@principal-ai/control-tower-core 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,84 @@
+# Control Tower Core
+
+Centralized, runtime-agnostic library for real-time collaboration and synchronization.
+
+## Installation
+
+```bash
+npm install @principal-ai/control-tower-core
+```
+
+## Quick Start
+
+```typescript
+import {
+  ServerBuilder,
+  DefaultRoomManager,
+  DefaultLockManager,
+  MockTransportAdapter
+} from '@principal-ai/control-tower-core';
+
+// Create a server with default implementations
+const server = new ServerBuilder()
+  .withTransport(new MockTransportAdapter())
+  .withRoomManager(new DefaultRoomManager())
+  .withLockManager(new DefaultLockManager())
+  .build();
+
+await server.start(8080);
+console.log('Server started on port 8080');
+```
+
+## Features
+
+- **Room Management**: Create, join, and manage collaborative rooms
+- **Lock Management**: File/directory locking with queue support
+- **Real-time Events**: Event broadcasting and history
+- **Extensible**: Abstract interfaces for custom implementations
+- **TypeScript**: Full type safety with generated declarations
+
+## API Reference
+
+### ServerBuilder
+
+The main entry point for creating servers:
+
+```typescript
+const server = new ServerBuilder()
+  .withTransport(transportAdapter)
+  .withRoomManager(roomManager)
+  .withLockManager(lockManager)
+  .withAuth(authAdapter) // optional
+  .withStorage(storageAdapter) // optional
+  .withDefaultRoomConfig({
+    maxUsers: 50,
+    maxHistory: 100,
+    permissions: ['read', 'write']
+  })
+  .build();
+```
+
+### Default Implementations
+
+- `DefaultRoomManager`: In-memory room management
+- `DefaultLockManager`: In-memory locking with queue support
+- `MockTransportAdapter`: Mock transport for testing
+
+### Custom Implementations
+
+Implement the abstract interfaces to create custom adapters:
+
+```typescript
+import { RoomManager } from '@principal-ai/control-tower-core';
+
+class CustomRoomManager extends RoomManager {
+  async createRoom(id: string, config: RoomConfig): Promise<Room> {
+    // Your implementation
+  }
+  // ... implement other methods
+}
+```
+
+## License
+
+MIT

package/dist/abstractions/AuthAdapter.d.ts

@@ -0,0 +1,9 @@
+import type { TokenPayload, AuthResult, Credentials } 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>;
+}
+//# sourceMappingURL=AuthAdapter.d.ts.map

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

@@ -0,0 +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"}

package/dist/abstractions/AuthAdapter.js

@@ -0,0 +1 @@
+export {};

package/dist/abstractions/DefaultLockManager.d.ts

@@ -0,0 +1,18 @@
+import type { Lock, LockRequest } from '../types';
+import { LockManager } from './LockManager';
+export declare class DefaultLockManager extends LockManager {
+    acquireLock(userId: string, username: string, request: LockRequest): Promise<Lock>;
+    releaseLock(lockId: string): Promise<void>;
+    releaseUserLocks(userId: string): Promise<void>;
+    getLock(path: string): Promise<Lock | null>;
+    getUserLocks(userId: string): Promise<Lock[]>;
+    getAllLocks(): Promise<Lock[]>;
+    isLocked(path: string): Promise<boolean>;
+    getQueueLength(path: string): Promise<number>;
+    extendLock(lockId: string, ttl: number): Promise<Lock>;
+    addToQueue(userId: string, username: string, request: LockRequest): Promise<void>;
+    removeFromQueue(path: string, userId: string): Promise<void>;
+    private generateId;
+    private processQueue;
+}
+//# sourceMappingURL=DefaultLockManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultLockManager.d.ts","sourceRoot":"","sources":["../../src/abstractions/DefaultLockManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,WAAW,EAEZ,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,qBAAa,kBAAmB,SAAQ,WAAW;IAC3C,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAyClF,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB1C,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe/C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAS3C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAK7C,WAAW,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAI9B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK7C,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUtD,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjF,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAelE,OAAO,CAAC,UAAU;YAIJ,YAAY;CA2B3B"}

package/dist/abstractions/DefaultLockManager.js

@@ -0,0 +1,152 @@
+import { LockManager } from './LockManager';
+export class DefaultLockManager extends LockManager {
+    async acquireLock(userId, username, request) {
+        const { path, type = 'file', priority = 'normal', ttl, branch, metadata } = request;
+        // Check if user already has a lock on this path
+        const userLocks = this.lockState.userLocks.get(userId) || new Set();
+        if (userLocks.has(path)) {
+            throw new Error(`User ${username} already has a lock on ${path}`);
+        }
+        // Check if path is already locked
+        const existingLock = await this.getLock(path);
+        if (existingLock) {
+            // Add to queue
+            await this.addToQueue(userId, username, request);
+            throw new Error(`Path ${path} is already locked by ${existingLock.username}, added to queue`);
+        }
+        // Generate lock ID
+        const lockId = this.generateId();
+        // Create lock
+        const lock = {
+            id: lockId,
+            type,
+            path,
+            userId,
+            username,
+            acquiredAt: Date.now(),
+            expiresAt: ttl ? Date.now() + ttl : undefined,
+            priority,
+            branch,
+            metadata
+        };
+        // Store lock
+        this.lockState.locks.set(lockId, lock);
+        this.lockState.userLocks.set(userId, userLocks.add(path));
+        return lock;
+    }
+    async releaseLock(lockId) {
+        const lock = this.lockState.locks.get(lockId);
+        if (!lock) {
+            throw new Error(`Lock ${lockId} not found`);
+        }
+        // Remove from user locks
+        const userLocks = this.lockState.userLocks.get(lock.userId);
+        if (userLocks) {
+            userLocks.delete(lock.path);
+            if (userLocks.size === 0) {
+                this.lockState.userLocks.delete(lock.userId);
+            }
+        }
+        // Remove lock
+        this.lockState.locks.delete(lockId);
+        // Process queue for this path
+        await this.processQueue(lock.path);
+    }
+    async releaseUserLocks(userId) {
+        const userLocks = this.lockState.userLocks.get(userId);
+        if (!userLocks) {
+            return;
+        }
+        const lockIds = Array.from(this.lockState.locks.entries())
+            .filter(([, lock]) => lock.userId === userId)
+            .map(([lockId]) => lockId);
+        for (const lockId of lockIds) {
+            await this.releaseLock(lockId);
+        }
+    }
+    async getLock(path) {
+        for (const lock of this.lockState.locks.values()) {
+            if (lock.path === path) {
+                return lock;
+            }
+        }
+        return null;
+    }
+    async getUserLocks(userId) {
+        return Array.from(this.lockState.locks.values())
+            .filter(lock => lock.userId === userId);
+    }
+    async getAllLocks() {
+        return Array.from(this.lockState.locks.values());
+    }
+    async isLocked(path) {
+        return await this.getLock(path) !== null;
+    }
+    async getQueueLength(path) {
+        const queue = this.lockState.queue.get(path);
+        return queue ? queue.length : 0;
+    }
+    async extendLock(lockId, ttl) {
+        const lock = this.lockState.locks.get(lockId);
+        if (!lock) {
+            throw new Error(`Lock ${lockId} not found`);
+        }
+        lock.expiresAt = Date.now() + ttl;
+        return lock;
+    }
+    async addToQueue(userId, username, request) {
+        const { path } = request;
+        const queue = this.lockState.queue.get(path) || [];
+        const queueItem = {
+            ...request,
+            userId,
+            username,
+            requestedAt: Date.now(),
+            resolve: () => { },
+            reject: () => { }
+        };
+        queue.push(queueItem);
+        this.lockState.queue.set(path, queue);
+    }
+    async removeFromQueue(path, userId) {
+        const queue = this.lockState.queue.get(path);
+        if (!queue) {
+            return;
+        }
+        const index = queue.findIndex(item => item.userId === userId);
+        if (index !== -1) {
+            queue.splice(index, 1);
+            if (queue.length === 0) {
+                this.lockState.queue.delete(path);
+            }
+        }
+    }
+    generateId() {
+        return Math.random().toString(36).substring(2) + Date.now().toString(36);
+    }
+    async processQueue(path) {
+        const queue = this.lockState.queue.get(path);
+        if (!queue || queue.length === 0) {
+            return;
+        }
+        // Process first item in queue
+        const item = queue.shift();
+        if (queue.length === 0) {
+            this.lockState.queue.delete(path);
+        }
+        try {
+            const lock = await this.acquireLock(item.userId, item.username, {
+                path: item.path,
+                type: item.type,
+                priority: item.priority,
+                ttl: item.ttl,
+                branch: item.branch,
+                metadata: item.metadata
+            });
+            item.resolve(lock);
+        }
+        catch (error) {
+            item.reject(error);
+        }
+    }
+}

package/dist/abstractions/DefaultRoomManager.d.ts

@@ -0,0 +1,15 @@
+import type { Room, RoomUser, RoomState, RoomConfig, Event } from '../types';
+import { RoomManager } from './RoomManager';
+export declare class DefaultRoomManager extends RoomManager {
+    createRoom(id: string, config: RoomConfig): Promise<Room>;
+    deleteRoom(id: string): Promise<void>;
+    joinRoom(roomId: string, user: RoomUser): Promise<void>;
+    leaveRoom(roomId: string, userId: string): Promise<void>;
+    broadcastToRoom(roomId: string, event: Event, _excludeUserId?: string): Promise<void>;
+    getRoomState(roomId: string): Promise<RoomState | null>;
+    getUsersInRoom(roomId: string): Promise<RoomUser[]>;
+    addEventToHistory(roomId: string, event: Event): Promise<void>;
+    getEventHistory(roomId: string, limit?: number): Promise<Event[]>;
+    updateUserStatus(roomId: string, userId: string, status: RoomUser['status']): Promise<void>;
+}
+//# sourceMappingURL=DefaultRoomManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultRoomManager.d.ts","sourceRoot":"","sources":["../../src/abstractions/DefaultRoomManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,UAAU,EACV,KAAK,EACN,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,qBAAa,kBAAmB,SAAQ,WAAW;IAC3C,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBzD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAavD,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASxD,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrF,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAIvD,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IASnD,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9D,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAUjE,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAYlG"}

package/dist/abstractions/DefaultRoomManager.js

@@ -0,0 +1,91 @@
+import { RoomManager } from './RoomManager';
+export class DefaultRoomManager extends RoomManager {
+    async createRoom(id, config) {
+        const room = {
+            id,
+            name: config.name || id,
+            createdAt: Date.now(),
+            maxUsers: config.maxUsers,
+            maxHistory: config.maxHistory,
+            permissions: config.permissions,
+            metadata: config.metadata || {}
+        };
+        const roomState = {
+            room,
+            users: new Map(),
+            eventHistory: [],
+            locks: new Map()
+        };
+        this.rooms.set(id, roomState);
+        return room;
+    }
+    async deleteRoom(id) {
+        this.rooms.delete(id);
+    }
+    async joinRoom(roomId, user) {
+        const roomState = this.rooms.get(roomId);
+        if (!roomState) {
+            throw new Error(`Room ${roomId} not found`);
+        }
+        if (roomState.room.maxUsers && roomState.users.size >= roomState.room.maxUsers) {
+            throw new Error(`Room ${roomId} is full`);
+        }
+        roomState.users.set(user.id, user);
+    }
+    async leaveRoom(roomId, userId) {
+        const roomState = this.rooms.get(roomId);
+        if (!roomState) {
+            return; // Room doesn't exist, nothing to do
+        }
+        roomState.users.delete(userId);
+    }
+    async broadcastToRoom(roomId, event, _excludeUserId) {
+        const roomState = this.rooms.get(roomId);
+        if (!roomState) {
+            throw new Error(`Room ${roomId} not found`);
+        }
+        // In a real implementation, this would broadcast to connected clients
+        // For now, we'll just store the event in history
+        await this.addEventToHistory(roomId, event);
+    }
+    async getRoomState(roomId) {
+        return this.rooms.get(roomId) || null;
+    }
+    async getUsersInRoom(roomId) {
+        const roomState = this.rooms.get(roomId);
+        if (!roomState) {
+            return [];
+        }
+        return Array.from(roomState.users.values());
+    }
+    async addEventToHistory(roomId, event) {
+        const roomState = this.rooms.get(roomId);
+        if (!roomState) {
+            throw new Error(`Room ${roomId} not found`);
+        }
+        roomState.eventHistory.push(event);
+        // Trim history if needed
+        if (roomState.room.maxHistory && roomState.eventHistory.length > roomState.room.maxHistory) {
+            roomState.eventHistory = roomState.eventHistory.slice(-roomState.room.maxHistory);
+        }
+    }
+    async getEventHistory(roomId, limit) {
+        const roomState = this.rooms.get(roomId);
+        if (!roomState) {
+            return [];
+        }
+        const history = roomState.eventHistory;
+        return limit ? history.slice(-limit) : history;
+    }
+    async updateUserStatus(roomId, userId, status) {
+        const roomState = this.rooms.get(roomId);
+        if (!roomState) {
+            throw new Error(`Room ${roomId} not found`);
+        }
+        const user = roomState.users.get(userId);
+        if (user) {
+            user.status = status;
+            user.lastActivity = Date.now();
+        }
+    }
+}

package/dist/abstractions/EventEmitter.d.ts

@@ -0,0 +1,14 @@
+export type EventData = unknown;
+export type EventListener<T = EventData> = (data: T) => void | Promise<void>;
+export type UnsubscribeFn = () => void;
+export declare class TypedEventEmitter<TEvents extends Record<string, EventData>> {
+    private listeners;
+    private onceListeners;
+    on<K extends keyof TEvents>(event: K, listener: EventListener<TEvents[K]>): UnsubscribeFn;
+    once<K extends keyof TEvents>(event: K, listener: EventListener<TEvents[K]>): UnsubscribeFn;
+    off<K extends keyof TEvents>(event: K, listener: EventListener<TEvents[K]>): void;
+    emit<K extends keyof TEvents>(event: K, data: TEvents[K]): Promise<void>;
+    removeAllListeners(event?: keyof TEvents): void;
+    listenerCount(event: keyof TEvents): number;
+}
+//# sourceMappingURL=EventEmitter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EventEmitter.d.ts","sourceRoot":"","sources":["../../src/abstractions/EventEmitter.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC;AAEhC,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAC7E,MAAM,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC;AAEvC,qBAAa,iBAAiB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;IAEtE,OAAO,CAAC,SAAS,CAA2D;IAC5E,OAAO,CAAC,aAAa,CAA2D;IAEhF,EAAE,CAAC,CAAC,SAAS,MAAM,OAAO,EACxB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAClC,aAAa;IAShB,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,EAC1B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAClC,aAAa;IAShB,GAAG,CAAC,CAAC,SAAS,MAAM,OAAO,EACzB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAClC,IAAI;IAKD,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,EAChC,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GACf,OAAO,CAAC,IAAI,CAAC;IAmBhB,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,OAAO,GAAG,IAAI;IAU/C,aAAa,CAAC,KAAK,EAAE,MAAM,OAAO,GAAG,MAAM;CAK5C"}

package/dist/abstractions/EventEmitter.js

@@ -0,0 +1,56 @@
+export class TypedEventEmitter {
+    constructor() {
+        // Use unknown type for storage, will be cast appropriately when called
+        this.listeners = new Map();
+        this.onceListeners = new Map();
+    }
+    on(event, listener) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, new Set());
+        }
+        this.listeners.get(event).add(listener);
+        return () => this.off(event, listener);
+    }
+    once(event, listener) {
+        if (!this.onceListeners.has(event)) {
+            this.onceListeners.set(event, new Set());
+        }
+        this.onceListeners.get(event).add(listener);
+        return () => this.off(event, listener);
+    }
+    off(event, listener) {
+        this.listeners.get(event)?.delete(listener);
+        this.onceListeners.get(event)?.delete(listener);
+    }
+    async emit(event, data) {
+        const listeners = this.listeners.get(event);
+        const onceListeners = this.onceListeners.get(event);
+        if (onceListeners) {
+            const listenersToCall = Array.from(onceListeners);
+            this.onceListeners.delete(event);
+            for (const listener of listenersToCall) {
+                await listener(data);
+            }
+        }
+        if (listeners) {
+            for (const listener of Array.from(listeners)) {
+                await listener(data);
+            }
+        }
+    }
+    removeAllListeners(event) {
+        if (event) {
+            this.listeners.delete(event);
+            this.onceListeners.delete(event);
+        }
+        else {
+            this.listeners.clear();
+            this.onceListeners.clear();
+        }
+    }
+    listenerCount(event) {
+        const regular = this.listeners.get(event)?.size ?? 0;
+        const once = this.onceListeners.get(event)?.size ?? 0;
+        return regular + once;
+    }
+}

package/dist/abstractions/LockManager.d.ts

@@ -0,0 +1,16 @@
+import type { Lock, LockRequest, LockState } from '../types';
+export declare abstract class LockManager {
+    protected lockState: LockState;
+    abstract acquireLock(userId: string, username: string, request: LockRequest): Promise<Lock>;
+    abstract releaseLock(lockId: string): Promise<void>;
+    abstract releaseUserLocks(userId: string): Promise<void>;
+    abstract getLock(path: string): Promise<Lock | null>;
+    abstract getUserLocks(userId: string): Promise<Lock[]>;
+    abstract getAllLocks(): Promise<Lock[]>;
+    abstract isLocked(path: string): Promise<boolean>;
+    abstract getQueueLength(path: string): Promise<number>;
+    abstract extendLock(lockId: string, ttl: number): Promise<Lock>;
+    abstract addToQueue(userId: string, username: string, request: LockRequest): Promise<void>;
+    abstract removeFromQueue(path: string, userId: string): Promise<void>;
+}
+//# sourceMappingURL=LockManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LockManager.d.ts","sourceRoot":"","sources":["../../src/abstractions/LockManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,WAAW,EACX,SAAS,EACV,MAAM,UAAU,CAAC;AAElB,8BAAsB,WAAW;IAC/B,SAAS,CAAC,SAAS,EAAE,SAAS,CAI5B;IAEF,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3F,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACnD,QAAQ,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACxD,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IACpD,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IACtD,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IACjD,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IACtD,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC/D,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1F,QAAQ,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CACtE"}

package/dist/abstractions/LockManager.js

@@ -0,0 +1,9 @@
+export class LockManager {
+    constructor() {
+        this.lockState = {
+            locks: new Map(),
+            queue: new Map(),
+            userLocks: new Map()
+        };
+    }
+}

package/dist/abstractions/RoomManager.d.ts

@@ -0,0 +1,15 @@
+import type { Room, RoomUser, RoomState, RoomConfig, Event } from '../types';
+export declare abstract class RoomManager {
+    protected rooms: Map<string, RoomState>;
+    abstract createRoom(id: string, config: RoomConfig): Promise<Room>;
+    abstract deleteRoom(id: string): Promise<void>;
+    abstract joinRoom(roomId: string, user: RoomUser): Promise<void>;
+    abstract leaveRoom(roomId: string, userId: string): Promise<void>;
+    abstract broadcastToRoom(roomId: string, event: Event, excludeUserId?: string): Promise<void>;
+    abstract getRoomState(roomId: string): Promise<RoomState | null>;
+    abstract getUsersInRoom(roomId: string): Promise<RoomUser[]>;
+    abstract addEventToHistory(roomId: string, event: Event): Promise<void>;
+    abstract getEventHistory(roomId: string, limit?: number): Promise<Event[]>;
+    abstract updateUserStatus(roomId: string, userId: string, status: RoomUser['status']): Promise<void>;
+}
+//# sourceMappingURL=RoomManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RoomManager.d.ts","sourceRoot":"","sources":["../../src/abstractions/RoomManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,UAAU,EACV,KAAK,EACN,MAAM,UAAU,CAAC;AAElB,8BAAsB,WAAW;IAC/B,SAAS,CAAC,KAAK,yBAAgC;IAE/C,QAAQ,CAAC,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAClE,QAAQ,CAAC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9C,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAChE,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACjE,QAAQ,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC7F,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAChE,QAAQ,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC5D,QAAQ,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IACvE,QAAQ,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAC1E,QAAQ,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CACrG"}

package/dist/abstractions/RoomManager.js

@@ -0,0 +1,5 @@
+export class RoomManager {
+    constructor() {
+        this.rooms = new Map();
+    }
+}

package/dist/abstractions/StorageAdapter.d.ts

@@ -0,0 +1,25 @@
+export type StorageOperation = {
+    type: 'get';
+    key: string;
+} | {
+    type: 'set';
+    key: string;
+    value: unknown;
+    ttl?: number;
+} | {
+    type: 'delete';
+    key: string;
+} | {
+    type: 'exists';
+    key: string;
+};
+export interface IStorageAdapter {
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T, ttl?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    scan(pattern: string): Promise<string[]>;
+    clear(): Promise<void>;
+    transaction<T>(operations: StorageOperation[]): Promise<T>;
+}
+//# sourceMappingURL=StorageAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StorageAdapter.d.ts","sourceRoot":"","sources":["../../src/abstractions/StorageAdapter.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACvC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,WAAW,CAAC,CAAC,EAAE,UAAU,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC5D"}

package/dist/abstractions/StorageAdapter.js

@@ -0,0 +1 @@
+export {};

package/dist/abstractions/TransportAdapter.d.ts

@@ -0,0 +1,17 @@
+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>;
+    send(message: Message): Promise<void>;
+    onMessage(handler: MessageHandler): void;
+    onError(handler: ErrorHandler): void;
+    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

@@ -0,0 +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;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/abstractions/TransportAdapter.js

@@ -0,0 +1 @@
+export {};

package/dist/abstractions/index.d.ts

@@ -0,0 +1,9 @@
+export { ITransportAdapter } from './TransportAdapter';
+export { IStorageAdapter, StorageOperation } from './StorageAdapter';
+export { IAuthAdapter } from './AuthAdapter';
+export { TypedEventEmitter, EventListener, UnsubscribeFn } from './EventEmitter';
+export { RoomManager } from './RoomManager';
+export { LockManager } from './LockManager';
+export { DefaultRoomManager } from './DefaultRoomManager';
+export { DefaultLockManager } from './DefaultLockManager';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/abstractions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/abstractions/index.js

@@ -0,0 +1,5 @@
+export { TypedEventEmitter } from './EventEmitter';
+export { RoomManager } from './RoomManager';
+export { LockManager } from './LockManager';
+export { DefaultRoomManager } from './DefaultRoomManager';
+export { DefaultLockManager } from './DefaultLockManager';

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

@@ -0,0 +1,27 @@
+import type { IAuthAdapter } from '../../abstractions/AuthAdapter';
+import type { TokenPayload, AuthResult, Credentials } from '../../types';
+export declare class MockAuthAdapter implements IAuthAdapter {
+    private tokens;
+    private revokedTokens;
+    private users;
+    private simulateLatency;
+    private shouldFailAuth;
+    private tokenCounter;
+    constructor(options?: {
+        simulateLatency?: number;
+        shouldFailAuth?: boolean;
+    });
+    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>;
+    private simulateDelay;
+    addUser(username: string, password: string, payload: TokenPayload): void;
+    removeUser(username: string): void;
+    getTokenCount(): number;
+    getRevokedTokenCount(): number;
+    clearTokens(): void;
+    setFailAuth(fail: boolean): void;
+}
+//# sourceMappingURL=MockAuthAdapter.d.ts.map

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

@@ -0,0 +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"}