@tolgee/core 3.0.1 → 3.2.0

package/dist/tolgee.cjs.js

@@ -398,6 +398,9 @@ var TranslationService = /** @class */ (function () {
         this.eventService = eventService;
         this.translationsCache = new Map();
         this.fetchPromises = {};
+        // we need to distinguish which languages are in cache initially
+        // because we need to refetch them in dev mode
+        this.fetchedDev = {};
         this.updateTranslationInCache = function (data) { return __awaiter(_this, void 0, void 0, function () {
             var result;
             var _this = this;
@@ -490,8 +493,7 @@ var TranslationService = /** @class */ (function () {
     TranslationService.prototype.initStatic = function () {
         var _this = this;
         var _a;
-        if (this.properties.config.mode === 'production' &&
-            typeof ((_a = this.properties.config) === null || _a === void 0 ? void 0 : _a.staticData) === 'object') {
+        if (typeof ((_a = this.properties.config) === null || _a === void 0 ? void 0 : _a.staticData) === 'object') {
             Object.entries(this.properties.config.staticData).forEach(function (_a) {
                 var _b = __read(_a, 2), language = _b[0], data = _b[1];
                 //if not provider or promise then it is raw data
@@ -510,7 +512,7 @@ var TranslationService = /** @class */ (function () {
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
-                        if (!(this.translationsCache.get(lang) == undefined)) return [3 /*break*/, 2];
+                        if (!this.isFetchNeeded(lang)) return [3 /*break*/, 2];
                         if (!(this.fetchPromises[lang] instanceof Promise)) {
                             this.fetchPromises[lang] = this.fetchTranslations(lang);
                         }
@@ -521,7 +523,7 @@ var TranslationService = /** @class */ (function () {
                         _a.label = 2;
                     case 2:
                         this.fetchPromises[lang] = undefined;
-                        return [2 /*return*/];
+                        return [2 /*return*/, this.translationsCache.get(lang)];
                 }
             });
         });
@@ -529,25 +531,28 @@ var TranslationService = /** @class */ (function () {
     TranslationService.prototype.getTranslation = function (key, lang, defaultValue) {
         if (lang === void 0) { lang = this.properties.currentLanguage; }
         return __awaiter(this, void 0, void 0, function () {
-            var message;
+            var message, fallbackLang;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
-                        message = this.getFromCache(key, lang);
-                        if (!!message) return [3 /*break*/, 3];
+                        if (!this.isFetchNeeded(lang)) return [3 /*break*/, 2];
                         return [4 /*yield*/, this.loadTranslations(lang)];
                     case 1:
                         _a.sent();
+                        _a.label = 2;
+                    case 2:
                         message = this.getFromCache(key, lang);
-                        if (!!message) return [3 /*break*/, 3];
-                        message = this.getFromCache(key, this.properties.config.fallbackLanguage);
-                        if (!!message) return [3 /*break*/, 3];
+                        if (!!message) return [3 /*break*/, 5];
+                        fallbackLang = this.properties.config.fallbackLanguage;
+                        if (!this.isFetchNeeded(fallbackLang)) return [3 /*break*/, 4];
                         return [4 /*yield*/, this.loadTranslations(this.properties.config.fallbackLanguage)];
-                    case 2:
+                    case 3:
                         _a.sent();
+                        _a.label = 4;
+                    case 4:
                         message = this.getFromCache(key, this.properties.config.fallbackLanguage);
-                        _a.label = 3;
-                    case 3: return [2 /*return*/, TranslationService.translationByValue(message, defaultValue)];
+                        _a.label = 5;
+                    case 5: return [2 /*return*/, TranslationService.translationByValue(message, defaultValue)];
                 }
             });
         });
@@ -682,12 +687,20 @@ var TranslationService = /** @class */ (function () {
             this.getFromCache(key, this.properties.config.fallbackLanguage);
         return TranslationService.translationByValue(message, defaultValue);
     };
+    TranslationService.prototype.isFetchNeeded = function (lang) {
+        var isDevMode = this.properties.config.mode === 'development';
+        var dataPresent = this.translationsCache.get(lang) !== undefined;
+        var devFetched = Boolean(this.fetchedDev[lang]);
+        return (isDevMode && !devFetched) || !dataPresent;
+    };
     TranslationService.prototype.fetchTranslations = function (lang) {
         return __awaiter(this, void 0, void 0, function () {
+            var isDevMode;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
-                        if (!(this.properties.config.mode === 'development')) return [3 /*break*/, 2];
+                        isDevMode = this.properties.config.mode === 'development';
+                        if (!isDevMode) return [3 /*break*/, 2];
                         return [4 /*yield*/, this.fetchTranslationsDevelopment(lang)];
                     case 1: return [2 /*return*/, _a.sent()];
                     case 2: return [4 /*yield*/, this.fetchTranslationsProduction(lang)];
@@ -762,23 +775,26 @@ var TranslationService = /** @class */ (function () {
             var data, e_4;
             return __generator(this, function (_a) {
                 switch (_a.label) {
-                    case 0:
-                        this.coreService.checkScope('translations.view');
-                        _a.label = 1;
+                    case 0: return [4 /*yield*/, this.coreService.loadApiKeyDetails()];
                     case 1:
-                        _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, this.apiHttpService.fetchJson("v2/projects/translations/".concat(language))];
+                        _a.sent();
+                        this.coreService.checkScope('translations.view');
+                        _a.label = 2;
                     case 2:
+                        _a.trys.push([2, 4, , 5]);
+                        return [4 /*yield*/, this.apiHttpService.fetchJson("v2/projects/translations/".concat(language))];
+                    case 3:
                         data = _a.sent();
+                        this.fetchedDev[language] = true;
                         this.setLanguageData(language, data[language] || {});
-                        return [3 /*break*/, 4];
-                    case 3:
+                        return [3 /*break*/, 5];
+                    case 4:
                         e_4 = _a.sent();
                         // eslint-disable-next-line no-console
                         console.error('Error while fetching localization data from API.', e_4);
                         this.setEmptyLanguageData(language);
                         return [2 /*return*/];
-                    case 4: return [2 /*return*/];
+                    case 5: return [2 /*return*/];
                 }
             });
         });
@@ -1575,6 +1591,24 @@ var CoreService = /** @class */ (function () {
             throw new Error("Api key not permitted to do this, please add 'translations.view' scope.");
         }
     };
+    CoreService.prototype.loadApiKeyDetails = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var details;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!(this.properties.scopes === undefined)) return [3 /*break*/, 2];
+                        return [4 /*yield*/, this.getApiKeyDetails()];
+                    case 1:
+                        details = _a.sent();
+                        this.properties.scopes = details.scopes;
+                        this.properties.projectId = details.projectId;
+                        _a.label = 2;
+                    case 2: return [2 /*return*/];
+                }
+            });
+        });
+    };
     return CoreService;
 }());
 
@@ -2224,51 +2258,39 @@ var Coder$1 = /** @class */ (function () {
         return result;
     };
     Coder.prototype.unwrap = function (text) {
-        return __awaiter(this, void 0, void 0, function () {
-            var matchRegexp, keysAndParams, matched, match, start, result, pre, _a, fullMatch, wrapped, unwrapped, index, input, translated;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
-                    case 0:
-                        matchRegexp = new RegExp(this.rawUnWrapRegex, 'gs');
-                        keysAndParams = [];
-                        matched = false;
-                        start = 0;
-                        result = '';
-                        _b.label = 1;
-                    case 1:
-                        if (!((match = matchRegexp.exec(text)) !== null)) return [3 /*break*/, 3];
-                        pre = match[1];
-                        _a = __read(match, 4), fullMatch = _a[0], wrapped = _a[2], unwrapped = _a[3];
-                        index = match.index, input = match.input;
-                        result += input.substr(start, index - start);
-                        start = index + fullMatch.length;
-                        if (pre === '\\') {
-                            if (!TextHelper.isCharEscaped(index, text)) {
-                                result += wrapped;
-                                return [3 /*break*/, 1];
-                            }
-                            pre = '';
-                        }
-                        return [4 /*yield*/, this.getTranslatedWithMetadata(unwrapped)];
-                    case 2:
-                        translated = _b.sent();
-                        keysAndParams.push({
-                            key: translated.key,
-                            params: translated.params,
-                            defaultValue: translated.defaultValue,
-                        });
-                        matched = true;
-                        result += pre + translated.translated;
-                        return [3 /*break*/, 1];
-                    case 3:
-                        result += text.substring(start);
-                        if (matched) {
-                            return [2 /*return*/, { text: result, keys: keysAndParams }];
-                        }
-                        return [2 /*return*/, undefined];
+        var matchRegexp = new RegExp(this.rawUnWrapRegex, 'gs');
+        var keysAndParams = [];
+        var matched = false;
+        var match;
+        var start = 0;
+        var result = '';
+        while ((match = matchRegexp.exec(text)) !== null) {
+            var pre = match[1];
+            var _a = __read(match, 4), fullMatch = _a[0]; _a[1]; var wrapped = _a[2], unwrapped = _a[3];
+            var index = match.index, input = match.input;
+            result += input.substr(start, index - start);
+            start = index + fullMatch.length;
+            if (pre === '\\') {
+                if (!TextHelper.isCharEscaped(index, text)) {
+                    result += wrapped;
+                    continue;
                 }
+                pre = '';
+            }
+            var translated = this.getTranslatedWithMetadata(unwrapped);
+            keysAndParams.push({
+                key: translated.key,
+                params: translated.params,
+                defaultValue: translated.defaultValue,
             });
-        });
+            matched = true;
+            result += pre + translated.translated;
+        }
+        result += text.substring(start);
+        if (matched) {
+            return { text: result, keys: keysAndParams };
+        }
+        return undefined;
     };
     Coder.prototype.wrap = function (key, params, defaultValue) {
         var _this = this;
@@ -2285,19 +2307,9 @@ var Coder$1 = /** @class */ (function () {
         return "".concat(this.properties.config.inputPrefix).concat(this.escapeParam(key)).concat(defaultString).concat(paramString).concat(this.properties.config.inputSuffix);
     };
     Coder.prototype.getTranslatedWithMetadata = function (text) {
-        return __awaiter(this, void 0, void 0, function () {
-            var _a, key, params, defaultValue, translated;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
-                    case 0:
-                        _a = Coder.parseUnwrapped(text), key = _a.key, params = _a.params, defaultValue = _a.defaultValue;
-                        return [4 /*yield*/, this.textService.translate(key, params, undefined, false, defaultValue)];
-                    case 1:
-                        translated = _b.sent();
-                        return [2 /*return*/, { translated: translated, key: key, params: params, defaultValue: defaultValue }];
-                }
-            });
-        });
+        var _a = Coder.parseUnwrapped(text), key = _a.key, params = _a.params, defaultValue = _a.defaultValue;
+        var translated = this.textService.instant(key, params, undefined, false, defaultValue);
+        return { translated: translated, key: key, params: params, defaultValue: defaultValue };
     };
     return Coder;
 }());
@@ -2732,31 +2744,26 @@ var Coder = /** @class */ (function () {
         this.defaultMemory = new ValueMemory();
     }
     Coder.prototype.unwrap = function (text) {
-        return __awaiter(this, void 0, void 0, function () {
-            var keysAndParams, messages, result;
-            var _this = this;
-            return __generator(this, function (_a) {
-                keysAndParams = [];
-                messages = decodeFromText(text);
-                messages.forEach(function (msg) {
-                    var _a = __read(stringToCodePoints(msg), 2), keyCode = _a[0], defaultCode = _a[1];
-                    var key = _this.keyMemory.numberToValue(keyCode);
-                    var defaultValue = defaultCode !== undefined
-                        ? _this.defaultMemory.numberToValue(defaultCode)
-                        : undefined;
-                    keysAndParams.push({
-                        key: key,
-                        params: undefined,
-                        defaultValue: defaultValue,
-                    });
-                });
-                result = removeSecrets(text);
-                if (keysAndParams.length) {
-                    return [2 /*return*/, { text: result, keys: keysAndParams }];
-                }
-                return [2 /*return*/, undefined];
+        var _this = this;
+        var keysAndParams = [];
+        var messages = decodeFromText(text);
+        messages.forEach(function (msg) {
+            var _a = __read(stringToCodePoints(msg), 2), keyCode = _a[0], defaultCode = _a[1];
+            var key = _this.keyMemory.numberToValue(keyCode);
+            var defaultValue = defaultCode !== undefined
+                ? _this.defaultMemory.numberToValue(defaultCode)
+                : undefined;
+            keysAndParams.push({
+                key: key,
+                params: undefined,
+                defaultValue: defaultValue,
             });
         });
+        var result = removeSecrets(text);
+        if (keysAndParams.length) {
+            return { text: result, keys: keysAndParams };
+        }
+        return undefined;
     };
     Coder.prototype.wrap = function (key, _params, defaultValue, translation) {
         if (defaultValue === void 0) { defaultValue = undefined; }
@@ -2904,20 +2911,6 @@ var Tolgee = /** @class */ (function () {
         };
         this.dependencyService = new DependencyService();
     }
-    Tolgee.use = function (module) {
-        return new Tolgee().use(module);
-    };
-    Tolgee.init = function (config) {
-        return new Tolgee().init(config);
-    };
-    Tolgee.prototype.use = function (module) {
-        this.dependencyService.moduleService.addModule(module);
-        return this;
-    };
-    Tolgee.prototype.init = function (config) {
-        this.dependencyService.init(config);
-        return this;
-    };
     Object.defineProperty(Tolgee.prototype, "properties", {
         get: function () {
             return this.dependencyService.properties;
@@ -2925,28 +2918,26 @@ var Tolgee = /** @class */ (function () {
         enumerable: false,
         configurable: true
     });
-    Object.defineProperty(Tolgee.prototype, "translationService", {
-        get: function () {
-            return this.dependencyService.translationService;
-        },
-        enumerable: false,
-        configurable: true
-    });
-    Object.defineProperty(Tolgee.prototype, "coreService", {
-        get: function () {
-            return this.dependencyService.coreService;
-        },
-        enumerable: false,
-        configurable: true
-    });
     Object.defineProperty(Tolgee.prototype, "lang", {
         get: function () {
             return this.properties.currentLanguage;
         },
-        set: function (value) {
-            this.properties.currentLanguage = value;
-            this.dependencyService.eventService
-                .LANGUAGE_CHANGED.emit(value);
+        /**
+         * This sets a new language.
+         *
+         * Using this setter can behave buggy when you change languages
+         * too fast, since it changes the language property before
+         * translations are actually loaded.
+         * @deprecated use asynchronous changeLanguage method.
+         */
+        set: function (newLanguage) {
+            var _this = this;
+            this.properties.currentLanguage = newLanguage;
+            this.dependencyService.translationService
+                .loadTranslations(newLanguage)
+                .then(function () {
+                _this.emitLangChangeEvent(newLanguage);
+            });
         },
         enumerable: false,
         configurable: true
@@ -2973,6 +2964,10 @@ var Tolgee = /** @class */ (function () {
         configurable: true
     });
     Object.defineProperty(Tolgee.prototype, "onLangLoaded", {
+        /**
+         * Is emitted when language translations are loaded for the first time.
+         * It is not emitted when language is changed and translations were loaded before.
+         */
         get: function () {
             return this.dependencyService.eventService.LANGUAGE_LOADED;
         },
@@ -2987,23 +2982,63 @@ var Tolgee = /** @class */ (function () {
          * fetching so initial loading is not needed at all.
          */
         get: function () {
-            var _a, _b, _c, _d;
-            if (((_b = (_a = this.properties) === null || _a === void 0 ? void 0 : _a.config) === null || _b === void 0 ? void 0 : _b.mode) !== 'production') {
-                return true;
-            }
+            var _a, _b;
             var currentLang = this.properties.currentLanguage;
             var fallbackLang = this.properties.config.fallbackLanguage;
             var fallbackPreloading = this.properties.config.preloadFallback;
             var isStaticDataProvided = function (data) {
                 return data !== undefined && typeof data !== 'function';
             };
-            return (!isStaticDataProvided((_c = this.properties.config.staticData) === null || _c === void 0 ? void 0 : _c[currentLang]) ||
+            return (!isStaticDataProvided((_a = this.properties.config.staticData) === null || _a === void 0 ? void 0 : _a[currentLang]) ||
                 (!!fallbackPreloading &&
-                    !isStaticDataProvided((_d = this.properties.config.staticData) === null || _d === void 0 ? void 0 : _d[fallbackLang])));
+                    !isStaticDataProvided((_b = this.properties.config.staticData) === null || _b === void 0 ? void 0 : _b[fallbackLang])));
         },
         enumerable: false,
         configurable: true
     });
+    Object.defineProperty(Tolgee.prototype, "coreService", {
+        get: function () {
+            return this.dependencyService.coreService;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Tolgee.use = function (module) {
+        return new Tolgee().use(module);
+    };
+    Tolgee.init = function (config) {
+        return new Tolgee().init(config);
+    };
+    /**
+     * Sets the new language.
+     *
+     * Emits the onLangChange and onLangChangeAndLoad events after
+     * the translations are loaded.
+     *
+     * @return Promise<void> Resolves when translations are loaded
+     */
+    Tolgee.prototype.changeLanguage = function (newLanguage) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.dependencyService.translationService.loadTranslations(newLanguage)];
+                    case 1:
+                        _a.sent();
+                        this.properties.currentLanguage = newLanguage;
+                        this.emitLangChangeEvent(newLanguage);
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    Tolgee.prototype.use = function (module) {
+        this.dependencyService.moduleService.addModule(module);
+        return this;
+    };
+    Tolgee.prototype.init = function (config) {
+        this.dependencyService.init(config);
+        return this;
+    };
     Tolgee.prototype.run = function () {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
@@ -3011,18 +3046,18 @@ var Tolgee = /** @class */ (function () {
                     case 0:
                         this.dependencyService.run();
                         if (!(this.properties.config.mode === 'development')) return [3 /*break*/, 2];
-                        return [4 /*yield*/, this.loadApiKeyDetails()];
+                        return [4 /*yield*/, this.coreService.loadApiKeyDetails()];
                     case 1:
                         _a.sent();
                         _a.label = 2;
-                    case 2: return [4 /*yield*/, this.translationService.loadTranslations()];
+                    case 2: return [4 /*yield*/, this.dependencyService.translationService.loadTranslations()];
                     case 3:
                         _a.sent();
                         return [4 /*yield*/, this.dependencyService.pluginManager.run()];
                     case 4:
                         _a.sent();
                         if (!this.properties.config.preloadFallback) return [3 /*break*/, 6];
-                        return [4 /*yield*/, this.translationService.loadTranslations(this.properties.config.fallbackLanguage)];
+                        return [4 /*yield*/, this.dependencyService.translationService.loadTranslations(this.properties.config.fallbackLanguage)];
                     case 5:
                         _a.sent();
                         _a.label = 6;
@@ -3065,18 +3100,15 @@ var Tolgee = /** @class */ (function () {
                                 props.defaultValue !== undefined ? props.defaultValue : defaultValue;
                             orEmpty = props.orEmpty;
                         }
-                        if (!(this.properties.config.mode === 'development' && !noWrap)) return [3 /*break*/, 4];
-                        return [4 /*yield*/, this.loadApiKeyDetails()];
+                        return [4 /*yield*/, this.dependencyService.textService.translate(key, params, undefined, orEmpty, defaultValue)];
                     case 1:
-                        _a.sent();
-                        return [4 /*yield*/, this.translationService.loadTranslations()];
+                        translation = _a.sent();
+                        if (!(this.properties.config.mode === 'development' && !noWrap)) return [3 /*break*/, 3];
+                        return [4 /*yield*/, this.coreService.loadApiKeyDetails()];
                     case 2:
                         _a.sent();
-                        return [4 /*yield*/, this.dependencyService.textService.translate(key, params, undefined, orEmpty, defaultValue)];
-                    case 3:
-                        translation = _a.sent();
                         return [2 /*return*/, this.dependencyService.wrapper.wrap(key, params, defaultValue, translation)];
-                    case 4: return [2 /*return*/, this.dependencyService.textService.translate(key, params, undefined, orEmpty, defaultValue)];
+                    case 3: return [2 /*return*/, translation];
                 }
             });
         });
@@ -3109,23 +3141,22 @@ var Tolgee = /** @class */ (function () {
         }
         return translation;
     };
-    Tolgee.prototype.loadApiKeyDetails = function () {
-        return __awaiter(this, void 0, void 0, function () {
-            var details;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        if (!(this.properties.scopes === undefined)) return [3 /*break*/, 2];
-                        return [4 /*yield*/, this.dependencyService.coreService.getApiKeyDetails()];
-                    case 1:
-                        details = _a.sent();
-                        this.properties.scopes = details.scopes;
-                        this.properties.projectId = details.projectId;
-                        _a.label = 2;
-                    case 2: return [2 /*return*/];
-                }
-            });
-        });
+    /**
+     * Get currently cached translations for all languages
+     */
+    Tolgee.prototype.getCachedTranslations = function () {
+        return this.dependencyService.translationService.getCachedTranslations();
+    };
+    /**
+     * Loads translations for given language or returns them from cache
+     * @returns Loaded translations
+     */
+    Tolgee.prototype.loadTranslations = function (lang) {
+        return this.dependencyService.translationService.loadTranslations(lang);
+    };
+    Tolgee.prototype.emitLangChangeEvent = function (value) {
+        var langChangedEmitter = this.onLangChange;
+        langChangedEmitter.emit(value);
     };
     return Tolgee;
 }());