@sanity/cli-build 0.1.1 → 0.2.0

package/dist/actions/schema/vite/plugin-schema-extraction.js

@@ -0,0 +1,201 @@
+import path, { isAbsolute } from 'node:path';
+import { logSymbols } from '@sanity/cli-core/ux';
+import debounce from 'lodash-es/debounce.js';
+import mean from 'lodash-es/mean.js';
+import once from 'lodash-es/once.js';
+import { SchemaExtractedTrace, SchemaExtractionWatchModeTrace } from '../../../telemetry/extractSchema.telemetry.js';
+import { formatSchemaValidation } from '../formatSchemaValidation.js';
+import { createSchemaPatternMatcher } from '../matchSchemaPattern.js';
+import { runSchemaExtraction } from '../runSchemaExtraction.js';
+import { SchemaExtractionError } from '../utils/SchemaExtractionError.js';
+/**
+ * Default glob patterns to watch for schema changes.
+ * Covers the sanity config file and common schema directory naming conventions.
+ */ const DEFAULT_SCHEMA_PATTERNS = [
+    'sanity.config.{js,jsx,ts,tsx,mjs}',
+    'schema*/**/*.{js,jsx,ts,tsx,mjs}'
+];
+/** Default debounce delay in milliseconds */ const DEFAULT_DEBOUNCE_MS = 1000;
+/**
+ * Delay before initial extraction to allow Vite to finish startup
+ * and avoid race conditions with module resolution.
+ */ const INITIAL_EXTRACTION_DELAY_MS = 1000;
+/**
+ * Creates a Vite plugin that automatically extracts Sanity schema during development and build.
+ *
+ * **During development:**
+ * The plugin performs an initial extraction when the dev server starts, then watches
+ * for file changes and re-extracts the schema when relevant files are modified.
+ *
+ * **During build:**
+ * The plugin extracts the schema once at the end of the build process, ensuring
+ * the schema is always up-to-date when deploying.
+ *
+ * **How it works in dev mode:**
+ * 1. Registers watch patterns with Vite's built-in file watcher
+ * 2. Performs initial schema extraction when the server starts
+ * 3. On file changes matching the patterns, triggers a debounced extraction
+ * 4. Uses concurrency control to prevent overlapping extractions
+ *
+ * @param options - Configuration options for the plugin
+ * @returns A Vite plugin configured for schema extraction
+ *
+ * @internal
+ */ export function sanitySchemaExtractionPlugin(options) {
+    const { additionalPatterns = [], configPath, debounceMs = DEFAULT_DEBOUNCE_MS, enforceRequiredFields = false, format = 'groq-type-nodes', output = console, outputPath: outputPathOption = 'schema.json', telemetryLogger, workDir: workDirOption, workspaceName } = options;
+    const watchPatterns = [
+        ...DEFAULT_SCHEMA_PATTERNS,
+        ...additionalPatterns
+    ];
+    // Resolved after Vite config is available
+    let resolvedWorkDir;
+    let resolvedOutputPath;
+    // State for concurrency control
+    let isExtracting = false;
+    let pendingExtraction = false;
+    // Stats for telemetry
+    const startTime = Date.now();
+    const stats = {
+        failedCount: 0,
+        successfulDurations: []
+    };
+    const extractSchema = ()=>runSchemaExtraction({
+            configPath,
+            enforceRequiredFields,
+            format,
+            outputPath: resolvedOutputPath,
+            workspace: workspaceName
+        });
+    /**
+   * Runs extraction with concurrency control.
+   * If extraction is already running, queues one more extraction to run after completion.
+   */ async function runExtraction(isBuilding = false) {
+        if (isExtracting) {
+            pendingExtraction = true;
+            return;
+        }
+        isExtracting = true;
+        pendingExtraction = false;
+        const extractionStartTime = Date.now();
+        try {
+            await extractSchema();
+            if (isBuilding) {
+                // TODO: Remove when we have better control over progress reporting in build
+                output.log('');
+            }
+            output.log(logSymbols.success, `Extracted schema to ${outputPathOption}`);
+            // add stats for the successful extraction run to use later for telemetry
+            stats.successfulDurations.push(Date.now() - extractionStartTime);
+        } catch (err) {
+            output.error(logSymbols.error, `Extraction failed: ${err instanceof Error ? err.message : String(err)}`);
+            if (err instanceof SchemaExtractionError && err.validation && err.validation.length > 0) {
+                output.error(logSymbols.error, formatSchemaValidation(err.validation));
+            }
+            // track the failed extraction
+            stats.failedCount++;
+        } finally{
+            isExtracting = false;
+            // If a change came in during extraction, run again
+            if (pendingExtraction) {
+                pendingExtraction = false;
+                await runExtraction();
+            }
+        }
+    }
+    const debouncedExtract = debounce(()=>{
+        void runExtraction();
+    }, debounceMs);
+    const { isMatch } = createSchemaPatternMatcher(watchPatterns);
+    const handleChange = (filePath)=>{
+        if (isMatch(filePath, resolvedWorkDir)) {
+            debouncedExtract();
+        }
+    };
+    return {
+        name: 'sanity/schema-extraction',
+        configResolved (config) {
+            // Resolve workDir from option or Vite's project root
+            resolvedWorkDir = workDirOption ?? config.root;
+            resolvedOutputPath = isAbsolute(outputPathOption) ? outputPathOption : path.join(resolvedWorkDir, outputPathOption);
+        },
+        configureServer (server) {
+            const trace = telemetryLogger?.trace(SchemaExtractionWatchModeTrace);
+            trace?.start();
+            trace?.log({
+                enforceRequiredFields,
+                schemaFormat: format,
+                step: 'started'
+            });
+            // Add schema patterns to Vite's watcher
+            const absolutePatterns = watchPatterns.map((pattern)=>path.join(resolvedWorkDir, pattern));
+            server.watcher.add(absolutePatterns);
+            // Prepare function to log "stopped" event to trace and complete the trace
+            const onClose = once(()=>{
+                // Cancel any pending debounced extractions
+                debouncedExtract.cancel();
+                // Log telemetry if available
+                if (trace) {
+                    trace.log({
+                        averageExtractionDuration: mean(stats.successfulDurations) || 0,
+                        extractionFailedCount: stats.failedCount,
+                        extractionSuccessfulCount: stats.successfulDurations.length,
+                        step: 'stopped',
+                        watcherDuration: Date.now() - startTime
+                    });
+                    trace.complete();
+                }
+                // Clean up process listeners (must always run, not just when trace exists)
+                process.off('SIGTERM', onClose);
+                process.off('SIGINT', onClose);
+            });
+            server.watcher.on('change', handleChange);
+            server.watcher.on('add', handleChange);
+            server.watcher.on('unlink', handleChange);
+            // call the watcherClosed method when watcher is closed or when process is stopped/killed
+            server.watcher.on('close', onClose);
+            process.on('SIGTERM', onClose);
+            process.on('SIGINT', onClose);
+            // Run initial extraction after server is ready
+            const startExtraction = ()=>{
+                setTimeout(()=>{
+                    // Notify about schema extraction enabled
+                    output.info(logSymbols.info, 'Schema extraction enabled. Watching:');
+                    for (const pattern of watchPatterns){
+                        output.info(`  - ${pattern}`);
+                    }
+                    // Perform first extraction
+                    void runExtraction();
+                }, INITIAL_EXTRACTION_DELAY_MS);
+            };
+            if (server.httpServer) {
+                server.httpServer.once('listening', startExtraction);
+            } else {
+                // Middleware mode - no HTTP server, run extraction immediately
+                startExtraction();
+            }
+        },
+        async buildEnd () {
+            const trace = telemetryLogger?.trace(SchemaExtractedTrace);
+            trace?.start();
+            try {
+                const start = Date.now();
+                const schema = await extractSchema();
+                output.log(logSymbols.success, `Extracted schema to ${outputPathOption} (${Date.now() - start}ms)`);
+                trace?.log({
+                    enforceRequiredFields,
+                    schemaAllTypesCount: schema.length,
+                    schemaDocumentTypesCount: schema.filter((type)=>type.type === 'document').length,
+                    schemaFormat: format,
+                    schemaTypesCount: schema.filter((type)=>type.type === 'type').length
+                });
+            } catch (err) {
+                trace?.error(err);
+                throw err;
+            } finally{
+                trace?.complete();
+            }
+        }
+    };
+}
+
+//# sourceMappingURL=plugin-schema-extraction.js.map

package/dist/actions/schema/vite/plugin-schema-extraction.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/actions/schema/vite/plugin-schema-extraction.ts"],"sourcesContent":["import path, {isAbsolute} from 'node:path'\n\nimport {type CLITelemetryStore} from '@sanity/cli-core'\nimport {logSymbols} from '@sanity/cli-core/ux'\nimport debounce from 'lodash-es/debounce.js'\nimport mean from 'lodash-es/mean.js'\nimport once from 'lodash-es/once.js'\nimport {type Plugin} from 'vite'\n\nimport {\n  SchemaExtractedTrace,\n  SchemaExtractionWatchModeTrace,\n} from '../../../telemetry/extractSchema.telemetry.js'\nimport {formatSchemaValidation} from '../formatSchemaValidation.js'\nimport {createSchemaPatternMatcher} from '../matchSchemaPattern.js'\nimport {runSchemaExtraction} from '../runSchemaExtraction.js'\nimport {SchemaExtractionError} from '../utils/SchemaExtractionError.js'\n\n/**\n * Default glob patterns to watch for schema changes.\n * Covers the sanity config file and common schema directory naming conventions.\n */\nconst DEFAULT_SCHEMA_PATTERNS = [\n  'sanity.config.{js,jsx,ts,tsx,mjs}',\n  'schema*/**/*.{js,jsx,ts,tsx,mjs}',\n]\n\n/** Default debounce delay in milliseconds */\nconst DEFAULT_DEBOUNCE_MS = 1000\n\n/**\n * Delay before initial extraction to allow Vite to finish startup\n * and avoid race conditions with module resolution.\n */\nconst INITIAL_EXTRACTION_DELAY_MS = 1000\n\n/**\n * Options for the Sanity schema extraction Vite plugin.\n *\n * @public\n */\ninterface SchemaExtractionPluginOptions {\n  /**\n   * Name of sanity config file\n   * @example sanity.config.ts\n   */\n  configPath: string\n\n  /**\n   * Additional glob patterns to watch for schema changes.\n   * These are merged with the default patterns.\n   * @example `['lib/custom-types/**\\/*.ts', 'shared/schemas/**\\/*.ts']`\n   */\n  additionalPatterns?: string[]\n\n  /**\n   * Debounce delay in milliseconds before triggering extraction\n   * after a file change. Helps prevent excessive extractions\n   * during rapid file saves.\n   * @defaultValue 1000\n   */\n  debounceMs?: number\n\n  /**\n   * When true, marks all fields as required in the extracted schema\n   * unless they are explicitly marked as optional.\n   * @defaultValue false\n   */\n  enforceRequiredFields?: boolean\n\n  /**\n   * Format of schema export. groq-type-nodes is the only avilable format at the moment\n   */\n  format?: string\n\n  /**\n   * Logger for output messages. Must implement `log`, `info`, and `error` methods.\n   * @defaultValue `console`\n   */\n  output?: Pick<Console, 'error' | 'info' | 'log'>\n\n  /**\n   * Path where the extracted schema JSON will be written.\n   * Can be absolute or relative to the working directory.\n   * @defaultValue `path.join(workDir, 'schema.json')`\n   */\n  outputPath?: string\n\n  /**\n   * Telemetry logger for the Sanity CLI tooling. If no logger is provided no telemetry\n   * is sent. Also, no telemetry will be sent if telemetry is disabled in the sanity CLI.\n   */\n  telemetryLogger?: CLITelemetryStore\n\n  /**\n   * Working directory containing the Sanity configuration.\n   * This should be the root of your Sanity Studio project where\n   * `sanity.config.ts` is located.\n   * @defaultValue Vite's project root (`config.root`)\n   */\n  workDir?: string\n\n  /**\n   * Workspace name for multi-workspace Sanity configurations.\n   * Required when your `sanity.config.ts` exports multiple workspaces\n   * and you want to extract schema from a specific one.\n   */\n  workspaceName?: string\n}\n\n/**\n * Creates a Vite plugin that automatically extracts Sanity schema during development and build.\n *\n * **During development:**\n * The plugin performs an initial extraction when the dev server starts, then watches\n * for file changes and re-extracts the schema when relevant files are modified.\n *\n * **During build:**\n * The plugin extracts the schema once at the end of the build process, ensuring\n * the schema is always up-to-date when deploying.\n *\n * **How it works in dev mode:**\n * 1. Registers watch patterns with Vite's built-in file watcher\n * 2. Performs initial schema extraction when the server starts\n * 3. On file changes matching the patterns, triggers a debounced extraction\n * 4. Uses concurrency control to prevent overlapping extractions\n *\n * @param options - Configuration options for the plugin\n * @returns A Vite plugin configured for schema extraction\n *\n * @internal\n */\nexport function sanitySchemaExtractionPlugin(options: SchemaExtractionPluginOptions) {\n  const {\n    additionalPatterns = [],\n    configPath,\n    debounceMs = DEFAULT_DEBOUNCE_MS,\n    enforceRequiredFields = false,\n    format = 'groq-type-nodes',\n    output = console,\n    outputPath: outputPathOption = 'schema.json',\n    telemetryLogger,\n    workDir: workDirOption,\n    workspaceName,\n  } = options\n\n  const watchPatterns = [...DEFAULT_SCHEMA_PATTERNS, ...additionalPatterns]\n\n  // Resolved after Vite config is available\n  let resolvedWorkDir: string\n  let resolvedOutputPath: string\n\n  // State for concurrency control\n  let isExtracting = false\n  let pendingExtraction = false\n\n  // Stats for telemetry\n  const startTime = Date.now()\n  const stats: {failedCount: number; successfulDurations: number[]} = {\n    failedCount: 0,\n    successfulDurations: [],\n  }\n\n  const extractSchema = () =>\n    runSchemaExtraction({\n      configPath,\n      enforceRequiredFields,\n      format,\n      outputPath: resolvedOutputPath,\n      workspace: workspaceName,\n    })\n\n  /**\n   * Runs extraction with concurrency control.\n   * If extraction is already running, queues one more extraction to run after completion.\n   */\n  async function runExtraction(isBuilding = false): Promise<void> {\n    if (isExtracting) {\n      pendingExtraction = true\n      return\n    }\n\n    isExtracting = true\n    pendingExtraction = false\n\n    const extractionStartTime = Date.now()\n    try {\n      await extractSchema()\n      if (isBuilding) {\n        // TODO: Remove when we have better control over progress reporting in build\n        output.log('')\n      }\n      output.log(logSymbols.success, `Extracted schema to ${outputPathOption}`)\n\n      // add stats for the successful extraction run to use later for telemetry\n      stats.successfulDurations.push(Date.now() - extractionStartTime)\n    } catch (err) {\n      output.error(\n        logSymbols.error,\n        `Extraction failed: ${err instanceof Error ? err.message : String(err)}`,\n      )\n      if (err instanceof SchemaExtractionError && err.validation && err.validation.length > 0) {\n        output.error(logSymbols.error, formatSchemaValidation(err.validation))\n      }\n\n      // track the failed extraction\n      stats.failedCount++\n    } finally {\n      isExtracting = false\n\n      // If a change came in during extraction, run again\n      if (pendingExtraction) {\n        pendingExtraction = false\n        await runExtraction()\n      }\n    }\n  }\n\n  const debouncedExtract = debounce(() => {\n    void runExtraction()\n  }, debounceMs)\n\n  const {isMatch} = createSchemaPatternMatcher(watchPatterns)\n\n  const handleChange = (filePath: string) => {\n    if (isMatch(filePath, resolvedWorkDir)) {\n      debouncedExtract()\n    }\n  }\n\n  return {\n    name: 'sanity/schema-extraction',\n\n    configResolved(config) {\n      // Resolve workDir from option or Vite's project root\n      resolvedWorkDir = workDirOption ?? config.root\n\n      resolvedOutputPath = isAbsolute(outputPathOption)\n        ? outputPathOption\n        : path.join(resolvedWorkDir, outputPathOption)\n    },\n\n    configureServer(server) {\n      const trace = telemetryLogger?.trace(SchemaExtractionWatchModeTrace)\n      trace?.start()\n\n      trace?.log({enforceRequiredFields, schemaFormat: format, step: 'started'})\n\n      // Add schema patterns to Vite's watcher\n      const absolutePatterns = watchPatterns.map((pattern) => path.join(resolvedWorkDir, pattern))\n      server.watcher.add(absolutePatterns)\n\n      // Prepare function to log \"stopped\" event to trace and complete the trace\n      const onClose = once(() => {\n        // Cancel any pending debounced extractions\n        debouncedExtract.cancel()\n\n        // Log telemetry if available\n        if (trace) {\n          trace.log({\n            averageExtractionDuration: mean(stats.successfulDurations) || 0,\n            extractionFailedCount: stats.failedCount,\n            extractionSuccessfulCount: stats.successfulDurations.length,\n            step: 'stopped',\n            watcherDuration: Date.now() - startTime,\n          })\n          trace.complete()\n        }\n\n        // Clean up process listeners (must always run, not just when trace exists)\n        process.off('SIGTERM', onClose)\n        process.off('SIGINT', onClose)\n      })\n\n      server.watcher.on('change', handleChange)\n      server.watcher.on('add', handleChange)\n      server.watcher.on('unlink', handleChange)\n\n      // call the watcherClosed method when watcher is closed or when process is stopped/killed\n      server.watcher.on('close', onClose)\n      process.on('SIGTERM', onClose)\n      process.on('SIGINT', onClose)\n\n      // Run initial extraction after server is ready\n      const startExtraction = () => {\n        setTimeout(() => {\n          // Notify about schema extraction enabled\n          output.info(logSymbols.info, 'Schema extraction enabled. Watching:')\n          for (const pattern of watchPatterns) {\n            output.info(`  - ${pattern}`)\n          }\n\n          // Perform first extraction\n          void runExtraction()\n        }, INITIAL_EXTRACTION_DELAY_MS)\n      }\n\n      if (server.httpServer) {\n        server.httpServer.once('listening', startExtraction)\n      } else {\n        // Middleware mode - no HTTP server, run extraction immediately\n        startExtraction()\n      }\n    },\n\n    async buildEnd() {\n      const trace = telemetryLogger?.trace(SchemaExtractedTrace)\n      trace?.start()\n\n      try {\n        const start = Date.now()\n        const schema = await extractSchema()\n        output.log(\n          logSymbols.success,\n          `Extracted schema to ${outputPathOption} (${Date.now() - start}ms)`,\n        )\n\n        trace?.log({\n          enforceRequiredFields,\n          schemaAllTypesCount: schema.length,\n          schemaDocumentTypesCount: schema.filter((type) => type.type === 'document').length,\n          schemaFormat: format,\n          schemaTypesCount: schema.filter((type) => type.type === 'type').length,\n        })\n      } catch (err) {\n        trace?.error(err)\n        throw err\n      } finally {\n        trace?.complete()\n      }\n    },\n  } satisfies Plugin\n}\n"],"names":["path","isAbsolute","logSymbols","debounce","mean","once","SchemaExtractedTrace","SchemaExtractionWatchModeTrace","formatSchemaValidation","createSchemaPatternMatcher","runSchemaExtraction","SchemaExtractionError","DEFAULT_SCHEMA_PATTERNS","DEFAULT_DEBOUNCE_MS","INITIAL_EXTRACTION_DELAY_MS","sanitySchemaExtractionPlugin","options","additionalPatterns","configPath","debounceMs","enforceRequiredFields","format","output","console","outputPath","outputPathOption","telemetryLogger","workDir","workDirOption","workspaceName","watchPatterns","resolvedWorkDir","resolvedOutputPath","isExtracting","pendingExtraction","startTime","Date","now","stats","failedCount","successfulDurations","extractSchema","workspace","runExtraction","isBuilding","extractionStartTime","log","success","push","err","error","Error","message","String","validation","length","debouncedExtract","isMatch","handleChange","filePath","name","configResolved","config","root","join","configureServer","server","trace","start","schemaFormat","step","absolutePatterns","map","pattern","watcher","add","onClose","cancel","averageExtractionDuration","extractionFailedCount","extractionSuccessfulCount","watcherDuration","complete","process","off","on","startExtraction","setTimeout","info","httpServer","buildEnd","schema","schemaAllTypesCount","schemaDocumentTypesCount","filter","type","schemaTypesCount"],"mappings":"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"}

package/dist/constants.js

@@ -0,0 +1,8 @@
+/**
+ * Root directory (relative to the project) used by Sanity tooling for
+ * build-time artifacts and caches — Vite's `cacheDir` and the dev-time
+ * manifest output. Lives under `node_modules/` so it's out of `dist` and
+ * ignored by default in typical `.gitignore` files.
+ */ export const SANITY_CACHE_DIR = 'node_modules/.sanity';
+
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.ts"],"sourcesContent":["/**\n * Root directory (relative to the project) used by Sanity tooling for\n * build-time artifacts and caches — Vite's `cacheDir` and the dev-time\n * manifest output. Lives under `node_modules/` so it's out of `dist` and\n * ignored by default in typical `.gitignore` files.\n */\nexport const SANITY_CACHE_DIR = 'node_modules/.sanity'\n"],"names":["SANITY_CACHE_DIR"],"mappings":"AAAA;;;;;CAKC,GACD,OAAO,MAAMA,mBAAmB,uBAAsB"}

package/dist/telemetry/build.telemetry.js

@@ -0,0 +1,13 @@
+import { defineTrace } from '@sanity/telemetry';
+export const StudioBuildTrace = defineTrace({
+    description: 'A Studio build completed',
+    name: 'Studio Build Completed',
+    version: 0
+});
+export const AppBuildTrace = defineTrace({
+    description: 'An App build completed',
+    name: 'App Build Completed',
+    version: 0
+});
+
+//# sourceMappingURL=build.telemetry.js.map

package/dist/telemetry/build.telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/telemetry/build.telemetry.ts"],"sourcesContent":["import {defineTrace} from '@sanity/telemetry'\n\nexport const StudioBuildTrace = defineTrace<{outputSize: number}>({\n  description: 'A Studio build completed',\n  name: 'Studio Build Completed',\n  version: 0,\n})\n\nexport const AppBuildTrace = defineTrace<{outputSize: number}>({\n  description: 'An App build completed',\n  name: 'App Build Completed',\n  version: 0,\n})\n"],"names":["defineTrace","StudioBuildTrace","description","name","version","AppBuildTrace"],"mappings":"AAAA,SAAQA,WAAW,QAAO,oBAAmB;AAE7C,OAAO,MAAMC,mBAAmBD,YAAkC;IAChEE,aAAa;IACbC,MAAM;IACNC,SAAS;AACX,GAAE;AAEF,OAAO,MAAMC,gBAAgBL,YAAkC;IAC7DE,aAAa;IACbC,MAAM;IACNC,SAAS;AACX,GAAE"}

package/dist/telemetry/extractSchema.telemetry.js

@@ -0,0 +1,18 @@
+import { defineTrace } from '@sanity/telemetry';
+export const SchemaExtractedTrace = defineTrace({
+    description: 'Trace emitted when extracting schema',
+    name: 'Schema Extracted',
+    version: 0
+});
+export const SchemaExtractionWatchModeTrace = defineTrace({
+    description: 'Trace emitted when schema extraction watch mode is run',
+    name: 'Schema Extraction Watch Mode',
+    version: 0
+});
+export const SchemaDeploy = defineTrace({
+    description: 'Schema deploy action was executed, either via sanity schema deploy or as sanity deploy',
+    name: 'Schema deploy action executed',
+    version: 1
+});
+
+//# sourceMappingURL=extractSchema.telemetry.js.map

package/dist/telemetry/extractSchema.telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/telemetry/extractSchema.telemetry.ts"],"sourcesContent":["import {defineTrace} from '@sanity/telemetry'\n\ninterface SchemaExtractedTraceAttributes {\n  enforceRequiredFields: boolean\n  schemaAllTypesCount: number\n  schemaDocumentTypesCount: number\n\n  schemaFormat: string\n  schemaTypesCount: number\n}\n\ntype SchemaExtractionWatchModeAttributes =\n  | {\n      averageExtractionDuration: number\n      extractionFailedCount: number\n      extractionSuccessfulCount: number\n      step: 'stopped'\n      watcherDuration: number\n    }\n  | {\n      enforceRequiredFields: boolean\n      schemaFormat: string\n      step: 'started'\n    }\n\ninterface SchemaDeployTraceData {\n  manifestDir: string\n  schemaRequired: boolean\n\n  extractManifest?: boolean\n}\n\nexport const SchemaExtractedTrace = defineTrace<SchemaExtractedTraceAttributes>({\n  description: 'Trace emitted when extracting schema',\n  name: 'Schema Extracted',\n  version: 0,\n})\n\nexport const SchemaExtractionWatchModeTrace = defineTrace<SchemaExtractionWatchModeAttributes>({\n  description: 'Trace emitted when schema extraction watch mode is run',\n  name: 'Schema Extraction Watch Mode',\n  version: 0,\n})\n\nexport const SchemaDeploy = defineTrace<SchemaDeployTraceData>({\n  description:\n    'Schema deploy action was executed, either via sanity schema deploy or as sanity deploy',\n  name: 'Schema deploy action executed',\n  version: 1,\n})\n"],"names":["defineTrace","SchemaExtractedTrace","description","name","version","SchemaExtractionWatchModeTrace","SchemaDeploy"],"mappings":"AAAA,SAAQA,WAAW,QAAO,oBAAmB;AAgC7C,OAAO,MAAMC,uBAAuBD,YAA4C;IAC9EE,aAAa;IACbC,MAAM;IACNC,SAAS;AACX,GAAE;AAEF,OAAO,MAAMC,iCAAiCL,YAAiD;IAC7FE,aAAa;IACbC,MAAM;IACNC,SAAS;AACX,GAAE;AAEF,OAAO,MAAME,eAAeN,YAAmC;IAC7DE,aACE;IACFC,MAAM;IACNC,SAAS;AACX,GAAE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanity/cli-build",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Internal Sanity package for building studios and apps",
   "keywords": [
     "cli",
@@ -27,12 +27,14 @@
   ],
   "type": "module",
   "sideEffects": false,
-  "main": "./dist/_exports/_internal.js",
-  "types": "./dist/_exports/_internal.d.ts",
   "exports": {
-    "./_internal": {
-      "source": "./src/_exports/_internal.ts",
-      "default": "./dist/_exports/_internal.js"
+    "./_internal/build": {
+      "source": "./src/_exports/_internal/build.ts",
+      "default": "./dist/_exports/_internal/build.js"
+    },
+    "./_internal/extract": {
+      "source": "./src/_exports/_internal/extract.ts",
+      "default": "./dist/_exports/_internal/extract.js"
     },
     "./package.json": "./package.json"
   },
@@ -40,17 +42,44 @@
     "access": "public"
   },
   "dependencies": {
-    "read-package-up": "^12.0.0"
+    "@oclif/core": "^4.11.0",
+    "@sanity/generate-help-url": "^4.0.0",
+    "@sanity/schema": "^5.26.0",
+    "@sanity/telemetry": "^0.9.0",
+    "@sanity/types": "^5.26.0",
+    "@vitejs/plugin-react": "^5.2.0",
+    "chokidar": "^5.0.0",
+    "debug": "^4.4.3",
+    "lodash-es": "^4.18.1",
+    "node-html-parser": "^7.1.0",
+    "picomatch": "^4.0.4",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "read-package-up": "^12.0.0",
+    "semver": "^7.7.4",
+    "vite": "^7.3.3",
+    "zod": "^4.3.6",
+    "@sanity/cli-core": "^1.3.2"
   },
   "devDependencies": {
     "@eslint/compat": "^2.0.5",
     "@sanity/pkg-utils": "^10.4.18",
     "@swc/cli": "^0.8.1",
     "@swc/core": "^1.15.33",
-    "@types/node": "^20.19.39",
+    "@types/debug": "^4.1.13",
+    "@types/jsdom": "^28.0.3",
+    "@types/lodash-es": "^4.17.12",
+    "@types/node": "^20.19.41",
+    "@types/picomatch": "^4.0.3",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@types/semver": "^7.7.1",
     "@vitest/coverage-istanbul": "^4.1.5",
+    "babel-plugin-react-compiler": "^1.0.0",
     "eslint": "^10.2.1",
+    "jsdom": "^29.1.1",
     "publint": "^0.3.18",
+    "sanity": "^5.26.0",
     "typescript": "^5.9.3",
     "vitest": "^4.1.5",
     "@repo/package.config": "0.0.1",

package/dist/_exports/_internal.d.ts

@@ -1,45 +0,0 @@
-/**
- * Copies a directory from one location to another
- *
- * @internal
- *
- * @param srcDir - Source directory
- * @param destDir - Destination directory
- * @param skipExisting - Skip existing files
- */
-export declare function copyDir(
-  srcDir: string,
-  destDir: string,
-  skipExisting?: boolean,
-): Promise<void>;
-
-/**
- * @internal
- */
-export declare function generateWebManifest(basePath: string): WebManifest;
-
-/**
- * @internal
- */
-export declare function getDefaultFaviconsPath(): Promise<string>;
-
-/**
- * @internal
- */
-declare interface WebManifest {
-  icons: {
-    sizes: string;
-    src: string;
-    type: string;
-  }[];
-}
-
-/**
- * @internal
- */
-export declare function writeFavicons(
-  basePath: string,
-  destDir: string,
-): Promise<void>;
-
-export {};

package/dist/_exports/_internal.js

@@ -1,5 +0,0 @@
-export * from '../actions/build/generateWebManifest.js';
-export * from '../actions/build/writeFavicons.js';
-export { copyDir } from '../util/copyDir.js';
-
-//# sourceMappingURL=_internal.js.map

package/dist/_exports/_internal.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/_exports/_internal.ts"],"sourcesContent":["export * from '../actions/build/generateWebManifest.js'\nexport * from '../actions/build/writeFavicons.js'\nexport {copyDir} from '../util/copyDir.js'\n"],"names":["copyDir"],"mappings":"AAAA,cAAc,0CAAyC;AACvD,cAAc,oCAAmC;AACjD,SAAQA,OAAO,QAAO,qBAAoB"}