@revturbine/sdk 0.2.61 → 0.2.62

package/dist/headless.d.ts

@@ -11665,7 +11665,15 @@ interface RevTurbineContextPolicy {
 /**
  * Feature flags for placement pipeline behavior that may alter decision semantics.
  *
- * All flags default to `false` to preserve backward compatibility.
+ * Each flag defaults to what the loaded Playbook authors (plan 174 TASK-2 /
+ * F-72): authored payload caps (`caps.max_per_period` / `caps.cooldown_days`
+ * or a `remind_later_minutes` window) turn on client caps enforcement; a
+ * `gated`-category placement turns on auto gated placement; a
+ * `trials`-category placement turns on trial auto-triggers. A Playbook that
+ * authors none of these leaves every flag `false` — existing integrations
+ * whose config authors nothing are unchanged. An explicit
+ * {@link RevTurbineInitOptions.placementBehavior} value (true or false)
+ * always overrides the derived default.
  */
 interface RevTurbinePlacementBehaviorFlags {
     /** Enable client-side payload cap enforcement (max-per-period + cooldown precedence). */
@@ -11911,10 +11919,13 @@ interface RevTurbineInitOptions {
     page?: RevTurbinePageContext;
     contextPolicy?: RevTurbineContextPolicy;
     /**
-     * Opt-in flags for placement decision behavior changes.
+     * Explicit overrides for placement decision behavior flags.
      *
-     * Defaults are conservative (`false`) so existing integrations do not change behavior
-     * until explicitly enabled.
+     * When omitted, each flag derives from what the loaded Playbook authors —
+     * caps authored → enforcement on; gated placements authored → auto-gating
+     * on; trial placements authored → trial triggers on (plan 174 TASK-2 /
+     * F-72). Set a flag here (true or false) to pin it regardless of the
+     * Playbook.
      */
     placementBehavior?: Partial<RevTurbinePlacementBehaviorFlags>;
     extension?: {
@@ -12426,7 +12437,8 @@ declare class RevTurbineCustomerSdk {
     private readonly mode;
     private readonly policy;
     private readonly extensionEnabled;
-    private readonly placementBehavior;
+    private readonly placementBehaviorOverrides;
+    private derivedPlacementBehaviorMemo;
     private readonly providerFailureSlotBehavior;
     private readonly uiPathResolvers;
     private unbridgeUiPathCtaResolvers;
@@ -12491,6 +12503,15 @@ declare class RevTurbineCustomerSdk {
     private resolveConfigProvider;
     private refreshExportedConfigSnapshot;
     private getConfiguredExportedConfig;
+    /**
+     * Effective placement-behavior flags: an explicit init override wins;
+     * otherwise each flag derives from what the loaded Playbook authors
+     * (plan 174 TASK-2 / F-72). Resolved at read time so hosted modes pick up
+     * the derivation once the config snapshot loads — every consumer reads
+     * through this one resolver.
+     */
+    private get placementBehavior();
+    private derivePlacementBehaviorFromPlaybook;
     private rebuildSegmentPredicateFieldIndex;
     /**
      * The config-driven placement resolver (core `createStaticPlacementResolver`