@lucaapp/service-utils 5.1.1 → 5.3.0

package/dist/lib/iso3166/iso3166Mapping.d.ts

@@ -4,6 +4,16 @@
  * Use this for accurate language detection and future language support planning
  * https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
  */
+/**
+ * Mapping of ISO 3166-1 alpha-2 country codes to their ACTUAL primary language
+ * COUNTRY_TO_LANGUAGE_MAP[countryCode] = languageCode
+ * @example
+ * ```typescript
+ * COUNTRY_TO_LANGUAGE_MAP['DE'] // returns 'de'
+ * COUNTRY_TO_LANGUAGE_MAP['FR'] // returns 'fr'
+ * COUNTRY_TO_LANGUAGE_MAP['US'] // returns 'en'
+ * ```
+ */
 export declare const COUNTRY_TO_LANGUAGE_MAP: Record<string, string>;
 /**
  * Gets the ACTUAL primary language for a given country code
@@ -68,8 +78,114 @@ export declare const getLocaleFromCountry: (countryCode?: string | null) => stri
 /**
  * Comprehensive mapping of language codes to their English names
  * Includes currently supported languages and potential future additions
+ * @example
+ * ```typescript
+ * ENGLISH_LANGUAGE_NAMES['de'] // returns 'German'
+ * ENGLISH_LANGUAGE_NAMES['en'] // returns 'English'
+ * ENGLISH_LANGUAGE_NAMES['fr'] // returns 'French'
+ * ```
+ */
+export declare const ENGLISH_LANGUAGE_NAMES: {
+    de: string;
+    en: string;
+    fr: string;
+    it: string;
+    es: string;
+    nl: string;
+    pl: string;
+    cs: string;
+    hu: string;
+    hr: string;
+    ro: string;
+    el: string;
+    pt: string;
+    ar: string;
+    zh: string;
+    ja: string;
+    ko: string;
+    ru: string;
+    tr: string;
+    hi: string;
+    sv: string;
+    no: string;
+    da: string;
+    fi: string;
+    uk: string;
+    he: string;
+    th: string;
+    vi: string;
+    id: string;
+    ms: string;
+    tl: string;
+    is: string;
+    et: string;
+    lv: string;
+    lt: string;
+    sk: string;
+    sl: string;
+    sq: string;
+    mk: string;
+    sr: string;
+    bs: string;
+    bg: string;
+    be: string;
+    mt: string;
+    ga: string;
+    cy: string;
+    gd: string;
+    fo: string;
+    lb: string;
+    bn: string;
+    ur: string;
+    fa: string;
+    ps: string;
+    ku: string;
+    hy: string;
+    ka: string;
+    az: string;
+    kk: string;
+    uz: string;
+    tk: string;
+    ky: string;
+    tg: string;
+    mn: string;
+    km: string;
+    lo: string;
+    my: string;
+    ne: string;
+    si: string;
+    ta: string;
+    dv: string;
+    dz: string;
+    sw: string;
+    am: string;
+    ti: string;
+    so: string;
+    ha: string;
+    yo: string;
+    ig: string;
+    zu: string;
+    xh: string;
+    af: string;
+    mg: string;
+    mi: string;
+    sm: string;
+    to: string;
+    fj: string;
+    ht: string;
+};
+/**
+ * Type representing all supported language codes (ISO 639-1)
+ * This includes all languages that are mapped in the system, providing comprehensive language code support
+ * Use this type instead of InternalLanguages for broader language support
+ * @example
+ * ```typescript
+ * const langName: string = ENGLISH_LANGUAGE_NAMES['de']; // returns 'German'
+ * const langName2: string = ENGLISH_LANGUAGE_NAMES['en']; // returns 'English'
+ * const langName3: string = ENGLISH_LANGUAGE_NAMES['fr']; // returns 'French'
+ * ```
  */
-export declare const ENGLISH_LANGUAGE_NAMES: Record<string, string>;
+export type LanguageCode = keyof typeof ENGLISH_LANGUAGE_NAMES;
 /**
  * Gets the language name in English for a given language code
  *
@@ -82,7 +198,7 @@ export declare const ENGLISH_LANGUAGE_NAMES: Record<string, string>;
  * getLanguageName('fr') // returns 'French'
  * ```
  */
-export declare const getLanguageName: (lang: string) => string | undefined;
+export declare const getLanguageName: (lang: LanguageCode) => (typeof ENGLISH_LANGUAGE_NAMES)[LanguageCode];
 /**
  * Comprehensive mapping of language codes to their native names
  * Includes currently supported languages and potential future additions

package/dist/lib/iso3166/iso3166Mapping.js

@@ -1,12 +1,22 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCountryName = exports.COUNTRY_NAMES = exports.getNativeLanguageName = exports.NATIVE_LANGUAGE_NAMES = exports.getLanguageName = exports.ENGLISH_LANGUAGE_NAMES = exports.getLocaleFromCountry = exports.getLocalesFromCountry = exports.COUNTRY_TO_LOCALES_MAP = exports.getLanguageFromCountry = exports.COUNTRY_TO_LANGUAGE_MAP = void 0;
 /**
  * Comprehensive mapping of ISO 3166-1 alpha-2 country codes to their ACTUAL primary language
  * This maps each country to its real primary language, regardless of whether we support it
  * Use this for accurate language detection and future language support planning
  * https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
  */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCountryName = exports.COUNTRY_NAMES = exports.getNativeLanguageName = exports.NATIVE_LANGUAGE_NAMES = exports.getLanguageName = exports.ENGLISH_LANGUAGE_NAMES = exports.getLocaleFromCountry = exports.getLocalesFromCountry = exports.COUNTRY_TO_LOCALES_MAP = exports.getLanguageFromCountry = exports.COUNTRY_TO_LANGUAGE_MAP = void 0;
+/**
+ * Mapping of ISO 3166-1 alpha-2 country codes to their ACTUAL primary language
+ * COUNTRY_TO_LANGUAGE_MAP[countryCode] = languageCode
+ * @example
+ * ```typescript
+ * COUNTRY_TO_LANGUAGE_MAP['DE'] // returns 'de'
+ * COUNTRY_TO_LANGUAGE_MAP['FR'] // returns 'fr'
+ * COUNTRY_TO_LANGUAGE_MAP['US'] // returns 'en'
+ * ```
+ */
 exports.COUNTRY_TO_LANGUAGE_MAP = {
     // Europe
     AD: 'ca', // Andorra - Catalan
@@ -483,6 +493,12 @@ exports.getLocaleFromCountry = getLocaleFromCountry;
 /**
  * Comprehensive mapping of language codes to their English names
  * Includes currently supported languages and potential future additions
+ * @example
+ * ```typescript
+ * ENGLISH_LANGUAGE_NAMES['de'] // returns 'German'
+ * ENGLISH_LANGUAGE_NAMES['en'] // returns 'English'
+ * ENGLISH_LANGUAGE_NAMES['fr'] // returns 'French'
+ * ```
  */
 exports.ENGLISH_LANGUAGE_NAMES = {
     de: 'German',
@@ -537,7 +553,7 @@ exports.ENGLISH_LANGUAGE_NAMES = {
     gd: 'Scottish Gaelic',
     fo: 'Faroese',
     lb: 'Luxembourgish',
-    //  Asian & Middle Eastern Languages
+    // Asian & Middle Eastern Languages
     bn: 'Bengali',
     ur: 'Urdu',
     fa: 'Persian',
@@ -593,7 +609,7 @@ exports.ENGLISH_LANGUAGE_NAMES = {
  * ```
  */
 const getLanguageName = (lang) => {
-    return exports.ENGLISH_LANGUAGE_NAMES[lang.toLowerCase()] || undefined;
+    return exports.ENGLISH_LANGUAGE_NAMES[lang];
 };
 exports.getLanguageName = getLanguageName;
 /**
@@ -613,7 +629,7 @@ exports.NATIVE_LANGUAGE_NAMES = {
     hr: 'Hrvatski', // Croatian
     ro: 'Română', // Romanian
     el: 'Ελληνικά', // Greek
-    // High Priority - Phase 2 (8 languages)
+    // Additional
     pt: 'Português', // Portuguese
     ar: 'العربية', // Arabic
     zh: '中文', // Chinese
@@ -622,14 +638,14 @@ exports.NATIVE_LANGUAGE_NAMES = {
     ru: 'Русский', // Russian
     tr: 'Türkçe', // Turkish
     hi: 'हिन्दी', // Hindi
-    // Medium Priority - Phase 3 (Nordic & Regional)
+    // Nordic & Regional
     sv: 'Svenska', // Swedish
     no: 'Norsk', // Norwegian
     da: 'Dansk', // Danish
     fi: 'Suomi', // Finnish
     uk: 'Українська', // Ukrainian
     he: 'עברית', // Hebrew
-    // Medium Priority - Phase 4 (Asian Markets)
+    // Asian Markets
     th: 'ไทย', // Thai
     vi: 'Tiếng Việt', // Vietnamese
     id: 'Bahasa Indonesia', // Indonesian

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucaapp/service-utils",
-  "version": "5.1.1",
+  "version": "5.3.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [