@beignet/provider-event-bus-memory 0.0.49 → 0.0.51

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @beignet/provider-event-bus-memory
 
+## 0.0.51
+
+### Patch Changes
+
+- 4f033a6: Forward canonical event payloads, expose framework error ownership through CORS, run focused-route misses through the fallback lifecycle, and inspect formatted route handlers with the TypeScript AST.
+
+## 0.0.50
+
+### Patch Changes
+
+- 6fe026a: Expose event-subscription readiness and asynchronous cleanup, await listener
+  registries during provider startup with bounded rollback, diagnose unsafe app
+  wiring, and make Redis subscription lifecycle failures observable with bounded
+  provider shutdown and recoverable channel state.
+
 ## 0.0.49
 
 ### Patch Changes

package/README.md

@@ -43,11 +43,13 @@ const UserRegistered = defineEvent("user.registered", {
 const eventBus = createMemoryEventBus();
 
 // Subscribe to events
-const unsubscribe = eventBus.subscribe(UserRegistered, (payload) => {
+const subscription = eventBus.subscribe(UserRegistered, (payload) => {
   console.log(`User registered: ${payload.email}`);
   // Send welcome email, update analytics, etc.
 });
 
+await subscription.ready;
+
 // Publish events
 await eventBus.publish(UserRegistered, {
   userId: "123",
@@ -55,7 +57,7 @@ await eventBus.publish(UserRegistered, {
 });
 
 // Unsubscribe when done
-unsubscribe();
+await subscription.unsubscribe();
 ```
 
 ## Framework setup
@@ -116,14 +118,18 @@ const OrderPlaced = defineEvent("order.placed", {
 });
 
 // Subscribe to events in your application setup
-ctx.ports.eventBus.subscribe(OrderPlaced, async (payload) => {
-  // Send order confirmation email
-  await ctx.ports.mailer.send({
-    to: customer.email,
-    subject: "Order Confirmation",
-    text: `Your order ${payload.orderId} has been placed!`,
-  });
-});
+const orderPlacedSubscription = ctx.ports.eventBus.subscribe(
+  OrderPlaced,
+  async (payload) => {
+    // Send order confirmation email
+    await ctx.ports.mailer.send({
+      to: customer.email,
+      subject: "Order Confirmation",
+      text: `Your order ${payload.orderId} has been placed!`,
+    });
+  },
+);
+await orderPlacedSubscription.ready;
 
 const placeOrder = useCase
   .command("orders.place")
@@ -142,6 +148,11 @@ const placeOrder = useCase
       return order;
     });
   });
+
+// Call this from the application's shutdown hook.
+export async function stopOrderListeners() {
+  await orderPlacedSubscription.unsubscribe();
+}
 ```
 
 ## EventBus port API
@@ -168,18 +179,22 @@ The optional third `{ trace }` argument is transport metadata used by Beignet
 listeners. When `instrumentation` exposes a tracing port, the bus captures the
 active context automatically. Existing two-argument calls are unchanged.
 
-### `subscribe<E>(event, handler): () => void`
+### `subscribe<E>(event, handler): EventSubscription`
 
-Subscribe to a domain event. Returns an unsubscribe function.
+Subscribe to a domain event. The memory adapter is active synchronously, so
+`ready` is already resolved. `unsubscribe()` is idempotent and removes local
+delivery before its promise resolves.
 
 ```typescript
-const unsubscribe = eventBus.subscribe(UserRegistered, (payload, options) => {
+const subscription = eventBus.subscribe(UserRegistered, (payload, options) => {
   console.log(`New user: ${payload.email}`);
   console.log(options?.trace?.traceparent);
 });
 
+await subscription.ready;
+
 // Later, when you want to stop listening:
-unsubscribe();
+await subscription.unsubscribe();
 ```
 
 ## TypeScript support
@@ -211,7 +226,8 @@ describe("User Registration", () => {
     const eventBus = createMemoryEventBus();
     const handler = mock(() => {});
     
-    eventBus.subscribe(UserRegistered, handler);
+    const subscription = eventBus.subscribe(UserRegistered, handler);
+    await subscription.ready;
     
     // Perform registration
     await registerUser(ctx, { email: "test@example.com" });
@@ -220,6 +236,8 @@ describe("User Registration", () => {
       userId: expect.any(String),
       email: "test@example.com",
     });
+
+    await subscription.unsubscribe();
   });
 });
 ```
@@ -232,6 +250,9 @@ describe("User Registration", () => {
 - **Memory-only**: No persistence - events are lost if the process crashes
 - **Order**: Handlers are called in the order they were subscribed
 - **Multiple handlers**: Multiple handlers can subscribe to the same event
+- **Canonical helper delivery**: `publishEvent(...)` and use-case event helpers
+  preserve parsed payload state through in-process delivery, so
+  `registerListeners(...)` does not apply schema transforms twice
 - **Error handling**: Handler errors reject `publish(...)` unless
   `onHandlerError` is configured
 

package/dist/index.d.ts

@@ -14,15 +14,16 @@
  * const eventBus = createMemoryEventBus();
  *
  * // Subscribe to an event
- * const unsubscribe = eventBus.subscribe(UserRegistered, (payload) => {
+ * const subscription = eventBus.subscribe(UserRegistered, (payload) => {
  *   console.log(`User registered: ${payload.email}`);
  * });
+ * await subscription.ready;
  *
  * // Publish an event
  * await eventBus.publish(UserRegistered, { userId: "123", email: "test@example.com" });
  *
  * // Unsubscribe when done
- * unsubscribe();
+ * await subscription.unsubscribe();
  * ```
  */
 import type { EventBusPort } from "@beignet/core/ports";
@@ -91,11 +92,13 @@ export interface MemoryEventBusProviderPorts {
  * ```ts
  * const eventBus = createMemoryEventBus();
  *
- * eventBus.subscribe(UserRegistered, (payload) => {
+ * const subscription = eventBus.subscribe(UserRegistered, (payload) => {
  *   console.log(`User registered: ${payload.email}`);
  * });
+ * await subscription.ready;
  *
  * await eventBus.publish(UserRegistered, { userId: "123", email: "test@example.com" });
+ * await subscription.unsubscribe();
  * ```
  *
  * @example

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAGL,KAAK,6BAA6B,EACnC,MAAM,yBAAyB,CAAC;AAGjC;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,eAAe,CAAC,EAAE,6BAA6B,CAAC;IAEhD;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAElC;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,EAAE,CACf,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,KACb,IAAI,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,6BACf,SAAQ,IAAI,CAAC,qBAAqB,EAAE,iBAAiB,CAAC;IACtD;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,qBAA0B,GAClC,YAAY,CAoGd;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE,6BAAkC;;kBAiB5C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAGL,KAAK,6BAA6B,EACnC,MAAM,yBAAyB,CAAC;AAGjC;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,eAAe,CAAC,EAAE,6BAA6B,CAAC;IAEhD;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAElC;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,EAAE,CACf,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,KACb,IAAI,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,6BACf,SAAQ,IAAI,CAAC,qBAAqB,EAAE,iBAAiB,CAAC;IACtD;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,qBAA0B,GAClC,YAAY,CAsHd;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE,6BAAkC;;kBAiB5C"}

package/dist/index.js

@@ -14,15 +14,16 @@
  * const eventBus = createMemoryEventBus();
  *
  * // Subscribe to an event
- * const unsubscribe = eventBus.subscribe(UserRegistered, (payload) => {
+ * const subscription = eventBus.subscribe(UserRegistered, (payload) => {
  *   console.log(`User registered: ${payload.email}`);
  * });
+ * await subscription.ready;
  *
  * // Publish an event
  * await eventBus.publish(UserRegistered, { userId: "123", email: "test@example.com" });
  *
  * // Unsubscribe when done
- * unsubscribe();
+ * await subscription.unsubscribe();
  * ```
  */
 import { createProvider, createProviderInstrumentation, } from "@beignet/core/providers";
@@ -38,11 +39,13 @@ import { captureTraceCarrier, parseTraceCarrier } from "@beignet/core/tracing";
  * ```ts
  * const eventBus = createMemoryEventBus();
  *
- * eventBus.subscribe(UserRegistered, (payload) => {
+ * const subscription = eventBus.subscribe(UserRegistered, (payload) => {
  *   console.log(`User registered: ${payload.email}`);
  * });
+ * await subscription.ready;
  *
  * await eventBus.publish(UserRegistered, { userId: "123", email: "test@example.com" });
+ * await subscription.unsubscribe();
  * ```
  *
  * @example
@@ -83,7 +86,20 @@ export function createMemoryEventBus(options = {}) {
             const subscribers = [...subs];
             const trace = parseTraceCarrier(publishOptions?.trace) ??
                 captureTraceCarrier(options.instrumentation);
-            const deliveryOptions = trace ? { trace } : undefined;
+            let deliveryOptions;
+            if (publishOptions) {
+                const hasNonTraceMetadata = Reflect.ownKeys(publishOptions).some((key) => key !== "trace");
+                if (trace || hasNonTraceMetadata) {
+                    deliveryOptions = { ...publishOptions };
+                    if (trace)
+                        deliveryOptions.trace = trace;
+                    else
+                        delete deliveryOptions.trace;
+                }
+            }
+            else if (trace) {
+                deliveryOptions = { trace };
+            }
             if (delivery === "fire-and-forget") {
                 for (const handler of subscribers) {
                     try {
@@ -118,11 +134,18 @@ export function createMemoryEventBus(options = {}) {
                 handlers.set(event.name, subs);
             }
             subs.add(handler);
-            return () => {
-                subs.delete(handler);
-                if (subs.size === 0) {
-                    handlers.delete(event.name);
-                }
+            let unsubscribed = false;
+            return {
+                ready: Promise.resolve(),
+                async unsubscribe() {
+                    if (unsubscribed)
+                        return;
+                    unsubscribed = true;
+                    subs.delete(handler);
+                    if (subs.size === 0) {
+                        handlers.delete(event.name);
+                    }
+                },
             };
         },
     };

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beignet/provider-event-bus-memory",
-  "version": "0.0.49",
+  "version": "0.0.51",
   "type": "module",
   "description": "In-memory event bus provider for Beignet - implements EventBusPort for single-process applications",
   "main": "./dist/index.js",

package/src/index.ts

@@ -14,15 +14,16 @@
  * const eventBus = createMemoryEventBus();
  *
  * // Subscribe to an event
- * const unsubscribe = eventBus.subscribe(UserRegistered, (payload) => {
+ * const subscription = eventBus.subscribe(UserRegistered, (payload) => {
  *   console.log(`User registered: ${payload.email}`);
  * });
+ * await subscription.ready;
  *
  * // Publish an event
  * await eventBus.publish(UserRegistered, { userId: "123", email: "test@example.com" });
  *
  * // Unsubscribe when done
- * unsubscribe();
+ * await subscription.unsubscribe();
  * ```
  */
 
@@ -110,11 +111,13 @@ export interface MemoryEventBusProviderPorts {
  * ```ts
  * const eventBus = createMemoryEventBus();
  *
- * eventBus.subscribe(UserRegistered, (payload) => {
+ * const subscription = eventBus.subscribe(UserRegistered, (payload) => {
  *   console.log(`User registered: ${payload.email}`);
  * });
+ * await subscription.ready;
  *
  * await eventBus.publish(UserRegistered, { userId: "123", email: "test@example.com" });
+ * await subscription.unsubscribe();
  * ```
  *
  * @example
@@ -173,7 +176,19 @@ export function createMemoryEventBus(
       const trace =
         parseTraceCarrier(publishOptions?.trace) ??
         captureTraceCarrier(options.instrumentation);
-      const deliveryOptions = trace ? { trace } : undefined;
+      let deliveryOptions: EventPublishOptions | undefined;
+      if (publishOptions) {
+        const hasNonTraceMetadata = Reflect.ownKeys(publishOptions).some(
+          (key) => key !== "trace",
+        );
+        if (trace || hasNonTraceMetadata) {
+          deliveryOptions = { ...publishOptions };
+          if (trace) deliveryOptions.trace = trace;
+          else delete deliveryOptions.trace;
+        }
+      } else if (trace) {
+        deliveryOptions = { trace };
+      }
 
       if (delivery === "fire-and-forget") {
         for (const handler of subscribers) {
@@ -216,16 +231,22 @@ export function createMemoryEventBus(
         ) => void | Promise<void>,
       );
 
-      return () => {
-        subs.delete(
-          handler as unknown as (
-            payload: unknown,
-            options?: EventPublishOptions,
-          ) => void | Promise<void>,
-        );
-        if (subs.size === 0) {
-          handlers.delete(event.name);
-        }
+      let unsubscribed = false;
+      return {
+        ready: Promise.resolve(),
+        async unsubscribe() {
+          if (unsubscribed) return;
+          unsubscribed = true;
+          subs.delete(
+            handler as unknown as (
+              payload: unknown,
+              options?: EventPublishOptions,
+            ) => void | Promise<void>,
+          );
+          if (subs.size === 0) {
+            handlers.delete(event.name);
+          }
+        },
       };
     },
   };