@daffodil/external-router 0.39.13 → 0.42.0

package/fesm2020/daffodil-external-router.mjs

@@ -0,0 +1,303 @@
+import { CommonModule } from '@angular/common';
+import * as i0 from '@angular/core';
+import { InjectionToken, NgModule, Injectable, Inject } from '@angular/core';
+import * as i1 from '@angular/router';
+import { DaffInheritableError } from '@daffodil/core';
+import { daffUriTruncateLeadingSlash } from '@daffodil/core/routing';
+
+const daffExternalRouterConfigurationDefault = {
+    failedResolutionPath: '/',
+    notFoundResolutionPath: '/',
+};
+/**
+ * The token holding the runtime configuration for the behavior of the
+ * `@daffodil/external-router` package.
+ */
+const DAFF_EXTERNAL_ROUTER_CONFIG = new InjectionToken('DAFF_EXTERNAL_ROUTER_CONFIG', {
+    providedIn: 'root',
+    factory: () => daffExternalRouterConfigurationDefault,
+});
+
+/**
+ * A multi-token that allows you to register route "types" that correspond to routes.
+ */
+const DAFF_EXTERNAL_ROUTER_ROUTES_RESOLVABLE_BY_TYPE = new InjectionToken('DAFF_EXTERNAL_ROUTER_RESOLVABLE_TYPE_ROUTES', {
+    providedIn: 'root',
+    factory: () => [],
+});
+/**
+ * A provider used to connect a type to a route to enable dynamic route resolution at runtime.
+ */
+function daffProvideRouteResolvableByType(typeRoutePair) {
+    return {
+        provide: DAFF_EXTERNAL_ROUTER_ROUTES_RESOLVABLE_BY_TYPE,
+        multi: true,
+        useValue: typeRoutePair,
+    };
+}
+/**
+ * A multi-provider used to connect an array of types to their respective routes.
+ */
+function daffProvideRoutesResolvableByType(routes) {
+    return routes.map((route) => ({
+        provide: DAFF_EXTERNAL_ROUTER_ROUTES_RESOLVABLE_BY_TYPE,
+        multi: true,
+        useValue: route,
+    }));
+}
+
+/**
+ * The external `DaffExternalRouterModule` allows you to configure the
+ * `@daffodil/external-router` package's behavior.
+ */
+class DaffExternalRouterModule {
+    static forRoot(config, routes = []) {
+        return {
+            ngModule: DaffExternalRouterModule,
+            providers: [
+                { provide: DAFF_EXTERNAL_ROUTER_CONFIG, useValue: { ...daffExternalRouterConfigurationDefault, ...config } },
+                ...daffProvideRoutesResolvableByType(routes),
+            ],
+        };
+    }
+}
+/** @nocollapse */ /** @nocollapse */ DaffExternalRouterModule.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "13.3.0", ngImport: i0, type: DaffExternalRouterModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
+/** @nocollapse */ /** @nocollapse */ DaffExternalRouterModule.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "12.0.0", version: "13.3.0", ngImport: i0, type: DaffExternalRouterModule, imports: [CommonModule] });
+/** @nocollapse */ /** @nocollapse */ DaffExternalRouterModule.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "13.3.0", ngImport: i0, type: DaffExternalRouterModule, imports: [[CommonModule]] });
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.0", ngImport: i0, type: DaffExternalRouterModule, decorators: [{
+            type: NgModule,
+            args: [{
+                    declarations: [],
+                    imports: [CommonModule],
+                }]
+        }] });
+
+/**
+ * An error thrown when there was no wildcard route found in configuration
+ * of the Angular Router.
+ */
+class DaffExternalRouterNoWildcardError extends DaffInheritableError {
+    constructor(message) {
+        super(message);
+        this.code = 'NO_WILDCARD_ROUTE';
+    }
+}
+
+/**
+ * An error thrown when there is a failure matching a configured route to a
+ * route type.
+ */
+class DaffExternalRouterUnknownRouteTypeError extends DaffInheritableError {
+    constructor(message) {
+        super(message);
+        this.code = 'UNKNOWN_ROUTE_TYPE';
+    }
+}
+
+/**
+ * Transforms a DaffExternallyResolvableUrl into an Angular Route.
+ */
+const daffTransformResolvedRouteToRoute = (resolvedRoute, availableTypes) => {
+    const routeType = availableTypes
+        .filter(t => t.type === resolvedRoute.type)
+        .shift();
+    if (!routeType) {
+        throw new DaffExternalRouterUnknownRouteTypeError(`Unable to resolve the route '${resolvedRoute.url}'. Its type is '${resolvedRoute.type}' but a matching route wasn't found.`);
+    }
+    return {
+        route: {
+            path: resolvedRoute.url,
+            daffExternalRouteType: resolvedRoute.type,
+            ...routeType.route,
+            data: {
+                ...resolvedRoute.data,
+            },
+        },
+        insertionStrategy: routeType.insertionStrategy,
+    };
+};
+
+/**
+ * Inserts a Route into Routes right before the wildcard route.
+ * If no wildcard is found, it fails fast with a `DaffExternalRouterNoWildcardError`.
+ */
+const daffInsertRouteBeforeWildCardStrategy = (route, routes) => {
+    const index = routes.findIndex((r) => r.path === '**');
+    if (index === -1) {
+        throw new DaffExternalRouterNoWildcardError('No wildcard (**) route was found during route resolution.');
+    }
+    return [
+        ...routes.slice(0, index),
+        route,
+        ...routes.slice(index),
+    ];
+};
+
+class DaffExternalRouter {
+    constructor(router, runtimeRoutes) {
+        this.router = router;
+        this.runtimeRoutes = runtimeRoutes;
+    }
+    /**
+     * Adds a route to the existing router configuration.
+     */
+    add(resolvedRoute) {
+        //Get the route.
+        const { route, insertionStrategy, } = daffTransformResolvedRouteToRoute(resolvedRoute, this.runtimeRoutes);
+        try {
+            //Add it to configuration.
+            this.router.config = (insertionStrategy || daffInsertRouteBeforeWildCardStrategy)(route, this.router.config);
+        }
+        catch (e) {
+            if (e instanceof DaffExternalRouterNoWildcardError) {
+                throw new DaffExternalRouterNoWildcardError(`${e.message} This usually means you have misconfigured your routes.`);
+            }
+            throw e;
+        }
+    }
+}
+/** @nocollapse */ /** @nocollapse */ DaffExternalRouter.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "13.3.0", ngImport: i0, type: DaffExternalRouter, deps: [{ token: i1.Router }, { token: DAFF_EXTERNAL_ROUTER_ROUTES_RESOLVABLE_BY_TYPE }], target: i0.ɵɵFactoryTarget.Injectable });
+/** @nocollapse */ /** @nocollapse */ DaffExternalRouter.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "13.3.0", ngImport: i0, type: DaffExternalRouter, providedIn: 'root' });
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "13.3.0", ngImport: i0, type: DaffExternalRouter, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root',
+                }]
+        }], ctorParameters: function () { return [{ type: i1.Router }, { type: undefined, decorators: [{
+                    type: Inject,
+                    args: [DAFF_EXTERNAL_ROUTER_ROUTES_RESOLVABLE_BY_TYPE]
+                }] }]; } });
+
+/**
+ * Tests whether or not a route matches a specific Daffodil Route type.
+ *
+ * See {@link DaffRouteWithDataPath}
+ */
+const routeMatchesRouteType = (route, type) => route?.data?.daffExternalRouteType === type;
+/**
+ * Adds a path to the `daffPaths` of the given route.
+ *
+ * See {@link DaffRouteWithDataPath}
+ */
+const addRouteToDaffPaths = (route, externalRoute) => {
+    route.data.daffPaths = {
+        ...route.data.daffPaths,
+        [externalRoute.path]: externalRoute.data,
+    };
+    return route;
+};
+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
+ * configuration trees, it will be most efficient to place externally routed
+ * components at the top of router configuration.
+ */
+const traverseRouteTree = (routes = [], matcher, operate) => {
+    if (routes.length === 0) {
+        return routes;
+    }
+    const stack = [];
+    const treeRoot = { children: routes };
+    stack.push(treeRoot);
+    while (stack.length) {
+        const route = stack.pop();
+        if (matcher(route)) {
+            operate(route);
+            break;
+        }
+        if (route.children) {
+            stack.push(...route.children.reverse());
+        }
+    }
+    return routes;
+};
+/**
+ * A route insertion strategy that can be used to append external routes onto
+ * existing Angular routes. This can be useful when you need to route to
+ * an existing lazy-loaded module from multiple externally defined urls.
+ *
+ * This should be used in combination with the {@link daffDataPathUrlMatcher} to match lazy-loaded modules with
+ * associated external urls.
+ *
+ * For example, you can provide the insertion strategy in the {@link DaffExternalRouterModule} as below.
+ *
+ * ```ts
+ * DaffExternalRouterModule.forRoot({}, [
+ *  {
+ *    type: 'CATEGORY',
+ *    insertionStrategy: daffInsertDataPathStrategy,
+ *    route: {}
+ *  }
+ * ],
+ * ```
+ *
+ * Then, you can match it with an associated route defined in your Routing
+ * configuration with the {@link daffDataPathUrlMatcher}.
+ *
+ * ```ts
+ *  export const routes: Routes = [
+ *    {
+ *      matcher: daffDataPathUrlMatcher,
+ *      data: {
+ *        daffExternalRouteType: "CATEGORY",
+ *      },
+ *      loadChildren: () => import('./category/category.module').then((m) => m.MyCategoryModule),
+ *    }
+ * ]
+ * ```
+ *
+ * See {@link DaffRouteWithDataPath}
+ *
+ */
+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
+ * configuration fields that External Router stores on a Route's data.
+ *
+ * ```ts
+ *  export const routes: Routes = [
+ *    {
+ *      matcher: daffDataPathUrlMatcher,
+ *      data: {
+ *        daffExternalRouteType: "CATEGORY",
+ *      },
+ *      loadChildren: () => import('./category/category.module').then((m) => m.ShopCategoryModule),
+ *    }
+ * ]
+ * ```
+ * {@link daffInsertDataPathStrategy }
+ * {@link DaffRouteWithDataPath }
+ */
+const daffDataPathUrlMatcher = (segments, group, route) => {
+    const path = daffUriTruncateLeadingSlash(segments.reduce((acc, segment) => acc + '/' + segment.path, ''));
+    const paths = route?.data?.daffPaths;
+    // If we don't have any paths, we can safely fail a match.
+    if (!paths) {
+        return null;
+    }
+    // Otherwise, look up the path in the dictionary, failing if a match isn't found,
+    // but matching the entire segment if a match is found.
+    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
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+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

@@ -0,0 +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/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":";;;;;;;AAEO,MAAM,sCAAsC,GAAoC;AACrF,IAAA,oBAAoB,EAAE,GAAG;AACzB,IAAA,sBAAsB,EAAE,GAAG;CAC5B,CAAC;AAEF;;;AAGG;MACU,2BAA2B,GAAG,IAAI,cAAc,CAE3D,6BAA6B,EAAE;AAC/B,IAAA,UAAU,EAAE,MAAM;AAClB,IAAA,OAAO,EAAE,MAAM,sCAAsC;AACtD,CAAA;;ACND;;AAEG;AACI,MAAM,8CAA8C,GAAG,IAAI,cAAc,CAE9E,6CAA6C,EAAE;AAC/C,IAAA,UAAU,EAAE,MAAM;AAClB,IAAA,OAAO,EAAE,MAAM,EAAE;AAClB,CAAA,CAAC,CAAC;AAEH;;AAEG;AACG,SAAU,gCAAgC,CAAC,aAAgC,EAAA;IAC/E,OAAO;AACL,QAAA,OAAO,EAAE,8CAA8C;AACvD,QAAA,KAAK,EAAE,IAAI;AACX,QAAA,QAAQ,EAAE,aAAa;KACxB,CAAC;AACJ,CAAC;AAED;;AAEG;AACG,SAAU,iCAAiC,CAAC,MAA2B,EAAA;IAC3E,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAwB,MAAM;AAC/C,QAAA,OAAO,EAAE,8CAA8C;AACvD,QAAA,KAAK,EAAE,IAAI;AACX,QAAA,QAAQ,EAAE,KAAK;AAChB,KAAA,CAAC,CAAC,CAAC;AACN;;AC1BA;;;AAGG;MAKU,wBAAwB,CAAA;AACnC,IAAA,OAAO,OAAO,CACZ,MAAgD,EAChD,SAA8B,EAAE,EAAA;QAEhC,OAAO;AACL,YAAA,QAAQ,EAAE,wBAAwB;AAClC,YAAA,SAAS,EAAE;AACT,gBAAA,EAAE,OAAO,EAAE,2BAA2B,EAAE,QAAQ,EAAE,EAAE,GAAG,sCAAsC,EAAE,GAAG,MAAM,EAAE,EAAC;gBAC3G,GAAG,iCAAiC,CAAC,MAAM,CAAC;AAC7C,aAAA;SACF,CAAC;KACH;;2JAZU,wBAAwB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,QAAA,EAAA,CAAA,CAAA;AAAxB,sCAAA,wBAAA,CAAA,IAAA,GAAA,EAAA,CAAA,mBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,wBAAwB,YAFzB,YAAY,CAAA,EAAA,CAAA,CAAA;4JAEX,wBAAwB,EAAA,OAAA,EAAA,CAF1B,CAAC,YAAY,CAAC,CAAA,EAAA,CAAA,CAAA;2FAEZ,wBAAwB,EAAA,UAAA,EAAA,CAAA;kBAJpC,QAAQ;AAAC,YAAA,IAAA,EAAA,CAAA;AACR,oBAAA,YAAY,EAAE,EAAE;oBAChB,OAAO,EAAE,CAAC,YAAY,CAAC;AACxB,iBAAA,CAAA;;;AChBD;;;AAGG;AACG,MAAO,iCAAkC,SAAQ,oBAAoB,CAAA;AAIzE,IAAA,WAAA,CAAY,OAAgB,EAAA;QAC3B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHA,IAAI,CAAA,IAAA,GAAW,mBAAmB,CAAC;KAIlD;AACF;;ACXD;;;AAGG;AACG,MAAO,uCAAwC,SAAQ,oBAAoB,CAAA;AAI/E,IAAA,WAAA,CAAY,OAAgB,EAAA;QAC3B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHA,IAAI,CAAA,IAAA,GAAW,oBAAoB,CAAC;KAInD;AACF;;ACXD;;AAEG;AACI,MAAM,iCAAiC,GAAG,CAC/C,aAA0C,EAC1C,cAAmC,KAClB;IACjB,MAAM,SAAS,GAAG,cAAc;AAC7B,SAAA,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,IAAI,CAAC;AAC1C,SAAA,KAAK,EAAE,CAAC;IACX,IAAI,CAAC,SAAS,EAAE;AACd,QAAA,MAAM,IAAI,uCAAuC,CAC/C,CAAA,6BAAA,EAAgC,aAAa,CAAC,GAAG,CAAA,gBAAA,EAAmB,aAAa,CAAC,IAAI,CAAA,oCAAA,CAAsC,CAC7H,CAAC;AACH,KAAA;IAED,OAAO;AACL,QAAA,KAAK,EAAE;YACL,IAAI,EAAE,aAAa,CAAC,GAAG;YACvB,qBAAqB,EAAE,aAAa,CAAC,IAAI;YACzC,GAAG,SAAS,CAAC,KAAK;AAClB,YAAA,IAAI,EAAE;gBACJ,GAAG,aAAa,CAAC,IAAI;AACtB,aAAA;AACF,SAAA;QACD,iBAAiB,EAAE,SAAS,CAAC,iBAAiB;KAC/C,CAAC;AACJ,CAAC;;ACxBD;;;AAGG;MACU,qCAAqC,GAAwC,CACxF,KAAY,EACZ,MAAc,KACJ;AACV,IAAA,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAQ,KAAK,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC9D,IAAA,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE;AAChB,QAAA,MAAM,IAAI,iCAAiC,CACzC,2DAA2D,CAC5D,CAAC;AACH,KAAA;IACD,OAAO;AACL,QAAA,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;QACzB,KAAK;AACL,QAAA,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;KACvB,CAAC;AACJ;;MCPa,kBAAkB,CAAA;IAC7B,WACU,CAAA,MAAc,EAEd,aAAkC,EAAA;QAFlC,IAAM,CAAA,MAAA,GAAN,MAAM,CAAQ;QAEd,IAAa,CAAA,aAAA,GAAb,aAAa,CAAqB;KACvC;AAEL;;AAEG;AACH,IAAA,GAAG,CAAC,aAA0C,EAAA;;AAE5C,QAAA,MAAM,EACJ,KAAK,EACL,iBAAiB,GAClB,GAAG,iCAAiC,CACnC,aAAa,EACb,IAAI,CAAC,aAAa,CACnB,CAAC;QAEF,IAAI;;AAEF,YAAA,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,iBAAiB,IAAI,qCAAqC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC9G,SAAA;AAAC,QAAA,OAAO,CAAC,EAAE;YACV,IAAI,CAAC,YAAY,iCAAiC,EAAE;gBAClD,MAAM,IAAI,iCAAiC,CACzC,CAAA,EAAG,CAAC,CAAC,OAAO,CAAyD,uDAAA,CAAA,CACtE,CAAC;AACH,aAAA;AAED,YAAA,MAAM,CAAC,CAAC;AACT,SAAA;KACF;;AAhCU,sCAAA,kBAAA,CAAA,IAAA,GAAA,EAAA,CAAA,kBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,kBAAkB,wCAGnB,8CAA8C,EAAA,CAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA,CAAA;AAH7C,sCAAA,kBAAA,CAAA,KAAA,GAAA,EAAA,CAAA,qBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,kBAAkB,cAFjB,MAAM,EAAA,CAAA,CAAA;2FAEP,kBAAkB,EAAA,UAAA,EAAA,CAAA;kBAH9B,UAAU;AAAC,YAAA,IAAA,EAAA,CAAA;AACV,oBAAA,UAAU,EAAE,MAAM;AACnB,iBAAA,CAAA;;0BAII,MAAM;2BAAC,8CAA8C,CAAA;;;ACR1D;;;;AAIG;AACH,MAAM,qBAAqB,GAAG,CAAC,KAAY,EAAE,IAA2B,KAAc,KAAK,EAAE,IAAI,EAAE,qBAAqB,KAAK,IAAI,CAAC;AAElI;;;;AAIG;AACH,MAAM,mBAAmB,GACvB,CAAC,KAA4B,EAAE,aAAoB,KAAI;AACrD,IAAA,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG;AACrB,QAAA,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS;AACvB,QAAA,CAAC,aAAa,CAAC,IAAI,GAAG,aAAa,CAAC,IAAI;KACzC,CAAC;AACF,IAAA,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEJ,MAAM,cAAc,GAClB,CAAC,aAAoB,KAAK,CAAC,KAA4B,KAAK,mBAAmB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;AAExG;;;;;AAKG;AACH,MAAM,iBAAiB,GAAG,CAAC,MAAiB,GAAA,EAAE,EAAE,OAAkC,EAAE,OAAsB,KAAY;AACpH,IAAA,IAAG,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE;AACtB,QAAA,OAAO,MAAM,CAAC;AACf,KAAA;IAED,MAAM,KAAK,GAAW,EAAE,CAAC;AACzB,IAAA,MAAM,QAAQ,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AACtC,IAAA,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAErB,OAAM,KAAK,CAAC,MAAM,EAAE;AAClB,QAAA,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;AAC1B,QAAA,IAAG,OAAO,CAAC,KAAK,CAAC,EAAE;YACjB,OAAO,CAAC,KAAK,CAAC,CAAC;YACf,MAAM;AACP,SAAA;QACD,IAAG,KAAK,CAAC,QAAQ,EAAC;YAChB,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;AACzC,SAAA;AACF,KAAA;AACD,IAAA,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCG;AACI,MAAM,0BAA0B,GAAwC,CAAC,aAAuD,EAAE,MAAc,KAAK,iBAAiB,CAC3K,MAAM,EACN,CAAC,KAAK,KAAK,qBAAqB,CAAC,KAAK,EAAE,aAAa,CAAC,qBAAqB,CAAC,EAC5E,cAAc,CAAC,aAAa,CAAC;;AClG/B;;;;;;;;;;;;;;;;;AAiBG;AACU,MAAA,sBAAsB,GAAe,CAAC,QAAsB,EAAE,KAAsB,EAAE,KAA4B,KAAI;IACjI,MAAM,IAAI,GAAG,2BAA2B,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAW,EAAE,OAAO,KAAK,GAAG,GAAG,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;AAClH,IAAA,MAAM,KAAK,GAAG,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC;;IAGrC,IAAG,CAAC,KAAK,EAAE;AACT,QAAA,OAAO,IAAI,CAAC;AACb,KAAA;;;AAID,IAAA,OAAO,IAAI,IAAI,KAAK,GAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;AACxD;;ACnCA;;;AAGG;MACU,uBAAuB,GAAG,CAAwB,QAAgC,EAAE,GAAY,KAAa;AACxH,IAAA,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClH,IAAA,OAAO,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,YAAY,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC;AACjE;;ACZA;;AAEG;;ACFH;;AAEG;;;;"}

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.39.13",
+  "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",
@@ -13,25 +13,101 @@
   },
   "homepage": "https://github.com/graycoreio/daffodil",
   "peerDependencies": {
-    "@angular/common": "^11.0.0",
-    "@angular/core": "^11.0.0",
-    "@angular/router": "^11.0.0",
-    "@daffodil/core": "0.39.13",
-    "rxjs": "6.6.3"
+    "@angular/common": "^13.0.0",
+    "@angular/core": "^13.0.0",
+    "@angular/router": "^13.0.0",
+    "@daffodil/core": "0.42.0",
+    "rxjs": "7.5.5"
   },
   "optionalDependencies": {
-    "apollo-angular": "^2.4.0",
-    "@daffodil/driver": "0.39.13"
+    "apollo-angular": "^3.0.1",
+    "@daffodil/driver": "0.42.0"
   },
-  "main": "bundles/daffodil-external-router.umd.js",
-  "module": "fesm2015/daffodil-external-router.js",
-  "es2015": "fesm2015/daffodil-external-router.js",
-  "esm2015": "esm2015/daffodil-external-router.js",
-  "fesm2015": "fesm2015/daffodil-external-router.js",
+  "module": "fesm2015/daffodil-external-router.mjs",
+  "es2020": "fesm2020/daffodil-external-router.mjs",
+  "esm2020": "esm2020/daffodil-external-router.mjs",
+  "fesm2020": "fesm2020/daffodil-external-router.mjs",
+  "fesm2015": "fesm2015/daffodil-external-router.mjs",
   "typings": "daffodil-external-router.d.ts",
-  "metadata": "daffodil-external-router.metadata.json",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./daffodil-external-router.d.ts",
+      "esm2020": "./esm2020/daffodil-external-router.mjs",
+      "es2020": "./fesm2020/daffodil-external-router.mjs",
+      "es2015": "./fesm2015/daffodil-external-router.mjs",
+      "node": "./fesm2015/daffodil-external-router.mjs",
+      "default": "./fesm2020/daffodil-external-router.mjs"
+    },
+    "./driver/in-memory": {
+      "types": "./driver/in-memory/daffodil-external-router-driver-in-memory.d.ts",
+      "esm2020": "./esm2020/driver/in-memory/daffodil-external-router-driver-in-memory.mjs",
+      "es2020": "./fesm2020/daffodil-external-router-driver-in-memory.mjs",
+      "es2015": "./fesm2015/daffodil-external-router-driver-in-memory.mjs",
+      "node": "./fesm2015/daffodil-external-router-driver-in-memory.mjs",
+      "default": "./fesm2020/daffodil-external-router-driver-in-memory.mjs"
+    },
+    "./driver/magento/2.4.1": {
+      "types": "./driver/magento/2.4.1/daffodil-external-router-driver-magento-2.4.1.d.ts",
+      "esm2020": "./esm2020/driver/magento/2.4.1/daffodil-external-router-driver-magento-2.4.1.mjs",
+      "es2020": "./fesm2020/daffodil-external-router-driver-magento-2.4.1.mjs",
+      "es2015": "./fesm2015/daffodil-external-router-driver-magento-2.4.1.mjs",
+      "node": "./fesm2015/daffodil-external-router-driver-magento-2.4.1.mjs",
+      "default": "./fesm2020/daffodil-external-router-driver-magento-2.4.1.mjs"
+    },
+    "./driver/magento/2.4.2": {
+      "types": "./driver/magento/2.4.2/daffodil-external-router-driver-magento-2.4.2.d.ts",
+      "esm2020": "./esm2020/driver/magento/2.4.2/daffodil-external-router-driver-magento-2.4.2.mjs",
+      "es2020": "./fesm2020/daffodil-external-router-driver-magento-2.4.2.mjs",
+      "es2015": "./fesm2015/daffodil-external-router-driver-magento-2.4.2.mjs",
+      "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",
+      "es2020": "./fesm2020/daffodil-external-router-driver-magento.mjs",
+      "es2015": "./fesm2015/daffodil-external-router-driver-magento.mjs",
+      "node": "./fesm2015/daffodil-external-router-driver-magento.mjs",
+      "default": "./fesm2020/daffodil-external-router-driver-magento.mjs"
+    },
+    "./driver": {
+      "types": "./driver/daffodil-external-router-driver.d.ts",
+      "esm2020": "./esm2020/driver/daffodil-external-router-driver.mjs",
+      "es2020": "./fesm2020/daffodil-external-router-driver.mjs",
+      "es2015": "./fesm2015/daffodil-external-router-driver.mjs",
+      "node": "./fesm2015/daffodil-external-router-driver.mjs",
+      "default": "./fesm2020/daffodil-external-router-driver.mjs"
+    },
+    "./driver/testing": {
+      "types": "./driver/testing/daffodil-external-router-driver-testing.d.ts",
+      "esm2020": "./esm2020/driver/testing/daffodil-external-router-driver-testing.mjs",
+      "es2020": "./fesm2020/daffodil-external-router-driver-testing.mjs",
+      "es2015": "./fesm2015/daffodil-external-router-driver-testing.mjs",
+      "node": "./fesm2015/daffodil-external-router-driver-testing.mjs",
+      "default": "./fesm2020/daffodil-external-router-driver-testing.mjs"
+    },
+    "./routing": {
+      "types": "./routing/daffodil-external-router-routing.d.ts",
+      "esm2020": "./esm2020/routing/daffodil-external-router-routing.mjs",
+      "es2020": "./fesm2020/daffodil-external-router-routing.mjs",
+      "es2015": "./fesm2015/daffodil-external-router-routing.mjs",
+      "node": "./fesm2015/daffodil-external-router-routing.mjs",
+      "default": "./fesm2020/daffodil-external-router-routing.mjs"
+    }
+  },
   "sideEffects": false,
   "dependencies": {
-    "tslib": "^2.0.0"
+    "tslib": "^2.3.0"
   }
 }

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/router/router.service.d.ts

@@ -1,6 +1,7 @@
 import { Router } from '@angular/router';
 import { DaffExternallyResolvableUrl } from '../model/resolvable-route';
 import { DaffTypeRoutePair } from '../model/type-route-pair';
+import * as i0 from "@angular/core";
 export declare class DaffExternalRouter {
     private router;
     private runtimeRoutes;
@@ -9,4 +10,6 @@ export declare class DaffExternalRouter {
      * Adds a route to the existing router configuration.
      */
     add(resolvedRoute: DaffExternallyResolvableUrl): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DaffExternalRouter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<DaffExternalRouter>;
 }

package/routing/daffodil-external-router-routing.d.ts

@@ -1,4 +1,5 @@
 /**
  * Generated bundle index. Do not edit.
  */
+/// <amd-module name="@daffodil/external-router/routing" />
 export * from './index';

package/routing/guard/existence.guard.d.ts

@@ -3,6 +3,7 @@ import { Observable } from 'rxjs';
 import { DaffRoutingUriNormalizer } from '@daffodil/core/routing';
 import { DaffExternalRouter, DaffExternalRouterConfiguration } from '@daffodil/external-router';
 import { DaffExternalRouterDriverInterface } from '@daffodil/external-router/driver';
+import * as i0 from "@angular/core";
 /**
  * The DaffExternalRouterExistenceGuard is responsible for guarding the wildcard route
  * of an Angular App and either navigating to a resolved route upon successful resolution
@@ -16,4 +17,6 @@ export declare class DaffExternalRouterExistenceGuard implements CanActivate {
     private urlNormalizer;
     constructor(driver: DaffExternalRouterDriverInterface, externalRouter: DaffExternalRouter, router: Router, config: DaffExternalRouterConfiguration, urlNormalizer: DaffRoutingUriNormalizer);
     canActivate(next: ActivatedRouteSnapshot, state: RouterStateSnapshot): Observable<UrlTree | boolean>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DaffExternalRouterExistenceGuard, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<DaffExternalRouterExistenceGuard>;
 }

package/routing/package.json

@@ -1,11 +1,10 @@
 {
   "name": "@daffodil/external-router/routing",
-  "main": "../bundles/daffodil-external-router-routing.umd.js",
-  "module": "../fesm2015/daffodil-external-router-routing.js",
-  "es2015": "../fesm2015/daffodil-external-router-routing.js",
-  "esm2015": "../esm2015/routing/daffodil-external-router-routing.js",
-  "fesm2015": "../fesm2015/daffodil-external-router-routing.js",
+  "module": "../fesm2015/daffodil-external-router-routing.mjs",
+  "es2020": "../fesm2020/daffodil-external-router-routing.mjs",
+  "esm2020": "../esm2020/routing/daffodil-external-router-routing.mjs",
+  "fesm2020": "../fesm2020/daffodil-external-router-routing.mjs",
+  "fesm2015": "../fesm2015/daffodil-external-router-routing.mjs",
   "typings": "daffodil-external-router-routing.d.ts",
-  "metadata": "daffodil-external-router-routing.metadata.json",
   "sideEffects": false
 }

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;