@nlabs/reaktor 0.10.5 → 0.10.7

package/lib/utils/languageDetection.d.ts

@@ -6,3 +6,4 @@ export interface LanguageDetectionContext {
     userPreference?: Locale;
 }
 export declare const detectLanguage: (context: LanguageDetectionContext) => Locale;
+//# sourceMappingURL=languageDetection.d.ts.map

package/lib/utils/languageDetection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"languageDetection.d.ts","sourceRoot":"","sources":["../../src/utils/languageDetection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,2BAA2B,CAAC;AAEtD,MAAM,WAAW,wBAAwB;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAiFD,eAAO,MAAM,cAAc,GAAI,SAAS,wBAAwB,KAAG,MA2BlE,CAAC"}

package/lib/utils/languageDetection.js

@@ -0,0 +1,120 @@
+const countryToLocaleMap = {
+    AR: 'es',
+    AU: 'en',
+    BE: 'fr',
+    BO: 'es',
+    BR: 'pt',
+    CA: 'en',
+    CL: 'es',
+    CO: 'es',
+    CR: 'es',
+    CU: 'es',
+    CV: 'pt',
+    DO: 'es',
+    EC: 'es',
+    ES: 'es',
+    FR: 'fr',
+    GB: 'en',
+    GQ: 'es',
+    GT: 'es',
+    GW: 'pt',
+    HN: 'es',
+    IT: 'it',
+    LI: 'de',
+    LU: 'fr',
+    MC: 'fr',
+    MX: 'es',
+    MZ: 'pt',
+    NI: 'es',
+    PA: 'es',
+    PE: 'es',
+    PY: 'es',
+    SM: 'it',
+    SV: 'es',
+    TL: 'pt',
+    US: 'en',
+    VA: 'it',
+    VE: 'es'
+};
+const phoneCodeToLocaleMap = {
+    1: 'en',
+    32: 'fr',
+    33: 'fr',
+    34: 'es',
+    39: 'it',
+    41: 'fr',
+    43: 'de',
+    49: 'de',
+    51: 'es',
+    52: 'es',
+    53: 'es',
+    54: 'es',
+    55: 'pt',
+    56: 'es',
+    57: 'es',
+    58: 'es',
+    240: 'es',
+    244: 'pt',
+    245: 'pt',
+    258: 'pt',
+    351: 'pt',
+    352: 'fr',
+    377: 'fr',
+    378: 'it',
+    379: 'it',
+    423: 'de',
+    502: 'es',
+    503: 'es',
+    504: 'es',
+    505: 'es',
+    506: 'es',
+    507: 'es',
+    591: 'es',
+    593: 'es',
+    595: 'es',
+    670: 'pt',
+    1809: 'es'
+};
+export const detectLanguage = (context)=>{
+    if (context.userPreference) {
+        return context.userPreference;
+    }
+    if (context.phoneCountryCode) {
+        const locale = phoneCodeToLocaleMap[context.phoneCountryCode];
+        if (locale) {
+            return locale;
+        }
+    }
+    if (context.acceptLanguage) {
+        const locale = parseAcceptLanguage(context.acceptLanguage);
+        if (locale) {
+            return locale;
+        }
+    }
+    if (context.ipCountry) {
+        const locale = countryToLocaleMap[context.ipCountry];
+        if (locale) {
+            return locale;
+        }
+    }
+    return 'en';
+};
+const parseAcceptLanguage = (acceptLanguage)=>{
+    const languages = acceptLanguage.split(',').map((lang)=>lang.trim().split(';')[0]).filter((lang)=>lang.length >= 2);
+    for (const lang of languages){
+        const locale = lang.substring(0, 2);
+        if ([
+            'en',
+            'es',
+            'fr',
+            'de',
+            'pt',
+            'it'
+        ].includes(locale)) {
+            return locale;
+        }
+    }
+    return null;
+};
+
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi9Vc2Vycy9uaXRyb2c3L0RldmVsb3BtZW50L3JlYWt0b3Ivc3JjL3V0aWxzL2xhbmd1YWdlRGV0ZWN0aW9uLnRzIl0sInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB0eXBlIHtMb2NhbGV9IGZyb20gJy4uL3R5cGVzL2NvbnRlbnQudHlwZXMuanMnO1xuXG5leHBvcnQgaW50ZXJmYWNlIExhbmd1YWdlRGV0ZWN0aW9uQ29udGV4dCB7XG4gIGFjY2VwdExhbmd1YWdlPzogc3RyaW5nO1xuICBpcENvdW50cnk/OiBzdHJpbmc7XG4gIHBob25lQ291bnRyeUNvZGU/OiBzdHJpbmc7XG4gIHVzZXJQcmVmZXJlbmNlPzogTG9jYWxlO1xufVxuXG5jb25zdCBjb3VudHJ5VG9Mb2NhbGVNYXA6IFJlY29yZDxzdHJpbmcsIExvY2FsZT4gPSB7XG4gIEFSOiAnZXMnLFxuICBBVTogJ2VuJyxcbiAgQkU6ICdmcicsXG4gIEJPOiAnZXMnLFxuICBCUjogJ3B0JyxcbiAgQ0E6ICdlbicsXG4gIENMOiAnZXMnLFxuICBDTzogJ2VzJyxcbiAgQ1I6ICdlcycsXG4gIENVOiAnZXMnLFxuICBDVjogJ3B0JyxcbiAgRE86ICdlcycsXG4gIEVDOiAnZXMnLFxuICBFUzogJ2VzJyxcbiAgRlI6ICdmcicsXG4gIEdCOiAnZW4nLFxuICBHUTogJ2VzJyxcbiAgR1Q6ICdlcycsXG4gIEdXOiAncHQnLFxuICBITjogJ2VzJyxcbiAgSVQ6ICdpdCcsXG4gIExJOiAnZGUnLFxuICBMVTogJ2ZyJyxcbiAgTUM6ICdmcicsXG4gIE1YOiAnZXMnLFxuICBNWjogJ3B0JyxcbiAgTkk6ICdlcycsXG4gIFBBOiAnZXMnLFxuICBQRTogJ2VzJyxcbiAgUFk6ICdlcycsXG4gIFNNOiAnaXQnLFxuICBTVjogJ2VzJyxcbiAgVEw6ICdwdCcsXG4gIFVTOiAnZW4nLFxuICBWQTogJ2l0JyxcbiAgVkU6ICdlcydcbn07XG5cbmNvbnN0IHBob25lQ29kZVRvTG9jYWxlTWFwOiBSZWNvcmQ8c3RyaW5nLCBMb2NhbGU+ID0ge1xuICAxOiAnZW4nLFxuICAzMjogJ2ZyJyxcbiAgMzM6ICdmcicsXG4gIDM0OiAnZXMnLFxuICAzOTogJ2l0JyxcbiAgNDE6ICdmcicsXG4gIDQzOiAnZGUnLFxuICA0OTogJ2RlJyxcbiAgNTE6ICdlcycsXG4gIDUyOiAnZXMnLFxuICA1MzogJ2VzJyxcbiAgNTQ6ICdlcycsXG4gIDU1OiAncHQnLFxuICA1NjogJ2VzJyxcbiAgNTc6ICdlcycsXG4gIDU4OiAnZXMnLFxuICAyNDA6ICdlcycsXG4gIDI0NDogJ3B0JyxcbiAgMjQ1OiAncHQnLFxuICAyNTg6ICdwdCcsXG4gIDM1MTogJ3B0JyxcbiAgMzUyOiAnZnInLFxuICAzNzc6ICdmcicsXG4gIDM3ODogJ2l0JyxcbiAgMzc5OiAnaXQnLFxuICA0MjM6ICdkZScsXG4gIDUwMjogJ2VzJyxcbiAgNTAzOiAnZXMnLFxuICA1MDQ6ICdlcycsXG4gIDUwNTogJ2VzJyxcbiAgNTA2OiAnZXMnLFxuICA1MDc6ICdlcycsXG4gIDU5MTogJ2VzJyxcbiAgNTkzOiAnZXMnLFxuICA1OTU6ICdlcycsXG4gIDY3MDogJ3B0JyxcbiAgMTgwOTogJ2VzJ1xufTtcblxuZXhwb3J0IGNvbnN0IGRldGVjdExhbmd1YWdlID0gKGNvbnRleHQ6IExhbmd1YWdlRGV0ZWN0aW9uQ29udGV4dCk6IExvY2FsZSA9PiB7XG4gIGlmKGNvbnRleHQudXNlclByZWZlcmVuY2UpIHtcbiAgICByZXR1cm4gY29udGV4dC51c2VyUHJlZmVyZW5jZTtcbiAgfVxuXG4gIGlmKGNvbnRleHQucGhvbmVDb3VudHJ5Q29kZSkge1xuICAgIGNvbnN0IGxvY2FsZSA9IHBob25lQ29kZVRvTG9jYWxlTWFwW2NvbnRleHQucGhvbmVDb3VudHJ5Q29kZV07XG4gICAgaWYobG9jYWxlKSB7XG4gICAgICByZXR1cm4gbG9jYWxlO1xuICAgIH1cbiAgfVxuXG4gIGlmKGNvbnRleHQuYWNjZXB0TGFuZ3VhZ2UpIHtcbiAgICBjb25zdCBsb2NhbGUgPSBwYXJzZUFjY2VwdExhbmd1YWdlKGNvbnRleHQuYWNjZXB0TGFuZ3VhZ2UpO1xuICAgIGlmKGxvY2FsZSkge1xuICAgICAgcmV0dXJuIGxvY2FsZTtcbiAgICB9XG4gIH1cblxuICBpZihjb250ZXh0LmlwQ291bnRyeSkge1xuICAgIGNvbnN0IGxvY2FsZSA9IGNvdW50cnlUb0xvY2FsZU1hcFtjb250ZXh0LmlwQ291bnRyeV07XG4gICAgaWYobG9jYWxlKSB7XG4gICAgICByZXR1cm4gbG9jYWxlO1xuICAgIH1cbiAgfVxuXG4gIHJldHVybiAnZW4nO1xufTtcblxuY29uc3QgcGFyc2VBY2NlcHRMYW5ndWFnZSA9IChhY2NlcHRMYW5ndWFnZTogc3RyaW5nKTogTG9jYWxlIHwgbnVsbCA9PiB7XG4gIGNvbnN0IGxhbmd1YWdlcyA9IGFjY2VwdExhbmd1YWdlXG4gICAgLnNwbGl0KCcsJylcbiAgICAubWFwKChsYW5nKSA9PiBsYW5nLnRyaW0oKS5zcGxpdCgnOycpWzBdKVxuICAgIC5maWx0ZXIoKGxhbmcpID0+IGxhbmcubGVuZ3RoID49IDIpO1xuXG4gIGZvcihjb25zdCBsYW5nIG9mIGxhbmd1YWdlcykge1xuICAgIGNvbnN0IGxvY2FsZSA9IGxhbmcuc3Vic3RyaW5nKDAsIDIpIGFzIExvY2FsZTtcbiAgICBpZihbJ2VuJywgJ2VzJywgJ2ZyJywgJ2RlJywgJ3B0JywgJ2l0J10uaW5jbHVkZXMobG9jYWxlKSkge1xuICAgICAgcmV0dXJuIGxvY2FsZTtcbiAgICB9XG4gIH1cblxuICByZXR1cm4gbnVsbDtcbn07Il0sIm5hbWVzIjpbImNvdW50cnlUb0xvY2FsZU1hcCIsIkFSIiwiQVUiLCJCRSIsIkJPIiwiQlIiLCJDQSIsIkNMIiwiQ08iLCJDUiIsIkNVIiwiQ1YiLCJETyIsIkVDIiwiRVMiLCJGUiIsIkdCIiwiR1EiLCJHVCIsIkdXIiwiSE4iLCJJVCIsIkxJIiwiTFUiLCJNQyIsIk1YIiwiTVoiLCJOSSIsIlBBIiwiUEUiLCJQWSIsIlNNIiwiU1YiLCJUTCIsIlVTIiwiVkEiLCJWRSIsInBob25lQ29kZVRvTG9jYWxlTWFwIiwiZGV0ZWN0TGFuZ3VhZ2UiLCJjb250ZXh0IiwidXNlclByZWZlcmVuY2UiLCJwaG9uZUNvdW50cnlDb2RlIiwibG9jYWxlIiwiYWNjZXB0TGFuZ3VhZ2UiLCJwYXJzZUFjY2VwdExhbmd1YWdlIiwiaXBDb3VudHJ5IiwibGFuZ3VhZ2VzIiwic3BsaXQiLCJtYXAiLCJsYW5nIiwidHJpbSIsImZpbHRlciIsImxlbmd0aCIsInN1YnN0cmluZyIsImluY2x1ZGVzIl0sIm1hcHBpbmdzIjoiQUFTQSxNQUFNQSxxQkFBNkM7SUFDakRDLElBQUk7SUFDSkMsSUFBSTtJQUNKQyxJQUFJO0lBQ0pDLElBQUk7SUFDSkMsSUFBSTtJQUNKQyxJQUFJO0lBQ0pDLElBQUk7SUFDSkMsSUFBSTtJQUNKQyxJQUFJO0lBQ0pDLElBQUk7SUFDSkMsSUFBSTtJQUNKQyxJQUFJO0lBQ0pDLElBQUk7SUFDSkMsSUFBSTtJQUNKQyxJQUFJO0lBQ0pDLElBQUk7SUFDSkMsSUFBSTtJQUNKQyxJQUFJO0lBQ0pDLElBQUk7SUFDSkMsSUFBSTtJQUNKQyxJQUFJO0lBQ0pDLElBQUk7SUFDSkMsSUFBSTtJQUNKQyxJQUFJO0lBQ0pDLElBQUk7SUFDSkMsSUFBSTtJQUNKQyxJQUFJO0lBQ0pDLElBQUk7SUFDSkMsSUFBSTtJQUNKQyxJQUFJO0lBQ0pDLElBQUk7SUFDSkMsSUFBSTtJQUNKQyxJQUFJO0lBQ0pDLElBQUk7SUFDSkMsSUFBSTtJQUNKQyxJQUFJO0FBQ047QUFFQSxNQUFNQyx1QkFBK0M7SUFDbkQsR0FBRztJQUNILElBQUk7SUFDSixJQUFJO0lBQ0osSUFBSTtJQUNKLElBQUk7SUFDSixJQUFJO0lBQ0osSUFBSTtJQUNKLElBQUk7SUFDSixJQUFJO0lBQ0osSUFBSTtJQUNKLElBQUk7SUFDSixJQUFJO0lBQ0osSUFBSTtJQUNKLElBQUk7SUFDSixJQUFJO0lBQ0osSUFBSTtJQUNKLEtBQUs7SUFDTCxLQUFLO0lBQ0wsS0FBSztJQUNMLEtBQUs7SUFDTCxLQUFLO0lBQ0wsS0FBSztJQUNMLEtBQUs7SUFDTCxLQUFLO0lBQ0wsS0FBSztJQUNMLEtBQUs7SUFDTCxLQUFLO0lBQ0wsS0FBSztJQUNMLEtBQUs7SUFDTCxLQUFLO0lBQ0wsS0FBSztJQUNMLEtBQUs7SUFDTCxLQUFLO0lBQ0wsS0FBSztJQUNMLEtBQUs7SUFDTCxLQUFLO0lBQ0wsTUFBTTtBQUNSO0FBRUEsT0FBTyxNQUFNQyxpQkFBaUIsQ0FBQ0M7SUFDN0IsSUFBR0EsUUFBUUMsY0FBYyxFQUFFO1FBQ3pCLE9BQU9ELFFBQVFDLGNBQWM7SUFDL0I7SUFFQSxJQUFHRCxRQUFRRSxnQkFBZ0IsRUFBRTtRQUMzQixNQUFNQyxTQUFTTCxvQkFBb0IsQ0FBQ0UsUUFBUUUsZ0JBQWdCLENBQUM7UUFDN0QsSUFBR0MsUUFBUTtZQUNULE9BQU9BO1FBQ1Q7SUFDRjtJQUVBLElBQUdILFFBQVFJLGNBQWMsRUFBRTtRQUN6QixNQUFNRCxTQUFTRSxvQkFBb0JMLFFBQVFJLGNBQWM7UUFDekQsSUFBR0QsUUFBUTtZQUNULE9BQU9BO1FBQ1Q7SUFDRjtJQUVBLElBQUdILFFBQVFNLFNBQVMsRUFBRTtRQUNwQixNQUFNSCxTQUFTMUMsa0JBQWtCLENBQUN1QyxRQUFRTSxTQUFTLENBQUM7UUFDcEQsSUFBR0gsUUFBUTtZQUNULE9BQU9BO1FBQ1Q7SUFDRjtJQUVBLE9BQU87QUFDVCxFQUFFO0FBRUYsTUFBTUUsc0JBQXNCLENBQUNEO0lBQzNCLE1BQU1HLFlBQVlILGVBQ2ZJLEtBQUssQ0FBQyxLQUNOQyxHQUFHLENBQUMsQ0FBQ0MsT0FBU0EsS0FBS0MsSUFBSSxHQUFHSCxLQUFLLENBQUMsSUFBSSxDQUFDLEVBQUUsRUFDdkNJLE1BQU0sQ0FBQyxDQUFDRixPQUFTQSxLQUFLRyxNQUFNLElBQUk7SUFFbkMsS0FBSSxNQUFNSCxRQUFRSCxVQUFXO1FBQzNCLE1BQU1KLFNBQVNPLEtBQUtJLFNBQVMsQ0FBQyxHQUFHO1FBQ2pDLElBQUc7WUFBQztZQUFNO1lBQU07WUFBTTtZQUFNO1lBQU07U0FBSyxDQUFDQyxRQUFRLENBQUNaLFNBQVM7WUFDeEQsT0FBT0E7UUFDVDtJQUNGO0lBRUEsT0FBTztBQUNUIn0=

package/lib/utils/localeUtils.d.ts

@@ -9,3 +9,4 @@ export declare const getFallbackChain: (locale: string) => string[];
 export declare const getPrimaryLanguages: () => string[];
 export declare const isValidLocale: (locale: string) => locale is Locale;
 export declare const getSupportedLocales: () => Locale[];
+//# sourceMappingURL=localeUtils.d.ts.map

package/lib/utils/localeUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localeUtils.d.ts","sourceRoot":"","sources":["../../src/utils/localeUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,2BAA2B,CAAC;AAEtD,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,MAA8B,CAAC;AAEhF,eAAO,MAAM,gBAAgB,GAAI,QAAQ,MAAM,KAAG,OAA+B,CAAC;AAElF,eAAO,MAAM,gBAAgB,GAAI,QAAQ,MAAM,KAAG,MAAM,EAGvD,CAAC;AAEF,eAAO,MAAM,mBAAmB,QAAO,MAAM,EAA0C,CAAC;AAExF,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,KAAG,MAAM,IAAI,MAUxD,CAAC;AAEF,eAAO,MAAM,mBAAmB,QAAO,MAAM,EAO5C,CAAC"}

package/lib/utils/localeUtils.example.d.ts

@@ -3,3 +3,4 @@
  * Copyrights licensed under the MIT License. See the accompanying LICENSE file for terms.
  */
 export declare const runLocaleExamples: () => Promise<void>;
+//# sourceMappingURL=localeUtils.example.d.ts.map

package/lib/utils/localeUtils.example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localeUtils.example.d.ts","sourceRoot":"","sources":["../../src/utils/localeUtils.example.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiJH,eAAO,MAAM,iBAAiB,qBAW7B,CAAC"}

package/lib/utils/localeUtils.example.js

@@ -0,0 +1,124 @@
+/**
+ * Copyright (c) 2025-Present, Nitrogen Labs, Inc.
+ * Copyrights licensed under the MIT License. See the accompanying LICENSE file for terms.
+ */ import { extractLanguage, getFallbackChain, getPrimaryLanguages, getSupportedLocales, isRegionalLocale, isValidLocale } from './localeUtils.js';
+/**
+ * Example: Locale Utilities with Regional Support
+ *
+ * This example demonstrates how to use the locale utilities for handling
+ * regional locales (e.g., "en-us", "es-mx") with language extraction
+ * for translation APIs while maintaining full locale support for
+ * time, currency, and other regional formatting.
+ */ // Example 1: Language Extraction for Translation APIs
+console.log('=== Language Extraction Examples ===');
+console.log(extractLanguage('en-us')); // 'en'
+console.log(extractLanguage('es-mx')); // 'es'
+console.log(extractLanguage('fr-ca')); // 'fr'
+console.log(extractLanguage('en')); // 'en'
+// Example 2: Regional Locale Detection
+console.log('\n=== Regional Locale Detection ===');
+console.log(isRegionalLocale('en-us')); // true
+console.log(isRegionalLocale('es-mx')); // true
+console.log(isRegionalLocale('en')); // false
+console.log(isRegionalLocale('fr')); // false
+// Example 3: Fallback Chain Generation
+console.log('\n=== Fallback Chain Examples ===');
+console.log(getFallbackChain('en-us')); // ['en-us', 'en']
+console.log(getFallbackChain('es-mx')); // ['es-mx', 'es']
+console.log(getFallbackChain('fr-ca')); // ['fr-ca', 'fr']
+console.log(getFallbackChain('en')); // ['en']
+// Example 4: Translation API Integration
+const translateText = async (text, targetLocale, sourceLocale = 'en')=>{
+    // Extract language codes for translation API
+    const targetLanguage = extractLanguage(targetLocale);
+    const sourceLanguage = extractLanguage(sourceLocale);
+    console.log(`Translating from ${sourceLanguage} to ${targetLanguage}`);
+    console.log(`Full locales: ${sourceLocale} → ${targetLocale}`);
+    // Call translation API with language codes
+    // const result = await googleTranslateAPI.translate(text, targetLanguage, sourceLanguage);
+    return `[Translated: ${text}]`;
+};
+// Example 5: Database Storage Strategy
+const storeTranslation = async (key, content, locale)=>{
+    // Store with full locale for regional support
+    console.log(`Storing translation for key "${key}" with locale "${locale}"`);
+    // Database record would include:
+    // - key: "welcome_message"
+    // - locale: "en-us" (full locale with region)
+    // - content: "Welcome to our US site!"
+    return {
+        key,
+        locale,
+        content
+    };
+};
+// Example 6: Content Retrieval with Fallback
+const getContentWithFallback = async (key, requestedLocale)=>{
+    console.log(`\n=== Content Retrieval for "${key}" with locale "${requestedLocale}" ===`);
+    // 1. Try exact locale match first
+    console.log(`1. Trying exact match: ${requestedLocale}`);
+    // 2. If regional locale and no exact match, try language fallback
+    if (isRegionalLocale(requestedLocale)) {
+        const language = extractLanguage(requestedLocale);
+        console.log(`2. Trying language fallback: ${language}`);
+        // If found, store the regional version for future use
+        console.log(`3. Storing extracted content for ${requestedLocale}`);
+    }
+    // 3. If still no match, use app default locale
+    console.log('4. Falling back to app default locale');
+    return `[Content for ${key} in ${requestedLocale}]`;
+};
+// Example 7: Validation
+console.log('\n=== Locale Validation ===');
+console.log(isValidLocale('en-us')); // true
+console.log(isValidLocale('es-mx')); // true
+console.log(isValidLocale('invalid')); // false
+console.log(isValidLocale('en-xx')); // false
+// Example 8: Supported Locales
+console.log('\n=== Supported Locales ===');
+const supportedLocales = getSupportedLocales();
+console.log(`Total supported locales: ${supportedLocales.length}`);
+console.log('English variants:', supportedLocales.filter((l)=>l.startsWith('en')));
+console.log('Spanish variants:', supportedLocales.filter((l)=>l.startsWith('es')));
+// Example 9: Primary Languages
+console.log('\n=== Primary Languages ===');
+const primaryLanguages = getPrimaryLanguages();
+console.log('Primary languages:', primaryLanguages);
+// Example 10: Complete Workflow
+const completeTranslationWorkflow = async ()=>{
+    console.log('\n=== Complete Translation Workflow ===');
+    const key = 'welcome_message';
+    const userLocale = 'es-mx'; // User's full locale
+    const appLocale = 'en-us'; // App's default locale
+    // 1. Extract language for translation API
+    const userLanguage = extractLanguage(userLocale);
+    const appLanguage = extractLanguage(appLocale);
+    console.log(`User locale: ${userLocale} (language: ${userLanguage})`);
+    console.log(`App locale: ${appLocale} (language: ${appLanguage})`);
+    // 2. Check if we need translation
+    if (userLanguage !== appLanguage) {
+        console.log('Translation needed!');
+        // 3. Get source content (from app locale)
+        const sourceContent = await getContentWithFallback(key, appLocale);
+        // 4. Translate using language codes
+        const translatedContent = await translateText(sourceContent, userLanguage, appLanguage);
+        // 5. Store with full locale
+        await storeTranslation(key, translatedContent, userLocale);
+        console.log(`Translation complete: ${translatedContent}`);
+    } else {
+        console.log('No translation needed - same language');
+    }
+};
+// Run examples
+export const runLocaleExamples = async ()=>{
+    console.log('Locale Utilities Examples\n');
+    // Run synchronous examples
+    console.log('Synchronous examples completed above');
+    // Run async examples
+    await getContentWithFallback('welcome_message', 'es-mx');
+    await completeTranslationWorkflow();
+    console.log('\n=== Example Complete ===');
+}; // Uncomment to run examples
+ // runLocaleExamples();
+
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi9Vc2Vycy9uaXRyb2c3L0RldmVsb3BtZW50L3JlYWt0b3Ivc3JjL3V0aWxzL2xvY2FsZVV0aWxzLmV4YW1wbGUudHMiXSwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBDb3B5cmlnaHQgKGMpIDIwMjUtUHJlc2VudCwgTml0cm9nZW4gTGFicywgSW5jLlxuICogQ29weXJpZ2h0cyBsaWNlbnNlZCB1bmRlciB0aGUgTUlUIExpY2Vuc2UuIFNlZSB0aGUgYWNjb21wYW55aW5nIExJQ0VOU0UgZmlsZSBmb3IgdGVybXMuXG4gKi9cblxuaW1wb3J0IHtcbiAgZXh0cmFjdExhbmd1YWdlLFxuICBnZXRGYWxsYmFja0NoYWluLFxuICBnZXRQcmltYXJ5TGFuZ3VhZ2VzLFxuICBnZXRTdXBwb3J0ZWRMb2NhbGVzLFxuICBpc1JlZ2lvbmFsTG9jYWxlLFxuICBpc1ZhbGlkTG9jYWxlXG59IGZyb20gJy4vbG9jYWxlVXRpbHMuanMnO1xuXG4vKipcbiAqIEV4YW1wbGU6IExvY2FsZSBVdGlsaXRpZXMgd2l0aCBSZWdpb25hbCBTdXBwb3J0XG4gKlxuICogVGhpcyBleGFtcGxlIGRlbW9uc3RyYXRlcyBob3cgdG8gdXNlIHRoZSBsb2NhbGUgdXRpbGl0aWVzIGZvciBoYW5kbGluZ1xuICogcmVnaW9uYWwgbG9jYWxlcyAoZS5nLiwgXCJlbi11c1wiLCBcImVzLW14XCIpIHdpdGggbGFuZ3VhZ2UgZXh0cmFjdGlvblxuICogZm9yIHRyYW5zbGF0aW9uIEFQSXMgd2hpbGUgbWFpbnRhaW5pbmcgZnVsbCBsb2NhbGUgc3VwcG9ydCBmb3JcbiAqIHRpbWUsIGN1cnJlbmN5LCBhbmQgb3RoZXIgcmVnaW9uYWwgZm9ybWF0dGluZy5cbiAqL1xuXG4vLyBFeGFtcGxlIDE6IExhbmd1YWdlIEV4dHJhY3Rpb24gZm9yIFRyYW5zbGF0aW9uIEFQSXNcbmNvbnNvbGUubG9nKCc9PT0gTGFuZ3VhZ2UgRXh0cmFjdGlvbiBFeGFtcGxlcyA9PT0nKTtcbmNvbnNvbGUubG9nKGV4dHJhY3RMYW5ndWFnZSgnZW4tdXMnKSk7IC8vICdlbidcbmNvbnNvbGUubG9nKGV4dHJhY3RMYW5ndWFnZSgnZXMtbXgnKSk7IC8vICdlcydcbmNvbnNvbGUubG9nKGV4dHJhY3RMYW5ndWFnZSgnZnItY2EnKSk7IC8vICdmcidcbmNvbnNvbGUubG9nKGV4dHJhY3RMYW5ndWFnZSgnZW4nKSk7IC8vICdlbidcblxuLy8gRXhhbXBsZSAyOiBSZWdpb25hbCBMb2NhbGUgRGV0ZWN0aW9uXG5jb25zb2xlLmxvZygnXFxuPT09IFJlZ2lvbmFsIExvY2FsZSBEZXRlY3Rpb24gPT09Jyk7XG5jb25zb2xlLmxvZyhpc1JlZ2lvbmFsTG9jYWxlKCdlbi11cycpKTsgLy8gdHJ1ZVxuY29uc29sZS5sb2coaXNSZWdpb25hbExvY2FsZSgnZXMtbXgnKSk7IC8vIHRydWVcbmNvbnNvbGUubG9nKGlzUmVnaW9uYWxMb2NhbGUoJ2VuJykpOyAvLyBmYWxzZVxuY29uc29sZS5sb2coaXNSZWdpb25hbExvY2FsZSgnZnInKSk7IC8vIGZhbHNlXG5cbi8vIEV4YW1wbGUgMzogRmFsbGJhY2sgQ2hhaW4gR2VuZXJhdGlvblxuY29uc29sZS5sb2coJ1xcbj09PSBGYWxsYmFjayBDaGFpbiBFeGFtcGxlcyA9PT0nKTtcbmNvbnNvbGUubG9nKGdldEZhbGxiYWNrQ2hhaW4oJ2VuLXVzJykpOyAvLyBbJ2VuLXVzJywgJ2VuJ11cbmNvbnNvbGUubG9nKGdldEZhbGxiYWNrQ2hhaW4oJ2VzLW14JykpOyAvLyBbJ2VzLW14JywgJ2VzJ11cbmNvbnNvbGUubG9nKGdldEZhbGxiYWNrQ2hhaW4oJ2ZyLWNhJykpOyAvLyBbJ2ZyLWNhJywgJ2ZyJ11cbmNvbnNvbGUubG9nKGdldEZhbGxiYWNrQ2hhaW4oJ2VuJykpOyAvLyBbJ2VuJ11cblxuLy8gRXhhbXBsZSA0OiBUcmFuc2xhdGlvbiBBUEkgSW50ZWdyYXRpb25cbmNvbnN0IHRyYW5zbGF0ZVRleHQgPSBhc3luYyAodGV4dDogc3RyaW5nLCB0YXJnZXRMb2NhbGU6IHN0cmluZywgc291cmNlTG9jYWxlOiBzdHJpbmcgPSAnZW4nKSA9PiB7XG4gIC8vIEV4dHJhY3QgbGFuZ3VhZ2UgY29kZXMgZm9yIHRyYW5zbGF0aW9uIEFQSVxuICBjb25zdCB0YXJnZXRMYW5ndWFnZSA9IGV4dHJhY3RMYW5ndWFnZSh0YXJnZXRMb2NhbGUpO1xuICBjb25zdCBzb3VyY2VMYW5ndWFnZSA9IGV4dHJhY3RMYW5ndWFnZShzb3VyY2VMb2NhbGUpO1xuXG4gIGNvbnNvbGUubG9nKGBUcmFuc2xhdGluZyBmcm9tICR7c291cmNlTGFuZ3VhZ2V9IHRvICR7dGFyZ2V0TGFuZ3VhZ2V9YCk7XG4gIGNvbnNvbGUubG9nKGBGdWxsIGxvY2FsZXM6ICR7c291cmNlTG9jYWxlfSDihpIgJHt0YXJnZXRMb2NhbGV9YCk7XG5cbiAgLy8gQ2FsbCB0cmFuc2xhdGlvbiBBUEkgd2l0aCBsYW5ndWFnZSBjb2Rlc1xuICAvLyBjb25zdCByZXN1bHQgPSBhd2FpdCBnb29nbGVUcmFuc2xhdGVBUEkudHJhbnNsYXRlKHRleHQsIHRhcmdldExhbmd1YWdlLCBzb3VyY2VMYW5ndWFnZSk7XG5cbiAgcmV0dXJuIGBbVHJhbnNsYXRlZDogJHt0ZXh0fV1gO1xufTtcblxuLy8gRXhhbXBsZSA1OiBEYXRhYmFzZSBTdG9yYWdlIFN0cmF0ZWd5XG5jb25zdCBzdG9yZVRyYW5zbGF0aW9uID0gYXN5bmMgKGtleTogc3RyaW5nLCBjb250ZW50OiBzdHJpbmcsIGxvY2FsZTogc3RyaW5nKSA9PiB7XG4gIC8vIFN0b3JlIHdpdGggZnVsbCBsb2NhbGUgZm9yIHJlZ2lvbmFsIHN1cHBvcnRcbiAgY29uc29sZS5sb2coYFN0b3JpbmcgdHJhbnNsYXRpb24gZm9yIGtleSBcIiR7a2V5fVwiIHdpdGggbG9jYWxlIFwiJHtsb2NhbGV9XCJgKTtcblxuICAvLyBEYXRhYmFzZSByZWNvcmQgd291bGQgaW5jbHVkZTpcbiAgLy8gLSBrZXk6IFwid2VsY29tZV9tZXNzYWdlXCJcbiAgLy8gLSBsb2NhbGU6IFwiZW4tdXNcIiAoZnVsbCBsb2NhbGUgd2l0aCByZWdpb24pXG4gIC8vIC0gY29udGVudDogXCJXZWxjb21lIHRvIG91ciBVUyBzaXRlIVwiXG5cbiAgcmV0dXJuIHtrZXksIGxvY2FsZSwgY29udGVudH07XG59O1xuXG4vLyBFeGFtcGxlIDY6IENvbnRlbnQgUmV0cmlldmFsIHdpdGggRmFsbGJhY2tcbmNvbnN0IGdldENvbnRlbnRXaXRoRmFsbGJhY2sgPSBhc3luYyAoa2V5OiBzdHJpbmcsIHJlcXVlc3RlZExvY2FsZTogc3RyaW5nKSA9PiB7XG4gIGNvbnNvbGUubG9nKGBcXG49PT0gQ29udGVudCBSZXRyaWV2YWwgZm9yIFwiJHtrZXl9XCIgd2l0aCBsb2NhbGUgXCIke3JlcXVlc3RlZExvY2FsZX1cIiA9PT1gKTtcblxuICAvLyAxLiBUcnkgZXhhY3QgbG9jYWxlIG1hdGNoIGZpcnN0XG4gIGNvbnNvbGUubG9nKGAxLiBUcnlpbmcgZXhhY3QgbWF0Y2g6ICR7cmVxdWVzdGVkTG9jYWxlfWApO1xuXG4gIC8vIDIuIElmIHJlZ2lvbmFsIGxvY2FsZSBhbmQgbm8gZXhhY3QgbWF0Y2gsIHRyeSBsYW5ndWFnZSBmYWxsYmFja1xuICBpZihpc1JlZ2lvbmFsTG9jYWxlKHJlcXVlc3RlZExvY2FsZSkpIHtcbiAgICBjb25zdCBsYW5ndWFnZSA9IGV4dHJhY3RMYW5ndWFnZShyZXF1ZXN0ZWRMb2NhbGUpO1xuICAgIGNvbnNvbGUubG9nKGAyLiBUcnlpbmcgbGFuZ3VhZ2UgZmFsbGJhY2s6ICR7bGFuZ3VhZ2V9YCk7XG5cbiAgICAvLyBJZiBmb3VuZCwgc3RvcmUgdGhlIHJlZ2lvbmFsIHZlcnNpb24gZm9yIGZ1dHVyZSB1c2VcbiAgICBjb25zb2xlLmxvZyhgMy4gU3RvcmluZyBleHRyYWN0ZWQgY29udGVudCBmb3IgJHtyZXF1ZXN0ZWRMb2NhbGV9YCk7XG4gIH1cblxuICAvLyAzLiBJZiBzdGlsbCBubyBtYXRjaCwgdXNlIGFwcCBkZWZhdWx0IGxvY2FsZVxuICBjb25zb2xlLmxvZygnNC4gRmFsbGluZyBiYWNrIHRvIGFwcCBkZWZhdWx0IGxvY2FsZScpO1xuXG4gIHJldHVybiBgW0NvbnRlbnQgZm9yICR7a2V5fSBpbiAke3JlcXVlc3RlZExvY2FsZX1dYDtcbn07XG5cbi8vIEV4YW1wbGUgNzogVmFsaWRhdGlvblxuY29uc29sZS5sb2coJ1xcbj09PSBMb2NhbGUgVmFsaWRhdGlvbiA9PT0nKTtcbmNvbnNvbGUubG9nKGlzVmFsaWRMb2NhbGUoJ2VuLXVzJykpOyAvLyB0cnVlXG5jb25zb2xlLmxvZyhpc1ZhbGlkTG9jYWxlKCdlcy1teCcpKTsgLy8gdHJ1ZVxuY29uc29sZS5sb2coaXNWYWxpZExvY2FsZSgnaW52YWxpZCcpKTsgLy8gZmFsc2VcbmNvbnNvbGUubG9nKGlzVmFsaWRMb2NhbGUoJ2VuLXh4JykpOyAvLyBmYWxzZVxuXG4vLyBFeGFtcGxlIDg6IFN1cHBvcnRlZCBMb2NhbGVzXG5jb25zb2xlLmxvZygnXFxuPT09IFN1cHBvcnRlZCBMb2NhbGVzID09PScpO1xuY29uc3Qgc3VwcG9ydGVkTG9jYWxlcyA9IGdldFN1cHBvcnRlZExvY2FsZXMoKTtcbmNvbnNvbGUubG9nKGBUb3RhbCBzdXBwb3J0ZWQgbG9jYWxlczogJHtzdXBwb3J0ZWRMb2NhbGVzLmxlbmd0aH1gKTtcbmNvbnNvbGUubG9nKCdFbmdsaXNoIHZhcmlhbnRzOicsIHN1cHBvcnRlZExvY2FsZXMuZmlsdGVyKChsKSA9PiBsLnN0YXJ0c1dpdGgoJ2VuJykpKTtcbmNvbnNvbGUubG9nKCdTcGFuaXNoIHZhcmlhbnRzOicsIHN1cHBvcnRlZExvY2FsZXMuZmlsdGVyKChsKSA9PiBsLnN0YXJ0c1dpdGgoJ2VzJykpKTtcblxuLy8gRXhhbXBsZSA5OiBQcmltYXJ5IExhbmd1YWdlc1xuY29uc29sZS5sb2coJ1xcbj09PSBQcmltYXJ5IExhbmd1YWdlcyA9PT0nKTtcbmNvbnN0IHByaW1hcnlMYW5ndWFnZXMgPSBnZXRQcmltYXJ5TGFuZ3VhZ2VzKCk7XG5jb25zb2xlLmxvZygnUHJpbWFyeSBsYW5ndWFnZXM6JywgcHJpbWFyeUxhbmd1YWdlcyk7XG5cbi8vIEV4YW1wbGUgMTA6IENvbXBsZXRlIFdvcmtmbG93XG5jb25zdCBjb21wbGV0ZVRyYW5zbGF0aW9uV29ya2Zsb3cgPSBhc3luYyAoKSA9PiB7XG4gIGNvbnNvbGUubG9nKCdcXG49PT0gQ29tcGxldGUgVHJhbnNsYXRpb24gV29ya2Zsb3cgPT09Jyk7XG5cbiAgY29uc3Qga2V5ID0gJ3dlbGNvbWVfbWVzc2FnZSc7XG4gIGNvbnN0IHVzZXJMb2NhbGUgPSAnZXMtbXgnOyAvLyBVc2VyJ3MgZnVsbCBsb2NhbGVcbiAgY29uc3QgYXBwTG9jYWxlID0gJ2VuLXVzJzsgLy8gQXBwJ3MgZGVmYXVsdCBsb2NhbGVcblxuICAvLyAxLiBFeHRyYWN0IGxhbmd1YWdlIGZvciB0cmFuc2xhdGlvbiBBUElcbiAgY29uc3QgdXNlckxhbmd1YWdlID0gZXh0cmFjdExhbmd1YWdlKHVzZXJMb2NhbGUpO1xuICBjb25zdCBhcHBMYW5ndWFnZSA9IGV4dHJhY3RMYW5ndWFnZShhcHBMb2NhbGUpO1xuXG4gIGNvbnNvbGUubG9nKGBVc2VyIGxvY2FsZTogJHt1c2VyTG9jYWxlfSAobGFuZ3VhZ2U6ICR7dXNlckxhbmd1YWdlfSlgKTtcbiAgY29uc29sZS5sb2coYEFwcCBsb2NhbGU6ICR7YXBwTG9jYWxlfSAobGFuZ3VhZ2U6ICR7YXBwTGFuZ3VhZ2V9KWApO1xuXG4gIC8vIDIuIENoZWNrIGlmIHdlIG5lZWQgdHJhbnNsYXRpb25cbiAgaWYodXNlckxhbmd1YWdlICE9PSBhcHBMYW5ndWFnZSkge1xuICAgIGNvbnNvbGUubG9nKCdUcmFuc2xhdGlvbiBuZWVkZWQhJyk7XG5cbiAgICAvLyAzLiBHZXQgc291cmNlIGNvbnRlbnQgKGZyb20gYXBwIGxvY2FsZSlcbiAgICBjb25zdCBzb3VyY2VDb250ZW50ID0gYXdhaXQgZ2V0Q29udGVudFdpdGhGYWxsYmFjayhrZXksIGFwcExvY2FsZSk7XG5cbiAgICAvLyA0LiBUcmFuc2xhdGUgdXNpbmcgbGFuZ3VhZ2UgY29kZXNcbiAgICBjb25zdCB0cmFuc2xhdGVkQ29udGVudCA9IGF3YWl0IHRyYW5zbGF0ZVRleHQoc291cmNlQ29udGVudCwgdXNlckxhbmd1YWdlLCBhcHBMYW5ndWFnZSk7XG5cbiAgICAvLyA1LiBTdG9yZSB3aXRoIGZ1bGwgbG9jYWxlXG4gICAgYXdhaXQgc3RvcmVUcmFuc2xhdGlvbihrZXksIHRyYW5zbGF0ZWRDb250ZW50LCB1c2VyTG9jYWxlKTtcblxuICAgIGNvbnNvbGUubG9nKGBUcmFuc2xhdGlvbiBjb21wbGV0ZTogJHt0cmFuc2xhdGVkQ29udGVudH1gKTtcbiAgfSBlbHNlIHtcbiAgICBjb25zb2xlLmxvZygnTm8gdHJhbnNsYXRpb24gbmVlZGVkIC0gc2FtZSBsYW5ndWFnZScpO1xuICB9XG59O1xuXG4vLyBSdW4gZXhhbXBsZXNcbmV4cG9ydCBjb25zdCBydW5Mb2NhbGVFeGFtcGxlcyA9IGFzeW5jICgpID0+IHtcbiAgY29uc29sZS5sb2coJ0xvY2FsZSBVdGlsaXRpZXMgRXhhbXBsZXNcXG4nKTtcblxuICAvLyBSdW4gc3luY2hyb25vdXMgZXhhbXBsZXNcbiAgY29uc29sZS5sb2coJ1N5bmNocm9ub3VzIGV4YW1wbGVzIGNvbXBsZXRlZCBhYm92ZScpO1xuXG4gIC8vIFJ1biBhc3luYyBleGFtcGxlc1xuICBhd2FpdCBnZXRDb250ZW50V2l0aEZhbGxiYWNrKCd3ZWxjb21lX21lc3NhZ2UnLCAnZXMtbXgnKTtcbiAgYXdhaXQgY29tcGxldGVUcmFuc2xhdGlvbldvcmtmbG93KCk7XG5cbiAgY29uc29sZS5sb2coJ1xcbj09PSBFeGFtcGxlIENvbXBsZXRlID09PScpO1xufTtcblxuLy8gVW5jb21tZW50IHRvIHJ1biBleGFtcGxlc1xuLy8gcnVuTG9jYWxlRXhhbXBsZXMoKTsiXSwibmFtZXMiOlsiZXh0cmFjdExhbmd1YWdlIiwiZ2V0RmFsbGJhY2tDaGFpbiIsImdldFByaW1hcnlMYW5ndWFnZXMiLCJnZXRTdXBwb3J0ZWRMb2NhbGVzIiwiaXNSZWdpb25hbExvY2FsZSIsImlzVmFsaWRMb2NhbGUiLCJjb25zb2xlIiwibG9nIiwidHJhbnNsYXRlVGV4dCIsInRleHQiLCJ0YXJnZXRMb2NhbGUiLCJzb3VyY2VMb2NhbGUiLCJ0YXJnZXRMYW5ndWFnZSIsInNvdXJjZUxhbmd1YWdlIiwic3RvcmVUcmFuc2xhdGlvbiIsImtleSIsImNvbnRlbnQiLCJsb2NhbGUiLCJnZXRDb250ZW50V2l0aEZhbGxiYWNrIiwicmVxdWVzdGVkTG9jYWxlIiwibGFuZ3VhZ2UiLCJzdXBwb3J0ZWRMb2NhbGVzIiwibGVuZ3RoIiwiZmlsdGVyIiwibCIsInN0YXJ0c1dpdGgiLCJwcmltYXJ5TGFuZ3VhZ2VzIiwiY29tcGxldGVUcmFuc2xhdGlvbldvcmtmbG93IiwidXNlckxvY2FsZSIsImFwcExvY2FsZSIsInVzZXJMYW5ndWFnZSIsImFwcExhbmd1YWdlIiwic291cmNlQ29udGVudCIsInRyYW5zbGF0ZWRDb250ZW50IiwicnVuTG9jYWxlRXhhbXBsZXMiXSwibWFwcGluZ3MiOiJBQUFBOzs7Q0FHQyxHQUVELFNBQ0VBLGVBQWUsRUFDZkMsZ0JBQWdCLEVBQ2hCQyxtQkFBbUIsRUFDbkJDLG1CQUFtQixFQUNuQkMsZ0JBQWdCLEVBQ2hCQyxhQUFhLFFBQ1IsbUJBQW1CO0FBRTFCOzs7Ozs7O0NBT0MsR0FFRCxzREFBc0Q7QUFDdERDLFFBQVFDLEdBQUcsQ0FBQztBQUNaRCxRQUFRQyxHQUFHLENBQUNQLGdCQUFnQixXQUFXLE9BQU87QUFDOUNNLFFBQVFDLEdBQUcsQ0FBQ1AsZ0JBQWdCLFdBQVcsT0FBTztBQUM5Q00sUUFBUUMsR0FBRyxDQUFDUCxnQkFBZ0IsV0FBVyxPQUFPO0FBQzlDTSxRQUFRQyxHQUFHLENBQUNQLGdCQUFnQixRQUFRLE9BQU87QUFFM0MsdUNBQXVDO0FBQ3ZDTSxRQUFRQyxHQUFHLENBQUM7QUFDWkQsUUFBUUMsR0FBRyxDQUFDSCxpQkFBaUIsV0FBVyxPQUFPO0FBQy9DRSxRQUFRQyxHQUFHLENBQUNILGlCQUFpQixXQUFXLE9BQU87QUFDL0NFLFFBQVFDLEdBQUcsQ0FBQ0gsaUJBQWlCLFFBQVEsUUFBUTtBQUM3Q0UsUUFBUUMsR0FBRyxDQUFD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

package/lib/utils/localeUtils.js

@@ -0,0 +1,71 @@
+/**
+ * Copyright (c) 2025-Present, Nitrogen Labs, Inc.
+ * Copyrights licensed under the MIT License. See the accompanying LICENSE file for terms.
+ */ export const extractLanguage = (locale)=>locale.split('-')[0];
+export const isRegionalLocale = (locale)=>locale.includes('-');
+export const getFallbackChain = (locale)=>{
+    const language = extractLanguage(locale);
+    return isRegionalLocale(locale) ? [
+        locale,
+        language
+    ] : [
+        locale
+    ];
+};
+export const getPrimaryLanguages = ()=>[
+        'en',
+        'es',
+        'fr',
+        'de',
+        'pt',
+        'it'
+    ];
+export const isValidLocale = (locale)=>{
+    const validLocales = [
+        'en',
+        'en-us',
+        'en-gb',
+        'en-ca',
+        'en-au',
+        'es',
+        'es-mx',
+        'es-es',
+        'es-ar',
+        'fr',
+        'fr-fr',
+        'fr-ca',
+        'de',
+        'de-de',
+        'de-at',
+        'pt',
+        'pt-br',
+        'pt-pt',
+        'it',
+        'it-it'
+    ];
+    return validLocales.includes(locale);
+};
+export const getSupportedLocales = ()=>[
+        'en',
+        'en-us',
+        'en-gb',
+        'en-ca',
+        'en-au',
+        'es',
+        'es-mx',
+        'es-es',
+        'es-ar',
+        'fr',
+        'fr-fr',
+        'fr-ca',
+        'de',
+        'de-de',
+        'de-at',
+        'pt',
+        'pt-br',
+        'pt-pt',
+        'it',
+        'it-it'
+    ];
+
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi9Vc2Vycy9uaXRyb2c3L0RldmVsb3BtZW50L3JlYWt0b3Ivc3JjL3V0aWxzL2xvY2FsZVV0aWxzLnRzIl0sInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQ29weXJpZ2h0IChjKSAyMDI1LVByZXNlbnQsIE5pdHJvZ2VuIExhYnMsIEluYy5cbiAqIENvcHlyaWdodHMgbGljZW5zZWQgdW5kZXIgdGhlIE1JVCBMaWNlbnNlLiBTZWUgdGhlIGFjY29tcGFueWluZyBMSUNFTlNFIGZpbGUgZm9yIHRlcm1zLlxuICovXG5pbXBvcnQgdHlwZSB7TG9jYWxlfSBmcm9tICcuLi90eXBlcy9jb250ZW50LnR5cGVzLmpzJztcblxuZXhwb3J0IGNvbnN0IGV4dHJhY3RMYW5ndWFnZSA9IChsb2NhbGU6IHN0cmluZyk6IHN0cmluZyA9PiBsb2NhbGUuc3BsaXQoJy0nKVswXTtcblxuZXhwb3J0IGNvbnN0IGlzUmVnaW9uYWxMb2NhbGUgPSAobG9jYWxlOiBzdHJpbmcpOiBib29sZWFuID0+IGxvY2FsZS5pbmNsdWRlcygnLScpO1xuXG5leHBvcnQgY29uc3QgZ2V0RmFsbGJhY2tDaGFpbiA9IChsb2NhbGU6IHN0cmluZyk6IHN0cmluZ1tdID0+IHtcbiAgY29uc3QgbGFuZ3VhZ2UgPSBleHRyYWN0TGFuZ3VhZ2UobG9jYWxlKTtcbiAgcmV0dXJuIGlzUmVnaW9uYWxMb2NhbGUobG9jYWxlKSA/IFtsb2NhbGUsIGxhbmd1YWdlXSA6IFtsb2NhbGVdO1xufTtcblxuZXhwb3J0IGNvbnN0IGdldFByaW1hcnlMYW5ndWFnZXMgPSAoKTogc3RyaW5nW10gPT4gWydlbicsICdlcycsICdmcicsICdkZScsICdwdCcsICdpdCddO1xuXG5leHBvcnQgY29uc3QgaXNWYWxpZExvY2FsZSA9IChsb2NhbGU6IHN0cmluZyk6IGxvY2FsZSBpcyBMb2NhbGUgPT4ge1xuICBjb25zdCB2YWxpZExvY2FsZXM6IExvY2FsZVtdID0gW1xuICAgICdlbicsICdlbi11cycsICdlbi1nYicsICdlbi1jYScsICdlbi1hdScsXG4gICAgJ2VzJywgJ2VzLW14JywgJ2VzLWVzJywgJ2VzLWFyJyxcbiAgICAnZnInLCAnZnItZnInLCAnZnItY2EnLFxuICAgICdkZScsICdkZS1kZScsICdkZS1hdCcsXG4gICAgJ3B0JywgJ3B0LWJyJywgJ3B0LXB0JyxcbiAgICAnaXQnLCAnaXQtaXQnXG4gIF07XG4gIHJldHVybiB2YWxpZExvY2FsZXMuaW5jbHVkZXMobG9jYWxlIGFzIExvY2FsZSk7XG59O1xuXG5leHBvcnQgY29uc3QgZ2V0U3VwcG9ydGVkTG9jYWxlcyA9ICgpOiBMb2NhbGVbXSA9PiBbXG4gICdlbicsICdlbi11cycsICdlbi1nYicsICdlbi1jYScsICdlbi1hdScsXG4gICdlcycsICdlcy1teCcsICdlcy1lcycsICdlcy1hcicsXG4gICdmcicsICdmci1mcicsICdmci1jYScsXG4gICdkZScsICdkZS1kZScsICdkZS1hdCcsXG4gICdwdCcsICdwdC1icicsICdwdC1wdCcsXG4gICdpdCcsICdpdC1pdCdcbl07Il0sIm5hbWVzIjpbImV4dHJhY3RMYW5ndWFnZSIsImxvY2FsZSIsInNwbGl0IiwiaXNSZWdpb25hbExvY2FsZSIsImluY2x1ZGVzIiwiZ2V0RmFsbGJhY2tDaGFpbiIsImxhbmd1YWdlIiwiZ2V0UHJpbWFyeUxhbmd1YWdlcyIsImlzVmFsaWRMb2NhbGUiLCJ2YWxpZExvY2FsZXMiLCJnZXRTdXBwb3J0ZWRMb2NhbGVzIl0sIm1hcHBpbmdzIjoiQUFBQTs7O0NBR0MsR0FHRCxPQUFPLE1BQU1BLGtCQUFrQixDQUFDQyxTQUEyQkEsT0FBT0MsS0FBSyxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUM7QUFFaEYsT0FBTyxNQUFNQyxtQkFBbUIsQ0FBQ0YsU0FBNEJBLE9BQU9HLFFBQVEsQ0FBQyxLQUFLO0FBRWxGLE9BQU8sTUFBTUMsbUJBQW1CLENBQUNKO0lBQy9CLE1BQU1LLFdBQVdOLGdCQUFnQkM7SUFDakMsT0FBT0UsaUJBQWlCRixVQUFVO1FBQUNBO1FBQVFLO0tBQVMsR0FBRztRQUFDTDtLQUFPO0FBQ2pFLEVBQUU7QUFFRixPQUFPLE1BQU1NLHNCQUFzQixJQUFnQjtRQUFDO1FBQU07UUFBTTtRQUFNO1FBQU07UUFBTTtLQUFLLENBQUM7QUFFeEYsT0FBTyxNQUFNQyxnQkFBZ0IsQ0FBQ1A7SUFDNUIsTUFBTVEsZUFBeUI7UUFDN0I7UUFBTTtRQUFTO1FBQVM7UUFBUztRQUNqQztRQUFNO1FBQVM7UUFBUztRQUN4QjtRQUFNO1FBQVM7UUFDZjtRQUFNO1FBQVM7UUFDZjtRQUFNO1FBQVM7UUFDZjtRQUFNO0tBQ1A7SUFDRCxPQUFPQSxhQUFhTCxRQUFRLENBQUNIO0FBQy9CLEVBQUU7QUFFRixPQUFPLE1BQU1TLHNCQUFzQixJQUFnQjtRQUNqRDtRQUFNO1FBQVM7UUFBUztRQUFTO1FBQ2pDO1FBQU07UUFBUztRQUFTO1FBQ3hCO1FBQU07UUFBUztRQUNmO1FBQU07UUFBUztRQUNmO1FBQU07UUFBUztRQUNmO1FBQU07S0FDUCxDQUFDIn0=

package/lib/utils/middlewareUtils.d.ts

@@ -1,2 +1,3 @@
 import type { ApiContext } from '../types/auth.types.js';
 export declare const addFieldsToContext: (resolve: Function, parent: any, args: any, context: ApiContext, info: any) => any;
+//# sourceMappingURL=middlewareUtils.d.ts.map

package/lib/utils/middlewareUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewareUtils.d.ts","sourceRoot":"","sources":["../../src/utils/middlewareUtils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,wBAAwB,CAAC;AAEvD,eAAO,MAAM,kBAAkB,GAC7B,SAAS,QAAQ,EACjB,QAAQ,GAAG,EACX,MAAM,GAAG,EACT,SAAS,UAAU,EACnB,MAAM,GAAG,QAQV,CAAC"}

package/lib/utils/middlewareUtils.js

@@ -0,0 +1,10 @@
+import { getGqlFields } from './arangodbUtils.js';
+export const addFieldsToContext = (resolve, parent, args, context, info)=>{
+    const contextWithFields = {
+        ...context,
+        fields: getGqlFields(info)
+    };
+    return resolve(parent, args, contextWithFields, info);
+};
+
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi9Vc2Vycy9uaXRyb2c3L0RldmVsb3BtZW50L3JlYWt0b3Ivc3JjL3V0aWxzL21pZGRsZXdhcmVVdGlscy50cyJdLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQge2dldEdxbEZpZWxkc30gZnJvbSAnLi9hcmFuZ29kYlV0aWxzLmpzJztcblxuaW1wb3J0IHR5cGUge0FwaUNvbnRleHR9IGZyb20gJy4uL3R5cGVzL2F1dGgudHlwZXMuanMnO1xuXG5leHBvcnQgY29uc3QgYWRkRmllbGRzVG9Db250ZXh0ID0gKFxuICByZXNvbHZlOiBGdW5jdGlvbixcbiAgcGFyZW50OiBhbnksXG4gIGFyZ3M6IGFueSxcbiAgY29udGV4dDogQXBpQ29udGV4dCxcbiAgaW5mbzogYW55XG4pID0+IHtcbiAgY29uc3QgY29udGV4dFdpdGhGaWVsZHMgPSB7XG4gICAgLi4uY29udGV4dCxcbiAgICBmaWVsZHM6IGdldEdxbEZpZWxkcyhpbmZvKVxuICB9O1xuXG4gIHJldHVybiByZXNvbHZlKHBhcmVudCwgYXJncywgY29udGV4dFdpdGhGaWVsZHMsIGluZm8pO1xufTsiXSwibmFtZXMiOlsiZ2V0R3FsRmllbGRzIiwiYWRkRmllbGRzVG9Db250ZXh0IiwicmVzb2x2ZSIsInBhcmVudCIsImFyZ3MiLCJjb250ZXh0IiwiaW5mbyIsImNvbnRleHRXaXRoRmllbGRzIiwiZmllbGRzIl0sIm1hcHBpbmdzIjoiQUFBQSxTQUFRQSxZQUFZLFFBQU8scUJBQXFCO0FBSWhELE9BQU8sTUFBTUMscUJBQXFCLENBQ2hDQyxTQUNBQyxRQUNBQyxNQUNBQyxTQUNBQztJQUVBLE1BQU1DLG9CQUFvQjtRQUN4QixHQUFHRixPQUFPO1FBQ1ZHLFFBQVFSLGFBQWFNO0lBQ3ZCO0lBRUEsT0FBT0osUUFBUUMsUUFBUUMsTUFBTUcsbUJBQW1CRDtBQUNsRCxFQUFFIn0=

package/lib/utils/sessionUtils.d.ts

@@ -16,3 +16,4 @@ export type SessionToken = {
 export declare const setSession: (session: Session) => string;
 export declare const getSession: (token: string) => Session;
 export declare const isAdminUser: (session?: Session) => boolean;
+//# sourceMappingURL=sessionUtils.d.ts.map

package/lib/utils/sessionUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionUtils.d.ts","sourceRoot":"","sources":["../../src/utils/sessionUtils.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,SAAS,OAAO,KAAG,MAAuD,CAAC;AAEtG,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,OAe1C,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,UAAU,OAAO,KAAG,OAA0D,CAAC"}

package/lib/utils/sessionUtils.js

@@ -0,0 +1,26 @@
+/**
+ * Copyright (c) 2019-Present, Nitrogen Labs, Inc.
+ * Copyrights licensed under the MIT License. See the accompanying LICENSE file for terms.
+ */ import jwt from 'jsonwebtoken';
+export const setSession = (session)=>jwt.sign(session, process.env.SESSION_SECRET);
+export const getSession = (token)=>{
+    try {
+        return jwt.verify(token, process.env.SESSION_SECRET);
+    } catch (error) {
+        switch(error.message){
+            case 'jwt expired':
+                {
+                    const err = new Error('expired_session');
+                    throw err;
+                }
+            default:
+                {
+                    const err = new Error('invalid_session');
+                    throw err;
+                }
+        }
+    }
+};
+export const isAdminUser = (session)=>!!session?.userAccess && session.userAccess > 2;
+
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi9Vc2Vycy9uaXRyb2c3L0RldmVsb3BtZW50L3JlYWt0b3Ivc3JjL3V0aWxzL3Nlc3Npb25VdGlscy50cyJdLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIENvcHlyaWdodCAoYykgMjAxOS1QcmVzZW50LCBOaXRyb2dlbiBMYWJzLCBJbmMuXG4gKiBDb3B5cmlnaHRzIGxpY2Vuc2VkIHVuZGVyIHRoZSBNSVQgTGljZW5zZS4gU2VlIHRoZSBhY2NvbXBhbnlpbmcgTElDRU5TRSBmaWxlIGZvciB0ZXJtcy5cbiAqL1xuaW1wb3J0IGp3dCBmcm9tICdqc29ud2VidG9rZW4nO1xuXG5leHBvcnQgdHlwZSBTZXNzaW9uID0ge1xuICByZWFkb25seSBlcnJvcnM/OiBzdHJpbmdbXTtcbiAgcmVhZG9ubHkgZXhwPzogbnVtYmVyO1xuICByZWFkb25seSBpYXQ/OiBudW1iZXI7XG4gIHJlYWRvbmx5IHVzZXJuYW1lPzogc3RyaW5nO1xuICByZWFkb25seSB1c2VyQWNjZXNzPzogbnVtYmVyO1xuICByZWFkb25seSB1c2VySWQ6IHN0cmluZztcbn07XG5cbmV4cG9ydCB0eXBlIFNlc3Npb25Ub2tlbiA9IHtcbiAgcmVhZG9ubHkgZXhwaXJlczogbnVtYmVyO1xuICByZWFkb25seSBpc3N1ZWQ6IG51bWJlcjtcbiAgcmVhZG9ubHkgdG9rZW46IHN0cmluZztcbiAgcmVhZG9ubHkgdXNlcklkOiBzdHJpbmc7XG4gIHJlYWRvbmx5IHVzZXJuYW1lOiBzdHJpbmc7XG59O1xuXG5leHBvcnQgY29uc3Qgc2V0U2Vzc2lvbiA9IChzZXNzaW9uOiBTZXNzaW9uKTogc3RyaW5nID0+IGp3dC5zaWduKHNlc3Npb24sIHByb2Nlc3MuZW52LlNFU1NJT05fU0VDUkVUKTtcblxuZXhwb3J0IGNvbnN0IGdldFNlc3Npb24gPSAodG9rZW46IHN0cmluZyk6IFNlc3Npb24gPT4ge1xuICB0cnkge1xuICAgIHJldHVybiBqd3QudmVyaWZ5KHRva2VuLCBwcm9jZXNzLmVudi5TRVNTSU9OX1NFQ1JFVCk7XG4gIH0gY2F0Y2goZXJyb3IpIHtcbiAgICBzd2l0Y2goZXJyb3IubWVzc2FnZSkge1xuICAgICAgY2FzZSAnand0IGV4cGlyZWQnOiB7XG4gICAgICAgIGNvbnN0IGVyciA9IG5ldyBFcnJvcignZXhwaXJlZF9zZXNzaW9uJyk7XG4gICAgICAgIHRocm93IGVycjtcbiAgICAgIH1cbiAgICAgIGRlZmF1bHQ6IHtcbiAgICAgICAgY29uc3QgZXJyID0gbmV3IEVycm9yKCdpbnZhbGlkX3Nlc3Npb24nKTtcbiAgICAgICAgdGhyb3cgZXJyO1xuICAgICAgfVxuICAgIH1cbiAgfVxufTtcblxuZXhwb3J0IGNvbnN0IGlzQWRtaW5Vc2VyID0gKHNlc3Npb24/OiBTZXNzaW9uKTogYm9vbGVhbiA9PiAhIXNlc3Npb24/LnVzZXJBY2Nlc3MgJiYgc2Vzc2lvbi51c2VyQWNjZXNzID4gMjsiXSwibmFtZXMiOlsiand0Iiwic2V0U2Vzc2lvbiIsInNlc3Npb24iLCJzaWduIiwicHJvY2VzcyIsImVudiIsIlNFU1NJT05fU0VDUkVUIiwiZ2V0U2Vzc2lvbiIsInRva2VuIiwidmVyaWZ5IiwiZXJyb3IiLCJtZXNzYWdlIiwiZXJyIiwiRXJyb3IiLCJpc0FkbWluVXNlciIsInVzZXJBY2Nlc3MiXSwibWFwcGluZ3MiOiJBQUFBOzs7Q0FHQyxHQUNELE9BQU9BLFNBQVMsZUFBZTtBQW1CL0IsT0FBTyxNQUFNQyxhQUFhLENBQUNDLFVBQTZCRixJQUFJRyxJQUFJLENBQUNELFNBQVNFLFFBQVFDLEdBQUcsQ0FBQ0MsY0FBYyxFQUFFO0FBRXRHLE9BQU8sTUFBTUMsYUFBYSxDQUFDQztJQUN6QixJQUFJO1FBQ0YsT0FBT1IsSUFBSVMsTUFBTSxDQUFDRCxPQUFPSixRQUFRQyxHQUFHLENBQUNDLGNBQWM7SUFDckQsRUFBRSxPQUFNSSxPQUFPO1FBQ2IsT0FBT0EsTUFBTUMsT0FBTztZQUNsQixLQUFLO2dCQUFlO29CQUNsQixNQUFNQyxNQUFNLElBQUlDLE1BQU07b0JBQ3RCLE1BQU1EO2dCQUNSO1lBQ0E7Z0JBQVM7b0JBQ1AsTUFBTUEsTUFBTSxJQUFJQyxNQUFNO29CQUN0QixNQUFNRDtnQkFDUjtRQUNGO0lBQ0Y7QUFDRixFQUFFO0FBRUYsT0FBTyxNQUFNRSxjQUFjLENBQUNaLFVBQStCLENBQUMsQ0FBQ0EsU0FBU2EsY0FBY2IsUUFBUWEsVUFBVSxHQUFHLEVBQUUifQ==

package/lib/utils/stripeUtils.d.ts

@@ -3,5 +3,6 @@
  * Copyrights licensed under the MIT License. See the accompanying LICENSE file for terms.
  */
 import stripe from 'stripe';
-export declare const stripeApiVersion = "2025-09-30.clover";
+export declare const stripeApiVersion = "2025-12-15.clover";
 export declare const getStripeClient: () => stripe;
+//# sourceMappingURL=stripeUtils.d.ts.map

package/lib/utils/stripeUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripeUtils.d.ts","sourceRoot":"","sources":["../../src/utils/stripeUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAI5B,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AAEpD,eAAO,MAAM,eAAe,cAAiG,CAAC"}

package/lib/utils/stripeUtils.js

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) 2025-Present, Nitrogen Labs, Inc.
+ * Copyrights licensed under the MIT License. See the accompanying LICENSE file for terms.
+ */ import stripe from 'stripe';
+import { Config } from '../config.js';
+export const stripeApiVersion = '2025-12-15.clover';
+export const getStripeClient = ()=>new stripe(Config.get('stripe.token'), {
+        apiVersion: stripeApiVersion,
+        typescript: true
+    });
+
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi9Vc2Vycy9uaXRyb2c3L0RldmVsb3BtZW50L3JlYWt0b3Ivc3JjL3V0aWxzL3N0cmlwZVV0aWxzLnRzIl0sInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQ29weXJpZ2h0IChjKSAyMDI1LVByZXNlbnQsIE5pdHJvZ2VuIExhYnMsIEluYy5cbiAqIENvcHlyaWdodHMgbGljZW5zZWQgdW5kZXIgdGhlIE1JVCBMaWNlbnNlLiBTZWUgdGhlIGFjY29tcGFueWluZyBMSUNFTlNFIGZpbGUgZm9yIHRlcm1zLlxuICovXG5pbXBvcnQgc3RyaXBlIGZyb20gJ3N0cmlwZSc7XG5cbmltcG9ydCB7Q29uZmlnfSBmcm9tICcuLi9jb25maWcuanMnO1xuXG5leHBvcnQgY29uc3Qgc3RyaXBlQXBpVmVyc2lvbiA9ICcyMDI1LTEyLTE1LmNsb3Zlcic7XG5cbmV4cG9ydCBjb25zdCBnZXRTdHJpcGVDbGllbnQgPSAoKSA9PiBuZXcgc3RyaXBlKENvbmZpZy5nZXQoJ3N0cmlwZS50b2tlbicpLCB7YXBpVmVyc2lvbjogc3RyaXBlQXBpVmVyc2lvbiwgdHlwZXNjcmlwdDogdHJ1ZX0pOyJdLCJuYW1lcyI6WyJzdHJpcGUiLCJDb25maWciLCJzdHJpcGVBcGlWZXJzaW9uIiwiZ2V0U3RyaXBlQ2xpZW50IiwiZ2V0IiwiYXBpVmVyc2lvbiIsInR5cGVzY3JpcHQiXSwibWFwcGluZ3MiOiJBQUFBOzs7Q0FHQyxHQUNELE9BQU9BLFlBQVksU0FBUztBQUU1QixTQUFRQyxNQUFNLFFBQU8sZUFBZTtBQUVwQyxPQUFPLE1BQU1DLG1CQUFtQixvQkFBb0I7QUFFcEQsT0FBTyxNQUFNQyxrQkFBa0IsSUFBTSxJQUFJSCxPQUFPQyxPQUFPRyxHQUFHLENBQUMsaUJBQWlCO1FBQUNDLFlBQVlIO1FBQWtCSSxZQUFZO0lBQUksR0FBRyJ9

package/lib/utils/templateUtils.d.ts

@@ -1,3 +1,4 @@
 export type TemplateParams = Record<string, string>;
 export declare const parseTemplate: (template: string, params: TemplateParams) => string;
 export declare const createTemplate: <T extends TemplateParams>(templateString: string, params: T) => string;
+//# sourceMappingURL=templateUtils.d.ts.map

package/lib/utils/templateUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateUtils.d.ts","sourceRoot":"","sources":["../../src/utils/templateUtils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpD,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,EAAE,QAAQ,cAAc,KAAG,MASxE,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,cAAc,EAAE,gBAAgB,MAAM,EAAE,QAAQ,CAAC,KAAG,MACtD,CAAC"}

package/lib/utils/templateUtils.js

@@ -0,0 +1,11 @@
+export const parseTemplate = (template, params)=>{
+    let result = template;
+    Object.keys(params).forEach((key)=>{
+        const regex = new RegExp(`\\[${key}\\]`, 'g');
+        result = result.replace(regex, params[key]);
+    });
+    return result;
+};
+export const createTemplate = (templateString, params)=>parseTemplate(templateString, params);
+
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi9Vc2Vycy9uaXRyb2c3L0RldmVsb3BtZW50L3JlYWt0b3Ivc3JjL3V0aWxzL3RlbXBsYXRlVXRpbHMudHMiXSwic291cmNlc0NvbnRlbnQiOlsiZXhwb3J0IHR5cGUgVGVtcGxhdGVQYXJhbXMgPSBSZWNvcmQ8c3RyaW5nLCBzdHJpbmc+O1xuXG5leHBvcnQgY29uc3QgcGFyc2VUZW1wbGF0ZSA9ICh0ZW1wbGF0ZTogc3RyaW5nLCBwYXJhbXM6IFRlbXBsYXRlUGFyYW1zKTogc3RyaW5nID0+IHtcbiAgbGV0IHJlc3VsdCA9IHRlbXBsYXRlO1xuXG4gIE9iamVjdC5rZXlzKHBhcmFtcykuZm9yRWFjaCgoa2V5KSA9PiB7XG4gICAgY29uc3QgcmVnZXggPSBuZXcgUmVnRXhwKGBcXFxcWyR7a2V5fVxcXFxdYCwgJ2cnKTtcbiAgICByZXN1bHQgPSByZXN1bHQucmVwbGFjZShyZWdleCwgcGFyYW1zW2tleV0pO1xuICB9KTtcblxuICByZXR1cm4gcmVzdWx0O1xufTtcblxuZXhwb3J0IGNvbnN0IGNyZWF0ZVRlbXBsYXRlID0gPFQgZXh0ZW5kcyBUZW1wbGF0ZVBhcmFtcz4odGVtcGxhdGVTdHJpbmc6IHN0cmluZywgcGFyYW1zOiBUKTogc3RyaW5nID0+XG4gIHBhcnNlVGVtcGxhdGUodGVtcGxhdGVTdHJpbmcsIHBhcmFtcyk7Il0sIm5hbWVzIjpbInBhcnNlVGVtcGxhdGUiLCJ0ZW1wbGF0ZSIsInBhcmFtcyIsInJlc3VsdCIsIk9iamVjdCIsImtleXMiLCJmb3JFYWNoIiwia2V5IiwicmVnZXgiLCJSZWdFeHAiLCJyZXBsYWNlIiwiY3JlYXRlVGVtcGxhdGUiLCJ0ZW1wbGF0ZVN0cmluZyJdLCJtYXBwaW5ncyI6IkFBRUEsT0FBTyxNQUFNQSxnQkFBZ0IsQ0FBQ0MsVUFBa0JDO0lBQzlDLElBQUlDLFNBQVNGO0lBRWJHLE9BQU9DLElBQUksQ0FBQ0gsUUFBUUksT0FBTyxDQUFDLENBQUNDO1FBQzNCLE1BQU1DLFFBQVEsSUFBSUMsT0FBTyxDQUFDLEdBQUcsRUFBRUYsSUFBSSxHQUFHLENBQUMsRUFBRTtRQUN6Q0osU0FBU0EsT0FBT08sT0FBTyxDQUFDRixPQUFPTixNQUFNLENBQUNLLElBQUk7SUFDNUM7SUFFQSxPQUFPSjtBQUNULEVBQUU7QUFFRixPQUFPLE1BQU1RLGlCQUFpQixDQUEyQkMsZ0JBQXdCVixTQUMvRUYsY0FBY1ksZ0JBQWdCVixRQUFRIn0=

package/lib/utils/testUtils.d.ts

@@ -93,3 +93,4 @@ export declare const createUtilsTestSuite: (name: string, utilsPath: string, tes
     expectedOutput: TestReturnValue;
 }>) => void;
 export {};
+//# sourceMappingURL=testUtils.d.ts.map

package/lib/utils/testUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testUtils.d.ts","sourceRoot":"","sources":["../../src/utils/testUtils.ts"],"names":[],"mappings":"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"}