@principal-ai/control-tower-core 0.1.4 → 0.1.5

package/dist/abstractions/AuthAdapter.d.ts

@@ -1,9 +1,12 @@
-import type { TokenPayload, AuthResult, Credentials } from '../types';
+import type { TokenPayload, AuthResult, Credentials, CredentialType } from '../types';
 export interface IAuthAdapter {
-    validateToken(token: string): Promise<TokenPayload>;
-    generateToken(payload: TokenPayload): Promise<string>;
-    refreshToken(token: string): Promise<string>;
-    revokeToken(token: string): Promise<void>;
     authenticate(credentials: Credentials): Promise<AuthResult>;
+    validateToken(token: string): Promise<TokenPayload>;
+    generateToken?(payload: TokenPayload): Promise<string>;
+    refreshToken?(token: string): Promise<string>;
+    revokeToken?(token: string): Promise<void>;
+    isAuthRequired?(): boolean;
+    getAuthTimeout?(): number;
+    getSupportedCredentialTypes?(): CredentialType[];
 }
 //# sourceMappingURL=AuthAdapter.d.ts.map

package/dist/abstractions/AuthAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AuthAdapter.d.ts","sourceRoot":"","sources":["../../src/abstractions/AuthAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACZ,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,YAAY;IAC3B,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACpD,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,YAAY,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC7D"}
+{"version":3,"file":"AuthAdapter.d.ts","sourceRoot":"","sources":["../../src/abstractions/AuthAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,cAAc,EACf,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,YAAY;IAE3B,YAAY,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAG5D,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACpD,aAAa,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,YAAY,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,WAAW,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAG3C,cAAc,CAAC,IAAI,OAAO,CAAC;IAC3B,cAAc,CAAC,IAAI,MAAM,CAAC;IAC1B,2BAA2B,CAAC,IAAI,cAAc,EAAE,CAAC;CAClD"}

package/dist/abstractions/TransportAdapter.d.ts

@@ -1,4 +1,7 @@
 import type { ConnectionState, ConnectionOptions, Message, MessageHandler, ErrorHandler, CloseHandler } from '../types';
+import type { Server as HttpServer } from 'http';
+import type { Server as HttpsServer } from 'https';
+import type { WebSocketServer } from 'ws';
 export interface ITransportAdapter {
     connect(url: string, options?: ConnectionOptions): Promise<void>;
     disconnect(): Promise<void>;
@@ -8,5 +11,7 @@ export interface ITransportAdapter {
     onClose(handler: CloseHandler): void;
     getState(): ConnectionState;
     isConnected(): boolean;
+    attach?(server: HttpServer | HttpsServer, path?: string): Promise<void>;
+    attachToWebSocketServer?(wss: WebSocketServer): Promise<void>;
 }
 //# sourceMappingURL=TransportAdapter.d.ts.map

package/dist/abstractions/TransportAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TransportAdapter.d.ts","sourceRoot":"","sources":["../../src/abstractions/TransportAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,OAAO,EACP,cAAc,EACd,YAAY,EACZ,YAAY,EACb,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IACzC,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IACrC,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IACrC,QAAQ,IAAI,eAAe,CAAC;IAC5B,WAAW,IAAI,OAAO,CAAC;CACxB"}
+{"version":3,"file":"TransportAdapter.d.ts","sourceRoot":"","sources":["../../src/abstractions/TransportAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,OAAO,EACP,cAAc,EACd,YAAY,EACZ,YAAY,EACb,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,OAAO,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC;AAE1C,MAAM,WAAW,iBAAiB;IAEhC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IACzC,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IACrC,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IACrC,QAAQ,IAAI,eAAe,CAAC;IAC5B,WAAW,IAAI,OAAO,CAAC;IAGvB,MAAM,CAAC,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,uBAAuB,CAAC,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D"}

package/dist/adapters/mock/MockAuthAdapter.d.ts

@@ -1,5 +1,5 @@
 import type { IAuthAdapter } from '../../abstractions/AuthAdapter';
-import type { TokenPayload, AuthResult, Credentials } from '../../types';
+import type { TokenPayload, AuthResult, Credentials, CredentialType } from '../../types';
 export declare class MockAuthAdapter implements IAuthAdapter {
     private tokens;
     private revokedTokens;
@@ -16,6 +16,9 @@ export declare class MockAuthAdapter implements IAuthAdapter {
     refreshToken(token: string): Promise<string>;
     revokeToken(token: string): Promise<void>;
     authenticate(credentials: Credentials): Promise<AuthResult>;
+    isAuthRequired(): boolean;
+    getAuthTimeout(): number;
+    getSupportedCredentialTypes(): CredentialType[];
     private simulateDelay;
     addUser(username: string, password: string, payload: TokenPayload): void;
     removeUser(username: string): void;

package/dist/adapters/mock/MockAuthAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MockAuthAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/mock/MockAuthAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB,qBAAa,eAAgB,YAAW,YAAY;IAClD,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,KAAK,CAAuE;IACpF,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,YAAY,CAAa;gBAErB,OAAO,CAAC,EAAE;QACpB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B;IAoBK,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAyBnD,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBrD,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqB5C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzC,YAAY,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;YAuEnD,aAAa;IAM3B,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAIxE,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIlC,aAAa,IAAI,MAAM;IAIvB,oBAAoB,IAAI,MAAM;IAI9B,WAAW,IAAI,IAAI;IAKnB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;CAGjC"}
+{"version":3,"file":"MockAuthAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/mock/MockAuthAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,qBAAa,eAAgB,YAAW,YAAY;IAClD,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,KAAK,CAAuE;IACpF,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,YAAY,CAAa;gBAErB,OAAO,CAAC,EAAE;QACpB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B;IAoBK,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAyBnD,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBrD,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqB5C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzC,YAAY,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAwGjE,cAAc,IAAI,OAAO;IAIzB,cAAc,IAAI,MAAM;IAIxB,2BAA2B,IAAI,cAAc,EAAE;YAKjC,aAAa;IAM3B,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAIxE,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIlC,aAAa,IAAI,MAAM;IAIvB,oBAAoB,IAAI,MAAM;IAI9B,WAAW,IAAI,IAAI;IAKnB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;CAGjC"}

package/dist/adapters/mock/MockAuthAdapter.js

@@ -78,42 +78,71 @@ export class MockAuthAdapter {
     async authenticate(credentials) {
         await this.simulateDelay();
         if (this.shouldFailAuth) {
-            throw new Error('Mock authentication failed');
+            return {
+                success: false,
+                error: 'Mock authentication failed'
+            };
         }
         switch (credentials.type) {
             case 'password': {
                 if (!credentials.username || !credentials.password) {
-                    throw new Error('Username and password required');
+                    return {
+                        success: false,
+                        error: 'Username and password required'
+                    };
                 }
                 const user = this.users.get(credentials.username);
                 if (!user || user.password !== credentials.password) {
-                    throw new Error('Invalid credentials');
+                    return {
+                        success: false,
+                        error: 'Invalid credentials'
+                    };
                 }
                 const token = await this.generateToken(user.payload);
                 const refreshToken = `refresh-${token}`;
                 this.tokens.set(refreshToken, user.payload);
                 return {
+                    success: true,
                     token,
                     refreshToken,
                     user: user.payload,
+                    userId: user.payload.userId,
                     expiresIn: 3600
                 };
             }
-            case 'token': {
+            case 'token':
+            case 'jwt':
+            case 'bearer': {
                 if (!credentials.token) {
-                    throw new Error('Token required');
+                    return {
+                        success: false,
+                        error: 'Token required'
+                    };
+                }
+                try {
+                    const payload = await this.validateToken(credentials.token);
+                    return {
+                        success: true,
+                        token: credentials.token,
+                        user: payload,
+                        userId: payload.userId,
+                        expiresIn: 3600
+                    };
+                }
+                catch (error) {
+                    return {
+                        success: false,
+                        error: error.message
+                    };
                 }
-                const payload = await this.validateToken(credentials.token);
-                return {
-                    token: credentials.token,
-                    user: payload,
-                    expiresIn: 3600
-                };
             }
             case 'oauth': {
                 // Simulate OAuth flow
                 if (!credentials.code) {
-                    throw new Error('OAuth code required');
+                    return {
+                        success: false,
+                        error: 'OAuth code required'
+                    };
                 }
                 // Create a mock OAuth user
                 const payload = {
@@ -124,15 +153,30 @@ export class MockAuthAdapter {
                 };
                 const token = await this.generateToken(payload);
                 return {
+                    success: true,
                     token,
                     user: payload,
+                    userId: payload.userId,
                     expiresIn: 3600
                 };
             }
             default:
-                throw new Error('Unsupported credential type');
+                return {
+                    success: false,
+                    error: 'Unsupported credential type'
+                };
         }
     }
+    // New methods for enhanced auth interface
+    isAuthRequired() {
+        return false; // Mock adapter doesn't require auth by default
+    }
+    getAuthTimeout() {
+        return 10000; // 10 seconds for testing
+    }
+    getSupportedCredentialTypes() {
+        return ['password', 'token', 'jwt', 'bearer', 'oauth'];
+    }
     // Test helper methods
     async simulateDelay() {
         if (this.simulateLatency > 0) {

package/dist/adapters/websocket/WebSocketTransportAdapter.d.ts

@@ -0,0 +1,60 @@
+import type { ITransportAdapter } from '../../abstractions/TransportAdapter';
+import type { IAuthAdapter } from '../../abstractions/AuthAdapter';
+import type { ConnectionState, ConnectionOptions, Message, MessageHandler, ErrorHandler, CloseHandler } from '../../types';
+import type { Server as HttpServer } from 'http';
+import type { Server as HttpsServer } from 'https';
+import { WebSocketServer, WebSocket } from 'ws';
+interface ClientConnection {
+    id: string;
+    ws: WebSocket;
+    userId?: string;
+    authenticated: boolean;
+    metadata?: Record<string, unknown>;
+    authTimeout?: NodeJS.Timeout;
+    connectedAt: number;
+}
+export interface WebSocketTransportConfig {
+    authTimeout?: number;
+    closeOnAuthFailure?: boolean;
+    requireAuth?: boolean;
+}
+export declare class WebSocketTransportAdapter implements ITransportAdapter {
+    private state;
+    private messageHandlers;
+    private errorHandlers;
+    private closeHandlers;
+    private wss?;
+    private serverUrl?;
+    private attachedServer?;
+    private attachedWss?;
+    private webSocketPath?;
+    private clients;
+    private mode;
+    private authAdapter?;
+    private config;
+    constructor(config?: WebSocketTransportConfig);
+    setAuthAdapter(auth: IAuthAdapter): void;
+    connect(url: string, _options?: ConnectionOptions): Promise<void>;
+    attach(server: HttpServer | HttpsServer, path?: string): Promise<void>;
+    attachToWebSocketServer(wss: WebSocketServer): Promise<void>;
+    private handleConnection;
+    private handleClientMessage;
+    private handleAuthMessage;
+    private extractBearerToken;
+    private sendToClient;
+    disconnect(): Promise<void>;
+    send(message: Message): Promise<void>;
+    onMessage(handler: MessageHandler): void;
+    onError(handler: ErrorHandler): void;
+    onClose(handler: CloseHandler): void;
+    getState(): ConnectionState;
+    isConnected(): boolean;
+    getConnectedClients(): ClientConnection[];
+    getAuthenticatedClients(): ClientConnection[];
+    getClientCount(): number;
+    getMode(): 'standalone' | 'integration';
+    isAuthRequired(): boolean;
+    private generateId;
+}
+export {};
+//# sourceMappingURL=WebSocketTransportAdapter.d.ts.map

package/dist/adapters/websocket/WebSocketTransportAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketTransportAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/websocket/WebSocketTransportAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,OAAO,EACP,cAAc,EACd,YAAY,EACZ,YAAY,EAGb,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,OAAO,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAEhD,UAAU,gBAAgB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,SAAS,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,qBAAa,yBAA0B,YAAW,iBAAiB;IACjE,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,aAAa,CAAgC;IACrD,OAAO,CAAC,aAAa,CAAgC;IAGrD,OAAO,CAAC,GAAG,CAAC,CAAkB;IAC9B,OAAO,CAAC,SAAS,CAAC,CAAS;IAG3B,OAAO,CAAC,cAAc,CAAC,CAA2B;IAClD,OAAO,CAAC,WAAW,CAAC,CAAkB;IACtC,OAAO,CAAC,aAAa,CAAC,CAAS;IAG/B,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,IAAI,CAA8C;IAG1D,OAAO,CAAC,WAAW,CAAC,CAAe;IACnC,OAAO,CAAC,MAAM,CAA2B;gBAE7B,MAAM,CAAC,EAAE,wBAAwB;IAU7C,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAYlC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCjE,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,EAAE,IAAI,GAAE,MAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC7E,uBAAuB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;YA2BpD,gBAAgB;YA6EhB,mBAAmB;YAuCnB,iBAAiB;IA4E/B,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,YAAY;IAMd,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiC3B,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B3C,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIxC,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAIpC,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAIpC,QAAQ,IAAI,eAAe;IAI3B,WAAW,IAAI,OAAO;IAKtB,mBAAmB,IAAI,gBAAgB,EAAE;IAIzC,uBAAuB,IAAI,gBAAgB,EAAE;IAI7C,cAAc,IAAI,MAAM;IAIxB,OAAO,IAAI,YAAY,GAAG,aAAa;IAIvC,cAAc,IAAI,OAAO;IAIzB,OAAO,CAAC,UAAU;CAGnB"}

package/dist/adapters/websocket/WebSocketTransportAdapter.js

@@ -0,0 +1,380 @@
+import { WebSocketServer, WebSocket } from 'ws';
+export class WebSocketTransportAdapter {
+    constructor(config) {
+        this.state = 'disconnected';
+        this.messageHandlers = new Set();
+        this.errorHandlers = new Set();
+        this.closeHandlers = new Set();
+        // Client management
+        this.clients = new Map();
+        this.mode = 'standalone';
+        this.config = {
+            authTimeout: config?.authTimeout ?? 5000,
+            closeOnAuthFailure: config?.closeOnAuthFailure ?? false,
+            requireAuth: config?.requireAuth ?? false,
+            ...config
+        };
+    }
+    // Set the auth adapter
+    setAuthAdapter(auth) {
+        this.authAdapter = auth;
+        // Update requireAuth based on auth adapter's preference
+        if (auth.isAuthRequired) {
+            this.config.requireAuth = auth.isAuthRequired();
+        }
+        if (auth.getAuthTimeout) {
+            this.config.authTimeout = auth.getAuthTimeout();
+        }
+    }
+    // Standalone mode implementation
+    async connect(url, _options) {
+        if (this.state === 'connected' || this.state === 'connecting') {
+            throw new Error('Already connected or connecting');
+        }
+        this.state = 'connecting';
+        this.serverUrl = url;
+        this.mode = 'standalone';
+        try {
+            // Extract port from URL
+            const urlObj = new URL(url);
+            const port = parseInt(urlObj.port) || (urlObj.protocol === 'wss:' ? 443 : 80);
+            // Create WebSocket server
+            this.wss = new WebSocketServer({ port });
+            this.wss.on('connection', (ws, req) => {
+                this.handleConnection(ws, req);
+            });
+            this.wss.on('error', (error) => {
+                this.errorHandlers.forEach(handler => handler(error));
+            });
+            this.wss.on('close', () => {
+                this.state = 'disconnected';
+                this.closeHandlers.forEach(handler => handler(1000, 'Server closed'));
+            });
+            this.state = 'connected';
+        }
+        catch (error) {
+            this.state = 'disconnected';
+            throw error;
+        }
+    }
+    // Integration mode implementation
+    async attach(server, path = '/ws') {
+        if (this.state === 'connected' || this.state === 'connecting') {
+            throw new Error('Already connected or connecting');
+        }
+        this.state = 'connecting';
+        this.attachedServer = server;
+        this.webSocketPath = path;
+        this.mode = 'integration';
+        try {
+            // Create WebSocket server attached to the existing HTTP server
+            this.wss = new WebSocketServer({
+                server,
+                path,
+                perMessageDeflate: false
+            });
+            this.wss.on('connection', (ws, req) => {
+                this.handleConnection(ws, req);
+            });
+            this.wss.on('error', (error) => {
+                this.errorHandlers.forEach(handler => handler(error));
+            });
+            this.state = 'connected';
+        }
+        catch (error) {
+            this.state = 'disconnected';
+            throw error;
+        }
+    }
+    async attachToWebSocketServer(wss) {
+        if (this.state === 'connected' || this.state === 'connecting') {
+            throw new Error('Already connected or connecting');
+        }
+        this.state = 'connecting';
+        this.attachedWss = wss;
+        this.mode = 'integration';
+        try {
+            this.wss = wss;
+            this.wss.on('connection', (ws, req) => {
+                this.handleConnection(ws, req);
+            });
+            this.wss.on('error', (error) => {
+                this.errorHandlers.forEach(handler => handler(error));
+            });
+            this.state = 'connected';
+        }
+        catch (error) {
+            this.state = 'disconnected';
+            throw error;
+        }
+    }
+    async handleConnection(ws, req) {
+        const clientId = this.generateId();
+        // Step 1: Try header authentication if auth adapter is available
+        let authenticated = false;
+        let authResult = null;
+        if (this.authAdapter && req.headers.authorization) {
+            const token = this.extractBearerToken(req.headers.authorization);
+            if (token) {
+                try {
+                    authResult = await this.authAdapter.authenticate({
+                        type: 'bearer',
+                        token: token
+                    });
+                    authenticated = authResult.success;
+                }
+                catch {
+                    // Header auth failed but don't reject connection
+                }
+            }
+        }
+        // Step 2: Create client with auth state
+        const client = {
+            id: clientId,
+            ws,
+            authenticated,
+            userId: authResult?.userId || (authResult?.user?.userId),
+            metadata: authResult?.metadata || authResult?.user?.metadata,
+            connectedAt: Date.now()
+        };
+        this.clients.set(clientId, client);
+        // Step 3: Set up message handling
+        ws.on('message', (data) => {
+            this.handleClientMessage(clientId, data);
+        });
+        ws.on('error', (error) => {
+            this.errorHandlers.forEach(handler => handler(error));
+        });
+        ws.on('close', (_code, _reason) => {
+            // Clear auth timeout if exists
+            if (client.authTimeout) {
+                clearTimeout(client.authTimeout);
+            }
+            this.clients.delete(clientId);
+        });
+        // Step 4: Set auth timeout if not authenticated and auth is required
+        if (!authenticated && this.config.requireAuth && this.authAdapter) {
+            client.authTimeout = setTimeout(() => {
+                if (!client.authenticated) {
+                    ws.close(1008, 'Authentication timeout');
+                    this.clients.delete(clientId);
+                }
+            }, this.config.authTimeout);
+        }
+        // Step 5: Notify about connection (with auth status)
+        const connectionMessage = {
+            id: this.generateId(),
+            type: 'connection',
+            payload: {
+                clientId,
+                authenticated,
+                userId: client.userId,
+                metadata: client.metadata
+            },
+            timestamp: Date.now()
+        };
+        this.messageHandlers.forEach(handler => handler(connectionMessage));
+    }
+    async handleClientMessage(clientId, data) {
+        const client = this.clients.get(clientId);
+        if (!client)
+            return;
+        try {
+            const message = JSON.parse(data.toString());
+            // Special handling for authentication messages
+            if (message.type === 'authenticate' && !client.authenticated && this.authAdapter) {
+                await this.handleAuthMessage(client, message);
+                return;
+            }
+            // Reject messages from unauthenticated clients if auth is required
+            if (this.config.requireAuth && !client.authenticated) {
+                this.sendToClient(client, {
+                    id: this.generateId(),
+                    type: 'error',
+                    payload: { error: 'Authentication required' },
+                    timestamp: Date.now()
+                });
+                return;
+            }
+            // Add clientId to message payload for routing
+            const enrichedMessage = {
+                ...message,
+                payload: {
+                    ...message.payload,
+                    clientId
+                }
+            };
+            this.messageHandlers.forEach(handler => handler(enrichedMessage));
+        }
+        catch (error) {
+            this.errorHandlers.forEach(handler => handler(error));
+        }
+    }
+    async handleAuthMessage(client, message) {
+        if (!this.authAdapter) {
+            this.sendToClient(client, {
+                id: this.generateId(),
+                type: 'auth_error',
+                payload: { error: 'No auth adapter configured' },
+                timestamp: Date.now()
+            });
+            return;
+        }
+        try {
+            const credentials = message.payload;
+            const result = await this.authAdapter.authenticate(credentials);
+            if (result.success) {
+                // Clear auth timeout
+                if (client.authTimeout) {
+                    clearTimeout(client.authTimeout);
+                    client.authTimeout = undefined;
+                }
+                // Update client state
+                client.authenticated = true;
+                client.userId = result.userId || result.user?.userId;
+                client.metadata = result.metadata || result.user?.metadata;
+                // Send success response
+                this.sendToClient(client, {
+                    id: this.generateId(),
+                    type: 'auth_success',
+                    payload: {
+                        userId: client.userId,
+                        metadata: client.metadata
+                    },
+                    timestamp: Date.now()
+                });
+                // Notify handlers about authentication
+                const authMessage = {
+                    id: this.generateId(),
+                    type: 'client_authenticated',
+                    payload: {
+                        clientId: client.id,
+                        userId: client.userId,
+                        metadata: client.metadata
+                    },
+                    timestamp: Date.now()
+                };
+                this.messageHandlers.forEach(handler => handler(authMessage));
+            }
+            else {
+                // Send error response
+                this.sendToClient(client, {
+                    id: this.generateId(),
+                    type: 'auth_error',
+                    payload: { error: result.error || 'Authentication failed' },
+                    timestamp: Date.now()
+                });
+                // Optionally close connection
+                if (this.config.closeOnAuthFailure) {
+                    client.ws.close(1008, 'Authentication failed');
+                    this.clients.delete(client.id);
+                }
+            }
+        }
+        catch (error) {
+            this.sendToClient(client, {
+                id: this.generateId(),
+                type: 'auth_error',
+                payload: { error: error.message },
+                timestamp: Date.now()
+            });
+        }
+    }
+    extractBearerToken(authHeader) {
+        if (authHeader.startsWith('Bearer ')) {
+            return authHeader.substring(7);
+        }
+        return null;
+    }
+    sendToClient(client, message) {
+        if (client.ws.readyState === WebSocket.OPEN) {
+            client.ws.send(JSON.stringify(message));
+        }
+    }
+    async disconnect() {
+        if (this.state === 'disconnected') {
+            return;
+        }
+        this.state = 'disconnecting';
+        // Close all client connections
+        for (const [_clientId, client] of this.clients) {
+            try {
+                if (client.authTimeout) {
+                    clearTimeout(client.authTimeout);
+                }
+                client.ws.close(1000, 'Server shutting down');
+            }
+            catch {
+                // Ignore errors when closing individual connections
+            }
+        }
+        this.clients.clear();
+        // Close the WebSocket server (only if we created it)
+        if (this.wss && this.mode === 'standalone') {
+            await new Promise((resolve) => {
+                this.wss.close(() => resolve());
+            });
+        }
+        this.state = 'disconnected';
+        this.wss = undefined;
+        this.attachedServer = undefined;
+        this.attachedWss = undefined;
+    }
+    async send(message) {
+        if (this.state !== 'connected') {
+            throw new Error('Not connected');
+        }
+        // Extract clientId from message payload for routing
+        const payload = message.payload;
+        const { clientId, ...clientMessage } = payload;
+        if (!clientId) {
+            throw new Error('Message must contain clientId in payload for routing');
+        }
+        const client = this.clients.get(clientId);
+        if (!client) {
+            throw new Error(`Client ${clientId} not found`);
+        }
+        if (client.ws.readyState !== WebSocket.OPEN) {
+            throw new Error(`Client ${clientId} connection is not open`);
+        }
+        const messageToSend = {
+            ...message,
+            payload: clientMessage
+        };
+        client.ws.send(JSON.stringify(messageToSend));
+    }
+    onMessage(handler) {
+        this.messageHandlers.add(handler);
+    }
+    onError(handler) {
+        this.errorHandlers.add(handler);
+    }
+    onClose(handler) {
+        this.closeHandlers.add(handler);
+    }
+    getState() {
+        return this.state;
+    }
+    isConnected() {
+        return this.state === 'connected';
+    }
+    // Utility methods
+    getConnectedClients() {
+        return Array.from(this.clients.values());
+    }
+    getAuthenticatedClients() {
+        return Array.from(this.clients.values()).filter(c => c.authenticated);
+    }
+    getClientCount() {
+        return this.clients.size;
+    }
+    getMode() {
+        return this.mode;
+    }
+    isAuthRequired() {
+        return this.config.requireAuth ?? false;
+    }
+    generateId() {
+        return Math.random().toString(36).substring(2) + Date.now().toString(36);
+    }
+}

package/dist/adapters/websocket/index.d.ts

@@ -0,0 +1,2 @@
+export { WebSocketTransportAdapter, type WebSocketTransportConfig } from './WebSocketTransportAdapter';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/websocket/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/websocket/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,KAAK,wBAAwB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/adapters/websocket/index.js

@@ -0,0 +1 @@
+export { WebSocketTransportAdapter } from './WebSocketTransportAdapter';

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

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