@nwire/handler 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alex Gefter / 200apps Ltd.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,64 @@
+# @nwire/handler
+
+> Operation primitive — one shape for action / query / resolver, usable from any transport.
+
+## What it is
+
+`defineHandler(name, config)` describes a single operation: input schema, response shape, the function. `execute(handler, input, ctx?)` runs one. Same shape whether the caller is HTTP, a queue worker, a CLI command, or an MCP tool. No framework lock-in — a foreign host (Express, Fastify, NestJS) can mount a handler with two lines of glue.
+
+## Install
+
+```bash
+pnpm add @nwire/handler
+```
+
+## Standalone use
+
+For developers who want a portable operation primitive without pulling in the rest of Nwire. Define a handler once, run it from anywhere.
+
+```ts
+import { defineHandler, execute, ok } from "@nwire/handler";
+import { z } from "zod";
+
+const createUser = defineHandler("createUser", {
+  input: z.object({ email: z.string().email() }),
+  handler: async ({ input }) => ok({ id: crypto.randomUUID(), email: input.email }),
+});
+
+// Run it directly:
+const res = await execute(createUser, { email: "a@b.co" });
+
+// Or mount in Express:
+app.post("/users", async (req, res) => {
+  const out = await execute(createUser, req.body);
+  res.status(out.status).json(out.body);
+});
+```
+
+## Within nwire-app
+
+For developers using this package as part of the Nwire stack. Every Nwire transport (`@nwire/http`, `@nwire/queue`, `@nwire/mcp`) speaks this exact shape; `@nwire/forge`'s `defineAction` / `defineQuery` are flavored sugar over `defineHandler`.
+
+```ts
+import { defineAction } from "@nwire/forge"; // sugar over defineHandler
+import { httpInterface, post } from "@nwire/http";
+
+const createUser = defineAction("createUser", {
+  input: z.object({ email: z.string().email() }),
+  handler: async ({ input }) => ({ id: crypto.randomUUID(), email: input.email }),
+});
+
+const api = httpInterface("api").wire(post("/users", createUser));
+```
+
+## API
+
+- `defineHandler(name, config)` — declare an operation: `{ input, handler, returns?, errors?, summary?, policy?, emits? }`.
+- `execute(handler, input, ctx?)` — run one; returns a response envelope.
+- `defineResource(...)` / `defineError(...)` — REST resource + typed error definitions.
+- Response factories: `ok` / `created` / `accepted` / `noContent` / `notFound` / etc.
+
+## See also
+
+- [Architecture sketch §08 — Handler, the operation](../../architecture-sketch.html#handler)
+- Sibling packages: [@nwire/hooks](../nwire-hooks), [@nwire/interface](../nwire-interface), [@nwire/http](../nwire-http)

package/dist/__tests__/define-handler.test.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Smoke tests for the `@nwire/handler` standalone primitives.
+ *
+ * Verifies:
+ *   - `defineHandler` produces a value-shaped definition + .run accessor
+ *   - `execute` validates input against the schema, throws on bad input
+ *   - `execute` invokes the handler with the parsed input
+ *   - `defineError` / `NwireError` typed throwable contract
+ *   - response factories (ok/created/accepted/noContent) return tagged instances
+ *   - `defineResource` projects records through declared `public` fields
+ *   - `pipe()` composes middleware + hooks in declaration order
+ *
+ * These are deliberately minimal — they document the standalone public
+ * surface. Full coverage of the chained DX (transports, runtime,
+ * middleware execution) lives in forge / http / queue test suites.
+ */
+export {};
+//# sourceMappingURL=define-handler.test.d.ts.map

package/dist/__tests__/define-handler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-handler.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/define-handler.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/__tests__/define-handler.test.js

@@ -0,0 +1,112 @@
+/**
+ * Smoke tests for the `@nwire/handler` standalone primitives.
+ *
+ * Verifies:
+ *   - `defineHandler` produces a value-shaped definition + .run accessor
+ *   - `execute` validates input against the schema, throws on bad input
+ *   - `execute` invokes the handler with the parsed input
+ *   - `defineError` / `NwireError` typed throwable contract
+ *   - response factories (ok/created/accepted/noContent) return tagged instances
+ *   - `defineResource` projects records through declared `public` fields
+ *   - `pipe()` composes middleware + hooks in declaration order
+ *
+ * These are deliberately minimal — they document the standalone public
+ * surface. Full coverage of the chained DX (transports, runtime,
+ * middleware execution) lives in forge / http / queue test suites.
+ */
+import { describe, it, expect } from "vitest";
+import { z } from "zod";
+import { defineHandler, execute, defineError, NwireError, isNwireError, defineResource, defineMiddleware, defineHook, pipe, ok, created, accepted, noContent, isResponseInstance, } from "../handler-index.js";
+describe("defineHandler", () => {
+    it("returns a value with $kind, name, config, .run", () => {
+        const h = defineHandler("noop", {
+            handler: async () => 42,
+        });
+        expect(h.$kind).toBe("handler");
+        expect(h.name).toBe("noop");
+        expect(typeof h.run).toBe("function");
+    });
+    it("execute() parses input against the declared schema", async () => {
+        const Echo = defineHandler("echo", {
+            input: z.object({ msg: z.string() }),
+            handler: async ({ input }) => input.msg,
+        });
+        const result = await execute(Echo, { msg: "hello" });
+        expect(result).toBe("hello");
+    });
+    it("execute() throws when input violates the schema", async () => {
+        const Echo = defineHandler("echo", {
+            input: z.object({ msg: z.string() }),
+            handler: async ({ input }) => input.msg,
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        await expect(execute(Echo, { msg: 123 })).rejects.toBeDefined();
+    });
+    it("execute() works without an input schema", async () => {
+        const Health = defineHandler("health", {
+            handler: async () => ({ status: "up" }),
+        });
+        expect(await execute(Health, undefined)).toEqual({ status: "up" });
+    });
+});
+describe("defineError + NwireError", () => {
+    it("produces a throwable that is both Error and NwireError", () => {
+        const Boom = defineError({ code: "BOOM", status: 418, summary: "boom" });
+        expect(Boom).toBeInstanceOf(Error);
+        expect(Boom).toBeInstanceOf(NwireError);
+        expect(isNwireError(Boom)).toBe(true);
+        expect(Boom.code).toBe("BOOM");
+        expect(Boom.status).toBe(418);
+    });
+    it(".with() returns a contextualized clone", () => {
+        const Boom = defineError({ code: "BOOM", status: 418, summary: "boom" });
+        const withCtx = Boom.with({ resourceId: "abc" });
+        expect(withCtx.code).toBe("BOOM");
+        expect(withCtx.context).toEqual({ resourceId: "abc" });
+    });
+});
+describe("response factories", () => {
+    it("ok() returns 200 instances; created() returns 201", () => {
+        const okI = ok()();
+        expect(okI.status).toBe(200);
+        expect(isResponseInstance(okI)).toBe(true);
+        const createdI = created()();
+        expect(createdI.status).toBe(201);
+        const acceptedI = accepted()();
+        expect(acceptedI.status).toBe(202);
+        const empty = noContent()();
+        expect(empty.status).toBe(204);
+    });
+});
+describe("defineResource", () => {
+    it("projects records through declared public fields", () => {
+        const Wash = defineResource("Wash", {
+            schema: z.object({ id: z.string(), secret: z.string(), name: z.string() }),
+            public: ["id", "name"],
+        });
+        const out = Wash.project({ id: "1", secret: "x", name: "Quick" });
+        expect(out).toEqual({ id: "1", name: "Quick" });
+    });
+    it("returns examples by name", () => {
+        const Wash = defineResource("Wash", {
+            schema: z.object({ id: z.string(), name: z.string() }),
+            examples: { quick: { id: "1", name: "Quick" } },
+        });
+        expect(Wash.example("quick")).toEqual({ id: "1", name: "Quick" });
+        expect(() => Wash.example("missing")).toThrow();
+    });
+});
+describe("pipe / defineMiddleware / defineHook", () => {
+    it("flattens nested pipes and tags steps", () => {
+        const a = defineMiddleware("a", async (_ctx, next) => { await next(); });
+        const b = defineMiddleware("b", async (_ctx, next) => { await next(); });
+        const after = defineHook("after", "audit", () => undefined);
+        const inner = pipe(a, b);
+        const outer = pipe(inner, after);
+        expect(outer.$kind).toBe("pipe");
+        expect(outer.steps).toHaveLength(3);
+        expect(outer.steps[0].$kind).toBe("middleware");
+        expect(outer.steps[2].$kind).toBe("hook");
+    });
+});
+//# sourceMappingURL=define-handler.test.js.map

package/dist/__tests__/define-handler.test.js.map

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

package/dist/define-error.d.ts

@@ -0,0 +1,59 @@
+/**
+ * `defineError` — a named, typed, throwable error value.
+ *
+ *   const WashInProgress = defineError({
+ *     code:    "WASH_IN_PROGRESS",
+ *     status:  409,
+ *     summary: "Station already has an unfinished wash",
+ *   });
+ *
+ *   // In a resolver handler:
+ *   if (active) throw WashInProgress;
+ *
+ * Each call site reuses the SAME instance (immutable). Transports detect
+ * `instanceof NwireError`, read `.code` + `.status` + `.summary`, render
+ * the right shape per medium:
+ *   - REST     → JSON body `{ code, message }` with the declared status
+ *   - GraphQL  → error with `extensions: { code }`
+ *   - CLI      → stderr message + exit status
+ */
+export interface ErrorMeta {
+    readonly code: string;
+    readonly status: number;
+    readonly summary: string;
+    readonly description?: string;
+    readonly tags?: readonly string[];
+}
+export interface ErrorDefinition extends ErrorMeta {
+    readonly $kind: "error";
+}
+/**
+ * Concrete Error subclass — thrown by domain code, caught by transport.
+ * The `defineError(...)` result is an instance of this class.
+ */
+export declare class NwireError extends Error implements ErrorDefinition {
+    readonly $kind: "error";
+    readonly code: string;
+    readonly status: number;
+    readonly summary: string;
+    readonly description?: string;
+    readonly tags?: readonly string[];
+    constructor(meta: ErrorMeta);
+    /**
+     * Build a fresh error instance with the same metadata but additional
+     * runtime context — e.g., the resource id that triggered it.
+     */
+    with(context: Record<string, unknown>): NwireError & {
+        readonly context: Record<string, unknown>;
+    };
+}
+export declare function defineError(meta: ErrorMeta): NwireError;
+/** Type narrow. */
+export declare function isNwireError(x: unknown): x is NwireError;
+export declare const Unauthorized: NwireError;
+export declare const Forbidden: NwireError;
+export declare const NotFound: NwireError;
+export declare const Gone: NwireError;
+export declare const BadRequest: NwireError;
+export declare const Conflict: NwireError;
+//# sourceMappingURL=define-error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-error.d.ts","sourceRoot":"","sources":["../src/define-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CAKzB;AAED;;;GAGG;AACH,qBAAa,UAAW,SAAQ,KAAM,YAAW,eAAe;IAC9D,QAAQ,CAAC,KAAK,EAAG,OAAO,CAAU;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;gBAEtB,IAAI,EAAE,SAAS;IAU3B;;;OAGG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,UAAU,GAAG;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;CAK9D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,CAEvD;AAED,mBAAmB;AACnB,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,UAAU,CAExD;AAGD,eAAO,MAAM,YAAY,YAIvB,CAAC;AAEH,eAAO,MAAM,SAAS,YAIpB,CAAC;AAEH,eAAO,MAAM,QAAQ,YAInB,CAAC;AAEH,eAAO,MAAM,IAAI,YAIf,CAAC;AAEH,eAAO,MAAM,UAAU,YAIrB,CAAC;AAEH,eAAO,MAAM,QAAQ,YAInB,CAAC"}

package/dist/define-error.js

@@ -0,0 +1,88 @@
+/**
+ * `defineError` — a named, typed, throwable error value.
+ *
+ *   const WashInProgress = defineError({
+ *     code:    "WASH_IN_PROGRESS",
+ *     status:  409,
+ *     summary: "Station already has an unfinished wash",
+ *   });
+ *
+ *   // In a resolver handler:
+ *   if (active) throw WashInProgress;
+ *
+ * Each call site reuses the SAME instance (immutable). Transports detect
+ * `instanceof NwireError`, read `.code` + `.status` + `.summary`, render
+ * the right shape per medium:
+ *   - REST     → JSON body `{ code, message }` with the declared status
+ *   - GraphQL  → error with `extensions: { code }`
+ *   - CLI      → stderr message + exit status
+ */
+/**
+ * Concrete Error subclass — thrown by domain code, caught by transport.
+ * The `defineError(...)` result is an instance of this class.
+ */
+export class NwireError extends Error {
+    $kind = "error";
+    code;
+    status;
+    summary;
+    description;
+    tags;
+    constructor(meta) {
+        super(meta.summary);
+        this.name = meta.code;
+        this.code = meta.code;
+        this.status = meta.status;
+        this.summary = meta.summary;
+        this.description = meta.description;
+        this.tags = meta.tags;
+    }
+    /**
+     * Build a fresh error instance with the same metadata but additional
+     * runtime context — e.g., the resource id that triggered it.
+     */
+    with(context) {
+        const next = new NwireError(this);
+        Object.assign(next, { context });
+        return next;
+    }
+}
+export function defineError(meta) {
+    return new NwireError(meta);
+}
+/** Type narrow. */
+export function isNwireError(x) {
+    return x instanceof NwireError;
+}
+// Built-in errors every transport should know.
+export const Unauthorized = defineError({
+    code: "UNAUTHORIZED",
+    status: 401,
+    summary: "Authentication required.",
+});
+export const Forbidden = defineError({
+    code: "FORBIDDEN",
+    status: 403,
+    summary: "Caller is not authorized to perform this action.",
+});
+export const NotFound = defineError({
+    code: "NOT_FOUND",
+    status: 404,
+    summary: "Requested resource not found.",
+});
+export const Gone = defineError({
+    code: "GONE",
+    status: 410,
+    summary: "Resource is permanently gone (sunset endpoint).",
+});
+export const BadRequest = defineError({
+    code: "BAD_REQUEST",
+    status: 400,
+    summary: "Request shape is invalid (separate from zod-driven 400s on schema mismatch).",
+});
+export const Conflict = defineError({
+    code: "CONFLICT",
+    status: 409,
+    summary: "Request conflicts with the current state of the resource.",
+});
+//# sourceMappingURL=define-error.js.map

package/dist/define-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-error.js","sourceRoot":"","sources":["../src/define-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAkBH;;;GAGG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,KAAK,GAAG,OAAgB,CAAC;IACzB,IAAI,CAAS;IACb,MAAM,CAAS;IACf,OAAO,CAAS;IAChB,WAAW,CAAU;IACrB,IAAI,CAAqB;IAElC,YAAY,IAAe;QACzB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,OAAgC;QAEhC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACjC,OAAO,IAAkE,CAAC;IAC5E,CAAC;CACF;AAED,MAAM,UAAU,WAAW,CAAC,IAAe;IACzC,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,mBAAmB;AACnB,MAAM,UAAU,YAAY,CAAC,CAAU;IACrC,OAAO,CAAC,YAAY,UAAU,CAAC;AACjC,CAAC;AAED,+CAA+C;AAC/C,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC;IACtC,IAAI,EAAE,cAAc;IACpB,MAAM,EAAE,GAAG;IACX,OAAO,EAAE,0BAA0B;CACpC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAC;IACnC,IAAI,EAAE,WAAW;IACjB,MAAM,EAAE,GAAG;IACX,OAAO,EAAE,kDAAkD;CAC5D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG,WAAW,CAAC;IAClC,IAAI,EAAE,WAAW;IACjB,MAAM,EAAE,GAAG;IACX,OAAO,EAAE,+BAA+B;CACzC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,IAAI,GAAG,WAAW,CAAC;IAC9B,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,GAAG;IACX,OAAO,EAAE,iDAAiD;CAC3D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,WAAW,CAAC;IACpC,IAAI,EAAE,aAAa;IACnB,MAAM,EAAE,GAAG;IACX,OAAO,EAAE,8EAA8E;CACxF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG,WAAW,CAAC;IAClC,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE,GAAG;IACX,OAAO,EAAE,2DAA2D;CACrE,CAAC,CAAC"}

package/dist/define-handler.d.ts

@@ -0,0 +1,168 @@
+/**
+ * `defineHandler(name, config)` — the operation primitive.
+ *
+ *   const GetStation = defineHandler("GetStation", {
+ *     input:   z.object({ stationId: z.string() }),
+ *     returns: Station,
+ *     handler: async ({ input, db }) => db.stations.findById(input.stationId),
+ *   });
+ *
+ * The shape is universal — same primitive whether the operation is exposed
+ * via HTTP, queue, MCP, CLI, or invoked directly via `execute(handler, input)`.
+ * Every transport binds via its own `(binding, handler, options)` signature;
+ * the binding narrows the input contract at the boundary, the handler is
+ * the lowest-common-denominator inside.
+ *
+ *   See: architecture-sketch.html §08.
+ *
+ * Field placement follows the freq table:
+ *   first-class — input, handler, returns, errors, summary, policy, emits
+ *   meta        — tags, description, version, deprecated, successor
+ *   settings    — retry, timeout, cache, idempotency
+ *
+ * `meta` + `settings` are open bags; adapters extend them via TS declaration
+ * merging without touching the core type.
+ *
+ * NOTE: forge has its own `defineHandler(action, fn)` that binds a handler
+ * to an existing `ActionDefinition`. That signature stays inside `@nwire/forge`
+ * because it depends on the action machinery. The standalone version lives
+ * here because every transport needs it without the forge surface.
+ */
+import type { z } from "zod";
+import type { ZodTypeAny } from "@nwire/messages";
+import type { Container } from "@nwire/container";
+import { type Logger } from "@nwire/logger";
+import type { ErrorDefinition } from "./define-error.js";
+import type { ResponseSpec, ListResponseSpec } from "./response.js";
+import type { ResourceDefinition } from "./define-resource.js";
+/** Bags extensible via TS declaration merging — adapters add fields here. */
+export interface HandlerMeta {
+    readonly tags?: readonly string[];
+    readonly description?: string;
+    readonly version?: number;
+    readonly deprecated?: boolean;
+    readonly successor?: string;
+}
+export interface HandlerSettings {
+    readonly retry?: {
+        attempts: number;
+        backoff?: "linear" | "exponential";
+    };
+    readonly timeout?: number;
+    readonly cache?: {
+        ttl: number;
+    };
+    readonly idempotency?: (input: unknown) => string;
+}
+/**
+ * Context delivered to every handler. The shape is intentionally minimal —
+ * adapters supply richer context via the container (resolve any registered
+ * dep by name + destructure into the handler signature).
+ */
+export interface HandlerContext<TInput = unknown> {
+    /** Parsed + validated input (drawn from `config.input` schema). */
+    readonly input: TInput;
+    /** Look up a dependency by name. Most handlers destructure instead. */
+    resolve<T = unknown>(name: string): T;
+    /** Per-execution container scope. */
+    readonly container: Container;
+    /** Logger scoped to this execution (correlation/causation already attached). */
+    readonly logger: Logger;
+    /** Free-form bag for transport-specific extras (raw request, MCP progress, …). */
+    readonly transport?: Record<string, unknown>;
+}
+/**
+ * `returns` may be a single resource, a single response spec, or an array
+ * of response specs (e.g. `[created(Station), accepted(StationHandle)]`).
+ */
+export type HandlerReturnsSpec = ResourceDefinition | ResponseSpec | ListResponseSpec<ResourceDefinition> | ReadonlyArray<ResponseSpec | ListResponseSpec<ResourceDefinition>>;
+/**
+ * Policy: a tag (`"admin"`), a list of tags (`["admin", "operator"]`), or
+ * a tuple of `[action, subject]` for RBAC-style policies. Adapters
+ * interpret the value per their authorization model.
+ */
+export type HandlerPolicy = string | readonly string[] | readonly [string, string];
+export interface HandlerConfig<TInputSchema extends ZodTypeAny | undefined = ZodTypeAny | undefined, TOutput = unknown> {
+    /** Input schema. Optional for zero-arg handlers (health checks, listings without filters). */
+    readonly input?: TInputSchema;
+    /** The implementation. Receives the typed input + context. */
+    readonly handler: (ctx: HandlerContext<TInputSchema extends ZodTypeAny ? z.output<TInputSchema> : undefined>) => TOutput | Promise<TOutput>;
+    /** Documented response shape(s). Drives OpenAPI + runtime body validation. */
+    readonly returns?: HandlerReturnsSpec;
+    /** Declared error values this handler may throw. */
+    readonly errors?: readonly ErrorDefinition[];
+    /** Events this handler may emit (action flavour). */
+    readonly emits?: readonly unknown[];
+    /** One-line intent. Surfaces in OpenAPI/MCP descriptions. */
+    readonly summary?: string;
+    /** Authorization policy. Adapters (rbac, authz) consume this. */
+    readonly policy?: HandlerPolicy;
+    /** Rare-field bag — tags, description, version, deprecated, …. */
+    readonly meta?: HandlerMeta;
+    /** Behavior-tuning bag — retry, timeout, cache, idempotency. */
+    readonly settings?: HandlerSettings;
+}
+export interface HandlerDefinition<TInputSchema extends ZodTypeAny | undefined = ZodTypeAny | undefined, TOutput = unknown> {
+    readonly $kind: "handler";
+    readonly name: string;
+    readonly config: HandlerConfig<TInputSchema, TOutput>;
+    /**
+     * Convenience accessor — equivalent to `config.handler`. Lets transports
+     * write `handler.run(ctx)` without reaching into `.config`.
+     */
+    run(ctx: HandlerContext<TInputSchema extends ZodTypeAny ? z.output<TInputSchema> : undefined>): TOutput | Promise<TOutput>;
+}
+/**
+ * Define a handler — the operation primitive.
+ *
+ *   const ListTodos = defineHandler("listTodos", {
+ *     input:   z.object({ status: z.string().optional() }),
+ *     handler: async ({ input, resolve }) => {
+ *       const db = resolve<DB>("db");
+ *       return db.todos.findMany(input);
+ *     },
+ *   });
+ *
+ *   // Direct invocation:
+ *   const todos = await execute(ListTodos, { status: "open" });
+ *
+ *   // HTTP transport:
+ *   api.wire(get("/todos"), ListTodos);
+ *
+ *   // Queue transport (same handler):
+ *   workers.wire(job("listTodos"), ListTodos);
+ */
+export declare function defineHandler<TInputSchema extends ZodTypeAny | undefined, TOutput>(name: string, config: HandlerConfig<TInputSchema, TOutput>): HandlerDefinition<TInputSchema, TOutput>;
+/** Type narrow. */
+export declare function isHandlerDefinition(x: unknown): x is HandlerDefinition;
+/**
+ * Options for `execute()` — transport-agnostic. Adapters can pass a
+ * container so the handler can `resolve()` its deps; if omitted, a
+ * minimal stub container is supplied that throws on resolve.
+ */
+export interface ExecuteOptions {
+    readonly container?: Container;
+    readonly logger?: Logger;
+    readonly transport?: Record<string, unknown>;
+}
+/**
+ * Invoke a handler directly with input. The framework validates input
+ * against the handler's `input` schema (if declared), constructs the
+ * handler context, runs the handler, and returns its result.
+ *
+ *   const todos = await execute(ListTodos, { status: "open" });
+ *
+ * This is the universal "any host can mount it" entry point. Transports
+ * call into `execute()` after parsing the binding's payload; tests call
+ * `execute()` directly to bypass transport machinery.
+ */
+export declare function execute<TInputSchema extends ZodTypeAny | undefined, TOutput>(handler: HandlerDefinition<TInputSchema, TOutput>, input: TInputSchema extends ZodTypeAny ? z.input<TInputSchema> : any, options?: ExecuteOptions): Promise<TOutput>;
+/**
+ * Type alias for a handler-or-callable. Transports `.wire()` accept either
+ * a full `HandlerDefinition` (typed, validated) or a bare async function
+ * (escape hatch for one-liners + health checks).
+ */
+export type HandlerLike<TInput = unknown, TOutput = unknown> = HandlerDefinition<ZodTypeAny | undefined, TOutput> | ((input: TInput) => Promise<TOutput> | TOutput);
+/** Re-exports for the public surface. */
+export type { ResponseInstance } from "./response.js";
+//# sourceMappingURL=define-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-handler.d.ts","sourceRoot":"","sources":["../src/define-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAoB,MAAM,eAAe,CAAC;AACtF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAA;KAAE,CAAC;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;CACnD;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc,CAAC,MAAM,GAAG,OAAO;IAC9C,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC;IACtC,qCAAqC;IACrC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9C;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAC1B,kBAAkB,GAClB,YAAY,GACZ,gBAAgB,CAAC,kBAAkB,CAAC,GACpC,aAAa,CAAC,YAAY,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,CAAC,CAAC;AAEvE;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEnF,MAAM,WAAW,aAAa,CAC5B,YAAY,SAAS,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,EACpE,OAAO,GAAG,OAAO;IAEjB,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,CAChB,GAAG,EAAE,cAAc,CAAC,YAAY,SAAS,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC,KACtF,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC;IACtC,oDAAoD;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,qDAAqD;IACrD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACpC,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,kEAAkE;IAClE,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;CACrC;AAED,MAAM,WAAW,iBAAiB,CAChC,YAAY,SAAS,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,EACpE,OAAO,GAAG,OAAO;IAEjB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACtD;;;OAGG;IACH,GAAG,CACD,GAAG,EAAE,cAAc,CAAC,YAAY,SAAS,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC,GACxF,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAAC,YAAY,SAAS,UAAU,GAAG,SAAS,EAAE,OAAO,EAChF,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,CAAC,YAAY,EAAE,OAAO,CAAC,GAC3C,iBAAiB,CAAC,YAAY,EAAE,OAAO,CAAC,CAS1C;AAED,mBAAmB;AACnB,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,iBAAiB,CAEtE;AAID;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9C;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,OAAO,CAAC,YAAY,SAAS,UAAU,GAAG,SAAS,EAAE,OAAO,EAChF,OAAO,EAAE,iBAAiB,CAAC,YAAY,EAAE,OAAO,CAAC,EAEjD,KAAK,EAAE,YAAY,SAAS,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,GAAG,EACpE,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,OAAO,CAAC,CAkBlB;AA6BD;;;;GAIG;AACH,MAAM,MAAM,WAAW,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IACvD,iBAAiB,CAAC,UAAU,GAAG,SAAS,EAAE,OAAO,CAAC,GAClD,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;AAEpD,yCAAyC;AACzC,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}