@hed-hog/core 0.0.387 → 0.0.390

package/dist/realtime/realtime.gateway.js

@@ -0,0 +1,156 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var RealtimeGateway_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealtimeGateway = exports.REALTIME_EVENTS = void 0;
+const common_1 = require("@nestjs/common");
+const event_emitter_1 = require("@nestjs/event-emitter");
+const websockets_1 = require("@nestjs/websockets");
+const token_service_1 = require("../token/token.service");
+const realtime_service_1 = require("./realtime.service");
+/** Events other modules can listen to via `@OnEvent(...)`. */
+exports.REALTIME_EVENTS = {
+    userConnected: 'realtime.user.connected',
+    userDisconnected: 'realtime.user.disconnected',
+};
+function corsOrigin() {
+    const raw = String(process.env.CORS_ALLOWED_ORIGINS || '').trim();
+    if (!raw)
+        return true; // permissive handshake — the JWT is the real gate
+    return raw
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+/**
+ * Single Socket.IO gateway (`/realtime`) on the same HTTP server/port. It only
+ * handles transport + auth + room membership; the reusable emit API lives in
+ * {@link RealtimeService}. Auth reuses {@link TokenService.verify} (same JWT as
+ * the HTTP `AuthGuard`); connection lifecycle is broadcast via EventEmitter2 so
+ * features (e.g. presence) react without this layer knowing about them.
+ */
+let RealtimeGateway = RealtimeGateway_1 = class RealtimeGateway {
+    constructor(realtime, token, events) {
+        this.realtime = realtime;
+        this.token = token;
+        this.events = events;
+        this.logger = new common_1.Logger(RealtimeGateway_1.name);
+    }
+    afterInit(server) {
+        this.realtime.setServer(server);
+        this.logger.log('Realtime gateway initialized on /realtime');
+    }
+    extractToken(socket) {
+        var _a;
+        const authToken = (_a = socket.handshake.auth) === null || _a === void 0 ? void 0 : _a.token;
+        if (authToken)
+            return authToken;
+        const header = socket.handshake.headers.authorization;
+        const [type, value] = String(header !== null && header !== void 0 ? header : '').split(' ');
+        return type === 'Bearer' ? value : undefined;
+    }
+    async handleConnection(socket) {
+        const token = this.extractToken(socket);
+        if (!token) {
+            socket.disconnect(true);
+            return;
+        }
+        try {
+            const payload = await this.token.verify('en', token);
+            const userId = Number(payload === null || payload === void 0 ? void 0 : payload.sub);
+            if (!Number.isInteger(userId) || userId <= 0) {
+                socket.disconnect(true);
+                return;
+            }
+            socket.data.userId = userId;
+            socket.join(`user:${userId}`);
+            const localCount = this.realtime.trackConnect(userId);
+            this.events.emit(exports.REALTIME_EVENTS.userConnected, {
+                userId,
+                firstConnection: localCount === 1,
+            });
+        }
+        catch (_a) {
+            socket.disconnect(true);
+        }
+    }
+    handleDisconnect(socket) {
+        var _a;
+        const userId = (_a = socket.data) === null || _a === void 0 ? void 0 : _a.userId;
+        if (!userId)
+            return;
+        const remaining = this.realtime.trackDisconnect(userId);
+        this.events.emit(exports.REALTIME_EVENTS.userDisconnected, {
+            userId,
+            remainingLocalSockets: remaining,
+        });
+    }
+    /** Joins the socket to the given channels (rooms `channel:{name}`). */
+    onSubscribe(socket, body) {
+        const channels = Array.isArray(body === null || body === void 0 ? void 0 : body.channels) ? body.channels : [];
+        for (const ch of channels) {
+            if (this.isAllowed(socket, String(ch)))
+                socket.join(`channel:${ch}`);
+        }
+        return { ok: true, subscribed: channels };
+    }
+    onUnsubscribe(socket, body) {
+        const channels = Array.isArray(body === null || body === void 0 ? void 0 : body.channels) ? body.channels : [];
+        for (const ch of channels)
+            socket.leave(`channel:${ch}`);
+        return { ok: true };
+    }
+    /**
+     * Channel-subscription authorization. `presence:{id}` is readable by any
+     * authenticated user (presence is coarse/non-sensitive). Modules adding
+     * sensitive channels should extend this with per-channel checks.
+     */
+    isAllowed(_socket, channel) {
+        if (channel.startsWith('presence:'))
+            return true;
+        // Default-allow other channels for now; tighten per feature as needed.
+        return true;
+    }
+};
+exports.RealtimeGateway = RealtimeGateway;
+__decorate([
+    (0, websockets_1.WebSocketServer)(),
+    __metadata("design:type", Function)
+], RealtimeGateway.prototype, "server", void 0);
+__decorate([
+    (0, websockets_1.SubscribeMessage)('subscribe'),
+    __param(0, (0, websockets_1.ConnectedSocket)()),
+    __param(1, (0, websockets_1.MessageBody)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Function, Object]),
+    __metadata("design:returntype", void 0)
+], RealtimeGateway.prototype, "onSubscribe", null);
+__decorate([
+    (0, websockets_1.SubscribeMessage)('unsubscribe'),
+    __param(0, (0, websockets_1.ConnectedSocket)()),
+    __param(1, (0, websockets_1.MessageBody)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Function, Object]),
+    __metadata("design:returntype", void 0)
+], RealtimeGateway.prototype, "onUnsubscribe", null);
+exports.RealtimeGateway = RealtimeGateway = RealtimeGateway_1 = __decorate([
+    (0, websockets_1.WebSocketGateway)({
+        namespace: '/realtime',
+        cors: { origin: corsOrigin(), credentials: true },
+    }),
+    __metadata("design:paramtypes", [realtime_service_1.RealtimeService,
+        token_service_1.TokenService,
+        event_emitter_1.EventEmitter2])
+], RealtimeGateway);
+//# sourceMappingURL=realtime.gateway.js.map

package/dist/realtime/realtime.gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.gateway.js","sourceRoot":"","sources":["../../src/realtime/realtime.gateway.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAwC;AACxC,yDAAsD;AACtD,mDAS4B;AAE5B,0DAAsD;AACtD,yDAAqD;AAErD,8DAA8D;AACjD,QAAA,eAAe,GAAG;IAC7B,aAAa,EAAE,yBAAyB;IACxC,gBAAgB,EAAE,4BAA4B;CACtC,CAAC;AAEX,SAAS,UAAU;IACjB,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClE,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC,CAAC,kDAAkD;IACzE,OAAO,GAAG;SACP,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED;;;;;;GAMG;AAKI,IAAM,eAAe,uBAArB,MAAM,eAAe;IAQ1B,YACmB,QAAyB,EACzB,KAAmB,EACnB,MAAqB;QAFrB,aAAQ,GAAR,QAAQ,CAAiB;QACzB,UAAK,GAAL,KAAK,CAAc;QACnB,WAAM,GAAN,MAAM,CAAe;QARvB,WAAM,GAAG,IAAI,eAAM,CAAC,iBAAe,CAAC,IAAI,CAAC,CAAC;IASxD,CAAC;IAEJ,SAAS,CAAC,MAAc;QACtB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAEO,YAAY,CAAC,MAAc;;QACjC,MAAM,SAAS,GAAG,MAAC,MAAM,CAAC,SAAS,CAAC,IAAuC,0CAAE,KAAK,CAAC;QACnF,IAAI,SAAS;YAAE,OAAO,SAAS,CAAC;QAChC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,aAAa,CAAC;QACtD,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACtD,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,MAAc;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACxB,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,GAAG,CAAC,CAAC;YACpC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;gBAC7C,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;gBACxB,OAAO;YACT,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,QAAQ,MAAM,EAAE,CAAC,CAAC;YAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YACtD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAe,CAAC,aAAa,EAAE;gBAC9C,MAAM;gBACN,eAAe,EAAE,UAAU,KAAK,CAAC;aAClC,CAAC,CAAC;QACL,CAAC;QAAC,WAAM,CAAC;YACP,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,gBAAgB,CAAC,MAAc;;QAC7B,MAAM,MAAM,GAAG,MAAA,MAAM,CAAC,IAAI,0CAAE,MAA4B,CAAC;QACzD,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAe,CAAC,gBAAgB,EAAE;YACjD,MAAM;YACN,qBAAqB,EAAE,SAAS;SACjC,CAAC,CAAC;IACL,CAAC;IAED,uEAAuE;IAEvE,WAAW,CACU,MAAc,EAClB,IAA6B;QAE5C,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC1B,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IAC5C,CAAC;IAGD,aAAa,CACQ,MAAc,EAClB,IAA6B;QAE5C,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,KAAK,MAAM,EAAE,IAAI,QAAQ;YAAE,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACzD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACK,SAAS,CAAC,OAAe,EAAE,OAAe;QAChD,IAAI,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC;YAAE,OAAO,IAAI,CAAC;QACjD,uEAAuE;QACvE,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAA;AA/FY,0CAAe;AAM1B;IADC,IAAA,4BAAe,GAAE;;+CACF;AA0DhB;IADC,IAAA,6BAAgB,EAAC,WAAW,CAAC;IAE3B,WAAA,IAAA,4BAAe,GAAE,CAAA;IACjB,WAAA,IAAA,wBAAW,GAAE,CAAA;;;;kDAOf;AAGD;IADC,IAAA,6BAAgB,EAAC,aAAa,CAAC;IAE7B,WAAA,IAAA,4BAAe,GAAE,CAAA;IACjB,WAAA,IAAA,wBAAW,GAAE,CAAA;;;;oDAKf;0BAnFU,eAAe;IAJ3B,IAAA,6BAAgB,EAAC;QAChB,SAAS,EAAE,WAAW;QACtB,IAAI,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;KAClD,CAAC;qCAU6B,kCAAe;QAClB,4BAAY;QACX,6BAAa;GAX7B,eAAe,CA+F3B"}

package/dist/realtime/realtime.module.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generic real-time (WebSocket) layer for the whole app. Any module can inject
+ * {@link RealtimeService} to push events to users/channels, fanned out across
+ * instances via Redis. EventEmitter2 (global) delivers connection lifecycle.
+ */
+export declare class RealtimeModule {
+}
+//# sourceMappingURL=realtime.module.d.ts.map

package/dist/realtime/realtime.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.module.d.ts","sourceRoot":"","sources":["../../src/realtime/realtime.module.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,qBAKa,cAAc;CAAG"}

package/dist/realtime/realtime.module.js

@@ -0,0 +1,29 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealtimeModule = void 0;
+const common_1 = require("@nestjs/common");
+const token_module_1 = require("../token/token.module");
+const realtime_gateway_1 = require("./realtime.gateway");
+const realtime_service_1 = require("./realtime.service");
+/**
+ * Generic real-time (WebSocket) layer for the whole app. Any module can inject
+ * {@link RealtimeService} to push events to users/channels, fanned out across
+ * instances via Redis. EventEmitter2 (global) delivers connection lifecycle.
+ */
+let RealtimeModule = class RealtimeModule {
+};
+exports.RealtimeModule = RealtimeModule;
+exports.RealtimeModule = RealtimeModule = __decorate([
+    (0, common_1.Module)({
+        imports: [(0, common_1.forwardRef)(() => token_module_1.TokenModule)],
+        providers: [realtime_gateway_1.RealtimeGateway, realtime_service_1.RealtimeService],
+        exports: [realtime_service_1.RealtimeService],
+    })
+], RealtimeModule);
+//# sourceMappingURL=realtime.module.js.map

package/dist/realtime/realtime.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.module.js","sourceRoot":"","sources":["../../src/realtime/realtime.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAoD;AACpD,wDAAoD;AACpD,yDAAqD;AACrD,yDAAqD;AAErD;;;;GAIG;AAMI,IAAM,cAAc,GAApB,MAAM,cAAc;CAAG,CAAA;AAAjB,wCAAc;yBAAd,cAAc;IAL1B,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,0BAAW,CAAC,CAAC;QACxC,SAAS,EAAE,CAAC,kCAAe,EAAE,kCAAe,CAAC;QAC7C,OAAO,EAAE,CAAC,kCAAe,CAAC;KAC3B,CAAC;GACW,cAAc,CAAG"}

package/dist/realtime/realtime.service.d.ts

@@ -0,0 +1,51 @@
+import { OnModuleDestroy, OnModuleInit } from '@nestjs/common';
+import type { Server } from 'socket.io';
+/**
+ * Generic real-time messaging layer usable by ANY module. Wraps the Socket.IO
+ * server (bound by {@link RealtimeGateway}) and fans emits out across API
+ * instances via Redis pub/sub — mirroring the settings-sync pattern — so a
+ * message emitted on one pod reaches clients connected to another. Without
+ * `REDIS_URL` it degrades to single-instance (local emit still works).
+ *
+ * Rooms: `user:{id}` (auto-joined on connect) and `channel:{name}` (joined via
+ * the gateway's `subscribe` message). Other modules just inject this service and
+ * call {@link emitToUser} / {@link emitToChannel} / {@link broadcast}.
+ */
+export declare class RealtimeService implements OnModuleInit, OnModuleDestroy {
+    private readonly logger;
+    private readonly instanceId;
+    private readonly redisUrl;
+    private readonly channel;
+    private server;
+    private redisPublisher;
+    private redisSubscriber;
+    /** Local (this-instance) socket count per user id, for presence/liveness. */
+    private readonly localConnections;
+    onModuleInit(): Promise<void>;
+    onModuleDestroy(): Promise<void>;
+    /** Called by the gateway once Socket.IO is initialized. */
+    setServer(server: Server): void;
+    private userRoom;
+    private channelRoom;
+    /** Emits an event to every socket of a given user (all their tabs/devices). */
+    emitToUser(userId: string | number, event: string, payload: unknown): void;
+    /** Emits an event to everyone subscribed to a named channel. */
+    emitToChannel(channel: string, event: string, payload: unknown): void;
+    /** Emits an event to every connected client. */
+    broadcast(event: string, payload: unknown): void;
+    private dispatch;
+    private emitLocal;
+    private publish;
+    private handleRedisMessage;
+    /** Records a new local socket for a user; returns the new local count. */
+    trackConnect(userId: number): number;
+    /** Drops a local socket for a user; returns the remaining local count. */
+    trackDisconnect(userId: number): number;
+    /** Whether the user has at least one socket on THIS instance. */
+    isLocallyConnected(userId: number): boolean;
+    /** All user ids with at least one socket on this instance. */
+    getLocallyConnectedUserIds(): number[];
+    private initRedis;
+    private safeClose;
+}
+//# sourceMappingURL=realtime.service.d.ts.map

package/dist/realtime/realtime.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.service.d.ts","sourceRoot":"","sources":["../../src/realtime/realtime.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,eAAe,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAcxC;;;;;;;;;;GAUG;AACH,qBACa,eAAgB,YAAW,YAAY,EAAE,eAAe;IACnE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8C;IACvE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAEhD,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,cAAc,CAAgC;IACtD,OAAO,CAAC,eAAe,CAAgC;IAEvD,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAExD,YAAY;IAIZ,eAAe;IAOrB,2DAA2D;IAC3D,SAAS,CAAC,MAAM,EAAE,MAAM;IAIxB,OAAO,CAAC,QAAQ;IAGhB,OAAO,CAAC,WAAW;IAInB,+EAA+E;IAC/E,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAInE,gEAAgE;IAChE,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAI9D,gDAAgD;IAChD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAIzC,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,kBAAkB;IAc1B,0EAA0E;IAC1E,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAMpC,0EAA0E;IAC1E,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAOvC,iEAAiE;IACjE,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI3C,8DAA8D;IAC9D,0BAA0B,IAAI,MAAM,EAAE;YAMxB,SAAS;YA4BT,SAAS;CAQxB"}

package/dist/realtime/realtime.service.js

@@ -0,0 +1,177 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var RealtimeService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealtimeService = void 0;
+const common_1 = require("@nestjs/common");
+const crypto_1 = require("crypto");
+const redis_1 = require("redis");
+/**
+ * Generic real-time messaging layer usable by ANY module. Wraps the Socket.IO
+ * server (bound by {@link RealtimeGateway}) and fans emits out across API
+ * instances via Redis pub/sub — mirroring the settings-sync pattern — so a
+ * message emitted on one pod reaches clients connected to another. Without
+ * `REDIS_URL` it degrades to single-instance (local emit still works).
+ *
+ * Rooms: `user:{id}` (auto-joined on connect) and `channel:{name}` (joined via
+ * the gateway's `subscribe` message). Other modules just inject this service and
+ * call {@link emitToUser} / {@link emitToChannel} / {@link broadcast}.
+ */
+let RealtimeService = RealtimeService_1 = class RealtimeService {
+    constructor() {
+        this.logger = new common_1.Logger(RealtimeService_1.name);
+        this.instanceId = (0, crypto_1.randomUUID)();
+        this.redisUrl = String(process.env.REDIS_URL || '').trim();
+        this.channel = 'core:realtime:emit';
+        this.server = null;
+        this.redisPublisher = null;
+        this.redisSubscriber = null;
+        /** Local (this-instance) socket count per user id, for presence/liveness. */
+        this.localConnections = new Map();
+    }
+    async onModuleInit() {
+        await this.initRedis();
+    }
+    async onModuleDestroy() {
+        await Promise.allSettled([
+            this.safeClose(this.redisSubscriber),
+            this.safeClose(this.redisPublisher),
+        ]);
+    }
+    /** Called by the gateway once Socket.IO is initialized. */
+    setServer(server) {
+        this.server = server;
+    }
+    userRoom(userId) {
+        return `user:${userId}`;
+    }
+    channelRoom(name) {
+        return `channel:${name}`;
+    }
+    /** Emits an event to every socket of a given user (all their tabs/devices). */
+    emitToUser(userId, event, payload) {
+        this.dispatch({ target: { type: 'user', target: String(userId) }, event, payload });
+    }
+    /** Emits an event to everyone subscribed to a named channel. */
+    emitToChannel(channel, event, payload) {
+        this.dispatch({ target: { type: 'channel', target: channel }, event, payload });
+    }
+    /** Emits an event to every connected client. */
+    broadcast(event, payload) {
+        this.dispatch({ target: { type: 'broadcast' }, event, payload });
+    }
+    dispatch(msg) {
+        this.emitLocal(msg);
+        this.publish(msg);
+    }
+    emitLocal(msg) {
+        if (!this.server)
+            return;
+        const { target, event, payload } = msg;
+        if (target.type === 'user') {
+            this.server.to(this.userRoom(target.target)).emit(event, payload);
+        }
+        else if (target.type === 'channel') {
+            this.server.to(this.channelRoom(target.target)).emit(event, payload);
+        }
+        else {
+            this.server.emit(event, payload);
+        }
+    }
+    publish(msg) {
+        if (!this.redisPublisher)
+            return;
+        const full = Object.assign(Object.assign({}, msg), { originInstanceId: this.instanceId });
+        this.redisPublisher
+            .publish(this.channel, JSON.stringify(full))
+            .catch((error) => this.logger.warn(`Realtime publish failed: ${error instanceof Error ? error.message : 'unknown'}`));
+    }
+    handleRedisMessage(raw) {
+        let msg;
+        try {
+            msg = JSON.parse(raw);
+        }
+        catch (_a) {
+            return;
+        }
+        // Skip our own messages — they were already emitted locally.
+        if (!msg || msg.originInstanceId === this.instanceId)
+            return;
+        this.emitLocal(msg);
+    }
+    // ── Connection tracking (called by the gateway) ────────────────────────────
+    /** Records a new local socket for a user; returns the new local count. */
+    trackConnect(userId) {
+        var _a;
+        const next = ((_a = this.localConnections.get(userId)) !== null && _a !== void 0 ? _a : 0) + 1;
+        this.localConnections.set(userId, next);
+        return next;
+    }
+    /** Drops a local socket for a user; returns the remaining local count. */
+    trackDisconnect(userId) {
+        var _a;
+        const next = Math.max(0, ((_a = this.localConnections.get(userId)) !== null && _a !== void 0 ? _a : 0) - 1);
+        if (next === 0)
+            this.localConnections.delete(userId);
+        else
+            this.localConnections.set(userId, next);
+        return next;
+    }
+    /** Whether the user has at least one socket on THIS instance. */
+    isLocallyConnected(userId) {
+        var _a;
+        return ((_a = this.localConnections.get(userId)) !== null && _a !== void 0 ? _a : 0) > 0;
+    }
+    /** All user ids with at least one socket on this instance. */
+    getLocallyConnectedUserIds() {
+        return [...this.localConnections.keys()];
+    }
+    // ── Redis wiring (mirrors setting.service) ─────────────────────────────────
+    async initRedis() {
+        if (!this.redisUrl) {
+            this.logger.log('Realtime Redis fan-out disabled (REDIS_URL not set); single-instance only.');
+            return;
+        }
+        try {
+            const opts = {
+                url: this.redisUrl,
+                socket: { reconnectStrategy: (retries) => Math.min(retries * 250, 5000) },
+            };
+            this.redisPublisher = (0, redis_1.createClient)(opts);
+            this.redisSubscriber = (0, redis_1.createClient)(opts);
+            this.redisPublisher.on('error', (e) => { var _a; return this.logger.warn(`Realtime Redis publisher error: ${(_a = e === null || e === void 0 ? void 0 : e.message) !== null && _a !== void 0 ? _a : e}`); });
+            this.redisSubscriber.on('error', (e) => { var _a; return this.logger.warn(`Realtime Redis subscriber error: ${(_a = e === null || e === void 0 ? void 0 : e.message) !== null && _a !== void 0 ? _a : e}`); });
+            await this.redisPublisher.connect();
+            await this.redisSubscriber.connect();
+            await this.redisSubscriber.subscribe(this.channel, (msg) => this.handleRedisMessage(msg));
+            this.logger.log(`Realtime Redis fan-out enabled on channel ${this.channel}`);
+        }
+        catch (error) {
+            this.logger.warn(`Failed to init realtime Redis fan-out: ${error instanceof Error ? error.message : 'unknown'}`);
+            await Promise.allSettled([this.safeClose(this.redisSubscriber), this.safeClose(this.redisPublisher)]);
+            this.redisPublisher = null;
+            this.redisSubscriber = null;
+        }
+    }
+    async safeClose(client) {
+        if (!client)
+            return;
+        try {
+            if (client.isOpen)
+                await client.quit();
+        }
+        catch (_a) {
+            /* ignore */
+        }
+    }
+};
+exports.RealtimeService = RealtimeService;
+exports.RealtimeService = RealtimeService = RealtimeService_1 = __decorate([
+    (0, common_1.Injectable)()
+], RealtimeService);
+//# sourceMappingURL=realtime.service.js.map

package/dist/realtime/realtime.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.service.js","sourceRoot":"","sources":["../../src/realtime/realtime.service.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAmF;AACnF,mCAAoC;AACpC,iCAA2D;AAe3D;;;;;;;;;;GAUG;AAEI,IAAM,eAAe,uBAArB,MAAM,eAAe;IAArB;QACY,WAAM,GAAG,IAAI,eAAM,CAAC,iBAAe,CAAC,IAAI,CAAC,CAAC;QAC1C,eAAU,GAAG,IAAA,mBAAU,GAAE,CAAC;QAC1B,aAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACtD,YAAO,GAAG,oBAAoB,CAAC;QAExC,WAAM,GAAkB,IAAI,CAAC;QAC7B,mBAAc,GAA2B,IAAI,CAAC;QAC9C,oBAAe,GAA2B,IAAI,CAAC;QAEvD,6EAA6E;QAC5D,qBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC;IAkJhE,CAAC;IAhJC,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,eAAe;QACnB,MAAM,OAAO,CAAC,UAAU,CAAC;YACvB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC;YACpC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC;SACpC,CAAC,CAAC;IACL,CAAC;IAED,2DAA2D;IAC3D,SAAS,CAAC,MAAc;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAEO,QAAQ,CAAC,MAAuB;QACtC,OAAO,QAAQ,MAAM,EAAE,CAAC;IAC1B,CAAC;IACO,WAAW,CAAC,IAAY;QAC9B,OAAO,WAAW,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,+EAA+E;IAC/E,UAAU,CAAC,MAAuB,EAAE,KAAa,EAAE,OAAgB;QACjE,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,gEAAgE;IAChE,aAAa,CAAC,OAAe,EAAE,KAAa,EAAE,OAAgB;QAC5D,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,gDAAgD;IAChD,SAAS,CAAC,KAAa,EAAE,OAAgB;QACvC,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IAEO,QAAQ,CAAC,GAA8C;QAC7D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IAEO,SAAS,CAAC,GAA8C;QAC9D,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACzB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;QACvC,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACpE,CAAC;aAAM,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACrC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAEO,OAAO,CAAC,GAA8C;QAC5D,IAAI,CAAC,IAAI,CAAC,cAAc;YAAE,OAAO;QACjC,MAAM,IAAI,mCAAyB,GAAG,KAAE,gBAAgB,EAAE,IAAI,CAAC,UAAU,GAAE,CAAC;QAC5E,IAAI,CAAC,cAAc;aAChB,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;aAC3C,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CACf,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,4BAA4B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CACjF,CACF,CAAC;IACN,CAAC;IAEO,kBAAkB,CAAC,GAAW;QACpC,IAAI,GAAoB,CAAC;QACzB,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoB,CAAC;QAC3C,CAAC;QAAC,WAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,6DAA6D;QAC7D,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,gBAAgB,KAAK,IAAI,CAAC,UAAU;YAAE,OAAO;QAC7D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IAED,8EAA8E;IAE9E,0EAA0E;IAC1E,YAAY,CAAC,MAAc;;QACzB,MAAM,IAAI,GAAG,CAAC,MAAA,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,mCAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC1D,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0EAA0E;IAC1E,eAAe,CAAC,MAAc;;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,MAAA,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,mCAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACvE,IAAI,IAAI,KAAK,CAAC;YAAE,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;;YAChD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iEAAiE;IACjE,kBAAkB,CAAC,MAAc;;QAC/B,OAAO,CAAC,MAAA,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,mCAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC;IAED,8DAA8D;IAC9D,0BAA0B;QACxB,OAAO,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,8EAA8E;IAEtE,KAAK,CAAC,SAAS;QACrB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,4EAA4E,CAAC,CAAC;YAC9F,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG;gBACX,GAAG,EAAE,IAAI,CAAC,QAAQ;gBAClB,MAAM,EAAE,EAAE,iBAAiB,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE;aAClF,CAAC;YACF,IAAI,CAAC,cAAc,GAAG,IAAA,oBAAY,EAAC,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC,eAAe,GAAG,IAAA,oBAAY,EAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,WAAC,OAAA,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mCAAmC,MAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,OAAO,mCAAI,CAAC,EAAE,CAAC,CAAA,EAAA,CAAC,CAAC;YAC/G,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,WAAC,OAAA,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oCAAoC,MAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,OAAO,mCAAI,CAAC,EAAE,CAAC,CAAA,EAAA,CAAC,CAAC;YACjH,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;YACpC,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;YACrC,MAAM,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1F,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,6CAA6C,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,0CAA0C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAC/F,CAAC;YACF,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;YACtG,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;YAC3B,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC9B,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,SAAS,CAAC,MAA8B;QACpD,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,IAAI,CAAC;YACH,IAAI,MAAM,CAAC,MAAM;gBAAE,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACzC,CAAC;QAAC,WAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC;CACF,CAAA;AA7JY,0CAAe;0BAAf,eAAe;IAD3B,IAAA,mBAAU,GAAE;GACA,eAAe,CA6J3B"}

package/dist/redis/redis-pubsub.d.ts

@@ -0,0 +1,27 @@
+import { Logger } from '@nestjs/common';
+export type RedisPubSub = {
+    /** `false` means no Redis: publishing is a no-op and this process runs single-instance. */
+    readonly enabled: boolean;
+    publish(payload: unknown): Promise<void>;
+    close(): Promise<void>;
+};
+export type CreateRedisPubSubOptions = {
+    channel: string;
+    logger: Logger;
+    /** Used in log lines, e.g. `ai instruction` -> "Redis ai instruction sync enabled...". */
+    label: string;
+    onMessage: (raw: string) => void | Promise<void>;
+    /** Defaults to `REDIS_URL`, read at call time so tests can set it before init. */
+    url?: string;
+    errorLogCooldownMs?: number;
+};
+/**
+ * Publisher/subscriber pair on a single channel, mirroring the settings-sync
+ * pattern. Never throws: without a URL — or if the connection fails — it returns
+ * an inert handle and logs once.
+ *
+ * A dedicated subscriber connection is required: node-redis v4 puts a client in
+ * subscriber mode, where it can no longer issue regular commands.
+ */
+export declare function createRedisPubSub(options: CreateRedisPubSubOptions): Promise<RedisPubSub>;
+//# sourceMappingURL=redis-pubsub.d.ts.map

package/dist/redis/redis-pubsub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-pubsub.d.ts","sourceRoot":"","sources":["../../src/redis/redis-pubsub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGxC,MAAM,MAAM,WAAW,GAAG;IACxB,2FAA2F;IAC3F,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAmDF;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,WAAW,CAAC,CAkGtB"}

package/dist/redis/redis-pubsub.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRedisPubSub = createRedisPubSub;
+const redis_1 = require("redis");
+const DEFAULT_ERROR_LOG_COOLDOWN_MS = 30000;
+/**
+ * A connection failure must never take the client's data path down with it, so
+ * every error path here degrades to `INERT` and lets the caller keep serving
+ * from its local cache.
+ */
+const INERT = {
+    enabled: false,
+    async publish() {
+        // no-op
+    },
+    async close() {
+        // no-op
+    },
+};
+/**
+ * `createClient` rejects with an `AggregateError` whose own `message` is empty,
+ * so logging it directly yields "Redis error: " with nothing after it.
+ */
+function extractRedisErrorMessage(error) {
+    var _a;
+    if (error instanceof AggregateError && ((_a = error.errors) === null || _a === void 0 ? void 0 : _a.length)) {
+        return error.errors
+            .map((e) => (e instanceof Error ? e.message || e.toString() : String(e)))
+            .join('; ');
+    }
+    if (error instanceof Error) {
+        return error.message || error.toString();
+    }
+    return String(error);
+}
+async function safeClose(client) {
+    if (!client || !client.isOpen) {
+        return;
+    }
+    try {
+        await client.quit();
+    }
+    catch (_a) {
+        try {
+            client.disconnect();
+        }
+        catch (_b) {
+            // ignore shutdown errors
+        }
+    }
+}
+/**
+ * Publisher/subscriber pair on a single channel, mirroring the settings-sync
+ * pattern. Never throws: without a URL — or if the connection fails — it returns
+ * an inert handle and logs once.
+ *
+ * A dedicated subscriber connection is required: node-redis v4 puts a client in
+ * subscriber mode, where it can no longer issue regular commands.
+ */
+async function createRedisPubSub(options) {
+    var _a, _b;
+    const { channel, logger, label, onMessage } = options;
+    const url = String((_b = (_a = options.url) !== null && _a !== void 0 ? _a : process.env.REDIS_URL) !== null && _b !== void 0 ? _b : '').trim();
+    if (!url) {
+        logger.log(`Redis ${label} sync disabled because REDIS_URL is not configured.`);
+        return INERT;
+    }
+    const cooldownMs = Math.max(1000, Number(options.errorLogCooldownMs || DEFAULT_ERROR_LOG_COOLDOWN_MS));
+    // A Redis outage fires `error` on every reconnect attempt; unthrottled that
+    // buries every other log line in the pod.
+    const lastErrorLogAt = {
+        subscriber: 0,
+        publisher: 0,
+    };
+    const logClientError = (kind, error) => {
+        const now = Date.now();
+        if (now - lastErrorLogAt[kind] < cooldownMs) {
+            return;
+        }
+        lastErrorLogAt[kind] = now;
+        logger.warn(`Redis ${label} ${kind} error: ${extractRedisErrorMessage(error)}`);
+    };
+    let subscriber = null;
+    let publisher = null;
+    try {
+        const clientOptions = {
+            url,
+            socket: {
+                reconnectStrategy: (retries) => Math.min(retries * 250, 5000),
+            },
+        };
+        subscriber = (0, redis_1.createClient)(clientOptions);
+        publisher = (0, redis_1.createClient)(clientOptions);
+        // Registered before `connect` so a failure during the handshake is handled
+        // rather than thrown as an unhandled 'error' event.
+        subscriber.on('error', (error) => logClientError('subscriber', error));
+        publisher.on('error', (error) => logClientError('publisher', error));
+        await subscriber.connect();
+        await publisher.connect();
+        await subscriber.subscribe(channel, async (message) => {
+            try {
+                await onMessage(message);
+            }
+            catch (error) {
+                logger.warn(`Failed to handle Redis ${label} message: ${extractRedisErrorMessage(error)}`);
+            }
+        });
+        logger.log(`Redis ${label} sync enabled on channel ${channel}`);
+    }
+    catch (error) {
+        logger.warn(`Failed to initialize Redis ${label} sync: ${extractRedisErrorMessage(error)}`);
+        await Promise.allSettled([safeClose(subscriber), safeClose(publisher)]);
+        return INERT;
+    }
+    const activePublisher = publisher;
+    const activeSubscriber = subscriber;
+    let closed = false;
+    return {
+        enabled: true,
+        async publish(payload) {
+            if (closed || !activePublisher.isOpen) {
+                return;
+            }
+            try {
+                await activePublisher.publish(channel, JSON.stringify(payload));
+            }
+            catch (error) {
+                logger.warn(`Failed to publish Redis ${label} message: ${extractRedisErrorMessage(error)}`);
+            }
+        },
+        async close() {
+            if (closed) {
+                return;
+            }
+            closed = true;
+            await Promise.allSettled([safeClose(activeSubscriber), safeClose(activePublisher)]);
+        },
+    };
+}
+//# sourceMappingURL=redis-pubsub.js.map

package/dist/redis/redis-pubsub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-pubsub.js","sourceRoot":"","sources":["../../src/redis/redis-pubsub.ts"],"names":[],"mappings":"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"}