@tolgee/core 3.0.1 → 3.2.0

package/dist/tolgee.umd.js

@@ -400,6 +400,9 @@
             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;
@@ -492,8 +495,7 @@
         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
@@ -512,7 +514,7 @@
                 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);
                             }
@@ -523,7 +525,7 @@
                             _a.label = 2;
                         case 2:
                             this.fetchPromises[lang] = undefined;
-                            return [2 /*return*/];
+                            return [2 /*return*/, this.translationsCache.get(lang)];
                     }
                 });
             });
@@ -531,25 +533,28 @@
         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)];
                     }
                 });
             });
@@ -684,12 +689,20 @@
                 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)];
@@ -764,23 +777,26 @@
                 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*/];
                     }
                 });
             });
@@ -1577,6 +1593,24 @@
                 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;
     }());
 
@@ -2226,51 +2260,39 @@
             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;
@@ -2287,19 +2309,9 @@
             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;
     }());
@@ -2734,31 +2746,26 @@
             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; }
@@ -2906,20 +2913,6 @@
             };
             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;
@@ -2927,28 +2920,26 @@
             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
@@ -2975,6 +2966,10 @@
             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;
             },
@@ -2989,23 +2984,63 @@
              * 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) {
@@ -3013,18 +3048,18 @@
                         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;
@@ -3067,18 +3102,15 @@
                                     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];
                     }
                 });
             });
@@ -3111,23 +3143,22 @@
             }
             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;
     }());