feat(iios): socket.io Redis adapter for cross-replica realtime (P9 scaling)

Adds an opt-in RedisIoAdapter (wired in main.ts when REDIS_URL is set) so socket.io room emits fan out across instances via Redis pub/sub — a client on replica B now receives messages emitted by replica A. Without REDIS_URL the in-memory adapter is kept (single-instance dev unchanged). Adds redis to docker-compose, REDIS_URL to the env contract, and smoke-realtime-cluster.mjs which proves cross-instance delivery fails without Redis and passes with it. Delivery is at-least-once at N>1; clients dedupe by message id (documented). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-03 19:28:11 +05:30
parent a520b26398
commit 427396653f
8 changed files with 237 additions and 8 deletions
@@ -0,0 +1,53 @@
+// P9 scaling smoke: cross-instance realtime fan-out via the socket.io Redis adapter.
+// Alice connects to instance A, Bob to instance B (two separate processes sharing one
+// Redis + DB). Alice sends on A; Bob must receive it live on B — which only works if the
+// Redis adapter fans room emits across replicas. Set A_URL / B_URL (default 3201/3202).
+import 'dotenv/config';
+import { io } from 'socket.io-client';
+import jwt from 'jsonwebtoken';
+
+const A_URL = process.env.A_URL ?? 'http://localhost:3201';
+const B_URL = process.env.B_URL ?? 'http://localhost:3202';
+const APP_ID = 'portal-demo';
+const SECRET = JSON.parse(process.env.APP_SECRETS ?? '{"portal-demo":"dev-secret"}')[APP_ID];
+
+const sign = (userId) =>
+  jwt.sign({ sub: userId, name: userId, appId: APP_ID, orgId: `org_${APP_ID}` }, SECRET, { algorithm: 'HS256', expiresIn: '1h' });
+const connect = (url, userId) =>
+  io(`${url}/message`, { auth: { token: sign(userId) }, transports: ['websocket'], forceNew: true });
+const once = (socket, event, ms = 8000) =>
+  new Promise((res, rej) => {
+    const t = setTimeout(() => rej(new Error(`timeout waiting for "${event}"`)), ms);
+    socket.once(event, (v) => { clearTimeout(t); res(v); });
+  });
+const assert = (c, m) => { if (!c) { console.error('✗', m); process.exit(1); } console.log('✓', m); };
+
+const alice = connect(A_URL, 'alice-cluster');
+const bob = connect(B_URL, 'bob-cluster');
+
+try {
+  await Promise.all([once(alice, 'connect'), once(bob, 'connect')]);
+  assert(true, `Alice connected to A (${A_URL}), Bob to B (${B_URL})`);
+
+  // Alice opens a thread on instance A; Bob joins the SAME thread on instance B.
+  const opened = await alice.emitWithAck('open_thread', {});
+  const threadId = opened.threadId;
+  assert(!!threadId, `Alice opened thread ${threadId} on instance A`);
+  await bob.emitWithAck('open_thread', { threadId });
+  assert(true, 'Bob joined the same thread on instance B');
+
+  // Alice sends on A → Bob must receive it on B (cross-instance fan-out via Redis).
+  const bobReceives = once(bob, 'message');
+  await alice.emitWithAck('send_message', { threadId, content: 'hello across instances' });
+  const received = await bobReceives;
+  assert(received.content === 'hello across instances', `Bob received "${received.content}" on B — emitted from A ✓`);
+
+  console.log('\nP9 cross-instance realtime smoke: PASS');
+} catch (err) {
+  console.error('✗', err.message);
+  process.exit(1);
+} finally {
+  alice.close();
+  bob.close();
+}
+process.exit(0);