@principal-ai/control-tower-core 0.1.11 → 0.1.13

package/dist/client/PresenceClient.js

@@ -0,0 +1,193 @@
+"use strict";
+/**
+ * Presence Client Helper
+ *
+ * Simplifies client-side presence integration for web/Electron applications.
+ * Automatically handles connection, authentication, and presence event forwarding.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PresenceClient = void 0;
+const BaseClient_js_1 = require("./BaseClient.js");
+const EventEmitter_js_1 = require("../abstractions/EventEmitter.js");
+/**
+ * High-level presence client for easy integration
+ *
+ * Example:
+ * ```typescript
+ * import { PresenceClient } from '@principal-ai/control-tower-core';
+ * import { WebSocketClientTransportAdapter } from '@principal-ai/control-tower-core';
+ * import { ClientBuilder } from '@principal-ai/control-tower-core';
+ *
+ * const transport = new WebSocketClientTransportAdapter();
+ *
+ * const client = new ClientBuilder()
+ *   .withTransport(transport)
+ *   .build();
+ *
+ * const presence = new PresenceClient({
+ *   clientConfig: client,
+ *   wsUrl: 'ws://localhost:3000/ws',
+ *   autoConnect: true,
+ *   autoReconnect: true
+ * });
+ *
+ * presence.on('userOnline', (data) => {
+ *   console.log(`${data.userId} came online`);
+ * });
+ *
+ * presence.on('userOffline', (data) => {
+ *   console.log(`${data.userId} went offline`);
+ * });
+ * ```
+ */
+class PresenceClient extends EventEmitter_js_1.TypedEventEmitter {
+    constructor(config) {
+        super();
+        this.wsUrl = config.wsUrl;
+        this.autoReconnectEnabled = config.autoReconnect ?? true;
+        this.globalRoomId = config.globalRoomId ?? '__global_presence__';
+        // Create base client
+        this.client = new BaseClient_js_1.BaseClient(config.clientConfig);
+        this.setupEventForwarding();
+        if (config.autoConnect) {
+            void this.connect();
+        }
+    }
+    /**
+     * Connect to the presence system
+     */
+    async connect() {
+        try {
+            // Connect base client
+            await this.client.connect(this.wsUrl);
+            // Join global presence room
+            await this.client.joinRoom(this.globalRoomId);
+            await this.emit('connected', {});
+        }
+        catch (error) {
+            await this.emit('error', { error: error });
+            throw error;
+        }
+    }
+    /**
+     * Disconnect from the presence system
+     */
+    async disconnect() {
+        // Disable auto-reconnect
+        this.autoReconnectEnabled = false;
+        // Clear any pending reconnect
+        if (this.reconnectTimeout) {
+            clearTimeout(this.reconnectTimeout);
+            this.reconnectTimeout = undefined;
+        }
+        try {
+            // Leave global presence room
+            await this.client.leaveRoom();
+            // Disconnect
+            await this.client.disconnect();
+            await this.emit('disconnected', {});
+        }
+        catch (error) {
+            await this.emit('error', { error: error });
+        }
+    }
+    /**
+     * Get all online users
+     *
+     * Note: This requires a corresponding API endpoint on your server.
+     */
+    async getOnlineUsers() {
+        // This assumes you have a REST API endpoint for fetching online users
+        // You can customize this based on your server implementation
+        throw new Error('getOnlineUsers() requires a REST API endpoint. ' +
+            'Implement this method based on your server API.');
+    }
+    /**
+     * Set user status
+     *
+     * Note: This requires a corresponding API endpoint on your server.
+     */
+    async setStatus(status, message) {
+        // This assumes you have a REST API endpoint for setting status
+        // You can customize this based on your server implementation
+        throw new Error('setStatus() requires a REST API endpoint. ' +
+            'Implement this method based on your server API.');
+    }
+    /**
+     * Set visibility
+     *
+     * Note: This requires a corresponding API endpoint on your server.
+     */
+    async setVisibility(visible) {
+        // This assumes you have a REST API endpoint for setting visibility
+        // You can customize this based on your server implementation
+        throw new Error('setVisibility() requires a REST API endpoint. ' +
+            'Implement this method based on your server API.');
+    }
+    /**
+     * Get the underlying BaseClient
+     */
+    getClient() {
+        return this.client;
+    }
+    /**
+     * Check if connected
+     */
+    isConnected() {
+        // BaseClient doesn't expose getState(), so we check internal state via a workaround
+        // In practice, you can track connection state via events
+        return this.client.connectionState === 'connected';
+    }
+    /**
+     * Set up event forwarding from BaseClient
+     * @private
+     */
+    setupEventForwarding() {
+        // Forward presence events with simplified API
+        this.client.on('presence:user_online', (data) => {
+            if (data && typeof data === 'object') {
+                const payload = data;
+                void this.emit('userOnline', {
+                    userId: payload.userId,
+                    devices: payload.devices || []
+                });
+            }
+        });
+        this.client.on('presence:user_offline', (data) => {
+            if (data && typeof data === 'object') {
+                const payload = data;
+                void this.emit('userOffline', { userId: payload.userId });
+            }
+        });
+        this.client.on('presence:status_changed', (data) => {
+            if (data && typeof data === 'object') {
+                const payload = data;
+                void this.emit('statusChanged', {
+                    userId: payload.userId,
+                    status: payload.status,
+                    statusMessage: payload.statusMessage
+                });
+            }
+        });
+        // Handle disconnection
+        this.client.on('disconnected', () => {
+            void this.emit('disconnected', {});
+            // Auto-reconnect if enabled
+            if (this.autoReconnectEnabled) {
+                this.reconnectTimeout = setTimeout(() => {
+                    void this.connect().catch((error) => {
+                        void this.emit('error', { error: error });
+                    });
+                }, 5000);
+            }
+        });
+        // Forward errors
+        this.client.on('error', (data) => {
+            if (data && typeof data === 'object' && 'error' in data) {
+                const payload = data;
+                void this.emit('error', { error: payload.error });
+            }
+        });
+    }
+}
+exports.PresenceClient = PresenceClient;

package/dist/client/index.d.ts

@@ -1,3 +1,4 @@
 export { BaseClient, type ClientConfig, type ClientEvents } from './BaseClient.js';
 export { ClientBuilder } from './ClientBuilder.js';
+export { PresenceClient, type PresenceClientConfig, type PresenceClientEvents } from './PresenceClient.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC"}

package/dist/client/index.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ClientBuilder = exports.BaseClient = void 0;
+exports.PresenceClient = exports.ClientBuilder = exports.BaseClient = void 0;
 // Client-side implementations
 var BaseClient_js_1 = require("./BaseClient.js");
 Object.defineProperty(exports, "BaseClient", { enumerable: true, get: function () { return BaseClient_js_1.BaseClient; } });
 var ClientBuilder_js_1 = require("./ClientBuilder.js");
 Object.defineProperty(exports, "ClientBuilder", { enumerable: true, get: function () { return ClientBuilder_js_1.ClientBuilder; } });
+var PresenceClient_js_1 = require("./PresenceClient.js");
+Object.defineProperty(exports, "PresenceClient", { enumerable: true, get: function () { return PresenceClient_js_1.PresenceClient; } });

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { EventType, BaseEvent, FileAction, FileChangeEvent, GitStatusEvent, CommitEvent, BranchChangeEvent, CursorPositionEvent, Event, TokenPayload, AuthResult, CredentialType, OAuthProvider, Credentials, JWTConfig, OAuthConfig, AuthProvider, RoomPermission, Room, RoomUser, UserStatus, RoomState, RoomConfig, LockType, LockPriority, Lock, LockRequest, LockQueueItem, LockState, ConnectionState, ConnectionOptions, Message, MessageHandler, ErrorHandler, CloseHandler, ExperimentalFeatureConfig, ClientPredicate, BroadcastResult, BroadcastOptions, ExperimentalUsageEvent, ExperimentalFeatureError, PresenceStatus, DeviceInfo, UserPresence, PresenceConfig, PresenceChangeEvent, ActivityUpdate } from './types/index.js';
-export { ITransportAdapter, IStorageAdapter, StorageOperation, IAuthAdapter, TypedEventEmitter, EventListener, UnsubscribeFn, RoomManager, LockManager, DefaultRoomManager, DefaultLockManager, PresenceManager, DefaultPresenceManager } from './abstractions/index.js';
+export { ITransportAdapter, IStorageAdapter, StorageOperation, IAuthAdapter, TypedEventEmitter, EventListener, UnsubscribeFn, RoomManager, LockManager, DefaultRoomManager, DefaultLockManager, PresenceManager, DefaultPresenceManager, PresenceExtension, ExtendedUserPresence } from './abstractions/index.js';
 export { MockTransportAdapter, MockStorageAdapter, MockAuthAdapter } from './adapters/mock/index.js';
 export { WebSocketServerTransportAdapter, type WebSocketServerTransportConfig, WebSocketClientTransportAdapter, type WebSocketClientConfig } from './adapters/websocket/index.js';
-export { BaseClient, ClientBuilder, type ClientConfig, type ClientEvents } from './client/index.js';
+export { BaseClient, ClientBuilder, type ClientConfig, type ClientEvents, PresenceClient, type PresenceClientConfig, type PresenceClientEvents } from './client/index.js';
 export { BaseServer, ServerBuilder, ExperimentalAPI, type ServerConfig, type ServerEvents, type ConnectedClient } from './server/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,SAAS,EACT,SAAS,EACT,UAAU,EACV,eAAe,EACf,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,EAEL,YAAY,EACZ,UAAU,EACV,cAAc,EACd,aAAa,EACb,WAAW,EACX,SAAS,EACT,WAAW,EACX,YAAY,EAEZ,cAAc,EACd,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,SAAS,EACT,UAAU,EAEV,QAAQ,EACR,YAAY,EACZ,IAAI,EACJ,WAAW,EACX,aAAa,EACb,SAAS,EAET,eAAe,EACf,iBAAiB,EACjB,OAAO,EACP,cAAc,EACd,YAAY,EACZ,YAAY,EAEZ,yBAAyB,EACzB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,wBAAwB,EAExB,cAAc,EACd,UAAU,EACV,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,cAAc,EACf,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACvB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,+BAA+B,EAC/B,KAAK,8BAA8B,EACnC,+BAA+B,EAC/B,KAAK,qBAAqB,EAC3B,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,UAAU,EACV,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,UAAU,EACV,aAAa,EACb,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,SAAS,EACT,SAAS,EACT,UAAU,EACV,eAAe,EACf,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,EAEL,YAAY,EACZ,UAAU,EACV,cAAc,EACd,aAAa,EACb,WAAW,EACX,SAAS,EACT,WAAW,EACX,YAAY,EAEZ,cAAc,EACd,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,SAAS,EACT,UAAU,EAEV,QAAQ,EACR,YAAY,EACZ,IAAI,EACJ,WAAW,EACX,aAAa,EACb,SAAS,EAET,eAAe,EACf,iBAAiB,EACjB,OAAO,EACP,cAAc,EACd,YAAY,EACZ,YAAY,EAEZ,yBAAyB,EACzB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,wBAAwB,EAExB,cAAc,EACd,UAAU,EACV,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,cAAc,EACf,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,+BAA+B,EAC/B,KAAK,8BAA8B,EACnC,+BAA+B,EAC/B,KAAK,qBAAqB,EAC3B,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,UAAU,EACV,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,UAAU,EACV,aAAa,EACb,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExperimentalAPI = exports.ServerBuilder = exports.BaseServer = exports.ClientBuilder = exports.BaseClient = exports.WebSocketClientTransportAdapter = exports.WebSocketServerTransportAdapter = exports.MockAuthAdapter = exports.MockStorageAdapter = exports.MockTransportAdapter = exports.DefaultPresenceManager = exports.PresenceManager = exports.DefaultLockManager = exports.DefaultRoomManager = exports.LockManager = exports.RoomManager = exports.TypedEventEmitter = exports.ExperimentalFeatureError = void 0;
+exports.ExperimentalAPI = exports.ServerBuilder = exports.BaseServer = exports.PresenceClient = exports.ClientBuilder = exports.BaseClient = exports.WebSocketClientTransportAdapter = exports.WebSocketServerTransportAdapter = exports.MockAuthAdapter = exports.MockStorageAdapter = exports.MockTransportAdapter = exports.DefaultPresenceManager = exports.PresenceManager = exports.DefaultLockManager = exports.DefaultRoomManager = exports.LockManager = exports.RoomManager = exports.TypedEventEmitter = exports.ExperimentalFeatureError = void 0;
 // Types
 var index_js_1 = require("./types/index.js");
 Object.defineProperty(exports, "ExperimentalFeatureError", { enumerable: true, get: function () { return index_js_1.ExperimentalFeatureError; } });
@@ -25,6 +25,7 @@ Object.defineProperty(exports, "WebSocketClientTransportAdapter", { enumerable:
 var index_js_5 = require("./client/index.js");
 Object.defineProperty(exports, "BaseClient", { enumerable: true, get: function () { return index_js_5.BaseClient; } });
 Object.defineProperty(exports, "ClientBuilder", { enumerable: true, get: function () { return index_js_5.ClientBuilder; } });
+Object.defineProperty(exports, "PresenceClient", { enumerable: true, get: function () { return index_js_5.PresenceClient; } });
 // Server
 var index_js_6 = require("./server/index.js");
 Object.defineProperty(exports, "BaseServer", { enumerable: true, get: function () { return index_js_6.BaseServer; } });