@nwire/forge 0.7.0

package/dist/define-external-call.d.ts

@@ -0,0 +1,85 @@
+/**
+ * `defineExternalCall` — declarative HTTP/RPC call going OUT of the system.
+ *
+ *   export const chargeStripe = defineExternalCall({
+ *     name: "stripe.create-payment-intent",
+ *     target: { provider: "stripe", endpoint: "/v1/payment_intents" },
+ *     request: ChargePaymentIntentSchema,
+ *     response: PaymentIntentSchema,
+ *     idempotencyKey: (req) => `charge-${req.orderId}-${req.amount}`,
+ *     slo: { p95LatencyMs: 600, successRate: 0.995 },
+ *     retry: { max: 3, backoff: "exponential" },
+ *   });
+ *
+ * The framework treats external calls as first-class boundaries. The
+ * declaration is pure data; the actual call is performed by a registered
+ * executor (HTTP client adapter / mock in tests / etc.). Studio renders
+ * external calls as boundary stickies in EventStorming and surfaces
+ * declared SLOs alongside observed latency from the telemetry stream.
+ *
+ * Wired at runtime via `ctx.externalCall(definition, request)` — see the
+ * HandlerContext extension in `define-handler.ts`.
+ */
+import type { z } from "zod";
+import type { ZodTypeAny } from "@nwire/messages";
+export interface ExternalCallTarget {
+    /** Free-form provider tag (e.g. `'stripe'`, `'twilio'`). Studio groups by this. */
+    readonly provider: string;
+    /** Path or RPC method on the provider. */
+    readonly endpoint: string;
+    /** Optional environment / region hint. */
+    readonly region?: string;
+}
+export interface ExternalCallSlo {
+    readonly p95LatencyMs?: number;
+    readonly successRate?: number;
+}
+export interface ExternalCallRetry {
+    readonly max: number;
+    readonly backoff?: "exponential" | "fixed";
+    readonly baseDelayMs?: number;
+    readonly maxDelayMs?: number;
+}
+export interface ExternalCallMeta<TRequest extends ZodTypeAny = ZodTypeAny, TResponse extends ZodTypeAny = ZodTypeAny> {
+    readonly name: string;
+    readonly description?: string;
+    readonly target: ExternalCallTarget;
+    readonly request: TRequest;
+    readonly response?: TResponse;
+    /**
+     * Pure key extractor — runtime + Studio use it for idempotent retries
+     * and request dedup. Same shape as `when().idempotencyKey`.
+     */
+    readonly idempotencyKey?: (req: z.output<TRequest>) => string;
+    readonly slo?: ExternalCallSlo;
+    readonly retry?: ExternalCallRetry;
+    readonly tags?: readonly string[];
+}
+export interface ExternalCallDefinition<TRequest extends ZodTypeAny = ZodTypeAny, TResponse extends ZodTypeAny = ZodTypeAny> {
+    readonly $kind: "external-call";
+    readonly name: string;
+    readonly description?: string;
+    readonly target: ExternalCallTarget;
+    readonly request: TRequest;
+    readonly response?: TResponse;
+    readonly idempotencyKey?: (req: z.output<TRequest>) => string;
+    /** Flag for the scanner — boolean form of `idempotencyKey` for the cache. */
+    readonly hasIdempotencyKey: boolean;
+    readonly slo?: ExternalCallSlo;
+    readonly retry?: ExternalCallRetry;
+    readonly tags?: readonly string[];
+}
+export declare function defineExternalCall<TRequest extends ZodTypeAny, TResponse extends ZodTypeAny = ZodTypeAny>(meta: ExternalCallMeta<TRequest, TResponse>): ExternalCallDefinition<TRequest, TResponse>;
+/**
+ * `ExternalCallExecutor` — pluggable transport for a single external call.
+ * Adapters (a Stripe SDK wrapper, a generic HTTP client, a test mock) plug
+ * one of these in at runtime via `runtime.registerExternalCall(def, exec)`.
+ * The runtime owns retry + telemetry + idempotency-key threading; the
+ * executor only performs the actual request and returns the validated
+ * response (or throws).
+ */
+export type ExternalCallExecutor<TRequest extends ZodTypeAny = ZodTypeAny, TResponse extends ZodTypeAny = ZodTypeAny> = (req: z.output<TRequest>, meta: {
+    readonly idempotencyKey?: string;
+    readonly attempt: number;
+}) => Promise<z.output<TResponse>>;
+//# sourceMappingURL=define-external-call.d.ts.map

package/dist/define-external-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-external-call.d.ts","sourceRoot":"","sources":["../src/define-external-call.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,WAAW,kBAAkB;IACjC,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB,CAC/B,QAAQ,SAAS,UAAU,GAAG,UAAU,EACxC,SAAS,SAAS,UAAU,GAAG,UAAU;IAEzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC;IAC9D,QAAQ,CAAC,GAAG,CAAC,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB,CACrC,QAAQ,SAAS,UAAU,GAAG,UAAU,EACxC,SAAS,SAAS,UAAU,GAAG,UAAU;IAEzC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC;IAC9D,6EAA6E;IAC7E,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,GAAG,CAAC,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,SAAS,UAAU,EAC3B,SAAS,SAAS,UAAU,GAAG,UAAU,EACzC,IAAI,EAAE,gBAAgB,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,sBAAsB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAc1F;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,CAC9B,QAAQ,SAAS,UAAU,GAAG,UAAU,EACxC,SAAS,SAAS,UAAU,GAAG,UAAU,IACvC,CACF,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EACvB,IAAI,EAAE;IAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,KACjE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC"}

package/dist/define-external-call.js

@@ -0,0 +1,38 @@
+/**
+ * `defineExternalCall` — declarative HTTP/RPC call going OUT of the system.
+ *
+ *   export const chargeStripe = defineExternalCall({
+ *     name: "stripe.create-payment-intent",
+ *     target: { provider: "stripe", endpoint: "/v1/payment_intents" },
+ *     request: ChargePaymentIntentSchema,
+ *     response: PaymentIntentSchema,
+ *     idempotencyKey: (req) => `charge-${req.orderId}-${req.amount}`,
+ *     slo: { p95LatencyMs: 600, successRate: 0.995 },
+ *     retry: { max: 3, backoff: "exponential" },
+ *   });
+ *
+ * The framework treats external calls as first-class boundaries. The
+ * declaration is pure data; the actual call is performed by a registered
+ * executor (HTTP client adapter / mock in tests / etc.). Studio renders
+ * external calls as boundary stickies in EventStorming and surfaces
+ * declared SLOs alongside observed latency from the telemetry stream.
+ *
+ * Wired at runtime via `ctx.externalCall(definition, request)` — see the
+ * HandlerContext extension in `define-handler.ts`.
+ */
+export function defineExternalCall(meta) {
+    return {
+        $kind: "external-call",
+        name: meta.name,
+        description: meta.description,
+        target: meta.target,
+        request: meta.request,
+        response: meta.response,
+        idempotencyKey: meta.idempotencyKey,
+        hasIdempotencyKey: !!meta.idempotencyKey,
+        slo: meta.slo,
+        retry: meta.retry,
+        tags: meta.tags,
+    };
+}
+//# sourceMappingURL=define-external-call.js.map

package/dist/define-external-call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-external-call.js","sourceRoot":"","sources":["../src/define-external-call.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AA+DH,MAAM,UAAU,kBAAkB,CAGhC,IAA2C;IAC3C,OAAO;QACL,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,iBAAiB,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc;QACxC,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC;AACJ,CAAC"}

package/dist/define-handler.d.ts

@@ -0,0 +1,98 @@
+/**
+ * `defineHandler` — handlers orchestrate and return events.
+ *
+ * The handler reads the world (external APIs, cross-module `request`s), decides
+ * what happened, and returns event(s). It never touches actor state, never
+ * persists, never knows what state any actor is in. State changes happen
+ * inside actors, driven by the events the handler returns.
+ *
+ *   defineHandler(autoGrade, async (input, { request }) => {
+ *     const grade = await request(evaluateGrade, { ... })
+ *     return grade.confidence >= THRESHOLD
+ *       ? AnswerAutoGradedEvent({ ... })
+ *       : AnswerFlaggedEvent({ ... })
+ *   })
+ *
+ * The first argument is the action's `ActionDefinition`. The action carries
+ * the name + schema; the handler reads input typed against the schema. The
+ * returned events route to actors + workflows and commit atomically.
+ *
+ * If the handler does pure side effects (no events to commit), return `void`.
+ */
+import type { z } from "zod";
+import type { ZodTypeAny } from "@nwire/messages";
+import type { Container } from "@nwire/container";
+import type { MessageEnvelope } from "@nwire/envelope";
+import type { EventMessage } from "./event-message.js";
+import type { ActionDefinition } from "./define-action.js";
+import type { ActorDefinition, ActorInstanceView } from "./define-actor.js";
+import type { QueryDefinition } from "./define-query.js";
+import type { ExternalCallDefinition } from "./define-external-call.js";
+import type { Logger } from "@nwire/logger";
+export interface HandlerContext {
+    readonly container: Container;
+    readonly envelope: MessageEnvelope;
+    /** Convenience getter — equivalent to `envelope.messageId`. */
+    readonly requestId: string;
+    /** Look up a dependency by name. Shortcut for `container.resolve(name)`. */
+    resolve<T = unknown>(name: string): T;
+    /**
+     * Logger scoped to this envelope — `messageId`, `correlationId`,
+     * `causationId`, `tenant`, `userId` are auto-attached to every line.
+     * Domain code never threads ids manually.
+     */
+    readonly logger: Logger;
+    /**
+     * Universal "ask and wait." Calls another action by reference, returns its
+     * result. The framework derives a child envelope (same correlationId,
+     * causationId = this handler's messageId) and handles transport routing.
+     */
+    request<TInput, TResult>(action: ActionDefinition<ZodTypeAny>, input: TInput): Promise<TResult>;
+    /**
+     * Read-during-handler — invoke a query (projection-backed read function)
+     * scoped to the envelope's tenant. Used by reactions that need to look up
+     * state to decide what action to dispatch.
+     *
+     * Per ADR-008, queries always read projections, never actor stores. Per
+     * ADR-007, handlers stay pure of state mutation; reads via `query` are the
+     * sanctioned way to inform a handler's decision.
+     */
+    query<TResult = unknown>(query: QueryDefinition<any, any, any>, input: unknown): Promise<TResult>;
+    /**
+     * Fire-and-forget dispatch of another action. Returns when the message is
+     * accepted by the transport, not when the handler completes.
+     */
+    send<TInput>(action: ActionDefinition<ZodTypeAny>, input: TInput): Promise<void>;
+    /**
+     * Load an actor instance by id (envelope.tenant-scoped) and return a view
+     * with `state`, `stateName`, `key`, plus every method declared on the actor
+     * pre-bound to the loaded state. The view is a snapshot — subsequent
+     * dispatches do not refresh it. Re-call `ctx.use` after a dispatch that
+     * mutated the actor to observe the new state.
+     *
+     * Methods are pure: they take state, return event(s) or read values. To
+     * apply an event the method minted, return it from the handler.
+     *
+     *   const submission = await ctx.use(Submission, input.submissionId)
+     *   if (!submission.isGradable()) throw new Error('not gradable')
+     *   return submission.grade(input.verdict)  // event consumed by handler
+     */
+    use<TActor extends ActorDefinition>(actor: TActor, id: string): Promise<ActorInstanceView<TActor>>;
+    /**
+     * Invoke a declared external call (HTTP/RPC to another system). The
+     * runtime threads the declared idempotency key, applies retry policy,
+     * and emits `external.call.started/.completed/.failed` telemetry. The
+     * actual transport is the registered `ExternalCallExecutor` for this
+     * definition; if none is registered the call throws at runtime so
+     * misconfigured wiring surfaces loudly.
+     */
+    externalCall<TRequest extends ZodTypeAny, TResponse extends ZodTypeAny>(call: ExternalCallDefinition<TRequest, TResponse>, request: z.output<TRequest>): Promise<z.output<TResponse>>;
+}
+export type HandlerReturn = void | EventMessage | EventMessage[] | null;
+export interface HandlerDefinition<TSchema extends ZodTypeAny = ZodTypeAny> {
+    readonly $kind: "v3-handler";
+    readonly action: ActionDefinition<TSchema>;
+    readonly handler: (input: z.output<TSchema>, ctx: HandlerContext) => Promise<HandlerReturn> | HandlerReturn;
+}
+export declare function defineHandler<TSchema extends ZodTypeAny>(action: ActionDefinition<TSchema>, handler: HandlerDefinition<TSchema>["handler"]): HandlerDefinition<TSchema>;
+//# 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":"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"}

package/dist/define-handler.js

@@ -0,0 +1,29 @@
+/**
+ * `defineHandler` — handlers orchestrate and return events.
+ *
+ * The handler reads the world (external APIs, cross-module `request`s), decides
+ * what happened, and returns event(s). It never touches actor state, never
+ * persists, never knows what state any actor is in. State changes happen
+ * inside actors, driven by the events the handler returns.
+ *
+ *   defineHandler(autoGrade, async (input, { request }) => {
+ *     const grade = await request(evaluateGrade, { ... })
+ *     return grade.confidence >= THRESHOLD
+ *       ? AnswerAutoGradedEvent({ ... })
+ *       : AnswerFlaggedEvent({ ... })
+ *   })
+ *
+ * The first argument is the action's `ActionDefinition`. The action carries
+ * the name + schema; the handler reads input typed against the schema. The
+ * returned events route to actors + workflows and commit atomically.
+ *
+ * If the handler does pure side effects (no events to commit), return `void`.
+ */
+export function defineHandler(action, handler) {
+    return {
+        $kind: "v3-handler",
+        action,
+        handler,
+    };
+}
+//# sourceMappingURL=define-handler.js.map

package/dist/define-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-handler.js","sourceRoot":"","sources":["../src/define-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AA8FH,MAAM,UAAU,aAAa,CAC3B,MAAiC,EACjC,OAA8C;IAE9C,OAAO;QACL,KAAK,EAAE,YAAY;QACnB,MAAM;QACN,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/define-inbound-webhook.d.ts

@@ -0,0 +1,82 @@
+/**
+ * `defineInboundWebhook` — declarative entry point for callbacks FROM
+ * external systems (Stripe events, Twilio status, partner pushes, …).
+ *
+ *   export const stripeWebhook = defineInboundWebhook({
+ *     name: "stripe.payment-events",
+ *     source: "stripe",
+ *     path: "/webhooks/stripe",
+ *     verifySignature: (rawBody, headers, secret) => stripeLib.verify(...),
+ *     dedupe: { window: "24h", keyFrom: (msg) => msg.id },
+ *     schema: StripeWebhookSchema,
+ *     routes: {
+ *       "payment_intent.succeeded": confirmPayment,
+ *       "payment_intent.payment_failed": markPaymentFailed,
+ *     },
+ *   });
+ *
+ * Wire-level handlers (`@nwire/http`) mount the route and on each request:
+ *   1. Run `verifySignature` (deny if invalid)
+ *   2. Run `dedupe.keyFrom` and check the inbox (skip if already seen)
+ *   3. Parse the payload through `schema`
+ *   4. Look up the discriminator field in `routes` → dispatch the action
+ *
+ * Studio renders inbound webhooks as boundary stickies and surfaces
+ * signature-failed / dedup hits / unrouted events as drift signals.
+ */
+import type { ZodTypeAny } from "@nwire/messages";
+import type { ActionDefinition } from "./define-action.js";
+export interface WebhookSignatureVerifier {
+    (req: {
+        readonly rawBody: string;
+        readonly headers: Readonly<Record<string, string>>;
+        readonly secret?: string;
+    }): boolean | Promise<boolean>;
+}
+export interface WebhookDedupe {
+    /** Window for dedup memory. Parseable duration: `'24h'`, `'7d'`. */
+    readonly window: string;
+    /** Pure extractor: return the unique id from the parsed body. */
+    readonly keyFrom: (msg: unknown) => string;
+}
+export interface InboundWebhookMeta<TSchema extends ZodTypeAny = ZodTypeAny> {
+    readonly name: string;
+    readonly description?: string;
+    /** Provider tag (e.g. `'stripe'`, `'twilio'`). */
+    readonly source: string;
+    /** HTTP path the wire mounts this on. */
+    readonly path: string;
+    /** Optional signature verifier — recommended for production. */
+    readonly verifySignature?: WebhookSignatureVerifier;
+    /** Optional dedupe config — Studio surfaces dedup hits. */
+    readonly dedupe?: WebhookDedupe;
+    /** Body schema. */
+    readonly schema: TSchema;
+    /**
+     * Discriminator field inside the parsed body. Default `'type'`.
+     * Webhook providers like Stripe use `type` (`payment_intent.succeeded`);
+     * Twilio uses `MessageStatus`; etc.
+     */
+    readonly discriminator?: string;
+    /**
+     * Map of discriminator value → action to dispatch. Studio draws an edge
+     * from this webhook to each routed action.
+     */
+    readonly routes: Readonly<Record<string, ActionDefinition>>;
+    readonly tags?: readonly string[];
+}
+export interface InboundWebhookDefinition<TSchema extends ZodTypeAny = ZodTypeAny> {
+    readonly $kind: "inbound-webhook";
+    readonly name: string;
+    readonly description?: string;
+    readonly source: string;
+    readonly path: string;
+    readonly verifySignature?: WebhookSignatureVerifier;
+    readonly dedupe?: WebhookDedupe;
+    readonly schema: TSchema;
+    readonly discriminator: string;
+    readonly routes: Readonly<Record<string, ActionDefinition>>;
+    readonly tags?: readonly string[];
+}
+export declare function defineInboundWebhook<TSchema extends ZodTypeAny>(meta: InboundWebhookMeta<TSchema>): InboundWebhookDefinition<TSchema>;
+//# sourceMappingURL=define-inbound-webhook.d.ts.map

package/dist/define-inbound-webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-inbound-webhook.d.ts","sourceRoot":"","sources":["../src/define-inbound-webhook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,WAAW,wBAAwB;IACvC,CAAC,GAAG,EAAE;QACJ,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;KAC1B,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAC;CAC5C;AAED,MAAM,WAAW,kBAAkB,CAAC,OAAO,SAAS,UAAU,GAAG,UAAU;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,QAAQ,CAAC,eAAe,CAAC,EAAE,wBAAwB,CAAC;IACpD,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,mBAAmB;IACnB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB,CAAC,OAAO,SAAS,UAAU,GAAG,UAAU;IAC/E,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,CAAC,EAAE,wBAAwB,CAAC;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,wBAAgB,oBAAoB,CAAC,OAAO,SAAS,UAAU,EAC7D,IAAI,EAAE,kBAAkB,CAAC,OAAO,CAAC,GAChC,wBAAwB,CAAC,OAAO,CAAC,CAcnC"}

package/dist/define-inbound-webhook.js

@@ -0,0 +1,42 @@
+/**
+ * `defineInboundWebhook` — declarative entry point for callbacks FROM
+ * external systems (Stripe events, Twilio status, partner pushes, …).
+ *
+ *   export const stripeWebhook = defineInboundWebhook({
+ *     name: "stripe.payment-events",
+ *     source: "stripe",
+ *     path: "/webhooks/stripe",
+ *     verifySignature: (rawBody, headers, secret) => stripeLib.verify(...),
+ *     dedupe: { window: "24h", keyFrom: (msg) => msg.id },
+ *     schema: StripeWebhookSchema,
+ *     routes: {
+ *       "payment_intent.succeeded": confirmPayment,
+ *       "payment_intent.payment_failed": markPaymentFailed,
+ *     },
+ *   });
+ *
+ * Wire-level handlers (`@nwire/http`) mount the route and on each request:
+ *   1. Run `verifySignature` (deny if invalid)
+ *   2. Run `dedupe.keyFrom` and check the inbox (skip if already seen)
+ *   3. Parse the payload through `schema`
+ *   4. Look up the discriminator field in `routes` → dispatch the action
+ *
+ * Studio renders inbound webhooks as boundary stickies and surfaces
+ * signature-failed / dedup hits / unrouted events as drift signals.
+ */
+export function defineInboundWebhook(meta) {
+    return {
+        $kind: "inbound-webhook",
+        name: meta.name,
+        description: meta.description,
+        source: meta.source,
+        path: meta.path,
+        verifySignature: meta.verifySignature,
+        dedupe: meta.dedupe,
+        schema: meta.schema,
+        discriminator: meta.discriminator ?? "type",
+        routes: meta.routes,
+        tags: meta.tags,
+    };
+}
+//# sourceMappingURL=define-inbound-webhook.js.map

package/dist/define-inbound-webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-inbound-webhook.js","sourceRoot":"","sources":["../src/define-inbound-webhook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AA6DH,MAAM,UAAU,oBAAoB,CAClC,IAAiC;IAEjC,OAAO;QACL,KAAK,EAAE,iBAAiB;QACxB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,MAAM;QAC3C,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC;AACJ,CAAC"}

package/dist/define-inbox.d.ts

@@ -0,0 +1,40 @@
+/**
+ * `defineInbox` — declarative inbound dedupe window.
+ *
+ *   export const ordersInbox = defineInbox({
+ *     name: "orders",
+ *     window: "7d",
+ *     on: [orderConfirmedFromPartner],
+ *   });
+ *
+ * An inbox tracks message ids that have already been processed. At-least-once
+ * delivery from a bus or webhook source can deliver the same message twice;
+ * the inbox short-circuits the duplicate.
+ *
+ * The framework treats inboxes as first-class so Studio can render them
+ * as boundary stickies and surface dedup-hit rates as health signals.
+ *
+ * Runtime: a registered `InboxStore` adapter holds seen-keys with a TTL.
+ * Used by `defineInboundWebhook` (when the webhook declares `dedupe`) and
+ * by inbound bus events (when the consuming action declares idempotency).
+ */
+import type { ActionDefinition } from "./define-action.js";
+export interface InboxMeta {
+    readonly name: string;
+    readonly description?: string;
+    /** TTL window for the dedup memory. Parseable duration: `'24h'`, `'7d'`. */
+    readonly window: string;
+    /** Actions this inbox guards — Studio uses this to draw arrows. */
+    readonly on: readonly ActionDefinition[];
+    readonly tags?: readonly string[];
+}
+export interface InboxDefinition {
+    readonly $kind: "inbox";
+    readonly name: string;
+    readonly description?: string;
+    readonly window: string;
+    readonly on: readonly ActionDefinition[];
+    readonly tags?: readonly string[];
+}
+export declare function defineInbox(meta: InboxMeta): InboxDefinition;
+//# sourceMappingURL=define-inbox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-inbox.d.ts","sourceRoot":"","sources":["../src/define-inbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,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,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,eAAe,CAS5D"}

package/dist/define-inbox.js

@@ -0,0 +1,31 @@
+/**
+ * `defineInbox` — declarative inbound dedupe window.
+ *
+ *   export const ordersInbox = defineInbox({
+ *     name: "orders",
+ *     window: "7d",
+ *     on: [orderConfirmedFromPartner],
+ *   });
+ *
+ * An inbox tracks message ids that have already been processed. At-least-once
+ * delivery from a bus or webhook source can deliver the same message twice;
+ * the inbox short-circuits the duplicate.
+ *
+ * The framework treats inboxes as first-class so Studio can render them
+ * as boundary stickies and surface dedup-hit rates as health signals.
+ *
+ * Runtime: a registered `InboxStore` adapter holds seen-keys with a TTL.
+ * Used by `defineInboundWebhook` (when the webhook declares `dedupe`) and
+ * by inbound bus events (when the consuming action declares idempotency).
+ */
+export function defineInbox(meta) {
+    return {
+        $kind: "inbox",
+        name: meta.name,
+        description: meta.description,
+        window: meta.window,
+        on: meta.on,
+        tags: meta.tags,
+    };
+}
+//# sourceMappingURL=define-inbox.js.map

package/dist/define-inbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-inbox.js","sourceRoot":"","sources":["../src/define-inbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAuBH,MAAM,UAAU,WAAW,CAAC,IAAe;IACzC,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC;AACJ,CAAC"}

package/dist/define-initializer.d.ts

@@ -0,0 +1,54 @@
+/**
+ * `defineInitializer` — app lifecycle hook.
+ *
+ * Two-phase boot (register → boot) + reverse-order shutdown. Initializers
+ * live in `apps/<app>/wires/initializers/` and have access to the app's
+ * container + config + the app itself.
+ *
+ *   export const persistence = defineInitializer("persistence", {
+ *     register: ({ container, config }) => {
+ *       container.register("db", () => new PrismaClient(config.dbUrl));
+ *     },
+ *     boot: async ({ container }) => {
+ *       await container.resolve("db").$connect();
+ *     },
+ *     shutdown: async ({ container }) => {
+ *       await container.resolve("db").$disconnect();
+ *     },
+ *   });
+ *
+ * Lifecycle:
+ *   1. App starts. All initializers' `register` run first (in declared order).
+ *   2. All initializers' `boot` run next (in declared order). Providers
+ *      registered in step 1 are now available.
+ *   3. App serves traffic.
+ *   4. On stop, `shutdown` runs in REVERSE order so things that depend on
+ *      others get shut down first.
+ *
+ * Distinct from `defineProvider` (which is a single resolvable value) and
+ * `definePlugin` (which carries middleware + actor hooks + routes too).
+ * Initializers are pure lifecycle.
+ */
+export type InitContainer = any;
+export type InitConfig = Record<string, any>;
+export type InitApp = any;
+export interface InitializerContext {
+    readonly container: InitContainer;
+    readonly config: InitConfig;
+    readonly app: InitApp;
+}
+export interface InitializerSpec {
+    /** Register providers/values into the container. Runs before any boot. */
+    readonly register?: (ctx: InitializerContext) => void | Promise<void>;
+    /** Boot — initializers run after every `register` has completed. */
+    readonly boot?: (ctx: InitializerContext) => void | Promise<void>;
+    /** Shutdown — runs in REVERSE order on app stop. */
+    readonly shutdown?: (ctx: InitializerContext) => void | Promise<void>;
+}
+export interface InitializerDefinition extends InitializerSpec {
+    readonly $kind: "initializer";
+    readonly name: string;
+}
+export declare function defineInitializer(name: string, spec: InitializerSpec): InitializerDefinition;
+export declare const isInitializer: (x: unknown) => x is InitializerDefinition;
+//# sourceMappingURL=define-initializer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-initializer.d.ts","sourceRoot":"","sources":["../src/define-initializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC;AAEhC,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAE7C,MAAM,MAAM,OAAO,GAAG,GAAG,CAAC;AAE1B,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,oEAAoE;IACpE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,eAAe,GACpB,qBAAqB,CAEvB;AAED,eAAO,MAAM,aAAa,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,qBAGI,CAAC"}

package/dist/define-initializer.js

@@ -0,0 +1,38 @@
+/**
+ * `defineInitializer` — app lifecycle hook.
+ *
+ * Two-phase boot (register → boot) + reverse-order shutdown. Initializers
+ * live in `apps/<app>/wires/initializers/` and have access to the app's
+ * container + config + the app itself.
+ *
+ *   export const persistence = defineInitializer("persistence", {
+ *     register: ({ container, config }) => {
+ *       container.register("db", () => new PrismaClient(config.dbUrl));
+ *     },
+ *     boot: async ({ container }) => {
+ *       await container.resolve("db").$connect();
+ *     },
+ *     shutdown: async ({ container }) => {
+ *       await container.resolve("db").$disconnect();
+ *     },
+ *   });
+ *
+ * Lifecycle:
+ *   1. App starts. All initializers' `register` run first (in declared order).
+ *   2. All initializers' `boot` run next (in declared order). Providers
+ *      registered in step 1 are now available.
+ *   3. App serves traffic.
+ *   4. On stop, `shutdown` runs in REVERSE order so things that depend on
+ *      others get shut down first.
+ *
+ * Distinct from `defineProvider` (which is a single resolvable value) and
+ * `definePlugin` (which carries middleware + actor hooks + routes too).
+ * Initializers are pure lifecycle.
+ */
+export function defineInitializer(name, spec) {
+    return { $kind: "initializer", name, ...spec };
+}
+export const isInitializer = (x) => typeof x === "object" &&
+    x !== null &&
+    x.$kind === "initializer";
+//# sourceMappingURL=define-initializer.js.map

package/dist/define-initializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-initializer.js","sourceRoot":"","sources":["../src/define-initializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AA6BH,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,IAAqB;IAErB,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAU,EAA8B,EAAE,CACtE,OAAO,CAAC,KAAK,QAAQ;IACrB,CAAC,KAAK,IAAI;IACT,CAAyB,CAAC,KAAK,KAAK,aAAa,CAAC"}

package/dist/define-middleware.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Middleware primitives — re-exported from `@nwire/handler`.
+ *
+ * The canonical implementation moved to `@nwire/handler`. Forge keeps
+ * the same export names so existing call sites compile unchanged.
+ */
+export { defineMiddleware, defineHook, pipe, unwindPipe, isMiddleware, isHook, isPipe, type MiddlewareDefinition, type HookDefinition, type MiddlewarePipe, type PipeStep, type ChainFn, type ResolverCtx, type Next, } from "@nwire/handler";
+//# sourceMappingURL=define-middleware.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-middleware.d.ts","sourceRoot":"","sources":["../src/define-middleware.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,IAAI,EACJ,UAAU,EACV,YAAY,EACZ,MAAM,EACN,MAAM,EACN,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,IAAI,GACV,MAAM,gBAAgB,CAAC"}

package/dist/define-middleware.js

@@ -0,0 +1,8 @@
+/**
+ * Middleware primitives — re-exported from `@nwire/handler`.
+ *
+ * The canonical implementation moved to `@nwire/handler`. Forge keeps
+ * the same export names so existing call sites compile unchanged.
+ */
+export { defineMiddleware, defineHook, pipe, unwindPipe, isMiddleware, isHook, isPipe, } from "@nwire/handler";
+//# sourceMappingURL=define-middleware.js.map

package/dist/define-middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-middleware.js","sourceRoot":"","sources":["../src/define-middleware.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,IAAI,EACJ,UAAU,EACV,YAAY,EACZ,MAAM,EACN,MAAM,GAQP,MAAM,gBAAgB,CAAC"}

package/dist/define-model.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `defineModel` — re-exported from `@nwire/handler` as `defineResource`.
+ *
+ * The canonical name for the interface/response shape primitive moved
+ * to `defineResource` in `@nwire/handler` as part of the v1.0 sealed-
+ * architecture extraction. Forge re-exports under both names so existing
+ * call sites compile unchanged.
+ */
+export { defineModel, isModelDefinition, defineResource, isResourceDefinition, type ModelDefinition, type DefineModelOptions, type ResourceDefinition, type DefineResourceOptions, } from "@nwire/handler";
+//# sourceMappingURL=define-model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-model.d.ts","sourceRoot":"","sources":["../src/define-model.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,WAAW,EACX,iBAAiB,EAGjB,cAAc,EACd,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,GAC3B,MAAM,gBAAgB,CAAC"}