@revturbine/sdk 0.2.79 → 0.2.81

package/dist/headless.d.ts

@@ -12058,6 +12058,20 @@ interface RevTurbineInitOptions {
      * when no explicit {@link branding} and no legacy config-embedded theme apply.
      */
     apiBranding?: BrandingConfig;
+    /**
+     * Fetch the tenant's theme overrides from the control plane's
+     * `GET /api/sdk/theme` and apply them OVER the launched Playbook's theme
+     * (plan 184).
+     *
+     * Opt-in and `false` by default, deliberately: the SDK otherwise issues no
+     * theme request at all, so an integration with no branding configured never
+     * pays a round-trip — and never logs a failed one. Enable it when branding is
+     * managed from the RevTurbine dashboard and should change without a redeploy.
+     *
+     * Independent of {@link apiBranding}, which is the same rung supplied by the
+     * host instead of fetched by the SDK.
+     */
+    fetchThemeOverride?: boolean;
 }
 /** Base init options shared by all runtime mode helper builders. */
 type RevTurbineInitBaseOptions = Omit<RevTurbineInitOptions, 'runtimeMode' | 'endpointOverrides' | 'localRuntime'>;
@@ -12833,6 +12847,8 @@ declare class RevTurbineCustomerSdk {
      * session so a render loop can never flood the channel.
      */
     private readonly emittedResolutionDiagnostics;
+    /** Session dedup for {@link reportSdkError}, keyed by `reason`. */
+    private readonly emittedSdkErrors;
     private static readonly RESOLUTION_DIAGNOSTIC_SESSION_CAP;
     /**
      * Gate for `resolution_failure` diagnostics (plan 144 TASK-21). Honors BOTH
@@ -12854,6 +12870,25 @@ declare class RevTurbineCustomerSdk {
      * `(reason, primary handle)` for the session and capped.
      */
     private emitResolutionFailure;
+    /**
+     * Report that the SDK itself failed (plan 182 TASK-5).
+     *
+     * `sdk_error` was declared in the meta taxonomy with no emitter. This is the
+     * "the SDK malfunctioned" signal — distinct from `resolution_failure`, which
+     * means a *decision* produced nothing. It rides the same anonymous
+     * `events_sdk_meta` lane: no tenant, no user, no placement identity.
+     *
+     * Deduped on `reason` for the session and capped, mirroring
+     * {@link emitResolutionFailure} — an SDK failing inside a render loop must
+     * not become a telemetry flood. Best-effort and never throwing: this is
+     * called from `catch` blocks, so it must not manufacture a second failure.
+     *
+     * @param reason Stable, categorical cause (e.g. `provider_init_failed`) —
+     *   what dashboards group by.
+     * @param message Human-readable detail for triage, sent on the same footing
+     *   as `sdk_validation_warning`'s message, which already ships on this lane.
+     */
+    reportSdkError(reason: string, message?: string): void;
     /** Fire the one anonymous `sdk_init` adoption beacon at startup. */
     private emitSdkInitTelemetry;
     /**
@@ -21120,6 +21155,12 @@ interface ThemeLoaderOptions {
     apiKey: string;
     /** Optional storage provider. Falls back to localStorage in browser, in-memory on server. */
     storage?: RevTurbineStorage;
+    /**
+     * The launched Playbook's theme, used as the BASE that fetched overrides
+     * merge over (plan 184). Supplying it means a partial override from the
+     * control plane refines the Playbook's theme instead of replacing it.
+     */
+    base?: RevTurbineThemeInput;
 }
 /**
  * Load the tenant's theme: