@nwire/forge 0.7.0

package/dist/define-projection.d.ts

@@ -0,0 +1,56 @@
+/**
+ * `defineProjection` — first-class CQRS read models.
+ *
+ *   export const SubmissionsByStudent = defineProjection('submissions-by-student', {
+ *     listens: [AnswerSubmittedEvent, SubmissionAutoGradedEvent, ...],
+ *     initial: () => ({}),
+ *     on: {
+ *       [AnswerSubmittedEvent.name]: (state, event) => ({
+ *         ...state,
+ *         [event.submissionId]: { ... }
+ *       }),
+ *       ...
+ *     }
+ *   })
+ *
+ * Projections are pure folds over event streams: `(state, event) => state`.
+ * The runtime registers a `when` listener for each event in `listens` and
+ * applies the corresponding `on` reducer to the projection's state.
+ *
+ * Queries (`defineQuery`) read from projections, not from actors. This
+ * preserves the CQRS separation: writes go through actors, reads through
+ * projections.
+ *
+ * Side effects (notifications, external sync) belong in `when` reactions, not
+ * in projections — projections are pure folds, like `assign`.
+ */
+import type { EventDefinition, EventPayload } from "@nwire/messages";
+export type ProjectionReducer<TState, E extends EventDefinition = EventDefinition> = (state: TState, event: EventPayload<E>) => TState;
+/** Studio-aware: declared read-model freshness target. */
+export interface ProjectionFreshness {
+    /** Declared p95 milliseconds the projection lags behind the event stream. */
+    readonly p95MsBehindStream?: number;
+}
+export interface ProjectionOptions<TState> {
+    /** The events this projection folds over. Order matters for `on` lookup. */
+    readonly listens: readonly EventDefinition[];
+    /** Factory for the initial state when no events have been seen yet. */
+    readonly initial: () => TState;
+    /** Pure reducers, keyed by event name. */
+    readonly on: Readonly<Record<string, ProjectionReducer<TState>>>;
+    /** Free-form description (Studio-aware). */
+    readonly description?: string;
+    /** Declared freshness SLO (Studio-aware). */
+    readonly freshness?: ProjectionFreshness;
+}
+export interface ProjectionDefinition<TState = unknown> {
+    readonly $kind: "projection";
+    readonly name: string;
+    readonly listens: readonly EventDefinition[];
+    readonly initial: () => TState;
+    readonly on: Readonly<Record<string, ProjectionReducer<TState>>>;
+    readonly description?: string;
+    readonly freshness?: ProjectionFreshness;
+}
+export declare function defineProjection<TState>(name: string, options: ProjectionOptions<TState>): ProjectionDefinition<TState>;
+//# sourceMappingURL=define-projection.d.ts.map

package/dist/define-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-projection.d.ts","sourceRoot":"","sources":["../src/define-projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAErE,MAAM,MAAM,iBAAiB,CAAC,MAAM,EAAE,CAAC,SAAS,eAAe,GAAG,eAAe,IAAI,CACnF,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,KACnB,MAAM,CAAC;AAEZ,0DAA0D;AAC1D,MAAM,WAAW,mBAAmB;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,iBAAiB,CAAC,MAAM;IACvC,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,MAAM,CAAC;IAC/B,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACjE,4CAA4C;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC;CAC1C;AAED,MAAM,WAAW,oBAAoB,CAAC,MAAM,GAAG,OAAO;IACpD,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC;CAC1C;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,GACjC,oBAAoB,CAAC,MAAM,CAAC,CAkB9B"}

package/dist/define-projection.js

@@ -0,0 +1,44 @@
+/**
+ * `defineProjection` — first-class CQRS read models.
+ *
+ *   export const SubmissionsByStudent = defineProjection('submissions-by-student', {
+ *     listens: [AnswerSubmittedEvent, SubmissionAutoGradedEvent, ...],
+ *     initial: () => ({}),
+ *     on: {
+ *       [AnswerSubmittedEvent.name]: (state, event) => ({
+ *         ...state,
+ *         [event.submissionId]: { ... }
+ *       }),
+ *       ...
+ *     }
+ *   })
+ *
+ * Projections are pure folds over event streams: `(state, event) => state`.
+ * The runtime registers a `when` listener for each event in `listens` and
+ * applies the corresponding `on` reducer to the projection's state.
+ *
+ * Queries (`defineQuery`) read from projections, not from actors. This
+ * preserves the CQRS separation: writes go through actors, reads through
+ * projections.
+ *
+ * Side effects (notifications, external sync) belong in `when` reactions, not
+ * in projections — projections are pure folds, like `assign`.
+ */
+export function defineProjection(name, options) {
+    // Validate that every listened event has a reducer.
+    for (const event of options.listens) {
+        if (!options.on[event.name]) {
+            throw new Error(`defineProjection("${name}"): event "${event.name}" is in 'listens' but has no reducer in 'on'.`);
+        }
+    }
+    return {
+        $kind: "projection",
+        name,
+        listens: options.listens,
+        initial: options.initial,
+        on: options.on,
+        description: options.description,
+        freshness: options.freshness,
+    };
+}
+//# sourceMappingURL=define-projection.js.map

package/dist/define-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-projection.js","sourceRoot":"","sources":["../src/define-projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAsCH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,OAAkC;IAElC,oDAAoD;IACpD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CACb,qBAAqB,IAAI,cAAc,KAAK,CAAC,IAAI,+CAA+C,CACjG,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO;QACL,KAAK,EAAE,YAAY;QACnB,IAAI;QACJ,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC;AACJ,CAAC"}

package/dist/define-provider.d.ts

@@ -0,0 +1,49 @@
+/**
+ * `defineProvider` — a bootable dependency.
+ *
+ *   const database = defineProvider('database', {
+ *       boot: async () => {
+ *           const pool = createPool(config.database.url)
+ *           await pool.connect()
+ *           return pool
+ *       },
+ *       shutdown: async (pool) => { await pool.end() },
+ *       healthCheck: async (pool) => { await pool.query('SELECT 1') }
+ *   })
+ *
+ *   createApp({
+ *       modules: [...],
+ *       providers: [database, redis, email]
+ *   })
+ *
+ * Providers boot in declaration order during `app.start()`; shutdown runs in
+ * reverse during `app.stop()`. The booted value is registered on the runtime
+ * container under `provider.name`, so handlers resolve it via
+ * `ctx.resolve<Pool>('database')`.
+ *
+ * This is the right shape for things that have lifecycle (a connection that
+ * opens + closes; a pool you must drain; a worker process you must signal).
+ * For plain values, register them on the container directly — no provider
+ * needed.
+ *
+ * Providers vs plugins:
+ *   - A provider produces a typed VALUE and manages its lifecycle.
+ *   - A plugin hooks into the FRAMEWORK (middleware, lifecycle hooks, routes).
+ * Most things you import as "an integration" (Redis client, Stripe SDK,
+ * S3 client) are providers. Things like observability, auth, audit-log
+ * are plugins.
+ */
+export interface ProviderDefinition<T = unknown> {
+    readonly $kind: "provider";
+    readonly name: string;
+    readonly boot: () => Promise<T> | T;
+    readonly shutdown?: (value: T) => Promise<void> | void;
+    readonly healthCheck?: (value: T) => Promise<void> | void;
+}
+export interface ProviderOptions<T> {
+    readonly boot: () => Promise<T> | T;
+    readonly shutdown?: (value: T) => Promise<void> | void;
+    readonly healthCheck?: (value: T) => Promise<void> | void;
+}
+export declare function defineProvider<T>(name: string, options: ProviderOptions<T>): ProviderDefinition<T>;
+//# sourceMappingURL=define-provider.d.ts.map

package/dist/define-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-provider.d.ts","sourceRoot":"","sources":["../src/define-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAC7C,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3D;AAED,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3D;AAED,wBAAgB,cAAc,CAAC,CAAC,EAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAC1B,kBAAkB,CAAC,CAAC,CAAC,CAQvB"}

package/dist/define-provider.js

@@ -0,0 +1,45 @@
+/**
+ * `defineProvider` — a bootable dependency.
+ *
+ *   const database = defineProvider('database', {
+ *       boot: async () => {
+ *           const pool = createPool(config.database.url)
+ *           await pool.connect()
+ *           return pool
+ *       },
+ *       shutdown: async (pool) => { await pool.end() },
+ *       healthCheck: async (pool) => { await pool.query('SELECT 1') }
+ *   })
+ *
+ *   createApp({
+ *       modules: [...],
+ *       providers: [database, redis, email]
+ *   })
+ *
+ * Providers boot in declaration order during `app.start()`; shutdown runs in
+ * reverse during `app.stop()`. The booted value is registered on the runtime
+ * container under `provider.name`, so handlers resolve it via
+ * `ctx.resolve<Pool>('database')`.
+ *
+ * This is the right shape for things that have lifecycle (a connection that
+ * opens + closes; a pool you must drain; a worker process you must signal).
+ * For plain values, register them on the container directly — no provider
+ * needed.
+ *
+ * Providers vs plugins:
+ *   - A provider produces a typed VALUE and manages its lifecycle.
+ *   - A plugin hooks into the FRAMEWORK (middleware, lifecycle hooks, routes).
+ * Most things you import as "an integration" (Redis client, Stripe SDK,
+ * S3 client) are providers. Things like observability, auth, audit-log
+ * are plugins.
+ */
+export function defineProvider(name, options) {
+    return {
+        $kind: "provider",
+        name,
+        boot: options.boot,
+        shutdown: options.shutdown,
+        healthCheck: options.healthCheck,
+    };
+}
+//# sourceMappingURL=define-provider.js.map

package/dist/define-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-provider.js","sourceRoot":"","sources":["../src/define-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAgBH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,OAA2B;IAE3B,OAAO;QACL,KAAK,EAAE,UAAU;QACjB,IAAI;QACJ,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAC;AACJ,CAAC"}

package/dist/define-query.d.ts

@@ -0,0 +1,50 @@
+/**
+ * `defineQuery` — read function over a projection.
+ *
+ *   export const submissionsByStudent = defineQuery(SubmissionsByStudent, {
+ *     name: 'submissions.by-student',
+ *     schema: z.object({ studentId: StudentId, status: SubmissionStatus.optional() }),
+ *     execute: (state, { studentId, status }) =>
+ *       Object.values(state).filter(s => s.studentId === studentId &&
+ *         (!status || s.status === status))
+ *   })
+ *
+ * Queries read from projections, never from actors. They have no envelope, no
+ * bus, no commit semantics — direct calls. The runtime hands them the
+ * projection's current state and the validated input.
+ *
+ * Naming follows actions: `<domain>.<verb-noun>` so a query is addressable on
+ * the same routing keyspace as actions when transports need it (HTTP GET
+ * routes wire queries; HTTP POST routes wire actions).
+ */
+import type { z } from "zod";
+import type { ZodTypeAny } from "@nwire/messages";
+import type { ProjectionDefinition } from "./define-projection.js";
+import { type PublicMarker } from "./public-marker.js";
+/** Studio-aware: declared read-path SLO. */
+export interface QuerySlo {
+    /** Declared p95 latency target in milliseconds. */
+    readonly p95LatencyMs?: number;
+}
+export interface QueryOptions<TState, TSchema extends ZodTypeAny, TResult> {
+    readonly name: string;
+    readonly description?: string;
+    readonly schema: TSchema;
+    readonly execute: (state: TState, input: z.output<TSchema>) => TResult | Promise<TResult>;
+    /** Studio-aware: declared latency target. */
+    readonly slo?: QuerySlo;
+    /** Studio-aware: hint that this query is safe to cache. */
+    readonly cacheable?: boolean;
+}
+export interface QueryDefinition<TState = unknown, TSchema extends ZodTypeAny = ZodTypeAny, TResult = unknown> extends PublicMarker {
+    readonly $kind: "query";
+    readonly name: string;
+    readonly description?: string;
+    readonly schema: TSchema;
+    readonly projection: ProjectionDefinition<TState>;
+    readonly execute: (state: TState, input: z.output<TSchema>) => TResult | Promise<TResult>;
+    readonly slo?: QuerySlo;
+    readonly cacheable?: boolean;
+}
+export declare function defineQuery<TState, TSchema extends ZodTypeAny, TResult>(projection: ProjectionDefinition<TState>, options: QueryOptions<TState, TSchema, TResult>): QueryDefinition<TState, TSchema, TResult>;
+//# sourceMappingURL=define-query.d.ts.map

package/dist/define-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-query.d.ts","sourceRoot":"","sources":["../src/define-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAY,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE9D,4CAA4C;AAC5C,MAAM,WAAW,QAAQ;IACvB,mDAAmD;IACnD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,YAAY,CAAC,MAAM,EAAE,OAAO,SAAS,UAAU,EAAE,OAAO;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1F,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe,CAC9B,MAAM,GAAG,OAAO,EAChB,OAAO,SAAS,UAAU,GAAG,UAAU,EACvC,OAAO,GAAG,OAAO,CACjB,SAAQ,YAAY;IACpB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1F,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,SAAS,UAAU,EAAE,OAAO,EACrE,UAAU,EAAE,oBAAoB,CAAC,MAAM,CAAC,EACxC,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,GAC9C,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAW3C"}

package/dist/define-query.js

@@ -0,0 +1,33 @@
+/**
+ * `defineQuery` — read function over a projection.
+ *
+ *   export const submissionsByStudent = defineQuery(SubmissionsByStudent, {
+ *     name: 'submissions.by-student',
+ *     schema: z.object({ studentId: StudentId, status: SubmissionStatus.optional() }),
+ *     execute: (state, { studentId, status }) =>
+ *       Object.values(state).filter(s => s.studentId === studentId &&
+ *         (!status || s.status === status))
+ *   })
+ *
+ * Queries read from projections, never from actors. They have no envelope, no
+ * bus, no commit semantics — direct calls. The runtime hands them the
+ * projection's current state and the validated input.
+ *
+ * Naming follows actions: `<domain>.<verb-noun>` so a query is addressable on
+ * the same routing keyspace as actions when transports need it (HTTP GET
+ * routes wire queries; HTTP POST routes wire actions).
+ */
+import { markable } from "./public-marker.js";
+export function defineQuery(projection, options) {
+    return markable({
+        $kind: "query",
+        name: options.name,
+        description: options.description,
+        schema: options.schema,
+        projection,
+        execute: options.execute,
+        slo: options.slo,
+        cacheable: options.cacheable,
+    });
+}
+//# sourceMappingURL=define-query.js.map

package/dist/define-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-query.js","sourceRoot":"","sources":["../src/define-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,EAAE,QAAQ,EAAqB,MAAM,iBAAiB,CAAC;AAkC9D,MAAM,UAAU,WAAW,CACzB,UAAwC,EACxC,OAA+C;IAE/C,OAAO,QAAQ,CAAC;QACd,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,UAAU;QACV,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC,CAAC;AACL,CAAC"}

package/dist/define-resolver.d.ts

@@ -0,0 +1,111 @@
+/**
+ * `defineResolver` — the operation: a named, versioned, statused, typed
+ * capability the system exposes through one or more transports.
+ *
+ *   const RecordWash = defineResolver({
+ *     operation:  "RecordWash",
+ *     version:    1,
+ *     status:     "active",
+ *     summary:    "Record a wash at a station",
+ *     description:"...",
+ *     tags:       ["Stations", "Washes"],
+ *     params:     z.object({ stationId: z.string().uuid() }),
+ *     body:       z.object({ subscriptionId: ..., plateNumber: ..., washType: ... }),
+ *     returns:    [washCreated, washAccepted],
+ *     errors:     [WashInProgress, QuotaExceeded, StationOffline],
+ *   })
+ *   .use(stationPipeline)
+ *   .use(async ({ input, user, station, execute, send, useProjection }) => {
+ *     // ...
+ *     const wash = await execute(recordWash, { ... });
+ *     return washCreated(wash);
+ *   });
+ *
+ * Status lifecycle:
+ *   draft       — not mountable (build error if a transport tries)
+ *   active      — live, serves traffic
+ *   deprecated  — live + warns; must declare `successor`
+ *   sunset      — dead, returns 410/error/exit 1; must declare `sunsetDate`
+ *
+ * Transport-agnostic. Mounted onto REST/GraphQL/CLI via the transport
+ * namespace (rest.mount, graphql.mount, cli.mount).
+ */
+import type { z } from "zod";
+import type { ZodTypeAny } from "@nwire/messages";
+import type { NwireError } from "./define-error.js";
+import { type MiddlewareDefinition, type HookDefinition, type PipeStep, type ResolverCtx } from "./define-middleware.js";
+import type { ResponseSpecBase, ResponseInstance } from "./response.js";
+export type ResolverStatus = "draft" | "active" | "deprecated" | "sunset";
+export type AnyResolverDefinition = ResolverDefinition<any, any, any, any>;
+export interface DefineResolverOptions<TParams extends ZodTypeAny | undefined, TQuery extends ZodTypeAny | undefined, TBody extends ZodTypeAny | undefined> {
+    readonly operation: string;
+    readonly version: number;
+    readonly status: ResolverStatus;
+    readonly summary?: string;
+    readonly description?: string;
+    readonly tags?: ReadonlyArray<string>;
+    readonly params?: TParams;
+    readonly query?: TQuery;
+    readonly body?: TBody;
+    readonly returns: ReadonlyArray<ResponseSpecBase>;
+    readonly errors?: ReadonlyArray<NwireError>;
+    /** Required when `status === "deprecated"` or `"sunset"`. */
+    readonly successor?: AnyResolverDefinition;
+    /** Required when `status === "sunset"`. ISO date the operation stopped serving. */
+    readonly sunsetDate?: string;
+}
+export interface ResolverHandlerContext<TInput = unknown> extends ResolverCtx {
+    readonly input: TInput;
+}
+export type ResolverHandler<TInput = any> = (ctx: ResolverHandlerContext<TInput>) => Promise<ResponseInstance | undefined> | ResponseInstance | undefined;
+type ZodOutput<T> = T extends ZodTypeAny ? z.output<T> : never;
+/**
+ * Flat-merge the params/query/body schemas. The handler sees one input
+ * object — `input.stationId`, not `input.params.stationId`. Collisions
+ * follow precedence: body > query > params (body is "the request", path/
+ * query are "the location"). Spec-level rationale: handlers shouldn't
+ * care where a value came from; they care what the operation needs.
+ */
+type MergeInput<TParams, TQuery, TBody> = (TParams extends ZodTypeAny ? ZodOutput<TParams> : unknown) & (TQuery extends ZodTypeAny ? ZodOutput<TQuery> : unknown) & (TBody extends ZodTypeAny ? ZodOutput<TBody> : unknown);
+export interface ResolverDefinition<TParams extends ZodTypeAny | undefined = undefined, TQuery extends ZodTypeAny | undefined = undefined, TBody extends ZodTypeAny | undefined = undefined, TInput = MergeInput<TParams, TQuery, TBody>> {
+    readonly $kind: "resolver";
+    readonly operation: string;
+    readonly version: number;
+    readonly status: ResolverStatus;
+    readonly summary?: string;
+    readonly description?: string;
+    readonly tags?: ReadonlyArray<string>;
+    readonly params?: TParams;
+    readonly query?: TQuery;
+    readonly body?: TBody;
+    readonly returns: ReadonlyArray<ResponseSpecBase>;
+    readonly errors: ReadonlyArray<NwireError>;
+    readonly successor?: AnyResolverDefinition;
+    readonly sunsetDate?: string;
+    /** Composed middleware + hooks (built via successive `.use(...)` calls). */
+    readonly steps: ReadonlyArray<MiddlewareDefinition | HookDefinition>;
+    /** The terminal handler — last `.use(fn)` where fn has arity 1. */
+    readonly handler?: ResolverHandler<TInput>;
+    /**
+     * Append a middleware / pipe / hook to the chain. If the value is a
+     * function with arity 1, it's treated as the terminal handler — no further
+     * `.use()` after that.
+     */
+    use(step: PipeStep): ResolverDefinition<TParams, TQuery, TBody, TInput>;
+    use(handler: ResolverHandler<TInput>): ResolverDefinition<TParams, TQuery, TBody, TInput>;
+    /**
+     * Call the resolver directly — for tests + harness. Runs middleware +
+     * handler in-process with the given input + ctx augmentations.
+     */
+    call(opts: {
+        readonly input?: TInput;
+        readonly user?: any;
+        readonly container?: any;
+        readonly ctx?: Record<string, any>;
+    }): Promise<ResponseInstance | undefined>;
+}
+export declare function defineResolver<TParams extends ZodTypeAny | undefined = undefined, TQuery extends ZodTypeAny | undefined = undefined, TBody extends ZodTypeAny | undefined = undefined>(options: DefineResolverOptions<TParams, TQuery, TBody>): ResolverDefinition<TParams, TQuery, TBody>;
+/** Type narrow. */
+export declare const isResolver: (x: unknown) => x is AnyResolverDefinition;
+export {};
+//# sourceMappingURL=define-resolver.d.ts.map

package/dist/define-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-resolver.d.ts","sourceRoot":"","sources":["../src/define-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,cAAc,EAGnB,KAAK,QAAQ,EACb,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAErE,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,CAAC;AAG1E,MAAM,MAAM,qBAAqB,GAAG,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAE3E,MAAM,WAAW,qBAAqB,CACpC,OAAO,SAAS,UAAU,GAAG,SAAS,EACtC,MAAM,SAAS,UAAU,GAAG,SAAS,EACrC,KAAK,SAAS,UAAU,GAAG,SAAS;IAEpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAC5C,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAC3C,mFAAmF;IACnF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB,CAAC,MAAM,GAAG,OAAO,CAAE,SAAQ,WAAW;IAC3E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAGD,MAAM,MAAM,eAAe,CAAC,MAAM,GAAG,GAAG,IAAI,CAC1C,GAAG,EAAE,sBAAsB,CAAC,MAAM,CAAC,KAChC,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,GAAG,gBAAgB,GAAG,SAAS,CAAC;AAE1E,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AAE/D;;;;;;GAMG;AACH,KAAK,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,IACpC,CAAC,OAAO,SAAS,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,GAC3D,CAAC,MAAM,SAAU,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,GAAI,OAAO,CAAC,GAC3D,CAAC,KAAK,SAAW,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,GAAK,OAAO,CAAC,CAAC;AAE9D,MAAM,WAAW,kBAAkB,CACjC,OAAO,SAAS,UAAU,GAAG,SAAS,GAAG,SAAS,EAClD,MAAM,SAAS,UAAU,GAAG,SAAS,GAAG,SAAS,EACjD,KAAK,SAAS,UAAU,GAAG,SAAS,GAAG,SAAS,EAChD,MAAM,GAAG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC;IAE3C,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,oBAAoB,GAAG,cAAc,CAAC,CAAC;IACrE,mEAAmE;IACnE,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IAE3C;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACxE,GAAG,CAAC,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAE1F;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE;QACT,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAExB,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC;QAEpB,QAAQ,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC;QAEzB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;CAC3C;AAiBD,wBAAgB,cAAc,CAC5B,OAAO,SAAS,UAAU,GAAG,SAAS,GAAG,SAAS,EAClD,MAAM,SAAS,UAAU,GAAG,SAAS,GAAG,SAAS,EACjD,KAAK,SAAS,UAAU,GAAG,SAAS,GAAG,SAAS,EAEhD,OAAO,EAAE,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,GACrD,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAwG5C;AAED,mBAAmB;AACnB,eAAO,MAAM,UAAU,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,qBAC2C,CAAC"}

package/dist/define-resolver.js

@@ -0,0 +1,146 @@
+/**
+ * `defineResolver` — the operation: a named, versioned, statused, typed
+ * capability the system exposes through one or more transports.
+ *
+ *   const RecordWash = defineResolver({
+ *     operation:  "RecordWash",
+ *     version:    1,
+ *     status:     "active",
+ *     summary:    "Record a wash at a station",
+ *     description:"...",
+ *     tags:       ["Stations", "Washes"],
+ *     params:     z.object({ stationId: z.string().uuid() }),
+ *     body:       z.object({ subscriptionId: ..., plateNumber: ..., washType: ... }),
+ *     returns:    [washCreated, washAccepted],
+ *     errors:     [WashInProgress, QuotaExceeded, StationOffline],
+ *   })
+ *   .use(stationPipeline)
+ *   .use(async ({ input, user, station, execute, send, useProjection }) => {
+ *     // ...
+ *     const wash = await execute(recordWash, { ... });
+ *     return washCreated(wash);
+ *   });
+ *
+ * Status lifecycle:
+ *   draft       — not mountable (build error if a transport tries)
+ *   active      — live, serves traffic
+ *   deprecated  — live + warns; must declare `successor`
+ *   sunset      — dead, returns 410/error/exit 1; must declare `sunsetDate`
+ *
+ * Transport-agnostic. Mounted onto REST/GraphQL/CLI via the transport
+ * namespace (rest.mount, graphql.mount, cli.mount).
+ */
+import { unwindPipe, } from "./define-middleware.js";
+function validateLifecycle(opts) {
+    const tag = `Resolver ${opts.operation} v${opts.version}`;
+    if (opts.status === "deprecated" && !opts.successor) {
+        throw new Error(`${tag}: status="deprecated" requires \`successor\` to point at the replacement resolver.`);
+    }
+    if (opts.status === "sunset") {
+        if (!opts.successor) {
+            throw new Error(`${tag}: status="sunset" requires \`successor\` to point at the replacement resolver.`);
+        }
+        if (!opts.sunsetDate) {
+            throw new Error(`${tag}: status="sunset" requires \`sunsetDate\` (ISO date when the operation stopped serving).`);
+        }
+    }
+}
+export function defineResolver(options) {
+    validateLifecycle(options);
+    const buildResolver = (steps, handler) => {
+        const def = {
+            $kind: "resolver",
+            operation: options.operation,
+            version: options.version,
+            status: options.status,
+            summary: options.summary,
+            description: options.description,
+            tags: options.tags,
+            params: options.params,
+            query: options.query,
+            body: options.body,
+            returns: options.returns,
+            errors: options.errors ?? [],
+            successor: options.successor,
+            sunsetDate: options.sunsetDate,
+            steps,
+            handler,
+            use(step) {
+                // Distinguish handler (single-arg fn) from middleware (two-arg fn).
+                if (typeof step === "function") {
+                    // It's a handler — arity 1 (the destructured ctx).
+                    return buildResolver(steps, step);
+                }
+                // Otherwise it's a middleware / hook / pipe.
+                const unwound = unwindPipe([step]);
+                const nextSteps = [
+                    ...steps,
+                    ...unwound.beforeHooks,
+                    ...unwound.middlewares,
+                    ...unwound.afterHooks,
+                ];
+                return buildResolver(nextSteps, handler);
+            },
+            async call({ input, user, container, ctx: ctxExtra }) {
+                // Status gate.
+                if (options.status === "sunset") {
+                    const { Gone } = await import("./define-error.js");
+                    throw Gone.with({
+                        operation: options.operation,
+                        version: options.version,
+                        successor: options.successor && { operation: options.successor.operation, version: options.successor.version },
+                        sunsetDate: options.sunsetDate,
+                    });
+                }
+                if (options.status === "draft") {
+                    throw new Error(`Resolver ${options.operation} v${options.version} is in status="draft" and cannot be called.`);
+                }
+                // Build the ctx. Adapters supply richer ctx; .call provides the
+                // minimum needed for unit tests + harness.
+                const ctx = {
+                    input,
+                    user,
+                    container,
+                    ...(ctxExtra ?? {}),
+                };
+                if (!handler) {
+                    throw new Error(`Resolver ${options.operation} v${options.version} has no handler. Call .use(async (ctx) => ...) before mounting.`);
+                }
+                // Compose middlewares (onion) around the handler.
+                let i = -1;
+                let result;
+                const dispatch = async (idx) => {
+                    if (idx <= i)
+                        throw new Error("next() called multiple times");
+                    i = idx;
+                    if (idx < steps.length) {
+                        const step = steps[idx];
+                        if (step.$kind === "middleware") {
+                            await step.fn(ctx, () => dispatch(idx + 1));
+                        }
+                        else if (step.when === "before") {
+                            await step.fn(ctx);
+                            await dispatch(idx + 1);
+                        }
+                        else {
+                            // after hooks run on the way back up — handled below.
+                            await dispatch(idx + 1);
+                            await step.fn(ctx, result);
+                        }
+                    }
+                    else {
+                        // Handler.
+                        result = (await handler(ctx)) ?? undefined;
+                    }
+                };
+                await dispatch(0);
+                return result;
+            },
+        };
+        return def;
+    };
+    return buildResolver([], undefined);
+}
+/** Type narrow. */
+export const isResolver = (x) => typeof x === "object" && x !== null && x.$kind === "resolver";
+//# sourceMappingURL=define-resolver.js.map

package/dist/define-resolver.js.map

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