nlcurl 0.1.0 → 0.2.0

package/dist/http/pool.d.ts

@@ -1,13 +1,19 @@
-/**
- * Connection pool.
- *
- * Manages TLS connections keyed by origin, supporting both HTTP/1.1
- * keep-alive and HTTP/2 multiplexing.  Handles connection reuse,
- * eviction, and idle timeout.
- */
 import type { TLSSocket } from '../tls/types.js';
 import { H2Client } from './h2/client.js';
 import type { H2Profile } from '../fingerprints/types.js';
+/**
+ * Represents a single pooled connection entry, holding the TLS socket,
+ * protocol version, and lifecycle timestamps.
+ *
+ * @typedef  {Object}       PoolEntry
+ * @property {string}       origin    - Origin key in `protocol://hostname:port` form.
+ * @property {TLSSocket}    socket    - The underlying TLS (or TCP) socket.
+ * @property {'h1'|'h2'}   protocol  - Negotiated HTTP protocol version.
+ * @property {H2Client}     [h2Client] - HTTP/2 client instance when `protocol === 'h2'`.
+ * @property {number}       createdAt - Unix timestamp (ms) when the connection was established.
+ * @property {number}       lastUsed  - Unix timestamp (ms) when the connection was last checked out.
+ * @property {boolean}      busy      - `true` while an HTTP/1.1 request is in flight.
+ */
 export interface PoolEntry {
     origin: string;
     socket: TLSSocket;
@@ -17,44 +23,87 @@ export interface PoolEntry {
     lastUsed: number;
     busy: boolean;
 }
+/**
+ * Configuration options for the {@link ConnectionPool}.
+ *
+ * @typedef  {Object}  PoolOptions
+ * @property {number}  [maxConnectionsPerOrigin=6]  - Maximum simultaneous connections to a single origin.
+ * @property {number}  [maxTotalConnections=64]     - Maximum total connections across all origins.
+ * @property {number}  [idleTimeout=60000]          - Milliseconds of inactivity before a connection is evicted.
+ * @property {number}  [maxAge=300000]              - Maximum lifetime of a connection in milliseconds.
+ */
 export interface PoolOptions {
-    /** Maximum connections per origin. */
     maxConnectionsPerOrigin?: number;
-    /** Maximum total connections across all origins. */
     maxTotalConnections?: number;
-    /** Connection idle timeout in milliseconds. */
     idleTimeout?: number;
-    /** Connection max age in milliseconds. */
     maxAge?: number;
 }
+/**
+ * Maintains a pool of reusable TLS connections, keyed by origin, supporting
+ * both HTTP/1.1 (exclusive per-request access) and HTTP/2 (multiplexed)
+ * connections. Idle and expired connections are evicted automatically on a
+ * 30-second timer.
+ */
 export declare class ConnectionPool {
     private readonly options;
     private readonly connections;
     private totalConnections;
     private cleanupTimer;
+    /**
+     * Creates a new ConnectionPool.
+     *
+     * @param {PoolOptions} [options={}] - Pool configuration; unset fields use their defaults.
+     */
     constructor(options?: PoolOptions);
     /**
-     * Get an existing idle connection for the given origin.
+     * Checks out a usable connection for the given origin. For HTTP/2 returns
+     * any live connection (multiplexing); for HTTP/1.1 returns a non-busy,
+     * non-expired connection and marks it busy.
      *
-     * Returns undefined if no reusable connection is available.
+     * @param {string} origin - Origin key in `protocol://hostname:port` form.
+     * @returns {PoolEntry|undefined} A ready connection entry, or `undefined` if none is available.
      */
     get(origin: string): PoolEntry | undefined;
     /**
-     * Add a new connection to the pool.
+     * Registers a new connection in the pool. If adding the entry would exceed
+     * the per-origin limit, the oldest entry for that origin is evicted. If the
+     * total connection limit has been reached, the globally least-recently-used
+     * idle connection is evicted first.
+     *
+     * @param {string}               origin         - Origin key.
+     * @param {TLSSocket}            socket         - Connected socket to pool.
+     * @param {'h1'|'h2'}           protocol       - Negotiated HTTP protocol.
+     * @param {H2Profile}            [h2Profile]    - H2 profile used to configure the H2Client.
+     * @param {Array<[string,string]>} [defaultHeaders] - Default headers applied to every H2 request.
+     * @returns {PoolEntry} The newly created pool entry.
      */
     put(origin: string, socket: TLSSocket, protocol: 'h1' | 'h2', h2Profile?: H2Profile, defaultHeaders?: Array<[string, string]>): PoolEntry;
     /**
-     * Release an H1 connection back to the pool.
+     * Marks an HTTP/1.1 pool entry as available for reuse once a request has
+     * completed. Updates the `lastUsed` timestamp.
+     *
+     * @param {PoolEntry} entry - The connection entry to release.
      */
     release(entry: PoolEntry): void;
     /**
-     * Remove a specific connection from the pool.
+     * Removes a connection entry from the pool and destroys its socket.
+     * Typically called when a connection error has occurred or the server
+     * sent a `Connection: close` header.
+     *
+     * @param {PoolEntry} entry - The connection entry to remove and destroy.
      */
     remove(entry: PoolEntry): void;
     /**
-     * Close all connections and stop the cleanup timer.
+     * Destroys all pooled connections and stops the idle-eviction timer.
+     * The pool must not be used after this call.
      */
     close(): void;
+    /**
+     * Returns the total number of connections (both idle and busy) currently held
+     * in the pool across all origins.
+     *
+     * @returns {number} Total pooled connection count.
+     */
     get size(): number;
     private isExpired;
     private evictIdle;

package/dist/http/pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../src/http/pool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAqB,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,oDAAoD;IACpD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AASD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkC;IAC9D,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,YAAY,CAA6C;gBAErD,OAAO,GAAE,WAAgB;IASrC;;;;OAIG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAwB1C;;OAEG;IACH,GAAG,CACD,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,IAAI,GAAG,IAAI,EACrB,SAAS,CAAC,EAAE,SAAS,EACrB,cAAc,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACvC,SAAS;IAyCZ;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAK/B;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAe9B;;OAEG;IACH,KAAK,IAAI,IAAI;IAgBb,IAAI,IAAI,IAAI,MAAM,CAEjB;IAID,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,SAAS;IAkBjB,OAAO,CAAC,WAAW;CAiBpB"}
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../src/http/pool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAqB,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AASD;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkC;IAC9D,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,YAAY,CAA6C;IAEjE;;;;OAIG;gBACS,OAAO,GAAE,WAAgB;IAQrC;;;;;;;OAOG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAyB1C;;;;;;;;;;;;OAYG;IACH,GAAG,CACD,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,IAAI,GAAG,IAAI,EACrB,SAAS,CAAC,EAAE,SAAS,EACrB,cAAc,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACvC,SAAS;IAsCZ;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAK/B;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAe9B;;;OAGG;IACH,KAAK,IAAI,IAAI;IAgBb;;;;;OAKG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,SAAS;IAkBjB,OAAO,CAAC,WAAW;CAiBpB"}

package/dist/http/pool.js

@@ -1,10 +1,3 @@
-/**
- * Connection pool.
- *
- * Manages TLS connections keyed by origin, supporting both HTTP/1.1
- * keep-alive and HTTP/2 multiplexing.  Handles connection reuse,
- * eviction, and idle timeout.
- */
 import { H2Client } from './h2/client.js';
 const DEFAULT_POOL_OPTIONS = {
     maxConnectionsPerOrigin: 6,
@@ -12,23 +5,36 @@ const DEFAULT_POOL_OPTIONS = {
     idleTimeout: 60_000,
     maxAge: 300_000,
 };
+/**
+ * Maintains a pool of reusable TLS connections, keyed by origin, supporting
+ * both HTTP/1.1 (exclusive per-request access) and HTTP/2 (multiplexed)
+ * connections. Idle and expired connections are evicted automatically on a
+ * 30-second timer.
+ */
 export class ConnectionPool {
     options;
     connections = new Map();
     totalConnections = 0;
     cleanupTimer;
+    /**
+     * Creates a new ConnectionPool.
+     *
+     * @param {PoolOptions} [options={}] - Pool configuration; unset fields use their defaults.
+     */
     constructor(options = {}) {
         this.options = { ...DEFAULT_POOL_OPTIONS, ...options };
-        // Periodic cleanup
         this.cleanupTimer = setInterval(() => this.evictIdle(), 30_000);
         if (this.cleanupTimer.unref) {
             this.cleanupTimer.unref();
         }
     }
     /**
-     * Get an existing idle connection for the given origin.
+     * Checks out a usable connection for the given origin. For HTTP/2 returns
+     * any live connection (multiplexing); for HTTP/1.1 returns a non-busy,
+     * non-expired connection and marks it busy.
      *
-     * Returns undefined if no reusable connection is available.
+     * @param {string} origin - Origin key in `protocol://hostname:port` form.
+     * @returns {PoolEntry|undefined} A ready connection entry, or `undefined` if none is available.
      */
     get(origin) {
         const entries = this.connections.get(origin);
@@ -36,12 +42,13 @@ export class ConnectionPool {
             return undefined;
         const now = Date.now();
         for (const entry of entries) {
-            // H2 connections can be multiplexed (always reusable)
             if (entry.protocol === 'h2' && !this.isExpired(entry, now)) {
+                if (entry.h2Client?.isClosed) {
+                    continue;
+                }
                 entry.lastUsed = now;
                 return entry;
             }
-            // H1 connections must be idle
             if (entry.protocol === 'h1' && !entry.busy && !this.isExpired(entry, now)) {
                 entry.busy = true;
                 entry.lastUsed = now;
@@ -51,13 +58,21 @@ export class ConnectionPool {
         return undefined;
     }
     /**
-     * Add a new connection to the pool.
+     * Registers a new connection in the pool. If adding the entry would exceed
+     * the per-origin limit, the oldest entry for that origin is evicted. If the
+     * total connection limit has been reached, the globally least-recently-used
+     * idle connection is evicted first.
+     *
+     * @param {string}               origin         - Origin key.
+     * @param {TLSSocket}            socket         - Connected socket to pool.
+     * @param {'h1'|'h2'}           protocol       - Negotiated HTTP protocol.
+     * @param {H2Profile}            [h2Profile]    - H2 profile used to configure the H2Client.
+     * @param {Array<[string,string]>} [defaultHeaders] - Default headers applied to every H2 request.
+     * @returns {PoolEntry} The newly created pool entry.
      */
     put(origin, socket, protocol, h2Profile, defaultHeaders) {
-        // Evict if at capacity
         if (this.totalConnections >= this.options.maxTotalConnections) {
             this.evictOldest();
-            // If eviction failed (all busy), allow temporary over-capacity
         }
         const entry = {
             origin,
@@ -75,7 +90,6 @@ export class ConnectionPool {
             entries = [];
             this.connections.set(origin, entries);
         }
-        // Check per-origin limit
         while (entries.length >= this.options.maxConnectionsPerOrigin) {
             const evicted = entries.shift();
             if (evicted) {
@@ -88,14 +102,21 @@ export class ConnectionPool {
         return entry;
     }
     /**
-     * Release an H1 connection back to the pool.
+     * Marks an HTTP/1.1 pool entry as available for reuse once a request has
+     * completed. Updates the `lastUsed` timestamp.
+     *
+     * @param {PoolEntry} entry - The connection entry to release.
      */
     release(entry) {
         entry.busy = false;
         entry.lastUsed = Date.now();
     }
     /**
-     * Remove a specific connection from the pool.
+     * Removes a connection entry from the pool and destroys its socket.
+     * Typically called when a connection error has occurred or the server
+     * sent a `Connection: close` header.
+     *
+     * @param {PoolEntry} entry - The connection entry to remove and destroy.
      */
     remove(entry) {
         const entries = this.connections.get(entry.origin);
@@ -112,7 +133,8 @@ export class ConnectionPool {
         entry.socket.destroyTLS();
     }
     /**
-     * Close all connections and stop the cleanup timer.
+     * Destroys all pooled connections and stops the idle-eviction timer.
+     * The pool must not be used after this call.
      */
     close() {
         if (this.cleanupTimer) {
@@ -129,10 +151,15 @@ export class ConnectionPool {
         this.connections.clear();
         this.totalConnections = 0;
     }
+    /**
+     * Returns the total number of connections (both idle and busy) currently held
+     * in the pool across all origins.
+     *
+     * @returns {number} Total pooled connection count.
+     */
     get size() {
         return this.totalConnections;
     }
-    // ---- Internal ----
     isExpired(entry, now) {
         if (now - entry.createdAt > this.options.maxAge)
             return true;

package/dist/http/pool.js.map

@@ -1 +1 @@
-{"version":3,"file":"pool.js","sourceRoot":"","sources":["../../src/http/pool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../../src/http/pool.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,7 +1,6 @@
 /**
- * NLcURL -- Pure TypeScript HTTP client with browser fingerprint impersonation.
- *
- * Zero runtime dependencies. Uses Node.js built-in modules exclusively.
+ * Public API entry point for the NLcURL library. Re-exports all types, classes,
+ * and functions that form the stable public surface of the package.
  *
  * @module nlcurl
  */

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,WAAW,EACX,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EACL,WAAW,EACX,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,UAAU,EACV,UAAU,EACV,eAAe,EACf,aAAa,GACd,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EACL,aAAa,EACb,OAAO,EACP,GAAG,EACH,IAAI,EACJ,GAAG,EACH,KAAK,EACL,GAAG,EACH,IAAI,GACL,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,UAAU,EACV,YAAY,EACZ,eAAe,GAChB,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACV,cAAc,EACd,UAAU,EACV,SAAS,EACT,aAAa,GACd,MAAM,yBAAyB,CAAC;AAGjC,YAAY,EACV,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AAErC,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7C,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAG9F,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AACH,YAAY,EACV,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,WAAW,EACX,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EACL,WAAW,EACX,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,UAAU,EACV,UAAU,EACV,eAAe,EACf,aAAa,GACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EACL,aAAa,EACb,OAAO,EACP,GAAG,EACH,IAAI,EACJ,GAAG,EACH,KAAK,EACL,GAAG,EACH,IAAI,GACL,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,UAAU,EACV,YAAY,EACZ,eAAe,GAChB,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACV,cAAc,EACd,UAAU,EACV,SAAS,EACT,aAAa,GACd,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AAErC,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE9F,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -1,23 +1,10 @@
-/**
- * NLcURL -- Pure TypeScript HTTP client with browser fingerprint impersonation.
- *
- * Zero runtime dependencies. Uses Node.js built-in modules exclusively.
- *
- * @module nlcurl
- */
 export { NLcURLResponse } from './core/response.js';
-// ---- Error types ----
 export { NLcURLError, TLSError, HTTPError, TimeoutError, ProxyError, AbortError, ConnectionError, ProtocolError, } from './core/errors.js';
-// ---- Session and client ----
 export { NLcURLSession } from './core/session.js';
 export { createSession, request, get, post, put, patch, del, head, } from './core/client.js';
-// ---- Fingerprints ----
 export { getProfile, listProfiles, DEFAULT_PROFILE, } from './fingerprints/database.js';
-// ---- Cookies ----
 export { CookieJar } from './cookies/jar.js';
-// ---- WebSocket ----
 export { WebSocketClient } from './ws/client.js';
-// ---- Utilities ----
 export { ja3Hash, ja3String } from './fingerprints/ja3.js';
 export { akamaiFingerprint } from './fingerprints/akamai.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,wBAAwB;AACxB,OAAO,EACL,WAAW,EACX,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,UAAU,EACV,UAAU,EACV,eAAe,EACf,aAAa,GACd,MAAM,kBAAkB,CAAC;AAE1B,+BAA+B;AAC/B,OAAO,EAAE,aAAa,EAAuB,MAAM,mBAAmB,CAAC;AACvE,OAAO,EACL,aAAa,EACb,OAAO,EACP,GAAG,EACH,IAAI,EACJ,GAAG,EACH,KAAK,EACL,GAAG,EACH,IAAI,GACL,MAAM,kBAAkB,CAAC;AAE1B,yBAAyB;AACzB,OAAO,EACL,UAAU,EACV,YAAY,EACZ,eAAe,GAChB,MAAM,4BAA4B,CAAC;AAiBpC,oBAAoB;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,sBAAsB;AACtB,OAAO,EAAE,eAAe,EAA+C,MAAM,gBAAgB,CAAC;AAE9F,sBAAsB;AACtB,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,OAAO,EACL,WAAW,EACX,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,UAAU,EACV,UAAU,EACV,eAAe,EACf,aAAa,GACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAuB,MAAM,mBAAmB,CAAC;AACvE,OAAO,EACL,aAAa,EACb,OAAO,EACP,GAAG,EACH,IAAI,EACJ,GAAG,EACH,KAAK,EACL,GAAG,EACH,IAAI,GACL,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,UAAU,EACV,YAAY,EACZ,eAAe,GAChB,MAAM,4BAA4B,CAAC;AAgBpC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,eAAe,EAA+C,MAAM,gBAAgB,CAAC;AAE9F,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/middleware/interceptor.d.ts

@@ -1,27 +1,59 @@
-/**
- * Request/response interceptor middleware.
- */
 import type { NLcURLRequest } from '../core/request.js';
 import { NLcURLResponse } from '../core/response.js';
 /**
- * A function that can modify a request before it is sent.
+ * A function that inspects and optionally transforms an outgoing request before
+ * it is sent. May be synchronous or asynchronous.
+ *
+ * @callback RequestInterceptor
+ * @param {NLcURLRequest} request - The outgoing request descriptor.
+ * @returns {NLcURLRequest | Promise<NLcURLRequest>} The (potentially modified) request.
  */
 export type RequestInterceptor = (request: NLcURLRequest) => NLcURLRequest | Promise<NLcURLRequest>;
 /**
- * A function that can modify or inspect a response after it is received.
+ * A function that inspects and optionally transforms an incoming response before
+ * it is returned to the caller. May be synchronous or asynchronous.
+ *
+ * @callback ResponseInterceptor
+ * @param {NLcURLResponse} response - The received response.
+ * @returns {NLcURLResponse | Promise<NLcURLResponse>} The (potentially modified) response.
  */
 export type ResponseInterceptor = (response: NLcURLResponse) => NLcURLResponse | Promise<NLcURLResponse>;
 /**
- * Middleware chain.
- *
- * Interceptors are executed in FIFO order.
+ * Maintains ordered lists of request and response interceptors and applies
+ * them sequentially. Interceptors are invoked in the order they were added.
  */
 export declare class InterceptorChain {
     private readonly requestInterceptors;
     private readonly responseInterceptors;
+    /**
+     * Registers a request interceptor. Interceptors are applied in registration order.
+     *
+     * @param {RequestInterceptor} fn - Interceptor function to add.
+     * @returns {this} This instance for chaining.
+     */
     addRequestInterceptor(fn: RequestInterceptor): this;
+    /**
+     * Registers a response interceptor. Interceptors are applied in registration order.
+     *
+     * @param {ResponseInterceptor} fn - Interceptor function to add.
+     * @returns {this} This instance for chaining.
+     */
     addResponseInterceptor(fn: ResponseInterceptor): this;
+    /**
+     * Passes `request` through all registered request interceptors in order and
+     * returns the final transformed request.
+     *
+     * @param {NLcURLRequest} request - Originating request descriptor.
+     * @returns {Promise<NLcURLRequest>} The request after all interceptors have run.
+     */
     processRequest(request: NLcURLRequest): Promise<NLcURLRequest>;
+    /**
+     * Passes `response` through all registered response interceptors in order and
+     * returns the final transformed response.
+     *
+     * @param {NLcURLResponse} response - Received response.
+     * @returns {Promise<NLcURLResponse>} The response after all interceptors have run.
+     */
     processResponse(response: NLcURLResponse): Promise<NLcURLResponse>;
 }
 //# sourceMappingURL=interceptor.d.ts.map

package/dist/middleware/interceptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../../src/middleware/interceptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,OAAO,EAAE,aAAa,KACnB,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,QAAQ,EAAE,cAAc,KACrB,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAE9C;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA4B;IAChE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA6B;IAElE,qBAAqB,CAAC,EAAE,EAAE,kBAAkB,GAAG,IAAI;IAKnD,sBAAsB,CAAC,EAAE,EAAE,mBAAmB,GAAG,IAAI;IAK/C,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAQ9D,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;CAOzE"}
+{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../../src/middleware/interceptor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,OAAO,EAAE,aAAa,KACnB,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5C;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,QAAQ,EAAE,cAAc,KACrB,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAE9C;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA4B;IAChE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA6B;IAElE;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,EAAE,kBAAkB,GAAG,IAAI;IAKnD;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,EAAE,mBAAmB,GAAG,IAAI;IAKrD;;;;;;OAMG;IACG,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAQpE;;;;;;OAMG;IACG,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;CAOzE"}

package/dist/middleware/interceptor.js

@@ -1,22 +1,37 @@
 /**
- * Request/response interceptor middleware.
- */
-/**
- * Middleware chain.
- *
- * Interceptors are executed in FIFO order.
+ * Maintains ordered lists of request and response interceptors and applies
+ * them sequentially. Interceptors are invoked in the order they were added.
  */
 export class InterceptorChain {
     requestInterceptors = [];
     responseInterceptors = [];
+    /**
+     * Registers a request interceptor. Interceptors are applied in registration order.
+     *
+     * @param {RequestInterceptor} fn - Interceptor function to add.
+     * @returns {this} This instance for chaining.
+     */
     addRequestInterceptor(fn) {
         this.requestInterceptors.push(fn);
         return this;
     }
+    /**
+     * Registers a response interceptor. Interceptors are applied in registration order.
+     *
+     * @param {ResponseInterceptor} fn - Interceptor function to add.
+     * @returns {this} This instance for chaining.
+     */
     addResponseInterceptor(fn) {
         this.responseInterceptors.push(fn);
         return this;
     }
+    /**
+     * Passes `request` through all registered request interceptors in order and
+     * returns the final transformed request.
+     *
+     * @param {NLcURLRequest} request - Originating request descriptor.
+     * @returns {Promise<NLcURLRequest>} The request after all interceptors have run.
+     */
     async processRequest(request) {
         let req = request;
         for (const fn of this.requestInterceptors) {
@@ -24,6 +39,13 @@ export class InterceptorChain {
         }
         return req;
     }
+    /**
+     * Passes `response` through all registered response interceptors in order and
+     * returns the final transformed response.
+     *
+     * @param {NLcURLResponse} response - Received response.
+     * @returns {Promise<NLcURLResponse>} The response after all interceptors have run.
+     */
     async processResponse(response) {
         let resp = response;
         for (const fn of this.responseInterceptors) {

package/dist/middleware/interceptor.js.map

@@ -1 +1 @@
-{"version":3,"file":"interceptor.js","sourceRoot":"","sources":["../../src/middleware/interceptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH;;;;GAIG;AACH,MAAM,OAAO,gBAAgB;IACV,mBAAmB,GAAyB,EAAE,CAAC;IAC/C,oBAAoB,GAA0B,EAAE,CAAC;IAElE,qBAAqB,CAAC,EAAsB;QAC1C,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sBAAsB,CAAC,EAAuB;QAC5C,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAAsB;QACzC,IAAI,GAAG,GAAG,OAAO,CAAC;QAClB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC1C,GAAG,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,QAAwB;QAC5C,IAAI,IAAI,GAAG,QAAQ,CAAC;QACpB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC3C,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
+{"version":3,"file":"interceptor.js","sourceRoot":"","sources":["../../src/middleware/interceptor.ts"],"names":[],"mappings":"AA4BA;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IACV,mBAAmB,GAAyB,EAAE,CAAC;IAC/C,oBAAoB,GAA0B,EAAE,CAAC;IAElE;;;;;OAKG;IACH,qBAAqB,CAAC,EAAsB;QAC1C,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,sBAAsB,CAAC,EAAuB;QAC5C,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,cAAc,CAAC,OAAsB;QACzC,IAAI,GAAG,GAAG,OAAO,CAAC;QAClB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC1C,GAAG,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,eAAe,CAAC,QAAwB;QAC5C,IAAI,IAAI,GAAG,QAAQ,CAAC;QACpB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC3C,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/middleware/rate-limiter.d.ts

@@ -1,23 +1,36 @@
 /**
- * Rate limiter middleware.
+ * Configuration options for a token-bucket rate limiter.
  *
- * Token-bucket rate limiter for controlling request frequency.
+ * @typedef  {Object} RateLimitConfig
+ * @property {number} maxRequests - Maximum number of requests allowed per `windowMs` interval.
+ * @property {number} windowMs    - Duration of the rate-limiting window in milliseconds.
  */
 export interface RateLimitConfig {
-    /** Maximum requests per window. */
     maxRequests: number;
-    /** Window duration in milliseconds. */
     windowMs: number;
 }
+/**
+ * Token-bucket rate limiter. Callers must call {@link RateLimiter.acquire} and
+ * await the returned promise before sending each request. Requests that would
+ * exceed the configured rate are queued and granted once the window refills.
+ */
 export declare class RateLimiter {
     private readonly maxRequests;
     private readonly windowMs;
     private tokens;
     private lastRefill;
     private waitQueue;
+    /**
+     * Creates a new RateLimiter.
+     *
+     * @param {RateLimitConfig} config - Rate-limit parameters.
+     */
     constructor(config: RateLimitConfig);
     /**
-     * Wait until a request token is available.
+     * Acquires a rate-limit token. Resolves immediately when a token is
+     * available, or waits until the current window refills.
+     *
+     * @returns {Promise<void>} Resolves once a token has been granted to the caller.
      */
     acquire(): Promise<void>;
     private drain;

package/dist/middleware/rate-limiter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/middleware/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAyB;gBAE9B,MAAM,EAAE,eAAe;IAOnC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB9B,OAAO,CAAC,KAAK;IAgBb,OAAO,CAAC,MAAM;CAQf"}
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/middleware/rate-limiter.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAyB;IAE1C;;;;OAIG;gBACS,MAAM,EAAE,eAAe;IAOnC;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B,OAAO,CAAC,KAAK;IAeb,OAAO,CAAC,MAAM;CAQf"}

package/dist/middleware/rate-limiter.js

@@ -1,7 +1,7 @@
 /**
- * Rate limiter middleware.
- *
- * Token-bucket rate limiter for controlling request frequency.
+ * Token-bucket rate limiter. Callers must call {@link RateLimiter.acquire} and
+ * await the returned promise before sending each request. Requests that would
+ * exceed the configured rate are queued and granted once the window refills.
  */
 export class RateLimiter {
     maxRequests;
@@ -9,6 +9,11 @@ export class RateLimiter {
     tokens;
     lastRefill;
     waitQueue = [];
+    /**
+     * Creates a new RateLimiter.
+     *
+     * @param {RateLimitConfig} config - Rate-limit parameters.
+     */
     constructor(config) {
         this.maxRequests = config.maxRequests;
         this.windowMs = config.windowMs;
@@ -16,7 +21,10 @@ export class RateLimiter {
         this.lastRefill = Date.now();
     }
     /**
-     * Wait until a request token is available.
+     * Acquires a rate-limit token. Resolves immediately when a token is
+     * available, or waits until the current window refills.
+     *
+     * @returns {Promise<void>} Resolves once a token has been granted to the caller.
      */
     async acquire() {
         this.refill();
@@ -24,10 +32,8 @@ export class RateLimiter {
             this.tokens--;
             return;
         }
-        // Enqueue and wait for a token to become available
         await new Promise((resolve) => {
             this.waitQueue.push(resolve);
-            // Schedule a refill check after the current window expires
             const elapsed = Date.now() - this.lastRefill;
             const waitMs = Math.max(1, this.windowMs - elapsed);
             setTimeout(() => this.drain(), waitMs);
@@ -40,7 +46,6 @@ export class RateLimiter {
             const next = this.waitQueue.shift();
             next();
         }
-        // If there are still waiters, schedule another drain
         if (this.waitQueue.length > 0) {
             const elapsed = Date.now() - this.lastRefill;
             const waitMs = Math.max(1, this.windowMs - elapsed);

package/dist/middleware/rate-limiter.js.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/middleware/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,MAAM,OAAO,WAAW;IACL,WAAW,CAAS;IACpB,QAAQ,CAAS;IAC1B,MAAM,CAAS;IACf,UAAU,CAAS;IACnB,SAAS,GAAsB,EAAE,CAAC;IAE1C,YAAY,MAAuB;QACjC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,MAAM,EAAE,CAAC;QAEd,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QAED,mDAAmD;QACnD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7B,2DAA2D;YAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;YAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC;YACpD,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK;QACX,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAG,CAAC;YACrC,IAAI,EAAE,CAAC;QACT,CAAC;QAED,qDAAqD;QACrD,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;YAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC;YACpD,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAEO,MAAM;QACZ,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC;QACtC,IAAI,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/middleware/rate-limiter.ts"],"names":[],"mappings":"AAaA;;;;GAIG;AACH,MAAM,OAAO,WAAW;IACL,WAAW,CAAS;IACpB,QAAQ,CAAS;IAC1B,MAAM,CAAS;IACf,UAAU,CAAS;IACnB,SAAS,GAAsB,EAAE,CAAC;IAE1C;;;;OAIG;IACH,YAAY,MAAuB;QACjC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,MAAM,EAAE,CAAC;QAEd,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;YAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC;YACpD,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK;QACX,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAG,CAAC;YACrC,IAAI,EAAE,CAAC;QACT,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;YAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC;YACpD,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAEO,MAAM;QACZ,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC;QACtC,IAAI,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}