@better-i18n/core 0.1.2 → 0.1.4

package/README.md

@@ -2,6 +2,13 @@
 
 Framework-agnostic core utilities for fetching translations from Better i18n CDN.
 
+## Features
+
+- **Framework Agnostic** - Works with any JavaScript runtime
+- **Edge-Ready** - Optimized for edge environments (Cloudflare, Vercel, etc.)
+- **Type-Safe** - Full TypeScript support
+- **Cached** - Built-in manifest caching with configurable TTL
+
 ## Installation
 
 ```bash
@@ -13,26 +20,26 @@ bun add @better-i18n/core
 ## Usage
 
 ```typescript
-import { createI18nCore } from '@better-i18n/core'
+import { createI18nCore } from "@better-i18n/core";
 
 const i18n = createI18nCore({
-  project: 'your-org/your-project',
-  defaultLocale: 'en',
-})
+  project: "your-org/your-project",
+  defaultLocale: "en",
+});
 
 // Fetch messages for a locale
-const messages = await i18n.getMessages('en')
+const messages = await i18n.getMessages("en");
 
 // Get available locales
-const locales = await i18n.getLocales()
-// ['en', 'tr', 'de', ...]
+const locales = await i18n.getLocales();
+// ["en", "tr", "de", ...]
 
 // Get language options with metadata (for UI)
-const languages = await i18n.getLanguages()
-// [{ code: 'en', name: 'English', nativeName: 'English', flagUrl: '...' }, ...]
+const languages = await i18n.getLanguages();
+// [{ code: "en", name: "English", nativeName: "English", flagUrl: "..." }, ...]
 
 // Get manifest
-const manifest = await i18n.getManifest()
+const manifest = await i18n.getManifest();
 ```
 
 ## Configuration
@@ -40,26 +47,29 @@ const manifest = await i18n.getManifest()
 ```typescript
 interface I18nCoreConfig {
   // Required
-  project: string        // "org/project" format
-  defaultLocale: string  // e.g., "en"
+  project: string;        // "org/project" format
+  defaultLocale: string;  // e.g., "en"
 
   // Optional
-  cdnBaseUrl?: string           // default: "https://cdn.better-i18n.com"
-  manifestCacheTtlMs?: number   // default: 300000 (5 minutes)
-  debug?: boolean               // default: false
-  logLevel?: LogLevel           // default: "warn"
-  fetch?: typeof fetch          // custom fetch function
+  cdnBaseUrl?: string;           // default: "https://cdn.better-i18n.com"
+  manifestCacheTtlMs?: number;   // default: 300000 (5 minutes)
+  debug?: boolean;               // default: false
+  logLevel?: LogLevel;           // default: "warn"
+  fetch?: typeof fetch;          // custom fetch function
 }
 ```
 
-## Used By
+## Framework Integrations
 
 This package is the foundation for:
 
-- `@better-i18n/next` - Next.js integration
-- `@better-i18n/use-intl` - TanStack/React integration
-- `@better-i18n/i18next-backend` - i18next backend plugin
+- `@better-i18n/next` - Next.js integration with ISR support
+- `@better-i18n/react` - React/TanStack integration (coming soon)
+
+## Documentation
+
+Full documentation available at [docs.better-i18n.com](https://docs.better-i18n.com)
 
 ## License
 
-MIT
+MIT © [Better i18n](https://better-i18n.com)

package/dist/cache.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Simple in-memory TTL cache
+ */
+export declare class TtlCache<T> {
+    private cache;
+    /**
+     * Get a value from cache if not expired
+     */
+    get(key: string): T | undefined;
+    /**
+     * Set a value in cache with TTL
+     */
+    set(key: string, value: T, ttlMs: number): void;
+    /**
+     * Check if a key exists and is not expired
+     */
+    has(key: string): boolean;
+    /**
+     * Delete a key from cache
+     */
+    delete(key: string): boolean;
+    /**
+     * Clear all entries
+     */
+    clear(): void;
+}
+/**
+ * Build a cache key from config
+ */
+export declare const buildCacheKey: (cdnBaseUrl: string, project: string) => string;
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,QAAQ,CAAC,CAAC;IACrB,OAAO,CAAC,KAAK,CAAoC;IAEjD;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAY/B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAO/C;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,YAAY,MAAM,EAAE,SAAS,MAAM,KAAG,MACxC,CAAC"}

package/dist/cache.js

@@ -0,0 +1,51 @@
+/**
+ * Simple in-memory TTL cache
+ */
+export class TtlCache {
+    cache = new Map();
+    /**
+     * Get a value from cache if not expired
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return undefined;
+        if (entry.expiresAt <= Date.now()) {
+            this.cache.delete(key);
+            return undefined;
+        }
+        return entry.value;
+    }
+    /**
+     * Set a value in cache with TTL
+     */
+    set(key, value, ttlMs) {
+        this.cache.set(key, {
+            value,
+            expiresAt: Date.now() + ttlMs,
+        });
+    }
+    /**
+     * Check if a key exists and is not expired
+     */
+    has(key) {
+        return this.get(key) !== undefined;
+    }
+    /**
+     * Delete a key from cache
+     */
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    /**
+     * Clear all entries
+     */
+    clear() {
+        this.cache.clear();
+    }
+}
+/**
+ * Build a cache key from config
+ */
+export const buildCacheKey = (cdnBaseUrl, project) => `${cdnBaseUrl}|${project}`;
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,QAAQ;IACX,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEjD;;OAEG;IACH,GAAG,CAAC,GAAW;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAE7B,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAClC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAW,EAAE,KAAQ,EAAE,KAAa;QACtC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SAC9B,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,UAAkB,EAAE,OAAe,EAAU,EAAE,CAC3E,GAAG,UAAU,IAAI,OAAO,EAAE,CAAC"}

package/dist/cdn.d.ts

@@ -0,0 +1,21 @@
+import type { I18nCore, I18nCoreConfig } from "./types";
+/**
+ * Create an i18n core instance
+ *
+ * @example
+ * ```ts
+ * const i18n = createI18nCore({
+ *   project: 'acme/dashboard',
+ *   defaultLocale: 'en',
+ * })
+ *
+ * const messages = await i18n.getMessages('en')
+ * const locales = await i18n.getLocales()
+ * ```
+ */
+export declare const createI18nCore: (config: I18nCoreConfig) => I18nCore;
+/**
+ * Clear the manifest cache (useful for testing)
+ */
+export declare const clearManifestCache: () => void;
+//# sourceMappingURL=cdn.d.ts.map

package/dist/cdn.d.ts.map

@@ -0,0 +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;AAmFjB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,cAAc,KAAG,QAkCvD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,QAAO,IAErC,CAAC"}

package/dist/cdn.js

@@ -0,0 +1,103 @@
+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 manifestCache = new TtlCache();
+/**
+ * Fetch manifest from CDN
+ */
+const fetchManifest = async (config, fetchFn) => {
+    const logger = createLogger(config, "manifest");
+    const url = `${getProjectBaseUrl(config)}/manifest.json`;
+    logger.debug("fetching", url);
+    const response = await fetchFn(url);
+    if (!response.ok) {
+        const message = `Manifest fetch failed (${response.status})`;
+        logger.error(message);
+        throw new Error(`[better-i18n] ${message}`);
+    }
+    const data = (await response.json());
+    if (!Array.isArray(data.languages)) {
+        throw new Error("[better-i18n] Manifest payload missing languages array");
+    }
+    logger.debug("fetched", { languages: data.languages.length });
+    return data;
+};
+/**
+ * Get manifest with caching
+ */
+const getManifestWithCache = async (config, fetchFn, forceRefresh = false) => {
+    const cacheKey = buildCacheKey(config.cdnBaseUrl, config.project);
+    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;
+};
+/**
+ * Fetch messages for a locale
+ */
+const fetchMessages = 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);
+    if (!response.ok) {
+        const message = `Messages fetch failed for locale "${locale}" (${response.status})`;
+        logger.error(message);
+        throw new Error(`[better-i18n] ${message}`);
+    }
+    const data = (await response.json());
+    logger.debug("fetched", { locale, keys: Object.keys(data).length });
+    return data;
+};
+/**
+ * Create an i18n core instance
+ *
+ * @example
+ * ```ts
+ * const i18n = createI18nCore({
+ *   project: 'acme/dashboard',
+ *   defaultLocale: 'en',
+ * })
+ *
+ * const messages = await i18n.getMessages('en')
+ * const locales = await i18n.getLocales()
+ * ```
+ */
+export const createI18nCore = (config) => {
+    const normalized = normalizeConfig(config);
+    const fetchFn = normalized.fetch ?? fetch;
+    return {
+        config: normalized,
+        getManifest: (options) => getManifestWithCache(normalized, fetchFn, options?.forceRefresh),
+        getMessages: (locale) => fetchMessages(normalized, locale, fetchFn),
+        getLocales: async () => {
+            const manifest = await getManifestWithCache(normalized, fetchFn);
+            const languages = extractLanguages(manifest);
+            if (languages.length === 0) {
+                throw new Error("[better-i18n] No locales found in manifest");
+            }
+            return languages.map((lang) => lang.code);
+        },
+        getLanguages: async () => {
+            const manifest = await getManifestWithCache(normalized, fetchFn);
+            const languages = extractLanguages(manifest);
+            if (languages.length === 0) {
+                throw new Error("[better-i18n] No languages found in manifest");
+            }
+            return languages;
+        },
+    };
+};
+/**
+ * Clear the manifest cache (useful for testing)
+ */
+export const clearManifestCache = () => {
+    manifestCache.clear();
+};
+//# sourceMappingURL=cdn.js.map

package/dist/cdn.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,14 @@
+import type { I18nCoreConfig, NormalizedConfig, ParsedProject } from "./types";
+/**
+ * Parse project string "org/slug" into workspaceId and projectSlug
+ */
+export declare const parseProject: (project: string) => ParsedProject;
+/**
+ * Normalize config with defaults
+ */
+export declare const normalizeConfig: (config: I18nCoreConfig) => NormalizedConfig;
+/**
+ * Build the project base URL on CDN
+ */
+export declare const getProjectBaseUrl: (config: NormalizedConfig) => string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +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"}

package/dist/config.js

@@ -0,0 +1,39 @@
+const DEFAULT_CDN_BASE_URL = "https://cdn.better-i18n.com";
+const DEFAULT_CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes
+/**
+ * Parse project string "org/slug" into workspaceId and projectSlug
+ */
+export const parseProject = (project) => {
+    const parts = project.split("/");
+    if (parts.length !== 2 || !parts[0] || !parts[1]) {
+        throw new Error(`[better-i18n] Invalid project format "${project}". Expected "org/project" (e.g., "acme/dashboard")`);
+    }
+    return {
+        workspaceId: parts[0],
+        projectSlug: parts[1],
+    };
+};
+/**
+ * Normalize config with defaults
+ */
+export const normalizeConfig = (config) => {
+    if (!config.project?.trim()) {
+        throw new Error("[better-i18n] project is required");
+    }
+    if (!config.defaultLocale?.trim()) {
+        throw new Error("[better-i18n] defaultLocale is required");
+    }
+    const { workspaceId, projectSlug } = parseProject(config.project);
+    return {
+        ...config,
+        workspaceId,
+        projectSlug,
+        cdnBaseUrl: config.cdnBaseUrl?.replace(/\/$/, "") || DEFAULT_CDN_BASE_URL,
+        manifestCacheTtlMs: config.manifestCacheTtlMs ?? DEFAULT_CACHE_TTL_MS,
+    };
+};
+/**
+ * Build the project base URL on CDN
+ */
+export const getProjectBaseUrl = (config) => `${config.cdnBaseUrl}/${config.workspaceId}/${config.projectSlug}`;
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +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"}

package/dist/i18n/detection.d.ts

@@ -0,0 +1,6 @@
+import type { LocaleDetectionOptions, LocaleDetectionResult } from "./types";
+/**
+ * Framework-agnostic locale detection logic
+ */
+export declare function detectLocale(options: LocaleDetectionOptions): LocaleDetectionResult;
+//# sourceMappingURL=detection.d.ts.map

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

@@ -0,0 +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"}

package/dist/i18n/detection.js

@@ -0,0 +1,29 @@
+/**
+ * Framework-agnostic locale detection logic
+ */
+export function detectLocale(options) {
+    const { pathLocale, cookieLocale, headerLocale, defaultLocale, availableLocales, } = options;
+    let locale;
+    let detectedFrom;
+    // Priority: path > cookie > header > default
+    if (pathLocale && availableLocales.includes(pathLocale)) {
+        locale = pathLocale;
+        detectedFrom = "path";
+    }
+    else if (cookieLocale && availableLocales.includes(cookieLocale)) {
+        locale = cookieLocale;
+        detectedFrom = "cookie";
+    }
+    else if (headerLocale && availableLocales.includes(headerLocale)) {
+        locale = headerLocale;
+        detectedFrom = "header";
+    }
+    else {
+        locale = defaultLocale;
+        detectedFrom = "default";
+    }
+    // Should set cookie if locale differs from current cookie
+    const shouldSetCookie = cookieLocale !== locale;
+    return { locale, detectedFrom, shouldSetCookie };
+}
+//# sourceMappingURL=detection.js.map

package/dist/i18n/detection.js.map

@@ -0,0 +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"}

package/dist/i18n/types.d.ts

@@ -0,0 +1,24 @@
+export interface I18nMiddlewareConfig {
+    project: string;
+    defaultLocale: string;
+    detection?: {
+        cookie?: boolean;
+        browserLanguage?: boolean;
+        cookieName?: string;
+        cookieMaxAge?: number;
+    };
+}
+export interface LocaleDetectionOptions {
+    project: string;
+    defaultLocale: string;
+    pathLocale?: string | null;
+    cookieLocale?: string | null;
+    headerLocale?: string | null;
+    availableLocales: string[];
+}
+export interface LocaleDetectionResult {
+    locale: string;
+    detectedFrom: "path" | "cookie" | "header" | "default";
+    shouldSetCookie: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/i18n/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE;QACV,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvD,eAAe,EAAE,OAAO,CAAC;CAC1B"}

package/dist/i18n/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/i18n/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/i18n/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { createI18nCore, clearManifestCache } from "./cdn";
+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 type { I18nCoreConfig, NormalizedConfig, ParsedProject, ManifestResponse, ManifestLanguage, ManifestFile, LanguageOption, Messages, Locale, I18nCore, Logger, LogLevel, CacheEntry, } from "./types";
+export type { I18nMiddlewareConfig, LocaleDetectionOptions, LocaleDetectionResult, } from "./i18n/types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,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,GACtB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+// Main API
+export { createI18nCore, clearManifestCache } from "./cdn";
+// Configuration utilities
+export { normalizeConfig, parseProject, getProjectBaseUrl } from "./config";
+// Manifest utilities
+export { extractLanguages } from "./manifest";
+// Logger
+export { createLogger } from "./logger";
+// Middleware logic
+export { detectLocale } from "./i18n/detection";
+// Cache utilities
+export { TtlCache, buildCacheKey } from "./cache";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/logger.d.ts

@@ -0,0 +1,6 @@
+import type { Logger, NormalizedConfig } from "./types";
+/**
+ * Create a logger instance with namespace prefix
+ */
+export declare const createLogger: (config: NormalizedConfig, namespace: string) => Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAY,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAalE;;GAEG;AACH,eAAO,MAAM,YAAY,GACvB,QAAQ,gBAAgB,EACxB,WAAW,MAAM,KAChB,MAoBF,CAAC"}

package/dist/logger.js

@@ -0,0 +1,31 @@
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    silent: 4,
+};
+const shouldLog = (targetLevel, configLevel) => LOG_LEVELS[targetLevel] >= LOG_LEVELS[configLevel];
+/**
+ * Create a logger instance with namespace prefix
+ */
+export const createLogger = (config, namespace) => {
+    const prefix = `[better-i18n:${namespace}]`;
+    const level = config.logLevel ?? (config.debug ? "debug" : "warn");
+    const noop = () => { };
+    return {
+        debug: shouldLog("debug", level)
+            ? (...args) => console.debug(prefix, ...args)
+            : noop,
+        info: shouldLog("info", level)
+            ? (...args) => console.info(prefix, ...args)
+            : noop,
+        warn: shouldLog("warn", level)
+            ? (...args) => console.warn(prefix, ...args)
+            : noop,
+        error: shouldLog("error", level)
+            ? (...args) => console.error(prefix, ...args)
+            : noop,
+    };
+};
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAA6B;IAC3C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;CACV,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,WAAqB,EAAE,WAAqB,EAAW,EAAE,CAC1E,UAAU,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;AAErD;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,MAAwB,EACxB,SAAiB,EACT,EAAE;IACV,MAAM,MAAM,GAAG,gBAAgB,SAAS,GAAG,CAAC;IAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAEnE,MAAM,IAAI,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;IAEtB,OAAO;QACL,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC;YAC9B,CAAC,CAAC,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;YACxD,CAAC,CAAC,IAAI;QACR,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC;YAC5B,CAAC,CAAC,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;YACvD,CAAC,CAAC,IAAI;QACR,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC;YAC5B,CAAC,CAAC,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;YACvD,CAAC,CAAC,IAAI;QACR,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC;YAC9B,CAAC,CAAC,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;YACxD,CAAC,CAAC,IAAI;KACT,CAAC;AACJ,CAAC,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,6 @@
+import type { LanguageOption, ManifestResponse } from "./types";
+/**
+ * Extract and normalize languages from manifest
+ */
+export declare const extractLanguages: (manifest: ManifestResponse) => LanguageOption[];
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAEd,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAajB;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAC3B,UAAU,gBAAgB,KACzB,cAAc,EAahB,CAAC"}

package/dist/manifest.js

@@ -0,0 +1,23 @@
+/**
+ * Normalize a manifest language to a simplified language option
+ */
+const normalizeLanguage = (language) => ({
+    code: language.code,
+    name: language.name,
+    nativeName: language.nativeName || language.name || language.code.toUpperCase(),
+    flagUrl: language.flagUrl ?? null,
+});
+/**
+ * Extract and normalize languages from manifest
+ */
+export const extractLanguages = (manifest) => {
+    const languages = Array.isArray(manifest.languages)
+        ? manifest.languages
+        : [];
+    return languages
+        .filter((language) => !!language &&
+        typeof language.code === "string" &&
+        language.code.length > 0)
+        .map(normalizeLanguage);
+};
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,iBAAiB,GAAG,CAAC,QAA0B,EAAkB,EAAE,CAAC,CAAC;IACzE,IAAI,EAAE,QAAQ,CAAC,IAAI;IACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;IACnB,UAAU,EACR,QAAQ,CAAC,UAAU,IAAI,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE;IACrE,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,IAAI;CAClC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,QAA0B,EACR,EAAE;IACpB,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;QACjD,CAAC,CAAC,QAAQ,CAAC,SAAS;QACpB,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,SAAS;SACb,MAAM,CACL,CAAC,QAAQ,EAAgC,EAAE,CACzC,CAAC,CAAC,QAAQ;QACV,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ;QACjC,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAC3B;SACA,GAAG,CAAC,iBAAiB,CAAC,CAAC;AAC5B,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Supported locale string (e.g., "en", "en-US", "tr")
+ */
+export type Locale = string;
+/**
+ * Log level for debugging
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error" | "silent";
+/**
+ * Core i18n configuration
+ */
+export interface I18nCoreConfig {
+    /**
+     * Project identifier in format "org/project" (e.g., "acme/dashboard")
+     */
+    project: string;
+    /**
+     * Default locale to use when no locale is specified
+     */
+    defaultLocale: string;
+    /**
+     * CDN base URL
+     * @default "https://cdn.better-i18n.com"
+     */
+    cdnBaseUrl?: string;
+    /**
+     * Cache TTL in milliseconds for manifest
+     * @default 300000 (5 minutes)
+     */
+    manifestCacheTtlMs?: number;
+    /**
+     * Enable debug logging
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Log level
+     * @default "warn"
+     */
+    logLevel?: LogLevel;
+    /**
+     * Custom fetch function (useful for testing or custom environments)
+     */
+    fetch?: typeof fetch;
+}
+/**
+ * Parsed project identifier
+ */
+export interface ParsedProject {
+    workspaceId: string;
+    projectSlug: string;
+}
+/**
+ * Normalized configuration with all defaults applied
+ */
+export interface NormalizedConfig extends I18nCoreConfig, ParsedProject {
+    cdnBaseUrl: string;
+    manifestCacheTtlMs: number;
+}
+/**
+ * Language information from manifest
+ */
+export interface ManifestLanguage {
+    code: string;
+    name?: string;
+    nativeName?: string;
+    flagUrl?: string | null;
+    isSource?: boolean;
+    lastUpdated?: string | null;
+    keyCount?: number;
+}
+/**
+ * File information in manifest
+ */
+export interface ManifestFile {
+    url: string;
+    size: number;
+    lastModified: string | null;
+}
+/**
+ * CDN manifest response
+ */
+export interface ManifestResponse {
+    projectSlug?: string;
+    sourceLanguage?: string;
+    languages: ManifestLanguage[];
+    files?: Record<string, ManifestFile>;
+    updatedAt?: string;
+}
+/**
+ * Simplified language option for UI components
+ */
+export interface LanguageOption {
+    code: string;
+    name?: string;
+    nativeName?: string;
+    flagUrl?: string | null;
+}
+/**
+ * Translation messages (flat or nested key-value pairs)
+ */
+export type Messages = Record<string, unknown>;
+/**
+ * Logger interface
+ */
+export interface Logger {
+    debug: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+}
+/**
+ * Cache entry with expiration
+ */
+export interface CacheEntry<T> {
+    value: T;
+    expiresAt: number;
+}
+/**
+ * i18n core instance returned by createI18nCore
+ */
+export interface I18nCore {
+    /**
+     * Resolved configuration
+     */
+    config: NormalizedConfig;
+    /**
+     * Fetch manifest from CDN
+     */
+    getManifest: (options?: {
+        forceRefresh?: boolean;
+    }) => Promise<ManifestResponse>;
+    /**
+     * Get messages for a specific locale
+     */
+    getMessages: (locale: string) => Promise<Messages>;
+    /**
+     * Get available locale codes
+     */
+    getLocales: () => Promise<string[]>;
+    /**
+     * Get language options with metadata (for UI components)
+     */
+    getLanguages: () => Promise<LanguageOption[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@better-i18n/core",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Framework-agnostic core utilities for Better i18n",
   "license": "MIT",
   "repository": {
@@ -11,7 +11,7 @@
   "bugs": {
     "url": "https://github.com/better-i18n/better-i18n/issues"
   },
-  "homepage": "https://github.com/better-i18n/better-i18n/tree/main/packages/i18n-core",
+  "homepage": "https://github.com/better-i18n/better-i18n/tree/main/packages/core",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -40,10 +40,10 @@
   "scripts": {
     "build": "tsc",
     "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist",
+    "prepublishOnly": "bun run build"
   },
   "devDependencies": {
-    "@better-i18n/typescript-config": "workspace:*",
     "@types/node": "^20.0.0",
     "typescript": "~5.9.2"
   }