@nwire/forge 0.9.1 → 0.10.0

package/dist/define-module.d.ts

@@ -1,160 +0,0 @@
-/**
- * `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 SourceLocation } from "@nwire/messages";
-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;
-    /** Where the module was declared. Studio uses this for IDE-open links. */
-    readonly $source?: SourceLocation;
-}
-export declare function defineModule(name: string, manifest: ModuleManifest): ModuleDefinition;
-//# sourceMappingURL=define-module.d.ts.map

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

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

package/dist/define-module.js

@@ -1,63 +0,0 @@
-/**
- * `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 { captureSourceLocation } from "@nwire/messages";
-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) {
-    const $source = captureSourceLocation();
-    // 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,
-        $source,
-    };
-}
-//# sourceMappingURL=define-module.js.map

package/dist/define-module.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"define-module.js","sourceRoot":"","sources":["../src/define-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,qBAAqB,EAAuB,MAAM,iBAAiB,CAAC;AAwJ7E,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,MAAM,OAAO,GAAG,qBAAqB,EAAE,CAAC;IACxC,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;QACb,OAAO;KACR,CAAC;AACJ,CAAC"}

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

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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

@@ -1,195 +0,0 @@
-/**
- * `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 SourceLocation } from "@nwire/messages";
-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";
-import type { AppPluginDefinition } from "@nwire/app";
-/** 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;
-    /** Call-site of `definePlugin(...)` — Studio + scan render this. */
-    readonly $source?: SourceLocation;
-}
-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>, pluginName?: string): {
-    readonly api: PluginContext;
-    readonly boots: Array<() => Promise<void> | void>;
-    readonly shutdowns: Array<() => Promise<void> | void>;
-};
-/**
- * Adapt a narrow `@nwire/app` plugin into the rich forge `PluginDefinition`
- * createApp expects. The narrow shape (provide / on / boot / shutdown) is a
- * strict subset of the rich shape, so the adaptation is straight forwarding:
- *
- *   - `provide(name, lifecycle)` becomes a `bind` whose factory invokes the
- *     lifecycle's `boot()` once, plus a shutdown step that runs
- *     `lifecycle.shutdown(value)` against the resolved value if it was ever
- *     materialized. Lazy resolution matches the rich `bind` contract — a
- *     value nobody asks for is never booted (and therefore never torn down).
- *   - `on(FrameworkEvent, handler, prio?)` maps 1:1 onto `runtime.onFramework`,
- *     which is what the rich `api.on` already does internally.
- *   - `boot(fn)` / `shutdown(fn)` map 1:1.
- *
- * The narrow plugin's `setup` may be async; we honor that by returning a
- * Promise from the rich setup. createApp's sync register loop rejects async
- * rich setups today, so app-plugin authors who need async work should put it
- * inside `api.boot(...)` — same rule as forge's closure form.
- */
-export declare function adaptAppPlugin(app: AppPluginDefinition): PluginDefinition;
-//# sourceMappingURL=define-plugin.d.ts.map

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

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

package/dist/define-plugin.js

@@ -1,220 +0,0 @@
-/**
- * `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 { captureSourceLocation } from "@nwire/messages";
-export function definePlugin(name, setupOrOptions) {
-    const $source = captureSourceLocation();
-    if (typeof setupOrOptions === "function") {
-        return {
-            $kind: "plugin",
-            name,
-            setup: setupOrOptions,
-            $source,
-        };
-    }
-    const opts = setupOrOptions;
-    return {
-        $kind: "plugin",
-        name,
-        register: opts.register,
-        boot: opts.boot,
-        shutdown: opts.shutdown,
-        middleware: opts.middleware,
-        actorHooks: opts.actorHooks,
-        $source,
-    };
-}
-/**
- * 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, pluginName = "anonymous") {
-    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) {
-            // Register a chain step on the per-action `action.before:<name>`
-            // hook. Each plugin's contribution gets its own named step so taps
-            // emit a distinct `hook.step` record — the chain is now a first-
-            // class observable surface (listHooks() / Studio / OTel see it).
-            // Returning false from the handler sets the veto flag the runtime
-            // checks immediately after the hook resolves.
-            const stepName = `plugin#${pluginName ?? "?"}.before`;
-            runtime.ensureActionBeforeHook(actionName).use(async (hctx, next) => {
-                const decision = await handler({
-                    action: hctx.action,
-                    input: hctx.input,
-                    ctx: hctx.ctx,
-                });
-                if (decision === false) {
-                    hctx.vetoed = true;
-                    return; // skip `next()` — downstream steps shouldn't run on veto
-                }
-                await next();
-            }, { name: stepName });
-        },
-        after(actionName, handler) {
-            const stepName = `plugin#${pluginName ?? "?"}.after`;
-            runtime.ensureActionAfterHook(actionName).use(async (hctx, next) => {
-                await handler({
-                    action: hctx.action,
-                    input: hctx.input,
-                    result: hctx.result,
-                    durationMs: hctx.durationMs,
-                });
-                await next();
-            }, { name: stepName });
-        },
-        middleware(mw) {
-            runtime.use(mw);
-        },
-        actorHook(hook) {
-            runtime.registerActorTransitionHook(hook);
-        },
-        boot(fn) {
-            boots.push(fn);
-        },
-        shutdown(fn) {
-            shutdowns.push(fn);
-        },
-    };
-    return { api, boots, shutdowns };
-}
-/**
- * Adapt a narrow `@nwire/app` plugin into the rich forge `PluginDefinition`
- * createApp expects. The narrow shape (provide / on / boot / shutdown) is a
- * strict subset of the rich shape, so the adaptation is straight forwarding:
- *
- *   - `provide(name, lifecycle)` becomes a `bind` whose factory invokes the
- *     lifecycle's `boot()` once, plus a shutdown step that runs
- *     `lifecycle.shutdown(value)` against the resolved value if it was ever
- *     materialized. Lazy resolution matches the rich `bind` contract — a
- *     value nobody asks for is never booted (and therefore never torn down).
- *   - `on(FrameworkEvent, handler, prio?)` maps 1:1 onto `runtime.onFramework`,
- *     which is what the rich `api.on` already does internally.
- *   - `boot(fn)` / `shutdown(fn)` map 1:1.
- *
- * The narrow plugin's `setup` may be async; we honor that by returning a
- * Promise from the rich setup. createApp's sync register loop rejects async
- * rich setups today, so app-plugin authors who need async work should put it
- * inside `api.boot(...)` — same rule as forge's closure form.
- */
-export function adaptAppPlugin(app) {
-    return {
-        $kind: "plugin",
-        name: app.name,
-        $source: app.$source,
-        setup(ctx) {
-            // bus is exposed on the narrow context for advanced cases (the rich
-            // `on` only covers framework events). runtime.frameworkEvents is the
-            // same bus the rich api.on writes to, so passing it through is safe.
-            const narrow = {
-                container: ctx.container,
-                bus: ctx.runtime.frameworkEvents,
-                provide(name, lifecycle) {
-                    let booted = false;
-                    let value;
-                    ctx.bind(name, () => {
-                        // The narrow contract permits async boot; bind's factory is
-                        // sync. We synchronously kick the promise (if any) — consumers
-                        // resolving an async-provided binding get the Promise back,
-                        // mirroring what they'd get if they implemented `bind` directly.
-                        const result = lifecycle.boot();
-                        booted = true;
-                        value = result;
-                        return result;
-                    });
-                    if (lifecycle.shutdown) {
-                        ctx.shutdown(async () => {
-                            if (!booted)
-                                return;
-                            await lifecycle.shutdown(value);
-                        });
-                    }
-                },
-                on(event, handler, priority) {
-                    ctx.on(event, handler, priority);
-                },
-                boot(fn) {
-                    ctx.boot(fn);
-                },
-                shutdown(fn) {
-                    ctx.shutdown(fn);
-                },
-            };
-            return app.setup(narrow);
-        },
-    };
-}
-//# sourceMappingURL=define-plugin.js.map