@digitaldefiance/i18n-lib 1.2.4 → 1.3.0

package/dist/core-i18n.d.ts

@@ -7,7 +7,11 @@ import { CoreStringKey } from './core-string-key';
 import { LanguageCodes } from './language-codes';
 import { LanguageDefinition } from './language-definition';
 import { PluginI18nEngine } from './plugin-i18n-engine';
-export type CoreLanguageCode = typeof LanguageCodes.EN_US | typeof LanguageCodes.EN_GB | typeof LanguageCodes.FR | typeof LanguageCodes.ES | typeof LanguageCodes.DE | typeof LanguageCodes.ZH_CN | typeof LanguageCodes.JA | typeof LanguageCodes.UK;
+/**
+ * Core language code type - derived from LanguageCodes for type safety
+ * Use this for type parameters when you want to restrict to core languages only
+ */
+export type CoreLanguageCode = typeof LanguageCodes[keyof typeof LanguageCodes];
 /**
  * Create default language definitions
  */
@@ -25,6 +29,14 @@ export declare function createCoreComponentStrings(): import("./strict-types").C
  * Create core component registration
  */
 export declare function createCoreComponentRegistration(): ComponentRegistration<CoreStringKey, CoreLanguageCode>;
+/**
+ * Get core language codes as array (for Mongoose enums, etc.)
+ */
+export declare function getCoreLanguageCodes(): string[];
+/**
+ * Get core language definitions
+ */
+export declare function getCoreLanguageDefinitions(): LanguageDefinition[];
 /**
  * Create a pre-configured I18n engine with core components
  */

package/dist/core-i18n.js

@@ -7,6 +7,8 @@ exports.CoreComponentDefinition = exports.CoreI18nComponentId = void 0;
 exports.createDefaultLanguages = createDefaultLanguages;
 exports.createCoreComponentStrings = createCoreComponentStrings;
 exports.createCoreComponentRegistration = createCoreComponentRegistration;
+exports.getCoreLanguageCodes = getCoreLanguageCodes;
+exports.getCoreLanguageDefinitions = getCoreLanguageDefinitions;
 exports.createCoreI18nEngine = createCoreI18nEngine;
 exports.getCoreTranslation = getCoreTranslation;
 exports.safeCoreTranslation = safeCoreTranslation;
@@ -433,6 +435,18 @@ function createCoreComponentRegistration() {
         strings: createCoreComponentStrings(),
     };
 }
+/**
+ * Get core language codes as array (for Mongoose enums, etc.)
+ */
+function getCoreLanguageCodes() {
+    return Object.values(language_codes_1.LanguageCodes);
+}
+/**
+ * Get core language definitions
+ */
+function getCoreLanguageDefinitions() {
+    return createDefaultLanguages();
+}
 /**
  * Create a pre-configured I18n engine with core components
  */

package/dist/create-translation-adapter.d.ts

@@ -0,0 +1,20 @@
+import { PluginI18nEngine } from './plugin-i18n-engine';
+import { TranslationEngine } from './translation-engine';
+/**
+ * Creates a TranslationEngine adapter from a PluginI18nEngine for a specific component.
+ * This allows PluginI18nEngine to be used where TranslationEngine interface is expected.
+ *
+ * @param pluginEngine - The PluginI18nEngine instance to wrap
+ * @param componentId - The component ID to use for translations
+ * @returns A TranslationEngine that delegates to the PluginI18nEngine
+ *
+ * @example
+ * ```typescript
+ * const pluginEngine = getMyPluginI18nEngine();
+ * const adapter = createTranslationAdapter(pluginEngine, 'my-component');
+ *
+ * // Now can be used where TranslationEngine is expected
+ * const error = new MyError(errorType, adapter);
+ * ```
+ */
+export declare function createTranslationAdapter<TStringKey extends string, TLanguage extends string>(pluginEngine: PluginI18nEngine<TLanguage>, componentId: string): TranslationEngine<TStringKey>;

package/dist/create-translation-adapter.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTranslationAdapter = createTranslationAdapter;
+/**
+ * Creates a TranslationEngine adapter from a PluginI18nEngine for a specific component.
+ * This allows PluginI18nEngine to be used where TranslationEngine interface is expected.
+ *
+ * @param pluginEngine - The PluginI18nEngine instance to wrap
+ * @param componentId - The component ID to use for translations
+ * @returns A TranslationEngine that delegates to the PluginI18nEngine
+ *
+ * @example
+ * ```typescript
+ * const pluginEngine = getMyPluginI18nEngine();
+ * const adapter = createTranslationAdapter(pluginEngine, 'my-component');
+ *
+ * // Now can be used where TranslationEngine is expected
+ * const error = new MyError(errorType, adapter);
+ * ```
+ */
+function createTranslationAdapter(pluginEngine, componentId) {
+    return {
+        translate: (key, vars, lang) => {
+            try {
+                return pluginEngine.translate(componentId, key, vars, lang);
+            }
+            catch (error) {
+                // Fallback to key if translation fails
+                return String(key);
+            }
+        },
+        safeTranslate: (key, vars, lang) => {
+            return pluginEngine.safeTranslate(componentId, key, vars, lang);
+        },
+    };
+}

package/dist/index.d.ts

@@ -35,6 +35,7 @@ export * from './registry-error-type';
 export * from './translation-engine';
 export * from './translation-request';
 export * from './translation-response';
+export * from './create-translation-adapter';
 export { createCoreI18nEngine as createCoreI18n } from './core-i18n';
 export { I18nEngine as I18n } from './i18n-engine';
 export { PluginI18nEngine as PluginI18n } from './plugin-i18n-engine';

package/dist/index.js

@@ -54,6 +54,7 @@ __exportStar(require("./registry-error-type"), exports);
 __exportStar(require("./translation-engine"), exports);
 __exportStar(require("./translation-request"), exports);
 __exportStar(require("./translation-response"), exports);
+__exportStar(require("./create-translation-adapter"), exports);
 // Re-export for convenience
 var core_i18n_1 = require("./core-i18n");
 Object.defineProperty(exports, "createCoreI18n", { enumerable: true, get: function () { return core_i18n_1.createCoreI18nEngine; } });

package/dist/typed-error.js

@@ -215,7 +215,7 @@ class UserError extends PluginTypedError<typeof UserErrorType, UserErrorStringKe
     engine: PluginI18nEngine<CoreLanguageCode>,
     type: UserErrorType,
     otherVars?: Record<string, string | number>,
-    language?: CoreLanguage
+    language?: CoreLanguageCode
   ) {
     super(engine, 'user-system', type, userErrorReasonMap, language, otherVars);
   }

package/package.json

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