@sanity/cli-core 0.0.0-20260424084316 → 0.0.0-20260428150004

package/dist/_exports/index.d.ts

@@ -402,6 +402,10 @@ declare type Flags<T extends typeof Command> = Interfaces.InferredFlags<
  *
  * If loading fails the cached promise is evicted so the next call retries.
  *
+ * Long-lived processes that need to observe edits to `sanity.cli.(ts|js)`
+ * (e.g. a dev-server watcher) should use {@link getCliConfigUncached}
+ * instead — it bypasses both this in-memory cache and Node's module cache.
+ *
  * @param rootPath - Root path for the project, eg where `sanity.cli.(ts|js)` is located.
  * @returns The CLI config
  * @internal
@@ -420,6 +424,26 @@ export declare function getCliConfig(rootPath: string): Promise<CliConfig>;
  */
 export declare function getCliConfigSync(rootPath: string): CliConfig;
 
+/**
+ * Read the CLI config for a project from disk, bypassing both the
+ * `getCliConfig` in-memory cache and Node's module cache. Each call locates
+ * `sanity.cli.(ts|js)`, drops any prior jiti compilation from `require.cache`,
+ * re-imports, and re-validates.
+ *
+ * Use this when the config file is expected to change during the process's
+ * lifetime — typically a dev-server watcher that needs the new values picked
+ * up after each save. One-shot CLI invocations should prefer
+ * {@link getCliConfig} so the prerun hook, SanityCommand helpers, and action
+ * files share a single load.
+ *
+ * @param rootPath - Root path for the project, eg where `sanity.cli.(ts|js)` is located.
+ * @returns The freshly loaded CLI config
+ * @internal
+ */
+export declare function getCliConfigUncached(
+  rootPath: string,
+): Promise<CliConfig>;
+
 /**
  * @public
  */

package/dist/config/cli/getCliConfig.js

@@ -1,3 +1,4 @@
+import { createRequire } from 'node:module';
 import { debug } from '../../debug.js';
 import { NotFoundError } from '../../errors/NotFoundError.js';
 import { importModule } from '../../util/importModule.js';
@@ -15,6 +16,10 @@ const cache = new Map();
  *
  * If loading fails the cached promise is evicted so the next call retries.
  *
+ * Long-lived processes that need to observe edits to `sanity.cli.(ts|js)`
+ * (e.g. a dev-server watcher) should use {@link getCliConfigUncached}
+ * instead — it bypasses both this in-memory cache and Node's module cache.
+ *
  * @param rootPath - Root path for the project, eg where `sanity.cli.(ts|js)` is located.
  * @returns The CLI config
  * @internal
@@ -23,14 +28,29 @@ const cache = new Map();
     if (cached) {
         return cached;
     }
-    const promise = loadCliConfig(rootPath).catch((err)=>{
+    const promise = getCliConfigUncached(rootPath).catch((err)=>{
         cache.delete(rootPath);
         throw err;
     });
     cache.set(rootPath, promise);
     return promise;
 }
-async function loadCliConfig(rootPath) {
+/**
+ * Read the CLI config for a project from disk, bypassing both the
+ * `getCliConfig` in-memory cache and Node's module cache. Each call locates
+ * `sanity.cli.(ts|js)`, drops any prior jiti compilation from `require.cache`,
+ * re-imports, and re-validates.
+ *
+ * Use this when the config file is expected to change during the process's
+ * lifetime — typically a dev-server watcher that needs the new values picked
+ * up after each save. One-shot CLI invocations should prefer
+ * {@link getCliConfig} so the prerun hook, SanityCommand helpers, and action
+ * files share a single load.
+ *
+ * @param rootPath - Root path for the project, eg where `sanity.cli.(ts|js)` is located.
+ * @returns The freshly loaded CLI config
+ * @internal
+ */ export async function getCliConfigUncached(rootPath) {
     const paths = await findPathForFiles(rootPath, [
         'sanity.cli.ts',
         'sanity.cli.js'
@@ -44,6 +64,12 @@ async function loadCliConfig(rootPath) {
     }
     const configPath = configPaths[0].path;
     debug(`Loading CLI config from: ${configPath}`);
+    // Drop any cached compilation of this file from Node's CJS module cache
+    // (jiti compiles `sanity.cli.ts` to CJS and registers it via `require.cache`).
+    // Without this, repeated calls would receive the previously imported module
+    // even though the file on disk has changed. No-op on first load.
+    const cjsRequire = createRequire(import.meta.url);
+    delete cjsRequire.cache[configPath];
     let cliConfig;
     try {
         const result = await importModule(configPath);

package/dist/config/cli/getCliConfig.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/config/cli/getCliConfig.ts"],"sourcesContent":["import {debug} from '../../debug.js'\nimport {NotFoundError} from '../../errors/NotFoundError.js'\nimport {importModule} from '../../util/importModule.js'\nimport {findPathForFiles} from '../util/findConfigsPaths.js'\nimport {cliConfigSchema} from './schemas.js'\nimport {type CliConfig} from './types/cliConfig.js'\n\nconst cache = new Map<string, Promise<CliConfig>>()\n\n/**\n * Get the CLI config for a project, given the root path.\n *\n * Results are cached in-memory keyed by rootPath for the lifetime of the\n * process. Since the CLI always runs from a single project root, the config\n * won't change during a command's execution, so caching avoids redundant\n * filesystem reads and jiti imports from the prerun hook, SanityCommand\n * helpers, and action files.\n *\n * If loading fails the cached promise is evicted so the next call retries.\n *\n * @param rootPath - Root path for the project, eg where `sanity.cli.(ts|js)` is located.\n * @returns The CLI config\n * @internal\n */\nexport function getCliConfig(rootPath: string): Promise<CliConfig> {\n  const cached = cache.get(rootPath)\n  if (cached) {\n    return cached\n  }\n\n  const promise = loadCliConfig(rootPath).catch((err) => {\n    cache.delete(rootPath)\n    throw err\n  })\n\n  cache.set(rootPath, promise)\n  return promise\n}\n\nasync function loadCliConfig(rootPath: string): Promise<CliConfig> {\n  const paths = await findPathForFiles(rootPath, ['sanity.cli.ts', 'sanity.cli.js'])\n  const configPaths = paths.filter((path) => path.exists)\n\n  if (configPaths.length === 0) {\n    throw new NotFoundError(`No CLI config found at ${rootPath}/sanity.cli.(ts|js)`)\n  }\n\n  if (configPaths.length > 1) {\n    throw new Error(\n      `Multiple CLI config files found (${configPaths.map((path) => path.path).join(', ')})`,\n    )\n  }\n\n  const configPath = configPaths[0].path\n\n  debug(`Loading CLI config from: ${configPath}`)\n\n  let cliConfig: CliConfig | undefined\n  try {\n    const result = await importModule<CliConfig>(configPath)\n\n    debug('CLI config loaded: %o', result)\n\n    cliConfig = result\n  } catch (err) {\n    debug('Failed to load CLI config in worker thread: %s', err)\n\n    throw new Error('CLI config cannot be loaded', {cause: err})\n  }\n\n  const {data, error, success} = cliConfigSchema.safeParse(cliConfig)\n  if (!success) {\n    debug(`Invalid CLI config: ${error.message}`)\n    throw new Error(`Invalid CLI config: ${error.message}`, {cause: error})\n  }\n\n  return data\n}\n"],"names":["debug","NotFoundError","importModule","findPathForFiles","cliConfigSchema","cache","Map","getCliConfig","rootPath","cached","get","promise","loadCliConfig","catch","err","delete","set","paths","configPaths","filter","path","exists","length","Error","map","join","configPath","cliConfig","result","cause","data","error","success","safeParse","message"],"mappings":"AAAA,SAAQA,KAAK,QAAO,iBAAgB;AACpC,SAAQC,aAAa,QAAO,gCAA+B;AAC3D,SAAQC,YAAY,QAAO,6BAA4B;AACvD,SAAQC,gBAAgB,QAAO,8BAA6B;AAC5D,SAAQC,eAAe,QAAO,eAAc;AAG5C,MAAMC,QAAQ,IAAIC;AAElB;;;;;;;;;;;;;;CAcC,GACD,OAAO,SAASC,aAAaC,QAAgB;IAC3C,MAAMC,SAASJ,MAAMK,GAAG,CAACF;IACzB,IAAIC,QAAQ;QACV,OAAOA;IACT;IAEA,MAAME,UAAUC,cAAcJ,UAAUK,KAAK,CAAC,CAACC;QAC7CT,MAAMU,MAAM,CAACP;QACb,MAAMM;IACR;IAEAT,MAAMW,GAAG,CAACR,UAAUG;IACpB,OAAOA;AACT;AAEA,eAAeC,cAAcJ,QAAgB;IAC3C,MAAMS,QAAQ,MAAMd,iBAAiBK,UAAU;QAAC;QAAiB;KAAgB;IACjF,MAAMU,cAAcD,MAAME,MAAM,CAAC,CAACC,OAASA,KAAKC,MAAM;IAEtD,IAAIH,YAAYI,MAAM,KAAK,GAAG;QAC5B,MAAM,IAAIrB,cAAc,CAAC,uBAAuB,EAAEO,SAAS,mBAAmB,CAAC;IACjF;IAEA,IAAIU,YAAYI,MAAM,GAAG,GAAG;QAC1B,MAAM,IAAIC,MACR,CAAC,iCAAiC,EAAEL,YAAYM,GAAG,CAAC,CAACJ,OAASA,KAAKA,IAAI,EAAEK,IAAI,CAAC,MAAM,CAAC,CAAC;IAE1F;IAEA,MAAMC,aAAaR,WAAW,CAAC,EAAE,CAACE,IAAI;IAEtCpB,MAAM,CAAC,yBAAyB,EAAE0B,YAAY;IAE9C,IAAIC;IACJ,IAAI;QACF,MAAMC,SAAS,MAAM1B,aAAwBwB;QAE7C1B,MAAM,yBAAyB4B;QAE/BD,YAAYC;IACd,EAAE,OAAOd,KAAK;QACZd,MAAM,kDAAkDc;QAExD,MAAM,IAAIS,MAAM,+BAA+B;YAACM,OAAOf;QAAG;IAC5D;IAEA,MAAM,EAACgB,IAAI,EAAEC,KAAK,EAAEC,OAAO,EAAC,GAAG5B,gBAAgB6B,SAAS,CAACN;IACzD,IAAI,CAACK,SAAS;QACZhC,MAAM,CAAC,oBAAoB,EAAE+B,MAAMG,OAAO,EAAE;QAC5C,MAAM,IAAIX,MAAM,CAAC,oBAAoB,EAAEQ,MAAMG,OAAO,EAAE,EAAE;YAACL,OAAOE;QAAK;IACvE;IAEA,OAAOD;AACT"}
+{"version":3,"sources":["../../../src/config/cli/getCliConfig.ts"],"sourcesContent":["import {createRequire} from 'node:module'\n\nimport {debug} from '../../debug.js'\nimport {NotFoundError} from '../../errors/NotFoundError.js'\nimport {importModule} from '../../util/importModule.js'\nimport {findPathForFiles} from '../util/findConfigsPaths.js'\nimport {cliConfigSchema} from './schemas.js'\nimport {type CliConfig} from './types/cliConfig.js'\n\nconst cache = new Map<string, Promise<CliConfig>>()\n\n/**\n * Get the CLI config for a project, given the root path.\n *\n * Results are cached in-memory keyed by rootPath for the lifetime of the\n * process. Since the CLI always runs from a single project root, the config\n * won't change during a command's execution, so caching avoids redundant\n * filesystem reads and jiti imports from the prerun hook, SanityCommand\n * helpers, and action files.\n *\n * If loading fails the cached promise is evicted so the next call retries.\n *\n * Long-lived processes that need to observe edits to `sanity.cli.(ts|js)`\n * (e.g. a dev-server watcher) should use {@link getCliConfigUncached}\n * instead — it bypasses both this in-memory cache and Node's module cache.\n *\n * @param rootPath - Root path for the project, eg where `sanity.cli.(ts|js)` is located.\n * @returns The CLI config\n * @internal\n */\nexport function getCliConfig(rootPath: string): Promise<CliConfig> {\n  const cached = cache.get(rootPath)\n  if (cached) {\n    return cached\n  }\n\n  const promise = getCliConfigUncached(rootPath).catch((err) => {\n    cache.delete(rootPath)\n    throw err\n  })\n\n  cache.set(rootPath, promise)\n  return promise\n}\n\n/**\n * Read the CLI config for a project from disk, bypassing both the\n * `getCliConfig` in-memory cache and Node's module cache. Each call locates\n * `sanity.cli.(ts|js)`, drops any prior jiti compilation from `require.cache`,\n * re-imports, and re-validates.\n *\n * Use this when the config file is expected to change during the process's\n * lifetime — typically a dev-server watcher that needs the new values picked\n * up after each save. One-shot CLI invocations should prefer\n * {@link getCliConfig} so the prerun hook, SanityCommand helpers, and action\n * files share a single load.\n *\n * @param rootPath - Root path for the project, eg where `sanity.cli.(ts|js)` is located.\n * @returns The freshly loaded CLI config\n * @internal\n */\nexport async function getCliConfigUncached(rootPath: string): Promise<CliConfig> {\n  const paths = await findPathForFiles(rootPath, ['sanity.cli.ts', 'sanity.cli.js'])\n  const configPaths = paths.filter((path) => path.exists)\n\n  if (configPaths.length === 0) {\n    throw new NotFoundError(`No CLI config found at ${rootPath}/sanity.cli.(ts|js)`)\n  }\n\n  if (configPaths.length > 1) {\n    throw new Error(\n      `Multiple CLI config files found (${configPaths.map((path) => path.path).join(', ')})`,\n    )\n  }\n\n  const configPath = configPaths[0].path\n\n  debug(`Loading CLI config from: ${configPath}`)\n\n  // Drop any cached compilation of this file from Node's CJS module cache\n  // (jiti compiles `sanity.cli.ts` to CJS and registers it via `require.cache`).\n  // Without this, repeated calls would receive the previously imported module\n  // even though the file on disk has changed. No-op on first load.\n  const cjsRequire = createRequire(import.meta.url)\n  delete cjsRequire.cache[configPath]\n\n  let cliConfig: CliConfig | undefined\n  try {\n    const result = await importModule<CliConfig>(configPath)\n\n    debug('CLI config loaded: %o', result)\n\n    cliConfig = result\n  } catch (err) {\n    debug('Failed to load CLI config in worker thread: %s', err)\n\n    throw new Error('CLI config cannot be loaded', {cause: err})\n  }\n\n  const {data, error, success} = cliConfigSchema.safeParse(cliConfig)\n  if (!success) {\n    debug(`Invalid CLI config: ${error.message}`)\n    throw new Error(`Invalid CLI config: ${error.message}`, {cause: error})\n  }\n\n  return data\n}\n"],"names":["createRequire","debug","NotFoundError","importModule","findPathForFiles","cliConfigSchema","cache","Map","getCliConfig","rootPath","cached","get","promise","getCliConfigUncached","catch","err","delete","set","paths","configPaths","filter","path","exists","length","Error","map","join","configPath","cjsRequire","url","cliConfig","result","cause","data","error","success","safeParse","message"],"mappings":"AAAA,SAAQA,aAAa,QAAO,cAAa;AAEzC,SAAQC,KAAK,QAAO,iBAAgB;AACpC,SAAQC,aAAa,QAAO,gCAA+B;AAC3D,SAAQC,YAAY,QAAO,6BAA4B;AACvD,SAAQC,gBAAgB,QAAO,8BAA6B;AAC5D,SAAQC,eAAe,QAAO,eAAc;AAG5C,MAAMC,QAAQ,IAAIC;AAElB;;;;;;;;;;;;;;;;;;CAkBC,GACD,OAAO,SAASC,aAAaC,QAAgB;IAC3C,MAAMC,SAASJ,MAAMK,GAAG,CAACF;IACzB,IAAIC,QAAQ;QACV,OAAOA;IACT;IAEA,MAAME,UAAUC,qBAAqBJ,UAAUK,KAAK,CAAC,CAACC;QACpDT,MAAMU,MAAM,CAACP;QACb,MAAMM;IACR;IAEAT,MAAMW,GAAG,CAACR,UAAUG;IACpB,OAAOA;AACT;AAEA;;;;;;;;;;;;;;;CAeC,GACD,OAAO,eAAeC,qBAAqBJ,QAAgB;IACzD,MAAMS,QAAQ,MAAMd,iBAAiBK,UAAU;QAAC;QAAiB;KAAgB;IACjF,MAAMU,cAAcD,MAAME,MAAM,CAAC,CAACC,OAASA,KAAKC,MAAM;IAEtD,IAAIH,YAAYI,MAAM,KAAK,GAAG;QAC5B,MAAM,IAAIrB,cAAc,CAAC,uBAAuB,EAAEO,SAAS,mBAAmB,CAAC;IACjF;IAEA,IAAIU,YAAYI,MAAM,GAAG,GAAG;QAC1B,MAAM,IAAIC,MACR,CAAC,iCAAiC,EAAEL,YAAYM,GAAG,CAAC,CAACJ,OAASA,KAAKA,IAAI,EAAEK,IAAI,CAAC,MAAM,CAAC,CAAC;IAE1F;IAEA,MAAMC,aAAaR,WAAW,CAAC,EAAE,CAACE,IAAI;IAEtCpB,MAAM,CAAC,yBAAyB,EAAE0B,YAAY;IAE9C,wEAAwE;IACxE,+EAA+E;IAC/E,4EAA4E;IAC5E,iEAAiE;IACjE,MAAMC,aAAa5B,cAAc,YAAY6B,GAAG;IAChD,OAAOD,WAAWtB,KAAK,CAACqB,WAAW;IAEnC,IAAIG;IACJ,IAAI;QACF,MAAMC,SAAS,MAAM5B,aAAwBwB;QAE7C1B,MAAM,yBAAyB8B;QAE/BD,YAAYC;IACd,EAAE,OAAOhB,KAAK;QACZd,MAAM,kDAAkDc;QAExD,MAAM,IAAIS,MAAM,+BAA+B;YAACQ,OAAOjB;QAAG;IAC5D;IAEA,MAAM,EAACkB,IAAI,EAAEC,KAAK,EAAEC,OAAO,EAAC,GAAG9B,gBAAgB+B,SAAS,CAACN;IACzD,IAAI,CAACK,SAAS;QACZlC,MAAM,CAAC,oBAAoB,EAAEiC,MAAMG,OAAO,EAAE;QAC5C,MAAM,IAAIb,MAAM,CAAC,oBAAoB,EAAEU,MAAMG,OAAO,EAAE,EAAE;YAACL,OAAOE;QAAK;IACvE;IAEA,OAAOD;AACT"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanity/cli-core",
-  "version": "0.0.0-20260424084316",
+  "version": "0.0.0-20260428150004",
   "description": "Sanity CLI core package",
   "keywords": [
     "cli",