@lionrapid/core 0.1.0

package/dist/handlers/network-handler.js

@@ -0,0 +1,283 @@
+/**
+ * Simplified API handler - no automatic namespace loading
+ * Namespace loading is now explicit via builder configuration
+ */
+import { isRetryableError, TranslationLockedError, TranslationNotFoundError, } from '../errors/translation-errors.js';
+import { logger, resolveNestedKey } from '../utils/index.js';
+/**
+ * Simple API handler - only loads individual keys
+ * Namespace loading is handled explicitly by builder
+ */
+export class NetworkHandler {
+    repository;
+    name;
+    priority;
+    version = '1.0.0';
+    type = 'network';
+    enabled;
+    bus;
+    retryCount;
+    retryDelay;
+    constructor(eventEmitter, repository) {
+        this.bus = eventEmitter;
+        this.repository = repository;
+        this.name = repository.name;
+        const config = repository.getConfig();
+        this.enabled = config.enabled ?? false;
+        this.priority = config.priority ?? 0;
+        this.retryCount = config.options?.retries ?? 3;
+        this.retryDelay = config.options?.retryDelay ?? 1000;
+    }
+    initialize() {
+        return Promise.resolve();
+    }
+    getSourceType() {
+        return 'network';
+    }
+    /**
+     * ✅ Lookup translation with full error handling
+     * Strategy: Key first, namespace as fallback
+     * Returns TranslationResult with status, source, duration, styles, and optional error
+     */
+    async lookup(request) {
+        const startTime = Date.now();
+        const fallbackValue = request.parsedDefaultValue || request.cleanKey;
+        if (!this.enabled) {
+            return this.createTranslationResult(fallbackValue, 'fallback', 0, startTime);
+        }
+        const networkBus = this.bus.network(request, this.name);
+        networkBus.start();
+        logger.debug(`Network lookup: ${request.cleanKey}`);
+        // Strategy 1: Try individual key lookup first (returns ContentUnit with styles)
+        try {
+            const contentUnit = await this.lookupContentUnitWithRetry(request.individualCacheKey);
+            logger.debug(`Network hit: ${request.cleanKey}`);
+            networkBus.success(contentUnit.text);
+            // Return text + styles for caching
+            return this.createTranslationResult(contentUnit.text, 'network', 200, startTime, undefined, false, undefined, contentUnit.styles);
+        }
+        catch (error) {
+            // Handle 404 - key not found, try namespace fallback
+            if (error instanceof TranslationNotFoundError && request.namespace) {
+                logger.debug(`Individual key not found, trying namespace: ${request.cleanKey}`);
+                return this.lookupFromNamespace(request, fallbackValue, startTime, networkBus);
+            }
+            // Handle 423 - locked translation
+            if (error instanceof TranslationLockedError) {
+                logger.debug(`Translation locked (423): ${request.cleanKey}`);
+                return this.handleTranslationLocked(request, fallbackValue, error, startTime, networkBus);
+            }
+            // Handle other errors (server errors, network errors)
+            logger.debug(`Network error: ${request.cleanKey}`, error);
+            networkBus.error(error);
+            return this.createTranslationResult(fallbackValue, 'fallback', 0, startTime, error);
+        }
+    }
+    /**
+     * Strategy 2: Namespace fallback when individual key not found
+     */
+    async lookupFromNamespace(request, fallbackValue, startTime, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    networkBus) {
+        try {
+            const namespaceResult = await this.loadNamespace(request.locale, request.namespace);
+            if (namespaceResult && namespaceResult.data) {
+                const nestedValue = resolveNestedKey(namespaceResult.data, request.cleanKey);
+                if (nestedValue !== undefined && nestedValue !== null) {
+                    // Handle both ContentUnit format and plain strings
+                    let resolvedValue;
+                    let styles = {};
+                    if (typeof nestedValue === 'object' && nestedValue !== null && 'text' in nestedValue) {
+                        // ContentUnit format: { text, styles }
+                        const contentUnit = nestedValue;
+                        resolvedValue = String(contentUnit.text);
+                        styles = contentUnit.styles || {};
+                    }
+                    else {
+                        // Plain string
+                        resolvedValue = String(nestedValue);
+                    }
+                    logger.debug(`Network namespace hit: ${request.cleanKey}, hasStyles=${Object.keys(styles).length > 0}`);
+                    networkBus.success(resolvedValue);
+                    return this.createTranslationResult(resolvedValue, 'network', 200, startTime, undefined, false, {
+                        locale: request.locale,
+                        namespace: request.namespace,
+                        data: namespaceResult.data,
+                    }, styles);
+                }
+            }
+            // Key not found in namespace either
+            const error = new TranslationNotFoundError(request.cleanKey);
+            return this.handleTranslationNotFound(request, fallbackValue, error, startTime);
+        }
+        catch (nsError) {
+            // Namespace load failed
+            logger.debug(`Namespace load failed: ${request.cleanKey}`, nsError);
+            if (nsError instanceof TranslationNotFoundError) {
+                return this.handleTranslationNotFound(request, fallbackValue, nsError, startTime);
+            }
+            if (nsError instanceof TranslationLockedError) {
+                return this.handleTranslationLocked(request, fallbackValue, nsError, startTime, networkBus);
+            }
+            networkBus.error(nsError);
+            return this.createTranslationResult(fallbackValue, 'fallback', 0, startTime, nsError);
+        }
+    }
+    /**
+     * ✅ Load entire namespace (used for preloading)
+     * Returns NamespaceResult with status and error information
+     */
+    async loadNamespace(locale, namespace) {
+        const startTime = Date.now();
+        if (!this.enabled) {
+            return this.createNamespaceResult(null, 'fallback', 0, startTime);
+        }
+        try {
+            const data = await this.loadNamespaceWithRetry(locale, namespace);
+            // 304 Not Modified — cached translations are still fresh
+            if (data === null) {
+                logger.debug(`Network namespace not modified: ${locale}:${namespace}`);
+                return this.createNamespaceResult(null, 'network', 304, startTime);
+            }
+            logger.debug(`Network namespace loaded: ${locale}:${namespace}`);
+            return this.createNamespaceResult(data, 'network', 200, startTime);
+        }
+        catch (error) {
+            if (error instanceof TranslationLockedError) {
+                logger.debug(`Namespace locked (423): ${locale}:${namespace}`);
+                return this.createNamespaceResult(null, 'fallback', 423, startTime, error);
+            }
+            if (error instanceof TranslationNotFoundError) {
+                logger.debug(`Network namespace not found: ${locale}:${namespace}`);
+                return this.createNamespaceResult(null, 'fallback', 404, startTime, error);
+            }
+            logger.debug(`Network namespace error: ${locale}:${namespace}`, error);
+            return this.createNamespaceResult(null, 'fallback', 0, startTime, error);
+        }
+    }
+    /**
+     * ✅ Namespace lookup with retry logic
+     * Throws custom errors (TranslationNotFoundError, TranslationLockedError, etc.)
+     */
+    async loadNamespaceWithRetry(locale, namespace) {
+        return this.withRetry(() => this.repository.getNamespace(locale, namespace), `${locale}:${namespace}`, 'namespace request');
+    }
+    /**
+     * Simple save implementation (API usually doesn't save)
+     */
+    async save(request, result) {
+        // APIs usually don't save translations, but we could implement PUT if needed
+        void request;
+        void result;
+    }
+    /**
+     * ✅ Lookup with retry logic for individual keys
+     * Throws custom errors (TranslationNotFoundError, TranslationLockedError, etc.)
+     */
+    async lookupWithRetry(cacheKey) {
+        return this.withRetry(() => this.repository.get(cacheKey), cacheKey, 'network request');
+    }
+    /**
+     * ✅ Lookup ContentUnit with retry logic for individual keys
+     * Returns full ContentUnit with text and styles
+     * Throws custom errors (TranslationNotFoundError, TranslationLockedError, etc.)
+     */
+    async lookupContentUnitWithRetry(cacheKey) {
+        // Check if repository supports getContentUnit (NetworkRepository does)
+        const repo = this.repository;
+        if (typeof repo.getContentUnit !== 'function') {
+            // Fallback: use get() and wrap in ContentUnit
+            const text = await this.lookupWithRetry(cacheKey);
+            return { text, styles: {} };
+        }
+        return this.withRetry(() => repo.getContentUnit(cacheKey), cacheKey, 'network content unit request');
+    }
+    /**
+     * Delay utility for retries
+     */
+    delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    calculateBackoff(attempt) {
+        const baseDelay = this.retryDelay;
+        const exponentialDelay = baseDelay * Math.pow(2, attempt - 1);
+        const maxDelay = 10000; // 10 seconds max
+        // Add jitter to prevent thundering herd
+        const jitter = Math.random() * 0.1 * exponentialDelay;
+        return Math.min(exponentialDelay + jitter, maxDelay);
+    }
+    /**
+     * Generic retry wrapper for repository operations
+     * Handles retryable errors with exponential backoff
+     */
+    async withRetry(operation, contextKey, contextDescription, attempt = 1) {
+        const networkBus = this.bus.network(contextKey, 'withRetry');
+        try {
+            return await operation();
+        }
+        catch (error) {
+            // Retry only on retryable errors (5xx, network errors)
+            if (attempt <= this.retryCount && isRetryableError(error)) {
+                const delay = this.calculateBackoff(attempt);
+                networkBus.retry(attempt, delay, error.message);
+                await this.delay(delay);
+                logger.debug(`Retrying ${contextDescription} (${attempt}/${this.retryCount}) after ${delay}ms`);
+                return this.withRetry(operation, contextKey, contextDescription, attempt + 1);
+            }
+            // Don't retry client errors (404, 423)
+            throw error;
+        }
+    }
+    /**
+     * Handle translation not found (after namespace fallback also failed)
+     */
+    handleTranslationNotFound(request, fallbackValue, error, startTime) {
+        logger.debug(`Network namespace miss: ${request.cleanKey}`);
+        const translateBus = this.bus.translation(request);
+        translateBus.notFound(fallbackValue, request.locale, request.namespace || 'default');
+        return this.createTranslationResult(fallbackValue, 'fallback', 404, startTime, error);
+    }
+    /**
+     * Handle TranslationLockedError for translation lookups
+     */
+    handleTranslationLocked(request, fallbackValue, error, startTime, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    networkBus) {
+        const translateBus = this.bus.translation(request);
+        translateBus.locked(fallbackValue, request.locale, request.namespace || 'default');
+        networkBus.error(error, 423);
+        return this.createTranslationResult(fallbackValue, 'fallback', 423, startTime, error);
+    }
+    /**
+     * Helper to create consistent TranslationResult objects
+     */
+    createTranslationResult(value, source, status, startTime, error, cached, namespaceLoaded, styles) {
+        return {
+            value,
+            source,
+            status,
+            duration: Date.now() - startTime,
+            ...(error && { error }),
+            ...(cached !== undefined && { cached }),
+            ...(namespaceLoaded && { namespaceLoaded }),
+            ...(styles && Object.keys(styles).length > 0 && { styles }),
+        };
+    }
+    /**
+     * Helper to create consistent NamespaceResult objects
+     */
+    createNamespaceResult(data, source, status, startTime, error) {
+        return {
+            data,
+            source,
+            status,
+            duration: Date.now() - startTime,
+            ...(error && { error }),
+        };
+    }
+    getPreload() {
+        const config = this.repository.getConfig();
+        return config.options?.preloadNamespaces || [];
+    }
+}
+//# sourceMappingURL=network-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"network-handler.js","sourceRoot":"","sources":["../../src/handlers/network-handler.ts"],"names":[],"mappings":"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"}

package/dist/handlers/sync-storage-handler.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Simplified memory cache handler
+ */
+import { EventEmitter } from '../base/event-emitter.js';
+import { ISyncHandler } from '../interfaces/handler.interface.js';
+import { IStatsProvider, ISyncRepository } from '../interfaces/repository.interface.js';
+import type { TranslationData } from '../types/translation-data.types.js';
+import type { TranslationContext, TranslationRequest, TranslationResult } from '../types/translation.types.js';
+/**
+ * Simple memory cache handler
+ */
+export declare class SyncHandler implements ISyncHandler {
+    readonly name: string;
+    readonly version = "1.0.0";
+    readonly priority: number;
+    readonly type: "memory";
+    readonly enabled: boolean;
+    private ttlMap;
+    private ttl;
+    private repository;
+    private bus;
+    constructor(eventEmitter: EventEmitter, repository: ISyncRepository & IStatsProvider);
+    getSourceType(): 'memory' | 'storage' | 'network' | 'fallback';
+    /**
+     * Simple lookup implementation
+     * Returns ContentUnit with both text and styles
+     */
+    lookup(request: TranslationRequest): TranslationResult;
+    /**
+     * Simple save implementation
+     * Stores ContentUnit (text + styles) as JSON
+     */
+    save(request: TranslationRequest, result: TranslationResult): void;
+    /**
+     * Namespace saving implementation
+     */
+    saveNamespace(translations: TranslationData, context: TranslationContext): void;
+    /**
+     * ✅ Strategy 1: Direct cache lookup using unified pattern
+     * Returns parsed ContentUnit (text + styles) or null
+     */
+    private tryDirectLookup;
+    /**
+     * ✅ Strategy 2: Namespace lookup using unified pattern
+     * Returns parsed ContentUnit (text + styles) or null
+     */
+    private tryNamespaceLookup;
+    /**
+     * Helper to create consistent TranslationResult objects
+     * Now includes styles from ContentUnit
+     */
+    private createResult;
+    /**
+     * Check TTL and expire if needed
+     * Returns true if expired, false if still valid
+     */
+    private checkAndExpireTTL;
+    /**
+     * Set value in repository and update TTL
+     */
+    private setWithTTL;
+    /**
+     * Refresh TTL on access
+     */
+    private refreshTTL;
+    /**
+     * Get TTL information for debugging
+     */
+    getTTLInfo(): Record<string, {
+        timestamp: number;
+        age: number;
+        remaining: number;
+    }>;
+    getEntries(): Record<string, string> | undefined;
+    /**
+     * Clear all entries for a specific namespace
+     * Removes namespace cache entry, individual keys, and TTL entries
+     */
+    clearNamespace(locale: string, namespace: string): void;
+    destroy(): void;
+    /**
+     * Direct cache set (for optimistic updates)
+     * Bypasses event emission for direct cache manipulation
+     * Stores as ContentUnit JSON (text + styles)
+     */
+    setCache(key: string, value: string, styles?: Record<string, string[]>): void;
+}
+//# sourceMappingURL=sync-storage-handler.d.ts.map

package/dist/handlers/sync-storage-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-storage-handler.d.ts","sourceRoot":"","sources":["../../src/handlers/sync-storage-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EACL,cAAc,EACd,eAAe,EAChB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,+BAA+B,CAAC;AAgBvC;;GAEG;AACH,qBAAa,WAAY,YAAW,YAAY;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,WAAqB;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,GAAG,CAAe;gBAGxB,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,eAAe,GAAG,cAAc;IAW9C,aAAa,IAAI,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU;IAI9D;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB;IAyCtD;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAelE;;OAEG;IACH,aAAa,CACX,YAAY,EAAE,eAAe,EAC7B,OAAO,EAAE,kBAAkB,GAC1B,IAAI;IA4BP;;;OAGG;IACH,OAAO,CAAC,eAAe;IA4BvB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAuD1B;;;OAGG;IACH,OAAO,CAAC,YAAY;IAiBpB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,UAAU,IAAI,MAAM,CAClB,MAAM,EACN;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CACtD;IAgBD,UAAU;IAMV;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAsBvD,OAAO,IAAI,IAAI;IAKf;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI;CAQ9E"}

package/dist/handlers/sync-storage-handler.js

@@ -0,0 +1,270 @@
+/**
+ * Simplified memory cache handler
+ */
+import { logger } from '../utils/index.js';
+import { createNamespaceCacheKey, flattenTranslations, resolveNestedKey, } from '../utils/translation-value-utils.js';
+/**
+ * Simple memory cache handler
+ */
+export class SyncHandler {
+    name;
+    version = '1.0.0';
+    priority;
+    type = 'memory';
+    enabled;
+    ttlMap = new Map();
+    ttl;
+    repository;
+    bus;
+    constructor(eventEmitter, repository) {
+        this.bus = eventEmitter;
+        this.repository = repository;
+        this.name = repository.name;
+        const config = repository.getConfig();
+        this.enabled = config.enabled ?? true;
+        this.priority = config.priority ?? 0;
+        this.ttl = config.options?.ttl ?? 30 * 60 * 1000; // Default 30 minutes
+    }
+    getSourceType() {
+        return 'memory';
+    }
+    /**
+     * Simple lookup implementation
+     * Returns ContentUnit with both text and styles
+     */
+    lookup(request) {
+        const startTime = Date.now();
+        logger.debug(`Sync lookup: ${request.cleanKey}`);
+        const repoBus = this.bus.repo(request, this.name);
+        repoBus.getStart();
+        const directResult = this.tryDirectLookup(request);
+        if (directResult !== null) {
+            logger.debug(`Cache hit: ${request.cleanKey}`);
+            repoBus.getSuccess(directResult.text);
+            return this.createResult(directResult, 'memory', 200, startTime, true);
+        }
+        // Try namespace lookup for nested keys
+        if (request.cleanKey.includes('.') && request.namespace) {
+            const namespaceResult = this.tryNamespaceLookup(request);
+            if (namespaceResult !== null) {
+                logger.debug(`Namespace hit: ${request.cleanKey}`);
+                repoBus.getSuccess(namespaceResult.text);
+                return this.createResult(namespaceResult, 'memory', 200, startTime, true);
+            }
+        }
+        logger.debug(`Cache miss: ${request.cleanKey}`);
+        repoBus.getMiss();
+        // Return fallback result (no styles for fallback)
+        return this.createResult({ text: request.parsedDefaultValue || request.cleanKey, styles: {} }, 'fallback', 404, startTime);
+    }
+    /**
+     * Simple save implementation
+     * Stores ContentUnit (text + styles) as JSON
+     */
+    save(request, result) {
+        if (!result.value)
+            return;
+        const repoBus = this.bus.repo(request, this.name);
+        // Store as ContentUnit JSON (text + styles together)
+        const contentUnit = {
+            text: result.value,
+            styles: result.styles || {},
+        };
+        this.setWithTTL(request.individualCacheKey, JSON.stringify(contentUnit));
+        logger.debug(`Saved to cache: ${request.cleanKey}`);
+        repoBus.setSuccess(result.value);
+    }
+    /**
+     * Namespace saving implementation
+     */
+    saveNamespace(translations, context) {
+        if (!context.namespace)
+            return;
+        const repoBus = this.bus.repo(context.locale + ':' + context.namespace, this.name);
+        // Store full namespace: @locale:namespace
+        const namespaceCacheKey = createNamespaceCacheKey(context.locale, context.namespace);
+        this.setWithTTL(namespaceCacheKey, JSON.stringify(translations));
+        // Store flattened individual keys: locale:namespace:key
+        const flattened = flattenTranslations(translations, '', context.locale, context.namespace);
+        for (const [flatKey, flatValue] of Object.entries(flattened)) {
+            this.setWithTTL(flatKey, flatValue);
+        }
+        repoBus.setSuccess(JSON.stringify(translations));
+    }
+    /**
+     * ✅ Strategy 1: Direct cache lookup using unified pattern
+     * Returns parsed ContentUnit (text + styles) or null
+     */
+    tryDirectLookup(request) {
+        // Check TTL and expire if needed
+        if (this.checkAndExpireTTL(request.individualCacheKey)) {
+            return null;
+        }
+        const cachedValue = this.repository.get(request.individualCacheKey);
+        if (!cachedValue)
+            return null;
+        this.refreshTTL(request.individualCacheKey); // Refresh TTL on access
+        // Parse cached ContentUnit JSON
+        try {
+            const parsed = JSON.parse(cachedValue);
+            if (typeof parsed === 'object' && 'text' in parsed) {
+                return {
+                    text: String(parsed.text),
+                    styles: parsed.styles || {},
+                };
+            }
+            // Legacy format: plain string (shouldn't happen with new data)
+            return { text: cachedValue, styles: {} };
+        }
+        catch {
+            // If parse fails, treat as legacy plain string
+            return { text: cachedValue, styles: {} };
+        }
+    }
+    /**
+     * ✅ Strategy 2: Namespace lookup using unified pattern
+     * Returns parsed ContentUnit (text + styles) or null
+     */
+    tryNamespaceLookup(request) {
+        if (!request.namespace)
+            return null;
+        const namespaceCacheKey = createNamespaceCacheKey(request.locale, request.namespace);
+        // Check TTL for namespace
+        if (this.checkAndExpireTTL(namespaceCacheKey)) {
+            return null;
+        }
+        const namespaceData = this.repository.get(namespaceCacheKey);
+        if (!namespaceData)
+            return null;
+        this.refreshTTL(namespaceCacheKey); // Refresh TTL on access
+        try {
+            const translations = JSON.parse(namespaceData);
+            const value = resolveNestedKey(translations, request.cleanKey);
+            if (value !== null && value !== undefined) {
+                // Extract ContentUnit from namespace data
+                let contentUnit;
+                if (typeof value === 'object' && value !== null && 'text' in value) {
+                    // Server ContentUnit format: { text, styles }
+                    contentUnit = {
+                        text: String(value.text),
+                        styles: value.styles || {},
+                    };
+                }
+                else {
+                    // Plain string fallback
+                    contentUnit = { text: String(value), styles: {} };
+                }
+                // Cache the individual key for faster future access (as JSON)
+                this.setWithTTL(request.individualCacheKey, JSON.stringify(contentUnit));
+                logger.debug(`Cached from namespace: ${request.cleanKey}`);
+                return contentUnit;
+            }
+        }
+        catch (error) {
+            // Invalid JSON in namespace cache
+            logger.debug(`Invalid JSON in namespace cache: ${namespaceCacheKey}`, error);
+            this.repository.remove(namespaceCacheKey);
+            this.ttlMap.delete(namespaceCacheKey);
+        }
+        return null;
+    }
+    /**
+     * Helper to create consistent TranslationResult objects
+     * Now includes styles from ContentUnit
+     */
+    createResult(contentUnit, source, status, startTime, cached) {
+        return {
+            value: contentUnit.text,
+            styles: contentUnit.styles,
+            source,
+            status,
+            duration: Date.now() - startTime,
+            ...(cached !== undefined && { cached }),
+        };
+    }
+    /**
+     * Check TTL and expire if needed
+     * Returns true if expired, false if still valid
+     */
+    checkAndExpireTTL(cacheKey) {
+        const timestamp = this.ttlMap.get(cacheKey);
+        if (timestamp && Date.now() - timestamp > this.ttl) {
+            this.repository.remove(cacheKey);
+            this.ttlMap.delete(cacheKey);
+            logger.debug(`TTL expired: ${cacheKey}`);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Set value in repository and update TTL
+     */
+    setWithTTL(cacheKey, value) {
+        this.repository.set(cacheKey, value);
+        this.ttlMap.set(cacheKey, Date.now());
+    }
+    /**
+     * Refresh TTL on access
+     */
+    refreshTTL(cacheKey) {
+        this.ttlMap.set(cacheKey, Date.now());
+    }
+    /**
+     * Get TTL information for debugging
+     */
+    getTTLInfo() {
+        const ttlInfo = {};
+        const now = Date.now();
+        for (const [key, timestamp] of this.ttlMap.entries()) {
+            const age = now - timestamp;
+            const remaining = Math.max(0, this.ttl - age);
+            ttlInfo[key] = { timestamp, age, remaining };
+        }
+        return ttlInfo;
+    }
+    getEntries() {
+        if (this.repository.getEntries !== undefined) {
+            return this.repository.getEntries();
+        }
+    }
+    /**
+     * Clear all entries for a specific namespace
+     * Removes namespace cache entry, individual keys, and TTL entries
+     */
+    clearNamespace(locale, namespace) {
+        const namespaceCacheKey = createNamespaceCacheKey(locale, namespace);
+        const keyPrefix = `${locale}:${namespace}:`;
+        // Remove namespace cache entry
+        this.repository.remove(namespaceCacheKey);
+        this.ttlMap.delete(namespaceCacheKey);
+        // Remove individual translation keys and their TTL entries
+        const entries = this.repository.getEntries?.();
+        if (entries) {
+            for (const key of Object.keys(entries)) {
+                if (key.startsWith(keyPrefix)) {
+                    this.repository.remove(key);
+                    this.ttlMap.delete(key);
+                }
+            }
+        }
+        logger.debug(`Cleared namespace: ${locale}:${namespace}`);
+    }
+    destroy() {
+        this.repository.clear();
+        this.ttlMap.clear();
+    }
+    /**
+     * Direct cache set (for optimistic updates)
+     * Bypasses event emission for direct cache manipulation
+     * Stores as ContentUnit JSON (text + styles)
+     */
+    setCache(key, value, styles) {
+        const contentUnit = {
+            text: value,
+            styles: styles || {},
+        };
+        this.setWithTTL(key, JSON.stringify(contentUnit));
+        logger.debug(`Direct cache set: ${key}`);
+    }
+}
+//# sourceMappingURL=sync-storage-handler.js.map