@sanity/cli 5.1.1-next.5 → 6.0.0-alpha.3

package/dist/commands/media/deploy-aspect.js

@@ -0,0 +1,150 @@
+import { Args, Flags } from '@oclif/core';
+import { SanityCommand, subdebug } from '@sanity/cli-core';
+import { chalk, spinner } from '@sanity/cli-core/ux';
+import { isAssetAspect } from '@sanity/types';
+import { getMediaLibraryConfig } from '../../actions/media/getMediaLibraryConfig.js';
+import { importAspects } from '../../actions/media/importAspects.js';
+import { selectMediaLibrary } from '../../prompts/selectMediaLibrary.js';
+import { deployAspects } from '../../services/mediaLibraries.js';
+import { NO_MEDIA_LIBRARY_ASPECTS_PATH, NO_PROJECT_ID } from '../../util/errorMessages.js';
+import { pluralize } from '../../util/pluralize.js';
+const deployAspectDebug = subdebug('media:deploy-aspect');
+export class MediaDeployAspectCommand extends SanityCommand {
+    static args = {
+        aspectName: Args.string({
+            description: 'Name of the aspect to deploy',
+            required: false
+        })
+    };
+    static description = 'Deploy an aspect';
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %> someAspect',
+            description: 'Deploy the aspect named "someAspect"'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> --all',
+            description: 'Deploy all aspects'
+        }
+    ];
+    static flags = {
+        all: Flags.boolean({
+            description: 'Deploy all aspects',
+            required: false
+        }),
+        'media-library-id': Flags.string({
+            description: 'The id of the target media library',
+            required: false
+        })
+    };
+    async run() {
+        const { aspectName } = this.args;
+        const { all, 'media-library-id': mediaLibraryIdFlag } = this.flags;
+        // Validation: must provide either aspect name or --all flag
+        if (!all && !aspectName) {
+            this.error('Specify an aspect name, or use the `--all` option to deploy all aspect definitions.', {
+                exit: 1
+            });
+        }
+        // Validation: cannot provide both aspect name and --all flag
+        if (all && aspectName) {
+            this.error('Specified both an aspect name and `--all`.', {
+                exit: 1
+            });
+        }
+        const cliConfig = await this.getCliConfig();
+        const mediaLibrary = getMediaLibraryConfig(cliConfig);
+        if (!mediaLibrary?.aspectsPath) {
+            this.error(NO_MEDIA_LIBRARY_ASPECTS_PATH, {
+                exit: 1
+            });
+        }
+        const projectId = await this.getProjectId();
+        if (!projectId) {
+            this.error(NO_PROJECT_ID, {
+                exit: 1
+            });
+        }
+        try {
+            // Determine target media library
+            let mediaLibraryId = mediaLibraryIdFlag;
+            if (!mediaLibraryId) {
+                mediaLibraryId = await selectMediaLibrary(projectId);
+            }
+            // Import and validate aspects
+            const spin = spinner('Loading aspect definitions').start();
+            const result = await importAspects({
+                aspectsPath: mediaLibrary.aspectsPath,
+                filterAspects: (aspect)=>{
+                    if (all) {
+                        return true;
+                    }
+                    if (typeof aspect === 'object' && aspect !== null && '_id' in aspect) {
+                        return aspect._id === aspectName;
+                    }
+                    return false;
+                }
+            });
+            spin.stop();
+            // Handle invalid aspects
+            if (result.invalid.length > 0) {
+                this.logToStderr('');
+                this.warn(chalk.bold(`Skipped ${result.invalid.length} invalid ${pluralize('aspect', result.invalid.length)}`));
+                this.logToStderr(this.formatAspectList(result.invalid));
+            }
+            // Check if we found the requested aspect (when not using --all)
+            if (!all && result.valid.length === 0 && result.invalid.length === 0) {
+                this.log();
+                this.error(`Could not find aspect: ${chalk.bold(aspectName)}`, {
+                    exit: 1
+                });
+            }
+            // Deploy valid aspects
+            if (result.valid.length === 0) {
+                this.logToStderr('');
+                this.warn('No valid aspects to deploy');
+                return;
+            }
+            const deploySpin = spinner(`Deploying ${result.valid.length} ${pluralize('aspect', result.valid.length)}`).start();
+            const deployResponse = await deployAspects({
+                aspects: result.valid.map((a)=>a.aspect),
+                mediaLibraryId
+            });
+            deploySpin.succeed();
+            // Display success message
+            this.log();
+            this.log(`${chalk.green('✓')} ${chalk.bold(`Deployed ${result.valid.length} ${pluralize('aspect', result.valid.length)}`)}`);
+            this.log(this.formatAspectList(result.valid));
+            deployAspectDebug('Deployed aspects', {
+                count: result.valid.length,
+                results: deployResponse.results
+            });
+        } catch (error) {
+            const err = error;
+            deployAspectDebug('Failed to deploy aspects', {
+                all,
+                aspectName,
+                error: err,
+                mediaLibraryId: mediaLibraryIdFlag
+            });
+            this.error(chalk.bold('Failed to deploy aspects') + `\n\n${chalk.red(err.message)}`, {
+                exit: 1
+            });
+        }
+    }
+    /**
+   * Format a list of aspects for display
+   */ formatAspectList(aspects) {
+        return aspects.map(({ aspect, filename, validationErrors = [] })=>{
+            const label = isAssetAspect(aspect) ? aspect._id : 'Unnamed aspect';
+            // Flatten the nested validation errors and extract messages
+            const simplifiedErrors = validationErrors.flatMap((group)=>group.map(({ message })=>message));
+            const errorLabel = simplifiedErrors.length > 0 ? ` ${chalk.bgRed(simplifiedErrors[0])}` : '';
+            const remainingErrorsCount = simplifiedErrors.length - 1;
+            const remainingErrorsLabel = remainingErrorsCount > 0 ? chalk.italic(` and ${remainingErrorsCount} other ${pluralize('error', remainingErrorsCount)}`) : '';
+            return `  - ${label} ${chalk.dim(filename)}${errorLabel}${remainingErrorsLabel}`;
+        }).join('\n');
+    }
+}
+
+//# sourceMappingURL=deploy-aspect.js.map

package/dist/commands/media/deploy-aspect.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/commands/media/deploy-aspect.ts"],"sourcesContent":["import {Args, Flags} from '@oclif/core'\nimport {SanityCommand, subdebug} from '@sanity/cli-core'\nimport {chalk, spinner} from '@sanity/cli-core/ux'\nimport {isAssetAspect, type SchemaValidationProblem} from '@sanity/types'\n\nimport {getMediaLibraryConfig} from '../../actions/media/getMediaLibraryConfig.js'\nimport {importAspects} from '../../actions/media/importAspects.js'\nimport {selectMediaLibrary} from '../../prompts/selectMediaLibrary.js'\nimport {deployAspects} from '../../services/mediaLibraries.js'\nimport {NO_MEDIA_LIBRARY_ASPECTS_PATH, NO_PROJECT_ID} from '../../util/errorMessages.js'\nimport {pluralize} from '../../util/pluralize.js'\n\nconst deployAspectDebug = subdebug('media:deploy-aspect')\n\nexport class MediaDeployAspectCommand extends SanityCommand<typeof MediaDeployAspectCommand> {\n  static override args = {\n    aspectName: Args.string({\n      description: 'Name of the aspect to deploy',\n      required: false,\n    }),\n  }\n\n  static override description = 'Deploy an aspect'\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %> someAspect',\n      description: 'Deploy the aspect named \"someAspect\"',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> --all',\n      description: 'Deploy all aspects',\n    },\n  ]\n\n  static override flags = {\n    all: Flags.boolean({\n      description: 'Deploy all aspects',\n      required: false,\n    }),\n    'media-library-id': Flags.string({\n      description: 'The id of the target media library',\n      required: false,\n    }),\n  }\n\n  public async run(): Promise<void> {\n    const {aspectName} = this.args\n    const {all, 'media-library-id': mediaLibraryIdFlag} = this.flags\n\n    // Validation: must provide either aspect name or --all flag\n    if (!all && !aspectName) {\n      this.error(\n        'Specify an aspect name, or use the `--all` option to deploy all aspect definitions.',\n        {exit: 1},\n      )\n    }\n\n    // Validation: cannot provide both aspect name and --all flag\n    if (all && aspectName) {\n      this.error('Specified both an aspect name and `--all`.', {exit: 1})\n    }\n\n    const cliConfig = await this.getCliConfig()\n    const mediaLibrary = getMediaLibraryConfig(cliConfig)\n\n    if (!mediaLibrary?.aspectsPath) {\n      this.error(NO_MEDIA_LIBRARY_ASPECTS_PATH, {exit: 1})\n    }\n\n    const projectId = await this.getProjectId()\n    if (!projectId) {\n      this.error(NO_PROJECT_ID, {exit: 1})\n    }\n\n    try {\n      // Determine target media library\n      let mediaLibraryId = mediaLibraryIdFlag\n      if (!mediaLibraryId) {\n        mediaLibraryId = await selectMediaLibrary(projectId)\n      }\n\n      // Import and validate aspects\n      const spin = spinner('Loading aspect definitions').start()\n      const result = await importAspects({\n        aspectsPath: mediaLibrary.aspectsPath,\n        filterAspects: (aspect) => {\n          if (all) {\n            return true\n          }\n\n          if (typeof aspect === 'object' && aspect !== null && '_id' in aspect) {\n            return aspect._id === aspectName\n          }\n\n          return false\n        },\n      })\n      spin.stop()\n\n      // Handle invalid aspects\n      if (result.invalid.length > 0) {\n        this.logToStderr('')\n        this.warn(\n          chalk.bold(\n            `Skipped ${result.invalid.length} invalid ${pluralize('aspect', result.invalid.length)}`,\n          ),\n        )\n        this.logToStderr(this.formatAspectList(result.invalid))\n      }\n\n      // Check if we found the requested aspect (when not using --all)\n      if (!all && result.valid.length === 0 && result.invalid.length === 0) {\n        this.log()\n        this.error(`Could not find aspect: ${chalk.bold(aspectName)}`, {exit: 1})\n      }\n\n      // Deploy valid aspects\n      if (result.valid.length === 0) {\n        this.logToStderr('')\n        this.warn('No valid aspects to deploy')\n        return\n      }\n\n      const deploySpin = spinner(\n        `Deploying ${result.valid.length} ${pluralize('aspect', result.valid.length)}`,\n      ).start()\n\n      const deployResponse = await deployAspects({\n        aspects: result.valid.map((a) => a.aspect),\n        mediaLibraryId,\n      })\n\n      deploySpin.succeed()\n\n      // Display success message\n      this.log()\n      this.log(\n        `${chalk.green('✓')} ${chalk.bold(`Deployed ${result.valid.length} ${pluralize('aspect', result.valid.length)}`)}`,\n      )\n      this.log(this.formatAspectList(result.valid))\n\n      deployAspectDebug('Deployed aspects', {\n        count: result.valid.length,\n        results: deployResponse.results,\n      })\n    } catch (error) {\n      const err = error as Error\n      deployAspectDebug('Failed to deploy aspects', {\n        all,\n        aspectName,\n        error: err,\n        mediaLibraryId: mediaLibraryIdFlag,\n      })\n      this.error(chalk.bold('Failed to deploy aspects') + `\\n\\n${chalk.red(err.message)}`, {\n        exit: 1,\n      })\n    }\n  }\n\n  /**\n   * Format a list of aspects for display\n   */\n  private formatAspectList(\n    aspects: Array<{\n      aspect: unknown\n      filename: string\n      validationErrors?: SchemaValidationProblem[][]\n    }>,\n  ): string {\n    return aspects\n      .map(({aspect, filename, validationErrors = []}) => {\n        const label = isAssetAspect(aspect) ? aspect._id : 'Unnamed aspect'\n\n        // Flatten the nested validation errors and extract messages\n        const simplifiedErrors = validationErrors.flatMap((group) =>\n          group.map(({message}) => message),\n        )\n\n        const errorLabel = simplifiedErrors.length > 0 ? ` ${chalk.bgRed(simplifiedErrors[0])}` : ''\n\n        const remainingErrorsCount = simplifiedErrors.length - 1\n        const remainingErrorsLabel =\n          remainingErrorsCount > 0\n            ? chalk.italic(\n                ` and ${remainingErrorsCount} other ${pluralize('error', remainingErrorsCount)}`,\n              )\n            : ''\n\n        return `  - ${label} ${chalk.dim(filename)}${errorLabel}${remainingErrorsLabel}`\n      })\n      .join('\\n')\n  }\n}\n"],"names":["Args","Flags","SanityCommand","subdebug","chalk","spinner","isAssetAspect","getMediaLibraryConfig","importAspects","selectMediaLibrary","deployAspects","NO_MEDIA_LIBRARY_ASPECTS_PATH","NO_PROJECT_ID","pluralize","deployAspectDebug","MediaDeployAspectCommand","args","aspectName","string","description","required","examples","command","flags","all","boolean","run","mediaLibraryIdFlag","error","exit","cliConfig","getCliConfig","mediaLibrary","aspectsPath","projectId","getProjectId","mediaLibraryId","spin","start","result","filterAspects","aspect","_id","stop","invalid","length","logToStderr","warn","bold","formatAspectList","valid","log","deploySpin","deployResponse","aspects","map","a","succeed","green","count","results","err","red","message","filename","validationErrors","label","simplifiedErrors","flatMap","group","errorLabel","bgRed","remainingErrorsCount","remainingErrorsLabel","italic","dim","join"],"mappings":"AAAA,SAAQA,IAAI,EAAEC,KAAK,QAAO,cAAa;AACvC,SAAQC,aAAa,EAAEC,QAAQ,QAAO,mBAAkB;AACxD,SAAQC,KAAK,EAAEC,OAAO,QAAO,sBAAqB;AAClD,SAAQC,aAAa,QAAqC,gBAAe;AAEzE,SAAQC,qBAAqB,QAAO,+CAA8C;AAClF,SAAQC,aAAa,QAAO,uCAAsC;AAClE,SAAQC,kBAAkB,QAAO,sCAAqC;AACtE,SAAQC,aAAa,QAAO,mCAAkC;AAC9D,SAAQC,6BAA6B,EAAEC,aAAa,QAAO,8BAA6B;AACxF,SAAQC,SAAS,QAAO,0BAAyB;AAEjD,MAAMC,oBAAoBX,SAAS;AAEnC,OAAO,MAAMY,iCAAiCb;IAC5C,OAAgBc,OAAO;QACrBC,YAAYjB,KAAKkB,MAAM,CAAC;YACtBC,aAAa;YACbC,UAAU;QACZ;IACF,EAAC;IAED,OAAgBD,cAAc,mBAAkB;IAEhD,OAAgBE,WAAW;QACzB;YACEC,SAAS;YACTH,aAAa;QACf;QACA;YACEG,SAAS;YACTH,aAAa;QACf;KACD,CAAA;IAED,OAAgBI,QAAQ;QACtBC,KAAKvB,MAAMwB,OAAO,CAAC;YACjBN,aAAa;YACbC,UAAU;QACZ;QACA,oBAAoBnB,MAAMiB,MAAM,CAAC;YAC/BC,aAAa;YACbC,UAAU;QACZ;IACF,EAAC;IAED,MAAaM,MAAqB;QAChC,MAAM,EAACT,UAAU,EAAC,GAAG,IAAI,CAACD,IAAI;QAC9B,MAAM,EAACQ,GAAG,EAAE,oBAAoBG,kBAAkB,EAAC,GAAG,IAAI,CAACJ,KAAK;QAEhE,4DAA4D;QAC5D,IAAI,CAACC,OAAO,CAACP,YAAY;YACvB,IAAI,CAACW,KAAK,CACR,uFACA;gBAACC,MAAM;YAAC;QAEZ;QAEA,6DAA6D;QAC7D,IAAIL,OAAOP,YAAY;YACrB,IAAI,CAACW,KAAK,CAAC,8CAA8C;gBAACC,MAAM;YAAC;QACnE;QAEA,MAAMC,YAAY,MAAM,IAAI,CAACC,YAAY;QACzC,MAAMC,eAAezB,sBAAsBuB;QAE3C,IAAI,CAACE,cAAcC,aAAa;YAC9B,IAAI,CAACL,KAAK,CAACjB,+BAA+B;gBAACkB,MAAM;YAAC;QACpD;QAEA,MAAMK,YAAY,MAAM,IAAI,CAACC,YAAY;QACzC,IAAI,CAACD,WAAW;YACd,IAAI,CAACN,KAAK,CAAChB,eAAe;gBAACiB,MAAM;YAAC;QACpC;QAEA,IAAI;YACF,iCAAiC;YACjC,IAAIO,iBAAiBT;YACrB,IAAI,CAACS,gBAAgB;gBACnBA,iBAAiB,MAAM3B,mBAAmByB;YAC5C;YAEA,8BAA8B;YAC9B,MAAMG,OAAOhC,QAAQ,8BAA8BiC,KAAK;YACxD,MAAMC,SAAS,MAAM/B,cAAc;gBACjCyB,aAAaD,aAAaC,WAAW;gBACrCO,eAAe,CAACC;oBACd,IAAIjB,KAAK;wBACP,OAAO;oBACT;oBAEA,IAAI,OAAOiB,WAAW,YAAYA,WAAW,QAAQ,SAASA,QAAQ;wBACpE,OAAOA,OAAOC,GAAG,KAAKzB;oBACxB;oBAEA,OAAO;gBACT;YACF;YACAoB,KAAKM,IAAI;YAET,yBAAyB;YACzB,IAAIJ,OAAOK,OAAO,CAACC,MAAM,GAAG,GAAG;gBAC7B,IAAI,CAACC,WAAW,CAAC;gBACjB,IAAI,CAACC,IAAI,CACP3C,MAAM4C,IAAI,CACR,CAAC,QAAQ,EAAET,OAAOK,OAAO,CAACC,MAAM,CAAC,SAAS,EAAEhC,UAAU,UAAU0B,OAAOK,OAAO,CAACC,MAAM,GAAG;gBAG5F,IAAI,CAACC,WAAW,CAAC,IAAI,CAACG,gBAAgB,CAACV,OAAOK,OAAO;YACvD;YAEA,gEAAgE;YAChE,IAAI,CAACpB,OAAOe,OAAOW,KAAK,CAACL,MAAM,KAAK,KAAKN,OAAOK,OAAO,CAACC,MAAM,KAAK,GAAG;gBACpE,IAAI,CAACM,GAAG;gBACR,IAAI,CAACvB,KAAK,CAAC,CAAC,uBAAuB,EAAExB,MAAM4C,IAAI,CAAC/B,aAAa,EAAE;oBAACY,MAAM;gBAAC;YACzE;YAEA,uBAAuB;YACvB,IAAIU,OAAOW,KAAK,CAACL,MAAM,KAAK,GAAG;gBAC7B,IAAI,CAACC,WAAW,CAAC;gBACjB,IAAI,CAACC,IAAI,CAAC;gBACV;YACF;YAEA,MAAMK,aAAa/C,QACjB,CAAC,UAAU,EAAEkC,OAAOW,KAAK,CAACL,MAAM,CAAC,CAAC,EAAEhC,UAAU,UAAU0B,OAAOW,KAAK,CAACL,MAAM,GAAG,EAC9EP,KAAK;YAEP,MAAMe,iBAAiB,MAAM3C,cAAc;gBACzC4C,SAASf,OAAOW,KAAK,CAACK,GAAG,CAAC,CAACC,IAAMA,EAAEf,MAAM;gBACzCL;YACF;YAEAgB,WAAWK,OAAO;YAElB,0BAA0B;YAC1B,IAAI,CAACN,GAAG;YACR,IAAI,CAACA,GAAG,CACN,GAAG/C,MAAMsD,KAAK,CAAC,KAAK,CAAC,EAAEtD,MAAM4C,IAAI,CAAC,CAAC,SAAS,EAAET,OAAOW,KAAK,CAACL,MAAM,CAAC,CAAC,EAAEhC,UAAU,UAAU0B,OAAOW,KAAK,CAACL,MAAM,GAAG,GAAG;YAEpH,IAAI,CAACM,GAAG,CAAC,IAAI,CAACF,gBAAgB,CAACV,OAAOW,KAAK;YAE3CpC,kBAAkB,oBAAoB;gBACpC6C,OAAOpB,OAAOW,KAAK,CAACL,MAAM;gBAC1Be,SAASP,eAAeO,OAAO;YACjC;QACF,EAAE,OAAOhC,OAAO;YACd,MAAMiC,MAAMjC;YACZd,kBAAkB,4BAA4B;gBAC5CU;gBACAP;gBACAW,OAAOiC;gBACPzB,gBAAgBT;YAClB;YACA,IAAI,CAACC,KAAK,CAACxB,MAAM4C,IAAI,CAAC,8BAA8B,CAAC,IAAI,EAAE5C,MAAM0D,GAAG,CAACD,IAAIE,OAAO,GAAG,EAAE;gBACnFlC,MAAM;YACR;QACF;IACF;IAEA;;GAEC,GACD,AAAQoB,iBACNK,OAIE,EACM;QACR,OAAOA,QACJC,GAAG,CAAC,CAAC,EAACd,MAAM,EAAEuB,QAAQ,EAAEC,mBAAmB,EAAE,EAAC;YAC7C,MAAMC,QAAQ5D,cAAcmC,UAAUA,OAAOC,GAAG,GAAG;YAEnD,4DAA4D;YAC5D,MAAMyB,mBAAmBF,iBAAiBG,OAAO,CAAC,CAACC,QACjDA,MAAMd,GAAG,CAAC,CAAC,EAACQ,OAAO,EAAC,GAAKA;YAG3B,MAAMO,aAAaH,iBAAiBtB,MAAM,GAAG,IAAI,CAAC,CAAC,EAAEzC,MAAMmE,KAAK,CAACJ,gBAAgB,CAAC,EAAE,GAAG,GAAG;YAE1F,MAAMK,uBAAuBL,iBAAiBtB,MAAM,GAAG;YACvD,MAAM4B,uBACJD,uBAAuB,IACnBpE,MAAMsE,MAAM,CACV,CAAC,KAAK,EAAEF,qBAAqB,OAAO,EAAE3D,UAAU,SAAS2D,uBAAuB,IAElF;YAEN,OAAO,CAAC,IAAI,EAAEN,MAAM,CAAC,EAAE9D,MAAMuE,GAAG,CAACX,YAAYM,aAAaG,sBAAsB;QAClF,GACCG,IAAI,CAAC;IACV;AACF"}

package/dist/commands/media/export.d.ts

@@ -0,0 +1,21 @@
+import { SanityCommand } from '@sanity/cli-core';
+export declare class MediaExportCommand extends SanityCommand<typeof MediaExportCommand> {
+    static args: {
+        destination: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: {
+        command: string;
+        description: string;
+    }[];
+    static flags: {
+        'asset-concurrency': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'media-library-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'no-compress': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        overwrite: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private createProgressHandler;
+    private getOutputPath;
+    private promptForDestination;
+}

package/dist/commands/media/export.js

@@ -0,0 +1,211 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { Args, Flags } from '@oclif/core';
+import { SanityCommand, subdebug } from '@sanity/cli-core';
+import { input, spinner } from '@sanity/cli-core/ux';
+import { exportDataset } from '@sanity/export';
+import boxen from 'boxen';
+import prettyMs from 'pretty-ms';
+import { promptForMediaLibrary } from '../../prompts/promptForMediaLibrary.js';
+import { getMediaLibraries } from '../../services/mediaLibraries.js';
+import { absolutify } from '../../util/absolutify.js';
+import { NO_PROJECT_ID } from '../../util/errorMessages.js';
+const noop = ()=>null;
+const exportDebug = subdebug('media:export');
+export class MediaExportCommand extends SanityCommand {
+    static args = {
+        destination: Args.string({
+            description: 'Output destination file path'
+        })
+    };
+    static description = 'Export an archive of all file and image assets including their aspect data from the target media library. Video assets are excluded from the export.';
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %>',
+            description: 'Export media library interactively'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> output.tar.gz',
+            description: 'Export media library to output.tar.gz'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> --media-library-id my-library-id',
+            description: 'Export specific media library'
+        }
+    ];
+    static flags = {
+        'asset-concurrency': Flags.integer({
+            default: 8,
+            description: 'Concurrent number of asset downloads'
+        }),
+        'media-library-id': Flags.string({
+            description: 'The id of the target media library'
+        }),
+        'no-compress': Flags.boolean({
+            default: false,
+            description: 'Skips compressing tarball entries (still generates a gzip file)'
+        }),
+        overwrite: Flags.boolean({
+            default: false,
+            description: 'Overwrite any file with the same name'
+        })
+    };
+    async run() {
+        const { args, flags } = await this.parse(MediaExportCommand);
+        const { destination: targetDestination } = args;
+        const projectId = await this.getProjectId();
+        if (!projectId) {
+            this.error(NO_PROJECT_ID, {
+                exit: 1
+            });
+        }
+        const projectClient = await this.getProjectApiClient({
+            apiVersion: 'v2025-02-19',
+            projectId,
+            requireUser: true
+        });
+        let mediaLibraries;
+        try {
+            mediaLibraries = await getMediaLibraries(projectId);
+        } catch (error) {
+            exportDebug('Error listing media libraries', error);
+            this.error(`Failed to list media libraries:\n${error instanceof Error ? error.message : error}`, {
+                exit: 1
+            });
+        }
+        if (mediaLibraries.length === 0) {
+            this.error('No active media libraries found in this project', {
+                exit: 1
+            });
+        }
+        let mediaLibraryId = flags['media-library-id'];
+        if (!mediaLibraryId) {
+            try {
+                mediaLibraryId = await promptForMediaLibrary({
+                    mediaLibraries
+                });
+            } catch (error) {
+                exportDebug('Error selecting media library', error);
+                this.error(`Failed to select media library:\n${error instanceof Error ? error.message : error}`, {
+                    exit: 1
+                });
+            }
+        }
+        if (!mediaLibraries.some((library)=>library.id === mediaLibraryId)) {
+            this.error(`Media library with id "${mediaLibraryId}" not found`, {
+                exit: 1
+            });
+        }
+        this.log(boxen(`Exporting from:
+projectId: ${projectId.padEnd(44)}
+mediaLibraryId: ${mediaLibraryId.padEnd(37)}`, {
+            borderColor: 'yellow',
+            borderStyle: 'round'
+        }));
+        let destinationPath = targetDestination;
+        if (!destinationPath) {
+            destinationPath = await this.promptForDestination({
+                mediaLibraryId
+            });
+        }
+        const outputPath = await this.getOutputPath(destinationPath, mediaLibraryId, flags);
+        if (!outputPath) {
+            this.error('Cancelled', {
+                exit: 1
+            });
+        }
+        const { fail, onProgress, succeed } = this.createProgressHandler();
+        const exportOptions = {
+            assetConcurrency: flags['asset-concurrency'],
+            client: projectClient,
+            compress: !flags['no-compress'],
+            mediaLibraryId,
+            onProgress,
+            outputPath
+        };
+        const start = Date.now();
+        try {
+            await exportDataset(exportOptions);
+            succeed();
+            this.log(`Export finished (${prettyMs(Date.now() - start)})`);
+        } catch (error) {
+            fail();
+            const err = error instanceof Error ? error : new Error(String(error));
+            exportDebug('Export failed', err);
+            this.error(`Export failed: ${err.message}`, {
+                exit: 1
+            });
+        }
+    }
+    createProgressHandler() {
+        let currentSpinner = null;
+        let currentStep = '';
+        const onProgress = (progress)=>{
+            if (progress.step !== currentStep) {
+                succeed();
+                currentStep = progress.step;
+                currentSpinner = spinner(progress.step).start();
+            } else if (progress.step === currentStep && progress.update && currentSpinner) {
+                currentSpinner.text = `${progress.step} (${progress.current}/${progress.total})`;
+            }
+        };
+        const succeed = ()=>{
+            currentSpinner?.succeed();
+        };
+        const fail = ()=>{
+            currentSpinner?.fail();
+        };
+        return {
+            fail,
+            onProgress,
+            succeed
+        };
+    }
+    async getOutputPath(destination, mediaLibraryId, flags) {
+        if (destination === '-') {
+            return process.stdout;
+        }
+        const dstPath = path.isAbsolute(destination) ? destination : path.resolve(process.cwd(), destination);
+        const dstStats = await fs.stat(dstPath).catch(noop);
+        const looksLikeFile = dstStats ? dstStats.isFile() : path.basename(dstPath).includes('.');
+        if (!dstStats) {
+            const createPath = looksLikeFile ? path.dirname(dstPath) : dstPath;
+            try {
+                await fs.mkdir(createPath, {
+                    recursive: true
+                });
+            } catch (error) {
+                const err = error instanceof Error ? error : new Error(String(error));
+                this.error(`Failed to create directory "${createPath}": ${err.message}`, {
+                    exit: 1
+                });
+            }
+        }
+        const finalPath = looksLikeFile ? dstPath : path.join(dstPath, `${mediaLibraryId}-export.tar.gz`);
+        const finalPathStats = await fs.stat(finalPath).catch(noop);
+        if (!flags.overwrite && finalPathStats && finalPathStats.isFile()) {
+            this.error(`File "${finalPath}" already exists. Use --overwrite flag to overwrite it.`, {
+                exit: 1
+            });
+        }
+        return finalPath;
+    }
+    promptForDestination(options) {
+        const { mediaLibraryId, workDir = process.cwd() } = options;
+        const defaultPath = path.join(workDir, `${mediaLibraryId}-export.tar.gz`);
+        return input({
+            default: defaultPath,
+            message: 'Output path:',
+            transformer: (value)=>absolutify(value.trim()),
+            validate: (value)=>{
+                const trimmed = value.trim();
+                if (!trimmed) {
+                    return 'Please provide a valid output path';
+                }
+                return true;
+            }
+        });
+    }
+}
+
+//# sourceMappingURL=export.js.map

package/dist/commands/media/export.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/commands/media/export.ts"],"sourcesContent":["import fs from 'node:fs/promises'\nimport path from 'node:path'\nimport {type Writable} from 'node:stream'\n\nimport {Args, Flags} from '@oclif/core'\nimport {SanityCommand, subdebug} from '@sanity/cli-core'\nimport {input, spinner} from '@sanity/cli-core/ux'\nimport {exportDataset, type ExportOptions, type ExportProgress} from '@sanity/export'\nimport boxen from 'boxen'\nimport prettyMs from 'pretty-ms'\n\nimport {promptForMediaLibrary} from '../../prompts/promptForMediaLibrary.js'\nimport {getMediaLibraries} from '../../services/mediaLibraries.js'\nimport {absolutify} from '../../util/absolutify.js'\nimport {NO_PROJECT_ID} from '../../util/errorMessages.js'\n\nconst noop = () => null\nconst exportDebug = subdebug('media:export')\n\nexport class MediaExportCommand extends SanityCommand<typeof MediaExportCommand> {\n  static override args = {\n    destination: Args.string({\n      description: 'Output destination file path',\n    }),\n  }\n\n  static override description =\n    'Export an archive of all file and image assets including their aspect data from the target media library. Video assets are excluded from the export.'\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %>',\n      description: 'Export media library interactively',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> output.tar.gz',\n      description: 'Export media library to output.tar.gz',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> --media-library-id my-library-id',\n      description: 'Export specific media library',\n    },\n  ]\n\n  static override flags = {\n    'asset-concurrency': Flags.integer({\n      default: 8,\n      description: 'Concurrent number of asset downloads',\n    }),\n    'media-library-id': Flags.string({\n      description: 'The id of the target media library',\n    }),\n    'no-compress': Flags.boolean({\n      default: false,\n      description: 'Skips compressing tarball entries (still generates a gzip file)',\n    }),\n    overwrite: Flags.boolean({\n      default: false,\n      description: 'Overwrite any file with the same name',\n    }),\n  }\n\n  public async run(): Promise<void> {\n    const {args, flags} = await this.parse(MediaExportCommand)\n    const {destination: targetDestination} = args\n\n    const projectId = await this.getProjectId()\n\n    if (!projectId) {\n      this.error(NO_PROJECT_ID, {\n        exit: 1,\n      })\n    }\n\n    const projectClient = await this.getProjectApiClient({\n      apiVersion: 'v2025-02-19',\n      projectId,\n      requireUser: true,\n    })\n\n    let mediaLibraries\n    try {\n      mediaLibraries = await getMediaLibraries(projectId)\n    } catch (error) {\n      exportDebug('Error listing media libraries', error)\n      this.error(\n        `Failed to list media libraries:\\n${error instanceof Error ? error.message : error}`,\n        {\n          exit: 1,\n        },\n      )\n    }\n\n    if (mediaLibraries.length === 0) {\n      this.error('No active media libraries found in this project', {exit: 1})\n    }\n\n    let mediaLibraryId = flags['media-library-id']\n    if (!mediaLibraryId) {\n      try {\n        mediaLibraryId = await promptForMediaLibrary({mediaLibraries})\n      } catch (error) {\n        exportDebug('Error selecting media library', error)\n        this.error(\n          `Failed to select media library:\\n${error instanceof Error ? error.message : error}`,\n          {\n            exit: 1,\n          },\n        )\n      }\n    }\n\n    if (!mediaLibraries.some((library) => library.id === mediaLibraryId)) {\n      this.error(`Media library with id \"${mediaLibraryId}\" not found`, {exit: 1})\n    }\n\n    this.log(\n      boxen(\n        `Exporting from:\nprojectId: ${projectId.padEnd(44)}\nmediaLibraryId: ${mediaLibraryId.padEnd(37)}`,\n        {\n          borderColor: 'yellow',\n          borderStyle: 'round',\n        },\n      ),\n    )\n\n    let destinationPath = targetDestination\n    if (!destinationPath) {\n      destinationPath = await this.promptForDestination({mediaLibraryId})\n    }\n\n    const outputPath = await this.getOutputPath(destinationPath, mediaLibraryId, flags)\n    if (!outputPath) {\n      this.error('Cancelled', {exit: 1})\n    }\n\n    const {fail, onProgress, succeed} = this.createProgressHandler()\n    const exportOptions: ExportOptions = {\n      assetConcurrency: flags['asset-concurrency'],\n      client: projectClient,\n      compress: !flags['no-compress'],\n      mediaLibraryId,\n      onProgress,\n      outputPath,\n    }\n\n    const start = Date.now()\n    try {\n      await exportDataset(exportOptions)\n      succeed()\n      this.log(`Export finished (${prettyMs(Date.now() - start)})`)\n    } catch (error) {\n      fail()\n      const err = error instanceof Error ? error : new Error(String(error))\n      exportDebug('Export failed', err)\n      this.error(`Export failed: ${err.message}`, {exit: 1})\n    }\n  }\n\n  private createProgressHandler() {\n    let currentSpinner: ReturnType<typeof spinner> | null = null\n    let currentStep = ''\n\n    const onProgress = (progress: ExportProgress) => {\n      if (progress.step !== currentStep) {\n        succeed()\n\n        currentStep = progress.step\n        currentSpinner = spinner(progress.step).start()\n      } else if (progress.step === currentStep && progress.update && currentSpinner) {\n        currentSpinner.text = `${progress.step} (${progress.current}/${progress.total})`\n      }\n    }\n\n    const succeed = () => {\n      currentSpinner?.succeed()\n    }\n\n    const fail = () => {\n      currentSpinner?.fail()\n    }\n\n    return {fail, onProgress, succeed}\n  }\n\n  private async getOutputPath(\n    destination: string,\n    mediaLibraryId: string,\n    flags: {overwrite?: boolean},\n  ): Promise<string | Writable> {\n    if (destination === '-') {\n      return process.stdout\n    }\n\n    const dstPath = path.isAbsolute(destination)\n      ? destination\n      : path.resolve(process.cwd(), destination)\n\n    const dstStats = await fs.stat(dstPath).catch(noop)\n    const looksLikeFile = dstStats ? dstStats.isFile() : path.basename(dstPath).includes('.')\n\n    if (!dstStats) {\n      const createPath = looksLikeFile ? path.dirname(dstPath) : dstPath\n      try {\n        await fs.mkdir(createPath, {recursive: true})\n      } catch (error) {\n        const err = error instanceof Error ? error : new Error(String(error))\n        this.error(`Failed to create directory \"${createPath}\": ${err.message}`, {\n          exit: 1,\n        })\n      }\n    }\n\n    const finalPath = looksLikeFile\n      ? dstPath\n      : path.join(dstPath, `${mediaLibraryId}-export.tar.gz`)\n    const finalPathStats = await fs.stat(finalPath).catch(noop)\n\n    if (!flags.overwrite && finalPathStats && finalPathStats.isFile()) {\n      this.error(`File \"${finalPath}\" already exists. Use --overwrite flag to overwrite it.`, {\n        exit: 1,\n      })\n    }\n\n    return finalPath\n  }\n\n  private promptForDestination(options: {\n    mediaLibraryId: string\n    workDir?: string\n  }): Promise<string> {\n    const {mediaLibraryId, workDir = process.cwd()} = options\n\n    const defaultPath = path.join(workDir, `${mediaLibraryId}-export.tar.gz`)\n\n    return input({\n      default: defaultPath,\n      message: 'Output path:',\n      transformer: (value: string) => absolutify(value.trim()),\n      validate: (value: string) => {\n        const trimmed = value.trim()\n        if (!trimmed) {\n          return 'Please provide a valid output path'\n        }\n        return true\n      },\n    })\n  }\n}\n"],"names":["fs","path","Args","Flags","SanityCommand","subdebug","input","spinner","exportDataset","boxen","prettyMs","promptForMediaLibrary","getMediaLibraries","absolutify","NO_PROJECT_ID","noop","exportDebug","MediaExportCommand","args","destination","string","description","examples","command","flags","integer","default","boolean","overwrite","run","parse","targetDestination","projectId","getProjectId","error","exit","projectClient","getProjectApiClient","apiVersion","requireUser","mediaLibraries","Error","message","length","mediaLibraryId","some","library","id","log","padEnd","borderColor","borderStyle","destinationPath","promptForDestination","outputPath","getOutputPath","fail","onProgress","succeed","createProgressHandler","exportOptions","assetConcurrency","client","compress","start","Date","now","err","String","currentSpinner","currentStep","progress","step","update","text","current","total","process","stdout","dstPath","isAbsolute","resolve","cwd","dstStats","stat","catch","looksLikeFile","isFile","basename","includes","createPath","dirname","mkdir","recursive","finalPath","join","finalPathStats","options","workDir","defaultPath","transformer","value","trim","validate","trimmed"],"mappings":"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"}

package/dist/commands/media/import.d.ts

@@ -0,0 +1,18 @@
+import { SanityCommand } from '@sanity/cli-core';
+export declare class MediaImportCommand extends SanityCommand<typeof MediaImportCommand> {
+    static args: {
+        source: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: {
+        command: string;
+        description: string;
+    }[];
+    static flags: {
+        'media-library-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'replace-aspects': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private importAssets;
+    private reportResult;
+}

package/dist/commands/media/import.js

@@ -0,0 +1,160 @@
+import { Args, Flags } from '@oclif/core';
+import { SanityCommand } from '@sanity/cli-core';
+import { chalk, spinner } from '@sanity/cli-core/ux';
+import boxen from 'boxen';
+import { pipe, scan, tap } from 'rxjs';
+import { importer } from '../../actions/media/importMedia.js';
+import { importMediaDebug } from '../../actions/media/importMediaDebug.js';
+import { promptForMediaLibrary } from '../../prompts/promptForMediaLibrary.js';
+import { getMediaLibraries } from '../../services/mediaLibraries.js';
+import { NO_PROJECT_ID } from '../../util/errorMessages.js';
+export class MediaImportCommand extends SanityCommand {
+    static args = {
+        source: Args.string({
+            description: 'Image file or folder to import from',
+            required: true
+        })
+    };
+    static description = 'Import a set of assets to the target media library.';
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %> products',
+            description: 'Import all assets from the "products" directory'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> gallery.tar.gz',
+            description: 'Import all assets from "gallery" archive'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> products --replace-aspects',
+            description: 'Import all assets from the "products" directory and replace aspects'
+        }
+    ];
+    static flags = {
+        'media-library-id': Flags.string({
+            description: 'The id of the target media library'
+        }),
+        'replace-aspects': Flags.boolean({
+            description: 'Replace existing aspect data. All versions will be replaced (e.g. published and draft aspect data)'
+        })
+    };
+    async run() {
+        const { args, flags } = await this.parse(MediaImportCommand);
+        const { source } = args;
+        const replaceAspects = flags['replace-aspects'];
+        const projectId = await this.getProjectId();
+        const cliConfig = await this.getCliConfig();
+        const dataset = cliConfig.api?.dataset;
+        if (!projectId) {
+            this.error(NO_PROJECT_ID, {
+                exit: 1
+            });
+        }
+        let mediaLibraries;
+        try {
+            mediaLibraries = await getMediaLibraries(projectId);
+        } catch (error) {
+            importMediaDebug('Error listing media libraries', error);
+            this.error(`Failed to list media libraries:\n${error instanceof Error ? error.message : error}`, {
+                exit: 1
+            });
+        }
+        if (mediaLibraries.length === 0) {
+            this.error('No active media libraries found in this project', {
+                exit: 1
+            });
+        }
+        let mediaLibraryId = flags['media-library-id'];
+        if (!mediaLibraryId) {
+            try {
+                mediaLibraryId = await promptForMediaLibrary({
+                    mediaLibraries
+                });
+            } catch (error) {
+                importMediaDebug('Error selecting media library', error);
+                this.error(`Failed to select media library:\n${error instanceof Error ? error.message : error}`, {
+                    exit: 1
+                });
+            }
+        }
+        if (!mediaLibraries.some((library)=>library.id === mediaLibraryId)) {
+            this.error(`Media library with id "${mediaLibraryId}" not found`, {
+                exit: 1
+            });
+        }
+        const projectClient = await this.getProjectApiClient({
+            apiVersion: 'v2025-02-19',
+            dataset,
+            perspective: 'drafts',
+            projectId,
+            requestTagPrefix: 'sanity.mediaLibraryCli.import',
+            requireUser: true,
+            '~experimental_resource': {
+                id: mediaLibraryId,
+                type: 'media-library'
+            }
+        });
+        this.log(boxen(`
+          Importing to media library: ${mediaLibraryId.padEnd(37)}
+          Importing from path: ${source}
+        `, {
+            borderColor: 'yellow',
+            borderStyle: 'round'
+        }));
+        const spin = spinner('Beginning import…').start();
+        await this.importAssets({
+            projectClient,
+            replaceAspects,
+            source,
+            spin
+        });
+    }
+    async importAssets(options) {
+        const { projectClient, replaceAspects, source, spin } = options;
+        return new Promise((resolve, reject)=>{
+            const subscription = importer({
+                client: projectClient,
+                replaceAspects,
+                sourcePath: source,
+                spinner: spin
+            }).pipe(this.reportResult(spin)).subscribe({
+                complete: ()=>{
+                    resolve();
+                },
+                error: (error)=>{
+                    const message = error instanceof Error ? error.message : String(error);
+                    spin.stop();
+                    reject(new Error(message));
+                }
+            });
+            // Cleanup on Ctrl+C
+            process.once('SIGINT', ()=>{
+                subscription.unsubscribe();
+                spin.fail('Import interrupted.');
+                process.exit(130);
+            });
+        }).catch((error)=>{
+            this.error(chalk.red(error.message), {
+                exit: 1
+            });
+        });
+    }
+    reportResult(spin) {
+        let previousState;
+        return pipe(scan((processedAssetsCount, state)=>[
+                processedAssetsCount[0] + 1,
+                state
+            ], [
+            0,
+            undefined
+        ]), tap({
+            complete: ()=>spin.succeed(`Imported ${previousState?.fileCount} assets`),
+            next: ([processedAssetsCount, state])=>{
+                previousState = state;
+                spin.text = `${processedAssetsCount} of ${state?.fileCount} assets imported ${chalk.dim(state?.asset.originalFilename)}`;
+            }
+        }));
+    }
+}
+
+//# sourceMappingURL=import.js.map

package/dist/commands/media/import.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/commands/media/import.ts"],"sourcesContent":["import {Args, Flags} from '@oclif/core'\nimport {SanityCommand} from '@sanity/cli-core'\nimport {chalk, spinner} from '@sanity/cli-core/ux'\nimport {SanityClient} from '@sanity/client'\nimport boxen from 'boxen'\nimport {type OperatorFunction, pipe, scan, tap} from 'rxjs'\n\nimport {importer, type State} from '../../actions/media/importMedia.js'\nimport {importMediaDebug} from '../../actions/media/importMediaDebug.js'\nimport {promptForMediaLibrary} from '../../prompts/promptForMediaLibrary.js'\nimport {getMediaLibraries} from '../../services/mediaLibraries.js'\nimport {NO_PROJECT_ID} from '../../util/errorMessages.js'\n\nexport class MediaImportCommand extends SanityCommand<typeof MediaImportCommand> {\n  static override args = {\n    source: Args.string({\n      description: 'Image file or folder to import from',\n      required: true,\n    }),\n  }\n\n  static override description = 'Import a set of assets to the target media library.'\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %> products',\n      description: 'Import all assets from the \"products\" directory',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> gallery.tar.gz',\n      description: 'Import all assets from \"gallery\" archive',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> products --replace-aspects',\n      description: 'Import all assets from the \"products\" directory and replace aspects',\n    },\n  ]\n\n  static override flags = {\n    'media-library-id': Flags.string({\n      description: 'The id of the target media library',\n    }),\n    'replace-aspects': Flags.boolean({\n      description:\n        'Replace existing aspect data. All versions will be replaced (e.g. published and draft aspect data)',\n    }),\n  }\n\n  public async run(): Promise<void> {\n    const {args, flags} = await this.parse(MediaImportCommand)\n    const {source} = args\n    const replaceAspects = flags['replace-aspects']\n\n    const projectId = await this.getProjectId()\n    const cliConfig = await this.getCliConfig()\n    const dataset = cliConfig.api?.dataset\n\n    if (!projectId) {\n      this.error(NO_PROJECT_ID, {\n        exit: 1,\n      })\n    }\n\n    let mediaLibraries\n    try {\n      mediaLibraries = await getMediaLibraries(projectId)\n    } catch (error) {\n      importMediaDebug('Error listing media libraries', error)\n      this.error(\n        `Failed to list media libraries:\\n${error instanceof Error ? error.message : error}`,\n        {\n          exit: 1,\n        },\n      )\n    }\n\n    if (mediaLibraries.length === 0) {\n      this.error('No active media libraries found in this project', {exit: 1})\n    }\n\n    let mediaLibraryId = flags['media-library-id']\n    if (!mediaLibraryId) {\n      try {\n        mediaLibraryId = await promptForMediaLibrary({mediaLibraries})\n      } catch (error) {\n        importMediaDebug('Error selecting media library', error)\n        this.error(\n          `Failed to select media library:\\n${error instanceof Error ? error.message : error}`,\n          {\n            exit: 1,\n          },\n        )\n      }\n    }\n\n    if (!mediaLibraries.some((library) => library.id === mediaLibraryId)) {\n      this.error(`Media library with id \"${mediaLibraryId}\" not found`, {exit: 1})\n    }\n\n    const projectClient = await this.getProjectApiClient({\n      apiVersion: 'v2025-02-19',\n      dataset,\n      perspective: 'drafts',\n      projectId,\n      requestTagPrefix: 'sanity.mediaLibraryCli.import',\n      requireUser: true,\n      '~experimental_resource': {\n        id: mediaLibraryId,\n        type: 'media-library',\n      },\n    })\n\n    this.log(\n      boxen(\n        `\n          Importing to media library: ${mediaLibraryId.padEnd(37)}\n          Importing from path: ${source}\n        `,\n        {\n          borderColor: 'yellow',\n          borderStyle: 'round',\n        },\n      ),\n    )\n\n    const spin = spinner('Beginning import…').start()\n\n    await this.importAssets({projectClient, replaceAspects, source, spin})\n  }\n\n  private async importAssets(options: {\n    projectClient: SanityClient\n    replaceAspects: boolean\n    source: string\n    spin: ReturnType<typeof spinner>\n  }): Promise<void> {\n    const {projectClient, replaceAspects, source, spin} = options\n\n    return new Promise<void>((resolve, reject) => {\n      const subscription = importer({\n        client: projectClient,\n        replaceAspects,\n        sourcePath: source,\n        spinner: spin,\n      })\n        .pipe(this.reportResult(spin))\n        .subscribe({\n          complete: () => {\n            resolve()\n          },\n          error: (error: unknown) => {\n            const message = error instanceof Error ? error.message : String(error)\n            spin.stop()\n            reject(new Error(message))\n          },\n        })\n\n      // Cleanup on Ctrl+C\n      process.once('SIGINT', () => {\n        subscription.unsubscribe()\n        spin.fail('Import interrupted.')\n        process.exit(130)\n      })\n    }).catch((error) => {\n      this.error(chalk.red(error.message), {exit: 1})\n    })\n  }\n\n  private reportResult(\n    spin: ReturnType<typeof spinner>,\n  ): OperatorFunction<State, [number, State | undefined]> {\n    let previousState: State | undefined\n\n    return pipe(\n      scan<State, [number, State | undefined]>(\n        (processedAssetsCount, state) => [processedAssetsCount[0] + 1, state],\n        [0, undefined],\n      ),\n      tap({\n        complete: () => spin.succeed(`Imported ${previousState?.fileCount} assets`),\n        next: ([processedAssetsCount, state]) => {\n          previousState = state\n          spin.text = `${processedAssetsCount} of ${state?.fileCount} assets imported ${chalk.dim(state?.asset.originalFilename)}`\n        },\n      }),\n    )\n  }\n}\n"],"names":["Args","Flags","SanityCommand","chalk","spinner","boxen","pipe","scan","tap","importer","importMediaDebug","promptForMediaLibrary","getMediaLibraries","NO_PROJECT_ID","MediaImportCommand","args","source","string","description","required","examples","command","flags","boolean","run","parse","replaceAspects","projectId","getProjectId","cliConfig","getCliConfig","dataset","api","error","exit","mediaLibraries","Error","message","length","mediaLibraryId","some","library","id","projectClient","getProjectApiClient","apiVersion","perspective","requestTagPrefix","requireUser","type","log","padEnd","borderColor","borderStyle","spin","start","importAssets","options","Promise","resolve","reject","subscription","client","sourcePath","reportResult","subscribe","complete","String","stop","process","once","unsubscribe","fail","catch","red","previousState","processedAssetsCount","state","undefined","succeed","fileCount","next","text","dim","asset","originalFilename"],"mappings":"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"}