@nwire/app 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alex Gefter / 200apps Ltd.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,60 @@
+# @nwire/app
+
+> Container + plugin lifecycle + envelope — the app layer of the sealed v1.0 architecture.
+
+## What it does
+
+Composes modules and plugins into a managed Container, fires typed framework events at every lifecycle transition, and propagates correlation / tracing / tenant via the envelope. `definePlugin` is the single extension primitive; the bus carries `App*` events (`AppRegistering`, `AppBooting`, `AppBooted`, `AppReady`, `AppShuttingDown`, `AppShutdown`) plus any plugins declare themselves.
+
+## Install
+
+```bash
+pnpm add @nwire/app
+```
+
+## Quick start
+
+```ts
+import { FrameworkEventBus, AppBooted, defineFrameworkEvent } from "@nwire/app";
+import { NoopLogger } from "@nwire/logger";
+
+const bus = new FrameworkEventBus(new NoopLogger());
+
+bus.on(AppBooted, async ({ appName, bootedAt }) => {
+  console.log(`${appName} booted at ${bootedAt}`);
+});
+
+const TenantSwitched = defineFrameworkEvent<{ tenantId: string }>(
+  "app.tenant-switched",
+  "parallel",
+);
+bus.on(TenantSwitched, ({ tenantId }) => console.log(`switched to ${tenantId}`));
+
+await bus.fire(TenantSwitched, { tenantId: "acme" });
+```
+
+## API surface
+
+- `defineFrameworkEvent<TPayload>(name, mode)` — declare a typed lifecycle event.
+- `FrameworkEventBus` — typed dispatcher; one per app instance.
+- `AppRegistering` / `AppBooting` / `AppBooted` / `AppReady` / `AppShuttingDown` / `AppShutdown` — built-in lifecycle events.
+- `definePlugin(name, setup)` — closure-form plugin with `bind` / `provide` / `on` / `before` / `after` / `middleware` / `boot` / `shutdown`.
+- Dispatch modes — `parallel` (`*-ed`, fire-and-forget), `series` (sequential await), `series-bail` (`*-ing`, vetoable).
+
+## When to use
+
+The composition root for any non-trivial Nwire app. Standalone (L2): use framework events as a generic typed pub/sub for any lifecycle. Full-stack (L4/L5): pair with `@nwire/forge` and the bus carries `ActionDispatching` / `ActionCompleted` / `ActionFailed` alongside lifecycle events.
+
+## Used only within nwire-app
+
+This package is part of the Nwire stack — it only makes sense inside a Nwire application built with `@nwire/app` + `@nwire/forge`. If you're looking for a standalone primitive, see:
+
+- [`@nwire/handler`](../nwire-handler/README.md) — the operation primitive (transport-agnostic)
+- [`@nwire/hooks`](../nwire-hooks/README.md) — universal dispatch (chain + listeners)
+- [`@nwire/http`](../nwire-http/README.md) — typed HTTP without forge
+- [`@nwire/endpoint`](../nwire-endpoint/README.md) — graceful shutdown for any host
+
+## See also
+
+- [Architecture sketch §05 — App tier](../../architecture-sketch.html#packages)
+- Sibling packages: [@nwire/container](../nwire-container), [@nwire/endpoint](../nwire-endpoint), [@nwire/forge](../nwire-forge)

package/dist/__tests__/define-plugin.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `definePlugin` (app-layer) — proves the narrow shape works standalone.
+ *
+ * We exercise every builder in the AppPluginContext using a tiny inline
+ * "runner" that mimics what `createApp` will do once it's also extracted:
+ * call `setup(ctx)`, collect what the closure registered, then invoke
+ * provide/boot/shutdown in the documented order, firing framework events
+ * at the transitions.
+ *
+ * The point: this primitive is genuinely standalone. No forge, no
+ * @nwire/http, no container-awilix. A consumer with `@nwire/app` +
+ * `@nwire/container` + `@nwire/logger` can build their own minimal
+ * lifecycle on top.
+ */
+export {};
+//# sourceMappingURL=define-plugin.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-plugin.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/define-plugin.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/__tests__/define-plugin.test.js

@@ -0,0 +1,269 @@
+/**
+ * `definePlugin` (app-layer) — proves the narrow shape works standalone.
+ *
+ * We exercise every builder in the AppPluginContext using a tiny inline
+ * "runner" that mimics what `createApp` will do once it's also extracted:
+ * call `setup(ctx)`, collect what the closure registered, then invoke
+ * provide/boot/shutdown in the documented order, firing framework events
+ * at the transitions.
+ *
+ * The point: this primitive is genuinely standalone. No forge, no
+ * @nwire/http, no container-awilix. A consumer with `@nwire/app` +
+ * `@nwire/container` + `@nwire/logger` can build their own minimal
+ * lifecycle on top.
+ */
+import { describe, it, expect } from "vitest";
+import { InMemoryContainer } from "@nwire/container";
+import { NoopLogger } from "@nwire/logger";
+import { definePlugin, isAppPlugin, FrameworkEventBus, AppBooting, AppBooted, AppShuttingDown, } from "../app.js";
+/**
+ * Tiny app runner that exercises the plugin context. This will be
+ * replaced by the real `createApp` in `@nwire/app` once the rest of
+ * Phase 69 lands. For now, this proves the primitive's surface works.
+ */
+async function runMinimalApp(plugins) {
+    const container = new InMemoryContainer();
+    const bus = new FrameworkEventBus(new NoopLogger());
+    /**
+     * Accumulators — the plugin context's builders push into these.
+     * The runner consumes them at the right lifecycle moment.
+     */
+    const provides = [];
+    const boots = [];
+    const shutdowns = [];
+    /**
+     * Track booted values so the runner can call their `shutdown(value)`
+     * at the right time — same way the real createApp will.
+     */
+    const booted = [];
+    const ctx = {
+        container,
+        bus,
+        provide(name, lifecycle) {
+            provides.push({ name, lifecycle: lifecycle });
+        },
+        on(event, handler, priority) {
+            bus.on(event, handler, priority);
+        },
+        boot(fn) {
+            boots.push(fn);
+        },
+        shutdown(fn) {
+            shutdowns.push(fn);
+        },
+    };
+    // 1. Run plugin setups in order
+    for (const p of plugins) {
+        await p.setup(ctx);
+    }
+    // 2. Fire AppBooting (interceptable)
+    const allowBoot = await bus.fire(AppBooting, { appName: "test" });
+    if (!allowBoot)
+        throw new Error("boot vetoed");
+    // 3. Resolve all bindings via their lifecycle.boot()
+    for (const { name, lifecycle } of provides) {
+        const value = await lifecycle.boot();
+        container.register(name, () => value);
+        booted.push({
+            name,
+            value,
+            shutdown: lifecycle.shutdown,
+        });
+    }
+    // 4. Run plugin boot() callbacks in order
+    for (const fn of boots)
+        await fn();
+    // 5. Fire AppBooted (observable)
+    await bus.fire(AppBooted, { appName: "test", bootedAt: new Date().toISOString() });
+    // Return a "running app" handle the test can interact with
+    return {
+        container,
+        bus,
+        async shutdown() {
+            // 6. Fire AppShuttingDown (interceptable)
+            const allow = await bus.fire(AppShuttingDown, { appName: "test" });
+            if (!allow)
+                throw new Error("shutdown vetoed");
+            // 7. Plugin shutdown callbacks in REVERSE order
+            for (let i = shutdowns.length - 1; i >= 0; i--) {
+                await shutdowns[i]();
+            }
+            // 8. Binding shutdowns in REVERSE order (last-registered first)
+            for (let i = booted.length - 1; i >= 0; i--) {
+                const b = booted[i];
+                if (b.shutdown)
+                    await b.shutdown(b.value);
+            }
+        },
+    };
+}
+describe("definePlugin (app layer)", () => {
+    it("returns a discriminable AppPluginDefinition", () => {
+        const p = definePlugin("test", () => undefined);
+        expect(isAppPlugin(p)).toBe(true);
+        expect(p.name).toBe("test");
+        expect(typeof p.setup).toBe("function");
+    });
+    it("isAppPlugin returns false for unrelated objects", () => {
+        expect(isAppPlugin({ name: "fake" })).toBe(false);
+        expect(isAppPlugin(null)).toBe(false);
+        expect(isAppPlugin("string")).toBe(false);
+    });
+});
+describe("definePlugin — provide bindings", () => {
+    it("provides a value that becomes resolvable on the container", async () => {
+        class Database {
+            ping() {
+                return "ok";
+            }
+        }
+        const plugin = definePlugin("db", ({ provide }) => {
+            provide("db", { boot: () => new Database() });
+        });
+        const app = await runMinimalApp([plugin]);
+        expect(app.container.resolve("db").ping()).toBe("ok");
+        await app.shutdown();
+    });
+    it("provided value's shutdown is called in reverse boot order", async () => {
+        const order = [];
+        const a = definePlugin("a", ({ provide }) => {
+            provide("a", {
+                boot: () => "a-value",
+                shutdown: () => {
+                    order.push("shutdown:a");
+                },
+            });
+        });
+        const b = definePlugin("b", ({ provide }) => {
+            provide("b", {
+                boot: () => "b-value",
+                shutdown: () => {
+                    order.push("shutdown:b");
+                },
+            });
+        });
+        const app = await runMinimalApp([a, b]);
+        await app.shutdown();
+        // Booted a then b, so shutdown happens b first, a second
+        expect(order).toEqual(["shutdown:b", "shutdown:a"]);
+    });
+});
+describe("definePlugin — framework event subscriptions", () => {
+    it("subscriptions fire when the bus fires the event", async () => {
+        const seen = [];
+        const plugin = definePlugin("observer", ({ on }) => {
+            on(AppBooted, ({ appName }) => {
+                seen.push(`booted:${appName}`);
+            });
+        });
+        const app = await runMinimalApp([plugin]);
+        expect(seen).toEqual(["booted:test"]);
+        await app.shutdown();
+    });
+    it("priority is respected in series-bail dispatch", async () => {
+        const order = [];
+        const plugin = definePlugin("prio", ({ on }) => {
+            on(AppShuttingDown, () => {
+                order.push("low");
+            }, 0);
+            on(AppShuttingDown, () => {
+                order.push("highest");
+            }, 100);
+            on(AppShuttingDown, () => {
+                order.push("debug");
+            }, -100);
+        });
+        const app = await runMinimalApp([plugin]);
+        await app.shutdown();
+        expect(order).toEqual(["highest", "low", "debug"]);
+    });
+    it("a subscription returning false vetoes a series-bail event", async () => {
+        const plugin = definePlugin("blocker", ({ on }) => {
+            on(AppShuttingDown, () => false);
+        });
+        const app = await runMinimalApp([plugin]);
+        await expect(app.shutdown()).rejects.toThrow("shutdown vetoed");
+    });
+});
+describe("definePlugin — boot + shutdown callbacks", () => {
+    it("boot callbacks run in declaration order", async () => {
+        const order = [];
+        const plugin = definePlugin("boot-order", ({ boot }) => {
+            boot(() => {
+                order.push("first");
+            });
+            boot(() => {
+                order.push("second");
+            });
+            boot(async () => {
+                order.push("third");
+            });
+        });
+        const app = await runMinimalApp([plugin]);
+        expect(order).toEqual(["first", "second", "third"]);
+        await app.shutdown();
+    });
+    it("shutdown callbacks run in REVERSE declaration order", async () => {
+        const order = [];
+        const plugin = definePlugin("shutdown-order", ({ shutdown }) => {
+            shutdown(() => {
+                order.push("first");
+            });
+            shutdown(() => {
+                order.push("second");
+            });
+            shutdown(() => {
+                order.push("third");
+            });
+        });
+        const app = await runMinimalApp([plugin]);
+        await app.shutdown();
+        // Reverse so "third" gets the resources first, undoes its work,
+        // then "second" can undo theirs without missing dependencies.
+        expect(order).toEqual(["third", "second", "first"]);
+    });
+});
+describe("definePlugin — composability", () => {
+    it("multiple plugins compose freely; each contribution flows through", async () => {
+        /**
+         * Realistic scenario: postgres plugin provides db; audit plugin uses
+         * AppBooted to log start; tracing plugin subscribes to AppShuttingDown.
+         * All compose into one app boot.
+         */
+        const logs = [];
+        const postgres = definePlugin("postgres", ({ provide }) => {
+            provide("db", {
+                boot: () => ({ kind: "fake-db" }),
+                shutdown: () => {
+                    logs.push("db-closed");
+                },
+            });
+        });
+        const audit = definePlugin("audit", ({ on, boot }) => {
+            on(AppBooted, ({ appName }) => {
+                logs.push(`audit-start:${appName}`);
+            });
+            boot(() => {
+                logs.push("audit-init");
+            });
+        });
+        const tracing = definePlugin("tracing", ({ on }) => {
+            on(AppShuttingDown, ({ reason }) => {
+                logs.push(`trace-end:${reason ?? "unknown"}`);
+            });
+        });
+        const app = await runMinimalApp([postgres, audit, tracing]);
+        expect(logs).toEqual([
+            "audit-init", // boot callback fires after providers register
+            "audit-start:test", // AppBooted observer fires
+        ]);
+        await app.shutdown();
+        expect(logs).toEqual([
+            "audit-init",
+            "audit-start:test",
+            "trace-end:unknown", // AppShuttingDown observer fires first
+            "db-closed", // db.shutdown(value) runs in reverse boot order
+        ]);
+    });
+});
+//# sourceMappingURL=define-plugin.test.js.map

package/dist/__tests__/define-plugin.test.js.map

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

package/dist/__tests__/framework-events.test.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Tests for the extracted framework-events surface in `@nwire/app`.
+ *
+ * What we exercise:
+ *
+ *   - `defineFrameworkEvent` returns a discriminable definition
+ *   - `FrameworkEventBus.fire()` dispatches per mode (parallel / series / series-bail)
+ *   - `series-bail` honors `false` returns (clean veto) vs throws (failure)
+ *   - Subscription priority ordering (higher = earlier)
+ *   - Unsubscribe + handler-count introspection
+ *   - Built-in lifecycle events have the expected names/modes
+ *
+ * These tests stand alone — they use only @nwire/app + @nwire/logger.
+ * That standalone-ness is the point: framework events are a generic
+ * pub/sub primitive useful anywhere, not coupled to forge.
+ */
+export {};
+//# sourceMappingURL=framework-events.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"framework-events.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/framework-events.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/__tests__/framework-events.test.js

@@ -0,0 +1,156 @@
+/**
+ * Tests for the extracted framework-events surface in `@nwire/app`.
+ *
+ * What we exercise:
+ *
+ *   - `defineFrameworkEvent` returns a discriminable definition
+ *   - `FrameworkEventBus.fire()` dispatches per mode (parallel / series / series-bail)
+ *   - `series-bail` honors `false` returns (clean veto) vs throws (failure)
+ *   - Subscription priority ordering (higher = earlier)
+ *   - Unsubscribe + handler-count introspection
+ *   - Built-in lifecycle events have the expected names/modes
+ *
+ * These tests stand alone — they use only @nwire/app + @nwire/logger.
+ * That standalone-ness is the point: framework events are a generic
+ * pub/sub primitive useful anywhere, not coupled to forge.
+ */
+import { describe, it, expect } from "vitest";
+import { NoopLogger } from "@nwire/logger";
+import { defineFrameworkEvent, FrameworkEventBus, AppRegistering, AppBooting, AppBooted, AppShuttingDown, AppShutdown, builtInLifecycleEvents, } from "../app.js";
+describe("defineFrameworkEvent", () => {
+    it("produces a discriminable definition with the requested mode", () => {
+        const evt = defineFrameworkEvent("test.event", "parallel");
+        expect(evt.$kind).toBe("framework-event");
+        expect(evt.name).toBe("test.event");
+        expect(evt.mode).toBe("parallel");
+    });
+});
+describe("FrameworkEventBus — dispatch modes", () => {
+    it("parallel: every handler runs, errors don't stop siblings", async () => {
+        const bus = new FrameworkEventBus(new NoopLogger());
+        const evt = defineFrameworkEvent("t.parallel", "parallel");
+        const seen = [];
+        bus.on(evt, () => {
+            seen.push(1);
+        });
+        bus.on(evt, () => {
+            throw new Error("ignored");
+        });
+        bus.on(evt, () => {
+            seen.push(2);
+        });
+        await bus.fire(evt, undefined);
+        expect(seen.sort()).toEqual([1, 2]);
+    });
+    it("series: handlers run sequentially; one throw kills the chain", async () => {
+        const bus = new FrameworkEventBus(new NoopLogger());
+        const evt = defineFrameworkEvent("t.series", "series");
+        const seen = [];
+        bus.on(evt, () => {
+            seen.push(1);
+        });
+        bus.on(evt, () => {
+            throw new Error("stop");
+        });
+        bus.on(evt, () => {
+            seen.push(3);
+        });
+        await expect(bus.fire(evt, undefined)).rejects.toThrow("stop");
+        expect(seen).toEqual([1]);
+    });
+    it("series-bail: false stops the chain cleanly + returns false", async () => {
+        const bus = new FrameworkEventBus(new NoopLogger());
+        const evt = defineFrameworkEvent("t.bail", "series-bail");
+        const seen = [];
+        bus.on(evt, () => {
+            seen.push(1);
+        });
+        bus.on(evt, () => false); // veto
+        bus.on(evt, () => {
+            seen.push(3);
+        });
+        const ok = await bus.fire(evt, undefined);
+        expect(ok).toBe(false);
+        expect(seen).toEqual([1]);
+    });
+    it("series-bail: undefined return continues the chain (fire returns true)", async () => {
+        const bus = new FrameworkEventBus(new NoopLogger());
+        const evt = defineFrameworkEvent("t.bail2", "series-bail");
+        const seen = [];
+        bus.on(evt, () => {
+            seen.push(1);
+        }); // returns undefined — continue
+        bus.on(evt, () => {
+            seen.push(2);
+        });
+        const ok = await bus.fire(evt, undefined);
+        expect(ok).toBe(true);
+        expect(seen).toEqual([1, 2]);
+    });
+});
+describe("FrameworkEventBus — priority + introspection", () => {
+    it("higher priority runs earlier in series + series-bail", async () => {
+        const bus = new FrameworkEventBus(new NoopLogger());
+        const evt = defineFrameworkEvent("t.priority", "series");
+        const order = [];
+        bus.on(evt, () => {
+            order.push("low");
+        }, 0);
+        bus.on(evt, () => {
+            order.push("highest");
+        }, 100);
+        bus.on(evt, () => {
+            order.push("debug");
+        }, -100);
+        await bus.fire(evt, undefined);
+        expect(order).toEqual(["highest", "low", "debug"]);
+    });
+    it("unsubscribe removes a handler", async () => {
+        const bus = new FrameworkEventBus(new NoopLogger());
+        const evt = defineFrameworkEvent("t.unsub", "parallel");
+        let calls = 0;
+        const off = bus.on(evt, () => {
+            calls++;
+        });
+        await bus.fire(evt, undefined);
+        expect(calls).toBe(1);
+        off();
+        await bus.fire(evt, undefined);
+        expect(calls).toBe(1); // didn't increment after unsubscribe
+    });
+    it("subscriberCount reports the current count", () => {
+        const bus = new FrameworkEventBus(new NoopLogger());
+        const evt = defineFrameworkEvent("t.count", "parallel");
+        expect(bus.subscriberCount(evt)).toBe(0);
+        bus.on(evt, () => undefined);
+        bus.on(evt, () => undefined);
+        expect(bus.subscriberCount(evt)).toBe(2);
+    });
+});
+describe("Built-in lifecycle events", () => {
+    /**
+     * The names + modes are an API contract — Studio, log aggregators, and
+     * external plugins subscribe to specific event names. Pinning them in a
+     * test catches accidental renames.
+     */
+    it("expose the expected names + modes", () => {
+        expect(AppRegistering.name).toBe("nwire.app.registering");
+        expect(AppRegistering.mode).toBe("series-bail");
+        expect(AppBooting.name).toBe("nwire.app.booting");
+        expect(AppBooting.mode).toBe("series-bail");
+        expect(AppBooted.name).toBe("nwire.app.booted");
+        expect(AppBooted.mode).toBe("parallel");
+        expect(AppShuttingDown.name).toBe("nwire.app.shutting-down");
+        expect(AppShuttingDown.mode).toBe("series-bail");
+        expect(AppShutdown.name).toBe("nwire.app.shutdown");
+        expect(AppShutdown.mode).toBe("parallel");
+    });
+    it("are all in the builtInLifecycleEvents catalog", () => {
+        expect(builtInLifecycleEvents).toContain(AppRegistering);
+        expect(builtInLifecycleEvents).toContain(AppBooting);
+        expect(builtInLifecycleEvents).toContain(AppBooted);
+        expect(builtInLifecycleEvents).toContain(AppShuttingDown);
+        expect(builtInLifecycleEvents).toContain(AppShutdown);
+    });
+});
+//# sourceMappingURL=framework-events.test.js.map

package/dist/__tests__/framework-events.test.js.map

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

package/dist/app.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `@nwire/app` — managed Container with plugin lifecycle and framework events.
+ *
+ * The "app" layer of the sealed architecture. Composes modules + plugins,
+ * boots them in order, exposes a Container, and fires framework events at
+ * every lifecycle transition.
+ *
+ * What it ships:
+ *
+ *   - `defineFrameworkEvent<TPayload>(name, mode)` — declare a typed
+ *     lifecycle event (`series-bail` / `parallel` / `series` dispatch).
+ *   - `FrameworkEventBus` — the dispatcher; one per app instance.
+ *   - `definePlugin(name, setup)` — the only extension primitive.
+ *   - `App*` events (`AppRegistering` / `AppBooting` / `AppBooted` /
+ *     `AppReady` / `AppShuttingDown` / `AppShutdown`) plus their plugin
+ *     counterparts (`PluginRegistered` / `PluginBooting` / `PluginBooted`).
+ *
+ * `createApp` (the composition root) currently lives in `@nwire/forge`; it
+ * will move here in a follow-up. Forge re-exports the framework-event types
+ * so consumers don't need to update imports.
+ */
+export { defineFrameworkEvent, AppRegistering, AppBooting, AppBooted, AppReady, AppShuttingDown, AppShutdown, PluginRegistered, PluginBooting, PluginBooted, PluginShuttingDown, PluginShutdown, WireMounting, WireMounted, WireUnmounted, builtInLifecycleEvents, type FrameworkEventDefinition, type FrameworkEventMode, } from "./framework-events.js";
+export { FrameworkEventBus, type FrameworkEventHandler, type FrameworkEventObserver, type FrameworkEventObservation, } from "./framework-event-bus.js";
+export { definePlugin, isAppPlugin, type AppPluginContext, type AppPluginDefinition, type BindingLifecycle, } from "./define-plugin.js";
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,UAAU,EACV,SAAS,EACT,QAAQ,EACR,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,WAAW,EACX,aAAa,EACb,sBAAsB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,iBAAiB,EACjB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,GAC/B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,YAAY,EACZ,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC"}

package/dist/app.js

@@ -0,0 +1,25 @@
+/**
+ * `@nwire/app` — managed Container with plugin lifecycle and framework events.
+ *
+ * The "app" layer of the sealed architecture. Composes modules + plugins,
+ * boots them in order, exposes a Container, and fires framework events at
+ * every lifecycle transition.
+ *
+ * What it ships:
+ *
+ *   - `defineFrameworkEvent<TPayload>(name, mode)` — declare a typed
+ *     lifecycle event (`series-bail` / `parallel` / `series` dispatch).
+ *   - `FrameworkEventBus` — the dispatcher; one per app instance.
+ *   - `definePlugin(name, setup)` — the only extension primitive.
+ *   - `App*` events (`AppRegistering` / `AppBooting` / `AppBooted` /
+ *     `AppReady` / `AppShuttingDown` / `AppShutdown`) plus their plugin
+ *     counterparts (`PluginRegistered` / `PluginBooting` / `PluginBooted`).
+ *
+ * `createApp` (the composition root) currently lives in `@nwire/forge`; it
+ * will move here in a follow-up. Forge re-exports the framework-event types
+ * so consumers don't need to update imports.
+ */
+export { defineFrameworkEvent, AppRegistering, AppBooting, AppBooted, AppReady, AppShuttingDown, AppShutdown, PluginRegistered, PluginBooting, PluginBooted, PluginShuttingDown, PluginShutdown, WireMounting, WireMounted, WireUnmounted, builtInLifecycleEvents, } from "./framework-events.js";
+export { FrameworkEventBus, } from "./framework-event-bus.js";
+export { definePlugin, isAppPlugin, } from "./define-plugin.js";
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,UAAU,EACV,SAAS,EACT,QAAQ,EACR,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,WAAW,EACX,aAAa,EACb,sBAAsB,GAGvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,iBAAiB,GAIlB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,YAAY,EACZ,WAAW,GAIZ,MAAM,iBAAiB,CAAC"}