@principal-ai/control-tower-core 0.1.7 → 0.1.9

package/dist/types/presence.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Presence System Types
+ *
+ * Types for tracking global user presence independent of room membership.
+ * Supports multi-device connections and activity monitoring.
+ */
+export type PresenceStatus = 'online' | 'away' | 'offline';
+/**
+ * Device information for a connected client
+ */
+export interface DeviceInfo {
+    /**
+     * Unique device identifier (client ID)
+     */
+    deviceId: string;
+    /**
+     * Device type (desktop, mobile, web, etc.)
+     */
+    type?: string;
+    /**
+     * When this device connected
+     */
+    connectedAt: number;
+    /**
+     * Last activity timestamp for this device
+     */
+    lastActivity: number;
+    /**
+     * Device metadata (browser, OS, etc.)
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * User presence state
+ *
+ * Tracks a user's global presence across all their connected devices
+ */
+export interface UserPresence {
+    /**
+     * User ID
+     */
+    userId: string;
+    /**
+     * Overall presence status
+     * - online: At least one device is active
+     * - away: All devices are idle
+     * - offline: No devices connected (grace period may apply)
+     */
+    status: PresenceStatus;
+    /**
+     * All devices connected for this user
+     */
+    devices: Map<string, DeviceInfo>;
+    /**
+     * When the user first connected (earliest device connection)
+     */
+    firstConnectedAt: number;
+    /**
+     * Last activity across all devices
+     */
+    lastActivity: number;
+    /**
+     * User metadata
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Configuration for presence tracking
+ */
+export interface PresenceConfig {
+    /**
+     * Enable global presence tracking
+     * @default false
+     */
+    enabled?: boolean;
+    /**
+     * Heartbeat interval in milliseconds
+     * How often clients should send heartbeats
+     * @default 30000 (30 seconds)
+     */
+    heartbeatInterval?: number;
+    /**
+     * Number of missed heartbeats before marking as away
+     * @default 2
+     */
+    awayThreshold?: number;
+    /**
+     * Number of missed heartbeats before disconnecting
+     * @default 3
+     */
+    disconnectThreshold?: number;
+    /**
+     * Grace period in milliseconds after disconnect
+     * Allows seamless reconnection without losing state
+     * @default 30000 (30 seconds)
+     */
+    gracePeriod?: number;
+    /**
+     * Track device-level activity
+     * @default true
+     */
+    trackDeviceActivity?: boolean;
+    /**
+     * Broadcast presence updates to authenticated clients
+     * @default true
+     */
+    broadcastPresenceUpdates?: boolean;
+}
+/**
+ * Presence change event
+ */
+export interface PresenceChangeEvent {
+    /**
+     * User whose presence changed
+     */
+    userId: string;
+    /**
+     * Previous status
+     */
+    previousStatus: PresenceStatus;
+    /**
+     * New status
+     */
+    status: PresenceStatus;
+    /**
+     * Timestamp of the change
+     */
+    timestamp: number;
+    /**
+     * Device that triggered the change (if applicable)
+     */
+    deviceId?: string;
+    /**
+     * Reason for the change
+     */
+    reason?: 'connected' | 'disconnected' | 'activity' | 'heartbeat_timeout' | 'grace_period_expired';
+}
+/**
+ * Activity update from a client
+ */
+export interface ActivityUpdate {
+    /**
+     * User ID
+     */
+    userId: string;
+    /**
+     * Device ID (client ID)
+     */
+    deviceId: string;
+    /**
+     * Timestamp of the activity
+     */
+    timestamp: number;
+    /**
+     * Type of activity (optional)
+     */
+    activityType?: 'heartbeat' | 'message' | 'user_action';
+    /**
+     * Additional metadata
+     */
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=presence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../src/types/presence.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;;;OAKG;IACH,MAAM,EAAE,cAAc,CAAC;IAEvB;;OAEG;IACH,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAEjC;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;OAGG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,cAAc,EAAE,cAAc,CAAC;IAE/B;;OAEG;IACH,MAAM,EAAE,cAAc,CAAC;IAEvB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,GAAG,cAAc,GAAG,UAAU,GAAG,mBAAmB,GAAG,sBAAsB,CAAC;CACnG;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,YAAY,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,aAAa,CAAC;IAEvD;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/types/presence.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Presence System Types
+ *
+ * Types for tracking global user presence independent of room membership.
+ * Supports multi-device connections and activity monitoring.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@principal-ai/control-tower-core",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Centralized, runtime-agnostic library for real-time collaboration and synchronization",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",