@prosopo/api-express-router 3.1.50 → 3.1.52

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.unit.test.js","sourceRoot":"","sources":["../../../src/tests/unit/index.unit.test.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACpD,OAAO,EACN,uBAAuB,EACvB,cAAc,EACd,sCAAsC,EACtC,YAAY,EACZ,uBAAuB,GACvB,MAAM,gBAAgB,CAAC;AAQxB,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE;IACvD,IAAI,CAAC,0CAA0C,EAAE,GAAG,EAAE;QACrD,MAAM,OAAO,GAAG,sCAAsC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3E,MAAM,CAAC,OAAO,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,iCAAiC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,sCAAsC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAC1E,sCAAsC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAC1D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,GAAG,EAAE,CACX,sCAAsC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAC3D,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,GAAG,EAAE,CACX,sCAAsC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAChE,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACxC,IAAI,CAAC,yCAAyC,EAAE,GAAG,EAAE;QAGpD,MAAM,CAAC,OAAO,uBAAuB,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,iCAAiC,EAAE,GAAG,EAAE;QAC5C,MAAM,QAAQ,GAAsB;YACnC,SAAS,EAAE,GAAc,EAAE,CAAC,CAAC,EAAE,CAAC;SAChC,CAAC;QACF,MAAM,MAAM,GAAG,uBAAuB,CAAC,YAAY,CAAC,QAAQ,EAAE;YAC7D,aAAa,EAAE,EAAE,CAAC,EAAE,CAOlB,KAAK,IAAI,EAAE,CAAC,SAAS,CAAC;SACxB,CAAC,CAAC;QACH,MAAM,CAAC,OAAO,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC3C,IAAI,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,OAAO,YAAY,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}