@revturbine/sdk 0.10.0 → 0.10.2

package/dist/index.d.ts

@@ -7322,7 +7322,7 @@ declare const WebhookEventLogSchema: z.ZodObject<{
 declare const TrackEventSchema: z.ZodObject<{
     environment_id: z.ZodString;
     user_id: z.ZodString;
-    account_id: z.ZodString;
+    account_id: z.ZodOptional<z.ZodString>;
     event_name: z.ZodString;
     event_ts: z.ZodString;
     properties: z.ZodOptional<z.ZodString>;
@@ -7348,7 +7348,7 @@ declare const TrackIngestBatchSchema: z.ZodObject<{
     events: z.ZodArray<z.ZodObject<{
         environment_id: z.ZodString;
         user_id: z.ZodString;
-        account_id: z.ZodString;
+        account_id: z.ZodOptional<z.ZodString>;
         event_name: z.ZodString;
         event_ts: z.ZodString;
         properties: z.ZodOptional<z.ZodString>;
@@ -21131,9 +21131,15 @@ declare class RevTurbineCustomerSdk {
      * Resolve the normalized variant used by RevTurbine decisions and telemetry.
      * Missing, conflicting, and unavailable assignments remain explicit and are
      * never converted to a control variant.
+     *
+     * @public
      */
     getExperimentVariant(experimentHandle: string): Promise<ExperimentVariantSelection>;
-    /** Return the immutable ephemeral context currently entering local evaluation. */
+    /**
+     * Return the immutable ephemeral context currently entering local evaluation.
+     *
+     * @public
+     */
     getEffectiveUserContext(): Promise<Readonly<RevTurbineUserContext>>;
     /**
      * Emit `experiment_assigned` assignment facts for the resolved snapshot
@@ -21179,6 +21185,49 @@ declare class RevTurbineCustomerSdk {
     private applyCategoryConflictSuppression;
     private resolveLocalPlacementFromCandidates;
     private localPlacementForConfig;
+    /**
+     * The `placement_slots[]` entry the loaded Playbook authors for a request.
+     *
+     * BL-0119. `placement_slots` is the authored registry of surfaces: an entry
+     * declares a slot's `id`, `surface_type` and `template`, and a placement
+     * targets it through `trigger.slot_id`. Scaffold's headless `LocalRuntime`
+     * has always resolved it (`slotRecordForConfig`); the browser SDK never did,
+     * so a slot-id lookup had nothing to match against and every caller who had
+     * not already driven a decision through that slot got `null` /
+     * `placement_not_found` while a by-name lookup worked.
+     *
+     * The matching rules are kept identical to `LocalRuntime.slotRecordForConfig`
+     * on purpose — a slot id wins outright; otherwise the component type matches
+     * the slot's `surface_type`. Divergence here is divergence in what the same
+     * Playbook decides in the browser versus headless.
+     *
+     * @internal
+     */
+    private authoredSurfaceSlotFor;
+    /**
+     * The surface template ids the Playbook declares for an authored slot id.
+     *
+     * BL-0119. `surface_template_ids` on the registered record is what drops the
+     * shared resolver into its slot branch; without it the resolver falls back to
+     * direct lookup, which is keyed by placement name/id and can never match a
+     * slot id. An integrator who declared the slot in config should not also have
+     * to repeat its template at the `registerSurfaceSlot()` call site.
+     *
+     * @internal
+     */
+    private authoredSlotTemplateIds;
+    /**
+     * Resolve a placement request through the Playbook's authored slot registry.
+     *
+     * BL-0119. Runs only after the local placement cache misses, so an already
+     * decided slot keeps its cached output and this path adds no behavior for
+     * requests the SDK could already answer. Registration is deliberately local:
+     * reading a placement must never write a surface slot back to the control
+     * plane.
+     *
+     * @internal
+     */
+    private placementFromAuthoredSlot;
     private hydrateLocalRuntimeState;
     private persistLocalRuntimeState;
     private decisionCacheStorageKey;
@@ -21270,6 +21319,8 @@ declare class RevTurbineCustomerSdk {
      *
      * Keys are usage units (derived from configured usage token prefixes when available),
      * and values include current usage plus optional limit when known.
+     *
+     * @public
      */
     getUsage(): RevTurbineUsageSnapshot;
     private catalogEligibilityContext;
@@ -21346,6 +21397,8 @@ declare class RevTurbineCustomerSdk {
      * - Placement decision metadata (`rule_id`, reason codes, suppression)
      *
      * Useful for debuggers, QA tooling, and customer-facing explainability UIs.
+     *
+     * @public
      */
     explainPlacementDecision(input: RevTurbinePlacementDecisionInput): Promise<RevTurbinePlacementDecisionExplanation>;
     private usageThresholdForEntitlement;
@@ -21485,6 +21538,8 @@ declare class RevTurbineCustomerSdk {
      * {@link RevTurbineInitOptions.anonymousTelemetry} switch (REQ-13).
      *
      * @param consent - the new consent state
+     *
+     * @public
      */
     setTelemetryConsent(consent: TelemetryConsent): void;
     /** The current behavior-telemetry consent state (plan 144 TASK-8). */
@@ -21516,6 +21571,8 @@ declare class RevTurbineCustomerSdk {
      * at emit time; a violation emits an `sdk_validation_warning` alongside
      * (never a throw — telemetry must not break the host app). Production
      * builds skip validation; the ingest boundary re-validates authoritatively.
+     *
+     * @public
      */
     emitPlatformEvent<K extends EmittablePlatformEventName>(eventName: K, payload: EventPayloadInput<K>, options?: RevTurbineEventOptions): Promise<void>;
     /**
@@ -21559,6 +21616,8 @@ declare class RevTurbineCustomerSdk {
      * interval timer, and page-unload. Best-effort and non-throwing — delivery
      * failures are swallowed (plan 95 REQ-3). Safe to call when the buffer is
      * empty (no-op).
+     *
+     * @public
      */
     flushEvents(): Promise<void>;
     /**
@@ -21622,6 +21681,13 @@ declare class RevTurbineCustomerSdk {
      * routes through the normal clickstream path and never throws into the app.
      */
     private emitObservedContextFields;
+    /**
+     * Merge fields into the session-bound user context. Recognized fields
+     * upsert; an omitted field never clobbers a previously-set value. See the
+     * advertised {@link update} alias for the full recognized-field contract.
+     *
+     * @public
+     */
     setUserContext(userContext: RevTurbineUserContext): void;
     /**
      * Subscribe to user-context changes — `identify()`, `setUserContext()`,
@@ -21713,9 +21779,32 @@ declare class RevTurbineCustomerSdk {
     diagnoseSlotInventory(): RevTurbineSlotInventoryDiagnosis;
     /**
      * @deprecated Use `registerSurfaceSlot`.
+     *
+     * @public
      */
     registerPlacement(config: RevTurbinePlacementConfig): Promise<string>;
     private upsertSurfaceSlot;
+    /**
+     * Build the internal placement record for a surface-slot config.
+     *
+     * Shared by `registerSurfaceSlot` and the BL-0119 authored-slot resolution
+     * path so both produce byte-identical records — a second hand-rolled record
+     * shape is how the two would drift into deciding differently.
+     *
+     * When the caller passes no `surfaceTemplateIds`, the ids the Playbook
+     * declares for this slot are adopted (BL-0119). An explicit list from the
+     * call site always wins: the mounting code knows what it actually renders.
+     *
+     * @internal
+     */
+    private buildSurfaceSlotRecord;
+    /**
+     * Store a surface-slot record in the local registry, marking it unsynced when
+     * it is new or has changed. Local only — never writes to the control plane.
+     *
+     * @internal
+     */
+    private commitSurfaceSlotRecord;
     registerSurfaceSlot(config: RevTurbineSurfaceSlotConfig): Promise<string>;
     /**
      * Persist authored placement types to a configured backend.
@@ -21755,6 +21844,14 @@ declare class RevTurbineCustomerSdk {
      */
     private gateDecisionByCaps;
     private normalizeDecisionFromResponse;
+    /**
+     * Resolve the placement decision for a registered surface slot — the
+     * evaluated payload (or lack of one), its reason, and the metadata needed
+     * to report the interaction lifecycle ({@link trackTreatmentInteraction},
+     * {@link dismiss}, {@link snooze}, {@link convert}).
+     *
+     * @public
+     */
     getPlacementDecision(input: RevTurbinePlacementDecisionInput): Promise<RevTurbinePlacementDecision>;
     preloadPlacementDecisions(inputs: RevTurbinePlacementDecisionInput[]): Promise<void>;
     bootstrapPlacementDecisions(inputs: RevTurbinePlacementDecisionInput[]): Promise<void>;
@@ -21789,6 +21886,31 @@ declare class RevTurbineCustomerSdk {
      * persistent failure is observable instead of merely quiet.
      */
     private failInteractionFlush;
+    /**
+     * The account identity to stamp on a treatment interaction, or `undefined`
+     * when the integration has identified none.
+     *
+     * Two rules make this a usable join key rather than a label:
+     *
+     * 1. **Redacted identically to `/api/track`.** Both paths run the account id
+     *    through {@link redactIdentityField}, so an email-shaped account id
+     *    becomes the SAME hash in `placement_presentations` and in
+     *    `events_clickstream`. Hashing on one path only would produce a hash on
+     *    one side and a raw email on the other, and `monetization_funnel` would
+     *    join nothing (identity keys are hashed, not sentinelled — the contract
+     *    is byte-identical across repos).
+     * 2. **Never falls back to the user id.** An absent account is absent. The
+     *    ingest route keeps its own `account_id ?? user_id` fallback for SDKs
+     *    that do not send the field yet; this SDK no longer feeds it.
+     */
+    private interactionAccountId;
+    /**
+     * Report a treatment interaction directly by placement/treatment id — the
+     * lower-level counterpart to {@link dismiss}/{@link snooze}/{@link convert},
+     * which key off a decision's `output_id` instead.
+     *
+     * @public
+     */
     trackTreatmentInteraction(input: RevTurbineTreatmentInteractionInput): Promise<void>;
     getPlacementContent(placementId: string, request?: JsonObject): Promise<RevTurbinePlacementContent>;
     /**
@@ -21841,8 +21963,29 @@ declare class RevTurbineCustomerSdk {
     private reportUnrecognizedContextKeys;
     private normalizePlacementOutput;
     private validateTrialStatusShape;
+    /**
+     * Resolve the legacy placement payload for a request config. Prefer
+     * {@link getPlacementDecision} for new integrations; kept for the
+     * documented legacy request-config path.
+     *
+     * @public
+     */
     getPlacement(config: RevTurbinePlacementRequestConfig): Promise<PlacementOutput | null>;
+    /**
+     * Evaluate a single entitlement handle for the active user, purely from the
+     * loaded UserContext and Playbook. The advertised {@link can} alias wraps
+     * this with the friendly verb name.
+     *
+     * @public
+     */
     checkEntitlement(handle: string, context?: RevTurbineEntitlementContext): Promise<EntitlementResult>;
+    /**
+     * Set absolute usage balances for the active user and emit any
+     * threshold-crossing triggers. See the advertised {@link update} alias's
+     * `usage` key for the same contract via the general patch verb.
+     *
+     * @public
+     */
     updateUsage(balances: UsageBalances): void;
     /**
      * Report usage values that are neither a number nor an entry object, so a
@@ -21875,12 +22018,16 @@ declare class RevTurbineCustomerSdk {
     /**
      * Build the full persistence-ready {@link UserContext} from the current
      * SDK state. Includes `tenant_id` and `user_id` required for API storage.
+     *
+     * @public
      */
     getUserContext(): UserContext;
     /**
      * Fetch the resolved user context from the decision API.
      * Returns the user's matched segments, traits, plan, and usage — used
      * to determine which placement payloads are eligible for display.
+     *
+     * @public
      */
     fetchUserContext(userId: string): Promise<UserTargetingContext>;
     /**
@@ -22018,6 +22165,12 @@ declare class RevTurbineCustomerSdk {
      * @param metadata - Optional metadata persisted with the record.
      */
     recordConversion(placementId: string, payloadId?: string, surfaceTemplateId?: string, metadata?: RevTurbineImpressionMetadata): Promise<void>;
+    /**
+     * Return the active user's trial status, derived from their trial
+     * instances and the configured reverse-trial rules.
+     *
+     * @public
+     */
     getTrialStatus(): Promise<RevTurbineTrialContext>;
     /**
      * Derive and push the user's trial status from their {@link TrialInstance}
@@ -22040,6 +22193,8 @@ declare class RevTurbineCustomerSdk {
      * @param options - Optional `nowIso` clock pin (defaults to the current
      *   time) and `basePlanHandle` (the base plan a reverse-trial user reverts
      *   to, surfaced as `plan_handle`).
+     *
+     * @public
      */
     setTrialInstances(instances: readonly TrialInstance[], options?: {
         nowIso?: string;
@@ -22059,6 +22214,8 @@ declare class RevTurbineCustomerSdk {
      * - `uiPathResolvers` passed at SDK init
      * - optional `resolvers` passed to this method
      * - CTA handlers from domain providers (`domain: 'cta'`), unless disabled
+     *
+     * @public
      */
     validateUiPathResolvers(options?: RevTurbineUiPathResolverValidationOptions): Promise<RevTurbineUiPathResolverValidationReport>;
     /**
@@ -22072,11 +22229,35 @@ declare class RevTurbineCustomerSdk {
     private warnOnUiPathResolverCoverageGaps;
     /** Route output-addressed callbacks through the canonical interaction/analytics path. */
     private trackOutputInteraction;
+    /**
+     * Suppress a decision's placement for its authored dismiss cooldown.
+     * Terminal for the window: `getPlacementDecision` will not return it again
+     * until the cooldown lapses.
+     *
+     * @public
+     */
     dismiss(outputId: string): Promise<void>;
+    /**
+     * Suppress a decision's placement for a "remind me later" window —
+     * `seconds` overrides the authored default.
+     *
+     * @public
+     */
     snooze(outputId: string, seconds?: number): Promise<void>;
+    /**
+     * Record a confirmed CTA completion and retire the decision's placement
+     * permanently — future calls to `getPlacementDecision` for it will not
+     * return it again.
+     *
+     * @public
+     */
     convert(outputId: string): Promise<void>;
     /**
-     * Emit a canonical trigger event recognised by the decision engine.
+     * Emit a canonical trigger event. There is no in-SDK consumer that matches
+     * on trigger names — the shipped behavior is ingest to `events_clickstream`
+     * only (plan 250's wire/consumer matrix); a decision-engine placement
+     * trigger matches `trigger.slot_id` against registered slots, not this
+     * event's name.
      *
      * Convenience wrapper over {@link emitSemantic} that constrains the event
      * name to {@link RevTurbineTriggerEvent} and attaches standard context
@@ -22100,6 +22281,8 @@ declare class RevTurbineCustomerSdk {
      * // stored as `clickstream_feature_gated` — see the collision note above
      * await sdk.emitTrigger('feature_gated', { feature: 'advanced_automation' });
      * ```
+     *
+     * @public
      */
     emitTrigger(trigger: RevTurbineTriggerEvent, payload?: RevTurbineTriggerPayload, options?: RevTurbineEventOptions): Promise<void>;
     trackEvent(name: string, data?: SdkEventProperties): Promise<void>;
@@ -22124,8 +22307,16 @@ declare class RevTurbineCustomerSdk {
      * rt.identify('user_123', { plan_handle: 'pro' }); // THE matching identity
      * rt.identify('user_123', { plan_handle: 'pro', plan: { handle: 'pro', name: 'Professional' } });
      * ```
+     *
+     * @public
      */
     identify<T extends IdentifyContextInput>(userId: string, context?: Exact<IdentifyContextInput, T>): void;
+    /**
+     * Reset to anonymous user state, re-inferring a fresh anonymous id. Also
+     * available as the advertised {@link reset} alias.
+     *
+     * @public
+     */
     resetIdentity(): void;
     /**
      * Hard-reset the user context to a blank slate — removes EVERY user-context
@@ -22163,6 +22354,8 @@ declare class RevTurbineCustomerSdk {
      * @example
      * const access = await rt.can('generate_image');
      * if (!access.allowed) showUpgrade();
+     *
+     * @public
      */
     can(handle: string, context?: RevTurbineEntitlementContext): Promise<EntitlementResult>;
     /**
@@ -22174,6 +22367,8 @@ declare class RevTurbineCustomerSdk {
      * @example
      * const gated = await rt.gate('export_pdf', () => exportPdf());
      * if (!gated.ran) openPaywall(gated.entitlement);
+     *
+     * @public
      */
     gate<T>(action: string, fn: () => T | Promise<T>, context?: RevTurbineEntitlementContext): Promise<RevTurbineGateResult<T>>;
     /**
@@ -22182,6 +22377,8 @@ declare class RevTurbineCustomerSdk {
      *
      * @example
      * rt.track('ai_generation_completed', { credits: 3 });
+     *
+     * @public
      */
     track(name: string, data?: SdkEventProperties): Promise<void>;
     /**
@@ -22205,11 +22402,15 @@ declare class RevTurbineCustomerSdk {
      * @example
      * // Reflect a plan change and new traits in one call (identity unchanged):
      * rt.update({ plan_handle: 'pro', custom: { role: 'admin' } });
+     *
+     * @public
      */
     update<T extends RevTurbineUpdateInput>(patch: Exact<RevTurbineUpdateInput, T>): void;
     /**
      * Clear the current user — the advertised alias of {@link resetIdentity}
      * (e.g. on sign-out).
+     *
+     * @public
      */
     reset(): void;
     onRouteChange(change: {
@@ -22930,6 +23131,8 @@ declare class SdkSession {
  *   ],
  * });
  * ```
+ *
+ * @public
  */
 declare function initRevTurbine<TUser extends RevTurbineUserContext = RevTurbineUserContext>(options: SdkSessionOptions & {
     user?: Exact<RevTurbineUserContext, TUser>;
@@ -23885,7 +24088,7 @@ interface components {
         TrackEvent: {
             environment_id: components["schemas"]["Anon_57796118d046_16"];
             user_id: components["schemas"]["Anon_761f976a1da1_1"];
-            account_id: components["schemas"]["Anon_57796118d046_17"];
+            account_id?: components["schemas"]["Anon_4e04ec5cc4e6_3"];
             event_name: components["schemas"]["Anon_cd76cef95ac8"];
             event_ts: components["schemas"]["Anon_3c179513a5d9_2"];
             properties?: components["schemas"]["Anon_96f9066c2fdc_20"];
@@ -23910,7 +24113,7 @@ interface components {
         SdkMetaEvent: {
             event_type: components["schemas"]["Anon_53b83ce9a609"];
             occurred_at: components["schemas"]["Anon_3c179513a5d9_3"];
-            request_id?: components["schemas"]["Anon_4e04ec5cc4e6_3"];
+            request_id?: components["schemas"]["Anon_4e04ec5cc4e6_4"];
             config_hash_id?: components["schemas"]["Anon_e17de468dbc9"];
             sdk_version?: components["schemas"]["Anon_e17de468dbc9_1"];
             runtime_mode?: components["schemas"]["Anon_e17de468dbc9_2"];
@@ -23941,17 +24144,17 @@ interface components {
         TreatmentInteractionInput: {
             user_id: components["schemas"]["Anon_761f976a1da1_2"];
             account_id?: components["schemas"]["Anon_0a729b73253d"];
-            placement_id: components["schemas"]["Anon_57796118d046_18"];
-            treatment_id?: components["schemas"]["Anon_4e04ec5cc4e6_4"];
-            surface_slot_id?: components["schemas"]["Anon_4e04ec5cc4e6_5"];
-            surface_template_id?: components["schemas"]["Anon_4e04ec5cc4e6_6"];
-            payload_id?: components["schemas"]["Anon_4e04ec5cc4e6_7"];
+            placement_id: components["schemas"]["Anon_57796118d046_17"];
+            treatment_id?: components["schemas"]["Anon_4e04ec5cc4e6_5"];
+            surface_slot_id?: components["schemas"]["Anon_4e04ec5cc4e6_6"];
+            surface_template_id?: components["schemas"]["Anon_4e04ec5cc4e6_7"];
+            payload_id?: components["schemas"]["Anon_4e04ec5cc4e6_8"];
             interaction_type: components["schemas"]["Anon_b540c131c269"];
             interaction_at?: components["schemas"]["Anon_e077e17ea982_3"];
-            message_block_handle?: components["schemas"]["Anon_4e04ec5cc4e6_8"];
-            message_block_id?: components["schemas"]["Anon_4e04ec5cc4e6_9"];
-            experiment_id?: components["schemas"]["Anon_4e04ec5cc4e6_10"];
-            variant_key?: components["schemas"]["Anon_4e04ec5cc4e6_11"];
+            message_block_handle?: components["schemas"]["Anon_4e04ec5cc4e6_9"];
+            message_block_id?: components["schemas"]["Anon_4e04ec5cc4e6_10"];
+            experiment_id?: components["schemas"]["Anon_4e04ec5cc4e6_11"];
+            variant_key?: components["schemas"]["Anon_4e04ec5cc4e6_12"];
             test?: components["schemas"]["Anon_fb9ddeea992e_3"];
             metadata?: components["schemas"]["Anon_a249e58b3222"];
         };
@@ -24285,7 +24488,8 @@ interface components {
         Anon_3f2bab3833ef: components["schemas"]["TrackEvent"][];
         Anon_57796118d046_16: string;
         Anon_761f976a1da1_1: string;
-        Anon_57796118d046_17: string;
+        Anon_4e04ec5cc4e6_3: components["schemas"]["Anon_9ac136edb99a_8"];
+        Anon_9ac136edb99a_8: string;
         Anon_cd76cef95ac8: string;
         /** Format: date-time */
         Anon_3c179513a5d9_2: string;
@@ -24319,8 +24523,8 @@ interface components {
         Anon_53b83ce9a609: components["schemas"]["SdkMetaEventType"];
         /** Format: date-time */
         Anon_3c179513a5d9_3: string;
-        Anon_4e04ec5cc4e6_3: components["schemas"]["Anon_9ac136edb99a_8"];
-        Anon_9ac136edb99a_8: string;
+        Anon_4e04ec5cc4e6_4: components["schemas"]["Anon_9ac136edb99a_9"];
+        Anon_9ac136edb99a_9: string;
         Anon_e17de468dbc9: components["schemas"]["Anon_520c691f88f7"];
         Anon_520c691f88f7: string;
         Anon_e17de468dbc9_1: components["schemas"]["Anon_520c691f88f7_1"];
@@ -24355,29 +24559,29 @@ interface components {
         Anon_e17de468dbc9_10: components["schemas"]["Anon_520c691f88f7_10"];
         Anon_520c691f88f7_10: string;
         Anon_761f976a1da1_2: string;
-        Anon_0a729b73253d: components["schemas"]["Anon_9ac136edb99a_9"];
-        Anon_9ac136edb99a_9: string;
-        Anon_57796118d046_18: string;
-        Anon_4e04ec5cc4e6_4: components["schemas"]["Anon_9ac136edb99a_10"];
+        Anon_0a729b73253d: components["schemas"]["Anon_9ac136edb99a_10"];
         Anon_9ac136edb99a_10: string;
+        Anon_57796118d046_17: string;
         Anon_4e04ec5cc4e6_5: components["schemas"]["Anon_9ac136edb99a_11"];
         Anon_9ac136edb99a_11: string;
         Anon_4e04ec5cc4e6_6: components["schemas"]["Anon_9ac136edb99a_12"];
         Anon_9ac136edb99a_12: string;
         Anon_4e04ec5cc4e6_7: components["schemas"]["Anon_9ac136edb99a_13"];
         Anon_9ac136edb99a_13: string;
+        Anon_4e04ec5cc4e6_8: components["schemas"]["Anon_9ac136edb99a_14"];
+        Anon_9ac136edb99a_14: string;
         Anon_b540c131c269: components["schemas"]["TreatmentInteractionType"];
         Anon_e077e17ea982_3: components["schemas"]["Anon_02ecf48bed22_3"];
         /** Format: date-time */
         Anon_02ecf48bed22_3: string;
-        Anon_4e04ec5cc4e6_8: components["schemas"]["Anon_9ac136edb99a_14"];
-        Anon_9ac136edb99a_14: string;
         Anon_4e04ec5cc4e6_9: components["schemas"]["Anon_9ac136edb99a_15"];
         Anon_9ac136edb99a_15: string;
         Anon_4e04ec5cc4e6_10: components["schemas"]["Anon_9ac136edb99a_16"];
         Anon_9ac136edb99a_16: string;
         Anon_4e04ec5cc4e6_11: components["schemas"]["Anon_9ac136edb99a_17"];
         Anon_9ac136edb99a_17: string;
+        Anon_4e04ec5cc4e6_12: components["schemas"]["Anon_9ac136edb99a_18"];
+        Anon_9ac136edb99a_18: string;
         Anon_fb9ddeea992e_3: components["schemas"]["Anon_7cb541e84f22_31"];
         Anon_7cb541e84f22_31: boolean;
         Anon_a249e58b3222: components["schemas"]["Anon_c65c1fbd5acf_8"];
@@ -24418,7 +24622,7 @@ interface components {
             base_sequence: components["schemas"]["Anon_71a2fb329804_1"];
             anchor_id: components["schemas"]["Anon_fb248bf5a9f7_12"];
             handle: components["schemas"]["Anon_2457cccd64aa_2"];
-            plan_id: components["schemas"]["Anon_57796118d046_28"];
+            plan_id: components["schemas"]["Anon_57796118d046_27"];
             billing_period: components["schemas"]["Anon_129e203b1449_2"];
             segment_id: components["schemas"]["Anon_f7fb9744a6e4_12"];
             price_amount: components["schemas"]["Anon_7ab7b70b014d_3"];
@@ -24461,7 +24665,7 @@ interface components {
             base_sequence: components["schemas"]["Anon_71a2fb329804_1"];
             anchor_id: components["schemas"]["Anon_fb248bf5a9f7_14"];
             handle: components["schemas"]["Anon_2457cccd64aa_3"];
-            addon_id: components["schemas"]["Anon_57796118d046_29"];
+            addon_id: components["schemas"]["Anon_57796118d046_28"];
             billing_period: components["schemas"]["Anon_129e203b1449_3"];
             segment_id: components["schemas"]["Anon_f7fb9744a6e4_13"];
             price_amount: components["schemas"]["Anon_7ab7b70b014d_4"];
@@ -24476,8 +24680,8 @@ interface components {
             created_at: components["schemas"]["Anon_be3e2585472d_2"];
             updated_at: components["schemas"]["Anon_be3e2585472d_3"];
             tenant_id: components["schemas"]["Anon_fb248bf5a9f7_10"];
-            stripe_price_id: components["schemas"]["Anon_57796118d046_30"];
-            stripe_product_id: components["schemas"]["Anon_57796118d046_31"];
+            stripe_price_id: components["schemas"]["Anon_57796118d046_29"];
+            stripe_product_id: components["schemas"]["Anon_57796118d046_30"];
             billing_period: components["schemas"]["Anon_cf08caa6d850_1"];
             unit_amount_cents: components["schemas"]["Anon_79391150fda1_1"];
             currency: components["schemas"]["Anon_1788a9a8a0b9_2"];
@@ -24524,7 +24728,7 @@ interface components {
             base_sequence: components["schemas"]["Anon_71a2fb329804_1"];
             anchor_id: components["schemas"]["Anon_fb248bf5a9f7_16"];
             handle: components["schemas"]["Anon_2457cccd64aa_4"];
-            entitlement_id: components["schemas"]["Anon_57796118d046_32"];
+            entitlement_id: components["schemas"]["Anon_57796118d046_31"];
             targets: components["schemas"]["Anon_effbae05e941"];
             segment_ids: components["schemas"]["Anon_f8dbfffc0ce2_10"];
             visibility: components["schemas"]["Anon_b26f420c5d82_1"];
@@ -24566,7 +24770,7 @@ interface components {
             base_sequence: components["schemas"]["Anon_71a2fb329804_1"];
             anchor_id: components["schemas"]["Anon_fb248bf5a9f7_16"];
             handle: components["schemas"]["Anon_2457cccd64aa_4"];
-            entitlement_id: components["schemas"]["Anon_57796118d046_32"];
+            entitlement_id: components["schemas"]["Anon_57796118d046_31"];
             targets: components["schemas"]["Anon_effbae05e941"];
             segment_ids: components["schemas"]["Anon_f8dbfffc0ce2_10"];
             visibility: components["schemas"]["Anon_b26f420c5d82_1"];
@@ -24597,7 +24801,7 @@ interface components {
         };
         EntitlementRuleWarning: {
             code: components["schemas"]["Anon_47cb53910d2c"];
-            message: components["schemas"]["Anon_57796118d046_34"];
+            message: components["schemas"]["Anon_57796118d046_33"];
             path?: components["schemas"]["Anon_e5444c6c0ca5"];
         };
         /** @enum {string} */
@@ -24615,8 +24819,8 @@ interface components {
             sequence: components["schemas"]["Anon_ffffc3c874cb_1"];
             base_sequence: components["schemas"]["Anon_71a2fb329804_1"];
             handle: components["schemas"]["Anon_2457cccd64aa_5"];
-            rule_id: components["schemas"]["Anon_57796118d046_35"];
-            experiment_id: components["schemas"]["Anon_57796118d046_36"];
+            rule_id: components["schemas"]["Anon_57796118d046_34"];
+            experiment_id: components["schemas"]["Anon_57796118d046_35"];
             variant_name: components["schemas"]["Anon_872e58432369_1"];
             is_control: components["schemas"]["Anon_062d958a93c4_5"];
             override_fields: components["schemas"]["Anon_5142f8473790_6"];
@@ -24686,7 +24890,7 @@ interface components {
         };
         PlacementWarning: {
             code: components["schemas"]["Anon_9481d431ae03"];
-            message: components["schemas"]["Anon_57796118d046_37"];
+            message: components["schemas"]["Anon_57796118d046_36"];
             path?: components["schemas"]["Anon_e5444c6c0ca5_1"];
         };
         /** @enum {string} */
@@ -24705,13 +24909,13 @@ interface components {
             base_sequence: components["schemas"]["Anon_71a2fb329804_1"];
             anchor_id: components["schemas"]["Anon_fb248bf5a9f7_18"];
             handle: components["schemas"]["Anon_2457cccd64aa_6"];
-            placement_id: components["schemas"]["Anon_57796118d046_38"];
+            placement_id: components["schemas"]["Anon_57796118d046_37"];
             drag_order: components["schemas"]["Anon_f95d5b2e4f52_9"];
             target_plan_ids: components["schemas"]["Anon_f8dbfffc0ce2_11"];
             target_plan_billing_cadences: components["schemas"]["Anon_f8dbfffc0ce2_12"];
             target_segments: components["schemas"]["Anon_f8dbfffc0ce2_13"];
             surface_slot_ids: components["schemas"]["Anon_f8dbfffc0ce2_14"];
-            surface_template_id: components["schemas"]["Anon_57796118d046_39"];
+            surface_template_id: components["schemas"]["Anon_57796118d046_38"];
             content_fields: components["schemas"]["Anon_5142f8473790_7"];
             cta_list: components["schemas"]["Anon_6ff5f738216c"];
             max_per_period: components["schemas"]["Anon_45e0e0d4a0da_3"];
@@ -24752,8 +24956,8 @@ interface components {
         Anon_be3e2585472d_3: string;
         Anon_fb248bf5a9f7_10: string;
         /** @default production */
-        Anon_51cbbf69cb41_1: components["schemas"]["Anon_9ac136edb99a_19"];
-        Anon_9ac136edb99a_19: string;
+        Anon_51cbbf69cb41_1: components["schemas"]["Anon_9ac136edb99a_20"];
+        Anon_9ac136edb99a_20: string;
         Anon_0eb2e3b6e08c_3: string;
         Anon_ed3fcc71dea7: {
             error: string;
@@ -24798,7 +25002,7 @@ interface components {
         Anon_f2d1b3e449b4_1: components["schemas"]["Anon_c65c1fbd5acf_11"];
         Anon_fb248bf5a9f7_12: string;
         Anon_2457cccd64aa_2: components["schemas"]["Anon_0eb2e3b6e08c_3"];
-        Anon_57796118d046_28: string;
+        Anon_57796118d046_27: string;
         /** @enum {string} */
         Anon_129e203b1449_2: "monthly" | "annual" | "one_time" | "custom";
         /** @default null */
@@ -24825,7 +25029,7 @@ interface components {
         Anon_f27cb44c32f6_14: components["schemas"]["Anon_f2d1b3e449b4_1"];
         Anon_fb248bf5a9f7_14: string;
         Anon_2457cccd64aa_3: components["schemas"]["Anon_0eb2e3b6e08c_3"];
-        Anon_57796118d046_29: string;
+        Anon_57796118d046_28: string;
         /** @enum {string} */
         Anon_129e203b1449_3: "monthly" | "annual" | "one_time" | "custom";
         /** @default null */
@@ -24840,8 +25044,8 @@ interface components {
         Anon_00404e686415_39: string;
         /** @default static */
         Anon_b5714cb1e73b_3: components["schemas"]["PriceSource"];
+        Anon_57796118d046_29: string;
         Anon_57796118d046_30: string;
-        Anon_57796118d046_31: string;
         Anon_cf08caa6d850_1: components["schemas"]["StripePriceBillingPeriod"];
         /** @default null */
         Anon_79391150fda1_1: components["schemas"]["Anon_c648138a0918_8"];
@@ -24880,10 +25084,10 @@ interface components {
         Anon_f27cb44c32f6_15: components["schemas"]["Anon_f2d1b3e449b4_1"];
         Anon_fb248bf5a9f7_16: string;
         Anon_2457cccd64aa_4: components["schemas"]["Anon_0eb2e3b6e08c_3"];
-        Anon_57796118d046_32: string;
+        Anon_57796118d046_31: string;
         Anon_effbae05e941: components["schemas"]["EntitlementRuleTargetOutput"][];
         Anon_70ee2ddbc798_1: components["schemas"]["EntitlementRuleTargetKind"];
-        Anon_57796118d046_33: string;
+        Anon_57796118d046_32: string;
         /** @default [] */
         Anon_f8dbfffc0ce2_10: components["schemas"]["Anon_681004346c78_13"];
         Anon_681004346c78_13: string[];
@@ -24936,12 +25140,12 @@ interface components {
         Anon_94e2b717b43e: components["schemas"]["Anon_b9f8542e5a53"];
         Anon_b9f8542e5a53: components["schemas"]["EntitlementRuleWarning"][];
         Anon_47cb53910d2c: components["schemas"]["EntitlementRuleWarningCode"];
-        Anon_57796118d046_34: string;
+        Anon_57796118d046_33: string;
         Anon_e5444c6c0ca5: components["schemas"]["Anon_9b45bb8cfd31"];
         Anon_9b45bb8cfd31: (string | number)[];
         Anon_2457cccd64aa_5: components["schemas"]["Anon_0eb2e3b6e08c_3"];
+        Anon_57796118d046_34: string;
         Anon_57796118d046_35: string;
-        Anon_57796118d046_36: string;
         Anon_872e58432369_1: string;
         /** @default false */
         Anon_062d958a93c4_5: components["schemas"]["Anon_7cb541e84f22_42"];
@@ -24990,12 +25194,12 @@ interface components {
         Anon_deca7bd23776: components["schemas"]["Anon_4683dfa2b0e7"];
         Anon_4683dfa2b0e7: components["schemas"]["PlacementWarning"][];
         Anon_9481d431ae03: components["schemas"]["PlacementWarningCode"];
-        Anon_57796118d046_37: string;
+        Anon_57796118d046_36: string;
         Anon_e5444c6c0ca5_1: components["schemas"]["Anon_9b45bb8cfd31_1"];
         Anon_9b45bb8cfd31_1: (string | number)[];
         Anon_fb248bf5a9f7_18: string;
         Anon_2457cccd64aa_6: components["schemas"]["Anon_0eb2e3b6e08c_3"];
-        Anon_57796118d046_38: string;
+        Anon_57796118d046_37: string;
         /** @default 0 */
         Anon_f95d5b2e4f52_9: components["schemas"]["Anon_278eaeabce08_11"];
         Anon_278eaeabce08_11: number;
@@ -25011,7 +25215,7 @@ interface components {
         /** @default [] */
         Anon_f8dbfffc0ce2_14: components["schemas"]["Anon_681004346c78_17"];
         Anon_681004346c78_17: string[];
-        Anon_57796118d046_39: string;
+        Anon_57796118d046_38: string;
         /** @default {} */
         Anon_5142f8473790_7: components["schemas"]["Anon_c65c1fbd5acf_13"];
         Anon_c65c1fbd5acf_13: {
@@ -25071,7 +25275,7 @@ interface components {
         /** @default [] */
         Anon_3b6346b139c2: components["schemas"]["Anon_f836473839d1"];
         Anon_f836473839d1: components["schemas"]["FieldDefinitionOutput"][];
-        Anon_9ac136edb99a_20: string;
+        Anon_9ac136edb99a_21: string;
         /** @default false */
         Anon_f56777819c8b_3: boolean;
         Anon_44136fa355b3_2: unknown;
@@ -25119,7 +25323,7 @@ interface components {
         CurrencyOutput: components["schemas"]["Anon_063c0cce3710_1"];
         EntitlementRuleTargetOutput: {
             kind: components["schemas"]["Anon_70ee2ddbc798_1"];
-            id: components["schemas"]["Anon_57796118d046_33"];
+            id: components["schemas"]["Anon_57796118d046_32"];
         };
         CtaObjectOutput: {
             label: components["schemas"]["Anon_872e58432369_2"];
@@ -25146,7 +25350,7 @@ interface components {
             description?: components["schemas"]["Anon_ee9224780226_6"];
         };
         FieldDefinitionOutput: {
-            name: components["schemas"]["Anon_9ac136edb99a_20"];
+            name: components["schemas"]["Anon_9ac136edb99a_21"];
             field_type: components["schemas"]["TemplateFieldType"];
             required: components["schemas"]["Anon_f56777819c8b_3"];
             default_value?: components["schemas"]["Anon_44136fa355b3_2"];
@@ -27913,6 +28117,8 @@ type RevTurbineProviderProps<TUser extends RevTurbineUserContext = RevTurbineUse
  *   <App />
  * </RevTurbineProvider>
  * ```
+ *
+ * @public
  */
 declare function RevTurbineProvider<TUser extends RevTurbineUserContext = RevTurbineUserContext, TOptions extends RevTurbineInitInputOptions = RevTurbineInitInputOptions>({ options, bootstrapPlacements, domCapture, colorScheme, children, }: RevTurbineProviderProps<TUser, TOptions>): React__default.JSX.Element;
 
@@ -29285,6 +29491,8 @@ interface UseEntitlementResult {
  *   return <BrandKitEditor />;
  * }
  * ```
+ *
+ * @public
  */
 declare function useEntitlement({ handle, context, autoCheck, autoGate, gatePlacementRequest, }: UseEntitlementOptions): UseEntitlementResult;
 
@@ -29469,6 +29677,8 @@ interface GatedAction<A extends unknown[], R> {
  * telemetry (`${action}_started` → `_completed` / `_failed`) and its return value
  * is preserved. Without a provider, `run` is a safe no-op that reports denied
  * (AC-13).
+ *
+ * @public
  */
 declare function useGatedAction<A extends unknown[], R>(action: string, fn: (...args: A) => Promise<R> | R, context?: RevTurbineEntitlementContext, options?: TrackOptions): GatedAction<A, R>;
 
@@ -29582,6 +29792,8 @@ interface UseCanResult {
  *   return <BatchExportButton warnLowBalance={limited} />;
  * }
  * ```
+ *
+ * @public
  */
 declare function useCan(handle: string, options?: Omit<UseEntitlementOptions, 'handle'>): UseCanResult;