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

package/dist/commands/migration/create.js

@@ -0,0 +1,143 @@
+import { access, mkdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { Args } from '@oclif/core';
+import { SanityCommand } from '@sanity/cli-core';
+import { chalk, confirm, input, select } from '@sanity/cli-core/ux';
+import { deburr } from 'lodash-es';
+import { getMigrationRootDirectory } from '../../actions/migration/getMigrationRootDirectory.js';
+import { minimalAdvanced, minimalSimple, renameField, renameType, stringToPTE } from '../../actions/migration/templates/index.js';
+import { MIGRATIONS_DIRECTORY } from '../../util/migration/constants.js';
+const TEMPLATES = [
+    {
+        name: 'Minimalistic migration to get you started',
+        template: minimalSimple
+    },
+    {
+        name: 'Rename an object type',
+        template: renameType
+    },
+    {
+        name: 'Rename a field',
+        template: renameField
+    },
+    {
+        name: 'Convert string field to Portable Text',
+        template: stringToPTE
+    },
+    {
+        name: 'Advanced template using async iterators providing more fine grained control',
+        template: minimalAdvanced
+    }
+];
+export class CreateMigrationCommand extends SanityCommand {
+    static args = {
+        title: Args.string({
+            description: 'Title of migration',
+            required: false
+        })
+    };
+    static description = 'Create a new migration within your project';
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %>',
+            description: 'Create a new migration, prompting for title and options'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> "Rename field from location to address"',
+            description: 'Create a new migration with the provided title, prompting for options'
+        }
+    ];
+    async run() {
+        const { args } = await this.parse(CreateMigrationCommand);
+        const workDir = await getMigrationRootDirectory(this.output);
+        const title = await this.promptForTitle(args.title);
+        const types = await this.promptForDocumentTypes();
+        const { template } = await this.promptForTemplate();
+        const renderedTemplate = (template || minimalSimple)({
+            documentTypes: types.split(',').map((t)=>t.trim()).filter(Boolean),
+            migrationName: title
+        });
+        const sluggedName = deburr(title.toLowerCase()).replaceAll(/\s+/g, '-').replaceAll(/[^a-z0-9-]/g, '');
+        const destDir = path.join(workDir, MIGRATIONS_DIRECTORY, sluggedName);
+        const definitionFile = path.join(destDir, 'index.ts');
+        const dirCreated = await this.createMigrationFile(destDir, definitionFile, renderedTemplate);
+        if (dirCreated) {
+            this.log();
+            this.log(`${chalk.green('✓')} Migration created!`);
+            this.log();
+            this.log('Next steps:');
+            this.log(`Open ${chalk.bold(definitionFile)} in your code editor and write the code for your migration.`);
+            this.log(`Dry run the migration with:\n\`${chalk.bold(`sanity migration run ${sluggedName} --project=<projectId> --dataset <dataset> `)}\``);
+            this.log(`Run the migration against a dataset with:\n \`${chalk.bold(`sanity migration run ${sluggedName} --project=<projectId> --dataset <dataset> --no-dry-run`)}\``);
+            this.log();
+            this.log(`👉 Learn more about schema and content migrations at ${chalk.bold('https://www.sanity.io/docs/schema-and-content-migrations')}`);
+        }
+    }
+    async createMigrationFile(destDir, definitionFile, renderedTemplate) {
+        const dirExists = await access(destDir).then(()=>true).catch(()=>false);
+        if (dirExists) {
+            const shouldOverwrite = await this.promptForOverwrite(destDir);
+            if (!shouldOverwrite) return false;
+        }
+        try {
+            await mkdir(destDir, {
+                recursive: true
+            });
+        } catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.error(`Failed to create migration directory: ${message}`, {
+                exit: 1
+            });
+        }
+        try {
+            await writeFile(definitionFile, renderedTemplate);
+        } catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.error(`Failed to create migration file: ${message}`, {
+                exit: 1
+            });
+        }
+        return true;
+    }
+    async promptForDocumentTypes() {
+        return input({
+            message: 'Type of documents to migrate. You can add multiple types separated by comma (optional)'
+        });
+    }
+    async promptForOverwrite(destDir) {
+        return confirm({
+            default: false,
+            message: `Migration directory ${chalk.cyan(destDir)} already exists. Overwrite?`
+        });
+    }
+    async promptForTemplate() {
+        const templatesByName = Object.fromEntries(TEMPLATES.map((t)=>[
+                t.name,
+                t
+            ]));
+        const templateName = await select({
+            choices: TEMPLATES.map((definedTemplate)=>({
+                    name: definedTemplate.name,
+                    value: definedTemplate.name
+                })),
+            message: 'Select a template'
+        });
+        return templatesByName[templateName];
+    }
+    async promptForTitle(providedTitle) {
+        if (providedTitle?.trim()) {
+            return providedTitle;
+        }
+        return input({
+            message: 'Title of migration (e.g. "Rename field from location to address")',
+            validate: (value)=>{
+                if (!value.trim()) {
+                    return 'Title cannot be empty';
+                }
+                return true;
+            }
+        });
+    }
+}
+
+//# sourceMappingURL=create.js.map

package/dist/commands/migration/create.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/commands/migration/create.ts"],"sourcesContent":["import {access, mkdir, writeFile} from 'node:fs/promises'\nimport path from 'node:path'\n\nimport {Args} from '@oclif/core'\nimport {SanityCommand} from '@sanity/cli-core'\nimport {chalk, confirm, input, select} from '@sanity/cli-core/ux'\nimport {deburr} from 'lodash-es'\n\nimport {getMigrationRootDirectory} from '../../actions/migration/getMigrationRootDirectory.js'\nimport {\n  minimalAdvanced,\n  minimalSimple,\n  renameField,\n  renameType,\n  stringToPTE,\n} from '../../actions/migration/templates/index.js'\nimport {MIGRATIONS_DIRECTORY} from '../../util/migration/constants.js'\n\nconst TEMPLATES = [\n  {name: 'Minimalistic migration to get you started', template: minimalSimple},\n  {name: 'Rename an object type', template: renameType},\n  {name: 'Rename a field', template: renameField},\n  {name: 'Convert string field to Portable Text', template: stringToPTE},\n  {\n    name: 'Advanced template using async iterators providing more fine grained control',\n    template: minimalAdvanced,\n  },\n]\n\nexport class CreateMigrationCommand extends SanityCommand<typeof CreateMigrationCommand> {\n  static override args = {\n    title: Args.string({\n      description: 'Title of migration',\n      required: false,\n    }),\n  }\n\n  static override description = 'Create a new migration within your project'\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %>',\n      description: 'Create a new migration, prompting for title and options',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> \"Rename field from location to address\"',\n      description: 'Create a new migration with the provided title, prompting for options',\n    },\n  ]\n\n  public async run(): Promise<void> {\n    const {args} = await this.parse(CreateMigrationCommand)\n    const workDir = await getMigrationRootDirectory(this.output)\n\n    const title = await this.promptForTitle(args.title)\n    const types = await this.promptForDocumentTypes()\n    const {template} = await this.promptForTemplate()\n\n    const renderedTemplate = (template || minimalSimple)({\n      documentTypes: types\n        .split(',')\n        .map((t) => t.trim())\n        .filter(Boolean),\n      migrationName: title,\n    })\n\n    const sluggedName = deburr(title.toLowerCase())\n      .replaceAll(/\\s+/g, '-')\n      .replaceAll(/[^a-z0-9-]/g, '')\n\n    const destDir = path.join(workDir, MIGRATIONS_DIRECTORY, sluggedName)\n    const definitionFile = path.join(destDir, 'index.ts')\n\n    const dirCreated = await this.createMigrationFile(destDir, definitionFile, renderedTemplate)\n\n    if (dirCreated) {\n      this.log()\n      this.log(`${chalk.green('✓')} Migration created!`)\n      this.log()\n      this.log('Next steps:')\n      this.log(\n        `Open ${chalk.bold(\n          definitionFile,\n        )} in your code editor and write the code for your migration.`,\n      )\n      this.log(\n        `Dry run the migration with:\\n\\`${chalk.bold(\n          `sanity migration run ${sluggedName} --project=<projectId> --dataset <dataset> `,\n        )}\\``,\n      )\n      this.log(\n        `Run the migration against a dataset with:\\n \\`${chalk.bold(\n          `sanity migration run ${sluggedName} --project=<projectId> --dataset <dataset> --no-dry-run`,\n        )}\\``,\n      )\n      this.log()\n      this.log(\n        `👉 Learn more about schema and content migrations at ${chalk.bold(\n          'https://www.sanity.io/docs/schema-and-content-migrations',\n        )}`,\n      )\n    }\n  }\n\n  private async createMigrationFile(\n    destDir: string,\n    definitionFile: string,\n    renderedTemplate: string,\n  ): Promise<boolean> {\n    const dirExists = await access(destDir)\n      .then(() => true)\n      .catch(() => false)\n\n    if (dirExists) {\n      const shouldOverwrite = await this.promptForOverwrite(destDir)\n      if (!shouldOverwrite) return false\n    }\n\n    try {\n      await mkdir(destDir, {recursive: true})\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error)\n      this.error(`Failed to create migration directory: ${message}`, {exit: 1})\n    }\n\n    try {\n      await writeFile(definitionFile, renderedTemplate)\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error)\n      this.error(`Failed to create migration file: ${message}`, {exit: 1})\n    }\n\n    return true\n  }\n\n  private async promptForDocumentTypes(): Promise<string> {\n    return input({\n      message:\n        'Type of documents to migrate. You can add multiple types separated by comma (optional)',\n    })\n  }\n\n  private async promptForOverwrite(destDir: string): Promise<boolean> {\n    return confirm({\n      default: false,\n      message: `Migration directory ${chalk.cyan(destDir)} already exists. Overwrite?`,\n    })\n  }\n\n  private async promptForTemplate(): Promise<{\n    name: string\n    template: (params: {documentTypes: string[]; migrationName: string}) => string\n  }> {\n    const templatesByName = Object.fromEntries(TEMPLATES.map((t) => [t.name, t]))\n    const templateName = await select({\n      choices: TEMPLATES.map((definedTemplate) => ({\n        name: definedTemplate.name,\n        value: definedTemplate.name,\n      })),\n      message: 'Select a template',\n    })\n\n    return templatesByName[templateName]\n  }\n\n  private async promptForTitle(providedTitle?: string): Promise<string> {\n    if (providedTitle?.trim()) {\n      return providedTitle\n    }\n\n    return input({\n      message: 'Title of migration (e.g. \"Rename field from location to address\")',\n      validate: (value) => {\n        if (!value.trim()) {\n          return 'Title cannot be empty'\n        }\n\n        return true\n      },\n    })\n  }\n}\n"],"names":["access","mkdir","writeFile","path","Args","SanityCommand","chalk","confirm","input","select","deburr","getMigrationRootDirectory","minimalAdvanced","minimalSimple","renameField","renameType","stringToPTE","MIGRATIONS_DIRECTORY","TEMPLATES","name","template","CreateMigrationCommand","args","title","string","description","required","examples","command","run","parse","workDir","output","promptForTitle","types","promptForDocumentTypes","promptForTemplate","renderedTemplate","documentTypes","split","map","t","trim","filter","Boolean","migrationName","sluggedName","toLowerCase","replaceAll","destDir","join","definitionFile","dirCreated","createMigrationFile","log","green","bold","dirExists","then","catch","shouldOverwrite","promptForOverwrite","recursive","error","message","Error","String","exit","default","cyan","templatesByName","Object","fromEntries","templateName","choices","definedTemplate","value","providedTitle","validate"],"mappings":"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"}

package/dist/commands/migration/list.d.ts

@@ -0,0 +1,9 @@
+import { SanityCommand } from '@sanity/cli-core';
+export declare class ListMigrationCommand extends SanityCommand<typeof ListMigrationCommand> {
+    static description: string;
+    static examples: {
+        command: string;
+        description: string;
+    }[];
+    run(): Promise<void>;
+}

package/dist/commands/migration/list.js

@@ -0,0 +1,61 @@
+import { SanityCommand, subdebug } from '@sanity/cli-core';
+import { chalk } from '@sanity/cli-core/ux';
+import { Table } from 'console-table-printer';
+import { resolveMigrations } from '../../actions/migration/resolveMigrations.js';
+const listMigrationDebug = subdebug('migration:list');
+export class ListMigrationCommand extends SanityCommand {
+    static description = 'List available migrations';
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %>',
+            description: 'List all available migrations in the project'
+        }
+    ];
+    async run() {
+        const { directory: workDir } = await this.getProjectRoot();
+        try {
+            const migrations = await resolveMigrations(workDir);
+            if (migrations.length === 0) {
+                this.log('No migrations found in migrations folder of the project');
+                this.log(`\nRun ${chalk.green('`sanity migration create <NAME>`')} to create a new migration`);
+                return;
+            }
+            const table = new Table({
+                columns: [
+                    {
+                        alignment: 'left',
+                        name: 'id',
+                        title: 'ID'
+                    },
+                    {
+                        alignment: 'left',
+                        name: 'title',
+                        title: 'Title'
+                    }
+                ],
+                title: `Found ${migrations.length} migrations in project`
+            });
+            for (const definedMigration of migrations){
+                table.addRow({
+                    id: definedMigration.id,
+                    title: definedMigration.migration.title
+                });
+            }
+            table.printTable();
+            this.log('\nRun `sanity migration run <ID>` to run a migration');
+            listMigrationDebug(`Successfully listed ${migrations.length} migrations`);
+        } catch (error) {
+            if (error.code === 'ENOENT') {
+                this.log('No migrations folder found in the project');
+                this.log(`\nRun ${chalk.green('`sanity migration create <NAME>`')} to create a new migration`);
+                return;
+            }
+            listMigrationDebug('Failed to list migrations:', error);
+            this.error(`List migrations failed: ${error instanceof Error ? error.message : String(error)}`, {
+                exit: 1
+            });
+        }
+    }
+}
+
+//# sourceMappingURL=list.js.map

package/dist/commands/migration/list.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/commands/migration/list.ts"],"sourcesContent":["import {SanityCommand, subdebug} from '@sanity/cli-core'\nimport {chalk} from '@sanity/cli-core/ux'\nimport {Table} from 'console-table-printer'\n\nimport {resolveMigrations} from '../../actions/migration/resolveMigrations.js'\n\nconst listMigrationDebug = subdebug('migration:list')\n\nexport class ListMigrationCommand extends SanityCommand<typeof ListMigrationCommand> {\n  static override description = 'List available migrations'\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %>',\n      description: 'List all available migrations in the project',\n    },\n  ]\n\n  public async run(): Promise<void> {\n    const {directory: workDir} = await this.getProjectRoot()\n\n    try {\n      const migrations = await resolveMigrations(workDir)\n\n      if (migrations.length === 0) {\n        this.log('No migrations found in migrations folder of the project')\n        this.log(\n          `\\nRun ${chalk.green('`sanity migration create <NAME>`')} to create a new migration`,\n        )\n        return\n      }\n\n      const table = new Table({\n        columns: [\n          {alignment: 'left', name: 'id', title: 'ID'},\n          {alignment: 'left', name: 'title', title: 'Title'},\n        ],\n        title: `Found ${migrations.length} migrations in project`,\n      })\n\n      for (const definedMigration of migrations) {\n        table.addRow({id: definedMigration.id, title: definedMigration.migration.title})\n      }\n      table.printTable()\n      this.log('\\nRun `sanity migration run <ID>` to run a migration')\n      listMigrationDebug(`Successfully listed ${migrations.length} migrations`)\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code === 'ENOENT') {\n        this.log('No migrations folder found in the project')\n        this.log(\n          `\\nRun ${chalk.green('`sanity migration create <NAME>`')} to create a new migration`,\n        )\n        return\n      }\n      listMigrationDebug('Failed to list migrations:', error)\n      this.error(\n        `List migrations failed: ${error instanceof Error ? error.message : String(error)}`,\n        {\n          exit: 1,\n        },\n      )\n    }\n  }\n}\n"],"names":["SanityCommand","subdebug","chalk","Table","resolveMigrations","listMigrationDebug","ListMigrationCommand","description","examples","command","run","directory","workDir","getProjectRoot","migrations","length","log","green","table","columns","alignment","name","title","definedMigration","addRow","id","migration","printTable","error","code","Error","message","String","exit"],"mappings":"AAAA,SAAQA,aAAa,EAAEC,QAAQ,QAAO,mBAAkB;AACxD,SAAQC,KAAK,QAAO,sBAAqB;AACzC,SAAQC,KAAK,QAAO,wBAAuB;AAE3C,SAAQC,iBAAiB,QAAO,+CAA8C;AAE9E,MAAMC,qBAAqBJ,SAAS;AAEpC,OAAO,MAAMK,6BAA6BN;IACxC,OAAgBO,cAAc,4BAA2B;IAEzD,OAAgBC,WAAW;QACzB;YACEC,SAAS;YACTF,aAAa;QACf;KACD,CAAA;IAED,MAAaG,MAAqB;QAChC,MAAM,EAACC,WAAWC,OAAO,EAAC,GAAG,MAAM,IAAI,CAACC,cAAc;QAEtD,IAAI;YACF,MAAMC,aAAa,MAAMV,kBAAkBQ;YAE3C,IAAIE,WAAWC,MAAM,KAAK,GAAG;gBAC3B,IAAI,CAACC,GAAG,CAAC;gBACT,IAAI,CAACA,GAAG,CACN,CAAC,MAAM,EAAEd,MAAMe,KAAK,CAAC,oCAAoC,0BAA0B,CAAC;gBAEtF;YACF;YAEA,MAAMC,QAAQ,IAAIf,MAAM;gBACtBgB,SAAS;oBACP;wBAACC,WAAW;wBAAQC,MAAM;wBAAMC,OAAO;oBAAI;oBAC3C;wBAACF,WAAW;wBAAQC,MAAM;wBAASC,OAAO;oBAAO;iBAClD;gBACDA,OAAO,CAAC,MAAM,EAAER,WAAWC,MAAM,CAAC,sBAAsB,CAAC;YAC3D;YAEA,KAAK,MAAMQ,oBAAoBT,WAAY;gBACzCI,MAAMM,MAAM,CAAC;oBAACC,IAAIF,iBAAiBE,EAAE;oBAAEH,OAAOC,iBAAiBG,SAAS,CAACJ,KAAK;gBAAA;YAChF;YACAJ,MAAMS,UAAU;YAChB,IAAI,CAACX,GAAG,CAAC;YACTX,mBAAmB,CAAC,oBAAoB,EAAES,WAAWC,MAAM,CAAC,WAAW,CAAC;QAC1E,EAAE,OAAOa,OAAO;YACd,IAAI,AAACA,MAAgCC,IAAI,KAAK,UAAU;gBACtD,IAAI,CAACb,GAAG,CAAC;gBACT,IAAI,CAACA,GAAG,CACN,CAAC,MAAM,EAAEd,MAAMe,KAAK,CAAC,oCAAoC,0BAA0B,CAAC;gBAEtF;YACF;YACAZ,mBAAmB,8BAA8BuB;YACjD,IAAI,CAACA,KAAK,CACR,CAAC,wBAAwB,EAAEA,iBAAiBE,QAAQF,MAAMG,OAAO,GAAGC,OAAOJ,QAAQ,EACnF;gBACEK,MAAM;YACR;QAEJ;IACF;AACF"}

package/dist/commands/migration/run.d.ts

@@ -0,0 +1,26 @@
+import { SanityCommand } from '@sanity/cli-core';
+export type RunMigrationFlags = RunMigrationCommand['flags'];
+export declare class RunMigrationCommand extends SanityCommand<typeof RunMigrationCommand> {
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: {
+        command: string;
+        description: string;
+    }[];
+    static flags: {
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        concurrency: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        confirm: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        dataset: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'from-export': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        progress: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private createProgress;
+    private dryRunHandler;
+    private promptConfirmMigrate;
+}

package/dist/commands/migration/run.js

@@ -0,0 +1,271 @@
+import path from 'node:path';
+import { Args, Flags } from '@oclif/core';
+import { SanityCommand, subdebug } from '@sanity/cli-core';
+import { chalk, confirm, spinner } from '@sanity/cli-core/ux';
+import { DEFAULT_MUTATION_CONCURRENCY, dryRun, MAX_MUTATION_CONCURRENCY, run } from '@sanity/migrate';
+import { Table } from 'console-table-printer';
+import { getMigrationRootDirectory } from '../../actions/migration/getMigrationRootDirectory.js';
+import { resolveMigrations } from '../../actions/migration/resolveMigrations.js';
+import { DEFAULT_API_VERSION, MIGRATIONS_DIRECTORY } from '../../util/migration/constants.js';
+import { ensureApiVersionFormat } from '../../util/migration/ensureApiVersionFormat.js';
+import { prettyFormat } from '../../util/migration/prettyMutationFormatter.js';
+import { isLoadableMigrationScript, resolveMigrationScript } from '../../utils/migration/resolveMigrationScript.js';
+const runMigrationDebug = subdebug('migration:run');
+export class RunMigrationCommand extends SanityCommand {
+    static args = {
+        id: Args.string({
+            description: 'ID',
+            required: false
+        })
+    };
+    static description = 'Run a migration against a dataset';
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %> <id>',
+            description: 'dry run the migration'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> <id> --no-dry-run --project xyz --dataset staging',
+            description: 'execute the migration against a dataset'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> <id> --from-export=production.tar.gz --no-dry-run --project xyz --dataset staging',
+            description: 'execute the migration using a dataset export as the source'
+        }
+    ];
+    static flags = {
+        'api-version': Flags.string({
+            description: `API version to use when migrating. Defaults to ${DEFAULT_API_VERSION}.`
+        }),
+        concurrency: Flags.integer({
+            default: DEFAULT_MUTATION_CONCURRENCY,
+            description: `How many mutation requests to run in parallel. Must be between 1 and ${MAX_MUTATION_CONCURRENCY}. Default: ${DEFAULT_MUTATION_CONCURRENCY}.`
+        }),
+        confirm: Flags.boolean({
+            allowNo: true,
+            default: true,
+            description: 'Prompt for confirmation before running the migration (default: true). Use --no-confirm to skip.'
+        }),
+        dataset: Flags.string({
+            description: 'Dataset to migrate. Defaults to the dataset configured in your Sanity CLI config.'
+        }),
+        'dry-run': Flags.boolean({
+            allowNo: true,
+            default: true,
+            description: 'By default the migration runs in dry mode. Use --no-dry-run to migrate dataset.'
+        }),
+        'from-export': Flags.string({
+            description: 'Use a local dataset export as source for migration instead of calling the Sanity API. Note: this is only supported for dry runs.'
+        }),
+        progress: Flags.boolean({
+            allowNo: true,
+            default: true,
+            description: 'Display progress during migration (default: true). Use --no-progress to hide output.'
+        }),
+        project: Flags.string({
+            description: 'Project ID of the dataset to migrate. Defaults to the projectId configured in your Sanity CLI config.'
+        })
+    };
+    async run() {
+        const { args, flags } = await this.parse(RunMigrationCommand);
+        const cliConfig = await this.getCliConfig();
+        const projectId = await this.getProjectId();
+        const datasetFromConfig = cliConfig.api?.dataset;
+        const workDir = await getMigrationRootDirectory(this.output);
+        const id = args.id;
+        const migrationsDirectoryPath = path.join(workDir, MIGRATIONS_DIRECTORY);
+        const fromExport = flags['from-export'];
+        const dry = flags['dry-run'];
+        const dataset = flags.dataset;
+        const project = flags.project;
+        const apiVersion = ensureApiVersionFormat(flags['api-version'] ?? DEFAULT_API_VERSION);
+        if (dataset && !project || project && !dataset) {
+            this.error('If either --dataset or --project is provided, both must be provided', {
+                exit: 1
+            });
+        }
+        if (!project && !projectId) {
+            this.error('sanity.cli.js does not contain a project identifier ("api.projectId") and no --project option was provided.', {
+                exit: 1
+            });
+        }
+        if (!dataset && !datasetFromConfig) {
+            this.error('sanity.cli.js does not contain a dataset identifier ("api.dataset") and no --dataset option was provided.', {
+                exit: 1
+            });
+        }
+        if (!id) {
+            this.warn(chalk.red('Error: Migration ID must be provided'));
+            const migrations = await resolveMigrations(workDir);
+            const table = new Table({
+                columns: [
+                    {
+                        alignment: 'left',
+                        name: 'id',
+                        title: 'ID'
+                    },
+                    {
+                        alignment: 'left',
+                        name: 'title',
+                        title: 'Title'
+                    }
+                ],
+                title: `Migrations found in project`
+            });
+            for (const definedMigration of migrations){
+                table.addRow({
+                    id: definedMigration.id,
+                    title: definedMigration.migration.title
+                });
+            }
+            table.printTable();
+            this.log('\nRun `sanity migration run <ID>` to run a migration');
+            this.exit(1);
+        }
+        const candidates = await resolveMigrationScript(workDir, id);
+        const resolvedScripts = candidates.filter((candidate)=>isLoadableMigrationScript(candidate));
+        if (resolvedScripts.length > 1) {
+            // todo: consider prompt user about which one to run? note: it's likely a mistake if multiple files resolve to the same name
+            this.error(`Found multiple migrations for "${id}" in ${chalk.cyan(migrationsDirectoryPath)}: \n - ${candidates.map((candidate)=>path.relative(migrationsDirectoryPath, candidate.absolutePath)).join('\n - ')}`, {
+                exit: 1
+            });
+        }
+        const script = resolvedScripts[0];
+        if (!script) {
+            this.error(`No migration found for "${id}" in ${chalk.cyan(chalk.cyan(migrationsDirectoryPath))}. Make sure that the migration file exists and exports a valid migration as its default export.\n
+ Tried the following files:\n - ${candidates.map((candidate)=>path.relative(migrationsDirectoryPath, candidate.absolutePath)).join('\n - ')}`, {
+                exit: 1
+            });
+        }
+        const mod = script.mod;
+        if ('up' in mod || 'down' in mod) {
+            // todo: consider adding support for up/down as separate named exports
+            // For now, make sure we reserve the names for future use
+            this.error('Only "up" migrations are supported at this time, please use a default export', {
+                exit: 1
+            });
+        }
+        const migration = mod.default;
+        if (fromExport && !dry) {
+            this.error('Can only dry run migrations from a dataset export file', {
+                exit: 1
+            });
+        }
+        const concurrency = flags.concurrency;
+        if (concurrency !== undefined) {
+            if (concurrency > MAX_MUTATION_CONCURRENCY) {
+                this.error(`Concurrency exceeds the maximum allowed value of ${MAX_MUTATION_CONCURRENCY}`, {
+                    exit: 1
+                });
+            }
+            if (concurrency < 1) {
+                this.error(`Concurrency must be a positive number, got ${concurrency}`, {
+                    exit: 1
+                });
+            }
+        }
+        const projectClient = await this.getProjectApiClient({
+            apiVersion: apiVersion,
+            projectId: project ?? projectId,
+            requireUser: true
+        });
+        const projectConfig = projectClient.config();
+        const apiConfig = {
+            apiHost: projectConfig.apiHost,
+            apiVersion: apiVersion,
+            dataset: dataset ?? datasetFromConfig,
+            projectId: project ?? projectId,
+            token: projectConfig.token
+        };
+        if (dry) {
+            this.dryRunHandler(id, migration, apiConfig, fromExport);
+            return;
+        }
+        this.log(`\n${chalk.yellow(chalk.bold('Note: During migrations, your webhooks stay active.'))}`);
+        this.log(`To adjust them, launch the management interface with ${chalk.cyan('sanity manage')}, navigate to the API settings, and toggle the webhooks before and after the migration as needed.\n`);
+        if (flags.confirm) {
+            await this.promptConfirmMigrate(apiConfig);
+        }
+        const spin = spinner(`Running migration "${id}"`).start();
+        await run({
+            api: apiConfig,
+            concurrency,
+            onProgress: this.createProgress(spin, flags, id, dry, apiConfig, migration)
+        }, migration);
+        spin.stop();
+    }
+    createProgress(progressSpinner, flags, id, dry, apiConfig, migration) {
+        return function onProgress(progress) {
+            if (!flags.progress) {
+                progressSpinner.stop();
+                return;
+            }
+            if (progress.done) {
+                progressSpinner.text = `Migration "${id}" completed.
+
+  Project id:  ${chalk.bold(apiConfig.projectId)}
+  Dataset:     ${chalk.bold(apiConfig.dataset)}
+
+  ${progress.documents} documents processed.
+  ${progress.mutations} mutations generated.
+  ${chalk.green(progress.completedTransactions.length)} transactions committed.`;
+                progressSpinner.stopAndPersist({
+                    symbol: chalk.green('✔')
+                });
+                return;
+            }
+            for (const transaction of [
+                null,
+                ...progress.currentTransactions
+            ]){
+                progressSpinner.text = `Running migration "${id}" ${dry ? 'in dry mode...' : '...'}
+
+  Project id:     ${chalk.bold(apiConfig.projectId)}
+  Dataset:        ${chalk.bold(apiConfig.dataset)}
+  Document type:  ${chalk.bold(migration.documentTypes?.join(','))}
+
+  ${progress.documents} documents processed…
+  ${progress.mutations} mutations generated…
+  ${chalk.blue(progress.pending)} requests pending…
+  ${chalk.green(progress.completedTransactions.length)} transactions committed.
+
+  ${transaction && !progress.done ? `» ${prettyFormat({
+                    indentSize: 2,
+                    migration,
+                    subject: transaction
+                })}` : ''}`;
+            }
+        };
+    }
+    async dryRunHandler(id, migration, apiConfig, fromExport) {
+        this.log(`Running migration "${id}" in dry mode`);
+        if (fromExport) {
+            this.log(`Using export ${chalk.cyan(fromExport)}`);
+        }
+        this.log();
+        this.log(`Project id:  ${chalk.bold(apiConfig.projectId)}`);
+        this.log(`Dataset:     ${chalk.bold(apiConfig.dataset)}`);
+        for await (const mutation of dryRun({
+            api: apiConfig,
+            exportPath: fromExport
+        }, migration)){
+            if (!mutation) continue;
+            this.log();
+            this.log(prettyFormat({
+                migration,
+                subject: mutation
+            }));
+        }
+    }
+    async promptConfirmMigrate(apiConfig) {
+        const response = await confirm({
+            message: `This migration will run on the ${chalk.yellow(chalk.bold(apiConfig.dataset))} dataset in ${chalk.yellow(chalk.bold(apiConfig.projectId))} project. Are you sure?`
+        });
+        if (!response) {
+            runMigrationDebug('User aborted migration');
+            this.exit(1);
+        }
+    }
+}
+
+//# sourceMappingURL=run.js.map

package/dist/commands/migration/run.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/commands/migration/run.ts"],"sourcesContent":["import path from 'node:path'\n\nimport {Args, Flags} from '@oclif/core'\nimport {SanityCommand, subdebug} from '@sanity/cli-core'\nimport {chalk, confirm, spinner} from '@sanity/cli-core/ux'\nimport {\n  APIConfig,\n  DEFAULT_MUTATION_CONCURRENCY,\n  dryRun,\n  MAX_MUTATION_CONCURRENCY,\n  type Migration,\n  type MigrationProgress,\n  run,\n} from '@sanity/migrate'\nimport {Table} from 'console-table-printer'\n\nimport {getMigrationRootDirectory} from '../../actions/migration/getMigrationRootDirectory.js'\nimport {resolveMigrations} from '../../actions/migration/resolveMigrations.js'\nimport {DEFAULT_API_VERSION, MIGRATIONS_DIRECTORY} from '../../util/migration/constants.js'\nimport {ensureApiVersionFormat} from '../../util/migration/ensureApiVersionFormat.js'\nimport {prettyFormat} from '../../util/migration/prettyMutationFormatter.js'\nimport {\n  isLoadableMigrationScript,\n  resolveMigrationScript,\n} from '../../utils/migration/resolveMigrationScript.js'\n\nconst runMigrationDebug = subdebug('migration:run')\n\nexport type RunMigrationFlags = RunMigrationCommand['flags']\n\nexport class RunMigrationCommand extends SanityCommand<typeof RunMigrationCommand> {\n  static override args = {\n    id: Args.string({\n      description: 'ID',\n      required: false,\n    }),\n  }\n\n  static override description = 'Run a migration against a dataset'\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %> <id>',\n      description: 'dry run the migration',\n    },\n    {\n      command:\n        '<%= config.bin %> <%= command.id %> <id> --no-dry-run --project xyz --dataset staging',\n      description: 'execute the migration against a dataset',\n    },\n    {\n      command:\n        '<%= config.bin %> <%= command.id %> <id> --from-export=production.tar.gz --no-dry-run --project xyz --dataset staging',\n      description: 'execute the migration using a dataset export as the source',\n    },\n  ]\n\n  static override flags = {\n    'api-version': Flags.string({\n      description: `API version to use when migrating. Defaults to ${DEFAULT_API_VERSION}.`,\n    }),\n    concurrency: Flags.integer({\n      default: DEFAULT_MUTATION_CONCURRENCY,\n      description: `How many mutation requests to run in parallel. Must be between 1 and ${MAX_MUTATION_CONCURRENCY}. Default: ${DEFAULT_MUTATION_CONCURRENCY}.`,\n    }),\n    confirm: Flags.boolean({\n      allowNo: true,\n      default: true,\n      description:\n        'Prompt for confirmation before running the migration (default: true). Use --no-confirm to skip.',\n    }),\n    dataset: Flags.string({\n      description:\n        'Dataset to migrate. Defaults to the dataset configured in your Sanity CLI config.',\n    }),\n    'dry-run': Flags.boolean({\n      allowNo: true,\n      default: true,\n      description:\n        'By default the migration runs in dry mode. Use --no-dry-run to migrate dataset.',\n    }),\n    'from-export': Flags.string({\n      description:\n        'Use a local dataset export as source for migration instead of calling the Sanity API. Note: this is only supported for dry runs.',\n    }),\n    progress: Flags.boolean({\n      allowNo: true,\n      default: true,\n      description:\n        'Display progress during migration (default: true). Use --no-progress to hide output.',\n    }),\n    project: Flags.string({\n      description:\n        'Project ID of the dataset to migrate. Defaults to the projectId configured in your Sanity CLI config.',\n    }),\n  }\n\n  public async run(): Promise<void> {\n    const {args, flags} = await this.parse(RunMigrationCommand)\n    const cliConfig = await this.getCliConfig()\n    const projectId = await this.getProjectId()\n    const datasetFromConfig = cliConfig.api?.dataset\n\n    const workDir = await getMigrationRootDirectory(this.output)\n    const id = args.id\n    const migrationsDirectoryPath = path.join(workDir, MIGRATIONS_DIRECTORY)\n\n    const fromExport = flags['from-export']\n    const dry = flags['dry-run']\n    const dataset = flags.dataset\n    const project = flags.project\n    const apiVersion = ensureApiVersionFormat(flags['api-version'] ?? DEFAULT_API_VERSION)\n\n    if ((dataset && !project) || (project && !dataset)) {\n      this.error('If either --dataset or --project is provided, both must be provided', {exit: 1})\n    }\n\n    if (!project && !projectId) {\n      this.error(\n        'sanity.cli.js does not contain a project identifier (\"api.projectId\") and no --project option was provided.',\n        {exit: 1},\n      )\n    }\n\n    if (!dataset && !datasetFromConfig) {\n      this.error(\n        'sanity.cli.js does not contain a dataset identifier (\"api.dataset\") and no --dataset option was provided.',\n        {exit: 1},\n      )\n    }\n\n    if (!id) {\n      this.warn(chalk.red('Error: Migration ID must be provided'))\n\n      const migrations = await resolveMigrations(workDir)\n      const table = new Table({\n        columns: [\n          {alignment: 'left', name: 'id', title: 'ID'},\n          {alignment: 'left', name: 'title', title: 'Title'},\n        ],\n        title: `Migrations found in project`,\n      })\n\n      for (const definedMigration of migrations) {\n        table.addRow({id: definedMigration.id, title: definedMigration.migration.title})\n      }\n      table.printTable()\n      this.log('\\nRun `sanity migration run <ID>` to run a migration')\n\n      this.exit(1)\n    }\n\n    const candidates = await resolveMigrationScript(workDir, id)\n    const resolvedScripts = candidates.filter((candidate) => isLoadableMigrationScript(candidate))\n\n    if (resolvedScripts.length > 1) {\n      // todo: consider prompt user about which one to run? note: it's likely a mistake if multiple files resolve to the same name\n      this.error(\n        `Found multiple migrations for \"${id}\" in ${chalk.cyan(migrationsDirectoryPath)}: \\n - ${candidates\n          .map((candidate) => path.relative(migrationsDirectoryPath, candidate.absolutePath))\n          .join('\\n - ')}`,\n        {exit: 1},\n      )\n    }\n\n    const script = resolvedScripts[0]\n    if (!script) {\n      this.error(\n        `No migration found for \"${id}\" in ${chalk.cyan(chalk.cyan(migrationsDirectoryPath))}. Make sure that the migration file exists and exports a valid migration as its default export.\\n\n Tried the following files:\\n - ${candidates\n   .map((candidate) => path.relative(migrationsDirectoryPath, candidate.absolutePath))\n   .join('\\n - ')}`,\n        {exit: 1},\n      )\n    }\n\n    const mod = script.mod\n    if ('up' in mod || 'down' in mod) {\n      // todo: consider adding support for up/down as separate named exports\n      // For now, make sure we reserve the names for future use\n      this.error('Only \"up\" migrations are supported at this time, please use a default export', {\n        exit: 1,\n      })\n    }\n\n    const migration: Migration = mod.default\n\n    if (fromExport && !dry) {\n      this.error('Can only dry run migrations from a dataset export file', {exit: 1})\n    }\n\n    const concurrency = flags.concurrency\n    if (concurrency !== undefined) {\n      if (concurrency > MAX_MUTATION_CONCURRENCY) {\n        this.error(`Concurrency exceeds the maximum allowed value of ${MAX_MUTATION_CONCURRENCY}`, {\n          exit: 1,\n        })\n      }\n\n      if (concurrency < 1) {\n        this.error(`Concurrency must be a positive number, got ${concurrency}`, {exit: 1})\n      }\n    }\n\n    const projectClient = await this.getProjectApiClient({\n      apiVersion: apiVersion,\n      projectId: (project ?? projectId)!,\n      requireUser: true,\n    })\n    const projectConfig = projectClient.config()\n\n    const apiConfig: APIConfig = {\n      apiHost: projectConfig.apiHost,\n      apiVersion: apiVersion,\n      dataset: (dataset ?? datasetFromConfig)!,\n      projectId: (project ?? projectId)!,\n      token: projectConfig.token!,\n    } as const\n    if (dry) {\n      this.dryRunHandler(id, migration, apiConfig, fromExport)\n      return\n    }\n\n    this.log(`\\n${chalk.yellow(chalk.bold('Note: During migrations, your webhooks stay active.'))}`)\n    this.log(\n      `To adjust them, launch the management interface with ${chalk.cyan('sanity manage')}, navigate to the API settings, and toggle the webhooks before and after the migration as needed.\\n`,\n    )\n\n    if (flags.confirm) {\n      await this.promptConfirmMigrate(apiConfig)\n    }\n\n    const spin = spinner(`Running migration \"${id}\"`).start()\n    await run(\n      {\n        api: apiConfig,\n        concurrency,\n        onProgress: this.createProgress(spin, flags, id, dry, apiConfig, migration),\n      },\n      migration,\n    )\n    spin.stop()\n  }\n\n  private createProgress(\n    progressSpinner: ReturnType<typeof spinner>,\n    flags: RunMigrationFlags,\n    id: string,\n    dry: boolean,\n    apiConfig: APIConfig,\n    migration: Migration,\n  ) {\n    return function onProgress(progress: MigrationProgress) {\n      if (!flags.progress) {\n        progressSpinner.stop()\n        return\n      }\n      if (progress.done) {\n        progressSpinner.text = `Migration \"${id}\" completed.\n\n  Project id:  ${chalk.bold(apiConfig.projectId)}\n  Dataset:     ${chalk.bold(apiConfig.dataset)}\n\n  ${progress.documents} documents processed.\n  ${progress.mutations} mutations generated.\n  ${chalk.green(progress.completedTransactions.length)} transactions committed.`\n        progressSpinner.stopAndPersist({symbol: chalk.green('✔')})\n        return\n      }\n\n      for (const transaction of [null, ...progress.currentTransactions]) {\n        progressSpinner.text = `Running migration \"${id}\" ${dry ? 'in dry mode...' : '...'}\n\n  Project id:     ${chalk.bold(apiConfig.projectId)}\n  Dataset:        ${chalk.bold(apiConfig.dataset)}\n  Document type:  ${chalk.bold(migration.documentTypes?.join(','))}\n\n  ${progress.documents} documents processed…\n  ${progress.mutations} mutations generated…\n  ${chalk.blue(progress.pending)} requests pending…\n  ${chalk.green(progress.completedTransactions.length)} transactions committed.\n\n  ${\n    transaction && !progress.done\n      ? `» ${prettyFormat({indentSize: 2, migration, subject: transaction})}`\n      : ''\n  }`\n      }\n    }\n  }\n\n  private async dryRunHandler(\n    id: string,\n    migration: Migration,\n    apiConfig: APIConfig,\n    fromExport: string | undefined,\n  ) {\n    this.log(`Running migration \"${id}\" in dry mode`)\n\n    if (fromExport) {\n      this.log(`Using export ${chalk.cyan(fromExport)}`)\n    }\n\n    this.log()\n    this.log(`Project id:  ${chalk.bold(apiConfig.projectId)}`)\n    this.log(`Dataset:     ${chalk.bold(apiConfig.dataset)}`)\n\n    for await (const mutation of dryRun({api: apiConfig, exportPath: fromExport}, migration)) {\n      if (!mutation) continue\n      this.log()\n      this.log(\n        prettyFormat({\n          migration,\n          subject: mutation,\n        }),\n      )\n    }\n  }\n\n  private async promptConfirmMigrate(apiConfig: APIConfig) {\n    const response = await confirm({\n      message: `This migration will run on the ${chalk.yellow(\n        chalk.bold(apiConfig.dataset),\n      )} dataset in ${chalk.yellow(chalk.bold(apiConfig.projectId))} project. Are you sure?`,\n    })\n\n    if (!response) {\n      runMigrationDebug('User aborted migration')\n      this.exit(1)\n    }\n  }\n}\n"],"names":["path","Args","Flags","SanityCommand","subdebug","chalk","confirm","spinner","DEFAULT_MUTATION_CONCURRENCY","dryRun","MAX_MUTATION_CONCURRENCY","run","Table","getMigrationRootDirectory","resolveMigrations","DEFAULT_API_VERSION","MIGRATIONS_DIRECTORY","ensureApiVersionFormat","prettyFormat","isLoadableMigrationScript","resolveMigrationScript","runMigrationDebug","RunMigrationCommand","args","id","string","description","required","examples","command","flags","concurrency","integer","default","boolean","allowNo","dataset","progress","project","parse","cliConfig","getCliConfig","projectId","getProjectId","datasetFromConfig","api","workDir","output","migrationsDirectoryPath","join","fromExport","dry","apiVersion","error","exit","warn","red","migrations","table","columns","alignment","name","title","definedMigration","addRow","migration","printTable","log","candidates","resolvedScripts","filter","candidate","length","cyan","map","relative","absolutePath","script","mod","undefined","projectClient","getProjectApiClient","requireUser","projectConfig","config","apiConfig","apiHost","token","dryRunHandler","yellow","bold","promptConfirmMigrate","spin","start","onProgress","createProgress","stop","progressSpinner","done","text","documents","mutations","green","completedTransactions","stopAndPersist","symbol","transaction","currentTransactions","documentTypes","blue","pending","indentSize","subject","mutation","exportPath","response","message"],"mappings":"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"}