@digitaldefiance/i18n-lib 1.2.5 → 1.3.1

package/dist/core-i18n.d.ts

@@ -7,7 +7,17 @@ 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 - union of supported language codes
+ * Provides compile-time type safety for core languages
+ * For custom languages, extend this type or use string
+ */
+export type CoreLanguageCode = typeof LanguageCodes[keyof typeof LanguageCodes];
+/**
+ * Flexible language code type - use when you want runtime-only validation
+ * Alias for string to indicate it's a language code
+ */
+export type FlexibleLanguageCode = string;
 /**
  * Create default language definitions
  */
@@ -20,24 +30,33 @@ export declare const CoreComponentDefinition: ComponentDefinition<CoreStringKey>
 /**
  * Core component strings for all default languages
  */
-export declare function createCoreComponentStrings(): import("./strict-types").CompleteComponentLanguageStrings<CoreStringKey, CoreLanguageCode>;
+export declare function createCoreComponentStrings(): import("./strict-types").CompleteComponentLanguageStrings<CoreStringKey, string>;
 /**
  * Create core component registration
  */
-export declare function createCoreComponentRegistration(): ComponentRegistration<CoreStringKey, CoreLanguageCode>;
+export declare function createCoreComponentRegistration(): ComponentRegistration<CoreStringKey, string>;
+/**
+ * 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
+ * Returns engine with string type - use registry for language validation
  */
-export declare function createCoreI18nEngine(instanceKey?: string): PluginI18nEngine<CoreLanguageCode>;
+export declare function createCoreI18nEngine(instanceKey?: string): PluginI18nEngine<string>;
 /**
  * Type alias for easier usage
  */
-export type CoreI18nEngine = PluginI18nEngine<CoreLanguageCode>;
+export type CoreI18nEngine = PluginI18nEngine<string>;
 /**
  * Helper function to get core translation
  */
-export declare function getCoreTranslation(stringKey: CoreStringKey, variables?: Record<string, string | number>, language?: CoreLanguageCode, instanceKey?: string): string;
+export declare function getCoreTranslation(stringKey: CoreStringKey, variables?: Record<string, string | number>, language?: string, instanceKey?: string): string;
 /**
  * Helper function to safely get core translation with fallback
  */
-export declare function safeCoreTranslation(stringKey: CoreStringKey, variables?: Record<string, string | number>, language?: CoreLanguageCode, instanceKey?: string): string;
+export declare function safeCoreTranslation(stringKey: CoreStringKey, variables?: Record<string, string | number>, language?: string, instanceKey?: string): string;

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,8 +435,21 @@ 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
+ * Returns engine with string type - use registry for language validation
  */
 function createCoreI18nEngine(instanceKey = DefaultInstanceKey) {
     const languages = createDefaultLanguages();

package/dist/registry-error.d.ts

@@ -1,4 +1,3 @@
-import { CoreLanguageCode } from './core-i18n';
 import { RegistryErrorType } from './registry-error-type';
 import { TranslationEngine } from './typed-error';
 /**
@@ -11,7 +10,7 @@ export declare class RegistryError extends Error {
     /**
      * Create a registry error with translation support
      */
-    static createWithEngine(engine: TranslationEngine, type: RegistryErrorType, variables?: Record<string, string | number>, language?: CoreLanguageCode, metadata?: Record<string, any>): RegistryError;
+    static createWithEngine(engine: TranslationEngine, type: RegistryErrorType, variables?: Record<string, string | number>, language?: string, metadata?: Record<string, any>): RegistryError;
     /**
      * Create a simple RegistryError without engine dependency
      */

package/dist/registry-error.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RegistryError = void 0;
+// CoreLanguageCode is deprecated - using string
 const core_string_key_1 = require("./core-string-key");
 const registry_error_type_1 = require("./registry-error-type");
 const typed_error_1 = require("./typed-error");

package/dist/typed-error.d.ts

@@ -1,6 +1,5 @@
 import { Language, StringKey } from './default-config';
 import { I18nEngine } from './i18n-engine';
-import { CoreLanguageCode } from './core-i18n';
 import { CoreStringKey } from './core-string-key';
 import { PluginI18nEngine } from './plugin-i18n-engine';
 import { TranslationEngine } from './translation-engine';
@@ -52,9 +51,9 @@ export declare abstract class PluginTypedError<TEnum extends Record<string, stri
 export declare abstract class CoreTypedError<TEnum extends Record<string, string>> extends Error {
     readonly type: TEnum[keyof TEnum];
     readonly reasonMap: CompleteReasonMap<TEnum, CoreStringKey>;
-    readonly language?: CoreLanguageCode | undefined;
+    readonly language?: string | undefined;
     readonly otherVars?: Record<string, string | number> | undefined;
-    constructor(engine: PluginI18nEngine<CoreLanguageCode>, type: TEnum[keyof TEnum], reasonMap: CompleteReasonMap<TEnum, CoreStringKey>, language?: CoreLanguageCode | undefined, otherVars?: Record<string, string | number> | undefined);
+    constructor(engine: PluginI18nEngine<string>, type: TEnum[keyof TEnum], reasonMap: CompleteReasonMap<TEnum, CoreStringKey>, language?: string | undefined, otherVars?: Record<string, string | number> | undefined);
 }
 /**
  * Helper function to create a plugin-based TypedError with automatic engine detection
@@ -63,7 +62,7 @@ export declare function createPluginTypedError<TEnum extends Record<string, stri
 /**
  * Helper function to create a core system TypedError with automatic engine detection
  */
-export declare function createCoreTypedError<TEnum extends Record<string, string>>(type: TEnum[keyof TEnum], reasonMap: CompleteReasonMap<TEnum, CoreStringKey>, otherVars?: Record<string, string | number>, language?: CoreLanguageCode, instanceKey?: string): Error;
+export declare function createCoreTypedError<TEnum extends Record<string, string>>(type: TEnum[keyof TEnum], reasonMap: CompleteReasonMap<TEnum, CoreStringKey>, otherVars?: Record<string, string | number>, language?: string, instanceKey?: string): Error;
 /**
  * Create a simple error with translation support (generalized pattern from RegistryError)
  */

package/dist/typed-error.js

@@ -6,6 +6,8 @@ exports.createCoreTypedError = createCoreTypedError;
 exports.createTranslatedError = createTranslatedError;
 // Legacy imports (for backward compatibility)
 const default_config_1 = require("./default-config");
+// New plugin architecture imports
+// CoreLanguageCode is deprecated - using string for flexibility
 const core_string_key_1 = require("./core-string-key");
 const plugin_i18n_engine_1 = require("./plugin-i18n-engine");
 /**
@@ -187,7 +189,7 @@ class DatabaseError extends CoreTypedError<typeof DatabaseErrorType> {
 }
 
 // Usage:
-// const engine = PluginI18nEngine.getInstance<CoreLanguageCode>();
+// const engine = PluginI18nEngine.getInstance<string>();
 // throw new DatabaseError(engine, DatabaseErrorType.ConnectionFailed);
 */
 // Example 2: Custom component error with custom strings
@@ -210,19 +212,19 @@ const userErrorReasonMap: CompleteReasonMap<typeof UserErrorType, UserErrorStrin
   [UserErrorType.AccountLocked]: UserErrorStringKey.AccountLockedMessage
 };
 
-class UserError extends PluginTypedError<typeof UserErrorType, UserErrorStringKey, CoreLanguageCode> {
+class UserError extends PluginTypedError<typeof UserErrorType, UserErrorStringKey, string> {
   constructor(
-    engine: PluginI18nEngine<CoreLanguageCode>,
+    engine: PluginI18nEngine<string>,
     type: UserErrorType,
     otherVars?: Record<string, string | number>,
-    language?: CoreLanguage
+    language?: string
   ) {
     super(engine, 'user-system', type, userErrorReasonMap, language, otherVars);
   }
 }
 
 // Usage:
-// const engine = PluginI18nEngine.getInstance<CoreLanguageCode>();
+// const engine = PluginI18nEngine.getInstance<string>();
 // throw new UserError(engine, UserErrorType.UserNotFound, { username: 'john_doe' });
 */
 // Example 3: Using helper functions for simpler error creation

package/package.json

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