dcl-catalyst-client 22.0.0 → 22.0.1-38482794215.commit-a4a4e71

package/dist/client/index.js

@@ -14,7 +14,13 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.PartialDeploymentValidationError = exports.PartialDeploymentRetryLaterError = exports.PartialDeploymentNotSupportedError = exports.DeploymentError = void 0;
 __exportStar(require("./utils/DeploymentBuilder"), exports);
+var errors_1 = require("./utils/errors");
+Object.defineProperty(exports, "DeploymentError", { enumerable: true, get: function () { return errors_1.DeploymentError; } });
+Object.defineProperty(exports, "PartialDeploymentNotSupportedError", { enumerable: true, get: function () { return errors_1.PartialDeploymentNotSupportedError; } });
+Object.defineProperty(exports, "PartialDeploymentRetryLaterError", { enumerable: true, get: function () { return errors_1.PartialDeploymentRetryLaterError; } });
+Object.defineProperty(exports, "PartialDeploymentValidationError", { enumerable: true, get: function () { return errors_1.PartialDeploymentValidationError; } });
 __exportStar(require("./CatalystClient"), exports);
 __exportStar(require("./ContentClient"), exports);
 __exportStar(require("./LambdasClient"), exports);

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAAyC;AACzC,mDAAgC;AAChC,kDAA+B;AAC/B,kDAA+B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4DAAyC;AACzC,yCAKuB;AAJrB,yGAAA,eAAe,OAAA;AACf,4HAAA,kCAAkC,OAAA;AAClC,0HAAA,gCAAgC,OAAA;AAChC,0HAAA,gCAAgC,OAAA;AAElC,mDAAgC;AAChC,kDAA+B;AAC/B,kDAA+B"}

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/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"}

package/dist/client/utils/upload-progress.js

@@ -0,0 +1,246 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createUploadProgressTracker = exports.trackUpload = exports.withBodyHeaders = exports.createCountingBody = exports.isDuplexUnsupportedError = exports.supportsStreamingUpload = exports.UPLOAD_SLICE_BYTES = exports.UPLOAD_PROGRESS_INTERVAL_MS = void 0;
+// Minimum time between two progress events of the same phase.
+exports.UPLOAD_PROGRESS_INTERVAL_MS = 200;
+// Size of each body slice handed to the HTTP client, and so the granularity of the progress.
+exports.UPLOAD_SLICE_BYTES = 256 * 1024;
+/** Whether request bodies can be streamed (and so counted as they go out): only on Node. */
+function supportsStreamingUpload() {
+    var _a;
+    return typeof process !== 'undefined' && !!((_a = process.versions) === null || _a === void 0 ? void 0 : _a.node);
+}
+exports.supportsStreamingUpload = supportsStreamingUpload;
+/**
+ * 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."
+ */
+function isDuplexUnsupportedError(error) {
+    return error instanceof TypeError && /duplex/i.test(error.message);
+}
+exports.isDuplexUnsupportedError = isDuplexUnsupportedError;
+/**
+ * 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.
+ */
+async function createCountingBody(url, form, onStreamed, signal) {
+    var _a;
+    const encoded = new Request(url, { method: 'POST', body: form });
+    const contentType = (_a = encoded.headers.get('content-type')) !== null && _a !== void 0 ? _a : 'multipart/form-data';
+    let bytes = new Uint8Array(await encoded.arrayBuffer());
+    const bodyBytes = bytes.byteLength;
+    let offset = 0;
+    let stream;
+    // Releases the encoded body and, if the stream is still open, errors it so the HTTP client stops reading.
+    const stop = (reason) => {
+        signal === null || signal === void 0 ? void 0 : signal.removeEventListener('abort', onAbort);
+        const controller = stream;
+        bytes = undefined;
+        stream = undefined;
+        controller === null || controller === void 0 ? void 0 : controller.error(reason !== null && reason !== void 0 ? reason : new Error('The upload stopped.'));
+    };
+    function onAbort() {
+        var _a;
+        stop((_a = signal === null || signal === void 0 ? void 0 : signal.reason) !== null && _a !== void 0 ? _a : new Error('The upload was aborted.'));
+    }
+    const body = new ReadableStream({
+        start(controller) {
+            stream = controller;
+            if (signal === null || signal === void 0 ? void 0 : signal.aborted)
+                onAbort();
+            else
+                signal === null || signal === void 0 ? void 0 : signal.addEventListener('abort', onAbort, { once: true });
+        },
+        pull(controller) {
+            if (!bytes)
+                return;
+            const slice = bytes.subarray(offset, offset + exports.UPLOAD_SLICE_BYTES);
+            offset += slice.byteLength;
+            controller.enqueue(slice);
+            if (offset >= bodyBytes) {
+                signal === null || signal === void 0 ? void 0 : signal.removeEventListener('abort', onAbort);
+                bytes = undefined;
+                stream = undefined;
+                controller.close();
+            }
+            onStreamed(offset, bodyBytes);
+        },
+        cancel() {
+            stream = undefined;
+            stop();
+        }
+    }, 
+    // Pull only when the HTTP client reads, so a slice is counted when it is handed over.
+    { highWaterMark: 0 });
+    return {
+        body,
+        headers: { 'content-type': contentType, 'content-length': String(bodyBytes) },
+        dispose: () => stop()
+    };
+}
+exports.createCountingBody = createCountingBody;
+/** Returns `headers` plus `extra`, dropping any caller header that `extra` replaces (case-insensitive). */
+function withBodyHeaders(headers, extra) {
+    const replaced = new Set(Object.keys(extra).map((name) => name.toLowerCase()));
+    const kept = Object.entries(headers !== null && headers !== void 0 ? headers : {}).filter(([name]) => !replaced.has(name.toLowerCase()));
+    return { ...Object.fromEntries(kept), ...extra };
+}
+exports.withBodyHeaders = withBodyHeaders;
+/**
+ * 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).
+ */
+async function trackUpload(tracker, upload, succeeded = () => true) {
+    try {
+        const result = await upload();
+        if (succeeded(result))
+            tracker === null || tracker === void 0 ? void 0 : tracker.complete();
+        else
+            tracker === null || tracker === void 0 ? void 0 : tracker.close();
+        return result;
+    }
+    catch (error) {
+        tracker === null || tracker === void 0 ? void 0 : tracker.close();
+        throw error;
+    }
+}
+exports.trackUpload = trackUpload;
+/** Tracks byte-level upload progress across requests, throttling events to `onUploadProgress`. */
+function createUploadProgressTracker(onUploadProgress, now = Date.now, intervalMs = exports.UPLOAD_PROGRESS_INTERVAL_MS) {
+    let phase;
+    let sentBytes = 0;
+    let totalBytes = 0;
+    // Planned bytes no request has taken yet, and bytes of ended requests that were never sent.
+    let unstartedBytes = 0;
+    let unsentBytes = 0;
+    let inFlight = 0;
+    let lastEmitAt = -Infinity;
+    let pending = false;
+    let closed = false;
+    let trailing;
+    let last;
+    const clearTrailing = () => {
+        if (trailing !== undefined)
+            clearTimeout(trailing);
+        trailing = undefined;
+    };
+    const emit = () => {
+        clearTrailing();
+        pending = false;
+        if (!phase || closed)
+            return;
+        lastEmitAt = now();
+        const progress = { phase, sentBytes: Math.min(sentBytes, totalBytes), totalBytes };
+        if (last &&
+            last.phase === progress.phase &&
+            last.sentBytes === progress.sentBytes &&
+            last.totalBytes === progress.totalBytes) {
+            return;
+        }
+        last = progress;
+        onUploadProgress(progress);
+    };
+    const update = () => {
+        var _a, _b;
+        const elapsed = now() - lastEmitAt;
+        if (elapsed >= intervalMs)
+            return emit();
+        pending = true;
+        // Trailing edge, so a stalled upload still reports its latest count.
+        if (trailing === undefined && !closed) {
+            trailing = setTimeout(emit, intervalMs - elapsed);
+            (_b = (_a = trailing).unref) === null || _b === void 0 ? void 0 : _b.call(_a);
+        }
+    };
+    const setPhase = (next) => {
+        if (next === phase)
+            return update();
+        // The last count of the previous phase goes out before the phase changes.
+        if (pending)
+            emit();
+        phase = next;
+        emit();
+    };
+    // `processing` only once every scheduled byte is sent and responses are pending.
+    const refreshPhase = () => {
+        if (inFlight === 0)
+            return;
+        const next = sentBytes >= totalBytes ? 'processing' : 'uploading';
+        if (next !== phase)
+            setPhase(next);
+    };
+    const dropUnsent = () => {
+        totalBytes -= unstartedBytes + unsentBytes;
+        unstartedBytes = 0;
+        unsentBytes = 0;
+    };
+    return {
+        checking(candidateBytes) {
+            totalBytes = candidateBytes;
+            setPhase('checking');
+        },
+        plan(fileBytes) {
+            if (phase === 'checking')
+                totalBytes = 0;
+            dropUnsent();
+            totalBytes += fileBytes;
+            unstartedBytes += fileBytes;
+        },
+        request(fileBytes, streamingBody) {
+            let counted = 0;
+            let isStreaming = streamingBody;
+            let ended = false;
+            unstartedBytes = Math.max(0, unstartedBytes - fileBytes);
+            inFlight++;
+            refreshPhase();
+            const count = (bytes) => {
+                sentBytes += bytes - counted;
+                counted = bytes;
+            };
+            return {
+                streamed(streamedBytes, bodyBytes) {
+                    if (ended || !isStreaming)
+                        return;
+                    const done = streamedBytes >= bodyBytes;
+                    count(done ? fileBytes : Math.floor((fileBytes * streamedBytes) / bodyBytes));
+                    update();
+                    refreshPhase();
+                },
+                unstreamed() {
+                    if (ended)
+                        return;
+                    isStreaming = false;
+                    refreshPhase();
+                },
+                delivered() {
+                    if (ended || isStreaming)
+                        return;
+                    count(fileBytes);
+                    update();
+                    refreshPhase();
+                },
+                end() {
+                    if (ended)
+                        return;
+                    ended = true;
+                    inFlight--;
+                    unsentBytes += fileBytes - counted;
+                }
+            };
+        },
+        complete() {
+            dropUnsent();
+            if (pending)
+                emit();
+            phase = 'processing';
+            emit();
+            closed = true;
+        },
+        close() {
+            clearTrailing();
+            closed = true;
+        }
+    };
+}
+exports.createUploadProgressTracker = createUploadProgressTracker;
+//# sourceMappingURL=upload-progress.js.map

package/dist/client/utils/upload-progress.js.map

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

package/dist/contracts-snapshots/data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../src/contracts-snapshots/data.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;CAwIjB,CAAA"}
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../src/contracts-snapshots/data.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;CA8IjB,CAAA"}