@zmdb/web 1.0.0-beta.1

package/README.md

@@ -0,0 +1,49 @@
+# @zmdb/web
+
+`@zmdb/web` is the HTTP framework for zmdb applications. It composes controllers, typed request contexts, middleware, OpenAPI, gateways, testing utilities, and runtime adapters over the
+protocol-neutral `@zmdb/app` kernel. It does not use `reflect-metadata` or runtime type reflection.
+
+It is part of [zmdb](https://github.com/ambasta/zmdb), where one TypeScript schema drives validation, serialization, SQL, OpenAPI, and CRUD.
+
+Applications normally install `zmdb` and use `zmdb/web`; see the [server journey](https://ambasta.github.io/zmdb/docs/web-overview.html). Select this package directly when an advanced dependency
+boundary needs HTTP without the full product facade.
+
+## Advanced: install HTTP alone
+
+```bash
+yarn add @zmdb/web@1.0.0-beta.1
+```
+
+> **Prerelease** (`1.0.0-beta.1`). Requires **Node.js 26+** and is **ESM-only**. Ships built ESM `.js` + `.d.ts` under `./dist`.
+
+## Entry points
+
+The package root contains the common HTTP APIs. Its complete feature entry set is `/app`, `/compression`, `/context`, `/contract`, `/contract/compiler`, `/csrf`, `/data`, `/devtools`, `/dto-pipes`,
+`/gateways`, `/health`, `/integrations`, `/middleware`, `/openapi`, `/pipeline`, `/routing`, `/static`, `/testing`, `/upload`, and `/versioning`.
+
+`@zmdb/web/contract` contains inert HTTP declarations and serialisable `HttpContractIR`. The build-time `@zmdb/web/contract/compiler` entry compiles those declarations and emits deterministic typed
+client modules whose runtime imports are limited to `@zmdb/client`. `zmdb client generate` projects the same compiled IR into sibling OpenAPI and client artifacts; it does not derive one from the
+other.
+
+Typed gRPC servers and clients ship from `@zmdb/transport-grpc`, core NATS ships from `@zmdb/transport-nats`, RabbitMQ ships from `@zmdb/transport-rabbitmq`, and Redis Pub/Sub ships from
+`@zmdb/transport-redis`; none of their old web subpaths forwards. The transport-neutral strategy, dispatcher, decorators, and typed clients live at `@zmdb/app/messaging`. Queues, workers, scheduling,
+and leases live in `@zmdb/jobs`; SQLite durable and memory storage lives in the separately selected `@zmdb/jobs-sqlite`. The removed web paths do not forward. Install
+`@zmdb/jobs-postgres@1.0.0-beta.1` with `pg@^8.23.0` when those jobs use a caller-owned PostgreSQL pool or client.
+
+Stage-3 metadata, dependency injection, modules, lifecycle, messaging, commands, events, CQRS, state machines, health contracts, and dependency-free observability ports live in `@zmdb/app`. Install
+`@zmdb/otel@1.0.0-beta.1` with `@opentelemetry/api@^1.9.1` to adapt caller-owned tracers and meters; web has no OpenTelemetry peer or forwarding subpath.
+
+`@zmdb/web/versioning` provides version decorators and the path, header, and media-type strategies used by the router and OpenAPI generator.
+
+Install each selected transport package with its required peer: grpc-js `^1.14.4`, the Node NATS transport `^3.4.0`, amqplib `^2.0.1`, or redis `^6.2.1`. `@zmdb/web` declares no third-party runtime
+peer and publishes no broker or benchmark-helper subpath. Its optional TypeScript peer is reached only by the build-time `/contract/compiler` entry.
+
+## Documentation
+
+Generated-client journey: **https://ambasta.github.io/zmdb/docs/generated-client.html**
+
+Full docs: **https://ambasta.github.io/zmdb/**
+
+## License
+
+GNU General Public License v3.0 or later (GPL-3.0-or-later) — see [LICENSE](./LICENSE).

package/dist/app/bridge.d.ts

@@ -0,0 +1,12 @@
+import type { Application, ApplicationOptions, CompiledModule, Constructor } from '@zmdb/app';
+export type CompiledController = {
+    readonly kind: 'eager';
+    readonly controller: object;
+} | {
+    readonly kind: 'deferred';
+    readonly controller: Constructor<object>;
+    readonly instance: () => Promise<object>;
+};
+export declare function applicationControllersOf(application: Application): readonly CompiledController[];
+export declare function withCompiledApplication(options: ApplicationOptions, compiled: CompiledModule): ApplicationOptions;
+//# sourceMappingURL=bridge.d.ts.map

package/dist/app/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/app/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAK9F,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACvD;IACE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1C,CAAC;AAcN,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,WAAW,GAAG,SAAS,kBAAkB,EAAE,CAOhG;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,cAAc,GAAG,kBAAkB,CAIjH"}

package/dist/app/bridge.js

@@ -0,0 +1,16 @@
+const APPLICATION_BRIDGE = Symbol.for('@zmdb/app.application-bridge');
+const COMPILED_APPLICATION = Symbol.for('@zmdb/app.compiled-application');
+export function applicationControllersOf(application) {
+    const carrier = application;
+    const bridge = carrier[APPLICATION_BRIDGE];
+    if (bridge === undefined) {
+        throw new Error('@zmdb/web: application omitted its controller graph');
+    }
+    return bridge.controllers;
+}
+export function withCompiledApplication(options, compiled) {
+    const carrier = { ...options };
+    Object.defineProperty(carrier, COMPILED_APPLICATION, { value: compiled });
+    return carrier;
+}
+//# sourceMappingURL=bridge.js.map

package/dist/app/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../src/app/bridge.ts"],"names":[],"mappings":"AAEA,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;AACtE,MAAM,oBAAoB,GAAG,MAAM,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;AAsB1E,MAAM,UAAU,wBAAwB,CAAC,WAAwB;IAC/D,MAAM,OAAO,GAAuB,WAAW,CAAC;IAChD,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC3C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,MAAM,CAAC,WAAW,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAA2B,EAAE,QAAwB;IAC3F,MAAM,OAAO,GAAoD,EAAE,GAAG,OAAO,EAAE,CAAC;IAChF,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,oBAAoB,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC1E,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/app/index.d.ts

@@ -0,0 +1,23 @@
+import { type Application, type ApplicationOptions, type ModuleClass } from '@zmdb/app';
+import { type GuardRegistry, type WebRequest, type WebResponse } from '../pipeline/index.js';
+import type { VersionStrategy } from '../versioning/index.js';
+export type { OnApplicationBootstrap, OnModuleInit, OnShutdown } from '@zmdb/app/lifecycle';
+/**
+ * Protocol integrations attach through `ApplicationOptions.extensions`.
+ */
+export interface WebApplicationOptions extends ApplicationOptions {
+    readonly guardRegistry?: GuardRegistry;
+    readonly versioning?: VersionStrategy;
+}
+/** A protocol-neutral application with one HTTP router attached. */
+export interface WebApplication extends Application {
+    handle(req: WebRequest): Promise<WebResponse>;
+    fetch(request: Request): Promise<Response>;
+}
+/**
+ * Compose one router over one application graph. The container, lazy handles,
+ * init function and async-dispose function are the app-owned members by
+ * identity; no second lifecycle or construction ledger exists here.
+ */
+export declare function createApp(rootModule: ModuleClass, options?: WebApplicationOptions): WebApplication;
+//# sourceMappingURL=index.d.ts.map

package/dist/app/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAqB,KAAK,WAAW,EAAE,KAAK,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAE3G,OAAO,EAGL,KAAK,aAAa,EAGlB,KAAK,UAAU,EACf,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,YAAY,EAAE,sBAAsB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE5F;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;CACvC;AAED,oEAAoE;AACpE,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9C,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC5C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,WAAW,EAAE,OAAO,GAAE,qBAA0B,GAAG,cAAc,CA2BtG"}

package/dist/app/index.js

@@ -0,0 +1,47 @@
+// @zmdb/web — HTTP application composition over the protocol-neutral kernel.
+// One @zmdb/app graph owns construction, lazy loading and lifecycle; this file
+// adds one startup-built router; protocol integrations remain explicit app extensions.
+import { createApplication } from '@zmdb/app';
+import { createRouter, toFetchHandler, } from '../pipeline/index.js';
+import { applicationControllersOf } from './bridge.js';
+/**
+ * Compose one router over one application graph. The container, lazy handles,
+ * init function and async-dispose function are the app-owned members by
+ * identity; no second lifecycle or construction ledger exists here.
+ */
+export function createApp(rootModule, options = {}) {
+    const applicationOptions = {
+        ...(options.graceMs === undefined ? {} : { graceMs: options.graceMs }),
+        ...(options.observability === undefined ? {} : { observability: options.observability }),
+        ...(options.extensions === undefined ? {} : { extensions: options.extensions }),
+    };
+    const application = createApplication(rootModule, applicationOptions);
+    const controllerBindings = applicationControllersOf(application);
+    const router = createRouter(routerOptions(options));
+    for (const binding of controllerBindings) {
+        if (binding.kind === 'eager') {
+            router.register(binding.controller);
+        }
+        else {
+            router.registerDeferred(binding.controller, binding.instance);
+        }
+    }
+    const fetchHandler = toFetchHandler(router);
+    return {
+        container: application.container,
+        lazy: application.lazy,
+        handle: req => router.handle(req),
+        fetch: request => fetchHandler(request),
+        init: application.init,
+        [Symbol.asyncDispose]: application[Symbol.asyncDispose],
+    };
+}
+function routerOptions(options) {
+    const observability = options.observability ?? {};
+    return {
+        ...observability,
+        ...(options.guardRegistry === undefined ? {} : { guardRegistry: options.guardRegistry }),
+        ...(options.versioning === undefined ? {} : { versioning: options.versioning }),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/app/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,+EAA+E;AAC/E,uFAAuF;AAEvF,OAAO,EAAE,iBAAiB,EAA+D,MAAM,WAAW,CAAC;AAE3G,OAAO,EACL,YAAY,EACZ,cAAc,GAMf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,wBAAwB,EAA2B,MAAM,aAAa,CAAC;AAkBhF;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,UAAuB,EAAE,OAAO,GAA0B,EAAE;IACpF,MAAM,kBAAkB,GAAuB;QAC7C,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;QACtE,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC;QACxF,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;KAChF,CAAC;IACF,MAAM,WAAW,GAAG,iBAAiB,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;IACtE,MAAM,kBAAkB,GAAkC,wBAAwB,CAAC,WAAW,CAAC,CAAC;IAEhG,MAAM,MAAM,GAAW,YAAY,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5D,KAAK,MAAM,OAAO,IAAI,kBAAkB,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC7B,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IACD,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAE5C,OAAO;QACL,SAAS,EAAE,WAAW,CAAC,SAAS;QAChC,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC;QACjC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC;QACvC,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,YAAY,CAAC;KACxD,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,OAA8B;IACnD,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;IAClD,OAAO;QACL,GAAG,aAAa;QAChB,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC;QACxF,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;KAChF,CAAC;AACJ,CAAC"}

package/dist/bench/index.d.ts

@@ -0,0 +1,68 @@
+import '@zmdb/app';
+import type { ModuleClass } from '@zmdb/app/modules';
+import { type Observability } from '@zmdb/app/observability';
+import { type VersionStrategy } from '../versioning/index.js';
+/** A probe that counts reads of a class's Symbol.metadata. */
+export interface MetadataReadCounter {
+    count(): number;
+    restore(): void;
+}
+/**
+ * Instrument a class so reads of its `Symbol.metadata` are counted. Replaces the
+ * own property with a counting getter over the original value; `restore` puts
+ * the original descriptor back. Test-only helper for the regression guard.
+ */
+export declare function countMetadataReads(target: object): MetadataReadCounter;
+interface BenchmarkBaseOptions {
+    readonly routes: number;
+    readonly iters: number;
+}
+/** Options for the router microbench, including one exact versioned route table. */
+export type BenchmarkOptions = (BenchmarkBaseOptions & {
+    readonly versioning?: undefined;
+    readonly version?: undefined;
+}) | (BenchmarkBaseOptions & {
+    readonly versioning: VersionStrategy;
+    readonly version: string;
+});
+/** Honest microbench result — raw timings, no scoring. */
+export interface BenchmarkResult {
+    readonly iters: number;
+    readonly totalMs: number;
+    readonly opsPerSec: number;
+}
+/** The three tracing configurations measured by the operability benchmark. */
+export type ObservabilityBenchmarkMode = 'off' | 'noop' | 'recording-exporter';
+/** The independently timed observability hot paths. */
+export type ObservabilityBenchmarkWorkload = 'request' | 'query';
+/** Options for one independently orderable observability sample. */
+export interface ObservabilityBenchmarkOptions {
+    readonly mode: ObservabilityBenchmarkMode;
+    readonly workload: ObservabilityBenchmarkWorkload;
+    readonly iters: number;
+    readonly observability?: Observability;
+}
+/** One raw workload timing. The checksum makes the loop's result observable. */
+export interface ObservabilityBenchmarkResult extends BenchmarkResult {
+    readonly mode: ObservabilityBenchmarkMode;
+    readonly workload: ObservabilityBenchmarkWorkload;
+    readonly checksum: number;
+}
+/** Measure repeated eager application creation with raw timings. */
+export declare function benchmarkAppStartup(rootModule: ModuleClass, iters: number): BenchmarkResult;
+/**
+ * Build a router with `routes` GET routes and time `iters` `handle` calls
+ * against a matching path. Returns raw timings — no averaging into a score.
+ */
+export declare function benchmarkRouter(options: BenchmarkOptions): Promise<BenchmarkResult>;
+/**
+ * Measure one request or driver hot path under an injected tracing configuration.
+ *
+ * Tracer construction belongs to the top-level benchmark runner: this shipped
+ * helper depends only on the framework's narrow observability port, never on an
+ * SDK. The runner calls the same function for elapsed-time warmup and for every
+ * raw sample, flushing an exporter only after this timer has stopped.
+ */
+export declare function benchmarkObservability(options: ObservabilityBenchmarkOptions): Promise<ObservabilityBenchmarkResult>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/bench/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bench/index.ts"],"names":[],"mappings":"AAIA,OAAO,WAAW,CAAC;AACnB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAsC,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAKjG,OAAO,EAAW,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGvE,8DAA8D;AAC9D,MAAM,WAAW,mBAAmB;IAClC,KAAK,IAAI,MAAM,CAAC;IAChB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAsBtE;AAED,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,oFAAoF;AACpF,MAAM,MAAM,gBAAgB,GACxB,CAAC,oBAAoB,GAAG;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC,GAC1F,CAAC,oBAAoB,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEhG,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,8EAA8E;AAC9E,MAAM,MAAM,0BAA0B,GAAG,KAAK,GAAG,MAAM,GAAG,oBAAoB,CAAC;AAE/E,uDAAuD;AACvD,MAAM,MAAM,8BAA8B,GAAG,SAAS,GAAG,OAAO,CAAC;AAEjE,oEAAoE;AACpE,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,8BAA8B,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;CACxC;AAED,gFAAgF;AAChF,MAAM,WAAW,4BAA6B,SAAQ,eAAe;IACnE,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,8BAA8B,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAQ3F;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAwBzF;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,4BAA4B,CAAC,CAEvC"}

package/dist/bench/index.js

@@ -0,0 +1,250 @@
+// @zmdb/web — router benchmark & perf verification (epic #317, spec ./SPEC.md).
+// An honest microbench + an init-time-resolution probe proving route resolution
+// does not re-read metadata per request. No `as` on the consumer surface.
+import '@zmdb/app';
+import { tracedDriver } from '@zmdb/app/observability';
+import { createApp } from '../app/index.js';
+import { createRouter } from '../pipeline/index.js';
+import { Controller, Get } from '../routing/index.js';
+import { Version } from '../versioning/index.js';
+import { pathForVersion } from '../versioning/runtime.js';
+/**
+ * Instrument a class so reads of its `Symbol.metadata` are counted. Replaces the
+ * own property with a counting getter over the original value; `restore` puts
+ * the original descriptor back. Test-only helper for the regression guard.
+ */
+export function countMetadataReads(target) {
+    const original = Object.getOwnPropertyDescriptor(target, Symbol.metadata);
+    const stored = original?.value;
+    let reads = 0;
+    Object.defineProperty(target, Symbol.metadata, {
+        configurable: true,
+        enumerable: original?.enumerable ?? false,
+        get() {
+            reads += 1;
+            return stored;
+        },
+    });
+    return {
+        count: () => reads,
+        restore: () => {
+            if (original === undefined) {
+                Reflect.deleteProperty(target, Symbol.metadata);
+            }
+            else {
+                Object.defineProperty(target, Symbol.metadata, original);
+            }
+        },
+    };
+}
+/** Measure repeated eager application creation with raw timings. */
+export function benchmarkAppStartup(rootModule, iters) {
+    const start = performance.now();
+    for (let index = 0; index < iters; index += 1) {
+        createApp(rootModule);
+    }
+    const totalMs = performance.now() - start;
+    const opsPerSec = totalMs > 0 ? (iters / totalMs) * 1000 : iters;
+    return { iters, totalMs, opsPerSec };
+}
+/**
+ * Build a router with `routes` GET routes and time `iters` `handle` calls
+ * against a matching path. Returns raw timings — no averaging into a score.
+ */
+export async function benchmarkRouter(options) {
+    const controller = makeController(options.routes, options.version);
+    const router = createRouter(options.versioning === undefined ? {} : { versioning: options.versioning });
+    router.register(controller);
+    const routePath = `/bench/r${Math.max(0, options.routes - 1)}`;
+    let path = routePath;
+    let headers = {};
+    if (options.versioning !== undefined) {
+        if (options.versioning.kind === 'path') {
+            path = pathForVersion(options.versioning.prefix, options.version, routePath);
+        }
+        else if (options.versioning.kind === 'header') {
+            headers = { [options.versioning.name.toLowerCase()]: options.version };
+        }
+        else {
+            headers = { accept: `application/json; ${options.versioning.key}=${options.version}` };
+        }
+    }
+    const start = performance.now();
+    for (let i = 0; i < options.iters; i += 1) {
+        await router.handle({ method: 'GET', path, headers });
+    }
+    const totalMs = performance.now() - start;
+    const opsPerSec = totalMs > 0 ? (options.iters / totalMs) * 1000 : options.iters;
+    return { iters: options.iters, totalMs, opsPerSec };
+}
+/**
+ * Measure one request or driver hot path under an injected tracing configuration.
+ *
+ * Tracer construction belongs to the top-level benchmark runner: this shipped
+ * helper depends only on the framework's narrow observability port, never on an
+ * SDK. The runner calls the same function for elapsed-time warmup and for every
+ * raw sample, flushing an exporter only after this timer has stopped.
+ */
+export async function benchmarkObservability(options) {
+    return options.workload === 'request' ? benchmarkRequest(options) : benchmarkQuery(options);
+}
+async function benchmarkRequest(options) {
+    const observability = options.observability ?? {};
+    const router = createRouter(observability);
+    router.register(makeController(1));
+    const request = Object.freeze({ method: 'GET', path: '/bench/r0', headers: Object.freeze({}) });
+    let checksum = 0;
+    const start = performance.now();
+    for (let i = 0; i < options.iters; i += 1) {
+        const response = await router.handle(request);
+        checksum = (checksum + response.status + responseBodySize(response.body)) >>> 0;
+    }
+    return observabilityResult(options, performance.now() - start, checksum);
+}
+async function benchmarkQuery(options) {
+    const observability = options.observability ?? {};
+    const driver = tracedDriver({
+        execute: query => {
+            const id = query.parameters[0];
+            return Promise.resolve(typeof id === 'number' && id % 2 === 0 ? TWO_ROWS : ONE_ROW);
+        },
+    }, observability);
+    let checksum = 0;
+    const start = performance.now();
+    for (let i = 0; i < options.iters; i += 1) {
+        const rows = await driver.execute(benchQuery(i));
+        checksum = (checksum + rows.length) >>> 0;
+    }
+    return observabilityResult(options, performance.now() - start, checksum);
+}
+function observabilityResult(options, totalMs, checksum) {
+    return {
+        mode: options.mode,
+        workload: options.workload,
+        ...result(options.iters, totalMs),
+        checksum,
+    };
+}
+const QUERY_TELEMETRY = Object.freeze({
+    system: 'postgresql',
+    operation: 'SELECT',
+    collection: 'bench',
+});
+const BENCH_QUERIES = Object.freeze(Array.from({ length: 8 }, (_, index) => Object.freeze({
+    text: 'SELECT "id" FROM "bench" WHERE "id" = $1',
+    parameters: Object.freeze([index + 1]),
+    telemetry: QUERY_TELEMETRY,
+})));
+const ONE_ROW = Object.freeze([Object.freeze({ id: 1 })]);
+const TWO_ROWS = Object.freeze([
+    Object.freeze({ id: 1 }),
+    Object.freeze({ id: 2 }),
+]);
+function benchQuery(index) {
+    const query = BENCH_QUERIES[index % BENCH_QUERIES.length];
+    if (query === undefined) {
+        throw new Error('observability benchmark query pool is empty');
+    }
+    return query;
+}
+function responseBodySize(body) {
+    if (typeof body.value === 'string') {
+        return body.value.length;
+    }
+    if (body.value instanceof Uint8Array) {
+        return body.value.byteLength;
+    }
+    return 'length' in body ? (body.length ?? 0) : 0;
+}
+// Build a controller instance with `count` GET routes /bench/r0../bench/r{n-1}.
+// Defined via a factory so each benchmark gets a fresh class + metadata.
+function makeController(count, version) {
+    class BenchController {
+        // Every route resolves to this one method, aliased under `count` names below. A benchmark
+        // that allocated a fresh closure per route would be measuring that instead of the router.
+        ok() {
+            return { ok: true };
+        }
+    }
+    // `@Controller('/bench')` in decorator position instead, except that decorators are real
+    // syntax rather than types, so a file containing one cannot be loaded by Node's type
+    // stripping — and this package ships its `src`. A single decorator here was enough to make
+    // `import '@zmdb/web'` a SyntaxError, because the root index re-exports this module. Applied
+    // programmatically it costs a synthesised context; the routing decorators only ever touch
+    // `context.metadata`, which is what makes the substitution exact.
+    Controller('/bench')(BenchController, classContext(BenchController));
+    if (version !== undefined) {
+        Version(version)(BenchController, classContext(BenchController));
+    }
+    // Attach `count` routes by decorating dynamically-added methods. Since Stage-3
+    // method decorators can't be applied dynamically, we register handlers on the
+    // prototype and record routes through a single re-decoration pass: simplest is
+    // to define a fixed handler and add route metadata via the Get decorator on
+    // named prototype methods.
+    const proto = BenchController.prototype;
+    for (let i = 0; i < count; i += 1) {
+        const name = `r${i}`;
+        Object.defineProperty(proto, name, {
+            configurable: true,
+            writable: true,
+            value: proto.ok,
+        });
+        const decorate = Get(`/r${i}`);
+        const context = methodContext(name, BenchController);
+        decorate(readProtoMethod(proto, name), context);
+    }
+    return new BenchController();
+}
+function result(iters, totalMs) {
+    return {
+        iters,
+        totalMs,
+        opsPerSec: totalMs > 0 ? (iters / totalMs) * 1000 : iters,
+    };
+}
+// A minimal ClassDecoratorContext, for the same reason. Controller reads `metadata` and nothing
+// else; `name` and `addInitializer` are here to satisfy the type.
+function classContext(cls) {
+    return {
+        kind: 'class',
+        name: cls.name,
+        metadata: ensureMetadata(cls),
+        addInitializer: () => undefined,
+    };
+}
+// A minimal ClassMethodDecoratorContext for programmatic decoration. The Get
+// decorator only reads `name` + `metadata`; the rest satisfies the type.
+function methodContext(name, cls) {
+    const metadata = ensureMetadata(cls);
+    const noop = () => undefined;
+    return {
+        kind: 'method',
+        name,
+        static: false,
+        private: false,
+        access: { has: () => true, get: obj => Reflect.get(Object(obj), name) },
+        metadata,
+        addInitializer: noop,
+    };
+}
+function ensureMetadata(cls) {
+    const existing = cls[Symbol.metadata];
+    if (existing !== undefined && existing !== null) {
+        return existing;
+    }
+    const created = Object.create(null);
+    Object.defineProperty(cls, Symbol.metadata, {
+        value: created,
+        configurable: true,
+        enumerable: false,
+        writable: false,
+    });
+    return created;
+}
+// boundary: reading a just-defined prototype method by name to hand to the Get
+// decorator; it is a function by construction (§2.1).
+function readProtoMethod(proto, name) {
+    const value = Reflect.get(proto, name);
+    return value;
+}
+//# sourceMappingURL=index.js.map

package/dist/bench/index.js.map

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

package/dist/compression/index.d.ts

@@ -0,0 +1,13 @@
+import type { AnyCtx, Interceptor } from '../middleware/index.js';
+import type { WebResponse } from '../pipeline/index.js';
+export type ContentCoding = 'gzip' | 'deflate';
+export interface CompressionOptions {
+    readonly minBytes?: number;
+    readonly types?: readonly string[];
+    readonly skip?: (response: WebResponse, ctx: AnyCtx) => boolean;
+}
+/** Negotiate and incrementally compress one response. */
+export declare function compress(response: WebResponse, ctx: AnyCtx, options?: CompressionOptions): WebResponse;
+/** The middleware form is deliberately a thin wrapper around the pure function. */
+export declare function compressionInterceptor(options?: CompressionOptions): Interceptor;
+//# sourceMappingURL=index.d.ts.map

package/dist/compression/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/compression/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEtE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CACjE;AAoBD,yDAAyD;AACzD,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAmC1G;AAED,mFAAmF;AACnF,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAOpF"}