@nwire/forge 0.7.0

package/dist/define-model.js

@@ -0,0 +1,13 @@
+/**
+ * `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, 
+// New canonical names also exposed for forge consumers that want
+// to track the spec vocabulary.
+defineResource, isResourceDefinition, } from "@nwire/handler";
+//# sourceMappingURL=define-model.js.map

package/dist/define-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-model.js","sourceRoot":"","sources":["../src/define-model.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,WAAW,EACX,iBAAiB;AACjB,iEAAiE;AACjE,gCAAgC;AAChC,cAAc,EACd,oBAAoB,GAKrB,MAAM,gBAAgB,CAAC"}

package/dist/define-module.d.ts

@@ -0,0 +1,157 @@
+/**
+ * `defineModule` — a bounded context as an explicit table of contents.
+ *
+ *   export default defineModule('submissions', {
+ *     actions:     [submitAnswer, flagForReview, gradeSubmission, autoGrade],
+ *     actors:      [Submission],
+ *     projections: [SubmissionsByStudent],
+ *     queries:     [submissionsByStudent, submissionById],
+ *     events:      [AnswerSubmittedEvent, AnswerFlaggedForReviewEvent, ...],
+ *     handlers:    [submitAnswerHandler, flagForReviewHandler, ...],
+ *     workflows:   [autoGradeWorkflow, notifyOnFlaggedWorkflow]
+ *   })
+ *
+ * Modules own DOMAIN, not transport — route bindings live in the app layer
+ * (transport interface builders) where they belong. Auto-discovery (file
+ * globs, directory walks) is rejected: new team members read one file to
+ * find every surface in the module. The module is what `createApp` registers
+ * with the runtime.
+ */
+import type { ActionDefinition } from "./define-action.js";
+import type { ActorDefinition } from "./define-actor.js";
+import type { HandlerDefinition } from "./define-handler.js";
+import type { ProjectionDefinition } from "./define-projection.js";
+import type { QueryDefinition } from "./define-query.js";
+import type { WorkflowDefinition } from "./define-workflow.js";
+import type { EventDefinition } from "@nwire/messages";
+import type { ExternalCallDefinition } from "./define-external-call.js";
+import type { InboundWebhookDefinition } from "./define-inbound-webhook.js";
+import type { OutboxDefinition } from "./define-outbox.js";
+import type { InboxDefinition } from "./define-inbox.js";
+import type { CronDefinition } from "./define-cron.js";
+import type { NwireInterface } from "@nwire/interface";
+/**
+ * Cross-module dependencies declared by this module.
+ *
+ * The existing `events` and `actions` arrays on a manifest serve as the
+ * module's implicit **provides** (what it owns + emits). `needs` declares
+ * the inverse — what this module consumes from other modules.
+ *
+ *   defineModule('mastery', {
+ *       events: [MasteryContributionRecordedEvent],   // this module's provides
+ *       workflows: [updateOnGradedReaction],          // listens to ...
+ *       needs: {
+ *           events: [SubmissionAutoGradedEvent, SubmissionManuallyGradedEvent]
+ *       }
+ *   })
+ *
+ * `createApp` validates the resulting dep graph at startup:
+ *   - every needed event must be in some OTHER module's `events` array,
+ *   - the producing event must be `visibility: 'public'` (the default),
+ *   - every needed action must be in some other module's `actions`,
+ *   - a module may not `need` what it itself provides (self-reference).
+ *
+ * Violations throw with a message that names the offending module + ref.
+ * This catches typos and refactor breakage at boot, before the first
+ * real dispatch, and makes the cross-module graph explicit for readers.
+ */
+export interface ModuleNeeds {
+    /**
+     * Events this module subscribes to that are provided by another module in
+     * the SAME app/service. Validated in-process at createApp.
+     */
+    readonly events?: readonly EventDefinition[];
+    /**
+     * Actions this module dispatches that are provided by another module in
+     * the SAME app/service. Validated in-process at createApp.
+     */
+    readonly actions?: readonly ActionDefinition[];
+    /**
+     * Events this module subscribes to that originate in OTHER services (a
+     * different `defineApp(...)` running in a different process). These flow
+     * over the configured `EventBus` (`@nwire/bus`). createApp:
+     *   - rejects an externalEvent that ALSO appears in this app's provides
+     *     (you don't reach across the bus for your own publishes),
+     *   - auto-subscribes the bus to each external event name at boot,
+     *   - routes received bus messages to `runtime.applyExternalEvent`.
+     *
+     * If the app has no bus configured but a module declares externalEvents,
+     * createApp throws — the dep is unsatisfiable.
+     */
+    readonly externalEvents?: readonly EventDefinition[];
+}
+/** A journey step a bounded context owns — Studio renders these as the
+ * spine of its persona view. `id` ties back to action.journeyStep. */
+export interface JourneyStep {
+    readonly id: string;
+    readonly label: string;
+    readonly description?: string;
+}
+export interface ModuleManifest {
+    readonly actions?: readonly ActionDefinition[];
+    readonly actors?: readonly ActorDefinition<any>[];
+    readonly handlers?: readonly HandlerDefinition<any>[];
+    readonly projections?: readonly ProjectionDefinition<any>[];
+    readonly queries?: readonly QueryDefinition<any, any, any>[];
+    readonly events?: readonly EventDefinition[];
+    /**
+     * Optional split of `events` into domain (BC-internal) + integration
+     * (public bus contract). If both are provided, `events` is computed as
+     * the union. If only `events` is provided, scope is inferred from
+     * each event's `scope` / `visibility`.
+     */
+    readonly domainEvents?: readonly EventDefinition[];
+    readonly integrationEvents?: readonly EventDefinition[];
+    /**
+     * Workflows — the unified primitive for event-driven side effects
+     * (reactions, translators, sagas). One declaration, three sophistication
+     * levels; the runtime picks fast-path dispatch vs full saga semantics
+     * based on what each workflow declares.
+     */
+    readonly workflows?: readonly WorkflowDefinition[];
+    readonly needs?: ModuleNeeds;
+    readonly externalCalls?: readonly ExternalCallDefinition<any, any>[];
+    readonly inboundWebhooks?: readonly InboundWebhookDefinition<any>[];
+    readonly outboxes?: readonly OutboxDefinition[];
+    readonly inboxes?: readonly InboxDefinition[];
+    readonly crons?: readonly CronDefinition[];
+    /**
+     * Wires the module owns — transport interfaces (http / queue / mcp / …)
+     * declared inside the module's own `__wires__/` folder. The fractal
+     * "module ≅ small project" layout means a module can ship its own
+     * transports for embedded / standalone runs; the parent app composes
+     * them onto its endpoint at boot.
+     *
+     * Wires here are values produced by `http()` / `queue()` / `mcp()` /
+     * etc. — they extend `InterfaceBuilder` and are servable by
+     * `@nwire/endpoint`. The framework treats them as opaque at the module
+     * layer; transports own the semantics.
+     */
+    readonly wires?: readonly NwireInterface[];
+    /** Studio-aware: free-form description. */
+    readonly description?: string;
+    /** Studio-aware: owning team/people identifiers. */
+    readonly owners?: readonly string[];
+    /** Studio-aware: declared journey steps this BC owns. */
+    readonly journey?: readonly JourneyStep[];
+}
+/**
+ * Public surface of a module — the names of every item this module
+ * exposed via `.public()` in its manifest. `createApp` validates cross-
+ * module needs against these sets; runtime cross-module dispatch is
+ * permitted only for names that appear here.
+ */
+export interface ModulePublicSurface {
+    readonly actions: ReadonlySet<string>;
+    readonly events: ReadonlySet<string>;
+    readonly queries: ReadonlySet<string>;
+    readonly workflows: ReadonlySet<string>;
+}
+export interface ModuleDefinition {
+    readonly $kind: "module";
+    readonly name: string;
+    readonly manifest: ModuleManifest;
+    readonly publicSurface: ModulePublicSurface;
+}
+export declare function defineModule(name: string, manifest: ModuleManifest): ModuleDefinition;
+//# sourceMappingURL=define-module.d.ts.map

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

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

package/dist/define-module.js

@@ -0,0 +1,60 @@
+/**
+ * `defineModule` — a bounded context as an explicit table of contents.
+ *
+ *   export default defineModule('submissions', {
+ *     actions:     [submitAnswer, flagForReview, gradeSubmission, autoGrade],
+ *     actors:      [Submission],
+ *     projections: [SubmissionsByStudent],
+ *     queries:     [submissionsByStudent, submissionById],
+ *     events:      [AnswerSubmittedEvent, AnswerFlaggedForReviewEvent, ...],
+ *     handlers:    [submitAnswerHandler, flagForReviewHandler, ...],
+ *     workflows:   [autoGradeWorkflow, notifyOnFlaggedWorkflow]
+ *   })
+ *
+ * Modules own DOMAIN, not transport — route bindings live in the app layer
+ * (transport interface builders) where they belong. Auto-discovery (file
+ * globs, directory walks) is rejected: new team members read one file to
+ * find every surface in the module. The module is what `createApp` registers
+ * with the runtime.
+ */
+function namesOf(items) {
+    const out = new Set();
+    for (const it of items ?? []) {
+        if (it.$public === true)
+            out.add(it.name);
+    }
+    return out;
+}
+export function defineModule(name, manifest) {
+    // If the user split events into domainEvents + integrationEvents, auto-merge
+    // into `events` so downstream registries find them. If the user provided
+    // their own `events` too, prefer the explicit value.
+    const split = [...(manifest.domainEvents ?? []), ...(manifest.integrationEvents ?? [])];
+    const events = manifest.events ?? (split.length > 0 ? split : undefined);
+    // The public surface is whatever was tagged `.public()` in this manifest.
+    // Until the example codebase fully migrates, events with the older
+    // `visibility: "public"` flag are also treated as part of the surface so
+    // pre-existing modules keep working.
+    const publicSurface = {
+        actions: namesOf(manifest.actions),
+        queries: namesOf(manifest.queries),
+        workflows: namesOf(manifest.workflows),
+        events: (() => {
+            const s = namesOf(events);
+            for (const e of events ?? []) {
+                if (e.$public === true)
+                    s.add(e.name);
+                else if (e.visibility === "public")
+                    s.add(e.name);
+            }
+            return s;
+        })(),
+    };
+    return {
+        $kind: "module",
+        name,
+        manifest: { ...manifest, events },
+        publicSurface,
+    };
+}
+//# sourceMappingURL=define-module.js.map

package/dist/define-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-module.js","sourceRoot":"","sources":["../src/define-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAuJH,SAAS,OAAO,CACd,KAA+B;IAE/B,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,EAAE,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAC7B,IAAI,EAAE,CAAC,OAAO,KAAK,IAAI;YAAE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,QAAwB;IACjE,6EAA6E;IAC7E,yEAAyE;IACzE,qDAAqD;IACrD,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,CAAC;IACxF,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEzE,0EAA0E;IAC1E,mEAAmE;IACnE,yEAAyE;IACzE,qCAAqC;IACrC,MAAM,aAAa,GAAwB;QACzC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;QAClC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;QAClC,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;QACtC,MAAM,EAAE,CAAC,GAAG,EAAE;YACZ,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YAC1B,KAAK,MAAM,CAAC,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;gBAC7B,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI;oBAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;qBACjC,IAAK,CAA6B,CAAC,UAAU,KAAK,QAAQ;oBAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACjF,CAAC;YACD,OAAO,CAAC,CAAC;QACX,CAAC,CAAC,EAAE;KACL,CAAC;IAEF,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,IAAI;QACJ,QAAQ,EAAE,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE;QACjC,aAAa;KACd,CAAC;AACJ,CAAC"}

package/dist/define-outbox.d.ts

@@ -0,0 +1,47 @@
+/**
+ * `defineOutbox` — declarative transactional outbox.
+ *
+ *   export const ordersOutbox = defineOutbox({
+ *     name: "orders",
+ *     publishes: [OrderPlacedEvent, OrderShippedEvent],
+ *     flushIntervalMs: 200,
+ *     maxBatch: 100,
+ *   });
+ *
+ * An outbox is a durable queue local to the service: events are written
+ * to it inside the same transaction as the business state change. A
+ * separate flusher reads the outbox and publishes events to the
+ * cross-service bus. Guarantees at-least-once delivery — readers handle
+ * dedup via inbox (`defineInbox`).
+ *
+ * The framework treats outboxes as first-class so Studio can render them
+ * as boundary stickies and surface depth + flush latency + failed-flush
+ * counts as drift signals.
+ *
+ * Runtime: a registered `OutboxStore` adapter holds pending entries; a
+ * flusher (`@nwire/outbox-poller` or BullMQ-backed) drains it. The
+ * runtime emits `outbox.flushed` telemetry on each batch.
+ */
+import type { EventDefinition } from "@nwire/messages";
+export interface OutboxMeta {
+    readonly name: string;
+    readonly description?: string;
+    /** Events this outbox is allowed to publish — Studio uses this to draw arrows. */
+    readonly publishes: readonly EventDefinition[];
+    /** Flush interval in milliseconds. Default 1000. */
+    readonly flushIntervalMs?: number;
+    /** Max batch size per flush. Default 100. */
+    readonly maxBatch?: number;
+    readonly tags?: readonly string[];
+}
+export interface OutboxDefinition {
+    readonly $kind: "outbox";
+    readonly name: string;
+    readonly description?: string;
+    readonly publishes: readonly EventDefinition[];
+    readonly flushIntervalMs: number;
+    readonly maxBatch: number;
+    readonly tags?: readonly string[];
+}
+export declare function defineOutbox(meta: OutboxMeta): OutboxDefinition;
+//# sourceMappingURL=define-outbox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-outbox.d.ts","sourceRoot":"","sources":["../src/define-outbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,kFAAkF;IAClF,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IAC/C,oDAAoD;IACpD,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IAC/C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,gBAAgB,CAU/D"}

package/dist/define-outbox.js

@@ -0,0 +1,36 @@
+/**
+ * `defineOutbox` — declarative transactional outbox.
+ *
+ *   export const ordersOutbox = defineOutbox({
+ *     name: "orders",
+ *     publishes: [OrderPlacedEvent, OrderShippedEvent],
+ *     flushIntervalMs: 200,
+ *     maxBatch: 100,
+ *   });
+ *
+ * An outbox is a durable queue local to the service: events are written
+ * to it inside the same transaction as the business state change. A
+ * separate flusher reads the outbox and publishes events to the
+ * cross-service bus. Guarantees at-least-once delivery — readers handle
+ * dedup via inbox (`defineInbox`).
+ *
+ * The framework treats outboxes as first-class so Studio can render them
+ * as boundary stickies and surface depth + flush latency + failed-flush
+ * counts as drift signals.
+ *
+ * Runtime: a registered `OutboxStore` adapter holds pending entries; a
+ * flusher (`@nwire/outbox-poller` or BullMQ-backed) drains it. The
+ * runtime emits `outbox.flushed` telemetry on each batch.
+ */
+export function defineOutbox(meta) {
+    return {
+        $kind: "outbox",
+        name: meta.name,
+        description: meta.description,
+        publishes: meta.publishes,
+        flushIntervalMs: meta.flushIntervalMs ?? 1000,
+        maxBatch: meta.maxBatch ?? 100,
+        tags: meta.tags,
+    };
+}
+//# sourceMappingURL=define-outbox.js.map

package/dist/define-outbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-outbox.js","sourceRoot":"","sources":["../src/define-outbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AA0BH,MAAM,UAAU,YAAY,CAAC,IAAgB;IAC3C,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,IAAI;QAC7C,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,GAAG;QAC9B,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC;AACJ,CAAC"}

package/dist/define-plugin.d.ts

@@ -0,0 +1,171 @@
+/**
+ * `definePlugin` — first-class extension primitive.
+ *
+ * Plugins extend the FRAMEWORK; modules provide DOMAIN. The distinction is
+ * load-bearing — module code is "what the system does"; plugin code is
+ * "what cuts across the system."
+ *
+ *   Plugin examples (cross-cutting):
+ *     - Tracing: open a span around every dispatch (middleware).
+ *     - Audit log: persist {action, user, input, result} per dispatch.
+ *     - Authz: enforce per-action policy before dispatch.
+ *     - Rate-limiting: throttle dispatches by user / tenant / action.
+ *     - Observability: register Prometheus metrics, expose /metrics.
+ *
+ * Two authoring forms — pick whichever is clearer:
+ *
+ *   1. Closure form (recommended for most plugins):
+ *
+ *      definePlugin("audit", ({ bind, on, after, middleware, boot }) => {
+ *        const log = bind("auditLog", () => new AuditLog())
+ *        after("post.publish", async ({ result }) => log.write(result))
+ *        middleware(async (next, action, input, ctx) => {
+ *          log.start(ctx.envelope.messageId, action.name)
+ *          try { return await next() }
+ *          finally { log.finish(ctx.envelope.messageId) }
+ *        })
+ *        boot(async () => log.connect())
+ *      })
+ *
+ *   2. Object form (kept for back-compat and explicit-lifecycle cases):
+ *
+ *      definePlugin("audit", {
+ *        register: (container) => container.register("auditLog", ...),
+ *        boot:     async (container) => { ... },
+ *        shutdown: async (container) => { ... },
+ *        middleware: [ ... ],
+ *      })
+ *
+ * The closure form's `on`/`before`/`after` subscribe to framework events
+ * (see `framework-events.ts`) so plugins can react to lifecycle and
+ * dispatch events the same way they'd react to a domain event — there is
+ * no separate "hooks" system.
+ *
+ * Plugins are listed in `createApp({ plugins: [...] })`. Sequencing:
+ *   start: plugin register / setup (sync) → providers boot → plugin boot
+ *   stop:  shutdown plugins in reverse → shutdown providers in reverse
+ */
+import type { Container } from "@nwire/container";
+import type { DispatchMiddleware, Runtime } from "./runtime.js";
+import type { EventMessage } from "./event-message.js";
+import type { ActorDefinition } from "./define-actor.js";
+import type { MessageEnvelope } from "@nwire/envelope";
+import type { FrameworkEventDefinition } from "./framework-events.js";
+import type { FrameworkEventHandler } from "./framework-event-bus.js";
+/** Hook fired by the runtime after an actor transitions to a new state. */
+export type ActorTransitionHook = (actor: ActorDefinition, key: string, fromState: string, toState: string, event: EventMessage, envelope: MessageEnvelope) => Promise<void> | void;
+export interface PluginActorHooks {
+    readonly afterTransition?: ActorTransitionHook;
+}
+/**
+ * The builder passed to a closure-form plugin. Every method mutates the
+ * world (container, runtime) immediately — there's no separate "apply"
+ * step. Returning values from `bind` gives ergonomic access to the just-
+ * registered binding (handy when the plugin's own subscriptions need it).
+ */
+export interface PluginContext {
+    readonly container: Container;
+    readonly runtime: Runtime;
+    readonly config: Record<string, any>;
+    /**
+     * Register a singleton on the container. The factory runs once, lazily,
+     * the first time something resolves the name. Returns the binding name
+     * so callers can immediately resolve if needed.
+     */
+    bind<T>(name: string, factory: () => T): string;
+    /** Resolve a previously-bound value (provider or other plugin's bind). */
+    resolve<T>(name: string): T;
+    /**
+     * Subscribe to ANY event — framework or domain. For framework events the
+     * payload type is the event's `__payload` marker. For domain events use
+     * `runtime.frameworkEvents` directly or rely on the workflow primitive.
+     */
+    on<TPayload>(event: FrameworkEventDefinition<TPayload>, handler: FrameworkEventHandler<TPayload>, priority?: number): void;
+    /**
+     * Sugar over `on(ActionDispatching, ...)` scoped to one action. Return
+     * `false` to veto the dispatch (interceptable). Throw to fail.
+     *
+     *   before("post.publish", async ({ ctx }) => {
+     *     if (!ctx.envelope.user) return false  // reject anonymous
+     *   })
+     */
+    before(actionName: string, handler: (payload: {
+        readonly action: import("./define-action.js").ActionDefinition;
+        readonly input: unknown;
+        readonly ctx: import("./define-handler.js").HandlerContext;
+    }) => Promise<void | boolean> | void | boolean): void;
+    /**
+     * Sugar over `on(ActionCompleted, ...)` scoped to one action. Observable;
+     * runs in parallel with other subscribers. Throws are logged, not fatal.
+     */
+    after(actionName: string, handler: (payload: {
+        readonly action: import("./define-action.js").ActionDefinition;
+        readonly input: unknown;
+        readonly result: unknown;
+        readonly durationMs: number;
+    }) => Promise<void> | void): void;
+    /** Add a dispatch middleware. Onion-style; first call is outermost. */
+    middleware(mw: DispatchMiddleware): void;
+    /** Hook actor transitions (every actor, every state change, every event). */
+    actorHook(hook: ActorTransitionHook): void;
+    /** Register an async boot callback — runs after all providers booted. */
+    boot(fn: () => Promise<void> | void): void;
+    /** Register an async shutdown callback — runs in REVERSE registration order. */
+    shutdown(fn: () => Promise<void> | void): void;
+}
+/** The closure form's setup signature. */
+export type PluginSetup = (ctx: PluginContext) => void | Promise<void>;
+export interface PluginDefinition {
+    readonly $kind: "plugin";
+    readonly name: string;
+    /**
+     * Synchronous container registration — runs before any provider boot.
+     * Use for value bindings the plugin will need later.
+     */
+    readonly register?: (container: Container) => void;
+    /**
+     * Closure-form setup. The framework runs this during plugin-register
+     * with `{ container, runtime, config }` and the builder helpers. Only
+     * set by the closure form; object-form plugins leave it undefined.
+     */
+    readonly setup?: PluginSetup;
+    /**
+     * Async startup. Runs AFTER providers have booted, BEFORE modules begin
+     * receiving traffic. Use for any I/O the plugin needs (connect to OTEL
+     * collector, prefetch policy, warm cache).
+     */
+    readonly boot?: (container: Container) => Promise<void> | void;
+    /** Async teardown. Runs in reverse plugin order on app.stop(). */
+    readonly shutdown?: (container: Container) => Promise<void> | void;
+    /** Dispatch middlewares the plugin contributes. Runs onion-style. */
+    readonly middleware?: readonly DispatchMiddleware[];
+    /** Actor lifecycle hooks the plugin contributes. */
+    readonly actorHooks?: PluginActorHooks;
+}
+export interface PluginOptions {
+    readonly register?: (container: Container) => void;
+    readonly boot?: (container: Container) => Promise<void> | void;
+    readonly shutdown?: (container: Container) => Promise<void> | void;
+    readonly middleware?: readonly DispatchMiddleware[];
+    readonly actorHooks?: PluginActorHooks;
+}
+/**
+ * Two callable shapes:
+ *
+ *   definePlugin("name", (ctx) => { ... })          // closure form
+ *   definePlugin("name", { register, boot, ... })   // object form
+ */
+export declare function definePlugin(name: string, setup: PluginSetup): PluginDefinition;
+export declare function definePlugin(name: string, options: PluginOptions): PluginDefinition;
+/**
+ * Build a PluginContext bound to a specific container + runtime + config,
+ * collecting boot/shutdown callbacks the closure registers. Used by
+ * createApp's plugin-register loop. Returns the bound API + the lists of
+ * boot/shutdown functions for createApp to wire into its lifecycle.
+ */
+export declare function buildPluginContext(container: Container, runtime: Runtime, config: Record<string, any>): {
+    readonly api: PluginContext;
+    readonly boots: Array<() => Promise<void> | void>;
+    readonly shutdowns: Array<() => Promise<void> | void>;
+};
+//# sourceMappingURL=define-plugin.d.ts.map

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

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

package/dist/define-plugin.js

@@ -0,0 +1,134 @@
+/**
+ * `definePlugin` — first-class extension primitive.
+ *
+ * Plugins extend the FRAMEWORK; modules provide DOMAIN. The distinction is
+ * load-bearing — module code is "what the system does"; plugin code is
+ * "what cuts across the system."
+ *
+ *   Plugin examples (cross-cutting):
+ *     - Tracing: open a span around every dispatch (middleware).
+ *     - Audit log: persist {action, user, input, result} per dispatch.
+ *     - Authz: enforce per-action policy before dispatch.
+ *     - Rate-limiting: throttle dispatches by user / tenant / action.
+ *     - Observability: register Prometheus metrics, expose /metrics.
+ *
+ * Two authoring forms — pick whichever is clearer:
+ *
+ *   1. Closure form (recommended for most plugins):
+ *
+ *      definePlugin("audit", ({ bind, on, after, middleware, boot }) => {
+ *        const log = bind("auditLog", () => new AuditLog())
+ *        after("post.publish", async ({ result }) => log.write(result))
+ *        middleware(async (next, action, input, ctx) => {
+ *          log.start(ctx.envelope.messageId, action.name)
+ *          try { return await next() }
+ *          finally { log.finish(ctx.envelope.messageId) }
+ *        })
+ *        boot(async () => log.connect())
+ *      })
+ *
+ *   2. Object form (kept for back-compat and explicit-lifecycle cases):
+ *
+ *      definePlugin("audit", {
+ *        register: (container) => container.register("auditLog", ...),
+ *        boot:     async (container) => { ... },
+ *        shutdown: async (container) => { ... },
+ *        middleware: [ ... ],
+ *      })
+ *
+ * The closure form's `on`/`before`/`after` subscribe to framework events
+ * (see `framework-events.ts`) so plugins can react to lifecycle and
+ * dispatch events the same way they'd react to a domain event — there is
+ * no separate "hooks" system.
+ *
+ * Plugins are listed in `createApp({ plugins: [...] })`. Sequencing:
+ *   start: plugin register / setup (sync) → providers boot → plugin boot
+ *   stop:  shutdown plugins in reverse → shutdown providers in reverse
+ */
+import { ActionDispatching as ActionDispatchingEvent, ActionCompleted as ActionCompletedEvent, } from "./framework-events.js";
+export function definePlugin(name, setupOrOptions) {
+    if (typeof setupOrOptions === "function") {
+        return {
+            $kind: "plugin",
+            name,
+            setup: setupOrOptions,
+        };
+    }
+    const opts = setupOrOptions;
+    return {
+        $kind: "plugin",
+        name,
+        register: opts.register,
+        boot: opts.boot,
+        shutdown: opts.shutdown,
+        middleware: opts.middleware,
+        actorHooks: opts.actorHooks,
+    };
+}
+/**
+ * Build a PluginContext bound to a specific container + runtime + config,
+ * collecting boot/shutdown callbacks the closure registers. Used by
+ * createApp's plugin-register loop. Returns the bound API + the lists of
+ * boot/shutdown functions for createApp to wire into its lifecycle.
+ */
+export function buildPluginContext(container, runtime, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+config) {
+    const boots = [];
+    const shutdowns = [];
+    const api = {
+        container,
+        runtime,
+        config,
+        bind(bindingName, factory) {
+            let cached;
+            let computed = false;
+            container.register(bindingName, () => {
+                if (!computed) {
+                    cached = factory();
+                    computed = true;
+                }
+                return cached;
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            });
+            return bindingName;
+        },
+        resolve(bindingName) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return container.resolve(bindingName);
+        },
+        on(event, handler, priority) {
+            runtime.onFramework(event, handler, priority);
+        },
+        before(actionName, handler) {
+            runtime.onFramework(ActionDispatchingEvent, async (payload) => {
+                if (payload.action.name !== actionName)
+                    return;
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                return (await handler(payload));
+            });
+        },
+        after(actionName, handler) {
+            runtime.onFramework(ActionCompletedEvent, async (payload) => {
+                if (payload.action.name !== actionName)
+                    return;
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                await handler(payload);
+            });
+        },
+        middleware(mw) {
+            runtime.use(mw);
+        },
+        actorHook(hook) {
+            runtime.registerActorTransitionHook(hook);
+        },
+        boot(fn) {
+            boots.push(fn);
+        },
+        shutdown(fn) {
+            shutdowns.push(fn);
+        },
+    };
+    return { api, boots, shutdowns };
+}
+//# sourceMappingURL=define-plugin.js.map

package/dist/define-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-plugin.js","sourceRoot":"","sources":["../src/define-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAQH,OAAO,EACL,iBAAiB,IAAI,sBAAsB,EAC3C,eAAe,IAAI,oBAAoB,GACxC,MAAM,oBAAoB,CAAC;AA6I5B,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,cAA2C;IAE3C,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;QACzC,OAAO;YACL,KAAK,EAAE,QAAQ;YACf,IAAI;YACJ,KAAK,EAAE,cAAc;SACtB,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,cAAc,CAAC;IAC5B,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,IAAI;QACJ,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAAoB,EACpB,OAAgB;AAChB,8DAA8D;AAC9D,MAA2B;IAM3B,MAAM,KAAK,GAAsC,EAAE,CAAC;IACpD,MAAM,SAAS,GAAsC,EAAE,CAAC;IAExD,MAAM,GAAG,GAAkB;QACzB,SAAS;QACT,OAAO;QACP,MAAM;QACN,IAAI,CAAI,WAAmB,EAAE,OAAgB;YAC3C,IAAI,MAAqB,CAAC;YAC1B,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;gBACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,MAAM,GAAG,OAAO,EAAE,CAAC;oBACnB,QAAQ,GAAG,IAAI,CAAC;gBAClB,CAAC;gBACD,OAAO,MAAW,CAAC;gBACnB,8DAA8D;YAChE,CAAC,CAAQ,CAAC;YACV,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,OAAO,CAAI,WAAmB;YAC5B,8DAA8D;YAC9D,OAAO,SAAS,CAAC,OAAO,CAAI,WAAkB,CAAC,CAAC;QAClD,CAAC;QACD,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ;YACzB,OAAO,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAChD,CAAC;QACD,MAAM,CAAC,UAAU,EAAE,OAAO;YACxB,OAAO,CAAC,WAAW,CAAC,sBAAsB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;gBAC5D,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU;oBAAE,OAAO;gBAC/C,8DAA8D;gBAC9D,OAAO,CAAC,MAAM,OAAO,CAAC,OAAc,CAAC,CAAiB,CAAC;YACzD,CAAC,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,UAAU,EAAE,OAAO;YACvB,OAAO,CAAC,WAAW,CAAC,oBAAoB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;gBAC1D,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU;oBAAE,OAAO;gBAC/C,8DAA8D;gBAC9D,MAAM,OAAO,CAAC,OAAc,CAAC,CAAC;YAChC,CAAC,CAAC,CAAC;QACL,CAAC;QACD,UAAU,CAAC,EAAE;YACX,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;QACD,SAAS,CAAC,IAAI;YACZ,OAAO,CAAC,2BAA2B,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,EAAE;YACL,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,QAAQ,CAAC,EAAE;YACT,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrB,CAAC;KACF,CAAC;IAEF,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AACnC,CAAC"}