@digitaldefiance/i18n-lib 1.0.31 → 1.0.33

package/dist/enum-registry.d.ts

@@ -2,9 +2,12 @@ import { EnumLanguageTranslation } from './types';
 /**
  * Registry for managing enum translations across multiple languages.
  */
-export declare class EnumTranslationRegistry<TLanguage extends string> {
+export declare class EnumTranslationRegistry<TStringKey extends string, TLanguage extends string> {
     protected translations: Map<any, Partial<{ [L in TLanguage]: import("./types").EnumTranslation<any>; }>>;
     protected enumNames: WeakMap<any, string>;
+    protected availableLanguages: Set<TLanguage>;
+    protected translateFn?: (key: TStringKey, vars?: Record<string, any>) => string;
+    constructor(availableLanguages: TLanguage[], translateFn?: (key: TStringKey, vars?: Record<string, any>) => string);
     /**
      * Registers an enumeration with its translations and a name.
      * @param enumObj The enumeration object
@@ -32,4 +35,10 @@ export declare class EnumTranslationRegistry<TLanguage extends string> {
      * @returns True if translations exist, false otherwise
      */
     has(enumObj: any): boolean;
+    /**
+     * Validates that enum translations only contain available languages.
+     * @param translations The translations to validate
+     * @param enumName The name of the enumeration for error messages
+     */
+    private validateTranslations;
 }

package/dist/enum-registry.js

@@ -5,9 +5,11 @@ exports.EnumTranslationRegistry = void 0;
  * Registry for managing enum translations across multiple languages.
  */
 class EnumTranslationRegistry {
-    constructor() {
+    constructor(availableLanguages, translateFn) {
         this.translations = new Map();
         this.enumNames = new WeakMap();
+        this.availableLanguages = new Set(availableLanguages);
+        this.translateFn = translateFn;
     }
     /**
      * Registers an enumeration with its translations and a name.
@@ -16,6 +18,7 @@ class EnumTranslationRegistry {
      * @param enumName The name of the enumeration
      */
     register(enumObj, translations, enumName) {
+        this.validateTranslations(translations, enumName);
         this.translations.set(enumObj, translations);
         this.enumNames.set(enumObj, enumName);
     }
@@ -29,11 +32,17 @@ class EnumTranslationRegistry {
     translate(enumObj, value, language) {
         const translations = this.translations.get(enumObj);
         if (!translations) {
-            throw new Error(`No translations found for enum: ${this.getEnumName(enumObj)}`);
+            const message = this.translateFn
+                ? this.translateFn('Error_EnumNotFoundTemplate', { enumName: this.getEnumName(enumObj) })
+                : `No translations found for enum: ${this.getEnumName(enumObj)}`;
+            throw new Error(message);
         }
         const langTranslations = translations[language];
         if (!langTranslations) {
-            throw new Error(`No translations found for language: ${language}`);
+            const message = this.translateFn
+                ? this.translateFn('Error_EnumLanguageNotFoundTemplate', { language })
+                : `No translations found for language: ${language}`;
+            throw new Error(message);
         }
         let result = langTranslations[value];
         if (!result && typeof value === 'number') {
@@ -43,7 +52,10 @@ class EnumTranslationRegistry {
             }
         }
         if (!result) {
-            throw new Error(`No translation found for value: ${String(value)}`);
+            const message = this.translateFn
+                ? this.translateFn('Error_EnumValueNotFoundTemplate', { value: String(value) })
+                : `No translation found for value: ${String(value)}`;
+            throw new Error(message);
         }
         return result;
     }
@@ -63,5 +75,20 @@ class EnumTranslationRegistry {
     has(enumObj) {
         return this.translations.has(enumObj);
     }
+    /**
+     * Validates that enum translations only contain available languages.
+     * @param translations The translations to validate
+     * @param enumName The name of the enumeration for error messages
+     */
+    validateTranslations(translations, enumName) {
+        for (const language of Object.keys(translations)) {
+            if (!this.availableLanguages.has(language)) {
+                const message = this.translateFn
+                    ? this.translateFn('Error_EnumLanguageNotAvailableTemplate', { language, enumName })
+                    : `Language '${language}' in enum '${enumName}' is not available in this engine instance`;
+                throw new Error(message);
+            }
+        }
+    }
 }
 exports.EnumTranslationRegistry = EnumTranslationRegistry;

package/dist/i18n-engine.d.ts

@@ -7,7 +7,7 @@ export declare class I18nEngine<TStringKey extends string, TLanguage extends str
     /**
      * Registry for enum translations
      */
-    protected enumRegistry: EnumTranslationRegistry<TLanguage>;
+    protected _enumRegistry: EnumTranslationRegistry<TStringKey, TLanguage>;
     /**
      * Configuration for the i18n engine
      */
@@ -74,6 +74,11 @@ export declare class I18nEngine<TStringKey extends string, TLanguage extends str
      * @param context The context to set
      */
     set context(context: Partial<TContext>);
+    /**
+     * Gets the enum translation registry for this engine instance
+     * @returns The enum translation registry
+     */
+    get enumRegistry(): EnumTranslationRegistry<TStringKey, TLanguage>;
     /**
      * Translates a string key into the specified language, replacing any variables as needed.
      * @param key The string key to translate

package/dist/i18n-engine.js

@@ -18,7 +18,7 @@ class I18nEngine {
     constructor(config, key, newContext = () => (0, context_1.createContext)(config.defaultLanguage, config.defaultTranslationContext, config.defaultCurrencyCode, config.timezone, config.adminTimezone)) {
         this.validateConfig(config);
         this.config = config;
-        this.enumRegistry = new enum_registry_1.EnumTranslationRegistry();
+        this._enumRegistry = new enum_registry_1.EnumTranslationRegistry(Object.keys(config.strings), (key, vars) => this.safeTranslate(key, vars));
         this._context = newContext();
         const instanceKey = key || I18nEngine.DefaultInstanceKey;
         if (I18nEngine._instances.has(instanceKey)) {
@@ -91,6 +91,13 @@ class I18nEngine {
     set context(context) {
         this._context = { ...this._context, ...context };
     }
+    /**
+     * Gets the enum translation registry for this engine instance
+     * @returns The enum translation registry
+     */
+    get enumRegistry() {
+        return this._enumRegistry;
+    }
     /**
      * Translates a string key into the specified language, replacing any variables as needed.
      * @param key The string key to translate
@@ -107,19 +114,27 @@ class I18nEngine {
         const fallback = fallbackLanguage ?? this.config.defaultLanguage;
         try {
             const stringValue = this.getString(lang, key);
-            const result = (0, utils_1.isTemplate)(key)
+            let result = (0, utils_1.isTemplate)(key)
                 ? (0, utils_1.replaceVariables)(stringValue, vars, this.config.constants)
                 : stringValue;
-            return typeof result === 'string' ? result : String(result);
+            // Ensure result is always a string
+            if (typeof result !== 'string') {
+                result = String(result);
+            }
+            return result;
         }
         catch {
             if (lang !== fallback) {
                 try {
                     const stringValue = this.getString(fallback, key);
-                    const result = (0, utils_1.isTemplate)(key)
+                    let result = (0, utils_1.isTemplate)(key)
                         ? (0, utils_1.replaceVariables)(stringValue, vars, this.config.constants)
                         : stringValue;
-                    return typeof result === 'string' ? result : String(result);
+                    // Ensure result is always a string
+                    if (typeof result !== 'string') {
+                        result = String(result);
+                    }
+                    return result;
                 }
                 catch {
                     return String(key);
@@ -136,7 +151,7 @@ class I18nEngine {
      * @returns The translated enumeration value
      */
     translateEnum(enumObj, value, language) {
-        return this.enumRegistry.translate(enumObj, value, language);
+        return this._enumRegistry.translate(enumObj, value, language);
     }
     /**
      * Registers an enumeration and its translations with the engine.
@@ -145,7 +160,7 @@ class I18nEngine {
      * @param enumName The name of the enumeration (for error messages)
      */
     registerEnum(enumObj, translations, enumName) {
-        this.enumRegistry.register(enumObj, translations, enumName);
+        this._enumRegistry.register(enumObj, translations, enumName);
     }
     /**
      * Safe translation that prevents infinite recursion for error messages
@@ -161,10 +176,14 @@ class I18nEngine {
             if (!strings?.[key])
                 return String(key);
             const stringValue = strings[key];
-            const result = (0, utils_1.isTemplate)(key)
+            let result = (0, utils_1.isTemplate)(key)
                 ? (0, utils_1.replaceVariables)(stringValue, vars, this.config.constants)
                 : stringValue;
-            return typeof result === 'string' ? result : String(result);
+            // Ensure result is always a string
+            if (typeof result !== 'string') {
+                result = String(result);
+            }
+            return result;
         }
         catch {
             return String(key);
@@ -262,12 +281,12 @@ class I18nEngine {
      * @throws Error if validation fails
      */
     validateConfig(config) {
-        // Check that all languages in languageCodes have string collections
-        for (const language of Object.keys(config.languageCodes)) {
-            if (!config.strings[language]) {
-                throw new Error(this.getValidationError('Error_MissingStringCollectionTemplate', { language }, config));
-            }
-            // Check that all string keys are provided for this language
+        // Check that default language exists
+        if (!config.strings[config.defaultLanguage]) {
+            throw new Error(this.getValidationError('Error_DefaultLanguageNoCollectionTemplate', { language: config.defaultLanguage }, config));
+        }
+        // Check that all string keys are provided for each language that has strings
+        for (const language of Object.keys(config.strings)) {
             const strings = config.strings[language];
             for (const stringKey of config.stringNames) {
                 if (!strings[stringKey]) {
@@ -275,10 +294,6 @@ class I18nEngine {
                 }
             }
         }
-        // Check that default language exists
-        if (!config.strings[config.defaultLanguage]) {
-            throw new Error(this.getValidationError('Error_DefaultLanguageNoCollectionTemplate', { language: config.defaultLanguage }, config));
-        }
     }
     /**
      * Gets validation error message, trying translation first, falling back to template

package/dist/utils.js

@@ -21,6 +21,10 @@ const moment_timezone_1 = __importDefault(require("moment-timezone"));
  * @returns The string with variables replaced
  */
 function replaceVariables(str, vars, constants) {
+    // Ensure input is a string
+    if (typeof str !== 'string') {
+        str = String(str);
+    }
     const variables = str.match(/\{(.+?)\}/g);
     if (!variables)
         return str;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitaldefiance/i18n-lib",
-  "version": "1.0.31",
+  "version": "1.0.33",
   "description": "Generic i18n library with enum translation support",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",