@acorex-platform/framework-server 0.0.15 → 0.0.20

package/realtime/src/lib/presence/in-process-user-presence.store.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InProcessUserPresenceStore = void 0;
+const user_presence_constants_1 = require("./user-presence.constants");
+//#region ----- In-process presence store -----
+function scopedKey(tenantId, userId) {
+    return `${tenantId}:${userId}`;
+}
+class InProcessUserPresenceStore {
+    constructor() {
+        this.sockets = new Map();
+        this.lastSeen = new Map();
+        this.overlays = new Map();
+        this.statusSince = new Map();
+        this.watchCounts = new Map();
+        this.graceUntil = new Map();
+    }
+    async addSocket(tenantId, userId, socketId) {
+        const key = scopedKey(tenantId, userId);
+        let members = this.sockets.get(key);
+        if (!members) {
+            members = new Map();
+            this.sockets.set(key, members);
+        }
+        members.set(socketId, Date.now());
+        return this.pruneAndCount(key, members);
+    }
+    async removeSocket(tenantId, userId, socketId) {
+        const key = scopedKey(tenantId, userId);
+        const members = this.sockets.get(key);
+        if (!members) {
+            return 0;
+        }
+        members.delete(socketId);
+        return this.pruneAndCount(key, members);
+    }
+    async touchSocket(tenantId, userId, socketId) {
+        const key = scopedKey(tenantId, userId);
+        const members = this.sockets.get(key);
+        if (!members?.has(socketId)) {
+            return;
+        }
+        members.set(socketId, Date.now());
+    }
+    async getSocketCount(tenantId, userId) {
+        const key = scopedKey(tenantId, userId);
+        const members = this.sockets.get(key);
+        if (!members) {
+            return 0;
+        }
+        return this.pruneAndCount(key, members);
+    }
+    async setLastSeen(tenantId, userId, iso) {
+        this.lastSeen.set(scopedKey(tenantId, userId), iso);
+    }
+    async getLastSeen(tenantId, userId) {
+        return this.lastSeen.get(scopedKey(tenantId, userId));
+    }
+    async getOverlay(tenantId, userId) {
+        return this.overlays.get(scopedKey(tenantId, userId));
+    }
+    async setOverlay(tenantId, userId, overlay) {
+        this.overlays.set(scopedKey(tenantId, userId), overlay);
+    }
+    async setStatusSince(tenantId, userId, iso) {
+        this.statusSince.set(scopedKey(tenantId, userId), iso);
+    }
+    async getStatusSince(tenantId, userId) {
+        return this.statusSince.get(scopedKey(tenantId, userId));
+    }
+    async addWatcher(tenantId, watchedUserId, watcherUserId) {
+        const key = scopedKey(tenantId, watchedUserId);
+        let counts = this.watchCounts.get(key);
+        if (!counts) {
+            counts = new Map();
+            this.watchCounts.set(key, counts);
+        }
+        counts.set(watcherUserId, (counts.get(watcherUserId) ?? 0) + 1);
+    }
+    async removeWatcher(tenantId, watchedUserId, watcherUserId) {
+        const key = scopedKey(tenantId, watchedUserId);
+        const counts = this.watchCounts.get(key);
+        if (!counts) {
+            return;
+        }
+        const next = (counts.get(watcherUserId) ?? 0) - 1;
+        if (next <= 0) {
+            counts.delete(watcherUserId);
+        }
+        else {
+            counts.set(watcherUserId, next);
+        }
+        if (counts.size === 0) {
+            this.watchCounts.delete(key);
+        }
+    }
+    async getWatchers(tenantId, watchedUserId) {
+        const counts = this.watchCounts.get(scopedKey(tenantId, watchedUserId));
+        return counts ? Array.from(counts.keys()) : [];
+    }
+    async markGrace(tenantId, userId, ttlSeconds) {
+        this.graceUntil.set(scopedKey(tenantId, userId), Date.now() + ttlSeconds * 1000);
+    }
+    async clearGrace(tenantId, userId) {
+        this.graceUntil.delete(scopedKey(tenantId, userId));
+    }
+    async isInGrace(tenantId, userId) {
+        const key = scopedKey(tenantId, userId);
+        const until = this.graceUntil.get(key);
+        if (until === undefined) {
+            return false;
+        }
+        if (until <= Date.now()) {
+            this.graceUntil.delete(key);
+            return false;
+        }
+        return true;
+    }
+    pruneAndCount(key, members) {
+        const cutoff = Date.now() - user_presence_constants_1.AXP_USER_PRESENCE_SOCKET_STALE_MS;
+        for (const [socketId, touchedAt] of members) {
+            if (touchedAt < cutoff) {
+                members.delete(socketId);
+            }
+        }
+        if (members.size === 0) {
+            this.sockets.delete(key);
+            return 0;
+        }
+        return members.size;
+    }
+}
+exports.InProcessUserPresenceStore = InProcessUserPresenceStore;
+//#endregion
+//# sourceMappingURL=in-process-user-presence.store.js.map

package/realtime/src/lib/presence/in-process-user-presence.store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-process-user-presence.store.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/presence/in-process-user-presence.store.ts"],"names":[],"mappings":"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"}

package/realtime/src/lib/presence/redis-user-presence.store.d.ts

@@ -0,0 +1,32 @@
+import type Redis from 'ioredis';
+import type { AXPUserPresenceOverlay } from './user-presence.types';
+import type { UserPresenceStateStore } from './user-presence-store.port';
+export declare class RedisUserPresenceStore implements UserPresenceStateStore {
+    private readonly redis;
+    constructor(redis: Redis);
+    addSocket(tenantId: string, userId: string, socketId: string): Promise<number>;
+    removeSocket(tenantId: string, userId: string, socketId: string): Promise<number>;
+    touchSocket(tenantId: string, userId: string, socketId: string): Promise<void>;
+    getSocketCount(tenantId: string, userId: string): Promise<number>;
+    setLastSeen(tenantId: string, userId: string, iso: string): Promise<void>;
+    getLastSeen(tenantId: string, userId: string): Promise<string | undefined>;
+    getOverlay(tenantId: string, userId: string): Promise<AXPUserPresenceOverlay | undefined>;
+    setOverlay(tenantId: string, userId: string, overlay: AXPUserPresenceOverlay): Promise<void>;
+    setStatusSince(tenantId: string, userId: string, iso: string): Promise<void>;
+    getStatusSince(tenantId: string, userId: string): Promise<string | undefined>;
+    addWatcher(tenantId: string, watchedUserId: string, watcherUserId: string): Promise<void>;
+    removeWatcher(tenantId: string, watchedUserId: string, watcherUserId: string): Promise<void>;
+    getWatchers(tenantId: string, watchedUserId: string): Promise<string[]>;
+    markGrace(tenantId: string, userId: string, ttlSeconds: number): Promise<void>;
+    clearGrace(tenantId: string, userId: string): Promise<void>;
+    isInGrace(tenantId: string, userId: string): Promise<boolean>;
+    private pruneAndCount;
+    private socketKey;
+    private lastSeenKey;
+    private overlayKey;
+    private sinceKey;
+    private watchersKey;
+    private watchCountKey;
+    private graceKey;
+}
+//# sourceMappingURL=redis-user-presence.store.d.ts.map

package/realtime/src/lib/presence/redis-user-presence.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-user-presence.store.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/presence/redis-user-presence.store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AAEjC,OAAO,KAAK,EAA+B,sBAAsB,EAAyB,MAAM,uBAAuB,CAAC;AACxH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAIzE,qBAAa,sBAAuB,YAAW,sBAAsB;IACvD,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,KAAK;IAEnC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO9E,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMjF,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9E,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIjE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAK1E,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;IAKzF,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5F,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5E,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAK7E,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzF,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5F,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIvE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9E,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAKrD,aAAa;IAW3B,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,QAAQ;CAGjB"}

package/realtime/src/lib/presence/redis-user-presence.store.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisUserPresenceStore = void 0;
+const user_presence_constants_1 = require("./user-presence.constants");
+//#region ----- Redis presence store -----
+class RedisUserPresenceStore {
+    constructor(redis) {
+        this.redis = redis;
+    }
+    async addSocket(tenantId, userId, socketId) {
+        const key = this.socketKey(tenantId, userId);
+        const now = Date.now();
+        await this.redis.zadd(key, now, socketId);
+        return this.pruneAndCount(key, now);
+    }
+    async removeSocket(tenantId, userId, socketId) {
+        const key = this.socketKey(tenantId, userId);
+        await this.redis.zrem(key, socketId);
+        return this.pruneAndCount(key, Date.now());
+    }
+    async touchSocket(tenantId, userId, socketId) {
+        const key = this.socketKey(tenantId, userId);
+        const score = await this.redis.zscore(key, socketId);
+        if (score == null) {
+            return;
+        }
+        await this.redis.zadd(key, Date.now(), socketId);
+    }
+    async getSocketCount(tenantId, userId) {
+        return this.pruneAndCount(this.socketKey(tenantId, userId), Date.now());
+    }
+    async setLastSeen(tenantId, userId, iso) {
+        await this.redis.set(this.lastSeenKey(tenantId, userId), iso);
+    }
+    async getLastSeen(tenantId, userId) {
+        const value = await this.redis.get(this.lastSeenKey(tenantId, userId));
+        return value?.trim() || undefined;
+    }
+    async getOverlay(tenantId, userId) {
+        const raw = await this.redis.get(this.overlayKey(tenantId, userId));
+        return parseOverlay(raw);
+    }
+    async setOverlay(tenantId, userId, overlay) {
+        await this.redis.set(this.overlayKey(tenantId, userId), JSON.stringify(overlay));
+    }
+    async setStatusSince(tenantId, userId, iso) {
+        await this.redis.set(this.sinceKey(tenantId, userId), iso);
+    }
+    async getStatusSince(tenantId, userId) {
+        const value = await this.redis.get(this.sinceKey(tenantId, userId));
+        return value?.trim() || undefined;
+    }
+    async addWatcher(tenantId, watchedUserId, watcherUserId) {
+        const count = await this.redis.hincrby(this.watchCountKey(tenantId, watchedUserId), watcherUserId, 1);
+        if (count === 1) {
+            await this.redis.sadd(this.watchersKey(tenantId, watchedUserId), watcherUserId);
+        }
+    }
+    async removeWatcher(tenantId, watchedUserId, watcherUserId) {
+        const count = await this.redis.hincrby(this.watchCountKey(tenantId, watchedUserId), watcherUserId, -1);
+        if (count <= 0) {
+            await this.redis.hdel(this.watchCountKey(tenantId, watchedUserId), watcherUserId);
+            await this.redis.srem(this.watchersKey(tenantId, watchedUserId), watcherUserId);
+        }
+    }
+    async getWatchers(tenantId, watchedUserId) {
+        return this.redis.smembers(this.watchersKey(tenantId, watchedUserId));
+    }
+    async markGrace(tenantId, userId, ttlSeconds) {
+        const ttl = Math.max(1, Math.ceil(ttlSeconds));
+        await this.redis.set(this.graceKey(tenantId, userId), '1', 'EX', ttl);
+    }
+    async clearGrace(tenantId, userId) {
+        await this.redis.del(this.graceKey(tenantId, userId));
+    }
+    async isInGrace(tenantId, userId) {
+        const exists = await this.redis.exists(this.graceKey(tenantId, userId));
+        return exists === 1;
+    }
+    async pruneAndCount(key, now) {
+        const cutoff = now - user_presence_constants_1.AXP_USER_PRESENCE_SOCKET_STALE_MS;
+        await this.redis.zremrangebyscore(key, 0, cutoff);
+        const count = await this.redis.zcard(key);
+        if (count <= 0) {
+            await this.redis.del(key);
+            return 0;
+        }
+        return count;
+    }
+    socketKey(tenantId, userId) {
+        // Sorted set of socketId → last touch (ms). Legacy counter keys are ignored.
+        return `${user_presence_constants_1.AXP_USER_PRESENCE_REDIS_PREFIX}:sockset:${tenantId}:${userId}`;
+    }
+    lastSeenKey(tenantId, userId) {
+        return `${user_presence_constants_1.AXP_USER_PRESENCE_REDIS_PREFIX}:lastSeen:${tenantId}:${userId}`;
+    }
+    overlayKey(tenantId, userId) {
+        return `${user_presence_constants_1.AXP_USER_PRESENCE_REDIS_PREFIX}:overlay:${tenantId}:${userId}`;
+    }
+    sinceKey(tenantId, userId) {
+        return `${user_presence_constants_1.AXP_USER_PRESENCE_REDIS_PREFIX}:since:${tenantId}:${userId}`;
+    }
+    watchersKey(tenantId, watchedUserId) {
+        return `${user_presence_constants_1.AXP_USER_PRESENCE_REDIS_PREFIX}:watchers:${tenantId}:${watchedUserId}`;
+    }
+    watchCountKey(tenantId, watchedUserId) {
+        return `${user_presence_constants_1.AXP_USER_PRESENCE_REDIS_PREFIX}:watchcount:${tenantId}:${watchedUserId}`;
+    }
+    graceKey(tenantId, userId) {
+        return `${user_presence_constants_1.AXP_USER_PRESENCE_REDIS_PREFIX}:grace:${tenantId}:${userId}`;
+    }
+}
+exports.RedisUserPresenceStore = RedisUserPresenceStore;
+function parseOverlay(raw) {
+    if (!raw?.trim()) {
+        return undefined;
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        const availability = parsed.availability === 'away' || parsed.availability === 'busy' || parsed.availability === 'available'
+            ? parsed.availability
+            : undefined;
+        const source = parsed.source === 'manual' || parsed.source === 'auto' ? parsed.source : undefined;
+        if (!availability || !source) {
+            return undefined;
+        }
+        return { availability, source };
+    }
+    catch {
+        return undefined;
+    }
+}
+//#endregion
+//# sourceMappingURL=redis-user-presence.store.js.map

package/realtime/src/lib/presence/redis-user-presence.store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-user-presence.store.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/presence/redis-user-presence.store.ts"],"names":[],"mappings":"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"}

package/realtime/src/lib/presence/user-presence-history.port.d.ts

@@ -0,0 +1,21 @@
+import type { AXPUserPresenceSource, AXPUserPresenceStatus } from './user-presence.types';
+export interface AXPUserPresenceHistoryTransition {
+    tenantId: string;
+    userId: string;
+    status: AXPUserPresenceStatus;
+    source: AXPUserPresenceSource;
+    at: string;
+}
+/**
+ * Durable ledger for presence status changes (Mongo segments).
+ * Required for activity reports; live badge state alone is not enough.
+ */
+export declare abstract class UserPresenceHistoryPort {
+    abstract recordTransition(input: AXPUserPresenceHistoryTransition): Promise<void>;
+    /**
+     * Ensures an open segment matches `status` (no-op when already correct).
+     * Use on connect so reports stay durable even after Redis restarts / missed transitions.
+     */
+    abstract ensureStatus(input: AXPUserPresenceHistoryTransition): Promise<void>;
+}
+//# sourceMappingURL=user-presence-history.port.d.ts.map

package/realtime/src/lib/presence/user-presence-history.port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-presence-history.port.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/presence/user-presence-history.port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAI1F,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,qBAAqB,CAAC;IAC9B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;GAGG;AACH,8BAAsB,uBAAuB;IAC3C,QAAQ,CAAC,gBAAgB,CAAC,KAAK,EAAE,gCAAgC,GAAG,OAAO,CAAC,IAAI,CAAC;IAEjF;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,KAAK,EAAE,gCAAgC,GAAG,OAAO,CAAC,IAAI,CAAC;CAC9E"}

package/realtime/src/lib/presence/user-presence-history.port.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserPresenceHistoryPort = void 0;
+/**
+ * Durable ledger for presence status changes (Mongo segments).
+ * Required for activity reports; live badge state alone is not enough.
+ */
+class UserPresenceHistoryPort {
+}
+exports.UserPresenceHistoryPort = UserPresenceHistoryPort;
+//#endregion
+//# sourceMappingURL=user-presence-history.port.js.map

package/realtime/src/lib/presence/user-presence-history.port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-presence-history.port.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/presence/user-presence-history.port.ts"],"names":[],"mappings":";;;AAYA;;;GAGG;AACH,MAAsB,uBAAuB;CAQ5C;AARD,0DAQC;AAED,YAAY"}

package/realtime/src/lib/presence/user-presence-history.registry.d.ts

@@ -0,0 +1,15 @@
+import { UserPresenceHistoryPort, type AXPUserPresenceHistoryTransition } from './user-presence-history.port';
+/**
+ * Global registry so platform-management can persist presence segments
+ * without creating a Nest import cycle with {@link RealtimeModule}.
+ */
+export declare class UserPresenceHistoryRegistry extends UserPresenceHistoryPort {
+    private readonly logger;
+    private delegate;
+    private missingDelegateWarned;
+    register(delegate: UserPresenceHistoryPort): void;
+    recordTransition(input: AXPUserPresenceHistoryTransition): Promise<void>;
+    ensureStatus(input: AXPUserPresenceHistoryTransition): Promise<void>;
+    private warnMissingDelegate;
+}
+//# sourceMappingURL=user-presence-history.registry.d.ts.map

package/realtime/src/lib/presence/user-presence-history.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-presence-history.registry.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/presence/user-presence-history.registry.ts"],"names":[],"mappings":"AACA,OAAO,EACL,uBAAuB,EACvB,KAAK,gCAAgC,EACtC,MAAM,8BAA8B,CAAC;AAItC;;;GAGG;AACH,qBACa,2BAA4B,SAAQ,uBAAuB;IACtE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgD;IACvE,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,qBAAqB,CAAS;IAEtC,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI;IAK3C,gBAAgB,CAAC,KAAK,EAAE,gCAAgC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxE,YAAY,CAAC,KAAK,EAAE,gCAAgC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1E,OAAO,CAAC,mBAAmB;CAS5B"}

package/realtime/src/lib/presence/user-presence-history.registry.js

@@ -0,0 +1,51 @@
+"use strict";
+var UserPresenceHistoryRegistry_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserPresenceHistoryRegistry = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const user_presence_history_port_1 = require("./user-presence-history.port");
+//#region ----- Presence history registry -----
+/**
+ * Global registry so platform-management can persist presence segments
+ * without creating a Nest import cycle with {@link RealtimeModule}.
+ */
+let UserPresenceHistoryRegistry = UserPresenceHistoryRegistry_1 = class UserPresenceHistoryRegistry extends user_presence_history_port_1.UserPresenceHistoryPort {
+    constructor() {
+        super(...arguments);
+        this.logger = new common_1.Logger(UserPresenceHistoryRegistry_1.name);
+        this.delegate = null;
+        this.missingDelegateWarned = false;
+    }
+    register(delegate) {
+        this.delegate = delegate;
+        this.logger.log('Presence history writer registered (activity segments will persist for reports)');
+    }
+    async recordTransition(input) {
+        if (!this.delegate) {
+            this.warnMissingDelegate();
+            return;
+        }
+        await this.delegate.recordTransition(input);
+    }
+    async ensureStatus(input) {
+        if (!this.delegate) {
+            this.warnMissingDelegate();
+            return;
+        }
+        await this.delegate.ensureStatus(input);
+    }
+    warnMissingDelegate() {
+        if (this.missingDelegateWarned) {
+            return;
+        }
+        this.missingDelegateWarned = true;
+        this.logger.warn('Presence history writer is not registered — online/offline badges still work, but activity reports will stay empty until platform-management registers UserPresenceHistoryService');
+    }
+};
+exports.UserPresenceHistoryRegistry = UserPresenceHistoryRegistry;
+exports.UserPresenceHistoryRegistry = UserPresenceHistoryRegistry = UserPresenceHistoryRegistry_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)()
+], UserPresenceHistoryRegistry);
+//#endregion
+//# sourceMappingURL=user-presence-history.registry.js.map

package/realtime/src/lib/presence/user-presence-history.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-presence-history.registry.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/presence/user-presence-history.registry.ts"],"names":[],"mappings":";;;;;AAAA,2CAAoD;AACpD,6EAGsC;AAEtC,+CAA+C;AAE/C;;;GAGG;AAEI,IAAM,2BAA2B,mCAAjC,MAAM,2BAA4B,SAAQ,oDAAuB;IAAjE;;QACY,WAAM,GAAG,IAAI,eAAM,CAAC,6BAA2B,CAAC,IAAI,CAAC,CAAC;QAC/D,aAAQ,GAAmC,IAAI,CAAC;QAChD,0BAAqB,GAAG,KAAK,CAAC;IAgCxC,CAAC;IA9BC,QAAQ,CAAC,QAAiC;QACxC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,iFAAiF,CAAC,CAAC;IACrG,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,KAAuC;QAC5D,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC3B,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAuC;QACxD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC3B,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAEO,mBAAmB;QACzB,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC/B,OAAO;QACT,CAAC;QACD,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,mLAAmL,CACpL,CAAC;IACJ,CAAC;CACF,CAAA;AAnCY,kEAA2B;sCAA3B,2BAA2B;IADvC,IAAA,mBAAU,GAAE;GACA,2BAA2B,CAmCvC;AAED,YAAY"}

package/realtime/src/lib/presence/user-presence-store.port.d.ts

@@ -0,0 +1,23 @@
+import type { AXPUserPresenceOverlay } from './user-presence.types';
+export interface UserPresenceStateStore {
+    /** Registers a live socket id; returns occupancy count after prune. */
+    addSocket(tenantId: string, userId: string, socketId: string): Promise<number>;
+    /** Removes a socket id; returns occupancy count after prune. */
+    removeSocket(tenantId: string, userId: string, socketId: string): Promise<number>;
+    /** Refreshes last-seen for a live socket (prevents stale prune). */
+    touchSocket(tenantId: string, userId: string, socketId: string): Promise<void>;
+    getSocketCount(tenantId: string, userId: string): Promise<number>;
+    setLastSeen(tenantId: string, userId: string, iso: string): Promise<void>;
+    getLastSeen(tenantId: string, userId: string): Promise<string | undefined>;
+    getOverlay(tenantId: string, userId: string): Promise<AXPUserPresenceOverlay | undefined>;
+    setOverlay(tenantId: string, userId: string, overlay: AXPUserPresenceOverlay): Promise<void>;
+    setStatusSince(tenantId: string, userId: string, iso: string): Promise<void>;
+    getStatusSince(tenantId: string, userId: string): Promise<string | undefined>;
+    addWatcher(tenantId: string, watchedUserId: string, watcherUserId: string): Promise<void>;
+    removeWatcher(tenantId: string, watchedUserId: string, watcherUserId: string): Promise<void>;
+    getWatchers(tenantId: string, watchedUserId: string): Promise<string[]>;
+    markGrace(tenantId: string, userId: string, ttlSeconds: number): Promise<void>;
+    clearGrace(tenantId: string, userId: string): Promise<void>;
+    isInGrace(tenantId: string, userId: string): Promise<boolean>;
+}
+//# sourceMappingURL=user-presence-store.port.d.ts.map

package/realtime/src/lib/presence/user-presence-store.port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-presence-store.port.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/presence/user-presence-store.port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAIpE,MAAM,WAAW,sBAAsB;IACrC,uEAAuE;IACvE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/E,gEAAgE;IAChE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClF,oEAAoE;IACpE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC3E,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAAC;IAC1F,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7F,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC9E,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1F,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7F,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/D"}

package/realtime/src/lib/presence/user-presence-store.port.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//#endregion
+//# sourceMappingURL=user-presence-store.port.js.map

package/realtime/src/lib/presence/user-presence-store.port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-presence-store.port.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/presence/user-presence-store.port.ts"],"names":[],"mappings":";;AA0BA,YAAY"}

package/realtime/src/lib/presence/user-presence-tracker.service.d.ts

@@ -0,0 +1,33 @@
+import { OnModuleDestroy } from '@nestjs/common';
+import { RealtimePublisherPort } from '../ports/realtime-publisher.port';
+import type { AXPRealtimeSocketSession } from '../types/realtime.types';
+import { UserPresenceHistoryRegistry } from './user-presence-history.registry';
+import type { AXPUserPresenceSetResult, AXPUserPresenceSnapshotItem, AXPUserPresenceSource, AXPUserPresenceStatus } from './user-presence.types';
+export declare class UserPresenceTrackerService implements OnModuleDestroy {
+    private readonly publisher;
+    private readonly history;
+    private readonly logger;
+    private readonly redis;
+    private readonly store;
+    private readonly graceTimers;
+    constructor(publisher: RealtimePublisherPort, history: UserPresenceHistoryRegistry);
+    onModuleDestroy(): Promise<void>;
+    handleSocketUp(session: AXPRealtimeSocketSession, socketId: string): Promise<void>;
+    handleSocketDown(session: AXPRealtimeSocketSession, socketId: string, options?: {
+        skipGrace?: boolean;
+    }): Promise<void>;
+    touchSocket(session: AXPRealtimeSocketSession, socketId: string): Promise<void>;
+    setAvailability(session: AXPRealtimeSocketSession, status: AXPUserPresenceStatus, source: AXPUserPresenceSource): Promise<AXPUserPresenceSetResult>;
+    subscribeWatchers(session: AXPRealtimeSocketSession, userIds: readonly string[]): Promise<AXPUserPresenceSnapshotItem[]>;
+    unsubscribeWatchers(session: AXPRealtimeSocketSession, userIds: readonly string[]): Promise<void>;
+    snapshot(tenantId: string, userIds: readonly string[]): Promise<AXPUserPresenceSnapshotItem[]>;
+    private occupancyOf;
+    private readPresence;
+    private scheduleGraceOffline;
+    private clearGraceTimer;
+    private finalizeOffline;
+    private publishStatus;
+    private ensureHistory;
+    private publishPresence;
+}
+//# sourceMappingURL=user-presence-tracker.service.d.ts.map

package/realtime/src/lib/presence/user-presence-tracker.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-presence-tracker.service.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/realtime/src/lib/presence/user-presence-tracker.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAErE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAMzE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAUxE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAE/E,OAAO,KAAK,EAIV,wBAAwB,EACxB,2BAA2B,EAC3B,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,uBAAuB,CAAC;AAiC/B,qBACa,0BAA2B,YAAW,eAAe;IAO9D,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+C;IACtE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoD;gBAG7D,SAAS,EAAE,qBAAqB,EAChC,OAAO,EAAE,2BAA2B;IAYjD,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAUhC,cAAc,CAAC,OAAO,EAAE,wBAAwB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBlF,gBAAgB,CACpB,OAAO,EAAE,wBAAwB,EACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAChC,OAAO,CAAC,IAAI,CAAC;IAyBV,WAAW,CAAC,OAAO,EAAE,wBAAwB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/E,eAAe,CACnB,OAAO,EAAE,wBAAwB,EACjC,MAAM,EAAE,qBAAqB,EAC7B,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,wBAAwB,CAAC;IAgC9B,iBAAiB,CACrB,OAAO,EAAE,wBAAwB,EACjC,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,OAAO,CAAC,2BAA2B,EAAE,CAAC;IAenC,mBAAmB,CACvB,OAAO,EAAE,wBAAwB,EACjC,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,OAAO,CAAC,IAAI,CAAC;IAaV,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,2BAA2B,EAAE,CAAC;YAQtF,WAAW;YAQX,YAAY;IAiB1B,OAAO,CAAC,oBAAoB;IAc5B,OAAO,CAAC,eAAe;YAST,eAAe;YA+Bf,aAAa;IAU3B,OAAO,CAAC,aAAa;YAgBP,eAAe;CAsB9B"}