@fluojs/event-bus 1.0.0-beta.1 → 1.0.0-beta.3

package/README.ko.md

@@ -11,6 +11,7 @@ fluo를 위한 인프로세스(In-process) 이벤트 발행 및 구독 패키지
 - [빠른 시작](#빠른-시작)
 - [일반적인 패턴](#일반적인-패턴)
 - [공개 API 개요](#공개-api-개요)
+- [런타임별 및 통합 서브패스](#런타임별-및-통합-서브패스)
 - [관련 패키지](#관련-패키지)
 - [예제 소스](#예제-소스)
 
@@ -104,13 +105,23 @@ class UserRegisteredEvent {
 ## 공개 API 개요
 
 ### 핵심 구성 요소
-- `EventBusModule`: 이벤트 버스 기능을 위한 기본 모듈입니다.
+- `EventBusModule.forRoot(...)`: 이벤트 버스 등록을 위한 기본 진입점입니다.
 - `EventBusLifecycleService`: 이벤트를 발행(`publish(event)`)하기 위한 기본 서비스입니다.
 - `@OnEvent(EventClass)`: 특정 메서드를 이벤트 핸들러로 지정하는 데코레이터입니다.
-- `EventBusModule.forRoot(...)`: in-process 이벤트 버스 구성을 설정합니다.
+- `EVENT_BUS`: 발행 facade를 위한 호환성 주입 토큰입니다.
+- `createEventBusPlatformStatusSnapshot(...)`: diagnostics와 health surface에서 사용하는 상태 스냅샷 헬퍼입니다.
 
 ### 인터페이스
 - `EventBusTransport`: 외부 트랜스포트 어댑터 구현을 위한 계약입니다.
+- `EventBus`, `EventPublishOptions`, `EventBusModuleOptions`, `EventType`: 발행, 기본값, 트랜스포트, 안정적인 이벤트 키를 위한 타입 전용 계약입니다.
+
+## 런타임별 및 통합 서브패스
+
+| 관심사 | 서브패스 | 내보내는 항목 |
+| --- | --- | --- |
+| Redis Pub/Sub 트랜스포트 | `@fluojs/event-bus/redis` | `RedisEventBusTransport`, `RedisEventBusTransportOptions` |
+
+`RedisEventBusTransport`는 명시적인 `@fluojs/event-bus/redis` 서브패스에만 유지되어 루트 `@fluojs/event-bus` 진입점이 모듈 등록, 로컬 발행, 데코레이터, 타입 전용 계약에 집중하도록 합니다. 이 트랜스포트는 shutdown 중 자신이 등록한 채널을 unsubscribe하고 message listener를 분리하지만, 호출자가 소유한 Redis 클라이언트를 disconnect하지 않습니다.
 
 ## 관련 패키지
 

package/README.md

@@ -11,6 +11,7 @@ In-process event publishing and subscription for fluo. It features decorator-bas
 - [Quick Start](#quick-start)
 - [Common Patterns](#common-patterns)
 - [Public API](#public-api)
+- [Runtime-Specific and Integration Subpaths](#runtime-specific-and-integration-subpaths)
 - [Related Packages](#related-packages)
 - [Example Sources](#example-sources)
 
@@ -104,12 +105,23 @@ class UserRegisteredEvent {
 ## Public API Overview
 
 ### Core
-- `EventBusModule`: Main entry point for event bus registration.
+- `EventBusModule.forRoot(...)`: Main entry point for event bus registration.
 - `EventBusLifecycleService`: Primary service for publishing events (`publish(event)`).
 - `@OnEvent(EventClass)`: Decorator to mark a method as an event handler.
+- `EVENT_BUS`: Compatibility injection token for the publish facade.
+- `createEventBusPlatformStatusSnapshot(...)`: Status snapshot helper used by diagnostics and health surfaces.
 
 ### Interfaces
 - `EventBusTransport`: Contract for implementing external transport adapters.
+- `EventBus`, `EventPublishOptions`, `EventBusModuleOptions`, `EventType`: Type-only contracts for publishing, defaults, transports, and stable event keys.
+
+## Runtime-Specific and Integration Subpaths
+
+| Concern | Subpath | Exports |
+| --- | --- | --- |
+| Redis Pub/Sub transport | `@fluojs/event-bus/redis` | `RedisEventBusTransport`, `RedisEventBusTransportOptions` |
+
+`RedisEventBusTransport` stays on the explicit `@fluojs/event-bus/redis` subpath so the root `@fluojs/event-bus` entrypoint remains focused on module registration, local publishing, decorators, and type-only contracts. The transport unsubscribes the channels it registered and detaches its message listener during shutdown, but it does not disconnect caller-owned Redis clients.
 
 ## Related Packages
 

package/dist/metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAsCvD,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,mBAAmB,EAChC,QAAQ,EAAE,oBAAoB,GAC7B,IAAI,CAEN;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB,GAAG,oBAAoB,GAAG,SAAS,CAS1H;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,MAAM,GACb,KAAK,CAAC;IAAE,QAAQ,EAAE,oBAAoB,CAAC;IAAC,WAAW,EAAE,mBAAmB,CAAA;CAAE,CAAC,CAW7E;AAED,eAAO,MAAM,sBAAsB,QAAkC,CAAC"}
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AA8BvD,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,mBAAmB,EAChC,QAAQ,EAAE,oBAAoB,GAC7B,IAAI,CAEN;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB,GAAG,oBAAoB,GAAG,SAAS,CAS1H;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,MAAM,GACb,KAAK,CAAC;IAAE,QAAQ,EAAE,oBAAoB,CAAC;IAAC,WAAW,EAAE,mBAAmB,CAAA;CAAE,CAAC,CAW7E;AAED,eAAO,MAAM,sBAAsB,QAAkC,CAAC"}

package/dist/metadata.js

@@ -1,4 +1,4 @@
-import { ensureSymbolMetadataPolyfill, metadataSymbol } from '@fluojs/core/internal';
+import { ensureSymbolMetadataPolyfill, getStandardConstructorMetadataBag } from '@fluojs/core/internal';
 void ensureSymbolMetadataPolyfill();
 const standardEventHandlerMetadataKey = Symbol.for('fluo.event-bus.standard.handler');
 const eventHandlerMetadataStore = new WeakMap();
@@ -7,12 +7,8 @@ function cloneEventHandlerMetadata(metadata) {
     eventType: metadata.eventType
   };
 }
-function getStandardMetadataBag(target) {
-  return target[metadataSymbol];
-}
 function getStandardEventHandlerMap(target) {
-  const constructor = target.constructor;
-  return constructor ? getStandardMetadataBag(constructor)?.[standardEventHandlerMetadataKey] : undefined;
+  return getStandardConstructorMetadataBag(target)?.[standardEventHandlerMetadataKey];
 }
 function getOrCreateEventHandlerMap(target) {
   let map = eventHandlerMetadataStore.get(target);

package/package.json

@@ -8,7 +8,7 @@
     "pubsub",
     "in-process"
   ],
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.3",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -39,9 +39,9 @@
     "dist"
   ],
   "dependencies": {
-    "@fluojs/di": "^1.0.0-beta.1",
-    "@fluojs/core": "^1.0.0-beta.1",
-    "@fluojs/runtime": "^1.0.0-beta.1"
+    "@fluojs/core": "^1.0.0-beta.2",
+    "@fluojs/di": "^1.0.0-beta.3",
+    "@fluojs/runtime": "^1.0.0-beta.3"
   },
   "peerDependencies": {
     "ioredis": "^5.0.0"