@intlayer/config 8.6.1 → 8.6.3

package/dist/cjs/envVars/envVars.cjs

@@ -0,0 +1,47 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/envVars/envVars.ts
+/**
+* Converts a list of unused NodeType keys into env-var definitions.
+* Set to `"false"` so bundlers can eliminate the corresponding plugin code.
+*
+* @example
+* formatNodeTypeToEnvVar(['enumeration'])
+* // { 'INTLAYER_NODE_TYPE_ENUMERATION': '"false"' }
+*
+* formatNodeTypeToEnvVar(['enumeration'], true)
+* // { 'process.env.INTLAYER_NODE_TYPE_ENUMERATION': '"false"' }
+*/
+const formatNodeTypeToEnvVar = (nodeTypes, addProcessEnv = false) => nodeTypes.reduce((acc, nodeType) => {
+	acc[addProcessEnv ? `process.env.INTLAYER_NODE_TYPE_${nodeType.toUpperCase()}` : `INTLAYER_NODE_TYPE_${nodeType.toUpperCase()}`] = "\"false\"";
+	return acc;
+}, {});
+/**
+* Returns env-var definitions for the full Intlayer config to be injected at
+* build time. Allows bundlers to dead-code-eliminate unused routing modes,
+* rewrite logic, storage mechanisms, and editor code.
+*
+* @example
+* getConfigEnvVars(config)
+* // { INTLAYER_ROUTING_MODE: '"prefix-no-default"', INTLAYER_ROUTING_REWRITE_RULES: '"false"', ... }
+*
+* getConfigEnvVars(config, true)
+* // { 'process.env.INTLAYER_ROUTING_MODE': '"prefix-no-default"', ... }
+*/
+const getConfigEnvVars = (config, addProcessEnv = false) => {
+	const prefix = addProcessEnv ? "process.env." : "";
+	const { routing, editor } = config;
+	const envVars = { [`${prefix}INTLAYER_ROUTING_MODE`]: JSON.stringify(routing.mode) };
+	if (!routing.rewrite) envVars[`${prefix}INTLAYER_ROUTING_REWRITE_RULES`] = "\"false\"";
+	if (routing.storage.cookies.length === 0) envVars[`${prefix}INTLAYER_ROUTING_STORAGE_COOKIES`] = "\"false\"";
+	if (routing.storage.localStorage.length === 0) envVars[`${prefix}INTLAYER_ROUTING_STORAGE_LOCALSTORAGE`] = "\"false\"";
+	if (routing.storage.sessionStorage.length === 0) envVars[`${prefix}INTLAYER_ROUTING_STORAGE_SESSIONSTORAGE`] = "\"false\"";
+	if (routing.storage.headers.length === 0) envVars[`${prefix}INTLAYER_ROUTING_STORAGE_HEADERS`] = "\"false\"";
+	if (editor?.enabled === false) envVars[`${prefix}INTLAYER_EDITOR_ENABLED`] = "\"false\"";
+	return envVars;
+};
+
+//#endregion
+exports.formatNodeTypeToEnvVar = formatNodeTypeToEnvVar;
+exports.getConfigEnvVars = getConfigEnvVars;
+//# sourceMappingURL=envVars.cjs.map

package/dist/cjs/envVars/envVars.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"envVars.cjs","names":[],"sources":["../../../src/envVars/envVars.ts"],"sourcesContent":["import type { IntlayerConfig } from '@intlayer/types/config';\n\n/**\n * Converts a list of unused NodeType keys into env-var definitions.\n * Set to `\"false\"` so bundlers can eliminate the corresponding plugin code.\n *\n * @example\n * formatNodeTypeToEnvVar(['enumeration'])\n * // { 'INTLAYER_NODE_TYPE_ENUMERATION': '\"false\"' }\n *\n * formatNodeTypeToEnvVar(['enumeration'], true)\n * // { 'process.env.INTLAYER_NODE_TYPE_ENUMERATION': '\"false\"' }\n */\nexport const formatNodeTypeToEnvVar = (\n  nodeTypes: string[],\n  addProcessEnv: boolean = false\n): Record<string, string> =>\n  nodeTypes.reduce(\n    (acc, nodeType) => {\n      acc[\n        addProcessEnv\n          ? `process.env.INTLAYER_NODE_TYPE_${nodeType.toUpperCase()}`\n          : `INTLAYER_NODE_TYPE_${nodeType.toUpperCase()}`\n      ] = '\"false\"';\n      return acc;\n    },\n    {} as Record<string, string>\n  );\n\n/**\n * Returns env-var definitions for the full Intlayer config to be injected at\n * build time. Allows bundlers to dead-code-eliminate unused routing modes,\n * rewrite logic, storage mechanisms, and editor code.\n *\n * @example\n * getConfigEnvVars(config)\n * // { INTLAYER_ROUTING_MODE: '\"prefix-no-default\"', INTLAYER_ROUTING_REWRITE_RULES: '\"false\"', ... }\n *\n * getConfigEnvVars(config, true)\n * // { 'process.env.INTLAYER_ROUTING_MODE': '\"prefix-no-default\"', ... }\n */\nexport const getConfigEnvVars = (\n  config: IntlayerConfig,\n  addProcessEnv: boolean = false\n): Record<string, string> => {\n  const prefix = addProcessEnv ? 'process.env.' : '';\n  const { routing, editor } = config;\n\n  const envVars: Record<string, string> = {\n    [`${prefix}INTLAYER_ROUTING_MODE`]: JSON.stringify(routing.mode),\n  };\n\n  if (!routing.rewrite) {\n    envVars[`${prefix}INTLAYER_ROUTING_REWRITE_RULES`] = '\"false\"';\n  }\n\n  if (routing.storage.cookies.length === 0) {\n    envVars[`${prefix}INTLAYER_ROUTING_STORAGE_COOKIES`] = '\"false\"';\n  }\n\n  if (routing.storage.localStorage.length === 0) {\n    envVars[`${prefix}INTLAYER_ROUTING_STORAGE_LOCALSTORAGE`] = '\"false\"';\n  }\n\n  if (routing.storage.sessionStorage.length === 0) {\n    envVars[`${prefix}INTLAYER_ROUTING_STORAGE_SESSIONSTORAGE`] = '\"false\"';\n  }\n\n  if (routing.storage.headers.length === 0) {\n    envVars[`${prefix}INTLAYER_ROUTING_STORAGE_HEADERS`] = '\"false\"';\n  }\n\n  if (editor?.enabled === false) {\n    envVars[`${prefix}INTLAYER_EDITOR_ENABLED`] = '\"false\"';\n  }\n\n  return envVars;\n};\n"],"mappings":";;;;;;;;;;;;;;AAaA,MAAa,0BACX,WACA,gBAAyB,UAEzB,UAAU,QACP,KAAK,aAAa;AACjB,KACE,gBACI,kCAAkC,SAAS,aAAa,KACxD,sBAAsB,SAAS,aAAa,MAC9C;AACJ,QAAO;GAET,EAAE,CACH;;;;;;;;;;;;;AAcH,MAAa,oBACX,QACA,gBAAyB,UACE;CAC3B,MAAM,SAAS,gBAAgB,iBAAiB;CAChD,MAAM,EAAE,SAAS,WAAW;CAE5B,MAAM,UAAkC,GACrC,GAAG,OAAO,yBAAyB,KAAK,UAAU,QAAQ,KAAK,EACjE;AAED,KAAI,CAAC,QAAQ,QACX,SAAQ,GAAG,OAAO,mCAAmC;AAGvD,KAAI,QAAQ,QAAQ,QAAQ,WAAW,EACrC,SAAQ,GAAG,OAAO,qCAAqC;AAGzD,KAAI,QAAQ,QAAQ,aAAa,WAAW,EAC1C,SAAQ,GAAG,OAAO,0CAA0C;AAG9D,KAAI,QAAQ,QAAQ,eAAe,WAAW,EAC5C,SAAQ,GAAG,OAAO,4CAA4C;AAGhE,KAAI,QAAQ,QAAQ,QAAQ,WAAW,EACrC,SAAQ,GAAG,OAAO,qCAAqC;AAGzD,KAAI,QAAQ,YAAY,MACtB,SAAQ,GAAG,OAAO,4BAA4B;AAGhD,QAAO"}

package/dist/cjs/envVars/index.cjs

@@ -0,0 +1,5 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_envVars_envVars = require('./envVars.cjs');
+
+exports.formatNodeTypeToEnvVar = require_envVars_envVars.formatNodeTypeToEnvVar;
+exports.getConfigEnvVars = require_envVars_envVars.getConfigEnvVars;

package/dist/cjs/utils/extractErrorMessage.cjs

@@ -2,11 +2,11 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 //#region src/utils/extractErrorMessage.ts
 const extractErrorMessage = (error) => {
-	const trimToSingleLine = (text) => text.split(/\r?\n/).map((s) => s.trim()).filter(Boolean)[0] ?? text.trim();
+	const trimToSingleLine = (text) => text.split(/\r?\n/).map((stringValue) => stringValue.trim()).filter(Boolean)[0] ?? text.trim();
 	const looksLikeJson = (value) => {
-		const s = value.trim();
-		if (!s) return false;
-		const first = s[0];
+		const stringValue = value.trim();
+		if (!stringValue) return false;
+		const first = stringValue[0];
 		return first === "{" || first === "[" || first === "\"";
 	};
 	const sanitizeUnexpectedTokenMessage = (text) => {
@@ -23,6 +23,14 @@ const extractErrorMessage = (error) => {
 		if (!value || typeof value !== "object") return void 0;
 		if (seen.has(value)) return void 0;
 		seen.add(value);
+		if (Array.isArray(value)) {
+			for (const item of value) {
+				const fromItem = pickFieldsFromObject(item, seen);
+				if (fromItem) return fromItem;
+				if (typeof item?.message === "string") return item.message;
+			}
+			return;
+		}
 		const obj = value;
 		if (typeof obj.message === "string" && obj.message.trim()) return obj.message;
 		if (typeof obj.error_description === "string" && obj.error_description.trim()) return obj.error_description;

package/dist/cjs/utils/extractErrorMessage.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"extractErrorMessage.cjs","names":[],"sources":["../../../src/utils/extractErrorMessage.ts"],"sourcesContent":["export const extractErrorMessage = (error: unknown): string => {\n  const trimToSingleLine = (text: string): string =>\n    text\n      .split(/\\r?\\n/)\n      .map((s) => s.trim())\n      .filter(Boolean)[0] ?? text.trim();\n\n  const looksLikeJson = (value: string): boolean => {\n    const s = value.trim();\n    if (!s) return false;\n    const first = s[0];\n    return first === '{' || first === '[' || first === '\"';\n  };\n\n  const sanitizeUnexpectedTokenMessage = (text: string): string => {\n    // If the text mentions an invalid JSON parse, try to extract the meaningful part\n    const t = text.trim();\n    if (/Unexpected token/i.test(t) && /not valid JSON/i.test(t)) {\n      const quoted = t.match(/\"([^\"]+)\"/);\n      if (quoted?.[1]) return quoted[1];\n      // Fallback: drop the leading parser error description\n      const afterColon = t.split(':').slice(1).join(':').trim();\n      if (afterColon) return afterColon;\n    }\n    return t;\n  };\n\n  const pickFieldsFromObject = (\n    value: unknown,\n    seen: Set<unknown>\n  ): string | undefined => {\n    if (!value || typeof value !== 'object') return undefined;\n    if (seen.has(value)) return undefined;\n    seen.add(value);\n\n    const obj = value as Record<string, unknown>;\n\n    // Check for message first (highest priority)\n    if (typeof obj.message === 'string' && obj.message.trim()) {\n      return obj.message;\n    }\n\n    // Check for error_description\n    if (\n      typeof obj.error_description === 'string' &&\n      obj.error_description.trim()\n    ) {\n      return obj.error_description;\n    }\n\n    // Check for error\n    if (typeof obj.error === 'string' && obj.error.trim()) {\n      return obj.error;\n    }\n\n    // Handle title and code combination\n    const title = typeof obj.title === 'string' ? obj.title.trim() : '';\n    const code = typeof obj.code === 'string' ? obj.code.trim() : '';\n\n    if (title && code) {\n      return `${title} (${code})`;\n    }\n\n    if (title) {\n      return title;\n    }\n\n    if (code) {\n      return code;\n    }\n\n    // Check for statusText\n    if (typeof obj.statusText === 'string' && obj.statusText.trim()) {\n      return obj.statusText;\n    }\n\n    // Common nested structures (Axios/Fetch-like)\n    const response = obj.response as Record<string, unknown> | undefined;\n    if (response && typeof response === 'object') {\n      const data = response.data as unknown;\n      const fromData = pickFieldsFromObject(data, seen);\n      if (fromData) return fromData;\n    }\n\n    const data = obj.data as unknown;\n    const fromData = pickFieldsFromObject(data, seen);\n    if (fromData) return fromData;\n\n    // Nested cause chain\n    const cause = (obj as { cause?: unknown }).cause;\n    const fromCause =\n      pickFieldsFromObject(cause, seen) ??\n      (typeof (cause as any)?.message === 'string'\n        ? (cause as any).message\n        : undefined);\n    if (fromCause) return fromCause;\n\n    // Arrays of errors\n    const errors = obj.errors as unknown;\n    if (Array.isArray(errors)) {\n      for (const item of errors) {\n        const fromItem = pickFieldsFromObject(item, seen);\n        if (fromItem) return fromItem;\n        if (typeof (item as any)?.message === 'string')\n          return (item as any).message;\n      }\n    }\n\n    return undefined;\n  };\n\n  const tryParseJsonString = (maybeJson: string): string | undefined => {\n    if (!looksLikeJson(maybeJson)) return undefined;\n    try {\n      const parsed = JSON.parse(maybeJson);\n      const picked = pickFieldsFromObject(parsed, new Set());\n      if (picked) return picked;\n      if (typeof parsed === 'string') return parsed;\n      return undefined;\n    } catch {\n      return undefined;\n    }\n  };\n\n  if (typeof error === 'string') {\n    const cleaned = sanitizeUnexpectedTokenMessage(error);\n    return tryParseJsonString(cleaned) ?? trimToSingleLine(cleaned);\n  }\n\n  if (error && typeof error === 'object') {\n    // Native Error instance\n    if (error instanceof Error) {\n      const cleaned = sanitizeUnexpectedTokenMessage(error.message);\n      const fromMessage = tryParseJsonString(cleaned);\n      if (fromMessage) return trimToSingleLine(fromMessage);\n      // Dive into cause when present\n      const fromCause = extractErrorMessage(error.cause as unknown);\n      if (fromCause && fromCause !== 'An unknown error occurred')\n        return trimToSingleLine(fromCause);\n      return trimToSingleLine(cleaned);\n    }\n\n    // Generic object\n    const seen = new Set<unknown>();\n    const fromObject = pickFieldsFromObject(error, seen);\n    if (fromObject) {\n      const cleaned = sanitizeUnexpectedTokenMessage(fromObject);\n      return tryParseJsonString(cleaned) ?? trimToSingleLine(cleaned);\n    }\n\n    try {\n      const serialized = JSON.stringify(error);\n      return trimToSingleLine(serialized);\n    } catch {\n      return trimToSingleLine(String(error));\n    }\n  }\n\n  return 'An unknown error occurred';\n};\n"],"mappings":"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"}
+{"version":3,"file":"extractErrorMessage.cjs","names":[],"sources":["../../../src/utils/extractErrorMessage.ts"],"sourcesContent":["export const extractErrorMessage = (error: unknown): string => {\n  const trimToSingleLine = (text: string): string =>\n    text\n      .split(/\\r?\\n/)\n      .map((stringValue) => stringValue.trim())\n      .filter(Boolean)[0] ?? text.trim();\n\n  const looksLikeJson = (value: string): boolean => {\n    const stringValue = value.trim();\n\n    if (!stringValue) return false;\n    const first = stringValue[0];\n    return first === '{' || first === '[' || first === '\"';\n  };\n\n  const sanitizeUnexpectedTokenMessage = (text: string): string => {\n    // If the text mentions an invalid JSON parse, try to extract the meaningful part\n    const t = text.trim();\n\n    if (/Unexpected token/i.test(t) && /not valid JSON/i.test(t)) {\n      const quoted = t.match(/\"([^\"]+)\"/);\n\n      if (quoted?.[1]) return quoted[1];\n      // Fallback: drop the leading parser error description\n      const afterColon = t.split(':').slice(1).join(':').trim();\n\n      if (afterColon) return afterColon;\n    }\n    return t;\n  };\n\n  const pickFieldsFromObject = (\n    value: unknown,\n    seen: Set<unknown>\n  ): string | undefined => {\n    if (!value || typeof value !== 'object') return undefined;\n\n    if (seen.has(value)) return undefined;\n\n    seen.add(value);\n\n    // If the value itself is an array (e.g. ZodError.issues), iterate its items\n\n    if (Array.isArray(value)) {\n      for (const item of value) {\n        const fromItem = pickFieldsFromObject(item, seen);\n\n        if (fromItem) return fromItem;\n\n        if (typeof (item as any)?.message === 'string')\n          return (item as any).message;\n      }\n      return undefined;\n    }\n\n    const obj = value as Record<string, unknown>;\n\n    // Check for message first (highest priority)\n\n    if (typeof obj.message === 'string' && obj.message.trim()) {\n      return obj.message;\n    }\n\n    // Check for error_description\n\n    if (\n      typeof obj.error_description === 'string' &&\n      obj.error_description.trim()\n    ) {\n      return obj.error_description;\n    }\n\n    // Check for error\n\n    if (typeof obj.error === 'string' && obj.error.trim()) {\n      return obj.error;\n    }\n\n    // Handle title and code combination\n    const title = typeof obj.title === 'string' ? obj.title.trim() : '';\n    const code = typeof obj.code === 'string' ? obj.code.trim() : '';\n\n    if (title && code) {\n      return `${title} (${code})`;\n    }\n\n    if (title) {\n      return title;\n    }\n\n    if (code) {\n      return code;\n    }\n\n    // Check for statusText\n\n    if (typeof obj.statusText === 'string' && obj.statusText.trim()) {\n      return obj.statusText;\n    }\n\n    // Common nested structures (Axios/Fetch-like)\n    const response = obj.response as Record<string, unknown> | undefined;\n\n    if (response && typeof response === 'object') {\n      const data = response.data as unknown;\n      const fromData = pickFieldsFromObject(data, seen);\n\n      if (fromData) return fromData;\n    }\n\n    const data = obj.data as unknown;\n    const fromData = pickFieldsFromObject(data, seen);\n\n    if (fromData) return fromData;\n\n    // Nested cause chain\n    const cause = (obj as { cause?: unknown }).cause;\n    const fromCause =\n      pickFieldsFromObject(cause, seen) ??\n      (typeof (cause as any)?.message === 'string'\n        ? (cause as any).message\n        : undefined);\n\n    if (fromCause) return fromCause;\n\n    // Arrays of errors\n    const errors = obj.errors as unknown;\n\n    if (Array.isArray(errors)) {\n      for (const item of errors) {\n        const fromItem = pickFieldsFromObject(item, seen);\n\n        if (fromItem) return fromItem;\n\n        if (typeof (item as any)?.message === 'string')\n          return (item as any).message;\n      }\n    }\n\n    return undefined;\n  };\n\n  const tryParseJsonString = (maybeJson: string): string | undefined => {\n    if (!looksLikeJson(maybeJson)) return undefined;\n    try {\n      const parsed = JSON.parse(maybeJson);\n      const picked = pickFieldsFromObject(parsed, new Set());\n\n      if (picked) return picked;\n\n      if (typeof parsed === 'string') return parsed;\n      return undefined;\n    } catch {\n      return undefined;\n    }\n  };\n\n  if (typeof error === 'string') {\n    const cleaned = sanitizeUnexpectedTokenMessage(error);\n    return tryParseJsonString(cleaned) ?? trimToSingleLine(cleaned);\n  }\n\n  if (error && typeof error === 'object') {\n    // Native Error instance\n\n    if (error instanceof Error) {\n      const cleaned = sanitizeUnexpectedTokenMessage(error.message);\n      const fromMessage = tryParseJsonString(cleaned);\n\n      if (fromMessage) return trimToSingleLine(fromMessage);\n      // Dive into cause when present\n      const fromCause = extractErrorMessage(error.cause as unknown);\n\n      if (fromCause && fromCause !== 'An unknown error occurred')\n        return trimToSingleLine(fromCause);\n      return trimToSingleLine(cleaned);\n    }\n\n    // Generic object\n    const seen = new Set<unknown>();\n    const fromObject = pickFieldsFromObject(error, seen);\n\n    if (fromObject) {\n      const cleaned = sanitizeUnexpectedTokenMessage(fromObject);\n      return tryParseJsonString(cleaned) ?? trimToSingleLine(cleaned);\n    }\n\n    try {\n      const serialized = JSON.stringify(error);\n      return trimToSingleLine(serialized);\n    } catch {\n      return trimToSingleLine(String(error));\n    }\n  }\n\n  return 'An unknown error occurred';\n};\n"],"mappings":"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"}

package/dist/cjs/utils/getUsedNodeTypes.cjs

@@ -0,0 +1,56 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+let _intlayer_types_nodeType = require("@intlayer/types/nodeType");
+
+//#region src/utils/getUsedNodeTypes.ts
+/** Recursively collect every `nodeType` string found in a value. */
+const collectNodeTypes = (value, result) => {
+	if (!value || typeof value !== "object") return;
+	if (Array.isArray(value)) {
+		for (const item of value) collectNodeTypes(item, result);
+		return;
+	}
+	const obj = value;
+	if (typeof obj.nodeType === "string") result.add(obj.nodeType);
+	for (const key of Object.keys(obj)) collectNodeTypes(obj[key], result);
+};
+/**
+* Returns the set of NodeType strings actually used across the given
+* built dictionaries.
+*
+* @example
+* const used = getUsedNodeTypes(getDictionaries(config));
+* // Set { 'translation', 'enumeration' }
+*/
+const getUsedNodeTypes = (dictionaries) => {
+	const result = /* @__PURE__ */ new Set();
+	const dicts = Array.isArray(dictionaries) ? dictionaries : Object.values(dictionaries);
+	for (const dict of dicts) collectNodeTypes(dict.content, result);
+	return [...result];
+};
+const getUnusedNodeTypes = (dictionaries) => {
+	const usedNodeTypes = getUsedNodeTypes(dictionaries);
+	return _intlayer_types_nodeType.PLUGIN_NODE_TYPES.filter((nodeType) => !usedNodeTypes.includes(nodeType));
+};
+const getUsedNodeTypesAsync = async (dictionaries) => {
+	const dictionariesArray = Array.isArray(dictionaries) ? dictionaries : Object.values(dictionaries);
+	const results = await Promise.all(dictionariesArray.map(async (dictionary) => {
+		const result = /* @__PURE__ */ new Set();
+		collectNodeTypes(dictionary.content, result);
+		return result;
+	}));
+	const finalResult = /* @__PURE__ */ new Set();
+	for (const res of results) for (const val of res) finalResult.add(val);
+	return [...finalResult];
+};
+const getUnusedNodeTypesAsync = async (dictionaries) => {
+	const usedNodeTypes = await getUsedNodeTypesAsync(dictionaries);
+	return _intlayer_types_nodeType.PLUGIN_NODE_TYPES.filter((nodeType) => !usedNodeTypes.includes(nodeType));
+};
+
+//#endregion
+exports.getUnusedNodeTypes = getUnusedNodeTypes;
+exports.getUnusedNodeTypesAsync = getUnusedNodeTypesAsync;
+exports.getUsedNodeTypes = getUsedNodeTypes;
+exports.getUsedNodeTypesAsync = getUsedNodeTypesAsync;
+//# sourceMappingURL=getUsedNodeTypes.cjs.map

package/dist/cjs/utils/getUsedNodeTypes.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getUsedNodeTypes.cjs","names":["PLUGIN_NODE_TYPES"],"sources":["../../../src/utils/getUsedNodeTypes.ts"],"sourcesContent":["import type { Dictionary } from '@intlayer/types/dictionary';\nimport { PLUGIN_NODE_TYPES } from '@intlayer/types/nodeType';\n\nexport type PluginNodeType = (typeof PLUGIN_NODE_TYPES)[number];\n\n/** Recursively collect every `nodeType` string found in a value. */\nconst collectNodeTypes = (value: unknown, result: Set<string>): void => {\n  if (!value || typeof value !== 'object') return;\n\n  if (Array.isArray(value)) {\n    for (const item of value) collectNodeTypes(item, result);\n    return;\n  }\n\n  const obj = value as Record<string, unknown>;\n\n  if (typeof obj.nodeType === 'string') {\n    result.add(obj.nodeType);\n  }\n\n  for (const key of Object.keys(obj)) {\n    collectNodeTypes(obj[key], result);\n  }\n};\n\n/**\n * Returns the set of NodeType strings actually used across the given\n * built dictionaries.\n *\n * @example\n * const used = getUsedNodeTypes(getDictionaries(config));\n * // Set { 'translation', 'enumeration' }\n */\nexport const getUsedNodeTypes = (\n  dictionaries: Record<string, Dictionary> | Dictionary[]\n): PluginNodeType[] => {\n  const result = new Set<PluginNodeType>();\n  const dicts = Array.isArray(dictionaries)\n    ? dictionaries\n    : Object.values(dictionaries);\n\n  for (const dict of dicts) {\n    collectNodeTypes(dict.content, result);\n  }\n\n  return [...result];\n};\n\nexport const getUnusedNodeTypes = (\n  dictionaries: Record<string, Dictionary> | Dictionary[]\n): PluginNodeType[] => {\n  const usedNodeTypes = getUsedNodeTypes(dictionaries);\n\n  return PLUGIN_NODE_TYPES.filter(\n    (nodeType) => !usedNodeTypes.includes(nodeType)\n  );\n};\n\nexport const getUsedNodeTypesAsync = async (\n  dictionaries: Record<string, Dictionary> | Dictionary[]\n): Promise<PluginNodeType[]> => {\n  const dictionariesArray = Array.isArray(dictionaries)\n    ? dictionaries\n    : Object.values(dictionaries);\n\n  const results = await Promise.all(\n    dictionariesArray.map(async (dictionary) => {\n      const result = new Set<PluginNodeType>();\n\n      collectNodeTypes(dictionary.content, result as Set<string>);\n\n      return result;\n    })\n  );\n\n  const finalResult = new Set<PluginNodeType>();\n\n  for (const res of results) {\n    for (const val of res) {\n      finalResult.add(val);\n    }\n  }\n\n  return [...finalResult];\n};\n\nexport const getUnusedNodeTypesAsync = async (\n  dictionaries: Record<string, Dictionary> | Dictionary[]\n): Promise<PluginNodeType[]> => {\n  const usedNodeTypes = await getUsedNodeTypesAsync(dictionaries);\n\n  return PLUGIN_NODE_TYPES.filter(\n    (nodeType) => !usedNodeTypes.includes(nodeType)\n  );\n};\n"],"mappings":";;;;;;AAMA,MAAM,oBAAoB,OAAgB,WAA8B;AACtE,KAAI,CAAC,SAAS,OAAO,UAAU,SAAU;AAEzC,KAAI,MAAM,QAAQ,MAAM,EAAE;AACxB,OAAK,MAAM,QAAQ,MAAO,kBAAiB,MAAM,OAAO;AACxD;;CAGF,MAAM,MAAM;AAEZ,KAAI,OAAO,IAAI,aAAa,SAC1B,QAAO,IAAI,IAAI,SAAS;AAG1B,MAAK,MAAM,OAAO,OAAO,KAAK,IAAI,CAChC,kBAAiB,IAAI,MAAM,OAAO;;;;;;;;;;AAYtC,MAAa,oBACX,iBACqB;CACrB,MAAM,yBAAS,IAAI,KAAqB;CACxC,MAAM,QAAQ,MAAM,QAAQ,aAAa,GACrC,eACA,OAAO,OAAO,aAAa;AAE/B,MAAK,MAAM,QAAQ,MACjB,kBAAiB,KAAK,SAAS,OAAO;AAGxC,QAAO,CAAC,GAAG,OAAO;;AAGpB,MAAa,sBACX,iBACqB;CACrB,MAAM,gBAAgB,iBAAiB,aAAa;AAEpD,QAAOA,2CAAkB,QACtB,aAAa,CAAC,cAAc,SAAS,SAAS,CAChD;;AAGH,MAAa,wBAAwB,OACnC,iBAC8B;CAC9B,MAAM,oBAAoB,MAAM,QAAQ,aAAa,GACjD,eACA,OAAO,OAAO,aAAa;CAE/B,MAAM,UAAU,MAAM,QAAQ,IAC5B,kBAAkB,IAAI,OAAO,eAAe;EAC1C,MAAM,yBAAS,IAAI,KAAqB;AAExC,mBAAiB,WAAW,SAAS,OAAsB;AAE3D,SAAO;GACP,CACH;CAED,MAAM,8BAAc,IAAI,KAAqB;AAE7C,MAAK,MAAM,OAAO,QAChB,MAAK,MAAM,OAAO,IAChB,aAAY,IAAI,IAAI;AAIxB,QAAO,CAAC,GAAG,YAAY;;AAGzB,MAAa,0BAA0B,OACrC,iBAC8B;CAC9B,MAAM,gBAAgB,MAAM,sBAAsB,aAAa;AAE/D,QAAOA,2CAAkB,QACtB,aAAa,CAAC,cAAc,SAAS,SAAS,CAChD"}

package/dist/cjs/utils/index.cjs

@@ -10,6 +10,7 @@ const require_utils_clearModuleCache = require('./clearModuleCache.cjs');
 const require_utils_compareVersions = require('./compareVersions.cjs');
 const require_utils_extractErrorMessage = require('./extractErrorMessage.cjs');
 const require_utils_getStorageAttributes = require('./getStorageAttributes.cjs');
+const require_utils_getUsedNodeTypes = require('./getUsedNodeTypes.cjs');
 const require_utils_logStack = require('./logStack.cjs');
 const require_utils_parseFilePathPattern = require('./parseFilePathPattern.cjs');
 const require_utils_retryManager = require('./retryManager.cjs');
@@ -36,6 +37,10 @@ exports.getExtension = require_utils_getExtension.getExtension;
 exports.getPackageJsonPath = require_utils_getPackageJsonPath.getPackageJsonPath;
 exports.getProjectRequire = require_utils_ESMxCJSHelpers.getProjectRequire;
 exports.getStorageAttributes = require_utils_getStorageAttributes.getStorageAttributes;
+exports.getUnusedNodeTypes = require_utils_getUsedNodeTypes.getUnusedNodeTypes;
+exports.getUnusedNodeTypesAsync = require_utils_getUsedNodeTypes.getUnusedNodeTypesAsync;
+exports.getUsedNodeTypes = require_utils_getUsedNodeTypes.getUsedNodeTypes;
+exports.getUsedNodeTypesAsync = require_utils_getUsedNodeTypes.getUsedNodeTypesAsync;
 exports.isESModule = require_utils_ESMxCJSHelpers.isESModule;
 exports.kebabCaseToCamelCase = require_utils_stringFormatter_kebabCaseToCamelCase.kebabCaseToCamelCase;
 exports.logStack = require_utils_logStack.logStack;

package/dist/esm/configFile/buildBrowserConfiguration.mjs

@@ -3,7 +3,7 @@ import { getStorageAttributes } from "../utils/getStorageAttributes.mjs";
 import { APPLICATION_URL, BACKEND_URL, CMS_URL, DICTIONARY_PRIORITY_STRATEGY, EDITOR_URL, IS_ENABLED, LIVE_SYNC, LIVE_SYNC_PORT, PORT } from "../defaultValues/editor.mjs";
 import { DEFAULT_LOCALE, LOCALES, REQUIRED_LOCALES, STRICT_MODE } from "../defaultValues/internationalization.mjs";
 import { MODE, PREFIX } from "../defaultValues/log.mjs";
-import packageJson from "@intlayer/types/package.json" with { type: "json" };
+import configPackageJson from "@intlayer/types/package.json" with { type: "json" };
 
 //#region src/configFile/buildBrowserConfiguration.ts
 /**
@@ -115,7 +115,7 @@ const buildBrowserConfiguration = (customConfig) => {
 		},
 		metadata: {
 			name: "Intlayer",
-			version: packageJson.version,
+			version: configPackageJson.version,
 			doc: "https://intlayer.org/docs"
 		}
 	};

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

@@ -1 +1 @@
-{"version":3,"file":"buildBrowserConfiguration.mjs","names":[],"sources":["../../../src/configFile/buildBrowserConfiguration.ts"],"sourcesContent":["import type {\n  CustomIntlayerConfig,\n  CustomRoutingConfig,\n  EditorConfig,\n  InternationalizationConfig,\n  IntlayerConfig,\n  LogConfig,\n  LogFunctions,\n  RoutingConfig,\n} from '@intlayer/types/config';\nimport packageJson from '@intlayer/types/package.json' with { type: 'json' };\nimport {\n  APPLICATION_URL,\n  BACKEND_URL,\n  CMS_URL,\n  DICTIONARY_PRIORITY_STRATEGY,\n  EDITOR_URL,\n  IS_ENABLED,\n  LIVE_SYNC,\n  LIVE_SYNC_PORT,\n  PORT,\n} from '../defaultValues/editor';\nimport {\n  DEFAULT_LOCALE,\n  LOCALES,\n  REQUIRED_LOCALES,\n  STRICT_MODE,\n} from '../defaultValues/internationalization';\nimport { MODE, PREFIX } from '../defaultValues/log';\nimport { BASE_PATH, ROUTING_MODE, STORAGE } from '../defaultValues/routing';\nimport { getStorageAttributes } from '../utils/getStorageAttributes';\n\n// ---------------------------------------------------------------------------\n// Type\n// ---------------------------------------------------------------------------\n\n/**\n * Browser-safe subset of {@link IntlayerConfig}.\n *\n * Excludes server-only fields (`system`, `content`, `build`, `compiler`,\n * `dictionary`, `ai`) and sensitive editor credentials (`clientId`,\n * `clientSecret`) that must never be shipped to the browser.\n */\nexport type BrowserIntlayerConfig = {\n  internationalization: Pick<\n    InternationalizationConfig,\n    'locales' | 'defaultLocale'\n  >;\n  routing: RoutingConfig;\n  editor: Omit<EditorConfig, 'clientId' | 'clientSecret'>;\n  log: Pick<LogConfig, 'mode' | 'prefix'>;\n  metadata: IntlayerConfig['metadata'];\n};\n\ndeclare global {\n  interface Window {\n    /** Browser-safe Intlayer configuration injected by a build plugin or `installIntlayer`. */\n    INTLAYER_CONFIG?: BrowserIntlayerConfig;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Shared field builders (browser-safe — no Node.js APIs)\n//\n// These functions are re-used by both `buildBrowserConfiguration` (browser)\n// and `buildConfigurationFields` (server) to avoid duplication.\n// ---------------------------------------------------------------------------\n\n/**\n * Build the internationalization section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied internationalization config.\n * @returns A fully-defaulted {@link InternationalizationConfig}.\n */\nexport const buildInternationalizationFields = (\n  customConfiguration?: Partial<InternationalizationConfig>\n): InternationalizationConfig => ({\n  /**\n   * Locales available in the application\n   *\n   * Default: ['en']\n   *\n   */\n  locales: customConfiguration?.locales ?? LOCALES,\n\n  /**\n   * Locales required by TypeScript to ensure strong implementations of internationalized content using typescript.\n   *\n   * Default: []\n   *\n   * If empty, all locales are required in `strict` mode.\n   *\n   * Ensure required locales are also defined in the `locales` field.\n   */\n  requiredLocales:\n    customConfiguration?.requiredLocales ??\n    customConfiguration?.locales ??\n    REQUIRED_LOCALES,\n\n  /**\n   * Ensure strong implementations of internationalized content using typescript.\n   * - If set to \"strict\", the translation `t` function will require each declared locales to be defined. If one locale is missing, or if a locale is not declared in your config, it will throw an error.\n   * - If set to \"inclusive\", the translation `t` function will require each declared locales to be defined. If one locale is missing, it will throw a warning. But will accept if a locale is not declared in your config, but exist.\n   * - If set to \"loose\", the translation `t` function will accept any existing locale.\n   *\n   * Default: \"inclusive\"\n   */\n  strictMode: customConfiguration?.strictMode ?? STRICT_MODE,\n\n  /**\n   * Default locale of the application for fallback\n   *\n   * Default: 'en'\n   */\n  defaultLocale: customConfiguration?.defaultLocale ?? DEFAULT_LOCALE,\n});\n\n/**\n * Build the routing section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied routing config.\n * @returns A fully-defaulted {@link RoutingConfig}.\n */\nexport const buildRoutingFields = (\n  customConfiguration?: Partial<CustomRoutingConfig>\n): RoutingConfig => {\n  const storage = customConfiguration?.storage ?? STORAGE;\n\n  return {\n    /**\n     * URL routing mode for locale handling\n     *\n     * Controls how locales are represented in application URLs:\n     * - 'prefix-no-default': Prefix all locales except the default locale (default)\n     *    - en → /dashboard\n     *    - fr → /fr/dashboard\n     *\n     * - 'prefix-all': Prefix all locales including the default locale\n     *    - en → /en/dashboard\n     *    - fr → /fr/dashboard\n     *\n     * - 'search-params': Use search parameters for locale handling\n     *    - en → /dashboard?locale=en\n     *    - fr → /fr/dashboard?locale=fr\n     *\n     * - 'no-prefix': No locale prefixing in URLs\n     *    - en → /dashboard\n     *    - fr → /dashboard\n     *\n     * Default: 'prefix-no-default'\n     */\n    mode: customConfiguration?.mode ?? ROUTING_MODE,\n\n    /**\n     * Configuration for storing the locale in the client (localStorage or sessionStorage)\n     *\n     * If false, the locale will not be stored by the middleware.\n     * If true, the locale storage will consider all default values. (cookie and header)\n     *\n     * Default: ['cookie', 'header']\n     *\n     */\n    storage: getStorageAttributes(storage),\n\n    /**\n     * Base path of the application URL\n     *\n     * Default: ''\n     *\n     * Example:\n     * - If the application is hosted at https://example.com/my-app\n     * - The base path is '/my-app'\n     * - The URL will be https://example.com/my-app/en\n     * - If the base path is not set, the URL will be https://example.com/en\n     */\n    basePath: customConfiguration?.basePath ?? BASE_PATH,\n\n    /**\n     * Custom URL rewriting rules that override the default routing mode for specific paths.\n     * Allows you to define locale-specific paths that differ from the standard routing behavior.\n     * Supports dynamic route parameters using `[param]` syntax.\n     *\n     * Default: undefined\n     *\n     * Example:\n     * ```typescript\n     * rewrite: {\n     *   \"/about\": {\n     *     en: \"/about\",\n     *     fr: \"/a-propos\",\n     *   },\n     *   \"/product/[slug]\": {\n     *     en: \"/product/[slug]\",\n     *     fr: \"/produit/[slug]\",\n     *   },\n     * }\n     * ```\n     *\n     * Note:\n     * - The rewrite rules take precedence over the default `mode` behavior.\n     * - If a path matches a rewrite rule, the localized path from the rewrite configuration will be used.\n     * - Dynamic route parameters are supported using bracket notation (e.g., `[slug]`, `[id]`).\n     * - Works with both Next.js and Vite applications.\n     */\n    rewrite: customConfiguration?.rewrite,\n  };\n};\n\n/**\n * Build the editor section of the Intlayer configuration.\n *\n * Returns the **full** {@link EditorConfig} including sensitive fields\n * (`clientId`, `clientSecret`). The browser-safe {@link BrowserIntlayerConfig}\n * omits those fields when exposing config to the client.\n *\n * @param customConfiguration - Partial user-supplied editor config.\n * @returns A fully-defaulted {@link EditorConfig}.\n */\nexport const buildEditorFields = (\n  customConfiguration?: Partial<EditorConfig>\n): EditorConfig => {\n  const liveSyncPort = customConfiguration?.liveSyncPort ?? LIVE_SYNC_PORT;\n  return {\n    /**\n     * URL of the application. Used to restrict the origin of the editor for security reasons.\n     *\n     * > '*' means that the editor is accessible from any origin\n     *\n     * Default: '*'\n     */\n    applicationURL: customConfiguration?.applicationURL || APPLICATION_URL,\n\n    /**\n     * URL of the editor server. Used to restrict the origin of the editor for security reasons.\n     *\n     * > '*' means that the editor is accessible from any origin\n     *\n     * Default: '*'\n     */\n    editorURL: customConfiguration?.editorURL || EDITOR_URL,\n\n    /**\n     * URL of the CMS server. Used to restrict the origin of the editor for security reasons.\n     */\n    cmsURL: customConfiguration?.cmsURL || CMS_URL,\n\n    /**\n     * URL of the editor server\n     *\n     * Default: 'https://back.intlayer.org'\n     */\n    backendURL: customConfiguration?.backendURL || BACKEND_URL,\n\n    /** Port of the editor server\n     *\n     * Default: 8000\n     */\n    port: customConfiguration?.port ?? PORT,\n\n    /**\n     * Indicates if the application interact with the visual editor\n     *\n     * Default: false;\n     *\n     * If true, the editor will be able to interact with the application.\n     * If false, the editor will not be able to interact with the application.\n     * In any case, the editor can only be enabled by the visual editor.\n     * Disabling the editor for specific environments is a way to enforce the security.\n     *\n     * Usage:\n     * ```js\n     * {\n     *  // Other configurations\n     *  editor: {\n     *   enabled: process.env.NODE_ENV !== 'production',\n     *  }\n     * };\n     * ```\n     */\n    enabled: customConfiguration?.enabled ?? IS_ENABLED,\n\n    /**\n     * clientId and clientSecret allow the intlayer packages to authenticate with the backend using oAuth2 authentication.\n     * An access token is use to authenticate the user related to the project.\n     * To get an access token, go to https://app.intlayer.org/project and create an account.\n     *\n     * Default: undefined\n     *\n     * > Important: The clientId and clientSecret should be kept secret and not shared publicly. Please ensure to keep them in a secure location, such as environment variables.\n     */\n    clientId: customConfiguration?.clientId ?? undefined,\n\n    /**\n     * clientId and clientSecret allow the intlayer packages to authenticate with the backend using oAuth2 authentication.\n     * An access token is use to authenticate the user related to the project.\n     * To get an access token, go to https://app.intlayer.org/project and create an account.\n     *\n     * Default: undefined\n     *\n     * > Important: The clientId and clientSecret should be kept secret and not shared publicly. Please ensure to keep them in a secure location, such as environment variables.\n     */\n    clientSecret: customConfiguration?.clientSecret ?? undefined,\n\n    /**\n     * Strategy for prioritizing dictionaries. If a dictionary is both present online and locally, the content will be merge.\n     * However, is a field is defined in both dictionary, this setting determines which fields takes the priority over the other.\n     *\n     * Default: 'local_first'\n     *\n     * The strategy for prioritizing dictionaries. It can be either 'local_first' or 'distant_first'.\n     * - 'local_first': The first dictionary found in the locale is used.\n     * - 'distant_first': The first dictionary found in the distant locales is used.\n     */\n    dictionaryPriorityStrategy:\n      customConfiguration?.dictionaryPriorityStrategy ??\n      DICTIONARY_PRIORITY_STRATEGY,\n\n    /**\n     * Indicates if the application should hot reload the locale configurations when a change is detected.\n     * For example, when a new dictionary is added or updated, the application will update the content tu display in the page.\n     *\n     * The hot reload is only available for clients of the `enterprise` plan.\n     *\n     * Default: false\n     */\n    liveSync: customConfiguration?.liveSync ?? LIVE_SYNC,\n\n    /**\n     * Port of the live sync server\n     *\n     * Default: 4000\n     */\n    liveSyncPort,\n\n    /**\n     * URL of the live sync server in case of remote live sync server\n     *\n     * Default: `http://localhost:${LIVE_SYNC_PORT}`\n     */\n    liveSyncURL:\n      customConfiguration?.liveSyncURL ?? `http://localhost:${liveSyncPort}`,\n  };\n};\n\n/**\n * Build the log section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied log config.\n * @param logFunctions - Optional custom log function overrides (server-only).\n * @returns A fully-defaulted {@link LogConfig}.\n */\nexport const buildLogFields = (\n  customConfiguration?: Partial<LogConfig>,\n  logFunctions?: LogFunctions\n): LogConfig => ({\n  /**\n   * Indicates if the logger is enabled\n   *\n   * Default: 'prefix-no-default'\n   *\n   * If 'default', the logger is enabled and can be used.\n   * If 'verbose', the logger will be enabled and can be used, but will log more information.\n   * If 'disabled', the logger is disabled and cannot be used.\n   */\n  mode: customConfiguration?.mode ?? MODE,\n\n  /**\n   * Prefix of the logger\n   *\n   * Default: '[intlayer]'\n   *\n   * The prefix of the logger.\n   */\n  prefix: customConfiguration?.prefix ?? PREFIX,\n\n  /**\n   * Functions to log\n   */\n  error: logFunctions?.error,\n  log: logFunctions?.log,\n  info: logFunctions?.info,\n  warn: logFunctions?.warn,\n});\n\n// ---------------------------------------------------------------------------\n// Browser configuration builders\n// ---------------------------------------------------------------------------\n\n/**\n * Build a browser-safe {@link BrowserIntlayerConfig} from a raw user config.\n *\n * Applies defaults for every field and strips all server-only or sensitive\n * information (`system`, `content`, `build`, `compiler`, `dictionary`, `ai`,\n * `editor.clientId`, `editor.clientSecret`).\n *\n * This is the browser counterpart of `buildConfigurationFields`. It is safe\n * to call in browser environments because it has no Node.js dependencies.\n *\n * @param customConfig - Optional partial user-supplied Intlayer config.\n * @returns A browser-safe configuration object ready for `window.INTLAYER_CONFIG`.\n *\n * @example\n * ```ts\n * import { buildBrowserConfiguration } from '@intlayer/config/client';\n *\n * window.INTLAYER_CONFIG = buildBrowserConfiguration({\n *   internationalization: { locales: ['en', 'fr'], defaultLocale: 'en' },\n * });\n * ```\n */\nexport const buildBrowserConfiguration = (\n  customConfig?: CustomIntlayerConfig\n): BrowserIntlayerConfig => {\n  const { locales, defaultLocale } = buildInternationalizationFields(\n    customConfig?.internationalization\n  );\n  const routing = buildRoutingFields(customConfig?.routing);\n  const {\n    clientId: _clientId,\n    clientSecret: _clientSecret,\n    ...editorPublic\n  } = buildEditorFields(customConfig?.editor);\n  const { mode, prefix } = buildLogFields(customConfig?.log);\n\n  return {\n    internationalization: { locales, defaultLocale },\n    routing,\n    editor: editorPublic,\n    log: { mode, prefix },\n    metadata: {\n      name: 'Intlayer',\n      version: packageJson.version,\n      doc: 'https://intlayer.org/docs',\n    },\n  };\n};\n\n/**\n * Extract a {@link BrowserIntlayerConfig} from an already-built full\n * {@link IntlayerConfig}.\n *\n * Used by build plugins (`vite-intlayer`, `withIntlayer`) which already hold\n * the full server-side config and need to inject the browser-safe subset at\n * compile time via a bundler `define`.\n *\n * @param config - A fully-built server-side Intlayer configuration.\n * @returns The browser-safe subset of that configuration.\n */\nexport const extractBrowserConfiguration = (\n  config: IntlayerConfig\n): BrowserIntlayerConfig => ({\n  internationalization: {\n    locales: config.internationalization.locales,\n    defaultLocale: config.internationalization.defaultLocale,\n  },\n  routing: {\n    mode: config.routing.mode,\n    storage: config.routing.storage,\n    basePath: config.routing.basePath,\n    rewrite: config.routing.rewrite,\n  },\n  editor: {\n    applicationURL: config.editor.applicationURL,\n    editorURL: config.editor.editorURL,\n    cmsURL: config.editor.cmsURL,\n    backendURL: config.editor.backendURL,\n    port: config.editor.port,\n    enabled: config.editor.enabled,\n    dictionaryPriorityStrategy: config.editor.dictionaryPriorityStrategy,\n    liveSync: config.editor.liveSync,\n    liveSyncPort: config.editor.liveSyncPort,\n    liveSyncURL: config.editor.liveSyncURL,\n  },\n  log: {\n    mode: config.log.mode,\n    prefix: config.log.prefix,\n  },\n  metadata: config.metadata,\n});\n"],"mappings":";;;;;;;;;;;;;;AA0EA,MAAa,mCACX,yBACgC;CAOhC,SAAS,qBAAqB,WAAW;CAWzC,iBACE,qBAAqB,mBACrB,qBAAqB,WACrB;CAUF,YAAY,qBAAqB;CAOjC,eAAe,qBAAqB,iBAAiB;CACtD;;;;;;;AAQD,MAAa,sBACX,wBACkB;CAClB,MAAM,UAAU,qBAAqB,WAAW;AAEhD,QAAO;EAuBL,MAAM,qBAAqB;EAW3B,SAAS,qBAAqB,QAAQ;EAatC,UAAU,qBAAqB;EA6B/B,SAAS,qBAAqB;EAC/B;;;;;;;;;;;;AAaH,MAAa,qBACX,wBACiB;CACjB,MAAM,eAAe,qBAAqB;AAC1C,QAAO;EAQL,gBAAgB,qBAAqB;EASrC,WAAW,qBAAqB;EAKhC,QAAQ,qBAAqB;EAO7B,YAAY,qBAAqB;EAMjC,MAAM,qBAAqB;EAsB3B,SAAS,qBAAqB;EAW9B,UAAU,qBAAqB,YAAY;EAW3C,cAAc,qBAAqB,gBAAgB;EAYnD,4BACE,qBAAqB;EAWvB,UAAU,qBAAqB;EAO/B;EAOA,aACE,qBAAqB,eAAe,oBAAoB;EAC3D;;;;;;;;;AAUH,MAAa,kBACX,qBACA,kBACe;CAUf,MAAM,qBAAqB;CAS3B,QAAQ,qBAAqB,UAAU;CAKvC,OAAO,cAAc;CACrB,KAAK,cAAc;CACnB,MAAM,cAAc;CACpB,MAAM,cAAc;CACrB;;;;;;;;;;;;;;;;;;;;;;;AA4BD,MAAa,6BACX,iBAC0B;CAC1B,MAAM,EAAE,SAAS,kBAAkB,gCACjC,cAAc,qBACf;CACD,MAAM,UAAU,mBAAmB,cAAc,QAAQ;CACzD,MAAM,EACJ,UAAU,WACV,cAAc,eACd,GAAG,iBACD,kBAAkB,cAAc,OAAO;CAC3C,MAAM,EAAE,MAAM,WAAW,eAAe,cAAc,IAAI;AAE1D,QAAO;EACL,sBAAsB;GAAE;GAAS;GAAe;EAChD;EACA,QAAQ;EACR,KAAK;GAAE;GAAM;GAAQ;EACrB,UAAU;GACR,MAAM;GACN,SAAS,YAAY;GACrB,KAAK;GACN;EACF;;;;;;;;;;;;;AAcH,MAAa,+BACX,YAC2B;CAC3B,sBAAsB;EACpB,SAAS,OAAO,qBAAqB;EACrC,eAAe,OAAO,qBAAqB;EAC5C;CACD,SAAS;EACP,MAAM,OAAO,QAAQ;EACrB,SAAS,OAAO,QAAQ;EACxB,UAAU,OAAO,QAAQ;EACzB,SAAS,OAAO,QAAQ;EACzB;CACD,QAAQ;EACN,gBAAgB,OAAO,OAAO;EAC9B,WAAW,OAAO,OAAO;EACzB,QAAQ,OAAO,OAAO;EACtB,YAAY,OAAO,OAAO;EAC1B,MAAM,OAAO,OAAO;EACpB,SAAS,OAAO,OAAO;EACvB,4BAA4B,OAAO,OAAO;EAC1C,UAAU,OAAO,OAAO;EACxB,cAAc,OAAO,OAAO;EAC5B,aAAa,OAAO,OAAO;EAC5B;CACD,KAAK;EACH,MAAM,OAAO,IAAI;EACjB,QAAQ,OAAO,IAAI;EACpB;CACD,UAAU,OAAO;CAClB"}
+{"version":3,"file":"buildBrowserConfiguration.mjs","names":["packageJson"],"sources":["../../../src/configFile/buildBrowserConfiguration.ts"],"sourcesContent":["import type {\n  CustomIntlayerConfig,\n  CustomRoutingConfig,\n  EditorConfig,\n  InternationalizationConfig,\n  IntlayerConfig,\n  LogConfig,\n  LogFunctions,\n  RoutingConfig,\n} from '@intlayer/types/config';\nimport packageJson from '@intlayer/types/package.json' with { type: 'json' };\nimport {\n  APPLICATION_URL,\n  BACKEND_URL,\n  CMS_URL,\n  DICTIONARY_PRIORITY_STRATEGY,\n  EDITOR_URL,\n  IS_ENABLED,\n  LIVE_SYNC,\n  LIVE_SYNC_PORT,\n  PORT,\n} from '../defaultValues/editor';\nimport {\n  DEFAULT_LOCALE,\n  LOCALES,\n  REQUIRED_LOCALES,\n  STRICT_MODE,\n} from '../defaultValues/internationalization';\nimport { MODE, PREFIX } from '../defaultValues/log';\nimport { BASE_PATH, ROUTING_MODE, STORAGE } from '../defaultValues/routing';\nimport { getStorageAttributes } from '../utils/getStorageAttributes';\n\n// ---------------------------------------------------------------------------\n// Type\n// ---------------------------------------------------------------------------\n\n/**\n * Browser-safe subset of {@link IntlayerConfig}.\n *\n * Excludes server-only fields (`system`, `content`, `build`, `compiler`,\n * `dictionary`, `ai`) and sensitive editor credentials (`clientId`,\n * `clientSecret`) that must never be shipped to the browser.\n */\nexport type BrowserIntlayerConfig = {\n  internationalization: Pick<\n    InternationalizationConfig,\n    'locales' | 'defaultLocale'\n  >;\n  routing: RoutingConfig;\n  editor: Omit<EditorConfig, 'clientId' | 'clientSecret'>;\n  log: Pick<LogConfig, 'mode' | 'prefix'>;\n  metadata: IntlayerConfig['metadata'];\n};\n\ndeclare global {\n  interface Window {\n    /** Browser-safe Intlayer configuration injected by a build plugin or `installIntlayer`. */\n    INTLAYER_CONFIG?: BrowserIntlayerConfig;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Shared field builders (browser-safe — no Node.js APIs)\n//\n// These functions are re-used by both `buildBrowserConfiguration` (browser)\n// and `buildConfigurationFields` (server) to avoid duplication.\n// ---------------------------------------------------------------------------\n\n/**\n * Build the internationalization section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied internationalization config.\n * @returns A fully-defaulted {@link InternationalizationConfig}.\n */\nexport const buildInternationalizationFields = (\n  customConfiguration?: Partial<InternationalizationConfig>\n): InternationalizationConfig => ({\n  /**\n   * Locales available in the application\n   *\n   * Default: ['en']\n   *\n   */\n  locales: customConfiguration?.locales ?? LOCALES,\n\n  /**\n   * Locales required by TypeScript to ensure strong implementations of internationalized content using typescript.\n   *\n   * Default: []\n   *\n   * If empty, all locales are required in `strict` mode.\n   *\n   * Ensure required locales are also defined in the `locales` field.\n   */\n  requiredLocales:\n    customConfiguration?.requiredLocales ??\n    customConfiguration?.locales ??\n    REQUIRED_LOCALES,\n\n  /**\n   * Ensure strong implementations of internationalized content using typescript.\n   * - If set to \"strict\", the translation `t` function will require each declared locales to be defined. If one locale is missing, or if a locale is not declared in your config, it will throw an error.\n   * - If set to \"inclusive\", the translation `t` function will require each declared locales to be defined. If one locale is missing, it will throw a warning. But will accept if a locale is not declared in your config, but exist.\n   * - If set to \"loose\", the translation `t` function will accept any existing locale.\n   *\n   * Default: \"inclusive\"\n   */\n  strictMode: customConfiguration?.strictMode ?? STRICT_MODE,\n\n  /**\n   * Default locale of the application for fallback\n   *\n   * Default: 'en'\n   */\n  defaultLocale: customConfiguration?.defaultLocale ?? DEFAULT_LOCALE,\n});\n\n/**\n * Build the routing section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied routing config.\n * @returns A fully-defaulted {@link RoutingConfig}.\n */\nexport const buildRoutingFields = (\n  customConfiguration?: Partial<CustomRoutingConfig>\n): RoutingConfig => {\n  const storage = customConfiguration?.storage ?? STORAGE;\n\n  return {\n    /**\n     * URL routing mode for locale handling\n     *\n     * Controls how locales are represented in application URLs:\n     * - 'prefix-no-default': Prefix all locales except the default locale (default)\n     *    - en → /dashboard\n     *    - fr → /fr/dashboard\n     *\n     * - 'prefix-all': Prefix all locales including the default locale\n     *    - en → /en/dashboard\n     *    - fr → /fr/dashboard\n     *\n     * - 'search-params': Use search parameters for locale handling\n     *    - en → /dashboard?locale=en\n     *    - fr → /fr/dashboard?locale=fr\n     *\n     * - 'no-prefix': No locale prefixing in URLs\n     *    - en → /dashboard\n     *    - fr → /dashboard\n     *\n     * Default: 'prefix-no-default'\n     */\n    mode: customConfiguration?.mode ?? ROUTING_MODE,\n\n    /**\n     * Configuration for storing the locale in the client (localStorage or sessionStorage)\n     *\n     * If false, the locale will not be stored by the middleware.\n     * If true, the locale storage will consider all default values. (cookie and header)\n     *\n     * Default: ['cookie', 'header']\n     *\n     */\n    storage: getStorageAttributes(storage),\n\n    /**\n     * Base path of the application URL\n     *\n     * Default: ''\n     *\n     * Example:\n     * - If the application is hosted at https://example.com/my-app\n     * - The base path is '/my-app'\n     * - The URL will be https://example.com/my-app/en\n     * - If the base path is not set, the URL will be https://example.com/en\n     */\n    basePath: customConfiguration?.basePath ?? BASE_PATH,\n\n    /**\n     * Custom URL rewriting rules that override the default routing mode for specific paths.\n     * Allows you to define locale-specific paths that differ from the standard routing behavior.\n     * Supports dynamic route parameters using `[param]` syntax.\n     *\n     * Default: undefined\n     *\n     * Example:\n     * ```typescript\n     * rewrite: {\n     *   \"/about\": {\n     *     en: \"/about\",\n     *     fr: \"/a-propos\",\n     *   },\n     *   \"/product/[slug]\": {\n     *     en: \"/product/[slug]\",\n     *     fr: \"/produit/[slug]\",\n     *   },\n     * }\n     * ```\n     *\n     * Note:\n     * - The rewrite rules take precedence over the default `mode` behavior.\n     * - If a path matches a rewrite rule, the localized path from the rewrite configuration will be used.\n     * - Dynamic route parameters are supported using bracket notation (e.g., `[slug]`, `[id]`).\n     * - Works with both Next.js and Vite applications.\n     */\n    rewrite: customConfiguration?.rewrite,\n  };\n};\n\n/**\n * Build the editor section of the Intlayer configuration.\n *\n * Returns the **full** {@link EditorConfig} including sensitive fields\n * (`clientId`, `clientSecret`). The browser-safe {@link BrowserIntlayerConfig}\n * omits those fields when exposing config to the client.\n *\n * @param customConfiguration - Partial user-supplied editor config.\n * @returns A fully-defaulted {@link EditorConfig}.\n */\nexport const buildEditorFields = (\n  customConfiguration?: Partial<EditorConfig>\n): EditorConfig => {\n  const liveSyncPort = customConfiguration?.liveSyncPort ?? LIVE_SYNC_PORT;\n  return {\n    /**\n     * URL of the application. Used to restrict the origin of the editor for security reasons.\n     *\n     * > '*' means that the editor is accessible from any origin\n     *\n     * Default: '*'\n     */\n    applicationURL: customConfiguration?.applicationURL || APPLICATION_URL,\n\n    /**\n     * URL of the editor server. Used to restrict the origin of the editor for security reasons.\n     *\n     * > '*' means that the editor is accessible from any origin\n     *\n     * Default: '*'\n     */\n    editorURL: customConfiguration?.editorURL || EDITOR_URL,\n\n    /**\n     * URL of the CMS server. Used to restrict the origin of the editor for security reasons.\n     */\n    cmsURL: customConfiguration?.cmsURL || CMS_URL,\n\n    /**\n     * URL of the editor server\n     *\n     * Default: 'https://back.intlayer.org'\n     */\n    backendURL: customConfiguration?.backendURL || BACKEND_URL,\n\n    /** Port of the editor server\n     *\n     * Default: 8000\n     */\n    port: customConfiguration?.port ?? PORT,\n\n    /**\n     * Indicates if the application interact with the visual editor\n     *\n     * Default: false;\n     *\n     * If true, the editor will be able to interact with the application.\n     * If false, the editor will not be able to interact with the application.\n     * In any case, the editor can only be enabled by the visual editor.\n     * Disabling the editor for specific environments is a way to enforce the security.\n     *\n     * Usage:\n     * ```js\n     * {\n     *  // Other configurations\n     *  editor: {\n     *   enabled: process.env.NODE_ENV !== 'production',\n     *  }\n     * };\n     * ```\n     */\n    enabled: customConfiguration?.enabled ?? IS_ENABLED,\n\n    /**\n     * clientId and clientSecret allow the intlayer packages to authenticate with the backend using oAuth2 authentication.\n     * An access token is use to authenticate the user related to the project.\n     * To get an access token, go to https://app.intlayer.org/project and create an account.\n     *\n     * Default: undefined\n     *\n     * > Important: The clientId and clientSecret should be kept secret and not shared publicly. Please ensure to keep them in a secure location, such as environment variables.\n     */\n    clientId: customConfiguration?.clientId ?? undefined,\n\n    /**\n     * clientId and clientSecret allow the intlayer packages to authenticate with the backend using oAuth2 authentication.\n     * An access token is use to authenticate the user related to the project.\n     * To get an access token, go to https://app.intlayer.org/project and create an account.\n     *\n     * Default: undefined\n     *\n     * > Important: The clientId and clientSecret should be kept secret and not shared publicly. Please ensure to keep them in a secure location, such as environment variables.\n     */\n    clientSecret: customConfiguration?.clientSecret ?? undefined,\n\n    /**\n     * Strategy for prioritizing dictionaries. If a dictionary is both present online and locally, the content will be merge.\n     * However, is a field is defined in both dictionary, this setting determines which fields takes the priority over the other.\n     *\n     * Default: 'local_first'\n     *\n     * The strategy for prioritizing dictionaries. It can be either 'local_first' or 'distant_first'.\n     * - 'local_first': The first dictionary found in the locale is used.\n     * - 'distant_first': The first dictionary found in the distant locales is used.\n     */\n    dictionaryPriorityStrategy:\n      customConfiguration?.dictionaryPriorityStrategy ??\n      DICTIONARY_PRIORITY_STRATEGY,\n\n    /**\n     * Indicates if the application should hot reload the locale configurations when a change is detected.\n     * For example, when a new dictionary is added or updated, the application will update the content tu display in the page.\n     *\n     * The hot reload is only available for clients of the `enterprise` plan.\n     *\n     * Default: false\n     */\n    liveSync: customConfiguration?.liveSync ?? LIVE_SYNC,\n\n    /**\n     * Port of the live sync server\n     *\n     * Default: 4000\n     */\n    liveSyncPort,\n\n    /**\n     * URL of the live sync server in case of remote live sync server\n     *\n     * Default: `http://localhost:${LIVE_SYNC_PORT}`\n     */\n    liveSyncURL:\n      customConfiguration?.liveSyncURL ?? `http://localhost:${liveSyncPort}`,\n  };\n};\n\n/**\n * Build the log section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied log config.\n * @param logFunctions - Optional custom log function overrides (server-only).\n * @returns A fully-defaulted {@link LogConfig}.\n */\nexport const buildLogFields = (\n  customConfiguration?: Partial<LogConfig>,\n  logFunctions?: LogFunctions\n): LogConfig => ({\n  /**\n   * Indicates if the logger is enabled\n   *\n   * Default: 'prefix-no-default'\n   *\n   * If 'default', the logger is enabled and can be used.\n   * If 'verbose', the logger will be enabled and can be used, but will log more information.\n   * If 'disabled', the logger is disabled and cannot be used.\n   */\n  mode: customConfiguration?.mode ?? MODE,\n\n  /**\n   * Prefix of the logger\n   *\n   * Default: '[intlayer]'\n   *\n   * The prefix of the logger.\n   */\n  prefix: customConfiguration?.prefix ?? PREFIX,\n\n  /**\n   * Functions to log\n   */\n  error: logFunctions?.error,\n  log: logFunctions?.log,\n  info: logFunctions?.info,\n  warn: logFunctions?.warn,\n});\n\n// ---------------------------------------------------------------------------\n// Browser configuration builders\n// ---------------------------------------------------------------------------\n\n/**\n * Build a browser-safe {@link BrowserIntlayerConfig} from a raw user config.\n *\n * Applies defaults for every field and strips all server-only or sensitive\n * information (`system`, `content`, `build`, `compiler`, `dictionary`, `ai`,\n * `editor.clientId`, `editor.clientSecret`).\n *\n * This is the browser counterpart of `buildConfigurationFields`. It is safe\n * to call in browser environments because it has no Node.js dependencies.\n *\n * @param customConfig - Optional partial user-supplied Intlayer config.\n * @returns A browser-safe configuration object ready for `window.INTLAYER_CONFIG`.\n *\n * @example\n * ```ts\n * import { buildBrowserConfiguration } from '@intlayer/config/client';\n *\n * window.INTLAYER_CONFIG = buildBrowserConfiguration({\n *   internationalization: { locales: ['en', 'fr'], defaultLocale: 'en' },\n * });\n * ```\n */\nexport const buildBrowserConfiguration = (\n  customConfig?: CustomIntlayerConfig\n): BrowserIntlayerConfig => {\n  const { locales, defaultLocale } = buildInternationalizationFields(\n    customConfig?.internationalization\n  );\n  const routing = buildRoutingFields(customConfig?.routing);\n  const {\n    clientId: _clientId,\n    clientSecret: _clientSecret,\n    ...editorPublic\n  } = buildEditorFields(customConfig?.editor);\n  const { mode, prefix } = buildLogFields(customConfig?.log);\n\n  return {\n    internationalization: { locales, defaultLocale },\n    routing,\n    editor: editorPublic,\n    log: { mode, prefix },\n    metadata: {\n      name: 'Intlayer',\n      version: packageJson.version,\n      doc: 'https://intlayer.org/docs',\n    },\n  };\n};\n\n/**\n * Extract a {@link BrowserIntlayerConfig} from an already-built full\n * {@link IntlayerConfig}.\n *\n * Used by build plugins (`vite-intlayer`, `withIntlayer`) which already hold\n * the full server-side config and need to inject the browser-safe subset at\n * compile time via a bundler `define`.\n *\n * @param config - A fully-built server-side Intlayer configuration.\n * @returns The browser-safe subset of that configuration.\n */\nexport const extractBrowserConfiguration = (\n  config: IntlayerConfig\n): BrowserIntlayerConfig => ({\n  internationalization: {\n    locales: config.internationalization.locales,\n    defaultLocale: config.internationalization.defaultLocale,\n  },\n  routing: {\n    mode: config.routing.mode,\n    storage: config.routing.storage,\n    basePath: config.routing.basePath,\n    rewrite: config.routing.rewrite,\n  },\n  editor: {\n    applicationURL: config.editor.applicationURL,\n    editorURL: config.editor.editorURL,\n    cmsURL: config.editor.cmsURL,\n    backendURL: config.editor.backendURL,\n    port: config.editor.port,\n    enabled: config.editor.enabled,\n    dictionaryPriorityStrategy: config.editor.dictionaryPriorityStrategy,\n    liveSync: config.editor.liveSync,\n    liveSyncPort: config.editor.liveSyncPort,\n    liveSyncURL: config.editor.liveSyncURL,\n  },\n  log: {\n    mode: config.log.mode,\n    prefix: config.log.prefix,\n  },\n  metadata: config.metadata,\n});\n"],"mappings":";;;;;;;;;;;;;;AA0EA,MAAa,mCACX,yBACgC;CAOhC,SAAS,qBAAqB,WAAW;CAWzC,iBACE,qBAAqB,mBACrB,qBAAqB,WACrB;CAUF,YAAY,qBAAqB;CAOjC,eAAe,qBAAqB,iBAAiB;CACtD;;;;;;;AAQD,MAAa,sBACX,wBACkB;CAClB,MAAM,UAAU,qBAAqB,WAAW;AAEhD,QAAO;EAuBL,MAAM,qBAAqB;EAW3B,SAAS,qBAAqB,QAAQ;EAatC,UAAU,qBAAqB;EA6B/B,SAAS,qBAAqB;EAC/B;;;;;;;;;;;;AAaH,MAAa,qBACX,wBACiB;CACjB,MAAM,eAAe,qBAAqB;AAC1C,QAAO;EAQL,gBAAgB,qBAAqB;EASrC,WAAW,qBAAqB;EAKhC,QAAQ,qBAAqB;EAO7B,YAAY,qBAAqB;EAMjC,MAAM,qBAAqB;EAsB3B,SAAS,qBAAqB;EAW9B,UAAU,qBAAqB,YAAY;EAW3C,cAAc,qBAAqB,gBAAgB;EAYnD,4BACE,qBAAqB;EAWvB,UAAU,qBAAqB;EAO/B;EAOA,aACE,qBAAqB,eAAe,oBAAoB;EAC3D;;;;;;;;;AAUH,MAAa,kBACX,qBACA,kBACe;CAUf,MAAM,qBAAqB;CAS3B,QAAQ,qBAAqB,UAAU;CAKvC,OAAO,cAAc;CACrB,KAAK,cAAc;CACnB,MAAM,cAAc;CACpB,MAAM,cAAc;CACrB;;;;;;;;;;;;;;;;;;;;;;;AA4BD,MAAa,6BACX,iBAC0B;CAC1B,MAAM,EAAE,SAAS,kBAAkB,gCACjC,cAAc,qBACf;CACD,MAAM,UAAU,mBAAmB,cAAc,QAAQ;CACzD,MAAM,EACJ,UAAU,WACV,cAAc,eACd,GAAG,iBACD,kBAAkB,cAAc,OAAO;CAC3C,MAAM,EAAE,MAAM,WAAW,eAAe,cAAc,IAAI;AAE1D,QAAO;EACL,sBAAsB;GAAE;GAAS;GAAe;EAChD;EACA,QAAQ;EACR,KAAK;GAAE;GAAM;GAAQ;EACrB,UAAU;GACR,MAAM;GACN,SAASA,kBAAY;GACrB,KAAK;GACN;EACF;;;;;;;;;;;;;AAcH,MAAa,+BACX,YAC2B;CAC3B,sBAAsB;EACpB,SAAS,OAAO,qBAAqB;EACrC,eAAe,OAAO,qBAAqB;EAC5C;CACD,SAAS;EACP,MAAM,OAAO,QAAQ;EACrB,SAAS,OAAO,QAAQ;EACxB,UAAU,OAAO,QAAQ;EACzB,SAAS,OAAO,QAAQ;EACzB;CACD,QAAQ;EACN,gBAAgB,OAAO,OAAO;EAC9B,WAAW,OAAO,OAAO;EACzB,QAAQ,OAAO,OAAO;EACtB,YAAY,OAAO,OAAO;EAC1B,MAAM,OAAO,OAAO;EACpB,SAAS,OAAO,OAAO;EACvB,4BAA4B,OAAO,OAAO;EAC1C,UAAU,OAAO,OAAO;EACxB,cAAc,OAAO,OAAO;EAC5B,aAAa,OAAO,OAAO;EAC5B;CACD,KAAK;EACH,MAAM,OAAO,IAAI;EACjB,QAAQ,OAAO,IAAI;EACpB;CACD,UAAU,OAAO;CAClB"}

package/dist/esm/envVars/envVars.mjs

@@ -0,0 +1,44 @@
+//#region src/envVars/envVars.ts
+/**
+* Converts a list of unused NodeType keys into env-var definitions.
+* Set to `"false"` so bundlers can eliminate the corresponding plugin code.
+*
+* @example
+* formatNodeTypeToEnvVar(['enumeration'])
+* // { 'INTLAYER_NODE_TYPE_ENUMERATION': '"false"' }
+*
+* formatNodeTypeToEnvVar(['enumeration'], true)
+* // { 'process.env.INTLAYER_NODE_TYPE_ENUMERATION': '"false"' }
+*/
+const formatNodeTypeToEnvVar = (nodeTypes, addProcessEnv = false) => nodeTypes.reduce((acc, nodeType) => {
+	acc[addProcessEnv ? `process.env.INTLAYER_NODE_TYPE_${nodeType.toUpperCase()}` : `INTLAYER_NODE_TYPE_${nodeType.toUpperCase()}`] = "\"false\"";
+	return acc;
+}, {});
+/**
+* Returns env-var definitions for the full Intlayer config to be injected at
+* build time. Allows bundlers to dead-code-eliminate unused routing modes,
+* rewrite logic, storage mechanisms, and editor code.
+*
+* @example
+* getConfigEnvVars(config)
+* // { INTLAYER_ROUTING_MODE: '"prefix-no-default"', INTLAYER_ROUTING_REWRITE_RULES: '"false"', ... }
+*
+* getConfigEnvVars(config, true)
+* // { 'process.env.INTLAYER_ROUTING_MODE': '"prefix-no-default"', ... }
+*/
+const getConfigEnvVars = (config, addProcessEnv = false) => {
+	const prefix = addProcessEnv ? "process.env." : "";
+	const { routing, editor } = config;
+	const envVars = { [`${prefix}INTLAYER_ROUTING_MODE`]: JSON.stringify(routing.mode) };
+	if (!routing.rewrite) envVars[`${prefix}INTLAYER_ROUTING_REWRITE_RULES`] = "\"false\"";
+	if (routing.storage.cookies.length === 0) envVars[`${prefix}INTLAYER_ROUTING_STORAGE_COOKIES`] = "\"false\"";
+	if (routing.storage.localStorage.length === 0) envVars[`${prefix}INTLAYER_ROUTING_STORAGE_LOCALSTORAGE`] = "\"false\"";
+	if (routing.storage.sessionStorage.length === 0) envVars[`${prefix}INTLAYER_ROUTING_STORAGE_SESSIONSTORAGE`] = "\"false\"";
+	if (routing.storage.headers.length === 0) envVars[`${prefix}INTLAYER_ROUTING_STORAGE_HEADERS`] = "\"false\"";
+	if (editor?.enabled === false) envVars[`${prefix}INTLAYER_EDITOR_ENABLED`] = "\"false\"";
+	return envVars;
+};
+
+//#endregion
+export { formatNodeTypeToEnvVar, getConfigEnvVars };
+//# sourceMappingURL=envVars.mjs.map

package/dist/esm/envVars/envVars.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"envVars.mjs","names":[],"sources":["../../../src/envVars/envVars.ts"],"sourcesContent":["import type { IntlayerConfig } from '@intlayer/types/config';\n\n/**\n * Converts a list of unused NodeType keys into env-var definitions.\n * Set to `\"false\"` so bundlers can eliminate the corresponding plugin code.\n *\n * @example\n * formatNodeTypeToEnvVar(['enumeration'])\n * // { 'INTLAYER_NODE_TYPE_ENUMERATION': '\"false\"' }\n *\n * formatNodeTypeToEnvVar(['enumeration'], true)\n * // { 'process.env.INTLAYER_NODE_TYPE_ENUMERATION': '\"false\"' }\n */\nexport const formatNodeTypeToEnvVar = (\n  nodeTypes: string[],\n  addProcessEnv: boolean = false\n): Record<string, string> =>\n  nodeTypes.reduce(\n    (acc, nodeType) => {\n      acc[\n        addProcessEnv\n          ? `process.env.INTLAYER_NODE_TYPE_${nodeType.toUpperCase()}`\n          : `INTLAYER_NODE_TYPE_${nodeType.toUpperCase()}`\n      ] = '\"false\"';\n      return acc;\n    },\n    {} as Record<string, string>\n  );\n\n/**\n * Returns env-var definitions for the full Intlayer config to be injected at\n * build time. Allows bundlers to dead-code-eliminate unused routing modes,\n * rewrite logic, storage mechanisms, and editor code.\n *\n * @example\n * getConfigEnvVars(config)\n * // { INTLAYER_ROUTING_MODE: '\"prefix-no-default\"', INTLAYER_ROUTING_REWRITE_RULES: '\"false\"', ... }\n *\n * getConfigEnvVars(config, true)\n * // { 'process.env.INTLAYER_ROUTING_MODE': '\"prefix-no-default\"', ... }\n */\nexport const getConfigEnvVars = (\n  config: IntlayerConfig,\n  addProcessEnv: boolean = false\n): Record<string, string> => {\n  const prefix = addProcessEnv ? 'process.env.' : '';\n  const { routing, editor } = config;\n\n  const envVars: Record<string, string> = {\n    [`${prefix}INTLAYER_ROUTING_MODE`]: JSON.stringify(routing.mode),\n  };\n\n  if (!routing.rewrite) {\n    envVars[`${prefix}INTLAYER_ROUTING_REWRITE_RULES`] = '\"false\"';\n  }\n\n  if (routing.storage.cookies.length === 0) {\n    envVars[`${prefix}INTLAYER_ROUTING_STORAGE_COOKIES`] = '\"false\"';\n  }\n\n  if (routing.storage.localStorage.length === 0) {\n    envVars[`${prefix}INTLAYER_ROUTING_STORAGE_LOCALSTORAGE`] = '\"false\"';\n  }\n\n  if (routing.storage.sessionStorage.length === 0) {\n    envVars[`${prefix}INTLAYER_ROUTING_STORAGE_SESSIONSTORAGE`] = '\"false\"';\n  }\n\n  if (routing.storage.headers.length === 0) {\n    envVars[`${prefix}INTLAYER_ROUTING_STORAGE_HEADERS`] = '\"false\"';\n  }\n\n  if (editor?.enabled === false) {\n    envVars[`${prefix}INTLAYER_EDITOR_ENABLED`] = '\"false\"';\n  }\n\n  return envVars;\n};\n"],"mappings":";;;;;;;;;;;;AAaA,MAAa,0BACX,WACA,gBAAyB,UAEzB,UAAU,QACP,KAAK,aAAa;AACjB,KACE,gBACI,kCAAkC,SAAS,aAAa,KACxD,sBAAsB,SAAS,aAAa,MAC9C;AACJ,QAAO;GAET,EAAE,CACH;;;;;;;;;;;;;AAcH,MAAa,oBACX,QACA,gBAAyB,UACE;CAC3B,MAAM,SAAS,gBAAgB,iBAAiB;CAChD,MAAM,EAAE,SAAS,WAAW;CAE5B,MAAM,UAAkC,GACrC,GAAG,OAAO,yBAAyB,KAAK,UAAU,QAAQ,KAAK,EACjE;AAED,KAAI,CAAC,QAAQ,QACX,SAAQ,GAAG,OAAO,mCAAmC;AAGvD,KAAI,QAAQ,QAAQ,QAAQ,WAAW,EACrC,SAAQ,GAAG,OAAO,qCAAqC;AAGzD,KAAI,QAAQ,QAAQ,aAAa,WAAW,EAC1C,SAAQ,GAAG,OAAO,0CAA0C;AAG9D,KAAI,QAAQ,QAAQ,eAAe,WAAW,EAC5C,SAAQ,GAAG,OAAO,4CAA4C;AAGhE,KAAI,QAAQ,QAAQ,QAAQ,WAAW,EACrC,SAAQ,GAAG,OAAO,qCAAqC;AAGzD,KAAI,QAAQ,YAAY,MACtB,SAAQ,GAAG,OAAO,4BAA4B;AAGhD,QAAO"}

package/dist/esm/envVars/index.mjs

@@ -0,0 +1,3 @@
+import { formatNodeTypeToEnvVar, getConfigEnvVars } from "./envVars.mjs";
+
+export { formatNodeTypeToEnvVar, getConfigEnvVars };

package/dist/esm/utils/cacheDisk.mjs

@@ -3,7 +3,7 @@ import { basename, dirname, join } from "node:path";
 import { mkdir, readFile, rename, rm, stat, unlink, writeFile } from "node:fs/promises";
 import { deserialize, serialize } from "node:v8";
 import { gunzipSync, gzipSync } from "node:zlib";
-import packageJson from "@intlayer/types/package.json" with { type: "json" };
+import configPackageJson from "@intlayer/types/package.json" with { type: "json" };
 
 //#region src/utils/cacheDisk.ts
 const DEFAULTS = { compress: true };
@@ -60,7 +60,7 @@ const cacheDisk = (intlayerConfig, keys, options) => {
 			const maybeObj = deserialized;
 			if (!!maybeObj && typeof maybeObj === "object" && typeof maybeObj.version === "string" && typeof maybeObj.timestamp === "number" && Object.hasOwn(maybeObj, "data")) {
 				const entry = maybeObj;
-				if (entry.version !== packageJson.version) {
+				if (entry.version !== configPackageJson.version) {
 					try {
 						await unlink(filePath);
 					} catch {}
@@ -96,7 +96,7 @@ const cacheDisk = (intlayerConfig, keys, options) => {
 		try {
 			await ensureDir(dirname(filePath));
 			const envelope = {
-				version: packageJson.version,
+				version: configPackageJson.version,
 				timestamp: Date.now(),
 				data: value
 			};
@@ -151,7 +151,7 @@ const cacheDisk = (intlayerConfig, keys, options) => {
 				const maybeObj = deserialize(flag === 1 ? gunzipSync(raw) : raw);
 				if (!!maybeObj && typeof maybeObj === "object" && typeof maybeObj.version === "string" && typeof maybeObj.timestamp === "number" && Object.hasOwn(maybeObj, "data")) {
 					const entry = maybeObj;
-					if (entry.version !== packageJson.version) return false;
+					if (entry.version !== configPackageJson.version) return false;
 					if (typeof maxTimeMs === "number" && maxTimeMs > 0) {
 						if (Date.now() - entry.timestamp > maxTimeMs) return false;
 					}

package/dist/esm/utils/cacheDisk.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cacheDisk.mjs","names":["configPackageJson"],"sources":["../../../src/utils/cacheDisk.ts"],"sourcesContent":["import {\n  mkdir,\n  readFile,\n  rename,\n  rm,\n  stat,\n  unlink,\n  writeFile,\n} from 'node:fs/promises';\nimport { basename, dirname, join } from 'node:path';\nimport { deserialize, serialize } from 'node:v8';\nimport { gunzipSync, gzipSync } from 'node:zlib';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport configPackageJson from '@intlayer/types/package.json' with {\n  type: 'json',\n};\nimport { type CacheKey, clearAllCache, computeKeyId } from './cacheMemory';\n\n/** ------------------------- Persistence layer ------------------------- **/\n\n/** Cache envelope structure stored on disk */\ntype CacheEnvelope = {\n  /** Version of the config package (for cache invalidation) */\n  version: string;\n  /** Timestamp when the cache entry was created (in milliseconds) */\n  timestamp: number;\n  /** Data payload (the actual cached value) */\n  data: unknown;\n};\n\ntype LocalCacheOptions = {\n  /** Preferred new option name */\n  persistent?: boolean;\n  /** Time-to-live in ms; if expired, disk entry is ignored. */\n  ttlMs?: number;\n  /** Max age in ms based on stored creation timestamp; invalidates on exceed. */\n  maxTimeMs?: number;\n  /** Optional namespace to separate different logical caches. */\n  namespace?: string;\n  /** Gzip values on disk (on by default for blobs > 1KB). */\n  compress?: boolean;\n};\n\nconst DEFAULTS: Required<Pick<LocalCacheOptions, 'compress'>> = {\n  compress: true,\n};\n\nconst ensureDir = async (dir: string) => {\n  await mkdir(dir, { recursive: true });\n};\n\nconst atomicWriteFile = async (\n  file: string,\n  data: Buffer,\n  tempDir?: string\n) => {\n  if (tempDir) {\n    try {\n      await ensureDir(tempDir);\n    } catch {}\n  }\n\n  const tempFileName = `${basename(file)}.tmp-${process.pid}-${Math.random().toString(36).slice(2)}`;\n  const tmp = tempDir\n    ? join(tempDir, tempFileName)\n    : `${file}.tmp-${process.pid}-${Math.random().toString(36).slice(2)}`;\n  try {\n    await writeFile(tmp, data);\n    await rename(tmp, file);\n  } catch (error) {\n    try {\n      await rm(tmp, { force: true });\n    } catch {\n      // Ignore\n    }\n    throw error;\n  }\n};\n\nconst shouldUseCompression = (buf: Buffer, force?: boolean) =>\n  force === true || (force !== false && buf.byteLength > 1024);\n\n/** Derive on-disk path from config dir + namespace + key id. */\nconst cachePath = (cacheDir: string, id: string, ns?: string) =>\n  join(cacheDir, ns ? join(ns, id) : id);\n\n/** ------------------------- Local cache facade ------------------------- **/\n\nconst cacheMap = new Map<string, any>();\n\n/** Clears the in-memory portion of the disk cache without touching disk files. */\nexport const clearDiskCacheMemory = (): void => {\n  cacheMap.clear();\n};\n\nexport const cacheDisk = (\n  intlayerConfig: IntlayerConfig,\n  keys: CacheKey[],\n  options?: LocalCacheOptions\n) => {\n  const { cacheDir, tempDir } = intlayerConfig.system;\n  const buildCacheEnabled = intlayerConfig.build.cache ?? true;\n  const persistent =\n    options?.persistent === true ||\n    (typeof options?.persistent === 'undefined' && buildCacheEnabled);\n\n  const { compress, ttlMs, maxTimeMs, namespace } = {\n    ...DEFAULTS,\n    ...options,\n  };\n\n  // single stable id for this key tuple (works for both memory & disk)\n  const id = computeKeyId(keys);\n  const filePath = cachePath(cacheDir, id, namespace);\n\n  const readFromDisk = async (): Promise<unknown | undefined> => {\n    try {\n      const statValue = await stat(filePath).catch(() => undefined);\n\n      if (!statValue) return undefined;\n\n      if (typeof ttlMs === 'number' && ttlMs > 0) {\n        const age = Date.now() - statValue.mtimeMs;\n        if (age > ttlMs) return undefined;\n      }\n      let raw = await readFile(filePath);\n      // header: 1 byte flag (0x00 raw, 0x01 gzip)\n      const flag = raw[0];\n\n      raw = raw.subarray(1);\n\n      const payload = flag === 0x01 ? gunzipSync(raw) : raw;\n      const deserialized = deserialize(payload) as unknown;\n\n      let value: unknown;\n      const maybeObj = deserialized as Record<string, unknown> | null;\n      const isEnvelope =\n        !!maybeObj &&\n        typeof maybeObj === 'object' &&\n        typeof (maybeObj as any).version === 'string' &&\n        typeof (maybeObj as any).timestamp === 'number' &&\n        Object.hasOwn(maybeObj, 'data');\n\n      if (isEnvelope) {\n        const entry = maybeObj as CacheEnvelope;\n\n        if (entry.version !== configPackageJson.version) {\n          try {\n            await unlink(filePath);\n          } catch {}\n          return undefined;\n        }\n\n        if (typeof maxTimeMs === 'number' && maxTimeMs > 0) {\n          const age = Date.now() - entry.timestamp;\n          if (age > maxTimeMs) {\n            try {\n              await unlink(filePath);\n            } catch {}\n            return undefined;\n          }\n        }\n\n        value = entry.data;\n      } else {\n        // Backward compatibility: old entries had raw serialized value.\n        if (typeof maxTimeMs === 'number' && maxTimeMs > 0) {\n          const age = Date.now() - statValue.mtimeMs;\n          if (age > maxTimeMs) {\n            try {\n              await unlink(filePath);\n            } catch {}\n            return undefined;\n          }\n        }\n        value = deserialized;\n      }\n\n      // hydrate memory cache as well\n      cacheMap.set(id, value);\n      return value;\n    } catch {\n      return undefined;\n    }\n  };\n\n  const writeToDisk = async (value: unknown) => {\n    try {\n      await ensureDir(dirname(filePath));\n      const envelope: CacheEnvelope = {\n        version: configPackageJson.version,\n        timestamp: Date.now(),\n        data: value,\n      };\n      const payload = Buffer.from(serialize(envelope));\n\n      const gz = shouldUseCompression(payload, compress)\n        ? gzipSync(payload)\n        : payload;\n\n      // prepend a 1-byte header indicating compression\n      const buf = Buffer.concat([\n        Buffer.from([gz === payload ? 0x00 : 0x01]),\n        gz,\n      ]);\n\n      await atomicWriteFile(filePath, buf, tempDir);\n    } catch {\n      // swallow disk errors for cache writes\n    }\n  };\n\n  return {\n    /** In-memory first, then disk (if enabled), otherwise undefined. */\n    get: async <T>(): Promise<T | undefined> => {\n      const mem = cacheMap.get(id);\n\n      if (mem !== undefined) return mem as T;\n\n      if (persistent && buildCacheEnabled) {\n        return (await readFromDisk()) as T | undefined;\n      }\n      return undefined;\n    },\n    /** Sets in-memory (always) and persists to disk if enabled. */\n    set: async (value: unknown): Promise<void> => {\n      cacheMap.set(id, value);\n\n      if (persistent && buildCacheEnabled) {\n        await writeToDisk(value);\n      }\n    },\n    /** Clears only this entry from memory and disk. */\n    clear: async (): Promise<void> => {\n      cacheMap.delete(id);\n\n      try {\n        await unlink(filePath);\n      } catch {}\n    },\n    /** Clears ALL cached entries (memory Map and entire cacheDir namespace if persistent). */\n    clearAll: async (): Promise<void> => {\n      clearAllCache();\n      if (persistent && buildCacheEnabled) {\n        // remove only the current namespace (if provided), else the root dir\n        const base = namespace ? join(cacheDir, namespace) : cacheDir;\n\n        try {\n          await rm(base, { recursive: true, force: true });\n        } catch {}\n\n        try {\n          await mkdir(base, { recursive: true });\n        } catch {}\n      }\n    },\n    /** Expose the computed id (useful if you want to key other structures). */\n    isValid: async (): Promise<boolean> => {\n      const cachedValue = cacheMap.get(id);\n      if (cachedValue !== undefined) return true;\n\n      // If persistence is disabled or build cache disabled, only memory can be valid\n      if (!persistent || !buildCacheEnabled) return false;\n\n      try {\n        const statValue = await stat(filePath).catch(() => undefined);\n        if (!statValue) return false;\n\n        if (typeof ttlMs === 'number' && ttlMs > 0) {\n          const age = Date.now() - statValue.mtimeMs;\n          if (age > ttlMs) return false;\n        }\n\n        let raw = await readFile(filePath);\n        const flag = raw[0];\n        raw = raw.subarray(1);\n        const payload = flag === 0x01 ? gunzipSync(raw) : raw;\n        const deserialized = deserialize(payload) as unknown;\n\n        const maybeObj = deserialized as Record<string, unknown> | null;\n        const isEnvelope =\n          !!maybeObj &&\n          typeof maybeObj === 'object' &&\n          typeof maybeObj.version === 'string' &&\n          typeof maybeObj.timestamp === 'number' &&\n          Object.hasOwn(maybeObj, 'data');\n\n        if (isEnvelope) {\n          const entry = maybeObj as CacheEnvelope;\n          if (entry.version !== configPackageJson.version) return false;\n\n          if (typeof maxTimeMs === 'number' && maxTimeMs > 0) {\n            const age = Date.now() - entry.timestamp;\n            if (age > maxTimeMs) return false;\n          }\n          return true;\n        }\n\n        if (typeof maxTimeMs === 'number' && maxTimeMs > 0) {\n          const age = Date.now() - statValue.mtimeMs;\n          if (age > maxTimeMs) return false;\n        }\n        return true;\n      } catch {\n        return false;\n      }\n    },\n    /** Expose the computed id (useful if you want to key other structures). */\n    id,\n    /** Expose the absolute file path for debugging. */\n    filePath,\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"cacheDisk.mjs","names":[],"sources":["../../../src/utils/cacheDisk.ts"],"sourcesContent":["import {\n  mkdir,\n  readFile,\n  rename,\n  rm,\n  stat,\n  unlink,\n  writeFile,\n} from 'node:fs/promises';\nimport { basename, dirname, join } from 'node:path';\nimport { deserialize, serialize } from 'node:v8';\nimport { gunzipSync, gzipSync } from 'node:zlib';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport configPackageJson from '@intlayer/types/package.json' with {\n  type: 'json',\n};\nimport { type CacheKey, clearAllCache, computeKeyId } from './cacheMemory';\n\n/** ------------------------- Persistence layer ------------------------- **/\n\n/** Cache envelope structure stored on disk */\ntype CacheEnvelope = {\n  /** Version of the config package (for cache invalidation) */\n  version: string;\n  /** Timestamp when the cache entry was created (in milliseconds) */\n  timestamp: number;\n  /** Data payload (the actual cached value) */\n  data: unknown;\n};\n\ntype LocalCacheOptions = {\n  /** Preferred new option name */\n  persistent?: boolean;\n  /** Time-to-live in ms; if expired, disk entry is ignored. */\n  ttlMs?: number;\n  /** Max age in ms based on stored creation timestamp; invalidates on exceed. */\n  maxTimeMs?: number;\n  /** Optional namespace to separate different logical caches. */\n  namespace?: string;\n  /** Gzip values on disk (on by default for blobs > 1KB). */\n  compress?: boolean;\n};\n\nconst DEFAULTS: Required<Pick<LocalCacheOptions, 'compress'>> = {\n  compress: true,\n};\n\nconst ensureDir = async (dir: string) => {\n  await mkdir(dir, { recursive: true });\n};\n\nconst atomicWriteFile = async (\n  file: string,\n  data: Buffer,\n  tempDir?: string\n) => {\n  if (tempDir) {\n    try {\n      await ensureDir(tempDir);\n    } catch {}\n  }\n\n  const tempFileName = `${basename(file)}.tmp-${process.pid}-${Math.random().toString(36).slice(2)}`;\n  const tmp = tempDir\n    ? join(tempDir, tempFileName)\n    : `${file}.tmp-${process.pid}-${Math.random().toString(36).slice(2)}`;\n  try {\n    await writeFile(tmp, data);\n    await rename(tmp, file);\n  } catch (error) {\n    try {\n      await rm(tmp, { force: true });\n    } catch {\n      // Ignore\n    }\n    throw error;\n  }\n};\n\nconst shouldUseCompression = (buf: Buffer, force?: boolean) =>\n  force === true || (force !== false && buf.byteLength > 1024);\n\n/** Derive on-disk path from config dir + namespace + key id. */\nconst cachePath = (cacheDir: string, id: string, ns?: string) =>\n  join(cacheDir, ns ? join(ns, id) : id);\n\n/** ------------------------- Local cache facade ------------------------- **/\n\nconst cacheMap = new Map<string, any>();\n\n/** Clears the in-memory portion of the disk cache without touching disk files. */\nexport const clearDiskCacheMemory = (): void => {\n  cacheMap.clear();\n};\n\nexport const cacheDisk = (\n  intlayerConfig: IntlayerConfig,\n  keys: CacheKey[],\n  options?: LocalCacheOptions\n) => {\n  const { cacheDir, tempDir } = intlayerConfig.system;\n  const buildCacheEnabled = intlayerConfig.build.cache ?? true;\n  const persistent =\n    options?.persistent === true ||\n    (typeof options?.persistent === 'undefined' && buildCacheEnabled);\n\n  const { compress, ttlMs, maxTimeMs, namespace } = {\n    ...DEFAULTS,\n    ...options,\n  };\n\n  // single stable id for this key tuple (works for both memory & disk)\n  const id = computeKeyId(keys);\n  const filePath = cachePath(cacheDir, id, namespace);\n\n  const readFromDisk = async (): Promise<unknown | undefined> => {\n    try {\n      const statValue = await stat(filePath).catch(() => undefined);\n\n      if (!statValue) return undefined;\n\n      if (typeof ttlMs === 'number' && ttlMs > 0) {\n        const age = Date.now() - statValue.mtimeMs;\n        if (age > ttlMs) return undefined;\n      }\n      let raw = await readFile(filePath);\n      // header: 1 byte flag (0x00 raw, 0x01 gzip)\n      const flag = raw[0];\n\n      raw = raw.subarray(1);\n\n      const payload = flag === 0x01 ? gunzipSync(raw) : raw;\n      const deserialized = deserialize(payload) as unknown;\n\n      let value: unknown;\n      const maybeObj = deserialized as Record<string, unknown> | null;\n      const isEnvelope =\n        !!maybeObj &&\n        typeof maybeObj === 'object' &&\n        typeof (maybeObj as any).version === 'string' &&\n        typeof (maybeObj as any).timestamp === 'number' &&\n        Object.hasOwn(maybeObj, 'data');\n\n      if (isEnvelope) {\n        const entry = maybeObj as CacheEnvelope;\n\n        if (entry.version !== configPackageJson.version) {\n          try {\n            await unlink(filePath);\n          } catch {}\n          return undefined;\n        }\n\n        if (typeof maxTimeMs === 'number' && maxTimeMs > 0) {\n          const age = Date.now() - entry.timestamp;\n          if (age > maxTimeMs) {\n            try {\n              await unlink(filePath);\n            } catch {}\n            return undefined;\n          }\n        }\n\n        value = entry.data;\n      } else {\n        // Backward compatibility: old entries had raw serialized value.\n        if (typeof maxTimeMs === 'number' && maxTimeMs > 0) {\n          const age = Date.now() - statValue.mtimeMs;\n          if (age > maxTimeMs) {\n            try {\n              await unlink(filePath);\n            } catch {}\n            return undefined;\n          }\n        }\n        value = deserialized;\n      }\n\n      // hydrate memory cache as well\n      cacheMap.set(id, value);\n      return value;\n    } catch {\n      return undefined;\n    }\n  };\n\n  const writeToDisk = async (value: unknown) => {\n    try {\n      await ensureDir(dirname(filePath));\n      const envelope: CacheEnvelope = {\n        version: configPackageJson.version,\n        timestamp: Date.now(),\n        data: value,\n      };\n      const payload = Buffer.from(serialize(envelope));\n\n      const gz = shouldUseCompression(payload, compress)\n        ? gzipSync(payload)\n        : payload;\n\n      // prepend a 1-byte header indicating compression\n      const buf = Buffer.concat([\n        Buffer.from([gz === payload ? 0x00 : 0x01]),\n        gz,\n      ]);\n\n      await atomicWriteFile(filePath, buf, tempDir);\n    } catch {\n      // swallow disk errors for cache writes\n    }\n  };\n\n  return {\n    /** In-memory first, then disk (if enabled), otherwise undefined. */\n    get: async <T>(): Promise<T | undefined> => {\n      const mem = cacheMap.get(id);\n\n      if (mem !== undefined) return mem as T;\n\n      if (persistent && buildCacheEnabled) {\n        return (await readFromDisk()) as T | undefined;\n      }\n      return undefined;\n    },\n    /** Sets in-memory (always) and persists to disk if enabled. */\n    set: async (value: unknown): Promise<void> => {\n      cacheMap.set(id, value);\n\n      if (persistent && buildCacheEnabled) {\n        await writeToDisk(value);\n      }\n    },\n    /** Clears only this entry from memory and disk. */\n    clear: async (): Promise<void> => {\n      cacheMap.delete(id);\n\n      try {\n        await unlink(filePath);\n      } catch {}\n    },\n    /** Clears ALL cached entries (memory Map and entire cacheDir namespace if persistent). */\n    clearAll: async (): Promise<void> => {\n      clearAllCache();\n      if (persistent && buildCacheEnabled) {\n        // remove only the current namespace (if provided), else the root dir\n        const base = namespace ? join(cacheDir, namespace) : cacheDir;\n\n        try {\n          await rm(base, { recursive: true, force: true });\n        } catch {}\n\n        try {\n          await mkdir(base, { recursive: true });\n        } catch {}\n      }\n    },\n    /** Expose the computed id (useful if you want to key other structures). */\n    isValid: async (): Promise<boolean> => {\n      const cachedValue = cacheMap.get(id);\n      if (cachedValue !== undefined) return true;\n\n      // If persistence is disabled or build cache disabled, only memory can be valid\n      if (!persistent || !buildCacheEnabled) return false;\n\n      try {\n        const statValue = await stat(filePath).catch(() => undefined);\n        if (!statValue) return false;\n\n        if (typeof ttlMs === 'number' && ttlMs > 0) {\n          const age = Date.now() - statValue.mtimeMs;\n          if (age > ttlMs) return false;\n        }\n\n        let raw = await readFile(filePath);\n        const flag = raw[0];\n        raw = raw.subarray(1);\n        const payload = flag === 0x01 ? gunzipSync(raw) : raw;\n        const deserialized = deserialize(payload) as unknown;\n\n        const maybeObj = deserialized as Record<string, unknown> | null;\n        const isEnvelope =\n          !!maybeObj &&\n          typeof maybeObj === 'object' &&\n          typeof maybeObj.version === 'string' &&\n          typeof maybeObj.timestamp === 'number' &&\n          Object.hasOwn(maybeObj, 'data');\n\n        if (isEnvelope) {\n          const entry = maybeObj as CacheEnvelope;\n          if (entry.version !== configPackageJson.version) return false;\n\n          if (typeof maxTimeMs === 'number' && maxTimeMs > 0) {\n            const age = Date.now() - entry.timestamp;\n            if (age > maxTimeMs) return false;\n          }\n          return true;\n        }\n\n        if (typeof maxTimeMs === 'number' && maxTimeMs > 0) {\n          const age = Date.now() - statValue.mtimeMs;\n          if (age > maxTimeMs) return false;\n        }\n        return true;\n      } catch {\n        return false;\n      }\n    },\n    /** Expose the computed id (useful if you want to key other structures). */\n    id,\n    /** Expose the absolute file path for debugging. */\n    filePath,\n  };\n};\n"],"mappings":"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"}

package/dist/esm/utils/extractErrorMessage.mjs

@@ -1,10 +1,10 @@
 //#region src/utils/extractErrorMessage.ts
 const extractErrorMessage = (error) => {
-	const trimToSingleLine = (text) => text.split(/\r?\n/).map((s) => s.trim()).filter(Boolean)[0] ?? text.trim();
+	const trimToSingleLine = (text) => text.split(/\r?\n/).map((stringValue) => stringValue.trim()).filter(Boolean)[0] ?? text.trim();
 	const looksLikeJson = (value) => {
-		const s = value.trim();
-		if (!s) return false;
-		const first = s[0];
+		const stringValue = value.trim();
+		if (!stringValue) return false;
+		const first = stringValue[0];
 		return first === "{" || first === "[" || first === "\"";
 	};
 	const sanitizeUnexpectedTokenMessage = (text) => {
@@ -21,6 +21,14 @@ const extractErrorMessage = (error) => {
 		if (!value || typeof value !== "object") return void 0;
 		if (seen.has(value)) return void 0;
 		seen.add(value);
+		if (Array.isArray(value)) {
+			for (const item of value) {
+				const fromItem = pickFieldsFromObject(item, seen);
+				if (fromItem) return fromItem;
+				if (typeof item?.message === "string") return item.message;
+			}
+			return;
+		}
 		const obj = value;
 		if (typeof obj.message === "string" && obj.message.trim()) return obj.message;
 		if (typeof obj.error_description === "string" && obj.error_description.trim()) return obj.error_description;

package/dist/esm/utils/extractErrorMessage.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"extractErrorMessage.mjs","names":[],"sources":["../../../src/utils/extractErrorMessage.ts"],"sourcesContent":["export const extractErrorMessage = (error: unknown): string => {\n  const trimToSingleLine = (text: string): string =>\n    text\n      .split(/\\r?\\n/)\n      .map((s) => s.trim())\n      .filter(Boolean)[0] ?? text.trim();\n\n  const looksLikeJson = (value: string): boolean => {\n    const s = value.trim();\n    if (!s) return false;\n    const first = s[0];\n    return first === '{' || first === '[' || first === '\"';\n  };\n\n  const sanitizeUnexpectedTokenMessage = (text: string): string => {\n    // If the text mentions an invalid JSON parse, try to extract the meaningful part\n    const t = text.trim();\n    if (/Unexpected token/i.test(t) && /not valid JSON/i.test(t)) {\n      const quoted = t.match(/\"([^\"]+)\"/);\n      if (quoted?.[1]) return quoted[1];\n      // Fallback: drop the leading parser error description\n      const afterColon = t.split(':').slice(1).join(':').trim();\n      if (afterColon) return afterColon;\n    }\n    return t;\n  };\n\n  const pickFieldsFromObject = (\n    value: unknown,\n    seen: Set<unknown>\n  ): string | undefined => {\n    if (!value || typeof value !== 'object') return undefined;\n    if (seen.has(value)) return undefined;\n    seen.add(value);\n\n    const obj = value as Record<string, unknown>;\n\n    // Check for message first (highest priority)\n    if (typeof obj.message === 'string' && obj.message.trim()) {\n      return obj.message;\n    }\n\n    // Check for error_description\n    if (\n      typeof obj.error_description === 'string' &&\n      obj.error_description.trim()\n    ) {\n      return obj.error_description;\n    }\n\n    // Check for error\n    if (typeof obj.error === 'string' && obj.error.trim()) {\n      return obj.error;\n    }\n\n    // Handle title and code combination\n    const title = typeof obj.title === 'string' ? obj.title.trim() : '';\n    const code = typeof obj.code === 'string' ? obj.code.trim() : '';\n\n    if (title && code) {\n      return `${title} (${code})`;\n    }\n\n    if (title) {\n      return title;\n    }\n\n    if (code) {\n      return code;\n    }\n\n    // Check for statusText\n    if (typeof obj.statusText === 'string' && obj.statusText.trim()) {\n      return obj.statusText;\n    }\n\n    // Common nested structures (Axios/Fetch-like)\n    const response = obj.response as Record<string, unknown> | undefined;\n    if (response && typeof response === 'object') {\n      const data = response.data as unknown;\n      const fromData = pickFieldsFromObject(data, seen);\n      if (fromData) return fromData;\n    }\n\n    const data = obj.data as unknown;\n    const fromData = pickFieldsFromObject(data, seen);\n    if (fromData) return fromData;\n\n    // Nested cause chain\n    const cause = (obj as { cause?: unknown }).cause;\n    const fromCause =\n      pickFieldsFromObject(cause, seen) ??\n      (typeof (cause as any)?.message === 'string'\n        ? (cause as any).message\n        : undefined);\n    if (fromCause) return fromCause;\n\n    // Arrays of errors\n    const errors = obj.errors as unknown;\n    if (Array.isArray(errors)) {\n      for (const item of errors) {\n        const fromItem = pickFieldsFromObject(item, seen);\n        if (fromItem) return fromItem;\n        if (typeof (item as any)?.message === 'string')\n          return (item as any).message;\n      }\n    }\n\n    return undefined;\n  };\n\n  const tryParseJsonString = (maybeJson: string): string | undefined => {\n    if (!looksLikeJson(maybeJson)) return undefined;\n    try {\n      const parsed = JSON.parse(maybeJson);\n      const picked = pickFieldsFromObject(parsed, new Set());\n      if (picked) return picked;\n      if (typeof parsed === 'string') return parsed;\n      return undefined;\n    } catch {\n      return undefined;\n    }\n  };\n\n  if (typeof error === 'string') {\n    const cleaned = sanitizeUnexpectedTokenMessage(error);\n    return tryParseJsonString(cleaned) ?? trimToSingleLine(cleaned);\n  }\n\n  if (error && typeof error === 'object') {\n    // Native Error instance\n    if (error instanceof Error) {\n      const cleaned = sanitizeUnexpectedTokenMessage(error.message);\n      const fromMessage = tryParseJsonString(cleaned);\n      if (fromMessage) return trimToSingleLine(fromMessage);\n      // Dive into cause when present\n      const fromCause = extractErrorMessage(error.cause as unknown);\n      if (fromCause && fromCause !== 'An unknown error occurred')\n        return trimToSingleLine(fromCause);\n      return trimToSingleLine(cleaned);\n    }\n\n    // Generic object\n    const seen = new Set<unknown>();\n    const fromObject = pickFieldsFromObject(error, seen);\n    if (fromObject) {\n      const cleaned = sanitizeUnexpectedTokenMessage(fromObject);\n      return tryParseJsonString(cleaned) ?? trimToSingleLine(cleaned);\n    }\n\n    try {\n      const serialized = JSON.stringify(error);\n      return trimToSingleLine(serialized);\n    } catch {\n      return trimToSingleLine(String(error));\n    }\n  }\n\n  return 'An unknown error occurred';\n};\n"],"mappings":"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"}
+{"version":3,"file":"extractErrorMessage.mjs","names":[],"sources":["../../../src/utils/extractErrorMessage.ts"],"sourcesContent":["export const extractErrorMessage = (error: unknown): string => {\n  const trimToSingleLine = (text: string): string =>\n    text\n      .split(/\\r?\\n/)\n      .map((stringValue) => stringValue.trim())\n      .filter(Boolean)[0] ?? text.trim();\n\n  const looksLikeJson = (value: string): boolean => {\n    const stringValue = value.trim();\n\n    if (!stringValue) return false;\n    const first = stringValue[0];\n    return first === '{' || first === '[' || first === '\"';\n  };\n\n  const sanitizeUnexpectedTokenMessage = (text: string): string => {\n    // If the text mentions an invalid JSON parse, try to extract the meaningful part\n    const t = text.trim();\n\n    if (/Unexpected token/i.test(t) && /not valid JSON/i.test(t)) {\n      const quoted = t.match(/\"([^\"]+)\"/);\n\n      if (quoted?.[1]) return quoted[1];\n      // Fallback: drop the leading parser error description\n      const afterColon = t.split(':').slice(1).join(':').trim();\n\n      if (afterColon) return afterColon;\n    }\n    return t;\n  };\n\n  const pickFieldsFromObject = (\n    value: unknown,\n    seen: Set<unknown>\n  ): string | undefined => {\n    if (!value || typeof value !== 'object') return undefined;\n\n    if (seen.has(value)) return undefined;\n\n    seen.add(value);\n\n    // If the value itself is an array (e.g. ZodError.issues), iterate its items\n\n    if (Array.isArray(value)) {\n      for (const item of value) {\n        const fromItem = pickFieldsFromObject(item, seen);\n\n        if (fromItem) return fromItem;\n\n        if (typeof (item as any)?.message === 'string')\n          return (item as any).message;\n      }\n      return undefined;\n    }\n\n    const obj = value as Record<string, unknown>;\n\n    // Check for message first (highest priority)\n\n    if (typeof obj.message === 'string' && obj.message.trim()) {\n      return obj.message;\n    }\n\n    // Check for error_description\n\n    if (\n      typeof obj.error_description === 'string' &&\n      obj.error_description.trim()\n    ) {\n      return obj.error_description;\n    }\n\n    // Check for error\n\n    if (typeof obj.error === 'string' && obj.error.trim()) {\n      return obj.error;\n    }\n\n    // Handle title and code combination\n    const title = typeof obj.title === 'string' ? obj.title.trim() : '';\n    const code = typeof obj.code === 'string' ? obj.code.trim() : '';\n\n    if (title && code) {\n      return `${title} (${code})`;\n    }\n\n    if (title) {\n      return title;\n    }\n\n    if (code) {\n      return code;\n    }\n\n    // Check for statusText\n\n    if (typeof obj.statusText === 'string' && obj.statusText.trim()) {\n      return obj.statusText;\n    }\n\n    // Common nested structures (Axios/Fetch-like)\n    const response = obj.response as Record<string, unknown> | undefined;\n\n    if (response && typeof response === 'object') {\n      const data = response.data as unknown;\n      const fromData = pickFieldsFromObject(data, seen);\n\n      if (fromData) return fromData;\n    }\n\n    const data = obj.data as unknown;\n    const fromData = pickFieldsFromObject(data, seen);\n\n    if (fromData) return fromData;\n\n    // Nested cause chain\n    const cause = (obj as { cause?: unknown }).cause;\n    const fromCause =\n      pickFieldsFromObject(cause, seen) ??\n      (typeof (cause as any)?.message === 'string'\n        ? (cause as any).message\n        : undefined);\n\n    if (fromCause) return fromCause;\n\n    // Arrays of errors\n    const errors = obj.errors as unknown;\n\n    if (Array.isArray(errors)) {\n      for (const item of errors) {\n        const fromItem = pickFieldsFromObject(item, seen);\n\n        if (fromItem) return fromItem;\n\n        if (typeof (item as any)?.message === 'string')\n          return (item as any).message;\n      }\n    }\n\n    return undefined;\n  };\n\n  const tryParseJsonString = (maybeJson: string): string | undefined => {\n    if (!looksLikeJson(maybeJson)) return undefined;\n    try {\n      const parsed = JSON.parse(maybeJson);\n      const picked = pickFieldsFromObject(parsed, new Set());\n\n      if (picked) return picked;\n\n      if (typeof parsed === 'string') return parsed;\n      return undefined;\n    } catch {\n      return undefined;\n    }\n  };\n\n  if (typeof error === 'string') {\n    const cleaned = sanitizeUnexpectedTokenMessage(error);\n    return tryParseJsonString(cleaned) ?? trimToSingleLine(cleaned);\n  }\n\n  if (error && typeof error === 'object') {\n    // Native Error instance\n\n    if (error instanceof Error) {\n      const cleaned = sanitizeUnexpectedTokenMessage(error.message);\n      const fromMessage = tryParseJsonString(cleaned);\n\n      if (fromMessage) return trimToSingleLine(fromMessage);\n      // Dive into cause when present\n      const fromCause = extractErrorMessage(error.cause as unknown);\n\n      if (fromCause && fromCause !== 'An unknown error occurred')\n        return trimToSingleLine(fromCause);\n      return trimToSingleLine(cleaned);\n    }\n\n    // Generic object\n    const seen = new Set<unknown>();\n    const fromObject = pickFieldsFromObject(error, seen);\n\n    if (fromObject) {\n      const cleaned = sanitizeUnexpectedTokenMessage(fromObject);\n      return tryParseJsonString(cleaned) ?? trimToSingleLine(cleaned);\n    }\n\n    try {\n      const serialized = JSON.stringify(error);\n      return trimToSingleLine(serialized);\n    } catch {\n      return trimToSingleLine(String(error));\n    }\n  }\n\n  return 'An unknown error occurred';\n};\n"],"mappings":"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"}

package/dist/esm/utils/getUsedNodeTypes.mjs

@@ -0,0 +1,51 @@
+import { PLUGIN_NODE_TYPES } from "@intlayer/types/nodeType";
+
+//#region src/utils/getUsedNodeTypes.ts
+/** Recursively collect every `nodeType` string found in a value. */
+const collectNodeTypes = (value, result) => {
+	if (!value || typeof value !== "object") return;
+	if (Array.isArray(value)) {
+		for (const item of value) collectNodeTypes(item, result);
+		return;
+	}
+	const obj = value;
+	if (typeof obj.nodeType === "string") result.add(obj.nodeType);
+	for (const key of Object.keys(obj)) collectNodeTypes(obj[key], result);
+};
+/**
+* Returns the set of NodeType strings actually used across the given
+* built dictionaries.
+*
+* @example
+* const used = getUsedNodeTypes(getDictionaries(config));
+* // Set { 'translation', 'enumeration' }
+*/
+const getUsedNodeTypes = (dictionaries) => {
+	const result = /* @__PURE__ */ new Set();
+	const dicts = Array.isArray(dictionaries) ? dictionaries : Object.values(dictionaries);
+	for (const dict of dicts) collectNodeTypes(dict.content, result);
+	return [...result];
+};
+const getUnusedNodeTypes = (dictionaries) => {
+	const usedNodeTypes = getUsedNodeTypes(dictionaries);
+	return PLUGIN_NODE_TYPES.filter((nodeType) => !usedNodeTypes.includes(nodeType));
+};
+const getUsedNodeTypesAsync = async (dictionaries) => {
+	const dictionariesArray = Array.isArray(dictionaries) ? dictionaries : Object.values(dictionaries);
+	const results = await Promise.all(dictionariesArray.map(async (dictionary) => {
+		const result = /* @__PURE__ */ new Set();
+		collectNodeTypes(dictionary.content, result);
+		return result;
+	}));
+	const finalResult = /* @__PURE__ */ new Set();
+	for (const res of results) for (const val of res) finalResult.add(val);
+	return [...finalResult];
+};
+const getUnusedNodeTypesAsync = async (dictionaries) => {
+	const usedNodeTypes = await getUsedNodeTypesAsync(dictionaries);
+	return PLUGIN_NODE_TYPES.filter((nodeType) => !usedNodeTypes.includes(nodeType));
+};
+
+//#endregion
+export { getUnusedNodeTypes, getUnusedNodeTypesAsync, getUsedNodeTypes, getUsedNodeTypesAsync };
+//# sourceMappingURL=getUsedNodeTypes.mjs.map

package/dist/esm/utils/getUsedNodeTypes.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getUsedNodeTypes.mjs","names":[],"sources":["../../../src/utils/getUsedNodeTypes.ts"],"sourcesContent":["import type { Dictionary } from '@intlayer/types/dictionary';\nimport { PLUGIN_NODE_TYPES } from '@intlayer/types/nodeType';\n\nexport type PluginNodeType = (typeof PLUGIN_NODE_TYPES)[number];\n\n/** Recursively collect every `nodeType` string found in a value. */\nconst collectNodeTypes = (value: unknown, result: Set<string>): void => {\n  if (!value || typeof value !== 'object') return;\n\n  if (Array.isArray(value)) {\n    for (const item of value) collectNodeTypes(item, result);\n    return;\n  }\n\n  const obj = value as Record<string, unknown>;\n\n  if (typeof obj.nodeType === 'string') {\n    result.add(obj.nodeType);\n  }\n\n  for (const key of Object.keys(obj)) {\n    collectNodeTypes(obj[key], result);\n  }\n};\n\n/**\n * Returns the set of NodeType strings actually used across the given\n * built dictionaries.\n *\n * @example\n * const used = getUsedNodeTypes(getDictionaries(config));\n * // Set { 'translation', 'enumeration' }\n */\nexport const getUsedNodeTypes = (\n  dictionaries: Record<string, Dictionary> | Dictionary[]\n): PluginNodeType[] => {\n  const result = new Set<PluginNodeType>();\n  const dicts = Array.isArray(dictionaries)\n    ? dictionaries\n    : Object.values(dictionaries);\n\n  for (const dict of dicts) {\n    collectNodeTypes(dict.content, result);\n  }\n\n  return [...result];\n};\n\nexport const getUnusedNodeTypes = (\n  dictionaries: Record<string, Dictionary> | Dictionary[]\n): PluginNodeType[] => {\n  const usedNodeTypes = getUsedNodeTypes(dictionaries);\n\n  return PLUGIN_NODE_TYPES.filter(\n    (nodeType) => !usedNodeTypes.includes(nodeType)\n  );\n};\n\nexport const getUsedNodeTypesAsync = async (\n  dictionaries: Record<string, Dictionary> | Dictionary[]\n): Promise<PluginNodeType[]> => {\n  const dictionariesArray = Array.isArray(dictionaries)\n    ? dictionaries\n    : Object.values(dictionaries);\n\n  const results = await Promise.all(\n    dictionariesArray.map(async (dictionary) => {\n      const result = new Set<PluginNodeType>();\n\n      collectNodeTypes(dictionary.content, result as Set<string>);\n\n      return result;\n    })\n  );\n\n  const finalResult = new Set<PluginNodeType>();\n\n  for (const res of results) {\n    for (const val of res) {\n      finalResult.add(val);\n    }\n  }\n\n  return [...finalResult];\n};\n\nexport const getUnusedNodeTypesAsync = async (\n  dictionaries: Record<string, Dictionary> | Dictionary[]\n): Promise<PluginNodeType[]> => {\n  const usedNodeTypes = await getUsedNodeTypesAsync(dictionaries);\n\n  return PLUGIN_NODE_TYPES.filter(\n    (nodeType) => !usedNodeTypes.includes(nodeType)\n  );\n};\n"],"mappings":";;;;AAMA,MAAM,oBAAoB,OAAgB,WAA8B;AACtE,KAAI,CAAC,SAAS,OAAO,UAAU,SAAU;AAEzC,KAAI,MAAM,QAAQ,MAAM,EAAE;AACxB,OAAK,MAAM,QAAQ,MAAO,kBAAiB,MAAM,OAAO;AACxD;;CAGF,MAAM,MAAM;AAEZ,KAAI,OAAO,IAAI,aAAa,SAC1B,QAAO,IAAI,IAAI,SAAS;AAG1B,MAAK,MAAM,OAAO,OAAO,KAAK,IAAI,CAChC,kBAAiB,IAAI,MAAM,OAAO;;;;;;;;;;AAYtC,MAAa,oBACX,iBACqB;CACrB,MAAM,yBAAS,IAAI,KAAqB;CACxC,MAAM,QAAQ,MAAM,QAAQ,aAAa,GACrC,eACA,OAAO,OAAO,aAAa;AAE/B,MAAK,MAAM,QAAQ,MACjB,kBAAiB,KAAK,SAAS,OAAO;AAGxC,QAAO,CAAC,GAAG,OAAO;;AAGpB,MAAa,sBACX,iBACqB;CACrB,MAAM,gBAAgB,iBAAiB,aAAa;AAEpD,QAAO,kBAAkB,QACtB,aAAa,CAAC,cAAc,SAAS,SAAS,CAChD;;AAGH,MAAa,wBAAwB,OACnC,iBAC8B;CAC9B,MAAM,oBAAoB,MAAM,QAAQ,aAAa,GACjD,eACA,OAAO,OAAO,aAAa;CAE/B,MAAM,UAAU,MAAM,QAAQ,IAC5B,kBAAkB,IAAI,OAAO,eAAe;EAC1C,MAAM,yBAAS,IAAI,KAAqB;AAExC,mBAAiB,WAAW,SAAS,OAAsB;AAE3D,SAAO;GACP,CACH;CAED,MAAM,8BAAc,IAAI,KAAqB;AAE7C,MAAK,MAAM,OAAO,QAChB,MAAK,MAAM,OAAO,IAChB,aAAY,IAAI,IAAI;AAIxB,QAAO,CAAC,GAAG,YAAY;;AAGzB,MAAa,0BAA0B,OACrC,iBAC8B;CAC9B,MAAM,gBAAgB,MAAM,sBAAsB,aAAa;AAE/D,QAAO,kBAAkB,QACtB,aAAa,CAAC,cAAc,SAAS,SAAS,CAChD"}

package/dist/esm/utils/index.mjs

@@ -9,6 +9,7 @@ import { clearModuleCache } from "./clearModuleCache.mjs";
 import { compareVersions } from "./compareVersions.mjs";
 import { extractErrorMessage } from "./extractErrorMessage.mjs";
 import { getStorageAttributes } from "./getStorageAttributes.mjs";
+import { getUnusedNodeTypes, getUnusedNodeTypesAsync, getUsedNodeTypes, getUsedNodeTypesAsync } from "./getUsedNodeTypes.mjs";
 import { logStack } from "./logStack.mjs";
 import { parseFilePathPattern, parseStringPattern } from "./parseFilePathPattern.mjs";
 import { retryManager } from "./retryManager.mjs";
@@ -17,4 +18,4 @@ import { camelCaseToSentence } from "./stringFormatter/camelCaseToSentence.mjs";
 import { kebabCaseToCamelCase } from "./stringFormatter/kebabCaseToCamelCase.mjs";
 import { toLowerCamelCase } from "./stringFormatter/toLowerCamelCase.mjs";
 
-export { cacheDisk, cacheMemory, camelCaseToKebabCase, camelCaseToSentence, clearAllCache, clearCache, clearDiskCacheMemory, clearModuleCache, compareVersions, computeKeyId, configESMxCJSRequire, extractErrorMessage, getAlias, getCache, getExtension, getPackageJsonPath, getProjectRequire, getStorageAttributes, isESModule, kebabCaseToCamelCase, logStack, normalizePath, parseFilePathPattern, parseStringPattern, retryManager, setCache, stableStringify, toLowerCamelCase };
+export { cacheDisk, cacheMemory, camelCaseToKebabCase, camelCaseToSentence, clearAllCache, clearCache, clearDiskCacheMemory, clearModuleCache, compareVersions, computeKeyId, configESMxCJSRequire, extractErrorMessage, getAlias, getCache, getExtension, getPackageJsonPath, getProjectRequire, getStorageAttributes, getUnusedNodeTypes, getUnusedNodeTypesAsync, getUsedNodeTypes, getUsedNodeTypesAsync, isESModule, kebabCaseToCamelCase, logStack, normalizePath, parseFilePathPattern, parseStringPattern, retryManager, setCache, stableStringify, toLowerCamelCase };

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.ZodDate, z.ZodNumber]>>;
 }, z.core.$strip>;
@@ -47,9 +47,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.ZodDate, z.ZodNumber]>>;
 }, z.core.$strip>, z.ZodObject<{
@@ -72,9 +72,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.ZodDate, z.ZodNumber]>>;
 }, z.core.$strip>, z.ZodObject<{
@@ -155,9 +155,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.ZodDate, z.ZodNumber]>>;
   }, z.core.$strip>, z.ZodObject<{
@@ -180,9 +180,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.ZodDate, z.ZodNumber]>>;
   }, z.core.$strip>, z.ZodObject<{
@@ -349,9 +349,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.ZodDate, z.ZodNumber]>>;
     }, z.core.$strip>, z.ZodObject<{
@@ -374,9 +374,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.ZodDate, z.ZodNumber]>>;
     }, z.core.$strip>, z.ZodObject<{

package/dist/types/envVars/envVars.d.ts

@@ -0,0 +1,31 @@
+import { IntlayerConfig } from "@intlayer/types/config";
+
+//#region src/envVars/envVars.d.ts
+/**
+ * Converts a list of unused NodeType keys into env-var definitions.
+ * Set to `"false"` so bundlers can eliminate the corresponding plugin code.
+ *
+ * @example
+ * formatNodeTypeToEnvVar(['enumeration'])
+ * // { 'INTLAYER_NODE_TYPE_ENUMERATION': '"false"' }
+ *
+ * formatNodeTypeToEnvVar(['enumeration'], true)
+ * // { 'process.env.INTLAYER_NODE_TYPE_ENUMERATION': '"false"' }
+ */
+declare const formatNodeTypeToEnvVar: (nodeTypes: string[], addProcessEnv?: boolean) => Record<string, string>;
+/**
+ * Returns env-var definitions for the full Intlayer config to be injected at
+ * build time. Allows bundlers to dead-code-eliminate unused routing modes,
+ * rewrite logic, storage mechanisms, and editor code.
+ *
+ * @example
+ * getConfigEnvVars(config)
+ * // { INTLAYER_ROUTING_MODE: '"prefix-no-default"', INTLAYER_ROUTING_REWRITE_RULES: '"false"', ... }
+ *
+ * getConfigEnvVars(config, true)
+ * // { 'process.env.INTLAYER_ROUTING_MODE': '"prefix-no-default"', ... }
+ */
+declare const getConfigEnvVars: (config: IntlayerConfig, addProcessEnv?: boolean) => Record<string, string>;
+//#endregion
+export { formatNodeTypeToEnvVar, getConfigEnvVars };
+//# sourceMappingURL=envVars.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"envVars.d.ts","names":[],"sources":["../../../src/envVars/envVars.ts"],"mappings":";;;;;AAaA;;;;;;;;;cAAa,sBAAA,GACX,SAAA,YACA,aAAA,eACC,MAAA;;;;;;;;;;;;;cAyBU,gBAAA,GACX,MAAA,EAAQ,cAAA,EACR,aAAA,eACC,MAAA"}

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

@@ -0,0 +1,2 @@
+import { formatNodeTypeToEnvVar, getConfigEnvVars } from "./envVars.js";
+export { formatNodeTypeToEnvVar, getConfigEnvVars };

package/dist/types/utils/getUsedNodeTypes.d.ts

@@ -0,0 +1,20 @@
+import { Dictionary } from "@intlayer/types/dictionary";
+import { PLUGIN_NODE_TYPES } from "@intlayer/types/nodeType";
+
+//#region src/utils/getUsedNodeTypes.d.ts
+type PluginNodeType = (typeof PLUGIN_NODE_TYPES)[number];
+/**
+ * Returns the set of NodeType strings actually used across the given
+ * built dictionaries.
+ *
+ * @example
+ * const used = getUsedNodeTypes(getDictionaries(config));
+ * // Set { 'translation', 'enumeration' }
+ */
+declare const getUsedNodeTypes: (dictionaries: Record<string, Dictionary> | Dictionary[]) => PluginNodeType[];
+declare const getUnusedNodeTypes: (dictionaries: Record<string, Dictionary> | Dictionary[]) => PluginNodeType[];
+declare const getUsedNodeTypesAsync: (dictionaries: Record<string, Dictionary> | Dictionary[]) => Promise<PluginNodeType[]>;
+declare const getUnusedNodeTypesAsync: (dictionaries: Record<string, Dictionary> | Dictionary[]) => Promise<PluginNodeType[]>;
+//#endregion
+export { PluginNodeType, getUnusedNodeTypes, getUnusedNodeTypesAsync, getUsedNodeTypes, getUsedNodeTypesAsync };
+//# sourceMappingURL=getUsedNodeTypes.d.ts.map

package/dist/types/utils/getUsedNodeTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getUsedNodeTypes.d.ts","names":[],"sources":["../../../src/utils/getUsedNodeTypes.ts"],"mappings":";;;;KAGY,cAAA,WAAyB,iBAAA;;AAArC;;;;;AA8BA;;cAAa,gBAAA,GACX,YAAA,EAAc,MAAA,SAAe,UAAA,IAAc,UAAA,OAC1C,cAAA;AAAA,cAaU,kBAAA,GACX,YAAA,EAAc,MAAA,SAAe,UAAA,IAAc,UAAA,OAC1C,cAAA;AAAA,cAQU,qBAAA,GACX,YAAA,EAAc,MAAA,SAAe,UAAA,IAAc,UAAA,OAC1C,OAAA,CAAQ,cAAA;AAAA,cA0BE,uBAAA,GACX,YAAA,EAAc,MAAA,SAAe,UAAA,IAAc,UAAA,OAC1C,OAAA,CAAQ,cAAA"}

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

@@ -14,6 +14,7 @@ import { compareVersions } from "./compareVersions.js";
 import { getExtension } from "./getExtension.js";
 import { getPackageJsonPath } from "./getPackageJsonPath.js";
 import { getStorageAttributes } from "./getStorageAttributes.js";
+import { PluginNodeType, getUnusedNodeTypes, getUnusedNodeTypesAsync, getUsedNodeTypes, getUsedNodeTypesAsync } from "./getUsedNodeTypes.js";
 import { parseFilePathPattern, parseStringPattern } from "./parseFilePathPattern.js";
 import { RetryManagerOptions, retryManager } from "./retryManager.js";
-export { CacheKey, GetAliasOptions, RetryManagerOptions, cacheDisk, cacheMemory, camelCaseToKebabCase, camelCaseToSentence, clearAllCache, clearCache, clearDiskCacheMemory, clearModuleCache, compareVersions, computeKeyId, configESMxCJSRequire, extractErrorMessage, getAlias, getCache, getExtension, getPackageJsonPath, getProjectRequire, getStorageAttributes, isESModule, kebabCaseToCamelCase, logStack, normalizePath, parseFilePathPattern, parseStringPattern, retryManager, setCache, stableStringify, toLowerCamelCase };
+export { CacheKey, GetAliasOptions, PluginNodeType, RetryManagerOptions, cacheDisk, cacheMemory, camelCaseToKebabCase, camelCaseToSentence, clearAllCache, clearCache, clearDiskCacheMemory, clearModuleCache, compareVersions, computeKeyId, configESMxCJSRequire, extractErrorMessage, getAlias, getCache, getExtension, getPackageJsonPath, getProjectRequire, getStorageAttributes, getUnusedNodeTypes, getUnusedNodeTypesAsync, getUsedNodeTypes, getUsedNodeTypesAsync, isESModule, kebabCaseToCamelCase, logStack, normalizePath, parseFilePathPattern, parseStringPattern, retryManager, setCache, stableStringify, toLowerCamelCase };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/config",
-  "version": "8.6.1",
+  "version": "8.6.3",
   "private": false,
   "description": "Retrieve Intlayer configurations and manage environment variables for both server-side and client-side environments.",
   "keywords": [
@@ -78,6 +78,11 @@
       "require": "./dist/cjs/colors.cjs",
       "import": "./dist/esm/colors.mjs"
     },
+    "./envVars": {
+      "types": "./dist/types/envVars/index.d.ts",
+      "require": "./dist/cjs/envVars/index.cjs",
+      "import": "./dist/esm/envVars/index.mjs"
+    },
     "./defaultValues": {
       "types": "./dist/types/defaultValues/index.d.ts",
       "require": "./dist/cjs/defaultValues/index.cjs",
@@ -108,6 +113,9 @@
       "env": [
         "./dist/types/loadEnvFile.d.ts"
       ],
+      "envVars": [
+        "./dist/types/envVars/index.d.ts"
+      ],
       "logger": [
         "./dist/types/logger.d.ts"
       ],
@@ -144,7 +152,7 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/types": "8.6.1",
+    "@intlayer/types": "8.6.3",
     "defu": "6.1.4",
     "dotenv": "17.3.1",
     "esbuild": "0.27.4",