@revturbine/sdk 0.2.81 → 0.2.82

package/dist/index.d.ts

@@ -21501,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;
 };
@@ -21519,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;