@kopynator/core 1.0.0

package/README.md

@@ -0,0 +1,37 @@
+# @kopynator/core
+
+The agnostic core engine for the Kopynator i18n platform.
+
+## Features
+- **Zero Dependencies**: Lightweight and fast.
+- **ICU Pluralization**: `{n, plural, =0 {None} =1 {One} other {# items}}`.
+- **Variable Interpolation**: `Hello {{name}}`.
+- **Intelligent Caching**: Syncs with `localStorage` (Web) or uses Memory (Node).
+- **Agnostic**: Works in Browser, React, Vue, Angular, Node.js, and more.
+
+## Installation
+```bash
+npm install @kopynator/core
+```
+
+## Basic Usage
+```typescript
+import { Kopynator } from '@kopynator/core';
+
+const kopy = new Kopynator({
+  apiKey: 'YOUR_PROJECT_TOKEN',
+  projectId: 'YOUR_PROJECT_ID',
+  defaultLocale: 'en'
+});
+
+await kopy.init();
+
+// Simple translation
+console.log(kopy.t('welcome_message'));
+
+// Interpolation
+console.log(kopy.t('greeting', { name: 'Carlos' }));
+
+// Pluralization
+console.log(kopy.t('inbox_count', { n: 5 }));
+```

package/dist/index.d.mts

@@ -0,0 +1,73 @@
+interface KopyConfig {
+    apiKey: string;
+    projectId?: string;
+    baseUrl?: string;
+    defaultLocale?: string;
+    mode?: 'local' | 'live';
+}
+interface TranslationResponse {
+    [key: string]: string;
+}
+declare class KopyFetcher {
+    private config;
+    private baseUrl;
+    constructor(config: KopyConfig);
+    fetchTranslations(locale: string): Promise<TranslationResponse>;
+    fetchAvailableLanguages(): Promise<string[]>;
+}
+
+declare class KopyCompiler {
+    /**
+     * Interpolates variables and handles pluralization in a string template.
+     * Interpolation: "Hello {{name}}" -> "Hello Carlos"
+     * Pluralization: "{n, plural, =0 {No items} =1 {One item} other {# items}}"
+     */
+    static compile(template: string, params?: Record<string, any>): string;
+}
+
+interface KopyStorage {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+}
+declare class MemoryStorage implements KopyStorage {
+    private cache;
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+}
+declare class LocalStorageWrapper implements KopyStorage {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+}
+declare const getBestStorage: () => KopyStorage;
+
+declare class Kopynator {
+    private config;
+    private fetcher;
+    private storage;
+    private translations;
+    private currentLocale;
+    constructor(config: KopyConfig);
+    /**
+     * Initialize the SDK and load initial translations.
+     */
+    init(): Promise<void>;
+    /**
+     * Load translations for a specific locale.
+     * Priority: Memory > Storage (Cache) > API
+     */
+    loadLocale(locale: string): Promise<void>;
+    /**
+     * Change current locale and load it if necessary.
+     */
+    setLocale(locale: string): Promise<void>;
+    /**
+     * Translate a key with optional parameters for interpolation.
+     */
+    translate(key: string, params?: Record<string, any>): string;
+    /**
+     * Shorthand for translate
+     */
+    t(key: string, params?: Record<string, any>): string;
+}
+
+export { KopyCompiler, type KopyConfig, KopyFetcher, type KopyStorage, Kopynator, LocalStorageWrapper, MemoryStorage, type TranslationResponse, getBestStorage };

package/dist/index.d.ts

@@ -0,0 +1,73 @@
+interface KopyConfig {
+    apiKey: string;
+    projectId?: string;
+    baseUrl?: string;
+    defaultLocale?: string;
+    mode?: 'local' | 'live';
+}
+interface TranslationResponse {
+    [key: string]: string;
+}
+declare class KopyFetcher {
+    private config;
+    private baseUrl;
+    constructor(config: KopyConfig);
+    fetchTranslations(locale: string): Promise<TranslationResponse>;
+    fetchAvailableLanguages(): Promise<string[]>;
+}
+
+declare class KopyCompiler {
+    /**
+     * Interpolates variables and handles pluralization in a string template.
+     * Interpolation: "Hello {{name}}" -> "Hello Carlos"
+     * Pluralization: "{n, plural, =0 {No items} =1 {One item} other {# items}}"
+     */
+    static compile(template: string, params?: Record<string, any>): string;
+}
+
+interface KopyStorage {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+}
+declare class MemoryStorage implements KopyStorage {
+    private cache;
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+}
+declare class LocalStorageWrapper implements KopyStorage {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+}
+declare const getBestStorage: () => KopyStorage;
+
+declare class Kopynator {
+    private config;
+    private fetcher;
+    private storage;
+    private translations;
+    private currentLocale;
+    constructor(config: KopyConfig);
+    /**
+     * Initialize the SDK and load initial translations.
+     */
+    init(): Promise<void>;
+    /**
+     * Load translations for a specific locale.
+     * Priority: Memory > Storage (Cache) > API
+     */
+    loadLocale(locale: string): Promise<void>;
+    /**
+     * Change current locale and load it if necessary.
+     */
+    setLocale(locale: string): Promise<void>;
+    /**
+     * Translate a key with optional parameters for interpolation.
+     */
+    translate(key: string, params?: Record<string, any>): string;
+    /**
+     * Shorthand for translate
+     */
+    t(key: string, params?: Record<string, any>): string;
+}
+
+export { KopyCompiler, type KopyConfig, KopyFetcher, type KopyStorage, Kopynator, LocalStorageWrapper, MemoryStorage, type TranslationResponse, getBestStorage };

package/dist/index.js

@@ -0,0 +1,191 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  KopyCompiler: () => KopyCompiler,
+  KopyFetcher: () => KopyFetcher,
+  Kopynator: () => Kopynator,
+  LocalStorageWrapper: () => LocalStorageWrapper,
+  MemoryStorage: () => MemoryStorage,
+  getBestStorage: () => getBestStorage
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/services/fetcher.ts
+var KopyFetcher = class {
+  constructor(config) {
+    this.config = config;
+    this.baseUrl = config.baseUrl || "http://localhost:7300/api";
+  }
+  baseUrl;
+  async fetchTranslations(locale) {
+    try {
+      const url = `${this.baseUrl}/tokens/fetch?token=${this.config.apiKey}&lang=${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();
+    } catch (error) {
+      console.error("[Kopynator] Error fetching translations:", error);
+      return {};
+    }
+  }
+  async fetchAvailableLanguages() {
+    try {
+      const url = `${this.baseUrl}/tokens/languages?token=${this.config.apiKey}`;
+      const response = await fetch(url);
+      if (!response.ok) {
+        throw new Error(`Failed to fetch languages: ${response.statusText}`);
+      }
+      return await response.json();
+    } catch (error) {
+      console.error("[Kopynator] Error fetching available languages:", error);
+      return [];
+    }
+  }
+};
+
+// src/utils/compiler.ts
+var KopyCompiler = class {
+  /**
+   * Interpolates variables and handles pluralization in a string template.
+   * Interpolation: "Hello {{name}}" -> "Hello Carlos"
+   * Pluralization: "{n, plural, =0 {No items} =1 {One item} other {# items}}"
+   */
+  static compile(template, params = {}) {
+    if (!template) return "";
+    let compiled = template.replace(/\{(\w+),\s*plural,\s*((?:[^{}]*|\{[^{}]*\})*)\}/g, (match, key, rules) => {
+      const count = Number(params[key]);
+      if (isNaN(count)) return match;
+      const parts = rules.split(/\s*(=?\d+|other)\s*\{/);
+      const ruleMap = {};
+      for (let i = 1; i < parts.length; i += 2) {
+        const ruleKey = parts[i];
+        const ruleValue = parts[i + 1].split("}")[0];
+        ruleMap[ruleKey] = ruleValue;
+      }
+      const result = ruleMap[`=${count}`] || ruleMap[count.toString()] || ruleMap["other"] || "";
+      return result.replace("#", count.toString());
+    });
+    return compiled.replace(/\{\{\s*([\w.-]+)\s*\}\}/g, (match, key) => {
+      const value = params[key];
+      return value !== void 0 ? String(value) : match;
+    });
+  }
+};
+
+// src/services/storage.ts
+var MemoryStorage = class {
+  cache = /* @__PURE__ */ new Map();
+  get(key) {
+    return this.cache.get(key) || null;
+  }
+  set(key, value) {
+    this.cache.set(key, value);
+  }
+};
+var LocalStorageWrapper = class {
+  get(key) {
+    return typeof localStorage !== "undefined" ? localStorage.getItem(key) : null;
+  }
+  set(key, value) {
+    if (typeof localStorage !== "undefined") localStorage.setItem(key, value);
+  }
+};
+var memoryStorage = new MemoryStorage();
+var getBestStorage = () => {
+  if (typeof localStorage !== "undefined") {
+    return new LocalStorageWrapper();
+  }
+  return memoryStorage;
+};
+
+// src/index.ts
+var Kopynator = class {
+  constructor(config) {
+    this.config = config;
+    this.fetcher = new KopyFetcher(config);
+    this.storage = getBestStorage();
+    this.currentLocale = config.defaultLocale || "en";
+  }
+  fetcher;
+  storage;
+  translations = {};
+  currentLocale;
+  /**
+   * Initialize the SDK and load initial translations.
+   */
+  async init() {
+    await this.loadLocale(this.currentLocale);
+  }
+  /**
+   * Load translations for a specific locale.
+   * Priority: Memory > Storage (Cache) > API
+   */
+  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) {
+      try {
+        this.translations[locale] = JSON.parse(cached);
+        return;
+      } 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.
+   */
+  async setLocale(locale) {
+    await this.loadLocale(locale);
+    this.currentLocale = locale;
+  }
+  /**
+   * Translate a key with optional parameters for interpolation.
+   */
+  translate(key, params = {}) {
+    const localeTranslations = this.translations[this.currentLocale] || {};
+    const template = localeTranslations[key] || key;
+    return KopyCompiler.compile(template, params);
+  }
+  /**
+   * Shorthand for translate
+   */
+  t(key, params = {}) {
+    return this.translate(key, params);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  KopyCompiler,
+  KopyFetcher,
+  Kopynator,
+  LocalStorageWrapper,
+  MemoryStorage,
+  getBestStorage
+});

package/dist/index.mjs

@@ -0,0 +1,159 @@
+// src/services/fetcher.ts
+var KopyFetcher = class {
+  constructor(config) {
+    this.config = config;
+    this.baseUrl = config.baseUrl || "http://localhost:7300/api";
+  }
+  baseUrl;
+  async fetchTranslations(locale) {
+    try {
+      const url = `${this.baseUrl}/tokens/fetch?token=${this.config.apiKey}&lang=${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();
+    } catch (error) {
+      console.error("[Kopynator] Error fetching translations:", error);
+      return {};
+    }
+  }
+  async fetchAvailableLanguages() {
+    try {
+      const url = `${this.baseUrl}/tokens/languages?token=${this.config.apiKey}`;
+      const response = await fetch(url);
+      if (!response.ok) {
+        throw new Error(`Failed to fetch languages: ${response.statusText}`);
+      }
+      return await response.json();
+    } catch (error) {
+      console.error("[Kopynator] Error fetching available languages:", error);
+      return [];
+    }
+  }
+};
+
+// src/utils/compiler.ts
+var KopyCompiler = class {
+  /**
+   * Interpolates variables and handles pluralization in a string template.
+   * Interpolation: "Hello {{name}}" -> "Hello Carlos"
+   * Pluralization: "{n, plural, =0 {No items} =1 {One item} other {# items}}"
+   */
+  static compile(template, params = {}) {
+    if (!template) return "";
+    let compiled = template.replace(/\{(\w+),\s*plural,\s*((?:[^{}]*|\{[^{}]*\})*)\}/g, (match, key, rules) => {
+      const count = Number(params[key]);
+      if (isNaN(count)) return match;
+      const parts = rules.split(/\s*(=?\d+|other)\s*\{/);
+      const ruleMap = {};
+      for (let i = 1; i < parts.length; i += 2) {
+        const ruleKey = parts[i];
+        const ruleValue = parts[i + 1].split("}")[0];
+        ruleMap[ruleKey] = ruleValue;
+      }
+      const result = ruleMap[`=${count}`] || ruleMap[count.toString()] || ruleMap["other"] || "";
+      return result.replace("#", count.toString());
+    });
+    return compiled.replace(/\{\{\s*([\w.-]+)\s*\}\}/g, (match, key) => {
+      const value = params[key];
+      return value !== void 0 ? String(value) : match;
+    });
+  }
+};
+
+// src/services/storage.ts
+var MemoryStorage = class {
+  cache = /* @__PURE__ */ new Map();
+  get(key) {
+    return this.cache.get(key) || null;
+  }
+  set(key, value) {
+    this.cache.set(key, value);
+  }
+};
+var LocalStorageWrapper = class {
+  get(key) {
+    return typeof localStorage !== "undefined" ? localStorage.getItem(key) : null;
+  }
+  set(key, value) {
+    if (typeof localStorage !== "undefined") localStorage.setItem(key, value);
+  }
+};
+var memoryStorage = new MemoryStorage();
+var getBestStorage = () => {
+  if (typeof localStorage !== "undefined") {
+    return new LocalStorageWrapper();
+  }
+  return memoryStorage;
+};
+
+// src/index.ts
+var Kopynator = class {
+  constructor(config) {
+    this.config = config;
+    this.fetcher = new KopyFetcher(config);
+    this.storage = getBestStorage();
+    this.currentLocale = config.defaultLocale || "en";
+  }
+  fetcher;
+  storage;
+  translations = {};
+  currentLocale;
+  /**
+   * Initialize the SDK and load initial translations.
+   */
+  async init() {
+    await this.loadLocale(this.currentLocale);
+  }
+  /**
+   * Load translations for a specific locale.
+   * Priority: Memory > Storage (Cache) > API
+   */
+  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) {
+      try {
+        this.translations[locale] = JSON.parse(cached);
+        return;
+      } 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.
+   */
+  async setLocale(locale) {
+    await this.loadLocale(locale);
+    this.currentLocale = locale;
+  }
+  /**
+   * Translate a key with optional parameters for interpolation.
+   */
+  translate(key, params = {}) {
+    const localeTranslations = this.translations[this.currentLocale] || {};
+    const template = localeTranslations[key] || key;
+    return KopyCompiler.compile(template, params);
+  }
+  /**
+   * Shorthand for translate
+   */
+  t(key, params = {}) {
+    return this.translate(key, params);
+  }
+};
+export {
+  KopyCompiler,
+  KopyFetcher,
+  Kopynator,
+  LocalStorageWrapper,
+  MemoryStorage,
+  getBestStorage
+};

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@kopynator/core",
+  "version": "1.0.0",
+  "description": "Core agnostic logic for Kopynator SDKs",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "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"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "jest": "^29.5.0",
+    "ts-jest": "^29.1.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}