@adzenai/core 1.2.4 → 1.2.5

package/README.md

@@ -33,10 +33,10 @@ import {
 | `AdzenDecision` | API response wrapper (`"serve"` or `"no_match"` with optional placement) |
 | `TrackingInfo` | Render/view/click tracking URLs |
 | `AdzenBaseConfig` | Shared config interface (`apiKey`, `endpointUrl`, `timeoutMs`) |
-| `InlineAdEvent` | In-message creative delivered by an `adzen_inline` SSE event; `paragraph_index` (with `ad_id`) is its placement instance key |
+| `InlineAdEvent` | In-message creative delivered by an `adzen_inline` SSE event; `paragraph_index` (with `ad_id`) is its placement instance key, and an optional absolute `content_offset` is the backend-authoritative render position (UTF-16 index) |
 | `InlineAdCreative` | Inline creative fields (`headline`, `cta_text`, `destination_url`, `format`, `label`, optional `advertiser_name`) |
 | `InlineAdEventPayload` | `InlineAdEvent` (including `paragraph_index`) plus `message_id` and `content_offset`, the character position in the message the ad is anchored to |
-| `AdAnchorEvent` | Payload of the `adzen_ad_anchor` SSE event (`version`, `paragraph_index`); reserves a paragraph's render offset before the matching `adzen_inline` arrives |
+| `AdAnchorEvent` | Payload of the `adzen_ad_anchor` SSE event (`version`, `paragraph_index`, optional absolute `content_offset`); reserves a paragraph's render position before the matching `adzen_inline` arrives |
 
 Static-channel types are also exported: `DecisionRequest`, `Decision`, `Creative`, `SlotSpec`, `BannerCreative`, `NativeCreative`, and more.
 

package/dist/index.d.cts

@@ -53,6 +53,15 @@ interface InlineAdEvent {
      * being deduped to the first.
      */
     paragraph_index: number;
+    /**
+     * Absolute render position: the ad is inserted at this index in the
+     * accumulated assistant text (`text.slice(0, content_offset)` is everything
+     * before it). Cumulative for the message and measured in UTF-16 code units —
+     * the same unit as JavaScript `String.length`/`.slice`, so no conversion is
+     * needed. Optional for back-compat: older servers omit it and the middleware
+     * falls back to the anchor reservation or the live stream cursor.
+     */
+    content_offset?: number;
     position: string;
     creative: InlineAdCreative;
     tracking: {
@@ -123,6 +132,13 @@ interface AdzenStreamInlineEvent {
 interface AdAnchorEvent {
     version: number;
     paragraph_index: number;
+    /**
+     * Absolute UTF-16 render position for the paragraph this anchor reserves,
+     * matching the `content_offset` on the `adzen_inline` that may follow.
+     * Optional for back-compat: older servers omit it and the middleware records
+     * the live stream cursor instead.
+     */
+    content_offset?: number;
 }
 interface AdzenStreamAnchorEvent {
     type: "adzen_ad_anchor";

package/dist/index.d.ts

@@ -53,6 +53,15 @@ interface InlineAdEvent {
      * being deduped to the first.
      */
     paragraph_index: number;
+    /**
+     * Absolute render position: the ad is inserted at this index in the
+     * accumulated assistant text (`text.slice(0, content_offset)` is everything
+     * before it). Cumulative for the message and measured in UTF-16 code units —
+     * the same unit as JavaScript `String.length`/`.slice`, so no conversion is
+     * needed. Optional for back-compat: older servers omit it and the middleware
+     * falls back to the anchor reservation or the live stream cursor.
+     */
+    content_offset?: number;
     position: string;
     creative: InlineAdCreative;
     tracking: {
@@ -123,6 +132,13 @@ interface AdzenStreamInlineEvent {
 interface AdAnchorEvent {
     version: number;
     paragraph_index: number;
+    /**
+     * Absolute UTF-16 render position for the paragraph this anchor reserves,
+     * matching the `content_offset` on the `adzen_inline` that may follow.
+     * Optional for back-compat: older servers omit it and the middleware records
+     * the live stream cursor instead.
+     */
+    content_offset?: number;
 }
 interface AdzenStreamAnchorEvent {
     type: "adzen_ad_anchor";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adzenai/core",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "description": "Core types and utilities for the Adzen AI ad SDK",
   "license": "MIT",
   "type": "module",