nlcurl 0.1.0 → 0.3.0

package/dist/utils/logger.js

@@ -1,6 +1,3 @@
-/**
- * Structured logger with configurable verbosity.
- */
 const LEVEL_ORDER = {
     debug: 0,
     info: 1,
@@ -8,26 +5,64 @@ const LEVEL_ORDER = {
     error: 3,
     silent: 4,
 };
+/**
+ * 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`.
+ */
 export class ConsoleLogger {
     level;
+    /**
+     * Creates a new ConsoleLogger.
+     *
+     * @param {LogLevel} [level='warn'] - Minimum severity level to emit.
+     */
     constructor(level = 'warn') {
         this.level = LEVEL_ORDER[level];
     }
+    /**
+     * Emits a debug-level message to `stderr` — only written when the
+     * configured minimum level is `'debug'`.
+     *
+     * @param {string}    message - Primary log message.
+     * @param {...unknown} args   - Additional values appended after the message.
+     */
     debug(message, ...args) {
         if (this.level <= LEVEL_ORDER.debug) {
             process.stderr.write(`[nlcurl:debug] ${message}${this.formatArgs(args)}\n`);
         }
     }
+    /**
+     * Emits an info-level message to `stderr` — only written when the
+     * configured minimum level is `'debug'` or `'info'`.
+     *
+     * @param {string}    message - Primary log message.
+     * @param {...unknown} args   - Additional values appended after the message.
+     */
     info(message, ...args) {
         if (this.level <= LEVEL_ORDER.info) {
             process.stderr.write(`[nlcurl:info] ${message}${this.formatArgs(args)}\n`);
         }
     }
+    /**
+     * 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.
+     * @param {...unknown} args   - Additional values appended after the message.
+     */
     warn(message, ...args) {
         if (this.level <= LEVEL_ORDER.warn) {
             process.stderr.write(`[nlcurl:warn] ${message}${this.formatArgs(args)}\n`);
         }
     }
+    /**
+     * 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, ...args) {
         if (this.level <= LEVEL_ORDER.error) {
             process.stderr.write(`[nlcurl:error] ${message}${this.formatArgs(args)}\n`);
@@ -39,7 +74,10 @@ export class ConsoleLogger {
         return ' ' + args.map((a) => (typeof a === 'string' ? a : JSON.stringify(a))).join(' ');
     }
 }
-/** Silent logger that discards all output. */
+/**
+ * A no-op {@link Logger} that discards all messages. Assign this via
+ * {@link setDefaultLogger} to silence the library entirely.
+ */
 export const SILENT_LOGGER = {
     debug() { },
     info() { },
@@ -47,9 +85,19 @@ export const SILENT_LOGGER = {
     error() { },
 };
 let _default = new ConsoleLogger('warn');
+/**
+ * Replaces the process-wide default logger used by all NLcURL internals.
+ *
+ * @param {Logger} logger - New logger instance to install.
+ */
 export function setDefaultLogger(logger) {
     _default = logger;
 }
+/**
+ * Returns the currently active process-wide logger.
+ *
+ * @returns {Logger} The active logger instance.
+ */
 export function getDefaultLogger() {
     return _default;
 }

package/dist/utils/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,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;AASF,MAAM,OAAO,aAAa;IAChB,KAAK,CAAS;IAEtB,YAAY,QAAkB,MAAM;QAClC,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,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,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,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,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,8CAA8C;AAC9C,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,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,QAAQ,GAAG,MAAM,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"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"}

package/dist/utils/url.d.ts

@@ -1,22 +1,62 @@
 /**
- * URL utilities -- parsing, query string encoding, base URL joining.
- * Zero dependencies; uses the built-in WHATWG URL API.
+ * Resolves `relative` against `base`. When `base` is `undefined` or the
+ * resolution fails, `relative` is returned as-is.
+ *
+ * @param {string | undefined} base     - Base URL string.
+ * @param {string}             relative - Relative or absolute URL to resolve.
+ * @returns {string} The resolved absolute URL, or `relative` if resolution fails.
  */
 export declare function resolveURL(base: string | undefined, relative: string): string;
+/**
+ * Appends `params` as query-string parameters to `url`. Existing parameters in
+ * the URL are preserved. `undefined` and `null` values are omitted.
+ *
+ * @param {string}                                        url    - Base URL.
+ * @param {Record<string, string | number | boolean>}     [params] - Key-value pairs to append.
+ * @returns {string} URL with appended query parameters.
+ */
 export declare function appendParams(url: string, params?: Record<string, string | number | boolean>): string;
+/**
+ * Parses `raw` into a `URL` object.
+ *
+ * @param {string} raw - Absolute URL string to parse.
+ * @returns {URL} Parsed URL.
+ * @throws {TypeError} If `raw` is not a valid absolute URL.
+ */
 export declare function parseURL(raw: string): URL;
 /**
- * Extract the origin key used for connection pooling:
- * `protocol://host:port`
+ * Returns the origin of `url` in `scheme://hostname:port` form. The port is
+ * always included explicitly, defaulting to `443` for `https:` and `80` for
+ * `http:`.
+ *
+ * @param {string} url - Absolute URL string.
+ * @returns {string} Origin string (e.g. `"https://example.com:443"`).
  */
 export declare function originOf(url: string): string;
-/** Return the hostname suitable for the TLS SNI extension. */
+/**
+ * Extracts the hostname from `url` for use as the TLS SNI server-name value.
+ *
+ * @param {string} url - Absolute URL string.
+ * @returns {string} Hostname without port (e.g. `"example.com"`).
+ */
 export declare function sniHost(url: string): string;
-/** Return the host:port string for TCP connection. */
+/**
+ * Extracts the host and port from `url`. The port defaults to `443` for
+ * `https:` and `80` for `http:` when not explicitly specified in the URL.
+ *
+ * @param {string} url - Absolute URL string.
+ * @returns {{ host: string; port: number }} Hostname and numeric port.
+ */
 export declare function hostPort(url: string): {
     host: string;
     port: number;
 };
-/** Return the request path including query string. */
+/**
+ * Returns the path and query string of `url` suitable for use as the
+ * request-target in an HTTP/1.1 request line.
+ *
+ * @param {string} url - Absolute URL string.
+ * @returns {string} Path + query string (e.g. `"/search?q=hello"`).
+ */
 export declare function requestPath(url: string): string;
 //# sourceMappingURL=url.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO7E;AAED,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACjD,MAAM,CASR;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAEzC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI5C;AAED,8DAA8D;AAC9D,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,sDAAsD;AACtD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAOpE;AAED,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG/C"}
+{"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"}

package/dist/utils/url.js

@@ -1,6 +1,10 @@
 /**
- * URL utilities -- parsing, query string encoding, base URL joining.
- * Zero dependencies; uses the built-in WHATWG URL API.
+ * Resolves `relative` against `base`. When `base` is `undefined` or the
+ * resolution fails, `relative` is returned as-is.
+ *
+ * @param {string | undefined} base     - Base URL string.
+ * @param {string}             relative - Relative or absolute URL to resolve.
+ * @returns {string} The resolved absolute URL, or `relative` if resolution fails.
  */
 export function resolveURL(base, relative) {
     if (!base)
@@ -12,6 +16,14 @@ export function resolveURL(base, relative) {
         return relative;
     }
 }
+/**
+ * Appends `params` as query-string parameters to `url`. Existing parameters in
+ * the URL are preserved. `undefined` and `null` values are omitted.
+ *
+ * @param {string}                                        url    - Base URL.
+ * @param {Record<string, string | number | boolean>}     [params] - Key-value pairs to append.
+ * @returns {string} URL with appended query parameters.
+ */
 export function appendParams(url, params) {
     if (!params || Object.keys(params).length === 0)
         return url;
@@ -23,23 +35,45 @@ export function appendParams(url, params) {
     }
     return parsed.toString();
 }
+/**
+ * Parses `raw` into a `URL` object.
+ *
+ * @param {string} raw - Absolute URL string to parse.
+ * @returns {URL} Parsed URL.
+ * @throws {TypeError} If `raw` is not a valid absolute URL.
+ */
 export function parseURL(raw) {
     return new URL(raw);
 }
 /**
- * Extract the origin key used for connection pooling:
- * `protocol://host:port`
+ * Returns the origin of `url` in `scheme://hostname:port` form. The port is
+ * always included explicitly, defaulting to `443` for `https:` and `80` for
+ * `http:`.
+ *
+ * @param {string} url - Absolute URL string.
+ * @returns {string} Origin string (e.g. `"https://example.com:443"`).
  */
 export function originOf(url) {
     const u = new URL(url);
     const port = u.port || (u.protocol === 'https:' ? '443' : '80');
     return `${u.protocol}//${u.hostname}:${port}`;
 }
-/** Return the hostname suitable for the TLS SNI extension. */
+/**
+ * Extracts the hostname from `url` for use as the TLS SNI server-name value.
+ *
+ * @param {string} url - Absolute URL string.
+ * @returns {string} Hostname without port (e.g. `"example.com"`).
+ */
 export function sniHost(url) {
     return new URL(url).hostname;
 }
-/** Return the host:port string for TCP connection. */
+/**
+ * Extracts the host and port from `url`. The port defaults to `443` for
+ * `https:` and `80` for `http:` when not explicitly specified in the URL.
+ *
+ * @param {string} url - Absolute URL string.
+ * @returns {{ host: string; port: number }} Hostname and numeric port.
+ */
 export function hostPort(url) {
     const u = new URL(url);
     const defaultPort = u.protocol === 'https:' ? 443 : 80;
@@ -48,7 +82,13 @@ export function hostPort(url) {
         port: u.port ? parseInt(u.port, 10) : defaultPort,
     };
 }
-/** Return the request path including query string. */
+/**
+ * Returns the path and query string of `url` suitable for use as the
+ * request-target in an HTTP/1.1 request line.
+ *
+ * @param {string} url - Absolute URL string.
+ * @returns {string} Path + query string (e.g. `"/search?q=hello"`).
+ */
 export function requestPath(url) {
     const u = new URL(url);
     return u.pathname + u.search;

package/dist/utils/url.js.map

@@ -1 +1 @@
-{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,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,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,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;AACtB,CAAC;AAED;;;GAGG;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,8DAA8D;AAC9D,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;AAC/B,CAAC;AAED,sDAAsD;AACtD,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,sDAAsD;AACtD,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":"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"}

package/dist/ws/client.d.ts

@@ -1,26 +1,40 @@
+import { EventEmitter } from 'node:events';
 /**
- * WebSocket client with TLS fingerprint impersonation.
+ * Options for creating a {@link WebSocketClient} connection.
  *
- * Implements the WebSocket protocol (RFC 6455) over impersonated
- * TLS connections.  Supports text and binary messages, ping/pong,
- * and graceful close.
+ * @typedef  {Object}    WebSocketOptions
+ * @property {string}    [impersonate]  - Browser profile name for fingerprint impersonation.
+ * @property {boolean}   [stealth]      - Use the stealth TLS engine for byte-level fingerprinting.
+ * @property {Record<string, string>} [headers] - Additional HTTP upgrade request headers.
+ * @property {string[]}  [protocols]    - Sub-protocol names to negotiate.
+ * @property {boolean}   [insecure]     - Skip TLS certificate validation for `wss:` connections.
+ * @property {number}    [timeout]      - Connection timeout in milliseconds.
  */
-import { EventEmitter } from 'node:events';
 export interface WebSocketOptions {
-    /** Browser profile name to impersonate. */
     impersonate?: string;
-    /** Use the stealth TLS engine. */
     stealth?: boolean;
-    /** Extra headers for the upgrade request. */
     headers?: Record<string, string>;
-    /** WebSocket sub-protocols. */
     protocols?: string[];
-    /** Skip TLS certificate verification. */
     insecure?: boolean;
-    /** Connection timeout in milliseconds. */
     timeout?: number;
 }
+/**
+ * WebSocket connection state.
+ *
+ * @typedef {'connecting' | 'open' | 'closing' | 'closed'} WebSocketState
+ */
 export type WebSocketState = 'connecting' | 'open' | 'closing' | 'closed';
+/**
+ * Typed event map for {@link WebSocketClient}.
+ *
+ * @typedef  {Object}                           WebSocketEvents
+ * @property {[]}                               open    - Emitted when the connection is established.
+ * @property {[data: string | Buffer, isBinary: boolean]} message - Emitted for each incoming message.
+ * @property {[code: number, reason: string]}   close   - Emitted when the connection closes.
+ * @property {[error: Error]}                   error   - Emitted on connection or protocol errors.
+ * @property {[data: Buffer]}                   ping    - Emitted when a PING frame is received.
+ * @property {[data: Buffer]}                   pong    - Emitted when a PONG frame is received.
+ */
 export interface WebSocketEvents {
     open: [];
     message: [data: string | Buffer, isBinary: boolean];
@@ -29,6 +43,17 @@ export interface WebSocketEvents {
     ping: [data: Buffer];
     pong: [data: Buffer];
 }
+/**
+ * WebSocket client with optional browser fingerprint impersonation. Emits
+ * typed lifecycle events (`open`, `message`, `close`, `error`, `ping`, `pong`).
+ * The connection is initiated asynchronously in the constructor; listen for
+ * the `'open'` event before sending frames.
+ *
+ * @example
+ * const ws = new WebSocketClient('wss://echo.example.com', { impersonate: 'chrome136' });
+ * ws.on('open', () => ws.sendText('hello'));
+ * ws.on('message', (data) => console.log(data));
+ */
 export declare class WebSocketClient extends EventEmitter {
     state: WebSocketState;
     protocol: string;
@@ -37,27 +62,47 @@ export declare class WebSocketClient extends EventEmitter {
     private parser;
     private fragments;
     private fragmentOpcode;
+    /**
+     * Creates a new WebSocketClient and begins connecting to `url`.
+     *
+     * @param {string}           url       - WebSocket URL (`ws:` or `wss:`).
+     * @param {WebSocketOptions} [options={}] - Connection and impersonation options.
+     */
     constructor(url: string, options?: WebSocketOptions);
     /**
-     * Send a text message.
+     * Sends a UTF-8 text message.
+     *
+     * @param {string} data - Text to send.
+     * @throws {NLcURLError} If the WebSocket is not in the `'open'` state.
      */
     sendText(data: string): void;
     /**
-     * Send a binary message.
+     * Sends a binary message.
+     *
+     * @param {Buffer} data - Binary data to send.
+     * @throws {NLcURLError} If the WebSocket is not in the `'open'` state.
      */
     sendBinary(data: Buffer): void;
     /**
-     * Send a ping frame.
+     * Sends a PING control frame.
+     *
+     * @param {Buffer} [data=Buffer.alloc(0)] - Optional ping payload (up to 125 bytes).
+     * @throws {NLcURLError} If the WebSocket is not in the `'open'` state.
      */
     ping(data?: Buffer): void;
     /**
-     * Initiate a graceful close handshake.
+     * Initiates a graceful close handshake by sending a CLOSE frame with the
+     * given status code and reason. Does nothing if the connection is not open.
+     *
+     * @param {number} [code=1000]  - WebSocket close status code.
+     * @param {string} [reason=''] - Human-readable close reason (UTF-8, max 123 bytes).
      */
     close(code?: number, reason?: string): void;
     private assertOpen;
     private connect;
     private performUpgrade;
     private onData;
+    private drainBufferedFrames;
     private handleFrame;
 }
 //# sourceMappingURL=client.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/ws/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAiB3C,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE1E,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,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;gBAEjC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB;IAWvD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM5B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK9B;;OAEG;IACH,IAAI,CAAC,IAAI,GAAE,MAAwB,GAAG,IAAI;IAK1C;;OAEG;IACH,KAAK,CAAC,IAAI,SAAO,EAAE,MAAM,SAAK,GAAG,IAAI;IAcrC,OAAO,CAAC,UAAU;YAMJ,OAAO;IAsErB,OAAO,CAAC,cAAc;IA6GtB,OAAO,CAAC,MAAM;IASd,OAAO,CAAC,WAAW;CA4DpB"}
+{"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"}

package/dist/ws/client.js

@@ -1,16 +1,20 @@
-/**
- * WebSocket client with TLS fingerprint impersonation.
- *
- * Implements the WebSocket protocol (RFC 6455) over impersonated
- * TLS connections.  Supports text and binary messages, ping/pong,
- * and graceful close.
- */
 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';
+/**
+ * WebSocket client with optional browser fingerprint impersonation. Emits
+ * typed lifecycle events (`open`, `message`, `close`, `error`, `ping`, `pong`).
+ * The connection is initiated asynchronously in the constructor; listen for
+ * the `'open'` event before sending frames.
+ *
+ * @example
+ * const ws = new WebSocketClient('wss://echo.example.com', { impersonate: 'chrome136' });
+ * ws.on('open', () => ws.sendText('hello'));
+ * ws.on('message', (data) => console.log(data));
+ */
 export class WebSocketClient extends EventEmitter {
     state = 'connecting';
     protocol = '';
@@ -19,17 +23,25 @@ export class WebSocketClient extends EventEmitter {
     parser = new FrameParser();
     fragments = [];
     fragmentOpcode = Opcode.TEXT;
+    /**
+     * Creates a new WebSocketClient and begins connecting to `url`.
+     *
+     * @param {string}           url       - WebSocket URL (`ws:` or `wss:`).
+     * @param {WebSocketOptions} [options={}] - Connection and impersonation options.
+     */
     constructor(url, options = {}) {
         super();
         this.url = url;
-        // Start connection asynchronously
         this.connect(url, options).catch((err) => {
             this.state = 'closed';
             this.emit('error', err);
         });
     }
     /**
-     * Send a text message.
+     * Sends a UTF-8 text message.
+     *
+     * @param {string} data - Text to send.
+     * @throws {NLcURLError} If the WebSocket is not in the `'open'` state.
      */
     sendText(data) {
         this.assertOpen();
@@ -37,21 +49,31 @@ export class WebSocketClient extends EventEmitter {
         this.socket.write(encodeFrame(Opcode.TEXT, payload));
     }
     /**
-     * Send a binary message.
+     * Sends a binary message.
+     *
+     * @param {Buffer} data - Binary data to send.
+     * @throws {NLcURLError} If the WebSocket is not in the `'open'` state.
      */
     sendBinary(data) {
         this.assertOpen();
         this.socket.write(encodeFrame(Opcode.BINARY, data));
     }
     /**
-     * Send a ping frame.
+     * Sends a PING control frame.
+     *
+     * @param {Buffer} [data=Buffer.alloc(0)] - Optional ping payload (up to 125 bytes).
+     * @throws {NLcURLError} If the WebSocket is not in the `'open'` state.
      */
     ping(data = Buffer.alloc(0)) {
         this.assertOpen();
         this.socket.write(encodeFrame(Opcode.PING, data));
     }
     /**
-     * Initiate a graceful close handshake.
+     * Initiates a graceful close handshake by sending a CLOSE frame with the
+     * given status code and reason. Does nothing if the connection is not open.
+     *
+     * @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')
@@ -63,7 +85,6 @@ export class WebSocketClient extends EventEmitter {
         reasonBuf.copy(payload, 2);
         this.socket.write(encodeFrame(Opcode.CLOSE, payload));
     }
-    // ---- Internal ----
     assertOpen() {
         if (this.state !== 'open') {
             throw new NLcURLError('WebSocket is not open', 'ERR_WS_NOT_OPEN');
@@ -76,13 +97,11 @@ export class WebSocketClient extends EventEmitter {
             ? parseInt(parsed.port, 10)
             : isSecure ? 443 : 80;
         const host = parsed.hostname;
-        // Resolve profile
         const profile = options.impersonate
             ? getProfile(options.impersonate) ?? undefined
             : undefined;
         let transport;
         if (isSecure) {
-            // TLS connection with impersonation
             const engine = options.stealth
                 ? new StealthTLSEngine()
                 : new NodeTLSEngine();
@@ -98,7 +117,6 @@ export class WebSocketClient extends EventEmitter {
             transport = tlsSocket;
         }
         else {
-            // Plain TCP (ws://)
             const net = await import('node:net');
             transport = await new Promise((resolve, reject) => {
                 const sock = net.createConnection({ host, port }, () => resolve(sock));
@@ -112,12 +130,9 @@ export class WebSocketClient extends EventEmitter {
             });
         }
         this.socket = transport;
-        // Perform HTTP upgrade handshake
         await this.performUpgrade(transport, parsed, options);
-        // Now in open state
         this.state = 'open';
         this.emit('open');
-        // Start reading frames
         transport.on('data', (chunk) => this.onData(chunk));
         transport.on('error', (err) => {
             this.state = 'closed';
@@ -129,6 +144,7 @@ export class WebSocketClient extends EventEmitter {
                 this.emit('close', 1006, 'Connection lost');
             }
         });
+        this.drainBufferedFrames();
     }
     performUpgrade(socket, url, options) {
         return new Promise((resolve, reject) => {
@@ -150,7 +166,6 @@ export class WebSocketClient extends EventEmitter {
             }
             request += `\r\n`;
             socket.write(request);
-            // Read the upgrade response
             let responseData = Buffer.alloc(0);
             const expectedAccept = computeAcceptKey(key);
             const onData = (chunk) => {
@@ -158,7 +173,6 @@ export class WebSocketClient extends EventEmitter {
                 const text = responseData.toString('utf8');
                 const headerEnd = text.indexOf('\r\n\r\n');
                 if (headerEnd === -1) {
-                    // Limit response header size
                     if (responseData.length > 16384) {
                         cleanup();
                         reject(new NLcURLError('WebSocket upgrade response too large', 'ERR_WS_UPGRADE'));
@@ -175,7 +189,6 @@ export class WebSocketClient extends EventEmitter {
                 if (!statusMatch || statusMatch[1] !== '101') {
                     return reject(new NLcURLError(`WebSocket upgrade failed: ${statusLine}`, 'ERR_WS_UPGRADE'));
                 }
-                // Validate Sec-WebSocket-Accept
                 const headers = new Map();
                 for (const line of headerLines) {
                     const colonIdx = line.indexOf(':');
@@ -188,7 +201,6 @@ export class WebSocketClient extends EventEmitter {
                     return reject(new NLcURLError('Invalid Sec-WebSocket-Accept header', 'ERR_WS_UPGRADE'));
                 }
                 this.protocol = headers.get('sec-websocket-protocol') ?? '';
-                // Push any remaining data after headers into frame parser
                 const remaining = responseData.subarray(headerEnd + 4);
                 if (remaining.length > 0) {
                     this.parser.push(remaining);
@@ -209,6 +221,9 @@ export class WebSocketClient extends EventEmitter {
     }
     onData(chunk) {
         this.parser.push(chunk);
+        this.drainBufferedFrames();
+    }
+    drainBufferedFrames() {
         let frame;
         while ((frame = this.parser.pull()) !== null) {
             this.handleFrame(frame);
@@ -219,13 +234,11 @@ export class WebSocketClient extends EventEmitter {
             case Opcode.TEXT:
             case Opcode.BINARY:
                 if (frame.fin) {
-                    // Complete message
                     const isBinary = frame.opcode === Opcode.BINARY;
                     const data = isBinary ? frame.payload : frame.payload.toString('utf8');
                     this.emit('message', data, isBinary);
                 }
                 else {
-                    // Start of fragmented message
                     this.fragmentOpcode = frame.opcode;
                     this.fragments = [frame.payload];
                 }
@@ -248,7 +261,6 @@ export class WebSocketClient extends EventEmitter {
                     reason = frame.payload.subarray(2).toString('utf8');
                 }
                 if (this.state === 'open') {
-                    // Server-initiated close, echo it back
                     this.state = 'closing';
                     this.socket.write(encodeFrame(Opcode.CLOSE, frame.payload));
                 }
@@ -259,7 +271,6 @@ export class WebSocketClient extends EventEmitter {
             }
             case Opcode.PING:
                 this.emit('ping', frame.payload);
-                // Auto-respond with pong
                 if (this.state === 'open') {
                     this.socket.write(encodeFrame(Opcode.PONG, frame.payload));
                 }