@adzenai/core 1.2.3 → 1.2.4

package/README.md

@@ -36,6 +36,7 @@ import {
 | `InlineAdEvent` | In-message creative delivered by an `adzen_inline` SSE event; `paragraph_index` (with `ad_id`) is its placement instance key |
 | `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 |
 
 Static-channel types are also exported: `DecisionRequest`, `Decision`, `Creative`, `SlotSpec`, `BannerCreative`, `NativeCreative`, and more.
 

package/dist/index.d.cts

@@ -113,11 +113,26 @@ interface AdzenStreamInlineEvent {
     type: "adzen_inline";
     data: InlineAdEvent;
 }
+/**
+ * Wire payload of the `adzen_ad_anchor` SSE event. Emitted the instant a
+ * paragraph closes (before matching runs), it reserves the render slot for the
+ * `adzen_inline` event that may follow for the same `paragraph_index`, so the
+ * ad lands at the paragraph boundary rather than wherever the live cursor has
+ * advanced to by the time the (match-latency-delayed) ad arrives.
+ */
+interface AdAnchorEvent {
+    version: number;
+    paragraph_index: number;
+}
+interface AdzenStreamAnchorEvent {
+    type: "adzen_ad_anchor";
+    data: AdAnchorEvent;
+}
 interface AdzenStreamContentEvent {
     type: "content";
     data: string;
 }
-type AdzenStreamEvent = AdzenStreamStartEvent | AdzenStreamEndEvent | AdzenStreamErrorEvent | AdzenStreamInlineEvent | AdzenStreamContentEvent;
+type AdzenStreamEvent = AdzenStreamStartEvent | AdzenStreamEndEvent | AdzenStreamErrorEvent | AdzenStreamInlineEvent | AdzenStreamAnchorEvent | AdzenStreamContentEvent;
 type AdzenEnv = "prod" | "stg" | "dev";
 type AdzenFormat = "banner" | "native" | "sticky" | "in-feed";
 type SlotPosition = "atf" | "btf";
@@ -279,4 +294,4 @@ interface ViewabilityOptions {
 }
 declare function observeViewability(options: ViewabilityOptions): () => void;
 
-export { type AbContext, type AdzenApi, type AdzenBaseConfig, type AdzenConsent, type AdzenDefaults, type AdzenEnv, type AdzenError, type AdzenFormat, type AdzenPlacement, type AdzenQueueItem, type AdzenStaticConfig, type AdzenStreamContentEvent, type AdzenStreamEndEvent, type AdzenStreamErrorEvent, type AdzenStreamEvent, type AdzenStreamInlineEvent, type AdzenStreamStartEvent, type BannerCreative, type Beacons, type Creative, type Decision, type DecisionRequest, type DecisionResponse, type InlineAdCreative, type InlineAdEvent, type InlineAdEventPayload, type NativeCreative, type PageContext, type PlacementRecord, type PlacementsResponse, type ProcessResponse, type ProcessResponseAd, type ResolvedAdzenStaticConfig, type SlotPosition, type SlotSpec, type StickyCreative, type UserContext, type ViewabilityOptions, type ViewportContext, ensureTid, observeViewability, readTid, registerErrorSink, reportError, safeRun, safeRunAsync, uuidv4 };
+export { type AbContext, type AdAnchorEvent, type AdzenApi, type AdzenBaseConfig, type AdzenConsent, type AdzenDefaults, type AdzenEnv, type AdzenError, type AdzenFormat, type AdzenPlacement, type AdzenQueueItem, type AdzenStaticConfig, type AdzenStreamAnchorEvent, type AdzenStreamContentEvent, type AdzenStreamEndEvent, type AdzenStreamErrorEvent, type AdzenStreamEvent, type AdzenStreamInlineEvent, type AdzenStreamStartEvent, type BannerCreative, type Beacons, type Creative, type Decision, type DecisionRequest, type DecisionResponse, type InlineAdCreative, type InlineAdEvent, type InlineAdEventPayload, type NativeCreative, type PageContext, type PlacementRecord, type PlacementsResponse, type ProcessResponse, type ProcessResponseAd, type ResolvedAdzenStaticConfig, type SlotPosition, type SlotSpec, type StickyCreative, type UserContext, type ViewabilityOptions, type ViewportContext, ensureTid, observeViewability, readTid, registerErrorSink, reportError, safeRun, safeRunAsync, uuidv4 };

package/dist/index.d.ts

@@ -113,11 +113,26 @@ interface AdzenStreamInlineEvent {
     type: "adzen_inline";
     data: InlineAdEvent;
 }
+/**
+ * Wire payload of the `adzen_ad_anchor` SSE event. Emitted the instant a
+ * paragraph closes (before matching runs), it reserves the render slot for the
+ * `adzen_inline` event that may follow for the same `paragraph_index`, so the
+ * ad lands at the paragraph boundary rather than wherever the live cursor has
+ * advanced to by the time the (match-latency-delayed) ad arrives.
+ */
+interface AdAnchorEvent {
+    version: number;
+    paragraph_index: number;
+}
+interface AdzenStreamAnchorEvent {
+    type: "adzen_ad_anchor";
+    data: AdAnchorEvent;
+}
 interface AdzenStreamContentEvent {
     type: "content";
     data: string;
 }
-type AdzenStreamEvent = AdzenStreamStartEvent | AdzenStreamEndEvent | AdzenStreamErrorEvent | AdzenStreamInlineEvent | AdzenStreamContentEvent;
+type AdzenStreamEvent = AdzenStreamStartEvent | AdzenStreamEndEvent | AdzenStreamErrorEvent | AdzenStreamInlineEvent | AdzenStreamAnchorEvent | AdzenStreamContentEvent;
 type AdzenEnv = "prod" | "stg" | "dev";
 type AdzenFormat = "banner" | "native" | "sticky" | "in-feed";
 type SlotPosition = "atf" | "btf";
@@ -279,4 +294,4 @@ interface ViewabilityOptions {
 }
 declare function observeViewability(options: ViewabilityOptions): () => void;
 
-export { type AbContext, type AdzenApi, type AdzenBaseConfig, type AdzenConsent, type AdzenDefaults, type AdzenEnv, type AdzenError, type AdzenFormat, type AdzenPlacement, type AdzenQueueItem, type AdzenStaticConfig, type AdzenStreamContentEvent, type AdzenStreamEndEvent, type AdzenStreamErrorEvent, type AdzenStreamEvent, type AdzenStreamInlineEvent, type AdzenStreamStartEvent, type BannerCreative, type Beacons, type Creative, type Decision, type DecisionRequest, type DecisionResponse, type InlineAdCreative, type InlineAdEvent, type InlineAdEventPayload, type NativeCreative, type PageContext, type PlacementRecord, type PlacementsResponse, type ProcessResponse, type ProcessResponseAd, type ResolvedAdzenStaticConfig, type SlotPosition, type SlotSpec, type StickyCreative, type UserContext, type ViewabilityOptions, type ViewportContext, ensureTid, observeViewability, readTid, registerErrorSink, reportError, safeRun, safeRunAsync, uuidv4 };
+export { type AbContext, type AdAnchorEvent, type AdzenApi, type AdzenBaseConfig, type AdzenConsent, type AdzenDefaults, type AdzenEnv, type AdzenError, type AdzenFormat, type AdzenPlacement, type AdzenQueueItem, type AdzenStaticConfig, type AdzenStreamAnchorEvent, type AdzenStreamContentEvent, type AdzenStreamEndEvent, type AdzenStreamErrorEvent, type AdzenStreamEvent, type AdzenStreamInlineEvent, type AdzenStreamStartEvent, type BannerCreative, type Beacons, type Creative, type Decision, type DecisionRequest, type DecisionResponse, type InlineAdCreative, type InlineAdEvent, type InlineAdEventPayload, type NativeCreative, type PageContext, type PlacementRecord, type PlacementsResponse, type ProcessResponse, type ProcessResponseAd, type ResolvedAdzenStaticConfig, type SlotPosition, type SlotSpec, type StickyCreative, type UserContext, type ViewabilityOptions, type ViewportContext, ensureTid, observeViewability, readTid, registerErrorSink, reportError, safeRun, safeRunAsync, uuidv4 };

package/package.json

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