@sanity/cli 7.5.0 → 7.7.0

package/dist/actions/deploy/deploymentPlan.js

@@ -0,0 +1,117 @@
+import { readdir, stat } from 'node:fs/promises';
+import { join, relative, sep } from 'node:path';
+import { styleText } from 'node:util';
+import { logSymbols } from '@sanity/cli-core/ux';
+import { pluralize } from '../../util/pluralize.js';
+/**
+ * Lists the files a deploy would pack from `sourceDir`, as paths relative to
+ * `fromDir`. A missing directory yields an empty list rather than throwing.
+ */ export async function listDeploymentFiles(sourceDir, fromDir) {
+    const walk = async (dir)=>{
+        let entries;
+        try {
+            entries = await readdir(dir, {
+                withFileTypes: true
+            });
+        } catch  {
+            return [];
+        }
+        const nested = await Promise.all(entries.map((entry)=>{
+            const full = join(dir, entry.name);
+            return entry.isDirectory() ? walk(full) : Promise.resolve([
+                full
+            ]);
+        }));
+        return nested.flat();
+    };
+    const absolute = await walk(sourceDir);
+    const files = await Promise.all(absolute.map(async (file)=>({
+            // Deploy paths are POSIX-style regardless of the host OS (Windows gives `\`).
+            path: relative(fromDir, file).split(sep).join('/'),
+            size: (await stat(file)).size
+        })));
+    return files.toSorted((a, b)=>a.path.localeCompare(b.path));
+}
+export function isDeployable(plan) {
+    return plan.checks.every((check)=>check.status !== 'fail');
+}
+function totalBytes(files) {
+    return files.reduce((sum, file)=>sum + file.size, 0);
+}
+/**
+ * A problem-focused, machine-readable projection of the plan: blocking problems
+ * mapped to their fix, warnings as messages. Derived from the same checks the
+ * human report renders (its pass/skip lines are informational and omitted here).
+ */ export function deploymentPlanToJson(plan) {
+    const errors = {};
+    const warnings = [];
+    for (const check of plan.checks){
+        if (check.status === 'fail') errors[check.message] = check.solution ?? null;
+        else if (check.status === 'warn') warnings.push(check.message);
+    }
+    return {
+        applicationType: plan.type,
+        applicationVersion: plan.version,
+        errors,
+        files: plan.files,
+        isDeployable: isDeployable(plan),
+        target: plan.target,
+        totalBytes: totalBytes(plan.files),
+        warnings
+    };
+}
+export function renderDeploymentPlan(plan, output) {
+    const label = plan.type === 'coreApp' ? 'application' : 'studio';
+    const problems = plan.checks.filter((check)=>check.status === 'fail');
+    const warnings = plan.checks.filter((check)=>check.status === 'warn');
+    output.log('\nDry run — no changes made.\n');
+    // Only pass/skip here; problems and warnings render below with their fixes.
+    for (const check of plan.checks){
+        if (check.status === 'pass' || check.status === 'skip') {
+            output.log(`  ${statusIcon(check.status)} ${check.message}`);
+        }
+    }
+    output.log(isDeployable(plan) ? styleText('green', `\nThis ${label} can be deployed.`) : styleText('red', `\nThis ${label} can't be deployed.`));
+    renderIssues(output, 'Problems to fix:', problems);
+    renderIssues(output, 'Warnings:', warnings);
+    // A blocked deploy uploads nothing, so only list files for a deployable plan.
+    if (isDeployable(plan) && plan.files.length > 0) {
+        output.log(`\nFiles to deploy (${plan.files.length} ${pluralize('file', plan.files.length)}, ${formatMB(totalBytes(plan.files))}):`);
+        for (const file of plan.files){
+            output.log(`  ${file.path} (${formatMB(file.size)})`);
+        }
+    }
+}
+function renderIssues(output, title, checks) {
+    if (checks.length === 0) return;
+    output.log(`\n${title}`);
+    for (const check of checks){
+        const fix = check.solution ? `: ${check.solution}` : '';
+        output.log(`  ${statusIcon(check.status)} ${check.message}${fix}`);
+    }
+}
+function formatMB(bytes) {
+    return `${(bytes / 1024 / 1024).toFixed(2)} MB`;
+}
+function statusIcon(status) {
+    switch(status){
+        case 'fail':
+            {
+                return logSymbols.error;
+            }
+        case 'skip':
+            {
+                return logSymbols.info;
+            }
+        case 'warn':
+            {
+                return logSymbols.warning;
+            }
+        default:
+            {
+                return logSymbols.success;
+            }
+    }
+}
+
+//# sourceMappingURL=deploymentPlan.js.map

package/dist/actions/deploy/deploymentPlan.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/deploy/deploymentPlan.ts"],"sourcesContent":["import {readdir, stat} from 'node:fs/promises'\nimport {join, relative, sep} from 'node:path'\nimport {styleText} from 'node:util'\n\nimport {type Output} from '@sanity/cli-core'\nimport {logSymbols} from '@sanity/cli-core/ux'\n\nimport {pluralize} from '../../util/pluralize.js'\nimport {type DeployCheck, type DeployTarget} from './deployChecks.js'\n\nexport interface DeploymentFile {\n  /** Path relative to the project root, POSIX-style. */\n  path: string\n  size: number\n}\n\n/** What a `--dry-run` deploy would do: the real deploy sequence with every mutation gated off. */\nexport interface DeploymentPlan {\n  checks: DeployCheck[]\n  files: DeploymentFile[]\n  /** The resolved deploy target; `null` when the checks can't determine one. */\n  target: DeployTarget | null\n  type: 'coreApp' | 'studio'\n  /** Installed framework version the deploy would use; `null` when not found. */\n  version: string | null\n}\n\n/**\n * Lists the files a deploy would pack from `sourceDir`, as paths relative to\n * `fromDir`. A missing directory yields an empty list rather than throwing.\n */\nexport async function listDeploymentFiles(\n  sourceDir: string,\n  fromDir: string,\n): Promise<DeploymentFile[]> {\n  const walk = async (dir: string): Promise<string[]> => {\n    let entries\n    try {\n      entries = await readdir(dir, {withFileTypes: true})\n    } catch {\n      return []\n    }\n    const nested = await Promise.all(\n      entries.map((entry) => {\n        const full = join(dir, entry.name)\n        return entry.isDirectory() ? walk(full) : Promise.resolve([full])\n      }),\n    )\n    return nested.flat()\n  }\n\n  const absolute = await walk(sourceDir)\n  const files = await Promise.all(\n    absolute.map(async (file) => ({\n      // Deploy paths are POSIX-style regardless of the host OS (Windows gives `\\`).\n      path: relative(fromDir, file).split(sep).join('/'),\n      size: (await stat(file)).size,\n    })),\n  )\n  return files.toSorted((a, b) => a.path.localeCompare(b.path))\n}\n\nexport function isDeployable(plan: DeploymentPlan): boolean {\n  return plan.checks.every((check) => check.status !== 'fail')\n}\n\nfunction totalBytes(files: DeploymentFile[]): number {\n  return files.reduce((sum, file) => sum + file.size, 0)\n}\n\n/**\n * A problem-focused, machine-readable projection of the plan: blocking problems\n * mapped to their fix, warnings as messages. Derived from the same checks the\n * human report renders (its pass/skip lines are informational and omitted here).\n */\nexport function deploymentPlanToJson(plan: DeploymentPlan): {\n  applicationType: DeploymentPlan['type']\n  applicationVersion: string | null\n  errors: Record<string, string | null>\n  files: DeploymentFile[]\n  isDeployable: boolean\n  target: DeployTarget | null\n  totalBytes: number\n  warnings: string[]\n} {\n  const errors: Record<string, string | null> = {}\n  const warnings: string[] = []\n  for (const check of plan.checks) {\n    if (check.status === 'fail') errors[check.message] = check.solution ?? null\n    else if (check.status === 'warn') warnings.push(check.message)\n  }\n\n  return {\n    applicationType: plan.type,\n    applicationVersion: plan.version,\n    errors,\n    files: plan.files,\n    isDeployable: isDeployable(plan),\n    target: plan.target,\n    totalBytes: totalBytes(plan.files),\n    warnings,\n  }\n}\n\nexport function renderDeploymentPlan(plan: DeploymentPlan, output: Output): void {\n  const label = plan.type === 'coreApp' ? 'application' : 'studio'\n  const problems = plan.checks.filter((check) => check.status === 'fail')\n  const warnings = plan.checks.filter((check) => check.status === 'warn')\n\n  output.log('\\nDry run — no changes made.\\n')\n\n  // Only pass/skip here; problems and warnings render below with their fixes.\n  for (const check of plan.checks) {\n    if (check.status === 'pass' || check.status === 'skip') {\n      output.log(`  ${statusIcon(check.status)} ${check.message}`)\n    }\n  }\n\n  output.log(\n    isDeployable(plan)\n      ? styleText('green', `\\nThis ${label} can be deployed.`)\n      : styleText('red', `\\nThis ${label} can't be deployed.`),\n  )\n\n  renderIssues(output, 'Problems to fix:', problems)\n  renderIssues(output, 'Warnings:', warnings)\n\n  // A blocked deploy uploads nothing, so only list files for a deployable plan.\n  if (isDeployable(plan) && plan.files.length > 0) {\n    output.log(\n      `\\nFiles to deploy (${plan.files.length} ${pluralize('file', plan.files.length)}, ${formatMB(totalBytes(plan.files))}):`,\n    )\n    for (const file of plan.files) {\n      output.log(`  ${file.path} (${formatMB(file.size)})`)\n    }\n  }\n}\n\nfunction renderIssues(output: Output, title: string, checks: DeployCheck[]): void {\n  if (checks.length === 0) return\n\n  output.log(`\\n${title}`)\n  for (const check of checks) {\n    const fix = check.solution ? `: ${check.solution}` : ''\n    output.log(`  ${statusIcon(check.status)} ${check.message}${fix}`)\n  }\n}\n\nfunction formatMB(bytes: number): string {\n  return `${(bytes / 1024 / 1024).toFixed(2)} MB`\n}\n\nfunction statusIcon(status: DeployCheck['status']): string {\n  switch (status) {\n    case 'fail': {\n      return logSymbols.error\n    }\n    case 'skip': {\n      return logSymbols.info\n    }\n    case 'warn': {\n      return logSymbols.warning\n    }\n    default: {\n      return logSymbols.success\n    }\n  }\n}\n"],"names":["readdir","stat","join","relative","sep","styleText","logSymbols","pluralize","listDeploymentFiles","sourceDir","fromDir","walk","dir","entries","withFileTypes","nested","Promise","all","map","entry","full","name","isDirectory","resolve","flat","absolute","files","file","path","split","size","toSorted","a","b","localeCompare","isDeployable","plan","checks","every","check","status","totalBytes","reduce","sum","deploymentPlanToJson","errors","warnings","message","solution","push","applicationType","type","applicationVersion","version","target","renderDeploymentPlan","output","label","problems","filter","log","statusIcon","renderIssues","length","formatMB","title","fix","bytes","toFixed","error","info","warning","success"],"mappings":"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"}

package/dist/actions/deploy/findUserApplication.js

@@ -0,0 +1,209 @@
+/**
+ * Finds (or creates) the user application a deploy targets — the interactive
+ * adapter that turns the resolveDeployTarget verdicts into prompts, creation,
+ * and exits. Dry runs consume the same verdicts read-only (see deployChecks).
+ */ import { select, Separator, spinner } from '@sanity/cli-core/ux';
+import { createUserApplication } from '../../services/userApplications.js';
+import { getAppId } from '../../util/appId.js';
+import { getErrorMessage } from '../../util/getErrorMessage.js';
+import { createFailFastReporter, describeAppTarget, describeAppTargetError, describeStudioTarget } from './deployChecks.js';
+import { deployDebug } from './deployDebug.js';
+import { resolveAppDeployTarget, resolveStudioDeployTarget } from './resolveDeployTarget.js';
+export async function findUserApplication(options) {
+    const { cliConfig, organizationId, output, title, unattended = false } = options;
+    const spin = spinner('Checking application info...').start();
+    let resolution;
+    try {
+        resolution = await resolveAppDeployTarget({
+            appId: getAppId(cliConfig),
+            organizationId
+        });
+        deployDebug('Resolved app deploy target', resolution);
+    } catch (error) {
+        spin.clear();
+        deployDebug('Error finding user application for app', error);
+        output.error(describeAppTargetError(error, organizationId), {
+            exit: 1
+        });
+        return null;
+    }
+    if (resolution.type === 'found') {
+        spin.succeed();
+        return resolution.application;
+    }
+    // null tells the caller to create. Unattended runs can only create with a
+    // --title; picking among existing apps (needs-input) always needs a prompt.
+    if (resolution.type === 'would-create' && (!unattended || title)) {
+        spin.info('No application ID configured');
+        return null;
+    }
+    if (resolution.type === 'needs-input' && !unattended) {
+        spin.info('No application ID configured');
+        return promptForExistingApp(resolution.existing);
+    }
+    spin.clear();
+    // 'blocked' diagnoses as a skip (its root cause fails an earlier check), so it
+    // needs an explicit exit here to not fall through to application creation
+    if (resolution.type === 'blocked') {
+        output.error(resolution.message, {
+            exit: 1
+        });
+        return null;
+    }
+    createFailFastReporter(output).report(describeAppTarget(resolution));
+    return null;
+}
+export async function findUserApplicationForStudio(options) {
+    const { appId, isExternal, output, projectId, studioHost, title, unattended = false, urlFlag } = options;
+    const urlType = isExternal ? 'external' : 'internal';
+    const spin = spinner('Checking project info').start();
+    let resolution;
+    try {
+        resolution = await resolveStudioDeployTarget({
+            appId,
+            isExternal,
+            projectId,
+            studioHost,
+            urlFlag
+        });
+        deployDebug('Resolved studio deploy target', resolution);
+    } catch (error) {
+        spin.fail();
+        deployDebug('Error finding user application', error);
+        output.error(`Failed to resolve deploy target: ${getErrorMessage(error)}`, {
+            exit: 1
+        });
+        return null;
+    }
+    if (resolution.type === 'found') {
+        spin.succeed();
+        return resolution.application;
+    }
+    // The configured host isn't registered yet — a deploy registers it without prompting
+    if (resolution.type === 'would-create') {
+        spin.succeed();
+        return createFromConfiguredHost({
+            appHost: resolution.appHost,
+            output,
+            projectId,
+            title,
+            urlType
+        });
+    }
+    if (resolution.type === 'needs-input' && !unattended) {
+        spin.succeed();
+        // Nothing to select from — the caller prompts for a brand new host
+        if (resolution.existing.length === 0) return null;
+        return promptForExistingStudio({
+            existing: resolution.existing,
+            urlType
+        });
+    }
+    spin.fail();
+    // 'blocked' diagnoses as a skip (its root cause fails an earlier check), so it
+    // needs an explicit exit here
+    if (resolution.type === 'blocked') {
+        output.error(resolution.message, {
+            exit: 1
+        });
+        return null;
+    }
+    createFailFastReporter(output).report(describeStudioTarget(resolution, {
+        isExternal
+    }));
+    return null;
+}
+/**
+ * The host is configured (studioHost or --url) but not registered yet:
+ * a deploy registers it without prompting.
+ */ async function createFromConfiguredHost({ appHost, output, projectId, title, urlType }) {
+    if (urlType === 'external') {
+        output.log('Your project has not been registered with an external studio URL.');
+        output.log(`Registering ${appHost}`);
+    } else {
+        output.log('Your project has not been assigned a studio hostname.');
+        output.log(`Creating https://${appHost}.sanity.studio`);
+    }
+    output.log('');
+    const spin = spinner(urlType === 'external' ? 'Registering external studio' : 'Creating studio hostname').start();
+    try {
+        const response = await createUserApplication({
+            appType: 'studio',
+            body: {
+                appHost,
+                title,
+                type: 'studio',
+                urlType
+            },
+            projectId
+        });
+        spin.succeed();
+        return response;
+    } catch (e) {
+        spin.fail();
+        // if the name is taken, it should return a 409 so we relay to the user
+        if ([
+            402,
+            409
+        ].includes(e?.statusCode)) {
+            output.error(e?.response?.body?.message || 'Bad request', {
+                exit: 1
+            });
+            return null;
+        }
+        // otherwise, it's a fatal error
+        deployDebug('Error creating user application from config', e);
+        output.error(`Error creating user application from config: ${e instanceof Error ? e.message : e}`, {
+            exit: 1
+        });
+        return null;
+    }
+}
+async function promptForExistingApp(existing) {
+    const choices = existing.map((app)=>({
+            name: app.title ?? app.appHost,
+            value: app.appHost
+        }));
+    const selected = await select({
+        choices: [
+            {
+                name: 'New application deployment',
+                value: 'NEW_APP'
+            },
+            new Separator(' ════ Existing applications: ════ '),
+            ...choices
+        ],
+        loop: false,
+        message: 'Would you like to create a new application deployment, or deploy to an existing one?',
+        pageSize: 10
+    });
+    if (selected === 'NEW_APP') {
+        return null;
+    }
+    return existing.find((app)=>app.appHost === selected);
+}
+async function promptForExistingStudio({ existing, urlType }) {
+    const newLabel = urlType === 'external' ? 'Register new external studio URL' : 'Create new studio hostname';
+    const selectMessage = urlType === 'external' ? 'Select existing external studio, or register a new one' : 'Select existing studio hostname, or create a new one';
+    const choices = existing.map((app)=>({
+            name: app.title ?? app.appHost,
+            value: app.appHost
+        }));
+    const selected = await select({
+        choices: [
+            {
+                name: newLabel,
+                value: 'NEW_STUDIO'
+            },
+            new Separator(),
+            ...choices
+        ],
+        message: selectMessage
+    });
+    if (selected === 'NEW_STUDIO') {
+        return null;
+    }
+    return existing.find((app)=>app.appHost === selected);
+}
+
+//# sourceMappingURL=findUserApplication.js.map

package/dist/actions/deploy/findUserApplication.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/deploy/findUserApplication.ts"],"sourcesContent":["/**\n * Finds (or creates) the user application a deploy targets — the interactive\n * adapter that turns the resolveDeployTarget verdicts into prompts, creation,\n * and exits. Dry runs consume the same verdicts read-only (see deployChecks).\n */\n\nimport {type CliConfig, type Output} from '@sanity/cli-core'\nimport {select, Separator, spinner} from '@sanity/cli-core/ux'\n\nimport {\n  createUserApplication,\n  type UserApplication,\n  type UserApplicationResolved,\n} from '../../services/userApplications.js'\nimport {getAppId} from '../../util/appId.js'\nimport {getErrorMessage} from '../../util/getErrorMessage.js'\nimport {\n  createFailFastReporter,\n  describeAppTarget,\n  describeAppTargetError,\n  describeStudioTarget,\n} from './deployChecks.js'\nimport {deployDebug} from './deployDebug.js'\nimport {resolveAppDeployTarget, resolveStudioDeployTarget} from './resolveDeployTarget.js'\n\ninterface FindUserApplicationOptions {\n  cliConfig: CliConfig\n  organizationId: string\n  output: Output\n\n  title?: string\n  unattended?: boolean\n}\n\nexport async function findUserApplication(\n  options: FindUserApplicationOptions,\n): Promise<UserApplicationResolved | null> {\n  const {cliConfig, organizationId, output, title, unattended = false} = options\n  const spin = spinner('Checking application info...').start()\n\n  let resolution\n  try {\n    resolution = await resolveAppDeployTarget({appId: getAppId(cliConfig), organizationId})\n    deployDebug('Resolved app deploy target', resolution)\n  } catch (error) {\n    spin.clear()\n    deployDebug('Error finding user application for app', error)\n    output.error(describeAppTargetError(error, organizationId), {exit: 1})\n    return null\n  }\n\n  if (resolution.type === 'found') {\n    spin.succeed()\n    return resolution.application\n  }\n\n  // null tells the caller to create. Unattended runs can only create with a\n  // --title; picking among existing apps (needs-input) always needs a prompt.\n  if (resolution.type === 'would-create' && (!unattended || title)) {\n    spin.info('No application ID configured')\n    return null\n  }\n  if (resolution.type === 'needs-input' && !unattended) {\n    spin.info('No application ID configured')\n    return promptForExistingApp(resolution.existing)\n  }\n\n  spin.clear()\n  // 'blocked' diagnoses as a skip (its root cause fails an earlier check), so it\n  // needs an explicit exit here to not fall through to application creation\n  if (resolution.type === 'blocked') {\n    output.error(resolution.message, {exit: 1})\n    return null\n  }\n  createFailFastReporter(output).report(describeAppTarget(resolution))\n  return null\n}\n\ninterface FindUserApplicationForStudioOptions {\n  isExternal: boolean\n  output: Output\n  projectId: string\n\n  appId?: string\n  studioHost?: string\n  title?: string\n  unattended?: boolean\n  urlFlag?: string\n}\n\nexport async function findUserApplicationForStudio(\n  options: FindUserApplicationForStudioOptions,\n): Promise<UserApplication | null> {\n  const {\n    appId,\n    isExternal,\n    output,\n    projectId,\n    studioHost,\n    title,\n    unattended = false,\n    urlFlag,\n  } = options\n  const urlType = isExternal ? 'external' : 'internal'\n  const spin = spinner('Checking project info').start()\n\n  let resolution\n  try {\n    resolution = await resolveStudioDeployTarget({\n      appId,\n      isExternal,\n      projectId,\n      studioHost,\n      urlFlag,\n    })\n    deployDebug('Resolved studio deploy target', resolution)\n  } catch (error) {\n    spin.fail()\n    deployDebug('Error finding user application', error)\n    output.error(`Failed to resolve deploy target: ${getErrorMessage(error)}`, {exit: 1})\n    return null\n  }\n\n  if (resolution.type === 'found') {\n    spin.succeed()\n    return resolution.application\n  }\n\n  // The configured host isn't registered yet — a deploy registers it without prompting\n  if (resolution.type === 'would-create') {\n    spin.succeed()\n    return createFromConfiguredHost({\n      appHost: resolution.appHost,\n      output,\n      projectId,\n      title,\n      urlType,\n    })\n  }\n\n  if (resolution.type === 'needs-input' && !unattended) {\n    spin.succeed()\n    // Nothing to select from — the caller prompts for a brand new host\n    if (resolution.existing.length === 0) return null\n    return promptForExistingStudio({existing: resolution.existing, urlType})\n  }\n\n  spin.fail()\n  // 'blocked' diagnoses as a skip (its root cause fails an earlier check), so it\n  // needs an explicit exit here\n  if (resolution.type === 'blocked') {\n    output.error(resolution.message, {exit: 1})\n    return null\n  }\n  createFailFastReporter(output).report(describeStudioTarget(resolution, {isExternal}))\n  return null\n}\n\n/**\n * The host is configured (studioHost or --url) but not registered yet:\n * a deploy registers it without prompting.\n */\nasync function createFromConfiguredHost({\n  appHost,\n  output,\n  projectId,\n  title,\n  urlType,\n}: {\n  appHost: string\n  output: Output\n  projectId: string\n  title?: string\n  urlType: 'external' | 'internal'\n}): Promise<UserApplication | null> {\n  if (urlType === 'external') {\n    output.log('Your project has not been registered with an external studio URL.')\n    output.log(`Registering ${appHost}`)\n  } else {\n    output.log('Your project has not been assigned a studio hostname.')\n    output.log(`Creating https://${appHost}.sanity.studio`)\n  }\n  output.log('')\n\n  const spin = spinner(\n    urlType === 'external' ? 'Registering external studio' : 'Creating studio hostname',\n  ).start()\n\n  try {\n    const response = await createUserApplication({\n      appType: 'studio',\n      body: {appHost, title, type: 'studio', urlType},\n      projectId,\n    })\n    spin.succeed()\n    return response\n  } catch (e) {\n    spin.fail()\n    // if the name is taken, it should return a 409 so we relay to the user\n    if ([402, 409].includes(e?.statusCode)) {\n      output.error(e?.response?.body?.message || 'Bad request', {exit: 1})\n      return null\n    }\n    // otherwise, it's a fatal error\n    deployDebug('Error creating user application from config', e)\n    output.error(\n      `Error creating user application from config: ${e instanceof Error ? e.message : e}`,\n      {exit: 1},\n    )\n    return null\n  }\n}\n\nasync function promptForExistingApp(\n  existing: UserApplicationResolved[],\n): Promise<UserApplicationResolved | null> {\n  const choices = existing.map((app) => ({name: app.title ?? app.appHost, value: app.appHost}))\n\n  const selected = await select({\n    choices: [\n      {name: 'New application deployment', value: 'NEW_APP'},\n      new Separator(' ════ Existing applications: ════ '),\n      ...choices,\n    ],\n    loop: false,\n    message: 'Would you like to create a new application deployment, or deploy to an existing one?',\n    pageSize: 10,\n  })\n\n  if (selected === 'NEW_APP') {\n    return null\n  }\n\n  return existing.find((app) => app.appHost === selected)!\n}\n\nasync function promptForExistingStudio({\n  existing,\n  urlType,\n}: {\n  existing: UserApplication[]\n  urlType: 'external' | 'internal'\n}): Promise<UserApplication | null> {\n  const newLabel =\n    urlType === 'external' ? 'Register new external studio URL' : 'Create new studio hostname'\n  const selectMessage =\n    urlType === 'external'\n      ? 'Select existing external studio, or register a new one'\n      : 'Select existing studio hostname, or create a new one'\n\n  const choices = existing.map((app) => ({name: app.title ?? app.appHost, value: app.appHost}))\n\n  const selected = await select({\n    choices: [{name: newLabel, value: 'NEW_STUDIO'}, new Separator(), ...choices],\n    message: selectMessage,\n  })\n\n  if (selected === 'NEW_STUDIO') {\n    return null\n  }\n\n  return existing.find((app) => app.appHost === selected)!\n}\n"],"names":["select","Separator","spinner","createUserApplication","getAppId","getErrorMessage","createFailFastReporter","describeAppTarget","describeAppTargetError","describeStudioTarget","deployDebug","resolveAppDeployTarget","resolveStudioDeployTarget","findUserApplication","options","cliConfig","organizationId","output","title","unattended","spin","start","resolution","appId","error","clear","exit","type","succeed","application","info","promptForExistingApp","existing","message","report","findUserApplicationForStudio","isExternal","projectId","studioHost","urlFlag","urlType","fail","createFromConfiguredHost","appHost","length","promptForExistingStudio","log","response","appType","body","e","includes","statusCode","Error","choices","map","app","name","value","selected","loop","pageSize","find","newLabel","selectMessage"],"mappings":"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"}

package/dist/actions/deploy/resolveDeployTarget.js

@@ -0,0 +1,185 @@
+import { getUserApplication, getUserApplications } from '../../services/userApplications.js';
+import { normalizeUrl, validateUrl } from './urlUtils.js';
+/**
+ * Owns the studio deploy-target rules: the --url flag over studioHost config,
+ * appId over appHost precedence, external URL normalization and validation.
+ * Both the real deploy and the dry run consume these verdicts.
+ *
+ * @internal
+ */ export async function resolveStudioDeployTarget(options) {
+    const { appId, isExternal, projectId, studioHost, urlFlag } = options;
+    // appId wins over host config (and undeploy resolves it the same way): a
+    // configured appId deploys even when studioHost is stale or invalid, so it's
+    // resolved before any host validation.
+    if (appId) {
+        if (!projectId) {
+            return {
+                message: 'api.projectId is missing',
+                type: 'blocked'
+            };
+        }
+        const application = await getUserApplication({
+            appId,
+            isSdkApp: false,
+            projectId
+        });
+        if (application) {
+            return {
+                application,
+                type: 'found'
+            };
+        }
+        return {
+            message: `Cannot find app with app ID ${appId}`,
+            reason: 'app-not-found',
+            type: 'invalid'
+        };
+    }
+    const { error: hostError, host: resolvedHost } = resolveAppHost({
+        isExternal,
+        studioHost,
+        url: urlFlag
+    });
+    if (hostError) {
+        return {
+            message: hostError,
+            reason: 'invalid-host',
+            type: 'invalid'
+        };
+    }
+    // A host from config hasn't passed through the --url validation yet
+    let appHost = resolvedHost;
+    if (appHost && isExternal) {
+        appHost = normalizeUrl(appHost);
+        const validation = validateUrl(appHost);
+        if (validation !== true) {
+            return {
+                message: validation,
+                reason: 'invalid-host',
+                type: 'invalid'
+            };
+        }
+    }
+    if (appHost) {
+        if (!projectId) {
+            return {
+                message: 'api.projectId is missing',
+                type: 'blocked'
+            };
+        }
+        const application = await getUserApplication({
+            appHost,
+            isSdkApp: false,
+            projectId
+        });
+        if (application) {
+            return {
+                application,
+                type: 'found'
+            };
+        }
+        return {
+            appHost,
+            type: 'would-create'
+        };
+    }
+    // Neither appId nor host configured — a deploy would prompt.
+    // Without a project there is nothing to list; a deploy would still prompt.
+    const existing = projectId ? await listStudioApplications(projectId, isExternal) : [];
+    return {
+        existing,
+        type: 'needs-input'
+    };
+}
+/**
+ * Owns the app deploy-target rules: appId lookup, falling back to listing the
+ * organization's applications. Both the real deploy and the dry run consume
+ * these verdicts.
+ *
+ * @internal
+ */ export async function resolveAppDeployTarget(options) {
+    const { appId, organizationId } = options;
+    if (appId) {
+        const application = await getUserApplication({
+            appId,
+            isSdkApp: true
+        });
+        if (application) {
+            return {
+                application,
+                type: 'found'
+            };
+        }
+        return {
+            message: `Cannot find app with app ID ${appId}`,
+            reason: 'app-not-found',
+            type: 'invalid'
+        };
+    }
+    if (!organizationId) {
+        return {
+            message: 'app.organizationId is missing',
+            type: 'blocked'
+        };
+    }
+    const existing = await getUserApplications({
+        appType: 'coreApp',
+        organizationId
+    });
+    if (existing?.length) {
+        return {
+            existing,
+            type: 'needs-input'
+        };
+    }
+    return {
+        type: 'would-create'
+    };
+}
+async function listStudioApplications(projectId, isExternal) {
+    const urlType = isExternal ? 'external' : 'internal';
+    const applications = await getUserApplications({
+        appType: 'studio',
+        projectId
+    });
+    // External deploys should only see external studios and vice versa
+    return applications?.filter((application)=>application.urlType === urlType) ?? [];
+}
+function resolveAppHost({ isExternal, studioHost, url }) {
+    if (!url) {
+        return {
+            host: studioHost
+        };
+    }
+    if (isExternal) {
+        const normalized = normalizeUrl(url);
+        const validation = validateUrl(normalized);
+        if (validation !== true) {
+            return {
+                error: validation
+            };
+        }
+        return {
+            host: normalized
+        };
+    }
+    // For internal deploys, strip protocol prefix and .sanity.studio suffix if present
+    const hostname = url.replace(/^https?:\/\//i, '').replace(/\.sanity\.studio\/?$/i, '');
+    // If the result still looks like a URL (contains dots), the user likely meant --external
+    if (hostname.includes('.')) {
+        return {
+            error: `"${hostname}" does not look like a sanity.studio hostname. Did you mean to use --external?`
+        };
+    }
+    // Validate hostname characters (alphanumeric and hyphens only)
+    if (!/^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/i.test(hostname)) {
+        return {
+            error: `Invalid studio hostname "${hostname}". Hostnames can only contain letters, numbers, and hyphens.`
+        };
+    }
+    return {
+        host: hostname
+    };
+}
+
+//# sourceMappingURL=resolveDeployTarget.js.map

package/dist/actions/deploy/resolveDeployTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/deploy/resolveDeployTarget.ts"],"sourcesContent":["import {\n  getUserApplication,\n  getUserApplications,\n  type UserApplication,\n  type UserApplicationResolved,\n} from '../../services/userApplications.js'\nimport {normalizeUrl, validateUrl} from './urlUtils.js'\n\n/**\n * The read-only outcome of resolving where a deploy would go.\n *\n * - `found` — the deploy targets this existing user application\n * - `would-create` — nothing registered yet; a deploy would create it without prompting\n * - `needs-input` — config doesn't determine a target; a deploy would prompt\n *   (`existing` lists the applications a prompt would offer)\n * - `invalid` — the configured target can never resolve (bad host, unknown appId)\n * - `blocked` — resolution requires config that's missing (projectId/organizationId)\n *\n * Transport errors (network, permissions) throw — they're not verdicts.\n */\ntype CommonDeployTargetResolution<App extends UserApplication = UserApplication> =\n  | {application: App; type: 'found'}\n  | {existing: App[]; type: 'needs-input'}\n  | {message: string; reason: 'app-not-found' | 'invalid-host'; type: 'invalid'}\n  | {message: string; type: 'blocked'}\n\nexport type StudioDeployTargetResolution =\n  | CommonDeployTargetResolution\n  | {appHost: string; type: 'would-create'}\n\nexport type AppDeployTargetResolution =\n  | CommonDeployTargetResolution<UserApplicationResolved>\n  | {type: 'would-create'}\n\n/**\n * Owns the studio deploy-target rules: the --url flag over studioHost config,\n * appId over appHost precedence, external URL normalization and validation.\n * Both the real deploy and the dry run consume these verdicts.\n *\n * @internal\n */\nexport async function resolveStudioDeployTarget(options: {\n  appId: string | undefined\n  isExternal: boolean\n  projectId: string | undefined\n  studioHost: string | undefined\n  urlFlag: string | undefined\n}): Promise<StudioDeployTargetResolution> {\n  const {appId, isExternal, projectId, studioHost, urlFlag} = options\n\n  // appId wins over host config (and undeploy resolves it the same way): a\n  // configured appId deploys even when studioHost is stale or invalid, so it's\n  // resolved before any host validation.\n  if (appId) {\n    if (!projectId) {\n      return {message: 'api.projectId is missing', type: 'blocked'}\n    }\n    const application = await getUserApplication({appId, isSdkApp: false, projectId})\n    if (application) {\n      return {application, type: 'found'}\n    }\n    return {\n      message: `Cannot find app with app ID ${appId}`,\n      reason: 'app-not-found',\n      type: 'invalid',\n    }\n  }\n\n  const {error: hostError, host: resolvedHost} = resolveAppHost({\n    isExternal,\n    studioHost,\n    url: urlFlag,\n  })\n  if (hostError) {\n    return {message: hostError, reason: 'invalid-host', type: 'invalid'}\n  }\n\n  // A host from config hasn't passed through the --url validation yet\n  let appHost = resolvedHost\n  if (appHost && isExternal) {\n    appHost = normalizeUrl(appHost)\n    const validation = validateUrl(appHost)\n    if (validation !== true) {\n      return {message: validation, reason: 'invalid-host', type: 'invalid'}\n    }\n  }\n\n  if (appHost) {\n    if (!projectId) {\n      return {message: 'api.projectId is missing', type: 'blocked'}\n    }\n    const application = await getUserApplication({appHost, isSdkApp: false, projectId})\n    if (application) {\n      return {application, type: 'found'}\n    }\n    return {appHost, type: 'would-create'}\n  }\n\n  // Neither appId nor host configured — a deploy would prompt.\n  // Without a project there is nothing to list; a deploy would still prompt.\n  const existing = projectId ? await listStudioApplications(projectId, isExternal) : []\n  return {existing, type: 'needs-input'}\n}\n\n/**\n * Owns the app deploy-target rules: appId lookup, falling back to listing the\n * organization's applications. Both the real deploy and the dry run consume\n * these verdicts.\n *\n * @internal\n */\nexport async function resolveAppDeployTarget(options: {\n  appId: string | undefined\n  organizationId: string | undefined\n}): Promise<AppDeployTargetResolution> {\n  const {appId, organizationId} = options\n\n  if (appId) {\n    const application = await getUserApplication({appId, isSdkApp: true})\n    if (application) {\n      return {application, type: 'found'}\n    }\n    return {\n      message: `Cannot find app with app ID ${appId}`,\n      reason: 'app-not-found',\n      type: 'invalid',\n    }\n  }\n\n  if (!organizationId) {\n    return {message: 'app.organizationId is missing', type: 'blocked'}\n  }\n\n  const existing = await getUserApplications({appType: 'coreApp', organizationId})\n  if (existing?.length) {\n    return {existing, type: 'needs-input'}\n  }\n\n  return {type: 'would-create'}\n}\n\nasync function listStudioApplications(\n  projectId: string,\n  isExternal: boolean,\n): Promise<UserApplication[]> {\n  const urlType = isExternal ? 'external' : 'internal'\n  const applications = await getUserApplications({appType: 'studio', projectId})\n  // External deploys should only see external studios and vice versa\n  return applications?.filter((application) => application.urlType === urlType) ?? []\n}\n\nfunction resolveAppHost({\n  isExternal,\n  studioHost,\n  url,\n}: {\n  isExternal: boolean\n  studioHost: string | undefined\n  url: string | undefined\n}): {error?: string; host?: string} {\n  if (!url) {\n    return {host: studioHost}\n  }\n\n  if (isExternal) {\n    const normalized = normalizeUrl(url)\n    const validation = validateUrl(normalized)\n    if (validation !== true) {\n      return {error: validation}\n    }\n    return {host: normalized}\n  }\n\n  // For internal deploys, strip protocol prefix and .sanity.studio suffix if present\n  const hostname = url.replace(/^https?:\\/\\//i, '').replace(/\\.sanity\\.studio\\/?$/i, '')\n\n  // If the result still looks like a URL (contains dots), the user likely meant --external\n  if (hostname.includes('.')) {\n    return {\n      error: `\"${hostname}\" does not look like a sanity.studio hostname. Did you mean to use --external?`,\n    }\n  }\n\n  // Validate hostname characters (alphanumeric and hyphens only)\n  if (!/^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/i.test(hostname)) {\n    return {\n      error: `Invalid studio hostname \"${hostname}\". Hostnames can only contain letters, numbers, and hyphens.`,\n    }\n  }\n\n  return {host: hostname}\n}\n"],"names":["getUserApplication","getUserApplications","normalizeUrl","validateUrl","resolveStudioDeployTarget","options","appId","isExternal","projectId","studioHost","urlFlag","message","type","application","isSdkApp","reason","error","hostError","host","resolvedHost","resolveAppHost","url","appHost","validation","existing","listStudioApplications","resolveAppDeployTarget","organizationId","appType","length","urlType","applications","filter","normalized","hostname","replace","includes","test"],"mappings":"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"}

package/dist/actions/deploy/urlUtils.js

@@ -1,3 +1,7 @@
+import { getSanityUrl } from '@sanity/cli-core';
+export function getCoreAppUrl(organizationId, appId) {
+    return getSanityUrl(`/@${organizationId}/application/${appId}`);
+}
 /**
  * Validates that the given string is a valid http or https URL.
  * Returns `true` if valid, or an error message string if invalid.

package/dist/actions/deploy/urlUtils.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/deploy/urlUtils.ts"],"sourcesContent":["/**\n * Validates that the given string is a valid http or https URL.\n * Returns `true` if valid, or an error message string if invalid.\n */\nexport function validateUrl(url: string): string | true {\n  try {\n    const parsed = new URL(url)\n    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {\n      return 'URL must use http or https protocol'\n    }\n    return true\n  } catch {\n    return 'Invalid URL. Please enter a valid http or https URL'\n  }\n}\n\n/**\n * Normalizes a URL by removing trailing slashes.\n */\nexport function normalizeUrl(url: string): string {\n  return url.replace(/\\/+$/, '')\n}\n"],"names":["validateUrl","url","parsed","URL","protocol","normalizeUrl","replace"],"mappings":"AAAA;;;CAGC,GACD,OAAO,SAASA,YAAYC,GAAW;IACrC,IAAI;QACF,MAAMC,SAAS,IAAIC,IAAIF;QACvB,IAAIC,OAAOE,QAAQ,KAAK,WAAWF,OAAOE,QAAQ,KAAK,UAAU;YAC/D,OAAO;QACT;QACA,OAAO;IACT,EAAE,OAAM;QACN,OAAO;IACT;AACF;AAEA;;CAEC,GACD,OAAO,SAASC,aAAaJ,GAAW;IACtC,OAAOA,IAAIK,OAAO,CAAC,QAAQ;AAC7B"}
+{"version":3,"sources":["../../../src/actions/deploy/urlUtils.ts"],"sourcesContent":["import {getSanityUrl} from '@sanity/cli-core'\n\nexport function getCoreAppUrl(organizationId: string, appId: string): string {\n  return getSanityUrl(`/@${organizationId}/application/${appId}`)\n}\n\n/**\n * Validates that the given string is a valid http or https URL.\n * Returns `true` if valid, or an error message string if invalid.\n */\nexport function validateUrl(url: string): string | true {\n  try {\n    const parsed = new URL(url)\n    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {\n      return 'URL must use http or https protocol'\n    }\n    return true\n  } catch {\n    return 'Invalid URL. Please enter a valid http or https URL'\n  }\n}\n\n/**\n * Normalizes a URL by removing trailing slashes.\n */\nexport function normalizeUrl(url: string): string {\n  return url.replace(/\\/+$/, '')\n}\n"],"names":["getSanityUrl","getCoreAppUrl","organizationId","appId","validateUrl","url","parsed","URL","protocol","normalizeUrl","replace"],"mappings":"AAAA,SAAQA,YAAY,QAAO,mBAAkB;AAE7C,OAAO,SAASC,cAAcC,cAAsB,EAAEC,KAAa;IACjE,OAAOH,aAAa,CAAC,EAAE,EAAEE,eAAe,aAAa,EAAEC,OAAO;AAChE;AAEA;;;CAGC,GACD,OAAO,SAASC,YAAYC,GAAW;IACrC,IAAI;QACF,MAAMC,SAAS,IAAIC,IAAIF;QACvB,IAAIC,OAAOE,QAAQ,KAAK,WAAWF,OAAOE,QAAQ,KAAK,UAAU;YAC/D,OAAO;QACT;QACA,OAAO;IACT,EAAE,OAAM;QACN,OAAO;IACT;AACF;AAEA;;CAEC,GACD,OAAO,SAASC,aAAaJ,GAAW;IACtC,OAAOA,IAAIK,OAAO,CAAC,QAAQ;AAC7B"}

package/dist/actions/dev/devAction.js

@@ -1,5 +1,5 @@
 import { SANITY_CACHE_DIR } from '@sanity/cli-build/_internal/build';
-import { isWorkbenchApp } from '@sanity/cli-core';
+import { isWorkbenchApp } from '@sanity/workbench-cli';
 import { checkForDeprecatedAppId, getAppId } from '../../util/appId.js';
 import { getSharedServerConfig } from '../../util/getSharedServerConfig.js';
 import { resolveReactStrictMode } from '../../util/resolveReactStrictMode.js';

package/dist/actions/dev/devAction.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/dev/devAction.ts"],"sourcesContent":["import {SANITY_CACHE_DIR} from '@sanity/cli-build/_internal/build'\nimport {type CliConfig, isWorkbenchApp} from '@sanity/cli-core'\n\nimport {checkForDeprecatedAppId, getAppId} from '../../util/appId.js'\nimport {getSharedServerConfig} from '../../util/getSharedServerConfig.js'\nimport {resolveReactStrictMode} from '../../util/resolveReactStrictMode.js'\nimport {extractCoreAppManifest} from '../manifest/extractCoreAppManifest.js'\nimport {extractStudioManifest} from '../manifest/extractStudioManifest.js'\nimport {startAppDevServer} from './servers/startAppDevServer.js'\nimport {startStudioDevServer} from './servers/startStudioDevServer.js'\nimport {type DevActionOptions} from './types.js'\n\nconst noop = async () => {}\n\n/**\n * Entry point for `sanity dev`. A plain studio/app starts a single dev server, as\n * before workbench existed. A workbench app (via `unstable_defineApp`) delegates to\n * `@sanity/workbench-cli`, injecting the CLI-domain pieces (app server, manifest\n * extraction, app id) and loading the package lazily so plain projects never do.\n */\nexport async function devAction(options: DevActionOptions): Promise<{close: () => Promise<void>}> {\n  const {cliConfig, flags, isApp, output, workDir} = options\n\n  const {httpHost, httpPort} = getSharedServerConfig({\n    cliConfig,\n    flags: {host: flags.host, port: flags.port},\n    workDir,\n  })\n\n  // The app/studio server, parameterized per call; `announceUrl` is false when\n  // the workbench announces the URL on its behalf.\n  const startAppServer = (params: {announceUrl: boolean; cliConfig: CliConfig; httpPort: number}) =>\n    (isApp ? startAppDevServer : startStudioDevServer)({\n      ...options,\n      announceUrl: params.announceUrl,\n      cliConfig: params.cliConfig,\n      httpPort: params.httpPort,\n    })\n\n  if (isWorkbenchApp(cliConfig?.app)) {\n    // Lazy so a non-workbench `sanity dev` never loads the package. `doImport`\n    // is path-based and doesn't apply to a bare specifier.\n    // eslint-disable-next-line no-restricted-syntax\n    const {startWorkbenchDev} = await import('@sanity/workbench-cli/dev')\n    return startWorkbenchDev({\n      appId: getAppId(cliConfig),\n      cacheDir: `${SANITY_CACHE_DIR}/vite`,\n      checkForDeprecatedAppId: () => checkForDeprecatedAppId({cliConfig, output}),\n      cliConfig,\n      extractManifest: isApp\n        ? ({workDir: wd}) => extractCoreAppManifest({workDir: wd})\n        : (params) => extractStudioManifest(params),\n      httpHost,\n      httpPort,\n      isApp,\n      output,\n      // Runtime template needs a concrete boolean; collapse an unset config to off.\n      reactStrictMode: resolveReactStrictMode(cliConfig) ?? false,\n      startAppServer,\n      workDir,\n    })\n  }\n\n  // Plain non-workbench studio/app: one dev server announcing its own URL.\n  const result = await startAppServer({announceUrl: true, cliConfig, httpPort})\n  return {close: result.started ? result.close : noop}\n}\n"],"names":["SANITY_CACHE_DIR","isWorkbenchApp","checkForDeprecatedAppId","getAppId","getSharedServerConfig","resolveReactStrictMode","extractCoreAppManifest","extractStudioManifest","startAppDevServer","startStudioDevServer","noop","devAction","options","cliConfig","flags","isApp","output","workDir","httpHost","httpPort","host","port","startAppServer","params","announceUrl","app","startWorkbenchDev","appId","cacheDir","extractManifest","wd","reactStrictMode","result","close","started"],"mappings":"AAAA,SAAQA,gBAAgB,QAAO,oCAAmC;AAClE,SAAwBC,cAAc,QAAO,mBAAkB;AAE/D,SAAQC,uBAAuB,EAAEC,QAAQ,QAAO,sBAAqB;AACrE,SAAQC,qBAAqB,QAAO,sCAAqC;AACzE,SAAQC,sBAAsB,QAAO,uCAAsC;AAC3E,SAAQC,sBAAsB,QAAO,wCAAuC;AAC5E,SAAQC,qBAAqB,QAAO,uCAAsC;AAC1E,SAAQC,iBAAiB,QAAO,iCAAgC;AAChE,SAAQC,oBAAoB,QAAO,oCAAmC;AAGtE,MAAMC,OAAO,WAAa;AAE1B;;;;;CAKC,GACD,OAAO,eAAeC,UAAUC,OAAyB;IACvD,MAAM,EAACC,SAAS,EAAEC,KAAK,EAAEC,KAAK,EAAEC,MAAM,EAAEC,OAAO,EAAC,GAAGL;IAEnD,MAAM,EAACM,QAAQ,EAAEC,QAAQ,EAAC,GAAGf,sBAAsB;QACjDS;QACAC,OAAO;YAACM,MAAMN,MAAMM,IAAI;YAAEC,MAAMP,MAAMO,IAAI;QAAA;QAC1CJ;IACF;IAEA,6EAA6E;IAC7E,iDAAiD;IACjD,MAAMK,iBAAiB,CAACC,SACtB,AAACR,CAAAA,QAAQP,oBAAoBC,oBAAmB,EAAG;YACjD,GAAGG,OAAO;YACVY,aAAaD,OAAOC,WAAW;YAC/BX,WAAWU,OAAOV,SAAS;YAC3BM,UAAUI,OAAOJ,QAAQ;QAC3B;IAEF,IAAIlB,eAAeY,WAAWY,MAAM;QAClC,2EAA2E;QAC3E,uDAAuD;QACvD,gDAAgD;QAChD,MAAM,EAACC,iBAAiB,EAAC,GAAG,MAAM,MAAM,CAAC;QACzC,OAAOA,kBAAkB;YACvBC,OAAOxB,SAASU;YAChBe,UAAU,GAAG5B,iBAAiB,KAAK,CAAC;YACpCE,yBAAyB,IAAMA,wBAAwB;oBAACW;oBAAWG;gBAAM;YACzEH;YACAgB,iBAAiBd,QACb,CAAC,EAACE,SAASa,EAAE,EAAC,GAAKxB,uBAAuB;oBAACW,SAASa;gBAAE,KACtD,CAACP,SAAWhB,sBAAsBgB;YACtCL;YACAC;YACAJ;YACAC;YACA,8EAA8E;YAC9Ee,iBAAiB1B,uBAAuBQ,cAAc;YACtDS;YACAL;QACF;IACF;IAEA,yEAAyE;IACzE,MAAMe,SAAS,MAAMV,eAAe;QAACE,aAAa;QAAMX;QAAWM;IAAQ;IAC3E,OAAO;QAACc,OAAOD,OAAOE,OAAO,GAAGF,OAAOC,KAAK,GAAGvB;IAAI;AACrD"}
+{"version":3,"sources":["../../../src/actions/dev/devAction.ts"],"sourcesContent":["import {SANITY_CACHE_DIR} from '@sanity/cli-build/_internal/build'\nimport {type CliConfig} from '@sanity/cli-core'\nimport {isWorkbenchApp} from '@sanity/workbench-cli'\n\nimport {checkForDeprecatedAppId, getAppId} from '../../util/appId.js'\nimport {getSharedServerConfig} from '../../util/getSharedServerConfig.js'\nimport {resolveReactStrictMode} from '../../util/resolveReactStrictMode.js'\nimport {extractCoreAppManifest} from '../manifest/extractCoreAppManifest.js'\nimport {extractStudioManifest} from '../manifest/extractStudioManifest.js'\nimport {startAppDevServer} from './servers/startAppDevServer.js'\nimport {startStudioDevServer} from './servers/startStudioDevServer.js'\nimport {type DevActionOptions} from './types.js'\n\nconst noop = async () => {}\n\n/**\n * Entry point for `sanity dev`. A plain studio/app starts a single dev server, as\n * before workbench existed. A workbench app (via `unstable_defineApp`) delegates to\n * `@sanity/workbench-cli`, injecting the CLI-domain pieces (app server, manifest\n * extraction, app id) and loading the package lazily so plain projects never do.\n */\nexport async function devAction(options: DevActionOptions): Promise<{close: () => Promise<void>}> {\n  const {cliConfig, flags, isApp, output, workDir} = options\n\n  const {httpHost, httpPort} = getSharedServerConfig({\n    cliConfig,\n    flags: {host: flags.host, port: flags.port},\n    workDir,\n  })\n\n  // The app/studio server, parameterized per call; `announceUrl` is false when\n  // the workbench announces the URL on its behalf.\n  const startAppServer = (params: {announceUrl: boolean; cliConfig: CliConfig; httpPort: number}) =>\n    (isApp ? startAppDevServer : startStudioDevServer)({\n      ...options,\n      announceUrl: params.announceUrl,\n      cliConfig: params.cliConfig,\n      httpPort: params.httpPort,\n    })\n\n  if (isWorkbenchApp(cliConfig?.app)) {\n    // Lazy so a non-workbench `sanity dev` never loads the package. `doImport`\n    // is path-based and doesn't apply to a bare specifier.\n    // eslint-disable-next-line no-restricted-syntax\n    const {startWorkbenchDev} = await import('@sanity/workbench-cli/dev')\n    return startWorkbenchDev({\n      appId: getAppId(cliConfig),\n      cacheDir: `${SANITY_CACHE_DIR}/vite`,\n      checkForDeprecatedAppId: () => checkForDeprecatedAppId({cliConfig, output}),\n      cliConfig,\n      extractManifest: isApp\n        ? ({workDir: wd}) => extractCoreAppManifest({workDir: wd})\n        : (params) => extractStudioManifest(params),\n      httpHost,\n      httpPort,\n      isApp,\n      output,\n      // Runtime template needs a concrete boolean; collapse an unset config to off.\n      reactStrictMode: resolveReactStrictMode(cliConfig) ?? false,\n      startAppServer,\n      workDir,\n    })\n  }\n\n  // Plain non-workbench studio/app: one dev server announcing its own URL.\n  const result = await startAppServer({announceUrl: true, cliConfig, httpPort})\n  return {close: result.started ? result.close : noop}\n}\n"],"names":["SANITY_CACHE_DIR","isWorkbenchApp","checkForDeprecatedAppId","getAppId","getSharedServerConfig","resolveReactStrictMode","extractCoreAppManifest","extractStudioManifest","startAppDevServer","startStudioDevServer","noop","devAction","options","cliConfig","flags","isApp","output","workDir","httpHost","httpPort","host","port","startAppServer","params","announceUrl","app","startWorkbenchDev","appId","cacheDir","extractManifest","wd","reactStrictMode","result","close","started"],"mappings":"AAAA,SAAQA,gBAAgB,QAAO,oCAAmC;AAElE,SAAQC,cAAc,QAAO,wBAAuB;AAEpD,SAAQC,uBAAuB,EAAEC,QAAQ,QAAO,sBAAqB;AACrE,SAAQC,qBAAqB,QAAO,sCAAqC;AACzE,SAAQC,sBAAsB,QAAO,uCAAsC;AAC3E,SAAQC,sBAAsB,QAAO,wCAAuC;AAC5E,SAAQC,qBAAqB,QAAO,uCAAsC;AAC1E,SAAQC,iBAAiB,QAAO,iCAAgC;AAChE,SAAQC,oBAAoB,QAAO,oCAAmC;AAGtE,MAAMC,OAAO,WAAa;AAE1B;;;;;CAKC,GACD,OAAO,eAAeC,UAAUC,OAAyB;IACvD,MAAM,EAACC,SAAS,EAAEC,KAAK,EAAEC,KAAK,EAAEC,MAAM,EAAEC,OAAO,EAAC,GAAGL;IAEnD,MAAM,EAACM,QAAQ,EAAEC,QAAQ,EAAC,GAAGf,sBAAsB;QACjDS;QACAC,OAAO;YAACM,MAAMN,MAAMM,IAAI;YAAEC,MAAMP,MAAMO,IAAI;QAAA;QAC1CJ;IACF;IAEA,6EAA6E;IAC7E,iDAAiD;IACjD,MAAMK,iBAAiB,CAACC,SACtB,AAACR,CAAAA,QAAQP,oBAAoBC,oBAAmB,EAAG;YACjD,GAAGG,OAAO;YACVY,aAAaD,OAAOC,WAAW;YAC/BX,WAAWU,OAAOV,SAAS;YAC3BM,UAAUI,OAAOJ,QAAQ;QAC3B;IAEF,IAAIlB,eAAeY,WAAWY,MAAM;QAClC,2EAA2E;QAC3E,uDAAuD;QACvD,gDAAgD;QAChD,MAAM,EAACC,iBAAiB,EAAC,GAAG,MAAM,MAAM,CAAC;QACzC,OAAOA,kBAAkB;YACvBC,OAAOxB,SAASU;YAChBe,UAAU,GAAG5B,iBAAiB,KAAK,CAAC;YACpCE,yBAAyB,IAAMA,wBAAwB;oBAACW;oBAAWG;gBAAM;YACzEH;YACAgB,iBAAiBd,QACb,CAAC,EAACE,SAASa,EAAE,EAAC,GAAKxB,uBAAuB;oBAACW,SAASa;gBAAE,KACtD,CAACP,SAAWhB,sBAAsBgB;YACtCL;YACAC;YACAJ;YACAC;YACA,8EAA8E;YAC9Ee,iBAAiB1B,uBAAuBQ,cAAc;YACtDS;YACAL;QACF;IACF;IAEA,yEAAyE;IACzE,MAAMe,SAAS,MAAMV,eAAe;QAACE,aAAa;QAAMX;QAAWM;IAAQ;IAC3E,OAAO;QAACc,OAAOD,OAAOE,OAAO,GAAGF,OAAOC,KAAK,GAAGvB;IAAI;AACrD"}