@koala-ts/framework 2.14.1 → 2.16.0

package/dist/routing/source/create-path-catalog.test.js

@@ -0,0 +1,62 @@
+import { describe, expect, test, vi } from 'vitest';
+import { Get } from '../../routing/helpers/http-verb-helpers.js';
+import { RouteGroup } from '../../routing/helpers/route-group.js';
+import { Route } from '../../routing/route.js';
+import { createPathCatalog } from './create-path-catalog.js';
+describe('create path catalog', () => {
+    test('it collects named route paths from route sources', () => {
+        const routes = [
+            Get('/users', 'users.index', vi.fn(async () => undefined)),
+            Route({
+                name: 'users.show',
+                method: 'GET',
+                path: '/users/:id',
+                handler: vi.fn(async () => undefined),
+            }),
+        ];
+        const catalog = createPathCatalog(routes);
+        expect(catalog).toEqual(new Map([
+            ['users.index', '/users'],
+            ['users.show', '/users/:id'],
+        ]));
+    });
+    test('it collects grouped route names using their normalized paths', () => {
+        const routes = [
+            RouteGroup({
+                prefix: '/api',
+                namePrefix: 'api.',
+            }, () => [
+                Get('/users/:id', 'users.show', vi.fn(async () => undefined)),
+            ]),
+        ];
+        const catalog = createPathCatalog(routes);
+        expect(catalog).toEqual(new Map([['api.users.show', '/api/users/:id']]));
+    });
+    test('it ignores unnamed routes', () => {
+        const routes = [
+            Get('/users', vi.fn(async () => undefined)),
+            Get('/users/:id', 'users.show', vi.fn(async () => undefined)),
+        ];
+        const catalog = createPathCatalog(routes);
+        expect(catalog).toEqual(new Map([['users.show', '/users/:id']]));
+    });
+    test('it throws when normalized route names are duplicated', () => {
+        const routes = [
+            RouteGroup({
+                prefix: '/api',
+                namePrefix: 'api.',
+            }, () => [
+                Get('/users', 'users.index', vi.fn(async () => undefined)),
+            ]),
+            Route({
+                name: 'api.users.index',
+                method: 'GET',
+                path: '/members',
+                handler: vi.fn(async () => undefined),
+            }),
+        ];
+        const createCatalog = () => createPathCatalog(routes);
+        expect(createCatalog).toThrow('Duplicate route name detected: api.users.index.');
+    });
+});
+//# sourceMappingURL=create-path-catalog.test.js.map

package/dist/routing/source/create-path-catalog.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-path-catalog.test.js","sourceRoot":"","sources":["../../../src/routing/source/create-path-catalog.test.ts"],"names":[],"mappings":"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"}

package/dist/routing/source/normalize-route-sources.d.ts

@@ -0,0 +1,10 @@
+import type { RouteDefinition } from '../../routing/definition/route-definition.js';
+import type { RouteSource } from './route-source.js';
+interface NormalizationContext {
+    prefix: string;
+    namePrefix: string;
+    middleware: RouteDefinition['middleware'];
+}
+export declare function normalizeRouteSources(routeSources: RouteSource[], context?: NormalizationContext): RouteDefinition[];
+export {};
+//# sourceMappingURL=normalize-route-sources.d.ts.map

package/dist/routing/source/normalize-route-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-route-sources.d.ts","sourceRoot":"","sources":["../../../src/routing/source/normalize-route-sources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAG7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,UAAU,oBAAoB;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;CAC3C;AAQD,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,WAAW,EAAE,EAC3B,OAAO,GAAE,oBAAkD,GAC1D,eAAe,EAAE,CAanB"}

package/dist/routing/source/normalize-route-sources.js

@@ -0,0 +1,82 @@
+import { mergeRouteOptions } from '../../routing/definition/resolve-route-options.js';
+const defaultNormalizationContext = {
+    prefix: '',
+    namePrefix: '',
+    middleware: [],
+};
+export function normalizeRouteSources(routeSources, context = defaultNormalizationContext) {
+    const routes = [];
+    for (const routeSource of routeSources) {
+        if (isRouteGroupDefinition(routeSource)) {
+            routes.push(...normalizeRouteGroup(routeSource, context));
+            continue;
+        }
+        routes.push(normalizeRouteDefinition(routeSource, context));
+    }
+    return routes;
+}
+function normalizeRouteGroup(group, parentContext) {
+    const context = createChildContext(group, parentContext);
+    return normalizeRouteSources(applyRouteConfig(group.resolveRoutes(), group), context);
+}
+function createChildContext(group, parentContext) {
+    return {
+        prefix: group.options.prefix === undefined
+            ? parentContext.prefix
+            : joinRoutePath(parentContext.prefix, group.options.prefix),
+        namePrefix: `${parentContext.namePrefix}${group.options.namePrefix ?? ''}`,
+        middleware: [...parentContext.middleware, ...(group.options.middleware ?? [])],
+    };
+}
+function normalizeRouteDefinition(route, context) {
+    return {
+        ...route,
+        path: joinRoutePath(context.prefix, route.path),
+        name: route.name ? `${context.namePrefix}${route.name}` : undefined,
+        middleware: [...context.middleware, ...route.middleware],
+    };
+}
+function applyRouteConfig(routeSources, group) {
+    return routeSources.map(routeSource => {
+        if (isRouteGroupDefinition(routeSource)) {
+            return routeSource;
+        }
+        const routeConfig = routeSource.name ? group.options.routeConfig?.[routeSource.name] : undefined;
+        if (!routeConfig) {
+            return routeSource;
+        }
+        return {
+            ...routeSource,
+            middleware: [...(routeConfig.middleware ?? []), ...routeSource.middleware],
+            ...resolveRouteConfigOptions(routeSource, routeConfig),
+        };
+    });
+}
+function resolveRouteConfigOptions(route, routeConfig) {
+    return routeConfig.options ? mergeRouteOptions(route, routeConfig.options) : {};
+}
+function isRouteGroupDefinition(routeSource) {
+    return 'kind' in routeSource && routeSource.kind === 'route-group';
+}
+function joinRoutePath(prefix, path) {
+    const normalizedPrefix = trimTrailingSlash(prefix);
+    const normalizedPath = trimLeadingSlash(path);
+    if (normalizedPrefix === '') {
+        return normalizedPath === '' ? '/' : `/${normalizedPath}`;
+    }
+    if (normalizedPath === '') {
+        return normalizedPrefix;
+    }
+    return `${normalizedPrefix}/${normalizedPath}`;
+}
+function trimLeadingSlash(value) {
+    return value.replace(/^\/+/, '');
+}
+function trimTrailingSlash(value) {
+    if (value === '') {
+        return value;
+    }
+    const normalized = value.replace(/\/+$/, '');
+    return normalized === '' ? '' : normalized;
+}
+//# sourceMappingURL=normalize-route-sources.js.map

package/dist/routing/source/normalize-route-sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-route-sources.js","sourceRoot":"","sources":["../../../src/routing/source/normalize-route-sources.ts"],"names":[],"mappings":"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"}

package/dist/routing/source/normalize-route-sources.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=normalize-route-sources.test.d.ts.map

package/dist/routing/source/normalize-route-sources.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-route-sources.test.d.ts","sourceRoot":"","sources":["../../../src/routing/source/normalize-route-sources.test.ts"],"names":[],"mappings":""}

package/dist/routing/source/normalize-route-sources.test.js

@@ -0,0 +1,268 @@
+import { describe, expect, test, vi } from 'vitest';
+import { Get } from '../../routing/helpers/http-verb-helpers.js';
+import { RouteGroup } from '../../routing/helpers/route-group.js';
+import { normalizeRouteSources } from './normalize-route-sources.js';
+describe('normalize route sources', () => {
+    test('it composes group prefixes and middleware into child routes', () => {
+        const auth = vi.fn(async () => undefined);
+        const routeMiddleware = vi.fn(async () => undefined);
+        const handler = vi.fn(async () => undefined);
+        const route = Get('/users', handler);
+        route.middleware = [routeMiddleware];
+        const routes = normalizeRouteSources([
+            RouteGroup({
+                prefix: '/api',
+                middleware: [auth],
+            }, () => [route]),
+        ]);
+        expect(routes).toEqual([
+            {
+                ...route,
+                path: '/api/users',
+                middleware: [auth, routeMiddleware],
+            },
+        ]);
+    });
+    test('it composes nested group prefixes and name prefixes', () => {
+        const handler = vi.fn(async () => undefined);
+        const routes = normalizeRouteSources([
+            RouteGroup({
+                prefix: '/api',
+                namePrefix: 'api.',
+            }, () => [
+                RouteGroup({
+                    prefix: '/posts',
+                    namePrefix: 'posts.',
+                }, () => [Get('/', 'list', handler)]),
+            ]),
+        ]);
+        expect(routes).toEqual([
+            {
+                bodyOptions: {},
+                handler,
+                methods: ['get'],
+                middleware: [],
+                name: 'api.posts.list',
+                parseBody: true,
+                path: '/api/posts',
+            },
+        ]);
+    });
+    test('it keeps the root path when both group prefix and child path are empty roots', () => {
+        const handler = vi.fn(async () => undefined);
+        const routes = normalizeRouteSources([
+            RouteGroup({
+                prefix: '/',
+            }, () => [Get('/', handler)]),
+        ]);
+        expect(routes).toEqual([
+            {
+                bodyOptions: {},
+                handler,
+                methods: ['get'],
+                middleware: [],
+                parseBody: true,
+                path: '/',
+            },
+        ]);
+    });
+    test('it treats a root group prefix as no prefix for non-root child paths', () => {
+        const handler = vi.fn(async () => undefined);
+        const routes = normalizeRouteSources([
+            RouteGroup({
+                prefix: '/',
+            }, () => [Get('/users', handler)]),
+        ]);
+        expect(routes).toEqual([
+            {
+                bodyOptions: {},
+                handler,
+                methods: ['get'],
+                middleware: [],
+                parseBody: true,
+                path: '/users',
+            },
+        ]);
+    });
+    test('it keeps the normalized group prefix when the child path is empty', () => {
+        const handler = vi.fn(async () => undefined);
+        const routes = normalizeRouteSources([
+            RouteGroup({
+                prefix: '/api/',
+            }, () => [
+                {
+                    bodyOptions: {},
+                    handler,
+                    methods: ['get'],
+                    middleware: [],
+                    parseBody: true,
+                    path: '/',
+                },
+            ]),
+        ]);
+        expect(routes).toEqual([
+            {
+                bodyOptions: {},
+                handler,
+                methods: ['get'],
+                middleware: [],
+                parseBody: true,
+                path: '/api',
+            },
+        ]);
+    });
+    test('it keeps the parent prefix when a nested group omits its own prefix', () => {
+        const handler = vi.fn(async () => undefined);
+        const routes = normalizeRouteSources([
+            RouteGroup({
+                prefix: '/api',
+            }, () => [RouteGroup({}, () => [Get('/users', handler)])]),
+        ]);
+        expect(routes).toEqual([
+            {
+                bodyOptions: {},
+                handler,
+                methods: ['get'],
+                middleware: [],
+                parseBody: true,
+                path: '/api/users',
+            },
+        ]);
+    });
+    test('it applies route overlays to direct child routes by local name', () => {
+        const groupMiddleware = vi.fn(async () => undefined);
+        const overlayMiddleware = vi.fn(async () => undefined);
+        const routeMiddleware = vi.fn(async () => undefined);
+        const handler = vi.fn(async () => undefined);
+        const route = Get('/posts', 'create', handler);
+        route.middleware = [routeMiddleware];
+        const routes = normalizeRouteSources([
+            RouteGroup({
+                middleware: [groupMiddleware],
+                routeConfig: {
+                    create: {
+                        middleware: [overlayMiddleware],
+                        options: {
+                            multipart: true,
+                            parseBody: false,
+                        },
+                    },
+                },
+            }, () => [route]),
+        ]);
+        expect(routes).toEqual([
+            {
+                ...route,
+                middleware: [groupMiddleware, overlayMiddleware, routeMiddleware],
+                parseBody: false,
+                bodyOptions: {
+                    multipart: true,
+                },
+            },
+        ]);
+    });
+    test('it does not apply parent route overlays to nested child routes', () => {
+        const overlayMiddleware = vi.fn(async () => undefined);
+        const handler = vi.fn(async () => undefined);
+        const routes = normalizeRouteSources([
+            RouteGroup({
+                routeConfig: {
+                    create: {
+                        middleware: [overlayMiddleware],
+                    },
+                },
+            }, () => [
+                RouteGroup({
+                    prefix: '/posts',
+                }, () => [Get('/', 'create', handler)]),
+            ]),
+        ]);
+        expect(routes).toEqual([
+            {
+                bodyOptions: {},
+                handler,
+                methods: ['get'],
+                middleware: [],
+                name: 'create',
+                parseBody: true,
+                path: '/posts',
+            },
+        ]);
+    });
+    test('it keeps unnamed direct child routes unchanged when route config is present', () => {
+        const overlayMiddleware = vi.fn(async () => undefined);
+        const handler = vi.fn(async () => undefined);
+        const routes = normalizeRouteSources([
+            RouteGroup({
+                routeConfig: {
+                    create: {
+                        middleware: [overlayMiddleware],
+                    },
+                },
+            }, () => [Get('/posts', handler)]),
+        ]);
+        expect(routes).toEqual([
+            {
+                bodyOptions: {},
+                handler,
+                methods: ['get'],
+                middleware: [],
+                parseBody: true,
+                path: '/posts',
+            },
+        ]);
+    });
+    test('it applies middleware-only route overlays without changing route options', () => {
+        const overlayMiddleware = vi.fn(async () => undefined);
+        const handler = vi.fn(async () => undefined);
+        const routes = normalizeRouteSources([
+            RouteGroup({
+                routeConfig: {
+                    create: {
+                        middleware: [overlayMiddleware],
+                    },
+                },
+            }, () => [Get('/posts', 'create', handler)]),
+        ]);
+        expect(routes).toEqual([
+            {
+                bodyOptions: {},
+                handler,
+                methods: ['get'],
+                middleware: [overlayMiddleware],
+                name: 'create',
+                parseBody: true,
+                path: '/posts',
+            },
+        ]);
+    });
+    test('it applies options-only route overlays without changing middleware', () => {
+        const handler = vi.fn(async () => undefined);
+        const routes = normalizeRouteSources([
+            RouteGroup({
+                routeConfig: {
+                    create: {
+                        options: {
+                            multipart: true,
+                            parseBody: false,
+                        },
+                    },
+                },
+            }, () => [Get('/posts', 'create', handler)]),
+        ]);
+        expect(routes).toEqual([
+            {
+                bodyOptions: {
+                    multipart: true,
+                },
+                handler,
+                methods: ['get'],
+                middleware: [],
+                name: 'create',
+                parseBody: false,
+                path: '/posts',
+            },
+        ]);
+    });
+});
+//# sourceMappingURL=normalize-route-sources.test.js.map

package/dist/routing/source/normalize-route-sources.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-route-sources.test.js","sourceRoot":"","sources":["../../../src/routing/source/normalize-route-sources.test.ts"],"names":[],"mappings":"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"}

package/dist/routing/source/resolve-path-template.d.ts

@@ -0,0 +1,6 @@
+type PathParamValue = string | number | boolean;
+type PathParams = Record<string, PathParamValue>;
+export declare function resolvePathTemplate(pathTemplate: string, params?: PathParams): string;
+export declare function createPathTemplateResolver(pathTemplate: string): (params?: PathParams) => string;
+export {};
+//# sourceMappingURL=resolve-path-template.d.ts.map

package/dist/routing/source/resolve-path-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-path-template.d.ts","sourceRoot":"","sources":["../../../src/routing/source/resolve-path-template.ts"],"names":[],"mappings":"AAAA,KAAK,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAChD,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAWjD,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,GAAE,UAAe,GAAG,MAAM,CAEzF;AAED,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,CAAC,MAAM,CAAC,EAAE,UAAU,KAAK,MAAM,CAuBhG"}

package/dist/routing/source/resolve-path-template.js

@@ -0,0 +1,58 @@
+export function resolvePathTemplate(pathTemplate, params = {}) {
+    return createPathTemplateResolver(pathTemplate)(params);
+}
+export function createPathTemplateResolver(pathTemplate) {
+    const segments = parsePathTemplate(pathTemplate);
+    return (params = {}) => {
+        let path = '';
+        for (const segment of segments) {
+            if (segment.kind === 'static') {
+                path += segment.value;
+                continue;
+            }
+            const value = params[segment.key];
+            if (value === undefined) {
+                throw new Error(`Missing required path parameter: ${segment.key}.`);
+            }
+            path += encodeURIComponent(String(value));
+        }
+        return path;
+    };
+}
+function parsePathTemplate(pathTemplate) {
+    const segments = [];
+    const pattern = /:([A-Za-z0-9_]+)/g;
+    let lastIndex = 0;
+    for (const match of pathTemplate.matchAll(pattern)) {
+        const index = match.index;
+        const placeholder = match[0];
+        const key = match[1];
+        if (index > lastIndex) {
+            segments.push({
+                kind: 'static',
+                value: pathTemplate.slice(lastIndex, index),
+            });
+        }
+        segments.push({
+            kind: 'param',
+            key,
+        });
+        lastIndex = index + placeholder.length;
+    }
+    if (lastIndex < pathTemplate.length) {
+        segments.push({
+            kind: 'static',
+            value: pathTemplate.slice(lastIndex),
+        });
+    }
+    if (segments.length === 0) {
+        return [
+            {
+                kind: 'static',
+                value: pathTemplate,
+            },
+        ];
+    }
+    return segments;
+}
+//# sourceMappingURL=resolve-path-template.js.map

package/dist/routing/source/resolve-path-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-path-template.js","sourceRoot":"","sources":["../../../src/routing/source/resolve-path-template.ts"],"names":[],"mappings":"AAYA,MAAM,UAAU,mBAAmB,CAAC,YAAoB,EAAE,SAAqB,EAAE;IAC/E,OAAO,0BAA0B,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,YAAoB;IAC7D,MAAM,QAAQ,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAEjD,OAAO,CAAC,SAAqB,EAAE,EAAE,EAAE;QACjC,IAAI,IAAI,GAAG,EAAE,CAAC;QAEd,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC9B,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC;gBACtB,SAAS;YACX,CAAC;YAED,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAElC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,oCAAoC,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;YACtE,CAAC;YAED,IAAI,IAAI,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,YAAoB;IAC7C,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,mBAAmB,CAAC;IACpC,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,MAAM,KAAK,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAe,CAAC;QACpC,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAW,CAAC;QAE/B,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;YACtB,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC;aAC5C,CAAC,CAAC;QACL,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,OAAO;YACb,GAAG;SACJ,CAAC,CAAC;QAEH,SAAS,GAAG,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC;IACzC,CAAC;IAED,IAAI,SAAS,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC;QACpC,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC;SACrC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL;gBACE,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,YAAY;aACpB;SACF,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/routing/source/resolve-path-template.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=resolve-path-template.test.d.ts.map

package/dist/routing/source/resolve-path-template.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-path-template.test.d.ts","sourceRoot":"","sources":["../../../src/routing/source/resolve-path-template.test.ts"],"names":[],"mappings":""}

package/dist/routing/source/resolve-path-template.test.js

@@ -0,0 +1,44 @@
+import { describe, expect, test } from 'vitest';
+import { createPathTemplateResolver, resolvePathTemplate } from './resolve-path-template.js';
+describe('resolve path template', () => {
+    describe('path resolution', () => {
+        test('it returns a static path unchanged', () => {
+            const path = resolvePathTemplate('/users');
+            expect(path).toBe('/users');
+        });
+        test('it returns an empty path template unchanged', () => {
+            const path = resolvePathTemplate('');
+            expect(path).toBe('');
+        });
+        test('it replaces a path parameter with its value', () => {
+            const path = resolvePathTemplate('/users/:id', { id: '42' });
+            expect(path).toBe('/users/42');
+        });
+        test('it replaces multiple path parameters', () => {
+            const path = resolvePathTemplate('/teams/:teamId/users/:userId', {
+                teamId: 'alpha',
+                userId: '42',
+            });
+            expect(path).toBe('/teams/alpha/users/42');
+        });
+        test('it resolves a template that starts with a path parameter', () => {
+            const path = resolvePathTemplate(':id/details', { id: '42' });
+            expect(path).toBe('42/details');
+        });
+        test('it creates a reusable resolver for a path template', () => {
+            const resolvePath = createPathTemplateResolver('/teams/:teamId/users/:userId');
+            const path = resolvePath({
+                teamId: 'alpha',
+                userId: '42',
+            });
+            expect(path).toBe('/teams/alpha/users/42');
+        });
+    });
+    describe('errors', () => {
+        test('it throws when a required path parameter is missing', () => {
+            const act = () => resolvePathTemplate('/users/:id');
+            expect(act).toThrow('Missing required path parameter: id.');
+        });
+    });
+});
+//# sourceMappingURL=resolve-path-template.test.js.map

package/dist/routing/source/resolve-path-template.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-path-template.test.js","sourceRoot":"","sources":["../../../src/routing/source/resolve-path-template.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE1F,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;QAC/B,IAAI,CAAC,oCAAoC,EAAE,GAAG,EAAE;YAC9C,MAAM,IAAI,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAE3C,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACvD,MAAM,IAAI,GAAG,mBAAmB,CAAC,EAAE,CAAC,CAAC;YAErC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACvD,MAAM,IAAI,GAAG,mBAAmB,CAAC,YAAY,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YAE7D,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAChD,MAAM,IAAI,GAAG,mBAAmB,CAAC,8BAA8B,EAAE;gBAC/D,MAAM,EAAE,OAAO;gBACf,MAAM,EAAE,IAAI;aACb,CAAC,CAAC;YAEH,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,0DAA0D,EAAE,GAAG,EAAE;YACpE,MAAM,IAAI,GAAG,mBAAmB,CAAC,aAAa,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YAE9D,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,oDAAoD,EAAE,GAAG,EAAE;YAC9D,MAAM,WAAW,GAAG,0BAA0B,CAAC,8BAA8B,CAAC,CAAC;YAE/E,MAAM,IAAI,GAAG,WAAW,CAAC;gBACvB,MAAM,EAAE,OAAO;gBACf,MAAM,EAAE,IAAI;aACb,CAAC,CAAC;YAEH,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;QACtB,IAAI,CAAC,qDAAqD,EAAE,GAAG,EAAE;YAC/D,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;YAEpD,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/routing/source/route-source.d.ts

@@ -0,0 +1,4 @@
+import type { RouteDefinition } from '../../routing/definition/route-definition.js';
+import type { RouteGroupDefinition } from '../../routing/helpers/route-group.js';
+export type RouteSource = RouteDefinition | RouteGroupDefinition;
+//# sourceMappingURL=route-source.d.ts.map

package/dist/routing/source/route-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-source.d.ts","sourceRoot":"","sources":["../../../src/routing/source/route-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,oBAAoB,CAAC"}

package/dist/routing/source/route-source.js

@@ -0,0 +1 @@
+//# sourceMappingURL=route-source.js.map

package/dist/routing/source/route-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-source.js","sourceRoot":"","sources":["../../../src/routing/source/route-source.ts"],"names":[],"mappings":""}

package/dist/routing/validation/validate-route-definitions.d.ts

@@ -0,0 +1,4 @@
+import type { RouteDefinition } from '../../routing/definition/route-definition.js';
+import type { RouteRegistration } from '../../routing/registration/route-registration.js';
+export declare function validateRouteDefinitions(routes: RouteDefinition[], registrations: RouteRegistration[]): void;
+//# sourceMappingURL=validate-route-definitions.d.ts.map

package/dist/routing/validation/validate-route-definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-route-definitions.d.ts","sourceRoot":"","sources":["../../../src/routing/validation/validate-route-definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAEnF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,aAAa,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAG5G"}