lambda-reactor 1.0.0

package/tests/handler.test.ts

@@ -0,0 +1,48 @@
+import {createHandler} from "#src/handler"
+import {method} from "#src/method"
+import {Response} from "#src/response"
+import type {APIGatewayProxyEvent, Context} from "aws-lambda"
+import {describe, expect, it, vi} from "vitest"
+
+vi.mock("source-map-support", () => ({install: vi.fn()}))
+
+function event(httpMethod: string): APIGatewayProxyEvent {
+    return {
+        body: null,
+        headers: {},
+        multiValueHeaders: {},
+        httpMethod,
+        isBase64Encoded: false,
+        path: "/",
+        pathParameters: null,
+        queryStringParameters: null,
+        multiValueQueryStringParameters: null,
+        stageVariables: null,
+        resource: "/",
+        requestContext: {} as APIGatewayProxyEvent["requestContext"],
+    }
+}
+
+const context = {} as Context
+
+describe("createHandler", () => {
+    it("passes through Response instances", async () => {
+        const callback = vi.fn(() => Response.text(204, ""))
+        const handler = createHandler({GET: method().handle(callback)})
+        await expect(handler(event("GET"), context)).resolves.toEqual({
+            statusCode: 204,
+            body: "",
+            headers: {"Content-Type": "text/plain; charset=utf-8"},
+        })
+        expect(callback).toHaveBeenCalledOnce()
+    })
+
+    it("returns 500 when callback is not defined", async () => {
+        const handler = createHandler({GET: method()})
+        await expect(handler(event("GET"), context)).resolves.toEqual({
+            statusCode: 500,
+            body: "Route has no handler defined",
+            headers: {"Content-Type": "text/plain; charset=utf-8"},
+        })
+    })
+})

package/tests/method.test.ts

@@ -0,0 +1,40 @@
+import {method} from "#src/method"
+import {describe, expect, it} from "vitest"
+import {z} from "zod"
+
+describe("method", () => {
+    it("creates a method with no schema", () => {
+        const m = method()
+        expect(m.bodySchema).toBeUndefined()
+        expect(m.outputSchema).toBeUndefined()
+        expect(m.callback).toBeUndefined()
+    })
+
+    it("chains input schema", () => {
+        const schema = z.object({name: z.string()})
+        const m = method().input(schema)
+        expect(m.bodySchema).toBe(schema)
+    })
+
+    it("chains output schema", () => {
+        const schema = z.object({id: z.number()})
+        const m = method().output(schema)
+        expect(m.outputSchema).toBe(schema)
+    })
+
+    it("chains handle callback", () => {
+        const cb = async () => ({ok: true})
+        const m = method().handle(cb)
+        expect(m.callback).toBe(cb)
+    })
+
+    it("preserves schemas through handle chain", () => {
+        const input = z.object({x: z.string()})
+        const output = z.object({y: z.number()})
+        const cb = async () => ({y: 1})
+        const m = method().input(input).output(output).handle(cb)
+        expect(m.bodySchema).toBe(input)
+        expect(m.outputSchema).toBe(output)
+        expect(m.callback).toBe(cb)
+    })
+})

package/tests/response.test.ts

@@ -0,0 +1,29 @@
+import {Response} from "#src/response"
+import {describe, expect, it} from "vitest"
+
+describe("Response", () => {
+    it("serializes json bodies", () => {
+        expect(
+            Response.json(201, {ok: true})
+                .header("X-Test", "1")
+                .toAPIGatewayProxyResult(),
+        ).toEqual({
+            statusCode: 201,
+            body: JSON.stringify({ok: true}),
+            headers: {
+                "Content-Type": "application/json; charset=utf-8",
+                "X-Test": "1",
+            },
+        })
+    })
+
+    it("serializes text bodies", () => {
+        expect(Response.text(400, "nope").toAPIGatewayProxyResult()).toEqual({
+            statusCode: 400,
+            body: "nope",
+            headers: {
+                "Content-Type": "text/plain; charset=utf-8",
+            },
+        })
+    })
+})

package/tsconfig.build.json

@@ -0,0 +1,26 @@
+{
+    "compilerOptions": {
+        "target": "esnext",
+        "module": "esnext",
+        "moduleResolution": "bundler",
+        "lib": ["esnext"],
+        "types": ["node"],
+        "strict": true,
+        "skipLibCheck": true,
+        "noUncheckedIndexedAccess": true,
+        "noImplicitOverride": true,
+        "noImplicitAny": true,
+        "noPropertyAccessFromIndexSignature": true,
+        "exactOptionalPropertyTypes": true,
+        "noFallthroughCasesInSwitch": true,
+        "noImplicitReturns": true,
+        "noUnusedLocals": true,
+        "noUnusedParameters": true,
+        "declaration": true,
+        "emitDeclarationOnly": true,
+        "sourceMap": true,
+        "rootDir": "./src/",
+        "outDir": "./dist/"
+    },
+    "include": ["./src/"]
+}

package/tsconfig.json

@@ -0,0 +1,3 @@
+{
+    "extends": ["./tsconfig.build.json", "./tsconfig.node.json"]
+}

package/tsconfig.node.json

@@ -0,0 +1,24 @@
+{
+    "compilerOptions": {
+        "target": "esnext",
+        "module": "esnext",
+        "moduleResolution": "bundler",
+        "lib": ["esnext"],
+        "types": ["node", "vitest/globals"],
+        "strict": true,
+        "skipLibCheck": true,
+        "noUncheckedIndexedAccess": true,
+        "noImplicitOverride": true,
+        "noImplicitAny": true,
+        "noPropertyAccessFromIndexSignature": true,
+        "exactOptionalPropertyTypes": false,
+        "noFallthroughCasesInSwitch": true,
+        "noImplicitReturns": true,
+        "noUnusedLocals": true,
+        "noUnusedParameters": true,
+        "noEmit": true,
+        "rootDir": "."
+    },
+    "include": ["."],
+    "exclude": ["./src/", "./dist/"]
+}

package/vitest.config.ts

@@ -0,0 +1,21 @@
+import {fileURLToPath, URL} from "node:url"
+
+import {defineConfig} from "vitest/config"
+
+export default defineConfig({
+    resolve: {
+        alias: {
+            "#src": fileURLToPath(new URL("./src", import.meta.url)),
+        },
+    },
+    test: {
+        globals: true,
+        environment: "node",
+        include: ["tests/**/*.test.{ts,tsx}"],
+        setupFiles: ["./vitest.setup.ts"],
+        coverage: {
+            provider: "v8",
+            include: ["src/**/*.ts"],
+        },
+    },
+})

package/vitest.setup.ts

@@ -0,0 +1,2 @@
+// Vitest setup file
+// Add any global test setup here