@digitaldefiance/i18n-lib 1.3.11 → 1.3.13

package/dist/component-registry.js

@@ -1,245 +0,0 @@
-"use strict";
-/**
- * Component registry for managing internationalization components and their string translations
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ComponentRegistry = void 0;
-const registry_error_1 = require("./registry-error");
-const registry_error_type_1 = require("./registry-error-type");
-const utils_1 = require("./utils");
-/**
- * Registry for managing components and their translations
- */
-class ComponentRegistry {
-    constructor(languages, validationConfig) {
-        this.components = new Map();
-        this.componentStrings = new Map();
-        this.registeredLanguages = new Set(languages);
-        this.validationConfig = validationConfig;
-    }
-    /**
-     * Update the set of registered languages (for dynamic language addition)
-     */
-    updateRegisteredLanguages(languages) {
-        this.registeredLanguages.clear();
-        languages.forEach((lang) => this.registeredLanguages.add(lang));
-    }
-    /**
-     * Register a new component with its translations
-     */
-    registerComponent(registration) {
-        const { component, strings } = registration;
-        // Check for duplicate component
-        if (this.components.has(component.id)) {
-            throw registry_error_1.RegistryError.createSimple(registry_error_type_1.RegistryErrorType.DuplicateComponent, `Component '${component.id}' is already registered`, { componentId: component.id });
-        }
-        // Validate the registration
-        const validationResult = this.validateComponentRegistration(registration);
-        if (!validationResult.isValid &&
-            !this.validationConfig.allowPartialRegistration) {
-            throw registry_error_1.RegistryError.createSimple(registry_error_type_1.RegistryErrorType.ValidationFailed, `Component registration validation failed: ${validationResult.errors.join(', ')}`, {
-                componentId: component.id,
-                missingKeys: validationResult.missingKeys,
-                errors: validationResult.errors,
-            });
-        }
-        // Complete missing strings with fallbacks if partial registration is allowed
-        const completeStrings = this.completeStringsWithFallbacks(component, strings);
-        // Register the component
-        this.components.set(component.id, component);
-        this.componentStrings.set(component.id, completeStrings);
-        return validationResult;
-    }
-    /**
-     * Update strings for an existing component
-     */
-    updateComponentStrings(componentId, strings) {
-        const component = this.components.get(componentId);
-        if (!component) {
-            throw registry_error_1.RegistryError.createSimple(registry_error_type_1.RegistryErrorType.ComponentNotFound, `Component with ID '${componentId}' not found`, { componentId });
-        }
-        const registration = {
-            component: component,
-            strings,
-        };
-        const validationResult = this.validateComponentRegistration(registration);
-        if (validationResult.isValid ||
-            this.validationConfig.allowPartialRegistration) {
-            const existingStrings = this.componentStrings.get(componentId) ||
-                {};
-            const updatedStrings = this.mergeStrings(existingStrings, strings);
-            const completeStrings = this.completeStringsWithFallbacks(component, updatedStrings);
-            this.componentStrings.set(componentId, completeStrings);
-        }
-        return validationResult;
-    }
-    /**
-     * Get a translation for a specific component, string key, and language
-     */
-    getTranslation(request) {
-        const { componentId, stringKey, language, variables } = request;
-        // Check if component exists
-        if (!this.components.has(componentId)) {
-            throw registry_error_1.RegistryError.createSimple(registry_error_type_1.RegistryErrorType.ComponentNotFound, `Component '${componentId}' not found`, { componentId });
-        }
-        const componentStrings = this.componentStrings.get(componentId);
-        if (!componentStrings) {
-            throw registry_error_1.RegistryError.createSimple(registry_error_type_1.RegistryErrorType.StringKeyNotFound, `No strings registered for component '${componentId}'`, { componentId });
-        }
-        const targetLanguage = language || this.validationConfig.fallbackLanguageId;
-        let actualLanguage = targetLanguage;
-        let wasFallback = false;
-        // Try to get the string in the requested language
-        let languageStrings = componentStrings[targetLanguage];
-        // If not found and different from fallback, try fallback language
-        if (!languageStrings &&
-            targetLanguage !== this.validationConfig.fallbackLanguageId) {
-            languageStrings =
-                componentStrings[this.validationConfig.fallbackLanguageId];
-            actualLanguage = this.validationConfig.fallbackLanguageId;
-            wasFallback = true;
-        }
-        if (!languageStrings) {
-            throw registry_error_1.RegistryError.createSimple(registry_error_type_1.RegistryErrorType.LanguageNotFound, `No strings found for language '${targetLanguage}' in component '${componentId}'`, { componentId, language: targetLanguage });
-        }
-        const translation = languageStrings[stringKey];
-        if (!translation) {
-            throw registry_error_1.RegistryError.createSimple(registry_error_type_1.RegistryErrorType.StringKeyNotFound, `String key '${stringKey}' not found for component '${componentId}' in language '${actualLanguage}'`, { componentId, stringKey, language: actualLanguage });
-        }
-        // Process variables if the string key indicates it's a template
-        let processedTranslation = translation;
-        if (variables && (0, utils_1.isTemplate)(stringKey)) {
-            processedTranslation = (0, utils_1.replaceVariables)(translation, variables);
-        }
-        return {
-            translation: processedTranslation,
-            actualLanguage,
-            wasFallback,
-        };
-    }
-    /**
-     * Get all registered components
-     */
-    getComponents() {
-        return Array.from(this.components.values());
-    }
-    /**
-     * Get a specific component by ID
-     */
-    getComponent(componentId) {
-        return this.components.get(componentId);
-    }
-    /**
-     * Check if a component is registered
-     */
-    hasComponent(componentId) {
-        return this.components.has(componentId);
-    }
-    /**
-     * Get all strings for a component in all languages
-     */
-    getComponentStrings(componentId) {
-        return this.componentStrings.get(componentId);
-    }
-    /**
-     * Validate a component registration
-     */
-    validateComponentRegistration(registration) {
-        const { component, strings } = registration;
-        const missingKeys = [];
-        const errors = [];
-        // Check if all required string keys are provided for each language
-        for (const languageId of this.registeredLanguages) {
-            const languageStrings = strings[languageId];
-            if (!languageStrings) {
-                if (this.validationConfig.requireCompleteStrings) {
-                    errors.push(`Missing all strings for language '${languageId}' in component '${component.id}'`);
-                }
-                // Add all missing keys for this language
-                for (const stringKey of component.stringKeys) {
-                    missingKeys.push({
-                        languageId,
-                        componentId: component.id,
-                        stringKey,
-                    });
-                }
-                continue;
-            }
-            // Check individual string keys
-            for (const stringKey of component.stringKeys) {
-                if (!languageStrings[stringKey]) {
-                    missingKeys.push({
-                        languageId,
-                        componentId: component.id,
-                        stringKey,
-                    });
-                    if (this.validationConfig.requireCompleteStrings) {
-                        errors.push(`Missing string key '${stringKey}' for language '${languageId}' in component '${component.id}'`);
-                    }
-                }
-            }
-        }
-        return {
-            isValid: missingKeys.length === 0,
-            missingKeys,
-            errors,
-        };
-    }
-    /**
-     * Complete missing strings with fallbacks
-     */
-    completeStringsWithFallbacks(component, strings) {
-        const result = {};
-        const fallbackLanguage = this.validationConfig
-            .fallbackLanguageId;
-        const fallbackStrings = strings[fallbackLanguage];
-        // Ensure all languages have all required keys
-        for (const languageId of this.registeredLanguages) {
-            const existingLanguageStrings = strings[languageId] || {};
-            const languageStrings = {};
-            for (const stringKey of component.stringKeys) {
-                if (existingLanguageStrings[stringKey]) {
-                    languageStrings[stringKey] = existingLanguageStrings[stringKey];
-                }
-                else if (fallbackStrings && fallbackStrings[stringKey]) {
-                    // Try to use fallback language
-                    languageStrings[stringKey] = fallbackStrings[stringKey];
-                }
-                else {
-                    // Last resort: use a placeholder
-                    languageStrings[stringKey] = `[${component.id}.${stringKey}]`;
-                }
-            }
-            result[languageId] = languageStrings;
-        }
-        return result;
-    }
-    /**
-     * Merge existing strings with new strings
-     */
-    mergeStrings(existing, updates) {
-        const result = {};
-        // Copy existing strings
-        for (const [languageId, languageStrings] of Object.entries(existing)) {
-            result[languageId] = { ...languageStrings };
-        }
-        // Apply updates
-        for (const [languageId, languageStrings] of Object.entries(updates)) {
-            if (languageStrings) {
-                result[languageId] = {
-                    ...result[languageId],
-                    ...languageStrings,
-                };
-            }
-        }
-        return result;
-    }
-    /**
-     * Clear all components and their strings (useful for testing)
-     */
-    clearAllComponents() {
-        this.components.clear();
-        this.componentStrings.clear();
-    }
-}
-exports.ComponentRegistry = ComponentRegistry;

package/dist/context-error-type.d.ts

@@ -1,3 +0,0 @@
-export declare enum ContextErrorType {
-    InvalidContext = "InvalidContext"
-}

package/dist/context-error-type.js

@@ -1,7 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ContextErrorType = void 0;
-var ContextErrorType;
-(function (ContextErrorType) {
-    ContextErrorType["InvalidContext"] = "InvalidContext";
-})(ContextErrorType || (exports.ContextErrorType = ContextErrorType = {}));

package/dist/context-error.d.ts

@@ -1,6 +0,0 @@
-import { ContextErrorType } from './context-error-type';
-export declare class ContextError extends Error {
-    readonly type: ContextErrorType;
-    readonly contextKey?: string;
-    constructor(type: ContextErrorType, contextKey?: string);
-}

package/dist/context-error.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ContextError = void 0;
-class ContextError extends Error {
-    constructor(type, contextKey) {
-        const message = contextKey
-            ? `Invalid context: ${contextKey}`
-            : 'Invalid context';
-        super(message);
-        this.name = 'ContextError';
-        this.type = type;
-        this.contextKey = contextKey;
-    }
-}
-exports.ContextError = ContextError;

package/dist/context-manager.d.ts

@@ -1,33 +0,0 @@
-/**
- * Context change management for i18n systems
- */
-export type ContextChangeListener<T = any> = (property: string, oldValue: T, newValue: T) => void;
-/**
- * Manages context changes and notifies listeners.
- */
-export declare class ContextManager<TContext extends Record<string, any>> {
-    protected listeners: ContextChangeListener[];
-    /**
-     * Adds a listener to be notified of context changes.
-     * @param listener - The listener function to add
-     */
-    addListener(listener: ContextChangeListener): void;
-    /**
-     * Removes a listener from the notification list.
-     * @param listener - The listener function to remove
-     */
-    removeListener(listener: ContextChangeListener): void;
-    /**
-     * Notifies all listeners of a context change.
-     * @param property - The property that changed
-     * @param oldValue - The old value of the property
-     * @param newValue - The new value of the property
-     */
-    notifyChange<K extends keyof TContext>(property: K, oldValue: TContext[K], newValue: TContext[K]): void;
-    /**
-     * Creates a proxy for the given context to automatically notify listeners on changes.
-     * @param context - The context object to proxy
-     * @returns A proxied version of the context object
-     */
-    createProxy(context: TContext): TContext;
-}

package/dist/context-manager.js

@@ -1,61 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ContextManager = void 0;
-/**
- * Manages context changes and notifies listeners.
- */
-class ContextManager {
-    constructor() {
-        this.listeners = [];
-    }
-    /**
-     * Adds a listener to be notified of context changes.
-     * @param listener - The listener function to add
-     */
-    addListener(listener) {
-        this.listeners.push(listener);
-    }
-    /**
-     * Removes a listener from the notification list.
-     * @param listener - The listener function to remove
-     */
-    removeListener(listener) {
-        const index = this.listeners.indexOf(listener);
-        if (index > -1) {
-            this.listeners.splice(index, 1);
-        }
-    }
-    /**
-     * Notifies all listeners of a context change.
-     * @param property - The property that changed
-     * @param oldValue - The old value of the property
-     * @param newValue - The new value of the property
-     */
-    notifyChange(property, oldValue, newValue) {
-        this.listeners.forEach((listener) => {
-            try {
-                listener(property, oldValue, newValue);
-            }
-            catch (error) {
-                console.error('Error in context change listener:', error);
-            }
-        });
-    }
-    /**
-     * Creates a proxy for the given context to automatically notify listeners on changes.
-     * @param context - The context object to proxy
-     * @returns A proxied version of the context object
-     */
-    createProxy(context) {
-        const manager = this;
-        return new Proxy(context, {
-            set(target, property, value) {
-                const oldValue = target[property];
-                target[property] = value;
-                manager.notifyChange(property, oldValue, value);
-                return true;
-            },
-        });
-    }
-}
-exports.ContextManager = ContextManager;

package/dist/context.d.ts

@@ -1,44 +0,0 @@
-import { CurrencyCode } from './currency-code';
-import { I18nContext } from './i18n-context';
-import { Timezone } from './timezone';
-import { LanguageContextSpace } from './types';
-/**
- * Creates a new I18n context with default values.
- * @param defaultLanguage - The default language for the context
- * @param defaultContext - The default language context
- * @param defaultCurrencyCode - The default currency code (defaults to USD)
- * @param defaultTimezone - The default timezone (defaults to UTC)
- * @param defaultAdminTimezone - The default admin timezone (defaults to UTC)
- * @returns A new I18nContext instance
- */
-export declare function createContext<TLanguage extends string>(defaultLanguage: TLanguage, defaultContext?: LanguageContextSpace, defaultCurrencyCode?: CurrencyCode, defaultTimezone?: Timezone, defaultAdminTimezone?: Timezone): I18nContext<TLanguage>;
-/**
- * Sets the language for the given I18n context.
- * @param context - The I18n context to modify
- * @param language - The language to set
- */
-export declare function setLanguage<TLanguage extends string>(context: I18nContext<TLanguage>, language: TLanguage): void;
-/**
- * Sets the admin language for the given I18n context.
- * @param context - The I18n context to modify
- * @param language - The admin language to set
- */
-export declare function setAdminLanguage<TLanguage extends string>(context: I18nContext<TLanguage>, language: TLanguage): void;
-/**
- * Sets the current context for the given I18n context.
- * @param context - The I18n context to modify
- * @param languageContext - The language context to set
- */
-export declare function setContext<TLanguage extends string>(context: I18nContext<TLanguage>, languageContext: LanguageContextSpace): void;
-/**
- * Sets the timezone for the given I18n context.
- * @param context - The I18n context to modify
- * @param timezone - The timezone to set
- */
-export declare function setTimezone<TLanguage extends string>(context: I18nContext<TLanguage>, timezone: Timezone): void;
-/**
- * Sets the admin timezone for the given I18n context.
- * @param context - The I18n context to modify
- * @param timezone - The admin timezone to set
- */
-export declare function setAdminTimezone<TLanguage extends string>(context: I18nContext<TLanguage>, timezone: Timezone): void;

package/dist/context.js

@@ -1,69 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createContext = createContext;
-exports.setLanguage = setLanguage;
-exports.setAdminLanguage = setAdminLanguage;
-exports.setContext = setContext;
-exports.setTimezone = setTimezone;
-exports.setAdminTimezone = setAdminTimezone;
-const currency_code_1 = require("./currency-code");
-const timezone_1 = require("./timezone");
-/**
- * Creates a new I18n context with default values.
- * @param defaultLanguage - The default language for the context
- * @param defaultContext - The default language context
- * @param defaultCurrencyCode - The default currency code (defaults to USD)
- * @param defaultTimezone - The default timezone (defaults to UTC)
- * @param defaultAdminTimezone - The default admin timezone (defaults to UTC)
- * @returns A new I18nContext instance
- */
-function createContext(defaultLanguage, defaultContext = 'admin', defaultCurrencyCode = new currency_code_1.CurrencyCode('USD'), defaultTimezone = new timezone_1.Timezone('UTC'), defaultAdminTimezone = new timezone_1.Timezone('UTC')) {
-    return {
-        language: defaultLanguage,
-        adminLanguage: defaultLanguage,
-        currencyCode: defaultCurrencyCode,
-        currentContext: defaultContext,
-        timezone: defaultTimezone,
-        adminTimezone: defaultAdminTimezone,
-    };
-}
-/**
- * Sets the language for the given I18n context.
- * @param context - The I18n context to modify
- * @param language - The language to set
- */
-function setLanguage(context, language) {
-    context.language = language;
-}
-/**
- * Sets the admin language for the given I18n context.
- * @param context - The I18n context to modify
- * @param language - The admin language to set
- */
-function setAdminLanguage(context, language) {
-    context.adminLanguage = language;
-}
-/**
- * Sets the current context for the given I18n context.
- * @param context - The I18n context to modify
- * @param languageContext - The language context to set
- */
-function setContext(context, languageContext) {
-    context.currentContext = languageContext;
-}
-/**
- * Sets the timezone for the given I18n context.
- * @param context - The I18n context to modify
- * @param timezone - The timezone to set
- */
-function setTimezone(context, timezone) {
-    context.timezone = timezone;
-}
-/**
- * Sets the admin timezone for the given I18n context.
- * @param context - The I18n context to modify
- * @param timezone - The admin timezone to set
- */
-function setAdminTimezone(context, timezone) {
-    context.adminTimezone = timezone;
-}

package/dist/core-i18n.d.ts

@@ -1,62 +0,0 @@
-/**
- * Core I18n component with default languages and system strings
- */
-import { ComponentDefinition } from './component-definition';
-import { ComponentRegistration } from './component-registration';
-import { CoreStringKey } from './core-string-key';
-import { LanguageCodes } from './language-codes';
-import { LanguageDefinition } from './language-definition';
-import { PluginI18nEngine } from './plugin-i18n-engine';
-/**
- * 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
- */
-export declare function createDefaultLanguages(): LanguageDefinition[];
-export declare const CoreI18nComponentId = "core";
-/**
- * Core component definition
- */
-export declare const CoreComponentDefinition: ComponentDefinition<CoreStringKey>;
-/**
- * Core component strings for all default languages
- */
-export declare function createCoreComponentStrings(): import("./strict-types").CompleteComponentLanguageStrings<CoreStringKey, string>;
-/**
- * Create core component registration
- */
-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<string>;
-/**
- * Type alias for easier usage
- */
-export type CoreI18nEngine = PluginI18nEngine<string>;
-/**
- * Helper function to get core translation
- */
-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?: string, instanceKey?: string): string;