@digitaldefiance/i18n-lib 1.0.24 → 1.0.26

package/dist/default-config.d.ts

@@ -2,7 +2,13 @@ import { I18nEngine } from './i18n-engine';
 import { Timezone } from './timezone';
 import { I18nContext, LanguageCodeCollection } from './types';
 export declare enum DefaultStringKey {
-    Common_Test = "common_test"
+    Common_Test = "common_test",
+    Error_InstanceAlreadyExistsTemplate = "error_instanceAlreadyExistsTemplate",
+    Error_InstanceNotFoundTemplate = "error_instanceNotFoundTemplate",
+    Error_MissingStringCollectionTemplate = "error_missingStringCollectionTemplate",
+    Error_MissingTranslationTemplate = "error_missingTranslationTemplate",
+    Error_DefaultLanguageNoCollectionTemplate = "error_defaultLanguageNoCollectionTemplate",
+    Error_MissingTranslationKeyTemplate = "error_missingTranslationKeyTemplate"
 }
 export declare enum DefaultLanguage {
     EnglishUS = "English (US)",

package/dist/default-config.js

@@ -9,6 +9,12 @@ const types_1 = require("./types");
 var DefaultStringKey;
 (function (DefaultStringKey) {
     DefaultStringKey["Common_Test"] = "common_test";
+    DefaultStringKey["Error_InstanceAlreadyExistsTemplate"] = "error_instanceAlreadyExistsTemplate";
+    DefaultStringKey["Error_InstanceNotFoundTemplate"] = "error_instanceNotFoundTemplate";
+    DefaultStringKey["Error_MissingStringCollectionTemplate"] = "error_missingStringCollectionTemplate";
+    DefaultStringKey["Error_MissingTranslationTemplate"] = "error_missingTranslationTemplate";
+    DefaultStringKey["Error_DefaultLanguageNoCollectionTemplate"] = "error_defaultLanguageNoCollectionTemplate";
+    DefaultStringKey["Error_MissingTranslationKeyTemplate"] = "error_missingTranslationKeyTemplate";
 })(DefaultStringKey || (exports.DefaultStringKey = DefaultStringKey = {}));
 var DefaultLanguage;
 (function (DefaultLanguage) {
@@ -34,21 +40,57 @@ const getConfig = (constants, timezone, adminTimezone) => ({
     strings: {
         [DefaultLanguage.EnglishUS]: {
             [DefaultStringKey.Common_Test]: 'Test',
+            [DefaultStringKey.Error_InstanceAlreadyExistsTemplate]: 'Instance with key \'{key}\' already exists',
+            [DefaultStringKey.Error_InstanceNotFoundTemplate]: 'Instance with key \'{key}\' not found',
+            [DefaultStringKey.Error_MissingStringCollectionTemplate]: 'Missing string collection for language: {language}',
+            [DefaultStringKey.Error_MissingTranslationTemplate]: 'Missing translation for key \'{key}\' in language \'{language}\'',
+            [DefaultStringKey.Error_DefaultLanguageNoCollectionTemplate]: 'Default language \'{language}\' has no string collection',
+            [DefaultStringKey.Error_MissingTranslationKeyTemplate]: 'Missing translation key for type: {type}',
         },
         [DefaultLanguage.EnglishUK]: {
             [DefaultStringKey.Common_Test]: 'Test',
+            [DefaultStringKey.Error_InstanceAlreadyExistsTemplate]: 'Instance with key \'{key}\' already exists',
+            [DefaultStringKey.Error_InstanceNotFoundTemplate]: 'Instance with key \'{key}\' not found',
+            [DefaultStringKey.Error_MissingStringCollectionTemplate]: 'Missing string collection for language: {language}',
+            [DefaultStringKey.Error_MissingTranslationTemplate]: 'Missing translation for key \'{key}\' in language \'{language}\'',
+            [DefaultStringKey.Error_DefaultLanguageNoCollectionTemplate]: 'Default language \'{language}\' has no string collection',
+            [DefaultStringKey.Error_MissingTranslationKeyTemplate]: 'Missing translation key for type: {type}',
         },
         [DefaultLanguage.French]: {
             [DefaultStringKey.Common_Test]: 'Test',
+            [DefaultStringKey.Error_InstanceAlreadyExistsTemplate]: 'Instance avec clé \'{key}\' existe déjà',
+            [DefaultStringKey.Error_InstanceNotFoundTemplate]: 'Instance avec clé \'{key}\' introuvable',
+            [DefaultStringKey.Error_MissingStringCollectionTemplate]: 'Collection de chaînes manquante pour la langue: {language}',
+            [DefaultStringKey.Error_MissingTranslationTemplate]: 'Traduction manquante pour la clé \'{key}\' dans la langue \'{language}\'',
+            [DefaultStringKey.Error_DefaultLanguageNoCollectionTemplate]: 'La langue par défaut \'{language}\' n\'a pas de collection de chaînes',
+            [DefaultStringKey.Error_MissingTranslationKeyTemplate]: 'Clé de traduction manquante pour le type: {type}',
         },
         [DefaultLanguage.MandarinChinese]: {
             [DefaultStringKey.Common_Test]: '测试',
+            [DefaultStringKey.Error_InstanceAlreadyExistsTemplate]: '键为\'{key}\'的实例已存在',
+            [DefaultStringKey.Error_InstanceNotFoundTemplate]: '未找到键为\'{key}\'的实例',
+            [DefaultStringKey.Error_MissingStringCollectionTemplate]: '缺少语言的字符串集合: {language}',
+            [DefaultStringKey.Error_MissingTranslationTemplate]: '在语言\'{language}\'中缺少键\'{key}\'的翻译',
+            [DefaultStringKey.Error_DefaultLanguageNoCollectionTemplate]: '默认语言\'{language}\'没有字符串集合',
+            [DefaultStringKey.Error_MissingTranslationKeyTemplate]: '类型缺少翻译键: {type}',
         },
         [DefaultLanguage.Spanish]: {
             [DefaultStringKey.Common_Test]: 'Prueba',
+            [DefaultStringKey.Error_InstanceAlreadyExistsTemplate]: 'La instancia con clave \'{key}\' ya existe',
+            [DefaultStringKey.Error_InstanceNotFoundTemplate]: 'Instancia con clave \'{key}\' no encontrada',
+            [DefaultStringKey.Error_MissingStringCollectionTemplate]: 'Falta colección de cadenas para el idioma: {language}',
+            [DefaultStringKey.Error_MissingTranslationTemplate]: 'Falta traducción para la clave \'{key}\' en el idioma \'{language}\'',
+            [DefaultStringKey.Error_DefaultLanguageNoCollectionTemplate]: 'El idioma predeterminado \'{language}\' no tiene colección de cadenas',
+            [DefaultStringKey.Error_MissingTranslationKeyTemplate]: 'Falta clave de traducción para el tipo: {type}',
         },
         [DefaultLanguage.Ukrainian]: {
             [DefaultStringKey.Common_Test]: 'Тест',
+            [DefaultStringKey.Error_InstanceAlreadyExistsTemplate]: 'Екземпляр з ключем \'{key}\' вже існує',
+            [DefaultStringKey.Error_InstanceNotFoundTemplate]: 'Екземпляр з ключем \'{key}\' не знайдено',
+            [DefaultStringKey.Error_MissingStringCollectionTemplate]: 'Відсутня колекція рядків для мови: {language}',
+            [DefaultStringKey.Error_MissingTranslationTemplate]: 'Відсутній переклад для ключа \'{key}\' в мові \'{language}\'',
+            [DefaultStringKey.Error_DefaultLanguageNoCollectionTemplate]: 'Мова за замовчуванням \'{language}\' не має колекції рядків',
+            [DefaultStringKey.Error_MissingTranslationKeyTemplate]: 'Відсутній ключ перекладу для типу: {type}',
         },
     },
     stringNames: Object.values(DefaultStringKey),

package/dist/typed-error.d.ts

@@ -0,0 +1,9 @@
+import { Language, StringKey } from './default-config';
+import { I18nEngine } from './i18n-engine';
+export declare abstract class TypedError<T extends string | number> extends Error {
+    readonly type: T;
+    readonly reasonMap: Record<T, StringKey>;
+    readonly language?: Language | undefined;
+    readonly otherVars?: Record<string, string | number> | undefined;
+    constructor(engine: I18nEngine<StringKey, Language, Record<string, any>, string>, type: T, reasonMap: Record<T, StringKey>, language?: Language | undefined, otherVars?: Record<string, string | number> | undefined);
+}

package/dist/typed-error.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypedError = void 0;
+const default_config_1 = require("./default-config");
+class TypedError extends Error {
+    constructor(engine, type, reasonMap, language, otherVars) {
+        const key = reasonMap[type];
+        if (!key)
+            throw new Error(engine.translate(default_config_1.DefaultStringKey.Error_MissingTranslationKeyTemplate, { type }, language));
+        super(engine.translate(key, otherVars, language));
+        this.type = type;
+        this.reasonMap = reasonMap;
+        this.language = language;
+        this.otherVars = otherVars;
+        this.name = this.constructor.name;
+    }
+}
+exports.TypedError = TypedError;

package/dist/utils.d.ts

@@ -26,16 +26,16 @@ export declare function isValidTimezone(timezone: string): boolean;
 export declare function toStringKey<TStringKey extends string>(...parts: (string)[]): TStringKey;
 /**
  * Converts an enum value to a string key by joining parts with underscores and appending the enum value.
- * @param enumObj - The enum object
  * @param value - The enum value
  * @param parts - Additional parts to join
  * @returns The constructed string key
  */
-export declare function toStringKeyFromEnum<TStringKey extends string, TEnum extends string>(value: TEnum[keyof TEnum], ...parts: (string)[]): TStringKey;
+export declare function toStringKeyFromEnum<TStringKey extends string>(value: string, ...parts: string[]): TStringKey;
 /**
  * Builds a reason map from an enum object, mapping each enum value to a string key.
  * @param enumObj - The enum object
  * @param prefixes - Prefixes to prepend to each string key
+ * @param templateKeys - Optional set of enum values that should have 'Template' suffix for template processing
  * @returns The constructed reason map
  */
-export declare function buildReasonMap<TStringKey extends string, TEnum extends Record<string, string>>(enumObj: TEnum, ...prefixes: string[]): Record<string, TStringKey>;
+export declare function buildReasonMap<TEnum extends Record<string, string>, TStringKey extends string>(enumObj: TEnum, prefixes?: string[], templateKeys?: Set<TEnum[keyof TEnum]>): Record<TEnum[keyof TEnum], TStringKey>;

package/dist/utils.js

@@ -63,23 +63,27 @@ function toStringKey(...parts) {
 }
 /**
  * Converts an enum value to a string key by joining parts with underscores and appending the enum value.
- * @param enumObj - The enum object
  * @param value - The enum value
  * @param parts - Additional parts to join
  * @returns The constructed string key
  */
 function toStringKeyFromEnum(value, ...parts) {
-    return parts.join('_') + '_' + String(value);
+    const allParts = [...parts, value];
+    return allParts.join('_');
 }
 /**
  * Builds a reason map from an enum object, mapping each enum value to a string key.
  * @param enumObj - The enum object
  * @param prefixes - Prefixes to prepend to each string key
+ * @param templateKeys - Optional set of enum values that should have 'Template' suffix for template processing
  * @returns The constructed reason map
  */
-function buildReasonMap(enumObj, ...prefixes) {
-    return Object.values(enumObj).reduce((map, value) => {
-        map[value] = toStringKeyFromEnum(value, ...prefixes);
-        return map;
-    }, {});
+function buildReasonMap(enumObj, prefixes = [], templateKeys) {
+    const map = {};
+    Object.values(enumObj).forEach(value => {
+        const baseKey = [...prefixes, value].join('_');
+        const finalKey = templateKeys?.has(value) ? baseKey + 'Template' : baseKey;
+        map[value] = finalKey;
+    });
+    return map;
 }

package/package.json

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