@sanity/cli 8.22.1 → 8.24.0

package/dist/commands/context/query.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/commands/context/query.ts"],"sourcesContent":["import {Args, Flags} from '@oclif/core'\nimport {type FlagInput} from '@oclif/core/interfaces'\nimport {colorizeJson, exitCodes, SanityCommand, subdebug} from '@sanity/cli-core'\nimport {getErrorMessage} from '@sanity/cli-core/errors'\nimport {isRecord} from '@sanity/cli-core/util'\n\nimport {\n  MissingOrganizationError,\n  resolveOrganizationId,\n} from '../../actions/context/resolveOrganizationId.js'\nimport {queryContext} from '../../services/context.js'\nimport {getOrganizationFlag} from '../../util/sharedFlags.js'\nimport {defineCommandTelemetry} from '../../util/telemetry/commandTelemetry.js'\n\nconst queryContextDebug = subdebug('context:query')\n\nconst flags = {\n  ...getOrganizationFlag({\n    description: 'Organization to query',\n    semantics: 'override',\n  }),\n  params: Flags.custom<Record<string, unknown>>({\n    description: 'Query parameters as a JSON object',\n    helpValue: '<json>',\n    parse: async (input: string) => {\n      let parsed: unknown\n      try {\n        parsed = JSON.parse(input)\n      } catch {\n        throw new Error('`--params` must be valid JSON')\n      }\n      if (!isRecord(parsed)) {\n        throw new Error('`--params` must be a JSON object, like \\'{\"type\": \"issue\"}\\'')\n      }\n      return parsed\n    },\n  })(),\n} satisfies FlagInput\n\nexport class QueryContextCommand extends SanityCommand<typeof QueryContextCommand> {\n  static override args = {\n    query: Args.string({\n      description: \"GROQ query to run against the organization's Context documents\",\n      required: true,\n    }),\n  }\n\n  static override description = \"Query an organization's Context documents with GROQ\"\n\n  static override enableJsonFlag = true\n\n  static override examples = [\n    {\n      command:\n        '<%= config.bin %> <%= command.id %> \\'*[_type == \"sanity.context.issue\" && status == \"open\"]{_id, knowledgeBaseId}\\'',\n      description: 'List open issues across all knowledge bases',\n    },\n    {\n      command:\n        '<%= config.bin %> <%= command.id %> \\'*[_type == \"sanity.context.entry\" && knowledgeBaseId == $kb].path\\' --params \\'{\"kb\": \"kb-abc123\"}\\' --json',\n      description: 'List the entry paths of one knowledge base as plain JSON',\n    },\n  ]\n\n  static override flags = flags\n\n  static telemetry = defineCommandTelemetry(flags, {redact: ['params']})\n\n  public async run(): Promise<void> {\n    const {query} = this.args\n    const {json, organization, params} = this.flags\n\n    let organizationId: string\n    try {\n      organizationId = await resolveOrganizationId({\n        configuredOrganizationId: (await this.tryGetCliConfig()).app?.organizationId,\n        flagOrganizationId: organization,\n        unattended: this.isUnattended(),\n      })\n    } catch (error) {\n      queryContextDebug('Error resolving organization', error)\n      this.error(getErrorMessage(error), {\n        exit:\n          error instanceof MissingOrganizationError\n            ? exitCodes.USAGE_ERROR\n            : exitCodes.RUNTIME_ERROR,\n      })\n    }\n\n    let result\n    try {\n      result = await queryContext(organizationId, query, params)\n    } catch (error) {\n      queryContextDebug('Error running query', error)\n      this.error(`Failed to run query: ${getErrorMessage(error)}`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n\n    // GROQ returns null for no match; guard undefined, which colorizeJson cannot tokenize\n    const output = result ?? null\n    if (json) {\n      this.logJson(output)\n      return\n    }\n\n    this.log(colorizeJson(output))\n  }\n}\n"],"names":["Args","Flags","colorizeJson","exitCodes","SanityCommand","subdebug","getErrorMessage","isRecord","MissingOrganizationError","resolveOrganizationId","queryContext","getOrganizationFlag","defineCommandTelemetry","queryContextDebug","flags","description","semantics","params","custom","helpValue","parse","input","parsed","JSON","Error","QueryContextCommand","args","query","string","required","enableJsonFlag","examples","command","telemetry","redact","run","json","organization","organizationId","configuredOrganizationId","tryGetCliConfig","app","flagOrganizationId","unattended","isUnattended","error","exit","USAGE_ERROR","RUNTIME_ERROR","result","output","logJson","log"],"mappings":"AAAA,SAAQA,IAAI,EAAEC,KAAK,QAAO,cAAa;AAEvC,SAAQC,YAAY,EAAEC,SAAS,EAAEC,aAAa,EAAEC,QAAQ,QAAO,mBAAkB;AACjF,SAAQC,eAAe,QAAO,0BAAyB;AACvD,SAAQC,QAAQ,QAAO,wBAAuB;AAE9C,SACEC,wBAAwB,EACxBC,qBAAqB,QAChB,iDAAgD;AACvD,SAAQC,YAAY,QAAO,4BAA2B;AACtD,SAAQC,mBAAmB,QAAO,4BAA2B;AAC7D,SAAQC,sBAAsB,QAAO,2CAA0C;AAE/E,MAAMC,oBAAoBR,SAAS;AAEnC,MAAMS,QAAQ;IACZ,GAAGH,oBAAoB;QACrBI,aAAa;QACbC,WAAW;IACb,EAAE;IACFC,QAAQhB,MAAMiB,MAAM,CAA0B;QAC5CH,aAAa;QACbI,WAAW;QACXC,OAAO,OAAOC;YACZ,IAAIC;YACJ,IAAI;gBACFA,SAASC,KAAKH,KAAK,CAACC;YACtB,EAAE,OAAM;gBACN,MAAM,IAAIG,MAAM;YAClB;YACA,IAAI,CAACjB,SAASe,SAAS;gBACrB,MAAM,IAAIE,MAAM;YAClB;YACA,OAAOF;QACT;IACF;AACF;AAEA,OAAO,MAAMG,4BAA4BrB;IACvC,OAAgBsB,OAAO;QACrBC,OAAO3B,KAAK4B,MAAM,CAAC;YACjBb,aAAa;YACbc,UAAU;QACZ;IACF,EAAC;IAED,OAAgBd,cAAc,sDAAqD;IAEnF,OAAgBe,iBAAiB,KAAI;IAErC,OAAgBC,WAAW;QACzB;YACEC,SACE;YACFjB,aAAa;QACf;QACA;YACEiB,SACE;YACFjB,aAAa;QACf;KACD,CAAA;IAED,OAAgBD,QAAQA,MAAK;IAE7B,OAAOmB,YAAYrB,uBAAuBE,OAAO;QAACoB,QAAQ;YAAC;SAAS;IAAA,GAAE;IAEtE,MAAaC,MAAqB;QAChC,MAAM,EAACR,KAAK,EAAC,GAAG,IAAI,CAACD,IAAI;QACzB,MAAM,EAACU,IAAI,EAAEC,YAAY,EAAEpB,MAAM,EAAC,GAAG,IAAI,CAACH,KAAK;QAE/C,IAAIwB;QACJ,IAAI;YACFA,iBAAiB,MAAM7B,sBAAsB;gBAC3C8B,0BAA0B,AAAC,CAAA,MAAM,IAAI,CAACC,eAAe,EAAC,EAAGC,GAAG,EAAEH;gBAC9DI,oBAAoBL;gBACpBM,YAAY,IAAI,CAACC,YAAY;YAC/B;QACF,EAAE,OAAOC,OAAO;YACdhC,kBAAkB,gCAAgCgC;YAClD,IAAI,CAACA,KAAK,CAACvC,gBAAgBuC,QAAQ;gBACjCC,MACED,iBAAiBrC,2BACbL,UAAU4C,WAAW,GACrB5C,UAAU6C,aAAa;YAC/B;QACF;QAEA,IAAIC;QACJ,IAAI;YACFA,SAAS,MAAMvC,aAAa4B,gBAAgBX,OAAOV;QACrD,EAAE,OAAO4B,OAAO;YACdhC,kBAAkB,uBAAuBgC;YACzC,IAAI,CAACA,KAAK,CAAC,CAAC,qBAAqB,EAAEvC,gBAAgBuC,QAAQ,EAAE;gBAC3DC,MAAM3C,UAAU6C,aAAa;YAC/B;QACF;QAEA,sFAAsF;QACtF,MAAME,SAASD,UAAU;QACzB,IAAIb,MAAM;YACR,IAAI,CAACe,OAAO,CAACD;YACb;QACF;QAEA,IAAI,CAACE,GAAG,CAAClD,aAAagD;IACxB;AACF"}

package/dist/commands/deploy.js

@@ -86,6 +86,12 @@ export class DeployCommand extends SanityCommand {
             default: false,
             description: 'Output the result as JSON'
         }),
+        'media-library-id': Flags.string({
+            description: 'For a Media Library config deploy: the media library to sync the aspect definitions to. Defaults to the single active library of the configured organization; required when the organization has several',
+            // Part of the beta config-app flow, like the hidden media commands it
+            // pairs with. A help-listed flag is hard to take back — unhide at GA.
+            hidden: true
+        }),
         minify: Flags.boolean({
             allowNo: true,
             default: true,
@@ -120,6 +126,13 @@ export class DeployCommand extends SanityCommand {
         const cliConfig = await this.getCliConfig();
         const projectRoot = await this.getProjectRoot();
         const isApp = determineIsApp(cliConfig);
+        // `--media-library-id` only steers the aspect-document sync of a Media
+        // Library config deploy (see deployApp); studio and app deploys never read
+        // it. Warned rather than silently dropped (same courtesy init gives
+        // --dashboard on the media template).
+        if (flags['media-library-id'] && !resolveWorkbenchConfig(cliConfig)) {
+            this.output.warn('--media-library-id is ignored — it only applies when deploying a Media Library config');
+        }
         if (flags.create) {
             if (!isApp) {
                 return this.output.error('--create is only supported for App SDK apps. For a studio, use --url <hostname>.');

package/dist/commands/deploy.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/commands/deploy.ts"],"sourcesContent":["import path from 'node:path'\n\nimport {Args, Flags} from '@oclif/core'\nimport {exitCodes, SanityCommand} from '@sanity/cli-core'\nimport {confirm} from '@sanity/cli-core/ux'\nimport {getWorkbench, resolveWorkbenchConfig} from '@sanity/workbench-cli/deploy'\n\nimport {deployApp} from '../actions/deploy/deployApp.js'\nimport {deployDebug} from '../actions/deploy/deployDebug.js'\nimport {deployStudio} from '../actions/deploy/deployStudio.js'\nimport {getAppId} from '../util/appId.js'\nimport {determineIsApp} from '../util/determineIsApp.js'\nimport {dirIsEmptyOrNonExistent} from '../util/dirIsEmptyOrNonExistent.js'\n\nexport class DeployCommand extends SanityCommand<typeof DeployCommand> {\n  static override args = {\n    sourceDir: Args.directory({\n      description: 'Source directory',\n    }),\n  }\n\n  static override description = 'Builds and deploys Sanity Studio or application to Sanity hosting'\n\n  static override enableJsonFlag = true\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %>',\n      description: 'Build and deploy the studio to Sanity hosting',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> --no-minify --source-maps',\n      description: 'Deploys non-minified build with source maps',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> --schema-required',\n      description:\n        'Fail fast on schema store fails - for when other services rely on the stored schema',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> --external',\n      description: 'Register an externally hosted studio (studioHost contains full URL)',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> --external --url https://apps.example.com',\n      description: 'Register an externally hosted studio, served from the provided origin',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> --create --title \"My App\" --yes --json',\n      description:\n        'Create and deploy an App SDK app without prompts. Save application.id as deployment.appId, then omit --create on later deploys',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> --create --title \"My App\" --dry-run --json',\n      description: 'Preview a new App SDK deployment without creating or uploading anything',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> --url my-studio --yes',\n      description: 'Deploy a studio without prompts using its hostname',\n    },\n  ]\n\n  static override flags = {\n    'auto-updates': Flags.boolean({\n      allowNo: true,\n      deprecated: true,\n      description: 'Automatically update the studio to the latest version',\n    }),\n    build: Flags.boolean({\n      allowNo: true,\n      default: true,\n      description:\n        'Build the studio before deploying (use --no-build to deploy existing `dist/` output)',\n    }),\n    create: Flags.boolean({\n      description: 'Create a new App SDK app, even if the organization has other apps',\n      exclusive: ['external', 'url'],\n    }),\n    'dry-run': Flags.boolean({\n      default: false,\n      description: 'Report what would be deployed without uploading or creating anything',\n    }),\n    external: Flags.boolean({\n      default: false,\n      description: 'Register an externally hosted studio',\n      exclusive: ['source-maps', 'minify'],\n    }),\n    json: Flags.boolean({\n      char: 'j',\n      default: false,\n      description: 'Output the result as JSON',\n    }),\n    minify: Flags.boolean({\n      allowNo: true,\n      default: true,\n      description: 'Minify built JavaScript (use --no-minify to skip for faster builds)',\n    }),\n    'schema-required': Flags.boolean({\n      default: false,\n      description: 'Fail if schema deployment fails',\n    }),\n    'source-maps': Flags.boolean({\n      default: false,\n      description: 'Enable source maps for built bundles (increases size of bundle)',\n    }),\n    title: Flags.string({\n      description:\n        'Title for a newly created application or studio. For apps, use --create to select creation when the organization already has apps',\n    }),\n    url: Flags.string({\n      description:\n        'Studio URL for deployment. For external deploys, the full URL. For hosted studios, the hostname (e.g. \"my-studio\" or \"my-studio.sanity.studio\")',\n    }),\n    verbose: Flags.boolean({\n      default: false,\n      description: 'Enable verbose logging',\n    }),\n    yes: Flags.boolean({\n      char: 'y',\n      default: false,\n      description:\n        'Unattended mode, answers \"yes\" to any \"yes/no\" prompt and otherwise uses defaults',\n    }),\n  }\n\n  public async run(): Promise<void> {\n    const {flags} = await this.parse(DeployCommand)\n\n    const cliConfig = await this.getCliConfig()\n    const projectRoot = await this.getProjectRoot()\n\n    const isApp = determineIsApp(cliConfig)\n\n    if (flags.create) {\n      if (!isApp) {\n        return this.output.error(\n          '--create is only supported for App SDK apps. For a studio, use --url <hostname>.',\n        )\n      }\n      if (getAppId(cliConfig)) {\n        return this.output.error(\n          '--create cannot be used with a configured app ID. Omit --create to deploy to that app, or remove deployment.appId and app.id to create a new one.',\n        )\n      }\n      if (getWorkbench(cliConfig) || resolveWorkbenchConfig(cliConfig)) {\n        return this.output.error(\n          '--create is not supported for this app configuration. Omit --create and run sanity deploy.',\n        )\n      }\n    }\n\n    const defaultOutputDir = path.resolve(path.join(projectRoot.directory, 'dist'))\n    const sourceDir = path.resolve(process.cwd(), this.args.sourceDir || defaultOutputDir)\n\n    // Skip the directory check if the studio is externally hosted\n    if (this.args.sourceDir && this.args.sourceDir !== 'dist' && !flags.external) {\n      let relativeOutput = path.relative(process.cwd(), sourceDir)\n      if (relativeOutput[0] !== '.') {\n        relativeOutput = `./${relativeOutput}`\n      }\n\n      if (!this.isUnattended() && !flags['dry-run']) {\n        const isEmpty = await dirIsEmptyOrNonExistent(sourceDir)\n        const shouldProceed =\n          isEmpty ||\n          (await confirm({\n            default: false,\n            message: `\"${relativeOutput}\" is not empty, do you want to proceed?`,\n          }))\n\n        if (!shouldProceed) {\n          this.output.error('Cancelled.', {exit: exitCodes.RUNTIME_ERROR})\n        }\n      }\n\n      // Keep --json's stdout clean for the payload\n      if (!flags.json) this.output.log(`Building to ${relativeOutput}\\n`)\n    }\n\n    // Force yes downstream: build/app resolution otherwise prompts for prerelease/version choices\n    const deployFlags = this.isUnattended() || flags['dry-run'] ? {...flags, yes: true} : flags\n\n    if (isApp) {\n      deployDebug('Deploying app')\n      await deployApp({\n        cliConfig,\n        flags: deployFlags,\n        output: this.output,\n        projectRoot,\n        sourceDir,\n      })\n    } else {\n      deployDebug('Deploying studio')\n      await deployStudio({\n        cliConfig,\n        flags: deployFlags,\n        output: this.output,\n        projectRoot,\n        sourceDir,\n      })\n    }\n  }\n}\n"],"names":["path","Args","Flags","exitCodes","SanityCommand","confirm","getWorkbench","resolveWorkbenchConfig","deployApp","deployDebug","deployStudio","getAppId","determineIsApp","dirIsEmptyOrNonExistent","DeployCommand","args","sourceDir","directory","description","enableJsonFlag","examples","command","flags","boolean","allowNo","deprecated","build","default","create","exclusive","external","json","char","minify","title","string","url","verbose","yes","run","parse","cliConfig","getCliConfig","projectRoot","getProjectRoot","isApp","output","error","defaultOutputDir","resolve","join","process","cwd","relativeOutput","relative","isUnattended","isEmpty","shouldProceed","message","exit","RUNTIME_ERROR","log","deployFlags"],"mappings":"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"}
+{"version":3,"sources":["../../src/commands/deploy.ts"],"sourcesContent":["import path from 'node:path'\n\nimport {Args, Flags} from '@oclif/core'\nimport {exitCodes, SanityCommand} from '@sanity/cli-core'\nimport {confirm} from '@sanity/cli-core/ux'\nimport {getWorkbench, resolveWorkbenchConfig} from '@sanity/workbench-cli/deploy'\n\nimport {deployApp} from '../actions/deploy/deployApp.js'\nimport {deployDebug} from '../actions/deploy/deployDebug.js'\nimport {deployStudio} from '../actions/deploy/deployStudio.js'\nimport {getAppId} from '../util/appId.js'\nimport {determineIsApp} from '../util/determineIsApp.js'\nimport {dirIsEmptyOrNonExistent} from '../util/dirIsEmptyOrNonExistent.js'\n\nexport class DeployCommand extends SanityCommand<typeof DeployCommand> {\n  static override args = {\n    sourceDir: Args.directory({\n      description: 'Source directory',\n    }),\n  }\n\n  static override description = 'Builds and deploys Sanity Studio or application to Sanity hosting'\n\n  static override enableJsonFlag = true\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %>',\n      description: 'Build and deploy the studio to Sanity hosting',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> --no-minify --source-maps',\n      description: 'Deploys non-minified build with source maps',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> --schema-required',\n      description:\n        'Fail fast on schema store fails - for when other services rely on the stored schema',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> --external',\n      description: 'Register an externally hosted studio (studioHost contains full URL)',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> --external --url https://apps.example.com',\n      description: 'Register an externally hosted studio, served from the provided origin',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> --create --title \"My App\" --yes --json',\n      description:\n        'Create and deploy an App SDK app without prompts. Save application.id as deployment.appId, then omit --create on later deploys',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> --create --title \"My App\" --dry-run --json',\n      description: 'Preview a new App SDK deployment without creating or uploading anything',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> --url my-studio --yes',\n      description: 'Deploy a studio without prompts using its hostname',\n    },\n  ]\n\n  static override flags = {\n    'auto-updates': Flags.boolean({\n      allowNo: true,\n      deprecated: true,\n      description: 'Automatically update the studio to the latest version',\n    }),\n    build: Flags.boolean({\n      allowNo: true,\n      default: true,\n      description:\n        'Build the studio before deploying (use --no-build to deploy existing `dist/` output)',\n    }),\n    create: Flags.boolean({\n      description: 'Create a new App SDK app, even if the organization has other apps',\n      exclusive: ['external', 'url'],\n    }),\n    'dry-run': Flags.boolean({\n      default: false,\n      description: 'Report what would be deployed without uploading or creating anything',\n    }),\n    external: Flags.boolean({\n      default: false,\n      description: 'Register an externally hosted studio',\n      exclusive: ['source-maps', 'minify'],\n    }),\n    json: Flags.boolean({\n      char: 'j',\n      default: false,\n      description: 'Output the result as JSON',\n    }),\n    'media-library-id': Flags.string({\n      description:\n        'For a Media Library config deploy: the media library to sync the aspect definitions to. Defaults to the single active library of the configured organization; required when the organization has several',\n      // Part of the beta config-app flow, like the hidden media commands it\n      // pairs with. A help-listed flag is hard to take back — unhide at GA.\n      hidden: true,\n    }),\n    minify: Flags.boolean({\n      allowNo: true,\n      default: true,\n      description: 'Minify built JavaScript (use --no-minify to skip for faster builds)',\n    }),\n    'schema-required': Flags.boolean({\n      default: false,\n      description: 'Fail if schema deployment fails',\n    }),\n    'source-maps': Flags.boolean({\n      default: false,\n      description: 'Enable source maps for built bundles (increases size of bundle)',\n    }),\n    title: Flags.string({\n      description:\n        'Title for a newly created application or studio. For apps, use --create to select creation when the organization already has apps',\n    }),\n    url: Flags.string({\n      description:\n        'Studio URL for deployment. For external deploys, the full URL. For hosted studios, the hostname (e.g. \"my-studio\" or \"my-studio.sanity.studio\")',\n    }),\n    verbose: Flags.boolean({\n      default: false,\n      description: 'Enable verbose logging',\n    }),\n    yes: Flags.boolean({\n      char: 'y',\n      default: false,\n      description:\n        'Unattended mode, answers \"yes\" to any \"yes/no\" prompt and otherwise uses defaults',\n    }),\n  }\n\n  public async run(): Promise<void> {\n    const {flags} = await this.parse(DeployCommand)\n\n    const cliConfig = await this.getCliConfig()\n    const projectRoot = await this.getProjectRoot()\n\n    const isApp = determineIsApp(cliConfig)\n\n    // `--media-library-id` only steers the aspect-document sync of a Media\n    // Library config deploy (see deployApp); studio and app deploys never read\n    // it. Warned rather than silently dropped (same courtesy init gives\n    // --dashboard on the media template).\n    if (flags['media-library-id'] && !resolveWorkbenchConfig(cliConfig)) {\n      this.output.warn(\n        '--media-library-id is ignored — it only applies when deploying a Media Library config',\n      )\n    }\n\n    if (flags.create) {\n      if (!isApp) {\n        return this.output.error(\n          '--create is only supported for App SDK apps. For a studio, use --url <hostname>.',\n        )\n      }\n      if (getAppId(cliConfig)) {\n        return this.output.error(\n          '--create cannot be used with a configured app ID. Omit --create to deploy to that app, or remove deployment.appId and app.id to create a new one.',\n        )\n      }\n      if (getWorkbench(cliConfig) || resolveWorkbenchConfig(cliConfig)) {\n        return this.output.error(\n          '--create is not supported for this app configuration. Omit --create and run sanity deploy.',\n        )\n      }\n    }\n\n    const defaultOutputDir = path.resolve(path.join(projectRoot.directory, 'dist'))\n    const sourceDir = path.resolve(process.cwd(), this.args.sourceDir || defaultOutputDir)\n\n    // Skip the directory check if the studio is externally hosted\n    if (this.args.sourceDir && this.args.sourceDir !== 'dist' && !flags.external) {\n      let relativeOutput = path.relative(process.cwd(), sourceDir)\n      if (relativeOutput[0] !== '.') {\n        relativeOutput = `./${relativeOutput}`\n      }\n\n      if (!this.isUnattended() && !flags['dry-run']) {\n        const isEmpty = await dirIsEmptyOrNonExistent(sourceDir)\n        const shouldProceed =\n          isEmpty ||\n          (await confirm({\n            default: false,\n            message: `\"${relativeOutput}\" is not empty, do you want to proceed?`,\n          }))\n\n        if (!shouldProceed) {\n          this.output.error('Cancelled.', {exit: exitCodes.RUNTIME_ERROR})\n        }\n      }\n\n      // Keep --json's stdout clean for the payload\n      if (!flags.json) this.output.log(`Building to ${relativeOutput}\\n`)\n    }\n\n    // Force yes downstream: build/app resolution otherwise prompts for prerelease/version choices\n    const deployFlags = this.isUnattended() || flags['dry-run'] ? {...flags, yes: true} : flags\n\n    if (isApp) {\n      deployDebug('Deploying app')\n      await deployApp({\n        cliConfig,\n        flags: deployFlags,\n        output: this.output,\n        projectRoot,\n        sourceDir,\n      })\n    } else {\n      deployDebug('Deploying studio')\n      await deployStudio({\n        cliConfig,\n        flags: deployFlags,\n        output: this.output,\n        projectRoot,\n        sourceDir,\n      })\n    }\n  }\n}\n"],"names":["path","Args","Flags","exitCodes","SanityCommand","confirm","getWorkbench","resolveWorkbenchConfig","deployApp","deployDebug","deployStudio","getAppId","determineIsApp","dirIsEmptyOrNonExistent","DeployCommand","args","sourceDir","directory","description","enableJsonFlag","examples","command","flags","boolean","allowNo","deprecated","build","default","create","exclusive","external","json","char","string","hidden","minify","title","url","verbose","yes","run","parse","cliConfig","getCliConfig","projectRoot","getProjectRoot","isApp","output","warn","error","defaultOutputDir","resolve","join","process","cwd","relativeOutput","relative","isUnattended","isEmpty","shouldProceed","message","exit","RUNTIME_ERROR","log","deployFlags"],"mappings":"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"}

package/dist/commands/media/prune-aspect-data.js

@@ -0,0 +1,170 @@
+import { styleText } from 'node:util';
+import { Args, Flags } from '@oclif/core';
+import { exitCodes, ProjectRootNotFoundError, SanityCommand, subdebug } from '@sanity/cli-core';
+import { getErrorMessage } from '@sanity/cli-core/errors';
+import { logSymbols, spinner } from '@sanity/cli-core/ux';
+import { resolveWorkbenchConfig } from '@sanity/workbench-cli/deploy';
+import { VALID_ASPECT_NAME } from '../../actions/media/aspectName.js';
+import { resolveMediaLibraryId } from '../../actions/media/resolveMediaLibraryId.js';
+import { getAspectDataCarrierIds, getStoredAspectIds, unsetAspectData } from '../../services/mediaLibraries.js';
+import { pluralize } from '../../util/pluralize.js';
+const pruneAspectDataDebug = subdebug('media:prune-aspect-data');
+const NOT_A_CONFIG_APP = 'This command must be run inside a Media Library config app — a project whose ' + '`sanity.cli.ts` declares `unstable_defineMediaLibrary(...)`. Scaffold one with ' + '`sanity init --template media-library-config`.';
+/** Unset-patch batch size per mutate request. */ const BATCH_SIZE = 100;
+/** How many carrier ids the report lists before truncating. */ const SAMPLE_SIZE = 10;
+/**
+ * The deliberate, explicitly-invoked counterpart to the deploy-time aspect
+ * sync: deploying a config only mirrors aspect *definitions* — `aspects.<name>`
+ * values on assets are never touched and resurface if a matching field comes
+ * back. This command removes that data. Irreversible fan-out mutation, so it
+ * never asks for confirmation: without `--yes` it only reports what would change.
+ */ export class MediaPruneAspectDataCommand extends SanityCommand {
+    static args = {
+        aspectName: Args.string({
+            description: 'Name of the aspect whose data to remove from all assets',
+            required: true
+        })
+    };
+    static description = "Irreversibly remove an aspect's data (aspects.<name> values) from every asset of a media library";
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %> legacyAspect',
+            description: 'Report which assets carry aspects.legacyAspect (changes nothing)'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> legacyAspect --yes',
+            description: 'Remove aspects.legacyAspect from every asset that carries it'
+        }
+    ];
+    static flags = {
+        'media-library-id': Flags.string({
+            description: 'The id of the media library to prune (defaults to the single active library of the configured organization)'
+        }),
+        yes: Flags.boolean({
+            char: 'y',
+            description: 'Execute the prune. Without this flag the command only reports what would change'
+        })
+    };
+    // Part of the beta config-app flow: the command requires a config app to
+    // resolve its organization, so listing it in the general help would only
+    // route legacy-flow users into the beta paradigm. The prune itself is
+    // paradigm-neutral (it only unsets asset data) — when there is demand from
+    // the legacy flow, ungate it from the config app and unhide it.
+    static hidden = true;
+    async run() {
+        const { aspectName } = this.args;
+        const { 'media-library-id': mediaLibraryIdFlag, yes = false } = this.flags;
+        // The name rule shared with the sync contract; also makes the
+        // interpolation into the carrier GROQ filter injection-safe.
+        if (!VALID_ASPECT_NAME.test(aspectName)) {
+            this.error(`"${aspectName}" is not a valid aspect name (${VALID_ASPECT_NAME})`, {
+                exit: exitCodes.USAGE_ERROR
+            });
+        }
+        let cliConfig;
+        try {
+            cliConfig = await this.getCliConfig();
+        } catch (err) {
+            if (err instanceof ProjectRootNotFoundError) {
+                this.error(NOT_A_CONFIG_APP, {
+                    exit: exitCodes.RUNTIME_ERROR
+                });
+            }
+            throw err;
+        }
+        const config = resolveWorkbenchConfig(cliConfig);
+        if (!config) {
+            this.error(NOT_A_CONFIG_APP, {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+        try {
+            // Not `isUnattended()`: that treats `--yes` as unattended, but here
+            // `--yes` consents to the prune, not to skipping prompts — the report
+            // path literally instructs "Re-run with --yes", and that run must still
+            // offer the library picker in a multi-library organization. Only a
+            // genuinely non-interactive run (CI, piped stdin) must not prompt.
+            const mediaLibraryId = await resolveMediaLibraryId({
+                mediaLibraryIdFlag,
+                organizationId: config.organizationId,
+                unattended: !this.resolveIsInteractive()
+            });
+            const spin = spinner('Finding assets that carry the aspect').start();
+            let storedIds;
+            let carriers;
+            try {
+                storedIds = await getStoredAspectIds(mediaLibraryId, 'prune-aspect-data');
+                carriers = await getAspectDataCarrierIds(mediaLibraryId, aspectName);
+            } finally{
+                // Also on failure — a spinner left running garbles the error output.
+                spin.stop();
+            }
+            // Guardrails, not gates: pruning while either is true can be deliberate
+            // (e.g. clearing data before re-shaping a field), so warn and continue.
+            if (config.fields.some((field)=>field.name === aspectName)) {
+                this.warn(`"${aspectName}" is still declared in sanity.cli.ts — its data is likely in active use and will grow back.`);
+            }
+            if (storedIds.includes(aspectName)) {
+                this.warn(`Aspect definition "${aspectName}" still exists in the library — this only removes data, not the definition.`);
+            }
+            if (carriers.length === 0) {
+                this.log(`No assets in media library ${styleText('bold', mediaLibraryId)} carry ${styleText('bold', `aspects.${aspectName}`)} — nothing to prune.`);
+                return;
+            }
+            const sample = carriers.slice(0, SAMPLE_SIZE);
+            // "documents", not "assets": under the raw perspective drafts and
+            // release versions are separate ids, so an asset count would overstate.
+            this.log(`${styleText('bold', String(carriers.length))} ${pluralize('document', carriers.length)} in media library ${styleText('bold', mediaLibraryId)} ${carriers.length === 1 ? 'carries' : 'carry'} ${styleText('bold', `aspects.${aspectName}`)}:`);
+            for (const id of sample){
+                this.log(`  - ${id}`);
+            }
+            if (carriers.length > sample.length) {
+                this.log(styleText('dim', `  … and ${carriers.length - sample.length} more`));
+            }
+            if (!yes) {
+                this.log('');
+                this.log(`This would ${styleText('bold', 'irreversibly')} unset aspects.${aspectName} on all of them. Re-run with ${styleText('bold', '--yes')} to execute.`);
+                return;
+            }
+            let pruned = 0;
+            for(let offset = 0; offset < carriers.length; offset += BATCH_SIZE){
+                const batch = carriers.slice(offset, offset + BATCH_SIZE);
+                try {
+                    await unsetAspectData({
+                        aspectName,
+                        assetIds: batch,
+                        mediaLibraryId
+                    });
+                } catch (batchError) {
+                    // The progress made so far must survive into the error: re-running
+                    // is safe (pruned assets no longer match the carrier query), so the
+                    // message says how far it got and that a retry finishes the rest.
+                    throw new Error(`Removed aspects.${aspectName} from ${pruned} of ${carriers.length} ${pluralize('document', carriers.length)} before a batch failed: ${getErrorMessage(batchError)}\n` + `Re-running the command with --yes is safe — already-pruned documents no longer ` + `match and only the remaining ${carriers.length - pruned} will be mutated.`, {
+                        cause: batchError
+                    });
+                }
+                pruned += batch.length;
+                this.log(styleText('dim', `  pruned ${pruned}/${carriers.length}`));
+            }
+            this.log('');
+            this.log(`${logSymbols.success} aspects.${aspectName} removed from ${pruned} ${pluralize('document', pruned)}.`);
+        } catch (error) {
+            const err = error;
+            // Ctrl+C in the library prompt and errors that already carry their exit
+            // story (`this.error`, CLIError from the resolver) pass through to
+            // `SanityCommand.catch` instead of being re-wrapped here.
+            if (err.name === 'ExitPromptError' || 'oclif' in err) {
+                throw err;
+            }
+            pruneAspectDataDebug('Failed to prune aspect data', {
+                aspectName,
+                error: err
+            });
+            this.error(styleText('bold', 'Failed to prune aspect data') + `\n\n${styleText('red', err.message)}`, {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+    }
+}
+
+//# sourceMappingURL=prune-aspect-data.js.map

package/dist/commands/media/prune-aspect-data.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/commands/media/prune-aspect-data.ts"],"sourcesContent":["import {styleText} from 'node:util'\n\nimport {Args, Flags} from '@oclif/core'\nimport {\n  type CliConfig,\n  exitCodes,\n  ProjectRootNotFoundError,\n  SanityCommand,\n  subdebug,\n} from '@sanity/cli-core'\nimport {getErrorMessage} from '@sanity/cli-core/errors'\nimport {logSymbols, spinner} from '@sanity/cli-core/ux'\nimport {resolveWorkbenchConfig} from '@sanity/workbench-cli/deploy'\n\nimport {VALID_ASPECT_NAME} from '../../actions/media/aspectName.js'\nimport {resolveMediaLibraryId} from '../../actions/media/resolveMediaLibraryId.js'\nimport {\n  getAspectDataCarrierIds,\n  getStoredAspectIds,\n  unsetAspectData,\n} from '../../services/mediaLibraries.js'\nimport {pluralize} from '../../util/pluralize.js'\n\nconst pruneAspectDataDebug = subdebug('media:prune-aspect-data')\n\nconst NOT_A_CONFIG_APP =\n  'This command must be run inside a Media Library config app — a project whose ' +\n  '`sanity.cli.ts` declares `unstable_defineMediaLibrary(...)`. Scaffold one with ' +\n  '`sanity init --template media-library-config`.'\n\n/** Unset-patch batch size per mutate request. */\nconst BATCH_SIZE = 100\n\n/** How many carrier ids the report lists before truncating. */\nconst SAMPLE_SIZE = 10\n\n/**\n * The deliberate, explicitly-invoked counterpart to the deploy-time aspect\n * sync: deploying a config only mirrors aspect *definitions* — `aspects.<name>`\n * values on assets are never touched and resurface if a matching field comes\n * back. This command removes that data. Irreversible fan-out mutation, so it\n * never asks for confirmation: without `--yes` it only reports what would change.\n */\nexport class MediaPruneAspectDataCommand extends SanityCommand<typeof MediaPruneAspectDataCommand> {\n  static override args = {\n    aspectName: Args.string({\n      description: 'Name of the aspect whose data to remove from all assets',\n      required: true,\n    }),\n  }\n\n  static override description =\n    \"Irreversibly remove an aspect's data (aspects.<name> values) from every asset of a media library\"\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %> legacyAspect',\n      description: 'Report which assets carry aspects.legacyAspect (changes nothing)',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> legacyAspect --yes',\n      description: 'Remove aspects.legacyAspect from every asset that carries it',\n    },\n  ]\n\n  static override flags = {\n    'media-library-id': Flags.string({\n      description:\n        'The id of the media library to prune (defaults to the single active library of the configured organization)',\n    }),\n    yes: Flags.boolean({\n      char: 'y',\n      description:\n        'Execute the prune. Without this flag the command only reports what would change',\n    }),\n  }\n\n  // Part of the beta config-app flow: the command requires a config app to\n  // resolve its organization, so listing it in the general help would only\n  // route legacy-flow users into the beta paradigm. The prune itself is\n  // paradigm-neutral (it only unsets asset data) — when there is demand from\n  // the legacy flow, ungate it from the config app and unhide it.\n  static override hidden = true\n\n  public async run(): Promise<void> {\n    const {aspectName} = this.args\n    const {'media-library-id': mediaLibraryIdFlag, yes = false} = this.flags\n\n    // The name rule shared with the sync contract; also makes the\n    // interpolation into the carrier GROQ filter injection-safe.\n    if (!VALID_ASPECT_NAME.test(aspectName)) {\n      this.error(`\"${aspectName}\" is not a valid aspect name (${VALID_ASPECT_NAME})`, {\n        exit: exitCodes.USAGE_ERROR,\n      })\n    }\n\n    let cliConfig: CliConfig\n    try {\n      cliConfig = await this.getCliConfig()\n    } catch (err) {\n      if (err instanceof ProjectRootNotFoundError) {\n        this.error(NOT_A_CONFIG_APP, {exit: exitCodes.RUNTIME_ERROR})\n      }\n      throw err\n    }\n\n    const config = resolveWorkbenchConfig(cliConfig)\n    if (!config) {\n      this.error(NOT_A_CONFIG_APP, {exit: exitCodes.RUNTIME_ERROR})\n    }\n\n    try {\n      // Not `isUnattended()`: that treats `--yes` as unattended, but here\n      // `--yes` consents to the prune, not to skipping prompts — the report\n      // path literally instructs \"Re-run with --yes\", and that run must still\n      // offer the library picker in a multi-library organization. Only a\n      // genuinely non-interactive run (CI, piped stdin) must not prompt.\n      const mediaLibraryId = await resolveMediaLibraryId({\n        mediaLibraryIdFlag,\n        organizationId: config.organizationId,\n        unattended: !this.resolveIsInteractive(),\n      })\n\n      const spin = spinner('Finding assets that carry the aspect').start()\n      let storedIds: string[]\n      let carriers: string[]\n      try {\n        storedIds = await getStoredAspectIds(mediaLibraryId, 'prune-aspect-data')\n        carriers = await getAspectDataCarrierIds(mediaLibraryId, aspectName)\n      } finally {\n        // Also on failure — a spinner left running garbles the error output.\n        spin.stop()\n      }\n\n      // Guardrails, not gates: pruning while either is true can be deliberate\n      // (e.g. clearing data before re-shaping a field), so warn and continue.\n      if (config.fields.some((field) => field.name === aspectName)) {\n        this.warn(\n          `\"${aspectName}\" is still declared in sanity.cli.ts — its data is likely in active use and will grow back.`,\n        )\n      }\n      if (storedIds.includes(aspectName)) {\n        this.warn(\n          `Aspect definition \"${aspectName}\" still exists in the library — this only removes data, not the definition.`,\n        )\n      }\n\n      if (carriers.length === 0) {\n        this.log(\n          `No assets in media library ${styleText('bold', mediaLibraryId)} carry ${styleText(\n            'bold',\n            `aspects.${aspectName}`,\n          )} — nothing to prune.`,\n        )\n        return\n      }\n\n      const sample = carriers.slice(0, SAMPLE_SIZE)\n      // \"documents\", not \"assets\": under the raw perspective drafts and\n      // release versions are separate ids, so an asset count would overstate.\n      this.log(\n        `${styleText('bold', String(carriers.length))} ${pluralize(\n          'document',\n          carriers.length,\n        )} in media library ${styleText('bold', mediaLibraryId)} ${\n          carriers.length === 1 ? 'carries' : 'carry'\n        } ${styleText('bold', `aspects.${aspectName}`)}:`,\n      )\n      for (const id of sample) {\n        this.log(`  - ${id}`)\n      }\n      if (carriers.length > sample.length) {\n        this.log(styleText('dim', `  … and ${carriers.length - sample.length} more`))\n      }\n\n      if (!yes) {\n        this.log('')\n        this.log(\n          `This would ${styleText(\n            'bold',\n            'irreversibly',\n          )} unset aspects.${aspectName} on all of them. Re-run with ${styleText(\n            'bold',\n            '--yes',\n          )} to execute.`,\n        )\n        return\n      }\n\n      let pruned = 0\n      for (let offset = 0; offset < carriers.length; offset += BATCH_SIZE) {\n        const batch = carriers.slice(offset, offset + BATCH_SIZE)\n        try {\n          await unsetAspectData({aspectName, assetIds: batch, mediaLibraryId})\n        } catch (batchError) {\n          // The progress made so far must survive into the error: re-running\n          // is safe (pruned assets no longer match the carrier query), so the\n          // message says how far it got and that a retry finishes the rest.\n          throw new Error(\n            `Removed aspects.${aspectName} from ${pruned} of ${carriers.length} ${pluralize(\n              'document',\n              carriers.length,\n            )} before a batch failed: ${getErrorMessage(batchError)}\\n` +\n              `Re-running the command with --yes is safe — already-pruned documents no longer ` +\n              `match and only the remaining ${carriers.length - pruned} will be mutated.`,\n            {cause: batchError},\n          )\n        }\n        pruned += batch.length\n        this.log(styleText('dim', `  pruned ${pruned}/${carriers.length}`))\n      }\n\n      this.log('')\n      this.log(\n        `${logSymbols.success} aspects.${aspectName} removed from ${pruned} ${pluralize(\n          'document',\n          pruned,\n        )}.`,\n      )\n    } catch (error) {\n      const err = error as Error\n      // Ctrl+C in the library prompt and errors that already carry their exit\n      // story (`this.error`, CLIError from the resolver) pass through to\n      // `SanityCommand.catch` instead of being re-wrapped here.\n      if (err.name === 'ExitPromptError' || 'oclif' in err) {\n        throw err\n      }\n      pruneAspectDataDebug('Failed to prune aspect data', {\n        aspectName,\n        error: err,\n      })\n      this.error(\n        styleText('bold', 'Failed to prune aspect data') + `\\n\\n${styleText('red', err.message)}`,\n        {exit: exitCodes.RUNTIME_ERROR},\n      )\n    }\n  }\n}\n"],"names":["styleText","Args","Flags","exitCodes","ProjectRootNotFoundError","SanityCommand","subdebug","getErrorMessage","logSymbols","spinner","resolveWorkbenchConfig","VALID_ASPECT_NAME","resolveMediaLibraryId","getAspectDataCarrierIds","getStoredAspectIds","unsetAspectData","pluralize","pruneAspectDataDebug","NOT_A_CONFIG_APP","BATCH_SIZE","SAMPLE_SIZE","MediaPruneAspectDataCommand","args","aspectName","string","description","required","examples","command","flags","yes","boolean","char","hidden","run","mediaLibraryIdFlag","test","error","exit","USAGE_ERROR","cliConfig","getCliConfig","err","RUNTIME_ERROR","config","mediaLibraryId","organizationId","unattended","resolveIsInteractive","spin","start","storedIds","carriers","stop","fields","some","field","name","warn","includes","length","log","sample","slice","String","id","pruned","offset","batch","assetIds","batchError","Error","cause","success","message"],"mappings":"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"}

package/dist/commands/media/pull-aspects.js

@@ -0,0 +1,309 @@
+import { access, mkdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { styleText } from 'node:util';
+import { Flags } from '@oclif/core';
+import { exitCodes, ProjectRootNotFoundError, SanityCommand, subdebug } from '@sanity/cli-core';
+import { confirm, logSymbols, spinner } from '@sanity/cli-core/ux';
+import { resolveWorkbenchConfig } from '@sanity/workbench-cli/deploy';
+import { appendFieldEntries } from '../../actions/media/cliConfigFields.js';
+import { convertAspectDocuments, formatFieldEntries } from '../../actions/media/pullAspects.js';
+import { resolveMediaLibraryId } from '../../actions/media/resolveMediaLibraryId.js';
+import { getAspects } from '../../services/mediaLibraries.js';
+import { pluralize } from '../../util/pluralize.js';
+import { defineCommandTelemetry } from '../../util/telemetry/commandTelemetry.js';
+const pullAspectsDebug = subdebug('media:pull-aspects');
+const NOT_A_CONFIG_APP = 'This command must be run inside a Media Library config app — a project whose ' + '`sanity.cli.ts` declares `unstable_defineMediaLibrary(...)`. Scaffold one with ' + '`sanity init --template media-library-config`.';
+const flags = {
+    'media-library-id': Flags.string({
+        description: 'The id of the media library to pull from (defaults to the single active library of the configured organization)'
+    }),
+    'out-dir': Flags.string({
+        default: 'src/fields',
+        description: 'Directory to write the generated field modules to, relative to the project root'
+    }),
+    overwrite: Flags.boolean({
+        description: 'Overwrite existing field modules and re-generate fields already declared in the config'
+    }),
+    'update-config': Flags.boolean({
+        allowNo: true,
+        description: 'Declare the generated fields in sanity.cli.ts (--no-update-config to skip). Prompted when omitted; unattended runs only print the entries'
+    })
+};
+export class MediaPullAspectsCommand extends SanityCommand {
+    static description = "Generate field modules from a media library's stored aspect documents";
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %>',
+            description: 'Generate src/fields/<name>.tsx modules from the stored aspects'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> --media-library-id ml123 --overwrite',
+            description: 'Pull from a specific media library, overwriting existing modules'
+        }
+    ];
+    static flags = flags;
+    // Part of the beta config-app flow: only usable inside a config app (like
+    // the unlisted media-library-config init template, which points to it), and
+    // listing it next to the legacy aspect commands would mix the two
+    // paradigms. Unhide when the config app leaves beta.
+    static hidden = true;
+    // --out-dir is a local filesystem path.
+    static telemetry = defineCommandTelemetry(flags, {
+        redact: [
+            'out-dir'
+        ]
+    });
+    async run() {
+        const { 'media-library-id': mediaLibraryIdFlag, 'out-dir': outDir, overwrite = false } = this.flags;
+        let cliConfig;
+        try {
+            cliConfig = await this.getCliConfig();
+        } catch (err) {
+            if (err instanceof ProjectRootNotFoundError) {
+                this.error(NOT_A_CONFIG_APP, {
+                    exit: exitCodes.RUNTIME_ERROR
+                });
+            }
+            throw err;
+        }
+        const config = resolveWorkbenchConfig(cliConfig);
+        if (!config) {
+            this.error(NOT_A_CONFIG_APP, {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+        const root = await this.getProjectRoot();
+        // The generated `src:` entries and the ownership story both assume the
+        // modules live inside the project; a path escaping the root is a mistake.
+        // `outDirRelative` (not the raw flag) feeds the report so an absolute
+        // --out-dir inside the root still prints proper relative `src:` entries.
+        const outDirAbsolute = path.resolve(root.directory, outDir);
+        const outDirRelative = path.relative(root.directory, outDirAbsolute);
+        if (path.isAbsolute(outDirRelative) || outDirRelative === '..' || outDirRelative.startsWith(`..${path.sep}`)) {
+            this.error(`--out-dir must stay inside the project root (got "${outDir}")`, {
+                exit: exitCodes.USAGE_ERROR
+            });
+        }
+        try {
+            const mediaLibraryId = await resolveMediaLibraryId({
+                mediaLibraryIdFlag,
+                organizationId: config.organizationId,
+                unattended: this.isUnattended()
+            });
+            const spin = spinner('Fetching stored aspect documents').start();
+            let documents;
+            try {
+                documents = await getAspects(mediaLibraryId);
+            } finally{
+                // Also on failure — a spinner left running garbles the error output.
+                spin.stop();
+            }
+            if (documents.length === 0) {
+                this.log(`Media library ${styleText('bold', mediaLibraryId)} has no stored aspects — nothing to pull.`);
+                return;
+            }
+            // Names already declared in the config are owned by existing field
+            // modules; pulling the stored mirror back over them would regress local
+            // edits, so they are skipped unless --overwrite says otherwise.
+            const configuredNames = new Set(config.fields.map((field)=>field.name));
+            const configuredSrcByName = new Map(config.fields.map((field)=>[
+                    field.name,
+                    field.src
+                ]));
+            // One module per field name; name collisions and invalid documents are skipped.
+            const { modules: winners, skipped } = convertAspectDocuments(documents);
+            const generated = [];
+            // Module name -> written path relative to the project root, so the
+            // report shows where each module actually landed.
+            const writtenPaths = new Map();
+            // Module name -> path of a module skipped because it already exists on
+            // disk. Those fields may still be undeclared and need registration.
+            const existingPaths = new Map();
+            for (const module of winners){
+                if (!overwrite && configuredNames.has(module.name)) {
+                    skipped.push({
+                        id: module.name,
+                        reasons: [
+                            'Already declared in sanity.cli.ts (pass --overwrite to re-generate)'
+                        ],
+                        status: 'skipped',
+                        validationErrors: []
+                    });
+                    continue;
+                }
+                const defaultDestination = path.join(outDirAbsolute, module.filename);
+                // The pull generates `.tsx`, but a hand-written module for the same
+                // field may be plain `.ts` — treat both as taken.
+                const existing = await firstExisting([
+                    defaultDestination,
+                    defaultDestination.replace(/\.tsx$/, '.ts')
+                ]);
+                if (!overwrite && existing) {
+                    // The file is left alone, but the field is undeclared (declared
+                    // names were skipped above) — so it still joins the registration
+                    // offer below. An on-disk module without a config entry is exactly
+                    // the state the next deploy punishes, however the file got there.
+                    existingPaths.set(module.name, path.relative(root.directory, existing));
+                    skipped.push({
+                        id: module.name,
+                        reasons: [
+                            `A file already exists at ${path.relative(root.directory, existing)} (pass --overwrite to replace it)`
+                        ],
+                        status: 'skipped',
+                        validationErrors: []
+                    });
+                    continue;
+                }
+                // When overwriting a field the config already declares, the module
+                // must land at the declared `src` path — writing <out-dir>/<name>.tsx
+                // instead would orphan the new file while deploy keeps evaluating the
+                // old one. Failing that, replace the module found on disk (which may
+                // be the .ts variant), and only then fall back to the default.
+                const declaredSrc = overwrite ? configuredSrcByName.get(module.name) : undefined;
+                const destination = declaredSrc ? await resolveDeclaredSrc(path.resolve(root.directory, declaredSrc), module.filename) : existing ?? defaultDestination;
+                await mkdir(path.dirname(destination), {
+                    recursive: true
+                });
+                await writeFile(destination, module.source);
+                writtenPaths.set(module.name, path.relative(root.directory, destination));
+                generated.push(module);
+            }
+            // Fields present locally — written this run or already on disk — but not
+            // declared get offered for registration: the deploy mirrors config to
+            // stored documents, so an undeclared stored aspect is deleted by the
+            // next deploy — leaving the entries unpasted is a data hazard, not just
+            // friction. Existing files count because a prior pull may have been
+            // declined (or edited by hand): the file being there does not make the
+            // field declared.
+            const entryPaths = new Map([
+                ...writtenPaths,
+                ...existingPaths
+            ]);
+            const newEntries = winners.filter((module)=>!configuredNames.has(module.name) && entryPaths.has(module.name));
+            const entryLines = newEntries.length > 0 ? formatFieldEntries(newEntries, outDirRelative, entryPaths).split('\n') : [];
+            const registration = newEntries.length > 0 ? await this.maybeRegisterFields({
+                configPath: root.path,
+                entryLines
+            }) : null;
+            this.report({
+                configuredNames,
+                entryLines,
+                generated,
+                newEntries,
+                outDir: outDirRelative,
+                registration,
+                skipped,
+                writtenPaths
+            });
+        } catch (error) {
+            // Ctrl+C on the library prompt and errors that already carry their exit
+            // code (`this.error` inside helpers) pass through to SanityCommand.catch.
+            if (error instanceof Error && error.name === 'ExitPromptError') throw error;
+            if (error && typeof error === 'object' && 'oclif' in error) throw error;
+            const err = error;
+            pullAspectsDebug('Failed to pull aspects', {
+                error: err,
+                mediaLibraryId: mediaLibraryIdFlag
+            });
+            this.error(styleText('bold', 'Failed to pull aspects') + `\n\n${styleText('red', err.message)}`, {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+    }
+    /**
+   * Offer to declare the generated fields in `sanity.cli.ts`. `--update-config`
+   * / `--no-update-config` decide outright; otherwise an interactive run
+   * prompts (default yes) and an unattended run leaves the config alone.
+   */ async maybeRegisterFields({ configPath, entryLines }) {
+        const flag = this.flags['update-config'];
+        const shouldUpdate = flag ?? (this.isUnattended() ? false : await confirm({
+            default: true,
+            message: `Declare the ${entryLines.length} pulled ${pluralize('field', entryLines.length)} in sanity.cli.ts?`
+        }));
+        if (!shouldUpdate) return 'declined';
+        const source = await readFile(configPath, 'utf8');
+        const result = appendFieldEntries(source, entryLines);
+        if (!result.ok) return {
+            reason: result.reason
+        };
+        await writeFile(configPath, result.updated);
+        return 'added';
+    }
+    report({ configuredNames, entryLines, generated, newEntries, outDir, registration, skipped, writtenPaths }) {
+        if (skipped.length > 0) {
+            this.logToStderr('');
+            this.warn(styleText('bold', `Skipped ${skipped.length} ${pluralize('aspect', skipped.length)}`));
+            for (const aspect of skipped){
+                const errors = aspect.validationErrors.flatMap((group)=>group.map(({ message })=>message));
+                const reasons = [
+                    ...aspect.reasons,
+                    ...errors
+                ];
+                this.logToStderr(`  - ${aspect.id} ${styleText('dim', reasons.join('; '))}`);
+            }
+        }
+        // No modules written and nothing to declare: done. Skipped-but-undeclared
+        // fields keep the report alive — their registration outcome still matters.
+        if (generated.length === 0 && newEntries.length === 0) {
+            this.log('');
+            this.log('No field modules generated.');
+            return;
+        }
+        if (generated.length === 0) {
+            this.log('');
+            this.log('No field modules generated.');
+        } else {
+            this.log('');
+            this.log(`${logSymbols.success} ${styleText('bold', `Generated ${generated.length} field ${pluralize('module', generated.length)}`)}`);
+            for (const module of generated){
+                const location = writtenPaths.get(module.name) ?? path.join(outDir, module.filename);
+                this.log(`  - ${module.name} ${styleText('dim', location)}`);
+                for (const warning of module.warnings){
+                    this.log(`    ${logSymbols.warning} ${warning}`);
+                }
+            }
+        }
+        if (newEntries.length > 0 && registration === 'added') {
+            this.log('');
+            this.log(`${logSymbols.success} Declared ${newEntries.length} ${pluralize('field', newEntries.length)} in ${styleText('bold', 'sanity.cli.ts')}`);
+        } else if (newEntries.length > 0) {
+            if (registration !== null && typeof registration === 'object') {
+                this.warn(`Could not update sanity.cli.ts automatically: ${registration.reason}`);
+            }
+            this.log('');
+            this.log(configuredNames.size > 0 ? `Add the pulled ${pluralize('field', newEntries.length)} to the \`fields\` array in ${styleText('bold', 'sanity.cli.ts')}:` : `Declare the pulled ${pluralize('field', newEntries.length)} in ${styleText('bold', 'sanity.cli.ts')}:`);
+            this.log('');
+            this.log(entryLines.map((line)=>`  ${line}`).join('\n'));
+            // The deploy mirrors config into stored documents; a pulled-but-undeclared
+            // field reads as stale there, so leaving the entries out is destructive.
+            this.warn('`sanity deploy` deletes the stored definition of any field not declared in sanity.cli.ts.');
+        }
+        this.log('');
+        this.log('Once declared in sanity.cli.ts, the config app owns these definitions — deploying the');
+        this.log('config overwrites the stored documents this pull read from. Stored definitions');
+        this.log('not declared in sanity.cli.ts are deleted on deploy.');
+    }
+}
+/**
+ * The write target for a declared `src` path. A declared path may omit the
+ * extension — the bundler and jiti both resolve `./src/fields/notes` to
+ * `notes.ts(x)` — so writing it literally would create an extensionless file
+ * next to the module deploy actually evaluates. Resolve to the existing
+ * module file; if none exists, append the generated module's extension.
+ */ async function resolveDeclaredSrc(declaredPath, moduleFilename) {
+    if (path.extname(declaredPath) !== '') return declaredPath;
+    const existing = await firstExisting([
+        `${declaredPath}.ts`,
+        `${declaredPath}.tsx`
+    ]);
+    return existing ?? `${declaredPath}${path.extname(moduleFilename)}`;
+}
+/** The first path in `paths` that exists, or `undefined`. */ async function firstExisting(paths) {
+    for (const filePath of paths){
+        const exists = await access(filePath).then(()=>true, ()=>false);
+        if (exists) return filePath;
+    }
+    return undefined;
+}
+
+//# sourceMappingURL=pull-aspects.js.map