@sonamu-kit/websocket-redis-adapter 0.13.0 → 0.13.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -11,7 +11,7 @@ pnpm add @sonamu-kit/websocket-redis-adapter redis
11
11
  | peer dependency | 범위 |
12
12
  | --- | --- |
13
13
  | `redis` | `^6` |
14
- | `sonamu` | `>=0.12.0` |
14
+ | `sonamu` | `>=0.13.9` |
15
15
 
16
16
  `redis` v6은 Node.js 20 이상이 필요합니다.
17
17
 
@@ -116,6 +116,14 @@ Redis Cluster(`createCluster`)와 sharded pub/sub는 아직 지원하지 않습
116
116
 
117
117
  pub/sub 채널에는 `keyPrefix`가 붙지 않습니다. **하나의 Redis를 여러 앱이 공유하면 앱마다 어댑터 `prefix`를 다르게 설정해야 합니다.** `keyPrefix`만 다르게 하면 키는 분리되지만 채널이 겹쳐 다른 앱의 envelope을 받습니다.
118
118
 
119
+ ## Control messages
120
+
121
+ `<prefix>:node:<nodeId>` 채널의 envelope은 `kind`로 구분되는 union입니다. `publish`는 audience로 보내는 메시지이고, `leaveUser`는 `registry.leaveUser`가 다른 노드에 보내는 control 메시지입니다. `kind`가 없는 envelope은 `publish`로 취급합니다. 알 수 없는 `kind`나 스키마 오류 envelope은 버리며, 어댑터는 `subscribe(handler, { onRejected })`의 `onRejected` 콜백으로 알리고 core는 `ws.cluster.envelope.rejected` telemetry를 남깁니다.
122
+
123
+ control envelope은 publish envelope과 같은 노드별 publish 큐와 같은 Redis 명령 연결을 쓰므로, 한 출발 노드에서 나간 순서(`leaveUser` 다음 `publishToRoom`)가 수신 노드에서도 유지됩니다.
124
+
125
+ `leaveUser`는 pub/sub의 at-most-once 전달에 의존하므로, 그 시점에 구독이 끊긴 노드는 leave를 놓칩니다. `partial: false`는 publish 성공만 뜻하고 원격 노드의 적용을 보장하지 않습니다. 0.13.9 미만 노드는 control envelope을 스키마 검증으로 거부합니다.
126
+
119
127
  ## 실패 동작
120
128
 
121
129
  어댑터는 node-redis의 timeout에 의존하지 않습니다. node-redis의 `commandOptions.timeout`은 아직 소켓에 쓰지 않은 명령에만 적용되므로, 모든 Redis 호출을 `commandDeadlineMs` deadline으로 감싸고 늦게 도착한 결과는 무시합니다.
@@ -1,4 +1,4 @@
1
- import { type WebSocketClusterBus, type WebSocketClusterEnvelope, type WebSocketClusterEnvelopeHandler } from "sonamu";
1
+ import { type WebSocketClusterBus, type WebSocketClusterEnvelope, type WebSocketClusterEnvelopeHandler, type WebSocketClusterSubscribeOptions } from "sonamu";
2
2
  import { type RedisWebSocketConnection } from "./connection";
3
3
  /**
4
4
  * 노드별 pub/sub 채널. 채널에는 client keyPrefix가 붙지 않으므로 어댑터 prefix만으로 앱을 구분한다.
@@ -30,7 +30,7 @@ export declare class RedisWebSocketClusterBus implements WebSocketClusterBus {
30
30
  * 자기 노드 채널을 구독한다. 구독이 끝나면 resolve하고, readyTimeoutMs와 commandDeadlineMs 안에 끝나지 않으면 reject한다.
31
31
  * reject돼도 핸들러는 남아 있어 연결이 ready가 되면 구독이 이어진다(shutdown이나 해제 함수로 정리한다).
32
32
  */
33
- subscribe(handler: WebSocketClusterEnvelopeHandler): Promise<() => void>;
33
+ subscribe(handler: WebSocketClusterEnvelopeHandler, options?: WebSocketClusterSubscribeOptions): Promise<() => void>;
34
34
  shutdown(): Promise<void>;
35
35
  private close;
36
36
  private releaseSubscription;
@@ -1 +1 @@
1
- {"version":3,"file":"cluster-bus.d.ts","sourceRoot":"","sources":["../src/cluster-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,+BAA+B,EACrC,MAAM,QAAQ,CAAC;AAGhB,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,cAAc,CAAC;AAGtB;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpE;AA6CD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,wBAAwB,GAAG,SAAS,CAG1F;AAID;;;GAGG;AACH,qBAAa,wBAAyB,YAAW,mBAAmB;IAClE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2B;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8C;IACvE,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAA4B;IAE/C,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,eAAe,CAA4B;IAEnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAWvB;IAEF,mDAAmD;IACnD,YAAY,UAAU,EAAE,wBAAwB,EAQ/C;IAEK,OAAO,CAAC,QAAQ,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB/D;IAED;;;OAGG;IACG,SAAS,CAAC,OAAO,EAAE,+BAA+B,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAa7E;IAED,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAGxB;YAEa,KAAK;YAML,mBAAmB;IAiBjC,OAAO,CAAC,gBAAgB;YAwBV,gBAAgB;IAsB9B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,eAAe;CAMxB"}
1
+ {"version":3,"file":"cluster-bus.d.ts","sourceRoot":"","sources":["../src/cluster-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,+BAA+B,EACpC,KAAK,gCAAgC,EACtC,MAAM,QAAQ,CAAC;AAGhB,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,cAAc,CAAC;AAGtB;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpE;AAyDD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,wBAAwB,GAAG,SAAS,CAG1F;AAID;;;GAGG;AACH,qBAAa,wBAAyB,YAAW,mBAAmB;IAClE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2B;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAGrB;IACJ,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAA4B;IAE/C,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,eAAe,CAA4B;IAEnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAgBvB;IAEF,mDAAmD;IACnD,YAAY,UAAU,EAAE,wBAAwB,EAQ/C;IAEK,OAAO,CAAC,QAAQ,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB/D;IAED;;;OAGG;IACG,SAAS,CACb,OAAO,EAAE,+BAA+B,EACxC,OAAO,GAAE,gCAAqC,GAC7C,OAAO,CAAC,MAAM,IAAI,CAAC,CAarB;IAED,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAGxB;YAEa,KAAK;YAML,mBAAmB;IAiBjC,OAAO,CAAC,gBAAgB;YAwBV,gBAAgB;IAsB9B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,eAAe;CAMxB"}
@@ -32,15 +32,23 @@ const AudienceSchema = z.lazy(() => z.discriminatedUnion("type", [
32
32
  audiences: z.array(AudienceSchema)
33
33
  })
34
34
  ]));
35
- const ClusterEnvelopeSchema = z.object({
35
+ const CommonEnvelopeSchema = z.object({
36
36
  id: z.string(),
37
37
  sourceNodeId: z.string(),
38
38
  targetNodeIds: z.array(z.string()),
39
- audience: AudienceSchema,
40
- event: z.string(),
41
- frames: z.record(z.string(), z.string()),
42
39
  emittedAt: z.number()
43
40
  });
41
+ const ClusterEnvelopeSchema = z.union([CommonEnvelopeSchema.extend({
42
+ kind: z.literal("publish").default("publish"),
43
+ audience: AudienceSchema,
44
+ event: z.string(),
45
+ frames: z.record(z.string(), z.string())
46
+ }), CommonEnvelopeSchema.extend({
47
+ kind: z.literal("leaveUser"),
48
+ userId: z.union([z.number(), z.string()]),
49
+ roomId: z.string(),
50
+ namespace: z.string().optional()
51
+ })]);
44
52
  const ClusterMessageSchema = z.string().transform((message, context) => {
45
53
  try {
46
54
  return JSON.parse(message);
@@ -68,7 +76,7 @@ var RedisWebSocketClusterBus = class {
68
76
  nodeId;
69
77
  connection;
70
78
  channel;
71
- handlers = /* @__PURE__ */ new Set();
79
+ handlers = /* @__PURE__ */ new Map();
72
80
  subscribed = false;
73
81
  subscribing;
74
82
  pendingSubscribes = 0;
@@ -76,8 +84,11 @@ var RedisWebSocketClusterBus = class {
76
84
  shutdownPromise;
77
85
  listener = (message) => {
78
86
  const envelope = parseClusterEnvelope(message.toString());
79
- if (!envelope) return;
80
- for (const handler of this.handlers) Promise.resolve().then(() => handler(envelope)).catch(ignoreError);
87
+ if (!envelope) {
88
+ for (const options of this.handlers.values()) Promise.resolve().then(() => options.onRejected?.({ reason: "invalidEnvelope" })).catch(ignoreError);
89
+ return;
90
+ }
91
+ for (const handler of this.handlers.keys()) Promise.resolve().then(() => handler(envelope)).catch(ignoreError);
81
92
  };
82
93
  /** @internal createRedisWebSocketAdapter가 생성한다. */
83
94
  constructor(connection) {
@@ -105,9 +116,9 @@ var RedisWebSocketClusterBus = class {
105
116
  * 자기 노드 채널을 구독한다. 구독이 끝나면 resolve하고, readyTimeoutMs와 commandDeadlineMs 안에 끝나지 않으면 reject한다.
106
117
  * reject돼도 핸들러는 남아 있어 연결이 ready가 되면 구독이 이어진다(shutdown이나 해제 함수로 정리한다).
107
118
  */
108
- async subscribe(handler) {
119
+ async subscribe(handler, options = {}) {
109
120
  if (this.closed) throw new Error("Redis WebSocket cluster bus is shut down.");
110
- this.handlers.add(handler);
121
+ this.handlers.set(handler, options);
111
122
  const unsubscribe = () => {
112
123
  this.handlers.delete(handler);
113
124
  if (this.handlers.size === 0) this.dropSubscription();
@@ -1 +1 @@
1
- {"version":3,"file":"cluster-bus.js","names":[],"sources":["../src/cluster-bus.ts"],"sourcesContent":["import {\n type WebSocketAudience,\n type WebSocketClusterBus,\n type WebSocketClusterEnvelope,\n type WebSocketClusterEnvelopeHandler,\n} from \"sonamu\";\nimport { z } from \"zod\";\n\nimport {\n type RedisPubSubListener,\n type RedisSubscriberTarget,\n type RedisWebSocketConnection,\n} from \"./connection\";\nimport { withDeadline } from \"./deadline\";\n\n/**\n * 노드별 pub/sub 채널. 채널에는 client keyPrefix가 붙지 않으므로 어댑터 prefix만으로 앱을 구분한다.\n */\nexport function nodeChannelOf(prefix: string, nodeId: string): string {\n return `${prefix}:node:${nodeId}`;\n}\n\n// 수신한 envelope은 다른 노드가 보낸 외부 입력이므로 형식을 검증한 뒤에만 핸들러에 넘긴다\nconst AudienceSchema: z.ZodType<WebSocketAudience> = z.lazy(() =>\n z.discriminatedUnion(\"type\", [\n z.object({ type: z.literal(\"all\"), namespace: z.string().optional() }),\n z.object({ type: z.literal(\"room\"), roomId: z.string(), namespace: z.string().optional() }),\n z.object({\n type: z.literal(\"user\"),\n userId: z.union([z.number(), z.string()]),\n namespace: z.string().optional(),\n }),\n z.object({\n type: z.literal(\"connections\"),\n connectionIds: z.array(z.string()),\n namespace: z.string().optional(),\n }),\n z.object({ type: z.literal(\"union\"), audiences: z.array(AudienceSchema) }),\n ]),\n);\n\nconst ClusterEnvelopeSchema = z.object({\n id: z.string(),\n sourceNodeId: z.string(),\n targetNodeIds: z.array(z.string()),\n audience: AudienceSchema,\n event: z.string(),\n frames: z.record(z.string(), z.string()),\n emittedAt: z.number(),\n});\n\nconst ClusterMessageSchema = z\n .string()\n .transform((message, context) => {\n try {\n return /* SAFETY: 결과는 바로 아래 pipe의 ClusterEnvelopeSchema로 검증한다. */ JSON.parse(\n message,\n ) as z.input<typeof ClusterEnvelopeSchema>;\n } catch {\n context.addIssue({ code: \"custom\", message: \"envelope JSON을 파싱할 수 없습니다.\" });\n return z.NEVER;\n }\n })\n .pipe(ClusterEnvelopeSchema);\n\n/**\n * 채널로 받은 envelope JSON을 검증한다. 형식이 맞지 않으면 undefined를 돌려 버린다.\n */\nexport function parseClusterEnvelope(message: string): WebSocketClusterEnvelope | undefined {\n const parsed = ClusterMessageSchema.safeParse(message);\n return parsed.success ? parsed.data : undefined;\n}\n\nfunction ignoreError(): void {}\n\n/**\n * node-redis pub/sub 기반 cluster bus. 노드마다 채널 하나를 구독하고, envelope을 대상 노드 채널에만 publish한다.\n * 한 노드의 publish는 같은 명령 연결로 순서대로 나가므로 수신 노드에도 보낸 순서대로 도착한다.\n */\nexport class RedisWebSocketClusterBus implements WebSocketClusterBus {\n readonly nodeId: string;\n private readonly connection: RedisWebSocketConnection;\n private readonly channel: string;\n private readonly handlers = new Set<WebSocketClusterEnvelopeHandler>();\n private subscribed = false;\n private subscribing: Promise<void> | undefined;\n // node-redis에 보냈지만 아직 끝나지 않은 SUBSCRIBE 수. 어댑터 deadline이 지나도 node-redis 쪽 구독은 늦게 끝날 수 있다\n private pendingSubscribes = 0;\n private closed = false;\n private shutdownPromise: Promise<void> | undefined;\n\n private readonly listener: RedisPubSubListener = (message) => {\n const envelope = parseClusterEnvelope(message.toString());\n if (!envelope) {\n return;\n }\n for (const handler of this.handlers) {\n // 핸들러 실패가 다른 핸들러나 구독 연결로 번지지 않게 한다\n Promise.resolve()\n .then(() => handler(envelope))\n .catch(ignoreError);\n }\n };\n\n /** @internal createRedisWebSocketAdapter가 생성한다. */\n constructor(connection: RedisWebSocketConnection) {\n this.connection = connection;\n this.nodeId = connection.options.nodeId;\n this.channel = nodeChannelOf(connection.options.prefix, this.nodeId);\n // Sentinel 입력에서 연결 전에 구독이 실패했으면 ready 때 다시 시도한다\n connection.onConnectionReady(() => {\n this.retrySubscription();\n });\n }\n\n async publish(envelope: WebSocketClusterEnvelope): Promise<void> {\n if (this.closed) {\n return;\n }\n const message = JSON.stringify(envelope);\n const prefix = this.connection.options.prefix;\n const targets = [...new Set(envelope.targetNodeIds)];\n if (targets.length === 0) {\n return;\n }\n const wait = this.connection.whenUsable();\n if (wait) {\n await wait;\n // ready를 기다리는 사이 shutdown됐으면 보내지 않는다\n if (this.closed) {\n return;\n }\n }\n await this.connection.run((commands) =>\n Promise.all(\n targets.map((target) => commands.publish(nodeChannelOf(prefix, target), message)),\n ),\n );\n }\n\n /**\n * 자기 노드 채널을 구독한다. 구독이 끝나면 resolve하고, readyTimeoutMs와 commandDeadlineMs 안에 끝나지 않으면 reject한다.\n * reject돼도 핸들러는 남아 있어 연결이 ready가 되면 구독이 이어진다(shutdown이나 해제 함수로 정리한다).\n */\n async subscribe(handler: WebSocketClusterEnvelopeHandler): Promise<() => void> {\n if (this.closed) {\n throw new Error(\"Redis WebSocket cluster bus is shut down.\");\n }\n this.handlers.add(handler);\n const unsubscribe = () => {\n this.handlers.delete(handler);\n if (this.handlers.size === 0) {\n this.dropSubscription();\n }\n };\n await this.ensureSubscribed();\n return unsubscribe;\n }\n\n shutdown(): Promise<void> {\n this.shutdownPromise ??= this.close();\n return this.shutdownPromise;\n }\n\n private async close(): Promise<void> {\n this.closed = true;\n this.handlers.clear();\n await Promise.all([this.releaseSubscription(), this.connection.release(\"bus\")]);\n }\n\n private async releaseSubscription(): Promise<void> {\n if (this.connection.kind === \"sentinel\") {\n // 호출자 Sentinel은 닫지 않으므로 구독만 해제한다. 아직 끝나지 않은 SUBSCRIBE는 완료 시점에 따로 해제한다\n const wasSubscribed = this.subscribed || this.pendingSubscribes > 0;\n this.subscribed = false;\n this.subscribing = undefined;\n if (wasSubscribed) {\n await this.unsubscribeFrom(this.connection.subscriber(ignoreError)).catch(ignoreError);\n }\n return;\n }\n // 어댑터 소유 duplicate()를 닫으면 구독도 함께 사라진다\n this.subscribed = false;\n this.subscribing = undefined;\n await this.connection.closeSubscriber();\n }\n\n private ensureSubscribed(): Promise<void> {\n if (this.subscribed) {\n return Promise.resolve();\n }\n if (!this.subscribing) {\n const subscribing = this.subscribeChannel().then(\n () => {\n if (this.subscribing === subscribing) {\n this.subscribed = true;\n }\n },\n (cause: unknown) => {\n if (this.subscribing === subscribing) {\n this.subscribing = undefined;\n }\n throw cause;\n },\n );\n subscribing.catch(ignoreError);\n this.subscribing = subscribing;\n }\n return this.subscribing;\n }\n\n private async subscribeChannel(): Promise<void> {\n // node-redis는 연결 전 SUBSCRIBE를 큐에 두고 연결 뒤 보내므로, 대기 상한만 어댑터가 정한다\n const { readyTimeoutMs, commandDeadlineMs } = this.connection.options;\n const wait = this.connection.kind === \"sentinel\" ? this.connection.whenUsable() : undefined;\n if (wait) {\n await wait;\n }\n // ready를 기다리는 사이 shutdown됐으면 호출자 연결에 구독을 남기지 않는다\n if (this.closed) {\n throw new Error(\"Redis WebSocket cluster bus is shut down.\");\n }\n const subscriber = this.connection.subscriber(() => {\n this.retrySubscription();\n });\n const sending = subscriber.subscribe(this.channel, this.listener);\n this.watchLateSubscribe(subscriber, sending);\n await withDeadline(\n () => sending,\n wait ? commandDeadlineMs : readyTimeoutMs + commandDeadlineMs,\n );\n }\n\n /**\n * deadline과 무관하게 node-redis SUBSCRIBE가 실제로 끝나는 시점을 본다.\n * 그때 bus가 닫혔거나 더 이상 구독할 핸들러가 없으면 같은 연결에서 바로 구독을 해제하고,\n * 아직 구독이 필요하면 늦게 끝난 구독을 그대로 쓴다.\n */\n private watchLateSubscribe(subscriber: RedisSubscriberTarget, sending: Promise<void>): void {\n this.pendingSubscribes += 1;\n sending\n .then(() => {\n if (this.closed || this.handlers.size === 0) {\n this.unsubscribeFrom(subscriber).catch(ignoreError);\n return;\n }\n this.subscribed = true;\n }, ignoreError)\n .finally(() => {\n this.pendingSubscribes -= 1;\n });\n }\n\n private retrySubscription(): void {\n if (this.closed || this.subscribed || this.subscribing || this.handlers.size === 0) {\n return;\n }\n this.ensureSubscribed().catch(ignoreError);\n }\n\n private dropSubscription(): void {\n if (this.closed) {\n return;\n }\n // 구독한 적이 없으면 보낼 것이 없다. 진행 중인 SUBSCRIBE는 완료 시점에 해제한다\n const wasSubscribed = this.subscribed;\n this.subscribed = false;\n this.subscribing = undefined;\n if (wasSubscribed) {\n this.unsubscribeFrom(this.connection.subscriber(ignoreError)).catch(ignoreError);\n }\n }\n\n private unsubscribeFrom(subscriber: RedisSubscriberTarget): Promise<void> {\n return withDeadline(\n () => subscriber.unsubscribe(this.channel, this.listener),\n this.connection.options.commandDeadlineMs,\n );\n }\n}\n"],"mappings":";;;;;;AAkBA,SAAgB,cAAc,QAAgB,QAAwB;CACpE,OAAO,GAAG,OAAO,QAAQ;AAC3B;AAGA,MAAM,iBAA+C,EAAE,WACrD,EAAE,mBAAmB,QAAQ;CAC3B,EAAE,OAAO;EAAE,MAAM,EAAE,QAAQ,KAAK;EAAG,WAAW,EAAE,OAAO,CAAC,CAAC,SAAS;CAAE,CAAC;CACrE,EAAE,OAAO;EAAE,MAAM,EAAE,QAAQ,MAAM;EAAG,QAAQ,EAAE,OAAO;EAAG,WAAW,EAAE,OAAO,CAAC,CAAC,SAAS;CAAE,CAAC;CAC1F,EAAE,OAAO;EACP,MAAM,EAAE,QAAQ,MAAM;EACtB,QAAQ,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,EAAE,OAAO,CAAC,CAAC;EACxC,WAAW,EAAE,OAAO,CAAC,CAAC,SAAS;CACjC,CAAC;CACD,EAAE,OAAO;EACP,MAAM,EAAE,QAAQ,aAAa;EAC7B,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC;EACjC,WAAW,EAAE,OAAO,CAAC,CAAC,SAAS;CACjC,CAAC;CACD,EAAE,OAAO;EAAE,MAAM,EAAE,QAAQ,OAAO;EAAG,WAAW,EAAE,MAAM,cAAc;CAAE,CAAC;AAC3E,CAAC,CACH;AAEA,MAAM,wBAAwB,EAAE,OAAO;CACrC,IAAI,EAAE,OAAO;CACb,cAAc,EAAE,OAAO;CACvB,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC;CACjC,UAAU;CACV,OAAO,EAAE,OAAO;CAChB,QAAQ,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,OAAO,CAAC;CACvC,WAAW,EAAE,OAAO;AACtB,CAAC;AAED,MAAM,uBAAuB,EAC1B,OAAO,CAAC,CACR,WAAW,SAAS,YAAY;CAC/B,IAAI;EACF,OAAkE,KAAK,MACrE,OACF;CACF,QAAQ;EACN,QAAQ,SAAS;GAAE,MAAM;GAAU,SAAS;EAA6B,CAAC;EAC1E,OAAO,EAAE;CACX;AACF,CAAC,CAAC,CACD,KAAK,qBAAqB;;;;AAK7B,SAAgB,qBAAqB,SAAuD;CAC1F,MAAM,SAAS,qBAAqB,UAAU,OAAO;CACrD,OAAO,OAAO,UAAU,OAAO,OAAO,KAAA;AACxC;AAEA,SAAS,cAAoB,CAAC;;;;;AAM9B,IAAa,2BAAb,MAAqE;CACnE;CACA;CACA;CACA,2BAA4B,IAAI,IAAqC;CACrE,aAAqB;CACrB;CAEA,oBAA4B;CAC5B,SAAiB;CACjB;CAEA,YAAkD,YAAY;EAC5D,MAAM,WAAW,qBAAqB,QAAQ,SAAS,CAAC;EACxD,IAAI,CAAC,UACH;EAEF,KAAK,MAAM,WAAW,KAAK,UAEzB,QAAQ,QAAQ,CAAC,CACd,WAAW,QAAQ,QAAQ,CAAC,CAAC,CAC7B,MAAM,WAAW;CAExB;;CAGA,YAAY,YAAsC;EAChD,KAAK,aAAa;EAClB,KAAK,SAAS,WAAW,QAAQ;EACjC,KAAK,UAAU,cAAc,WAAW,QAAQ,QAAQ,KAAK,MAAM;EAEnE,WAAW,wBAAwB;GACjC,KAAK,kBAAkB;EACzB,CAAC;CACH;CAEA,MAAM,QAAQ,UAAmD;EAC/D,IAAI,KAAK,QACP;EAEF,MAAM,UAAU,KAAK,UAAU,QAAQ;EACvC,MAAM,SAAS,KAAK,WAAW,QAAQ;EACvC,MAAM,UAAU,CAAC,GAAG,IAAI,IAAI,SAAS,aAAa,CAAC;EACnD,IAAI,QAAQ,WAAW,GACrB;EAEF,MAAM,OAAO,KAAK,WAAW,WAAW;EACxC,IAAI,MAAM;GACR,MAAM;GAEN,IAAI,KAAK,QACP;EAEJ;EACA,MAAM,KAAK,WAAW,KAAK,aACzB,QAAQ,IACN,QAAQ,KAAK,WAAW,SAAS,QAAQ,cAAc,QAAQ,MAAM,GAAG,OAAO,CAAC,CAClF,CACF;CACF;;;;;CAMA,MAAM,UAAU,SAA+D;EAC7E,IAAI,KAAK,QACP,MAAM,IAAI,MAAM,2CAA2C;EAE7D,KAAK,SAAS,IAAI,OAAO;EACzB,MAAM,oBAAoB;GACxB,KAAK,SAAS,OAAO,OAAO;GAC5B,IAAI,KAAK,SAAS,SAAS,GACzB,KAAK,iBAAiB;EAE1B;EACA,MAAM,KAAK,iBAAiB;EAC5B,OAAO;CACT;CAEA,WAA0B;EACxB,KAAK,oBAAoB,KAAK,MAAM;EACpC,OAAO,KAAK;CACd;CAEA,MAAc,QAAuB;EACnC,KAAK,SAAS;EACd,KAAK,SAAS,MAAM;EACpB,MAAM,QAAQ,IAAI,CAAC,KAAK,oBAAoB,GAAG,KAAK,WAAW,QAAQ,KAAK,CAAC,CAAC;CAChF;CAEA,MAAc,sBAAqC;EACjD,IAAI,KAAK,WAAW,SAAS,YAAY;GAEvC,MAAM,gBAAgB,KAAK,cAAc,KAAK,oBAAoB;GAClE,KAAK,aAAa;GAClB,KAAK,cAAc,KAAA;GACnB,IAAI,eACF,MAAM,KAAK,gBAAgB,KAAK,WAAW,WAAW,WAAW,CAAC,CAAC,CAAC,MAAM,WAAW;GAEvF;EACF;EAEA,KAAK,aAAa;EAClB,KAAK,cAAc,KAAA;EACnB,MAAM,KAAK,WAAW,gBAAgB;CACxC;CAEA,mBAA0C;EACxC,IAAI,KAAK,YACP,OAAO,QAAQ,QAAQ;EAEzB,IAAI,CAAC,KAAK,aAAa;GACrB,MAAM,cAAc,KAAK,iBAAiB,CAAC,CAAC,WACpC;IACJ,IAAI,KAAK,gBAAgB,aACvB,KAAK,aAAa;GAEtB,IACC,UAAmB;IAClB,IAAI,KAAK,gBAAgB,aACvB,KAAK,cAAc,KAAA;IAErB,MAAM;GACR,CACF;GACA,YAAY,MAAM,WAAW;GAC7B,KAAK,cAAc;EACrB;EACA,OAAO,KAAK;CACd;CAEA,MAAc,mBAAkC;EAE9C,MAAM,EAAE,gBAAgB,sBAAsB,KAAK,WAAW;EAC9D,MAAM,OAAO,KAAK,WAAW,SAAS,aAAa,KAAK,WAAW,WAAW,IAAI,KAAA;EAClF,IAAI,MACF,MAAM;EAGR,IAAI,KAAK,QACP,MAAM,IAAI,MAAM,2CAA2C;EAE7D,MAAM,aAAa,KAAK,WAAW,iBAAiB;GAClD,KAAK,kBAAkB;EACzB,CAAC;EACD,MAAM,UAAU,WAAW,UAAU,KAAK,SAAS,KAAK,QAAQ;EAChE,KAAK,mBAAmB,YAAY,OAAO;EAC3C,MAAM,mBACE,SACN,OAAO,oBAAoB,iBAAiB,iBAC9C;CACF;;;;;;CAOA,mBAA2B,YAAmC,SAA8B;EAC1F,KAAK,qBAAqB;EAC1B,QACG,WAAW;GACV,IAAI,KAAK,UAAU,KAAK,SAAS,SAAS,GAAG;IAC3C,KAAK,gBAAgB,UAAU,CAAC,CAAC,MAAM,WAAW;IAClD;GACF;GACA,KAAK,aAAa;EACpB,GAAG,WAAW,CAAC,CACd,cAAc;GACb,KAAK,qBAAqB;EAC5B,CAAC;CACL;CAEA,oBAAkC;EAChC,IAAI,KAAK,UAAU,KAAK,cAAc,KAAK,eAAe,KAAK,SAAS,SAAS,GAC/E;EAEF,KAAK,iBAAiB,CAAC,CAAC,MAAM,WAAW;CAC3C;CAEA,mBAAiC;EAC/B,IAAI,KAAK,QACP;EAGF,MAAM,gBAAgB,KAAK;EAC3B,KAAK,aAAa;EAClB,KAAK,cAAc,KAAA;EACnB,IAAI,eACF,KAAK,gBAAgB,KAAK,WAAW,WAAW,WAAW,CAAC,CAAC,CAAC,MAAM,WAAW;CAEnF;CAEA,gBAAwB,YAAkD;EACxE,OAAO,mBACC,WAAW,YAAY,KAAK,SAAS,KAAK,QAAQ,GACxD,KAAK,WAAW,QAAQ,iBAC1B;CACF;AACF"}
1
+ {"version":3,"file":"cluster-bus.js","names":[],"sources":["../src/cluster-bus.ts"],"sourcesContent":["import {\n type WebSocketAudience,\n type WebSocketClusterBus,\n type WebSocketClusterEnvelope,\n type WebSocketClusterEnvelopeHandler,\n type WebSocketClusterSubscribeOptions,\n} from \"sonamu\";\nimport { z } from \"zod\";\n\nimport {\n type RedisPubSubListener,\n type RedisSubscriberTarget,\n type RedisWebSocketConnection,\n} from \"./connection\";\nimport { withDeadline } from \"./deadline\";\n\n/**\n * 노드별 pub/sub 채널. 채널에는 client keyPrefix가 붙지 않으므로 어댑터 prefix만으로 앱을 구분한다.\n */\nexport function nodeChannelOf(prefix: string, nodeId: string): string {\n return `${prefix}:node:${nodeId}`;\n}\n\n// 수신한 envelope은 다른 노드가 보낸 외부 입력이므로 형식을 검증한 뒤에만 핸들러에 넘긴다\nconst AudienceSchema: z.ZodType<WebSocketAudience> = z.lazy(() =>\n z.discriminatedUnion(\"type\", [\n z.object({ type: z.literal(\"all\"), namespace: z.string().optional() }),\n z.object({ type: z.literal(\"room\"), roomId: z.string(), namespace: z.string().optional() }),\n z.object({\n type: z.literal(\"user\"),\n userId: z.union([z.number(), z.string()]),\n namespace: z.string().optional(),\n }),\n z.object({\n type: z.literal(\"connections\"),\n connectionIds: z.array(z.string()),\n namespace: z.string().optional(),\n }),\n z.object({ type: z.literal(\"union\"), audiences: z.array(AudienceSchema) }),\n ]),\n);\n\nconst CommonEnvelopeSchema = z.object({\n id: z.string(),\n sourceNodeId: z.string(),\n targetNodeIds: z.array(z.string()),\n emittedAt: z.number(),\n});\n\nconst ClusterEnvelopeSchema = z.union([\n CommonEnvelopeSchema.extend({\n kind: z.literal(\"publish\").default(\"publish\"),\n audience: AudienceSchema,\n event: z.string(),\n frames: z.record(z.string(), z.string()),\n }),\n CommonEnvelopeSchema.extend({\n kind: z.literal(\"leaveUser\"),\n userId: z.union([z.number(), z.string()]),\n roomId: z.string(),\n namespace: z.string().optional(),\n }),\n]);\n\nconst ClusterMessageSchema = z\n .string()\n .transform((message, context) => {\n try {\n return /* SAFETY: 결과는 바로 아래 pipe의 ClusterEnvelopeSchema로 검증한다. */ JSON.parse(\n message,\n ) as z.input<typeof ClusterEnvelopeSchema>;\n } catch {\n context.addIssue({ code: \"custom\", message: \"envelope JSON을 파싱할 수 없습니다.\" });\n return z.NEVER;\n }\n })\n .pipe(ClusterEnvelopeSchema);\n\n/**\n * 채널로 받은 envelope JSON을 검증한다. 형식이 맞지 않으면 undefined를 돌려 버린다.\n */\nexport function parseClusterEnvelope(message: string): WebSocketClusterEnvelope | undefined {\n const parsed = ClusterMessageSchema.safeParse(message);\n return parsed.success ? parsed.data : undefined;\n}\n\nfunction ignoreError(): void {}\n\n/**\n * node-redis pub/sub 기반 cluster bus. 노드마다 채널 하나를 구독하고, envelope을 대상 노드 채널에만 publish한다.\n * 한 노드의 publish는 같은 명령 연결로 순서대로 나가므로 수신 노드에도 보낸 순서대로 도착한다.\n */\nexport class RedisWebSocketClusterBus implements WebSocketClusterBus {\n readonly nodeId: string;\n private readonly connection: RedisWebSocketConnection;\n private readonly channel: string;\n private readonly handlers = new Map<\n WebSocketClusterEnvelopeHandler,\n WebSocketClusterSubscribeOptions\n >();\n private subscribed = false;\n private subscribing: Promise<void> | undefined;\n // node-redis에 보냈지만 아직 끝나지 않은 SUBSCRIBE 수. 어댑터 deadline이 지나도 node-redis 쪽 구독은 늦게 끝날 수 있다\n private pendingSubscribes = 0;\n private closed = false;\n private shutdownPromise: Promise<void> | undefined;\n\n private readonly listener: RedisPubSubListener = (message) => {\n const envelope = parseClusterEnvelope(message.toString());\n if (!envelope) {\n for (const options of this.handlers.values()) {\n Promise.resolve()\n .then(() => options.onRejected?.({ reason: \"invalidEnvelope\" }))\n .catch(ignoreError);\n }\n return;\n }\n for (const handler of this.handlers.keys()) {\n // 핸들러 실패가 다른 핸들러나 구독 연결로 번지지 않게 한다\n Promise.resolve()\n .then(() => handler(envelope))\n .catch(ignoreError);\n }\n };\n\n /** @internal createRedisWebSocketAdapter가 생성한다. */\n constructor(connection: RedisWebSocketConnection) {\n this.connection = connection;\n this.nodeId = connection.options.nodeId;\n this.channel = nodeChannelOf(connection.options.prefix, this.nodeId);\n // Sentinel 입력에서 연결 전에 구독이 실패했으면 ready 때 다시 시도한다\n connection.onConnectionReady(() => {\n this.retrySubscription();\n });\n }\n\n async publish(envelope: WebSocketClusterEnvelope): Promise<void> {\n if (this.closed) {\n return;\n }\n const message = JSON.stringify(envelope);\n const prefix = this.connection.options.prefix;\n const targets = [...new Set(envelope.targetNodeIds)];\n if (targets.length === 0) {\n return;\n }\n const wait = this.connection.whenUsable();\n if (wait) {\n await wait;\n // ready를 기다리는 사이 shutdown됐으면 보내지 않는다\n if (this.closed) {\n return;\n }\n }\n await this.connection.run((commands) =>\n Promise.all(\n targets.map((target) => commands.publish(nodeChannelOf(prefix, target), message)),\n ),\n );\n }\n\n /**\n * 자기 노드 채널을 구독한다. 구독이 끝나면 resolve하고, readyTimeoutMs와 commandDeadlineMs 안에 끝나지 않으면 reject한다.\n * reject돼도 핸들러는 남아 있어 연결이 ready가 되면 구독이 이어진다(shutdown이나 해제 함수로 정리한다).\n */\n async subscribe(\n handler: WebSocketClusterEnvelopeHandler,\n options: WebSocketClusterSubscribeOptions = {},\n ): Promise<() => void> {\n if (this.closed) {\n throw new Error(\"Redis WebSocket cluster bus is shut down.\");\n }\n this.handlers.set(handler, options);\n const unsubscribe = () => {\n this.handlers.delete(handler);\n if (this.handlers.size === 0) {\n this.dropSubscription();\n }\n };\n await this.ensureSubscribed();\n return unsubscribe;\n }\n\n shutdown(): Promise<void> {\n this.shutdownPromise ??= this.close();\n return this.shutdownPromise;\n }\n\n private async close(): Promise<void> {\n this.closed = true;\n this.handlers.clear();\n await Promise.all([this.releaseSubscription(), this.connection.release(\"bus\")]);\n }\n\n private async releaseSubscription(): Promise<void> {\n if (this.connection.kind === \"sentinel\") {\n // 호출자 Sentinel은 닫지 않으므로 구독만 해제한다. 아직 끝나지 않은 SUBSCRIBE는 완료 시점에 따로 해제한다\n const wasSubscribed = this.subscribed || this.pendingSubscribes > 0;\n this.subscribed = false;\n this.subscribing = undefined;\n if (wasSubscribed) {\n await this.unsubscribeFrom(this.connection.subscriber(ignoreError)).catch(ignoreError);\n }\n return;\n }\n // 어댑터 소유 duplicate()를 닫으면 구독도 함께 사라진다\n this.subscribed = false;\n this.subscribing = undefined;\n await this.connection.closeSubscriber();\n }\n\n private ensureSubscribed(): Promise<void> {\n if (this.subscribed) {\n return Promise.resolve();\n }\n if (!this.subscribing) {\n const subscribing = this.subscribeChannel().then(\n () => {\n if (this.subscribing === subscribing) {\n this.subscribed = true;\n }\n },\n (cause: unknown) => {\n if (this.subscribing === subscribing) {\n this.subscribing = undefined;\n }\n throw cause;\n },\n );\n subscribing.catch(ignoreError);\n this.subscribing = subscribing;\n }\n return this.subscribing;\n }\n\n private async subscribeChannel(): Promise<void> {\n // node-redis는 연결 전 SUBSCRIBE를 큐에 두고 연결 뒤 보내므로, 대기 상한만 어댑터가 정한다\n const { readyTimeoutMs, commandDeadlineMs } = this.connection.options;\n const wait = this.connection.kind === \"sentinel\" ? this.connection.whenUsable() : undefined;\n if (wait) {\n await wait;\n }\n // ready를 기다리는 사이 shutdown됐으면 호출자 연결에 구독을 남기지 않는다\n if (this.closed) {\n throw new Error(\"Redis WebSocket cluster bus is shut down.\");\n }\n const subscriber = this.connection.subscriber(() => {\n this.retrySubscription();\n });\n const sending = subscriber.subscribe(this.channel, this.listener);\n this.watchLateSubscribe(subscriber, sending);\n await withDeadline(\n () => sending,\n wait ? commandDeadlineMs : readyTimeoutMs + commandDeadlineMs,\n );\n }\n\n /**\n * deadline과 무관하게 node-redis SUBSCRIBE가 실제로 끝나는 시점을 본다.\n * 그때 bus가 닫혔거나 더 이상 구독할 핸들러가 없으면 같은 연결에서 바로 구독을 해제하고,\n * 아직 구독이 필요하면 늦게 끝난 구독을 그대로 쓴다.\n */\n private watchLateSubscribe(subscriber: RedisSubscriberTarget, sending: Promise<void>): void {\n this.pendingSubscribes += 1;\n sending\n .then(() => {\n if (this.closed || this.handlers.size === 0) {\n this.unsubscribeFrom(subscriber).catch(ignoreError);\n return;\n }\n this.subscribed = true;\n }, ignoreError)\n .finally(() => {\n this.pendingSubscribes -= 1;\n });\n }\n\n private retrySubscription(): void {\n if (this.closed || this.subscribed || this.subscribing || this.handlers.size === 0) {\n return;\n }\n this.ensureSubscribed().catch(ignoreError);\n }\n\n private dropSubscription(): void {\n if (this.closed) {\n return;\n }\n // 구독한 적이 없으면 보낼 것이 없다. 진행 중인 SUBSCRIBE는 완료 시점에 해제한다\n const wasSubscribed = this.subscribed;\n this.subscribed = false;\n this.subscribing = undefined;\n if (wasSubscribed) {\n this.unsubscribeFrom(this.connection.subscriber(ignoreError)).catch(ignoreError);\n }\n }\n\n private unsubscribeFrom(subscriber: RedisSubscriberTarget): Promise<void> {\n return withDeadline(\n () => subscriber.unsubscribe(this.channel, this.listener),\n this.connection.options.commandDeadlineMs,\n );\n }\n}\n"],"mappings":"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"}
@@ -51,6 +51,8 @@ export declare class RedisWebSocketPresenceStore implements WebSocketPresenceSto
51
51
  clearUserId(sessionId: string): Promise<void>;
52
52
  join(sessionId: string, roomId: WebSocketRoomId): Promise<void>;
53
53
  leave(sessionId: string, roomId: WebSocketRoomId): Promise<void>;
54
+ /** heartbeat 기한 안에 있는 노드 ID만 반환한다. */
55
+ getLiveNodeIds(): Promise<string[]>;
54
56
  /**
55
57
  * nodeId 관점의 라우팅 계획. 원격 노드는 heartbeat가 nodeTimeoutMs 안인 노드 중 audience count가 있는 노드다.
56
58
  * 세션 목록은 읽지 않고, 노드별 count 조회를 한 번의 pipeline으로 보낸다.
@@ -1 +1 @@
1
- {"version":3,"file":"presence-store.d.ts","sourceRoot":"","sources":["../src/presence-store.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"presence-store.d.ts","sourceRoot":"","sources":["../src/presence-store.ts"],"names":[],"mappings":"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"}
@@ -170,6 +170,15 @@ var RedisWebSocketPresenceStore = class {
170
170
  session.rooms.delete(roomId);
171
171
  });
172
172
  }
173
+ /** heartbeat 기한 안에 있는 노드 ID만 반환한다. */
174
+ async getLiveNodeIds() {
175
+ if (this.closing) throw new Error("Redis presence store is shut down.");
176
+ this.start();
177
+ const wait = this.connection.whenUsable();
178
+ if (wait) await wait;
179
+ if (this.closing) throw new Error("Redis presence store is shut down.");
180
+ return this.connection.run((commands) => commands.zRangeByScore(this.nodesKey, Date.now() - this.connection.options.nodeTimeoutMs, "+inf"));
181
+ }
173
182
  /**
174
183
  * nodeId 관점의 라우팅 계획. 원격 노드는 heartbeat가 nodeTimeoutMs 안인 노드 중 audience count가 있는 노드다.
175
184
  * 세션 목록은 읽지 않고, 노드별 count 조회를 한 번의 pipeline으로 보낸다.
@@ -284,15 +293,11 @@ var RedisWebSocketPresenceStore = class {
284
293
  return this.track(wait ? wait.then(execute) : execute());
285
294
  }
286
295
  async countOnLiveNodes(leaves, excludeNodeId) {
287
- if (this.closing) throw new Error("Redis presence store is shut down.");
288
- this.start();
289
- const wait = this.connection.whenUsable();
290
- if (wait) await wait;
291
- if (this.closing) throw new Error("Redis presence store is shut down.");
296
+ const liveNodeIds = await this.getLiveNodeIds();
292
297
  const prefix = this.connection.options.prefix;
293
298
  const leavesJson = JSON.stringify(leaves);
294
299
  return this.connection.run(async (commands, token) => {
295
- const candidates = (await commands.zRangeByScore(this.nodesKey, Date.now() - this.connection.options.nodeTimeoutMs, "+inf")).filter((candidate) => candidate !== excludeNodeId);
300
+ const candidates = liveNodeIds.filter((candidate) => candidate !== excludeNodeId);
296
301
  const counts = await Promise.all(candidates.map((candidate) => {
297
302
  const keys = nodeKeysOf(prefix, candidate);
298
303
  return this.connection.evalScript(commands, token, COUNT_AUDIENCE_SCRIPT, [
@@ -1 +1 @@
1
- {"version":3,"file":"presence-store.js","names":[],"sources":["../src/presence-store.ts"],"sourcesContent":["import {\n parseWebSocketSessionNodeId,\n type WebSocketAudience,\n type WebSocketPresenceRegistration,\n type WebSocketPresenceStore,\n type WebSocketRoomId,\n type WebSocketRoutingPlan,\n type WebSocketUserId,\n} from \"sonamu\";\nimport { z } from \"zod\";\n\nimport { type RedisWebSocketConnection } from \"./connection\";\nimport { APPLY_SESSION_SCRIPT, COUNT_AUDIENCE_SCRIPT, REBUILD_NODE_SCRIPT } from \"./scripts\";\n\nexport type RedisWebSocketPresenceStoreStatus = {\n // 명령용 연결이 지금 ready인지\n ready: boolean;\n // 쓰기 실패나 deadline 초과로 노드 키를 메모리 상태로 다시 써야 하는지\n rebuildPending: boolean;\n};\n\ntype LocalSession = {\n sessionId: string;\n namespace: string;\n active: boolean;\n rooms: Set<WebSocketRoomId>;\n connectedAt: number;\n lastSeenAt: number;\n userId?: WebSocketUserId;\n};\n\n// countAudience 스크립트 조건. namespace가 없으면 스크립트가 그 노드의 활성 namespace로 펼친다\ntype CountLeaf = { k: \"all\"; ns?: string } | { k: \"room\" | \"user\"; ns?: string; id: string };\n\ntype NodeKeys = {\n sessions: string;\n rooms: string;\n users: string;\n namespaces: string;\n};\n\n// MASTER_CHANGE가 짧은 간격으로 여러 번 와도 rebuild를 한 번만 하도록 모으는 창\nconst REBUILD_DEBOUNCE_MS = 200;\n\n/**\n * 노드별 키는 해시태그 `{nodeId}`를 공유해 Redis Cluster에서도 한 slot에 놓인다.\n */\nexport function nodeKeysOf(prefix: string, nodeId: string): NodeKeys {\n return {\n sessions: `${prefix}:{${nodeId}}:sessions`,\n rooms: `${prefix}:{${nodeId}}:rooms`,\n users: `${prefix}:{${nodeId}}:users`,\n namespaces: `${prefix}:{${nodeId}}:namespaces`,\n };\n}\n\n// 타입 태그를 붙여 1과 \"1\"을 다른 사용자로 다룬다\nconst TaggedUserIdSchema = z.union([\n z.number().transform((userId) => `n:${String(userId)}`),\n z.string().transform((userId) => `s:${userId}`),\n]);\n\nfunction tagUserId(userId: WebSocketUserId): string {\n return TaggedUserIdSchema.parse(userId);\n}\n\nfunction serializeSession(session: LocalSession, nodeId: string): string {\n return JSON.stringify({\n sessionId: session.sessionId,\n nodeId,\n namespace: session.namespace,\n active: session.active,\n rooms: [...session.rooms],\n userId: session.userId === undefined ? null : tagUserId(session.userId),\n connectedAt: session.connectedAt,\n lastSeenAt: session.lastSeenAt,\n });\n}\n\n// core와 같이 namespace가 없거나 빈 문자열이면 모든 namespace를 본다\nfunction scopedNamespace(namespace: string | undefined): string | undefined {\n return namespace === \"\" ? undefined : namespace;\n}\n\nfunction matchesNamespace(session: LocalSession, namespace: string | undefined): boolean {\n const scoped = scopedNamespace(namespace);\n return scoped === undefined || session.namespace === scoped;\n}\n\nfunction matchesAudience(session: LocalSession, audience: WebSocketAudience): boolean {\n if (audience.type === \"union\") {\n return audience.audiences.some((child) => matchesAudience(session, child));\n }\n if (!matchesNamespace(session, audience.namespace)) {\n return false;\n }\n if (audience.type === \"room\") {\n return session.rooms.has(audience.roomId);\n }\n if (audience.type === \"user\") {\n // userId는 타입까지 같아야 한다\n return session.userId === audience.userId;\n }\n if (audience.type === \"connections\") {\n return audience.connectionIds.includes(session.sessionId);\n }\n return true;\n}\n\n/**\n * audience를 count 조건과 세션 ID로 라우팅할 노드로 나눈다. connections는 세션 ID에 든 노드 ID만으로 라우팅한다.\n */\nfunction collectRouting(\n audience: WebSocketAudience,\n leaves: CountLeaf[],\n connectionNodeIds: Set<string>,\n): void {\n switch (audience.type) {\n case \"all\":\n leaves.push({ k: \"all\", ns: scopedNamespace(audience.namespace) });\n return;\n case \"room\":\n leaves.push({ k: \"room\", ns: scopedNamespace(audience.namespace), id: audience.roomId });\n return;\n case \"user\":\n leaves.push({\n k: \"user\",\n ns: scopedNamespace(audience.namespace),\n id: tagUserId(audience.userId),\n });\n return;\n case \"connections\":\n for (const sessionId of audience.connectionIds) {\n const nodeId = parseWebSocketSessionNodeId(sessionId);\n if (nodeId !== undefined) {\n connectionNodeIds.add(nodeId);\n }\n }\n return;\n case \"union\":\n for (const child of audience.audiences) {\n collectRouting(child, leaves, connectionNodeIds);\n }\n }\n}\n\n/**\n * node-redis 기반 presence store. 자기 노드 세션의 replica를 Redis에 두고, 다른 노드로의 라우팅과 클러스터 인원수를 제공한다.\n *\n * - 각 mutation은 메모리 snapshot을 즉시 갱신하고, 세션 상태 JSON을 Lua 스크립트 하나(EVALSHA)로 Redis에 반영한다.\n * - 모든 Redis 호출은 commandDeadlineMs 안에 끝난다. 쓰기가 실패하거나 deadline을 넘기면 rebuild 대기가 되고,\n * standalone `ready`, Sentinel `MASTER_CHANGE`, 다음 성공한 heartbeat 중 먼저 오는 시점에 노드 키 전체를 메모리로 다시 쓴다.\n * - heartbeat는 노드 키 TTL과 `<prefix>:nodes` score를 갱신하고 오래된 노드를 정리한다.\n */\nexport class RedisWebSocketPresenceStore implements WebSocketPresenceStore {\n readonly nodeId: string;\n private readonly connection: RedisWebSocketConnection;\n private readonly keys: NodeKeys;\n private readonly nodesKey: string;\n private readonly sessions = new Map<string, LocalSession>();\n private readonly inFlight = new Set<Promise<void>>();\n\n private started = false;\n private closing = false;\n private shutdownPromise: Promise<void> | undefined;\n private heartbeatTimer: ReturnType<typeof setInterval> | undefined;\n private heartbeatRunning = false;\n private rebuildTimer: ReturnType<typeof setTimeout> | undefined;\n private rebuildRunning = false;\n private rebuildRequested = false;\n private rebuildPending = false;\n // 세션 JSON 쓰기가 한 번이라도 성공해 sessions 키가 있어야 하는지. 첫 쓰기보다 먼저 나간 heartbeat를 키 유실로 오인하지 않게 한다\n private sessionsPersisted = false;\n // 아직 끝나지 않은 세션 쓰기 수. 진행 중인 쓰기가 있으면 메모리가 Redis보다 앞서 있을 수 있어 키 유실 판정을 하지 않는다\n private pendingWrites = 0;\n // rebuild 도중 새 쓰기 실패가 생겼는지 구분하기 위한 세대 번호\n private failureGeneration = 0;\n\n /** @internal createRedisWebSocketAdapter가 생성한다. */\n constructor(connection: RedisWebSocketConnection) {\n this.connection = connection;\n this.nodeId = connection.options.nodeId;\n this.keys = nodeKeysOf(connection.options.prefix, this.nodeId);\n this.nodesKey = `${connection.options.prefix}:nodes`;\n connection.onConnectionReady(() => {\n // 재연결 직후 heartbeat를 보내고, 성공하면 대기 중인 rebuild가 이어진다\n this.runHeartbeat();\n });\n connection.onMasterChange(() => {\n // 아직 쓰기 전이면 다시 쓸 키도 없다\n if (!this.started) {\n return;\n }\n // failover에서는 비동기 복제로 직전 쓰기가 유실될 수 있으므로 매번 rebuild를 예약한다\n this.markRebuildPending();\n this.scheduleRebuild();\n });\n }\n\n getStatus(): RedisWebSocketPresenceStoreStatus {\n return { ready: this.connection.isReady, rebuildPending: this.rebuildPending };\n }\n\n register(input: WebSocketPresenceRegistration): Promise<void> {\n if (input.nodeId !== this.nodeId) {\n return Promise.reject(\n new Error(\n `Redis presence store for node ${this.nodeId} cannot register a session of node ${input.nodeId}.`,\n ),\n );\n }\n if (this.closing) {\n return Promise.resolve();\n }\n const connectedAt = input.connectedAt.getTime();\n this.sessions.set(input.sessionId, {\n sessionId: input.sessionId,\n namespace: input.namespace,\n active: input.active,\n rooms: new Set(),\n connectedAt,\n lastSeenAt: connectedAt,\n });\n return this.applySession(input.sessionId);\n }\n\n activate(sessionId: string): Promise<void> {\n return this.mutate(sessionId, (session) => {\n session.active = true;\n });\n }\n\n unregister(sessionId: string): Promise<void> {\n if (this.closing || !this.sessions.delete(sessionId)) {\n return Promise.resolve();\n }\n return this.applySession(sessionId);\n }\n\n setUserId(sessionId: string, userId: WebSocketUserId): Promise<void> {\n return this.mutate(sessionId, (session) => {\n session.userId = userId;\n });\n }\n\n clearUserId(sessionId: string): Promise<void> {\n return this.mutate(sessionId, (session) => {\n delete session.userId;\n });\n }\n\n join(sessionId: string, roomId: WebSocketRoomId): Promise<void> {\n return this.mutate(sessionId, (session) => {\n session.rooms.add(roomId);\n });\n }\n\n leave(sessionId: string, roomId: WebSocketRoomId): Promise<void> {\n return this.mutate(sessionId, (session) => {\n session.rooms.delete(roomId);\n });\n }\n\n /**\n * nodeId 관점의 라우팅 계획. 원격 노드는 heartbeat가 nodeTimeoutMs 안인 노드 중 audience count가 있는 노드다.\n * 세션 목록은 읽지 않고, 노드별 count 조회를 한 번의 pipeline으로 보낸다.\n */\n async resolveRoute(audience: WebSocketAudience, nodeId: string): Promise<WebSocketRoutingPlan> {\n const localSessionIds =\n nodeId === this.nodeId\n ? [...this.sessions.values()]\n .filter((session) => session.active && matchesAudience(session, audience))\n .map((session) => session.sessionId)\n : [];\n\n const leaves: CountLeaf[] = [];\n const remoteNodeIds = new Set<string>();\n collectRouting(audience, leaves, remoteNodeIds);\n\n if (leaves.length > 0) {\n const counts = await this.countOnLiveNodes(leaves, nodeId);\n for (const [candidate, count] of counts) {\n if (count > 0) {\n remoteNodeIds.add(candidate);\n }\n }\n }\n remoteNodeIds.delete(nodeId);\n\n return { localSessionIds, remoteNodeIds: [...remoteNodeIds].toSorted() };\n }\n\n /** 살아 있는 모든 노드의 활성 방 인원수 합계. 자기 노드는 메모리, 원격 노드는 Redis count로 센다. */\n async getRoomMemberCount(roomId: WebSocketRoomId, namespace?: string): Promise<number> {\n // 자기 노드는 메모리에서 센다. Redis 반영이 늦거나(rebuild 대기) 키가 사라져도 자기 노드 인원은 정확하다\n const audience: WebSocketAudience = { type: \"room\", roomId, namespace };\n let total = 0;\n for (const session of this.sessions.values()) {\n if (session.active && matchesAudience(session, audience)) {\n total += 1;\n }\n }\n // 원격 노드만 Redis에서 센다\n const counts = await this.countOnLiveNodes(\n [{ k: \"room\", ns: scopedNamespace(namespace), id: roomId }],\n this.nodeId,\n );\n for (const count of counts.values()) {\n total += count;\n }\n return total;\n }\n\n /**\n * 진행 중인 쓰기를 drainTimeoutMs까지 기다린 뒤 노드 키를 지우고 nodes에서 자기 노드를 뺀다.\n * 이후 들어오는 mutation은 Redis에 쓰지 않으므로 늦은 쓰기가 키를 되살리지 않는다.\n */\n shutdown(): Promise<void> {\n this.shutdownPromise ??= this.close();\n return this.shutdownPromise;\n }\n\n private async close(): Promise<void> {\n // 이 시점부터 아직 보내지 않은 쓰기와 heartbeat는 Redis로 나가지 않는다(prepare 단계에서 closing을 확인한다)\n this.closing = true;\n clearInterval(this.heartbeatTimer);\n clearTimeout(this.rebuildTimer);\n this.rebuildTimer = undefined;\n\n if (this.started) {\n let drainTimer: ReturnType<typeof setTimeout> | undefined;\n try {\n await Promise.race([\n Promise.allSettled(this.inFlight),\n new Promise<void>((resolve) => {\n drainTimer = setTimeout(resolve, this.connection.options.drainTimeoutMs);\n }),\n ]);\n } finally {\n // 빨리 끝난 drain이 event loop를 붙잡지 않게 한다\n clearTimeout(drainTimer);\n }\n // 같은 연결에서 앞서 보낸 늦은 쓰기보다 뒤에 실행되므로 그 쓰기가 만든 키도 함께 지운다\n await this.connection\n .run((commands) =>\n Promise.all([\n commands.del(Object.values(this.keys)),\n commands.zRem(this.nodesKey, this.nodeId),\n ]),\n )\n .catch(() => {});\n }\n this.sessions.clear();\n await this.connection.release(\"store\");\n }\n\n private mutate(sessionId: string, update: (session: LocalSession) => void): Promise<void> {\n const session = this.sessions.get(sessionId);\n if (this.closing || !session) {\n return Promise.resolve();\n }\n update(session);\n session.lastSeenAt = Date.now();\n return this.applySession(sessionId);\n }\n\n /**\n * 세션 하나를 Redis에 반영한다.\n *\n * 불변식: 모든 쓰기(세션 반영과 rebuild)는 명령을 보내는 바로 그 tick의 메모리 상태를 절대값으로 쓴다.\n * - 세션 반영 스크립트는 Redis에 있던 이전 JSON과 새 JSON을 비교해 count를 맞추므로, 같은 상태를 두 번 써도 count가 두 번 변하지 않는다.\n * - 한 연결의 명령은 보낸 순서대로 실행되므로, 나중에 보낸 쓰기일수록 더 최신 메모리를 담는다.\n * rebuild가 먼저 보낸 세션 반영을 덮어써도 rebuild snapshot이 그 변경을 이미 담고 있고,\n * rebuild 뒤에 보낸 세션 반영은 rebuild 결과 위에 최신 상태를 쓴다.\n * - NOSCRIPT 재시도와 ready 대기 뒤에도 snapshot을 다시 만들므로 오래된 상태를 늦게 보내는 일이 없다.\n * 따라서 마지막 쓰기가 성공하면 Redis는 그 시점의 메모리와 같다.\n */\n private applySession(sessionId: string): Promise<void> {\n const keyTtl = String(this.connection.options.keyTtlMs);\n this.pendingWrites += 1;\n const done = () => {\n this.pendingWrites -= 1;\n };\n const writing = this.write(async (commands, token) => {\n let wroteSession = false;\n await this.connection.evalScript(\n commands,\n token,\n APPLY_SESSION_SCRIPT,\n Object.values(this.keys),\n () => {\n if (this.closing) {\n return undefined;\n }\n const session = this.sessions.get(sessionId);\n wroteSession = session !== undefined;\n return [sessionId, session ? serializeSession(session, this.nodeId) : \"\", keyTtl];\n },\n );\n if (wroteSession) {\n this.sessionsPersisted = true;\n }\n });\n writing.then(done, done);\n return writing;\n }\n\n private write(operation: Parameters<RedisWebSocketConnection[\"run\"]>[0]): Promise<void> {\n this.start();\n const wait = this.connection.whenUsable();\n const execute = () =>\n // ready를 기다리는 사이 shutdown이 시작됐으면 정리된 노드 키를 되살리지 않도록 버린다\n this.closing\n ? Promise.resolve()\n : this.connection.run(operation).then(\n () => undefined,\n (cause: unknown) => {\n // 서버에서 실행됐을 수도 있으므로 결과와 무관하게 메모리로 다시 써야 한다\n this.markRebuildPending();\n throw cause;\n },\n );\n return this.track(wait ? wait.then(execute) : execute());\n }\n\n private async countOnLiveNodes(\n leaves: CountLeaf[],\n excludeNodeId?: string,\n ): Promise<Map<string, number>> {\n // shutdown 뒤에는 연결을 새로 시작하거나 ready 대기를 걸지 않는다\n if (this.closing) {\n throw new Error(\"Redis presence store is shut down.\");\n }\n this.start();\n const wait = this.connection.whenUsable();\n if (wait) {\n await wait;\n }\n // ready를 기다리는 사이 shutdown됐으면 조회를 보내지 않는다(런타임은 원격 없이 로컬만 쓴다)\n if (this.closing) {\n throw new Error(\"Redis presence store is shut down.\");\n }\n const prefix = this.connection.options.prefix;\n const leavesJson = JSON.stringify(leaves);\n return this.connection.run(async (commands, token) => {\n const liveNodeIds = await commands.zRangeByScore(\n this.nodesKey,\n Date.now() - this.connection.options.nodeTimeoutMs,\n \"+inf\",\n );\n const candidates = liveNodeIds.filter((candidate) => candidate !== excludeNodeId);\n // 같은 tick에 보내므로 node-redis가 한 번의 pipeline으로 묶어 보낸다\n const counts = await Promise.all(\n candidates.map((candidate) => {\n const keys = nodeKeysOf(prefix, candidate);\n return this.connection.evalScript(\n commands,\n token,\n COUNT_AUDIENCE_SCRIPT,\n [keys.rooms, keys.users, keys.namespaces],\n // NOSCRIPT 재시도 전에 shutdown됐으면 보내지 않는다\n () => (this.closing ? undefined : [leavesJson]),\n );\n }),\n );\n return new Map<string, number>(\n candidates.map((candidate, index) => [candidate, counts[index] ?? 0]),\n );\n });\n }\n\n // 첫 사용 때 연결과 heartbeat를 시작한다\n private start(): void {\n if (this.started || this.closing) {\n return;\n }\n this.started = true;\n this.connection.start();\n this.heartbeatTimer = setInterval(() => {\n this.runHeartbeat();\n }, this.connection.options.heartbeatIntervalMs);\n this.heartbeatTimer.unref();\n // 첫 mutation보다 먼저 보내 nodes에 바로 등록되게 한다\n this.runHeartbeat();\n }\n\n private runHeartbeat(): void {\n if (!this.started || this.closing || this.heartbeatRunning) {\n return;\n }\n this.heartbeatRunning = true;\n const wait = this.connection.whenUsable();\n const execute = (): Promise<boolean | undefined> =>\n this.closing\n ? Promise.resolve(undefined)\n : this.connection.run((commands) => this.sendHeartbeat(commands));\n const heartbeat = (wait ? wait.then(execute) : execute()).then(\n (keysIntact) => {\n if (this.closing) {\n return;\n }\n // 명령 실패 없이 노드 키가 사라진 경우(eviction, FLUSHDB)는 메모리상 있어야 할 키가 없는 것으로 알아챈다\n // 쓰기 실패가 아니므로 failureGeneration은 올리지 않는다. 이 heartbeat보다 뒤에 보낸 rebuild가 성공하면 키가 복구된 것이고,\n // 앞서 보낸 rebuild였다면 다음 heartbeat가 다시 알아챈다\n if (keysIntact === false) {\n this.rebuildPending = true;\n }\n // 연결은 유지된 채 응답만 멈췄다 돌아오면 ready도 MASTER_CHANGE도 없으므로 heartbeat 성공이 rebuild 계기가 된다\n if (this.rebuildPending) {\n this.scheduleRebuild();\n }\n },\n () => {\n // heartbeat가 실패하면 TTL이 갱신되지 않아 키가 만료될 수 있으므로 복구 뒤 다시 써야 한다\n this.markRebuildPending();\n },\n );\n this.track(\n heartbeat.finally(() => {\n this.heartbeatRunning = false;\n }),\n );\n }\n\n /**\n * nodes score와 키 TTL을 한 번의 pipeline으로 갱신한다.\n * 노드 키 4개의 PEXPIRE 결과(키가 있었는지)를 메모리상 있어야 할 키와 비교해 키 유실을 별도 왕복 없이 알아챈다.\n * 있어야 할 키가 하나라도 없었으면 false를 돌려준다.\n */\n private async sendHeartbeat(\n commands: Parameters<Parameters<RedisWebSocketConnection[\"run\"]>[0]>[0],\n ): Promise<boolean> {\n const now = Date.now();\n const { keyTtlMs } = this.connection.options;\n // 기대값은 명령을 보내는 시점의 메모리로 정한다. 같은 연결의 앞선 쓰기는 이 PEXPIRE보다 먼저 실행된다\n const expected = this.expectedNodeKeys();\n const [sessions, rooms, users, namespaces] = await Promise.all([\n commands.pExpire(this.keys.sessions, keyTtlMs),\n commands.pExpire(this.keys.rooms, keyTtlMs),\n commands.pExpire(this.keys.users, keyTtlMs),\n commands.pExpire(this.keys.namespaces, keyTtlMs),\n commands.zAdd(this.nodesKey, now, this.nodeId),\n // keyTtlMs가 지난 노드는 키도 만료됐으므로 live-node set에서 정리해 크기를 제한한다\n commands.zRemRangeByScore(this.nodesKey, \"-inf\", now - keyTtlMs),\n commands.pExpire(this.nodesKey, keyTtlMs),\n ]);\n if (expected === undefined) {\n return true;\n }\n return (\n (sessions || !expected.sessions) &&\n (rooms || !expected.rooms) &&\n (users || !expected.users) &&\n (namespaces || !expected.namespaces)\n );\n }\n\n /**\n * 메모리 상태에서 Redis에 반드시 있어야 할 노드 키를 Lua 스크립트 규칙대로 계산한다.\n * - sessions: 세션이 하나라도 있으면(비활성 포함) 있다\n * - namespaces: 활성 세션이 하나라도 있으면 있다\n * - rooms: 방에 들어간 활성 세션이 있으면 있다\n * - users: userId가 있는 활성 세션이 있으면 있다\n * 아직 세션을 쓴 적이 없거나 끝나지 않은 쓰기가 있으면 메모리가 Redis보다 앞서 있을 수 있으므로 판정하지 않는다(undefined).\n * 반대 방향(메모리상 없어야 할 키가 있음)은 eviction으로 생기지 않으므로 보지 않는다.\n */\n private expectedNodeKeys():\n | { sessions: boolean; rooms: boolean; users: boolean; namespaces: boolean }\n | undefined {\n if (!this.sessionsPersisted || this.pendingWrites > 0) {\n return undefined;\n }\n const expected = {\n sessions: this.sessions.size > 0,\n rooms: false,\n users: false,\n namespaces: false,\n };\n for (const session of this.sessions.values()) {\n if (!session.active) {\n continue;\n }\n expected.namespaces = true;\n if (session.rooms.size > 0) {\n expected.rooms = true;\n }\n if (session.userId !== undefined) {\n expected.users = true;\n }\n }\n return expected;\n }\n\n private markRebuildPending(): void {\n if (this.closing) {\n return;\n }\n this.rebuildPending = true;\n this.failureGeneration += 1;\n }\n\n /**\n * 짧은 간격의 계기를 하나로 모은다. 첫 계기부터 REBUILD_DEBOUNCE_MS 뒤에 실행하고, 그 사이의 계기는 타이머를 다시 걸지 않는다.\n * 계기가 debounce보다 자주 와도(짧은 heartbeat 주기, 반복 이벤트) rebuild가 무한히 밀리지 않는다.\n */\n private scheduleRebuild(): void {\n if (this.closing || this.rebuildTimer !== undefined) {\n return;\n }\n this.rebuildTimer = setTimeout(() => {\n this.rebuildTimer = undefined;\n this.rebuild();\n }, REBUILD_DEBOUNCE_MS);\n this.rebuildTimer.unref();\n }\n\n /**\n * 노드 키를 메모리 snapshot으로 다시 쓴다. 이미 진행 중이면 끝난 뒤 한 번 더 실행해 마지막 계기를 놓치지 않는다.\n */\n private rebuild(): void {\n if (this.closing) {\n return;\n }\n if (this.rebuildRunning) {\n this.rebuildRequested = true;\n return;\n }\n this.rebuildRunning = true;\n const generation = this.failureGeneration;\n const keyTtl = String(this.connection.options.keyTtlMs);\n\n const rebuilding = this.connection\n .run(async (commands, token) => {\n let wroteSessions = false;\n // snapshot은 보내기 직전에 만든다(applySession의 불변식 참고)\n await this.connection.evalScript(\n commands,\n token,\n REBUILD_NODE_SCRIPT,\n Object.values(this.keys),\n () => {\n if (this.closing) {\n return undefined;\n }\n const args = [keyTtl];\n for (const session of this.sessions.values()) {\n args.push(session.sessionId, serializeSession(session, this.nodeId));\n }\n wroteSessions = this.sessions.size > 0;\n return args;\n },\n );\n if (wroteSessions) {\n this.sessionsPersisted = true;\n }\n if (this.closing) {\n return true;\n }\n return this.sendHeartbeat(commands);\n })\n .then(\n (keysIntact) => {\n if (!keysIntact) {\n // rebuild 직후 heartbeat가 키 유실을 확인했으면 대기를 유지하고 debounce를 거쳐 다시 rebuild한다\n this.rebuildPending = true;\n this.scheduleRebuild();\n return;\n }\n // rebuild 도중 새 쓰기 실패가 없었을 때만 대기를 해제한다\n if (generation === this.failureGeneration) {\n this.rebuildPending = false;\n }\n },\n () => {\n this.markRebuildPending();\n },\n )\n .finally(() => {\n this.rebuildRunning = false;\n // 진행 중에 들어온 계기는 아직 복구할 것이 남은 경우에만 다시 실행한다\n if (this.rebuildRequested) {\n this.rebuildRequested = false;\n if (this.rebuildPending) {\n this.scheduleRebuild();\n }\n }\n });\n this.track(rebuilding);\n }\n\n private track(promise: Promise<void>): Promise<void> {\n this.inFlight.add(promise);\n const forget = () => {\n this.inFlight.delete(promise);\n };\n promise.then(forget, forget);\n return promise;\n }\n}\n"],"mappings":";;;;AA0CA,MAAM,sBAAsB;;;;AAK5B,SAAgB,WAAW,QAAgB,QAA0B;CACnE,OAAO;EACL,UAAU,GAAG,OAAO,IAAI,OAAO;EAC/B,OAAO,GAAG,OAAO,IAAI,OAAO;EAC5B,OAAO,GAAG,OAAO,IAAI,OAAO;EAC5B,YAAY,GAAG,OAAO,IAAI,OAAO;CACnC;AACF;AAGA,MAAM,qBAAqB,EAAE,MAAM,CACjC,EAAE,OAAO,CAAC,CAAC,WAAW,WAAW,KAAK,OAAO,MAAM,GAAG,GACtD,EAAE,OAAO,CAAC,CAAC,WAAW,WAAW,KAAK,QAAQ,CAChD,CAAC;AAED,SAAS,UAAU,QAAiC;CAClD,OAAO,mBAAmB,MAAM,MAAM;AACxC;AAEA,SAAS,iBAAiB,SAAuB,QAAwB;CACvE,OAAO,KAAK,UAAU;EACpB,WAAW,QAAQ;EACnB;EACA,WAAW,QAAQ;EACnB,QAAQ,QAAQ;EAChB,OAAO,CAAC,GAAG,QAAQ,KAAK;EACxB,QAAQ,QAAQ,WAAW,KAAA,IAAY,OAAO,UAAU,QAAQ,MAAM;EACtE,aAAa,QAAQ;EACrB,YAAY,QAAQ;CACtB,CAAC;AACH;AAGA,SAAS,gBAAgB,WAAmD;CAC1E,OAAO,cAAc,KAAK,KAAA,IAAY;AACxC;AAEA,SAAS,iBAAiB,SAAuB,WAAwC;CACvF,MAAM,SAAS,gBAAgB,SAAS;CACxC,OAAO,WAAW,KAAA,KAAa,QAAQ,cAAc;AACvD;AAEA,SAAS,gBAAgB,SAAuB,UAAsC;CACpF,IAAI,SAAS,SAAS,SACpB,OAAO,SAAS,UAAU,MAAM,UAAU,gBAAgB,SAAS,KAAK,CAAC;CAE3E,IAAI,CAAC,iBAAiB,SAAS,SAAS,SAAS,GAC/C,OAAO;CAET,IAAI,SAAS,SAAS,QACpB,OAAO,QAAQ,MAAM,IAAI,SAAS,MAAM;CAE1C,IAAI,SAAS,SAAS,QAEpB,OAAO,QAAQ,WAAW,SAAS;CAErC,IAAI,SAAS,SAAS,eACpB,OAAO,SAAS,cAAc,SAAS,QAAQ,SAAS;CAE1D,OAAO;AACT;;;;AAKA,SAAS,eACP,UACA,QACA,mBACM;CACN,QAAQ,SAAS,MAAjB;EACE,KAAK;GACH,OAAO,KAAK;IAAE,GAAG;IAAO,IAAI,gBAAgB,SAAS,SAAS;GAAE,CAAC;GACjE;EACF,KAAK;GACH,OAAO,KAAK;IAAE,GAAG;IAAQ,IAAI,gBAAgB,SAAS,SAAS;IAAG,IAAI,SAAS;GAAO,CAAC;GACvF;EACF,KAAK;GACH,OAAO,KAAK;IACV,GAAG;IACH,IAAI,gBAAgB,SAAS,SAAS;IACtC,IAAI,UAAU,SAAS,MAAM;GAC/B,CAAC;GACD;EACF,KAAK;GACH,KAAK,MAAM,aAAa,SAAS,eAAe;IAC9C,MAAM,SAAS,4BAA4B,SAAS;IACpD,IAAI,WAAW,KAAA,GACb,kBAAkB,IAAI,MAAM;GAEhC;GACA;EACF,KAAK,SACH,KAAK,MAAM,SAAS,SAAS,WAC3B,eAAe,OAAO,QAAQ,iBAAiB;CAErD;AACF;;;;;;;;;AAUA,IAAa,8BAAb,MAA2E;CACzE;CACA;CACA;CACA;CACA,2BAA4B,IAAI,IAA0B;CAC1D,2BAA4B,IAAI,IAAmB;CAEnD,UAAkB;CAClB,UAAkB;CAClB;CACA;CACA,mBAA2B;CAC3B;CACA,iBAAyB;CACzB,mBAA2B;CAC3B,iBAAyB;CAEzB,oBAA4B;CAE5B,gBAAwB;CAExB,oBAA4B;;CAG5B,YAAY,YAAsC;EAChD,KAAK,aAAa;EAClB,KAAK,SAAS,WAAW,QAAQ;EACjC,KAAK,OAAO,WAAW,WAAW,QAAQ,QAAQ,KAAK,MAAM;EAC7D,KAAK,WAAW,GAAG,WAAW,QAAQ,OAAO;EAC7C,WAAW,wBAAwB;GAEjC,KAAK,aAAa;EACpB,CAAC;EACD,WAAW,qBAAqB;GAE9B,IAAI,CAAC,KAAK,SACR;GAGF,KAAK,mBAAmB;GACxB,KAAK,gBAAgB;EACvB,CAAC;CACH;CAEA,YAA+C;EAC7C,OAAO;GAAE,OAAO,KAAK,WAAW;GAAS,gBAAgB,KAAK;EAAe;CAC/E;CAEA,SAAS,OAAqD;EAC5D,IAAI,MAAM,WAAW,KAAK,QACxB,OAAO,QAAQ,uBACb,IAAI,MACF,iCAAiC,KAAK,OAAO,qCAAqC,MAAM,OAAO,EACjG,CACF;EAEF,IAAI,KAAK,SACP,OAAO,QAAQ,QAAQ;EAEzB,MAAM,cAAc,MAAM,YAAY,QAAQ;EAC9C,KAAK,SAAS,IAAI,MAAM,WAAW;GACjC,WAAW,MAAM;GACjB,WAAW,MAAM;GACjB,QAAQ,MAAM;GACd,uBAAO,IAAI,IAAI;GACf;GACA,YAAY;EACd,CAAC;EACD,OAAO,KAAK,aAAa,MAAM,SAAS;CAC1C;CAEA,SAAS,WAAkC;EACzC,OAAO,KAAK,OAAO,YAAY,YAAY;GACzC,QAAQ,SAAS;EACnB,CAAC;CACH;CAEA,WAAW,WAAkC;EAC3C,IAAI,KAAK,WAAW,CAAC,KAAK,SAAS,OAAO,SAAS,GACjD,OAAO,QAAQ,QAAQ;EAEzB,OAAO,KAAK,aAAa,SAAS;CACpC;CAEA,UAAU,WAAmB,QAAwC;EACnE,OAAO,KAAK,OAAO,YAAY,YAAY;GACzC,QAAQ,SAAS;EACnB,CAAC;CACH;CAEA,YAAY,WAAkC;EAC5C,OAAO,KAAK,OAAO,YAAY,YAAY;GACzC,OAAO,QAAQ;EACjB,CAAC;CACH;CAEA,KAAK,WAAmB,QAAwC;EAC9D,OAAO,KAAK,OAAO,YAAY,YAAY;GACzC,QAAQ,MAAM,IAAI,MAAM;EAC1B,CAAC;CACH;CAEA,MAAM,WAAmB,QAAwC;EAC/D,OAAO,KAAK,OAAO,YAAY,YAAY;GACzC,QAAQ,MAAM,OAAO,MAAM;EAC7B,CAAC;CACH;;;;;CAMA,MAAM,aAAa,UAA6B,QAA+C;EAC7F,MAAM,kBACJ,WAAW,KAAK,SACZ,CAAC,GAAG,KAAK,SAAS,OAAO,CAAC,CAAC,CACxB,QAAQ,YAAY,QAAQ,UAAU,gBAAgB,SAAS,QAAQ,CAAC,CAAC,CACzE,KAAK,YAAY,QAAQ,SAAS,IACrC,CAAC;EAEP,MAAM,SAAsB,CAAC;EAC7B,MAAM,gCAAgB,IAAI,IAAY;EACtC,eAAe,UAAU,QAAQ,aAAa;EAE9C,IAAI,OAAO,SAAS,GAAG;GACrB,MAAM,SAAS,MAAM,KAAK,iBAAiB,QAAQ,MAAM;GACzD,KAAK,MAAM,CAAC,WAAW,UAAU,QAC/B,IAAI,QAAQ,GACV,cAAc,IAAI,SAAS;EAGjC;EACA,cAAc,OAAO,MAAM;EAE3B,OAAO;GAAE;GAAiB,eAAe,CAAC,GAAG,aAAa,CAAC,CAAC,SAAS;EAAE;CACzE;;CAGA,MAAM,mBAAmB,QAAyB,WAAqC;EAErF,MAAM,WAA8B;GAAE,MAAM;GAAQ;GAAQ;EAAU;EACtE,IAAI,QAAQ;EACZ,KAAK,MAAM,WAAW,KAAK,SAAS,OAAO,GACzC,IAAI,QAAQ,UAAU,gBAAgB,SAAS,QAAQ,GACrD,SAAS;EAIb,MAAM,SAAS,MAAM,KAAK,iBACxB,CAAC;GAAE,GAAG;GAAQ,IAAI,gBAAgB,SAAS;GAAG,IAAI;EAAO,CAAC,GAC1D,KAAK,MACP;EACA,KAAK,MAAM,SAAS,OAAO,OAAO,GAChC,SAAS;EAEX,OAAO;CACT;;;;;CAMA,WAA0B;EACxB,KAAK,oBAAoB,KAAK,MAAM;EACpC,OAAO,KAAK;CACd;CAEA,MAAc,QAAuB;EAEnC,KAAK,UAAU;EACf,cAAc,KAAK,cAAc;EACjC,aAAa,KAAK,YAAY;EAC9B,KAAK,eAAe,KAAA;EAEpB,IAAI,KAAK,SAAS;GAChB,IAAI;GACJ,IAAI;IACF,MAAM,QAAQ,KAAK,CACjB,QAAQ,WAAW,KAAK,QAAQ,GAChC,IAAI,SAAe,YAAY;KAC7B,aAAa,WAAW,SAAS,KAAK,WAAW,QAAQ,cAAc;IACzE,CAAC,CACH,CAAC;GACH,UAAU;IAER,aAAa,UAAU;GACzB;GAEA,MAAM,KAAK,WACR,KAAK,aACJ,QAAQ,IAAI,CACV,SAAS,IAAI,OAAO,OAAO,KAAK,IAAI,CAAC,GACrC,SAAS,KAAK,KAAK,UAAU,KAAK,MAAM,CAC1C,CAAC,CACH,CAAC,CACA,YAAY,CAAC,CAAC;EACnB;EACA,KAAK,SAAS,MAAM;EACpB,MAAM,KAAK,WAAW,QAAQ,OAAO;CACvC;CAEA,OAAe,WAAmB,QAAwD;EACxF,MAAM,UAAU,KAAK,SAAS,IAAI,SAAS;EAC3C,IAAI,KAAK,WAAW,CAAC,SACnB,OAAO,QAAQ,QAAQ;EAEzB,OAAO,OAAO;EACd,QAAQ,aAAa,KAAK,IAAI;EAC9B,OAAO,KAAK,aAAa,SAAS;CACpC;;;;;;;;;;;;CAaA,aAAqB,WAAkC;EACrD,MAAM,SAAS,OAAO,KAAK,WAAW,QAAQ,QAAQ;EACtD,KAAK,iBAAiB;EACtB,MAAM,aAAa;GACjB,KAAK,iBAAiB;EACxB;EACA,MAAM,UAAU,KAAK,MAAM,OAAO,UAAU,UAAU;GACpD,IAAI,eAAe;GACnB,MAAM,KAAK,WAAW,WACpB,UACA,OACA,sBACA,OAAO,OAAO,KAAK,IAAI,SACjB;IACJ,IAAI,KAAK,SACP;IAEF,MAAM,UAAU,KAAK,SAAS,IAAI,SAAS;IAC3C,eAAe,YAAY,KAAA;IAC3B,OAAO;KAAC;KAAW,UAAU,iBAAiB,SAAS,KAAK,MAAM,IAAI;KAAI;IAAM;GAClF,CACF;GACA,IAAI,cACF,KAAK,oBAAoB;EAE7B,CAAC;EACD,QAAQ,KAAK,MAAM,IAAI;EACvB,OAAO;CACT;CAEA,MAAc,WAA0E;EACtF,KAAK,MAAM;EACX,MAAM,OAAO,KAAK,WAAW,WAAW;EACxC,MAAM,gBAEJ,KAAK,UACD,QAAQ,QAAQ,IAChB,KAAK,WAAW,IAAI,SAAS,CAAC,CAAC,WACvB,KAAA,IACL,UAAmB;GAElB,KAAK,mBAAmB;GACxB,MAAM;EACR,CACF;EACN,OAAO,KAAK,MAAM,OAAO,KAAK,KAAK,OAAO,IAAI,QAAQ,CAAC;CACzD;CAEA,MAAc,iBACZ,QACA,eAC8B;EAE9B,IAAI,KAAK,SACP,MAAM,IAAI,MAAM,oCAAoC;EAEtD,KAAK,MAAM;EACX,MAAM,OAAO,KAAK,WAAW,WAAW;EACxC,IAAI,MACF,MAAM;EAGR,IAAI,KAAK,SACP,MAAM,IAAI,MAAM,oCAAoC;EAEtD,MAAM,SAAS,KAAK,WAAW,QAAQ;EACvC,MAAM,aAAa,KAAK,UAAU,MAAM;EACxC,OAAO,KAAK,WAAW,IAAI,OAAO,UAAU,UAAU;GAMpD,MAAM,cAAa,MALO,SAAS,cACjC,KAAK,UACL,KAAK,IAAI,IAAI,KAAK,WAAW,QAAQ,eACrC,MACF,EAAA,CAC+B,QAAQ,cAAc,cAAc,aAAa;GAEhF,MAAM,SAAS,MAAM,QAAQ,IAC3B,WAAW,KAAK,cAAc;IAC5B,MAAM,OAAO,WAAW,QAAQ,SAAS;IACzC,OAAO,KAAK,WAAW,WACrB,UACA,OACA,uBACA;KAAC,KAAK;KAAO,KAAK;KAAO,KAAK;IAAU,SAEjC,KAAK,UAAU,KAAA,IAAY,CAAC,UAAU,CAC/C;GACF,CAAC,CACH;GACA,OAAO,IAAI,IACT,WAAW,KAAK,WAAW,UAAU,CAAC,WAAW,OAAO,UAAU,CAAC,CAAC,CACtE;EACF,CAAC;CACH;CAGA,QAAsB;EACpB,IAAI,KAAK,WAAW,KAAK,SACvB;EAEF,KAAK,UAAU;EACf,KAAK,WAAW,MAAM;EACtB,KAAK,iBAAiB,kBAAkB;GACtC,KAAK,aAAa;EACpB,GAAG,KAAK,WAAW,QAAQ,mBAAmB;EAC9C,KAAK,eAAe,MAAM;EAE1B,KAAK,aAAa;CACpB;CAEA,eAA6B;EAC3B,IAAI,CAAC,KAAK,WAAW,KAAK,WAAW,KAAK,kBACxC;EAEF,KAAK,mBAAmB;EACxB,MAAM,OAAO,KAAK,WAAW,WAAW;EACxC,MAAM,gBACJ,KAAK,UACD,QAAQ,QAAQ,KAAA,CAAS,IACzB,KAAK,WAAW,KAAK,aAAa,KAAK,cAAc,QAAQ,CAAC;EACpE,MAAM,aAAa,OAAO,KAAK,KAAK,OAAO,IAAI,QAAQ,EAAA,CAAG,MACvD,eAAe;GACd,IAAI,KAAK,SACP;GAKF,IAAI,eAAe,OACjB,KAAK,iBAAiB;GAGxB,IAAI,KAAK,gBACP,KAAK,gBAAgB;EAEzB,SACM;GAEJ,KAAK,mBAAmB;EAC1B,CACF;EACA,KAAK,MACH,UAAU,cAAc;GACtB,KAAK,mBAAmB;EAC1B,CAAC,CACH;CACF;;;;;;CAOA,MAAc,cACZ,UACkB;EAClB,MAAM,MAAM,KAAK,IAAI;EACrB,MAAM,EAAE,aAAa,KAAK,WAAW;EAErC,MAAM,WAAW,KAAK,iBAAiB;EACvC,MAAM,CAAC,UAAU,OAAO,OAAO,cAAc,MAAM,QAAQ,IAAI;GAC7D,SAAS,QAAQ,KAAK,KAAK,UAAU,QAAQ;GAC7C,SAAS,QAAQ,KAAK,KAAK,OAAO,QAAQ;GAC1C,SAAS,QAAQ,KAAK,KAAK,OAAO,QAAQ;GAC1C,SAAS,QAAQ,KAAK,KAAK,YAAY,QAAQ;GAC/C,SAAS,KAAK,KAAK,UAAU,KAAK,KAAK,MAAM;GAE7C,SAAS,iBAAiB,KAAK,UAAU,QAAQ,MAAM,QAAQ;GAC/D,SAAS,QAAQ,KAAK,UAAU,QAAQ;EAC1C,CAAC;EACD,IAAI,aAAa,KAAA,GACf,OAAO;EAET,QACG,YAAY,CAAC,SAAS,cACtB,SAAS,CAAC,SAAS,WACnB,SAAS,CAAC,SAAS,WACnB,cAAc,CAAC,SAAS;CAE7B;;;;;;;;;;CAWA,mBAEc;EACZ,IAAI,CAAC,KAAK,qBAAqB,KAAK,gBAAgB,GAClD;EAEF,MAAM,WAAW;GACf,UAAU,KAAK,SAAS,OAAO;GAC/B,OAAO;GACP,OAAO;GACP,YAAY;EACd;EACA,KAAK,MAAM,WAAW,KAAK,SAAS,OAAO,GAAG;GAC5C,IAAI,CAAC,QAAQ,QACX;GAEF,SAAS,aAAa;GACtB,IAAI,QAAQ,MAAM,OAAO,GACvB,SAAS,QAAQ;GAEnB,IAAI,QAAQ,WAAW,KAAA,GACrB,SAAS,QAAQ;EAErB;EACA,OAAO;CACT;CAEA,qBAAmC;EACjC,IAAI,KAAK,SACP;EAEF,KAAK,iBAAiB;EACtB,KAAK,qBAAqB;CAC5B;;;;;CAMA,kBAAgC;EAC9B,IAAI,KAAK,WAAW,KAAK,iBAAiB,KAAA,GACxC;EAEF,KAAK,eAAe,iBAAiB;GACnC,KAAK,eAAe,KAAA;GACpB,KAAK,QAAQ;EACf,GAAG,mBAAmB;EACtB,KAAK,aAAa,MAAM;CAC1B;;;;CAKA,UAAwB;EACtB,IAAI,KAAK,SACP;EAEF,IAAI,KAAK,gBAAgB;GACvB,KAAK,mBAAmB;GACxB;EACF;EACA,KAAK,iBAAiB;EACtB,MAAM,aAAa,KAAK;EACxB,MAAM,SAAS,OAAO,KAAK,WAAW,QAAQ,QAAQ;EAEtD,MAAM,aAAa,KAAK,WACrB,IAAI,OAAO,UAAU,UAAU;GAC9B,IAAI,gBAAgB;GAEpB,MAAM,KAAK,WAAW,WACpB,UACA,OACA,qBACA,OAAO,OAAO,KAAK,IAAI,SACjB;IACJ,IAAI,KAAK,SACP;IAEF,MAAM,OAAO,CAAC,MAAM;IACpB,KAAK,MAAM,WAAW,KAAK,SAAS,OAAO,GACzC,KAAK,KAAK,QAAQ,WAAW,iBAAiB,SAAS,KAAK,MAAM,CAAC;IAErE,gBAAgB,KAAK,SAAS,OAAO;IACrC,OAAO;GACT,CACF;GACA,IAAI,eACF,KAAK,oBAAoB;GAE3B,IAAI,KAAK,SACP,OAAO;GAET,OAAO,KAAK,cAAc,QAAQ;EACpC,CAAC,CAAC,CACD,MACE,eAAe;GACd,IAAI,CAAC,YAAY;IAEf,KAAK,iBAAiB;IACtB,KAAK,gBAAgB;IACrB;GACF;GAEA,IAAI,eAAe,KAAK,mBACtB,KAAK,iBAAiB;EAE1B,SACM;GACJ,KAAK,mBAAmB;EAC1B,CACF,CAAC,CACA,cAAc;GACb,KAAK,iBAAiB;GAEtB,IAAI,KAAK,kBAAkB;IACzB,KAAK,mBAAmB;IACxB,IAAI,KAAK,gBACP,KAAK,gBAAgB;GAEzB;EACF,CAAC;EACH,KAAK,MAAM,UAAU;CACvB;CAEA,MAAc,SAAuC;EACnD,KAAK,SAAS,IAAI,OAAO;EACzB,MAAM,eAAe;GACnB,KAAK,SAAS,OAAO,OAAO;EAC9B;EACA,QAAQ,KAAK,QAAQ,MAAM;EAC3B,OAAO;CACT;AACF"}
1
+ {"version":3,"file":"presence-store.js","names":[],"sources":["../src/presence-store.ts"],"sourcesContent":["import {\n parseWebSocketSessionNodeId,\n type WebSocketAudience,\n type WebSocketPresenceRegistration,\n type WebSocketPresenceStore,\n type WebSocketRoomId,\n type WebSocketRoutingPlan,\n type WebSocketUserId,\n} from \"sonamu\";\nimport { z } from \"zod\";\n\nimport { type RedisWebSocketConnection } from \"./connection\";\nimport { APPLY_SESSION_SCRIPT, COUNT_AUDIENCE_SCRIPT, REBUILD_NODE_SCRIPT } from \"./scripts\";\n\nexport type RedisWebSocketPresenceStoreStatus = {\n // 명령용 연결이 지금 ready인지\n ready: boolean;\n // 쓰기 실패나 deadline 초과로 노드 키를 메모리 상태로 다시 써야 하는지\n rebuildPending: boolean;\n};\n\ntype LocalSession = {\n sessionId: string;\n namespace: string;\n active: boolean;\n rooms: Set<WebSocketRoomId>;\n connectedAt: number;\n lastSeenAt: number;\n userId?: WebSocketUserId;\n};\n\n// countAudience 스크립트 조건. namespace가 없으면 스크립트가 그 노드의 활성 namespace로 펼친다\ntype CountLeaf = { k: \"all\"; ns?: string } | { k: \"room\" | \"user\"; ns?: string; id: string };\n\ntype NodeKeys = {\n sessions: string;\n rooms: string;\n users: string;\n namespaces: string;\n};\n\n// MASTER_CHANGE가 짧은 간격으로 여러 번 와도 rebuild를 한 번만 하도록 모으는 창\nconst REBUILD_DEBOUNCE_MS = 200;\n\n/**\n * 노드별 키는 해시태그 `{nodeId}`를 공유해 Redis Cluster에서도 한 slot에 놓인다.\n */\nexport function nodeKeysOf(prefix: string, nodeId: string): NodeKeys {\n return {\n sessions: `${prefix}:{${nodeId}}:sessions`,\n rooms: `${prefix}:{${nodeId}}:rooms`,\n users: `${prefix}:{${nodeId}}:users`,\n namespaces: `${prefix}:{${nodeId}}:namespaces`,\n };\n}\n\n// 타입 태그를 붙여 1과 \"1\"을 다른 사용자로 다룬다\nconst TaggedUserIdSchema = z.union([\n z.number().transform((userId) => `n:${String(userId)}`),\n z.string().transform((userId) => `s:${userId}`),\n]);\n\nfunction tagUserId(userId: WebSocketUserId): string {\n return TaggedUserIdSchema.parse(userId);\n}\n\nfunction serializeSession(session: LocalSession, nodeId: string): string {\n return JSON.stringify({\n sessionId: session.sessionId,\n nodeId,\n namespace: session.namespace,\n active: session.active,\n rooms: [...session.rooms],\n userId: session.userId === undefined ? null : tagUserId(session.userId),\n connectedAt: session.connectedAt,\n lastSeenAt: session.lastSeenAt,\n });\n}\n\n// core와 같이 namespace가 없거나 빈 문자열이면 모든 namespace를 본다\nfunction scopedNamespace(namespace: string | undefined): string | undefined {\n return namespace === \"\" ? undefined : namespace;\n}\n\nfunction matchesNamespace(session: LocalSession, namespace: string | undefined): boolean {\n const scoped = scopedNamespace(namespace);\n return scoped === undefined || session.namespace === scoped;\n}\n\nfunction matchesAudience(session: LocalSession, audience: WebSocketAudience): boolean {\n if (audience.type === \"union\") {\n return audience.audiences.some((child) => matchesAudience(session, child));\n }\n if (!matchesNamespace(session, audience.namespace)) {\n return false;\n }\n if (audience.type === \"room\") {\n return session.rooms.has(audience.roomId);\n }\n if (audience.type === \"user\") {\n // userId는 타입까지 같아야 한다\n return session.userId === audience.userId;\n }\n if (audience.type === \"connections\") {\n return audience.connectionIds.includes(session.sessionId);\n }\n return true;\n}\n\n/**\n * audience를 count 조건과 세션 ID로 라우팅할 노드로 나눈다. connections는 세션 ID에 든 노드 ID만으로 라우팅한다.\n */\nfunction collectRouting(\n audience: WebSocketAudience,\n leaves: CountLeaf[],\n connectionNodeIds: Set<string>,\n): void {\n switch (audience.type) {\n case \"all\":\n leaves.push({ k: \"all\", ns: scopedNamespace(audience.namespace) });\n return;\n case \"room\":\n leaves.push({ k: \"room\", ns: scopedNamespace(audience.namespace), id: audience.roomId });\n return;\n case \"user\":\n leaves.push({\n k: \"user\",\n ns: scopedNamespace(audience.namespace),\n id: tagUserId(audience.userId),\n });\n return;\n case \"connections\":\n for (const sessionId of audience.connectionIds) {\n const nodeId = parseWebSocketSessionNodeId(sessionId);\n if (nodeId !== undefined) {\n connectionNodeIds.add(nodeId);\n }\n }\n return;\n case \"union\":\n for (const child of audience.audiences) {\n collectRouting(child, leaves, connectionNodeIds);\n }\n }\n}\n\n/**\n * node-redis 기반 presence store. 자기 노드 세션의 replica를 Redis에 두고, 다른 노드로의 라우팅과 클러스터 인원수를 제공한다.\n *\n * - 각 mutation은 메모리 snapshot을 즉시 갱신하고, 세션 상태 JSON을 Lua 스크립트 하나(EVALSHA)로 Redis에 반영한다.\n * - 모든 Redis 호출은 commandDeadlineMs 안에 끝난다. 쓰기가 실패하거나 deadline을 넘기면 rebuild 대기가 되고,\n * standalone `ready`, Sentinel `MASTER_CHANGE`, 다음 성공한 heartbeat 중 먼저 오는 시점에 노드 키 전체를 메모리로 다시 쓴다.\n * - heartbeat는 노드 키 TTL과 `<prefix>:nodes` score를 갱신하고 오래된 노드를 정리한다.\n */\nexport class RedisWebSocketPresenceStore implements WebSocketPresenceStore {\n readonly nodeId: string;\n private readonly connection: RedisWebSocketConnection;\n private readonly keys: NodeKeys;\n private readonly nodesKey: string;\n private readonly sessions = new Map<string, LocalSession>();\n private readonly inFlight = new Set<Promise<void>>();\n\n private started = false;\n private closing = false;\n private shutdownPromise: Promise<void> | undefined;\n private heartbeatTimer: ReturnType<typeof setInterval> | undefined;\n private heartbeatRunning = false;\n private rebuildTimer: ReturnType<typeof setTimeout> | undefined;\n private rebuildRunning = false;\n private rebuildRequested = false;\n private rebuildPending = false;\n // 세션 JSON 쓰기가 한 번이라도 성공해 sessions 키가 있어야 하는지. 첫 쓰기보다 먼저 나간 heartbeat를 키 유실로 오인하지 않게 한다\n private sessionsPersisted = false;\n // 아직 끝나지 않은 세션 쓰기 수. 진행 중인 쓰기가 있으면 메모리가 Redis보다 앞서 있을 수 있어 키 유실 판정을 하지 않는다\n private pendingWrites = 0;\n // rebuild 도중 새 쓰기 실패가 생겼는지 구분하기 위한 세대 번호\n private failureGeneration = 0;\n\n /** @internal createRedisWebSocketAdapter가 생성한다. */\n constructor(connection: RedisWebSocketConnection) {\n this.connection = connection;\n this.nodeId = connection.options.nodeId;\n this.keys = nodeKeysOf(connection.options.prefix, this.nodeId);\n this.nodesKey = `${connection.options.prefix}:nodes`;\n connection.onConnectionReady(() => {\n // 재연결 직후 heartbeat를 보내고, 성공하면 대기 중인 rebuild가 이어진다\n this.runHeartbeat();\n });\n connection.onMasterChange(() => {\n // 아직 쓰기 전이면 다시 쓸 키도 없다\n if (!this.started) {\n return;\n }\n // failover에서는 비동기 복제로 직전 쓰기가 유실될 수 있으므로 매번 rebuild를 예약한다\n this.markRebuildPending();\n this.scheduleRebuild();\n });\n }\n\n getStatus(): RedisWebSocketPresenceStoreStatus {\n return { ready: this.connection.isReady, rebuildPending: this.rebuildPending };\n }\n\n register(input: WebSocketPresenceRegistration): Promise<void> {\n if (input.nodeId !== this.nodeId) {\n return Promise.reject(\n new Error(\n `Redis presence store for node ${this.nodeId} cannot register a session of node ${input.nodeId}.`,\n ),\n );\n }\n if (this.closing) {\n return Promise.resolve();\n }\n const connectedAt = input.connectedAt.getTime();\n this.sessions.set(input.sessionId, {\n sessionId: input.sessionId,\n namespace: input.namespace,\n active: input.active,\n rooms: new Set(),\n connectedAt,\n lastSeenAt: connectedAt,\n });\n return this.applySession(input.sessionId);\n }\n\n activate(sessionId: string): Promise<void> {\n return this.mutate(sessionId, (session) => {\n session.active = true;\n });\n }\n\n unregister(sessionId: string): Promise<void> {\n if (this.closing || !this.sessions.delete(sessionId)) {\n return Promise.resolve();\n }\n return this.applySession(sessionId);\n }\n\n setUserId(sessionId: string, userId: WebSocketUserId): Promise<void> {\n return this.mutate(sessionId, (session) => {\n session.userId = userId;\n });\n }\n\n clearUserId(sessionId: string): Promise<void> {\n return this.mutate(sessionId, (session) => {\n delete session.userId;\n });\n }\n\n join(sessionId: string, roomId: WebSocketRoomId): Promise<void> {\n return this.mutate(sessionId, (session) => {\n session.rooms.add(roomId);\n });\n }\n\n leave(sessionId: string, roomId: WebSocketRoomId): Promise<void> {\n return this.mutate(sessionId, (session) => {\n session.rooms.delete(roomId);\n });\n }\n\n /** heartbeat 기한 안에 있는 노드 ID만 반환한다. */\n async getLiveNodeIds(): Promise<string[]> {\n if (this.closing) {\n throw new Error(\"Redis presence store is shut down.\");\n }\n this.start();\n const wait = this.connection.whenUsable();\n if (wait) {\n await wait;\n }\n if (this.closing) {\n throw new Error(\"Redis presence store is shut down.\");\n }\n return this.connection.run((commands) =>\n commands.zRangeByScore(\n this.nodesKey,\n Date.now() - this.connection.options.nodeTimeoutMs,\n \"+inf\",\n ),\n );\n }\n\n /**\n * nodeId 관점의 라우팅 계획. 원격 노드는 heartbeat가 nodeTimeoutMs 안인 노드 중 audience count가 있는 노드다.\n * 세션 목록은 읽지 않고, 노드별 count 조회를 한 번의 pipeline으로 보낸다.\n */\n async resolveRoute(audience: WebSocketAudience, nodeId: string): Promise<WebSocketRoutingPlan> {\n const localSessionIds =\n nodeId === this.nodeId\n ? [...this.sessions.values()]\n .filter((session) => session.active && matchesAudience(session, audience))\n .map((session) => session.sessionId)\n : [];\n\n const leaves: CountLeaf[] = [];\n const remoteNodeIds = new Set<string>();\n collectRouting(audience, leaves, remoteNodeIds);\n\n if (leaves.length > 0) {\n const counts = await this.countOnLiveNodes(leaves, nodeId);\n for (const [candidate, count] of counts) {\n if (count > 0) {\n remoteNodeIds.add(candidate);\n }\n }\n }\n remoteNodeIds.delete(nodeId);\n\n return { localSessionIds, remoteNodeIds: [...remoteNodeIds].toSorted() };\n }\n\n /** 살아 있는 모든 노드의 활성 방 인원수 합계. 자기 노드는 메모리, 원격 노드는 Redis count로 센다. */\n async getRoomMemberCount(roomId: WebSocketRoomId, namespace?: string): Promise<number> {\n // 자기 노드는 메모리에서 센다. Redis 반영이 늦거나(rebuild 대기) 키가 사라져도 자기 노드 인원은 정확하다\n const audience: WebSocketAudience = { type: \"room\", roomId, namespace };\n let total = 0;\n for (const session of this.sessions.values()) {\n if (session.active && matchesAudience(session, audience)) {\n total += 1;\n }\n }\n // 원격 노드만 Redis에서 센다\n const counts = await this.countOnLiveNodes(\n [{ k: \"room\", ns: scopedNamespace(namespace), id: roomId }],\n this.nodeId,\n );\n for (const count of counts.values()) {\n total += count;\n }\n return total;\n }\n\n /**\n * 진행 중인 쓰기를 drainTimeoutMs까지 기다린 뒤 노드 키를 지우고 nodes에서 자기 노드를 뺀다.\n * 이후 들어오는 mutation은 Redis에 쓰지 않으므로 늦은 쓰기가 키를 되살리지 않는다.\n */\n shutdown(): Promise<void> {\n this.shutdownPromise ??= this.close();\n return this.shutdownPromise;\n }\n\n private async close(): Promise<void> {\n // 이 시점부터 아직 보내지 않은 쓰기와 heartbeat는 Redis로 나가지 않는다(prepare 단계에서 closing을 확인한다)\n this.closing = true;\n clearInterval(this.heartbeatTimer);\n clearTimeout(this.rebuildTimer);\n this.rebuildTimer = undefined;\n\n if (this.started) {\n let drainTimer: ReturnType<typeof setTimeout> | undefined;\n try {\n await Promise.race([\n Promise.allSettled(this.inFlight),\n new Promise<void>((resolve) => {\n drainTimer = setTimeout(resolve, this.connection.options.drainTimeoutMs);\n }),\n ]);\n } finally {\n // 빨리 끝난 drain이 event loop를 붙잡지 않게 한다\n clearTimeout(drainTimer);\n }\n // 같은 연결에서 앞서 보낸 늦은 쓰기보다 뒤에 실행되므로 그 쓰기가 만든 키도 함께 지운다\n await this.connection\n .run((commands) =>\n Promise.all([\n commands.del(Object.values(this.keys)),\n commands.zRem(this.nodesKey, this.nodeId),\n ]),\n )\n .catch(() => {});\n }\n this.sessions.clear();\n await this.connection.release(\"store\");\n }\n\n private mutate(sessionId: string, update: (session: LocalSession) => void): Promise<void> {\n const session = this.sessions.get(sessionId);\n if (this.closing || !session) {\n return Promise.resolve();\n }\n update(session);\n session.lastSeenAt = Date.now();\n return this.applySession(sessionId);\n }\n\n /**\n * 세션 하나를 Redis에 반영한다.\n *\n * 불변식: 모든 쓰기(세션 반영과 rebuild)는 명령을 보내는 바로 그 tick의 메모리 상태를 절대값으로 쓴다.\n * - 세션 반영 스크립트는 Redis에 있던 이전 JSON과 새 JSON을 비교해 count를 맞추므로, 같은 상태를 두 번 써도 count가 두 번 변하지 않는다.\n * - 한 연결의 명령은 보낸 순서대로 실행되므로, 나중에 보낸 쓰기일수록 더 최신 메모리를 담는다.\n * rebuild가 먼저 보낸 세션 반영을 덮어써도 rebuild snapshot이 그 변경을 이미 담고 있고,\n * rebuild 뒤에 보낸 세션 반영은 rebuild 결과 위에 최신 상태를 쓴다.\n * - NOSCRIPT 재시도와 ready 대기 뒤에도 snapshot을 다시 만들므로 오래된 상태를 늦게 보내는 일이 없다.\n * 따라서 마지막 쓰기가 성공하면 Redis는 그 시점의 메모리와 같다.\n */\n private applySession(sessionId: string): Promise<void> {\n const keyTtl = String(this.connection.options.keyTtlMs);\n this.pendingWrites += 1;\n const done = () => {\n this.pendingWrites -= 1;\n };\n const writing = this.write(async (commands, token) => {\n let wroteSession = false;\n await this.connection.evalScript(\n commands,\n token,\n APPLY_SESSION_SCRIPT,\n Object.values(this.keys),\n () => {\n if (this.closing) {\n return undefined;\n }\n const session = this.sessions.get(sessionId);\n wroteSession = session !== undefined;\n return [sessionId, session ? serializeSession(session, this.nodeId) : \"\", keyTtl];\n },\n );\n if (wroteSession) {\n this.sessionsPersisted = true;\n }\n });\n writing.then(done, done);\n return writing;\n }\n\n private write(operation: Parameters<RedisWebSocketConnection[\"run\"]>[0]): Promise<void> {\n this.start();\n const wait = this.connection.whenUsable();\n const execute = () =>\n // ready를 기다리는 사이 shutdown이 시작됐으면 정리된 노드 키를 되살리지 않도록 버린다\n this.closing\n ? Promise.resolve()\n : this.connection.run(operation).then(\n () => undefined,\n (cause: unknown) => {\n // 서버에서 실행됐을 수도 있으므로 결과와 무관하게 메모리로 다시 써야 한다\n this.markRebuildPending();\n throw cause;\n },\n );\n return this.track(wait ? wait.then(execute) : execute());\n }\n\n private async countOnLiveNodes(\n leaves: CountLeaf[],\n excludeNodeId?: string,\n ): Promise<Map<string, number>> {\n const liveNodeIds = await this.getLiveNodeIds();\n const prefix = this.connection.options.prefix;\n const leavesJson = JSON.stringify(leaves);\n return this.connection.run(async (commands, token) => {\n const candidates = liveNodeIds.filter((candidate) => candidate !== excludeNodeId);\n // 같은 tick에 보내므로 node-redis가 한 번의 pipeline으로 묶어 보낸다\n const counts = await Promise.all(\n candidates.map((candidate) => {\n const keys = nodeKeysOf(prefix, candidate);\n return this.connection.evalScript(\n commands,\n token,\n COUNT_AUDIENCE_SCRIPT,\n [keys.rooms, keys.users, keys.namespaces],\n // NOSCRIPT 재시도 전에 shutdown됐으면 보내지 않는다\n () => (this.closing ? undefined : [leavesJson]),\n );\n }),\n );\n return new Map<string, number>(\n candidates.map((candidate, index) => [candidate, counts[index] ?? 0]),\n );\n });\n }\n\n // 첫 사용 때 연결과 heartbeat를 시작한다\n private start(): void {\n if (this.started || this.closing) {\n return;\n }\n this.started = true;\n this.connection.start();\n this.heartbeatTimer = setInterval(() => {\n this.runHeartbeat();\n }, this.connection.options.heartbeatIntervalMs);\n this.heartbeatTimer.unref();\n // 첫 mutation보다 먼저 보내 nodes에 바로 등록되게 한다\n this.runHeartbeat();\n }\n\n private runHeartbeat(): void {\n if (!this.started || this.closing || this.heartbeatRunning) {\n return;\n }\n this.heartbeatRunning = true;\n const wait = this.connection.whenUsable();\n const execute = (): Promise<boolean | undefined> =>\n this.closing\n ? Promise.resolve(undefined)\n : this.connection.run((commands) => this.sendHeartbeat(commands));\n const heartbeat = (wait ? wait.then(execute) : execute()).then(\n (keysIntact) => {\n if (this.closing) {\n return;\n }\n // 명령 실패 없이 노드 키가 사라진 경우(eviction, FLUSHDB)는 메모리상 있어야 할 키가 없는 것으로 알아챈다\n // 쓰기 실패가 아니므로 failureGeneration은 올리지 않는다. 이 heartbeat보다 뒤에 보낸 rebuild가 성공하면 키가 복구된 것이고,\n // 앞서 보낸 rebuild였다면 다음 heartbeat가 다시 알아챈다\n if (keysIntact === false) {\n this.rebuildPending = true;\n }\n // 연결은 유지된 채 응답만 멈췄다 돌아오면 ready도 MASTER_CHANGE도 없으므로 heartbeat 성공이 rebuild 계기가 된다\n if (this.rebuildPending) {\n this.scheduleRebuild();\n }\n },\n () => {\n // heartbeat가 실패하면 TTL이 갱신되지 않아 키가 만료될 수 있으므로 복구 뒤 다시 써야 한다\n this.markRebuildPending();\n },\n );\n this.track(\n heartbeat.finally(() => {\n this.heartbeatRunning = false;\n }),\n );\n }\n\n /**\n * nodes score와 키 TTL을 한 번의 pipeline으로 갱신한다.\n * 노드 키 4개의 PEXPIRE 결과(키가 있었는지)를 메모리상 있어야 할 키와 비교해 키 유실을 별도 왕복 없이 알아챈다.\n * 있어야 할 키가 하나라도 없었으면 false를 돌려준다.\n */\n private async sendHeartbeat(\n commands: Parameters<Parameters<RedisWebSocketConnection[\"run\"]>[0]>[0],\n ): Promise<boolean> {\n const now = Date.now();\n const { keyTtlMs } = this.connection.options;\n // 기대값은 명령을 보내는 시점의 메모리로 정한다. 같은 연결의 앞선 쓰기는 이 PEXPIRE보다 먼저 실행된다\n const expected = this.expectedNodeKeys();\n const [sessions, rooms, users, namespaces] = await Promise.all([\n commands.pExpire(this.keys.sessions, keyTtlMs),\n commands.pExpire(this.keys.rooms, keyTtlMs),\n commands.pExpire(this.keys.users, keyTtlMs),\n commands.pExpire(this.keys.namespaces, keyTtlMs),\n commands.zAdd(this.nodesKey, now, this.nodeId),\n // keyTtlMs가 지난 노드는 키도 만료됐으므로 live-node set에서 정리해 크기를 제한한다\n commands.zRemRangeByScore(this.nodesKey, \"-inf\", now - keyTtlMs),\n commands.pExpire(this.nodesKey, keyTtlMs),\n ]);\n if (expected === undefined) {\n return true;\n }\n return (\n (sessions || !expected.sessions) &&\n (rooms || !expected.rooms) &&\n (users || !expected.users) &&\n (namespaces || !expected.namespaces)\n );\n }\n\n /**\n * 메모리 상태에서 Redis에 반드시 있어야 할 노드 키를 Lua 스크립트 규칙대로 계산한다.\n * - sessions: 세션이 하나라도 있으면(비활성 포함) 있다\n * - namespaces: 활성 세션이 하나라도 있으면 있다\n * - rooms: 방에 들어간 활성 세션이 있으면 있다\n * - users: userId가 있는 활성 세션이 있으면 있다\n * 아직 세션을 쓴 적이 없거나 끝나지 않은 쓰기가 있으면 메모리가 Redis보다 앞서 있을 수 있으므로 판정하지 않는다(undefined).\n * 반대 방향(메모리상 없어야 할 키가 있음)은 eviction으로 생기지 않으므로 보지 않는다.\n */\n private expectedNodeKeys():\n | { sessions: boolean; rooms: boolean; users: boolean; namespaces: boolean }\n | undefined {\n if (!this.sessionsPersisted || this.pendingWrites > 0) {\n return undefined;\n }\n const expected = {\n sessions: this.sessions.size > 0,\n rooms: false,\n users: false,\n namespaces: false,\n };\n for (const session of this.sessions.values()) {\n if (!session.active) {\n continue;\n }\n expected.namespaces = true;\n if (session.rooms.size > 0) {\n expected.rooms = true;\n }\n if (session.userId !== undefined) {\n expected.users = true;\n }\n }\n return expected;\n }\n\n private markRebuildPending(): void {\n if (this.closing) {\n return;\n }\n this.rebuildPending = true;\n this.failureGeneration += 1;\n }\n\n /**\n * 짧은 간격의 계기를 하나로 모은다. 첫 계기부터 REBUILD_DEBOUNCE_MS 뒤에 실행하고, 그 사이의 계기는 타이머를 다시 걸지 않는다.\n * 계기가 debounce보다 자주 와도(짧은 heartbeat 주기, 반복 이벤트) rebuild가 무한히 밀리지 않는다.\n */\n private scheduleRebuild(): void {\n if (this.closing || this.rebuildTimer !== undefined) {\n return;\n }\n this.rebuildTimer = setTimeout(() => {\n this.rebuildTimer = undefined;\n this.rebuild();\n }, REBUILD_DEBOUNCE_MS);\n this.rebuildTimer.unref();\n }\n\n /**\n * 노드 키를 메모리 snapshot으로 다시 쓴다. 이미 진행 중이면 끝난 뒤 한 번 더 실행해 마지막 계기를 놓치지 않는다.\n */\n private rebuild(): void {\n if (this.closing) {\n return;\n }\n if (this.rebuildRunning) {\n this.rebuildRequested = true;\n return;\n }\n this.rebuildRunning = true;\n const generation = this.failureGeneration;\n const keyTtl = String(this.connection.options.keyTtlMs);\n\n const rebuilding = this.connection\n .run(async (commands, token) => {\n let wroteSessions = false;\n // snapshot은 보내기 직전에 만든다(applySession의 불변식 참고)\n await this.connection.evalScript(\n commands,\n token,\n REBUILD_NODE_SCRIPT,\n Object.values(this.keys),\n () => {\n if (this.closing) {\n return undefined;\n }\n const args = [keyTtl];\n for (const session of this.sessions.values()) {\n args.push(session.sessionId, serializeSession(session, this.nodeId));\n }\n wroteSessions = this.sessions.size > 0;\n return args;\n },\n );\n if (wroteSessions) {\n this.sessionsPersisted = true;\n }\n if (this.closing) {\n return true;\n }\n return this.sendHeartbeat(commands);\n })\n .then(\n (keysIntact) => {\n if (!keysIntact) {\n // rebuild 직후 heartbeat가 키 유실을 확인했으면 대기를 유지하고 debounce를 거쳐 다시 rebuild한다\n this.rebuildPending = true;\n this.scheduleRebuild();\n return;\n }\n // rebuild 도중 새 쓰기 실패가 없었을 때만 대기를 해제한다\n if (generation === this.failureGeneration) {\n this.rebuildPending = false;\n }\n },\n () => {\n this.markRebuildPending();\n },\n )\n .finally(() => {\n this.rebuildRunning = false;\n // 진행 중에 들어온 계기는 아직 복구할 것이 남은 경우에만 다시 실행한다\n if (this.rebuildRequested) {\n this.rebuildRequested = false;\n if (this.rebuildPending) {\n this.scheduleRebuild();\n }\n }\n });\n this.track(rebuilding);\n }\n\n private track(promise: Promise<void>): Promise<void> {\n this.inFlight.add(promise);\n const forget = () => {\n this.inFlight.delete(promise);\n };\n promise.then(forget, forget);\n return promise;\n }\n}\n"],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sonamu-kit/websocket-redis-adapter",
3
- "version": "0.13.0",
3
+ "version": "0.13.9",
4
4
  "description": "Redis presence store and cluster bus for Sonamu multi-node WebSocket delivery",
5
5
  "license": "MIT",
6
6
  "author": "CartaNova <dev@cartanova.ai>",
@@ -32,7 +32,7 @@
32
32
  "oxfmt": "^0.74.0",
33
33
  "oxlint": "1.89.0",
34
34
  "redis": "^6.3.0",
35
- "sonamu": "0.13.0",
35
+ "sonamu": "0.13.9",
36
36
  "testcontainers": "^12.0.0",
37
37
  "tsdown": "^0.23.1",
38
38
  "typescript": "7.1.0-dev.20260831.1",
@@ -40,7 +40,7 @@
40
40
  },
41
41
  "peerDependencies": {
42
42
  "redis": "^6.3.0",
43
- "sonamu": ">=0.12.0"
43
+ "sonamu": ">=0.13.9"
44
44
  },
45
45
  "engines": {
46
46
  "node": ">=22.0.0"