dcl-catalyst-client 22.0.0 → 22.0.1-38601546385.commit-cee8815

package/dist/client/types.d.ts

@@ -28,6 +28,9 @@ export type FetchResponse = {
     json(): Promise<any>;
     text(): Promise<string>;
     arrayBuffer(): Promise<ArrayBuffer>;
+    headers?: {
+        get(name: string): string | null;
+    };
 };
 /**
  * The fetch component the client depends on.
@@ -69,6 +72,68 @@ export type ServerMetadata = {
 export type ParallelConfig = {
     urls: string[];
 };
+export type PartialDeploymentProgress = {
+    /** Bytes of content confirmed on the server so far (includes content already present before the upload). */
+    uploadedBytes: number;
+    /** Total bytes of the entity's content files. */
+    totalBytes: number;
+    /** Number of batches confirmed staged so far. */
+    completedBatches: number;
+    /** Total number of batches known so far; grows if the server reports more content missing. */
+    totalBatches: number;
+};
+/**
+ * Stage of an upload reported by `onUploadProgress`:
+ * - `checking`: asking the server which files it already stores.
+ * - `uploading`: file bytes are going out.
+ * - `processing`: every scheduled byte was sent; waiting for the server's answer.
+ */
+export type UploadPhase = 'checking' | 'uploading' | 'processing';
+/** Byte-level progress of a deployment upload. */
+export type UploadProgress = {
+    phase: UploadPhase;
+    /**
+     * File bytes handed to the HTTP client so far, summed across requests (multipart overhead excluded).
+     * Never decreases and never exceeds `totalBytes`.
+     */
+    sentBytes: number;
+    /**
+     * File bytes the deployment must send: files the server already stores are excluded, and the entity
+     * file is included when sent. Grows when content is re-sent (retries, the server's `missing` list).
+     * While `checking`, it is every candidate file.
+     */
+    totalBytes: number;
+};
+export type UploadProgressOptions = {
+    /**
+     * Invoked with byte-level upload progress, at most every 200 ms plus on every phase change. With
+     * {@link ClientOptions.streamingUploads} on Node, the request body is streamed and counted as it is
+     * handed to the HTTP client; otherwise a request's bytes count as sent when its response arrives.
+     */
+    onUploadProgress?: (progress: UploadProgress) => void;
+};
+export type PartialDeploymentOptions = UploadProgressOptions & {
+    /**
+     * Max summed file bytes per request. Default {@link DEFAULT_MAX_BATCH_SIZE_BYTES} (100 MiB — safely
+     * under the ~200MB request ceiling of the infrastructure in front of the content servers).
+     */
+    maxBatchSizeBytes?: number;
+    /** Concurrent batch uploads after the first (entity-carrying) request. Default 2. */
+    concurrency?: number;
+    /**
+     * Retries after retryable failures (408, 409, 429, 5xx, network), and rounds allowed without progress
+     * when the server keeps reporting content missing. Both budgets reset whenever the server's missing
+     * list shrinks below its lowest count so far. Default 3.
+     */
+    maxResumeAttempts?: number;
+    /** Base retry delay in ms, doubled on each retry (exponential backoff), never below `Retry-After`. Default 1000. */
+    resumeDelay?: number;
+    /** Invoked after each staged batch with cumulative progress. */
+    onProgress?: (progress: PartialDeploymentProgress) => void;
+};
+export type PartialDeploymentResult = {
+    creationTimestamp: number;
+};
 export type ClientOptions = {
     url: string;
     fetcher: IFetchComponent;
@@ -79,5 +144,15 @@ export type ClientOptions = {
      * @type {ParallelConfig}
      */
     parallelConfig?: ParallelConfig;
+    /**
+     * Declares that `fetcher` can send a streamed deployment body, so `onUploadProgress` counts bytes as
+     * they go out instead of per request. Default false. Only enable it when the fetcher:
+     * - passes `body` to the global (undici) `fetch` of Node >= 18, which accepts a web `ReadableStream`;
+     * - forwards the `duplex: 'half'` option and the `content-length` header unchanged;
+     * - never retries a POST with the same options, since the stream can only be read once.
+     * `@dcl/fetch-component` meets this. node-fetch does not (it would send the stream as a string).
+     * Each request in flight then also holds an encoded copy of its body, about the batch size.
+     */
+    streamingUploads?: boolean;
 };
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AAEpE;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,IAAI,CAAC,EAAE,GAAG,CAAA;IACV,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,CAAA;IACpB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IACvB,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;CACpC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;CAClE,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,yBAAyB,GAAG;IACvD,SAAS,EAAE,SAAS,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAC/B,QAAQ,CAAC,EAAE,GAAG,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,QAAQ,CAAC,EAAE,GAAG,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,EAAE,EAAE,MAAM,CAAA;CACX,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,EAAE,CAAA;CACf,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,eAAe,CAAA;IACxB,MAAM,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAA;IACjC;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,CAAA;CAChC,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"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"}

package/dist/client/utils/batching.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Default cap on the summed file bytes per partial-deployment request. The infrastructure in front of
+ * the content servers times out requests larger than ~200MB, so 100MB keeps a comfortable safety
+ * margin (the cap counts file bytes, not exact wire size — the margin also absorbs multipart overhead
+ * and the entity JSON riding along in the first request) while keeping the request count low for large
+ * scenes. Also under the servers' own request caps (worlds-content-server 350MB, catalyst 2GiB).
+ */
+export declare const DEFAULT_MAX_BATCH_SIZE_BYTES: number;
+export type FileBatch = {
+    hashes: string[];
+    sizeBytes: number;
+};
+/**
+ * Splits files into batches whose summed byte size stays at or below `maxBatchSizeBytes`, using
+ * first-fit-decreasing bin packing. Files are never split, so a file larger than the cap still lands
+ * alone in an over-cap batch; deployPartial rejects such files before uploading. Deterministic given the
+ * same input.
+ */
+export declare function splitIntoBatches(files: Map<string, Uint8Array>, maxBatchSizeBytes: number): FileBatch[];
+//# sourceMappingURL=batching.d.ts.map

package/dist/client/utils/batching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batching.d.ts","sourceRoot":"","sources":["../../../src/client/utils/batching.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,QAAoB,CAAA;AAE7D,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,EAAE,MAAM,GAAG,SAAS,EAAE,CAqBvG"}

package/dist/client/utils/batching.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.splitIntoBatches = exports.DEFAULT_MAX_BATCH_SIZE_BYTES = void 0;
+/**
+ * Default cap on the summed file bytes per partial-deployment request. The infrastructure in front of
+ * the content servers times out requests larger than ~200MB, so 100MB keeps a comfortable safety
+ * margin (the cap counts file bytes, not exact wire size — the margin also absorbs multipart overhead
+ * and the entity JSON riding along in the first request) while keeping the request count low for large
+ * scenes. Also under the servers' own request caps (worlds-content-server 350MB, catalyst 2GiB).
+ */
+exports.DEFAULT_MAX_BATCH_SIZE_BYTES = 100 * 1024 * 1024; // 100 MiB
+/**
+ * Splits files into batches whose summed byte size stays at or below `maxBatchSizeBytes`, using
+ * first-fit-decreasing bin packing. Files are never split, so a file larger than the cap still lands
+ * alone in an over-cap batch; deployPartial rejects such files before uploading. Deterministic given the
+ * same input.
+ */
+function splitIntoBatches(files, maxBatchSizeBytes) {
+    const entries = Array.from(files.entries()).sort((a, b) => b[1].byteLength - a[1].byteLength);
+    const batches = [];
+    for (const [hash, content] of entries) {
+        const size = content.byteLength;
+        let placed = false;
+        for (const batch of batches) {
+            if (batch.sizeBytes + size <= maxBatchSizeBytes) {
+                batch.hashes.push(hash);
+                batch.sizeBytes += size;
+                placed = true;
+                break;
+            }
+        }
+        if (!placed) {
+            batches.push({ hashes: [hash], sizeBytes: size });
+        }
+    }
+    return batches;
+}
+exports.splitIntoBatches = splitIntoBatches;
+//# sourceMappingURL=batching.js.map

package/dist/client/utils/batching.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batching.js","sourceRoot":"","sources":["../../../src/client/utils/batching.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACU,QAAA,4BAA4B,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAA,CAAC,UAAU;AAOxE;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,KAA8B,EAAE,iBAAyB;IACxF,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;IAC7F,MAAM,OAAO,GAAgB,EAAE,CAAA;IAE/B,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,OAAO,EAAE;QACrC,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAA;QAC/B,IAAI,MAAM,GAAG,KAAK,CAAA;QAClB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE;YAC3B,IAAI,KAAK,CAAC,SAAS,GAAG,IAAI,IAAI,iBAAiB,EAAE;gBAC/C,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACvB,KAAK,CAAC,SAAS,IAAI,IAAI,CAAA;gBACvB,MAAM,GAAG,IAAI,CAAA;gBACb,MAAK;aACN;SACF;QACD,IAAI,CAAC,MAAM,EAAE;YACX,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;SAClD;KACF;IAED,OAAO,OAAO,CAAA;AAChB,CAAC;AArBD,4CAqBC"}

package/dist/client/utils/errors.d.ts

@@ -0,0 +1,43 @@
+/** Base error for a failed deployment. Carries the HTTP status and raw response body when available. */
+export declare class DeploymentError extends Error {
+    readonly status?: number | undefined;
+    readonly responseBody?: string | undefined;
+    constructor(message: string, status?: number | undefined, responseBody?: string | undefined);
+}
+/**
+ * The server rejected the deployment with a validation error (HTTP 400) — e.g. the deployment exceeds
+ * the size budget, or a signature/permission check failed. Terminal: retrying will not help.
+ */
+export declare class PartialDeploymentValidationError extends DeploymentError {
+    constructor(message: string, status?: number, responseBody?: string);
+}
+/**
+ * The target server does not support partial deployments: it ran the full deployment pipeline on a
+ * staging request and rejected it because referenced content was not uploaded or stored. Fall back to
+ * `deploy()` (a single request) against such a server. Best-effort detection via the server's error text.
+ */
+export declare class PartialDeploymentNotSupportedError extends DeploymentError {
+    constructor(message: string, status?: number, responseBody?: string);
+}
+/**
+ * A transient failure the resume loop should retry (408, 409, 429, 5xx). Deliberately NOT a
+ * {@link DeploymentError} (those are terminal). `retryAfterMs`, when set from a server `Retry-After`
+ * header, is used as the backoff floor so the client waits out the server's window instead of exhausting
+ * its attempts inside it.
+ */
+export declare class RetryablePartialDeploymentError extends Error {
+    readonly retryAfterMs?: number | undefined;
+    readonly status?: number | undefined;
+    readonly responseBody?: string | undefined;
+    constructor(message: string, retryAfterMs?: number | undefined, status?: number | undefined, responseBody?: string | undefined);
+}
+/**
+ * The server asked to retry later than the client is willing to wait (e.g. a partial-upload quota that
+ * frees up only when older uploads expire). Terminal for this call; `retryAfterMs` says when a new
+ * attempt may succeed, and the message carries the server's explanation.
+ */
+export declare class PartialDeploymentRetryLaterError extends DeploymentError {
+    readonly retryAfterMs: number;
+    constructor(message: string, retryAfterMs: number, status?: number, responseBody?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/client/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/client/utils/errors.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,qBAAa,eAAgB,SAAQ,KAAK;aACK,MAAM,CAAC;aAA0B,YAAY,CAAC;gBAA/E,OAAO,EAAE,MAAM,EAAkB,MAAM,CAAC,oBAAQ,EAAkB,YAAY,CAAC,oBAAQ;CAIpG;AAED;;;GAGG;AACH,qBAAa,gCAAiC,SAAQ,eAAe;gBACvD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;CAIpE;AAED;;;;GAIG;AACH,qBAAa,kCAAmC,SAAQ,eAAe;gBACzD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;CAIpE;AAED;;;;;GAKG;AACH,qBAAa,+BAAgC,SAAQ,KAAK;aAGtC,YAAY,CAAC;aACb,MAAM,CAAC;aACP,YAAY,CAAC;gBAH7B,OAAO,EAAE,MAAM,EACC,YAAY,CAAC,oBAAQ,EACrB,MAAM,CAAC,oBAAQ,EACf,YAAY,CAAC,oBAAQ;CAKxC;AAED;;;;GAIG;AACH,qBAAa,gCAAiC,SAAQ,eAAe;aACtB,YAAY,EAAE,MAAM;gBAArD,OAAO,EAAE,MAAM,EAAkB,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;CAI1G"}

package/dist/client/utils/errors.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PartialDeploymentRetryLaterError = exports.RetryablePartialDeploymentError = exports.PartialDeploymentNotSupportedError = exports.PartialDeploymentValidationError = exports.DeploymentError = void 0;
+/** Base error for a failed deployment. Carries the HTTP status and raw response body when available. */
+class DeploymentError extends Error {
+    constructor(message, status, responseBody) {
+        super(message);
+        this.status = status;
+        this.responseBody = responseBody;
+        this.name = 'DeploymentError';
+    }
+}
+exports.DeploymentError = DeploymentError;
+/**
+ * The server rejected the deployment with a validation error (HTTP 400) — e.g. the deployment exceeds
+ * the size budget, or a signature/permission check failed. Terminal: retrying will not help.
+ */
+class PartialDeploymentValidationError extends DeploymentError {
+    constructor(message, status, responseBody) {
+        super(message, status, responseBody);
+        this.name = 'PartialDeploymentValidationError';
+    }
+}
+exports.PartialDeploymentValidationError = PartialDeploymentValidationError;
+/**
+ * The target server does not support partial deployments: it ran the full deployment pipeline on a
+ * staging request and rejected it because referenced content was not uploaded or stored. Fall back to
+ * `deploy()` (a single request) against such a server. Best-effort detection via the server's error text.
+ */
+class PartialDeploymentNotSupportedError extends DeploymentError {
+    constructor(message, status, responseBody) {
+        super(message, status, responseBody);
+        this.name = 'PartialDeploymentNotSupportedError';
+    }
+}
+exports.PartialDeploymentNotSupportedError = PartialDeploymentNotSupportedError;
+/**
+ * A transient failure the resume loop should retry (408, 409, 429, 5xx). Deliberately NOT a
+ * {@link DeploymentError} (those are terminal). `retryAfterMs`, when set from a server `Retry-After`
+ * header, is used as the backoff floor so the client waits out the server's window instead of exhausting
+ * its attempts inside it.
+ */
+class RetryablePartialDeploymentError extends Error {
+    constructor(message, retryAfterMs, status, responseBody) {
+        super(message);
+        this.retryAfterMs = retryAfterMs;
+        this.status = status;
+        this.responseBody = responseBody;
+        this.name = 'RetryablePartialDeploymentError';
+    }
+}
+exports.RetryablePartialDeploymentError = RetryablePartialDeploymentError;
+/**
+ * The server asked to retry later than the client is willing to wait (e.g. a partial-upload quota that
+ * frees up only when older uploads expire). Terminal for this call; `retryAfterMs` says when a new
+ * attempt may succeed, and the message carries the server's explanation.
+ */
+class PartialDeploymentRetryLaterError extends DeploymentError {
+    constructor(message, retryAfterMs, status, responseBody) {
+        super(message, status, responseBody);
+        this.retryAfterMs = retryAfterMs;
+        this.name = 'PartialDeploymentRetryLaterError';
+    }
+}
+exports.PartialDeploymentRetryLaterError = PartialDeploymentRetryLaterError;
+//# sourceMappingURL=errors.js.map

package/dist/client/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/client/utils/errors.ts"],"names":[],"mappings":";;;AAAA,wGAAwG;AACxG,MAAa,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe,EAAkB,MAAe,EAAkB,YAAqB;QACjG,KAAK,CAAC,OAAO,CAAC,CAAA;QAD6B,WAAM,GAAN,MAAM,CAAS;QAAkB,iBAAY,GAAZ,YAAY,CAAS;QAEjG,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;IAC/B,CAAC;CACF;AALD,0CAKC;AAED;;;GAGG;AACH,MAAa,gCAAiC,SAAQ,eAAe;IACnE,YAAY,OAAe,EAAE,MAAe,EAAE,YAAqB;QACjE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,CAAA;QACpC,IAAI,CAAC,IAAI,GAAG,kCAAkC,CAAA;IAChD,CAAC;CACF;AALD,4EAKC;AAED;;;;GAIG;AACH,MAAa,kCAAmC,SAAQ,eAAe;IACrE,YAAY,OAAe,EAAE,MAAe,EAAE,YAAqB;QACjE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,CAAA;QACpC,IAAI,CAAC,IAAI,GAAG,oCAAoC,CAAA;IAClD,CAAC;CACF;AALD,gFAKC;AAED;;;;;GAKG;AACH,MAAa,+BAAgC,SAAQ,KAAK;IACxD,YACE,OAAe,EACC,YAAqB,EACrB,MAAe,EACf,YAAqB;QAErC,KAAK,CAAC,OAAO,CAAC,CAAA;QAJE,iBAAY,GAAZ,YAAY,CAAS;QACrB,WAAM,GAAN,MAAM,CAAS;QACf,iBAAY,GAAZ,YAAY,CAAS;QAGrC,IAAI,CAAC,IAAI,GAAG,iCAAiC,CAAA;IAC/C,CAAC;CACF;AAVD,0EAUC;AAED;;;;GAIG;AACH,MAAa,gCAAiC,SAAQ,eAAe;IACnE,YAAY,OAAe,EAAkB,YAAoB,EAAE,MAAe,EAAE,YAAqB;QACvG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,CAAA;QADO,iBAAY,GAAZ,YAAY,CAAQ;QAE/D,IAAI,CAAC,IAAI,GAAG,kCAAkC,CAAA;IAChD,CAAC;CACF;AALD,4EAKC"}

package/dist/client/utils/fetcher.d.ts

@@ -1,7 +1,7 @@
 import { IFetchComponent } from '../types';
 type Context = {
     url: string;
-    method: 'get' | 'post' | 'put' | 'delete' | 'patch';
+    method: 'get' | 'head' | 'post' | 'put' | 'delete' | 'patch';
     params?: any;
     data?: any;
     responseType?: string;

package/dist/client/utils/fetcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../../src/client/utils/fetcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE1C,KAAK,OAAO,GAAG;IACb,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAA;IACnD,MAAM,CAAC,EAAE,GAAG,CAAA;IACZ,IAAI,CAAC,EAAE,GAAG,CAAA;IACV,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;AAGrF,eAAO,MAAM,eAAe,8CAA+C,OAAO,oBAWjF,CAAA;AAED,eAAe,eAAe,CAAA"}
+{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../../src/client/utils/fetcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE1C,KAAK,OAAO,GAAG;IACb,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAA;IAC5D,MAAM,CAAC,EAAE,GAAG,CAAA;IACZ,IAAI,CAAC,EAAE,GAAG,CAAA;IACV,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;AAcrF,eAAO,MAAM,eAAe,8CAA+C,OAAO,oBAcjF,CAAA;AAED,eAAe,eAAe,CAAA"}

package/dist/client/utils/fetcher.js

@@ -1,15 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useCustomClient = void 0;
+// Arrays become repeated keys; null and undefined are left out (presence flags would read them as set).
+function toSearchParams(params) {
+    const searchParams = new URLSearchParams();
+    for (const [key, value] of Object.entries(params !== null && params !== void 0 ? params : {})) {
+        for (const item of Array.isArray(value) ? value : [value]) {
+            if (item !== undefined && item !== null)
+                searchParams.append(key, String(item));
+        }
+    }
+    return searchParams;
+}
 // NOTE: used by orval generator
 const useCustomClient = ({ url, method, params, data, headers }) => {
     const relPath = url.substring('/lambdas'.length + 1);
     return async function (baseUrl, fetch) {
-        const response = await fetch.fetch(`${baseUrl}/${relPath}?` + new URLSearchParams(params), {
+        const response = await fetch.fetch(`${baseUrl}/${relPath}?` + toSearchParams(params), {
             method,
             headers,
             ...(data ? { body: JSON.stringify(data) } : {})
         });
+        // A HEAD response has no body to parse.
+        if (method === 'head')
+            return undefined;
         return response.json();
     };
 };

package/dist/client/utils/fetcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetcher.js","sourceRoot":"","sources":["../../../src/client/utils/fetcher.ts"],"names":[],"mappings":";;;AAaA,gCAAgC;AACzB,MAAM,eAAe,GAAG,CAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAW,EAAmB,EAAE;IACrG,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACpD,OAAO,KAAK,WAAW,OAAe,EAAE,KAAsB;QAC5D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,OAAO,GAAG,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE;YACzF,MAAM;YACN,OAAO;YACP,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChD,CAAC,CAAA;QAEF,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAA;IACxB,CAAC,CAAA;AACH,CAAC,CAAA;AAXY,QAAA,eAAe,mBAW3B;AAED,kBAAe,uBAAe,CAAA"}
+{"version":3,"file":"fetcher.js","sourceRoot":"","sources":["../../../src/client/utils/fetcher.ts"],"names":[],"mappings":";;;AAaA,wGAAwG;AACxG,SAAS,cAAc,CAAC,MAAgC;IACtD,MAAM,YAAY,GAAG,IAAI,eAAe,EAAE,CAAA;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,EAAE,CAAC,EAAE;QACvD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE;YACzD,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI;gBAAE,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;SAChF;KACF;IACD,OAAO,YAAY,CAAA;AACrB,CAAC;AAED,gCAAgC;AACzB,MAAM,eAAe,GAAG,CAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAW,EAAmB,EAAE;IACrG,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACpD,OAAO,KAAK,WAAW,OAAe,EAAE,KAAsB;QAC5D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,OAAO,GAAG,GAAG,cAAc,CAAC,MAAM,CAAC,EAAE;YACpF,MAAM;YACN,OAAO;YACP,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChD,CAAC,CAAA;QAEF,wCAAwC;QACxC,IAAI,MAAM,KAAK,MAAM;YAAE,OAAO,SAAc,CAAA;QAE5C,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAA;IACxB,CAAC,CAAA;AACH,CAAC,CAAA;AAdY,QAAA,eAAe,mBAc3B;AAED,kBAAe,uBAAe,CAAA"}

package/dist/client/utils/upload-progress.d.ts

@@ -0,0 +1,57 @@
+import { UploadProgress } from '../types';
+export declare const UPLOAD_PROGRESS_INTERVAL_MS = 200;
+export declare const UPLOAD_SLICE_BYTES: number;
+/** Whether request bodies can be streamed (and so counted as they go out): only on Node. */
+export declare function supportsStreamingUpload(): boolean;
+/**
+ * Whether `error` is the rejection of a fetcher that dropped the `duplex` option of a streamed body.
+ * Targets undici's "TypeError: RequestInit: duplex option is required when sending a body."
+ */
+export declare function isDuplexUnsupportedError(error: unknown): boolean;
+export type CountingBody = {
+    body: ReadableStream<Uint8Array>;
+    headers: {
+        'content-type': string;
+        'content-length': string;
+    };
+    /** Releases the encoded body and stops the stream if it is still open. */
+    dispose: () => void;
+};
+/**
+ * Encodes `form` once and returns a stream of it that calls `onStreamed` with the cumulative
+ * number of body bytes handed to the HTTP client, one slice at a time.
+ */
+export declare function createCountingBody(url: string, form: FormData, onStreamed: (streamedBytes: number, bodyBytes: number) => void, signal?: AbortSignal): Promise<CountingBody>;
+/** Returns `headers` plus `extra`, dropping any caller header that `extra` replaces (case-insensitive). */
+export declare function withBodyHeaders(headers: Record<string, string> | undefined, extra: Record<string, string>): Record<string, string>;
+/** Progress of one request, in file bytes. */
+export type UploadRequestProgress = {
+    /** Body bytes streamed so far; converted to file bytes proportionally. */
+    streamed(streamedBytes: number, bodyBytes: number): void;
+    /** The body won't be streamed after all: its bytes count when the response arrives. */
+    unstreamed(): void;
+    /** A response arrived for an unstreamed body: all its file bytes count as sent. */
+    delivered(): void;
+    /** The request ended. Bytes it never sent leave the total only once a retry or success follows. */
+    end(): void;
+};
+export type UploadProgressTracker = {
+    /** Reports the `/available-content` check, with every candidate file as the provisional total. */
+    checking(candidateBytes: number): void;
+    /** Adds the file bytes a round of requests is about to send, dropping what earlier rounds never sent. */
+    plan(fileBytes: number): void;
+    /** Starts a request carrying `fileBytes` of the planned bytes; `streaming` when its body is counted. */
+    request(fileBytes: number, streaming: boolean): UploadRequestProgress;
+    /** The deployment succeeded: emits `processing` with every byte sent, then stops. */
+    complete(): void;
+    /** The deployment failed: stops without emitting. */
+    close(): void;
+};
+/**
+ * Runs `upload`, completing the tracker when it succeeds and closing it silently when it rejects or
+ * `succeeded` rejects its result (e.g. an error response the caller still receives).
+ */
+export declare function trackUpload<T>(tracker: UploadProgressTracker | undefined, upload: () => Promise<T>, succeeded?: (result: T) => boolean): Promise<T>;
+/** Tracks byte-level upload progress across requests, throttling events to `onUploadProgress`. */
+export declare function createUploadProgressTracker(onUploadProgress: (progress: UploadProgress) => void, now?: () => number, intervalMs?: number): UploadProgressTracker;
+//# sourceMappingURL=upload-progress.d.ts.map

package/dist/client/utils/upload-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-progress.d.ts","sourceRoot":"","sources":["../../../src/client/utils/upload-progress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,cAAc,EAAE,MAAM,UAAU,CAAA;AAGtD,eAAO,MAAM,2BAA2B,MAAM,CAAA;AAG9C,eAAO,MAAM,kBAAkB,QAAa,CAAA;AAE5C,4FAA4F;AAC5F,wBAAgB,uBAAuB,IAAI,OAAO,CAEjD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEhE;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,CAAA;IAChC,OAAO,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7D,0EAA0E;IAC1E,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB,CAAA;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,QAAQ,EACd,UAAU,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,EAC9D,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,CAsDvB;AAED,2GAA2G;AAC3G,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC3C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIxB;AAED,8CAA8C;AAC9C,MAAM,MAAM,qBAAqB,GAAG;IAClC,0EAA0E;IAC1E,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxD,uFAAuF;IACvF,UAAU,IAAI,IAAI,CAAA;IAClB,mFAAmF;IACnF,SAAS,IAAI,IAAI,CAAA;IACjB,mGAAmG;IACnG,GAAG,IAAI,IAAI,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,kGAAkG;IAClG,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IACtC,yGAAyG;IACzG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,wGAAwG;IACxG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,qBAAqB,CAAA;IACrE,qFAAqF;IACrF,QAAQ,IAAI,IAAI,CAAA;IAChB,qDAAqD;IACrD,KAAK,IAAI,IAAI,CAAA;CACd,CAAA;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE,qBAAqB,GAAG,SAAS,EAC1C,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACxB,SAAS,GAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAoB,GAC7C,OAAO,CAAC,CAAC,CAAC,CAUZ;AAED,kGAAkG;AAClG,wBAAgB,2BAA2B,CACzC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,EACpD,GAAG,GAAE,MAAM,MAAiB,EAC5B,UAAU,GAAE,MAAoC,GAC/C,qBAAqB,CAoIvB"}