@nwire/forge 0.7.0

package/dist/foundation.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `@nwire/forge` — Nwire framework primitives.
+ *
+ * Public surface domain code uses: `defineAction`, `defineEvent`,
+ * `defineHandler`, `defineActor`, `defineProjection`, `defineQuery`,
+ * `defineWorkflow`, `defineModule`, `defineApp`, `definePlugin`,
+ * `createApp`, `eventFactory`, the runtime, and the InMemory store defaults.
+ *
+ * `MessageEnvelope` and its constructors are re-exported from `@nwire/envelope`
+ * so consumers don't need to import that package separately.
+ */
+export { seedEnvelope, deriveEnvelope, type MessageEnvelope, type SeedEnvelopeInput, } from "@nwire/envelope";
+export * from "./index.js";
+//# sourceMappingURL=foundation.d.ts.map

package/dist/foundation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundation.d.ts","sourceRoot":"","sources":["../src/foundation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,YAAY,EACZ,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,cAAc,SAAS,CAAC"}

package/dist/foundation.js

@@ -0,0 +1,14 @@
+/**
+ * `@nwire/forge` — Nwire framework primitives.
+ *
+ * Public surface domain code uses: `defineAction`, `defineEvent`,
+ * `defineHandler`, `defineActor`, `defineProjection`, `defineQuery`,
+ * `defineWorkflow`, `defineModule`, `defineApp`, `definePlugin`,
+ * `createApp`, `eventFactory`, the runtime, and the InMemory store defaults.
+ *
+ * `MessageEnvelope` and its constructors are re-exported from `@nwire/envelope`
+ * so consumers don't need to import that package separately.
+ */
+export { seedEnvelope, deriveEnvelope, } from "@nwire/envelope";
+export * from "./index.js";
+//# sourceMappingURL=foundation.js.map

package/dist/foundation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"foundation.js","sourceRoot":"","sources":["../src/foundation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,YAAY,EACZ,cAAc,GAGf,MAAM,iBAAiB,CAAC;AAEzB,cAAc,SAAS,CAAC"}

package/dist/framework-event-bus.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `FrameworkEventBus` — re-exported from `@nwire/app`.
+ *
+ * The bus lives in `@nwire/app` (the canonical "managed Container with
+ * lifecycle" layer). Forge re-exports the same surface so consumers that
+ * already pull from forge don't need a second import line.
+ *
+ * Standalone code can import directly from `@nwire/app`:
+ *
+ *   import { FrameworkEventBus, type FrameworkEventHandler } from "@nwire/app"
+ */
+export { FrameworkEventBus, type FrameworkEventHandler } from "@nwire/app";
+//# sourceMappingURL=framework-event-bus.d.ts.map

package/dist/framework-event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-event-bus.d.ts","sourceRoot":"","sources":["../src/framework-event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,iBAAiB,EAAE,KAAK,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/framework-event-bus.js

@@ -0,0 +1,13 @@
+/**
+ * `FrameworkEventBus` — re-exported from `@nwire/app`.
+ *
+ * The bus lives in `@nwire/app` (the canonical "managed Container with
+ * lifecycle" layer). Forge re-exports the same surface so consumers that
+ * already pull from forge don't need a second import line.
+ *
+ * Standalone code can import directly from `@nwire/app`:
+ *
+ *   import { FrameworkEventBus, type FrameworkEventHandler } from "@nwire/app"
+ */
+export { FrameworkEventBus } from "@nwire/app";
+//# sourceMappingURL=framework-event-bus.js.map

package/dist/framework-event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-event-bus.js","sourceRoot":"","sources":["../src/framework-event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,iBAAiB,EAA8B,MAAM,YAAY,CAAC"}

package/dist/framework-events.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Framework events — re-exports of app-layer events + forge-specific events.
+ *
+ * The generic infrastructure (`defineFrameworkEvent` +
+ * `FrameworkEventDefinition`) and the app-lifecycle events (App* / Plugin* /
+ * Wire*) live in `@nwire/app`; this module re-exports them so consumers
+ * pulling from forge get one import line.
+ *
+ * The action-specific events (`ActionDispatching` / `ActionCompleted` /
+ * `ActionFailed`) and event-recording events (`EventRecording` /
+ * `EventRecorded`) are defined here because their payload types reference
+ * forge-specific types (`ActionDefinition`, `HandlerContext`) and the
+ * domain-event bus forge owns.
+ */
+import { type FrameworkEventDefinition } from "@nwire/app";
+import type { ActionDefinition } from "./define-action.js";
+import type { HandlerContext } from "./define-handler.js";
+export { defineFrameworkEvent, AppRegistering, AppBooting, AppBooted, AppReady, AppShuttingDown, AppShutdown, PluginRegistered, PluginBooting, PluginBooted, PluginShuttingDown, PluginShutdown, WireMounting, WireMounted, WireUnmounted, builtInLifecycleEvents, type FrameworkEventDefinition, type FrameworkEventMode, } from "@nwire/app";
+/**
+ * Fired before a dispatch reaches the handler. Interceptable: return
+ * `false` to silently prevent execution, throw to fail with a specific
+ * error, or mutate `payload.input` to transform what the handler sees.
+ */
+export declare const ActionDispatching: FrameworkEventDefinition<{
+    readonly action: ActionDefinition;
+    readonly input: unknown;
+    readonly ctx: HandlerContext;
+}>;
+/** Fired after a handler returns successfully. Observable; runs in parallel. */
+export declare const ActionCompleted: FrameworkEventDefinition<{
+    readonly action: ActionDefinition;
+    readonly input: unknown;
+    readonly result: unknown;
+    readonly durationMs: number;
+}>;
+/** Fired after a handler throws. Observable; runs in parallel. */
+export declare const ActionFailed: FrameworkEventDefinition<{
+    readonly action: ActionDefinition;
+    readonly input: unknown;
+    readonly error: unknown;
+    readonly durationMs: number;
+}>;
+/**
+ * Fired before an event is persisted. Interceptable: return false to drop
+ * the event (rarely useful in practice — events represent facts that
+ * already happened). Throw to fail the dispatch that produced this event.
+ */
+export declare const EventRecording: FrameworkEventDefinition<{
+    readonly eventName: string;
+    readonly payload: unknown;
+}>;
+/** Fired after an event is persisted + workflows have been notified. */
+export declare const EventRecorded: FrameworkEventDefinition<{
+    readonly eventName: string;
+    readonly payload: unknown;
+}>;
+export declare const builtInFrameworkEvents: readonly [FrameworkEventDefinition<{
+    readonly appName: string;
+}>, FrameworkEventDefinition<{
+    readonly appName: string;
+}>, FrameworkEventDefinition<{
+    readonly appName: string;
+    readonly bootedAt: string;
+}>, FrameworkEventDefinition<{
+    readonly appName: string;
+    readonly readyAt: string;
+}>, FrameworkEventDefinition<{
+    readonly appName: string;
+    readonly reason?: string;
+}>, FrameworkEventDefinition<{
+    readonly appName: string;
+}>, FrameworkEventDefinition<{
+    readonly appName: string;
+    readonly pluginName: string;
+}>, FrameworkEventDefinition<{
+    readonly appName: string;
+    readonly pluginName: string;
+}>, FrameworkEventDefinition<{
+    readonly appName: string;
+    readonly pluginName: string;
+    readonly durationMs: number;
+}>, FrameworkEventDefinition<{
+    readonly appName: string;
+    readonly pluginName: string;
+}>, FrameworkEventDefinition<{
+    readonly appName: string;
+    readonly pluginName: string;
+    readonly durationMs: number;
+}>, FrameworkEventDefinition<{
+    readonly appName: string;
+    readonly transport: string;
+    readonly manifest: unknown;
+}>, FrameworkEventDefinition<{
+    readonly appName: string;
+    readonly transport: string;
+    readonly manifest: unknown;
+}>, FrameworkEventDefinition<{
+    readonly appName: string;
+    readonly transport: string;
+}>, FrameworkEventDefinition<{
+    readonly action: ActionDefinition;
+    readonly input: unknown;
+    readonly ctx: HandlerContext;
+}>, FrameworkEventDefinition<{
+    readonly action: ActionDefinition;
+    readonly input: unknown;
+    readonly result: unknown;
+    readonly durationMs: number;
+}>, FrameworkEventDefinition<{
+    readonly action: ActionDefinition;
+    readonly input: unknown;
+    readonly error: unknown;
+    readonly durationMs: number;
+}>, FrameworkEventDefinition<{
+    readonly eventName: string;
+    readonly payload: unknown;
+}>, FrameworkEventDefinition<{
+    readonly eventName: string;
+    readonly payload: unknown;
+}>];
+//# sourceMappingURL=framework-events.d.ts.map

package/dist/framework-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-events.d.ts","sourceRoot":"","sources":["../src/framework-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAwB,KAAK,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIvD,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,UAAU,EACV,SAAS,EACT,QAAQ,EACR,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,WAAW,EACX,aAAa,EACb,sBAAsB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC;AAIpB;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;qBACX,gBAAgB;oBACjB,OAAO;kBACT,cAAc;EACe,CAAC;AAE9C,gFAAgF;AAChF,eAAO,MAAM,eAAe;qBACT,gBAAgB;oBACjB,OAAO;qBACN,OAAO;yBACH,MAAM;EACW,CAAC;AAEzC,kEAAkE;AAClE,eAAO,MAAM,YAAY;qBACN,gBAAgB;oBACjB,OAAO;oBACP,OAAO;yBACF,MAAM;EACQ,CAAC;AAItC;;;;GAIG;AACH,eAAO,MAAM,cAAc;wBACL,MAAM;sBACR,OAAO;EACe,CAAC;AAE3C,wEAAwE;AACxE,eAAO,MAAM,aAAa;wBACJ,MAAM;sBACR,OAAO;EACW,CAAC;AA0BvC,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA/DhB,gBAAgB;oBACjB,OAAO;kBACT,cAAc;;qBAKX,gBAAgB;oBACjB,OAAO;qBACN,OAAO;yBACH,MAAM;;qBAKV,gBAAgB;oBACjB,OAAO;oBACP,OAAO;yBACF,MAAM;;wBAWP,MAAM;sBACR,OAAO;;wBAKL,MAAM;sBACR,OAAO;GA+CjB,CAAC"}

package/dist/framework-events.js

@@ -0,0 +1,67 @@
+/**
+ * Framework events — re-exports of app-layer events + forge-specific events.
+ *
+ * The generic infrastructure (`defineFrameworkEvent` +
+ * `FrameworkEventDefinition`) and the app-lifecycle events (App* / Plugin* /
+ * Wire*) live in `@nwire/app`; this module re-exports them so consumers
+ * pulling from forge get one import line.
+ *
+ * The action-specific events (`ActionDispatching` / `ActionCompleted` /
+ * `ActionFailed`) and event-recording events (`EventRecording` /
+ * `EventRecorded`) are defined here because their payload types reference
+ * forge-specific types (`ActionDefinition`, `HandlerContext`) and the
+ * domain-event bus forge owns.
+ */
+import { defineFrameworkEvent } from "@nwire/app";
+// ─── Re-exports from @nwire/app ────────────────────────────────────
+export { defineFrameworkEvent, AppRegistering, AppBooting, AppBooted, AppReady, AppShuttingDown, AppShutdown, PluginRegistered, PluginBooting, PluginBooted, PluginShuttingDown, PluginShutdown, WireMounting, WireMounted, WireUnmounted, builtInLifecycleEvents, } from "@nwire/app";
+// ─── Action dispatch (forge-local — depends on ActionDefinition) ───
+/**
+ * Fired before a dispatch reaches the handler. Interceptable: return
+ * `false` to silently prevent execution, throw to fail with a specific
+ * error, or mutate `payload.input` to transform what the handler sees.
+ */
+export const ActionDispatching = defineFrameworkEvent("nwire.action.dispatching", "series-bail");
+/** Fired after a handler returns successfully. Observable; runs in parallel. */
+export const ActionCompleted = defineFrameworkEvent("nwire.action.completed", "parallel");
+/** Fired after a handler throws. Observable; runs in parallel. */
+export const ActionFailed = defineFrameworkEvent("nwire.action.failed", "parallel");
+// ─── Event recording (forge-local — about the domain event bus) ────
+/**
+ * Fired before an event is persisted. Interceptable: return false to drop
+ * the event (rarely useful in practice — events represent facts that
+ * already happened). Throw to fail the dispatch that produced this event.
+ */
+export const EventRecording = defineFrameworkEvent("nwire.event.recording", "series-bail");
+/** Fired after an event is persisted + workflows have been notified. */
+export const EventRecorded = defineFrameworkEvent("nwire.event.recorded", "parallel");
+// ─── Catalog ────────────────────────────────────────────────────
+/**
+ * Every built-in framework event — union of app-lifecycle (from @nwire/app)
+ * and forge-specific (action + event-recording). Studio reads this list to
+ * render the "what can I hook into?" page.
+ */
+import { AppRegistering, AppBooting, AppBooted, AppReady, AppShuttingDown, AppShutdown, PluginRegistered, PluginBooting, PluginBooted, PluginShuttingDown, PluginShutdown, WireMounting, WireMounted, WireUnmounted, } from "@nwire/app";
+export const builtInFrameworkEvents = [
+    AppRegistering,
+    AppBooting,
+    AppBooted,
+    AppReady,
+    AppShuttingDown,
+    AppShutdown,
+    PluginRegistered,
+    PluginBooting,
+    PluginBooted,
+    PluginShuttingDown,
+    PluginShutdown,
+    WireMounting,
+    WireMounted,
+    WireUnmounted,
+    ActionDispatching,
+    ActionCompleted,
+    ActionFailed,
+    EventRecording,
+    EventRecorded,
+];
+void {};
+//# sourceMappingURL=framework-events.js.map

package/dist/framework-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-events.js","sourceRoot":"","sources":["../src/framework-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,oBAAoB,EAAiC,MAAM,YAAY,CAAC;AAIjF,sEAAsE;AAEtE,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,UAAU,EACV,SAAS,EACT,QAAQ,EACR,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,WAAW,EACX,aAAa,EACb,sBAAsB,GAGvB,MAAM,YAAY,CAAC;AAEpB,sEAAsE;AAEtE;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,oBAAoB,CAIlD,0BAA0B,EAAE,aAAa,CAAC,CAAC;AAE9C,gFAAgF;AAChF,MAAM,CAAC,MAAM,eAAe,GAAG,oBAAoB,CAKhD,wBAAwB,EAAE,UAAU,CAAC,CAAC;AAEzC,kEAAkE;AAClE,MAAM,CAAC,MAAM,YAAY,GAAG,oBAAoB,CAK7C,qBAAqB,EAAE,UAAU,CAAC,CAAC;AAEtC,sEAAsE;AAEtE;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,oBAAoB,CAG/C,uBAAuB,EAAE,aAAa,CAAC,CAAC;AAE3C,wEAAwE;AACxE,MAAM,CAAC,MAAM,aAAa,GAAG,oBAAoB,CAG9C,sBAAsB,EAAE,UAAU,CAAC,CAAC;AAEvC,mEAAmE;AAEnE;;;;GAIG;AACH,OAAO,EACL,cAAc,EACd,UAAU,EACV,SAAS,EACT,QAAQ,EACR,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,WAAW,EACX,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,cAAc;IACd,UAAU;IACV,SAAS;IACT,QAAQ;IACR,eAAe;IACf,WAAW;IACX,gBAAgB;IAChB,aAAa;IACb,YAAY;IACZ,kBAAkB;IAClB,cAAc;IACd,YAAY;IACZ,WAAW;IACX,aAAa;IACb,iBAAiB;IACjB,eAAe;IACf,YAAY;IACZ,cAAc;IACd,aAAa;CACL,CAAC;AAIX,KAAK,EAA2C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * `@nwire/forge` — the framework's public surface.
+ *
+ * The center of gravity is the action as intent. Resolvers wrap actions for
+ * transport; workflows wire events to effects (reactions, translators, sagas
+ * — one primitive). Actors carry state when entities need identity over time.
+ * Projections + queries are the read side.
+ *
+ * Surface at a glance:
+ *   - defineAction, defineEvent  (events re-exported from @nwire/messages)
+ *   - defineHandler, defineActor, defineWorkflow
+ *   - defineProjection, defineQuery
+ *   - defineResource, defineMiddleware, defineError
+ *   - defineModule, defineApp, createApp
+ *   - ctx verbs (in handlers + resolvers): request, send, use, query
+ *   - .public() marks an item exposed across module boundaries
+ */
+export { defineAction, type ActionDefinition, type ActionMeta, type ActionInput, } from "./define-action.js";
+export { defineActor, eventKey, type ActorDefinition, type ActorOptions, type ActorOptionsBound, type ActorReaction, type ActorStateConfig, type ActorTimerSpec, type ActorMethod, type ActorInstanceView, } from "./define-actor.js";
+export { defineSchema, isSchemaDefinition, type SchemaDefinition, type SchemaOptions, type SchemaStateSpec, type SchemaStorageHints, } from "./define-schema.js";
+export { validate, isInvariantError, InvariantError, type Invariant } from "./validate.js";
+export { defineHandler, type HandlerContext, type HandlerDefinition, type HandlerReturn, } from "./define-handler.js";
+export { eventFactory, isEventMessage, normalizeEventReturn, type EventMessage, type EventFactory, } from "./event-message.js";
+export { assertModuleSurface, type ExpectedSurface } from "./module-surface.js";
+export { InMemoryWorkflowTimerStore, timerEventName, type WorkflowTimer, type WorkflowTimerStore, } from "./workflow-timer-store.js";
+export { isPublic, type PublicMarker } from "./public-marker.js";
+export { defineWorkflow, COMPLETE_EVENT_NAME, type WorkflowDefinition, type WorkflowContext, type StatelessWorkflowContext, type StatefulWorkflowContext, type WorkflowEffects, type WorkflowOptions, type StatelessWorkflowOptions, type StatefulWorkflowOptions, type WorkflowOnOptions, type WorkflowRetryPolicy, type WorkflowStateSpec, type WorkflowInstance, type WorkflowCorrelateMap, type FireContext, type CompleteEvent, type StateCallable, type TimerDefinition, } from "./define-workflow.js";
+export { defineExternalCall, type ExternalCallDefinition, type ExternalCallMeta, type ExternalCallTarget, type ExternalCallSlo, type ExternalCallRetry, type ExternalCallExecutor, } from "./define-external-call.js";
+export { defineInboundWebhook, type InboundWebhookDefinition, type InboundWebhookMeta, type WebhookSignatureVerifier, type WebhookDedupe, } from "./define-inbound-webhook.js";
+export { defineOutbox, type OutboxDefinition, type OutboxMeta } from "./define-outbox.js";
+export { defineInbox, type InboxDefinition, type InboxMeta } from "./define-inbox.js";
+export { defineCron, type CronDefinition, type CronMeta } from "./define-cron.js";
+export { Runtime, parseDelay, type RuntimeOptions, type DispatchMiddleware, type Telemetry, type TelemetryListener, type SerializedError, } from "./runtime.js";
+export { defineFrameworkEvent, AppRegistering, AppBooting, AppBooted, AppReady, AppShuttingDown, AppShutdown, ActionDispatching, ActionCompleted, ActionFailed, EventRecording, EventRecorded, builtInFrameworkEvents, type FrameworkEventDefinition, type FrameworkEventMode, } from "./framework-events.js";
+export { FrameworkEventBus, type FrameworkEventHandler } from "./framework-event-bus.js";
+export { InMemoryActorStore, createInitialInstance, type ActorStore, type ActorInstance, type ActorTimerHandle, } from "./actor-store.js";
+export { runCli, type RunCliOptions } from "./cli-runner.js";
+export { NoopLogger, ConsoleLogger, loggerForEnvelope, type Logger } from "@nwire/logger";
+export { InMemoryDeadLetterSink, buildDeadLetterEntry, type DeadLetterSink, type DeadLetterEntry, } from "@nwire/dead-letter";
+export type { RetryPolicy } from "./define-action.js";
+export { defineProjection, type ProjectionDefinition, type ProjectionOptions, type ProjectionReducer, } from "./define-projection.js";
+export { InMemoryProjectionStore, type ProjectionStore } from "./projection-store.js";
+export { defineQuery, type QueryDefinition, type QueryOptions } from "./define-query.js";
+export { defineModule, type ModuleDefinition, type ModuleManifest, type ModuleNeeds, } from "./define-module.js";
+export { createApp, type App, type CreateAppOptions, type TimerSchedulerOptions, } from "./create-app.js";
+export { attachDevLogger, formatTelemetry, type DevLoggerOptions } from "./dev-logger.js";
+export { defineApp, type AppDefinition, type DefineAppOptions, type EndpointDefinition, type TenantModel, } from "./define-app.js";
+export { definePlugin, type PluginDefinition, type PluginOptions, type PluginContext, type PluginSetup, type PluginActorHooks, type ActorTransitionHook, } from "./define-plugin.js";
+export { defineResource, isResourceDefinition, type ResourceDefinition, type DefineResourceOptions, } from "@nwire/handler";
+export { defineError, isNwireError, NwireError, Unauthorized, Forbidden, NotFound, Gone, BadRequest, Conflict, type ErrorDefinition, type ErrorMeta, } from "./define-error.js";
+export { defineMiddleware, defineHook, pipe, unwindPipe, isMiddleware, isHook, isPipe, type MiddlewareDefinition, type HookDefinition, type MiddlewarePipe, type PipeStep, type ResolverCtx, type Next, } from "./define-middleware.js";
+export { response, isResponseSpec, isResponseInstance, ok, created, accepted, noContent, notModified, gone, type ResponseSpec, type ListResponseSpec, type ResponseInstance, type ResponseKind, } from "./response.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,61 @@
+/**
+ * `@nwire/forge` — the framework's public surface.
+ *
+ * The center of gravity is the action as intent. Resolvers wrap actions for
+ * transport; workflows wire events to effects (reactions, translators, sagas
+ * — one primitive). Actors carry state when entities need identity over time.
+ * Projections + queries are the read side.
+ *
+ * Surface at a glance:
+ *   - defineAction, defineEvent  (events re-exported from @nwire/messages)
+ *   - defineHandler, defineActor, defineWorkflow
+ *   - defineProjection, defineQuery
+ *   - defineResource, defineMiddleware, defineError
+ *   - defineModule, defineApp, createApp
+ *   - ctx verbs (in handlers + resolvers): request, send, use, query
+ *   - .public() marks an item exposed across module boundaries
+ */
+export { defineAction, } from "./define-action.js";
+export { defineActor, eventKey, } from "./define-actor.js";
+export { defineSchema, isSchemaDefinition, } from "./define-schema.js";
+export { validate, isInvariantError, InvariantError } from "./validate.js";
+export { defineHandler, } from "./define-handler.js";
+export { eventFactory, isEventMessage, normalizeEventReturn, } from "./event-message.js";
+export { assertModuleSurface } from "./module-surface.js";
+export { InMemoryWorkflowTimerStore, timerEventName, } from "./workflow-timer-store.js";
+export { isPublic } from "./public-marker.js";
+export { defineWorkflow, COMPLETE_EVENT_NAME, } from "./define-workflow.js";
+// ─── Orchestrator primitives ──────────────────────────
+export { defineExternalCall, } from "./define-external-call.js";
+export { defineInboundWebhook, } from "./define-inbound-webhook.js";
+export { defineOutbox } from "./define-outbox.js";
+export { defineInbox } from "./define-inbox.js";
+export { defineCron } from "./define-cron.js";
+export { Runtime, parseDelay, } from "./runtime.js";
+// ─── Framework events ───────────────────────────────────────────
+export { defineFrameworkEvent, AppRegistering, AppBooting, AppBooted, AppReady, AppShuttingDown, AppShutdown, ActionDispatching, ActionCompleted, ActionFailed, EventRecording, EventRecorded, builtInFrameworkEvents, } from "./framework-events.js";
+export { FrameworkEventBus } from "./framework-event-bus.js";
+export { InMemoryActorStore, createInitialInstance, } from "./actor-store.js";
+// File-snapshot store extracted to `@nwire/store-file`.
+// Mongo stores extracted to `@nwire/store-mongo`.
+// Forge ships only interfaces + InMemory defaults; persistent adapters
+// are separate packages consumers add as needed.
+// Queue transport + createQueueWorker live in `@nwire/queue` (consumers
+// import from there directly to avoid a forge ↔ queue dep cycle).
+export { runCli } from "./cli-runner.js";
+export { NoopLogger, ConsoleLogger, loggerForEnvelope } from "@nwire/logger";
+export { InMemoryDeadLetterSink, buildDeadLetterEntry, } from "@nwire/dead-letter";
+export { defineProjection, } from "./define-projection.js";
+export { InMemoryProjectionStore } from "./projection-store.js";
+export { defineQuery } from "./define-query.js";
+export { defineModule, } from "./define-module.js";
+export { createApp, } from "./create-app.js";
+export { attachDevLogger, formatTelemetry } from "./dev-logger.js";
+export { defineApp, } from "./define-app.js";
+export { definePlugin, } from "./define-plugin.js";
+// ─── Interface / app layer primitives ────────────────────────────
+export { defineResource, isResourceDefinition, } from "@nwire/handler";
+export { defineError, isNwireError, NwireError, Unauthorized, Forbidden, NotFound, Gone, BadRequest, Conflict, } from "./define-error.js";
+export { defineMiddleware, defineHook, pipe, unwindPipe, isMiddleware, isHook, isPipe, } from "./define-middleware.js";
+export { response, isResponseSpec, isResponseInstance, ok, created, accepted, noContent, notModified, gone, } from "./response.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/module-surface.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Module barrel helpers.
+ *
+ * The recommended import pattern is `import { x } from "@modules/<bc>"` —
+ * a single barrel file per bounded context that re-exports only the items
+ * the module declared `.public()` on. Three layers of enforcement:
+ *
+ *   1. The barrel itself is hand-written, listing only public symbols.
+ *      Drift is loud — a missing re-export, an unexposed symbol.
+ *   2. `assertModuleSurface(module, expected)` runs at module-load time
+ *      and throws if the manifest's public surface doesn't match. Catches
+ *      "exported in barrel but not .public() in manifest" and vice versa.
+ *   3. `package.json` `exports` field locks consumers to the barrel
+ *      (workspace-package-per-module mode). Direct-file imports raise
+ *      module-not-found errors at build/runtime.
+ *
+ * This file gives you the assertion helper. The barrel is yours to write
+ * (it's the part that names what's public).
+ */
+import type { ModuleDefinition } from "./define-module.js";
+export interface ExpectedSurface {
+    readonly actions?: readonly string[];
+    readonly events?: readonly string[];
+    readonly queries?: readonly string[];
+    readonly workflows?: readonly string[];
+}
+/**
+ * Assert that the module's manifest exposes exactly the items the barrel
+ * intends to re-export. Throws with a structured diff message on mismatch.
+ *
+ *   // modules/stations/index.ts
+ *   import { stationsModule }    from "./stations.module";
+ *   import { createStation }     from "./actions/create-station";
+ *   import { recordWash }        from "./actions/record-wash";
+ *   import { listStations }      from "./queries/list-stations";
+ *   import { WashRecorded_v1 }   from "./events/wash-recorded.v1";
+ *
+ *   export { stationsModule, createStation, recordWash, listStations, WashRecorded_v1 };
+ *
+ *   assertModuleSurface(stationsModule, {
+ *     actions: ["stations.create-station", "stations.record-wash"],
+ *     queries: ["stations.list-stations"],
+ *     events:  ["stations.wash-recorded.v1"],
+ *   });
+ */
+export declare function assertModuleSurface(module: ModuleDefinition, expected: ExpectedSurface): void;
+//# sourceMappingURL=module-surface.d.ts.map

package/dist/module-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-surface.d.ts","sourceRoot":"","sources":["../src/module-surface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CA+B7F"}

package/dist/module-surface.js

@@ -0,0 +1,65 @@
+/**
+ * Module barrel helpers.
+ *
+ * The recommended import pattern is `import { x } from "@modules/<bc>"` —
+ * a single barrel file per bounded context that re-exports only the items
+ * the module declared `.public()` on. Three layers of enforcement:
+ *
+ *   1. The barrel itself is hand-written, listing only public symbols.
+ *      Drift is loud — a missing re-export, an unexposed symbol.
+ *   2. `assertModuleSurface(module, expected)` runs at module-load time
+ *      and throws if the manifest's public surface doesn't match. Catches
+ *      "exported in barrel but not .public() in manifest" and vice versa.
+ *   3. `package.json` `exports` field locks consumers to the barrel
+ *      (workspace-package-per-module mode). Direct-file imports raise
+ *      module-not-found errors at build/runtime.
+ *
+ * This file gives you the assertion helper. The barrel is yours to write
+ * (it's the part that names what's public).
+ */
+/**
+ * Assert that the module's manifest exposes exactly the items the barrel
+ * intends to re-export. Throws with a structured diff message on mismatch.
+ *
+ *   // modules/stations/index.ts
+ *   import { stationsModule }    from "./stations.module";
+ *   import { createStation }     from "./actions/create-station";
+ *   import { recordWash }        from "./actions/record-wash";
+ *   import { listStations }      from "./queries/list-stations";
+ *   import { WashRecorded_v1 }   from "./events/wash-recorded.v1";
+ *
+ *   export { stationsModule, createStation, recordWash, listStations, WashRecorded_v1 };
+ *
+ *   assertModuleSurface(stationsModule, {
+ *     actions: ["stations.create-station", "stations.record-wash"],
+ *     queries: ["stations.list-stations"],
+ *     events:  ["stations.wash-recorded.v1"],
+ *   });
+ */
+export function assertModuleSurface(module, expected) {
+    const checks = [
+        { kind: "actions", want: expected.actions ?? [], have: module.publicSurface.actions },
+        { kind: "events", want: expected.events ?? [], have: module.publicSurface.events },
+        { kind: "queries", want: expected.queries ?? [], have: module.publicSurface.queries },
+        { kind: "workflows", want: expected.workflows ?? [], have: module.publicSurface.workflows },
+    ];
+    const errors = [];
+    for (const { kind, want, have } of checks) {
+        const wantSet = new Set(want);
+        const missingFromManifest = [...wantSet].filter((n) => !have.has(n));
+        const missingFromBarrel = [...have].filter((n) => !wantSet.has(n));
+        if (missingFromManifest.length > 0) {
+            errors.push(`${kind}: barrel re-exports ${missingFromManifest.map((n) => `"${n}"`).join(", ")} ` +
+                `but the module manifest did not call .public() on ${missingFromManifest.length === 1 ? "it" : "them"}.`);
+        }
+        if (missingFromBarrel.length > 0) {
+            errors.push(`${kind}: manifest exposes ${missingFromBarrel.map((n) => `"${n}"`).join(", ")} ` +
+                `but the barrel does not re-export ${missingFromBarrel.length === 1 ? "it" : "them"}.`);
+        }
+    }
+    if (errors.length > 0) {
+        throw new Error(`assertModuleSurface(${module.name}): public surface drift detected.\n` +
+            errors.map((e) => `  • ${e}`).join("\n"));
+    }
+}
+//# sourceMappingURL=module-surface.js.map

package/dist/module-surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-surface.js","sourceRoot":"","sources":["../src/module-surface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAWH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAwB,EAAE,QAAyB;IACrF,MAAM,MAAM,GAAgF;QAC1F,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE;QACrF,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE;QAClF,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE;QACrF,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,CAAC,SAAS,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE;KAC5F,CAAC;IACF,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,mBAAmB,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrE,MAAM,iBAAiB,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,CAAC,IAAI,CACT,GAAG,IAAI,uBAAuB,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;gBAClF,qDAAqD,mBAAmB,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,CAC3G,CAAC;QACJ,CAAC;QACD,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CACT,GAAG,IAAI,sBAAsB,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;gBAC/E,qCAAqC,iBAAiB,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,CACzF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,uBAAuB,MAAM,CAAC,IAAI,qCAAqC;YACrE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAC3C,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/projection-store.d.ts

@@ -0,0 +1,26 @@
+/**
+ * ProjectionStore — persistence contract for projection state.
+ *
+ * Each projection has a single state value (the fold result over its event
+ * stream). The store is keyed by projection name. Implementations are kept
+ * deliberately thin; richer query patterns belong in the projection's own
+ * structure (typically a Map keyed by entity id).
+ */
+export interface ProjectionStore {
+    /**
+     * Load the projection's state for `tenant` (default `''` for the global
+     * / single-tenant scope). Returns `null` if no events have folded yet
+     * for this tenant — the runtime then seeds with `projection.initial()`.
+     */
+    load<TState = unknown>(projectionName: string, tenant?: string): Promise<TState | null>;
+    save<TState = unknown>(projectionName: string, state: TState, tenant?: string): Promise<void>;
+}
+export declare class InMemoryProjectionStore implements ProjectionStore {
+    private readonly entries;
+    private cacheKey;
+    load<TState = unknown>(projectionName: string, tenant?: string): Promise<TState | null>;
+    save<TState = unknown>(projectionName: string, state: TState, tenant?: string): Promise<void>;
+    /** Test-only — clear all projection state. */
+    clear(): void;
+}
+//# sourceMappingURL=projection-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projection-store.d.ts","sourceRoot":"","sources":["../src/projection-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxF,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/F;AAED,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IAEtD,OAAO,CAAC,QAAQ;IAIV,IAAI,CAAC,MAAM,GAAG,OAAO,EACzB,cAAc,EAAE,MAAM,EACtB,MAAM,GAAE,MAAW,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAMnB,IAAI,CAAC,MAAM,GAAG,OAAO,EACzB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,MAAW,GAClB,OAAO,CAAC,IAAI,CAAC;IAIhB,8CAA8C;IAC9C,KAAK,IAAI,IAAI;CAGd"}

package/dist/projection-store.js

@@ -0,0 +1,28 @@
+/**
+ * ProjectionStore — persistence contract for projection state.
+ *
+ * Each projection has a single state value (the fold result over its event
+ * stream). The store is keyed by projection name. Implementations are kept
+ * deliberately thin; richer query patterns belong in the projection's own
+ * structure (typically a Map keyed by entity id).
+ */
+export class InMemoryProjectionStore {
+    entries = new Map();
+    cacheKey(projectionName, tenant) {
+        return `${tenant}::${projectionName}`;
+    }
+    async load(projectionName, tenant = "") {
+        const k = this.cacheKey(projectionName, tenant);
+        if (!this.entries.has(k))
+            return null;
+        return structuredClone(this.entries.get(k));
+    }
+    async save(projectionName, state, tenant = "") {
+        this.entries.set(this.cacheKey(projectionName, tenant), structuredClone(state));
+    }
+    /** Test-only — clear all projection state. */
+    clear() {
+        this.entries.clear();
+    }
+}
+//# sourceMappingURL=projection-store.js.map

package/dist/projection-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-store.js","sourceRoot":"","sources":["../src/projection-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,MAAM,OAAO,uBAAuB;IACjB,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;IAE9C,QAAQ,CAAC,cAAsB,EAAE,MAAc;QACrD,OAAO,GAAG,MAAM,KAAK,cAAc,EAAE,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,IAAI,CACR,cAAsB,EACtB,SAAiB,EAAE;QAEnB,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACtC,OAAO,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAW,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,IAAI,CACR,cAAsB,EACtB,KAAa,EACb,SAAiB,EAAE;QAEnB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IAClF,CAAC;IAED,8CAA8C;IAC9C,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF"}

package/dist/public-marker.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `.public()` — the marker every cross-module-eligible primitive carries.
+ *
+ * Visibility is a module-level decision: a definition declares *behavior*,
+ * the module manifest declares *exposure*. Code calls `def.public()` only
+ * inside the manifest array (or inline at the call site if it's convenient),
+ * and `defineModule` reads the `$public` flag to partition each array into
+ * the module's public surface vs its internals.
+ *
+ *   actions: [
+ *     createStation.public(),      // public — other modules may dispatch
+ *     normalizeTraffic,             // internal — only this module sees it
+ *   ]
+ *
+ * The marker is non-enumerable so it doesn't pollute logs / OpenAPI dumps;
+ * the `public()` method is non-enumerable for the same reason. Calling
+ * `.public()` returns a SHALLOW clone — the original stays unmarked, so
+ * the definition file remains visibility-agnostic.
+ */
+export interface PublicMarker {
+    /** Truthy when this definition was marked via `.public()` in a manifest. */
+    readonly $public?: true;
+    /** Return a clone of this definition with `$public: true`. */
+    public: () => this;
+}
+export declare function isPublic(def: {
+    readonly $public?: boolean;
+}): boolean;
+/**
+ * Attach the `.public()` method + the `$public` slot in place. Each call
+ * to `.public()` produces a fresh clone with `$public: true` and the method
+ * re-installed so the clone remains markable (idempotent).
+ */
+export declare function markable<T extends object>(def: T): T & PublicMarker;
+//# sourceMappingURL=public-marker.d.ts.map