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

package/dist/commands/dataset/alias/link.js

@@ -0,0 +1,137 @@
+import { Args, Flags } from '@oclif/core';
+import { SanityCommand, subdebug } from '@sanity/cli-core';
+import { input } from '@sanity/cli-core/ux';
+import { processAliasName } from '../../../actions/dataset/processAliasName.js';
+import { validateDatasetAliasName } from '../../../actions/dataset/validateDatasetAliasName.js';
+import { validateDatasetName } from '../../../actions/dataset/validateDatasetName.js';
+import { promptForDatasetAliasName } from '../../../prompts/promptForDatasetAliasName.js';
+import { selectDataset } from '../../../prompts/selectDataset.js';
+import { listAliases, updateAlias } from '../../../services/datasetAliases.js';
+import { listDatasets } from '../../../services/datasets.js';
+import { NO_PROJECT_ID } from '../../../util/errorMessages.js';
+const linkAliasDebug = subdebug('dataset:alias:link');
+export class LinkAliasCommand extends SanityCommand {
+    static args = {
+        aliasName: Args.string({
+            description: 'Dataset alias name to link',
+            required: false
+        }),
+        targetDataset: Args.string({
+            description: 'Target dataset name to link the alias to',
+            required: false
+        })
+    };
+    static description = 'Link a dataset alias to a dataset within your project';
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %>',
+            description: 'Link an alias with interactive prompts'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> conference',
+            description: 'Link alias named "conference" with interactive dataset selection'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> conference conf-2025',
+            description: 'Link alias "conference" to "conf-2025" dataset'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> ~conference conf-2025',
+            description: 'Link alias with explicit ~ prefix'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> conference conf-2025 --force',
+            description: 'Force link without confirmation (skip relink prompt)'
+        }
+    ];
+    static flags = {
+        force: Flags.boolean({
+            description: 'Skip confirmation prompt when relinking existing alias',
+            required: false
+        })
+    };
+    async run() {
+        const { args, flags } = await this.parse(LinkAliasCommand);
+        const { force } = flags;
+        const projectId = await this.getProjectId();
+        if (!projectId) {
+            this.error(NO_PROJECT_ID, {
+                exit: 1
+            });
+        }
+        if (args.aliasName) {
+            const { apiName } = processAliasName(args.aliasName);
+            const nameError = validateDatasetAliasName(apiName);
+            if (nameError) {
+                this.error(nameError, {
+                    exit: 1
+                });
+            }
+        }
+        if (args.targetDataset) {
+            const datasetErr = validateDatasetName(args.targetDataset);
+            if (datasetErr) {
+                this.error(datasetErr, {
+                    exit: 1
+                });
+            }
+        }
+        try {
+            const [datasetsResponse, aliases] = await Promise.all([
+                listDatasets(projectId),
+                listAliases(projectId)
+            ]);
+            const datasets = datasetsResponse.map((ds)=>ds.name);
+            const aliasNameInput = args.aliasName || await promptForDatasetAliasName();
+            const { apiName, displayName } = processAliasName(aliasNameInput);
+            const existingAlias = aliases.find((alias)=>alias.name === apiName);
+            if (!existingAlias) {
+                const availableAliases = aliases.map((a)=>`~${a.name}`).join(', ');
+                this.error(`Dataset alias "${displayName}" does not exist. Available aliases: ${availableAliases}`, {
+                    exit: 1
+                });
+            }
+            const targetDataset = args.targetDataset || (datasets.length > 0 ? await selectDataset(datasets, {
+                message: 'Select target dataset to link alias to:'
+            }) : null);
+            if (!targetDataset) {
+                this.error('No datasets available to link to', {
+                    exit: 1
+                });
+            }
+            if (!datasets.includes(targetDataset)) {
+                this.error(`Dataset "${targetDataset}" does not exist. Available datasets: ${datasets.join(', ')}`, {
+                    exit: 1
+                });
+            }
+            if (existingAlias.datasetName === targetDataset) {
+                this.error(`Dataset alias ${displayName} already linked to ${targetDataset}`, {
+                    exit: 1
+                });
+            }
+            if (existingAlias.datasetName && !force) {
+                await this.confirmRelink(existingAlias.datasetName, targetDataset);
+            } else if (force && existingAlias.datasetName) {
+                this.warn(`'--force' used: skipping confirmation, linking alias to ${targetDataset}`);
+            }
+            await updateAlias(projectId, apiName, targetDataset);
+            this.log(`Dataset alias ${displayName} linked to ${targetDataset} successfully`);
+        } catch (error) {
+            linkAliasDebug(`Error linking dataset alias`, error);
+            this.error(`Dataset alias linking failed: ${error instanceof Error ? error.message : String(error)}`, {
+                exit: 1
+            });
+        }
+    }
+    async confirmRelink(currentDataset, newDataset) {
+        await input({
+            message: `This alias is linked to dataset <${currentDataset}>. Are you ABSOLUTELY sure you want to link this dataset alias to ${newDataset}?\n  Type YES/NO:`,
+            validate: (input)=>{
+                const response = input.toLowerCase().trim();
+                return response === 'yes' || 'Type YES to confirm or Ctrl + C to cancel dataset alias link.';
+            }
+        });
+    }
+}
+
+//# sourceMappingURL=link.js.map

package/dist/commands/dataset/alias/link.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/commands/dataset/alias/link.ts"],"sourcesContent":["import {Args, Flags} from '@oclif/core'\nimport {SanityCommand, subdebug} from '@sanity/cli-core'\nimport {input} from '@sanity/cli-core/ux'\n\nimport {processAliasName} from '../../../actions/dataset/processAliasName.js'\nimport {validateDatasetAliasName} from '../../../actions/dataset/validateDatasetAliasName.js'\nimport {validateDatasetName} from '../../../actions/dataset/validateDatasetName.js'\nimport {promptForDatasetAliasName} from '../../../prompts/promptForDatasetAliasName.js'\nimport {selectDataset} from '../../../prompts/selectDataset.js'\nimport {listAliases, updateAlias} from '../../../services/datasetAliases.js'\nimport {listDatasets} from '../../../services/datasets.js'\nimport {NO_PROJECT_ID} from '../../../util/errorMessages.js'\n\nconst linkAliasDebug = subdebug('dataset:alias:link')\n\nexport class LinkAliasCommand extends SanityCommand<typeof LinkAliasCommand> {\n  static override args = {\n    aliasName: Args.string({\n      description: 'Dataset alias name to link',\n      required: false,\n    }),\n    targetDataset: Args.string({\n      description: 'Target dataset name to link the alias to',\n      required: false,\n    }),\n  }\n\n  static override description = 'Link a dataset alias to a dataset within your project'\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %>',\n      description: 'Link an alias with interactive prompts',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> conference',\n      description: 'Link alias named \"conference\" with interactive dataset selection',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> conference conf-2025',\n      description: 'Link alias \"conference\" to \"conf-2025\" dataset',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> ~conference conf-2025',\n      description: 'Link alias with explicit ~ prefix',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> conference conf-2025 --force',\n      description: 'Force link without confirmation (skip relink prompt)',\n    },\n  ]\n\n  static override flags = {\n    force: Flags.boolean({\n      description: 'Skip confirmation prompt when relinking existing alias',\n      required: false,\n    }),\n  }\n\n  public async run(): Promise<void> {\n    const {args, flags} = await this.parse(LinkAliasCommand)\n    const {force} = flags\n\n    const projectId = await this.getProjectId()\n    if (!projectId) {\n      this.error(NO_PROJECT_ID, {exit: 1})\n    }\n\n    if (args.aliasName) {\n      const {apiName} = processAliasName(args.aliasName)\n      const nameError = validateDatasetAliasName(apiName)\n      if (nameError) {\n        this.error(nameError, {exit: 1})\n      }\n    }\n\n    if (args.targetDataset) {\n      const datasetErr = validateDatasetName(args.targetDataset)\n      if (datasetErr) {\n        this.error(datasetErr, {exit: 1})\n      }\n    }\n\n    try {\n      const [datasetsResponse, aliases] = await Promise.all([\n        listDatasets(projectId),\n        listAliases(projectId),\n      ])\n\n      const datasets = datasetsResponse.map((ds) => ds.name)\n\n      const aliasNameInput = args.aliasName || (await promptForDatasetAliasName())\n\n      const {apiName, displayName} = processAliasName(aliasNameInput)\n\n      const existingAlias = aliases.find((alias) => alias.name === apiName)\n      if (!existingAlias) {\n        const availableAliases = aliases.map((a) => `~${a.name}`).join(', ')\n        this.error(\n          `Dataset alias \"${displayName}\" does not exist. Available aliases: ${availableAliases}`,\n          {exit: 1},\n        )\n      }\n\n      const targetDataset =\n        args.targetDataset ||\n        (datasets.length > 0\n          ? await selectDataset(datasets, {\n              message: 'Select target dataset to link alias to:',\n            })\n          : null)\n\n      if (!targetDataset) {\n        this.error('No datasets available to link to', {exit: 1})\n      }\n\n      if (!datasets.includes(targetDataset)) {\n        this.error(\n          `Dataset \"${targetDataset}\" does not exist. Available datasets: ${datasets.join(', ')}`,\n          {exit: 1},\n        )\n      }\n\n      if (existingAlias.datasetName === targetDataset) {\n        this.error(`Dataset alias ${displayName} already linked to ${targetDataset}`, {exit: 1})\n      }\n\n      if (existingAlias.datasetName && !force) {\n        await this.confirmRelink(existingAlias.datasetName, targetDataset)\n      } else if (force && existingAlias.datasetName) {\n        this.warn(`'--force' used: skipping confirmation, linking alias to ${targetDataset}`)\n      }\n\n      await updateAlias(projectId, apiName, targetDataset)\n\n      this.log(`Dataset alias ${displayName} linked to ${targetDataset} successfully`)\n    } catch (error) {\n      linkAliasDebug(`Error linking dataset alias`, error)\n      this.error(\n        `Dataset alias linking failed: ${error instanceof Error ? error.message : String(error)}`,\n        {exit: 1},\n      )\n    }\n  }\n\n  private async confirmRelink(currentDataset: string, newDataset: string): Promise<void> {\n    await input({\n      message: `This alias is linked to dataset <${currentDataset}>. Are you ABSOLUTELY sure you want to link this dataset alias to ${newDataset}?\\n  Type YES/NO:`,\n      validate: (input) => {\n        const response = input.toLowerCase().trim()\n        return response === 'yes' || 'Type YES to confirm or Ctrl + C to cancel dataset alias link.'\n      },\n    })\n  }\n}\n"],"names":["Args","Flags","SanityCommand","subdebug","input","processAliasName","validateDatasetAliasName","validateDatasetName","promptForDatasetAliasName","selectDataset","listAliases","updateAlias","listDatasets","NO_PROJECT_ID","linkAliasDebug","LinkAliasCommand","args","aliasName","string","description","required","targetDataset","examples","command","flags","force","boolean","run","parse","projectId","getProjectId","error","exit","apiName","nameError","datasetErr","datasetsResponse","aliases","Promise","all","datasets","map","ds","name","aliasNameInput","displayName","existingAlias","find","alias","availableAliases","a","join","length","message","includes","datasetName","confirmRelink","warn","log","Error","String","currentDataset","newDataset","validate","response","toLowerCase","trim"],"mappings":"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"}

package/dist/commands/dataset/alias/unlink.js

@@ -0,0 +1,98 @@
+import { Args, Flags } from '@oclif/core';
+import { SanityCommand, subdebug } from '@sanity/cli-core';
+import { input } from '@sanity/cli-core/ux';
+import { processAliasName } from '../../../actions/dataset/processAliasName.js';
+import { validateDatasetAliasName } from '../../../actions/dataset/validateDatasetAliasName.js';
+import { promptForDatasetAliasName } from '../../../prompts/promptForDatasetAliasName.js';
+import { listAliases, unlinkAlias } from '../../../services/datasetAliases.js';
+import { NO_PROJECT_ID } from '../../../util/errorMessages.js';
+const unlinkAliasDebug = subdebug('dataset:alias:unlink');
+export class UnlinkAliasCommand extends SanityCommand {
+    static args = {
+        aliasName: Args.string({
+            description: 'Dataset alias name to unlink',
+            required: false
+        })
+    };
+    static description = 'Unlink a dataset alias from its dataset within your project';
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %>',
+            description: 'Unlink an alias with interactive selection'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> conference',
+            description: 'Unlink alias "conference" with confirmation prompt'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> ~conference',
+            description: 'Unlink alias with explicit ~ prefix'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> conference --force',
+            description: 'Unlink alias "conference" without confirmation prompt'
+        }
+    ];
+    static flags = {
+        force: Flags.boolean({
+            description: 'Skip confirmation prompt and unlink immediately',
+            required: false
+        })
+    };
+    async run() {
+        const { args, flags } = await this.parse(UnlinkAliasCommand);
+        const { force } = flags;
+        const projectId = await this.getProjectId();
+        if (!projectId) {
+            this.error(NO_PROJECT_ID, {
+                exit: 1
+            });
+        }
+        try {
+            const aliasNameInput = args.aliasName || await promptForDatasetAliasName();
+            const { apiName, displayName } = processAliasName(aliasNameInput);
+            const nameError = validateDatasetAliasName(apiName);
+            if (nameError) {
+                this.error(nameError, {
+                    exit: 1
+                });
+            }
+            const aliases = await listAliases(projectId);
+            // get the current alias from the remote alias list
+            const linkedAlias = aliases.find((elem)=>elem.name === apiName);
+            if (!linkedAlias) {
+                this.error(`Dataset alias "${displayName}" does not exist`, {
+                    exit: 1
+                });
+            }
+            if (!linkedAlias.datasetName) {
+                this.error(`Dataset alias "${displayName}" is not linked to a dataset`, {
+                    exit: 1
+                });
+            }
+            if (force) {
+                this.warn(`'--force' used: skipping confirmation, unlinking alias "${displayName}"`);
+            } else {
+                await this.confirmUnlink(linkedAlias.datasetName);
+            }
+            const result = await unlinkAlias(projectId, apiName);
+            this.log(`Dataset alias ${displayName} unlinked from ${result.datasetName} successfully`);
+        } catch (error) {
+            unlinkAliasDebug('Error unlinking dataset alias', error);
+            this.error(`Dataset alias unlink failed: ${error instanceof Error ? error.message : String(error)}`, {
+                exit: 1
+            });
+        }
+    }
+    async confirmUnlink(datasetName) {
+        await input({
+            message: `Are you ABSOLUTELY sure you want to unlink this alias from the "${datasetName}" dataset?\n  Type YES/NO:`,
+            validate: (input)=>{
+                const response = input.toLowerCase().trim();
+                return response === 'yes' || 'Type YES to confirm or Ctrl + C to cancel dataset alias unlink.';
+            }
+        });
+    }
+}
+
+//# sourceMappingURL=unlink.js.map

package/dist/commands/dataset/alias/unlink.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/commands/dataset/alias/unlink.ts"],"sourcesContent":["import {Args, Flags} from '@oclif/core'\nimport {SanityCommand, subdebug} from '@sanity/cli-core'\nimport {input} from '@sanity/cli-core/ux'\n\nimport {processAliasName} from '../../../actions/dataset/processAliasName.js'\nimport {validateDatasetAliasName} from '../../../actions/dataset/validateDatasetAliasName.js'\nimport {promptForDatasetAliasName} from '../../../prompts/promptForDatasetAliasName.js'\nimport {listAliases, unlinkAlias} from '../../../services/datasetAliases.js'\nimport {NO_PROJECT_ID} from '../../../util/errorMessages.js'\n\nconst unlinkAliasDebug = subdebug('dataset:alias:unlink')\n\nexport class UnlinkAliasCommand extends SanityCommand<typeof UnlinkAliasCommand> {\n  static override args = {\n    aliasName: Args.string({\n      description: 'Dataset alias name to unlink',\n      required: false,\n    }),\n  }\n\n  static override description = 'Unlink a dataset alias from its dataset within your project'\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %>',\n      description: 'Unlink an alias with interactive selection',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> conference',\n      description: 'Unlink alias \"conference\" with confirmation prompt',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> ~conference',\n      description: 'Unlink alias with explicit ~ prefix',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> conference --force',\n      description: 'Unlink alias \"conference\" without confirmation prompt',\n    },\n  ]\n\n  static override flags = {\n    force: Flags.boolean({\n      description: 'Skip confirmation prompt and unlink immediately',\n      required: false,\n    }),\n  }\n\n  public async run(): Promise<void> {\n    const {args, flags} = await this.parse(UnlinkAliasCommand)\n    const {force} = flags\n\n    const projectId = await this.getProjectId()\n    if (!projectId) {\n      this.error(NO_PROJECT_ID, {exit: 1})\n    }\n\n    try {\n      const aliasNameInput = args.aliasName || (await promptForDatasetAliasName())\n      const {apiName, displayName} = processAliasName(aliasNameInput)\n\n      const nameError = validateDatasetAliasName(apiName)\n      if (nameError) {\n        this.error(nameError, {exit: 1})\n      }\n\n      const aliases = await listAliases(projectId)\n\n      // get the current alias from the remote alias list\n      const linkedAlias = aliases.find((elem) => elem.name === apiName)\n      if (!linkedAlias) {\n        this.error(`Dataset alias \"${displayName}\" does not exist`, {exit: 1})\n      }\n\n      if (!linkedAlias.datasetName) {\n        this.error(`Dataset alias \"${displayName}\" is not linked to a dataset`, {exit: 1})\n      }\n\n      if (force) {\n        this.warn(`'--force' used: skipping confirmation, unlinking alias \"${displayName}\"`)\n      } else {\n        await this.confirmUnlink(linkedAlias.datasetName)\n      }\n\n      const result = await unlinkAlias(projectId, apiName)\n      this.log(`Dataset alias ${displayName} unlinked from ${result.datasetName} successfully`)\n    } catch (error) {\n      unlinkAliasDebug('Error unlinking dataset alias', error)\n      this.error(\n        `Dataset alias unlink failed: ${error instanceof Error ? error.message : String(error)}`,\n        {exit: 1},\n      )\n    }\n  }\n\n  private async confirmUnlink(datasetName: string): Promise<void> {\n    await input({\n      message: `Are you ABSOLUTELY sure you want to unlink this alias from the \"${datasetName}\" dataset?\\n  Type YES/NO:`,\n      validate: (input) => {\n        const response = input.toLowerCase().trim()\n        return (\n          response === 'yes' || 'Type YES to confirm or Ctrl + C to cancel dataset alias unlink.'\n        )\n      },\n    })\n  }\n}\n"],"names":["Args","Flags","SanityCommand","subdebug","input","processAliasName","validateDatasetAliasName","promptForDatasetAliasName","listAliases","unlinkAlias","NO_PROJECT_ID","unlinkAliasDebug","UnlinkAliasCommand","args","aliasName","string","description","required","examples","command","flags","force","boolean","run","parse","projectId","getProjectId","error","exit","aliasNameInput","apiName","displayName","nameError","aliases","linkedAlias","find","elem","name","datasetName","warn","confirmUnlink","result","log","Error","message","String","validate","response","toLowerCase","trim"],"mappings":"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"}

package/dist/commands/dataset/copy.js

@@ -0,0 +1,369 @@
+import { styleText } from 'node:util';
+import { Args, Flags } from '@oclif/core';
+import { exit } from '@oclif/core/errors';
+import { SanityCommand, subdebug } from '@sanity/cli-core';
+import { spinner } from '@sanity/cli-core/ux';
+import { Table } from 'console-table-printer';
+import { formatDistance, formatDistanceToNow, parseISO } from 'date-fns';
+import { validateDatasetName } from '../../actions/dataset/validateDatasetName.js';
+import { promptForDataset } from '../../prompts/promptForDataset.js';
+import { promptForDatasetName } from '../../prompts/promptForDatasetName.js';
+import { copyDataset, followCopyJobProgress, listDatasetCopyJobs, listDatasets } from '../../services/datasets.js';
+import { NO_PROJECT_ID } from '../../util/errorMessages.js';
+const copyDatasetDebug = subdebug('dataset:copy');
+export class CopyDatasetCommand extends SanityCommand {
+    static args = {
+        source: Args.string({
+            description: 'Name of the dataset to copy from',
+            required: false
+        }),
+        target: Args.string({
+            description: 'Name of the dataset to copy to',
+            required: false
+        })
+    };
+    static description = 'Manages dataset copying, including starting a new copy job, listing copy jobs and following the progress of a running copy job';
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %>',
+            description: 'Interactively copy a dataset'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> source-dataset',
+            description: 'Copy from source-dataset (prompts for target)'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> source-dataset target-dataset',
+            description: 'Copy from source-dataset to target-dataset'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> --skip-history source target',
+            description: 'Copy without preserving document history (faster for large datasets)'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> --detach source target',
+            description: 'Start copy job without waiting for completion'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> --attach <job-id>',
+            description: 'Attach to a running copy job to follow progress'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> --list',
+            description: 'List all dataset copy jobs'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> --list --offset 2 --limit 10',
+            description: 'List copy jobs with pagination'
+        }
+    ];
+    static flags = {
+        attach: Flags.string({
+            description: 'Attach to the running copy process to show progress',
+            exclusive: [
+                'list',
+                'detach',
+                'skip-history'
+            ],
+            required: false
+        }),
+        detach: Flags.boolean({
+            description: 'Start the copy without waiting for it to finish',
+            exclusive: [
+                'list',
+                'attach'
+            ],
+            required: false
+        }),
+        limit: Flags.integer({
+            dependsOn: [
+                'list'
+            ],
+            description: 'Maximum number of jobs returned (default 10, max 1000)',
+            max: 1000,
+            required: false
+        }),
+        list: Flags.boolean({
+            description: 'Lists all dataset copy jobs',
+            exclusive: [
+                'attach',
+                'detach',
+                'skip-history'
+            ],
+            required: false
+        }),
+        offset: Flags.integer({
+            dependsOn: [
+                'list'
+            ],
+            description: 'Start position in the list of jobs (default 0)',
+            required: false
+        }),
+        'skip-history': Flags.boolean({
+            description: "Don't preserve document history on copy",
+            exclusive: [
+                'list',
+                'attach'
+            ],
+            required: false
+        })
+    };
+    projectId;
+    async run() {
+        const { args, flags } = await this.parse(CopyDatasetCommand);
+        const projectId = await this.getProjectId();
+        if (!projectId) {
+            this.error(NO_PROJECT_ID, {
+                exit: 1
+            });
+        }
+        this.projectId = projectId;
+        // Route to appropriate mode
+        if (flags.list) {
+            return this.handleListMode(flags);
+        }
+        if (flags.attach) {
+            return this.handleAttachMode(flags.attach);
+        }
+        return this.handleCopyMode(args, flags);
+    }
+    displayCopyJobsTable(jobs) {
+        const table = new Table({
+            columns: [
+                {
+                    alignment: 'left',
+                    name: 'id',
+                    title: 'Job ID'
+                },
+                {
+                    alignment: 'left',
+                    name: 'sourceDataset',
+                    title: 'Source Dataset'
+                },
+                {
+                    alignment: 'left',
+                    name: 'targetDataset',
+                    title: 'Target Dataset'
+                },
+                {
+                    alignment: 'left',
+                    name: 'state',
+                    title: 'State'
+                },
+                {
+                    alignment: 'left',
+                    name: 'withHistory',
+                    title: 'With history'
+                },
+                {
+                    alignment: 'left',
+                    name: 'timeStarted',
+                    title: 'Time started'
+                },
+                {
+                    alignment: 'left',
+                    name: 'timeTaken',
+                    title: 'Time taken'
+                }
+            ],
+            title: 'Dataset copy jobs for this project in descending order'
+        });
+        for (const job of jobs){
+            const { createdAt, id, sourceDataset, state, targetDataset, updatedAt, withHistory } = job;
+            let timeStarted = '';
+            if (createdAt !== '') {
+                timeStarted = formatDistanceToNow(parseISO(createdAt));
+            }
+            let timeTaken = '';
+            if (updatedAt !== '') {
+                timeTaken = formatDistance(parseISO(updatedAt), parseISO(createdAt));
+            }
+            let color = '';
+            switch(state){
+                case 'completed':
+                    {
+                        color = 'green';
+                        break;
+                    }
+                case 'failed':
+                    {
+                        color = 'red';
+                        break;
+                    }
+                case 'pending':
+                    {
+                        color = 'yellow';
+                        break;
+                    }
+                default:
+                    {
+                        color = '';
+                    }
+            }
+            table.addRow({
+                id,
+                sourceDataset,
+                state,
+                targetDataset,
+                timeStarted: `${timeStarted} ago`,
+                timeTaken,
+                withHistory
+            }, {
+                color
+            });
+        }
+        table.printTable();
+    }
+    async handleAttachMode(jobId) {
+        copyDatasetDebug('Attaching to copy job %s', jobId);
+        if (!jobId || typeof jobId !== 'string' || jobId.trim() === '') {
+            this.error('Please supply a valid jobId', {
+                exit: 1
+            });
+        }
+        try {
+            await this.subscribeToProgress(jobId);
+            this.log(`Job ${styleText('green', jobId)} completed`);
+        } catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            copyDatasetDebug('Failed to attach to copy job: %s', message, error);
+            this.error(`Failed to attach to copy job: ${message}`, {
+                exit: 1
+            });
+        }
+    }
+    async handleCopyMode(args, flags) {
+        copyDatasetDebug('Starting copy mode');
+        const skipHistory = Boolean(flags['skip-history']);
+        // Get and validate source dataset
+        let sourceDataset = args.source;
+        if (sourceDataset) {
+            const nameError = validateDatasetName(sourceDataset);
+            if (nameError) {
+                this.error(nameError, {
+                    exit: 1
+                });
+            }
+        }
+        let datasetsResponse;
+        try {
+            datasetsResponse = await listDatasets(this.projectId);
+        } catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            copyDatasetDebug('Failed to fetch datasets: %s', message, error);
+            this.error(`Failed to fetch datasets: ${message}`, {
+                exit: 1
+            });
+        }
+        const datasetNames = new Set(datasetsResponse.map((ds)=>ds.name));
+        // Prompt for source if not provided
+        if (!sourceDataset) {
+            sourceDataset = await promptForDataset({
+                datasets: datasetsResponse
+            });
+        }
+        if (!datasetNames.has(sourceDataset)) {
+            this.error(`Source dataset "${sourceDataset}" doesn't exist`, {
+                exit: 1
+            });
+        }
+        // Get and validate target dataset
+        let targetDataset = args.target;
+        if (targetDataset) {
+            const nameError = validateDatasetName(targetDataset);
+            if (nameError) {
+                this.error(nameError, {
+                    exit: 1
+                });
+            }
+        } else {
+            targetDataset = await promptForDatasetName({
+                message: 'Target dataset name:'
+            });
+        }
+        if (datasetNames.has(targetDataset)) {
+            this.error(`Target dataset "${targetDataset}" already exists`, {
+                exit: 1
+            });
+        }
+        // Start the copy job
+        try {
+            this.log(`Copying dataset ${styleText('green', sourceDataset)} to ${styleText('green', targetDataset)}...`);
+            if (!skipHistory) {
+                this.log(`Note: You can run this command with flag '--skip-history'. The flag will reduce copy time in larger datasets.`);
+            }
+            const response = await copyDataset({
+                projectId: this.projectId,
+                skipHistory,
+                sourceDataset,
+                targetDataset
+            });
+            this.log(`Job ${styleText('green', response.jobId)} started`);
+            if (flags.detach) {
+                return;
+            }
+            await this.subscribeToProgress(response.jobId);
+            this.log(`Job ${styleText('green', response.jobId)} completed`);
+        } catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            copyDatasetDebug('Dataset copying failed: %s', message, error);
+            this.error(`Dataset copying failed: ${message}`, {
+                exit: 1
+            });
+        }
+    }
+    async handleListMode(flags) {
+        copyDatasetDebug('Listing dataset copy jobs');
+        try {
+            const jobs = await listDatasetCopyJobs({
+                limit: flags.limit,
+                offset: flags.offset,
+                projectId: this.projectId
+            });
+            if (jobs.length === 0) {
+                this.log("This project doesn't have any dataset copy jobs");
+                return;
+            }
+            this.displayCopyJobsTable(jobs);
+        } catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            copyDatasetDebug('Failed to list dataset copy jobs: %s', message, error);
+            this.error(`Failed to list dataset copy jobs: ${message}`, {
+                exit: 1
+            });
+        }
+    }
+    async subscribeToProgress(jobId) {
+        let currentProgress = 0;
+        const spin = spinner('').start();
+        return new Promise((resolve, reject)=>{
+            const subscription = followCopyJobProgress({
+                jobId,
+                projectId: this.projectId
+            }).subscribe({
+                complete: ()=>{
+                    spin.succeed('Copy finished.');
+                    resolve();
+                },
+                error: (err)=>{
+                    spin.fail('Copy failed.');
+                    reject(err);
+                },
+                next: (event)=>{
+                    if (typeof event.progress === 'number') {
+                        currentProgress = event.progress;
+                    }
+                    spin.text = `Copy in progress: ${currentProgress}%`;
+                }
+            });
+            // Cleanup on process termination - use 'once' to prevent memory leaks
+            process.once('SIGINT', ()=>{
+                subscription.unsubscribe();
+                spin.fail('Copy interrupted.');
+                exit(130);
+            });
+        });
+    }
+}
+
+//# sourceMappingURL=copy.js.map