@intlayer/config 9.6.0 → 9.7.0

package/dist/cjs/configFile/editorServerOverride.cjs

@@ -0,0 +1,62 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+//#region src/configFile/editorServerOverride.ts
+/**
+* Port of the `intlayer-editor` server, set by `intlayer-editor start --with`
+* on the application it starts. Turns the editor on for that application and
+* points `editor.editorURL` at the server, without touching the configuration
+* file.
+*/
+const EDITOR_SERVER_PORT_ENV_VAR = "INTLAYER_EDITOR_SERVER_PORT";
+/** Hostnames `editor.editorURL` may name the local editor server with. */
+const LOCAL_HOSTNAMES = /* @__PURE__ */ new Set([
+	"localhost",
+	"127.0.0.1",
+	"0.0.0.0",
+	"[::1]"
+]);
+/**
+* `editor.editorURL` adapted to the port the local editor server listens on,
+* which differs from `editor.port` when that one is taken.
+*
+* @returns The adapted URL, or `undefined` when the URL already targets that
+* port or names another host (e.g. a proxy) that cannot be adapted.
+*/
+const getEditorURLForPort = (editorURL, port) => {
+	const localEditorURL = `http://localhost:${port}`;
+	if (!editorURL) return localEditorURL;
+	let parsedEditorURL;
+	try {
+		parsedEditorURL = new URL(editorURL);
+	} catch {
+		return localEditorURL;
+	}
+	if (!LOCAL_HOSTNAMES.has(parsedEditorURL.hostname)) return void 0;
+	if ((parsedEditorURL.port || (parsedEditorURL.protocol === "https:" ? "443" : "80")) === String(port)) return void 0;
+	parsedEditorURL.port = String(port);
+	return editorURL.endsWith("/") ? parsedEditorURL.href : parsedEditorURL.href.replace(/\/$/, "");
+};
+/**
+* Applies {@link EDITOR_SERVER_PORT_ENV_VAR}: enables the editor and adapts
+* its URL and port to the running editor server.
+*
+* @returns The configuration unchanged when the variable is not set.
+*/
+const applyEditorServerOverride = (configuration, environment = process.env) => {
+	const editorServerPort = Number(environment[EDITOR_SERVER_PORT_ENV_VAR]);
+	if (!Number.isInteger(editorServerPort) || editorServerPort <= 0) return configuration;
+	return {
+		...configuration,
+		editor: {
+			...configuration.editor,
+			enabled: true,
+			port: editorServerPort,
+			editorURL: getEditorURLForPort(configuration.editor.editorURL, editorServerPort) ?? configuration.editor.editorURL
+		}
+	};
+};
+
+//#endregion
+exports.EDITOR_SERVER_PORT_ENV_VAR = EDITOR_SERVER_PORT_ENV_VAR;
+exports.applyEditorServerOverride = applyEditorServerOverride;
+exports.getEditorURLForPort = getEditorURLForPort;
+//# sourceMappingURL=editorServerOverride.cjs.map

package/dist/cjs/configFile/editorServerOverride.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorServerOverride.cjs","names":[],"sources":["../../../src/configFile/editorServerOverride.ts"],"sourcesContent":["import type { IntlayerConfig } from '@intlayer/types/config';\n\n/**\n * Port of the `intlayer-editor` server, set by `intlayer-editor start --with`\n * on the application it starts. Turns the editor on for that application and\n * points `editor.editorURL` at the server, without touching the configuration\n * file.\n */\nexport const EDITOR_SERVER_PORT_ENV_VAR = 'INTLAYER_EDITOR_SERVER_PORT';\n\n/** Hostnames `editor.editorURL` may name the local editor server with. */\nconst LOCAL_HOSTNAMES = new Set(['localhost', '127.0.0.1', '0.0.0.0', '[::1]']);\n\n/**\n * `editor.editorURL` adapted to the port the local editor server listens on,\n * which differs from `editor.port` when that one is taken.\n *\n * @returns The adapted URL, or `undefined` when the URL already targets that\n * port or names another host (e.g. a proxy) that cannot be adapted.\n */\nexport const getEditorURLForPort = (\n  editorURL: string | undefined,\n  port: number\n): string | undefined => {\n  const localEditorURL = `http://localhost:${port}`;\n\n  if (!editorURL) return localEditorURL;\n\n  let parsedEditorURL: URL;\n\n  try {\n    parsedEditorURL = new URL(editorURL);\n  } catch {\n    return localEditorURL;\n  }\n\n  if (!LOCAL_HOSTNAMES.has(parsedEditorURL.hostname)) return undefined;\n\n  const editorPort =\n    parsedEditorURL.port ||\n    (parsedEditorURL.protocol === 'https:' ? '443' : '80');\n\n  if (editorPort === String(port)) return undefined;\n\n  parsedEditorURL.port = String(port);\n\n  // `URL` adds a trailing slash to a bare origin\n  return editorURL.endsWith('/')\n    ? parsedEditorURL.href\n    : parsedEditorURL.href.replace(/\\/$/, '');\n};\n\n/**\n * Applies {@link EDITOR_SERVER_PORT_ENV_VAR}: enables the editor and adapts\n * its URL and port to the running editor server.\n *\n * @returns The configuration unchanged when the variable is not set.\n */\nexport const applyEditorServerOverride = (\n  configuration: IntlayerConfig,\n  environment: NodeJS.ProcessEnv = process.env\n): IntlayerConfig => {\n  const editorServerPort = Number(environment[EDITOR_SERVER_PORT_ENV_VAR]);\n\n  if (!Number.isInteger(editorServerPort) || editorServerPort <= 0) {\n    return configuration;\n  }\n\n  return {\n    ...configuration,\n    editor: {\n      ...configuration.editor,\n      enabled: true,\n      port: editorServerPort,\n      editorURL:\n        getEditorURLForPort(configuration.editor.editorURL, editorServerPort) ??\n        configuration.editor.editorURL,\n    },\n  };\n};\n"],"mappings":";;;;;;;;AAQA,MAAa,6BAA6B;;AAG1C,MAAM,kCAAkB,IAAI,IAAI;CAAC;CAAa;CAAa;CAAW;AAAO,CAAC;;;;;;;;AAS9E,MAAa,uBACX,WACA,SACuB;CACvB,MAAM,iBAAiB,oBAAoB;CAE3C,IAAI,CAAC,WAAW,OAAO;CAEvB,IAAI;CAEJ,IAAI;EACF,kBAAkB,IAAI,IAAI,SAAS;CACrC,QAAQ;EACN,OAAO;CACT;CAEA,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,QAAQ,GAAG,OAAO;CAM3D,KAHE,gBAAgB,SACf,gBAAgB,aAAa,WAAW,QAAQ,WAEhC,OAAO,IAAI,GAAG,OAAO;CAExC,gBAAgB,OAAO,OAAO,IAAI;CAGlC,OAAO,UAAU,SAAS,GAAG,IACzB,gBAAgB,OAChB,gBAAgB,KAAK,QAAQ,OAAO,EAAE;AAC5C;;;;;;;AAQA,MAAa,6BACX,eACA,cAAiC,QAAQ,QACtB;CACnB,MAAM,mBAAmB,OAAO,YAAY,2BAA2B;CAEvE,IAAI,CAAC,OAAO,UAAU,gBAAgB,KAAK,oBAAoB,GAC7D,OAAO;CAGT,OAAO;EACL,GAAG;EACH,QAAQ;GACN,GAAG,cAAc;GACjB,SAAS;GACT,MAAM;GACN,WACE,oBAAoB,cAAc,OAAO,WAAW,gBAAgB,KACpE,cAAc,OAAO;EACzB;CACF;AACF"}

package/dist/cjs/configFile/getConfiguration.cjs

@@ -2,12 +2,24 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_utils_cacheMemory = require('../utils/cacheMemory.cjs');
 const require_utils_getPackageJsonPath = require('../utils/getPackageJsonPath.cjs');
 const require_configFile_buildConfigurationFields = require('./buildConfigurationFields.cjs');
+const require_configFile_editorServerOverride = require('./editorServerOverride.cjs');
 const require_configFile_loadConfigurationFile = require('./loadConfigurationFile.cjs');
 const require_configFile_searchConfigurationFile = require('./searchConfigurationFile.cjs');
 let defu = require("defu");
 
 //#region src/configFile/getConfiguration.ts
 /**
+* Applies the editor server override outside the cache: the editor server
+* sets it once listening, after its configuration was first read.
+*/
+const withEditorServerOverride = (result) => {
+	const configuration = require_configFile_editorServerOverride.applyEditorServerOverride(result.configuration);
+	return configuration === result.configuration ? result : {
+		...result,
+		configuration
+	};
+};
+/**
 * Get the configuration for the intlayer by reading the configuration file (e.g. intlayer.config.js)
 */
 const getConfigurationAndFilePath = (options) => {
@@ -23,7 +35,7 @@ const getConfigurationAndFilePath = (options) => {
 		};
 	}
 	const cachedConfiguration = require_utils_cacheMemory.cacheMemory.get(options);
-	if (cachedConfiguration) return cachedConfiguration;
+	if (cachedConfiguration) return withEditorServerOverride(cachedConfiguration);
 	const { configurationFilePath, numCustomConfiguration } = require_configFile_searchConfigurationFile.searchConfigurationFile(baseDir);
 	let storedConfiguration;
 	let customConfiguration;
@@ -52,12 +64,12 @@ const getConfigurationAndFilePath = (options) => {
 		numCustomConfiguration,
 		configurationFilePath
 	});
-	return {
+	return withEditorServerOverride({
 		configuration,
 		customConfiguration,
 		numCustomConfiguration,
 		configurationFilePath
-	};
+	});
 };
 /**
 * Get the configuration for the intlayer by reading the configuration file (e.g. intlayer.config.js)

package/dist/cjs/configFile/getConfiguration.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"getConfiguration.cjs","names":["getPackageJsonPath","buildConfigurationFields","cacheMemory","searchConfigurationFile","loadConfigurationFile"],"sources":["../../../src/configFile/getConfiguration.ts"],"sourcesContent":["import type {\n  CustomIntlayerConfig,\n  IntlayerConfig,\n  LogFunctions,\n} from '@intlayer/types/config';\nimport { defu } from 'defu';\nimport type { LoadExternalFileOptions } from '../loadExternalFile/loadExternalFile';\nimport type { SandBoxContextOptions } from '../loadExternalFile/parseFileContent';\nimport { cacheMemory } from '../utils/cacheMemory';\nimport { getPackageJsonPath } from '../utils/getPackageJsonPath';\nimport { buildConfigurationFields } from './buildConfigurationFields';\nimport { loadConfigurationFile } from './loadConfigurationFile';\nimport { searchConfigurationFile } from './searchConfigurationFile';\n\nexport type GetConfigurationOptions = {\n  baseDir?: string;\n  override?: CustomIntlayerConfig;\n  // Dotenv options\n  env?: string;\n  envFile?: string;\n  // Log functions\n  logFunctions?: LogFunctions;\n  // Require function\n  require?: NodeJS.Require;\n  // cache\n  cache?: boolean;\n  // Build options for TypeScript transpilation (e.g. custom esbuild instance)\n  buildOptions?: LoadExternalFileOptions['buildOptions'];\n} & Omit<SandBoxContextOptions, 'projectRequire'>;\n\nexport type GetConfigurationAndFilePathResult = {\n  configuration: IntlayerConfig;\n  customConfiguration: CustomIntlayerConfig | undefined;\n  numCustomConfiguration: number;\n  configurationFilePath: string | undefined;\n};\n\n/**\n * Get the configuration for the intlayer by reading the configuration file (e.g. intlayer.config.js)\n */\nexport const getConfigurationAndFilePath = (\n  options?: GetConfigurationOptions\n): GetConfigurationAndFilePathResult => {\n  let baseDir: string | undefined;\n\n  try {\n    // Can fail in some environments (e.g. MCP server, VScode extension)\n    baseDir = options?.baseDir ?? getPackageJsonPath().baseDir;\n  } catch (_err) {\n    // Return default config if the package.json is not found\n    return {\n      configuration: buildConfigurationFields(\n        {},\n        options?.baseDir,\n        options?.logFunctions\n      ),\n      customConfiguration: undefined,\n      numCustomConfiguration: 0,\n      configurationFilePath: undefined,\n    };\n  }\n\n  const cachedConfiguration =\n    cacheMemory.get<GetConfigurationAndFilePathResult>(options);\n\n  if (cachedConfiguration) return cachedConfiguration;\n\n  // Search for configuration files\n  const { configurationFilePath, numCustomConfiguration } =\n    searchConfigurationFile(baseDir);\n\n  let storedConfiguration: IntlayerConfig;\n  let customConfiguration: CustomIntlayerConfig | undefined;\n\n  if (configurationFilePath) {\n    // Load the custom configuration\n    customConfiguration = loadConfigurationFile(configurationFilePath, {\n      projectRequire: options?.require,\n      // Dotenv options\n      envVarOptions: {\n        env: options?.env,\n        envFile: options?.envFile,\n      },\n      // Sandbox context additional variables\n      additionalEnvVars: options?.additionalEnvVars,\n      aliases: options?.aliases,\n      // Build options for TypeScript transpilation (e.g. custom esbuild instance)\n      buildOptions: options?.buildOptions,\n    });\n\n    // Save the configuration to avoid reading the file again\n    storedConfiguration = buildConfigurationFields(\n      customConfiguration,\n      options?.baseDir,\n      options?.logFunctions\n    );\n  } else {\n    // No configuration file found, use default configuration\n    storedConfiguration = buildConfigurationFields(\n      {},\n      options?.baseDir,\n      options?.logFunctions\n    );\n  }\n\n  // Log warning if multiple configuration files are found\n  const projectRequireConfig: CustomIntlayerConfig = options?.require\n    ? {\n        build: {\n          require: options?.require,\n          cache: options?.cache,\n        },\n      }\n    : {};\n\n  const configWithProjectRequire = defu(\n    projectRequireConfig,\n    storedConfiguration\n  ) as IntlayerConfig;\n\n  const configuration = defu(\n    options?.override ?? {},\n    configWithProjectRequire\n  ) as IntlayerConfig;\n\n  cacheMemory.set(options, {\n    configuration,\n    customConfiguration,\n    numCustomConfiguration,\n    configurationFilePath,\n  });\n\n  return {\n    configuration,\n    customConfiguration,\n    numCustomConfiguration,\n    configurationFilePath,\n  };\n};\n\n/**\n * Get the configuration for the intlayer by reading the configuration file (e.g. intlayer.config.js)\n */\nexport const getConfiguration = (\n  options?: GetConfigurationOptions\n): IntlayerConfig => getConfigurationAndFilePath(options).configuration;\n"],"mappings":";;;;;;;;;;;;AAwCA,MAAa,+BACX,YACsC;CACtC,IAAI;CAEJ,IAAI;EAEF,UAAU,SAAS,WAAWA,oDAAmB,CAAC,CAAC;CACrD,SAAS,MAAM;EAEb,OAAO;GACL,eAAeC,qEACb,CAAC,GACD,SAAS,SACT,SAAS,YACX;GACA,qBAAqB;GACrB,wBAAwB;GACxB,uBAAuB;EACzB;CACF;CAEA,MAAM,sBACJC,sCAAY,IAAuC,OAAO;CAE5D,IAAI,qBAAqB,OAAO;CAGhC,MAAM,EAAE,uBAAuB,2BAC7BC,mEAAwB,OAAO;CAEjC,IAAI;CACJ,IAAI;CAEJ,IAAI,uBAAuB;EAEzB,sBAAsBC,+DAAsB,uBAAuB;GACjE,gBAAgB,SAAS;GAEzB,eAAe;IACb,KAAK,SAAS;IACd,SAAS,SAAS;GACpB;GAEA,mBAAmB,SAAS;GAC5B,SAAS,SAAS;GAElB,cAAc,SAAS;EACzB,CAAC;EAGD,sBAAsBH,qEACpB,qBACA,SAAS,SACT,SAAS,YACX;CACF,OAEE,sBAAsBA,qEACpB,CAAC,GACD,SAAS,SACT,SAAS,YACX;CAIF,MAAM,uBAA6C,SAAS,UACxD,EACE,OAAO;EACL,SAAS,SAAS;EAClB,OAAO,SAAS;CAClB,EACF,IACA,CAAC;CAEL,MAAM,+BAA2B,WAC/B,sBACA,mBACF;CAEA,MAAM,oBAAgB,WACpB,SAAS,YAAY,CAAC,GACtB,wBACF;CAEA,sCAAY,IAAI,SAAS;EACvB;EACA;EACA;EACA;CACF,CAAC;CAED,OAAO;EACL;EACA;EACA;EACA;CACF;AACF;;;;AAKA,MAAa,oBACX,YACmB,4BAA4B,OAAO,CAAC,CAAC"}
+{"version":3,"file":"getConfiguration.cjs","names":["applyEditorServerOverride","getPackageJsonPath","buildConfigurationFields","cacheMemory","searchConfigurationFile","loadConfigurationFile"],"sources":["../../../src/configFile/getConfiguration.ts"],"sourcesContent":["import type {\n  CustomIntlayerConfig,\n  IntlayerConfig,\n  LogFunctions,\n} from '@intlayer/types/config';\nimport { defu } from 'defu';\nimport type { LoadExternalFileOptions } from '../loadExternalFile/loadExternalFile';\nimport type { SandBoxContextOptions } from '../loadExternalFile/parseFileContent';\nimport { cacheMemory } from '../utils/cacheMemory';\nimport { getPackageJsonPath } from '../utils/getPackageJsonPath';\nimport { buildConfigurationFields } from './buildConfigurationFields';\nimport { applyEditorServerOverride } from './editorServerOverride';\nimport { loadConfigurationFile } from './loadConfigurationFile';\nimport { searchConfigurationFile } from './searchConfigurationFile';\n\nexport type GetConfigurationOptions = {\n  baseDir?: string;\n  override?: CustomIntlayerConfig;\n  // Dotenv options\n  env?: string;\n  envFile?: string;\n  // Log functions\n  logFunctions?: LogFunctions;\n  // Require function\n  require?: NodeJS.Require;\n  // cache\n  cache?: boolean;\n  // Build options for TypeScript transpilation (e.g. custom esbuild instance)\n  buildOptions?: LoadExternalFileOptions['buildOptions'];\n} & Omit<SandBoxContextOptions, 'projectRequire'>;\n\nexport type GetConfigurationAndFilePathResult = {\n  configuration: IntlayerConfig;\n  customConfiguration: CustomIntlayerConfig | undefined;\n  numCustomConfiguration: number;\n  configurationFilePath: string | undefined;\n};\n\n/**\n * Applies the editor server override outside the cache: the editor server\n * sets it once listening, after its configuration was first read.\n */\nconst withEditorServerOverride = (\n  result: GetConfigurationAndFilePathResult\n): GetConfigurationAndFilePathResult => {\n  const configuration = applyEditorServerOverride(result.configuration);\n\n  return configuration === result.configuration\n    ? result\n    : { ...result, configuration };\n};\n\n/**\n * Get the configuration for the intlayer by reading the configuration file (e.g. intlayer.config.js)\n */\nexport const getConfigurationAndFilePath = (\n  options?: GetConfigurationOptions\n): GetConfigurationAndFilePathResult => {\n  let baseDir: string | undefined;\n\n  try {\n    // Can fail in some environments (e.g. MCP server, VScode extension)\n    baseDir = options?.baseDir ?? getPackageJsonPath().baseDir;\n  } catch (_err) {\n    // Return default config if the package.json is not found\n    return {\n      configuration: buildConfigurationFields(\n        {},\n        options?.baseDir,\n        options?.logFunctions\n      ),\n      customConfiguration: undefined,\n      numCustomConfiguration: 0,\n      configurationFilePath: undefined,\n    };\n  }\n\n  const cachedConfiguration =\n    cacheMemory.get<GetConfigurationAndFilePathResult>(options);\n\n  if (cachedConfiguration) return withEditorServerOverride(cachedConfiguration);\n\n  // Search for configuration files\n  const { configurationFilePath, numCustomConfiguration } =\n    searchConfigurationFile(baseDir);\n\n  let storedConfiguration: IntlayerConfig;\n  let customConfiguration: CustomIntlayerConfig | undefined;\n\n  if (configurationFilePath) {\n    // Load the custom configuration\n    customConfiguration = loadConfigurationFile(configurationFilePath, {\n      projectRequire: options?.require,\n      // Dotenv options\n      envVarOptions: {\n        env: options?.env,\n        envFile: options?.envFile,\n      },\n      // Sandbox context additional variables\n      additionalEnvVars: options?.additionalEnvVars,\n      aliases: options?.aliases,\n      // Build options for TypeScript transpilation (e.g. custom esbuild instance)\n      buildOptions: options?.buildOptions,\n    });\n\n    // Save the configuration to avoid reading the file again\n    storedConfiguration = buildConfigurationFields(\n      customConfiguration,\n      options?.baseDir,\n      options?.logFunctions\n    );\n  } else {\n    // No configuration file found, use default configuration\n    storedConfiguration = buildConfigurationFields(\n      {},\n      options?.baseDir,\n      options?.logFunctions\n    );\n  }\n\n  // Log warning if multiple configuration files are found\n  const projectRequireConfig: CustomIntlayerConfig = options?.require\n    ? {\n        build: {\n          require: options?.require,\n          cache: options?.cache,\n        },\n      }\n    : {};\n\n  const configWithProjectRequire = defu(\n    projectRequireConfig,\n    storedConfiguration\n  ) as IntlayerConfig;\n\n  const configuration = defu(\n    options?.override ?? {},\n    configWithProjectRequire\n  ) as IntlayerConfig;\n\n  cacheMemory.set(options, {\n    configuration,\n    customConfiguration,\n    numCustomConfiguration,\n    configurationFilePath,\n  });\n\n  return withEditorServerOverride({\n    configuration,\n    customConfiguration,\n    numCustomConfiguration,\n    configurationFilePath,\n  });\n};\n\n/**\n * Get the configuration for the intlayer by reading the configuration file (e.g. intlayer.config.js)\n */\nexport const getConfiguration = (\n  options?: GetConfigurationOptions\n): IntlayerConfig => getConfigurationAndFilePath(options).configuration;\n"],"mappings":";;;;;;;;;;;;;;AA0CA,MAAM,4BACJ,WACsC;CACtC,MAAM,gBAAgBA,kEAA0B,OAAO,aAAa;CAEpE,OAAO,kBAAkB,OAAO,gBAC5B,SACA;EAAE,GAAG;EAAQ;CAAc;AACjC;;;;AAKA,MAAa,+BACX,YACsC;CACtC,IAAI;CAEJ,IAAI;EAEF,UAAU,SAAS,WAAWC,oDAAmB,CAAC,CAAC;CACrD,SAAS,MAAM;EAEb,OAAO;GACL,eAAeC,qEACb,CAAC,GACD,SAAS,SACT,SAAS,YACX;GACA,qBAAqB;GACrB,wBAAwB;GACxB,uBAAuB;EACzB;CACF;CAEA,MAAM,sBACJC,sCAAY,IAAuC,OAAO;CAE5D,IAAI,qBAAqB,OAAO,yBAAyB,mBAAmB;CAG5E,MAAM,EAAE,uBAAuB,2BAC7BC,mEAAwB,OAAO;CAEjC,IAAI;CACJ,IAAI;CAEJ,IAAI,uBAAuB;EAEzB,sBAAsBC,+DAAsB,uBAAuB;GACjE,gBAAgB,SAAS;GAEzB,eAAe;IACb,KAAK,SAAS;IACd,SAAS,SAAS;GACpB;GAEA,mBAAmB,SAAS;GAC5B,SAAS,SAAS;GAElB,cAAc,SAAS;EACzB,CAAC;EAGD,sBAAsBH,qEACpB,qBACA,SAAS,SACT,SAAS,YACX;CACF,OAEE,sBAAsBA,qEACpB,CAAC,GACD,SAAS,SACT,SAAS,YACX;CAIF,MAAM,uBAA6C,SAAS,UACxD,EACE,OAAO;EACL,SAAS,SAAS;EAClB,OAAO,SAAS;CAClB,EACF,IACA,CAAC;CAEL,MAAM,+BAA2B,WAC/B,sBACA,mBACF;CAEA,MAAM,oBAAgB,WACpB,SAAS,YAAY,CAAC,GACtB,wBACF;CAEA,sCAAY,IAAI,SAAS;EACvB;EACA;EACA;EACA;CACF,CAAC;CAED,OAAO,yBAAyB;EAC9B;EACA;EACA;EACA;CACF,CAAC;AACH;;;;AAKA,MAAa,oBACX,YACmB,4BAA4B,OAAO,CAAC,CAAC"}

package/dist/cjs/configFile/index.cjs

@@ -2,11 +2,14 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_configFile_buildBrowserConfiguration = require('./buildBrowserConfiguration.cjs');
 const require_configFile_configurationSchema = require('./configurationSchema.cjs');
 const require_configFile_buildConfigurationFields = require('./buildConfigurationFields.cjs');
+const require_configFile_editorServerOverride = require('./editorServerOverride.cjs');
 const require_configFile_searchConfigurationFile = require('./searchConfigurationFile.cjs');
 const require_configFile_getConfiguration = require('./getConfiguration.cjs');
 
+exports.EDITOR_SERVER_PORT_ENV_VAR = require_configFile_editorServerOverride.EDITOR_SERVER_PORT_ENV_VAR;
 exports.aiSchema = require_configFile_configurationSchema.aiSchema;
 exports.analyticsSchema = require_configFile_configurationSchema.analyticsSchema;
+exports.applyEditorServerOverride = require_configFile_editorServerOverride.applyEditorServerOverride;
 exports.buildAnalyticsFields = require_configFile_buildBrowserConfiguration.buildAnalyticsFields;
 exports.buildBrowserConfiguration = require_configFile_buildBrowserConfiguration.buildBrowserConfiguration;
 exports.buildConfigurationFields = require_configFile_buildConfigurationFields.buildConfigurationFields;
@@ -24,6 +27,7 @@ exports.editorSchema = require_configFile_configurationSchema.editorSchema;
 exports.extractBrowserConfiguration = require_configFile_buildBrowserConfiguration.extractBrowserConfiguration;
 exports.getConfiguration = require_configFile_getConfiguration.getConfiguration;
 exports.getConfigurationAndFilePath = require_configFile_getConfiguration.getConfigurationAndFilePath;
+exports.getEditorURLForPort = require_configFile_editorServerOverride.getEditorURLForPort;
 exports.internationalizationSchema = require_configFile_configurationSchema.internationalizationSchema;
 exports.intlayerConfigSchema = require_configFile_configurationSchema.intlayerConfigSchema;
 exports.intlayerConfigSchemaParseContext = require_configFile_configurationSchema.intlayerConfigSchemaParseContext;

package/dist/cjs/node.cjs

@@ -2,11 +2,14 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_configFile_buildBrowserConfiguration = require('./configFile/buildBrowserConfiguration.cjs');
 const require_configFile_configurationSchema = require('./configFile/configurationSchema.cjs');
 const require_configFile_buildConfigurationFields = require('./configFile/buildConfigurationFields.cjs');
+const require_configFile_editorServerOverride = require('./configFile/editorServerOverride.cjs');
 const require_configFile_searchConfigurationFile = require('./configFile/searchConfigurationFile.cjs');
 const require_configFile_getConfiguration = require('./configFile/getConfiguration.cjs');
 
+exports.EDITOR_SERVER_PORT_ENV_VAR = require_configFile_editorServerOverride.EDITOR_SERVER_PORT_ENV_VAR;
 exports.aiSchema = require_configFile_configurationSchema.aiSchema;
 exports.analyticsSchema = require_configFile_configurationSchema.analyticsSchema;
+exports.applyEditorServerOverride = require_configFile_editorServerOverride.applyEditorServerOverride;
 exports.buildAnalyticsFields = require_configFile_buildBrowserConfiguration.buildAnalyticsFields;
 exports.buildBrowserConfiguration = require_configFile_buildBrowserConfiguration.buildBrowserConfiguration;
 exports.buildConfigurationFields = require_configFile_buildConfigurationFields.buildConfigurationFields;
@@ -24,6 +27,7 @@ exports.editorSchema = require_configFile_configurationSchema.editorSchema;
 exports.extractBrowserConfiguration = require_configFile_buildBrowserConfiguration.extractBrowserConfiguration;
 exports.getConfiguration = require_configFile_getConfiguration.getConfiguration;
 exports.getConfigurationAndFilePath = require_configFile_getConfiguration.getConfigurationAndFilePath;
+exports.getEditorURLForPort = require_configFile_editorServerOverride.getEditorURLForPort;
 exports.internationalizationSchema = require_configFile_configurationSchema.internationalizationSchema;
 exports.intlayerConfigSchema = require_configFile_configurationSchema.intlayerConfigSchema;
 exports.intlayerConfigSchemaParseContext = require_configFile_configurationSchema.intlayerConfigSchemaParseContext;

package/dist/esm/configFile/editorServerOverride.mjs

@@ -0,0 +1,59 @@
+//#region src/configFile/editorServerOverride.ts
+/**
+* Port of the `intlayer-editor` server, set by `intlayer-editor start --with`
+* on the application it starts. Turns the editor on for that application and
+* points `editor.editorURL` at the server, without touching the configuration
+* file.
+*/
+const EDITOR_SERVER_PORT_ENV_VAR = "INTLAYER_EDITOR_SERVER_PORT";
+/** Hostnames `editor.editorURL` may name the local editor server with. */
+const LOCAL_HOSTNAMES = /* @__PURE__ */ new Set([
+	"localhost",
+	"127.0.0.1",
+	"0.0.0.0",
+	"[::1]"
+]);
+/**
+* `editor.editorURL` adapted to the port the local editor server listens on,
+* which differs from `editor.port` when that one is taken.
+*
+* @returns The adapted URL, or `undefined` when the URL already targets that
+* port or names another host (e.g. a proxy) that cannot be adapted.
+*/
+const getEditorURLForPort = (editorURL, port) => {
+	const localEditorURL = `http://localhost:${port}`;
+	if (!editorURL) return localEditorURL;
+	let parsedEditorURL;
+	try {
+		parsedEditorURL = new URL(editorURL);
+	} catch {
+		return localEditorURL;
+	}
+	if (!LOCAL_HOSTNAMES.has(parsedEditorURL.hostname)) return void 0;
+	if ((parsedEditorURL.port || (parsedEditorURL.protocol === "https:" ? "443" : "80")) === String(port)) return void 0;
+	parsedEditorURL.port = String(port);
+	return editorURL.endsWith("/") ? parsedEditorURL.href : parsedEditorURL.href.replace(/\/$/, "");
+};
+/**
+* Applies {@link EDITOR_SERVER_PORT_ENV_VAR}: enables the editor and adapts
+* its URL and port to the running editor server.
+*
+* @returns The configuration unchanged when the variable is not set.
+*/
+const applyEditorServerOverride = (configuration, environment = process.env) => {
+	const editorServerPort = Number(environment[EDITOR_SERVER_PORT_ENV_VAR]);
+	if (!Number.isInteger(editorServerPort) || editorServerPort <= 0) return configuration;
+	return {
+		...configuration,
+		editor: {
+			...configuration.editor,
+			enabled: true,
+			port: editorServerPort,
+			editorURL: getEditorURLForPort(configuration.editor.editorURL, editorServerPort) ?? configuration.editor.editorURL
+		}
+	};
+};
+
+//#endregion
+export { EDITOR_SERVER_PORT_ENV_VAR, applyEditorServerOverride, getEditorURLForPort };
+//# sourceMappingURL=editorServerOverride.mjs.map

package/dist/esm/configFile/editorServerOverride.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorServerOverride.mjs","names":[],"sources":["../../../src/configFile/editorServerOverride.ts"],"sourcesContent":["import type { IntlayerConfig } from '@intlayer/types/config';\n\n/**\n * Port of the `intlayer-editor` server, set by `intlayer-editor start --with`\n * on the application it starts. Turns the editor on for that application and\n * points `editor.editorURL` at the server, without touching the configuration\n * file.\n */\nexport const EDITOR_SERVER_PORT_ENV_VAR = 'INTLAYER_EDITOR_SERVER_PORT';\n\n/** Hostnames `editor.editorURL` may name the local editor server with. */\nconst LOCAL_HOSTNAMES = new Set(['localhost', '127.0.0.1', '0.0.0.0', '[::1]']);\n\n/**\n * `editor.editorURL` adapted to the port the local editor server listens on,\n * which differs from `editor.port` when that one is taken.\n *\n * @returns The adapted URL, or `undefined` when the URL already targets that\n * port or names another host (e.g. a proxy) that cannot be adapted.\n */\nexport const getEditorURLForPort = (\n  editorURL: string | undefined,\n  port: number\n): string | undefined => {\n  const localEditorURL = `http://localhost:${port}`;\n\n  if (!editorURL) return localEditorURL;\n\n  let parsedEditorURL: URL;\n\n  try {\n    parsedEditorURL = new URL(editorURL);\n  } catch {\n    return localEditorURL;\n  }\n\n  if (!LOCAL_HOSTNAMES.has(parsedEditorURL.hostname)) return undefined;\n\n  const editorPort =\n    parsedEditorURL.port ||\n    (parsedEditorURL.protocol === 'https:' ? '443' : '80');\n\n  if (editorPort === String(port)) return undefined;\n\n  parsedEditorURL.port = String(port);\n\n  // `URL` adds a trailing slash to a bare origin\n  return editorURL.endsWith('/')\n    ? parsedEditorURL.href\n    : parsedEditorURL.href.replace(/\\/$/, '');\n};\n\n/**\n * Applies {@link EDITOR_SERVER_PORT_ENV_VAR}: enables the editor and adapts\n * its URL and port to the running editor server.\n *\n * @returns The configuration unchanged when the variable is not set.\n */\nexport const applyEditorServerOverride = (\n  configuration: IntlayerConfig,\n  environment: NodeJS.ProcessEnv = process.env\n): IntlayerConfig => {\n  const editorServerPort = Number(environment[EDITOR_SERVER_PORT_ENV_VAR]);\n\n  if (!Number.isInteger(editorServerPort) || editorServerPort <= 0) {\n    return configuration;\n  }\n\n  return {\n    ...configuration,\n    editor: {\n      ...configuration.editor,\n      enabled: true,\n      port: editorServerPort,\n      editorURL:\n        getEditorURLForPort(configuration.editor.editorURL, editorServerPort) ??\n        configuration.editor.editorURL,\n    },\n  };\n};\n"],"mappings":";;;;;;;AAQA,MAAa,6BAA6B;;AAG1C,MAAM,kCAAkB,IAAI,IAAI;CAAC;CAAa;CAAa;CAAW;AAAO,CAAC;;;;;;;;AAS9E,MAAa,uBACX,WACA,SACuB;CACvB,MAAM,iBAAiB,oBAAoB;CAE3C,IAAI,CAAC,WAAW,OAAO;CAEvB,IAAI;CAEJ,IAAI;EACF,kBAAkB,IAAI,IAAI,SAAS;CACrC,QAAQ;EACN,OAAO;CACT;CAEA,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,QAAQ,GAAG,OAAO;CAM3D,KAHE,gBAAgB,SACf,gBAAgB,aAAa,WAAW,QAAQ,WAEhC,OAAO,IAAI,GAAG,OAAO;CAExC,gBAAgB,OAAO,OAAO,IAAI;CAGlC,OAAO,UAAU,SAAS,GAAG,IACzB,gBAAgB,OAChB,gBAAgB,KAAK,QAAQ,OAAO,EAAE;AAC5C;;;;;;;AAQA,MAAa,6BACX,eACA,cAAiC,QAAQ,QACtB;CACnB,MAAM,mBAAmB,OAAO,YAAY,2BAA2B;CAEvE,IAAI,CAAC,OAAO,UAAU,gBAAgB,KAAK,oBAAoB,GAC7D,OAAO;CAGT,OAAO;EACL,GAAG;EACH,QAAQ;GACN,GAAG,cAAc;GACjB,SAAS;GACT,MAAM;GACN,WACE,oBAAoB,cAAc,OAAO,WAAW,gBAAgB,KACpE,cAAc,OAAO;EACzB;CACF;AACF"}

package/dist/esm/configFile/getConfiguration.mjs

@@ -1,12 +1,24 @@
 import { cacheMemory } from "../utils/cacheMemory.mjs";
 import { getPackageJsonPath } from "../utils/getPackageJsonPath.mjs";
 import { buildConfigurationFields } from "./buildConfigurationFields.mjs";
+import { applyEditorServerOverride } from "./editorServerOverride.mjs";
 import { loadConfigurationFile } from "./loadConfigurationFile.mjs";
 import { searchConfigurationFile } from "./searchConfigurationFile.mjs";
 import { defu } from "defu";
 
 //#region src/configFile/getConfiguration.ts
 /**
+* Applies the editor server override outside the cache: the editor server
+* sets it once listening, after its configuration was first read.
+*/
+const withEditorServerOverride = (result) => {
+	const configuration = applyEditorServerOverride(result.configuration);
+	return configuration === result.configuration ? result : {
+		...result,
+		configuration
+	};
+};
+/**
 * Get the configuration for the intlayer by reading the configuration file (e.g. intlayer.config.js)
 */
 const getConfigurationAndFilePath = (options) => {
@@ -22,7 +34,7 @@ const getConfigurationAndFilePath = (options) => {
 		};
 	}
 	const cachedConfiguration = cacheMemory.get(options);
-	if (cachedConfiguration) return cachedConfiguration;
+	if (cachedConfiguration) return withEditorServerOverride(cachedConfiguration);
 	const { configurationFilePath, numCustomConfiguration } = searchConfigurationFile(baseDir);
 	let storedConfiguration;
 	let customConfiguration;
@@ -51,12 +63,12 @@ const getConfigurationAndFilePath = (options) => {
 		numCustomConfiguration,
 		configurationFilePath
 	});
-	return {
+	return withEditorServerOverride({
 		configuration,
 		customConfiguration,
 		numCustomConfiguration,
 		configurationFilePath
-	};
+	});
 };
 /**
 * Get the configuration for the intlayer by reading the configuration file (e.g. intlayer.config.js)

package/dist/esm/configFile/getConfiguration.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"getConfiguration.mjs","names":[],"sources":["../../../src/configFile/getConfiguration.ts"],"sourcesContent":["import type {\n  CustomIntlayerConfig,\n  IntlayerConfig,\n  LogFunctions,\n} from '@intlayer/types/config';\nimport { defu } from 'defu';\nimport type { LoadExternalFileOptions } from '../loadExternalFile/loadExternalFile';\nimport type { SandBoxContextOptions } from '../loadExternalFile/parseFileContent';\nimport { cacheMemory } from '../utils/cacheMemory';\nimport { getPackageJsonPath } from '../utils/getPackageJsonPath';\nimport { buildConfigurationFields } from './buildConfigurationFields';\nimport { loadConfigurationFile } from './loadConfigurationFile';\nimport { searchConfigurationFile } from './searchConfigurationFile';\n\nexport type GetConfigurationOptions = {\n  baseDir?: string;\n  override?: CustomIntlayerConfig;\n  // Dotenv options\n  env?: string;\n  envFile?: string;\n  // Log functions\n  logFunctions?: LogFunctions;\n  // Require function\n  require?: NodeJS.Require;\n  // cache\n  cache?: boolean;\n  // Build options for TypeScript transpilation (e.g. custom esbuild instance)\n  buildOptions?: LoadExternalFileOptions['buildOptions'];\n} & Omit<SandBoxContextOptions, 'projectRequire'>;\n\nexport type GetConfigurationAndFilePathResult = {\n  configuration: IntlayerConfig;\n  customConfiguration: CustomIntlayerConfig | undefined;\n  numCustomConfiguration: number;\n  configurationFilePath: string | undefined;\n};\n\n/**\n * Get the configuration for the intlayer by reading the configuration file (e.g. intlayer.config.js)\n */\nexport const getConfigurationAndFilePath = (\n  options?: GetConfigurationOptions\n): GetConfigurationAndFilePathResult => {\n  let baseDir: string | undefined;\n\n  try {\n    // Can fail in some environments (e.g. MCP server, VScode extension)\n    baseDir = options?.baseDir ?? getPackageJsonPath().baseDir;\n  } catch (_err) {\n    // Return default config if the package.json is not found\n    return {\n      configuration: buildConfigurationFields(\n        {},\n        options?.baseDir,\n        options?.logFunctions\n      ),\n      customConfiguration: undefined,\n      numCustomConfiguration: 0,\n      configurationFilePath: undefined,\n    };\n  }\n\n  const cachedConfiguration =\n    cacheMemory.get<GetConfigurationAndFilePathResult>(options);\n\n  if (cachedConfiguration) return cachedConfiguration;\n\n  // Search for configuration files\n  const { configurationFilePath, numCustomConfiguration } =\n    searchConfigurationFile(baseDir);\n\n  let storedConfiguration: IntlayerConfig;\n  let customConfiguration: CustomIntlayerConfig | undefined;\n\n  if (configurationFilePath) {\n    // Load the custom configuration\n    customConfiguration = loadConfigurationFile(configurationFilePath, {\n      projectRequire: options?.require,\n      // Dotenv options\n      envVarOptions: {\n        env: options?.env,\n        envFile: options?.envFile,\n      },\n      // Sandbox context additional variables\n      additionalEnvVars: options?.additionalEnvVars,\n      aliases: options?.aliases,\n      // Build options for TypeScript transpilation (e.g. custom esbuild instance)\n      buildOptions: options?.buildOptions,\n    });\n\n    // Save the configuration to avoid reading the file again\n    storedConfiguration = buildConfigurationFields(\n      customConfiguration,\n      options?.baseDir,\n      options?.logFunctions\n    );\n  } else {\n    // No configuration file found, use default configuration\n    storedConfiguration = buildConfigurationFields(\n      {},\n      options?.baseDir,\n      options?.logFunctions\n    );\n  }\n\n  // Log warning if multiple configuration files are found\n  const projectRequireConfig: CustomIntlayerConfig = options?.require\n    ? {\n        build: {\n          require: options?.require,\n          cache: options?.cache,\n        },\n      }\n    : {};\n\n  const configWithProjectRequire = defu(\n    projectRequireConfig,\n    storedConfiguration\n  ) as IntlayerConfig;\n\n  const configuration = defu(\n    options?.override ?? {},\n    configWithProjectRequire\n  ) as IntlayerConfig;\n\n  cacheMemory.set(options, {\n    configuration,\n    customConfiguration,\n    numCustomConfiguration,\n    configurationFilePath,\n  });\n\n  return {\n    configuration,\n    customConfiguration,\n    numCustomConfiguration,\n    configurationFilePath,\n  };\n};\n\n/**\n * Get the configuration for the intlayer by reading the configuration file (e.g. intlayer.config.js)\n */\nexport const getConfiguration = (\n  options?: GetConfigurationOptions\n): IntlayerConfig => getConfigurationAndFilePath(options).configuration;\n"],"mappings":";;;;;;;;;;;AAwCA,MAAa,+BACX,YACsC;CACtC,IAAI;CAEJ,IAAI;EAEF,UAAU,SAAS,WAAW,mBAAmB,CAAC,CAAC;CACrD,SAAS,MAAM;EAEb,OAAO;GACL,eAAe,yBACb,CAAC,GACD,SAAS,SACT,SAAS,YACX;GACA,qBAAqB;GACrB,wBAAwB;GACxB,uBAAuB;EACzB;CACF;CAEA,MAAM,sBACJ,YAAY,IAAuC,OAAO;CAE5D,IAAI,qBAAqB,OAAO;CAGhC,MAAM,EAAE,uBAAuB,2BAC7B,wBAAwB,OAAO;CAEjC,IAAI;CACJ,IAAI;CAEJ,IAAI,uBAAuB;EAEzB,sBAAsB,sBAAsB,uBAAuB;GACjE,gBAAgB,SAAS;GAEzB,eAAe;IACb,KAAK,SAAS;IACd,SAAS,SAAS;GACpB;GAEA,mBAAmB,SAAS;GAC5B,SAAS,SAAS;GAElB,cAAc,SAAS;EACzB,CAAC;EAGD,sBAAsB,yBACpB,qBACA,SAAS,SACT,SAAS,YACX;CACF,OAEE,sBAAsB,yBACpB,CAAC,GACD,SAAS,SACT,SAAS,YACX;CAIF,MAAM,uBAA6C,SAAS,UACxD,EACE,OAAO;EACL,SAAS,SAAS;EAClB,OAAO,SAAS;CAClB,EACF,IACA,CAAC;CAEL,MAAM,2BAA2B,KAC/B,sBACA,mBACF;CAEA,MAAM,gBAAgB,KACpB,SAAS,YAAY,CAAC,GACtB,wBACF;CAEA,YAAY,IAAI,SAAS;EACvB;EACA;EACA;EACA;CACF,CAAC;CAED,OAAO;EACL;EACA;EACA;EACA;CACF;AACF;;;;AAKA,MAAa,oBACX,YACmB,4BAA4B,OAAO,CAAC,CAAC"}
+{"version":3,"file":"getConfiguration.mjs","names":[],"sources":["../../../src/configFile/getConfiguration.ts"],"sourcesContent":["import type {\n  CustomIntlayerConfig,\n  IntlayerConfig,\n  LogFunctions,\n} from '@intlayer/types/config';\nimport { defu } from 'defu';\nimport type { LoadExternalFileOptions } from '../loadExternalFile/loadExternalFile';\nimport type { SandBoxContextOptions } from '../loadExternalFile/parseFileContent';\nimport { cacheMemory } from '../utils/cacheMemory';\nimport { getPackageJsonPath } from '../utils/getPackageJsonPath';\nimport { buildConfigurationFields } from './buildConfigurationFields';\nimport { applyEditorServerOverride } from './editorServerOverride';\nimport { loadConfigurationFile } from './loadConfigurationFile';\nimport { searchConfigurationFile } from './searchConfigurationFile';\n\nexport type GetConfigurationOptions = {\n  baseDir?: string;\n  override?: CustomIntlayerConfig;\n  // Dotenv options\n  env?: string;\n  envFile?: string;\n  // Log functions\n  logFunctions?: LogFunctions;\n  // Require function\n  require?: NodeJS.Require;\n  // cache\n  cache?: boolean;\n  // Build options for TypeScript transpilation (e.g. custom esbuild instance)\n  buildOptions?: LoadExternalFileOptions['buildOptions'];\n} & Omit<SandBoxContextOptions, 'projectRequire'>;\n\nexport type GetConfigurationAndFilePathResult = {\n  configuration: IntlayerConfig;\n  customConfiguration: CustomIntlayerConfig | undefined;\n  numCustomConfiguration: number;\n  configurationFilePath: string | undefined;\n};\n\n/**\n * Applies the editor server override outside the cache: the editor server\n * sets it once listening, after its configuration was first read.\n */\nconst withEditorServerOverride = (\n  result: GetConfigurationAndFilePathResult\n): GetConfigurationAndFilePathResult => {\n  const configuration = applyEditorServerOverride(result.configuration);\n\n  return configuration === result.configuration\n    ? result\n    : { ...result, configuration };\n};\n\n/**\n * Get the configuration for the intlayer by reading the configuration file (e.g. intlayer.config.js)\n */\nexport const getConfigurationAndFilePath = (\n  options?: GetConfigurationOptions\n): GetConfigurationAndFilePathResult => {\n  let baseDir: string | undefined;\n\n  try {\n    // Can fail in some environments (e.g. MCP server, VScode extension)\n    baseDir = options?.baseDir ?? getPackageJsonPath().baseDir;\n  } catch (_err) {\n    // Return default config if the package.json is not found\n    return {\n      configuration: buildConfigurationFields(\n        {},\n        options?.baseDir,\n        options?.logFunctions\n      ),\n      customConfiguration: undefined,\n      numCustomConfiguration: 0,\n      configurationFilePath: undefined,\n    };\n  }\n\n  const cachedConfiguration =\n    cacheMemory.get<GetConfigurationAndFilePathResult>(options);\n\n  if (cachedConfiguration) return withEditorServerOverride(cachedConfiguration);\n\n  // Search for configuration files\n  const { configurationFilePath, numCustomConfiguration } =\n    searchConfigurationFile(baseDir);\n\n  let storedConfiguration: IntlayerConfig;\n  let customConfiguration: CustomIntlayerConfig | undefined;\n\n  if (configurationFilePath) {\n    // Load the custom configuration\n    customConfiguration = loadConfigurationFile(configurationFilePath, {\n      projectRequire: options?.require,\n      // Dotenv options\n      envVarOptions: {\n        env: options?.env,\n        envFile: options?.envFile,\n      },\n      // Sandbox context additional variables\n      additionalEnvVars: options?.additionalEnvVars,\n      aliases: options?.aliases,\n      // Build options for TypeScript transpilation (e.g. custom esbuild instance)\n      buildOptions: options?.buildOptions,\n    });\n\n    // Save the configuration to avoid reading the file again\n    storedConfiguration = buildConfigurationFields(\n      customConfiguration,\n      options?.baseDir,\n      options?.logFunctions\n    );\n  } else {\n    // No configuration file found, use default configuration\n    storedConfiguration = buildConfigurationFields(\n      {},\n      options?.baseDir,\n      options?.logFunctions\n    );\n  }\n\n  // Log warning if multiple configuration files are found\n  const projectRequireConfig: CustomIntlayerConfig = options?.require\n    ? {\n        build: {\n          require: options?.require,\n          cache: options?.cache,\n        },\n      }\n    : {};\n\n  const configWithProjectRequire = defu(\n    projectRequireConfig,\n    storedConfiguration\n  ) as IntlayerConfig;\n\n  const configuration = defu(\n    options?.override ?? {},\n    configWithProjectRequire\n  ) as IntlayerConfig;\n\n  cacheMemory.set(options, {\n    configuration,\n    customConfiguration,\n    numCustomConfiguration,\n    configurationFilePath,\n  });\n\n  return withEditorServerOverride({\n    configuration,\n    customConfiguration,\n    numCustomConfiguration,\n    configurationFilePath,\n  });\n};\n\n/**\n * Get the configuration for the intlayer by reading the configuration file (e.g. intlayer.config.js)\n */\nexport const getConfiguration = (\n  options?: GetConfigurationOptions\n): IntlayerConfig => getConfigurationAndFilePath(options).configuration;\n"],"mappings":";;;;;;;;;;;;;AA0CA,MAAM,4BACJ,WACsC;CACtC,MAAM,gBAAgB,0BAA0B,OAAO,aAAa;CAEpE,OAAO,kBAAkB,OAAO,gBAC5B,SACA;EAAE,GAAG;EAAQ;CAAc;AACjC;;;;AAKA,MAAa,+BACX,YACsC;CACtC,IAAI;CAEJ,IAAI;EAEF,UAAU,SAAS,WAAW,mBAAmB,CAAC,CAAC;CACrD,SAAS,MAAM;EAEb,OAAO;GACL,eAAe,yBACb,CAAC,GACD,SAAS,SACT,SAAS,YACX;GACA,qBAAqB;GACrB,wBAAwB;GACxB,uBAAuB;EACzB;CACF;CAEA,MAAM,sBACJ,YAAY,IAAuC,OAAO;CAE5D,IAAI,qBAAqB,OAAO,yBAAyB,mBAAmB;CAG5E,MAAM,EAAE,uBAAuB,2BAC7B,wBAAwB,OAAO;CAEjC,IAAI;CACJ,IAAI;CAEJ,IAAI,uBAAuB;EAEzB,sBAAsB,sBAAsB,uBAAuB;GACjE,gBAAgB,SAAS;GAEzB,eAAe;IACb,KAAK,SAAS;IACd,SAAS,SAAS;GACpB;GAEA,mBAAmB,SAAS;GAC5B,SAAS,SAAS;GAElB,cAAc,SAAS;EACzB,CAAC;EAGD,sBAAsB,yBACpB,qBACA,SAAS,SACT,SAAS,YACX;CACF,OAEE,sBAAsB,yBACpB,CAAC,GACD,SAAS,SACT,SAAS,YACX;CAIF,MAAM,uBAA6C,SAAS,UACxD,EACE,OAAO;EACL,SAAS,SAAS;EAClB,OAAO,SAAS;CAClB,EACF,IACA,CAAC;CAEL,MAAM,2BAA2B,KAC/B,sBACA,mBACF;CAEA,MAAM,gBAAgB,KACpB,SAAS,YAAY,CAAC,GACtB,wBACF;CAEA,YAAY,IAAI,SAAS;EACvB;EACA;EACA;EACA;CACF,CAAC;CAED,OAAO,yBAAyB;EAC9B;EACA;EACA;EACA;CACF,CAAC;AACH;;;;AAKA,MAAa,oBACX,YACmB,4BAA4B,OAAO,CAAC,CAAC"}

package/dist/esm/configFile/index.mjs

@@ -1,7 +1,8 @@
 import { buildAnalyticsFields, buildBrowserConfiguration, buildEditorFields, buildInternationalizationFields, buildLogFields, buildRoutingFields, extractBrowserConfiguration } from "./buildBrowserConfiguration.mjs";
 import { aiSchema, analyticsSchema, buildSchema, compilerSchema, contentSchema, cookiesAttributesSchema, dictionarySchema, editorSchema, internationalizationSchema, intlayerConfigSchema, intlayerConfigSchemaParseContext, logSchema, rewriteObjectSchema, rewriteRuleSchema, rewriteRulesSchema, routingSchema, storageAttributesSchema, storageSchema, systemSchema } from "./configurationSchema.mjs";
 import { buildConfigurationFields } from "./buildConfigurationFields.mjs";
+import { EDITOR_SERVER_PORT_ENV_VAR, applyEditorServerOverride, getEditorURLForPort } from "./editorServerOverride.mjs";
 import { configurationFilesCandidates, searchConfigurationFile } from "./searchConfigurationFile.mjs";
 import { getConfiguration, getConfigurationAndFilePath } from "./getConfiguration.mjs";
 
-export { aiSchema, analyticsSchema, buildAnalyticsFields, buildBrowserConfiguration, buildConfigurationFields, buildEditorFields, buildInternationalizationFields, buildLogFields, buildRoutingFields, buildSchema, compilerSchema, configurationFilesCandidates, contentSchema, cookiesAttributesSchema, dictionarySchema, editorSchema, extractBrowserConfiguration, getConfiguration, getConfigurationAndFilePath, internationalizationSchema, intlayerConfigSchema, intlayerConfigSchemaParseContext, logSchema, rewriteObjectSchema, rewriteRuleSchema, rewriteRulesSchema, routingSchema, searchConfigurationFile, storageAttributesSchema, storageSchema, systemSchema };
+export { EDITOR_SERVER_PORT_ENV_VAR, aiSchema, analyticsSchema, applyEditorServerOverride, buildAnalyticsFields, buildBrowserConfiguration, buildConfigurationFields, buildEditorFields, buildInternationalizationFields, buildLogFields, buildRoutingFields, buildSchema, compilerSchema, configurationFilesCandidates, contentSchema, cookiesAttributesSchema, dictionarySchema, editorSchema, extractBrowserConfiguration, getConfiguration, getConfigurationAndFilePath, getEditorURLForPort, internationalizationSchema, intlayerConfigSchema, intlayerConfigSchemaParseContext, logSchema, rewriteObjectSchema, rewriteRuleSchema, rewriteRulesSchema, routingSchema, searchConfigurationFile, storageAttributesSchema, storageSchema, systemSchema };

package/dist/esm/node.mjs

@@ -1,7 +1,8 @@
 import { buildAnalyticsFields, buildBrowserConfiguration, buildEditorFields, buildInternationalizationFields, buildLogFields, buildRoutingFields, extractBrowserConfiguration } from "./configFile/buildBrowserConfiguration.mjs";
 import { aiSchema, analyticsSchema, buildSchema, compilerSchema, contentSchema, cookiesAttributesSchema, dictionarySchema, editorSchema, internationalizationSchema, intlayerConfigSchema, intlayerConfigSchemaParseContext, logSchema, rewriteObjectSchema, rewriteRuleSchema, rewriteRulesSchema, routingSchema, storageAttributesSchema, storageSchema, systemSchema } from "./configFile/configurationSchema.mjs";
 import { buildConfigurationFields } from "./configFile/buildConfigurationFields.mjs";
+import { EDITOR_SERVER_PORT_ENV_VAR, applyEditorServerOverride, getEditorURLForPort } from "./configFile/editorServerOverride.mjs";
 import { configurationFilesCandidates, searchConfigurationFile } from "./configFile/searchConfigurationFile.mjs";
 import { getConfiguration, getConfigurationAndFilePath } from "./configFile/getConfiguration.mjs";
 
-export { aiSchema, analyticsSchema, buildAnalyticsFields, buildBrowserConfiguration, buildConfigurationFields, buildEditorFields, buildInternationalizationFields, buildLogFields, buildRoutingFields, buildSchema, compilerSchema, configurationFilesCandidates, contentSchema, cookiesAttributesSchema, dictionarySchema, editorSchema, extractBrowserConfiguration, getConfiguration, getConfigurationAndFilePath, internationalizationSchema, intlayerConfigSchema, intlayerConfigSchemaParseContext, logSchema, rewriteObjectSchema, rewriteRuleSchema, rewriteRulesSchema, routingSchema, searchConfigurationFile, storageAttributesSchema, storageSchema, systemSchema };
+export { EDITOR_SERVER_PORT_ENV_VAR, aiSchema, analyticsSchema, applyEditorServerOverride, buildAnalyticsFields, buildBrowserConfiguration, buildConfigurationFields, buildEditorFields, buildInternationalizationFields, buildLogFields, buildRoutingFields, buildSchema, compilerSchema, configurationFilesCandidates, contentSchema, cookiesAttributesSchema, dictionarySchema, editorSchema, extractBrowserConfiguration, getConfiguration, getConfigurationAndFilePath, getEditorURLForPort, internationalizationSchema, intlayerConfigSchema, intlayerConfigSchemaParseContext, logSchema, rewriteObjectSchema, rewriteRuleSchema, rewriteRulesSchema, routingSchema, searchConfigurationFile, storageAttributesSchema, storageSchema, systemSchema };

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

@@ -0,0 +1,26 @@
+import { IntlayerConfig } from "@intlayer/types/config";
+//#region src/configFile/editorServerOverride.d.ts
+/**
+ * Port of the `intlayer-editor` server, set by `intlayer-editor start --with`
+ * on the application it starts. Turns the editor on for that application and
+ * points `editor.editorURL` at the server, without touching the configuration
+ * file.
+ */
+export declare const EDITOR_SERVER_PORT_ENV_VAR = "INTLAYER_EDITOR_SERVER_PORT";
+/**
+ * `editor.editorURL` adapted to the port the local editor server listens on,
+ * which differs from `editor.port` when that one is taken.
+ *
+ * @returns The adapted URL, or `undefined` when the URL already targets that
+ * port or names another host (e.g. a proxy) that cannot be adapted.
+ */
+export declare const getEditorURLForPort: (editorURL: string | undefined, port: number) => string | undefined;
+/**
+ * Applies {@link EDITOR_SERVER_PORT_ENV_VAR}: enables the editor and adapts
+ * its URL and port to the running editor server.
+ *
+ * @returns The configuration unchanged when the variable is not set.
+ */
+export declare const applyEditorServerOverride: (configuration: IntlayerConfig, environment?: NodeJS.ProcessEnv) => IntlayerConfig;
+//#endregion
+//# sourceMappingURL=editorServerOverride.d.ts.map

package/dist/types/configFile/editorServerOverride.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorServerOverride.d.ts","names":[],"sources":["../../../src/configFile/editorServerOverride.ts"],"mappings":";;;;;;;;qBAQa;;;;;;;;qBAYA,sBAAmB,+BACD;;;;;;;qBAqClB,4BAAyB,eACrB,gBAAc,cAChB,OAAO,eACnB"}

package/dist/types/configFile/getConfiguration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getConfiguration.d.ts","names":[],"sources":["../../../src/configFile/getConfiguration.ts"],"mappings":";;;;YAcY;EACV;EACA,WAAW;EAEX;EACA;EAEA,eAAe;EAEf,UAAU,OAAO;EAEjB;EAEA,eAAe;IACb,KAAK;YAEG;EACV,eAAe;EACf,qBAAqB;EACrB;EACA;;;;;qBAMW,8BAA2B,UAC5B,4BACT;;;;qBAqGU,mBAAgB,UACjB,4BACT"}
+{"version":3,"file":"getConfiguration.d.ts","names":[],"sources":["../../../src/configFile/getConfiguration.ts"],"mappings":";;;;YAeY;EACV;EACA,WAAW;EAEX;EACA;EAEA,eAAe;EAEf,UAAU,OAAO;EAEjB;EAEA,eAAe;IACb,KAAK;YAEG;EACV,eAAe;EACf,qBAAqB;EACrB;EACA;;;;;qBAoBW,8BAA2B,UAC5B,4BACT;;;;qBAqGU,mBAAgB,UACjB,4BACT"}

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

@@ -2,5 +2,6 @@ import { GetConfigurationAndFilePathResult, GetConfigurationOptions, getConfigur
 import { BrowserIntlayerConfig, buildAnalyticsFields, buildBrowserConfiguration, buildEditorFields, buildInternationalizationFields, buildLogFields, buildRoutingFields, extractBrowserConfiguration } from "./buildBrowserConfiguration.js";
 import { buildConfigurationFields } from "./buildConfigurationFields.js";
 import { aiSchema, analyticsSchema, buildSchema, compilerSchema, contentSchema, cookiesAttributesSchema, dictionarySchema, editorSchema, internationalizationSchema, intlayerConfigSchema, intlayerConfigSchemaParseContext, logSchema, rewriteObjectSchema, rewriteRuleSchema, rewriteRulesSchema, routingSchema, storageAttributesSchema, storageSchema, systemSchema } from "./configurationSchema.js";
+import { EDITOR_SERVER_PORT_ENV_VAR, applyEditorServerOverride, getEditorURLForPort } from "./editorServerOverride.js";
 import { configurationFilesCandidates, searchConfigurationFile } from "./searchConfigurationFile.js";
-export { type BrowserIntlayerConfig, GetConfigurationAndFilePathResult, GetConfigurationOptions, aiSchema, analyticsSchema, buildAnalyticsFields, buildBrowserConfiguration, buildConfigurationFields, buildEditorFields, buildInternationalizationFields, buildLogFields, buildRoutingFields, buildSchema, compilerSchema, configurationFilesCandidates, contentSchema, cookiesAttributesSchema, dictionarySchema, editorSchema, extractBrowserConfiguration, getConfiguration, getConfigurationAndFilePath, internationalizationSchema, intlayerConfigSchema, intlayerConfigSchemaParseContext, logSchema, rewriteObjectSchema, rewriteRuleSchema, rewriteRulesSchema, routingSchema, searchConfigurationFile, storageAttributesSchema, storageSchema, systemSchema };
+export { type BrowserIntlayerConfig, EDITOR_SERVER_PORT_ENV_VAR, GetConfigurationAndFilePathResult, GetConfigurationOptions, aiSchema, analyticsSchema, applyEditorServerOverride, buildAnalyticsFields, buildBrowserConfiguration, buildConfigurationFields, buildEditorFields, buildInternationalizationFields, buildLogFields, buildRoutingFields, buildSchema, compilerSchema, configurationFilesCandidates, contentSchema, cookiesAttributesSchema, dictionarySchema, editorSchema, extractBrowserConfiguration, getConfiguration, getConfigurationAndFilePath, getEditorURLForPort, internationalizationSchema, intlayerConfigSchema, intlayerConfigSchemaParseContext, logSchema, rewriteObjectSchema, rewriteRuleSchema, rewriteRulesSchema, routingSchema, searchConfigurationFile, storageAttributesSchema, storageSchema, systemSchema };

package/dist/types/node.d.ts

@@ -2,5 +2,6 @@ import { GetConfigurationAndFilePathResult, GetConfigurationOptions, getConfigur
 import { BrowserIntlayerConfig, buildAnalyticsFields, buildBrowserConfiguration, buildEditorFields, buildInternationalizationFields, buildLogFields, buildRoutingFields, extractBrowserConfiguration } from "./configFile/buildBrowserConfiguration.js";
 import { buildConfigurationFields } from "./configFile/buildConfigurationFields.js";
 import { aiSchema, analyticsSchema, buildSchema, compilerSchema, contentSchema, cookiesAttributesSchema, dictionarySchema, editorSchema, internationalizationSchema, intlayerConfigSchema, intlayerConfigSchemaParseContext, logSchema, rewriteObjectSchema, rewriteRuleSchema, rewriteRulesSchema, routingSchema, storageAttributesSchema, storageSchema, systemSchema } from "./configFile/configurationSchema.js";
+import { EDITOR_SERVER_PORT_ENV_VAR, applyEditorServerOverride, getEditorURLForPort } from "./configFile/editorServerOverride.js";
 import { configurationFilesCandidates, searchConfigurationFile } from "./configFile/searchConfigurationFile.js";
-export { type BrowserIntlayerConfig, GetConfigurationAndFilePathResult, GetConfigurationOptions, aiSchema, analyticsSchema, buildAnalyticsFields, buildBrowserConfiguration, buildConfigurationFields, buildEditorFields, buildInternationalizationFields, buildLogFields, buildRoutingFields, buildSchema, compilerSchema, configurationFilesCandidates, contentSchema, cookiesAttributesSchema, dictionarySchema, editorSchema, extractBrowserConfiguration, getConfiguration, getConfigurationAndFilePath, internationalizationSchema, intlayerConfigSchema, intlayerConfigSchemaParseContext, logSchema, rewriteObjectSchema, rewriteRuleSchema, rewriteRulesSchema, routingSchema, searchConfigurationFile, storageAttributesSchema, storageSchema, systemSchema };
+export { type BrowserIntlayerConfig, EDITOR_SERVER_PORT_ENV_VAR, GetConfigurationAndFilePathResult, GetConfigurationOptions, aiSchema, analyticsSchema, applyEditorServerOverride, buildAnalyticsFields, buildBrowserConfiguration, buildConfigurationFields, buildEditorFields, buildInternationalizationFields, buildLogFields, buildRoutingFields, buildSchema, compilerSchema, configurationFilesCandidates, contentSchema, cookiesAttributesSchema, dictionarySchema, editorSchema, extractBrowserConfiguration, getConfiguration, getConfigurationAndFilePath, getEditorURLForPort, internationalizationSchema, intlayerConfigSchema, intlayerConfigSchemaParseContext, logSchema, rewriteObjectSchema, rewriteRuleSchema, rewriteRulesSchema, routingSchema, searchConfigurationFile, storageAttributesSchema, storageSchema, systemSchema };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/config",
-  "version": "9.6.0",
+  "version": "9.7.0",
   "private": false,
   "description": "Retrieve Intlayer configurations and manage environment variables for both server-side and client-side environments.",
   "keywords": [
@@ -190,15 +190,15 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/types": "9.6.0",
+    "@intlayer/types": "9.7.0",
     "defu": "6.1.7",
-    "dotenv": "18.0.5",
+    "dotenv": "18.0.6",
     "esbuild": "0.28.2",
     "json5": "2.2.3",
     "zod": "4.6.5"
   },
   "devDependencies": {
-    "@types/node": "^22",
+    "@types/node": "^26",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
     "@utils/tsdown-config": "1.0.4",