@zeltjs/eventbus 0.11.0 → 0.12.0-canary.0

package/README.md

@@ -14,20 +14,68 @@ npm install @zeltjs/eventbus @zeltjs/core
 
 ## Usage
 
+Declare your event schema by augmenting `EventBusSchema`:
+
 ```typescript
-import { MemoryEventBusAdaptor } from '@zeltjs/eventbus';
-import type { EventBusSchema } from '@zeltjs/eventbus';
+declare module '@zeltjs/eventbus' {
+  interface EventBusSchema {
+    'order:created': { orderId: number; userId: number };
+  }
+}
 
-type MyEvents = EventBusSchema<{
-  'user.created': { id: string; name: string };
-  'user.deleted': { id: string };
-}>;
+export {};
+```
 
-const eventbus = new MemoryEventBusAdaptor<MyEvents>();
+Register the `eventbus` feature with an adaptor in `createApp`:
+
+```typescript
+import { createApp } from '@zeltjs/core';
+import { eventbus, MemoryEventBusAdaptor } from '@zeltjs/eventbus';
 
-eventbus.on('user.created', (data) => {
-  console.log('User created:', data.name);
+const app = createApp([eventbus({ adaptor: MemoryEventBusAdaptor })]);
+const runtime = await app.createRuntime();
+
+runtime.eventbus.on('order:created', (data) => {
+  console.log('Order created:', data.orderId);
 });
 
-eventbus.emit('user.created', { id: '1', name: 'Alice' });
+await runtime.eventbus.emit('order:created', { orderId: 1, userId: 2 });
 ```
+
+Subscribers are ordinary `Lifecycle` classes: subscribe in `startup()`, unsubscribe in `shutdown()`, and pass them as `handlers` so the feature resolves and starts them:
+
+```typescript
+import type { Lifecycle } from '@zeltjs/core';
+import { Injectable, inject, LifecycleManager } from '@zeltjs/core';
+import { MemoryEventBusAdaptor } from '@zeltjs/eventbus';
+
+@Injectable()
+class OrderHandlers implements Lifecycle {
+  private unsubscribes: Array<() => void> = [];
+
+  constructor(
+    private readonly eventBus = inject(MemoryEventBusAdaptor),
+    lifecycle = inject(LifecycleManager),
+  ) {
+    lifecycle.register(this);
+  }
+
+  async startup(): Promise<void> {
+    const unsub = this.eventBus.on('order:created', (data) => {
+      // handle event
+    });
+    this.unsubscribes.push(unsub);
+  }
+
+  async shutdown(): Promise<void> {
+    for (const unsub of this.unsubscribes) unsub();
+    this.unsubscribes = [];
+  }
+}
+
+const app = createApp([
+  eventbus({ adaptor: MemoryEventBusAdaptor, handlers: [OrderHandlers] }),
+]);
+```
+
+Use `RedisEventBusAdaptor` from `@zeltjs/eventbus/adaptor-redis` in place of `MemoryEventBusAdaptor` to fan events out across processes via Redis pub/sub.

package/dist/adaptor-memory/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_adaptor_memory = require("../adaptor-memory-Obg3l9mF.cjs");
+const require_adaptor_memory = require("../adaptor-memory-zYqB6KAT.cjs");
 Object.defineProperty(exports, "MemoryEventBusAdaptor", {
 	enumerable: true,
 	get: function() {

package/dist/adaptor-memory/index.d.cts

@@ -1,2 +1,2 @@
-import { t as MemoryEventBusAdaptor } from "../index-qecFavvB.cjs";
+import { t as MemoryEventBusAdaptor } from "../index-C2cRFzub.cjs";
 export { MemoryEventBusAdaptor };

package/dist/adaptor-memory/index.d.ts

@@ -1,2 +1,2 @@
-import { t as MemoryEventBusAdaptor } from "../index-Buq5DkB1.js";
+import { t as MemoryEventBusAdaptor } from "../index-CcpSMqqG.js";
 export { MemoryEventBusAdaptor };

package/dist/adaptor-memory/index.js

@@ -1,2 +1,2 @@
-import { t as MemoryEventBusAdaptor } from "../adaptor-memory-BG1Xyr7_.js";
+import { t as MemoryEventBusAdaptor } from "../adaptor-memory-WYgtTbUx.js";
 export { MemoryEventBusAdaptor };

package/dist/{adaptor-memory-BG1Xyr7_.js → adaptor-memory-WYgtTbUx.js}

@@ -11,17 +11,16 @@ var MemoryEventBusAdaptor = class {
 	async emit(event, data) {
 		this.emitter.emit(event, data);
 	}
-	on(event, handler) {
+	async on(event, handler) {
 		this.emitter.on(event, handler);
 		return () => this.emitter.off(event, handler);
 	}
-	once(event, handler) {
+	async once(event, handler) {
 		const wrappedHandler = (data) => {
-			unsubscribe();
+			this.emitter.off(event, wrappedHandler);
 			handler(data);
 		};
-		const unsubscribe = this.on(event, wrappedHandler);
-		return unsubscribe;
+		return this.on(event, wrappedHandler);
 	}
 	constructor() {
 		this.emitter = mitt_default();
@@ -31,4 +30,4 @@ MemoryEventBusAdaptor = _ts_decorate([Injectable()], MemoryEventBusAdaptor);
 //#endregion
 export { MemoryEventBusAdaptor as t };
 
-//# sourceMappingURL=adaptor-memory-BG1Xyr7_.js.map
+//# sourceMappingURL=adaptor-memory-WYgtTbUx.js.map

package/dist/adaptor-memory-WYgtTbUx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptor-memory-WYgtTbUx.js","names":["Injectable","mitt","MemoryEventBusAdaptor","emit","event","data","emitter","on","handler","off","once","wrappedHandler"],"sources":["../src/adaptor-memory/memory-event-bus.adaptor.ts"],"sourcesContent":["import { Injectable } from '@zeltjs/core';\nimport mitt from 'mitt';\n\nimport type { EventBusAdaptor, EventBusSchema } from '../eventbus.types';\n\n@Injectable()\nexport class MemoryEventBusAdaptor implements EventBusAdaptor {\n  private readonly emitter = mitt<EventBusSchema>();\n\n  async emit<K extends string & keyof EventBusSchema>(\n    event: K,\n    data: EventBusSchema[K],\n  ): Promise<void> {\n    this.emitter.emit(event, data);\n  }\n\n  async on<K extends string & keyof EventBusSchema>(\n    event: K,\n    handler: (data: EventBusSchema[K]) => void,\n  ): Promise<() => void> {\n    this.emitter.on(event, handler);\n    return () => this.emitter.off(event, handler);\n  }\n\n  async once<K extends string & keyof EventBusSchema>(\n    event: K,\n    handler: (data: EventBusSchema[K]) => void,\n  ): Promise<() => void> {\n    // Unsubscribes itself directly instead of going through on()'s returned\n    // function, since that function only resolves after this handler is\n    // already registered.\n    const wrappedHandler = (data: EventBusSchema[K]) => {\n      this.emitter.off(event, wrappedHandler);\n      handler(data);\n    };\n    return this.on(event, wrappedHandler);\n  }\n}\n"],"mappings":";;;;;;;;;AAMA,IAAaE,wBAAb,MAAaA;CAGX,MAAMC,KACJC,OACAC,MACe;AACf,OAAKC,QAAQH,KAAKC,OAAOC,KAAAA;;CAG3B,MAAME,GACJH,OACAI,SACqB;AACrB,OAAKF,QAAQC,GAAGH,OAAOI,QAAAA;AACvB,eAAa,KAAKF,QAAQG,IAAIL,OAAOI,QAAAA;;CAGvC,MAAME,KACJN,OACAI,SACqB;EAIrB,MAAMG,kBAAkBN,SAAAA;AACtB,QAAKC,QAAQG,IAAIL,OAAOO,eAAAA;AACxBH,WAAQH,KAAAA;;AAEV,SAAO,KAAKE,GAAGH,OAAOO,eAAAA;;;OA5BPL,UAAUL,cAAAA"}

package/dist/{adaptor-memory-Obg3l9mF.cjs → adaptor-memory-zYqB6KAT.cjs}

@@ -11,17 +11,16 @@ var MemoryEventBusAdaptor = class {
 	async emit(event, data) {
 		this.emitter.emit(event, data);
 	}
-	on(event, handler) {
+	async on(event, handler) {
 		this.emitter.on(event, handler);
 		return () => this.emitter.off(event, handler);
 	}
-	once(event, handler) {
+	async once(event, handler) {
 		const wrappedHandler = (data) => {
-			unsubscribe();
+			this.emitter.off(event, wrappedHandler);
 			handler(data);
 		};
-		const unsubscribe = this.on(event, wrappedHandler);
-		return unsubscribe;
+		return this.on(event, wrappedHandler);
 	}
 	constructor() {
 		this.emitter = require_mitt.mitt_default();

package/dist/adaptor-redis/index.cjs

@@ -13,42 +13,68 @@ function _ts_metadata(k, v) {
 	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
 var RedisEventBusAdaptor = class {
-	async startup() {}
+	async startup() {
+		try {
+			await this.sub.connect();
+			if (this.subscriptions.size > 0) await this.sub.subscribe(...this.subscriptions);
+		} catch (error) {
+			this.sub.disconnect();
+			throw error;
+		}
+	}
 	async shutdown() {
 		this.sub.disconnect();
 	}
 	async emit(event, data) {
 		await this.pub.publish(event, JSON.stringify(data));
 	}
-	on(event, handler) {
-		if (!this.subscriptions.has(event)) {
-			this.subscriptions.add(event);
-			this.sub.subscribe(event);
-		}
+	/**
+	* @throws {Error} When the channel's SUBSCRIBE command to Redis fails,
+	* whether this call sent it or joined another in-flight on() for the same
+	* channel; the handler is not registered in that case.
+	*/ async on(event, handler) {
 		this.localEmitter.on(event, handler);
+		if (!(this.sub.status !== "wait" && this.sub.status !== "end")) this.subscriptions.add(event);
+		else if (!this.subscriptions.has(event)) {
+			let subscribing = this.subscribing.get(event);
+			if (!subscribing) {
+				subscribing = this.sub.subscribe(event).then(() => {
+					this.subscriptions.add(event);
+				}).finally(() => {
+					this.subscribing.delete(event);
+				});
+				this.subscribing.set(event, subscribing);
+			}
+			try {
+				await subscribing;
+			} catch (error) {
+				this.localEmitter.off(event, handler);
+				throw error;
+			}
+		}
 		return () => {
 			this.localEmitter.off(event, handler);
 		};
 	}
-	once(event, handler) {
+	/** @throws {Error} Same as on(), which this delegates to. */ async once(event, handler) {
 		const wrappedHandler = (data) => {
-			unsubscribe();
+			this.localEmitter.off(event, wrappedHandler);
 			handler(data);
 		};
-		const unsubscribe = this.on(event, wrappedHandler);
-		return unsubscribe;
+		return this.on(event, wrappedHandler);
 	}
 	constructor(redis = (0, _zeltjs_core.inject)(_zeltjs_redis.RedisService), lifecycle = (0, _zeltjs_core.inject)(_zeltjs_core.LifecycleManager)) {
 		this.localEmitter = require_mitt.mitt_default();
 		this.subscriptions = /* @__PURE__ */ new Set();
+		this.subscribing = /* @__PURE__ */ new Map();
 		this.pub = redis.client;
-		this.sub = redis.client.duplicate();
-		lifecycle.register(this);
+		this.sub = this.pub.duplicate();
 		this.sub.on("message", (channel, message) => {
 			if (!this.subscriptions.has(channel)) return;
 			const data = JSON.parse(message);
 			this.localEmitter.emit(channel, data);
 		});
+		lifecycle.register(this);
 	}
 };
 RedisEventBusAdaptor = _ts_decorate([

package/dist/adaptor-redis/index.d.cts

@@ -1,4 +1,4 @@
-import { n as EventBusSchema, t as EventBusAdaptor } from "../eventbus.types-kl1yXTK8.cjs";
+import { n as EventBusSchema, t as EventBusAdaptor } from "../eventbus.types-Dk9jl4Xp.cjs";
 import { Lifecycle, LifecycleManager } from "@zeltjs/core";
 import { RedisService } from "@zeltjs/redis";
 
@@ -8,12 +8,19 @@ declare class RedisEventBusAdaptor implements EventBusAdaptor, Lifecycle {
   private readonly sub;
   private readonly localEmitter;
   private readonly subscriptions;
+  private readonly subscribing;
   constructor(redis?: RedisService, lifecycle?: LifecycleManager);
   startup(): Promise<void>;
   shutdown(): Promise<void>;
   emit<K extends string & keyof EventBusSchema>(event: K, data: EventBusSchema[K]): Promise<void>;
-  on<K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): () => void;
-  once<K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): () => void;
+  /**
+   * @throws {Error} When the channel's SUBSCRIBE command to Redis fails,
+   * whether this call sent it or joined another in-flight on() for the same
+   * channel; the handler is not registered in that case.
+   */
+  on<K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): Promise<() => void>;
+  /** @throws {Error} Same as on(), which this delegates to. */
+  once<K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): Promise<() => void>;
 }
 //#endregion
 export { RedisEventBusAdaptor };

package/dist/adaptor-redis/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/adaptor-redis/redis-event-bus.adaptor.ts"],"mappings":";;;;;cASa,oBAAA,YAAgC,eAAA,EAAiB,SAAA;EAAA,iBAC3C,GAAA;EAAA,iBACA,GAAA;EAAA,iBACA,YAAA;EAAA,iBACA,aAAA;cAEL,KAAA,GAAK,YAAA,EAAyB,SAAA,GAAS,gBAAA;EAY7C,OAAA,CAAA,GAAW,OAAA;EAEX,QAAA,CAAA,GAAY,OAAA;EAIZ,IAAA,0BAA8B,cAAA,CAAA,CAClC,KAAA,EAAO,CAAA,EACP,IAAA,EAAM,cAAA,CAAe,CAAA,IACpB,OAAA;EAIH,EAAA,0BAA4B,cAAA,CAAA,CAC1B,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA;EAajC,IAAA,0BAA8B,cAAA,CAAA,CAC5B,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA;AAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/adaptor-redis/redis-event-bus.adaptor.ts"],"mappings":";;;;;cASa,oBAAA,YAAgC,eAAA,EAAiB,SAAA;EAAA,iBAC3C,GAAA;EAAA,iBACA,GAAA;EAAA,iBACA,YAAA;EAAA,iBACA,aAAA;EAAA,iBAIA,WAAA;cAEL,KAAA,GAAK,YAAA,EAAyB,SAAA,GAAS,gBAAA;EAa7C,OAAA,CAAA,GAAW,OAAA;EAgBX,QAAA,CAAA,GAAY,OAAA;EAIZ,IAAA,0BAA8B,cAAA,CAAA,CAClC,KAAA,EAAO,CAAA,EACP,IAAA,EAAM,cAAA,CAAe,CAAA,IACpB,OAAA;EADK;;;;;EAUF,EAAA,0BAA4B,cAAA,CAAA,CAChC,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA,aAC9B,OAAA;EAD8B;EAmD3B,IAAA,0BAA8B,cAAA,CAAA,CAClC,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA,aAC9B,OAAA;AAAA"}

package/dist/adaptor-redis/index.d.ts

@@ -1,4 +1,4 @@
-import { n as EventBusSchema, t as EventBusAdaptor } from "../eventbus.types-Cn8xuI2B.js";
+import { n as EventBusSchema, t as EventBusAdaptor } from "../eventbus.types-DvL3Ux3o.js";
 import { Lifecycle, LifecycleManager } from "@zeltjs/core";
 import { RedisService } from "@zeltjs/redis";
 
@@ -8,12 +8,19 @@ declare class RedisEventBusAdaptor implements EventBusAdaptor, Lifecycle {
   private readonly sub;
   private readonly localEmitter;
   private readonly subscriptions;
+  private readonly subscribing;
   constructor(redis?: RedisService, lifecycle?: LifecycleManager);
   startup(): Promise<void>;
   shutdown(): Promise<void>;
   emit<K extends string & keyof EventBusSchema>(event: K, data: EventBusSchema[K]): Promise<void>;
-  on<K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): () => void;
-  once<K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): () => void;
+  /**
+   * @throws {Error} When the channel's SUBSCRIBE command to Redis fails,
+   * whether this call sent it or joined another in-flight on() for the same
+   * channel; the handler is not registered in that case.
+   */
+  on<K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): Promise<() => void>;
+  /** @throws {Error} Same as on(), which this delegates to. */
+  once<K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): Promise<() => void>;
 }
 //#endregion
 export { RedisEventBusAdaptor };

package/dist/adaptor-redis/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/adaptor-redis/redis-event-bus.adaptor.ts"],"mappings":";;;;;cASa,oBAAA,YAAgC,eAAA,EAAiB,SAAA;EAAA,iBAC3C,GAAA;EAAA,iBACA,GAAA;EAAA,iBACA,YAAA;EAAA,iBACA,aAAA;cAEL,KAAA,GAAK,YAAA,EAAyB,SAAA,GAAS,gBAAA;EAY7C,OAAA,CAAA,GAAW,OAAA;EAEX,QAAA,CAAA,GAAY,OAAA;EAIZ,IAAA,0BAA8B,cAAA,CAAA,CAClC,KAAA,EAAO,CAAA,EACP,IAAA,EAAM,cAAA,CAAe,CAAA,IACpB,OAAA;EAIH,EAAA,0BAA4B,cAAA,CAAA,CAC1B,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA;EAajC,IAAA,0BAA8B,cAAA,CAAA,CAC5B,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA;AAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/adaptor-redis/redis-event-bus.adaptor.ts"],"mappings":";;;;;cASa,oBAAA,YAAgC,eAAA,EAAiB,SAAA;EAAA,iBAC3C,GAAA;EAAA,iBACA,GAAA;EAAA,iBACA,YAAA;EAAA,iBACA,aAAA;EAAA,iBAIA,WAAA;cAEL,KAAA,GAAK,YAAA,EAAyB,SAAA,GAAS,gBAAA;EAa7C,OAAA,CAAA,GAAW,OAAA;EAgBX,QAAA,CAAA,GAAY,OAAA;EAIZ,IAAA,0BAA8B,cAAA,CAAA,CAClC,KAAA,EAAO,CAAA,EACP,IAAA,EAAM,cAAA,CAAe,CAAA,IACpB,OAAA;EADK;;;;;EAUF,EAAA,0BAA4B,cAAA,CAAA,CAChC,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA,aAC9B,OAAA;EAD8B;EAmD3B,IAAA,0BAA8B,cAAA,CAAA,CAClC,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA,aAC9B,OAAA;AAAA"}

package/dist/adaptor-redis/index.js

@@ -12,42 +12,68 @@ function _ts_metadata(k, v) {
 	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
 var RedisEventBusAdaptor = class {
-	async startup() {}
+	async startup() {
+		try {
+			await this.sub.connect();
+			if (this.subscriptions.size > 0) await this.sub.subscribe(...this.subscriptions);
+		} catch (error) {
+			this.sub.disconnect();
+			throw error;
+		}
+	}
 	async shutdown() {
 		this.sub.disconnect();
 	}
 	async emit(event, data) {
 		await this.pub.publish(event, JSON.stringify(data));
 	}
-	on(event, handler) {
-		if (!this.subscriptions.has(event)) {
-			this.subscriptions.add(event);
-			this.sub.subscribe(event);
-		}
+	/**
+	* @throws {Error} When the channel's SUBSCRIBE command to Redis fails,
+	* whether this call sent it or joined another in-flight on() for the same
+	* channel; the handler is not registered in that case.
+	*/ async on(event, handler) {
 		this.localEmitter.on(event, handler);
+		if (!(this.sub.status !== "wait" && this.sub.status !== "end")) this.subscriptions.add(event);
+		else if (!this.subscriptions.has(event)) {
+			let subscribing = this.subscribing.get(event);
+			if (!subscribing) {
+				subscribing = this.sub.subscribe(event).then(() => {
+					this.subscriptions.add(event);
+				}).finally(() => {
+					this.subscribing.delete(event);
+				});
+				this.subscribing.set(event, subscribing);
+			}
+			try {
+				await subscribing;
+			} catch (error) {
+				this.localEmitter.off(event, handler);
+				throw error;
+			}
+		}
 		return () => {
 			this.localEmitter.off(event, handler);
 		};
 	}
-	once(event, handler) {
+	/** @throws {Error} Same as on(), which this delegates to. */ async once(event, handler) {
 		const wrappedHandler = (data) => {
-			unsubscribe();
+			this.localEmitter.off(event, wrappedHandler);
 			handler(data);
 		};
-		const unsubscribe = this.on(event, wrappedHandler);
-		return unsubscribe;
+		return this.on(event, wrappedHandler);
 	}
 	constructor(redis = inject(RedisService), lifecycle = inject(LifecycleManager)) {
 		this.localEmitter = mitt_default();
 		this.subscriptions = /* @__PURE__ */ new Set();
+		this.subscribing = /* @__PURE__ */ new Map();
 		this.pub = redis.client;
-		this.sub = redis.client.duplicate();
-		lifecycle.register(this);
+		this.sub = this.pub.duplicate();
 		this.sub.on("message", (channel, message) => {
 			if (!this.subscriptions.has(channel)) return;
 			const data = JSON.parse(message);
 			this.localEmitter.emit(channel, data);
 		});
+		lifecycle.register(this);
 	}
 };
 RedisEventBusAdaptor = _ts_decorate([

package/dist/adaptor-redis/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["Injectable","inject","LifecycleManager","RedisService","mitt","RedisEventBusAdaptor","startup","shutdown","sub","disconnect","emit","event","data","pub","publish","JSON","stringify","on","handler","subscriptions","has","add","subscribe","localEmitter","off","once","wrappedHandler","unsubscribe","redis","lifecycle","Set","client","duplicate","register","channel","message","parse"],"sources":["../../src/adaptor-redis/redis-event-bus.adaptor.ts"],"sourcesContent":["import type { Lifecycle } from '@zeltjs/core';\nimport { Injectable, inject, LifecycleManager } from '@zeltjs/core';\nimport { RedisService } from '@zeltjs/redis';\nimport type Redis from 'ioredis';\nimport mitt from 'mitt';\n\nimport type { EventBusAdaptor, EventBusSchema } from '../eventbus.types';\n\n@Injectable()\nexport class RedisEventBusAdaptor implements EventBusAdaptor, Lifecycle {\n  private readonly pub: Redis;\n  private readonly sub: Redis;\n  private readonly localEmitter = mitt<EventBusSchema>();\n  private readonly subscriptions = new Set<string>();\n\n  constructor(redis = inject(RedisService), lifecycle = inject(LifecycleManager)) {\n    this.pub = redis.client;\n    this.sub = redis.client.duplicate();\n    lifecycle.register(this);\n\n    this.sub.on('message', (channel: string, message: string) => {\n      if (!this.subscriptions.has(channel)) return;\n      const data: unknown = JSON.parse(message);\n      this.localEmitter.emit(channel, data);\n    });\n  }\n\n  async startup(): Promise<void> {}\n\n  async shutdown(): Promise<void> {\n    this.sub.disconnect();\n  }\n\n  async emit<K extends string & keyof EventBusSchema>(\n    event: K,\n    data: EventBusSchema[K],\n  ): Promise<void> {\n    await this.pub.publish(event, JSON.stringify(data));\n  }\n\n  on<K extends string & keyof EventBusSchema>(\n    event: K,\n    handler: (data: EventBusSchema[K]) => void,\n  ): () => void {\n    if (!this.subscriptions.has(event)) {\n      this.subscriptions.add(event);\n      void this.sub.subscribe(event);\n    }\n    this.localEmitter.on(event, handler);\n\n    return () => {\n      this.localEmitter.off(event, handler);\n    };\n  }\n\n  once<K extends string & keyof EventBusSchema>(\n    event: K,\n    handler: (data: EventBusSchema[K]) => void,\n  ): () => void {\n    const wrappedHandler = (data: EventBusSchema[K]) => {\n      unsubscribe();\n      handler(data);\n    };\n    const unsubscribe = this.on(event, wrappedHandler);\n    return unsubscribe;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AASA,IAAaK,uBAAb,MAAaA;CAkBX,MAAMC,UAAyB;CAE/B,MAAMC,WAA0B;AAC9B,OAAKC,IAAIC,YAAU;;CAGrB,MAAMC,KACJC,OACAC,MACe;AACf,QAAM,KAAKC,IAAIC,QAAQH,OAAOI,KAAKC,UAAUJ,KAAAA,CAAAA;;CAG/CK,GACEN,OACAO,SACY;AACZ,MAAI,CAAC,KAAKC,cAAcC,IAAIT,MAAAA,EAAQ;AAClC,QAAKQ,cAAcE,IAAIV,MAAAA;AAClB,QAAKH,IAAIc,UAAUX,MAAAA;;AAE1B,OAAKY,aAAaN,GAAGN,OAAOO,QAAAA;AAE5B,eAAO;AACL,QAAKK,aAAaC,IAAIb,OAAOO,QAAAA;;;CAIjCO,KACEd,OACAO,SACY;EACZ,MAAMQ,kBAAkBd,SAAAA;AACtBe,gBAAAA;AACAT,WAAQN,KAAAA;;EAEV,MAAMe,cAAc,KAAKV,GAAGN,OAAOe,eAAAA;AACnC,SAAOC;;CAjDT,YAAYC,QAAQ3B,OAAOE,aAAa,EAAE0B,YAAY5B,OAAOC,iBAAiB,EAAE;OAH/DqB,eAAenB,cAAAA;OACfe,gCAAgB,IAAIW,KAAAA;AAGnC,OAAKjB,MAAMe,MAAMG;AACjB,OAAKvB,MAAMoB,MAAMG,OAAOC,WAAS;AACjCH,YAAUI,SAAS,KAAI;AAEvB,OAAKzB,IAAIS,GAAG,YAAYiB,SAAiBC,YAAAA;AACvC,OAAI,CAAC,KAAKhB,cAAcC,IAAIc,QAAAA,CAAU;GACtC,MAAMtB,OAAgBG,KAAKqB,MAAMD,QAAAA;AACjC,QAAKZ,aAAab,KAAKwB,SAAStB,KAAAA;IAClC"}
+{"version":3,"file":"index.js","names":["Injectable","inject","LifecycleManager","RedisService","mitt","RedisEventBusAdaptor","startup","sub","connect","subscriptions","size","subscribe","error","disconnect","shutdown","emit","event","data","pub","publish","JSON","stringify","on","handler","localEmitter","connectionInitiated","status","add","has","subscribing","get","then","finally","delete","set","off","once","wrappedHandler","redis","lifecycle","Set","Map","client","duplicate","channel","message","parse","register"],"sources":["../../src/adaptor-redis/redis-event-bus.adaptor.ts"],"sourcesContent":["import type { Lifecycle } from '@zeltjs/core';\nimport { Injectable, inject, LifecycleManager } from '@zeltjs/core';\nimport { RedisService } from '@zeltjs/redis';\nimport type Redis from 'ioredis';\nimport mitt from 'mitt';\n\nimport type { EventBusAdaptor, EventBusSchema } from '../eventbus.types';\n\n@Injectable()\nexport class RedisEventBusAdaptor implements EventBusAdaptor, Lifecycle {\n  private readonly pub: Redis;\n  private readonly sub: Redis;\n  private readonly localEmitter = mitt<EventBusSchema>();\n  private readonly subscriptions = new Set<string>();\n  // Lets concurrent on() calls for the same not-yet-established channel share\n  // one in-flight SUBSCRIBE, so the second caller's await reflects whether\n  // that SUBSCRIBE actually succeeded instead of resolving early.\n  private readonly subscribing = new Map<string, Promise<void>>();\n\n  constructor(redis = inject(RedisService), lifecycle = inject(LifecycleManager)) {\n    // redis.client is lazyConnect (no I/O yet); duplicate() copies that option,\n    // so building the sub client and attaching the listener here is also I/O-free.\n    this.pub = redis.client;\n    this.sub = this.pub.duplicate();\n    this.sub.on('message', (channel: string, message: string) => {\n      if (!this.subscriptions.has(channel)) return;\n      const data: unknown = JSON.parse(message);\n      this.localEmitter.emit(channel, data);\n    });\n    lifecycle.register(this);\n  }\n\n  async startup(): Promise<void> {\n    try {\n      await this.sub.connect();\n      if (this.subscriptions.size > 0) {\n        await this.sub.subscribe(...this.subscriptions);\n      }\n    } catch (error) {\n      // ioredis keeps rescheduling reconnects via retryStrategy after a\n      // rejected connect(), and LifecycleManager never calls shutdown() for\n      // a lifecycle whose own startup() threw, so this is the only place\n      // left to stop the socket/reconnect timer before rethrowing.\n      this.sub.disconnect();\n      throw error;\n    }\n  }\n\n  async shutdown(): Promise<void> {\n    this.sub.disconnect();\n  }\n\n  async emit<K extends string & keyof EventBusSchema>(\n    event: K,\n    data: EventBusSchema[K],\n  ): Promise<void> {\n    await this.pub.publish(event, JSON.stringify(data));\n  }\n\n  /**\n   * @throws {Error} When the channel's SUBSCRIBE command to Redis fails,\n   * whether this call sent it or joined another in-flight on() for the same\n   * channel; the handler is not registered in that case.\n   */\n  async on<K extends string & keyof EventBusSchema>(\n    event: K,\n    handler: (data: EventBusSchema[K]) => void,\n  ): Promise<() => void> {\n    // Registered before any await, so a message that arrives while this call\n    // is still waiting on SUBSCRIBE (below) or on startup()'s bulk subscribe\n    // is not missed.\n    this.localEmitter.on(event, handler);\n\n    // Before startup() the lazy client sits in 'wait'; sending SUBSCRIBE then\n    // would auto-connect and make startup()'s connect() reject as \"already\n    // connecting\". startup() bulk-subscribes everything registered until then,\n    // so resolve immediately here without waiting on that bulk subscribe.\n    // Once startup() has initiated the connection ioredis queues commands\n    // across reconnects, so subscribing here is safe. 'end' means shutdown().\n    const connectionInitiated = this.sub.status !== 'wait' && this.sub.status !== 'end';\n    if (!connectionInitiated) {\n      this.subscriptions.add(event);\n    } else if (!this.subscriptions.has(event)) {\n      // Share one in-flight SUBSCRIBE across concurrent on() calls for the\n      // same channel, so a second call's await reflects the same outcome as\n      // the first instead of resolving before the channel is established.\n      let subscribing = this.subscribing.get(event);\n      if (!subscribing) {\n        subscribing = this.sub\n          .subscribe(event)\n          .then(() => {\n            this.subscriptions.add(event);\n          })\n          .finally(() => {\n            this.subscribing.delete(event);\n          });\n        this.subscribing.set(event, subscribing);\n      }\n\n      try {\n        await subscribing;\n      } catch (error) {\n        // Subscribing failed, so leave no trace of this call: a caller that\n        // sees on() reject must be free to retry without a leaked handler.\n        // `subscriptions` never gained this channel (add() only runs on\n        // success above), so there is nothing to delete there.\n        this.localEmitter.off(event, handler);\n        throw error;\n      }\n    }\n\n    return () => {\n      this.localEmitter.off(event, handler);\n    };\n  }\n\n  /** @throws {Error} Same as on(), which this delegates to. */\n  async once<K extends string & keyof EventBusSchema>(\n    event: K,\n    handler: (data: EventBusSchema[K]) => void,\n  ): Promise<() => void> {\n    // Unsubscribes itself directly instead of going through on()'s returned\n    // function, since that function only resolves after this handler is\n    // already registered.\n    const wrappedHandler = (data: EventBusSchema[K]) => {\n      this.localEmitter.off(event, wrappedHandler);\n      handler(data);\n    };\n    return this.on(event, wrappedHandler);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AASA,IAAaK,uBAAb,MAAaA;CAuBX,MAAMC,UAAyB;AAC7B,MAAI;AACF,SAAM,KAAKC,IAAIC,SAAO;AACtB,OAAI,KAAKC,cAAcC,OAAO,EAC5B,OAAM,KAAKH,IAAII,UAAS,GAAI,KAAKF,cAAa;WAEzCG,OAAO;AAKd,QAAKL,IAAIM,YAAU;AACnB,SAAMD;;;CAIV,MAAME,WAA0B;AAC9B,OAAKP,IAAIM,YAAU;;CAGrB,MAAME,KACJC,OACAC,MACe;AACf,QAAM,KAAKC,IAAIC,QAAQH,OAAOI,KAAKC,UAAUJ,KAAAA,CAAAA;;;;;;IAQ/C,MAAMK,GACJN,OACAO,SACqB;AAIrB,OAAKC,aAAaF,GAAGN,OAAOO,QAAAA;AAS5B,MAAI,EADwB,KAAKhB,IAAImB,WAAW,UAAU,KAAKnB,IAAImB,WAAW,OAE5E,MAAKjB,cAAckB,IAAIX,MAAAA;WACd,CAAC,KAAKP,cAAcmB,IAAIZ,MAAAA,EAAQ;GAIzC,IAAIa,cAAc,KAAKA,YAAYC,IAAId,MAAAA;AACvC,OAAI,CAACa,aAAa;AAChBA,kBAAc,KAAKtB,IAChBI,UAAUK,MAAAA,CACVe,WAAK;AACJ,UAAKtB,cAAckB,IAAIX,MAAAA;MACzB,CACCgB,cAAQ;AACP,UAAKH,YAAYI,OAAOjB,MAAAA;MAC1B;AACF,SAAKa,YAAYK,IAAIlB,OAAOa,YAAAA;;AAG9B,OAAI;AACF,UAAMA;YACCjB,OAAO;AAKd,SAAKY,aAAaW,IAAInB,OAAOO,QAAAA;AAC7B,UAAMX;;;AAIV,eAAO;AACL,QAAKY,aAAaW,IAAInB,OAAOO,QAAAA;;;+DAKjC,MAAMa,KACJpB,OACAO,SACqB;EAIrB,MAAMc,kBAAkBpB,SAAAA;AACtB,QAAKO,aAAaW,IAAInB,OAAOqB,eAAAA;AAC7Bd,WAAQN,KAAAA;;AAEV,SAAO,KAAKK,GAAGN,OAAOqB,eAAAA;;CA7GxB,YAAYC,QAAQrC,OAAOE,aAAa,EAAEoC,YAAYtC,OAAOC,iBAAiB,EAAE;OAP/DsB,eAAepB,cAAAA;OACfK,gCAAgB,IAAI+B,KAAAA;OAIpBX,8BAAc,IAAIY,KAAAA;AAKjC,OAAKvB,MAAMoB,MAAMI;AACjB,OAAKnC,MAAM,KAAKW,IAAIyB,WAAS;AAC7B,OAAKpC,IAAIe,GAAG,YAAYsB,SAAiBC,YAAAA;AACvC,OAAI,CAAC,KAAKpC,cAAcmB,IAAIgB,QAAAA,CAAU;GACtC,MAAM3B,OAAgBG,KAAK0B,MAAMD,QAAAA;AACjC,QAAKrB,aAAaT,KAAK6B,SAAS3B,KAAAA;IAClC;AACAsB,YAAUQ,SAAS,KAAI"}

package/dist/{eventbus.types-Cn8xuI2B.d.ts → eventbus.types-Dk9jl4Xp.d.cts}

@@ -2,9 +2,9 @@
 interface EventBusSchema extends Record<string, unknown> {}
 interface EventBusAdaptor {
   emit<K extends string & keyof EventBusSchema>(event: K, data: EventBusSchema[K]): Promise<void>;
-  on<K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): () => void;
-  once<K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): () => void;
+  on<K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): Promise<() => void>;
+  once<K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): Promise<() => void>;
 }
 //#endregion
 export { EventBusSchema as n, EventBusAdaptor as t };
-//# sourceMappingURL=eventbus.types-Cn8xuI2B.d.ts.map
+//# sourceMappingURL=eventbus.types-Dk9jl4Xp.d.cts.map

package/dist/eventbus.types-Dk9jl4Xp.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventbus.types-Dk9jl4Xp.d.cts","names":[],"sources":["../src/eventbus.types.ts"],"mappings":";UACiB,cAAA,SAAuB,MAAA;AAAA,UAEvB,eAAA;EACf,IAAA,0BAA8B,cAAA,EAAgB,KAAA,EAAO,CAAA,EAAG,IAAA,EAAM,cAAA,CAAe,CAAA,IAAK,OAAA;EAClF,EAAA,0BAA4B,cAAA,EAC1B,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA,aAC9B,OAAA;EACH,IAAA,0BAA8B,cAAA,EAC5B,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA,aAC9B,OAAA;AAAA"}

package/dist/{eventbus.types-kl1yXTK8.d.cts → eventbus.types-DvL3Ux3o.d.ts}

@@ -2,9 +2,9 @@
 interface EventBusSchema extends Record<string, unknown> {}
 interface EventBusAdaptor {
   emit<K extends string & keyof EventBusSchema>(event: K, data: EventBusSchema[K]): Promise<void>;
-  on<K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): () => void;
-  once<K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): () => void;
+  on<K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): Promise<() => void>;
+  once<K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): Promise<() => void>;
 }
 //#endregion
 export { EventBusSchema as n, EventBusAdaptor as t };
-//# sourceMappingURL=eventbus.types-kl1yXTK8.d.cts.map
+//# sourceMappingURL=eventbus.types-DvL3Ux3o.d.ts.map

package/dist/eventbus.types-DvL3Ux3o.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventbus.types-DvL3Ux3o.d.ts","names":[],"sources":["../src/eventbus.types.ts"],"mappings":";UACiB,cAAA,SAAuB,MAAA;AAAA,UAEvB,eAAA;EACf,IAAA,0BAA8B,cAAA,EAAgB,KAAA,EAAO,CAAA,EAAG,IAAA,EAAM,cAAA,CAAe,CAAA,IAAK,OAAA;EAClF,EAAA,0BAA4B,cAAA,EAC1B,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA,aAC9B,OAAA;EACH,IAAA,0BAA8B,cAAA,EAC5B,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA,aAC9B,OAAA;AAAA"}

package/dist/{index-Buq5DkB1.d.ts → index-C2cRFzub.d.cts}

@@ -1,12 +1,12 @@
-import { n as EventBusSchema, t as EventBusAdaptor } from "./eventbus.types-Cn8xuI2B.js";
+import { n as EventBusSchema, t as EventBusAdaptor } from "./eventbus.types-Dk9jl4Xp.cjs";
 
 //#region src/adaptor-memory/memory-event-bus.adaptor.d.ts
 declare class MemoryEventBusAdaptor implements EventBusAdaptor {
   private readonly emitter;
   emit<K extends string & keyof EventBusSchema>(event: K, data: EventBusSchema[K]): Promise<void>;
-  on<K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): () => void;
-  once<K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): () => void;
+  on<K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): Promise<() => void>;
+  once<K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): Promise<() => void>;
 }
 //#endregion
 export { MemoryEventBusAdaptor as t };
-//# sourceMappingURL=index-Buq5DkB1.d.ts.map
+//# sourceMappingURL=index-C2cRFzub.d.cts.map

package/dist/index-C2cRFzub.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-C2cRFzub.d.cts","names":[],"sources":["../src/adaptor-memory/memory-event-bus.adaptor.ts"],"mappings":";;;cAMa,qBAAA,YAAiC,eAAA;EAAA,iBAC3B,OAAA;EAEX,IAAA,0BAA8B,cAAA,CAAA,CAClC,KAAA,EAAO,CAAA,EACP,IAAA,EAAM,cAAA,CAAe,CAAA,IACpB,OAAA;EAIG,EAAA,0BAA4B,cAAA,CAAA,CAChC,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA,aAC9B,OAAA;EAKG,IAAA,0BAA8B,cAAA,CAAA,CAClC,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA,aAC9B,OAAA;AAAA"}

package/dist/{index-qecFavvB.d.cts → index-CcpSMqqG.d.ts}

@@ -1,12 +1,12 @@
-import { n as EventBusSchema, t as EventBusAdaptor } from "./eventbus.types-kl1yXTK8.cjs";
+import { n as EventBusSchema, t as EventBusAdaptor } from "./eventbus.types-DvL3Ux3o.js";
 
 //#region src/adaptor-memory/memory-event-bus.adaptor.d.ts
 declare class MemoryEventBusAdaptor implements EventBusAdaptor {
   private readonly emitter;
   emit<K extends string & keyof EventBusSchema>(event: K, data: EventBusSchema[K]): Promise<void>;
-  on<K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): () => void;
-  once<K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): () => void;
+  on<K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): Promise<() => void>;
+  once<K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): Promise<() => void>;
 }
 //#endregion
 export { MemoryEventBusAdaptor as t };
-//# sourceMappingURL=index-qecFavvB.d.cts.map
+//# sourceMappingURL=index-CcpSMqqG.d.ts.map

package/dist/index-CcpSMqqG.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-CcpSMqqG.d.ts","names":[],"sources":["../src/adaptor-memory/memory-event-bus.adaptor.ts"],"mappings":";;;cAMa,qBAAA,YAAiC,eAAA;EAAA,iBAC3B,OAAA;EAEX,IAAA,0BAA8B,cAAA,CAAA,CAClC,KAAA,EAAO,CAAA,EACP,IAAA,EAAM,cAAA,CAAe,CAAA,IACpB,OAAA;EAIG,EAAA,0BAA4B,cAAA,CAAA,CAChC,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA,aAC9B,OAAA;EAKG,IAAA,0BAA8B,cAAA,CAAA,CAClC,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA,aAC9B,OAAA;AAAA"}

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_adaptor_memory = require("./adaptor-memory-Obg3l9mF.cjs");
+const require_adaptor_memory = require("./adaptor-memory-zYqB6KAT.cjs");
 //#region src/eventbus.feature.ts
 const eventbus = (opts) => ({
 	key: "eventbus",

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { n as EventBusSchema, t as EventBusAdaptor } from "./eventbus.types-kl1yXTK8.cjs";
-import { t as MemoryEventBusAdaptor } from "./index-qecFavvB.cjs";
+import { n as EventBusSchema, t as EventBusAdaptor } from "./eventbus.types-Dk9jl4Xp.cjs";
+import { t as MemoryEventBusAdaptor } from "./index-C2cRFzub.cjs";
 import { ConfiguredFeature } from "@zeltjs/core";
 
 //#region src/eventbus.feature.d.ts
@@ -10,8 +10,8 @@ type EventBusOptions = {
 };
 type EventBusCapabilities = {
   readonly emit: <K extends string & keyof EventBusSchema>(event: K, data: EventBusSchema[K]) => Promise<void>;
-  readonly on: <K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void) => () => void;
-  readonly once: <K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void) => () => void;
+  readonly on: <K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void) => Promise<() => void>;
+  readonly once: <K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void) => Promise<() => void>;
 };
 declare const eventbus: (opts: EventBusOptions) => ConfiguredFeature<"eventbus", EventBusCapabilities>;
 //#endregion

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/eventbus.feature.ts"],"mappings":";;;;;KAIK,oBAAA,WAA+B,IAAA;AAAA,KAE/B,eAAA;EAAA,SACM,OAAA,UAAiB,IAAA,cAAkB,eAAA;EAAA,SACnC,QAAA,YAAoB,oBAAA;AAAA;AAAA,KAGnB,oBAAA;EAAA,SACD,IAAA,4BAAgC,cAAA,EACvC,KAAA,EAAO,CAAA,EACP,IAAA,EAAM,cAAA,CAAe,CAAA,MAClB,OAAA;EAAA,SACI,EAAA,4BAA8B,cAAA,EACrC,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA;EAAA,SAExB,IAAA,4BAAgC,cAAA,EACvC,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA;AAAA;AAAA,cAItB,QAAA,GACX,IAAA,EAAM,eAAA,KACL,iBAAA,aAA8B,oBAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/eventbus.feature.ts"],"mappings":";;;;;KAIK,oBAAA,WAA+B,IAAA;AAAA,KAE/B,eAAA;EAAA,SACM,OAAA,UAAiB,IAAA,cAAkB,eAAA;EAAA,SACnC,QAAA,YAAoB,oBAAA;AAAA;AAAA,KAGnB,oBAAA;EAAA,SACD,IAAA,4BAAgC,cAAA,EACvC,KAAA,EAAO,CAAA,EACP,IAAA,EAAM,cAAA,CAAe,CAAA,MAClB,OAAA;EAAA,SACI,EAAA,4BAA8B,cAAA,EACrC,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA,eAC5B,OAAA;EAAA,SACI,IAAA,4BAAgC,cAAA,EACvC,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA,eAC5B,OAAA;AAAA;AAAA,cAGM,QAAA,GACX,IAAA,EAAM,eAAA,KACL,iBAAA,aAA8B,oBAAA"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { n as EventBusSchema, t as EventBusAdaptor } from "./eventbus.types-Cn8xuI2B.js";
-import { t as MemoryEventBusAdaptor } from "./index-Buq5DkB1.js";
+import { n as EventBusSchema, t as EventBusAdaptor } from "./eventbus.types-DvL3Ux3o.js";
+import { t as MemoryEventBusAdaptor } from "./index-CcpSMqqG.js";
 import { ConfiguredFeature } from "@zeltjs/core";
 
 //#region src/eventbus.feature.d.ts
@@ -10,8 +10,8 @@ type EventBusOptions = {
 };
 type EventBusCapabilities = {
   readonly emit: <K extends string & keyof EventBusSchema>(event: K, data: EventBusSchema[K]) => Promise<void>;
-  readonly on: <K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void) => () => void;
-  readonly once: <K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void) => () => void;
+  readonly on: <K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void) => Promise<() => void>;
+  readonly once: <K extends string & keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void) => Promise<() => void>;
 };
 declare const eventbus: (opts: EventBusOptions) => ConfiguredFeature<"eventbus", EventBusCapabilities>;
 //#endregion

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/eventbus.feature.ts"],"mappings":";;;;;KAIK,oBAAA,WAA+B,IAAA;AAAA,KAE/B,eAAA;EAAA,SACM,OAAA,UAAiB,IAAA,cAAkB,eAAA;EAAA,SACnC,QAAA,YAAoB,oBAAA;AAAA;AAAA,KAGnB,oBAAA;EAAA,SACD,IAAA,4BAAgC,cAAA,EACvC,KAAA,EAAO,CAAA,EACP,IAAA,EAAM,cAAA,CAAe,CAAA,MAClB,OAAA;EAAA,SACI,EAAA,4BAA8B,cAAA,EACrC,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA;EAAA,SAExB,IAAA,4BAAgC,cAAA,EACvC,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA;AAAA;AAAA,cAItB,QAAA,GACX,IAAA,EAAM,eAAA,KACL,iBAAA,aAA8B,oBAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/eventbus.feature.ts"],"mappings":";;;;;KAIK,oBAAA,WAA+B,IAAA;AAAA,KAE/B,eAAA;EAAA,SACM,OAAA,UAAiB,IAAA,cAAkB,eAAA;EAAA,SACnC,QAAA,YAAoB,oBAAA;AAAA;AAAA,KAGnB,oBAAA;EAAA,SACD,IAAA,4BAAgC,cAAA,EACvC,KAAA,EAAO,CAAA,EACP,IAAA,EAAM,cAAA,CAAe,CAAA,MAClB,OAAA;EAAA,SACI,EAAA,4BAA8B,cAAA,EACrC,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA,eAC5B,OAAA;EAAA,SACI,IAAA,4BAAgC,cAAA,EACvC,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA,eAC5B,OAAA;AAAA;AAAA,cAGM,QAAA,GACX,IAAA,EAAM,eAAA,KACL,iBAAA,aAA8B,oBAAA"}

package/dist/index.js

@@ -1,4 +1,4 @@
-import { t as MemoryEventBusAdaptor } from "./adaptor-memory-BG1Xyr7_.js";
+import { t as MemoryEventBusAdaptor } from "./adaptor-memory-WYgtTbUx.js";
 //#region src/eventbus.feature.ts
 const eventbus = (opts) => ({
 	key: "eventbus",

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["eventbus","opts","key","featureClasses","adaptor","handlers","blueprint","realize","resolver","handler","get","emit","event","data","on","once"],"sources":["../src/eventbus.feature.ts"],"sourcesContent":["import type { ConfiguredFeature } from '@zeltjs/core';\n\nimport type { EventBusAdaptor, EventBusSchema } from './eventbus.types';\n\ntype EventBusHandlerClass = new (...args: never[]) => object;\n\ntype EventBusOptions = {\n  readonly adaptor: new (...args: never[]) => EventBusAdaptor;\n  readonly handlers?: readonly EventBusHandlerClass[];\n};\n\nexport type EventBusCapabilities = {\n  readonly emit: <K extends string & keyof EventBusSchema>(\n    event: K,\n    data: EventBusSchema[K],\n  ) => Promise<void>;\n  readonly on: <K extends string & keyof EventBusSchema>(\n    event: K,\n    handler: (data: EventBusSchema[K]) => void,\n  ) => () => void;\n  readonly once: <K extends string & keyof EventBusSchema>(\n    event: K,\n    handler: (data: EventBusSchema[K]) => void,\n  ) => () => void;\n};\n\nexport const eventbus = (\n  opts: EventBusOptions,\n): ConfiguredFeature<'eventbus', EventBusCapabilities> => ({\n  key: 'eventbus',\n  featureClasses: () => [opts.adaptor, ...(opts.handlers ?? [])],\n  blueprint: () => ({}),\n  realize: async (resolver) => {\n    for (const handler of opts.handlers ?? []) {\n      await resolver.get(handler);\n    }\n\n    const adaptor = await resolver.get(opts.adaptor);\n    return {\n      emit: (event, data) => adaptor.emit(event, data),\n      on: (event, handler) => adaptor.on(event, handler),\n      once: (event, handler) => adaptor.once(event, handler),\n    };\n  },\n});\n"],"mappings":";;AA0BA,MAAaA,YACXC,UACyD;CACzDC,KAAK;CACLC,sBAAsB,CAACF,KAAKG,SAAAA,GAAaH,KAAKI,YAAY,EAAE,CAAE;CAC9DC,kBAAkB,EAAC;CACnBC,SAAS,OAAOC,aAAAA;AACd,OAAK,MAAMC,WAAWR,KAAKI,YAAY,EAAE,CACvC,OAAMG,SAASE,IAAID,QAAAA;EAGrB,MAAML,UAAU,MAAMI,SAASE,IAAIT,KAAKG,QAAO;AAC/C,SAAO;GACLO,OAAOC,OAAOC,SAAST,QAAQO,KAAKC,OAAOC,KAAAA;GAC3CC,KAAKF,OAAOH,YAAYL,QAAQU,GAAGF,OAAOH,QAAAA;GAC1CM,OAAOH,OAAOH,YAAYL,QAAQW,KAAKH,OAAOH,QAAAA;GAChD;;CAEJ"}
+{"version":3,"file":"index.js","names":["eventbus","opts","key","featureClasses","adaptor","handlers","blueprint","realize","resolver","handler","get","emit","event","data","on","once"],"sources":["../src/eventbus.feature.ts"],"sourcesContent":["import type { ConfiguredFeature } from '@zeltjs/core';\n\nimport type { EventBusAdaptor, EventBusSchema } from './eventbus.types';\n\ntype EventBusHandlerClass = new (...args: never[]) => object;\n\ntype EventBusOptions = {\n  readonly adaptor: new (...args: never[]) => EventBusAdaptor;\n  readonly handlers?: readonly EventBusHandlerClass[];\n};\n\nexport type EventBusCapabilities = {\n  readonly emit: <K extends string & keyof EventBusSchema>(\n    event: K,\n    data: EventBusSchema[K],\n  ) => Promise<void>;\n  readonly on: <K extends string & keyof EventBusSchema>(\n    event: K,\n    handler: (data: EventBusSchema[K]) => void,\n  ) => Promise<() => void>;\n  readonly once: <K extends string & keyof EventBusSchema>(\n    event: K,\n    handler: (data: EventBusSchema[K]) => void,\n  ) => Promise<() => void>;\n};\n\nexport const eventbus = (\n  opts: EventBusOptions,\n): ConfiguredFeature<'eventbus', EventBusCapabilities> => ({\n  key: 'eventbus',\n  featureClasses: () => [opts.adaptor, ...(opts.handlers ?? [])],\n  blueprint: () => ({}),\n  realize: async (resolver) => {\n    for (const handler of opts.handlers ?? []) {\n      await resolver.get(handler);\n    }\n\n    const adaptor = await resolver.get(opts.adaptor);\n    return {\n      emit: (event, data) => adaptor.emit(event, data),\n      on: (event, handler) => adaptor.on(event, handler),\n      once: (event, handler) => adaptor.once(event, handler),\n    };\n  },\n});\n"],"mappings":";;AA0BA,MAAaA,YACXC,UACyD;CACzDC,KAAK;CACLC,sBAAsB,CAACF,KAAKG,SAAAA,GAAaH,KAAKI,YAAY,EAAE,CAAE;CAC9DC,kBAAkB,EAAC;CACnBC,SAAS,OAAOC,aAAAA;AACd,OAAK,MAAMC,WAAWR,KAAKI,YAAY,EAAE,CACvC,OAAMG,SAASE,IAAID,QAAAA;EAGrB,MAAML,UAAU,MAAMI,SAASE,IAAIT,KAAKG,QAAO;AAC/C,SAAO;GACLO,OAAOC,OAAOC,SAAST,QAAQO,KAAKC,OAAOC,KAAAA;GAC3CC,KAAKF,OAAOH,YAAYL,QAAQU,GAAGF,OAAOH,QAAAA;GAC1CM,OAAOH,OAAOH,YAAYL,QAAQW,KAAKH,OAAOH,QAAAA;GAChD;;CAEJ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeltjs/eventbus",
-  "version": "0.11.0",
+  "version": "0.12.0-canary.0",
   "description": "Event bus abstraction for Zelt applications",
   "type": "module",
   "license": "MIT",
@@ -48,8 +48,8 @@
     "dist"
   ],
   "peerDependencies": {
-    "@zeltjs/core": "0.11.0",
-    "@zeltjs/redis": "0.11.0"
+    "@zeltjs/core": "0.12.0-canary.0",
+    "@zeltjs/redis": "0.12.0-canary.0"
   },
   "peerDependenciesMeta": {
     "@zeltjs/redis": {
@@ -60,8 +60,10 @@
     "@types/node": "22.19.17",
     "ioredis": "5.10.1",
     "mitt": "3.0.1",
-    "@zeltjs/core": "0.11.0",
-    "@zeltjs/redis": "0.11.0"
+    "testcontainers": "10.25.0",
+    "@zeltjs/core": "0.12.0-canary.0",
+    "@zeltjs/testing": "0.12.0-canary.0",
+    "@zeltjs/redis": "0.12.0-canary.0"
   },
   "volta": {
     "extends": "../../package.json"

package/dist/adaptor-memory-BG1Xyr7_.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"adaptor-memory-BG1Xyr7_.js","names":["Injectable","mitt","MemoryEventBusAdaptor","emit","event","data","emitter","on","handler","off","once","wrappedHandler","unsubscribe"],"sources":["../src/adaptor-memory/memory-event-bus.adaptor.ts"],"sourcesContent":["import { Injectable } from '@zeltjs/core';\nimport mitt from 'mitt';\n\nimport type { EventBusAdaptor, EventBusSchema } from '../eventbus.types';\n\n@Injectable()\nexport class MemoryEventBusAdaptor implements EventBusAdaptor {\n  private readonly emitter = mitt<EventBusSchema>();\n\n  async emit<K extends string & keyof EventBusSchema>(\n    event: K,\n    data: EventBusSchema[K],\n  ): Promise<void> {\n    this.emitter.emit(event, data);\n  }\n\n  on<K extends string & keyof EventBusSchema>(\n    event: K,\n    handler: (data: EventBusSchema[K]) => void,\n  ): () => void {\n    this.emitter.on(event, handler);\n    return () => this.emitter.off(event, handler);\n  }\n\n  once<K extends string & keyof EventBusSchema>(\n    event: K,\n    handler: (data: EventBusSchema[K]) => void,\n  ): () => void {\n    const wrappedHandler = (data: EventBusSchema[K]) => {\n      unsubscribe();\n      handler(data);\n    };\n    const unsubscribe = this.on(event, wrappedHandler);\n    return unsubscribe;\n  }\n}\n"],"mappings":";;;;;;;;;AAMA,IAAaE,wBAAb,MAAaA;CAGX,MAAMC,KACJC,OACAC,MACe;AACf,OAAKC,QAAQH,KAAKC,OAAOC,KAAAA;;CAG3BE,GACEH,OACAI,SACY;AACZ,OAAKF,QAAQC,GAAGH,OAAOI,QAAAA;AACvB,eAAa,KAAKF,QAAQG,IAAIL,OAAOI,QAAAA;;CAGvCE,KACEN,OACAI,SACY;EACZ,MAAMG,kBAAkBN,SAAAA;AACtBO,gBAAAA;AACAJ,WAAQH,KAAAA;;EAEV,MAAMO,cAAc,KAAKL,GAAGH,OAAOO,eAAAA;AACnC,SAAOC;;;OA1BQN,UAAUL,cAAAA"}

package/dist/eventbus.types-Cn8xuI2B.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"eventbus.types-Cn8xuI2B.d.ts","names":[],"sources":["../src/eventbus.types.ts"],"mappings":";UACiB,cAAA,SAAuB,MAAA;AAAA,UAEvB,eAAA;EACf,IAAA,0BAA8B,cAAA,EAAgB,KAAA,EAAO,CAAA,EAAG,IAAA,EAAM,cAAA,CAAe,CAAA,IAAK,OAAA;EAClF,EAAA,0BAA4B,cAAA,EAC1B,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA;EAEjC,IAAA,0BAA8B,cAAA,EAC5B,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA;AAAA"}

package/dist/eventbus.types-kl1yXTK8.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"eventbus.types-kl1yXTK8.d.cts","names":[],"sources":["../src/eventbus.types.ts"],"mappings":";UACiB,cAAA,SAAuB,MAAA;AAAA,UAEvB,eAAA;EACf,IAAA,0BAA8B,cAAA,EAAgB,KAAA,EAAO,CAAA,EAAG,IAAA,EAAM,cAAA,CAAe,CAAA,IAAK,OAAA;EAClF,EAAA,0BAA4B,cAAA,EAC1B,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA;EAEjC,IAAA,0BAA8B,cAAA,EAC5B,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA;AAAA"}

package/dist/index-Buq5DkB1.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index-Buq5DkB1.d.ts","names":[],"sources":["../src/adaptor-memory/memory-event-bus.adaptor.ts"],"mappings":";;;cAMa,qBAAA,YAAiC,eAAA;EAAA,iBAC3B,OAAA;EAEX,IAAA,0BAA8B,cAAA,CAAA,CAClC,KAAA,EAAO,CAAA,EACP,IAAA,EAAM,cAAA,CAAe,CAAA,IACpB,OAAA;EAIH,EAAA,0BAA4B,cAAA,CAAA,CAC1B,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA;EAMjC,IAAA,0BAA8B,cAAA,CAAA,CAC5B,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA;AAAA"}

package/dist/index-qecFavvB.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index-qecFavvB.d.cts","names":[],"sources":["../src/adaptor-memory/memory-event-bus.adaptor.ts"],"mappings":";;;cAMa,qBAAA,YAAiC,eAAA;EAAA,iBAC3B,OAAA;EAEX,IAAA,0BAA8B,cAAA,CAAA,CAClC,KAAA,EAAO,CAAA,EACP,IAAA,EAAM,cAAA,CAAe,CAAA,IACpB,OAAA;EAIH,EAAA,0BAA4B,cAAA,CAAA,CAC1B,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA;EAMjC,IAAA,0BAA8B,cAAA,CAAA,CAC5B,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA;AAAA"}