@revturbine/sdk 0.2.80 → 0.2.82

package/dist/index.d.ts

@@ -12151,6 +12151,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'>;
@@ -21234,6 +21248,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:
@@ -21481,6 +21501,34 @@ type RevTurbineProviderProps = {
      * Omit to disable. Memoize an object value to avoid re-installing.
      */
     domCapture?: boolean | AnnotatedCaptureOptions;
+    /**
+     * A server-evaluated payload to hydrate the SDK from (plan 186 TASK-2).
+     *
+     * Produced by the server SDK — `RevTurbineServer.evaluate()` or
+     * `LocalEvaluationServer.evaluate()` — and serialized into page props / RSC
+     * props. Applied synchronously the moment the SDK instance exists, before any
+     * awaited init work, so the decisions and entitlements it carries are already
+     * cached the first time a gate reads them. Without it, a server-rendered app
+     * evaluates once on the server and then re-evaluates from scratch on the
+     * client.
+     *
+     * Carries no credential — it is built for browser delivery. A malformed or
+     * unknown-version payload is logged and skipped rather than thrown: hydration
+     * is an optimization, so a bad payload degrades to normal client-side
+     * evaluation instead of breaking the provider.
+     *
+     * Re-hydrates when the payload's identity changes (e.g. a server navigation
+     * supplies a fresh one), so a provider mounted in a root layout stays current
+     * without remounting. Memoize a value you rebuild every render.
+     *
+     * @example
+     * ```tsx
+     * // app/layout.tsx (Server Component)
+     * const payload = await server.evaluate({ userId, placements: [{ slotId: 'hero' }] });
+     * return <RevTurbineProvider options={options} serverPayload={payload}>{children}</RevTurbineProvider>;
+     * ```
+     */
+    serverPayload?: ServerEvaluationHydrationPayload;
     /** React children. */
     children: React__default.ReactNode;
 };
@@ -21499,7 +21547,7 @@ type RevTurbineProviderProps = {
  * </RevTurbineProvider>
  * ```
  */
-declare function RevTurbineProvider({ options, bootstrapPlacements, domCapture, children }: RevTurbineProviderProps): React__default.JSX.Element;
+declare function RevTurbineProvider({ options, bootstrapPlacements, domCapture, serverPayload, children }: RevTurbineProviderProps): React__default.JSX.Element;
 
 type RevTurbineContextValue = {
     sdk: RevTurbineCustomerSdk | null;