Route metadata

README.md

@@ -79,6 +79,15 @@ result = router.recognize("/pages/hello/world");
 result === [{ handler: page, params: { path: "hello/world" } }];
 ```
 
+Metadata:
+
+```javascript
+router.add([{ path: "/post/1", handler: page, metadata: { test: 123 } }]);
+
+result = router.recognize("/post/1");
+result === [{ handler: page, params: {}, metadata: { test: 123 } }];
+```
+
 # Sorting
 
 If multiple routes all match a path, `route-recognizer`

lib/route-recognizer.ts

@@ -209,12 +209,14 @@ interface EmptyHandler {
   handler: Opaque;
   names: EmptyArray;
   shouldDecodes: EmptyArray;
+  metadata: Opaque;
 }
 
 interface PopulatedHandler {
   handler: Opaque;
   names: string [];
   shouldDecodes: boolean[];
+  metadata: Opaque;
 }
 
 type Handler = EmptyHandler | PopulatedHandler;
@@ -385,6 +387,7 @@ export interface Result {
   handler: Opaque;
   params: Params;
   isDynamic: boolean;
+  metadata: Opaque;
 }
 
 export interface Results extends ArrayLike<Result | undefined> {
@@ -449,6 +452,7 @@ function findHandler(state: State, originalPath: string, queryParams: QueryParam
 
     result[i] = {
       handler: handler.handler,
+      metadata: handler.metadata,
       params,
       isDynamic
     };
@@ -526,8 +530,10 @@ class RouteRecognizer {
         currentState = eachChar[segment.type](segment, currentState);
         pattern += regex[segment.type](segment);
       }
+
       handlers[i] = {
         handler: route.handler,
+        metadata: route.metadata,
         names,
         shouldDecodes
       };

lib/route-recognizer/dsl.ts

@@ -10,6 +10,7 @@ export type Opaque = {} | void | null | undefined;
 export interface Route {
   path: string;
   handler: Opaque;
+  metadata?: Opaque;
   queryParams?: string[];
 }
 
@@ -105,14 +106,14 @@ function generateMatch(startingPath: string, matcher: Matcher, delegate: Delegat
   return match;
 }
 
-function addRoute(routeArray: Route[], path: string, handler: any) {
+function addRoute(routeArray: Route[], path: string, handler: any, metadata: any) {
   let len = 0;
   for (let i = 0; i < routeArray.length; i++) {
     len += routeArray[i].path.length;
   }
 
   path = path.substr(len);
-  let route = { path: path, handler: handler };
+  let route = { path: path, handler: handler, metadata: metadata };
   routeArray.push(route);
 }
 
@@ -122,7 +123,7 @@ function eachRoute<T>(baseRoute: Route[], matcher: Matcher, callback: (this: T,
   for (let i = 0; i < paths.length; i++) {
     let path = paths[i];
     let routeArray = baseRoute.slice();
-    addRoute(routeArray, path, routes[path]);
+    addRoute(routeArray, path, routes[path], routes.metadata);
     let nested = matcher.children[path];
     if (nested) {
       eachRoute(routeArray, nested, callback, binding);