@lionrapid/core 0.1.0

package/dist/repositories/memory-repository.js

@@ -0,0 +1,100 @@
+import { createNamespaceCacheKey } from '../utils/index.js';
+export class MemoryRepository {
+    name = 'MemoryRepository';
+    type = 'memory';
+    config = {};
+    cache = new Map();
+    accessOrder = new Map();
+    maxSize = 1000;
+    constructor(config) {
+        this.config = config;
+        this.maxSize = this.config.options?.maxSize || 1000;
+    }
+    get(key) {
+        const value = this.cache.get(key);
+        if (value !== undefined) {
+            // Update access time for LRU
+            this.accessOrder.set(key, Date.now());
+            return value;
+        }
+        return null;
+    }
+    set(key, value) {
+        if (this.cache.size >= this.maxSize && !this.cache.has(key)) {
+            this.evictOldest();
+        }
+        this.cache.set(key, value);
+        this.accessOrder.set(key, Date.now());
+    }
+    remove(key) {
+        this.cache.delete(key);
+        this.accessOrder.delete(key);
+    }
+    clear() {
+        this.cache.clear();
+        this.accessOrder.clear();
+    }
+    /**
+     * Clear all entries for a specific namespace
+     * Removes both the namespace cache entry and all individual translation keys
+     */
+    clearNamespace(locale, namespace) {
+        const namespaceCacheKey = createNamespaceCacheKey(locale, namespace);
+        const keyPrefix = `${locale}:${namespace}:`;
+        // Remove namespace cache entry
+        this.cache.delete(namespaceCacheKey);
+        this.accessOrder.delete(namespaceCacheKey);
+        // Remove individual translation keys
+        for (const key of this.cache.keys()) {
+            if (key.startsWith(keyPrefix)) {
+                this.cache.delete(key);
+                this.accessOrder.delete(key);
+            }
+        }
+    }
+    getNamespace(locale, namespace) {
+        const namespaceCacheKey = createNamespaceCacheKey(locale, namespace);
+        const namespaceData = this.cache.get(namespaceCacheKey);
+        if (!namespaceData)
+            return null;
+        try {
+            return JSON.parse(namespaceData);
+        }
+        catch (error) {
+            this.cache.delete(namespaceCacheKey);
+            return null;
+        }
+    }
+    setNamespace(locale, namespace, translations) {
+        const namespaceCacheKey = createNamespaceCacheKey(locale, namespace);
+        this.cache.set(namespaceCacheKey, JSON.stringify(translations));
+    }
+    evictOldest() {
+        let oldestKey = '';
+        let oldestTime = Date.now();
+        for (const [key, time] of this.accessOrder.entries()) {
+            if (time < oldestTime) {
+                oldestTime = time;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey) {
+            this.cache.delete(oldestKey);
+            this.accessOrder.delete(oldestKey);
+        }
+    }
+    /**
+     * Get all cache entries for debugging
+     */
+    getEntries() {
+        const entries = {};
+        for (const [key, value] of this.cache.entries()) {
+            entries[key] = value;
+        }
+        return entries;
+    }
+    getConfig() {
+        return this.config;
+    }
+}
+//# sourceMappingURL=memory-repository.js.map

package/dist/repositories/memory-repository.js.map

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

package/dist/repositories/network-repository.d.ts

@@ -0,0 +1,138 @@
+/**
+ * API repository - Simple HTTP data access layer
+ * No business logic - just GET/POST operations
+ *
+ * Server always returns ContentUnit format: { text, styles }
+ */
+import type { NetworkRepositoryConfig } from '../config/repository.config.js';
+import type { ContentUnit } from '../content/types.js';
+import type { IAsyncRepository } from '../interfaces/repository.interface.js';
+import type { ContentUnitData, TranslationData } from '../types/translation-data.types.js';
+/**
+ * API repository implementation
+ * Pure data access - no caching, no business logic
+ */
+export declare class NetworkRepository implements IAsyncRepository<NetworkRepositoryConfig> {
+    readonly name = "NetworkRepository";
+    readonly type = "network";
+    readonly config: NetworkRepositoryConfig;
+    /** Cached version (opaque string from server) per namespace key "locale:namespace" */
+    private namespaceVersions;
+    /** localStorage key prefix for persisted versions */
+    private static readonly VERSION_PREFIX;
+    /**
+     * Default endpoint templates with placeholder support
+     * Placeholders: :key, :locale, :namespace
+     */
+    private readonly DEFAULT_ENDPOINTS;
+    constructor(config?: NetworkRepositoryConfig);
+    /**
+     * Get single translation from API
+     * Uses platform-specific integration endpoint
+     * @throws {TranslationNotFoundError} When translation doesn't exist (404)
+     * @throws {TranslationLockedError} When translation is locked/not ready (423)
+     * @throws {ServerError} When server returns 5xx error
+     * @throws {NetworkError} When network request fails
+     */
+    get(key: string): Promise<string>;
+    /**
+     * Get single translation as full ContentUnit (with styles)
+     * Used by NetworkHandler for individual key lookups that need styles
+     * @throws {TranslationNotFoundError} When translation doesn't exist (404)
+     * @throws {TranslationLockedError} When translation is locked/not ready (423)
+     * @throws {ServerError} When server returns 5xx error
+     * @throws {NetworkError} When network request fails
+     */
+    getContentUnit(key: string): Promise<ContentUnit>;
+    /**
+     * Get namespace with all translations
+     * @throws {TranslationNotFoundError} When namespace doesn't exist (404)
+     * @throws {TranslationLockedError} When namespace is locked/not ready (423)
+     * @throws {ServerError} When server returns 5xx error
+     * @throws {NetworkError} When network request fails
+     */
+    getNamespace(locale: string, namespace: string): Promise<TranslationData | null>;
+    /**
+     * Save translation to API (if supported)
+     */
+    set(key: string, value: string): Promise<void>;
+    setNamespace(locale: string, namespace: string, translations: TranslationData): Promise<void>;
+    /**
+     * Batch sync multiple missing translations
+     * Uses new batch endpoint for efficiency
+     */
+    setBatch(items: Array<{
+        key: string;
+        value: string;
+    }>): Promise<void>;
+    /**
+     * Get namespace with all translations as ContentUnit data
+     *
+     * @returns ContentUnitData (Record<string, ContentUnit>)
+     * @throws {TranslationNotFoundError} When namespace doesn't exist (404)
+     * @throws {TranslationLockedError} When namespace is locked/not ready (423)
+     * @throws {ServerError} When server returns 5xx error
+     * @throws {NetworkError} When network request fails
+     */
+    getNamespaceContentUnits(locale: string, namespace: string): Promise<ContentUnitData | null>;
+    /**
+     * Save ContentUnit to API
+     *
+     * Sends the ContentUnit format to server for storage.
+     * Server should store in ContentUnit format for efficient retrieval.
+     *
+     * @param key - Translation key
+     * @param unit - ContentUnit to save
+     */
+    setContentUnit(key: string, unit: ContentUnit): Promise<void>;
+    /**
+     * Batch sync multiple ContentUnits
+     *
+     * Sends ContentUnit format to server for batch storage.
+     *
+     * @param items - Array of key-ContentUnit pairs
+     */
+    setBatchContentUnits(items: Array<{
+        key: string;
+        value: ContentUnit;
+    }>): Promise<void>;
+    /**
+     * Remove translation from API (if supported)
+     */
+    remove(key: string): Promise<void>;
+    /**
+     * Clear all translations (if supported)
+     */
+    clear(): Promise<void>;
+    getConfig(): NetworkRepositoryConfig;
+    /** Read persisted version from localStorage, falling back to in-memory map */
+    private getVersion;
+    /** Persist version to both in-memory map and localStorage */
+    private setVersion;
+    /**
+     * Handle HTTP error responses by mapping to domain errors
+     * @throws {TranslationNotFoundError} When status is 404
+     * @throws {TranslationLockedError} When status is 423
+     * @throws {ServerError} When status is 5xx
+     * @throws {NetworkError} For other client errors
+     */
+    private handleHttpError;
+    /**
+     * Handle caught errors by wrapping non-domain errors
+     * @throws {TranslationError} Always throws - propagates domain errors or wraps unexpected ones
+     */
+    private handleCaughtError;
+    /**
+     * Build URL from endpoint template and parameters
+     * Supports placeholders: :key, :locale, :namespace
+     * @param endpoint - Endpoint key from DEFAULT_ENDPOINTS
+     * @param params - Parameters to replace placeholders with
+     * @returns Complete URL with baseUrl + endpoint path
+     */
+    private buildUrl;
+    /**
+     * Make HTTP request with timeout and headers
+     */
+    private makeRequest;
+}
+//# sourceMappingURL=network-repository.d.ts.map

package/dist/repositories/network-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-repository.d.ts","sourceRoot":"","sources":["../../src/repositories/network-repository.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAOvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EAChB,MAAM,oCAAoC,CAAC;AAG5C;;;GAGG;AACH,qBAAa,iBACX,YAAW,gBAAgB,CAAC,uBAAuB,CAAC;IAEpD,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAM;IAE9C,sFAAsF;IACtF,OAAO,CAAC,iBAAiB,CAA6B;IAEtD,qDAAqD;IACrD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAkB;IAExD;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAQvB;gBAEC,MAAM,GAAE,uBAA4B;IAWhD;;;;;;;OAOG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAyCvC;;;;;;;OAOG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAiDvD;;;;;;OAMG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAkDlC;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB9C,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,eAAe,GAC5B,OAAO,CAAC,IAAI,CAAC;IAuBhB;;;OAGG;IACG,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B3E;;;;;;;;OAQG;IACG,wBAAwB,CAC5B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAmDlC;;;;;;;;OAQG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBnE;;;;;;OAMG;IACG,oBAAoB,CACxB,KAAK,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,WAAW,CAAA;KAAE,CAAC,GAChD,OAAO,CAAC,IAAI,CAAC;IA+BhB;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBxC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB5B,SAAS,IAAI,uBAAuB;IAIpC,8EAA8E;IAC9E,OAAO,CAAC,UAAU;IAalB,6DAA6D;IAC7D,OAAO,CAAC,UAAU;IAOlB;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAuBvB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAezB;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ;IA2BhB;;OAEG;YACW,WAAW;CAoC1B"}