@dcl/sdk-commands 7.30.2-39321726891.commit-9926e63 → 7.30.2-39796956377.commit-4223559

package/dist/commands/deploy/routes.js.map

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

package/dist/commands/deploy/state.d.ts

@@ -0,0 +1,60 @@
+export type DeploymentPhase = 'awaiting-signature' | 'undeploying' | 'uploading' | 'deployed' | 'failed' | 'cancelled';
+export type UploadStage = 'checking' | 'uploading' | 'processing';
+export type DeploymentUpload = {
+    stage: UploadStage;
+    sentBytes: number;
+    totalBytes: number;
+    completedBatches: number | null;
+    totalBatches: number | null;
+};
+export type DeploymentResult = {
+    entityId: string;
+    message?: string;
+};
+export type DeploymentError = {
+    code: string;
+    message: string;
+};
+export type DeploymentState = {
+    phase: DeploymentPhase;
+    upload: DeploymentUpload | null;
+    result: DeploymentResult | null;
+    error: DeploymentError | null;
+    cancelRequested: boolean;
+};
+export type UploadProgressUpdate = {
+    stage: UploadStage;
+    sentBytes: number;
+    totalBytes: number;
+};
+export type BatchProgressUpdate = {
+    completedBatches: number;
+    totalBatches: number;
+};
+export type DeploymentStateListener = (state: DeploymentState) => void;
+export interface IDeploymentStateComponent {
+    /** Returns a snapshot of the current state. */
+    get(): DeploymentState;
+    isFinal(): boolean;
+    /** Moves a deployment in progress to `undeploying` or `uploading`. Ignored once final. */
+    setPhase(phase: 'undeploying' | 'uploading'): void;
+    /** Records byte-level progress. Notifications are throttled unless the stage changes. */
+    reportUpload(progress: UploadProgressUpdate): void;
+    /** Records batch progress of a partial upload, or `null` when the upload uses a single request. */
+    reportBatches(progress: BatchProgressUpdate | null): void;
+    deployed(result: DeploymentResult): void;
+    failed(error: DeploymentError): void;
+    /** Records that a cancellation was accepted while the outcome is still pending. Ignored once final. */
+    requestCancel(): void;
+    /** Ends as `cancelled`; `error` carries a caveat about the outcome, e.g. the world was already undeployed. */
+    cancelled(error?: DeploymentError): void;
+    /** Calls `listener` on every change until the returned function is called. */
+    subscribe(listener: DeploymentStateListener): () => void;
+    subscriberCount(): number;
+}
+export declare const FINAL_PHASES: ReadonlySet<DeploymentPhase>;
+export declare const PROGRESS_NOTIFICATION_INTERVAL_MS = 250;
+export declare function createDeploymentState(options?: {
+    progressIntervalMs?: number;
+    now?: () => number;
+}): IDeploymentStateComponent;

package/dist/commands/deploy/state.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROGRESS_NOTIFICATION_INTERVAL_MS = exports.FINAL_PHASES = void 0;
+exports.createDeploymentState = createDeploymentState;
+exports.FINAL_PHASES = new Set(['deployed', 'failed', 'cancelled']);
+exports.PROGRESS_NOTIFICATION_INTERVAL_MS = 250;
+function createDeploymentState(options = {}) {
+    const progressIntervalMs = options.progressIntervalMs ?? exports.PROGRESS_NOTIFICATION_INTERVAL_MS;
+    const now = options.now ?? Date.now;
+    const listeners = new Set();
+    let state = {
+        phase: 'awaiting-signature',
+        upload: null,
+        result: null,
+        error: null,
+        cancelRequested: false
+    };
+    let batches = {
+        completedBatches: null,
+        totalBatches: null
+    };
+    // Keeps sentBytes monotonic when an upload restarts (a partial upload falling back to a single request).
+    let restartOffset = 0;
+    let lastSentBytes = 0;
+    let lastNotification = 0;
+    let pendingTimer;
+    function snapshot() {
+        return {
+            ...state,
+            upload: state.upload && { ...state.upload },
+            result: state.result && { ...state.result },
+            error: state.error && { ...state.error }
+        };
+    }
+    function notify() {
+        if (pendingTimer) {
+            clearTimeout(pendingTimer);
+            pendingTimer = undefined;
+        }
+        lastNotification = now();
+        const current = snapshot();
+        for (const listener of Array.from(listeners)) {
+            try {
+                listener(current);
+            }
+            catch {
+                listeners.delete(listener);
+            }
+        }
+    }
+    function notifyThrottled() {
+        const elapsed = now() - lastNotification;
+        if (elapsed >= progressIntervalMs) {
+            notify();
+        }
+        else if (!pendingTimer) {
+            pendingTimer = setTimeout(notify, progressIntervalMs - elapsed);
+            pendingTimer.unref?.();
+        }
+    }
+    function isFinal() {
+        return exports.FINAL_PHASES.has(state.phase);
+    }
+    function finish(next) {
+        if (isFinal())
+            return;
+        state = { ...state, ...next };
+        notify();
+        listeners.clear();
+    }
+    return {
+        get: snapshot,
+        isFinal,
+        setPhase(phase) {
+            if (isFinal() || state.phase === phase)
+                return;
+            state = { ...state, phase };
+            notify();
+        },
+        reportUpload({ stage, sentBytes, totalBytes }) {
+            if (isFinal())
+                return;
+            if (sentBytes < lastSentBytes) {
+                restartOffset = state.upload?.sentBytes ?? 0;
+            }
+            lastSentBytes = sentBytes;
+            const previousStage = state.upload?.stage;
+            state = {
+                ...state,
+                phase: 'uploading',
+                upload: {
+                    stage,
+                    sentBytes: restartOffset + sentBytes,
+                    totalBytes: restartOffset + totalBytes,
+                    ...batches
+                }
+            };
+            if (previousStage === stage) {
+                notifyThrottled();
+            }
+            else {
+                notify();
+            }
+        },
+        reportBatches(progress) {
+            if (isFinal())
+                return;
+            batches = progress
+                ? { completedBatches: progress.completedBatches, totalBatches: progress.totalBatches }
+                : { completedBatches: null, totalBatches: null };
+            if (!state.upload)
+                return;
+            state = { ...state, upload: { ...state.upload, ...batches } };
+            notifyThrottled();
+        },
+        deployed(result) {
+            finish({ phase: 'deployed', result: { ...result } });
+        },
+        failed(error) {
+            finish({ phase: 'failed', error: { ...error } });
+        },
+        requestCancel() {
+            if (isFinal() || state.cancelRequested)
+                return;
+            state = { ...state, cancelRequested: true };
+            notify();
+        },
+        cancelled(error) {
+            finish({ phase: 'cancelled', ...(error ? { error: { ...error } } : {}) });
+        },
+        subscribe(listener) {
+            if (isFinal())
+                return () => { };
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        subscriberCount() {
+            return listeners.size;
+        }
+    };
+}
+//# sourceMappingURL=state.js.map

package/dist/commands/deploy/state.js.map

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

package/dist/commands/deploy/upload.d.ts

@@ -0,0 +1,23 @@
+import { ContentClient } from 'dcl-catalyst-client';
+import { CliComponents } from '../../components';
+import { IDeploymentStateComponent } from './state';
+type DeploymentData = Parameters<ContentClient['deploy']>[0];
+export type UploadResult = {
+    message?: string;
+};
+export type UploadOptions = {
+    signal?: AbortSignal;
+    progress?: Pick<IDeploymentStateComponent, 'reportUpload' | 'reportBatches'>;
+};
+export declare const CONTENT_AVAILABILITY_TIMEOUT_MS = 30000;
+export declare const MAX_SINGLE_REQUEST_BYTES: number;
+export declare const MIN_PARTIAL_DEPLOYMENT_BYTES: number;
+export declare const PARTIAL_BATCH_BYTES: number;
+export declare const PARTIAL_BATCH_CONCURRENCY = 3;
+/**
+ * Uploads a deployment of at least {@link MIN_PARTIAL_DEPLOYMENT_BYTES} in size-bounded batches when the
+ * client supports partial deployments, falling back to a single request for servers that don't support them.
+ * Smaller deployments always use a single request.
+ */
+export declare function uploadDeployment(components: Pick<CliComponents, 'logger'>, client: ContentClient, deployData: DeploymentData, options?: UploadOptions): Promise<UploadResult>;
+export {};

package/dist/commands/deploy/upload.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PARTIAL_BATCH_CONCURRENCY = exports.PARTIAL_BATCH_BYTES = exports.MIN_PARTIAL_DEPLOYMENT_BYTES = exports.MAX_SINGLE_REQUEST_BYTES = exports.CONTENT_AVAILABILITY_TIMEOUT_MS = void 0;
+exports.uploadDeployment = uploadDeployment;
+const dcl_catalyst_client_1 = require("dcl-catalyst-client");
+const error_1 = require("../../logic/error");
+const beautiful_logs_1 = require("../../logic/beautiful-logs");
+const fetch_1 = require("../../logic/fetch");
+const REQUEST_TIMEOUT_MS = 600000;
+exports.CONTENT_AVAILABILITY_TIMEOUT_MS = 30000;
+// The infrastructure in front of the content servers times out requests larger than ~200MB.
+exports.MAX_SINGLE_REQUEST_BYTES = 200 * 1000 * 1000;
+// Smaller scenes upload faster in one request than in batches.
+exports.MIN_PARTIAL_DEPLOYMENT_BYTES = 50 * 1024 * 1024;
+// Batches small enough that the server stores one while the next is still uploading.
+exports.PARTIAL_BATCH_BYTES = 32 * 1024 * 1024;
+exports.PARTIAL_BATCH_CONCURRENCY = 3;
+function formatMegabytes(bytes) {
+    return `${(bytes / 1e6).toFixed(1)} MB`;
+}
+function batchSize(deployData) {
+    let largest = 0;
+    for (const file of deployData.files.values()) {
+        largest = Math.max(largest, file.byteLength);
+    }
+    return Math.max(exports.PARTIAL_BATCH_BYTES, largest);
+}
+function deploymentSize(deployData) {
+    let total = 0;
+    for (const file of deployData.files.values()) {
+        total += file.byteLength;
+    }
+    return total;
+}
+async function fetchAvailableContent(client, contentHashes, signal) {
+    try {
+        const availability = await (0, fetch_1.withDeadline)((deadline) => {
+            const init = { signal: deadline, rejectHttpErrors: true };
+            return client.isContentAvailable(contentHashes, init);
+        }, { timeoutMs: exports.CONTENT_AVAILABILITY_TIMEOUT_MS, signal });
+        if (!Array.isArray(availability))
+            throw new Error('unexpected response');
+        return new Set(availability.filter(({ available }) => available === true).map(({ cid }) => cid));
+    }
+    catch (error) {
+        if (signal?.aborted)
+            throw error;
+        const reason = error?.message ?? String(error);
+        throw new error_1.CliError('DEPLOY_CONTENT_CHECK_FAILED', `Couldn't check which content the server already has (${reason})`);
+    }
+}
+// A single request only uploads the files missing on the server, plus the entity file.
+async function missingBytes(client, deployData, signal) {
+    const contentHashes = Array.from(deployData.files.keys()).filter((hash) => hash !== deployData.entityId);
+    const available = contentHashes.length ? await fetchAvailableContent(client, contentHashes, signal) : new Set();
+    let total = 0;
+    for (const [hash, file] of deployData.files) {
+        if (!available.has(hash))
+            total += file.byteLength;
+    }
+    return total;
+}
+function uploadProgressReporter(progress) {
+    return (progress &&
+        (({ phase, sentBytes, totalBytes }) => progress.reportUpload({ stage: phase, sentBytes, totalBytes })));
+}
+async function uploadInSingleRequest(client, deployData, { signal, progress }) {
+    progress?.reportBatches(null);
+    const response = (await client.deploy(deployData, {
+        timeout: REQUEST_TIMEOUT_MS,
+        signal,
+        onUploadProgress: uploadProgressReporter(progress)
+    }));
+    if (response.status !== 200) {
+        throw new Error(await response.text());
+    }
+    return (await response.json());
+}
+/**
+ * Uploads a deployment of at least {@link MIN_PARTIAL_DEPLOYMENT_BYTES} in size-bounded batches when the
+ * client supports partial deployments, falling back to a single request for servers that don't support them.
+ * Smaller deployments always use a single request.
+ */
+async function uploadDeployment(components, client, deployData, options = {}) {
+    const { signal, progress } = options;
+    const size = deploymentSize(deployData);
+    if (size < exports.MIN_PARTIAL_DEPLOYMENT_BYTES) {
+        return uploadInSingleRequest(client, deployData, options);
+    }
+    try {
+        progress?.reportBatches({ completedBatches: 0, totalBatches: 1 });
+        const result = await client.deployPartial(deployData, {
+            timeout: REQUEST_TIMEOUT_MS,
+            signal,
+            maxBatchSizeBytes: batchSize(deployData),
+            concurrency: exports.PARTIAL_BATCH_CONCURRENCY,
+            onUploadProgress: uploadProgressReporter(progress),
+            onProgress: ({ uploadedBytes, totalBytes, completedBatches, totalBatches }) => {
+                progress?.reportBatches({ completedBatches, totalBatches });
+                (0, beautiful_logs_1.printProgressInfo)(components.logger, `Uploaded ${formatMegabytes(uploadedBytes)} of ${formatMegabytes(totalBytes)} ` +
+                    `(batch ${completedBatches}/${totalBatches})`);
+            }
+        });
+        return { message: result.message };
+    }
+    catch (error) {
+        if (!(error instanceof dcl_catalyst_client_1.PartialDeploymentNotSupportedError) || signal?.aborted) {
+            throw error;
+        }
+        const missing = size > exports.MAX_SINGLE_REQUEST_BYTES ? await missingBytes(client, deployData, signal) : size;
+        if (missing > exports.MAX_SINGLE_REQUEST_BYTES) {
+            throw new error_1.CliError('DEPLOY_PARTIAL_NOT_SUPPORTED', `The target server does not support batched uploads, and the content of this scene missing on it ` +
+                `(${formatMegabytes(missing)}) is too large to upload in a single request ` +
+                `(max ${formatMegabytes(exports.MAX_SINGLE_REQUEST_BYTES)}).`);
+        }
+        components.logger.warn('The target server does not support batched uploads, uploading in a single request.');
+        return uploadInSingleRequest(client, deployData, options);
+    }
+}
+//# sourceMappingURL=upload.js.map

package/dist/commands/deploy/upload.js.map

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

package/dist/commands/deploy/utils.d.ts

@@ -3,18 +3,47 @@ import { Lifecycle } from '@well-known-components/interfaces';
 import { ContentClient } from 'dcl-catalyst-client';
 import { CliComponents } from '../../components';
 import { IFile } from '../../logic/scene-validations';
-import { LinkerResponse } from '../../linker-dapp/routes';
 import { IFuture } from '../../logic/future';
 import { dAppOptions } from '../../run-dapp';
+import { IDeploymentComponent } from './deployment';
+/**
+ * Minimal undici-backed fetch component for the catalyst client. Replaces
+ * @well-known-components/fetch-component, which uses cross-fetch -> node-fetch v2
+ * and trips a gzip "Premature close" under keep-alive socket reuse on recent Node
+ * runtimes (nodejs/node#63989). Honors the `timeout`, `signal` and `abortController`
+ * options via an AbortController (until the headers arrive); `rejectHttpErrors` rejects
+ * non-2xx responses with an {@link HttpStatusError}. All other init fields (including
+ * `duplex` for streamed uploads) pass straight through to undici.fetch.
+ */
+export declare function createFetchComponent(): {
+    fetch(url: string, init?: CatalystFetchInit): Promise<Response>;
+};
+export type CatalystFetchInit = RequestInit & {
+    timeout?: number;
+    abortController?: AbortController;
+    rejectHttpErrors?: boolean;
+};
+export declare class HttpStatusError extends Error {
+    readonly status: number;
+    constructor(status: number);
+}
 export declare function getCatalyst(chainId?: ChainId, target?: string, targetContent?: string): Promise<{
     client: ContentClient;
     url: string;
 }>;
 export declare function buildDeleteScenesFromWorldPayload(worldName: string): string;
-export declare function deleteWorldScenes(components: Pick<CliComponents, 'logger'>, worldName: string, deleteSignature: string, targetContent?: string): Promise<Response>;
-export declare function getAddressAndSignature(components: CliComponents, awaitResponse: IFuture<void>, messageToSign: string, scene: Scene, files: IFile[], skipValidations: boolean, linkOptions: Omit<dAppOptions, 'uri'>, deployCallback: (response: LinkerResponse) => Promise<void>, deleteScenesFromWorldPayload?: string, targetContent?: string, multiScene?: boolean): Promise<{
+export declare function deleteWorldScenes(components: Pick<CliComponents, 'logger'>, worldName: string, deleteSignature: string, targetContent?: string, signal?: AbortSignal): Promise<Response>;
+export declare function getAddressAndSignature(components: CliComponents, awaitResponse: IFuture<void>, messageToSign: string, scene: Scene, files: IFile[], skipValidations: boolean, linkOptions: Omit<dAppOptions, 'uri'>, deployment: IDeploymentComponent, deployToken: string, deleteScenesFromWorldPayload?: string, targetContent?: string, multiScene?: boolean): Promise<{
     program?: Lifecycle.ComponentBasedProgram<unknown>;
 }>;
+export declare const MIN_DEPLOY_TOKEN_LENGTH = 16;
+/** The `--deploy-token` given to the CLI, or a random one for this run. */
+export declare function resolveDeployToken(deployTokenArg?: string): string;
+/**
+ * The linker dapp reads the token that authorizes cancelling the deployment from its URL fragment, which is
+ * never sent in HTTP requests.
+ */
+export declare function deployLinkerUri(deployToken: string): string;
 export declare function sceneHasWorldCfg(scene: Scene): boolean;
 export interface SceneInfo {
     baseParcel: string;
@@ -65,6 +94,17 @@ export declare function getScenesOnOtherParcels(existingScenes: WorldScene[], de
 export declare function fetchWorldScenes(logger: {
     info: (msg: string) => void;
 }, worldName: string, targetContent?: string): Promise<WorldScene[]>;
+/**
+ * Whether the entity is live on the content server. Worlds servers don't list entities by id, so a world
+ * is checked through its scenes.
+ */
+export declare function isEntityPublished(client: Pick<ContentClient, 'fetchEntitiesByIds'>, entityId: string, options: {
+    world?: {
+        name: string;
+        targetContent: string;
+    };
+    timeoutMs: number;
+}): Promise<boolean>;
 export declare function promptUser(question: string): Promise<boolean>;
 interface WorldPermissionsResponse {
     permissions: {
@@ -80,11 +120,11 @@ interface WorldPermissionsResponse {
         parcel_count: number;
     }[]>;
 }
-export declare function fetchWorldPermissions(worldName: string, targetContent: string): Promise<WorldPermissionsResponse>;
-export declare function fetchParcelPermissions(worldName: string, address: string, targetContent: string): Promise<string[]>;
+export declare function fetchWorldPermissions(worldName: string, targetContent: string, signal?: AbortSignal): Promise<WorldPermissionsResponse>;
+export declare function fetchParcelPermissions(worldName: string, address: string, targetContent: string, signal?: AbortSignal): Promise<string[]>;
 export declare function checkWorldDeploymentPermission(logger: {
     info: (msg: string) => void;
-}, worldName: string, address: string, targetContent: string, deployingParcels: string[]): Promise<{
+}, worldName: string, address: string, targetContent: string, deployingParcels: string[], signal?: AbortSignal): Promise<{
     allowed: boolean;
     deniedParcels?: string[];
 }>;