nlcurl 0.6.0 → 0.8.0

package/dist/http/pool.d.ts

@@ -1,109 +1,79 @@
 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.
- */
+/** A pooled connection entry. */
 export interface PoolEntry {
+    /** Origin key (scheme + host + port). */
     origin: string;
+    /** Underlying TLS socket. */
     socket: TLSSocket;
-    protocol: "h1" | "h2";
+    /** Negotiated HTTP protocol version. */
+    protocol: "h1" | "h2" | "h3";
+    /** HTTP/2 multiplexing client, if this is an h2 connection. */
     h2Client?: H2Client;
+    /** Timestamp when the connection was created. */
     createdAt: number;
+    /** Timestamp when the connection was last used. */
     lastUsed: number;
+    /** Whether the connection is currently in use. */
     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.
- */
+/** Connection pool configuration. */
 export interface PoolOptions {
+    /** Maximum connections per origin. */
     maxConnectionsPerOrigin?: number;
+    /** Maximum total connections across all origins. */
     maxTotalConnections?: number;
+    /** Idle timeout in milliseconds before connections are closed. */
     idleTimeout?: number;
+    /** Maximum connection 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.
- */
+/** HTTP connection pool with idle eviction and per-origin limits. */
 export declare class ConnectionPool {
     private readonly options;
     private readonly connections;
     private totalConnections;
     private cleanupTimer;
     /**
-     * Creates a new ConnectionPool.
+     * Create a new connection pool.
      *
-     * @param {PoolOptions} [options={}] - Pool configuration; unset fields use their defaults.
+     * @param {PoolOptions} [options] - Pool configuration.
      */
     constructor(options?: PoolOptions);
     /**
-     * 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.
+     * Get an available connection for the given origin.
      *
-     * @param {string} origin - Origin key in `protocol://hostname:port` form.
-     * @returns {PoolEntry|undefined} A ready connection entry, or `undefined` if none is available.
+     * @param {string} origin - Origin to look up.
+     * @returns {PoolEntry|undefined} A pool entry, or `undefined` if none is available.
      */
     get(origin: string): PoolEntry | undefined;
     /**
-     * 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.
+     * Add a new connection to the pool.
      *
-     * @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.
+     * @param {string} origin - Origin key.
+     * @param {TLSSocket} socket - TLS socket.
+     * @param {"h1"|"h2"|"h3"} protocol - Negotiated protocol.
+     * @param {H2Profile} [h2Profile] - Optional HTTP/2 profile for h2 connections.
+     * @param {Array<[string, string]>} [defaultHeaders] - Default headers for h2 connections.
+     * @returns {PoolEntry} The created pool entry.
      */
-    put(origin: string, socket: TLSSocket, protocol: "h1" | "h2", h2Profile?: H2Profile, defaultHeaders?: Array<[string, string]>): PoolEntry;
+    put(origin: string, socket: TLSSocket, protocol: "h1" | "h2" | "h3", h2Profile?: H2Profile, defaultHeaders?: Array<[string, string]>): PoolEntry;
     /**
-     * Marks an HTTP/1.1 pool entry as available for reuse once a request has
-     * completed. Updates the `lastUsed` timestamp.
+     * Mark a connection as idle and available for reuse.
      *
-     * @param {PoolEntry} entry - The connection entry to release.
+     * @param {PoolEntry} entry - Pool entry to release.
      */
     release(entry: PoolEntry): void;
     /**
-     * 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.
+     * Remove a connection from the pool and destroy its socket.
      *
-     * @param {PoolEntry} entry - The connection entry to remove and destroy.
+     * @param {PoolEntry} entry - Pool entry to remove.
      */
     remove(entry: PoolEntry): void;
-    /**
-     * Destroys all pooled connections and stops the idle-eviction timer.
-     * The pool must not be used after this call.
-     */
+    /** Close all pooled connections and stop the cleanup timer. */
     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.
-     */
+    /** Total number of connections across all origins. */
     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":"AACA,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,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,GAAG,IAAI,EAAE,SAAS,CAAC,EAAE,SAAS,EAAE,cAAc,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS;IAsCzI;;;;;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"}
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../src/http/pool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,iCAAiC;AACjC,MAAM,WAAW,SAAS;IACxB,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,MAAM,EAAE,SAAS,CAAC;IAClB,wCAAwC;IACxC,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,IAAI,EAAE,OAAO,CAAC;CACf;AAED,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,oDAAoD;IACpD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AASD,qEAAqE;AACrE,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;IAUrC;;;;;OAKG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAyB1C;;;;;;;;;OASG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,EAAE,SAAS,CAAC,EAAE,SAAS,EAAE,cAAc,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS;IAsChJ;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAK/B;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAe9B,+DAA+D;IAC/D,KAAK,IAAI,IAAI;IAgBb,sDAAsD;IACtD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,SAAS;IAkBjB,OAAO,CAAC,WAAW;CAiBpB"}

package/dist/http/pool.js

@@ -5,36 +5,31 @@ 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.
- */
+/** HTTP connection pool with idle eviction and per-origin limits. */
 export class ConnectionPool {
     options;
     connections = new Map();
     totalConnections = 0;
     cleanupTimer;
     /**
-     * Creates a new ConnectionPool.
+     * Create a new connection pool.
      *
-     * @param {PoolOptions} [options={}] - Pool configuration; unset fields use their defaults.
+     * @param {PoolOptions} [options] - Pool configuration.
      */
     constructor(options = {}) {
         this.options = { ...DEFAULT_POOL_OPTIONS, ...options };
-        this.cleanupTimer = setInterval(() => this.evictIdle(), 30_000);
+        this.cleanupTimer = setInterval(() => {
+            this.evictIdle();
+        }, 30_000);
         if (this.cleanupTimer.unref) {
             this.cleanupTimer.unref();
         }
     }
     /**
-     * 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.
+     * Get an available connection for the given origin.
      *
-     * @param {string} origin - Origin key in `protocol://hostname:port` form.
-     * @returns {PoolEntry|undefined} A ready connection entry, or `undefined` if none is available.
+     * @param {string} origin - Origin to look up.
+     * @returns {PoolEntry|undefined} A pool entry, or `undefined` if none is available.
      */
     get(origin) {
         const entries = this.connections.get(origin);
@@ -58,17 +53,14 @@ export class ConnectionPool {
         return undefined;
     }
     /**
-     * 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.
+     * Add a new connection to the pool.
      *
-     * @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.
+     * @param {string} origin - Origin key.
+     * @param {TLSSocket} socket - TLS socket.
+     * @param {"h1"|"h2"|"h3"} protocol - Negotiated protocol.
+     * @param {H2Profile} [h2Profile] - Optional HTTP/2 profile for h2 connections.
+     * @param {Array<[string, string]>} [defaultHeaders] - Default headers for h2 connections.
+     * @returns {PoolEntry} The created pool entry.
      */
     put(origin, socket, protocol, h2Profile, defaultHeaders) {
         if (this.totalConnections >= this.options.maxTotalConnections) {
@@ -102,21 +94,18 @@ export class ConnectionPool {
         return entry;
     }
     /**
-     * Marks an HTTP/1.1 pool entry as available for reuse once a request has
-     * completed. Updates the `lastUsed` timestamp.
+     * Mark a connection as idle and available for reuse.
      *
-     * @param {PoolEntry} entry - The connection entry to release.
+     * @param {PoolEntry} entry - Pool entry to release.
      */
     release(entry) {
         entry.busy = false;
         entry.lastUsed = Date.now();
     }
     /**
-     * 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.
+     * Remove a connection from the pool and destroy its socket.
      *
-     * @param {PoolEntry} entry - The connection entry to remove and destroy.
+     * @param {PoolEntry} entry - Pool entry to remove.
      */
     remove(entry) {
         const entries = this.connections.get(entry.origin);
@@ -132,10 +121,7 @@ export class ConnectionPool {
         }
         entry.socket.destroyTLS();
     }
-    /**
-     * Destroys all pooled connections and stops the idle-eviction timer.
-     * The pool must not be used after this call.
-     */
+    /** Close all pooled connections and stop the cleanup timer. */
     close() {
         if (this.cleanupTimer) {
             clearInterval(this.cleanupTimer);
@@ -151,12 +137,7 @@ 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.
-     */
+    /** Total number of connections across all origins. */
     get size() {
         return this.totalConnections;
     }

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/http/resumable-upload.d.ts

@@ -0,0 +1,76 @@
+/** State of a resumable upload session. */
+export interface UploadSession {
+    /** Server-assigned upload URL. */
+    uploadUrl: string;
+    /** Number of bytes already uploaded. */
+    offset: number;
+    /** Total size of the upload in bytes. */
+    totalSize: number;
+    /** Whether the upload has been completed. */
+    complete: boolean;
+    /** Timestamp when the session was created. */
+    createdAt: number;
+}
+/** Configuration for resumable upload operations. */
+export interface ResumableUploadConfig {
+    /** Size of each upload chunk in bytes. */
+    chunkSize?: number;
+    /** Maximum number of retry attempts per chunk. */
+    maxRetries?: number;
+    /** Progress callback invoked after each chunk. */
+    onProgress?: (offset: number, total: number) => void;
+}
+/**
+ * Build headers for initiating a new resumable upload.
+ *
+ * @param {number} totalSize - Total upload size in bytes.
+ * @param {string} [contentType] - MIME type of the upload content.
+ * @returns {Record<string, string>} Header record for the upload creation request.
+ */
+export declare function buildUploadCreationHeaders(totalSize: number, contentType?: string): Record<string, string>;
+/**
+ * Build headers for resuming an upload at a given offset.
+ *
+ * @param {number} offset - Byte offset to resume from.
+ * @param {number} chunkSize - Size of the chunk being sent.
+ * @param {boolean} isLast - Whether this is the final chunk.
+ * @returns {Record<string, string>} Header record for the resume request.
+ */
+export declare function buildUploadResumeHeaders(offset: number, chunkSize: number, isLast: boolean): Record<string, string>;
+/**
+ * Build headers for querying the current upload offset.
+ *
+ * @returns {Record<string, string>} Header record for the offset query request.
+ */
+export declare function buildUploadOffsetHeaders(): Record<string, string>;
+/**
+ * Parse the upload offset from response headers.
+ *
+ * @param {Record<string, string>} headers - Response headers.
+ * @returns {number} Byte offset, or -1 if not present or invalid.
+ */
+export declare function parseUploadOffset(headers: Record<string, string>): number;
+/**
+ * Check whether the upload is marked as complete in response headers.
+ *
+ * @param {Record<string, string>} headers - Response headers.
+ * @returns {boolean} `true` if the upload-complete header is "?1".
+ */
+export declare function isUploadComplete(headers: Record<string, string>): boolean;
+/**
+ * Split a buffer into offset-chunk pairs for resumable upload.
+ *
+ * @param {Buffer} data - Data to split.
+ * @param {number} [chunkSize] - Maximum chunk size in bytes.
+ * @returns {Array<[number, Buffer]>} Array of [offset, chunk] tuples.
+ */
+export declare function splitIntoChunks(data: Buffer, chunkSize?: number): Array<[number, Buffer]>;
+/**
+ * Extract the upload URL from response headers.
+ *
+ * @param {Record<string, string>} headers - Response headers.
+ * @param {string} requestUrl - Original request URL for resolving relative locations.
+ * @returns {string | null} Absolute upload URL, or `null` if not present.
+ */
+export declare function parseUploadUrl(headers: Record<string, string>, requestUrl: string): string | null;
+//# sourceMappingURL=resumable-upload.d.ts.map

package/dist/http/resumable-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resumable-upload.d.ts","sourceRoot":"","sources":["../../src/http/resumable-upload.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,QAAQ,EAAE,OAAO,CAAC;IAClB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qDAAqD;AACrD,MAAM,WAAW,qBAAqB;IACpC,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACtD;AAKD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO1G;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQnH;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIjE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAKzE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAGzE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAUzF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQjG"}

package/dist/http/resumable-upload.js

@@ -0,0 +1,104 @@
+const DEFAULT_CHUNK_SIZE = 5 * 1024 * 1024;
+const UPLOAD_CONTENT_TYPE = "application/partial-upload";
+/**
+ * Build headers for initiating a new resumable upload.
+ *
+ * @param {number} totalSize - Total upload size in bytes.
+ * @param {string} [contentType] - MIME type of the upload content.
+ * @returns {Record<string, string>} Header record for the upload creation request.
+ */
+export function buildUploadCreationHeaders(totalSize, contentType) {
+    return {
+        "upload-complete": "?0",
+        "upload-draft-interop-version": "7",
+        "content-type": contentType ?? "application/octet-stream",
+        "content-length": String(totalSize),
+    };
+}
+/**
+ * Build headers for resuming an upload at a given offset.
+ *
+ * @param {number} offset - Byte offset to resume from.
+ * @param {number} chunkSize - Size of the chunk being sent.
+ * @param {boolean} isLast - Whether this is the final chunk.
+ * @returns {Record<string, string>} Header record for the resume request.
+ */
+export function buildUploadResumeHeaders(offset, chunkSize, isLast) {
+    return {
+        "upload-offset": String(offset),
+        "upload-complete": isLast ? "?1" : "?0",
+        "upload-draft-interop-version": "7",
+        "content-type": UPLOAD_CONTENT_TYPE,
+        "content-length": String(chunkSize),
+    };
+}
+/**
+ * Build headers for querying the current upload offset.
+ *
+ * @returns {Record<string, string>} Header record for the offset query request.
+ */
+export function buildUploadOffsetHeaders() {
+    return {
+        "upload-draft-interop-version": "7",
+    };
+}
+/**
+ * Parse the upload offset from response headers.
+ *
+ * @param {Record<string, string>} headers - Response headers.
+ * @returns {number} Byte offset, or -1 if not present or invalid.
+ */
+export function parseUploadOffset(headers) {
+    const val = headers["upload-offset"];
+    if (!val)
+        return -1;
+    const offset = parseInt(val, 10);
+    return Number.isFinite(offset) && offset >= 0 ? offset : -1;
+}
+/**
+ * Check whether the upload is marked as complete in response headers.
+ *
+ * @param {Record<string, string>} headers - Response headers.
+ * @returns {boolean} `true` if the upload-complete header is "?1".
+ */
+export function isUploadComplete(headers) {
+    const val = headers["upload-complete"];
+    return val === "?1";
+}
+/**
+ * Split a buffer into offset-chunk pairs for resumable upload.
+ *
+ * @param {Buffer} data - Data to split.
+ * @param {number} [chunkSize] - Maximum chunk size in bytes.
+ * @returns {Array<[number, Buffer]>} Array of [offset, chunk] tuples.
+ */
+export function splitIntoChunks(data, chunkSize) {
+    const size = chunkSize ?? DEFAULT_CHUNK_SIZE;
+    const chunks = [];
+    let offset = 0;
+    while (offset < data.length) {
+        const end = Math.min(offset + size, data.length);
+        chunks.push([offset, data.subarray(offset, end)]);
+        offset = end;
+    }
+    return chunks;
+}
+/**
+ * Extract the upload URL from response headers.
+ *
+ * @param {Record<string, string>} headers - Response headers.
+ * @param {string} requestUrl - Original request URL for resolving relative locations.
+ * @returns {string | null} Absolute upload URL, or `null` if not present.
+ */
+export function parseUploadUrl(headers, requestUrl) {
+    const location = headers["location"];
+    if (!location)
+        return null;
+    try {
+        return new URL(location, requestUrl).href;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=resumable-upload.js.map

package/dist/http/resumable-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resumable-upload.js","sourceRoot":"","sources":["../../src/http/resumable-upload.ts"],"names":[],"mappings":"AAwBA,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAC3C,MAAM,mBAAmB,GAAG,4BAA4B,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CAAC,SAAiB,EAAE,WAAoB;IAChF,OAAO;QACL,iBAAiB,EAAE,IAAI;QACvB,8BAA8B,EAAE,GAAG;QACnC,cAAc,EAAE,WAAW,IAAI,0BAA0B;QACzD,gBAAgB,EAAE,MAAM,CAAC,SAAS,CAAC;KACpC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAc,EAAE,SAAiB,EAAE,MAAe;IACzF,OAAO;QACL,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC;QAC/B,iBAAiB,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;QACvC,8BAA8B,EAAE,GAAG;QACnC,cAAc,EAAE,mBAAmB;QACnC,gBAAgB,EAAE,MAAM,CAAC,SAAS,CAAC;KACpC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,8BAA8B,EAAE,GAAG;KACpC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA+B;IAC/D,MAAM,GAAG,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG;QAAE,OAAO,CAAC,CAAC,CAAC;IACpB,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAA+B;IAC9D,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACvC,OAAO,GAAG,KAAK,IAAI,CAAC;AACtB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,SAAkB;IAC9D,MAAM,IAAI,GAAG,SAAS,IAAI,kBAAkB,CAAC;IAC7C,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACjD,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,CAAC;IACf,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,OAA+B,EAAE,UAAkB;IAChF,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/http/trailers.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Check whether a header name is allowed as an HTTP trailer field.
+ *
+ * @param {string} name - Header field name.
+ * @returns {boolean} `true` if the name is not in the forbidden trailer fields set.
+ */
+export declare function isValidTrailerField(name: string): boolean;
+/**
+ * Serialize trailer fields into a wire-format buffer.
+ *
+ * @param {Record<string, string>} trailers - Key-value pairs of trailer fields.
+ * @returns {Buffer} CRLF-delimited buffer of valid trailer fields.
+ */
+export declare function serializeTrailers(trailers: Record<string, string>): Buffer;
+/**
+ * Parse trailer field data into a key-value record.
+ *
+ * @param {Buffer} data - Raw trailer data buffer.
+ * @returns {Record<string, string>} Parsed trailer fields keyed by lowercase name.
+ */
+export declare function parseTrailers(data: Buffer): Record<string, string>;
+/**
+ * Build a Trailer header value listing the trailer field names.
+ *
+ * @param {string[]} fieldNames - Trailer field names to advertise.
+ * @returns {string} Comma-separated string of valid trailer field names.
+ */
+export declare function buildTrailerHeader(fieldNames: string[]): string;
+//# sourceMappingURL=trailers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trailers.d.ts","sourceRoot":"","sources":["../../src/http/trailers.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAQ1E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAclE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAE/D"}

package/dist/http/trailers.js

@@ -0,0 +1,57 @@
+const FORBIDDEN_TRAILER_FIELDS = new Set(["transfer-encoding", "content-length", "host", "cache-control", "expect", "max-forwards", "pragma", "range", "te", "authorization", "content-encoding", "content-range", "content-type", "trailer", "set-cookie"]);
+/**
+ * Check whether a header name is allowed as an HTTP trailer field.
+ *
+ * @param {string} name - Header field name.
+ * @returns {boolean} `true` if the name is not in the forbidden trailer fields set.
+ */
+export function isValidTrailerField(name) {
+    return !FORBIDDEN_TRAILER_FIELDS.has(name.toLowerCase());
+}
+/**
+ * Serialize trailer fields into a wire-format buffer.
+ *
+ * @param {Record<string, string>} trailers - Key-value pairs of trailer fields.
+ * @returns {Buffer} CRLF-delimited buffer of valid trailer fields.
+ */
+export function serializeTrailers(trailers) {
+    const lines = [];
+    for (const [name, value] of Object.entries(trailers)) {
+        if (isValidTrailerField(name)) {
+            lines.push(`${name}: ${value}`);
+        }
+    }
+    return Buffer.from(lines.join("\r\n") + "\r\n", "ascii");
+}
+/**
+ * Parse trailer field data into a key-value record.
+ *
+ * @param {Buffer} data - Raw trailer data buffer.
+ * @returns {Record<string, string>} Parsed trailer fields keyed by lowercase name.
+ */
+export function parseTrailers(data) {
+    const trailers = {};
+    const text = data.toString("ascii");
+    const lines = text.split("\r\n");
+    for (const line of lines) {
+        const colonIdx = line.indexOf(":");
+        if (colonIdx < 0)
+            continue;
+        const name = line.substring(0, colonIdx).trim().toLowerCase();
+        const value = line.substring(colonIdx + 1).trim();
+        if (name && isValidTrailerField(name)) {
+            trailers[name] = value;
+        }
+    }
+    return trailers;
+}
+/**
+ * Build a Trailer header value listing the trailer field names.
+ *
+ * @param {string[]} fieldNames - Trailer field names to advertise.
+ * @returns {string} Comma-separated string of valid trailer field names.
+ */
+export function buildTrailerHeader(fieldNames) {
+    return fieldNames.filter(isValidTrailerField).join(", ");
+}
+//# sourceMappingURL=trailers.js.map

package/dist/http/trailers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trailers.js","sourceRoot":"","sources":["../../src/http/trailers.ts"],"names":[],"mappings":"AAAA,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC,CAAC,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,kBAAkB,EAAE,eAAe,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;AAE7P;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,CAAC,wBAAwB,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgC;IAChE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrD,IAAI,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,QAAQ,GAAG,CAAC;YAAE,SAAS;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,IAAI,IAAI,IAAI,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAoB;IACrD,OAAO,UAAU,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC"}