@roomkit/worker 1.1.3 → 1.3.0

package/README.md

@@ -1,121 +1,372 @@
 # @roomkit/worker
 
-Game logic Worker server for the RoomKit framework.
+Worker server for the RoomKit framework - manages room state and game logic.
 
 ## Installation
 
 ```bash
-npm install @roomkit/worker @roomkit/core @roomkit/state
+npm install @roomkit/worker @roomkit/core
 ```
 
 ## Features
 
-- 🎮 **Room System** - Colyseus-style room lifecycle
-- 🔄 **State Synchronization** - Automatic state sync with clients
-- 🔧 **Circuit Breaker** - Fault tolerance and resilience
+- 🎮 **Room Management** - Create and manage game rooms with state synchronization
+- 🔄 **Message Handling** - Type-safe message handling with RoomKit protocol
+- 💾 **State Persistence** - Optional room state persistence to Redis
+- 🔌 **Hot Reload** - Seamless room migration between workers
+- ��️ **Circuit Breaker** - Protection against overload with graceful degradation
 - 📊 **Metrics** - Built-in Prometheus metrics
-- 🔌 **Horizontal Scaling** - Multiple worker instances supported
-- 🚀 **Room Migration** - Move rooms between workers
+- ⚡ **High Performance** - Optimized for low-latency multiplayer games
 
 ## Quick Start
 
-### Create a Game Room
+### 1. Define Your Room
 
 ```typescript
-import { GameRoom } from '@roomkit/worker';
+import { Room } from '@roomkit/worker';
 
-export class MyGameRoom extends GameRoom {
+interface GameState {
+  players: Map<string, Player>;
+  score: number;
+}
+
+class GameRoom extends Room<GameState> {
   maxClients = 4;
 
   onCreate(options: any) {
-    console.log('Room created', options);
-    this.setState({ players: [], status: 'waiting' });
+    this.setState({
+      players: new Map(),
+      score: 0,
+    });
   }
 
-  onJoin(client: ClientProxy, options: any) {
-    console.log('Player joined', client.userId);
-    this.state.players.push({ id: client.userId });
-    this.broadcastStateToAll();
+  onJoin(client: Client, options?: any) {
+    this.state.players.set(client.sessionId, {
+      name: options.name,
+      x: 0,
+      y: 0,
+    });
+    this.broadcast('player-joined', { id: client.sessionId });
   }
 
-  onMessage(client: ClientProxy, type: number, message: any) {
-    // Handle game logic
+  onMessage(client: Client, type: string, payload: any) {
+    if (type === 'move') {
+      const player = this.state.players.get(client.sessionId);
+      if (player) {
+        player.x = payload.x;
+        player.y = payload.y;
+        this.broadcast('player-moved', { id: client.sessionId, ...payload });
+      }
+    }
   }
 
-  onLeave(client: ClientProxy) {
-    console.log('Player left', client.userId);
+  onLeave(client: Client, consented: boolean) {
+    this.state.players.delete(client.sessionId);
+    this.broadcast('player-left', { id: client.sessionId });
   }
 }
 ```
 
-### Register Room
+### 2. Start the Worker
 
 ```typescript
-import { RoomRegistry } from '@roomkit/worker';
-import { MyGameRoom } from './my-game-room';
+import { createWorker, Room } from '@roomkit/worker';
+
+class GameRoom extends Room<GameState> { /* ... */ }
+
+const worker = await createWorker({
+  redis: 'redis://localhost:6379',
+  rooms: [
+    { name: 'game', room: GameRoom }
+  ],
+  admin: { 
+    port: 28200 
+  },
+});
+
+await worker.listen();
+console.log(\`Worker listening on admin port \${worker.adminPort}\`);
+```
+
+## Configuration
 
-RoomRegistry.register('my_game', MyGameRoom);
+### Redis Configuration
+
+```typescript
+// Option 1: URL string
+redis: 'redis://:password@localhost:6379/0'
+
+// Option 2: Object
+redis: {
+  host: 'localhost',
+  port: 6379,
+  password: 'your-password',
+  db: 0
+}
 ```
 
-### Environment Variables
+### Room Registration
 
-```bash
-# Server
-ADMIN_PORT=28200
+```typescript
+rooms: [
+  { 
+    name: 'lobby',      // Room type name
+    room: LobbyRoom     // Room class
+  },
+  { 
+    name: 'game', 
+    room: GameRoom 
+  },
+]
+```
 
-# Redis
-REDIS_HOST=localhost
-REDIS_PORT=6379
-REDIS_PASSWORD=
+### Circuit Breaker
 
-# Worker
-WORKER_ID=worker-1
+```typescript
+circuitBreaker: {
+  maxRooms: 1000,              // Max rooms per worker (default: 1000)
+  maxPendingRequests: 100,     // Max pending room creation requests (default: 100)
+  enabled: true,               // Enable circuit breaker (default: true)
+  failureThreshold: 5,         // Failures before opening (default: 5)
+  successThreshold: 2,         // Successes before closing (default: 2)
+  timeout: 10000,              // Timeout in ms (default: 10000)
+  resetTimeout: 30000,         // Reset timeout in ms (default: 30000)
+}
 ```
 
-### Run Worker
+### State Persistence
 
-```bash
-# Using the binary
-npx @roomkit/worker
+```typescript
+persistence: {
+  enabled: true,              // Enable persistence (default: false)
+  saveInterval: 5000,         // Auto-save interval in ms (default: 5000)
+  loadOnCreate: true,         // Load state on room creation (default: true)
+}
+```
+
+### Admin API
 
-# Or using Node.js
-node node_modules/@roomkit/worker/dist/main.js
+```typescript
+admin: {
+  port: 28200,       // Admin API port (default: 28200)
+  enabled: true      // Enable admin API (default: true)
+}
+```
+
+## Complete Example
+
+```typescript
+import { createWorker, Room } from '@roomkit/worker';
+import { LobbyRoom } from './rooms/LobbyRoom';
+
+class GameRoom extends Room<GameState> { /* ... */ }
+
+const worker = await createWorker({
+  // Optional: Custom worker ID (auto-generated if not provided)
+  id: 'worker-1',
+  
+  // Redis configuration (required)
+  redis: {
+    host: process.env.REDIS_HOST || 'localhost',
+    port: parseInt(process.env.REDIS_PORT || '6379'),
+    password: process.env.REDIS_PASSWORD,
+  },
+  
+  // Room definitions (required)
+  rooms: [
+    { name: 'lobby', room: LobbyRoom },
+    { name: 'game', room: GameRoom },
+  ],
+  
+  // Circuit breaker configuration
+  circuitBreaker: {
+    maxRooms: 1000,
+    maxPendingRequests: 100,
+    enabled: true,
+    failureThreshold: 5,
+    successThreshold: 2,
+    timeout: 10000,
+    resetTimeout: 30000,
+  },
+  
+  // State persistence
+  persistence: {
+    enabled: true,
+    saveInterval: 5000,
+    loadOnCreate: true,
+  },
+  
+  // Admin API
+  admin: {
+    port: 28200,
+    enabled: true,
+  },
+});
+
+// Start the worker
+await worker.listen();
+
+// Graceful shutdown
+process.on('SIGTERM', async () => {
+  await worker.close();
+  process.exit(0);
+});
 ```
 
 ## Room Lifecycle
 
 ```typescript
-class GameRoom {
-  onCreate(options) {
-    // Room initialization
+class MyRoom extends Room<MyState> {
+  // Called when room is created
+  onCreate(options: any) {
+    this.setState({ ... });
   }
 
-  onJoin(client, options) {
-    // Player joins
+  // Called when a client joins
+  onJoin(client: Client, options?: any) {
+    // Add player to state
   }
 
-  onMessage(client, type, message) {
-    // Handle messages
+  // Called when client sends a message
+  onMessage(client: Client, type: string, payload: any) {
+    // Handle game logic
   }
 
-  onLeave(client) {
-    // Player leaves
+  // Called when a client leaves
+  onLeave(client: Client, consented: boolean) {
+    // Remove player from state
   }
 
+  // Called before room is destroyed
   onDispose() {
-    // Room cleanup
+    // Cleanup resources
   }
 }
 ```
 
+## Room API
+
+### Broadcasting
+
+```typescript
+// Broadcast to all clients
+this.broadcast('event-type', { data: 'value' });
+
+// Broadcast to all except one
+this.broadcast('event-type', { data: 'value' }, { except: client });
+
+// Send to specific client
+client.send('event-type', { data: 'value' });
+```
+
+### State Management
+
+```typescript
+// Set initial state
+this.setState({ score: 0, players: new Map() });
+
+// Update state (triggers automatic sync to clients)
+this.state.score += 10;
+this.state.players.set(id, player);
+
+// Lock for atomic updates
+this.lock.acquire('update-score', async () => {
+  this.state.score += 10;
+});
+```
+
+### Room Metadata
+
+```typescript
+// Set custom metadata (visible in lobby)
+this.setMetadata({ 
+  mapName: 'Forest',
+  difficulty: 'Hard'
+});
+
+// Set if room is private
+this.setPrivate(true);
+```
+
+## Environment Variables
+
+The worker supports basic environment variables for infrastructure configuration:
+
+```bash
+# Redis (infrastructure)
+REDIS_HOST=localhost
+REDIS_PORT=6379
+REDIS_PASSWORD=your-password
+
+# Note: Application-level configs (circuit breaker, persistence, etc.) 
+# should be passed via code parameters for better type safety.
+```
+
 ## Admin API
 
-The worker provides an admin API on port `ADMIN_PORT`:
+### Health Check
+```bash
+GET http://localhost:28200/health
+```
+
+### Metrics
+```bash
+GET http://localhost:28200/metrics
+```
+
+### Room Stats
+```bash
+GET http://localhost:28200/admin/rooms
+```
+
+## Docker
+
+```dockerfile
+FROM node:20-alpine
+WORKDIR /app
+COPY package*.json ./
+RUN npm install
+COPY . .
+EXPOSE 28200
+CMD ["node", "worker.js"]
+```
+
+```bash
+docker run -p 28200:28200 \
+  -e REDIS_HOST=redis \
+  -e REDIS_PORT=6379 \
+  my-worker
+```
+
+## Production Deployment
+
+### Horizontal Scaling
+
+Run multiple worker instances:
+
+```bash
+# Worker 1
+node worker.js --id worker-1
+
+# Worker 2
+node worker.js --id worker-2
+
+# Workers register automatically via Redis
+```
+
+### Monitoring
+
+- Monitor room count, client count, message rate
+- Set up alerts for circuit breaker triggers
+- Track room creation/disposal rates
+
+### Best Practices
 
-- `GET /health` - Health check
-- `GET /metrics` - Prometheus metrics
-- `GET /admin/rooms` - List active rooms
-- `GET /admin/stats` - Worker statistics
+1. **Set maxRooms** based on your server capacity
+2. **Enable persistence** for important game state
+3. **Use circuit breaker** to prevent overload
+4. **Implement proper cleanup** in onDispose()
+5. **Handle errors gracefully** in onMessage()
 
 ## License
 

package/dist/src/config/config.module.d.ts

@@ -1,3 +1,6 @@
+import { DynamicModule } from '@nestjs/common';
+import { WorkerConfigOptions } from './config.service';
 export declare class ConfigModule {
+    static forRoot(config?: Partial<WorkerConfigOptions>): DynamicModule;
 }
 //# sourceMappingURL=config.module.d.ts.map

package/dist/src/config/config.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.module.d.ts","sourceRoot":"","sources":["../../../src/config/config.module.ts"],"names":[],"mappings":"AAGA,qBAKa,YAAY;CAAG"}
+{"version":3,"file":"config.module.d.ts","sourceRoot":"","sources":["../../../src/config/config.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAiB,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEtE,qBAEa,YAAY;IACvB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,aAAa;CAYrE"}

package/dist/src/config/config.module.js

@@ -5,18 +5,28 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
+var ConfigModule_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConfigModule = void 0;
 const common_1 = require("@nestjs/common");
 const config_service_1 = require("./config.service");
-let ConfigModule = class ConfigModule {
+let ConfigModule = ConfigModule_1 = class ConfigModule {
+    static forRoot(config) {
+        return {
+            module: ConfigModule_1,
+            providers: [
+                {
+                    provide: config_service_1.ConfigService,
+                    useValue: new config_service_1.ConfigService(config),
+                },
+            ],
+            exports: [config_service_1.ConfigService],
+        };
+    }
 };
 exports.ConfigModule = ConfigModule;
-exports.ConfigModule = ConfigModule = __decorate([
+exports.ConfigModule = ConfigModule = ConfigModule_1 = __decorate([
     (0, common_1.Global)(),
-    (0, common_1.Module)({
-        providers: [config_service_1.ConfigService],
-        exports: [config_service_1.ConfigService],
-    })
+    (0, common_1.Module)({})
 ], ConfigModule);
 //# sourceMappingURL=config.module.js.map

package/dist/src/config/config.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.module.js","sourceRoot":"","sources":["../../../src/config/config.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAgD;AAChD,qDAAiD;AAO1C,IAAM,YAAY,GAAlB,MAAM,YAAY;CAAG,CAAA;AAAf,oCAAY;uBAAZ,YAAY;IALxB,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,CAAC,8BAAa,CAAC;QAC1B,OAAO,EAAE,CAAC,8BAAa,CAAC;KACzB,CAAC;GACW,YAAY,CAAG"}
+{"version":3,"file":"config.module.js","sourceRoot":"","sources":["../../../src/config/config.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAA+D;AAC/D,qDAAsE;AAI/D,IAAM,YAAY,oBAAlB,MAAM,YAAY;IACvB,MAAM,CAAC,OAAO,CAAC,MAAqC;QAClD,OAAO;YACL,MAAM,EAAE,cAAY;YACpB,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,8BAAa;oBACtB,QAAQ,EAAE,IAAI,8BAAa,CAAC,MAAM,CAAC;iBACpC;aACF;YACD,OAAO,EAAE,CAAC,8BAAa,CAAC;SACzB,CAAC;IACJ,CAAC;CACF,CAAA;AAbY,oCAAY;uBAAZ,YAAY;IAFxB,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,YAAY,CAaxB"}

package/dist/src/config/config.service.d.ts

@@ -1,3 +1,20 @@
+export interface WorkerConfigOptions {
+    workerId: string;
+    adminPort: number;
+    redisHost: string;
+    redisPort: number;
+    redisPassword?: string;
+    maxRooms: number;
+    circuitFailureThreshold: number;
+    circuitSuccessThreshold: number;
+    circuitOpenTimeout: number;
+    maxPendingRequests: number;
+    persistenceEnabled: boolean;
+    snapshotInterval: number;
+    eventFlushInterval: number;
+    snapshotTTL: number;
+    eventTTL: number;
+}
 export declare class ConfigService {
     readonly workerId: string;
     readonly adminPort: number;
@@ -14,6 +31,6 @@ export declare class ConfigService {
     readonly eventFlushInterval: number;
     readonly snapshotTTL: number;
     readonly eventTTL: number;
-    constructor();
+    constructor(config?: Partial<WorkerConfigOptions>);
 }
 //# sourceMappingURL=config.service.d.ts.map

package/dist/src/config/config.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.service.d.ts","sourceRoot":"","sources":["../../../src/config/config.service.ts"],"names":[],"mappings":"AAGA,qBACa,aAAa;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAG1B,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IAGpC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;;CAuB3B"}
+{"version":3,"file":"config.service.d.ts","sourceRoot":"","sources":["../../../src/config/config.service.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB,EAAE,MAAM,CAAC;IAChC,uBAAuB,EAAE,MAAM,CAAC;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBACa,aAAa;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAG1B,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IAGpC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,MAAM,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;CAsBlD"}

package/dist/src/config/config.service.js

@@ -30,29 +30,30 @@ let ConfigService = class ConfigService {
     eventFlushInterval;
     snapshotTTL;
     eventTTL;
-    constructor() {
-        this.workerId = process.env.GW_WORKER_ID || `worker-${(0, uuid_1.v4)().substring(0, 8)}`;
-        this.adminPort = parseInt(process.env.GW_WORKER_ADMIN_PORT || '28200', 10);
-        this.redisHost = process.env.GW_REDIS_HOST || 'localhost';
-        this.redisPort = parseInt(process.env.GW_REDIS_PORT || '6379', 10);
-        this.redisPassword = process.env.GW_REDIS_PASSWORD;
-        this.maxRooms = parseInt(process.env.GW_MAX_ROOMS || '500', 10);
+    constructor(config) {
+        // 优先使用传入的配置，其次使用环境变量（仅支持 REDIS_* 用于基础设施）
+        this.workerId = config?.workerId || process.env.WORKER_ID || `worker-${(0, uuid_1.v4)().substring(0, 8)}`;
+        this.adminPort = config?.adminPort || parseInt(process.env.WORKER_ADMIN_PORT || '28200', 10);
+        this.redisHost = config?.redisHost || process.env.REDIS_HOST || 'localhost';
+        this.redisPort = config?.redisPort || parseInt(process.env.REDIS_PORT || '6379', 10);
+        this.redisPassword = config?.redisPassword || process.env.REDIS_PASSWORD;
+        this.maxRooms = config?.maxRooms || parseInt(process.env.MAX_ROOMS || '500', 10);
         // 熔断器配置
-        this.circuitFailureThreshold = parseInt(process.env.GW_CIRCUIT_FAILURE_THRESHOLD || '10', 10);
-        this.circuitSuccessThreshold = parseInt(process.env.GW_CIRCUIT_SUCCESS_THRESHOLD || '5', 10);
-        this.circuitOpenTimeout = parseInt(process.env.GW_CIRCUIT_OPEN_TIMEOUT || '30000', 10);
-        this.maxPendingRequests = parseInt(process.env.GW_MAX_PENDING_REQUESTS || '1000', 10);
-        // 持久化配置
-        this.persistenceEnabled = process.env.GW_PERSISTENCE_ENABLED !== 'false'; // 默认开启
-        this.snapshotInterval = parseInt(process.env.GW_SNAPSHOT_INTERVAL || '10000', 10); // 10秒
-        this.eventFlushInterval = parseInt(process.env.GW_EVENT_FLUSH_INTERVAL || '1000', 10); // 1秒
-        this.snapshotTTL = parseInt(process.env.GW_SNAPSHOT_TTL || '3600', 10); // 1小时
-        this.eventTTL = parseInt(process.env.GW_EVENT_TTL || '3600', 10); // 1小时
+        this.circuitFailureThreshold = config?.circuitFailureThreshold || parseInt(process.env.CIRCUIT_FAILURE_THRESHOLD || '10', 10);
+        this.circuitSuccessThreshold = config?.circuitSuccessThreshold || parseInt(process.env.CIRCUIT_SUCCESS_THRESHOLD || '5', 10);
+        this.circuitOpenTimeout = config?.circuitOpenTimeout || parseInt(process.env.CIRCUIT_OPEN_TIMEOUT || '30000', 10);
+        this.maxPendingRequests = config?.maxPendingRequests || parseInt(process.env.MAX_PENDING_REQUESTS || '1000', 10);
+        // 持久化配置（默认禁用）
+        this.persistenceEnabled = config?.persistenceEnabled ?? (process.env.PERSISTENCE_ENABLED === 'true');
+        this.snapshotInterval = config?.snapshotInterval || parseInt(process.env.SNAPSHOT_INTERVAL || '10000', 10);
+        this.eventFlushInterval = config?.eventFlushInterval || parseInt(process.env.EVENT_FLUSH_INTERVAL || '1000', 10);
+        this.snapshotTTL = config?.snapshotTTL || parseInt(process.env.SNAPSHOT_TTL || '3600', 10);
+        this.eventTTL = config?.eventTTL || parseInt(process.env.EVENT_TTL || '3600', 10);
     }
 };
 exports.ConfigService = ConfigService;
 exports.ConfigService = ConfigService = __decorate([
     (0, common_1.Injectable)(),
-    __metadata("design:paramtypes", [])
+    __metadata("design:paramtypes", [Object])
 ], ConfigService);
 //# sourceMappingURL=config.service.js.map

package/dist/src/config/config.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.service.js","sourceRoot":"","sources":["../../../src/config/config.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,+BAAkC;AAG3B,IAAM,aAAa,GAAnB,MAAM,aAAa;IACf,QAAQ,CAAS;IACjB,SAAS,CAAS;IAClB,SAAS,CAAS;IAClB,SAAS,CAAS;IAClB,aAAa,CAAU;IACvB,QAAQ,CAAS;IAE1B,QAAQ;IACC,uBAAuB,CAAS;IAChC,uBAAuB,CAAS;IAChC,kBAAkB,CAAS;IAC3B,kBAAkB,CAAS;IAEpC,QAAQ;IACC,kBAAkB,CAAU;IAC5B,gBAAgB,CAAS;IACzB,kBAAkB,CAAS;IAC3B,WAAW,CAAS;IACpB,QAAQ,CAAS;IAE1B;QACE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,UAAU,IAAA,SAAI,GAAE,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC/E,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,EAAE,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,WAAW,CAAC;QAC1D,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QACnD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,KAAK,EAAE,EAAE,CAAC,CAAC;QAEhE,QAAQ;QACR,IAAI,CAAC,uBAAuB,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;QAC9F,IAAI,CAAC,uBAAuB,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;QAC7F,IAAI,CAAC,kBAAkB,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,OAAO,EAAE,EAAE,CAAC,CAAC;QACvF,IAAI,CAAC,kBAAkB,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;QAEtF,QAAQ;QACR,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,OAAO,CAAC,CAAC,OAAO;QACjF,IAAI,CAAC,gBAAgB,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM;QACzF,IAAI,CAAC,kBAAkB,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK;QAC5F,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM;QAC9E,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM;IAC1E,CAAC;CACF,CAAA;AA1CY,sCAAa;wBAAb,aAAa;IADzB,IAAA,mBAAU,GAAE;;GACA,aAAa,CA0CzB"}
+{"version":3,"file":"config.service.js","sourceRoot":"","sources":["../../../src/config/config.service.ts"],"names":[],"mappings":"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"}

package/dist/src/config/worker.config.d.ts

@@ -20,6 +20,20 @@ export interface CircuitBreakerConfig {
     successThreshold?: number;
     /** Time to wait before trying again (ms) */
     openTimeout?: number;
+    /** Maximum pending requests */
+    maxPendingRequests?: number;
+}
+export interface PersistenceConfig {
+    /** Enable persistence */
+    enabled?: boolean;
+    /** Snapshot interval in milliseconds */
+    snapshotInterval?: number;
+    /** Event flush interval in milliseconds */
+    eventFlushInterval?: number;
+    /** Snapshot TTL in seconds */
+    snapshotTTL?: number;
+    /** Event TTL in seconds */
+    eventTTL?: number;
 }
 export interface AdminConfig {
     /** Admin API port */
@@ -50,12 +64,16 @@ export interface WorkerConfig {
     id?: string;
     /** Redis configuration */
     redis: RedisConfig | string;
+    /** Maximum number of rooms this worker can handle */
+    maxRooms?: number;
     /** Room types to register */
     rooms?: Record<string, new (...args: any[]) => any>;
     /** Circuit breaker configuration */
     circuitBreaker?: CircuitBreakerConfig;
     /** Admin API configuration */
     admin?: AdminConfig;
+    /** Persistence configuration */
+    persistence?: PersistenceConfig;
     /**
      * Custom authentication handler
      * If not provided, uses default pass-through authentication (token = userId)

package/dist/src/config/worker.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.config.d.ts","sourceRoot":"","sources":["../../../src/config/worker.config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC;AAE9E,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,KAAK,EAAE,WAAW,GAAG,MAAM,CAAC;IAC5B,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC;IACpD,oCAAoC;IACpC,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,8BAA8B;IAC9B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,WAAW,CAW9E;AAED;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,QAAQ,CAAC,oBAAoB,CAIzE,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,WAAW,CAGtD,CAAC"}
+{"version":3,"file":"worker.config.d.ts","sourceRoot":"","sources":["../../../src/config/worker.config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2CAA2C;IAC3C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC;AAE9E,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,KAAK,EAAE,WAAW,GAAG,MAAM,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC;IACpD,oCAAoC;IACpC,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,8BAA8B;IAC9B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,gCAAgC;IAChC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,WAAW,CAW9E;AAED;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,QAAQ,CAAC,oBAAoB,CAKzE,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,WAAW,CAGtD,CAAC"}

package/dist/src/config/worker.config.js

@@ -27,6 +27,7 @@ exports.DEFAULT_CIRCUIT_BREAKER_CONFIG = {
     failureThreshold: 10,
     successThreshold: 5,
     openTimeout: 30000,
+    maxPendingRequests: 1000,
 };
 exports.DEFAULT_ADMIN_CONFIG = {
     port: 27300,

package/dist/src/config/worker.config.js.map

@@ -1 +1 @@
-{"version":3,"file":"worker.config.js","sourceRoot":"","sources":["../../../src/config/worker.config.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAgFH,oDAWC;AAdD;;GAEG;AACH,SAAgB,oBAAoB,CAAC,MAA4B;IAC/D,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5B,OAAO;YACL,IAAI,EAAE,GAAG,CAAC,QAAQ;YAClB,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI;YAChC,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,SAAS;YACnC,EAAE,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACvD,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACU,QAAA,8BAA8B,GAAmC;IAC5E,gBAAgB,EAAE,EAAE;IACpB,gBAAgB,EAAE,CAAC;IACnB,WAAW,EAAE,KAAK;CACnB,CAAC;AAEW,QAAA,oBAAoB,GAA0B;IACzD,IAAI,EAAE,KAAK;IACX,OAAO,EAAE,IAAI;CACd,CAAC"}
+{"version":3,"file":"worker.config.js","sourceRoot":"","sources":["../../../src/config/worker.config.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAmGH,oDAWC;AAdD;;GAEG;AACH,SAAgB,oBAAoB,CAAC,MAA4B;IAC/D,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5B,OAAO;YACL,IAAI,EAAE,GAAG,CAAC,QAAQ;YAClB,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI;YAChC,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,SAAS;YACnC,EAAE,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACvD,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACU,QAAA,8BAA8B,GAAmC;IAC5E,gBAAgB,EAAE,EAAE;IACpB,gBAAgB,EAAE,CAAC;IACnB,WAAW,EAAE,KAAK;IAClB,kBAAkB,EAAE,IAAI;CACzB,CAAC;AAEW,QAAA,oBAAoB,GAA0B;IACzD,IAAI,EAAE,KAAK;IACX,OAAO,EAAE,IAAI;CACd,CAAC"}