@intlayer/config 8.7.6 → 8.7.7

package/dist/cjs/logger.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"logger.cjs","names":["RESET","GREEN","BEIGE","GREY","BLUE","RED"],"sources":["../../src/logger.ts"],"sourcesContent":["import type { Locale } from '@intlayer/types/allLocales';\nimport type {\n  CustomIntlayerConfig,\n  IntlayerConfig,\n} from '@intlayer/types/config';\nimport type * as ANSIColorsTypes from './colors';\nimport { BEIGE, BLUE, GREEN, GREY, RED, RESET } from './colors';\n\nexport type ANSIColorsType =\n  (typeof ANSIColorsTypes)[keyof typeof ANSIColorsTypes];\n\nexport type Details = {\n  isVerbose?: boolean;\n  level?: 'info' | 'warn' | 'error' | 'debug';\n  config?: CustomIntlayerConfig['log'];\n};\n\nexport type Logger = (content: any, details?: Details) => void;\n\nlet loggerPrefix: string | undefined;\n\nexport const setPrefix = (prefix: string | undefined) => {\n  loggerPrefix = prefix;\n};\n\nexport const getPrefix = (configPrefix?: string): string | undefined => {\n  if (typeof loggerPrefix !== 'undefined') {\n    return loggerPrefix;\n  }\n\n  return configPrefix;\n};\n\nexport const logger: Logger = (content, details) => {\n  const config = details?.config ?? {};\n  const mode = config.mode ?? 'default';\n\n  if (mode === 'disabled' || (details?.isVerbose && mode !== 'verbose')) return;\n\n  const prefix = getPrefix(config.prefix);\n  const flatContent = prefix ? [prefix, ...[content].flat()] : [content].flat();\n  const level = details?.level ?? 'info';\n\n  const logMethod =\n    config[level] ?? console[level] ?? config.log ?? console.log;\n\n  logMethod(...flatContent);\n};\n\nexport const spinnerFrames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];\n\n/**\n * The appLogger function takes the logger and merges it with the configuration from the intlayer config file.\n * It allows overriding the default configuration by passing a config object in the details parameter.\n * The configuration is merged with the default configuration from the intlayer config file.\n */\nexport const getAppLogger =\n  (configuration?: Pick<IntlayerConfig, 'log'>, globalDetails?: Details) =>\n  (content: any, details?: Details) =>\n    logger(content, {\n      ...(details ?? {}),\n      config: {\n        ...configuration?.log,\n        ...globalDetails?.config,\n        ...(details?.config ?? {}),\n      },\n    });\n\nexport const colorize = (\n  string: string,\n  color?: ANSIColorsType,\n  reset?: boolean | ANSIColorsType\n): string =>\n  color\n    ? `${color}${string}${reset ? (typeof reset === 'boolean' ? RESET : reset) : RESET}`\n    : string;\n\nexport const colorizeLocales = (\n  locales: Locale | Locale[],\n  color: ANSIColorsType = GREEN,\n  reset: boolean | ANSIColorsType = RESET\n) =>\n  [locales]\n    .flat()\n    .map((locale) => colorize(locale, color, reset))\n    .join(`, `);\n\nexport const colorizeKey = (\n  keyPath: string | string[],\n  color: ANSIColorsType = BEIGE,\n  reset: boolean | ANSIColorsType = RESET\n) =>\n  [keyPath]\n    .flat()\n    .map((key) => colorize(key, color, reset))\n    .join(`, `);\n\nexport const colorizePath = (\n  path: string | string[],\n  color: ANSIColorsType = GREY,\n  reset: boolean | ANSIColorsType = RESET\n) =>\n  [path]\n    .flat()\n    .map((path) => colorize(path, color, reset))\n    .join(`, `);\n\nexport const colorizeNumber = (\n  number: number | string,\n  options: Partial<Record<Intl.LDMLPluralRule, ANSIColorsType>> = {\n    zero: BLUE,\n    one: BLUE,\n    two: BLUE,\n    few: BLUE,\n    many: BLUE,\n    other: BLUE,\n  }\n): string => {\n  if (number === 0 || number === '0') {\n    const color = options.zero ?? GREEN;\n    return colorize(number.toString(), color);\n  }\n\n  // Kept inside the function. Top-level instantiation of classes/APIs\n  // is treated as a side-effect and prevents tree-shaking if the function is unused.\n  const rule = new Intl.PluralRules('en').select(Number(number));\n  const color = options[rule];\n  return colorize(number.toString(), color);\n};\n\nexport const removeColor = (text: string) =>\n  // biome-ignore lint/suspicious/noControlCharactersInRegex: we need to remove the color codes\n  text.replace(/\\x1b\\[[0-9;]*m/g, '');\n\nconst getLength = (length: number | number[] | string | string[]): number => {\n  let value: number = 0;\n  if (typeof length === 'number') {\n    value = length;\n  }\n  if (typeof length === 'string') {\n    value = length.length;\n  }\n  if (\n    Array.isArray(length) &&\n    length.every((locale) => typeof locale === 'string')\n  ) {\n    value = Math.max(...length.map((str) => str.length));\n  }\n  if (\n    Array.isArray(length) &&\n    length.every((locale) => typeof locale === 'number')\n  ) {\n    value = Math.max(...length);\n  }\n  return Math.max(value, 0);\n};\n\nconst defaultColonOptions = {\n  colSize: 0,\n  minSize: 0,\n  maxSize: Infinity,\n  pad: 'right',\n  padChar: '0',\n};\n\n/**\n * Create a string of spaces of a given length.\n *\n * @param colSize - The length of the string to create.\n * @returns A string of spaces.\n */\nexport const colon = (\n  text: string | string[],\n  options?: {\n    colSize?: number | number[] | string | string[];\n    minSize?: number;\n    maxSize?: number;\n    pad?: 'left' | 'right';\n    padChar?: string;\n  }\n): string =>\n  [text]\n    .flat()\n    .map((text) => {\n      const { colSize, minSize, maxSize, pad } = {\n        ...defaultColonOptions,\n        ...(options ?? {}),\n      };\n\n      const length = getLength(colSize);\n      const spacesLength = Math.max(\n        minSize!,\n        Math.min(maxSize!, length - removeColor(text).length)\n      );\n\n      if (pad === 'left') {\n        return `${' '.repeat(spacesLength)}${text}`;\n      }\n\n      return `${text}${' '.repeat(spacesLength)}`;\n    })\n    .join('');\n\nexport const x = colorize('✗', RED);\nexport const v = colorize('✓', GREEN);\nexport const clock = colorize('⏲', BLUE);\n"],"mappings":"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"}
+{"version":3,"file":"logger.cjs","names":["RESET","GREEN","BEIGE","GREY","BLUE","RED"],"sources":["../../src/logger.ts"],"sourcesContent":["import type { Locale } from '@intlayer/types/allLocales';\nimport type {\n  CustomIntlayerConfig,\n  IntlayerConfig,\n} from '@intlayer/types/config';\nimport type * as ANSIColorsTypes from './colors';\nimport { BEIGE, BLUE, GREEN, GREY, RED, RESET } from './colors';\n\nexport type ANSIColorsType =\n  (typeof ANSIColorsTypes)[keyof typeof ANSIColorsTypes];\n\nexport type Details = {\n  isVerbose?: boolean;\n  level?: 'info' | 'warn' | 'error' | 'debug';\n  config?: CustomIntlayerConfig['log'];\n};\n\nexport type Logger = (content: any, details?: Details) => void;\n\nlet loggerPrefix: string | undefined;\n\nexport const setPrefix = (prefix: string | undefined) => {\n  loggerPrefix = prefix;\n};\n\nexport const getPrefix = (configPrefix?: string): string | undefined => {\n  if (typeof loggerPrefix !== 'undefined') {\n    return loggerPrefix;\n  }\n\n  return configPrefix;\n};\n\nexport const logger: Logger = (content, details) => {\n  const config = details?.config ?? {};\n  const mode = config.mode ?? 'default';\n\n  if (mode === 'disabled' || (details?.isVerbose && mode !== 'verbose')) return;\n\n  const prefix = getPrefix(config.prefix);\n  const flatContent = prefix ? [prefix, ...[content].flat()] : [content].flat();\n  const level = details?.level ?? 'info';\n\n  const logMethod =\n    config[level] ?? console[level] ?? config.log ?? console.log;\n\n  logMethod(...flatContent);\n};\n\nexport const spinnerFrames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];\n\n/**\n * The appLogger function takes the logger and merges it with the configuration from the intlayer config file.\n * It allows overriding the default configuration by passing a config object in the details parameter.\n * The configuration is merged with the default configuration from the intlayer config file.\n */\nexport const getAppLogger =\n  (configuration?: Pick<IntlayerConfig, 'log'>, globalDetails?: Details) =>\n  (content: any, details?: Details) =>\n    logger(content, {\n      ...(details ?? {}),\n      config: {\n        ...configuration?.log,\n        ...globalDetails?.config,\n        ...(details?.config ?? {}),\n      },\n    });\n\nexport const colorize = (\n  string: string,\n  color?: ANSIColorsType,\n  reset?: boolean | ANSIColorsType\n): string =>\n  color\n    ? `${color}${string}${reset ? (typeof reset === 'boolean' ? RESET : reset) : RESET}`\n    : string;\n\nexport const colorizeLocales = (\n  locales: Locale | Locale[],\n  color: ANSIColorsType = GREEN,\n  reset: boolean | ANSIColorsType = RESET\n) =>\n  [locales]\n    .flat()\n    .map((locale) => colorize(locale, color, reset))\n    .join(`, `);\n\nexport const colorizeKey = (\n  keyPath: string | string[],\n  color: ANSIColorsType = BEIGE,\n  reset: boolean | ANSIColorsType = RESET\n) =>\n  [keyPath]\n    .flat()\n    .map((key) => colorize(key, color, reset))\n    .join(`, `);\n\nexport const colorizePath = (\n  path: string | string[],\n  color: ANSIColorsType = GREY,\n  reset: boolean | ANSIColorsType = RESET\n) =>\n  [path]\n    .flat()\n    .map((path) => colorize(path, color, reset))\n    .join(`, `);\n\nexport const colorizeNumber = (\n  number: number | string,\n  options: Partial<Record<Intl.LDMLPluralRule, ANSIColorsType>> = {\n    zero: BLUE,\n    one: BLUE,\n    two: BLUE,\n    few: BLUE,\n    many: BLUE,\n    other: BLUE,\n  }\n): string => {\n  if (number === 0 || number === '0') {\n    const color = options.zero ?? GREEN;\n    return colorize(number.toString(), color);\n  }\n\n  // Kept inside the function. Top-level instantiation of classes/APIs\n  // is treated as a side-effect and prevents tree-shaking if the function is unused.\n  const rule = new Intl.PluralRules('en').select(Number(number));\n  const color = options[rule];\n  return colorize(number.toString(), color);\n};\n\nexport const removeColor = (text: string) =>\n  // biome-ignore lint/suspicious/noControlCharactersInRegex: we need to remove the color codes\n  text.replace(/\\x1b\\[[0-9;]*m/g, '');\n\nconst getLength = (length: number | number[] | string | string[]): number => {\n  let value: number = 0;\n  if (typeof length === 'number') {\n    value = length;\n  }\n  if (typeof length === 'string') {\n    value = length.length;\n  }\n  if (\n    Array.isArray(length) &&\n    length.every((locale) => typeof locale === 'string')\n  ) {\n    value = Math.max(...length.map((str) => str.length));\n  }\n  if (\n    Array.isArray(length) &&\n    length.every((locale) => typeof locale === 'number')\n  ) {\n    value = Math.max(...length);\n  }\n  return Math.max(value, 0);\n};\n\nconst defaultColonOptions = {\n  colSize: 0,\n  minSize: 0,\n  maxSize: Infinity,\n  pad: 'right',\n  padChar: '0',\n};\n\n/**\n * Create a string of spaces of a given length.\n *\n * @param colSize - The length of the string to create.\n * @returns A string of spaces.\n */\nexport const colon = (\n  text: string | string[],\n  options?: {\n    colSize?: number | number[] | string | string[];\n    minSize?: number;\n    maxSize?: number;\n    pad?: 'left' | 'right';\n    padChar?: string;\n  }\n): string =>\n  [text]\n    .flat()\n    .map((text) => {\n      const { colSize, minSize, maxSize, pad } = {\n        ...defaultColonOptions,\n        ...(options ?? {}),\n      };\n\n      const length = getLength(colSize);\n      const spacesLength = Math.max(\n        minSize!,\n        Math.min(maxSize!, length - removeColor(text).length)\n      );\n\n      if (pad === 'left') {\n        return `${' '.repeat(spacesLength)}${text}`;\n      }\n\n      return `${text}${' '.repeat(spacesLength)}`;\n    })\n    .join('');\n\nexport const x = colorize('✗', RED);\nexport const v = colorize('✓', GREEN);\nexport const clock = colorize('⏲', BLUE);\n"],"mappings":"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"}

package/dist/cjs/utils/alias.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"alias.cjs","names":["getExtension","normalizePath"],"sources":["../../../src/utils/alias.ts"],"sourcesContent":["import { join, relative } from 'node:path';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { getExtension } from './getExtension';\nimport { normalizePath } from './normalizePath';\n\nexport type GetAliasOptions = {\n  configuration: IntlayerConfig;\n  format?: 'esm' | 'cjs';\n  formatter?: (value: string) => string;\n};\n\nexport const getAlias = ({\n  configuration,\n  format,\n  formatter = (value: string) => value,\n}: GetAliasOptions) => {\n  const extension = getExtension(\n    configuration,\n    format ?? configuration.build.outputFormat[0] ?? 'esm'\n  );\n\n  const { baseDir } = configuration.system;\n  const { mainDir, configDir } = configuration.system;\n\n  /**\n   * Dictionaries\n   */\n  const dictionariesPath = join(mainDir, `dictionaries.${extension}`);\n  const relativeDictionariesPath = relative(baseDir, dictionariesPath);\n  const fixedDictionariesPath = formatter(\n    normalizePath(relativeDictionariesPath)\n  );\n\n  /**\n   * Unmerged dictionaries\n   */\n  const unmergedDictionariesPath = join(\n    mainDir,\n    `unmerged_dictionaries.${extension}`\n  );\n  const relativeUnmergedDictionariesPath = relative(\n    baseDir,\n    unmergedDictionariesPath\n  );\n  const fixedUnmergedDictionariesPath = formatter(\n    normalizePath(relativeUnmergedDictionariesPath)\n  );\n\n  /**\n   * Remote dictionaries\n   */\n  const remoteDictionariesPath = join(\n    mainDir,\n    `remote_dictionaries.${extension}`\n  );\n  const relativeRemoteDictionariesPath = relative(\n    baseDir,\n    remoteDictionariesPath\n  );\n  const fixedRemoteDictionariesPath = formatter(\n    normalizePath(relativeRemoteDictionariesPath)\n  );\n\n  /**\n   * Dynamic dictionaries\n   */\n  const dynamicDictionariesPath = join(\n    mainDir,\n    `dynamic_dictionaries.${extension}`\n  );\n  const relativeDynamicDictionariesPath = relative(\n    baseDir,\n    dynamicDictionariesPath\n  );\n  const fixedDynamicDictionariesPath = formatter(\n    normalizePath(relativeDynamicDictionariesPath)\n  );\n\n  /**\n   * Fetch dictionaries\n   */\n  const fetchDictionariesPath = join(\n    mainDir,\n    `fetch_dictionaries.${extension}`\n  );\n  const relativeFetchDictionariesPath = relative(\n    baseDir,\n    fetchDictionariesPath\n  );\n  const fixedFetchDictionariesPath = formatter(\n    normalizePath(relativeFetchDictionariesPath)\n  );\n\n  /**\n   * Configuration\n   */\n  const configurationPath = join(configDir, `configuration.${extension}`);\n  const relativeConfigurationPath = relative(baseDir, configurationPath);\n  const fixedConfigurationPath = formatter(\n    normalizePath(relativeConfigurationPath)\n  );\n\n  return {\n    '@intlayer/dictionaries-entry': fixedDictionariesPath,\n    '@intlayer/unmerged-dictionaries-entry': fixedUnmergedDictionariesPath,\n    '@intlayer/remote-dictionaries-entry': fixedRemoteDictionariesPath,\n    '@intlayer/dynamic-dictionaries-entry': fixedDynamicDictionariesPath,\n    '@intlayer/fetch-dictionaries-entry': fixedFetchDictionariesPath,\n    '@intlayer/config/built': fixedConfigurationPath,\n  } as const;\n};\n"],"mappings":";;;;;;;AAWA,MAAa,YAAY,EACvB,eACA,QACA,aAAa,UAAkB,YACV;CACrB,MAAM,YAAYA,wCAChB,eACA,UAAU,cAAc,MAAM,aAAa,MAAM,MAClD;CAED,MAAM,EAAE,YAAY,cAAc;CAClC,MAAM,EAAE,SAAS,cAAc,cAAc;AAgF7C,QAAO;EACL,gCA1E4B,UAC5BC,kEAFwC,6BADZ,SAAS,gBAAgB,YAAY,CACC,CAE3B,CACxC;EAyEC,yCA5DoC,UACpCA,kEAJA,6BAJA,SACA,yBAAyB,YAC1B,CAIA,CAEgD,CAChD;EA2DC,uCA9CkC,UAClCA,kEAJA,6BAJA,SACA,uBAAuB,YACxB,CAIA,CAE8C,CAC9C;EA6CC,wCAhCmC,UACnCA,kEAJA,6BAJA,SACA,wBAAwB,YACzB,CAIA,CAE+C,CAC/C;EA+BC,sCAlBiC,UACjCA,kEAJA,6BAJA,SACA,sBAAsB,YACvB,CAIA,CAE6C,CAC7C;EAiBC,0BAV6B,UAC7BA,kEAFyC,6BADZ,WAAW,iBAAiB,YAAY,CACD,CAE5B,CACzC;EASA"}
+{"version":3,"file":"alias.cjs","names":["getExtension","normalizePath"],"sources":["../../../src/utils/alias.ts"],"sourcesContent":["import { join, relative } from 'node:path';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { getExtension } from './getExtension';\nimport { normalizePath } from './normalizePath';\n\nexport type GetAliasOptions = {\n  configuration: IntlayerConfig;\n  format?: 'esm' | 'cjs';\n  formatter?: (value: string) => string;\n};\n\nexport const getAlias = ({\n  configuration,\n  format,\n  formatter = (value: string) => value,\n}: GetAliasOptions) => {\n  const extension = getExtension(\n    configuration,\n    format ?? configuration.build.outputFormat[0] ?? 'esm'\n  );\n\n  const { baseDir } = configuration.system;\n  const { mainDir, configDir } = configuration.system;\n\n  /**\n   * Dictionaries\n   */\n  const dictionariesPath = join(mainDir, `dictionaries.${extension}`);\n  const relativeDictionariesPath = relative(baseDir, dictionariesPath);\n  const fixedDictionariesPath = formatter(\n    normalizePath(relativeDictionariesPath)\n  );\n\n  /**\n   * Unmerged dictionaries\n   */\n  const unmergedDictionariesPath = join(\n    mainDir,\n    `unmerged_dictionaries.${extension}`\n  );\n  const relativeUnmergedDictionariesPath = relative(\n    baseDir,\n    unmergedDictionariesPath\n  );\n  const fixedUnmergedDictionariesPath = formatter(\n    normalizePath(relativeUnmergedDictionariesPath)\n  );\n\n  /**\n   * Remote dictionaries\n   */\n  const remoteDictionariesPath = join(\n    mainDir,\n    `remote_dictionaries.${extension}`\n  );\n  const relativeRemoteDictionariesPath = relative(\n    baseDir,\n    remoteDictionariesPath\n  );\n  const fixedRemoteDictionariesPath = formatter(\n    normalizePath(relativeRemoteDictionariesPath)\n  );\n\n  /**\n   * Dynamic dictionaries\n   */\n  const dynamicDictionariesPath = join(\n    mainDir,\n    `dynamic_dictionaries.${extension}`\n  );\n  const relativeDynamicDictionariesPath = relative(\n    baseDir,\n    dynamicDictionariesPath\n  );\n  const fixedDynamicDictionariesPath = formatter(\n    normalizePath(relativeDynamicDictionariesPath)\n  );\n\n  /**\n   * Fetch dictionaries\n   */\n  const fetchDictionariesPath = join(\n    mainDir,\n    `fetch_dictionaries.${extension}`\n  );\n  const relativeFetchDictionariesPath = relative(\n    baseDir,\n    fetchDictionariesPath\n  );\n  const fixedFetchDictionariesPath = formatter(\n    normalizePath(relativeFetchDictionariesPath)\n  );\n\n  /**\n   * Configuration\n   */\n  const configurationPath = join(configDir, `configuration.${extension}`);\n  const relativeConfigurationPath = relative(baseDir, configurationPath);\n  const fixedConfigurationPath = formatter(\n    normalizePath(relativeConfigurationPath)\n  );\n\n  return {\n    '@intlayer/dictionaries-entry': fixedDictionariesPath,\n    '@intlayer/unmerged-dictionaries-entry': fixedUnmergedDictionariesPath,\n    '@intlayer/remote-dictionaries-entry': fixedRemoteDictionariesPath,\n    '@intlayer/dynamic-dictionaries-entry': fixedDynamicDictionariesPath,\n    '@intlayer/fetch-dictionaries-entry': fixedFetchDictionariesPath,\n    '@intlayer/config/built': fixedConfigurationPath,\n  } as const;\n};\n"],"mappings":";;;;;;;AAWA,MAAa,YAAY,EACvB,eACA,QACA,aAAa,UAAkB,YACV;CACrB,MAAM,YAAYA,wCAChB,eACA,UAAU,cAAc,MAAM,aAAa,MAAM,MAClD;CAED,MAAM,EAAE,YAAY,cAAc;CAClC,MAAM,EAAE,SAAS,cAAc,cAAc;AAgF7C,QAAO;EACL,gCA1E4B,UAC5BC,kEAFwC,6BADZ,SAAS,gBAAgB,YACY,CAE3B,CAAC,CAyEc;EACrD,yCA5DoC,UACpCA,kEAJA,6BAJA,SACA,yBAAyB,YAID,CAGsB,CAAC,CA2DuB;EACtE,uCA9CkC,UAClCA,kEAJA,6BAJA,SACA,uBAAuB,YAID,CAGsB,CAAC,CA6CqB;EAClE,wCAhCmC,UACnCA,kEAJA,6BAJA,SACA,wBAAwB,YAID,CAGsB,CAAC,CA+BsB;EACpE,sCAlBiC,UACjCA,kEAJA,6BAJA,SACA,sBAAsB,YAID,CAGsB,CAAC,CAiBoB;EAChE,0BAV6B,UAC7BA,kEAFyC,6BADZ,WAAW,iBAAiB,YACU,CAE5B,CAAC,CASQ;EACjD"}

package/dist/cjs/utils/cacheDisk.cjs

@@ -109,21 +109,25 @@ const cacheDisk = (intlayerConfig, keys, options) => {
 		} catch {}
 	};
 	return {
+		/** In-memory first, then disk (if enabled), otherwise undefined. */
 		get: async () => {
 			const mem = cacheMap.get(id);
 			if (mem !== void 0) return mem;
 			if (persistent && buildCacheEnabled) return await readFromDisk();
 		},
+		/** Sets in-memory (always) and persists to disk if enabled. */
 		set: async (value) => {
 			cacheMap.set(id, value);
 			if (persistent && buildCacheEnabled) await writeToDisk(value);
 		},
+		/** Clears only this entry from memory and disk. */
 		clear: async () => {
 			cacheMap.delete(id);
 			try {
 				await (0, node_fs_promises.unlink)(filePath);
 			} catch {}
 		},
+		/** Clears ALL cached entries (memory Map and entire cacheDir namespace if persistent). */
 		clearAll: async () => {
 			require_utils_cacheMemory.clearAllCache();
 			if (persistent && buildCacheEnabled) {
@@ -139,6 +143,7 @@ const cacheDisk = (intlayerConfig, keys, options) => {
 				} catch {}
 			}
 		},
+		/** Expose the computed id (useful if you want to key other structures). */
 		isValid: async () => {
 			if (cacheMap.get(id) !== void 0) return true;
 			if (!persistent || !buildCacheEnabled) return false;
@@ -168,7 +173,9 @@ const cacheDisk = (intlayerConfig, keys, options) => {
 				return false;
 			}
 		},
+		/** Expose the computed id (useful if you want to key other structures). */
 		id,
+		/** Expose the absolute file path for debugging. */
 		filePath
 	};
 };

package/dist/cjs/utils/cacheDisk.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"cacheDisk.cjs","names":["computeKeyId","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.cjs","names":["computeKeyId","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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"}

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((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":";;;AAAA,MAAa,uBAAuB,UAA2B;CAC7D,MAAM,oBAAoB,SACxB,KACG,MAAM,QAAQ,CACd,KAAK,gBAAgB,YAAY,MAAM,CAAC,CACxC,OAAO,QAAQ,CAAC,MAAM,KAAK,MAAM;CAEtC,MAAM,iBAAiB,UAA2B;EAChD,MAAM,cAAc,MAAM,MAAM;AAEhC,MAAI,CAAC,YAAa,QAAO;EACzB,MAAM,QAAQ,YAAY;AAC1B,SAAO,UAAU,OAAO,UAAU,OAAO,UAAU;;CAGrD,MAAM,kCAAkC,SAAyB;EAE/D,MAAM,IAAI,KAAK,MAAM;AAErB,MAAI,oBAAoB,KAAK,EAAE,IAAI,kBAAkB,KAAK,EAAE,EAAE;GAC5D,MAAM,SAAS,EAAE,MAAM,YAAY;AAEnC,OAAI,SAAS,GAAI,QAAO,OAAO;GAE/B,MAAM,aAAa,EAAE,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC,MAAM;AAEzD,OAAI,WAAY,QAAO;;AAEzB,SAAO;;CAGT,MAAM,wBACJ,OACA,SACuB;AACvB,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAEhD,MAAI,KAAK,IAAI,MAAM,CAAE,QAAO;AAE5B,OAAK,IAAI,MAAM;AAIf,MAAI,MAAM,QAAQ,MAAM,EAAE;AACxB,QAAK,MAAM,QAAQ,OAAO;IACxB,MAAM,WAAW,qBAAqB,MAAM,KAAK;AAEjD,QAAI,SAAU,QAAO;AAErB,QAAI,OAAQ,MAAc,YAAY,SACpC,QAAQ,KAAa;;AAEzB;;EAGF,MAAM,MAAM;AAIZ,MAAI,OAAO,IAAI,YAAY,YAAY,IAAI,QAAQ,MAAM,CACvD,QAAO,IAAI;AAKb,MACE,OAAO,IAAI,sBAAsB,YACjC,IAAI,kBAAkB,MAAM,CAE5B,QAAO,IAAI;AAKb,MAAI,OAAO,IAAI,UAAU,YAAY,IAAI,MAAM,MAAM,CACnD,QAAO,IAAI;EAIb,MAAM,QAAQ,OAAO,IAAI,UAAU,WAAW,IAAI,MAAM,MAAM,GAAG;EACjE,MAAM,OAAO,OAAO,IAAI,SAAS,WAAW,IAAI,KAAK,MAAM,GAAG;AAE9D,MAAI,SAAS,KACX,QAAO,GAAG,MAAM,IAAI,KAAK;AAG3B,MAAI,MACF,QAAO;AAGT,MAAI,KACF,QAAO;AAKT,MAAI,OAAO,IAAI,eAAe,YAAY,IAAI,WAAW,MAAM,CAC7D,QAAO,IAAI;EAIb,MAAM,WAAW,IAAI;AAErB,MAAI,YAAY,OAAO,aAAa,UAAU;GAC5C,MAAM,OAAO,SAAS;GACtB,MAAM,WAAW,qBAAqB,MAAM,KAAK;AAEjD,OAAI,SAAU,QAAO;;EAGvB,MAAM,OAAO,IAAI;EACjB,MAAM,WAAW,qBAAqB,MAAM,KAAK;AAEjD,MAAI,SAAU,QAAO;EAGrB,MAAM,QAAS,IAA4B;EAC3C,MAAM,YACJ,qBAAqB,OAAO,KAAK,KAChC,OAAQ,OAAe,YAAY,WAC/B,MAAc,UACf;AAEN,MAAI,UAAW,QAAO;EAGtB,MAAM,SAAS,IAAI;AAEnB,MAAI,MAAM,QAAQ,OAAO,CACvB,MAAK,MAAM,QAAQ,QAAQ;GACzB,MAAM,WAAW,qBAAqB,MAAM,KAAK;AAEjD,OAAI,SAAU,QAAO;AAErB,OAAI,OAAQ,MAAc,YAAY,SACpC,QAAQ,KAAa;;;CAO7B,MAAM,sBAAsB,cAA0C;AACpE,MAAI,CAAC,cAAc,UAAU,CAAE,QAAO;AACtC,MAAI;GACF,MAAM,SAAS,KAAK,MAAM,UAAU;GACpC,MAAM,SAAS,qBAAqB,wBAAQ,IAAI,KAAK,CAAC;AAEtD,OAAI,OAAQ,QAAO;AAEnB,OAAI,OAAO,WAAW,SAAU,QAAO;AACvC;UACM;AACN;;;AAIJ,KAAI,OAAO,UAAU,UAAU;EAC7B,MAAM,UAAU,+BAA+B,MAAM;AACrD,SAAO,mBAAmB,QAAQ,IAAI,iBAAiB,QAAQ;;AAGjE,KAAI,SAAS,OAAO,UAAU,UAAU;AAGtC,MAAI,iBAAiB,OAAO;GAC1B,MAAM,UAAU,+BAA+B,MAAM,QAAQ;GAC7D,MAAM,cAAc,mBAAmB,QAAQ;AAE/C,OAAI,YAAa,QAAO,iBAAiB,YAAY;GAErD,MAAM,YAAY,oBAAoB,MAAM,MAAiB;AAE7D,OAAI,aAAa,cAAc,4BAC7B,QAAO,iBAAiB,UAAU;AACpC,UAAO,iBAAiB,QAAQ;;EAKlC,MAAM,aAAa,qBAAqB,uBAD3B,IAAI,KAAc,CACqB;AAEpD,MAAI,YAAY;GACd,MAAM,UAAU,+BAA+B,WAAW;AAC1D,UAAO,mBAAmB,QAAQ,IAAI,iBAAiB,QAAQ;;AAGjE,MAAI;AAEF,UAAO,iBADY,KAAK,UAAU,MAAM,CACL;UAC7B;AACN,UAAO,iBAAiB,OAAO,MAAM,CAAC;;;AAI1C,QAAO"}
+{"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/getStorageAttributes.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"getStorageAttributes.cjs","names":[],"sources":["../../../src/utils/getStorageAttributes.ts"],"sourcesContent":["import type {\n  CookiesAttributes,\n  ProcessedStorageAttributes,\n  RoutingStorageInput,\n  StorageAttributes,\n} from '@intlayer/types/config';\nimport {\n  COOKIE_NAME,\n  HEADER_NAME,\n  LOCALE_STORAGE_NAME,\n} from '../defaultValues/routing';\n\n// ============================================================================\n// Types\n// ============================================================================\n\ntype CookieEntry = {\n  name: string;\n  attributes: Omit<CookiesAttributes, 'type' | 'name'>;\n};\n\ntype WebStorageEntry = {\n  name: string;\n};\n\ntype HeaderEntry = {\n  name: string;\n};\n\ntype StorageEntry =\n  | 'cookie'\n  | 'localStorage'\n  | 'sessionStorage'\n  | 'header'\n  | CookiesAttributes\n  | StorageAttributes;\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\nconst createCookieEntry = (\n  options?: Partial<CookiesAttributes>\n): CookieEntry => {\n  const { name, path, expires, domain, secure, sameSite, httpOnly } =\n    options ?? {};\n  return {\n    name: name ?? COOKIE_NAME,\n    attributes: { path, expires, domain, secure, sameSite, httpOnly },\n  };\n};\n\nconst createWebStorageEntry = (\n  options?: Partial<StorageAttributes>\n): WebStorageEntry => ({\n  name: options?.name ?? LOCALE_STORAGE_NAME,\n});\n\nconst createHeaderEntry = (\n  options?: Partial<StorageAttributes>\n): HeaderEntry => ({\n  name: options?.name ?? HEADER_NAME,\n});\n\nconst isCookieEntry = (entry: unknown): boolean => {\n  if (typeof entry !== 'object' || entry === null) return false;\n  const e = entry as Record<string, unknown>;\n  return (\n    e['type'] === 'cookie' ||\n    'sameSite' in e ||\n    'httpOnly' in e ||\n    'secure' in e\n  );\n};\n\nconst isStorageType = (\n  value: string\n): value is 'cookie' | 'localStorage' | 'sessionStorage' | 'header' =>\n  value === 'cookie' ||\n  value === 'localStorage' ||\n  value === 'sessionStorage' ||\n  value === 'header';\n\n// ============================================================================\n// Main Function\n// ============================================================================\n\nconst processStorageEntry = (\n  entry: StorageEntry\n): Partial<ProcessedStorageAttributes> => {\n  if (typeof entry === 'string') {\n    if (!isStorageType(entry)) {\n      return { cookies: [], localStorage: [], sessionStorage: [], headers: [] };\n    }\n    if (entry === 'cookie') return { cookies: [createCookieEntry()] };\n    if (entry === 'localStorage')\n      return { localStorage: [createWebStorageEntry()] };\n    if (entry === 'sessionStorage')\n      return { sessionStorage: [createWebStorageEntry()] };\n    if (entry === 'header') return { headers: [createHeaderEntry()] };\n  }\n\n  if (typeof entry === 'object' && entry !== null) {\n    const typedEntry = entry as CookiesAttributes | StorageAttributes;\n\n    if (isCookieEntry(typedEntry)) {\n      return { cookies: [createCookieEntry(typedEntry as CookiesAttributes)] };\n    }\n    if ('type' in typedEntry && typedEntry.type === 'localStorage') {\n      return {\n        localStorage: [createWebStorageEntry(typedEntry as StorageAttributes)],\n      };\n    }\n    if ('type' in typedEntry && typedEntry.type === 'sessionStorage') {\n      return {\n        sessionStorage: [\n          createWebStorageEntry(typedEntry as StorageAttributes),\n        ],\n      };\n    }\n    if ('type' in typedEntry && typedEntry.type === 'header') {\n      return { headers: [createHeaderEntry(typedEntry as StorageAttributes)] };\n    }\n    // Default to localStorage for ambiguous objects\n    return {\n      localStorage: [\n        createWebStorageEntry(typedEntry as Omit<StorageAttributes, 'type'>),\n      ],\n    };\n  }\n\n  return { cookies: [], localStorage: [], sessionStorage: [], headers: [] };\n};\n\nconst mergeStorageAttributes = (\n  accumulated: ProcessedStorageAttributes,\n  partial: Partial<ProcessedStorageAttributes>\n): ProcessedStorageAttributes => ({\n  cookies: [...(accumulated.cookies ?? []), ...(partial.cookies ?? [])],\n  localStorage: [\n    ...(accumulated.localStorage ?? []),\n    ...(partial.localStorage ?? []),\n  ],\n  sessionStorage: [\n    ...(accumulated.sessionStorage ?? []),\n    ...(partial.sessionStorage ?? []),\n  ],\n  headers: [...(accumulated.headers ?? []), ...(partial.headers ?? [])],\n});\n\n/**\n * Extracts and normalizes storage configuration into separate arrays for each storage type.\n * Called at config-build time so the result is pre-computed and stored in the config.\n *\n * @param options - The storage configuration from IntlayerConfig\n * @returns An object containing arrays for cookies, localStorage, sessionStorage and headers\n */\nexport const getStorageAttributes = (\n  options: RoutingStorageInput\n): ProcessedStorageAttributes => {\n  const emptyResult: ProcessedStorageAttributes = {\n    cookies: [],\n    localStorage: [],\n    sessionStorage: [],\n    headers: [],\n  };\n\n  if (options === false || options === undefined) return {};\n\n  const result = Array.isArray(options)\n    ? options.reduce<ProcessedStorageAttributes>((acc, entry) => {\n        const partial = processStorageEntry(entry);\n        return mergeStorageAttributes(acc, partial);\n      }, emptyResult)\n    : mergeStorageAttributes(emptyResult, processStorageEntry(options));\n\n  // Remove empty arrays\n  const cleanedResult: ProcessedStorageAttributes = {};\n\n  if (result.cookies && result.cookies.length > 0) {\n    cleanedResult.cookies = result.cookies;\n  }\n\n  if (result.localStorage && result.localStorage.length > 0) {\n    cleanedResult.localStorage = result.localStorage;\n  }\n\n  if (result.sessionStorage && result.sessionStorage.length > 0) {\n    cleanedResult.sessionStorage = result.sessionStorage;\n  }\n\n  if (result.headers && result.headers.length > 0) {\n    cleanedResult.headers = result.headers;\n  }\n\n  return cleanedResult;\n};\n"],"mappings":"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"}
+{"version":3,"file":"getStorageAttributes.cjs","names":[],"sources":["../../../src/utils/getStorageAttributes.ts"],"sourcesContent":["import type {\n  CookiesAttributes,\n  ProcessedStorageAttributes,\n  RoutingStorageInput,\n  StorageAttributes,\n} from '@intlayer/types/config';\nimport {\n  COOKIE_NAME,\n  HEADER_NAME,\n  LOCALE_STORAGE_NAME,\n} from '../defaultValues/routing';\n\n// ============================================================================\n// Types\n// ============================================================================\n\ntype CookieEntry = {\n  name: string;\n  attributes: Omit<CookiesAttributes, 'type' | 'name'>;\n};\n\ntype WebStorageEntry = {\n  name: string;\n};\n\ntype HeaderEntry = {\n  name: string;\n};\n\ntype StorageEntry =\n  | 'cookie'\n  | 'localStorage'\n  | 'sessionStorage'\n  | 'header'\n  | CookiesAttributes\n  | StorageAttributes;\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\nconst createCookieEntry = (\n  options?: Partial<CookiesAttributes>\n): CookieEntry => {\n  const { name, path, expires, domain, secure, sameSite, httpOnly } =\n    options ?? {};\n  return {\n    name: name ?? COOKIE_NAME,\n    attributes: { path, expires, domain, secure, sameSite, httpOnly },\n  };\n};\n\nconst createWebStorageEntry = (\n  options?: Partial<StorageAttributes>\n): WebStorageEntry => ({\n  name: options?.name ?? LOCALE_STORAGE_NAME,\n});\n\nconst createHeaderEntry = (\n  options?: Partial<StorageAttributes>\n): HeaderEntry => ({\n  name: options?.name ?? HEADER_NAME,\n});\n\nconst isCookieEntry = (entry: unknown): boolean => {\n  if (typeof entry !== 'object' || entry === null) return false;\n  const e = entry as Record<string, unknown>;\n  return (\n    e['type'] === 'cookie' ||\n    'sameSite' in e ||\n    'httpOnly' in e ||\n    'secure' in e\n  );\n};\n\nconst isStorageType = (\n  value: string\n): value is 'cookie' | 'localStorage' | 'sessionStorage' | 'header' =>\n  value === 'cookie' ||\n  value === 'localStorage' ||\n  value === 'sessionStorage' ||\n  value === 'header';\n\n// ============================================================================\n// Main Function\n// ============================================================================\n\nconst processStorageEntry = (\n  entry: StorageEntry\n): Partial<ProcessedStorageAttributes> => {\n  if (typeof entry === 'string') {\n    if (!isStorageType(entry)) {\n      return { cookies: [], localStorage: [], sessionStorage: [], headers: [] };\n    }\n    if (entry === 'cookie') return { cookies: [createCookieEntry()] };\n    if (entry === 'localStorage')\n      return { localStorage: [createWebStorageEntry()] };\n    if (entry === 'sessionStorage')\n      return { sessionStorage: [createWebStorageEntry()] };\n    if (entry === 'header') return { headers: [createHeaderEntry()] };\n  }\n\n  if (typeof entry === 'object' && entry !== null) {\n    const typedEntry = entry as CookiesAttributes | StorageAttributes;\n\n    if (isCookieEntry(typedEntry)) {\n      return { cookies: [createCookieEntry(typedEntry as CookiesAttributes)] };\n    }\n    if ('type' in typedEntry && typedEntry.type === 'localStorage') {\n      return {\n        localStorage: [createWebStorageEntry(typedEntry as StorageAttributes)],\n      };\n    }\n    if ('type' in typedEntry && typedEntry.type === 'sessionStorage') {\n      return {\n        sessionStorage: [\n          createWebStorageEntry(typedEntry as StorageAttributes),\n        ],\n      };\n    }\n    if ('type' in typedEntry && typedEntry.type === 'header') {\n      return { headers: [createHeaderEntry(typedEntry as StorageAttributes)] };\n    }\n    // Default to localStorage for ambiguous objects\n    return {\n      localStorage: [\n        createWebStorageEntry(typedEntry as Omit<StorageAttributes, 'type'>),\n      ],\n    };\n  }\n\n  return { cookies: [], localStorage: [], sessionStorage: [], headers: [] };\n};\n\nconst mergeStorageAttributes = (\n  accumulated: ProcessedStorageAttributes,\n  partial: Partial<ProcessedStorageAttributes>\n): ProcessedStorageAttributes => ({\n  cookies: [...(accumulated.cookies ?? []), ...(partial.cookies ?? [])],\n  localStorage: [\n    ...(accumulated.localStorage ?? []),\n    ...(partial.localStorage ?? []),\n  ],\n  sessionStorage: [\n    ...(accumulated.sessionStorage ?? []),\n    ...(partial.sessionStorage ?? []),\n  ],\n  headers: [...(accumulated.headers ?? []), ...(partial.headers ?? [])],\n});\n\n/**\n * Extracts and normalizes storage configuration into separate arrays for each storage type.\n * Called at config-build time so the result is pre-computed and stored in the config.\n *\n * @param options - The storage configuration from IntlayerConfig\n * @returns An object containing arrays for cookies, localStorage, sessionStorage and headers\n */\nexport const getStorageAttributes = (\n  options: RoutingStorageInput\n): ProcessedStorageAttributes => {\n  const emptyResult: ProcessedStorageAttributes = {\n    cookies: [],\n    localStorage: [],\n    sessionStorage: [],\n    headers: [],\n  };\n\n  if (options === false || options === undefined) return {};\n\n  const result = Array.isArray(options)\n    ? options.reduce<ProcessedStorageAttributes>((acc, entry) => {\n        const partial = processStorageEntry(entry);\n        return mergeStorageAttributes(acc, partial);\n      }, emptyResult)\n    : mergeStorageAttributes(emptyResult, processStorageEntry(options));\n\n  // Remove empty arrays\n  const cleanedResult: ProcessedStorageAttributes = {};\n\n  if (result.cookies && result.cookies.length > 0) {\n    cleanedResult.cookies = result.cookies;\n  }\n\n  if (result.localStorage && result.localStorage.length > 0) {\n    cleanedResult.localStorage = result.localStorage;\n  }\n\n  if (result.sessionStorage && result.sessionStorage.length > 0) {\n    cleanedResult.sessionStorage = result.sessionStorage;\n  }\n\n  if (result.headers && result.headers.length > 0) {\n    cleanedResult.headers = result.headers;\n  }\n\n  return cleanedResult;\n};\n"],"mappings":"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"}

package/dist/esm/bundle/index.mjs

@@ -1,7 +1,7 @@
 import { getAlias } from "../utils/alias.mjs";
 import { getConfiguration } from "../configFile/getConfiguration.mjs";
-import { BundleLogger } from "./logBundle.mjs";
 import { getConfigEnvVars } from "../envVars/envVars.mjs";
+import { BundleLogger } from "./logBundle.mjs";
 import { isAbsolute, join, resolve } from "node:path";
 import { mkdir, rm, writeFile } from "node:fs/promises";
 import packageJSON from "@intlayer/types/package.json" with { type: "json" };

package/dist/esm/configFile/buildBrowserConfiguration.mjs

@@ -12,9 +12,37 @@ import { MODE, PREFIX } from "../defaultValues/log.mjs";
 * @returns A fully-defaulted {@link InternationalizationConfig}.
 */
 const buildInternationalizationFields = (customConfiguration) => ({
+	/**
+	* Locales available in the application
+	*
+	* Default: ['en']
+	*
+	*/
 	locales: customConfiguration?.locales ?? LOCALES,
+	/**
+	* Locales required by TypeScript to ensure strong implementations of internationalized content using typescript.
+	*
+	* Default: []
+	*
+	* If empty, all locales are required in `strict` mode.
+	*
+	* Ensure required locales are also defined in the `locales` field.
+	*/
 	requiredLocales: customConfiguration?.requiredLocales ?? customConfiguration?.locales ?? REQUIRED_LOCALES,
+	/**
+	* Ensure strong implementations of internationalized content using typescript.
+	* - 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.
+	* - 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.
+	* - If set to "loose", the translation `t` function will accept any existing locale.
+	*
+	* Default: "inclusive"
+	*/
 	strictMode: customConfiguration?.strictMode ?? "inclusive",
+	/**
+	* Default locale of the application for fallback
+	*
+	* Default: 'en'
+	*/
 	defaultLocale: customConfiguration?.defaultLocale ?? "en"
 });
 /**
@@ -26,10 +54,84 @@ const buildInternationalizationFields = (customConfiguration) => ({
 const buildRoutingFields = (customConfiguration) => {
 	const storage = customConfiguration?.storage ?? STORAGE;
 	return {
+		/**
+		* URL routing mode for locale handling
+		*
+		* Controls how locales are represented in application URLs:
+		* - 'prefix-no-default': Prefix all locales except the default locale (default)
+		*    - en → /dashboard
+		*    - fr → /fr/dashboard
+		*
+		* - 'prefix-all': Prefix all locales including the default locale
+		*    - en → /en/dashboard
+		*    - fr → /fr/dashboard
+		*
+		* - 'search-params': Use search parameters for locale handling
+		*    - en → /dashboard?locale=en
+		*    - fr → /fr/dashboard?locale=fr
+		*
+		* - 'no-prefix': No locale prefixing in URLs
+		*    - en → /dashboard
+		*    - fr → /dashboard
+		*
+		* Default: 'prefix-no-default'
+		*/
 		mode: customConfiguration?.mode ?? "prefix-no-default",
+		/**
+		* Configuration for storing the locale in the client (localStorage or sessionStorage)
+		*
+		* If false, the locale will not be stored by the middleware.
+		* If true, the locale storage will consider all default values. (cookie and header)
+		*
+		* Default: ['cookie', 'header']
+		*
+		*/
 		storage: getStorageAttributes(storage),
+		/**
+		* Base path of the application URL
+		*
+		* Default: ''
+		*
+		* Example:
+		* - If the application is hosted at https://example.com/my-app
+		* - The base path is '/my-app'
+		* - The URL will be https://example.com/my-app/en
+		* - If the base path is not set, the URL will be https://example.com/en
+		*/
 		basePath: customConfiguration?.basePath ?? "",
+		/**
+		* Custom URL rewriting rules that override the default routing mode for specific paths.
+		* Allows you to define locale-specific paths that differ from the standard routing behavior.
+		* Supports dynamic route parameters using `[param]` syntax.
+		*
+		* Default: undefined
+		*
+		* Example:
+		* ```typescript
+		* rewrite: {
+		*   "/about": {
+		*     en: "/about",
+		*     fr: "/a-propos",
+		*   },
+		*   "/product/[slug]": {
+		*     en: "/product/[slug]",
+		*     fr: "/produit/[slug]",
+		*   },
+		* }
+		* ```
+		*
+		* Note:
+		* - The rewrite rules take precedence over the default `mode` behavior.
+		* - If a path matches a rewrite rule, the localized path from the rewrite configuration will be used.
+		* - Dynamic route parameters are supported using bracket notation (e.g., `[slug]`, `[id]`).
+		* - Works with both Next.js and Vite applications.
+		*/
 		rewrite: customConfiguration?.rewrite,
+		/**
+		* Maps locales to specific domain hostnames for domain-based routing.
+		*
+		* Default: undefined
+		*/
 		domains: customConfiguration?.domains
 	};
 };
@@ -46,17 +148,109 @@ const buildRoutingFields = (customConfiguration) => {
 const buildEditorFields = (customConfiguration) => {
 	const liveSyncPort = customConfiguration?.liveSyncPort ?? 4e3;
 	return {
+		/**
+		* URL of the application. Used to restrict the origin of the editor for security reasons.
+		*
+		* > '*' means that the editor is accessible from any origin
+		*
+		* Default: '*'
+		*/
 		applicationURL: customConfiguration?.applicationURL || void 0,
+		/**
+		* URL of the editor server. Used to restrict the origin of the editor for security reasons.
+		*
+		* > '*' means that the editor is accessible from any origin
+		*
+		* Default: '*'
+		*/
 		editorURL: customConfiguration?.editorURL || "http://localhost:8000",
+		/**
+		* URL of the CMS server. Used to restrict the origin of the editor for security reasons.
+		*/
 		cmsURL: customConfiguration?.cmsURL || "https://app.intlayer.org",
+		/**
+		* URL of the editor server
+		*
+		* Default: 'https://back.intlayer.org'
+		*/
 		backendURL: customConfiguration?.backendURL || "https://back.intlayer.org",
+		/** Port of the editor server
+		*
+		* Default: 8000
+		*/
 		port: customConfiguration?.port ?? 8e3,
+		/**
+		* Indicates if the application interact with the visual editor
+		*
+		* Default: false;
+		*
+		* If true, the editor will be able to interact with the application.
+		* If false, the editor will not be able to interact with the application.
+		* In any case, the editor can only be enabled by the visual editor.
+		* Disabling the editor for specific environments is a way to enforce the security.
+		*
+		* Usage:
+		* ```js
+		* {
+		*  // Other configurations
+		*  editor: {
+		*   enabled: process.env.NODE_ENV !== 'production',
+		*  }
+		* };
+		* ```
+		*/
 		enabled: customConfiguration?.enabled ?? false,
+		/**
+		* clientId and clientSecret allow the intlayer packages to authenticate with the backend using oAuth2 authentication.
+		* An access token is use to authenticate the user related to the project.
+		* To get an access token, go to https://app.intlayer.org/project and create an account.
+		*
+		* Default: undefined
+		*
+		* > 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.
+		*/
 		clientId: customConfiguration?.clientId ?? void 0,
+		/**
+		* clientId and clientSecret allow the intlayer packages to authenticate with the backend using oAuth2 authentication.
+		* An access token is use to authenticate the user related to the project.
+		* To get an access token, go to https://app.intlayer.org/project and create an account.
+		*
+		* Default: undefined
+		*
+		* > 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.
+		*/
 		clientSecret: customConfiguration?.clientSecret ?? void 0,
+		/**
+		* Strategy for prioritizing dictionaries. If a dictionary is both present online and locally, the content will be merge.
+		* However, is a field is defined in both dictionary, this setting determines which fields takes the priority over the other.
+		*
+		* Default: 'local_first'
+		*
+		* The strategy for prioritizing dictionaries. It can be either 'local_first' or 'distant_first'.
+		* - 'local_first': The first dictionary found in the locale is used.
+		* - 'distant_first': The first dictionary found in the distant locales is used.
+		*/
 		dictionaryPriorityStrategy: customConfiguration?.dictionaryPriorityStrategy ?? "local_first",
+		/**
+		* Indicates if the application should hot reload the locale configurations when a change is detected.
+		* For example, when a new dictionary is added or updated, the application will update the content tu display in the page.
+		*
+		* The hot reload is only available for clients of the `enterprise` plan.
+		*
+		* Default: false
+		*/
 		liveSync: customConfiguration?.liveSync ?? true,
+		/**
+		* Port of the live sync server
+		*
+		* Default: 4000
+		*/
 		liveSyncPort,
+		/**
+		* URL of the live sync server in case of remote live sync server
+		*
+		* Default: `http://localhost:${LIVE_SYNC_PORT}`
+		*/
 		liveSyncURL: customConfiguration?.liveSyncURL ?? `http://localhost:${liveSyncPort}`
 	};
 };
@@ -68,8 +262,27 @@ const buildEditorFields = (customConfiguration) => {
 * @returns A fully-defaulted {@link LogConfig}.
 */
 const buildLogFields = (customConfiguration, logFunctions) => ({
+	/**
+	* Indicates if the logger is enabled
+	*
+	* Default: 'prefix-no-default'
+	*
+	* If 'default', the logger is enabled and can be used.
+	* If 'verbose', the logger will be enabled and can be used, but will log more information.
+	* If 'disabled', the logger is disabled and cannot be used.
+	*/
 	mode: customConfiguration?.mode ?? "default",
+	/**
+	* Prefix of the logger
+	*
+	* Default: '[intlayer]'
+	*
+	* The prefix of the logger.
+	*/
 	prefix: customConfiguration?.prefix ?? PREFIX,
+	/**
+	* Functions to log
+	*/
 	error: logFunctions?.error,
 	log: logFunctions?.log,
 	info: logFunctions?.info,

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 {\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};\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     * Maps locales to specific domain hostnames for domain-based routing.\n     *\n     * Default: undefined\n     */\n    domains: customConfiguration?.domains,\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  };\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});\n"],"mappings":";;;;;;;;;;;;;AAwEA,MAAa,mCACX,yBACgC;CAOhC,SAAS,qBAAqB,WAAW;CAWzC,iBACE,qBAAqB,mBACrB,qBAAqB,WACrB;CAUF,YAAY,qBAAqB;CAOjC,eAAe,qBAAqB;CACrC;;;;;;;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;EAO9B,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;EACtB;;;;;;;;;;;;;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;CACF"}
+{"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 {\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};\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     * Maps locales to specific domain hostnames for domain-based routing.\n     *\n     * Default: undefined\n     */\n    domains: customConfiguration?.domains,\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  };\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});\n"],"mappings":";;;;;;;;;;;;;AAwEA,MAAa,mCACX,yBACgC;;;;;;;CAOhC,SAAS,qBAAqB,WAAW;;;;;;;;;;CAWzC,iBACE,qBAAqB,mBACrB,qBAAqB,WACrB;;;;;;;;;CAUF,YAAY,qBAAqB;;;;;;CAOjC,eAAe,qBAAqB;CACrC;;;;;;;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;;;;;;EAO9B,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;EACtB;;;;;;;;;;;;;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;CACF"}