@nwire/forge 0.7.0

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

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

package/dist/__tests__/dev-logger.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Dev logger — formatting + filter + createApp default attach behavior.
+ *
+ * Doesn't test colors (terminal-dependent); asserts the structural parts
+ * of the output and proves the attach/detach lifecycle works through
+ * createApp's start() + stop().
+ */
+export {};
+//# sourceMappingURL=dev-logger.test.d.ts.map

package/dist/__tests__/dev-logger.test.d.ts.map

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

package/dist/__tests__/dev-logger.test.js

@@ -0,0 +1,126 @@
+/**
+ * Dev logger — formatting + filter + createApp default attach behavior.
+ *
+ * Doesn't test colors (terminal-dependent); asserts the structural parts
+ * of the output and proves the attach/detach lifecycle works through
+ * createApp's start() + stop().
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import { z } from "zod";
+import { defineEvent } from "@nwire/messages";
+import { attachDevLogger, formatTelemetry } from "../dev-logger.js";
+import * as forge from "../foundation.js";
+const { defineAction, defineHandler, defineModule, createApp, eventFactory } = forge;
+const NoteWasAddedDef = defineEvent({
+    name: "notes.was-added",
+    schema: z.object({ noteId: z.string(), text: z.string() }),
+});
+const NoteWasAdded = eventFactory(NoteWasAddedDef);
+const AddNote = defineAction({
+    name: "notes.add",
+    schema: z.object({ noteId: z.string(), text: z.string() }),
+    emits: [NoteWasAddedDef],
+});
+const addNoteHandler = defineHandler(AddNote, async (input) => {
+    return NoteWasAdded({ noteId: input.noteId, text: input.text });
+});
+const notesModule = defineModule("notes", {
+    actions: [AddNote],
+    handlers: [addNoteHandler],
+    events: [NoteWasAddedDef],
+});
+describe("formatTelemetry", () => {
+    it("renders an action.dispatched line with the action name", () => {
+        const line = formatTelemetry({
+            kind: "action.dispatched",
+            action: "notes.add",
+            input: {},
+            envelope: { messageId: "m1", correlationId: "c1" },
+            appName: "test",
+            ts: "2026-05-25T21:30:45.123Z",
+        });
+        expect(line).toContain("notes.add");
+        expect(line).toContain("21:30:45.123");
+        expect(line).toContain("action");
+    });
+    it("renders action.completed with durationMs and emitted-event count", () => {
+        const line = formatTelemetry({
+            kind: "action.completed",
+            action: "notes.add",
+            durationMs: 5,
+            emittedEvents: ["notes.was-added"],
+            envelope: {},
+            appName: "test",
+            ts: "2026-05-25T21:30:45.500Z",
+        });
+        expect(line).toContain("5ms");
+        expect(line).toContain("+1 event");
+    });
+    it("renders an event.published line with the event name", () => {
+        const line = formatTelemetry({
+            kind: "event.published",
+            event: { eventName: "notes.was-added", payload: {} },
+            envelope: {},
+            source: "in-process",
+            appName: "test",
+            ts: "2026-05-25T21:30:45.000Z",
+        });
+        expect(line).toContain("notes.was-added");
+        expect(line).toContain("event");
+    });
+});
+describe("attachDevLogger filter", () => {
+    it("only emits records whose kind matches the configured filter", async () => {
+        const lines = [];
+        const app = createApp({ modules: [notesModule], devLogs: false });
+        await app.start();
+        const detach = attachDevLogger(app.runtime, {
+            kinds: ["action.completed"],
+            write: (line) => lines.push(line),
+        });
+        await app.runtime.dispatch(AddNote, { noteId: "n1", text: "hi" });
+        detach();
+        await app.stop();
+        // Only completed lines — no dispatched, no event.published.
+        expect(lines.length).toBeGreaterThan(0);
+        for (const l of lines)
+            expect(l).toContain("notes.add");
+        expect(lines.some((l) => l.match(/✓|action\b/))).toBe(true);
+    });
+});
+describe("createApp default dev logger", () => {
+    let writeSpy;
+    beforeEach(() => {
+        writeSpy = vi.spyOn(process.stdout, "write").mockImplementation(() => true);
+    });
+    afterEach(() => {
+        writeSpy.mockRestore();
+    });
+    it("auto-attaches when NODE_ENV != production and writes telemetry", async () => {
+        const previousEnv = process.env.NODE_ENV;
+        process.env.NODE_ENV = "development";
+        try {
+            const app = createApp({ modules: [notesModule] });
+            await app.start();
+            await app.runtime.dispatch(AddNote, { noteId: "n2", text: "hello" });
+            await app.stop();
+        }
+        finally {
+            if (previousEnv === undefined)
+                delete process.env.NODE_ENV;
+            else
+                process.env.NODE_ENV = previousEnv;
+        }
+        const allWrites = writeSpy.mock.calls.map((c) => String(c[0])).join("");
+        expect(allWrites).toContain("notes.add");
+    });
+    it("stays silent when devLogs:false is explicit", async () => {
+        const app = createApp({ modules: [notesModule], devLogs: false });
+        await app.start();
+        await app.runtime.dispatch(AddNote, { noteId: "n3", text: "quiet" });
+        await app.stop();
+        const allWrites = writeSpy.mock.calls.map((c) => String(c[0])).join("");
+        expect(allWrites).not.toContain("notes.add");
+    });
+});
+//# sourceMappingURL=dev-logger.test.js.map

package/dist/__tests__/dev-logger.test.js.map

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

package/dist/__tests__/external-call.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Phase 47 — orchestrator primitives. Smoke tests for `defineExternalCall`
+ * + runtime execution + telemetry emission.
+ *
+ * The declarative shape is pure data; what we want to verify is:
+ *   1. The runtime registers external-call definitions when a module declares them.
+ *   2. `ctx.externalCall(def, request)` runs the registered executor, validates
+ *      response, threads the idempotency key, applies retry policy.
+ *   3. Each call emits `external.call.started` / `.completed` / `.failed`
+ *      records on the canonical telemetry stream.
+ *   4. Missing executor → loud failure (no silent dropped call).
+ */
+export {};
+//# sourceMappingURL=external-call.test.d.ts.map

package/dist/__tests__/external-call.test.d.ts.map

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

package/dist/__tests__/external-call.test.js

@@ -0,0 +1,99 @@
+/**
+ * Phase 47 — orchestrator primitives. Smoke tests for `defineExternalCall`
+ * + runtime execution + telemetry emission.
+ *
+ * The declarative shape is pure data; what we want to verify is:
+ *   1. The runtime registers external-call definitions when a module declares them.
+ *   2. `ctx.externalCall(def, request)` runs the registered executor, validates
+ *      response, threads the idempotency key, applies retry policy.
+ *   3. Each call emits `external.call.started` / `.completed` / `.failed`
+ *      records on the canonical telemetry stream.
+ *   4. Missing executor → loud failure (no silent dropped call).
+ */
+import { describe, it, expect } from "vitest";
+import { z } from "zod";
+import * as forge from "../foundation.js";
+const NotifyRequest = z.object({ to: z.string(), template: z.string() });
+const NotifyResponse = z.object({ notificationId: z.string(), delivered: z.boolean() });
+const notify = forge.defineExternalCall({
+    name: "notifications.send",
+    target: { provider: "notifications", endpoint: "/v1/notify" },
+    request: NotifyRequest,
+    response: NotifyResponse,
+    idempotencyKey: (req) => `notify-${req.to}-${req.template}`,
+    slo: { p95LatencyMs: 200, successRate: 0.99 },
+    retry: { max: 2, backoff: "fixed", baseDelayMs: 1 },
+});
+const SendNudgeInput = z.object({ to: z.string() });
+const sendNudge = forge.defineAction({
+    name: "ops.send-nudge",
+    schema: SendNudgeInput,
+    handler: async (input, ctx) => {
+        await ctx.externalCall(notify, { to: input.to, template: "hello" });
+        return undefined;
+    },
+});
+const opsModule = forge.defineModule("ops", {
+    actions: [sendNudge],
+    externalCalls: [notify],
+});
+const opsApp = forge.defineApp("ops-app", { modules: [opsModule] });
+describe("defineExternalCall + ctx.externalCall", () => {
+    it("executes the registered executor and emits started/completed telemetry", async () => {
+        const app = opsApp.create();
+        await app.start();
+        let executorCalls = 0;
+        app.runtime.registerExternalCallExecutor(notify, async (req, meta) => {
+            executorCalls++;
+            expect(req.to).toBe("avi");
+            expect(meta.idempotencyKey).toBe("notify-avi-hello");
+            return { notificationId: "n1", delivered: true };
+        });
+        const seen = [];
+        app.runtime.onTelemetry((rec) => seen.push(rec));
+        await app.runtime.dispatch(sendNudge, { to: "avi" });
+        expect(executorCalls).toBe(1);
+        const kinds = seen.map((r) => r.kind);
+        expect(kinds).toContain("external.call.started");
+        expect(kinds).toContain("external.call.completed");
+        const completed = seen.find((r) => r.kind === "external.call.completed");
+        expect(completed?.call).toBe("notifications.send");
+        expect(completed?.target).toBe("notifications//v1/notify");
+        expect(completed?.idempotencyKey).toBe("notify-avi-hello");
+        expect(typeof completed?.durationMs).toBe("number");
+    });
+    it("retries on failure and emits external.call.failed per attempt", async () => {
+        const app = opsApp.create();
+        await app.start();
+        let attempts = 0;
+        app.runtime.registerExternalCallExecutor(notify, async () => {
+            attempts++;
+            if (attempts < 3)
+                throw new Error(`flake #${attempts}`);
+            return { notificationId: "n1", delivered: true };
+        });
+        const seen = [];
+        app.runtime.onTelemetry((rec) => seen.push(rec));
+        await app.runtime.dispatch(sendNudge, { to: "dina" });
+        expect(attempts).toBe(3);
+        const failures = seen.filter((r) => r.kind === "external.call.failed");
+        expect(failures).toHaveLength(2);
+        expect(seen.some((r) => r.kind === "external.call.completed")).toBe(true);
+    });
+    it("throws when no executor is registered and emits external.call.failed", async () => {
+        const app = opsApp.create();
+        await app.start();
+        const seen = [];
+        app.runtime.onTelemetry((rec) => seen.push(rec));
+        await expect(app.runtime.dispatch(sendNudge, { to: "miri" })).rejects.toThrow(/no executor registered/);
+        const failures = seen.filter((r) => r.kind === "external.call.failed");
+        expect(failures).toHaveLength(1);
+    });
+    it("registers external calls into the runtime registry", async () => {
+        const app = opsApp.create();
+        await app.start();
+        expect(app.runtime.listExternalCalls()).toContain("notifications.send");
+        expect(app.runtime.getExternalCall("notifications.send")?.target.provider).toBe("notifications");
+    });
+});
+//# sourceMappingURL=external-call.test.js.map

package/dist/__tests__/external-call.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-call.test.js","sourceRoot":"","sources":["../../src/__tests__/external-call.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,KAAK,MAAM,eAAe,CAAC;AAEvC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACzE,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAExF,MAAM,MAAM,GAAG,KAAK,CAAC,kBAAkB,CAAC;IACtC,IAAI,EAAE,oBAAoB;IAC1B,MAAM,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,EAAE;IAC7D,OAAO,EAAE,aAAa;IACtB,QAAQ,EAAE,cAAc;IACxB,cAAc,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,QAAQ,EAAE;IAC3D,GAAG,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE;IAC7C,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE;CACpD,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAEpD,MAAM,SAAS,GAAG,KAAK,CAAC,YAAY,CAAC;IACnC,IAAI,EAAE,gBAAgB;IACtB,MAAM,EAAE,cAAc;IACtB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC5B,MAAM,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACpE,OAAO,SAAS,CAAC;IACnB,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE;IAC1C,OAAO,EAAE,CAAC,SAAS,CAAC;IACpB,aAAa,EAAE,CAAC,MAAM,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;AAEpE,QAAQ,CAAC,uCAAuC,EAAE,GAAG,EAAE;IACrD,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACtF,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QAElB,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,GAAG,CAAC,OAAO,CAAC,4BAA4B,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;YACnE,aAAa,EAAE,CAAC;YAChB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YACrD,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAsB,EAAE,CAAC;QACnC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAEjD,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAErD,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;QACjD,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;QAEnD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CACzB,CAAC,CAAC,EAAsE,EAAE,CACxE,CAAC,CAAC,IAAI,KAAK,yBAAyB,CACvC,CAAC;QACF,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACnD,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC3D,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC3D,MAAM,CAAC,OAAO,SAAS,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC7E,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,GAAG,CAAC,OAAO,CAAC,4BAA4B,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;YAC1D,QAAQ,EAAE,CAAC;YACX,IAAI,QAAQ,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,UAAU,QAAQ,EAAE,CAAC,CAAC;YACxD,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACnD,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,GAAsB,EAAE,CAAC;QACnC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAEjD,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAEtD,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,sBAAsB,CAAC,CAAC;QACvE,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,yBAAyB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;QACpF,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,GAAsB,EAAE,CAAC;QACnC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAEjD,MAAM,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAC3E,wBAAwB,CACzB,CAAC;QACF,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,sBAAsB,CAAC,CAAC;QACvE,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;QACxE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAC7E,eAAe,CAChB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Framework events — lifecycle + dispatch hooks expressed as values.
+ *
+ * Verifies:
+ *   - dispatch modes: parallel / series / series-bail
+ *   - priority ordering (higher runs first in serial modes)
+ *   - subscriber unsubscribe
+ *   - lifecycle wiring: createApp fires AppBooting/Booted/ShuttingDown/Shutdown
+ *   - dispatch wiring: runtime fires ActionDispatching/Completed/Failed
+ *   - ActionDispatching can veto a dispatch with `return false`
+ */
+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;;;;;;;;;;GAUG"}

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

@@ -0,0 +1,204 @@
+/**
+ * Framework events — lifecycle + dispatch hooks expressed as values.
+ *
+ * Verifies:
+ *   - dispatch modes: parallel / series / series-bail
+ *   - priority ordering (higher runs first in serial modes)
+ *   - subscriber unsubscribe
+ *   - lifecycle wiring: createApp fires AppBooting/Booted/ShuttingDown/Shutdown
+ *   - dispatch wiring: runtime fires ActionDispatching/Completed/Failed
+ *   - ActionDispatching can veto a dispatch with `return false`
+ */
+import { describe, it, expect } from "vitest";
+import { z } from "zod";
+import { ActionDispatching, ActionCompleted, ActionFailed, AppBooting, AppBooted, AppShuttingDown, AppShutdown, createApp, defineAction, defineFrameworkEvent, defineHandler, defineModule, FrameworkEventBus, NoopLogger, } from "../foundation.js";
+// ─── Bus mechanics ─────────────────────────────────────────────────
+describe("FrameworkEventBus dispatch modes", () => {
+    const logger = new NoopLogger();
+    it("parallel: every subscriber runs; throws are isolated", async () => {
+        const bus = new FrameworkEventBus(logger);
+        const evt = defineFrameworkEvent("test.completed", "parallel");
+        const calls = [];
+        bus.on(evt, async () => {
+            throw new Error("first");
+        });
+        bus.on(evt, async (p) => {
+            calls.push(p.n);
+        });
+        bus.on(evt, async (p) => {
+            calls.push(p.n * 2);
+        });
+        const ok = await bus.fire(evt, { n: 5 });
+        expect(ok).toBe(true);
+        expect(calls.sort((a, b) => a - b)).toEqual([5, 10]);
+    });
+    it("series: subscribers run sequentially; throws propagate", async () => {
+        const bus = new FrameworkEventBus(logger);
+        const evt = defineFrameworkEvent("test.transition", "series");
+        const order = [];
+        bus.on(evt, async (p) => {
+            order.push(`a:${p.s}`);
+        });
+        bus.on(evt, async () => {
+            throw new Error("boom");
+        });
+        bus.on(evt, async (p) => {
+            order.push(`c:${p.s}`);
+        });
+        await expect(bus.fire(evt, { s: "x" })).rejects.toThrow("boom");
+        expect(order).toEqual(["a:x"]); // third never ran
+    });
+    it("series-bail: returning false stops the chain and returns false", async () => {
+        const bus = new FrameworkEventBus(logger);
+        const evt = defineFrameworkEvent("test.starting", "series-bail");
+        const order = [];
+        bus.on(evt, async (p) => {
+            order.push(`a:${p.go}`);
+        });
+        bus.on(evt, async () => false); // bail
+        bus.on(evt, async () => {
+            order.push("c");
+        });
+        const ok = await bus.fire(evt, { go: true });
+        expect(ok).toBe(false);
+        expect(order).toEqual(["a:true"]);
+    });
+    it("priority orders subscribers (higher first)", async () => {
+        const bus = new FrameworkEventBus(logger);
+        const evt = defineFrameworkEvent("test.ordered", "series");
+        const order = [];
+        bus.on(evt, () => {
+            order.push("low");
+        }, -10);
+        bus.on(evt, () => {
+            order.push("high");
+        }, 100);
+        bus.on(evt, () => {
+            order.push("normal");
+        }, 0);
+        await bus.fire(evt, undefined);
+        expect(order).toEqual(["high", "normal", "low"]);
+    });
+    it("unsubscribe removes the listener", async () => {
+        const bus = new FrameworkEventBus(logger);
+        const evt = defineFrameworkEvent("test.unsub", "parallel");
+        let calls = 0;
+        const off = bus.on(evt, () => {
+            calls++;
+        });
+        await bus.fire(evt, undefined);
+        off();
+        await bus.fire(evt, undefined);
+        expect(calls).toBe(1);
+    });
+});
+// ─── Lifecycle wiring ──────────────────────────────────────────────
+describe("createApp fires lifecycle framework events", () => {
+    it("fires AppBooting → AppBooted around start; AppShuttingDown → AppShutdown around stop", async () => {
+        const app = createApp({ modules: [] });
+        const seen = [];
+        app.runtime.onFramework(AppBooting, () => {
+            seen.push("booting");
+        });
+        app.runtime.onFramework(AppBooted, () => {
+            seen.push("booted");
+        });
+        app.runtime.onFramework(AppShuttingDown, () => {
+            seen.push("shutting");
+        });
+        app.runtime.onFramework(AppShutdown, () => {
+            seen.push("shutdown");
+        });
+        await app.start();
+        await app.stop("test-teardown");
+        expect(seen).toEqual(["booting", "booted", "shutting", "shutdown"]);
+    });
+    it("AppShuttingDown can prevent shutdown by returning false", async () => {
+        const app = createApp({ modules: [] });
+        await app.start();
+        app.runtime.onFramework(AppShuttingDown, () => false);
+        await expect(app.stop()).rejects.toThrow(/prevented/i);
+    });
+    it("AppShuttingDown receives the reason", async () => {
+        const app = createApp({ modules: [] });
+        let received;
+        app.runtime.onFramework(AppShuttingDown, (p) => {
+            received = p.reason;
+        });
+        await app.start();
+        await app.stop("SIGTERM-received");
+        expect(received).toBe("SIGTERM-received");
+    });
+});
+// ─── Dispatch wiring ───────────────────────────────────────────────
+describe("runtime fires action framework events", () => {
+    const Ping = defineAction({
+        name: "test/ping",
+        schema: z.object({ n: z.number() }),
+    });
+    const handler = defineHandler(Ping, async (input) => {
+        if (input.n < 0)
+            throw new Error("negative");
+        return undefined;
+    });
+    const mod = defineModule("test", {
+        actions: [Ping],
+        handlers: [handler],
+    });
+    it("fires ActionDispatching → ActionCompleted on success", async () => {
+        const app = createApp({ modules: [mod] });
+        await app.start();
+        const seen = [];
+        app.runtime.onFramework(ActionDispatching, (p) => {
+            seen.push(`pre:${p.action.name}`);
+        });
+        app.runtime.onFramework(ActionCompleted, (p) => {
+            seen.push(`ok:${p.action.name}`);
+        });
+        app.runtime.onFramework(ActionFailed, () => {
+            seen.push("fail");
+        });
+        await app.runtime.dispatch(Ping, { n: 1 });
+        // ActionCompleted fires in parallel/non-awaited; wait a tick.
+        await new Promise((r) => setImmediate(r));
+        expect(seen).toEqual(["pre:test/ping", "ok:test/ping"]);
+        await app.stop();
+    });
+    it("fires ActionDispatching → ActionFailed when the handler throws", async () => {
+        const app = createApp({ modules: [mod] });
+        await app.start();
+        const seen = [];
+        app.runtime.onFramework(ActionDispatching, () => {
+            seen.push("pre");
+        });
+        app.runtime.onFramework(ActionCompleted, () => {
+            seen.push("ok");
+        });
+        app.runtime.onFramework(ActionFailed, (p) => {
+            seen.push(`fail:${p.error.message}`);
+        });
+        await expect(app.runtime.dispatch(Ping, { n: -1 })).rejects.toThrow("negative");
+        await new Promise((r) => setImmediate(r));
+        expect(seen).toEqual(["pre", "fail:negative"]);
+        await app.stop();
+    });
+    it("ActionDispatching returning false cancels the dispatch", async () => {
+        const app = createApp({ modules: [mod] });
+        await app.start();
+        let handlerRan = false;
+        app.runtime.onFramework(ActionDispatching, () => false);
+        // Add a second handler subscription to ensure veto comes from anywhere
+        // in the chain.
+        let completed = false;
+        app.runtime.onFramework(ActionCompleted, () => {
+            completed = true;
+        });
+        const result = await app.runtime.dispatch(Ping, { n: 1 });
+        await new Promise((r) => setImmediate(r));
+        expect(result).toBeUndefined();
+        expect(completed).toBe(false); // veto skipped the handler entirely
+        expect(handlerRan).toBe(false); // unused; satisfies prior style
+        await app.stop();
+    });
+});
+//# 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":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,UAAU,EACV,SAAS,EACT,eAAe,EACf,WAAW,EACX,SAAS,EACT,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,UAAU,GACX,MAAM,eAAe,CAAC;AAEvB,sEAAsE;AAEtE,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAChD,MAAM,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;IAEhC,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,GAAG,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,oBAAoB,CAAgB,gBAAgB,EAAE,UAAU,CAAC,CAAC;QAC9E,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,IAAI,EAAE;YACrB,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YACtB,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YACtB,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;QAEH,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACzC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,GAAG,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,oBAAoB,CAAgB,iBAAiB,EAAE,QAAQ,CAAC,CAAC;QAC7E,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YACtB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,IAAI,EAAE;YACrB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YACtB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAChE,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,kBAAkB;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC9E,MAAM,GAAG,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,oBAAoB,CAAkB,eAAe,EAAE,aAAa,CAAC,CAAC;QAClF,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YACtB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO;QACvC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,IAAI,EAAE;YACrB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,GAAG,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,oBAAoB,CAAO,cAAc,EAAE,QAAQ,CAAC,CAAC;QACjE,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,GAAG,CAAC,EAAE,CACJ,GAAG,EACH,GAAG,EAAE;YACH,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC,EACD,CAAC,EAAE,CACJ,CAAC;QACF,GAAG,CAAC,EAAE,CACJ,GAAG,EACH,GAAG,EAAE;YACH,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC,EACD,GAAG,CACJ,CAAC;QACF,GAAG,CAAC,EAAE,CACJ,GAAG,EACH,GAAG,EAAE;YACH,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC,EACD,CAAC,CACF,CAAC;QAEF,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAChD,MAAM,GAAG,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,oBAAoB,CAAO,YAAY,EAAE,UAAU,CAAC,CAAC;QACjE,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE;YAC3B,KAAK,EAAE,CAAC;QACV,CAAC,CAAC,CAAC;QAEH,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC/B,GAAG,EAAE,CAAC;QACN,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,sEAAsE;AAEtE,QAAQ,CAAC,4CAA4C,EAAE,GAAG,EAAE;IAC1D,EAAE,CAAC,sFAAsF,EAAE,KAAK,IAAI,EAAE;QACpG,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,IAAI,GAAa,EAAE,CAAC;QAE1B,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,GAAG,EAAE;YACvC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,GAAG,EAAE;YACtC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,GAAG,EAAE;YAC5C,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,GAAG,EAAE;YACxC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;QAEH,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAEhC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QAClB,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QACtD,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACvC,IAAI,QAA4B,CAAC;QACjC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC,CAAC,EAAE,EAAE;YAC7C,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;QACtB,CAAC,CAAC,CAAC;QACH,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACnC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,sEAAsE;AAEtE,QAAQ,CAAC,uCAAuC,EAAE,GAAG,EAAE;IACrD,MAAM,IAAI,GAAG,YAAY,CAAC;QACxB,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;KACpC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAClD,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC;QAC7C,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,EAAE;QAC/B,OAAO,EAAE,CAAC,IAAI,CAAC;QACf,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1C,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,CAAC,CAAC,EAAE,EAAE;YAC/C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC,CAAC,EAAE,EAAE;YAC7C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,GAAG,EAAE;YACzC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;QAEH,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAE3C,8DAA8D;QAC9D,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC,CAAC;QACxD,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC9E,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1C,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,GAAG,EAAE;YAC9C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,GAAG,EAAE;YAC5C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE;YAC1C,IAAI,CAAC,IAAI,CAAC,QAAS,CAAC,CAAC,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAChF,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC;QAC/C,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1C,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QAExD,uEAAuE;QACvE,gBAAgB;QAChB,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,GAAG,EAAE;YAC5C,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC1D,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QAE1C,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,CAAC;QAC/B,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,oCAAoC;QACnE,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,gCAAgC;QAChE,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/inline-handler.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Inline-handler shortcut — `defineAction({..., handler})` collapses the
+ * action contract + handler into a single declaration. createApp auto-
+ * registers the inline handler when walking `manifest.actions`. The
+ * separate `defineHandler(action, fn)` form keeps working alongside.
+ */
+export {};
+//# sourceMappingURL=inline-handler.test.d.ts.map

package/dist/__tests__/inline-handler.test.d.ts.map

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

package/dist/__tests__/inline-handler.test.js

@@ -0,0 +1,101 @@
+/**
+ * Inline-handler shortcut — `defineAction({..., handler})` collapses the
+ * action contract + handler into a single declaration. createApp auto-
+ * registers the inline handler when walking `manifest.actions`. The
+ * separate `defineHandler(action, fn)` form keeps working alongside.
+ */
+import { describe, it, expect } from "vitest";
+import { z } from "zod";
+import { defineAction, defineHandler, defineModule, createApp, Runtime } from "../foundation.js";
+describe("inline-handler shortcut", () => {
+    it("dispatches an action with an inline handler", async () => {
+        let calls = 0;
+        const ping = defineAction({
+            name: "ping.inline",
+            schema: z.object({}),
+            handler: async () => {
+                calls++;
+                return undefined;
+            },
+        });
+        expect(ping.handler).toBeDefined();
+        expect(ping.handler?.action.name).toBe("ping.inline");
+        const runtime = new Runtime();
+        // Register via the synthesized handler.
+        runtime.registerHandler(ping.handler);
+        await runtime.dispatch(ping, {});
+        expect(calls).toBe(1);
+    });
+    it("createApp auto-registers inline handlers from manifest.actions", async () => {
+        let calls = 0;
+        const ping = defineAction({
+            name: "ping.via-app",
+            schema: z.object({}),
+            handler: async () => {
+                calls++;
+                return undefined;
+            },
+        });
+        const module = defineModule("ping-module", {
+            actions: [ping],
+            // No separate `handlers:` — the inline form is enough.
+        });
+        const app = createApp({ modules: [module] });
+        await app.runtime.dispatch(ping, {});
+        expect(calls).toBe(1);
+    });
+    it("inline handler coexists with separate defineHandler in the same module", async () => {
+        const inlineAction = defineAction({
+            name: "mixed.inline",
+            schema: z.object({}),
+            handler: async () => undefined,
+        });
+        const separateAction = defineAction({
+            name: "mixed.separate",
+            schema: z.object({}),
+        });
+        const separateHandler = defineHandler(separateAction, async () => undefined);
+        const module = defineModule("mixed-module", {
+            actions: [inlineAction, separateAction],
+            handlers: [separateHandler],
+        });
+        const app = createApp({ modules: [module] });
+        // Both dispatch without "no handler registered" errors.
+        await app.runtime.dispatch(inlineAction, {});
+        await app.runtime.dispatch(separateAction, {});
+    });
+    it("inline handler receives typed input and ctx", async () => {
+        let seen;
+        let seenRequestId = "";
+        const enroll = defineAction({
+            name: "enroll.typed",
+            schema: z.object({ studentId: z.string() }),
+            handler: async (input, ctx) => {
+                seen = input;
+                seenRequestId = ctx.requestId;
+                return undefined;
+            },
+        });
+        const app = createApp({ modules: [defineModule("m", { actions: [enroll] })] });
+        await app.runtime.dispatch(enroll, { studentId: "avi-1" });
+        expect(seen).toEqual({ studentId: "avi-1" });
+        expect(seenRequestId).toMatch(/^[0-9a-f-]{36}$/i);
+    });
+    it("registering the same action via both inline AND defineHandler throws", () => {
+        const action = defineAction({
+            name: "dup.action",
+            schema: z.object({}),
+            handler: async () => undefined,
+        });
+        const duplicateHandler = defineHandler(action, async () => undefined);
+        expect(() => createApp({
+            modules: [
+                defineModule("dup", {
+                    actions: [action],
+                    handlers: [duplicateHandler],
+                }),
+            ],
+        })).toThrow(/already registered/);
+    });
+});
+//# sourceMappingURL=inline-handler.test.js.map