gt-react 3.1.39 → 3.1.41

package/dist/cjs/config/I18NConfiguration.d.ts

@@ -0,0 +1,135 @@
+import GT from "generaltranslation";
+type I18NConfigurationParams = {
+    apiKey: string;
+    projectID: string;
+    cacheURL: string;
+    baseURL: string;
+    remoteSource: boolean;
+    automaticTranslation: boolean;
+    getLocale: () => string;
+    defaultLocale: string;
+    approvedLocales?: string[];
+    renderPrevious: boolean;
+    renderMethod: string;
+    renderTimeout: number | null;
+    dictionary: Record<string, any>;
+    dictionaryName: string;
+    translations?: Record<string, () => Promise<Record<string, any>>>;
+    maxConcurrentRequests: number;
+    batchInterval: number;
+    getMetadata: () => Record<string, any>;
+    [key: string]: any;
+};
+export default class I18NConfiguration {
+    projectID: string;
+    remoteSource: boolean;
+    automaticTranslation: boolean;
+    getLocale: () => string;
+    defaultLocale: string;
+    approvedLocales: string[] | undefined;
+    renderPrevious: boolean;
+    renderMethod: string;
+    renderTimeout: number | null;
+    dictionaryName: string;
+    dictionary: Record<string, any>;
+    translations?: Record<string, () => Promise<Record<string, any>>>;
+    private _localDictionaryManager;
+    private _remoteDictionaryManager;
+    gt: GT;
+    getMetadata: () => Record<string, any>;
+    metadata: Record<string, any>;
+    maxConcurrentRequests: number;
+    batchInterval: number;
+    private _queue;
+    private _activeRequests;
+    private _translationCache;
+    constructor({ apiKey, projectID, baseURL, cacheURL, remoteSource, automaticTranslation, getLocale, defaultLocale, approvedLocales, renderPrevious, renderMethod, renderTimeout, dictionary, dictionaryName, translations, maxConcurrentRequests, batchInterval, getMetadata, ...metadata }: I18NConfigurationParams);
+    /**
+     * Gets the application's default locale
+     * @returns {string} A BCP-47 language tag
+    */
+    getDefaultLocale(): string;
+    /**
+     * Gets the list of approved locales for this app
+     * @returns {string[] | undefined} A list of BCP-47 language tags, or undefined if none were provided
+    */
+    getApprovedLocales(): string[] | undefined;
+    /**
+     * Get dictionary
+     * @returns The entire dictionary, or an empty object if none found
+    */
+    getDictionary(): Record<string, any>;
+    /**
+     * Get an entry from the dictionary
+     * @returns An entry from the dictionary determined by id
+    */
+    getDictionaryEntry(id: string): any;
+    /**
+     * Get an entry from the dictionary
+     * @returns An entry from the dictionary determined by id
+    */
+    automaticTranslationEnabled(): boolean;
+    /**
+     * Get the rendering instructions
+     * @returns An object containing the current method and timeout.
+     * As of 7/31/24: method is "skeleton", "replace", "hang", "subtle".
+     * Timeout is a number or null, representing no assigned timeout.
+     * renderPrevious determines whether a non-matching previous entry should be rendered while the new translation loads.
+    */
+    getRenderSettings(): {
+        method: string;
+        timeout: number | null;
+        renderPrevious: boolean;
+    };
+    /**
+     * Check if translation is required based on the user's locale
+     * @param locale - The user's locale
+     * @returns True if translation is required, otherwise false
+     */
+    translationRequired(locale: string): boolean;
+    /**
+     * Get the translation dictionaries for this user's locale, if they exist
+     * @param locale - The language set by the user
+     * @param dictionaryName - User-defined dictionary name, for distinguishing between multiple translation dictionaries for a single language.
+     * @returns A promise that resolves to the translations.
+    */
+    getTranslations(locale: string, dictionaryName?: string): Promise<{
+        local?: any;
+        remote?: any;
+    }>;
+    /**
+     * Get the entry in the translation dictionary for the user's locale, if it exists
+     * @param locale - The user's locale
+     * @param key - Key in the dictionary. For strings, the original language version of that string. For React children, a hash.
+     * @param dictionaryName - User-defined dictionary name, for distinguishing between multiple translation dictionaries for a single language.
+     * @param translations - Optional translations to search.
+     * @returns A promise that resolves to the a value in the translations.
+    */
+    getTranslation(locale: string, key: string, id?: string, dictionaryName?: string, translations?: {
+        local?: any;
+        remote?: any;
+    }): Promise<any | null>;
+    /**
+     * Translate content into language
+     * @param params - Parameters for translation
+     * @returns Translated string
+     */
+    intl(params: any): Promise<string>;
+    /**
+     * Translate the children components
+     * @param params - Parameters for translation
+     * @returns A promise that resolves when translation is complete
+    */
+    translateChildren(params: any): Promise<any>;
+    /**
+     * Send a batch request for React translation
+     * @param batch - The batch of requests to be sent
+     */
+    private _sendBatchRequest;
+    /**
+     * Start the batching process with a set interval
+    */
+    private _startBatching;
+}
+export {};
+//# sourceMappingURL=I18NConfiguration.d.ts.map

package/dist/cjs/config/I18NConfiguration.d.ts.map

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

package/dist/cjs/config/I18NConfiguration.js

@@ -0,0 +1,343 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const generaltranslation_1 = __importStar(require("generaltranslation"));
+const RemoteDictionaryManager_1 = __importDefault(require("./RemoteDictionaryManager"));
+const getDictionaryEntry_1 = __importDefault(require("../dictionary/getDictionaryEntry"));
+const LocalDictionaryManager_1 = __importDefault(require("./LocalDictionaryManager"));
+const defaultGTProps_1 = __importDefault(require("../types/defaultGTProps"));
+class I18NConfiguration {
+    constructor(_a) {
+        var { 
+        // Cloud integration
+        apiKey, projectID, baseURL, cacheURL, remoteSource, automaticTranslation, 
+        // Locale info
+        getLocale, defaultLocale, approvedLocales, 
+        // Render method
+        renderPrevious, renderMethod, renderTimeout, 
+        // Dictionaries
+        dictionary, dictionaryName, translations, 
+        // Batching config
+        maxConcurrentRequests, batchInterval, 
+        // Other metadata
+        getMetadata } = _a, metadata = __rest(_a, ["apiKey", "projectID", "baseURL", "cacheURL", "remoteSource", "automaticTranslation", "getLocale", "defaultLocale", "approvedLocales", "renderPrevious", "renderMethod", "renderTimeout", "dictionary", "dictionaryName", "translations", "maxConcurrentRequests", "batchInterval", "getMetadata"]);
+        // Validate required parameters
+        if (!apiKey && (automaticTranslation && baseURL === defaultGTProps_1.default.baseURL)) {
+            throw new Error("gt-react Error: Automatic translation requires an API key! Get an API key at www.generaltranslation.com.");
+        }
+        if (!projectID && ((automaticTranslation && baseURL === defaultGTProps_1.default.baseURL) || (remoteSource && cacheURL === defaultGTProps_1.default.cacheURL))) {
+            throw new Error("gt-react Error: General Translation cloud services require a project ID! Find yours at www.generaltranslation.com/dashboard.");
+        }
+        // Cloud integration
+        this.projectID = projectID;
+        this.remoteSource = remoteSource;
+        this.automaticTranslation = automaticTranslation;
+        // Locales
+        this.getLocale = getLocale;
+        this.defaultLocale = defaultLocale;
+        this.approvedLocales = approvedLocales;
+        // Render method
+        this.renderPrevious = renderPrevious;
+        this.renderMethod = renderMethod;
+        this.renderTimeout = renderTimeout;
+        // Dictionaries
+        this.dictionary = dictionary;
+        this.dictionaryName = dictionaryName;
+        this.translations = translations;
+        // GT
+        this.gt = new generaltranslation_1.default({ projectID, apiKey, defaultLanguage: defaultLocale, baseURL });
+        // Other metadata
+        this.getMetadata = getMetadata;
+        this.metadata = Object.assign(Object.assign({ projectID: this.projectID, defaultLanguage: this.defaultLocale, dictionaryName }, (this.renderTimeout && { timeout: this.renderTimeout - batchInterval })), metadata);
+        // Dictionary managers
+        if (this.translations) {
+            this._localDictionaryManager = new LocalDictionaryManager_1.default({
+                translations: this.translations
+            });
+        }
+        if (this.remoteSource) {
+            this._remoteDictionaryManager = RemoteDictionaryManager_1.default;
+            this._remoteDictionaryManager.setConfig({
+                cacheURL, projectID
+            });
+        }
+        // Batching
+        this.maxConcurrentRequests = maxConcurrentRequests;
+        this.batchInterval = batchInterval;
+        this._queue = [];
+        this._activeRequests = 0;
+        this._translationCache = new Map(); // cache for ongoing promises, so things aren't translated twice
+        this._startBatching();
+    }
+    /**
+     * Gets the application's default locale
+     * @returns {string} A BCP-47 language tag
+    */
+    getDefaultLocale() {
+        return this.defaultLocale;
+    }
+    /**
+     * Gets the list of approved locales for this app
+     * @returns {string[] | undefined} A list of BCP-47 language tags, or undefined if none were provided
+    */
+    getApprovedLocales() {
+        return this.approvedLocales;
+    }
+    /**
+     * Get dictionary
+     * @returns The entire dictionary, or an empty object if none found
+    */
+    getDictionary() {
+        return this.dictionary;
+    }
+    /**
+     * Get an entry from the dictionary
+     * @returns An entry from the dictionary determined by id
+    */
+    getDictionaryEntry(id) {
+        return (0, getDictionaryEntry_1.default)(id, this.dictionary);
+    }
+    /**
+     * Get an entry from the dictionary
+     * @returns An entry from the dictionary determined by id
+    */
+    automaticTranslationEnabled() {
+        return this.automaticTranslation;
+    }
+    /**
+     * Get the rendering instructions
+     * @returns An object containing the current method and timeout.
+     * As of 7/31/24: method is "skeleton", "replace", "hang", "subtle".
+     * Timeout is a number or null, representing no assigned timeout.
+     * renderPrevious determines whether a non-matching previous entry should be rendered while the new translation loads.
+    */
+    getRenderSettings() {
+        return {
+            method: this.renderMethod,
+            timeout: this.renderTimeout,
+            renderPrevious: this.renderPrevious
+        };
+    }
+    /**
+     * Check if translation is required based on the user's locale
+     * @param locale - The user's locale
+     * @returns True if translation is required, otherwise false
+     */
+    translationRequired(locale) {
+        if (!locale)
+            return false;
+        if (this.approvedLocales && !this.approvedLocales.some(approvedLocale => (0, generaltranslation_1.isSameLanguage)(locale, approvedLocale)))
+            return false;
+        if ((0, generaltranslation_1.isSameLanguage)(locale, this.defaultLocale))
+            return false;
+        return true;
+    }
+    /**
+     * Get the translation dictionaries for this user's locale, if they exist
+     * @param locale - The language set by the user
+     * @param dictionaryName - User-defined dictionary name, for distinguishing between multiple translation dictionaries for a single language.
+     * @returns A promise that resolves to the translations.
+    */
+    getTranslations(locale_1) {
+        return __awaiter(this, arguments, void 0, function* (locale, dictionaryName = this.dictionaryName) {
+            let translations = {};
+            const localPromise = this._localDictionaryManager ? this._localDictionaryManager.getDictionary(locale) : Promise.resolve(undefined);
+            const remotePromise = this._remoteDictionaryManager ? this._remoteDictionaryManager.getDictionary(locale, dictionaryName) : Promise.resolve(undefined);
+            const [local, remote] = yield Promise.all([localPromise, remotePromise]);
+            if (local !== undefined) {
+                translations.local = local;
+            }
+            if (remote !== undefined) {
+                translations.remote = remote;
+            }
+            return translations;
+        });
+    }
+    /**
+     * Get the entry in the translation dictionary for the user's locale, if it exists
+     * @param locale - The user's locale
+     * @param key - Key in the dictionary. For strings, the original language version of that string. For React children, a hash.
+     * @param dictionaryName - User-defined dictionary name, for distinguishing between multiple translation dictionaries for a single language.
+     * @param translations - Optional translations to search.
+     * @returns A promise that resolves to the a value in the translations.
+    */
+    getTranslation(locale_1, key_1) {
+        return __awaiter(this, arguments, void 0, function* (locale, key, id = key, dictionaryName = this.dictionaryName, translations) {
+            translations = translations || (yield this.getTranslations(locale, dictionaryName));
+            if (translations.local) {
+                const translation = (0, getDictionaryEntry_1.default)(id, translations.local);
+                if (translation)
+                    return translation;
+            }
+            if (translations.remote) {
+                if (translations.remote[id] && translations.remote[id].k === key)
+                    return translations.remote[id].t;
+            }
+            return null;
+        });
+    }
+    /**
+     * Translate content into language
+     * @param params - Parameters for translation
+     * @returns Translated string
+     */
+    intl(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const cacheKey = JSON.stringify(params);
+            if (this._translationCache.has(cacheKey)) {
+                return this._translationCache.get(cacheKey);
+            }
+            const { content, targetLanguage, options } = params;
+            const dictionaryName = ((_a = params.options) === null || _a === void 0 ? void 0 : _a.dictionaryName) || this.dictionaryName;
+            const translationPromise = new Promise((resolve, reject) => {
+                this._queue.push({
+                    type: "intl",
+                    data: {
+                        content,
+                        targetLanguage,
+                        projectID: this.projectID,
+                        metadata: Object.assign(Object.assign(Object.assign({}, this.metadata), this.getMetadata()), options)
+                    },
+                    cache: (this._remoteDictionaryManager) ? this._remoteDictionaryManager.getTranslationRequested(targetLanguage, dictionaryName) : false,
+                    resolve,
+                    reject
+                });
+            });
+            this._translationCache.set(cacheKey, translationPromise);
+            return translationPromise.finally(() => this._translationCache.delete(cacheKey));
+        });
+    }
+    /**
+     * Translate the children components
+     * @param params - Parameters for translation
+     * @returns A promise that resolves when translation is complete
+    */
+    translateChildren(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const cacheKey = JSON.stringify(params);
+            if (this._translationCache.has(cacheKey)) {
+                return this._translationCache.get(cacheKey);
+            }
+            const { children, targetLanguage, metadata } = params;
+            const dictionaryName = ((_a = params.options) === null || _a === void 0 ? void 0 : _a.dictionaryName) || this.dictionaryName;
+            const translationPromise = new Promise((resolve, reject) => {
+                this._queue.push({
+                    type: "react",
+                    data: {
+                        children,
+                        targetLanguage,
+                        metadata: Object.assign(Object.assign(Object.assign({}, this.metadata), this.getMetadata()), metadata)
+                    },
+                    cache: (this._remoteDictionaryManager) ? this._remoteDictionaryManager.getTranslationRequested(targetLanguage, dictionaryName) : false,
+                    resolve,
+                    reject
+                });
+            });
+            this._translationCache.set(cacheKey, translationPromise);
+            return translationPromise.finally(() => this._translationCache.delete(cacheKey));
+        });
+    }
+    /**
+     * Send a batch request for React translation
+     * @param batch - The batch of requests to be sent
+     */
+    _sendBatchRequest(batch) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this._activeRequests++;
+            try {
+                const bundlePromise = this.gt.bundleTranslation(batch);
+                batch.forEach((item) => {
+                    if (this._remoteDictionaryManager && item.cache)
+                        this._remoteDictionaryManager.setTranslationRequested(item.data.targetLanguage, item.data.metadata.dictionaryName);
+                });
+                const results = yield bundlePromise;
+                batch.forEach((item, index) => {
+                    const result = results[index];
+                    if (!result || result.error)
+                        return resolveBatchError(item);
+                    if (result && typeof result === 'object') {
+                        item.resolve(result.translation);
+                        if (result.translation && result.language && result.reference && this._remoteDictionaryManager) {
+                            this._remoteDictionaryManager.setDictionary(result.language, result.reference.dictionaryName, result.reference.key, result.reference.id, result.translation);
+                        }
+                    }
+                });
+            }
+            catch (error) {
+                console.error(error);
+                batch.forEach(resolveBatchError);
+            }
+            finally {
+                this._activeRequests--;
+            }
+        });
+    }
+    /**
+     * Start the batching process with a set interval
+    */
+    _startBatching() {
+        setInterval(() => {
+            if (this._queue.length > 0 && this._activeRequests < this.maxConcurrentRequests) {
+                this._sendBatchRequest(this._queue);
+                this._queue = [];
+            }
+        }, this.batchInterval);
+    }
+}
+exports.default = I18NConfiguration;
+// Resolve errors in the batch request
+const resolveBatchError = (item) => {
+    if (item.type === "react")
+        return item.resolve(null);
+    if (item.type === "intl")
+        return item.resolve(item.data.content);
+    return item.resolve("");
+};
+//# sourceMappingURL=I18NConfiguration.js.map

package/dist/cjs/config/I18NConfiguration.js.map

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

package/dist/cjs/config/LocalDictionaryManager.d.ts

@@ -0,0 +1,31 @@
+/**
+ * LocalDictionaryManager is responsible for managing dictionaries loaded from local file paths.
+ * @class
+ */
+export default class LocalDictionaryManager {
+    private translations;
+    private localeCache;
+    private dictionaryMap;
+    private fetchPromises;
+    /**
+     * Creates an instance of LocalDictionaryManager.
+     * @param {Object} params - Parameters object.
+     * @param {Record<string, () => Promise<Record<string, any>>>} params.translations - A mapping of locale to a function that imports the corresponding dictionary.
+     */
+    constructor({ translations }: {
+        translations: Record<string, () => Promise<Record<string, any>>>;
+    });
+    /**
+     * Retrieves a dictionary based on locale.
+     * @param {string} locale - The locale of the dictionary.
+     * @returns {Promise<Record<string, any> | null>} The dictionary data or null if not found.
+     */
+    getDictionary(locale: string): Promise<Record<string, any> | null>;
+    /**
+     * Fetches a dictionary from the translations object using the provided function.
+     * @param {string} locale - The locale of the dictionary.
+     * @returns {Promise<Record<string, any> | null>} The fetched dictionary data or null if not found.
+     */
+    private _fetchDictionary;
+}
+//# sourceMappingURL=LocalDictionaryManager.d.ts.map

package/dist/cjs/config/LocalDictionaryManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalDictionaryManager.d.ts","sourceRoot":"","sources":["../../../src/config/LocalDictionaryManager.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,sBAAsB;IACvC,OAAO,CAAC,YAAY,CAAqD;IACzE,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,aAAa,CAAmD;IAExE;;;;OAIG;gBACS,EAAE,YAAY,EAAE,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;KAAE;IAOlG;;;;OAIG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IA6CxE;;;;OAIG;YACW,gBAAgB;CAWjC"}

package/dist/cjs/config/LocalDictionaryManager.js

@@ -0,0 +1,95 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const generaltranslation_1 = require("generaltranslation");
+/**
+ * LocalDictionaryManager is responsible for managing dictionaries loaded from local file paths.
+ * @class
+ */
+class LocalDictionaryManager {
+    /**
+     * Creates an instance of LocalDictionaryManager.
+     * @param {Object} params - Parameters object.
+     * @param {Record<string, () => Promise<Record<string, any>>>} params.translations - A mapping of locale to a function that imports the corresponding dictionary.
+     */
+    constructor({ translations }) {
+        this.translations = translations;
+        this.localeCache = new Map();
+        this.dictionaryMap = new Map();
+        this.fetchPromises = new Map();
+    }
+    /**
+     * Retrieves a dictionary based on locale.
+     * @param {string} locale - The locale of the dictionary.
+     * @returns {Promise<Record<string, any> | null>} The dictionary data or null if not found.
+     */
+    getDictionary(locale) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Check if the dictionary is already cached
+            if (this.dictionaryMap.has(locale)) {
+                return this.dictionaryMap.get(locale) || null;
+            }
+            // Check if there is an ongoing fetch for this locale
+            if (this.fetchPromises.has(locale)) {
+                return (yield this.fetchPromises.get(locale)) || null;
+            }
+            // Resolve the final locale
+            let finalLocale = locale;
+            if (!this.translations[finalLocale]) {
+                finalLocale = this.localeCache.get(locale) || '';
+                if (!finalLocale) {
+                    for (const key of Object.keys(this.translations)) {
+                        if ((0, generaltranslation_1.isSameLanguage)(key, locale)) {
+                            finalLocale = key;
+                            break;
+                        }
+                    }
+                    this.localeCache.set(locale, finalLocale);
+                }
+            }
+            // If no valid finalLocale is found, return null
+            if (!finalLocale || !this.translations[finalLocale]) {
+                return null;
+            }
+            // Fetch the dictionary and cache the result
+            const fetchPromise = this._fetchDictionary(finalLocale);
+            this.fetchPromises.set(locale, fetchPromise);
+            const retrievedDictionary = yield fetchPromise;
+            this.fetchPromises.delete(locale);
+            if (retrievedDictionary) {
+                this.dictionaryMap.set(locale, retrievedDictionary);
+            }
+            return retrievedDictionary;
+        });
+    }
+    /**
+     * Fetches a dictionary from the translations object using the provided function.
+     * @param {string} locale - The locale of the dictionary.
+     * @returns {Promise<Record<string, any> | null>} The fetched dictionary data or null if not found.
+     */
+    _fetchDictionary(locale) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const loadDictionary = this.translations[locale];
+                if (!loadDictionary)
+                    throw new Error(`No translation function for locale: ${locale}`);
+                const dictionary = yield loadDictionary();
+                return dictionary;
+            }
+            catch (error) {
+                console.error(`Error loading dictionary for locale ${locale}:`, error);
+                return null;
+            }
+        });
+    }
+}
+exports.default = LocalDictionaryManager;
+//# sourceMappingURL=LocalDictionaryManager.js.map

package/dist/cjs/config/LocalDictionaryManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalDictionaryManager.js","sourceRoot":"","sources":["../../../src/config/LocalDictionaryManager.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,2DAAoD;AAEpD;;;GAGG;AACH,MAAqB,sBAAsB;IAMvC;;;;OAIG;IACH,YAAY,EAAE,YAAY,EAAwE;QAC9F,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,IAAI,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;QAC/B,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACG,aAAa,CAAC,MAAc;;YAC9B,4CAA4C;YAC5C,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjC,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;YAClD,CAAC;YAED,qDAAqD;YACrD,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjC,OAAO,CAAA,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,KAAI,IAAI,CAAC;YACxD,CAAC;YAED,2BAA2B;YAC3B,IAAI,WAAW,GAAG,MAAM,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,CAAC;gBAClC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBACjD,IAAI,CAAC,WAAW,EAAE,CAAC;oBACf,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;wBAC/C,IAAI,IAAA,mCAAc,EAAC,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC;4BAC9B,WAAW,GAAG,GAAG,CAAC;4BAClB,MAAM;wBACV,CAAC;oBACL,CAAC;oBACD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;gBAC9C,CAAC;YACL,CAAC;YAED,gDAAgD;YAChD,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,CAAC;gBAClD,OAAO,IAAI,CAAC;YAChB,CAAC;YAED,4CAA4C;YAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;YACxD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;YAE7C,MAAM,mBAAmB,GAAG,MAAM,YAAY,CAAC;YAC/C,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAElC,IAAI,mBAAmB,EAAE,CAAC;gBACtB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;YACxD,CAAC;YAED,OAAO,mBAAmB,CAAC;QAC/B,CAAC;KAAA;IAED;;;;OAIG;IACW,gBAAgB,CAAC,MAAc;;YACzC,IAAI,CAAC;gBACD,MAAM,cAAc,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;gBACjD,IAAI,CAAC,cAAc;oBAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,MAAM,EAAE,CAAC,CAAC;gBACtF,MAAM,UAAU,GAAG,MAAM,cAAc,EAAE,CAAC;gBAC1C,OAAO,UAAU,CAAC;YACtB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,uCAAuC,MAAM,GAAG,EAAE,KAAK,CAAC,CAAC;gBACvE,OAAO,IAAI,CAAC;YAChB,CAAC;QACL,CAAC;KAAA;CACJ;AApFD,yCAoFC"}