@prosopo/api-express-router 3.1.51 → 3.1.52

package/.turbo/turbo-build$colon$cjs.log

@@ -1,5 +1,5 @@
 
-> @prosopo/api-express-router@3.1.51 build:cjs
+> @prosopo/api-express-router@3.1.52 build:cjs
 > NODE_ENV=${NODE_ENV:-development}; vite build --config vite.cjs.config.ts --mode $NODE_ENV
 
 ViteCommonJSConfig: .
@@ -57,4 +57,4 @@ dist/cjs/index.cjs                                             1.25 kB │ gzip:
 dist/cjs/middlewares/authMiddleware.cjs                        1.71 kB │ gzip: 0.74 kB
 dist/cjs/middlewares/requestLoggerMiddleware.cjs               1.81 kB │ gzip: 0.78 kB
 
-✓ built in 41ms
+✓ built in 50ms

package/.turbo/turbo-build$colon$tsc.log

@@ -1,8 +1,8 @@
 
-> @prosopo/api-express-router@3.1.51 build:tsc
+> @prosopo/api-express-router@3.1.52 build:tsc
 > tsc --build --verbose
 
-8:59:58 PM - Projects in this build: 
+12:37:06 PM - Projects in this build: 
     * ../../dev/config/tsconfig.json
     * ../util/tsconfig.json
     * ../logger/tsconfig.json
@@ -22,41 +22,41 @@
     * ../env/tsconfig.json
     * tsconfig.json
 
-8:59:58 PM - Project '../../dev/config/tsconfig.json' is up to date because newest input '../../dev/config/src/webpack/webpack.config.ts' is older than output '../../dev/config/tsconfig.tsbuildinfo'
+12:37:06 PM - Project '../../dev/config/tsconfig.json' is up to date because newest input '../../dev/config/src/webpack/index.ts' is older than output '../../dev/config/tsconfig.tsbuildinfo'
 
-8:59:58 PM - Project '../util/tsconfig.json' is up to date because newest input '../util/src/url.ts' is older than output '../util/tsconfig.tsbuildinfo'
+12:37:06 PM - Project '../util/tsconfig.json' is up to date because newest input '../util/src/url.ts' is older than output '../util/tsconfig.tsbuildinfo'
 
-8:59:58 PM - Project '../logger/tsconfig.json' is up to date because newest input '../logger/src/index.ts' is older than output '../logger/tsconfig.tsbuildinfo'
+12:37:06 PM - Project '../logger/tsconfig.json' is up to date because newest input '../logger/src/index.ts' is older than output '../logger/tsconfig.tsbuildinfo'
 
-8:59:58 PM - Project '../api-route/tsconfig.json' is up to date because newest input '../api-route/src/apiRoutes.ts' is older than output '../api-route/tsconfig.tsbuildinfo'
+12:37:06 PM - Project '../api-route/tsconfig.json' is up to date because newest input '../api-route/src/tests/apiRoute.unit.test.ts' is older than output '../api-route/tsconfig.tsbuildinfo'
 
-8:59:58 PM - Project '../locale/tsconfig.json' is up to date because newest input '../locale/src/translationKey.ts' is older than output '../locale/tsconfig.tsbuildinfo'
+12:37:06 PM - Project '../locale/tsconfig.json' is up to date because newest input '../locale/src/translationKey.ts' is older than output '../locale/tsconfig.tsbuildinfo'
 
-8:59:58 PM - Project '../util-crypto/tsconfig.json' is up to date because newest input '../util-crypto/src/types.ts' is older than output '../util-crypto/tsconfig.tsbuildinfo'
+12:37:06 PM - Project '../util-crypto/tsconfig.json' is up to date because newest input '../util-crypto/src/types.ts' is older than output '../util-crypto/tsconfig.tsbuildinfo'
 
-8:59:58 PM - Project '../types/tsconfig.json' is up to date because newest input '../types/src/provider/api.ts' is older than output '../types/tsconfig.tsbuildinfo'
+12:37:06 PM - Project '../types/tsconfig.json' is up to date because newest input '../types/src/provider/api.ts' is older than output '../types/tsconfig.tsbuildinfo'
 
-8:59:58 PM - Project '../common/tsconfig.json' is up to date because newest input '../common/src/tests/utils/batches.unit.test.ts' is older than output '../common/tsconfig.tsbuildinfo'
+12:37:06 PM - Project '../common/tsconfig.json' is up to date because newest input '../common/src/index.ts' is older than output '../common/tsconfig.tsbuildinfo'
 
-8:59:58 PM - Project '../ipinfo/tsconfig.json' is up to date because newest input '../ipinfo/src/IpInfoService.ts' is older than output '../ipinfo/tsconfig.tsbuildinfo'
+12:37:06 PM - Project '../ipinfo/tsconfig.json' is up to date because newest input '../ipinfo/src/IpInfoService.ts' is older than output '../ipinfo/tsconfig.tsbuildinfo'
 
-8:59:58 PM - Project '../redis-client/tsconfig.json' is up to date because newest input '../redis-client/src/index.ts' is older than output '../redis-client/tsconfig.tsbuildinfo'
+12:37:06 PM - Project '../redis-client/tsconfig.json' is up to date because newest input '../redis-client/src/index.ts' is older than output '../redis-client/tsconfig.tsbuildinfo'
 
-8:59:58 PM - Project '../api/tsconfig.json' is up to date because newest input '../api/src/index.ts' is older than output '../api/tsconfig.tsbuildinfo'
+12:37:07 PM - Project '../api/tsconfig.json' is up to date because newest input '../api/src/tests/apiHarness.ts' is older than output '../api/tsconfig.tsbuildinfo'
 
-8:59:58 PM - Project '../user-access-policy/tsconfig.json' is up to date because newest input '../user-access-policy/src/ruleRecord.ts' is older than output '../user-access-policy/tsconfig.tsbuildinfo'
+12:37:07 PM - Project '../user-access-policy/tsconfig.json' is up to date because newest input '../user-access-policy/src/transformRule.ts' is older than output '../user-access-policy/tsconfig.tsbuildinfo'
 
-8:59:58 PM - Project '../types-database/tsconfig.json' is up to date because newest input '../types-database/src/types/bannedDomain.ts' is older than output '../types-database/tsconfig.tsbuildinfo'
+12:37:07 PM - Project '../types-database/tsconfig.json' is up to date because newest input '../types-database/src/types/bannedDomain.ts' is older than output '../types-database/tsconfig.tsbuildinfo'
 
-8:59:58 PM - Project '../database/tsconfig.json' is up to date because newest input '../database/src/tests/mongoGlobalSetup.ts' is older than output '../database/tsconfig.tsbuildinfo'
+12:37:07 PM - Project '../database/tsconfig.json' is up to date because newest input '../database/src/tests/unit/redisCacheEscalation.unit.test.ts' is older than output '../database/tsconfig.tsbuildinfo'
 
-8:59:58 PM - Project '../keyring/tsconfig.json' is up to date because newest input '../keyring/src/keyring/keyring.ts' is older than output '../keyring/tsconfig.tsbuildinfo'
+12:37:07 PM - Project '../keyring/tsconfig.json' is up to date because newest input '../keyring/src/keyring/keyring.ts' is older than output '../keyring/tsconfig.tsbuildinfo'
 
-8:59:58 PM - Project '../types-env/tsconfig.json' is up to date because newest input '../types-env/src/index.ts' is older than output '../types-env/tsconfig.tsbuildinfo'
+12:37:07 PM - Project '../types-env/tsconfig.json' is up to date because newest input '../types-env/src/index.ts' is older than output '../types-env/tsconfig.tsbuildinfo'
 
-8:59:58 PM - Project '../env/tsconfig.json' is up to date because newest input '../env/src/index.ts' is older than output '../env/tsconfig.tsbuildinfo'
+12:37:07 PM - Project '../env/tsconfig.json' is up to date because newest input '../env/src/env.ts' is older than output '../env/tsconfig.tsbuildinfo'
 
-8:59:58 PM - Project 'tsconfig.json' is out of date because output file 'tsconfig.tsbuildinfo' does not exist
+12:37:07 PM - Project 'tsconfig.json' is out of date because output file 'tsconfig.tsbuildinfo' does not exist
 
-8:59:58 PM - Building project '/home/runner/work/captcha/captcha/packages/api-express-router/tsconfig.json'...
+12:37:07 PM - Building project '/home/runner/work/captcha/captcha/packages/api-express-router/tsconfig.json'...
 

package/.turbo/turbo-build.log

@@ -1,9 +1,9 @@
 
-> @prosopo/api-express-router@3.1.51 build
+> @prosopo/api-express-router@3.1.52 build
 > npm run build:cross-env -- --mode ${NODE_ENV:-development}
 
 
-> @prosopo/api-express-router@3.1.51 build:cross-env
+> @prosopo/api-express-router@3.1.52 build:cross-env
 > vite build --config vite.esm.config.ts --mode production
 
 ViteEsmConfig: .
@@ -62,4 +62,4 @@ dist/endpointAdapter/apiExpressDefaultEndpointAdapter.js  0.94 kB │ gzip: 0.47
 dist/middlewares/authMiddleware.js                        1.60 kB │ gzip: 0.72 kB
 dist/middlewares/requestLoggerMiddleware.js               1.75 kB │ gzip: 0.76 kB
 
-✓ built in 55ms
+✓ built in 49ms

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @prosopo/api-express-router
 
+## 3.1.52
+### Patch Changes
+
+- 508fee8: Add unit and type test coverage for the router factory, the default endpoint adapter, the auth and request-logger middleware, and the package barrel.
+  - @prosopo/env@3.6.21
+
 ## 3.1.51
 ### Patch Changes
 

package/dist/tests/apiExpressRouter.test-d.d.ts

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

package/dist/tests/apiExpressRouter.test-d.d.ts.map

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

package/dist/tests/apiExpressRouter.test-d.js

@@ -0,0 +1,76 @@
+import { assertType, describe, expectTypeOf, test } from "vitest";
+import { apiExpressRouterFactory, authMiddleware, createApiExpressDefaultEndpointAdapter, handleErrors, requestLoggerMiddleware, verifySignature, } from "../index.js";
+describe("the barrel's shape", () => {
+    test("exports exactly the intended names", () => {
+        expectTypeOf().toEqualTypeOf();
+    });
+});
+describe("createApiExpressDefaultEndpointAdapter", () => {
+    test("takes a log level and an optional status code", () => {
+        expectTypeOf(createApiExpressDefaultEndpointAdapter).parameters.toEqualTypeOf();
+    });
+    test("returns the interface, not the concrete class", () => {
+        expectTypeOf(createApiExpressDefaultEndpointAdapter).returns.toEqualTypeOf();
+    });
+    test("rejects a log level that is not one of the known levels", () => {
+        createApiExpressDefaultEndpointAdapter("chatty");
+    });
+    test("rejects a non-numeric status code", () => {
+        createApiExpressDefaultEndpointAdapter("info", "500");
+    });
+});
+describe("the router factory", () => {
+    test("takes a routes provider and an adapter, and returns a Router", () => {
+        expectTypeOf(apiExpressRouterFactory.createRouter).toEqualTypeOf();
+    });
+    test("rejects a bare routes object in place of a provider", () => {
+        const adapter = {
+            handleRequest: async () => undefined,
+        };
+        apiExpressRouterFactory.createRouter({}, adapter);
+    });
+});
+describe("the endpoint adapter interface", () => {
+    test("takes the endpoint and the express trio and resolves to void", () => {
+        expectTypeOf().toEqualTypeOf();
+    });
+    test("is satisfied by any object with a matching handleRequest", () => {
+        assertType({
+            handleRequest: async () => undefined,
+        });
+    });
+});
+describe("the middleware", () => {
+    test("authMiddleware takes an optional pair and an optional auth account", () => {
+        expectTypeOf(authMiddleware).parameters.toEqualTypeOf();
+    });
+    test("authMiddleware returns an async express handler", () => {
+        expectTypeOf(authMiddleware).returns.toEqualTypeOf();
+    });
+    test("authMiddleware still requires the first argument to be passed", () => {
+        authMiddleware();
+    });
+    test("requestLoggerMiddleware returns a synchronous express handler", () => {
+        expectTypeOf(requestLoggerMiddleware).returns.toEqualTypeOf();
+    });
+    test("the handler each factory builds is usable as express middleware", () => {
+        assertType(requestLoggerMiddleware({}));
+        assertType(authMiddleware(undefined));
+    });
+    test("verifySignature takes a signature, a message and a pair, and returns void", () => {
+        expectTypeOf(verifySignature).parameters.toEqualTypeOf();
+        expectTypeOf(verifySignature).returns.toEqualTypeOf();
+    });
+    test("verifySignature rejects a byte-array signature", () => {
+        verifySignature(new Uint8Array([1]), "msg", {});
+    });
+});
+describe("the error handler", () => {
+    test("takes an error first, which is what makes express treat it as one", () => {
+        expectTypeOf(handleErrors).parameters.toMatchTypeOf();
+    });
+    test("rejects being mounted as an ordinary handler", () => {
+        assertType(handleErrors);
+    });
+});
+//# sourceMappingURL=apiExpressRouter.test-d.js.map

package/dist/tests/apiExpressRouter.test-d.js.map

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

package/dist/tests/unit/apiExpressDefaultEndpointAdapter.unit.test.d.ts

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

package/dist/tests/unit/apiExpressDefaultEndpointAdapter.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiExpressDefaultEndpointAdapter.unit.test.d.ts","sourceRoot":"","sources":["../../../src/tests/unit/apiExpressDefaultEndpointAdapter.unit.test.ts"],"names":[],"mappings":""}

package/dist/tests/unit/apiExpressDefaultEndpointAdapter.unit.test.js

@@ -0,0 +1,197 @@
+import { ApiEndpointResponseStatus, } from "@prosopo/api-route";
+import { ProsopoApiError } from "@prosopo/common";
+import { LogLevel } from "@prosopo/logger";
+import { beforeEach, describe, expect, test, vi } from "vitest";
+import { z } from "zod";
+import { ApiExpressDefaultEndpointAdapter } from "../../endpointAdapter/apiExpressDefaultEndpointAdapter.js";
+import { captureNext } from "./testDoubles.js";
+const build = (body = {}, errorStatusCode = 500) => {
+    const logged = vi.fn();
+    const logger = {
+        error: logged,
+        info: vi.fn(),
+        debug: vi.fn(),
+        warn: vi.fn(),
+    };
+    const json = vi.fn();
+    const send = vi.fn();
+    const status = vi.fn();
+    const response = { json, send, status };
+    status.mockReturnValue(response);
+    return {
+        adapter: new ApiExpressDefaultEndpointAdapter(LogLevel.enum.info, errorStatusCode),
+        request: { body, logger },
+        response,
+        next: captureNext(),
+        logger,
+        json,
+        status,
+        send,
+        logged,
+    };
+};
+const endpoint = (schema, process = async () => ({
+    status: ApiEndpointResponseStatus.SUCCESS,
+})) => ({
+    getRequestArgsSchema: () => schema,
+    processRequest: vi.fn(process),
+});
+let harness;
+beforeEach(() => {
+    harness = build();
+});
+describe("a request the endpoint accepts", () => {
+    test("parses the body and passes the parsed value on", async () => {
+        harness = build({ count: "5" });
+        const schema = z.object({ count: z.coerce.number() });
+        const target = endpoint(schema);
+        await harness.adapter.handleRequest(target, harness.request, harness.response, harness.next.fn);
+        expect(target.processRequest).toHaveBeenCalledWith({ count: 5 }, harness.logger);
+    });
+    test("passes undefined args when the endpoint declares no schema", async () => {
+        const target = endpoint(undefined);
+        await harness.adapter.handleRequest(target, harness.request, harness.response, harness.next.fn);
+        expect(target.processRequest).toHaveBeenCalledWith(undefined, harness.logger);
+    });
+    test("hands the endpoint the request's own logger", async () => {
+        const target = endpoint(undefined);
+        await harness.adapter.handleRequest(target, harness.request, harness.response, harness.next.fn);
+        expect(vi.mocked(target.processRequest).mock.calls[0]?.[1]).toBe(harness.logger);
+    });
+    test("answers with the endpoint's response as JSON", async () => {
+        await harness.adapter.handleRequest(endpoint(undefined, async () => ({
+            status: ApiEndpointResponseStatus.SUCCESS,
+            data: { value: 1 },
+        })), harness.request, harness.response, harness.next.fn);
+        expect(harness.json).toHaveBeenCalledWith({
+            status: ApiEndpointResponseStatus.SUCCESS,
+            data: { value: 1 },
+        });
+        expect(harness.next.calls).toHaveLength(0);
+    });
+    test("stringifies bigints, which res.json() cannot serialise", async () => {
+        await harness.adapter.handleRequest(endpoint(undefined, async () => ({
+            status: ApiEndpointResponseStatus.SUCCESS,
+            data: { big: 10n },
+        })), harness.request, harness.response, harness.next.fn);
+        expect(harness.json).toHaveBeenCalledWith({
+            status: ApiEndpointResponseStatus.SUCCESS,
+            data: { big: "10" },
+        });
+    });
+    test("passes an empty data payload straight through", async () => {
+        await harness.adapter.handleRequest(endpoint(undefined, async () => ({
+            status: ApiEndpointResponseStatus.SUCCESS,
+            data: {},
+        })), harness.request, harness.response, harness.next.fn);
+        expect(harness.json).toHaveBeenCalledWith({
+            status: ApiEndpointResponseStatus.SUCCESS,
+            data: {},
+        });
+    });
+    test("an absent request body is still handed to the schema", async () => {
+        harness.request.body = undefined;
+        const schema = z.object({ a: z.string() }).optional();
+        const target = endpoint(schema);
+        await harness.adapter.handleRequest(target, harness.request, harness.response, harness.next.fn);
+        expect(target.processRequest).toHaveBeenCalledWith(undefined, harness.logger);
+        expect(harness.json).toHaveBeenCalledWith({
+            status: ApiEndpointResponseStatus.SUCCESS,
+        });
+    });
+});
+describe("a body the schema rejects", () => {
+    test("goes to the error handler rather than being answered here", async () => {
+        harness = build({ count: "not a number" });
+        const target = endpoint(z.object({ count: z.number() }));
+        await harness.adapter.handleRequest(target, harness.request, harness.response, harness.next.fn);
+        expect(harness.next.calls).toHaveLength(1);
+        expect(harness.json).not.toHaveBeenCalled();
+        expect(target.processRequest).not.toHaveBeenCalled();
+    });
+    test("is reported as a 400 parse error carrying the cause", async () => {
+        harness = build({ count: "not a number" });
+        await harness.adapter.handleRequest(endpoint(z.object({ count: z.number() })), harness.request, harness.response, harness.next.fn);
+        const [forwarded] = harness.next.calls[0] ?? [];
+        expect(forwarded).toBeInstanceOf(ProsopoApiError);
+        const error = forwarded;
+        expect(error.context?.code).toBe(400);
+        expect(error.context?.error).toBeDefined();
+    });
+    test("a schema that throws something other than a ZodError is treated the same", async () => {
+        const schema = {
+            parse: () => {
+                throw new Error("custom validator exploded");
+            },
+        };
+        await harness.adapter.handleRequest(endpoint(schema), harness.request, harness.response, harness.next.fn);
+        expect(harness.next.calls).toHaveLength(1);
+        expect(harness.next.calls[0]?.[0]).toBeInstanceOf(ProsopoApiError);
+    });
+    test("an endpoint that fails while building its schema is caught too", async () => {
+        const target = {
+            getRequestArgsSchema: () => {
+                throw new Error("schema construction failed");
+            },
+            processRequest: vi.fn(),
+        };
+        await harness.adapter.handleRequest(target, harness.request, harness.response, harness.next.fn);
+        expect(harness.next.calls[0]?.[0]).toBeInstanceOf(ProsopoApiError);
+        expect(target.processRequest).not.toHaveBeenCalled();
+    });
+});
+describe("an endpoint that fails", () => {
+    test("is answered with a 500 and a generic message", async () => {
+        await harness.adapter.handleRequest(endpoint(undefined, async () => {
+            throw new Error("database down");
+        }), harness.request, harness.response, harness.next.fn);
+        expect(harness.status).toHaveBeenCalledWith(500);
+        expect(harness.send).toHaveBeenCalledWith("An internal server error occurred.");
+    });
+    test("does not leak the failure's message to the client", async () => {
+        await harness.adapter.handleRequest(endpoint(undefined, async () => {
+            throw new Error("connection string: postgres://user:secret@host");
+        }), harness.request, harness.response, harness.next.fn);
+        expect(String(harness.send.mock.calls[0]?.[0])).not.toContain("secret");
+    });
+    test("logs the failure against the request's logger", async () => {
+        const failure = new Error("database down");
+        await harness.adapter.handleRequest(endpoint(undefined, async () => {
+            throw failure;
+        }), harness.request, harness.response, harness.next.fn);
+        expect(harness.logged).toHaveBeenCalledTimes(1);
+        const entry = harness.logged.mock.calls[0]?.[0];
+        expect(entry?.()).toEqual({ err: failure });
+    });
+    test("does not also call next(), so the error handler is not double-run", async () => {
+        await harness.adapter.handleRequest(endpoint(undefined, async () => {
+            throw new Error("database down");
+        }), harness.request, harness.response, harness.next.fn);
+        expect(harness.next.calls).toHaveLength(0);
+    });
+    test("ignores the configured errorStatusCode and always answers 500", async () => {
+        harness = build({}, 503);
+        await harness.adapter.handleRequest(endpoint(undefined, async () => {
+            throw new Error("unavailable");
+        }), harness.request, harness.response, harness.next.fn);
+        expect(harness.status).toHaveBeenCalledWith(500);
+        expect(harness.status).not.toHaveBeenCalledWith(503);
+    });
+    test("a rejection with a non-Error value is handled just the same", async () => {
+        await harness.adapter.handleRequest(endpoint(undefined, async () => {
+            throw "a bare string";
+        }), harness.request, harness.response, harness.next.fn);
+        expect(harness.status).toHaveBeenCalledWith(500);
+        expect(harness.logged).toHaveBeenCalledTimes(1);
+    });
+    test("a failure while serialising the response is caught too", async () => {
+        const hostile = {
+            get status() {
+                throw new Error("getter exploded");
+            },
+        };
+        await harness.adapter.handleRequest(endpoint(undefined, async () => hostile), harness.request, harness.response, harness.next.fn);
+        expect(harness.status).toHaveBeenCalledWith(500);
+    });
+});
+//# sourceMappingURL=apiExpressDefaultEndpointAdapter.unit.test.js.map

package/dist/tests/unit/apiExpressDefaultEndpointAdapter.unit.test.js.map

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

package/dist/tests/unit/apiExpressRouterFactory.unit.test.d.ts

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

package/dist/tests/unit/apiExpressRouterFactory.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiExpressRouterFactory.unit.test.d.ts","sourceRoot":"","sources":["../../../src/tests/unit/apiExpressRouterFactory.unit.test.ts"],"names":[],"mappings":""}

package/dist/tests/unit/apiExpressRouterFactory.unit.test.js

@@ -0,0 +1,108 @@
+import { ApiEndpointResponseStatus, } from "@prosopo/api-route";
+import { beforeEach, describe, expect, test, vi } from "vitest";
+import { ApiExpressRouterFactory } from "../../apiExpressRouterFactory.js";
+import { handleErrors } from "../../errorHandler.js";
+import { captureNext } from "./testDoubles.js";
+const endpoint = () => ({
+    getRequestArgsSchema: vi.fn(() => undefined),
+    processRequest: vi.fn(async () => ({ status: ApiEndpointResponseStatus.SUCCESS })),
+});
+const provider = (routes) => ({
+    getRoutes: () => routes,
+});
+const adapter = () => ({
+    handleRequest: vi.fn(async () => undefined),
+});
+const postRoutes = (router) => {
+    const registered = [];
+    for (const layer of router.stack) {
+        const route = layer.route;
+        if (!route)
+            continue;
+        const handler = route.stack[route.stack.length - 1]?.handle;
+        if (handler)
+            registered.push([route.path, handler]);
+    }
+    return registered;
+};
+let factory;
+beforeEach(() => {
+    factory = new ApiExpressRouterFactory();
+});
+describe("createRouter", () => {
+    test("registers one POST route per entry the provider declares", () => {
+        const router = factory.createRouter(provider({ "/a": endpoint(), "/b": endpoint() }), adapter());
+        expect(postRoutes(router).map(([path]) => path)).toEqual(["/a", "/b"]);
+    });
+    test("registers the routes as POST only", () => {
+        const router = factory.createRouter(provider({ "/a": endpoint() }), adapter());
+        const route = router.stack.find((layer) => layer.route)?.route;
+        expect(route?.methods).toEqual({ post: true });
+    });
+    test("a provider with no routes still yields a router", () => {
+        const router = factory.createRouter(provider({}), adapter());
+        expect(postRoutes(router)).toEqual([]);
+        expect(router.stack).toHaveLength(1);
+    });
+    test("mounts the error handler last, after every route", () => {
+        const router = factory.createRouter(provider({ "/a": endpoint(), "/b": endpoint() }), adapter());
+        const last = router.stack[router.stack.length - 1];
+        expect(last?.handle).toBe(handleErrors);
+        expect(last?.route).toBeUndefined();
+    });
+    test("asks the provider for its routes exactly once", () => {
+        const getRoutes = vi.fn(() => ({ "/a": endpoint() }));
+        factory.createRouter({ getRoutes }, adapter());
+        expect(getRoutes).toHaveBeenCalledTimes(1);
+    });
+    test("each call builds a fresh router", () => {
+        const routes = provider({ "/a": endpoint() });
+        expect(factory.createRouter(routes, adapter())).not.toBe(factory.createRouter(routes, adapter()));
+    });
+    test("routes named oddly are passed to express verbatim", () => {
+        const router = factory.createRouter(provider({ "/": endpoint(), "/nested/:id": endpoint() }), adapter());
+        expect(postRoutes(router).map(([path]) => path)).toEqual([
+            "/",
+            "/nested/:id",
+        ]);
+    });
+});
+describe("the handler each route is given", () => {
+    test("hands the endpoint and the express trio to the adapter", async () => {
+        const target = endpoint();
+        const endpointAdapter = adapter();
+        const router = factory.createRouter(provider({ "/a": target }), endpointAdapter);
+        const request = {};
+        const response = {};
+        const next = captureNext();
+        const handler = postRoutes(router)[0]?.[1];
+        await handler?.(request, response, next.fn);
+        expect(endpointAdapter.handleRequest).toHaveBeenCalledWith(target, request, response, next.fn);
+    });
+    test("routes each path to its own endpoint, not the last one registered", () => {
+        const first = endpoint();
+        const second = endpoint();
+        const endpointAdapter = adapter();
+        const router = factory.createRouter(provider({ "/first": first, "/second": second }), endpointAdapter);
+        for (const [, handler] of postRoutes(router)) {
+            void handler({}, {}, captureNext().fn);
+        }
+        const handled = vi.mocked(endpointAdapter.handleRequest).mock.calls;
+        expect(handled.map(([called]) => called)).toEqual([first, second]);
+    });
+    test("propagates a rejection from the adapter to the caller", async () => {
+        const endpointAdapter = adapter();
+        vi.mocked(endpointAdapter.handleRequest).mockRejectedValue(new Error("adapter blew up"));
+        const router = factory.createRouter(provider({ "/a": endpoint() }), endpointAdapter);
+        const handler = postRoutes(router)[0]?.[1];
+        await expect(handler?.({}, {}, captureNext().fn)).rejects.toThrow("adapter blew up");
+    });
+    test("does not call the endpoint itself — that is the adapter's job", async () => {
+        const target = endpoint();
+        const router = factory.createRouter(provider({ "/a": target }), adapter());
+        const handler = postRoutes(router)[0]?.[1];
+        await handler?.({}, {}, captureNext().fn);
+        expect(target.processRequest).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=apiExpressRouterFactory.unit.test.js.map

package/dist/tests/unit/apiExpressRouterFactory.unit.test.js.map

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

package/dist/tests/unit/index.unit.test.d.ts

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

package/dist/tests/unit/index.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.unit.test.d.ts","sourceRoot":"","sources":["../../../src/tests/unit/index.unit.test.ts"],"names":[],"mappings":""}

package/dist/tests/unit/index.unit.test.js

@@ -0,0 +1,44 @@
+import { LogLevel } from "@prosopo/logger";
+import { describe, expect, test, vi } from "vitest";
+import { apiExpressRouterFactory, authMiddleware, createApiExpressDefaultEndpointAdapter, handleErrors, requestLoggerMiddleware, } from "../../index.js";
+describe("createApiExpressDefaultEndpointAdapter", () => {
+    test("builds an adapter exposing handleRequest", () => {
+        const adapter = createApiExpressDefaultEndpointAdapter(LogLevel.enum.info);
+        expect(typeof adapter.handleRequest).toBe("function");
+    });
+    test("builds a fresh adapter per call", () => {
+        expect(createApiExpressDefaultEndpointAdapter(LogLevel.enum.info)).not.toBe(createApiExpressDefaultEndpointAdapter(LogLevel.enum.info));
+    });
+    test("defaults the error status code so callers may omit it", () => {
+        expect(() => createApiExpressDefaultEndpointAdapter(LogLevel.enum.debug)).not.toThrow();
+    });
+    test("accepts an explicit error status code", () => {
+        expect(() => createApiExpressDefaultEndpointAdapter(LogLevel.enum.debug, 503)).not.toThrow();
+    });
+});
+describe("apiExpressRouterFactory", () => {
+    test("is exported as a single shared instance", () => {
+        expect(typeof apiExpressRouterFactory.createRouter).toBe("function");
+    });
+    test("builds a router from a provider", () => {
+        const provider = {
+            getRoutes: () => ({}),
+        };
+        const router = apiExpressRouterFactory.createRouter(provider, {
+            handleRequest: vi.fn(async () => undefined),
+        });
+        expect(typeof router).toBe("function");
+    });
+});
+describe("the re-exported middleware", () => {
+    test("exposes the error handler", () => {
+        expect(typeof handleErrors).toBe("function");
+    });
+    test("exposes the auth middleware", () => {
+        expect(typeof authMiddleware).toBe("function");
+    });
+    test("exposes the request logger middleware", () => {
+        expect(typeof requestLoggerMiddleware).toBe("function");
+    });
+});
+//# sourceMappingURL=index.unit.test.js.map