@verbumia/react-i18next 0.7.0 → 0.8.0

package/README.md

@@ -63,7 +63,8 @@ interface VerbumiaConfig {
   defaultLocale: string;          // BCP-47 (e.g. "fr", "fr-CA")
   fallbackLng?: string;           // resolved before reporting a key as missing
   namespaces?: string[];          // default ['common']
-  apiBase?: string;               // default 'https://api.verbumia.ca'
+  defaultNS?: string;             // alias: default namespace for single-ns apps
+  apiBase?: string;               // default 'https://api.verbumia.dev'
   cdnBase?: string;               // default 'https://cdn.verbumia.ca'
   transport?: (batch: MissingKeyEvent[]) => void | Promise<void>;
   missingHandler?: 'send' | 'log' | 'off';   // default 'send'
@@ -78,15 +79,20 @@ interface VerbumiaConfig {
 Returns `{ t, i18n }`.
 
 ```ts
-type TranslationFunction = (
-  key: string,                                  // "ns:key.path" or "key.path"
-  options?: Record<string, unknown> & { defaultValue?: string }
-) => string;
+// Two call shapes — the native object form AND the react-i18next-style
+// positional fallback (a string 2nd arg is the default value):
+type TranslationFunction = {
+  (key: string, defaultValue: string, options?: Record<string, unknown>): string;
+  (key: string, options?: Record<string, unknown> & { defaultValue?: string }): string;
+};
 
 interface I18nInstance {
   ready: boolean;
   locale: string;
+  language: string;                             // alias of `locale`
   setLocale(next: string): Promise<void>;
+  changeLanguage(next: string): Promise<void>;  // alias of `setLocale`
+  t: TranslationFunction;                       // for out-of-React use via getI18n()
   missingEvents: MissingKeyEvent[];             // newest first, capped buffer
   flushMissing(): Promise<void>;                // force-flush the pending batch
 }
@@ -110,6 +116,41 @@ and the SDK swaps the elements at render time.
 
 ---
 
+## Migrating from react-i18next
+
+`@verbumia/react-i18next` is built to be a near drop-in for react-i18next, so
+existing codebases migrate with minimal changes:
+
+- **Positional default value** — `t('key', 'Default text')` works (so does
+  `t('key', 'Hi {{name}}', { name })`), alongside the native
+  `t('key', { defaultValue })`. No codemod needed for inline fallbacks.
+- **`changeLanguage` / `language`** — `i18n.changeLanguage('en')` (alias of
+  `setLocale`) and the `i18n.language` getter (alias of `locale`) are available.
+- **Out-of-React access** — `getI18n()` returns the active instance for use in
+  plain modules, stores, or helpers (the react-i18next standalone-singleton
+  pattern):
+
+  ```ts
+  import { getI18n } from "@verbumia/react-i18next";
+  // anywhere after <VerbumiaProvider> has mounted:
+  const label = getI18n().t("nav.home", "Home");
+  await getI18n().changeLanguage("en");
+  ```
+
+  `getI18n()` throws a clear error if no provider is mounted yet, and assumes a
+  single app-wide provider.
+- **Default namespace** — the default is `['common']` (not react-i18next's
+  `'translation'`). Migrants pass `namespaces={['translation']}`, or the
+  `defaultNS="translation"` alias for single-namespace apps.
+
+### Not yet supported (planned for V1.1)
+
+Plurals and context are **not** resolved yet: `t('key', { count })` performs
+interpolation only — it does **not** select plural keys (`key_one` /
+`key_other`) or context keys (`key_male`). Handle these manually until V1.1.
+
+---
+
 ## Missing-key flow
 
 1. The user navigates a page that calls `t("hello.title")`.

package/dist/index.cjs

@@ -23,6 +23,7 @@ __export(index_exports, {
   Trans: () => Trans,
   VerbumiaProvider: () => VerbumiaProvider,
   defaultTransport: () => defaultTransport,
+  getI18n: () => getI18n,
   keyRegistry: () => keyRegistry,
   logTransport: () => logTransport,
   useTranslation: () => useTranslation
@@ -252,7 +253,7 @@ var KeyRegistry = class {
 var keyRegistry = new KeyRegistry();
 
 // src/i18n.ts
-var DEFAULT_API_BASE = "https://api.verbumia.ca";
+var DEFAULT_API_BASE = "https://api.verbumia.dev";
 var DEFAULT_CDN_BASE = "https://cdn.verbumia.ca";
 var DEFAULT_FLUSH_MS = 5e3;
 var DEFAULT_BATCH = 50;
@@ -349,7 +350,7 @@ var VerbumiaI18n = class {
       missingHandler: config.missingHandler ?? "send",
       token: config.token,
       projectUuid: config.projectUuid,
-      namespaces: config.namespaces?.length ? config.namespaces : ["common"],
+      namespaces: config.namespaces?.length ? config.namespaces : config.defaultNS ? [config.defaultNS] : ["common"],
       flushIntervalMs: config.flushIntervalMs ?? DEFAULT_FLUSH_MS,
       flushBatchSize: config.flushBatchSize ?? DEFAULT_BATCH,
       missingEventsBufferSize: config.missingEventsBufferSize ?? DEFAULT_BUFFER,
@@ -378,7 +379,10 @@ var VerbumiaI18n = class {
     return {
       ready: this.ready,
       locale: this.locale,
+      language: this.locale,
       setLocale: this.setLocale,
+      changeLanguage: this.changeLanguage,
+      t: this.t,
       missingEvents: this.missingEvents,
       flushMissing: this.flushMissing
     };
@@ -421,6 +425,12 @@ var VerbumiaI18n = class {
     this.ready = true;
     this._notify();
   };
+  /** Alias of {@link setLocale} for react-i18next compatibility. */
+  changeLanguage = (next) => this.setLocale(next);
+  /** Alias of {@link locale} for react-i18next compatibility. */
+  get language() {
+    return this.locale;
+  }
   stop() {
     keyRegistry.detach();
     if (this._timer) {
@@ -502,7 +512,8 @@ var VerbumiaI18n = class {
     });
   }
   // ---- Translation ----
-  t = (key, options) => {
+  t = (key, optionsOrDefault, maybeOptions) => {
+    const options = typeof optionsOrDefault === "string" ? { ...maybeOptions ?? {}, defaultValue: optionsOrDefault } : optionsOrDefault;
     const namespace = this._splitNamespace(key);
     const bareKey = namespace.bareKey;
     const ns = namespace.ns;
@@ -657,6 +668,23 @@ var VerbumiaI18n = class {
   }
 };
 
+// src/singleton.ts
+var _active = null;
+function _setActiveInstance(instance) {
+  _active = instance;
+}
+function _clearActiveInstance(instance) {
+  if (_active === instance) _active = null;
+}
+function getI18n() {
+  if (!_active) {
+    throw new Error(
+      "@verbumia/react-i18next: getI18n() was called before <VerbumiaProvider> mounted (no active i18n instance)."
+    );
+  }
+  return _active;
+}
+
 // src/provider.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
 var VerbumiaContext = (0, import_react.createContext)(null);
@@ -666,11 +694,13 @@ function VerbumiaProvider({
 }) {
   const i18n = (0, import_react.useMemo)(() => new VerbumiaI18n(config), []);
   (0, import_react.useEffect)(() => {
+    _setActiveInstance(i18n);
     void i18n.start();
     const teardowns = (config.plugins ?? []).map((p) => p.setup?.({ i18n, config })).filter((t) => typeof t === "function");
     return () => {
       teardowns.forEach((t) => t());
       i18n.stop();
+      _clearActiveInstance(i18n);
     };
   }, [i18n]);
   const value = (0, import_react.useMemo)(() => ({ i18n }), [i18n]);
@@ -702,13 +732,14 @@ function useTranslation(defaultNamespace) {
   renderedRef.current = /* @__PURE__ */ new Set();
   const tokenRef = (0, import_react2.useRef)(/* @__PURE__ */ Symbol("verbumia.t"));
   const t = (0, import_react2.useMemo)(() => {
-    return (key, options) => {
+    const fn = (key, optionsOrDefault, maybeOptions) => {
       const fullKey = defaultNamespace && !key.includes(":") ? `${defaultNamespace}:${key}` : key;
       renderedRef.current.add(
         keyRegistry.encode(fullKey, i18n.defaultNamespace)
       );
-      return i18n.t(fullKey, options);
+      return i18n.t(fullKey, optionsOrDefault, maybeOptions);
     };
+    return fn;
   }, [i18n, defaultNamespace]);
   (0, import_react2.useEffect)(() => {
     keyRegistry._set(tokenRef.current, renderedRef.current);
@@ -764,6 +795,7 @@ function splitOnComponents(text, components) {
   Trans,
   VerbumiaProvider,
   defaultTransport,
+  getI18n,
   keyRegistry,
   logTransport,
   useTranslation

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/provider.tsx","../src/transport.ts","../src/live.ts","../src/key-registry.ts","../src/i18n.ts","../src/hooks.ts","../src/trans.tsx"],"sourcesContent":["export { VerbumiaProvider } from \"./provider\";\nexport { useTranslation } from \"./hooks\";\nexport { Trans } from \"./trans\";\nexport type {\n  I18nInstance,\n  Locale,\n  MissingHandlerMode,\n  MissingKeyEvent,\n  Namespace,\n  TranslationFunction,\n  TranslationOptions,\n  Transport,\n  VerbumiaConfig,\n  VerbumiaPlugin,\n  VerbumiaPluginContext,\n} from \"./types\";\nexport { defaultTransport, logTransport } from \"./transport\";\n/** Advanced: the on-screen key registry feeding `@verbumia/feedback`.\n *  Mount-tracking handles navigation automatically; `reset()` is only\n *  needed for non-React routing edge cases. */\nexport { keyRegistry } from \"./key-registry\";\nexport type { DeclaredKey } from \"./key-registry\";\n","import {\n  createContext,\n  Fragment,\n  useContext,\n  useEffect,\n  useMemo,\n  useSyncExternalStore,\n  type ReactNode,\n} from \"react\";\nimport { VerbumiaI18n } from \"./i18n\";\nimport type { I18nInstance, VerbumiaConfig } from \"./types\";\n\ninterface VerbumiaContextValue {\n  i18n: VerbumiaI18n;\n}\n\nconst VerbumiaContext = createContext<VerbumiaContextValue | null>(null);\n\nexport interface VerbumiaProviderProps extends VerbumiaConfig {\n  children: ReactNode;\n}\n\nexport function VerbumiaProvider({\n  children,\n  ...config\n}: VerbumiaProviderProps) {\n  // Stable instance for the lifetime of the provider mount.\n  const i18n = useMemo(() => new VerbumiaI18n(config), []); // eslint-disable-line react-hooks/exhaustive-deps\n\n  useEffect(() => {\n    void i18n.start();\n    // Plugins (e.g. @verbumia/feedback) hook the SAME i18n instance —\n    // no second context. setup() runs once; optional teardown on unmount.\n    const teardowns = (config.plugins ?? [])\n      .map((p) => p.setup?.({ i18n, config }))\n      .filter((t): t is () => void => typeof t === \"function\");\n    return () => {\n      teardowns.forEach((t) => t());\n      i18n.stop();\n    };\n  }, [i18n]); // eslint-disable-line react-hooks/exhaustive-deps\n\n  const value = useMemo<VerbumiaContextValue>(() => ({ i18n }), [i18n]);\n  return (\n    <VerbumiaContext.Provider value={value}>\n      {children}\n      {/* Plugin outlets: isolated sibling leaves AFTER children. Their\n          internal state never propagates to the host app subtree. */}\n      {(config.plugins ?? []).map((p) =>\n        p.render ? <Fragment key={p.name}>{p.render()}</Fragment> : null,\n      )}\n    </VerbumiaContext.Provider>\n  );\n}\n\n/** Internal — used by useTranslation + Trans. */\nexport function useI18n(): VerbumiaI18n {\n  const ctx = useContext(VerbumiaContext);\n  if (!ctx) {\n    throw new Error(\"useTranslation/Trans must be used inside <VerbumiaProvider>\");\n  }\n  return ctx.i18n;\n}\n\n/** Subscribes to the i18n store and returns a snapshot the React tree can render.\n *\n * `getSnapshot` MUST return a stable reference between notifications,\n * otherwise React loops forever (Maximum update depth exceeded). The\n * VerbumiaI18n instance caches its snapshot internally — see\n * `_notify` / `_buildSnapshot`. */\nexport function useI18nSnapshot(): I18nInstance {\n  const i18n = useI18n();\n  return useSyncExternalStore(i18n.subscribe, i18n.getSnapshot, i18n.getSnapshot);\n}\n","import type { MissingKeyEvent, Transport } from \"./types\";\n\nconst SDK_LIB = \"@verbumia/react-i18next\";\nconst SDK_VER = \"0.5.2\";\n\n/** Default transport: POST to `${apiBase}/v1/missing` with the API key. */\nexport function defaultTransport(opts: {\n  apiBase: string;\n  token: string;\n  projectUuid: string;\n}): Transport {\n  return async (batch) => {\n    if (!batch.length) return;\n    const body = {\n      project_uuid: opts.projectUuid,\n      events: batch.map((e) => ({\n        key: e.key,\n        namespace: e.namespace,\n        language_code: e.language_code,\n        source_value: e.source_value,\n        sdk_meta: {\n          lib: SDK_LIB,\n          ver: SDK_VER,\n          ...(typeof window !== \"undefined\"\n            ? { url: window.location?.href }\n            : {}),\n          ...(e.sdk_meta ?? {}),\n        },\n      })),\n    };\n    try {\n      await fetch(`${opts.apiBase.replace(/\\/+$/, \"\")}/v1/missing`, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          Authorization: `ApiKey ${opts.token}`,\n        },\n        body: JSON.stringify(body),\n        // SDKs are best-effort; never block the render path\n        keepalive: true,\n      });\n    } catch {\n      // swallow — missing-key reporting must never break the host app\n    }\n  };\n}\n\n/** Logs each event to console.warn — handy for dev. */\nexport const logTransport: Transport = (batch: MissingKeyEvent[]) => {\n  for (const e of batch) {\n    // eslint-disable-next-line no-console\n    console.warn(\"[verbumia] missing key\", e);\n  }\n};\n","/**\n * Tiny Centrifugo WebSocket client tailored to the Verbumia\n * `translations:` channel. Hand-rolled (no `centrifuge-js` dep) so the SDK\n * stays under 15 KB gzipped — we only need: connect, subscribe, listen.\n *\n * Wire format reference:\n *   https://centrifugal.dev/docs/transports/websocket\n *\n * Lifecycle:\n *   - call connect() with a valid token\n *   - server replies with {push|reply}; we wait for the connect ack\n *   - subscribe(channel) — send subscribe command, wait for ack\n *   - subsequent {push, channel, pub.data} are routed to onMessage\n *   - reconnect with exponential backoff (capped at 30s) on close\n */\n\nexport interface LiveClientConfig {\n  url: string;\n  token: string;\n  channel: string;\n  onMessage: (data: unknown) => void;\n  onStatus?: (status: \"connecting\" | \"connected\" | \"disconnected\") => void;\n  /**\n   * Hook called just before each connect attempt — return a fresh token\n   * (used to refresh a token whose `exp` is close). Defaults to the\n   * static one passed in `token`.\n   */\n  refreshToken?: () => Promise<string>;\n}\n\nexport class LiveClient {\n  private _ws: WebSocket | null = null;\n  private _id = 0;\n  private _backoffMs = 1_000;\n  private _disposed = false;\n  private _connectAcked = false;\n\n  constructor(private readonly cfg: LiveClientConfig) {}\n\n  /** Open the socket and try to subscribe. Idempotent — calling twice is a no-op. */\n  async connect(): Promise<void> {\n    if (this._ws) return;\n    if (this._disposed) return;\n    this.cfg.onStatus?.(\"connecting\");\n    const token = this.cfg.refreshToken ? await this.cfg.refreshToken() : this.cfg.token;\n    // Centrifugo's WebSocket endpoint lives at `/connection/websocket`.\n    // Be forgiving on the input — accept either a bare host\n    // (`wss://centrifugo.example`) or the full path.\n    let url = this.cfg.url;\n    if (!url.includes(\"/connection/websocket\")) {\n      url = url.replace(/\\/+$/, \"\") + \"/connection/websocket\";\n    }\n    const ws = new WebSocket(url);\n    this._ws = ws;\n    this._connectAcked = false;\n\n    ws.onopen = () => {\n      // Centrifugo command: connect with token\n      this._send({ id: ++this._id, connect: { token } });\n    };\n    ws.onmessage = (evt) => this._onFrame(evt.data);\n    ws.onclose = () => this._onClose();\n    ws.onerror = () => {\n      // Let onclose handle the reconnect.\n    };\n  }\n\n  dispose(): void {\n    this._disposed = true;\n    if (this._ws) {\n      try {\n        this._ws.close();\n      } catch {\n        // ignore\n      }\n      this._ws = null;\n    }\n    this.cfg.onStatus?.(\"disconnected\");\n  }\n\n  // ---- internals ----\n\n  private _send(msg: unknown): void {\n    if (!this._ws || this._ws.readyState !== WebSocket.OPEN) return;\n    try {\n      this._ws.send(JSON.stringify(msg));\n    } catch {\n      // ignore — onclose will fire shortly\n    }\n  }\n\n  private _onFrame(raw: unknown): void {\n    let parsed: {\n      id?: number;\n      connect?: { client?: string };\n      subscribe?: unknown;\n      push?: { channel?: string; pub?: { data?: unknown }; sub?: unknown };\n    } | undefined;\n    try {\n      parsed = JSON.parse(raw as string);\n    } catch {\n      return;\n    }\n    if (!parsed || typeof parsed !== \"object\") return;\n    // Centrifugo v2 protocol pings: server periodically sends an empty\n    // object `{}`. Client MUST reply with an empty `{}` to keep the\n    // connection alive — without this the server force-closes after\n    // ~25-30s and we lose pushes silently.\n    if (Object.keys(parsed).length === 0) {\n      this._send({});\n      return;\n    }\n    if (parsed.connect && !this._connectAcked) {\n      this._connectAcked = true;\n      this.cfg.onStatus?.(\"connected\");\n      this._backoffMs = 1_000;\n      // Connection token's `channels` claim auto-subscribes us server-side,\n      // so an explicit subscribe command is unnecessary. We still send it\n      // for back-compat with anonymous-channel deployments where no\n      // server-side subscription was created.\n      this._send({\n        id: ++this._id,\n        subscribe: { channel: this.cfg.channel },\n      });\n      return;\n    }\n    const push = parsed.push;\n    if (push && push.channel === this.cfg.channel && push.pub) {\n      this.cfg.onMessage(push.pub.data);\n    }\n  }\n\n  private _onClose(): void {\n    this._ws = null;\n    this._connectAcked = false;\n    this.cfg.onStatus?.(\"disconnected\");\n    if (this._disposed) return;\n    const delay = this._backoffMs;\n    this._backoffMs = Math.min(this._backoffMs * 2, 30_000);\n    setTimeout(() => {\n      if (!this._disposed) void this.connect();\n    }, delay);\n  }\n}\n\n/**\n * Fetch a fresh Centrifugo connection token from the backend. The\n * endpoint signature matches `POST /v1/auth/centrifugo-token` —\n * `{project_uuid}` body, `{token, channel, ...}` response.\n */\nexport async function fetchCentrifugoToken(\n  endpoint: string,\n  projectUuid: string,\n  authToken: string,\n  fetchImpl: typeof fetch = fetch,\n): Promise<{ token: string; channel: string; expires_at: number }> {\n  const r = await fetchImpl(endpoint, {\n    method: \"POST\",\n    headers: {\n      \"Content-Type\": \"application/json\",\n      Authorization: `ApiKey ${authToken}`,\n    },\n    body: JSON.stringify({ project_uuid: projectUuid }),\n  });\n  if (!r.ok) {\n    throw new Error(`centrifugo-token endpoint ${r.status}: ${await r.text()}`);\n  }\n  return (await r.json()) as { token: string; channel: string; expires_at: number };\n}\n","/**\n * On-screen key registry — the PRODUCER side of the tiny cross-package\n * contract that `@verbumia/feedback` consumes via\n * `globalThis.__verbumia_key_registry__` (see `@verbumia/feedback`'s\n * `core/keys.ts`).\n *\n * Why this exists: the feedback widget must list only the translation\n * strings RENDERED on the current screen (spec ltm 373) — NOT every\n * project string. The widget can't know what's on screen; the i18n SDK\n * does, because it resolves the keys. So the SDK tracks the keys touched\n * by currently-MOUNTED `useTranslation`/`Trans` consumers and exposes\n * them through a minimal global. When a component unmounts (navigation),\n * its keys drop out automatically — so `snapshot()` is always exactly\n * \"what is on screen right now\". Explicit `keys` on the feedback plugin\n * stays a fallback for non-i18n strings; it is NOT \"pass everything\".\n *\n * The published shape is intentionally tiny so any framework port of the\n * i18n SDK can implement the same global without depending on feedback:\n *\n *   globalThis.__verbumia_key_registry__ = {\n *     snapshot(): { namespace: string; key: string }[];\n *     reset(): void;\n *   }\n */\n\nexport interface DeclaredKey {\n  namespace: string;\n  key: string;\n}\n\nconst GLOBAL = \"__verbumia_key_registry__\";\n// Internal id separator. NUL never appears in an i18next namespace or\n// key, so it round-trips even when a key itself contains ':'.\nconst SEP = \"\u0000\";\n\n/** Split an i18next-style `ns:key` (mirrors VerbumiaI18n._splitNamespace). */\nfunction split(fullKey: string, defaultNamespace: string): DeclaredKey {\n  const idx = fullKey.indexOf(\":\");\n  if (idx > 0) {\n    return { namespace: fullKey.slice(0, idx), key: fullKey.slice(idx + 1) };\n  }\n  return { namespace: defaultNamespace, key: fullKey };\n}\n\nclass KeyRegistry {\n  // One Set per mounted hook/Trans instance (keyed by an opaque token).\n  // The on-screen set is the UNION of all live instances' latest render.\n  private _instances = new Map<symbol, Set<string>>();\n  // Provider mounts that have published us onto globalThis. Ref-counted so\n  // a multi-provider tree (or fast unmount/remount in tests) never leaves\n  // a stale global or unpublishes while another provider is still live.\n  private _providers = 0;\n\n  /** Replace an instance's contributed key set (called every render). */\n  _set(token: symbol, keys: Set<string>): void {\n    this._instances.set(token, keys);\n  }\n\n  /** Drop an instance entirely (called on unmount). */\n  _delete(token: symbol): void {\n    this._instances.delete(token);\n  }\n\n  /** Keys rendered by currently-mounted consumers. Stable insertion order. */\n  snapshot(): DeclaredKey[] {\n    const seen = new Set<string>();\n    const out: DeclaredKey[] = [];\n    for (const set of this._instances.values()) {\n      for (const id of set) {\n        if (seen.has(id)) continue;\n        seen.add(id);\n        const c = id.indexOf(SEP);\n        out.push({ namespace: id.slice(0, c), key: id.slice(c + 1) });\n      }\n    }\n    return out;\n  }\n\n  /** Escape hatch (router integrations / tests). Mount-tracking already\n   *  handles navigation, so this is rarely needed. */\n  reset(): void {\n    this._instances.clear();\n  }\n\n  /** Encode a resolved key into the internal id used by `_set`. */\n  encode(fullKey: string, defaultNamespace: string): string {\n    const k = split(fullKey, defaultNamespace);\n    return `${k.namespace}${SEP}${k.key}`;\n  }\n\n  /** Provider mounted — publish the global (idempotent, ref-counted). */\n  attach(): void {\n    this._providers += 1;\n    if (this._providers === 1) {\n      (globalThis as Record<string, unknown>)[GLOBAL] = {\n        snapshot: () => this.snapshot(),\n        reset: () => this.reset(),\n      };\n    }\n  }\n\n  /** Provider unmounted — unpublish when the last one goes away. */\n  detach(): void {\n    this._providers = Math.max(0, this._providers - 1);\n    if (this._providers === 0) {\n      this._instances.clear();\n      const g = globalThis as Record<string, unknown>;\n      if (g[GLOBAL]) delete g[GLOBAL];\n    }\n  }\n}\n\n/** Process-wide singleton — there is exactly one on-screen registry. */\nexport const keyRegistry = new KeyRegistry();\n","import type {\n  I18nInstance,\n  Locale,\n  MissingKeyEvent,\n  Namespace,\n  Transport,\n  VerbumiaConfig,\n} from \"./types\";\nimport { defaultTransport, logTransport } from \"./transport\";\nimport { LiveClient, fetchCentrifugoToken } from \"./live\";\nimport { keyRegistry } from \"./key-registry\";\n\nconst DEFAULT_API_BASE = \"https://api.verbumia.ca\";\nconst DEFAULT_CDN_BASE = \"https://cdn.verbumia.ca\";\nconst DEFAULT_FLUSH_MS = 5_000;\nconst DEFAULT_BATCH = 50;\nconst DEFAULT_BUFFER = 200;\nconst DEFAULT_VERSION_SLUG = \"main\";\n\ntype Bundle = Record<string, unknown>;\ntype Listener = () => void;\n\ntype PluralForms = Record<string, string>;\ntype ResolvedValue = string | PluralForms;\n\n/**\n * Plural-form objects mirror the CLDR `Intl.PluralRules` categories. Treat\n * any object whose keys overlap the CLDR set AND whose values are all\n * strings as a plural object — the chunky type guard keeps stray nested\n * namespaces from being misread.\n */\nconst CLDR_CATEGORIES = new Set<string>([\n  \"zero\", \"one\", \"two\", \"few\", \"many\", \"other\",\n]);\n\nfunction isPluralForms(v: unknown): v is PluralForms {\n  if (!v || typeof v !== \"object\" || Array.isArray(v)) return false;\n  const keys = Object.keys(v as object);\n  if (keys.length === 0) return false;\n  if (!keys.some((k) => CLDR_CATEGORIES.has(k))) return false;\n  return keys.every(\n    (k) => typeof (v as Record<string, unknown>)[k] === \"string\",\n  );\n}\n\n/** Resolve a dotted key against a deeply-nested bundle. Returns either a\n *  plain string OR a CLDR plural-forms dict so the caller can pick a form. */\nfunction resolve(bundle: Bundle | undefined, key: string): ResolvedValue | undefined {\n  if (!bundle) return undefined;\n  const parts = key.split(\".\");\n  let cur: unknown = bundle;\n  for (const p of parts) {\n    if (cur && typeof cur === \"object\" && p in (cur as Record<string, unknown>)) {\n      cur = (cur as Record<string, unknown>)[p];\n    } else {\n      return undefined;\n    }\n  }\n  if (typeof cur === \"string\") return cur;\n  if (isPluralForms(cur)) return cur;\n  return undefined;\n}\n\n/**\n * Pick the right CLDR form for `count` against the active locale's plural\n * rules. Falls back to `other` (always required by the contract) and then\n * the first available form so we never render nothing for a configured key.\n */\nfunction selectPluralForm(\n  forms: PluralForms,\n  count: number,\n  locale: string,\n): string {\n  let category: string = \"other\";\n  try {\n    if (typeof Intl !== \"undefined\" && typeof Intl.PluralRules === \"function\") {\n      category = new Intl.PluralRules(locale).select(count);\n    }\n  } catch {\n    // Bad locale tag — fall through to \"other\".\n  }\n  if (category in forms) return forms[category]!;\n  if (\"other\" in forms) return forms[\"other\"]!;\n  const first = Object.keys(forms)[0];\n  return first ? forms[first]! : \"\";\n}\n\n/** Cheap interpolation: replaces `{{name}}` with `options[name]`. */\nfunction interpolate(template: string, options?: Record<string, unknown>): string {\n  if (!options) return template;\n  return template.replace(/\\{\\{\\s*([a-zA-Z0-9_]+)\\s*\\}\\}/g, (_m, name) => {\n    const v = options[name];\n    return v == null ? \"\" : String(v);\n  });\n}\n\n/** A single ready-state + bundle store + missing-key buffer wrapped behind\n *  a tiny pub-sub so React can subscribe via useSyncExternalStore. */\nexport class VerbumiaI18n implements I18nInstance {\n  ready = false;\n  locale: Locale;\n  fallbackLng: Locale | undefined;\n  missingEvents: MissingKeyEvent[] = [];\n\n  private _bundles = new Map<string, Bundle>(); // `${locale}/${ns}` -> tree\n  private _attempted = new Set<string>(); // `${locale}/${ns}` keys we've fetched\n  // Tighter gate than `_attempted`: this set only contains (locale, ns)\n  // pairs whose CDN response was 200 with at least one top-level key. An\n  // empty bundle (404 → {} OR 200 → {}) is treated as \"no data yet\";\n  // calling t() against a key in such a bundle does NOT fire reportMissing.\n  // Prevents the \"boot floods the dashboard\" failure when the project has\n  // a brand-new namespace not yet published, OR when a network blip\n  // produced an empty bundle.\n  private _hasContent = new Set<string>();\n  private _config: Required<\n    Pick<VerbumiaConfig, \"apiBase\" | \"cdnBase\" | \"missingHandler\">\n  > & {\n    token: string;\n    projectUuid: string;\n    namespaces: string[];\n    flushIntervalMs: number;\n    flushBatchSize: number;\n    missingEventsBufferSize: number;\n    versionSlug: string;\n    liveUpdates: boolean;\n    centrifugoTokenEndpoint: string;\n    centrifugoWsUrl: string;\n    env: \"prod\" | \"dev\";\n  };\n\n  private _transport: Transport;\n  private _pending: MissingKeyEvent[] = [];\n  private _seen = new Set<string>(); // dedup `${locale}/${ns}/${key}` per-flush\n  private _timer: ReturnType<typeof setInterval> | null = null;\n  private _listeners = new Set<Listener>();\n  private _live: LiveClient | null = null;\n  // Stable snapshot reference for useSyncExternalStore. Returning a fresh\n  // object on each getSnapshot call would loop React forever — we rebuild\n  // it ONLY in _notify (when state actually changed) and return the cached\n  // reference between notifications.\n  private _snapshot!: I18nInstance;\n\n  constructor(config: VerbumiaConfig) {\n    this.locale = config.defaultLocale;\n    this.fallbackLng = config.fallbackLng;\n    this._config = {\n      apiBase: config.apiBase ?? DEFAULT_API_BASE,\n      cdnBase: config.cdnBase ?? DEFAULT_CDN_BASE,\n      missingHandler: config.missingHandler ?? \"send\",\n      token: config.token,\n      projectUuid: config.projectUuid,\n      namespaces: config.namespaces?.length ? config.namespaces : [\"common\"],\n      flushIntervalMs: config.flushIntervalMs ?? DEFAULT_FLUSH_MS,\n      flushBatchSize: config.flushBatchSize ?? DEFAULT_BATCH,\n      missingEventsBufferSize:\n        config.missingEventsBufferSize ?? DEFAULT_BUFFER,\n      versionSlug: config.versionSlug ?? DEFAULT_VERSION_SLUG,\n      liveUpdates: !!config.liveUpdates,\n      centrifugoTokenEndpoint:\n        config.centrifugoTokenEndpoint ??\n        `${(config.apiBase ?? DEFAULT_API_BASE).replace(/\\/+$/, \"\")}/v1/auth/centrifugo-token`,\n      centrifugoWsUrl: config.centrifugoWsUrl ?? \"\",\n      env: config.env ?? \"prod\",\n    };\n\n    this._transport =\n      config.transport ??\n      (this._config.missingHandler === \"log\"\n        ? logTransport\n        : defaultTransport({\n            apiBase: this._config.apiBase,\n            token: this._config.token,\n            projectUuid: this._config.projectUuid,\n          }));\n    this._snapshot = this._buildSnapshot();\n  }\n\n  // ---- React subscription ----\n\n  subscribe = (listener: Listener): (() => void) => {\n    this._listeners.add(listener);\n    return () => this._listeners.delete(listener) as unknown as void;\n  };\n\n  /** Stable snapshot accessor for useSyncExternalStore. The returned\n   *  object reference is identical between renders unless _notify fired. */\n  getSnapshot = (): I18nInstance => this._snapshot;\n\n  private _buildSnapshot(): I18nInstance {\n    return {\n      ready: this.ready,\n      locale: this.locale,\n      setLocale: this.setLocale,\n      missingEvents: this.missingEvents,\n      flushMissing: this.flushMissing,\n    };\n  }\n\n  private _notify(): void {\n    this._snapshot = this._buildSnapshot();\n    for (const l of this._listeners) l();\n  }\n\n  // ---- Lifecycle ----\n\n  /** Default namespace (the first configured one) — used to attribute a\n   *  bare `t(\"key\")` call when recording on-screen keys. */\n  get defaultNamespace(): string {\n    return this._config.namespaces[0]!;\n  }\n\n  /** Loads the configured namespaces for the active locale + fallback. */\n  async start(fetchImpl: typeof fetch = fetch): Promise<void> {\n    // Publish the on-screen key registry so a mounted feedback widget\n    // lists only the strings rendered on the current view (spec ltm 373).\n    keyRegistry.attach();\n    const targets = new Set<string>([this.locale]);\n    if (this.fallbackLng) targets.add(this.fallbackLng);\n    await Promise.all(\n      [...targets].flatMap((loc) =>\n        this._config.namespaces.map((ns) => this._loadBundle(loc, ns, fetchImpl))\n      )\n    );\n    this.ready = true;\n    this._startTimer();\n    // Product model (ltm 341): an SDK serving a *promoted production*\n    // version (`env: \"prod\"`) NEVER opens a Centrifugo WS — prod freshness\n    // is the CDN `latest/` alias at max-age=60s. Realtime + the\n    // `translations_published` cache-bust are a DEV-version feature only\n    // (bounded connection count, no large prod realtime fleet). The\n    // missing-key POST still fires in prod — it's HTTP, not WS, and is\n    // gated separately. `_startLive` also no-ops when `centrifugoWsUrl`\n    // is unset.\n    if (this._config.liveUpdates && this._config.env === \"dev\") {\n      this._startLive(fetchImpl);\n    }\n    this._notify();\n  }\n\n  setLocale = async (next: Locale): Promise<void> => {\n    if (next === this.locale) return;\n    this.locale = next;\n    this.ready = false;\n    this._notify();\n    await Promise.all(\n      this._config.namespaces.map((ns) => this._loadBundle(next, ns))\n    );\n    this.ready = true;\n    this._notify();\n  };\n\n  stop(): void {\n    keyRegistry.detach();\n    if (this._timer) {\n      clearInterval(this._timer);\n      this._timer = null;\n    }\n    if (this._live) {\n      this._live.dispose();\n      this._live = null;\n    }\n  }\n\n  /**\n   * Start the Centrifugo subscription and re-fetch the relevant bundle on\n   * each `translations_published` event. Best-effort: if the WS URL or\n   * token endpoint isn't reachable, we log silently and the SDK continues\n   * to serve the initial bundle.\n   */\n  private _startLive(fetchImpl: typeof fetch): void {\n    const wsUrl = this._config.centrifugoWsUrl;\n    if (!wsUrl) {\n      // No WS URL configured — emit a console warning and stay static.\n      if (typeof console !== \"undefined\") {\n        console.warn(\n          \"@verbumia/react-i18next: liveUpdates=true but centrifugoWsUrl is empty; skipping subscription.\",\n        );\n      }\n      return;\n    }\n    const projectUuid = this._config.projectUuid;\n    const tokenEndpoint = this._config.centrifugoTokenEndpoint;\n    const apiToken = this._config.token;\n\n    const refreshToken = async (): Promise<string> => {\n      const { token } = await fetchCentrifugoToken(\n        tokenEndpoint, projectUuid, apiToken, fetchImpl,\n      );\n      return token;\n    };\n\n    // Bootstrap: fetch the initial token to learn the channel name + token.\n    void (async () => {\n      let channel: string;\n      let token: string;\n      try {\n        const minted = await fetchCentrifugoToken(\n          tokenEndpoint, projectUuid, apiToken, fetchImpl,\n        );\n        channel = minted.channel;\n        token = minted.token;\n      } catch (err) {\n        if (typeof console !== \"undefined\") {\n          console.warn(\"@verbumia/react-i18next: live token mint failed\", err);\n        }\n        return;\n      }\n      this._live = new LiveClient({\n        url: wsUrl,\n        token,\n        channel,\n        refreshToken,\n        onMessage: (data) => this._onLiveMessage(data, fetchImpl),\n      });\n      void this._live.connect();\n    })();\n  }\n\n  private _onLiveMessage(data: unknown, fetchImpl: typeof fetch): void {\n    if (!data || typeof data !== \"object\") return;\n    const d = data as { event?: string; language_code?: string; namespace_slug?: string };\n    if (d.event !== \"translations_published\") return;\n    const lang = d.language_code;\n    const ns = d.namespace_slug;\n    if (!lang || !ns) return;\n    // Only refetch bundles we already loaded — no point pulling a (lang, ns)\n    // pair the app never asked for.\n    const cacheKey = `${lang}/${ns}`;\n    if (!this._attempted.has(cacheKey)) return;\n    // Live republish: the CDN `latest/` alias is mutable and may still be\n    // inside its HTTP max-age window in the browser cache, so a normal\n    // refetch would return the STALE bundle. Force `cache: \"reload\"` to\n    // bypass the HTTP cache and pull the just-published content, then\n    // re-render. (Option-c, task 580.)\n    void this._loadBundle(lang, ns, fetchImpl, { bust: true }).then(() => {\n      this._notify();\n    });\n  }\n\n  // ---- Translation ----\n\n  t = (key: string, options?: Record<string, unknown> & { defaultValue?: string; count?: number }): string => {\n    const namespace = this._splitNamespace(key);\n    const bareKey = namespace.bareKey;\n    const ns = namespace.ns;\n\n    const fromActive = resolve(this._bundles.get(`${this.locale}/${ns}`), bareKey);\n    if (fromActive != null) {\n      return this._render(fromActive, this.locale, options);\n    }\n\n    if (this.fallbackLng && this.fallbackLng !== this.locale) {\n      const fb = resolve(this._bundles.get(`${this.fallbackLng}/${ns}`), bareKey);\n      if (fb != null) {\n        return this._render(fb, this.fallbackLng, options);\n      }\n    }\n\n    // Missing path — only report once we've actually fetched the bundle for\n    // this (locale, ns), otherwise the first paint floods the dashboard.\n    // Three-condition gate: ready + attempted + bundle had content. The\n    // last clause prevents flooding when the bundle came back empty (404\n    // or {}); we'd be reporting against keys we never had a chance to\n    // resolve. Master 2026-05-07 P0: see `_hasContent` doc.\n    if (\n      this.ready &&\n      this._attempted.has(`${this.locale}/${ns}`) &&\n      this._hasContent.has(`${this.locale}/${ns}`)\n    ) {\n      this._reportMissing({\n        key: bareKey,\n        namespace: ns,\n        language_code: this.locale,\n        source_value: this._sourceValueFor(bareKey, ns, options),\n      });\n    }\n    const defaultValue = options?.defaultValue;\n    if (typeof defaultValue === \"string\") {\n      return interpolate(defaultValue, options);\n    }\n    return key;\n  };\n\n  flushMissing = async (): Promise<void> => {\n    if (!this._pending.length) return;\n    const batch = this._pending.slice(0);\n    this._pending = [];\n    if (this._config.missingHandler === \"off\") return;\n    try {\n      await this._transport(batch);\n    } catch {\n      // best-effort\n    }\n  };\n\n  // ---- Internals ----\n\n  /**\n   * Final-stage render: pick the right plural form (when value is a CLDR\n   * dict and `options.count` is a number) then interpolate `{{var}}`.\n   */\n  private _render(\n    value: ResolvedValue,\n    locale: Locale,\n    options?: Record<string, unknown> & { count?: number },\n  ): string {\n    let str: string;\n    if (typeof value === \"string\") {\n      str = value;\n    } else {\n      const count = typeof options?.count === \"number\" ? options.count : 0;\n      str = selectPluralForm(value, count, locale);\n    }\n    return interpolate(str, options);\n  }\n\n  private _splitNamespace(key: string): { ns: Namespace; bareKey: string } {\n    // i18next convention: \"ns:key\"\n    const idx = key.indexOf(\":\");\n    if (idx > 0) {\n      return { ns: key.slice(0, idx), bareKey: key.slice(idx + 1) };\n    }\n    return { ns: this._config.namespaces[0]!, bareKey: key };\n  }\n\n  private async _loadBundle(\n    locale: Locale,\n    ns: Namespace,\n    fetchImpl: typeof fetch = fetch,\n    opts: { bust?: boolean } = {}\n  ): Promise<void> {\n    const cacheKey = `${locale}/${ns}`;\n    // env routing — prod hits the CDN cache; dev hits the live runtime\n    // endpoint authenticated with the API key.\n    let url: string;\n    let init: RequestInit;\n    if (this._config.env === \"dev\") {\n      const params = new URLSearchParams({ language: locale, namespace: ns });\n      if (this._config.versionSlug && this._config.versionSlug !== \"main\") {\n        params.set(\"version_slug\", this._config.versionSlug);\n      }\n      url = `${this._config.apiBase.replace(/\\/+$/, \"\")}/v1/projects/${this._config.projectUuid}/translations/runtime?${params.toString()}`;\n      init = {\n        method: \"GET\",\n        headers: { Authorization: `ApiKey ${this._config.token}` },\n        credentials: \"omit\",\n      };\n    } else {\n      url = `${this._config.cdnBase.replace(/\\/+$/, \"\")}/p/${this._config.projectUuid}/${this._config.versionSlug}/latest/${locale}/${ns}.json`;\n      init = { method: \"GET\", credentials: \"omit\" };\n    }\n    // On a live-republish refetch, bypass the browser HTTP cache so the\n    // mutable `latest/` alias is re-pulled from network even within its\n    // max-age window.\n    if (opts.bust) {\n      init.cache = \"reload\";\n    }\n    // A failed live refetch must NOT downgrade already-good translations to\n    // keys — keep showing the last-known-good bundle. Only the initial\n    // (non-bust) load may cache an empty object as the \"no bundle\" sentinel.\n    const hadContent = this._hasContent.has(cacheKey);\n    try {\n      const r = await fetchImpl(url, init);\n      if (r.ok) {\n        const data = (await r.json()) as Bundle;\n        this._bundles.set(cacheKey, data);\n        if (data && typeof data === \"object\" && Object.keys(data).length > 0) {\n          this._hasContent.add(cacheKey);\n        } else {\n          this._hasContent.delete(cacheKey);\n        }\n      } else if (opts.bust && hadContent) {\n        // transient non-OK on a live refetch — keep prior content\n      } else {\n        // 404 = no published bundle yet. Cache an empty object so subsequent\n        // resolve()s short-circuit, but DO NOT flag as having content — the\n        // gate suppresses reportMissing in this state.\n        this._bundles.set(cacheKey, {});\n        this._hasContent.delete(cacheKey);\n      }\n    } catch {\n      if (opts.bust && hadContent) {\n        // transient network error on a live refetch — keep prior content\n      } else {\n        this._bundles.set(cacheKey, {});\n        this._hasContent.delete(cacheKey);\n      }\n    } finally {\n      this._attempted.add(cacheKey);\n    }\n  }\n\n  private _startTimer(): void {\n    if (this._config.missingHandler === \"off\") return;\n    if (typeof setInterval !== \"function\") return;\n    this._timer = setInterval(() => {\n      void this.flushMissing();\n    }, this._config.flushIntervalMs);\n  }\n\n  /**\n   * Resolve the `source_value` we send with a missing-key report.\n   *\n   * Fallback chain (per backend agreement 2026-05-14, task 575):\n   *   1. `options.defaultValue` — explicit developer-provided string.\n   *   2. The fallbackLng bundle's value for this key (typically the\n   *      source/canonical locale). Only used when it resolves to a\n   *      plain string, not a plural CLDR dict.\n   *   3. The bare key itself — last resort so dashboards never render\n   *      a blank `source_value` column.\n   */\n  private _sourceValueFor(\n    bareKey: string,\n    ns: string,\n    options?: { defaultValue?: string }\n  ): string {\n    if (typeof options?.defaultValue === \"string\") {\n      return options.defaultValue;\n    }\n    if (this.fallbackLng && this.fallbackLng !== this.locale) {\n      const fb = resolve(this._bundles.get(`${this.fallbackLng}/${ns}`), bareKey);\n      if (typeof fb === \"string\") {\n        return fb;\n      }\n    }\n    return bareKey;\n  }\n\n  private _reportMissing(event: MissingKeyEvent): void {\n    if (this._config.missingHandler === \"off\") return;\n    const dedupKey = `${event.language_code}/${event.namespace}/${event.key}`;\n    if (this._seen.has(dedupKey)) return;\n    this._seen.add(dedupKey);\n\n    // Push to ring buffer (capped) for in-app inspectors.\n    this.missingEvents = [event, ...this.missingEvents].slice(\n      0,\n      this._config.missingEventsBufferSize\n    );\n    this._pending.push(event);\n    if (this._pending.length >= this._config.flushBatchSize) {\n      void this.flushMissing();\n    }\n    this._notify();\n  }\n}\n","import { useEffect, useMemo, useRef } from \"react\";\nimport { useI18n, useI18nSnapshot } from \"./provider\";\nimport { keyRegistry } from \"./key-registry\";\nimport type { I18nInstance, TranslationFunction } from \"./types\";\n\nexport interface UseTranslationResult {\n  t: TranslationFunction;\n  i18n: I18nInstance;\n}\n\n/** React hook — returns `{ t, i18n }`. Optional `defaultNamespace` lets you\n *  drop the `ns:` prefix on every call.\n *\n *  Every key this hook resolves during a render is recorded into the\n *  on-screen key registry (so a mounted `@verbumia/feedback` widget lists\n *  only the strings rendered on the current view — spec ltm 373). The\n *  contribution is keyed to THIS hook instance and dropped on unmount, so\n *  navigating away removes its keys automatically. */\nexport function useTranslation(defaultNamespace?: string): UseTranslationResult {\n  const i18n = useI18n();\n  const snapshot = useI18nSnapshot();\n\n  // Keys resolved in the CURRENT render pass. The hook body runs before\n  // the component's own `t()` calls, so clearing here yields a set that\n  // reflects exactly this render once the component finishes.\n  const renderedRef = useRef<Set<string>>(new Set());\n  renderedRef.current = new Set<string>();\n  // Opaque, stable token identifying this hook instance in the registry.\n  const tokenRef = useRef<symbol>(Symbol(\"verbumia.t\"));\n\n  const t = useMemo<TranslationFunction>(() => {\n    return (key, options) => {\n      const fullKey =\n        defaultNamespace && !key.includes(\":\")\n          ? `${defaultNamespace}:${key}`\n          : key;\n      renderedRef.current.add(\n        keyRegistry.encode(fullKey, i18n.defaultNamespace),\n      );\n      return i18n.t(fullKey, options);\n    };\n  }, [i18n, defaultNamespace]);\n\n  // After every commit, publish this instance's latest rendered-key set.\n  useEffect(() => {\n    keyRegistry._set(tokenRef.current, renderedRef.current);\n  });\n  // Unmount only: drop this instance entirely so its keys leave the\n  // on-screen snapshot when the component is gone (e.g. route change).\n  useEffect(() => {\n    const token = tokenRef.current;\n    return () => keyRegistry._delete(token);\n  }, []);\n\n  return { t, i18n: snapshot };\n}\n","import { Children, cloneElement, isValidElement, type ReactNode } from \"react\";\nimport { useTranslation } from \"./hooks\";\n\nexport interface TransProps {\n  /** The translation key (optionally `ns:key`). */\n  i18nKey: string;\n  /** Default value if the key is missing — used as the fallback string. */\n  defaults?: string;\n  /** Variables interpolated into `{{var}}` placeholders. */\n  values?: Record<string, unknown>;\n  /** JSX components mapped by 0-based numeric index — `<0>bold</0>` etc. */\n  components?: ReactNode[];\n  /** Optional namespace shortcut. */\n  namespace?: string;\n}\n\n/** Bare-bones Trans component: resolves the key, interpolates values, and\n *  swaps `<0>...</0>` placeholders into the supplied React components.\n *  Keeps the surface minimal — full Trans semantics (nested keys, plural\n *  trees, gender) land in V1.1. */\nexport function Trans({\n  i18nKey,\n  defaults,\n  values,\n  components,\n  namespace,\n}: TransProps) {\n  const { t } = useTranslation(namespace);\n  const raw = t(i18nKey, { ...(values ?? {}), defaultValue: defaults ?? i18nKey });\n  if (!components || !components.length) return <>{raw}</>;\n  return <>{splitOnComponents(raw, components)}</>;\n}\n\nfunction splitOnComponents(text: string, components: ReactNode[]): ReactNode[] {\n  const out: ReactNode[] = [];\n  // Match <N>...</N> where N is a 0-based index into `components`.\n  const re = /<(\\d+)>(.*?)<\\/\\1>/g;\n  let lastIndex = 0;\n  let m: RegExpExecArray | null;\n  while ((m = re.exec(text)) !== null) {\n    if (m.index > lastIndex) out.push(text.slice(lastIndex, m.index));\n    const idx = Number(m[1]);\n    const inner = m[2];\n    const node = components[idx];\n    if (isValidElement(node)) {\n      out.push(\n        cloneElement(node, { key: `t-${m.index}` }, ...Children.toArray(inner ?? \"\"))\n      );\n    } else if (node !== undefined) {\n      out.push(node);\n    } else {\n      out.push(inner ?? \"\");\n    }\n    lastIndex = re.lastIndex;\n  }\n  if (lastIndex < text.length) out.push(text.slice(lastIndex));\n  return out;\n}\n"],"mappings":"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","names":["import_react","import_react","import_jsx_runtime"]}
+{"version":3,"sources":["../src/index.ts","../src/provider.tsx","../src/transport.ts","../src/live.ts","../src/key-registry.ts","../src/i18n.ts","../src/singleton.ts","../src/hooks.ts","../src/trans.tsx"],"sourcesContent":["export { VerbumiaProvider } from \"./provider\";\nexport { useTranslation } from \"./hooks\";\nexport { Trans } from \"./trans\";\n/** Access the active i18n instance outside React components (react-i18next\n *  drop-in: standalone singleton). Throws if no provider is mounted. */\nexport { getI18n } from \"./singleton\";\nexport type {\n  I18nInstance,\n  Locale,\n  MissingHandlerMode,\n  MissingKeyEvent,\n  Namespace,\n  TranslationFunction,\n  TranslationOptions,\n  Transport,\n  VerbumiaConfig,\n  VerbumiaPlugin,\n  VerbumiaPluginContext,\n} from \"./types\";\nexport { defaultTransport, logTransport } from \"./transport\";\n/** Advanced: the on-screen key registry feeding `@verbumia/feedback`.\n *  Mount-tracking handles navigation automatically; `reset()` is only\n *  needed for non-React routing edge cases. */\nexport { keyRegistry } from \"./key-registry\";\nexport type { DeclaredKey } from \"./key-registry\";\n","import {\n  createContext,\n  Fragment,\n  useContext,\n  useEffect,\n  useMemo,\n  useSyncExternalStore,\n  type ReactNode,\n} from \"react\";\nimport { VerbumiaI18n } from \"./i18n\";\nimport { _clearActiveInstance, _setActiveInstance } from \"./singleton\";\nimport type { I18nInstance, VerbumiaConfig } from \"./types\";\n\ninterface VerbumiaContextValue {\n  i18n: VerbumiaI18n;\n}\n\nconst VerbumiaContext = createContext<VerbumiaContextValue | null>(null);\n\nexport interface VerbumiaProviderProps extends VerbumiaConfig {\n  children: ReactNode;\n}\n\nexport function VerbumiaProvider({\n  children,\n  ...config\n}: VerbumiaProviderProps) {\n  // Stable instance for the lifetime of the provider mount.\n  const i18n = useMemo(() => new VerbumiaI18n(config), []); // eslint-disable-line react-hooks/exhaustive-deps\n\n  useEffect(() => {\n    // Register as the active instance so `getI18n()` works outside React.\n    _setActiveInstance(i18n);\n    void i18n.start();\n    // Plugins (e.g. @verbumia/feedback) hook the SAME i18n instance —\n    // no second context. setup() runs once; optional teardown on unmount.\n    const teardowns = (config.plugins ?? [])\n      .map((p) => p.setup?.({ i18n, config }))\n      .filter((t): t is () => void => typeof t === \"function\");\n    return () => {\n      teardowns.forEach((t) => t());\n      i18n.stop();\n      _clearActiveInstance(i18n);\n    };\n  }, [i18n]); // eslint-disable-line react-hooks/exhaustive-deps\n\n  const value = useMemo<VerbumiaContextValue>(() => ({ i18n }), [i18n]);\n  return (\n    <VerbumiaContext.Provider value={value}>\n      {children}\n      {/* Plugin outlets: isolated sibling leaves AFTER children. Their\n          internal state never propagates to the host app subtree. */}\n      {(config.plugins ?? []).map((p) =>\n        p.render ? <Fragment key={p.name}>{p.render()}</Fragment> : null,\n      )}\n    </VerbumiaContext.Provider>\n  );\n}\n\n/** Internal — used by useTranslation + Trans. */\nexport function useI18n(): VerbumiaI18n {\n  const ctx = useContext(VerbumiaContext);\n  if (!ctx) {\n    throw new Error(\"useTranslation/Trans must be used inside <VerbumiaProvider>\");\n  }\n  return ctx.i18n;\n}\n\n/** Subscribes to the i18n store and returns a snapshot the React tree can render.\n *\n * `getSnapshot` MUST return a stable reference between notifications,\n * otherwise React loops forever (Maximum update depth exceeded). The\n * VerbumiaI18n instance caches its snapshot internally — see\n * `_notify` / `_buildSnapshot`. */\nexport function useI18nSnapshot(): I18nInstance {\n  const i18n = useI18n();\n  return useSyncExternalStore(i18n.subscribe, i18n.getSnapshot, i18n.getSnapshot);\n}\n","import type { MissingKeyEvent, Transport } from \"./types\";\n\nconst SDK_LIB = \"@verbumia/react-i18next\";\nconst SDK_VER = \"0.5.2\";\n\n/** Default transport: POST to `${apiBase}/v1/missing` with the API key. */\nexport function defaultTransport(opts: {\n  apiBase: string;\n  token: string;\n  projectUuid: string;\n}): Transport {\n  return async (batch) => {\n    if (!batch.length) return;\n    const body = {\n      project_uuid: opts.projectUuid,\n      events: batch.map((e) => ({\n        key: e.key,\n        namespace: e.namespace,\n        language_code: e.language_code,\n        source_value: e.source_value,\n        sdk_meta: {\n          lib: SDK_LIB,\n          ver: SDK_VER,\n          ...(typeof window !== \"undefined\"\n            ? { url: window.location?.href }\n            : {}),\n          ...(e.sdk_meta ?? {}),\n        },\n      })),\n    };\n    try {\n      await fetch(`${opts.apiBase.replace(/\\/+$/, \"\")}/v1/missing`, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          Authorization: `ApiKey ${opts.token}`,\n        },\n        body: JSON.stringify(body),\n        // SDKs are best-effort; never block the render path\n        keepalive: true,\n      });\n    } catch {\n      // swallow — missing-key reporting must never break the host app\n    }\n  };\n}\n\n/** Logs each event to console.warn — handy for dev. */\nexport const logTransport: Transport = (batch: MissingKeyEvent[]) => {\n  for (const e of batch) {\n    // eslint-disable-next-line no-console\n    console.warn(\"[verbumia] missing key\", e);\n  }\n};\n","/**\n * Tiny Centrifugo WebSocket client tailored to the Verbumia\n * `translations:` channel. Hand-rolled (no `centrifuge-js` dep) so the SDK\n * stays under 15 KB gzipped — we only need: connect, subscribe, listen.\n *\n * Wire format reference:\n *   https://centrifugal.dev/docs/transports/websocket\n *\n * Lifecycle:\n *   - call connect() with a valid token\n *   - server replies with {push|reply}; we wait for the connect ack\n *   - subscribe(channel) — send subscribe command, wait for ack\n *   - subsequent {push, channel, pub.data} are routed to onMessage\n *   - reconnect with exponential backoff (capped at 30s) on close\n */\n\nexport interface LiveClientConfig {\n  url: string;\n  token: string;\n  channel: string;\n  onMessage: (data: unknown) => void;\n  onStatus?: (status: \"connecting\" | \"connected\" | \"disconnected\") => void;\n  /**\n   * Hook called just before each connect attempt — return a fresh token\n   * (used to refresh a token whose `exp` is close). Defaults to the\n   * static one passed in `token`.\n   */\n  refreshToken?: () => Promise<string>;\n}\n\nexport class LiveClient {\n  private _ws: WebSocket | null = null;\n  private _id = 0;\n  private _backoffMs = 1_000;\n  private _disposed = false;\n  private _connectAcked = false;\n\n  constructor(private readonly cfg: LiveClientConfig) {}\n\n  /** Open the socket and try to subscribe. Idempotent — calling twice is a no-op. */\n  async connect(): Promise<void> {\n    if (this._ws) return;\n    if (this._disposed) return;\n    this.cfg.onStatus?.(\"connecting\");\n    const token = this.cfg.refreshToken ? await this.cfg.refreshToken() : this.cfg.token;\n    // Centrifugo's WebSocket endpoint lives at `/connection/websocket`.\n    // Be forgiving on the input — accept either a bare host\n    // (`wss://centrifugo.example`) or the full path.\n    let url = this.cfg.url;\n    if (!url.includes(\"/connection/websocket\")) {\n      url = url.replace(/\\/+$/, \"\") + \"/connection/websocket\";\n    }\n    const ws = new WebSocket(url);\n    this._ws = ws;\n    this._connectAcked = false;\n\n    ws.onopen = () => {\n      // Centrifugo command: connect with token\n      this._send({ id: ++this._id, connect: { token } });\n    };\n    ws.onmessage = (evt) => this._onFrame(evt.data);\n    ws.onclose = () => this._onClose();\n    ws.onerror = () => {\n      // Let onclose handle the reconnect.\n    };\n  }\n\n  dispose(): void {\n    this._disposed = true;\n    if (this._ws) {\n      try {\n        this._ws.close();\n      } catch {\n        // ignore\n      }\n      this._ws = null;\n    }\n    this.cfg.onStatus?.(\"disconnected\");\n  }\n\n  // ---- internals ----\n\n  private _send(msg: unknown): void {\n    if (!this._ws || this._ws.readyState !== WebSocket.OPEN) return;\n    try {\n      this._ws.send(JSON.stringify(msg));\n    } catch {\n      // ignore — onclose will fire shortly\n    }\n  }\n\n  private _onFrame(raw: unknown): void {\n    let parsed: {\n      id?: number;\n      connect?: { client?: string };\n      subscribe?: unknown;\n      push?: { channel?: string; pub?: { data?: unknown }; sub?: unknown };\n    } | undefined;\n    try {\n      parsed = JSON.parse(raw as string);\n    } catch {\n      return;\n    }\n    if (!parsed || typeof parsed !== \"object\") return;\n    // Centrifugo v2 protocol pings: server periodically sends an empty\n    // object `{}`. Client MUST reply with an empty `{}` to keep the\n    // connection alive — without this the server force-closes after\n    // ~25-30s and we lose pushes silently.\n    if (Object.keys(parsed).length === 0) {\n      this._send({});\n      return;\n    }\n    if (parsed.connect && !this._connectAcked) {\n      this._connectAcked = true;\n      this.cfg.onStatus?.(\"connected\");\n      this._backoffMs = 1_000;\n      // Connection token's `channels` claim auto-subscribes us server-side,\n      // so an explicit subscribe command is unnecessary. We still send it\n      // for back-compat with anonymous-channel deployments where no\n      // server-side subscription was created.\n      this._send({\n        id: ++this._id,\n        subscribe: { channel: this.cfg.channel },\n      });\n      return;\n    }\n    const push = parsed.push;\n    if (push && push.channel === this.cfg.channel && push.pub) {\n      this.cfg.onMessage(push.pub.data);\n    }\n  }\n\n  private _onClose(): void {\n    this._ws = null;\n    this._connectAcked = false;\n    this.cfg.onStatus?.(\"disconnected\");\n    if (this._disposed) return;\n    const delay = this._backoffMs;\n    this._backoffMs = Math.min(this._backoffMs * 2, 30_000);\n    setTimeout(() => {\n      if (!this._disposed) void this.connect();\n    }, delay);\n  }\n}\n\n/**\n * Fetch a fresh Centrifugo connection token from the backend. The\n * endpoint signature matches `POST /v1/auth/centrifugo-token` —\n * `{project_uuid}` body, `{token, channel, ...}` response.\n */\nexport async function fetchCentrifugoToken(\n  endpoint: string,\n  projectUuid: string,\n  authToken: string,\n  fetchImpl: typeof fetch = fetch,\n): Promise<{ token: string; channel: string; expires_at: number }> {\n  const r = await fetchImpl(endpoint, {\n    method: \"POST\",\n    headers: {\n      \"Content-Type\": \"application/json\",\n      Authorization: `ApiKey ${authToken}`,\n    },\n    body: JSON.stringify({ project_uuid: projectUuid }),\n  });\n  if (!r.ok) {\n    throw new Error(`centrifugo-token endpoint ${r.status}: ${await r.text()}`);\n  }\n  return (await r.json()) as { token: string; channel: string; expires_at: number };\n}\n","/**\n * On-screen key registry — the PRODUCER side of the tiny cross-package\n * contract that `@verbumia/feedback` consumes via\n * `globalThis.__verbumia_key_registry__` (see `@verbumia/feedback`'s\n * `core/keys.ts`).\n *\n * Why this exists: the feedback widget must list only the translation\n * strings RENDERED on the current screen (spec ltm 373) — NOT every\n * project string. The widget can't know what's on screen; the i18n SDK\n * does, because it resolves the keys. So the SDK tracks the keys touched\n * by currently-MOUNTED `useTranslation`/`Trans` consumers and exposes\n * them through a minimal global. When a component unmounts (navigation),\n * its keys drop out automatically — so `snapshot()` is always exactly\n * \"what is on screen right now\". Explicit `keys` on the feedback plugin\n * stays a fallback for non-i18n strings; it is NOT \"pass everything\".\n *\n * The published shape is intentionally tiny so any framework port of the\n * i18n SDK can implement the same global without depending on feedback:\n *\n *   globalThis.__verbumia_key_registry__ = {\n *     snapshot(): { namespace: string; key: string }[];\n *     reset(): void;\n *   }\n */\n\nexport interface DeclaredKey {\n  namespace: string;\n  key: string;\n}\n\nconst GLOBAL = \"__verbumia_key_registry__\";\n// Internal id separator. NUL never appears in an i18next namespace or\n// key, so it round-trips even when a key itself contains ':'.\nconst SEP = \"\u0000\";\n\n/** Split an i18next-style `ns:key` (mirrors VerbumiaI18n._splitNamespace). */\nfunction split(fullKey: string, defaultNamespace: string): DeclaredKey {\n  const idx = fullKey.indexOf(\":\");\n  if (idx > 0) {\n    return { namespace: fullKey.slice(0, idx), key: fullKey.slice(idx + 1) };\n  }\n  return { namespace: defaultNamespace, key: fullKey };\n}\n\nclass KeyRegistry {\n  // One Set per mounted hook/Trans instance (keyed by an opaque token).\n  // The on-screen set is the UNION of all live instances' latest render.\n  private _instances = new Map<symbol, Set<string>>();\n  // Provider mounts that have published us onto globalThis. Ref-counted so\n  // a multi-provider tree (or fast unmount/remount in tests) never leaves\n  // a stale global or unpublishes while another provider is still live.\n  private _providers = 0;\n\n  /** Replace an instance's contributed key set (called every render). */\n  _set(token: symbol, keys: Set<string>): void {\n    this._instances.set(token, keys);\n  }\n\n  /** Drop an instance entirely (called on unmount). */\n  _delete(token: symbol): void {\n    this._instances.delete(token);\n  }\n\n  /** Keys rendered by currently-mounted consumers. Stable insertion order. */\n  snapshot(): DeclaredKey[] {\n    const seen = new Set<string>();\n    const out: DeclaredKey[] = [];\n    for (const set of this._instances.values()) {\n      for (const id of set) {\n        if (seen.has(id)) continue;\n        seen.add(id);\n        const c = id.indexOf(SEP);\n        out.push({ namespace: id.slice(0, c), key: id.slice(c + 1) });\n      }\n    }\n    return out;\n  }\n\n  /** Escape hatch (router integrations / tests). Mount-tracking already\n   *  handles navigation, so this is rarely needed. */\n  reset(): void {\n    this._instances.clear();\n  }\n\n  /** Encode a resolved key into the internal id used by `_set`. */\n  encode(fullKey: string, defaultNamespace: string): string {\n    const k = split(fullKey, defaultNamespace);\n    return `${k.namespace}${SEP}${k.key}`;\n  }\n\n  /** Provider mounted — publish the global (idempotent, ref-counted). */\n  attach(): void {\n    this._providers += 1;\n    if (this._providers === 1) {\n      (globalThis as Record<string, unknown>)[GLOBAL] = {\n        snapshot: () => this.snapshot(),\n        reset: () => this.reset(),\n      };\n    }\n  }\n\n  /** Provider unmounted — unpublish when the last one goes away. */\n  detach(): void {\n    this._providers = Math.max(0, this._providers - 1);\n    if (this._providers === 0) {\n      this._instances.clear();\n      const g = globalThis as Record<string, unknown>;\n      if (g[GLOBAL]) delete g[GLOBAL];\n    }\n  }\n}\n\n/** Process-wide singleton — there is exactly one on-screen registry. */\nexport const keyRegistry = new KeyRegistry();\n","import type {\n  I18nInstance,\n  Locale,\n  MissingKeyEvent,\n  Namespace,\n  Transport,\n  VerbumiaConfig,\n} from \"./types\";\nimport { defaultTransport, logTransport } from \"./transport\";\nimport { LiveClient, fetchCentrifugoToken } from \"./live\";\nimport { keyRegistry } from \"./key-registry\";\n\nconst DEFAULT_API_BASE = \"https://api.verbumia.dev\";\nconst DEFAULT_CDN_BASE = \"https://cdn.verbumia.ca\";\nconst DEFAULT_FLUSH_MS = 5_000;\nconst DEFAULT_BATCH = 50;\nconst DEFAULT_BUFFER = 200;\nconst DEFAULT_VERSION_SLUG = \"main\";\n\ntype Bundle = Record<string, unknown>;\ntype Listener = () => void;\n\ntype PluralForms = Record<string, string>;\ntype ResolvedValue = string | PluralForms;\n\n/**\n * Plural-form objects mirror the CLDR `Intl.PluralRules` categories. Treat\n * any object whose keys overlap the CLDR set AND whose values are all\n * strings as a plural object — the chunky type guard keeps stray nested\n * namespaces from being misread.\n */\nconst CLDR_CATEGORIES = new Set<string>([\n  \"zero\", \"one\", \"two\", \"few\", \"many\", \"other\",\n]);\n\nfunction isPluralForms(v: unknown): v is PluralForms {\n  if (!v || typeof v !== \"object\" || Array.isArray(v)) return false;\n  const keys = Object.keys(v as object);\n  if (keys.length === 0) return false;\n  if (!keys.some((k) => CLDR_CATEGORIES.has(k))) return false;\n  return keys.every(\n    (k) => typeof (v as Record<string, unknown>)[k] === \"string\",\n  );\n}\n\n/** Resolve a dotted key against a deeply-nested bundle. Returns either a\n *  plain string OR a CLDR plural-forms dict so the caller can pick a form. */\nfunction resolve(bundle: Bundle | undefined, key: string): ResolvedValue | undefined {\n  if (!bundle) return undefined;\n  const parts = key.split(\".\");\n  let cur: unknown = bundle;\n  for (const p of parts) {\n    if (cur && typeof cur === \"object\" && p in (cur as Record<string, unknown>)) {\n      cur = (cur as Record<string, unknown>)[p];\n    } else {\n      return undefined;\n    }\n  }\n  if (typeof cur === \"string\") return cur;\n  if (isPluralForms(cur)) return cur;\n  return undefined;\n}\n\n/**\n * Pick the right CLDR form for `count` against the active locale's plural\n * rules. Falls back to `other` (always required by the contract) and then\n * the first available form so we never render nothing for a configured key.\n */\nfunction selectPluralForm(\n  forms: PluralForms,\n  count: number,\n  locale: string,\n): string {\n  let category: string = \"other\";\n  try {\n    if (typeof Intl !== \"undefined\" && typeof Intl.PluralRules === \"function\") {\n      category = new Intl.PluralRules(locale).select(count);\n    }\n  } catch {\n    // Bad locale tag — fall through to \"other\".\n  }\n  if (category in forms) return forms[category]!;\n  if (\"other\" in forms) return forms[\"other\"]!;\n  const first = Object.keys(forms)[0];\n  return first ? forms[first]! : \"\";\n}\n\n/** Cheap interpolation: replaces `{{name}}` with `options[name]`. */\nfunction interpolate(template: string, options?: Record<string, unknown>): string {\n  if (!options) return template;\n  return template.replace(/\\{\\{\\s*([a-zA-Z0-9_]+)\\s*\\}\\}/g, (_m, name) => {\n    const v = options[name];\n    return v == null ? \"\" : String(v);\n  });\n}\n\n/** A single ready-state + bundle store + missing-key buffer wrapped behind\n *  a tiny pub-sub so React can subscribe via useSyncExternalStore. */\nexport class VerbumiaI18n implements I18nInstance {\n  ready = false;\n  locale: Locale;\n  fallbackLng: Locale | undefined;\n  missingEvents: MissingKeyEvent[] = [];\n\n  private _bundles = new Map<string, Bundle>(); // `${locale}/${ns}` -> tree\n  private _attempted = new Set<string>(); // `${locale}/${ns}` keys we've fetched\n  // Tighter gate than `_attempted`: this set only contains (locale, ns)\n  // pairs whose CDN response was 200 with at least one top-level key. An\n  // empty bundle (404 → {} OR 200 → {}) is treated as \"no data yet\";\n  // calling t() against a key in such a bundle does NOT fire reportMissing.\n  // Prevents the \"boot floods the dashboard\" failure when the project has\n  // a brand-new namespace not yet published, OR when a network blip\n  // produced an empty bundle.\n  private _hasContent = new Set<string>();\n  private _config: Required<\n    Pick<VerbumiaConfig, \"apiBase\" | \"cdnBase\" | \"missingHandler\">\n  > & {\n    token: string;\n    projectUuid: string;\n    namespaces: string[];\n    flushIntervalMs: number;\n    flushBatchSize: number;\n    missingEventsBufferSize: number;\n    versionSlug: string;\n    liveUpdates: boolean;\n    centrifugoTokenEndpoint: string;\n    centrifugoWsUrl: string;\n    env: \"prod\" | \"dev\";\n  };\n\n  private _transport: Transport;\n  private _pending: MissingKeyEvent[] = [];\n  private _seen = new Set<string>(); // dedup `${locale}/${ns}/${key}` per-flush\n  private _timer: ReturnType<typeof setInterval> | null = null;\n  private _listeners = new Set<Listener>();\n  private _live: LiveClient | null = null;\n  // Stable snapshot reference for useSyncExternalStore. Returning a fresh\n  // object on each getSnapshot call would loop React forever — we rebuild\n  // it ONLY in _notify (when state actually changed) and return the cached\n  // reference between notifications.\n  private _snapshot!: I18nInstance;\n\n  constructor(config: VerbumiaConfig) {\n    this.locale = config.defaultLocale;\n    this.fallbackLng = config.fallbackLng;\n    this._config = {\n      apiBase: config.apiBase ?? DEFAULT_API_BASE,\n      cdnBase: config.cdnBase ?? DEFAULT_CDN_BASE,\n      missingHandler: config.missingHandler ?? \"send\",\n      token: config.token,\n      projectUuid: config.projectUuid,\n      namespaces: config.namespaces?.length\n        ? config.namespaces\n        : config.defaultNS\n          ? [config.defaultNS]\n          : [\"common\"],\n      flushIntervalMs: config.flushIntervalMs ?? DEFAULT_FLUSH_MS,\n      flushBatchSize: config.flushBatchSize ?? DEFAULT_BATCH,\n      missingEventsBufferSize:\n        config.missingEventsBufferSize ?? DEFAULT_BUFFER,\n      versionSlug: config.versionSlug ?? DEFAULT_VERSION_SLUG,\n      liveUpdates: !!config.liveUpdates,\n      centrifugoTokenEndpoint:\n        config.centrifugoTokenEndpoint ??\n        `${(config.apiBase ?? DEFAULT_API_BASE).replace(/\\/+$/, \"\")}/v1/auth/centrifugo-token`,\n      centrifugoWsUrl: config.centrifugoWsUrl ?? \"\",\n      env: config.env ?? \"prod\",\n    };\n\n    this._transport =\n      config.transport ??\n      (this._config.missingHandler === \"log\"\n        ? logTransport\n        : defaultTransport({\n            apiBase: this._config.apiBase,\n            token: this._config.token,\n            projectUuid: this._config.projectUuid,\n          }));\n    this._snapshot = this._buildSnapshot();\n  }\n\n  // ---- React subscription ----\n\n  subscribe = (listener: Listener): (() => void) => {\n    this._listeners.add(listener);\n    return () => this._listeners.delete(listener) as unknown as void;\n  };\n\n  /** Stable snapshot accessor for useSyncExternalStore. The returned\n   *  object reference is identical between renders unless _notify fired. */\n  getSnapshot = (): I18nInstance => this._snapshot;\n\n  private _buildSnapshot(): I18nInstance {\n    return {\n      ready: this.ready,\n      locale: this.locale,\n      language: this.locale,\n      setLocale: this.setLocale,\n      changeLanguage: this.changeLanguage,\n      t: this.t,\n      missingEvents: this.missingEvents,\n      flushMissing: this.flushMissing,\n    };\n  }\n\n  private _notify(): void {\n    this._snapshot = this._buildSnapshot();\n    for (const l of this._listeners) l();\n  }\n\n  // ---- Lifecycle ----\n\n  /** Default namespace (the first configured one) — used to attribute a\n   *  bare `t(\"key\")` call when recording on-screen keys. */\n  get defaultNamespace(): string {\n    return this._config.namespaces[0]!;\n  }\n\n  /** Loads the configured namespaces for the active locale + fallback. */\n  async start(fetchImpl: typeof fetch = fetch): Promise<void> {\n    // Publish the on-screen key registry so a mounted feedback widget\n    // lists only the strings rendered on the current view (spec ltm 373).\n    keyRegistry.attach();\n    const targets = new Set<string>([this.locale]);\n    if (this.fallbackLng) targets.add(this.fallbackLng);\n    await Promise.all(\n      [...targets].flatMap((loc) =>\n        this._config.namespaces.map((ns) => this._loadBundle(loc, ns, fetchImpl))\n      )\n    );\n    this.ready = true;\n    this._startTimer();\n    // Product model (ltm 341): an SDK serving a *promoted production*\n    // version (`env: \"prod\"`) NEVER opens a Centrifugo WS — prod freshness\n    // is the CDN `latest/` alias at max-age=60s. Realtime + the\n    // `translations_published` cache-bust are a DEV-version feature only\n    // (bounded connection count, no large prod realtime fleet). The\n    // missing-key POST still fires in prod — it's HTTP, not WS, and is\n    // gated separately. `_startLive` also no-ops when `centrifugoWsUrl`\n    // is unset.\n    if (this._config.liveUpdates && this._config.env === \"dev\") {\n      this._startLive(fetchImpl);\n    }\n    this._notify();\n  }\n\n  setLocale = async (next: Locale): Promise<void> => {\n    if (next === this.locale) return;\n    this.locale = next;\n    this.ready = false;\n    this._notify();\n    await Promise.all(\n      this._config.namespaces.map((ns) => this._loadBundle(next, ns))\n    );\n    this.ready = true;\n    this._notify();\n  };\n\n  /** Alias of {@link setLocale} for react-i18next compatibility. */\n  changeLanguage = (next: Locale): Promise<void> => this.setLocale(next);\n\n  /** Alias of {@link locale} for react-i18next compatibility. */\n  get language(): Locale {\n    return this.locale;\n  }\n\n  stop(): void {\n    keyRegistry.detach();\n    if (this._timer) {\n      clearInterval(this._timer);\n      this._timer = null;\n    }\n    if (this._live) {\n      this._live.dispose();\n      this._live = null;\n    }\n  }\n\n  /**\n   * Start the Centrifugo subscription and re-fetch the relevant bundle on\n   * each `translations_published` event. Best-effort: if the WS URL or\n   * token endpoint isn't reachable, we log silently and the SDK continues\n   * to serve the initial bundle.\n   */\n  private _startLive(fetchImpl: typeof fetch): void {\n    const wsUrl = this._config.centrifugoWsUrl;\n    if (!wsUrl) {\n      // No WS URL configured — emit a console warning and stay static.\n      if (typeof console !== \"undefined\") {\n        console.warn(\n          \"@verbumia/react-i18next: liveUpdates=true but centrifugoWsUrl is empty; skipping subscription.\",\n        );\n      }\n      return;\n    }\n    const projectUuid = this._config.projectUuid;\n    const tokenEndpoint = this._config.centrifugoTokenEndpoint;\n    const apiToken = this._config.token;\n\n    const refreshToken = async (): Promise<string> => {\n      const { token } = await fetchCentrifugoToken(\n        tokenEndpoint, projectUuid, apiToken, fetchImpl,\n      );\n      return token;\n    };\n\n    // Bootstrap: fetch the initial token to learn the channel name + token.\n    void (async () => {\n      let channel: string;\n      let token: string;\n      try {\n        const minted = await fetchCentrifugoToken(\n          tokenEndpoint, projectUuid, apiToken, fetchImpl,\n        );\n        channel = minted.channel;\n        token = minted.token;\n      } catch (err) {\n        if (typeof console !== \"undefined\") {\n          console.warn(\"@verbumia/react-i18next: live token mint failed\", err);\n        }\n        return;\n      }\n      this._live = new LiveClient({\n        url: wsUrl,\n        token,\n        channel,\n        refreshToken,\n        onMessage: (data) => this._onLiveMessage(data, fetchImpl),\n      });\n      void this._live.connect();\n    })();\n  }\n\n  private _onLiveMessage(data: unknown, fetchImpl: typeof fetch): void {\n    if (!data || typeof data !== \"object\") return;\n    const d = data as { event?: string; language_code?: string; namespace_slug?: string };\n    if (d.event !== \"translations_published\") return;\n    const lang = d.language_code;\n    const ns = d.namespace_slug;\n    if (!lang || !ns) return;\n    // Only refetch bundles we already loaded — no point pulling a (lang, ns)\n    // pair the app never asked for.\n    const cacheKey = `${lang}/${ns}`;\n    if (!this._attempted.has(cacheKey)) return;\n    // Live republish: the CDN `latest/` alias is mutable and may still be\n    // inside its HTTP max-age window in the browser cache, so a normal\n    // refetch would return the STALE bundle. Force `cache: \"reload\"` to\n    // bypass the HTTP cache and pull the just-published content, then\n    // re-render. (Option-c, task 580.)\n    void this._loadBundle(lang, ns, fetchImpl, { bust: true }).then(() => {\n      this._notify();\n    });\n  }\n\n  // ---- Translation ----\n\n  t = (\n    key: string,\n    optionsOrDefault?:\n      | (Record<string, unknown> & { defaultValue?: string; count?: number })\n      | string,\n    maybeOptions?: Record<string, unknown> & { defaultValue?: string; count?: number },\n  ): string => {\n    // react-i18next-style positional fallback: a string 2nd arg is the\n    // default value. Optional 3rd arg carries interpolation/options and is\n    // merged under it. `t(key, { defaultValue })` keeps working unchanged.\n    const options:\n      | (Record<string, unknown> & { defaultValue?: string; count?: number })\n      | undefined =\n      typeof optionsOrDefault === \"string\"\n        ? { ...(maybeOptions ?? {}), defaultValue: optionsOrDefault }\n        : optionsOrDefault;\n    const namespace = this._splitNamespace(key);\n    const bareKey = namespace.bareKey;\n    const ns = namespace.ns;\n\n    const fromActive = resolve(this._bundles.get(`${this.locale}/${ns}`), bareKey);\n    if (fromActive != null) {\n      return this._render(fromActive, this.locale, options);\n    }\n\n    if (this.fallbackLng && this.fallbackLng !== this.locale) {\n      const fb = resolve(this._bundles.get(`${this.fallbackLng}/${ns}`), bareKey);\n      if (fb != null) {\n        return this._render(fb, this.fallbackLng, options);\n      }\n    }\n\n    // Missing path — only report once we've actually fetched the bundle for\n    // this (locale, ns), otherwise the first paint floods the dashboard.\n    // Three-condition gate: ready + attempted + bundle had content. The\n    // last clause prevents flooding when the bundle came back empty (404\n    // or {}); we'd be reporting against keys we never had a chance to\n    // resolve. Master 2026-05-07 P0: see `_hasContent` doc.\n    if (\n      this.ready &&\n      this._attempted.has(`${this.locale}/${ns}`) &&\n      this._hasContent.has(`${this.locale}/${ns}`)\n    ) {\n      this._reportMissing({\n        key: bareKey,\n        namespace: ns,\n        language_code: this.locale,\n        source_value: this._sourceValueFor(bareKey, ns, options),\n      });\n    }\n    const defaultValue = options?.defaultValue;\n    if (typeof defaultValue === \"string\") {\n      return interpolate(defaultValue, options);\n    }\n    return key;\n  };\n\n  flushMissing = async (): Promise<void> => {\n    if (!this._pending.length) return;\n    const batch = this._pending.slice(0);\n    this._pending = [];\n    if (this._config.missingHandler === \"off\") return;\n    try {\n      await this._transport(batch);\n    } catch {\n      // best-effort\n    }\n  };\n\n  // ---- Internals ----\n\n  /**\n   * Final-stage render: pick the right plural form (when value is a CLDR\n   * dict and `options.count` is a number) then interpolate `{{var}}`.\n   */\n  private _render(\n    value: ResolvedValue,\n    locale: Locale,\n    options?: Record<string, unknown> & { count?: number },\n  ): string {\n    let str: string;\n    if (typeof value === \"string\") {\n      str = value;\n    } else {\n      const count = typeof options?.count === \"number\" ? options.count : 0;\n      str = selectPluralForm(value, count, locale);\n    }\n    return interpolate(str, options);\n  }\n\n  private _splitNamespace(key: string): { ns: Namespace; bareKey: string } {\n    // i18next convention: \"ns:key\"\n    const idx = key.indexOf(\":\");\n    if (idx > 0) {\n      return { ns: key.slice(0, idx), bareKey: key.slice(idx + 1) };\n    }\n    return { ns: this._config.namespaces[0]!, bareKey: key };\n  }\n\n  private async _loadBundle(\n    locale: Locale,\n    ns: Namespace,\n    fetchImpl: typeof fetch = fetch,\n    opts: { bust?: boolean } = {}\n  ): Promise<void> {\n    const cacheKey = `${locale}/${ns}`;\n    // env routing — prod hits the CDN cache; dev hits the live runtime\n    // endpoint authenticated with the API key.\n    let url: string;\n    let init: RequestInit;\n    if (this._config.env === \"dev\") {\n      const params = new URLSearchParams({ language: locale, namespace: ns });\n      if (this._config.versionSlug && this._config.versionSlug !== \"main\") {\n        params.set(\"version_slug\", this._config.versionSlug);\n      }\n      url = `${this._config.apiBase.replace(/\\/+$/, \"\")}/v1/projects/${this._config.projectUuid}/translations/runtime?${params.toString()}`;\n      init = {\n        method: \"GET\",\n        headers: { Authorization: `ApiKey ${this._config.token}` },\n        credentials: \"omit\",\n      };\n    } else {\n      url = `${this._config.cdnBase.replace(/\\/+$/, \"\")}/p/${this._config.projectUuid}/${this._config.versionSlug}/latest/${locale}/${ns}.json`;\n      init = { method: \"GET\", credentials: \"omit\" };\n    }\n    // On a live-republish refetch, bypass the browser HTTP cache so the\n    // mutable `latest/` alias is re-pulled from network even within its\n    // max-age window.\n    if (opts.bust) {\n      init.cache = \"reload\";\n    }\n    // A failed live refetch must NOT downgrade already-good translations to\n    // keys — keep showing the last-known-good bundle. Only the initial\n    // (non-bust) load may cache an empty object as the \"no bundle\" sentinel.\n    const hadContent = this._hasContent.has(cacheKey);\n    try {\n      const r = await fetchImpl(url, init);\n      if (r.ok) {\n        const data = (await r.json()) as Bundle;\n        this._bundles.set(cacheKey, data);\n        if (data && typeof data === \"object\" && Object.keys(data).length > 0) {\n          this._hasContent.add(cacheKey);\n        } else {\n          this._hasContent.delete(cacheKey);\n        }\n      } else if (opts.bust && hadContent) {\n        // transient non-OK on a live refetch — keep prior content\n      } else {\n        // 404 = no published bundle yet. Cache an empty object so subsequent\n        // resolve()s short-circuit, but DO NOT flag as having content — the\n        // gate suppresses reportMissing in this state.\n        this._bundles.set(cacheKey, {});\n        this._hasContent.delete(cacheKey);\n      }\n    } catch {\n      if (opts.bust && hadContent) {\n        // transient network error on a live refetch — keep prior content\n      } else {\n        this._bundles.set(cacheKey, {});\n        this._hasContent.delete(cacheKey);\n      }\n    } finally {\n      this._attempted.add(cacheKey);\n    }\n  }\n\n  private _startTimer(): void {\n    if (this._config.missingHandler === \"off\") return;\n    if (typeof setInterval !== \"function\") return;\n    this._timer = setInterval(() => {\n      void this.flushMissing();\n    }, this._config.flushIntervalMs);\n  }\n\n  /**\n   * Resolve the `source_value` we send with a missing-key report.\n   *\n   * Fallback chain (per backend agreement 2026-05-14, task 575):\n   *   1. `options.defaultValue` — explicit developer-provided string.\n   *   2. The fallbackLng bundle's value for this key (typically the\n   *      source/canonical locale). Only used when it resolves to a\n   *      plain string, not a plural CLDR dict.\n   *   3. The bare key itself — last resort so dashboards never render\n   *      a blank `source_value` column.\n   */\n  private _sourceValueFor(\n    bareKey: string,\n    ns: string,\n    options?: { defaultValue?: string }\n  ): string {\n    if (typeof options?.defaultValue === \"string\") {\n      return options.defaultValue;\n    }\n    if (this.fallbackLng && this.fallbackLng !== this.locale) {\n      const fb = resolve(this._bundles.get(`${this.fallbackLng}/${ns}`), bareKey);\n      if (typeof fb === \"string\") {\n        return fb;\n      }\n    }\n    return bareKey;\n  }\n\n  private _reportMissing(event: MissingKeyEvent): void {\n    if (this._config.missingHandler === \"off\") return;\n    const dedupKey = `${event.language_code}/${event.namespace}/${event.key}`;\n    if (this._seen.has(dedupKey)) return;\n    this._seen.add(dedupKey);\n\n    // Push to ring buffer (capped) for in-app inspectors.\n    this.missingEvents = [event, ...this.missingEvents].slice(\n      0,\n      this._config.missingEventsBufferSize\n    );\n    this._pending.push(event);\n    if (this._pending.length >= this._config.flushBatchSize) {\n      void this.flushMissing();\n    }\n    this._notify();\n  }\n}\n","import type { I18nInstance } from \"./types\";\nimport type { VerbumiaI18n } from \"./i18n\";\n\n// Active instance registered by the mounted <VerbumiaProvider>. Lets code\n// OUTSIDE React (utilities, stores, non-component modules) reach the i18n\n// instance the way react-i18next exposes its default singleton.\nlet _active: VerbumiaI18n | null = null;\n\n/** @internal — VerbumiaProvider registers its instance on mount. */\nexport function _setActiveInstance(instance: VerbumiaI18n): void {\n  _active = instance;\n}\n\n/** @internal — VerbumiaProvider clears its instance on unmount. */\nexport function _clearActiveInstance(instance: VerbumiaI18n): void {\n  if (_active === instance) _active = null;\n}\n\n/**\n * Access the active i18n instance OUTSIDE React components — the\n * react-i18next-style standalone singleton (e.g. for `t()`/`changeLanguage()`\n * in plain modules, stores, or helpers).\n *\n * Returns the instance created by the mounted `<VerbumiaProvider>`; throws a\n * clear error if no provider is mounted yet. Assumes a single app-wide\n * provider (the common case); with multiple concurrent providers it returns\n * the most recently mounted one.\n */\nexport function getI18n(): I18nInstance {\n  if (!_active) {\n    throw new Error(\n      \"@verbumia/react-i18next: getI18n() was called before <VerbumiaProvider> mounted (no active i18n instance).\",\n    );\n  }\n  return _active;\n}\n","import { useEffect, useMemo, useRef } from \"react\";\nimport { useI18n, useI18nSnapshot } from \"./provider\";\nimport { keyRegistry } from \"./key-registry\";\nimport type {\n  I18nInstance,\n  TranslationFunction,\n  TranslationOptions,\n} from \"./types\";\n\nexport interface UseTranslationResult {\n  t: TranslationFunction;\n  i18n: I18nInstance;\n}\n\n/** React hook — returns `{ t, i18n }`. Optional `defaultNamespace` lets you\n *  drop the `ns:` prefix on every call.\n *\n *  Every key this hook resolves during a render is recorded into the\n *  on-screen key registry (so a mounted `@verbumia/feedback` widget lists\n *  only the strings rendered on the current view — spec ltm 373). The\n *  contribution is keyed to THIS hook instance and dropped on unmount, so\n *  navigating away removes its keys automatically. */\nexport function useTranslation(defaultNamespace?: string): UseTranslationResult {\n  const i18n = useI18n();\n  const snapshot = useI18nSnapshot();\n\n  // Keys resolved in the CURRENT render pass. The hook body runs before\n  // the component's own `t()` calls, so clearing here yields a set that\n  // reflects exactly this render once the component finishes.\n  const renderedRef = useRef<Set<string>>(new Set());\n  renderedRef.current = new Set<string>();\n  // Opaque, stable token identifying this hook instance in the registry.\n  const tokenRef = useRef<symbol>(Symbol(\"verbumia.t\"));\n\n  const t = useMemo<TranslationFunction>(() => {\n    // Forwards both call shapes — `t(key, opts)` and the react-i18next\n    // positional `t(key, 'Default', opts?)` — straight to `i18n.t`, which\n    // normalizes them. Registry tracking is keyed on the resolved fullKey.\n    const fn = (\n      key: string,\n      optionsOrDefault?: TranslationOptions | string,\n      maybeOptions?: TranslationOptions,\n    ): string => {\n      const fullKey =\n        defaultNamespace && !key.includes(\":\")\n          ? `${defaultNamespace}:${key}`\n          : key;\n      renderedRef.current.add(\n        keyRegistry.encode(fullKey, i18n.defaultNamespace),\n      );\n      return i18n.t(fullKey, optionsOrDefault, maybeOptions);\n    };\n    return fn as TranslationFunction;\n  }, [i18n, defaultNamespace]);\n\n  // After every commit, publish this instance's latest rendered-key set.\n  useEffect(() => {\n    keyRegistry._set(tokenRef.current, renderedRef.current);\n  });\n  // Unmount only: drop this instance entirely so its keys leave the\n  // on-screen snapshot when the component is gone (e.g. route change).\n  useEffect(() => {\n    const token = tokenRef.current;\n    return () => keyRegistry._delete(token);\n  }, []);\n\n  return { t, i18n: snapshot };\n}\n","import { Children, cloneElement, isValidElement, type ReactNode } from \"react\";\nimport { useTranslation } from \"./hooks\";\n\nexport interface TransProps {\n  /** The translation key (optionally `ns:key`). */\n  i18nKey: string;\n  /** Default value if the key is missing — used as the fallback string. */\n  defaults?: string;\n  /** Variables interpolated into `{{var}}` placeholders. */\n  values?: Record<string, unknown>;\n  /** JSX components mapped by 0-based numeric index — `<0>bold</0>` etc. */\n  components?: ReactNode[];\n  /** Optional namespace shortcut. */\n  namespace?: string;\n}\n\n/** Bare-bones Trans component: resolves the key, interpolates values, and\n *  swaps `<0>...</0>` placeholders into the supplied React components.\n *  Keeps the surface minimal — full Trans semantics (nested keys, plural\n *  trees, gender) land in V1.1. */\nexport function Trans({\n  i18nKey,\n  defaults,\n  values,\n  components,\n  namespace,\n}: TransProps) {\n  const { t } = useTranslation(namespace);\n  const raw = t(i18nKey, { ...(values ?? {}), defaultValue: defaults ?? i18nKey });\n  if (!components || !components.length) return <>{raw}</>;\n  return <>{splitOnComponents(raw, components)}</>;\n}\n\nfunction splitOnComponents(text: string, components: ReactNode[]): ReactNode[] {\n  const out: ReactNode[] = [];\n  // Match <N>...</N> where N is a 0-based index into `components`.\n  const re = /<(\\d+)>(.*?)<\\/\\1>/g;\n  let lastIndex = 0;\n  let m: RegExpExecArray | null;\n  while ((m = re.exec(text)) !== null) {\n    if (m.index > lastIndex) out.push(text.slice(lastIndex, m.index));\n    const idx = Number(m[1]);\n    const inner = m[2];\n    const node = components[idx];\n    if (isValidElement(node)) {\n      out.push(\n        cloneElement(node, { key: `t-${m.index}` }, ...Children.toArray(inner ?? \"\"))\n      );\n    } else if (node !== undefined) {\n      out.push(node);\n    } else {\n      out.push(inner ?? \"\");\n    }\n    lastIndex = re.lastIndex;\n  }\n  if (lastIndex < text.length) out.push(text.slice(lastIndex));\n  return out;\n}\n"],"mappings":"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","names":["import_react","import_react","import_jsx_runtime"]}

package/dist/index.d.cts

@@ -25,11 +25,18 @@ interface VerbumiaConfig {
     projectUuid: string;
     /** Namespaces to preload on mount. Defaults to `['common']`. */
     namespaces?: Namespace[];
+    /**
+     * react-i18next-style alias for the default namespace. Convenience for
+     * single-namespace apps: when `namespaces` is omitted, the SDK loads
+     * `[defaultNS]`. Ignored when `namespaces` is provided (use that — its
+     * first entry is the default namespace).
+     */
+    defaultNS?: Namespace;
     /** Initial locale (BCP-47). */
     defaultLocale: Locale;
     /** Fallback locale used when a key is missing in `defaultLocale`. */
     fallbackLng?: Locale;
-    /** Override the API base. Defaults to `https://api.verbumia.ca`. */
+    /** Override the API base. Defaults to `https://api.verbumia.dev`. */
     apiBase?: string;
     /** Override the CDN base. Defaults to `https://cdn.verbumia.ca`. */
     cdnBase?: string;
@@ -127,7 +134,20 @@ interface I18nInstance {
     /** True once the initial namespace bundles loaded for the active locale. */
     ready: boolean;
     locale: Locale;
+    /** Alias of `locale` for react-i18next compatibility. */
+    language: Locale;
     setLocale: (l: Locale) => Promise<void>;
+    /**
+     * Alias of `setLocale` for react-i18next compatibility. Resolves once the
+     * new locale's namespace bundles have loaded.
+     */
+    changeLanguage: (l: Locale) => Promise<void>;
+    /**
+     * Translate a key. Exposed here mainly for out-of-React use via
+     * `getI18n()`; inside components prefer the `t` returned by
+     * `useTranslation()` (it also feeds the on-screen key registry).
+     */
+    t: TranslationFunction;
     /** Recently captured missing-key events (most recent first). */
     missingEvents: MissingKeyEvent[];
     /** Force-flush the missing-key batch now. */
@@ -136,7 +156,16 @@ interface I18nInstance {
 type TranslationOptions = Record<string, unknown> & {
     defaultValue?: string;
 };
-type TranslationFunction = (key: string, options?: TranslationOptions) => string;
+interface TranslationFunction {
+    /**
+     * react-i18next-style positional fallback: `t('key', 'Default text')`,
+     * optionally with interpolation/options as a 3rd argument:
+     * `t('key', 'Hi {{name}}', { name })`.
+     */
+    (key: string, defaultValue: string, options?: TranslationOptions): string;
+    /** Native form: `t('key', { defaultValue, ...interpolation })`. */
+    (key: string, options?: TranslationOptions): string;
+}
 
 interface VerbumiaProviderProps extends VerbumiaConfig {
     children: ReactNode;
@@ -175,6 +204,18 @@ interface TransProps {
  *  trees, gender) land in V1.1. */
 declare function Trans({ i18nKey, defaults, values, components, namespace, }: TransProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Access the active i18n instance OUTSIDE React components — the
+ * react-i18next-style standalone singleton (e.g. for `t()`/`changeLanguage()`
+ * in plain modules, stores, or helpers).
+ *
+ * Returns the instance created by the mounted `<VerbumiaProvider>`; throws a
+ * clear error if no provider is mounted yet. Assumes a single app-wide
+ * provider (the common case); with multiple concurrent providers it returns
+ * the most recently mounted one.
+ */
+declare function getI18n(): I18nInstance;
+
 /** Default transport: POST to `${apiBase}/v1/missing` with the API key. */
 declare function defaultTransport(opts: {
     apiBase: string;
@@ -234,4 +275,4 @@ declare class KeyRegistry {
 /** Process-wide singleton — there is exactly one on-screen registry. */
 declare const keyRegistry: KeyRegistry;
 
-export { type DeclaredKey, type I18nInstance, type Locale, type MissingHandlerMode, type MissingKeyEvent, type Namespace, Trans, type TranslationFunction, type TranslationOptions, type Transport, type VerbumiaConfig, type VerbumiaPlugin, type VerbumiaPluginContext, VerbumiaProvider, defaultTransport, keyRegistry, logTransport, useTranslation };
+export { type DeclaredKey, type I18nInstance, type Locale, type MissingHandlerMode, type MissingKeyEvent, type Namespace, Trans, type TranslationFunction, type TranslationOptions, type Transport, type VerbumiaConfig, type VerbumiaPlugin, type VerbumiaPluginContext, VerbumiaProvider, defaultTransport, getI18n, keyRegistry, logTransport, useTranslation };

package/dist/index.d.ts

@@ -25,11 +25,18 @@ interface VerbumiaConfig {
     projectUuid: string;
     /** Namespaces to preload on mount. Defaults to `['common']`. */
     namespaces?: Namespace[];
+    /**
+     * react-i18next-style alias for the default namespace. Convenience for
+     * single-namespace apps: when `namespaces` is omitted, the SDK loads
+     * `[defaultNS]`. Ignored when `namespaces` is provided (use that — its
+     * first entry is the default namespace).
+     */
+    defaultNS?: Namespace;
     /** Initial locale (BCP-47). */
     defaultLocale: Locale;
     /** Fallback locale used when a key is missing in `defaultLocale`. */
     fallbackLng?: Locale;
-    /** Override the API base. Defaults to `https://api.verbumia.ca`. */
+    /** Override the API base. Defaults to `https://api.verbumia.dev`. */
     apiBase?: string;
     /** Override the CDN base. Defaults to `https://cdn.verbumia.ca`. */
     cdnBase?: string;
@@ -127,7 +134,20 @@ interface I18nInstance {
     /** True once the initial namespace bundles loaded for the active locale. */
     ready: boolean;
     locale: Locale;
+    /** Alias of `locale` for react-i18next compatibility. */
+    language: Locale;
     setLocale: (l: Locale) => Promise<void>;
+    /**
+     * Alias of `setLocale` for react-i18next compatibility. Resolves once the
+     * new locale's namespace bundles have loaded.
+     */
+    changeLanguage: (l: Locale) => Promise<void>;
+    /**
+     * Translate a key. Exposed here mainly for out-of-React use via
+     * `getI18n()`; inside components prefer the `t` returned by
+     * `useTranslation()` (it also feeds the on-screen key registry).
+     */
+    t: TranslationFunction;
     /** Recently captured missing-key events (most recent first). */
     missingEvents: MissingKeyEvent[];
     /** Force-flush the missing-key batch now. */
@@ -136,7 +156,16 @@ interface I18nInstance {
 type TranslationOptions = Record<string, unknown> & {
     defaultValue?: string;
 };
-type TranslationFunction = (key: string, options?: TranslationOptions) => string;
+interface TranslationFunction {
+    /**
+     * react-i18next-style positional fallback: `t('key', 'Default text')`,
+     * optionally with interpolation/options as a 3rd argument:
+     * `t('key', 'Hi {{name}}', { name })`.
+     */
+    (key: string, defaultValue: string, options?: TranslationOptions): string;
+    /** Native form: `t('key', { defaultValue, ...interpolation })`. */
+    (key: string, options?: TranslationOptions): string;
+}
 
 interface VerbumiaProviderProps extends VerbumiaConfig {
     children: ReactNode;
@@ -175,6 +204,18 @@ interface TransProps {
  *  trees, gender) land in V1.1. */
 declare function Trans({ i18nKey, defaults, values, components, namespace, }: TransProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Access the active i18n instance OUTSIDE React components — the
+ * react-i18next-style standalone singleton (e.g. for `t()`/`changeLanguage()`
+ * in plain modules, stores, or helpers).
+ *
+ * Returns the instance created by the mounted `<VerbumiaProvider>`; throws a
+ * clear error if no provider is mounted yet. Assumes a single app-wide
+ * provider (the common case); with multiple concurrent providers it returns
+ * the most recently mounted one.
+ */
+declare function getI18n(): I18nInstance;
+
 /** Default transport: POST to `${apiBase}/v1/missing` with the API key. */
 declare function defaultTransport(opts: {
     apiBase: string;
@@ -234,4 +275,4 @@ declare class KeyRegistry {
 /** Process-wide singleton — there is exactly one on-screen registry. */
 declare const keyRegistry: KeyRegistry;
 
-export { type DeclaredKey, type I18nInstance, type Locale, type MissingHandlerMode, type MissingKeyEvent, type Namespace, Trans, type TranslationFunction, type TranslationOptions, type Transport, type VerbumiaConfig, type VerbumiaPlugin, type VerbumiaPluginContext, VerbumiaProvider, defaultTransport, keyRegistry, logTransport, useTranslation };
+export { type DeclaredKey, type I18nInstance, type Locale, type MissingHandlerMode, type MissingKeyEvent, type Namespace, Trans, type TranslationFunction, type TranslationOptions, type Transport, type VerbumiaConfig, type VerbumiaPlugin, type VerbumiaPluginContext, VerbumiaProvider, defaultTransport, getI18n, keyRegistry, logTransport, useTranslation };

package/dist/index.js

@@ -228,7 +228,7 @@ var KeyRegistry = class {
 var keyRegistry = new KeyRegistry();
 
 // src/i18n.ts
-var DEFAULT_API_BASE = "https://api.verbumia.ca";
+var DEFAULT_API_BASE = "https://api.verbumia.dev";
 var DEFAULT_CDN_BASE = "https://cdn.verbumia.ca";
 var DEFAULT_FLUSH_MS = 5e3;
 var DEFAULT_BATCH = 50;
@@ -325,7 +325,7 @@ var VerbumiaI18n = class {
       missingHandler: config.missingHandler ?? "send",
       token: config.token,
       projectUuid: config.projectUuid,
-      namespaces: config.namespaces?.length ? config.namespaces : ["common"],
+      namespaces: config.namespaces?.length ? config.namespaces : config.defaultNS ? [config.defaultNS] : ["common"],
       flushIntervalMs: config.flushIntervalMs ?? DEFAULT_FLUSH_MS,
       flushBatchSize: config.flushBatchSize ?? DEFAULT_BATCH,
       missingEventsBufferSize: config.missingEventsBufferSize ?? DEFAULT_BUFFER,
@@ -354,7 +354,10 @@ var VerbumiaI18n = class {
     return {
       ready: this.ready,
       locale: this.locale,
+      language: this.locale,
       setLocale: this.setLocale,
+      changeLanguage: this.changeLanguage,
+      t: this.t,
       missingEvents: this.missingEvents,
       flushMissing: this.flushMissing
     };
@@ -397,6 +400,12 @@ var VerbumiaI18n = class {
     this.ready = true;
     this._notify();
   };
+  /** Alias of {@link setLocale} for react-i18next compatibility. */
+  changeLanguage = (next) => this.setLocale(next);
+  /** Alias of {@link locale} for react-i18next compatibility. */
+  get language() {
+    return this.locale;
+  }
   stop() {
     keyRegistry.detach();
     if (this._timer) {
@@ -478,7 +487,8 @@ var VerbumiaI18n = class {
     });
   }
   // ---- Translation ----
-  t = (key, options) => {
+  t = (key, optionsOrDefault, maybeOptions) => {
+    const options = typeof optionsOrDefault === "string" ? { ...maybeOptions ?? {}, defaultValue: optionsOrDefault } : optionsOrDefault;
     const namespace = this._splitNamespace(key);
     const bareKey = namespace.bareKey;
     const ns = namespace.ns;
@@ -633,6 +643,23 @@ var VerbumiaI18n = class {
   }
 };
 
+// src/singleton.ts
+var _active = null;
+function _setActiveInstance(instance) {
+  _active = instance;
+}
+function _clearActiveInstance(instance) {
+  if (_active === instance) _active = null;
+}
+function getI18n() {
+  if (!_active) {
+    throw new Error(
+      "@verbumia/react-i18next: getI18n() was called before <VerbumiaProvider> mounted (no active i18n instance)."
+    );
+  }
+  return _active;
+}
+
 // src/provider.tsx
 import { jsx, jsxs } from "react/jsx-runtime";
 var VerbumiaContext = createContext(null);
@@ -642,11 +669,13 @@ function VerbumiaProvider({
 }) {
   const i18n = useMemo(() => new VerbumiaI18n(config), []);
   useEffect(() => {
+    _setActiveInstance(i18n);
     void i18n.start();
     const teardowns = (config.plugins ?? []).map((p) => p.setup?.({ i18n, config })).filter((t) => typeof t === "function");
     return () => {
       teardowns.forEach((t) => t());
       i18n.stop();
+      _clearActiveInstance(i18n);
     };
   }, [i18n]);
   const value = useMemo(() => ({ i18n }), [i18n]);
@@ -678,13 +707,14 @@ function useTranslation(defaultNamespace) {
   renderedRef.current = /* @__PURE__ */ new Set();
   const tokenRef = useRef(/* @__PURE__ */ Symbol("verbumia.t"));
   const t = useMemo2(() => {
-    return (key, options) => {
+    const fn = (key, optionsOrDefault, maybeOptions) => {
       const fullKey = defaultNamespace && !key.includes(":") ? `${defaultNamespace}:${key}` : key;
       renderedRef.current.add(
         keyRegistry.encode(fullKey, i18n.defaultNamespace)
       );
-      return i18n.t(fullKey, options);
+      return i18n.t(fullKey, optionsOrDefault, maybeOptions);
     };
+    return fn;
   }, [i18n, defaultNamespace]);
   useEffect2(() => {
     keyRegistry._set(tokenRef.current, renderedRef.current);
@@ -739,6 +769,7 @@ export {
   Trans,
   VerbumiaProvider,
   defaultTransport,
+  getI18n,
   keyRegistry,
   logTransport,
   useTranslation

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/provider.tsx","../src/transport.ts","../src/live.ts","../src/key-registry.ts","../src/i18n.ts","../src/hooks.ts","../src/trans.tsx"],"sourcesContent":["import {\n  createContext,\n  Fragment,\n  useContext,\n  useEffect,\n  useMemo,\n  useSyncExternalStore,\n  type ReactNode,\n} from \"react\";\nimport { VerbumiaI18n } from \"./i18n\";\nimport type { I18nInstance, VerbumiaConfig } from \"./types\";\n\ninterface VerbumiaContextValue {\n  i18n: VerbumiaI18n;\n}\n\nconst VerbumiaContext = createContext<VerbumiaContextValue | null>(null);\n\nexport interface VerbumiaProviderProps extends VerbumiaConfig {\n  children: ReactNode;\n}\n\nexport function VerbumiaProvider({\n  children,\n  ...config\n}: VerbumiaProviderProps) {\n  // Stable instance for the lifetime of the provider mount.\n  const i18n = useMemo(() => new VerbumiaI18n(config), []); // eslint-disable-line react-hooks/exhaustive-deps\n\n  useEffect(() => {\n    void i18n.start();\n    // Plugins (e.g. @verbumia/feedback) hook the SAME i18n instance —\n    // no second context. setup() runs once; optional teardown on unmount.\n    const teardowns = (config.plugins ?? [])\n      .map((p) => p.setup?.({ i18n, config }))\n      .filter((t): t is () => void => typeof t === \"function\");\n    return () => {\n      teardowns.forEach((t) => t());\n      i18n.stop();\n    };\n  }, [i18n]); // eslint-disable-line react-hooks/exhaustive-deps\n\n  const value = useMemo<VerbumiaContextValue>(() => ({ i18n }), [i18n]);\n  return (\n    <VerbumiaContext.Provider value={value}>\n      {children}\n      {/* Plugin outlets: isolated sibling leaves AFTER children. Their\n          internal state never propagates to the host app subtree. */}\n      {(config.plugins ?? []).map((p) =>\n        p.render ? <Fragment key={p.name}>{p.render()}</Fragment> : null,\n      )}\n    </VerbumiaContext.Provider>\n  );\n}\n\n/** Internal — used by useTranslation + Trans. */\nexport function useI18n(): VerbumiaI18n {\n  const ctx = useContext(VerbumiaContext);\n  if (!ctx) {\n    throw new Error(\"useTranslation/Trans must be used inside <VerbumiaProvider>\");\n  }\n  return ctx.i18n;\n}\n\n/** Subscribes to the i18n store and returns a snapshot the React tree can render.\n *\n * `getSnapshot` MUST return a stable reference between notifications,\n * otherwise React loops forever (Maximum update depth exceeded). The\n * VerbumiaI18n instance caches its snapshot internally — see\n * `_notify` / `_buildSnapshot`. */\nexport function useI18nSnapshot(): I18nInstance {\n  const i18n = useI18n();\n  return useSyncExternalStore(i18n.subscribe, i18n.getSnapshot, i18n.getSnapshot);\n}\n","import type { MissingKeyEvent, Transport } from \"./types\";\n\nconst SDK_LIB = \"@verbumia/react-i18next\";\nconst SDK_VER = \"0.5.2\";\n\n/** Default transport: POST to `${apiBase}/v1/missing` with the API key. */\nexport function defaultTransport(opts: {\n  apiBase: string;\n  token: string;\n  projectUuid: string;\n}): Transport {\n  return async (batch) => {\n    if (!batch.length) return;\n    const body = {\n      project_uuid: opts.projectUuid,\n      events: batch.map((e) => ({\n        key: e.key,\n        namespace: e.namespace,\n        language_code: e.language_code,\n        source_value: e.source_value,\n        sdk_meta: {\n          lib: SDK_LIB,\n          ver: SDK_VER,\n          ...(typeof window !== \"undefined\"\n            ? { url: window.location?.href }\n            : {}),\n          ...(e.sdk_meta ?? {}),\n        },\n      })),\n    };\n    try {\n      await fetch(`${opts.apiBase.replace(/\\/+$/, \"\")}/v1/missing`, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          Authorization: `ApiKey ${opts.token}`,\n        },\n        body: JSON.stringify(body),\n        // SDKs are best-effort; never block the render path\n        keepalive: true,\n      });\n    } catch {\n      // swallow — missing-key reporting must never break the host app\n    }\n  };\n}\n\n/** Logs each event to console.warn — handy for dev. */\nexport const logTransport: Transport = (batch: MissingKeyEvent[]) => {\n  for (const e of batch) {\n    // eslint-disable-next-line no-console\n    console.warn(\"[verbumia] missing key\", e);\n  }\n};\n","/**\n * Tiny Centrifugo WebSocket client tailored to the Verbumia\n * `translations:` channel. Hand-rolled (no `centrifuge-js` dep) so the SDK\n * stays under 15 KB gzipped — we only need: connect, subscribe, listen.\n *\n * Wire format reference:\n *   https://centrifugal.dev/docs/transports/websocket\n *\n * Lifecycle:\n *   - call connect() with a valid token\n *   - server replies with {push|reply}; we wait for the connect ack\n *   - subscribe(channel) — send subscribe command, wait for ack\n *   - subsequent {push, channel, pub.data} are routed to onMessage\n *   - reconnect with exponential backoff (capped at 30s) on close\n */\n\nexport interface LiveClientConfig {\n  url: string;\n  token: string;\n  channel: string;\n  onMessage: (data: unknown) => void;\n  onStatus?: (status: \"connecting\" | \"connected\" | \"disconnected\") => void;\n  /**\n   * Hook called just before each connect attempt — return a fresh token\n   * (used to refresh a token whose `exp` is close). Defaults to the\n   * static one passed in `token`.\n   */\n  refreshToken?: () => Promise<string>;\n}\n\nexport class LiveClient {\n  private _ws: WebSocket | null = null;\n  private _id = 0;\n  private _backoffMs = 1_000;\n  private _disposed = false;\n  private _connectAcked = false;\n\n  constructor(private readonly cfg: LiveClientConfig) {}\n\n  /** Open the socket and try to subscribe. Idempotent — calling twice is a no-op. */\n  async connect(): Promise<void> {\n    if (this._ws) return;\n    if (this._disposed) return;\n    this.cfg.onStatus?.(\"connecting\");\n    const token = this.cfg.refreshToken ? await this.cfg.refreshToken() : this.cfg.token;\n    // Centrifugo's WebSocket endpoint lives at `/connection/websocket`.\n    // Be forgiving on the input — accept either a bare host\n    // (`wss://centrifugo.example`) or the full path.\n    let url = this.cfg.url;\n    if (!url.includes(\"/connection/websocket\")) {\n      url = url.replace(/\\/+$/, \"\") + \"/connection/websocket\";\n    }\n    const ws = new WebSocket(url);\n    this._ws = ws;\n    this._connectAcked = false;\n\n    ws.onopen = () => {\n      // Centrifugo command: connect with token\n      this._send({ id: ++this._id, connect: { token } });\n    };\n    ws.onmessage = (evt) => this._onFrame(evt.data);\n    ws.onclose = () => this._onClose();\n    ws.onerror = () => {\n      // Let onclose handle the reconnect.\n    };\n  }\n\n  dispose(): void {\n    this._disposed = true;\n    if (this._ws) {\n      try {\n        this._ws.close();\n      } catch {\n        // ignore\n      }\n      this._ws = null;\n    }\n    this.cfg.onStatus?.(\"disconnected\");\n  }\n\n  // ---- internals ----\n\n  private _send(msg: unknown): void {\n    if (!this._ws || this._ws.readyState !== WebSocket.OPEN) return;\n    try {\n      this._ws.send(JSON.stringify(msg));\n    } catch {\n      // ignore — onclose will fire shortly\n    }\n  }\n\n  private _onFrame(raw: unknown): void {\n    let parsed: {\n      id?: number;\n      connect?: { client?: string };\n      subscribe?: unknown;\n      push?: { channel?: string; pub?: { data?: unknown }; sub?: unknown };\n    } | undefined;\n    try {\n      parsed = JSON.parse(raw as string);\n    } catch {\n      return;\n    }\n    if (!parsed || typeof parsed !== \"object\") return;\n    // Centrifugo v2 protocol pings: server periodically sends an empty\n    // object `{}`. Client MUST reply with an empty `{}` to keep the\n    // connection alive — without this the server force-closes after\n    // ~25-30s and we lose pushes silently.\n    if (Object.keys(parsed).length === 0) {\n      this._send({});\n      return;\n    }\n    if (parsed.connect && !this._connectAcked) {\n      this._connectAcked = true;\n      this.cfg.onStatus?.(\"connected\");\n      this._backoffMs = 1_000;\n      // Connection token's `channels` claim auto-subscribes us server-side,\n      // so an explicit subscribe command is unnecessary. We still send it\n      // for back-compat with anonymous-channel deployments where no\n      // server-side subscription was created.\n      this._send({\n        id: ++this._id,\n        subscribe: { channel: this.cfg.channel },\n      });\n      return;\n    }\n    const push = parsed.push;\n    if (push && push.channel === this.cfg.channel && push.pub) {\n      this.cfg.onMessage(push.pub.data);\n    }\n  }\n\n  private _onClose(): void {\n    this._ws = null;\n    this._connectAcked = false;\n    this.cfg.onStatus?.(\"disconnected\");\n    if (this._disposed) return;\n    const delay = this._backoffMs;\n    this._backoffMs = Math.min(this._backoffMs * 2, 30_000);\n    setTimeout(() => {\n      if (!this._disposed) void this.connect();\n    }, delay);\n  }\n}\n\n/**\n * Fetch a fresh Centrifugo connection token from the backend. The\n * endpoint signature matches `POST /v1/auth/centrifugo-token` —\n * `{project_uuid}` body, `{token, channel, ...}` response.\n */\nexport async function fetchCentrifugoToken(\n  endpoint: string,\n  projectUuid: string,\n  authToken: string,\n  fetchImpl: typeof fetch = fetch,\n): Promise<{ token: string; channel: string; expires_at: number }> {\n  const r = await fetchImpl(endpoint, {\n    method: \"POST\",\n    headers: {\n      \"Content-Type\": \"application/json\",\n      Authorization: `ApiKey ${authToken}`,\n    },\n    body: JSON.stringify({ project_uuid: projectUuid }),\n  });\n  if (!r.ok) {\n    throw new Error(`centrifugo-token endpoint ${r.status}: ${await r.text()}`);\n  }\n  return (await r.json()) as { token: string; channel: string; expires_at: number };\n}\n","/**\n * On-screen key registry — the PRODUCER side of the tiny cross-package\n * contract that `@verbumia/feedback` consumes via\n * `globalThis.__verbumia_key_registry__` (see `@verbumia/feedback`'s\n * `core/keys.ts`).\n *\n * Why this exists: the feedback widget must list only the translation\n * strings RENDERED on the current screen (spec ltm 373) — NOT every\n * project string. The widget can't know what's on screen; the i18n SDK\n * does, because it resolves the keys. So the SDK tracks the keys touched\n * by currently-MOUNTED `useTranslation`/`Trans` consumers and exposes\n * them through a minimal global. When a component unmounts (navigation),\n * its keys drop out automatically — so `snapshot()` is always exactly\n * \"what is on screen right now\". Explicit `keys` on the feedback plugin\n * stays a fallback for non-i18n strings; it is NOT \"pass everything\".\n *\n * The published shape is intentionally tiny so any framework port of the\n * i18n SDK can implement the same global without depending on feedback:\n *\n *   globalThis.__verbumia_key_registry__ = {\n *     snapshot(): { namespace: string; key: string }[];\n *     reset(): void;\n *   }\n */\n\nexport interface DeclaredKey {\n  namespace: string;\n  key: string;\n}\n\nconst GLOBAL = \"__verbumia_key_registry__\";\n// Internal id separator. NUL never appears in an i18next namespace or\n// key, so it round-trips even when a key itself contains ':'.\nconst SEP = \"\u0000\";\n\n/** Split an i18next-style `ns:key` (mirrors VerbumiaI18n._splitNamespace). */\nfunction split(fullKey: string, defaultNamespace: string): DeclaredKey {\n  const idx = fullKey.indexOf(\":\");\n  if (idx > 0) {\n    return { namespace: fullKey.slice(0, idx), key: fullKey.slice(idx + 1) };\n  }\n  return { namespace: defaultNamespace, key: fullKey };\n}\n\nclass KeyRegistry {\n  // One Set per mounted hook/Trans instance (keyed by an opaque token).\n  // The on-screen set is the UNION of all live instances' latest render.\n  private _instances = new Map<symbol, Set<string>>();\n  // Provider mounts that have published us onto globalThis. Ref-counted so\n  // a multi-provider tree (or fast unmount/remount in tests) never leaves\n  // a stale global or unpublishes while another provider is still live.\n  private _providers = 0;\n\n  /** Replace an instance's contributed key set (called every render). */\n  _set(token: symbol, keys: Set<string>): void {\n    this._instances.set(token, keys);\n  }\n\n  /** Drop an instance entirely (called on unmount). */\n  _delete(token: symbol): void {\n    this._instances.delete(token);\n  }\n\n  /** Keys rendered by currently-mounted consumers. Stable insertion order. */\n  snapshot(): DeclaredKey[] {\n    const seen = new Set<string>();\n    const out: DeclaredKey[] = [];\n    for (const set of this._instances.values()) {\n      for (const id of set) {\n        if (seen.has(id)) continue;\n        seen.add(id);\n        const c = id.indexOf(SEP);\n        out.push({ namespace: id.slice(0, c), key: id.slice(c + 1) });\n      }\n    }\n    return out;\n  }\n\n  /** Escape hatch (router integrations / tests). Mount-tracking already\n   *  handles navigation, so this is rarely needed. */\n  reset(): void {\n    this._instances.clear();\n  }\n\n  /** Encode a resolved key into the internal id used by `_set`. */\n  encode(fullKey: string, defaultNamespace: string): string {\n    const k = split(fullKey, defaultNamespace);\n    return `${k.namespace}${SEP}${k.key}`;\n  }\n\n  /** Provider mounted — publish the global (idempotent, ref-counted). */\n  attach(): void {\n    this._providers += 1;\n    if (this._providers === 1) {\n      (globalThis as Record<string, unknown>)[GLOBAL] = {\n        snapshot: () => this.snapshot(),\n        reset: () => this.reset(),\n      };\n    }\n  }\n\n  /** Provider unmounted — unpublish when the last one goes away. */\n  detach(): void {\n    this._providers = Math.max(0, this._providers - 1);\n    if (this._providers === 0) {\n      this._instances.clear();\n      const g = globalThis as Record<string, unknown>;\n      if (g[GLOBAL]) delete g[GLOBAL];\n    }\n  }\n}\n\n/** Process-wide singleton — there is exactly one on-screen registry. */\nexport const keyRegistry = new KeyRegistry();\n","import type {\n  I18nInstance,\n  Locale,\n  MissingKeyEvent,\n  Namespace,\n  Transport,\n  VerbumiaConfig,\n} from \"./types\";\nimport { defaultTransport, logTransport } from \"./transport\";\nimport { LiveClient, fetchCentrifugoToken } from \"./live\";\nimport { keyRegistry } from \"./key-registry\";\n\nconst DEFAULT_API_BASE = \"https://api.verbumia.ca\";\nconst DEFAULT_CDN_BASE = \"https://cdn.verbumia.ca\";\nconst DEFAULT_FLUSH_MS = 5_000;\nconst DEFAULT_BATCH = 50;\nconst DEFAULT_BUFFER = 200;\nconst DEFAULT_VERSION_SLUG = \"main\";\n\ntype Bundle = Record<string, unknown>;\ntype Listener = () => void;\n\ntype PluralForms = Record<string, string>;\ntype ResolvedValue = string | PluralForms;\n\n/**\n * Plural-form objects mirror the CLDR `Intl.PluralRules` categories. Treat\n * any object whose keys overlap the CLDR set AND whose values are all\n * strings as a plural object — the chunky type guard keeps stray nested\n * namespaces from being misread.\n */\nconst CLDR_CATEGORIES = new Set<string>([\n  \"zero\", \"one\", \"two\", \"few\", \"many\", \"other\",\n]);\n\nfunction isPluralForms(v: unknown): v is PluralForms {\n  if (!v || typeof v !== \"object\" || Array.isArray(v)) return false;\n  const keys = Object.keys(v as object);\n  if (keys.length === 0) return false;\n  if (!keys.some((k) => CLDR_CATEGORIES.has(k))) return false;\n  return keys.every(\n    (k) => typeof (v as Record<string, unknown>)[k] === \"string\",\n  );\n}\n\n/** Resolve a dotted key against a deeply-nested bundle. Returns either a\n *  plain string OR a CLDR plural-forms dict so the caller can pick a form. */\nfunction resolve(bundle: Bundle | undefined, key: string): ResolvedValue | undefined {\n  if (!bundle) return undefined;\n  const parts = key.split(\".\");\n  let cur: unknown = bundle;\n  for (const p of parts) {\n    if (cur && typeof cur === \"object\" && p in (cur as Record<string, unknown>)) {\n      cur = (cur as Record<string, unknown>)[p];\n    } else {\n      return undefined;\n    }\n  }\n  if (typeof cur === \"string\") return cur;\n  if (isPluralForms(cur)) return cur;\n  return undefined;\n}\n\n/**\n * Pick the right CLDR form for `count` against the active locale's plural\n * rules. Falls back to `other` (always required by the contract) and then\n * the first available form so we never render nothing for a configured key.\n */\nfunction selectPluralForm(\n  forms: PluralForms,\n  count: number,\n  locale: string,\n): string {\n  let category: string = \"other\";\n  try {\n    if (typeof Intl !== \"undefined\" && typeof Intl.PluralRules === \"function\") {\n      category = new Intl.PluralRules(locale).select(count);\n    }\n  } catch {\n    // Bad locale tag — fall through to \"other\".\n  }\n  if (category in forms) return forms[category]!;\n  if (\"other\" in forms) return forms[\"other\"]!;\n  const first = Object.keys(forms)[0];\n  return first ? forms[first]! : \"\";\n}\n\n/** Cheap interpolation: replaces `{{name}}` with `options[name]`. */\nfunction interpolate(template: string, options?: Record<string, unknown>): string {\n  if (!options) return template;\n  return template.replace(/\\{\\{\\s*([a-zA-Z0-9_]+)\\s*\\}\\}/g, (_m, name) => {\n    const v = options[name];\n    return v == null ? \"\" : String(v);\n  });\n}\n\n/** A single ready-state + bundle store + missing-key buffer wrapped behind\n *  a tiny pub-sub so React can subscribe via useSyncExternalStore. */\nexport class VerbumiaI18n implements I18nInstance {\n  ready = false;\n  locale: Locale;\n  fallbackLng: Locale | undefined;\n  missingEvents: MissingKeyEvent[] = [];\n\n  private _bundles = new Map<string, Bundle>(); // `${locale}/${ns}` -> tree\n  private _attempted = new Set<string>(); // `${locale}/${ns}` keys we've fetched\n  // Tighter gate than `_attempted`: this set only contains (locale, ns)\n  // pairs whose CDN response was 200 with at least one top-level key. An\n  // empty bundle (404 → {} OR 200 → {}) is treated as \"no data yet\";\n  // calling t() against a key in such a bundle does NOT fire reportMissing.\n  // Prevents the \"boot floods the dashboard\" failure when the project has\n  // a brand-new namespace not yet published, OR when a network blip\n  // produced an empty bundle.\n  private _hasContent = new Set<string>();\n  private _config: Required<\n    Pick<VerbumiaConfig, \"apiBase\" | \"cdnBase\" | \"missingHandler\">\n  > & {\n    token: string;\n    projectUuid: string;\n    namespaces: string[];\n    flushIntervalMs: number;\n    flushBatchSize: number;\n    missingEventsBufferSize: number;\n    versionSlug: string;\n    liveUpdates: boolean;\n    centrifugoTokenEndpoint: string;\n    centrifugoWsUrl: string;\n    env: \"prod\" | \"dev\";\n  };\n\n  private _transport: Transport;\n  private _pending: MissingKeyEvent[] = [];\n  private _seen = new Set<string>(); // dedup `${locale}/${ns}/${key}` per-flush\n  private _timer: ReturnType<typeof setInterval> | null = null;\n  private _listeners = new Set<Listener>();\n  private _live: LiveClient | null = null;\n  // Stable snapshot reference for useSyncExternalStore. Returning a fresh\n  // object on each getSnapshot call would loop React forever — we rebuild\n  // it ONLY in _notify (when state actually changed) and return the cached\n  // reference between notifications.\n  private _snapshot!: I18nInstance;\n\n  constructor(config: VerbumiaConfig) {\n    this.locale = config.defaultLocale;\n    this.fallbackLng = config.fallbackLng;\n    this._config = {\n      apiBase: config.apiBase ?? DEFAULT_API_BASE,\n      cdnBase: config.cdnBase ?? DEFAULT_CDN_BASE,\n      missingHandler: config.missingHandler ?? \"send\",\n      token: config.token,\n      projectUuid: config.projectUuid,\n      namespaces: config.namespaces?.length ? config.namespaces : [\"common\"],\n      flushIntervalMs: config.flushIntervalMs ?? DEFAULT_FLUSH_MS,\n      flushBatchSize: config.flushBatchSize ?? DEFAULT_BATCH,\n      missingEventsBufferSize:\n        config.missingEventsBufferSize ?? DEFAULT_BUFFER,\n      versionSlug: config.versionSlug ?? DEFAULT_VERSION_SLUG,\n      liveUpdates: !!config.liveUpdates,\n      centrifugoTokenEndpoint:\n        config.centrifugoTokenEndpoint ??\n        `${(config.apiBase ?? DEFAULT_API_BASE).replace(/\\/+$/, \"\")}/v1/auth/centrifugo-token`,\n      centrifugoWsUrl: config.centrifugoWsUrl ?? \"\",\n      env: config.env ?? \"prod\",\n    };\n\n    this._transport =\n      config.transport ??\n      (this._config.missingHandler === \"log\"\n        ? logTransport\n        : defaultTransport({\n            apiBase: this._config.apiBase,\n            token: this._config.token,\n            projectUuid: this._config.projectUuid,\n          }));\n    this._snapshot = this._buildSnapshot();\n  }\n\n  // ---- React subscription ----\n\n  subscribe = (listener: Listener): (() => void) => {\n    this._listeners.add(listener);\n    return () => this._listeners.delete(listener) as unknown as void;\n  };\n\n  /** Stable snapshot accessor for useSyncExternalStore. The returned\n   *  object reference is identical between renders unless _notify fired. */\n  getSnapshot = (): I18nInstance => this._snapshot;\n\n  private _buildSnapshot(): I18nInstance {\n    return {\n      ready: this.ready,\n      locale: this.locale,\n      setLocale: this.setLocale,\n      missingEvents: this.missingEvents,\n      flushMissing: this.flushMissing,\n    };\n  }\n\n  private _notify(): void {\n    this._snapshot = this._buildSnapshot();\n    for (const l of this._listeners) l();\n  }\n\n  // ---- Lifecycle ----\n\n  /** Default namespace (the first configured one) — used to attribute a\n   *  bare `t(\"key\")` call when recording on-screen keys. */\n  get defaultNamespace(): string {\n    return this._config.namespaces[0]!;\n  }\n\n  /** Loads the configured namespaces for the active locale + fallback. */\n  async start(fetchImpl: typeof fetch = fetch): Promise<void> {\n    // Publish the on-screen key registry so a mounted feedback widget\n    // lists only the strings rendered on the current view (spec ltm 373).\n    keyRegistry.attach();\n    const targets = new Set<string>([this.locale]);\n    if (this.fallbackLng) targets.add(this.fallbackLng);\n    await Promise.all(\n      [...targets].flatMap((loc) =>\n        this._config.namespaces.map((ns) => this._loadBundle(loc, ns, fetchImpl))\n      )\n    );\n    this.ready = true;\n    this._startTimer();\n    // Product model (ltm 341): an SDK serving a *promoted production*\n    // version (`env: \"prod\"`) NEVER opens a Centrifugo WS — prod freshness\n    // is the CDN `latest/` alias at max-age=60s. Realtime + the\n    // `translations_published` cache-bust are a DEV-version feature only\n    // (bounded connection count, no large prod realtime fleet). The\n    // missing-key POST still fires in prod — it's HTTP, not WS, and is\n    // gated separately. `_startLive` also no-ops when `centrifugoWsUrl`\n    // is unset.\n    if (this._config.liveUpdates && this._config.env === \"dev\") {\n      this._startLive(fetchImpl);\n    }\n    this._notify();\n  }\n\n  setLocale = async (next: Locale): Promise<void> => {\n    if (next === this.locale) return;\n    this.locale = next;\n    this.ready = false;\n    this._notify();\n    await Promise.all(\n      this._config.namespaces.map((ns) => this._loadBundle(next, ns))\n    );\n    this.ready = true;\n    this._notify();\n  };\n\n  stop(): void {\n    keyRegistry.detach();\n    if (this._timer) {\n      clearInterval(this._timer);\n      this._timer = null;\n    }\n    if (this._live) {\n      this._live.dispose();\n      this._live = null;\n    }\n  }\n\n  /**\n   * Start the Centrifugo subscription and re-fetch the relevant bundle on\n   * each `translations_published` event. Best-effort: if the WS URL or\n   * token endpoint isn't reachable, we log silently and the SDK continues\n   * to serve the initial bundle.\n   */\n  private _startLive(fetchImpl: typeof fetch): void {\n    const wsUrl = this._config.centrifugoWsUrl;\n    if (!wsUrl) {\n      // No WS URL configured — emit a console warning and stay static.\n      if (typeof console !== \"undefined\") {\n        console.warn(\n          \"@verbumia/react-i18next: liveUpdates=true but centrifugoWsUrl is empty; skipping subscription.\",\n        );\n      }\n      return;\n    }\n    const projectUuid = this._config.projectUuid;\n    const tokenEndpoint = this._config.centrifugoTokenEndpoint;\n    const apiToken = this._config.token;\n\n    const refreshToken = async (): Promise<string> => {\n      const { token } = await fetchCentrifugoToken(\n        tokenEndpoint, projectUuid, apiToken, fetchImpl,\n      );\n      return token;\n    };\n\n    // Bootstrap: fetch the initial token to learn the channel name + token.\n    void (async () => {\n      let channel: string;\n      let token: string;\n      try {\n        const minted = await fetchCentrifugoToken(\n          tokenEndpoint, projectUuid, apiToken, fetchImpl,\n        );\n        channel = minted.channel;\n        token = minted.token;\n      } catch (err) {\n        if (typeof console !== \"undefined\") {\n          console.warn(\"@verbumia/react-i18next: live token mint failed\", err);\n        }\n        return;\n      }\n      this._live = new LiveClient({\n        url: wsUrl,\n        token,\n        channel,\n        refreshToken,\n        onMessage: (data) => this._onLiveMessage(data, fetchImpl),\n      });\n      void this._live.connect();\n    })();\n  }\n\n  private _onLiveMessage(data: unknown, fetchImpl: typeof fetch): void {\n    if (!data || typeof data !== \"object\") return;\n    const d = data as { event?: string; language_code?: string; namespace_slug?: string };\n    if (d.event !== \"translations_published\") return;\n    const lang = d.language_code;\n    const ns = d.namespace_slug;\n    if (!lang || !ns) return;\n    // Only refetch bundles we already loaded — no point pulling a (lang, ns)\n    // pair the app never asked for.\n    const cacheKey = `${lang}/${ns}`;\n    if (!this._attempted.has(cacheKey)) return;\n    // Live republish: the CDN `latest/` alias is mutable and may still be\n    // inside its HTTP max-age window in the browser cache, so a normal\n    // refetch would return the STALE bundle. Force `cache: \"reload\"` to\n    // bypass the HTTP cache and pull the just-published content, then\n    // re-render. (Option-c, task 580.)\n    void this._loadBundle(lang, ns, fetchImpl, { bust: true }).then(() => {\n      this._notify();\n    });\n  }\n\n  // ---- Translation ----\n\n  t = (key: string, options?: Record<string, unknown> & { defaultValue?: string; count?: number }): string => {\n    const namespace = this._splitNamespace(key);\n    const bareKey = namespace.bareKey;\n    const ns = namespace.ns;\n\n    const fromActive = resolve(this._bundles.get(`${this.locale}/${ns}`), bareKey);\n    if (fromActive != null) {\n      return this._render(fromActive, this.locale, options);\n    }\n\n    if (this.fallbackLng && this.fallbackLng !== this.locale) {\n      const fb = resolve(this._bundles.get(`${this.fallbackLng}/${ns}`), bareKey);\n      if (fb != null) {\n        return this._render(fb, this.fallbackLng, options);\n      }\n    }\n\n    // Missing path — only report once we've actually fetched the bundle for\n    // this (locale, ns), otherwise the first paint floods the dashboard.\n    // Three-condition gate: ready + attempted + bundle had content. The\n    // last clause prevents flooding when the bundle came back empty (404\n    // or {}); we'd be reporting against keys we never had a chance to\n    // resolve. Master 2026-05-07 P0: see `_hasContent` doc.\n    if (\n      this.ready &&\n      this._attempted.has(`${this.locale}/${ns}`) &&\n      this._hasContent.has(`${this.locale}/${ns}`)\n    ) {\n      this._reportMissing({\n        key: bareKey,\n        namespace: ns,\n        language_code: this.locale,\n        source_value: this._sourceValueFor(bareKey, ns, options),\n      });\n    }\n    const defaultValue = options?.defaultValue;\n    if (typeof defaultValue === \"string\") {\n      return interpolate(defaultValue, options);\n    }\n    return key;\n  };\n\n  flushMissing = async (): Promise<void> => {\n    if (!this._pending.length) return;\n    const batch = this._pending.slice(0);\n    this._pending = [];\n    if (this._config.missingHandler === \"off\") return;\n    try {\n      await this._transport(batch);\n    } catch {\n      // best-effort\n    }\n  };\n\n  // ---- Internals ----\n\n  /**\n   * Final-stage render: pick the right plural form (when value is a CLDR\n   * dict and `options.count` is a number) then interpolate `{{var}}`.\n   */\n  private _render(\n    value: ResolvedValue,\n    locale: Locale,\n    options?: Record<string, unknown> & { count?: number },\n  ): string {\n    let str: string;\n    if (typeof value === \"string\") {\n      str = value;\n    } else {\n      const count = typeof options?.count === \"number\" ? options.count : 0;\n      str = selectPluralForm(value, count, locale);\n    }\n    return interpolate(str, options);\n  }\n\n  private _splitNamespace(key: string): { ns: Namespace; bareKey: string } {\n    // i18next convention: \"ns:key\"\n    const idx = key.indexOf(\":\");\n    if (idx > 0) {\n      return { ns: key.slice(0, idx), bareKey: key.slice(idx + 1) };\n    }\n    return { ns: this._config.namespaces[0]!, bareKey: key };\n  }\n\n  private async _loadBundle(\n    locale: Locale,\n    ns: Namespace,\n    fetchImpl: typeof fetch = fetch,\n    opts: { bust?: boolean } = {}\n  ): Promise<void> {\n    const cacheKey = `${locale}/${ns}`;\n    // env routing — prod hits the CDN cache; dev hits the live runtime\n    // endpoint authenticated with the API key.\n    let url: string;\n    let init: RequestInit;\n    if (this._config.env === \"dev\") {\n      const params = new URLSearchParams({ language: locale, namespace: ns });\n      if (this._config.versionSlug && this._config.versionSlug !== \"main\") {\n        params.set(\"version_slug\", this._config.versionSlug);\n      }\n      url = `${this._config.apiBase.replace(/\\/+$/, \"\")}/v1/projects/${this._config.projectUuid}/translations/runtime?${params.toString()}`;\n      init = {\n        method: \"GET\",\n        headers: { Authorization: `ApiKey ${this._config.token}` },\n        credentials: \"omit\",\n      };\n    } else {\n      url = `${this._config.cdnBase.replace(/\\/+$/, \"\")}/p/${this._config.projectUuid}/${this._config.versionSlug}/latest/${locale}/${ns}.json`;\n      init = { method: \"GET\", credentials: \"omit\" };\n    }\n    // On a live-republish refetch, bypass the browser HTTP cache so the\n    // mutable `latest/` alias is re-pulled from network even within its\n    // max-age window.\n    if (opts.bust) {\n      init.cache = \"reload\";\n    }\n    // A failed live refetch must NOT downgrade already-good translations to\n    // keys — keep showing the last-known-good bundle. Only the initial\n    // (non-bust) load may cache an empty object as the \"no bundle\" sentinel.\n    const hadContent = this._hasContent.has(cacheKey);\n    try {\n      const r = await fetchImpl(url, init);\n      if (r.ok) {\n        const data = (await r.json()) as Bundle;\n        this._bundles.set(cacheKey, data);\n        if (data && typeof data === \"object\" && Object.keys(data).length > 0) {\n          this._hasContent.add(cacheKey);\n        } else {\n          this._hasContent.delete(cacheKey);\n        }\n      } else if (opts.bust && hadContent) {\n        // transient non-OK on a live refetch — keep prior content\n      } else {\n        // 404 = no published bundle yet. Cache an empty object so subsequent\n        // resolve()s short-circuit, but DO NOT flag as having content — the\n        // gate suppresses reportMissing in this state.\n        this._bundles.set(cacheKey, {});\n        this._hasContent.delete(cacheKey);\n      }\n    } catch {\n      if (opts.bust && hadContent) {\n        // transient network error on a live refetch — keep prior content\n      } else {\n        this._bundles.set(cacheKey, {});\n        this._hasContent.delete(cacheKey);\n      }\n    } finally {\n      this._attempted.add(cacheKey);\n    }\n  }\n\n  private _startTimer(): void {\n    if (this._config.missingHandler === \"off\") return;\n    if (typeof setInterval !== \"function\") return;\n    this._timer = setInterval(() => {\n      void this.flushMissing();\n    }, this._config.flushIntervalMs);\n  }\n\n  /**\n   * Resolve the `source_value` we send with a missing-key report.\n   *\n   * Fallback chain (per backend agreement 2026-05-14, task 575):\n   *   1. `options.defaultValue` — explicit developer-provided string.\n   *   2. The fallbackLng bundle's value for this key (typically the\n   *      source/canonical locale). Only used when it resolves to a\n   *      plain string, not a plural CLDR dict.\n   *   3. The bare key itself — last resort so dashboards never render\n   *      a blank `source_value` column.\n   */\n  private _sourceValueFor(\n    bareKey: string,\n    ns: string,\n    options?: { defaultValue?: string }\n  ): string {\n    if (typeof options?.defaultValue === \"string\") {\n      return options.defaultValue;\n    }\n    if (this.fallbackLng && this.fallbackLng !== this.locale) {\n      const fb = resolve(this._bundles.get(`${this.fallbackLng}/${ns}`), bareKey);\n      if (typeof fb === \"string\") {\n        return fb;\n      }\n    }\n    return bareKey;\n  }\n\n  private _reportMissing(event: MissingKeyEvent): void {\n    if (this._config.missingHandler === \"off\") return;\n    const dedupKey = `${event.language_code}/${event.namespace}/${event.key}`;\n    if (this._seen.has(dedupKey)) return;\n    this._seen.add(dedupKey);\n\n    // Push to ring buffer (capped) for in-app inspectors.\n    this.missingEvents = [event, ...this.missingEvents].slice(\n      0,\n      this._config.missingEventsBufferSize\n    );\n    this._pending.push(event);\n    if (this._pending.length >= this._config.flushBatchSize) {\n      void this.flushMissing();\n    }\n    this._notify();\n  }\n}\n","import { useEffect, useMemo, useRef } from \"react\";\nimport { useI18n, useI18nSnapshot } from \"./provider\";\nimport { keyRegistry } from \"./key-registry\";\nimport type { I18nInstance, TranslationFunction } from \"./types\";\n\nexport interface UseTranslationResult {\n  t: TranslationFunction;\n  i18n: I18nInstance;\n}\n\n/** React hook — returns `{ t, i18n }`. Optional `defaultNamespace` lets you\n *  drop the `ns:` prefix on every call.\n *\n *  Every key this hook resolves during a render is recorded into the\n *  on-screen key registry (so a mounted `@verbumia/feedback` widget lists\n *  only the strings rendered on the current view — spec ltm 373). The\n *  contribution is keyed to THIS hook instance and dropped on unmount, so\n *  navigating away removes its keys automatically. */\nexport function useTranslation(defaultNamespace?: string): UseTranslationResult {\n  const i18n = useI18n();\n  const snapshot = useI18nSnapshot();\n\n  // Keys resolved in the CURRENT render pass. The hook body runs before\n  // the component's own `t()` calls, so clearing here yields a set that\n  // reflects exactly this render once the component finishes.\n  const renderedRef = useRef<Set<string>>(new Set());\n  renderedRef.current = new Set<string>();\n  // Opaque, stable token identifying this hook instance in the registry.\n  const tokenRef = useRef<symbol>(Symbol(\"verbumia.t\"));\n\n  const t = useMemo<TranslationFunction>(() => {\n    return (key, options) => {\n      const fullKey =\n        defaultNamespace && !key.includes(\":\")\n          ? `${defaultNamespace}:${key}`\n          : key;\n      renderedRef.current.add(\n        keyRegistry.encode(fullKey, i18n.defaultNamespace),\n      );\n      return i18n.t(fullKey, options);\n    };\n  }, [i18n, defaultNamespace]);\n\n  // After every commit, publish this instance's latest rendered-key set.\n  useEffect(() => {\n    keyRegistry._set(tokenRef.current, renderedRef.current);\n  });\n  // Unmount only: drop this instance entirely so its keys leave the\n  // on-screen snapshot when the component is gone (e.g. route change).\n  useEffect(() => {\n    const token = tokenRef.current;\n    return () => keyRegistry._delete(token);\n  }, []);\n\n  return { t, i18n: snapshot };\n}\n","import { Children, cloneElement, isValidElement, type ReactNode } from \"react\";\nimport { useTranslation } from \"./hooks\";\n\nexport interface TransProps {\n  /** The translation key (optionally `ns:key`). */\n  i18nKey: string;\n  /** Default value if the key is missing — used as the fallback string. */\n  defaults?: string;\n  /** Variables interpolated into `{{var}}` placeholders. */\n  values?: Record<string, unknown>;\n  /** JSX components mapped by 0-based numeric index — `<0>bold</0>` etc. */\n  components?: ReactNode[];\n  /** Optional namespace shortcut. */\n  namespace?: string;\n}\n\n/** Bare-bones Trans component: resolves the key, interpolates values, and\n *  swaps `<0>...</0>` placeholders into the supplied React components.\n *  Keeps the surface minimal — full Trans semantics (nested keys, plural\n *  trees, gender) land in V1.1. */\nexport function Trans({\n  i18nKey,\n  defaults,\n  values,\n  components,\n  namespace,\n}: TransProps) {\n  const { t } = useTranslation(namespace);\n  const raw = t(i18nKey, { ...(values ?? {}), defaultValue: defaults ?? i18nKey });\n  if (!components || !components.length) return <>{raw}</>;\n  return <>{splitOnComponents(raw, components)}</>;\n}\n\nfunction splitOnComponents(text: string, components: ReactNode[]): ReactNode[] {\n  const out: ReactNode[] = [];\n  // Match <N>...</N> where N is a 0-based index into `components`.\n  const re = /<(\\d+)>(.*?)<\\/\\1>/g;\n  let lastIndex = 0;\n  let m: RegExpExecArray | null;\n  while ((m = re.exec(text)) !== null) {\n    if (m.index > lastIndex) out.push(text.slice(lastIndex, m.index));\n    const idx = Number(m[1]);\n    const inner = m[2];\n    const node = components[idx];\n    if (isValidElement(node)) {\n      out.push(\n        cloneElement(node, { key: `t-${m.index}` }, ...Children.toArray(inner ?? \"\"))\n      );\n    } else if (node !== undefined) {\n      out.push(node);\n    } else {\n      out.push(inner ?? \"\");\n    }\n    lastIndex = re.lastIndex;\n  }\n  if (lastIndex < text.length) out.push(text.slice(lastIndex));\n  return out;\n}\n"],"mappings":"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","names":["useEffect","useMemo","useMemo","useEffect","Fragment","jsx"]}
+{"version":3,"sources":["../src/provider.tsx","../src/transport.ts","../src/live.ts","../src/key-registry.ts","../src/i18n.ts","../src/singleton.ts","../src/hooks.ts","../src/trans.tsx"],"sourcesContent":["import {\n  createContext,\n  Fragment,\n  useContext,\n  useEffect,\n  useMemo,\n  useSyncExternalStore,\n  type ReactNode,\n} from \"react\";\nimport { VerbumiaI18n } from \"./i18n\";\nimport { _clearActiveInstance, _setActiveInstance } from \"./singleton\";\nimport type { I18nInstance, VerbumiaConfig } from \"./types\";\n\ninterface VerbumiaContextValue {\n  i18n: VerbumiaI18n;\n}\n\nconst VerbumiaContext = createContext<VerbumiaContextValue | null>(null);\n\nexport interface VerbumiaProviderProps extends VerbumiaConfig {\n  children: ReactNode;\n}\n\nexport function VerbumiaProvider({\n  children,\n  ...config\n}: VerbumiaProviderProps) {\n  // Stable instance for the lifetime of the provider mount.\n  const i18n = useMemo(() => new VerbumiaI18n(config), []); // eslint-disable-line react-hooks/exhaustive-deps\n\n  useEffect(() => {\n    // Register as the active instance so `getI18n()` works outside React.\n    _setActiveInstance(i18n);\n    void i18n.start();\n    // Plugins (e.g. @verbumia/feedback) hook the SAME i18n instance —\n    // no second context. setup() runs once; optional teardown on unmount.\n    const teardowns = (config.plugins ?? [])\n      .map((p) => p.setup?.({ i18n, config }))\n      .filter((t): t is () => void => typeof t === \"function\");\n    return () => {\n      teardowns.forEach((t) => t());\n      i18n.stop();\n      _clearActiveInstance(i18n);\n    };\n  }, [i18n]); // eslint-disable-line react-hooks/exhaustive-deps\n\n  const value = useMemo<VerbumiaContextValue>(() => ({ i18n }), [i18n]);\n  return (\n    <VerbumiaContext.Provider value={value}>\n      {children}\n      {/* Plugin outlets: isolated sibling leaves AFTER children. Their\n          internal state never propagates to the host app subtree. */}\n      {(config.plugins ?? []).map((p) =>\n        p.render ? <Fragment key={p.name}>{p.render()}</Fragment> : null,\n      )}\n    </VerbumiaContext.Provider>\n  );\n}\n\n/** Internal — used by useTranslation + Trans. */\nexport function useI18n(): VerbumiaI18n {\n  const ctx = useContext(VerbumiaContext);\n  if (!ctx) {\n    throw new Error(\"useTranslation/Trans must be used inside <VerbumiaProvider>\");\n  }\n  return ctx.i18n;\n}\n\n/** Subscribes to the i18n store and returns a snapshot the React tree can render.\n *\n * `getSnapshot` MUST return a stable reference between notifications,\n * otherwise React loops forever (Maximum update depth exceeded). The\n * VerbumiaI18n instance caches its snapshot internally — see\n * `_notify` / `_buildSnapshot`. */\nexport function useI18nSnapshot(): I18nInstance {\n  const i18n = useI18n();\n  return useSyncExternalStore(i18n.subscribe, i18n.getSnapshot, i18n.getSnapshot);\n}\n","import type { MissingKeyEvent, Transport } from \"./types\";\n\nconst SDK_LIB = \"@verbumia/react-i18next\";\nconst SDK_VER = \"0.5.2\";\n\n/** Default transport: POST to `${apiBase}/v1/missing` with the API key. */\nexport function defaultTransport(opts: {\n  apiBase: string;\n  token: string;\n  projectUuid: string;\n}): Transport {\n  return async (batch) => {\n    if (!batch.length) return;\n    const body = {\n      project_uuid: opts.projectUuid,\n      events: batch.map((e) => ({\n        key: e.key,\n        namespace: e.namespace,\n        language_code: e.language_code,\n        source_value: e.source_value,\n        sdk_meta: {\n          lib: SDK_LIB,\n          ver: SDK_VER,\n          ...(typeof window !== \"undefined\"\n            ? { url: window.location?.href }\n            : {}),\n          ...(e.sdk_meta ?? {}),\n        },\n      })),\n    };\n    try {\n      await fetch(`${opts.apiBase.replace(/\\/+$/, \"\")}/v1/missing`, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          Authorization: `ApiKey ${opts.token}`,\n        },\n        body: JSON.stringify(body),\n        // SDKs are best-effort; never block the render path\n        keepalive: true,\n      });\n    } catch {\n      // swallow — missing-key reporting must never break the host app\n    }\n  };\n}\n\n/** Logs each event to console.warn — handy for dev. */\nexport const logTransport: Transport = (batch: MissingKeyEvent[]) => {\n  for (const e of batch) {\n    // eslint-disable-next-line no-console\n    console.warn(\"[verbumia] missing key\", e);\n  }\n};\n","/**\n * Tiny Centrifugo WebSocket client tailored to the Verbumia\n * `translations:` channel. Hand-rolled (no `centrifuge-js` dep) so the SDK\n * stays under 15 KB gzipped — we only need: connect, subscribe, listen.\n *\n * Wire format reference:\n *   https://centrifugal.dev/docs/transports/websocket\n *\n * Lifecycle:\n *   - call connect() with a valid token\n *   - server replies with {push|reply}; we wait for the connect ack\n *   - subscribe(channel) — send subscribe command, wait for ack\n *   - subsequent {push, channel, pub.data} are routed to onMessage\n *   - reconnect with exponential backoff (capped at 30s) on close\n */\n\nexport interface LiveClientConfig {\n  url: string;\n  token: string;\n  channel: string;\n  onMessage: (data: unknown) => void;\n  onStatus?: (status: \"connecting\" | \"connected\" | \"disconnected\") => void;\n  /**\n   * Hook called just before each connect attempt — return a fresh token\n   * (used to refresh a token whose `exp` is close). Defaults to the\n   * static one passed in `token`.\n   */\n  refreshToken?: () => Promise<string>;\n}\n\nexport class LiveClient {\n  private _ws: WebSocket | null = null;\n  private _id = 0;\n  private _backoffMs = 1_000;\n  private _disposed = false;\n  private _connectAcked = false;\n\n  constructor(private readonly cfg: LiveClientConfig) {}\n\n  /** Open the socket and try to subscribe. Idempotent — calling twice is a no-op. */\n  async connect(): Promise<void> {\n    if (this._ws) return;\n    if (this._disposed) return;\n    this.cfg.onStatus?.(\"connecting\");\n    const token = this.cfg.refreshToken ? await this.cfg.refreshToken() : this.cfg.token;\n    // Centrifugo's WebSocket endpoint lives at `/connection/websocket`.\n    // Be forgiving on the input — accept either a bare host\n    // (`wss://centrifugo.example`) or the full path.\n    let url = this.cfg.url;\n    if (!url.includes(\"/connection/websocket\")) {\n      url = url.replace(/\\/+$/, \"\") + \"/connection/websocket\";\n    }\n    const ws = new WebSocket(url);\n    this._ws = ws;\n    this._connectAcked = false;\n\n    ws.onopen = () => {\n      // Centrifugo command: connect with token\n      this._send({ id: ++this._id, connect: { token } });\n    };\n    ws.onmessage = (evt) => this._onFrame(evt.data);\n    ws.onclose = () => this._onClose();\n    ws.onerror = () => {\n      // Let onclose handle the reconnect.\n    };\n  }\n\n  dispose(): void {\n    this._disposed = true;\n    if (this._ws) {\n      try {\n        this._ws.close();\n      } catch {\n        // ignore\n      }\n      this._ws = null;\n    }\n    this.cfg.onStatus?.(\"disconnected\");\n  }\n\n  // ---- internals ----\n\n  private _send(msg: unknown): void {\n    if (!this._ws || this._ws.readyState !== WebSocket.OPEN) return;\n    try {\n      this._ws.send(JSON.stringify(msg));\n    } catch {\n      // ignore — onclose will fire shortly\n    }\n  }\n\n  private _onFrame(raw: unknown): void {\n    let parsed: {\n      id?: number;\n      connect?: { client?: string };\n      subscribe?: unknown;\n      push?: { channel?: string; pub?: { data?: unknown }; sub?: unknown };\n    } | undefined;\n    try {\n      parsed = JSON.parse(raw as string);\n    } catch {\n      return;\n    }\n    if (!parsed || typeof parsed !== \"object\") return;\n    // Centrifugo v2 protocol pings: server periodically sends an empty\n    // object `{}`. Client MUST reply with an empty `{}` to keep the\n    // connection alive — without this the server force-closes after\n    // ~25-30s and we lose pushes silently.\n    if (Object.keys(parsed).length === 0) {\n      this._send({});\n      return;\n    }\n    if (parsed.connect && !this._connectAcked) {\n      this._connectAcked = true;\n      this.cfg.onStatus?.(\"connected\");\n      this._backoffMs = 1_000;\n      // Connection token's `channels` claim auto-subscribes us server-side,\n      // so an explicit subscribe command is unnecessary. We still send it\n      // for back-compat with anonymous-channel deployments where no\n      // server-side subscription was created.\n      this._send({\n        id: ++this._id,\n        subscribe: { channel: this.cfg.channel },\n      });\n      return;\n    }\n    const push = parsed.push;\n    if (push && push.channel === this.cfg.channel && push.pub) {\n      this.cfg.onMessage(push.pub.data);\n    }\n  }\n\n  private _onClose(): void {\n    this._ws = null;\n    this._connectAcked = false;\n    this.cfg.onStatus?.(\"disconnected\");\n    if (this._disposed) return;\n    const delay = this._backoffMs;\n    this._backoffMs = Math.min(this._backoffMs * 2, 30_000);\n    setTimeout(() => {\n      if (!this._disposed) void this.connect();\n    }, delay);\n  }\n}\n\n/**\n * Fetch a fresh Centrifugo connection token from the backend. The\n * endpoint signature matches `POST /v1/auth/centrifugo-token` —\n * `{project_uuid}` body, `{token, channel, ...}` response.\n */\nexport async function fetchCentrifugoToken(\n  endpoint: string,\n  projectUuid: string,\n  authToken: string,\n  fetchImpl: typeof fetch = fetch,\n): Promise<{ token: string; channel: string; expires_at: number }> {\n  const r = await fetchImpl(endpoint, {\n    method: \"POST\",\n    headers: {\n      \"Content-Type\": \"application/json\",\n      Authorization: `ApiKey ${authToken}`,\n    },\n    body: JSON.stringify({ project_uuid: projectUuid }),\n  });\n  if (!r.ok) {\n    throw new Error(`centrifugo-token endpoint ${r.status}: ${await r.text()}`);\n  }\n  return (await r.json()) as { token: string; channel: string; expires_at: number };\n}\n","/**\n * On-screen key registry — the PRODUCER side of the tiny cross-package\n * contract that `@verbumia/feedback` consumes via\n * `globalThis.__verbumia_key_registry__` (see `@verbumia/feedback`'s\n * `core/keys.ts`).\n *\n * Why this exists: the feedback widget must list only the translation\n * strings RENDERED on the current screen (spec ltm 373) — NOT every\n * project string. The widget can't know what's on screen; the i18n SDK\n * does, because it resolves the keys. So the SDK tracks the keys touched\n * by currently-MOUNTED `useTranslation`/`Trans` consumers and exposes\n * them through a minimal global. When a component unmounts (navigation),\n * its keys drop out automatically — so `snapshot()` is always exactly\n * \"what is on screen right now\". Explicit `keys` on the feedback plugin\n * stays a fallback for non-i18n strings; it is NOT \"pass everything\".\n *\n * The published shape is intentionally tiny so any framework port of the\n * i18n SDK can implement the same global without depending on feedback:\n *\n *   globalThis.__verbumia_key_registry__ = {\n *     snapshot(): { namespace: string; key: string }[];\n *     reset(): void;\n *   }\n */\n\nexport interface DeclaredKey {\n  namespace: string;\n  key: string;\n}\n\nconst GLOBAL = \"__verbumia_key_registry__\";\n// Internal id separator. NUL never appears in an i18next namespace or\n// key, so it round-trips even when a key itself contains ':'.\nconst SEP = \"\u0000\";\n\n/** Split an i18next-style `ns:key` (mirrors VerbumiaI18n._splitNamespace). */\nfunction split(fullKey: string, defaultNamespace: string): DeclaredKey {\n  const idx = fullKey.indexOf(\":\");\n  if (idx > 0) {\n    return { namespace: fullKey.slice(0, idx), key: fullKey.slice(idx + 1) };\n  }\n  return { namespace: defaultNamespace, key: fullKey };\n}\n\nclass KeyRegistry {\n  // One Set per mounted hook/Trans instance (keyed by an opaque token).\n  // The on-screen set is the UNION of all live instances' latest render.\n  private _instances = new Map<symbol, Set<string>>();\n  // Provider mounts that have published us onto globalThis. Ref-counted so\n  // a multi-provider tree (or fast unmount/remount in tests) never leaves\n  // a stale global or unpublishes while another provider is still live.\n  private _providers = 0;\n\n  /** Replace an instance's contributed key set (called every render). */\n  _set(token: symbol, keys: Set<string>): void {\n    this._instances.set(token, keys);\n  }\n\n  /** Drop an instance entirely (called on unmount). */\n  _delete(token: symbol): void {\n    this._instances.delete(token);\n  }\n\n  /** Keys rendered by currently-mounted consumers. Stable insertion order. */\n  snapshot(): DeclaredKey[] {\n    const seen = new Set<string>();\n    const out: DeclaredKey[] = [];\n    for (const set of this._instances.values()) {\n      for (const id of set) {\n        if (seen.has(id)) continue;\n        seen.add(id);\n        const c = id.indexOf(SEP);\n        out.push({ namespace: id.slice(0, c), key: id.slice(c + 1) });\n      }\n    }\n    return out;\n  }\n\n  /** Escape hatch (router integrations / tests). Mount-tracking already\n   *  handles navigation, so this is rarely needed. */\n  reset(): void {\n    this._instances.clear();\n  }\n\n  /** Encode a resolved key into the internal id used by `_set`. */\n  encode(fullKey: string, defaultNamespace: string): string {\n    const k = split(fullKey, defaultNamespace);\n    return `${k.namespace}${SEP}${k.key}`;\n  }\n\n  /** Provider mounted — publish the global (idempotent, ref-counted). */\n  attach(): void {\n    this._providers += 1;\n    if (this._providers === 1) {\n      (globalThis as Record<string, unknown>)[GLOBAL] = {\n        snapshot: () => this.snapshot(),\n        reset: () => this.reset(),\n      };\n    }\n  }\n\n  /** Provider unmounted — unpublish when the last one goes away. */\n  detach(): void {\n    this._providers = Math.max(0, this._providers - 1);\n    if (this._providers === 0) {\n      this._instances.clear();\n      const g = globalThis as Record<string, unknown>;\n      if (g[GLOBAL]) delete g[GLOBAL];\n    }\n  }\n}\n\n/** Process-wide singleton — there is exactly one on-screen registry. */\nexport const keyRegistry = new KeyRegistry();\n","import type {\n  I18nInstance,\n  Locale,\n  MissingKeyEvent,\n  Namespace,\n  Transport,\n  VerbumiaConfig,\n} from \"./types\";\nimport { defaultTransport, logTransport } from \"./transport\";\nimport { LiveClient, fetchCentrifugoToken } from \"./live\";\nimport { keyRegistry } from \"./key-registry\";\n\nconst DEFAULT_API_BASE = \"https://api.verbumia.dev\";\nconst DEFAULT_CDN_BASE = \"https://cdn.verbumia.ca\";\nconst DEFAULT_FLUSH_MS = 5_000;\nconst DEFAULT_BATCH = 50;\nconst DEFAULT_BUFFER = 200;\nconst DEFAULT_VERSION_SLUG = \"main\";\n\ntype Bundle = Record<string, unknown>;\ntype Listener = () => void;\n\ntype PluralForms = Record<string, string>;\ntype ResolvedValue = string | PluralForms;\n\n/**\n * Plural-form objects mirror the CLDR `Intl.PluralRules` categories. Treat\n * any object whose keys overlap the CLDR set AND whose values are all\n * strings as a plural object — the chunky type guard keeps stray nested\n * namespaces from being misread.\n */\nconst CLDR_CATEGORIES = new Set<string>([\n  \"zero\", \"one\", \"two\", \"few\", \"many\", \"other\",\n]);\n\nfunction isPluralForms(v: unknown): v is PluralForms {\n  if (!v || typeof v !== \"object\" || Array.isArray(v)) return false;\n  const keys = Object.keys(v as object);\n  if (keys.length === 0) return false;\n  if (!keys.some((k) => CLDR_CATEGORIES.has(k))) return false;\n  return keys.every(\n    (k) => typeof (v as Record<string, unknown>)[k] === \"string\",\n  );\n}\n\n/** Resolve a dotted key against a deeply-nested bundle. Returns either a\n *  plain string OR a CLDR plural-forms dict so the caller can pick a form. */\nfunction resolve(bundle: Bundle | undefined, key: string): ResolvedValue | undefined {\n  if (!bundle) return undefined;\n  const parts = key.split(\".\");\n  let cur: unknown = bundle;\n  for (const p of parts) {\n    if (cur && typeof cur === \"object\" && p in (cur as Record<string, unknown>)) {\n      cur = (cur as Record<string, unknown>)[p];\n    } else {\n      return undefined;\n    }\n  }\n  if (typeof cur === \"string\") return cur;\n  if (isPluralForms(cur)) return cur;\n  return undefined;\n}\n\n/**\n * Pick the right CLDR form for `count` against the active locale's plural\n * rules. Falls back to `other` (always required by the contract) and then\n * the first available form so we never render nothing for a configured key.\n */\nfunction selectPluralForm(\n  forms: PluralForms,\n  count: number,\n  locale: string,\n): string {\n  let category: string = \"other\";\n  try {\n    if (typeof Intl !== \"undefined\" && typeof Intl.PluralRules === \"function\") {\n      category = new Intl.PluralRules(locale).select(count);\n    }\n  } catch {\n    // Bad locale tag — fall through to \"other\".\n  }\n  if (category in forms) return forms[category]!;\n  if (\"other\" in forms) return forms[\"other\"]!;\n  const first = Object.keys(forms)[0];\n  return first ? forms[first]! : \"\";\n}\n\n/** Cheap interpolation: replaces `{{name}}` with `options[name]`. */\nfunction interpolate(template: string, options?: Record<string, unknown>): string {\n  if (!options) return template;\n  return template.replace(/\\{\\{\\s*([a-zA-Z0-9_]+)\\s*\\}\\}/g, (_m, name) => {\n    const v = options[name];\n    return v == null ? \"\" : String(v);\n  });\n}\n\n/** A single ready-state + bundle store + missing-key buffer wrapped behind\n *  a tiny pub-sub so React can subscribe via useSyncExternalStore. */\nexport class VerbumiaI18n implements I18nInstance {\n  ready = false;\n  locale: Locale;\n  fallbackLng: Locale | undefined;\n  missingEvents: MissingKeyEvent[] = [];\n\n  private _bundles = new Map<string, Bundle>(); // `${locale}/${ns}` -> tree\n  private _attempted = new Set<string>(); // `${locale}/${ns}` keys we've fetched\n  // Tighter gate than `_attempted`: this set only contains (locale, ns)\n  // pairs whose CDN response was 200 with at least one top-level key. An\n  // empty bundle (404 → {} OR 200 → {}) is treated as \"no data yet\";\n  // calling t() against a key in such a bundle does NOT fire reportMissing.\n  // Prevents the \"boot floods the dashboard\" failure when the project has\n  // a brand-new namespace not yet published, OR when a network blip\n  // produced an empty bundle.\n  private _hasContent = new Set<string>();\n  private _config: Required<\n    Pick<VerbumiaConfig, \"apiBase\" | \"cdnBase\" | \"missingHandler\">\n  > & {\n    token: string;\n    projectUuid: string;\n    namespaces: string[];\n    flushIntervalMs: number;\n    flushBatchSize: number;\n    missingEventsBufferSize: number;\n    versionSlug: string;\n    liveUpdates: boolean;\n    centrifugoTokenEndpoint: string;\n    centrifugoWsUrl: string;\n    env: \"prod\" | \"dev\";\n  };\n\n  private _transport: Transport;\n  private _pending: MissingKeyEvent[] = [];\n  private _seen = new Set<string>(); // dedup `${locale}/${ns}/${key}` per-flush\n  private _timer: ReturnType<typeof setInterval> | null = null;\n  private _listeners = new Set<Listener>();\n  private _live: LiveClient | null = null;\n  // Stable snapshot reference for useSyncExternalStore. Returning a fresh\n  // object on each getSnapshot call would loop React forever — we rebuild\n  // it ONLY in _notify (when state actually changed) and return the cached\n  // reference between notifications.\n  private _snapshot!: I18nInstance;\n\n  constructor(config: VerbumiaConfig) {\n    this.locale = config.defaultLocale;\n    this.fallbackLng = config.fallbackLng;\n    this._config = {\n      apiBase: config.apiBase ?? DEFAULT_API_BASE,\n      cdnBase: config.cdnBase ?? DEFAULT_CDN_BASE,\n      missingHandler: config.missingHandler ?? \"send\",\n      token: config.token,\n      projectUuid: config.projectUuid,\n      namespaces: config.namespaces?.length\n        ? config.namespaces\n        : config.defaultNS\n          ? [config.defaultNS]\n          : [\"common\"],\n      flushIntervalMs: config.flushIntervalMs ?? DEFAULT_FLUSH_MS,\n      flushBatchSize: config.flushBatchSize ?? DEFAULT_BATCH,\n      missingEventsBufferSize:\n        config.missingEventsBufferSize ?? DEFAULT_BUFFER,\n      versionSlug: config.versionSlug ?? DEFAULT_VERSION_SLUG,\n      liveUpdates: !!config.liveUpdates,\n      centrifugoTokenEndpoint:\n        config.centrifugoTokenEndpoint ??\n        `${(config.apiBase ?? DEFAULT_API_BASE).replace(/\\/+$/, \"\")}/v1/auth/centrifugo-token`,\n      centrifugoWsUrl: config.centrifugoWsUrl ?? \"\",\n      env: config.env ?? \"prod\",\n    };\n\n    this._transport =\n      config.transport ??\n      (this._config.missingHandler === \"log\"\n        ? logTransport\n        : defaultTransport({\n            apiBase: this._config.apiBase,\n            token: this._config.token,\n            projectUuid: this._config.projectUuid,\n          }));\n    this._snapshot = this._buildSnapshot();\n  }\n\n  // ---- React subscription ----\n\n  subscribe = (listener: Listener): (() => void) => {\n    this._listeners.add(listener);\n    return () => this._listeners.delete(listener) as unknown as void;\n  };\n\n  /** Stable snapshot accessor for useSyncExternalStore. The returned\n   *  object reference is identical between renders unless _notify fired. */\n  getSnapshot = (): I18nInstance => this._snapshot;\n\n  private _buildSnapshot(): I18nInstance {\n    return {\n      ready: this.ready,\n      locale: this.locale,\n      language: this.locale,\n      setLocale: this.setLocale,\n      changeLanguage: this.changeLanguage,\n      t: this.t,\n      missingEvents: this.missingEvents,\n      flushMissing: this.flushMissing,\n    };\n  }\n\n  private _notify(): void {\n    this._snapshot = this._buildSnapshot();\n    for (const l of this._listeners) l();\n  }\n\n  // ---- Lifecycle ----\n\n  /** Default namespace (the first configured one) — used to attribute a\n   *  bare `t(\"key\")` call when recording on-screen keys. */\n  get defaultNamespace(): string {\n    return this._config.namespaces[0]!;\n  }\n\n  /** Loads the configured namespaces for the active locale + fallback. */\n  async start(fetchImpl: typeof fetch = fetch): Promise<void> {\n    // Publish the on-screen key registry so a mounted feedback widget\n    // lists only the strings rendered on the current view (spec ltm 373).\n    keyRegistry.attach();\n    const targets = new Set<string>([this.locale]);\n    if (this.fallbackLng) targets.add(this.fallbackLng);\n    await Promise.all(\n      [...targets].flatMap((loc) =>\n        this._config.namespaces.map((ns) => this._loadBundle(loc, ns, fetchImpl))\n      )\n    );\n    this.ready = true;\n    this._startTimer();\n    // Product model (ltm 341): an SDK serving a *promoted production*\n    // version (`env: \"prod\"`) NEVER opens a Centrifugo WS — prod freshness\n    // is the CDN `latest/` alias at max-age=60s. Realtime + the\n    // `translations_published` cache-bust are a DEV-version feature only\n    // (bounded connection count, no large prod realtime fleet). The\n    // missing-key POST still fires in prod — it's HTTP, not WS, and is\n    // gated separately. `_startLive` also no-ops when `centrifugoWsUrl`\n    // is unset.\n    if (this._config.liveUpdates && this._config.env === \"dev\") {\n      this._startLive(fetchImpl);\n    }\n    this._notify();\n  }\n\n  setLocale = async (next: Locale): Promise<void> => {\n    if (next === this.locale) return;\n    this.locale = next;\n    this.ready = false;\n    this._notify();\n    await Promise.all(\n      this._config.namespaces.map((ns) => this._loadBundle(next, ns))\n    );\n    this.ready = true;\n    this._notify();\n  };\n\n  /** Alias of {@link setLocale} for react-i18next compatibility. */\n  changeLanguage = (next: Locale): Promise<void> => this.setLocale(next);\n\n  /** Alias of {@link locale} for react-i18next compatibility. */\n  get language(): Locale {\n    return this.locale;\n  }\n\n  stop(): void {\n    keyRegistry.detach();\n    if (this._timer) {\n      clearInterval(this._timer);\n      this._timer = null;\n    }\n    if (this._live) {\n      this._live.dispose();\n      this._live = null;\n    }\n  }\n\n  /**\n   * Start the Centrifugo subscription and re-fetch the relevant bundle on\n   * each `translations_published` event. Best-effort: if the WS URL or\n   * token endpoint isn't reachable, we log silently and the SDK continues\n   * to serve the initial bundle.\n   */\n  private _startLive(fetchImpl: typeof fetch): void {\n    const wsUrl = this._config.centrifugoWsUrl;\n    if (!wsUrl) {\n      // No WS URL configured — emit a console warning and stay static.\n      if (typeof console !== \"undefined\") {\n        console.warn(\n          \"@verbumia/react-i18next: liveUpdates=true but centrifugoWsUrl is empty; skipping subscription.\",\n        );\n      }\n      return;\n    }\n    const projectUuid = this._config.projectUuid;\n    const tokenEndpoint = this._config.centrifugoTokenEndpoint;\n    const apiToken = this._config.token;\n\n    const refreshToken = async (): Promise<string> => {\n      const { token } = await fetchCentrifugoToken(\n        tokenEndpoint, projectUuid, apiToken, fetchImpl,\n      );\n      return token;\n    };\n\n    // Bootstrap: fetch the initial token to learn the channel name + token.\n    void (async () => {\n      let channel: string;\n      let token: string;\n      try {\n        const minted = await fetchCentrifugoToken(\n          tokenEndpoint, projectUuid, apiToken, fetchImpl,\n        );\n        channel = minted.channel;\n        token = minted.token;\n      } catch (err) {\n        if (typeof console !== \"undefined\") {\n          console.warn(\"@verbumia/react-i18next: live token mint failed\", err);\n        }\n        return;\n      }\n      this._live = new LiveClient({\n        url: wsUrl,\n        token,\n        channel,\n        refreshToken,\n        onMessage: (data) => this._onLiveMessage(data, fetchImpl),\n      });\n      void this._live.connect();\n    })();\n  }\n\n  private _onLiveMessage(data: unknown, fetchImpl: typeof fetch): void {\n    if (!data || typeof data !== \"object\") return;\n    const d = data as { event?: string; language_code?: string; namespace_slug?: string };\n    if (d.event !== \"translations_published\") return;\n    const lang = d.language_code;\n    const ns = d.namespace_slug;\n    if (!lang || !ns) return;\n    // Only refetch bundles we already loaded — no point pulling a (lang, ns)\n    // pair the app never asked for.\n    const cacheKey = `${lang}/${ns}`;\n    if (!this._attempted.has(cacheKey)) return;\n    // Live republish: the CDN `latest/` alias is mutable and may still be\n    // inside its HTTP max-age window in the browser cache, so a normal\n    // refetch would return the STALE bundle. Force `cache: \"reload\"` to\n    // bypass the HTTP cache and pull the just-published content, then\n    // re-render. (Option-c, task 580.)\n    void this._loadBundle(lang, ns, fetchImpl, { bust: true }).then(() => {\n      this._notify();\n    });\n  }\n\n  // ---- Translation ----\n\n  t = (\n    key: string,\n    optionsOrDefault?:\n      | (Record<string, unknown> & { defaultValue?: string; count?: number })\n      | string,\n    maybeOptions?: Record<string, unknown> & { defaultValue?: string; count?: number },\n  ): string => {\n    // react-i18next-style positional fallback: a string 2nd arg is the\n    // default value. Optional 3rd arg carries interpolation/options and is\n    // merged under it. `t(key, { defaultValue })` keeps working unchanged.\n    const options:\n      | (Record<string, unknown> & { defaultValue?: string; count?: number })\n      | undefined =\n      typeof optionsOrDefault === \"string\"\n        ? { ...(maybeOptions ?? {}), defaultValue: optionsOrDefault }\n        : optionsOrDefault;\n    const namespace = this._splitNamespace(key);\n    const bareKey = namespace.bareKey;\n    const ns = namespace.ns;\n\n    const fromActive = resolve(this._bundles.get(`${this.locale}/${ns}`), bareKey);\n    if (fromActive != null) {\n      return this._render(fromActive, this.locale, options);\n    }\n\n    if (this.fallbackLng && this.fallbackLng !== this.locale) {\n      const fb = resolve(this._bundles.get(`${this.fallbackLng}/${ns}`), bareKey);\n      if (fb != null) {\n        return this._render(fb, this.fallbackLng, options);\n      }\n    }\n\n    // Missing path — only report once we've actually fetched the bundle for\n    // this (locale, ns), otherwise the first paint floods the dashboard.\n    // Three-condition gate: ready + attempted + bundle had content. The\n    // last clause prevents flooding when the bundle came back empty (404\n    // or {}); we'd be reporting against keys we never had a chance to\n    // resolve. Master 2026-05-07 P0: see `_hasContent` doc.\n    if (\n      this.ready &&\n      this._attempted.has(`${this.locale}/${ns}`) &&\n      this._hasContent.has(`${this.locale}/${ns}`)\n    ) {\n      this._reportMissing({\n        key: bareKey,\n        namespace: ns,\n        language_code: this.locale,\n        source_value: this._sourceValueFor(bareKey, ns, options),\n      });\n    }\n    const defaultValue = options?.defaultValue;\n    if (typeof defaultValue === \"string\") {\n      return interpolate(defaultValue, options);\n    }\n    return key;\n  };\n\n  flushMissing = async (): Promise<void> => {\n    if (!this._pending.length) return;\n    const batch = this._pending.slice(0);\n    this._pending = [];\n    if (this._config.missingHandler === \"off\") return;\n    try {\n      await this._transport(batch);\n    } catch {\n      // best-effort\n    }\n  };\n\n  // ---- Internals ----\n\n  /**\n   * Final-stage render: pick the right plural form (when value is a CLDR\n   * dict and `options.count` is a number) then interpolate `{{var}}`.\n   */\n  private _render(\n    value: ResolvedValue,\n    locale: Locale,\n    options?: Record<string, unknown> & { count?: number },\n  ): string {\n    let str: string;\n    if (typeof value === \"string\") {\n      str = value;\n    } else {\n      const count = typeof options?.count === \"number\" ? options.count : 0;\n      str = selectPluralForm(value, count, locale);\n    }\n    return interpolate(str, options);\n  }\n\n  private _splitNamespace(key: string): { ns: Namespace; bareKey: string } {\n    // i18next convention: \"ns:key\"\n    const idx = key.indexOf(\":\");\n    if (idx > 0) {\n      return { ns: key.slice(0, idx), bareKey: key.slice(idx + 1) };\n    }\n    return { ns: this._config.namespaces[0]!, bareKey: key };\n  }\n\n  private async _loadBundle(\n    locale: Locale,\n    ns: Namespace,\n    fetchImpl: typeof fetch = fetch,\n    opts: { bust?: boolean } = {}\n  ): Promise<void> {\n    const cacheKey = `${locale}/${ns}`;\n    // env routing — prod hits the CDN cache; dev hits the live runtime\n    // endpoint authenticated with the API key.\n    let url: string;\n    let init: RequestInit;\n    if (this._config.env === \"dev\") {\n      const params = new URLSearchParams({ language: locale, namespace: ns });\n      if (this._config.versionSlug && this._config.versionSlug !== \"main\") {\n        params.set(\"version_slug\", this._config.versionSlug);\n      }\n      url = `${this._config.apiBase.replace(/\\/+$/, \"\")}/v1/projects/${this._config.projectUuid}/translations/runtime?${params.toString()}`;\n      init = {\n        method: \"GET\",\n        headers: { Authorization: `ApiKey ${this._config.token}` },\n        credentials: \"omit\",\n      };\n    } else {\n      url = `${this._config.cdnBase.replace(/\\/+$/, \"\")}/p/${this._config.projectUuid}/${this._config.versionSlug}/latest/${locale}/${ns}.json`;\n      init = { method: \"GET\", credentials: \"omit\" };\n    }\n    // On a live-republish refetch, bypass the browser HTTP cache so the\n    // mutable `latest/` alias is re-pulled from network even within its\n    // max-age window.\n    if (opts.bust) {\n      init.cache = \"reload\";\n    }\n    // A failed live refetch must NOT downgrade already-good translations to\n    // keys — keep showing the last-known-good bundle. Only the initial\n    // (non-bust) load may cache an empty object as the \"no bundle\" sentinel.\n    const hadContent = this._hasContent.has(cacheKey);\n    try {\n      const r = await fetchImpl(url, init);\n      if (r.ok) {\n        const data = (await r.json()) as Bundle;\n        this._bundles.set(cacheKey, data);\n        if (data && typeof data === \"object\" && Object.keys(data).length > 0) {\n          this._hasContent.add(cacheKey);\n        } else {\n          this._hasContent.delete(cacheKey);\n        }\n      } else if (opts.bust && hadContent) {\n        // transient non-OK on a live refetch — keep prior content\n      } else {\n        // 404 = no published bundle yet. Cache an empty object so subsequent\n        // resolve()s short-circuit, but DO NOT flag as having content — the\n        // gate suppresses reportMissing in this state.\n        this._bundles.set(cacheKey, {});\n        this._hasContent.delete(cacheKey);\n      }\n    } catch {\n      if (opts.bust && hadContent) {\n        // transient network error on a live refetch — keep prior content\n      } else {\n        this._bundles.set(cacheKey, {});\n        this._hasContent.delete(cacheKey);\n      }\n    } finally {\n      this._attempted.add(cacheKey);\n    }\n  }\n\n  private _startTimer(): void {\n    if (this._config.missingHandler === \"off\") return;\n    if (typeof setInterval !== \"function\") return;\n    this._timer = setInterval(() => {\n      void this.flushMissing();\n    }, this._config.flushIntervalMs);\n  }\n\n  /**\n   * Resolve the `source_value` we send with a missing-key report.\n   *\n   * Fallback chain (per backend agreement 2026-05-14, task 575):\n   *   1. `options.defaultValue` — explicit developer-provided string.\n   *   2. The fallbackLng bundle's value for this key (typically the\n   *      source/canonical locale). Only used when it resolves to a\n   *      plain string, not a plural CLDR dict.\n   *   3. The bare key itself — last resort so dashboards never render\n   *      a blank `source_value` column.\n   */\n  private _sourceValueFor(\n    bareKey: string,\n    ns: string,\n    options?: { defaultValue?: string }\n  ): string {\n    if (typeof options?.defaultValue === \"string\") {\n      return options.defaultValue;\n    }\n    if (this.fallbackLng && this.fallbackLng !== this.locale) {\n      const fb = resolve(this._bundles.get(`${this.fallbackLng}/${ns}`), bareKey);\n      if (typeof fb === \"string\") {\n        return fb;\n      }\n    }\n    return bareKey;\n  }\n\n  private _reportMissing(event: MissingKeyEvent): void {\n    if (this._config.missingHandler === \"off\") return;\n    const dedupKey = `${event.language_code}/${event.namespace}/${event.key}`;\n    if (this._seen.has(dedupKey)) return;\n    this._seen.add(dedupKey);\n\n    // Push to ring buffer (capped) for in-app inspectors.\n    this.missingEvents = [event, ...this.missingEvents].slice(\n      0,\n      this._config.missingEventsBufferSize\n    );\n    this._pending.push(event);\n    if (this._pending.length >= this._config.flushBatchSize) {\n      void this.flushMissing();\n    }\n    this._notify();\n  }\n}\n","import type { I18nInstance } from \"./types\";\nimport type { VerbumiaI18n } from \"./i18n\";\n\n// Active instance registered by the mounted <VerbumiaProvider>. Lets code\n// OUTSIDE React (utilities, stores, non-component modules) reach the i18n\n// instance the way react-i18next exposes its default singleton.\nlet _active: VerbumiaI18n | null = null;\n\n/** @internal — VerbumiaProvider registers its instance on mount. */\nexport function _setActiveInstance(instance: VerbumiaI18n): void {\n  _active = instance;\n}\n\n/** @internal — VerbumiaProvider clears its instance on unmount. */\nexport function _clearActiveInstance(instance: VerbumiaI18n): void {\n  if (_active === instance) _active = null;\n}\n\n/**\n * Access the active i18n instance OUTSIDE React components — the\n * react-i18next-style standalone singleton (e.g. for `t()`/`changeLanguage()`\n * in plain modules, stores, or helpers).\n *\n * Returns the instance created by the mounted `<VerbumiaProvider>`; throws a\n * clear error if no provider is mounted yet. Assumes a single app-wide\n * provider (the common case); with multiple concurrent providers it returns\n * the most recently mounted one.\n */\nexport function getI18n(): I18nInstance {\n  if (!_active) {\n    throw new Error(\n      \"@verbumia/react-i18next: getI18n() was called before <VerbumiaProvider> mounted (no active i18n instance).\",\n    );\n  }\n  return _active;\n}\n","import { useEffect, useMemo, useRef } from \"react\";\nimport { useI18n, useI18nSnapshot } from \"./provider\";\nimport { keyRegistry } from \"./key-registry\";\nimport type {\n  I18nInstance,\n  TranslationFunction,\n  TranslationOptions,\n} from \"./types\";\n\nexport interface UseTranslationResult {\n  t: TranslationFunction;\n  i18n: I18nInstance;\n}\n\n/** React hook — returns `{ t, i18n }`. Optional `defaultNamespace` lets you\n *  drop the `ns:` prefix on every call.\n *\n *  Every key this hook resolves during a render is recorded into the\n *  on-screen key registry (so a mounted `@verbumia/feedback` widget lists\n *  only the strings rendered on the current view — spec ltm 373). The\n *  contribution is keyed to THIS hook instance and dropped on unmount, so\n *  navigating away removes its keys automatically. */\nexport function useTranslation(defaultNamespace?: string): UseTranslationResult {\n  const i18n = useI18n();\n  const snapshot = useI18nSnapshot();\n\n  // Keys resolved in the CURRENT render pass. The hook body runs before\n  // the component's own `t()` calls, so clearing here yields a set that\n  // reflects exactly this render once the component finishes.\n  const renderedRef = useRef<Set<string>>(new Set());\n  renderedRef.current = new Set<string>();\n  // Opaque, stable token identifying this hook instance in the registry.\n  const tokenRef = useRef<symbol>(Symbol(\"verbumia.t\"));\n\n  const t = useMemo<TranslationFunction>(() => {\n    // Forwards both call shapes — `t(key, opts)` and the react-i18next\n    // positional `t(key, 'Default', opts?)` — straight to `i18n.t`, which\n    // normalizes them. Registry tracking is keyed on the resolved fullKey.\n    const fn = (\n      key: string,\n      optionsOrDefault?: TranslationOptions | string,\n      maybeOptions?: TranslationOptions,\n    ): string => {\n      const fullKey =\n        defaultNamespace && !key.includes(\":\")\n          ? `${defaultNamespace}:${key}`\n          : key;\n      renderedRef.current.add(\n        keyRegistry.encode(fullKey, i18n.defaultNamespace),\n      );\n      return i18n.t(fullKey, optionsOrDefault, maybeOptions);\n    };\n    return fn as TranslationFunction;\n  }, [i18n, defaultNamespace]);\n\n  // After every commit, publish this instance's latest rendered-key set.\n  useEffect(() => {\n    keyRegistry._set(tokenRef.current, renderedRef.current);\n  });\n  // Unmount only: drop this instance entirely so its keys leave the\n  // on-screen snapshot when the component is gone (e.g. route change).\n  useEffect(() => {\n    const token = tokenRef.current;\n    return () => keyRegistry._delete(token);\n  }, []);\n\n  return { t, i18n: snapshot };\n}\n","import { Children, cloneElement, isValidElement, type ReactNode } from \"react\";\nimport { useTranslation } from \"./hooks\";\n\nexport interface TransProps {\n  /** The translation key (optionally `ns:key`). */\n  i18nKey: string;\n  /** Default value if the key is missing — used as the fallback string. */\n  defaults?: string;\n  /** Variables interpolated into `{{var}}` placeholders. */\n  values?: Record<string, unknown>;\n  /** JSX components mapped by 0-based numeric index — `<0>bold</0>` etc. */\n  components?: ReactNode[];\n  /** Optional namespace shortcut. */\n  namespace?: string;\n}\n\n/** Bare-bones Trans component: resolves the key, interpolates values, and\n *  swaps `<0>...</0>` placeholders into the supplied React components.\n *  Keeps the surface minimal — full Trans semantics (nested keys, plural\n *  trees, gender) land in V1.1. */\nexport function Trans({\n  i18nKey,\n  defaults,\n  values,\n  components,\n  namespace,\n}: TransProps) {\n  const { t } = useTranslation(namespace);\n  const raw = t(i18nKey, { ...(values ?? {}), defaultValue: defaults ?? i18nKey });\n  if (!components || !components.length) return <>{raw}</>;\n  return <>{splitOnComponents(raw, components)}</>;\n}\n\nfunction splitOnComponents(text: string, components: ReactNode[]): ReactNode[] {\n  const out: ReactNode[] = [];\n  // Match <N>...</N> where N is a 0-based index into `components`.\n  const re = /<(\\d+)>(.*?)<\\/\\1>/g;\n  let lastIndex = 0;\n  let m: RegExpExecArray | null;\n  while ((m = re.exec(text)) !== null) {\n    if (m.index > lastIndex) out.push(text.slice(lastIndex, m.index));\n    const idx = Number(m[1]);\n    const inner = m[2];\n    const node = components[idx];\n    if (isValidElement(node)) {\n      out.push(\n        cloneElement(node, { key: `t-${m.index}` }, ...Children.toArray(inner ?? \"\"))\n      );\n    } else if (node !== undefined) {\n      out.push(node);\n    } else {\n      out.push(inner ?? \"\");\n    }\n    lastIndex = re.lastIndex;\n  }\n  if (lastIndex < text.length) out.push(text.slice(lastIndex));\n  return out;\n}\n"],"mappings":"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","names":["useEffect","useMemo","useMemo","useEffect","Fragment","jsx"]}

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@verbumia/react-i18next",
-  "version": "0.7.0",
-  "description": "React SDK for Verbumia \u2014 translations + realtime missing-key handler.",
+  "version": "0.8.0",
+  "description": "React SDK for Verbumia — translations + realtime missing-key handler.",
   "license": "MIT",
   "homepage": "https://verbumia.ca",
   "repository": {
     "type": "git",
-    "url": "https://github.com/verbumia/verbumia-react-i18next.git"
+    "url": "https://github.com/verbumia/verbumia-sdk.git",
+    "directory": "packages/react-i18next"
   },
   "keywords": [
     "i18n",
@@ -49,16 +50,14 @@
     "typescript": "^5.5.0",
     "vitest": "^2.1.0"
   },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
   "scripts": {
     "build": "tsup",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "pnpm typecheck && pnpm test && pnpm build",
     "pack:dry-run": "pnpm pack --dry-run"
-  },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/",
-    "provenance": true
   }
-}
+}