lambda-pipe 0.1.0 → 0.1.2

package/README.md

@@ -717,6 +717,56 @@ See: [DOC](https://github.com/delpikye-v/lambda-pipe/blob/main/docs/websocket.md
 
 ---
 
+# Server Runtime
+
+Production-ready Fastify runtime for LambdaPipe.
+
+Designed for:
+
+* bundled deployments
+* lazy-loaded route manifests
+* serverless adapters
+* container deployments
+* runtime middleware pipelines
+* runtime plugin lifecycle hooks
+
+Unlike the dev runtime, production mode does not scan the filesystem dynamically.
+
+Routes are registered through a static manifest for deterministic builds and deployment-safe startup.
+
+```ts
+import { bootstrap } from 'lambda-pipe/server'
+
+import routes from './routes.manifest'
+
+await bootstrap({
+  port: 3000,
+
+  routes,
+})
+
+```
+
+```ts
+// routes.manifest.ts
+
+import type {
+  RouteLoader,
+} from 'lambda-pipe/server'
+
+const routes: RouteLoader[] = [
+  () => import('./routes/health'),
+
+  () => import('./routes/user'),
+]
+
+export default routes
+```
+
+See: [DOC](https://github.com/delpikye-v/lambda-pipe/blob/main/docs/websocket.md)
+
+---
+
 # Philosophy
 
 ```text

package/build/cjs/cli/index.js

@@ -1 +1 @@
-"use strict";var e=require("node:crypto"),t=require("node:fs"),r=require("node:path"),o=require("node:url"),n=require("@fastify/cookie"),s=require("chokidar"),a=require("fastify");Math.random().toString(36).slice(2);const i=[];function c(e){return e.endsWith(".ts")||e.endsWith(".js")||e.endsWith(".mjs")||e.endsWith(".cjs")}function u(e){if(e)return function(e){try{return JSON.parse(e)}catch{return e}}(e)}function h(t){return{headers:t.headers,body:t.body,queryStringParameters:t.query,pathParameters:t.params,cookies:t.cookies,rawPath:t.url,requestContext:{requestId:e.randomUUID(),http:{method:t.method}}}}async function d(e,n){const s=t.readdirSync(n,{withFileTypes:!0});for(const t of s){const s=r.join(n,t.name);if(t.isDirectory()){await d(e,s);continue}if(!c(t.name))continue;const a=(await import(o.pathToFileURL(s).href+"?v="+Date.now())).default;a?.__isRoute&&(i.push({method:a.method.toUpperCase(),path:a.path,file:s}),e.route({method:a.method.toUpperCase(),url:a.path,handler:async(e,t)=>{try{const r=await a.handler(h(e),{});if(t.code(r.statusCode),r.headers)for(const[e,o]of Object.entries(r.headers))t.header(e,o);return u(r.body)}catch(e){t.code(500).send({error:e.message,stack:e.stack,path:a.path})}}}))}}async function p(e={}){const o=a({logger:e.logger??!0});await o.register(n);const c=(u=e.routesDir,r.resolve(process.cwd(),u||process.env.ROUTES_DIR||"src/routes"));var u;if(!t.existsSync(c))throw Error("Routes directory not found: "+c);return function(e){e.get("/__routes",async()=>({routes:i})),e.get("/__health",async()=>({ok:!0,ts:Date.now()}))}(o),await d(o,c),!1!==e.hmr&&function(e,t){s.watch(t,{ignoreInitial:!0}).on("change",e=>{process.exit(0)})}(0,c),o}exports.bootstrap=async function(e={}){const t=await p(e),r=function(e){return Number(e||process.env.PORT||3e3)}(e.port),o=function(e){return e||process.env.HOST||"0.0.0.0"}(e.host);return await t.listen({port:r,host:o}),t},exports.createDevApp=p;
+"use strict";var e=require("node:fs"),t=require("node:path"),o=require("node:url"),r=require("@fastify/cookie"),n=require("chokidar"),s=require("fastify"),a=require("node:crypto");function i(e,t){return{headers:e.headers,body:e.body,queryStringParameters:e.query,pathParameters:e.params,cookies:e.cookies||{},rawPath:e.url,method:e.method,requestId:a.randomUUID(),request:e,reply:t}}async function c(e=[],t){for(const o of e)await o(t)}async function u(e,t){const o=t.statusCode||200;if(e.code(o),t.headers)for(const[o,r]of Object.entries(t.headers))e.header(o,r);return t.body}async function d(e,t,o=[]){for(const r of o)r.onError&&await r.onError(e,t);return t.reply.code(e.statusCode||500),{error:e.message||"Internal Server Error",stack:"development"===process.env.NODE_ENV?e.stack:void 0}}async function f(e=[],t){for(const o of e)o.onRequest&&await o.onRequest(t)}async function h(e=[],t,o){for(const r of e)r.onResponse&&await r.onResponse(t,o)}const p=[];function y(e){return e.endsWith(".ts")||e.endsWith(".js")||e.endsWith(".mjs")||e.endsWith(".cjs")}async function l(r,n,s){const a=e.readdirSync(n,{withFileTypes:!0});for(const e of a){const a=t.join(n,e.name);if(e.isDirectory()){await l(r,a,s);continue}if(!y(e.name))continue;const w=(await import(o.pathToFileURL(a).href+"?v="+Date.now())).default;w?.__isRoute&&(p.push({method:w.method.toUpperCase(),path:w.path,file:a}),r.route({method:w.method.toUpperCase(),url:w.path,handler:async(e,t)=>{const o=i(e,t);try{await f(s.plugins,o),await c(s.globalMiddlewares,o),await c(w.middlewares,o);const e=await w.handler(o,r);return await h(s.plugins,o,e),u(t,e)}catch(e){return d(e,o,s.plugins)}}}))}}async function w(o={}){const a=s({logger:o.logger??!0});await a.register(r),await async function(e=[],t){for(const o of e)o.onInit&&await o.onInit(t)}(o.plugins,a);const i=(c=o.routesDir,t.resolve(process.cwd(),c||process.env.ROUTES_DIR||"src/routes"));var c;if(!e.existsSync(i))throw Error("Routes directory not found: "+i);return function(e){e.get("/__routes",async()=>({routes:p})),e.get("/__health",async()=>({ok:!0,ts:Date.now()}))}(a),await l(a,i,o),!1!==o.hmr&&function(e){n.watch(e,{ignoreInitial:!0}).on("change",e=>{process.exit(0)})}(i),a}exports.bootstrap=async function(e={}){const t=await w(e),o=function(e){return Number(e||process.env.PORT||3e3)}(e.port),r=function(e){return e||process.env.HOST||"0.0.0.0"}(e.host);return await t.listen({port:o,host:r}),t},exports.createDevApp=w;

package/build/cjs/server/index.js

@@ -0,0 +1 @@
+"use strict";var o=require("@fastify/cookie"),t=require("fastify"),e=require("node:crypto");const r=new WeakMap;function n(o,t){return{headers:o.headers,body:o.body,queryStringParameters:o.query,pathParameters:o.params,cookies:o.cookies||{},rawPath:o.url,method:o.method,requestId:e.randomUUID(),request:o,reply:t}}async function a(o=[],t){for(const e of o)await e(t)}async function s(o,t){const e=t.statusCode||200;if(o.code(e),t.headers)for(const[e,r]of Object.entries(t.headers))o.header(e,r);return t.body}async function i(o,t,e=[]){for(const r of e)r.onError&&await r.onError(o,t);return t.reply.code(o.statusCode||500),{error:o.message||"Internal Server Error",stack:"development"===process.env.NODE_ENV?o.stack:void 0}}async function c(o){const t=r.get(o);if(t)return t;const e=(await o()).default;if(!e?.__isRoute)throw Error("Invalid route module");return r.set(o,e),e}async function u(o=[],t){for(const e of o)e.onRequest&&await e.onRequest(t)}async function f(o=[],t,e){for(const r of o)r.onResponse&&await r.onResponse(t,e)}async function d(e){const r=t({logger:e.logger??!0});await r.register(o),await async function(o=[],t){for(const e of o)e.onInit&&await e.onInit(t)}(e.plugins,r);for(const o of e.routes){const t=await c(o);r.log.info(`⚡ ${t.method} ${t.path}`),r.route({method:t.method,url:t.path,handler:async(o,c)=>{const d=n(o,c);try{await u(e.plugins,d),await a(e.globalMiddlewares,d),await a(t.middlewares,d);const o=await t.handler(d,r);return await f(e.plugins,d,o),s(c,o)}catch(o){return i(o,d,e.plugins)}}})}return r}exports.bootstrap=async function(o){const t=await d(o),e=Number(o.port||process.env.PORT||3e3),r=o.host||process.env.HOST||"0.0.0.0";return await t.listen({port:e,host:r}),t.log.info(""),t.log.info("🚀 LambdaPipe Runtime"),t.log.info(`🌐 http://${r}:${e}`),t.log.info("📦 routes: "+o.routes.length),t.log.info(""),t},exports.createRuntimeApp=d;

package/build/cli/dev.d.ts

@@ -1,10 +1,12 @@
-import { type FastifyInstance } from 'fastify';
+import type { RuntimeMiddleware, RuntimePlugin } from './shared';
 export type CreateDevAppOptions = {
     port?: number;
     host?: string;
     routesDir?: string;
     logger?: boolean;
     hmr?: boolean;
+    plugins?: RuntimePlugin[];
+    globalMiddlewares?: RuntimeMiddleware[];
 };
-export declare function createDevApp(options?: CreateDevAppOptions): Promise<FastifyInstance<import("node:http").Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>, import("node:http").IncomingMessage, import("node:http").ServerResponse<import("node:http").IncomingMessage>, import("fastify").FastifyBaseLogger, import("fastify").FastifyTypeProviderDefault>>;
-export declare function bootstrap(options?: CreateDevAppOptions): Promise<FastifyInstance<import("node:http").Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>, import("node:http").IncomingMessage, import("node:http").ServerResponse<import("node:http").IncomingMessage>, import("fastify").FastifyBaseLogger, import("fastify").FastifyTypeProviderDefault>>;
+export declare function createDevApp(options?: CreateDevAppOptions): Promise<import("fastify").FastifyInstance<import("node:http").Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>, import("node:http").IncomingMessage, import("node:http").ServerResponse<import("node:http").IncomingMessage>, import("fastify").FastifyBaseLogger, import("fastify").FastifyTypeProviderDefault>>;
+export declare function bootstrap(options?: CreateDevAppOptions): Promise<import("fastify").FastifyInstance<import("node:http").Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>, import("node:http").IncomingMessage, import("node:http").ServerResponse<import("node:http").IncomingMessage>, import("fastify").FastifyBaseLogger, import("fastify").FastifyTypeProviderDefault>>;

package/build/cli/routes.manifest.d.ts

@@ -0,0 +1 @@
+export declare const routes: (() => Promise<typeof import("../../src/routes/health")>)[];

package/build/cli/server.d.ts

@@ -0,0 +1,13 @@
+import type { RouteLoader, RuntimeMiddleware, RuntimePlugin } from './shared';
+export type CreateRuntimeAppOptions = {
+    routes: RouteLoader[];
+    logger?: boolean;
+    plugins?: RuntimePlugin[];
+    globalMiddlewares?: RuntimeMiddleware[];
+};
+export type BootstrapOptions = CreateRuntimeAppOptions & {
+    port?: number;
+    host?: string;
+};
+export declare function createRuntimeApp(options: CreateRuntimeAppOptions): Promise<import("fastify").FastifyInstance<import("node:http").Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>, import("node:http").IncomingMessage, import("node:http").ServerResponse<import("node:http").IncomingMessage>, import("fastify").FastifyBaseLogger, import("fastify").FastifyTypeProviderDefault>>;
+export declare function bootstrap(options: BootstrapOptions): Promise<import("fastify").FastifyInstance<import("node:http").Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>, import("node:http").IncomingMessage, import("node:http").ServerResponse<import("node:http").IncomingMessage>, import("fastify").FastifyBaseLogger, import("fastify").FastifyTypeProviderDefault>>;

package/build/cli/shared.d.ts

@@ -0,0 +1,49 @@
+import type { FastifyReply, FastifyRequest } from 'fastify';
+export type RuntimeContext = {
+    headers: Record<string, any>;
+    body: unknown;
+    queryStringParameters: Record<string, any>;
+    pathParameters: Record<string, any>;
+    cookies: Record<string, any>;
+    rawPath: string;
+    method: string;
+    requestId: string;
+    request: FastifyRequest;
+    reply: FastifyReply;
+};
+export type RuntimeResponse = {
+    statusCode?: number;
+    headers?: Record<string, any>;
+    body?: any;
+};
+export type RuntimeMiddleware = (ctx: RuntimeContext) => Promise<void> | void;
+export type RuntimePlugin = {
+    name?: string;
+    onInit?: (app: any) => Promise<void> | void;
+    onRequest?: (ctx: RuntimeContext) => Promise<void> | void;
+    onResponse?: (ctx: RuntimeContext, response: RuntimeResponse) => Promise<void> | void;
+    onError?: (error: unknown, ctx: RuntimeContext) => Promise<void> | void;
+};
+export type RouteDefinition = {
+    __isRoute?: boolean;
+    path: string;
+    method: string;
+    middlewares?: RuntimeMiddleware[];
+    handler: (ctx: RuntimeContext, app: any) => Promise<RuntimeResponse>;
+};
+export type RouteModule = {
+    default: RouteDefinition;
+};
+export type RouteLoader = () => Promise<RouteModule>;
+export declare const moduleCache: WeakMap<RouteLoader, RouteDefinition>;
+export declare function createRuntimeContext(req: FastifyRequest, reply: FastifyReply): RuntimeContext;
+export declare function runMiddlewares(middlewares: RuntimeMiddleware[] | undefined, ctx: RuntimeContext): Promise<void>;
+export declare function serializeResponse(reply: FastifyReply, response: RuntimeResponse): Promise<any>;
+export declare function handleRuntimeError(error: any, ctx: RuntimeContext, plugins?: RuntimePlugin[]): Promise<{
+    error: any;
+    stack: any;
+}>;
+export declare function loadRouteModule(load: RouteLoader): Promise<RouteDefinition>;
+export declare function runPluginOnInit(plugins: RuntimePlugin[] | undefined, app: any): Promise<void>;
+export declare function runPluginOnRequest(plugins: RuntimePlugin[] | undefined, ctx: RuntimeContext): Promise<void>;
+export declare function runPluginOnResponse(plugins: RuntimePlugin[] | undefined, ctx: RuntimeContext, response: RuntimeResponse): Promise<void>;

package/build/esm/cli/index.js

@@ -1 +1 @@
-import t from"node:crypto";import e from"node:fs";import r from"node:path";import{pathToFileURL as o}from"node:url";import n from"@fastify/cookie";import s from"chokidar";import a from"fastify";Math.random().toString(36).slice(2);const i=[];function c(t){return t.endsWith(".ts")||t.endsWith(".js")||t.endsWith(".mjs")||t.endsWith(".cjs")}function u(t){if(t)return function(t){try{return JSON.parse(t)}catch{return t}}(t)}function h(e){return{headers:e.headers,body:e.body,queryStringParameters:e.query,pathParameters:e.params,cookies:e.cookies,rawPath:e.url,requestContext:{requestId:t.randomUUID(),http:{method:e.method}}}}async function d(t,n){const s=e.readdirSync(n,{withFileTypes:!0});for(const e of s){const s=r.join(n,e.name);if(e.isDirectory()){await d(t,s);continue}if(!c(e.name))continue;const a=(await import(o(s).href+"?v="+Date.now())).default;a?.__isRoute&&(i.push({method:a.method.toUpperCase(),path:a.path,file:s}),t.route({method:a.method.toUpperCase(),url:a.path,handler:async(t,e)=>{try{const r=await a.handler(h(t),{});if(e.code(r.statusCode),r.headers)for(const[t,o]of Object.entries(r.headers))e.header(t,o);return u(r.body)}catch(t){e.code(500).send({error:t.message,stack:t.stack,path:a.path})}}}))}}async function f(t={}){const o=a({logger:t.logger??!0});await o.register(n);const c=(u=t.routesDir,r.resolve(process.cwd(),u||process.env.ROUTES_DIR||"src/routes"));var u;if(!e.existsSync(c))throw Error("Routes directory not found: "+c);return function(t){t.get("/__routes",async()=>({routes:i})),t.get("/__health",async()=>({ok:!0,ts:Date.now()}))}(o),await d(o,c),!1!==t.hmr&&function(t,e){s.watch(e,{ignoreInitial:!0}).on("change",t=>{process.exit(0)})}(0,c),o}async function p(t={}){const e=await f(t),r=function(t){return Number(t||process.env.PORT||3e3)}(t.port),o=function(t){return t||process.env.HOST||"0.0.0.0"}(t.host);return await e.listen({port:r,host:o}),e}export{p as bootstrap,f as createDevApp};
+import t from"node:fs";import o from"node:path";import{pathToFileURL as e}from"node:url";import r from"@fastify/cookie";import n from"chokidar";import s from"fastify";import a from"node:crypto";function i(t,o){return{headers:t.headers,body:t.body,queryStringParameters:t.query,pathParameters:t.params,cookies:t.cookies||{},rawPath:t.url,method:t.method,requestId:a.randomUUID(),request:t,reply:o}}async function c(t=[],o){for(const e of t)await e(o)}async function u(t,o){const e=o.statusCode||200;if(t.code(e),o.headers)for(const[e,r]of Object.entries(o.headers))t.header(e,r);return o.body}async function f(t,o,e=[]){for(const r of e)r.onError&&await r.onError(t,o);return o.reply.code(t.statusCode||500),{error:t.message||"Internal Server Error",stack:"development"===process.env.NODE_ENV?t.stack:void 0}}async function d(t=[],o){for(const e of t)e.onRequest&&await e.onRequest(o)}async function p(t=[],o,e){for(const r of t)r.onResponse&&await r.onResponse(o,e)}const h=[];function m(t){return t.endsWith(".ts")||t.endsWith(".js")||t.endsWith(".mjs")||t.endsWith(".cjs")}async function y(r,n,s){const a=t.readdirSync(n,{withFileTypes:!0});for(const t of a){const a=o.join(n,t.name);if(t.isDirectory()){await y(r,a,s);continue}if(!m(t.name))continue;const l=(await import(e(a).href+"?v="+Date.now())).default;l?.__isRoute&&(h.push({method:l.method.toUpperCase(),path:l.path,file:a}),r.route({method:l.method.toUpperCase(),url:l.path,handler:async(t,o)=>{const e=i(t,o);try{await d(s.plugins,e),await c(s.globalMiddlewares,e),await c(l.middlewares,e);const t=await l.handler(e,r);return await p(s.plugins,e,t),u(o,t)}catch(t){return f(t,e,s.plugins)}}}))}}async function l(e={}){const a=s({logger:e.logger??!0});await a.register(r),await async function(t=[],o){for(const e of t)e.onInit&&await e.onInit(o)}(e.plugins,a);const i=(c=e.routesDir,o.resolve(process.cwd(),c||process.env.ROUTES_DIR||"src/routes"));var c;if(!t.existsSync(i))throw Error("Routes directory not found: "+i);return function(t){t.get("/__routes",async()=>({routes:h})),t.get("/__health",async()=>({ok:!0,ts:Date.now()}))}(a),await y(a,i,e),!1!==e.hmr&&function(t){n.watch(t,{ignoreInitial:!0}).on("change",t=>{process.exit(0)})}(i),a}async function w(t={}){const o=await l(t),e=function(t){return Number(t||process.env.PORT||3e3)}(t.port),r=function(t){return t||process.env.HOST||"0.0.0.0"}(t.host);return await o.listen({port:e,host:r}),o}export{w as bootstrap,l as createDevApp};

package/build/esm/server/index.js

@@ -0,0 +1 @@
+import o from"@fastify/cookie";import t from"fastify";import e from"node:crypto";const n=new WeakMap;function r(o,t){return{headers:o.headers,body:o.body,queryStringParameters:o.query,pathParameters:o.params,cookies:o.cookies||{},rawPath:o.url,method:o.method,requestId:e.randomUUID(),request:o,reply:t}}async function a(o=[],t){for(const e of o)await e(t)}async function s(o,t){const e=t.statusCode||200;if(o.code(e),t.headers)for(const[e,n]of Object.entries(t.headers))o.header(e,n);return t.body}async function i(o,t,e=[]){for(const n of e)n.onError&&await n.onError(o,t);return t.reply.code(o.statusCode||500),{error:o.message||"Internal Server Error",stack:"development"===process.env.NODE_ENV?o.stack:void 0}}async function c(o){const t=n.get(o);if(t)return t;const e=(await o()).default;if(!e?.__isRoute)throw Error("Invalid route module");return n.set(o,e),e}async function u(o=[],t){for(const e of o)e.onRequest&&await e.onRequest(t)}async function f(o=[],t,e){for(const n of o)n.onResponse&&await n.onResponse(t,e)}async function d(e){const n=t({logger:e.logger??!0});await n.register(o),await async function(o=[],t){for(const e of o)e.onInit&&await e.onInit(t)}(e.plugins,n);for(const o of e.routes){const t=await c(o);n.log.info(`⚡ ${t.method} ${t.path}`),n.route({method:t.method,url:t.path,handler:async(o,c)=>{const d=r(o,c);try{await u(e.plugins,d),await a(e.globalMiddlewares,d),await a(t.middlewares,d);const o=await t.handler(d,n);return await f(e.plugins,d,o),s(c,o)}catch(o){return i(o,d,e.plugins)}}})}return n}async function l(o){const t=await d(o),e=Number(o.port||process.env.PORT||3e3),n=o.host||process.env.HOST||"0.0.0.0";return await t.listen({port:e,host:n}),t.log.info(""),t.log.info("🚀 LambdaPipe Runtime"),t.log.info(`🌐 http://${n}:${e}`),t.log.info("📦 routes: "+o.routes.length),t.log.info(""),t}export{l as bootstrap,d as createRuntimeApp};

package/docs/prod-server.md

@@ -0,0 +1,397 @@
+# Production Runtime production.ts
+
+Production-ready Fastify runtime for LambdaPipe.
+
+Designed for:
+
+* bundled deployments
+* lazy-loaded route manifests
+* serverless adapters
+* container deployments
+* runtime middleware pipelines
+* runtime plugin lifecycle hooks
+
+Unlike the dev runtime, production mode does not scan the filesystem dynamically.
+
+Routes are registered through a static manifest for deterministic builds and deployment-safe startup.
+
+---
+
+# Features
+
+* Fastify production runtime
+* Static route manifest system
+* Lazy-loaded route modules
+* Runtime middleware lifecycle
+* Runtime plugin hooks
+* Shared execution context
+* Cookie support
+* Response serialization
+* Route module cache
+* Error handling pipeline
+* Deployment-safe routing
+* Tree-shake friendly architecture
+
+---
+
+# Installation
+
+```bash
+npm install fastify @fastify/cookie
+```
+
+---
+
+# Quick Start
+
+```ts
+import { bootstrap } from 'lambda-pipe/server'
+
+import routes from './routes.manifest'
+
+await bootstrap({
+  port: 3000,
+
+  routes,
+})
+```
+
+---
+
+# Route Manifest
+
+```ts
+// routes.manifest.ts
+
+import type {
+  RouteLoader,
+} from 'lambda-pipe/server'
+
+const routes: RouteLoader[] = [
+  () => import('./routes/health'),
+
+  () => import('./routes/user'),
+]
+
+export default routes
+```
+
+---
+
+# Why Manifest Loaders
+
+Each manifest item is only responsible for lazy-importing a route module.
+
+Route metadata is defined directly inside `defineRoute()`.
+
+This avoids:
+
+* duplicated route metadata
+* route mismatch bugs
+* startup filesystem scanning
+* runtime path resolution issues
+
+---
+
+# Project Structure
+
+```bash
+src/
+  routes/
+    health.ts
+    user.ts
+
+  routes.manifest.ts
+```
+
+---
+
+# Health Route
+
+```ts
+import {
+  defineRoute,
+  ok,
+} from 'lambda-pipe'
+
+export default defineRoute({
+  method: 'GET',
+
+  path: '/health',
+
+  handler: async () => {
+    return ok({
+      status: 'ok',
+
+      uptime: process.uptime(),
+    })
+  },
+})
+```
+
+---
+
+# Full Runtime Route Example
+
+```ts
+import {
+  defineRoute,
+  ok,
+  HttpError,
+} from 'lambda-pipe'
+
+export default defineRoute({
+  method: 'GET',
+
+  path: '/user/:id',
+
+  middlewares: [
+    async (context) => {
+      if (!context.headers.authorization) {
+        throw new HttpError(
+          401,
+          'Unauthorized',
+        )
+      }
+    },
+  ],
+
+  handler: async (context) => {
+    const userId =
+      context.pathParameters.id
+
+    return ok({
+      id: userId,
+
+      source: 'runtime',
+
+      requestId:
+        context.requestId,
+    })
+  },
+})
+```
+
+---
+
+# Runtime Plugins
+
+```ts
+import type {
+  RuntimePlugin,
+} from 'lambda-pipe/server'
+
+export const loggerPlugin: RuntimePlugin = {
+  name: 'logger',
+
+  onInit: async (app) => {
+    app.log.info(
+      'logger initialized',
+    )
+  },
+
+  onRequest: async (context) => {
+    context.request.log.info({
+      method: context.method,
+
+      path: context.rawPath,
+    })
+  },
+
+  onResponse: async (
+    context,
+    response,
+  ) => {
+    context.request.log.info({
+      statusCode:
+        response.statusCode,
+    })
+  },
+
+  onError: async (
+    error,
+    context,
+  ) => {
+    context.request.log.error(
+      error,
+    )
+  },
+}
+```
+
+---
+
+# Using Plugins
+
+```ts
+import { bootstrap } from 'lambda-pipe/server'
+
+import routes from './routes.manifest'
+
+import { loggerPlugin } from './plugins/logger'
+
+await bootstrap({
+  routes,
+
+  plugins: [loggerPlugin],
+})
+```
+
+---
+
+# Global Middleware
+
+```ts
+await bootstrap({
+  port: 3000,
+
+  routes,
+
+  logger: true,
+
+  globalMiddlewares: [
+    async (context) => {
+      context.request.log.info({
+        path: context.rawPath,
+      })
+    },
+  ],
+})
+```
+
+---
+
+# Runtime Lifecycle
+
+```text
+HTTP Request
+  ↓
+Fastify Runtime
+  ↓
+Route Manifest Match
+  ↓
+Lazy Route Import
+  ↓
+Create Runtime Context
+  ↓
+Plugin onRequest Hooks
+  ↓
+Global Middlewares
+  ↓
+Route Middlewares
+  ↓
+Route Handler
+  ↓
+Plugin onResponse Hooks
+  ↓
+Serialize Response
+  ↓
+HTTP Response
+```
+
+---
+
+# Error Lifecycle
+
+```text
+Handler Error
+  ↓
+Plugin onError Hooks
+  ↓
+Runtime Error Handler
+  ↓
+Serialized Error Response
+```
+
+---
+
+# Response Shape
+
+```ts
+return {
+  statusCode: 200,
+
+  headers: {
+    'x-runtime': 'lambda-pipe',
+  },
+
+  body: {
+    ok: true,
+  },
+}
+```
+
+---
+
+# Module Cache
+
+Production runtime caches loaded route modules internally using a WeakMap-based loader cache.
+
+Benefits:
+
+* avoids duplicate imports
+* keeps lazy-loading efficient
+* reduces runtime overhead
+* keeps route identity stable
+
+---
+
+# Deployment Targets
+
+Production runtime works well with:
+
+* AWS Lambda
+* ECS / Fargate
+* Docker containers
+* Bun runtime
+* Node.js servers
+* Edge-compatible adapters
+* Kubernetes
+* Railway / Render / Fly.io
+
+---
+
+# Why Production Runtime Avoids FS Scanning
+
+Filesystem scanning is avoided in production because:
+
+* faster startup
+* deployment-safe bundling
+* smaller runtime surface
+* deterministic route registration
+* serverless compatibility
+* better tree-shaking support
+* fewer runtime filesystem assumptions
+
+---
+
+# Example Production Bootstrap
+
+```ts
+import { bootstrap } from 'lambda-pipe/server'
+
+import routes from './routes.manifest'
+
+await bootstrap({
+  port: 8080,
+
+  host: '0.0.0.0',
+
+  routes,
+
+  logger: true,
+})
+```
+
+---
+
+# Example Startup Logs
+
+```text
+⚡ GET /health
+⚡ GET /user/:id
+
+🚀 LambdaPipe Runtime
+🌐 http://0.0.0.0:3000
+📦 routes: 2
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lambda-pipe",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Type-safe plugin & middleware runtime for AWS Lambda and serverless APIs.",
   "license": "MIT",
   "author": "Delpi.Kye",
@@ -38,6 +38,11 @@
       "types": "./build/cli/dev.d.ts",
       "import": "./build/esm/cli/index.js",
       "require": "./build/cjs/cli/index.js"
+    },
+    "./server": {
+      "types": "./build/cli/server.d.ts",
+      "import": "./build/esm/server/index.js",
+      "require": "./build/cjs/server/index.js"
     }
   },
   "files": [
@@ -47,6 +52,7 @@
   "scripts": {
     "clean": "rimraf build",
     "dev": "nodemon --watch src --ext ts --exec tsx src/cli/dev.ts",
+    "prod": "nodemon --watch src --ext ts --exec tsx src/cli/server.ts",
     "build": "rollup -c",
     "cb": "npm run clean && npm run build",
     "lint": "eslint \"src/**/*.{ts,tsx}\"",