@databehave/server 0.1.4 → 0.3.0

package/dist/plugins/cors.js

@@ -0,0 +1,35 @@
+import { buildCorsResponseHeaders, buildPreflightResponse, mergeVary } from '../cors.js';
+import { httpCapability } from '../http.js';
+/** Apply application CORS only to resolved routes, honoring each route owner's policy. */
+export const corsPlugin = (options = {}) => ({
+    id: 'databehave.http.cors', apiVersion: 1, requires: [httpCapability],
+    setup(ctx) {
+        const http = ctx.use(httpCapability);
+        const policy = (request) => {
+            const method = request.method === 'options'
+                ? request.headers['access-control-request-method'] ?? 'options'
+                : request.method;
+            const route = http.resolveRoute(method, request.path);
+            return route ? route.cors ?? options : false;
+        };
+        http.registerMiddleware({ owner: 'databehave.http.cors', order: ctx.order, stage: 'preflight', handle: (request) => {
+                const selected = policy(request);
+                if (request.method === 'options' && selected !== false)
+                    return buildPreflightResponse(selected, request);
+            } });
+        http.registerMiddleware({ owner: 'databehave.http.cors', order: ctx.order, stage: 'decoration', handle: (request, response) => {
+                const selected = policy(request);
+                if (selected === false)
+                    return;
+                const headers = new Headers(response.headers);
+                for (const [name, value] of Object.entries(buildCorsResponseHeaders(selected, request))) {
+                    if (name === 'vary')
+                        headers.set(name, mergeVary(headers.get(name) ?? undefined, value));
+                    else if (!headers.has(name))
+                        headers.set(name, value);
+                }
+                return { ...response, headers: Object.fromEntries(headers.entries()) };
+            } });
+    },
+});
+//# sourceMappingURL=cors.js.map

package/dist/plugins/cors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cors.js","sourceRoot":"","sources":["../../src/plugins/cors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAG3C,0FAA0F;AAC1F,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,UAAsB,EAAE,EAAU,EAAE,CAAC,CAAC;IAC/D,EAAE,EAAE,sBAAsB,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,cAAc,CAAC;IACrE,KAAK,CAAC,GAAG;QACP,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;QACpC,MAAM,MAAM,GAAG,CAAC,OAAoB,EAAsB,EAAE;YAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,SAAS;gBACzC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,+BAA+B,CAAC,IAAI,SAAS;gBAC/D,CAAC,CAAC,OAAO,CAAC,MAAM,CAAA;YAClB,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;YACrD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,CAAA;QAC9C,CAAC,CAAA;QACD,IAAI,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE;gBACjH,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;gBAChC,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,QAAQ,KAAK,KAAK;oBAAE,OAAO,sBAAsB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;YAC1G,CAAC,EAAE,CAAC,CAAA;QACJ,IAAI,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;gBAC5H,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;gBAChC,IAAI,QAAQ,KAAK,KAAK;oBAAE,OAAM;gBAC9B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;gBAC7C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,wBAAwB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;oBACxF,IAAI,IAAI,KAAK,MAAM;wBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,KAAK,CAAC,CAAC,CAAA;yBACnF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;wBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;gBACvD,CAAC;gBACD,OAAO,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,EAAE,CAAA;YACxE,CAAC,EAAE,CAAC,CAAA;IACN,CAAC;CACF,CAAC,CAAA"}

package/dist/plugins/routes.d.ts

@@ -0,0 +1,5 @@
+import type { Plugin } from '@databehave/core';
+import type { Handler, RouteKey } from '../types.js';
+/** Register explicit handlers through the same contribution contract as external plugins. */
+export declare const routesPlugin: (routes: Readonly<Partial<Record<RouteKey, Handler>>>, id?: string) => Plugin;
+//# sourceMappingURL=routes.d.ts.map

package/dist/plugins/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/plugins/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAE9C,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAEpD,6FAA6F;AAC7F,eAAO,MAAM,YAAY,GAAI,QAAQ,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,WAA6B,KAAG,MAMjH,CAAA"}

package/dist/plugins/routes.js

@@ -0,0 +1,10 @@
+import { httpCapability } from '../http.js';
+/** Register explicit handlers through the same contribution contract as external plugins. */
+export const routesPlugin = (routes, id = 'databehave.http.routes') => ({
+    id, apiVersion: 1, requires: [httpCapability],
+    setup(ctx) {
+        const entries = Object.entries(routes);
+        ctx.use(httpCapability).registerRoutes({ owner: id, order: ctx.order, materialize: () => entries.flatMap(([key, handler]) => handler ? [{ key: key, handler, priority: 'explicit' }] : []) });
+    },
+});
+//# sourceMappingURL=routes.js.map

package/dist/plugins/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/plugins/routes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAG3C,6FAA6F;AAC7F,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAoD,EAAE,EAAE,GAAG,wBAAwB,EAAU,EAAE,CAAC,CAAC;IAC5H,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,cAAc,CAAC;IAC7C,KAAK,CAAC,GAAG;QACP,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QACtC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAe,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAmB,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IACpN,CAAC;CACF,CAAC,CAAA"}

package/dist/request.d.ts

@@ -1,4 +1,4 @@
-import type { MockRequest } from './types.js';
+import type { ObservedMethod, MockRequest } from './types.js';
 /**
  * Build a `MockRequest` from a web standard `Request`.
  *
@@ -15,5 +15,5 @@ import type { MockRequest } from './types.js';
  * directly and then calling `json()` / `text()` will throw, matching
  * the web standard.
  */
-export declare const buildRequest: (req: globalThis.Request, params?: Readonly<Record<string, string>>) => MockRequest;
+export declare const buildRequest: (req: globalThis.Request, params?: Readonly<Record<string, string>>, effectiveMethod?: ObservedMethod) => MockRequest;
 //# sourceMappingURL=request.d.ts.map

package/dist/request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,YAAY,CAAA;AAa7D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,YAAY,GACvB,KAAK,UAAU,CAAC,OAAO,EACvB,SAAQ,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,KAC5C,WAuCF,CAAA"}
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAa7D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,YAAY,GACvB,KAAK,UAAU,CAAC,OAAO,EACvB,SAAQ,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,EAC7C,kBAAkB,cAAc,KAC/B,WAyCF,CAAA"}

package/dist/request.js

@@ -24,21 +24,21 @@ const bodyCache = new WeakMap();
  * directly and then calling `json()` / `text()` will throw, matching
  * the web standard.
  */
-export const buildRequest = (req, params = {}) => {
+export const buildRequest = (req, params = {}, effectiveMethod) => {
     const url = new URL(req.url);
     const method = req.method.toLowerCase();
-    const queryAll = {};
+    const queryAll = Object.create(null);
     for (const [k, v] of url.searchParams.entries()) {
         ;
         (queryAll[k] ??= []).push(v);
     }
-    const query = {};
+    const query = Object.create(null);
     for (const [k, vs] of Object.entries(queryAll)) {
         const last = vs[vs.length - 1];
         if (last !== undefined)
             query[k] = last;
     }
-    const headers = {};
+    const headers = Object.create(null);
     req.headers.forEach((value, key) => {
         headers[key.toLowerCase()] = value;
     });
@@ -52,6 +52,8 @@ export const buildRequest = (req, params = {}) => {
     };
     return {
         method,
+        effectiveMethod: effectiveMethod ?? method,
+        signal: req.signal,
         url: req.url,
         path: url.pathname,
         query,

package/dist/request.js.map

@@ -1 +1 @@
-{"version":3,"file":"request.js","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,SAAS,GAAG,IAAI,OAAO,EAAuC,CAAA;AAEpE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,GAAuB,EACvB,SAA2C,EAAE,EAChC,EAAE;IACf,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC5B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,EAAoB,CAAA;IAEzD,MAAM,QAAQ,GAA6B,EAAE,CAAA;IAC7C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC;QAChD,CAAC;QAAA,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC/B,CAAC;IACD,MAAM,KAAK,GAA2B,EAAE,CAAA;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,EAAE,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QAC9B,IAAI,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IACzC,CAAC;IAED,MAAM,OAAO,GAA2B,EAAE,CAAA;IAC1C,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACjC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,MAAM,IAAI,GAAG,GAAoB,EAAE;QACjC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACjC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAA;QACzB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAA;QAChC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACzB,OAAO,KAAK,CAAA;IACd,CAAC,CAAA;IAED,OAAO;QACL,MAAM;QACN,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,IAAI,EAAE,GAAG,CAAC,QAAQ;QAClB,KAAK;QACL,QAAQ;QACR,MAAM;QACN,OAAO;QACP,IAAI,EAAE,GAAgB,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAM,CAAC;QAC/D,IAAI;QACJ,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG;KACf,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,SAAS,GAAG,IAAI,OAAO,EAAuC,CAAA;AAEpE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,GAAuB,EACvB,SAA2C,EAAE,EAC7C,eAAgC,EACnB,EAAE;IACf,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC5B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,EAAoB,CAAA;IAEzD,MAAM,QAAQ,GAA6B,MAAM,CAAC,MAAM,CAAC,IAAI,CAA6B,CAAA;IAC1F,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC;QAChD,CAAC;QAAA,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC/B,CAAC;IACD,MAAM,KAAK,GAA2B,MAAM,CAAC,MAAM,CAAC,IAAI,CAA2B,CAAA;IACnF,KAAK,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,EAAE,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QAC9B,IAAI,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IACzC,CAAC;IAED,MAAM,OAAO,GAA2B,MAAM,CAAC,MAAM,CAAC,IAAI,CAA2B,CAAA;IACrF,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACjC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,MAAM,IAAI,GAAG,GAAoB,EAAE;QACjC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACjC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAA;QACzB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAA;QAChC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACzB,OAAO,KAAK,CAAA;IACd,CAAC,CAAA;IAED,OAAO;QACL,MAAM;QACN,eAAe,EAAE,eAAe,IAAI,MAAM;QAC1C,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,IAAI,EAAE,GAAG,CAAC,QAAQ;QAClB,KAAK;QACL,QAAQ;QACR,MAAM;QACN,OAAO;QACP,IAAI,EAAE,GAAgB,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAM,CAAC;QAC/D,IAAI;QACJ,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG;KACf,CAAA;AACH,CAAC,CAAA"}

package/dist/route-key.d.ts

@@ -1,4 +1,5 @@
 import type { Method, RouteKey } from './types.js';
+/** Parsed method and absolute path. */
 export interface ParsedRouteKey {
     readonly method: Method;
     readonly path: string;
@@ -16,6 +17,7 @@ export type PatternSegment = {
     readonly kind: 'param';
     readonly name: string;
 };
+/** Compiled path segments used by the route matcher. */
 export interface RoutePattern {
     /** Original path string as declared (post-trim). */
     readonly path: string;

package/dist/route-key.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route-key.d.ts","sourceRoot":"","sources":["../src/route-key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAUlD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAErD,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAA;IAC5C,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAC3B;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,QAAQ,KAAG,cA6B7C,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,YAwBhD,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GACvB,SAAS,YAAY,EACrB,aAAa,MAAM,KAClB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAmB3B,CAAA"}
+{"version":3,"file":"route-key.d.ts","sourceRoot":"","sources":["../src/route-key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAYlD,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAErD,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAA;IAC5C,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAC3B;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,QAAQ,KAAG,cA6B7C,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,KAAG,YAwBhD,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GACvB,SAAS,YAAY,EACrB,aAAa,MAAM,KAClB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAoB3B,CAAA"}

package/dist/route-key.js

@@ -4,6 +4,8 @@ const SUPPORTED_METHODS = new Set([
     'put',
     'delete',
     'patch',
+    'head',
+    'options',
 ]);
 /**
  * Parse a `'METHOD /path'` key.
@@ -82,10 +84,12 @@ export const matchPattern = (pattern, requestPath) => {
     const reqSegments = requestPath.slice(1).split('/');
     if (reqSegments.length !== pattern.segments.length)
         return null;
-    const params = {};
+    const params = Object.create(null);
     for (let i = 0; i < pattern.segments.length; i++) {
         const seg = pattern.segments[i];
         const part = reqSegments[i];
+        if (seg === undefined || part === undefined)
+            return null;
         if (seg.kind === 'static') {
             if (seg.value !== part)
                 return null;

package/dist/route-key.js.map

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

package/dist/server.d.ts

@@ -1,60 +1,8 @@
-import { type AdminModeConfig } from './admin/admin-types.js';
-import type { Config, MockRequest, MockResponse, Server } from './types.js';
-/**
- * Resolve admin config defaults + validate inputs that don't
- * depend on listen() host. Returns `null` when admin is absent or
- * `enabled !== true`. Pure — no side effects.
- */
-export declare const resolveAdminMode: (cfg: AdminModeConfig | undefined) => {
-    path: string;
-    ui: boolean;
-    headers: boolean;
-    bind: "loopback-only" | "any";
-    cors: NonNullable<AdminModeConfig["cors"]>;
-    allowDestroy: boolean;
-    openapiBody: string | undefined;
-    scenariosDir: string;
-} | null;
-/**
- * Compose two onRequest hooks (user-first per spec H13): if the user
- * hook returned a response, skip the admin inject hook; else call
- * inject. Exported for unit testability.
- */
-export declare const composeAdminOnRequest: (userHook: ((req: MockRequest) => MockResponse | void | Promise<MockResponse | void>) | undefined, adminHook: (req: MockRequest) => Promise<MockResponse | void>) => ((req: MockRequest) => Promise<MockResponse | void>);
-/**
- * Build a @databehave/server server.
- *
- * Construction validates every route key and pre-computes a dispatch
- * index (static lookups are O(1), `:param` patterns are linear). The
- * returned object exposes:
- *
- * - `fetch(Request)` for in-process testing — no socket is opened.
- * - `listen({port, host})` to bind a Node HTTP server. Port `0`
- *   asks the OS for a free port; the resolved port/host come back in
- *   the handle.
- *
- * Request flow per call:
- *   1. CORS preflight (OPTIONS) → short-circuit when `cors` is set
- *   2. `hooks.onRequest` → may short-circuit
- *   3. Route dispatch → handler / OAS walker / 404
- *   4. `hooks.onResponse` → may replace the result
- *   5. CORS response headers merged on top (don't override the user)
- *   6. Handler errors funnel through `hooks.onError` or fall back
- *      to a 500 JSON envelope.
- */
-/**
- * Route a runtime `'error'` event from a bound Node `http.Server` to
- * the user-supplied `onServerError` hook (when present), with a
- * `console.error` fallback. Exported so the branching is unit-testable
- * without standing up a real socket and provoking EMFILE/EACCES.
- *
- * Branch contract:
- *   - no hook              → log via `console.error`
- *   - hook returns         → silent (hook owns reporting)
- *   - hook itself throws   → log the *hook* failure AND the original
- *                            error, so a misbehaving logger never
- *                            silently swallows a real server fault.
- */
-export declare const handleRuntimeServerError: (err: Error, onServerError: ((err: Error) => void) | undefined) => void;
-export declare const createServer: (config: Config) => Server;
+import type { Plugin } from '@databehave/core';
+/** Shutdown budget shared by logical requests and optional transports. */
+export interface HttpOptions {
+    readonly drainTimeoutMs?: number;
+}
+/** Provide an instance-local HTTP pipeline; no listener or feature is installed implicitly. */
+export declare const httpPlugin: (options?: HttpOptions) => Plugin;
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAUA,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAA;AAmB/B,OAAO,KAAK,EACV,MAAM,EAKN,WAAW,EACX,YAAY,EAGZ,MAAM,EACP,MAAM,YAAY,CAAA;AAInB;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,KAAK,eAAe,GAAG,SAAS,KAC/B;IACD,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,OAAO,CAAA;IACX,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,eAAe,GAAG,KAAK,CAAA;IAC7B,IAAI,EAAE,WAAW,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAA;IAC1C,YAAY,EAAE,OAAO,CAAA;IACrB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,YAAY,EAAE,MAAM,CAAA;CACrB,GAAG,IAkBH,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,UACI,CAAC,CACC,GAAG,EAAE,WAAW,KACb,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,GACxD,SAAS,EACb,WAAW,CACT,GAAG,EAAE,WAAW,KACb,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,KAChC,CAAC,CACF,GAAG,EAAE,WAAW,KACb,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAOhC,CAAA;AA+FD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB,GACnC,KAAK,KAAK,EACV,eAAe,CAAC,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,SAAS,KAChD,IAYF,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,KAAG,MA6W7C,CAAA"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAyB9C,0EAA0E;AAC1E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CACjC;AAED,+FAA+F;AAC/F,eAAO,MAAM,UAAU,GAAI,UAAS,WAAgB,KAAG,MA2PtD,CAAA"}