@adtrackify/at-service-common 3.17.6 → 3.17.8

package/dist/cjs/__tests__/unit/libs/api-router/public-api-router.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/__tests__/unit/libs/api-router/public-api-router.spec.js

@@ -0,0 +1,198 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const public_api_router_js_1 = require("../../../../libs/api-router/public-api-router.js");
+const ok = (body = { ok: true }) => ({ statusCode: 200, body: JSON.stringify(body) });
+const baseEvent = (overrides) => {
+    const { httpMethod, proxy, ...rest } = overrides;
+    return {
+        httpMethod,
+        path: `/api/${proxy}`,
+        requestContext: {
+            authorizer: {
+                pixelId: 'px_1',
+                accountId: 'acc_1',
+                scopes: 'account:read',
+            },
+        },
+        pathParameters: { proxy },
+        queryStringParameters: null,
+        body: null,
+        ...rest,
+    };
+};
+const ctx = { awsRequestId: 'req_1' };
+describe('createPublicApiRouter', () => {
+    it('dispatches to the route handler for a literal path', async () => {
+        const getAccount = jest.fn().mockResolvedValue(ok());
+        const routes = [
+            { method: 'GET', path: '/api/account', handler: getAccount },
+        ];
+        const handler = (0, public_api_router_js_1.createPublicApiRouter)(routes);
+        const result = await handler(baseEvent({ httpMethod: 'GET', proxy: 'account' }), ctx);
+        expect(result.statusCode).toBe(200);
+        expect(getAccount).toHaveBeenCalledTimes(1);
+    });
+    it('extracts named path parameters and clears the API-GW {proxy+} placeholder', async () => {
+        const updateCog = jest.fn().mockResolvedValue(ok());
+        const routes = [
+            { method: 'PUT', path: '/api/products/:productId/:variantId/cogs/:cogId', handler: updateCog },
+        ];
+        const handler = (0, public_api_router_js_1.createPublicApiRouter)(routes);
+        await handler(baseEvent({
+            httpMethod: 'PUT',
+            proxy: 'products/prd_1/var_2/cogs/cog_3',
+            body: JSON.stringify({ cost: 5 }),
+        }), ctx);
+        expect(updateCog).toHaveBeenCalledTimes(1);
+        const dispatched = updateCog.mock.calls[0][0];
+        expect(dispatched.pathParameters).toEqual({
+            productId: 'prd_1',
+            variantId: 'var_2',
+            cogId: 'cog_3',
+        });
+        expect(dispatched.pathParameters?.proxy).toBeUndefined();
+    });
+    it('routes off pathParameters.proxy, not event.path (custom-domain basePath regression)', async () => {
+        const getAccount = jest.fn().mockResolvedValue(ok());
+        const routes = [
+            { method: 'GET', path: '/api/account', handler: getAccount },
+        ];
+        const handler = (0, public_api_router_js_1.createPublicApiRouter)(routes);
+        const event = baseEvent({ httpMethod: 'GET', proxy: 'account' });
+        event.path = '/accounts/api/account';
+        const result = await handler(event, ctx);
+        expect(result.statusCode).toBe(200);
+        expect(getAccount).toHaveBeenCalledTimes(1);
+    });
+    it('passes path params through unchanged (API GW already decoded them, no double-decode)', async () => {
+        const updateCog = jest.fn().mockResolvedValue(ok());
+        const routes = [
+            { method: 'PUT', path: '/api/products/:productId/:variantId/cogs/:cogId', handler: updateCog },
+        ];
+        const handler = (0, public_api_router_js_1.createPublicApiRouter)(routes);
+        await handler(baseEvent({
+            httpMethod: 'PUT',
+            proxy: 'products/prd_a/var_b/cogs/cog_c%10',
+            body: JSON.stringify({ cost: 5 }),
+        }), ctx);
+        expect(updateCog).toHaveBeenCalledTimes(1);
+        const dispatched = updateCog.mock.calls[0][0];
+        expect(dispatched.pathParameters?.cogId).toBe('cog_c%10');
+    });
+    it('returns 404 when no route matches', async () => {
+        const getAccount = jest.fn().mockResolvedValue(ok());
+        const routes = [
+            { method: 'GET', path: '/api/account', handler: getAccount },
+        ];
+        const handler = (0, public_api_router_js_1.createPublicApiRouter)(routes);
+        const result = await handler(baseEvent({ httpMethod: 'GET', proxy: 'nope' }), ctx);
+        expect(result.statusCode).toBe(404);
+        expect(getAccount).not.toHaveBeenCalled();
+    });
+    it('does not log a 404 at error level (avoids double-log + false-positive error alerts)', async () => {
+        const loggingHelper = await Promise.resolve().then(() => __importStar(require('../../../../helpers/logging-helper.js')));
+        const errorSpy = jest.spyOn(loggingHelper.Logger, 'error').mockImplementation(() => undefined);
+        const warnSpy = jest.spyOn(loggingHelper.Logger, 'warn').mockImplementation(() => undefined);
+        try {
+            const routes = [
+                { method: 'GET', path: '/api/account', handler: jest.fn().mockResolvedValue(ok()) },
+            ];
+            const handler = (0, public_api_router_js_1.createPublicApiRouter)(routes);
+            const result = await handler(baseEvent({ httpMethod: 'GET', proxy: 'nope' }), ctx);
+            expect(result.statusCode).toBe(404);
+            expect(warnSpy).toHaveBeenCalledTimes(1);
+            expect(errorSpy).not.toHaveBeenCalled();
+        }
+        finally {
+            errorSpy.mockRestore();
+            warnSpy.mockRestore();
+        }
+    });
+    it('handles OPTIONS preflight without invoking any downstream handler', async () => {
+        const getAccount = jest.fn().mockResolvedValue(ok());
+        const routes = [
+            { method: 'GET', path: '/api/account', handler: getAccount },
+        ];
+        const handler = (0, public_api_router_js_1.createPublicApiRouter)(routes);
+        const result = await handler(baseEvent({ httpMethod: 'OPTIONS', proxy: 'account' }), ctx);
+        expect(result.statusCode).toBe(200);
+        expect(getAccount).not.toHaveBeenCalled();
+    });
+    it('treats OPTIONS case-insensitively (matches matchRoute method-case contract)', async () => {
+        const getAccount = jest.fn().mockResolvedValue(ok());
+        const routes = [
+            { method: 'GET', path: '/api/account', handler: getAccount },
+        ];
+        const handler = (0, public_api_router_js_1.createPublicApiRouter)(routes);
+        const result = await handler(baseEvent({ httpMethod: 'options', proxy: 'account' }), ctx);
+        expect(result.statusCode).toBe(200);
+        expect(getAccount).not.toHaveBeenCalled();
+    });
+    it('preserves the request body when dispatching', async () => {
+        const updateCog = jest.fn().mockResolvedValue(ok());
+        const routes = [
+            { method: 'PUT', path: '/api/products/:productId/:variantId/cogs/:cogId', handler: updateCog },
+        ];
+        const handler = (0, public_api_router_js_1.createPublicApiRouter)(routes);
+        await handler(baseEvent({
+            httpMethod: 'PUT',
+            proxy: 'products/prd_1/var_2/cogs/cog_3',
+            body: JSON.stringify({ cost: 7 }),
+        }), ctx);
+        const dispatched = updateCog.mock.calls[0][0];
+        expect(dispatched.body).toBe(JSON.stringify({ cost: 7 }));
+    });
+    it('preserves the authorizer context when dispatching', async () => {
+        const getAccount = jest.fn().mockResolvedValue(ok());
+        const routes = [
+            { method: 'GET', path: '/api/account', handler: getAccount },
+        ];
+        const handler = (0, public_api_router_js_1.createPublicApiRouter)(routes);
+        await handler(baseEvent({ httpMethod: 'GET', proxy: 'account' }), ctx);
+        const dispatched = getAccount.mock.calls[0][0];
+        expect(dispatched.requestContext.authorizer?.pixelId).toBe('px_1');
+        expect(dispatched.requestContext.authorizer?.scopes).toContain('account:read');
+    });
+    it('compiles routes once at factory call, not per-request', async () => {
+        const h = jest.fn().mockResolvedValue(ok());
+        const routes = [{ method: 'GET', path: '/api/x', handler: h }];
+        const handler = (0, public_api_router_js_1.createPublicApiRouter)(routes);
+        await handler(baseEvent({ httpMethod: 'GET', proxy: 'x' }), ctx);
+        await handler(baseEvent({ httpMethod: 'GET', proxy: 'x' }), ctx);
+        expect(h).toHaveBeenCalledTimes(2);
+    });
+    it('returns failure() envelope when the downstream handler throws', async () => {
+        const broken = jest.fn().mockRejectedValue(new Error('boom'));
+        const routes = [
+            { method: 'GET', path: '/api/broken', handler: broken },
+        ];
+        const handler = (0, public_api_router_js_1.createPublicApiRouter)(routes);
+        const result = await handler(baseEvent({ httpMethod: 'GET', proxy: 'broken' }), ctx);
+        expect(result.statusCode).toBeGreaterThanOrEqual(400);
+        expect(broken).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=public-api-router.spec.js.map

package/dist/cjs/__tests__/unit/libs/api-router/public-api-router.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api-router.spec.js","sourceRoot":"","sources":["../../../../../../src/__tests__/unit/libs/api-router/public-api-router.spec.ts"],"names":[],"mappings":"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"}

package/dist/cjs/__tests__/unit/libs/api-router/route-matcher.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/__tests__/unit/libs/api-router/route-matcher.spec.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const route_matcher_js_1 = require("../../../../libs/api-router/route-matcher.js");
+const noop = async () => ({ statusCode: 200, body: '{}' });
+const defs = [
+    { method: 'GET', path: '/api/account', handler: noop },
+    { method: 'PATCH', path: '/api/account', handler: noop },
+    { method: 'GET', path: '/api/account/settings/order', handler: noop },
+    { method: 'PUT', path: '/api/account/settings/order', handler: noop },
+    { method: 'GET', path: '/api/products/search', handler: noop },
+    { method: 'GET', path: '/api/products/:productId/:variantId/cost', handler: noop },
+    { method: 'POST', path: '/api/products/:productId/:variantId/cogs', handler: noop },
+    { method: 'PUT', path: '/api/products/:productId/:variantId/cogs/:cogId', handler: noop },
+    { method: 'DELETE', path: '/api/products/:productId/:variantId/cogs/:cogId', handler: noop },
+    { method: 'POST', path: '/api/dashboard/views/from-preset', handler: noop },
+    { method: 'POST', path: '/api/dashboard/views/:dashboardViewId/copy', handler: noop },
+    { method: 'GET', path: '/api/dashboard/views/:dashboardViewId', handler: noop },
+];
+const compiled = (0, route_matcher_js_1.compileRoutes)(defs);
+describe('matchRoute', () => {
+    it('matches a literal static route', () => {
+        const m = (0, route_matcher_js_1.matchRoute)(compiled, 'GET', '/api/account');
+        expect(m?.route.path).toBe('/api/account');
+        expect(m?.pathParameters).toEqual({});
+    });
+    it('discriminates by method on the same path', () => {
+        expect((0, route_matcher_js_1.matchRoute)(compiled, 'GET', '/api/account')?.route.path).toBe('/api/account');
+        expect((0, route_matcher_js_1.matchRoute)(compiled, 'PATCH', '/api/account')?.route.path).toBe('/api/account');
+    });
+    it('extracts named path parameters', () => {
+        const m = (0, route_matcher_js_1.matchRoute)(compiled, 'PUT', '/api/products/prd_1/var_2/cogs/cog_3');
+        expect(m?.pathParameters).toEqual({ productId: 'prd_1', variantId: 'var_2', cogId: 'cog_3' });
+    });
+    it('prefers an earlier literal route over a later wildcard (search vs :productId)', () => {
+        const m = (0, route_matcher_js_1.matchRoute)(compiled, 'GET', '/api/products/search');
+        expect(m?.route.path).toBe('/api/products/search');
+        expect(m?.pathParameters).toEqual({});
+    });
+    it('prefers an earlier literal route over a later wildcard (from-preset vs :dashboardViewId)', () => {
+        const m = (0, route_matcher_js_1.matchRoute)(compiled, 'POST', '/api/dashboard/views/from-preset');
+        expect(m?.route.path).toBe('/api/dashboard/views/from-preset');
+    });
+    it('returns RAW (still-encoded) path params — decoding is the caller’s responsibility', () => {
+        const m = (0, route_matcher_js_1.matchRoute)(compiled, 'GET', '/api/products/prd%20space/var_2/cost');
+        expect(m?.pathParameters.productId).toBe('prd%20space');
+    });
+    it('does not throw on malformed percent-encoding (matcher stays pure)', () => {
+        expect(() => (0, route_matcher_js_1.matchRoute)(compiled, 'GET', '/api/products/%ZZ/var_2/cost')).not.toThrow();
+    });
+    it('accepts and ignores a trailing slash', () => {
+        const m = (0, route_matcher_js_1.matchRoute)(compiled, 'GET', '/api/account/');
+        expect(m?.route.path).toBe('/api/account');
+    });
+    it('returns null when path does not match any route', () => {
+        expect((0, route_matcher_js_1.matchRoute)(compiled, 'GET', '/api/unknown')).toBeNull();
+    });
+    it('returns null when method does not match a registered path', () => {
+        expect((0, route_matcher_js_1.matchRoute)(compiled, 'DELETE', '/api/account')).toBeNull();
+    });
+    it('treats methods case-insensitively', () => {
+        expect((0, route_matcher_js_1.matchRoute)(compiled, 'get', '/api/account')?.route.path).toBe('/api/account');
+    });
+    it('does not match a partial path (no greedy fallthrough)', () => {
+        expect((0, route_matcher_js_1.matchRoute)(compiled, 'GET', '/api/account/extra')).toBeNull();
+    });
+    it('does not let a wildcard segment swallow a slash', () => {
+        expect((0, route_matcher_js_1.matchRoute)(compiled, 'POST', '/api/products/foo/bar/baz/cogs')).toBeNull();
+    });
+});
+//# sourceMappingURL=route-matcher.spec.js.map

package/dist/cjs/__tests__/unit/libs/api-router/route-matcher.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-matcher.spec.js","sourceRoot":"","sources":["../../../../../../src/__tests__/unit/libs/api-router/route-matcher.spec.ts"],"names":[],"mappings":"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"}

package/dist/cjs/libs/api-router/index.d.ts

@@ -0,0 +1,2 @@
+export * from './route-matcher.js';
+export * from './public-api-router.js';

package/dist/cjs/libs/api-router/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./route-matcher.js"), exports);
+__exportStar(require("./public-api-router.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/libs/api-router/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/libs/api-router/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,yDAAuC"}

package/dist/cjs/libs/api-router/public-api-router.d.ts

@@ -0,0 +1,3 @@
+import type { APIGatewayProxyResult, Context } from 'aws-lambda';
+import { type RouteDef } from './route-matcher.js';
+export declare const createPublicApiRouter: (routes: RouteDef[]) => (event: import("aws-lambda").APIGatewayProxyEvent, context: Context) => Promise<APIGatewayProxyResult>;

package/dist/cjs/libs/api-router/public-api-router.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPublicApiRouter = void 0;
+const logging_helper_js_1 = require("../../helpers/logging-helper.js");
+const response_helper_js_1 = require("../../helpers/response-helper.js");
+const http_error_js_1 = require("../http-error.js");
+const route_matcher_js_1 = require("./route-matcher.js");
+const createPublicApiRouter = (routes) => {
+    const compiled = (0, route_matcher_js_1.compileRoutes)(routes);
+    return async function handler(event, context) {
+        try {
+            (0, logging_helper_js_1.configureLogger)(event, context);
+            const method = event.httpMethod.toUpperCase();
+            if (method === 'OPTIONS') {
+                return (0, response_helper_js_1.success)({});
+            }
+            const proxy = event.pathParameters?.proxy ?? '';
+            const path = `/api/${proxy}`.replace(/\/+$/, '') || '/api';
+            const match = (0, route_matcher_js_1.matchRoute)(compiled, method, path);
+            if (!match) {
+                logging_helper_js_1.Logger.warn('PublicApiRouter: no route matched', { method, path, rawPath: event.path });
+                return (0, response_helper_js_1.failure)(http_error_js_1.HttpError.notFound(`No route for ${method} ${path}`));
+            }
+            const enrichedEvent = {
+                ...event,
+                pathParameters: { ...match.pathParameters },
+            };
+            return await match.route.handler(enrichedEvent, context);
+        }
+        catch (error) {
+            logging_helper_js_1.Logger.error('PublicApiRouter: failed', { error });
+            return (0, response_helper_js_1.failure)(error);
+        }
+    };
+};
+exports.createPublicApiRouter = createPublicApiRouter;
+//# sourceMappingURL=public-api-router.js.map

package/dist/cjs/libs/api-router/public-api-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api-router.js","sourceRoot":"","sources":["../../../../src/libs/api-router/public-api-router.ts"],"names":[],"mappings":";;;AACA,uEAA0E;AAC1E,yEAAoE;AACpE,oDAA6C;AAC7C,yDAA8E;AAyBvE,MAAM,qBAAqB,GAAG,CAAC,MAAkB,EAAE,EAAE;IAC1D,MAAM,QAAQ,GAAG,IAAA,gCAAa,EAAC,MAAM,CAAC,CAAC;IAEvC,OAAO,KAAK,UAAU,OAAO,CAAC,KAAsB,EAAE,OAAgB;QACpE,IAAI;YACF,IAAA,mCAAe,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAMhC,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;YAE9C,IAAI,MAAM,KAAK,SAAS,EAAE;gBACxB,OAAO,IAAA,4BAAO,EAAC,EAAE,CAAC,CAAC;aACpB;YAED,MAAM,KAAK,GAAG,KAAK,CAAC,cAAc,EAAE,KAAK,IAAI,EAAE,CAAC;YAChD,MAAM,IAAI,GAAG,QAAQ,KAAK,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC;YAE3D,MAAM,KAAK,GAAG,IAAA,6BAAU,EAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;YACjD,IAAI,CAAC,KAAK,EAAE;gBAMV,0BAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;gBACxF,OAAO,IAAA,4BAAO,EAAC,yBAAS,CAAC,QAAQ,CAAC,gBAAgB,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;aACtE;YAED,MAAM,aAAa,GAAoB;gBACrC,GAAG,KAAK;gBACR,cAAc,EAAE,EAAE,GAAG,KAAK,CAAC,cAAc,EAAE;aAC5C,CAAC;YAEF,OAAO,MAAM,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;SAC1D;QAAC,OAAO,KAAK,EAAE;YACd,0BAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YACnD,OAAO,IAAA,4BAAO,EAAC,KAAK,CAAC,CAAC;SACvB;IACH,CAAC,CAAC;AACJ,CAAC,CAAC;AA1CW,QAAA,qBAAqB,yBA0ChC"}

package/dist/cjs/libs/api-router/route-matcher.d.ts

@@ -0,0 +1,21 @@
+import type { APIGatewayEvent, APIGatewayProxyResult, Context } from 'aws-lambda';
+export type ApiHandler = (event: APIGatewayEvent, context: Context) => Promise<APIGatewayProxyResult>;
+export interface RouteDef {
+    method: string;
+    path: string;
+    handler: ApiHandler;
+}
+export interface CompiledRoute {
+    method: string;
+    path: string;
+    paramNames: string[];
+    pattern: RegExp;
+    handler: ApiHandler;
+}
+export interface RouteMatch {
+    route: CompiledRoute;
+    pathParameters: Record<string, string>;
+}
+export declare const compileRoute: (def: RouteDef) => CompiledRoute;
+export declare const compileRoutes: (defs: RouteDef[]) => CompiledRoute[];
+export declare const matchRoute: (routes: CompiledRoute[], method: string, path: string) => RouteMatch | null;

package/dist/cjs/libs/api-router/route-matcher.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchRoute = exports.compileRoutes = exports.compileRoute = void 0;
+const escapeRegex = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+const compileRoute = (def) => {
+    const paramNames = [];
+    const segments = def.path.split('/').map(seg => {
+        if (seg.startsWith(':')) {
+            paramNames.push(seg.slice(1));
+            return '([^/]+)';
+        }
+        return escapeRegex(seg);
+    });
+    const pattern = new RegExp('^' + segments.join('/') + '/?$');
+    return { method: def.method.toUpperCase(), path: def.path, paramNames, pattern, handler: def.handler };
+};
+exports.compileRoute = compileRoute;
+const compileRoutes = (defs) => defs.map(exports.compileRoute);
+exports.compileRoutes = compileRoutes;
+const matchRoute = (routes, method, path) => {
+    const upper = method.toUpperCase();
+    for (const route of routes) {
+        if (route.method !== upper)
+            continue;
+        const m = route.pattern.exec(path);
+        if (!m)
+            continue;
+        const pathParameters = {};
+        for (let i = 0; i < route.paramNames.length; i++) {
+            pathParameters[route.paramNames[i]] = m[i + 1];
+        }
+        return { route, pathParameters };
+    }
+    return null;
+};
+exports.matchRoute = matchRoute;
+//# sourceMappingURL=route-matcher.js.map

package/dist/cjs/libs/api-router/route-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-matcher.js","sourceRoot":"","sources":["../../../../src/libs/api-router/route-matcher.ts"],"names":[],"mappings":";;;AA2BA,MAAM,WAAW,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAErE,MAAM,YAAY,GAAG,CAAC,GAAa,EAAiB,EAAE;IAC3D,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QAC7C,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;YACvB,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9B,OAAO,SAAS,CAAC;SAClB;QACD,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAC7D,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;AACzG,CAAC,CAAC;AAXW,QAAA,YAAY,gBAWvB;AAEK,MAAM,aAAa,GAAG,CAAC,IAAgB,EAAmB,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,oBAAY,CAAC,CAAC;AAA9E,QAAA,aAAa,iBAAiE;AAepF,MAAM,UAAU,GAAG,CACxB,MAAuB,EACvB,MAAc,EACd,IAAY,EACO,EAAE;IACrB,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;QAC1B,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK;YAAE,SAAS;QACrC,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,cAAc,GAA2B,EAAE,CAAC;QAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YAChD,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;SAChD;QACD,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;KAClC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAjBW,QAAA,UAAU,cAiBrB"}

package/dist/cjs/libs/index.d.ts

@@ -15,3 +15,4 @@ export * from './strings.js';
 export * from './cookie.js';
 export * from './domain.js';
 export * from './emails.js';
+export * from './api-router/index.js';

package/dist/cjs/libs/index.js

@@ -31,4 +31,5 @@ __exportStar(require("./strings.js"), exports);
 __exportStar(require("./cookie.js"), exports);
 __exportStar(require("./domain.js"), exports);
 __exportStar(require("./emails.js"), exports);
+__exportStar(require("./api-router/index.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/libs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/libs/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA6C;AAC7C,8CAA4B;AAC5B,6CAA2B;AAC3B,kDAAgC;AAChC,yDAAuC;AACvC,2CAAyB;AACzB,6DAA2C;AAC3C,uDAAqC;AACrC,mDAAiC;AACjC,2CAAyB;AACzB,8CAA4B;AAC5B,gDAA8B;AAC9B,+CAA6B;AAC7B,+CAA6B;AAC7B,8CAA4B;AAC5B,8CAA4B;AAC5B,8CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/libs/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA6C;AAC7C,8CAA4B;AAC5B,6CAA2B;AAC3B,kDAAgC;AAChC,yDAAuC;AACvC,2CAAyB;AACzB,6DAA2C;AAC3C,uDAAqC;AACrC,mDAAiC;AACjC,2CAAyB;AACzB,8CAA4B;AAC5B,gDAA8B;AAC9B,+CAA6B;AAC7B,+CAA6B;AAC7B,8CAA4B;AAC5B,8CAA4B;AAC5B,8CAA4B;AAC5B,wDAAsC"}

package/dist/esm/__tests__/unit/libs/api-router/public-api-router.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/__tests__/unit/libs/api-router/public-api-router.spec.js

@@ -0,0 +1,173 @@
+import { createPublicApiRouter } from '../../../../libs/api-router/public-api-router.js';
+const ok = (body = { ok: true }) => ({ statusCode: 200, body: JSON.stringify(body) });
+const baseEvent = (overrides) => {
+    const { httpMethod, proxy, ...rest } = overrides;
+    return {
+        httpMethod,
+        path: `/api/${proxy}`,
+        requestContext: {
+            authorizer: {
+                pixelId: 'px_1',
+                accountId: 'acc_1',
+                scopes: 'account:read',
+            },
+        },
+        pathParameters: { proxy },
+        queryStringParameters: null,
+        body: null,
+        ...rest,
+    };
+};
+const ctx = { awsRequestId: 'req_1' };
+describe('createPublicApiRouter', () => {
+    it('dispatches to the route handler for a literal path', async () => {
+        const getAccount = jest.fn().mockResolvedValue(ok());
+        const routes = [
+            { method: 'GET', path: '/api/account', handler: getAccount },
+        ];
+        const handler = createPublicApiRouter(routes);
+        const result = await handler(baseEvent({ httpMethod: 'GET', proxy: 'account' }), ctx);
+        expect(result.statusCode).toBe(200);
+        expect(getAccount).toHaveBeenCalledTimes(1);
+    });
+    it('extracts named path parameters and clears the API-GW {proxy+} placeholder', async () => {
+        const updateCog = jest.fn().mockResolvedValue(ok());
+        const routes = [
+            { method: 'PUT', path: '/api/products/:productId/:variantId/cogs/:cogId', handler: updateCog },
+        ];
+        const handler = createPublicApiRouter(routes);
+        await handler(baseEvent({
+            httpMethod: 'PUT',
+            proxy: 'products/prd_1/var_2/cogs/cog_3',
+            body: JSON.stringify({ cost: 5 }),
+        }), ctx);
+        expect(updateCog).toHaveBeenCalledTimes(1);
+        const dispatched = updateCog.mock.calls[0][0];
+        expect(dispatched.pathParameters).toEqual({
+            productId: 'prd_1',
+            variantId: 'var_2',
+            cogId: 'cog_3',
+        });
+        expect(dispatched.pathParameters?.proxy).toBeUndefined();
+    });
+    it('routes off pathParameters.proxy, not event.path (custom-domain basePath regression)', async () => {
+        const getAccount = jest.fn().mockResolvedValue(ok());
+        const routes = [
+            { method: 'GET', path: '/api/account', handler: getAccount },
+        ];
+        const handler = createPublicApiRouter(routes);
+        const event = baseEvent({ httpMethod: 'GET', proxy: 'account' });
+        event.path = '/accounts/api/account';
+        const result = await handler(event, ctx);
+        expect(result.statusCode).toBe(200);
+        expect(getAccount).toHaveBeenCalledTimes(1);
+    });
+    it('passes path params through unchanged (API GW already decoded them, no double-decode)', async () => {
+        const updateCog = jest.fn().mockResolvedValue(ok());
+        const routes = [
+            { method: 'PUT', path: '/api/products/:productId/:variantId/cogs/:cogId', handler: updateCog },
+        ];
+        const handler = createPublicApiRouter(routes);
+        await handler(baseEvent({
+            httpMethod: 'PUT',
+            proxy: 'products/prd_a/var_b/cogs/cog_c%10',
+            body: JSON.stringify({ cost: 5 }),
+        }), ctx);
+        expect(updateCog).toHaveBeenCalledTimes(1);
+        const dispatched = updateCog.mock.calls[0][0];
+        expect(dispatched.pathParameters?.cogId).toBe('cog_c%10');
+    });
+    it('returns 404 when no route matches', async () => {
+        const getAccount = jest.fn().mockResolvedValue(ok());
+        const routes = [
+            { method: 'GET', path: '/api/account', handler: getAccount },
+        ];
+        const handler = createPublicApiRouter(routes);
+        const result = await handler(baseEvent({ httpMethod: 'GET', proxy: 'nope' }), ctx);
+        expect(result.statusCode).toBe(404);
+        expect(getAccount).not.toHaveBeenCalled();
+    });
+    it('does not log a 404 at error level (avoids double-log + false-positive error alerts)', async () => {
+        const loggingHelper = await import('../../../../helpers/logging-helper.js');
+        const errorSpy = jest.spyOn(loggingHelper.Logger, 'error').mockImplementation(() => undefined);
+        const warnSpy = jest.spyOn(loggingHelper.Logger, 'warn').mockImplementation(() => undefined);
+        try {
+            const routes = [
+                { method: 'GET', path: '/api/account', handler: jest.fn().mockResolvedValue(ok()) },
+            ];
+            const handler = createPublicApiRouter(routes);
+            const result = await handler(baseEvent({ httpMethod: 'GET', proxy: 'nope' }), ctx);
+            expect(result.statusCode).toBe(404);
+            expect(warnSpy).toHaveBeenCalledTimes(1);
+            expect(errorSpy).not.toHaveBeenCalled();
+        }
+        finally {
+            errorSpy.mockRestore();
+            warnSpy.mockRestore();
+        }
+    });
+    it('handles OPTIONS preflight without invoking any downstream handler', async () => {
+        const getAccount = jest.fn().mockResolvedValue(ok());
+        const routes = [
+            { method: 'GET', path: '/api/account', handler: getAccount },
+        ];
+        const handler = createPublicApiRouter(routes);
+        const result = await handler(baseEvent({ httpMethod: 'OPTIONS', proxy: 'account' }), ctx);
+        expect(result.statusCode).toBe(200);
+        expect(getAccount).not.toHaveBeenCalled();
+    });
+    it('treats OPTIONS case-insensitively (matches matchRoute method-case contract)', async () => {
+        const getAccount = jest.fn().mockResolvedValue(ok());
+        const routes = [
+            { method: 'GET', path: '/api/account', handler: getAccount },
+        ];
+        const handler = createPublicApiRouter(routes);
+        const result = await handler(baseEvent({ httpMethod: 'options', proxy: 'account' }), ctx);
+        expect(result.statusCode).toBe(200);
+        expect(getAccount).not.toHaveBeenCalled();
+    });
+    it('preserves the request body when dispatching', async () => {
+        const updateCog = jest.fn().mockResolvedValue(ok());
+        const routes = [
+            { method: 'PUT', path: '/api/products/:productId/:variantId/cogs/:cogId', handler: updateCog },
+        ];
+        const handler = createPublicApiRouter(routes);
+        await handler(baseEvent({
+            httpMethod: 'PUT',
+            proxy: 'products/prd_1/var_2/cogs/cog_3',
+            body: JSON.stringify({ cost: 7 }),
+        }), ctx);
+        const dispatched = updateCog.mock.calls[0][0];
+        expect(dispatched.body).toBe(JSON.stringify({ cost: 7 }));
+    });
+    it('preserves the authorizer context when dispatching', async () => {
+        const getAccount = jest.fn().mockResolvedValue(ok());
+        const routes = [
+            { method: 'GET', path: '/api/account', handler: getAccount },
+        ];
+        const handler = createPublicApiRouter(routes);
+        await handler(baseEvent({ httpMethod: 'GET', proxy: 'account' }), ctx);
+        const dispatched = getAccount.mock.calls[0][0];
+        expect(dispatched.requestContext.authorizer?.pixelId).toBe('px_1');
+        expect(dispatched.requestContext.authorizer?.scopes).toContain('account:read');
+    });
+    it('compiles routes once at factory call, not per-request', async () => {
+        const h = jest.fn().mockResolvedValue(ok());
+        const routes = [{ method: 'GET', path: '/api/x', handler: h }];
+        const handler = createPublicApiRouter(routes);
+        await handler(baseEvent({ httpMethod: 'GET', proxy: 'x' }), ctx);
+        await handler(baseEvent({ httpMethod: 'GET', proxy: 'x' }), ctx);
+        expect(h).toHaveBeenCalledTimes(2);
+    });
+    it('returns failure() envelope when the downstream handler throws', async () => {
+        const broken = jest.fn().mockRejectedValue(new Error('boom'));
+        const routes = [
+            { method: 'GET', path: '/api/broken', handler: broken },
+        ];
+        const handler = createPublicApiRouter(routes);
+        const result = await handler(baseEvent({ httpMethod: 'GET', proxy: 'broken' }), ctx);
+        expect(result.statusCode).toBeGreaterThanOrEqual(400);
+        expect(broken).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=public-api-router.spec.js.map

package/dist/esm/__tests__/unit/libs/api-router/public-api-router.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api-router.spec.js","sourceRoot":"","sources":["../../../../../../src/__tests__/unit/libs/api-router/public-api-router.spec.ts"],"names":[],"mappings":"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"}

package/dist/esm/__tests__/unit/libs/api-router/route-matcher.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/__tests__/unit/libs/api-router/route-matcher.spec.js

@@ -0,0 +1,68 @@
+import { compileRoutes, matchRoute } from '../../../../libs/api-router/route-matcher.js';
+const noop = async () => ({ statusCode: 200, body: '{}' });
+const defs = [
+    { method: 'GET', path: '/api/account', handler: noop },
+    { method: 'PATCH', path: '/api/account', handler: noop },
+    { method: 'GET', path: '/api/account/settings/order', handler: noop },
+    { method: 'PUT', path: '/api/account/settings/order', handler: noop },
+    { method: 'GET', path: '/api/products/search', handler: noop },
+    { method: 'GET', path: '/api/products/:productId/:variantId/cost', handler: noop },
+    { method: 'POST', path: '/api/products/:productId/:variantId/cogs', handler: noop },
+    { method: 'PUT', path: '/api/products/:productId/:variantId/cogs/:cogId', handler: noop },
+    { method: 'DELETE', path: '/api/products/:productId/:variantId/cogs/:cogId', handler: noop },
+    { method: 'POST', path: '/api/dashboard/views/from-preset', handler: noop },
+    { method: 'POST', path: '/api/dashboard/views/:dashboardViewId/copy', handler: noop },
+    { method: 'GET', path: '/api/dashboard/views/:dashboardViewId', handler: noop },
+];
+const compiled = compileRoutes(defs);
+describe('matchRoute', () => {
+    it('matches a literal static route', () => {
+        const m = matchRoute(compiled, 'GET', '/api/account');
+        expect(m?.route.path).toBe('/api/account');
+        expect(m?.pathParameters).toEqual({});
+    });
+    it('discriminates by method on the same path', () => {
+        expect(matchRoute(compiled, 'GET', '/api/account')?.route.path).toBe('/api/account');
+        expect(matchRoute(compiled, 'PATCH', '/api/account')?.route.path).toBe('/api/account');
+    });
+    it('extracts named path parameters', () => {
+        const m = matchRoute(compiled, 'PUT', '/api/products/prd_1/var_2/cogs/cog_3');
+        expect(m?.pathParameters).toEqual({ productId: 'prd_1', variantId: 'var_2', cogId: 'cog_3' });
+    });
+    it('prefers an earlier literal route over a later wildcard (search vs :productId)', () => {
+        const m = matchRoute(compiled, 'GET', '/api/products/search');
+        expect(m?.route.path).toBe('/api/products/search');
+        expect(m?.pathParameters).toEqual({});
+    });
+    it('prefers an earlier literal route over a later wildcard (from-preset vs :dashboardViewId)', () => {
+        const m = matchRoute(compiled, 'POST', '/api/dashboard/views/from-preset');
+        expect(m?.route.path).toBe('/api/dashboard/views/from-preset');
+    });
+    it('returns RAW (still-encoded) path params — decoding is the caller’s responsibility', () => {
+        const m = matchRoute(compiled, 'GET', '/api/products/prd%20space/var_2/cost');
+        expect(m?.pathParameters.productId).toBe('prd%20space');
+    });
+    it('does not throw on malformed percent-encoding (matcher stays pure)', () => {
+        expect(() => matchRoute(compiled, 'GET', '/api/products/%ZZ/var_2/cost')).not.toThrow();
+    });
+    it('accepts and ignores a trailing slash', () => {
+        const m = matchRoute(compiled, 'GET', '/api/account/');
+        expect(m?.route.path).toBe('/api/account');
+    });
+    it('returns null when path does not match any route', () => {
+        expect(matchRoute(compiled, 'GET', '/api/unknown')).toBeNull();
+    });
+    it('returns null when method does not match a registered path', () => {
+        expect(matchRoute(compiled, 'DELETE', '/api/account')).toBeNull();
+    });
+    it('treats methods case-insensitively', () => {
+        expect(matchRoute(compiled, 'get', '/api/account')?.route.path).toBe('/api/account');
+    });
+    it('does not match a partial path (no greedy fallthrough)', () => {
+        expect(matchRoute(compiled, 'GET', '/api/account/extra')).toBeNull();
+    });
+    it('does not let a wildcard segment swallow a slash', () => {
+        expect(matchRoute(compiled, 'POST', '/api/products/foo/bar/baz/cogs')).toBeNull();
+    });
+});
+//# sourceMappingURL=route-matcher.spec.js.map

package/dist/esm/__tests__/unit/libs/api-router/route-matcher.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-matcher.spec.js","sourceRoot":"","sources":["../../../../../../src/__tests__/unit/libs/api-router/route-matcher.spec.ts"],"names":[],"mappings":"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"}

package/dist/esm/libs/api-router/index.d.ts

@@ -0,0 +1,2 @@
+export * from './route-matcher.js';
+export * from './public-api-router.js';

package/dist/esm/libs/api-router/index.js

@@ -0,0 +1,3 @@
+export * from './route-matcher.js';
+export * from './public-api-router.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/libs/api-router/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/libs/api-router/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC"}

package/dist/esm/libs/api-router/public-api-router.d.ts

@@ -0,0 +1,3 @@
+import type { APIGatewayProxyResult, Context } from 'aws-lambda';
+import { type RouteDef } from './route-matcher.js';
+export declare const createPublicApiRouter: (routes: RouteDef[]) => (event: import("aws-lambda").APIGatewayProxyEvent, context: Context) => Promise<APIGatewayProxyResult>;

package/dist/esm/libs/api-router/public-api-router.js

@@ -0,0 +1,33 @@
+import { configureLogger, Logger } from '../../helpers/logging-helper.js';
+import { success, failure } from '../../helpers/response-helper.js';
+import { HttpError } from '../http-error.js';
+import { compileRoutes, matchRoute } from './route-matcher.js';
+export const createPublicApiRouter = (routes) => {
+    const compiled = compileRoutes(routes);
+    return async function handler(event, context) {
+        try {
+            configureLogger(event, context);
+            const method = event.httpMethod.toUpperCase();
+            if (method === 'OPTIONS') {
+                return success({});
+            }
+            const proxy = event.pathParameters?.proxy ?? '';
+            const path = `/api/${proxy}`.replace(/\/+$/, '') || '/api';
+            const match = matchRoute(compiled, method, path);
+            if (!match) {
+                Logger.warn('PublicApiRouter: no route matched', { method, path, rawPath: event.path });
+                return failure(HttpError.notFound(`No route for ${method} ${path}`));
+            }
+            const enrichedEvent = {
+                ...event,
+                pathParameters: { ...match.pathParameters },
+            };
+            return await match.route.handler(enrichedEvent, context);
+        }
+        catch (error) {
+            Logger.error('PublicApiRouter: failed', { error });
+            return failure(error);
+        }
+    };
+};
+//# sourceMappingURL=public-api-router.js.map

package/dist/esm/libs/api-router/public-api-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api-router.js","sourceRoot":"","sources":["../../../../src/libs/api-router/public-api-router.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,UAAU,EAAiB,MAAM,oBAAoB,CAAC;AAyB9E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAkB,EAAE,EAAE;IAC1D,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAEvC,OAAO,KAAK,UAAU,OAAO,CAAC,KAAsB,EAAE,OAAgB;QACpE,IAAI;YACF,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAMhC,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;YAE9C,IAAI,MAAM,KAAK,SAAS,EAAE;gBACxB,OAAO,OAAO,CAAC,EAAE,CAAC,CAAC;aACpB;YAED,MAAM,KAAK,GAAG,KAAK,CAAC,cAAc,EAAE,KAAK,IAAI,EAAE,CAAC;YAChD,MAAM,IAAI,GAAG,QAAQ,KAAK,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC;YAE3D,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;YACjD,IAAI,CAAC,KAAK,EAAE;gBAMV,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;gBACxF,OAAO,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,gBAAgB,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;aACtE;YAED,MAAM,aAAa,GAAoB;gBACrC,GAAG,KAAK;gBACR,cAAc,EAAE,EAAE,GAAG,KAAK,CAAC,cAAc,EAAE;aAC5C,CAAC;YAEF,OAAO,MAAM,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;SAC1D;QAAC,OAAO,KAAK,EAAE;YACd,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YACnD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;SACvB;IACH,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/libs/api-router/route-matcher.d.ts

@@ -0,0 +1,21 @@
+import type { APIGatewayEvent, APIGatewayProxyResult, Context } from 'aws-lambda';
+export type ApiHandler = (event: APIGatewayEvent, context: Context) => Promise<APIGatewayProxyResult>;
+export interface RouteDef {
+    method: string;
+    path: string;
+    handler: ApiHandler;
+}
+export interface CompiledRoute {
+    method: string;
+    path: string;
+    paramNames: string[];
+    pattern: RegExp;
+    handler: ApiHandler;
+}
+export interface RouteMatch {
+    route: CompiledRoute;
+    pathParameters: Record<string, string>;
+}
+export declare const compileRoute: (def: RouteDef) => CompiledRoute;
+export declare const compileRoutes: (defs: RouteDef[]) => CompiledRoute[];
+export declare const matchRoute: (routes: CompiledRoute[], method: string, path: string) => RouteMatch | null;

package/dist/esm/libs/api-router/route-matcher.js

@@ -0,0 +1,31 @@
+const escapeRegex = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+export const compileRoute = (def) => {
+    const paramNames = [];
+    const segments = def.path.split('/').map(seg => {
+        if (seg.startsWith(':')) {
+            paramNames.push(seg.slice(1));
+            return '([^/]+)';
+        }
+        return escapeRegex(seg);
+    });
+    const pattern = new RegExp('^' + segments.join('/') + '/?$');
+    return { method: def.method.toUpperCase(), path: def.path, paramNames, pattern, handler: def.handler };
+};
+export const compileRoutes = (defs) => defs.map(compileRoute);
+export const matchRoute = (routes, method, path) => {
+    const upper = method.toUpperCase();
+    for (const route of routes) {
+        if (route.method !== upper)
+            continue;
+        const m = route.pattern.exec(path);
+        if (!m)
+            continue;
+        const pathParameters = {};
+        for (let i = 0; i < route.paramNames.length; i++) {
+            pathParameters[route.paramNames[i]] = m[i + 1];
+        }
+        return { route, pathParameters };
+    }
+    return null;
+};
+//# sourceMappingURL=route-matcher.js.map

package/dist/esm/libs/api-router/route-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-matcher.js","sourceRoot":"","sources":["../../../../src/libs/api-router/route-matcher.ts"],"names":[],"mappings":"AA2BA,MAAM,WAAW,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAE5E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAa,EAAiB,EAAE;IAC3D,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QAC7C,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;YACvB,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9B,OAAO,SAAS,CAAC;SAClB;QACD,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAC7D,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;AACzG,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAgB,EAAmB,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAe3F,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,MAAuB,EACvB,MAAc,EACd,IAAY,EACO,EAAE;IACrB,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;QAC1B,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK;YAAE,SAAS;QACrC,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,cAAc,GAA2B,EAAE,CAAC;QAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YAChD,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;SAChD;QACD,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;KAClC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

package/dist/esm/libs/index.d.ts

@@ -15,3 +15,4 @@ export * from './strings.js';
 export * from './cookie.js';
 export * from './domain.js';
 export * from './emails.js';
+export * from './api-router/index.js';

package/dist/esm/libs/index.js

@@ -15,4 +15,5 @@ export * from './strings.js';
 export * from './cookie.js';
 export * from './domain.js';
 export * from './emails.js';
+export * from './api-router/index.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/libs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/libs/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,UAAU,CAAC;AACzB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/libs/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,UAAU,CAAC;AACzB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adtrackify/at-service-common",
-  "version": "3.17.6",
+  "version": "3.17.8",
   "description": "",
   "files": [
     "dist/*"