@acorex-platform/framework-client 0.0.15 → 0.0.20

package/fesm2022/acorex-platform-framework-client-native.mjs

@@ -2,11 +2,11 @@ import * as i0 from '@angular/core';
 import { NgModule, Injectable } from '@angular/core';
 
 class AXPNativeModule {
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPNativeModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
-    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "21.2.9", ngImport: i0, type: AXPNativeModule }); }
-    static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPNativeModule }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPNativeModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
+    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "22.0.8", ngImport: i0, type: AXPNativeModule }); }
+    static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPNativeModule }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPNativeModule, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPNativeModule, decorators: [{
             type: NgModule,
             args: [{
                     imports: [],
@@ -139,10 +139,10 @@ class AXPNativeService {
             console.error('FlutterChannel is not defined');
         }
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPNativeService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPNativeService, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPNativeService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPNativeService, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPNativeService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPNativeService, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }], ctorParameters: () => [] });

package/fesm2022/acorex-platform-framework-client-realtime-set-presence-availability.command-CetlUjnM.mjs

@@ -0,0 +1,29 @@
+import { runtimeCommandFailure, runtimeCommandSuccessObject } from '@acorex-platform/framework-shared/core';
+import * as i0 from '@angular/core';
+import { inject, Injectable } from '@angular/core';
+import { AXPUserPresenceService } from './acorex-platform-framework-client-realtime.mjs';
+
+//#endregion
+//#region ----- Command -----
+class AXPSetPresenceAvailabilityCommand {
+    constructor() {
+        this.presence = inject(AXPUserPresenceService);
+    }
+    async execute(input) {
+        const status = input?.status;
+        if (status !== 'online' && status !== 'away' && status !== 'busy') {
+            return runtimeCommandFailure('Invalid presence status');
+        }
+        await this.presence.setAvailability(status, 'manual');
+        return runtimeCommandSuccessObject(undefined);
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPSetPresenceAvailabilityCommand, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPSetPresenceAvailabilityCommand, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPSetPresenceAvailabilityCommand, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+export { AXPSetPresenceAvailabilityCommand };
+//# sourceMappingURL=acorex-platform-framework-client-realtime-set-presence-availability.command-CetlUjnM.mjs.map

package/fesm2022/acorex-platform-framework-client-realtime-set-presence-availability.command-CetlUjnM.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"acorex-platform-framework-client-realtime-set-presence-availability.command-CetlUjnM.mjs","sources":["../../../../../libs/framework/client/realtime/src/lib/presence/set-presence-availability.command.ts"],"sourcesContent":["import { AXPCommand, type AXPCommandExecuteResultPromise } from '@acorex-platform/framework-shared/runtime';\nimport { runtimeCommandFailure, runtimeCommandSuccessObject } from '@acorex-platform/framework-shared/core';\nimport { inject, Injectable } from '@angular/core';\nimport { AXPUserPresenceService } from './user-presence.service';\n\n//#region ----- Types -----\n\nexport interface AXPSetPresenceAvailabilityInput {\n  status?: 'online' | 'away' | 'busy';\n}\n\n//#endregion\n\n//#region ----- Command -----\n\n@Injectable({ providedIn: 'root' })\nexport class AXPSetPresenceAvailabilityCommand implements AXPCommand<AXPSetPresenceAvailabilityInput, void> {\n  private readonly presence = inject(AXPUserPresenceService);\n\n  async execute(input?: AXPSetPresenceAvailabilityInput): AXPCommandExecuteResultPromise<void> {\n    const status = input?.status;\n    if (status !== 'online' && status !== 'away' && status !== 'busy') {\n      return runtimeCommandFailure('Invalid presence status');\n    }\n    await this.presence.setAvailability(status, 'manual');\n    return runtimeCommandSuccessObject(undefined);\n  }\n}\n\n//#endregion\n"],"names":[],"mappings":";;;;;AAWA;AAEA;MAGa,iCAAiC,CAAA;AAD9C,IAAA,WAAA,GAAA;AAEmB,QAAA,IAAA,CAAA,QAAQ,GAAG,MAAM,CAAC,sBAAsB,CAAC;AAU3D,IAAA;IARC,MAAM,OAAO,CAAC,KAAuC,EAAA;AACnD,QAAA,MAAM,MAAM,GAAG,KAAK,EAAE,MAAM;AAC5B,QAAA,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,MAAM,EAAE;AACjE,YAAA,OAAO,qBAAqB,CAAC,yBAAyB,CAAC;QACzD;QACA,MAAM,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC;AACrD,QAAA,OAAO,2BAA2B,CAAC,SAAS,CAAC;IAC/C;8GAVW,iCAAiC,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA,CAAA;AAAjC,IAAA,SAAA,IAAA,CAAA,KAAA,GAAA,EAAA,CAAA,qBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,iCAAiC,cADpB,MAAM,EAAA,CAAA,CAAA;;2FACnB,iCAAiC,EAAA,UAAA,EAAA,CAAA;kBAD7C,UAAU;mBAAC,EAAE,UAAU,EAAE,MAAM,EAAE;;;;;"}

package/fesm2022/acorex-platform-framework-client-realtime.mjs

@@ -1,8 +1,13 @@
 import * as i0 from '@angular/core';
-import { InjectionToken, Optional, Inject, Injectable, inject, makeEnvironmentProviders, APP_INITIALIZER } from '@angular/core';
+import { InjectionToken, Optional, Inject, Injectable, inject, DestroyRef, makeEnvironmentProviders } from '@angular/core';
 import { AXPSessionService, AXPSessionStatus } from '@acorex-platform/framework-client/auth';
 import { io } from 'socket.io-client';
-import { BehaviorSubject } from 'rxjs';
+import { BehaviorSubject, Subject } from 'rxjs';
+import { provideAppStartUpTask, AXP_APP_STARTUP_PRIORITY } from '@acorex-platform/framework-client/core';
+import { provideCommandSetups } from '@acorex-platform/framework-client/runtime';
+import { PRESENCE_SET_AVAILABILITY } from '@acorex-platform/framework-shared/runtime';
+import { DOCUMENT } from '@angular/common';
+import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
 
 //#region ---- Client realtime types ----
 //#endregion
@@ -10,10 +15,18 @@ import { BehaviorSubject } from 'rxjs';
 //#region ---- Client topic constants (mirror server) ----
 const AXP_REALTIME_TOPIC_INBOX_REFRESH = 'inbox.refresh';
 const AXP_REALTIME_TOPIC_CONVERSATION_MESSAGE = 'conversation.message';
+const AXP_REALTIME_TOPIC_CONVERSATION_TYPING = 'conversation.typing';
+const AXP_REALTIME_TOPIC_CONVERSATION_CALL = 'conversation.call';
 const AXP_REALTIME_TOPIC_ENTITY_MUTATION = 'entity.mutation';
+const AXP_REALTIME_TOPIC_USER_PRESENCE = 'user.presence';
 const AXP_REALTIME_SOCKET_EVENT = 'realtime';
 const AXP_REALTIME_SUBSCRIBE_CONVERSATION = 'subscribe.conversation';
 const AXP_REALTIME_UNSUBSCRIBE_CONVERSATION = 'unsubscribe.conversation';
+const AXP_REALTIME_SUBSCRIBE_PRESENCE = 'subscribe.presence';
+const AXP_REALTIME_UNSUBSCRIBE_PRESENCE = 'unsubscribe.presence';
+const AXP_REALTIME_PRESENCE_LEAVE = 'presence.leave';
+const AXP_REALTIME_PRESENCE_SET = 'presence.set';
+const AXP_REALTIME_EMIT_TYPING = 'conversation.typing.emit';
 //#endregion
 
 //#region ---- Realtime URL helpers ----
@@ -67,10 +80,10 @@ class AXPRealtimeDispatcherService {
             await registration.handle(envelope);
         }
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPRealtimeDispatcherService, deps: [{ token: AXP_REALTIME_TOPIC_HANDLER, optional: true }], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPRealtimeDispatcherService }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPRealtimeDispatcherService, deps: [{ token: AXP_REALTIME_TOPIC_HANDLER, optional: true }], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPRealtimeDispatcherService }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPRealtimeDispatcherService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPRealtimeDispatcherService, decorators: [{
             type: Injectable
         }], ctorParameters: () => [{ type: undefined, decorators: [{
                     type: Optional
@@ -79,9 +92,21 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
                     args: [AXP_REALTIME_TOPIC_HANDLER]
                 }] }] });
 
-//#region ---- Connection service ----
-class AXPRealtimeConnectionService {
+/**
+ * Always-on realtime connection used by the app shell.
+ * Built-in implementation uses Socket.IO; alternate backends may replace this port.
+ */
+class AXPRealtimeConnectionPort {
+}
+//#endregion
+
+//#region ---- Socket.IO connection (built-in) ----
+/**
+ * Built-in always-on realtime connection via Socket.IO.
+ */
+class AXPRealtimeConnectionService extends AXPRealtimeConnectionPort {
     constructor(config) {
+        super();
         this.config = config;
         this.session = inject(AXPSessionService);
         this.dispatcher = inject(AXPRealtimeDispatcherService);
@@ -95,11 +120,11 @@ class AXPRealtimeConnectionService {
             return;
         }
         this.statusSub = this.session.status$.subscribe((status) => {
-            if (status === AXPSessionStatus.Authenticated || status === AXPSessionStatus.Authorized) {
+            if (status === AXPSessionStatus.Authorized) {
                 this.connect();
             }
             else {
-                this.disconnect();
+                void this.leaveAndDisconnect();
             }
         });
     }
@@ -107,10 +132,14 @@ class AXPRealtimeConnectionService {
         this.statusSub?.unsubscribe();
         this.disconnect();
     }
+    /** Sign-out: tell the server to skip grace, then close the socket. */
+    async leaveAndDisconnect() {
+        await this.leavePresence();
+        this.disconnect();
+    }
     connect() {
-        const token = this.session.getToken()?.trim();
         const url = this.config?.url?.trim();
-        if (!token || !url) {
+        if (!url || !this.session.hasSessionCredentials()) {
             this.connectionStatusSubject.next('disconnected');
             return;
         }
@@ -122,9 +151,10 @@ class AXPRealtimeConnectionService {
             return;
         }
         this.connectionStatusSubject.next('connecting');
+        // Auth uses HttpOnly access cookie (same-site / proxied); no token in JS.
         this.socket = io(url, {
             transports: ['websocket', 'polling'],
-            auth: { token },
+            withCredentials: true,
             autoConnect: true,
             reconnection: true,
         });
@@ -177,10 +207,57 @@ class AXPRealtimeConnectionService {
         this.joinedConversations.delete(id);
         this.socket?.emit(AXP_REALTIME_UNSUBSCRIBE_CONVERSATION, { conversationId: id });
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPRealtimeConnectionService, deps: [{ token: AXP_REALTIME_CONFIG, optional: true }], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPRealtimeConnectionService }); }
+    emitConversationTyping(conversationId, active) {
+        const id = conversationId?.trim();
+        if (!id || !this.socket?.connected) {
+            return;
+        }
+        this.socket.emit(AXP_REALTIME_EMIT_TYPING, { conversationId: id, active });
+    }
+    subscribePresence(userIds) {
+        const ids = userIds.map((id) => id.trim()).filter(Boolean);
+        if (ids.length === 0 || !this.socket?.connected) {
+            return Promise.resolve([]);
+        }
+        return new Promise((resolve) => {
+            this.socket?.emit(AXP_REALTIME_SUBSCRIBE_PRESENCE, { userIds: ids }, (result) => {
+                resolve(Array.isArray(result?.items) ? result.items : []);
+            });
+        });
+    }
+    unsubscribePresence(userIds) {
+        const ids = userIds.map((id) => id.trim()).filter(Boolean);
+        if (ids.length === 0) {
+            return;
+        }
+        this.socket?.emit(AXP_REALTIME_UNSUBSCRIBE_PRESENCE, { userIds: ids });
+    }
+    leavePresence() {
+        if (!this.socket?.connected) {
+            return Promise.resolve();
+        }
+        return new Promise((resolve) => {
+            const timer = setTimeout(resolve, 400);
+            this.socket?.emit(AXP_REALTIME_PRESENCE_LEAVE, {}, () => {
+                clearTimeout(timer);
+                resolve();
+            });
+        });
+    }
+    setPresence(status, source = 'manual') {
+        if (!this.socket?.connected) {
+            return Promise.resolve(undefined);
+        }
+        return new Promise((resolve) => {
+            this.socket?.emit(AXP_REALTIME_PRESENCE_SET, { status, source }, (result) => {
+                resolve(result?.ok ? result.item : undefined);
+            });
+        });
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPRealtimeConnectionService, deps: [{ token: AXP_REALTIME_CONFIG, optional: true }], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPRealtimeConnectionService }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPRealtimeConnectionService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPRealtimeConnectionService, decorators: [{
             type: Injectable
         }], ctorParameters: () => [{ type: undefined, decorators: [{
                     type: Optional
@@ -189,8 +266,313 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
                     args: [AXP_REALTIME_CONFIG]
                 }] }] });
 
-//#region ---- provideRealtime ----
+//#region ----- Constants -----
+/** Idle without input before automatic Away. Keep in sync with server `AXP_USER_PRESENCE_IDLE_MS`. */
+const AXP_USER_PRESENCE_IDLE_MS = 5 * 60_000;
+//#endregion
+
+//#region ----- Presence helpers -----
+const PRESENCE_STATUSES = ['online', 'offline', 'away', 'busy'];
+function isWatchablePresenceUserId(userId) {
+    const id = userId?.trim() ?? '';
+    if (!id || id === 'system') {
+        return false;
+    }
+    return !id.startsWith('assist-');
+}
+function parseUserPresencePayload(payload) {
+    if (!payload || typeof payload !== 'object') {
+        return null;
+    }
+    const raw = payload;
+    const userId = raw.userId?.trim();
+    if (!userId) {
+        return null;
+    }
+    const status = PRESENCE_STATUSES.includes(raw.status) ? raw.status : 'offline';
+    const lastSeen = typeof raw.lastSeen === 'string' && raw.lastSeen.trim() ? raw.lastSeen.trim() : undefined;
+    const since = typeof raw.since === 'string' && raw.since.trim() ? raw.since.trim() : undefined;
+    const source = raw.source === 'auto' || raw.source === 'manual' ? raw.source : undefined;
+    return {
+        userId,
+        status,
+        ...(lastSeen ? { lastSeen } : {}),
+        ...(since ? { since } : {}),
+        ...(source ? { source } : {}),
+    };
+}
+//#endregion
+
+//#region ----- User presence store -----
+const FLUSH_DEBOUNCE_MS = 40;
+class AXPUserPresenceService {
+    //#endregion
+    constructor() {
+        //#region ----- Services & Dependencies -----
+        this.connection = inject(AXPRealtimeConnectionService, { optional: true });
+        //#endregion
+        //#region ----- State -----
+        this.presenceByUserId = new Map();
+        this.watchCounts = new Map();
+        this.subjects = new Map();
+        this.updatesSubject = new Subject();
+        this.flushTimer = null;
+        this.pendingSubscribe = new Set();
+        this.pendingUnsubscribe = new Set();
+        this.updates$ = this.updatesSubject.asObservable();
+        this.connection?.connectionStatus$.subscribe((status) => {
+            if (status === 'connected') {
+                this.resubscribeAll();
+            }
+        });
+    }
+    //#region ----- Public API -----
+    get(userId) {
+        const id = userId?.trim();
+        if (!id) {
+            return undefined;
+        }
+        return this.presenceByUserId.get(id);
+    }
+    presence$(userId) {
+        const id = userId?.trim();
+        const fallback = { userId: id, status: 'offline' };
+        if (!id) {
+            return new BehaviorSubject(fallback).asObservable();
+        }
+        let subject = this.subjects.get(id);
+        if (!subject) {
+            subject = new BehaviorSubject(this.presenceByUserId.get(id) ?? fallback);
+            this.subjects.set(id, subject);
+        }
+        return subject.asObservable();
+    }
+    watch(userId) {
+        if (!isWatchablePresenceUserId(userId)) {
+            return;
+        }
+        const id = userId.trim();
+        const next = (this.watchCounts.get(id) ?? 0) + 1;
+        this.watchCounts.set(id, next);
+        if (next === 1) {
+            this.pendingUnsubscribe.delete(id);
+            this.pendingSubscribe.add(id);
+            this.scheduleFlush();
+        }
+    }
+    watchMany(userIds) {
+        for (const userId of userIds) {
+            this.watch(userId);
+        }
+    }
+    /** Watch only if this user is not already in the local watch set. */
+    ensureWatch(userId) {
+        const id = userId?.trim();
+        if (!id || (this.watchCounts.get(id) ?? 0) > 0) {
+            return;
+        }
+        this.watch(id);
+    }
+    ensureWatchMany(userIds) {
+        for (const userId of userIds) {
+            this.ensureWatch(userId);
+        }
+    }
+    unwatch(userId) {
+        const id = userId?.trim();
+        if (!id) {
+            return;
+        }
+        const current = this.watchCounts.get(id) ?? 0;
+        if (current <= 1) {
+            this.watchCounts.delete(id);
+            this.pendingSubscribe.delete(id);
+            this.pendingUnsubscribe.add(id);
+            this.scheduleFlush();
+            return;
+        }
+        this.watchCounts.set(id, current - 1);
+    }
+    applySnapshot(items) {
+        for (const item of items) {
+            this.applyPresence(item);
+        }
+    }
+    applyEnvelopePayload(payload) {
+        const parsed = parseUserPresencePayload(payload);
+        if (parsed) {
+            this.applyPresence(parsed);
+        }
+    }
+    async setAvailability(status, source = 'manual') {
+        const item = await this.connection?.setPresence(status, source);
+        if (item) {
+            this.applyPresence(item);
+        }
+    }
+    //#endregion
+    //#region ----- Store updates -----
+    applyPresence(presence) {
+        const previous = this.presenceByUserId.get(presence.userId);
+        if (previous &&
+            previous.status === presence.status &&
+            previous.lastSeen === presence.lastSeen &&
+            previous.since === presence.since) {
+            return;
+        }
+        this.presenceByUserId.set(presence.userId, presence);
+        const subject = this.subjects.get(presence.userId);
+        if (subject && !subject.closed) {
+            subject.next(presence);
+        }
+        this.updatesSubject.next(presence);
+    }
+    scheduleFlush() {
+        if (this.flushTimer) {
+            return;
+        }
+        this.flushTimer = setTimeout(() => {
+            this.flushTimer = null;
+            void this.flush();
+        }, FLUSH_DEBOUNCE_MS);
+    }
+    async flush() {
+        const subscribeIds = Array.from(this.pendingSubscribe);
+        const unsubscribeIds = Array.from(this.pendingUnsubscribe);
+        this.pendingSubscribe.clear();
+        this.pendingUnsubscribe.clear();
+        if (unsubscribeIds.length > 0) {
+            this.connection?.unsubscribePresence(unsubscribeIds);
+        }
+        if (subscribeIds.length === 0) {
+            return;
+        }
+        const items = (await this.connection?.subscribePresence(subscribeIds)) ?? [];
+        this.applySnapshot(items);
+    }
+    resubscribeAll() {
+        const watched = Array.from(this.watchCounts.keys());
+        if (watched.length === 0) {
+            return;
+        }
+        this.pendingUnsubscribe.clear();
+        for (const id of watched) {
+            this.pendingSubscribe.add(id);
+        }
+        this.scheduleFlush();
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPUserPresenceService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPUserPresenceService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPUserPresenceService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }], ctorParameters: () => [] });
+
+//#region ----- Automatic away from idle -----
+const IDLE_CHECK_MS = 15_000;
+const ACTIVITY_THROTTLE_MS = 1_000;
+class AXPUserPresenceIdleService {
+    //#endregion
+    constructor() {
+        //#region ----- Services & Dependencies -----
+        this.document = inject(DOCUMENT);
+        this.session = inject(AXPSessionService);
+        this.presence = inject(AXPUserPresenceService);
+        this.destroyRef = inject(DestroyRef);
+        //#endregion
+        //#region ----- State -----
+        this.lastActivityAt = Date.now();
+        this.lastActivityEmitAt = 0;
+        this.idle = false;
+        this.checkTimer = null;
+        this.started = false;
+        //#endregion
+        //#region ----- Activity -----
+        this.onActivity = () => {
+            const now = Date.now();
+            this.lastActivityAt = now;
+            if (now - this.lastActivityEmitAt < ACTIVITY_THROTTLE_MS) {
+                return;
+            }
+            this.lastActivityEmitAt = now;
+            if (this.idle) {
+                this.idle = false;
+                void this.presence.setAvailability('online', 'auto');
+            }
+        };
+        this.onVisibility = () => {
+            if (!this.document.hidden) {
+                this.onActivity();
+            }
+        };
+        this.session.status$.pipe(takeUntilDestroyed(this.destroyRef)).subscribe((status) => {
+            if (status === AXPSessionStatus.Authorized) {
+                this.start();
+                return;
+            }
+            this.stop();
+        });
+    }
+    //#region ----- Lifecycle -----
+    start() {
+        if (this.started) {
+            return;
+        }
+        this.started = true;
+        this.lastActivityAt = Date.now();
+        this.idle = false;
+        const target = this.document.defaultView ?? this.document;
+        target.addEventListener('mousemove', this.onActivity, { passive: true });
+        target.addEventListener('keydown', this.onActivity, { passive: true });
+        target.addEventListener('mousedown', this.onActivity, { passive: true });
+        target.addEventListener('touchstart', this.onActivity, { passive: true });
+        this.document.addEventListener('visibilitychange', this.onVisibility);
+        this.checkTimer = setInterval(() => this.checkIdle(), IDLE_CHECK_MS);
+    }
+    stop() {
+        if (!this.started) {
+            return;
+        }
+        this.started = false;
+        this.idle = false;
+        const target = this.document.defaultView ?? this.document;
+        target.removeEventListener('mousemove', this.onActivity);
+        target.removeEventListener('keydown', this.onActivity);
+        target.removeEventListener('mousedown', this.onActivity);
+        target.removeEventListener('touchstart', this.onActivity);
+        this.document.removeEventListener('visibilitychange', this.onVisibility);
+        if (this.checkTimer) {
+            clearInterval(this.checkTimer);
+            this.checkTimer = null;
+        }
+    }
+    checkIdle() {
+        if (!this.started || this.idle) {
+            return;
+        }
+        if (Date.now() - this.lastActivityAt < AXP_USER_PRESENCE_IDLE_MS) {
+            return;
+        }
+        this.idle = true;
+        void this.presence.setAvailability('away', 'auto');
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPUserPresenceIdleService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPUserPresenceIdleService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPUserPresenceIdleService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }], ctorParameters: () => [] });
+
+/**
+ * Registers built-in always-on realtime (Socket.IO) + topic dispatcher.
+ */
 function provideRealtime(config = {}) {
+    const backend = config.backend ?? 'builtin';
+    if (backend !== 'builtin') {
+        throw new Error(`Unsupported realtime backend '${String(backend)}'. Use 'builtin'.`);
+    }
     const url = config.url?.trim() ||
         (config.apiBaseUrl?.trim() ? resolveRealtimeSocketUrl(config.apiBaseUrl) : undefined);
     return makeEnvironmentProviders([
@@ -204,24 +586,79 @@ function provideRealtime(config = {}) {
         AXPRealtimeDispatcherService,
         AXPRealtimeConnectionService,
         {
-            provide: APP_INITIALIZER,
-            multi: true,
-            useFactory: () => {
-                const connection = inject(AXPRealtimeConnectionService);
-                return () => {
-                    // Connection lifecycle is owned by AXPRealtimeConnectionService (session.status$).
+            provide: AXPRealtimeConnectionPort,
+            useExisting: AXPRealtimeConnectionService,
+        },
+        provideCommandSetups([
+            {
+                key: PRESENCE_SET_AVAILABILITY,
+                command: () => import('./acorex-platform-framework-client-realtime-set-presence-availability.command-CetlUjnM.mjs').then((c) => c.AXPSetPresenceAvailabilityCommand),
+            },
+        ]),
+        provideAppStartUpTask(() => {
+            inject(AXPUserPresenceIdleService);
+            return {
+                name: 'user-presence-idle',
+                priority: AXP_APP_STARTUP_PRIORITY.realtimeSubscriptions,
+                run: async () => undefined,
+            };
+        }),
+        provideAppStartUpTask(() => {
+            const dispatcher = inject(AXPRealtimeDispatcherService);
+            const presence = inject(AXPUserPresenceService);
+            return {
+                name: 'user-presence-handler',
+                priority: AXP_APP_STARTUP_PRIORITY.realtimeHandlers,
+                run: async () => {
+                    dispatcher.register({
+                        topic: AXP_REALTIME_TOPIC_USER_PRESENCE,
+                        handle: (envelope) => {
+                            presence.applyEnvelopePayload(envelope.payload);
+                        },
+                    });
+                },
+            };
+        }),
+        provideAppStartUpTask(() => {
+            const connection = inject(AXPRealtimeConnectionPort);
+            return {
+                name: 'realtime-connect',
+                priority: AXP_APP_STARTUP_PRIORITY.realtimeConnect,
+                run: async () => {
+                    // Connection lifecycle is owned by the connection service (session.status$).
                     // Eagerly invoke connect once so an already-authenticated session connects on bootstrap.
                     connection.connect();
-                };
-            },
-        },
+                },
+            };
+        }),
     ]);
 }
 //#endregion
 
+//#endregion
+
+//#region ----- Presence duration tooltip -----
+function presenceDurationBucket(ms) {
+    const elapsed = Math.max(0, ms);
+    if (elapsed < 60_000) {
+        return { key: 'duration.less-than-a-minute' };
+    }
+    const minutes = Math.floor(elapsed / 60_000);
+    if (minutes < 60) {
+        return minutes === 1 ? { key: 'duration.one-minute' } : { key: 'duration.minutes', params: { count: minutes } };
+    }
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24) {
+        return hours === 1 ? { key: 'duration.one-hour' } : { key: 'duration.hours', params: { count: hours } };
+    }
+    const days = Math.floor(hours / 24);
+    return days === 1 ? { key: 'duration.one-day' } : { key: 'duration.days', params: { count: days } };
+}
+//#endregion
+
 /**
  * Generated bundle index. Do not edit.
  */
 
-export { AXPRealtimeConnectionService, AXPRealtimeDispatcherService, AXP_REALTIME_CONFIG, AXP_REALTIME_SOCKET_EVENT, AXP_REALTIME_SUBSCRIBE_CONVERSATION, AXP_REALTIME_TOPIC_CONVERSATION_MESSAGE, AXP_REALTIME_TOPIC_ENTITY_MUTATION, AXP_REALTIME_TOPIC_HANDLER, AXP_REALTIME_TOPIC_INBOX_REFRESH, AXP_REALTIME_UNSUBSCRIBE_CONVERSATION, provideRealtime, resolveRealtimeSocketUrl };
+export { AXPRealtimeConnectionPort, AXPRealtimeConnectionService, AXPRealtimeDispatcherService, AXPUserPresenceIdleService, AXPUserPresenceService, AXP_REALTIME_CONFIG, AXP_REALTIME_EMIT_TYPING, AXP_REALTIME_PRESENCE_LEAVE, AXP_REALTIME_PRESENCE_SET, AXP_REALTIME_SOCKET_EVENT, AXP_REALTIME_SUBSCRIBE_CONVERSATION, AXP_REALTIME_SUBSCRIBE_PRESENCE, AXP_REALTIME_TOPIC_CONVERSATION_CALL, AXP_REALTIME_TOPIC_CONVERSATION_MESSAGE, AXP_REALTIME_TOPIC_CONVERSATION_TYPING, AXP_REALTIME_TOPIC_ENTITY_MUTATION, AXP_REALTIME_TOPIC_HANDLER, AXP_REALTIME_TOPIC_INBOX_REFRESH, AXP_REALTIME_TOPIC_USER_PRESENCE, AXP_REALTIME_UNSUBSCRIBE_CONVERSATION, AXP_REALTIME_UNSUBSCRIBE_PRESENCE, AXP_USER_PRESENCE_IDLE_MS, isWatchablePresenceUserId, parseUserPresencePayload, presenceDurationBucket, provideRealtime, resolveRealtimeSocketUrl };
 //# sourceMappingURL=acorex-platform-framework-client-realtime.mjs.map