@nwire/forge 0.7.1 → 0.8.17

package/README.md

@@ -1,104 +1,194 @@
 # @nwire/forge
 
-> The framework's domain primitives — one import for actions, actors, events, workflows, projections, modules, and the runtime that ties them together.
+> The framework's domain primitives — actions, actors, events, workflows, projections, modules, plugins, and the runtime that fires them.
 
-## What it does
-
-Provides the `define*` surface that domain code uses every day, plus the
-runtime that fires them. Forge composes lower packages (`@nwire/messages`,
-`@nwire/handler`, `@nwire/app`) into one ergonomic API; you can also use
-the lower packages directly when you want a narrower surface.
-
-## Install
+Forge composes the lower packages (`@nwire/messages`, `@nwire/handler`,
+`@nwire/app`) into one ergonomic surface. You can drop down to any of
+them when you want a narrower import; forge stays the default for app code.
 
 ```bash
 pnpm add @nwire/forge zod
 ```
 
-## Quick start
+## 5-minute tour
+
+Two primitives carry most of an app: `defineSchema` declares the data shape +
+lifecycle, `defineActor` (closure form) declares the methods + transitions
+against it. Everything else (`defineAction`, `defineModule`, `createApp`)
+plugs in around them.
+
+### 1. Declare the data + lifecycle with `defineSchema`
 
 ```ts
 import { z } from "zod";
-import { defineEvent } from "@nwire/messages";
-import { defineAction, defineActor, defineModule, createApp } from "@nwire/forge";
+import { defineSchema } from "@nwire/forge";
 
-// 1. A past-tense fact the domain cares about.
-export const StudentWasEnrolled = defineEvent({
-  name: "enrollments.student-was-enrolled",
-  schema: z.object({ studentId: z.string(), courseId: z.string() }),
-});
-
-// 2. An aggregate that holds state + invariants.
-export const Student = defineActor("Student", {
-  schema: z.object({
+export const SubmissionData = defineSchema({
+  name: "submission",
+  key: "submissionId",
+  fields: {
+    submissionId: z.string(),
     studentId: z.string(),
-    enrolments: z.array(z.string()),
-  }),
-  initial: (id: string) => ({ studentId: id, enrolments: [] }),
-  methods: {
-    enrol(state, courseId: string) {
-      if (state.enrolments.includes(courseId)) return state;
-      return { ...state, enrolments: [...state.enrolments, courseId] };
-    },
+    answer: z.string(),
+    verdict: z.string().optional(),
+    gradedAt: z.string().datetime().optional(),
+  },
+  states: {
+    submitted: { initial: true },
+    "under-review": {},
+    graded: { final: true },
   },
 });
+```
 
-// 3. A user-visible command that emits the event.
-export const enrolStudent = defineAction({
-  name: "enrollments.enrol-student",
-  schema: z.object({ studentId: z.string(), courseId: z.string() }),
-  emits: [StudentWasEnrolled],
-  handler: async (input, { use }) => {
-    const student = await use(Student, input.studentId);
-    student.enrol(input.courseId);
-    return StudentWasEnrolled({
-      studentId: input.studentId,
-      courseId: input.courseId,
+The schema is the single source of truth for the data model and the set of
+valid lifecycle states — Studio renders it, persistent stores (`@nwire/store-mongo`,
+`@nwire/store-prisma`) read `storage.indexes` / `storage.unique` from it, and
+`defineActor` borrows `key` + `initial` + the state names off it.
+
+### 2. Bind methods + transitions with `defineActor` (closure form)
+
+```ts
+import { defineActor } from "@nwire/forge";
+import { SubmissionData } from "./submission.schema";
+import { SubmissionWasFlagged, SubmissionWasGraded } from "./events";
+
+export const Submission = defineActor(
+  SubmissionData,
+  ({ data, id, validate, recordThat, when, methods, states }) => {
+    const { underReview, graded } = states;
+
+    // Methods enforce invariants and `recordThat` the events. They don't
+    // mutate state directly — `when(...)` below folds the recorded events
+    // into state.
+    const flag = (input: { reason: string }) => {
+      validate(input, [(i) => i.reason.length > 0 || "reason required"]);
+      recordThat(SubmissionWasFlagged({ submissionId: id, reason: input.reason }));
+    };
+    const grade = (input: { verdict: string }) => {
+      recordThat(SubmissionWasGraded({ submissionId: id, verdict: input.verdict }));
+    };
+
+    when(SubmissionWasFlagged, (_e, { assign }) => {
+      assign({}); // no field changes — state move only
+      return underReview; // transition: submitted → under-review
+    });
+    when(SubmissionWasGraded, (e, { assign }) => {
+      assign({ verdict: e.verdict, gradedAt: new Date().toISOString() });
+      return graded; // transition into the final state
     });
+
+    return methods({ flag, grade });
+  },
+);
+```
+
+The closure runs once at define time (to capture transitions + method names)
+and again per `ctx.use(Submission, id)` call (to bind methods over the live
+`data`). `recordThat` collects events the runtime publishes after the method
+returns; `when` is the matching fold — methods never write to state directly,
+so the actor's history is always the event log.
+
+> See: [write paths (actor xor direct-DB)](https://nwire.dev/concepts/write-paths) — a handler picks one path per write; never both.
+
+**Object form vs. closure form** — both exist. Use the closure form when you
+want typed `states.<name>` refs, want methods and folds in the same file, and
+want invariants on the input shape (`validate(...)`); use the object form
+(`defineActor(name, { schema, key, initial, states, methods })`) when the
+state machine is the whole story and you don't need per-method input
+validation.
+
+### 3. Wire it into a module + app
+
+```ts
+import { defineAction, defineModule, createApp, AppBooted, ActionCompleted } from "@nwire/forge";
+import { z } from "zod";
+
+export const flagSubmission = defineAction({
+  name: "submissions.flag",
+  schema: z.object({ submissionId: z.string(), reason: z.string() }),
+  emits: [SubmissionWasFlagged],
+  handler: async (input, { use }) => {
+    const sub = await use(Submission, input.submissionId);
+    sub.flag({ reason: input.reason }); // recorded event(s) published by runtime
   },
 });
 
-// 4. A module bundles the bounded context.
-export const enrollmentsModule = defineModule("enrollments", {
-  events: [StudentWasEnrolled],
-  actors: [Student],
-  actions: [enrolStudent.public()],
+export const submissions = defineModule("submissions", {
+  events: [SubmissionWasFlagged, SubmissionWasGraded],
+  actors: [Submission],
+  actions: [flagSubmission.public()],
 });
 
-// 5. createApp wires the modules into a runnable app.
-export const app = createApp({ modules: [enrollmentsModule] });
+const app = createApp({ modules: [submissions] });
+app.bus.on(AppBooted, ({ appName }) => console.log("booted:", appName));
+app.bus.on(ActionCompleted, ({ action }) => console.log("ran:", action.name));
+
 await app.start();
-await app.runtime.dispatch(enrolStudent, { studentId: "avi", courseId: "heb-1" });
+await app.runtime.dispatch(flagSubmission, { submissionId: "s-1", reason: "off-topic" });
 ```
 
-## API surface
-
-| Primitive                                                                                 | Purpose                                                             |
-| ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
-| `defineAction`                                                                            | User-visible command — validated input, emits events                |
-| `defineEvent`                                                                             | Past-tense fact (re-exported from `@nwire/messages`)                |
-| `defineHandler`                                                                           | Operation primitive — transport-agnostic                            |
-| `defineActor`                                                                             | Aggregate with state, methods, optional state machine               |
-| `defineSchema`                                                                            | Data shape + lifecycle states + storage hints                       |
-| `defineProjection`                                                                        | Read-model fold over events                                         |
-| `defineQuery`                                                                             | Projection-backed read function                                     |
-| `defineWorkflow`                                                                          | Reaction + saga unified — stateful or stateless                     |
-| `defineModule`                                                                            | Bundle of actors + actions + events + projections + queries         |
-| `defineApp`                                                                               | App declaration (multi-wire instantiation)                          |
-| `createApp`                                                                               | App runtime — boots modules, owns the bus                           |
-| `definePlugin`                                                                            | Cross-cutting: provide bindings, hook lifecycle, intercept dispatch |
-| `defineResource`                                                                          | Public response shape (field allowlist + OpenAPI schema)            |
-| `defineError`                                                                             | Typed throwable with status code                                    |
-| `defineMiddleware`                                                                        | Reusable handler middleware step                                    |
-| `defineCron`, `defineInbox`, `defineOutbox`, `defineExternalCall`, `defineInboundWebhook` | Orchestrator primitives                                             |
-| `runCli(app, argv)`                                                                       | Argv dispatcher — operator CLI without HTTP                         |
-
-Forge also re-exports `MessageEnvelope`, `seedEnvelope`, `deriveEnvelope`
-from `@nwire/envelope` and the `Logger` contract from `@nwire/logger`.
-
-## When to use forge
-
-When you want the full framework DX in one import. If you only need typed
-handlers without the actor/event machinery, pull `@nwire/handler` instead;
-if you only need lifecycle + plugins, pull `@nwire/app`. Forge is the
-default for app code; the smaller packages are the standalone path.
+## Surface
+
+### Domain primitives
+
+| Export                                                                                        | Role                                                         |
+| --------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
+| `defineAction`                                                                                | User-visible command — validated input, emits events         |
+| `defineEvent`                                                                                 | Past-tense fact (re-exported from `@nwire/messages`)         |
+| `defineHandler`                                                                               | Operation primitive — transport-agnostic                     |
+| `defineActor`                                                                                 | Aggregate with state, methods, optional state machine        |
+| `defineSchema`                                                                                | Data shape + lifecycle states + storage hints                |
+| `defineProjection`                                                                            | Read-model fold over events                                  |
+| `defineQuery`                                                                                 | Projection-backed read function                              |
+| `defineWorkflow`                                                                              | Reaction + saga unified — stateless or stateful              |
+| `defineModule`                                                                                | Bundle of actors + actions + events + projections + queries  |
+| `defineApp`                                                                                   | App declaration (multi-wire instantiation)                   |
+| `createApp`                                                                                   | App runtime — boots modules, owns the bus and runtime        |
+| `definePlugin`                                                                                | Forge-richer plugin: middleware + actor hooks + before/after |
+| `defineResource`                                                                              | Public response shape (field allowlist + OpenAPI schema)     |
+| `defineError`                                                                                 | Typed throwable with status code                             |
+| `defineMiddleware` / `defineHook` / `pipe`                                                    | Reusable resolver chain pieces                               |
+| `defineCron` / `defineInbox` / `defineOutbox` / `defineExternalCall` / `defineInboundWebhook` | Orchestrator primitives                                      |
+| `runCli(app, argv)`                                                                           | Argv dispatcher — operator CLI without HTTP                  |
+
+### Framework events
+
+Forge re-exports the app-lifecycle events from `@nwire/app`
+(`AppRegistering` / `AppBooting` / `AppBooted` / `AppReady` /
+`AppShuttingDown` / `AppShutdown`, `PluginRegistered` …, `WireMounting` …)
+and adds its own forge-local events:
+
+| Event                    | Mode        | When                                                  |
+| ------------------------ | ----------- | ----------------------------------------------------- |
+| `ActionDispatching`      | series-bail | Before handler runs. Return `false` to short-circuit. |
+| `ActionCompleted`        | parallel    | After handler returns successfully.                   |
+| `ActionFailed`           | parallel    | After handler throws.                                 |
+| `EventRecording`         | series-bail | Before an event is appended to the store.             |
+| `EventRecorded`          | parallel    | After append succeeds.                                |
+| `builtInFrameworkEvents` | —           | Catalog of every built-in (lifecycle + forge-local).  |
+
+### Re-exports
+
+- `MessageEnvelope`, `seedEnvelope`, `deriveEnvelope` from `@nwire/envelope`
+- `Logger` contract + `NoopLogger` / `ConsoleLogger` from `@nwire/logger`
+- `DeadLetterSink` + `InMemoryDeadLetterSink` from `@nwire/dead-letter`
+
+## Picking the right entry point
+
+| You want…                               | Import from       |
+| --------------------------------------- | ----------------- |
+| Full framework DX in one import         | `@nwire/forge`    |
+| Just operations (handlers / middleware) | `@nwire/handler`  |
+| Just lifecycle + plugins                | `@nwire/app`      |
+| Just events + envelope                  | `@nwire/messages` |
+
+## Related
+
+- `@nwire/endpoint` — wraps the runtime in a process (graceful shutdown, probes).
+- `@nwire/http` — HTTP transport over the runtime.
+- `@nwire/hooks` — the dispatch substrate that powers `runtime.use(...)` and every framework event.
+
+## Status
+
+v0.x — public surface is stable; `createApp` will extract to `@nwire/app` in a follow-up phase but imports won't change (re-exports preserved).

package/dist/__tests__/action-hooks.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Per-action `action.before:<name>` and `action.after:<name>` hooks —
+ * proves the named-hook surface that plugin `before()`/`after()` sugar
+ * registers chain steps on, AND that the dispatcher honors veto + observes
+ * after-success.
+ */
+export {};
+//# sourceMappingURL=action-hooks.test.d.ts.map

package/dist/__tests__/action-hooks.test.d.ts.map

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

package/dist/__tests__/action-hooks.test.js

@@ -0,0 +1,95 @@
+/**
+ * Per-action `action.before:<name>` and `action.after:<name>` hooks —
+ * proves the named-hook surface that plugin `before()`/`after()` sugar
+ * registers chain steps on, AND that the dispatcher honors veto + observes
+ * after-success.
+ */
+import { describe, it, expect } from "vitest";
+import { z } from "zod";
+import { listHooks } from "@nwire/hooks";
+import { createApp, defineAction, defineHandler, defineModule, definePlugin } from "../foundation.js";
+const Ping = defineAction({
+    name: "test/action-hooks-ping",
+    schema: z.object({ n: z.number() }),
+});
+const pingHandler = defineHandler(Ping, async (input) => undefined);
+const mod = defineModule("test-action-hooks", {
+    actions: [Ping],
+    handlers: [pingHandler],
+});
+describe("per-action hooks", () => {
+    it("registers action.before:<name> + action.after:<name> on handler register", async () => {
+        const app = createApp({ appName: "action-hooks-test", modules: [mod] });
+        await app.start();
+        const names = listHooks().map((h) => h.name);
+        expect(names).toContain("action.before:test/action-hooks-ping");
+        expect(names).toContain("action.after:test/action-hooks-ping");
+        await app.stop();
+    });
+    it("plugin.before chain step that returns false vetoes the dispatch", async () => {
+        let handlerRan = false;
+        let beforeRan = false;
+        let afterRan = false;
+        const ping2 = defineHandler(defineAction({ name: "test/veto-ping", schema: z.object({}) }), async () => {
+            handlerRan = true;
+            return undefined;
+        });
+        const m = defineModule("test-veto", { actions: [ping2.action], handlers: [ping2] });
+        const vetoer = definePlugin("vetoer", ({ before, after }) => {
+            before("test/veto-ping", () => {
+                beforeRan = true;
+                return false;
+            });
+            after("test/veto-ping", () => {
+                afterRan = true;
+            });
+        });
+        const app = createApp({ appName: "veto-test", modules: [m], plugins: [vetoer] });
+        await app.start();
+        await app.runtime.dispatch(ping2.action, {});
+        expect(beforeRan).toBe(true);
+        expect(handlerRan).toBe(false);
+        expect(afterRan).toBe(false);
+        await app.stop();
+    });
+    it("plugin.after observes the result + durationMs of a successful dispatch", async () => {
+        let captured = null;
+        const ping3 = defineHandler(defineAction({ name: "test/observe-ping", schema: z.object({}) }), async () => undefined);
+        const m = defineModule("test-observe", { actions: [ping3.action], handlers: [ping3] });
+        const observer = definePlugin("observer", ({ after }) => {
+            after("test/observe-ping", ({ result, durationMs }) => {
+                captured = { result, durationMs };
+            });
+        });
+        const app = createApp({ appName: "observe-test", modules: [m], plugins: [observer] });
+        await app.start();
+        await app.runtime.dispatch(ping3.action, {});
+        expect(captured).not.toBeNull();
+        expect(typeof captured.durationMs).toBe("number");
+        await app.stop();
+    });
+    it("multiple plugins.before steps stack as named chain steps on the same hook", async () => {
+        const callOrder = [];
+        const ping4 = defineHandler(defineAction({ name: "test/stack-ping", schema: z.object({}) }), async () => {
+            callOrder.push("handler");
+            return undefined;
+        });
+        const m = defineModule("test-stack", { actions: [ping4.action], handlers: [ping4] });
+        const pluginA = definePlugin("a", ({ before }) => {
+            before("test/stack-ping", () => {
+                callOrder.push("a.before");
+            });
+        });
+        const pluginB = definePlugin("b", ({ before }) => {
+            before("test/stack-ping", () => {
+                callOrder.push("b.before");
+            });
+        });
+        const app = createApp({ appName: "stack-test", modules: [m], plugins: [pluginA, pluginB] });
+        await app.start();
+        await app.runtime.dispatch(ping4.action, {});
+        expect(callOrder).toEqual(["a.before", "b.before", "handler"]);
+        await app.stop();
+    });
+});
+//# sourceMappingURL=action-hooks.test.js.map

package/dist/__tests__/action-hooks.test.js.map

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

package/dist/__tests__/actor-workflow-hooks.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Per-actor `actor.transition:<name>` and per-workflow `workflow.fire:<name>`
+ * hooks (A7). Proves both:
+ *   - hooks appear in listHooks() right after registerActor/Workflow
+ *   - chain steps observe transitions / fires during real dispatch
+ */
+export {};
+//# sourceMappingURL=actor-workflow-hooks.test.d.ts.map

package/dist/__tests__/actor-workflow-hooks.test.d.ts.map

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

package/dist/__tests__/actor-workflow-hooks.test.js

@@ -0,0 +1,106 @@
+/**
+ * Per-actor `actor.transition:<name>` and per-workflow `workflow.fire:<name>`
+ * hooks (A7). Proves both:
+ *   - hooks appear in listHooks() right after registerActor/Workflow
+ *   - chain steps observe transitions / fires during real dispatch
+ */
+import { describe, it, expect } from "vitest";
+import { z } from "zod";
+import { defineEvent } from "@nwire/messages";
+import { listHooks } from "@nwire/hooks";
+import { createApp, defineAction, defineActor, defineModule, defineWorkflow, eventFactory, } from "../foundation.js";
+// ─── Domain ────────────────────────────────────────────────────────
+const OrderState = z.object({ orderId: z.string(), total: z.number() });
+const Placed = defineEvent({
+    name: "orders.placed",
+    schema: z.object({ orderId: z.string(), total: z.number() }),
+});
+const Confirmed = defineEvent({
+    name: "orders.confirmed",
+    schema: z.object({ orderId: z.string() }),
+});
+const PlacedEvent = eventFactory(Placed);
+const ConfirmedEvent = eventFactory(Confirmed);
+const Order = defineActor("order", {
+    schema: OrderState,
+    key: "orderId",
+    initial: "draft",
+    states: {
+        draft: {
+            on: { [Placed.name]: { target: "placed", assign: (_, e) => ({ ...e }) } },
+        },
+        placed: { on: { [Confirmed.name]: { target: "confirmed" } } },
+        confirmed: {},
+    },
+});
+const placeOrder = defineAction({
+    name: "orders.place",
+    schema: z.object({ orderId: z.string(), total: z.number() }),
+    handler: async (input) => PlacedEvent(input),
+});
+const confirmOrder = defineAction({
+    name: "orders.confirm",
+    schema: z.object({ orderId: z.string() }),
+    handler: async (input) => ConfirmedEvent({ orderId: input.orderId }),
+});
+let workflowFiredCount = 0;
+const notifyOnPlace = defineWorkflow("notify-on-place", ({ on }) => {
+    on(Placed, async () => {
+        workflowFiredCount++;
+    });
+});
+const mod = defineModule("orders", {
+    actors: [Order],
+    actions: [placeOrder, confirmOrder],
+    events: [Placed, Confirmed],
+    workflows: [notifyOnPlace],
+});
+// ─── Tests ─────────────────────────────────────────────────────────
+describe("per-actor + per-workflow hooks", () => {
+    it("registerActor + registerWorkflow create named hooks visible in listHooks", async () => {
+        const app = createApp({ appName: "actor-workflow-hooks-list", modules: [mod] });
+        await app.start();
+        const names = listHooks().map((h) => h.name);
+        expect(names).toContain("actor.transition:order");
+        expect(names).toContain("workflow.fire:notify-on-place");
+        await app.stop();
+    });
+    it("actor.transition hook observes state changes during real dispatch", async () => {
+        const transitions = [];
+        const app = createApp({ appName: "actor-transition-test", modules: [mod] });
+        await app.start();
+        app.runtime.ensureActorTransitionHook("order").use(async (hctx, next) => {
+            transitions.push({ from: hctx.fromState, to: hctx.toState });
+            await next();
+        }, { name: "observer" });
+        await app.runtime.dispatch(placeOrder, { orderId: "o1", total: 100 });
+        expect(transitions).toEqual([{ from: "draft", to: "placed" }]);
+        await app.runtime.dispatch(confirmOrder, { orderId: "o1" });
+        expect(transitions).toEqual([
+            { from: "draft", to: "placed" },
+            { from: "placed", to: "confirmed" },
+        ]);
+        await app.stop();
+    });
+    it("workflow.fire hook observes saga invocations", async () => {
+        const fires = [];
+        workflowFiredCount = 0;
+        const app = createApp({ appName: "workflow-fire-test", modules: [mod] });
+        await app.start();
+        app.runtime.ensureWorkflowFireHook("notify-on-place").use(async (hctx, next) => {
+            fires.push({
+                workflow: hctx.workflow.name,
+                event: hctx.event.eventName,
+                correlationKey: hctx.correlationKey,
+            });
+            await next();
+        }, { name: "observer" });
+        await app.runtime.dispatch(placeOrder, { orderId: "o2", total: 50 });
+        expect(fires).toHaveLength(1);
+        expect(fires[0].workflow).toBe("notify-on-place");
+        expect(fires[0].event).toBe("orders.placed");
+        expect(workflowFiredCount).toBe(1);
+        await app.stop();
+    });
+});
+//# sourceMappingURL=actor-workflow-hooks.test.js.map

package/dist/__tests__/actor-workflow-hooks.test.js.map

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

package/dist/__tests__/lifecycle-logging.test.js

@@ -71,8 +71,10 @@ describe("framework events → telemetry → dev logger", () => {
         // Multiple lifecycle lines should be present.
         const lifecycleLines = lines.filter((l) => l.includes("nwire:"));
         expect(lifecycleLines.length).toBeGreaterThan(5);
-        // Plugin-booted line should include the plugin name (`trace`).
-        const booted = lifecycleLines.find((l) => l.includes("plugin.booted"));
+        // Plugin-booted line for the `trace` plugin specifically. Modules now
+        // also fire PluginBooted with `kind:"module"` first, so we need to find
+        // the booted line that names the `trace` plugin — not just the first.
+        const booted = lifecycleLines.find((l) => l.includes("plugin.booted") && l.includes("trace"));
         expect(booted).toBeTruthy();
         expect(booted).toContain("trace");
     });

package/dist/__tests__/lifecycle-logging.test.js.map

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

package/dist/__tests__/plugin-app-narrow.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * createApp accepts the narrow `@nwire/app` plugin shape as well as the
+ * rich forge `definePlugin`. Verifies the adaptation at the boundary:
+ *
+ *   - `provide(name, lifecycle)` produces a container binding whose value
+ *     comes from `lifecycle.boot()`.
+ *   - `boot(fn)` fires during app start.
+ *   - `shutdown(fn)` fires during app stop.
+ *   - `lifecycle.shutdown(value)` fires for materialized bindings.
+ */
+export {};
+//# sourceMappingURL=plugin-app-narrow.test.d.ts.map

package/dist/__tests__/plugin-app-narrow.test.d.ts.map

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