@intlayer/config 9.0.0-canary.12 → 9.0.0-canary.15

package/dist/cjs/loadEnvFile.cjs

@@ -14,16 +14,53 @@ const getEnvFilePath = (env = process.env.NODE_ENV ?? "development", envFile) =>
 		".env"
 	]).find(node_fs.existsSync);
 };
-const loadEnvFile = (options) => {
-	const envFiles = getEnvFilePath(options?.env ?? DEFAULT_ENV, options?.envFile);
-	if (!envFiles) return {};
-	const result = {};
+/**
+* Cache of parsed env files keyed by `cwd|env|envFile`. Loading content
+* declarations calls `loadEnvFile` once per file; without this every call pays
+* up to 4 `existsSync` probes plus a dotenv read+parse. A cached hit is
+* validated with a single `stat` so edits to the env file are still picked up.
+*/
+const envFileCache = /* @__PURE__ */ new Map();
+const parseEnvFile = (envFilePath) => {
+	const parsedEnv = {};
 	dotenv.default.config({
-		path: envFiles,
-		processEnv: result,
+		path: envFilePath,
+		processEnv: parsedEnv,
 		quiet: true
 	});
-	return result;
+	return parsedEnv;
+};
+const loadEnvFile = (options) => {
+	const env = options?.env ?? DEFAULT_ENV;
+	const cacheKey = `${process.cwd()}|${env}|${options?.envFile ?? ""}`;
+	const cachedEntry = envFileCache.get(cacheKey);
+	if (cachedEntry) if (cachedEntry.envFilePath === void 0) {
+		if (!getEnvFilePath(env, options?.envFile)) return cachedEntry.parsedEnv;
+	} else try {
+		const stats = (0, node_fs.statSync)(cachedEntry.envFilePath);
+		if (stats.mtimeMs === cachedEntry.mtimeMs && stats.size === cachedEntry.size) return cachedEntry.parsedEnv;
+	} catch {}
+	const envFilePath = getEnvFilePath(env, options?.envFile);
+	if (!envFilePath) {
+		envFileCache.set(cacheKey, {
+			envFilePath: void 0,
+			mtimeMs: 0,
+			size: 0,
+			parsedEnv: {}
+		});
+		return {};
+	}
+	const parsedEnv = parseEnvFile(envFilePath);
+	try {
+		const stats = (0, node_fs.statSync)(envFilePath);
+		envFileCache.set(cacheKey, {
+			envFilePath,
+			mtimeMs: stats.mtimeMs,
+			size: stats.size,
+			parsedEnv
+		});
+	} catch {}
+	return parsedEnv;
 };
 
 //#endregion

package/dist/cjs/loadEnvFile.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"loadEnvFile.cjs","names":["existsSync"],"sources":["../../src/loadEnvFile.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport dotenv from 'dotenv';\n\nconst DEFAULT_ENV = process.env.NODE_ENV ?? 'development';\n\nexport type LoadEnvFileOptions = {\n  env?: string;\n  envFile?: string;\n};\n\nexport const getEnvFilePath = (\n  env: string = process.env.NODE_ENV ?? 'development',\n  envFile?: string\n): string | undefined => {\n  const envFiles = envFile\n    ? [envFile]\n    : [`.env.${env}.local`, `.env.${env}`, '.env.local', '.env'];\n\n  return envFiles.find(existsSync); // Returns the first existing env file\n};\n\nexport const loadEnvFile = (options?: Partial<LoadEnvFileOptions>) => {\n  const env = options?.env ?? DEFAULT_ENV;\n\n  const envFiles = getEnvFilePath(env, options?.envFile);\n\n  if (!envFiles) {\n    return {};\n  }\n\n  const result = {};\n\n  dotenv.config({\n    path: envFiles,\n    processEnv: result,\n    quiet: true,\n  });\n\n  return result; // Return the parsed env object\n};\n"],"mappings":";;;;;;;AAGA,MAAM,cAAc,QAAQ,IAAI,YAAY;AAO5C,MAAa,kBACX,MAAc,QAAQ,IAAI,YAAY,eACtC,YACuB;AAKvB,SAJiB,UACb,CAAC,QAAQ,GACT;EAAC,QAAQ,IAAI;EAAS,QAAQ;EAAO;EAAc;EAAO,EAE9C,KAAKA,mBAAW;;AAGlC,MAAa,eAAe,YAA0C;CAGpE,MAAM,WAAW,eAFL,SAAS,OAAO,aAES,SAAS,QAAQ;AAEtD,KAAI,CAAC,SACH,QAAO,EAAE;CAGX,MAAM,SAAS,EAAE;AAEjB,gBAAO,OAAO;EACZ,MAAM;EACN,YAAY;EACZ,OAAO;EACR,CAAC;AAEF,QAAO"}
+{"version":3,"file":"loadEnvFile.cjs","names":["existsSync"],"sources":["../../src/loadEnvFile.ts"],"sourcesContent":["import { existsSync, statSync } from 'node:fs';\nimport dotenv from 'dotenv';\n\nconst DEFAULT_ENV = process.env.NODE_ENV ?? 'development';\n\nexport type LoadEnvFileOptions = {\n  env?: string;\n  envFile?: string;\n};\n\nexport const getEnvFilePath = (\n  env: string = process.env.NODE_ENV ?? 'development',\n  envFile?: string\n): string | undefined => {\n  const envFiles = envFile\n    ? [envFile]\n    : [`.env.${env}.local`, `.env.${env}`, '.env.local', '.env'];\n\n  return envFiles.find(existsSync); // Returns the first existing env file\n};\n\ntype EnvFileCacheEntry = {\n  /** The env file that was resolved and parsed (undefined if none exists). */\n  envFilePath: string | undefined;\n  /** Fingerprint of the parsed file, used to detect edits. */\n  mtimeMs: number;\n  size: number;\n  /** The parsed env variables. */\n  parsedEnv: Record<string, string>;\n};\n\n/**\n * Cache of parsed env files keyed by `cwd|env|envFile`. Loading content\n * declarations calls `loadEnvFile` once per file; without this every call pays\n * up to 4 `existsSync` probes plus a dotenv read+parse. A cached hit is\n * validated with a single `stat` so edits to the env file are still picked up.\n */\nconst envFileCache = new Map<string, EnvFileCacheEntry>();\n\nconst parseEnvFile = (envFilePath: string): Record<string, string> => {\n  const parsedEnv: Record<string, string> = {};\n\n  dotenv.config({\n    path: envFilePath,\n    processEnv: parsedEnv,\n    quiet: true,\n  });\n\n  return parsedEnv;\n};\n\nexport const loadEnvFile = (\n  options?: Partial<LoadEnvFileOptions>\n): Record<string, string> => {\n  const env = options?.env ?? DEFAULT_ENV;\n\n  // Env file candidates are resolved relative to the working directory\n  const cacheKey = `${process.cwd()}|${env}|${options?.envFile ?? ''}`;\n\n  const cachedEntry = envFileCache.get(cacheKey);\n\n  if (cachedEntry) {\n    if (cachedEntry.envFilePath === undefined) {\n      // No env file existed. Re-probe cheaply in case one was created since.\n      const envFilePath = getEnvFilePath(env, options?.envFile);\n      if (!envFilePath) return cachedEntry.parsedEnv;\n    } else {\n      try {\n        const stats = statSync(cachedEntry.envFilePath);\n        if (\n          stats.mtimeMs === cachedEntry.mtimeMs &&\n          stats.size === cachedEntry.size\n        ) {\n          return cachedEntry.parsedEnv;\n        }\n      } catch {\n        // File was removed — fall through and re-resolve\n      }\n    }\n  }\n\n  const envFilePath = getEnvFilePath(env, options?.envFile);\n\n  if (!envFilePath) {\n    envFileCache.set(cacheKey, {\n      envFilePath: undefined,\n      mtimeMs: 0,\n      size: 0,\n      parsedEnv: {},\n    });\n    return {};\n  }\n\n  const parsedEnv = parseEnvFile(envFilePath);\n\n  try {\n    const stats = statSync(envFilePath);\n    envFileCache.set(cacheKey, {\n      envFilePath,\n      mtimeMs: stats.mtimeMs,\n      size: stats.size,\n      parsedEnv,\n    });\n  } catch {\n    // Race: file removed between parse and stat — skip caching this round\n  }\n\n  return parsedEnv; // Return the parsed env object\n};\n"],"mappings":";;;;;;;AAGA,MAAM,cAAc,QAAQ,IAAI,YAAY;AAO5C,MAAa,kBACX,MAAc,QAAQ,IAAI,YAAY,eACtC,YACuB;AAKvB,SAJiB,UACb,CAAC,QAAQ,GACT;EAAC,QAAQ,IAAI;EAAS,QAAQ;EAAO;EAAc;EAAO,EAE9C,KAAKA,mBAAW;;;;;;;;AAmBlC,MAAM,+BAAe,IAAI,KAAgC;AAEzD,MAAM,gBAAgB,gBAAgD;CACpE,MAAM,YAAoC,EAAE;AAE5C,gBAAO,OAAO;EACZ,MAAM;EACN,YAAY;EACZ,OAAO;EACR,CAAC;AAEF,QAAO;;AAGT,MAAa,eACX,YAC2B;CAC3B,MAAM,MAAM,SAAS,OAAO;CAG5B,MAAM,WAAW,GAAG,QAAQ,KAAK,CAAC,GAAG,IAAI,GAAG,SAAS,WAAW;CAEhE,MAAM,cAAc,aAAa,IAAI,SAAS;AAE9C,KAAI,YACF,KAAI,YAAY,gBAAgB,QAG9B;MAAI,CADgB,eAAe,KAAK,SAAS,QACjC,CAAE,QAAO,YAAY;OAErC,KAAI;EACF,MAAM,8BAAiB,YAAY,YAAY;AAC/C,MACE,MAAM,YAAY,YAAY,WAC9B,MAAM,SAAS,YAAY,KAE3B,QAAO,YAAY;SAEf;CAMZ,MAAM,cAAc,eAAe,KAAK,SAAS,QAAQ;AAEzD,KAAI,CAAC,aAAa;AAChB,eAAa,IAAI,UAAU;GACzB,aAAa;GACb,SAAS;GACT,MAAM;GACN,WAAW,EAAE;GACd,CAAC;AACF,SAAO,EAAE;;CAGX,MAAM,YAAY,aAAa,YAAY;AAE3C,KAAI;EACF,MAAM,8BAAiB,YAAY;AACnC,eAAa,IAAI,UAAU;GACzB;GACA,SAAS,MAAM;GACf,MAAM,MAAM;GACZ;GACD,CAAC;SACI;AAIR,QAAO"}

package/dist/cjs/loadExternalFile/index.cjs

@@ -8,6 +8,7 @@ const require_loadExternalFile_bundleJSFile = require('./bundleJSFile.cjs');
 exports.bundleFile = require_loadExternalFile_bundleFile.bundleFile;
 exports.bundleFileSync = require_loadExternalFile_bundleFile.bundleFileSync;
 exports.bundleJSFile = require_loadExternalFile_bundleJSFile.bundleJSFile;
+exports.clearTranspileCache = require_loadExternalFile_transpileTSToCJS.clearTranspileCache;
 exports.getLoader = require_loadExternalFile_bundleFile.getLoader;
 exports.getSandBoxContext = require_loadExternalFile_parseFileContent.getSandBoxContext;
 exports.loadExternalFile = require_loadExternalFile_loadExternalFile.loadExternalFile;

package/dist/cjs/loadExternalFile/loadExternalFile.cjs

@@ -25,13 +25,13 @@ const loadExternalFileSync = (filePath, options) => {
 			require_logger.logger("File could not be loaded.", { level: "error" });
 			return;
 		}
-		const fileContent = require_loadExternalFile_parseFileContent.parseFileContent(moduleResultString, {
+		const fileContent = withPreloadedGlobals(options?.preloadGlobals, () => require_loadExternalFile_parseFileContent.parseFileContent(moduleResultString, {
 			projectRequire: options?.projectRequire,
 			envVarOptions: options?.envVarOptions,
 			additionalEnvVars: options?.additionalEnvVars,
 			mocks: options?.mocks,
 			aliases: options?.aliases
-		});
+		}));
 		if (typeof fileContent === "undefined") {
 			require_logger.logger(`File could not be loaded. Path : ${filePath}`);
 			return;
@@ -44,15 +44,17 @@ const loadExternalFileSync = (filePath, options) => {
 const withPreloadedGlobals = (globals, fn) => {
 	if (!globals) return fn();
 	const globalVars = globalThis;
-	const prev = {};
+	const previousValues = {};
+	const previouslyPresent = {};
 	for (const [key, value] of Object.entries(globals)) {
-		prev[key] = globalVars[key];
+		previouslyPresent[key] = key in globalVars;
+		previousValues[key] = globalVars[key];
 		globalVars[key] = value;
 	}
 	try {
 		return fn();
 	} finally {
-		for (const key of Object.keys(globals)) if (prev[key] !== void 0) globalVars[key] = prev[key];
+		for (const key of Object.keys(globals)) if (previouslyPresent[key]) globalVars[key] = previousValues[key];
 		else delete globalVars[key];
 	}
 };

package/dist/cjs/loadExternalFile/loadExternalFile.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"loadExternalFile.cjs","names":["JSON5","transpileTSToCJSSync","parseFileContent","transpileTSToCJS","colorizePath"],"sources":["../../../src/loadExternalFile/loadExternalFile.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport { extname } from 'node:path';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport JSON5 from 'json5';\nimport { colorizePath, logger } from '../logger';\nimport {\n  parseFileContent,\n  type SandBoxContextOptions,\n} from './parseFileContent';\nimport {\n  type TranspileOptions,\n  transpileTSToCJS,\n  transpileTSToCJSSync,\n} from './transpileTSToCJS';\n\n// CJS MJS cross usage\nconst parseJSON5 = JSON5.parse || (JSON5 as any).default?.parse;\n\nexport type LoadExternalFileOptions = {\n  configuration?: IntlayerConfig;\n  buildOptions?: TranspileOptions;\n  logError?: boolean;\n  /**\n   * Key-value pairs to temporarily set on the main Node.js `globalThis` for the\n   * synchronous duration of `parseFileContent` / `runInNewContext`. External modules\n   * loaded via `require()` inside the VM (e.g. `@intlayer/core`'s `file()` helper)\n   * run in the main context and read from the real `globalThis`, not the VM sandbox.\n   * Values are restored (or deleted) after `runInNewContext` returns.\n   */\n  preloadGlobals?: Record<string, unknown>;\n} & SandBoxContextOptions;\n\n/**\n * Load the content declaration from the given path\n *\n * Accepts JSON, JS, MJS and TS files as configuration\n */\nexport const loadExternalFileSync = (\n  filePath: string,\n  options?: LoadExternalFileOptions\n): any | undefined => {\n  const fileExtension = extname(filePath) || '.json';\n\n  try {\n    if (\n      fileExtension === '.json' ||\n      fileExtension === '.json5' ||\n      fileExtension === '.jsonc'\n    ) {\n      // Assume JSON\n      return parseJSON5(readFileSync(filePath, 'utf-8'));\n    }\n\n    // Rest is JS, MJS or TS\n    const code = readFileSync(filePath, 'utf-8');\n\n    const moduleResultString: string | undefined = transpileTSToCJSSync(\n      code,\n      filePath,\n      options?.buildOptions\n    );\n\n    if (!moduleResultString) {\n      logger('File could not be loaded.', { level: 'error' });\n      return undefined;\n    }\n\n    const fileContent = parseFileContent(moduleResultString, {\n      projectRequire: options?.projectRequire,\n      envVarOptions: options?.envVarOptions,\n      additionalEnvVars: options?.additionalEnvVars,\n      mocks: options?.mocks,\n      aliases: options?.aliases,\n    });\n\n    if (typeof fileContent === 'undefined') {\n      logger(`File could not be loaded. Path : ${filePath}`);\n      return undefined;\n    }\n\n    return fileContent;\n  } catch (error) {\n    logger(\n      [\n        `Error: ${(error as Error).message} - `,\n        JSON.stringify((error as Error).stack, null, 2),\n      ],\n      {\n        level: 'error',\n      }\n    );\n  }\n};\n\nconst withPreloadedGlobals = <T>(\n  globals: Record<string, unknown> | undefined,\n  fn: () => T\n): T => {\n  if (!globals) return fn();\n\n  const globalVars = globalThis as Record<string, unknown>;\n  const prev: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(globals)) {\n    prev[key] = globalVars[key];\n    globalVars[key] = value;\n  }\n\n  try {\n    return fn();\n  } finally {\n    for (const key of Object.keys(globals)) {\n      if (prev[key] !== undefined) {\n        globalVars[key] = prev[key];\n      } else {\n        delete globalVars[key];\n      }\n    }\n  }\n};\n\n/**\n * Load the content declaration from the given path\n *\n * Accepts JSON, JS, MJS and TS files as configuration\n */\nexport const loadExternalFile = async (\n  filePath: string,\n  options?: LoadExternalFileOptions\n): Promise<any | undefined> => {\n  const fileExtension = extname(filePath);\n\n  try {\n    if (\n      fileExtension === '.json' ||\n      fileExtension === '.json5' ||\n      fileExtension === '.jsonc'\n    ) {\n      // Remove cache to force getting fresh content\n      const fileContent = await readFile(filePath, 'utf-8');\n      return parseJSON5(fileContent);\n    }\n\n    // Rest is JS, MJS or TS\n    const code = await readFile(filePath, 'utf-8');\n\n    const moduleResultString: string | undefined = await transpileTSToCJS(\n      code,\n      filePath,\n      options?.buildOptions\n    );\n\n    if (!moduleResultString) {\n      logger('File could not be loaded.', { level: 'error' });\n      return undefined;\n    }\n\n    // parseFileContent/runInNewContext is synchronous, so withPreloadedGlobals\n    // has no interleaving risk even when multiple files are processed concurrently.\n    const fileContent = withPreloadedGlobals(options?.preloadGlobals, () =>\n      parseFileContent(moduleResultString, {\n        projectRequire: options?.projectRequire,\n        envVarOptions: options?.envVarOptions,\n        additionalEnvVars: options?.additionalEnvVars,\n        mocks: options?.mocks,\n        aliases: options?.aliases,\n      })\n    );\n\n    if (typeof fileContent === 'undefined') {\n      logger(`File could not be loaded. Path : ${colorizePath(filePath)}`);\n      return undefined;\n    }\n\n    return fileContent;\n  } catch (error) {\n    if (options?.logError ?? true) {\n      logger(\n        [\n          `Error: ${(error as Error).message} - `,\n          JSON.stringify((error as Error).stack, null, 2),\n        ],\n        {\n          level: 'error',\n        }\n      );\n    }\n  }\n};\n"],"mappings":";;;;;;;;;;;;AAiBA,MAAM,aAAaA,cAAM,SAAUA,cAAc,SAAS;;;;;;AAqB1D,MAAa,wBACX,UACA,YACoB;CACpB,MAAM,uCAAwB,SAAS,IAAI;AAE3C,KAAI;AACF,MACE,kBAAkB,WAClB,kBAAkB,YAClB,kBAAkB,SAGlB,QAAO,qCAAwB,UAAU,QAAQ,CAAC;EAMpD,MAAM,qBAAyCC,yFAFrB,UAAU,QAG9B,EACJ,UACA,SAAS,aACV;AAED,MAAI,CAAC,oBAAoB;AACvB,yBAAO,6BAA6B,EAAE,OAAO,SAAS,CAAC;AACvD;;EAGF,MAAM,cAAcC,2DAAiB,oBAAoB;GACvD,gBAAgB,SAAS;GACzB,eAAe,SAAS;GACxB,mBAAmB,SAAS;GAC5B,OAAO,SAAS;GAChB,SAAS,SAAS;GACnB,CAAC;AAEF,MAAI,OAAO,gBAAgB,aAAa;AACtC,yBAAO,oCAAoC,WAAW;AACtD;;AAGF,SAAO;UACA,OAAO;AACd,wBACE,CACE,UAAW,MAAgB,QAAQ,MACnC,KAAK,UAAW,MAAgB,OAAO,MAAM,EAAE,CAChD,EACD,EACE,OAAO,SACR,CACF;;;AAIL,MAAM,wBACJ,SACA,OACM;AACN,KAAI,CAAC,QAAS,QAAO,IAAI;CAEzB,MAAM,aAAa;CACnB,MAAM,OAAgC,EAAE;AAExC,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,EAAE;AAClD,OAAK,OAAO,WAAW;AACvB,aAAW,OAAO;;AAGpB,KAAI;AACF,SAAO,IAAI;WACH;AACR,OAAK,MAAM,OAAO,OAAO,KAAK,QAAQ,CACpC,KAAI,KAAK,SAAS,OAChB,YAAW,OAAO,KAAK;MAEvB,QAAO,WAAW;;;;;;;;AAW1B,MAAa,mBAAmB,OAC9B,UACA,YAC6B;CAC7B,MAAM,uCAAwB,SAAS;AAEvC,KAAI;AACF,MACE,kBAAkB,WAClB,kBAAkB,YAClB,kBAAkB,SAIlB,QAAO,WAAW,qCADiB,UAAU,QAAQ,CACvB;EAMhC,MAAM,qBAAyC,MAAMC,2DACnD,qCAH0B,UAAU,QAAQ,EAI5C,UACA,SAAS,aACV;AAED,MAAI,CAAC,oBAAoB;AACvB,yBAAO,6BAA6B,EAAE,OAAO,SAAS,CAAC;AACvD;;EAKF,MAAM,cAAc,qBAAqB,SAAS,sBAChDD,2DAAiB,oBAAoB;GACnC,gBAAgB,SAAS;GACzB,eAAe,SAAS;GACxB,mBAAmB,SAAS;GAC5B,OAAO,SAAS;GAChB,SAAS,SAAS;GACnB,CAAC,CACH;AAED,MAAI,OAAO,gBAAgB,aAAa;AACtC,yBAAO,oCAAoCE,4BAAa,SAAS,GAAG;AACpE;;AAGF,SAAO;UACA,OAAO;AACd,MAAI,SAAS,YAAY,KACvB,uBACE,CACE,UAAW,MAAgB,QAAQ,MACnC,KAAK,UAAW,MAAgB,OAAO,MAAM,EAAE,CAChD,EACD,EACE,OAAO,SACR,CACF"}
+{"version":3,"file":"loadExternalFile.cjs","names":["JSON5","transpileTSToCJSSync","parseFileContent","transpileTSToCJS","colorizePath"],"sources":["../../../src/loadExternalFile/loadExternalFile.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport { extname } from 'node:path';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport JSON5 from 'json5';\nimport { colorizePath, logger } from '../logger';\nimport {\n  parseFileContent,\n  type SandBoxContextOptions,\n} from './parseFileContent';\nimport {\n  type TranspileOptions,\n  transpileTSToCJS,\n  transpileTSToCJSSync,\n} from './transpileTSToCJS';\n\n// CJS MJS cross usage\nconst parseJSON5 = JSON5.parse || (JSON5 as any).default?.parse;\n\nexport type LoadExternalFileOptions = {\n  configuration?: IntlayerConfig;\n  buildOptions?: TranspileOptions;\n  logError?: boolean;\n  /**\n   * Key-value pairs to temporarily set on the main Node.js `globalThis` for the\n   * synchronous duration of `parseFileContent` / `runInNewContext`. External modules\n   * loaded via `require()` inside the VM (e.g. `@intlayer/core`'s `file()` helper)\n   * run in the main context and read from the real `globalThis`, not the VM sandbox.\n   * Values are restored (or deleted) after `runInNewContext` returns.\n   */\n  preloadGlobals?: Record<string, unknown>;\n} & SandBoxContextOptions;\n\n/**\n * Load the content declaration from the given path\n *\n * Accepts JSON, JS, MJS and TS files as configuration\n */\nexport const loadExternalFileSync = (\n  filePath: string,\n  options?: LoadExternalFileOptions\n): any | undefined => {\n  const fileExtension = extname(filePath) || '.json';\n\n  try {\n    if (\n      fileExtension === '.json' ||\n      fileExtension === '.json5' ||\n      fileExtension === '.jsonc'\n    ) {\n      // Assume JSON\n      return parseJSON5(readFileSync(filePath, 'utf-8'));\n    }\n\n    // Rest is JS, MJS or TS\n    const code = readFileSync(filePath, 'utf-8');\n\n    const moduleResultString: string | undefined = transpileTSToCJSSync(\n      code,\n      filePath,\n      options?.buildOptions\n    );\n\n    if (!moduleResultString) {\n      logger('File could not be loaded.', { level: 'error' });\n      return undefined;\n    }\n\n    // parseFileContent/runInNewContext is synchronous, so withPreloadedGlobals\n    // fully restores the globals before returning.\n    const fileContent = withPreloadedGlobals(options?.preloadGlobals, () =>\n      parseFileContent(moduleResultString, {\n        projectRequire: options?.projectRequire,\n        envVarOptions: options?.envVarOptions,\n        additionalEnvVars: options?.additionalEnvVars,\n        mocks: options?.mocks,\n        aliases: options?.aliases,\n      })\n    );\n\n    if (typeof fileContent === 'undefined') {\n      logger(`File could not be loaded. Path : ${filePath}`);\n      return undefined;\n    }\n\n    return fileContent;\n  } catch (error) {\n    logger(\n      [\n        `Error: ${(error as Error).message} - `,\n        JSON.stringify((error as Error).stack, null, 2),\n      ],\n      {\n        level: 'error',\n      }\n    );\n  }\n};\n\nconst withPreloadedGlobals = <T>(\n  globals: Record<string, unknown> | undefined,\n  fn: () => T\n): T => {\n  if (!globals) return fn();\n\n  const globalVars = globalThis as Record<string, unknown>;\n  const previousValues: Record<string, unknown> = {};\n  const previouslyPresent: Record<string, boolean> = {};\n\n  for (const [key, value] of Object.entries(globals)) {\n    previouslyPresent[key] = key in globalVars;\n    previousValues[key] = globalVars[key];\n    globalVars[key] = value;\n  }\n\n  try {\n    return fn();\n  } finally {\n    for (const key of Object.keys(globals)) {\n      // `in` check (not `!== undefined`) so a global that legitimately held\n      // `undefined` is restored rather than deleted.\n      if (previouslyPresent[key]) {\n        globalVars[key] = previousValues[key];\n      } else {\n        delete globalVars[key];\n      }\n    }\n  }\n};\n\n/**\n * Load the content declaration from the given path\n *\n * Accepts JSON, JS, MJS and TS files as configuration\n */\nexport const loadExternalFile = async (\n  filePath: string,\n  options?: LoadExternalFileOptions\n): Promise<any | undefined> => {\n  const fileExtension = extname(filePath);\n\n  try {\n    if (\n      fileExtension === '.json' ||\n      fileExtension === '.json5' ||\n      fileExtension === '.jsonc'\n    ) {\n      // Remove cache to force getting fresh content\n      const fileContent = await readFile(filePath, 'utf-8');\n      return parseJSON5(fileContent);\n    }\n\n    // Rest is JS, MJS or TS\n    const code = await readFile(filePath, 'utf-8');\n\n    const moduleResultString: string | undefined = await transpileTSToCJS(\n      code,\n      filePath,\n      options?.buildOptions\n    );\n\n    if (!moduleResultString) {\n      logger('File could not be loaded.', { level: 'error' });\n      return undefined;\n    }\n\n    // parseFileContent/runInNewContext is synchronous, so withPreloadedGlobals\n    // has no interleaving risk even when multiple files are processed concurrently.\n    const fileContent = withPreloadedGlobals(options?.preloadGlobals, () =>\n      parseFileContent(moduleResultString, {\n        projectRequire: options?.projectRequire,\n        envVarOptions: options?.envVarOptions,\n        additionalEnvVars: options?.additionalEnvVars,\n        mocks: options?.mocks,\n        aliases: options?.aliases,\n      })\n    );\n\n    if (typeof fileContent === 'undefined') {\n      logger(`File could not be loaded. Path : ${colorizePath(filePath)}`);\n      return undefined;\n    }\n\n    return fileContent;\n  } catch (error) {\n    if (options?.logError ?? true) {\n      logger(\n        [\n          `Error: ${(error as Error).message} - `,\n          JSON.stringify((error as Error).stack, null, 2),\n        ],\n        {\n          level: 'error',\n        }\n      );\n    }\n  }\n};\n"],"mappings":";;;;;;;;;;;;AAiBA,MAAM,aAAaA,cAAM,SAAUA,cAAc,SAAS;;;;;;AAqB1D,MAAa,wBACX,UACA,YACoB;CACpB,MAAM,uCAAwB,SAAS,IAAI;AAE3C,KAAI;AACF,MACE,kBAAkB,WAClB,kBAAkB,YAClB,kBAAkB,SAGlB,QAAO,qCAAwB,UAAU,QAAQ,CAAC;EAMpD,MAAM,qBAAyCC,yFAFrB,UAAU,QAG9B,EACJ,UACA,SAAS,aACV;AAED,MAAI,CAAC,oBAAoB;AACvB,yBAAO,6BAA6B,EAAE,OAAO,SAAS,CAAC;AACvD;;EAKF,MAAM,cAAc,qBAAqB,SAAS,sBAChDC,2DAAiB,oBAAoB;GACnC,gBAAgB,SAAS;GACzB,eAAe,SAAS;GACxB,mBAAmB,SAAS;GAC5B,OAAO,SAAS;GAChB,SAAS,SAAS;GACnB,CAAC,CACH;AAED,MAAI,OAAO,gBAAgB,aAAa;AACtC,yBAAO,oCAAoC,WAAW;AACtD;;AAGF,SAAO;UACA,OAAO;AACd,wBACE,CACE,UAAW,MAAgB,QAAQ,MACnC,KAAK,UAAW,MAAgB,OAAO,MAAM,EAAE,CAChD,EACD,EACE,OAAO,SACR,CACF;;;AAIL,MAAM,wBACJ,SACA,OACM;AACN,KAAI,CAAC,QAAS,QAAO,IAAI;CAEzB,MAAM,aAAa;CACnB,MAAM,iBAA0C,EAAE;CAClD,MAAM,oBAA6C,EAAE;AAErD,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,EAAE;AAClD,oBAAkB,OAAO,OAAO;AAChC,iBAAe,OAAO,WAAW;AACjC,aAAW,OAAO;;AAGpB,KAAI;AACF,SAAO,IAAI;WACH;AACR,OAAK,MAAM,OAAO,OAAO,KAAK,QAAQ,CAGpC,KAAI,kBAAkB,KACpB,YAAW,OAAO,eAAe;MAEjC,QAAO,WAAW;;;;;;;;AAW1B,MAAa,mBAAmB,OAC9B,UACA,YAC6B;CAC7B,MAAM,uCAAwB,SAAS;AAEvC,KAAI;AACF,MACE,kBAAkB,WAClB,kBAAkB,YAClB,kBAAkB,SAIlB,QAAO,WAAW,qCADiB,UAAU,QAAQ,CACvB;EAMhC,MAAM,qBAAyC,MAAMC,2DACnD,qCAH0B,UAAU,QAAQ,EAI5C,UACA,SAAS,aACV;AAED,MAAI,CAAC,oBAAoB;AACvB,yBAAO,6BAA6B,EAAE,OAAO,SAAS,CAAC;AACvD;;EAKF,MAAM,cAAc,qBAAqB,SAAS,sBAChDD,2DAAiB,oBAAoB;GACnC,gBAAgB,SAAS;GACzB,eAAe,SAAS;GACxB,mBAAmB,SAAS;GAC5B,OAAO,SAAS;GAChB,SAAS,SAAS;GACnB,CAAC,CACH;AAED,MAAI,OAAO,gBAAgB,aAAa;AACtC,yBAAO,oCAAoCE,4BAAa,SAAS,GAAG;AACpE;;AAGF,SAAO;UACA,OAAO;AACd,MAAI,SAAS,YAAY,KACvB,uBACE,CACE,UAAW,MAAgB,QAAQ,MACnC,KAAK,UAAW,MAAgB,OAAO,MAAM,EAAE,CAChD,EACD,EACE,OAAO,SACR,CACF"}

package/dist/cjs/loadExternalFile/parseFileContent.cjs

@@ -27,9 +27,58 @@ const NODE_GLOBALS = [
 	"crypto",
 	"structuredClone"
 ];
+/**
+* Cache of the project's React module (or the JSX-capturing fallback) keyed by
+* the require's resolution paths. Node does not cache *failed* resolutions, so
+* without this every sandbox creation in a non-React project (Vue, Svelte,
+* Angular…) pays a full node_modules walk that ends in a throw.
+*/
+const reactModuleCache = /* @__PURE__ */ new Map();
+/**
+* Fallback React implementation used when React is not installed in the
+* project. It captures JSX elements as plain objects so JSX can be used in
+* content declarations (esbuild's tsx loader defaults to React.createElement).
+*/
+const createFallbackReact = () => ({
+	createElement: (type, props, ...children) => ({
+		type,
+		props: {
+			...props,
+			children: children.length <= 1 ? children[0] : children
+		}
+	}),
+	Fragment: Symbol.for("react.fragment")
+});
+const getReactGlobal = (baseRequire) => {
+	const resolutionKey = baseRequire.resolve.paths?.("react")?.join("|") ?? "<default>";
+	const cachedReactModule = reactModuleCache.get(resolutionKey);
+	if (cachedReactModule) return cachedReactModule;
+	let reactGlobal;
+	try {
+		reactGlobal = { React: baseRequire("react") };
+	} catch (_err) {
+		reactGlobal = { React: createFallbackReact() };
+	}
+	reactModuleCache.set(resolutionKey, reactGlobal);
+	return reactGlobal;
+};
+/**
+* Snapshot of the non-env `process` properties, taken once at module load.
+* Spreading `process` enumerates ~100 properties (some behind getters); doing
+* it per sandbox is wasteful since everything except `env` is static.
+*/
+const processSnapshot = { ...process };
+/**
+* Builds the global context handed to `runInNewContext`.
+*
+* SECURITY NOTE: this sandbox exists for global-scope hygiene (fresh
+* module/exports, controlled env), NOT for containment. It exposes the real
+* project `require`, a copy of `process`, and `fetch` — code executed here has
+* full host privileges. Only ever run trusted, build-time project files
+* (same trust model as `vite.config.ts`).
+*/
 const getSandBoxContext = (options) => {
 	const { envVarOptions, projectRequire, additionalEnvVars, mocks, aliases } = options ?? {};
-	let additionalGlobalVar = {};
 	const baseRequire = typeof projectRequire === "function" ? projectRequire : require_utils_ESMxCJSHelpers.getProjectRequire();
 	const mockedRequire = (() => {
 		const mockTable = Object.assign({ esbuild }, mocks);
@@ -46,25 +95,11 @@ const getSandBoxContext = (options) => {
 		wrappedRequire.cache = baseRequire.cache;
 		return wrappedRequire;
 	})();
-	try {
-		additionalGlobalVar = { React: baseRequire("react") };
-	} catch (_err) {
-		additionalGlobalVar = { React: {
-			createElement: (type, props, ...children) => ({
-				type,
-				props: {
-					...props,
-					children: children.length <= 1 ? children[0] : children
-				}
-			}),
-			Fragment: Symbol.for("react.fragment")
-		} };
-	}
 	const sandboxContext = {
 		exports: { default: {} },
 		module: { exports: {} },
 		process: {
-			...process,
+			...processSnapshot,
 			env: {
 				...process.env,
 				...require_loadEnvFile.loadEnvFile(envVarOptions),
@@ -73,7 +108,7 @@ const getSandBoxContext = (options) => {
 		},
 		console,
 		require: mockedRequire,
-		...additionalGlobalVar
+		...getReactGlobal(baseRequire)
 	};
 	for (const key of NODE_GLOBALS) if (!(key in sandboxContext) && key in globalThis) sandboxContext[key] = globalThis[key];
 	return sandboxContext;

package/dist/cjs/loadExternalFile/parseFileContent.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"parseFileContent.cjs","names":["getProjectRequire","loadEnvFile"],"sources":["../../../src/loadExternalFile/parseFileContent.ts"],"sourcesContent":["import { type Context, runInNewContext } from 'node:vm';\nimport * as esbuild from 'esbuild';\nimport { type LoadEnvFileOptions, loadEnvFile } from '../loadEnvFile';\nimport { getProjectRequire } from '../utils/ESMxCJSHelpers';\n\nexport type SandBoxContextOptions = {\n  envVarOptions?: LoadEnvFileOptions;\n  projectRequire?: NodeJS.Require;\n  additionalEnvVars?: Record<string, string>;\n  /**\n   * Map of specifier -> mocked export to be returned when code in the VM calls require(specifier).\n   * Example:\n   *   mocks: {\n   *     '@intlayer/config/built': { getConfig: () => ({}), Locales: {} }\n   *   }\n   */\n  mocks?: Record<string, any>;\n  /**\n   * Optional alias map if you want to redirect specifiers.\n   * Useful when user code imports a subpath you want to collapse.\n   * Example:\n   *   aliases: { '@intlayer/config/built': '@intlayer/config' }\n   */\n  aliases?: Record<string, string>;\n};\n\n// Inject only Node.js-specific globals that are absent from a plain V8 context.\n// JS built-ins (Object, Array, Promise, Math, Date, JSON, Symbol, etc.) are\n// provided automatically by runInNewContext — no need to copy them.\n// Copying all of globalThis would retain hundreds of references (including the\n// full module cache via `global`) inside every sandbox, causing a memory leak.\nconst NODE_GLOBALS = [\n  'Buffer',\n  'setTimeout',\n  'clearTimeout',\n  'setInterval',\n  'clearInterval',\n  'setImmediate',\n  'clearImmediate',\n  'queueMicrotask',\n  'URL',\n  'URLSearchParams',\n  'TextEncoder',\n  'TextDecoder',\n  'AbortController',\n  'AbortSignal',\n  'performance',\n  'fetch',\n  'crypto',\n  'structuredClone',\n] as const;\n\nexport const getSandBoxContext = (options?: SandBoxContextOptions): Context => {\n  const { envVarOptions, projectRequire, additionalEnvVars, mocks, aliases } =\n    options ?? {};\n\n  let additionalGlobalVar = {};\n\n  const baseRequire: NodeJS.Require =\n    typeof projectRequire === 'function' ? projectRequire : getProjectRequire();\n\n  // Wrap require to honor mocks and aliases inside the VM\n  const mockedRequire: NodeJS.Require = (() => {\n    const mockTable = Object.assign(\n      {\n        esbuild,\n      },\n      mocks\n    );\n    const aliasTable = Object.assign({}, aliases);\n\n    const wrappedRequire = function mockableRequire(id: string) {\n      const target = aliasTable?.[id] ? aliasTable[id] : id;\n\n      if (mockTable && Object.hasOwn(mockTable, target)) {\n        return mockTable[target];\n      }\n\n      // If the original id was aliased, allow mocks to be defined on either key.\n      if (target !== id && mockTable && Object.hasOwn(mockTable, id)) {\n        return mockTable[id];\n      }\n\n      return baseRequire(target);\n    } as NodeJS.Require;\n\n    // Mirror NodeJS.Require properties\n    wrappedRequire.resolve = baseRequire.resolve.bind(baseRequire);\n    wrappedRequire.main = baseRequire.main;\n    wrappedRequire.extensions = baseRequire.extensions;\n    wrappedRequire.cache = baseRequire.cache;\n\n    return wrappedRequire;\n  })();\n\n  try {\n    // Dynamically try to require React if it's installed in the project\n    additionalGlobalVar = {\n      React: baseRequire('react'),\n    };\n  } catch (_err) {\n    // React is not installed, so we inject a dummy React object to capture JSX elements\n    // This allows using JSX in content declarations even if React is not installed (e.g. in Solid.js or Vue projects)\n    // because esbuild's tsx loader defaults to React.createElement.\n    additionalGlobalVar = {\n      React: {\n        createElement: (type: any, props: any, ...children: any[]) => ({\n          type,\n          props: {\n            ...props,\n            children: children.length <= 1 ? children[0] : children,\n          },\n        }),\n        Fragment: Symbol.for('react.fragment'),\n      },\n    };\n  }\n\n  const sandboxContext: Context = {\n    exports: {\n      default: {},\n    },\n    module: {\n      exports: {},\n    },\n    process: {\n      ...process,\n      env: {\n        ...process.env,\n        ...loadEnvFile(envVarOptions),\n        ...additionalEnvVars,\n      },\n    },\n    console,\n    require: mockedRequire,\n    ...additionalGlobalVar,\n  };\n\n  for (const key of NODE_GLOBALS) {\n    if (!(key in sandboxContext) && key in globalThis) {\n      (sandboxContext as Record<string, unknown>)[key] =\n        globalThis[key as keyof typeof globalThis];\n    }\n  }\n\n  return sandboxContext;\n};\n\nexport const parseFileContent = <T>(\n  fileContentString: string,\n  options?: SandBoxContextOptions\n): T | undefined => {\n  const sandboxContext = getSandBoxContext(options);\n\n  // Force strict mode so illegal writes throw instead of silently failing.\n  runInNewContext(`\"use strict\";\\n${fileContentString}`, sandboxContext);\n\n  const candidates: unknown[] = [\n    sandboxContext.exports?.default,\n    sandboxContext.module?.exports?.defaults,\n    sandboxContext.module?.exports?.default,\n    sandboxContext.module?.exports,\n  ];\n\n  let result: T | undefined;\n  for (const candidate of candidates) {\n    if (\n      candidate &&\n      typeof candidate === 'object' &&\n      Object.keys(candidate as object).length > 0\n    ) {\n      result = candidate as T;\n      break;\n    }\n  }\n\n  // Drop heavy references so the V8 context created by runInNewContext can be\n  // garbage-collected promptly. The extracted `result` is a plain data object\n  // and does not retain the sandbox.\n  (sandboxContext as Record<string, unknown>).require = undefined;\n  (sandboxContext as Record<string, unknown>).process = undefined;\n  (sandboxContext as Record<string, unknown>).React = undefined;\n  (sandboxContext as Record<string, unknown>).module = undefined;\n  (sandboxContext as Record<string, unknown>).exports = undefined;\n\n  return result;\n};\n"],"mappings":";;;;;;;;;AA+BA,MAAM,eAAe;CACnB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,MAAa,qBAAqB,YAA6C;CAC7E,MAAM,EAAE,eAAe,gBAAgB,mBAAmB,OAAO,YAC/D,WAAW,EAAE;CAEf,IAAI,sBAAsB,EAAE;CAE5B,MAAM,cACJ,OAAO,mBAAmB,aAAa,iBAAiBA,gDAAmB;CAG7E,MAAM,uBAAuC;EAC3C,MAAM,YAAY,OAAO,OACvB,EACE,SACD,EACD,MACD;EACD,MAAM,aAAa,OAAO,OAAO,EAAE,EAAE,QAAQ;EAE7C,MAAM,iBAAiB,SAAS,gBAAgB,IAAY;GAC1D,MAAM,SAAS,aAAa,MAAM,WAAW,MAAM;AAEnD,OAAI,aAAa,OAAO,OAAO,WAAW,OAAO,CAC/C,QAAO,UAAU;AAInB,OAAI,WAAW,MAAM,aAAa,OAAO,OAAO,WAAW,GAAG,CAC5D,QAAO,UAAU;AAGnB,UAAO,YAAY,OAAO;;AAI5B,iBAAe,UAAU,YAAY,QAAQ,KAAK,YAAY;AAC9D,iBAAe,OAAO,YAAY;AAClC,iBAAe,aAAa,YAAY;AACxC,iBAAe,QAAQ,YAAY;AAEnC,SAAO;KACL;AAEJ,KAAI;AAEF,wBAAsB,EACpB,OAAO,YAAY,QAAQ,EAC5B;UACM,MAAM;AAIb,wBAAsB,EACpB,OAAO;GACL,gBAAgB,MAAW,OAAY,GAAG,cAAqB;IAC7D;IACA,OAAO;KACL,GAAG;KACH,UAAU,SAAS,UAAU,IAAI,SAAS,KAAK;KAChD;IACF;GACD,UAAU,OAAO,IAAI,iBAAiB;GACvC,EACF;;CAGH,MAAM,iBAA0B;EAC9B,SAAS,EACP,SAAS,EAAE,EACZ;EACD,QAAQ,EACN,SAAS,EAAE,EACZ;EACD,SAAS;GACP,GAAG;GACH,KAAK;IACH,GAAG,QAAQ;IACX,GAAGC,gCAAY,cAAc;IAC7B,GAAG;IACJ;GACF;EACD;EACA,SAAS;EACT,GAAG;EACJ;AAED,MAAK,MAAM,OAAO,aAChB,KAAI,EAAE,OAAO,mBAAmB,OAAO,WACrC,CAAC,eAA2C,OAC1C,WAAW;AAIjB,QAAO;;AAGT,MAAa,oBACX,mBACA,YACkB;CAClB,MAAM,iBAAiB,kBAAkB,QAAQ;AAGjD,8BAAgB,kBAAkB,qBAAqB,eAAe;CAEtE,MAAM,aAAwB;EAC5B,eAAe,SAAS;EACxB,eAAe,QAAQ,SAAS;EAChC,eAAe,QAAQ,SAAS;EAChC,eAAe,QAAQ;EACxB;CAED,IAAI;AACJ,MAAK,MAAM,aAAa,WACtB,KACE,aACA,OAAO,cAAc,YACrB,OAAO,KAAK,UAAoB,CAAC,SAAS,GAC1C;AACA,WAAS;AACT;;AAOJ,CAAC,eAA2C,UAAU;AACtD,CAAC,eAA2C,UAAU;AACtD,CAAC,eAA2C,QAAQ;AACpD,CAAC,eAA2C,SAAS;AACrD,CAAC,eAA2C,UAAU;AAEtD,QAAO"}
+{"version":3,"file":"parseFileContent.cjs","names":["getProjectRequire","loadEnvFile"],"sources":["../../../src/loadExternalFile/parseFileContent.ts"],"sourcesContent":["import { type Context, runInNewContext } from 'node:vm';\nimport * as esbuild from 'esbuild';\nimport { type LoadEnvFileOptions, loadEnvFile } from '../loadEnvFile';\nimport { getProjectRequire } from '../utils/ESMxCJSHelpers';\n\nexport type SandBoxContextOptions = {\n  envVarOptions?: LoadEnvFileOptions;\n  projectRequire?: NodeJS.Require;\n  additionalEnvVars?: Record<string, string>;\n  /**\n   * Map of specifier -> mocked export to be returned when code in the VM calls require(specifier).\n   * Example:\n   *   mocks: {\n   *     '@intlayer/config/built': { getConfig: () => ({}), Locales: {} }\n   *   }\n   */\n  mocks?: Record<string, any>;\n  /**\n   * Optional alias map if you want to redirect specifiers.\n   * Useful when user code imports a subpath you want to collapse.\n   * Example:\n   *   aliases: { '@intlayer/config/built': '@intlayer/config' }\n   */\n  aliases?: Record<string, string>;\n};\n\n// Inject only Node.js-specific globals that are absent from a plain V8 context.\n// JS built-ins (Object, Array, Promise, Math, Date, JSON, Symbol, etc.) are\n// provided automatically by runInNewContext — no need to copy them.\n// Copying all of globalThis would retain hundreds of references (including the\n// full module cache via `global`) inside every sandbox, causing a memory leak.\nconst NODE_GLOBALS = [\n  'Buffer',\n  'setTimeout',\n  'clearTimeout',\n  'setInterval',\n  'clearInterval',\n  'setImmediate',\n  'clearImmediate',\n  'queueMicrotask',\n  'URL',\n  'URLSearchParams',\n  'TextEncoder',\n  'TextDecoder',\n  'AbortController',\n  'AbortSignal',\n  'performance',\n  'fetch',\n  'crypto',\n  'structuredClone',\n] as const;\n\n/**\n * Cache of the project's React module (or the JSX-capturing fallback) keyed by\n * the require's resolution paths. Node does not cache *failed* resolutions, so\n * without this every sandbox creation in a non-React project (Vue, Svelte,\n * Angular…) pays a full node_modules walk that ends in a throw.\n */\nconst reactModuleCache = new Map<string, { React: unknown }>();\n\n/**\n * Fallback React implementation used when React is not installed in the\n * project. It captures JSX elements as plain objects so JSX can be used in\n * content declarations (esbuild's tsx loader defaults to React.createElement).\n */\nconst createFallbackReact = () => ({\n  createElement: (type: any, props: any, ...children: any[]) => ({\n    type,\n    props: {\n      ...props,\n      children: children.length <= 1 ? children[0] : children,\n    },\n  }),\n  Fragment: Symbol.for('react.fragment'),\n});\n\nconst getReactGlobal = (baseRequire: NodeJS.Require): { React: unknown } => {\n  // resolve.paths() is computed in-memory (no fs access) and identifies the\n  // node_modules chain this require instance resolves against.\n  const resolutionKey =\n    baseRequire.resolve.paths?.('react')?.join('|') ?? '<default>';\n\n  const cachedReactModule = reactModuleCache.get(resolutionKey);\n  if (cachedReactModule) return cachedReactModule;\n\n  let reactGlobal: { React: unknown };\n  try {\n    // Dynamically try to require React if it's installed in the project\n    reactGlobal = { React: baseRequire('react') };\n  } catch (_err) {\n    reactGlobal = { React: createFallbackReact() };\n  }\n\n  reactModuleCache.set(resolutionKey, reactGlobal);\n\n  return reactGlobal;\n};\n\n/**\n * Snapshot of the non-env `process` properties, taken once at module load.\n * Spreading `process` enumerates ~100 properties (some behind getters); doing\n * it per sandbox is wasteful since everything except `env` is static.\n */\nconst processSnapshot = { ...process };\n\n/**\n * Builds the global context handed to `runInNewContext`.\n *\n * SECURITY NOTE: this sandbox exists for global-scope hygiene (fresh\n * module/exports, controlled env), NOT for containment. It exposes the real\n * project `require`, a copy of `process`, and `fetch` — code executed here has\n * full host privileges. Only ever run trusted, build-time project files\n * (same trust model as `vite.config.ts`).\n */\nexport const getSandBoxContext = (options?: SandBoxContextOptions): Context => {\n  const { envVarOptions, projectRequire, additionalEnvVars, mocks, aliases } =\n    options ?? {};\n\n  const baseRequire: NodeJS.Require =\n    typeof projectRequire === 'function' ? projectRequire : getProjectRequire();\n\n  // Wrap require to honor mocks and aliases inside the VM\n  const mockedRequire: NodeJS.Require = (() => {\n    const mockTable = Object.assign(\n      {\n        esbuild,\n      },\n      mocks\n    );\n    const aliasTable = Object.assign({}, aliases);\n\n    const wrappedRequire = function mockableRequire(id: string) {\n      const target = aliasTable?.[id] ? aliasTable[id] : id;\n\n      if (mockTable && Object.hasOwn(mockTable, target)) {\n        return mockTable[target];\n      }\n\n      // If the original id was aliased, allow mocks to be defined on either key.\n      if (target !== id && mockTable && Object.hasOwn(mockTable, id)) {\n        return mockTable[id];\n      }\n\n      return baseRequire(target);\n    } as NodeJS.Require;\n\n    // Mirror NodeJS.Require properties\n    wrappedRequire.resolve = baseRequire.resolve.bind(baseRequire);\n    wrappedRequire.main = baseRequire.main;\n    wrappedRequire.extensions = baseRequire.extensions;\n    wrappedRequire.cache = baseRequire.cache;\n\n    return wrappedRequire;\n  })();\n\n  const sandboxContext: Context = {\n    exports: {\n      default: {},\n    },\n    module: {\n      exports: {},\n    },\n    process: {\n      ...processSnapshot,\n      env: {\n        ...process.env,\n        ...loadEnvFile(envVarOptions),\n        ...additionalEnvVars,\n      },\n    },\n    console,\n    require: mockedRequire,\n    ...getReactGlobal(baseRequire),\n  };\n\n  for (const key of NODE_GLOBALS) {\n    if (!(key in sandboxContext) && key in globalThis) {\n      (sandboxContext as Record<string, unknown>)[key] =\n        globalThis[key as keyof typeof globalThis];\n    }\n  }\n\n  return sandboxContext;\n};\n\nexport const parseFileContent = <T>(\n  fileContentString: string,\n  options?: SandBoxContextOptions\n): T | undefined => {\n  const sandboxContext = getSandBoxContext(options);\n\n  // Force strict mode so illegal writes throw instead of silently failing.\n  runInNewContext(`\"use strict\";\\n${fileContentString}`, sandboxContext);\n\n  const candidates: unknown[] = [\n    sandboxContext.exports?.default,\n    sandboxContext.module?.exports?.defaults,\n    sandboxContext.module?.exports?.default,\n    sandboxContext.module?.exports,\n  ];\n\n  let result: T | undefined;\n  for (const candidate of candidates) {\n    if (\n      candidate &&\n      typeof candidate === 'object' &&\n      Object.keys(candidate as object).length > 0\n    ) {\n      result = candidate as T;\n      break;\n    }\n  }\n\n  // Drop heavy references so the V8 context created by runInNewContext can be\n  // garbage-collected promptly. The extracted `result` is a plain data object\n  // and does not retain the sandbox.\n  (sandboxContext as Record<string, unknown>).require = undefined;\n  (sandboxContext as Record<string, unknown>).process = undefined;\n  (sandboxContext as Record<string, unknown>).React = undefined;\n  (sandboxContext as Record<string, unknown>).module = undefined;\n  (sandboxContext as Record<string, unknown>).exports = undefined;\n\n  return result;\n};\n"],"mappings":";;;;;;;;;AA+BA,MAAM,eAAe;CACnB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;;;;;;AAQD,MAAM,mCAAmB,IAAI,KAAiC;;;;;;AAO9D,MAAM,6BAA6B;CACjC,gBAAgB,MAAW,OAAY,GAAG,cAAqB;EAC7D;EACA,OAAO;GACL,GAAG;GACH,UAAU,SAAS,UAAU,IAAI,SAAS,KAAK;GAChD;EACF;CACD,UAAU,OAAO,IAAI,iBAAiB;CACvC;AAED,MAAM,kBAAkB,gBAAoD;CAG1E,MAAM,gBACJ,YAAY,QAAQ,QAAQ,QAAQ,EAAE,KAAK,IAAI,IAAI;CAErD,MAAM,oBAAoB,iBAAiB,IAAI,cAAc;AAC7D,KAAI,kBAAmB,QAAO;CAE9B,IAAI;AACJ,KAAI;AAEF,gBAAc,EAAE,OAAO,YAAY,QAAQ,EAAE;UACtC,MAAM;AACb,gBAAc,EAAE,OAAO,qBAAqB,EAAE;;AAGhD,kBAAiB,IAAI,eAAe,YAAY;AAEhD,QAAO;;;;;;;AAQT,MAAM,kBAAkB,EAAE,GAAG,SAAS;;;;;;;;;;AAWtC,MAAa,qBAAqB,YAA6C;CAC7E,MAAM,EAAE,eAAe,gBAAgB,mBAAmB,OAAO,YAC/D,WAAW,EAAE;CAEf,MAAM,cACJ,OAAO,mBAAmB,aAAa,iBAAiBA,gDAAmB;CAG7E,MAAM,uBAAuC;EAC3C,MAAM,YAAY,OAAO,OACvB,EACE,SACD,EACD,MACD;EACD,MAAM,aAAa,OAAO,OAAO,EAAE,EAAE,QAAQ;EAE7C,MAAM,iBAAiB,SAAS,gBAAgB,IAAY;GAC1D,MAAM,SAAS,aAAa,MAAM,WAAW,MAAM;AAEnD,OAAI,aAAa,OAAO,OAAO,WAAW,OAAO,CAC/C,QAAO,UAAU;AAInB,OAAI,WAAW,MAAM,aAAa,OAAO,OAAO,WAAW,GAAG,CAC5D,QAAO,UAAU;AAGnB,UAAO,YAAY,OAAO;;AAI5B,iBAAe,UAAU,YAAY,QAAQ,KAAK,YAAY;AAC9D,iBAAe,OAAO,YAAY;AAClC,iBAAe,aAAa,YAAY;AACxC,iBAAe,QAAQ,YAAY;AAEnC,SAAO;KACL;CAEJ,MAAM,iBAA0B;EAC9B,SAAS,EACP,SAAS,EAAE,EACZ;EACD,QAAQ,EACN,SAAS,EAAE,EACZ;EACD,SAAS;GACP,GAAG;GACH,KAAK;IACH,GAAG,QAAQ;IACX,GAAGC,gCAAY,cAAc;IAC7B,GAAG;IACJ;GACF;EACD;EACA,SAAS;EACT,GAAG,eAAe,YAAY;EAC/B;AAED,MAAK,MAAM,OAAO,aAChB,KAAI,EAAE,OAAO,mBAAmB,OAAO,WACrC,CAAC,eAA2C,OAC1C,WAAW;AAIjB,QAAO;;AAGT,MAAa,oBACX,mBACA,YACkB;CAClB,MAAM,iBAAiB,kBAAkB,QAAQ;AAGjD,8BAAgB,kBAAkB,qBAAqB,eAAe;CAEtE,MAAM,aAAwB;EAC5B,eAAe,SAAS;EACxB,eAAe,QAAQ,SAAS;EAChC,eAAe,QAAQ,SAAS;EAChC,eAAe,QAAQ;EACxB;CAED,IAAI;AACJ,MAAK,MAAM,aAAa,WACtB,KACE,aACA,OAAO,cAAc,YACrB,OAAO,KAAK,UAAoB,CAAC,SAAS,GAC1C;AACA,WAAS;AACT;;AAOJ,CAAC,eAA2C,UAAU;AACtD,CAAC,eAA2C,UAAU;AACtD,CAAC,eAA2C,QAAQ;AACpD,CAAC,eAA2C,SAAS;AACrD,CAAC,eAA2C,UAAU;AAEtD,QAAO"}

package/dist/cjs/loadExternalFile/transpileTSToCJS.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_utils_cacheMemory = require('../utils/cacheMemory.cjs');
 const require_utils_getPackageJsonPath = require('../utils/getPackageJsonPath.cjs');
 const require_loadExternalFile_bundleFile = require('./bundleFile.cjs');
 let node_fs = require("node:fs");
@@ -9,9 +10,23 @@ let esbuild = require("esbuild");
 let node_url = require("node:url");
 
 //#region src/loadExternalFile/transpileTSToCJS.ts
+/**
+* Cache of resolved tsconfig paths keyed by the file's directory.
+* Avoids re-walking to package.json + existsSync on every transpilation.
+*/
+const tsConfigPathCache = /* @__PURE__ */ new Map();
 const getTsConfigPath = (filePath) => {
-	const tsconfigPath = (0, node_path.join)(require_utils_getPackageJsonPath.getPackageJsonPath((0, node_path.dirname)(filePath)).baseDir, "tsconfig.json");
-	return (0, node_fs.existsSync)(tsconfigPath) ? tsconfigPath : void 0;
+	const fileDirectory = (0, node_path.dirname)(filePath);
+	if (tsConfigPathCache.has(fileDirectory)) return tsConfigPathCache.get(fileDirectory);
+	let resolvedPath;
+	try {
+		const tsconfigPath = (0, node_path.join)(require_utils_getPackageJsonPath.getPackageJsonPath(fileDirectory).baseDir, "tsconfig.json");
+		resolvedPath = (0, node_fs.existsSync)(tsconfigPath) ? tsconfigPath : void 0;
+	} catch {
+		resolvedPath = void 0;
+	}
+	tsConfigPathCache.set(fileDirectory, resolvedPath);
+	return resolvedPath;
 };
 const getTransformationOptions = (filePath) => ({
 	loader: {
@@ -31,15 +46,85 @@ const getTransformationOptions = (filePath) => ({
 	write: false,
 	packages: "external",
 	bundle: true,
+	metafile: true,
 	tsconfig: getTsConfigPath(filePath),
 	define: {
 		"import.meta.url": JSON.stringify((0, node_url.pathToFileURL)(filePath).href),
 		"import.meta.env": "process.env"
 	}
 });
+/**
+* In-memory cache of transpiled outputs keyed by entry file path (one entry
+* per file, so re-transpilations replace rather than accumulate).
+* The entry file is validated by content hash; bundled relative imports are
+* validated by mtime + size so an edited dependency invalidates the cache.
+*/
+const transpileCache = /* @__PURE__ */ new Map();
+const isInputUnchanged = (input) => {
+	try {
+		const stats = (0, node_fs.statSync)(input.path);
+		return stats.mtimeMs === input.mtimeMs && stats.size === input.size;
+	} catch {
+		return false;
+	}
+};
+const getCachedTranspilation = (filePath, codeHash, optionsKey) => {
+	const cacheEntry = transpileCache.get(filePath);
+	if (!cacheEntry) return void 0;
+	if (cacheEntry.codeHash !== codeHash) return void 0;
+	if (cacheEntry.optionsKey !== optionsKey) return void 0;
+	if (!cacheEntry.inputs.every(isInputUnchanged)) return void 0;
+	return cacheEntry.output;
+};
+/**
+* Extracts the fingerprints of every bundled input from the esbuild metafile.
+* Returns `undefined` when an input cannot be fingerprinted (the result should
+* then not be cached, as invalidation would be unreliable).
+*/
+const getInputFingerprints = (metafile, entryFilePath) => {
+	if (!metafile) return void 0;
+	const resolvedEntryFilePath = (0, node_path.resolve)(entryFilePath);
+	const inputs = [];
+	for (const inputPath of Object.keys(metafile.inputs)) {
+		if (inputPath === "<stdin>") continue;
+		if (inputPath.includes(":") && !(0, node_path.isAbsolute)(inputPath)) return void 0;
+		const absoluteInputPath = (0, node_path.isAbsolute)(inputPath) ? inputPath : (0, node_path.resolve)(process.cwd(), inputPath);
+		if (absoluteInputPath === resolvedEntryFilePath) continue;
+		try {
+			const stats = (0, node_fs.statSync)(absoluteInputPath);
+			inputs.push({
+				path: absoluteInputPath,
+				mtimeMs: stats.mtimeMs,
+				size: stats.size
+			});
+		} catch {
+			return;
+		}
+	}
+	return inputs;
+};
+const setCachedTranspilation = (filePath, codeHash, optionsKey, moduleResult, output) => {
+	const inputs = getInputFingerprints(moduleResult.metafile, filePath);
+	if (!inputs) return;
+	transpileCache.set(filePath, {
+		codeHash,
+		optionsKey,
+		output,
+		inputs
+	});
+};
+/** Clears the in-memory transpilation cache (mainly for tests). */
+const clearTranspileCache = () => {
+	transpileCache.clear();
+	tsConfigPathCache.clear();
+};
 const transpileTSToCJSSync = (code, filePath, options) => {
 	const loader = require_loadExternalFile_bundleFile.getLoader((0, node_path.extname)(filePath));
 	const { esbuildInstance, ...buildOptions } = options ?? {};
+	const codeHash = require_utils_cacheMemory.computeKeyId([code]);
+	const optionsKey = require_utils_cacheMemory.computeKeyId([buildOptions]);
+	const cachedOutput = getCachedTranspilation(filePath, codeHash, optionsKey);
+	if (typeof cachedOutput === "string") return cachedOutput;
 	const esbuildBuildSync = esbuildInstance?.buildSync ?? esbuild.buildSync;
 	const g = globalThis;
 	const hadFilename = typeof g.__filename === "string";
@@ -70,12 +155,18 @@ const transpileTSToCJSSync = (code, filePath, options) => {
 			else g.__dirname = prevDirname;
 		}
 	}
-	return moduleResult.outputFiles?.[0]?.text;
+	const moduleResultString = moduleResult.outputFiles?.[0]?.text;
+	if (typeof moduleResultString === "string") setCachedTranspilation(filePath, codeHash, optionsKey, moduleResult, moduleResultString);
+	return moduleResultString;
 };
 const transpileTSToCJS = async (code, filePath, options) => {
 	const loader = require_loadExternalFile_bundleFile.getLoader((0, node_path.extname)(filePath));
 	const { esbuildInstance, ...buildOptions } = options ?? {};
-	const ctx = await (esbuildInstance?.context ?? esbuild.context)({
+	const codeHash = require_utils_cacheMemory.computeKeyId([code]);
+	const optionsKey = require_utils_cacheMemory.computeKeyId([buildOptions]);
+	const cachedOutput = getCachedTranspilation(filePath, codeHash, optionsKey);
+	if (typeof cachedOutput === "string") return cachedOutput;
+	const moduleResult = await (esbuildInstance?.build ?? esbuild.build)({
 		stdin: {
 			contents: code,
 			loader,
@@ -85,14 +176,13 @@ const transpileTSToCJS = async (code, filePath, options) => {
 		...getTransformationOptions(filePath),
 		...buildOptions
 	});
-	try {
-		return (await ctx.rebuild()).outputFiles?.[0].text;
-	} finally {
-		await ctx.dispose();
-	}
+	const moduleResultString = moduleResult.outputFiles?.[0]?.text;
+	if (typeof moduleResultString === "string") setCachedTranspilation(filePath, codeHash, optionsKey, moduleResult, moduleResultString);
+	return moduleResultString;
 };
 
 //#endregion
+exports.clearTranspileCache = clearTranspileCache;
 exports.transpileTSToCJS = transpileTSToCJS;
 exports.transpileTSToCJSSync = transpileTSToCJSSync;
 //# sourceMappingURL=transpileTSToCJS.cjs.map

package/dist/cjs/loadExternalFile/transpileTSToCJS.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"transpileTSToCJS.cjs","names":["getPackageJsonPath","getLoader","buildSync","context"],"sources":["../../../src/loadExternalFile/transpileTSToCJS.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { createRequire } from 'node:module';\nimport { dirname, extname, join } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport {\n  type BuildOptions,\n  type BuildResult,\n  buildSync,\n  context,\n} from 'esbuild';\nimport { getPackageJsonPath } from '../utils/getPackageJsonPath';\nimport { getLoader } from './bundleFile';\n\nexport type TranspileOptions = BuildOptions & {\n  /**\n   * Optional custom esbuild instance to use for transpilation.\n   * Useful in environments (e.g. VS Code extensions) where the bundled\n   * esbuild binary may not match the host platform.\n   * When provided, its `buildSync`/`build` methods are used instead of\n   * the ones imported from the `esbuild` package.\n   */\n  esbuildInstance?: typeof import('esbuild');\n};\n\nconst getTsConfigPath = (filePath: string): string | undefined => {\n  const tsconfigPath = join(\n    getPackageJsonPath(dirname(filePath)).baseDir,\n    'tsconfig.json'\n  );\n\n  // Only return the tsconfig path if it exists\n  return existsSync(tsconfigPath) ? tsconfigPath : undefined;\n};\n\nconst getTransformationOptions = (filePath: string): BuildOptions => ({\n  loader: {\n    '.js': 'js',\n    '.jsx': 'jsx',\n    '.mjs': 'js',\n    '.ts': 'ts',\n    '.tsx': 'tsx',\n    '.cjs': 'js',\n    '.json': 'json',\n    '.md': 'text',\n    '.mdx': 'text',\n  },\n  format: 'cjs',\n  target: 'node20',\n  platform: 'node',\n  write: false,\n  packages: 'external',\n  bundle: true,\n  tsconfig: getTsConfigPath(filePath),\n  define: {\n    'import.meta.url': JSON.stringify(pathToFileURL(filePath).href),\n    'import.meta.env': 'process.env',\n  },\n});\n\nexport const transpileTSToCJSSync = (\n  code: string,\n  filePath: string,\n  options?: TranspileOptions\n): string | undefined => {\n  const extension = extname(filePath);\n  const loader = getLoader(extension);\n\n  const { esbuildInstance, ...buildOptions } = options ?? {};\n  const esbuildBuildSync = esbuildInstance?.buildSync ?? buildSync;\n\n  // esbuild's worker thread service calls `new Worker(__filename, …)` on first use.\n  // In Vite's SSR module runner the SSR-optimised chunk is ESM and __filename is\n  // never declared (confirmed: accessing it throws ReferenceError, not undefined).\n  // Because there is no local declaration the bare `__filename` lookup falls\n  // through to globalThis, so we set it there to esbuild's own CJS entry-point –\n  // the exact path esbuild would use if it were loaded in a normal CJS context.\n  //\n  // IMPORTANT: We save/restore the globals so this temporary shim does not leak\n  // to other Vite plugins (e.g. `@vitejs/plugin-react-swc`) that check\n  // `typeof __dirname !== \"undefined\"` to locate their own assets.\n  const g = globalThis as Record<string, unknown>;\n  const hadFilename = typeof g.__filename === 'string';\n  const prevFilename = g.__filename;\n  const prevDirname = g.__dirname;\n\n  if (!hadFilename) {\n    try {\n      const _require = createRequire(import.meta.url);\n      const esbuildEntry = _require.resolve('esbuild');\n      g.__filename = esbuildEntry;\n      g.__dirname = dirname(esbuildEntry);\n    } catch {\n      // Best-effort: if esbuild can't be resolved the caller's catch handles it\n    }\n  }\n\n  let moduleResult: BuildResult;\n  try {\n    moduleResult = esbuildBuildSync({\n      stdin: {\n        contents: code,\n        loader,\n        resolveDir: dirname(filePath), // Add resolveDir to resolve imports relative to the file's location\n        sourcefile: filePath, // Add sourcefile for better error messages\n      },\n      ...getTransformationOptions(filePath),\n      ...buildOptions,\n    });\n  } finally {\n    // Always restore the previous values so the globals don't linger.\n    if (!hadFilename) {\n      if (prevFilename === undefined) {\n        delete g.__filename;\n      } else {\n        g.__filename = prevFilename;\n      }\n      if (prevDirname === undefined) {\n        delete g.__dirname;\n      } else {\n        g.__dirname = prevDirname;\n      }\n    }\n  }\n\n  const moduleResultString = moduleResult!.outputFiles?.[0]?.text;\n\n  return moduleResultString;\n};\n\nexport const transpileTSToCJS = async (\n  code: string,\n  filePath: string,\n  options?: TranspileOptions\n): Promise<string | undefined> => {\n  const extension = extname(filePath);\n  const loader = getLoader(extension);\n\n  const { esbuildInstance, ...buildOptions } = options ?? {};\n  // Use context() + rebuild() + dispose() so esbuild deterministically releases\n  // Go-subprocess resources for each one-shot transpilation, preventing them\n  // from accumulating between rapid HMR-driven file changes.\n  const esbuildContext = esbuildInstance?.context ?? context;\n\n  const ctx = await esbuildContext({\n    stdin: {\n      contents: code,\n      loader,\n      resolveDir: dirname(filePath),\n      sourcefile: filePath,\n    },\n    ...getTransformationOptions(filePath),\n    ...buildOptions,\n  });\n\n  try {\n    const moduleResult = await ctx.rebuild();\n    return moduleResult.outputFiles?.[0].text;\n  } finally {\n    await ctx.dispose();\n  }\n};\n"],"mappings":";;;;;;;;;;;AAwBA,MAAM,mBAAmB,aAAyC;CAChE,MAAM,mCACJA,2EAA2B,SAAS,CAAC,CAAC,SACtC,gBACD;AAGD,gCAAkB,aAAa,GAAG,eAAe;;AAGnD,MAAM,4BAA4B,cAAoC;CACpE,QAAQ;EACN,OAAO;EACP,QAAQ;EACR,QAAQ;EACR,OAAO;EACP,QAAQ;EACR,QAAQ;EACR,SAAS;EACT,OAAO;EACP,QAAQ;EACT;CACD,QAAQ;CACR,QAAQ;CACR,UAAU;CACV,OAAO;CACP,UAAU;CACV,QAAQ;CACR,UAAU,gBAAgB,SAAS;CACnC,QAAQ;EACN,mBAAmB,KAAK,sCAAwB,SAAS,CAAC,KAAK;EAC/D,mBAAmB;EACpB;CACF;AAED,MAAa,wBACX,MACA,UACA,YACuB;CAEvB,MAAM,SAASC,qEADW,SACQ,CAAC;CAEnC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,WAAW,EAAE;CAC1D,MAAM,mBAAmB,iBAAiB,aAAaC;CAYvD,MAAM,IAAI;CACV,MAAM,cAAc,OAAO,EAAE,eAAe;CAC5C,MAAM,eAAe,EAAE;CACvB,MAAM,cAAc,EAAE;AAEtB,KAAI,CAAC,YACH,KAAI;EAEF,MAAM,4FAAuB,CAAC,QAAQ,UAAU;AAChD,IAAE,aAAa;AACf,IAAE,mCAAoB,aAAa;SAC7B;CAKV,IAAI;AACJ,KAAI;AACF,iBAAe,iBAAiB;GAC9B,OAAO;IACL,UAAU;IACV;IACA,mCAAoB,SAAS;IAC7B,YAAY;IACb;GACD,GAAG,yBAAyB,SAAS;GACrC,GAAG;GACJ,CAAC;WACM;AAER,MAAI,CAAC,aAAa;AAChB,OAAI,iBAAiB,OACnB,QAAO,EAAE;OAET,GAAE,aAAa;AAEjB,OAAI,gBAAgB,OAClB,QAAO,EAAE;OAET,GAAE,YAAY;;;AAOpB,QAF2B,aAAc,cAAc,IAAI;;AAK7D,MAAa,mBAAmB,OAC9B,MACA,UACA,YACgC;CAEhC,MAAM,SAASD,qEADW,SACQ,CAAC;CAEnC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,WAAW,EAAE;CAM1D,MAAM,MAAM,OAFW,iBAAiB,WAAWE,iBAElB;EAC/B,OAAO;GACL,UAAU;GACV;GACA,mCAAoB,SAAS;GAC7B,YAAY;GACb;EACD,GAAG,yBAAyB,SAAS;EACrC,GAAG;EACJ,CAAC;AAEF,KAAI;AAEF,UAAO,MADoB,IAAI,SAAS,EACpB,cAAc,GAAG;WAC7B;AACR,QAAM,IAAI,SAAS"}
+{"version":3,"file":"transpileTSToCJS.cjs","names":["getPackageJsonPath","getLoader","computeKeyId","buildSync","build"],"sources":["../../../src/loadExternalFile/transpileTSToCJS.ts"],"sourcesContent":["import { existsSync, statSync } from 'node:fs';\nimport { createRequire } from 'node:module';\nimport { dirname, extname, isAbsolute, join, resolve } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport {\n  type BuildOptions,\n  type BuildResult,\n  build,\n  buildSync,\n  type Metafile,\n} from 'esbuild';\nimport { computeKeyId } from '../utils/cacheMemory';\nimport { getPackageJsonPath } from '../utils/getPackageJsonPath';\nimport { getLoader } from './bundleFile';\n\nexport type TranspileOptions = BuildOptions & {\n  /**\n   * Optional custom esbuild instance to use for transpilation.\n   * Useful in environments (e.g. VS Code extensions) where the bundled\n   * esbuild binary may not match the host platform.\n   * When provided, its `buildSync`/`build` methods are used instead of\n   * the ones imported from the `esbuild` package.\n   */\n  esbuildInstance?: typeof import('esbuild');\n};\n\n/**\n * Cache of resolved tsconfig paths keyed by the file's directory.\n * Avoids re-walking to package.json + existsSync on every transpilation.\n */\nconst tsConfigPathCache = new Map<string, string | undefined>();\n\nconst getTsConfigPath = (filePath: string): string | undefined => {\n  const fileDirectory = dirname(filePath);\n\n  if (tsConfigPathCache.has(fileDirectory)) {\n    return tsConfigPathCache.get(fileDirectory);\n  }\n\n  let resolvedPath: string | undefined;\n  try {\n    const tsconfigPath = join(\n      getPackageJsonPath(fileDirectory).baseDir,\n      'tsconfig.json'\n    );\n\n    // Only return the tsconfig path if it exists\n    resolvedPath = existsSync(tsconfigPath) ? tsconfigPath : undefined;\n  } catch {\n    // No package.json found up the tree — transpile without a tsconfig\n    resolvedPath = undefined;\n  }\n\n  tsConfigPathCache.set(fileDirectory, resolvedPath);\n\n  return resolvedPath;\n};\n\nconst getTransformationOptions = (filePath: string): BuildOptions => ({\n  loader: {\n    '.js': 'js',\n    '.jsx': 'jsx',\n    '.mjs': 'js',\n    '.ts': 'ts',\n    '.tsx': 'tsx',\n    '.cjs': 'js',\n    '.json': 'json',\n    '.md': 'text',\n    '.mdx': 'text',\n  },\n  format: 'cjs',\n  target: 'node20',\n  platform: 'node',\n  write: false,\n  packages: 'external',\n  bundle: true,\n  // The metafile lists every bundled input, which the transpile cache uses to\n  // invalidate when an imported file changes (the entry itself is keyed by hash).\n  metafile: true,\n  tsconfig: getTsConfigPath(filePath),\n  define: {\n    'import.meta.url': JSON.stringify(pathToFileURL(filePath).href),\n    'import.meta.env': 'process.env',\n  },\n});\n\n/** Fingerprint of a bundled input file, used to detect changes without re-reading it. */\ntype TranspileCacheInput = {\n  path: string;\n  mtimeMs: number;\n  size: number;\n};\n\ntype TranspileCacheEntry = {\n  /** Hash of the entry file's source code. */\n  codeHash: string;\n  /** Hash of the build options, so different option sets don't collide. */\n  optionsKey: string;\n  /** The transpiled CJS output. */\n  output: string;\n  /** Fingerprints of every non-entry input bundled into the output. */\n  inputs: TranspileCacheInput[];\n};\n\n/**\n * In-memory cache of transpiled outputs keyed by entry file path (one entry\n * per file, so re-transpilations replace rather than accumulate).\n * The entry file is validated by content hash; bundled relative imports are\n * validated by mtime + size so an edited dependency invalidates the cache.\n */\nconst transpileCache = new Map<string, TranspileCacheEntry>();\n\nconst isInputUnchanged = (input: TranspileCacheInput): boolean => {\n  try {\n    const stats = statSync(input.path);\n    return stats.mtimeMs === input.mtimeMs && stats.size === input.size;\n  } catch {\n    // File removed or unreadable — treat as changed\n    return false;\n  }\n};\n\nconst getCachedTranspilation = (\n  filePath: string,\n  codeHash: string,\n  optionsKey: string\n): string | undefined => {\n  const cacheEntry = transpileCache.get(filePath);\n\n  if (!cacheEntry) return undefined;\n  if (cacheEntry.codeHash !== codeHash) return undefined;\n  if (cacheEntry.optionsKey !== optionsKey) return undefined;\n  if (!cacheEntry.inputs.every(isInputUnchanged)) return undefined;\n\n  return cacheEntry.output;\n};\n\n/**\n * Extracts the fingerprints of every bundled input from the esbuild metafile.\n * Returns `undefined` when an input cannot be fingerprinted (the result should\n * then not be cached, as invalidation would be unreliable).\n */\nconst getInputFingerprints = (\n  metafile: Metafile | undefined,\n  entryFilePath: string\n): TranspileCacheInput[] | undefined => {\n  if (!metafile) return undefined;\n\n  const resolvedEntryFilePath = resolve(entryFilePath);\n  const inputs: TranspileCacheInput[] = [];\n\n  for (const inputPath of Object.keys(metafile.inputs)) {\n    // The entry itself is provided via stdin and validated by content hash.\n    // esbuild labels it \"<stdin>\", or with the sourcefile path when set.\n    if (inputPath === '<stdin>') continue;\n    // Virtual modules from plugins (e.g. \"plugin:...\") cannot be fingerprinted\n    if (inputPath.includes(':') && !isAbsolute(inputPath)) return undefined;\n\n    const absoluteInputPath = isAbsolute(inputPath)\n      ? inputPath\n      : resolve(process.cwd(), inputPath);\n\n    if (absoluteInputPath === resolvedEntryFilePath) continue;\n\n    try {\n      const stats = statSync(absoluteInputPath);\n      inputs.push({\n        path: absoluteInputPath,\n        mtimeMs: stats.mtimeMs,\n        size: stats.size,\n      });\n    } catch {\n      return undefined;\n    }\n  }\n\n  return inputs;\n};\n\nconst setCachedTranspilation = (\n  filePath: string,\n  codeHash: string,\n  optionsKey: string,\n  moduleResult: BuildResult,\n  output: string\n): void => {\n  const inputs = getInputFingerprints(moduleResult.metafile, filePath);\n\n  // Without a usable metafile the cache cannot be invalidated reliably — skip\n  if (!inputs) return;\n\n  transpileCache.set(filePath, { codeHash, optionsKey, output, inputs });\n};\n\n/** Clears the in-memory transpilation cache (mainly for tests). */\nexport const clearTranspileCache = (): void => {\n  transpileCache.clear();\n  tsConfigPathCache.clear();\n};\n\nexport const transpileTSToCJSSync = (\n  code: string,\n  filePath: string,\n  options?: TranspileOptions\n): string | undefined => {\n  const extension = extname(filePath);\n  const loader = getLoader(extension);\n\n  const { esbuildInstance, ...buildOptions } = options ?? {};\n\n  const codeHash = computeKeyId([code]);\n  const optionsKey = computeKeyId([buildOptions]);\n\n  const cachedOutput = getCachedTranspilation(filePath, codeHash, optionsKey);\n  if (typeof cachedOutput === 'string') return cachedOutput;\n\n  const esbuildBuildSync = esbuildInstance?.buildSync ?? buildSync;\n\n  // esbuild's worker thread service calls `new Worker(__filename, …)` on first use.\n  // In Vite's SSR module runner the SSR-optimised chunk is ESM and __filename is\n  // never declared (confirmed: accessing it throws ReferenceError, not undefined).\n  // Because there is no local declaration the bare `__filename` lookup falls\n  // through to globalThis, so we set it there to esbuild's own CJS entry-point –\n  // the exact path esbuild would use if it were loaded in a normal CJS context.\n  //\n  // IMPORTANT: We save/restore the globals so this temporary shim does not leak\n  // to other Vite plugins (e.g. `@vitejs/plugin-react-swc`) that check\n  // `typeof __dirname !== \"undefined\"` to locate their own assets.\n  const g = globalThis as Record<string, unknown>;\n  const hadFilename = typeof g.__filename === 'string';\n  const prevFilename = g.__filename;\n  const prevDirname = g.__dirname;\n\n  if (!hadFilename) {\n    try {\n      const _require = createRequire(import.meta.url);\n      const esbuildEntry = _require.resolve('esbuild');\n      g.__filename = esbuildEntry;\n      g.__dirname = dirname(esbuildEntry);\n    } catch {\n      // Best-effort: if esbuild can't be resolved the caller's catch handles it\n    }\n  }\n\n  let moduleResult: BuildResult;\n  try {\n    moduleResult = esbuildBuildSync({\n      stdin: {\n        contents: code,\n        loader,\n        resolveDir: dirname(filePath), // Add resolveDir to resolve imports relative to the file's location\n        sourcefile: filePath, // Add sourcefile for better error messages\n      },\n      ...getTransformationOptions(filePath),\n      ...buildOptions,\n    });\n  } finally {\n    // Always restore the previous values so the globals don't linger.\n    if (!hadFilename) {\n      if (prevFilename === undefined) {\n        // biome-ignore lint/performance/noDelete: the global must be truly absent — assigning undefined would leave the key present and break `typeof __filename` checks in other tools\n        delete g.__filename;\n      } else {\n        g.__filename = prevFilename;\n      }\n      if (prevDirname === undefined) {\n        // biome-ignore lint/performance/noDelete: same as __filename above\n        delete g.__dirname;\n      } else {\n        g.__dirname = prevDirname;\n      }\n    }\n  }\n\n  const moduleResultString = moduleResult!.outputFiles?.[0]?.text;\n\n  if (typeof moduleResultString === 'string') {\n    setCachedTranspilation(\n      filePath,\n      codeHash,\n      optionsKey,\n      moduleResult!,\n      moduleResultString\n    );\n  }\n\n  return moduleResultString;\n};\n\nexport const transpileTSToCJS = async (\n  code: string,\n  filePath: string,\n  options?: TranspileOptions\n): Promise<string | undefined> => {\n  const extension = extname(filePath);\n  const loader = getLoader(extension);\n\n  const { esbuildInstance, ...buildOptions } = options ?? {};\n\n  const codeHash = computeKeyId([code]);\n  const optionsKey = computeKeyId([buildOptions]);\n\n  const cachedOutput = getCachedTranspilation(filePath, codeHash, optionsKey);\n  if (typeof cachedOutput === 'string') return cachedOutput;\n\n  // A one-shot build() releases its Go-side resources on completion and costs a\n  // single service round-trip (context()+rebuild()+dispose() costs three).\n  const esbuildBuild = esbuildInstance?.build ?? build;\n\n  const moduleResult = await esbuildBuild({\n    stdin: {\n      contents: code,\n      loader,\n      resolveDir: dirname(filePath),\n      sourcefile: filePath,\n    },\n    ...getTransformationOptions(filePath),\n    ...buildOptions,\n  });\n\n  const moduleResultString = moduleResult.outputFiles?.[0]?.text;\n\n  if (typeof moduleResultString === 'string') {\n    setCachedTranspilation(\n      filePath,\n      codeHash,\n      optionsKey,\n      moduleResult,\n      moduleResultString\n    );\n  }\n\n  return moduleResultString;\n};\n"],"mappings":";;;;;;;;;;;;;;;;AA8BA,MAAM,oCAAoB,IAAI,KAAiC;AAE/D,MAAM,mBAAmB,aAAyC;CAChE,MAAM,uCAAwB,SAAS;AAEvC,KAAI,kBAAkB,IAAI,cAAc,CACtC,QAAO,kBAAkB,IAAI,cAAc;CAG7C,IAAI;AACJ,KAAI;EACF,MAAM,mCACJA,oDAAmB,cAAc,CAAC,SAClC,gBACD;AAGD,yCAA0B,aAAa,GAAG,eAAe;SACnD;AAEN,iBAAe;;AAGjB,mBAAkB,IAAI,eAAe,aAAa;AAElD,QAAO;;AAGT,MAAM,4BAA4B,cAAoC;CACpE,QAAQ;EACN,OAAO;EACP,QAAQ;EACR,QAAQ;EACR,OAAO;EACP,QAAQ;EACR,QAAQ;EACR,SAAS;EACT,OAAO;EACP,QAAQ;EACT;CACD,QAAQ;CACR,QAAQ;CACR,UAAU;CACV,OAAO;CACP,UAAU;CACV,QAAQ;CAGR,UAAU;CACV,UAAU,gBAAgB,SAAS;CACnC,QAAQ;EACN,mBAAmB,KAAK,sCAAwB,SAAS,CAAC,KAAK;EAC/D,mBAAmB;EACpB;CACF;;;;;;;AA0BD,MAAM,iCAAiB,IAAI,KAAkC;AAE7D,MAAM,oBAAoB,UAAwC;AAChE,KAAI;EACF,MAAM,8BAAiB,MAAM,KAAK;AAClC,SAAO,MAAM,YAAY,MAAM,WAAW,MAAM,SAAS,MAAM;SACzD;AAEN,SAAO;;;AAIX,MAAM,0BACJ,UACA,UACA,eACuB;CACvB,MAAM,aAAa,eAAe,IAAI,SAAS;AAE/C,KAAI,CAAC,WAAY,QAAO;AACxB,KAAI,WAAW,aAAa,SAAU,QAAO;AAC7C,KAAI,WAAW,eAAe,WAAY,QAAO;AACjD,KAAI,CAAC,WAAW,OAAO,MAAM,iBAAiB,CAAE,QAAO;AAEvD,QAAO,WAAW;;;;;;;AAQpB,MAAM,wBACJ,UACA,kBACsC;AACtC,KAAI,CAAC,SAAU,QAAO;CAEtB,MAAM,+CAAgC,cAAc;CACpD,MAAM,SAAgC,EAAE;AAExC,MAAK,MAAM,aAAa,OAAO,KAAK,SAAS,OAAO,EAAE;AAGpD,MAAI,cAAc,UAAW;AAE7B,MAAI,UAAU,SAAS,IAAI,IAAI,2BAAY,UAAU,CAAE,QAAO;EAE9D,MAAM,8CAA+B,UAAU,GAC3C,mCACQ,QAAQ,KAAK,EAAE,UAAU;AAErC,MAAI,sBAAsB,sBAAuB;AAEjD,MAAI;GACF,MAAM,8BAAiB,kBAAkB;AACzC,UAAO,KAAK;IACV,MAAM;IACN,SAAS,MAAM;IACf,MAAM,MAAM;IACb,CAAC;UACI;AACN;;;AAIJ,QAAO;;AAGT,MAAM,0BACJ,UACA,UACA,YACA,cACA,WACS;CACT,MAAM,SAAS,qBAAqB,aAAa,UAAU,SAAS;AAGpE,KAAI,CAAC,OAAQ;AAEb,gBAAe,IAAI,UAAU;EAAE;EAAU;EAAY;EAAQ;EAAQ,CAAC;;;AAIxE,MAAa,4BAAkC;AAC7C,gBAAe,OAAO;AACtB,mBAAkB,OAAO;;AAG3B,MAAa,wBACX,MACA,UACA,YACuB;CAEvB,MAAM,SAASC,qEADW,SACQ,CAAC;CAEnC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,WAAW,EAAE;CAE1D,MAAM,WAAWC,uCAAa,CAAC,KAAK,CAAC;CACrC,MAAM,aAAaA,uCAAa,CAAC,aAAa,CAAC;CAE/C,MAAM,eAAe,uBAAuB,UAAU,UAAU,WAAW;AAC3E,KAAI,OAAO,iBAAiB,SAAU,QAAO;CAE7C,MAAM,mBAAmB,iBAAiB,aAAaC;CAYvD,MAAM,IAAI;CACV,MAAM,cAAc,OAAO,EAAE,eAAe;CAC5C,MAAM,eAAe,EAAE;CACvB,MAAM,cAAc,EAAE;AAEtB,KAAI,CAAC,YACH,KAAI;EAEF,MAAM,4FAAuB,CAAC,QAAQ,UAAU;AAChD,IAAE,aAAa;AACf,IAAE,mCAAoB,aAAa;SAC7B;CAKV,IAAI;AACJ,KAAI;AACF,iBAAe,iBAAiB;GAC9B,OAAO;IACL,UAAU;IACV;IACA,mCAAoB,SAAS;IAC7B,YAAY;IACb;GACD,GAAG,yBAAyB,SAAS;GACrC,GAAG;GACJ,CAAC;WACM;AAER,MAAI,CAAC,aAAa;AAChB,OAAI,iBAAiB,OAEnB,QAAO,EAAE;OAET,GAAE,aAAa;AAEjB,OAAI,gBAAgB,OAElB,QAAO,EAAE;OAET,GAAE,YAAY;;;CAKpB,MAAM,qBAAqB,aAAc,cAAc,IAAI;AAE3D,KAAI,OAAO,uBAAuB,SAChC,wBACE,UACA,UACA,YACA,cACA,mBACD;AAGH,QAAO;;AAGT,MAAa,mBAAmB,OAC9B,MACA,UACA,YACgC;CAEhC,MAAM,SAASF,qEADW,SACQ,CAAC;CAEnC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,WAAW,EAAE;CAE1D,MAAM,WAAWC,uCAAa,CAAC,KAAK,CAAC;CACrC,MAAM,aAAaA,uCAAa,CAAC,aAAa,CAAC;CAE/C,MAAM,eAAe,uBAAuB,UAAU,UAAU,WAAW;AAC3E,KAAI,OAAO,iBAAiB,SAAU,QAAO;CAM7C,MAAM,eAAe,OAFA,iBAAiB,SAASE,eAEP;EACtC,OAAO;GACL,UAAU;GACV;GACA,mCAAoB,SAAS;GAC7B,YAAY;GACb;EACD,GAAG,yBAAyB,SAAS;EACrC,GAAG;EACJ,CAAC;CAEF,MAAM,qBAAqB,aAAa,cAAc,IAAI;AAE1D,KAAI,OAAO,uBAAuB,SAChC,wBACE,UACA,UACA,YACA,cACA,mBACD;AAGH,QAAO"}

package/dist/esm/loadEnvFile.mjs

@@ -1,4 +1,4 @@
-import { existsSync } from "node:fs";
+import { existsSync, statSync } from "node:fs";
 import dotenv from "dotenv";
 
 //#region src/loadEnvFile.ts
@@ -11,16 +11,53 @@ const getEnvFilePath = (env = "development", envFile) => {
 		".env"
 	]).find(existsSync);
 };
-const loadEnvFile = (options) => {
-	const envFiles = getEnvFilePath(options?.env ?? DEFAULT_ENV, options?.envFile);
-	if (!envFiles) return {};
-	const result = {};
+/**
+* Cache of parsed env files keyed by `cwd|env|envFile`. Loading content
+* declarations calls `loadEnvFile` once per file; without this every call pays
+* up to 4 `existsSync` probes plus a dotenv read+parse. A cached hit is
+* validated with a single `stat` so edits to the env file are still picked up.
+*/
+const envFileCache = /* @__PURE__ */ new Map();
+const parseEnvFile = (envFilePath) => {
+	const parsedEnv = {};
 	dotenv.config({
-		path: envFiles,
-		processEnv: result,
+		path: envFilePath,
+		processEnv: parsedEnv,
 		quiet: true
 	});
-	return result;
+	return parsedEnv;
+};
+const loadEnvFile = (options) => {
+	const env = options?.env ?? DEFAULT_ENV;
+	const cacheKey = `${process.cwd()}|${env}|${options?.envFile ?? ""}`;
+	const cachedEntry = envFileCache.get(cacheKey);
+	if (cachedEntry) if (cachedEntry.envFilePath === void 0) {
+		if (!getEnvFilePath(env, options?.envFile)) return cachedEntry.parsedEnv;
+	} else try {
+		const stats = statSync(cachedEntry.envFilePath);
+		if (stats.mtimeMs === cachedEntry.mtimeMs && stats.size === cachedEntry.size) return cachedEntry.parsedEnv;
+	} catch {}
+	const envFilePath = getEnvFilePath(env, options?.envFile);
+	if (!envFilePath) {
+		envFileCache.set(cacheKey, {
+			envFilePath: void 0,
+			mtimeMs: 0,
+			size: 0,
+			parsedEnv: {}
+		});
+		return {};
+	}
+	const parsedEnv = parseEnvFile(envFilePath);
+	try {
+		const stats = statSync(envFilePath);
+		envFileCache.set(cacheKey, {
+			envFilePath,
+			mtimeMs: stats.mtimeMs,
+			size: stats.size,
+			parsedEnv
+		});
+	} catch {}
+	return parsedEnv;
 };
 
 //#endregion

package/dist/esm/loadEnvFile.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"loadEnvFile.mjs","names":[],"sources":["../../src/loadEnvFile.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport dotenv from 'dotenv';\n\nconst DEFAULT_ENV = process.env.NODE_ENV ?? 'development';\n\nexport type LoadEnvFileOptions = {\n  env?: string;\n  envFile?: string;\n};\n\nexport const getEnvFilePath = (\n  env: string = process.env.NODE_ENV ?? 'development',\n  envFile?: string\n): string | undefined => {\n  const envFiles = envFile\n    ? [envFile]\n    : [`.env.${env}.local`, `.env.${env}`, '.env.local', '.env'];\n\n  return envFiles.find(existsSync); // Returns the first existing env file\n};\n\nexport const loadEnvFile = (options?: Partial<LoadEnvFileOptions>) => {\n  const env = options?.env ?? DEFAULT_ENV;\n\n  const envFiles = getEnvFilePath(env, options?.envFile);\n\n  if (!envFiles) {\n    return {};\n  }\n\n  const result = {};\n\n  dotenv.config({\n    path: envFiles,\n    processEnv: result,\n    quiet: true,\n  });\n\n  return result; // Return the parsed env object\n};\n"],"mappings":";;;;AAGA,MAAM;AAON,MAAa,kBACX,qBACA,YACuB;AAKvB,SAJiB,UACb,CAAC,QAAQ,GACT;EAAC,QAAQ,IAAI;EAAS,QAAQ;EAAO;EAAc;EAAO,EAE9C,KAAK,WAAW;;AAGlC,MAAa,eAAe,YAA0C;CAGpE,MAAM,WAAW,eAFL,SAAS,OAAO,aAES,SAAS,QAAQ;AAEtD,KAAI,CAAC,SACH,QAAO,EAAE;CAGX,MAAM,SAAS,EAAE;AAEjB,QAAO,OAAO;EACZ,MAAM;EACN,YAAY;EACZ,OAAO;EACR,CAAC;AAEF,QAAO"}
+{"version":3,"file":"loadEnvFile.mjs","names":[],"sources":["../../src/loadEnvFile.ts"],"sourcesContent":["import { existsSync, statSync } from 'node:fs';\nimport dotenv from 'dotenv';\n\nconst DEFAULT_ENV = process.env.NODE_ENV ?? 'development';\n\nexport type LoadEnvFileOptions = {\n  env?: string;\n  envFile?: string;\n};\n\nexport const getEnvFilePath = (\n  env: string = process.env.NODE_ENV ?? 'development',\n  envFile?: string\n): string | undefined => {\n  const envFiles = envFile\n    ? [envFile]\n    : [`.env.${env}.local`, `.env.${env}`, '.env.local', '.env'];\n\n  return envFiles.find(existsSync); // Returns the first existing env file\n};\n\ntype EnvFileCacheEntry = {\n  /** The env file that was resolved and parsed (undefined if none exists). */\n  envFilePath: string | undefined;\n  /** Fingerprint of the parsed file, used to detect edits. */\n  mtimeMs: number;\n  size: number;\n  /** The parsed env variables. */\n  parsedEnv: Record<string, string>;\n};\n\n/**\n * Cache of parsed env files keyed by `cwd|env|envFile`. Loading content\n * declarations calls `loadEnvFile` once per file; without this every call pays\n * up to 4 `existsSync` probes plus a dotenv read+parse. A cached hit is\n * validated with a single `stat` so edits to the env file are still picked up.\n */\nconst envFileCache = new Map<string, EnvFileCacheEntry>();\n\nconst parseEnvFile = (envFilePath: string): Record<string, string> => {\n  const parsedEnv: Record<string, string> = {};\n\n  dotenv.config({\n    path: envFilePath,\n    processEnv: parsedEnv,\n    quiet: true,\n  });\n\n  return parsedEnv;\n};\n\nexport const loadEnvFile = (\n  options?: Partial<LoadEnvFileOptions>\n): Record<string, string> => {\n  const env = options?.env ?? DEFAULT_ENV;\n\n  // Env file candidates are resolved relative to the working directory\n  const cacheKey = `${process.cwd()}|${env}|${options?.envFile ?? ''}`;\n\n  const cachedEntry = envFileCache.get(cacheKey);\n\n  if (cachedEntry) {\n    if (cachedEntry.envFilePath === undefined) {\n      // No env file existed. Re-probe cheaply in case one was created since.\n      const envFilePath = getEnvFilePath(env, options?.envFile);\n      if (!envFilePath) return cachedEntry.parsedEnv;\n    } else {\n      try {\n        const stats = statSync(cachedEntry.envFilePath);\n        if (\n          stats.mtimeMs === cachedEntry.mtimeMs &&\n          stats.size === cachedEntry.size\n        ) {\n          return cachedEntry.parsedEnv;\n        }\n      } catch {\n        // File was removed — fall through and re-resolve\n      }\n    }\n  }\n\n  const envFilePath = getEnvFilePath(env, options?.envFile);\n\n  if (!envFilePath) {\n    envFileCache.set(cacheKey, {\n      envFilePath: undefined,\n      mtimeMs: 0,\n      size: 0,\n      parsedEnv: {},\n    });\n    return {};\n  }\n\n  const parsedEnv = parseEnvFile(envFilePath);\n\n  try {\n    const stats = statSync(envFilePath);\n    envFileCache.set(cacheKey, {\n      envFilePath,\n      mtimeMs: stats.mtimeMs,\n      size: stats.size,\n      parsedEnv,\n    });\n  } catch {\n    // Race: file removed between parse and stat — skip caching this round\n  }\n\n  return parsedEnv; // Return the parsed env object\n};\n"],"mappings":";;;;AAGA,MAAM;AAON,MAAa,kBACX,qBACA,YACuB;AAKvB,SAJiB,UACb,CAAC,QAAQ,GACT;EAAC,QAAQ,IAAI;EAAS,QAAQ;EAAO;EAAc;EAAO,EAE9C,KAAK,WAAW;;;;;;;;AAmBlC,MAAM,+BAAe,IAAI,KAAgC;AAEzD,MAAM,gBAAgB,gBAAgD;CACpE,MAAM,YAAoC,EAAE;AAE5C,QAAO,OAAO;EACZ,MAAM;EACN,YAAY;EACZ,OAAO;EACR,CAAC;AAEF,QAAO;;AAGT,MAAa,eACX,YAC2B;CAC3B,MAAM,MAAM,SAAS,OAAO;CAG5B,MAAM,WAAW,GAAG,QAAQ,KAAK,CAAC,GAAG,IAAI,GAAG,SAAS,WAAW;CAEhE,MAAM,cAAc,aAAa,IAAI,SAAS;AAE9C,KAAI,YACF,KAAI,YAAY,gBAAgB,QAG9B;MAAI,CADgB,eAAe,KAAK,SAAS,QACjC,CAAE,QAAO,YAAY;OAErC,KAAI;EACF,MAAM,QAAQ,SAAS,YAAY,YAAY;AAC/C,MACE,MAAM,YAAY,YAAY,WAC9B,MAAM,SAAS,YAAY,KAE3B,QAAO,YAAY;SAEf;CAMZ,MAAM,cAAc,eAAe,KAAK,SAAS,QAAQ;AAEzD,KAAI,CAAC,aAAa;AAChB,eAAa,IAAI,UAAU;GACzB,aAAa;GACb,SAAS;GACT,MAAM;GACN,WAAW,EAAE;GACd,CAAC;AACF,SAAO,EAAE;;CAGX,MAAM,YAAY,aAAa,YAAY;AAE3C,KAAI;EACF,MAAM,QAAQ,SAAS,YAAY;AACnC,eAAa,IAAI,UAAU;GACzB;GACA,SAAS,MAAM;GACf,MAAM,MAAM;GACZ;GACD,CAAC;SACI;AAIR,QAAO"}

package/dist/esm/loadExternalFile/index.mjs

@@ -1,7 +1,7 @@
 import { getSandBoxContext, parseFileContent } from "./parseFileContent.mjs";
 import { bundleFile, bundleFileSync, getLoader } from "./bundleFile.mjs";
-import { transpileTSToCJS, transpileTSToCJSSync } from "./transpileTSToCJS.mjs";
+import { clearTranspileCache, transpileTSToCJS, transpileTSToCJSSync } from "./transpileTSToCJS.mjs";
 import { loadExternalFile, loadExternalFileSync } from "./loadExternalFile.mjs";
 import { bundleJSFile } from "./bundleJSFile.mjs";
 
-export { bundleFile, bundleFileSync, bundleJSFile, getLoader, getSandBoxContext, loadExternalFile, loadExternalFileSync, parseFileContent, transpileTSToCJS, transpileTSToCJSSync };
+export { bundleFile, bundleFileSync, bundleJSFile, clearTranspileCache, getLoader, getSandBoxContext, loadExternalFile, loadExternalFileSync, parseFileContent, transpileTSToCJS, transpileTSToCJSSync };

package/dist/esm/loadExternalFile/loadExternalFile.mjs

@@ -22,13 +22,13 @@ const loadExternalFileSync = (filePath, options) => {
 			logger("File could not be loaded.", { level: "error" });
 			return;
 		}
-		const fileContent = parseFileContent(moduleResultString, {
+		const fileContent = withPreloadedGlobals(options?.preloadGlobals, () => parseFileContent(moduleResultString, {
 			projectRequire: options?.projectRequire,
 			envVarOptions: options?.envVarOptions,
 			additionalEnvVars: options?.additionalEnvVars,
 			mocks: options?.mocks,
 			aliases: options?.aliases
-		});
+		}));
 		if (typeof fileContent === "undefined") {
 			logger(`File could not be loaded. Path : ${filePath}`);
 			return;
@@ -41,15 +41,17 @@ const loadExternalFileSync = (filePath, options) => {
 const withPreloadedGlobals = (globals, fn) => {
 	if (!globals) return fn();
 	const globalVars = globalThis;
-	const prev = {};
+	const previousValues = {};
+	const previouslyPresent = {};
 	for (const [key, value] of Object.entries(globals)) {
-		prev[key] = globalVars[key];
+		previouslyPresent[key] = key in globalVars;
+		previousValues[key] = globalVars[key];
 		globalVars[key] = value;
 	}
 	try {
 		return fn();
 	} finally {
-		for (const key of Object.keys(globals)) if (prev[key] !== void 0) globalVars[key] = prev[key];
+		for (const key of Object.keys(globals)) if (previouslyPresent[key]) globalVars[key] = previousValues[key];
 		else delete globalVars[key];
 	}
 };

package/dist/esm/loadExternalFile/loadExternalFile.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"loadExternalFile.mjs","names":[],"sources":["../../../src/loadExternalFile/loadExternalFile.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport { extname } from 'node:path';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport JSON5 from 'json5';\nimport { colorizePath, logger } from '../logger';\nimport {\n  parseFileContent,\n  type SandBoxContextOptions,\n} from './parseFileContent';\nimport {\n  type TranspileOptions,\n  transpileTSToCJS,\n  transpileTSToCJSSync,\n} from './transpileTSToCJS';\n\n// CJS MJS cross usage\nconst parseJSON5 = JSON5.parse || (JSON5 as any).default?.parse;\n\nexport type LoadExternalFileOptions = {\n  configuration?: IntlayerConfig;\n  buildOptions?: TranspileOptions;\n  logError?: boolean;\n  /**\n   * Key-value pairs to temporarily set on the main Node.js `globalThis` for the\n   * synchronous duration of `parseFileContent` / `runInNewContext`. External modules\n   * loaded via `require()` inside the VM (e.g. `@intlayer/core`'s `file()` helper)\n   * run in the main context and read from the real `globalThis`, not the VM sandbox.\n   * Values are restored (or deleted) after `runInNewContext` returns.\n   */\n  preloadGlobals?: Record<string, unknown>;\n} & SandBoxContextOptions;\n\n/**\n * Load the content declaration from the given path\n *\n * Accepts JSON, JS, MJS and TS files as configuration\n */\nexport const loadExternalFileSync = (\n  filePath: string,\n  options?: LoadExternalFileOptions\n): any | undefined => {\n  const fileExtension = extname(filePath) || '.json';\n\n  try {\n    if (\n      fileExtension === '.json' ||\n      fileExtension === '.json5' ||\n      fileExtension === '.jsonc'\n    ) {\n      // Assume JSON\n      return parseJSON5(readFileSync(filePath, 'utf-8'));\n    }\n\n    // Rest is JS, MJS or TS\n    const code = readFileSync(filePath, 'utf-8');\n\n    const moduleResultString: string | undefined = transpileTSToCJSSync(\n      code,\n      filePath,\n      options?.buildOptions\n    );\n\n    if (!moduleResultString) {\n      logger('File could not be loaded.', { level: 'error' });\n      return undefined;\n    }\n\n    const fileContent = parseFileContent(moduleResultString, {\n      projectRequire: options?.projectRequire,\n      envVarOptions: options?.envVarOptions,\n      additionalEnvVars: options?.additionalEnvVars,\n      mocks: options?.mocks,\n      aliases: options?.aliases,\n    });\n\n    if (typeof fileContent === 'undefined') {\n      logger(`File could not be loaded. Path : ${filePath}`);\n      return undefined;\n    }\n\n    return fileContent;\n  } catch (error) {\n    logger(\n      [\n        `Error: ${(error as Error).message} - `,\n        JSON.stringify((error as Error).stack, null, 2),\n      ],\n      {\n        level: 'error',\n      }\n    );\n  }\n};\n\nconst withPreloadedGlobals = <T>(\n  globals: Record<string, unknown> | undefined,\n  fn: () => T\n): T => {\n  if (!globals) return fn();\n\n  const globalVars = globalThis as Record<string, unknown>;\n  const prev: Record<string, unknown> = {};\n\n  for (const [key, value] of Object.entries(globals)) {\n    prev[key] = globalVars[key];\n    globalVars[key] = value;\n  }\n\n  try {\n    return fn();\n  } finally {\n    for (const key of Object.keys(globals)) {\n      if (prev[key] !== undefined) {\n        globalVars[key] = prev[key];\n      } else {\n        delete globalVars[key];\n      }\n    }\n  }\n};\n\n/**\n * Load the content declaration from the given path\n *\n * Accepts JSON, JS, MJS and TS files as configuration\n */\nexport const loadExternalFile = async (\n  filePath: string,\n  options?: LoadExternalFileOptions\n): Promise<any | undefined> => {\n  const fileExtension = extname(filePath);\n\n  try {\n    if (\n      fileExtension === '.json' ||\n      fileExtension === '.json5' ||\n      fileExtension === '.jsonc'\n    ) {\n      // Remove cache to force getting fresh content\n      const fileContent = await readFile(filePath, 'utf-8');\n      return parseJSON5(fileContent);\n    }\n\n    // Rest is JS, MJS or TS\n    const code = await readFile(filePath, 'utf-8');\n\n    const moduleResultString: string | undefined = await transpileTSToCJS(\n      code,\n      filePath,\n      options?.buildOptions\n    );\n\n    if (!moduleResultString) {\n      logger('File could not be loaded.', { level: 'error' });\n      return undefined;\n    }\n\n    // parseFileContent/runInNewContext is synchronous, so withPreloadedGlobals\n    // has no interleaving risk even when multiple files are processed concurrently.\n    const fileContent = withPreloadedGlobals(options?.preloadGlobals, () =>\n      parseFileContent(moduleResultString, {\n        projectRequire: options?.projectRequire,\n        envVarOptions: options?.envVarOptions,\n        additionalEnvVars: options?.additionalEnvVars,\n        mocks: options?.mocks,\n        aliases: options?.aliases,\n      })\n    );\n\n    if (typeof fileContent === 'undefined') {\n      logger(`File could not be loaded. Path : ${colorizePath(filePath)}`);\n      return undefined;\n    }\n\n    return fileContent;\n  } catch (error) {\n    if (options?.logError ?? true) {\n      logger(\n        [\n          `Error: ${(error as Error).message} - `,\n          JSON.stringify((error as Error).stack, null, 2),\n        ],\n        {\n          level: 'error',\n        }\n      );\n    }\n  }\n};\n"],"mappings":";;;;;;;;;AAiBA,MAAM,aAAa,MAAM,SAAU,MAAc,SAAS;;;;;;AAqB1D,MAAa,wBACX,UACA,YACoB;CACpB,MAAM,gBAAgB,QAAQ,SAAS,IAAI;AAE3C,KAAI;AACF,MACE,kBAAkB,WAClB,kBAAkB,YAClB,kBAAkB,SAGlB,QAAO,WAAW,aAAa,UAAU,QAAQ,CAAC;EAMpD,MAAM,qBAAyC,qBAFlC,aAAa,UAAU,QAG9B,EACJ,UACA,SAAS,aACV;AAED,MAAI,CAAC,oBAAoB;AACvB,UAAO,6BAA6B,EAAE,OAAO,SAAS,CAAC;AACvD;;EAGF,MAAM,cAAc,iBAAiB,oBAAoB;GACvD,gBAAgB,SAAS;GACzB,eAAe,SAAS;GACxB,mBAAmB,SAAS;GAC5B,OAAO,SAAS;GAChB,SAAS,SAAS;GACnB,CAAC;AAEF,MAAI,OAAO,gBAAgB,aAAa;AACtC,UAAO,oCAAoC,WAAW;AACtD;;AAGF,SAAO;UACA,OAAO;AACd,SACE,CACE,UAAW,MAAgB,QAAQ,MACnC,KAAK,UAAW,MAAgB,OAAO,MAAM,EAAE,CAChD,EACD,EACE,OAAO,SACR,CACF;;;AAIL,MAAM,wBACJ,SACA,OACM;AACN,KAAI,CAAC,QAAS,QAAO,IAAI;CAEzB,MAAM,aAAa;CACnB,MAAM,OAAgC,EAAE;AAExC,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,EAAE;AAClD,OAAK,OAAO,WAAW;AACvB,aAAW,OAAO;;AAGpB,KAAI;AACF,SAAO,IAAI;WACH;AACR,OAAK,MAAM,OAAO,OAAO,KAAK,QAAQ,CACpC,KAAI,KAAK,SAAS,OAChB,YAAW,OAAO,KAAK;MAEvB,QAAO,WAAW;;;;;;;;AAW1B,MAAa,mBAAmB,OAC9B,UACA,YAC6B;CAC7B,MAAM,gBAAgB,QAAQ,SAAS;AAEvC,KAAI;AACF,MACE,kBAAkB,WAClB,kBAAkB,YAClB,kBAAkB,SAIlB,QAAO,WAAW,MADQ,SAAS,UAAU,QAAQ,CACvB;EAMhC,MAAM,qBAAyC,MAAM,iBACnD,MAHiB,SAAS,UAAU,QAAQ,EAI5C,UACA,SAAS,aACV;AAED,MAAI,CAAC,oBAAoB;AACvB,UAAO,6BAA6B,EAAE,OAAO,SAAS,CAAC;AACvD;;EAKF,MAAM,cAAc,qBAAqB,SAAS,sBAChD,iBAAiB,oBAAoB;GACnC,gBAAgB,SAAS;GACzB,eAAe,SAAS;GACxB,mBAAmB,SAAS;GAC5B,OAAO,SAAS;GAChB,SAAS,SAAS;GACnB,CAAC,CACH;AAED,MAAI,OAAO,gBAAgB,aAAa;AACtC,UAAO,oCAAoC,aAAa,SAAS,GAAG;AACpE;;AAGF,SAAO;UACA,OAAO;AACd,MAAI,SAAS,YAAY,KACvB,QACE,CACE,UAAW,MAAgB,QAAQ,MACnC,KAAK,UAAW,MAAgB,OAAO,MAAM,EAAE,CAChD,EACD,EACE,OAAO,SACR,CACF"}
+{"version":3,"file":"loadExternalFile.mjs","names":[],"sources":["../../../src/loadExternalFile/loadExternalFile.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport { extname } from 'node:path';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport JSON5 from 'json5';\nimport { colorizePath, logger } from '../logger';\nimport {\n  parseFileContent,\n  type SandBoxContextOptions,\n} from './parseFileContent';\nimport {\n  type TranspileOptions,\n  transpileTSToCJS,\n  transpileTSToCJSSync,\n} from './transpileTSToCJS';\n\n// CJS MJS cross usage\nconst parseJSON5 = JSON5.parse || (JSON5 as any).default?.parse;\n\nexport type LoadExternalFileOptions = {\n  configuration?: IntlayerConfig;\n  buildOptions?: TranspileOptions;\n  logError?: boolean;\n  /**\n   * Key-value pairs to temporarily set on the main Node.js `globalThis` for the\n   * synchronous duration of `parseFileContent` / `runInNewContext`. External modules\n   * loaded via `require()` inside the VM (e.g. `@intlayer/core`'s `file()` helper)\n   * run in the main context and read from the real `globalThis`, not the VM sandbox.\n   * Values are restored (or deleted) after `runInNewContext` returns.\n   */\n  preloadGlobals?: Record<string, unknown>;\n} & SandBoxContextOptions;\n\n/**\n * Load the content declaration from the given path\n *\n * Accepts JSON, JS, MJS and TS files as configuration\n */\nexport const loadExternalFileSync = (\n  filePath: string,\n  options?: LoadExternalFileOptions\n): any | undefined => {\n  const fileExtension = extname(filePath) || '.json';\n\n  try {\n    if (\n      fileExtension === '.json' ||\n      fileExtension === '.json5' ||\n      fileExtension === '.jsonc'\n    ) {\n      // Assume JSON\n      return parseJSON5(readFileSync(filePath, 'utf-8'));\n    }\n\n    // Rest is JS, MJS or TS\n    const code = readFileSync(filePath, 'utf-8');\n\n    const moduleResultString: string | undefined = transpileTSToCJSSync(\n      code,\n      filePath,\n      options?.buildOptions\n    );\n\n    if (!moduleResultString) {\n      logger('File could not be loaded.', { level: 'error' });\n      return undefined;\n    }\n\n    // parseFileContent/runInNewContext is synchronous, so withPreloadedGlobals\n    // fully restores the globals before returning.\n    const fileContent = withPreloadedGlobals(options?.preloadGlobals, () =>\n      parseFileContent(moduleResultString, {\n        projectRequire: options?.projectRequire,\n        envVarOptions: options?.envVarOptions,\n        additionalEnvVars: options?.additionalEnvVars,\n        mocks: options?.mocks,\n        aliases: options?.aliases,\n      })\n    );\n\n    if (typeof fileContent === 'undefined') {\n      logger(`File could not be loaded. Path : ${filePath}`);\n      return undefined;\n    }\n\n    return fileContent;\n  } catch (error) {\n    logger(\n      [\n        `Error: ${(error as Error).message} - `,\n        JSON.stringify((error as Error).stack, null, 2),\n      ],\n      {\n        level: 'error',\n      }\n    );\n  }\n};\n\nconst withPreloadedGlobals = <T>(\n  globals: Record<string, unknown> | undefined,\n  fn: () => T\n): T => {\n  if (!globals) return fn();\n\n  const globalVars = globalThis as Record<string, unknown>;\n  const previousValues: Record<string, unknown> = {};\n  const previouslyPresent: Record<string, boolean> = {};\n\n  for (const [key, value] of Object.entries(globals)) {\n    previouslyPresent[key] = key in globalVars;\n    previousValues[key] = globalVars[key];\n    globalVars[key] = value;\n  }\n\n  try {\n    return fn();\n  } finally {\n    for (const key of Object.keys(globals)) {\n      // `in` check (not `!== undefined`) so a global that legitimately held\n      // `undefined` is restored rather than deleted.\n      if (previouslyPresent[key]) {\n        globalVars[key] = previousValues[key];\n      } else {\n        delete globalVars[key];\n      }\n    }\n  }\n};\n\n/**\n * Load the content declaration from the given path\n *\n * Accepts JSON, JS, MJS and TS files as configuration\n */\nexport const loadExternalFile = async (\n  filePath: string,\n  options?: LoadExternalFileOptions\n): Promise<any | undefined> => {\n  const fileExtension = extname(filePath);\n\n  try {\n    if (\n      fileExtension === '.json' ||\n      fileExtension === '.json5' ||\n      fileExtension === '.jsonc'\n    ) {\n      // Remove cache to force getting fresh content\n      const fileContent = await readFile(filePath, 'utf-8');\n      return parseJSON5(fileContent);\n    }\n\n    // Rest is JS, MJS or TS\n    const code = await readFile(filePath, 'utf-8');\n\n    const moduleResultString: string | undefined = await transpileTSToCJS(\n      code,\n      filePath,\n      options?.buildOptions\n    );\n\n    if (!moduleResultString) {\n      logger('File could not be loaded.', { level: 'error' });\n      return undefined;\n    }\n\n    // parseFileContent/runInNewContext is synchronous, so withPreloadedGlobals\n    // has no interleaving risk even when multiple files are processed concurrently.\n    const fileContent = withPreloadedGlobals(options?.preloadGlobals, () =>\n      parseFileContent(moduleResultString, {\n        projectRequire: options?.projectRequire,\n        envVarOptions: options?.envVarOptions,\n        additionalEnvVars: options?.additionalEnvVars,\n        mocks: options?.mocks,\n        aliases: options?.aliases,\n      })\n    );\n\n    if (typeof fileContent === 'undefined') {\n      logger(`File could not be loaded. Path : ${colorizePath(filePath)}`);\n      return undefined;\n    }\n\n    return fileContent;\n  } catch (error) {\n    if (options?.logError ?? true) {\n      logger(\n        [\n          `Error: ${(error as Error).message} - `,\n          JSON.stringify((error as Error).stack, null, 2),\n        ],\n        {\n          level: 'error',\n        }\n      );\n    }\n  }\n};\n"],"mappings":";;;;;;;;;AAiBA,MAAM,aAAa,MAAM,SAAU,MAAc,SAAS;;;;;;AAqB1D,MAAa,wBACX,UACA,YACoB;CACpB,MAAM,gBAAgB,QAAQ,SAAS,IAAI;AAE3C,KAAI;AACF,MACE,kBAAkB,WAClB,kBAAkB,YAClB,kBAAkB,SAGlB,QAAO,WAAW,aAAa,UAAU,QAAQ,CAAC;EAMpD,MAAM,qBAAyC,qBAFlC,aAAa,UAAU,QAG9B,EACJ,UACA,SAAS,aACV;AAED,MAAI,CAAC,oBAAoB;AACvB,UAAO,6BAA6B,EAAE,OAAO,SAAS,CAAC;AACvD;;EAKF,MAAM,cAAc,qBAAqB,SAAS,sBAChD,iBAAiB,oBAAoB;GACnC,gBAAgB,SAAS;GACzB,eAAe,SAAS;GACxB,mBAAmB,SAAS;GAC5B,OAAO,SAAS;GAChB,SAAS,SAAS;GACnB,CAAC,CACH;AAED,MAAI,OAAO,gBAAgB,aAAa;AACtC,UAAO,oCAAoC,WAAW;AACtD;;AAGF,SAAO;UACA,OAAO;AACd,SACE,CACE,UAAW,MAAgB,QAAQ,MACnC,KAAK,UAAW,MAAgB,OAAO,MAAM,EAAE,CAChD,EACD,EACE,OAAO,SACR,CACF;;;AAIL,MAAM,wBACJ,SACA,OACM;AACN,KAAI,CAAC,QAAS,QAAO,IAAI;CAEzB,MAAM,aAAa;CACnB,MAAM,iBAA0C,EAAE;CAClD,MAAM,oBAA6C,EAAE;AAErD,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,EAAE;AAClD,oBAAkB,OAAO,OAAO;AAChC,iBAAe,OAAO,WAAW;AACjC,aAAW,OAAO;;AAGpB,KAAI;AACF,SAAO,IAAI;WACH;AACR,OAAK,MAAM,OAAO,OAAO,KAAK,QAAQ,CAGpC,KAAI,kBAAkB,KACpB,YAAW,OAAO,eAAe;MAEjC,QAAO,WAAW;;;;;;;;AAW1B,MAAa,mBAAmB,OAC9B,UACA,YAC6B;CAC7B,MAAM,gBAAgB,QAAQ,SAAS;AAEvC,KAAI;AACF,MACE,kBAAkB,WAClB,kBAAkB,YAClB,kBAAkB,SAIlB,QAAO,WAAW,MADQ,SAAS,UAAU,QAAQ,CACvB;EAMhC,MAAM,qBAAyC,MAAM,iBACnD,MAHiB,SAAS,UAAU,QAAQ,EAI5C,UACA,SAAS,aACV;AAED,MAAI,CAAC,oBAAoB;AACvB,UAAO,6BAA6B,EAAE,OAAO,SAAS,CAAC;AACvD;;EAKF,MAAM,cAAc,qBAAqB,SAAS,sBAChD,iBAAiB,oBAAoB;GACnC,gBAAgB,SAAS;GACzB,eAAe,SAAS;GACxB,mBAAmB,SAAS;GAC5B,OAAO,SAAS;GAChB,SAAS,SAAS;GACnB,CAAC,CACH;AAED,MAAI,OAAO,gBAAgB,aAAa;AACtC,UAAO,oCAAoC,aAAa,SAAS,GAAG;AACpE;;AAGF,SAAO;UACA,OAAO;AACd,MAAI,SAAS,YAAY,KACvB,QACE,CACE,UAAW,MAAgB,QAAQ,MACnC,KAAK,UAAW,MAAgB,OAAO,MAAM,EAAE,CAChD,EACD,EACE,OAAO,SACR,CACF"}

package/dist/esm/loadExternalFile/parseFileContent.mjs

@@ -24,9 +24,58 @@ const NODE_GLOBALS = [
 	"crypto",
 	"structuredClone"
 ];
+/**
+* Cache of the project's React module (or the JSX-capturing fallback) keyed by
+* the require's resolution paths. Node does not cache *failed* resolutions, so
+* without this every sandbox creation in a non-React project (Vue, Svelte,
+* Angular…) pays a full node_modules walk that ends in a throw.
+*/
+const reactModuleCache = /* @__PURE__ */ new Map();
+/**
+* Fallback React implementation used when React is not installed in the
+* project. It captures JSX elements as plain objects so JSX can be used in
+* content declarations (esbuild's tsx loader defaults to React.createElement).
+*/
+const createFallbackReact = () => ({
+	createElement: (type, props, ...children) => ({
+		type,
+		props: {
+			...props,
+			children: children.length <= 1 ? children[0] : children
+		}
+	}),
+	Fragment: Symbol.for("react.fragment")
+});
+const getReactGlobal = (baseRequire) => {
+	const resolutionKey = baseRequire.resolve.paths?.("react")?.join("|") ?? "<default>";
+	const cachedReactModule = reactModuleCache.get(resolutionKey);
+	if (cachedReactModule) return cachedReactModule;
+	let reactGlobal;
+	try {
+		reactGlobal = { React: baseRequire("react") };
+	} catch (_err) {
+		reactGlobal = { React: createFallbackReact() };
+	}
+	reactModuleCache.set(resolutionKey, reactGlobal);
+	return reactGlobal;
+};
+/**
+* Snapshot of the non-env `process` properties, taken once at module load.
+* Spreading `process` enumerates ~100 properties (some behind getters); doing
+* it per sandbox is wasteful since everything except `env` is static.
+*/
+const processSnapshot = { ...process };
+/**
+* Builds the global context handed to `runInNewContext`.
+*
+* SECURITY NOTE: this sandbox exists for global-scope hygiene (fresh
+* module/exports, controlled env), NOT for containment. It exposes the real
+* project `require`, a copy of `process`, and `fetch` — code executed here has
+* full host privileges. Only ever run trusted, build-time project files
+* (same trust model as `vite.config.ts`).
+*/
 const getSandBoxContext = (options) => {
 	const { envVarOptions, projectRequire, additionalEnvVars, mocks, aliases } = options ?? {};
-	let additionalGlobalVar = {};
 	const baseRequire = typeof projectRequire === "function" ? projectRequire : getProjectRequire();
 	const mockedRequire = (() => {
 		const mockTable = Object.assign({ esbuild }, mocks);
@@ -43,25 +92,11 @@ const getSandBoxContext = (options) => {
 		wrappedRequire.cache = baseRequire.cache;
 		return wrappedRequire;
 	})();
-	try {
-		additionalGlobalVar = { React: baseRequire("react") };
-	} catch (_err) {
-		additionalGlobalVar = { React: {
-			createElement: (type, props, ...children) => ({
-				type,
-				props: {
-					...props,
-					children: children.length <= 1 ? children[0] : children
-				}
-			}),
-			Fragment: Symbol.for("react.fragment")
-		} };
-	}
 	const sandboxContext = {
 		exports: { default: {} },
 		module: { exports: {} },
 		process: {
-			...process,
+			...processSnapshot,
 			env: {
 				...process.env,
 				...loadEnvFile(envVarOptions),
@@ -70,7 +105,7 @@ const getSandBoxContext = (options) => {
 		},
 		console,
 		require: mockedRequire,
-		...additionalGlobalVar
+		...getReactGlobal(baseRequire)
 	};
 	for (const key of NODE_GLOBALS) if (!(key in sandboxContext) && key in globalThis) sandboxContext[key] = globalThis[key];
 	return sandboxContext;

package/dist/esm/loadExternalFile/parseFileContent.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"parseFileContent.mjs","names":[],"sources":["../../../src/loadExternalFile/parseFileContent.ts"],"sourcesContent":["import { type Context, runInNewContext } from 'node:vm';\nimport * as esbuild from 'esbuild';\nimport { type LoadEnvFileOptions, loadEnvFile } from '../loadEnvFile';\nimport { getProjectRequire } from '../utils/ESMxCJSHelpers';\n\nexport type SandBoxContextOptions = {\n  envVarOptions?: LoadEnvFileOptions;\n  projectRequire?: NodeJS.Require;\n  additionalEnvVars?: Record<string, string>;\n  /**\n   * Map of specifier -> mocked export to be returned when code in the VM calls require(specifier).\n   * Example:\n   *   mocks: {\n   *     '@intlayer/config/built': { getConfig: () => ({}), Locales: {} }\n   *   }\n   */\n  mocks?: Record<string, any>;\n  /**\n   * Optional alias map if you want to redirect specifiers.\n   * Useful when user code imports a subpath you want to collapse.\n   * Example:\n   *   aliases: { '@intlayer/config/built': '@intlayer/config' }\n   */\n  aliases?: Record<string, string>;\n};\n\n// Inject only Node.js-specific globals that are absent from a plain V8 context.\n// JS built-ins (Object, Array, Promise, Math, Date, JSON, Symbol, etc.) are\n// provided automatically by runInNewContext — no need to copy them.\n// Copying all of globalThis would retain hundreds of references (including the\n// full module cache via `global`) inside every sandbox, causing a memory leak.\nconst NODE_GLOBALS = [\n  'Buffer',\n  'setTimeout',\n  'clearTimeout',\n  'setInterval',\n  'clearInterval',\n  'setImmediate',\n  'clearImmediate',\n  'queueMicrotask',\n  'URL',\n  'URLSearchParams',\n  'TextEncoder',\n  'TextDecoder',\n  'AbortController',\n  'AbortSignal',\n  'performance',\n  'fetch',\n  'crypto',\n  'structuredClone',\n] as const;\n\nexport const getSandBoxContext = (options?: SandBoxContextOptions): Context => {\n  const { envVarOptions, projectRequire, additionalEnvVars, mocks, aliases } =\n    options ?? {};\n\n  let additionalGlobalVar = {};\n\n  const baseRequire: NodeJS.Require =\n    typeof projectRequire === 'function' ? projectRequire : getProjectRequire();\n\n  // Wrap require to honor mocks and aliases inside the VM\n  const mockedRequire: NodeJS.Require = (() => {\n    const mockTable = Object.assign(\n      {\n        esbuild,\n      },\n      mocks\n    );\n    const aliasTable = Object.assign({}, aliases);\n\n    const wrappedRequire = function mockableRequire(id: string) {\n      const target = aliasTable?.[id] ? aliasTable[id] : id;\n\n      if (mockTable && Object.hasOwn(mockTable, target)) {\n        return mockTable[target];\n      }\n\n      // If the original id was aliased, allow mocks to be defined on either key.\n      if (target !== id && mockTable && Object.hasOwn(mockTable, id)) {\n        return mockTable[id];\n      }\n\n      return baseRequire(target);\n    } as NodeJS.Require;\n\n    // Mirror NodeJS.Require properties\n    wrappedRequire.resolve = baseRequire.resolve.bind(baseRequire);\n    wrappedRequire.main = baseRequire.main;\n    wrappedRequire.extensions = baseRequire.extensions;\n    wrappedRequire.cache = baseRequire.cache;\n\n    return wrappedRequire;\n  })();\n\n  try {\n    // Dynamically try to require React if it's installed in the project\n    additionalGlobalVar = {\n      React: baseRequire('react'),\n    };\n  } catch (_err) {\n    // React is not installed, so we inject a dummy React object to capture JSX elements\n    // This allows using JSX in content declarations even if React is not installed (e.g. in Solid.js or Vue projects)\n    // because esbuild's tsx loader defaults to React.createElement.\n    additionalGlobalVar = {\n      React: {\n        createElement: (type: any, props: any, ...children: any[]) => ({\n          type,\n          props: {\n            ...props,\n            children: children.length <= 1 ? children[0] : children,\n          },\n        }),\n        Fragment: Symbol.for('react.fragment'),\n      },\n    };\n  }\n\n  const sandboxContext: Context = {\n    exports: {\n      default: {},\n    },\n    module: {\n      exports: {},\n    },\n    process: {\n      ...process,\n      env: {\n        ...process.env,\n        ...loadEnvFile(envVarOptions),\n        ...additionalEnvVars,\n      },\n    },\n    console,\n    require: mockedRequire,\n    ...additionalGlobalVar,\n  };\n\n  for (const key of NODE_GLOBALS) {\n    if (!(key in sandboxContext) && key in globalThis) {\n      (sandboxContext as Record<string, unknown>)[key] =\n        globalThis[key as keyof typeof globalThis];\n    }\n  }\n\n  return sandboxContext;\n};\n\nexport const parseFileContent = <T>(\n  fileContentString: string,\n  options?: SandBoxContextOptions\n): T | undefined => {\n  const sandboxContext = getSandBoxContext(options);\n\n  // Force strict mode so illegal writes throw instead of silently failing.\n  runInNewContext(`\"use strict\";\\n${fileContentString}`, sandboxContext);\n\n  const candidates: unknown[] = [\n    sandboxContext.exports?.default,\n    sandboxContext.module?.exports?.defaults,\n    sandboxContext.module?.exports?.default,\n    sandboxContext.module?.exports,\n  ];\n\n  let result: T | undefined;\n  for (const candidate of candidates) {\n    if (\n      candidate &&\n      typeof candidate === 'object' &&\n      Object.keys(candidate as object).length > 0\n    ) {\n      result = candidate as T;\n      break;\n    }\n  }\n\n  // Drop heavy references so the V8 context created by runInNewContext can be\n  // garbage-collected promptly. The extracted `result` is a plain data object\n  // and does not retain the sandbox.\n  (sandboxContext as Record<string, unknown>).require = undefined;\n  (sandboxContext as Record<string, unknown>).process = undefined;\n  (sandboxContext as Record<string, unknown>).React = undefined;\n  (sandboxContext as Record<string, unknown>).module = undefined;\n  (sandboxContext as Record<string, unknown>).exports = undefined;\n\n  return result;\n};\n"],"mappings":";;;;;;AA+BA,MAAM,eAAe;CACnB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,MAAa,qBAAqB,YAA6C;CAC7E,MAAM,EAAE,eAAe,gBAAgB,mBAAmB,OAAO,YAC/D,WAAW,EAAE;CAEf,IAAI,sBAAsB,EAAE;CAE5B,MAAM,cACJ,OAAO,mBAAmB,aAAa,iBAAiB,mBAAmB;CAG7E,MAAM,uBAAuC;EAC3C,MAAM,YAAY,OAAO,OACvB,EACE,SACD,EACD,MACD;EACD,MAAM,aAAa,OAAO,OAAO,EAAE,EAAE,QAAQ;EAE7C,MAAM,iBAAiB,SAAS,gBAAgB,IAAY;GAC1D,MAAM,SAAS,aAAa,MAAM,WAAW,MAAM;AAEnD,OAAI,aAAa,OAAO,OAAO,WAAW,OAAO,CAC/C,QAAO,UAAU;AAInB,OAAI,WAAW,MAAM,aAAa,OAAO,OAAO,WAAW,GAAG,CAC5D,QAAO,UAAU;AAGnB,UAAO,YAAY,OAAO;;AAI5B,iBAAe,UAAU,YAAY,QAAQ,KAAK,YAAY;AAC9D,iBAAe,OAAO,YAAY;AAClC,iBAAe,aAAa,YAAY;AACxC,iBAAe,QAAQ,YAAY;AAEnC,SAAO;KACL;AAEJ,KAAI;AAEF,wBAAsB,EACpB,OAAO,YAAY,QAAQ,EAC5B;UACM,MAAM;AAIb,wBAAsB,EACpB,OAAO;GACL,gBAAgB,MAAW,OAAY,GAAG,cAAqB;IAC7D;IACA,OAAO;KACL,GAAG;KACH,UAAU,SAAS,UAAU,IAAI,SAAS,KAAK;KAChD;IACF;GACD,UAAU,OAAO,IAAI,iBAAiB;GACvC,EACF;;CAGH,MAAM,iBAA0B;EAC9B,SAAS,EACP,SAAS,EAAE,EACZ;EACD,QAAQ,EACN,SAAS,EAAE,EACZ;EACD,SAAS;GACP,GAAG;GACH,KAAK;IACH,GAAG,QAAQ;IACX,GAAG,YAAY,cAAc;IAC7B,GAAG;IACJ;GACF;EACD;EACA,SAAS;EACT,GAAG;EACJ;AAED,MAAK,MAAM,OAAO,aAChB,KAAI,EAAE,OAAO,mBAAmB,OAAO,WACrC,CAAC,eAA2C,OAC1C,WAAW;AAIjB,QAAO;;AAGT,MAAa,oBACX,mBACA,YACkB;CAClB,MAAM,iBAAiB,kBAAkB,QAAQ;AAGjD,iBAAgB,kBAAkB,qBAAqB,eAAe;CAEtE,MAAM,aAAwB;EAC5B,eAAe,SAAS;EACxB,eAAe,QAAQ,SAAS;EAChC,eAAe,QAAQ,SAAS;EAChC,eAAe,QAAQ;EACxB;CAED,IAAI;AACJ,MAAK,MAAM,aAAa,WACtB,KACE,aACA,OAAO,cAAc,YACrB,OAAO,KAAK,UAAoB,CAAC,SAAS,GAC1C;AACA,WAAS;AACT;;AAOJ,CAAC,eAA2C,UAAU;AACtD,CAAC,eAA2C,UAAU;AACtD,CAAC,eAA2C,QAAQ;AACpD,CAAC,eAA2C,SAAS;AACrD,CAAC,eAA2C,UAAU;AAEtD,QAAO"}
+{"version":3,"file":"parseFileContent.mjs","names":[],"sources":["../../../src/loadExternalFile/parseFileContent.ts"],"sourcesContent":["import { type Context, runInNewContext } from 'node:vm';\nimport * as esbuild from 'esbuild';\nimport { type LoadEnvFileOptions, loadEnvFile } from '../loadEnvFile';\nimport { getProjectRequire } from '../utils/ESMxCJSHelpers';\n\nexport type SandBoxContextOptions = {\n  envVarOptions?: LoadEnvFileOptions;\n  projectRequire?: NodeJS.Require;\n  additionalEnvVars?: Record<string, string>;\n  /**\n   * Map of specifier -> mocked export to be returned when code in the VM calls require(specifier).\n   * Example:\n   *   mocks: {\n   *     '@intlayer/config/built': { getConfig: () => ({}), Locales: {} }\n   *   }\n   */\n  mocks?: Record<string, any>;\n  /**\n   * Optional alias map if you want to redirect specifiers.\n   * Useful when user code imports a subpath you want to collapse.\n   * Example:\n   *   aliases: { '@intlayer/config/built': '@intlayer/config' }\n   */\n  aliases?: Record<string, string>;\n};\n\n// Inject only Node.js-specific globals that are absent from a plain V8 context.\n// JS built-ins (Object, Array, Promise, Math, Date, JSON, Symbol, etc.) are\n// provided automatically by runInNewContext — no need to copy them.\n// Copying all of globalThis would retain hundreds of references (including the\n// full module cache via `global`) inside every sandbox, causing a memory leak.\nconst NODE_GLOBALS = [\n  'Buffer',\n  'setTimeout',\n  'clearTimeout',\n  'setInterval',\n  'clearInterval',\n  'setImmediate',\n  'clearImmediate',\n  'queueMicrotask',\n  'URL',\n  'URLSearchParams',\n  'TextEncoder',\n  'TextDecoder',\n  'AbortController',\n  'AbortSignal',\n  'performance',\n  'fetch',\n  'crypto',\n  'structuredClone',\n] as const;\n\n/**\n * Cache of the project's React module (or the JSX-capturing fallback) keyed by\n * the require's resolution paths. Node does not cache *failed* resolutions, so\n * without this every sandbox creation in a non-React project (Vue, Svelte,\n * Angular…) pays a full node_modules walk that ends in a throw.\n */\nconst reactModuleCache = new Map<string, { React: unknown }>();\n\n/**\n * Fallback React implementation used when React is not installed in the\n * project. It captures JSX elements as plain objects so JSX can be used in\n * content declarations (esbuild's tsx loader defaults to React.createElement).\n */\nconst createFallbackReact = () => ({\n  createElement: (type: any, props: any, ...children: any[]) => ({\n    type,\n    props: {\n      ...props,\n      children: children.length <= 1 ? children[0] : children,\n    },\n  }),\n  Fragment: Symbol.for('react.fragment'),\n});\n\nconst getReactGlobal = (baseRequire: NodeJS.Require): { React: unknown } => {\n  // resolve.paths() is computed in-memory (no fs access) and identifies the\n  // node_modules chain this require instance resolves against.\n  const resolutionKey =\n    baseRequire.resolve.paths?.('react')?.join('|') ?? '<default>';\n\n  const cachedReactModule = reactModuleCache.get(resolutionKey);\n  if (cachedReactModule) return cachedReactModule;\n\n  let reactGlobal: { React: unknown };\n  try {\n    // Dynamically try to require React if it's installed in the project\n    reactGlobal = { React: baseRequire('react') };\n  } catch (_err) {\n    reactGlobal = { React: createFallbackReact() };\n  }\n\n  reactModuleCache.set(resolutionKey, reactGlobal);\n\n  return reactGlobal;\n};\n\n/**\n * Snapshot of the non-env `process` properties, taken once at module load.\n * Spreading `process` enumerates ~100 properties (some behind getters); doing\n * it per sandbox is wasteful since everything except `env` is static.\n */\nconst processSnapshot = { ...process };\n\n/**\n * Builds the global context handed to `runInNewContext`.\n *\n * SECURITY NOTE: this sandbox exists for global-scope hygiene (fresh\n * module/exports, controlled env), NOT for containment. It exposes the real\n * project `require`, a copy of `process`, and `fetch` — code executed here has\n * full host privileges. Only ever run trusted, build-time project files\n * (same trust model as `vite.config.ts`).\n */\nexport const getSandBoxContext = (options?: SandBoxContextOptions): Context => {\n  const { envVarOptions, projectRequire, additionalEnvVars, mocks, aliases } =\n    options ?? {};\n\n  const baseRequire: NodeJS.Require =\n    typeof projectRequire === 'function' ? projectRequire : getProjectRequire();\n\n  // Wrap require to honor mocks and aliases inside the VM\n  const mockedRequire: NodeJS.Require = (() => {\n    const mockTable = Object.assign(\n      {\n        esbuild,\n      },\n      mocks\n    );\n    const aliasTable = Object.assign({}, aliases);\n\n    const wrappedRequire = function mockableRequire(id: string) {\n      const target = aliasTable?.[id] ? aliasTable[id] : id;\n\n      if (mockTable && Object.hasOwn(mockTable, target)) {\n        return mockTable[target];\n      }\n\n      // If the original id was aliased, allow mocks to be defined on either key.\n      if (target !== id && mockTable && Object.hasOwn(mockTable, id)) {\n        return mockTable[id];\n      }\n\n      return baseRequire(target);\n    } as NodeJS.Require;\n\n    // Mirror NodeJS.Require properties\n    wrappedRequire.resolve = baseRequire.resolve.bind(baseRequire);\n    wrappedRequire.main = baseRequire.main;\n    wrappedRequire.extensions = baseRequire.extensions;\n    wrappedRequire.cache = baseRequire.cache;\n\n    return wrappedRequire;\n  })();\n\n  const sandboxContext: Context = {\n    exports: {\n      default: {},\n    },\n    module: {\n      exports: {},\n    },\n    process: {\n      ...processSnapshot,\n      env: {\n        ...process.env,\n        ...loadEnvFile(envVarOptions),\n        ...additionalEnvVars,\n      },\n    },\n    console,\n    require: mockedRequire,\n    ...getReactGlobal(baseRequire),\n  };\n\n  for (const key of NODE_GLOBALS) {\n    if (!(key in sandboxContext) && key in globalThis) {\n      (sandboxContext as Record<string, unknown>)[key] =\n        globalThis[key as keyof typeof globalThis];\n    }\n  }\n\n  return sandboxContext;\n};\n\nexport const parseFileContent = <T>(\n  fileContentString: string,\n  options?: SandBoxContextOptions\n): T | undefined => {\n  const sandboxContext = getSandBoxContext(options);\n\n  // Force strict mode so illegal writes throw instead of silently failing.\n  runInNewContext(`\"use strict\";\\n${fileContentString}`, sandboxContext);\n\n  const candidates: unknown[] = [\n    sandboxContext.exports?.default,\n    sandboxContext.module?.exports?.defaults,\n    sandboxContext.module?.exports?.default,\n    sandboxContext.module?.exports,\n  ];\n\n  let result: T | undefined;\n  for (const candidate of candidates) {\n    if (\n      candidate &&\n      typeof candidate === 'object' &&\n      Object.keys(candidate as object).length > 0\n    ) {\n      result = candidate as T;\n      break;\n    }\n  }\n\n  // Drop heavy references so the V8 context created by runInNewContext can be\n  // garbage-collected promptly. The extracted `result` is a plain data object\n  // and does not retain the sandbox.\n  (sandboxContext as Record<string, unknown>).require = undefined;\n  (sandboxContext as Record<string, unknown>).process = undefined;\n  (sandboxContext as Record<string, unknown>).React = undefined;\n  (sandboxContext as Record<string, unknown>).module = undefined;\n  (sandboxContext as Record<string, unknown>).exports = undefined;\n\n  return result;\n};\n"],"mappings":";;;;;;AA+BA,MAAM,eAAe;CACnB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;;;;;;AAQD,MAAM,mCAAmB,IAAI,KAAiC;;;;;;AAO9D,MAAM,6BAA6B;CACjC,gBAAgB,MAAW,OAAY,GAAG,cAAqB;EAC7D;EACA,OAAO;GACL,GAAG;GACH,UAAU,SAAS,UAAU,IAAI,SAAS,KAAK;GAChD;EACF;CACD,UAAU,OAAO,IAAI,iBAAiB;CACvC;AAED,MAAM,kBAAkB,gBAAoD;CAG1E,MAAM,gBACJ,YAAY,QAAQ,QAAQ,QAAQ,EAAE,KAAK,IAAI,IAAI;CAErD,MAAM,oBAAoB,iBAAiB,IAAI,cAAc;AAC7D,KAAI,kBAAmB,QAAO;CAE9B,IAAI;AACJ,KAAI;AAEF,gBAAc,EAAE,OAAO,YAAY,QAAQ,EAAE;UACtC,MAAM;AACb,gBAAc,EAAE,OAAO,qBAAqB,EAAE;;AAGhD,kBAAiB,IAAI,eAAe,YAAY;AAEhD,QAAO;;;;;;;AAQT,MAAM,kBAAkB,EAAE,GAAG,SAAS;;;;;;;;;;AAWtC,MAAa,qBAAqB,YAA6C;CAC7E,MAAM,EAAE,eAAe,gBAAgB,mBAAmB,OAAO,YAC/D,WAAW,EAAE;CAEf,MAAM,cACJ,OAAO,mBAAmB,aAAa,iBAAiB,mBAAmB;CAG7E,MAAM,uBAAuC;EAC3C,MAAM,YAAY,OAAO,OACvB,EACE,SACD,EACD,MACD;EACD,MAAM,aAAa,OAAO,OAAO,EAAE,EAAE,QAAQ;EAE7C,MAAM,iBAAiB,SAAS,gBAAgB,IAAY;GAC1D,MAAM,SAAS,aAAa,MAAM,WAAW,MAAM;AAEnD,OAAI,aAAa,OAAO,OAAO,WAAW,OAAO,CAC/C,QAAO,UAAU;AAInB,OAAI,WAAW,MAAM,aAAa,OAAO,OAAO,WAAW,GAAG,CAC5D,QAAO,UAAU;AAGnB,UAAO,YAAY,OAAO;;AAI5B,iBAAe,UAAU,YAAY,QAAQ,KAAK,YAAY;AAC9D,iBAAe,OAAO,YAAY;AAClC,iBAAe,aAAa,YAAY;AACxC,iBAAe,QAAQ,YAAY;AAEnC,SAAO;KACL;CAEJ,MAAM,iBAA0B;EAC9B,SAAS,EACP,SAAS,EAAE,EACZ;EACD,QAAQ,EACN,SAAS,EAAE,EACZ;EACD,SAAS;GACP,GAAG;GACH,KAAK;IACH,GAAG,QAAQ;IACX,GAAG,YAAY,cAAc;IAC7B,GAAG;IACJ;GACF;EACD;EACA,SAAS;EACT,GAAG,eAAe,YAAY;EAC/B;AAED,MAAK,MAAM,OAAO,aAChB,KAAI,EAAE,OAAO,mBAAmB,OAAO,WACrC,CAAC,eAA2C,OAC1C,WAAW;AAIjB,QAAO;;AAGT,MAAa,oBACX,mBACA,YACkB;CAClB,MAAM,iBAAiB,kBAAkB,QAAQ;AAGjD,iBAAgB,kBAAkB,qBAAqB,eAAe;CAEtE,MAAM,aAAwB;EAC5B,eAAe,SAAS;EACxB,eAAe,QAAQ,SAAS;EAChC,eAAe,QAAQ,SAAS;EAChC,eAAe,QAAQ;EACxB;CAED,IAAI;AACJ,MAAK,MAAM,aAAa,WACtB,KACE,aACA,OAAO,cAAc,YACrB,OAAO,KAAK,UAAoB,CAAC,SAAS,GAC1C;AACA,WAAS;AACT;;AAOJ,CAAC,eAA2C,UAAU;AACtD,CAAC,eAA2C,UAAU;AACtD,CAAC,eAA2C,QAAQ;AACpD,CAAC,eAA2C,SAAS;AACrD,CAAC,eAA2C,UAAU;AAEtD,QAAO"}

package/dist/esm/loadExternalFile/transpileTSToCJS.mjs

@@ -1,15 +1,30 @@
+import { computeKeyId } from "../utils/cacheMemory.mjs";
 import { getPackageJsonPath } from "../utils/getPackageJsonPath.mjs";
 import { getLoader } from "./bundleFile.mjs";
-import { existsSync } from "node:fs";
-import { dirname, extname, join } from "node:path";
+import { existsSync, statSync } from "node:fs";
+import { dirname, extname, isAbsolute, join, resolve } from "node:path";
 import { createRequire } from "node:module";
-import { buildSync, context } from "esbuild";
+import { build, buildSync } from "esbuild";
 import { pathToFileURL } from "node:url";
 
 //#region src/loadExternalFile/transpileTSToCJS.ts
+/**
+* Cache of resolved tsconfig paths keyed by the file's directory.
+* Avoids re-walking to package.json + existsSync on every transpilation.
+*/
+const tsConfigPathCache = /* @__PURE__ */ new Map();
 const getTsConfigPath = (filePath) => {
-	const tsconfigPath = join(getPackageJsonPath(dirname(filePath)).baseDir, "tsconfig.json");
-	return existsSync(tsconfigPath) ? tsconfigPath : void 0;
+	const fileDirectory = dirname(filePath);
+	if (tsConfigPathCache.has(fileDirectory)) return tsConfigPathCache.get(fileDirectory);
+	let resolvedPath;
+	try {
+		const tsconfigPath = join(getPackageJsonPath(fileDirectory).baseDir, "tsconfig.json");
+		resolvedPath = existsSync(tsconfigPath) ? tsconfigPath : void 0;
+	} catch {
+		resolvedPath = void 0;
+	}
+	tsConfigPathCache.set(fileDirectory, resolvedPath);
+	return resolvedPath;
 };
 const getTransformationOptions = (filePath) => ({
 	loader: {
@@ -29,15 +44,85 @@ const getTransformationOptions = (filePath) => ({
 	write: false,
 	packages: "external",
 	bundle: true,
+	metafile: true,
 	tsconfig: getTsConfigPath(filePath),
 	define: {
 		"import.meta.url": JSON.stringify(pathToFileURL(filePath).href),
 		"import.meta.env": "process.env"
 	}
 });
+/**
+* In-memory cache of transpiled outputs keyed by entry file path (one entry
+* per file, so re-transpilations replace rather than accumulate).
+* The entry file is validated by content hash; bundled relative imports are
+* validated by mtime + size so an edited dependency invalidates the cache.
+*/
+const transpileCache = /* @__PURE__ */ new Map();
+const isInputUnchanged = (input) => {
+	try {
+		const stats = statSync(input.path);
+		return stats.mtimeMs === input.mtimeMs && stats.size === input.size;
+	} catch {
+		return false;
+	}
+};
+const getCachedTranspilation = (filePath, codeHash, optionsKey) => {
+	const cacheEntry = transpileCache.get(filePath);
+	if (!cacheEntry) return void 0;
+	if (cacheEntry.codeHash !== codeHash) return void 0;
+	if (cacheEntry.optionsKey !== optionsKey) return void 0;
+	if (!cacheEntry.inputs.every(isInputUnchanged)) return void 0;
+	return cacheEntry.output;
+};
+/**
+* Extracts the fingerprints of every bundled input from the esbuild metafile.
+* Returns `undefined` when an input cannot be fingerprinted (the result should
+* then not be cached, as invalidation would be unreliable).
+*/
+const getInputFingerprints = (metafile, entryFilePath) => {
+	if (!metafile) return void 0;
+	const resolvedEntryFilePath = resolve(entryFilePath);
+	const inputs = [];
+	for (const inputPath of Object.keys(metafile.inputs)) {
+		if (inputPath === "<stdin>") continue;
+		if (inputPath.includes(":") && !isAbsolute(inputPath)) return void 0;
+		const absoluteInputPath = isAbsolute(inputPath) ? inputPath : resolve(process.cwd(), inputPath);
+		if (absoluteInputPath === resolvedEntryFilePath) continue;
+		try {
+			const stats = statSync(absoluteInputPath);
+			inputs.push({
+				path: absoluteInputPath,
+				mtimeMs: stats.mtimeMs,
+				size: stats.size
+			});
+		} catch {
+			return;
+		}
+	}
+	return inputs;
+};
+const setCachedTranspilation = (filePath, codeHash, optionsKey, moduleResult, output) => {
+	const inputs = getInputFingerprints(moduleResult.metafile, filePath);
+	if (!inputs) return;
+	transpileCache.set(filePath, {
+		codeHash,
+		optionsKey,
+		output,
+		inputs
+	});
+};
+/** Clears the in-memory transpilation cache (mainly for tests). */
+const clearTranspileCache = () => {
+	transpileCache.clear();
+	tsConfigPathCache.clear();
+};
 const transpileTSToCJSSync = (code, filePath, options) => {
 	const loader = getLoader(extname(filePath));
 	const { esbuildInstance, ...buildOptions } = options ?? {};
+	const codeHash = computeKeyId([code]);
+	const optionsKey = computeKeyId([buildOptions]);
+	const cachedOutput = getCachedTranspilation(filePath, codeHash, optionsKey);
+	if (typeof cachedOutput === "string") return cachedOutput;
 	const esbuildBuildSync = esbuildInstance?.buildSync ?? buildSync;
 	const g = globalThis;
 	const hadFilename = typeof g.__filename === "string";
@@ -68,12 +153,18 @@ const transpileTSToCJSSync = (code, filePath, options) => {
 			else g.__dirname = prevDirname;
 		}
 	}
-	return moduleResult.outputFiles?.[0]?.text;
+	const moduleResultString = moduleResult.outputFiles?.[0]?.text;
+	if (typeof moduleResultString === "string") setCachedTranspilation(filePath, codeHash, optionsKey, moduleResult, moduleResultString);
+	return moduleResultString;
 };
 const transpileTSToCJS = async (code, filePath, options) => {
 	const loader = getLoader(extname(filePath));
 	const { esbuildInstance, ...buildOptions } = options ?? {};
-	const ctx = await (esbuildInstance?.context ?? context)({
+	const codeHash = computeKeyId([code]);
+	const optionsKey = computeKeyId([buildOptions]);
+	const cachedOutput = getCachedTranspilation(filePath, codeHash, optionsKey);
+	if (typeof cachedOutput === "string") return cachedOutput;
+	const moduleResult = await (esbuildInstance?.build ?? build)({
 		stdin: {
 			contents: code,
 			loader,
@@ -83,13 +174,11 @@ const transpileTSToCJS = async (code, filePath, options) => {
 		...getTransformationOptions(filePath),
 		...buildOptions
 	});
-	try {
-		return (await ctx.rebuild()).outputFiles?.[0].text;
-	} finally {
-		await ctx.dispose();
-	}
+	const moduleResultString = moduleResult.outputFiles?.[0]?.text;
+	if (typeof moduleResultString === "string") setCachedTranspilation(filePath, codeHash, optionsKey, moduleResult, moduleResultString);
+	return moduleResultString;
 };
 
 //#endregion
-export { transpileTSToCJS, transpileTSToCJSSync };
+export { clearTranspileCache, transpileTSToCJS, transpileTSToCJSSync };
 //# sourceMappingURL=transpileTSToCJS.mjs.map

package/dist/esm/loadExternalFile/transpileTSToCJS.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"transpileTSToCJS.mjs","names":[],"sources":["../../../src/loadExternalFile/transpileTSToCJS.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { createRequire } from 'node:module';\nimport { dirname, extname, join } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport {\n  type BuildOptions,\n  type BuildResult,\n  buildSync,\n  context,\n} from 'esbuild';\nimport { getPackageJsonPath } from '../utils/getPackageJsonPath';\nimport { getLoader } from './bundleFile';\n\nexport type TranspileOptions = BuildOptions & {\n  /**\n   * Optional custom esbuild instance to use for transpilation.\n   * Useful in environments (e.g. VS Code extensions) where the bundled\n   * esbuild binary may not match the host platform.\n   * When provided, its `buildSync`/`build` methods are used instead of\n   * the ones imported from the `esbuild` package.\n   */\n  esbuildInstance?: typeof import('esbuild');\n};\n\nconst getTsConfigPath = (filePath: string): string | undefined => {\n  const tsconfigPath = join(\n    getPackageJsonPath(dirname(filePath)).baseDir,\n    'tsconfig.json'\n  );\n\n  // Only return the tsconfig path if it exists\n  return existsSync(tsconfigPath) ? tsconfigPath : undefined;\n};\n\nconst getTransformationOptions = (filePath: string): BuildOptions => ({\n  loader: {\n    '.js': 'js',\n    '.jsx': 'jsx',\n    '.mjs': 'js',\n    '.ts': 'ts',\n    '.tsx': 'tsx',\n    '.cjs': 'js',\n    '.json': 'json',\n    '.md': 'text',\n    '.mdx': 'text',\n  },\n  format: 'cjs',\n  target: 'node20',\n  platform: 'node',\n  write: false,\n  packages: 'external',\n  bundle: true,\n  tsconfig: getTsConfigPath(filePath),\n  define: {\n    'import.meta.url': JSON.stringify(pathToFileURL(filePath).href),\n    'import.meta.env': 'process.env',\n  },\n});\n\nexport const transpileTSToCJSSync = (\n  code: string,\n  filePath: string,\n  options?: TranspileOptions\n): string | undefined => {\n  const extension = extname(filePath);\n  const loader = getLoader(extension);\n\n  const { esbuildInstance, ...buildOptions } = options ?? {};\n  const esbuildBuildSync = esbuildInstance?.buildSync ?? buildSync;\n\n  // esbuild's worker thread service calls `new Worker(__filename, …)` on first use.\n  // In Vite's SSR module runner the SSR-optimised chunk is ESM and __filename is\n  // never declared (confirmed: accessing it throws ReferenceError, not undefined).\n  // Because there is no local declaration the bare `__filename` lookup falls\n  // through to globalThis, so we set it there to esbuild's own CJS entry-point –\n  // the exact path esbuild would use if it were loaded in a normal CJS context.\n  //\n  // IMPORTANT: We save/restore the globals so this temporary shim does not leak\n  // to other Vite plugins (e.g. `@vitejs/plugin-react-swc`) that check\n  // `typeof __dirname !== \"undefined\"` to locate their own assets.\n  const g = globalThis as Record<string, unknown>;\n  const hadFilename = typeof g.__filename === 'string';\n  const prevFilename = g.__filename;\n  const prevDirname = g.__dirname;\n\n  if (!hadFilename) {\n    try {\n      const _require = createRequire(import.meta.url);\n      const esbuildEntry = _require.resolve('esbuild');\n      g.__filename = esbuildEntry;\n      g.__dirname = dirname(esbuildEntry);\n    } catch {\n      // Best-effort: if esbuild can't be resolved the caller's catch handles it\n    }\n  }\n\n  let moduleResult: BuildResult;\n  try {\n    moduleResult = esbuildBuildSync({\n      stdin: {\n        contents: code,\n        loader,\n        resolveDir: dirname(filePath), // Add resolveDir to resolve imports relative to the file's location\n        sourcefile: filePath, // Add sourcefile for better error messages\n      },\n      ...getTransformationOptions(filePath),\n      ...buildOptions,\n    });\n  } finally {\n    // Always restore the previous values so the globals don't linger.\n    if (!hadFilename) {\n      if (prevFilename === undefined) {\n        delete g.__filename;\n      } else {\n        g.__filename = prevFilename;\n      }\n      if (prevDirname === undefined) {\n        delete g.__dirname;\n      } else {\n        g.__dirname = prevDirname;\n      }\n    }\n  }\n\n  const moduleResultString = moduleResult!.outputFiles?.[0]?.text;\n\n  return moduleResultString;\n};\n\nexport const transpileTSToCJS = async (\n  code: string,\n  filePath: string,\n  options?: TranspileOptions\n): Promise<string | undefined> => {\n  const extension = extname(filePath);\n  const loader = getLoader(extension);\n\n  const { esbuildInstance, ...buildOptions } = options ?? {};\n  // Use context() + rebuild() + dispose() so esbuild deterministically releases\n  // Go-subprocess resources for each one-shot transpilation, preventing them\n  // from accumulating between rapid HMR-driven file changes.\n  const esbuildContext = esbuildInstance?.context ?? context;\n\n  const ctx = await esbuildContext({\n    stdin: {\n      contents: code,\n      loader,\n      resolveDir: dirname(filePath),\n      sourcefile: filePath,\n    },\n    ...getTransformationOptions(filePath),\n    ...buildOptions,\n  });\n\n  try {\n    const moduleResult = await ctx.rebuild();\n    return moduleResult.outputFiles?.[0].text;\n  } finally {\n    await ctx.dispose();\n  }\n};\n"],"mappings":";;;;;;;;;AAwBA,MAAM,mBAAmB,aAAyC;CAChE,MAAM,eAAe,KACnB,mBAAmB,QAAQ,SAAS,CAAC,CAAC,SACtC,gBACD;AAGD,QAAO,WAAW,aAAa,GAAG,eAAe;;AAGnD,MAAM,4BAA4B,cAAoC;CACpE,QAAQ;EACN,OAAO;EACP,QAAQ;EACR,QAAQ;EACR,OAAO;EACP,QAAQ;EACR,QAAQ;EACR,SAAS;EACT,OAAO;EACP,QAAQ;EACT;CACD,QAAQ;CACR,QAAQ;CACR,UAAU;CACV,OAAO;CACP,UAAU;CACV,QAAQ;CACR,UAAU,gBAAgB,SAAS;CACnC,QAAQ;EACN,mBAAmB,KAAK,UAAU,cAAc,SAAS,CAAC,KAAK;EAC/D,mBAAmB;EACpB;CACF;AAED,MAAa,wBACX,MACA,UACA,YACuB;CAEvB,MAAM,SAAS,UADG,QAAQ,SACQ,CAAC;CAEnC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,WAAW,EAAE;CAC1D,MAAM,mBAAmB,iBAAiB,aAAa;CAYvD,MAAM,IAAI;CACV,MAAM,cAAc,OAAO,EAAE,eAAe;CAC5C,MAAM,eAAe,EAAE;CACvB,MAAM,cAAc,EAAE;AAEtB,KAAI,CAAC,YACH,KAAI;EAEF,MAAM,eADW,cAAc,OAAO,KAAK,IACd,CAAC,QAAQ,UAAU;AAChD,IAAE,aAAa;AACf,IAAE,YAAY,QAAQ,aAAa;SAC7B;CAKV,IAAI;AACJ,KAAI;AACF,iBAAe,iBAAiB;GAC9B,OAAO;IACL,UAAU;IACV;IACA,YAAY,QAAQ,SAAS;IAC7B,YAAY;IACb;GACD,GAAG,yBAAyB,SAAS;GACrC,GAAG;GACJ,CAAC;WACM;AAER,MAAI,CAAC,aAAa;AAChB,OAAI,iBAAiB,OACnB,QAAO,EAAE;OAET,GAAE,aAAa;AAEjB,OAAI,gBAAgB,OAClB,QAAO,EAAE;OAET,GAAE,YAAY;;;AAOpB,QAF2B,aAAc,cAAc,IAAI;;AAK7D,MAAa,mBAAmB,OAC9B,MACA,UACA,YACgC;CAEhC,MAAM,SAAS,UADG,QAAQ,SACQ,CAAC;CAEnC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,WAAW,EAAE;CAM1D,MAAM,MAAM,OAFW,iBAAiB,WAAW,SAElB;EAC/B,OAAO;GACL,UAAU;GACV;GACA,YAAY,QAAQ,SAAS;GAC7B,YAAY;GACb;EACD,GAAG,yBAAyB,SAAS;EACrC,GAAG;EACJ,CAAC;AAEF,KAAI;AAEF,UAAO,MADoB,IAAI,SAAS,EACpB,cAAc,GAAG;WAC7B;AACR,QAAM,IAAI,SAAS"}
+{"version":3,"file":"transpileTSToCJS.mjs","names":[],"sources":["../../../src/loadExternalFile/transpileTSToCJS.ts"],"sourcesContent":["import { existsSync, statSync } from 'node:fs';\nimport { createRequire } from 'node:module';\nimport { dirname, extname, isAbsolute, join, resolve } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport {\n  type BuildOptions,\n  type BuildResult,\n  build,\n  buildSync,\n  type Metafile,\n} from 'esbuild';\nimport { computeKeyId } from '../utils/cacheMemory';\nimport { getPackageJsonPath } from '../utils/getPackageJsonPath';\nimport { getLoader } from './bundleFile';\n\nexport type TranspileOptions = BuildOptions & {\n  /**\n   * Optional custom esbuild instance to use for transpilation.\n   * Useful in environments (e.g. VS Code extensions) where the bundled\n   * esbuild binary may not match the host platform.\n   * When provided, its `buildSync`/`build` methods are used instead of\n   * the ones imported from the `esbuild` package.\n   */\n  esbuildInstance?: typeof import('esbuild');\n};\n\n/**\n * Cache of resolved tsconfig paths keyed by the file's directory.\n * Avoids re-walking to package.json + existsSync on every transpilation.\n */\nconst tsConfigPathCache = new Map<string, string | undefined>();\n\nconst getTsConfigPath = (filePath: string): string | undefined => {\n  const fileDirectory = dirname(filePath);\n\n  if (tsConfigPathCache.has(fileDirectory)) {\n    return tsConfigPathCache.get(fileDirectory);\n  }\n\n  let resolvedPath: string | undefined;\n  try {\n    const tsconfigPath = join(\n      getPackageJsonPath(fileDirectory).baseDir,\n      'tsconfig.json'\n    );\n\n    // Only return the tsconfig path if it exists\n    resolvedPath = existsSync(tsconfigPath) ? tsconfigPath : undefined;\n  } catch {\n    // No package.json found up the tree — transpile without a tsconfig\n    resolvedPath = undefined;\n  }\n\n  tsConfigPathCache.set(fileDirectory, resolvedPath);\n\n  return resolvedPath;\n};\n\nconst getTransformationOptions = (filePath: string): BuildOptions => ({\n  loader: {\n    '.js': 'js',\n    '.jsx': 'jsx',\n    '.mjs': 'js',\n    '.ts': 'ts',\n    '.tsx': 'tsx',\n    '.cjs': 'js',\n    '.json': 'json',\n    '.md': 'text',\n    '.mdx': 'text',\n  },\n  format: 'cjs',\n  target: 'node20',\n  platform: 'node',\n  write: false,\n  packages: 'external',\n  bundle: true,\n  // The metafile lists every bundled input, which the transpile cache uses to\n  // invalidate when an imported file changes (the entry itself is keyed by hash).\n  metafile: true,\n  tsconfig: getTsConfigPath(filePath),\n  define: {\n    'import.meta.url': JSON.stringify(pathToFileURL(filePath).href),\n    'import.meta.env': 'process.env',\n  },\n});\n\n/** Fingerprint of a bundled input file, used to detect changes without re-reading it. */\ntype TranspileCacheInput = {\n  path: string;\n  mtimeMs: number;\n  size: number;\n};\n\ntype TranspileCacheEntry = {\n  /** Hash of the entry file's source code. */\n  codeHash: string;\n  /** Hash of the build options, so different option sets don't collide. */\n  optionsKey: string;\n  /** The transpiled CJS output. */\n  output: string;\n  /** Fingerprints of every non-entry input bundled into the output. */\n  inputs: TranspileCacheInput[];\n};\n\n/**\n * In-memory cache of transpiled outputs keyed by entry file path (one entry\n * per file, so re-transpilations replace rather than accumulate).\n * The entry file is validated by content hash; bundled relative imports are\n * validated by mtime + size so an edited dependency invalidates the cache.\n */\nconst transpileCache = new Map<string, TranspileCacheEntry>();\n\nconst isInputUnchanged = (input: TranspileCacheInput): boolean => {\n  try {\n    const stats = statSync(input.path);\n    return stats.mtimeMs === input.mtimeMs && stats.size === input.size;\n  } catch {\n    // File removed or unreadable — treat as changed\n    return false;\n  }\n};\n\nconst getCachedTranspilation = (\n  filePath: string,\n  codeHash: string,\n  optionsKey: string\n): string | undefined => {\n  const cacheEntry = transpileCache.get(filePath);\n\n  if (!cacheEntry) return undefined;\n  if (cacheEntry.codeHash !== codeHash) return undefined;\n  if (cacheEntry.optionsKey !== optionsKey) return undefined;\n  if (!cacheEntry.inputs.every(isInputUnchanged)) return undefined;\n\n  return cacheEntry.output;\n};\n\n/**\n * Extracts the fingerprints of every bundled input from the esbuild metafile.\n * Returns `undefined` when an input cannot be fingerprinted (the result should\n * then not be cached, as invalidation would be unreliable).\n */\nconst getInputFingerprints = (\n  metafile: Metafile | undefined,\n  entryFilePath: string\n): TranspileCacheInput[] | undefined => {\n  if (!metafile) return undefined;\n\n  const resolvedEntryFilePath = resolve(entryFilePath);\n  const inputs: TranspileCacheInput[] = [];\n\n  for (const inputPath of Object.keys(metafile.inputs)) {\n    // The entry itself is provided via stdin and validated by content hash.\n    // esbuild labels it \"<stdin>\", or with the sourcefile path when set.\n    if (inputPath === '<stdin>') continue;\n    // Virtual modules from plugins (e.g. \"plugin:...\") cannot be fingerprinted\n    if (inputPath.includes(':') && !isAbsolute(inputPath)) return undefined;\n\n    const absoluteInputPath = isAbsolute(inputPath)\n      ? inputPath\n      : resolve(process.cwd(), inputPath);\n\n    if (absoluteInputPath === resolvedEntryFilePath) continue;\n\n    try {\n      const stats = statSync(absoluteInputPath);\n      inputs.push({\n        path: absoluteInputPath,\n        mtimeMs: stats.mtimeMs,\n        size: stats.size,\n      });\n    } catch {\n      return undefined;\n    }\n  }\n\n  return inputs;\n};\n\nconst setCachedTranspilation = (\n  filePath: string,\n  codeHash: string,\n  optionsKey: string,\n  moduleResult: BuildResult,\n  output: string\n): void => {\n  const inputs = getInputFingerprints(moduleResult.metafile, filePath);\n\n  // Without a usable metafile the cache cannot be invalidated reliably — skip\n  if (!inputs) return;\n\n  transpileCache.set(filePath, { codeHash, optionsKey, output, inputs });\n};\n\n/** Clears the in-memory transpilation cache (mainly for tests). */\nexport const clearTranspileCache = (): void => {\n  transpileCache.clear();\n  tsConfigPathCache.clear();\n};\n\nexport const transpileTSToCJSSync = (\n  code: string,\n  filePath: string,\n  options?: TranspileOptions\n): string | undefined => {\n  const extension = extname(filePath);\n  const loader = getLoader(extension);\n\n  const { esbuildInstance, ...buildOptions } = options ?? {};\n\n  const codeHash = computeKeyId([code]);\n  const optionsKey = computeKeyId([buildOptions]);\n\n  const cachedOutput = getCachedTranspilation(filePath, codeHash, optionsKey);\n  if (typeof cachedOutput === 'string') return cachedOutput;\n\n  const esbuildBuildSync = esbuildInstance?.buildSync ?? buildSync;\n\n  // esbuild's worker thread service calls `new Worker(__filename, …)` on first use.\n  // In Vite's SSR module runner the SSR-optimised chunk is ESM and __filename is\n  // never declared (confirmed: accessing it throws ReferenceError, not undefined).\n  // Because there is no local declaration the bare `__filename` lookup falls\n  // through to globalThis, so we set it there to esbuild's own CJS entry-point –\n  // the exact path esbuild would use if it were loaded in a normal CJS context.\n  //\n  // IMPORTANT: We save/restore the globals so this temporary shim does not leak\n  // to other Vite plugins (e.g. `@vitejs/plugin-react-swc`) that check\n  // `typeof __dirname !== \"undefined\"` to locate their own assets.\n  const g = globalThis as Record<string, unknown>;\n  const hadFilename = typeof g.__filename === 'string';\n  const prevFilename = g.__filename;\n  const prevDirname = g.__dirname;\n\n  if (!hadFilename) {\n    try {\n      const _require = createRequire(import.meta.url);\n      const esbuildEntry = _require.resolve('esbuild');\n      g.__filename = esbuildEntry;\n      g.__dirname = dirname(esbuildEntry);\n    } catch {\n      // Best-effort: if esbuild can't be resolved the caller's catch handles it\n    }\n  }\n\n  let moduleResult: BuildResult;\n  try {\n    moduleResult = esbuildBuildSync({\n      stdin: {\n        contents: code,\n        loader,\n        resolveDir: dirname(filePath), // Add resolveDir to resolve imports relative to the file's location\n        sourcefile: filePath, // Add sourcefile for better error messages\n      },\n      ...getTransformationOptions(filePath),\n      ...buildOptions,\n    });\n  } finally {\n    // Always restore the previous values so the globals don't linger.\n    if (!hadFilename) {\n      if (prevFilename === undefined) {\n        // biome-ignore lint/performance/noDelete: the global must be truly absent — assigning undefined would leave the key present and break `typeof __filename` checks in other tools\n        delete g.__filename;\n      } else {\n        g.__filename = prevFilename;\n      }\n      if (prevDirname === undefined) {\n        // biome-ignore lint/performance/noDelete: same as __filename above\n        delete g.__dirname;\n      } else {\n        g.__dirname = prevDirname;\n      }\n    }\n  }\n\n  const moduleResultString = moduleResult!.outputFiles?.[0]?.text;\n\n  if (typeof moduleResultString === 'string') {\n    setCachedTranspilation(\n      filePath,\n      codeHash,\n      optionsKey,\n      moduleResult!,\n      moduleResultString\n    );\n  }\n\n  return moduleResultString;\n};\n\nexport const transpileTSToCJS = async (\n  code: string,\n  filePath: string,\n  options?: TranspileOptions\n): Promise<string | undefined> => {\n  const extension = extname(filePath);\n  const loader = getLoader(extension);\n\n  const { esbuildInstance, ...buildOptions } = options ?? {};\n\n  const codeHash = computeKeyId([code]);\n  const optionsKey = computeKeyId([buildOptions]);\n\n  const cachedOutput = getCachedTranspilation(filePath, codeHash, optionsKey);\n  if (typeof cachedOutput === 'string') return cachedOutput;\n\n  // A one-shot build() releases its Go-side resources on completion and costs a\n  // single service round-trip (context()+rebuild()+dispose() costs three).\n  const esbuildBuild = esbuildInstance?.build ?? build;\n\n  const moduleResult = await esbuildBuild({\n    stdin: {\n      contents: code,\n      loader,\n      resolveDir: dirname(filePath),\n      sourcefile: filePath,\n    },\n    ...getTransformationOptions(filePath),\n    ...buildOptions,\n  });\n\n  const moduleResultString = moduleResult.outputFiles?.[0]?.text;\n\n  if (typeof moduleResultString === 'string') {\n    setCachedTranspilation(\n      filePath,\n      codeHash,\n      optionsKey,\n      moduleResult,\n      moduleResultString\n    );\n  }\n\n  return moduleResultString;\n};\n"],"mappings":";;;;;;;;;;;;;;AA8BA,MAAM,oCAAoB,IAAI,KAAiC;AAE/D,MAAM,mBAAmB,aAAyC;CAChE,MAAM,gBAAgB,QAAQ,SAAS;AAEvC,KAAI,kBAAkB,IAAI,cAAc,CACtC,QAAO,kBAAkB,IAAI,cAAc;CAG7C,IAAI;AACJ,KAAI;EACF,MAAM,eAAe,KACnB,mBAAmB,cAAc,CAAC,SAClC,gBACD;AAGD,iBAAe,WAAW,aAAa,GAAG,eAAe;SACnD;AAEN,iBAAe;;AAGjB,mBAAkB,IAAI,eAAe,aAAa;AAElD,QAAO;;AAGT,MAAM,4BAA4B,cAAoC;CACpE,QAAQ;EACN,OAAO;EACP,QAAQ;EACR,QAAQ;EACR,OAAO;EACP,QAAQ;EACR,QAAQ;EACR,SAAS;EACT,OAAO;EACP,QAAQ;EACT;CACD,QAAQ;CACR,QAAQ;CACR,UAAU;CACV,OAAO;CACP,UAAU;CACV,QAAQ;CAGR,UAAU;CACV,UAAU,gBAAgB,SAAS;CACnC,QAAQ;EACN,mBAAmB,KAAK,UAAU,cAAc,SAAS,CAAC,KAAK;EAC/D,mBAAmB;EACpB;CACF;;;;;;;AA0BD,MAAM,iCAAiB,IAAI,KAAkC;AAE7D,MAAM,oBAAoB,UAAwC;AAChE,KAAI;EACF,MAAM,QAAQ,SAAS,MAAM,KAAK;AAClC,SAAO,MAAM,YAAY,MAAM,WAAW,MAAM,SAAS,MAAM;SACzD;AAEN,SAAO;;;AAIX,MAAM,0BACJ,UACA,UACA,eACuB;CACvB,MAAM,aAAa,eAAe,IAAI,SAAS;AAE/C,KAAI,CAAC,WAAY,QAAO;AACxB,KAAI,WAAW,aAAa,SAAU,QAAO;AAC7C,KAAI,WAAW,eAAe,WAAY,QAAO;AACjD,KAAI,CAAC,WAAW,OAAO,MAAM,iBAAiB,CAAE,QAAO;AAEvD,QAAO,WAAW;;;;;;;AAQpB,MAAM,wBACJ,UACA,kBACsC;AACtC,KAAI,CAAC,SAAU,QAAO;CAEtB,MAAM,wBAAwB,QAAQ,cAAc;CACpD,MAAM,SAAgC,EAAE;AAExC,MAAK,MAAM,aAAa,OAAO,KAAK,SAAS,OAAO,EAAE;AAGpD,MAAI,cAAc,UAAW;AAE7B,MAAI,UAAU,SAAS,IAAI,IAAI,CAAC,WAAW,UAAU,CAAE,QAAO;EAE9D,MAAM,oBAAoB,WAAW,UAAU,GAC3C,YACA,QAAQ,QAAQ,KAAK,EAAE,UAAU;AAErC,MAAI,sBAAsB,sBAAuB;AAEjD,MAAI;GACF,MAAM,QAAQ,SAAS,kBAAkB;AACzC,UAAO,KAAK;IACV,MAAM;IACN,SAAS,MAAM;IACf,MAAM,MAAM;IACb,CAAC;UACI;AACN;;;AAIJ,QAAO;;AAGT,MAAM,0BACJ,UACA,UACA,YACA,cACA,WACS;CACT,MAAM,SAAS,qBAAqB,aAAa,UAAU,SAAS;AAGpE,KAAI,CAAC,OAAQ;AAEb,gBAAe,IAAI,UAAU;EAAE;EAAU;EAAY;EAAQ;EAAQ,CAAC;;;AAIxE,MAAa,4BAAkC;AAC7C,gBAAe,OAAO;AACtB,mBAAkB,OAAO;;AAG3B,MAAa,wBACX,MACA,UACA,YACuB;CAEvB,MAAM,SAAS,UADG,QAAQ,SACQ,CAAC;CAEnC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,WAAW,EAAE;CAE1D,MAAM,WAAW,aAAa,CAAC,KAAK,CAAC;CACrC,MAAM,aAAa,aAAa,CAAC,aAAa,CAAC;CAE/C,MAAM,eAAe,uBAAuB,UAAU,UAAU,WAAW;AAC3E,KAAI,OAAO,iBAAiB,SAAU,QAAO;CAE7C,MAAM,mBAAmB,iBAAiB,aAAa;CAYvD,MAAM,IAAI;CACV,MAAM,cAAc,OAAO,EAAE,eAAe;CAC5C,MAAM,eAAe,EAAE;CACvB,MAAM,cAAc,EAAE;AAEtB,KAAI,CAAC,YACH,KAAI;EAEF,MAAM,eADW,cAAc,OAAO,KAAK,IACd,CAAC,QAAQ,UAAU;AAChD,IAAE,aAAa;AACf,IAAE,YAAY,QAAQ,aAAa;SAC7B;CAKV,IAAI;AACJ,KAAI;AACF,iBAAe,iBAAiB;GAC9B,OAAO;IACL,UAAU;IACV;IACA,YAAY,QAAQ,SAAS;IAC7B,YAAY;IACb;GACD,GAAG,yBAAyB,SAAS;GACrC,GAAG;GACJ,CAAC;WACM;AAER,MAAI,CAAC,aAAa;AAChB,OAAI,iBAAiB,OAEnB,QAAO,EAAE;OAET,GAAE,aAAa;AAEjB,OAAI,gBAAgB,OAElB,QAAO,EAAE;OAET,GAAE,YAAY;;;CAKpB,MAAM,qBAAqB,aAAc,cAAc,IAAI;AAE3D,KAAI,OAAO,uBAAuB,SAChC,wBACE,UACA,UACA,YACA,cACA,mBACD;AAGH,QAAO;;AAGT,MAAa,mBAAmB,OAC9B,MACA,UACA,YACgC;CAEhC,MAAM,SAAS,UADG,QAAQ,SACQ,CAAC;CAEnC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,WAAW,EAAE;CAE1D,MAAM,WAAW,aAAa,CAAC,KAAK,CAAC;CACrC,MAAM,aAAa,aAAa,CAAC,aAAa,CAAC;CAE/C,MAAM,eAAe,uBAAuB,UAAU,UAAU,WAAW;AAC3E,KAAI,OAAO,iBAAiB,SAAU,QAAO;CAM7C,MAAM,eAAe,OAFA,iBAAiB,SAAS,OAEP;EACtC,OAAO;GACL,UAAU;GACV;GACA,YAAY,QAAQ,SAAS;GAC7B,YAAY;GACb;EACD,GAAG,yBAAyB,SAAS;EACrC,GAAG;EACJ,CAAC;CAEF,MAAM,qBAAqB,aAAa,cAAc,IAAI;AAE1D,KAAI,OAAO,uBAAuB,SAChC,wBACE,UACA,UACA,YACA,cACA,mBACD;AAGH,QAAO"}

package/dist/types/configFile/configurationSchema.d.ts

@@ -20,9 +20,9 @@ declare const cookiesAttributesSchema: z.ZodObject<{
   secure: z.ZodOptional<z.ZodBoolean>;
   httpOnly: z.ZodOptional<z.ZodBoolean>;
   sameSite: z.ZodOptional<z.ZodEnum<{
-    none: "none";
     strict: "strict";
     lax: "lax";
+    none: "none";
   }>>;
   expires: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<Date, Date>, z.ZodNumber, z.ZodString]>>;
   maxAge: z.ZodOptional<z.ZodNumber>;
@@ -48,9 +48,9 @@ declare const storageSchema: z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodEnum
   secure: z.ZodOptional<z.ZodBoolean>;
   httpOnly: z.ZodOptional<z.ZodBoolean>;
   sameSite: z.ZodOptional<z.ZodEnum<{
-    none: "none";
     strict: "strict";
     lax: "lax";
+    none: "none";
   }>>;
   expires: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<Date, Date>, z.ZodNumber, z.ZodString]>>;
   maxAge: z.ZodOptional<z.ZodNumber>;
@@ -74,9 +74,9 @@ declare const storageSchema: z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodEnum
   secure: z.ZodOptional<z.ZodBoolean>;
   httpOnly: z.ZodOptional<z.ZodBoolean>;
   sameSite: z.ZodOptional<z.ZodEnum<{
-    none: "none";
     strict: "strict";
     lax: "lax";
+    none: "none";
   }>>;
   expires: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<Date, Date>, z.ZodNumber, z.ZodString]>>;
   maxAge: z.ZodOptional<z.ZodNumber>;
@@ -159,9 +159,9 @@ declare const routingSchema: z.ZodObject<{
     secure: z.ZodOptional<z.ZodBoolean>;
     httpOnly: z.ZodOptional<z.ZodBoolean>;
     sameSite: z.ZodOptional<z.ZodEnum<{
-      none: "none";
       strict: "strict";
       lax: "lax";
+      none: "none";
     }>>;
     expires: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<Date, Date>, z.ZodNumber, z.ZodString]>>;
     maxAge: z.ZodOptional<z.ZodNumber>;
@@ -185,9 +185,9 @@ declare const routingSchema: z.ZodObject<{
     secure: z.ZodOptional<z.ZodBoolean>;
     httpOnly: z.ZodOptional<z.ZodBoolean>;
     sameSite: z.ZodOptional<z.ZodEnum<{
-      none: "none";
       strict: "strict";
       lax: "lax";
+      none: "none";
     }>>;
     expires: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<Date, Date>, z.ZodNumber, z.ZodString]>>;
     maxAge: z.ZodOptional<z.ZodNumber>;
@@ -357,9 +357,9 @@ declare const intlayerConfigSchema: z.ZodObject<{
       secure: z.ZodOptional<z.ZodBoolean>;
       httpOnly: z.ZodOptional<z.ZodBoolean>;
       sameSite: z.ZodOptional<z.ZodEnum<{
-        none: "none";
         strict: "strict";
         lax: "lax";
+        none: "none";
       }>>;
       expires: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<Date, Date>, z.ZodNumber, z.ZodString]>>;
       maxAge: z.ZodOptional<z.ZodNumber>;
@@ -383,9 +383,9 @@ declare const intlayerConfigSchema: z.ZodObject<{
       secure: z.ZodOptional<z.ZodBoolean>;
       httpOnly: z.ZodOptional<z.ZodBoolean>;
       sameSite: z.ZodOptional<z.ZodEnum<{
-        none: "none";
         strict: "strict";
         lax: "lax";
+        none: "none";
       }>>;
       expires: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<Date, Date>, z.ZodNumber, z.ZodString]>>;
       maxAge: z.ZodOptional<z.ZodNumber>;

package/dist/types/loadEnvFile.d.ts

@@ -4,7 +4,7 @@ type LoadEnvFileOptions = {
   envFile?: string;
 };
 declare const getEnvFilePath: (env?: string, envFile?: string) => string | undefined;
-declare const loadEnvFile: (options?: Partial<LoadEnvFileOptions>) => {};
+declare const loadEnvFile: (options?: Partial<LoadEnvFileOptions>) => Record<string, string>;
 //#endregion
 export { LoadEnvFileOptions, getEnvFilePath, loadEnvFile };
 //# sourceMappingURL=loadEnvFile.d.ts.map

package/dist/types/loadEnvFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loadEnvFile.d.ts","names":[],"sources":["../../src/loadEnvFile.ts"],"mappings":";KAKY,kBAAA;EACV,GAAA;EACA,OAAA;AAAA;AAAA,cAGW,cAAA,GACX,GAAA,WACA,OAAA;AAAA,cASW,WAAA,GAAe,OAAA,GAAU,OAAA,CAAQ,kBAAA"}
+{"version":3,"file":"loadEnvFile.d.ts","names":[],"sources":["../../src/loadEnvFile.ts"],"mappings":";KAKY,kBAAA;EACV,GAAA;EACA,OAAA;AAAA;AAAA,cAGW,cAAA,GACX,GAAA,WACA,OAAA;AAAA,cAuCW,WAAA,GACX,OAAA,GAAU,OAAA,CAAQ,kBAAA,MACjB,MAAA"}

package/dist/types/loadExternalFile/index.d.ts

@@ -1,6 +1,6 @@
 import { SandBoxContextOptions, getSandBoxContext, parseFileContent } from "./parseFileContent.js";
-import { TranspileOptions, transpileTSToCJS, transpileTSToCJSSync } from "./transpileTSToCJS.js";
+import { TranspileOptions, clearTranspileCache, transpileTSToCJS, transpileTSToCJSSync } from "./transpileTSToCJS.js";
 import { LoadExternalFileOptions, loadExternalFile, loadExternalFileSync } from "./loadExternalFile.js";
 import { ESBuildPlugin, bundleFile, bundleFileSync, getLoader } from "./bundleFile.js";
 import { bundleJSFile } from "./bundleJSFile.js";
-export { ESBuildPlugin, LoadExternalFileOptions, SandBoxContextOptions, TranspileOptions, bundleFile, bundleFileSync, bundleJSFile, getLoader, getSandBoxContext, loadExternalFile, loadExternalFileSync, parseFileContent, transpileTSToCJS, transpileTSToCJSSync };
+export { ESBuildPlugin, LoadExternalFileOptions, SandBoxContextOptions, TranspileOptions, bundleFile, bundleFileSync, bundleJSFile, clearTranspileCache, getLoader, getSandBoxContext, loadExternalFile, loadExternalFileSync, parseFileContent, transpileTSToCJS, transpileTSToCJSSync };

package/dist/types/loadExternalFile/loadExternalFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loadExternalFile.d.ts","names":[],"sources":["../../../src/loadExternalFile/loadExternalFile.ts"],"mappings":";;;;;KAmBY,uBAAA;EACV,aAAA,GAAgB,cAAA;EAChB,YAAA,GAAe,gBAAA;EACf,QAAA;;;;;;;;EAQA,cAAA,GAAiB,MAAA;AAAA,IACf,qBAAA;;;;;;cAOS,oBAAA,GACX,QAAA,UACA,OAAA,GAAU,uBAAA;;;AAFZ;;;cAyFa,gBAAA,GACX,QAAA,UACA,OAAA,GAAU,uBAAA,KACT,OAAA"}
+{"version":3,"file":"loadExternalFile.d.ts","names":[],"sources":["../../../src/loadExternalFile/loadExternalFile.ts"],"mappings":";;;;;KAmBY,uBAAA;EACV,aAAA,GAAgB,cAAA;EAChB,YAAA,GAAe,gBAAA;EACf,QAAA;;;;;;;;EAQA,cAAA,GAAiB,MAAA;AAAA,IACf,qBAAA;;;;;;cAOS,oBAAA,GACX,QAAA,UACA,OAAA,GAAU,uBAAA;;;AAFZ;;;cAiGa,gBAAA,GACX,QAAA,UACA,OAAA,GAAU,uBAAA,KACT,OAAA"}

package/dist/types/loadExternalFile/parseFileContent.d.ts

@@ -22,6 +22,15 @@ type SandBoxContextOptions = {
    */
   aliases?: Record<string, string>;
 };
+/**
+ * Builds the global context handed to `runInNewContext`.
+ *
+ * SECURITY NOTE: this sandbox exists for global-scope hygiene (fresh
+ * module/exports, controlled env), NOT for containment. It exposes the real
+ * project `require`, a copy of `process`, and `fetch` — code executed here has
+ * full host privileges. Only ever run trusted, build-time project files
+ * (same trust model as `vite.config.ts`).
+ */
 declare const getSandBoxContext: (options?: SandBoxContextOptions) => Context;
 declare const parseFileContent: <T>(fileContentString: string, options?: SandBoxContextOptions) => T | undefined;
 //#endregion

package/dist/types/loadExternalFile/parseFileContent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parseFileContent.d.ts","names":[],"sources":["../../../src/loadExternalFile/parseFileContent.ts"],"mappings":";;;;KAKY,qBAAA;EACV,aAAA,GAAgB,kBAAA;EAChB,cAAA,GAAiB,MAAA,CAAO,OAAA;EACxB,iBAAA,GAAoB,MAAA;;;;;;;;EAQpB,KAAA,GAAQ,MAAA;EAVR;;;;;;EAiBA,OAAA,GAAU,MAAA;AAAA;AAAA,cA6BC,iBAAA,GAAqB,OAAA,GAAU,qBAAA,KAAwB,OAAA;AAAA,cAgGvD,gBAAA,MACX,iBAAA,UACA,OAAA,GAAU,qBAAA,KACT,CAAA"}
+{"version":3,"file":"parseFileContent.d.ts","names":[],"sources":["../../../src/loadExternalFile/parseFileContent.ts"],"mappings":";;;;KAKY,qBAAA;EACV,aAAA,GAAgB,kBAAA;EAChB,cAAA,GAAiB,MAAA,CAAO,OAAA;EACxB,iBAAA,GAAoB,MAAA;;;;;;;;EAQpB,KAAA,GAAQ,MAAA;EAVR;;;;;;EAiBA,OAAA,GAAU,MAAA;AAAA;;;;;;AA2FZ;;;;cAAa,iBAAA,GAAqB,OAAA,GAAU,qBAAA,KAAwB,OAAA;AAAA,cAuEvD,gBAAA,MACX,iBAAA,UACA,OAAA,GAAU,qBAAA,KACT,CAAA"}

package/dist/types/loadExternalFile/transpileTSToCJS.d.ts

@@ -12,8 +12,10 @@ type TranspileOptions = BuildOptions & {
    */
   esbuildInstance?: typeof _$esbuild;
 };
+/** Clears the in-memory transpilation cache (mainly for tests). */
+declare const clearTranspileCache: () => void;
 declare const transpileTSToCJSSync: (code: string, filePath: string, options?: TranspileOptions) => string | undefined;
 declare const transpileTSToCJS: (code: string, filePath: string, options?: TranspileOptions) => Promise<string | undefined>;
 //#endregion
-export { TranspileOptions, transpileTSToCJS, transpileTSToCJSSync };
+export { TranspileOptions, clearTranspileCache, transpileTSToCJS, transpileTSToCJSSync };
 //# sourceMappingURL=transpileTSToCJS.d.ts.map

package/dist/types/loadExternalFile/transpileTSToCJS.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transpileTSToCJS.d.ts","names":[],"sources":["../../../src/loadExternalFile/transpileTSToCJS.ts"],"mappings":";;;;KAaY,gBAAA,GAAmB,YAAA;;;AAA/B;;;;;EAQE,eAAA,UARyC,SAAA;AAAA;AAAA,cA8C9B,oBAAA,GACX,IAAA,UACA,QAAA,UACA,OAAA,GAAU,gBAAA;AAAA,cAmEC,gBAAA,GACX,IAAA,UACA,QAAA,UACA,OAAA,GAAU,gBAAA,KACT,OAAA"}
+{"version":3,"file":"transpileTSToCJS.d.ts","names":[],"sources":["../../../src/loadExternalFile/transpileTSToCJS.ts"],"mappings":";;;;KAeY,gBAAA,GAAmB,YAAA;;;AAA/B;;;;;EAQE,eAAA,UARyC,SAAA;AAAA;;cAoL9B,mBAAA;AAAA,cAKA,oBAAA,GACX,IAAA,UACA,QAAA,UACA,OAAA,GAAU,gBAAA;AAAA,cAsFC,gBAAA,GACX,IAAA,UACA,QAAA,UACA,OAAA,GAAU,gBAAA,KACT,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/config",
-  "version": "9.0.0-canary.12",
+  "version": "9.0.0-canary.15",
   "private": false,
   "description": "Retrieve Intlayer configurations and manage environment variables for both server-side and client-side environments.",
   "keywords": [
@@ -165,7 +165,7 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/types": "9.0.0-canary.12",
+    "@intlayer/types": "9.0.0-canary.15",
     "defu": "6.1.7",
     "dotenv": "17.4.2",
     "esbuild": "0.28.1",