nlcurl 0.3.1 → 0.5.0

package/dist/utils/logger.d.ts

@@ -4,33 +4,72 @@
  *
  * @typedef {'debug' | 'info' | 'warn' | 'error' | 'silent'} LogLevel
  */
-export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+export type LogLevel = "debug" | "info" | "warn" | "error" | "silent";
+/**
+ * Key-value metadata attached to every log entry produced by a child logger.
+ * Bindings are inherited from parent to child, allowing nested scoping.
+ *
+ * @typedef {Record<string, unknown>} LogBindings
+ */
+export type LogBindings = Record<string, unknown>;
 /**
  * Minimal logger interface consumed throughout the library. Implementations
  * must provide four severity methods; all parameters follow `console.log`
  * semantics (a primary message string followed by optional extra values).
  */
 export interface Logger {
+    /** Emits a diagnostic message useful only during development. */
     debug(message: string, ...args: unknown[]): void;
+    /** Emits a significant lifecycle or business event. */
     info(message: string, ...args: unknown[]): void;
+    /** Emits a warning about an unexpected but recoverable condition. */
     warn(message: string, ...args: unknown[]): void;
+    /** Emits an error indicating an operation failure that requires attention. */
     error(message: string, ...args: unknown[]): void;
 }
 /**
  * Default {@link Logger} implementation that writes to `process.stderr`.
  * Messages are prefixed with `[nlcurl:<level>]` and only emitted when the
  * message severity meets or exceeds the configured `level`.
+ *
+ * Supports scoped child loggers via {@link ConsoleLogger.child}, which
+ * prepend a component tag to every message for easy filtering.
  */
 export declare class ConsoleLogger implements Logger {
     private level;
+    private readonly prefix;
+    private readonly bindings;
     /**
      * Creates a new ConsoleLogger.
      *
-     * @param {LogLevel} [level='warn'] - Minimum severity level to emit.
+     * @param {LogLevel}    [level='warn'] - Minimum severity level to emit.
+     * @param {string}      [prefix='']    - Component prefix prepended to every message.
+     * @param {LogBindings} [bindings={}]  - Key-value metadata appended to every message.
+     */
+    constructor(level?: LogLevel, prefix?: string, bindings?: LogBindings);
+    /**
+     * Creates a child logger that inherits this logger's level and prepends
+     * an additional component tag to every message. Bindings from the parent
+     * are merged with the child's bindings (child values win on conflict).
+     *
+     * @param {LogBindings} bindings - Additional metadata for the child scope.
+     * @returns {ConsoleLogger} A new scoped logger instance.
+     *
+     * @example
+     * const logger = new ConsoleLogger('debug');
+     * const child = logger.child({ component: 'h2' });
+     * child.debug('stream opened', { streamId: 1 });
+     */
+    child(bindings: LogBindings): ConsoleLogger;
+    /**
+     * Updates the minimum severity level at runtime without creating a new
+     * logger instance.
+     *
+     * @param {LogLevel} level - New minimum severity level.
      */
-    constructor(level?: LogLevel);
+    setLevel(level: LogLevel): void;
     /**
-     * Emits a debug-level message to `stderr` — only written when the
+     * Emits a debug-level message to `stderr` -- only written when the
      * configured minimum level is `'debug'`.
      *
      * @param {string}    message - Primary log message.
@@ -38,7 +77,7 @@ export declare class ConsoleLogger implements Logger {
      */
     debug(message: string, ...args: unknown[]): void;
     /**
-     * Emits an info-level message to `stderr` — only written when the
+     * Emits an info-level message to `stderr` -- only written when the
      * configured minimum level is `'debug'` or `'info'`.
      *
      * @param {string}    message - Primary log message.
@@ -46,7 +85,7 @@ export declare class ConsoleLogger implements Logger {
      */
     info(message: string, ...args: unknown[]): void;
     /**
-     * Emits a warn-level message to `stderr` — only written when the
+     * Emits a warn-level message to `stderr` -- only written when the
      * configured minimum level is `'debug'`, `'info'`, or `'warn'`.
      *
      * @param {string}    message - Primary log message.
@@ -54,14 +93,16 @@ export declare class ConsoleLogger implements Logger {
      */
     warn(message: string, ...args: unknown[]): void;
     /**
-     * Emits an error-level message to `stderr` — only written when the
+     * Emits an error-level message to `stderr` -- only written when the
      * configured minimum level is not `'silent'`.
      *
      * @param {string}    message - Primary log message.
      * @param {...unknown} args   - Additional values appended after the message.
      */
     error(message: string, ...args: unknown[]): void;
+    private write;
     private formatArgs;
+    private resolveLevel;
 }
 /**
  * A no-op {@link Logger} that discards all messages. Assign this via

package/dist/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAUtE;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClD;AAED;;;;GAIG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C,OAAO,CAAC,KAAK,CAAS;IAEtB;;;;OAIG;gBACS,KAAK,GAAE,QAAiB;IAIpC;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD,OAAO,CAAC,UAAU;CAInB;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAK3B,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAErD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAUlD;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB,iEAAiE;IACjE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,uDAAuD;IACvD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,qEAAqE;IACrE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,8EAA8E;IAC9E,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClD;AAED;;;;;;;GAOG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IAEvC;;;;;;OAMG;gBACS,KAAK,GAAE,QAAiB,EAAE,MAAM,GAAE,MAAW,EAAE,QAAQ,GAAE,WAAgB;IAMrF;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,QAAQ,EAAE,WAAW,GAAG,aAAa;IAO3C;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,YAAY;CAMrB;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAK3B,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAErD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/dist/utils/logger.js

@@ -9,19 +9,56 @@ const LEVEL_ORDER = {
  * Default {@link Logger} implementation that writes to `process.stderr`.
  * Messages are prefixed with `[nlcurl:<level>]` and only emitted when the
  * message severity meets or exceeds the configured `level`.
+ *
+ * Supports scoped child loggers via {@link ConsoleLogger.child}, which
+ * prepend a component tag to every message for easy filtering.
  */
 export class ConsoleLogger {
     level;
+    prefix;
+    bindings;
     /**
      * Creates a new ConsoleLogger.
      *
-     * @param {LogLevel} [level='warn'] - Minimum severity level to emit.
+     * @param {LogLevel}    [level='warn'] - Minimum severity level to emit.
+     * @param {string}      [prefix='']    - Component prefix prepended to every message.
+     * @param {LogBindings} [bindings={}]  - Key-value metadata appended to every message.
+     */
+    constructor(level = "warn", prefix = "", bindings = {}) {
+        this.level = LEVEL_ORDER[level];
+        this.prefix = prefix;
+        this.bindings = bindings;
+    }
+    /**
+     * Creates a child logger that inherits this logger's level and prepends
+     * an additional component tag to every message. Bindings from the parent
+     * are merged with the child's bindings (child values win on conflict).
+     *
+     * @param {LogBindings} bindings - Additional metadata for the child scope.
+     * @returns {ConsoleLogger} A new scoped logger instance.
+     *
+     * @example
+     * const logger = new ConsoleLogger('debug');
+     * const child = logger.child({ component: 'h2' });
+     * child.debug('stream opened', { streamId: 1 });
      */
-    constructor(level = 'warn') {
+    child(bindings) {
+        const component = typeof bindings["component"] === "string" ? bindings["component"] : "";
+        const childPrefix = this.prefix ? (component ? `${this.prefix}:${component}` : this.prefix) : component;
+        const merged = { ...this.bindings, ...bindings };
+        return new ConsoleLogger(this.resolveLevel(), childPrefix, merged);
+    }
+    /**
+     * Updates the minimum severity level at runtime without creating a new
+     * logger instance.
+     *
+     * @param {LogLevel} level - New minimum severity level.
+     */
+    setLevel(level) {
         this.level = LEVEL_ORDER[level];
     }
     /**
-     * Emits a debug-level message to `stderr` — only written when the
+     * Emits a debug-level message to `stderr` -- only written when the
      * configured minimum level is `'debug'`.
      *
      * @param {string}    message - Primary log message.
@@ -29,11 +66,11 @@ export class ConsoleLogger {
      */
     debug(message, ...args) {
         if (this.level <= LEVEL_ORDER.debug) {
-            process.stderr.write(`[nlcurl:debug] ${message}${this.formatArgs(args)}\n`);
+            this.write("debug", message, args);
         }
     }
     /**
-     * Emits an info-level message to `stderr` — only written when the
+     * Emits an info-level message to `stderr` -- only written when the
      * configured minimum level is `'debug'` or `'info'`.
      *
      * @param {string}    message - Primary log message.
@@ -41,11 +78,11 @@ export class ConsoleLogger {
      */
     info(message, ...args) {
         if (this.level <= LEVEL_ORDER.info) {
-            process.stderr.write(`[nlcurl:info] ${message}${this.formatArgs(args)}\n`);
+            this.write("info", message, args);
         }
     }
     /**
-     * Emits a warn-level message to `stderr` — only written when the
+     * Emits a warn-level message to `stderr` -- only written when the
      * configured minimum level is `'debug'`, `'info'`, or `'warn'`.
      *
      * @param {string}    message - Primary log message.
@@ -53,11 +90,11 @@ export class ConsoleLogger {
      */
     warn(message, ...args) {
         if (this.level <= LEVEL_ORDER.warn) {
-            process.stderr.write(`[nlcurl:warn] ${message}${this.formatArgs(args)}\n`);
+            this.write("warn", message, args);
         }
     }
     /**
-     * Emits an error-level message to `stderr` — only written when the
+     * Emits an error-level message to `stderr` -- only written when the
      * configured minimum level is not `'silent'`.
      *
      * @param {string}    message - Primary log message.
@@ -65,13 +102,24 @@ export class ConsoleLogger {
      */
     error(message, ...args) {
         if (this.level <= LEVEL_ORDER.error) {
-            process.stderr.write(`[nlcurl:error] ${message}${this.formatArgs(args)}\n`);
+            this.write("error", message, args);
         }
     }
+    write(level, message, args) {
+        const tag = this.prefix ? `nlcurl:${this.prefix}:${level}` : `nlcurl:${level}`;
+        process.stderr.write(`[${tag}] ${message}${this.formatArgs(args)}\n`);
+    }
     formatArgs(args) {
         if (args.length === 0)
-            return '';
-        return ' ' + args.map((a) => (typeof a === 'string' ? a : JSON.stringify(a))).join(' ');
+            return "";
+        return " " + args.map((a) => (typeof a === "string" ? a : JSON.stringify(a))).join(" ");
+    }
+    resolveLevel() {
+        for (const [name, order] of Object.entries(LEVEL_ORDER)) {
+            if (order === this.level)
+                return name;
+        }
+        return "warn";
     }
 }
 /**
@@ -84,7 +132,7 @@ export const SILENT_LOGGER = {
     warn() { },
     error() { },
 };
-let _default = new ConsoleLogger('warn');
+let _default = new ConsoleLogger("warn");
 /**
  * Replaces the process-wide default logger used by all NLcURL internals.
  *

package/dist/utils/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,GAA6B;IAC5C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;CACV,CAAC;AAcF;;;;GAIG;AACH,MAAM,OAAO,aAAa;IAChB,KAAK,CAAS;IAEtB;;;;OAIG;IACH,YAAY,QAAkB,MAAM;QAClC,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;YACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC;YACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC;YACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;YACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAEO,UAAU,CAAC,IAAe;QAChC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACjC,OAAO,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1F,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAW;IACnC,KAAK,KAAI,CAAC;IACV,IAAI,KAAI,CAAC;IACT,IAAI,KAAI,CAAC;IACT,KAAK,KAAI,CAAC;CACX,CAAC;AAEF,IAAI,QAAQ,GAAW,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;AAEjD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,QAAQ,GAAG,MAAM,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"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"}

package/dist/utils/url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO7E;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACjD,MAAM,CASR;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAEzC;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI5C;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAOpE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG/C"}
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO7E;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,MAAM,CASpG;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAEzC;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI5C;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAOpE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG/C"}

package/dist/utils/url.js

@@ -55,7 +55,7 @@ export function parseURL(raw) {
  */
 export function originOf(url) {
     const u = new URL(url);
-    const port = u.port || (u.protocol === 'https:' ? '443' : '80');
+    const port = u.port || (u.protocol === "https:" ? "443" : "80");
     return `${u.protocol}//${u.hostname}:${port}`;
 }
 /**
@@ -76,7 +76,7 @@ export function sniHost(url) {
  */
 export function hostPort(url) {
     const u = new URL(url);
-    const defaultPort = u.protocol === 'https:' ? 443 : 80;
+    const defaultPort = u.protocol === "https:" ? 443 : 80;
     return {
         host: u.hostname,
         port: u.port ? parseInt(u.port, 10) : defaultPort,

package/dist/utils/url.js.map

@@ -1 +1 @@
-{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,IAAwB,EAAE,QAAgB;IACnE,IAAI,CAAC,IAAI;QAAE,OAAO,QAAQ,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,GAAW,EACX,MAAkD;IAElD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAE5D,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QACpD,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;AACtB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAChE,OAAO,GAAG,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;AAC/B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,MAAM,WAAW,GAAG,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,QAAQ;QAChB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW;KAClD,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,OAAO,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,IAAwB,EAAE,QAAgB;IACnE,IAAI,CAAC,IAAI;QAAE,OAAO,QAAQ,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,MAAkD;IAC1F,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAE5D,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QACpD,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;AACtB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAChE,OAAO,GAAG,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;AAC/B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,MAAM,WAAW,GAAG,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,QAAQ;QAChB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW;KAClD,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,OAAO,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;AAC/B,CAAC"}

package/dist/ws/client.d.ts

@@ -1,4 +1,4 @@
-import { EventEmitter } from 'node:events';
+import { EventEmitter } from "node:events";
 /**
  * Options for creating a {@link WebSocketClient} connection.
  *
@@ -23,7 +23,7 @@ export interface WebSocketOptions {
  *
  * @typedef {'connecting' | 'open' | 'closing' | 'closed'} WebSocketState
  */
-export type WebSocketState = 'connecting' | 'open' | 'closing' | 'closed';
+export type WebSocketState = "connecting" | "open" | "closing" | "closed";
 /**
  * Typed event map for {@link WebSocketClient}.
  *

package/dist/ws/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/ws/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAiB3C;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE1E;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,EAAE,CAAC;IACT,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpD,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACtB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,eAAgB,SAAQ,YAAY;IACxC,KAAK,EAAE,cAAc,CAAgB;IACrC,QAAQ,SAAM;IACrB,SAAgB,GAAG,EAAE,MAAM,CAAC;IAE5B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,cAAc,CAAuB;IAE7C;;;;;OAKG;gBACS,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB;IAUvD;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM5B;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK9B;;;;;OAKG;IACH,IAAI,CAAC,IAAI,GAAE,MAAwB,GAAG,IAAI;IAK1C;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,SAAO,EAAE,MAAM,SAAK,GAAG,IAAI;IAYrC,OAAO,CAAC,UAAU;YAMJ,OAAO;IAkErB,OAAO,CAAC,cAAc;IAyGtB,OAAO,CAAC,MAAM;IAKd,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,WAAW;CAwDpB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/ws/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAW3C;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE1E;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,EAAE,CAAC;IACT,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpD,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACtB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,eAAgB,SAAQ,YAAY;IACxC,KAAK,EAAE,cAAc,CAAgB;IACrC,QAAQ,SAAM;IACrB,SAAgB,GAAG,EAAE,MAAM,CAAC;IAE5B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,cAAc,CAAuB;IAE7C;;;;;OAKG;gBACS,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB;IAWvD;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM5B;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK9B;;;;;OAKG;IACH,IAAI,CAAC,IAAI,GAAE,MAAwB,GAAG,IAAI;IAK1C;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,SAAO,EAAE,MAAM,SAAK,GAAG,IAAI;IAYrC,OAAO,CAAC,UAAU;YAMJ,OAAO;IA4DrB,OAAO,CAAC,cAAc;IAqGtB,OAAO,CAAC,MAAM;IAKd,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,WAAW;CAwDpB"}

package/dist/ws/client.js

@@ -1,9 +1,10 @@
-import { EventEmitter } from 'node:events';
-import { NodeTLSEngine } from '../tls/node-engine.js';
-import { StealthTLSEngine } from '../tls/stealth/engine.js';
-import { getProfile } from '../fingerprints/database.js';
-import { NLcURLError, ConnectionError } from '../core/errors.js';
-import { encodeFrame, FrameParser, Opcode, generateWebSocketKey, computeAcceptKey, } from './frame.js';
+import { EventEmitter } from "node:events";
+import { NodeTLSEngine } from "../tls/node-engine.js";
+import { StealthTLSEngine } from "../tls/stealth/engine.js";
+import { getProfile } from "../fingerprints/database.js";
+import { NLcURLError, ConnectionError } from "../core/errors.js";
+import { validateWebSocketUrl } from "../core/validation.js";
+import { encodeFrame, FrameParser, Opcode, generateWebSocketKey, computeAcceptKey } from "./frame.js";
 /**
  * WebSocket client with optional browser fingerprint impersonation. Emits
  * typed lifecycle events (`open`, `message`, `close`, `error`, `ping`, `pong`).
@@ -16,8 +17,8 @@ import { encodeFrame, FrameParser, Opcode, generateWebSocketKey, computeAcceptKe
  * ws.on('message', (data) => console.log(data));
  */
 export class WebSocketClient extends EventEmitter {
-    state = 'connecting';
-    protocol = '';
+    state = "connecting";
+    protocol = "";
     url;
     socket = null;
     parser = new FrameParser();
@@ -31,10 +32,11 @@ export class WebSocketClient extends EventEmitter {
      */
     constructor(url, options = {}) {
         super();
+        validateWebSocketUrl(url);
         this.url = url;
         this.connect(url, options).catch((err) => {
-            this.state = 'closed';
-            this.emit('error', err);
+            this.state = "closed";
+            this.emit("error", err);
         });
     }
     /**
@@ -45,7 +47,7 @@ export class WebSocketClient extends EventEmitter {
      */
     sendText(data) {
         this.assertOpen();
-        const payload = Buffer.from(data, 'utf8');
+        const payload = Buffer.from(data, "utf8");
         this.socket.write(encodeFrame(Opcode.TEXT, payload));
     }
     /**
@@ -75,73 +77,67 @@ export class WebSocketClient extends EventEmitter {
      * @param {number} [code=1000]  - WebSocket close status code.
      * @param {string} [reason=''] - Human-readable close reason (UTF-8, max 123 bytes).
      */
-    close(code = 1000, reason = '') {
-        if (this.state !== 'open')
+    close(code = 1000, reason = "") {
+        if (this.state !== "open")
             return;
-        this.state = 'closing';
-        const reasonBuf = Buffer.from(reason, 'utf8');
+        this.state = "closing";
+        const reasonBuf = Buffer.from(reason, "utf8");
         const payload = Buffer.allocUnsafe(2 + reasonBuf.length);
         payload.writeUInt16BE(code, 0);
         reasonBuf.copy(payload, 2);
         this.socket.write(encodeFrame(Opcode.CLOSE, payload));
     }
     assertOpen() {
-        if (this.state !== 'open') {
-            throw new NLcURLError('WebSocket is not open', 'ERR_WS_NOT_OPEN');
+        if (this.state !== "open") {
+            throw new NLcURLError("WebSocket is not open", "ERR_WS_NOT_OPEN");
         }
     }
     async connect(url, options) {
         const parsed = new URL(url);
-        const isSecure = parsed.protocol === 'wss:';
-        const port = parsed.port
-            ? parseInt(parsed.port, 10)
-            : isSecure ? 443 : 80;
+        const isSecure = parsed.protocol === "wss:";
+        const port = parsed.port ? parseInt(parsed.port, 10) : isSecure ? 443 : 80;
         const host = parsed.hostname;
-        const profile = options.impersonate
-            ? getProfile(options.impersonate) ?? undefined
-            : undefined;
+        const profile = options.impersonate ? (getProfile(options.impersonate) ?? undefined) : undefined;
         let transport;
         if (isSecure) {
-            const engine = options.stealth
-                ? new StealthTLSEngine()
-                : new NodeTLSEngine();
+            const engine = options.stealth ? new StealthTLSEngine() : new NodeTLSEngine();
             const tlsOpts = {
                 host,
                 port,
                 servername: host,
                 insecure: options.insecure ?? false,
-                alpnProtocols: ['http/1.1'],
+                alpnProtocols: ["http/1.1"],
                 timeout: options.timeout,
             };
             const tlsSocket = await engine.connect(tlsOpts, profile);
             transport = tlsSocket;
         }
         else {
-            const net = await import('node:net');
+            const net = await import("node:net");
             transport = await new Promise((resolve, reject) => {
                 const sock = net.createConnection({ host, port }, () => resolve(sock));
-                sock.once('error', reject);
+                sock.once("error", reject);
                 if (options.timeout) {
                     sock.setTimeout(options.timeout, () => {
                         sock.destroy();
-                        reject(new ConnectionError('WebSocket connection timed out'));
+                        reject(new ConnectionError("WebSocket connection timed out"));
                     });
                 }
             });
         }
         this.socket = transport;
         await this.performUpgrade(transport, parsed, options);
-        this.state = 'open';
-        this.emit('open');
-        transport.on('data', (chunk) => this.onData(chunk));
-        transport.on('error', (err) => {
-            this.state = 'closed';
-            this.emit('error', err);
+        this.state = "open";
+        this.emit("open");
+        transport.on("data", (chunk) => this.onData(chunk));
+        transport.on("error", (err) => {
+            this.state = "closed";
+            this.emit("error", err);
         });
-        transport.on('close', () => {
-            if (this.state !== 'closed') {
-                this.state = 'closed';
-                this.emit('close', 1006, 'Connection lost');
+        transport.on("close", () => {
+            if (this.state !== "closed") {
+                this.state = "closed";
+                this.emit("close", 1006, "Connection lost");
             }
         });
         this.drainBufferedFrames();
@@ -149,7 +145,7 @@ export class WebSocketClient extends EventEmitter {
     performUpgrade(socket, url, options) {
         return new Promise((resolve, reject) => {
             const key = generateWebSocketKey();
-            const path = (url.pathname || '/') + (url.search || '');
+            const path = (url.pathname || "/") + (url.search || "");
             let request = `GET ${path} HTTP/1.1\r\n`;
             request += `Host: ${url.host}\r\n`;
             request += `Upgrade: websocket\r\n`;
@@ -157,7 +153,7 @@ export class WebSocketClient extends EventEmitter {
             request += `Sec-WebSocket-Key: ${key}\r\n`;
             request += `Sec-WebSocket-Version: 13\r\n`;
             if (options.protocols && options.protocols.length > 0) {
-                request += `Sec-WebSocket-Protocol: ${options.protocols.join(', ')}\r\n`;
+                request += `Sec-WebSocket-Protocol: ${options.protocols.join(", ")}\r\n`;
             }
             if (options.headers) {
                 for (const [k, v] of Object.entries(options.headers)) {
@@ -168,39 +164,46 @@ export class WebSocketClient extends EventEmitter {
             socket.write(request);
             let responseData = Buffer.alloc(0);
             const expectedAccept = computeAcceptKey(key);
+            let upgradeTimer;
+            if (options.timeout && options.timeout > 0) {
+                upgradeTimer = setTimeout(() => {
+                    cleanup();
+                    reject(new NLcURLError("WebSocket upgrade timed out", "ERR_WS_TIMEOUT"));
+                }, options.timeout);
+            }
             const onData = (chunk) => {
                 responseData = Buffer.concat([responseData, chunk]);
-                const text = responseData.toString('utf8');
-                const headerEnd = text.indexOf('\r\n\r\n');
+                const text = responseData.toString("utf8");
+                const headerEnd = text.indexOf("\r\n\r\n");
                 if (headerEnd === -1) {
                     if (responseData.length > 16384) {
                         cleanup();
-                        reject(new NLcURLError('WebSocket upgrade response too large', 'ERR_WS_UPGRADE'));
+                        reject(new NLcURLError("WebSocket upgrade response too large", "ERR_WS_UPGRADE"));
                     }
                     return;
                 }
                 cleanup();
                 const headerStr = text.substring(0, headerEnd);
-                const [statusLine, ...headerLines] = headerStr.split('\r\n');
+                const [statusLine, ...headerLines] = headerStr.split("\r\n");
                 if (!statusLine) {
-                    return reject(new NLcURLError('Empty upgrade response', 'ERR_WS_UPGRADE'));
+                    return reject(new NLcURLError("Empty upgrade response", "ERR_WS_UPGRADE"));
                 }
                 const statusMatch = statusLine.match(/^HTTP\/\d\.\d (\d{3})/);
-                if (!statusMatch || statusMatch[1] !== '101') {
-                    return reject(new NLcURLError(`WebSocket upgrade failed: ${statusLine}`, 'ERR_WS_UPGRADE'));
+                if (!statusMatch || statusMatch[1] !== "101") {
+                    return reject(new NLcURLError(`WebSocket upgrade failed: ${statusLine}`, "ERR_WS_UPGRADE"));
                 }
                 const headers = new Map();
                 for (const line of headerLines) {
-                    const colonIdx = line.indexOf(':');
+                    const colonIdx = line.indexOf(":");
                     if (colonIdx > 0) {
                         headers.set(line.substring(0, colonIdx).trim().toLowerCase(), line.substring(colonIdx + 1).trim());
                     }
                 }
-                const accept = headers.get('sec-websocket-accept');
+                const accept = headers.get("sec-websocket-accept");
                 if (accept !== expectedAccept) {
-                    return reject(new NLcURLError('Invalid Sec-WebSocket-Accept header', 'ERR_WS_UPGRADE'));
+                    return reject(new NLcURLError("Invalid Sec-WebSocket-Accept header", "ERR_WS_UPGRADE"));
                 }
-                this.protocol = headers.get('sec-websocket-protocol') ?? '';
+                this.protocol = headers.get("sec-websocket-protocol") ?? "";
                 const remaining = responseData.subarray(headerEnd + 4);
                 if (remaining.length > 0) {
                     this.parser.push(remaining);
@@ -212,11 +215,13 @@ export class WebSocketClient extends EventEmitter {
                 reject(err);
             };
             const cleanup = () => {
-                socket.removeListener('data', onData);
-                socket.removeListener('error', onError);
+                if (upgradeTimer)
+                    clearTimeout(upgradeTimer);
+                socket.removeListener("data", onData);
+                socket.removeListener("error", onError);
             };
-            socket.on('data', onData);
-            socket.on('error', onError);
+            socket.on("data", onData);
+            socket.on("error", onError);
         });
     }
     onData(chunk) {
@@ -235,8 +240,8 @@ export class WebSocketClient extends EventEmitter {
             case Opcode.BINARY:
                 if (frame.fin) {
                     const isBinary = frame.opcode === Opcode.BINARY;
-                    const data = isBinary ? frame.payload : frame.payload.toString('utf8');
-                    this.emit('message', data, isBinary);
+                    const data = isBinary ? frame.payload : frame.payload.toString("utf8");
+                    this.emit("message", data, isBinary);
                 }
                 else {
                     this.fragmentOpcode = frame.opcode;
@@ -249,34 +254,34 @@ export class WebSocketClient extends EventEmitter {
                     const assembled = Buffer.concat(this.fragments);
                     this.fragments = [];
                     const isBinary = this.fragmentOpcode === Opcode.BINARY;
-                    const data = isBinary ? assembled : assembled.toString('utf8');
-                    this.emit('message', data, isBinary);
+                    const data = isBinary ? assembled : assembled.toString("utf8");
+                    this.emit("message", data, isBinary);
                 }
                 break;
             case Opcode.CLOSE: {
                 let code = 1005;
-                let reason = '';
+                let reason = "";
                 if (frame.payload.length >= 2) {
                     code = frame.payload.readUInt16BE(0);
-                    reason = frame.payload.subarray(2).toString('utf8');
+                    reason = frame.payload.subarray(2).toString("utf8");
                 }
-                if (this.state === 'open') {
-                    this.state = 'closing';
+                if (this.state === "open") {
+                    this.state = "closing";
                     this.socket.write(encodeFrame(Opcode.CLOSE, frame.payload));
                 }
-                this.state = 'closed';
+                this.state = "closed";
                 this.socket?.destroy();
-                this.emit('close', code, reason);
+                this.emit("close", code, reason);
                 break;
             }
             case Opcode.PING:
-                this.emit('ping', frame.payload);
-                if (this.state === 'open') {
+                this.emit("ping", frame.payload);
+                if (this.state === "open") {
                     this.socket.write(encodeFrame(Opcode.PONG, frame.payload));
                 }
                 break;
             case Opcode.PONG:
-                this.emit('pong', frame.payload);
+                this.emit("pong", frame.payload);
                 break;
         }
     }