@revturbine/sdk 0.2.91 → 0.3.0

package/dist/headless.d.ts

@@ -15632,6 +15632,16 @@ declare class RevTurbineCustomerSdk {
     private resolveAnonymousId;
     private installBridge;
     private installRouteTracking;
+    /**
+     * Merge a caller-supplied patch into the current user context.
+     *
+     * The single choke point every context entry point flows through
+     * (identify / setUserContext / update / rehydrate), so it is also where the
+     * removed `plan.id` key is rejected — see {@link rejectLegacyPlanId}.
+     *
+     * @param next The caller's patch.
+     * @param verb Which entry point supplied it, for the rejection diagnostic.
+     */
     private mergeUserContext;
     private mergePageContext;
     private collectPageContextIssues;
@@ -15891,6 +15901,32 @@ declare class RevTurbineCustomerSdk {
      * nobody is reading. Never throws — a monetization SDK must not take down
      * the host app over a bad key.
      */
+    /**
+       * Detect and reject the removed `plan.id` identity key (plan 191 Q-1).
+       *
+       * Plan identity is the `unique_handle`; `plan.id` was removed from the user
+       * context. TypeScript rejects it at compile time via {@link Exact}, but a
+       * plain-JS caller — or a stale build — passes it happily, and the failure is
+       * SILENT and consequential: {@link resolveContextPlanRaw} finds no handle, so
+       * the user reads as having no plan and every plan-targeted entitlement rule
+       * quietly stops matching (fail-closed, with no signal).
+       *
+       * So the legacy shape is rejected rather than tolerated: the offending `id`
+       * is stripped from the plan object, the caller gets a prod-visible console
+       * error (once per session, mirroring
+       * {@link reportUnrecognizedContextKeys}), and an `sdk_validation_warning`
+       * rides the anonymous meta lane so the control plane can see integrations
+       * still sending it.
+       *
+       * A plan object carrying BOTH `handle` and `id` keeps the handle — the `id`
+       * is simply dropped, since the handle is the identity.
+       *
+       * @param verb Which entry point received it, for the message and dedupe key.
+       * @param plan The caller-supplied plan object, unvalidated.
+       * @returns The plan object with any legacy `id` removed, or the input
+       *   unchanged when it carries none.
+       */
+    private rejectLegacyPlanId;
     private reportUnrecognizedContextKeys;
     private normalizePlacementOutput;
     private validateTrialStatusShape;