@spfn/core 0.2.0-beta.21 → 0.2.0-beta.23

package/dist/{types-DHQMQlcb.d.ts → types-DAVwA-_7.d.ts}

@@ -22,6 +22,15 @@ import { E as EventRouterDef, I as InferEventNames, b as InferEventPayload } fro
  * manager.destroy();
  * ```
  */
+/**
+ * Minimal cache client interface (compatible with ioredis Redis | Cluster)
+ */
+type CacheClient = {
+    set(key: string, value: string, ...args: any[]): Promise<any>;
+    getdel?(key: string): Promise<string | null>;
+    get(key: string): Promise<string | null>;
+    del(key: string | string[]): Promise<number>;
+};
 /**
  * Stored SSE token data
  */
@@ -62,6 +71,31 @@ interface SSETokenManagerConfig {
      */
     cleanupInterval?: number;
 }
+/**
+ * Redis/Valkey-backed token store for multi-instance deployments.
+ *
+ * Uses SET EX for automatic TTL expiry and GETDEL for atomic one-time consumption.
+ * No cleanup needed — Redis handles expiration automatically.
+ *
+ * @example
+ * ```typescript
+ * import { getCache } from '@spfn/core/cache';
+ *
+ * const cache = getCache();
+ * if (cache) {
+ *     const store = new CacheTokenStore(cache);
+ *     const manager = new SSETokenManager({ store });
+ * }
+ * ```
+ */
+declare class CacheTokenStore implements SSETokenStore {
+    private cache;
+    private prefix;
+    constructor(cache: CacheClient);
+    set(token: string, data: SSEToken): Promise<void>;
+    consume(token: string): Promise<SSEToken | null>;
+    cleanup(): Promise<void>;
+}
 declare class SSETokenManager {
     private store;
     private ttl;
@@ -302,4 +336,4 @@ type SSEConnectionState = 'connecting' | 'open' | 'closed' | 'error';
  */
 type SSEUnsubscribe = () => void;
 
-export { type SSEHandlerConfig as S, type SSEAuthConfig as a, SSETokenManager as b, type SSEToken as c, type SSETokenStore as d, type SSETokenManagerConfig as e, type SSEMessage as f, type SSEHandlerAuthConfig as g, type SSEClientConfig as h, type SSEEventHandler as i, type SSEEventHandlers as j, type SSESubscribeOptions as k, type SSEConnectionState as l, type SSEUnsubscribe as m };
+export { CacheTokenStore as C, type SSEHandlerConfig as S, type SSEAuthConfig as a, SSETokenManager as b, type SSEToken as c, type SSETokenStore as d, type SSETokenManagerConfig as e, type SSEMessage as f, type SSEHandlerAuthConfig as g, type SSEClientConfig as h, type SSEEventHandler as i, type SSEEventHandlers as j, type SSESubscribeOptions as k, type SSEConnectionState as l, type SSEUnsubscribe as m };

package/docs/event.md

@@ -307,6 +307,17 @@ if (cache)
 await userCreated.emit({ userId: '123' });
 ```
 
+### SSE Token Store
+
+SSE 토큰 저장소도 멀티 인스턴스에서 공유되어야 합니다.
+캐시가 연결되면 `CacheTokenStore`가 **자동 사용**됩니다.
+
+| 환경 | 토큰 저장소 | 설정 |
+|------|------------|------|
+| `CACHE_URL` 없음 | `InMemoryTokenStore` | 자동 |
+| `CACHE_URL` 설정됨 | `CacheTokenStore` | 자동 감지 |
+| 커스텀 | `SSETokenStore` 구현 | `auth.store` 옵션 |
+
 ## API Reference
 
 ### defineEvent(name)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spfn/core",
-  "version": "0.2.0-beta.21",
+  "version": "0.2.0-beta.23",
   "description": "SPFN Framework Core - File-based routing, transactions, repository pattern",
   "type": "module",
   "exports": {