@lyxa.ai/core 1.4.297 → 1.4.298

package/dist/types/libraries/socket/connections/instance-disconnect.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.disconnectAllEntitiesFromInstance = disconnectAllEntitiesFromInstance;
+const instance_utils_1 = require("../../../utilities/instance.utils");
+const __1 = require("../../..");
+const keys_1 = require("./keys");
+const redis_helpers_1 = require("./redis-helpers");
+async function disconnectAllEntitiesFromInstance(entityType) {
+    const instanceId = (0, instance_utils_1.getInstanceId)();
+    const redis = (0, __1.getLibraries)().getRedisService();
+    const pattern = entityType
+        ? `socket:active_subscriptions:${entityType}:*`
+        : 'socket:active_subscriptions:*';
+    const ledgerKeys = await (0, redis_helpers_1.scanKeys)(redis.redisClient, pattern);
+    const affectedEvents = new Set();
+    await Promise.all(ledgerKeys.map(async (ledgerKey) => {
+        const [, , type, id] = ledgerKey.split(':');
+        const entity = {
+            id,
+            type: type === 'default' ? undefined : type,
+        };
+        const eventKeys = await redis.getSetMembers(ledgerKey);
+        const pipeline = redis.redisClient.pipeline();
+        for (const eventKey of eventKeys) {
+            const entityEventKey = (0, keys_1.kEntityEventSockets)(entity, eventKey);
+            const sockets = await redis.getSetMembers(entityEventKey);
+            const toRemove = sockets.filter(s => {
+                const [sInstanceId] = s.split('|');
+                return sInstanceId === instanceId;
+            });
+            for (const s of toRemove) {
+                pipeline.srem(entityEventKey, s);
+            }
+            if (sockets.length - toRemove.length === 0) {
+                pipeline.del(entityEventKey);
+                pipeline.srem(ledgerKey, eventKey);
+            }
+            affectedEvents.add(eventKey);
+        }
+        await pipeline.exec();
+    }));
+}
+//# sourceMappingURL=instance-disconnect.js.map

package/dist/types/libraries/socket/connections/instance-disconnect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-disconnect.js","sourceRoot":"/","sources":["libraries/socket/connections/instance-disconnect.ts"],"names":[],"mappings":";;AAgBA,8EAqCC;AApDD,sEAAkE;AAClE,gCAAwC;AACxC,iCAA0F;AAC1F,mDAA2C;AAYpC,KAAK,UAAU,iCAAiC,CAAC,UAA2B;IAClF,MAAM,UAAU,GAAG,IAAA,8BAAa,GAAE,CAAC;IACnC,MAAM,KAAK,GAAG,IAAA,gBAAY,GAAE,CAAC,eAAe,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,UAAU;QACzB,CAAC,CAAC,+BAA+B,UAAU,IAAI;QAC/C,CAAC,CAAC,+BAA+B,CAAC;IACnC,MAAM,UAAU,GAAG,MAAM,IAAA,wBAAQ,EAAC,KAAK,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC9D,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,MAAM,OAAO,CAAC,GAAG,CAChB,UAAU,CAAC,GAAG,CAAC,KAAK,EAAC,SAAS,EAAC,EAAE;QAChC,MAAM,CAAC,EAAE,AAAD,EAAG,IAAI,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAuB;YAClC,EAAE;YACF,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,IAAuB;SAC/D,CAAC;QACF,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;QAC9C,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YAClC,MAAM,cAAc,GAAG,IAAA,0BAAmB,EAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC7D,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;YAE1D,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;gBACnC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACnC,OAAO,WAAW,KAAK,UAAU,CAAC;YACnC,CAAC,CAAC,CAAC;YACH,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBAC1B,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;YAClC,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC5C,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;gBAC7B,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACpC,CAAC;YACD,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC;QACD,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC,CAAC,CACF,CAAC;AACH,CAAC","sourcesContent":["// Instance disconnect logic for socket Redis\nimport { getInstanceId } from '../../../utilities/instance.utils';\nimport { getLibraries } from '../../..';\nimport { kEntityEvent, kEntityEventSockets, entityKey, EntitySubscription } from './keys';\nimport { scanKeys } from './redis-helpers';\nimport { AuthEntityType } from '../../auth';\nimport { LRUCache } from './cache';\n\n/**\n * Removes all sockets belonging to the current instance.\n * Used on shutdown or crash recovery.\n * Cleans entity-event keys, event subscribers, and ledgers in bulk.\n *\n * NOTE: This currently scans all ledgers (SCAN), which is acceptable for small/medium scale and infrequent use.\n * For very large scale or frequent shutdowns, consider maintaining a reverse index (instance → ledgers) to avoid SCAN entirely.\n */\nexport async function disconnectAllEntitiesFromInstance(entityType?: AuthEntityType) {\n\tconst instanceId = getInstanceId();\n\tconst redis = getLibraries().getRedisService();\n\tconst pattern = entityType\n\t\t? `socket:active_subscriptions:${entityType}:*`\n\t\t: 'socket:active_subscriptions:*';\n\tconst ledgerKeys = await scanKeys(redis.redisClient, pattern);\n\tconst affectedEvents = new Set<string>();\n\tawait Promise.all(\n\t\tledgerKeys.map(async ledgerKey => {\n\t\t\tconst [, , type, id] = ledgerKey.split(':');\n\t\t\tconst entity: EntitySubscription = {\n\t\t\t\tid,\n\t\t\t\ttype: type === 'default' ? undefined : (type as AuthEntityType),\n\t\t\t};\n\t\t\tconst eventKeys = await redis.getSetMembers(ledgerKey);\n\t\t\tconst pipeline = redis.redisClient.pipeline();\n\t\t\tfor (const eventKey of eventKeys) {\n\t\t\t\tconst entityEventKey = kEntityEventSockets(entity, eventKey);\n\t\t\t\tconst sockets = await redis.getSetMembers(entityEventKey);\n\t\t\t\t// Remove all sockets for this instance\n\t\t\t\tconst toRemove = sockets.filter(s => {\n\t\t\t\t\tconst [sInstanceId] = s.split('|');\n\t\t\t\t\treturn sInstanceId === instanceId;\n\t\t\t\t});\n\t\t\t\tfor (const s of toRemove) {\n\t\t\t\t\tpipeline.srem(entityEventKey, s);\n\t\t\t\t}\n\t\t\t\tif (sockets.length - toRemove.length === 0) {\n\t\t\t\t\tpipeline.del(entityEventKey);\n\t\t\t\t\tpipeline.srem(ledgerKey, eventKey);\n\t\t\t\t}\n\t\t\t\taffectedEvents.add(eventKey);\n\t\t\t}\n\t\t\tawait pipeline.exec();\n\t\t})\n\t);\n}\n"]}

package/dist/types/libraries/socket/connections/keys.d.ts

@@ -0,0 +1,10 @@
+import { AuthEntityType } from '../../auth';
+export type EntitySubscription = {
+    id: string;
+    type?: AuthEntityType;
+};
+export declare const entityKey: (entity: EntitySubscription) => string;
+export declare const kEventEntity: (eventKey: string) => string;
+export declare const kEntityEvent: (entity: EntitySubscription) => string;
+export declare const kOnlineEntities: (type: AuthEntityType) => string;
+export declare const kEntityEventSockets: (entity: EntitySubscription, eventKey: string) => string;

package/dist/types/libraries/socket/connections/keys.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.kEntityEventSockets = exports.kOnlineEntities = exports.kEntityEvent = exports.kEventEntity = exports.entityKey = void 0;
+const keyCache = new Map();
+const entityKey = (entity) => {
+    const cacheKey = `${entity.type}:${entity.id}`;
+    let key = keyCache.get(cacheKey);
+    if (!key) {
+        key = `${entity.type ?? 'default'}:${entity.id}`;
+        keyCache.set(cacheKey, key);
+    }
+    return key;
+};
+exports.entityKey = entityKey;
+const kEventEntity = (eventKey) => `socket:event:${eventKey}`;
+exports.kEventEntity = kEventEntity;
+const kEntityEvent = (entity) => `socket:subscriptions:${(0, exports.entityKey)(entity)}`;
+exports.kEntityEvent = kEntityEvent;
+const kOnlineEntities = (type) => `socket:online:${type}`;
+exports.kOnlineEntities = kOnlineEntities;
+const kEntityEventSockets = (entity, eventKey) => `socket:entity:${(0, exports.entityKey)(entity)}:${eventKey}`;
+exports.kEntityEventSockets = kEntityEventSockets;
+//# sourceMappingURL=keys.js.map

package/dist/types/libraries/socket/connections/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"/","sources":["libraries/socket/connections/keys.ts"],"names":[],"mappings":";;;AAOA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;AAEpC,MAAM,SAAS,GAAG,CAAC,MAA0B,EAAU,EAAE;IAC/D,MAAM,QAAQ,GAAG,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;IAC/C,IAAI,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACjC,IAAI,CAAC,GAAG,EAAE,CAAC;QACV,GAAG,GAAG,GAAG,MAAM,CAAC,IAAI,IAAI,SAAS,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACjD,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC,CAAC;AARW,QAAA,SAAS,aAQpB;AAEK,MAAM,YAAY,GAAG,CAAC,QAAgB,EAAE,EAAE,CAAC,gBAAgB,QAAQ,EAAE,CAAC;AAAhE,QAAA,YAAY,gBAAoD;AAEtE,MAAM,YAAY,GAAG,CAAC,MAA0B,EAAE,EAAE,CAAC,wBAAwB,IAAA,iBAAS,EAAC,MAAM,CAAC,EAAE,CAAC;AAA3F,QAAA,YAAY,gBAA+E;AAEjG,MAAM,eAAe,GAAG,CAAC,IAAoB,EAAE,EAAE,CAAC,iBAAiB,IAAI,EAAE,CAAC;AAApE,QAAA,eAAe,mBAAqD;AAE1E,MAAM,mBAAmB,GAAG,CAAC,MAA0B,EAAE,QAAgB,EAAE,EAAE,CACnF,iBAAiB,IAAA,iBAAS,EAAC,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;AADrC,QAAA,mBAAmB,uBACkB","sourcesContent":["import { AuthEntityType } from '../../auth';\n\nexport type EntitySubscription = {\n\tid: string;\n\ttype?: AuthEntityType;\n};\n\nconst keyCache = new Map<string, string>();\n\nexport const entityKey = (entity: EntitySubscription): string => {\n\tconst cacheKey = `${entity.type}:${entity.id}`;\n\tlet key = keyCache.get(cacheKey);\n\tif (!key) {\n\t\tkey = `${entity.type ?? 'default'}:${entity.id}`;\n\t\tkeyCache.set(cacheKey, key);\n\t}\n\treturn key;\n};\n\nexport const kEventEntity = (eventKey: string) => `socket:event:${eventKey}`;\n\nexport const kEntityEvent = (entity: EntitySubscription) => `socket:subscriptions:${entityKey(entity)}`;\n\nexport const kOnlineEntities = (type: AuthEntityType) => `socket:online:${type}`;\n\nexport const kEntityEventSockets = (entity: EntitySubscription, eventKey: string) =>\n\t`socket:entity:${entityKey(entity)}:${eventKey}`;\n"]}

package/dist/types/libraries/socket/connections/presence.d.ts

@@ -0,0 +1,6 @@
+import { AuthEntityType } from '../../auth';
+export declare function setUserOnline(userId: string, type: AuthEntityType, timestamp?: number): Promise<void>;
+export declare function setUserOffline(userId: string, type: AuthEntityType): Promise<void>;
+export declare function getOnlineUsers(type: AuthEntityType, page?: number, pageSize?: number): Promise<string[]>;
+export declare function getOnlineUsersCount(type: AuthEntityType, activeWindowMs?: number): Promise<number>;
+export declare function isUserOnline(userId: string, type: AuthEntityType): Promise<boolean>;

package/dist/types/libraries/socket/connections/presence.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setUserOnline = setUserOnline;
+exports.setUserOffline = setUserOffline;
+exports.getOnlineUsers = getOnlineUsers;
+exports.getOnlineUsersCount = getOnlineUsersCount;
+exports.isUserOnline = isUserOnline;
+const __1 = require("../../..");
+const dayjs_1 = require("../../../utilities/dayjs");
+const keys_1 = require("./keys");
+async function setUserOnline(userId, type, timestamp = Date.now()) {
+    const redis = (0, __1.getLibraries)().getRedisService().redisClient;
+    await redis.zadd((0, keys_1.kOnlineEntities)(type), timestamp, userId);
+}
+async function setUserOffline(userId, type) {
+    const redis = (0, __1.getLibraries)().getRedisService().redisClient;
+    await redis.zrem((0, keys_1.kOnlineEntities)(type), userId);
+}
+async function getOnlineUsers(type, page = 1, pageSize = 100) {
+    const redis = (0, __1.getLibraries)().getRedisService().redisClient;
+    const zsetKey = (0, keys_1.kOnlineEntities)(type);
+    const start = (page - 1) * pageSize;
+    const end = start + pageSize - 1;
+    return await redis.zrange(zsetKey, start, end);
+}
+async function getOnlineUsersCount(type, activeWindowMs = 60000) {
+    const redis = (0, __1.getLibraries)().getRedisService().redisClient;
+    const zsetKey = (0, keys_1.kOnlineEntities)(type);
+    const now = (0, dayjs_1.dayjs)().valueOf();
+    const min = now - activeWindowMs;
+    await redis.zremrangebyscore(zsetKey, 0, min);
+    return await redis.zcount(zsetKey, min, now);
+}
+async function isUserOnline(userId, type) {
+    const redis = (0, __1.getLibraries)().getRedisService().redisClient;
+    const score = await redis.zscore((0, keys_1.kOnlineEntities)(type), userId);
+    return score !== null;
+}
+//# sourceMappingURL=presence.js.map

package/dist/types/libraries/socket/connections/presence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.js","sourceRoot":"/","sources":["libraries/socket/connections/presence.ts"],"names":[],"mappings":";;AASA,sCAGC;AAKD,wCAGC;AAKD,wCAUC;AAED,kDAaC;AAED,oCAIC;AAxDD,gCAAwC;AACxC,oDAAiD;AAEjD,iCAAyC;AAMlC,KAAK,UAAU,aAAa,CAAC,MAAc,EAAE,IAAoB,EAAE,YAAoB,IAAI,CAAC,GAAG,EAAE;IACvG,MAAM,KAAK,GAAG,IAAA,gBAAY,GAAE,CAAC,eAAe,EAAE,CAAC,WAAoB,CAAC;IACpE,MAAM,KAAK,CAAC,IAAI,CAAC,IAAA,sBAAe,EAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;AAC5D,CAAC;AAKM,KAAK,UAAU,cAAc,CAAC,MAAc,EAAE,IAAoB;IACxE,MAAM,KAAK,GAAG,IAAA,gBAAY,GAAE,CAAC,eAAe,EAAE,CAAC,WAAoB,CAAC;IACpE,MAAM,KAAK,CAAC,IAAI,CAAC,IAAA,sBAAe,EAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC;AAKM,KAAK,UAAU,cAAc,CACnC,IAAoB,EACpB,OAAe,CAAC,EAChB,WAAmB,GAAG;IAEtB,MAAM,KAAK,GAAG,IAAA,gBAAY,GAAE,CAAC,eAAe,EAAE,CAAC,WAAoB,CAAC;IACpE,MAAM,OAAO,GAAG,IAAA,sBAAe,EAAC,IAAI,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC;IACpC,MAAM,GAAG,GAAG,KAAK,GAAG,QAAQ,GAAG,CAAC,CAAC;IACjC,OAAO,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;AAChD,CAAC;AAEM,KAAK,UAAU,mBAAmB,CACxC,IAAoB,EACpB,iBAAyB,KAAK;IAE9B,MAAM,KAAK,GAAG,IAAA,gBAAY,GAAE,CAAC,eAAe,EAAE,CAAC,WAAoB,CAAC;IACpE,MAAM,OAAO,GAAG,IAAA,sBAAe,EAAC,IAAI,CAAC,CAAC;IAEtC,MAAM,GAAG,GAAG,IAAA,aAAK,GAAE,CAAC,OAAO,EAAE,CAAC;IAC9B,MAAM,GAAG,GAAG,GAAG,GAAG,cAAc,CAAC;IAEjC,MAAM,KAAK,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;IAE9C,OAAO,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAC9C,CAAC;AAEM,KAAK,UAAU,YAAY,CAAC,MAAc,EAAE,IAAoB;IACtE,MAAM,KAAK,GAAG,IAAA,gBAAY,GAAE,CAAC,eAAe,EAAE,CAAC,WAAoB,CAAC;IACpE,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAA,sBAAe,EAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IAChE,OAAO,KAAK,KAAK,IAAI,CAAC;AACvB,CAAC","sourcesContent":["import { getLibraries } from '../../..';\nimport { dayjs } from '../../../utilities/dayjs';\nimport { AuthEntityType } from '../../auth';\nimport { kOnlineEntities } from './keys';\nimport type { Redis } from 'ioredis';\n\n/**\n * Add or update a user as online in the type-based ZSET.\n */\nexport async function setUserOnline(userId: string, type: AuthEntityType, timestamp: number = Date.now()) {\n\tconst redis = getLibraries().getRedisService().redisClient as Redis;\n\tawait redis.zadd(kOnlineEntities(type), timestamp, userId);\n}\n\n/**\n * Remove a user from the type-based online ZSET (on disconnect).\n */\nexport async function setUserOffline(userId: string, type: AuthEntityType) {\n\tconst redis = getLibraries().getRedisService().redisClient as Redis;\n\tawait redis.zrem(kOnlineEntities(type), userId);\n}\n\n/**\n * Paginate online users for a given entity type (deep pagination, scalable).\n */\nexport async function getOnlineUsers(\n\ttype: AuthEntityType,\n\tpage: number = 1,\n\tpageSize: number = 100\n): Promise<string[]> {\n\tconst redis = getLibraries().getRedisService().redisClient as Redis;\n\tconst zsetKey = kOnlineEntities(type);\n\tconst start = (page - 1) * pageSize;\n\tconst end = start + pageSize - 1;\n\treturn await redis.zrange(zsetKey, start, end);\n}\n\nexport async function getOnlineUsersCount(\n\ttype: AuthEntityType,\n\tactiveWindowMs: number = 60000\n): Promise<number> {\n\tconst redis = getLibraries().getRedisService().redisClient as Redis;\n\tconst zsetKey = kOnlineEntities(type);\n\n\tconst now = dayjs().valueOf();\n\tconst min = now - activeWindowMs;\n\n\tawait redis.zremrangebyscore(zsetKey, 0, min);\n\n\treturn await redis.zcount(zsetKey, min, now);\n}\n\nexport async function isUserOnline(userId: string, type: AuthEntityType): Promise<boolean> {\n\tconst redis = getLibraries().getRedisService().redisClient as Redis;\n\tconst score = await redis.zscore(kOnlineEntities(type), userId);\n\treturn score !== null;\n}\n\n/**\n * Example usage:\n *\n * import { getConnectedEntityByType } from './type-queries';\n *\n * // For entity type 'user', get page 2, 100 per page:\n * const users = await getConnectedEntityByType('user', 2, 100);\n */\n"]}

package/dist/types/libraries/socket/connections/redis-helpers.d.ts

@@ -0,0 +1,2 @@
+import type { Redis } from 'ioredis';
+export declare function scanKeys(redis: Redis, pattern: string): Promise<string[]>;

package/dist/types/libraries/socket/connections/redis-helpers.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanKeys = scanKeys;
+async function scanKeys(redis, pattern) {
+    const keys = [];
+    let cursor = '0';
+    do {
+        const [newCursor, foundKeys] = await redis.scan(cursor, 'MATCH', pattern, 'COUNT', 100);
+        cursor = newCursor;
+        keys.push(...foundKeys);
+    } while (cursor !== '0');
+    return keys;
+}
+//# sourceMappingURL=redis-helpers.js.map

package/dist/types/libraries/socket/connections/redis-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-helpers.js","sourceRoot":"/","sources":["libraries/socket/connections/redis-helpers.ts"],"names":[],"mappings":";;AAGA,4BASC;AATM,KAAK,UAAU,QAAQ,CAAC,KAAY,EAAE,OAAe;IAC3D,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,MAAM,GAAG,GAAG,CAAC;IACjB,GAAG,CAAC;QACH,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QACxF,MAAM,GAAG,SAAS,CAAC;QACnB,IAAI,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IACzB,CAAC,QAAQ,MAAM,KAAK,GAAG,EAAE;IACzB,OAAO,IAAI,CAAC;AACb,CAAC","sourcesContent":["// Redis set helpers for socket logic\nimport type { Redis } from 'ioredis';\n\nexport async function scanKeys(redis: Redis, pattern: string): Promise<string[]> {\n\tconst keys: string[] = [];\n\tlet cursor = '0';\n\tdo {\n\t\tconst [newCursor, foundKeys] = await redis.scan(cursor, 'MATCH', pattern, 'COUNT', 100);\n\t\tcursor = newCursor;\n\t\tkeys.push(...foundKeys);\n\t} while (cursor !== '0');\n\treturn keys;\n}\n"]}

package/dist/types/libraries/socket/connections/subscription.d.ts

@@ -0,0 +1,13 @@
+import { EntitySubscription } from './keys';
+export interface SocketRedisEventInformation {
+    eventKey: string;
+    instanceId: string;
+    socketId: string;
+}
+export declare function connectEntityToSocketEvent(entity: EntitySubscription, socketRedisEventInformation: SocketRedisEventInformation): Promise<void>;
+export declare function disconnectEntityFromSocketEvent(entity: EntitySubscription, socketRedisEventInformation: SocketRedisEventInformation): Promise<{
+    removed: boolean;
+    socketsRemoved: number;
+    subscribersRemoved: number;
+}>;
+export declare function refreshEntityEventTTL(entity: EntitySubscription): Promise<void>;

package/dist/types/libraries/socket/connections/subscription.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectEntityToSocketEvent = connectEntityToSocketEvent;
+exports.disconnectEntityFromSocketEvent = disconnectEntityFromSocketEvent;
+exports.refreshEntityEventTTL = refreshEntityEventTTL;
+const __1 = require("../../..");
+const keys_1 = require("./keys");
+const constants_1 = require("./constants");
+const cache_1 = require("./cache");
+const subscriptionCache = new cache_1.LRUCache(10000);
+const eventSubscribersCache = new cache_1.LRUCache(5000);
+async function connectEntityToSocketEvent(entity, socketRedisEventInformation) {
+    const redis = (0, __1.getLibraries)().getRedisService();
+    const entityKeyStr = (0, keys_1.entityKey)(entity);
+    const { instanceId, socketId, eventKey } = socketRedisEventInformation;
+    const socketData = `${instanceId}|${socketId}`;
+    const subscriberData = `${entityKeyStr}|${instanceId}|${socketId}`;
+    const entityEventKey = (0, keys_1.kEntityEventSockets)(entity, eventKey);
+    const eventSubsKey = (0, keys_1.kEventEntity)(eventKey);
+    const ledgerKey = (0, keys_1.kEntityEvent)(entity);
+    await Promise.all([
+        redis.addToSet(entityEventKey, socketData),
+        redis.addToSet(eventSubsKey, subscriberData),
+        redis.addToSet(ledgerKey, eventKey),
+    ]);
+    await Promise.all([
+        redis.redisClient.expire(entityEventKey, constants_1.REDIS_KEY_TTL_SECONDS),
+        redis.redisClient.expire(eventSubsKey, constants_1.REDIS_KEY_TTL_SECONDS),
+        redis.redisClient.expire(ledgerKey, constants_1.REDIS_KEY_TTL_SECONDS),
+    ]);
+    subscriptionCache.delete(`${entityKeyStr}:${eventKey}`);
+    eventSubscribersCache.delete(eventKey);
+}
+async function disconnectEntityFromSocketEvent(entity, socketRedisEventInformation) {
+    const redis = (0, __1.getLibraries)().getRedisService();
+    const entityKeyStr = (0, keys_1.entityKey)(entity);
+    const { instanceId, socketId, eventKey } = socketRedisEventInformation;
+    const entityEventKey = (0, keys_1.kEntityEventSockets)(entity, eventKey);
+    const eventSubsKey = (0, keys_1.kEventEntity)(eventKey);
+    const ledgerKey = (0, keys_1.kEntityEvent)(entity);
+    const socketData = `${instanceId}|${socketId}`;
+    const subscriberData = `${entityKeyStr}|${instanceId}|${socketId}`;
+    await Promise.all([
+        redis.removeFromSet(entityEventKey, socketData),
+        redis.removeFromSet(eventSubsKey, subscriberData),
+    ]);
+    const entitySockets = await redis.getSetMembers(entityEventKey);
+    if (entitySockets.length === 0) {
+        await Promise.all([redis.deleteCachedObject(entityEventKey), redis.removeFromSet(ledgerKey, eventKey)]);
+    }
+    subscriptionCache.delete(`${entityKeyStr}:${eventKey}`);
+    eventSubscribersCache.delete(eventKey);
+    return {
+        removed: true,
+        socketsRemoved: 1,
+        subscribersRemoved: 1,
+    };
+}
+async function refreshEntityEventTTL(entity) {
+    const redis = (0, __1.getLibraries)().getRedisService();
+    const ledgerKey = (0, keys_1.kEntityEvent)(entity);
+    const activeEvents = await redis.getSetMembers(ledgerKey);
+    if (!activeEvents.length)
+        return;
+    const pipeline = redis.redisClient.pipeline();
+    pipeline.expire(ledgerKey, constants_1.REDIS_KEY_TTL_SECONDS);
+    for (const eventKey of activeEvents) {
+        pipeline.expire((0, keys_1.kEntityEventSockets)(entity, eventKey), constants_1.REDIS_KEY_TTL_SECONDS);
+        pipeline.expire((0, keys_1.kEventEntity)(eventKey), constants_1.REDIS_KEY_TTL_SECONDS);
+    }
+    await pipeline.exec();
+}
+//# sourceMappingURL=subscription.js.map

package/dist/types/libraries/socket/connections/subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.js","sourceRoot":"/","sources":["libraries/socket/connections/subscription.ts"],"names":[],"mappings":";;AAoBA,gEAwBC;AAED,0EA2BC;AAED,sDAYC;AAtFD,gCAAwC;AACxC,iCAAwG;AACxG,2CAAoD;AACpD,mCAAmC;AAQnC,MAAM,iBAAiB,GAAG,IAAI,gBAAQ,CAGpC,KAAK,CAAC,CAAC;AACT,MAAM,qBAAqB,GAAG,IAAI,gBAAQ,CACzC,IAAI,CACJ,CAAC;AAEK,KAAK,UAAU,0BAA0B,CAC/C,MAA0B,EAC1B,2BAAwD;IAExD,MAAM,KAAK,GAAG,IAAA,gBAAY,GAAE,CAAC,eAAe,EAAE,CAAC;IAC/C,MAAM,YAAY,GAAG,IAAA,gBAAS,EAAC,MAAM,CAAC,CAAC;IACvC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,2BAA2B,CAAC;IACvE,MAAM,UAAU,GAAG,GAAG,UAAU,IAAI,QAAQ,EAAE,CAAC;IAC/C,MAAM,cAAc,GAAG,GAAG,YAAY,IAAI,UAAU,IAAI,QAAQ,EAAE,CAAC;IACnE,MAAM,cAAc,GAAG,IAAA,0BAAmB,EAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG,IAAA,mBAAY,EAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAA,mBAAY,EAAC,MAAM,CAAC,CAAC;IACvC,MAAM,OAAO,CAAC,GAAG,CAAC;QACjB,KAAK,CAAC,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAC;QAC1C,KAAK,CAAC,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;QAC5C,KAAK,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC;KACnC,CAAC,CAAC;IACH,MAAM,OAAO,CAAC,GAAG,CAAC;QACjB,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,cAAc,EAAE,iCAAqB,CAAC;QAC/D,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,YAAY,EAAE,iCAAqB,CAAC;QAC7D,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,EAAE,iCAAqB,CAAC;KAC1D,CAAC,CAAC;IACH,iBAAiB,CAAC,MAAM,CAAC,GAAG,YAAY,IAAI,QAAQ,EAAE,CAAC,CAAC;IACxD,qBAAqB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACxC,CAAC;AAEM,KAAK,UAAU,+BAA+B,CACpD,MAA0B,EAC1B,2BAAwD;IAExD,MAAM,KAAK,GAAG,IAAA,gBAAY,GAAE,CAAC,eAAe,EAAE,CAAC;IAC/C,MAAM,YAAY,GAAG,IAAA,gBAAS,EAAC,MAAM,CAAC,CAAC;IACvC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,2BAA2B,CAAC;IACvE,MAAM,cAAc,GAAG,IAAA,0BAAmB,EAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG,IAAA,mBAAY,EAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAA,mBAAY,EAAC,MAAM,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,GAAG,UAAU,IAAI,QAAQ,EAAE,CAAC;IAC/C,MAAM,cAAc,GAAG,GAAG,YAAY,IAAI,UAAU,IAAI,QAAQ,EAAE,CAAC;IACnE,MAAM,OAAO,CAAC,GAAG,CAAC;QACjB,KAAK,CAAC,aAAa,CAAC,cAAc,EAAE,UAAU,CAAC;QAC/C,KAAK,CAAC,aAAa,CAAC,YAAY,EAAE,cAAc,CAAC;KACjD,CAAC,CAAC;IACH,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;IAChE,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACzG,CAAC;IACD,iBAAiB,CAAC,MAAM,CAAC,GAAG,YAAY,IAAI,QAAQ,EAAE,CAAC,CAAC;IACxD,qBAAqB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO;QACN,OAAO,EAAE,IAAI;QACb,cAAc,EAAE,CAAC;QACjB,kBAAkB,EAAE,CAAC;KACrB,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,qBAAqB,CAAC,MAA0B;IACrE,MAAM,KAAK,GAAG,IAAA,gBAAY,GAAE,CAAC,eAAe,EAAE,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAA,mBAAY,EAAC,MAAM,CAAC,CAAC;IACvC,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IAC1D,IAAI,CAAC,YAAY,CAAC,MAAM;QAAE,OAAO;IACjC,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;IAC9C,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,iCAAqB,CAAC,CAAC;IAClD,KAAK,MAAM,QAAQ,IAAI,YAAY,EAAE,CAAC;QACrC,QAAQ,CAAC,MAAM,CAAC,IAAA,0BAAmB,EAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,iCAAqB,CAAC,CAAC;QAC9E,QAAQ,CAAC,MAAM,CAAC,IAAA,mBAAY,EAAC,QAAQ,CAAC,EAAE,iCAAqB,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC","sourcesContent":["// Subscription management logic for socket Redis\nimport { getLibraries } from '../../..';\nimport { kEntityEventSockets, kEventEntity, kEntityEvent, entityKey, EntitySubscription } from './keys';\nimport { REDIS_KEY_TTL_SECONDS } from './constants';\nimport { LRUCache } from './cache';\n\nexport interface SocketRedisEventInformation {\n\teventKey: string;\n\tinstanceId: string;\n\tsocketId: string;\n}\n\nconst subscriptionCache = new LRUCache<\n\tstring,\n\t{ isSubscribed: boolean; instances: string[]; timestamp: number }\n>(10000);\nconst eventSubscribersCache = new LRUCache<string, { subscribers: EntitySubscription[]; timestamp: number }>(\n\t5000\n);\n\nexport async function connectEntityToSocketEvent(\n\tentity: EntitySubscription,\n\tsocketRedisEventInformation: SocketRedisEventInformation\n) {\n\tconst redis = getLibraries().getRedisService();\n\tconst entityKeyStr = entityKey(entity);\n\tconst { instanceId, socketId, eventKey } = socketRedisEventInformation;\n\tconst socketData = `${instanceId}|${socketId}`;\n\tconst subscriberData = `${entityKeyStr}|${instanceId}|${socketId}`;\n\tconst entityEventKey = kEntityEventSockets(entity, eventKey);\n\tconst eventSubsKey = kEventEntity(eventKey);\n\tconst ledgerKey = kEntityEvent(entity);\n\tawait Promise.all([\n\t\tredis.addToSet(entityEventKey, socketData),\n\t\tredis.addToSet(eventSubsKey, subscriberData),\n\t\tredis.addToSet(ledgerKey, eventKey),\n\t]);\n\tawait Promise.all([\n\t\tredis.redisClient.expire(entityEventKey, REDIS_KEY_TTL_SECONDS),\n\t\tredis.redisClient.expire(eventSubsKey, REDIS_KEY_TTL_SECONDS),\n\t\tredis.redisClient.expire(ledgerKey, REDIS_KEY_TTL_SECONDS),\n\t]);\n\tsubscriptionCache.delete(`${entityKeyStr}:${eventKey}`);\n\teventSubscribersCache.delete(eventKey);\n}\n\nexport async function disconnectEntityFromSocketEvent(\n\tentity: EntitySubscription,\n\tsocketRedisEventInformation: SocketRedisEventInformation\n) {\n\tconst redis = getLibraries().getRedisService();\n\tconst entityKeyStr = entityKey(entity);\n\tconst { instanceId, socketId, eventKey } = socketRedisEventInformation;\n\tconst entityEventKey = kEntityEventSockets(entity, eventKey);\n\tconst eventSubsKey = kEventEntity(eventKey);\n\tconst ledgerKey = kEntityEvent(entity);\n\tconst socketData = `${instanceId}|${socketId}`;\n\tconst subscriberData = `${entityKeyStr}|${instanceId}|${socketId}`;\n\tawait Promise.all([\n\t\tredis.removeFromSet(entityEventKey, socketData),\n\t\tredis.removeFromSet(eventSubsKey, subscriberData),\n\t]);\n\tconst entitySockets = await redis.getSetMembers(entityEventKey);\n\tif (entitySockets.length === 0) {\n\t\tawait Promise.all([redis.deleteCachedObject(entityEventKey), redis.removeFromSet(ledgerKey, eventKey)]);\n\t}\n\tsubscriptionCache.delete(`${entityKeyStr}:${eventKey}`);\n\teventSubscribersCache.delete(eventKey);\n\treturn {\n\t\tremoved: true,\n\t\tsocketsRemoved: 1,\n\t\tsubscribersRemoved: 1,\n\t};\n}\n\nexport async function refreshEntityEventTTL(entity: EntitySubscription) {\n\tconst redis = getLibraries().getRedisService();\n\tconst ledgerKey = kEntityEvent(entity);\n\tconst activeEvents = await redis.getSetMembers(ledgerKey);\n\tif (!activeEvents.length) return;\n\tconst pipeline = redis.redisClient.pipeline();\n\tpipeline.expire(ledgerKey, REDIS_KEY_TTL_SECONDS);\n\tfor (const eventKey of activeEvents) {\n\t\tpipeline.expire(kEntityEventSockets(entity, eventKey), REDIS_KEY_TTL_SECONDS);\n\t\tpipeline.expire(kEventEntity(eventKey), REDIS_KEY_TTL_SECONDS);\n\t}\n\tawait pipeline.exec();\n}\n"]}

package/dist/types/libraries/socket/core/index.d.ts

@@ -0,0 +1,6 @@
+export * from '../BaseSocketEvent';
+export * from './local-subscription-registry';
+export * from './socket-event-registry';
+export * from './zAsyncIterable';
+export * from './socket-event-publisher';
+export * from './socket-event-consumer';

package/dist/types/libraries/socket/core/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("../BaseSocketEvent"), exports);
+__exportStar(require("./local-subscription-registry"), exports);
+__exportStar(require("./socket-event-registry"), exports);
+__exportStar(require("./zAsyncIterable"), exports);
+__exportStar(require("./socket-event-publisher"), exports);
+__exportStar(require("./socket-event-consumer"), exports);
+//# sourceMappingURL=index.js.map

package/dist/types/libraries/socket/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"/","sources":["libraries/socket/core/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,gEAA8C;AAC9C,0DAAwC;AACxC,mDAAiC;AACjC,2DAAyC;AACzC,0DAAwC","sourcesContent":["export * from '../BaseSocketEvent';\nexport * from './local-subscription-registry';\nexport * from './socket-event-registry';\nexport * from './zAsyncIterable';\nexport * from './socket-event-publisher';\nexport * from './socket-event-consumer';\n"]}

package/dist/types/libraries/socket/core/local-subscription-registry.d.ts

@@ -0,0 +1,17 @@
+import EventEmitter from 'events';
+import { EntitySubscription } from '../connections';
+type EventKey = string;
+type SocketId = string;
+export declare class LocalEventEmitter {
+    readonly ee: EventEmitter;
+    readonly socketId: SocketId;
+    constructor(socketId: SocketId);
+}
+declare class LocalSubscriptionRegistry {
+    private listeners;
+    bind(entity: EntitySubscription, eventKey: EventKey, ee: LocalEventEmitter): void;
+    unbind(entity: EntitySubscription, eventKey: EventKey, ee: LocalEventEmitter): void;
+    emit(entity: EntitySubscription, eventKey: EventKey, payload: unknown): void;
+}
+export declare const LocalSubs: LocalSubscriptionRegistry;
+export {};

package/dist/types/libraries/socket/core/local-subscription-registry.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalSubs = exports.LocalEventEmitter = void 0;
+const events_1 = __importDefault(require("events"));
+const keyCache = new Map();
+const entityKey = (entity) => {
+    const raw = `${entity.type ?? 'default'}:${entity.id}`;
+    let cached = keyCache.get(raw);
+    if (!cached) {
+        cached = raw;
+        keyCache.set(raw, cached);
+    }
+    return cached;
+};
+class LocalEventEmitter {
+    ee;
+    socketId;
+    constructor(socketId) {
+        this.ee = new events_1.default();
+        this.ee.setMaxListeners(0);
+        this.socketId = socketId;
+    }
+}
+exports.LocalEventEmitter = LocalEventEmitter;
+class LocalSubscriptionRegistry {
+    listeners = new Map();
+    bind(entity, eventKey, ee) {
+        const key = `${entityKey(entity)}:${eventKey}`;
+        let listenerSet = this.listeners.get(key);
+        if (!listenerSet) {
+            listenerSet = new Set();
+            this.listeners.set(key, listenerSet);
+        }
+        listenerSet.add(ee);
+    }
+    unbind(entity, eventKey, ee) {
+        const key = `${entityKey(entity)}:${eventKey}`;
+        const listenerSet = this.listeners.get(key);
+        if (listenerSet) {
+            listenerSet.delete(ee);
+            if (listenerSet.size === 0) {
+                this.listeners.delete(key);
+            }
+        }
+    }
+    emit(entity, eventKey, payload) {
+        const key = `${entityKey(entity)}:${eventKey}`;
+        const listeners = this.listeners.get(key);
+        if (!listeners)
+            return;
+        for (const listener of listeners) {
+            listener.ee.emit(eventKey, payload);
+        }
+    }
+}
+exports.LocalSubs = new LocalSubscriptionRegistry();
+//# sourceMappingURL=local-subscription-registry.js.map

package/dist/types/libraries/socket/core/local-subscription-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-subscription-registry.js","sourceRoot":"/","sources":["libraries/socket/core/local-subscription-registry.ts"],"names":[],"mappings":";;;;;;AAAA,oDAAkC;AAOlC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;AAC3C,MAAM,SAAS,GAAG,CAAC,MAA0B,EAAU,EAAE;IACxD,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,IAAI,IAAI,SAAS,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;IACvD,IAAI,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,CAAC;QACb,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC,CAAC;AAGF,MAAa,iBAAiB;IACpB,EAAE,CAAe;IACjB,QAAQ,CAAW;IAE5B,YAAY,QAAkB;QAC7B,IAAI,CAAC,EAAE,GAAG,IAAI,gBAAY,EAAE,CAAC;QAC7B,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC1B,CAAC;CACD;AATD,8CASC;AAED,MAAM,yBAAyB;IAEtB,SAAS,GAAG,IAAI,GAAG,EAAkC,CAAC;IAE9D,IAAI,CAAC,MAA0B,EAAE,QAAkB,EAAE,EAAqB;QACzE,MAAM,GAAG,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QAC/C,IAAI,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE1C,IAAI,CAAC,WAAW,EAAE,CAAC;YAClB,WAAW,GAAG,IAAI,GAAG,EAAE,CAAC;YACxB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QACtC,CAAC;QAED,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,MAA0B,EAAE,QAAkB,EAAE,EAAqB;QAC3E,MAAM,GAAG,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE5C,IAAI,WAAW,EAAE,CAAC;YACjB,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACvB,IAAI,WAAW,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBAC5B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC5B,CAAC;QACF,CAAC;IACF,CAAC;IAGD,IAAI,CAAC,MAA0B,EAAE,QAAkB,EAAE,OAAgB;QACpE,MAAM,GAAG,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE1C,IAAI,CAAC,SAAS;YAAE,OAAO;QAGvB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YAClC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrC,CAAC;IACF,CAAC;CACD;AAEY,QAAA,SAAS,GAAG,IAAI,yBAAyB,EAAE,CAAC","sourcesContent":["import EventEmitter from 'events';\nimport { EntitySubscription } from '../connections';\n\ntype EventKey = string;\ntype SocketId = string;\n\n// Zero-overhead key with memoization\nconst keyCache = new Map<string, string>();\nconst entityKey = (entity: EntitySubscription): string => {\n\tconst raw = `${entity.type ?? 'default'}:${entity.id}`;\n\tlet cached = keyCache.get(raw);\n\tif (!cached) {\n\t\tcached = raw;\n\t\tkeyCache.set(raw, cached);\n\t}\n\treturn cached;\n};\n\n// Remove wrapper class - direct EventEmitter usage\nexport class LocalEventEmitter {\n\treadonly ee: EventEmitter;\n\treadonly socketId: SocketId;\n\n\tconstructor(socketId: SocketId) {\n\t\tthis.ee = new EventEmitter();\n\t\tthis.ee.setMaxListeners(0); // Unlimited listeners\n\t\tthis.socketId = socketId;\n\t}\n}\n\nclass LocalSubscriptionRegistry {\n\t// Direct map for O(1) lookups with minimal overhead\n\tprivate listeners = new Map<string, Set<LocalEventEmitter>>();\n\n\tbind(entity: EntitySubscription, eventKey: EventKey, ee: LocalEventEmitter): void {\n\t\tconst key = `${entityKey(entity)}:${eventKey}`;\n\t\tlet listenerSet = this.listeners.get(key);\n\n\t\tif (!listenerSet) {\n\t\t\tlistenerSet = new Set();\n\t\t\tthis.listeners.set(key, listenerSet);\n\t\t}\n\n\t\tlistenerSet.add(ee);\n\t}\n\n\tunbind(entity: EntitySubscription, eventKey: EventKey, ee: LocalEventEmitter): void {\n\t\tconst key = `${entityKey(entity)}:${eventKey}`;\n\t\tconst listenerSet = this.listeners.get(key);\n\n\t\tif (listenerSet) {\n\t\t\tlistenerSet.delete(ee);\n\t\t\tif (listenerSet.size === 0) {\n\t\t\t\tthis.listeners.delete(key);\n\t\t\t}\n\t\t}\n\t}\n\n\t// Zero-overhead emit - inline fast path\n\temit(entity: EntitySubscription, eventKey: EventKey, payload: unknown): void {\n\t\tconst key = `${entityKey(entity)}:${eventKey}`;\n\t\tconst listeners = this.listeners.get(key);\n\n\t\tif (!listeners) return;\n\n\t\t// Direct iteration - fastest possible\n\t\tfor (const listener of listeners) {\n\t\t\tlistener.ee.emit(eventKey, payload);\n\t\t}\n\t}\n}\n\nexport const LocalSubs = new LocalSubscriptionRegistry();\n"]}

package/dist/types/libraries/socket/core/socket-event-consumer.d.ts

@@ -0,0 +1 @@
+export declare function subscribeToSocketEvent(): Promise<void>;

package/dist/types/libraries/socket/core/socket-event-consumer.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.subscribeToSocketEvent = subscribeToSocketEvent;
+const instance_utils_1 = require("../../../utilities/instance.utils");
+const event_1 = require("../../event");
+const local_subscription_registry_1 = require("./local-subscription-registry");
+async function subscribeToSocketEvent() {
+    const instanceId = (0, instance_utils_1.getInstanceId)();
+    await (0, event_1.subscribeToQueue)(`socket-events-${instanceId}`, `instance.${instanceId}`, (msg) => {
+        const { localKey, payload, recipient } = msg;
+        local_subscription_registry_1.LocalSubs.emit(recipient, localKey, payload);
+    }, { requeue: false });
+}
+//# sourceMappingURL=socket-event-consumer.js.map

package/dist/types/libraries/socket/core/socket-event-consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-event-consumer.js","sourceRoot":"/","sources":["libraries/socket/core/socket-event-consumer.ts"],"names":[],"mappings":";;AAIA,wDAWC;AAfD,sEAAkE;AAClE,uCAA+C;AAC/C,+EAA0D;AAEnD,KAAK,UAAU,sBAAsB;IAC3C,MAAM,UAAU,GAAG,IAAA,8BAAa,GAAE,CAAC;IACnC,MAAM,IAAA,wBAAgB,EACrB,iBAAiB,UAAU,EAAE,EAC7B,YAAY,UAAU,EAAE,EACxB,CAAC,GAAY,EAAE,EAAE;QAChB,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,GAA6D,CAAC;QACvG,uCAAS,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC,EACD,EAAE,OAAO,EAAE,KAAK,EAAE,CAClB,CAAC;AACH,CAAC","sourcesContent":["import { getInstanceId } from '../../../utilities/instance.utils';\nimport { subscribeToQueue } from '../../event';\nimport { LocalSubs } from './local-subscription-registry';\n\nexport async function subscribeToSocketEvent(): Promise<void> {\n\tconst instanceId = getInstanceId();\n\tawait subscribeToQueue(\n\t\t`socket-events-${instanceId}`,\n\t\t`instance.${instanceId}`,\n\t\t(msg: unknown) => {\n\t\t\tconst { localKey, payload, recipient } = msg as { localKey: string; payload: unknown; recipient: any };\n\t\t\tLocalSubs.emit(recipient, localKey, payload);\n\t\t},\n\t\t{ requeue: false }\n\t);\n}\n"]}

package/dist/types/libraries/socket/core/socket-event-publisher.d.ts

@@ -0,0 +1,6 @@
+import { BaseSocketEvent } from '../BaseSocketEvent';
+import { SocketNotificationEvent } from '../events';
+import type { ZodTypeAny } from 'zod';
+import { EntitySubscription } from '../connections';
+export declare function publishSocketEvent(event: BaseSocketEvent<ZodTypeAny, ZodTypeAny, ZodTypeAny | undefined>, recipients: EntitySubscription[]): Promise<void>;
+export declare function publishNotificationSocketEvent(event: SocketNotificationEvent, recipients: EntitySubscription[]): Promise<void>;

package/dist/types/libraries/socket/core/socket-event-publisher.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.publishSocketEvent = publishSocketEvent;
+exports.publishNotificationSocketEvent = publishNotificationSocketEvent;
+const __1 = require("../../..");
+const event_1 = require("../../event");
+const PushNotificationEvent_1 = require("../PushNotificationEvent");
+const connections_1 = require("../connections");
+function fanOutToInstances(recipientsWithInstances, localKey, payload) {
+    if (recipientsWithInstances.length === 0)
+        return;
+    for (const { recipient, instances } of recipientsWithInstances) {
+        const message = { localKey, payload, recipient };
+        for (const instanceId of instances) {
+            (0, event_1.publish)(`instance.${instanceId}`, message).catch((error) => {
+                console.error(`[Socket] Publish failed for instance ${instanceId}`, error);
+            });
+        }
+    }
+}
+async function getActiveSubscribedRecipients(recipients, localKey) {
+    if (recipients.length === 0)
+        return { subscribed: [], unsubscribed: [] };
+    const redis = (0, __1.getLibraries)().getRedisService();
+    const subscribed = [];
+    const unsubscribed = [];
+    await Promise.all(recipients.map(async (recipient) => {
+        const sockets = await redis.getSetMembers((0, connections_1.kEntityEventSockets)(recipient, localKey));
+        if (sockets.length === 0) {
+            unsubscribed.push(recipient);
+            return;
+        }
+        const instances = [...new Set(sockets.map(s => s.split('|')[0]).filter(Boolean))];
+        if (instances.length > 0)
+            subscribed.push({ recipient, instances });
+        else
+            unsubscribed.push(recipient);
+    }));
+    return { subscribed, unsubscribed };
+}
+async function publishSocketEvent(event, recipients) {
+    const logger = (0, __1.getLibraries)().getLogger().logger;
+    if (recipients.length === 0)
+        return;
+    const localKey = event.getSubscriptionKey();
+    const payload = event.payload();
+    const { subscribed, unsubscribed } = await getActiveSubscribedRecipients(recipients, localKey);
+    logger.debug({ subscribed }, '[Socket] Subscribed recipients:');
+    logger.debug({ unsubscribed }, '[Socket] Unsubscribed recipients:');
+    if (subscribed.length > 0)
+        fanOutToInstances(subscribed, localKey, payload);
+    if (unsubscribed.length > 0) {
+        logger.debug({ unsubscribed }, '[Socket] Processing unsubscribed recipients');
+        if (event.notificationSettings?.isPushNotification) {
+            const pushNotificationPayload = event.getPushNotificationPayload();
+            await (0, event_1.publishEvent)(new PushNotificationEvent_1.PushNotificationEvent(event.eventType(), pushNotificationPayload, unsubscribed, event.notificationSettings)).catch(err => console.error('[Socket] Push notification failed:', err));
+        }
+        const socketNotificationPayload = event.getSocketNotificationEvent();
+        logger.debug({ socketNotificationPayload }, '[Socket] Socket notification payload');
+        if (socketNotificationPayload) {
+            await publishNotificationSocketEvent(socketNotificationPayload, unsubscribed);
+        }
+    }
+}
+async function publishNotificationSocketEvent(event, recipients) {
+    if (recipients.length === 0)
+        return;
+    const eventKey = event.getSubscriptionKey();
+    const redis = (0, __1.getLibraries)().getRedisService();
+    const validInstances = [];
+    await Promise.all(recipients.map(async (recipient) => {
+        const sockets = await redis.getSetMembers((0, connections_1.kEntityEventSockets)(recipient, eventKey));
+        if (sockets.length === 0)
+            return;
+        const instances = [...new Set(sockets.map(s => s.split('|')[0]).filter(Boolean))];
+        if (instances.length > 0)
+            validInstances.push({ recipient, instances });
+    }));
+    if (validInstances.length > 0)
+        fanOutToInstances(validInstances, eventKey, event.payload());
+}
+//# sourceMappingURL=socket-event-publisher.js.map

package/dist/types/libraries/socket/core/socket-event-publisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-event-publisher.js","sourceRoot":"/","sources":["libraries/socket/core/socket-event-publisher.ts"],"names":[],"mappings":"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","sourcesContent":["import { getLibraries } from '../../..';\nimport { BaseSocketEvent } from '../BaseSocketEvent';\nimport { SocketNotificationEvent } from '../events';\nimport { publish, publishEvent } from '../../event';\nimport { PushNotificationEvent } from '../PushNotificationEvent';\nimport type { ZodTypeAny } from 'zod';\nimport { EntitySubscription, kEntityEventSockets } from '../connections';\n\nfunction fanOutToInstances(\n\trecipientsWithInstances: Array<{ recipient: EntitySubscription; instances: string[] }>,\n\tlocalKey: string,\n\tpayload: unknown\n): void {\n\tif (recipientsWithInstances.length === 0) return;\n\n\tfor (const { recipient, instances } of recipientsWithInstances) {\n\t\tconst message = { localKey, payload, recipient };\n\t\tfor (const instanceId of instances) {\n\t\t\tpublish(`instance.${instanceId}`, message).catch((error: unknown) => {\n\t\t\t\tconsole.error(`[Socket] Publish failed for instance ${instanceId}`, error);\n\t\t\t});\n\t\t}\n\t}\n}\n\nasync function getActiveSubscribedRecipients(\n\trecipients: EntitySubscription[],\n\tlocalKey: string\n): Promise<{\n\tsubscribed: Array<{ recipient: EntitySubscription; instances: string[] }>;\n\tunsubscribed: EntitySubscription[];\n}> {\n\tif (recipients.length === 0) return { subscribed: [], unsubscribed: [] };\n\n\tconst redis = getLibraries().getRedisService();\n\tconst subscribed: Array<{ recipient: EntitySubscription; instances: string[] }> = [];\n\tconst unsubscribed: EntitySubscription[] = [];\n\n\tawait Promise.all(\n\t\trecipients.map(async recipient => {\n\t\t\tconst sockets = await redis.getSetMembers(kEntityEventSockets(recipient, localKey));\n\t\t\tif (sockets.length === 0) {\n\t\t\t\tunsubscribed.push(recipient);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst instances = [...new Set(sockets.map(s => s.split('|')[0]).filter(Boolean))];\n\t\t\tif (instances.length > 0) subscribed.push({ recipient, instances });\n\t\t\telse unsubscribed.push(recipient);\n\t\t})\n\t);\n\n\treturn { subscribed, unsubscribed };\n}\n\nexport async function publishSocketEvent(\n\tevent: BaseSocketEvent<ZodTypeAny, ZodTypeAny, ZodTypeAny | undefined>,\n\trecipients: EntitySubscription[]\n): Promise<void> {\n\tconst logger = getLibraries().getLogger().logger;\n\tif (recipients.length === 0) return;\n\n\tconst localKey = event.getSubscriptionKey();\n\tconst payload = event.payload();\n\n\tconst { subscribed, unsubscribed } = await getActiveSubscribedRecipients(recipients, localKey);\n\n\tlogger.debug({ subscribed }, '[Socket] Subscribed recipients:');\n\tlogger.debug({ unsubscribed }, '[Socket] Unsubscribed recipients:');\n\n\tif (subscribed.length > 0) fanOutToInstances(subscribed, localKey, payload);\n\n\tif (unsubscribed.length > 0) {\n\t\tlogger.debug({ unsubscribed }, '[Socket] Processing unsubscribed recipients');\n\n\t\tif (event.notificationSettings?.isPushNotification) {\n\t\t\tconst pushNotificationPayload = event.getPushNotificationPayload();\n\t\t\tawait publishEvent(\n\t\t\t\tnew PushNotificationEvent(event.eventType(), pushNotificationPayload, unsubscribed, event.notificationSettings)\n\t\t\t).catch(err => console.error('[Socket] Push notification failed:', err));\n\t\t}\n\n\t\tconst socketNotificationPayload = event.getSocketNotificationEvent();\n\t\tlogger.debug({ socketNotificationPayload }, '[Socket] Socket notification payload');\n\n\t\tif (socketNotificationPayload) {\n\t\t\tawait publishNotificationSocketEvent(socketNotificationPayload, unsubscribed);\n\t\t}\n\t}\n}\n\nexport async function publishNotificationSocketEvent(\n\tevent: SocketNotificationEvent,\n\trecipients: EntitySubscription[]\n): Promise<void> {\n\tif (recipients.length === 0) return;\n\n\tconst eventKey = event.getSubscriptionKey();\n\tconst redis = getLibraries().getRedisService();\n\tconst validInstances: Array<{ recipient: EntitySubscription; instances: string[] }> = [];\n\n\tawait Promise.all(\n\t\trecipients.map(async recipient => {\n\t\t\tconst sockets = await redis.getSetMembers(kEntityEventSockets(recipient, eventKey));\n\t\t\tif (sockets.length === 0) return;\n\t\t\tconst instances = [...new Set(sockets.map(s => s.split('|')[0]).filter(Boolean))];\n\t\t\tif (instances.length > 0) validInstances.push({ recipient, instances });\n\t\t})\n\t);\n\n\tif (validInstances.length > 0) fanOutToInstances(validInstances, eventKey, event.payload());\n}\n"]}

package/dist/types/libraries/socket/core/socket-event-registry.d.ts

@@ -0,0 +1,12 @@
+import type { z } from 'zod';
+import type { SocketEventType } from '../../../utilities/enum';
+import { REGISTRY } from './socket-event-registry.map';
+type InputFor<T extends SocketEventType> = z.infer<(typeof REGISTRY)[T]['schemas']['input']>;
+type OutputFor<T extends SocketEventType> = z.infer<(typeof REGISTRY)[T]['schemas']['output']>;
+type EventFor<T extends SocketEventType> = InstanceType<(typeof REGISTRY)[T]>;
+export declare class EventFactory {
+    static getEventClass<T extends SocketEventType>(eventType: T): (typeof REGISTRY)[T];
+    static getSubscriptionKey<T extends SocketEventType>(eventType: T, input: InputFor<T>): string;
+    static createEvent<T extends SocketEventType>(eventType: T, data: OutputFor<T>): EventFor<T>;
+}
+export type { EventFor, InputFor, OutputFor };

package/dist/types/libraries/socket/core/socket-event-registry.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventFactory = void 0;
+const socket_event_registry_map_1 = require("./socket-event-registry.map");
+class EventFactory {
+    static getEventClass(eventType) {
+        return socket_event_registry_map_1.REGISTRY[eventType];
+    }
+    static getSubscriptionKey(eventType, input) {
+        const eventClass = this.getEventClass(eventType);
+        const schemas = (0, socket_event_registry_map_1.getSchemas)(eventClass);
+        const identifier = (0, socket_event_registry_map_1.getIdentifier)(eventClass);
+        const validatedInput = schemas.input.parse(input);
+        const key = typeof identifier === 'function' ? identifier(validatedInput) : 'default';
+        return `${eventType}:${key}`;
+    }
+    static createEvent(eventType, data) {
+        const EventClass = this.getEventClass(eventType);
+        return new EventClass(data);
+    }
+}
+exports.EventFactory = EventFactory;
+//# sourceMappingURL=socket-event-registry.js.map

package/dist/types/libraries/socket/core/socket-event-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-event-registry.js","sourceRoot":"/","sources":["libraries/socket/core/socket-event-registry.ts"],"names":[],"mappings":";;;AAEA,2EAAkF;AAOlF,MAAa,YAAY;IAExB,MAAM,CAAC,aAAa,CAA4B,SAAY;QAC3D,OAAO,oCAAQ,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC;IAGD,MAAM,CAAC,kBAAkB,CAA4B,SAAY,EAAE,KAAkB;QACpF,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,IAAA,sCAAU,EAAC,UAAU,CAAC,CAAC;QACvC,MAAM,UAAU,GAAG,IAAA,yCAAa,EAAC,UAAU,CAAC,CAAC;QAE7C,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,OAAO,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAEtF,OAAO,GAAG,SAAS,IAAI,GAAG,EAAE,CAAC;IAC9B,CAAC;IAGD,MAAM,CAAC,WAAW,CAA4B,SAAY,EAAE,IAAkB;QAC7E,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACjD,OAAO,IAAI,UAAU,CAAC,IAAI,CAAgB,CAAC;IAC5C,CAAC;CACD;AAvBD,oCAuBC","sourcesContent":["import type { z } from 'zod';\nimport type { SocketEventType } from '../../../utilities/enum';\nimport { getIdentifier, getSchemas, REGISTRY } from './socket-event-registry.map';\n\n// Infer types directly from the registry\ntype InputFor<T extends SocketEventType> = z.infer<(typeof REGISTRY)[T]['schemas']['input']>;\ntype OutputFor<T extends SocketEventType> = z.infer<(typeof REGISTRY)[T]['schemas']['output']>;\ntype EventFor<T extends SocketEventType> = InstanceType<(typeof REGISTRY)[T]>;\n\nexport class EventFactory {\n\t// Get the event class constructor\n\tstatic getEventClass<T extends SocketEventType>(eventType: T): (typeof REGISTRY)[T] {\n\t\treturn REGISTRY[eventType];\n\t}\n\n\t// Create a subscription key for an event with validated input\n\tstatic getSubscriptionKey<T extends SocketEventType>(eventType: T, input: InputFor<T>): string {\n\t\tconst eventClass = this.getEventClass(eventType);\n\t\tconst schemas = getSchemas(eventClass);\n\t\tconst identifier = getIdentifier(eventClass);\n\n\t\tconst validatedInput = schemas.input.parse(input);\n\t\tconst key = typeof identifier === 'function' ? identifier(validatedInput) : 'default';\n\n\t\treturn `${eventType}:${key}`;\n\t}\n\n\t// Create an event instance from validated output data\n\tstatic createEvent<T extends SocketEventType>(eventType: T, data: OutputFor<T>): EventFor<T> {\n\t\tconst EventClass = this.getEventClass(eventType);\n\t\treturn new EventClass(data) as EventFor<T>;\n\t}\n}\n\nexport type { EventFor, InputFor, OutputFor };\n"]}