@revturbine/sdk 0.11.3 → 0.11.4

package/CHANGELOG.md

@@ -47,6 +47,39 @@ also require a changelog entry.
 
 ---
 
+## 0.11.4
+
+### The treatment-interaction wire record now carries `rule_handle` (BL-0200)
+
+**What changed.** `flushInteractionQueue`'s projection onto
+`POST /api/events/interactions` now includes `rule_handle`, taken from the same
+`ruleHandle` on `RevTurbineTreatmentInteractionInput` that 0.11.3 began stamping
+on the `placement_interaction` clickstream event.
+
+0.11.3 deliberately kept it off this record, and #530 asserted the omission with
+a "never reaches the treatment-interaction wire record" test. The reasoning was
+that the clickstream carries payload fields inside a JSON column — readable the
+moment a producer sends them — while this record is column-shaped
+(`placement_presentations`) and a new key needed a datasource migration.
+
+The migration has since landed (revturbine-web ledger 015 added
+`placement_exposure_attribution.rule_handle`), and the field is now declared on
+`TreatmentInteractionInputSchema` (`revturbine-scaffold#394`, published as
+`@revt-eng/*` v0.1.342). Sending it lets the app record the rule an exposure was
+**decided by**, on the base exposure row, instead of waiting for the attribution
+worker to reconstruct one from the clickstream when a conversion lands — which
+is what makes presentation-grain analytics cuts per rule honest rather than
+computed over the converted subset.
+
+**Nothing to change in your integration.** `ruleHandle` was already public and
+already populated by every `PlacementController` path; this only widens where the
+value is sent. Spread, not set: the key is **absent** when no decision was in
+scope. The contract accepts an explicit `null` for "a rule was selected and none
+matched", but the SDK cannot distinguish that from "no decision in scope" —
+`PlacementOutput.rule_id` is simply missing in both — so it asserts neither.
+
+**No `@public` surface moved**, hence a patch release.
+
 ## 0.11.3
 
 ### `placement_interaction` now carries `rule_handle` (BL-0182)

package/dist/headless.d.ts

@@ -7103,6 +7103,7 @@ declare const TreatmentInteractionInputSchema: z.ZodObject<{
     message_block_id: z.ZodOptional<z.ZodString>;
     experiment_id: z.ZodOptional<z.ZodString>;
     variant_key: z.ZodOptional<z.ZodString>;
+    rule_handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     test: z.ZodOptional<z.ZodBoolean>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
@@ -7144,6 +7145,7 @@ declare const TreatmentInteractionBatchSchema: z.ZodArray<z.ZodObject<{
     message_block_id: z.ZodOptional<z.ZodString>;
     experiment_id: z.ZodOptional<z.ZodString>;
     variant_key: z.ZodOptional<z.ZodString>;
+    rule_handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     test: z.ZodOptional<z.ZodBoolean>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>>;
@@ -7173,6 +7175,7 @@ declare const TreatmentInteractionRequestSchema: z.ZodUnion<readonly [z.ZodObjec
     message_block_id: z.ZodOptional<z.ZodString>;
     experiment_id: z.ZodOptional<z.ZodString>;
     variant_key: z.ZodOptional<z.ZodString>;
+    rule_handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     test: z.ZodOptional<z.ZodBoolean>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>, z.ZodArray<z.ZodObject<{
@@ -7196,6 +7199,7 @@ declare const TreatmentInteractionRequestSchema: z.ZodUnion<readonly [z.ZodObjec
     message_block_id: z.ZodOptional<z.ZodString>;
     experiment_id: z.ZodOptional<z.ZodString>;
     variant_key: z.ZodOptional<z.ZodString>;
+    rule_handle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     test: z.ZodOptional<z.ZodBoolean>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>>]>;
@@ -24431,6 +24435,7 @@ interface components {
             message_block_id?: components["schemas"]["Anon_4e04ec5cc4e6_10"];
             experiment_id?: components["schemas"]["Anon_4e04ec5cc4e6_11"];
             variant_key?: components["schemas"]["Anon_4e04ec5cc4e6_12"];
+            rule_handle?: components["schemas"]["Anon_94b7b4f4c44a"];
             test?: components["schemas"]["Anon_fb9ddeea992e_3"];
             metadata?: components["schemas"]["Anon_a249e58b3222"];
         };
@@ -24861,6 +24866,8 @@ interface components {
         Anon_9ac136edb99a_17: string;
         Anon_4e04ec5cc4e6_12: components["schemas"]["Anon_9ac136edb99a_18"];
         Anon_9ac136edb99a_18: string;
+        Anon_94b7b4f4c44a: components["schemas"]["Anon_904af497346b"];
+        Anon_904af497346b: string | null;
         Anon_fb9ddeea992e_3: components["schemas"]["Anon_7cb541e84f22_31"];
         Anon_7cb541e84f22_31: boolean;
         Anon_a249e58b3222: components["schemas"]["Anon_c65c1fbd5acf_8"];