@wix/headless-localization-utils 1.0.1 → 1.0.3

package/build/index.cjs

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  MULTILINGUAL_COOKIE_HEADER_KEY: () => MULTILINGUAL_COOKIE_HEADER_KEY,
   getLocalizationData: () => getLocalizationData
 });
 module.exports = __toCommonJS(index_exports);
@@ -103,8 +104,34 @@ var getLanguageIfExists = (languageCode, availableLocales) => {
   );
 };
 
+// src/languageHeaderUtils.ts
+var calculateLocaleFromMultilingualCookie = (headers, supportedLanguages) => {
+  if (!supportedLanguages.length) {
+    return void 0;
+  }
+  const languageCode = getWixLanguageFromCookie(headers)?.languageCode;
+  if (!languageCode) {
+    return void 0;
+  }
+  return supportedLanguages.find(
+    (supportedLanguage) => supportedLanguage.languageCode === languageCode
+  );
+};
+var getWixLanguageFromCookie = (headers) => {
+  try {
+    const cookies = headers.get("cookie") ?? void 0;
+    const languageCookie = cookies?.split(";").find(
+      (keyValue) => keyValue.trim().startsWith(`${MULTILINGUAL_COOKIE_HEADER_KEY}=`)
+    );
+    return languageCookie ? { languageCode: languageCookie.split("=")[1] } : void 0;
+  } catch {
+    return void 0;
+  }
+};
+
 // src/localizationUtils.ts
-function getLocalizationData(url, siteProperties) {
+var MULTILINGUAL_COOKIE_HEADER_KEY = `wixLanguage`;
+function getLocalizationData(url, header, siteProperties) {
   const availableLocales = siteProperties?.multilingual?.supportedLanguages ?? [];
   const explicitRequestedLocale = extractLanguageFromUrlAndValidate(
     url,
@@ -114,11 +141,11 @@ function getLocalizationData(url, siteProperties) {
     ...availableLocales.map((locale2) => locale2.locale?.languageCode),
     siteProperties?.locale?.languageCode
   ].filter((languageCode) => Boolean(languageCode));
-  const cleanUrl = clearLanguageFromUrl(url.href, languageCodes);
   const locale = buildLocaleString(
-    explicitRequestedLocale?.locale ?? siteProperties?.locale
+    explicitRequestedLocale?.locale ?? calculateLocaleFromMultilingualCookie(header, availableLocales)?.locale ?? siteProperties?.locale
   ) ?? void 0;
-  const language = explicitRequestedLocale?.languageCode ?? siteProperties?.language ?? void 0;
+  const language = explicitRequestedLocale?.languageCode ?? calculateLocaleFromMultilingualCookie(header, availableLocales)?.languageCode ?? siteProperties?.language ?? void 0;
+  const cleanUrl = clearLanguageFromUrl(url.href, languageCodes);
   const essentials = {
     language,
     locale,
@@ -129,6 +156,7 @@ function getLocalizationData(url, siteProperties) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  MULTILINGUAL_COOKIE_HEADER_KEY,
   getLocalizationData
 });
 //# sourceMappingURL=index.cjs.map

package/build/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/localeUtils.ts","../src/urlUtils.ts","../src/localizationUtils.ts"],"sourcesContent":["export {\n  getLocalizationData,\n  type LocalizationData,\n} from './localizationUtils.js';\n","import type { scripts } from '@wix/headless-site-assets';\n\n// Type for locale object\nexport type Locale = scripts.Locale;\n\n// Type for locale string building\nexport const buildLocaleString = (\n  locale?: null | Locale,\n): string | undefined => {\n  if (!locale) {\n    return;\n  }\n\n  // in case of dialects, language code will be in the form of\n  // en-au and not just en\n  if (locale.languageCode?.includes('-')) {\n    return locale.languageCode;\n  }\n\n  const localeParts = [locale.languageCode, locale.country].filter(Boolean);\n\n  if (localeParts.length === 0) {\n    return;\n  }\n\n  return localeParts.join('-');\n};\n","import type { scripts } from '@wix/headless-site-assets';\n\nexport type SupportedLanguage = scripts.SupportedLanguage;\n\ntype AvailableLocale = SupportedLanguage;\n\nconst getLanguageFromQueryParam = (url: URL) =>\n  url.searchParams.get('lang') ?? undefined;\nconst getLanguageFromSubfolder = (url: URL) => url.pathname.split('/')[1];\nconst getLanguageFromSubdomain = (url: URL) => url.hostname.split('.')[0];\n\nexport const extractLanguageFromUrlAndValidate = (\n  url: URL,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  const localeFromQueryParams = extractFromQueryParamsAndValidate(\n    url,\n    availableLocales,\n  );\n  if (localeFromQueryParams?.resolutionMethod === 'QUERY_PARAM') {\n    return localeFromQueryParams;\n  }\n\n  const localeFromSubfolder = extractFromSubfolderAndValidate(\n    url,\n    availableLocales,\n  );\n  if (localeFromSubfolder?.resolutionMethod === 'SUBDIRECTORY') {\n    return localeFromSubfolder;\n  }\n\n  const localeFromSubdomain = extractFromSubdomainAndValidate(\n    url,\n    availableLocales,\n  );\n  if (localeFromSubdomain?.resolutionMethod === 'SUBDOMAIN') {\n    return localeFromSubdomain;\n  }\n\n  // Fallback if a locale is available but doesn't have the correct resolution method\n  return localeFromQueryParams ?? localeFromSubfolder ?? localeFromSubdomain;\n};\n\nexport const clearLanguageFromUrl = (\n  urlString: string,\n  languageCodes: string[],\n): string => {\n  const url = new URL(urlString);\n  url.searchParams.delete('lang');\n\n  const subfolderLanguage = url.pathname.split('/')[1]?.toLowerCase();\n  if (languageCodes.includes(subfolderLanguage ?? '')) {\n    const segments = url.pathname.split('/'); // ['', 'en', 'docs', 'api']\n    segments.splice(1, 1); // Remove index 1\n    url.pathname = segments.join('/');\n  }\n\n  const subdirectoryLanguage = url.hostname.split('.')[0]?.toLowerCase();\n  if (languageCodes.includes(subdirectoryLanguage ?? '')) {\n    const parts = url.hostname.split('.'); // ['fr', 'example', 'com']\n    parts.shift(); // ['example', 'com']\n    url.hostname = parts.join('.');\n  }\n\n  return url.href;\n};\n\n// https://somesite.com/hello?lang:XX\nconst extractFromQueryParamsAndValidate = (\n  url: URL,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  return getLanguageIfExists(getLanguageFromQueryParam(url), availableLocales);\n};\n\n// https://somesite.com/XX/hello\nconst extractFromSubfolderAndValidate = (\n  url: URL,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  return getLanguageIfExists(getLanguageFromSubfolder(url), availableLocales);\n};\n\n// https://XX.somesite.com/hello\nconst extractFromSubdomainAndValidate = (\n  url: URL,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  return getLanguageIfExists(getLanguageFromSubdomain(url), availableLocales);\n};\n\nconst getLanguageIfExists = (\n  languageCode: string | undefined,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  if (languageCode == null) {\n    return undefined;\n  }\n  const lowerCasedCode = languageCode.toLowerCase();\n  return availableLocales.find(\n    (locale) => locale.locale?.languageCode?.toLowerCase() === lowerCasedCode,\n  );\n};\n","import type { Essentials, Multilingual } from '@wix/headless-node';\nimport type { scripts } from '@wix/headless-site-assets';\nimport { buildLocaleString } from './localeUtils.js';\nimport {\n  clearLanguageFromUrl,\n  extractLanguageFromUrlAndValidate,\n} from './urlUtils.js';\n\nexport type EssentialProperties = scripts.EssentialProperties;\n\nexport type LocalizationData = {\n  cleanUrl: string;\n  essentials: Essentials;\n};\n\nexport function getLocalizationData(\n  url: URL,\n  siteProperties: EssentialProperties,\n): LocalizationData {\n  const availableLocales =\n    siteProperties?.multilingual?.supportedLanguages ?? [];\n  const explicitRequestedLocale = extractLanguageFromUrlAndValidate(\n    url,\n    availableLocales,\n  );\n\n  const languageCodes = [\n    ...availableLocales.map((locale) => locale.locale?.languageCode),\n    siteProperties?.locale?.languageCode,\n  ].filter((languageCode) => Boolean(languageCode)) as string[];\n\n  const cleanUrl = clearLanguageFromUrl(url.href, languageCodes);\n\n  const locale =\n    buildLocaleString(\n      explicitRequestedLocale?.locale ?? siteProperties?.locale,\n    ) ?? undefined;\n\n  const language =\n    explicitRequestedLocale?.languageCode ??\n    siteProperties?.language ??\n    undefined;\n\n  const essentials: Essentials = {\n    language,\n    locale,\n    multilingual: siteProperties?.multilingual as Multilingual | undefined,\n    timezone: siteProperties?.timeZone ?? undefined,\n  };\n\n  return { cleanUrl, essentials };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACMO,IAAM,oBAAoB,CAC/B,WACuB;AACvB,MAAI,CAAC,QAAQ;AACX;AAAA,EACF;AAIA,MAAI,OAAO,cAAc,SAAS,GAAG,GAAG;AACtC,WAAO,OAAO;AAAA,EAChB;AAEA,QAAM,cAAc,CAAC,OAAO,cAAc,OAAO,OAAO,EAAE,OAAO,OAAO;AAExE,MAAI,YAAY,WAAW,GAAG;AAC5B;AAAA,EACF;AAEA,SAAO,YAAY,KAAK,GAAG;AAC7B;;;ACpBA,IAAM,4BAA4B,CAAC,QACjC,IAAI,aAAa,IAAI,MAAM,KAAK;AAClC,IAAM,2BAA2B,CAAC,QAAa,IAAI,SAAS,MAAM,GAAG,EAAE,CAAC;AACxE,IAAM,2BAA2B,CAAC,QAAa,IAAI,SAAS,MAAM,GAAG,EAAE,CAAC;AAEjE,IAAM,oCAAoC,CAC/C,KACA,qBACgC;AAChC,QAAM,wBAAwB;AAAA,IAC5B;AAAA,IACA;AAAA,EACF;AACA,MAAI,uBAAuB,qBAAqB,eAAe;AAC7D,WAAO;AAAA,EACT;AAEA,QAAM,sBAAsB;AAAA,IAC1B;AAAA,IACA;AAAA,EACF;AACA,MAAI,qBAAqB,qBAAqB,gBAAgB;AAC5D,WAAO;AAAA,EACT;AAEA,QAAM,sBAAsB;AAAA,IAC1B;AAAA,IACA;AAAA,EACF;AACA,MAAI,qBAAqB,qBAAqB,aAAa;AACzD,WAAO;AAAA,EACT;AAGA,SAAO,yBAAyB,uBAAuB;AACzD;AAEO,IAAM,uBAAuB,CAClC,WACA,kBACW;AACX,QAAM,MAAM,IAAI,IAAI,SAAS;AAC7B,MAAI,aAAa,OAAO,MAAM;AAE9B,QAAM,oBAAoB,IAAI,SAAS,MAAM,GAAG,EAAE,CAAC,GAAG,YAAY;AAClE,MAAI,cAAc,SAAS,qBAAqB,EAAE,GAAG;AACnD,UAAM,WAAW,IAAI,SAAS,MAAM,GAAG;AACvC,aAAS,OAAO,GAAG,CAAC;AACpB,QAAI,WAAW,SAAS,KAAK,GAAG;AAAA,EAClC;AAEA,QAAM,uBAAuB,IAAI,SAAS,MAAM,GAAG,EAAE,CAAC,GAAG,YAAY;AACrE,MAAI,cAAc,SAAS,wBAAwB,EAAE,GAAG;AACtD,UAAM,QAAQ,IAAI,SAAS,MAAM,GAAG;AACpC,UAAM,MAAM;AACZ,QAAI,WAAW,MAAM,KAAK,GAAG;AAAA,EAC/B;AAEA,SAAO,IAAI;AACb;AAGA,IAAM,oCAAoC,CACxC,KACA,qBACgC;AAChC,SAAO,oBAAoB,0BAA0B,GAAG,GAAG,gBAAgB;AAC7E;AAGA,IAAM,kCAAkC,CACtC,KACA,qBACgC;AAChC,SAAO,oBAAoB,yBAAyB,GAAG,GAAG,gBAAgB;AAC5E;AAGA,IAAM,kCAAkC,CACtC,KACA,qBACgC;AAChC,SAAO,oBAAoB,yBAAyB,GAAG,GAAG,gBAAgB;AAC5E;AAEA,IAAM,sBAAsB,CAC1B,cACA,qBACgC;AAChC,MAAI,gBAAgB,MAAM;AACxB,WAAO;AAAA,EACT;AACA,QAAM,iBAAiB,aAAa,YAAY;AAChD,SAAO,iBAAiB;AAAA,IACtB,CAAC,WAAW,OAAO,QAAQ,cAAc,YAAY,MAAM;AAAA,EAC7D;AACF;;;ACvFO,SAAS,oBACd,KACA,gBACkB;AAClB,QAAM,mBACJ,gBAAgB,cAAc,sBAAsB,CAAC;AACvD,QAAM,0BAA0B;AAAA,IAC9B;AAAA,IACA;AAAA,EACF;AAEA,QAAM,gBAAgB;AAAA,IACpB,GAAG,iBAAiB,IAAI,CAACA,YAAWA,QAAO,QAAQ,YAAY;AAAA,IAC/D,gBAAgB,QAAQ;AAAA,EAC1B,EAAE,OAAO,CAAC,iBAAiB,QAAQ,YAAY,CAAC;AAEhD,QAAM,WAAW,qBAAqB,IAAI,MAAM,aAAa;AAE7D,QAAM,SACJ;AAAA,IACE,yBAAyB,UAAU,gBAAgB;AAAA,EACrD,KAAK;AAEP,QAAM,WACJ,yBAAyB,gBACzB,gBAAgB,YAChB;AAEF,QAAM,aAAyB;AAAA,IAC7B;AAAA,IACA;AAAA,IACA,cAAc,gBAAgB;AAAA,IAC9B,UAAU,gBAAgB,YAAY;AAAA,EACxC;AAEA,SAAO,EAAE,UAAU,WAAW;AAChC;","names":["locale"]}
+{"version":3,"sources":["../src/index.ts","../src/localeUtils.ts","../src/urlUtils.ts","../src/languageHeaderUtils.ts","../src/localizationUtils.ts"],"sourcesContent":["export {\n  getLocalizationData,\n  type LocalizationData,\n  MULTILINGUAL_COOKIE_HEADER_KEY,\n} from './localizationUtils.js';\n","import type { scripts } from '@wix/headless-site-assets';\n\n// Type for locale object\nexport type Locale = scripts.Locale;\n\n// Type for locale string building\nexport const buildLocaleString = (\n  locale?: null | Locale,\n): string | undefined => {\n  if (!locale) {\n    return;\n  }\n\n  // in case of dialects, language code will be in the form of\n  // en-au and not just en\n  if (locale.languageCode?.includes('-')) {\n    return locale.languageCode;\n  }\n\n  const localeParts = [locale.languageCode, locale.country].filter(Boolean);\n\n  if (localeParts.length === 0) {\n    return;\n  }\n\n  return localeParts.join('-');\n};\n","import type { scripts } from '@wix/headless-site-assets';\n\nexport type SupportedLanguage = scripts.SupportedLanguage;\n\ntype AvailableLocale = SupportedLanguage;\n\nconst getLanguageFromQueryParam = (url: URL) =>\n  url.searchParams.get('lang') ?? undefined;\nconst getLanguageFromSubfolder = (url: URL) => url.pathname.split('/')[1];\nconst getLanguageFromSubdomain = (url: URL) => url.hostname.split('.')[0];\n\nexport const extractLanguageFromUrlAndValidate = (\n  url: URL,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  const localeFromQueryParams = extractFromQueryParamsAndValidate(\n    url,\n    availableLocales,\n  );\n  if (localeFromQueryParams?.resolutionMethod === 'QUERY_PARAM') {\n    return localeFromQueryParams;\n  }\n\n  const localeFromSubfolder = extractFromSubfolderAndValidate(\n    url,\n    availableLocales,\n  );\n  if (localeFromSubfolder?.resolutionMethod === 'SUBDIRECTORY') {\n    return localeFromSubfolder;\n  }\n\n  const localeFromSubdomain = extractFromSubdomainAndValidate(\n    url,\n    availableLocales,\n  );\n  if (localeFromSubdomain?.resolutionMethod === 'SUBDOMAIN') {\n    return localeFromSubdomain;\n  }\n\n  // Fallback if a locale is available but doesn't have the correct resolution method\n  return localeFromQueryParams ?? localeFromSubfolder ?? localeFromSubdomain;\n};\n\nexport const clearLanguageFromUrl = (\n  urlString: string,\n  languageCodes: string[],\n): string => {\n  const url = new URL(urlString);\n  url.searchParams.delete('lang');\n\n  const subfolderLanguage = url.pathname.split('/')[1]?.toLowerCase();\n  if (languageCodes.includes(subfolderLanguage ?? '')) {\n    const segments = url.pathname.split('/'); // ['', 'en', 'docs', 'api']\n    segments.splice(1, 1); // Remove index 1\n    url.pathname = segments.join('/');\n  }\n\n  const subdirectoryLanguage = url.hostname.split('.')[0]?.toLowerCase();\n  if (languageCodes.includes(subdirectoryLanguage ?? '')) {\n    const parts = url.hostname.split('.'); // ['fr', 'example', 'com']\n    parts.shift(); // ['example', 'com']\n    url.hostname = parts.join('.');\n  }\n\n  return url.href;\n};\n\n// https://somesite.com/hello?lang:XX\nconst extractFromQueryParamsAndValidate = (\n  url: URL,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  return getLanguageIfExists(getLanguageFromQueryParam(url), availableLocales);\n};\n\n// https://somesite.com/XX/hello\nconst extractFromSubfolderAndValidate = (\n  url: URL,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  return getLanguageIfExists(getLanguageFromSubfolder(url), availableLocales);\n};\n\n// https://XX.somesite.com/hello\nconst extractFromSubdomainAndValidate = (\n  url: URL,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  return getLanguageIfExists(getLanguageFromSubdomain(url), availableLocales);\n};\n\nconst getLanguageIfExists = (\n  languageCode: string | undefined,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  if (languageCode == null) {\n    return undefined;\n  }\n  const lowerCasedCode = languageCode.toLowerCase();\n  return availableLocales.find(\n    (locale) => locale.locale?.languageCode?.toLowerCase() === lowerCasedCode,\n  );\n};\n","import type { scripts } from '@wix/headless-site-assets';\nimport {\n  MULTILINGUAL_COOKIE_HEADER_KEY,\n  WixLanguage,\n} from './localizationUtils.js';\n\nexport const calculateLocaleFromMultilingualCookie = (\n  headers: Headers,\n  supportedLanguages: scripts.SupportedLanguage[],\n) => {\n  if (!supportedLanguages.length) {\n    return undefined;\n  }\n\n  const languageCode = getWixLanguageFromCookie(headers)?.languageCode;\n  if (!languageCode) {\n    return undefined;\n  }\n  return supportedLanguages.find(\n    (supportedLanguage) => supportedLanguage.languageCode === languageCode,\n  );\n};\n\nconst getWixLanguageFromCookie = (\n  headers: Headers,\n): WixLanguage | undefined => {\n  try {\n    const cookies = headers.get('cookie') ?? undefined;\n\n    const languageCookie = cookies\n      ?.split(';')\n      .find((keyValue) =>\n        keyValue.trim().startsWith(`${MULTILINGUAL_COOKIE_HEADER_KEY}=`),\n      );\n\n    return languageCookie\n      ? { languageCode: languageCookie.split('=')[1] }\n      : undefined;\n  } catch {\n    return undefined;\n  }\n};\n","import type { Essentials, Multilingual } from '@wix/headless-node';\nimport type { scripts } from '@wix/headless-site-assets';\nimport { buildLocaleString } from './localeUtils.js';\nimport {\n  clearLanguageFromUrl,\n  extractLanguageFromUrlAndValidate,\n} from './urlUtils.js';\nimport { calculateLocaleFromMultilingualCookie } from './languageHeaderUtils.js';\n\nexport type EssentialProperties = scripts.EssentialProperties;\nexport const MULTILINGUAL_COOKIE_HEADER_KEY = `wixLanguage`;\nexport interface WixLanguage {\n  languageCode?: string;\n}\n\nexport type LocalizationData = {\n  cleanUrl: string;\n  essentials: Essentials;\n};\n\nexport function getLocalizationData(\n  url: URL,\n  header: Headers,\n  siteProperties: EssentialProperties,\n): LocalizationData {\n  const availableLocales =\n    siteProperties?.multilingual?.supportedLanguages ?? [];\n  const explicitRequestedLocale = extractLanguageFromUrlAndValidate(\n    url,\n    availableLocales,\n  );\n\n  const languageCodes = [\n    ...availableLocales.map((locale) => locale.locale?.languageCode),\n    siteProperties?.locale?.languageCode,\n  ].filter((languageCode) => Boolean(languageCode)) as string[];\n\n  const locale =\n    buildLocaleString(\n      explicitRequestedLocale?.locale ??\n        calculateLocaleFromMultilingualCookie(header, availableLocales)\n          ?.locale ??\n        siteProperties?.locale,\n    ) ?? undefined;\n\n  const language =\n    explicitRequestedLocale?.languageCode ??\n    calculateLocaleFromMultilingualCookie(header, availableLocales)\n      ?.languageCode ??\n    siteProperties?.language ??\n    undefined;\n\n  const cleanUrl = clearLanguageFromUrl(url.href, languageCodes);\n\n  const essentials: Essentials = {\n    language,\n    locale,\n    multilingual: siteProperties?.multilingual as Multilingual | undefined,\n    timezone: siteProperties?.timeZone ?? undefined,\n  };\n\n  return { cleanUrl, essentials };\n}\n"],"mappings":"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","names":["locale"]}

package/build/index.d.cts

@@ -2,10 +2,11 @@ import { Essentials } from '@wix/headless-node';
 import { scripts } from '@wix/headless-site-assets';
 
 type EssentialProperties = scripts.EssentialProperties;
+declare const MULTILINGUAL_COOKIE_HEADER_KEY = "wixLanguage";
 type LocalizationData = {
     cleanUrl: string;
     essentials: Essentials;
 };
-declare function getLocalizationData(url: URL, siteProperties: EssentialProperties): LocalizationData;
+declare function getLocalizationData(url: URL, header: Headers, siteProperties: EssentialProperties): LocalizationData;
 
-export { type LocalizationData, getLocalizationData };
+export { type LocalizationData, MULTILINGUAL_COOKIE_HEADER_KEY, getLocalizationData };

package/build/index.d.ts

@@ -2,10 +2,11 @@ import { Essentials } from '@wix/headless-node';
 import { scripts } from '@wix/headless-site-assets';
 
 type EssentialProperties = scripts.EssentialProperties;
+declare const MULTILINGUAL_COOKIE_HEADER_KEY = "wixLanguage";
 type LocalizationData = {
     cleanUrl: string;
     essentials: Essentials;
 };
-declare function getLocalizationData(url: URL, siteProperties: EssentialProperties): LocalizationData;
+declare function getLocalizationData(url: URL, header: Headers, siteProperties: EssentialProperties): LocalizationData;
 
-export { type LocalizationData, getLocalizationData };
+export { type LocalizationData, MULTILINGUAL_COOKIE_HEADER_KEY, getLocalizationData };

package/build/index.js

@@ -77,8 +77,34 @@ var getLanguageIfExists = (languageCode, availableLocales) => {
   );
 };
 
+// src/languageHeaderUtils.ts
+var calculateLocaleFromMultilingualCookie = (headers, supportedLanguages) => {
+  if (!supportedLanguages.length) {
+    return void 0;
+  }
+  const languageCode = getWixLanguageFromCookie(headers)?.languageCode;
+  if (!languageCode) {
+    return void 0;
+  }
+  return supportedLanguages.find(
+    (supportedLanguage) => supportedLanguage.languageCode === languageCode
+  );
+};
+var getWixLanguageFromCookie = (headers) => {
+  try {
+    const cookies = headers.get("cookie") ?? void 0;
+    const languageCookie = cookies?.split(";").find(
+      (keyValue) => keyValue.trim().startsWith(`${MULTILINGUAL_COOKIE_HEADER_KEY}=`)
+    );
+    return languageCookie ? { languageCode: languageCookie.split("=")[1] } : void 0;
+  } catch {
+    return void 0;
+  }
+};
+
 // src/localizationUtils.ts
-function getLocalizationData(url, siteProperties) {
+var MULTILINGUAL_COOKIE_HEADER_KEY = `wixLanguage`;
+function getLocalizationData(url, header, siteProperties) {
   const availableLocales = siteProperties?.multilingual?.supportedLanguages ?? [];
   const explicitRequestedLocale = extractLanguageFromUrlAndValidate(
     url,
@@ -88,11 +114,11 @@ function getLocalizationData(url, siteProperties) {
     ...availableLocales.map((locale2) => locale2.locale?.languageCode),
     siteProperties?.locale?.languageCode
   ].filter((languageCode) => Boolean(languageCode));
-  const cleanUrl = clearLanguageFromUrl(url.href, languageCodes);
   const locale = buildLocaleString(
-    explicitRequestedLocale?.locale ?? siteProperties?.locale
+    explicitRequestedLocale?.locale ?? calculateLocaleFromMultilingualCookie(header, availableLocales)?.locale ?? siteProperties?.locale
   ) ?? void 0;
-  const language = explicitRequestedLocale?.languageCode ?? siteProperties?.language ?? void 0;
+  const language = explicitRequestedLocale?.languageCode ?? calculateLocaleFromMultilingualCookie(header, availableLocales)?.languageCode ?? siteProperties?.language ?? void 0;
+  const cleanUrl = clearLanguageFromUrl(url.href, languageCodes);
   const essentials = {
     language,
     locale,
@@ -102,6 +128,7 @@ function getLocalizationData(url, siteProperties) {
   return { cleanUrl, essentials };
 }
 export {
+  MULTILINGUAL_COOKIE_HEADER_KEY,
   getLocalizationData
 };
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/localeUtils.ts","../src/urlUtils.ts","../src/localizationUtils.ts"],"sourcesContent":["import type { scripts } from '@wix/headless-site-assets';\n\n// Type for locale object\nexport type Locale = scripts.Locale;\n\n// Type for locale string building\nexport const buildLocaleString = (\n  locale?: null | Locale,\n): string | undefined => {\n  if (!locale) {\n    return;\n  }\n\n  // in case of dialects, language code will be in the form of\n  // en-au and not just en\n  if (locale.languageCode?.includes('-')) {\n    return locale.languageCode;\n  }\n\n  const localeParts = [locale.languageCode, locale.country].filter(Boolean);\n\n  if (localeParts.length === 0) {\n    return;\n  }\n\n  return localeParts.join('-');\n};\n","import type { scripts } from '@wix/headless-site-assets';\n\nexport type SupportedLanguage = scripts.SupportedLanguage;\n\ntype AvailableLocale = SupportedLanguage;\n\nconst getLanguageFromQueryParam = (url: URL) =>\n  url.searchParams.get('lang') ?? undefined;\nconst getLanguageFromSubfolder = (url: URL) => url.pathname.split('/')[1];\nconst getLanguageFromSubdomain = (url: URL) => url.hostname.split('.')[0];\n\nexport const extractLanguageFromUrlAndValidate = (\n  url: URL,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  const localeFromQueryParams = extractFromQueryParamsAndValidate(\n    url,\n    availableLocales,\n  );\n  if (localeFromQueryParams?.resolutionMethod === 'QUERY_PARAM') {\n    return localeFromQueryParams;\n  }\n\n  const localeFromSubfolder = extractFromSubfolderAndValidate(\n    url,\n    availableLocales,\n  );\n  if (localeFromSubfolder?.resolutionMethod === 'SUBDIRECTORY') {\n    return localeFromSubfolder;\n  }\n\n  const localeFromSubdomain = extractFromSubdomainAndValidate(\n    url,\n    availableLocales,\n  );\n  if (localeFromSubdomain?.resolutionMethod === 'SUBDOMAIN') {\n    return localeFromSubdomain;\n  }\n\n  // Fallback if a locale is available but doesn't have the correct resolution method\n  return localeFromQueryParams ?? localeFromSubfolder ?? localeFromSubdomain;\n};\n\nexport const clearLanguageFromUrl = (\n  urlString: string,\n  languageCodes: string[],\n): string => {\n  const url = new URL(urlString);\n  url.searchParams.delete('lang');\n\n  const subfolderLanguage = url.pathname.split('/')[1]?.toLowerCase();\n  if (languageCodes.includes(subfolderLanguage ?? '')) {\n    const segments = url.pathname.split('/'); // ['', 'en', 'docs', 'api']\n    segments.splice(1, 1); // Remove index 1\n    url.pathname = segments.join('/');\n  }\n\n  const subdirectoryLanguage = url.hostname.split('.')[0]?.toLowerCase();\n  if (languageCodes.includes(subdirectoryLanguage ?? '')) {\n    const parts = url.hostname.split('.'); // ['fr', 'example', 'com']\n    parts.shift(); // ['example', 'com']\n    url.hostname = parts.join('.');\n  }\n\n  return url.href;\n};\n\n// https://somesite.com/hello?lang:XX\nconst extractFromQueryParamsAndValidate = (\n  url: URL,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  return getLanguageIfExists(getLanguageFromQueryParam(url), availableLocales);\n};\n\n// https://somesite.com/XX/hello\nconst extractFromSubfolderAndValidate = (\n  url: URL,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  return getLanguageIfExists(getLanguageFromSubfolder(url), availableLocales);\n};\n\n// https://XX.somesite.com/hello\nconst extractFromSubdomainAndValidate = (\n  url: URL,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  return getLanguageIfExists(getLanguageFromSubdomain(url), availableLocales);\n};\n\nconst getLanguageIfExists = (\n  languageCode: string | undefined,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  if (languageCode == null) {\n    return undefined;\n  }\n  const lowerCasedCode = languageCode.toLowerCase();\n  return availableLocales.find(\n    (locale) => locale.locale?.languageCode?.toLowerCase() === lowerCasedCode,\n  );\n};\n","import type { Essentials, Multilingual } from '@wix/headless-node';\nimport type { scripts } from '@wix/headless-site-assets';\nimport { buildLocaleString } from './localeUtils.js';\nimport {\n  clearLanguageFromUrl,\n  extractLanguageFromUrlAndValidate,\n} from './urlUtils.js';\n\nexport type EssentialProperties = scripts.EssentialProperties;\n\nexport type LocalizationData = {\n  cleanUrl: string;\n  essentials: Essentials;\n};\n\nexport function getLocalizationData(\n  url: URL,\n  siteProperties: EssentialProperties,\n): LocalizationData {\n  const availableLocales =\n    siteProperties?.multilingual?.supportedLanguages ?? [];\n  const explicitRequestedLocale = extractLanguageFromUrlAndValidate(\n    url,\n    availableLocales,\n  );\n\n  const languageCodes = [\n    ...availableLocales.map((locale) => locale.locale?.languageCode),\n    siteProperties?.locale?.languageCode,\n  ].filter((languageCode) => Boolean(languageCode)) as string[];\n\n  const cleanUrl = clearLanguageFromUrl(url.href, languageCodes);\n\n  const locale =\n    buildLocaleString(\n      explicitRequestedLocale?.locale ?? siteProperties?.locale,\n    ) ?? undefined;\n\n  const language =\n    explicitRequestedLocale?.languageCode ??\n    siteProperties?.language ??\n    undefined;\n\n  const essentials: Essentials = {\n    language,\n    locale,\n    multilingual: siteProperties?.multilingual as Multilingual | undefined,\n    timezone: siteProperties?.timeZone ?? undefined,\n  };\n\n  return { cleanUrl, essentials };\n}\n"],"mappings":"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","names":["locale"]}
+{"version":3,"sources":["../src/localeUtils.ts","../src/urlUtils.ts","../src/languageHeaderUtils.ts","../src/localizationUtils.ts"],"sourcesContent":["import type { scripts } from '@wix/headless-site-assets';\n\n// Type for locale object\nexport type Locale = scripts.Locale;\n\n// Type for locale string building\nexport const buildLocaleString = (\n  locale?: null | Locale,\n): string | undefined => {\n  if (!locale) {\n    return;\n  }\n\n  // in case of dialects, language code will be in the form of\n  // en-au and not just en\n  if (locale.languageCode?.includes('-')) {\n    return locale.languageCode;\n  }\n\n  const localeParts = [locale.languageCode, locale.country].filter(Boolean);\n\n  if (localeParts.length === 0) {\n    return;\n  }\n\n  return localeParts.join('-');\n};\n","import type { scripts } from '@wix/headless-site-assets';\n\nexport type SupportedLanguage = scripts.SupportedLanguage;\n\ntype AvailableLocale = SupportedLanguage;\n\nconst getLanguageFromQueryParam = (url: URL) =>\n  url.searchParams.get('lang') ?? undefined;\nconst getLanguageFromSubfolder = (url: URL) => url.pathname.split('/')[1];\nconst getLanguageFromSubdomain = (url: URL) => url.hostname.split('.')[0];\n\nexport const extractLanguageFromUrlAndValidate = (\n  url: URL,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  const localeFromQueryParams = extractFromQueryParamsAndValidate(\n    url,\n    availableLocales,\n  );\n  if (localeFromQueryParams?.resolutionMethod === 'QUERY_PARAM') {\n    return localeFromQueryParams;\n  }\n\n  const localeFromSubfolder = extractFromSubfolderAndValidate(\n    url,\n    availableLocales,\n  );\n  if (localeFromSubfolder?.resolutionMethod === 'SUBDIRECTORY') {\n    return localeFromSubfolder;\n  }\n\n  const localeFromSubdomain = extractFromSubdomainAndValidate(\n    url,\n    availableLocales,\n  );\n  if (localeFromSubdomain?.resolutionMethod === 'SUBDOMAIN') {\n    return localeFromSubdomain;\n  }\n\n  // Fallback if a locale is available but doesn't have the correct resolution method\n  return localeFromQueryParams ?? localeFromSubfolder ?? localeFromSubdomain;\n};\n\nexport const clearLanguageFromUrl = (\n  urlString: string,\n  languageCodes: string[],\n): string => {\n  const url = new URL(urlString);\n  url.searchParams.delete('lang');\n\n  const subfolderLanguage = url.pathname.split('/')[1]?.toLowerCase();\n  if (languageCodes.includes(subfolderLanguage ?? '')) {\n    const segments = url.pathname.split('/'); // ['', 'en', 'docs', 'api']\n    segments.splice(1, 1); // Remove index 1\n    url.pathname = segments.join('/');\n  }\n\n  const subdirectoryLanguage = url.hostname.split('.')[0]?.toLowerCase();\n  if (languageCodes.includes(subdirectoryLanguage ?? '')) {\n    const parts = url.hostname.split('.'); // ['fr', 'example', 'com']\n    parts.shift(); // ['example', 'com']\n    url.hostname = parts.join('.');\n  }\n\n  return url.href;\n};\n\n// https://somesite.com/hello?lang:XX\nconst extractFromQueryParamsAndValidate = (\n  url: URL,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  return getLanguageIfExists(getLanguageFromQueryParam(url), availableLocales);\n};\n\n// https://somesite.com/XX/hello\nconst extractFromSubfolderAndValidate = (\n  url: URL,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  return getLanguageIfExists(getLanguageFromSubfolder(url), availableLocales);\n};\n\n// https://XX.somesite.com/hello\nconst extractFromSubdomainAndValidate = (\n  url: URL,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  return getLanguageIfExists(getLanguageFromSubdomain(url), availableLocales);\n};\n\nconst getLanguageIfExists = (\n  languageCode: string | undefined,\n  availableLocales: AvailableLocale[],\n): AvailableLocale | undefined => {\n  if (languageCode == null) {\n    return undefined;\n  }\n  const lowerCasedCode = languageCode.toLowerCase();\n  return availableLocales.find(\n    (locale) => locale.locale?.languageCode?.toLowerCase() === lowerCasedCode,\n  );\n};\n","import type { scripts } from '@wix/headless-site-assets';\nimport {\n  MULTILINGUAL_COOKIE_HEADER_KEY,\n  WixLanguage,\n} from './localizationUtils.js';\n\nexport const calculateLocaleFromMultilingualCookie = (\n  headers: Headers,\n  supportedLanguages: scripts.SupportedLanguage[],\n) => {\n  if (!supportedLanguages.length) {\n    return undefined;\n  }\n\n  const languageCode = getWixLanguageFromCookie(headers)?.languageCode;\n  if (!languageCode) {\n    return undefined;\n  }\n  return supportedLanguages.find(\n    (supportedLanguage) => supportedLanguage.languageCode === languageCode,\n  );\n};\n\nconst getWixLanguageFromCookie = (\n  headers: Headers,\n): WixLanguage | undefined => {\n  try {\n    const cookies = headers.get('cookie') ?? undefined;\n\n    const languageCookie = cookies\n      ?.split(';')\n      .find((keyValue) =>\n        keyValue.trim().startsWith(`${MULTILINGUAL_COOKIE_HEADER_KEY}=`),\n      );\n\n    return languageCookie\n      ? { languageCode: languageCookie.split('=')[1] }\n      : undefined;\n  } catch {\n    return undefined;\n  }\n};\n","import type { Essentials, Multilingual } from '@wix/headless-node';\nimport type { scripts } from '@wix/headless-site-assets';\nimport { buildLocaleString } from './localeUtils.js';\nimport {\n  clearLanguageFromUrl,\n  extractLanguageFromUrlAndValidate,\n} from './urlUtils.js';\nimport { calculateLocaleFromMultilingualCookie } from './languageHeaderUtils.js';\n\nexport type EssentialProperties = scripts.EssentialProperties;\nexport const MULTILINGUAL_COOKIE_HEADER_KEY = `wixLanguage`;\nexport interface WixLanguage {\n  languageCode?: string;\n}\n\nexport type LocalizationData = {\n  cleanUrl: string;\n  essentials: Essentials;\n};\n\nexport function getLocalizationData(\n  url: URL,\n  header: Headers,\n  siteProperties: EssentialProperties,\n): LocalizationData {\n  const availableLocales =\n    siteProperties?.multilingual?.supportedLanguages ?? [];\n  const explicitRequestedLocale = extractLanguageFromUrlAndValidate(\n    url,\n    availableLocales,\n  );\n\n  const languageCodes = [\n    ...availableLocales.map((locale) => locale.locale?.languageCode),\n    siteProperties?.locale?.languageCode,\n  ].filter((languageCode) => Boolean(languageCode)) as string[];\n\n  const locale =\n    buildLocaleString(\n      explicitRequestedLocale?.locale ??\n        calculateLocaleFromMultilingualCookie(header, availableLocales)\n          ?.locale ??\n        siteProperties?.locale,\n    ) ?? undefined;\n\n  const language =\n    explicitRequestedLocale?.languageCode ??\n    calculateLocaleFromMultilingualCookie(header, availableLocales)\n      ?.languageCode ??\n    siteProperties?.language ??\n    undefined;\n\n  const cleanUrl = clearLanguageFromUrl(url.href, languageCodes);\n\n  const essentials: Essentials = {\n    language,\n    locale,\n    multilingual: siteProperties?.multilingual as Multilingual | undefined,\n    timezone: siteProperties?.timeZone ?? undefined,\n  };\n\n  return { cleanUrl, essentials };\n}\n"],"mappings":"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","names":["locale"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/headless-localization-utils",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "unpkg": true,
   "license": "MIT",
   "author": {
@@ -44,7 +44,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@wix/headless-node": "1.22.0",
+    "@wix/headless-node": "1.23.0",
     "@wix/headless-site-assets": "^1.0.9"
   },
   "devDependencies": {
@@ -74,5 +74,5 @@
       ]
     }
   },
-  "falconPackageHash": "aa137c953b5dff655ba6dde097998dcfb6e06e582869beb1ea6abf51"
+  "falconPackageHash": "a897f873c70cd942f726a736161c2126fb69392c9ca303c30a79687e"
 }