@nwire/app 0.11.1 → 0.12.0

package/README.md

@@ -69,15 +69,17 @@ await endpoint("monolith", { port: 3000 }).use(httpKoa()).mount(monolith).run();
 ## Framework events
 
 The runtime fires typed events at lifecycle transitions —
-`AppBooting`, `AppBooted`, `PluginBooting`, `PluginBooted`,
-`AppStopping`, `AppStopped`. Subscribe via the App's `FrameworkEventBus`
-or register a `FrameworkEventBus` hook from a plugin.
+`AppBooting`, `AppBooted`, `AppReady`, `PluginBooting`, `PluginBooted`,
+`AppShuttingDown`, `AppShutdown`. Observe them from a plugin's ctx `on` —
+the payload is typed from the named hook.
 
 ```ts
-import { AppBooted } from "@nwire/app";
+import { definePlugin } from "@nwire/app";
 
-app.frameworkBus.on(AppBooted, ({ appName, bootedAt }) => {
-  console.log(`${appName} booted at ${bootedAt}`);
+const readyLog = definePlugin("ready-log", ({ on }) => {
+  on("AppBooted", ({ appName, bootedAt }) => {
+    console.log(`${appName} booted at ${bootedAt}`);
+  });
 });
 ```
 

package/dist/create-app.d.ts

@@ -20,8 +20,8 @@
 import { type Container } from "@nwire/container/awilix";
 import { type Logger } from "@nwire/logger";
 import { type Binding, type HandlerDef, type Interface, type WireCtxBuilder } from "@nwire/wires";
-import type { EventDefinition } from "@nwire/messages";
-import type { MessageEnvelope } from "@nwire/envelope";
+import type { EventDefinition, EventPayload } from "@nwire/messages";
+import type { ListenerContext } from "@nwire/runtime";
 import { type PluginDefinition, type Runtime } from "./runtime/index.js";
 import { type Subscription } from "./subscribe.js";
 export interface CreateAppOptions {
@@ -87,12 +87,12 @@ export interface App<TCaps = {}> {
      * pulling a dedicated listener file feels heavy. For organised codebases,
      * prefer `.subscribe([...])` from `app/listeners/`.
      */
-    when<TPayload>(event: EventDefinition & {
+    when<E extends EventDefinition & {
         readonly name: string;
         readonly schema: {
             parse(input: unknown): unknown;
         };
-    }, fn: (payload: TPayload, envelope: MessageEnvelope) => Promise<void> | void): this;
+    }>(event: E, fn: (payload: EventPayload<E>, ctx: ListenerContext) => Promise<void> | void): this;
     /** Sugar for `app.interface.wire(b, h)`. Returns the app for chaining. */
     wire(binding: Binding, handler: HandlerDef): this;
     /** Sugar for `app.interface.provide(builder)`. Returns the app for chaining. */

package/dist/subscribe.d.ts

@@ -12,21 +12,24 @@
  *   import { UserRegistered } from "../events";
  *
  *   export default subscribe((when) => {
- *     when(UserRegistered, async (payload, env) => {
- *       await sendWelcomeEmail(payload.email);
+ *     when(UserRegistered, async (user, ctx) => {
+ *       await ctx.send(sendWelcome({ email: user.email }));
  *     });
  *   });
  *
  * Subscriptions are registered through `app.subscribe(sub | subs)`.
  */
-import type { EventDefinition } from "@nwire/messages";
-import type { MessageEnvelope } from "@nwire/envelope";
+import type { EventDefinition, EventPayload } from "@nwire/messages";
+import type { ListenerContext } from "@nwire/runtime";
 /**
- * Late-bound listener registration handed to a subscribe closure.
+ * Late-bound listener registration handed to a subscribe closure. The
+ * handler receives the event payload and a {@link ListenerContext} — the
+ * subset of the workflow `when` ctx, so the same block moves into a
+ * `defineWorkflow` unchanged.
  */
-export type WhenFn = <TPayload>(event: EventDefinition & {
+export type WhenFn = <E extends EventDefinition & {
     readonly name: string;
-}, fn: (payload: TPayload, envelope: MessageEnvelope) => Promise<void> | void) => void;
+}>(event: E, fn: (payload: EventPayload<E>, ctx: ListenerContext) => Promise<void> | void) => void;
 /**
  * A subscription is a closure waiting for an App's `when` to be handed in.
  * `install(when)` is the contract: the App passes its runtime's `when` and

package/dist/subscribe.js

@@ -12,8 +12,8 @@
  *   import { UserRegistered } from "../events";
  *
  *   export default subscribe((when) => {
- *     when(UserRegistered, async (payload, env) => {
- *       await sendWelcomeEmail(payload.email);
+ *     when(UserRegistered, async (user, ctx) => {
+ *       await ctx.send(sendWelcome({ email: user.email }));
  *     });
  *   });
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nwire/app",
-  "version": "0.11.1",
+  "version": "0.12.0",
   "description": "Nwire — managed Container with plugin lifecycle, framework events, and DI hooks. Composes modules + plugins, boots in order, exposes a Container, fires framework events at every lifecycle transition.",
   "keywords": [
     "app",
@@ -29,14 +29,14 @@
     "access": "public"
   },
   "dependencies": {
-    "@nwire/container": "0.11.1",
-    "@nwire/envelope": "0.11.1",
-    "@nwire/handler": "0.11.1",
-    "@nwire/hooks": "0.11.1",
-    "@nwire/logger": "0.11.1",
-    "@nwire/messages": "0.11.1",
-    "@nwire/runtime": "0.11.1",
-    "@nwire/wires": "0.11.1"
+    "@nwire/container": "0.12.0",
+    "@nwire/envelope": "0.12.0",
+    "@nwire/hooks": "0.12.0",
+    "@nwire/logger": "0.12.0",
+    "@nwire/messages": "0.12.0",
+    "@nwire/handler": "0.12.0",
+    "@nwire/wires": "0.12.0",
+    "@nwire/runtime": "0.12.0"
   },
   "devDependencies": {
     "@types/node": "^22.19.9",