@better-i18n/core 0.1.8 → 0.1.10

package/README.md

@@ -8,6 +8,8 @@ Framework-agnostic core utilities for fetching translations from Better i18n CDN
 - **Edge-Ready** - Optimized for edge environments (Cloudflare, Vercel, etc.)
 - **Type-Safe** - Full TypeScript support
 - **Cached** - Built-in manifest caching with configurable TTL
+- **Offline Fallback** - 3-tier fallback chain: CDN → persistent storage → static data
+- **Resilient** - Configurable fetch timeout and retry with exponential backoff
 
 ## Installation
 
@@ -56,19 +58,80 @@ interface I18nCoreConfig {
   debug?: boolean;               // default: false
   logLevel?: LogLevel;           // default: "warn"
   fetch?: typeof fetch;          // custom fetch function
+
+  // Fallback & Resilience
+  storage?: TranslationStorage;  // persistent cache (localStorage, AsyncStorage, etc.)
+  staticData?: Record<string, Messages> | (() => Promise<Record<string, Messages>>);
+  fetchTimeout?: number;         // default: 10000 (10s) — abort if CDN doesn't respond
+  retryCount?: number;           // default: 1 — retry attempts on CDN failure
 }
 ```
 
+## Offline Fallback
+
+When CDN is unavailable, translations are resolved through a 3-tier fallback chain:
+
+```
+CDN (primary) → Storage (persistent cache) → Static Data (bundled) → throw
+```
+
+### Storage Adapter
+
+Persist translations locally so they survive CDN outages and app restarts:
+
+```typescript
+import { createI18nCore, createLocalStorage } from "@better-i18n/core";
+
+const i18n = createI18nCore({
+  project: "your-org/your-project",
+  defaultLocale: "en",
+  storage: createLocalStorage(), // browser localStorage
+});
+```
+
+Built-in adapters:
+
+| Adapter | Environment | Import |
+| --- | --- | --- |
+| `createLocalStorage()` | Browser | `@better-i18n/core` |
+| `createMemoryStorage()` | Any (non-persistent) | `@better-i18n/core` |
+| `createAutoStorage()` | Auto-detect (localStorage or memory) | `@better-i18n/core` |
+
+You can also provide any object implementing `{ get, set, remove? }` for custom stores (e.g., AsyncStorage, MMKV).
+
+### Static Data
+
+Bundle translations as a last-resort fallback:
+
+```typescript
+const i18n = createI18nCore({
+  project: "your-org/your-project",
+  defaultLocale: "en",
+  // Static import
+  staticData: {
+    en: { common: { hello: "Hello" } },
+    tr: { common: { hello: "Merhaba" } },
+  },
+  // Or lazy import (code-split)
+  // staticData: () => import('./fallback-translations.json'),
+});
+```
+
 ## Framework Integrations
 
-This package is the foundation for:
+This package is the foundation for all Better i18n SDKs:
+
+| Package | Framework | Built On |
+| --- | --- | --- |
+| [`@better-i18n/next`](https://www.npmjs.com/package/@better-i18n/next) | Next.js | `next-intl` |
+| [`@better-i18n/use-intl`](https://www.npmjs.com/package/@better-i18n/use-intl) | React, Vite, TanStack Start | `use-intl` |
+| [`@better-i18n/expo`](https://www.npmjs.com/package/@better-i18n/expo) | Expo / React Native | `i18next` |
 
-- `@better-i18n/next` - Next.js integration with ISR support
-- `@better-i18n/react` - React/TanStack integration (coming soon)
+If you're using one of these frameworks, install the framework SDK instead — `@better-i18n/core` is included automatically as a dependency.
 
 ## Documentation
 
-Full documentation available at [docs.better-i18n.com](https://docs.better-i18n.com)
+Full documentation available at [docs.better-i18n.com/core](https://docs.better-i18n.com/core)
 
 ## License
 

package/dist/__tests__/cdn-fallback.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cdn-fallback.test.d.ts.map

package/dist/__tests__/cdn-fallback.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdn-fallback.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/cdn-fallback.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/cdn-fallback.test.js

@@ -0,0 +1,380 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { createI18nCore, clearManifestCache, clearMessagesCache, } from "../cdn";
+import { createMemoryStorage } from "../storage/memory";
+// ─── Test fixtures ──────────────────────────────────────────────────
+const MANIFEST = {
+    projectSlug: "dashboard",
+    sourceLanguage: "en",
+    languages: [
+        { code: "en", name: "English", isSource: true },
+        { code: "tr", name: "Turkish" },
+    ],
+    updatedAt: "2026-01-01T00:00:00Z",
+};
+const MESSAGES_EN = {
+    common: { hello: "Hello", goodbye: "Goodbye" },
+};
+const MESSAGES_TR = {
+    common: { hello: "Merhaba", goodbye: "Hoşçakal" },
+};
+const BASE_CONFIG = {
+    project: "acme/dashboard",
+    defaultLocale: "en",
+    cdnBaseUrl: "https://cdn.test.com",
+};
+// ─── Helpers ────────────────────────────────────────────────────────
+/**
+ * Create a mock fetch that responds with given data, or throws.
+ */
+const createMockFetch = (responses) => {
+    return vi.fn(async (input, init) => {
+        // Check if aborted
+        if (init?.signal?.aborted) {
+            throw new DOMException("The operation was aborted.", "AbortError");
+        }
+        const url = typeof input === "string" ? input : input.toString();
+        for (const [pattern, response] of Object.entries(responses)) {
+            if (url.includes(pattern)) {
+                if (response.throws) {
+                    throw new Error(`Network error for ${pattern}`);
+                }
+                return {
+                    ok: response.ok,
+                    status: response.ok ? 200 : 500,
+                    json: async () => response.data,
+                };
+            }
+        }
+        throw new Error(`Unmocked URL: ${url}`);
+    });
+};
+/**
+ * Create a fetch that hangs forever (for timeout tests)
+ */
+const createHangingFetch = () => {
+    return vi.fn((_input, init) => new Promise((_resolve, reject) => {
+        // Listen for abort signal
+        if (init?.signal) {
+            init.signal.addEventListener("abort", () => {
+                reject(new DOMException("The operation was aborted.", "AbortError"));
+            });
+        }
+        // Never resolves otherwise
+    }));
+};
+// ─── Tests ──────────────────────────────────────────────────────────
+describe("cdn fallback", () => {
+    beforeEach(() => {
+        clearManifestCache();
+        clearMessagesCache();
+    });
+    // ─── CDN success path ───────────────────────────────────────────
+    describe("CDN success path", () => {
+        it("fetches messages from CDN successfully", async () => {
+            const mockFetch = createMockFetch({
+                "manifest.json": { ok: true, data: MANIFEST },
+                "en/translations.json": { ok: true, data: MESSAGES_EN },
+            });
+            const i18n = createI18nCore({ ...BASE_CONFIG, fetch: mockFetch });
+            const messages = await i18n.getMessages("en");
+            expect(messages).toEqual(MESSAGES_EN);
+        });
+        it("fetches manifest from CDN successfully", async () => {
+            const mockFetch = createMockFetch({
+                "manifest.json": { ok: true, data: MANIFEST },
+            });
+            const i18n = createI18nCore({ ...BASE_CONFIG, fetch: mockFetch });
+            const manifest = await i18n.getManifest();
+            expect(manifest.languages).toHaveLength(2);
+            expect(manifest.languages[0].code).toBe("en");
+        });
+        it("caches messages in memory on subsequent calls", async () => {
+            const mockFetch = createMockFetch({
+                "en/translations.json": { ok: true, data: MESSAGES_EN },
+            });
+            const i18n = createI18nCore({ ...BASE_CONFIG, fetch: mockFetch });
+            await i18n.getMessages("en");
+            await i18n.getMessages("en");
+            // Should only fetch once — second call served from memory
+            expect(mockFetch).toHaveBeenCalledTimes(1);
+        });
+        it("writes through to storage on CDN success", async () => {
+            const storage = createMemoryStorage();
+            const setSpy = vi.spyOn(storage, "set");
+            const mockFetch = createMockFetch({
+                "en/translations.json": { ok: true, data: MESSAGES_EN },
+            });
+            const i18n = createI18nCore({
+                ...BASE_CONFIG,
+                fetch: mockFetch,
+                storage,
+            });
+            await i18n.getMessages("en");
+            // Wait for fire-and-forget storage write
+            await new Promise((r) => setTimeout(r, 10));
+            expect(setSpy).toHaveBeenCalledWith(expect.stringContaining("messages"), expect.any(String));
+        });
+    });
+    // ─── CDN failure → storage fallback ─────────────────────────────
+    describe("CDN failure → storage fallback", () => {
+        it("falls back to storage when CDN fails for messages", async () => {
+            const storage = createMemoryStorage();
+            // Pre-populate storage with cached messages
+            await storage.set("@better-i18n:messages:acme/dashboard:en", JSON.stringify(MESSAGES_EN));
+            const mockFetch = createMockFetch({
+                "en/translations.json": { ok: false },
+            });
+            const i18n = createI18nCore({
+                ...BASE_CONFIG,
+                fetch: mockFetch,
+                storage,
+                retryCount: 0,
+            });
+            const messages = await i18n.getMessages("en");
+            expect(messages).toEqual(MESSAGES_EN);
+        });
+        it("falls back to storage when CDN fails for manifest", async () => {
+            const storage = createMemoryStorage();
+            // Pre-populate storage with cached manifest
+            await storage.set("@better-i18n:manifest:acme/dashboard", JSON.stringify(MANIFEST));
+            const mockFetch = createMockFetch({
+                "manifest.json": { ok: false },
+            });
+            const i18n = createI18nCore({
+                ...BASE_CONFIG,
+                fetch: mockFetch,
+                storage,
+                retryCount: 0,
+            });
+            const manifest = await i18n.getManifest();
+            expect(manifest.languages).toHaveLength(2);
+        });
+        it("falls back to storage on network error", async () => {
+            const storage = createMemoryStorage();
+            await storage.set("@better-i18n:messages:acme/dashboard:tr", JSON.stringify(MESSAGES_TR));
+            const mockFetch = createMockFetch({
+                "tr/translations.json": { ok: false, throws: true },
+            });
+            const i18n = createI18nCore({
+                ...BASE_CONFIG,
+                fetch: mockFetch,
+                storage,
+                retryCount: 0,
+            });
+            const messages = await i18n.getMessages("tr");
+            expect(messages).toEqual(MESSAGES_TR);
+        });
+    });
+    // ─── CDN failure + storage miss → staticData ────────────────────
+    describe("CDN failure + storage miss → staticData fallback", () => {
+        it("falls back to staticData when CDN and storage fail", async () => {
+            const mockFetch = createMockFetch({
+                "en/translations.json": { ok: false, throws: true },
+            });
+            const i18n = createI18nCore({
+                ...BASE_CONFIG,
+                fetch: mockFetch,
+                staticData: { en: MESSAGES_EN, tr: MESSAGES_TR },
+                retryCount: 0,
+            });
+            const messages = await i18n.getMessages("en");
+            expect(messages).toEqual(MESSAGES_EN);
+        });
+        it("resolves lazy staticData function", async () => {
+            const mockFetch = createMockFetch({
+                "tr/translations.json": { ok: false, throws: true },
+            });
+            const i18n = createI18nCore({
+                ...BASE_CONFIG,
+                fetch: mockFetch,
+                staticData: async () => ({ en: MESSAGES_EN, tr: MESSAGES_TR }),
+                retryCount: 0,
+            });
+            const messages = await i18n.getMessages("tr");
+            expect(messages).toEqual(MESSAGES_TR);
+        });
+        it("throws when locale not in staticData", async () => {
+            const mockFetch = createMockFetch({
+                "fr/translations.json": { ok: false, throws: true },
+            });
+            const i18n = createI18nCore({
+                ...BASE_CONFIG,
+                fetch: mockFetch,
+                staticData: { en: MESSAGES_EN },
+                retryCount: 0,
+            });
+            await expect(i18n.getMessages("fr")).rejects.toThrow();
+        });
+    });
+    // ─── Complete failure ───────────────────────────────────────────
+    describe("complete failure (no CDN, no storage, no staticData)", () => {
+        it("throws when all sources fail for messages", async () => {
+            const mockFetch = createMockFetch({
+                "en/translations.json": { ok: false, throws: true },
+            });
+            const i18n = createI18nCore({
+                ...BASE_CONFIG,
+                fetch: mockFetch,
+                retryCount: 0,
+            });
+            await expect(i18n.getMessages("en")).rejects.toThrow();
+        });
+        it("throws when all sources fail for manifest", async () => {
+            const mockFetch = createMockFetch({
+                "manifest.json": { ok: false, throws: true },
+            });
+            const i18n = createI18nCore({
+                ...BASE_CONFIG,
+                fetch: mockFetch,
+                retryCount: 0,
+            });
+            await expect(i18n.getManifest()).rejects.toThrow();
+        });
+    });
+    // ─── Timeout ────────────────────────────────────────────────────
+    describe("timeout", () => {
+        it("aborts fetch after timeout and falls back to storage", async () => {
+            const storage = createMemoryStorage();
+            await storage.set("@better-i18n:messages:acme/dashboard:en", JSON.stringify(MESSAGES_EN));
+            const hangingFetch = createHangingFetch();
+            const i18n = createI18nCore({
+                ...BASE_CONFIG,
+                fetch: hangingFetch,
+                storage,
+                fetchTimeout: 50, // 50ms timeout for fast test
+                retryCount: 0,
+            });
+            const messages = await i18n.getMessages("en");
+            expect(messages).toEqual(MESSAGES_EN);
+        });
+        it("aborts manifest fetch after timeout and falls back to storage", async () => {
+            const storage = createMemoryStorage();
+            await storage.set("@better-i18n:manifest:acme/dashboard", JSON.stringify(MANIFEST));
+            const hangingFetch = createHangingFetch();
+            const i18n = createI18nCore({
+                ...BASE_CONFIG,
+                fetch: hangingFetch,
+                storage,
+                fetchTimeout: 50,
+                retryCount: 0,
+            });
+            const manifest = await i18n.getManifest();
+            expect(manifest.languages).toHaveLength(2);
+        });
+    });
+    // ─── Retry logic ────────────────────────────────────────────────
+    describe("retry logic", () => {
+        it("retries on failure before falling back", async () => {
+            let callCount = 0;
+            const flakyFetch = vi.fn(async (input) => {
+                const url = typeof input === "string" ? input : input.toString();
+                if (url.includes("translations.json")) {
+                    callCount++;
+                    if (callCount <= 2) {
+                        throw new Error("Transient error");
+                    }
+                    return {
+                        ok: true,
+                        status: 200,
+                        json: async () => MESSAGES_EN,
+                    };
+                }
+                throw new Error(`Unmocked URL: ${url}`);
+            });
+            const i18n = createI18nCore({
+                ...BASE_CONFIG,
+                fetch: flakyFetch,
+                retryCount: 2,
+                fetchTimeout: 5000,
+            });
+            const messages = await i18n.getMessages("en");
+            expect(messages).toEqual(MESSAGES_EN);
+            // 1st attempt + 2 retries = 3 calls total
+            expect(callCount).toBe(3);
+        });
+        it("falls back to storage after all retries exhausted", async () => {
+            const storage = createMemoryStorage();
+            await storage.set("@better-i18n:messages:acme/dashboard:en", JSON.stringify(MESSAGES_EN));
+            let callCount = 0;
+            const alwaysFailFetch = vi.fn(async () => {
+                callCount++;
+                throw new Error("Network error");
+            });
+            const i18n = createI18nCore({
+                ...BASE_CONFIG,
+                fetch: alwaysFailFetch,
+                storage,
+                retryCount: 2,
+                fetchTimeout: 5000,
+            });
+            const messages = await i18n.getMessages("en");
+            expect(messages).toEqual(MESSAGES_EN);
+            // 1st attempt + 2 retries = 3 calls
+            expect(callCount).toBe(3);
+        });
+    });
+    // ─── Storage adapter ────────────────────────────────────────────
+    describe("storage adapter", () => {
+        it("createMemoryStorage works correctly", async () => {
+            const storage = createMemoryStorage();
+            expect(await storage.get("key")).toBeNull();
+            await storage.set("key", "value");
+            expect(await storage.get("key")).toBe("value");
+            await storage.remove("key");
+            expect(await storage.get("key")).toBeNull();
+        });
+        it("handles storage.get errors gracefully", async () => {
+            const brokenStorage = {
+                get: async () => {
+                    throw new Error("Storage read failed");
+                },
+                set: async () => {
+                    throw new Error("Storage write failed");
+                },
+            };
+            const mockFetch = createMockFetch({
+                "en/translations.json": { ok: false, throws: true },
+            });
+            const i18n = createI18nCore({
+                ...BASE_CONFIG,
+                fetch: mockFetch,
+                storage: brokenStorage,
+                retryCount: 0,
+            });
+            // Should still throw CDN error even though storage also fails
+            await expect(i18n.getMessages("en")).rejects.toThrow();
+        });
+    });
+    // ─── Config defaults ───────────────────────────────────────────
+    describe("config defaults", () => {
+        it("uses default fetchTimeout of 10000ms", () => {
+            const mockFetch = createMockFetch({});
+            const i18n = createI18nCore({ ...BASE_CONFIG, fetch: mockFetch });
+            expect(i18n.config.fetchTimeout).toBe(10000);
+        });
+        it("uses default retryCount of 1", () => {
+            const mockFetch = createMockFetch({});
+            const i18n = createI18nCore({ ...BASE_CONFIG, fetch: mockFetch });
+            expect(i18n.config.retryCount).toBe(1);
+        });
+        it("allows overriding fetchTimeout", () => {
+            const mockFetch = createMockFetch({});
+            const i18n = createI18nCore({
+                ...BASE_CONFIG,
+                fetch: mockFetch,
+                fetchTimeout: 5000,
+            });
+            expect(i18n.config.fetchTimeout).toBe(5000);
+        });
+        it("allows overriding retryCount", () => {
+            const mockFetch = createMockFetch({});
+            const i18n = createI18nCore({
+                ...BASE_CONFIG,
+                fetch: mockFetch,
+                retryCount: 3,
+            });
+            expect(i18n.config.retryCount).toBe(3);
+        });
+    });
+});
+//# sourceMappingURL=cdn-fallback.test.js.map

package/dist/__tests__/cdn-fallback.test.js.map

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

package/dist/cdn.d.ts

@@ -12,10 +12,27 @@ import type { I18nCore, I18nCoreConfig } from "./types";
  * const messages = await i18n.getMessages('en')
  * const locales = await i18n.getLocales()
  * ```
+ *
+ * @example
+ * ```ts
+ * // With fallback support
+ * const i18n = createI18nCore({
+ *   project: 'acme/dashboard',
+ *   defaultLocale: 'en',
+ *   storage: createAutoStorage(),
+ *   staticData: { en: { common: { hello: "Hello" } } },
+ *   fetchTimeout: 5000,
+ *   retryCount: 2,
+ * })
+ * ```
  */
 export declare const createI18nCore: (config: I18nCoreConfig) => I18nCore;
 /**
- * Clear the manifest cache (useful for testing)
+ * Clear all caches (useful for testing)
  */
 export declare const clearManifestCache: () => void;
+/**
+ * Clear the messages cache (useful for testing)
+ */
+export declare const clearMessagesCache: () => void;
 //# sourceMappingURL=cdn.d.ts.map

package/dist/cdn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cdn.d.ts","sourceRoot":"","sources":["../src/cdn.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EAKf,MAAM,SAAS,CAAC;AAuFjB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,cAAc,KAAG,QAkCvD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,QAAO,IAErC,CAAC"}
+{"version":3,"file":"cdn.d.ts","sourceRoot":"","sources":["../src/cdn.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EAMf,MAAM,SAAS,CAAC;AAqSjB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,cAAc,KAAG,QAmCvD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,QAAO,IAErC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,QAAO,IAErC,CAAC"}

package/dist/cdn.js

@@ -2,18 +2,97 @@ import { TtlCache, buildCacheKey } from "./cache";
 import { getProjectBaseUrl, normalizeConfig } from "./config";
 import { createLogger } from "./logger";
 import { extractLanguages } from "./manifest";
-// Global manifest cache (shared across instances)
+const STORAGE_PREFIX = "@better-i18n";
+// Global caches (shared across instances)
 const manifestCache = new TtlCache();
+const messagesCache = new TtlCache();
+// ─── Storage helpers ────────────────────────────────────────────────
+const buildManifestStorageKey = (project) => `${STORAGE_PREFIX}:manifest:${project}`;
+const buildMessagesStorageKey = (project, locale) => `${STORAGE_PREFIX}:messages:${project}:${locale}`;
+const readFromStorage = async (storage, key) => {
+    if (!storage)
+        return null;
+    try {
+        const raw = await storage.get(key);
+        if (!raw)
+            return null;
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+};
+const writeToStorage = async (storage, key, data) => {
+    if (!storage)
+        return;
+    try {
+        await storage.set(key, JSON.stringify(data));
+    }
+    catch {
+        // Storage full or unavailable — silently fail
+    }
+};
+// ─── Fetch helpers ──────────────────────────────────────────────────
 /**
- * Fetch manifest from CDN
+ * Fetch with AbortController-based timeout
  */
-const fetchManifest = async (config, fetchFn) => {
+const fetchWithTimeout = async (fetchFn, url, init, timeoutMs) => {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetchFn(url, {
+            ...init,
+            signal: controller.signal,
+        });
+        return response;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+};
+/**
+ * Fetch with retry logic
+ */
+const fetchWithRetry = async (fetchFn, url, init, timeoutMs, retryCount) => {
+    let lastError;
+    for (let attempt = 0; attempt <= retryCount; attempt++) {
+        try {
+            return await fetchWithTimeout(fetchFn, url, init, timeoutMs);
+        }
+        catch (err) {
+            lastError = err;
+            // Don't retry on the last attempt
+            if (attempt < retryCount) {
+                // Simple exponential backoff: 200ms, 400ms, ...
+                await new Promise((resolve) => setTimeout(resolve, 200 * (attempt + 1)));
+            }
+        }
+    }
+    throw lastError;
+};
+// ─── Resolve staticData helper ──────────────────────────────────────
+const resolveStaticData = async (staticData) => {
+    if (!staticData)
+        return null;
+    if (typeof staticData === "function") {
+        try {
+            return await staticData();
+        }
+        catch {
+            return null;
+        }
+    }
+    return staticData;
+};
+// ─── Manifest fetching with fallback ────────────────────────────────
+/**
+ * Fetch manifest from CDN (raw, no cache)
+ */
+const fetchManifestFromCdn = async (config, fetchFn) => {
     const logger = createLogger(config, "manifest");
     const url = `${getProjectBaseUrl(config)}/manifest.json`;
     logger.debug("fetching", url);
-    const response = await fetchFn(url, {
-        headers: { "Cache-Control": "no-cache" },
-    });
+    const response = await fetchWithRetry(fetchFn, url, { headers: { "Cache-Control": "no-cache" } }, config.fetchTimeout, config.retryCount);
     if (!response.ok) {
         const message = `Manifest fetch failed (${response.status})`;
         logger.error(message);
@@ -27,29 +106,52 @@ const fetchManifest = async (config, fetchFn) => {
     return data;
 };
 /**
- * Get manifest with caching
+ * Get manifest with full fallback chain:
+ * 1. Memory cache (TtlCache)
+ * 2. CDN fetch (with timeout + retry)
+ * 3. Persistent storage
+ * 4. Throw (last resort)
  */
 const getManifestWithCache = async (config, fetchFn, forceRefresh = false) => {
+    const logger = createLogger(config, "manifest");
     const cacheKey = buildCacheKey(config.cdnBaseUrl, config.project);
+    const storageKey = buildManifestStorageKey(config.project);
+    // 1. Memory cache
     if (!forceRefresh) {
         const cached = manifestCache.get(cacheKey);
         if (cached)
             return cached;
     }
-    const manifest = await fetchManifest(config, fetchFn);
-    manifestCache.set(cacheKey, manifest, config.manifestCacheTtlMs);
-    return manifest;
+    // 2. CDN fetch
+    try {
+        const manifest = await fetchManifestFromCdn(config, fetchFn);
+        manifestCache.set(cacheKey, manifest, config.manifestCacheTtlMs);
+        // Write-through to storage (fire-and-forget)
+        writeToStorage(config.storage, storageKey, manifest);
+        return manifest;
+    }
+    catch (cdnError) {
+        logger.warn("CDN fetch failed, trying fallback sources", cdnError);
+        // 3. Persistent storage
+        const stored = await readFromStorage(config.storage, storageKey);
+        if (stored && Array.isArray(stored.languages)) {
+            logger.info("serving manifest from persistent storage (stale)");
+            manifestCache.set(cacheKey, stored, config.manifestCacheTtlMs);
+            return stored;
+        }
+        // 4. No fallback available
+        throw cdnError;
+    }
 };
+// ─── Messages fetching with fallback ────────────────────────────────
 /**
- * Fetch messages for a locale
+ * Fetch messages from CDN (raw, no cache)
  */
-const fetchMessages = async (config, locale, fetchFn) => {
+const fetchMessagesFromCdn = async (config, locale, fetchFn) => {
     const logger = createLogger(config, "messages");
     const url = `${getProjectBaseUrl(config)}/${locale}/translations.json`;
     logger.debug("fetching", url);
-    const response = await fetchFn(url, {
-        headers: { "Cache-Control": "no-cache" },
-    });
+    const response = await fetchWithRetry(fetchFn, url, { headers: { "Cache-Control": "no-cache" } }, config.fetchTimeout, config.retryCount);
     if (!response.ok) {
         const message = `Messages fetch failed for locale "${locale}" (${response.status})`;
         logger.error(message);
@@ -59,6 +161,51 @@ const fetchMessages = async (config, locale, fetchFn) => {
     logger.debug("fetched", { locale, keys: Object.keys(data).length });
     return data;
 };
+/**
+ * Get messages with full fallback chain:
+ * 1. Memory cache (TtlCache)
+ * 2. CDN fetch (with timeout + retry)
+ * 3. Persistent storage
+ * 4. staticData
+ * 5. Throw (last resort)
+ */
+const getMessagesWithFallback = async (config, locale, fetchFn) => {
+    const safeLng = locale.toLowerCase(); // CDN convention: always lowercase
+    const logger = createLogger(config, "messages");
+    const cacheKey = `${buildCacheKey(config.cdnBaseUrl, config.project)}|${safeLng}`;
+    const storageKey = buildMessagesStorageKey(config.project, safeLng);
+    // 1. Memory cache
+    const memoryCached = messagesCache.get(cacheKey);
+    if (memoryCached)
+        return memoryCached;
+    // 2. CDN fetch
+    try {
+        const messages = await fetchMessagesFromCdn(config, safeLng, fetchFn);
+        messagesCache.set(cacheKey, messages, config.manifestCacheTtlMs);
+        // Write-through to storage (fire-and-forget)
+        writeToStorage(config.storage, storageKey, messages);
+        return messages;
+    }
+    catch (cdnError) {
+        logger.warn(`CDN fetch failed for locale "${safeLng}", trying fallback sources`, cdnError);
+        // 3. Persistent storage
+        const stored = await readFromStorage(config.storage, storageKey);
+        if (stored) {
+            logger.info(`serving messages for "${safeLng}" from persistent storage (stale)`);
+            messagesCache.set(cacheKey, stored, config.manifestCacheTtlMs);
+            return stored;
+        }
+        // 4. staticData
+        const resolved = await resolveStaticData(config.staticData);
+        if (resolved && resolved[safeLng]) {
+            logger.info(`serving messages for "${safeLng}" from staticData`);
+            return resolved[safeLng];
+        }
+        // 5. No fallback available
+        throw cdnError;
+    }
+};
+// ─── Public API ─────────────────────────────────────────────────────
 /**
  * Create an i18n core instance
  *
@@ -72,6 +219,19 @@ const fetchMessages = async (config, locale, fetchFn) => {
  * const messages = await i18n.getMessages('en')
  * const locales = await i18n.getLocales()
  * ```
+ *
+ * @example
+ * ```ts
+ * // With fallback support
+ * const i18n = createI18nCore({
+ *   project: 'acme/dashboard',
+ *   defaultLocale: 'en',
+ *   storage: createAutoStorage(),
+ *   staticData: { en: { common: { hello: "Hello" } } },
+ *   fetchTimeout: 5000,
+ *   retryCount: 2,
+ * })
+ * ```
  */
 export const createI18nCore = (config) => {
     const normalized = normalizeConfig(config);
@@ -79,7 +239,7 @@ export const createI18nCore = (config) => {
     return {
         config: normalized,
         getManifest: (options) => getManifestWithCache(normalized, fetchFn, options?.forceRefresh),
-        getMessages: (locale) => fetchMessages(normalized, locale, fetchFn),
+        getMessages: (locale) => getMessagesWithFallback(normalized, locale, fetchFn),
         getLocales: async () => {
             const manifest = await getManifestWithCache(normalized, fetchFn);
             const languages = extractLanguages(manifest);
@@ -99,9 +259,15 @@ export const createI18nCore = (config) => {
     };
 };
 /**
- * Clear the manifest cache (useful for testing)
+ * Clear all caches (useful for testing)
  */
 export const clearManifestCache = () => {
     manifestCache.clear();
 };
+/**
+ * Clear the messages cache (useful for testing)
+ */
+export const clearMessagesCache = () => {
+    messagesCache.clear();
+};
 //# sourceMappingURL=cdn.js.map

package/dist/cdn.js.map

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

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAK/E;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,KAAG,aAW9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,cAAc,KAAG,gBAiBxD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,gBAAgB,KAAG,MACO,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAO/E;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,KAAG,aAW9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,cAAc,KAAG,gBAmBxD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,gBAAgB,KAAG,MACO,CAAC"}

package/dist/config.js

@@ -1,5 +1,7 @@
 const DEFAULT_CDN_BASE_URL = "https://cdn.better-i18n.com";
 const DEFAULT_CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes
+const DEFAULT_FETCH_TIMEOUT_MS = 10_000; // 10 seconds
+const DEFAULT_RETRY_COUNT = 1;
 /**
  * Parse project string "org/slug" into workspaceId and projectSlug
  */
@@ -30,6 +32,8 @@ export const normalizeConfig = (config) => {
         projectSlug,
         cdnBaseUrl: config.cdnBaseUrl?.replace(/\/$/, "") || DEFAULT_CDN_BASE_URL,
         manifestCacheTtlMs: config.manifestCacheTtlMs ?? DEFAULT_CACHE_TTL_MS,
+        fetchTimeout: config.fetchTimeout ?? DEFAULT_FETCH_TIMEOUT_MS,
+        retryCount: config.retryCount ?? DEFAULT_RETRY_COUNT,
     };
 };
 /**

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,MAAM,oBAAoB,GAAG,6BAA6B,CAAC;AAC3D,MAAM,oBAAoB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY;AAExD;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAe,EAAiB,EAAE;IAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CACb,yCAAyC,OAAO,oDAAoD,CACrG,CAAC;IACJ,CAAC;IACD,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;QACrB,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;KACtB,CAAC;AACJ,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAsB,EAAoB,EAAE;IAC1E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,IAAI,EAAE,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElE,OAAO;QACL,GAAG,MAAM;QACT,WAAW;QACX,WAAW;QACX,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,oBAAoB;QACzE,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,IAAI,oBAAoB;KACtE,CAAC;AACJ,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAwB,EAAU,EAAE,CACpE,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,MAAM,oBAAoB,GAAG,6BAA6B,CAAC;AAC3D,MAAM,oBAAoB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY;AACxD,MAAM,wBAAwB,GAAG,MAAM,CAAC,CAAC,aAAa;AACtD,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAE9B;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAe,EAAiB,EAAE;IAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CACb,yCAAyC,OAAO,oDAAoD,CACrG,CAAC;IACJ,CAAC;IACD,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;QACrB,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;KACtB,CAAC;AACJ,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAsB,EAAoB,EAAE;IAC1E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,IAAI,EAAE,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElE,OAAO;QACL,GAAG,MAAM;QACT,WAAW;QACX,WAAW;QACX,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,oBAAoB;QACzE,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,IAAI,oBAAoB;QACrE,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,wBAAwB;QAC7D,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,mBAAmB;KACrD,CAAC;AACJ,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAwB,EAAU,EAAE,CACpE,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC"}

package/dist/i18n/detection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detection.d.ts","sourceRoot":"","sources":["../../src/i18n/detection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAE7E;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CA+BvB"}
+{"version":3,"file":"detection.d.ts","sourceRoot":"","sources":["../../src/i18n/detection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAM7E;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CAmCvB"}

package/dist/i18n/detection.js

@@ -1,3 +1,5 @@
+/** Case-insensitive locale lookup — returns the canonical (CDN) form if matched */
+const findLocale = (code, available) => code ? available.find((a) => a.toLowerCase() === code.toLowerCase()) : undefined;
 /**
  * Framework-agnostic locale detection logic
  */
@@ -6,16 +8,19 @@ export function detectLocale(options) {
     let locale;
     let detectedFrom;
     // Priority: path > cookie > header > default
-    if (pathLocale && availableLocales.includes(pathLocale)) {
-        locale = pathLocale;
+    const pathMatch = findLocale(pathLocale, availableLocales);
+    const cookieMatch = findLocale(cookieLocale, availableLocales);
+    const headerMatch = findLocale(headerLocale, availableLocales);
+    if (pathMatch) {
+        locale = pathMatch;
         detectedFrom = "path";
     }
-    else if (cookieLocale && availableLocales.includes(cookieLocale)) {
-        locale = cookieLocale;
+    else if (cookieMatch) {
+        locale = cookieMatch;
         detectedFrom = "cookie";
     }
-    else if (headerLocale && availableLocales.includes(headerLocale)) {
-        locale = headerLocale;
+    else if (headerMatch) {
+        locale = headerMatch;
         detectedFrom = "header";
     }
     else {

package/dist/i18n/detection.js.map

@@ -1 +1 @@
-{"version":3,"file":"detection.js","sourceRoot":"","sources":["../../src/i18n/detection.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,OAA+B;IAE/B,MAAM,EACJ,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,gBAAgB,GACjB,GAAG,OAAO,CAAC;IAEZ,IAAI,MAAc,CAAC;IACnB,IAAI,YAAmD,CAAC;IAExD,6CAA6C;IAC7C,IAAI,UAAU,IAAI,gBAAgB,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACxD,MAAM,GAAG,UAAU,CAAC;QACpB,YAAY,GAAG,MAAM,CAAC;IACxB,CAAC;SAAM,IAAI,YAAY,IAAI,gBAAgB,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QACnE,MAAM,GAAG,YAAY,CAAC;QACtB,YAAY,GAAG,QAAQ,CAAC;IAC1B,CAAC;SAAM,IAAI,YAAY,IAAI,gBAAgB,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QACnE,MAAM,GAAG,YAAY,CAAC;QACtB,YAAY,GAAG,QAAQ,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,aAAa,CAAC;QACvB,YAAY,GAAG,SAAS,CAAC;IAC3B,CAAC;IAED,0DAA0D;IAC1D,MAAM,eAAe,GAAG,YAAY,KAAK,MAAM,CAAC;IAEhD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC;AACnD,CAAC"}
+{"version":3,"file":"detection.js","sourceRoot":"","sources":["../../src/i18n/detection.ts"],"names":[],"mappings":"AAEA,mFAAmF;AACnF,MAAM,UAAU,GAAG,CAAC,IAA+B,EAAE,SAAmB,EAAE,EAAE,CAC1E,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAEnF;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,OAA+B;IAE/B,MAAM,EACJ,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,gBAAgB,GACjB,GAAG,OAAO,CAAC;IAEZ,IAAI,MAAc,CAAC;IACnB,IAAI,YAAmD,CAAC;IAExD,6CAA6C;IAC7C,MAAM,SAAS,GAAG,UAAU,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IAC3D,MAAM,WAAW,GAAG,UAAU,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,UAAU,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;IAE/D,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,GAAG,SAAS,CAAC;QACnB,YAAY,GAAG,MAAM,CAAC;IACxB,CAAC;SAAM,IAAI,WAAW,EAAE,CAAC;QACvB,MAAM,GAAG,WAAW,CAAC;QACrB,YAAY,GAAG,QAAQ,CAAC;IAC1B,CAAC;SAAM,IAAI,WAAW,EAAE,CAAC;QACvB,MAAM,GAAG,WAAW,CAAC;QACrB,YAAY,GAAG,QAAQ,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,aAAa,CAAC;QACvB,YAAY,GAAG,SAAS,CAAC;IAC3B,CAAC;IAED,0DAA0D;IAC1D,MAAM,eAAe,GAAG,YAAY,KAAK,MAAM,CAAC;IAEhD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC;AACnD,CAAC"}

package/dist/index.d.ts

@@ -1,10 +1,11 @@
-export { createI18nCore, clearManifestCache } from "./cdn";
+export { createI18nCore, clearManifestCache, clearMessagesCache } from "./cdn";
+export { createAutoStorage, createLocalStorage, createMemoryStorage } from "./storage";
 export { normalizeConfig, parseProject, getProjectBaseUrl } from "./config";
 export { extractLanguages } from "./manifest";
 export { createLogger } from "./logger";
 export { detectLocale } from "./i18n/detection";
 export { TtlCache, buildCacheKey } from "./cache";
 export { extractLocale, getLocaleFromPath, hasLocalePrefix, removeLocalePrefix, addLocalePrefix, replaceLocaleInPath, createLocalePath, type LocaleConfig, } from "./utils/locale";
-export type { I18nCoreConfig, NormalizedConfig, ParsedProject, ManifestResponse, ManifestLanguage, ManifestFile, LanguageOption, Messages, Locale, I18nCore, Logger, LogLevel, CacheEntry, } from "./types";
+export type { I18nCoreConfig, NormalizedConfig, ParsedProject, ManifestResponse, ManifestLanguage, ManifestFile, LanguageOption, Messages, Locale, I18nCore, TranslationStorage, Logger, LogLevel, CacheEntry, } from "./types";
 export type { I18nMiddlewareConfig, LocaleDetectionOptions, LocaleDetectionResult, LocalePrefix, } from "./i18n/types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAG3D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGlD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,YAAY,GAClB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EAEV,cAAc,EACd,gBAAgB,EAChB,aAAa,EAGb,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EAGd,QAAQ,EACR,MAAM,EAGN,QAAQ,EAGR,MAAM,EACN,QAAQ,EACR,UAAU,GACX,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,YAAY,GACb,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAG/E,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGvF,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGlD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,YAAY,GAClB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EAEV,cAAc,EACd,gBAAgB,EAChB,aAAa,EAGb,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EAGd,QAAQ,EACR,MAAM,EAGN,QAAQ,EAGR,kBAAkB,EAGlB,MAAM,EACN,QAAQ,EACR,UAAU,GACX,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,YAAY,GACb,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,5 +1,7 @@
 // Main API
-export { createI18nCore, clearManifestCache } from "./cdn";
+export { createI18nCore, clearManifestCache, clearMessagesCache } from "./cdn";
+// Storage adapters
+export { createAutoStorage, createLocalStorage, createMemoryStorage } from "./storage";
 // Configuration utilities
 export { normalizeConfig, parseProject, getProjectBaseUrl } from "./config";
 // Manifest utilities

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAE3D,0BAA0B;AAC1B,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE5E,qBAAqB;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,kBAAkB;AAClB,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAElD,oEAAoE;AACpE,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,GAEjB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAE/E,mBAAmB;AACnB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEvF,0BAA0B;AAC1B,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE5E,qBAAqB;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,kBAAkB;AAClB,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAElD,oEAAoE;AACpE,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,GAEjB,MAAM,gBAAgB,CAAC"}

package/dist/storage/index.d.ts

@@ -0,0 +1,9 @@
+import type { TranslationStorage } from "../types";
+export { createLocalStorage } from "./localStorage";
+export { createMemoryStorage } from "./memory";
+/**
+ * Auto-detect the best available storage.
+ * Uses localStorage if available (browser), otherwise falls back to in-memory.
+ */
+export declare const createAutoStorage: () => TranslationStorage;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAInD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAU/C;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAO,kBAcpC,CAAC"}

package/dist/storage/index.js

@@ -0,0 +1,25 @@
+import { createLocalStorage } from "./localStorage";
+import { createMemoryStorage } from "./memory";
+export { createLocalStorage } from "./localStorage";
+export { createMemoryStorage } from "./memory";
+/**
+ * Auto-detect the best available storage.
+ * Uses localStorage if available (browser), otherwise falls back to in-memory.
+ */
+export const createAutoStorage = () => {
+    try {
+        const storage = globalThis.localStorage;
+        if (storage) {
+            // Test that localStorage actually works (may throw in private browsing, iframes, etc.)
+            const testKey = "__better_i18n_test__";
+            storage.setItem(testKey, "1");
+            storage.removeItem(testKey);
+            return createLocalStorage();
+        }
+    }
+    catch {
+        // localStorage not available or not writable
+    }
+    return createMemoryStorage();
+};
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAU/C;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAuB,EAAE;IACxD,IAAI,CAAC;QACH,MAAM,OAAO,GAAI,UAA4C,CAAC,YAAY,CAAC;QAC3E,IAAI,OAAO,EAAE,CAAC;YACZ,uFAAuF;YACvF,MAAM,OAAO,GAAG,sBAAsB,CAAC;YACvC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC9B,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAC5B,OAAO,kBAAkB,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,6CAA6C;IAC/C,CAAC;IACD,OAAO,mBAAmB,EAAE,CAAC;AAC/B,CAAC,CAAC"}

package/dist/storage/localStorage.d.ts

@@ -0,0 +1,8 @@
+import type { TranslationStorage } from "../types";
+/**
+ * Create a storage adapter backed by browser localStorage.
+ * All operations are wrapped in try/catch to handle environments
+ * where localStorage is unavailable or full (quota exceeded).
+ */
+export declare const createLocalStorage: () => TranslationStorage;
+//# sourceMappingURL=localStorage.d.ts.map

package/dist/storage/localStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localStorage.d.ts","sourceRoot":"","sources":["../../src/storage/localStorage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAkBnD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAAO,kBAsBpC,CAAC"}

package/dist/storage/localStorage.js

@@ -0,0 +1,36 @@
+/**
+ * Access localStorage via globalThis to work in any environment.
+ */
+const getStorage = () => globalThis.localStorage;
+/**
+ * Create a storage adapter backed by browser localStorage.
+ * All operations are wrapped in try/catch to handle environments
+ * where localStorage is unavailable or full (quota exceeded).
+ */
+export const createLocalStorage = () => ({
+    get: async (key) => {
+        try {
+            return getStorage()?.getItem(key) ?? null;
+        }
+        catch {
+            return null;
+        }
+    },
+    set: async (key, value) => {
+        try {
+            getStorage()?.setItem(key, value);
+        }
+        catch {
+            // Storage full or unavailable — silently fail
+        }
+    },
+    remove: async (key) => {
+        try {
+            getStorage()?.removeItem(key);
+        }
+        catch {
+            // Silently fail
+        }
+    },
+});
+//# sourceMappingURL=localStorage.js.map

package/dist/storage/localStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localStorage.js","sourceRoot":"","sources":["../../src/storage/localStorage.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,MAAM,UAAU,GAAG,GAA2B,EAAE,CAC7C,UAA4C,CAAC,YAAY,CAAC;AAE7D;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAuB,EAAE,CAAC,CAAC;IAC3D,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACjB,IAAI,CAAC;YACH,OAAO,UAAU,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QACxB,IAAI,CAAC;YACH,UAAU,EAAE,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,8CAA8C;QAChD,CAAC;IACH,CAAC;IACD,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACpB,IAAI,CAAC;YACH,UAAU,EAAE,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB;QAClB,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/storage/memory.d.ts

@@ -0,0 +1,7 @@
+import type { TranslationStorage } from "../types";
+/**
+ * Create an in-memory storage adapter backed by a Map.
+ * Useful as a fallback when no persistent storage is available (e.g., SSR).
+ */
+export declare const createMemoryStorage: () => TranslationStorage;
+//# sourceMappingURL=memory.d.ts.map

package/dist/storage/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/storage/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAAO,kBAWtC,CAAC"}

package/dist/storage/memory.js

@@ -0,0 +1,17 @@
+/**
+ * Create an in-memory storage adapter backed by a Map.
+ * Useful as a fallback when no persistent storage is available (e.g., SSR).
+ */
+export const createMemoryStorage = () => {
+    const store = new Map();
+    return {
+        get: async (key) => store.get(key) ?? null,
+        set: async (key, value) => {
+            store.set(key, value);
+        },
+        remove: async (key) => {
+            store.delete(key);
+        },
+    };
+};
+//# sourceMappingURL=memory.js.map

package/dist/storage/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/storage/memory.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAuB,EAAE;IAC1D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,OAAO;QACL,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI;QAC1C,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;YACxB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACxB,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACpB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/types.d.ts

@@ -6,6 +6,15 @@ export type Locale = string;
  * Log level for debugging
  */
 export type LogLevel = "debug" | "info" | "warn" | "error" | "silent";
+/**
+ * Pluggable storage interface for persistent translation caching.
+ * Compatible with browser localStorage, AsyncStorage, MMKV, or any key-value store.
+ */
+export interface TranslationStorage {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    remove?(key: string): Promise<void>;
+}
 /**
  * Core i18n configuration
  */
@@ -42,6 +51,38 @@ export interface I18nCoreConfig {
      * Custom fetch function (useful for testing or custom environments)
      */
     fetch?: typeof fetch;
+    /**
+     * Persistent storage adapter for offline fallback.
+     * When CDN is unavailable, translations are served from storage.
+     */
+    storage?: TranslationStorage;
+    /**
+     * Bundled/static translations as last-resort fallback.
+     * Used when both CDN and storage are unavailable.
+     * Can be a static object or a lazy-loading function.
+     *
+     * @example
+     * ```ts
+     * // Static import
+     * staticData: { en: { common: { hello: "Hello" } } }
+     *
+     * // Lazy import
+     * staticData: () => import('./fallback-translations.json')
+     * ```
+     */
+    staticData?: Record<string, Messages> | (() => Promise<Record<string, Messages>>);
+    /**
+     * CDN fetch timeout in milliseconds.
+     * If a fetch does not complete within this time, the request is aborted
+     * and fallback sources are tried.
+     * @default 10000
+     */
+    fetchTimeout?: number;
+    /**
+     * Number of retry attempts on CDN fetch failure.
+     * @default 1
+     */
+    retryCount?: number;
 }
 /**
  * Parsed project identifier
@@ -56,6 +97,8 @@ export interface ParsedProject {
 export interface NormalizedConfig extends I18nCoreConfig, ParsedProject {
     cdnBaseUrl: string;
     manifestCacheTtlMs: number;
+    fetchTimeout: number;
+    retryCount: number;
 }
 /**
  * Language information from manifest
@@ -101,9 +144,10 @@ export interface LanguageOption {
     isDefault?: boolean;
 }
 /**
- * Translation messages (flat or nested key-value pairs)
+ * Translation messages keyed by namespace.
+ * Matches the CDN response format: `{ "common": { "key": "value" }, "auth": { ... } }`
  */
-export type Messages = Record<string, unknown>;
+export type Messages = Record<string, Record<string, any>>;
 /**
  * Logger interface
  */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,cAAc,EAAE,aAAa;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,MAAM,EAAE,gBAAgB,CAAC;IAEzB;;OAEG;IACH,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEjF;;OAEG;IACH,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEnD;;OAEG;IACH,UAAU,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEpC;;OAEG;IACH,YAAY,EAAE,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CAC/C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@better-i18n/core",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "Framework-agnostic core utilities for Better i18n",
   "license": "MIT",
   "repository": {