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

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

@@ -0,0 +1,88 @@
+import fs, { mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { styleText } from 'node:util';
+import { fileExists, SanityCommand, subdebug } from '@sanity/cli-core';
+import { input } from '@sanity/cli-core/ux';
+import { createPublishedId } from '@sanity/id-utils';
+import { camelCase } from 'lodash-es';
+import { getMediaLibraryConfig } from '../../actions/media/getMediaLibraryConfig.js';
+import { NO_MEDIA_LIBRARY_ASPECTS_PATH } from '../../util/errorMessages.js';
+const createAspectDebug = subdebug('media:create-aspect');
+export class MediaCreateAspectCommand extends SanityCommand {
+    static description = 'Create a new aspect definition file';
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %>',
+            description: 'Create a new aspect definition file'
+        }
+    ];
+    async run() {
+        const cliConfig = await this.getCliConfig();
+        const mediaLibrary = getMediaLibraryConfig(cliConfig);
+        if (mediaLibrary?.aspectsPath === undefined) {
+            this.error(NO_MEDIA_LIBRARY_ASPECTS_PATH, {
+                exit: 1
+            });
+        }
+        try {
+            const title = await input({
+                message: 'Title'
+            });
+            const name = await input({
+                default: createPublishedId(camelCase(title)),
+                message: 'Name'
+            });
+            const safeName = createPublishedId(camelCase(name));
+            const destinationPath = path.resolve(mediaLibrary.aspectsPath, `${safeName}.ts`);
+            const relativeDestinationPath = path.relative(process.cwd(), destinationPath);
+            await mkdir(path.resolve(mediaLibrary.aspectsPath), {
+                recursive: true
+            });
+            const destinationPathExists = await fileExists(destinationPath);
+            if (destinationPathExists) {
+                this.error(`A file already exists at ${styleText('bold', relativeDestinationPath)}`, {
+                    exit: 1
+                });
+            }
+            await fs.writeFile(destinationPath, template({
+                name: safeName,
+                title
+            }));
+            this.log(`${styleText('green', '✓')} Aspect created! ${styleText('bold', relativeDestinationPath)}`);
+            this.log();
+            this.log('Next steps:');
+            this.log(`Open ${styleText('bold', relativeDestinationPath)} in your code editor and customize the aspect.`);
+            this.log();
+            this.log('Deploy this aspect by running:');
+            this.log(styleText('bold', `sanity media deploy-aspect ${safeName}`));
+            this.log();
+            this.log('Deploy all aspects by running:');
+            this.log(styleText('bold', `sanity media deploy-aspect --all`));
+        } catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            createAspectDebug('Failed to create aspect', error);
+            this.error(`Failed to create aspect: ${message}`, {
+                exit: 1
+            });
+        }
+    }
+}
+function template({ name, title }) {
+    return `import {defineAssetAspect, defineField} from 'sanity'
+
+export default defineAssetAspect({
+  name: '${name}',
+  title: '${title}',
+  type: 'object',
+  fields: [
+    defineField({
+      name: 'string',
+      title: 'Plain String',
+      type: 'string',
+    }),
+  ],
+})
+`;
+}
+
+//# sourceMappingURL=create-aspect.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/commands/media/create-aspect.ts"],"sourcesContent":["import fs, {mkdir} from 'node:fs/promises'\nimport path from 'node:path'\nimport {styleText} from 'node:util'\n\nimport {fileExists, SanityCommand, subdebug} from '@sanity/cli-core'\nimport {input} from '@sanity/cli-core/ux'\nimport {createPublishedId} from '@sanity/id-utils'\nimport {camelCase} from 'lodash-es'\n\nimport {getMediaLibraryConfig} from '../../actions/media/getMediaLibraryConfig.js'\nimport {NO_MEDIA_LIBRARY_ASPECTS_PATH} from '../../util/errorMessages.js'\n\nconst createAspectDebug = subdebug('media:create-aspect')\n\nexport class MediaCreateAspectCommand extends SanityCommand<typeof MediaCreateAspectCommand> {\n  static override description = 'Create a new aspect definition file'\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %>',\n      description: 'Create a new aspect definition file',\n    },\n  ]\n\n  public async run(): Promise<void> {\n    const cliConfig = await this.getCliConfig()\n    const mediaLibrary = getMediaLibraryConfig(cliConfig)\n    if (mediaLibrary?.aspectsPath === undefined) {\n      this.error(NO_MEDIA_LIBRARY_ASPECTS_PATH, {exit: 1})\n    }\n\n    try {\n      const title = await input({\n        message: 'Title',\n      })\n\n      const name = await input({\n        default: createPublishedId(camelCase(title)),\n        message: 'Name',\n      })\n\n      const safeName = createPublishedId(camelCase(name))\n      const destinationPath = path.resolve(mediaLibrary.aspectsPath, `${safeName}.ts`)\n      const relativeDestinationPath = path.relative(process.cwd(), destinationPath)\n\n      await mkdir(path.resolve(mediaLibrary.aspectsPath), {\n        recursive: true,\n      })\n\n      const destinationPathExists = await fileExists(destinationPath)\n      if (destinationPathExists) {\n        this.error(`A file already exists at ${styleText('bold', relativeDestinationPath)}`, {\n          exit: 1,\n        })\n      }\n\n      await fs.writeFile(\n        destinationPath,\n        template({\n          name: safeName,\n          title,\n        }),\n      )\n\n      this.log(\n        `${styleText('green', '✓')} Aspect created! ${styleText('bold', relativeDestinationPath)}`,\n      )\n      this.log()\n      this.log('Next steps:')\n      this.log(\n        `Open ${styleText('bold', relativeDestinationPath)} in your code editor and customize the aspect.`,\n      )\n      this.log()\n      this.log('Deploy this aspect by running:')\n      this.log(styleText('bold', `sanity media deploy-aspect ${safeName}`))\n      this.log()\n      this.log('Deploy all aspects by running:')\n      this.log(styleText('bold', `sanity media deploy-aspect --all`))\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error)\n      createAspectDebug('Failed to create aspect', error)\n      this.error(`Failed to create aspect: ${message}`, {exit: 1})\n    }\n  }\n}\n\nfunction template({name, title}: {name: string; title: string}) {\n  return `import {defineAssetAspect, defineField} from 'sanity'\n\nexport default defineAssetAspect({\n  name: '${name}',\n  title: '${title}',\n  type: 'object',\n  fields: [\n    defineField({\n      name: 'string',\n      title: 'Plain String',\n      type: 'string',\n    }),\n  ],\n})\n`\n}\n"],"names":["fs","mkdir","path","styleText","fileExists","SanityCommand","subdebug","input","createPublishedId","camelCase","getMediaLibraryConfig","NO_MEDIA_LIBRARY_ASPECTS_PATH","createAspectDebug","MediaCreateAspectCommand","description","examples","command","run","cliConfig","getCliConfig","mediaLibrary","aspectsPath","undefined","error","exit","title","message","name","default","safeName","destinationPath","resolve","relativeDestinationPath","relative","process","cwd","recursive","destinationPathExists","writeFile","template","log","Error","String"],"mappings":"AAAA,OAAOA,MAAKC,KAAK,QAAO,mBAAkB;AAC1C,OAAOC,UAAU,YAAW;AAC5B,SAAQC,SAAS,QAAO,YAAW;AAEnC,SAAQC,UAAU,EAAEC,aAAa,EAAEC,QAAQ,QAAO,mBAAkB;AACpE,SAAQC,KAAK,QAAO,sBAAqB;AACzC,SAAQC,iBAAiB,QAAO,mBAAkB;AAClD,SAAQC,SAAS,QAAO,YAAW;AAEnC,SAAQC,qBAAqB,QAAO,+CAA8C;AAClF,SAAQC,6BAA6B,QAAO,8BAA6B;AAEzE,MAAMC,oBAAoBN,SAAS;AAEnC,OAAO,MAAMO,iCAAiCR;IAC5C,OAAgBS,cAAc,sCAAqC;IAEnE,OAAgBC,WAAW;QACzB;YACEC,SAAS;YACTF,aAAa;QACf;KACD,CAAA;IAED,MAAaG,MAAqB;QAChC,MAAMC,YAAY,MAAM,IAAI,CAACC,YAAY;QACzC,MAAMC,eAAeV,sBAAsBQ;QAC3C,IAAIE,cAAcC,gBAAgBC,WAAW;YAC3C,IAAI,CAACC,KAAK,CAACZ,+BAA+B;gBAACa,MAAM;YAAC;QACpD;QAEA,IAAI;YACF,MAAMC,QAAQ,MAAMlB,MAAM;gBACxBmB,SAAS;YACX;YAEA,MAAMC,OAAO,MAAMpB,MAAM;gBACvBqB,SAASpB,kBAAkBC,UAAUgB;gBACrCC,SAAS;YACX;YAEA,MAAMG,WAAWrB,kBAAkBC,UAAUkB;YAC7C,MAAMG,kBAAkB5B,KAAK6B,OAAO,CAACX,aAAaC,WAAW,EAAE,GAAGQ,SAAS,GAAG,CAAC;YAC/E,MAAMG,0BAA0B9B,KAAK+B,QAAQ,CAACC,QAAQC,GAAG,IAAIL;YAE7D,MAAM7B,MAAMC,KAAK6B,OAAO,CAACX,aAAaC,WAAW,GAAG;gBAClDe,WAAW;YACb;YAEA,MAAMC,wBAAwB,MAAMjC,WAAW0B;YAC/C,IAAIO,uBAAuB;gBACzB,IAAI,CAACd,KAAK,CAAC,CAAC,yBAAyB,EAAEpB,UAAU,QAAQ6B,0BAA0B,EAAE;oBACnFR,MAAM;gBACR;YACF;YAEA,MAAMxB,GAAGsC,SAAS,CAChBR,iBACAS,SAAS;gBACPZ,MAAME;gBACNJ;YACF;YAGF,IAAI,CAACe,GAAG,CACN,GAAGrC,UAAU,SAAS,KAAK,iBAAiB,EAAEA,UAAU,QAAQ6B,0BAA0B;YAE5F,IAAI,CAACQ,GAAG;YACR,IAAI,CAACA,GAAG,CAAC;YACT,IAAI,CAACA,GAAG,CACN,CAAC,KAAK,EAAErC,UAAU,QAAQ6B,yBAAyB,8CAA8C,CAAC;YAEpG,IAAI,CAACQ,GAAG;YACR,IAAI,CAACA,GAAG,CAAC;YACT,IAAI,CAACA,GAAG,CAACrC,UAAU,QAAQ,CAAC,2BAA2B,EAAE0B,UAAU;YACnE,IAAI,CAACW,GAAG;YACR,IAAI,CAACA,GAAG,CAAC;YACT,IAAI,CAACA,GAAG,CAACrC,UAAU,QAAQ,CAAC,gCAAgC,CAAC;QAC/D,EAAE,OAAOoB,OAAO;YACd,MAAMG,UAAUH,iBAAiBkB,QAAQlB,MAAMG,OAAO,GAAGgB,OAAOnB;YAChEX,kBAAkB,2BAA2BW;YAC7C,IAAI,CAACA,KAAK,CAAC,CAAC,yBAAyB,EAAEG,SAAS,EAAE;gBAACF,MAAM;YAAC;QAC5D;IACF;AACF;AAEA,SAASe,SAAS,EAACZ,IAAI,EAAEF,KAAK,EAAgC;IAC5D,OAAO,CAAC;;;SAGD,EAAEE,KAAK;UACN,EAAEF,MAAM;;;;;;;;;;AAUlB,CAAC;AACD"}

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

@@ -0,0 +1,85 @@
+import { styleText } from 'node:util';
+import { Args, Flags } from '@oclif/core';
+import { SanityCommand, subdebug } from '@sanity/cli-core';
+import { confirm } from '@sanity/cli-core/ux';
+import { selectMediaLibrary } from '../../prompts/selectMediaLibrary.js';
+import { deleteAspect } from '../../services/mediaLibraries.js';
+import { NO_PROJECT_ID } from '../../util/errorMessages.js';
+const deleteAspectDebug = subdebug('media:delete-aspect');
+export class MediaDeleteAspectCommand extends SanityCommand {
+    static args = {
+        aspectName: Args.string({
+            description: 'Name of the aspect to delete',
+            required: true
+        })
+    };
+    static description = 'Undeploy an aspect';
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %> someAspect',
+            description: 'Delete the aspect named "someAspect"'
+        }
+    ];
+    static flags = {
+        'media-library-id': Flags.string({
+            description: 'The id of the target media library',
+            required: false
+        }),
+        yes: Flags.boolean({
+            aliases: [
+                'y'
+            ],
+            description: 'Skip confirmation prompt',
+            required: false
+        })
+    };
+    async run() {
+        const { aspectName } = this.args;
+        const { 'media-library-id': mediaLibraryIdFlag, yes: skipConfirmation } = this.flags;
+        const projectId = await this.getProjectId();
+        if (!projectId) {
+            this.error(NO_PROJECT_ID, {
+                exit: 1
+            });
+        }
+        try {
+            let mediaLibraryId = mediaLibraryIdFlag;
+            if (!mediaLibraryId) {
+                mediaLibraryId = await selectMediaLibrary(projectId);
+            }
+            if (!skipConfirmation) {
+                const confirmed = await confirm({
+                    default: false,
+                    message: `Are you absolutely sure you want to undeploy the ${aspectName} aspect from the "${mediaLibraryId}" media library?`
+                });
+                if (!confirmed) {
+                    this.log('Operation cancelled');
+                    return;
+                }
+            }
+            const response = await deleteAspect({
+                aspectName,
+                mediaLibraryId,
+                projectId
+            });
+            if (response.results.length === 0) {
+                this.warn(styleText('bold', `There's no deployed aspect with that name`));
+                this.log(`  - ${aspectName}`);
+                return;
+            }
+            this.log();
+            this.log(`${styleText('green', '✓')} ${styleText('bold', 'Deleted aspect')}`);
+            this.log(`  - ${aspectName}`);
+        // TODO: Find existing aspect definition files matching the undeployed aspect name and offer
+        // to delete them.
+        } catch (error) {
+            const err = error;
+            deleteAspectDebug('Failed to delete aspect', err);
+            this.error(styleText('bold', 'Failed to delete aspect') + `\n  - ${aspectName}\n\n${styleText('red', err.message)}`, {
+                exit: 1
+            });
+        }
+    }
+}
+
+//# sourceMappingURL=delete-aspect.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/commands/media/delete-aspect.ts"],"sourcesContent":["import {styleText} from 'node:util'\n\nimport {Args, Flags} from '@oclif/core'\nimport {SanityCommand, subdebug} from '@sanity/cli-core'\nimport {confirm} from '@sanity/cli-core/ux'\n\nimport {selectMediaLibrary} from '../../prompts/selectMediaLibrary.js'\nimport {deleteAspect} from '../../services/mediaLibraries.js'\nimport {NO_PROJECT_ID} from '../../util/errorMessages.js'\n\nconst deleteAspectDebug = subdebug('media:delete-aspect')\n\nexport class MediaDeleteAspectCommand extends SanityCommand<typeof MediaDeleteAspectCommand> {\n  static override args = {\n    aspectName: Args.string({\n      description: 'Name of the aspect to delete',\n      required: true,\n    }),\n  }\n\n  static override description = 'Undeploy an aspect'\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %> someAspect',\n      description: 'Delete the aspect named \"someAspect\"',\n    },\n  ]\n\n  static override flags = {\n    'media-library-id': Flags.string({\n      description: 'The id of the target media library',\n      required: false,\n    }),\n    yes: Flags.boolean({\n      aliases: ['y'],\n      description: 'Skip confirmation prompt',\n      required: false,\n    }),\n  }\n\n  public async run(): Promise<void> {\n    const {aspectName} = this.args\n    const {'media-library-id': mediaLibraryIdFlag, yes: skipConfirmation} = this.flags\n\n    const projectId = await this.getProjectId()\n    if (!projectId) {\n      this.error(NO_PROJECT_ID, {exit: 1})\n    }\n\n    try {\n      let mediaLibraryId = mediaLibraryIdFlag\n      if (!mediaLibraryId) {\n        mediaLibraryId = await selectMediaLibrary(projectId)\n      }\n\n      if (!skipConfirmation) {\n        const confirmed = await confirm({\n          default: false,\n          message: `Are you absolutely sure you want to undeploy the ${aspectName} aspect from the \"${mediaLibraryId}\" media library?`,\n        })\n\n        if (!confirmed) {\n          this.log('Operation cancelled')\n          return\n        }\n      }\n\n      const response = await deleteAspect({\n        aspectName,\n        mediaLibraryId,\n        projectId,\n      })\n\n      if (response.results.length === 0) {\n        this.warn(styleText('bold', `There's no deployed aspect with that name`))\n        this.log(`  - ${aspectName}`)\n        return\n      }\n\n      this.log()\n      this.log(`${styleText('green', '✓')} ${styleText('bold', 'Deleted aspect')}`)\n      this.log(`  - ${aspectName}`)\n\n      // TODO: Find existing aspect definition files matching the undeployed aspect name and offer\n      // to delete them.\n    } catch (error) {\n      const err = error as Error\n      deleteAspectDebug('Failed to delete aspect', err)\n      this.error(\n        styleText('bold', 'Failed to delete aspect') +\n          `\\n  - ${aspectName}\\n\\n${styleText('red', err.message)}`,\n        {\n          exit: 1,\n        },\n      )\n    }\n  }\n}\n"],"names":["styleText","Args","Flags","SanityCommand","subdebug","confirm","selectMediaLibrary","deleteAspect","NO_PROJECT_ID","deleteAspectDebug","MediaDeleteAspectCommand","args","aspectName","string","description","required","examples","command","flags","yes","boolean","aliases","run","mediaLibraryIdFlag","skipConfirmation","projectId","getProjectId","error","exit","mediaLibraryId","confirmed","default","message","log","response","results","length","warn","err"],"mappings":"AAAA,SAAQA,SAAS,QAAO,YAAW;AAEnC,SAAQC,IAAI,EAAEC,KAAK,QAAO,cAAa;AACvC,SAAQC,aAAa,EAAEC,QAAQ,QAAO,mBAAkB;AACxD,SAAQC,OAAO,QAAO,sBAAqB;AAE3C,SAAQC,kBAAkB,QAAO,sCAAqC;AACtE,SAAQC,YAAY,QAAO,mCAAkC;AAC7D,SAAQC,aAAa,QAAO,8BAA6B;AAEzD,MAAMC,oBAAoBL,SAAS;AAEnC,OAAO,MAAMM,iCAAiCP;IAC5C,OAAgBQ,OAAO;QACrBC,YAAYX,KAAKY,MAAM,CAAC;YACtBC,aAAa;YACbC,UAAU;QACZ;IACF,EAAC;IAED,OAAgBD,cAAc,qBAAoB;IAElD,OAAgBE,WAAW;QACzB;YACEC,SAAS;YACTH,aAAa;QACf;KACD,CAAA;IAED,OAAgBI,QAAQ;QACtB,oBAAoBhB,MAAMW,MAAM,CAAC;YAC/BC,aAAa;YACbC,UAAU;QACZ;QACAI,KAAKjB,MAAMkB,OAAO,CAAC;YACjBC,SAAS;gBAAC;aAAI;YACdP,aAAa;YACbC,UAAU;QACZ;IACF,EAAC;IAED,MAAaO,MAAqB;QAChC,MAAM,EAACV,UAAU,EAAC,GAAG,IAAI,CAACD,IAAI;QAC9B,MAAM,EAAC,oBAAoBY,kBAAkB,EAAEJ,KAAKK,gBAAgB,EAAC,GAAG,IAAI,CAACN,KAAK;QAElF,MAAMO,YAAY,MAAM,IAAI,CAACC,YAAY;QACzC,IAAI,CAACD,WAAW;YACd,IAAI,CAACE,KAAK,CAACnB,eAAe;gBAACoB,MAAM;YAAC;QACpC;QAEA,IAAI;YACF,IAAIC,iBAAiBN;YACrB,IAAI,CAACM,gBAAgB;gBACnBA,iBAAiB,MAAMvB,mBAAmBmB;YAC5C;YAEA,IAAI,CAACD,kBAAkB;gBACrB,MAAMM,YAAY,MAAMzB,QAAQ;oBAC9B0B,SAAS;oBACTC,SAAS,CAAC,iDAAiD,EAAEpB,WAAW,kBAAkB,EAAEiB,eAAe,gBAAgB,CAAC;gBAC9H;gBAEA,IAAI,CAACC,WAAW;oBACd,IAAI,CAACG,GAAG,CAAC;oBACT;gBACF;YACF;YAEA,MAAMC,WAAW,MAAM3B,aAAa;gBAClCK;gBACAiB;gBACAJ;YACF;YAEA,IAAIS,SAASC,OAAO,CAACC,MAAM,KAAK,GAAG;gBACjC,IAAI,CAACC,IAAI,CAACrC,UAAU,QAAQ,CAAC,yCAAyC,CAAC;gBACvE,IAAI,CAACiC,GAAG,CAAC,CAAC,IAAI,EAAErB,YAAY;gBAC5B;YACF;YAEA,IAAI,CAACqB,GAAG;YACR,IAAI,CAACA,GAAG,CAAC,GAAGjC,UAAU,SAAS,KAAK,CAAC,EAAEA,UAAU,QAAQ,mBAAmB;YAC5E,IAAI,CAACiC,GAAG,CAAC,CAAC,IAAI,EAAErB,YAAY;QAE5B,4FAA4F;QAC5F,kBAAkB;QACpB,EAAE,OAAOe,OAAO;YACd,MAAMW,MAAMX;YACZlB,kBAAkB,2BAA2B6B;YAC7C,IAAI,CAACX,KAAK,CACR3B,UAAU,QAAQ,6BAChB,CAAC,MAAM,EAAEY,WAAW,IAAI,EAAEZ,UAAU,OAAOsC,IAAIN,OAAO,GAAG,EAC3D;gBACEJ,MAAM;YACR;QAEJ;IACF;AACF"}

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

@@ -0,0 +1,151 @@
+import { styleText } from 'node:util';
+import { Args, Flags } from '@oclif/core';
+import { SanityCommand, subdebug } from '@sanity/cli-core';
+import { 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(styleText('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: ${styleText('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(`${styleText('green', '✓')} ${styleText('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(styleText('bold', 'Failed to deploy aspects') + `\n\n${styleText('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 ? ` ${styleText('bgRed', simplifiedErrors[0])}` : '';
+            const remainingErrorsCount = simplifiedErrors.length - 1;
+            const remainingErrorsLabel = remainingErrorsCount > 0 ? styleText('italic', ` and ${remainingErrorsCount} other ${pluralize('error', remainingErrorsCount)}`) : '';
+            return `  - ${label} ${styleText('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 {styleText} from 'node:util'\n\nimport {Args, Flags} from '@oclif/core'\nimport {SanityCommand, subdebug} from '@sanity/cli-core'\nimport {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          styleText(\n            '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: ${styleText('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        `${styleText('green', '✓')} ${styleText('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(\n        styleText('bold', 'Failed to deploy aspects') + `\\n\\n${styleText('red', err.message)}`,\n        {\n          exit: 1,\n        },\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 =\n          simplifiedErrors.length > 0 ? ` ${styleText('bgRed', simplifiedErrors[0])}` : ''\n\n        const remainingErrorsCount = simplifiedErrors.length - 1\n        const remainingErrorsLabel =\n          remainingErrorsCount > 0\n            ? styleText(\n                'italic',\n                ` and ${remainingErrorsCount} other ${pluralize('error', remainingErrorsCount)}`,\n              )\n            : ''\n\n        return `  - ${label} ${styleText('dim', filename)}${errorLabel}${remainingErrorsLabel}`\n      })\n      .join('\\n')\n  }\n}\n"],"names":["styleText","Args","Flags","SanityCommand","subdebug","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","formatAspectList","valid","log","deploySpin","deployResponse","aspects","map","a","succeed","count","results","err","message","filename","validationErrors","label","simplifiedErrors","flatMap","group","errorLabel","remainingErrorsCount","remainingErrorsLabel","join"],"mappings":"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"}

package/dist/commands/media/export.js

@@ -0,0 +1,210 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { Args, Flags } from '@oclif/core';
+import { getProjectCliClient, SanityCommand, subdebug } from '@sanity/cli-core';
+import { boxen, input, spinner } from '@sanity/cli-core/ux';
+import { exportDataset } from '@sanity/export';
+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 getProjectCliClient({
+            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 {getProjectCliClient, SanityCommand, subdebug} from '@sanity/cli-core'\nimport {boxen, input, spinner} from '@sanity/cli-core/ux'\nimport {exportDataset, type ExportOptions, type ExportProgress} from '@sanity/export'\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 getProjectCliClient({\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","getProjectCliClient","SanityCommand","subdebug","boxen","input","spinner","exportDataset","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","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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"}