@revturbine/sdk 0.11.20 → 0.11.22

package/CHANGELOG.md

@@ -47,6 +47,56 @@ also require a changelog entry.
 
 ---
 
+## 0.11.22
+
+### Message slots never show Fixed or Access Gate content (D-62)
+
+**What changed.** Behaviour change in every port; no signature changes.
+
+- A message slot (`<MessageSurfaceSlot>`, `surface_slot_category: triggered`)
+  shows only RT-initiated placements: usage/credit/seat and trial alerts,
+  conversion/expansion and retention nudges. 0.11.21 treated this as a
+  preference — Fixed content still rendered when no RT-initiated placement
+  qualified. Now the slot shows nothing in that case. Access Gate content was
+  already excluded (D-60).
+- The filter judges by category tier, so every category spelling agrees.
+- **Scaffold pin 0.1.409 → 0.1.411** (revturbine-scaffold #473; vendored `types.py` / `types.rs` refreshed).
+
+**Landed in** 0.11.22. **Fail-closed in** 0.11.22.
+
+**Proving tests.** D-62 blocks in scaffold `local-resolver.test.ts`, py
+`TestMessageSlotsShowOnlyRtInitiated`, rs `d62_*` in `tests/static_resolver.rs`.
+
+## 0.11.21
+
+### `getPlacement` is a pure function of (user context, Playbook) (D-39, BL-0379)
+
+**What changed.** Behaviour change in the browser SDK; no signature changes.
+
+- **One decision path.** `getPlacement(config)` resolves the Playbook's
+  authored slot through the same decision path as `getPlacementDecision` and
+  the server SDKs' `get_placement` / `LocalRuntime.getPlacement`. 0.11.20 first
+  consulted a lane of previously decided or seeded outputs and ranked them with
+  a separate selection layer (category bucket, urgency, score), so it could
+  return a different placement than the decision path for the same user.
+- **Always current.** Each call reflects the current user context; the only
+  caching is the decision path's own memo keyed by the request and context.
+- **`getPlacementContent`** in local-only mode now decides through the same
+  path instead of reading seeded outputs.
+- **Deprecated, ignored:** `localRuntime.initialData.placementsByLookupKey`
+  (warns once when supplied). Author placements in `localRuntime.playbook`, or
+  implement the `getPlacement` resolver for a custom source. The field, and
+  core's `resolveLocalPlacementFromCandidates` selection helper, are removed in
+  0.12.0 (BL-0167).
+- **Live design partner:** an integration that seeded placement outputs, or
+  relied on the old cached ranking, now sees the Playbook's decision.
+
+**Landed in** 0.11.21. **Fail-closed in** 0.11.21.
+
+**Proving tests.** `web-sdk/pure-getplacement.test.ts` (browser `getPlacement`
+equals the server runtime for the same inputs; reflects a changed user
+context; ignores seeded outputs); `web-sdk/customer-side-fixed-only.test.ts`.
+
 ## 0.11.20
 
 ### One entitlement answer for browser and server, with Entitlement Mirroring; Access Gates only fire while denied (D-60, D-61)

package/dist/headless.d.ts

@@ -31522,6 +31522,11 @@ interface RevTurbineEventBatchingOptions {
 }
 interface RevTurbineLocalRuntimeData {
     placementDecisionsByPlacementId?: Record<string, RevTurbinePlacementDecision>;
+    /**
+     * @deprecated Ignored since 0.11.21 (D-39 / BL-0379): `getPlacement` is a
+     * pure function of the user context and `localRuntime.playbook`, so
+     * pre-decided outputs are never consulted. Removed in 0.12.0.
+     */
     placementsByLookupKey?: Record<string, PlacementOutput | null>;
     entitlementByHandle?: Record<string, EntitlementResult>;
     userContextByUserId?: Record<string, UserTargetingContext>;
@@ -32299,7 +32304,6 @@ declare class RevTurbineCustomerSdk {
     private pendingConversionPlan?;
     private usageBalances;
     private localDecisionsByPlacementId;
-    private localPlacementsByLookupKey;
     private localEntitlementsByHandle;
     private localUserContextsByUserId;
     /**
@@ -32600,12 +32604,6 @@ declare class RevTurbineCustomerSdk {
      */
     private hasEndpointOverride;
     private endpointFor;
-    private localPlacementLookupKey;
-    private localLookupMatchesConfig;
-    private localOutputMatchesConfig;
-    private applyCategoryConflictSuppression;
-    private resolveLocalPlacementFromCandidates;
-    private localPlacementForConfig;
     /**
      * The `placement_slots[]` entry the loaded Playbook authors for a request.
      *