lambda-reactor 1.0.0 → 1.0.1

package/{src/route-handler.ts → dist/route-handler.d.ts}

@@ -1,8 +1,7 @@
-import {type Middleware} from "#src/middleware"
-import {Response} from "#src/response"
-import type {APIGatewayProxyEvent, Context} from "aws-lambda"
-import type {ZodType} from "zod"
-
+import { type Middleware } from "#src/middleware";
+import { Response } from "#src/response";
+import type { APIGatewayProxyEvent, Context } from "aws-lambda";
+import type { ZodType } from "zod";
 /**
  * The user-supplied handler function for a single HTTP method on a route.
  *
@@ -10,19 +9,18 @@ import type {ZodType} from "zod"
  * @typeParam TOutput - Shape of the value returned by the callback.
  */
 export type EndpointCallback<TInput, TOutput> = (props: {
-    body: TInput
-    event: APIGatewayProxyEvent
-    context: Context
-}) => Promise<TOutput | Response> | TOutput | Response
-
+    body: TInput;
+    event: APIGatewayProxyEvent;
+    context: Context;
+}) => Promise<TOutput | Response> | TOutput | Response;
 /**
  * Internal read-only view of a {@link Method} used by {@link dispatch} and
  * {@link createHandler}.  The type parameters are erased so that handlers for
  * different routes can be stored in the same map.
  */
 export interface RouteHandler {
-    readonly middlewares: Middleware[]
-    readonly bodySchema?: ZodType<unknown>
-    readonly outputSchema?: ZodType<unknown>
-    readonly callback?: (props: never) => unknown
+    readonly middlewares: Middleware[];
+    readonly bodySchema?: ZodType<unknown>;
+    readonly outputSchema?: ZodType<unknown>;
+    readonly callback?: (props: never) => unknown;
 }

package/dist/route-handler.js

@@ -0,0 +1,2 @@
+
+//# debugId=25332E27D5EF449C64756E2164756E21

package/dist/route-handler.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "25332E27D5EF449C64756E2164756E21",
+  "names": []
+}

package/dist/router-class.d.ts

@@ -0,0 +1,54 @@
+import { type FunctionFactory } from "#src/build-handlers";
+import { type CorsOptions, IRestApi } from "aws-cdk-lib/aws-apigateway";
+import { IFunction } from "aws-cdk-lib/aws-lambda";
+/**
+ * Immutable CDK router that maps route paths to Lambda-backed API Gateway
+ * resources.
+ *
+ * ```ts
+ * const api = router()
+ *   .cors({allowOrigins: ["*"]})
+ *   .route("/users")
+ *   .route("/items")
+ *   .defineRestApi(restApi, factory)
+ * ```
+ *
+ * @typeParam TPaths - Union of all route path strings registered so far.
+ */
+export declare class Router<TPaths extends string = never> {
+    srcDir: string;
+    corsOptions?: CorsOptions;
+    paths: TPaths[];
+    constructor(srcDir: string);
+    /**
+     * Returns a new `Router` with CORS preflight options applied to every
+     * resource added via {@link Router.route}.
+     *
+     * @param options - CDK `CorsOptions` passed to `addCorsPreflight`.
+     */
+    cors(options: CorsOptions): Router<TPaths>;
+    /**
+     * Registers a new route path and returns a new `Router` with the path
+     * added to its path union.
+     *
+     * @param path - Route path string (e.g. `"/users"`).  Must correspond to a
+     *   handler file at `<srcDir>/<path>.ts`.
+     */
+    route<TPath extends string>(path: TPath): Router<TPaths | TPath>;
+    /**
+     * Wires all registered routes into the given API Gateway REST API.
+     *
+     * For each route path the method:
+     * 1. Creates (or reuses) nested API Gateway resources for each path segment.
+     * 2. Optionally calls `addCorsPreflight` when CORS options are configured.
+     * 3. Reads the handler source file and extracts HTTP method names via
+     *    {@link getMethods}.
+     * 4. Adds an `addMethod` entry backed by a `LambdaIntegration` for each
+     *    discovered method.
+     *
+     * @param api     - The CDK `IRestApi` to attach resources and methods to.
+     * @param factory - {@link FunctionFactory} used to build Lambda functions.
+     * @returns A record mapping each route path to its {@link IFunction}.
+     */
+    defineRestApi<TApi extends IRestApi>(api: TApi, factory: FunctionFactory): Record<TPaths, IFunction>;
+}

package/dist/router-class.js

@@ -0,0 +1,46 @@
+// src/router-class.ts
+import { readFileSync } from "fs";
+import { join } from "path";
+import { buildHandlers } from "#src/build-handlers";
+import { getMethods } from "#src/router";
+import { LambdaIntegration } from "aws-cdk-lib/aws-apigateway";
+
+class Router {
+  srcDir;
+  corsOptions;
+  paths = [];
+  constructor(srcDir) {
+    this.srcDir = srcDir;
+  }
+  cors(options) {
+    const r = new Router(this.srcDir);
+    r.corsOptions = options;
+    r.paths = this.paths;
+    return r;
+  }
+  route(path) {
+    const r = new Router(this.srcDir);
+    if (this.corsOptions)
+      r.corsOptions = this.corsOptions;
+    r.paths = [...this.paths, path];
+    return r;
+  }
+  defineRestApi(api, factory) {
+    const handlers = buildHandlers(this.paths, factory);
+    for (const path of this.paths) {
+      const resource = path.split("/").filter(Boolean).reduce((r, part) => r.getResource(part) ?? r.addResource(part), api.root);
+      if (this.corsOptions)
+        resource.addCorsPreflight(this.corsOptions);
+      const src = readFileSync(join(process.cwd(), this.srcDir, `${path}.ts`), "utf-8");
+      for (const method of getMethods(src)) {
+        resource.addMethod(method, new LambdaIntegration(handlers[path]));
+      }
+    }
+    return handlers;
+  }
+}
+export {
+  Router
+};
+
+//# debugId=C6AD2943C8356E8564756E2164756E21

package/dist/router-class.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/router-class.ts"],
+  "sourcesContent": [
+    "import {readFileSync} from \"fs\"\nimport {join} from \"path\"\n\nimport {buildHandlers, type FunctionFactory} from \"#src/build-handlers\"\nimport {getMethods} from \"#src/router\"\nimport {type CorsOptions, IRestApi, LambdaIntegration} from \"aws-cdk-lib/aws-apigateway\"\nimport {IFunction} from \"aws-cdk-lib/aws-lambda\"\n\n/**\n * Immutable CDK router that maps route paths to Lambda-backed API Gateway\n * resources.\n *\n * ```ts\n * const api = router()\n *   .cors({allowOrigins: [\"*\"]})\n *   .route(\"/users\")\n *   .route(\"/items\")\n *   .defineRestApi(restApi, factory)\n * ```\n *\n * @typeParam TPaths - Union of all route path strings registered so far.\n */\nexport class Router<TPaths extends string = never> {\n    srcDir: string\n    corsOptions?: CorsOptions\n    paths: TPaths[] = []\n\n    constructor(srcDir: string) {\n        this.srcDir = srcDir\n    }\n\n    /**\n     * Returns a new `Router` with CORS preflight options applied to every\n     * resource added via {@link Router.route}.\n     *\n     * @param options - CDK `CorsOptions` passed to `addCorsPreflight`.\n     */\n    cors(options: CorsOptions): Router<TPaths> {\n        const r = new Router<TPaths>(this.srcDir)\n        r.corsOptions = options\n        r.paths = this.paths\n        return r\n    }\n\n    /**\n     * Registers a new route path and returns a new `Router` with the path\n     * added to its path union.\n     *\n     * @param path - Route path string (e.g. `\"/users\"`).  Must correspond to a\n     *   handler file at `<srcDir>/<path>.ts`.\n     */\n    route<TPath extends string>(path: TPath): Router<TPaths | TPath> {\n        const r = new Router<TPaths | TPath>(this.srcDir)\n        if (this.corsOptions) r.corsOptions = this.corsOptions\n        r.paths = [...this.paths, path as unknown as TPaths | TPath]\n        return r\n    }\n\n    /**\n     * Wires all registered routes into the given API Gateway REST API.\n     *\n     * For each route path the method:\n     * 1. Creates (or reuses) nested API Gateway resources for each path segment.\n     * 2. Optionally calls `addCorsPreflight` when CORS options are configured.\n     * 3. Reads the handler source file and extracts HTTP method names via\n     *    {@link getMethods}.\n     * 4. Adds an `addMethod` entry backed by a `LambdaIntegration` for each\n     *    discovered method.\n     *\n     * @param api     - The CDK `IRestApi` to attach resources and methods to.\n     * @param factory - {@link FunctionFactory} used to build Lambda functions.\n     * @returns A record mapping each route path to its {@link IFunction}.\n     */\n    defineRestApi<TApi extends IRestApi>(\n        api: TApi,\n        factory: FunctionFactory,\n    ): Record<TPaths, IFunction> {\n        const handlers = buildHandlers(this.paths, factory)\n        for (const path of this.paths) {\n            const resource = path\n                .split(\"/\")\n                .filter(Boolean)\n                .reduce(\n                    (r, part) => r.getResource(part) ?? r.addResource(part),\n                    api.root,\n                )\n            if (this.corsOptions) resource.addCorsPreflight(this.corsOptions)\n            const src = readFileSync(\n                join(process.cwd(), this.srcDir, `${path}.ts`),\n                \"utf-8\",\n            )\n            for (const method of getMethods(src)) {\n                resource.addMethod(method, new LambdaIntegration(handlers[path]!))\n            }\n        }\n        return handlers\n    }\n}\n"
+  ],
+  "mappings": ";AAAA;AACA;AAEA;AACA;AACA;AAAA;AAiBO,MAAM,OAAsC;AAAA,EAC/C;AAAA,EACA;AAAA,EACA,QAAkB,CAAC;AAAA,EAEnB,WAAW,CAAC,QAAgB;AAAA,IACxB,KAAK,SAAS;AAAA;AAAA,EASlB,IAAI,CAAC,SAAsC;AAAA,IACvC,MAAM,IAAI,IAAI,OAAe,KAAK,MAAM;AAAA,IACxC,EAAE,cAAc;AAAA,IAChB,EAAE,QAAQ,KAAK;AAAA,IACf,OAAO;AAAA;AAAA,EAUX,KAA2B,CAAC,MAAqC;AAAA,IAC7D,MAAM,IAAI,IAAI,OAAuB,KAAK,MAAM;AAAA,IAChD,IAAI,KAAK;AAAA,MAAa,EAAE,cAAc,KAAK;AAAA,IAC3C,EAAE,QAAQ,CAAC,GAAG,KAAK,OAAO,IAAiC;AAAA,IAC3D,OAAO;AAAA;AAAA,EAkBX,aAAoC,CAChC,KACA,SACyB;AAAA,IACzB,MAAM,WAAW,cAAc,KAAK,OAAO,OAAO;AAAA,IAClD,WAAW,QAAQ,KAAK,OAAO;AAAA,MAC3B,MAAM,WAAW,KACZ,MAAM,GAAG,EACT,OAAO,OAAO,EACd,OACG,CAAC,GAAG,SAAS,EAAE,YAAY,IAAI,KAAK,EAAE,YAAY,IAAI,GACtD,IAAI,IACR;AAAA,MACJ,IAAI,KAAK;AAAA,QAAa,SAAS,iBAAiB,KAAK,WAAW;AAAA,MAChE,MAAM,MAAM,aACR,KAAK,QAAQ,IAAI,GAAG,KAAK,QAAQ,GAAG,SAAS,GAC7C,OACJ;AAAA,MACA,WAAW,UAAU,WAAW,GAAG,GAAG;AAAA,QAClC,SAAS,UAAU,QAAQ,IAAI,kBAAkB,SAAS,KAAM,CAAC;AAAA,MACrE;AAAA,IACJ;AAAA,IACA,OAAO;AAAA;AAEf;",
+  "debugId": "C6AD2943C8356E8564756E2164756E21",
+  "names": []
+}

package/{src/router.ts → dist/router.d.ts}

@@ -1,7 +1,5 @@
-import {Router} from "#src/router-class"
-
-export {Router}
-
+import { Router } from "#src/router-class";
+export { Router };
 /**
  * Extracts the HTTP method names declared inside a `createHandler({…})` call
  * by statically scanning the source text of a handler file.
@@ -10,21 +8,11 @@ export {Router}
  * @returns Array of upper-case HTTP method names (e.g. `["GET", "POST"]`),
  *   or an empty array when no `createHandler` call is found.
  */
-export function getMethods(src: string): string[] {
-    const match = src.match(/createHandler\(\{([^}]*)\}\)/)
-    if (!match || !match[1]) return []
-    return match[1]
-        .split(",")
-        .map((s) => s.trim())
-        .filter(Boolean)
-}
-
+export declare function getMethods(src: string): string[];
 /**
  * Creates a new, empty {@link Router} builder.
  *
  * @param srcDir - Directory (relative to `cwd`) where handler `.ts` files
  *   live.  Defaults to `"src"`.
  */
-export function router(srcDir: string = "src"): Router {
-    return new Router(srcDir)
-}
+export declare function router(srcDir?: string): Router;

package/dist/router.js

@@ -0,0 +1,18 @@
+// src/router.ts
+import { Router } from "#src/router-class";
+function getMethods(src) {
+  const match = src.match(/createHandler\(\{([^}]*)\}\)/);
+  if (!match || !match[1])
+    return [];
+  return match[1].split(",").map((s) => s.trim()).filter(Boolean);
+}
+function router(srcDir = "src") {
+  return new Router(srcDir);
+}
+export {
+  router,
+  getMethods,
+  Router
+};
+
+//# debugId=555487F73388CB1F64756E2164756E21

package/dist/router.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/router.ts"],
+  "sourcesContent": [
+    "import {Router} from \"#src/router-class\"\n\nexport {Router}\n\n/**\n * Extracts the HTTP method names declared inside a `createHandler({…})` call\n * by statically scanning the source text of a handler file.\n *\n * @param src - Raw TypeScript source of a handler module.\n * @returns Array of upper-case HTTP method names (e.g. `[\"GET\", \"POST\"]`),\n *   or an empty array when no `createHandler` call is found.\n */\nexport function getMethods(src: string): string[] {\n    const match = src.match(/createHandler\\(\\{([^}]*)\\}\\)/)\n    if (!match || !match[1]) return []\n    return match[1]\n        .split(\",\")\n        .map((s) => s.trim())\n        .filter(Boolean)\n}\n\n/**\n * Creates a new, empty {@link Router} builder.\n *\n * @param srcDir - Directory (relative to `cwd`) where handler `.ts` files\n *   live.  Defaults to `\"src\"`.\n */\nexport function router(srcDir: string = \"src\"): Router {\n    return new Router(srcDir)\n}\n"
+  ],
+  "mappings": ";AAAA;AAYO,SAAS,UAAU,CAAC,KAAuB;AAAA,EAC9C,MAAM,QAAQ,IAAI,MAAM,8BAA8B;AAAA,EACtD,IAAI,CAAC,SAAS,CAAC,MAAM;AAAA,IAAI,OAAO,CAAC;AAAA,EACjC,OAAO,MAAM,GACR,MAAM,GAAG,EACT,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EACnB,OAAO,OAAO;AAAA;AAShB,SAAS,MAAM,CAAC,SAAiB,OAAe;AAAA,EACnD,OAAO,IAAI,OAAO,MAAM;AAAA;",
+  "debugId": "555487F73388CB1F64756E2164756E21",
+  "names": []
+}

package/package.json

@@ -1,18 +1,28 @@
 {
     "name": "lambda-reactor",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "scripts": {
         "prepare": "lefthook install",
         "check": "tsgo",
         "lint": "eslint --fix",
         "format": "prettier -uwu .",
         "test": "vitest",
-        "build": "rm -rf dist && tsgo -p tsconfig.build.json && bun build --target=node --external='*' --splitting --sourcemap=external --keep-names --root=src --outdir=dist src/*.ts"
+        "build": "rm -rf dist && tsgo -p tsconfig.build.json && bun build --target=node --external='*' --splitting --sourcemap=external --keep-names --root=src --outdir=dist src/*.ts",
+        "prepublishOnly": "bun run build"
     },
     "type": "module",
     "imports": {
         "#src/*": "./src/*.ts"
     },
+    "files": [
+        "dist"
+    ],
+    "exports": {
+        "./*": {
+            "types": "./dist/*.d.ts",
+            "default": "./dist/*.js"
+        }
+    },
     "devDependencies": {
         "@eslint/js": "^10.0.1",
         "@types/aws-lambda": "^8.10.161",

package/.prettierrc

@@ -1,8 +0,0 @@
-{
-    "semi": false,
-    "tabWidth": 4,
-    "bracketSpacing": false,
-    "experimentalTernaries": true,
-    "printWidth": 88,
-    "endOfLine": "lf"
-}

package/AGENTS.md

@@ -1,7 +0,0 @@
-use absolute imports like `"#src/router"`
-run `.git/hooks/pre-commit && bun run check` to ensure code quality
-whenever you add a feature or fix a bug, add tests and documentation for it (jsdoc)
-you may not suppress eslint rules or typescript errors
-functions must either be 100% pure, or be 100% side-effectful
-if a function returns a value other than undefined, then it must be pure
-if a function has side-effects, then it must only return undefined