@actschurch/ccms-sdk 0.0.3 → 0.0.5

package/dist/realtime/presence/PresenceProvider.js

@@ -2,6 +2,22 @@
  * PresenceProvider
  * React Context Provider for presence management
  * Auto-connects on login, auto-disconnects on logout, handles activity detection
+ *
+ * @deprecated For new projects, use CCMSProvider with presenceUrl config instead.
+ * This provider is maintained for backward compatibility and fine-grained control.
+ *
+ * Migration example:
+ * ```typescript
+ * // Old way:
+ * <PresenceProvider authManager={authManager} baseUrl={baseUrl}>
+ *   <App />
+ * </PresenceProvider>
+ *
+ * // New way (recommended):
+ * <CCMSProvider config={{ baseUrl, presenceUrl, getToken: async () => token }}>
+ *   <App />
+ * </CCMSProvider>
+ * ```
  */
 import React, { useRef, useReducer, useEffect, useCallback, useMemo } from 'react';
 import { PresenceContext } from './PresenceContext';
@@ -91,6 +107,8 @@ function detectPlatform() {
 export function PresenceProvider({ children, authManager, baseUrl, options = {}, onConnectionChange, onConnectionError, }) {
     const presenceClientRef = useRef(null);
     const activityDetectorRef = useRef(null);
+    const isConnectingRef = useRef(false);
+    const tokenRef = useRef(null); // Store latest token for SignalR
     const [state, dispatch] = useReducer(presenceReducer, initialPresenceState);
     // Detect platform if not specified
     const platform = options.platform || detectPlatform();
@@ -98,19 +116,40 @@ export function PresenceProvider({ children, authManager, baseUrl, options = {},
      * Handle login - create client and connect
      */
     const handleLogin = useCallback(async (authState) => {
-        if (!authState.isAuthenticated || !authState.user) {
+        if (!authState.isAuthenticated || !authState.user?.accessToken) {
+            console.warn('[PresenceProvider] Cannot connect - no access token in auth state');
             return;
         }
+        // Prevent multiple simultaneous connection attempts
+        if (isConnectingRef.current) {
+            console.log('[PresenceProvider] Connection already in progress, skipping...');
+            return;
+        }
+        // If already connected, skip
+        if (presenceClientRef.current && state.isConnected) {
+            console.log('[PresenceProvider] Already connected, skipping...');
+            return;
+        }
+        isConnectingRef.current = true;
         try {
+            // Token is already stored in ref by the subscription
+            // This allows the token to be updated on refresh without recreating the client
+            console.log('[PresenceProvider] Connecting with stored token', {
+                hasToken: !!tokenRef.current,
+                tokenLength: tokenRef.current?.length,
+            });
             // Create PresenceClient if needed
             if (!presenceClientRef.current) {
                 const hubUrl = `${baseUrl}/presencehub`;
-                // Capture the user from authState to avoid timing issues with React state updates
-                const capturedUser = authState.user;
                 presenceClientRef.current = new PresenceClient(hubUrl, async () => {
-                    // First try authManager.getUser(), fall back to captured user from authState
-                    const user = authManager.getUser() || capturedUser;
-                    return user?.accessToken || null;
+                    // Return the latest token from ref (updated on token refresh)
+                    // This avoids React state timing issues and supports token refresh
+                    console.log('[PresenceProvider] accessTokenFactory called', {
+                        hasToken: !!tokenRef.current,
+                        tokenLength: tokenRef.current?.length,
+                        timestamp: new Date().toISOString(),
+                    });
+                    return tokenRef.current;
                 }, options);
                 // Subscribe to presence client events
                 presenceClientRef.current.onStateChange((connectionState, error) => {
@@ -122,30 +161,43 @@ export function PresenceProvider({ children, authManager, baseUrl, options = {},
                     }
                     onConnectionChange?.(connected);
                 });
-                presenceClientRef.current.on('userOnline', ({ presence }) => {
+                // Backend sends PresenceUpdate objects directly, not wrapped in { userId, presence }
+                presenceClientRef.current.on('userOnline', (presence) => {
                     dispatch({ type: 'USER_ONLINE', payload: presence });
                 });
-                presenceClientRef.current.on('userOffline', ({ userId }) => {
-                    dispatch({ type: 'USER_OFFLINE', payload: userId });
+                presenceClientRef.current.on('userOffline', (presence) => {
+                    dispatch({ type: 'USER_OFFLINE', payload: presence.userId });
                 });
-                presenceClientRef.current.on('statusChanged', ({ presence }) => {
+                presenceClientRef.current.on('statusChanged', (presence) => {
                     dispatch({ type: 'USER_STATUS_CHANGED', payload: presence });
                 });
+                // Listen for current user's own presence changes
+                presenceClientRef.current.on('currentUserPresenceChanged', (presence) => {
+                    dispatch({ type: 'SET_CURRENT_USER_PRESENCE', payload: presence });
+                });
             }
-            // Wait a small delay for auth state to propagate through React context
-            await new Promise(resolve => setTimeout(resolve, 100));
-            // Connect to hub
+            // Connect to hub (token is already captured, no delay needed)
             await presenceClientRef.current.connect();
+            // Start heartbeat interval (send heartbeat every 30 seconds)
+            const heartbeatInterval = setInterval(() => {
+                if (presenceClientRef.current) {
+                    presenceClientRef.current.heartbeat().catch((error) => {
+                        console.error('[PresenceProvider] Heartbeat failed:', error);
+                    });
+                }
+            }, 30000); // 30 seconds
+            // Store interval ID for cleanup
+            presenceClientRef.current._heartbeatInterval = heartbeatInterval;
             // Start activity detection if enabled
             if (options.enableActivityDetection !== false) {
                 activityDetectorRef.current = new ActivityDetector(
-                // On active
+                // On active - call recordActivity which automatically updates status if needed
                 () => {
-                    presenceClientRef.current?.updateStatus(PresenceStatus.Online).catch((error) => {
-                        console.error('[PresenceProvider] Failed to update status to Online:', error);
+                    presenceClientRef.current?.recordActivity().catch((error) => {
+                        console.error('[PresenceProvider] Failed to record activity:', error);
                     });
                 }, 
-                // On inactive
+                // On inactive - manually update to Away
                 () => {
                     presenceClientRef.current?.updateStatus(PresenceStatus.Away).catch((error) => {
                         console.error('[PresenceProvider] Failed to update status to Away:', error);
@@ -161,7 +213,10 @@ export function PresenceProvider({ children, authManager, baseUrl, options = {},
             dispatch({ type: 'SET_ERROR', payload: err });
             onConnectionError?.(err);
         }
-    }, [authManager, baseUrl, options, platform, onConnectionChange, onConnectionError]);
+        finally {
+            isConnectingRef.current = false;
+        }
+    }, [authManager, baseUrl, options, platform, onConnectionChange, onConnectionError, state.isConnected]);
     /**
      * Handle logout - disconnect and cleanup
      */
@@ -169,8 +224,14 @@ export function PresenceProvider({ children, authManager, baseUrl, options = {},
         // Stop activity detection
         activityDetectorRef.current?.stop();
         activityDetectorRef.current = null;
-        // Disconnect from hub
+        // Clear heartbeat interval
         if (presenceClientRef.current) {
+            const heartbeatInterval = presenceClientRef.current._heartbeatInterval;
+            if (heartbeatInterval) {
+                clearInterval(heartbeatInterval);
+                presenceClientRef.current._heartbeatInterval = null;
+            }
+            // Disconnect from hub
             await presenceClientRef.current.disconnect();
         }
         // Reset state
@@ -178,12 +239,23 @@ export function PresenceProvider({ children, authManager, baseUrl, options = {},
     }, []);
     /**
      * Subscribe to auth state changes
+     * NOTE: In production, PresenceProvider should only be mounted AFTER user is authenticated
+     * This prevents WebSocket connection from blocking the login flow
      */
     useEffect(() => {
         const unsubscribe = authManager.subscribe((authState) => {
             const state = authState;
             if (state.isAuthenticated && state.user) {
-                handleLogin(state);
+                // Verify token is actually available before connecting
+                if (state.user.accessToken) {
+                    console.log('[PresenceProvider] Auth state updated with token, connecting...');
+                    // Store token immediately
+                    tokenRef.current = state.user.accessToken;
+                    handleLogin(state);
+                }
+                else {
+                    console.warn('[PresenceProvider] Auth state updated but token not yet available');
+                }
             }
             else {
                 handleLogout();

package/dist/realtime/presence/PresenceProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"PresenceProvider.js","sourceRoot":"","sources":["../../../src/realtime/presence/PresenceProvider.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"PresenceProvider.js","sourceRoot":"","sources":["../../../src/realtime/presence/PresenceProvider.tsx"],"names":[],"mappings":"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"}

package/dist/realtime/presence/index.d.ts

@@ -4,6 +4,11 @@
  */
 export * from './types';
 export * from './PresenceClient';
+export * from './utils';
+export * from './AutoHeartbeatManager';
+export * from './ActivityTracker';
+export * from './IdleDetector';
+export * from './PresenceManager';
 export * from './ActivityDetector';
 export * from './PresenceContext';
 export * from './PresenceProvider';

package/dist/realtime/presence/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/realtime/presence/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/realtime/presence/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AAGjC,cAAc,SAAS,CAAC;AAGxB,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,mBAAmB,CAAC;AAGlC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}

package/dist/realtime/presence/index.js

@@ -2,8 +2,18 @@
  * Presence Module
  * Real-time user presence tracking with automatic status management
  */
+// Core types and client
 export * from './types';
 export * from './PresenceClient';
+// Utility helpers
+export * from './utils';
+// Automatic feature managers
+export * from './AutoHeartbeatManager';
+export * from './ActivityTracker';
+export * from './IdleDetector';
+// High-level manager (recommended)
+export * from './PresenceManager';
+// Legacy components (still available for backward compatibility)
 export * from './ActivityDetector';
 export * from './PresenceContext';
 export * from './PresenceProvider';

package/dist/realtime/presence/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/realtime/presence/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,mEAAmE;AACnE,qEAAqE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/realtime/presence/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAwB;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AAEjC,kBAAkB;AAClB,cAAc,SAAS,CAAC;AAExB,6BAA6B;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAE/B,mCAAmC;AACnC,cAAc,mBAAmB,CAAC;AAElC,iEAAiE;AACjE,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AAEnC,mEAAmE;AACnE,qEAAqE"}

package/dist/realtime/presence/types.d.ts

@@ -5,13 +5,14 @@
 import { SignalRClientOptions } from '../shared/types';
 /**
  * Presence status enum
- * Matches backend PresenceStatus enum
+ * Matches backend PresenceStatus enum (numeric values)
+ * IMPORTANT: Backend expects numeric values (0, 1, 2, 3)
  */
 export declare enum PresenceStatus {
-    Offline = "Offline",
-    Online = "Online",
-    Away = "Away",
-    Busy = "Busy"
+    Offline = 0,
+    Online = 1,
+    Away = 2,
+    Busy = 3
 }
 /**
  * User presence update
@@ -24,16 +25,34 @@ export interface UserPresenceUpdate {
     userName?: string;
     /** Current presence status */
     status: PresenceStatus;
-    /** Last activity timestamp (ISO-8601) */
-    lastActivity: string;
-    /** Optional status message (e.g., "In a meeting") */
-    statusMessage?: string | null;
-    /** Current working location */
-    workingAt?: string | null;
+    /** Last seen/activity timestamp (ISO-8601) */
+    lastSeen: string;
+    /** Optional activity/status message (e.g., "In a meeting", "🏖️ On vacation") */
+    activityMessage?: string | null;
     /** Whether user is online */
     isOnline: boolean;
-    /** SignalR connection ID */
-    connectionId: string;
+    /** SignalR connection ID (optional) */
+    connectionId?: string;
+    /** Platform (web, ios, android, desktop) */
+    platform?: string;
+}
+/**
+ * Presence statistics (Admin only)
+ * Matches backend PresenceStatistics DTO
+ */
+export interface PresenceStats {
+    /** Total number of users in the system */
+    totalUsers: number;
+    /** Number of users with Online status */
+    onlineUsers: number;
+    /** Number of users with Away status */
+    awayUsers: number;
+    /** Number of users with Busy status */
+    busyUsers: number;
+    /** Number of users with Offline status */
+    offlineUsers: number;
+    /** Timestamp when statistics were generated */
+    timestamp: string;
 }
 /**
  * Presence client options

package/dist/realtime/presence/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/realtime/presence/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/realtime/presence/types.ts"],"names":[],"mappings":"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"}

package/dist/realtime/presence/types.js

@@ -4,14 +4,15 @@
  */
 /**
  * Presence status enum
- * Matches backend PresenceStatus enum
+ * Matches backend PresenceStatus enum (numeric values)
+ * IMPORTANT: Backend expects numeric values (0, 1, 2, 3)
  */
 export var PresenceStatus;
 (function (PresenceStatus) {
-    PresenceStatus["Offline"] = "Offline";
-    PresenceStatus["Online"] = "Online";
-    PresenceStatus["Away"] = "Away";
-    PresenceStatus["Busy"] = "Busy";
+    PresenceStatus[PresenceStatus["Offline"] = 0] = "Offline";
+    PresenceStatus[PresenceStatus["Online"] = 1] = "Online";
+    PresenceStatus[PresenceStatus["Away"] = 2] = "Away";
+    PresenceStatus[PresenceStatus["Busy"] = 3] = "Busy";
 })(PresenceStatus || (PresenceStatus = {}));
 /**
  * Default activity detector options

package/dist/realtime/presence/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/realtime/presence/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,MAAM,CAAN,IAAY,cAKX;AALD,WAAY,cAAc;IACxB,qCAAmB,CAAA;IACnB,mCAAiB,CAAA;IACjB,+BAAa,CAAA;IACb,+BAAa,CAAA;AACf,CAAC,EALW,cAAc,KAAd,cAAc,QAKzB;AAgHD;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAA4B;IAC/D,iBAAiB,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;IAC9C,aAAa,EAAE,EAAE,GAAG,IAAI,EAAW,aAAa;IAChD,aAAa,EAAE,IAAI,EAAgB,WAAW;CAC/C,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/realtime/presence/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;GAIG;AACH,MAAM,CAAN,IAAY,cAKX;AALD,WAAY,cAAc;IACxB,yDAAW,CAAA;IACX,uDAAU,CAAA;IACV,mDAAQ,CAAA;IACR,mDAAQ,CAAA;AACV,CAAC,EALW,cAAc,KAAd,cAAc,QAKzB;AAmID;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAA4B;IAC/D,iBAAiB,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;IAC9C,aAAa,EAAE,EAAE,GAAG,IAAI,EAAW,aAAa;IAChD,aAAa,EAAE,IAAI,EAAgB,WAAW;CAC/C,CAAC"}

package/dist/realtime/presence/utils/platformDetector.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Platform Detector Utility
+ * Detects the platform from which the user is connecting
+ */
+export type Platform = 'web' | 'ios' | 'android' | 'desktop';
+/**
+ * Detect the current platform based on user agent and environment
+ */
+export declare function detectPlatform(): Platform;
+/**
+ * Get platform-specific activity timeout
+ * Mobile devices need longer timeouts due to different interaction patterns
+ */
+export declare function getPlatformActivityTimeout(platform: Platform): number;
+/**
+ * Get platform display name
+ */
+export declare function getPlatformDisplayName(platform?: string): string;
+/**
+ * Get platform icon name (for use with icon libraries)
+ */
+export declare function getPlatformIcon(platform?: string): string;
+//# sourceMappingURL=platformDetector.d.ts.map

package/dist/realtime/presence/utils/platformDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platformDetector.d.ts","sourceRoot":"","sources":["../../../../src/realtime/presence/utils/platformDetector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7D;;GAEG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CAuCzC;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAWrE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAYhE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAYzD"}

package/dist/realtime/presence/utils/platformDetector.js

@@ -0,0 +1,88 @@
+/**
+ * Platform Detector Utility
+ * Detects the platform from which the user is connecting
+ */
+/**
+ * Detect the current platform based on user agent and environment
+ */
+export function detectPlatform() {
+    // Check if we're in a browser environment
+    if (typeof window === 'undefined' || typeof navigator === 'undefined') {
+        return 'web'; // Default for server-side rendering
+    }
+    const userAgent = navigator.userAgent.toLowerCase();
+    const platform = navigator.platform?.toLowerCase() || '';
+    // Check for mobile platforms
+    if (/iphone|ipad|ipod/.test(userAgent)) {
+        return 'ios';
+    }
+    if (/android/.test(userAgent)) {
+        return 'android';
+    }
+    // Check for desktop platforms
+    if (/electron/.test(userAgent)) {
+        return 'desktop';
+    }
+    // Check if running as PWA or native-like environment
+    if (window.matchMedia('(display-mode: standalone)').matches ||
+        window.navigator.standalone === true) {
+        // Could be iOS/Android PWA, check user agent again
+        if (/iphone|ipad|ipod/.test(userAgent)) {
+            return 'ios';
+        }
+        if (/android/.test(userAgent)) {
+            return 'android';
+        }
+    }
+    // Default to web for desktop browsers
+    return 'web';
+}
+/**
+ * Get platform-specific activity timeout
+ * Mobile devices need longer timeouts due to different interaction patterns
+ */
+export function getPlatformActivityTimeout(platform) {
+    switch (platform) {
+        case 'ios':
+        case 'android':
+            return 10 * 60 * 1000; // 10 minutes for mobile
+        case 'desktop':
+            return 5 * 60 * 1000; // 5 minutes for desktop apps
+        case 'web':
+        default:
+            return 5 * 60 * 1000; // 5 minutes for web
+    }
+}
+/**
+ * Get platform display name
+ */
+export function getPlatformDisplayName(platform) {
+    switch (platform?.toLowerCase()) {
+        case 'ios':
+            return 'iOS';
+        case 'android':
+            return 'Android';
+        case 'desktop':
+            return 'Desktop';
+        case 'web':
+        default:
+            return 'Web';
+    }
+}
+/**
+ * Get platform icon name (for use with icon libraries)
+ */
+export function getPlatformIcon(platform) {
+    switch (platform?.toLowerCase()) {
+        case 'ios':
+            return 'apple';
+        case 'android':
+            return 'android';
+        case 'desktop':
+            return 'desktop';
+        case 'web':
+        default:
+            return 'browser';
+    }
+}
+//# sourceMappingURL=platformDetector.js.map

package/dist/realtime/presence/utils/platformDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platformDetector.js","sourceRoot":"","sources":["../../../../src/realtime/presence/utils/platformDetector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,0CAA0C;IAC1C,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,SAAS,KAAK,WAAW,EAAE,CAAC;QACtE,OAAO,KAAK,CAAC,CAAC,oCAAoC;IACpD,CAAC;IAED,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;IACpD,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAEzD,6BAA6B;IAC7B,IAAI,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,8BAA8B;IAC9B,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,qDAAqD;IACrD,IACE,MAAM,CAAC,UAAU,CAAC,4BAA4B,CAAC,CAAC,OAAO;QACtD,MAAM,CAAC,SAAiB,CAAC,UAAU,KAAK,IAAI,EAC7C,CAAC;QACD,mDAAmD;QACnD,IAAI,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACvC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,sCAAsC;IACtC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,QAAkB;IAC3D,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,KAAK,CAAC;QACX,KAAK,SAAS;YACZ,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,wBAAwB;QACjD,KAAK,SAAS;YACZ,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,6BAA6B;QACrD,KAAK,KAAK,CAAC;QACX;YACE,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,oBAAoB;IAC9C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAiB;IACtD,QAAQ,QAAQ,EAAE,WAAW,EAAE,EAAE,CAAC;QAChC,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,KAAK,CAAC;QACX;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAiB;IAC/C,QAAQ,QAAQ,EAAE,WAAW,EAAE,EAAE,CAAC;QAChC,KAAK,KAAK;YACR,OAAO,OAAO,CAAC;QACjB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,KAAK,CAAC;QACX;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/realtime/presence/utils.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Presence Utility Functions
+ * Helper utilities extracted from the working test app for consistency
+ * These match the patterns used in frontend/web_sockets_test/PresenceHub/react-app
+ */
+import { PresenceStatus } from './types';
+/**
+ * Get human-readable status name from enum
+ * @param status - Presence status enum value
+ * @returns Status name string
+ */
+export declare function getStatusName(status: PresenceStatus): string;
+/**
+ * Get status color for UI (hex color)
+ * Matches the test app's color scheme
+ * @param status - Presence status enum value
+ * @returns Hex color string
+ */
+export declare function getStatusColor(status: PresenceStatus): string;
+/**
+ * Generate user initials from name
+ * Falls back to userId if name is not available
+ * @param userName - User's display name (can be null/undefined)
+ * @param userId - User's ID (fallback)
+ * @returns Two-letter initials in uppercase
+ */
+export declare function getUserInitials(userName: string | null | undefined, userId: string): string;
+/**
+ * Generate deterministic avatar color from userId
+ * Uses hash function to consistently assign one of 10 colors
+ * @param userId - User's ID
+ * @returns Hex color string
+ */
+export declare function getAvatarColor(userId: string): string;
+/**
+ * Get relative time string (e.g., "5 minutes ago")
+ * @param lastSeenDate - Last seen date (ISO-8601 string or Date object)
+ * @returns Human-readable relative time string
+ */
+export declare function getRelativeTime(lastSeenDate: Date | string): string;
+/**
+ * Extract userId from JWT token
+ * Supports multiple claim formats used by different auth systems
+ * @param token - JWT token string
+ * @returns User ID or null if extraction fails
+ */
+export declare function extractUserIdFromToken(token: string): string | null;
+/**
+ * Extract admin role from JWT token
+ * Checks if the token contains "Admin" role
+ * @param token - JWT token string
+ * @returns True if user has Admin role, false otherwise
+ */
+export declare function extractAdminRoleFromToken(token: string): boolean;
+/**
+ * Format timestamp to locale string
+ * @param timestamp - ISO-8601 timestamp string
+ * @returns Formatted date/time string
+ */
+export declare function formatTimestamp(timestamp: string): string;
+/**
+ * Status preset configurations
+ * Matches the test app's quick status buttons
+ */
+export declare const STATUS_PRESETS: {
+    readonly available: {
+        readonly status: PresenceStatus.Online;
+        readonly message: "";
+    };
+    readonly onBreak: {
+        readonly status: PresenceStatus.Away;
+        readonly message: "On break";
+    };
+    readonly inMeeting: {
+        readonly status: PresenceStatus.Busy;
+        readonly message: "In a meeting";
+    };
+    readonly doNotDisturb: {
+        readonly status: PresenceStatus.Busy;
+        readonly message: "Do not disturb";
+    };
+    readonly appearOffline: {
+        readonly status: PresenceStatus.Offline;
+        readonly message: "Appear offline";
+    };
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/realtime/presence/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/realtime/presence/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAa7D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAY3F;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAsBrD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAiBnE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgBnE;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAkBhE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;CAqBjB,CAAC"}