@asenajs/asena 0.4.0 → 0.6.0-beta.0

package/dist/lib/server/messaging/Ulak.d.ts

@@ -0,0 +1,224 @@
+import type { AsenaWebSocketService } from '../web/websocket';
+import { type ICoreService, ICoreServiceNames } from '../../ioc';
+import { type BulkOperation, type BulkResult } from './types';
+/**
+ * Central WebSocket message broker for Asena.js
+ *
+ * Ulak (Turkish: Messenger/Courier) provides a centralized way to send WebSocket messages
+ * without circular dependencies. Services can inject Ulak to send messages to any
+ * WebSocket namespace without directly injecting WebSocket services.
+ *
+ * @example
+ * ```typescript
+ * @Service('UserService')
+ * class UserService {
+ *   @Inject(ulak("/notifications"))
+ *   private notifications: Ulak.NameSpace<"/notifications">;
+ *
+ *   async createUser(data: any) {
+ *     const user = await this.saveUser(data);
+ *     await this.notifications.broadcast({ type: 'user_created', user });
+ *   }
+ * }
+ * ```
+ */
+export declare class Ulak implements ICoreService {
+    readonly serviceName: string;
+    /**
+     * Logger instance injected from CoreContainer
+     */
+    private logger;
+    /**
+     * Map of namespace path to WebSocket service instance
+     */
+    private namespaces;
+    /**
+     * Initialize Ulak messaging system
+     * Called after dependency injection is complete
+     */
+    init(): Promise<void>;
+    /**
+     * Register a WebSocket namespace
+     * Called automatically during WebSocket service initialization
+     *
+     * @param path - The namespace path (e.g., "/notifications")
+     * @param service - The WebSocket service instance
+     */
+    registerNamespace(path: string, service: AsenaWebSocketService<any>): void;
+    /**
+     * Unregister a WebSocket namespace
+     * Useful for cleanup and preventing memory leaks
+     *
+     * @param path - The namespace path to unregister
+     */
+    unregisterNamespace(path: string): void;
+    /**
+     * Select a specific namespace for scoped operations
+     * Returns a scoped namespace interface for ergonomic API
+     *
+     * @param path - The namespace path
+     * @returns Scoped namespace instance
+     *
+     * @example
+     * ```typescript
+     * const chat = ulak.namespace('/chat');
+     * await chat.broadcast({ message: 'Hello' }); // No need to repeat '/chat'
+     * ```
+     */
+    namespace<T extends string>(path: T): Ulak.NameSpace<T>;
+    /**
+     * Broadcast message to all clients in a namespace
+     *
+     * @param namespace - The target namespace
+     * @param data - The data to send
+     * @throws {UlakError} If namespace not found or broadcast fails
+     */
+    broadcast(namespace: string, data: any): Promise<void>;
+    /**
+     * Send message to specific room in a namespace
+     *
+     * @param namespace - The target namespace
+     * @param room - The room name
+     * @param data - The data to send
+     * @throws {UlakError} If namespace not found or send fails
+     */
+    to(namespace: string, room: string, data: any): Promise<void>;
+    /**
+     * Send message to specific socket by ID
+     *
+     * @param namespace - The target namespace
+     * @param socketId - The socket ID
+     * @param data - The data to send
+     * @throws {UlakError} If namespace not found, socket not found, or send fails
+     */
+    toSocket(namespace: string, socketId: string, data: any): Promise<void>;
+    /**
+     * Send to multiple rooms at once (parallel execution)
+     *
+     * @param namespace - The target namespace
+     * @param rooms - Array of room names
+     * @param data - The data to send
+     */
+    toMany(namespace: string, rooms: string[], data: any): Promise<void>;
+    /**
+     * Broadcast to all registered namespaces
+     *
+     * @param data - The data to send
+     */
+    broadcastAll(data: any): Promise<void>;
+    /**
+     * Send different messages to different targets (bulk operation)
+     *
+     * @param operations - Array of operations to perform
+     * @returns Result summary
+     */
+    bulkSend(operations: BulkOperation[]): Promise<BulkResult>;
+    /**
+     * Get all active namespaces
+     *
+     * @returns Array of namespace paths
+     */
+    getNamespaces(): string[];
+    /**
+     * Check if namespace exists
+     *
+     * @param namespace - The namespace to check
+     * @returns True if namespace is registered
+     */
+    hasNamespace(namespace: string): boolean;
+    /**
+     * Get socket count for a namespace
+     *
+     * @param namespace - The namespace to query
+     * @returns Number of active sockets
+     */
+    getSocketCount(namespace: string): number;
+    /**
+     * Dispose of all resources and stop background tasks
+     * Should be called during application shutdown
+     */
+    dispose(): void;
+    /**
+     * Get namespace service or throw error
+     *
+     * @param namespace - The namespace to retrieve
+     * @returns The WebSocket service
+     * @throws {UlakError} If namespace not found
+     */
+    private getNamespaceService;
+}
+/**
+ * Scoped namespace interface
+ * Provides ergonomic API without repeating namespace path
+ */
+export declare namespace Ulak {
+    interface NameSpace<T extends string = string> {
+        /**
+         * The namespace path
+         */
+        readonly path: T;
+        /**
+         * Broadcast to all clients in this namespace
+         *
+         * @param data - The data to send
+         */
+        broadcast(data: any): Promise<void>;
+        /**
+         * Send to specific room in this namespace
+         *
+         * @param room - The room name
+         * @param data - The data to send
+         */
+        to(room: string, data: any): Promise<void>;
+        /**
+         * Send to specific socket by ID in this namespace
+         *
+         * @param socketId - The socket ID
+         * @param data - The data to send
+         */
+        toSocket(socketId: string, data: any): Promise<void>;
+        /**
+         * Send to multiple rooms at once
+         *
+         * @param rooms - Array of room names
+         * @param data - The data to send
+         */
+        toMany(rooms: string[], data: any): Promise<void>;
+        /**
+         * Get socket count for this namespace
+         *
+         * @returns Number of active sockets
+         */
+        getSocketCount(): number;
+    }
+}
+/**
+ * Helper function for injecting scoped Ulak namespace
+ *
+ * This function returns a tuple that can be used with the @Inject decorator
+ * to inject a scoped namespace from Ulak. This provides an ergonomic API
+ * where you don't need to repeat the namespace path in every method call.
+ *
+ * @param namespace - The WebSocket namespace path (e.g., "/chat", "/notifications")
+ * @returns A tuple of [serviceName, expression] for @Inject decorator
+ *
+ * @example
+ * ```typescript
+ * @Service('ChatService')
+ * export class ChatService {
+ *   // Inject scoped namespace
+ *   @Inject(ulak("/chat"))
+ *   private chat: Ulak.NameSpace<"/chat">;
+ *
+ *   async sendMessage(roomId: string, message: string) {
+ *     // Clean API - no need to repeat '/chat'
+ *     await this.chat.to(roomId, { message });
+ *   }
+ *
+ *   async broadcastAnnouncement(text: string) {
+ *     await this.chat.broadcast({ type: 'announcement', text });
+ *   }
+ * }
+ * ```
+ */
+export declare function ulak<T extends string>(namespace: T): readonly [ICoreServiceNames.__ULAK__, (ulak: Ulak) => Ulak.NameSpace<T>];

package/dist/lib/server/messaging/Ulak.js

@@ -0,0 +1,351 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    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 __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { CoreService, ICoreServiceNames } from '../../ioc';
+import { UlakError, UlakErrorCode } from './types';
+import { Inject } from '../../ioc/component';
+import { blue } from '../../logger';
+/**
+ * Central WebSocket message broker for Asena.js
+ *
+ * Ulak (Turkish: Messenger/Courier) provides a centralized way to send WebSocket messages
+ * without circular dependencies. Services can inject Ulak to send messages to any
+ * WebSocket namespace without directly injecting WebSocket services.
+ *
+ * @example
+ * ```typescript
+ * @Service('UserService')
+ * class UserService {
+ *   @Inject(ulak("/notifications"))
+ *   private notifications: Ulak.NameSpace<"/notifications">;
+ *
+ *   async createUser(data: any) {
+ *     const user = await this.saveUser(data);
+ *     await this.notifications.broadcast({ type: 'user_created', user });
+ *   }
+ * }
+ * ```
+ */
+let Ulak = class Ulak {
+    serviceName = 'Ulak';
+    /**
+     * Logger instance injected from CoreContainer
+     */
+    logger;
+    /**
+     * Map of namespace path to WebSocket service instance
+     */
+    namespaces = new Map();
+    /**
+     * Initialize Ulak messaging system
+     * Called after dependency injection is complete
+     */
+    async init() {
+        this.logger.info(`${blue('[Ulak]')} Initializing WebSocket messaging system ready`);
+    }
+    /**
+     * Register a WebSocket namespace
+     * Called automatically during WebSocket service initialization
+     *
+     * @param path - The namespace path (e.g., "/notifications")
+     * @param service - The WebSocket service instance
+     */
+    registerNamespace(path, service) {
+        if (this.namespaces.has(path)) {
+            this.logger.warn(`${blue('[Ulak]')} Namespace "${path}" already registered, skipping`);
+            return;
+        }
+        this.namespaces.set(path, service);
+        this.logger.info(`${blue('[Ulak]')} Namespace "${path}" registered`);
+    }
+    /**
+     * Unregister a WebSocket namespace
+     * Useful for cleanup and preventing memory leaks
+     *
+     * @param path - The namespace path to unregister
+     */
+    unregisterNamespace(path) {
+        if (!this.namespaces.has(path)) {
+            this.logger.warn(`${blue('[Ulak]')} Cannot unregister namespace "${path}" - not found`);
+            return;
+        }
+        this.namespaces.delete(path);
+        this.logger.info(`${blue('[Ulak]')} Namespace "${path}" unregistered`);
+    }
+    /**
+     * Select a specific namespace for scoped operations
+     * Returns a scoped namespace interface for ergonomic API
+     *
+     * @param path - The namespace path
+     * @returns Scoped namespace instance
+     *
+     * @example
+     * ```typescript
+     * const chat = ulak.namespace('/chat');
+     * await chat.broadcast({ message: 'Hello' }); // No need to repeat '/chat'
+     * ```
+     */
+    namespace(path) {
+        return new UlakNameSpace(path, this);
+    }
+    /**
+     * Broadcast message to all clients in a namespace
+     *
+     * @param namespace - The target namespace
+     * @param data - The data to send
+     * @throws {UlakError} If namespace not found or broadcast fails
+     */
+    async broadcast(namespace, data) {
+        try {
+            const service = this.getNamespaceService(namespace);
+            // Use service's in() method to broadcast to all clients
+            service.in(data);
+        }
+        catch (error) {
+            this.logger.error(`${blue('[Ulak]')} Broadcast failed for namespace "${namespace}"`, error);
+            // If already a UlakError (e.g., NAMESPACE_NOT_FOUND), rethrow as-is
+            if (error instanceof UlakError) {
+                throw error;
+            }
+            throw new UlakError(`Failed to broadcast to namespace: ${namespace}`, UlakErrorCode.BROADCAST_FAILED, namespace, error);
+        }
+    }
+    /**
+     * Send message to specific room in a namespace
+     *
+     * @param namespace - The target namespace
+     * @param room - The room name
+     * @param data - The data to send
+     * @throws {UlakError} If namespace not found or send fails
+     */
+    async to(namespace, room, data) {
+        try {
+            const service = this.getNamespaceService(namespace);
+            // Use service's to() method to send to specific room
+            service.to(room, data);
+        }
+        catch (error) {
+            this.logger.error(`${blue('[Ulak]')} Send to room "${room}" failed in namespace "${namespace}"`, error);
+            // If already a UlakError (e.g., NAMESPACE_NOT_FOUND), rethrow as-is
+            if (error instanceof UlakError) {
+                throw error;
+            }
+            throw new UlakError(`Failed to send to room "${room}" in namespace: ${namespace}`, UlakErrorCode.SEND_FAILED, namespace, error);
+        }
+    }
+    /**
+     * Send message to specific socket by ID
+     *
+     * @param namespace - The target namespace
+     * @param socketId - The socket ID
+     * @param data - The data to send
+     * @throws {UlakError} If namespace not found, socket not found, or send fails
+     */
+    async toSocket(namespace, socketId, data) {
+        try {
+            const service = this.getNamespaceService(namespace);
+            // Get socket from service's socket map
+            const socket = service.sockets.get(socketId);
+            if (!socket) {
+                throw new UlakError(`Socket "${socketId}" not found in namespace "${namespace}"`, UlakErrorCode.SOCKET_NOT_FOUND, namespace);
+            }
+            // Send data to socket
+            socket.send(typeof data === 'string' ? data : JSON.stringify(data));
+        }
+        catch (error) {
+            this.logger.error(`${blue('[Ulak]')} Send to socket "${socketId}" failed in namespace "${namespace}"`, error);
+            if (error instanceof UlakError) {
+                throw error;
+            }
+            throw new UlakError(`Failed to send to socket "${socketId}" in namespace: ${namespace}`, UlakErrorCode.SEND_FAILED, namespace, error);
+        }
+    }
+    /**
+     * Send to multiple rooms at once (parallel execution)
+     *
+     * @param namespace - The target namespace
+     * @param rooms - Array of room names
+     * @param data - The data to send
+     */
+    async toMany(namespace, rooms, data) {
+        const results = await Promise.allSettled(rooms.map((room) => this.to(namespace, room, data)));
+        // Track failures
+        const failures = results.filter((r) => r.status === 'rejected');
+        if (failures.length > 0) {
+            this.logger.warn(`${blue('[Ulak]')} Batch send failed for ${failures.length}/${rooms.length} rooms in "${namespace}"`);
+        }
+    }
+    /**
+     * Broadcast to all registered namespaces
+     *
+     * @param data - The data to send
+     */
+    async broadcastAll(data) {
+        const namespaces = Array.from(this.namespaces.keys());
+        const results = await Promise.allSettled(namespaces.map((ns) => this.broadcast(ns, data)));
+        const succeeded = results.filter((r) => r.status === 'fulfilled').length;
+        const failed = results.filter((r) => r.status === 'rejected').length;
+        this.logger.info(`${blue('[Ulak]')} Broadcast to all: ${succeeded} succeeded, ${failed} failed`);
+    }
+    /**
+     * Send different messages to different targets (bulk operation)
+     *
+     * @param operations - Array of operations to perform
+     * @returns Result summary
+     */
+    async bulkSend(operations) {
+        const results = await Promise.allSettled(operations.map((op) => {
+            switch (op.type) {
+                case 'broadcast':
+                    return this.broadcast(op.namespace, op.data);
+                case 'room':
+                    if (!op.room) {
+                        return Promise.reject(new Error('Room name required for room operation'));
+                    }
+                    return this.to(op.namespace, op.room, op.data);
+                case 'socket':
+                    if (!op.socketId) {
+                        return Promise.reject(new Error('Socket ID required for socket operation'));
+                    }
+                    return this.toSocket(op.namespace, op.socketId, op.data);
+                default:
+                    return Promise.reject(new Error(`Invalid operation type: ${op.type}`));
+            }
+        }));
+        const succeeded = results.filter((r) => r.status === 'fulfilled').length;
+        const failed = results.filter((r) => r.status === 'rejected').length;
+        this.logger.info(`${blue('[Ulak]')} Bulk send: ${succeeded}/${operations.length} succeeded, ${failed} failed`);
+        return {
+            total: operations.length,
+            succeeded,
+            failed,
+            results,
+        };
+    }
+    /**
+     * Get all active namespaces
+     *
+     * @returns Array of namespace paths
+     */
+    getNamespaces() {
+        return Array.from(this.namespaces.keys());
+    }
+    /**
+     * Check if namespace exists
+     *
+     * @param namespace - The namespace to check
+     * @returns True if namespace is registered
+     */
+    hasNamespace(namespace) {
+        return this.namespaces.has(namespace);
+    }
+    /**
+     * Get socket count for a namespace
+     *
+     * @param namespace - The namespace to query
+     * @returns Number of active sockets
+     */
+    getSocketCount(namespace) {
+        const service = this.namespaces.get(namespace);
+        return service ? service.sockets.size : 0;
+    }
+    /**
+     * Dispose of all resources and stop background tasks
+     * Should be called during application shutdown
+     */
+    dispose() {
+        // Unregister all namespaces
+        const namespaces = Array.from(this.namespaces.keys());
+        for (const namespace of namespaces) {
+            this.unregisterNamespace(namespace);
+        }
+        this.logger.info(`${blue('[Ulak]')} Disposed`);
+    }
+    /**
+     * Get namespace service or throw error
+     *
+     * @param namespace - The namespace to retrieve
+     * @returns The WebSocket service
+     * @throws {UlakError} If namespace not found
+     */
+    getNamespaceService(namespace) {
+        const service = this.namespaces.get(namespace);
+        if (!service) {
+            throw new UlakError(`Namespace "${namespace}" not found in Ulak`, UlakErrorCode.NAMESPACE_NOT_FOUND, namespace);
+        }
+        return service;
+    }
+};
+__decorate([
+    Inject(ICoreServiceNames.SERVER_LOGGER),
+    __metadata("design:type", Object)
+], Ulak.prototype, "logger", void 0);
+Ulak = __decorate([
+    CoreService(ICoreServiceNames.__ULAK__)
+], Ulak);
+export { Ulak };
+/**
+ * Internal implementation of scoped namespace
+ */
+class UlakNameSpace {
+    path;
+    ulak;
+    constructor(path, ulak) {
+        this.path = path;
+        this.ulak = ulak;
+    }
+    async broadcast(data) {
+        await this.ulak.broadcast(this.path, data);
+    }
+    async to(room, data) {
+        await this.ulak.to(this.path, room, data);
+    }
+    async toSocket(socketId, data) {
+        await this.ulak.toSocket(this.path, socketId, data);
+    }
+    async toMany(rooms, data) {
+        await this.ulak.toMany(this.path, rooms, data);
+    }
+    getSocketCount() {
+        return this.ulak.getSocketCount(this.path);
+    }
+}
+/**
+ * Helper function for injecting scoped Ulak namespace
+ *
+ * This function returns a tuple that can be used with the @Inject decorator
+ * to inject a scoped namespace from Ulak. This provides an ergonomic API
+ * where you don't need to repeat the namespace path in every method call.
+ *
+ * @param namespace - The WebSocket namespace path (e.g., "/chat", "/notifications")
+ * @returns A tuple of [serviceName, expression] for @Inject decorator
+ *
+ * @example
+ * ```typescript
+ * @Service('ChatService')
+ * export class ChatService {
+ *   // Inject scoped namespace
+ *   @Inject(ulak("/chat"))
+ *   private chat: Ulak.NameSpace<"/chat">;
+ *
+ *   async sendMessage(roomId: string, message: string) {
+ *     // Clean API - no need to repeat '/chat'
+ *     await this.chat.to(roomId, { message });
+ *   }
+ *
+ *   async broadcastAnnouncement(text: string) {
+ *     await this.chat.broadcast({ type: 'announcement', text });
+ *   }
+ * }
+ * ```
+ */
+export function ulak(namespace) {
+    return [ICoreServiceNames.__ULAK__, (ulak) => ulak.namespace(namespace)];
+}
+//# sourceMappingURL=Ulak.js.map

package/dist/lib/server/messaging/Ulak.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Ulak.js","sourceRoot":"","sources":["../../../../lib/server/messaging/Ulak.ts"],"names":[],"mappings":";;;;;;;;;AACA,OAAO,EAAE,WAAW,EAAqB,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9E,OAAO,EAAuC,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxF,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAqB,MAAM,cAAc,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;GAoBG;AAEI,IAAM,IAAI,GAAV,MAAM,IAAI;IACC,WAAW,GAAW,MAAM,CAAC;IAE7C;;OAEG;IAEK,MAAM,CAAe;IAE7B;;OAEG;IACK,UAAU,GAA4C,IAAI,GAAG,EAAE,CAAC;IAExE;;;OAGG;IACI,KAAK,CAAC,IAAI;QACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,gDAAgD,CAAC,CAAC;IACtF,CAAC;IAED;;;;;;OAMG;IACI,iBAAiB,CAAC,IAAY,EAAE,OAAmC;QACxE,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,IAAI,gCAAgC,CAAC,CAAC;YACvF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,IAAI,cAAc,CAAC,CAAC;IACvE,CAAC;IAED;;;;;OAKG;IACI,mBAAmB,CAAC,IAAY;QACrC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,iCAAiC,IAAI,eAAe,CAAC,CAAC;YACxF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,IAAI,gBAAgB,CAAC,CAAC;IACzE,CAAC;IAED;;;;;;;;;;;;OAYG;IACI,SAAS,CAAmB,IAAO;QACxC,OAAO,IAAI,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,SAAS,CAAC,SAAiB,EAAE,IAAS;QACjD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;YAEpD,wDAAwD;YACxD,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,oCAAoC,SAAS,GAAG,EAAE,KAAK,CAAC,CAAC;YAE5F,oEAAoE;YACpE,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;gBAC/B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,MAAM,IAAI,SAAS,CACjB,qCAAqC,SAAS,EAAE,EAChD,aAAa,CAAC,gBAAgB,EAC9B,SAAS,EACT,KAAc,CACf,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,EAAE,CAAC,SAAiB,EAAE,IAAY,EAAE,IAAS;QACxD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;YAEpD,qDAAqD;YACrD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,kBAAkB,IAAI,0BAA0B,SAAS,GAAG,EAAE,KAAK,CAAC,CAAC;YAExG,oEAAoE;YACpE,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;gBAC/B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,MAAM,IAAI,SAAS,CACjB,2BAA2B,IAAI,mBAAmB,SAAS,EAAE,EAC7D,aAAa,CAAC,WAAW,EACzB,SAAS,EACT,KAAc,CACf,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,QAAQ,CAAC,SAAiB,EAAE,QAAgB,EAAE,IAAS;QAClE,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;YAEpD,uCAAuC;YACvC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAE7C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,SAAS,CACjB,WAAW,QAAQ,6BAA6B,SAAS,GAAG,EAC5D,aAAa,CAAC,gBAAgB,EAC9B,SAAS,CACV,CAAC;YACJ,CAAC;YAED,sBAAsB;YACtB,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,oBAAoB,QAAQ,0BAA0B,SAAS,GAAG,EAAE,KAAK,CAAC,CAAC;YAE9G,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;gBAC/B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,MAAM,IAAI,SAAS,CACjB,6BAA6B,QAAQ,mBAAmB,SAAS,EAAE,EACnE,aAAa,CAAC,WAAW,EACzB,SAAS,EACT,KAAc,CACf,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,KAAe,EAAE,IAAS;QAC/D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAE9F,iBAAiB;QACjB,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;QAEhE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,GAAG,IAAI,CAAC,QAAQ,CAAC,0BAA0B,QAAQ,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,cAAc,SAAS,GAAG,CACrG,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,YAAY,CAAC,IAAS;QACjC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAE3F,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;QACzE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,MAAM,CAAC;QAErE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,sBAAsB,SAAS,eAAe,MAAM,SAAS,CAAC,CAAC;IACnG,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,QAAQ,CAAC,UAA2B;QAC/C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;YACpB,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;gBAChB,KAAK,WAAW;oBACd,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;gBAE/C,KAAK,MAAM;oBACT,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;wBACb,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC,CAAC;oBAC5E,CAAC;oBAED,OAAO,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;gBAEjD,KAAK,QAAQ;oBACX,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC;wBACjB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC,CAAC;oBAC9E,CAAC;oBAED,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;gBAE3D;oBACE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,2BAA4B,EAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACpF,CAAC;QACH,CAAC,CAAC,CACH,CAAC;QAEF,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;QACzE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,MAAM,CAAC;QAErE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,SAAS,IAAI,UAAU,CAAC,MAAM,eAAe,MAAM,SAAS,CAAC,CAAC;QAE/G,OAAO;YACL,KAAK,EAAE,UAAU,CAAC,MAAM;YACxB,SAAS;YACT,MAAM;YACN,OAAO;SACR,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,aAAa;QAClB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACI,YAAY,CAAC,SAAiB;QACnC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACI,cAAc,CAAC,SAAiB;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAE/C,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACI,OAAO;QACZ,4BAA4B;QAC5B,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QAEtD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACjD,CAAC;IAED;;;;;;OAMG;IACK,mBAAmB,CAAC,SAAiB;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAE/C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,SAAS,CAAC,cAAc,SAAS,qBAAqB,EAAE,aAAa,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;QAClH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF,CAAA;AAtTS;IADP,MAAM,CAAC,iBAAiB,CAAC,aAAa,CAAC;;oCACX;AAPlB,IAAI;IADhB,WAAW,CAAC,iBAAiB,CAAC,QAAQ,CAAC;GAC3B,IAAI,CA6ThB;;AAsDD;;GAEG;AACH,MAAM,aAAa;IAEC;IACC;IAFnB,YACkB,IAAO,EACN,IAAU;QADX,SAAI,GAAJ,IAAI,CAAG;QACN,SAAI,GAAJ,IAAI,CAAM;IAC1B,CAAC;IAEG,KAAK,CAAC,SAAS,CAAC,IAAS;QAC9B,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAEM,KAAK,CAAC,EAAE,CAAC,IAAY,EAAE,IAAS;QACrC,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;IAEM,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,IAAS;QAC/C,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IACtD,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,KAAe,EAAE,IAAS;QAC5C,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;IAEM,cAAc;QACnB,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,IAAI,CAAmB,SAAY;IACjD,OAAO,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC,IAAU,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAU,CAAC;AAC1F,CAAC"}

package/dist/lib/server/messaging/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Ulak WebSocket Messaging System
+ *
+ * Provides a centralized message broker for WebSocket communications
+ * without circular dependencies.
+ */
+export { Ulak, ulak } from './Ulak';
+export { UlakError, UlakErrorCode, type BulkOperation, type BulkResult, type BulkOperationType } from './types';

package/dist/lib/server/messaging/index.js

@@ -0,0 +1,9 @@
+/**
+ * Ulak WebSocket Messaging System
+ *
+ * Provides a centralized message broker for WebSocket communications
+ * without circular dependencies.
+ */
+export { Ulak, ulak } from './Ulak';
+export { UlakError, UlakErrorCode } from './types';
+//# sourceMappingURL=index.js.map

package/dist/lib/server/messaging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/server/messaging/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,aAAa,EAA+D,MAAM,SAAS,CAAC"}

package/dist/lib/server/messaging/types.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Error codes for Ulak messaging system
+ */
+export declare enum UlakErrorCode {
+    NAMESPACE_NOT_FOUND = "NAMESPACE_NOT_FOUND",
+    NAMESPACE_ALREADY_EXISTS = "NAMESPACE_ALREADY_EXISTS",
+    INVALID_NAMESPACE = "INVALID_NAMESPACE",
+    INVALID_MESSAGE = "INVALID_MESSAGE",
+    SEND_FAILED = "SEND_FAILED",
+    BROADCAST_FAILED = "BROADCAST_FAILED",
+    SOCKET_NOT_FOUND = "SOCKET_NOT_FOUND",
+    SERVICE_NOT_INITIALIZED = "SERVICE_NOT_INITIALIZED"
+}
+/**
+ * Custom error class for Ulak messaging system
+ * Provides structured error information with error codes
+ */
+export declare class UlakError extends Error {
+    readonly code: UlakErrorCode;
+    readonly namespace?: string;
+    readonly cause?: Error;
+    constructor(message: string, code: UlakErrorCode, namespace?: string, cause?: Error);
+}
+/**
+ * Operation types for bulk message sending
+ */
+export type BulkOperationType = 'broadcast' | 'room' | 'socket';
+/**
+ * A single operation in a bulk send
+ */
+export interface BulkOperation {
+    /**
+     * Type of operation
+     */
+    type: BulkOperationType;
+    /**
+     * Target namespace
+     */
+    namespace: string;
+    /**
+     * Room name (required for 'room' type)
+     */
+    room?: string;
+    /**
+     * Socket ID (required for 'socket' type)
+     */
+    socketId?: string;
+    /**
+     * Data to send
+     */
+    data: any;
+}
+/**
+ * Result of a bulk send operation
+ */
+export interface BulkResult {
+    /**
+     * Total number of operations attempted
+     */
+    total: number;
+    /**
+     * Number of successful operations
+     */
+    succeeded: number;
+    /**
+     * Number of failed operations
+     */
+    failed: number;
+    /**
+     * Detailed results for each operation
+     */
+    results: PromiseSettledResult<void>[];
+}