@verbumia/feedback 0.2.5 → 0.2.7

package/dist/react/index.d.cts

@@ -1,17 +1,43 @@
 import { ReactNode } from 'react';
-import { F as FeedbackClient, D as DeclaredKey } from '../client-CYgwLkiA.cjs';
-export { B as BatchResponse, a as FeedbackConfig, b as FeedbackError, c as FeedbackString, R as RatingInput, S as StringsResponse, d as SuggestionInput, T as TokenBundle } from '../client-CYgwLkiA.cjs';
+import { F as FeedbackClient, D as DeclaredKey } from '../client-D83qhH0O.cjs';
+export { B as BatchResponse, a as FeedbackConfig, b as FeedbackError, c as FeedbackString, R as RatingInput, S as StringsResponse, d as SuggestionInput, T as TokenBundle } from '../client-D83qhH0O.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-export { h as hasKeyRegistry, r as resolveKeys } from '../keys-BQpczt84.cjs';
+export { h as hasKeyRegistry, r as resolveKeys } from '../keys-D4oJtn64.cjs';
 
 /** Structural mirror of `@verbumia/react-i18next`'s VerbumiaPlugin —
- * kept local so feedback has no build-time dep on the i18n SDK. */
+ * kept local so feedback has no build-time dep on the i18n SDK. The
+ * `i18n` and `onLanguageChange` fields are optional so a plugin attached
+ * to a non-Verbumia host (or to a pre-1.0.5 react-i18next) keeps
+ * working — runtime language re-sync is just disabled. From feedback
+ * ≥0.2.6, the peerDep on `@verbumia/react-i18next` is `>=1.0.5`, so the
+ * lang-change subscription path is guaranteed available in matched
+ * installs. */
 interface I18nPluginContext {
+    i18n?: {
+        language?: string;
+        /** 0.2.7 — direct handle on the underlying `i18next` instance the
+         *  `@verbumia/react-i18next` provider exposes. Used by the
+         *  `scope: "current-view"` snapshot path: a same-locale
+         *  `changeLanguage(language)` re-emits `languageChanged` so every
+         *  bound consumer re-renders → `t()` calls repopulate the registry.
+         *  Optional so the plugin still works on non-Verbumia hosts (it
+         *  falls back to a no-rerender registry snapshot in that case). */
+        i18next?: {
+            language?: string;
+            changeLanguage?: (lng: string) => Promise<unknown>;
+        };
+    };
     config: {
         apiBase?: string;
         projectUuid: string;
         defaultLocale: string;
     };
+    /** #806 — subscribe to runtime language changes (see VerbumiaPluginContext
+     *  in `@verbumia/react-i18next` ≥1.0.5). Returns an unsubscribe fn the
+     *  plugin MUST call from teardown. Optional so attaching to a
+     *  pre-1.0.5 react-i18next falls back gracefully (no auto re-sync;
+     *  consumer can still pass `options.language` explicitly). */
+    onLanguageChange?: (cb: (lng: string) => void) => () => void;
 }
 interface I18nPlugin {
     name: string;
@@ -19,10 +45,53 @@ interface I18nPlugin {
     render?: () => ReactNode;
 }
 interface FeedbackController {
-    open: () => void;
+    /**
+     * Opens the panel. From 0.2.7 the call is **async** (returns
+     * `Promise<void>`) so the `scope: "current-view"` snapshot sequence
+     * can run before the modal mounts (reset registry → force
+     * languageChanged → 1-frame yield → snapshot). Hosts that do NOT
+     * await still work — the modal mounts when the promise resolves.
+     * Under `scope: "all"` (or when the i18next instance isn't reachable)
+     * `open()` resolves on the next microtask with no extra work.
+     */
+    open: () => Promise<void>;
     close: () => void;
     /** The underlying client (advanced; usually unused). */
     client: FeedbackClient;
+    /** ToS version currently required by the backend (SDK build-time
+     *  constant — see core/tos.ts). 0.2.7+. */
+    readonly tosVersion: string;
+    /** Whether this end-user has a live session-token bundle (i.e. has
+     *  accepted the current ToS version). Mirrors the same persisted state
+     *  the built-in modal writes to, so an external ToS page that calls
+     *  `acceptTos()` flips this to `true` immediately. 0.2.7+. */
+    readonly hasAcceptedTos: boolean;
+    /** Programmatically POST `/v1/feedback/tos` and persist the returned
+     *  token bundle into the SDK's shared store. Used by hosts that
+     *  build their own ToS page (`feedbackPlugin({ tos: "skip" })`). Thin
+     *  alias over `FeedbackClient.acceptTos()` — idempotent (a second
+     *  call returns the in-flight / existing bundle without re-POSTing).
+     *  0.2.7+. */
+    acceptTos: () => Promise<void>;
+    /** 0.2.7 — feedback-addon active flag for this project, sourced from
+     *  `GET /v1/projects/{p}/feedback-addon/state` + composed with the
+     *  plugin's `cta` option:
+     *    - `cta: "auto"` (default): mirrors `state.isActive` (so a host
+     *      that hides its CTA on `!isActive` does the right thing for
+     *      Starter / no SKU).
+     *    - `cta: "show"`: always `true` (force the host's CTA).
+     *    - `cta: "hide"`: always `false`.
+     *  `null` before the first state fetch resolves (e.g. on a host that
+     *  didn't pass `apiKey` and hasn't accepted ToS yet). */
+    readonly isActive: boolean | null;
+    /** 0.2.7 — the languages the SDK is licensed to rate strings in.
+     *  Mirrors `state.enabledLanguages` verbatim: `string[]` for Starter
+     *  / no SKU, literal `"all"` for Unlimited. `null` before the first
+     *  state fetch resolves. */
+    readonly enabledLanguages: string[] | "all" | null;
+    /** 0.2.7 — raw SKU code (`feedback_starter` / `feedback_unlimited`
+     *  / `null`). Useful for downstream UI / billing dashboards. */
+    readonly sku: "feedback_starter" | "feedback_unlimited" | null;
 }
 interface FeedbackPluginOptions {
     /** Override language; defaults to the i18n provider's defaultLocale. */
@@ -48,6 +117,62 @@ interface FeedbackPluginOptions {
     };
     /** Injected fetch (tests / RN polyfills). */
     fetchImpl?: typeof fetch;
+    /**
+     * 0.2.7 — how the SDK handles the Terms of Service prompt:
+     *   - `"modal"` (DEFAULT, backwards-compatible): the built-in modal
+     *     renders the SDK's ToS step on first open; tapping Accept calls
+     *     `POST /v1/feedback/tos` and persists the token bundle.
+     *   - `"skip"`: the built-in modal SKIPS the ToS step entirely. The
+     *     host promises to handle consent externally (e.g. their own
+     *     branded ToS page) and must call `controller.acceptTos()` to
+     *     mint the session bundle. Until that runs, every `getStrings()`
+     *     surfaces the existing 401 error state (the SDK does NOT
+     *     silently auto-accept on the user's behalf).
+     */
+    tos?: "modal" | "skip";
+    /**
+     * 0.2.7 — host's project API key (`vrb_live_…`, scope `project:read`).
+     * Lets the SDK call `GET /v1/projects/{p}/feedback-addon/state` at
+     * `setup()` time + on language change, BEFORE the end-user accepts
+     * ToS. When omitted, addon-state is deferred until the user's
+     * session bearer is minted via `acceptTos()`, and `controller.isActive`
+     * stays `null` until then.
+     */
+    apiKey?: string;
+    /**
+     * 0.2.7 — controls `controller.isActive` (which hosts wire to their
+     * own CTA's `hidden` flag — the SDK does not render a floating CTA
+     * itself; see plugin.tsx header).
+     *   - `"auto"` (DEFAULT): mirrors `state.isActive` from the backend,
+     *     i.e. hides on Starter / no SKU, shows on Unlimited.
+     *   - `"show"`: forces `isActive=true` regardless of state.
+     *   - `"hide"`: forces `isActive=false` regardless of state.
+     */
+    cta?: "auto" | "show" | "hide";
+    /**
+     * 0.2.7 — what the panel calls "on-screen keys":
+     *   - `"current-view"` (DEFAULT — rebalances the 1.0.3 "strict-better-
+     *     than-false-empty" trade-off now that we have a better mechanism):
+     *     `controller.open()` (now async) resets the on-screen key
+     *     registry, force-emits a same-locale `languageChanged` through
+     *     i18next to re-render every consumer, awaits a 1-frame yield so
+     *     their `t()` calls repopulate the registry, snapshots, then opens
+     *     the modal with that snapshot. Result: the widget lists ONLY keys
+     *     rendered on the user's current screen at the instant they
+     *     opened it.
+     *   - `"all"`: pre-0.2.7 behavior — no reset, no force re-render. The
+     *     panel reads the accumulated registry as-is (still strictly
+     *     better than a false-empty; useful if you want the cumulative
+     *     keys-since-mount view).
+     *
+     * KNOWN LIMITATION (`"current-view"`): components that call
+     * `i18next.t()` OUTSIDE a React tree (cron-like calls, module-load
+     * `t()`) are NOT re-collected by the changeLanguage trigger — they
+     * have nothing to re-render. Acceptable: those calls aren't strictly
+     * "rendered on screen", so excluding them matches the on-screen
+     * contract.
+     */
+    scope?: "current-view" | "all";
 }
 declare function feedbackPlugin(options: FeedbackPluginOptions): I18nPlugin;
 
@@ -55,6 +180,11 @@ declare function FeedbackPanel(props: {
     client: FeedbackClient;
     keys?: DeclaredKey[];
     namespace?: string | string[];
+    /** 0.2.7 — `"skip"` removes the built-in ToS step entirely; the host
+     *  owns consent (via `controller.acceptTos()`). When the user has not
+     *  yet accepted, the strings fetch surfaces a 401-derived error in the
+     *  existing error row. */
+    tos?: "modal" | "skip";
     onClose: () => void;
 }): react_jsx_runtime.JSX.Element;
 

package/dist/react/index.d.ts

@@ -1,17 +1,43 @@
 import { ReactNode } from 'react';
-import { F as FeedbackClient, D as DeclaredKey } from '../client-CYgwLkiA.js';
-export { B as BatchResponse, a as FeedbackConfig, b as FeedbackError, c as FeedbackString, R as RatingInput, S as StringsResponse, d as SuggestionInput, T as TokenBundle } from '../client-CYgwLkiA.js';
+import { F as FeedbackClient, D as DeclaredKey } from '../client-D83qhH0O.js';
+export { B as BatchResponse, a as FeedbackConfig, b as FeedbackError, c as FeedbackString, R as RatingInput, S as StringsResponse, d as SuggestionInput, T as TokenBundle } from '../client-D83qhH0O.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-export { h as hasKeyRegistry, r as resolveKeys } from '../keys-BPAFf8xR.js';
+export { h as hasKeyRegistry, r as resolveKeys } from '../keys-BpVB1kcI.js';
 
 /** Structural mirror of `@verbumia/react-i18next`'s VerbumiaPlugin —
- * kept local so feedback has no build-time dep on the i18n SDK. */
+ * kept local so feedback has no build-time dep on the i18n SDK. The
+ * `i18n` and `onLanguageChange` fields are optional so a plugin attached
+ * to a non-Verbumia host (or to a pre-1.0.5 react-i18next) keeps
+ * working — runtime language re-sync is just disabled. From feedback
+ * ≥0.2.6, the peerDep on `@verbumia/react-i18next` is `>=1.0.5`, so the
+ * lang-change subscription path is guaranteed available in matched
+ * installs. */
 interface I18nPluginContext {
+    i18n?: {
+        language?: string;
+        /** 0.2.7 — direct handle on the underlying `i18next` instance the
+         *  `@verbumia/react-i18next` provider exposes. Used by the
+         *  `scope: "current-view"` snapshot path: a same-locale
+         *  `changeLanguage(language)` re-emits `languageChanged` so every
+         *  bound consumer re-renders → `t()` calls repopulate the registry.
+         *  Optional so the plugin still works on non-Verbumia hosts (it
+         *  falls back to a no-rerender registry snapshot in that case). */
+        i18next?: {
+            language?: string;
+            changeLanguage?: (lng: string) => Promise<unknown>;
+        };
+    };
     config: {
         apiBase?: string;
         projectUuid: string;
         defaultLocale: string;
     };
+    /** #806 — subscribe to runtime language changes (see VerbumiaPluginContext
+     *  in `@verbumia/react-i18next` ≥1.0.5). Returns an unsubscribe fn the
+     *  plugin MUST call from teardown. Optional so attaching to a
+     *  pre-1.0.5 react-i18next falls back gracefully (no auto re-sync;
+     *  consumer can still pass `options.language` explicitly). */
+    onLanguageChange?: (cb: (lng: string) => void) => () => void;
 }
 interface I18nPlugin {
     name: string;
@@ -19,10 +45,53 @@ interface I18nPlugin {
     render?: () => ReactNode;
 }
 interface FeedbackController {
-    open: () => void;
+    /**
+     * Opens the panel. From 0.2.7 the call is **async** (returns
+     * `Promise<void>`) so the `scope: "current-view"` snapshot sequence
+     * can run before the modal mounts (reset registry → force
+     * languageChanged → 1-frame yield → snapshot). Hosts that do NOT
+     * await still work — the modal mounts when the promise resolves.
+     * Under `scope: "all"` (or when the i18next instance isn't reachable)
+     * `open()` resolves on the next microtask with no extra work.
+     */
+    open: () => Promise<void>;
     close: () => void;
     /** The underlying client (advanced; usually unused). */
     client: FeedbackClient;
+    /** ToS version currently required by the backend (SDK build-time
+     *  constant — see core/tos.ts). 0.2.7+. */
+    readonly tosVersion: string;
+    /** Whether this end-user has a live session-token bundle (i.e. has
+     *  accepted the current ToS version). Mirrors the same persisted state
+     *  the built-in modal writes to, so an external ToS page that calls
+     *  `acceptTos()` flips this to `true` immediately. 0.2.7+. */
+    readonly hasAcceptedTos: boolean;
+    /** Programmatically POST `/v1/feedback/tos` and persist the returned
+     *  token bundle into the SDK's shared store. Used by hosts that
+     *  build their own ToS page (`feedbackPlugin({ tos: "skip" })`). Thin
+     *  alias over `FeedbackClient.acceptTos()` — idempotent (a second
+     *  call returns the in-flight / existing bundle without re-POSTing).
+     *  0.2.7+. */
+    acceptTos: () => Promise<void>;
+    /** 0.2.7 — feedback-addon active flag for this project, sourced from
+     *  `GET /v1/projects/{p}/feedback-addon/state` + composed with the
+     *  plugin's `cta` option:
+     *    - `cta: "auto"` (default): mirrors `state.isActive` (so a host
+     *      that hides its CTA on `!isActive` does the right thing for
+     *      Starter / no SKU).
+     *    - `cta: "show"`: always `true` (force the host's CTA).
+     *    - `cta: "hide"`: always `false`.
+     *  `null` before the first state fetch resolves (e.g. on a host that
+     *  didn't pass `apiKey` and hasn't accepted ToS yet). */
+    readonly isActive: boolean | null;
+    /** 0.2.7 — the languages the SDK is licensed to rate strings in.
+     *  Mirrors `state.enabledLanguages` verbatim: `string[]` for Starter
+     *  / no SKU, literal `"all"` for Unlimited. `null` before the first
+     *  state fetch resolves. */
+    readonly enabledLanguages: string[] | "all" | null;
+    /** 0.2.7 — raw SKU code (`feedback_starter` / `feedback_unlimited`
+     *  / `null`). Useful for downstream UI / billing dashboards. */
+    readonly sku: "feedback_starter" | "feedback_unlimited" | null;
 }
 interface FeedbackPluginOptions {
     /** Override language; defaults to the i18n provider's defaultLocale. */
@@ -48,6 +117,62 @@ interface FeedbackPluginOptions {
     };
     /** Injected fetch (tests / RN polyfills). */
     fetchImpl?: typeof fetch;
+    /**
+     * 0.2.7 — how the SDK handles the Terms of Service prompt:
+     *   - `"modal"` (DEFAULT, backwards-compatible): the built-in modal
+     *     renders the SDK's ToS step on first open; tapping Accept calls
+     *     `POST /v1/feedback/tos` and persists the token bundle.
+     *   - `"skip"`: the built-in modal SKIPS the ToS step entirely. The
+     *     host promises to handle consent externally (e.g. their own
+     *     branded ToS page) and must call `controller.acceptTos()` to
+     *     mint the session bundle. Until that runs, every `getStrings()`
+     *     surfaces the existing 401 error state (the SDK does NOT
+     *     silently auto-accept on the user's behalf).
+     */
+    tos?: "modal" | "skip";
+    /**
+     * 0.2.7 — host's project API key (`vrb_live_…`, scope `project:read`).
+     * Lets the SDK call `GET /v1/projects/{p}/feedback-addon/state` at
+     * `setup()` time + on language change, BEFORE the end-user accepts
+     * ToS. When omitted, addon-state is deferred until the user's
+     * session bearer is minted via `acceptTos()`, and `controller.isActive`
+     * stays `null` until then.
+     */
+    apiKey?: string;
+    /**
+     * 0.2.7 — controls `controller.isActive` (which hosts wire to their
+     * own CTA's `hidden` flag — the SDK does not render a floating CTA
+     * itself; see plugin.tsx header).
+     *   - `"auto"` (DEFAULT): mirrors `state.isActive` from the backend,
+     *     i.e. hides on Starter / no SKU, shows on Unlimited.
+     *   - `"show"`: forces `isActive=true` regardless of state.
+     *   - `"hide"`: forces `isActive=false` regardless of state.
+     */
+    cta?: "auto" | "show" | "hide";
+    /**
+     * 0.2.7 — what the panel calls "on-screen keys":
+     *   - `"current-view"` (DEFAULT — rebalances the 1.0.3 "strict-better-
+     *     than-false-empty" trade-off now that we have a better mechanism):
+     *     `controller.open()` (now async) resets the on-screen key
+     *     registry, force-emits a same-locale `languageChanged` through
+     *     i18next to re-render every consumer, awaits a 1-frame yield so
+     *     their `t()` calls repopulate the registry, snapshots, then opens
+     *     the modal with that snapshot. Result: the widget lists ONLY keys
+     *     rendered on the user's current screen at the instant they
+     *     opened it.
+     *   - `"all"`: pre-0.2.7 behavior — no reset, no force re-render. The
+     *     panel reads the accumulated registry as-is (still strictly
+     *     better than a false-empty; useful if you want the cumulative
+     *     keys-since-mount view).
+     *
+     * KNOWN LIMITATION (`"current-view"`): components that call
+     * `i18next.t()` OUTSIDE a React tree (cron-like calls, module-load
+     * `t()`) are NOT re-collected by the changeLanguage trigger — they
+     * have nothing to re-render. Acceptable: those calls aren't strictly
+     * "rendered on screen", so excluding them matches the on-screen
+     * contract.
+     */
+    scope?: "current-view" | "all";
 }
 declare function feedbackPlugin(options: FeedbackPluginOptions): I18nPlugin;
 
@@ -55,6 +180,11 @@ declare function FeedbackPanel(props: {
     client: FeedbackClient;
     keys?: DeclaredKey[];
     namespace?: string | string[];
+    /** 0.2.7 — `"skip"` removes the built-in ToS step entirely; the host
+     *  owns consent (via `controller.acceptTos()`). When the user has not
+     *  yet accepted, the strings fetch surfaces a 401-derived error in the
+     *  existing error row. */
+    tos?: "modal" | "skip";
     onClose: () => void;
 }): react_jsx_runtime.JSX.Element;
 

package/dist/react/index.js

@@ -4,7 +4,7 @@ import {
   FeedbackError,
   hasKeyRegistry,
   resolveKeys
-} from "../chunk-5DZUKJ4M.js";
+} from "../chunk-7KWEI55W.js";
 
 // src/react/plugin.tsx
 import { createPortal } from "react-dom";
@@ -23,8 +23,10 @@ var C = {
   emeraldSoft: "#34d399"
 };
 function FeedbackPanel(props) {
-  const { client, keys, namespace, onClose } = props;
-  const [consented, setConsented] = useState(client.hasConsented);
+  const { client, keys, namespace, tos = "modal", onClose } = props;
+  const [consented, setConsented] = useState(
+    tos === "skip" ? true : client.hasConsented
+  );
   const [busy, setBusy] = useState(false);
   const [error, setError] = useState(null);
   const [strings, setStrings] = useState([]);
@@ -310,42 +312,73 @@ function StringRow(props) {
 // src/react/plugin.tsx
 import { jsx as jsx2 } from "react/jsx-runtime";
 function makeStore() {
-  let open = false;
+  let state = { isOpen: false, snapshotKeys: void 0 };
   const listeners = /* @__PURE__ */ new Set();
   return {
-    isOpen: () => open,
-    set(v) {
-      if (open !== v) {
-        open = v;
-        listeners.forEach((l) => l());
+    getState: () => state,
+    setOpen(open, snapshotKeys) {
+      const next = {
+        isOpen: open,
+        snapshotKeys: open ? snapshotKeys : void 0
+      };
+      if (state.isOpen === next.isOpen && state.snapshotKeys === next.snapshotKeys) {
+        return;
       }
+      state = next;
+      listeners.forEach((l) => l());
     },
     subscribe(l) {
       listeners.add(l);
-      return () => listeners.delete(l);
+      return () => {
+        listeners.delete(l);
+      };
     }
   };
 }
+async function captureCurrentViewSnapshot(i18next) {
+  const reg = globalThis.__verbumia_key_registry__;
+  if (!reg) return [];
+  const lng = i18next?.language;
+  const change = i18next?.changeLanguage;
+  if (typeof change === "function" && typeof lng === "string" && lng) {
+    reg.reset?.();
+    try {
+      await change(lng);
+    } catch {
+    }
+    await new Promise((r) => {
+      if (typeof requestAnimationFrame === "function") {
+        requestAnimationFrame(() => r());
+      } else {
+        setTimeout(() => r(), 16);
+      }
+    });
+    return reg.snapshot();
+  }
+  return reg.snapshot();
+}
 function feedbackPlugin(options) {
   const store = makeStore();
   let client = null;
   function Outlet() {
-    const isOpen = useSyncExternalStore(
+    const state = useSyncExternalStore(
       store.subscribe,
-      store.isOpen,
-      store.isOpen
+      store.getState,
+      store.getState
     );
-    if (!isOpen || !client || typeof document === "undefined") return null;
+    if (!state.isOpen || !client || typeof document === "undefined") return null;
     const c = client;
+    const panelKeys = options.keys ?? state.snapshotKeys;
     return createPortal(
       /* @__PURE__ */ jsx2(
         FeedbackPanel,
         {
           client: c,
-          keys: options.keys,
+          keys: panelKeys,
           namespace: options.namespace,
+          tos: options.tos ?? "modal",
           onClose: () => {
-            store.set(false);
+            store.setOpen(false);
             void c.flush();
           }
         }
@@ -356,24 +389,77 @@ function feedbackPlugin(options) {
   return {
     name: "@verbumia/feedback",
     setup(ctx) {
+      const initialLanguage = options.language ?? ctx.i18n?.language ?? ctx.config.defaultLocale;
+      const tos = options.tos ?? "modal";
       client = new FeedbackClient({
         apiBase: options.apiBase ?? ctx.config.apiBase ?? "https://api.verbumia.dev",
         projectId: options.projectId ?? ctx.config.projectUuid,
-        language: options.language ?? ctx.config.defaultLocale,
+        language: initialLanguage,
         endUserId: options.endUserId,
-        fetchImpl: options.fetchImpl
+        fetchImpl: options.fetchImpl,
+        apiKey: options.apiKey,
+        autoAcceptTos: tos !== "skip"
       });
+      const clientRef = client;
+      let addonState = null;
+      const cta = options.cta ?? "auto";
+      const scope = options.scope ?? "current-view";
+      const ctxI18next = ctx.i18n?.i18next;
+      const refreshState = async () => {
+        try {
+          const next = await clientRef.getAddonState();
+          if (next !== null) addonState = next;
+        } catch {
+        }
+      };
+      if (options.apiKey) void refreshState();
+      let langUnsub;
+      if (typeof ctx.onLanguageChange === "function") {
+        langUnsub = ctx.onLanguageChange((lng) => {
+          clientRef.setLanguage(lng);
+          void refreshState();
+        });
+      }
       const controller = {
-        open: () => store.set(true),
+        open: async () => {
+          if (scope === "current-view") {
+            const snapshot = await captureCurrentViewSnapshot(ctxI18next);
+            store.setOpen(true, snapshot);
+            return;
+          }
+          store.setOpen(true);
+        },
         close: () => {
-          store.set(false);
-          void client?.flush();
+          store.setOpen(false);
+          void clientRef?.flush();
+        },
+        client: clientRef,
+        get tosVersion() {
+          return clientRef.tosVersion;
         },
-        client
+        get hasAcceptedTos() {
+          return clientRef.hasAcceptedTos;
+        },
+        acceptTos: async () => {
+          await clientRef.acceptTos();
+          if (!options.apiKey) await refreshState();
+        },
+        get isActive() {
+          if (cta === "show") return true;
+          if (cta === "hide") return false;
+          return addonState ? addonState.isActive : null;
+        },
+        get enabledLanguages() {
+          return addonState ? addonState.enabledLanguages : null;
+        },
+        get sku() {
+          return addonState ? addonState.sku : null;
+        }
       };
       options.onReady?.(controller);
       if (options.controllerRef) options.controllerRef.current = controller;
       return () => {
+        langUnsub?.();
         if (options.controllerRef) options.controllerRef.current = null;
         void client?.flush();
       };