@revturbine/sdk 0.11.3 → 0.11.5

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>>]>;
@@ -20477,6 +20481,16 @@ interface RevTurbineEndpointOverrides {
      */
     legacyInteractions?: string;
     placementTypes: string;
+    /**
+     * Optional sink for registered surface slots.
+     *
+     * RevTurbine hosts **no default route** for this verb (BL-0197). Slot
+     * registration is client-local and discovery is ingestion-driven — the
+     * pipeline derives discovered slots from the `slot_*` telemetry the SDK
+     * already emits through `/api/track`. Set this only when you run your own
+     * slot-inventory service; unset, `registerSurfaceSlot()` performs no
+     * network write.
+     */
     surfaceSlots: string;
 }
 /** Client-side clickstream batching policy (plan 95 TASK-6). */
@@ -21930,6 +21944,30 @@ declare class RevTurbineCustomerSdk {
      * @public
      */
     registerPlacement(config: RevTurbinePlacementConfig): Promise<string>;
+    /**
+     * Mirror a registered surface slot to an explicitly configured backend.
+     *
+     * **Requires an explicit `surfaceSlots` endpoint override** (BL-0197).
+     * There is no default route for this verb and there never was a correct
+     * one: the previous default pointed at `/api/placements`, RevTurbine's
+     * *authored-config* CRUD. That route validates against `PlacementSchema`
+     * (which requires `handle` and `category`), so the legacy surface-slot body
+     * this method sends could only ever be rejected — in production every
+     * non-`local_only` registration failed with
+     * `surface_slot_create_failed:422` and the React runtime turned that into a
+     * `slot_error`.
+     *
+     * It was also wrong in principle. On a same-origin integration the signed-in
+     * user's session cookie authenticates the request, so a body the route *did*
+     * accept would have let merely loading a gated page create a draft placement
+     * in the tenant's Playbook. Only the 422 prevented that.
+     *
+     * Surface-slot **discovery is ingestion-driven**: the SDK emits its
+     * `slot_*` / `placement_*` telemetry through `/api/track` and the pipeline
+     * derives discovered slots from it. Registration itself is client-local.
+     *
+     * @internal
+     */
     private upsertSurfaceSlot;
     /**
      * Build the internal placement record for a surface-slot config.
@@ -21952,6 +21990,18 @@ declare class RevTurbineCustomerSdk {
      * @internal
      */
     private commitSurfaceSlotRecord;
+    /**
+     * Register a surface slot with the local runtime and return its placement id.
+     *
+     * **Client-local by default** (BL-0197): this performs no network write. The
+     * slot is recorded in the in-process registry, and the pipeline discovers it
+     * from the `slot_*` / `placement_*` telemetry the SDK emits through
+     * `/api/track`. A write happens only when `custom_endpoints.surfaceSlots`
+     * points at a slot-inventory service you run; there is no fallback to
+     * `/api/placements`.
+     *
+     * @public
+     */
     registerSurfaceSlot(config: RevTurbineSurfaceSlotConfig): Promise<string>;
     /**
      * Persist authored placement types to a configured backend.
@@ -24431,6 +24481,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 +24912,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"];