@nestjs/websockets 11.1.16 → 12.0.0-alpha.1

package/errors/ws-exception.js

@@ -1,19 +1,17 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WsException = void 0;
-const shared_utils_1 = require("@nestjs/common/utils/shared.utils");
-class WsException extends Error {
+import { isObject, isString } from '@nestjs/common/internal';
+export class WsException extends Error {
+    error;
     constructor(error) {
         super();
         this.error = error;
         this.initMessage();
     }
     initMessage() {
-        if ((0, shared_utils_1.isString)(this.error)) {
+        if (isString(this.error)) {
             this.message = this.error;
         }
-        else if ((0, shared_utils_1.isObject)(this.error) &&
-            (0, shared_utils_1.isString)(this.error.message)) {
+        else if (isObject(this.error) &&
+            isString(this.error.message)) {
             this.message = this.error.message;
         }
         else if (this.constructor) {
@@ -26,4 +24,3 @@ class WsException extends Error {
         return this.error;
     }
 }
-exports.WsException = WsException;

package/exceptions/base-ws-exception-filter.d.ts

@@ -1,4 +1,4 @@
-import { ArgumentsHost, Logger, WsExceptionFilter } from '@nestjs/common';
+import { type ArgumentsHost, Logger, type WsExceptionFilter } from '@nestjs/common';
 export interface ErrorPayload<Cause = {
     pattern: string;
     data: unknown;

package/exceptions/base-ws-exception-filter.js

@@ -1,14 +1,13 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseWsExceptionFilter = void 0;
-const common_1 = require("@nestjs/common");
-const shared_utils_1 = require("@nestjs/common/utils/shared.utils");
-const constants_1 = require("@nestjs/core/constants");
-const ws_exception_1 = require("../errors/ws-exception");
+import { IntrinsicException, Logger, } from '@nestjs/common';
+import { WsException } from '../errors/ws-exception.js';
+import { isObject } from '@nestjs/common/internal';
+import { MESSAGES } from '@nestjs/core/internal';
 /**
  * @publicApi
  */
-class BaseWsExceptionFilter {
+export class BaseWsExceptionFilter {
+    options;
+    static logger = new Logger('WsExceptionsHandler');
     constructor(options = {}) {
         this.options = options;
         this.options.includeCause = this.options.includeCause ?? true;
@@ -25,12 +24,12 @@ class BaseWsExceptionFilter {
         });
     }
     handleError(client, exception, cause) {
-        if (!(exception instanceof ws_exception_1.WsException)) {
+        if (!(exception instanceof WsException)) {
             return this.handleUnknownError(exception, client, cause);
         }
         const status = 'error';
         const result = exception.getError();
-        if ((0, shared_utils_1.isObject)(result)) {
+        if (isObject(result)) {
             return client.emit('exception', result);
         }
         const payload = {
@@ -46,20 +45,18 @@ class BaseWsExceptionFilter {
         const status = 'error';
         const payload = {
             status,
-            message: constants_1.MESSAGES.UNKNOWN_EXCEPTION_MESSAGE,
+            message: MESSAGES.UNKNOWN_EXCEPTION_MESSAGE,
         };
         if (this.options?.includeCause && data) {
             payload.cause = this.options.causeFactory(data.pattern, data.data);
         }
         client.emit('exception', payload);
-        if (!(exception instanceof common_1.IntrinsicException)) {
+        if (!(exception instanceof IntrinsicException)) {
             const logger = BaseWsExceptionFilter.logger;
             logger.error(exception);
         }
     }
     isExceptionObject(err) {
-        return (0, shared_utils_1.isObject)(err) && !!err.message;
+        return isObject(err) && !!err.message;
     }
 }
-exports.BaseWsExceptionFilter = BaseWsExceptionFilter;
-BaseWsExceptionFilter.logger = new common_1.Logger('WsExceptionsHandler');

package/exceptions/index.d.ts

@@ -1 +1 @@
-export * from './base-ws-exception-filter';
+export * from './base-ws-exception-filter.js';

package/exceptions/index.js

@@ -1,4 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./base-ws-exception-filter"), exports);
+export * from './base-ws-exception-filter.js';

package/exceptions/ws-exceptions-handler.d.ts

@@ -1,7 +1,7 @@
-import { ArgumentsHost } from '@nestjs/common';
-import { ExceptionFilterMetadata } from '@nestjs/common/interfaces/exceptions/exception-filter-metadata.interface';
-import { WsException } from '../errors/ws-exception';
-import { BaseWsExceptionFilter } from './base-ws-exception-filter';
+import type { ArgumentsHost } from '@nestjs/common';
+import { WsException } from '../errors/ws-exception.js';
+import { BaseWsExceptionFilter } from './base-ws-exception-filter.js';
+import { type ExceptionFilterMetadata } from '@nestjs/common/internal';
 /**
  * @publicApi
  */

package/exceptions/ws-exceptions-handler.js

@@ -1,18 +1,11 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WsExceptionsHandler = void 0;
-const select_exception_filter_metadata_util_1 = require("@nestjs/common/utils/select-exception-filter-metadata.util");
-const shared_utils_1 = require("@nestjs/common/utils/shared.utils");
-const invalid_exception_filter_exception_1 = require("@nestjs/core/errors/exceptions/invalid-exception-filter.exception");
-const base_ws_exception_filter_1 = require("./base-ws-exception-filter");
+import { BaseWsExceptionFilter } from './base-ws-exception-filter.js';
+import { selectExceptionFilterMetadata, isEmptyArray, } from '@nestjs/common/internal';
+import { InvalidExceptionFilterException } from '@nestjs/core/internal';
 /**
  * @publicApi
  */
-class WsExceptionsHandler extends base_ws_exception_filter_1.BaseWsExceptionFilter {
-    constructor() {
-        super(...arguments);
-        this.filters = [];
-    }
+export class WsExceptionsHandler extends BaseWsExceptionFilter {
+    filters = [];
     handle(exception, host) {
         const client = host.switchToWs().getClient();
         if (this.invokeCustomFilters(exception, host) || !client.emit) {
@@ -22,16 +15,15 @@ class WsExceptionsHandler extends base_ws_exception_filter_1.BaseWsExceptionFilt
     }
     setCustomFilters(filters) {
         if (!Array.isArray(filters)) {
-            throw new invalid_exception_filter_exception_1.InvalidExceptionFilterException();
+            throw new InvalidExceptionFilterException();
         }
         this.filters = filters;
     }
     invokeCustomFilters(exception, args) {
-        if ((0, shared_utils_1.isEmpty)(this.filters))
+        if (isEmptyArray(this.filters))
             return false;
-        const filter = (0, select_exception_filter_metadata_util_1.selectExceptionFilterMetadata)(this.filters, exception);
+        const filter = selectExceptionFilterMetadata(this.filters, exception);
         filter && filter.func(exception, args);
         return !!filter;
     }
 }
-exports.WsExceptionsHandler = WsExceptionsHandler;

package/factories/server-and-event-streams-factory.d.ts

@@ -1,4 +1,4 @@
-import { ServerAndEventStreamsHost } from '../interfaces/server-and-event-streams-host.interface';
+import { ServerAndEventStreamsHost } from '../interfaces/server-and-event-streams-host.interface.js';
 export declare class ServerAndEventStreamsFactory {
     static create<T = any>(server: T): ServerAndEventStreamsHost<T>;
 }

package/factories/server-and-event-streams-factory.js

@@ -1,13 +1,10 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ServerAndEventStreamsFactory = void 0;
-const rxjs_1 = require("rxjs");
-class ServerAndEventStreamsFactory {
+import { ReplaySubject, Subject } from 'rxjs';
+export class ServerAndEventStreamsFactory {
     static create(server) {
-        const init = new rxjs_1.ReplaySubject();
+        const init = new ReplaySubject();
         init.next(server);
-        const connection = new rxjs_1.Subject();
-        const disconnect = new rxjs_1.Subject();
+        const connection = new Subject();
+        const disconnect = new Subject();
         return {
             init,
             connection,
@@ -16,4 +13,3 @@ class ServerAndEventStreamsFactory {
         };
     }
 }
-exports.ServerAndEventStreamsFactory = ServerAndEventStreamsFactory;

package/factories/ws-params-factory.js

@@ -1,24 +1,20 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WsParamsFactory = void 0;
-const shared_utils_1 = require("@nestjs/common/utils/shared.utils");
-const ws_paramtype_enum_1 = require("../enums/ws-paramtype.enum");
-class WsParamsFactory {
+import { WsParamtype } from '../enums/ws-paramtype.enum.js';
+import { isFunction } from '@nestjs/common/internal';
+export class WsParamsFactory {
     exchangeKeyForValue(type, data, args) {
         if (!args) {
             return null;
         }
         switch (type) {
-            case ws_paramtype_enum_1.WsParamtype.SOCKET:
+            case WsParamtype.SOCKET:
                 return args[0];
-            case ws_paramtype_enum_1.WsParamtype.PAYLOAD:
+            case WsParamtype.PAYLOAD:
                 return data ? args[1]?.[data] : args[1];
-            case ws_paramtype_enum_1.WsParamtype.ACK: {
-                return args.find(arg => (0, shared_utils_1.isFunction)(arg));
+            case WsParamtype.ACK: {
+                return args.find(arg => isFunction(arg));
             }
             default:
                 return null;
         }
     }
 }
-exports.WsParamsFactory = WsParamsFactory;

package/gateway-metadata-explorer.d.ts

@@ -1,6 +1,6 @@
-import { MetadataScanner } from '@nestjs/core/metadata-scanner';
 import { Observable } from 'rxjs';
-import { NestGateway } from './interfaces/nest-gateway.interface';
+import { NestGateway } from './interfaces/nest-gateway.interface.js';
+import type { MetadataScanner } from '@nestjs/core';
 export interface MessageMappingProperties {
     message: any;
     methodName: string;

package/gateway-metadata-explorer.js

@@ -1,14 +1,12 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GatewayMetadataExplorer = void 0;
-const shared_utils_1 = require("@nestjs/common/utils/shared.utils");
-const constants_1 = require("./constants");
-const ws_paramtype_enum_1 = require("./enums/ws-paramtype.enum");
-const context_utils_1 = require("@nestjs/core/helpers/context-utils");
-class GatewayMetadataExplorer {
+import { GATEWAY_SERVER_METADATA, MESSAGE_MAPPING_METADATA, MESSAGE_METADATA, PARAM_ARGS_METADATA, } from './constants.js';
+import { WsParamtype } from './enums/ws-paramtype.enum.js';
+import { isFunction, isUndefined } from '@nestjs/common/internal';
+import { ContextUtils } from '@nestjs/core/internal';
+export class GatewayMetadataExplorer {
+    metadataScanner;
+    contextUtils = new ContextUtils();
     constructor(metadataScanner) {
         this.metadataScanner = metadataScanner;
-        this.contextUtils = new context_utils_1.ContextUtils();
     }
     explore(instance) {
         const instancePrototype = Object.getPrototypeOf(instance);
@@ -19,11 +17,11 @@ class GatewayMetadataExplorer {
     }
     exploreMethodMetadata(instancePrototype, methodName) {
         const callback = instancePrototype[methodName];
-        const isMessageMapping = Reflect.getMetadata(constants_1.MESSAGE_MAPPING_METADATA, callback);
-        if ((0, shared_utils_1.isUndefined)(isMessageMapping)) {
+        const isMessageMapping = Reflect.getMetadata(MESSAGE_MAPPING_METADATA, callback);
+        if (isUndefined(isMessageMapping)) {
             return null;
         }
-        const message = Reflect.getMetadata(constants_1.MESSAGE_METADATA, callback);
+        const message = Reflect.getMetadata(MESSAGE_METADATA, callback);
         const isAckHandledManually = this.hasAckDecorator(instancePrototype, methodName);
         return {
             callback,
@@ -33,27 +31,26 @@ class GatewayMetadataExplorer {
         };
     }
     hasAckDecorator(instancePrototype, methodName) {
-        const paramsMetadata = Reflect.getMetadata(constants_1.PARAM_ARGS_METADATA, instancePrototype.constructor, methodName);
+        const paramsMetadata = Reflect.getMetadata(PARAM_ARGS_METADATA, instancePrototype.constructor, methodName);
         if (!paramsMetadata) {
             return false;
         }
         const metadataKeys = Object.keys(paramsMetadata);
         return metadataKeys.some(key => {
             const type = this.contextUtils.mapParamType(key);
-            return Number(type) === ws_paramtype_enum_1.WsParamtype.ACK;
+            return Number(type) === WsParamtype.ACK;
         });
     }
     *scanForServerHooks(instance) {
         for (const propertyKey in instance) {
-            if ((0, shared_utils_1.isFunction)(propertyKey)) {
+            if (isFunction(propertyKey)) {
                 continue;
             }
             const property = String(propertyKey);
-            const isServer = Reflect.getMetadata(constants_1.GATEWAY_SERVER_METADATA, instance, property);
-            if (!(0, shared_utils_1.isUndefined)(isServer)) {
+            const isServer = Reflect.getMetadata(GATEWAY_SERVER_METADATA, instance, property);
+            if (!isUndefined(isServer)) {
                 yield property;
             }
         }
     }
 }
-exports.GatewayMetadataExplorer = GatewayMetadataExplorer;

package/index.d.ts

@@ -1,7 +1,7 @@
 import 'reflect-metadata';
-export * from './adapters';
-export * from './decorators';
-export * from './errors';
-export * from './exceptions';
-export { MessageMappingProperties } from './gateway-metadata-explorer';
-export * from './interfaces';
+export * from './adapters/index.js';
+export * from './decorators/index.js';
+export * from './errors/index.js';
+export * from './exceptions/index.js';
+export { MessageMappingProperties } from './gateway-metadata-explorer.js';
+export * from './interfaces/index.js';

package/index.js

@@ -1,15 +1,12 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
 /*
  * Nest @websockets
  * Copyright(c) 2017 - 2025 Kamil Mysliwiec
  * https://nestjs.com
  * MIT Licensed
  */
-require("reflect-metadata");
-tslib_1.__exportStar(require("./adapters"), exports);
-tslib_1.__exportStar(require("./decorators"), exports);
-tslib_1.__exportStar(require("./errors"), exports);
-tslib_1.__exportStar(require("./exceptions"), exports);
-tslib_1.__exportStar(require("./interfaces"), exports);
+import 'reflect-metadata';
+export * from './adapters/index.js';
+export * from './decorators/index.js';
+export * from './errors/index.js';
+export * from './exceptions/index.js';
+export * from './interfaces/index.js';

package/interfaces/gateway-metadata.interface.d.ts

@@ -1,4 +1,4 @@
-import { CorsOptions } from '@nestjs/common/interfaces/external/cors-options.interface';
+import type { CorsOptions } from '@nestjs/common/internal';
 /**
  * External interface
  * @see https://github.com/socketio/socket.io/blob/master/lib/index.ts

package/interfaces/gateway-metadata.interface.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/interfaces/hooks/index.d.ts

@@ -1,3 +1,3 @@
-export * from './on-gateway-connection.interface';
-export * from './on-gateway-disconnect.interface';
-export * from './on-gateway-init.interface';
+export * from './on-gateway-connection.interface.js';
+export * from './on-gateway-disconnect.interface.js';
+export * from './on-gateway-init.interface.js';

package/interfaces/hooks/index.js

@@ -1,6 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./on-gateway-connection.interface"), exports);
-tslib_1.__exportStar(require("./on-gateway-disconnect.interface"), exports);
-tslib_1.__exportStar(require("./on-gateway-init.interface"), exports);
+export * from './on-gateway-connection.interface.js';
+export * from './on-gateway-disconnect.interface.js';
+export * from './on-gateway-init.interface.js';

package/interfaces/hooks/on-gateway-connection.interface.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/interfaces/hooks/on-gateway-disconnect.interface.d.ts

@@ -2,5 +2,5 @@
  * @publicApi
  */
 export interface OnGatewayDisconnect<T = any> {
-    handleDisconnect(client: T): any;
+    handleDisconnect(client: T, reason?: string): any;
 }

package/interfaces/hooks/on-gateway-disconnect.interface.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/interfaces/hooks/on-gateway-init.interface.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/interfaces/index.d.ts

@@ -1,5 +1,5 @@
-export * from './gateway-metadata.interface';
-export * from './hooks';
-export * from './server-and-event-streams-host.interface';
-export * from './web-socket-server.interface';
-export * from './ws-response.interface';
+export * from './gateway-metadata.interface.js';
+export * from './hooks/index.js';
+export * from './server-and-event-streams-host.interface.js';
+export * from './web-socket-server.interface.js';
+export * from './ws-response.interface.js';

package/interfaces/index.js

@@ -1,8 +1,5 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./gateway-metadata.interface"), exports);
-tslib_1.__exportStar(require("./hooks"), exports);
-tslib_1.__exportStar(require("./server-and-event-streams-host.interface"), exports);
-tslib_1.__exportStar(require("./web-socket-server.interface"), exports);
-tslib_1.__exportStar(require("./ws-response.interface"), exports);
+export * from './gateway-metadata.interface.js';
+export * from './hooks/index.js';
+export * from './server-and-event-streams-host.interface.js';
+export * from './web-socket-server.interface.js';
+export * from './ws-response.interface.js';

package/interfaces/nest-gateway.interface.d.ts

@@ -4,5 +4,5 @@
 export interface NestGateway {
     afterInit?: (server: any) => void;
     handleConnection?: (...args: any[]) => void;
-    handleDisconnect?: (client: any) => void;
+    handleDisconnect?: (client: any, reason?: string) => void;
 }

package/interfaces/nest-gateway.interface.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/interfaces/server-and-event-streams-host.interface.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/interfaces/web-socket-server.interface.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/interfaces/websockets-entrypoint-metadata.interface.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/interfaces/ws-response.interface.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/internal.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Internal module - not part of the public API.
+ * These exports are used by sibling @nestjs packages.
+ * Do not depend on these in your application code.
+ * @internal
+ * @module
+ */
+export * from './constants.js';

package/internal.js

@@ -0,0 +1,8 @@
+/**
+ * Internal module - not part of the public API.
+ * These exports are used by sibling @nestjs packages.
+ * Do not depend on these in your application code.
+ * @internal
+ * @module
+ */
+export * from './constants.js';

package/package.json

@@ -1,9 +1,23 @@
 {
   "name": "@nestjs/websockets",
-  "version": "11.1.16",
+  "version": "12.0.0-alpha.1",
   "description": "Nest - modern, fast, powerful node.js web framework (@websockets)",
   "author": "Kamil Mysliwiec",
   "license": "MIT",
+  "type": "module",
+  "main": "./index.js",
+  "exports": {
+    ".": "./index.js",
+    "./*.js": "./*.js",
+    "./*": "./*.js",
+    "./adapters": "./adapters/index.js",
+    "./decorators": "./decorators/index.js",
+    "./errors": "./errors/index.js",
+    "./exceptions": "./exceptions/index.js",
+    "./interfaces": "./interfaces/index.js",
+    "./interfaces/hooks": "./interfaces/hooks/index.js",
+    "./utils": "./utils/index.js"
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/nestjs/nest.git",
@@ -18,8 +32,8 @@
     "tslib": "2.8.1"
   },
   "devDependencies": {
-    "@nestjs/common": "11.1.16",
-    "@nestjs/core": "11.1.16"
+    "@nestjs/common": "^12.0.0-alpha.1",
+    "@nestjs/core": "^12.0.0-alpha.1"
   },
   "peerDependencies": {
     "@nestjs/common": "^11.0.0",
@@ -33,5 +47,5 @@
       "optional": true
     }
   },
-  "gitHead": "315e698096208868b43dda25f2db9ac9d7c1d822"
+  "gitHead": "7035ecc828a2a9f752aad188871b1171663a20c2"
 }

package/socket-module.d.ts

@@ -1,10 +1,7 @@
-import { InjectionToken } from '@nestjs/common/interfaces';
-import { Injectable } from '@nestjs/common/interfaces/injectable.interface';
-import { NestApplicationContextOptions } from '@nestjs/common/interfaces/nest-application-context-options.interface';
-import { ApplicationConfig } from '@nestjs/core/application-config';
-import { NestContainer } from '@nestjs/core/injector/container';
-import { InstanceWrapper } from '@nestjs/core/injector/instance-wrapper';
-import { GraphInspector } from '@nestjs/core/inspector/graph-inspector';
+import type { InjectionToken } from '@nestjs/common';
+import type { Injectable, NestApplicationContextOptions } from '@nestjs/common/internal';
+import type { ApplicationConfig, NestContainer, GraphInspector } from '@nestjs/core';
+import { type InstanceWrapper } from '@nestjs/core/internal';
 export declare class SocketModule<THttpServer = any, TAppOptions extends NestApplicationContextOptions = NestApplicationContextOptions> {
     private readonly socketsContainer;
     private applicationConfig;
@@ -14,7 +11,7 @@ export declare class SocketModule<THttpServer = any, TAppOptions extends NestApp
     private appOptions;
     register(container: NestContainer, applicationConfig: ApplicationConfig, graphInspector: GraphInspector, appOptions: TAppOptions, httpServer?: THttpServer): void;
     connectAllGateways(providers: Map<InjectionToken, InstanceWrapper<Injectable>>, moduleName: string): void;
-    connectGatewayToServer(wrapper: InstanceWrapper<Injectable>, moduleName: string): void;
+    connectGatewayToServer(wrapper: InstanceWrapper<Injectable>, moduleName: string): Promise<void>;
     close(): Promise<any>;
     private initializeAdapter;
     private getContextCreator;