@revturbine/sdk 0.11.11 → 0.11.12

package/dist/index.d.ts

@@ -21129,6 +21129,25 @@ interface RevTurbineUserContext extends Omit<UserContextInput, 'custom' | 'entit
      * `string | number` when serialized.
      */
     personalization?: SdkTraits;
+    /**
+     * Server-evaluated built-in segment dimensions (plan 279 PD-3), one leaf
+     * per resolved dimension keyed by its dimension key (e.g.
+     * `subscription_state`, `region`) — see the built-in segment resolution
+     * contract in `targeting-studio-ui.md` §4.1 for the full vocabulary.
+     *
+     * `fetchClientContext` delivers this from `GET /api/sdk/client-context`
+     * and merges it the way it merges `plan_handle`: **server values overlay
+     * app-set values**, per leaf. A dimension the server did not evaluate on a
+     * given fetch leaves whatever the app (or a prior fetch) had set for that
+     * leaf untouched; a dimension is simply absent when neither side has ever
+     * set it (unknown is trait absence — plan 255).
+     *
+     * Feeds the reserved `rt_<dimension>` segment traits that built-in
+     * Playbook segments match on — never read or write those trait keys
+     * directly. Set this yourself only to seed `local_only` mode or a
+     * server-side port, which has no client-context fetch of its own.
+     */
+    builtin_dimensions?: UserContextInput['builtin_dimensions'];
 }
 /** Page-level context automatically inferred or manually set. */
 interface RevTurbinePageContext {