@actschurch/ccms-sdk 0.0.3 → 0.0.5

package/dist/realtime/presence/ActivityTracker.js

@@ -0,0 +1,342 @@
+/**
+ * ActivityTracker
+ * Tracks user activity (mouse, keyboard) and sends to backend with debounce
+ * Platform-aware: Works on web, React Native, and Node.js
+ * Matches the test app's activity tracking implementation
+ */
+export class ActivityTracker {
+    /**
+     * Create ActivityTracker
+     * @param presenceClient - PresenceClient instance
+     * @param debounceMs - Debounce delay in milliseconds (default: 5000 = 5 seconds) - DEPRECATED
+     * @param highSignificanceThrottleMs - Throttle delay for keyboard/clicks (default: 2000 = 2 seconds)
+     * @param lowSignificanceThrottleMs - Throttle delay for mouse/scroll (default: 5000 = 5 seconds)
+     * @param platform - Platform type (default: auto-detect)
+     */
+    constructor(presenceClient, debounceMs = 5000, highSignificanceThrottleMs = 2000, lowSignificanceThrottleMs = 5000, platform = 'web') {
+        this.presenceClient = presenceClient;
+        this.debounceMs = debounceMs;
+        this.highSignificanceThrottleMs = highSignificanceThrottleMs;
+        this.lowSignificanceThrottleMs = lowSignificanceThrottleMs;
+        this.platform = platform;
+        this.debounceTimer = null;
+        this.throttleTimer = null;
+        this.lastActivityTime = Date.now();
+        this.lastServerSyncTime = 0;
+        this.isActive = false;
+        this.activityHandler = null;
+        this.highSignificanceHandler = null;
+        this.lowSignificanceHandler = null;
+        /**
+         * Handle activity event (internal) - DEPRECATED, kept for React Native compatibility
+         * Debounces calls to recordActivity
+         * @private
+         */
+        this.handleActivity = () => {
+            this.lastActivityTime = Date.now();
+            // Clear existing debounce timer
+            if (this.debounceTimer) {
+                clearTimeout(this.debounceTimer);
+            }
+            // Set new debounce timer
+            this.debounceTimer = setTimeout(async () => {
+                try {
+                    await this.presenceClient.recordActivity();
+                    console.log('[ActivityTracker] Activity recorded at', new Date().toISOString());
+                }
+                catch (error) {
+                    console.error('[ActivityTracker] Failed to record activity:', error);
+                }
+            }, this.debounceMs);
+        };
+        /**
+         * Handle high-significance activity (keyboard, clicks)
+         * Updates local timestamp immediately, throttles server sync
+         * @private
+         */
+        this.handleHighSignificanceActivity = () => {
+            // ALWAYS update local timestamp immediately (for idle detection)
+            this.lastActivityTime = Date.now();
+            // Throttle server sync
+            this.throttleServerSync(this.highSignificanceThrottleMs);
+        };
+        /**
+         * Handle low-significance activity (mouse movement, scroll)
+         * Updates local timestamp immediately, throttles server sync with longer delay
+         * @private
+         */
+        this.handleLowSignificanceActivity = () => {
+            // ALWAYS update local timestamp immediately (for idle detection)
+            this.lastActivityTime = Date.now();
+            // Throttle server sync with longer delay
+            this.throttleServerSync(this.lowSignificanceThrottleMs);
+        };
+        // Auto-detect platform if not specified
+        if (!platform) {
+            this.platform = this.detectPlatform();
+        }
+    }
+    /**
+     * Auto-detect the current platform
+     * @private
+     */
+    detectPlatform() {
+        // Check for React Native
+        if (typeof navigator !== 'undefined' && navigator.product === 'ReactNative') {
+            return 'react-native';
+        }
+        // Check for browser environment
+        if (typeof window !== 'undefined' && typeof document !== 'undefined') {
+            return 'web';
+        }
+        // Default to Node.js
+        return 'node';
+    }
+    /**
+     * Start activity tracking
+     * Begins listening to platform-specific activity events
+     */
+    start() {
+        if (this.isActive) {
+            console.warn('[ActivityTracker] Already tracking');
+            return;
+        }
+        console.log(`[ActivityTracker] Starting on platform: ${this.platform}`);
+        if (this.platform === 'web') {
+            this.startWebTracking();
+        }
+        else if (this.platform === 'react-native') {
+            this.startReactNativeTracking();
+        }
+        // Node.js doesn't need activity tracking (server-side)
+        this.isActive = true;
+    }
+    /**
+     * Stop activity tracking
+     * Removes all event listeners and clears pending timers
+     */
+    stop() {
+        if (!this.isActive) {
+            return;
+        }
+        console.log('[ActivityTracker] Stopping');
+        if (this.platform === 'web') {
+            this.stopWebTracking();
+        }
+        else if (this.platform === 'react-native') {
+            this.stopReactNativeTracking();
+        }
+        // Clear any pending timers
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+        if (this.throttleTimer) {
+            clearTimeout(this.throttleTimer);
+            this.throttleTimer = null;
+        }
+        this.isActive = false;
+    }
+    /**
+     * Throttle server synchronization
+     * Ensures we send updates at most once per interval
+     * @private
+     */
+    throttleServerSync(throttleMs) {
+        const now = Date.now();
+        const timeSinceLastSync = now - this.lastServerSyncTime;
+        // If enough time has passed, sync immediately
+        if (timeSinceLastSync >= throttleMs) {
+            this.syncActivityToServer();
+            return;
+        }
+        // Otherwise, schedule a sync for the remaining time
+        if (!this.throttleTimer) {
+            const remainingTime = throttleMs - timeSinceLastSync;
+            this.throttleTimer = setTimeout(() => {
+                this.syncActivityToServer();
+            }, remainingTime);
+        }
+    }
+    /**
+     * Send activity to server
+     * @private
+     */
+    async syncActivityToServer() {
+        this.lastServerSyncTime = Date.now();
+        this.throttleTimer = null;
+        try {
+            await this.presenceClient.recordActivity();
+            console.log('[ActivityTracker] Activity synced to server at', new Date().toISOString());
+        }
+        catch (error) {
+            console.error('[ActivityTracker] Failed to sync activity to server:', error);
+        }
+    }
+    /**
+     * Start web platform tracking
+     * Listens to high-significance (keyboard, clicks) and low-significance (mouse, scroll) events
+     * @private
+     */
+    startWebTracking() {
+        if (typeof window === 'undefined') {
+            console.warn('[ActivityTracker] Web platform not available');
+            return;
+        }
+        console.log('[ActivityTracker] Starting web event listeners');
+        // High-significance events (definite user activity)
+        window.addEventListener('keydown', this.handleHighSignificanceActivity);
+        window.addEventListener('keypress', this.handleHighSignificanceActivity);
+        window.addEventListener('mousedown', this.handleHighSignificanceActivity);
+        window.addEventListener('click', this.handleHighSignificanceActivity);
+        window.addEventListener('touchstart', this.handleHighSignificanceActivity);
+        // Low-significance events (potential idle movement)
+        window.addEventListener('mousemove', this.handleLowSignificanceActivity);
+        window.addEventListener('scroll', this.handleLowSignificanceActivity);
+    }
+    /**
+     * Stop web platform tracking
+     * Removes all web event listeners
+     * @private
+     */
+    stopWebTracking() {
+        if (typeof window === 'undefined')
+            return;
+        console.log('[ActivityTracker] Removing web event listeners');
+        // High-significance events
+        window.removeEventListener('keydown', this.handleHighSignificanceActivity);
+        window.removeEventListener('keypress', this.handleHighSignificanceActivity);
+        window.removeEventListener('mousedown', this.handleHighSignificanceActivity);
+        window.removeEventListener('click', this.handleHighSignificanceActivity);
+        window.removeEventListener('touchstart', this.handleHighSignificanceActivity);
+        // Low-significance events
+        window.removeEventListener('mousemove', this.handleLowSignificanceActivity);
+        window.removeEventListener('scroll', this.handleLowSignificanceActivity);
+    }
+    /**
+     * Start React Native platform tracking
+     * Uses AppState to detect app activity
+     * @private
+     */
+    startReactNativeTracking() {
+        try {
+            // Dynamically import AppState for React Native
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const { AppState } = require('react-native');
+            this.activityHandler = AppState.addEventListener('change', (nextAppState) => {
+                if (nextAppState === 'active') {
+                    this.handleActivity();
+                }
+            });
+            console.log('[ActivityTracker] Started React Native AppState tracking');
+        }
+        catch (error) {
+            console.warn('[ActivityTracker] React Native AppState not available:', error);
+        }
+    }
+    /**
+     * Stop React Native platform tracking
+     * Removes AppState listener
+     * @private
+     */
+    stopReactNativeTracking() {
+        if (this.activityHandler) {
+            try {
+                // Remove the subscription
+                if (typeof this.activityHandler === 'function') {
+                    // In newer React Native versions, addEventListener returns a remove function
+                    this.activityHandler();
+                }
+                else if ('remove' in this.activityHandler) {
+                    // Older versions have a remove method
+                    this.activityHandler.remove();
+                }
+                this.activityHandler = null;
+                console.log('[ActivityTracker] Stopped React Native tracking');
+            }
+            catch (error) {
+                console.warn('[ActivityTracker] Failed to stop React Native tracking:', error);
+            }
+        }
+    }
+    /**
+     * Get the timestamp of the last detected activity
+     * @returns Timestamp in milliseconds
+     */
+    getLastActivityTime() {
+        return this.lastActivityTime;
+    }
+    /**
+     * Manually trigger activity recording
+     * Bypasses debounce and sends immediately
+     */
+    async triggerActivity() {
+        try {
+            await this.presenceClient.recordActivity();
+            this.lastActivityTime = Date.now();
+            console.log('[ActivityTracker] Activity triggered manually');
+        }
+        catch (error) {
+            console.error('[ActivityTracker] Failed to trigger activity:', error);
+            throw error;
+        }
+    }
+    /**
+     * Update the debounce delay
+     * @param ms - New debounce delay in milliseconds
+     */
+    setDebounce(ms) {
+        if (ms < 1000) {
+            console.warn('[ActivityTracker] Debounce too short, using minimum 1000ms');
+            ms = 1000;
+        }
+        this.debounceMs = ms;
+        console.log(`[ActivityTracker] Debounce updated to ${ms}ms`);
+    }
+    /**
+     * Get current debounce setting
+     * @returns Debounce delay in milliseconds
+     */
+    getDebounce() {
+        return this.debounceMs;
+    }
+    /**
+     * Check if activity tracking is currently active
+     * @returns True if tracking, false otherwise
+     */
+    isTracking() {
+        return this.isActive;
+    }
+    /**
+     * Get the current platform
+     * @returns Platform type
+     */
+    getPlatform() {
+        return this.platform;
+    }
+    /**
+     * Update high-significance throttle delay
+     * @param ms - New throttle delay in milliseconds
+     */
+    setHighSignificanceThrottle(ms) {
+        if (ms < 500) {
+            console.warn('[ActivityTracker] High-significance throttle too short, using minimum 500ms');
+            ms = 500;
+        }
+        this.highSignificanceThrottleMs = ms;
+        console.log(`[ActivityTracker] High-significance throttle updated to ${ms}ms`);
+    }
+    /**
+     * Update low-significance throttle delay
+     * @param ms - New throttle delay in milliseconds
+     */
+    setLowSignificanceThrottle(ms) {
+        if (ms < 1000) {
+            console.warn('[ActivityTracker] Low-significance throttle too short, using minimum 1000ms');
+            ms = 1000;
+        }
+        this.lowSignificanceThrottleMs = ms;
+        console.log(`[ActivityTracker] Low-significance throttle updated to ${ms}ms`);
+    }
+}
+//# sourceMappingURL=ActivityTracker.js.map

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

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

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

@@ -0,0 +1,68 @@
+/**
+ * AutoHeartbeatManager
+ * Manages automatic periodic heartbeat to keep presence fresh
+ * Matches the test app's auto-heartbeat implementation
+ */
+import { PresenceClient } from './PresenceClient';
+export declare class AutoHeartbeatManager {
+    private presenceClient;
+    private intervalSeconds;
+    private intervalId;
+    private lastHeartbeat;
+    private isRunning;
+    private stateChangeUnsubscribe;
+    private wasPausedDueToDisconnect;
+    /**
+     * Create AutoHeartbeatManager
+     * @param presenceClient - PresenceClient instance
+     * @param intervalSeconds - Heartbeat interval in seconds (default: 30)
+     */
+    constructor(presenceClient: PresenceClient, intervalSeconds?: number);
+    /**
+     * Start automatic heartbeat
+     * Sends heartbeat immediately and then every intervalSeconds
+     */
+    start(): void;
+    /**
+     * Stop automatic heartbeat
+     */
+    stop(): void;
+    /**
+     * Send a single heartbeat
+     * @private
+     */
+    private sendHeartbeat;
+    /**
+     * Get the timestamp of the last successful heartbeat
+     * @returns Last heartbeat date or null if never sent
+     */
+    getLastHeartbeat(): Date | null;
+    /**
+     * Update the heartbeat interval
+     * If currently running, restarts with new interval
+     * @param seconds - New interval in seconds
+     */
+    setInterval(seconds: number): void;
+    /**
+     * Get current interval setting
+     * @returns Interval in seconds
+     */
+    getInterval(): number;
+    /**
+     * Check if heartbeat is currently running
+     * @returns True if running, false otherwise
+     */
+    isActive(): boolean;
+    /**
+     * Handle connection state changes
+     * Pauses heartbeat when disconnected/reconnecting, resumes when connected
+     * @private
+     */
+    private handleConnectionStateChange;
+    /**
+     * Cleanup and destroy the heartbeat manager
+     * Stops heartbeat and unsubscribes from connection state changes
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=AutoHeartbeatManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AutoHeartbeatManager.d.ts","sourceRoot":"","sources":["../../../src/realtime/presence/AutoHeartbeatManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,qBAAa,oBAAoB;IAa7B,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,eAAe;IAbzB,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,sBAAsB,CAAmC;IACjE,OAAO,CAAC,wBAAwB,CAAkB;IAElD;;;;OAIG;gBAEO,cAAc,EAAE,cAAc,EAC9B,eAAe,GAAE,MAAW;IAQtC;;;OAGG;IACH,KAAK,IAAI,IAAI;IAmBb;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;;OAGG;YACW,aAAa;IAgB3B;;;OAGG;IACH,gBAAgB,IAAI,IAAI,GAAG,IAAI;IAI/B;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAoBlC;;;OAGG;IACH,WAAW,IAAI,MAAM;IAIrB;;;OAGG;IACH,QAAQ,IAAI,OAAO;IAInB;;;;OAIG;IACH,OAAO,CAAC,2BAA2B;IA0BnC;;;OAGG;IACH,OAAO,IAAI,IAAI;CAOhB"}

package/dist/realtime/presence/AutoHeartbeatManager.js

@@ -0,0 +1,160 @@
+/**
+ * AutoHeartbeatManager
+ * Manages automatic periodic heartbeat to keep presence fresh
+ * Matches the test app's auto-heartbeat implementation
+ */
+import { ConnectionState } from '../shared/types';
+export class AutoHeartbeatManager {
+    /**
+     * Create AutoHeartbeatManager
+     * @param presenceClient - PresenceClient instance
+     * @param intervalSeconds - Heartbeat interval in seconds (default: 30)
+     */
+    constructor(presenceClient, intervalSeconds = 30) {
+        this.presenceClient = presenceClient;
+        this.intervalSeconds = intervalSeconds;
+        this.intervalId = null;
+        this.lastHeartbeat = null;
+        this.isRunning = false;
+        this.stateChangeUnsubscribe = null;
+        this.wasPausedDueToDisconnect = false;
+        // Listen for connection state changes
+        this.stateChangeUnsubscribe = this.presenceClient.onStateChange((state) => {
+            this.handleConnectionStateChange(state);
+        });
+    }
+    /**
+     * Start automatic heartbeat
+     * Sends heartbeat immediately and then every intervalSeconds
+     */
+    start() {
+        if (this.isRunning) {
+            console.warn('[AutoHeartbeat] Already running');
+            return;
+        }
+        console.log(`[AutoHeartbeat] Starting with ${this.intervalSeconds}s interval`);
+        // Send initial heartbeat immediately
+        this.sendHeartbeat();
+        // Setup interval for subsequent heartbeats
+        this.intervalId = setInterval(() => {
+            this.sendHeartbeat();
+        }, this.intervalSeconds * 1000);
+        this.isRunning = true;
+    }
+    /**
+     * Stop automatic heartbeat
+     */
+    stop() {
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+        this.isRunning = false;
+        console.log('[AutoHeartbeat] Stopped');
+    }
+    /**
+     * Send a single heartbeat
+     * @private
+     */
+    async sendHeartbeat() {
+        try {
+            // Check if connected before invoking hub method
+            if (!this.presenceClient.isConnected()) {
+                console.warn('[AutoHeartbeat] Not connected, skipping heartbeat');
+                return;
+            }
+            await this.presenceClient.heartbeat();
+            this.lastHeartbeat = new Date();
+            console.log('[AutoHeartbeat] Heartbeat sent successfully at', this.lastHeartbeat.toISOString());
+        }
+        catch (error) {
+            console.error('[AutoHeartbeat] Failed to send heartbeat:', error);
+        }
+    }
+    /**
+     * Get the timestamp of the last successful heartbeat
+     * @returns Last heartbeat date or null if never sent
+     */
+    getLastHeartbeat() {
+        return this.lastHeartbeat;
+    }
+    /**
+     * Update the heartbeat interval
+     * If currently running, restarts with new interval
+     * @param seconds - New interval in seconds
+     */
+    setInterval(seconds) {
+        if (seconds < 10) {
+            console.warn('[AutoHeartbeat] Interval too short, using minimum 10 seconds');
+            seconds = 10;
+        }
+        if (seconds > 300) {
+            console.warn('[AutoHeartbeat] Interval too long, using maximum 300 seconds');
+            seconds = 300;
+        }
+        this.intervalSeconds = seconds;
+        // If running, restart with new interval
+        if (this.isRunning) {
+            console.log(`[AutoHeartbeat] Updating interval to ${seconds}s`);
+            this.stop();
+            this.start();
+        }
+    }
+    /**
+     * Get current interval setting
+     * @returns Interval in seconds
+     */
+    getInterval() {
+        return this.intervalSeconds;
+    }
+    /**
+     * Check if heartbeat is currently running
+     * @returns True if running, false otherwise
+     */
+    isActive() {
+        return this.isRunning;
+    }
+    /**
+     * Handle connection state changes
+     * Pauses heartbeat when disconnected/reconnecting, resumes when connected
+     * @private
+     */
+    handleConnectionStateChange(state) {
+        if (state === ConnectionState.Disconnected || state === ConnectionState.Reconnecting) {
+            // Pause if running
+            if (this.isRunning) {
+                console.log(`[AutoHeartbeat] Pausing due to connection state: ${state}`);
+                if (this.intervalId) {
+                    clearInterval(this.intervalId);
+                    this.intervalId = null;
+                }
+                this.wasPausedDueToDisconnect = true;
+            }
+        }
+        else if (state === ConnectionState.Connected) {
+            // Resume if was paused due to disconnect
+            if (this.wasPausedDueToDisconnect && this.isRunning) {
+                console.log('[AutoHeartbeat] Resuming after reconnection');
+                // Send immediate heartbeat on reconnect
+                this.sendHeartbeat();
+                // Restart interval
+                this.intervalId = setInterval(() => {
+                    this.sendHeartbeat();
+                }, this.intervalSeconds * 1000);
+                this.wasPausedDueToDisconnect = false;
+            }
+        }
+    }
+    /**
+     * Cleanup and destroy the heartbeat manager
+     * Stops heartbeat and unsubscribes from connection state changes
+     */
+    destroy() {
+        this.stop();
+        if (this.stateChangeUnsubscribe) {
+            this.stateChangeUnsubscribe();
+            this.stateChangeUnsubscribe = null;
+        }
+    }
+}
+//# sourceMappingURL=AutoHeartbeatManager.js.map

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

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