@intlayer/engine 9.2.0 → 9.3.1

package/dist/esm/prepareIntlayer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"prepareIntlayer.mjs","names":[],"sources":["../../src/prepareIntlayer.ts"],"sourcesContent":["import { stat } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport packageJson from '@intlayer/config/package.json' with { type: 'json' };\nimport { cacheDisk } from '@intlayer/config/utils';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { buildDictionary } from './buildIntlayerDictionary/buildIntlayerDictionary';\nimport { writeRemoteDictionary } from './buildIntlayerDictionary/writeRemoteDictionary';\nimport { cleanOutputDir } from './cleanOutputDir';\nimport { createDictionaryEntryPoint } from './createDictionaryEntryPoint/createDictionaryEntryPoint';\nimport { createModuleAugmentation, createTypes } from './createType/index';\nimport { listDictionariesWithStats } from './listDictionariesPath';\nimport { loadDictionaries } from './loadDictionaries/loadDictionaries';\nimport { runOnce } from './utils/runOnce';\nimport {\n  isCachedConfigurationUpToDate,\n  writeConfiguration,\n} from './writeConfiguration';\n\ntype PrepareIntlayerOptions = {\n  clean?: boolean;\n  env?: 'prod' | 'dev';\n  format?: ('cjs' | 'esm')[];\n  forceRun?: boolean;\n  cacheTimeoutMs?: number;\n  onIsCached?: () => void | Promise<void>;\n};\n\nconst DEFAULT_PREPARE_INTLAYER_OPTIONS = {\n  clean: false,\n  env: 'dev',\n  format: ['cjs', 'esm'],\n  cacheTimeoutMs: 1000 * 60 * 60, // 1 hour\n} satisfies PrepareIntlayerOptions;\n\nexport const prepareIntlayer = async (\n  configuration: IntlayerConfig,\n  options?: PrepareIntlayerOptions\n) => {\n  const appLogger = getAppLogger(configuration);\n\n  const sentinelPath = join(\n    configuration.system.cacheDir,\n    'intlayer-prepared.lock'\n  );\n  // Clean output dir if the intlayer version has changed\n  const versionCache = cacheDisk(configuration, ['intlayer-version']);\n  const intlayerCacheVersion = await versionCache.get();\n  const isCorrectVersion = Boolean(\n    intlayerCacheVersion === undefined ||\n      intlayerCacheVersion === packageJson.version\n  );\n\n  const isConfigSimilar = await isCachedConfigurationUpToDate(configuration);\n\n  // Check if any dictionary has been changed to force a new rebuild\n  const dictionariesWithStats = await listDictionariesWithStats(configuration);\n  let isDictionaryChanged = false;\n  try {\n    // Try catch as sentinel file may not exist yet\n    const sentinelStats = await stat(sentinelPath);\n    isDictionaryChanged = dictionariesWithStats.some(\n      (dictionary) =>\n        dictionary.stats.mtime.getTime() > sentinelStats.mtime.getTime()\n    );\n  } catch {}\n\n  const resolvedPlugins = await Promise.all(configuration.plugins ?? []);\n  const hasPluginLoadDictionaries = resolvedPlugins.some((plugin) =>\n    Boolean(plugin.loadDictionaries)\n  ); // Disable cache if any plugin because it can have custom behavior\n\n  const { clean, format, forceRun, onIsCached, cacheTimeoutMs, env } = {\n    ...DEFAULT_PREPARE_INTLAYER_OPTIONS,\n    forceRun:\n      !isCorrectVersion ||\n      !isConfigSimilar ||\n      isDictionaryChanged ||\n      hasPluginLoadDictionaries,\n    ...(options ?? {}),\n  };\n\n  // Skip preparation if it has already been done recently\n  await runOnce(\n    sentinelPath,\n    async ({ renewLock }) => {\n      // comment because of issue with next and webpack\n      // await checkVersionsConsistency(configuration);\n\n      // Re-read the cached version now that the lock is held: another process\n      // may have upgraded the output directory while this call was queued, in\n      // which case cleaning it would throw away a build that just completed.\n      const isCorrectVersionUnderLock =\n        (await versionCache.get()) === packageJson.version;\n\n      if (clean || !isCorrectVersionUnderLock) {\n        await cleanOutputDir(configuration);\n        // `cleanOutputDir` wipes the cache directory the sentinel lives in.\n        // Re-create it immediately, otherwise a concurrent process (e.g. the\n        // `intlayer watch` CLI next to a dev server) sees no lock, starts its\n        // own run, and cleans the output directory while this one writes.\n        await renewLock();\n      }\n\n      await versionCache.set(packageJson.version);\n\n      const preparationStartMs = Date.now();\n\n      appLogger([\n        'Preparing Intlayer',\n        colorize(`(v${packageJson.version})`, ANSIColors.GREY_DARK),\n      ]);\n\n      await writeConfiguration(configuration);\n\n      const configurationWrittenTime = Date.now();\n\n      appLogger(\n        [\n          'Configuration written',\n          colorize(\n            `(${configurationWrittenTime - preparationStartMs}ms)`,\n            ANSIColors.GREY_DARK\n          ),\n        ],\n        {\n          isVerbose: true,\n        }\n      );\n\n      const contentDeclarationPaths = dictionariesWithStats.map(\n        (dictionary) => dictionary.path\n      );\n\n      const dictionaries = await loadDictionaries(\n        contentDeclarationPaths,\n        configuration\n      );\n\n      const dictionariesLoadedTime = Date.now();\n\n      appLogger(\n        [\n          'Content loaded',\n          colorize(\n            [\n              dictionaries.remoteDictionaries.length +\n                dictionaries.pluginDictionaries.length >\n              0\n                ? [\n                    `(Total: ${dictionariesLoadedTime - configurationWrittenTime}ms`,\n                    dictionaries.localDictionaries.length > 0\n                      ? ` - Local: ${dictionaries.time.localDictionaries}ms`\n                      : '',\n                    dictionaries.remoteDictionaries.length > 0\n                      ? ` - Remote: ${dictionaries.time.remoteDictionaries}ms`\n                      : '',\n                    dictionaries.pluginDictionaries.length > 0\n                      ? ` - Plugin: ${dictionaries.time.pluginDictionaries}ms`\n                      : '',\n                    `)`,\n                  ].join('')\n                : `(${dictionariesLoadedTime - configurationWrittenTime}ms)`,\n            ].join(''),\n            ANSIColors.GREY_DARK\n          ),\n        ],\n        {\n          isVerbose: true,\n        }\n      );\n\n      // Build local dictionaries\n      const dictionariesOutput = await buildDictionary(\n        [\n          ...dictionaries.localDictionaries,\n          ...dictionaries.remoteDictionaries,\n          ...dictionaries.pluginDictionaries,\n        ],\n        configuration,\n        { formats: format, importOtherDictionaries: false, env }\n      );\n\n      // Write remote dictionaries\n      // Used as cache for next fetch\n      await writeRemoteDictionary(\n        dictionaries.remoteDictionaries,\n        configuration\n      );\n\n      const dictionariesToBuild = Object.values(\n        dictionariesOutput?.mergedDictionaries ?? {}\n      ).map((dictionary) => dictionary.dictionary);\n\n      await createTypes(dictionariesToBuild, configuration);\n\n      await createDictionaryEntryPoint(configuration, {\n        formats: options?.format,\n      });\n\n      const dictionariesBuiltTime = Date.now();\n\n      appLogger([\n        'Dictionaries built',\n        colorize(\n          `(${dictionariesBuiltTime - preparationStartMs}ms)`,\n          ANSIColors.GREY_DARK\n        ),\n      ]);\n\n      await createModuleAugmentation(configuration);\n\n      const moduleAugmentationBuiltTime = Date.now();\n\n      appLogger(\n        [\n          'Module augmentation built',\n          colorize(\n            `(${moduleAugmentationBuiltTime - dictionariesBuiltTime}ms)`,\n            ANSIColors.GREY_DARK\n          ),\n        ],\n        {\n          isVerbose: true,\n        }\n      );\n\n      // Plugin transformation\n      // Allow plugins to post-process the final build output (e.g., write back ICU JSON)\n      for await (const plugin of configuration.plugins ?? []) {\n        const { unmergedDictionaries, mergedDictionaries } = dictionariesOutput;\n\n        try {\n          await plugin.afterBuild?.({\n            dictionaries: {\n              unmergedDictionaries,\n              mergedDictionaries,\n            },\n            configuration,\n          });\n        } catch (error) {\n          // A failing write-back (e.g. transient network error on a remote\n          // target) must not invalidate the dictionaries already built.\n          appLogger(\n            [\n              `Plugin ${plugin.name} afterBuild failed:`,\n              (error as Error).message,\n            ],\n            { level: 'error' }\n          );\n        }\n      }\n\n      const preparationElapsedMs = Date.now() - preparationStartMs;\n      appLogger(\n        [`Done`, colorize(`${preparationElapsedMs}ms`, ANSIColors.GREEN)],\n        {\n          level: 'info',\n          isVerbose: true,\n        }\n      );\n    },\n    {\n      forceRun,\n      onIsCached,\n      cacheTimeoutMs,\n    }\n  );\n};\n"],"mappings":"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"}
+{"version":3,"file":"prepareIntlayer.mjs","names":[],"sources":["../../src/prepareIntlayer.ts"],"sourcesContent":["import { stat } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport packageJson from '@intlayer/config/package.json' with { type: 'json' };\nimport { cacheDisk } from '@intlayer/config/utils';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { buildDictionary } from './buildIntlayerDictionary/buildIntlayerDictionary';\nimport { writeRemoteDictionary } from './buildIntlayerDictionary/writeRemoteDictionary';\nimport { cleanOutputDir } from './cleanOutputDir';\nimport { createDictionaryEntryPoint } from './createDictionaryEntryPoint/createDictionaryEntryPoint';\nimport { createModuleAugmentation, createTypes } from './createType/index';\nimport { listDictionariesWithStats } from './listDictionariesPath';\nimport { loadDictionaries } from './loadDictionaries/loadDictionaries';\nimport { runOnce } from './utils/runOnce';\nimport {\n  isCachedConfigurationUpToDate,\n  writeConfiguration,\n} from './writeConfiguration';\n\ntype PrepareIntlayerOptions = {\n  clean?: boolean;\n  env?: 'prod' | 'dev';\n  format?: ('cjs' | 'esm')[];\n  forceRun?: boolean;\n  cacheTimeoutMs?: number;\n  onIsCached?: () => void | Promise<void>;\n};\n\nconst DEFAULT_PREPARE_INTLAYER_OPTIONS = {\n  clean: false,\n  env: 'dev',\n  format: ['cjs', 'esm'],\n  cacheTimeoutMs: 1000 * 60 * 60, // 1 hour\n} satisfies PrepareIntlayerOptions;\n\nexport const prepareIntlayer = async (\n  configuration: IntlayerConfig,\n  options?: PrepareIntlayerOptions\n) => {\n  const appLogger = getAppLogger(configuration);\n\n  const sentinelPath = join(\n    configuration.system.cacheDir,\n    'intlayer-prepared.lock'\n  );\n  // Clean output dir if the intlayer version has changed\n  const versionCache = cacheDisk(configuration, ['intlayer-version']);\n  const intlayerCacheVersion = await versionCache.get();\n  const isCorrectVersion = Boolean(\n    intlayerCacheVersion === undefined ||\n      intlayerCacheVersion === packageJson.version\n  );\n\n  const isConfigSimilar = await isCachedConfigurationUpToDate(configuration);\n\n  // Check if any dictionary has been changed to force a new rebuild\n  const dictionariesWithStats = await listDictionariesWithStats(configuration);\n  let isDictionaryChanged = false;\n  try {\n    // Try catch as sentinel file may not exist yet\n    const sentinelStats = await stat(sentinelPath);\n    isDictionaryChanged = dictionariesWithStats.some(\n      (dictionary) =>\n        dictionary.stats.mtime.getTime() > sentinelStats.mtime.getTime()\n    );\n  } catch {}\n\n  const resolvedPlugins = await Promise.all(configuration.plugins ?? []);\n  const hasPluginLoadDictionaries = resolvedPlugins.some((plugin) =>\n    Boolean(plugin.loadDictionaries)\n  ); // Disable cache if any plugin because it can have custom behavior\n\n  const { clean, format, forceRun, onIsCached, cacheTimeoutMs, env } = {\n    ...DEFAULT_PREPARE_INTLAYER_OPTIONS,\n    forceRun:\n      !isCorrectVersion ||\n      !isConfigSimilar ||\n      isDictionaryChanged ||\n      hasPluginLoadDictionaries,\n    ...(options ?? {}),\n  };\n\n  // Skip preparation if it has already been done recently\n  await runOnce(\n    sentinelPath,\n    async ({ renewLock }) => {\n      // comment because of issue with next and webpack\n      // await checkVersionsConsistency(configuration);\n\n      // Re-read the cached version now that the lock is held: another process\n      // may have upgraded the output directory while this call was queued, in\n      // which case cleaning it would throw away a build that just completed.\n      const isCorrectVersionUnderLock =\n        (await versionCache.get()) === packageJson.version;\n\n      if (clean || !isCorrectVersionUnderLock) {\n        await cleanOutputDir(configuration);\n        // `cleanOutputDir` wipes the cache directory the sentinel lives in.\n        // Re-create it immediately, otherwise a concurrent process (e.g. the\n        // `intlayer watch` CLI next to a dev server) sees no lock, starts its\n        // own run, and cleans the output directory while this one writes.\n        await renewLock();\n      }\n\n      await versionCache.set(packageJson.version);\n\n      const preparationStartMs = Date.now();\n\n      appLogger([\n        'Preparing Intlayer',\n        colorize(`(v${packageJson.version})`, ANSIColors.GREY_DARK),\n      ]);\n\n      await writeConfiguration(configuration);\n\n      const configurationWrittenTime = Date.now();\n\n      appLogger(\n        [\n          'Configuration written',\n          colorize(\n            `(${configurationWrittenTime - preparationStartMs}ms)`,\n            ANSIColors.GREY_DARK\n          ),\n        ],\n        {\n          isVerbose: true,\n        }\n      );\n\n      const contentDeclarationPaths = dictionariesWithStats.map(\n        (dictionary) => dictionary.path\n      );\n\n      const dictionaries = await loadDictionaries(\n        contentDeclarationPaths,\n        configuration\n      );\n\n      const dictionariesLoadedTime = Date.now();\n\n      appLogger(\n        [\n          'Content loaded',\n          colorize(\n            [\n              dictionaries.remoteDictionaries.length +\n                dictionaries.pluginDictionaries.length >\n              0\n                ? [\n                    `(Total: ${dictionariesLoadedTime - configurationWrittenTime}ms`,\n                    dictionaries.localDictionaries.length > 0\n                      ? ` - Local: ${dictionaries.time.localDictionaries}ms`\n                      : '',\n                    dictionaries.remoteDictionaries.length > 0\n                      ? ` - Remote: ${dictionaries.time.remoteDictionaries}ms`\n                      : '',\n                    dictionaries.pluginDictionaries.length > 0\n                      ? ` - Plugin: ${dictionaries.time.pluginDictionaries}ms`\n                      : '',\n                    `)`,\n                  ].join('')\n                : `(${dictionariesLoadedTime - configurationWrittenTime}ms)`,\n            ].join(''),\n            ANSIColors.GREY_DARK\n          ),\n        ],\n        {\n          isVerbose: true,\n        }\n      );\n\n      // Build local dictionaries\n      const dictionariesOutput = await buildDictionary(\n        [\n          ...dictionaries.localDictionaries,\n          ...dictionaries.remoteDictionaries,\n          ...dictionaries.pluginDictionaries,\n        ],\n        configuration,\n        { formats: format, importOtherDictionaries: false, env }\n      );\n\n      // Write remote dictionaries\n      // Used as cache for next fetch\n      await writeRemoteDictionary(\n        dictionaries.remoteDictionaries,\n        configuration\n      );\n\n      const dictionariesToBuild = Object.values(\n        dictionariesOutput?.mergedDictionaries ?? {}\n      ).map((dictionary) => dictionary.dictionary);\n\n      await createTypes(dictionariesToBuild, configuration);\n\n      await createDictionaryEntryPoint(configuration, {\n        formats: options?.format,\n      });\n\n      const dictionariesBuiltTime = Date.now();\n\n      appLogger([\n        'Dictionaries built',\n        colorize(\n          `(${dictionariesBuiltTime - preparationStartMs}ms)`,\n          ANSIColors.GREY_DARK\n        ),\n      ]);\n\n      await createModuleAugmentation(configuration);\n\n      const moduleAugmentationBuiltTime = Date.now();\n\n      appLogger(\n        [\n          'Module augmentation built',\n          colorize(\n            `(${moduleAugmentationBuiltTime - dictionariesBuiltTime}ms)`,\n            ANSIColors.GREY_DARK\n          ),\n        ],\n        {\n          isVerbose: true,\n        }\n      );\n\n      // Plugin transformation\n      // Allow plugins to post-process the final build output (e.g., write back ICU JSON)\n      for await (const plugin of configuration.plugins ?? []) {\n        const { unmergedDictionaries, mergedDictionaries } = dictionariesOutput;\n\n        try {\n          await plugin.afterBuild?.({\n            dictionaries: {\n              unmergedDictionaries,\n              mergedDictionaries,\n            },\n            configuration,\n          });\n        } catch (error) {\n          // A failing write-back (e.g. transient network error on a remote\n          // target) must not invalidate the dictionaries already built.\n          appLogger(\n            [\n              `Plugin ${plugin.name} afterBuild failed:`,\n              (error as Error).message,\n            ],\n            { level: 'error' }\n          );\n        }\n      }\n\n      const preparationElapsedMs = Date.now() - preparationStartMs;\n      appLogger(\n        [`Done`, colorize(`${preparationElapsedMs}ms`, ANSIColors.GREEN)],\n        {\n          level: 'info',\n          isVerbose: true,\n        }\n      );\n    },\n    {\n      forceRun,\n      onIsCached,\n      cacheTimeoutMs,\n    }\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AA6BA,MAAM,mCAAmC;CACvC,OAAO;CACP,KAAK;CACL,QAAQ,CAAC,OAAO,KAAK;CACrB,gBAAgB;AAClB;AAEA,MAAa,kBAAkB,OAC7B,eACA,YACG;CACH,MAAM,YAAY,aAAa,aAAa;CAE5C,MAAM,eAAe,KACnB,cAAc,OAAO,UACrB,wBACF;CAEA,MAAM,eAAe,UAAU,eAAe,CAAC,kBAAkB,CAAC;CAClE,MAAM,uBAAuB,MAAM,aAAa,IAAI;CACpD,MAAM,mBAAmB,QACvB,yBAAyB,UACvB,yBAAyB,YAAY,OACzC;CAEA,MAAM,kBAAkB,MAAM,8BAA8B,aAAa;CAGzE,MAAM,wBAAwB,MAAM,0BAA0B,aAAa;CAC3E,IAAI,sBAAsB;CAC1B,IAAI;EAEF,MAAM,gBAAgB,MAAM,KAAK,YAAY;EAC7C,sBAAsB,sBAAsB,MACzC,eACC,WAAW,MAAM,MAAM,QAAQ,IAAI,cAAc,MAAM,QAAQ,CACnE;CACF,QAAQ,CAAC;CAGT,MAAM,6BAA4B,MADJ,QAAQ,IAAI,cAAc,WAAW,CAAC,CAAC,EACpB,CAAC,MAAM,WACtD,QAAQ,OAAO,gBAAgB,CACjC;CAEA,MAAM,EAAE,OAAO,QAAQ,UAAU,YAAY,gBAAgB,QAAQ;EACnE,GAAG;EACH,UACE,CAAC,oBACD,CAAC,mBACD,uBACA;EACF,GAAI,WAAW,CAAC;CAClB;CAGA,MAAM,QACJ,cACA,OAAO,EAAE,gBAAgB;EAOvB,MAAM,4BACH,MAAM,aAAa,IAAI,MAAO,YAAY;EAE7C,IAAI,SAAS,CAAC,2BAA2B;GACvC,MAAM,eAAe,aAAa;GAKlC,MAAM,UAAU;EAClB;EAEA,MAAM,aAAa,IAAI,YAAY,OAAO;EAE1C,MAAM,qBAAqB,KAAK,IAAI;EAEpC,UAAU,CACR,sBACA,SAAS,KAAK,YAAY,QAAQ,IAAI,WAAW,SAAS,CAC5D,CAAC;EAED,MAAM,mBAAmB,aAAa;EAEtC,MAAM,2BAA2B,KAAK,IAAI;EAE1C,UACE,CACE,yBACA,SACE,IAAI,2BAA2B,mBAAmB,MAClD,WAAW,SACb,CACF,GACA,EACE,WAAW,KACb,CACF;EAEA,MAAM,0BAA0B,sBAAsB,KACnD,eAAe,WAAW,IAC7B;EAEA,MAAM,eAAe,MAAM,iBACzB,yBACA,aACF;EAEA,MAAM,yBAAyB,KAAK,IAAI;EAExC,UACE,CACE,kBACA,SACE,CACE,aAAa,mBAAmB,SAC9B,aAAa,mBAAmB,SAClC,IACI;GACE,WAAW,yBAAyB,yBAAyB;GAC7D,aAAa,kBAAkB,SAAS,IACpC,aAAa,aAAa,KAAK,kBAAkB,MACjD;GACJ,aAAa,mBAAmB,SAAS,IACrC,cAAc,aAAa,KAAK,mBAAmB,MACnD;GACJ,aAAa,mBAAmB,SAAS,IACrC,cAAc,aAAa,KAAK,mBAAmB,MACnD;GACJ;EACF,CAAC,CAAC,KAAK,EAAE,IACT,IAAI,yBAAyB,yBAAyB,IAC5D,CAAC,CAAC,KAAK,EAAE,GACT,WAAW,SACb,CACF,GACA,EACE,WAAW,KACb,CACF;EAGA,MAAM,qBAAqB,MAAM,gBAC/B;GACE,GAAG,aAAa;GAChB,GAAG,aAAa;GAChB,GAAG,aAAa;EAClB,GACA,eACA;GAAE,SAAS;GAAQ,yBAAyB;GAAO;EAAI,CACzD;EAIA,MAAM,sBACJ,aAAa,oBACb,aACF;EAEA,MAAM,sBAAsB,OAAO,OACjC,oBAAoB,sBAAsB,CAAC,CAC7C,CAAC,CAAC,KAAK,eAAe,WAAW,UAAU;EAE3C,MAAM,YAAY,qBAAqB,aAAa;EAEpD,MAAM,2BAA2B,eAAe,EAC9C,SAAS,SAAS,OACpB,CAAC;EAED,MAAM,wBAAwB,KAAK,IAAI;EAEvC,UAAU,CACR,sBACA,SACE,IAAI,wBAAwB,mBAAmB,MAC/C,WAAW,SACb,CACF,CAAC;EAED,MAAM,yBAAyB,aAAa;EAI5C,UACE,CACE,6BACA,SACE,IAN8B,KAAK,IAML,IAAI,sBAAsB,MACxD,WAAW,SACb,CACF,GACA,EACE,WAAW,KACb,CACF;EAIA,WAAW,MAAM,UAAU,cAAc,WAAW,CAAC,GAAG;GACtD,MAAM,EAAE,sBAAsB,uBAAuB;GAErD,IAAI;IACF,MAAM,OAAO,aAAa;KACxB,cAAc;MACZ;MACA;KACF;KACA;IACF,CAAC;GACH,SAAS,OAAO;IAGd,UACE,CACE,UAAU,OAAO,KAAK,sBACrB,MAAgB,OACnB,GACA,EAAE,OAAO,QAAQ,CACnB;GACF;EACF;EAEA,MAAM,uBAAuB,KAAK,IAAI,IAAI;EAC1C,UACE,CAAC,QAAQ,SAAS,GAAG,qBAAqB,KAAK,WAAW,KAAK,CAAC,GAChE;GACE,OAAO;GACP,WAAW;EACb,CACF;CACF,GACA;EACE;EACA;EACA;CACF,CACF;AACF"}

package/dist/esm/reduceDictionaryContent/reduceDictionaryContent.mjs

@@ -3,7 +3,8 @@ import { getMaskContent } from "@intlayer/core/plugins";
 
 //#region src/reduceDictionaryContent/reduceDictionaryContent.ts
 const reduceDictionaryContent = (fullDictionary, partialDictionary) => {
-	return applyMask(fullDictionary, getMaskContent(partialDictionary));
+	const mask = getMaskContent(partialDictionary);
+	return applyMask(fullDictionary, mask);
 };
 
 //#endregion

package/dist/esm/reduceDictionaryContent/reduceDictionaryContent.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"reduceDictionaryContent.mjs","names":[],"sources":["../../../src/reduceDictionaryContent/reduceDictionaryContent.ts"],"sourcesContent":["import { getMaskContent } from '@intlayer/core/plugins';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport { applyMask } from './applyMask';\n\nexport const reduceDictionaryContent = (\n  fullDictionary: Dictionary,\n  partialDictionary: Dictionary\n) => {\n  const mask = getMaskContent(partialDictionary);\n  const result = applyMask(fullDictionary, mask);\n\n  return result;\n};\n"],"mappings":";;;;AAIA,MAAa,2BACX,gBACA,sBACG;CAIH,OAFe,UAAU,gBADZ,eAAe,iBACgB,CAEhC;AACd"}
+{"version":3,"file":"reduceDictionaryContent.mjs","names":[],"sources":["../../../src/reduceDictionaryContent/reduceDictionaryContent.ts"],"sourcesContent":["import { getMaskContent } from '@intlayer/core/plugins';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport { applyMask } from './applyMask';\n\nexport const reduceDictionaryContent = (\n  fullDictionary: Dictionary,\n  partialDictionary: Dictionary\n) => {\n  const mask = getMaskContent(partialDictionary);\n  const result = applyMask(fullDictionary, mask);\n\n  return result;\n};\n"],"mappings":";;;;AAIA,MAAa,2BACX,gBACA,sBACG;CACH,MAAM,OAAO,eAAe,iBAAiB;CAG7C,OAFe,UAAU,gBAAgB,IAE7B;AACd"}

package/dist/esm/scan/checks.mjs

@@ -5,7 +5,7 @@ import { ALL_LOCALES } from "@intlayer/types/allLocales";
 //#region src/scan/checks.ts
 /** Format a byte count as a human-readable size. */
 const formatSize = (bytes) => {
-	if (bytes >= 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
+	if (bytes >= 1048576) return `${(bytes / 1048576).toFixed(2)} MB`;
 	if (bytes >= 1024) return `${(bytes / 1024).toFixed(2)} KB`;
 	return `${bytes} B`;
 };

package/dist/esm/scan/checks.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"checks.mjs","names":[],"sources":["../../../src/scan/checks.ts"],"sourcesContent":["import { ALL_LOCALES } from '@intlayer/types/allLocales';\nimport { analyzeBundleContent } from './analyzeBundleContent';\nimport {\n  type Anchor,\n  extractHreflangs,\n  extractHtmlDir,\n  extractHtmlLang,\n  hasCanonical,\n} from './parseHtml';\nimport type {\n  BundleChunkInput,\n  BundleContentAnalysis,\n  ScanEvent,\n} from './types';\n\n/** Format a byte count as a human-readable size. */\nexport const formatSize = (bytes: number): string => {\n  if (bytes >= 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;\n  if (bytes >= 1024) return `${(bytes / 1024).toFixed(2)} KB`;\n  return `${bytes} B`;\n};\n\n/**\n * Check the `<html>` element attributes (`lang`, `dir`) and the resulting\n * current-locale signal. Returns the detected language tag.\n */\nexport const checkHtmlAttributes = (\n  html: string,\n  targetUrl: string,\n  events: ScanEvent[]\n): { langTag: string | undefined } => {\n  const langTag = extractHtmlLang(html);\n  const dirTag = extractHtmlDir(html);\n\n  events.push({\n    type: `url_htmlLang\\\\${targetUrl}`,\n    status: langTag ? 'success' : 'error',\n    details: {\n      success: langTag,\n      error: langTag ? undefined : 'Missing html lang attribute',\n    },\n  });\n\n  events.push({\n    type: `url_currentLocale\\\\${targetUrl}`,\n    status: langTag ? 'success' : 'warning',\n    details: {\n      success: langTag,\n      warning: langTag ? undefined : 'No locale detected',\n    },\n  });\n\n  events.push({\n    type: `url_htmlDir\\\\${targetUrl}`,\n    status: dirTag ? 'success' : 'warning',\n    details: {\n      success: dirTag,\n      warning: dirTag ? undefined : 'Missing html dir attribute',\n    },\n  });\n\n  return { langTag };\n};\n\n/** Check the presence of a canonical link. */\nexport const checkCanonical = (\n  html: string,\n  targetUrl: string,\n  events: ScanEvent[]\n): void => {\n  const present = hasCanonical(html);\n  events.push({\n    type: `url_hasCanonical\\\\${targetUrl}`,\n    status: present ? 'success' : 'warning',\n    details: { warning: present ? undefined : 'Missing canonical link' },\n  });\n};\n\n/**\n * Check the page's hreflang structure and collect discovered locales into\n * `localesSet`.\n */\nexport const checkLinguisticStructure = (\n  html: string,\n  targetUrl: string,\n  localesSet: Set<string>,\n  events: ScanEvent[]\n): void => {\n  const langTag = extractHtmlLang(html);\n  if (langTag) localesSet.add(langTag);\n\n  const hreflangs = extractHreflangs(html);\n  for (const { hreflang } of hreflangs) {\n    if (hreflang !== 'x-default') localesSet.add(hreflang);\n  }\n\n  const hasXDefault = hreflangs.some((h) => h.hreflang === 'x-default');\n\n  events.push({\n    type: `url_hreflang\\\\${targetUrl}`,\n    status: hreflangs.length > 0 ? 'success' : 'warning',\n    details: {\n      success: hreflangs.length > 0 ? hreflangs : undefined,\n      warning: hreflangs.length === 0 ? 'No hreflang tags found' : undefined,\n    },\n  });\n\n  events.push({\n    type: `url_hasXDefault\\\\${targetUrl}`,\n    status: hasXDefault ? 'success' : 'error',\n    details: {\n      error: hasXDefault ? undefined : 'Missing x-default hreflang link',\n    },\n  });\n};\n\nconst normalizeHost = (host: string): string =>\n  host.startsWith('www.') ? host.slice(4) : host;\n\nconst localeValues = Object.values(ALL_LOCALES) as string[];\n\n/**\n * Check whether internal links carry a locale segment, mirroring the hosted\n * audit's URL-structure analysis but operating on parsed anchors instead of a\n * live DOM.\n */\nexport const checkUrlStructure = (\n  anchors: Anchor[],\n  origin: string,\n  targetUrl: string,\n  events: ScanEvent[]\n): void => {\n  const targetHostname = normalizeHost(new URL(origin).hostname);\n\n  let localizedCount = 0;\n  let totalInternalCount = 0;\n  const nonLocalizedLinks: string[] = [];\n\n  for (const { href } of anchors) {\n    if (!href || href.startsWith('#') || href.startsWith('javascript:'))\n      continue;\n\n    try {\n      const url = new URL(href, origin);\n      if (normalizeHost(url.hostname) !== targetHostname) continue;\n\n      totalInternalCount++;\n      const path = url.pathname.toLowerCase();\n      const hostname = url.hostname.toLowerCase();\n\n      const hasLocaleInPath = localeValues.some((locale) => {\n        const l = locale.toLowerCase();\n        return path === `/${l}` || path.includes(`/${l}/`);\n      });\n      const hasLocaleInSubdomain = localeValues.some((locale) => {\n        const l = locale.toLowerCase();\n        return hostname.startsWith(`${l}.`) || hostname.includes(`.${l}.`);\n      });\n\n      if (hasLocaleInPath || hasLocaleInSubdomain) {\n        localizedCount++;\n      } else {\n        nonLocalizedLinks.push(href);\n      }\n    } catch {\n      /* ignore malformed URLs */\n    }\n  }\n\n  const hasLocalizedLinks = localizedCount > 0;\n  const allAnchorsLocalized =\n    totalInternalCount === 0 || localizedCount === totalInternalCount;\n\n  events.push({\n    type: `url_hasLocalizedLinks\\\\${targetUrl}`,\n    status: hasLocalizedLinks ? 'success' : 'warning',\n    details: {\n      success: hasLocalizedLinks\n        ? `${localizedCount} localized links found out of ${totalInternalCount} internal links`\n        : undefined,\n      warning: hasLocalizedLinks ? undefined : 'No localized links found',\n    },\n  });\n\n  events.push({\n    type: `url_allAnchorsLocalized\\\\${targetUrl}`,\n    status: allAnchorsLocalized ? 'success' : 'warning',\n    details: {\n      warning: allAnchorsLocalized\n        ? undefined\n        : {\n            message: 'Some internal links are not localized',\n            links: nonLocalizedLinks,\n          },\n    },\n  });\n};\n\n/**\n * Analyze the JavaScript bundles for unused locale content and emit the\n * corresponding event. Returns the analysis so callers can report on it.\n */\nexport const checkBundleContent = (\n  chunks: BundleChunkInput[],\n  html: string,\n  currentLocale: string | undefined,\n  targetUrl: string,\n  totalPageSize: number,\n  events: ScanEvent[]\n): BundleContentAnalysis | undefined => {\n  if (!currentLocale) {\n    events.push({\n      type: `url_unusedBundleContent\\\\${targetUrl}`,\n      status: 'warning',\n      details: {\n        warning: 'Cannot analyse bundle content: page locale not detected',\n      },\n    });\n    return undefined;\n  }\n\n  const analysis = analyzeBundleContent(\n    chunks,\n    html,\n    currentLocale,\n    totalPageSize\n  );\n\n  // Status is driven by the main bundle — lazy chunks with unused content are expected.\n  const mainBundleMaxUnused = analysis.mainBundleChunks.reduce(\n    (max, c) => Math.max(max, c.unusedPercent),\n    0\n  );\n\n  const status =\n    mainBundleMaxUnused === 0\n      ? 'success'\n      : mainBundleMaxUnused <= 30\n        ? 'warning'\n        : 'error';\n\n  events.push({\n    type: `url_unusedBundleContent\\\\${targetUrl}`,\n    status,\n    details: { [status]: analysis },\n  });\n\n  return analysis;\n};\n\n/** Fetch and check `robots.txt`, emitting robots-related events. */\nexport const checkRobots = async (\n  origin: string,\n  discoveredLocales: Set<string>,\n  userAgent: string,\n  events: ScanEvent[]\n): Promise<void> => {\n  let robotsPresent = false;\n  let noLocalizedUrlsForgotten = true;\n  const errors: string[] = [];\n\n  try {\n    const response = await fetch(`${origin}/robots.txt`, {\n      headers: { 'User-Agent': userAgent },\n    });\n\n    if (response.ok) {\n      robotsPresent = true;\n      const content = await response.text();\n\n      if (content && discoveredLocales.size > 0) {\n        const disallowedPaths = content\n          .split('\\n')\n          .map((line) => line.trim().toLowerCase())\n          .filter((line) => line.startsWith('disallow:'))\n          .map((line) => line.slice('disallow:'.length).trim());\n\n        for (const locale of discoveredLocales) {\n          for (const path of disallowedPaths) {\n            if (path === `/${locale}` || path === `/${locale}/`) {\n              noLocalizedUrlsForgotten = false;\n              errors.push(\n                `Locale path \"${locale}\" appears to be blocked in robots.txt: ${path}`\n              );\n            }\n          }\n        }\n      }\n    }\n  } catch (error) {\n    errors.push(\n      `Failed to fetch robots.txt: ${error instanceof Error ? error.message : 'Unknown error'}`\n    );\n  }\n\n  events.push({\n    type: 'robots_robotsPresent',\n    status: robotsPresent ? 'success' : 'warning',\n    details: {\n      warning: robotsPresent ? undefined : 'No robots.txt found',\n      error: errors.length > 0 ? errors : undefined,\n    },\n  });\n\n  if (robotsPresent) {\n    events.push({\n      type: 'robots_noLocalizedUrlsForgotten',\n      status: noLocalizedUrlsForgotten ? 'success' : 'error',\n      details: { error: noLocalizedUrlsForgotten ? undefined : errors },\n    });\n  }\n};\n\n/** Fetch and check `sitemap.xml`, emitting sitemap-related events. */\nexport const checkSitemap = async (\n  origin: string,\n  discoveredLocales: Set<string>,\n  userAgent: string,\n  events: ScanEvent[]\n): Promise<void> => {\n  let sitemapPresent = false;\n  let hasXDefault = false;\n  let hasAlternates = false;\n  let noLocalizedUrlsForgotten = true;\n  const errors: string[] = [];\n\n  try {\n    const response = await fetch(`${origin}/sitemap.xml`, {\n      headers: { 'User-Agent': userAgent },\n    });\n\n    if (response.ok) {\n      sitemapPresent = true;\n      const content = await response.text();\n\n      const hreflangMatches = content.match(/hreflang\\s*=\\s*\"([^\"]+)\"/gi) ?? [];\n      const hreflangs = hreflangMatches.map((m) =>\n        m.replace(/hreflang\\s*=\\s*\"/i, '').replace(/\"$/, '')\n      );\n      hasAlternates = hreflangs.length > 0;\n      hasXDefault = hreflangs.includes('x-default');\n\n      if (discoveredLocales.size > 0) {\n        const urlBlocks = content.match(/<url\\b[\\s\\S]*?<\\/url>/gi) ?? [];\n        const allFoundLocales = new Set<string>();\n        let anyUrlMissingLocale = false;\n\n        for (const block of urlBlocks) {\n          const localesInUrl = new Set<string>();\n\n          for (const hreflang of block.match(/hreflang\\s*=\\s*\"([^\"]+)\"/gi) ??\n            []) {\n            const value = hreflang\n              .replace(/hreflang\\s*=\\s*\"/i, '')\n              .replace(/\"$/, '');\n            if (value !== 'x-default') {\n              localesInUrl.add(value);\n              allFoundLocales.add(value);\n            }\n          }\n\n          const loc = block.match(/<loc>([\\s\\S]*?)<\\/loc>/i)?.[1]?.trim();\n          if (loc) {\n            try {\n              const firstSegment = new URL(loc).pathname\n                .split('/')\n                .filter(Boolean)[0];\n              if (firstSegment && discoveredLocales.has(firstSegment)) {\n                localesInUrl.add(firstSegment);\n                allFoundLocales.add(firstSegment);\n              }\n            } catch {\n              /* invalid loc URL, skip */\n            }\n          }\n\n          const missing = [...discoveredLocales].filter(\n            (locale) => !localesInUrl.has(locale)\n          );\n          if (missing.length > 0 && missing.length < discoveredLocales.size) {\n            anyUrlMissingLocale = true;\n          }\n        }\n\n        const completelyMissing = [...discoveredLocales].filter(\n          (locale) => !allFoundLocales.has(locale)\n        );\n        if (anyUrlMissingLocale || completelyMissing.length > 0) {\n          noLocalizedUrlsForgotten = false;\n          if (completelyMissing.length > 0) {\n            errors.push(\n              `The following locales are completely missing from the sitemap: ${completelyMissing.join(', ')}`\n            );\n          }\n        }\n      }\n    }\n  } catch (error) {\n    errors.push(\n      `Failed to fetch sitemap.xml: ${error instanceof Error ? error.message : 'Unknown error'}`\n    );\n  }\n\n  events.push({\n    type: 'sitemap_sitemapPresent',\n    status: sitemapPresent ? 'success' : 'warning',\n    details: {\n      warning: sitemapPresent ? undefined : 'No sitemap.xml found',\n      error: errors.length > 0 ? errors : undefined,\n    },\n  });\n\n  if (sitemapPresent) {\n    events.push({\n      type: 'sitemap_noLocalizedUrlsForgotten',\n      status: noLocalizedUrlsForgotten ? 'success' : 'warning',\n      details: { warning: noLocalizedUrlsForgotten ? undefined : errors },\n    });\n\n    events.push({\n      type: 'sitemap_hasXDefault',\n      status: hasXDefault ? 'success' : 'warning',\n      details: {\n        warning: hasXDefault ? undefined : 'No x-default hreflang in sitemap',\n      },\n    });\n\n    events.push({\n      type: 'sitemap_hasAlternates',\n      status: hasAlternates ? 'success' : 'warning',\n      details: {\n        warning: hasAlternates\n          ? undefined\n          : 'No alternate language links found in sitemap',\n      },\n    });\n  }\n};\n"],"mappings":"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"}
+{"version":3,"file":"checks.mjs","names":[],"sources":["../../../src/scan/checks.ts"],"sourcesContent":["import { ALL_LOCALES } from '@intlayer/types/allLocales';\nimport { analyzeBundleContent } from './analyzeBundleContent';\nimport {\n  type Anchor,\n  extractHreflangs,\n  extractHtmlDir,\n  extractHtmlLang,\n  hasCanonical,\n} from './parseHtml';\nimport type {\n  BundleChunkInput,\n  BundleContentAnalysis,\n  ScanEvent,\n} from './types';\n\n/** Format a byte count as a human-readable size. */\nexport const formatSize = (bytes: number): string => {\n  if (bytes >= 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;\n  if (bytes >= 1024) return `${(bytes / 1024).toFixed(2)} KB`;\n  return `${bytes} B`;\n};\n\n/**\n * Check the `<html>` element attributes (`lang`, `dir`) and the resulting\n * current-locale signal. Returns the detected language tag.\n */\nexport const checkHtmlAttributes = (\n  html: string,\n  targetUrl: string,\n  events: ScanEvent[]\n): { langTag: string | undefined } => {\n  const langTag = extractHtmlLang(html);\n  const dirTag = extractHtmlDir(html);\n\n  events.push({\n    type: `url_htmlLang\\\\${targetUrl}`,\n    status: langTag ? 'success' : 'error',\n    details: {\n      success: langTag,\n      error: langTag ? undefined : 'Missing html lang attribute',\n    },\n  });\n\n  events.push({\n    type: `url_currentLocale\\\\${targetUrl}`,\n    status: langTag ? 'success' : 'warning',\n    details: {\n      success: langTag,\n      warning: langTag ? undefined : 'No locale detected',\n    },\n  });\n\n  events.push({\n    type: `url_htmlDir\\\\${targetUrl}`,\n    status: dirTag ? 'success' : 'warning',\n    details: {\n      success: dirTag,\n      warning: dirTag ? undefined : 'Missing html dir attribute',\n    },\n  });\n\n  return { langTag };\n};\n\n/** Check the presence of a canonical link. */\nexport const checkCanonical = (\n  html: string,\n  targetUrl: string,\n  events: ScanEvent[]\n): void => {\n  const present = hasCanonical(html);\n  events.push({\n    type: `url_hasCanonical\\\\${targetUrl}`,\n    status: present ? 'success' : 'warning',\n    details: { warning: present ? undefined : 'Missing canonical link' },\n  });\n};\n\n/**\n * Check the page's hreflang structure and collect discovered locales into\n * `localesSet`.\n */\nexport const checkLinguisticStructure = (\n  html: string,\n  targetUrl: string,\n  localesSet: Set<string>,\n  events: ScanEvent[]\n): void => {\n  const langTag = extractHtmlLang(html);\n  if (langTag) localesSet.add(langTag);\n\n  const hreflangs = extractHreflangs(html);\n  for (const { hreflang } of hreflangs) {\n    if (hreflang !== 'x-default') localesSet.add(hreflang);\n  }\n\n  const hasXDefault = hreflangs.some((h) => h.hreflang === 'x-default');\n\n  events.push({\n    type: `url_hreflang\\\\${targetUrl}`,\n    status: hreflangs.length > 0 ? 'success' : 'warning',\n    details: {\n      success: hreflangs.length > 0 ? hreflangs : undefined,\n      warning: hreflangs.length === 0 ? 'No hreflang tags found' : undefined,\n    },\n  });\n\n  events.push({\n    type: `url_hasXDefault\\\\${targetUrl}`,\n    status: hasXDefault ? 'success' : 'error',\n    details: {\n      error: hasXDefault ? undefined : 'Missing x-default hreflang link',\n    },\n  });\n};\n\nconst normalizeHost = (host: string): string =>\n  host.startsWith('www.') ? host.slice(4) : host;\n\nconst localeValues = Object.values(ALL_LOCALES) as string[];\n\n/**\n * Check whether internal links carry a locale segment, mirroring the hosted\n * audit's URL-structure analysis but operating on parsed anchors instead of a\n * live DOM.\n */\nexport const checkUrlStructure = (\n  anchors: Anchor[],\n  origin: string,\n  targetUrl: string,\n  events: ScanEvent[]\n): void => {\n  const targetHostname = normalizeHost(new URL(origin).hostname);\n\n  let localizedCount = 0;\n  let totalInternalCount = 0;\n  const nonLocalizedLinks: string[] = [];\n\n  for (const { href } of anchors) {\n    if (!href || href.startsWith('#') || href.startsWith('javascript:'))\n      continue;\n\n    try {\n      const url = new URL(href, origin);\n      if (normalizeHost(url.hostname) !== targetHostname) continue;\n\n      totalInternalCount++;\n      const path = url.pathname.toLowerCase();\n      const hostname = url.hostname.toLowerCase();\n\n      const hasLocaleInPath = localeValues.some((locale) => {\n        const l = locale.toLowerCase();\n        return path === `/${l}` || path.includes(`/${l}/`);\n      });\n      const hasLocaleInSubdomain = localeValues.some((locale) => {\n        const l = locale.toLowerCase();\n        return hostname.startsWith(`${l}.`) || hostname.includes(`.${l}.`);\n      });\n\n      if (hasLocaleInPath || hasLocaleInSubdomain) {\n        localizedCount++;\n      } else {\n        nonLocalizedLinks.push(href);\n      }\n    } catch {\n      /* ignore malformed URLs */\n    }\n  }\n\n  const hasLocalizedLinks = localizedCount > 0;\n  const allAnchorsLocalized =\n    totalInternalCount === 0 || localizedCount === totalInternalCount;\n\n  events.push({\n    type: `url_hasLocalizedLinks\\\\${targetUrl}`,\n    status: hasLocalizedLinks ? 'success' : 'warning',\n    details: {\n      success: hasLocalizedLinks\n        ? `${localizedCount} localized links found out of ${totalInternalCount} internal links`\n        : undefined,\n      warning: hasLocalizedLinks ? undefined : 'No localized links found',\n    },\n  });\n\n  events.push({\n    type: `url_allAnchorsLocalized\\\\${targetUrl}`,\n    status: allAnchorsLocalized ? 'success' : 'warning',\n    details: {\n      warning: allAnchorsLocalized\n        ? undefined\n        : {\n            message: 'Some internal links are not localized',\n            links: nonLocalizedLinks,\n          },\n    },\n  });\n};\n\n/**\n * Analyze the JavaScript bundles for unused locale content and emit the\n * corresponding event. Returns the analysis so callers can report on it.\n */\nexport const checkBundleContent = (\n  chunks: BundleChunkInput[],\n  html: string,\n  currentLocale: string | undefined,\n  targetUrl: string,\n  totalPageSize: number,\n  events: ScanEvent[]\n): BundleContentAnalysis | undefined => {\n  if (!currentLocale) {\n    events.push({\n      type: `url_unusedBundleContent\\\\${targetUrl}`,\n      status: 'warning',\n      details: {\n        warning: 'Cannot analyse bundle content: page locale not detected',\n      },\n    });\n    return undefined;\n  }\n\n  const analysis = analyzeBundleContent(\n    chunks,\n    html,\n    currentLocale,\n    totalPageSize\n  );\n\n  // Status is driven by the main bundle — lazy chunks with unused content are expected.\n  const mainBundleMaxUnused = analysis.mainBundleChunks.reduce(\n    (max, c) => Math.max(max, c.unusedPercent),\n    0\n  );\n\n  const status =\n    mainBundleMaxUnused === 0\n      ? 'success'\n      : mainBundleMaxUnused <= 30\n        ? 'warning'\n        : 'error';\n\n  events.push({\n    type: `url_unusedBundleContent\\\\${targetUrl}`,\n    status,\n    details: { [status]: analysis },\n  });\n\n  return analysis;\n};\n\n/** Fetch and check `robots.txt`, emitting robots-related events. */\nexport const checkRobots = async (\n  origin: string,\n  discoveredLocales: Set<string>,\n  userAgent: string,\n  events: ScanEvent[]\n): Promise<void> => {\n  let robotsPresent = false;\n  let noLocalizedUrlsForgotten = true;\n  const errors: string[] = [];\n\n  try {\n    const response = await fetch(`${origin}/robots.txt`, {\n      headers: { 'User-Agent': userAgent },\n    });\n\n    if (response.ok) {\n      robotsPresent = true;\n      const content = await response.text();\n\n      if (content && discoveredLocales.size > 0) {\n        const disallowedPaths = content\n          .split('\\n')\n          .map((line) => line.trim().toLowerCase())\n          .filter((line) => line.startsWith('disallow:'))\n          .map((line) => line.slice('disallow:'.length).trim());\n\n        for (const locale of discoveredLocales) {\n          for (const path of disallowedPaths) {\n            if (path === `/${locale}` || path === `/${locale}/`) {\n              noLocalizedUrlsForgotten = false;\n              errors.push(\n                `Locale path \"${locale}\" appears to be blocked in robots.txt: ${path}`\n              );\n            }\n          }\n        }\n      }\n    }\n  } catch (error) {\n    errors.push(\n      `Failed to fetch robots.txt: ${error instanceof Error ? error.message : 'Unknown error'}`\n    );\n  }\n\n  events.push({\n    type: 'robots_robotsPresent',\n    status: robotsPresent ? 'success' : 'warning',\n    details: {\n      warning: robotsPresent ? undefined : 'No robots.txt found',\n      error: errors.length > 0 ? errors : undefined,\n    },\n  });\n\n  if (robotsPresent) {\n    events.push({\n      type: 'robots_noLocalizedUrlsForgotten',\n      status: noLocalizedUrlsForgotten ? 'success' : 'error',\n      details: { error: noLocalizedUrlsForgotten ? undefined : errors },\n    });\n  }\n};\n\n/** Fetch and check `sitemap.xml`, emitting sitemap-related events. */\nexport const checkSitemap = async (\n  origin: string,\n  discoveredLocales: Set<string>,\n  userAgent: string,\n  events: ScanEvent[]\n): Promise<void> => {\n  let sitemapPresent = false;\n  let hasXDefault = false;\n  let hasAlternates = false;\n  let noLocalizedUrlsForgotten = true;\n  const errors: string[] = [];\n\n  try {\n    const response = await fetch(`${origin}/sitemap.xml`, {\n      headers: { 'User-Agent': userAgent },\n    });\n\n    if (response.ok) {\n      sitemapPresent = true;\n      const content = await response.text();\n\n      const hreflangMatches = content.match(/hreflang\\s*=\\s*\"([^\"]+)\"/gi) ?? [];\n      const hreflangs = hreflangMatches.map((m) =>\n        m.replace(/hreflang\\s*=\\s*\"/i, '').replace(/\"$/, '')\n      );\n      hasAlternates = hreflangs.length > 0;\n      hasXDefault = hreflangs.includes('x-default');\n\n      if (discoveredLocales.size > 0) {\n        const urlBlocks = content.match(/<url\\b[\\s\\S]*?<\\/url>/gi) ?? [];\n        const allFoundLocales = new Set<string>();\n        let anyUrlMissingLocale = false;\n\n        for (const block of urlBlocks) {\n          const localesInUrl = new Set<string>();\n\n          for (const hreflang of block.match(/hreflang\\s*=\\s*\"([^\"]+)\"/gi) ??\n            []) {\n            const value = hreflang\n              .replace(/hreflang\\s*=\\s*\"/i, '')\n              .replace(/\"$/, '');\n            if (value !== 'x-default') {\n              localesInUrl.add(value);\n              allFoundLocales.add(value);\n            }\n          }\n\n          const loc = block.match(/<loc>([\\s\\S]*?)<\\/loc>/i)?.[1]?.trim();\n          if (loc) {\n            try {\n              const firstSegment = new URL(loc).pathname\n                .split('/')\n                .filter(Boolean)[0];\n              if (firstSegment && discoveredLocales.has(firstSegment)) {\n                localesInUrl.add(firstSegment);\n                allFoundLocales.add(firstSegment);\n              }\n            } catch {\n              /* invalid loc URL, skip */\n            }\n          }\n\n          const missing = [...discoveredLocales].filter(\n            (locale) => !localesInUrl.has(locale)\n          );\n          if (missing.length > 0 && missing.length < discoveredLocales.size) {\n            anyUrlMissingLocale = true;\n          }\n        }\n\n        const completelyMissing = [...discoveredLocales].filter(\n          (locale) => !allFoundLocales.has(locale)\n        );\n        if (anyUrlMissingLocale || completelyMissing.length > 0) {\n          noLocalizedUrlsForgotten = false;\n          if (completelyMissing.length > 0) {\n            errors.push(\n              `The following locales are completely missing from the sitemap: ${completelyMissing.join(', ')}`\n            );\n          }\n        }\n      }\n    }\n  } catch (error) {\n    errors.push(\n      `Failed to fetch sitemap.xml: ${error instanceof Error ? error.message : 'Unknown error'}`\n    );\n  }\n\n  events.push({\n    type: 'sitemap_sitemapPresent',\n    status: sitemapPresent ? 'success' : 'warning',\n    details: {\n      warning: sitemapPresent ? undefined : 'No sitemap.xml found',\n      error: errors.length > 0 ? errors : undefined,\n    },\n  });\n\n  if (sitemapPresent) {\n    events.push({\n      type: 'sitemap_noLocalizedUrlsForgotten',\n      status: noLocalizedUrlsForgotten ? 'success' : 'warning',\n      details: { warning: noLocalizedUrlsForgotten ? undefined : errors },\n    });\n\n    events.push({\n      type: 'sitemap_hasXDefault',\n      status: hasXDefault ? 'success' : 'warning',\n      details: {\n        warning: hasXDefault ? undefined : 'No x-default hreflang in sitemap',\n      },\n    });\n\n    events.push({\n      type: 'sitemap_hasAlternates',\n      status: hasAlternates ? 'success' : 'warning',\n      details: {\n        warning: hasAlternates\n          ? undefined\n          : 'No alternate language links found in sitemap',\n      },\n    });\n  }\n};\n"],"mappings":"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"}

package/dist/esm/syncPluginKit/createFileAdapter.mjs

@@ -34,7 +34,8 @@ const createFileAdapter = (options) => {
 			const globPatternLocale = await parseFilePathPattern(source, buildFilePathPatternContext("**", locale));
 			const maskPatternLocale = await parseFilePathPattern(source, buildFilePathPatternContext("{{__KEY__}}", locale));
 			if (!globPatternLocale || !maskPatternLocale) continue;
-			const files = await fg(globPatternLocale.startsWith("./") ? globPatternLocale.slice(2) : globPatternLocale, { cwd: baseDir });
+			const normalizedGlobPattern = globPatternLocale.startsWith("./") ? globPatternLocale.slice(2) : globPatternLocale;
+			const files = await fg(normalizedGlobPattern, { cwd: baseDir });
 			const hasLocaleInMask = maskPatternLocale.includes("{{__LOCALE__}}");
 			const hasKeyInMask = maskPatternLocale.includes("{{__KEY__}}");
 			for (const file of files) {

package/dist/esm/syncPluginKit/createFileAdapter.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"createFileAdapter.mjs","names":[],"sources":["../../../src/syncPluginKit/createFileAdapter.ts"],"sourcesContent":["import { mkdir, readFile } from 'node:fs/promises';\nimport { dirname, isAbsolute, resolve } from 'node:path';\nimport { parseFilePathPattern } from '@intlayer/config/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { FilePathPattern } from '@intlayer/types/filePathPattern';\nimport fg from 'fast-glob';\nimport { writeFileIfChanged } from '../writeFileIfChanged';\nimport { extractKeyAndLocaleFromPath } from './extractKeyAndLocaleFromPath';\nimport { buildFilePathPatternContext } from './filePathPatternHelpers';\nimport type {\n  ContentAdapter,\n  ContentEntry,\n  FormatCodec,\n  SyncContent,\n  SyncPluginContext,\n} from './types';\n\n/**\n * Discovery strategy of the file adapter:\n * - `strict`: keep only files whose path rebuilds identically from the source\n *   pattern, and fabricate entries for missing locales/keys so every declared\n *   locale has a write-back target (sync plugins).\n * - `inclusive`: keep every glob match without fabricating missing entries\n *   (read-only load plugins, whose patterns may contain free `**` globs).\n */\nexport type FileAdapterDiscovery = 'strict' | 'inclusive';\n\nexport type CreateFileAdapterOptions = {\n  /**\n   * Location of the files, as a static string, a templated string\n   * (e.g. `./messages/{{locale}}/{{key}}.json`) or a function building the\n   * path from the key and locale.\n   */\n  source: FilePathPattern;\n\n  /**\n   * Format of the files: string payload ↔ structured content.\n   */\n  codec: FormatCodec;\n\n  /**\n   * Optional override of how one file is read and parsed. Defaults to a plain\n   * utf-8 read followed by `codec.parse`, returning `undefined` for missing or\n   * unreadable files. Adapters needing richer loading (e.g. JSON5 or\n   * transpiled TS sources) provide their own implementation here.\n   */\n  readEntry?: (\n    absoluteFilePath: string,\n    context: SyncPluginContext\n  ) => Promise<SyncContent | undefined>;\n\n  /**\n   * Discovery strategy. Defaults to `'strict'`.\n   */\n  discovery?: FileAdapterDiscovery;\n};\n\ntype FilePath = string;\ntype MessagesRecord = Record<Locale, Record<string, FilePath>>;\n\n/**\n * Create a filesystem {@link ContentAdapter} for `createSyncPlugin`.\n *\n * Handles glob discovery of the source pattern, key/locale extraction from\n * paths, base-directory resolution, and change-detected atomic writes.\n */\nexport const createFileAdapter = (\n  options: CreateFileAdapterOptions\n): ContentAdapter => {\n  const { source, codec, discovery = 'strict' } = options;\n  const readEntry = options.readEntry ?? createFileReader(codec.parse);\n\n  let patternMarkerPromise: Promise<string> | undefined;\n\n  /**\n   * Source pattern with `{{key}}` / `{{locale}}` markers kept verbatim,\n   * memoized because pattern functions can be asynchronous.\n   */\n  const getPatternMarker = () => {\n    patternMarkerPromise ??= parseFilePathPattern(\n      source,\n      buildFilePathPatternContext('{{key}}', '{{locale}}')\n    );\n\n    return patternMarkerPromise;\n  };\n\n  const listMessages = async (\n    context: SyncPluginContext\n  ): Promise<MessagesRecord> => {\n    const { system, internationalization } = context.configuration;\n    const { baseDir } = system;\n    const { locales } = internationalization;\n\n    const result: MessagesRecord = {} as MessagesRecord;\n\n    for (const locale of locales) {\n      const globPatternLocale = await parseFilePathPattern(\n        source,\n        buildFilePathPatternContext('**', locale)\n      );\n\n      const maskPatternLocale = await parseFilePathPattern(\n        source,\n        buildFilePathPatternContext('{{__KEY__}}', locale)\n      );\n\n      if (!globPatternLocale || !maskPatternLocale) {\n        continue;\n      }\n\n      const normalizedGlobPattern = globPatternLocale.startsWith('./')\n        ? globPatternLocale.slice(2)\n        : globPatternLocale;\n\n      const files = await fg(normalizedGlobPattern, {\n        cwd: baseDir,\n      });\n\n      const hasLocaleInMask = maskPatternLocale.includes('{{__LOCALE__}}');\n      const hasKeyInMask = maskPatternLocale.includes('{{__KEY__}}');\n\n      for (const file of files) {\n        let key: string;\n        let extractedLocale: Locale;\n\n        if (hasLocaleInMask || hasKeyInMask) {\n          const extraction = extractKeyAndLocaleFromPath(\n            file,\n            maskPatternLocale,\n            locales,\n            locale\n          );\n\n          if (!extraction) {\n            continue;\n          }\n\n          key = extraction.key;\n          extractedLocale = extraction.locale;\n        } else if (discovery === 'inclusive') {\n          // Mask has no placeholders — the file was found via a concrete\n          // locale glob. Attribute it directly to the current loop locale.\n          key = 'index';\n          extractedLocale = locale;\n        } else {\n          // Strict mode relies on the fabrication step below to attribute\n          // placeholder-free sources to their canonical paths.\n          continue;\n        }\n\n        const absoluteFoundPath = isAbsolute(file)\n          ? file\n          : resolve(baseDir, file);\n\n        if (discovery === 'strict') {\n          // Rebuild what the path SHOULD be for this key/locale. A mismatch\n          // means the file belongs to another plugin/structure.\n          const expectedPath = await parseFilePathPattern(\n            source,\n            buildFilePathPatternContext(key, extractedLocale)\n          );\n\n          const absoluteExpectedPath = isAbsolute(expectedPath)\n            ? expectedPath\n            : resolve(baseDir, expectedPath);\n\n          if (absoluteFoundPath !== absoluteExpectedPath) {\n            continue;\n          }\n        }\n\n        result[extractedLocale] ??= {};\n        result[extractedLocale][key] = absoluteFoundPath;\n      }\n    }\n\n    if (discovery === 'inclusive') {\n      // Read-only mode only uses actual discovered files; do not fabricate\n      // missing locales or keys, since no outputs are written.\n      return result;\n    }\n\n    // Ensure all declared locales are present even if the file doesn't exist yet\n    const maskWithKey = await parseFilePathPattern(\n      source,\n      buildFilePathPatternContext('{{__KEY__}}', locales[0])\n    );\n\n    const hasKeyInMask = maskWithKey.includes('{{__KEY__}}');\n    const discoveredKeys = new Set<string>();\n\n    for (const locale of Object.keys(result) as Locale[]) {\n      for (const key of Object.keys(result[locale] ?? {})) {\n        discoveredKeys.add(key);\n      }\n    }\n\n    if (!hasKeyInMask) {\n      discoveredKeys.add('index');\n    }\n\n    for (const locale of locales) {\n      result[locale] ??= {};\n\n      for (const key of discoveredKeys) {\n        if (!result[locale][key]) {\n          const builtPath = await parseFilePathPattern(\n            source,\n            buildFilePathPatternContext(key, locale)\n          );\n\n          result[locale][key] = isAbsolute(builtPath)\n            ? builtPath\n            : resolve(baseDir, builtPath);\n        }\n      }\n    }\n\n    return result;\n  };\n\n  return {\n    list: async (context) => {\n      const messages = await listMessages(context);\n\n      const entries: ContentEntry[] = (\n        Object.entries(messages) as [Locale, Record<string, FilePath>][]\n      ).flatMap(([locale, keysRecord]) =>\n        Object.entries(keysRecord).map(([key, absoluteFilePath]) => ({\n          key,\n          locale,\n          uri: absoluteFilePath,\n          filePath: absoluteFilePath,\n        }))\n      );\n\n      return entries;\n    },\n\n    read: async (entry, context) => await readEntry(entry.uri, context),\n\n    write: async ({ key, locale }, content, { configuration }) => {\n      const builderPath = await parseFilePathPattern(\n        source,\n        buildFilePathPatternContext(key, locale)\n      );\n\n      const absoluteFilePath = resolve(\n        configuration.system.baseDir,\n        builderPath\n      );\n\n      await mkdir(dirname(absoluteFilePath), { recursive: true });\n\n      await writeFileIfChanged(\n        absoluteFilePath,\n        codec.serialize(content, { locale }),\n        { tempDir: configuration.system?.tempDir }\n      );\n    },\n\n    resolveUri: async ({ key, locale }, { configuration }) => {\n      const builderPath = await parseFilePathPattern(\n        source,\n        buildFilePathPatternContext(key, locale)\n      );\n\n      return resolve(configuration.system.baseDir, builderPath);\n    },\n\n    getFillPattern: async () => await getPatternMarker(),\n\n    describeSource: async () => await getPatternMarker(),\n\n    detectSplitKeys: async () =>\n      !(await getPatternMarker()).includes('{{key}}'),\n  };\n};\n\n/**\n * Default `readEntry` implementation: plain utf-8 read followed by the given\n * parser. Returns `undefined` for missing or unreadable files.\n */\nexport const createFileReader =\n  (parse: (raw: string) => SyncContent) =>\n  async (absoluteFilePath: string): Promise<SyncContent | undefined> => {\n    try {\n      const raw = await readFile(absoluteFilePath, 'utf-8');\n\n      return parse(raw);\n    } catch {\n      return undefined;\n    }\n  };\n"],"mappings":"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"}
+{"version":3,"file":"createFileAdapter.mjs","names":[],"sources":["../../../src/syncPluginKit/createFileAdapter.ts"],"sourcesContent":["import { mkdir, readFile } from 'node:fs/promises';\nimport { dirname, isAbsolute, resolve } from 'node:path';\nimport { parseFilePathPattern } from '@intlayer/config/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { FilePathPattern } from '@intlayer/types/filePathPattern';\nimport fg from 'fast-glob';\nimport { writeFileIfChanged } from '../writeFileIfChanged';\nimport { extractKeyAndLocaleFromPath } from './extractKeyAndLocaleFromPath';\nimport { buildFilePathPatternContext } from './filePathPatternHelpers';\nimport type {\n  ContentAdapter,\n  ContentEntry,\n  FormatCodec,\n  SyncContent,\n  SyncPluginContext,\n} from './types';\n\n/**\n * Discovery strategy of the file adapter:\n * - `strict`: keep only files whose path rebuilds identically from the source\n *   pattern, and fabricate entries for missing locales/keys so every declared\n *   locale has a write-back target (sync plugins).\n * - `inclusive`: keep every glob match without fabricating missing entries\n *   (read-only load plugins, whose patterns may contain free `**` globs).\n */\nexport type FileAdapterDiscovery = 'strict' | 'inclusive';\n\nexport type CreateFileAdapterOptions = {\n  /**\n   * Location of the files, as a static string, a templated string\n   * (e.g. `./messages/{{locale}}/{{key}}.json`) or a function building the\n   * path from the key and locale.\n   */\n  source: FilePathPattern;\n\n  /**\n   * Format of the files: string payload ↔ structured content.\n   */\n  codec: FormatCodec;\n\n  /**\n   * Optional override of how one file is read and parsed. Defaults to a plain\n   * utf-8 read followed by `codec.parse`, returning `undefined` for missing or\n   * unreadable files. Adapters needing richer loading (e.g. JSON5 or\n   * transpiled TS sources) provide their own implementation here.\n   */\n  readEntry?: (\n    absoluteFilePath: string,\n    context: SyncPluginContext\n  ) => Promise<SyncContent | undefined>;\n\n  /**\n   * Discovery strategy. Defaults to `'strict'`.\n   */\n  discovery?: FileAdapterDiscovery;\n};\n\ntype FilePath = string;\ntype MessagesRecord = Record<Locale, Record<string, FilePath>>;\n\n/**\n * Create a filesystem {@link ContentAdapter} for `createSyncPlugin`.\n *\n * Handles glob discovery of the source pattern, key/locale extraction from\n * paths, base-directory resolution, and change-detected atomic writes.\n */\nexport const createFileAdapter = (\n  options: CreateFileAdapterOptions\n): ContentAdapter => {\n  const { source, codec, discovery = 'strict' } = options;\n  const readEntry = options.readEntry ?? createFileReader(codec.parse);\n\n  let patternMarkerPromise: Promise<string> | undefined;\n\n  /**\n   * Source pattern with `{{key}}` / `{{locale}}` markers kept verbatim,\n   * memoized because pattern functions can be asynchronous.\n   */\n  const getPatternMarker = () => {\n    patternMarkerPromise ??= parseFilePathPattern(\n      source,\n      buildFilePathPatternContext('{{key}}', '{{locale}}')\n    );\n\n    return patternMarkerPromise;\n  };\n\n  const listMessages = async (\n    context: SyncPluginContext\n  ): Promise<MessagesRecord> => {\n    const { system, internationalization } = context.configuration;\n    const { baseDir } = system;\n    const { locales } = internationalization;\n\n    const result: MessagesRecord = {} as MessagesRecord;\n\n    for (const locale of locales) {\n      const globPatternLocale = await parseFilePathPattern(\n        source,\n        buildFilePathPatternContext('**', locale)\n      );\n\n      const maskPatternLocale = await parseFilePathPattern(\n        source,\n        buildFilePathPatternContext('{{__KEY__}}', locale)\n      );\n\n      if (!globPatternLocale || !maskPatternLocale) {\n        continue;\n      }\n\n      const normalizedGlobPattern = globPatternLocale.startsWith('./')\n        ? globPatternLocale.slice(2)\n        : globPatternLocale;\n\n      const files = await fg(normalizedGlobPattern, {\n        cwd: baseDir,\n      });\n\n      const hasLocaleInMask = maskPatternLocale.includes('{{__LOCALE__}}');\n      const hasKeyInMask = maskPatternLocale.includes('{{__KEY__}}');\n\n      for (const file of files) {\n        let key: string;\n        let extractedLocale: Locale;\n\n        if (hasLocaleInMask || hasKeyInMask) {\n          const extraction = extractKeyAndLocaleFromPath(\n            file,\n            maskPatternLocale,\n            locales,\n            locale\n          );\n\n          if (!extraction) {\n            continue;\n          }\n\n          key = extraction.key;\n          extractedLocale = extraction.locale;\n        } else if (discovery === 'inclusive') {\n          // Mask has no placeholders — the file was found via a concrete\n          // locale glob. Attribute it directly to the current loop locale.\n          key = 'index';\n          extractedLocale = locale;\n        } else {\n          // Strict mode relies on the fabrication step below to attribute\n          // placeholder-free sources to their canonical paths.\n          continue;\n        }\n\n        const absoluteFoundPath = isAbsolute(file)\n          ? file\n          : resolve(baseDir, file);\n\n        if (discovery === 'strict') {\n          // Rebuild what the path SHOULD be for this key/locale. A mismatch\n          // means the file belongs to another plugin/structure.\n          const expectedPath = await parseFilePathPattern(\n            source,\n            buildFilePathPatternContext(key, extractedLocale)\n          );\n\n          const absoluteExpectedPath = isAbsolute(expectedPath)\n            ? expectedPath\n            : resolve(baseDir, expectedPath);\n\n          if (absoluteFoundPath !== absoluteExpectedPath) {\n            continue;\n          }\n        }\n\n        result[extractedLocale] ??= {};\n        result[extractedLocale][key] = absoluteFoundPath;\n      }\n    }\n\n    if (discovery === 'inclusive') {\n      // Read-only mode only uses actual discovered files; do not fabricate\n      // missing locales or keys, since no outputs are written.\n      return result;\n    }\n\n    // Ensure all declared locales are present even if the file doesn't exist yet\n    const maskWithKey = await parseFilePathPattern(\n      source,\n      buildFilePathPatternContext('{{__KEY__}}', locales[0])\n    );\n\n    const hasKeyInMask = maskWithKey.includes('{{__KEY__}}');\n    const discoveredKeys = new Set<string>();\n\n    for (const locale of Object.keys(result) as Locale[]) {\n      for (const key of Object.keys(result[locale] ?? {})) {\n        discoveredKeys.add(key);\n      }\n    }\n\n    if (!hasKeyInMask) {\n      discoveredKeys.add('index');\n    }\n\n    for (const locale of locales) {\n      result[locale] ??= {};\n\n      for (const key of discoveredKeys) {\n        if (!result[locale][key]) {\n          const builtPath = await parseFilePathPattern(\n            source,\n            buildFilePathPatternContext(key, locale)\n          );\n\n          result[locale][key] = isAbsolute(builtPath)\n            ? builtPath\n            : resolve(baseDir, builtPath);\n        }\n      }\n    }\n\n    return result;\n  };\n\n  return {\n    list: async (context) => {\n      const messages = await listMessages(context);\n\n      const entries: ContentEntry[] = (\n        Object.entries(messages) as [Locale, Record<string, FilePath>][]\n      ).flatMap(([locale, keysRecord]) =>\n        Object.entries(keysRecord).map(([key, absoluteFilePath]) => ({\n          key,\n          locale,\n          uri: absoluteFilePath,\n          filePath: absoluteFilePath,\n        }))\n      );\n\n      return entries;\n    },\n\n    read: async (entry, context) => await readEntry(entry.uri, context),\n\n    write: async ({ key, locale }, content, { configuration }) => {\n      const builderPath = await parseFilePathPattern(\n        source,\n        buildFilePathPatternContext(key, locale)\n      );\n\n      const absoluteFilePath = resolve(\n        configuration.system.baseDir,\n        builderPath\n      );\n\n      await mkdir(dirname(absoluteFilePath), { recursive: true });\n\n      await writeFileIfChanged(\n        absoluteFilePath,\n        codec.serialize(content, { locale }),\n        { tempDir: configuration.system?.tempDir }\n      );\n    },\n\n    resolveUri: async ({ key, locale }, { configuration }) => {\n      const builderPath = await parseFilePathPattern(\n        source,\n        buildFilePathPatternContext(key, locale)\n      );\n\n      return resolve(configuration.system.baseDir, builderPath);\n    },\n\n    getFillPattern: async () => await getPatternMarker(),\n\n    describeSource: async () => await getPatternMarker(),\n\n    detectSplitKeys: async () =>\n      !(await getPatternMarker()).includes('{{key}}'),\n  };\n};\n\n/**\n * Default `readEntry` implementation: plain utf-8 read followed by the given\n * parser. Returns `undefined` for missing or unreadable files.\n */\nexport const createFileReader =\n  (parse: (raw: string) => SyncContent) =>\n  async (absoluteFilePath: string): Promise<SyncContent | undefined> => {\n    try {\n      const raw = await readFile(absoluteFilePath, 'utf-8');\n\n      return parse(raw);\n    } catch {\n      return undefined;\n    }\n  };\n"],"mappings":"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"}

package/dist/esm/syncPluginKit/createSyncPlugin.mjs

@@ -45,7 +45,10 @@ const createSyncPlugin = (options) => {
 		const { baseDir } = configuration.system;
 		const { defaultLocale } = configuration.internationalization;
 		let patternFill;
-		if (direction === "both" && adapter.getFillPattern) patternFill = relative(baseDir, resolve(baseDir, await adapter.getFillPattern(context)));
+		if (direction === "both" && adapter.getFillPattern) {
+			const fillPattern = await adapter.getFillPattern(context);
+			patternFill = relative(baseDir, resolve(baseDir, fillPattern));
+		}
 		const dictionaries = [];
 		for (const entry of entries) {
 			const content = await adapter.read(entry, context) ?? {};

package/dist/esm/syncPluginKit/createSyncPlugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"createSyncPlugin.mjs","names":[],"sources":["../../../src/syncPluginKit/createSyncPlugin.ts"],"sourcesContent":["import { relative, resolve } from 'node:path';\nimport { colorizePath, getAppLogger } from '@intlayer/config/logger';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { Dictionary, LocalDictionaryId } from '@intlayer/types/dictionary';\nimport type { Plugin } from '@intlayer/types/plugin';\nimport type {\n  CreateSyncPluginOptions,\n  SyncContent,\n  SyncPluginContext,\n} from './types';\n\n/**\n * Content that carries nothing to persist: `undefined`, `null`, or an object\n * without any own key. Writing it back would erase the target.\n */\nconst isEmptyContent = (content: unknown): boolean =>\n  typeof content === 'undefined' ||\n  content === null ||\n  (typeof content === 'object' && Object.keys(content).length === 0);\n\n/**\n * Deep-clone formatted output into plain JSON data, stripping prototypes and\n * non-serializable values before the emptiness check and the write.\n */\nconst toPlainContent = (content: unknown): unknown =>\n  typeof content === 'undefined'\n    ? undefined\n    : JSON.parse(JSON.stringify(content));\n\n/**\n * Build an Intlayer {@link Plugin} from a transport adapter.\n *\n * The factory implements the three plugin hooks once — ingestion\n * (`loadDictionaries`), content-declaration reformatting (`formatOutput`) and\n * write-back (`afterBuild`) — so adapters only describe *where* content lives\n * (filesystem, TMS such as Crowdin, extra CMS…) and codecs only describe the\n * payload format. Write-back only processes dictionaries whose `location`\n * matches this plugin instance, so adapters never see foreign content.\n */\nexport const createSyncPlugin = (options: CreateSyncPluginOptions): Plugin => {\n  const {\n    name,\n    adapter,\n    direction = 'both',\n    location,\n    priority = 0,\n    format,\n    localeOverride,\n  } = options;\n\n  let splitKeysPromise: Promise<boolean> | undefined;\n\n  /**\n   * `splitKeys` resolution is asynchronous (adapter auto-detection may parse\n   * an async source pattern), so it is resolved lazily and memoized.\n   */\n  const resolveSplitKeys = (): Promise<boolean> => {\n    splitKeysPromise ??= (async () =>\n      options.splitKeys ?? (await adapter.detectSplitKeys?.()) ?? false)();\n\n    return splitKeysPromise;\n  };\n\n  const loadDictionaries: Plugin['loadDictionaries'] = async ({\n    configuration,\n  }) => {\n    const context: SyncPluginContext = { configuration };\n    const appLogger = getAppLogger(configuration);\n\n    const entries = await adapter.list(context);\n\n    if (entries.length === 0) {\n      const sourceDescription =\n        (await adapter.describeSource?.(context)) ?? name;\n\n      appLogger(\n        `[${name}] No dictionaries found at locations matching source pattern: ${colorizePath(sourceDescription)}`,\n        { level: 'warn' }\n      );\n    }\n\n    const shouldSplitByKeys = await resolveSplitKeys();\n    const { baseDir } = configuration.system;\n    const { defaultLocale } = configuration.internationalization;\n\n    // Sync plugins advertise the source pattern (with {{key}}/{{locale}}\n    // markers) as fill target; pull-only plugins fill each entry in place.\n    let patternFill: string | undefined;\n\n    if (direction === 'both' && adapter.getFillPattern) {\n      const fillPattern = await adapter.getFillPattern(context);\n      patternFill = relative(baseDir, resolve(baseDir, fillPattern));\n    }\n\n    const dictionaries: Dictionary[] = [];\n\n    for (const entry of entries) {\n      const content = (await adapter.read(entry, context)) ?? {};\n\n      const relativeFilePath = entry.filePath\n        ? relative(baseDir, entry.filePath)\n        : undefined;\n\n      const usedLocale = (localeOverride ?? entry.locale) as Locale;\n      const filled = usedLocale !== defaultLocale ? true : undefined;\n      const fill = patternFill ?? relativeFilePath;\n      const identifier = relativeFilePath ?? entry.uri;\n\n      // One entry groups several namespaces by its first-level keys: emit one\n      // dictionary per top-level key (e.g. `Hero`, `Nav`, …).\n      if (shouldSplitByKeys) {\n        for (const [namespaceKey, namespaceContent] of Object.entries(\n          content\n        )) {\n          dictionaries.push({\n            key: namespaceKey,\n            locale: usedLocale,\n            fill,\n            format,\n            localId:\n              `${namespaceKey}::${location}::${identifier}` as LocalDictionaryId,\n            location: location as Dictionary['location'],\n            filled,\n            content: namespaceContent as SyncContent,\n            filePath: relativeFilePath,\n            priority,\n          } as Dictionary);\n        }\n        continue;\n      }\n\n      dictionaries.push({\n        key: entry.key,\n        locale: usedLocale,\n        fill,\n        format,\n        localId:\n          `${entry.key}::${location}::${identifier}` as LocalDictionaryId,\n        location: location as Dictionary['location'],\n        filled,\n        content,\n        filePath: relativeFilePath,\n        priority,\n      } as Dictionary);\n    }\n\n    return dictionaries;\n  };\n\n  if (direction === 'pull') {\n    return { name, loadDictionaries };\n  }\n\n  const formatOutput: Plugin['formatOutput'] = async ({\n    dictionary,\n    configuration,\n  }) => {\n    if (!dictionary.filePath || !dictionary.locale) return dictionary;\n\n    // In split mode several namespaces share the same target; the target is\n    // re-assembled in `afterBuild`. Skip here to avoid overwriting the whole\n    // target with a single namespace.\n    if (await resolveSplitKeys()) return dictionary;\n\n    // Ownership check: only reformat declarations this adapter can identify\n    // as its own canonical target.\n    if (!adapter.resolveUri) return dictionary;\n\n    const canonicalUri = await adapter.resolveUri(\n      { key: dictionary.key, locale: dictionary.locale as Locale },\n      { configuration }\n    );\n\n    const { baseDir } = configuration.system;\n\n    if (\n      resolve(baseDir, canonicalUri) !== resolve(baseDir, dictionary.filePath)\n    ) {\n      return dictionary;\n    }\n\n    // Lazy import to keep the module graph light when configs are transpiled\n    const { formatDictionaryOutput } = await import('../formatDictionary');\n\n    return formatDictionaryOutput(dictionary as Dictionary, format).content;\n  };\n\n  const afterBuild: Plugin['afterBuild'] = async ({\n    dictionaries,\n    configuration,\n  }) => {\n    // Lazy imports to keep the module graph light when configs are transpiled\n    const { getPerLocaleDictionary } = await import('@intlayer/core/plugins');\n    const { formatDictionaryOutput } = await import('../formatDictionary');\n    const { parallelize } = await import('../utils/parallelize');\n\n    const context: SyncPluginContext = { configuration };\n    const { locales } = configuration.internationalization;\n\n    // Only ever hand the adapter dictionaries owned by THIS plugin instance.\n    const ownedDictionaries = Object.entries(dictionaries.mergedDictionaries)\n      .map(([key, result]) => ({\n        key,\n        dictionary: result.dictionary as Dictionary,\n      }))\n      .filter(({ dictionary }) => dictionary.location === location);\n\n    if (await resolveSplitKeys()) {\n      // Split mode: every namespace dictionary writes back into the same\n      // per-locale target. Re-assemble them under their top-level key and\n      // write each target once, instead of one write per key (which would\n      // overwrite).\n      const mergedContentByLocale = {} as Record<Locale, SyncContent>;\n      const writeKeyByLocale = {} as Record<Locale, string>;\n\n      for (const { key, dictionary } of ownedDictionaries) {\n        for (const locale of locales) {\n          const localizedDictionary = getPerLocaleDictionary(\n            dictionary,\n            locale\n          );\n\n          const formattedOutput = formatDictionaryOutput(\n            localizedDictionary,\n            format\n          );\n\n          const content = toPlainContent(formattedOutput.content);\n\n          if (isEmptyContent(content)) continue;\n\n          mergedContentByLocale[locale] ??= {};\n          mergedContentByLocale[locale][key] = content;\n          writeKeyByLocale[locale] = key;\n        }\n      }\n\n      await parallelize(\n        Object.keys(mergedContentByLocale) as Locale[],\n        async (locale) => {\n          await adapter.write(\n            { key: writeKeyByLocale[locale], locale },\n            mergedContentByLocale[locale],\n            context\n          );\n        }\n      );\n\n      return;\n    }\n\n    const writeTasks = ownedDictionaries.flatMap(({ key, dictionary }) =>\n      locales.map((locale) => ({ key, dictionary, locale }))\n    );\n\n    await parallelize(writeTasks, async ({ key, dictionary, locale }) => {\n      const localizedDictionary = getPerLocaleDictionary(dictionary, locale);\n\n      const formattedOutput = formatDictionaryOutput(\n        localizedDictionary,\n        format\n      );\n\n      const content = toPlainContent(formattedOutput.content);\n\n      if (isEmptyContent(content)) return;\n\n      await adapter.write({ key, locale }, content as SyncContent, context);\n    });\n  };\n\n  return { name, loadDictionaries, formatOutput, afterBuild };\n};\n"],"mappings":"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"}
+{"version":3,"file":"createSyncPlugin.mjs","names":[],"sources":["../../../src/syncPluginKit/createSyncPlugin.ts"],"sourcesContent":["import { relative, resolve } from 'node:path';\nimport { colorizePath, getAppLogger } from '@intlayer/config/logger';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { Dictionary, LocalDictionaryId } from '@intlayer/types/dictionary';\nimport type { Plugin } from '@intlayer/types/plugin';\nimport type {\n  CreateSyncPluginOptions,\n  SyncContent,\n  SyncPluginContext,\n} from './types';\n\n/**\n * Content that carries nothing to persist: `undefined`, `null`, or an object\n * without any own key. Writing it back would erase the target.\n */\nconst isEmptyContent = (content: unknown): boolean =>\n  typeof content === 'undefined' ||\n  content === null ||\n  (typeof content === 'object' && Object.keys(content).length === 0);\n\n/**\n * Deep-clone formatted output into plain JSON data, stripping prototypes and\n * non-serializable values before the emptiness check and the write.\n */\nconst toPlainContent = (content: unknown): unknown =>\n  typeof content === 'undefined'\n    ? undefined\n    : JSON.parse(JSON.stringify(content));\n\n/**\n * Build an Intlayer {@link Plugin} from a transport adapter.\n *\n * The factory implements the three plugin hooks once — ingestion\n * (`loadDictionaries`), content-declaration reformatting (`formatOutput`) and\n * write-back (`afterBuild`) — so adapters only describe *where* content lives\n * (filesystem, TMS such as Crowdin, extra CMS…) and codecs only describe the\n * payload format. Write-back only processes dictionaries whose `location`\n * matches this plugin instance, so adapters never see foreign content.\n */\nexport const createSyncPlugin = (options: CreateSyncPluginOptions): Plugin => {\n  const {\n    name,\n    adapter,\n    direction = 'both',\n    location,\n    priority = 0,\n    format,\n    localeOverride,\n  } = options;\n\n  let splitKeysPromise: Promise<boolean> | undefined;\n\n  /**\n   * `splitKeys` resolution is asynchronous (adapter auto-detection may parse\n   * an async source pattern), so it is resolved lazily and memoized.\n   */\n  const resolveSplitKeys = (): Promise<boolean> => {\n    splitKeysPromise ??= (async () =>\n      options.splitKeys ?? (await adapter.detectSplitKeys?.()) ?? false)();\n\n    return splitKeysPromise;\n  };\n\n  const loadDictionaries: Plugin['loadDictionaries'] = async ({\n    configuration,\n  }) => {\n    const context: SyncPluginContext = { configuration };\n    const appLogger = getAppLogger(configuration);\n\n    const entries = await adapter.list(context);\n\n    if (entries.length === 0) {\n      const sourceDescription =\n        (await adapter.describeSource?.(context)) ?? name;\n\n      appLogger(\n        `[${name}] No dictionaries found at locations matching source pattern: ${colorizePath(sourceDescription)}`,\n        { level: 'warn' }\n      );\n    }\n\n    const shouldSplitByKeys = await resolveSplitKeys();\n    const { baseDir } = configuration.system;\n    const { defaultLocale } = configuration.internationalization;\n\n    // Sync plugins advertise the source pattern (with {{key}}/{{locale}}\n    // markers) as fill target; pull-only plugins fill each entry in place.\n    let patternFill: string | undefined;\n\n    if (direction === 'both' && adapter.getFillPattern) {\n      const fillPattern = await adapter.getFillPattern(context);\n      patternFill = relative(baseDir, resolve(baseDir, fillPattern));\n    }\n\n    const dictionaries: Dictionary[] = [];\n\n    for (const entry of entries) {\n      const content = (await adapter.read(entry, context)) ?? {};\n\n      const relativeFilePath = entry.filePath\n        ? relative(baseDir, entry.filePath)\n        : undefined;\n\n      const usedLocale = (localeOverride ?? entry.locale) as Locale;\n      const filled = usedLocale !== defaultLocale ? true : undefined;\n      const fill = patternFill ?? relativeFilePath;\n      const identifier = relativeFilePath ?? entry.uri;\n\n      // One entry groups several namespaces by its first-level keys: emit one\n      // dictionary per top-level key (e.g. `Hero`, `Nav`, …).\n      if (shouldSplitByKeys) {\n        for (const [namespaceKey, namespaceContent] of Object.entries(\n          content\n        )) {\n          dictionaries.push({\n            key: namespaceKey,\n            locale: usedLocale,\n            fill,\n            format,\n            localId:\n              `${namespaceKey}::${location}::${identifier}` as LocalDictionaryId,\n            location: location as Dictionary['location'],\n            filled,\n            content: namespaceContent as SyncContent,\n            filePath: relativeFilePath,\n            priority,\n          } as Dictionary);\n        }\n        continue;\n      }\n\n      dictionaries.push({\n        key: entry.key,\n        locale: usedLocale,\n        fill,\n        format,\n        localId:\n          `${entry.key}::${location}::${identifier}` as LocalDictionaryId,\n        location: location as Dictionary['location'],\n        filled,\n        content,\n        filePath: relativeFilePath,\n        priority,\n      } as Dictionary);\n    }\n\n    return dictionaries;\n  };\n\n  if (direction === 'pull') {\n    return { name, loadDictionaries };\n  }\n\n  const formatOutput: Plugin['formatOutput'] = async ({\n    dictionary,\n    configuration,\n  }) => {\n    if (!dictionary.filePath || !dictionary.locale) return dictionary;\n\n    // In split mode several namespaces share the same target; the target is\n    // re-assembled in `afterBuild`. Skip here to avoid overwriting the whole\n    // target with a single namespace.\n    if (await resolveSplitKeys()) return dictionary;\n\n    // Ownership check: only reformat declarations this adapter can identify\n    // as its own canonical target.\n    if (!adapter.resolveUri) return dictionary;\n\n    const canonicalUri = await adapter.resolveUri(\n      { key: dictionary.key, locale: dictionary.locale as Locale },\n      { configuration }\n    );\n\n    const { baseDir } = configuration.system;\n\n    if (\n      resolve(baseDir, canonicalUri) !== resolve(baseDir, dictionary.filePath)\n    ) {\n      return dictionary;\n    }\n\n    // Lazy import to keep the module graph light when configs are transpiled\n    const { formatDictionaryOutput } = await import('../formatDictionary');\n\n    return formatDictionaryOutput(dictionary as Dictionary, format).content;\n  };\n\n  const afterBuild: Plugin['afterBuild'] = async ({\n    dictionaries,\n    configuration,\n  }) => {\n    // Lazy imports to keep the module graph light when configs are transpiled\n    const { getPerLocaleDictionary } = await import('@intlayer/core/plugins');\n    const { formatDictionaryOutput } = await import('../formatDictionary');\n    const { parallelize } = await import('../utils/parallelize');\n\n    const context: SyncPluginContext = { configuration };\n    const { locales } = configuration.internationalization;\n\n    // Only ever hand the adapter dictionaries owned by THIS plugin instance.\n    const ownedDictionaries = Object.entries(dictionaries.mergedDictionaries)\n      .map(([key, result]) => ({\n        key,\n        dictionary: result.dictionary as Dictionary,\n      }))\n      .filter(({ dictionary }) => dictionary.location === location);\n\n    if (await resolveSplitKeys()) {\n      // Split mode: every namespace dictionary writes back into the same\n      // per-locale target. Re-assemble them under their top-level key and\n      // write each target once, instead of one write per key (which would\n      // overwrite).\n      const mergedContentByLocale = {} as Record<Locale, SyncContent>;\n      const writeKeyByLocale = {} as Record<Locale, string>;\n\n      for (const { key, dictionary } of ownedDictionaries) {\n        for (const locale of locales) {\n          const localizedDictionary = getPerLocaleDictionary(\n            dictionary,\n            locale\n          );\n\n          const formattedOutput = formatDictionaryOutput(\n            localizedDictionary,\n            format\n          );\n\n          const content = toPlainContent(formattedOutput.content);\n\n          if (isEmptyContent(content)) continue;\n\n          mergedContentByLocale[locale] ??= {};\n          mergedContentByLocale[locale][key] = content;\n          writeKeyByLocale[locale] = key;\n        }\n      }\n\n      await parallelize(\n        Object.keys(mergedContentByLocale) as Locale[],\n        async (locale) => {\n          await adapter.write(\n            { key: writeKeyByLocale[locale], locale },\n            mergedContentByLocale[locale],\n            context\n          );\n        }\n      );\n\n      return;\n    }\n\n    const writeTasks = ownedDictionaries.flatMap(({ key, dictionary }) =>\n      locales.map((locale) => ({ key, dictionary, locale }))\n    );\n\n    await parallelize(writeTasks, async ({ key, dictionary, locale }) => {\n      const localizedDictionary = getPerLocaleDictionary(dictionary, locale);\n\n      const formattedOutput = formatDictionaryOutput(\n        localizedDictionary,\n        format\n      );\n\n      const content = toPlainContent(formattedOutput.content);\n\n      if (isEmptyContent(content)) return;\n\n      await adapter.write({ key, locale }, content as SyncContent, context);\n    });\n  };\n\n  return { name, loadDictionaries, formatOutput, afterBuild };\n};\n"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"babelParser.mjs","names":[],"sources":["../../../src/utils/babelParser.ts"],"sourcesContent":["import { createRequire } from 'node:module';\nimport type {\n  babelTsParser as babelTsParserImpl,\n  RecastParser,\n  typescriptParser as typescriptParserImpl,\n} from '@intlayer/babel/babelParser';\n\n/**\n * Recast-compatible parsers, backed by `@intlayer/babel`.\n *\n * All Babel operations live in `@intlayer/babel`, so this package never depends\n * on `@babel/parser` directly. `@intlayer/babel/babelParser` is loaded lazily on\n * the first `parse` call: `recast.parse` invokes `parser.parse` synchronously,\n * so a `require` (rather than a dynamic `import`) is used to keep the API\n * synchronous while deferring the load — `@babel/parser` stays off the hot path\n * until an AST transform actually runs.\n *\n * `@intlayer/babel` is an optional peer dependency of `@intlayer/engine`. The\n * flows that use these parsers (`intlayer init`, content-declaration writes) are\n * driven by `@intlayer/cli`, which ships `@intlayer/babel`, so it is present\n * whenever these parsers are needed.\n */\n\n/** Works in both the ESM and CJS builds (see `@intlayer/config`'s helper). */\nconst isESModule = typeof import.meta.url === 'string';\nconst engineRequire: NodeJS.Require = isESModule\n  ? createRequire(import.meta.url)\n  : require;\n\nconst BABEL_PARSER_MODULE = '@intlayer/babel/babelParser';\n\ntype BabelParserModule = {\n  typescriptParser: typeof typescriptParserImpl;\n  babelTsParser: typeof babelTsParserImpl;\n};\n\nlet cachedModule: BabelParserModule | undefined;\n\n/**\n * Lazily resolves `@intlayer/babel/babelParser`, caching the result.\n *\n * @throws If `@intlayer/babel` is not installed.\n */\nconst loadBabelParser = (): BabelParserModule => {\n  if (cachedModule) return cachedModule;\n\n  try {\n    cachedModule = engineRequire(BABEL_PARSER_MODULE) as BabelParserModule;\n  } catch (error) {\n    throw new Error(\n      `Failed to load \"${BABEL_PARSER_MODULE}\". Install \"@intlayer/babel\" to enable AST-based transforms.`,\n      { cause: error }\n    );\n  }\n\n  return cachedModule;\n};\n\nexport type { RecastParser };\n\n/** Drop-in replacement for `recast/parsers/typescript` (TS without JSX). */\nexport const typescriptParser: RecastParser = {\n  parse: (source: string) => loadBabelParser().typescriptParser.parse(source),\n};\n\n/** Drop-in replacement for `recast/parsers/babel-ts` (TS *and* JSX). */\nexport const babelTsParser: RecastParser = {\n  parse: (source: string) => loadBabelParser().babelTsParser.parse(source),\n};\n"],"mappings":";;;;AAyBA,MAAM,gBADa,OAAO,OAAO,KAAK,QAAQ,WAE1C,cAAc,OAAO,KAAK,GAAG;AAGjC,MAAM,sBAAsB;AAO5B,IAAI;;;;;;AAOJ,MAAM,wBAA2C;CAC/C,IAAI,cAAc,OAAO;CAEzB,IAAI;EACF,eAAe,cAAc,mBAAmB;CAClD,SAAS,OAAO;EACd,MAAM,IAAI,MACR,mBAAmB,oBAAoB,+DACvC,EAAE,OAAO,MAAM,CACjB;CACF;CAEA,OAAO;AACT;;AAKA,MAAa,mBAAiC,EAC5C,QAAQ,WAAmB,gBAAgB,CAAC,CAAC,iBAAiB,MAAM,MAAM,EAC5E;;AAGA,MAAa,gBAA8B,EACzC,QAAQ,WAAmB,gBAAgB,CAAC,CAAC,cAAc,MAAM,MAAM,EACzE"}
+{"version":3,"file":"babelParser.mjs","names":[],"sources":["../../../src/utils/babelParser.ts"],"sourcesContent":["import { createRequire } from 'node:module';\nimport type {\n  babelTsParser as babelTsParserImpl,\n  RecastParser,\n  typescriptParser as typescriptParserImpl,\n} from '@intlayer/babel/babelParser';\n\n/**\n * Recast-compatible parsers, backed by `@intlayer/babel`.\n *\n * All Babel operations live in `@intlayer/babel`, so this package never depends\n * on `@babel/parser` directly. `@intlayer/babel/babelParser` is loaded lazily on\n * the first `parse` call: `recast.parse` invokes `parser.parse` synchronously,\n * so a `require` (rather than a dynamic `import`) is used to keep the API\n * synchronous while deferring the load — `@babel/parser` stays off the hot path\n * until an AST transform actually runs.\n *\n * `@intlayer/babel` is an optional peer dependency of `@intlayer/engine`. The\n * flows that use these parsers (`intlayer init`, content-declaration writes) are\n * driven by `@intlayer/cli`, which ships `@intlayer/babel`, so it is present\n * whenever these parsers are needed.\n */\n\n/** Works in both the ESM and CJS builds (see `@intlayer/config`'s helper). */\nconst isESModule = typeof import.meta.url === 'string';\nconst engineRequire: NodeJS.Require = isESModule\n  ? createRequire(import.meta.url)\n  : require;\n\nconst BABEL_PARSER_MODULE = '@intlayer/babel/babelParser';\n\ntype BabelParserModule = {\n  typescriptParser: typeof typescriptParserImpl;\n  babelTsParser: typeof babelTsParserImpl;\n};\n\nlet cachedModule: BabelParserModule | undefined;\n\n/**\n * Lazily resolves `@intlayer/babel/babelParser`, caching the result.\n *\n * @throws If `@intlayer/babel` is not installed.\n */\nconst loadBabelParser = (): BabelParserModule => {\n  if (cachedModule) return cachedModule;\n\n  try {\n    cachedModule = engineRequire(BABEL_PARSER_MODULE) as BabelParserModule;\n  } catch (error) {\n    throw new Error(\n      `Failed to load \"${BABEL_PARSER_MODULE}\". Install \"@intlayer/babel\" to enable AST-based transforms.`,\n      { cause: error }\n    );\n  }\n\n  return cachedModule;\n};\n\nexport type { RecastParser };\n\n/** Drop-in replacement for `recast/parsers/typescript` (TS without JSX). */\nexport const typescriptParser: RecastParser = {\n  parse: (source: string) => loadBabelParser().typescriptParser.parse(source),\n};\n\n/** Drop-in replacement for `recast/parsers/babel-ts` (TS *and* JSX). */\nexport const babelTsParser: RecastParser = {\n  parse: (source: string) => loadBabelParser().babelTsParser.parse(source),\n};\n"],"mappings":";;;;AAyBA,MAAM,gBADa,OAAO,YAAY,QAAQ,WAE1C,cAAc,YAAY,GAAG;AAGjC,MAAM,sBAAsB;AAO5B,IAAI;;;;;;AAOJ,MAAM,wBAA2C;CAC/C,IAAI,cAAc,OAAO;CAEzB,IAAI;EACF,eAAe,cAAc,mBAAmB;CAClD,SAAS,OAAO;EACd,MAAM,IAAI,MACR,mBAAmB,oBAAoB,+DACvC,EAAE,OAAO,MAAM,CACjB;CACF;CAEA,OAAO;AACT;;AAKA,MAAa,mBAAiC,EAC5C,QAAQ,WAAmB,gBAAgB,CAAC,CAAC,iBAAiB,MAAM,MAAM,EAC5E;;AAGA,MAAa,gBAA8B,EACzC,QAAQ,WAAmB,gBAAgB,CAAC,CAAC,cAAc,MAAM,MAAM,EACzE"}

package/dist/esm/utils/chunkArray.mjs

@@ -0,0 +1,22 @@
+//#region src/utils/chunkArray.ts
+/**
+* Splits an array into consecutive chunks of at most `chunkSize` items.
+*
+* The last chunk holds the remainder and may be smaller. An empty input, or a
+* `chunkSize` lower than 1, returns an empty list of chunks.
+*
+* @example
+* ```ts
+* chunkArray(['a', 'b', 'c', 'd', 'e'], 2); // [['a', 'b'], ['c', 'd'], ['e']]
+* ```
+*/
+const chunkArray = (items, chunkSize) => {
+	if (chunkSize < 1) return [];
+	const chunks = [];
+	for (let index = 0; index < items.length; index += chunkSize) chunks.push(items.slice(index, index + chunkSize));
+	return chunks;
+};
+
+//#endregion
+export { chunkArray };
+//# sourceMappingURL=chunkArray.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunkArray.mjs","names":[],"sources":["../../../src/utils/chunkArray.ts"],"sourcesContent":["/**\n * Splits an array into consecutive chunks of at most `chunkSize` items.\n *\n * The last chunk holds the remainder and may be smaller. An empty input, or a\n * `chunkSize` lower than 1, returns an empty list of chunks.\n *\n * @example\n * ```ts\n * chunkArray(['a', 'b', 'c', 'd', 'e'], 2); // [['a', 'b'], ['c', 'd'], ['e']]\n * ```\n */\nexport const chunkArray = <T>(items: T[], chunkSize: number): T[][] => {\n  if (chunkSize < 1) return [];\n\n  const chunks: T[][] = [];\n\n  for (let index = 0; index < items.length; index += chunkSize) {\n    chunks.push(items.slice(index, index + chunkSize));\n  }\n\n  return chunks;\n};\n"],"mappings":";;;;;;;;;;;;AAWA,MAAa,cAAiB,OAAY,cAA6B;CACrE,IAAI,YAAY,GAAG,OAAO,CAAC;CAE3B,MAAM,SAAgB,CAAC;CAEvB,KAAK,IAAI,QAAQ,GAAG,QAAQ,MAAM,QAAQ,SAAS,WACjD,OAAO,KAAK,MAAM,MAAM,OAAO,QAAQ,SAAS,CAAC;CAGnD,OAAO;AACT"}

package/dist/esm/utils/getContentExtension.mjs

@@ -16,9 +16,7 @@ const getContentExtension = (format, configuration) => {
 		case "cjs":
 			contentFileExtension = ".cjs";
 			break;
-		case "esm":
-			contentFileExtension = ".js";
-			break;
+		case "esm": contentFileExtension = ".js";
 	}
 	return configuration.content.fileExtensions.find((extension) => extension.endsWith(contentFileExtension)) ?? configuration.content.fileExtensions[0] ?? `.content${contentFileExtension}`;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"getContentExtension.mjs","names":[],"sources":["../../../src/utils/getContentExtension.ts"],"sourcesContent":["import type { IntlayerConfig } from '@intlayer/types/config';\n\n/**\n * Generates the .content file extension based on the desired format\n * and the project's fileExtensions configuration.\n *\n * Example:\n * format 'ts' -> '.content.ts'\n * format 'esm' -> '.content.js' (if matching .content.js is found in config)\n */\nexport const getContentExtension = (\n  format: 'ts' | 'esm' | 'cjs' | 'json' | 'jsonc' | 'json5' | (string & {}),\n  configuration: IntlayerConfig\n): string => {\n  let contentFileExtension = '.ts';\n  switch (format) {\n    case 'json':\n      contentFileExtension = '.json';\n      break;\n    case 'cjs':\n      contentFileExtension = '.cjs';\n      break;\n    case 'esm':\n      contentFileExtension = '.js';\n      break;\n  }\n\n  // Find the configured extension that matches the format's extension\n  const pickedFileExtension = configuration.content.fileExtensions.find(\n    (extension) => extension.endsWith(contentFileExtension)\n  );\n\n  return (\n    pickedFileExtension ??\n    configuration.content.fileExtensions[0] ??\n    `.content${contentFileExtension}`\n  );\n};\n"],"mappings":";;;;;;;;;AAUA,MAAa,uBACX,QACA,kBACW;CACX,IAAI,uBAAuB;CAC3B,QAAQ,QAAR;EACE,KAAK;GACH,uBAAuB;GACvB;EACF,KAAK;GACH,uBAAuB;GACvB;EACF,KAAK;GACH,uBAAuB;GACvB;CACJ;CAOA,OAJ4B,cAAc,QAAQ,eAAe,MAC9D,cAAc,UAAU,SAAS,oBAAoB,CAIpC,KAClB,cAAc,QAAQ,eAAe,MACrC,WAAW;AAEf"}
+{"version":3,"file":"getContentExtension.mjs","names":[],"sources":["../../../src/utils/getContentExtension.ts"],"sourcesContent":["import type { IntlayerConfig } from '@intlayer/types/config';\n\n/**\n * Generates the .content file extension based on the desired format\n * and the project's fileExtensions configuration.\n *\n * Example:\n * format 'ts' -> '.content.ts'\n * format 'esm' -> '.content.js' (if matching .content.js is found in config)\n */\nexport const getContentExtension = (\n  format: 'ts' | 'esm' | 'cjs' | 'json' | 'jsonc' | 'json5' | (string & {}),\n  configuration: IntlayerConfig\n): string => {\n  let contentFileExtension = '.ts';\n  switch (format) {\n    case 'json':\n      contentFileExtension = '.json';\n      break;\n    case 'cjs':\n      contentFileExtension = '.cjs';\n      break;\n    case 'esm':\n      contentFileExtension = '.js';\n      break;\n  }\n\n  // Find the configured extension that matches the format's extension\n  const pickedFileExtension = configuration.content.fileExtensions.find(\n    (extension) => extension.endsWith(contentFileExtension)\n  );\n\n  return (\n    pickedFileExtension ??\n    configuration.content.fileExtensions[0] ??\n    `.content${contentFileExtension}`\n  );\n};\n"],"mappings":";;;;;;;;;AAUA,MAAa,uBACX,QACA,kBACW;CACX,IAAI,uBAAuB;CAC3B,QAAQ,QAAR;EACE,KAAK;GACH,uBAAuB;GACvB;EACF,KAAK;GACH,uBAAuB;GACvB;EACF,KAAK,OACH,uBAAuB;CAE3B;CAOA,OAJ4B,cAAc,QAAQ,eAAe,MAC9D,cAAc,UAAU,SAAS,oBAAoB,CAIpC,KAClB,cAAc,QAAQ,eAAe,MACrC,WAAW;AAEf"}

package/dist/esm/utils/index.mjs

@@ -4,6 +4,7 @@ import { getPathHash } from "./getPathHash.mjs";
 import { formatLocale, formatPath } from "./formatter.mjs";
 import { autoDecorateContent } from "./autoDecorateContent.mjs";
 import { buildComponentFilesList } from "./buildComponentFilesList.mjs";
+import { chunkArray } from "./chunkArray.mjs";
 import { splitTextByLines } from "./splitTextByLine.mjs";
 import { getChunk } from "./getChunk.mjs";
 import { assembleJSON, chunkJSON, reconstructFromSingleChunk } from "./chunkJSON.mjs";
@@ -19,4 +20,4 @@ import { runParallel } from "./runParallel/index.mjs";
 import { sortAlphabetically } from "./sortAlphabetically.mjs";
 import { verifyIdenticObjectFormat } from "./verifyIdenticObjectFormat.mjs";
 
-export { Queue, assembleJSON, autoDecorateContent, buildComponentFilesList, chunkJSON, excludeObjectFormat, formatLocale, formatPath, getChunk, getContentExtension, getExtensionFromFormat, getFormatFromExtension, getGlobalLimiter, getPathHash, getTaskLimiter, mergeChunks, pLimit, parallelize, parallelizeGlobal, reconstructFromSingleChunk, reduceObjectFormat, resolveObjectPromises, resolveRelativePath, runOnce, runParallel, sortAlphabetically, splitTextByLines, verifyIdenticObjectFormat };
+export { Queue, assembleJSON, autoDecorateContent, buildComponentFilesList, chunkArray, chunkJSON, excludeObjectFormat, formatLocale, formatPath, getChunk, getContentExtension, getExtensionFromFormat, getFormatFromExtension, getGlobalLimiter, getPathHash, getTaskLimiter, mergeChunks, pLimit, parallelize, parallelizeGlobal, reconstructFromSingleChunk, reduceObjectFormat, resolveObjectPromises, resolveRelativePath, runOnce, runParallel, sortAlphabetically, splitTextByLines, verifyIdenticObjectFormat };

package/dist/esm/utils/resolveRelativePath.mjs

@@ -11,7 +11,10 @@ const resolveRelativePath = (path, sourcePath, baseDir) => {
 		}
 		return normalizedResult;
 	}
-	if (path.startsWith("./") || path.startsWith("../")) return resolve(dirname(sourcePath), path);
+	if (path.startsWith("./") || path.startsWith("../")) {
+		const fileDir = dirname(sourcePath);
+		return resolve(fileDir, path);
+	}
 	return resolve(baseDir, path);
 };
 

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

@@ -1 +1 @@
-{"version":3,"file":"resolveRelativePath.mjs","names":[],"sources":["../../../src/utils/resolveRelativePath.ts"],"sourcesContent":["import { dirname, isAbsolute, normalize, resolve } from 'node:path';\n\nexport const resolveRelativePath = (\n  path: string,\n  sourcePath: string,\n  baseDir: string\n) => {\n  // Handle absolute paths\n  if (isAbsolute(path)) {\n    const normalizedResult = normalize(path);\n    const normalizedBaseDir = normalize(baseDir);\n\n    // Check if it's relative to baseDir (starts with /)\n    // but not a system path (like /usr/local)\n    if (\n      path.startsWith('/') &&\n      !normalizedResult.startsWith(normalizedBaseDir)\n    ) {\n      // Try to resolve it relative to baseDir first\n      const relativeToBase = resolve(baseDir, path.substring(1));\n\n      // If the path doesn't exist in common system directories, treat as relative to baseDir\n      if (\n        !path.startsWith('/usr/') &&\n        !path.startsWith('/etc/') &&\n        !path.startsWith('/var/') &&\n        !path.startsWith('/home/') &&\n        !path.startsWith('/Users/') &&\n        !path.startsWith('/tmp/') &&\n        !path.startsWith('/private/') &&\n        !path.startsWith('/opt/')\n      ) {\n        return relativeToBase;\n      }\n    }\n\n    // It's a true system absolute path\n    return normalizedResult;\n  }\n\n  // Handle relative paths (starting with ./ or ../)\n  if (path.startsWith('./') || path.startsWith('../')) {\n    const fileDir = dirname(sourcePath);\n    return resolve(fileDir, path);\n  }\n\n  // Default case: treat as relative to baseDir\n  return resolve(baseDir, path);\n};\n"],"mappings":";;;AAEA,MAAa,uBACX,MACA,YACA,YACG;CAEH,IAAI,WAAW,IAAI,GAAG;EACpB,MAAM,mBAAmB,UAAU,IAAI;EACvC,MAAM,oBAAoB,UAAU,OAAO;EAI3C,IACE,KAAK,WAAW,GAAG,KACnB,CAAC,iBAAiB,WAAW,iBAAiB,GAC9C;GAEA,MAAM,iBAAiB,QAAQ,SAAS,KAAK,UAAU,CAAC,CAAC;GAGzD,IACE,CAAC,KAAK,WAAW,OAAO,KACxB,CAAC,KAAK,WAAW,OAAO,KACxB,CAAC,KAAK,WAAW,OAAO,KACxB,CAAC,KAAK,WAAW,QAAQ,KACzB,CAAC,KAAK,WAAW,SAAS,KAC1B,CAAC,KAAK,WAAW,OAAO,KACxB,CAAC,KAAK,WAAW,WAAW,KAC5B,CAAC,KAAK,WAAW,OAAO,GAExB,OAAO;EAEX;EAGA,OAAO;CACT;CAGA,IAAI,KAAK,WAAW,IAAI,KAAK,KAAK,WAAW,KAAK,GAEhD,OAAO,QADS,QAAQ,UACH,GAAG,IAAI;CAI9B,OAAO,QAAQ,SAAS,IAAI;AAC9B"}
+{"version":3,"file":"resolveRelativePath.mjs","names":[],"sources":["../../../src/utils/resolveRelativePath.ts"],"sourcesContent":["import { dirname, isAbsolute, normalize, resolve } from 'node:path';\n\nexport const resolveRelativePath = (\n  path: string,\n  sourcePath: string,\n  baseDir: string\n) => {\n  // Handle absolute paths\n  if (isAbsolute(path)) {\n    const normalizedResult = normalize(path);\n    const normalizedBaseDir = normalize(baseDir);\n\n    // Check if it's relative to baseDir (starts with /)\n    // but not a system path (like /usr/local)\n    if (\n      path.startsWith('/') &&\n      !normalizedResult.startsWith(normalizedBaseDir)\n    ) {\n      // Try to resolve it relative to baseDir first\n      const relativeToBase = resolve(baseDir, path.substring(1));\n\n      // If the path doesn't exist in common system directories, treat as relative to baseDir\n      if (\n        !path.startsWith('/usr/') &&\n        !path.startsWith('/etc/') &&\n        !path.startsWith('/var/') &&\n        !path.startsWith('/home/') &&\n        !path.startsWith('/Users/') &&\n        !path.startsWith('/tmp/') &&\n        !path.startsWith('/private/') &&\n        !path.startsWith('/opt/')\n      ) {\n        return relativeToBase;\n      }\n    }\n\n    // It's a true system absolute path\n    return normalizedResult;\n  }\n\n  // Handle relative paths (starting with ./ or ../)\n  if (path.startsWith('./') || path.startsWith('../')) {\n    const fileDir = dirname(sourcePath);\n    return resolve(fileDir, path);\n  }\n\n  // Default case: treat as relative to baseDir\n  return resolve(baseDir, path);\n};\n"],"mappings":";;;AAEA,MAAa,uBACX,MACA,YACA,YACG;CAEH,IAAI,WAAW,IAAI,GAAG;EACpB,MAAM,mBAAmB,UAAU,IAAI;EACvC,MAAM,oBAAoB,UAAU,OAAO;EAI3C,IACE,KAAK,WAAW,GAAG,KACnB,CAAC,iBAAiB,WAAW,iBAAiB,GAC9C;GAEA,MAAM,iBAAiB,QAAQ,SAAS,KAAK,UAAU,CAAC,CAAC;GAGzD,IACE,CAAC,KAAK,WAAW,OAAO,KACxB,CAAC,KAAK,WAAW,OAAO,KACxB,CAAC,KAAK,WAAW,OAAO,KACxB,CAAC,KAAK,WAAW,QAAQ,KACzB,CAAC,KAAK,WAAW,SAAS,KAC1B,CAAC,KAAK,WAAW,OAAO,KACxB,CAAC,KAAK,WAAW,WAAW,KAC5B,CAAC,KAAK,WAAW,OAAO,GAExB,OAAO;EAEX;EAGA,OAAO;CACT;CAGA,IAAI,KAAK,WAAW,IAAI,KAAK,KAAK,WAAW,KAAK,GAAG;EACnD,MAAM,UAAU,QAAQ,UAAU;EAClC,OAAO,QAAQ,SAAS,IAAI;CAC9B;CAGA,OAAO,QAAQ,SAAS,IAAI;AAC9B"}

package/dist/esm/utils/runOnce.mjs

@@ -5,8 +5,8 @@ import packageJson from "@intlayer/core/package.json" with { type: "json" };
 
 //#region src/utils/runOnce.ts
 const DEFAULT_RUN_ONCE_OPTIONS = {
-	cacheTimeoutMs: 60 * 1e3,
-	lockWaitTimeoutMs: 300 * 1e3
+	cacheTimeoutMs: 6e4,
+	lockWaitTimeoutMs: 3e5
 };
 /** Delay between two reads of a sentinel owned by another process. */
 const LOCK_POLL_INTERVAL_MS = 50;

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

@@ -1 +1 @@
-{"version":3,"file":"runOnce.mjs","names":[],"sources":["../../../src/utils/runOnce.ts"],"sourcesContent":["import { rmSync } from 'node:fs';\nimport { mkdir, readFile, stat, unlink, writeFile } from 'node:fs/promises';\nimport { dirname } from 'node:path';\nimport packageJson from '@intlayer/core/package.json' with { type: 'json' };\n\n/**\n * Lifecycle of the run described by a sentinel file.\n *\n * - `running` — a process owns the sentinel and its callback is still in flight.\n *   Other processes must wait instead of starting a concurrent run.\n * - `done` — the callback completed; the sentinel is now a plain cache marker.\n */\ntype SentinelStatus = 'running' | 'done';\n\ntype SentinelData = {\n  version: string;\n  timestamp: number;\n  status: SentinelStatus;\n  /** PID of the process that owns the sentinel, used to detect abandoned locks. */\n  pid: number;\n};\n\n/** Sentinel state as read from disk, enriched with the file's modification time. */\ntype SentinelState = SentinelData & { mtimeMs: number };\n\n/**\n * Context handed to the callback so it can interact with the lock it runs under.\n */\nexport type RunOnceContext = {\n  /**\n   * Re-create the sentinel file after an operation that may have deleted it —\n   * typically cleaning the output directory, which wipes the cache directory the\n   * sentinel lives in. Without this, concurrent processes would see no lock and\n   * start a competing run while this one is still writing.\n   */\n  renewLock: () => Promise<void>;\n};\n\ntype RunOnceOptions = {\n  /**\n   * The function to execute when the sentinel is not found or is older than the cache timeout.\n   */\n  onIsCached?: () => void | Promise<void>;\n  /**\n   * The time window in milliseconds during which the sentinel is considered valid.\n   *\n   * @default 60000 = 1 minute\n   */\n  cacheTimeoutMs?: number;\n  /**\n   * If true, the callback will always run. If undefined, the callback will run only if the sentinel is older than the cache timeout.\n   *\n   * @default false\n   */\n  forceRun?: boolean;\n  /**\n   * How long to wait for another process to release the sentinel before\n   * considering its run abandoned and taking the lock over.\n   *\n   * @default 300000 = 5 minutes\n   */\n  lockWaitTimeoutMs?: number;\n};\n\nconst DEFAULT_RUN_ONCE_OPTIONS = {\n  cacheTimeoutMs: 60 * 1000, // 1 minute in milliseconds,\n  lockWaitTimeoutMs: 5 * 60 * 1000, // 5 minutes in milliseconds\n} satisfies RunOnceOptions;\n\n/** Delay between two reads of a sentinel owned by another process. */\nconst LOCK_POLL_INTERVAL_MS = 50;\n\nconst delay = (durationMs: number): Promise<void> =>\n  new Promise((resolve) => setTimeout(resolve, durationMs));\n\n/**\n * Sentinels owned by this process, released synchronously on exit so a crash or\n * a Ctrl-C never leaves a `running` lock that would stall the next run.\n */\nconst ownedSentinelFilePaths = new Set<string>();\n\nprocess.on('exit', () => {\n  for (const sentinelFilePath of ownedSentinelFilePaths) {\n    try {\n      rmSync(sentinelFilePath, { force: true });\n    } catch {}\n  }\n});\n\n/**\n * Reads the sentinel file, returning `undefined` when it does not exist or\n * cannot be parsed.\n *\n * Sentinels written by older versions carry no `status`; they always describe a\n * finished run, so they are reported as `done`.\n */\nconst readSentinelState = async (\n  sentinelFilePath: string\n): Promise<SentinelState | undefined> => {\n  try {\n    const [sentinelStats, raw] = await Promise.all([\n      stat(sentinelFilePath),\n      readFile(sentinelFilePath, 'utf8'),\n    ]);\n\n    const parsed = JSON.parse(raw) as Partial<SentinelData>;\n\n    return {\n      version: parsed.version ?? '',\n      timestamp: parsed.timestamp ?? 0,\n      status: parsed.status ?? 'done',\n      pid: parsed.pid ?? 0,\n      mtimeMs: sentinelStats.mtime.getTime(),\n    };\n  } catch {\n    return undefined;\n  }\n};\n\n/**\n * Whether the process that wrote the sentinel is still alive. An unknown PID\n * (legacy sentinel) is assumed alive so the staleness timeout stays the only\n * way to reclaim it.\n */\nconst isOwnerProcessAlive = (pid: number): boolean => {\n  if (!pid || pid === process.pid) return true;\n\n  try {\n    // Signal 0 performs an existence check without delivering a signal.\n    process.kill(pid, 0);\n    return true;\n  } catch (error) {\n    // EPERM means the process exists but belongs to another user.\n    return (error as NodeJS.ErrnoException).code === 'EPERM';\n  }\n};\n\nconst serializeSentinel = (timestamp: number, status: SentinelStatus): string =>\n  JSON.stringify({\n    version: packageJson.version,\n    timestamp,\n    status,\n    pid: process.pid,\n  } satisfies SentinelData);\n\n/**\n * Attempts to take ownership of the sentinel.\n *\n * `wx` makes the creation atomic, so exactly one process can win even when\n * several start at the same moment.\n *\n * @returns `true` when this process now owns the sentinel, `false` when another\n * process created it first.\n */\nconst acquireSentinel = async (\n  sentinelFilePath: string,\n  timestamp: number\n): Promise<boolean> => {\n  const data = serializeSentinel(timestamp, 'running');\n\n  for (let attempt = 0; attempt < 2; attempt++) {\n    try {\n      // Ensure the directory exists before writing the file\n      await mkdir(dirname(sentinelFilePath), { recursive: true });\n\n      await writeFile(sentinelFilePath, data, { flag: 'wx' });\n      return true;\n    } catch (error) {\n      const code = (error as NodeJS.ErrnoException).code;\n\n      if (code === 'EEXIST') return false;\n      // The directory was removed between the mkdir and the write (e.g. a\n      // concurrent output-directory clean); retry once.\n      if (code === 'ENOENT' && attempt === 0) continue;\n\n      throw error;\n    }\n  }\n\n  return false;\n};\n\n/**\n * Rewrites the sentinel owned by this process, overwriting any existing file.\n */\nconst writeOwnedSentinel = async (\n  sentinelFilePath: string,\n  timestamp: number,\n  status: SentinelStatus\n): Promise<void> => {\n  try {\n    await mkdir(dirname(sentinelFilePath), { recursive: true });\n    await writeFile(sentinelFilePath, serializeSentinel(timestamp, status));\n  } catch {}\n};\n\nconst removeSentinel = async (sentinelFilePath: string): Promise<void> => {\n  try {\n    await unlink(sentinelFilePath);\n  } catch {}\n};\n\n/**\n * Ensures a callback function runs only once within a specified time window across multiple processes.\n * Uses a sentinel file to coordinate execution and prevent duplicate work.\n *\n * Processes that lose the race for the sentinel wait for the owner to finish\n * rather than running a competing copy of the callback — concurrent runs would\n * otherwise write to (and clean) the same output directory at the same time.\n *\n * @param sentinelFilePath - Path to the sentinel file used for coordination\n * @param callback - The function to execute (should be async)\n * @param options - The options for the runOnce function\n *\n * @example\n * ```typescript\n * await runOnce(\n *   '/tmp/intlayer-sentinel',\n *   async ({ renewLock }) => {\n *     await cleanOutputDir(configuration); // may delete the sentinel\n *     await renewLock();\n *     await prepareIntlayer();\n *   },\n *   { cacheTimeoutMs: 30 * 1000 } // 30 seconds cache\n * );\n * ```\n *\n * @throws {Error} When there are unexpected filesystem errors\n */\nexport const runOnce = async (\n  sentinelFilePath: string,\n  callback: (context: RunOnceContext) => void | Promise<void>,\n  options?: RunOnceOptions\n) => {\n  const { onIsCached, cacheTimeoutMs, forceRun, lockWaitTimeoutMs } = {\n    ...DEFAULT_RUN_ONCE_OPTIONS,\n    ...(options ?? {}),\n  };\n  const currentTimestamp = Date.now();\n  const waitDeadline = currentTimestamp + lockWaitTimeoutMs;\n\n  // Acquisition loop: read the sentinel, then either return early (fresh cache),\n  // wait for the current owner, or take the lock. Every branch either returns or\n  // makes progress, so the loop always terminates.\n  while (true) {\n    const sentinelState = await readSentinelState(sentinelFilePath);\n\n    if (sentinelState) {\n      const sentinelAge = Date.now() - sentinelState.mtimeMs;\n\n      if (sentinelState.status === 'running') {\n        const isAbandoned =\n          sentinelAge > lockWaitTimeoutMs ||\n          !isOwnerProcessAlive(sentinelState.pid);\n\n        if (!isAbandoned && Date.now() < waitDeadline) {\n          await delay(LOCK_POLL_INTERVAL_MS);\n          continue;\n        }\n\n        // The owner died or overran the timeout: reclaim the sentinel.\n        await removeSentinel(sentinelFilePath);\n        continue;\n      }\n\n      const isCacheValid =\n        !forceRun &&\n        sentinelAge <= cacheTimeoutMs &&\n        sentinelState.version === packageJson.version;\n\n      if (isCacheValid) {\n        await onIsCached?.();\n        return;\n      }\n\n      await removeSentinel(sentinelFilePath);\n    }\n\n    const hasAcquiredSentinel = await acquireSentinel(\n      sentinelFilePath,\n      currentTimestamp\n    );\n\n    if (hasAcquiredSentinel) break;\n\n    // Another process won the race in the meantime: loop back and wait for it.\n    // The delay also guarantees the loop yields, so a sentinel being repeatedly\n    // created and removed can never turn into a busy wait.\n    await delay(LOCK_POLL_INTERVAL_MS);\n  }\n\n  ownedSentinelFilePaths.add(sentinelFilePath);\n\n  const renewLock = () =>\n    writeOwnedSentinel(sentinelFilePath, currentTimestamp, 'running');\n\n  try {\n    await callback({ renewLock });\n\n    // Mark the run as finished, re-creating the sentinel if the callback\n    // deleted it (e.g. by cleaning the output directory).\n    await writeOwnedSentinel(sentinelFilePath, currentTimestamp, 'done');\n  } catch {\n    await removeSentinel(sentinelFilePath); // Remove sentinel file if an error occurs\n  } finally {\n    ownedSentinelFilePaths.delete(sentinelFilePath);\n  }\n};\n"],"mappings":"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"}
+{"version":3,"file":"runOnce.mjs","names":[],"sources":["../../../src/utils/runOnce.ts"],"sourcesContent":["import { rmSync } from 'node:fs';\nimport { mkdir, readFile, stat, unlink, writeFile } from 'node:fs/promises';\nimport { dirname } from 'node:path';\nimport packageJson from '@intlayer/core/package.json' with { type: 'json' };\n\n/**\n * Lifecycle of the run described by a sentinel file.\n *\n * - `running` — a process owns the sentinel and its callback is still in flight.\n *   Other processes must wait instead of starting a concurrent run.\n * - `done` — the callback completed; the sentinel is now a plain cache marker.\n */\ntype SentinelStatus = 'running' | 'done';\n\ntype SentinelData = {\n  version: string;\n  timestamp: number;\n  status: SentinelStatus;\n  /** PID of the process that owns the sentinel, used to detect abandoned locks. */\n  pid: number;\n};\n\n/** Sentinel state as read from disk, enriched with the file's modification time. */\ntype SentinelState = SentinelData & { mtimeMs: number };\n\n/**\n * Context handed to the callback so it can interact with the lock it runs under.\n */\nexport type RunOnceContext = {\n  /**\n   * Re-create the sentinel file after an operation that may have deleted it —\n   * typically cleaning the output directory, which wipes the cache directory the\n   * sentinel lives in. Without this, concurrent processes would see no lock and\n   * start a competing run while this one is still writing.\n   */\n  renewLock: () => Promise<void>;\n};\n\ntype RunOnceOptions = {\n  /**\n   * The function to execute when the sentinel is not found or is older than the cache timeout.\n   */\n  onIsCached?: () => void | Promise<void>;\n  /**\n   * The time window in milliseconds during which the sentinel is considered valid.\n   *\n   * @default 60000 = 1 minute\n   */\n  cacheTimeoutMs?: number;\n  /**\n   * If true, the callback will always run. If undefined, the callback will run only if the sentinel is older than the cache timeout.\n   *\n   * @default false\n   */\n  forceRun?: boolean;\n  /**\n   * How long to wait for another process to release the sentinel before\n   * considering its run abandoned and taking the lock over.\n   *\n   * @default 300000 = 5 minutes\n   */\n  lockWaitTimeoutMs?: number;\n};\n\nconst DEFAULT_RUN_ONCE_OPTIONS = {\n  cacheTimeoutMs: 60 * 1000, // 1 minute in milliseconds,\n  lockWaitTimeoutMs: 5 * 60 * 1000, // 5 minutes in milliseconds\n} satisfies RunOnceOptions;\n\n/** Delay between two reads of a sentinel owned by another process. */\nconst LOCK_POLL_INTERVAL_MS = 50;\n\nconst delay = (durationMs: number): Promise<void> =>\n  new Promise((resolve) => setTimeout(resolve, durationMs));\n\n/**\n * Sentinels owned by this process, released synchronously on exit so a crash or\n * a Ctrl-C never leaves a `running` lock that would stall the next run.\n */\nconst ownedSentinelFilePaths = new Set<string>();\n\nprocess.on('exit', () => {\n  for (const sentinelFilePath of ownedSentinelFilePaths) {\n    try {\n      rmSync(sentinelFilePath, { force: true });\n    } catch {}\n  }\n});\n\n/**\n * Reads the sentinel file, returning `undefined` when it does not exist or\n * cannot be parsed.\n *\n * Sentinels written by older versions carry no `status`; they always describe a\n * finished run, so they are reported as `done`.\n */\nconst readSentinelState = async (\n  sentinelFilePath: string\n): Promise<SentinelState | undefined> => {\n  try {\n    const [sentinelStats, raw] = await Promise.all([\n      stat(sentinelFilePath),\n      readFile(sentinelFilePath, 'utf8'),\n    ]);\n\n    const parsed = JSON.parse(raw) as Partial<SentinelData>;\n\n    return {\n      version: parsed.version ?? '',\n      timestamp: parsed.timestamp ?? 0,\n      status: parsed.status ?? 'done',\n      pid: parsed.pid ?? 0,\n      mtimeMs: sentinelStats.mtime.getTime(),\n    };\n  } catch {\n    return undefined;\n  }\n};\n\n/**\n * Whether the process that wrote the sentinel is still alive. An unknown PID\n * (legacy sentinel) is assumed alive so the staleness timeout stays the only\n * way to reclaim it.\n */\nconst isOwnerProcessAlive = (pid: number): boolean => {\n  if (!pid || pid === process.pid) return true;\n\n  try {\n    // Signal 0 performs an existence check without delivering a signal.\n    process.kill(pid, 0);\n    return true;\n  } catch (error) {\n    // EPERM means the process exists but belongs to another user.\n    return (error as NodeJS.ErrnoException).code === 'EPERM';\n  }\n};\n\nconst serializeSentinel = (timestamp: number, status: SentinelStatus): string =>\n  JSON.stringify({\n    version: packageJson.version,\n    timestamp,\n    status,\n    pid: process.pid,\n  } satisfies SentinelData);\n\n/**\n * Attempts to take ownership of the sentinel.\n *\n * `wx` makes the creation atomic, so exactly one process can win even when\n * several start at the same moment.\n *\n * @returns `true` when this process now owns the sentinel, `false` when another\n * process created it first.\n */\nconst acquireSentinel = async (\n  sentinelFilePath: string,\n  timestamp: number\n): Promise<boolean> => {\n  const data = serializeSentinel(timestamp, 'running');\n\n  for (let attempt = 0; attempt < 2; attempt++) {\n    try {\n      // Ensure the directory exists before writing the file\n      await mkdir(dirname(sentinelFilePath), { recursive: true });\n\n      await writeFile(sentinelFilePath, data, { flag: 'wx' });\n      return true;\n    } catch (error) {\n      const code = (error as NodeJS.ErrnoException).code;\n\n      if (code === 'EEXIST') return false;\n      // The directory was removed between the mkdir and the write (e.g. a\n      // concurrent output-directory clean); retry once.\n      if (code === 'ENOENT' && attempt === 0) continue;\n\n      throw error;\n    }\n  }\n\n  return false;\n};\n\n/**\n * Rewrites the sentinel owned by this process, overwriting any existing file.\n */\nconst writeOwnedSentinel = async (\n  sentinelFilePath: string,\n  timestamp: number,\n  status: SentinelStatus\n): Promise<void> => {\n  try {\n    await mkdir(dirname(sentinelFilePath), { recursive: true });\n    await writeFile(sentinelFilePath, serializeSentinel(timestamp, status));\n  } catch {}\n};\n\nconst removeSentinel = async (sentinelFilePath: string): Promise<void> => {\n  try {\n    await unlink(sentinelFilePath);\n  } catch {}\n};\n\n/**\n * Ensures a callback function runs only once within a specified time window across multiple processes.\n * Uses a sentinel file to coordinate execution and prevent duplicate work.\n *\n * Processes that lose the race for the sentinel wait for the owner to finish\n * rather than running a competing copy of the callback — concurrent runs would\n * otherwise write to (and clean) the same output directory at the same time.\n *\n * @param sentinelFilePath - Path to the sentinel file used for coordination\n * @param callback - The function to execute (should be async)\n * @param options - The options for the runOnce function\n *\n * @example\n * ```typescript\n * await runOnce(\n *   '/tmp/intlayer-sentinel',\n *   async ({ renewLock }) => {\n *     await cleanOutputDir(configuration); // may delete the sentinel\n *     await renewLock();\n *     await prepareIntlayer();\n *   },\n *   { cacheTimeoutMs: 30 * 1000 } // 30 seconds cache\n * );\n * ```\n *\n * @throws {Error} When there are unexpected filesystem errors\n */\nexport const runOnce = async (\n  sentinelFilePath: string,\n  callback: (context: RunOnceContext) => void | Promise<void>,\n  options?: RunOnceOptions\n) => {\n  const { onIsCached, cacheTimeoutMs, forceRun, lockWaitTimeoutMs } = {\n    ...DEFAULT_RUN_ONCE_OPTIONS,\n    ...(options ?? {}),\n  };\n  const currentTimestamp = Date.now();\n  const waitDeadline = currentTimestamp + lockWaitTimeoutMs;\n\n  // Acquisition loop: read the sentinel, then either return early (fresh cache),\n  // wait for the current owner, or take the lock. Every branch either returns or\n  // makes progress, so the loop always terminates.\n  while (true) {\n    const sentinelState = await readSentinelState(sentinelFilePath);\n\n    if (sentinelState) {\n      const sentinelAge = Date.now() - sentinelState.mtimeMs;\n\n      if (sentinelState.status === 'running') {\n        const isAbandoned =\n          sentinelAge > lockWaitTimeoutMs ||\n          !isOwnerProcessAlive(sentinelState.pid);\n\n        if (!isAbandoned && Date.now() < waitDeadline) {\n          await delay(LOCK_POLL_INTERVAL_MS);\n          continue;\n        }\n\n        // The owner died or overran the timeout: reclaim the sentinel.\n        await removeSentinel(sentinelFilePath);\n        continue;\n      }\n\n      const isCacheValid =\n        !forceRun &&\n        sentinelAge <= cacheTimeoutMs &&\n        sentinelState.version === packageJson.version;\n\n      if (isCacheValid) {\n        await onIsCached?.();\n        return;\n      }\n\n      await removeSentinel(sentinelFilePath);\n    }\n\n    const hasAcquiredSentinel = await acquireSentinel(\n      sentinelFilePath,\n      currentTimestamp\n    );\n\n    if (hasAcquiredSentinel) break;\n\n    // Another process won the race in the meantime: loop back and wait for it.\n    // The delay also guarantees the loop yields, so a sentinel being repeatedly\n    // created and removed can never turn into a busy wait.\n    await delay(LOCK_POLL_INTERVAL_MS);\n  }\n\n  ownedSentinelFilePaths.add(sentinelFilePath);\n\n  const renewLock = () =>\n    writeOwnedSentinel(sentinelFilePath, currentTimestamp, 'running');\n\n  try {\n    await callback({ renewLock });\n\n    // Mark the run as finished, re-creating the sentinel if the callback\n    // deleted it (e.g. by cleaning the output directory).\n    await writeOwnedSentinel(sentinelFilePath, currentTimestamp, 'done');\n  } catch {\n    await removeSentinel(sentinelFilePath); // Remove sentinel file if an error occurs\n  } finally {\n    ownedSentinelFilePaths.delete(sentinelFilePath);\n  }\n};\n"],"mappings":";;;;;;AAgEA,MAAM,2BAA2B;CAC/B,gBAAgB;CAChB,mBAAmB;AACrB;;AAGA,MAAM,wBAAwB;AAE9B,MAAM,SAAS,eACb,IAAI,SAAS,YAAY,WAAW,SAAS,UAAU,CAAC;;;;;AAM1D,MAAM,yCAAyB,IAAI,IAAY;AAE/C,QAAQ,GAAG,cAAc;CACvB,KAAK,MAAM,oBAAoB,wBAC7B,IAAI;EACF,OAAO,kBAAkB,EAAE,OAAO,KAAK,CAAC;CAC1C,QAAQ,CAAC;AAEb,CAAC;;;;;;;;AASD,MAAM,oBAAoB,OACxB,qBACuC;CACvC,IAAI;EACF,MAAM,CAAC,eAAe,OAAO,MAAM,QAAQ,IAAI,CAC7C,KAAK,gBAAgB,GACrB,SAAS,kBAAkB,MAAM,CACnC,CAAC;EAED,MAAM,SAAS,KAAK,MAAM,GAAG;EAE7B,OAAO;GACL,SAAS,OAAO,WAAW;GAC3B,WAAW,OAAO,aAAa;GAC/B,QAAQ,OAAO,UAAU;GACzB,KAAK,OAAO,OAAO;GACnB,SAAS,cAAc,MAAM,QAAQ;EACvC;CACF,QAAQ;EACN;CACF;AACF;;;;;;AAOA,MAAM,uBAAuB,QAAyB;CACpD,IAAI,CAAC,OAAO,QAAQ,QAAQ,KAAK,OAAO;CAExC,IAAI;EAEF,QAAQ,KAAK,KAAK,CAAC;EACnB,OAAO;CACT,SAAS,OAAO;EAEd,OAAQ,MAAgC,SAAS;CACnD;AACF;AAEA,MAAM,qBAAqB,WAAmB,WAC5C,KAAK,UAAU;CACb,SAAS,YAAY;CACrB;CACA;CACA,KAAK,QAAQ;AACf,CAAwB;;;;;;;;;;AAW1B,MAAM,kBAAkB,OACtB,kBACA,cACqB;CACrB,MAAM,OAAO,kBAAkB,WAAW,SAAS;CAEnD,KAAK,IAAI,UAAU,GAAG,UAAU,GAAG,WACjC,IAAI;EAEF,MAAM,MAAM,QAAQ,gBAAgB,GAAG,EAAE,WAAW,KAAK,CAAC;EAE1D,MAAM,UAAU,kBAAkB,MAAM,EAAE,MAAM,KAAK,CAAC;EACtD,OAAO;CACT,SAAS,OAAO;EACd,MAAM,OAAQ,MAAgC;EAE9C,IAAI,SAAS,UAAU,OAAO;EAG9B,IAAI,SAAS,YAAY,YAAY,GAAG;EAExC,MAAM;CACR;CAGF,OAAO;AACT;;;;AAKA,MAAM,qBAAqB,OACzB,kBACA,WACA,WACkB;CAClB,IAAI;EACF,MAAM,MAAM,QAAQ,gBAAgB,GAAG,EAAE,WAAW,KAAK,CAAC;EAC1D,MAAM,UAAU,kBAAkB,kBAAkB,WAAW,MAAM,CAAC;CACxE,QAAQ,CAAC;AACX;AAEA,MAAM,iBAAiB,OAAO,qBAA4C;CACxE,IAAI;EACF,MAAM,OAAO,gBAAgB;CAC/B,QAAQ,CAAC;AACX;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,MAAa,UAAU,OACrB,kBACA,UACA,YACG;CACH,MAAM,EAAE,YAAY,gBAAgB,UAAU,sBAAsB;EAClE,GAAG;EACH,GAAI,WAAW,CAAC;CAClB;CACA,MAAM,mBAAmB,KAAK,IAAI;CAClC,MAAM,eAAe,mBAAmB;CAKxC,OAAO,MAAM;EACX,MAAM,gBAAgB,MAAM,kBAAkB,gBAAgB;EAE9D,IAAI,eAAe;GACjB,MAAM,cAAc,KAAK,IAAI,IAAI,cAAc;GAE/C,IAAI,cAAc,WAAW,WAAW;IAKtC,IAAI,EAHF,cAAc,qBACd,CAAC,oBAAoB,cAAc,GAAG,MAEpB,KAAK,IAAI,IAAI,cAAc;KAC7C,MAAM,MAAM,qBAAqB;KACjC;IACF;IAGA,MAAM,eAAe,gBAAgB;IACrC;GACF;GAOA,IAJE,CAAC,YACD,eAAe,kBACf,cAAc,YAAY,YAAY,SAEtB;IAChB,MAAM,aAAa;IACnB;GACF;GAEA,MAAM,eAAe,gBAAgB;EACvC;EAOA,IAAI,MAL8B,gBAChC,kBACA,gBACF,GAEyB;EAKzB,MAAM,MAAM,qBAAqB;CACnC;CAEA,uBAAuB,IAAI,gBAAgB;CAE3C,MAAM,kBACJ,mBAAmB,kBAAkB,kBAAkB,SAAS;CAElE,IAAI;EACF,MAAM,SAAS,EAAE,UAAU,CAAC;EAI5B,MAAM,mBAAmB,kBAAkB,kBAAkB,MAAM;CACrE,QAAQ;EACN,MAAM,eAAe,gBAAgB;CACvC,UAAU;EACR,uBAAuB,OAAO,gBAAgB;CAChD;AACF"}

package/dist/esm/watcher.mjs

@@ -81,7 +81,8 @@ const watch = async (options) => {
 				if (rel.endsWith(".tmp")) continue;
 				if (event.type === "update") processEvent(async () => {
 					try {
-						await transpileTSToCJS(await readFile(event.path, "utf-8"), event.path);
+						const entryCode = await readFile(event.path, "utf-8");
+						await transpileTSToCJS(entryCode, event.path);
 					} catch {
 						appLogger(`Entry point ${basename(event.path)} failed to load, running clean rebuild...`, { level: "warn" });
 						await prepareIntlayer(configuration, {
@@ -166,8 +167,9 @@ const watch = async (options) => {
 					processEvent(async () => {
 						if (await readFile(filePath, "utf-8") === "") {
 							const extensionPattern = fileExtensions.map((ext) => ext.replace(/\./g, "\\.")).join("|");
+							const name = fileName.replace(new RegExp(`(${extensionPattern})$`), "");
 							await writeContentDeclaration({
-								key: fileName.replace(new RegExp(`(${extensionPattern})$`), ""),
+								key: name,
 								content: {},
 								filePath
 							}, configuration);