@intlayer/core 7.3.15 → 7.4.0

package/dist/cjs/localization/validatePrefix.cjs

@@ -0,0 +1,54 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_localization_getPrefix = require('./getPrefix.cjs');
+let __intlayer_config_client = require("@intlayer/config/client");
+let __intlayer_config_built = require("@intlayer/config/built");
+__intlayer_config_built = require_rolldown_runtime.__toESM(__intlayer_config_built);
+
+//#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 } = {
+		defaultLocale: __intlayer_config_built.default?.internationalization?.defaultLocale ?? __intlayer_config_client.DefaultValues.Internationalization.DEFAULT_LOCALE,
+		mode: __intlayer_config_built.default?.routing?.mode ?? __intlayer_config_client.DefaultValues.Routing.ROUTING_MODE,
+		locales: __intlayer_config_built.default?.internationalization?.locales ?? __intlayer_config_client.DefaultValues.Internationalization.LOCALES,
+		...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

@@ -0,0 +1 @@
+{"version":3,"file":"validatePrefix.cjs","names":["configuration","DefaultValues","getPrefix"],"sources":["../../../src/localization/validatePrefix.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport { DefaultValues } from '@intlayer/config/client';\nimport type { LocalesValues } from '@intlayer/types';\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 ??\n      DefaultValues.Internationalization.DEFAULT_LOCALE,\n    mode: configuration?.routing?.mode ?? DefaultValues.Routing.ROUTING_MODE,\n    locales:\n      configuration?.internationalization?.locales ??\n      DefaultValues.Internationalization.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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,MAAa,kBACX,QACA,YAKyB;CACzB,MAAM,EAAE,eAAe,MAAM,YAAY;EACvC,eACEA,iCAAe,sBAAsB,iBACrCC,uCAAc,qBAAqB;EACrC,MAAMD,iCAAe,SAAS,QAAQC,uCAAc,QAAQ;EAC5D,SACED,iCAAe,sBAAsB,WACrCC,uCAAc,qBAAqB;EACrC,GAAG;EACJ;CAID,MAAM,EAAE,iBAAiBC,yCAAU,UAAU,eAAe;EAC1D;EACA;EACA;EACD,CAAC;AAEF,KAAI,iBAAiB,UAAU,WAAW,OACxC,QAAO;EAAE,SAAS;EAAM,cAAc;EAAW;AAMnD,QAAO;EAAE,SAFgB,QAAQ,MAAM,aAAa,aAAa,OAAO;EAE7C;EAAc"}

package/dist/esm/dist/esm/getStorageAttributes.mjs

@@ -0,0 +1,133 @@
+import { DefaultValues } from "@intlayer/config/client";
+
+//#region dist/esm/getStorageAttributes.mjs
+/**
+* Creates a cookie entry with default values for missing attributes
+*/
+const createCookieEntry = (options) => {
+	const { name, path, expires, domain, secure, sameSite, httpOnly } = options ?? {};
+	return {
+		name: name ?? DefaultValues.Routing.COOKIE_NAME,
+		attributes: {
+			path,
+			expires,
+			domain,
+			secure,
+			sameSite,
+			httpOnly
+		}
+	};
+};
+/**
+* Creates a web storage entry (localStorage or sessionStorage) with default name
+*/
+const createWebStorageEntry = (options) => {
+	const { name } = options ?? {};
+	return { name: name ?? DefaultValues.Routing.LOCALE_STORAGE_NAME };
+};
+/**
+* Creates a header entry with default name
+*/
+const createHeaderEntry = (options) => {
+	const { name } = options ?? {};
+	return { name: name ?? DefaultValues.Routing.HEADER_NAME };
+};
+/**
+* Determines if a storage entry is a cookie based on its properties
+*/
+const isCookieEntry = (entry) => {
+	return entry.type === "cookie" || "sameSite" in entry || "httpOnly" in entry || "secure" in entry;
+};
+/**
+* Determines the storage type from a string literal
+*/
+const isStorageType = (value) => {
+	return value === "cookie" || value === "localStorage" || value === "sessionStorage" || value === "header";
+};
+/**
+* Processes a single storage entry and returns the appropriate storage attributes
+*/
+const processStorageEntry = (entry) => {
+	if (typeof entry === "string") {
+		if (!isStorageType(entry)) return {
+			cookies: [],
+			localStorage: [],
+			sessionStorage: [],
+			headers: []
+		};
+		if (entry === "cookie") return { cookies: [createCookieEntry()] };
+		if (entry === "localStorage") return { localStorage: [createWebStorageEntry()] };
+		if (entry === "sessionStorage") return { sessionStorage: [createWebStorageEntry()] };
+		if (entry === "header") return { headers: [createHeaderEntry()] };
+	}
+	if (typeof entry === "object" && entry !== null) {
+		const typedEntry = entry;
+		if (isCookieEntry(typedEntry)) return { cookies: [createCookieEntry(typedEntry)] };
+		if ("type" in typedEntry && typedEntry.type === "localStorage") {
+			const { name: name$1, ...rest$1 } = typedEntry;
+			return { localStorage: [createWebStorageEntry({
+				name: name$1,
+				...rest$1
+			})] };
+		}
+		if ("type" in typedEntry && typedEntry.type === "sessionStorage") {
+			const { name: name$1, ...rest$1 } = typedEntry;
+			return { sessionStorage: [createWebStorageEntry({
+				name: name$1,
+				...rest$1
+			})] };
+		}
+		if ("type" in typedEntry && typedEntry.type === "header") {
+			const { name: name$1, ...rest$1 } = typedEntry;
+			return { headers: [createHeaderEntry({
+				name: name$1,
+				...rest$1
+			})] };
+		}
+		const { name, ...rest } = typedEntry;
+		return { localStorage: [createWebStorageEntry({
+			name,
+			...rest
+		})] };
+	}
+	return {
+		cookies: [],
+		localStorage: [],
+		sessionStorage: [],
+		headers: []
+	};
+};
+/**
+* Merges multiple partial storage attributes into a single result
+*/
+const mergeStorageAttributes = (accumulated, partial) => {
+	return {
+		cookies: [...accumulated.cookies, ...partial.cookies ?? []],
+		localStorage: [...accumulated.localStorage, ...partial.localStorage ?? []],
+		sessionStorage: [...accumulated.sessionStorage, ...partial.sessionStorage ?? []],
+		headers: [...accumulated.headers, ...partial.headers ?? []]
+	};
+};
+/**
+* Extracts and normalizes storage configuration into separate arrays for each storage type
+*
+* @param options - The storage configuration from IntlayerConfig
+* @returns An object containing arrays for cookies, localStorage, and sessionStorage
+*/
+const getStorageAttributes = (options) => {
+	const emptyResult = {
+		cookies: [],
+		localStorage: [],
+		sessionStorage: [],
+		headers: []
+	};
+	if (options === false || options === void 0) return emptyResult;
+	if (Array.isArray(options)) return options.reduce((acc, entry) => {
+		return mergeStorageAttributes(acc, processStorageEntry(entry));
+	}, emptyResult);
+	return mergeStorageAttributes(emptyResult, processStorageEntry(options));
+};
+
+//#endregion
+export { getStorageAttributes };
+//# sourceMappingURL=getStorageAttributes.mjs.map

package/dist/esm/dist/esm/getStorageAttributes.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getStorageAttributes.mjs","names":[],"sources":["../../getStorageAttributes.mjs"],"sourcesContent":["import { DefaultValues } from \"@intlayer/config/client\";\n\n//#region src/getStorageAttributes.ts\n/**\n* Creates a cookie entry with default values for missing attributes\n*/\nconst createCookieEntry = (options) => {\n\tconst { name, path, expires, domain, secure, sameSite, httpOnly } = options ?? {};\n\treturn {\n\t\tname: name ?? DefaultValues.Routing.COOKIE_NAME,\n\t\tattributes: {\n\t\t\tpath,\n\t\t\texpires,\n\t\t\tdomain,\n\t\t\tsecure,\n\t\t\tsameSite,\n\t\t\thttpOnly\n\t\t}\n\t};\n};\n/**\n* Creates a web storage entry (localStorage or sessionStorage) with default name\n*/\nconst createWebStorageEntry = (options) => {\n\tconst { name } = options ?? {};\n\treturn { name: name ?? DefaultValues.Routing.LOCALE_STORAGE_NAME };\n};\n/**\n* Creates a header entry with default name\n*/\nconst createHeaderEntry = (options) => {\n\tconst { name } = options ?? {};\n\treturn { name: name ?? DefaultValues.Routing.HEADER_NAME };\n};\n/**\n* Determines if a storage entry is a cookie based on its properties\n*/\nconst isCookieEntry = (entry) => {\n\treturn entry.type === \"cookie\" || \"sameSite\" in entry || \"httpOnly\" in entry || \"secure\" in entry;\n};\n/**\n* Determines the storage type from a string literal\n*/\nconst isStorageType = (value) => {\n\treturn value === \"cookie\" || value === \"localStorage\" || value === \"sessionStorage\" || value === \"header\";\n};\n/**\n* Processes a single storage entry and returns the appropriate storage attributes\n*/\nconst processStorageEntry = (entry) => {\n\tif (typeof entry === \"string\") {\n\t\tif (!isStorageType(entry)) return {\n\t\t\tcookies: [],\n\t\t\tlocalStorage: [],\n\t\t\tsessionStorage: [],\n\t\t\theaders: []\n\t\t};\n\t\tif (entry === \"cookie\") return { cookies: [createCookieEntry()] };\n\t\tif (entry === \"localStorage\") return { localStorage: [createWebStorageEntry()] };\n\t\tif (entry === \"sessionStorage\") return { sessionStorage: [createWebStorageEntry()] };\n\t\tif (entry === \"header\") return { headers: [createHeaderEntry()] };\n\t}\n\tif (typeof entry === \"object\" && entry !== null) {\n\t\tconst typedEntry = entry;\n\t\tif (isCookieEntry(typedEntry)) return { cookies: [createCookieEntry(typedEntry)] };\n\t\tif (\"type\" in typedEntry && typedEntry.type === \"localStorage\") {\n\t\t\tconst { name: name$1, ...rest$1 } = typedEntry;\n\t\t\treturn { localStorage: [createWebStorageEntry({\n\t\t\t\tname: name$1,\n\t\t\t\t...rest$1\n\t\t\t})] };\n\t\t}\n\t\tif (\"type\" in typedEntry && typedEntry.type === \"sessionStorage\") {\n\t\t\tconst { name: name$1, ...rest$1 } = typedEntry;\n\t\t\treturn { sessionStorage: [createWebStorageEntry({\n\t\t\t\tname: name$1,\n\t\t\t\t...rest$1\n\t\t\t})] };\n\t\t}\n\t\tif (\"type\" in typedEntry && typedEntry.type === \"header\") {\n\t\t\tconst { name: name$1, ...rest$1 } = typedEntry;\n\t\t\treturn { headers: [createHeaderEntry({\n\t\t\t\tname: name$1,\n\t\t\t\t...rest$1\n\t\t\t})] };\n\t\t}\n\t\tconst { name, ...rest } = typedEntry;\n\t\treturn { localStorage: [createWebStorageEntry({\n\t\t\tname,\n\t\t\t...rest\n\t\t})] };\n\t}\n\treturn {\n\t\tcookies: [],\n\t\tlocalStorage: [],\n\t\tsessionStorage: [],\n\t\theaders: []\n\t};\n};\n/**\n* Merges multiple partial storage attributes into a single result\n*/\nconst mergeStorageAttributes = (accumulated, partial) => {\n\treturn {\n\t\tcookies: [...accumulated.cookies, ...partial.cookies ?? []],\n\t\tlocalStorage: [...accumulated.localStorage, ...partial.localStorage ?? []],\n\t\tsessionStorage: [...accumulated.sessionStorage, ...partial.sessionStorage ?? []],\n\t\theaders: [...accumulated.headers, ...partial.headers ?? []]\n\t};\n};\n/**\n* Extracts and normalizes storage configuration into separate arrays for each storage type\n*\n* @param options - The storage configuration from IntlayerConfig\n* @returns An object containing arrays for cookies, localStorage, and sessionStorage\n*/\nconst getStorageAttributes = (options) => {\n\tconst emptyResult = {\n\t\tcookies: [],\n\t\tlocalStorage: [],\n\t\tsessionStorage: [],\n\t\theaders: []\n\t};\n\tif (options === false || options === void 0) return emptyResult;\n\tif (Array.isArray(options)) return options.reduce((acc, entry) => {\n\t\treturn mergeStorageAttributes(acc, processStorageEntry(entry));\n\t}, emptyResult);\n\treturn mergeStorageAttributes(emptyResult, processStorageEntry(options));\n};\n\n//#endregion\nexport { getStorageAttributes };\n//# sourceMappingURL=getStorageAttributes.mjs.map"],"mappings":";;;;;;AAMA,MAAM,qBAAqB,YAAY;CACtC,MAAM,EAAE,MAAM,MAAM,SAAS,QAAQ,QAAQ,UAAU,aAAa,WAAW,EAAE;AACjF,QAAO;EACN,MAAM,QAAQ,cAAc,QAAQ;EACpC,YAAY;GACX;GACA;GACA;GACA;GACA;GACA;GACA;EACD;;;;;AAKF,MAAM,yBAAyB,YAAY;CAC1C,MAAM,EAAE,SAAS,WAAW,EAAE;AAC9B,QAAO,EAAE,MAAM,QAAQ,cAAc,QAAQ,qBAAqB;;;;;AAKnE,MAAM,qBAAqB,YAAY;CACtC,MAAM,EAAE,SAAS,WAAW,EAAE;AAC9B,QAAO,EAAE,MAAM,QAAQ,cAAc,QAAQ,aAAa;;;;;AAK3D,MAAM,iBAAiB,UAAU;AAChC,QAAO,MAAM,SAAS,YAAY,cAAc,SAAS,cAAc,SAAS,YAAY;;;;;AAK7F,MAAM,iBAAiB,UAAU;AAChC,QAAO,UAAU,YAAY,UAAU,kBAAkB,UAAU,oBAAoB,UAAU;;;;;AAKlG,MAAM,uBAAuB,UAAU;AACtC,KAAI,OAAO,UAAU,UAAU;AAC9B,MAAI,CAAC,cAAc,MAAM,CAAE,QAAO;GACjC,SAAS,EAAE;GACX,cAAc,EAAE;GAChB,gBAAgB,EAAE;GAClB,SAAS,EAAE;GACX;AACD,MAAI,UAAU,SAAU,QAAO,EAAE,SAAS,CAAC,mBAAmB,CAAC,EAAE;AACjE,MAAI,UAAU,eAAgB,QAAO,EAAE,cAAc,CAAC,uBAAuB,CAAC,EAAE;AAChF,MAAI,UAAU,iBAAkB,QAAO,EAAE,gBAAgB,CAAC,uBAAuB,CAAC,EAAE;AACpF,MAAI,UAAU,SAAU,QAAO,EAAE,SAAS,CAAC,mBAAmB,CAAC,EAAE;;AAElE,KAAI,OAAO,UAAU,YAAY,UAAU,MAAM;EAChD,MAAM,aAAa;AACnB,MAAI,cAAc,WAAW,CAAE,QAAO,EAAE,SAAS,CAAC,kBAAkB,WAAW,CAAC,EAAE;AAClF,MAAI,UAAU,cAAc,WAAW,SAAS,gBAAgB;GAC/D,MAAM,EAAE,MAAM,QAAQ,GAAG,WAAW;AACpC,UAAO,EAAE,cAAc,CAAC,sBAAsB;IAC7C,MAAM;IACN,GAAG;IACH,CAAC,CAAC,EAAE;;AAEN,MAAI,UAAU,cAAc,WAAW,SAAS,kBAAkB;GACjE,MAAM,EAAE,MAAM,QAAQ,GAAG,WAAW;AACpC,UAAO,EAAE,gBAAgB,CAAC,sBAAsB;IAC/C,MAAM;IACN,GAAG;IACH,CAAC,CAAC,EAAE;;AAEN,MAAI,UAAU,cAAc,WAAW,SAAS,UAAU;GACzD,MAAM,EAAE,MAAM,QAAQ,GAAG,WAAW;AACpC,UAAO,EAAE,SAAS,CAAC,kBAAkB;IACpC,MAAM;IACN,GAAG;IACH,CAAC,CAAC,EAAE;;EAEN,MAAM,EAAE,MAAM,GAAG,SAAS;AAC1B,SAAO,EAAE,cAAc,CAAC,sBAAsB;GAC7C;GACA,GAAG;GACH,CAAC,CAAC,EAAE;;AAEN,QAAO;EACN,SAAS,EAAE;EACX,cAAc,EAAE;EAChB,gBAAgB,EAAE;EAClB,SAAS,EAAE;EACX;;;;;AAKF,MAAM,0BAA0B,aAAa,YAAY;AACxD,QAAO;EACN,SAAS,CAAC,GAAG,YAAY,SAAS,GAAG,QAAQ,WAAW,EAAE,CAAC;EAC3D,cAAc,CAAC,GAAG,YAAY,cAAc,GAAG,QAAQ,gBAAgB,EAAE,CAAC;EAC1E,gBAAgB,CAAC,GAAG,YAAY,gBAAgB,GAAG,QAAQ,kBAAkB,EAAE,CAAC;EAChF,SAAS,CAAC,GAAG,YAAY,SAAS,GAAG,QAAQ,WAAW,EAAE,CAAC;EAC3D;;;;;;;;AAQF,MAAM,wBAAwB,YAAY;CACzC,MAAM,cAAc;EACnB,SAAS,EAAE;EACX,cAAc,EAAE;EAChB,gBAAgB,EAAE;EAClB,SAAS,EAAE;EACX;AACD,KAAI,YAAY,SAAS,YAAY,KAAK,EAAG,QAAO;AACpD,KAAI,MAAM,QAAQ,QAAQ,CAAE,QAAO,QAAQ,QAAQ,KAAK,UAAU;AACjE,SAAO,uBAAuB,KAAK,oBAAoB,MAAM,CAAC;IAC5D,YAAY;AACf,QAAO,uBAAuB,aAAa,oBAAoB,QAAQ,CAAC"}

package/dist/esm/dist/esm/localization/localeResolver.mjs

@@ -0,0 +1,26 @@
+import configuration from "@intlayer/config/built";
+
+//#region dist/esm/localization/localeResolver.mjs
+/**
+* Resolves the most specific locale from a user-provided list,
+* or falls back to the default locale if no match is found.
+*/
+const localeResolver = (selectedLocale, locales = configuration?.internationalization?.locales, defaultLocale = configuration?.internationalization?.defaultLocale) => {
+	const requestedLocales = [selectedLocale].flat();
+	const normalize = (locale) => locale.trim().toLowerCase();
+	try {
+		for (const requested of requestedLocales) {
+			const normalizedRequested = normalize(requested);
+			const exactMatch = locales.find((loc) => normalize(loc) === normalizedRequested);
+			if (exactMatch) return exactMatch;
+			const [requestedLang] = normalizedRequested.split("-");
+			const partialMatch = locales.find((loc) => normalize(loc).split("-")[0] === requestedLang);
+			if (partialMatch) return partialMatch;
+		}
+	} catch (_error) {}
+	return defaultLocale;
+};
+
+//#endregion
+export { localeResolver };
+//# sourceMappingURL=localeResolver.mjs.map

package/dist/esm/dist/esm/localization/localeResolver.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"localeResolver.mjs","names":[],"sources":["../../../localization/localeResolver.mjs"],"sourcesContent":["import configuration from \"@intlayer/config/built\";\n\n//#region src/localization/localeResolver.ts\n/**\n* Resolves the most specific locale from a user-provided list,\n* or falls back to the default locale if no match is found.\n*/\nconst localeResolver = (selectedLocale, locales = configuration?.internationalization?.locales, defaultLocale = configuration?.internationalization?.defaultLocale) => {\n\tconst requestedLocales = [selectedLocale].flat();\n\tconst normalize = (locale) => locale.trim().toLowerCase();\n\ttry {\n\t\tfor (const requested of requestedLocales) {\n\t\t\tconst normalizedRequested = normalize(requested);\n\t\t\tconst exactMatch = locales.find((loc) => normalize(loc) === normalizedRequested);\n\t\t\tif (exactMatch) return exactMatch;\n\t\t\tconst [requestedLang] = normalizedRequested.split(\"-\");\n\t\t\tconst partialMatch = locales.find((loc) => normalize(loc).split(\"-\")[0] === requestedLang);\n\t\t\tif (partialMatch) return partialMatch;\n\t\t}\n\t} catch (_error) {}\n\treturn defaultLocale;\n};\n\n//#endregion\nexport { localeResolver };\n//# sourceMappingURL=localeResolver.mjs.map"],"mappings":";;;;;;;AAOA,MAAM,kBAAkB,gBAAgB,UAAU,eAAe,sBAAsB,SAAS,gBAAgB,eAAe,sBAAsB,kBAAkB;CACtK,MAAM,mBAAmB,CAAC,eAAe,CAAC,MAAM;CAChD,MAAM,aAAa,WAAW,OAAO,MAAM,CAAC,aAAa;AACzD,KAAI;AACH,OAAK,MAAM,aAAa,kBAAkB;GACzC,MAAM,sBAAsB,UAAU,UAAU;GAChD,MAAM,aAAa,QAAQ,MAAM,QAAQ,UAAU,IAAI,KAAK,oBAAoB;AAChF,OAAI,WAAY,QAAO;GACvB,MAAM,CAAC,iBAAiB,oBAAoB,MAAM,IAAI;GACtD,MAAM,eAAe,QAAQ,MAAM,QAAQ,UAAU,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,cAAc;AAC1F,OAAI,aAAc,QAAO;;UAElB,QAAQ;AACjB,QAAO"}

package/dist/esm/dist/esm/utils/getCookie.mjs

@@ -0,0 +1,31 @@
+//#region dist/esm/utils/getCookie.mjs
+/**
+* Retrieves a cookie by name from a cookie string or document.cookie
+* @param name - The name of the cookie to retrieve
+* @param cookieString - Optional cookie string to parse (defaults to document.cookie in browser)
+* @returns The cookie value or undefined if not found
+*/
+const getCookie = (name, cookieString) => {
+	try {
+		const str = cookieString ?? (typeof document !== "undefined" ? document.cookie : "");
+		if (!str) return void 0;
+		const pairs = str.split(";");
+		for (let i = 0; i < pairs.length; i++) {
+			const part = pairs[i].trim();
+			if (!part) continue;
+			const equalIndex = part.indexOf("=");
+			if ((equalIndex >= 0 ? part.substring(0, equalIndex) : part) === name) {
+				const rawValue = equalIndex >= 0 ? part.substring(equalIndex + 1) : "";
+				try {
+					return decodeURIComponent(rawValue);
+				} catch {
+					return rawValue;
+				}
+			}
+		}
+	} catch {}
+};
+
+//#endregion
+export { getCookie };
+//# sourceMappingURL=getCookie.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getCookie.mjs","names":[],"sources":["../../../utils/getCookie.mjs"],"sourcesContent":["//#region src/utils/getCookie.ts\n/**\n* Retrieves a cookie by name from a cookie string or document.cookie\n* @param name - The name of the cookie to retrieve\n* @param cookieString - Optional cookie string to parse (defaults to document.cookie in browser)\n* @returns The cookie value or undefined if not found\n*/\nconst getCookie = (name, cookieString) => {\n\ttry {\n\t\tconst str = cookieString ?? (typeof document !== \"undefined\" ? document.cookie : \"\");\n\t\tif (!str) return void 0;\n\t\tconst pairs = str.split(\";\");\n\t\tfor (let i = 0; i < pairs.length; i++) {\n\t\t\tconst part = pairs[i].trim();\n\t\t\tif (!part) continue;\n\t\t\tconst equalIndex = part.indexOf(\"=\");\n\t\t\tif ((equalIndex >= 0 ? part.substring(0, equalIndex) : part) === name) {\n\t\t\t\tconst rawValue = equalIndex >= 0 ? part.substring(equalIndex + 1) : \"\";\n\t\t\t\ttry {\n\t\t\t\t\treturn decodeURIComponent(rawValue);\n\t\t\t\t} catch {\n\t\t\t\t\treturn rawValue;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t} catch {}\n};\n\n//#endregion\nexport { getCookie };\n//# sourceMappingURL=getCookie.mjs.map"],"mappings":";;;;;;;AAOA,MAAM,aAAa,MAAM,iBAAiB;AACzC,KAAI;EACH,MAAM,MAAM,iBAAiB,OAAO,aAAa,cAAc,SAAS,SAAS;AACjF,MAAI,CAAC,IAAK,QAAO,KAAK;EACtB,MAAM,QAAQ,IAAI,MAAM,IAAI;AAC5B,OAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;GACtC,MAAM,OAAO,MAAM,GAAG,MAAM;AAC5B,OAAI,CAAC,KAAM;GACX,MAAM,aAAa,KAAK,QAAQ,IAAI;AACpC,QAAK,cAAc,IAAI,KAAK,UAAU,GAAG,WAAW,GAAG,UAAU,MAAM;IACtE,MAAM,WAAW,cAAc,IAAI,KAAK,UAAU,aAAa,EAAE,GAAG;AACpE,QAAI;AACH,YAAO,mBAAmB,SAAS;YAC5B;AACP,YAAO;;;;SAIH"}

package/dist/esm/dist/esm/utils/localeStorage.mjs

@@ -0,0 +1,59 @@
+import { getStorageAttributes } from "../getStorageAttributes.mjs";
+import { getCookie } from "./getCookie.mjs";
+import configuration from "@intlayer/config/built";
+
+//#region dist/esm/utils/localeStorage.mjs
+/**
+* Retrieves the locale from various storage mechanisms (cookies, localStorage, sessionStorage, headers).
+* The function checks storage locations in order of priority as defined in the configuration.
+*
+* @returns The locale if found in any storage, or undefined if not found
+*/
+const getLocaleFromStorage = (options) => {
+	const { routing, internationalization } = configuration;
+	const { locales } = internationalization;
+	const { storage } = routing;
+	if (storage === false || options?.isCookieEnabled === false) return void 0;
+	const storageAttributes = getStorageAttributes(storage);
+	const isValidLocale = (value) => {
+		if (!value) return false;
+		return locales.includes(value);
+	};
+	const readCookie = (name) => {
+		try {
+			const fromOption = options?.getCookie?.(name);
+			if (fromOption !== null && fromOption !== void 0) return fromOption;
+		} catch {}
+		return getCookie(name);
+	};
+	for (let i = 0; i < storageAttributes.cookies.length; i++) {
+		const { name } = storageAttributes.cookies[i];
+		const value = readCookie(name);
+		if (isValidLocale(value)) return value;
+	}
+	for (let i = 0; i < storageAttributes.localStorage.length; i++) {
+		const { name } = storageAttributes.localStorage[i];
+		try {
+			const value = options?.getLocaleStorage?.(name);
+			if (isValidLocale(value)) return value;
+		} catch {}
+	}
+	for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {
+		const { name } = storageAttributes.sessionStorage[i];
+		try {
+			const value = options?.getSessionStorage?.(name);
+			if (isValidLocale(value)) return value;
+		} catch {}
+	}
+	for (let i = 0; i < storageAttributes.headers.length; i++) {
+		const { name } = storageAttributes.headers[i];
+		try {
+			const value = options?.getHeader?.(name);
+			if (isValidLocale(value)) return value;
+		} catch {}
+	}
+};
+
+//#endregion
+export { getLocaleFromStorage };
+//# sourceMappingURL=localeStorage.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"localeStorage.mjs","names":[],"sources":["../../../utils/localeStorage.mjs"],"sourcesContent":["import { getStorageAttributes } from \"../getStorageAttributes.mjs\";\nimport { getCookie } from \"./getCookie.mjs\";\nimport configuration from \"@intlayer/config/built\";\n\n//#region src/utils/localeStorage.ts\nconst buildCookieString = (name, value, attributes) => {\n\tconst parts = [`${name}=${encodeURIComponent(value)}`];\n\tif (attributes.path) parts.push(`Path=${attributes.path}`);\n\tif (attributes.domain) parts.push(`Domain=${attributes.domain}`);\n\tif (attributes.expires instanceof Date) parts.push(`Expires=${attributes.expires.toUTCString()}`);\n\tif (attributes.secure) parts.push(\"Secure\");\n\tif (attributes.sameSite) parts.push(`SameSite=${attributes.sameSite}`);\n\treturn parts.join(\"; \");\n};\n/**\n* Retrieves the locale from various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n* The function checks storage locations in order of priority as defined in the configuration.\n*\n* @returns The locale if found in any storage, or undefined if not found\n*/\nconst getLocaleFromStorage = (options) => {\n\tconst { routing, internationalization } = configuration;\n\tconst { locales } = internationalization;\n\tconst { storage } = routing;\n\tif (storage === false || options?.isCookieEnabled === false) return void 0;\n\tconst storageAttributes = getStorageAttributes(storage);\n\tconst isValidLocale = (value) => {\n\t\tif (!value) return false;\n\t\treturn locales.includes(value);\n\t};\n\tconst readCookie = (name) => {\n\t\ttry {\n\t\t\tconst fromOption = options?.getCookie?.(name);\n\t\t\tif (fromOption !== null && fromOption !== void 0) return fromOption;\n\t\t} catch {}\n\t\treturn getCookie(name);\n\t};\n\tfor (let i = 0; i < storageAttributes.cookies.length; i++) {\n\t\tconst { name } = storageAttributes.cookies[i];\n\t\tconst value = readCookie(name);\n\t\tif (isValidLocale(value)) return value;\n\t}\n\tfor (let i = 0; i < storageAttributes.localStorage.length; i++) {\n\t\tconst { name } = storageAttributes.localStorage[i];\n\t\ttry {\n\t\t\tconst value = options?.getLocaleStorage?.(name);\n\t\t\tif (isValidLocale(value)) return value;\n\t\t} catch {}\n\t}\n\tfor (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n\t\tconst { name } = storageAttributes.sessionStorage[i];\n\t\ttry {\n\t\t\tconst value = options?.getSessionStorage?.(name);\n\t\t\tif (isValidLocale(value)) return value;\n\t\t} catch {}\n\t}\n\tfor (let i = 0; i < storageAttributes.headers.length; i++) {\n\t\tconst { name } = storageAttributes.headers[i];\n\t\ttry {\n\t\t\tconst value = options?.getHeader?.(name);\n\t\t\tif (isValidLocale(value)) return value;\n\t\t} catch {}\n\t}\n};\n/**\n* Stores the locale in various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n* The function writes to all configured storage locations according to their attributes.\n* Respects overwrite flags for localStorage and sessionStorage.\n*\n* @param locale - The locale to store\n*/\nconst setLocaleInStorage = (locale, options) => {\n\tif (configuration.routing.storage === false || options?.isCookieEnabled === false) return;\n\tconst storageAttributes = getStorageAttributes(configuration.routing.storage);\n\tfor (let i = 0; i < storageAttributes.cookies.length; i++) {\n\t\tconst { name, attributes } = storageAttributes.cookies[i];\n\t\ttry {\n\t\t\tif (options?.setCookieStore) options?.setCookieStore?.(name, locale, {\n\t\t\t\t...attributes,\n\t\t\t\texpires: attributes.expires instanceof Date ? attributes.expires.getTime() : attributes.expires\n\t\t\t});\n\t\t} catch {\n\t\t\ttry {\n\t\t\t\tif (options?.setCookieString) {\n\t\t\t\t\tconst cookieString = buildCookieString(name, locale, attributes);\n\t\t\t\t\toptions?.setCookieString?.(name, cookieString);\n\t\t\t\t}\n\t\t\t} catch {}\n\t\t}\n\t}\n\tif (options?.setLocaleStorage) for (let i = 0; i < storageAttributes.localStorage.length; i++) {\n\t\tconst { name } = storageAttributes.localStorage[i];\n\t\ttry {\n\t\t\tif (!(options?.overwrite ?? true) && options?.getLocaleStorage) {\n\t\t\t\tif (options?.getLocaleStorage?.(name)) continue;\n\t\t\t}\n\t\t\toptions?.setLocaleStorage?.(name, locale);\n\t\t} catch {}\n\t}\n\tif (options?.setSessionStorage) for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n\t\tconst { name } = storageAttributes.sessionStorage[i];\n\t\ttry {\n\t\t\tif (!(options?.overwrite ?? true) && options?.getSessionStorage) {\n\t\t\t\tif (options?.getSessionStorage?.(name)) continue;\n\t\t\t}\n\t\t\toptions?.setSessionStorage?.(name, locale);\n\t\t} catch {}\n\t}\n\tif (options?.setHeader) for (let i = 0; i < storageAttributes.headers.length; i++) {\n\t\tconst { name } = storageAttributes.headers[i];\n\t\ttry {\n\t\t\toptions?.setHeader?.(name, locale);\n\t\t} catch {}\n\t}\n};\n/**\n* Utility object to get and set the locale in the storage by considering the configuration\n*\n* @property getLocale - Retrieves the locale from various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n* Retrieves the locale from various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n* The function checks storage locations in order of priority as defined in the configuration.\n*\n* @property setLocale - Stores the locale in various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n* The function writes to all configured storage locations according to their attributes.\n* Respects overwrite flags for localStorage and sessionStorage.\n*\n* @returns The locale if found in any storage, or undefined if not found\n*/\nconst LocaleStorage = (options) => ({\n\tgetLocale: () => getLocaleFromStorage(options),\n\tsetLocale: (locale) => setLocaleInStorage(locale, options)\n});\n\n//#endregion\nexport { LocaleStorage, getLocaleFromStorage, setLocaleInStorage };\n//# sourceMappingURL=localeStorage.mjs.map"],"mappings":";;;;;;;;;;;AAoBA,MAAM,wBAAwB,YAAY;CACzC,MAAM,EAAE,SAAS,yBAAyB;CAC1C,MAAM,EAAE,YAAY;CACpB,MAAM,EAAE,YAAY;AACpB,KAAI,YAAY,SAAS,SAAS,oBAAoB,MAAO,QAAO,KAAK;CACzE,MAAM,oBAAoB,qBAAqB,QAAQ;CACvD,MAAM,iBAAiB,UAAU;AAChC,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,QAAQ,SAAS,MAAM;;CAE/B,MAAM,cAAc,SAAS;AAC5B,MAAI;GACH,MAAM,aAAa,SAAS,YAAY,KAAK;AAC7C,OAAI,eAAe,QAAQ,eAAe,KAAK,EAAG,QAAO;UAClD;AACR,SAAO,UAAU,KAAK;;AAEvB,MAAK,IAAI,IAAI,GAAG,IAAI,kBAAkB,QAAQ,QAAQ,KAAK;EAC1D,MAAM,EAAE,SAAS,kBAAkB,QAAQ;EAC3C,MAAM,QAAQ,WAAW,KAAK;AAC9B,MAAI,cAAc,MAAM,CAAE,QAAO;;AAElC,MAAK,IAAI,IAAI,GAAG,IAAI,kBAAkB,aAAa,QAAQ,KAAK;EAC/D,MAAM,EAAE,SAAS,kBAAkB,aAAa;AAChD,MAAI;GACH,MAAM,QAAQ,SAAS,mBAAmB,KAAK;AAC/C,OAAI,cAAc,MAAM,CAAE,QAAO;UAC1B;;AAET,MAAK,IAAI,IAAI,GAAG,IAAI,kBAAkB,eAAe,QAAQ,KAAK;EACjE,MAAM,EAAE,SAAS,kBAAkB,eAAe;AAClD,MAAI;GACH,MAAM,QAAQ,SAAS,oBAAoB,KAAK;AAChD,OAAI,cAAc,MAAM,CAAE,QAAO;UAC1B;;AAET,MAAK,IAAI,IAAI,GAAG,IAAI,kBAAkB,QAAQ,QAAQ,KAAK;EAC1D,MAAM,EAAE,SAAS,kBAAkB,QAAQ;AAC3C,MAAI;GACH,MAAM,QAAQ,SAAS,YAAY,KAAK;AACxC,OAAI,cAAc,MAAM,CAAE,QAAO;UAC1B"}

package/dist/esm/index.mjs

@@ -66,6 +66,7 @@ import { getPrefix } from "./localization/getPrefix.mjs";
 import { getLocalizedUrl } from "./localization/getLocalizedUrl.mjs";
 import { getMultilingualUrls } from "./localization/getMultilingualUrls.mjs";
 import { localeFlatMap, localeMap, localeRecord } from "./localization/localeMapper.mjs";
+import { validatePrefix } from "./localization/validatePrefix.mjs";
 import { isSameKeyPath } from "./utils/isSameKeyPath.mjs";
 
-export { CachedIntl, CachedIntl as Intl, LocaleStorage, buildMaskPlugin, checkIsURLAbsolute, checkMissingLocalesPlugin, compact, condition as cond, conditionPlugin, createCachedIntl, currency, date, deepTransformNode, editDictionaryByKeyPath, enumeration as enu, enumerationPlugin, filePlugin, filterMissingTranslationsOnlyPlugin, filterTranslationsOnlyPlugin, findMatchingCondition, gender, genderPlugin, getBrowserLocale, getCondition, getContent, getContentNodeByKeyPath, getCookie, getDefaultNode, getDictionary, getEmptyNode, getEnumeration, getFilterMissingTranslationsContent, getFilterMissingTranslationsDictionary, getFilterTranslationsOnlyContent, getFilterTranslationsOnlyDictionary, getFilteredLocalesContent, getFilteredLocalesDictionary, getHTMLTextDir, getInsertionValues, getIntlayer, getLocale, getLocaleFromPath, getLocaleFromStorage, getLocaleLang, getLocaleName, getLocalizedContent, getLocalizedUrl, getMarkdownMetadata, getMaskContent, getMissingLocalesContent, getMissingLocalesContentFromDictionary, getMultilingualDictionary, getMultilingualUrls, getNesting, getNodeChildren, getNodeType, getPathWithoutLocale, getPerLocaleDictionary, getPrefix, getReplacedValuesContent, getSplittedContent, getSplittedDictionaryContent, getStorageAttributes, getTranslation, insertion as insert, insertContentInDictionary, insertionPlugin, isSameKeyPath, isValidElement, list, localeDetector, localeFlatMap, localeMap, localeRecord, localeResolver, localeStorageOptions, markdown as md, mergeDictionaries, nesting as nest, nestedPlugin, normalizeDictionaries, normalizeDictionary, number, orderDictionaries, parseYaml, percentage, relativeTime, removeContentNodeByKeyPath, renameContentNodeByKeyPath, setLocaleInStorage, translation as t, translationPlugin, units, updateNodeChildren };
+export { CachedIntl, CachedIntl as Intl, LocaleStorage, buildMaskPlugin, checkIsURLAbsolute, checkMissingLocalesPlugin, compact, condition as cond, conditionPlugin, createCachedIntl, currency, date, deepTransformNode, editDictionaryByKeyPath, enumeration as enu, enumerationPlugin, filePlugin, filterMissingTranslationsOnlyPlugin, filterTranslationsOnlyPlugin, findMatchingCondition, gender, genderPlugin, getBrowserLocale, getCondition, getContent, getContentNodeByKeyPath, getCookie, getDefaultNode, getDictionary, getEmptyNode, getEnumeration, getFilterMissingTranslationsContent, getFilterMissingTranslationsDictionary, getFilterTranslationsOnlyContent, getFilterTranslationsOnlyDictionary, getFilteredLocalesContent, getFilteredLocalesDictionary, getHTMLTextDir, getInsertionValues, getIntlayer, getLocale, getLocaleFromPath, getLocaleFromStorage, getLocaleLang, getLocaleName, getLocalizedContent, getLocalizedUrl, getMarkdownMetadata, getMaskContent, getMissingLocalesContent, getMissingLocalesContentFromDictionary, getMultilingualDictionary, getMultilingualUrls, getNesting, getNodeChildren, getNodeType, getPathWithoutLocale, getPerLocaleDictionary, getPrefix, getReplacedValuesContent, getSplittedContent, getSplittedDictionaryContent, getStorageAttributes, getTranslation, insertion as insert, insertContentInDictionary, insertionPlugin, isSameKeyPath, isValidElement, list, localeDetector, localeFlatMap, localeMap, localeRecord, localeResolver, localeStorageOptions, markdown as md, mergeDictionaries, nesting as nest, nestedPlugin, normalizeDictionaries, normalizeDictionary, number, orderDictionaries, parseYaml, percentage, relativeTime, removeContentNodeByKeyPath, renameContentNodeByKeyPath, setLocaleInStorage, translation as t, translationPlugin, units, updateNodeChildren, validatePrefix };

package/dist/esm/localization/getLocale.mjs

@@ -1,7 +1,8 @@
+import { localeResolver } from "../dist/esm/localization/localeResolver.mjs";
+import { getLocaleFromStorage } from "../dist/esm/utils/localeStorage.mjs";
 import { getPreferredLanguages } from "./localeDetector.mjs";
 import { DefaultValues } from "@intlayer/config/client";
 import configuration from "@intlayer/config/built";
-import { getLocaleFromStorage, localeResolver } from "@intlayer/core";
 
 //#region src/localization/getLocale.ts
 const getLocale = async (ctx = {}) => {

package/dist/esm/localization/getLocale.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"getLocale.mjs","names":[],"sources":["../../../src/localization/getLocale.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport { DefaultValues } from '@intlayer/config/client';\nimport { getLocaleFromStorage, localeResolver } from '@intlayer/core';\nimport type { Locale } from '@intlayer/types';\nimport { getPreferredLanguages } from './localeDetector';\n\nexport type RequestContext = {\n  getHeader?: (name: string) => string | null | undefined;\n  getCookie?: (name: string) => string | null | undefined;\n};\n\nexport const getLocale = async (ctx: RequestContext = {}): Promise<Locale> => {\n  const defaultLocale =\n    configuration?.internationalization?.defaultLocale ??\n    DefaultValues.Internationalization.DEFAULT_LOCALE;\n  const availableLocales =\n    configuration?.internationalization?.locales ??\n    DefaultValues.Internationalization.LOCALES;\n\n  // Try locale from storage (cookie or header)\n  const storedLocale = getLocaleFromStorage({\n    getCookie: ctx.getCookie,\n    getHeader: ctx.getHeader,\n  });\n\n  if (storedLocale) {\n    return storedLocale;\n  }\n\n  // Fallback to Accept-Language negotiation\n  const acceptLanguageHeader = ctx.getHeader?.('accept-language');\n\n  if (!acceptLanguageHeader) {\n    return defaultLocale;\n  }\n\n  const preferredLocaleStrings = getPreferredLanguages(\n    acceptLanguageHeader,\n    availableLocales\n  );\n\n  const userFallbackLocale = localeResolver(\n    preferredLocaleStrings,\n    availableLocales,\n    defaultLocale\n  );\n\n  if (userFallbackLocale) {\n    return userFallbackLocale;\n  }\n\n  // Default locale\n  return defaultLocale;\n};\n"],"mappings":";;;;;;AAWA,MAAa,YAAY,OAAO,MAAsB,EAAE,KAAsB;CAC5E,MAAM,gBACJ,eAAe,sBAAsB,iBACrC,cAAc,qBAAqB;CACrC,MAAM,mBACJ,eAAe,sBAAsB,WACrC,cAAc,qBAAqB;CAGrC,MAAM,eAAe,qBAAqB;EACxC,WAAW,IAAI;EACf,WAAW,IAAI;EAChB,CAAC;AAEF,KAAI,aACF,QAAO;CAIT,MAAM,uBAAuB,IAAI,YAAY,kBAAkB;AAE/D,KAAI,CAAC,qBACH,QAAO;CAQT,MAAM,qBAAqB,eALI,sBAC7B,sBACA,iBACD,EAIC,kBACA,cACD;AAED,KAAI,mBACF,QAAO;AAIT,QAAO"}
+{"version":3,"file":"getLocale.mjs","names":[],"sources":["../../../src/localization/getLocale.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport { DefaultValues } from '@intlayer/config/client';\nimport { getLocaleFromStorage, localeResolver } from '@intlayer/core';\nimport type { Locale } from '@intlayer/types';\nimport { getPreferredLanguages } from './localeDetector';\n\nexport type RequestContext = {\n  getHeader?: (name: string) => string | null | undefined;\n  getCookie?: (name: string) => string | null | undefined;\n};\n\nexport const getLocale = async (ctx: RequestContext = {}): Promise<Locale> => {\n  const defaultLocale =\n    configuration?.internationalization?.defaultLocale ??\n    DefaultValues.Internationalization.DEFAULT_LOCALE;\n  const availableLocales =\n    configuration?.internationalization?.locales ??\n    DefaultValues.Internationalization.LOCALES;\n\n  // Try locale from storage (cookie or header)\n  const storedLocale = getLocaleFromStorage({\n    getCookie: ctx.getCookie,\n    getHeader: ctx.getHeader,\n  });\n\n  if (storedLocale) {\n    return storedLocale;\n  }\n\n  // Fallback to Accept-Language negotiation\n  const acceptLanguageHeader = ctx.getHeader?.('accept-language');\n\n  if (!acceptLanguageHeader) {\n    return defaultLocale;\n  }\n\n  const preferredLocaleStrings = getPreferredLanguages(\n    acceptLanguageHeader,\n    availableLocales\n  );\n\n  const userFallbackLocale = localeResolver(\n    preferredLocaleStrings,\n    availableLocales,\n    defaultLocale\n  );\n\n  if (userFallbackLocale) {\n    return userFallbackLocale;\n  }\n\n  // Default locale\n  return defaultLocale;\n};\n"],"mappings":";;;;;;;AAWA,MAAa,YAAY,OAAO,MAAsB,EAAE,KAAsB;CAC5E,MAAM,gBACJ,eAAe,sBAAsB,iBACrC,cAAc,qBAAqB;CACrC,MAAM,mBACJ,eAAe,sBAAsB,WACrC,cAAc,qBAAqB;CAGrC,MAAM,eAAe,qBAAqB;EACxC,WAAW,IAAI;EACf,WAAW,IAAI;EAChB,CAAC;AAEF,KAAI,aACF,QAAO;CAIT,MAAM,uBAAuB,IAAI,YAAY,kBAAkB;AAE/D,KAAI,CAAC,qBACH,QAAO;CAQT,MAAM,qBAAqB,eALI,sBAC7B,sBACA,iBACD,EAIC,kBACA,cACD;AAED,KAAI,mBACF,QAAO;AAIT,QAAO"}

package/dist/esm/localization/getLocalizedUrl.mjs

@@ -42,7 +42,12 @@ import configuration from "@intlayer/config/built";
 * @returns The localized URL for the current locale.
 */
 const getLocalizedUrl = (url, currentLocale, options = {}) => {
-	const { locales = configuration?.internationalization?.locales ?? DefaultValues.Internationalization.LOCALES, defaultLocale = configuration?.internationalization?.defaultLocale ?? DefaultValues.Internationalization.DEFAULT_LOCALE, mode = configuration?.routing?.mode ?? DefaultValues.Routing.ROUTING_MODE } = options;
+	const { defaultLocale, mode, locales } = {
+		defaultLocale: configuration?.internationalization?.defaultLocale ?? DefaultValues.Internationalization.DEFAULT_LOCALE,
+		mode: configuration?.routing?.mode ?? DefaultValues.Routing.ROUTING_MODE,
+		locales: configuration?.internationalization?.locales ?? DefaultValues.Internationalization.LOCALES,
+		...options
+	};
 	const urlWithoutLocale = getPathWithoutLocale(url, locales);
 	if (mode === "no-prefix") return urlWithoutLocale;
 	const isAbsoluteUrl = checkIsURLAbsolute(urlWithoutLocale);

package/dist/esm/localization/getLocalizedUrl.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"getLocalizedUrl.mjs","names":[],"sources":["../../../src/localization/getLocalizedUrl.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport { DefaultValues } from '@intlayer/config/client';\nimport type { LocalesValues } from '@intlayer/types';\nimport { checkIsURLAbsolute } from '../utils/checkIsURLAbsolute';\nimport { getPathWithoutLocale } from './getPathWithoutLocale';\nimport { getPrefix } from './getPrefix';\n\n/**\n * Generate URL by prefixing the given URL with the referenced locale or adding search parameters\n * based on the routing mode. Handles both absolute and relative URLs appropriately.\n *\n * This function gets the locales, default locale, and routing mode from the configuration if not provided.\n *\n * Example:\n *\n * ```ts\n *  // prefix-no-default mode\n *  getLocalizedUrl('/about', 'fr', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'prefix-no-default' });\n *  // Returns '/fr/about' for the French locale\n *  // Returns '/about' for the English locale (default)\n *\n *  // prefix-all mode\n *  getLocalizedUrl('/about', 'en', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'prefix-all' });\n *  // Returns '/en/about' for the English locale\n *  // Returns '/fr/about' for the French locale\n *\n *  // search-params mode\n *  getLocalizedUrl('/about', 'fr', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'search-params' });\n *  // Returns '/about?locale=fr' for the French locale\n *\n *  // no-prefix mode\n *  getLocalizedUrl('/about', 'fr', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'no-prefix' });\n *  // Returns '/about' for any locale\n * ```\n *\n * @param url - The original URL string to be processed.\n * @param currentLocale - The current locale.\n * @param options - Configuration options\n * @param options.locales - Optional array of supported locales. Defaults to configured locales.\n * @param options.defaultLocale - The default locale. Defaults to configured default locale.\n * @param options.mode - URL routing mode for locale handling. Defaults to configured mode.\n * @returns The localized URL for the current locale.\n */\nexport const getLocalizedUrl = (\n  url: string,\n  currentLocale: LocalesValues,\n  options: {\n    locales?: LocalesValues[];\n    defaultLocale?: LocalesValues;\n    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';\n  } = {}\n): string => {\n  const {\n    locales = configuration?.internationalization?.locales ??\n      DefaultValues.Internationalization.LOCALES,\n    defaultLocale = configuration?.internationalization?.defaultLocale ??\n      DefaultValues.Internationalization.DEFAULT_LOCALE,\n    mode = configuration?.routing?.mode ?? DefaultValues.Routing.ROUTING_MODE,\n  } = options;\n  // Remove any existing locale segment from the URL\n  const urlWithoutLocale = getPathWithoutLocale(url, locales);\n\n  if (mode === 'no-prefix') {\n    // No locale prefixing\n    return urlWithoutLocale;\n  }\n\n  // Determine if the original URL is absolute (includes protocol)\n  const isAbsoluteUrl = checkIsURLAbsolute(urlWithoutLocale);\n\n  // Initialize a URL object if the URL is absolute\n  // For relative URLs, use a dummy base to leverage the URL API\n  const parsedUrl = isAbsoluteUrl\n    ? new URL(urlWithoutLocale)\n    : new URL(urlWithoutLocale, 'http://example.com');\n\n  // Prepare the base URL (protocol + host) if it's absolute\n  const baseUrl = isAbsoluteUrl\n    ? `${parsedUrl.protocol}//${parsedUrl.host}`\n    : '';\n\n  if (mode === 'search-params') {\n    // Use search parameters for locale handling\n    const searchParams = new URLSearchParams(parsedUrl.search);\n    searchParams.set('locale', currentLocale.toString());\n\n    const queryString = searchParams.toString();\n    const pathWithQuery = queryString\n      ? `${parsedUrl.pathname}?${queryString}`\n      : parsedUrl.pathname;\n\n    if (isAbsoluteUrl) {\n      return `${baseUrl}${pathWithQuery}${parsedUrl.hash}`;\n    }\n\n    return `${pathWithQuery}${parsedUrl.hash}`;\n  }\n\n  const { prefix } = getPrefix(currentLocale, {\n    defaultLocale,\n    mode,\n  });\n\n  // Construct the new pathname with or without the locale prefix\n  let localizedPath = `/${prefix}${parsedUrl.pathname}`;\n\n  // Remove double slashes\n  localizedPath = localizedPath.replaceAll(/\\/+/g, '/');\n\n  // Remove trailing slash for non-root paths\n  if (localizedPath.length > 1 && localizedPath.endsWith('/')) {\n    localizedPath = localizedPath.slice(0, -1);\n  }\n\n  // Combine with the base URL if the original URL was absolute\n  if (isAbsoluteUrl) {\n    return `${baseUrl}${localizedPath}${parsedUrl.search}${parsedUrl.hash}`;\n  }\n\n  return `${localizedPath}${parsedUrl.search}${parsedUrl.hash}`;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CA,MAAa,mBACX,KACA,eACA,UAII,EAAE,KACK;CACX,MAAM,EACJ,UAAU,eAAe,sBAAsB,WAC7C,cAAc,qBAAqB,SACrC,gBAAgB,eAAe,sBAAsB,iBACnD,cAAc,qBAAqB,gBACrC,OAAO,eAAe,SAAS,QAAQ,cAAc,QAAQ,iBAC3D;CAEJ,MAAM,mBAAmB,qBAAqB,KAAK,QAAQ;AAE3D,KAAI,SAAS,YAEX,QAAO;CAIT,MAAM,gBAAgB,mBAAmB,iBAAiB;CAI1D,MAAM,YAAY,gBACd,IAAI,IAAI,iBAAiB,GACzB,IAAI,IAAI,kBAAkB,qBAAqB;CAGnD,MAAM,UAAU,gBACZ,GAAG,UAAU,SAAS,IAAI,UAAU,SACpC;AAEJ,KAAI,SAAS,iBAAiB;EAE5B,MAAM,eAAe,IAAI,gBAAgB,UAAU,OAAO;AAC1D,eAAa,IAAI,UAAU,cAAc,UAAU,CAAC;EAEpD,MAAM,cAAc,aAAa,UAAU;EAC3C,MAAM,gBAAgB,cAClB,GAAG,UAAU,SAAS,GAAG,gBACzB,UAAU;AAEd,MAAI,cACF,QAAO,GAAG,UAAU,gBAAgB,UAAU;AAGhD,SAAO,GAAG,gBAAgB,UAAU;;CAGtC,MAAM,EAAE,WAAW,UAAU,eAAe;EAC1C;EACA;EACD,CAAC;CAGF,IAAI,gBAAgB,IAAI,SAAS,UAAU;AAG3C,iBAAgB,cAAc,WAAW,QAAQ,IAAI;AAGrD,KAAI,cAAc,SAAS,KAAK,cAAc,SAAS,IAAI,CACzD,iBAAgB,cAAc,MAAM,GAAG,GAAG;AAI5C,KAAI,cACF,QAAO,GAAG,UAAU,gBAAgB,UAAU,SAAS,UAAU;AAGnE,QAAO,GAAG,gBAAgB,UAAU,SAAS,UAAU"}
+{"version":3,"file":"getLocalizedUrl.mjs","names":[],"sources":["../../../src/localization/getLocalizedUrl.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport { DefaultValues } from '@intlayer/config/client';\nimport type { LocalesValues } from '@intlayer/types';\nimport { checkIsURLAbsolute } from '../utils/checkIsURLAbsolute';\nimport { getPathWithoutLocale } from './getPathWithoutLocale';\nimport { getPrefix } from './getPrefix';\n\n/**\n * Generate URL by prefixing the given URL with the referenced locale or adding search parameters\n * based on the routing mode. Handles both absolute and relative URLs appropriately.\n *\n * This function gets the locales, default locale, and routing mode from the configuration if not provided.\n *\n * Example:\n *\n * ```ts\n *  // prefix-no-default mode\n *  getLocalizedUrl('/about', 'fr', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'prefix-no-default' });\n *  // Returns '/fr/about' for the French locale\n *  // Returns '/about' for the English locale (default)\n *\n *  // prefix-all mode\n *  getLocalizedUrl('/about', 'en', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'prefix-all' });\n *  // Returns '/en/about' for the English locale\n *  // Returns '/fr/about' for the French locale\n *\n *  // search-params mode\n *  getLocalizedUrl('/about', 'fr', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'search-params' });\n *  // Returns '/about?locale=fr' for the French locale\n *\n *  // no-prefix mode\n *  getLocalizedUrl('/about', 'fr', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'no-prefix' });\n *  // Returns '/about' for any locale\n * ```\n *\n * @param url - The original URL string to be processed.\n * @param currentLocale - The current locale.\n * @param options - Configuration options\n * @param options.locales - Optional array of supported locales. Defaults to configured locales.\n * @param options.defaultLocale - The default locale. Defaults to configured default locale.\n * @param options.mode - URL routing mode for locale handling. Defaults to configured mode.\n * @returns The localized URL for the current locale.\n */\nexport const getLocalizedUrl = (\n  url: string,\n  currentLocale: LocalesValues,\n  options: {\n    locales?: LocalesValues[];\n    defaultLocale?: LocalesValues;\n    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';\n  } = {}\n): string => {\n  const { defaultLocale, mode, locales } = {\n    defaultLocale:\n      configuration?.internationalization?.defaultLocale ??\n      DefaultValues.Internationalization.DEFAULT_LOCALE,\n    mode: configuration?.routing?.mode ?? DefaultValues.Routing.ROUTING_MODE,\n    locales:\n      configuration?.internationalization?.locales ??\n      DefaultValues.Internationalization.LOCALES,\n    ...options,\n  };\n\n  // Remove any existing locale segment from the URL\n  const urlWithoutLocale = getPathWithoutLocale(url, locales);\n\n  if (mode === 'no-prefix') {\n    // No locale prefixing\n    return urlWithoutLocale;\n  }\n\n  // Determine if the original URL is absolute (includes protocol)\n  const isAbsoluteUrl = checkIsURLAbsolute(urlWithoutLocale);\n\n  // Initialize a URL object if the URL is absolute\n  // For relative URLs, use a dummy base to leverage the URL API\n  const parsedUrl = isAbsoluteUrl\n    ? new URL(urlWithoutLocale)\n    : new URL(urlWithoutLocale, 'http://example.com');\n\n  // Prepare the base URL (protocol + host) if it's absolute\n  const baseUrl = isAbsoluteUrl\n    ? `${parsedUrl.protocol}//${parsedUrl.host}`\n    : '';\n\n  if (mode === 'search-params') {\n    // Use search parameters for locale handling\n    const searchParams = new URLSearchParams(parsedUrl.search);\n    searchParams.set('locale', currentLocale.toString());\n\n    const queryString = searchParams.toString();\n    const pathWithQuery = queryString\n      ? `${parsedUrl.pathname}?${queryString}`\n      : parsedUrl.pathname;\n\n    if (isAbsoluteUrl) {\n      return `${baseUrl}${pathWithQuery}${parsedUrl.hash}`;\n    }\n\n    return `${pathWithQuery}${parsedUrl.hash}`;\n  }\n\n  const { prefix } = getPrefix(currentLocale, {\n    defaultLocale,\n    mode,\n  });\n\n  // Construct the new pathname with or without the locale prefix\n  let localizedPath = `/${prefix}${parsedUrl.pathname}`;\n\n  // Remove double slashes\n  localizedPath = localizedPath.replaceAll(/\\/+/g, '/');\n\n  // Remove trailing slash for non-root paths\n  if (localizedPath.length > 1 && localizedPath.endsWith('/')) {\n    localizedPath = localizedPath.slice(0, -1);\n  }\n\n  // Combine with the base URL if the original URL was absolute\n  if (isAbsoluteUrl) {\n    return `${baseUrl}${localizedPath}${parsedUrl.search}${parsedUrl.hash}`;\n  }\n\n  return `${localizedPath}${parsedUrl.search}${parsedUrl.hash}`;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CA,MAAa,mBACX,KACA,eACA,UAII,EAAE,KACK;CACX,MAAM,EAAE,eAAe,MAAM,YAAY;EACvC,eACE,eAAe,sBAAsB,iBACrC,cAAc,qBAAqB;EACrC,MAAM,eAAe,SAAS,QAAQ,cAAc,QAAQ;EAC5D,SACE,eAAe,sBAAsB,WACrC,cAAc,qBAAqB;EACrC,GAAG;EACJ;CAGD,MAAM,mBAAmB,qBAAqB,KAAK,QAAQ;AAE3D,KAAI,SAAS,YAEX,QAAO;CAIT,MAAM,gBAAgB,mBAAmB,iBAAiB;CAI1D,MAAM,YAAY,gBACd,IAAI,IAAI,iBAAiB,GACzB,IAAI,IAAI,kBAAkB,qBAAqB;CAGnD,MAAM,UAAU,gBACZ,GAAG,UAAU,SAAS,IAAI,UAAU,SACpC;AAEJ,KAAI,SAAS,iBAAiB;EAE5B,MAAM,eAAe,IAAI,gBAAgB,UAAU,OAAO;AAC1D,eAAa,IAAI,UAAU,cAAc,UAAU,CAAC;EAEpD,MAAM,cAAc,aAAa,UAAU;EAC3C,MAAM,gBAAgB,cAClB,GAAG,UAAU,SAAS,GAAG,gBACzB,UAAU;AAEd,MAAI,cACF,QAAO,GAAG,UAAU,gBAAgB,UAAU;AAGhD,SAAO,GAAG,gBAAgB,UAAU;;CAGtC,MAAM,EAAE,WAAW,UAAU,eAAe;EAC1C;EACA;EACD,CAAC;CAGF,IAAI,gBAAgB,IAAI,SAAS,UAAU;AAG3C,iBAAgB,cAAc,WAAW,QAAQ,IAAI;AAGrD,KAAI,cAAc,SAAS,KAAK,cAAc,SAAS,IAAI,CACzD,iBAAgB,cAAc,MAAM,GAAG,GAAG;AAI5C,KAAI,cACF,QAAO,GAAG,UAAU,gBAAgB,UAAU,SAAS,UAAU;AAGnE,QAAO,GAAG,gBAAgB,UAAU,SAAS,UAAU"}

package/dist/esm/localization/getMultilingualUrls.mjs

@@ -1,4 +1,5 @@
 import { getLocalizedUrl } from "./getLocalizedUrl.mjs";
+import { DefaultValues } from "@intlayer/config/client";
 import configuration from "@intlayer/config/built";
 
 //#region src/localization/getMultilingualUrls.ts
@@ -37,7 +38,12 @@ import configuration from "@intlayer/config/built";
 * @returns An object mapping each locale to its corresponding multilingual URL.
 */
 const getMultilingualUrls = (url, options = {}) => {
-	const { locales = configuration?.internationalization?.locales, defaultLocale = configuration?.internationalization?.defaultLocale, mode = configuration?.routing?.mode } = options;
+	const { defaultLocale, mode, locales } = {
+		defaultLocale: configuration?.internationalization?.defaultLocale ?? DefaultValues.Internationalization.DEFAULT_LOCALE,
+		mode: configuration?.routing?.mode ?? DefaultValues.Routing.ROUTING_MODE,
+		locales: configuration?.internationalization?.locales ?? DefaultValues.Internationalization.LOCALES,
+		...options
+	};
 	return (locales ?? []).reduce((acc, locale) => {
 		acc[locale] = getLocalizedUrl(url, locale, {
 			locales,

package/dist/esm/localization/getMultilingualUrls.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"getMultilingualUrls.mjs","names":[],"sources":["../../../src/localization/getMultilingualUrls.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { LocalesValues, StrictModeLocaleMap } from '@intlayer/types';\nimport { getLocalizedUrl } from './getLocalizedUrl';\n\n/**\n * Generates multilingual URLs by prefixing the given URL with each supported locale\n * or adding search parameters based on the routing mode.\n * Handles both absolute and relative URLs appropriately.\n *\n * This function gets the locales, default locale, and routing mode from the configuration if not provided.\n *\n * Example:\n *\n * ```ts\n *  // prefix-no-default mode\n *  getMultilingualUrls('/dashboard', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'prefix-no-default' })\n *     // Returns { en: '/dashboard', fr: '/fr/dashboard' }\n *\n *  // prefix-all mode\n *  getMultilingualUrls('/dashboard', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'prefix-all' })\n *     // Returns { en: '/en/dashboard', fr: '/fr/dashboard' }\n *\n *  // search-params mode\n *  getMultilingualUrls('/dashboard', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'search-params' })\n *     // Returns { en: '/dashboard?locale=en', fr: '/dashboard?locale=fr' }\n *\n *  // no-prefix mode\n *  getMultilingualUrls('/dashboard', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'no-prefix' })\n *     // Returns { en: '/dashboard', fr: '/dashboard' }\n * ```\n *\n * @param url - The original URL string to be processed.\n * @param options - Configuration options\n * @param options.locales - Optional array of supported locales. Defaults to configured locales.\n * @param options.defaultLocale - The default locale. Defaults to configured default locale.\n * @param options.mode - URL routing mode for locale handling. Defaults to configured mode.\n * @returns An object mapping each locale to its corresponding multilingual URL.\n */\nexport const getMultilingualUrls = (\n  url: string,\n  options: {\n    locales?: LocalesValues[];\n    defaultLocale?: LocalesValues;\n    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';\n  } = {}\n): StrictModeLocaleMap<string> => {\n  const {\n    locales = configuration?.internationalization?.locales,\n    defaultLocale = configuration?.internationalization?.defaultLocale,\n    mode = configuration?.routing?.mode,\n  } = options;\n\n  // Generate multilingual URLs by iterating over each locale and calling getLocalizedUrl\n  const multilingualUrls = (locales ?? []).reduce<StrictModeLocaleMap<string>>(\n    (acc, locale) => {\n      // Get the localized URL for this locale\n      const localizedUrl = getLocalizedUrl(url, locale, {\n        locales,\n        defaultLocale,\n        mode,\n      });\n\n      // Assign the constructed URL to the corresponding locale key\n      acc[locale as unknown as keyof typeof acc] = localizedUrl;\n\n      return acc;\n    },\n    {} as StrictModeLocaleMap<string>\n  );\n\n  return multilingualUrls;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,MAAa,uBACX,KACA,UAII,EAAE,KAC0B;CAChC,MAAM,EACJ,UAAU,eAAe,sBAAsB,SAC/C,gBAAgB,eAAe,sBAAsB,eACrD,OAAO,eAAe,SAAS,SAC7B;AAoBJ,SAjB0B,WAAW,EAAE,EAAE,QACtC,KAAK,WAAW;AASf,MAAI,UAPiB,gBAAgB,KAAK,QAAQ;GAChD;GACA;GACA;GACD,CAAC;AAKF,SAAO;IAET,EAAE,CACH"}
+{"version":3,"file":"getMultilingualUrls.mjs","names":[],"sources":["../../../src/localization/getMultilingualUrls.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport { DefaultValues } from '@intlayer/config/client';\nimport type { LocalesValues, StrictModeLocaleMap } from '@intlayer/types';\nimport { getLocalizedUrl } from './getLocalizedUrl';\n\n/**\n * Generates multilingual URLs by prefixing the given URL with each supported locale\n * or adding search parameters based on the routing mode.\n * Handles both absolute and relative URLs appropriately.\n *\n * This function gets the locales, default locale, and routing mode from the configuration if not provided.\n *\n * Example:\n *\n * ```ts\n *  // prefix-no-default mode\n *  getMultilingualUrls('/dashboard', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'prefix-no-default' })\n *     // Returns { en: '/dashboard', fr: '/fr/dashboard' }\n *\n *  // prefix-all mode\n *  getMultilingualUrls('/dashboard', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'prefix-all' })\n *     // Returns { en: '/en/dashboard', fr: '/fr/dashboard' }\n *\n *  // search-params mode\n *  getMultilingualUrls('/dashboard', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'search-params' })\n *     // Returns { en: '/dashboard?locale=en', fr: '/dashboard?locale=fr' }\n *\n *  // no-prefix mode\n *  getMultilingualUrls('/dashboard', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'no-prefix' })\n *     // Returns { en: '/dashboard', fr: '/dashboard' }\n * ```\n *\n * @param url - The original URL string to be processed.\n * @param options - Configuration options\n * @param options.locales - Optional array of supported locales. Defaults to configured locales.\n * @param options.defaultLocale - The default locale. Defaults to configured default locale.\n * @param options.mode - URL routing mode for locale handling. Defaults to configured mode.\n * @returns An object mapping each locale to its corresponding multilingual URL.\n */\nexport const getMultilingualUrls = (\n  url: string,\n  options: {\n    locales?: LocalesValues[];\n    defaultLocale?: LocalesValues;\n    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';\n  } = {}\n): StrictModeLocaleMap<string> => {\n  const { defaultLocale, mode, locales } = {\n    defaultLocale:\n      configuration?.internationalization?.defaultLocale ??\n      DefaultValues.Internationalization.DEFAULT_LOCALE,\n    mode: configuration?.routing?.mode ?? DefaultValues.Routing.ROUTING_MODE,\n    locales:\n      configuration?.internationalization?.locales ??\n      DefaultValues.Internationalization.LOCALES,\n    ...options,\n  };\n\n  // Generate multilingual URLs by iterating over each locale and calling getLocalizedUrl\n  const multilingualUrls = (locales ?? []).reduce<StrictModeLocaleMap<string>>(\n    (acc, locale) => {\n      // Get the localized URL for this locale\n      const localizedUrl = getLocalizedUrl(url, locale, {\n        locales,\n        defaultLocale,\n        mode,\n      });\n\n      // Assign the constructed URL to the corresponding locale key\n      acc[locale as unknown as keyof typeof acc] = localizedUrl;\n\n      return acc;\n    },\n    {} as StrictModeLocaleMap<string>\n  );\n\n  return multilingualUrls;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,MAAa,uBACX,KACA,UAII,EAAE,KAC0B;CAChC,MAAM,EAAE,eAAe,MAAM,YAAY;EACvC,eACE,eAAe,sBAAsB,iBACrC,cAAc,qBAAqB;EACrC,MAAM,eAAe,SAAS,QAAQ,cAAc,QAAQ;EAC5D,SACE,eAAe,sBAAsB,WACrC,cAAc,qBAAqB;EACrC,GAAG;EACJ;AAoBD,SAjB0B,WAAW,EAAE,EAAE,QACtC,KAAK,WAAW;AASf,MAAI,UAPiB,gBAAgB,KAAK,QAAQ;GAChD;GACA;GACA;GACD,CAAC;AAKF,SAAO;IAET,EAAE,CACH"}

package/dist/esm/localization/getPrefix.mjs

@@ -1,3 +1,4 @@
+import { DefaultValues } from "@intlayer/config/client";
 import configuration from "@intlayer/config/built";
 
 //#region src/localization/getPrefix.ts
@@ -35,8 +36,13 @@ import configuration from "@intlayer/config/built";
 * @returns An object containing pathPrefix, prefix, and localePrefix for the given locale.
 */
 const getPrefix = (locale, options = {}) => {
-	const { defaultLocale = configuration?.internationalization?.defaultLocale, mode = configuration?.routing?.mode } = options;
-	if (!locale) return {
+	const { defaultLocale, mode, locales } = {
+		defaultLocale: configuration?.internationalization?.defaultLocale ?? DefaultValues.Internationalization.DEFAULT_LOCALE,
+		mode: configuration?.routing?.mode ?? DefaultValues.Routing.ROUTING_MODE,
+		locales: configuration?.internationalization?.locales ?? DefaultValues.Internationalization.LOCALES,
+		...options
+	};
+	if (!locale || !locales.includes(locale)) return {
 		prefix: "",
 		localePrefix: void 0
 	};

package/dist/esm/localization/getPrefix.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"getPrefix.mjs","names":[],"sources":["../../../src/localization/getPrefix.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { Locale, LocalesValues } from '@intlayer/types';\n\nexport type GetPrefixOptions = {\n  defaultLocale?: LocalesValues;\n  mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';\n};\n\nexport type GetPrefixResult = {\n  /**\n   * The complete base URL path with leading and trailing slashes.\n   *\n   * @example\n   * // https://example.com/fr/about -> '/fr'\n   * // https://example.com/about -> ''\n   */\n  prefix: string;\n  /**\n   * The locale identifier without slashes.\n   *\n   * @example\n   * // https://example.com/fr/about -> 'fr'\n   * // https://example.com/about -> undefined\n   */\n  localePrefix: Locale | undefined;\n};\n\n/**\n * Determines the URL prefix for a given locale based on the routing mode configuration.\n *\n * Example:\n *\n * ```ts\n *  // prefix-no-default mode with default locale\n *  getPrefix('en', { defaultLocale: 'en', mode: 'prefix-no-default' })\n *     // Returns { prefix: '', localePrefix: undefined }\n *\n *  // prefix-no-default mode with non-default locale\n *  getPrefix('fr', { defaultLocale: 'en', mode: 'prefix-no-default' })\n *     // Returns { prefix: '/fr', localePrefix: 'fr' }\n *\n *  // prefix-all mode\n *  getPrefix('en', { defaultLocale: 'en', mode: 'prefix-all' })\n *     // Returns { prefix: '/en', localePrefix: locale }\n *\n *  // search-params mode\n *  getPrefix('en', { defaultLocale: 'en', mode: 'search-params' })\n *     // Returns { prefix: '', localePrefix: undefined }\n *\n *  // no-prefix mode\n *  getPrefix('en', { defaultLocale: 'en', mode: 'no-prefix' })\n *     // Returns { prefix: '', localePrefix: undefined }\n * ```\n *\n * @param locale - The locale to check for prefix. If not provided, uses configured default locale.\n * @param options - Configuration options\n * @param options.defaultLocale - The default locale. Defaults to configured default locale.\n * @param options.mode - URL routing mode for locale handling. Defaults to configured mode.\n * @returns An object containing pathPrefix, prefix, and localePrefix for the given locale.\n */\nexport const getPrefix = (\n  locale: LocalesValues,\n  options: {\n    defaultLocale?: LocalesValues;\n    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';\n  } = {}\n): GetPrefixResult => {\n  const {\n    defaultLocale = configuration?.internationalization?.defaultLocale,\n    mode = configuration?.routing?.mode,\n  } = options;\n\n  if (!locale) {\n    return {\n      prefix: '',\n      localePrefix: undefined,\n    };\n  }\n\n  // Handle prefix-based modes (prefix-all or prefix-no-default)\n  const shouldPrefix =\n    mode === 'prefix-all' ||\n    (mode === 'prefix-no-default' && defaultLocale !== locale);\n\n  if (shouldPrefix) {\n    return {\n      prefix: `${locale}/`,\n      localePrefix: locale as Locale,\n    };\n  }\n\n  return {\n    prefix: '',\n    localePrefix: undefined,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4DA,MAAa,aACX,QACA,UAGI,EAAE,KACc;CACpB,MAAM,EACJ,gBAAgB,eAAe,sBAAsB,eACrD,OAAO,eAAe,SAAS,SAC7B;AAEJ,KAAI,CAAC,OACH,QAAO;EACL,QAAQ;EACR,cAAc;EACf;AAQH,KAHE,SAAS,gBACR,SAAS,uBAAuB,kBAAkB,OAGnD,QAAO;EACL,QAAQ,GAAG,OAAO;EAClB,cAAc;EACf;AAGH,QAAO;EACL,QAAQ;EACR,cAAc;EACf"}
+{"version":3,"file":"getPrefix.mjs","names":[],"sources":["../../../src/localization/getPrefix.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport { DefaultValues } from '@intlayer/config/client';\nimport type { Locale, LocalesValues } from '@intlayer/types';\n\nexport type GetPrefixOptions = {\n  defaultLocale?: LocalesValues;\n  mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';\n};\n\nexport type GetPrefixResult = {\n  /**\n   * The complete base URL path with leading and trailing slashes.\n   *\n   * @example\n   * // https://example.com/fr/about -> '/fr'\n   * // https://example.com/about -> ''\n   */\n  prefix: string;\n  /**\n   * The locale identifier without slashes.\n   *\n   * @example\n   * // https://example.com/fr/about -> 'fr'\n   * // https://example.com/about -> undefined\n   */\n  localePrefix: Locale | undefined;\n};\n\n/**\n * Determines the URL prefix for a given locale based on the routing mode configuration.\n *\n * Example:\n *\n * ```ts\n *  // prefix-no-default mode with default locale\n *  getPrefix('en', { defaultLocale: 'en', mode: 'prefix-no-default' })\n *     // Returns { prefix: '', localePrefix: undefined }\n *\n *  // prefix-no-default mode with non-default locale\n *  getPrefix('fr', { defaultLocale: 'en', mode: 'prefix-no-default' })\n *     // Returns { prefix: '/fr', localePrefix: 'fr' }\n *\n *  // prefix-all mode\n *  getPrefix('en', { defaultLocale: 'en', mode: 'prefix-all' })\n *     // Returns { prefix: '/en', localePrefix: locale }\n *\n *  // search-params mode\n *  getPrefix('en', { defaultLocale: 'en', mode: 'search-params' })\n *     // Returns { prefix: '', localePrefix: undefined }\n *\n *  // no-prefix mode\n *  getPrefix('en', { defaultLocale: 'en', mode: 'no-prefix' })\n *     // Returns { prefix: '', localePrefix: undefined }\n * ```\n *\n * @param locale - The locale to check for prefix. If not provided, uses configured default locale.\n * @param options - Configuration options\n * @param options.defaultLocale - The default locale. Defaults to configured default locale.\n * @param options.mode - URL routing mode for locale handling. Defaults to configured mode.\n * @returns An object containing pathPrefix, prefix, and localePrefix for the given locale.\n */\nexport const getPrefix = (\n  locale: LocalesValues | undefined,\n  options: {\n    defaultLocale?: LocalesValues;\n    locales?: LocalesValues[];\n    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';\n  } = {}\n): GetPrefixResult => {\n  const { defaultLocale, mode, locales } = {\n    defaultLocale:\n      configuration?.internationalization?.defaultLocale ??\n      DefaultValues.Internationalization.DEFAULT_LOCALE,\n    mode: configuration?.routing?.mode ?? DefaultValues.Routing.ROUTING_MODE,\n    locales:\n      configuration?.internationalization?.locales ??\n      DefaultValues.Internationalization.LOCALES,\n    ...options,\n  };\n\n  if (!locale || !locales.includes(locale)) {\n    return {\n      prefix: '',\n      localePrefix: undefined,\n    };\n  }\n\n  // Handle prefix-based modes (prefix-all or prefix-no-default)\n  const shouldPrefix =\n    mode === 'prefix-all' ||\n    (mode === 'prefix-no-default' && defaultLocale !== locale);\n\n  if (shouldPrefix) {\n    return {\n      prefix: `${locale}/`,\n      localePrefix: locale as Locale,\n    };\n  }\n\n  return {\n    prefix: '',\n    localePrefix: undefined,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DA,MAAa,aACX,QACA,UAII,EAAE,KACc;CACpB,MAAM,EAAE,eAAe,MAAM,YAAY;EACvC,eACE,eAAe,sBAAsB,iBACrC,cAAc,qBAAqB;EACrC,MAAM,eAAe,SAAS,QAAQ,cAAc,QAAQ;EAC5D,SACE,eAAe,sBAAsB,WACrC,cAAc,qBAAqB;EACrC,GAAG;EACJ;AAED,KAAI,CAAC,UAAU,CAAC,QAAQ,SAAS,OAAO,CACtC,QAAO;EACL,QAAQ;EACR,cAAc;EACf;AAQH,KAHE,SAAS,gBACR,SAAS,uBAAuB,kBAAkB,OAGnD,QAAO;EACL,QAAQ,GAAG,OAAO;EAClB,cAAc;EACf;AAGH,QAAO;EACL,QAAQ;EACR,cAAc;EACf"}

package/dist/esm/localization/index.mjs

@@ -10,5 +10,6 @@ import { getPrefix } from "./getPrefix.mjs";
 import { getLocalizedUrl } from "./getLocalizedUrl.mjs";
 import { getMultilingualUrls } from "./getMultilingualUrls.mjs";
 import { localeFlatMap, localeMap, localeRecord } from "./localeMapper.mjs";
+import { validatePrefix } from "./validatePrefix.mjs";
 
-export { getBrowserLocale, getHTMLTextDir, getLocaleFromPath, getLocaleLang, getLocaleName, getLocalizedUrl, getMultilingualUrls, getPathWithoutLocale, getPrefix, localeDetector, localeFlatMap, localeMap, localeRecord, localeResolver, localeStorageOptions };
+export { getBrowserLocale, getHTMLTextDir, getLocaleFromPath, getLocaleLang, getLocaleName, getLocalizedUrl, getMultilingualUrls, getPathWithoutLocale, getPrefix, localeDetector, localeFlatMap, localeMap, localeRecord, localeResolver, localeStorageOptions, validatePrefix };

package/dist/esm/localization/isValidLocale.mjs

@@ -0,0 +1,52 @@
+import { getPrefix } from "./getPrefix.mjs";
+import { DefaultValues } from "@intlayer/config/client";
+import configuration from "@intlayer/config/built";
+
+//#region src/localization/isValidLocale.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 `true` if the locale is valid or if no locale is provided and the routing mode allows it; `false` otherwise.
+*
+* @example
+* // Check if 'en' is a valid locale
+* const isValid = validatePrefix('en');
+*
+* @example
+* // Check with custom options
+* const isValid = validatePrefix('fr', {
+*   locales: ['en', 'fr', 'es'],
+*   defaultLocale: 'en',
+*   mode: 'prefix-all',
+* });
+*/
+const validatePrefix = (locale, options) => {
+	const { defaultLocale, mode, locales } = {
+		defaultLocale: configuration?.internationalization?.defaultLocale ?? DefaultValues.Internationalization.DEFAULT_LOCALE,
+		mode: configuration?.routing?.mode ?? DefaultValues.Routing.ROUTING_MODE,
+		locales: configuration?.internationalization?.locales ?? DefaultValues.Internationalization.LOCALES,
+		...options
+	};
+	const { localePrefix } = 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
+export { validatePrefix };
+//# sourceMappingURL=isValidLocale.mjs.map

package/dist/esm/localization/isValidLocale.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"isValidLocale.mjs","names":[],"sources":["../../../src/localization/isValidLocale.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport { DefaultValues } from '@intlayer/config/client';\nimport type { LocalesValues } from '@intlayer/types';\nimport { getPrefix } from './getPrefix';\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 `true` if the locale is valid or if no locale is provided and the routing mode allows it; `false` otherwise.\n *\n * @example\n * // Check if 'en' is a valid locale\n * const isValid = validatePrefix('en');\n *\n * @example\n * // Check with custom options\n * const isValid = 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): boolean => {\n  const { defaultLocale, mode, locales } = {\n    defaultLocale:\n      configuration?.internationalization?.defaultLocale ??\n      DefaultValues.Internationalization.DEFAULT_LOCALE,\n    mode: configuration?.routing?.mode ?? DefaultValues.Routing.ROUTING_MODE,\n    locales:\n      configuration?.internationalization?.locales ??\n      DefaultValues.Internationalization.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 isValidLocale: boolean = locales.some(\n    (localeEl) => localeEl === locale\n  );\n\n  return { isValid: isValidLocale, localePrefix: localePrefix };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,MAAa,kBACX,QACA,YAKY;CACZ,MAAM,EAAE,eAAe,MAAM,YAAY;EACvC,eACE,eAAe,sBAAsB,iBACrC,cAAc,qBAAqB;EACrC,MAAM,eAAe,SAAS,QAAQ,cAAc,QAAQ;EAC5D,SACE,eAAe,sBAAsB,WACrC,cAAc,qBAAqB;EACrC,GAAG;EACJ;CAID,MAAM,EAAE,iBAAiB,UAAU,UAAU,eAAe;EAC1D;EACA;EACA;EACD,CAAC;AAEF,KAAI,iBAAiB,UAAU,WAAW,OACxC,QAAO;EAAE,SAAS;EAAM,cAAc;EAAW;AAQnD,QAAO;EAAE,SAJsB,QAAQ,MACpC,aAAa,aAAa,OAC5B;EAE8C;EAAc"}