@asenajs/asena 0.3.3 → 0.5.0

package/dist/lib/server/decorators/components/Controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"Controller.js","sourceRoot":"","sources":["../../../../../lib/server/decorators/components/Controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAyB,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAInE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAkC,EAAkB,EAAE;IAC/E,MAAM,OAAO,GACX,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAE3G,OAAO,eAAe,CAAC,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE;QACnE,mBAAmB,CACjB,kBAAkB,CAAC,OAAO,EACzB,OAA4B,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,GAAG,EAC9D,MAAM,CACP,CAAC;QAEF,gBAAgB,CAAC,MAAM,EAAG,OAA4B,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QAE1E,mBAAmB,CACjB,kBAAkB,CAAC,cAAc,EAChC,OAA4B,CAAC,WAAW,IAAK,EAAwB,EACtE,MAAM,CACP,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}
+{"version":3,"file":"Controller.js","sourceRoot":"","sources":["../../../../../lib/server/decorators/components/Controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAyB,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAInE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAkC,EAAkB,EAAE;IAC/E,MAAM,OAAO,GACX,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAE3G,OAAO,eAAe,CAAC,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE;QACnE,mBAAmB,CACjB,kBAAkB,CAAC,OAAO,EACzB,OAA4B,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,GAAG,EAC9D,MAAM,CACP,CAAC;QAEF,gBAAgB,CAAC,MAAM,EAAG,OAA4B,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QAE1E,mBAAmB,CACjB,kBAAkB,CAAC,cAAc,EAChC,OAA4B,CAAC,WAAW,IAAK,EAAwB,EACtE,MAAM,CACP,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/lib/server/decorators/components/Middleware.js

@@ -1,6 +1,5 @@
 import { defineComponent } from '../../../ioc/component';
-import { ComponentType } from '../../../ioc/types';
-import { ComponentConstants } from '../../../ioc/constants';
+import { ComponentConstants, ComponentType } from '../../../ioc';
 import { defineTypedMetadata } from '../../../utils/typedMetadata';
 import { VALIDATOR_METHODS } from '../../../adapter';
 /**

package/dist/lib/server/decorators/components/Middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"Middleware.js","sourceRoot":"","sources":["../../../../../lib/server/decorators/components/Middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAyB,EAAkB,EAAE;IACtE,OAAO,eAAe,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QAClE,mBAAmB,CAAU,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,IAAI,KAAK,EAAE,MAAM,CAAC,CAAC;QAElG,IAAI,MAAM,EAAE,SAAS,EAAE,CAAC;YACtB,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,UAAU,CAAC,CAAC;YAE9G,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBACxB,OAAO,CAAC,KAAK,CACX,SAAS,MAAM,CAAC,IAAI,0DAA0D,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9G,CAAC;gBACF,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACzD,OAAO,CAAC,KAAK,CAAC,SAAS,MAAM,CAAC,IAAI,mDAAmD,CAAC,CAAC;YACvF,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}
+{"version":3,"file":"Middleware.js","sourceRoot":"","sources":["../../../../../lib/server/decorators/components/Middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAyB,EAAkB,EAAE;IACtE,OAAO,eAAe,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QAClE,mBAAmB,CAAU,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,IAAI,KAAK,EAAE,MAAM,CAAC,CAAC;QAElG,IAAI,MAAM,EAAE,SAAS,EAAE,CAAC;YACtB,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,UAAU,CAAC,CAAC;YAE9G,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBACxB,OAAO,CAAC,KAAK,CACX,SAAS,MAAM,CAAC,IAAI,0DAA0D,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9G,CAAC;gBACF,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACzD,OAAO,CAAC,KAAK,CAAC,SAAS,MAAM,CAAC,IAAI,mDAAmD,CAAC,CAAC;YACvF,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/lib/server/decorators/components/Schedule.d.ts

@@ -1,4 +1,4 @@
-import { type ScheduleParams } from '../../../ioc/types';
+import { type ScheduleParams } from '../../../ioc';
 /**
  * @deprecated Not working right now.
  *

package/dist/lib/server/decorators/components/Schedule.js

@@ -1,7 +1,6 @@
-import { ComponentType } from '../../../ioc/types';
+import { ComponentConstants, ComponentType } from '../../../ioc';
 import { defineComponent } from '../../../ioc/component';
 import { parseCron } from '../../../ioc/helper/cronParser';
-import { ComponentConstants } from '../../../ioc/constants';
 import { defineTypedMetadata } from '../../../utils/typedMetadata';
 /**
  * @deprecated Not working right now.

package/dist/lib/server/decorators/components/Schedule.js.map

@@ -1 +1 @@
-{"version":3,"file":"Schedule.js","sourceRoot":"","sources":["../../../../../lib/server/decorators/components/Schedule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAuB,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAmB,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,MAAsB,EAAkB,EAAE;IACjE,OAAO,eAAe,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QAChE,MAAM,UAAU,GAAG,SAAS,CAAE,MAAyB,CAAC,IAAI,CAAC,CAAC;QAE9D,mBAAmB,CAAa,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}
+{"version":3,"file":"Schedule.js","sourceRoot":"","sources":["../../../../../lib/server/decorators/components/Schedule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAuB,MAAM,cAAc,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAmB,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,MAAsB,EAAkB,EAAE;IACjE,OAAO,eAAe,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QAChE,MAAM,UAAU,GAAG,SAAS,CAAE,MAAyB,CAAC,IAAI,CAAC,CAAC;QAE9D,mBAAmB,CAAa,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/lib/server/decorators/components/WebSocket.d.ts

@@ -1,4 +1,4 @@
-import { type ControllerParams } from '../../../ioc/types';
+import { type ControllerParams } from '../../../ioc';
 /**
  * Decorator for defining a WebSocket component.
  *

package/dist/lib/server/decorators/components/WebSocket.js

@@ -1,6 +1,5 @@
-import { ComponentType } from '../../../ioc/types';
+import { ComponentConstants, ComponentType } from '../../../ioc';
 import { defineComponent } from '../../../ioc/component';
-import { ComponentConstants } from '../../../ioc/constants';
 import { defineMiddleware } from '../../web/helper';
 import { defineTypedMetadata } from '../../../utils/typedMetadata';
 /**

package/dist/lib/server/decorators/components/WebSocket.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebSocket.js","sourceRoot":"","sources":["../../../../../lib/server/decorators/components/WebSocket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAyB,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAInE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAiC,EAAkB,EAAE;IAC7E,OAAO,eAAe,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjE,IAAI,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;QAE7D,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAC5C,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,CAAC;QAED,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAEhC,mBAAmB,CAAS,kBAAkB,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAEtE,gBAAgB,CAAC,MAAM,EAAG,MAA2B,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QAEzE,mBAAmB,CACjB,kBAAkB,CAAC,cAAc,EAChC,MAA2B,CAAC,WAAW,IAAI,EAAE,EAC9C,MAAM,CACP,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}
+{"version":3,"file":"WebSocket.js","sourceRoot":"","sources":["../../../../../lib/server/decorators/components/WebSocket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAyB,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAInE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAiC,EAAkB,EAAE;IAC7E,OAAO,eAAe,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjE,IAAI,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;QAE7D,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAC5C,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,CAAC;QAED,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAEhC,mBAAmB,CAAS,kBAAkB,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAEtE,gBAAgB,CAAC,MAAM,EAAG,MAA2B,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QAEzE,mBAAmB,CACjB,kBAAkB,CAAC,cAAc,EAChC,MAA2B,CAAC,WAAW,IAAI,EAAE,EAC9C,MAAM,CACP,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

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

@@ -1,3 +1,5 @@
 export * from './components';
 export * from './Override';
 export * from './components/Config';
+export * from '../web/decorators/methods';
+export * from '../../ioc/component';

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

@@ -1,4 +1,6 @@
 export * from './components';
 export * from './Override';
 export * from './components/Config';
+export * from '../web/decorators/methods';
+export * from '../../ioc/component';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/server/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/server/decorators/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC"}

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

@@ -1 +1,4 @@
 export * from './AsenaServer';
+export * from './AsenaServerFactory';
+export { ICoreServiceNames } from '../ioc';
+export * from './messaging';

package/dist/lib/server/index.js

@@ -1,2 +1,6 @@
 export * from './AsenaServer';
+export * from './AsenaServerFactory';
+export { ICoreServiceNames } from '../ioc';
+// Ulak WebSocket Messaging System
+export * from './messaging';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAE3C,kCAAkC;AAClC,cAAc,aAAa,CAAC"}

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>];