@zeltjs/eventbus 0.0.1 → 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 9wick / Kohei Kido
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,45 +1,33 @@
 # @zeltjs/eventbus
 
-## ⚠️ IMPORTANT NOTICE ⚠️
+[![Documentation](https://img.shields.io/badge/docs-zeltjs.com-blue)](https://zeltjs.com)
 
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
+Event bus abstraction for Zelt applications.
 
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
+**[Read the Documentation](https://zeltjs.com)**
 
-## Purpose
+## Installation
 
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@zeltjs/eventbus`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
+```bash
+npm install @zeltjs/eventbus @zeltjs/core
+```
 
-## What is OIDC Trusted Publishing?
+## Usage
 
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
+```typescript
+import { MemoryEventBusAdaptor } from '@zeltjs/eventbus';
+import type { EventBusSchema } from '@zeltjs/eventbus';
 
-## Setup Instructions
+type MyEvents = EventBusSchema<{
+  'user.created': { id: string; name: string };
+  'user.deleted': { id: string };
+}>;
 
-To properly configure OIDC trusted publishing for this package:
+const eventbus = new MemoryEventBusAdaptor<MyEvents>();
 
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
+eventbus.on('user.created', (data) => {
+  console.log('User created:', data.name);
+});
 
-## DO NOT USE THIS PACKAGE
-
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
-
-## More Information
-
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
-
----
-
-**Maintained for OIDC setup purposes only**
+eventbus.emit('user.created', { id: '1', name: 'Alice' });
+```

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

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

package/dist/adaptor-memory/index.js

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

package/dist/adaptor-memory-_pl2McN_.js

@@ -0,0 +1,23 @@
+import { EventEmitter } from "node:events";
+import { Injectable } from "@zeltjs/core";
+//#region src/adaptor-memory/memory-event-bus.adaptor.ts
+var MemoryEventBusAdaptor = @Injectable() class {
+	constructor() {
+		this.emitter = new EventEmitter();
+	}
+	async emit(event, data) {
+		this.emitter.emit(event, data);
+	}
+	on(event, handler) {
+		this.emitter.on(event, handler);
+		return () => this.emitter.off(event, handler);
+	}
+	once(event, handler) {
+		this.emitter.once(event, handler);
+		return () => this.emitter.off(event, handler);
+	}
+};
+//#endregion
+export { MemoryEventBusAdaptor as t };
+
+//# sourceMappingURL=adaptor-memory-_pl2McN_.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adaptor-memory-_pl2McN_.js","names":[],"sources":["../src/adaptor-memory/memory-event-bus.adaptor.ts"],"sourcesContent":["import { EventEmitter } from 'node:events';\nimport { Injectable } from '@zeltjs/core';\n\nimport type { EventBusAdaptor, EventBusSchema } from '../types';\n\n@Injectable()\nexport class MemoryEventBusAdaptor implements EventBusAdaptor {\n  private readonly emitter = new EventEmitter();\n\n  async emit<K extends keyof EventBusSchema>(event: K, data: EventBusSchema[K]): Promise<void> {\n    this.emitter.emit(event as string, data);\n  }\n\n  on<K extends keyof EventBusSchema>(\n    event: K,\n    handler: (data: EventBusSchema[K]) => void,\n  ): () => void {\n    this.emitter.on(event as string, handler);\n    return () => this.emitter.off(event as string, handler);\n  }\n\n  once<K extends keyof EventBusSchema>(\n    event: K,\n    handler: (data: EventBusSchema[K]) => void,\n  ): () => void {\n    this.emitter.once(event as string, handler);\n    return () => this.emitter.off(event as string, handler);\n  }\n}\n"],"mappings":";;;AAMA,IAAa,wBADb,CAAC,YAAY,CAAb,MAC8D;;iBACjC,IAAI,cAAc;;CAE7C,MAAM,KAAqC,OAAU,MAAwC;AAC3F,OAAK,QAAQ,KAAK,OAAiB,KAAK;;CAG1C,GACE,OACA,SACY;AACZ,OAAK,QAAQ,GAAG,OAAiB,QAAQ;AACzC,eAAa,KAAK,QAAQ,IAAI,OAAiB,QAAQ;;CAGzD,KACE,OACA,SACY;AACZ,OAAK,QAAQ,KAAK,OAAiB,QAAQ;AAC3C,eAAa,KAAK,QAAQ,IAAI,OAAiB,QAAQ"}

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

@@ -0,0 +1,19 @@
+import { n as EventBusSchema, t as EventBusAdaptor } from "../types-CLqE_rki.js";
+import { Lifecycle, LifecycleManager } from "@zeltjs/core";
+import { RedisService } from "@zeltjs/redis";
+
+//#region src/adaptor-redis/redis-event-bus.adaptor.d.ts
+declare class RedisEventBusAdaptor implements EventBusAdaptor, Lifecycle {
+  private readonly pub;
+  private readonly sub;
+  private readonly handlers;
+  constructor(redis?: RedisService, lifecycle?: LifecycleManager);
+  startup(): Promise<void>;
+  shutdown(): Promise<void>;
+  emit<K extends keyof EventBusSchema>(event: K, data: EventBusSchema[K]): Promise<void>;
+  on<K extends keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): () => void;
+  once<K extends keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): () => void;
+}
+//#endregion
+export { RedisEventBusAdaptor };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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,QAAA;cAEL,KAAA,GAAK,YAAA,EAAyB,SAAA,GAAS,gBAAA;EAe7C,OAAA,CAAA,GAAW,OAAA;EAEX,QAAA,CAAA,GAAY,OAAA;EAIZ,IAAA,iBAAqB,cAAA,CAAA,CAAgB,KAAA,EAAO,CAAA,EAAG,IAAA,EAAM,cAAA,CAAe,CAAA,IAAK,OAAA;EAI/E,EAAA,iBAAmB,cAAA,CAAA,CACjB,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA;EAoBjC,IAAA,iBAAqB,cAAA,CAAA,CACnB,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA;AAAA"}

package/dist/adaptor-redis/index.js

@@ -0,0 +1,53 @@
+import { LifecycleManager, inject } from "@zeltjs/core";
+import { RedisService } from "@zeltjs/redis";
+//#region src/adaptor-redis/redis-event-bus.adaptor.ts
+var RedisEventBusAdaptor = class {
+	constructor(redis = inject(RedisService), lifecycle = inject(LifecycleManager)) {
+		this.handlers = /* @__PURE__ */ new Map();
+		this.pub = redis.client;
+		this.sub = redis.client.duplicate();
+		lifecycle.register(this);
+		this.sub.on("message", (channel, message) => {
+			const eventHandlers = this.handlers.get(channel);
+			if (!eventHandlers) return;
+			const data = JSON.parse(message);
+			for (const handler of eventHandlers) handler(data);
+		});
+	}
+	async startup() {}
+	async shutdown() {
+		this.sub.disconnect();
+	}
+	async emit(event, data) {
+		await this.pub.publish(event, JSON.stringify(data));
+	}
+	on(event, handler) {
+		const channel = event;
+		let handlers = this.handlers.get(channel);
+		if (!handlers) {
+			handlers = /* @__PURE__ */ new Set();
+			this.handlers.set(channel, handlers);
+			this.sub.subscribe(channel);
+		}
+		handlers.add(handler);
+		return () => {
+			handlers.delete(handler);
+			if (handlers.size === 0) {
+				this.handlers.delete(channel);
+				this.sub.unsubscribe(channel);
+			}
+		};
+	}
+	once(event, handler) {
+		const wrappedHandler = (data) => {
+			unsubscribe();
+			handler(data);
+		};
+		const unsubscribe = this.on(event, wrappedHandler);
+		return unsubscribe;
+	}
+};
+//#endregion
+export { RedisEventBusAdaptor };
+
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/adaptor-redis/redis-event-bus.adaptor.ts"],"sourcesContent":["import type { Lifecycle } from '@zeltjs/core';\nimport { inject, LifecycleManager } from '@zeltjs/core';\nimport { RedisService } from '@zeltjs/redis';\nimport type Redis from 'ioredis';\n\nimport type { EventBusAdaptor, EventBusSchema } from '../types';\n\ntype Handler = (data: unknown) => void;\n\nexport class RedisEventBusAdaptor implements EventBusAdaptor, Lifecycle {\n  private readonly pub: Redis;\n  private readonly sub: Redis;\n  private readonly handlers = new Map<string, Set<Handler>>();\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      const eventHandlers = this.handlers.get(channel);\n      if (!eventHandlers) return;\n      const data: unknown = JSON.parse(message);\n      for (const handler of eventHandlers) {\n        handler(data);\n      }\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 keyof EventBusSchema>(event: K, data: EventBusSchema[K]): Promise<void> {\n    await this.pub.publish(event as string, JSON.stringify(data));\n  }\n\n  on<K extends keyof EventBusSchema>(\n    event: K,\n    handler: (data: EventBusSchema[K]) => void,\n  ): () => void {\n    const channel = event as string;\n    let handlers = this.handlers.get(channel);\n    if (!handlers) {\n      handlers = new Set();\n      this.handlers.set(channel, handlers);\n      void this.sub.subscribe(channel);\n    }\n    handlers.add(handler as Handler);\n\n    return () => {\n      handlers.delete(handler as Handler);\n      if (handlers.size === 0) {\n        this.handlers.delete(channel);\n        void this.sub.unsubscribe(channel);\n      }\n    };\n  }\n\n  once<K extends 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,IAAa,uBAAb,MAAwE;CAKtE,YAAY,QAAQ,OAAO,aAAa,EAAE,YAAY,OAAO,iBAAiB,EAAE;kCAFpD,IAAI,KAA2B;AAGzD,OAAK,MAAM,MAAM;AACjB,OAAK,MAAM,MAAM,OAAO,WAAW;AACnC,YAAU,SAAS,KAAK;AAExB,OAAK,IAAI,GAAG,YAAY,SAAiB,YAAoB;GAC3D,MAAM,gBAAgB,KAAK,SAAS,IAAI,QAAQ;AAChD,OAAI,CAAC,cAAe;GACpB,MAAM,OAAgB,KAAK,MAAM,QAAQ;AACzC,QAAK,MAAM,WAAW,cACpB,SAAQ,KAAK;IAEf;;CAGJ,MAAM,UAAyB;CAE/B,MAAM,WAA0B;AAC9B,OAAK,IAAI,YAAY;;CAGvB,MAAM,KAAqC,OAAU,MAAwC;AAC3F,QAAM,KAAK,IAAI,QAAQ,OAAiB,KAAK,UAAU,KAAK,CAAC;;CAG/D,GACE,OACA,SACY;EACZ,MAAM,UAAU;EAChB,IAAI,WAAW,KAAK,SAAS,IAAI,QAAQ;AACzC,MAAI,CAAC,UAAU;AACb,8BAAW,IAAI,KAAK;AACpB,QAAK,SAAS,IAAI,SAAS,SAAS;AAC/B,QAAK,IAAI,UAAU,QAAQ;;AAElC,WAAS,IAAI,QAAmB;AAEhC,eAAa;AACX,YAAS,OAAO,QAAmB;AACnC,OAAI,SAAS,SAAS,GAAG;AACvB,SAAK,SAAS,OAAO,QAAQ;AACxB,SAAK,IAAI,YAAY,QAAQ;;;;CAKxC,KACE,OACA,SACY;EACZ,MAAM,kBAAkB,SAA4B;AAClD,gBAAa;AACb,WAAQ,KAAK;;EAEf,MAAM,cAAc,KAAK,GAAG,OAAO,eAAe;AAClD,SAAO"}

package/dist/index-CmcsSQcu.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index-CmcsSQcu.d.ts","names":[],"sources":["../src/adaptor-memory/memory-event-bus.adaptor.ts"],"mappings":";;;cAMa,qBAAA,YAAiC,eAAA;EAAA,iBAC3B,OAAA;EAEX,IAAA,iBAAqB,cAAA,CAAA,CAAgB,KAAA,EAAO,CAAA,EAAG,IAAA,EAAM,cAAA,CAAe,CAAA,IAAK,OAAA;EAI/E,EAAA,iBAAmB,cAAA,CAAA,CACjB,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA;EAMjC,IAAA,iBAAqB,cAAA,CAAA,CACnB,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA;AAAA"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import { n as EventBusSchema, t as EventBusAdaptor } from "./types-CLqE_rki.js";
+import { t as MemoryEventBusAdaptor } from "./index-CmcsSQcu.js";
+export { type EventBusAdaptor, type EventBusSchema, MemoryEventBusAdaptor };

package/dist/index.js

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

package/dist/types-CLqE_rki.d.ts

@@ -0,0 +1,10 @@
+//#region src/types.d.ts
+interface EventBusSchema {}
+interface EventBusAdaptor {
+  emit<K extends keyof EventBusSchema>(event: K, data: EventBusSchema[K]): Promise<void>;
+  on<K extends keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): () => void;
+  once<K extends keyof EventBusSchema>(event: K, handler: (data: EventBusSchema[K]) => void): () => void;
+}
+//#endregion
+export { EventBusSchema as n, EventBusAdaptor as t };
+//# sourceMappingURL=types-CLqE_rki.d.ts.map

package/dist/types-CLqE_rki.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-CLqE_rki.d.ts","names":[],"sources":["../src/types.ts"],"mappings":";UACiB,cAAA;AAAA,UAEA,eAAA;EACf,IAAA,iBAAqB,cAAA,EAAgB,KAAA,EAAO,CAAA,EAAG,IAAA,EAAM,cAAA,CAAe,CAAA,IAAK,OAAA;EACzE,EAAA,iBAAmB,cAAA,EACjB,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA;EAEjC,IAAA,iBAAqB,cAAA,EACnB,KAAA,EAAO,CAAA,EACP,OAAA,GAAU,IAAA,EAAM,cAAA,CAAe,CAAA;AAAA"}

package/package.json

@@ -1,10 +1,54 @@
 {
   "name": "@zeltjs/eventbus",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @zeltjs/eventbus",
-  "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
-}
+  "version": "0.5.0",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zeltjs/zelt.git",
+    "directory": "packages/eventbus"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./adaptor-memory": {
+      "types": "./dist/adaptor-memory/index.d.ts",
+      "import": "./dist/adaptor-memory/index.js"
+    },
+    "./adaptor-redis": {
+      "types": "./dist/adaptor-redis/index.d.ts",
+      "import": "./dist/adaptor-redis/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@zeltjs/core": "0.5.0",
+    "@zeltjs/redis": "0.5.0"
+  },
+  "peerDependenciesMeta": {
+    "@zeltjs/redis": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "22.19.17",
+    "ioredis": "5.10.1",
+    "@zeltjs/core": "0.5.0",
+    "@zeltjs/redis": "0.5.0"
+  },
+  "volta": {
+    "extends": "../../package.json"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "typecheck": "tsc -b"
+  }
+}