@intlayer/core 8.4.3 → 8.4.5

package/dist/cjs/localization/rewriteUtils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"rewriteUtils.cjs","names":[],"sources":["../../../src/localization/rewriteUtils.ts"],"sourcesContent":["import type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport type { RewriteObject, RewriteRules, RoutingConfig } from '@intlayer/types/config';\nimport type { Locale } from '@intlayer/types/allLocales';\n\nexport type LocalizedPathResult = {\n  path: string;\n  isRewritten: boolean;\n};\n\n/**\n * Normalizes legacy Record format or extracts specialized rules from RewriteObject.\n */\nexport const getRewriteRules = (\n  rewrite: RoutingConfig['rewrite'],\n  context: keyof RewriteObject = 'url'\n): RewriteRules | undefined => {\n  if (!rewrite) return undefined;\n\n  if ('url' in rewrite) {\n    return (rewrite as RewriteObject)[context];\n  }\n\n  // Normalize legacy format\n  return {\n    rules: Object.entries(rewrite).map(([canonical, localized]) => ({\n      // Normalize canonical path\n      canonical: canonical.startsWith('/')\n        ? canonical.replace(/\\[([^\\]]+)\\]/g, ':$1')\n        : `/${canonical.replace(/\\[([^\\]]+)\\]/g, ':$1')}`,\n\n      // Normalize localized path\n      localized: Object.fromEntries(\n        Object.entries(localized).map(([locale, pattern]) => {\n          const normalizedPattern = pattern?.startsWith('/')\n            ? pattern.replace(/\\[([^\\]]+)\\]/g, ':$1')\n            : `/${(pattern || '').replace(/\\[([^\\]]+)\\]/g, ':$1')}`;\n          return [locale, normalizedPattern];\n        })\n      ),\n    })),\n  };\n};\n\n/**\n * Converts normalized pattern to Regex.\n * Internal syntax supports:\n * - :param -> ([^/]+) (one segment)\n * - :param* -> (.*) (zero or more segments)\n * - :param+ -> (.+) (one or more segments)\n * - :param? -> ([^/]*) (zero or one segment)\n */\nconst patternToRegex = (pattern: string) => {\n  const regexString = pattern\n    .replace(/\\//g, '\\\\/') // Escape slashes\n    .replace(/\\\\\\/:(?:[^/\\\\*+?]+)\\*/g, '(?:\\\\/(.*))?') // /:param*\n    .replace(/\\\\\\/:(?:[^/\\\\*+?]+)\\?/g, '(?:\\\\/([^\\\\/]+))?') // /:param?\n    .replace(/:([^/\\\\*+?]+)\\*/g, '(.*)') // :param* (if no leading slash)\n    .replace(/:([^/\\\\*+?]+)\\?/g, '([^\\\\/]*)') // :param? (if no leading slash)\n    .replace(/:([^/\\\\*+?]+)\\+/g, '(.+)') // :param+\n    .replace(/:([^/\\\\*+?]+)/g, '([^\\\\/]+)'); // :param\n\n  return new RegExp(`^${regexString}$`);\n};\n\n/**\n * Replaces route parameters in a path with provided values.\n */\nconst fillPath = (pattern: string, params: string[]) => {\n  let index = 0;\n  return (\n    pattern\n      .replace(/:([^/\\\\*+?]+)[*+?]?/g, () => params[index++] ?? '')\n      .replace(/\\/+/g, '/')\n      .replace(/\\/$/, '') || '/'\n  );\n};\n\n/**\n * Extract values from a URL based on a pattern.\n */\nconst extractParams = (url: string, pattern: string): string[] | null => {\n  const regex = patternToRegex(pattern);\n  const match = url.match(regex);\n  return match ? match.slice(1) : null;\n};\n\n/**\n * Given a localized URL (e.g., \"/produits/123\"), finds the canonical internal path (e.g., \"/products/123\").\n * If locale is provided, only check for that locale. Otherwise, check for all locales.\n */\nexport const getCanonicalPath = (\n  localizedPath: string,\n  locale?: Locale,\n  rewriteRules?: RewriteRules\n): string => {\n  if (!rewriteRules) return localizedPath;\n\n  for (const rule of rewriteRules.rules) {\n    const { canonical, localized } = rule;\n    const localesToCheck = locale ? [locale] : Object.keys(localized);\n\n    for (const loc of localesToCheck) {\n      const localizedPattern = localized[loc as keyof typeof localized];\n\n      if (!localizedPattern) continue;\n\n      const params = extractParams(localizedPath, localizedPattern);\n\n      if (params) {\n        return fillPath(canonical, params);\n      }\n    }\n  }\n\n  return localizedPath;\n};\n\n/**\n * Given a canonical path (e.g., \"/products/123\"), finds the localized URL pattern (e.g., \"/produits/123\").\n */\nexport const getLocalizedPath = (\n  canonicalPath: string,\n  locale: LocalesValues,\n  rewriteRules?: RewriteRules\n): LocalizedPathResult => {\n  if (!rewriteRules) return { path: canonicalPath, isRewritten: false };\n\n  for (const rule of rewriteRules.rules) {\n    const { canonical, localized } = rule;\n\n    // Check if the input path matches a configured canonical pattern\n    const params = extractParams(canonicalPath, canonical);\n\n    if (params) {\n      const targetPattern = localized[locale as keyof typeof localized];\n\n      if (targetPattern) {\n        return {\n          path: fillPath(targetPattern, params),\n          isRewritten: true,\n        };\n      }\n    }\n  }\n\n  return { path: canonicalPath, isRewritten: false };\n};\n\n/**\n * Returns the internal path for a given canonical path and locale.\n * Ensures the locale prefix is present exactly once.\n */\nexport const getInternalPath = (\n  canonicalPath: string,\n  locale: Locale\n): string => {\n  const pathWithLeadingSlash = canonicalPath.startsWith('/')\n    ? canonicalPath\n    : `/${canonicalPath}`;\n\n  if (\n    pathWithLeadingSlash.startsWith(`/${locale}/`) ||\n    pathWithLeadingSlash === `/${locale}`\n  ) {\n    return pathWithLeadingSlash;\n  }\n\n  return `/${locale}${pathWithLeadingSlash === '/' ? '' : pathWithLeadingSlash}`;\n};\n\n/**\n * Given a current pathname and locale, returns the pretty localized path if a rewrite rule exists and the path is not already localized.\n */\nexport const getRewritePath = (\n  pathname: string,\n  locale: Locale,\n  rewrite?: RoutingConfig['rewrite']\n): string | undefined => {\n  const rules = getRewriteRules(rewrite, 'url');\n  if (!rules) return undefined;\n\n  // Identify canonical path (relative to root, no locale prefix expected in 'url' context)\n  const canonicalPath = getCanonicalPath(pathname, undefined, rules);\n\n  // Get the localized path for the current locale\n  const { path: localizedPath, isRewritten } = getLocalizedPath(\n    canonicalPath,\n    locale,\n    rules\n  );\n\n  if (isRewritten && localizedPath !== pathname) {\n    return localizedPath;\n  }\n\n  return undefined;\n};\n"],"mappings":"mEAYA,MAAa,GACX,EACA,EAA+B,QACF,CACxB,KAOL,MALI,QAAS,EACH,EAA0B,GAI7B,CACL,MAAO,OAAO,QAAQ,EAAQ,CAAC,KAAK,CAAC,EAAW,MAAgB,CAE9D,UAAW,EAAU,WAAW,IAAI,CAChC,EAAU,QAAQ,gBAAiB,MAAM,CACzC,IAAI,EAAU,QAAQ,gBAAiB,MAAM,GAGjD,UAAW,OAAO,YAChB,OAAO,QAAQ,EAAU,CAAC,KAAK,CAAC,EAAQ,KAI/B,CAAC,EAHkB,GAAS,WAAW,IAAI,CAC9C,EAAQ,QAAQ,gBAAiB,MAAM,CACvC,KAAK,GAAW,IAAI,QAAQ,gBAAiB,MAAM,GACrB,CAClC,CACH,CACF,EAAE,CACJ,EAWG,EAAkB,GAAoB,CAC1C,IAAM,EAAc,EACjB,QAAQ,MAAO,MAAM,CACrB,QAAQ,yBAA0B,eAAe,CACjD,QAAQ,yBAA0B,oBAAoB,CACtD,QAAQ,mBAAoB,OAAO,CACnC,QAAQ,mBAAoB,YAAY,CACxC,QAAQ,mBAAoB,OAAO,CACnC,QAAQ,iBAAkB,YAAY,CAEzC,OAAW,OAAO,IAAI,EAAY,GAAG,EAMjC,GAAY,EAAiB,IAAqB,CACtD,IAAI,EAAQ,EACZ,OACE,EACG,QAAQ,2BAA8B,EAAO,MAAY,GAAG,CAC5D,QAAQ,OAAQ,IAAI,CACpB,QAAQ,MAAO,GAAG,EAAI,KAOvB,GAAiB,EAAa,IAAqC,CACvE,IAAM,EAAQ,EAAe,EAAQ,CAC/B,EAAQ,EAAI,MAAM,EAAM,CAC9B,OAAO,EAAQ,EAAM,MAAM,EAAE,CAAG,MAOrB,GACX,EACA,EACA,IACW,CACX,GAAI,CAAC,EAAc,OAAO,EAE1B,IAAK,IAAM,KAAQ,EAAa,MAAO,CACrC,GAAM,CAAE,YAAW,aAAc,EAC3B,EAAiB,EAAS,CAAC,EAAO,CAAG,OAAO,KAAK,EAAU,CAEjE,IAAK,IAAM,KAAO,EAAgB,CAChC,IAAM,EAAmB,EAAU,GAEnC,GAAI,CAAC,EAAkB,SAEvB,IAAM,EAAS,EAAc,EAAe,EAAiB,CAE7D,GAAI,EACF,OAAO,EAAS,EAAW,EAAO,EAKxC,OAAO,GAMI,GACX,EACA,EACA,IACwB,CACxB,GAAI,CAAC,EAAc,MAAO,CAAE,KAAM,EAAe,YAAa,GAAO,CAErE,IAAK,IAAM,KAAQ,EAAa,MAAO,CACrC,GAAM,CAAE,YAAW,aAAc,EAG3B,EAAS,EAAc,EAAe,EAAU,CAEtD,GAAI,EAAQ,CACV,IAAM,EAAgB,EAAU,GAEhC,GAAI,EACF,MAAO,CACL,KAAM,EAAS,EAAe,EAAO,CACrC,YAAa,GACd,EAKP,MAAO,CAAE,KAAM,EAAe,YAAa,GAAO,EAOvC,GACX,EACA,IACW,CACX,IAAM,EAAuB,EAAc,WAAW,IAAI,CACtD,EACA,IAAI,IASR,OANE,EAAqB,WAAW,IAAI,EAAO,GAAG,EAC9C,IAAyB,IAAI,IAEtB,EAGF,IAAI,IAAS,IAAyB,IAAM,GAAK,KAM7C,GACX,EACA,EACA,IACuB,CACvB,IAAM,EAAQ,EAAgB,EAAS,MAAM,CAC7C,GAAI,CAAC,EAAO,OAMZ,GAAM,CAAE,KAAM,EAAe,eAAgB,EAHvB,EAAiB,EAAU,IAAA,GAAW,EAAM,CAKhE,EACA,EACD,CAED,GAAI,GAAe,IAAkB,EACnC,OAAO"}
+{"version":3,"file":"rewriteUtils.cjs","names":[],"sources":["../../../src/localization/rewriteUtils.ts"],"sourcesContent":["import type { Locale } from '@intlayer/types/allLocales';\nimport type {\n  RewriteObject,\n  RewriteRules,\n  RoutingConfig,\n} from '@intlayer/types/config';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\n\nexport type LocalizedPathResult = {\n  path: string;\n  isRewritten: boolean;\n};\n\n/**\n * Normalizes legacy Record format or extracts specialized rules from RewriteObject.\n */\nexport const getRewriteRules = (\n  rewrite: RoutingConfig['rewrite'],\n  context: keyof RewriteObject = 'url'\n): RewriteRules | undefined => {\n  if (!rewrite) return undefined;\n\n  if ('url' in rewrite) {\n    return (rewrite as RewriteObject)[context];\n  }\n\n  // Normalize legacy format\n  return {\n    rules: Object.entries(rewrite).map(([canonical, localized]) => ({\n      // Normalize canonical path\n      canonical: canonical.startsWith('/')\n        ? canonical.replace(/\\[([^\\]]+)\\]/g, ':$1')\n        : `/${canonical.replace(/\\[([^\\]]+)\\]/g, ':$1')}`,\n\n      // Normalize localized path\n      localized: Object.fromEntries(\n        Object.entries(localized).map(([locale, pattern]) => {\n          const normalizedPattern = pattern?.startsWith('/')\n            ? pattern.replace(/\\[([^\\]]+)\\]/g, ':$1')\n            : `/${(pattern || '').replace(/\\[([^\\]]+)\\]/g, ':$1')}`;\n          return [locale, normalizedPattern];\n        })\n      ),\n    })),\n  };\n};\n\n/**\n * Converts normalized pattern to Regex.\n * Internal syntax supports:\n * - :param -> ([^/]+) (one segment)\n * - :param* -> (.*) (zero or more segments)\n * - :param+ -> (.+) (one or more segments)\n * - :param? -> ([^/]*) (zero or one segment)\n */\nconst patternToRegex = (pattern: string) => {\n  const regexString = pattern\n    .replace(/\\//g, '\\\\/') // Escape slashes\n    .replace(/\\\\\\/:(?:[^/\\\\*+?]+)\\*/g, '(?:\\\\/(.*))?') // /:param*\n    .replace(/\\\\\\/:(?:[^/\\\\*+?]+)\\?/g, '(?:\\\\/([^\\\\/]+))?') // /:param?\n    .replace(/:([^/\\\\*+?]+)\\*/g, '(.*)') // :param* (if no leading slash)\n    .replace(/:([^/\\\\*+?]+)\\?/g, '([^\\\\/]*)') // :param? (if no leading slash)\n    .replace(/:([^/\\\\*+?]+)\\+/g, '(.+)') // :param+\n    .replace(/:([^/\\\\*+?]+)/g, '([^\\\\/]+)'); // :param\n\n  return new RegExp(`^${regexString}$`);\n};\n\n/**\n * Replaces route parameters in a path with provided values.\n */\nconst fillPath = (pattern: string, params: string[]) => {\n  let index = 0;\n  return (\n    pattern\n      .replace(/:([^/\\\\*+?]+)[*+?]?/g, () => params[index++] ?? '')\n      .replace(/\\/+/g, '/')\n      .replace(/\\/$/, '') || '/'\n  );\n};\n\n/**\n * Extract values from a URL based on a pattern.\n */\nconst extractParams = (url: string, pattern: string): string[] | null => {\n  const regex = patternToRegex(pattern);\n  const match = url.match(regex);\n  return match ? match.slice(1) : null;\n};\n\n/**\n * Given a localized URL (e.g., \"/produits/123\"), finds the canonical internal path (e.g., \"/products/123\").\n * If locale is provided, only check for that locale. Otherwise, check for all locales.\n */\nexport const getCanonicalPath = (\n  localizedPath: string,\n  locale?: Locale,\n  rewriteRules?: RewriteRules\n): string => {\n  if (!rewriteRules) return localizedPath;\n\n  for (const rule of rewriteRules.rules) {\n    const { canonical, localized } = rule;\n    const localesToCheck = locale ? [locale] : Object.keys(localized);\n\n    for (const loc of localesToCheck) {\n      const localizedPattern = localized[loc as keyof typeof localized];\n\n      if (!localizedPattern) continue;\n\n      const params = extractParams(localizedPath, localizedPattern);\n\n      if (params) {\n        return fillPath(canonical, params);\n      }\n    }\n  }\n\n  return localizedPath;\n};\n\n/**\n * Given a canonical path (e.g., \"/products/123\"), finds the localized URL pattern (e.g., \"/produits/123\").\n */\nexport const getLocalizedPath = (\n  canonicalPath: string,\n  locale: LocalesValues,\n  rewriteRules?: RewriteRules\n): LocalizedPathResult => {\n  if (!rewriteRules) return { path: canonicalPath, isRewritten: false };\n\n  for (const rule of rewriteRules.rules) {\n    const { canonical, localized } = rule;\n\n    // Check if the input path matches a configured canonical pattern\n    const params = extractParams(canonicalPath, canonical);\n\n    if (params) {\n      const targetPattern = localized[locale as keyof typeof localized];\n\n      if (targetPattern) {\n        return {\n          path: fillPath(targetPattern, params),\n          isRewritten: true,\n        };\n      }\n    }\n  }\n\n  return { path: canonicalPath, isRewritten: false };\n};\n\n/**\n * Returns the internal path for a given canonical path and locale.\n * Ensures the locale prefix is present exactly once.\n */\nexport const getInternalPath = (\n  canonicalPath: string,\n  locale: Locale\n): string => {\n  const pathWithLeadingSlash = canonicalPath.startsWith('/')\n    ? canonicalPath\n    : `/${canonicalPath}`;\n\n  if (\n    pathWithLeadingSlash.startsWith(`/${locale}/`) ||\n    pathWithLeadingSlash === `/${locale}`\n  ) {\n    return pathWithLeadingSlash;\n  }\n\n  return `/${locale}${pathWithLeadingSlash === '/' ? '' : pathWithLeadingSlash}`;\n};\n\n/**\n * Given a current pathname and locale, returns the pretty localized path if a rewrite rule exists and the path is not already localized.\n */\nexport const getRewritePath = (\n  pathname: string,\n  locale: Locale,\n  rewrite?: RoutingConfig['rewrite']\n): string | undefined => {\n  const rules = getRewriteRules(rewrite, 'url');\n  if (!rules) return undefined;\n\n  // Identify canonical path (relative to root, no locale prefix expected in 'url' context)\n  const canonicalPath = getCanonicalPath(pathname, undefined, rules);\n\n  // Get the localized path for the current locale\n  const { path: localizedPath, isRewritten } = getLocalizedPath(\n    canonicalPath,\n    locale,\n    rules\n  );\n\n  if (isRewritten && localizedPath !== pathname) {\n    return localizedPath;\n  }\n\n  return undefined;\n};\n"],"mappings":";;;;;;AAgBA,MAAa,mBACX,SACA,UAA+B,UACF;AAC7B,KAAI,CAAC,QAAS,QAAO;AAErB,KAAI,SAAS,QACX,QAAQ,QAA0B;AAIpC,QAAO,EACL,OAAO,OAAO,QAAQ,QAAQ,CAAC,KAAK,CAAC,WAAW,gBAAgB;EAE9D,WAAW,UAAU,WAAW,IAAI,GAChC,UAAU,QAAQ,iBAAiB,MAAM,GACzC,IAAI,UAAU,QAAQ,iBAAiB,MAAM;EAGjD,WAAW,OAAO,YAChB,OAAO,QAAQ,UAAU,CAAC,KAAK,CAAC,QAAQ,aAAa;AAInD,UAAO,CAAC,QAHkB,SAAS,WAAW,IAAI,GAC9C,QAAQ,QAAQ,iBAAiB,MAAM,GACvC,KAAK,WAAW,IAAI,QAAQ,iBAAiB,MAAM,GACrB;IAClC,CACH;EACF,EAAE,EACJ;;;;;;;;;;AAWH,MAAM,kBAAkB,YAAoB;CAC1C,MAAM,cAAc,QACjB,QAAQ,OAAO,MAAM,CACrB,QAAQ,0BAA0B,eAAe,CACjD,QAAQ,0BAA0B,oBAAoB,CACtD,QAAQ,oBAAoB,OAAO,CACnC,QAAQ,oBAAoB,YAAY,CACxC,QAAQ,oBAAoB,OAAO,CACnC,QAAQ,kBAAkB,YAAY;AAEzC,QAAO,IAAI,OAAO,IAAI,YAAY,GAAG;;;;;AAMvC,MAAM,YAAY,SAAiB,WAAqB;CACtD,IAAI,QAAQ;AACZ,QACE,QACG,QAAQ,8BAA8B,OAAO,YAAY,GAAG,CAC5D,QAAQ,QAAQ,IAAI,CACpB,QAAQ,OAAO,GAAG,IAAI;;;;;AAO7B,MAAM,iBAAiB,KAAa,YAAqC;CACvE,MAAM,QAAQ,eAAe,QAAQ;CACrC,MAAM,QAAQ,IAAI,MAAM,MAAM;AAC9B,QAAO,QAAQ,MAAM,MAAM,EAAE,GAAG;;;;;;AAOlC,MAAa,oBACX,eACA,QACA,iBACW;AACX,KAAI,CAAC,aAAc,QAAO;AAE1B,MAAK,MAAM,QAAQ,aAAa,OAAO;EACrC,MAAM,EAAE,WAAW,cAAc;EACjC,MAAM,iBAAiB,SAAS,CAAC,OAAO,GAAG,OAAO,KAAK,UAAU;AAEjE,OAAK,MAAM,OAAO,gBAAgB;GAChC,MAAM,mBAAmB,UAAU;AAEnC,OAAI,CAAC,iBAAkB;GAEvB,MAAM,SAAS,cAAc,eAAe,iBAAiB;AAE7D,OAAI,OACF,QAAO,SAAS,WAAW,OAAO;;;AAKxC,QAAO;;;;;AAMT,MAAa,oBACX,eACA,QACA,iBACwB;AACxB,KAAI,CAAC,aAAc,QAAO;EAAE,MAAM;EAAe,aAAa;EAAO;AAErE,MAAK,MAAM,QAAQ,aAAa,OAAO;EACrC,MAAM,EAAE,WAAW,cAAc;EAGjC,MAAM,SAAS,cAAc,eAAe,UAAU;AAEtD,MAAI,QAAQ;GACV,MAAM,gBAAgB,UAAU;AAEhC,OAAI,cACF,QAAO;IACL,MAAM,SAAS,eAAe,OAAO;IACrC,aAAa;IACd;;;AAKP,QAAO;EAAE,MAAM;EAAe,aAAa;EAAO;;;;;;AAOpD,MAAa,mBACX,eACA,WACW;CACX,MAAM,uBAAuB,cAAc,WAAW,IAAI,GACtD,gBACA,IAAI;AAER,KACE,qBAAqB,WAAW,IAAI,OAAO,GAAG,IAC9C,yBAAyB,IAAI,SAE7B,QAAO;AAGT,QAAO,IAAI,SAAS,yBAAyB,MAAM,KAAK;;;;;AAM1D,MAAa,kBACX,UACA,QACA,YACuB;CACvB,MAAM,QAAQ,gBAAgB,SAAS,MAAM;AAC7C,KAAI,CAAC,MAAO,QAAO;CAMnB,MAAM,EAAE,MAAM,eAAe,gBAAgB,iBAHvB,iBAAiB,UAAU,QAAW,MAAM,EAKhE,QACA,MACD;AAED,KAAI,eAAe,kBAAkB,SACnC,QAAO"}

package/dist/cjs/localization/validatePrefix.cjs

@@ -1,2 +1,46 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../chunk-Bmb41Sf3.cjs`),t=require(`./getPrefix.cjs`);let n=require(`@intlayer/config/defaultValues`),r=require(`@intlayer/config/built`);r=e.t(r);const i=(e,i)=>{let{defaultLocale:a,mode:o,locales:s}={defaultLocale:r.default?.internationalization?.defaultLocale??n.DEFAULT_LOCALE,mode:r.default?.routing?.mode??n.ROUTING_MODE,locales:r.default?.internationalization?.locales??n.LOCALES,...i},{localePrefix:c}=t.getPrefix(e||a,{mode:o,locales:s,defaultLocale:a});return c===e&&e===void 0?{isValid:!0,localePrefix:void 0}:{isValid:s.some(t=>t===e),localePrefix:c}};exports.validatePrefix=i;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_localization_getPrefix = require('./getPrefix.cjs');
+
+//#region src/localization/validatePrefix.ts
+/**
+* Checks whether a given locale is valid based on the configured locales.
+*
+* @param locale - The locale value to validate. Can be `undefined` or `null`.
+* @param options - Optional configuration to override default settings.
+* @param options.locales - Array of valid locales. Defaults to the configured internationalization locales.
+* @param options.defaultLocale - The default locale to use as fallback. Defaults to the configured default locale.
+* @param options.mode - The routing mode (`'prefix'`, `'prefix-all'`, or `'no-prefix'`). Defaults to the configured routing mode.
+* @returns An object containing the validation result and the locale prefix.
+*
+* @example
+* // Check if 'en' is a valid locale
+* const { isValid, localePrefix } = validatePrefix('en');
+*
+* @example
+* // Check with custom options
+* const { isValid, localePrefix } = validatePrefix('fr', {
+*   locales: ['en', 'fr', 'es'],
+*   defaultLocale: 'en',
+*   mode: 'prefix-all',
+* });
+*/
+const validatePrefix = (locale, options) => {
+	const { defaultLocale, mode, locales } = require_localization_getPrefix.resolveRoutingConfig(options);
+	const { localePrefix } = require_localization_getPrefix.getPrefix(locale || defaultLocale, {
+		mode,
+		locales,
+		defaultLocale
+	});
+	if (localePrefix === locale && locale === void 0) return {
+		isValid: true,
+		localePrefix: void 0
+	};
+	return {
+		isValid: locales.some((localeEl) => localeEl === locale),
+		localePrefix
+	};
+};
+
+//#endregion
+exports.validatePrefix = validatePrefix;
 //# sourceMappingURL=validatePrefix.cjs.map

package/dist/cjs/localization/validatePrefix.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"validatePrefix.cjs","names":["configuration","DEFAULT_LOCALE","ROUTING_MODE","LOCALES","getPrefix"],"sources":["../../../src/localization/validatePrefix.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport {\n  DEFAULT_LOCALE,\n  LOCALES,\n  ROUTING_MODE,\n} from '@intlayer/config/defaultValues';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { getPrefix } from './getPrefix';\n\nexport type ValidatePrefixResult = {\n  isValid: boolean;\n  localePrefix: string | undefined;\n};\n\n/**\n * Checks whether a given locale is valid based on the configured locales.\n *\n * @param locale - The locale value to validate. Can be `undefined` or `null`.\n * @param options - Optional configuration to override default settings.\n * @param options.locales - Array of valid locales. Defaults to the configured internationalization locales.\n * @param options.defaultLocale - The default locale to use as fallback. Defaults to the configured default locale.\n * @param options.mode - The routing mode (`'prefix'`, `'prefix-all'`, or `'no-prefix'`). Defaults to the configured routing mode.\n * @returns An object containing the validation result and the locale prefix.\n *\n * @example\n * // Check if 'en' is a valid locale\n * const { isValid, localePrefix } = validatePrefix('en');\n *\n * @example\n * // Check with custom options\n * const { isValid, localePrefix } = validatePrefix('fr', {\n *   locales: ['en', 'fr', 'es'],\n *   defaultLocale: 'en',\n *   mode: 'prefix-all',\n * });\n */\nexport const validatePrefix = (\n  locale: LocalesValues | undefined | null,\n  options?: {\n    locales?: LocalesValues[];\n    defaultLocale?: LocalesValues;\n    mode?: typeof configuration.routing.mode;\n  }\n): ValidatePrefixResult => {\n  const { defaultLocale, mode, locales } = {\n    defaultLocale:\n      configuration?.internationalization?.defaultLocale ?? DEFAULT_LOCALE,\n    mode: configuration?.routing?.mode ?? ROUTING_MODE,\n    locales: configuration?.internationalization?.locales ?? LOCALES,\n    ...options,\n  };\n\n  // If no locale provided (optional param), will use default\n  // In `routing.mode = 'prefix-all'`, the locale is required to be a valid locale\n  const { localePrefix } = getPrefix(locale || defaultLocale, {\n    mode,\n    locales,\n    defaultLocale,\n  });\n\n  if (localePrefix === locale && locale === undefined) {\n    return { isValid: true, localePrefix: undefined };\n  }\n\n  // Check if the provided locale is valid\n  const isValid: boolean = locales.some((localeEl) => localeEl === locale);\n\n  return { isValid: isValid, localePrefix };\n};\n"],"mappings":"sOAoCA,MAAa,GACX,EACA,IAKyB,CACzB,GAAM,CAAE,gBAAe,OAAM,WAAY,CACvC,cACEA,EAAAA,SAAe,sBAAsB,eAAiBC,EAAAA,eACxD,KAAMD,EAAAA,SAAe,SAAS,MAAQE,EAAAA,aACtC,QAASF,EAAAA,SAAe,sBAAsB,SAAWG,EAAAA,QACzD,GAAG,EACJ,CAIK,CAAE,gBAAiBC,EAAAA,UAAU,GAAU,EAAe,CAC1D,OACA,UACA,gBACD,CAAC,CASF,OAPI,IAAiB,GAAU,IAAW,IAAA,GACjC,CAAE,QAAS,GAAM,aAAc,IAAA,GAAW,CAM5C,CAAE,QAFgB,EAAQ,KAAM,GAAa,IAAa,EAAO,CAE7C,eAAc"}
+{"version":3,"file":"validatePrefix.cjs","names":["resolveRoutingConfig","getPrefix"],"sources":["../../../src/localization/validatePrefix.ts"],"sourcesContent":["import type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport {\n  getPrefix,\n  type RoutingOptions,\n  resolveRoutingConfig,\n} from './getPrefix';\n\nexport type ValidatePrefixResult = {\n  isValid: boolean;\n  localePrefix: string | undefined;\n};\n\n/**\n * Checks whether a given locale is valid based on the configured locales.\n *\n * @param locale - The locale value to validate. Can be `undefined` or `null`.\n * @param options - Optional configuration to override default settings.\n * @param options.locales - Array of valid locales. Defaults to the configured internationalization locales.\n * @param options.defaultLocale - The default locale to use as fallback. Defaults to the configured default locale.\n * @param options.mode - The routing mode (`'prefix'`, `'prefix-all'`, or `'no-prefix'`). Defaults to the configured routing mode.\n * @returns An object containing the validation result and the locale prefix.\n *\n * @example\n * // Check if 'en' is a valid locale\n * const { isValid, localePrefix } = validatePrefix('en');\n *\n * @example\n * // Check with custom options\n * const { isValid, localePrefix } = validatePrefix('fr', {\n *   locales: ['en', 'fr', 'es'],\n *   defaultLocale: 'en',\n *   mode: 'prefix-all',\n * });\n */\nexport const validatePrefix = (\n  locale: LocalesValues | undefined | null,\n  options?: RoutingOptions\n): ValidatePrefixResult => {\n  const { defaultLocale, mode, locales } = resolveRoutingConfig(options);\n\n  const { localePrefix } = getPrefix(locale || defaultLocale, {\n    mode,\n    locales,\n    defaultLocale,\n  });\n\n  if (localePrefix === locale && locale === undefined) {\n    return { isValid: true, localePrefix: undefined };\n  }\n\n  const isValid = locales.some((localeEl) => localeEl === locale);\n\n  return { isValid, localePrefix };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,MAAa,kBACX,QACA,YACyB;CACzB,MAAM,EAAE,eAAe,MAAM,YAAYA,oDAAqB,QAAQ;CAEtE,MAAM,EAAE,iBAAiBC,yCAAU,UAAU,eAAe;EAC1D;EACA;EACA;EACD,CAAC;AAEF,KAAI,iBAAiB,UAAU,WAAW,OACxC,QAAO;EAAE,SAAS;EAAM,cAAc;EAAW;AAKnD,QAAO;EAAE,SAFO,QAAQ,MAAM,aAAa,aAAa,OAAO;EAE7C;EAAc"}