@lionrapid/core 0.1.0

package/dist/handlers/handler-chain.js

@@ -0,0 +1,366 @@
+/**
+ * Array-based handler chain implementation
+ * Much simpler than linked list approach
+ */
+import { logger } from '../utils/logger.js';
+export class HandlerChain {
+    asyncHandlers = [];
+    syncHandlers = [];
+    bus;
+    constructor(eventEmitter) {
+        this.bus = eventEmitter;
+    }
+    addSyncHandler(handler) {
+        if (!handler.enabled)
+            return;
+        this.syncHandlers.push(handler);
+        this.sortHandlersIfNeeded(this.syncHandlers);
+        logger.debug(`Sync handler added: ${handler.name}`);
+    }
+    handleSync(request) {
+        for (const handler of this.syncHandlers) {
+            try {
+                const result = handler.lookup(request);
+                if (result !== null && result.value) {
+                    logger.debug(`Sync hit: ${handler.name} (${result.duration}ms)`);
+                    return result;
+                }
+            }
+            catch (error) {
+                logger.warn(`Sync lookup failed in ${handler.name}:`, error);
+                const repoBus = this.bus.repo(request, handler.name);
+                repoBus.error(error);
+                continue;
+            }
+        }
+        return null;
+    }
+    saveToMemoryHandlers(request, result, _sourceHandler) {
+        const memoryHandlers = this.syncHandlers;
+        if (memoryHandlers.length === 0)
+            return;
+        logger.debug(`Saving to ${memoryHandlers.length} memory handlers`);
+        // Result already contains value and styles from source handler
+        memoryHandlers.forEach(handler => {
+            try {
+                handler.save(request, result);
+                logger.debug(`Saved to memory: ${handler.name}`);
+            }
+            catch (error) {
+                logger.warn(`Failed to save to memory ${handler.name}:`, error);
+                const repoBus = this.bus.repo(request, handler.name);
+                repoBus.error(error);
+            }
+        });
+    }
+    saveNamespaceToMemoryHandlers(translations, context) {
+        const memoryHandlers = this.syncHandlers.filter(h => h.type === 'memory' && h.saveNamespace);
+        if (memoryHandlers.length === 0)
+            return;
+        logger.debug(`Saving namespace to ${memoryHandlers.length} memory handlers`);
+        // ✅ Save to memory handlers (sync)
+        memoryHandlers.forEach(handler => {
+            try {
+                handler.saveNamespace(translations, context);
+                logger.debug(`Namespace saved to memory: ${handler.name}`, {
+                    locale: context.locale,
+                    namespace: context.namespace,
+                });
+            }
+            catch (error) {
+                logger.warn(`Failed to save namespace to memory ${handler.name}:`, error);
+                const repoBus = this.bus.repo(`${context.locale}:${context.namespace}`, handler.name);
+                repoBus.error(error);
+            }
+        });
+    }
+    addAsyncHandler(handler) {
+        if (!handler.enabled)
+            return;
+        this.asyncHandlers.push(handler);
+        this.sortHandlersIfNeeded(this.asyncHandlers);
+        logger.debug(`Async handler added: ${handler.name}`);
+    }
+    async handleAsync(request) {
+        for (const handler of this.asyncHandlers) {
+            try {
+                logger.debug(`Trying handler: ${handler.name}`);
+                const result = await handler.lookup(request);
+                // Check if we got a successful result (not fallback)
+                if (result.value && result.status === 200) {
+                    // Found translation - save to all storage handlers that come before this one
+                    logger.debug(`Async hit: ${handler.name} (${result.duration}ms)`);
+                    // If a full namespace was loaded during lookup, save it first
+                    if (result.namespaceLoaded) {
+                        logger.debug(`Saving loaded namespace: ${result.namespaceLoaded.locale}:${result.namespaceLoaded.namespace}`);
+                        await this.saveNamespaceToHandlers(result.namespaceLoaded.data, {
+                            locale: result.namespaceLoaded.locale,
+                            namespace: result.namespaceLoaded.namespace,
+                        });
+                        return result;
+                    }
+                    // Save to storage and memory handlers (styles included in result)
+                    await this.saveToStorageHandlers(request, result, handler);
+                    this.saveToMemoryHandlers(request, result, handler);
+                    return result;
+                }
+                // If we got a fallback result (404, 423, error), continue to next handler
+                logger.debug(`Handler ${handler.name} returned fallback (status: ${result.status})`);
+            }
+            catch (error) {
+                logger.warn(`Handler ${handler.name} failed:`, error);
+                const repoBus = this.bus.repo(request, handler.name);
+                repoBus.error(error);
+                continue;
+            }
+        }
+        logger.debug(`No async handlers found translation for ${request.cleanKey}`);
+        return null; // Not found in any handler
+    }
+    /**
+     * Save translation to all storage handlers that come before the source handler
+     */
+    async saveToStorageHandlers(request, result, sourceHandler) {
+        const sourceIndex = this.asyncHandlers.indexOf(sourceHandler);
+        // Get all storage handlers with higher priority (lower index) than source
+        const storageHandlers = this.asyncHandlers
+            .slice(0, sourceIndex)
+            .filter(h => h.type === 'storage');
+        if (storageHandlers.length === 0)
+            return;
+        logger.debug(`Saving to ${storageHandlers.length} storage handlers`);
+        // Result already contains value and styles from source handler
+        const savePromises = storageHandlers.map(async (handler) => {
+            try {
+                await handler.save(request, result);
+                logger.debug(`Saved to storage: ${handler.name}`);
+            }
+            catch (error) {
+                logger.warn(`Failed to save to storage ${handler.name}:`, error);
+                const repoBus = this.bus.repo(request, handler.name);
+                repoBus.error(error);
+            }
+        });
+        await Promise.allSettled(savePromises);
+    }
+    async saveNamespaceToStorageHandlers(translations, context) {
+        const storageHandlers = this.asyncHandlers.filter(h => h.type === 'storage' && h.saveNamespace);
+        if (storageHandlers.length === 0)
+            return;
+        logger.debug(`Saving namespace to ${storageHandlers.length} storage handlers`);
+        // ✅ Save to storage handlers (async/parallel)
+        const savePromises = storageHandlers.map(async (handler) => {
+            try {
+                await handler.saveNamespace(translations, context);
+                logger.debug(`Namespace saved to storage: ${handler.name}`, {
+                    locale: context.locale,
+                    namespace: context.namespace,
+                });
+            }
+            catch (error) {
+                logger.warn(`Failed to save namespace to storage ${handler.name}:`, error);
+                const repoBus = this.bus.repo(`${context.locale}:${context.namespace}`, handler.name);
+                repoBus.error(error);
+            }
+        });
+        await Promise.allSettled(savePromises);
+    }
+    async saveNamespaceToHandlers(translations, context) {
+        this.saveNamespaceToMemoryHandlers(translations, context);
+        await this.saveNamespaceToStorageHandlers(translations, context);
+    }
+    getSyncHandlers() {
+        return [...this.syncHandlers];
+    }
+    getAsyncHandlers() {
+        return [...this.asyncHandlers];
+    }
+    /**
+     * Get chain info for debugging
+     */
+    getChainInfo() {
+        return {
+            length: this.syncHandlers.length + this.asyncHandlers.length,
+            handlers: [
+                ...this.syncHandlers.map(h => ({
+                    name: h.name,
+                    priority: h.priority,
+                    type: h.type,
+                    enabled: h.enabled,
+                })),
+                ...this.asyncHandlers.map(h => ({
+                    name: h.name,
+                    priority: h.priority,
+                    type: h.type,
+                    enabled: h.enabled,
+                })),
+            ],
+        };
+    }
+    /**
+     * Check if any handler has cached data
+     */
+    isCached(request) {
+        return (this.syncHandlers.some(h => h.isCached?.(request) === true) ||
+            this.asyncHandlers.some(h => h.isCached?.(request) === true));
+    }
+    /**
+     * Get combined cache entries
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    getEntries() {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const entries = {};
+        // ✅ Fix: Use proper arrays instead of this.handlers
+        const allHandlers = [...this.syncHandlers, ...this.asyncHandlers];
+        for (const handler of allHandlers) {
+            if (handler.getEntries) {
+                entries[handler.name] = handler.getEntries();
+            }
+        }
+        return entries;
+    }
+    /**
+     * Destroy all handlers
+     */
+    async destroy() {
+        // ✅ Fix: Use proper arrays instead of this.handlers
+        const allHandlers = [...this.syncHandlers, ...this.asyncHandlers];
+        const destroyPromises = allHandlers.map(async (handler) => {
+            try {
+                await handler.destroy?.();
+                logger.debug(`Handler destroyed: ${handler.name}`);
+            }
+            catch (error) {
+                logger.warn(`Failed to destroy handler: ${handler.name}`, error);
+            }
+        });
+        await Promise.allSettled(destroyPromises);
+        // Clear handler arrays
+        this.syncHandlers = [];
+        this.asyncHandlers = [];
+    }
+    sortHandlersIfNeeded(handlers) {
+        const hasExplicitPriorities = handlers.some(h => h.priority > 0);
+        if (hasExplicitPriorities) {
+            handlers.sort((a, b) => {
+                const priorityA = a.priority || Number.MAX_SAFE_INTEGER;
+                const priorityB = b.priority || Number.MAX_SAFE_INTEGER;
+                return priorityA - priorityB;
+            });
+        }
+    }
+    async loadNamespace(locale, namespace) {
+        for (const handler of this.asyncHandlers) {
+            if (handler.type !== 'network')
+                continue;
+            try {
+                logger.debug(`Trying to load namespace: ${locale}:${namespace} from ${handler.name}`);
+                const result = await handler.loadNamespace?.(locale, namespace);
+                if (result && result.data && result.status === 200) {
+                    logger.debug(`Loaded namespace: ${locale}:${namespace} from ${handler.name}`);
+                    await this.saveNamespaceToStorageHandlers(result.data, {
+                        namespace,
+                        locale,
+                    });
+                    this.saveNamespaceToMemoryHandlers(result.data, {
+                        namespace,
+                        locale,
+                    });
+                    return result.data;
+                }
+            }
+            catch (error) {
+                logger.warn(`Failed to load namespace: ${locale}:${namespace} from ${handler.name}`, error);
+                const repoBus = this.bus.repo(`${locale}:${namespace}`, handler.name);
+                repoBus.error(error);
+                continue;
+            }
+        }
+        logger.debug(`No handlers found namespace: ${locale}:${namespace}`);
+        return null;
+    }
+    clearCache() {
+        const allHandlers = [...this.syncHandlers, ...this.asyncHandlers];
+        for (const handler of allHandlers) {
+            try {
+                handler.destroy?.();
+                logger.debug(`Cache cleared for handler: ${handler.name}`);
+            }
+            catch (error) {
+                logger.warn(`Failed to clear cache for handler: ${handler.name}`, error);
+            }
+        }
+        logger.debug('Cache cleared for all handlers');
+    }
+    /**
+     * Clear cache entries for a specific namespace
+     */
+    clearNamespace(locale, namespace) {
+        // Clear from sync handlers (memory)
+        for (const handler of this.syncHandlers) {
+            try {
+                handler.clearNamespace?.(locale, namespace);
+            }
+            catch (error) {
+                logger.warn(`Failed to clear namespace for handler: ${handler.name}`, error);
+            }
+        }
+        logger.debug(`Cleared namespace: ${locale}:${namespace}`);
+    }
+    /**
+     * Set a value directly in the cache (for optimistic updates)
+     * Bypasses the normal handler flow to directly set values in memory handlers
+     * Stores as ContentUnit (text + styles) for consistency
+     *
+     * @param key - Full cache key (e.g., 'en:app:welcome')
+     * @param value - Translation value
+     * @param styles - Optional styles for indexed tags
+     */
+    setCache(key, value, styles) {
+        // Save to memory handlers using the dedicated setCache method
+        // Handler stores as ContentUnit JSON internally
+        for (const handler of this.syncHandlers) {
+            if (handler.type === 'memory' && handler.setCache) {
+                try {
+                    handler.setCache(key, value, styles);
+                }
+                catch (error) {
+                    logger.warn(`Failed to set cache in handler: ${handler.name}`, error);
+                }
+            }
+        }
+        logger.debug(`Cache set: ${key}`);
+    }
+    /**
+     * Get namespace data from cache for ContentUnit style lookup
+     *
+     * Used by t() to retrieve styles for indexed tags at render time.
+     *
+     * @param namespaceCacheKey - Cache key in format @locale:namespace
+     * @returns Parsed namespace data or null if not found
+     */
+    getNamespaceData(namespaceCacheKey) {
+        // Try to get from memory handlers first (sync)
+        for (const handler of this.syncHandlers) {
+            if (handler.type === 'memory') {
+                try {
+                    const entries = handler.getEntries?.();
+                    if (entries && entries[namespaceCacheKey]) {
+                        const data = entries[namespaceCacheKey];
+                        // Parse if it's a string (JSON)
+                        if (typeof data === 'string') {
+                            return JSON.parse(data);
+                        }
+                        return data;
+                    }
+                }
+                catch (error) {
+                    logger.debug(`Error getting namespace data from ${handler.name}:`, error);
+                }
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=handler-chain.js.map

package/dist/handlers/handler-chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-chain.js","sourceRoot":"","sources":["../../src/handlers/handler-chain.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,OAAO,YAAY;IACf,aAAa,GAAoB,EAAE,CAAC;IACpC,YAAY,GAAmB,EAAE,CAAC;IAClC,GAAG,CAAe;IAE1B,YAAY,YAA0B;QACpC,IAAI,CAAC,GAAG,GAAG,YAAY,CAAC;IAC1B,CAAC;IAED,cAAc,CAAC,OAAqB;QAClC,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO;QAC7B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,uBAAuB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,UAAU,CAAC,OAA2B;QACpC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACxC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACvC,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;oBACpC,MAAM,CAAC,KAAK,CAAC,aAAa,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAC;oBACjE,OAAO,MAAM,CAAC;gBAChB,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,yBAAyB,OAAO,CAAC,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;gBAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBACrD,OAAO,CAAC,KAAK,CAAC,KAAc,CAAC,CAAC;gBAC9B,SAAS;YACX,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,oBAAoB,CAC1B,OAA2B,EAC3B,MAAyB,EACzB,cAA6B;QAE7B,MAAM,cAAc,GAAG,IAAI,CAAC,YAAY,CAAC;QACzC,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACxC,MAAM,CAAC,KAAK,CAAC,aAAa,cAAc,CAAC,MAAM,kBAAkB,CAAC,CAAC;QAEnE,+DAA+D;QAC/D,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YAC/B,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC9B,MAAM,CAAC,KAAK,CAAC,oBAAoB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACnD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,4BAA4B,OAAO,CAAC,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;gBAChE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBACrD,OAAO,CAAC,KAAK,CAAC,KAAc,CAAC,CAAC;YAChC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,6BAA6B,CACnC,YAA6B,EAC7B,OAA2B;QAE3B,MAAM,cAAc,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAC7C,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,aAAa,CAC5C,CAAC;QAEF,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAExC,MAAM,CAAC,KAAK,CACV,uBAAuB,cAAc,CAAC,MAAM,kBAAkB,CAC/D,CAAC;QAEF,mCAAmC;QACnC,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YAC/B,IAAI,CAAC;gBACH,OAAO,CAAC,aAAc,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;gBAC9C,MAAM,CAAC,KAAK,CAAC,8BAA8B,OAAO,CAAC,IAAI,EAAE,EAAE;oBACzD,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,SAAS,EAAE,OAAO,CAAC,SAAS;iBAC7B,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CACT,sCAAsC,OAAO,CAAC,IAAI,GAAG,EACrD,KAAK,CACN,CAAC;gBACF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAC3B,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,SAAS,EAAE,EACxC,OAAO,CAAC,IAAI,CACb,CAAC;gBACF,OAAO,CAAC,KAAK,CAAC,KAAc,CAAC,CAAC;YAChC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,eAAe,CAAC,OAAsB;QACpC,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO;QAC7B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAE9C,MAAM,CAAC,KAAK,CAAC,wBAAwB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,WAAW,CACf,OAA2B;QAE3B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACzC,IAAI,CAAC;gBACH,MAAM,CAAC,KAAK,CAAC,mBAAmB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;gBAChD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAE7C,qDAAqD;gBACrD,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBAC1C,6EAA6E;oBAC7E,MAAM,CAAC,KAAK,CAAC,cAAc,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAC;oBAElE,8DAA8D;oBAC9D,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;wBAC3B,MAAM,CAAC,KAAK,CACV,4BAA4B,MAAM,CAAC,eAAe,CAAC,MAAM,IAAI,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,CAChG,CAAC;wBACF,MAAM,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE;4BAC9D,MAAM,EAAE,MAAM,CAAC,eAAe,CAAC,MAAM;4BACrC,SAAS,EAAE,MAAM,CAAC,eAAe,CAAC,SAAS;yBAC5C,CAAC,CAAC;wBACH,OAAO,MAAM,CAAC;oBAChB,CAAC;oBAED,kEAAkE;oBAClE,MAAM,IAAI,CAAC,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;oBAC3D,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;oBAEpD,OAAO,MAAM,CAAC;gBAChB,CAAC;gBAED,0EAA0E;gBAC1E,MAAM,CAAC,KAAK,CACV,WAAW,OAAO,CAAC,IAAI,+BAA+B,MAAM,CAAC,MAAM,GAAG,CACvE,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,IAAI,UAAU,EAAE,KAAK,CAAC,CAAC;gBACtD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBACrD,OAAO,CAAC,KAAK,CAAC,KAAc,CAAC,CAAC;gBAC9B,SAAS;YACX,CAAC;QACH,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,2CAA2C,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5E,OAAO,IAAI,CAAC,CAAC,2BAA2B;IAC1C,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,qBAAqB,CACjC,OAA2B,EAC3B,MAAyB,EACzB,aAA4B;QAE5B,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAE9D,0EAA0E;QAC1E,MAAM,eAAe,GAAG,IAAI,CAAC,aAAa;aACvC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC;aACrB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;QAErC,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEzC,MAAM,CAAC,KAAK,CAAC,aAAa,eAAe,CAAC,MAAM,mBAAmB,CAAC,CAAC;QAErE,+DAA+D;QAC/D,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,EAAC,OAAO,EAAC,EAAE;YACvD,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBACpC,MAAM,CAAC,KAAK,CAAC,qBAAqB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACpD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,6BAA6B,OAAO,CAAC,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;gBACjE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBACrD,OAAO,CAAC,KAAK,CAAC,KAAc,CAAC,CAAC;YAChC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC;IAEO,KAAK,CAAC,8BAA8B,CAC1C,YAA6B,EAC7B,OAA2B;QAE3B,MAAM,eAAe,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAC/C,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,aAAa,CAC7C,CAAC;QAEF,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEzC,MAAM,CAAC,KAAK,CACV,uBAAuB,eAAe,CAAC,MAAM,mBAAmB,CACjE,CAAC;QAEF,8CAA8C;QAC9C,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,EAAC,OAAO,EAAC,EAAE;YACvD,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,aAAc,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;gBACpD,MAAM,CAAC,KAAK,CAAC,+BAA+B,OAAO,CAAC,IAAI,EAAE,EAAE;oBAC1D,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,SAAS,EAAE,OAAO,CAAC,SAAS;iBAC7B,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CACT,uCAAuC,OAAO,CAAC,IAAI,GAAG,EACtD,KAAK,CACN,CAAC;gBACF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAC3B,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,SAAS,EAAE,EACxC,OAAO,CAAC,IAAI,CACb,CAAC;gBACF,OAAO,CAAC,KAAK,CAAC,KAAc,CAAC,CAAC;YAChC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,uBAAuB,CAC3B,YAA6B,EAC7B,OAA2B;QAE3B,IAAI,CAAC,6BAA6B,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC1D,MAAM,IAAI,CAAC,8BAA8B,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IAED,eAAe;QACb,OAAO,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC;IAChC,CAAC;IAED,gBAAgB;QACd,OAAO,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,YAAY;QASV,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM;YAC5D,QAAQ,EAAE;gBACR,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBAC7B,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,OAAO,EAAE,CAAC,CAAC,OAAO;iBACnB,CAAC,CAAC;gBACH,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBAC9B,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,OAAO,EAAE,CAAC,CAAC,OAAO;iBACnB,CAAC,CAAC;aACJ;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,OAA2B;QAClC,OAAO,CACL,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;YAC3D,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,CAC7D,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,8DAA8D;IAC9D,UAAU;QACR,8DAA8D;QAC9D,MAAM,OAAO,GAAwB,EAAE,CAAC;QAExC,oDAAoD;QACpD,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;QAClE,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;YAClC,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBACvB,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;YAC/C,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,oDAAoD;QACpD,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;QAElE,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,EAAC,OAAO,EAAC,EAAE;YACtD,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC1B,MAAM,CAAC,KAAK,CAAC,sBAAsB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACrD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,8BAA8B,OAAO,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;YACnE,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;QAE1C,uBAAuB;QACvB,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;IAC1B,CAAC;IAEO,oBAAoB,CAC1B,QAA0C;QAE1C,MAAM,qBAAqB,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;QAEjE,IAAI,qBAAqB,EAAE,CAAC;YAC1B,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACrB,MAAM,SAAS,GAAG,CAAC,CAAC,QAAQ,IAAI,MAAM,CAAC,gBAAgB,CAAC;gBACxD,MAAM,SAAS,GAAG,CAAC,CAAC,QAAQ,IAAI,MAAM,CAAC,gBAAgB,CAAC;gBACxD,OAAO,SAAS,GAAG,SAAS,CAAC;YAC/B,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,MAAc,EACd,SAAiB;QAEjB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACzC,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;gBAAE,SAAS;YACzC,IAAI,CAAC;gBACH,MAAM,CAAC,KAAK,CACV,6BAA6B,MAAM,IAAI,SAAS,SAAS,OAAO,CAAC,IAAI,EAAE,CACxE,CAAC;gBACF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;gBAChE,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBACnD,MAAM,CAAC,KAAK,CACV,qBAAqB,MAAM,IAAI,SAAS,SAAS,OAAO,CAAC,IAAI,EAAE,CAChE,CAAC;oBACF,MAAM,IAAI,CAAC,8BAA8B,CAAC,MAAM,CAAC,IAAI,EAAE;wBACrD,SAAS;wBACT,MAAM;qBACP,CAAC,CAAC;oBACH,IAAI,CAAC,6BAA6B,CAAC,MAAM,CAAC,IAAI,EAAE;wBAC9C,SAAS;wBACT,MAAM;qBACP,CAAC,CAAC;oBACH,OAAO,MAAM,CAAC,IAAI,CAAC;gBACrB,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CACT,6BAA6B,MAAM,IAAI,SAAS,SAAS,OAAO,CAAC,IAAI,EAAE,EACvE,KAAK,CACN,CAAC;gBACF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,SAAS,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBACtE,OAAO,CAAC,KAAK,CAAC,KAAc,CAAC,CAAC;gBAC9B,SAAS;YACX,CAAC;QACH,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,gCAAgC,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,UAAU;QACR,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;QAElE,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;gBACpB,MAAM,CAAC,KAAK,CAAC,8BAA8B,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7D,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CACT,sCAAsC,OAAO,CAAC,IAAI,EAAE,EACpD,KAAK,CACN,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,MAAc,EAAE,SAAiB;QAC9C,oCAAoC;QACpC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACxC,IAAI,CAAC;gBACH,OAAO,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAC9C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CACT,0CAA0C,OAAO,CAAC,IAAI,EAAE,EACxD,KAAK,CACN,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,sBAAsB,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;;;;OAQG;IACH,QAAQ,CAAC,GAAW,EAAE,KAAa,EAAE,MAAiC;QACpE,8DAA8D;QAC9D,gDAAgD;QAChD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACxC,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBAClD,IAAI,CAAC;oBACH,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;gBACvC,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,IAAI,CAAC,mCAAmC,OAAO,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;gBACxE,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,cAAc,GAAG,EAAE,CAAC,CAAC;IACpC,CAAC;IAED;;;;;;;OAOG;IACH,gBAAgB,CAAC,iBAAyB;QACxC,+CAA+C;QAC/C,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACxC,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC9B,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;oBACvC,IAAI,OAAO,IAAI,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;wBAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;wBACxC,gCAAgC;wBAChC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;4BAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;wBAC1B,CAAC;wBACD,OAAO,IAAI,CAAC;oBACd,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,KAAK,CAAC,qCAAqC,OAAO,CAAC,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;gBAC5E,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/handlers/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Handlers exports - Chain of Responsibility implementations
+ */
+export * from './sync-storage-handler.js';
+export * from './async-storage-handler.js';
+export * from './network-handler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC"}

package/dist/handlers/index.js

@@ -0,0 +1,7 @@
+/**
+ * Handlers exports - Chain of Responsibility implementations
+ */
+export * from './sync-storage-handler.js';
+export * from './async-storage-handler.js';
+export * from './network-handler.js';
+//# sourceMappingURL=index.js.map

package/dist/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC"}

package/dist/handlers/network-handler.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Simplified API handler - no automatic namespace loading
+ * Namespace loading is now explicit via builder configuration
+ */
+import { EventEmitter } from '../base/event-emitter.js';
+import { PreloadNamespaces } from '../config';
+import { IAsyncHandler } from '../interfaces/handler.interface.js';
+import { IAsyncRepository } from '../interfaces/repository.interface.js';
+import type { NamespaceResult, TranslationRequest, TranslationResult } from '../types/translation.types.js';
+/**
+ * Simple API handler - only loads individual keys
+ * Namespace loading is handled explicitly by builder
+ */
+export declare class NetworkHandler implements IAsyncHandler {
+    repository: IAsyncRepository;
+    readonly name: string;
+    readonly priority: number;
+    readonly version = "1.0.0";
+    readonly type: "network";
+    readonly enabled: boolean;
+    private bus;
+    private retryCount;
+    private retryDelay;
+    constructor(eventEmitter: EventEmitter, repository: IAsyncRepository);
+    initialize(): Promise<void>;
+    getSourceType(): 'memory' | 'storage' | 'network' | 'fallback';
+    /**
+     * ✅ Lookup translation with full error handling
+     * Strategy: Key first, namespace as fallback
+     * Returns TranslationResult with status, source, duration, styles, and optional error
+     */
+    lookup(request: TranslationRequest): Promise<TranslationResult>;
+    /**
+     * Strategy 2: Namespace fallback when individual key not found
+     */
+    private lookupFromNamespace;
+    /**
+     * ✅ Load entire namespace (used for preloading)
+     * Returns NamespaceResult with status and error information
+     */
+    loadNamespace(locale: string, namespace: string): Promise<NamespaceResult | null>;
+    /**
+     * ✅ Namespace lookup with retry logic
+     * Throws custom errors (TranslationNotFoundError, TranslationLockedError, etc.)
+     */
+    private loadNamespaceWithRetry;
+    /**
+     * Simple save implementation (API usually doesn't save)
+     */
+    save(request: TranslationRequest, result: TranslationResult): Promise<void>;
+    /**
+     * ✅ Lookup with retry logic for individual keys
+     * Throws custom errors (TranslationNotFoundError, TranslationLockedError, etc.)
+     */
+    private lookupWithRetry;
+    /**
+     * ✅ Lookup ContentUnit with retry logic for individual keys
+     * Returns full ContentUnit with text and styles
+     * Throws custom errors (TranslationNotFoundError, TranslationLockedError, etc.)
+     */
+    private lookupContentUnitWithRetry;
+    /**
+     * Delay utility for retries
+     */
+    private delay;
+    private calculateBackoff;
+    /**
+     * Generic retry wrapper for repository operations
+     * Handles retryable errors with exponential backoff
+     */
+    private withRetry;
+    /**
+     * Handle translation not found (after namespace fallback also failed)
+     */
+    private handleTranslationNotFound;
+    /**
+     * Handle TranslationLockedError for translation lookups
+     */
+    private handleTranslationLocked;
+    /**
+     * Helper to create consistent TranslationResult objects
+     */
+    private createTranslationResult;
+    /**
+     * Helper to create consistent NamespaceResult objects
+     */
+    private createNamespaceResult;
+    getPreload(): Array<PreloadNamespaces>;
+}
+//# sourceMappingURL=network-handler.d.ts.map

package/dist/handlers/network-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-handler.d.ts","sourceRoot":"","sources":["../../src/handlers/network-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAA2B,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAOvE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAGzE,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,+BAA+B,CAAC;AAGvC;;;GAGG;AACH,qBAAa,cAAe,YAAW,aAAa;IAClD,UAAU,EAAE,gBAAgB,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,IAAI,YAAsB;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAe;IAE1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;gBAEf,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,gBAAgB;IAWpE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,aAAa,IAAI,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU;IAI9D;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAwErE;;OAEG;YACW,mBAAmB;IAgGjC;;;OAGG;IACG,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAuDlC;;;OAGG;YACW,sBAAsB;IAWpC;;OAEG;IACG,IAAI,CACR,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,IAAI,CAAC;IAMhB;;;OAGG;YACW,eAAe;IAQ7B;;;;OAIG;YACW,0BAA0B;IAgBxC;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,gBAAgB;IAWxB;;;OAGG;YACW,SAAS;IAiCvB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAuBjC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAyB/B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA0B/B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAgB7B,UAAU,IAAI,KAAK,CAAC,iBAAiB,CAAC;CAIvC"}