@kopynator/core 1.0.0 → 1.0.2

package/dist/index.d.mts

@@ -3,7 +3,8 @@ interface KopyConfig {
     projectId?: string;
     baseUrl?: string;
     defaultLocale?: string;
-    mode?: 'local' | 'live';
+    mode?: 'local' | 'live' | 'hybrid';
+    languages?: string[];
 }
 interface TranslationResponse {
     [key: string]: string;
@@ -14,6 +15,7 @@ declare class KopyFetcher {
     constructor(config: KopyConfig);
     fetchTranslations(locale: string): Promise<TranslationResponse>;
     fetchAvailableLanguages(): Promise<string[]>;
+    fetchLocal(locale: string): Promise<TranslationResponse>;
 }
 
 declare class KopyCompiler {
@@ -28,17 +30,20 @@ declare class KopyCompiler {
 interface KopyStorage {
     get(key: string): string | null;
     set(key: string, value: string): void;
+    clear(): void;
 }
 declare class MemoryStorage implements KopyStorage {
     private cache;
     get(key: string): string | null;
     set(key: string, value: string): void;
+    clear(): void;
 }
 declare class LocalStorageWrapper implements KopyStorage {
     get(key: string): string | null;
     set(key: string, value: string): void;
+    clear(): void;
 }
-declare const getBestStorage: () => KopyStorage;
+declare const getBestStorage: (usePersistence?: boolean) => KopyStorage;
 
 declare class Kopynator {
     private config;
@@ -46,14 +51,21 @@ declare class Kopynator {
     private storage;
     private translations;
     private currentLocale;
+    private availableLanguages;
     constructor(config: KopyConfig);
     /**
      * Initialize the SDK and load initial translations.
      */
     init(): Promise<void>;
+    /**
+     * Fetch and update the list of available languages from the API.
+     */
+    refreshAvailableLanguages(): Promise<string[]>;
+    getLanguages(): string[];
+    getCurrentLocale(): string;
     /**
      * Load translations for a specific locale.
-     * Priority: Memory > Storage (Cache) > API
+     * Priority: Local Assets (Base) -> API (Override)
      */
     loadLocale(locale: string): Promise<void>;
     /**

package/dist/index.d.ts

@@ -3,7 +3,8 @@ interface KopyConfig {
     projectId?: string;
     baseUrl?: string;
     defaultLocale?: string;
-    mode?: 'local' | 'live';
+    mode?: 'local' | 'live' | 'hybrid';
+    languages?: string[];
 }
 interface TranslationResponse {
     [key: string]: string;
@@ -14,6 +15,7 @@ declare class KopyFetcher {
     constructor(config: KopyConfig);
     fetchTranslations(locale: string): Promise<TranslationResponse>;
     fetchAvailableLanguages(): Promise<string[]>;
+    fetchLocal(locale: string): Promise<TranslationResponse>;
 }
 
 declare class KopyCompiler {
@@ -28,17 +30,20 @@ declare class KopyCompiler {
 interface KopyStorage {
     get(key: string): string | null;
     set(key: string, value: string): void;
+    clear(): void;
 }
 declare class MemoryStorage implements KopyStorage {
     private cache;
     get(key: string): string | null;
     set(key: string, value: string): void;
+    clear(): void;
 }
 declare class LocalStorageWrapper implements KopyStorage {
     get(key: string): string | null;
     set(key: string, value: string): void;
+    clear(): void;
 }
-declare const getBestStorage: () => KopyStorage;
+declare const getBestStorage: (usePersistence?: boolean) => KopyStorage;
 
 declare class Kopynator {
     private config;
@@ -46,14 +51,21 @@ declare class Kopynator {
     private storage;
     private translations;
     private currentLocale;
+    private availableLanguages;
     constructor(config: KopyConfig);
     /**
      * Initialize the SDK and load initial translations.
      */
     init(): Promise<void>;
+    /**
+     * Fetch and update the list of available languages from the API.
+     */
+    refreshAvailableLanguages(): Promise<string[]>;
+    getLanguages(): string[];
+    getCurrentLocale(): string;
     /**
      * Load translations for a specific locale.
-     * Priority: Memory > Storage (Cache) > API
+     * Priority: Local Assets (Base) -> API (Override)
      */
     loadLocale(locale: string): Promise<void>;
     /**

package/dist/index.js

@@ -29,21 +29,36 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/utils/flatten.ts
+function flatten(obj, prefix = "") {
+  return Object.keys(obj).reduce((acc, k) => {
+    const pre = prefix.length ? prefix + "." : "";
+    if (typeof obj[k] === "object" && obj[k] !== null && !Array.isArray(obj[k])) {
+      Object.assign(acc, flatten(obj[k], pre + k));
+    } else {
+      acc[pre + k] = String(obj[k]);
+    }
+    return acc;
+  }, {});
+}
+
 // src/services/fetcher.ts
 var KopyFetcher = class {
   constructor(config) {
     this.config = config;
-    this.baseUrl = config.baseUrl || "http://localhost:7300/api";
+    this.baseUrl = config.baseUrl || "https://api.kopynator.com";
   }
   baseUrl;
   async fetchTranslations(locale) {
     try {
-      const url = `${this.baseUrl}/tokens/fetch?token=${this.config.apiKey}&lang=${locale}&nested=false&includeLangKey=false`;
+      const url = `${this.baseUrl}/tokens/fetch?token=${this.config.apiKey}&langs=${locale}&nested=false&includeLangKey=false`;
       const response = await fetch(url);
       if (!response.ok) {
         throw new Error(`Failed to fetch translations: ${response.statusText}`);
       }
-      return await response.json();
+      const data = await response.json();
+      const flattened = flatten(data);
+      return flattened;
     } catch (error) {
       console.error("[Kopynator] Error fetching translations:", error);
       return {};
@@ -62,6 +77,20 @@ var KopyFetcher = class {
       return [];
     }
   }
+  async fetchLocal(locale) {
+    try {
+      const url = `/assets/i18n/${locale}.json`;
+      const response = await fetch(url);
+      if (!response.ok) {
+        throw new Error(`Local translations not found: ${response.statusText}`);
+      }
+      const data = await response.json();
+      const flattened = flatten(data);
+      return flattened;
+    } catch (error) {
+      return {};
+    }
+  }
 };
 
 // src/utils/compiler.ts
@@ -102,6 +131,9 @@ var MemoryStorage = class {
   set(key, value) {
     this.cache.set(key, value);
   }
+  clear() {
+    this.cache.clear();
+  }
 };
 var LocalStorageWrapper = class {
   get(key) {
@@ -110,10 +142,13 @@ var LocalStorageWrapper = class {
   set(key, value) {
     if (typeof localStorage !== "undefined") localStorage.setItem(key, value);
   }
+  clear() {
+    if (typeof localStorage !== "undefined") localStorage.clear();
+  }
 };
 var memoryStorage = new MemoryStorage();
-var getBestStorage = () => {
-  if (typeof localStorage !== "undefined") {
+var getBestStorage = (usePersistence = false) => {
+  if (usePersistence && typeof localStorage !== "undefined") {
     return new LocalStorageWrapper();
   }
   return memoryStorage;
@@ -124,39 +159,75 @@ var Kopynator = class {
   constructor(config) {
     this.config = config;
     this.fetcher = new KopyFetcher(config);
-    this.storage = getBestStorage();
+    this.storage = getBestStorage(false);
     this.currentLocale = config.defaultLocale || "en";
+    this.availableLanguages = config.languages || [];
+    if (!this.config.mode) {
+      this.config.mode = "hybrid";
+    }
   }
   fetcher;
   storage;
   translations = {};
   currentLocale;
+  availableLanguages = [];
   /**
    * Initialize the SDK and load initial translations.
    */
   async init() {
-    await this.loadLocale(this.currentLocale);
+    const tasks = [this.loadLocale(this.currentLocale)];
+    if (this.config.mode !== "local") {
+      tasks.push(this.refreshAvailableLanguages());
+    }
+    await Promise.all(tasks);
+  }
+  /**
+   * Fetch and update the list of available languages from the API.
+   */
+  async refreshAvailableLanguages() {
+    if (!this.config.apiKey || this.config.mode === "local") {
+      return this.availableLanguages;
+    }
+    const langs = await this.fetcher.fetchAvailableLanguages();
+    if (langs && langs.length > 0) {
+      this.availableLanguages = langs;
+    }
+    return this.availableLanguages;
+  }
+  getLanguages() {
+    return this.availableLanguages;
+  }
+  getCurrentLocale() {
+    return this.currentLocale;
   }
   /**
    * Load translations for a specific locale.
-   * Priority: Memory > Storage (Cache) > API
+   * Priority: Local Assets (Base) -> API (Override)
    */
   async loadLocale(locale) {
-    const identifier = this.config.projectId || this.config.apiKey;
-    if (this.translations[locale]) return;
-    const cached = this.storage.get(`kopy_${identifier}_${locale}`);
-    if (cached) {
+    if (this.translations[locale] && Object.keys(this.translations[locale]).length > 0) {
+      return;
+    }
+    this.translations[locale] = {};
+    try {
+      const localData = await this.fetcher.fetchLocal(locale);
+      if (localData && Object.keys(localData).length > 0) {
+        this.translations[locale] = { ...localData };
+      }
+    } catch (e) {
+    }
+    if (this.config.mode !== "local") {
       try {
-        this.translations[locale] = JSON.parse(cached);
-        return;
+        const remoteData = await this.fetcher.fetchTranslations(locale);
+        if (remoteData && Object.keys(remoteData).length > 0) {
+          this.translations[locale] = {
+            ...this.translations[locale],
+            ...remoteData
+          };
+        }
       } catch (e) {
-        console.warn("[Kopynator] Failed to parse cached translations");
       }
     }
-    const data = await this.fetcher.fetchTranslations(locale);
-    this.translations[locale] = data;
-    this.storage.set(`kopy_${identifier}_${locale}`, JSON.stringify(data));
-    this.currentLocale = locale;
   }
   /**
    * Change current locale and load it if necessary.
@@ -170,7 +241,10 @@ var Kopynator = class {
    */
   translate(key, params = {}) {
     const localeTranslations = this.translations[this.currentLocale] || {};
-    const template = localeTranslations[key] || key;
+    const template = localeTranslations[key];
+    if (!template) {
+      return key;
+    }
     return KopyCompiler.compile(template, params);
   }
   /**

package/dist/index.mjs

@@ -1,18 +1,33 @@
+// src/utils/flatten.ts
+function flatten(obj, prefix = "") {
+  return Object.keys(obj).reduce((acc, k) => {
+    const pre = prefix.length ? prefix + "." : "";
+    if (typeof obj[k] === "object" && obj[k] !== null && !Array.isArray(obj[k])) {
+      Object.assign(acc, flatten(obj[k], pre + k));
+    } else {
+      acc[pre + k] = String(obj[k]);
+    }
+    return acc;
+  }, {});
+}
+
 // src/services/fetcher.ts
 var KopyFetcher = class {
   constructor(config) {
     this.config = config;
-    this.baseUrl = config.baseUrl || "http://localhost:7300/api";
+    this.baseUrl = config.baseUrl || "https://api.kopynator.com";
   }
   baseUrl;
   async fetchTranslations(locale) {
     try {
-      const url = `${this.baseUrl}/tokens/fetch?token=${this.config.apiKey}&lang=${locale}&nested=false&includeLangKey=false`;
+      const url = `${this.baseUrl}/tokens/fetch?token=${this.config.apiKey}&langs=${locale}&nested=false&includeLangKey=false`;
       const response = await fetch(url);
       if (!response.ok) {
         throw new Error(`Failed to fetch translations: ${response.statusText}`);
       }
-      return await response.json();
+      const data = await response.json();
+      const flattened = flatten(data);
+      return flattened;
     } catch (error) {
       console.error("[Kopynator] Error fetching translations:", error);
       return {};
@@ -31,6 +46,20 @@ var KopyFetcher = class {
       return [];
     }
   }
+  async fetchLocal(locale) {
+    try {
+      const url = `/assets/i18n/${locale}.json`;
+      const response = await fetch(url);
+      if (!response.ok) {
+        throw new Error(`Local translations not found: ${response.statusText}`);
+      }
+      const data = await response.json();
+      const flattened = flatten(data);
+      return flattened;
+    } catch (error) {
+      return {};
+    }
+  }
 };
 
 // src/utils/compiler.ts
@@ -71,6 +100,9 @@ var MemoryStorage = class {
   set(key, value) {
     this.cache.set(key, value);
   }
+  clear() {
+    this.cache.clear();
+  }
 };
 var LocalStorageWrapper = class {
   get(key) {
@@ -79,10 +111,13 @@ var LocalStorageWrapper = class {
   set(key, value) {
     if (typeof localStorage !== "undefined") localStorage.setItem(key, value);
   }
+  clear() {
+    if (typeof localStorage !== "undefined") localStorage.clear();
+  }
 };
 var memoryStorage = new MemoryStorage();
-var getBestStorage = () => {
-  if (typeof localStorage !== "undefined") {
+var getBestStorage = (usePersistence = false) => {
+  if (usePersistence && typeof localStorage !== "undefined") {
     return new LocalStorageWrapper();
   }
   return memoryStorage;
@@ -93,39 +128,75 @@ var Kopynator = class {
   constructor(config) {
     this.config = config;
     this.fetcher = new KopyFetcher(config);
-    this.storage = getBestStorage();
+    this.storage = getBestStorage(false);
     this.currentLocale = config.defaultLocale || "en";
+    this.availableLanguages = config.languages || [];
+    if (!this.config.mode) {
+      this.config.mode = "hybrid";
+    }
   }
   fetcher;
   storage;
   translations = {};
   currentLocale;
+  availableLanguages = [];
   /**
    * Initialize the SDK and load initial translations.
    */
   async init() {
-    await this.loadLocale(this.currentLocale);
+    const tasks = [this.loadLocale(this.currentLocale)];
+    if (this.config.mode !== "local") {
+      tasks.push(this.refreshAvailableLanguages());
+    }
+    await Promise.all(tasks);
+  }
+  /**
+   * Fetch and update the list of available languages from the API.
+   */
+  async refreshAvailableLanguages() {
+    if (!this.config.apiKey || this.config.mode === "local") {
+      return this.availableLanguages;
+    }
+    const langs = await this.fetcher.fetchAvailableLanguages();
+    if (langs && langs.length > 0) {
+      this.availableLanguages = langs;
+    }
+    return this.availableLanguages;
+  }
+  getLanguages() {
+    return this.availableLanguages;
+  }
+  getCurrentLocale() {
+    return this.currentLocale;
   }
   /**
    * Load translations for a specific locale.
-   * Priority: Memory > Storage (Cache) > API
+   * Priority: Local Assets (Base) -> API (Override)
    */
   async loadLocale(locale) {
-    const identifier = this.config.projectId || this.config.apiKey;
-    if (this.translations[locale]) return;
-    const cached = this.storage.get(`kopy_${identifier}_${locale}`);
-    if (cached) {
+    if (this.translations[locale] && Object.keys(this.translations[locale]).length > 0) {
+      return;
+    }
+    this.translations[locale] = {};
+    try {
+      const localData = await this.fetcher.fetchLocal(locale);
+      if (localData && Object.keys(localData).length > 0) {
+        this.translations[locale] = { ...localData };
+      }
+    } catch (e) {
+    }
+    if (this.config.mode !== "local") {
       try {
-        this.translations[locale] = JSON.parse(cached);
-        return;
+        const remoteData = await this.fetcher.fetchTranslations(locale);
+        if (remoteData && Object.keys(remoteData).length > 0) {
+          this.translations[locale] = {
+            ...this.translations[locale],
+            ...remoteData
+          };
+        }
       } catch (e) {
-        console.warn("[Kopynator] Failed to parse cached translations");
       }
     }
-    const data = await this.fetcher.fetchTranslations(locale);
-    this.translations[locale] = data;
-    this.storage.set(`kopy_${identifier}_${locale}`, JSON.stringify(data));
-    this.currentLocale = locale;
   }
   /**
    * Change current locale and load it if necessary.
@@ -139,7 +210,10 @@ var Kopynator = class {
    */
   translate(key, params = {}) {
     const localeTranslations = this.translations[this.currentLocale] || {};
-    const template = localeTranslations[key] || key;
+    const template = localeTranslations[key];
+    if (!template) {
+      return key;
+    }
     return KopyCompiler.compile(template, params);
   }
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kopynator/core",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Core agnostic logic for Kopynator SDKs",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -19,7 +19,10 @@
     "build": "tsup src/index.ts --format cjs,esm --dts --clean",
     "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
     "lint": "eslint src/**/*.ts",
-    "test": "jest"
+    "test": "jest",
+    "release:patch": "npm version patch",
+    "release:minor": "npm version minor",
+    "release:major": "npm version major"
   },
   "devDependencies": {
     "@types/jest": "^29.5.0",
@@ -30,5 +33,8 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "dependencies": {
+    "@kopynator/core": "^1.0.1"
   }
 }