@daffodil/external-router 0.41.0 → 0.42.0

package/fesm2020/daffodil-external-router.mjs

@@ -107,10 +107,10 @@ const daffTransformResolvedRouteToRoute = (resolvedRoute, availableTypes) => {
     return {
         route: {
             path: resolvedRoute.url,
+            daffExternalRouteType: resolvedRoute.type,
             ...routeType.route,
             data: {
-                daffExternalRouteType: resolvedRoute.type,
-                ...routeType.route.data,
+                ...resolvedRoute.data,
             },
         },
         insertionStrategy: routeType.insertionStrategy,
@@ -179,11 +179,14 @@ const routeMatchesRouteType = (route, type) => route?.data?.daffExternalRouteTyp
  *
  * See {@link DaffRouteWithDataPath}
  */
-const addRouteToDaffPaths = (route, path) => route.data.daffPaths = {
-    ...route.data.daffPaths,
-    [path]: path,
+const addRouteToDaffPaths = (route, externalRoute) => {
+    route.data.daffPaths = {
+        ...route.data.daffPaths,
+        [externalRoute.path]: externalRoute.data,
+    };
+    return route;
 };
-const operateOnRoute = (externalRoute) => (route) => addRouteToDaffPaths(route, externalRoute.path);
+const operateOnRoute = (externalRoute) => (route) => addRouteToDaffPaths(route, externalRoute);
 /**
  * Traverse the router config tree, halting after the first match.
  * This traversal is implemented in a pre-order manner. As such, for large
@@ -247,7 +250,7 @@ const traverseRouteTree = (routes = [], matcher, operate) => {
  * See {@link DaffRouteWithDataPath}
  *
  */
-const daffInsertDataPathStrategy = (externalRoute, routes) => traverseRouteTree(routes, (route) => routeMatchesRouteType(route, externalRoute.data?.daffExternalRouteType), operateOnRoute(externalRoute));
+const daffInsertDataPathStrategy = (externalRoute, routes) => traverseRouteTree(routes, (route) => routeMatchesRouteType(route, externalRoute.daffExternalRouteType), operateOnRoute(externalRoute));
 
 /**
  * A UrlMatcher that does an exact match against a path stored in the special
@@ -279,6 +282,15 @@ const daffDataPathUrlMatcher = (segments, group, route) => {
     return path in paths ? { consumed: segments } : null;
 };
 
+/**
+ * Extracts a key from DaffPath data based upon the currently activated
+ * RouteSnapshot.
+ */
+const daffExtractDaffPathData = (snapshot, key) => {
+    const pathFromRoot = snapshot.pathFromRoot[snapshot.pathFromRoot.length - 1].url.map((seg) => seg.path).join('/');
+    return snapshot.data?.daffPaths?.[pathFromRoot]?.[key] ?? null;
+};
+
 /*
  * Public API Surface of @daffodil/external-router
  */
@@ -287,5 +299,5 @@ const daffDataPathUrlMatcher = (segments, group, route) => {
  * Generated bundle index. Do not edit.
  */
 
-export { DAFF_EXTERNAL_ROUTER_CONFIG, DaffExternalRouter, DaffExternalRouterModule, DaffExternalRouterNoWildcardError, DaffExternalRouterUnknownRouteTypeError, daffDataPathUrlMatcher, daffInsertDataPathStrategy, daffInsertRouteBeforeWildCardStrategy, daffProvideRouteResolvableByType };
+export { DAFF_EXTERNAL_ROUTER_CONFIG, DaffExternalRouter, DaffExternalRouterModule, DaffExternalRouterNoWildcardError, DaffExternalRouterUnknownRouteTypeError, daffDataPathUrlMatcher, daffExtractDaffPathData, daffInsertDataPathStrategy, daffInsertRouteBeforeWildCardStrategy, daffProvideRouteResolvableByType };
 //# sourceMappingURL=daffodil-external-router.mjs.map

package/fesm2020/daffodil-external-router.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"daffodil-external-router.mjs","sources":["../../../libs/external-router/src/config.ts","../../../libs/external-router/src/token/type-resolvable-routes.token.ts","../../../libs/external-router/src/external-router.module.ts","../../../libs/external-router/src/errors/no-wildcard.ts","../../../libs/external-router/src/errors/unknown-type.ts","../../../libs/external-router/src/transform/resolved-route-to-route.ts","../../../libs/external-router/src/router/strategies/insert-route-before-wildcard.ts","../../../libs/external-router/src/router/router.service.ts","../../../libs/external-router/src/router/strategies/insert-data-path.ts","../../../libs/external-router/src/router/url-matcher/data-path-matcher.ts","../../../libs/external-router/src/public_api.ts","../../../libs/external-router/src/daffodil-external-router.ts"],"sourcesContent":["import { InjectionToken } from '@angular/core';\n\nexport const daffExternalRouterConfigurationDefault: DaffExternalRouterConfiguration = {\n  failedResolutionPath: '/',\n  notFoundResolutionPath: '/',\n};\n\n/**\n * The token holding the runtime configuration for the behavior of the\n * `@daffodil/external-router` package.\n */\nexport const DAFF_EXTERNAL_ROUTER_CONFIG = new InjectionToken<\n\tDaffExternalRouterConfiguration\n>('DAFF_EXTERNAL_ROUTER_CONFIG', {\n  providedIn: 'root',\n  factory: () => daffExternalRouterConfigurationDefault,\n});\n\n/**\n * The configuration object for the external router package.\n */\nexport interface DaffExternalRouterConfiguration {\n\t/**\n\t * The path to redirect to when external route resolution fails.\n\t */\n\tfailedResolutionPath: string;\n\n\t/**\n\t * The path to redirect to when the requested URL is not found.\n\t */\n\tnotFoundResolutionPath: string;\n}\n","import {\n  InjectionToken,\n  Provider,\n} from '@angular/core';\n\nimport { DaffExternalRouterInsertionStrategy } from '../model/insertion-strategy.type';\nimport { DaffExternalRouteType } from '../model/route-type';\nimport { DaffRouteWithoutPath } from '../model/route-without-path';\nimport { DaffTypeRoutePair } from '../model/type-route-pair';\n\n/**\n * A multi-token that allows you to register route \"types\" that correspond to routes.\n */\nexport const DAFF_EXTERNAL_ROUTER_ROUTES_RESOLVABLE_BY_TYPE = new InjectionToken<\n\tDaffTypeRoutePair[]\n>('DAFF_EXTERNAL_ROUTER_RESOLVABLE_TYPE_ROUTES', {\n  providedIn: 'root',\n  factory: () => [],\n});\n\n/**\n * A provider used to connect a type to a route to enable dynamic route resolution at runtime.\n */\nexport function daffProvideRouteResolvableByType(typeRoutePair: DaffTypeRoutePair): Provider {\n  return {\n    provide: DAFF_EXTERNAL_ROUTER_ROUTES_RESOLVABLE_BY_TYPE,\n    multi: true,\n    useValue: typeRoutePair,\n  };\n}\n\n/**\n * A multi-provider used to connect an array of types to their respective routes.\n */\nexport function daffProvideRoutesResolvableByType(routes: DaffTypeRoutePair[]): Provider[] {\n  return routes.map((route: DaffTypeRoutePair) => ({\n    provide: DAFF_EXTERNAL_ROUTER_ROUTES_RESOLVABLE_BY_TYPE,\n    multi: true,\n    useValue: route,\n  }));\n}\n","import { CommonModule } from '@angular/common';\nimport {\n  ModuleWithProviders,\n  NgModule,\n} from '@angular/core';\n\nimport {\n  DaffExternalRouterConfiguration,\n  DAFF_EXTERNAL_ROUTER_CONFIG,\n  daffExternalRouterConfigurationDefault,\n} from './config';\nimport { DaffTypeRoutePair } from './model/type-route-pair';\nimport { daffProvideRoutesResolvableByType } from './token/type-resolvable-routes.token';\n\n/**\n * The external `DaffExternalRouterModule` allows you to configure the\n * `@daffodil/external-router` package's behavior.\n */\n@NgModule({\n  declarations: [],\n  imports: [CommonModule],\n})\nexport class DaffExternalRouterModule {\n  static forRoot(\n    config: Partial<DaffExternalRouterConfiguration>,\n    routes: DaffTypeRoutePair[] = [],\n  ): ModuleWithProviders<DaffExternalRouterModule> {\n    return {\n      ngModule: DaffExternalRouterModule,\n      providers: [\n        { provide: DAFF_EXTERNAL_ROUTER_CONFIG, useValue: { ...daffExternalRouterConfigurationDefault, ...config }},\n        ...daffProvideRoutesResolvableByType(routes),\n      ],\n    };\n  }\n}\n","import {\n  DaffError,\n  DaffInheritableError,\n} from '@daffodil/core';\n\n/**\n * An error thrown when there was no wildcard route found in configuration\n * of the Angular Router.\n */\nexport class DaffExternalRouterNoWildcardError extends DaffInheritableError\n  implements DaffError {\n\tpublic readonly code: string = 'NO_WILDCARD_ROUTE';\n\n\tconstructor(message?: string) {\n\t  super(message);\n\t}\n}\n","import {\n  DaffError,\n  DaffInheritableError,\n} from '@daffodil/core';\n\n/**\n * An error thrown when there is a failure matching a configured route to a\n * route type.\n */\nexport class DaffExternalRouterUnknownRouteTypeError extends DaffInheritableError\n  implements DaffError {\n\tpublic readonly code: string = 'UNKNOWN_ROUTE_TYPE';\n\n\tconstructor(message?: string) {\n\t  super(message);\n\t}\n}\n","import { DaffExternalRouterUnknownRouteTypeError } from '../errors/unknown-type';\nimport { DaffExternallyResolvableUrl } from '../model/resolvable-route';\nimport { DaffRouteInfo } from '../model/route-info';\nimport { DaffTypeRoutePair } from '../model/type-route-pair';\n\n/**\n * Transforms a DaffExternallyResolvableUrl into an Angular Route.\n */\nexport const daffTransformResolvedRouteToRoute = (\n  resolvedRoute: DaffExternallyResolvableUrl,\n  availableTypes: DaffTypeRoutePair[],\n): DaffRouteInfo => {\n  const routeType = availableTypes\n    .filter(t => t.type === resolvedRoute.type)\n    .shift();\n  if (!routeType) {\n    throw new DaffExternalRouterUnknownRouteTypeError(\n      `Unable to resolve the route '${resolvedRoute.url}'. Its type is '${resolvedRoute.type}' but a matching route wasn't found.`,\n    );\n  }\n\n  return {\n    route: {\n      path: resolvedRoute.url,\n      ...routeType.route,\n      data: {\n        daffExternalRouteType: resolvedRoute.type,\n        ...routeType.route.data,\n      },\n    },\n    insertionStrategy: routeType.insertionStrategy,\n  };\n};\n","import {\n  Route,\n  Routes,\n} from '@angular/router';\n\nimport { DaffExternalRouterNoWildcardError } from '../../errors/no-wildcard';\nimport { DaffExternalRouterInsertionStrategy } from '../../model/insertion-strategy.type';\n\n/**\n * Inserts a Route into Routes right before the wildcard route.\n * If no wildcard is found, it fails fast with a `DaffExternalRouterNoWildcardError`.\n */\nexport const daffInsertRouteBeforeWildCardStrategy: DaffExternalRouterInsertionStrategy = (\n  route: Route,\n  routes: Routes,\n): Routes => {\n  const index = routes.findIndex((r: Route) => r.path === '**');\n  if (index === -1) {\n    throw new DaffExternalRouterNoWildcardError(\n      'No wildcard (**) route was found during route resolution.',\n    );\n  }\n  return [\n    ...routes.slice(0, index),\n    route,\n    ...routes.slice(index),\n  ];\n};\n","import {\n  Inject,\n  Injectable,\n} from '@angular/core';\nimport {\n  Router,\n  Route,\n} from '@angular/router';\n\n\nimport { DaffExternalRouterNoWildcardError } from '../errors/no-wildcard';\nimport { DaffExternallyResolvableUrl } from '../model/resolvable-route';\nimport { DaffTypeRoutePair } from '../model/type-route-pair';\nimport { DAFF_EXTERNAL_ROUTER_ROUTES_RESOLVABLE_BY_TYPE } from '../token/type-resolvable-routes.token';\nimport { daffTransformResolvedRouteToRoute } from '../transform/resolved-route-to-route';\nimport { daffInsertRouteBeforeWildCardStrategy } from './strategies/insert-route-before-wildcard';\n\n@Injectable({\n  providedIn: 'root',\n})\nexport class DaffExternalRouter {\n  constructor(\n    private router: Router,\n    @Inject(DAFF_EXTERNAL_ROUTER_ROUTES_RESOLVABLE_BY_TYPE)\n    private runtimeRoutes: DaffTypeRoutePair[],\n  ) { }\n\n  /**\n   * Adds a route to the existing router configuration.\n   */\n  add(resolvedRoute: DaffExternallyResolvableUrl) {\n    //Get the route.\n    const {\n      route,\n      insertionStrategy,\n    } = daffTransformResolvedRouteToRoute(\n      resolvedRoute,\n      this.runtimeRoutes,\n    );\n\n    try {\n      //Add it to configuration.\n      this.router.config = (insertionStrategy || daffInsertRouteBeforeWildCardStrategy)(route, this.router.config);\n    } catch (e) {\n      if (e instanceof DaffExternalRouterNoWildcardError) {\n        throw new DaffExternalRouterNoWildcardError(\n          `${e.message} This usually means you have misconfigured your routes.`,\n        );\n      }\n\n      throw e;\n    }\n  }\n}\n","import {\n  Route,\n  Routes,\n} from '@angular/router';\n\nimport { DaffExternalRouterInsertionStrategy } from '../../model/insertion-strategy.type';\nimport { DaffExternalRouteType } from '../../model/route-type';\nimport { DaffRouteWithDataPath } from '../../model/route-with-data-path';\n\n/**\n * Tests whether or not a route matches a specific Daffodil Route type.\n *\n * See {@link DaffRouteWithDataPath}\n */\nconst routeMatchesRouteType = (route: DaffRouteWithDataPath, type: DaffExternalRouteType): boolean => route?.data?.daffExternalRouteType === type;\n\n/**\n * Adds a path to the `daffPaths` of the given route.\n *\n * See {@link DaffRouteWithDataPath}\n */\nconst addRouteToDaffPaths:\n  (route: DaffRouteWithDataPath, path: string) => Route =\n  (route: DaffRouteWithDataPath, path: string) => route.data.daffPaths  = {\n    ...route.data.daffPaths,\n    [path]: path,\n  };\n\nconst operateOnRoute = (externalRoute: Route): (route: Route) => Route =>\n  (route: DaffRouteWithDataPath) => addRouteToDaffPaths(route, externalRoute.path);\n\n/**\n * Traverse the router config tree, halting after the first match.\n * This traversal is implemented in a pre-order manner. As such, for large\n * configuration trees, it will be most efficient to place externally routed\n * components at the top of router configuration.\n */\nconst traverseRouteTree = (routes: Routes = [], matcher: (route: Route) => boolean, operate: (route: Route) => void): Routes => {\n  if(routes.length === 0) {\n    return routes;\n  }\n\n  const stack: Routes = [];\n  const treeRoot = { children: routes };\n  stack.push(treeRoot);\n\n  while(stack.length) {\n    const route = stack.pop();\n    if(matcher(route)) {\n      operate(route);\n      break;\n    }\n    if(route.children){\n      stack.push(...route.children.reverse());\n    }\n  }\n  return routes;\n};\n\n/**\n * A route insertion strategy that can be used to append external routes onto\n * existing Angular routes. This can be useful when you need to route to\n * an existing lazy-loaded module from multiple externally defined urls.\n *\n * This should be used in combination with the {@link daffDataPathUrlMatcher} to match lazy-loaded modules with\n * associated external urls.\n *\n * For example, you can provide the insertion strategy in the {@link DaffExternalRouterModule} as below.\n *\n * ```ts\n * DaffExternalRouterModule.forRoot({}, [\n *  {\n *    type: 'CATEGORY',\n *    insertionStrategy: daffInsertDataPathStrategy,\n *    route: {}\n *  }\n * ],\n * ```\n *\n * Then, you can match it with an associated route defined in your Routing\n * configuration with the {@link daffDataPathUrlMatcher}.\n *\n * ```ts\n *  export const routes: Routes = [\n *    {\n *      matcher: daffDataPathUrlMatcher,\n *      data: {\n *        daffExternalRouteType: \"CATEGORY\",\n *      },\n *      loadChildren: () => import('./category/category.module').then((m) => m.MyCategoryModule),\n *    }\n * ]\n * ```\n *\n * See {@link DaffRouteWithDataPath}\n *\n */\nexport const daffInsertDataPathStrategy: DaffExternalRouterInsertionStrategy = (externalRoute: DaffRouteWithDataPath, routes: Routes) => traverseRouteTree(\n  routes,\n  (route) => routeMatchesRouteType(route, externalRoute.data?.daffExternalRouteType),\n  operateOnRoute(externalRoute),\n);\n","import {\n  UrlMatcher,\n  UrlSegment,\n  UrlSegmentGroup,\n} from '@angular/router';\n\nimport { daffUriTruncateLeadingSlash } from '@daffodil/core/routing';\n\nimport { DaffRouteWithDataPath } from '../../model/public_api';\n\n/**\n * A UrlMatcher that does an exact match against a path stored in the special\n * configuration fields that External Router stores on a Route's data.\n *\n * ```ts\n *  export const routes: Routes = [\n *    {\n *      matcher: daffDataPathUrlMatcher,\n *      data: {\n *        daffExternalRouteType: \"CATEGORY\",\n *      },\n *      loadChildren: () => import('./category/category.module').then((m) => m.ShopCategoryModule),\n *    }\n * ]\n * ```\n * {@link daffInsertDataPathStrategy }\n * {@link DaffRouteWithDataPath }\n */\nexport const daffDataPathUrlMatcher: UrlMatcher = (segments: UrlSegment[], group: UrlSegmentGroup, route: DaffRouteWithDataPath) => {\n  const path = daffUriTruncateLeadingSlash(segments.reduce((acc: string, segment) => acc + '/' + segment.path, ''));\n  const paths = route?.data?.daffPaths;\n\n  // If we don't have any paths, we can safely fail a match.\n  if(!paths) {\n    return null;\n  }\n\n  // Otherwise, look up the path in the dictionary, failing if a match isn't found,\n  // but matching the entire segment if a match is found.\n  return path in paths ?  { consumed: segments } : null;\n};\n\n","/*\n * Public API Surface of @daffodil/external-router\n */\n\nexport { DaffExternalRouterModule } from './external-router.module';\n\nexport {\n  DAFF_EXTERNAL_ROUTER_CONFIG,\n  DaffExternalRouterConfiguration,\n} from './config';\n\nexport { daffProvideRouteResolvableByType } from './token/type-resolvable-routes.token';\n\nexport * from './model/public_api';\n\nexport { DaffExternalRouter } from './router/router.service';\nexport { daffInsertRouteBeforeWildCardStrategy } from './router/strategies/insert-route-before-wildcard';\n\nexport { daffInsertDataPathStrategy } from './router/strategies/insert-data-path';\nexport { daffDataPathUrlMatcher } from './router/url-matcher/data-path-matcher';\n\nexport { DaffExternalRouterNoWildcardError } from './errors/no-wildcard';\nexport { DaffExternalRouterUnknownRouteTypeError } from './errors/unknown-type';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public_api';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"daffodil-external-router.mjs","sources":["../../../libs/external-router/src/config.ts","../../../libs/external-router/src/token/type-resolvable-routes.token.ts","../../../libs/external-router/src/external-router.module.ts","../../../libs/external-router/src/errors/no-wildcard.ts","../../../libs/external-router/src/errors/unknown-type.ts","../../../libs/external-router/src/transform/resolved-route-to-route.ts","../../../libs/external-router/src/router/strategies/insert-route-before-wildcard.ts","../../../libs/external-router/src/router/router.service.ts","../../../libs/external-router/src/router/strategies/insert-data-path.ts","../../../libs/external-router/src/router/url-matcher/data-path-matcher.ts","../../../libs/external-router/src/util/extract-daff-path-data.ts","../../../libs/external-router/src/public_api.ts","../../../libs/external-router/src/daffodil-external-router.ts"],"sourcesContent":["import { InjectionToken } from '@angular/core';\n\nexport const daffExternalRouterConfigurationDefault: DaffExternalRouterConfiguration = {\n  failedResolutionPath: '/',\n  notFoundResolutionPath: '/',\n};\n\n/**\n * The token holding the runtime configuration for the behavior of the\n * `@daffodil/external-router` package.\n */\nexport const DAFF_EXTERNAL_ROUTER_CONFIG = new InjectionToken<\nDaffExternalRouterConfiguration\n>('DAFF_EXTERNAL_ROUTER_CONFIG', {\n  providedIn: 'root',\n  factory: () => daffExternalRouterConfigurationDefault,\n});\n\n/**\n * The configuration object for the external router package.\n */\nexport interface DaffExternalRouterConfiguration {\n  /**\n   * The path to redirect to when external route resolution fails.\n   */\n  failedResolutionPath: string;\n\n  /**\n   * The path to redirect to when the requested URL is not found.\n   */\n  notFoundResolutionPath: string;\n}\n","import {\n  InjectionToken,\n  Provider,\n} from '@angular/core';\n\nimport { DaffExternalRouterInsertionStrategy } from '../model/insertion-strategy.type';\nimport { DaffExternalRouteType } from '../model/route-type';\nimport { DaffRouteWithoutPath } from '../model/route-without-path';\nimport { DaffTypeRoutePair } from '../model/type-route-pair';\n\n/**\n * A multi-token that allows you to register route \"types\" that correspond to routes.\n */\nexport const DAFF_EXTERNAL_ROUTER_ROUTES_RESOLVABLE_BY_TYPE = new InjectionToken<\nDaffTypeRoutePair[]\n>('DAFF_EXTERNAL_ROUTER_RESOLVABLE_TYPE_ROUTES', {\n  providedIn: 'root',\n  factory: () => [],\n});\n\n/**\n * A provider used to connect a type to a route to enable dynamic route resolution at runtime.\n */\nexport function daffProvideRouteResolvableByType(typeRoutePair: DaffTypeRoutePair): Provider {\n  return {\n    provide: DAFF_EXTERNAL_ROUTER_ROUTES_RESOLVABLE_BY_TYPE,\n    multi: true,\n    useValue: typeRoutePair,\n  };\n}\n\n/**\n * A multi-provider used to connect an array of types to their respective routes.\n */\nexport function daffProvideRoutesResolvableByType(routes: DaffTypeRoutePair[]): Provider[] {\n  return routes.map((route: DaffTypeRoutePair) => ({\n    provide: DAFF_EXTERNAL_ROUTER_ROUTES_RESOLVABLE_BY_TYPE,\n    multi: true,\n    useValue: route,\n  }));\n}\n","import { CommonModule } from '@angular/common';\nimport {\n  ModuleWithProviders,\n  NgModule,\n} from '@angular/core';\n\nimport {\n  DaffExternalRouterConfiguration,\n  DAFF_EXTERNAL_ROUTER_CONFIG,\n  daffExternalRouterConfigurationDefault,\n} from './config';\nimport { DaffTypeRoutePair } from './model/type-route-pair';\nimport { daffProvideRoutesResolvableByType } from './token/type-resolvable-routes.token';\n\n/**\n * The external `DaffExternalRouterModule` allows you to configure the\n * `@daffodil/external-router` package's behavior.\n */\n@NgModule({\n  declarations: [],\n  imports: [CommonModule],\n})\nexport class DaffExternalRouterModule {\n  static forRoot(\n    config: Partial<DaffExternalRouterConfiguration>,\n    routes: DaffTypeRoutePair[] = [],\n  ): ModuleWithProviders<DaffExternalRouterModule> {\n    return {\n      ngModule: DaffExternalRouterModule,\n      providers: [\n        { provide: DAFF_EXTERNAL_ROUTER_CONFIG, useValue: { ...daffExternalRouterConfigurationDefault, ...config }},\n        ...daffProvideRoutesResolvableByType(routes),\n      ],\n    };\n  }\n}\n","import {\n  DaffError,\n  DaffInheritableError,\n} from '@daffodil/core';\n\n/**\n * An error thrown when there was no wildcard route found in configuration\n * of the Angular Router.\n */\nexport class DaffExternalRouterNoWildcardError extends DaffInheritableError\n  implements DaffError {\n  public readonly code: string = 'NO_WILDCARD_ROUTE';\n\n  constructor(message?: string) {\n\t  super(message);\n  }\n}\n","import {\n  DaffError,\n  DaffInheritableError,\n} from '@daffodil/core';\n\n/**\n * An error thrown when there is a failure matching a configured route to a\n * route type.\n */\nexport class DaffExternalRouterUnknownRouteTypeError extends DaffInheritableError\n  implements DaffError {\n  public readonly code: string = 'UNKNOWN_ROUTE_TYPE';\n\n  constructor(message?: string) {\n\t  super(message);\n  }\n}\n","import { DaffExternalRouterUnknownRouteTypeError } from '../errors/unknown-type';\nimport { DaffExternallyResolvableUrl } from '../model/resolvable-route';\nimport { DaffRouteInfo } from '../model/route-info';\nimport { DaffTypeRoutePair } from '../model/type-route-pair';\n\n/**\n * Transforms a DaffExternallyResolvableUrl into an Angular Route.\n */\nexport const daffTransformResolvedRouteToRoute = (\n  resolvedRoute: DaffExternallyResolvableUrl,\n  availableTypes: DaffTypeRoutePair[],\n): DaffRouteInfo => {\n  const routeType = availableTypes\n    .filter(t => t.type === resolvedRoute.type)\n    .shift();\n  if (!routeType) {\n    throw new DaffExternalRouterUnknownRouteTypeError(\n      `Unable to resolve the route '${resolvedRoute.url}'. Its type is '${resolvedRoute.type}' but a matching route wasn't found.`,\n    );\n  }\n\n  return {\n    route: {\n      path: resolvedRoute.url,\n      daffExternalRouteType: resolvedRoute.type,\n      ...routeType.route,\n      data: {\n        ...resolvedRoute.data,\n      },\n    },\n    insertionStrategy: routeType.insertionStrategy,\n  };\n};\n","import {\n  Route,\n  Routes,\n} from '@angular/router';\n\nimport { DaffExternalRouterNoWildcardError } from '../../errors/no-wildcard';\nimport { DaffExternalRouterInsertionStrategy } from '../../model/insertion-strategy.type';\n\n/**\n * Inserts a Route into Routes right before the wildcard route.\n * If no wildcard is found, it fails fast with a `DaffExternalRouterNoWildcardError`.\n */\nexport const daffInsertRouteBeforeWildCardStrategy: DaffExternalRouterInsertionStrategy = (\n  route: Route,\n  routes: Routes,\n): Routes => {\n  const index = routes.findIndex((r: Route) => r.path === '**');\n  if (index === -1) {\n    throw new DaffExternalRouterNoWildcardError(\n      'No wildcard (**) route was found during route resolution.',\n    );\n  }\n  return [\n    ...routes.slice(0, index),\n    route,\n    ...routes.slice(index),\n  ];\n};\n","import {\n  Inject,\n  Injectable,\n} from '@angular/core';\nimport {\n  Router,\n  Route,\n} from '@angular/router';\n\n\nimport { DaffExternalRouterNoWildcardError } from '../errors/no-wildcard';\nimport { DaffExternallyResolvableUrl } from '../model/resolvable-route';\nimport { DaffTypeRoutePair } from '../model/type-route-pair';\nimport { DAFF_EXTERNAL_ROUTER_ROUTES_RESOLVABLE_BY_TYPE } from '../token/type-resolvable-routes.token';\nimport { daffTransformResolvedRouteToRoute } from '../transform/resolved-route-to-route';\nimport { daffInsertRouteBeforeWildCardStrategy } from './strategies/insert-route-before-wildcard';\n\n@Injectable({\n  providedIn: 'root',\n})\nexport class DaffExternalRouter {\n  constructor(\n    private router: Router,\n    @Inject(DAFF_EXTERNAL_ROUTER_ROUTES_RESOLVABLE_BY_TYPE)\n    private runtimeRoutes: DaffTypeRoutePair[],\n  ) { }\n\n  /**\n   * Adds a route to the existing router configuration.\n   */\n  add(resolvedRoute: DaffExternallyResolvableUrl) {\n    //Get the route.\n    const {\n      route,\n      insertionStrategy,\n    } = daffTransformResolvedRouteToRoute(\n      resolvedRoute,\n      this.runtimeRoutes,\n    );\n\n    try {\n      //Add it to configuration.\n      this.router.config = (insertionStrategy || daffInsertRouteBeforeWildCardStrategy)(route, this.router.config);\n    } catch (e) {\n      if (e instanceof DaffExternalRouterNoWildcardError) {\n        throw new DaffExternalRouterNoWildcardError(\n          `${e.message} This usually means you have misconfigured your routes.`,\n        );\n      }\n\n      throw e;\n    }\n  }\n}\n","import {\n  Route,\n  Routes,\n} from '@angular/router';\n\nimport { DaffExternalRouterInsertionStrategy } from '../../model/insertion-strategy.type';\nimport { DaffExternalRouteType } from '../../model/route-type';\nimport { DaffRouteWithDataPath } from '../../model/route-with-data-path';\nimport { DaffRouteWithSeoData } from '../../model/route-with-seo-data';\nimport { DaffRouteWithType } from '../../model/route-with-type';\n\ntype RouteOperator = (route: Route) => Route;\ntype ExternalRouteOperator = (route: DaffRouteWithDataPath, externalRoute: Route) => Route;\ntype InsertionOperatorFactory = (externalRoute: Route) => RouteOperator;\n\n/**\n * Tests whether or not a route matches a specific Daffodil Route type.\n *\n * See {@link DaffRouteWithDataPath}\n */\nconst routeMatchesRouteType = (route: Route, type: DaffExternalRouteType): boolean => route?.data?.daffExternalRouteType === type;\n\n/**\n * Adds a path to the `daffPaths` of the given route.\n *\n * See {@link DaffRouteWithDataPath}\n */\nconst addRouteToDaffPaths: ExternalRouteOperator =\n  (route: DaffRouteWithDataPath, externalRoute: Route) => {\n    route.data.daffPaths = {\n      ...route.data.daffPaths,\n      [externalRoute.path]: externalRoute.data,\n    };\n    return route;\n  };\n\nconst operateOnRoute: InsertionOperatorFactory =\n  (externalRoute: Route) => (route: DaffRouteWithDataPath) => addRouteToDaffPaths(route, externalRoute);\n\n/**\n * Traverse the router config tree, halting after the first match.\n * This traversal is implemented in a pre-order manner. As such, for large\n * configuration trees, it will be most efficient to place externally routed\n * components at the top of router configuration.\n */\nconst traverseRouteTree = (routes: Routes = [], matcher: (route: Route) => boolean, operate: RouteOperator): Routes => {\n  if(routes.length === 0) {\n    return routes;\n  }\n\n  const stack: Routes = [];\n  const treeRoot = { children: routes };\n  stack.push(treeRoot);\n\n  while(stack.length) {\n    const route = stack.pop();\n    if(matcher(route)) {\n      operate(route);\n      break;\n    }\n    if(route.children){\n      stack.push(...route.children.reverse());\n    }\n  }\n  return routes;\n};\n\n/**\n * A route insertion strategy that can be used to append external routes onto\n * existing Angular routes. This can be useful when you need to route to\n * an existing lazy-loaded module from multiple externally defined urls.\n *\n * This should be used in combination with the {@link daffDataPathUrlMatcher} to match lazy-loaded modules with\n * associated external urls.\n *\n * For example, you can provide the insertion strategy in the {@link DaffExternalRouterModule} as below.\n *\n * ```ts\n * DaffExternalRouterModule.forRoot({}, [\n *  {\n *    type: 'CATEGORY',\n *    insertionStrategy: daffInsertDataPathStrategy,\n *    route: {}\n *  }\n * ],\n * ```\n *\n * Then, you can match it with an associated route defined in your Routing\n * configuration with the {@link daffDataPathUrlMatcher}.\n *\n * ```ts\n *  export const routes: Routes = [\n *    {\n *      matcher: daffDataPathUrlMatcher,\n *      data: {\n *        daffExternalRouteType: \"CATEGORY\",\n *      },\n *      loadChildren: () => import('./category/category.module').then((m) => m.MyCategoryModule),\n *    }\n * ]\n * ```\n *\n * See {@link DaffRouteWithDataPath}\n *\n */\nexport const daffInsertDataPathStrategy: DaffExternalRouterInsertionStrategy = (externalRoute: DaffRouteWithType & DaffRouteWithSeoData, routes: Routes) => traverseRouteTree(\n  routes,\n  (route) => routeMatchesRouteType(route, externalRoute.daffExternalRouteType),\n  operateOnRoute(externalRoute),\n);\n","import {\n  UrlMatcher,\n  UrlSegment,\n  UrlSegmentGroup,\n} from '@angular/router';\n\nimport { daffUriTruncateLeadingSlash } from '@daffodil/core/routing';\n\nimport { DaffRouteWithDataPath } from '../../model/public_api';\n\n/**\n * A UrlMatcher that does an exact match against a path stored in the special\n * configuration fields that External Router stores on a Route's data.\n *\n * ```ts\n *  export const routes: Routes = [\n *    {\n *      matcher: daffDataPathUrlMatcher,\n *      data: {\n *        daffExternalRouteType: \"CATEGORY\",\n *      },\n *      loadChildren: () => import('./category/category.module').then((m) => m.ShopCategoryModule),\n *    }\n * ]\n * ```\n * {@link daffInsertDataPathStrategy }\n * {@link DaffRouteWithDataPath }\n */\nexport const daffDataPathUrlMatcher: UrlMatcher = (segments: UrlSegment[], group: UrlSegmentGroup, route: DaffRouteWithDataPath) => {\n  const path = daffUriTruncateLeadingSlash(segments.reduce((acc: string, segment) => acc + '/' + segment.path, ''));\n  const paths = route?.data?.daffPaths;\n\n  // If we don't have any paths, we can safely fail a match.\n  if(!paths) {\n    return null;\n  }\n\n  // Otherwise, look up the path in the dictionary, failing if a match isn't found,\n  // but matching the entire segment if a match is found.\n  return path in paths ?  { consumed: segments } : null;\n};\n\n","import {\n  ActivatedRouteSnapshot,\n  Data,\n} from '@angular/router';\n\n/**\n * Extracts a key from DaffPath data based upon the currently activated\n * RouteSnapshot.\n */\nexport const daffExtractDaffPathData = <T extends Data = Data>(snapshot: ActivatedRouteSnapshot, key: keyof T): unknown => {\n  const pathFromRoot = snapshot.pathFromRoot[snapshot.pathFromRoot.length - 1].url.map((seg) => seg.path).join('/');\n  return snapshot.data?.daffPaths?.[pathFromRoot]?.[key] ?? null;\n};\n","/*\n * Public API Surface of @daffodil/external-router\n */\n\nexport { DaffExternalRouterModule } from './external-router.module';\n\nexport {\n  DAFF_EXTERNAL_ROUTER_CONFIG,\n  DaffExternalRouterConfiguration,\n} from './config';\n\nexport { daffProvideRouteResolvableByType } from './token/type-resolvable-routes.token';\n\nexport * from './model/public_api';\n\nexport { DaffExternalRouter } from './router/router.service';\nexport { daffInsertRouteBeforeWildCardStrategy } from './router/strategies/insert-route-before-wildcard';\n\nexport { daffInsertDataPathStrategy } from './router/strategies/insert-data-path';\nexport { daffDataPathUrlMatcher } from './router/url-matcher/data-path-matcher';\n\nexport { DaffExternalRouterNoWildcardError } from './errors/no-wildcard';\nexport { DaffExternalRouterUnknownRouteTypeError } from './errors/unknown-type';\n\nexport { daffExtractDaffPathData } from './util/extract-daff-path-data';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public_api';\n"],"names":[],"mappings":"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"}

package/model/resolvable-route.d.ts

@@ -1,4 +1,5 @@
 import { DaffIdentifiable } from '@daffodil/core';
+import { DaffRouteData } from './route-data';
 import { DaffExternalRouteType } from './route-type';
 /**
  * A `DaffExternallyResolvableUrl` describes the relationship between a "type" of route
@@ -19,9 +20,19 @@ export interface DaffExternallyResolvableUrl extends DaffIdentifiable {
      * Should not contain URL fragments, query parameters, or leading slashes.
      */
     url: string;
+    /**
+     * The type of the route
+     *
+     * @see {@link DaffExternalRouteType}
+     */
     type: DaffExternalRouteType;
     /**
      * The HTTP status code for the resolvable route.
      */
     code: number;
+    /**
+     * Additional route data. Note that this is not guaranteed to come from
+     * the driver, its only available when the driver makes it available.
+     */
+    data?: DaffRouteData;
 }

package/model/route-data.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Data associated with a route.
+ */
+export interface DaffRouteData {
+    canonical_url?: string;
+    meta_description?: string;
+    title?: string;
+}

package/model/route-info.d.ts

@@ -1,9 +1,9 @@
 import { DaffExternalRouterInsertionStrategy } from './insertion-strategy.type';
-import { DaffRouteWithDataPath } from './route-with-data-path';
+import { DaffRouteWithType } from './route-with-type';
 /**
  * An object containing the info needed to insert a route into a configuration.
  */
 export interface DaffRouteInfo {
-    route: DaffRouteWithDataPath;
+    route: DaffRouteWithType;
     insertionStrategy?: DaffExternalRouterInsertionStrategy;
 }

package/model/route-with-data-path.d.ts

@@ -1,5 +1,5 @@
-import { Route } from '@angular/router';
-import { DaffExternalRouteType } from './route-type';
+import { Data, Route } from '@angular/router';
+import { DaffRouteData } from './route-data';
 /**
  * A type that describes the special data that Daffodil will look for when attempting
  * to match a route based upon path data stored in the `data` key of a route.
@@ -9,7 +9,6 @@ import { DaffExternalRouteType } from './route-type';
  */
 export declare type DaffRouteWithDataPath = Route & {
     data?: {
-        daffExternalRouteType?: DaffExternalRouteType;
-        daffPaths?: Record<string, string>;
+        daffPaths?: Record<string, DaffRouteData | Data>;
     };
 };

package/model/route-with-seo-data.d.ts

@@ -0,0 +1,12 @@
+import { Route } from '@angular/router';
+import { DaffRouteData } from './route-data';
+/**
+ * A type that describes the special data that Daffodil will store for SEO purposes on
+ * an external resolved route.
+ *
+ * {@link daffDataPathUrlMatcher}
+ * {@link daffInsertDataPathStrategy}
+ */
+export declare type DaffRouteWithSeoData = Route & {
+    data: DaffRouteData;
+};

package/model/route-with-type.d.ts

@@ -0,0 +1,12 @@
+import { Route } from '@angular/router';
+import { DaffExternalRouteType } from './route-type';
+/**
+ * A type that describes the special data that Daffodil will look for when attempting
+ * to match a route based upon path data stored in the `data` key of a route.
+ *
+ * {@link daffDataPathUrlMatcher}
+ * {@link daffInsertDataPathStrategy}
+ */
+export declare type DaffRouteWithType = Route & {
+    daffExternalRouteType: DaffExternalRouteType;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daffodil/external-router",
-  "version": "0.41.0",
+  "version": "0.42.0",
   "description": "A platform-agnostic package that connects the @angular/router with an external routing service (e.g. an API), allowing for runtime route resolution.",
   "repository": {
     "type": "git",
@@ -16,12 +16,12 @@
     "@angular/common": "^13.0.0",
     "@angular/core": "^13.0.0",
     "@angular/router": "^13.0.0",
-    "@daffodil/core": "0.41.0",
+    "@daffodil/core": "0.42.0",
     "rxjs": "7.5.5"
   },
   "optionalDependencies": {
     "apollo-angular": "^3.0.1",
-    "@daffodil/driver": "0.41.0"
+    "@daffodil/driver": "0.42.0"
   },
   "module": "fesm2015/daffodil-external-router.mjs",
   "es2020": "fesm2020/daffodil-external-router.mjs",
@@ -65,6 +65,14 @@
       "node": "./fesm2015/daffodil-external-router-driver-magento-2.4.2.mjs",
       "default": "./fesm2020/daffodil-external-router-driver-magento-2.4.2.mjs"
     },
+    "./driver/magento/2.4.3": {
+      "types": "./driver/magento/2.4.3/daffodil-external-router-driver-magento-2.4.3.d.ts",
+      "esm2020": "./esm2020/driver/magento/2.4.3/daffodil-external-router-driver-magento-2.4.3.mjs",
+      "es2020": "./fesm2020/daffodil-external-router-driver-magento-2.4.3.mjs",
+      "es2015": "./fesm2015/daffodil-external-router-driver-magento-2.4.3.mjs",
+      "node": "./fesm2015/daffodil-external-router-driver-magento-2.4.3.mjs",
+      "default": "./fesm2020/daffodil-external-router-driver-magento-2.4.3.mjs"
+    },
     "./driver/magento": {
       "types": "./driver/magento/daffodil-external-router-driver-magento.d.ts",
       "esm2020": "./esm2020/driver/magento/daffodil-external-router-driver-magento.mjs",

package/public_api.d.ts

@@ -8,3 +8,4 @@ export { daffInsertDataPathStrategy } from './router/strategies/insert-data-path
 export { daffDataPathUrlMatcher } from './router/url-matcher/data-path-matcher';
 export { DaffExternalRouterNoWildcardError } from './errors/no-wildcard';
 export { DaffExternalRouterUnknownRouteTypeError } from './errors/unknown-type';
+export { daffExtractDaffPathData } from './util/extract-daff-path-data';

package/util/extract-daff-path-data.d.ts

@@ -0,0 +1,6 @@
+import { ActivatedRouteSnapshot, Data } from '@angular/router';
+/**
+ * Extracts a key from DaffPath data based upon the currently activated
+ * RouteSnapshot.
+ */
+export declare const daffExtractDaffPathData: <T extends Data = Data>(snapshot: ActivatedRouteSnapshot, key: keyof T) => unknown;