npm - @docyrus/i18n - Versions diffs - 0.0.1 - Mend

@docyrus/i18n 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

package/README.md ADDED Viewed

@@ -0,0 +1,283 @@
+# @docyrus/i18n
+Internationalization provider for Docyrus apps. Provides `DocyrusI18nProvider` + `t()` function with API-based and static translation support, cookie-based locale persistence, and `{{variable}}` interpolation.
+Supports **React**, **Vue**, and **SSR** (Next.js Server Components) via separate entrypoints.
+## Features
+- **Translation Provider**: Wrap your app with `DocyrusI18nProvider` and use `t()` anywhere
+- **API + Static Merge**: Fetch translations from API (`GET /tenant/translations`) and/or provide static JSON
+- **Cookie-based Locale**: Persists locale in a cookie (`docyrus-locale`), survives page reloads
+- **Locale Switching**: `setLocale('en')` writes cookie + refetches translations automatically
+- **Interpolation**: Supports `{{name}}`, `{name}`, and `{0}` placeholder formats
+- **SSR + CSR**: `'use client'` directive for Next.js; static translations available immediately (no loading flash)
+- **Auth Integration**: Accepts `RestApiClient` from `@docyrus/api-client` (auto Authorization header)
+- **React Hooks**: `useDocyrusI18n()` (full context) and `useTranslation()` (lightweight)
+- **Vue Composables**: `useDocyrusI18n()` and `useTranslation()` for Vue 3
+- **Framework-Agnostic Core**: `I18nManager` class for custom integrations
+- **TypeScript**: Full type definitions included
+## Installation
+```bash
+npm install @docyrus/i18n @docyrus/api-client
+```
+```bash
+pnpm add @docyrus/i18n @docyrus/api-client
+```
+### Peer Dependencies
+- `@docyrus/api-client` >= 0.0.9 (required)
+- `react` >= 19.2.0 (optional — required for React/Next.js entrypoint)
+- `vue` >= 3.5.0 (optional — required for Vue entrypoint)
+## Entrypoints
+| Import Path | Description | Framework |
+|-------------|-------------|-----------|
+| `@docyrus/i18n` | React provider, hooks | React, Next.js |
+| `@docyrus/i18n/vue` | Vue provider, composables | Vue 3 |
+| `@docyrus/i18n/core` | Pure TypeScript core (no framework dependency) | Any |
+## Quick Start (React)
+```tsx
+import { DocyrusI18nProvider, useTranslation, useDocyrusI18n } from '@docyrus/i18n';
+import { useDocyrusClient } from '@docyrus/app-auth-ui';
+function App() {
+  const client = useDocyrusClient();
+  return (
+    <DocyrusI18nProvider
+      client={client}
+      staticTranslations={{ 'common.loading': 'Yükleniyor...' }}
+    >
+      <Dashboard />
+    </DocyrusI18nProvider>
+  );
+}
+function Dashboard() {
+  const { t, isLoading } = useTranslation();
+  if (isLoading) return <div>{t('common.loading')}</div>;
+  return <h1>{t('dashboard.title')}</h1>;
+}
+```
+## Quick Start (Next.js SSR)
+```tsx
+// app/layout.tsx (Server Component)
+import { I18nClientProvider } from './i18n-client-provider';
+async function getTranslations() {
+  const res = await fetch(`${API_URL}/tenant/translations`, {
+    headers: { Authorization: `Bearer ${serverToken}` }
+  });
+  return res.json();
+}
+export default async function Layout({ children }: { children: React.ReactNode }) {
+  const { data: translations } = await getTranslations();
+  return (
+    <html>
+      <body>
+        <I18nClientProvider staticTranslations={translations}>
+          {children}
+        </I18nClientProvider>
+      </body>
+    </html>
+  );
+}
+```
+```tsx
+// components/i18n-client-provider.tsx (Client Component)
+'use client';
+import { DocyrusI18nProvider, type TranslationDictionary } from '@docyrus/i18n';
+import { useDocyrusClient } from '@docyrus/app-auth-ui';
+export function I18nClientProvider({
+  children,
+  staticTranslations
+}: {
+  children: React.ReactNode;
+  staticTranslations: TranslationDictionary;
+}) {
+  const client = useDocyrusClient();
+  return (
+    <DocyrusI18nProvider
+      client={client}
+      staticTranslations={staticTranslations}
+    >
+      {children}
+    </DocyrusI18nProvider>
+  );
+}
+```
+## Quick Start (Vue)
+```vue
+<!-- App.vue -->
+<script setup lang="ts">
+import { RouterView } from 'vue-router';
+import { DocyrusI18nProvider } from '@docyrus/i18n/vue';
+import { useDocyrusClient } from '@docyrus/app-auth-ui/vue';
+const client = useDocyrusClient();
+</script>
+<template>
+  <DocyrusI18nProvider :client="client">
+    <RouterView />
+  </DocyrusI18nProvider>
+</template>
+```
+```vue
+<!-- Dashboard.vue -->
+<script setup lang="ts">
+import { useDocyrusI18n } from '@docyrus/i18n/vue';
+const { t, locale, setLocale, isLoading } = useDocyrusI18n();
+</script>
+<template>
+  <div v-if="isLoading">Loading...</div>
+  <div v-else>
+    <h1>{{ t('dashboard.title') }}</h1>
+    <select :value="locale" @change="setLocale(($event.target as HTMLSelectElement).value)">
+      <option value="tr">Turkce</option>
+      <option value="en">English</option>
+    </select>
+  </div>
+</template>
+```
+## Configuration
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `client` | `RestApiClient \| null` | `null` | Pre-configured API client with auth tokens |
+| `getAccessToken` | `() => Promise<string \| null>` | `undefined` | Alternative auth callback (for SSR or custom setups) |
+| `apiUrl` | `string` | `undefined` | API base URL (required with `getAccessToken`) |
+| `translationsEndpoint` | `string` | `'tenant/translations'` | API endpoint path |
+| `staticTranslations` | `Record<string, string>` | `{}` | Pre-loaded translations (available immediately) |
+| `cookieKey` | `string` | `'docyrus-locale'` | Cookie name for locale persistence |
+| `mergeStrategy` | `'api-first' \| 'static-first'` | `'api-first'` | How to merge static and API translations |
+| `fallback` | `'key' \| 'empty' \| (key) => string` | `'key'` | What to return when a key is not found |
+| `disableApiFetch` | `boolean` | `false` | Skip API fetch entirely (use only static translations) |
+| `userLanguageEndpoint` | `string \| false` | `'users/me'` | PATCH endpoint to persist user language. Set `false` to disable |
+## Hooks / Composables
+### useDocyrusI18n()
+Full i18n context. Available in both React and Vue (`@docyrus/i18n/vue`).
+```tsx
+const {
+  t,            // (key: string, params?: Record<string, string | number>) => string
+  locale,       // current locale string | null
+  setLocale,    // (locale: string) => void — writes cookie + refetches
+  status,       // 'loading' | 'ready' | 'error'
+  isLoading,    // boolean
+  translations, // Record<string, string>
+  error,        // Error | null
+  refetch       // () => Promise<void>
+} = useDocyrusI18n();
+```
+### useTranslation()
+Lightweight hook for components that only need `t()`:
+```tsx
+const { t, isLoading } = useTranslation();
+```
+## Merge Strategy
+- **`'api-first'`** (default): `{ ...static, ...api }` — API translations override static. Use this when static translations are fallbacks.
+- **`'static-first'`**: `{ ...api, ...static }` — Static translations override API. Use this for hardcoded overrides.
+Static translations are available immediately on mount (no loading flash). API translations are fetched asynchronously and merged in.
+## Locale Management
+1. On mount: read locale from cookie (`docyrus-locale`). If not set, locale is `null` — API resolves from user profile.
+2. `setLocale('en_US')`: write to cookie + `PATCH users/me { language: 'en_US' }` + refetch translations.
+3. API returns translations based on user's `language` field — no `?locale=` param needed.
+4. Next page load: cookie is read automatically — user stays on the same locale.
+5. SSR: cookie can be read server-side via Next.js `cookies()` API.
+## Interpolation
+Three placeholder formats are supported:
+```tsx
+// Double-brace (static translations convention)
+t('greeting', { name: 'Ali' })       // "Merhaba, {{name}}!" → "Merhaba, Ali!"
+// Single-brace named (API convention)
+t('ai.chat', { name: 'Docyrus' })    // "Talk to {name} AI" → "Talk to Docyrus AI"
+// Single-brace positional (API convention)
+t('add.new', { '0': 'User' })        // "Add New {0}" → "Add New User"
+```
+## API Response Format
+The API endpoint (`GET /tenant/translations`) must return:
+```json
+{
+  "success": true,
+  "data": {
+    "Show Expand Detail Button": "Detayı Genişlet Butonunu Göster",
+    "Add New {0}": "Yeni {0} Ekle",
+    "Talk to {name} AI": "{name} AI ile Konuş"
+  }
+}
+```
+Translation keys are flat strings (not dot-notation). Values may contain `{0}` or `{name}` placeholders.
+## Core (Framework-Agnostic)
+```tsx
+import { I18nManager, interpolate, getLocale, setLocale } from '@docyrus/i18n/core';
+const manager = new I18nManager({
+  staticTranslations: { 'hello': 'Merhaba, {{name}}!' }
+});
+manager.subscribe((state) => console.log(state.status, state.translations));
+await manager.initialize();
+console.log(manager.t('hello', { name: 'Ali' })); // "Merhaba, Ali!"
+```
+## Development
+```bash
+pnpm install
+pnpm dev        # Watch mode
+pnpm build      # Build ESM + dts
+pnpm lint       # ESLint
+pnpm typecheck  # ESLint + tsc --noEmit
+```
+## License
+MIT

package/dist/core-index.d.ts ADDED Viewed

@@ -0,0 +1,107 @@
+import { D as DocyrusI18nConfig, I as I18nStatus, T as TranslationDictionary } from './types-DQtgewNG.js';
+export { a as DocyrusI18nContextValue, F as FallbackStrategy, b as TranslationsResponse } from './types-DQtgewNG.js';
+import '@docyrus/api-client';
+type I18nStateListener = (state: {
+    status: I18nStatus;
+    locale: string | null;
+    translations: TranslationDictionary;
+    error: Error | null;
+}) => void;
+/**
+ * Framework-agnostic translation engine.
+ *
+ * Manages locale persistence (cookie), translation fetching (API + static merge),
+ * and provides the `t()` function for translation lookup with interpolation.
+ *
+ * Pattern follows AuthManager from @docyrus/app-auth-ui.
+ */
+declare class I18nManager {
+    private status;
+    private locale;
+    private translations;
+    private apiTranslations;
+    private error;
+    private listeners;
+    private abortController;
+    private client;
+    private getAccessToken;
+    private apiUrl;
+    private translationsEndpoint;
+    private staticTranslations;
+    private cookieKey;
+    private mergeStrategy;
+    private fallback;
+    private disableApiFetch;
+    private userLanguageEndpoint;
+    constructor(config: DocyrusI18nConfig);
+    getStatus(): I18nStatus;
+    getLocale(): string | null;
+    getTranslations(): TranslationDictionary;
+    getError(): Error | null;
+    subscribe(listener: I18nStateListener): () => void;
+    private notify;
+    /**
+     * Initialize the manager.
+     * 1. Apply static translations immediately (no loading flash).
+     * 2. Fetch from API if enabled and auth is available.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Fetch translations from the API.
+     * Uses RestApiClient.get() if client is available, otherwise raw fetch with getAccessToken.
+     */
+    fetchTranslations(): Promise<void>;
+    /**
+     * Translate a key with optional interpolation.
+     * Falls back based on the configured strategy.
+     */
+    t(key: string, params?: Record<string, string | number>): string;
+    /**
+     * Change the active locale.
+     * Writes to cookie, persists to API (PATCH users/me), and triggers translation refetch.
+     */
+    setLocale(locale: string): Promise<void>;
+    /**
+     * Persist user language preference to API.
+     * PATCH {userLanguageEndpoint} { language: locale }
+     */
+    private persistUserLanguage;
+    /**
+     * Update config at runtime.
+     * Useful when client transitions from null → RestApiClient (auth loading complete).
+     */
+    updateConfig(updates: Partial<Pick<DocyrusI18nConfig, 'client' | 'staticTranslations'>>): void;
+    /** Cleanup: abort in-flight requests + clear listeners. */
+    destroy(): void;
+    private mergeTranslations;
+}
+/**
+ * Interpolate placeholders in a translation string.
+ *
+ * Supports three formats (checked in order):
+ *   1. {{variable}}  — double-brace (static translations convention)
+ *   2. {variable}    — single-brace named (API convention: "Talk to {name} AI")
+ *   3. {0}, {1}      — single-brace positional (API convention: "Add New {0}")
+ *
+ * Positional placeholders use numeric keys: params = { '0': 'User' }
+ *
+ * Examples:
+ *   interpolate('Hello, {{name}}!', { name: 'Ali' })     → 'Hello, Ali!'
+ *   interpolate('Talk to {name} AI', { name: 'Docyrus' }) → 'Talk to Docyrus AI'
+ *   interpolate('Add New {0}', { '0': 'User' })           → 'Add New User'
+ */
+declare function interpolate(template: string, params?: Record<string, string | number>): string;
+/**
+ * Read the locale from a cookie. SSR-safe.
+ * Returns null if the cookie is not set or not in a browser environment.
+ */
+declare function getLocale(cookieKey: string): string | null;
+/**
+ * Write the locale to a cookie. SSR-safe (no-op on server).
+ */
+declare function setLocale(cookieKey: string, locale: string): void;
+export { DocyrusI18nConfig, I18nManager, type I18nStateListener, I18nStatus, TranslationDictionary, getLocale, interpolate, setLocale };

package/dist/core-index.js ADDED Viewed

@@ -0,0 +1,246 @@
+// src/core/interpolation.ts
+function interpolate(template, params) {
+  if (!params) return template;
+  return template.replace(
+    /\{\{(\w+)\}\}|\{(\w+)\}/g,
+    (match, doubleBraceKey, singleBraceKey) => {
+      const key = doubleBraceKey ?? singleBraceKey;
+      if (key === void 0) return match;
+      const value = params[key];
+      return value !== void 0 ? String(value) : match;
+    }
+  );
+}
+// src/core/locale-storage.ts
+var DEFAULT_MAX_AGE = 365 * 24 * 60 * 60;
+function getLocale(cookieKey) {
+  if (typeof document === "undefined") return null;
+  const match = document.cookie.match(new RegExp(`(?:^|;\\s*)${escapeRegex(cookieKey)}=([^;]*)`));
+  return match ? decodeURIComponent(match[1]) : null;
+}
+function setLocale(cookieKey, locale) {
+  if (typeof document === "undefined") return;
+  document.cookie = `${cookieKey}=${encodeURIComponent(locale)};path=/;max-age=${DEFAULT_MAX_AGE};SameSite=Lax`;
+}
+function escapeRegex(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+// src/core/i18n-manager.ts
+var I18nManager = class {
+  status = "loading";
+  locale;
+  translations = {};
+  apiTranslations = {};
+  error = null;
+  listeners = /* @__PURE__ */ new Set();
+  abortController = null;
+  client;
+  getAccessToken;
+  apiUrl;
+  translationsEndpoint;
+  staticTranslations;
+  cookieKey;
+  mergeStrategy;
+  fallback;
+  disableApiFetch;
+  userLanguageEndpoint;
+  constructor(config) {
+    this.client = config.client ?? null;
+    this.getAccessToken = config.getAccessToken;
+    this.apiUrl = config.apiUrl;
+    this.translationsEndpoint = config.translationsEndpoint ?? "tenant/translations";
+    this.staticTranslations = config.staticTranslations ?? {};
+    this.cookieKey = config.cookieKey ?? "docyrus-locale";
+    this.mergeStrategy = config.mergeStrategy ?? "api-first";
+    this.fallback = config.fallback ?? "key";
+    this.disableApiFetch = config.disableApiFetch ?? false;
+    this.userLanguageEndpoint = config.userLanguageEndpoint ?? "users/me";
+    this.locale = getLocale(this.cookieKey);
+  }
+  getStatus() {
+    return this.status;
+  }
+  getLocale() {
+    return this.locale;
+  }
+  getTranslations() {
+    return this.translations;
+  }
+  getError() {
+    return this.error;
+  }
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => this.listeners.delete(listener);
+  }
+  notify() {
+    for (const listener of this.listeners) {
+      listener({
+        status: this.status,
+        locale: this.locale,
+        translations: this.translations,
+        error: this.error
+      });
+    }
+  }
+  /**
+   * Initialize the manager.
+   * 1. Apply static translations immediately (no loading flash).
+   * 2. Fetch from API if enabled and auth is available.
+   */
+  async initialize() {
+    if (Object.keys(this.staticTranslations).length > 0) {
+      this.translations = { ...this.staticTranslations };
+      this.status = "ready";
+      this.notify();
+    }
+    if (!this.disableApiFetch && (this.client || this.getAccessToken)) {
+      await this.fetchTranslations();
+    } else if (this.status !== "ready") {
+      this.status = "ready";
+      this.notify();
+    }
+  }
+  /**
+   * Fetch translations from the API.
+   * Uses RestApiClient.get() if client is available, otherwise raw fetch with getAccessToken.
+   */
+  async fetchTranslations() {
+    this.abortController?.abort();
+    this.abortController = new AbortController();
+    try {
+      let apiData;
+      if (this.client) {
+        apiData = await this.client.get(
+          this.translationsEndpoint
+        );
+      } else if (this.getAccessToken && this.apiUrl) {
+        const token = await this.getAccessToken();
+        if (!token) {
+          throw new Error("getAccessToken returned null \u2014 cannot fetch translations");
+        }
+        const url = `${this.apiUrl.replace(/\/$/, "")}/${this.translationsEndpoint}`;
+        const res = await fetch(url, {
+          headers: { Authorization: `Bearer ${token}` },
+          signal: this.abortController.signal
+        });
+        if (!res.ok) {
+          throw new Error(`Translation fetch failed: ${res.status} ${res.statusText}`);
+        }
+        apiData = await res.json();
+      } else {
+        return;
+      }
+      this.apiTranslations = apiData.data;
+      this.mergeTranslations();
+      this.error = null;
+      this.status = "ready";
+      this.notify();
+    } catch (err) {
+      if (err.name === "AbortError") return;
+      this.error = err instanceof Error ? err : new Error(String(err));
+      if (Object.keys(this.translations).length > 0) {
+        this.notify();
+      } else {
+        this.status = "error";
+        this.notify();
+      }
+    }
+  }
+  /**
+   * Translate a key with optional interpolation.
+   * Falls back based on the configured strategy.
+   */
+  t(key, params) {
+    const value = this.translations[key];
+    if (value !== void 0) {
+      return interpolate(value, params);
+    }
+    if (this.fallback === "key") return key;
+    if (this.fallback === "empty") return "";
+    return this.fallback(key);
+  }
+  /**
+   * Change the active locale.
+   * Writes to cookie, persists to API (PATCH users/me), and triggers translation refetch.
+   */
+  async setLocale(locale) {
+    if (locale === this.locale) return;
+    this.locale = locale;
+    setLocale(this.cookieKey, locale);
+    this.notify();
+    const promises = [];
+    if (this.userLanguageEndpoint !== false && (this.client || this.getAccessToken)) {
+      promises.push(this.persistUserLanguage(locale));
+    }
+    if (!this.disableApiFetch && (this.client || this.getAccessToken)) {
+      promises.push(this.fetchTranslations());
+    }
+    await Promise.all(promises);
+  }
+  /**
+   * Persist user language preference to API.
+   * PATCH {userLanguageEndpoint} { language: locale }
+   */
+  async persistUserLanguage(locale) {
+    if (this.userLanguageEndpoint === false) return;
+    try {
+      if (this.client) {
+        await this.client.patch(this.userLanguageEndpoint, { language: locale });
+      } else if (this.getAccessToken && this.apiUrl) {
+        const token = await this.getAccessToken();
+        if (!token) return;
+        const url = `${this.apiUrl.replace(/\/$/, "")}/${this.userLanguageEndpoint}`;
+        await fetch(url, {
+          method: "PATCH",
+          headers: {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify({ language: locale })
+        });
+      }
+    } catch {
+    }
+  }
+  /**
+   * Update config at runtime.
+   * Useful when client transitions from null → RestApiClient (auth loading complete).
+   */
+  updateConfig(updates) {
+    let shouldFetch = false;
+    if (updates.client !== void 0 && updates.client !== this.client) {
+      const hadNoClient = !this.client;
+      this.client = updates.client;
+      if (hadNoClient && this.client && !this.disableApiFetch) {
+        shouldFetch = true;
+      }
+    }
+    if (updates.staticTranslations !== void 0) {
+      this.staticTranslations = updates.staticTranslations;
+      this.mergeTranslations();
+      this.notify();
+    }
+    if (shouldFetch) {
+      this.fetchTranslations();
+    }
+  }
+  /** Cleanup: abort in-flight requests + clear listeners. */
+  destroy() {
+    this.abortController?.abort();
+    this.listeners.clear();
+  }
+  mergeTranslations() {
+    if (this.mergeStrategy === "api-first") {
+      this.translations = { ...this.staticTranslations, ...this.apiTranslations };
+    } else {
+      this.translations = { ...this.apiTranslations, ...this.staticTranslations };
+    }
+  }
+};
+export { I18nManager, getLocale, interpolate, setLocale };
+//# sourceMappingURL=core-index.js.map
+//# sourceMappingURL=core-index.js.map

package/dist/core-index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../src/core/interpolation.ts","../src/core/locale-storage.ts","../src/core/i18n-manager.ts"],"names":[],"mappings":"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","file":"core-index.js","sourcesContent":["/**\n * Interpolate placeholders in a translation string.\n *\n * Supports three formats (checked in order):\n * 1. {{variable}} — double-brace (static translations convention)\n * 2. {variable} — single-brace named (API convention: \"Talk to {name} AI\")\n * 3. {0}, {1} — single-brace positional (API convention: \"Add New {0}\")\n *\n * Positional placeholders use numeric keys: params = { '0': 'User' }\n *\n * Examples:\n * interpolate('Hello, {{name}}!', { name: 'Ali' }) → 'Hello, Ali!'\n * interpolate('Talk to {name} AI', { name: 'Docyrus' }) → 'Talk to Docyrus AI'\n * interpolate('Add New {0}', { '0': 'User' }) → 'Add New User'\n */\nexport function interpolate(\n template: string,\n params?: Record<string, string | number>\n): string {\n if (!params) return template;\n\n // Match both {{key}} and {key} — double-brace first, then single-brace\n return template.replace(\n /\\{\\{(\\w+)\\}\\}|\\{(\\w+)\\}/g,\n (match, doubleBraceKey: string | undefined, singleBraceKey: string | undefined) => {\n const key = doubleBraceKey ?? singleBraceKey;\n\n if (key === undefined) return match;\n\n const value = params[key];\n\n return value !== undefined ? String(value) : match;\n }\n );\n}\n","const DEFAULT_MAX_AGE = 365 * 24 * 60 * 60; // 1 year in seconds\n\n/**\n * Read the locale from a cookie. SSR-safe.\n * Returns null if the cookie is not set or not in a browser environment.\n */\nexport function getLocale(cookieKey: string): string | null {\n if (typeof document === 'undefined') return null;\n\n const match = document.cookie.match(new RegExp(`(?:^|;\\\\s*)${escapeRegex(cookieKey)}=([^;]*)`));\n\n return match ? decodeURIComponent(match[1]) : null;\n}\n\n/**\n * Write the locale to a cookie. SSR-safe (no-op on server).\n */\nexport function setLocale(cookieKey: string, locale: string): void {\n if (typeof document === 'undefined') return;\n\n document.cookie = `${cookieKey}=${encodeURIComponent(locale)};path=/;max-age=${DEFAULT_MAX_AGE};SameSite=Lax`;\n}\n\nfunction escapeRegex(str: string): string {\n return str.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n","import { type RestApiClient } from '@docyrus/api-client';\n\nimport {\n type DocyrusI18nConfig,\n type FallbackStrategy,\n type I18nStatus,\n type TranslationDictionary,\n type TranslationsResponse\n} from '../types';\n\nimport { interpolate } from './interpolation';\nimport { getLocale, setLocale as writeLocaleCookie } from './locale-storage';\n\nexport type I18nStateListener = (state: {\n status: I18nStatus;\n locale: string | null;\n translations: TranslationDictionary;\n error: Error | null;\n}) => void;\n\n/**\n * Framework-agnostic translation engine.\n *\n * Manages locale persistence (cookie), translation fetching (API + static merge),\n * and provides the `t()` function for translation lookup with interpolation.\n *\n * Pattern follows AuthManager from @docyrus/app-auth-ui.\n */\nexport class I18nManager {\n private status: I18nStatus = 'loading';\n private locale: string | null;\n private translations: TranslationDictionary = {};\n private apiTranslations: TranslationDictionary = {};\n private error: Error | null = null;\n private listeners: Set<I18nStateListener> = new Set();\n private abortController: AbortController | null = null;\n private client: RestApiClient | null;\n private getAccessToken: (() => Promise<string | null> | string | null) | undefined;\n private apiUrl: string | undefined;\n private translationsEndpoint: string;\n private staticTranslations: TranslationDictionary;\n private cookieKey: string;\n private mergeStrategy: 'api-first' | 'static-first';\n private fallback: FallbackStrategy;\n private disableApiFetch: boolean;\n private userLanguageEndpoint: string | false;\n constructor(config: DocyrusI18nConfig) {\n this.client = config.client ?? null;\n this.getAccessToken = config.getAccessToken;\n this.apiUrl = config.apiUrl;\n this.translationsEndpoint = config.translationsEndpoint ?? 'tenant/translations';\n this.staticTranslations = config.staticTranslations ?? {};\n this.cookieKey = config.cookieKey ?? 'docyrus-locale';\n this.mergeStrategy = config.mergeStrategy ?? 'api-first';\n this.fallback = config.fallback ?? 'key';\n this.disableApiFetch = config.disableApiFetch ?? false;\n this.userLanguageEndpoint = config.userLanguageEndpoint ?? 'users/me';\n\n // Read locale from cookie (null if not set — API resolves from user profile)\n this.locale = getLocale(this.cookieKey);\n }\n getStatus(): I18nStatus {\n return this.status;\n }\n getLocale(): string | null {\n return this.locale;\n }\n getTranslations(): TranslationDictionary {\n return this.translations;\n }\n getError(): Error | null {\n return this.error;\n }\n subscribe(listener: I18nStateListener): () => void {\n this.listeners.add(listener);\n\n return () => this.listeners.delete(listener);\n }\n private notify(): void {\n for (const listener of this.listeners) {\n listener({\n status: this.status,\n locale: this.locale,\n translations: this.translations,\n error: this.error\n });\n }\n }\n /**\n * Initialize the manager.\n * 1. Apply static translations immediately (no loading flash).\n * 2. Fetch from API if enabled and auth is available.\n */\n async initialize(): Promise<void> {\n // Apply static translations immediately\n if (Object.keys(this.staticTranslations).length > 0) {\n this.translations = { ...this.staticTranslations };\n this.status = 'ready';\n this.notify();\n }\n\n // Fetch from API\n if (!this.disableApiFetch && (this.client || this.getAccessToken)) {\n await this.fetchTranslations();\n } else if (this.status !== 'ready') {\n // No static translations and no API fetch — mark ready with empty translations\n this.status = 'ready';\n this.notify();\n }\n }\n /**\n * Fetch translations from the API.\n * Uses RestApiClient.get() if client is available, otherwise raw fetch with getAccessToken.\n */\n async fetchTranslations(): Promise<void> {\n // Abort any in-flight request\n this.abortController?.abort();\n this.abortController = new AbortController();\n\n try {\n let apiData: TranslationsResponse;\n\n if (this.client) {\n apiData = await this.client.get<TranslationsResponse>(\n this.translationsEndpoint\n );\n } else if (this.getAccessToken && this.apiUrl) {\n const token = await this.getAccessToken();\n\n if (!token) {\n throw new Error('getAccessToken returned null — cannot fetch translations');\n }\n\n const url = `${this.apiUrl.replace(/\\/$/, '')}/${this.translationsEndpoint}`;\n const res = await fetch(url, {\n headers: { Authorization: `Bearer ${token}` },\n signal: this.abortController.signal\n });\n\n if (!res.ok) {\n throw new Error(`Translation fetch failed: ${res.status} ${res.statusText}`);\n }\n\n apiData = await res.json() as TranslationsResponse;\n } else {\n // No auth available yet — skip silently\n return;\n }\n\n this.apiTranslations = apiData.data;\n this.mergeTranslations();\n this.error = null;\n this.status = 'ready';\n this.notify();\n } catch (err) {\n if ((err as Error).name === 'AbortError') return;\n\n this.error = err instanceof Error ? err : new Error(String(err));\n\n // If we already have static translations, stay 'ready' with error\n if (Object.keys(this.translations).length > 0) {\n this.notify();\n } else {\n this.status = 'error';\n this.notify();\n }\n }\n }\n /**\n * Translate a key with optional interpolation.\n * Falls back based on the configured strategy.\n */\n t(key: string, params?: Record<string, string | number>): string {\n const value = this.translations[key];\n\n if (value !== undefined) {\n return interpolate(value, params);\n }\n\n // Fallback\n if (this.fallback === 'key') return key;\n if (this.fallback === 'empty') return '';\n\n return this.fallback(key);\n }\n /**\n * Change the active locale.\n * Writes to cookie, persists to API (PATCH users/me), and triggers translation refetch.\n */\n async setLocale(locale: string): Promise<void> {\n if (locale === this.locale) return;\n\n this.locale = locale;\n writeLocaleCookie(this.cookieKey, locale);\n this.notify();\n\n // Persist language preference to API + refetch translations in parallel\n const promises: Promise<void>[] = [];\n\n if (this.userLanguageEndpoint !== false && (this.client || this.getAccessToken)) {\n promises.push(this.persistUserLanguage(locale));\n }\n\n if (!this.disableApiFetch && (this.client || this.getAccessToken)) {\n promises.push(this.fetchTranslations());\n }\n\n await Promise.all(promises);\n }\n /**\n * Persist user language preference to API.\n * PATCH {userLanguageEndpoint} { language: locale }\n */\n private async persistUserLanguage(locale: string): Promise<void> {\n if (this.userLanguageEndpoint === false) return;\n\n try {\n if (this.client) {\n await this.client.patch(this.userLanguageEndpoint, { language: locale });\n } else if (this.getAccessToken && this.apiUrl) {\n const token = await this.getAccessToken();\n\n if (!token) return;\n\n const url = `${this.apiUrl.replace(/\\/$/, '')}/${this.userLanguageEndpoint}`;\n\n await fetch(url, {\n method: 'PATCH',\n headers: {\n Authorization: `Bearer ${token}`,\n 'Content-Type': 'application/json'\n },\n body: JSON.stringify({ language: locale })\n });\n }\n } catch {\n // Language persist is best-effort — don't block locale switch on failure\n }\n }\n /**\n * Update config at runtime.\n * Useful when client transitions from null → RestApiClient (auth loading complete).\n */\n updateConfig(updates: Partial<Pick<DocyrusI18nConfig, 'client' | 'staticTranslations'>>): void {\n let shouldFetch = false;\n\n if (updates.client !== undefined && updates.client !== this.client) {\n const hadNoClient = !this.client;\n\n this.client = updates.client;\n\n // Client became available — fetch translations\n if (hadNoClient && this.client && !this.disableApiFetch) {\n shouldFetch = true;\n }\n }\n\n if (updates.staticTranslations !== undefined) {\n this.staticTranslations = updates.staticTranslations;\n this.mergeTranslations();\n this.notify();\n }\n\n if (shouldFetch) {\n this.fetchTranslations();\n }\n }\n /** Cleanup: abort in-flight requests + clear listeners. */\n destroy(): void {\n this.abortController?.abort();\n this.listeners.clear();\n }\n private mergeTranslations(): void {\n if (this.mergeStrategy === 'api-first') {\n this.translations = { ...this.staticTranslations, ...this.apiTranslations };\n } else {\n this.translations = { ...this.apiTranslations, ...this.staticTranslations };\n }\n }\n}\n"]}