@sanity/cli 5.9.0-next.8 → 6.0.0-alpha.11

package/dist/actions/versions/findSanityModulesVersions.js

@@ -0,0 +1,47 @@
+import path from 'node:path';
+import { spinner } from '@sanity/cli-core/ux';
+import promiseProps from 'promise-props-recursive';
+import semver from 'semver';
+import semverCompare from 'semver-compare';
+import { getCliVersion } from '../../util/getCliVersion.js';
+import { readPackageJson } from '../../util/readPackageJson.js';
+import { buildPackageArray } from './buildPackageArray.js';
+import { filterSanityModules } from './filterSanityModules.js';
+import { versionsDebug } from './versionsDebug.js';
+/**
+ * Print the versions of the all sanity and `@sanity/*` packages.
+ *
+ * @internal
+ */ export async function findSanityModulesVersions(args) {
+    const { cwd } = args;
+    const cliVersion = await getCliVersion();
+    versionsDebug(`Sanity CLI version: ${cliVersion}`);
+    const packageJsonPath = path.join(cwd, 'package.json');
+    versionsDebug(`Reading package.json from ${packageJsonPath}`);
+    // Declared @sanity/* modules and their wanted versions in package.json
+    const packageJson = await readPackageJson(packageJsonPath);
+    versionsDebug('Resolved package.json:', packageJson);
+    const filteredSanityModules = filterSanityModules(packageJson);
+    versionsDebug('sanity modules:', filteredSanityModules);
+    const spin = spinner('Resolving latest versions').start();
+    try {
+        const versions = await promiseProps(buildPackageArray(filteredSanityModules, cwd, cliVersion));
+        const packages = Object.values(versions);
+        versionsDebug('packages:', packages);
+        return packages.map((mod)=>{
+            const current = mod.installed || semver.minVersion(mod.declared)?.toString() || '';
+            const needsUpdate = mod.latest ? semverCompare(current, mod.latest) === -1 : false;
+            return {
+                ...mod,
+                needsUpdate
+            };
+        });
+    } catch (error) {
+        versionsDebug('Error finding sanity modules versions:', error);
+        throw error;
+    } finally{
+        spin.stop();
+    }
+}
+
+//# sourceMappingURL=findSanityModulesVersions.js.map

package/dist/actions/versions/findSanityModulesVersions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/versions/findSanityModulesVersions.ts"],"sourcesContent":["import path from 'node:path'\n\nimport {spinner} from '@sanity/cli-core/ux'\nimport promiseProps from 'promise-props-recursive'\nimport semver from 'semver'\nimport semverCompare from 'semver-compare'\n\nimport {getCliVersion} from '../../util/getCliVersion.js'\nimport {readPackageJson} from '../../util/readPackageJson.js'\nimport {buildPackageArray} from './buildPackageArray.js'\nimport {filterSanityModules} from './filterSanityModules.js'\nimport {type ModuleVersionInfo, type ModuleVersionResult} from './types.js'\nimport {versionsDebug} from './versionsDebug.js'\n\n/**\n * @internal\n */\ninterface PrintVersionArgs {\n  cwd: string\n}\n\n/**\n * Print the versions of the all sanity and `@sanity/*` packages.\n *\n * @internal\n */\nexport async function findSanityModulesVersions(\n  args: PrintVersionArgs,\n): Promise<ModuleVersionResult[]> {\n  const {cwd} = args\n  const cliVersion = await getCliVersion()\n\n  versionsDebug(`Sanity CLI version: ${cliVersion}`)\n\n  const packageJsonPath = path.join(cwd, 'package.json')\n  versionsDebug(`Reading package.json from ${packageJsonPath}`)\n  // Declared @sanity/* modules and their wanted versions in package.json\n  const packageJson = await readPackageJson(packageJsonPath)\n  versionsDebug('Resolved package.json:', packageJson)\n\n  const filteredSanityModules = filterSanityModules(packageJson)\n  versionsDebug('sanity modules:', filteredSanityModules)\n\n  const spin = spinner('Resolving latest versions').start()\n\n  try {\n    const versions = await promiseProps<ModuleVersionInfo[]>(\n      buildPackageArray(filteredSanityModules, cwd, cliVersion),\n    )\n\n    const packages = Object.values(versions)\n    versionsDebug('packages:', packages)\n\n    return packages.map((mod) => {\n      const current = mod.installed || semver.minVersion(mod.declared)?.toString() || ''\n      const needsUpdate = mod.latest ? semverCompare(current, mod.latest) === -1 : false\n\n      return {...mod, needsUpdate}\n    })\n  } catch (error) {\n    versionsDebug('Error finding sanity modules versions:', error)\n    throw error\n  } finally {\n    spin.stop()\n  }\n}\n"],"names":["path","spinner","promiseProps","semver","semverCompare","getCliVersion","readPackageJson","buildPackageArray","filterSanityModules","versionsDebug","findSanityModulesVersions","args","cwd","cliVersion","packageJsonPath","join","packageJson","filteredSanityModules","spin","start","versions","packages","Object","values","map","mod","current","installed","minVersion","declared","toString","needsUpdate","latest","error","stop"],"mappings":"AAAA,OAAOA,UAAU,YAAW;AAE5B,SAAQC,OAAO,QAAO,sBAAqB;AAC3C,OAAOC,kBAAkB,0BAAyB;AAClD,OAAOC,YAAY,SAAQ;AAC3B,OAAOC,mBAAmB,iBAAgB;AAE1C,SAAQC,aAAa,QAAO,8BAA6B;AACzD,SAAQC,eAAe,QAAO,gCAA+B;AAC7D,SAAQC,iBAAiB,QAAO,yBAAwB;AACxD,SAAQC,mBAAmB,QAAO,2BAA0B;AAE5D,SAAQC,aAAa,QAAO,qBAAoB;AAShD;;;;CAIC,GACD,OAAO,eAAeC,0BACpBC,IAAsB;IAEtB,MAAM,EAACC,GAAG,EAAC,GAAGD;IACd,MAAME,aAAa,MAAMR;IAEzBI,cAAc,CAAC,oBAAoB,EAAEI,YAAY;IAEjD,MAAMC,kBAAkBd,KAAKe,IAAI,CAACH,KAAK;IACvCH,cAAc,CAAC,0BAA0B,EAAEK,iBAAiB;IAC5D,uEAAuE;IACvE,MAAME,cAAc,MAAMV,gBAAgBQ;IAC1CL,cAAc,0BAA0BO;IAExC,MAAMC,wBAAwBT,oBAAoBQ;IAClDP,cAAc,mBAAmBQ;IAEjC,MAAMC,OAAOjB,QAAQ,6BAA6BkB,KAAK;IAEvD,IAAI;QACF,MAAMC,WAAW,MAAMlB,aACrBK,kBAAkBU,uBAAuBL,KAAKC;QAGhD,MAAMQ,WAAWC,OAAOC,MAAM,CAACH;QAC/BX,cAAc,aAAaY;QAE3B,OAAOA,SAASG,GAAG,CAAC,CAACC;YACnB,MAAMC,UAAUD,IAAIE,SAAS,IAAIxB,OAAOyB,UAAU,CAACH,IAAII,QAAQ,GAAGC,cAAc;YAChF,MAAMC,cAAcN,IAAIO,MAAM,GAAG5B,cAAcsB,SAASD,IAAIO,MAAM,MAAM,CAAC,IAAI;YAE7E,OAAO;gBAAC,GAAGP,GAAG;gBAAEM;YAAW;QAC7B;IACF,EAAE,OAAOE,OAAO;QACdxB,cAAc,0CAA0CwB;QACxD,MAAMA;IACR,SAAU;QACRf,KAAKgB,IAAI;IACX;AACF"}

package/dist/actions/versions/getFormatters.js

@@ -0,0 +1,30 @@
+import { styleText } from 'node:util';
+import { padEnd } from 'lodash-es';
+/**
+ * Get the display name for a module.
+ *
+ * @internal
+ */ export function getDisplayName(mod) {
+    return mod.isGlobal ? `${mod.name} (global)` : mod.name;
+}
+/**
+ * Get formatters for the package versions.
+ *
+ * @internal
+ */ export function getFormatters(versions) {
+    let nameLength = 0;
+    let versionLength = 0;
+    for (const mod of versions){
+        const displayName = getDisplayName(mod);
+        nameLength = Math.max(nameLength, displayName.length);
+        versionLength = Math.max(versionLength, (mod.installed || '<missing>').length);
+    }
+    const formatName = (name)=>padEnd(name, nameLength + 1).replace(/^@sanity\/(.*?)(\s|$)/, `${styleText('yellow', '@sanity/')}${styleText('cyan', '$1')}$2`).replace(/^sanity(\s|$)/, `${styleText('yellow', 'sanity')}$1`);
+    return {
+        formatName,
+        nameLength,
+        versionLength
+    };
+}
+
+//# sourceMappingURL=getFormatters.js.map

package/dist/actions/versions/getFormatters.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/versions/getFormatters.ts"],"sourcesContent":["import {styleText} from 'node:util'\n\nimport {padEnd} from 'lodash-es'\n\nimport {type ModuleVersionResult} from './types.js'\n\n/**\n * Get the display name for a module.\n *\n * @internal\n */\nexport function getDisplayName(mod: ModuleVersionResult): string {\n  return mod.isGlobal ? `${mod.name} (global)` : mod.name\n}\n\n/**\n * Get formatters for the package versions.\n *\n * @internal\n */\nexport function getFormatters(versions: ModuleVersionResult[]): {\n  formatName: (name: string) => string\n  nameLength: number\n  versionLength: number\n} {\n  let nameLength = 0\n  let versionLength = 0\n\n  for (const mod of versions) {\n    const displayName = getDisplayName(mod)\n    nameLength = Math.max(nameLength, displayName.length)\n    versionLength = Math.max(versionLength, (mod.installed || '<missing>').length)\n  }\n\n  const formatName = (name: string): string =>\n    padEnd(name, nameLength + 1)\n      .replace(\n        /^@sanity\\/(.*?)(\\s|$)/,\n        `${styleText('yellow', '@sanity/')}${styleText('cyan', '$1')}$2`,\n      )\n      .replace(/^sanity(\\s|$)/, `${styleText('yellow', 'sanity')}$1`)\n\n  return {formatName, nameLength, versionLength}\n}\n"],"names":["styleText","padEnd","getDisplayName","mod","isGlobal","name","getFormatters","versions","nameLength","versionLength","displayName","Math","max","length","installed","formatName","replace"],"mappings":"AAAA,SAAQA,SAAS,QAAO,YAAW;AAEnC,SAAQC,MAAM,QAAO,YAAW;AAIhC;;;;CAIC,GACD,OAAO,SAASC,eAAeC,GAAwB;IACrD,OAAOA,IAAIC,QAAQ,GAAG,GAAGD,IAAIE,IAAI,CAAC,SAAS,CAAC,GAAGF,IAAIE,IAAI;AACzD;AAEA;;;;CAIC,GACD,OAAO,SAASC,cAAcC,QAA+B;IAK3D,IAAIC,aAAa;IACjB,IAAIC,gBAAgB;IAEpB,KAAK,MAAMN,OAAOI,SAAU;QAC1B,MAAMG,cAAcR,eAAeC;QACnCK,aAAaG,KAAKC,GAAG,CAACJ,YAAYE,YAAYG,MAAM;QACpDJ,gBAAgBE,KAAKC,GAAG,CAACH,eAAe,AAACN,CAAAA,IAAIW,SAAS,IAAI,WAAU,EAAGD,MAAM;IAC/E;IAEA,MAAME,aAAa,CAACV,OAClBJ,OAAOI,MAAMG,aAAa,GACvBQ,OAAO,CACN,yBACA,GAAGhB,UAAU,UAAU,cAAcA,UAAU,QAAQ,MAAM,EAAE,CAAC,EAEjEgB,OAAO,CAAC,iBAAiB,GAAGhB,UAAU,UAAU,UAAU,EAAE,CAAC;IAElE,OAAO;QAACe;QAAYP;QAAYC;IAAa;AAC/C"}

package/dist/actions/versions/tryFindLatestVersion.js

@@ -0,0 +1,21 @@
+import getLatestVersion from 'get-latest-version';
+import { versionsDebug } from './versionsDebug.js';
+/**
+ * Try to find the latest version of a package.
+ *
+ * @param pkgName - The name of the package to find the latest version of.
+ * @returns The latest version of the package.
+ * @internal
+ */ export async function tryFindLatestVersion(pkgName) {
+    try {
+        const latest = await getLatestVersion(pkgName);
+        return latest;
+    } catch (err) {
+        versionsDebug(`Cannot find version for ${pkgName}`, err);
+        throw new Error(`Cannot find version for ${pkgName}`, {
+            cause: err
+        });
+    }
+}
+
+//# sourceMappingURL=tryFindLatestVersion.js.map

package/dist/actions/versions/tryFindLatestVersion.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/versions/tryFindLatestVersion.ts"],"sourcesContent":["import getLatestVersion from 'get-latest-version'\n\nimport {versionsDebug} from './versionsDebug.js'\n\n/**\n * Try to find the latest version of a package.\n *\n * @param pkgName - The name of the package to find the latest version of.\n * @returns The latest version of the package.\n * @internal\n */\nexport async function tryFindLatestVersion(pkgName: string): Promise<string | undefined> {\n  try {\n    const latest = await getLatestVersion(pkgName)\n    return latest\n  } catch (err) {\n    versionsDebug(`Cannot find version for ${pkgName}`, err)\n    throw new Error(`Cannot find version for ${pkgName}`, {cause: err})\n  }\n}\n"],"names":["getLatestVersion","versionsDebug","tryFindLatestVersion","pkgName","latest","err","Error","cause"],"mappings":"AAAA,OAAOA,sBAAsB,qBAAoB;AAEjD,SAAQC,aAAa,QAAO,qBAAoB;AAEhD;;;;;;CAMC,GACD,OAAO,eAAeC,qBAAqBC,OAAe;IACxD,IAAI;QACF,MAAMC,SAAS,MAAMJ,iBAAiBG;QACtC,OAAOC;IACT,EAAE,OAAOC,KAAK;QACZJ,cAAc,CAAC,wBAAwB,EAAEE,SAAS,EAAEE;QACpD,MAAM,IAAIC,MAAM,CAAC,wBAAwB,EAAEH,SAAS,EAAE;YAACI,OAAOF;QAAG;IACnE;AACF"}

package/dist/actions/versions/types.js

@@ -0,0 +1,5 @@
+/**
+ * @internal
+ */ export { };
+
+//# sourceMappingURL=types.js.map

package/dist/actions/versions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/versions/types.ts"],"sourcesContent":["/**\n * @internal\n */\nexport interface ModuleVersionInfo {\n  declared: string\n  installed: string | undefined\n  isGlobal: boolean\n  isPinned: boolean\n  latest: string\n  name: string\n}\n\nexport interface ModuleVersionResult extends ModuleVersionInfo {\n  needsUpdate: boolean\n}\n"],"names":[],"mappings":"AAAA;;CAEC,GAUD,WAEC"}

package/dist/actions/versions/versionsDebug.js

@@ -0,0 +1,4 @@
+import { subdebug } from '@sanity/cli-core';
+export const versionsDebug = subdebug('versions');
+
+//# sourceMappingURL=versionsDebug.js.map

package/dist/actions/versions/versionsDebug.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/versions/versionsDebug.ts"],"sourcesContent":["import {subdebug} from '@sanity/cli-core'\n\nexport const versionsDebug = subdebug('versions')\n"],"names":["subdebug","versionsDebug"],"mappings":"AAAA,SAAQA,QAAQ,QAAO,mBAAkB;AAEzC,OAAO,MAAMC,gBAAgBD,SAAS,YAAW"}

package/dist/commands/backup/disable.js

@@ -0,0 +1,94 @@
+import { styleText } from 'node:util';
+import { Args } from '@oclif/core';
+import { SanityCommand, subdebug } from '@sanity/cli-core';
+import { select } from '@sanity/cli-core/ux';
+import { assertDatasetExists } from '../../actions/backup/assertDatasetExist.js';
+import { setBackup } from '../../services/backup.js';
+import { listDatasets } from '../../services/datasets.js';
+import { NO_PROJECT_ID } from '../../util/errorMessages.js';
+const disableBackupDebug = subdebug('backup:disable');
+export class DisableBackupCommand extends SanityCommand {
+    static args = {
+        dataset: Args.string({
+            description: 'Dataset name to disable backup for',
+            required: false
+        })
+    };
+    static description = 'Disable backup for a dataset.';
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %>',
+            description: 'Interactively disable backup for a dataset'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> production',
+            description: 'Disable backup for the production dataset'
+        }
+    ];
+    async run() {
+        const { args } = await this.parse(DisableBackupCommand);
+        let { dataset } = args;
+        const projectId = await this.getProjectId();
+        if (!projectId) {
+            this.error(NO_PROJECT_ID, {
+                exit: 1
+            });
+        }
+        let datasets;
+        try {
+            datasets = await listDatasets(projectId);
+        } catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            disableBackupDebug(`Failed to list datasets: ${message}`, error);
+            this.error(`Failed to list datasets: ${message}`, {
+                exit: 1
+            });
+        }
+        if (datasets.length === 0) {
+            this.error('No datasets found in this project.', {
+                exit: 1
+            });
+        }
+        if (dataset) {
+            assertDatasetExists(datasets, dataset);
+        } else {
+            dataset = await this.promptForDataset(datasets);
+        }
+        try {
+            await setBackup({
+                dataset,
+                projectId,
+                status: false
+            });
+            this.log(`${styleText('green', `Disabled daily backups for dataset ${dataset}.\n`)}`);
+            this.log(`${styleText('yellow', 'Note: Existing backups will be retained according to your retention policy.\n')}`);
+            disableBackupDebug(`Successfully disabled backup for dataset ${dataset}`);
+        } catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            disableBackupDebug(`Failed to disable backup for dataset`, error);
+            this.error(`Disabling dataset backup failed: ${message}`, {
+                exit: 1
+            });
+        }
+    }
+    async promptForDataset(datasets) {
+        try {
+            const choices = datasets.map((dataset)=>({
+                    name: dataset.name,
+                    value: dataset.name
+                }));
+            return select({
+                choices,
+                message: 'Select the dataset name:'
+            });
+        } catch (error) {
+            const err = error;
+            disableBackupDebug(`Error fetching datasets`, err);
+            this.error(`Failed to fetch datasets:\n${err.message}`, {
+                exit: 1
+            });
+        }
+    }
+}
+
+//# sourceMappingURL=disable.js.map

package/dist/commands/backup/disable.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/commands/backup/disable.ts"],"sourcesContent":["import {styleText} from 'node:util'\n\nimport {Args} from '@oclif/core'\nimport {SanityCommand, subdebug} from '@sanity/cli-core'\nimport {select} from '@sanity/cli-core/ux'\nimport {type DatasetsResponse} from '@sanity/client'\n\nimport {assertDatasetExists} from '../../actions/backup/assertDatasetExist.js'\nimport {setBackup} from '../../services/backup.js'\nimport {listDatasets} from '../../services/datasets.js'\nimport {NO_PROJECT_ID} from '../../util/errorMessages.js'\n\nconst disableBackupDebug = subdebug('backup:disable')\n\nexport class DisableBackupCommand extends SanityCommand<typeof DisableBackupCommand> {\n  static override args = {\n    dataset: Args.string({\n      description: 'Dataset name to disable backup for',\n      required: false,\n    }),\n  }\n\n  static override description = 'Disable backup for a dataset.'\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %>',\n      description: 'Interactively disable backup for a dataset',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> production',\n      description: 'Disable backup for the production dataset',\n    },\n  ]\n\n  public async run(): Promise<void> {\n    const {args} = await this.parse(DisableBackupCommand)\n    let {dataset} = args\n\n    const projectId = await this.getProjectId()\n    if (!projectId) {\n      this.error(NO_PROJECT_ID, {exit: 1})\n    }\n\n    let datasets: DatasetsResponse\n\n    try {\n      datasets = await listDatasets(projectId)\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error)\n      disableBackupDebug(`Failed to list datasets: ${message}`, error)\n      this.error(`Failed to list datasets: ${message}`, {exit: 1})\n    }\n\n    if (datasets.length === 0) {\n      this.error('No datasets found in this project.', {exit: 1})\n    }\n\n    if (dataset) {\n      assertDatasetExists(datasets, dataset)\n    } else {\n      dataset = await this.promptForDataset(datasets)\n    }\n\n    try {\n      await setBackup({dataset, projectId, status: false})\n\n      this.log(`${styleText('green', `Disabled daily backups for dataset ${dataset}.\\n`)}`)\n      this.log(\n        `${styleText('yellow', 'Note: Existing backups will be retained according to your retention policy.\\n')}`,\n      )\n\n      disableBackupDebug(`Successfully disabled backup for dataset ${dataset}`)\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error)\n      disableBackupDebug(`Failed to disable backup for dataset`, error)\n      this.error(`Disabling dataset backup failed: ${message}`, {exit: 1})\n    }\n  }\n\n  private async promptForDataset(datasets: DatasetsResponse): Promise<string> {\n    try {\n      const choices = datasets.map((dataset) => ({\n        name: dataset.name,\n        value: dataset.name,\n      }))\n\n      return select({\n        choices,\n        message: 'Select the dataset name:',\n      })\n    } catch (error) {\n      const err = error as Error\n      disableBackupDebug(`Error fetching datasets`, err)\n      this.error(`Failed to fetch datasets:\\n${err.message}`, {exit: 1})\n    }\n  }\n}\n"],"names":["styleText","Args","SanityCommand","subdebug","select","assertDatasetExists","setBackup","listDatasets","NO_PROJECT_ID","disableBackupDebug","DisableBackupCommand","args","dataset","string","description","required","examples","command","run","parse","projectId","getProjectId","error","exit","datasets","message","Error","String","length","promptForDataset","status","log","choices","map","name","value","err"],"mappings":"AAAA,SAAQA,SAAS,QAAO,YAAW;AAEnC,SAAQC,IAAI,QAAO,cAAa;AAChC,SAAQC,aAAa,EAAEC,QAAQ,QAAO,mBAAkB;AACxD,SAAQC,MAAM,QAAO,sBAAqB;AAG1C,SAAQC,mBAAmB,QAAO,6CAA4C;AAC9E,SAAQC,SAAS,QAAO,2BAA0B;AAClD,SAAQC,YAAY,QAAO,6BAA4B;AACvD,SAAQC,aAAa,QAAO,8BAA6B;AAEzD,MAAMC,qBAAqBN,SAAS;AAEpC,OAAO,MAAMO,6BAA6BR;IACxC,OAAgBS,OAAO;QACrBC,SAASX,KAAKY,MAAM,CAAC;YACnBC,aAAa;YACbC,UAAU;QACZ;IACF,EAAC;IAED,OAAgBD,cAAc,gCAA+B;IAE7D,OAAgBE,WAAW;QACzB;YACEC,SAAS;YACTH,aAAa;QACf;QACA;YACEG,SAAS;YACTH,aAAa;QACf;KACD,CAAA;IAED,MAAaI,MAAqB;QAChC,MAAM,EAACP,IAAI,EAAC,GAAG,MAAM,IAAI,CAACQ,KAAK,CAACT;QAChC,IAAI,EAACE,OAAO,EAAC,GAAGD;QAEhB,MAAMS,YAAY,MAAM,IAAI,CAACC,YAAY;QACzC,IAAI,CAACD,WAAW;YACd,IAAI,CAACE,KAAK,CAACd,eAAe;gBAACe,MAAM;YAAC;QACpC;QAEA,IAAIC;QAEJ,IAAI;YACFA,WAAW,MAAMjB,aAAaa;QAChC,EAAE,OAAOE,OAAO;YACd,MAAMG,UAAUH,iBAAiBI,QAAQJ,MAAMG,OAAO,GAAGE,OAAOL;YAChEb,mBAAmB,CAAC,yBAAyB,EAAEgB,SAAS,EAAEH;YAC1D,IAAI,CAACA,KAAK,CAAC,CAAC,yBAAyB,EAAEG,SAAS,EAAE;gBAACF,MAAM;YAAC;QAC5D;QAEA,IAAIC,SAASI,MAAM,KAAK,GAAG;YACzB,IAAI,CAACN,KAAK,CAAC,sCAAsC;gBAACC,MAAM;YAAC;QAC3D;QAEA,IAAIX,SAAS;YACXP,oBAAoBmB,UAAUZ;QAChC,OAAO;YACLA,UAAU,MAAM,IAAI,CAACiB,gBAAgB,CAACL;QACxC;QAEA,IAAI;YACF,MAAMlB,UAAU;gBAACM;gBAASQ;gBAAWU,QAAQ;YAAK;YAElD,IAAI,CAACC,GAAG,CAAC,GAAG/B,UAAU,SAAS,CAAC,mCAAmC,EAAEY,QAAQ,GAAG,CAAC,GAAG;YACpF,IAAI,CAACmB,GAAG,CACN,GAAG/B,UAAU,UAAU,kFAAkF;YAG3GS,mBAAmB,CAAC,yCAAyC,EAAEG,SAAS;QAC1E,EAAE,OAAOU,OAAO;YACd,MAAMG,UAAUH,iBAAiBI,QAAQJ,MAAMG,OAAO,GAAGE,OAAOL;YAChEb,mBAAmB,CAAC,oCAAoC,CAAC,EAAEa;YAC3D,IAAI,CAACA,KAAK,CAAC,CAAC,iCAAiC,EAAEG,SAAS,EAAE;gBAACF,MAAM;YAAC;QACpE;IACF;IAEA,MAAcM,iBAAiBL,QAA0B,EAAmB;QAC1E,IAAI;YACF,MAAMQ,UAAUR,SAASS,GAAG,CAAC,CAACrB,UAAa,CAAA;oBACzCsB,MAAMtB,QAAQsB,IAAI;oBAClBC,OAAOvB,QAAQsB,IAAI;gBACrB,CAAA;YAEA,OAAO9B,OAAO;gBACZ4B;gBACAP,SAAS;YACX;QACF,EAAE,OAAOH,OAAO;YACd,MAAMc,MAAMd;YACZb,mBAAmB,CAAC,uBAAuB,CAAC,EAAE2B;YAC9C,IAAI,CAACd,KAAK,CAAC,CAAC,2BAA2B,EAAEc,IAAIX,OAAO,EAAE,EAAE;gBAACF,MAAM;YAAC;QAClE;IACF;AACF"}

package/dist/commands/backup/download.js

@@ -0,0 +1,291 @@
+import { createWriteStream } from 'node:fs';
+import { mkdir, mkdtemp } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { finished } from 'node:stream/promises';
+import { styleText } from 'node:util';
+import { Args, Flags } from '@oclif/core';
+import { fileExists, SanityCommand } from '@sanity/cli-core';
+import { boxen, confirm, input, select } from '@sanity/cli-core/ux';
+import pMap from 'p-map';
+import prettyMs from 'pretty-ms';
+import { archiveDir } from '../../actions/backup/archiveDir.js';
+import { assertDatasetExists } from '../../actions/backup/assertDatasetExist.js';
+import { backupDownloadDebug } from '../../actions/backup/backupDownloadDebug.js';
+import { cleanupTmpDir } from '../../actions/backup/cleanupTmpDir.js';
+import { downloadAsset } from '../../actions/backup/downloadAsset.js';
+import { downloadDocument } from '../../actions/backup/downloadDocument.js';
+import { PaginatedGetBackupStream } from '../../actions/backup/fetchNextBackupPage.js';
+import { newProgress } from '../../actions/backup/progressSpinner.js';
+import { validateDatasetName } from '../../actions/dataset/validateDatasetName.js';
+import { promptForDataset } from '../../prompts/promptForDataset.js';
+import { listBackups } from '../../services/backup.js';
+import { listDatasets } from '../../services/datasets.js';
+import { NO_PROJECT_ID } from '../../util/errorMessages.js';
+import { humanFileSize } from '../../util/humanFileSize.js';
+import { isPathDirName } from '../../util/isPathDirName.js';
+const DEFAULT_DOWNLOAD_CONCURRENCY = 10;
+const MAX_DOWNLOAD_CONCURRENCY = 24;
+export class DownloadBackupCommand extends SanityCommand {
+    static args = {
+        dataset: Args.string({
+            description: 'Dataset name to download backup from',
+            required: false
+        })
+    };
+    static description = 'Download a dataset backup to a local file.';
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %>',
+            description: 'Interactively download a backup'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> production --backup-id 2024-01-01-backup-1',
+            description: 'Download a specific backup for the production dataset'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> production --backup-id 2024-01-01-backup-2 --out /path/to/file',
+            description: 'Download backup to a specific file'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> production --backup-id 2024-01-01-backup-3 --out /path/to/file --overwrite',
+            description: 'Download backup and overwrite existing file'
+        }
+    ];
+    static flags = {
+        'backup-id': Flags.string({
+            description: 'The backup ID to download'
+        }),
+        concurrency: Flags.integer({
+            default: DEFAULT_DOWNLOAD_CONCURRENCY,
+            description: `Concurrent number of backup item downloads (max: ${MAX_DOWNLOAD_CONCURRENCY})`
+        }),
+        out: Flags.string({
+            description: 'The file or directory path the backup should download to'
+        }),
+        overwrite: Flags.boolean({
+            default: false,
+            description: 'Allows overwriting of existing backup file'
+        })
+    };
+    async run() {
+        const { args } = await this.parse(DownloadBackupCommand);
+        let { dataset } = args;
+        const projectId = await this.getProjectId();
+        if (!projectId) {
+            this.error(NO_PROJECT_ID, {
+                exit: 1
+            });
+        }
+        let datasets;
+        try {
+            datasets = await listDatasets(projectId);
+        } catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            backupDownloadDebug(`Failed to list datasets: ${message}`, error);
+            this.error(`Failed to list datasets: ${message}`, {
+                exit: 1
+            });
+        }
+        if (datasets.length === 0) {
+            this.error('No datasets found in this project.', {
+                exit: 1
+            });
+        }
+        if (dataset) {
+            assertDatasetExists(datasets, dataset);
+        } else {
+            dataset = await promptForDataset({
+                allowCreation: false,
+                datasets
+            });
+        }
+        const opts = await this.prepareBackupOptions(projectId, dataset);
+        const outFilePath = path.join(opts.outDir, opts.outFileName);
+        this.log(boxen(`Downloading backup for:
+
+${styleText('bold', 'projectId')}: ${styleText('cyan', opts.projectId)}
+${styleText('bold', 'dataset')}: ${styleText('cyan', opts.datasetName)}
+${styleText('bold', 'backupId')}: ${styleText('cyan', opts.backupId)}`, {
+            borderColor: 'cyan',
+            borderStyle: 'round',
+            padding: 1
+        }));
+        this.log('');
+        this.log(`Downloading backup to "${styleText('cyan', outFilePath)}"`);
+        const start = Date.now();
+        const progressSpinner = newProgress('Setting up backup environment...');
+        // Create a unique temporary directory to store files before bundling them into the archive at outputPath.
+        // Temporary directories are normally deleted at the end of backup process, any unexpected exit may leave them
+        // behind, hence it is important to create a unique directory for each attempt.
+        const tmpOutDir = await mkdtemp(path.join(tmpdir(), `sanity-backup-`));
+        // Create required directories if they don't exist.
+        for (const dir of [
+            opts.outDir,
+            path.join(tmpOutDir, 'images'),
+            path.join(tmpOutDir, 'files')
+        ]){
+            await mkdir(dir, {
+                recursive: true
+            });
+        }
+        backupDownloadDebug('Writing to temporary directory %s', tmpOutDir);
+        const tmpOutDocumentsFile = path.join(tmpOutDir, 'data.ndjson');
+        const docOutStream = createWriteStream(tmpOutDocumentsFile);
+        try {
+            const backupFileStream = new PaginatedGetBackupStream(opts.projectId, opts.datasetName, opts.backupId);
+            const files = [];
+            let i = 0;
+            for await (const file of backupFileStream){
+                files.push(file);
+                i++;
+                progressSpinner.set({
+                    current: i,
+                    step: `Reading backup files...`,
+                    total: backupFileStream.totalFiles,
+                    update: true
+                });
+            }
+            let totalItemsDownloaded = 0;
+            await pMap(files, async (file)=>{
+                if (file.type === 'file' || file.type === 'image') {
+                    await downloadAsset(file.url, file.name, file.type, tmpOutDir);
+                } else {
+                    const doc = await downloadDocument(file.url);
+                    docOutStream.write(`${doc}\n`);
+                }
+                totalItemsDownloaded += 1;
+                progressSpinner.set({
+                    current: totalItemsDownloaded,
+                    step: `Downloading documents and assets...`,
+                    total: backupFileStream.totalFiles,
+                    update: true
+                });
+            }, {
+                concurrency: opts.concurrency
+            });
+        } catch (error) {
+            progressSpinner.fail();
+            const message = error instanceof Error ? error.message : String(error);
+            backupDownloadDebug(`Downloading dataset backup failed: ${message}`, error);
+            this.error(`Downloading dataset backup failed: ${message}`, {
+                exit: 1
+            });
+        }
+        docOutStream.end();
+        await finished(docOutStream);
+        progressSpinner.set({
+            step: `Archiving files into a tarball...`,
+            update: true
+        });
+        try {
+            await archiveDir(tmpOutDir, outFilePath, (processedBytes)=>{
+                progressSpinner.update({
+                    step: `Archiving files into a tarball, ${humanFileSize(processedBytes)} bytes written...`
+                });
+            });
+        } catch (err) {
+            progressSpinner.fail();
+            const message = err instanceof Error ? err.message : String(err);
+            backupDownloadDebug(`Archiving backup failed: ${message}`, err);
+            this.error(`Archiving backup failed: ${message}`, {
+                exit: 1
+            });
+        }
+        progressSpinner.set({
+            step: `Cleaning up temporary files at ${styleText('cyan', `${tmpOutDir}`)}`
+        });
+        await cleanupTmpDir(tmpOutDir);
+        progressSpinner.set({
+            step: `Backup download complete [${prettyMs(Date.now() - start)}]`
+        });
+        progressSpinner.succeed();
+    }
+    async getOutputPath(defaultOutFileName) {
+        if (this.flags.out !== undefined) {
+            // Rewrite the output path to an absolute path, if it is not already.
+            return path.resolve(this.flags.out);
+        }
+        const workDir = process.cwd();
+        const inputResult = await input({
+            default: path.join(workDir, defaultOutFileName),
+            message: 'Output path:'
+        });
+        return path.resolve(inputResult);
+    }
+    async prepareBackupOptions(projectId, datasetName) {
+        const err = validateDatasetName(datasetName);
+        if (err) {
+            this.error(err, {
+                exit: 1
+            });
+        }
+        const backupId = String(this.flags['backup-id'] || await this.promptForBackupId(projectId, datasetName));
+        if ('concurrency' in this.flags && (this.flags.concurrency < 1 || this.flags.concurrency > MAX_DOWNLOAD_CONCURRENCY)) {
+            this.error(`concurrency should be in 1 to ${MAX_DOWNLOAD_CONCURRENCY} range`, {
+                exit: 1
+            });
+        }
+        const defaultOutFileName = `${datasetName}-backup-${backupId}.tar.gz`;
+        let out = await this.getOutputPath(defaultOutFileName);
+        // If path is a directory name, then add a default file name to the path.
+        if (isPathDirName(out)) {
+            out = path.join(out, defaultOutFileName);
+        }
+        const exists = await fileExists(out);
+        // If the file already exists, ask for confirmation if it should be overwritten.
+        if (!this.flags.overwrite && exists) {
+            const shouldOverwrite = await confirm({
+                default: false,
+                message: `File "${out}" already exists, would you like to overwrite it?`
+            });
+            // If the user does not want to overwrite the file, cancel the operation.
+            if (!shouldOverwrite) {
+                this.error('Operation cancelled.', {
+                    exit: 1
+                });
+            }
+        }
+        return {
+            backupId,
+            concurrency: this.flags.concurrency || DEFAULT_DOWNLOAD_CONCURRENCY,
+            datasetName,
+            outDir: path.dirname(out),
+            outFileName: path.basename(out),
+            overwrite: this.flags.overwrite,
+            projectId
+        };
+    }
+    async promptForBackupId(projectId, datasetName) {
+        const maxBackupIdsShown = 100;
+        try {
+            const response = await listBackups({
+                datasetName,
+                limit: maxBackupIdsShown,
+                projectId
+            });
+            if (!response?.backups?.length) {
+                this.error('No backups found', {
+                    exit: 1
+                });
+            }
+            const backupIdChoices = response.backups.map((backup)=>({
+                    name: backup.id,
+                    value: backup.id
+                }));
+            const hint = backupIdChoices.length === maxBackupIdsShown ? ` (only last ${maxBackupIdsShown} shown)` : '';
+            return select({
+                choices: backupIdChoices,
+                message: `Select backup ID to use${hint}`
+            });
+        } catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            backupDownloadDebug(`Failed to fetch backups for dataset ${datasetName}: ${message}`, err);
+            this.error(`Failed to fetch backups for dataset ${datasetName}: ${message}`, {
+                exit: 1
+            });
+        }
+    }
+}
+
+//# sourceMappingURL=download.js.map

package/dist/commands/backup/download.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/commands/backup/download.ts"],"sourcesContent":["import {createWriteStream} from 'node:fs'\nimport {mkdir, mkdtemp} from 'node:fs/promises'\nimport {tmpdir} from 'node:os'\nimport path from 'node:path'\nimport {finished} from 'node:stream/promises'\nimport {styleText} from 'node:util'\n\nimport {Args, Flags} from '@oclif/core'\nimport {fileExists, SanityCommand} from '@sanity/cli-core'\nimport {boxen, confirm, input, select} from '@sanity/cli-core/ux'\nimport {type DatasetsResponse} from '@sanity/client'\nimport pMap from 'p-map'\nimport prettyMs from 'pretty-ms'\n\nimport {archiveDir} from '../../actions/backup/archiveDir.js'\nimport {assertDatasetExists} from '../../actions/backup/assertDatasetExist.js'\nimport {backupDownloadDebug} from '../../actions/backup/backupDownloadDebug.js'\nimport {cleanupTmpDir} from '../../actions/backup/cleanupTmpDir.js'\nimport {downloadAsset} from '../../actions/backup/downloadAsset.js'\nimport {downloadDocument} from '../../actions/backup/downloadDocument.js'\nimport {type File, PaginatedGetBackupStream} from '../../actions/backup/fetchNextBackupPage.js'\nimport {newProgress} from '../../actions/backup/progressSpinner.js'\nimport {validateDatasetName} from '../../actions/dataset/validateDatasetName.js'\nimport {promptForDataset} from '../../prompts/promptForDataset.js'\nimport {type BackupItem, listBackups} from '../../services/backup.js'\nimport {listDatasets} from '../../services/datasets.js'\nimport {NO_PROJECT_ID} from '../../util/errorMessages.js'\nimport {humanFileSize} from '../../util/humanFileSize.js'\nimport {isPathDirName} from '../../util/isPathDirName.js'\n\nconst DEFAULT_DOWNLOAD_CONCURRENCY = 10\nconst MAX_DOWNLOAD_CONCURRENCY = 24\n\ninterface DownloadBackupOptions {\n  backupId: string\n  concurrency: number\n  datasetName: string\n  outDir: string\n  outFileName: string\n  overwrite: boolean\n  projectId: string\n}\n\nexport class DownloadBackupCommand extends SanityCommand<typeof DownloadBackupCommand> {\n  static override args = {\n    dataset: Args.string({\n      description: 'Dataset name to download backup from',\n      required: false,\n    }),\n  }\n\n  static override description = 'Download a dataset backup to a local file.'\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %>',\n      description: 'Interactively download a backup',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> production --backup-id 2024-01-01-backup-1',\n      description: 'Download a specific backup for the production dataset',\n    },\n    {\n      command:\n        '<%= config.bin %> <%= command.id %> production --backup-id 2024-01-01-backup-2 --out /path/to/file',\n      description: 'Download backup to a specific file',\n    },\n    {\n      command:\n        '<%= config.bin %> <%= command.id %> production --backup-id 2024-01-01-backup-3 --out /path/to/file --overwrite',\n      description: 'Download backup and overwrite existing file',\n    },\n  ]\n\n  static override flags = {\n    'backup-id': Flags.string({\n      description: 'The backup ID to download',\n    }),\n    concurrency: Flags.integer({\n      default: DEFAULT_DOWNLOAD_CONCURRENCY,\n      description: `Concurrent number of backup item downloads (max: ${MAX_DOWNLOAD_CONCURRENCY})`,\n    }),\n    out: Flags.string({\n      description: 'The file or directory path the backup should download to',\n    }),\n    overwrite: Flags.boolean({\n      default: false,\n      description: 'Allows overwriting of existing backup file',\n    }),\n  }\n\n  public async run(): Promise<void> {\n    const {args} = await this.parse(DownloadBackupCommand)\n    let {dataset} = args\n\n    const projectId = await this.getProjectId()\n    if (!projectId) {\n      this.error(NO_PROJECT_ID, {exit: 1})\n    }\n\n    let datasets: DatasetsResponse\n\n    try {\n      datasets = await listDatasets(projectId)\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error)\n      backupDownloadDebug(`Failed to list datasets: ${message}`, error)\n      this.error(`Failed to list datasets: ${message}`, {exit: 1})\n    }\n\n    if (datasets.length === 0) {\n      this.error('No datasets found in this project.', {exit: 1})\n    }\n\n    if (dataset) {\n      assertDatasetExists(datasets, dataset)\n    } else {\n      dataset = await promptForDataset({allowCreation: false, datasets})\n    }\n\n    const opts = await this.prepareBackupOptions(projectId, dataset)\n    const outFilePath = path.join(opts.outDir, opts.outFileName)\n\n    this.log(\n      boxen(\n        `Downloading backup for:\n\n${styleText('bold', 'projectId')}: ${styleText('cyan', opts.projectId)}\n${styleText('bold', 'dataset')}: ${styleText('cyan', opts.datasetName)}\n${styleText('bold', 'backupId')}: ${styleText('cyan', opts.backupId)}`,\n        {\n          borderColor: 'cyan',\n          borderStyle: 'round',\n          padding: 1,\n        },\n      ),\n    )\n    this.log('')\n    this.log(`Downloading backup to \"${styleText('cyan', outFilePath)}\"`)\n\n    const start = Date.now()\n    const progressSpinner = newProgress('Setting up backup environment...')\n\n    // Create a unique temporary directory to store files before bundling them into the archive at outputPath.\n    // Temporary directories are normally deleted at the end of backup process, any unexpected exit may leave them\n    // behind, hence it is important to create a unique directory for each attempt.\n    const tmpOutDir = await mkdtemp(path.join(tmpdir(), `sanity-backup-`))\n\n    // Create required directories if they don't exist.\n    for (const dir of [\n      opts.outDir,\n      path.join(tmpOutDir, 'images'),\n      path.join(tmpOutDir, 'files'),\n    ]) {\n      await mkdir(dir, {recursive: true})\n    }\n\n    backupDownloadDebug('Writing to temporary directory %s', tmpOutDir)\n    const tmpOutDocumentsFile = path.join(tmpOutDir, 'data.ndjson')\n\n    const docOutStream = createWriteStream(tmpOutDocumentsFile)\n\n    try {\n      const backupFileStream = new PaginatedGetBackupStream(\n        opts.projectId,\n        opts.datasetName,\n        opts.backupId,\n      )\n\n      const files: File[] = []\n      let i = 0\n      for await (const file of backupFileStream) {\n        files.push(file)\n        i++\n        progressSpinner.set({\n          current: i,\n          step: `Reading backup files...`,\n          total: backupFileStream.totalFiles,\n          update: true,\n        })\n      }\n\n      let totalItemsDownloaded = 0\n      await pMap(\n        files,\n        async (file: File) => {\n          if (file.type === 'file' || file.type === 'image') {\n            await downloadAsset(file.url, file.name, file.type, tmpOutDir)\n          } else {\n            const doc = await downloadDocument(file.url)\n            docOutStream.write(`${doc}\\n`)\n          }\n\n          totalItemsDownloaded += 1\n          progressSpinner.set({\n            current: totalItemsDownloaded,\n            step: `Downloading documents and assets...`,\n            total: backupFileStream.totalFiles,\n            update: true,\n          })\n        },\n        {concurrency: opts.concurrency},\n      )\n    } catch (error) {\n      progressSpinner.fail()\n      const message = error instanceof Error ? error.message : String(error)\n      backupDownloadDebug(`Downloading dataset backup failed: ${message}`, error)\n      this.error(`Downloading dataset backup failed: ${message}`, {exit: 1})\n    }\n\n    docOutStream.end()\n    await finished(docOutStream)\n\n    progressSpinner.set({step: `Archiving files into a tarball...`, update: true})\n    try {\n      await archiveDir(tmpOutDir, outFilePath, (processedBytes: number) => {\n        progressSpinner.update({\n          step: `Archiving files into a tarball, ${humanFileSize(processedBytes)} bytes written...`,\n        })\n      })\n    } catch (err) {\n      progressSpinner.fail()\n      const message = err instanceof Error ? err.message : String(err)\n      backupDownloadDebug(`Archiving backup failed: ${message}`, err)\n      this.error(`Archiving backup failed: ${message}`, {exit: 1})\n    }\n\n    progressSpinner.set({\n      step: `Cleaning up temporary files at ${styleText('cyan', `${tmpOutDir}`)}`,\n    })\n    await cleanupTmpDir(tmpOutDir)\n\n    progressSpinner.set({\n      step: `Backup download complete [${prettyMs(Date.now() - start)}]`,\n    })\n    progressSpinner.succeed()\n  }\n\n  private async getOutputPath(defaultOutFileName: string): Promise<string> {\n    if (this.flags.out !== undefined) {\n      // Rewrite the output path to an absolute path, if it is not already.\n      return path.resolve(this.flags.out)\n    }\n\n    const workDir = process.cwd()\n    const inputResult = await input({\n      default: path.join(workDir, defaultOutFileName),\n      message: 'Output path:',\n    })\n    return path.resolve(inputResult)\n  }\n\n  private async prepareBackupOptions(\n    projectId: string,\n    datasetName: string,\n  ): Promise<DownloadBackupOptions> {\n    const err = validateDatasetName(datasetName)\n    if (err) {\n      this.error(err, {exit: 1})\n    }\n\n    const backupId = String(\n      this.flags['backup-id'] || (await this.promptForBackupId(projectId, datasetName)),\n    )\n\n    if (\n      'concurrency' in this.flags &&\n      (this.flags.concurrency < 1 || this.flags.concurrency > MAX_DOWNLOAD_CONCURRENCY)\n    ) {\n      this.error(`concurrency should be in 1 to ${MAX_DOWNLOAD_CONCURRENCY} range`, {exit: 1})\n    }\n\n    const defaultOutFileName = `${datasetName}-backup-${backupId}.tar.gz`\n    let out = await this.getOutputPath(defaultOutFileName)\n\n    // If path is a directory name, then add a default file name to the path.\n    if (isPathDirName(out)) {\n      out = path.join(out, defaultOutFileName)\n    }\n\n    const exists = await fileExists(out)\n    // If the file already exists, ask for confirmation if it should be overwritten.\n    if (!this.flags.overwrite && exists) {\n      const shouldOverwrite = await confirm({\n        default: false,\n        message: `File \"${out}\" already exists, would you like to overwrite it?`,\n      })\n\n      // If the user does not want to overwrite the file, cancel the operation.\n      if (!shouldOverwrite) {\n        this.error('Operation cancelled.', {exit: 1})\n      }\n    }\n\n    return {\n      backupId,\n      concurrency: this.flags.concurrency || DEFAULT_DOWNLOAD_CONCURRENCY,\n      datasetName,\n      outDir: path.dirname(out),\n      outFileName: path.basename(out),\n      overwrite: this.flags.overwrite,\n      projectId,\n    }\n  }\n\n  private async promptForBackupId(projectId: string, datasetName: string): Promise<string> {\n    const maxBackupIdsShown = 100\n\n    try {\n      const response = await listBackups({\n        datasetName,\n        limit: maxBackupIdsShown,\n        projectId,\n      })\n\n      if (!response?.backups?.length) {\n        this.error('No backups found', {exit: 1})\n      }\n\n      const backupIdChoices = response.backups.map((backup: BackupItem) => ({\n        name: backup.id,\n        value: backup.id,\n      }))\n\n      const hint =\n        backupIdChoices.length === maxBackupIdsShown\n          ? ` (only last ${maxBackupIdsShown} shown)`\n          : ''\n\n      return select({\n        choices: backupIdChoices,\n        message: `Select backup ID to use${hint}`,\n      })\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err)\n      backupDownloadDebug(`Failed to fetch backups for dataset ${datasetName}: ${message}`, err)\n      this.error(`Failed to fetch backups for dataset ${datasetName}: ${message}`, {exit: 1})\n    }\n  }\n}\n"],"names":["createWriteStream","mkdir","mkdtemp","tmpdir","path","finished","styleText","Args","Flags","fileExists","SanityCommand","boxen","confirm","input","select","pMap","prettyMs","archiveDir","assertDatasetExists","backupDownloadDebug","cleanupTmpDir","downloadAsset","downloadDocument","PaginatedGetBackupStream","newProgress","validateDatasetName","promptForDataset","listBackups","listDatasets","NO_PROJECT_ID","humanFileSize","isPathDirName","DEFAULT_DOWNLOAD_CONCURRENCY","MAX_DOWNLOAD_CONCURRENCY","DownloadBackupCommand","args","dataset","string","description","required","examples","command","flags","concurrency","integer","default","out","overwrite","boolean","run","parse","projectId","getProjectId","error","exit","datasets","message","Error","String","length","allowCreation","opts","prepareBackupOptions","outFilePath","join","outDir","outFileName","log","datasetName","backupId","borderColor","borderStyle","padding","start","Date","now","progressSpinner","tmpOutDir","dir","recursive","tmpOutDocumentsFile","docOutStream","backupFileStream","files","i","file","push","set","current","step","total","totalFiles","update","totalItemsDownloaded","type","url","name","doc","write","fail","end","processedBytes","err","succeed","getOutputPath","defaultOutFileName","undefined","resolve","workDir","process","cwd","inputResult","promptForBackupId","exists","shouldOverwrite","dirname","basename","maxBackupIdsShown","response","limit","backups","backupIdChoices","map","backup","id","value","hint","choices"],"mappings":"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"}