@nwire/app 0.9.2 → 0.10.1

package/dist/framework-events.js

@@ -1,136 +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.
- */
-/**
- * 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 function defineFrameworkEvent(name, mode) {
-    return { $kind: "framework-event", name, mode };
-}
-// ─── App lifecycle ──────────────────────────────────────────────
-/**
- * Fired during `app.start()` right after plugin `register` has run, before
- * provider boot. Plugins/apps can return `false` here to short-circuit boot.
- */
-export const AppRegistering = defineFrameworkEvent("nwire.app.registering", "series-bail");
-/**
- * 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 const AppBooting = defineFrameworkEvent("nwire.app.booting", "series-bail");
-/**
- * Fired after `app.start()` completes — all providers booted, all plugins
- * booted, all initializers boot-phase complete. Safe to do post-boot work.
- */
-export const AppBooted = defineFrameworkEvent("nwire.app.booted", "parallel");
-/**
- * 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 const AppReady = defineFrameworkEvent("nwire.app.ready", "parallel");
-/**
- * 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 const AppShuttingDown = defineFrameworkEvent("nwire.app.shutting-down", "series-bail");
-/** Fired after `app.stop()` completes — everything torn down. */
-export const AppShutdown = defineFrameworkEvent("nwire.app.shutdown", "parallel");
-export const PluginRegistered = defineFrameworkEvent("nwire.plugin.registered", "parallel");
-/**
- * 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 const PluginBooting = defineFrameworkEvent("nwire.plugin.booting", "series-bail");
-/** Fired after a plugin's boot completes successfully. Observable. */
-export const PluginBooted = defineFrameworkEvent("nwire.plugin.booted", "parallel");
-/**
- * Fired before a plugin's `shutdown()` callback runs. Interceptable. Used
- * by observers that want to flush state before a plugin tears down.
- */
-export const PluginShuttingDown = defineFrameworkEvent("nwire.plugin.shutting-down", "series-bail");
-/** Fired after a plugin's shutdown completes. Observable. */
-export const PluginShutdown = defineFrameworkEvent("nwire.plugin.shutdown", "parallel");
-// ─── Wire (transport interface) lifecycle ──────────────────────────
-/**
- * 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 const WireMounting = defineFrameworkEvent("nwire.wire.mounting", "series-bail");
-/**
- * Fired after an interface attaches successfully. Observable. Subscribers
- * use this to register routes with introspection tools, expose the
- * transport in Studio, etc.
- */
-export const WireMounted = defineFrameworkEvent("nwire.wire.mounted", "parallel");
-/**
- * Fired after an interface is unmounted (during shutdown or live re-mount).
- * Observable.
- */
-export const WireUnmounted = defineFrameworkEvent("nwire.wire.unmounted", "parallel");
-// ─── Catalog ───────────────────────────────────────────────────────
-/**
- * Every built-in lifecycle event. Forge augments this list with its own
- * action / event-recording events; the union catalog lives there.
- */
-export const builtInLifecycleEvents = [
-    AppRegistering,
-    AppBooting,
-    AppBooted,
-    AppReady,
-    AppShuttingDown,
-    AppShutdown,
-    PluginRegistered,
-    PluginBooting,
-    PluginBooted,
-    PluginShuttingDown,
-    PluginShutdown,
-    WireMounting,
-    WireMounted,
-    WireUnmounted,
-];
-//# sourceMappingURL=framework-events.js.map

package/dist/framework-events.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"framework-events.js","sourceRoot":"","sources":["../src/framework-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAcH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,IAAwB;IAExB,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAClD,CAAC;AAED,mEAAmE;AAEnE;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,oBAAoB,CAE/C,uBAAuB,EAAE,aAAa,CAAC,CAAC;AAE3C;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,oBAAoB,CAE3C,mBAAmB,EAAE,aAAa,CAAC,CAAC;AAEvC;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,oBAAoB,CAG1C,kBAAkB,EAAE,UAAU,CAAC,CAAC;AAEnC;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,oBAAoB,CAGzC,iBAAiB,EAAE,UAAU,CAAC,CAAC;AAElC;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,oBAAoB,CAGhD,yBAAyB,EAAE,aAAa,CAAC,CAAC;AAE7C,iEAAiE;AACjE,MAAM,CAAC,MAAM,WAAW,GAAG,oBAAoB,CAE5C,oBAAoB,EAAE,UAAU,CAAC,CAAC;AAgBrC,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,CAIjD,yBAAyB,EAAE,UAAU,CAAC,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,oBAAoB,CAI9C,sBAAsB,EAAE,aAAa,CAAC,CAAC;AAE1C,sEAAsE;AACtE,MAAM,CAAC,MAAM,YAAY,GAAG,oBAAoB,CAK7C,qBAAqB,EAAE,UAAU,CAAC,CAAC;AAEtC;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,CAInD,4BAA4B,EAAE,aAAa,CAAC,CAAC;AAEhD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,cAAc,GAAG,oBAAoB,CAK/C,uBAAuB,EAAE,UAAU,CAAC,CAAC;AAExC,sEAAsE;AAEtE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,oBAAoB,CAI7C,qBAAqB,EAAE,aAAa,CAAC,CAAC;AAEzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,oBAAoB,CAI5C,oBAAoB,EAAE,UAAU,CAAC,CAAC;AAErC;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,oBAAoB,CAG9C,sBAAsB,EAAE,UAAU,CAAC,CAAC;AAEvC,sEAAsE;AAEtE;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,cAAc;IACd,UAAU;IACV,SAAS;IACT,QAAQ;IACR,eAAe;IACf,WAAW;IACX,gBAAgB;IAChB,aAAa;IACb,YAAY;IACZ,kBAAkB;IAClB,cAAc;IACd,YAAY;IACZ,WAAW;IACX,aAAa;CACL,CAAC"}

package/dist/runtime.d.ts

@@ -1,185 +0,0 @@
-/**
- * Runtime — generic dispatch + observation substrate.
- *
- * The "app" half of the runtime: a managed Container, a hooks-backed
- * dispatch chain, a framework-event bus, and a canonical telemetry stream.
- * Domain engines (`@nwire/forge.Runtime`) extend this class and layer their
- * own registries (actors, workflows, projections, queries, event store)
- * on top.
- *
- * What this class owns:
- *   - A Container (default `createContainer()`).
- *   - The `runtime.dispatch` hook from `@nwire/hooks` — middleware substrate
- *     for any sub-class's per-action pipeline. Subclasses register the
- *     pinned innermost step that calls their handler; this base only owns
- *     the hook itself, the user-middleware adapter, and the tap into the
- *     telemetry stream.
- *   - The `FrameworkEventBus` — lifecycle events (`AppBooting`,
- *     `PluginRegistered`, …). Subclasses add per-action / per-actor events
- *     by registering more event definitions.
- *   - `onTelemetry` / `offTelemetry` / `emit` — the canonical observation
- *     stream every consumer (dev logger, Studio Live SSE, OTel exporter)
- *     listens on. Subclasses widen the `Telemetry` union with their own
- *     domain kinds (e.g. `action.dispatched`, `actor.transitioned`) and
- *     call `this.emit(record)` to push them through the same channel.
- */
-import { type Container } from "@nwire/container";
-import { type Hook } from "@nwire/hooks";
-import { type Logger } from "@nwire/logger";
-import { FrameworkEventBus, type FrameworkEventHandler } from "./framework-event-bus.js";
-import type { FrameworkEventDefinition } from "./framework-events.js";
-/**
- * Serialized form of any thrown value — `Error` instances keep `name` /
- * `message` / `stack` plus any own enumerable properties; non-Error throws
- * round-trip as `{ name: "NonError", message: String(err) }`. Used by every
- * telemetry record that carries an error payload.
- */
-export type SerializedError = {
-    readonly name: string;
-    readonly message: string;
-    readonly stack?: string;
-    readonly [k: string]: unknown;
-};
-export declare function serializeError(err: unknown): SerializedError;
-/**
- * `hook.step` — one record per chain/listener phase on any adopted hook.
- * `runId` / `parentRunId` link nested hook invocations into a causal tree
- * — that's what Studio's Trace page uses.
- */
-export interface HookStepTelemetry {
-    readonly kind: "hook.step";
-    readonly hookName: string;
-    readonly hookId: string;
-    readonly runId: string;
-    readonly parentRunId?: string;
-    readonly stepId: number;
-    readonly stepKind: "chain" | "listener";
-    readonly stepName?: string;
-    readonly phase: "start" | "end" | "error";
-    readonly durationMs?: number;
-    readonly error?: SerializedError;
-    readonly appName: string;
-    readonly ts: string;
-}
-/**
- * `lifecycle` — one record per framework-event firing on the bus. The
- * runtime bridges every fire into the telemetry stream so dev logger,
- * Studio Live, and OTel exporter all see lifecycle activity through the
- * same channel as domain events. `phase: "prevented"` flags series-bail
- * handlers that vetoed.
- */
-export interface LifecycleTelemetry {
-    readonly kind: "lifecycle";
-    readonly event: string;
-    readonly namespace: string;
-    readonly payload: unknown;
-    readonly phase: "fired" | "prevented";
-    readonly appName: string;
-    readonly ts: string;
-}
-/**
- * Base `Telemetry` union — generic kinds only. Subclasses (forge) WIDEN
- * this with their own domain kinds (`action.dispatched`, `event.published`,
- * `actor.transitioned`, …) and re-export the wider union as their own
- * `Telemetry` alias. Consumers that listen on the base accept everything;
- * consumers that care about discriminants narrow with `switch (rec.kind)`.
- */
-export type Telemetry = HookStepTelemetry | LifecycleTelemetry;
-export type TelemetryListener<T = Telemetry> = (record: T) => void;
-/**
- * Per-dispatch context passed through the `runtime.dispatch` hook. Subclass
- * dispatchers populate `coreFn` with their retry-loop + handler-invocation
- * closure; the pinned innermost chain step calls it and writes `result`.
- * User middlewares attached via `runtime.use()` see this ctx via adapters
- * that re-expose the legacy `(next, action, input, ctx)` shape.
- *
- * Types here are deliberately structural / unknown — the base runtime
- * doesn't know what an "action" or "context" looks like; forge tightens
- * the generics in its own re-export.
- */
-export interface DispatchHookCtx {
-    readonly action: unknown;
-    readonly input: unknown;
-    readonly ctx: unknown;
-    readonly coreFn: () => Promise<unknown>;
-    result?: unknown;
-}
-/**
- * Onion-style extension point around action dispatch. Outermost first;
- * registration order is execution order (matches Koa/express semantics).
- * Middlewares run OUTSIDE any retry loop — one pass per dispatch.
- */
-export type DispatchMiddleware = (next: () => Promise<unknown>, action: unknown, input: unknown, ctx: unknown) => Promise<unknown>;
-export interface RuntimeOptions {
-    readonly container?: Container;
-    readonly logger?: Logger;
-    /**
-     * App / service name. Stamped on every telemetry record so a single
-     * multi-tenant observer can demux records by origin.
-     */
-    readonly appName?: string;
-    /**
-     * Framework events to pre-create hooks for. The bus also lazily creates
-     * a hook the first time `bus.on(Event, …)` or `bus.fire(Event, …)` runs
-     * — but eager creation surfaces every known event in `listHooks()` +
-     * scan + Studio before any subscription has happened.
-     */
-    readonly events?: readonly FrameworkEventDefinition<unknown>[];
-}
-export declare class Runtime {
-    protected readonly container: Container;
-    protected readonly logger: Logger;
-    readonly appName: string;
-    /**
-     * Dispatch substrate. Subclasses register their pinned `handler` step at
-     * priority `-Infinity` and call `dispatchHook.run(ctx)` from their own
-     * `dispatch` method. The tap forwards every chain step to the canonical
-     * telemetry stream.
-     */
-    protected readonly dispatchHook: Hook<DispatchHookCtx>;
-    private userMiddlewareCount;
-    readonly frameworkEvents: FrameworkEventBus;
-    private readonly telemetryListeners;
-    constructor(options?: RuntimeOptions);
-    /**
-     * Subscribe to a framework event. Sugar over `runtime.frameworkEvents.on`
-     * so plugins can write `runtime.onFramework(ActionDispatching, ...)`.
-     * Returns an unsubscribe function.
-     */
-    onFramework<TPayload>(event: FrameworkEventDefinition<TPayload>, handler: FrameworkEventHandler<TPayload>, priority?: number): () => void;
-    /**
-     * Register a dispatch middleware. Outermost first — the order you call
-     * `use()` is the order layers wrap (first `use` is the outermost layer).
-     * Middlewares run once per dispatch, outside the retry loop.
-     *
-     * Each user middleware gets a distinct negative priority so the chain
-     * order matches registration order; the pinned subclass-owned "handler"
-     * step at `-Infinity` stays strictly innermost.
-     */
-    use(middleware: DispatchMiddleware): void;
-    /**
-     * Wire a hook's per-step tap into the canonical telemetry stream. After
-     * this call, every `.use()` / `.on()` step on the hook emits a
-     * `kind: "hook.step"` record through `runtime.onTelemetry`, the same way
-     * the built-in `runtime.dispatch` hook does.
-     *
-     * The framework calls this for every per-plugin / per-module lifecycle
-     * hook; plugin authors can call it on their own hooks if they want their
-     * extension points surfaced in Studio / dev-logger / OTel for free.
-     */
-    adoptHook<TCtx>(hook: Hook<TCtx>): void;
-    /**
-     * Subscribe to the canonical telemetry stream. Returns an unsubscribe.
-     * Throwing in a listener is caught and logged; never breaks dispatch.
-     */
-    onTelemetry<T = Telemetry>(listener: TelemetryListener<T>): () => void;
-    offTelemetry<T = Telemetry>(listener: TelemetryListener<T>): void;
-    /**
-     * Push a record onto the telemetry stream. Accepts `unknown` so
-     * subclass-widened records (CQRS kinds in forge) don't need cast
-     * gymnastics — listeners narrow with `switch (rec.kind)`.
-     */
-    protected emit(record: unknown): void;
-    getContainer(): Container;
-}
-//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

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

package/dist/runtime.js

@@ -1,197 +0,0 @@
-/**
- * Runtime — generic dispatch + observation substrate.
- *
- * The "app" half of the runtime: a managed Container, a hooks-backed
- * dispatch chain, a framework-event bus, and a canonical telemetry stream.
- * Domain engines (`@nwire/forge.Runtime`) extend this class and layer their
- * own registries (actors, workflows, projections, queries, event store)
- * on top.
- *
- * What this class owns:
- *   - A Container (default `createContainer()`).
- *   - The `runtime.dispatch` hook from `@nwire/hooks` — middleware substrate
- *     for any sub-class's per-action pipeline. Subclasses register the
- *     pinned innermost step that calls their handler; this base only owns
- *     the hook itself, the user-middleware adapter, and the tap into the
- *     telemetry stream.
- *   - The `FrameworkEventBus` — lifecycle events (`AppBooting`,
- *     `PluginRegistered`, …). Subclasses add per-action / per-actor events
- *     by registering more event definitions.
- *   - `onTelemetry` / `offTelemetry` / `emit` — the canonical observation
- *     stream every consumer (dev logger, Studio Live SSE, OTel exporter)
- *     listens on. Subclasses widen the `Telemetry` union with their own
- *     domain kinds (e.g. `action.dispatched`, `actor.transitioned`) and
- *     call `this.emit(record)` to push them through the same channel.
- */
-import { createContainer } from "@nwire/container";
-import { hook } from "@nwire/hooks";
-import { NoopLogger } from "@nwire/logger";
-import { FrameworkEventBus } from "./framework-event-bus.js";
-export function serializeError(err) {
-    if (err instanceof Error) {
-        const out = {
-            name: err.name,
-            message: err.message,
-            stack: err.stack,
-        };
-        for (const k of Object.keys(err)) {
-            if (k === "name" || k === "message" || k === "stack")
-                continue;
-            out[k] = err[k];
-        }
-        return out;
-    }
-    return { name: "NonError", message: String(err) };
-}
-export class Runtime {
-    container;
-    logger;
-    appName;
-    /**
-     * Dispatch substrate. Subclasses register their pinned `handler` step at
-     * priority `-Infinity` and call `dispatchHook.run(ctx)` from their own
-     * `dispatch` method. The tap forwards every chain step to the canonical
-     * telemetry stream.
-     */
-    dispatchHook;
-    userMiddlewareCount = 0;
-    frameworkEvents;
-    telemetryListeners = [];
-    constructor(options = {}) {
-        this.container = options.container ?? createContainer();
-        this.logger = options.logger ?? new NoopLogger();
-        this.appName = options.appName ?? "app";
-        this.frameworkEvents = new FrameworkEventBus(this.logger, {
-            adoptHook: (h) => this.adoptHook(h),
-            events: options.events ?? [],
-        });
-        // Bridge framework-event firings into the telemetry stream so every
-        // existing telemetry consumer (dev logger, Studio Live SSE, OTel
-        // exporter) sees lifecycle activity through the same channel as
-        // domain events. `namespace` = the second dotted segment so dev
-        // logger / Studio can group by phase (app / plugin / wire / …).
-        this.frameworkEvents.onFire((rec) => {
-            const parts = rec.eventName.split(".");
-            const namespace = parts.length >= 2 ? parts[1] : "framework";
-            this.emit({
-                kind: "lifecycle",
-                event: rec.eventName,
-                namespace,
-                payload: rec.payload,
-                phase: rec.phase,
-                appName: this.appName,
-                ts: rec.ts,
-            });
-        });
-        this.dispatchHook = hook("runtime.dispatch");
-        this.dispatchHook.tap((obs) => {
-            this.emit({
-                kind: "hook.step",
-                hookName: obs.hookName,
-                hookId: obs.hookId,
-                runId: obs.runId,
-                parentRunId: obs.parentRunId,
-                stepId: obs.stepId,
-                stepKind: obs.stepKind,
-                stepName: obs.stepName,
-                phase: obs.phase,
-                durationMs: obs.durationMs,
-                error: obs.error ? serializeError(obs.error) : undefined,
-                appName: this.appName,
-                ts: new Date().toISOString(),
-            });
-        });
-    }
-    /**
-     * Subscribe to a framework event. Sugar over `runtime.frameworkEvents.on`
-     * so plugins can write `runtime.onFramework(ActionDispatching, ...)`.
-     * Returns an unsubscribe function.
-     */
-    onFramework(event, handler, priority = 0) {
-        return this.frameworkEvents.on(event, handler, priority);
-    }
-    /**
-     * Register a dispatch middleware. Outermost first — the order you call
-     * `use()` is the order layers wrap (first `use` is the outermost layer).
-     * Middlewares run once per dispatch, outside the retry loop.
-     *
-     * Each user middleware gets a distinct negative priority so the chain
-     * order matches registration order; the pinned subclass-owned "handler"
-     * step at `-Infinity` stays strictly innermost.
-     */
-    use(middleware) {
-        const priority = -this.userMiddlewareCount;
-        this.userMiddlewareCount += 1;
-        this.dispatchHook.use(async (hctx, next) => {
-            hctx.result = await middleware(async () => {
-                await next();
-                return hctx.result;
-            }, hctx.action, hctx.input, hctx.ctx);
-        }, { name: middleware.name || `middleware#${this.userMiddlewareCount}`, priority });
-    }
-    /**
-     * Wire a hook's per-step tap into the canonical telemetry stream. After
-     * this call, every `.use()` / `.on()` step on the hook emits a
-     * `kind: "hook.step"` record through `runtime.onTelemetry`, the same way
-     * the built-in `runtime.dispatch` hook does.
-     *
-     * The framework calls this for every per-plugin / per-module lifecycle
-     * hook; plugin authors can call it on their own hooks if they want their
-     * extension points surfaced in Studio / dev-logger / OTel for free.
-     */
-    adoptHook(hook) {
-        hook.tap((obs) => {
-            this.emit({
-                kind: "hook.step",
-                hookName: obs.hookName,
-                hookId: obs.hookId,
-                runId: obs.runId,
-                parentRunId: obs.parentRunId,
-                stepId: obs.stepId,
-                stepKind: obs.stepKind,
-                stepName: obs.stepName,
-                phase: obs.phase,
-                durationMs: obs.durationMs,
-                error: obs.error ? serializeError(obs.error) : undefined,
-                appName: this.appName,
-                ts: new Date().toISOString(),
-            });
-        });
-    }
-    /**
-     * Subscribe to the canonical telemetry stream. Returns an unsubscribe.
-     * Throwing in a listener is caught and logged; never breaks dispatch.
-     */
-    onTelemetry(listener) {
-        this.telemetryListeners.push(listener);
-        return () => this.offTelemetry(listener);
-    }
-    offTelemetry(listener) {
-        const i = this.telemetryListeners.indexOf(listener);
-        if (i >= 0)
-            this.telemetryListeners.splice(i, 1);
-    }
-    /**
-     * Push a record onto the telemetry stream. Accepts `unknown` so
-     * subclass-widened records (CQRS kinds in forge) don't need cast
-     * gymnastics — listeners narrow with `switch (rec.kind)`.
-     */
-    emit(record) {
-        if (this.telemetryListeners.length === 0)
-            return;
-        for (const listener of this.telemetryListeners) {
-            try {
-                listener(record);
-            }
-            catch (err) {
-                // Best-effort — don't let a bad listener break dispatch.
-                // eslint-disable-next-line no-console
-                console.error("Runtime.onTelemetry listener threw:", err);
-            }
-        }
-    }
-    getContainer() {
-        return this.container;
-    }
-}
-//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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