actor-ts 0.9.0

package/dist/http/backend/FastifyBackend.d.ts

@@ -0,0 +1,31 @@
+import Fastify from 'fastify';
+import { type HttpRequest, type HttpResponse } from '../types.js';
+import type { HttpServerBackend, RouteRegistration, ServerBinding } from './HttpServerBackend.js';
+type FastifyLike = ReturnType<typeof Fastify>;
+/**
+ * Fastify-based default HTTP backend.  Leans on Fastify for fast routing,
+ * body parsing (including raw-body support), and its plugin ecosystem.
+ * The directives DSL compiles down to plain Fastify route registrations —
+ * user code never interacts with Fastify types unless they explicitly opt
+ * in via `backend.withPlugin(...)`.
+ */
+export declare class FastifyBackend implements HttpServerBackend {
+    readonly name = "fastify";
+    private readonly app;
+    private readonly registered;
+    constructor(opts?: object);
+    /** Escape hatch: register a native Fastify plugin (e.g. @fastify/cors). */
+    withPlugin(plugin: unknown, options?: object): Promise<void>;
+    registerRoute(route: RouteRegistration): void;
+    setNotFound(handler: (req: HttpRequest) => Promise<HttpResponse> | HttpResponse): void;
+    setErrorHandler(handler: (err: unknown, req: HttpRequest) => Promise<HttpResponse> | HttpResponse): void;
+    listen(host: string, port: number): Promise<ServerBinding>;
+    /** @internal — used by tests that inspect Fastify state. */
+    get fastify(): FastifyLike;
+    private adaptRequest;
+    private asBytes;
+    private writeResponse;
+    private writeError;
+}
+export {};
+//# sourceMappingURL=FastifyBackend.d.ts.map

package/dist/http/backend/FastifyBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FastifyBackend.d.ts","sourceRoot":"","sources":["../../../src/http/backend/FastifyBackend.ts"],"names":[],"mappings":"AAAA,OAAO,OAAmD,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAa,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACd,MAAM,wBAAwB,CAAC;AAIhC,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;AAE9C;;;;;;GAMG;AACH,qBAAa,cAAe,YAAW,iBAAiB;IACtD,QAAQ,CAAC,IAAI,aAAa;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2B;gBAE1C,IAAI,GAAE,MAA0B;IAa5C,2EAA2E;IACrE,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlE,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAiB7C,WAAW,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,GAAG,IAAI;IAQtF,eAAe,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,GAAG,IAAI;IAQlG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAyDhE,4DAA4D;IAC5D,IAAI,OAAO,IAAI,WAAW,CAAqB;IAI/C,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,aAAa;IAuBrB,OAAO,CAAC,UAAU;CAOnB"}

package/dist/http/backend/FastifyBackend.js

@@ -0,0 +1,193 @@
+import Fastify from 'fastify';
+import { HttpError } from '../types.js';
+/**
+ * Fastify-based default HTTP backend.  Leans on Fastify for fast routing,
+ * body parsing (including raw-body support), and its plugin ecosystem.
+ * The directives DSL compiles down to plain Fastify route registrations —
+ * user code never interacts with Fastify types unless they explicitly opt
+ * in via `backend.withPlugin(...)`.
+ */
+export class FastifyBackend {
+    name = 'fastify';
+    app;
+    registered = [];
+    constructor(opts = { logger: false }) {
+        this.app = Fastify(opts);
+        // Route EVERY content-type through a raw-buffer parser — we want the
+        // bytes to reach the DSL unparsed so user code picks the decoder via
+        // pickRequestSerializer.  Fastify's built-in JSON parser would steal
+        // `application/json` bodies otherwise.
+        const rawParser = (_req, body, done) => done(null, body);
+        this.app.removeContentTypeParser(['application/json', 'text/plain']);
+        this.app.addContentTypeParser('*', { parseAs: 'buffer' }, rawParser);
+        this.app.addContentTypeParser('application/json', { parseAs: 'buffer' }, rawParser);
+        this.app.addContentTypeParser('application/cbor', { parseAs: 'buffer' }, rawParser);
+    }
+    /** Escape hatch: register a native Fastify plugin (e.g. @fastify/cors). */
+    async withPlugin(plugin, options) {
+        await this.app.register(plugin, options);
+    }
+    registerRoute(route) {
+        this.registered.push(route);
+        this.app.route({
+            method: route.method,
+            url: route.pattern,
+            handler: async (req, reply) => {
+                const adapted = this.adaptRequest(req);
+                try {
+                    const out = await route.handler(adapted);
+                    this.writeResponse(reply, out);
+                }
+                catch (err) {
+                    this.writeError(reply, err);
+                }
+            },
+        });
+    }
+    setNotFound(handler) {
+        this.app.setNotFoundHandler(async (req, reply) => {
+            const adapted = this.adaptRequest(req);
+            const res = await handler(adapted);
+            this.writeResponse(reply, res);
+        });
+    }
+    setErrorHandler(handler) {
+        this.app.setErrorHandler(async (err, req, reply) => {
+            const adapted = this.adaptRequest(req);
+            const res = await handler(err, adapted);
+            this.writeResponse(reply, res);
+        });
+    }
+    async listen(host, port) {
+        const address = await this.app.listen({ host, port });
+        // Fastify returns "http://<host>:<port>".
+        const match = /:(\d+)$/.exec(address);
+        const actualPort = match ? parseInt(match[1], 10) : port;
+        return {
+            host,
+            port: actualPort,
+            unbind: async (gracePeriodMs) => {
+                // `app.close()` waits for every in-flight request — and every
+                // long-lived WebSocket connection — to drain.  Long-lived
+                // sockets never drain on their own, so a server with even one
+                // active WS client would hang `close()` forever (process
+                // refuses to exit on Ctrl+C).  We give in-flight work a
+                // bounded grace window, then force-close anything still
+                // hanging on:
+                //
+                //   1. `server.closeAllConnections()` kills regular HTTP
+                //      sockets (Node 18.2+ / Bun).  It does NOT touch
+                //      sockets already upgraded to WebSocket — Node
+                //      releases ownership of those at upgrade time.
+                //   2. For WebSockets we walk `fastify.websocketServer.clients`
+                //      (populated by `@fastify/websocket`) and `terminate()`
+                //      each one.  `terminate()` destroys the underlying TCP
+                //      socket without sending a close frame — appropriate
+                //      for shutdown where we're going down anyway.
+                //
+                // Both probes are best-effort: if no WS plugin is registered
+                // `websocketServer` is undefined, and on Bun
+                // `closeAllConnections` may also be unavailable.  After
+                // forcing, `app.close()` resolves quickly and we return.
+                const grace = gracePeriodMs && gracePeriodMs > 0 ? gracePeriodMs : 0;
+                const server = this.app.server;
+                const wss = this.app.websocketServer;
+                const closing = this.app.close();
+                if (grace > 0) {
+                    let timer = null;
+                    await Promise.race([
+                        closing,
+                        new Promise((resolve) => {
+                            timer = setTimeout(resolve, grace);
+                            timer.unref?.();
+                        }),
+                    ]);
+                    if (timer)
+                        clearTimeout(timer);
+                }
+                try {
+                    server?.closeAllConnections?.();
+                }
+                catch { /* best-effort */ }
+                if (wss?.clients) {
+                    for (const client of wss.clients) {
+                        try {
+                            client.terminate?.();
+                        }
+                        catch { /* best-effort */ }
+                    }
+                }
+                await closing;
+            },
+        };
+    }
+    /** @internal — used by tests that inspect Fastify state. */
+    get fastify() { return this.app; }
+    /* -------------------------------- Helpers ------------------------------- */
+    adaptRequest(req) {
+        const headers = {};
+        for (const [k, v] of Object.entries(req.headers)) {
+            if (typeof v === 'string')
+                headers[k] = v;
+            else if (Array.isArray(v))
+                headers[k] = v.join(',');
+        }
+        const body = this.asBytes(req.body);
+        return {
+            method: req.method,
+            path: req.url,
+            headers,
+            query: req.query ?? {},
+            params: req.params ?? {},
+            body,
+        };
+    }
+    asBytes(raw) {
+        if (raw === null || raw === undefined)
+            return null;
+        if (raw instanceof Uint8Array)
+            return raw;
+        if (typeof raw === 'string')
+            return new TextEncoder().encode(raw);
+        if (typeof Buffer !== 'undefined' && raw instanceof Buffer) {
+            return new Uint8Array(raw.buffer, raw.byteOffset, raw.byteLength);
+        }
+        return null;
+    }
+    writeResponse(reply, res) {
+        reply.status(res.status);
+        if (res.headers)
+            for (const [k, v] of Object.entries(res.headers))
+                reply.header(k, v);
+        if (res.contentType)
+            reply.header('content-type', res.contentType);
+        if (res.body === undefined || res.body === null) {
+            reply.send();
+            return;
+        }
+        if (typeof res.body === 'string') {
+            if (!res.contentType && !res.headers?.['content-type'])
+                reply.header('content-type', 'text/plain; charset=utf-8');
+            reply.send(res.body);
+            return;
+        }
+        if (res.body instanceof Uint8Array) {
+            if (!res.contentType)
+                reply.header('content-type', 'application/octet-stream');
+            reply.send(Buffer.from(res.body));
+            return;
+        }
+        // Plain object → JSON.
+        if (!res.contentType)
+            reply.header('content-type', 'application/json; charset=utf-8');
+        reply.send(JSON.stringify(res.body));
+    }
+    writeError(reply, err) {
+        if (err instanceof HttpError) {
+            reply.status(err.status).send({ error: err.message, ...err.extra });
+            return;
+        }
+        reply.status(500).send({ error: 'Internal Server Error', message: err?.message });
+    }
+}
+//# sourceMappingURL=FastifyBackend.js.map

package/dist/http/backend/FastifyBackend.js.map

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

package/dist/http/backend/HonoBackend.d.ts

@@ -0,0 +1,72 @@
+import { type HttpRequest, type HttpResponse } from '../types.js';
+import type { HttpServerBackend, RouteRegistration, ServerBinding } from './HttpServerBackend.js';
+interface HonoContextLike {
+    readonly req: {
+        method: string;
+        path: string;
+        url: string;
+        param(name?: string): Record<string, string> | string | undefined;
+        queries(name?: string): Record<string, string[]> | string[] | undefined;
+        header(name?: string): Record<string, string> | string | undefined;
+        arrayBuffer(): Promise<ArrayBuffer>;
+    };
+}
+type HonoHandler = (c: HonoContextLike) => Promise<Response> | Response;
+type HonoErrorHandler = (err: unknown, c: HonoContextLike) => Promise<Response> | Response;
+type HonoNotFoundHandler = (c: HonoContextLike) => Promise<Response> | Response;
+/** Structural subset of the Hono app we consume. */
+interface HonoAppLike {
+    get(path: string, handler: HonoHandler): unknown;
+    post(path: string, handler: HonoHandler): unknown;
+    put(path: string, handler: HonoHandler): unknown;
+    delete(path: string, handler: HonoHandler): unknown;
+    patch(path: string, handler: HonoHandler): unknown;
+    options(path: string, handler: HonoHandler): unknown;
+    on(method: string, path: string, handler: HonoHandler): unknown;
+    onError(handler: HonoErrorHandler): unknown;
+    notFound(handler: HonoNotFoundHandler): unknown;
+    fetch(request: Request): Promise<Response> | Response;
+}
+export interface HonoBackendOptions {
+    /**
+     * Bring-your-own Hono app — useful if you already registered middleware
+     * (CORS, JWT, logger) before handing it off.  When omitted, we import
+     * `hono` dynamically and build a fresh app on `listen()`.
+     */
+    readonly app?: HonoAppLike;
+    /** Maximum allowed body size in bytes (default: 10 MiB).  Exceeding it returns 413. */
+    readonly maxBodyBytes?: number;
+}
+/**
+ * Hono-backed HTTP backend — a thin adapter that compiles the actor-ts
+ * routing DSL onto a Hono app and serves it with `Bun.serve`.  Hono is a
+ * lightweight router that runs well on Bun and covers the middleware cases
+ * we usually reach for (CORS, auth, logger) without pulling in Express.
+ *
+ * `hono` is an optional peer dependency: install it only if you use this
+ * backend.  Without a user-supplied app, the backend imports `hono`
+ * dynamically on `listen()`.
+ */
+export declare class HonoBackend implements HttpServerBackend {
+    readonly name = "hono";
+    private app;
+    private readonly ownsApp;
+    private readonly maxBodyBytes;
+    private readonly registered;
+    private notFoundHandler;
+    private errorHandler;
+    private server;
+    constructor(options?: HonoBackendOptions);
+    /** Inject / access the underlying Hono app — useful for native middleware. */
+    getApp(): HonoAppLike;
+    registerRoute(route: RouteRegistration): void;
+    setNotFound(handler: (req: HttpRequest) => Promise<HttpResponse> | HttpResponse): void;
+    setErrorHandler(handler: (err: unknown, req: HttpRequest) => Promise<HttpResponse> | HttpResponse): void;
+    listen(host: string, port: number): Promise<ServerBinding>;
+    private attachRoute;
+    private adaptRequest;
+    private writeResponse;
+    private createHonoApp;
+}
+export {};
+//# sourceMappingURL=HonoBackend.d.ts.map

package/dist/http/backend/HonoBackend.d.ts.map

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

package/dist/http/backend/HonoBackend.js

@@ -0,0 +1,212 @@
+import { match } from 'ts-pattern';
+import { getHonoRunner } from '../../runtime/http/index.js';
+import { HttpError } from '../types.js';
+/**
+ * Hono-backed HTTP backend — a thin adapter that compiles the actor-ts
+ * routing DSL onto a Hono app and serves it with `Bun.serve`.  Hono is a
+ * lightweight router that runs well on Bun and covers the middleware cases
+ * we usually reach for (CORS, auth, logger) without pulling in Express.
+ *
+ * `hono` is an optional peer dependency: install it only if you use this
+ * backend.  Without a user-supplied app, the backend imports `hono`
+ * dynamically on `listen()`.
+ */
+export class HonoBackend {
+    name = 'hono';
+    app;
+    ownsApp;
+    maxBodyBytes;
+    registered = [];
+    notFoundHandler = null;
+    errorHandler = null;
+    // Runtime-neutral server handle; the per-runtime adapter supplies a
+    // concrete implementation (Bun.serve / @hono/node-server / Deno.serve).
+    server = null;
+    constructor(options = {}) {
+        this.app = options.app ?? null;
+        this.ownsApp = options.app == null;
+        this.maxBodyBytes = options.maxBodyBytes ?? 10 * 1024 * 1024;
+    }
+    /** Inject / access the underlying Hono app — useful for native middleware. */
+    getApp() {
+        if (!this.app)
+            throw new Error('HonoBackend: app not constructed yet — call listen() first or pass `{ app }` to the constructor.');
+        return this.app;
+    }
+    registerRoute(route) {
+        this.registered.push(route);
+    }
+    setNotFound(handler) {
+        this.notFoundHandler = handler;
+    }
+    setErrorHandler(handler) {
+        this.errorHandler = handler;
+    }
+    async listen(host, port) {
+        if (!this.app)
+            this.app = await this.createHonoApp();
+        const app = this.app;
+        for (const r of this.registered)
+            this.attachRoute(r);
+        if (this.notFoundHandler) {
+            const handler = this.notFoundHandler;
+            app.notFound(async (c) => {
+                const req = await this.adaptRequest(c);
+                const res = await handler(req);
+                return this.writeResponse(res);
+            });
+        }
+        app.onError(async (err, c) => {
+            const req = await this.adaptRequest(c);
+            if (this.errorHandler) {
+                try {
+                    const res = await this.errorHandler(err, req);
+                    return this.writeResponse(res);
+                }
+                catch (inner) {
+                    err = inner;
+                }
+            }
+            if (err instanceof HttpError) {
+                return new Response(JSON.stringify({ error: err.message, ...err.extra }), {
+                    status: err.status,
+                    headers: { 'content-type': 'application/json; charset=utf-8' },
+                });
+            }
+            return new Response(JSON.stringify({ error: 'Internal Server Error', message: err?.message ?? String(err) }), { status: 500, headers: { 'content-type': 'application/json; charset=utf-8' } });
+        });
+        const runner = await getHonoRunner();
+        const server = await runner.serve({
+            host,
+            port,
+            fetch: (request) => app.fetch(request),
+        });
+        this.server = server;
+        return {
+            host: server.host,
+            port: server.port,
+            unbind: async (gracePeriodMs) => {
+                const srv = this.server;
+                if (!srv)
+                    return;
+                this.server = null;
+                if (gracePeriodMs && gracePeriodMs > 0) {
+                    // Race a graceful stop against the grace window — whichever wins
+                    // first resolves.  After the window we force-close regardless.
+                    await Promise.race([
+                        srv.stop(true),
+                        new Promise((resolve) => {
+                            const t = setTimeout(() => resolve(), gracePeriodMs);
+                            t.unref?.();
+                        }),
+                    ]);
+                    await srv.stop(false); // force any still-active connections
+                    return;
+                }
+                await srv.stop(false);
+            },
+        };
+    }
+    /* ============================ internals ============================ */
+    attachRoute(route) {
+        const app = this.app;
+        const handler = async (c) => {
+            const req = await this.adaptRequest(c);
+            if (req.body && req.body.byteLength > this.maxBodyBytes) {
+                return new Response('Payload Too Large', {
+                    status: 413,
+                    headers: { 'content-type': 'text/plain; charset=utf-8' },
+                });
+            }
+            const out = await route.handler(req);
+            return this.writeResponse(out);
+        };
+        const method = route.method.toLowerCase();
+        match(method)
+            .with('get', () => app.get(route.pattern, handler))
+            .with('post', () => app.post(route.pattern, handler))
+            .with('put', () => app.put(route.pattern, handler))
+            .with('delete', () => app.delete(route.pattern, handler))
+            .with('patch', () => app.patch(route.pattern, handler))
+            .with('head', () => app.on('HEAD', route.pattern, handler))
+            .with('options', () => app.options(route.pattern, handler))
+            .exhaustive();
+    }
+    async adaptRequest(c) {
+        const method = c.req.method.toUpperCase();
+        const headers = c.req.header() ?? {};
+        // `c.req.param()` throws inside notFound / onError handlers because no
+        // route matched — swallow that, an empty params object is the right
+        // fallback there.
+        let params = {};
+        try {
+            params = c.req.param() ?? {};
+        }
+        catch { /* no match — leave empty */ }
+        // Hono returns queries as Record<string, string[]>; flatten single values.
+        const rawQueries = c.req.queries() ?? {};
+        const query = {};
+        for (const [k, v] of Object.entries(rawQueries)) {
+            if (!v)
+                continue;
+            query[k] = v.length === 1 ? v[0] : v;
+        }
+        let body = null;
+        if (method !== 'GET' && method !== 'HEAD' && method !== 'OPTIONS') {
+            const buf = await c.req.arrayBuffer();
+            if (buf.byteLength > 0)
+                body = new Uint8Array(buf);
+        }
+        return {
+            method,
+            path: c.req.path ?? new URL(c.req.url).pathname,
+            headers,
+            query,
+            params,
+            body,
+        };
+    }
+    writeResponse(res) {
+        const headers = new Headers();
+        if (res.headers)
+            for (const [k, v] of Object.entries(res.headers))
+                headers.set(k, v);
+        if (res.contentType)
+            headers.set('content-type', res.contentType);
+        const body = res.body;
+        if (body === undefined || body === null)
+            return new Response(null, { status: res.status, headers });
+        if (typeof body === 'string') {
+            if (!headers.has('content-type'))
+                headers.set('content-type', 'text/plain; charset=utf-8');
+            return new Response(body, { status: res.status, headers });
+        }
+        if (body instanceof Uint8Array) {
+            if (!headers.has('content-type'))
+                headers.set('content-type', 'application/octet-stream');
+            // Cast through BodyInit — the standard `Uint8Array<ArrayBufferLike>`
+            // IS a valid Fetch body, but TypeScript 5.7+'s DOM types are not
+            // (yet) parameterised that way, so the direct assignment errors.
+            return new Response(body, { status: res.status, headers });
+        }
+        if (!headers.has('content-type'))
+            headers.set('content-type', 'application/json; charset=utf-8');
+        return new Response(JSON.stringify(body), { status: res.status, headers });
+    }
+    async createHonoApp() {
+        if (!this.ownsApp)
+            throw new Error('HonoBackend: app was not injected but ownsApp=false');
+        try {
+            const moduleName = 'hono';
+            const mod = (await import(moduleName));
+            if (!mod.Hono)
+                throw new Error('"hono" export "Hono" not found');
+            return new mod.Hono();
+        }
+        catch (e) {
+            throw new Error('HonoBackend requires the "hono" package.  Install it with: '
+                + 'bun add hono\nOriginal error: ' + (e instanceof Error ? e.message : String(e)));
+        }
+    }
+}
+//# sourceMappingURL=HonoBackend.js.map

package/dist/http/backend/HonoBackend.js.map

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

package/dist/http/backend/HttpServerBackend.d.ts

@@ -0,0 +1,31 @@
+import type { HttpMethod, HttpRequest, HttpResponse } from '../types.js';
+/** One route registration — supplied by the DSL after compilation. */
+export interface RouteRegistration {
+    readonly method: HttpMethod;
+    /** Path pattern in the Fastify/Express style: `/users/:id` */
+    readonly pattern: string;
+    readonly handler: (req: HttpRequest) => Promise<HttpResponse> | HttpResponse;
+}
+export interface ServerBinding {
+    readonly host: string;
+    readonly port: number;
+    /** Stop the server; waits up to `gracePeriodMs` for in-flight requests. */
+    unbind(gracePeriodMs?: number): Promise<void>;
+}
+/**
+ * Pluggable HTTP server abstraction.  Backends translate our generic
+ * route registrations to their native framework (Fastify, Bun.serve,
+ * Express, …).  The DSL only ever talks to this interface.
+ */
+export interface HttpServerBackend {
+    readonly name: string;
+    /** Register all routes before `listen` is called.  Duplicate paths must be rejected. */
+    registerRoute(route: RouteRegistration): void;
+    /** Start listening.  Returns a ServerBinding with the actual bound port. */
+    listen(host: string, port: number): Promise<ServerBinding>;
+    /** Optionally register a catch-all not-found handler. */
+    setNotFound?(handler: (req: HttpRequest) => Promise<HttpResponse> | HttpResponse): void;
+    /** Optionally register a global error handler. */
+    setErrorHandler?(handler: (err: unknown, req: HttpRequest) => Promise<HttpResponse> | HttpResponse): void;
+}
+//# sourceMappingURL=HttpServerBackend.d.ts.map

package/dist/http/backend/HttpServerBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpServerBackend.d.ts","sourceRoot":"","sources":["../../../src/http/backend/HttpServerBackend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzE,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;CAC9E;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,wFAAwF;IACxF,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAE9C,4EAA4E;IAC5E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE3D,yDAAyD;IACzD,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,GAAG,IAAI,CAAC;IAExF,kDAAkD;IAClD,eAAe,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,GAAG,IAAI,CAAC;CAC3G"}

package/dist/http/backend/HttpServerBackend.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=HttpServerBackend.js.map

package/dist/http/backend/HttpServerBackend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpServerBackend.js","sourceRoot":"","sources":["../../../src/http/backend/HttpServerBackend.ts"],"names":[],"mappings":""}

package/dist/http/cache/IdempotencyKey.d.ts

@@ -0,0 +1,48 @@
+import type { Cache } from '../../cache/Cache.js';
+import { type HttpRequest, type HttpResponse } from '../types.js';
+/**
+ * Idempotency-key middleware.  Implements the Stripe / Adyen pattern:
+ * clients send an `Idempotency-Key` header on retryable requests
+ * (typically POST), and the server records the first response under
+ * that key so subsequent requests with the same key replay the same
+ * outcome.
+ *
+ * Three states for a given key:
+ *   1. **Absent** — handler runs; the (status, headers, body) tuple is
+ *      cached under the key for `ttlMs` (default 24h).
+ *   2. **In-flight** — another worker is currently processing this key.
+ *      We respond `409 Conflict` so the client retries later.
+ *   3. **Completed** — replay the cached response verbatim.
+ *
+ * Storage is JSON-encoded — bodies that are `Uint8Array` are base64'd
+ * so the round-trip preserves bytes.
+ *
+ * Usage:
+ *
+ *   const dedup = idempotent({ cache: ext.cache(), ttlMs: 24 * 60 * 60_000 });
+ *   route(post('/payments', dedup(handler)));
+ */
+export interface IdempotencyOptions {
+    readonly cache: Cache;
+    /** How long to remember responses.  Default: 24 hours. */
+    readonly ttlMs?: number;
+    /**
+     * Header to read the idempotency key from.  Default: `'idempotency-key'`
+     * (the standard).  Header names are matched case-insensitively against
+     * the `req.headers` map (which holds them lower-cased).
+     */
+    readonly headerName?: string;
+    /**
+     * Cache-key namespace.  Default: `'idem:'`.
+     */
+    readonly keyPrefix?: string;
+    /**
+     * What to do when the request lacks the header.  Default: `'reject'`
+     * (respond 400).  Setting `'pass-through'` runs the handler unchanged
+     * — useful when only some clients use idempotency and you don't want
+     * to break the others.
+     */
+    readonly missingHeader?: 'reject' | 'pass-through';
+}
+export declare function idempotent(opts: IdempotencyOptions): (handler: (req: HttpRequest) => Promise<HttpResponse> | HttpResponse) => (req: HttpRequest) => Promise<HttpResponse>;
+//# sourceMappingURL=IdempotencyKey.d.ts.map

package/dist/http/cache/IdempotencyKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IdempotencyKey.d.ts","sourceRoot":"","sources":["../../../src/http/cache/IdempotencyKey.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAU,MAAM,aAAa,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,GAAG,cAAc,CAAC;CACpD;AAuBD,wBAAgB,UAAU,CAAC,IAAI,EAAE,kBAAkB,IAS5B,SAAS,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,MACxD,KAAK,WAAW,KAAG,OAAO,CAAC,YAAY,CAAC,CA2DzE"}