@nwire/app 0.9.2 → 0.10.0

package/dist/create-app.js.map

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

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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAItF;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACvB,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1C,WAAW,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC9C;AAID;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAE9B;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAC;IAEhC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAE/D;;;;OAIG;IACH,EAAE,CAAC,QAAQ,EACT,KAAK,EAAE,wBAAwB,CAAC,QAAQ,CAAC,EACzC,OAAO,EAAE,qBAAqB,CAAC,QAAQ,CAAC,EACxC,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,CAAC;IAER;;;;;OAKG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;IAE3C;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;CAChD;AAID;;;;;;;;;GASG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,eAAe,EAAE,IAAI,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,oEAAoE;IACpE,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;CACnC;AAID;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACrD,mBAAmB,CAOrB;AAED,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,mBAAmB,CAMhE"}

package/dist/define-plugin.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"define-plugin.js","sourceRoot":"","sources":["../src/define-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,EAAE,qBAAqB,EAAuB,MAAM,iBAAiB,CAAC;AA8G7E,qEAAqE;AAErE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,KAAsD;IAEtD,OAAO;QACL,eAAe,EAAE,IAAI;QACrB,IAAI;QACJ,KAAK;QACL,OAAO,EAAE,qBAAqB,EAAE;KACjC,CAAC;AACJ,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,WAAW,CAAC,CAAU;IACpC,OAAO,CACL,OAAO,CAAC,KAAK,QAAQ;QACrB,CAAC,KAAK,IAAI;QACT,CAAmC,CAAC,eAAe,KAAK,IAAI,CAC9D,CAAC;AACJ,CAAC"}

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

@@ -1,129 +0,0 @@
-/**
- * `FrameworkEventBus` — the dispatcher behind framework events.
- *
- * Owned by an app's runtime. One bus per app instance. Plugins, apps,
- * and modules subscribe with `bus.on(Event, handler)`; the runtime fires
- * events at the appropriate lifecycle points with `bus.fire(Event, payload)`.
- *
- * Internals: every event delegates to a `hook<TPayload>(name)` from
- * `@nwire/hooks`. Subscribers attach as hook chain steps (series /
- * series-bail) or hook listeners (parallel). Dispatch is `hook.run()` —
- * no parallel subscription map. Telemetry, replay, .tap observation,
- * cancellation all come from hooks substrate by construction.
- *
- * Dispatch semantics come from the event's `mode`:
- *
- *   parallel    → handlers fire as hook listeners (Promise.allSettled);
- *                 one failing doesn't affect others; errors are logged.
- *   series      → handlers fire as chain steps in priority order;
- *                 one throwing stops the chain.
- *   series-bail → handlers fire as chain steps in priority order;
- *                 returning `false` short-circuits (don't call next()).
- *                 `fire()` returns false to signal "prevented".
- *
- * The bus lives in `@nwire/app` (the "managed Container with lifecycle"
- * layer). `@nwire/forge` re-exports the same surface so consumers that
- * pull from forge get one import line.
- */
-import { type Hook } from "@nwire/hooks";
-import type { Logger } from "@nwire/logger";
-import type { FrameworkEventDefinition } from "./framework-events.js";
-/**
- * Handler signature. The handler MAY:
- *   - return nothing                            → "continue"
- *   - return false                              → "prevent" (series-bail only)
- *   - return a Promise resolving to either
- *   - throw                                     → "fail" (propagates in series modes,
- *                                                  logged-and-swallowed in parallel)
- *
- * In parallel/series modes the return value is ignored entirely.
- */
-export type FrameworkEventHandler<TPayload> = (payload: TPayload) => Promise<void | boolean> | void | boolean;
-/**
- * Per-fire observer — receives every framework-event firing on the bus.
- * Used by the dev logger, Studio Live stream, and OTel exporter to surface
- * lifecycle activity without each one re-subscribing per event type.
- *
- *   `phase: "fired"`     — handler chain completed without a veto.
- *   `phase: "prevented"` — a series-bail handler returned false.
- */
-export interface FrameworkEventObservation {
-    readonly eventName: string;
-    readonly payload: unknown;
-    readonly mode: "parallel" | "series" | "series-bail";
-    readonly phase: "fired" | "prevented";
-    readonly ts: string;
-}
-export type FrameworkEventObserver = (record: FrameworkEventObservation) => void;
-/**
- * The bus. Subscriptions and dispatch live here so an app's runtime stays
- * focused on the domain pipeline. Designed to be reusable — Studio, the
- * orchestrator, and external plugins all hit the same surface.
- */
-export declare class FrameworkEventBus {
-    private readonly observers;
-    private readonly logger;
-    /**
-     * One hook per event name. Each event's subscribers attach as chain
-     * steps (series / series-bail) or listeners (parallel) on its hook;
-     * dispatch is `hook.run()`. `listHooks()` + scan + Studio see every
-     * framework event in the registry by construction.
-     *
-     * Runtime can pass an `adoptHook` callback in the constructor; each
-     * lazily-created hook is adopted so taps flow into the canonical
-     * telemetry stream as `kind: "hook.step"`.
-     */
-    private readonly eventHooks;
-    private readonly adoptHook?;
-    constructor(logger: Logger, options?: {
-        adoptHook?: (h: Hook<unknown>) => void;
-        /**
-         * Built-in framework events to pre-create observation hooks for at
-         * construction. Pass the host's known event registry (e.g. forge's
-         * `builtInFrameworkEvents`) so `listHooks()` + scan see them BEFORE
-         * the first fire — Studio's Hooks page and CLI both consume that.
-         */
-        events?: ReadonlyArray<{
-            readonly name: string;
-        }>;
-    });
-    /** Lazily create + adopt the per-event hook. Bus dispatches through these. */
-    private ensureEventHook;
-    /**
-     * Subscribe to EVERY framework-event firing on this bus. Used by the
-     * dev logger, Studio Live, and OTel exporter to surface lifecycle
-     * activity without each one re-subscribing per event type.
-     *
-     * Returns an unsubscribe handle.
-     */
-    onFire(observer: FrameworkEventObserver): () => void;
-    private notify;
-    /**
-     * Subscribe to a framework event. `priority` controls ordering for
-     * series-bail / series modes (higher runs first; default 0). Framework
-     * built-ins should subscribe at priority 100+; debug/observer plugins
-     * at -100 so they see the final post-mutation state.
-     *
-     * Attaches to the per-event hook: as a listener (parallel mode) or as
-     * a chain step (series / series-bail). The returned handle calls
-     * `hook.off()` to detach.
-     */
-    on<TPayload>(event: FrameworkEventDefinition<TPayload>, handler: FrameworkEventHandler<TPayload>, priority?: number): () => void;
-    /**
-     * Fire a framework event. Resolves to `false` when a series-bail handler
-     * vetoed; `true` otherwise. The boolean is irrelevant for parallel /
-     * series modes and always returns `true` there.
-     *
-     * Internally: delegates to the per-event hook's `.run()` (parallel /
-     * series) or `.runDetailed()` (series-bail, to detect "prevented"
-     * outcome from short-circuit). The hook's observability surface (.tap,
-     * StepObservation) lights up automatically.
-     */
-    fire<TPayload>(event: FrameworkEventDefinition<TPayload>, payload: TPayload): Promise<boolean>;
-    /**
-     * Count subscribers for an event — diagnostic surface (Studio, tests).
-     * Sums chain steps and listeners attached to the per-event hook.
-     */
-    subscriberCount(event: FrameworkEventDefinition): number;
-}
-//# sourceMappingURL=framework-event-bus.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"framework-event-bus.d.ts","sourceRoot":"","sources":["../src/framework-event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAQ,KAAK,IAAI,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAEnE;;;;;;;;;GASG;AACH,MAAM,MAAM,qBAAqB,CAAC,QAAQ,IAAI,CAC5C,OAAO,EAAE,QAAQ,KACd,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC;AAE9C;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,aAAa,CAAC;IACrD,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AACD,MAAM,MAAM,sBAAsB,GAAG,CAAC,MAAM,EAAE,yBAAyB,KAAK,IAAI,CAAC;AAEjF;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC;;;;;;;;;OASG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAA6B;gBAGtD,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QACP,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;QACvC;;;;;WAKG;QACH,MAAM,CAAC,EAAE,aAAa,CAAC;YAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC9C;IASR,8EAA8E;IAC9E,OAAO,CAAC,eAAe;IASvB;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,IAAI;IAQpD,OAAO,CAAC,MAAM;IAgBd;;;;;;;;;OASG;IACH,EAAE,CAAC,QAAQ,EACT,KAAK,EAAE,wBAAwB,CAAC,QAAQ,CAAC,EACzC,OAAO,EAAE,qBAAqB,CAAC,QAAQ,CAAC,EACxC,QAAQ,GAAE,MAAU,GACnB,MAAM,IAAI;IAiCb;;;;;;;;;OASG;IACG,IAAI,CAAC,QAAQ,EACjB,KAAK,EAAE,wBAAwB,CAAC,QAAQ,CAAC,EACzC,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,OAAO,CAAC;IAgCnB;;;OAGG;IACH,eAAe,CAAC,KAAK,EAAE,wBAAwB,GAAG,MAAM;CAMzD"}

package/dist/framework-event-bus.js

@@ -1,188 +0,0 @@
-/**
- * `FrameworkEventBus` — the dispatcher behind framework events.
- *
- * Owned by an app's runtime. One bus per app instance. Plugins, apps,
- * and modules subscribe with `bus.on(Event, handler)`; the runtime fires
- * events at the appropriate lifecycle points with `bus.fire(Event, payload)`.
- *
- * Internals: every event delegates to a `hook<TPayload>(name)` from
- * `@nwire/hooks`. Subscribers attach as hook chain steps (series /
- * series-bail) or hook listeners (parallel). Dispatch is `hook.run()` —
- * no parallel subscription map. Telemetry, replay, .tap observation,
- * cancellation all come from hooks substrate by construction.
- *
- * Dispatch semantics come from the event's `mode`:
- *
- *   parallel    → handlers fire as hook listeners (Promise.allSettled);
- *                 one failing doesn't affect others; errors are logged.
- *   series      → handlers fire as chain steps in priority order;
- *                 one throwing stops the chain.
- *   series-bail → handlers fire as chain steps in priority order;
- *                 returning `false` short-circuits (don't call next()).
- *                 `fire()` returns false to signal "prevented".
- *
- * The bus lives in `@nwire/app` (the "managed Container with lifecycle"
- * layer). `@nwire/forge` re-exports the same surface so consumers that
- * pull from forge get one import line.
- */
-import { hook } from "@nwire/hooks";
-/**
- * The bus. Subscriptions and dispatch live here so an app's runtime stays
- * focused on the domain pipeline. Designed to be reusable — Studio, the
- * orchestrator, and external plugins all hit the same surface.
- */
-export class FrameworkEventBus {
-    observers = [];
-    logger;
-    /**
-     * One hook per event name. Each event's subscribers attach as chain
-     * steps (series / series-bail) or listeners (parallel) on its hook;
-     * dispatch is `hook.run()`. `listHooks()` + scan + Studio see every
-     * framework event in the registry by construction.
-     *
-     * Runtime can pass an `adoptHook` callback in the constructor; each
-     * lazily-created hook is adopted so taps flow into the canonical
-     * telemetry stream as `kind: "hook.step"`.
-     */
-    eventHooks = new Map();
-    adoptHook;
-    constructor(logger, options = {}) {
-        this.logger = logger;
-        this.adoptHook = options.adoptHook;
-        for (const event of options.events ?? []) {
-            this.ensureEventHook(event.name);
-        }
-    }
-    /** Lazily create + adopt the per-event hook. Bus dispatches through these. */
-    ensureEventHook(eventName) {
-        let h = this.eventHooks.get(eventName);
-        if (h)
-            return h;
-        h = hook(`framework.event:${eventName}`);
-        this.eventHooks.set(eventName, h);
-        this.adoptHook?.(h);
-        return h;
-    }
-    /**
-     * Subscribe to EVERY framework-event firing on this bus. Used by the
-     * dev logger, Studio Live, and OTel exporter to surface lifecycle
-     * activity without each one re-subscribing per event type.
-     *
-     * Returns an unsubscribe handle.
-     */
-    onFire(observer) {
-        this.observers.push(observer);
-        return () => {
-            const i = this.observers.indexOf(observer);
-            if (i >= 0)
-                this.observers.splice(i, 1);
-        };
-    }
-    notify(rec) {
-        // Observers run after the actual fire — they MUST NOT veto or alter
-        // semantics. Errors are swallowed + logged so a buggy observer can't
-        // break the lifecycle.
-        for (const o of this.observers) {
-            try {
-                o(rec);
-            }
-            catch (err) {
-                this.logger.error?.("framework-event observer threw", {
-                    event: rec.eventName,
-                    error: err?.message ?? String(err),
-                });
-            }
-        }
-    }
-    /**
-     * Subscribe to a framework event. `priority` controls ordering for
-     * series-bail / series modes (higher runs first; default 0). Framework
-     * built-ins should subscribe at priority 100+; debug/observer plugins
-     * at -100 so they see the final post-mutation state.
-     *
-     * Attaches to the per-event hook: as a listener (parallel mode) or as
-     * a chain step (series / series-bail). The returned handle calls
-     * `hook.off()` to detach.
-     */
-    on(event, handler, priority = 0) {
-        const eventHook = this.ensureEventHook(event.name);
-        if (event.mode === "parallel") {
-            const listener = async (payload) => {
-                try {
-                    await handler(payload);
-                }
-                catch (err) {
-                    this.logger.error?.("framework-event handler threw (parallel)", {
-                        event: event.name,
-                        error: err?.message ?? String(err),
-                    });
-                }
-            };
-            eventHook.on(listener, { priority });
-            return () => eventHook.off(listener);
-        }
-        // series + series-bail both run as chain steps; series-bail returning
-        // false short-circuits by not calling next().
-        const step = async (ctx, next) => {
-            const result = await handler(ctx);
-            if (event.mode === "series-bail" && result === false) {
-                // Don't call next() — short-circuits the chain. fire() sees
-                // outcome === "prevented" via runDetailed.
-                return;
-            }
-            await next();
-        };
-        eventHook.use(step, { priority });
-        return () => eventHook.off(step);
-    }
-    /**
-     * Fire a framework event. Resolves to `false` when a series-bail handler
-     * vetoed; `true` otherwise. The boolean is irrelevant for parallel /
-     * series modes and always returns `true` there.
-     *
-     * Internally: delegates to the per-event hook's `.run()` (parallel /
-     * series) or `.runDetailed()` (series-bail, to detect "prevented"
-     * outcome from short-circuit). The hook's observability surface (.tap,
-     * StepObservation) lights up automatically.
-     */
-    async fire(event, payload) {
-        const eventHook = this.ensureEventHook(event.name);
-        const ts = new Date().toISOString();
-        const obsRec = (phase) => ({
-            eventName: event.name,
-            payload,
-            mode: event.mode,
-            phase,
-            ts,
-        });
-        if (event.mode === "series-bail") {
-            const result = await eventHook.runDetailed(payload);
-            const fired = result.outcome === "completed";
-            if (!fired) {
-                this.logger.info?.("framework-event prevented by handler", {
-                    event: event.name,
-                });
-            }
-            this.notify(obsRec(fired ? "fired" : "prevented"));
-            return fired;
-        }
-        // parallel + series: hook.run handles dispatch; listener errors in
-        // parallel mode are swallowed by the listener wrapper in on(); chain
-        // errors in series mode propagate (matches old behaviour).
-        await eventHook.run(payload);
-        this.notify(obsRec("fired"));
-        return true;
-    }
-    /**
-     * Count subscribers for an event — diagnostic surface (Studio, tests).
-     * Sums chain steps and listeners attached to the per-event hook.
-     */
-    subscriberCount(event) {
-        const h = this.eventHooks.get(event.name);
-        if (!h)
-            return 0;
-        const counts = h.stepCounts();
-        return counts.chain + counts.listeners;
-    }
-}
-//# sourceMappingURL=framework-event-bus.js.map

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

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

package/dist/framework-events.d.ts

@@ -1,233 +0,0 @@
-/**
- * Framework events — lifecycle hooks expressed as values.
- *
- * The principle: every primitive is a value; lifecycle is events. There is
- * no separate "hooks" system — plugins (and apps) react to framework events
- * with the same `on(Event, handler)` shape they'd use for a domain event.
- *
- * Tense convention encodes dispatch semantics:
- *
- *   `*-ing`  → series-bail (sequential, return false to prevent, throw to fail)
- *   `*-ed`   → parallel (Promise.allSettled, fire-and-forget)
- *
- * A third mode `series` exists for the rare case where you need ordering
- * but no veto power — currently unused on built-in events but available to
- * apps that define their own framework-like events.
- *
- * ## What's in this file
- *
- * The generic infrastructure (`defineFrameworkEvent`, `FrameworkEventDefinition`)
- * and the app-lifecycle events (`AppRegistering` / `AppBooting` / `AppBooted` /
- * `AppReady` / `AppShuttingDown` / `AppShutdown`). These have no domain
- * coupling — they take only the app name + timing metadata.
- *
- * Action-specific events (`ActionDispatching` / `ActionCompleted` /
- * `ActionFailed`) and event-recording events (`EventRecording` /
- * `EventRecorded`) live in `@nwire/forge` because their payload types
- * reference forge-specific types (`ActionDefinition`, `HandlerContext`).
- *
- * Both packages re-export from each other through forge's index so that
- * `import { AppBooted, ActionCompleted } from "@nwire/forge"` keeps
- * working — most consumers don't notice the split.
- */
-/** Three dispatch modes. The tense of the event name picks one of these. */
-export type FrameworkEventMode = "parallel" | "series" | "series-bail";
-/** Framework event definition — name + dispatch mode + payload type. */
-export interface FrameworkEventDefinition<TPayload = unknown> {
-    readonly $kind: "framework-event";
-    readonly name: string;
-    readonly mode: FrameworkEventMode;
-    /** Type-only marker; runtime carries the actual payload. */
-    readonly __payload?: TPayload;
-}
-/**
- * Declare a framework event. The mode picks dispatch semantics:
- *
- *   defineFrameworkEvent<{...}>("nwire.action.dispatching", "series-bail");
- *   defineFrameworkEvent<{...}>("nwire.action.completed",   "parallel");
- *
- * App authors can declare their OWN framework events (e.g.
- * `defineFrameworkEvent<{ tenant: string }>("app.tenant-switched", "parallel")`)
- * and fire them through the same bus. Every subscriber pattern works
- * uniformly across built-in and user-defined events.
- */
-export declare function defineFrameworkEvent<TPayload>(name: string, mode: FrameworkEventMode): FrameworkEventDefinition<TPayload>;
-/**
- * Fired during `app.start()` right after plugin `register` has run, before
- * provider boot. Plugins/apps can return `false` here to short-circuit boot.
- */
-export declare const AppRegistering: FrameworkEventDefinition<{
-    readonly appName: string;
-}>;
-/**
- * Fired during `app.start()` after provider boot and before plugin `boot`
- * callbacks. Useful for diagnostics that need the container populated but
- * want to run before plugins start subscribing to real traffic.
- */
-export declare const AppBooting: FrameworkEventDefinition<{
-    readonly appName: string;
-}>;
-/**
- * Fired after `app.start()` completes — all providers booted, all plugins
- * booted, all initializers boot-phase complete. Safe to do post-boot work.
- */
-export declare const AppBooted: FrameworkEventDefinition<{
-    readonly appName: string;
-    readonly bootedAt: string;
-}>;
-/**
- * Fired after the wire is fully ready — endpoints listening, health checks
- * passing. This is the signal external observers (Studio, log aggregators)
- * use to start treating the app as live.
- */
-export declare const AppReady: FrameworkEventDefinition<{
-    readonly appName: string;
-    readonly readyAt: string;
-}>;
-/**
- * Fired at the start of `app.stop()` — interceptable so plugins can refuse
- * shutdown (e.g., "still draining work, give me 5 more seconds"). Throwing
- * fails the shutdown; the runtime then falls back to hard-timeout SIGKILL.
- */
-export declare const AppShuttingDown: FrameworkEventDefinition<{
-    readonly appName: string;
-    readonly reason?: string;
-}>;
-/** Fired after `app.stop()` completes — everything torn down. */
-export declare const AppShutdown: FrameworkEventDefinition<{
-    readonly appName: string;
-}>;
-/**
- * Fired once per plugin during `createApp` composition, before any boot
- * begins. Useful for an observer that wants to list "what's this app made
- * of?" before lifecycle starts. Observable; runs in parallel.
- */
-/**
- * `kind` distinguishes a plugin proper from a module that's been compiled
- * onto the plugin lifecycle. Optional + defaulting to "plugin" so existing
- * subscribers stay back-compat.
- */
-export type PluginKind = "plugin" | "module";
-export declare const PluginRegistered: FrameworkEventDefinition<{
-    readonly appName: string;
-    readonly pluginName: string;
-    readonly kind?: PluginKind;
-}>;
-/**
- * Fired before a plugin's `boot()` callback (object-form) or its `boot(...)`
- * fns registered via the closure-form setup. Interceptable — returning
- * `false` aborts boot of the whole app (the runtime treats a vetoed plugin
- * boot as a fatal startup failure, surfaced with the plugin name).
- */
-export declare const PluginBooting: FrameworkEventDefinition<{
-    readonly appName: string;
-    readonly pluginName: string;
-    readonly kind?: PluginKind;
-}>;
-/** Fired after a plugin's boot completes successfully. Observable. */
-export declare const PluginBooted: FrameworkEventDefinition<{
-    readonly appName: string;
-    readonly pluginName: string;
-    readonly durationMs: number;
-    readonly kind?: PluginKind;
-}>;
-/**
- * Fired before a plugin's `shutdown()` callback runs. Interceptable. Used
- * by observers that want to flush state before a plugin tears down.
- */
-export declare const PluginShuttingDown: FrameworkEventDefinition<{
-    readonly appName: string;
-    readonly pluginName: string;
-    readonly kind?: PluginKind;
-}>;
-/** Fired after a plugin's shutdown completes. Observable. */
-export declare const PluginShutdown: FrameworkEventDefinition<{
-    readonly appName: string;
-    readonly pluginName: string;
-    readonly durationMs: number;
-    readonly kind?: PluginKind;
-}>;
-/**
- * Fired before an interface is attached to a host (typically an endpoint).
- * The payload carries the transport id + the interface's `manifest()` so
- * subscribers can inspect the wired surface before it goes live.
- * Interceptable — return `false` to refuse the mount (useful for safety
- * gates like "this endpoint only accepts http interfaces").
- */
-export declare const WireMounting: FrameworkEventDefinition<{
-    readonly appName: string;
-    readonly transport: string;
-    readonly manifest: unknown;
-}>;
-/**
- * Fired after an interface attaches successfully. Observable. Subscribers
- * use this to register routes with introspection tools, expose the
- * transport in Studio, etc.
- */
-export declare const WireMounted: FrameworkEventDefinition<{
-    readonly appName: string;
-    readonly transport: string;
-    readonly manifest: unknown;
-}>;
-/**
- * Fired after an interface is unmounted (during shutdown or live re-mount).
- * Observable.
- */
-export declare const WireUnmounted: FrameworkEventDefinition<{
-    readonly appName: string;
-    readonly transport: string;
-}>;
-/**
- * Every built-in lifecycle event. Forge augments this list with its own
- * action / event-recording events; the union catalog lives there.
- */
-export declare const builtInLifecycleEvents: 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;
-    readonly kind?: PluginKind;
-}>, FrameworkEventDefinition<{
-    readonly appName: string;
-    readonly pluginName: string;
-    readonly kind?: PluginKind;
-}>, FrameworkEventDefinition<{
-    readonly appName: string;
-    readonly pluginName: string;
-    readonly durationMs: number;
-    readonly kind?: PluginKind;
-}>, FrameworkEventDefinition<{
-    readonly appName: string;
-    readonly pluginName: string;
-    readonly kind?: PluginKind;
-}>, FrameworkEventDefinition<{
-    readonly appName: string;
-    readonly pluginName: string;
-    readonly durationMs: number;
-    readonly kind?: PluginKind;
-}>, 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;
-}>];
-//# sourceMappingURL=framework-events.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"framework-events.d.ts","sourceRoot":"","sources":["../src/framework-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,4EAA4E;AAC5E,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEvE,wEAAwE;AACxE,MAAM,WAAW,wBAAwB,CAAC,QAAQ,GAAG,OAAO;IAC1D,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAC3C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,kBAAkB,GACvB,wBAAwB,CAAC,QAAQ,CAAC,CAEpC;AAID;;;GAGG;AACH,eAAO,MAAM,cAAc;sBACP,MAAM;EACgB,CAAC;AAE3C;;;;GAIG;AACH,eAAO,MAAM,UAAU;sBACH,MAAM;EACY,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,SAAS;sBACF,MAAM;uBACL,MAAM;EACO,CAAC;AAEnC;;;;GAIG;AACH,eAAO,MAAM,QAAQ;sBACD,MAAM;sBACN,MAAM;EACO,CAAC;AAElC;;;;GAIG;AACH,eAAO,MAAM,eAAe;sBACR,MAAM;sBACN,MAAM;EACkB,CAAC;AAE7C,iEAAiE;AACjE,eAAO,MAAM,WAAW;sBACJ,MAAM;EACU,CAAC;AAIrC;;;;GAIG;AACH;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE7C,eAAO,MAAM,gBAAgB;sBACT,MAAM;yBACH,MAAM;oBACX,UAAU;EACa,CAAC;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,aAAa;sBACN,MAAM;yBACH,MAAM;oBACX,UAAU;EACa,CAAC;AAE1C,sEAAsE;AACtE,eAAO,MAAM,YAAY;sBACL,MAAM;yBACH,MAAM;yBACN,MAAM;oBACX,UAAU;EACS,CAAC;AAEtC;;;GAGG;AACH,eAAO,MAAM,kBAAkB;sBACX,MAAM;yBACH,MAAM;oBACX,UAAU;EACmB,CAAC;AAEhD,6DAA6D;AAC7D,eAAO,MAAM,cAAc;sBACP,MAAM;yBACH,MAAM;yBACN,MAAM;oBACX,UAAU;EACW,CAAC;AAIxC;;;;;;GAMG;AACH,eAAO,MAAM,YAAY;sBACL,MAAM;wBACJ,MAAM;uBACP,OAAO;EACY,CAAC;AAEzC;;;;GAIG;AACH,eAAO,MAAM,WAAW;sBACJ,MAAM;wBACJ,MAAM;uBACP,OAAO;EACQ,CAAC;AAErC;;;GAGG;AACH,eAAO,MAAM,aAAa;sBACN,MAAM;wBACJ,MAAM;EACU,CAAC;AAIvC;;;GAGG;AACH,eAAO,MAAM,sBAAsB;sBAjJf,MAAM;;sBASN,MAAM;;sBAQN,MAAM;uBACL,MAAM;;sBASP,MAAM;sBACN,MAAM;;sBASN,MAAM;sBACN,MAAM;;sBAKN,MAAM;;sBAkBN,MAAM;yBACH,MAAM;oBACX,UAAU;;sBAUR,MAAM;yBACH,MAAM;oBACX,UAAU;;sBAKR,MAAM;yBACH,MAAM;yBACN,MAAM;oBACX,UAAU;;sBAQR,MAAM;yBACH,MAAM;oBACX,UAAU;;sBAKR,MAAM;yBACH,MAAM;yBACN,MAAM;oBACX,UAAU;;sBAaR,MAAM;wBACJ,MAAM;uBACP,OAAO;;sBASR,MAAM;wBACJ,MAAM;uBACP,OAAO;;sBAQR,MAAM;wBACJ,MAAM;GAwBlB,CAAC"}