@trillboards/ads-sdk 2.2.1 → 2.3.1

package/dist/index.d.mts

@@ -35,6 +35,11 @@ interface ProgrammaticSettings {
     variant_name: string | null;
     min_interval_seconds?: number;
     sources?: VastSource[];
+    vast_waterfall?: {
+        enabled: boolean;
+        sources: VastSource[];
+        total_timeout_ms: number;
+    };
     auction_winner?: AuctionWinner | null;
 }
 interface VastSource {
@@ -42,7 +47,7 @@ interface VastSource {
     vast_url: string;
     priority: number;
     timeout_ms: number;
-    enabled: boolean;
+    enabled?: boolean;
 }
 interface AuctionWinner {
     source: string;

package/dist/index.d.ts

@@ -35,6 +35,11 @@ interface ProgrammaticSettings {
     variant_name: string | null;
     min_interval_seconds?: number;
     sources?: VastSource[];
+    vast_waterfall?: {
+        enabled: boolean;
+        sources: VastSource[];
+        total_timeout_ms: number;
+    };
     auction_winner?: AuctionWinner | null;
 }
 interface VastSource {
@@ -42,7 +47,7 @@ interface VastSource {
     vast_url: string;
     priority: number;
     timeout_ms: number;
-    enabled: boolean;
+    enabled?: boolean;
 }
 interface AuctionWinner {
     source: string;

package/dist/index.js

@@ -320,10 +320,17 @@ var ApiClient = class {
       }
       const data = await response.json();
       const newEtag = response.headers.get("ETag");
+      const hbs = data.data?.header_bidding_settings;
       const result = {
         ads: data.data?.ads ?? [],
         settings: data.data?.settings ?? {},
-        programmatic: data.data?.header_bidding_settings ?? null,
+        programmatic: hbs ? {
+          ...hbs,
+          sources: (hbs.vast_waterfall?.sources ?? []).map((s) => ({
+            ...s,
+            enabled: s.enabled !== false
+          }))
+        } : null,
         screenId: data.data?.screen_id ?? null,
         screenOrientation: data.data?.screen_orientation ?? null,
         screenDimensions: data.data?.screen_dimensions ?? null,
@@ -921,7 +928,7 @@ var WaterfallEngine = class {
    */
   getNextSource(sources) {
     if (!sources || sources.length === 0) return null;
-    const sorted = [...sources].filter((s) => s.enabled).sort((a, b) => a.priority - b.priority || Math.random() - 0.5);
+    const sorted = [...sources].filter((s) => s.enabled !== false).sort((a, b) => a.priority - b.priority || Math.random() - 0.5);
     for (const source of sorted) {
       if (this.circuitBreaker.isAvailable(source.name)) {
         return { source, vastUrl: source.vast_url };
@@ -936,7 +943,7 @@ var WaterfallEngine = class {
    */
   getAvailableSources(sources) {
     if (!sources || sources.length === 0) return [];
-    return sources.filter((s) => s.enabled && this.circuitBreaker.isAvailable(s.name)).sort((a, b) => a.priority - b.priority || Math.random() - 0.5).map((source) => ({ source, vastUrl: source.vast_url }));
+    return sources.filter((s) => s.enabled !== false && this.circuitBreaker.isAvailable(s.name)).sort((a, b) => a.priority - b.priority || Math.random() - 0.5).map((source) => ({ source, vastUrl: source.vast_url }));
   }
   /** Record a successful ad fill for a source. */
   recordSuccess(sourceName) {
@@ -949,7 +956,7 @@ var WaterfallEngine = class {
 };
 
 // src/player/ProgrammaticPlayer.ts
-var ProgrammaticPlayer = class {
+var _ProgrammaticPlayer = class _ProgrammaticPlayer {
   constructor(events, timeoutMs = 12e3) {
     // ── Public state ──────────────────────────────────────────
     this.vastTagUrl = null;
@@ -1036,8 +1043,11 @@ var ProgrammaticPlayer = class {
     this.telemetry.recordRequest();
     const correlator = Date.now();
     const finalUrl = vastUrl.includes("correlator=") ? vastUrl.replace(/correlator=[^&]*/, `correlator=${correlator}`) : `${vastUrl}${vastUrl.includes("?") ? "&" : "?"}correlator=${correlator}`;
-    if (typeof google === "undefined" || !google?.ima) {
-      onError("Google IMA SDK not loaded");
+    const imaReady = await this.ensureImaSdk();
+    if (!imaReady) {
+      const msg = "Google IMA SDK not loaded";
+      this.events.emit("programmatic_error", { error: msg, code: void 0 });
+      onError(msg);
       this.telemetry.recordError();
       this.waterfallEngine.recordFailure(sourceName);
       return;
@@ -1054,6 +1064,50 @@ var ProgrammaticPlayer = class {
       onError(err instanceof Error ? err.message : String(err));
     }
   }
+  /**
+   * Ensure Google IMA SDK is available. If already loaded, resolves
+   * immediately. Otherwise injects the `<script>` tag and waits.
+   * Matches the Lite SDK's `loadImaScript()` pattern.
+   */
+  async ensureImaSdk() {
+    if (typeof google !== "undefined" && google?.ima) return true;
+    if (typeof document === "undefined") return false;
+    const existing = document.querySelector(
+      `script[src="${_ProgrammaticPlayer.IMA_SDK_URL}"]`
+    );
+    if (existing) {
+      return new Promise((resolve) => {
+        const start = Date.now();
+        const check = () => {
+          if (typeof google !== "undefined" && google?.ima) {
+            resolve(true);
+          } else if (Date.now() - start > 5e3) {
+            resolve(false);
+          } else {
+            setTimeout(check, 100);
+          }
+        };
+        check();
+      });
+    }
+    if (!_ProgrammaticPlayer.imaLoadPromise) {
+      _ProgrammaticPlayer.imaLoadPromise = new Promise((resolve) => {
+        const script = document.createElement("script");
+        script.src = _ProgrammaticPlayer.IMA_SDK_URL;
+        script.async = true;
+        script.onload = () => {
+          _ProgrammaticPlayer.imaLoadPromise = null;
+          resolve(true);
+        };
+        script.onerror = () => {
+          _ProgrammaticPlayer.imaLoadPromise = null;
+          resolve(false);
+        };
+        document.head.appendChild(script);
+      });
+    }
+    return _ProgrammaticPlayer.imaLoadPromise;
+  }
   // ── IMA request / playback lifecycle ──────────────────────
   async requestAdsViaIMA(vastUrl, onComplete, onError) {
     return new Promise((resolve) => {
@@ -1255,6 +1309,12 @@ var ProgrammaticPlayer = class {
     this.telemetry.reset();
   }
 };
+// ── IMA SDK loader ──────────────────────────────────────────
+/** IMA script URL */
+_ProgrammaticPlayer.IMA_SDK_URL = "https://imasdk.googleapis.com/js/sdkloader/ima3.js";
+/** Singleton load promise so concurrent calls don't insert multiple scripts. */
+_ProgrammaticPlayer.imaLoadPromise = null;
+var ProgrammaticPlayer = _ProgrammaticPlayer;
 
 // src/player/Player.ts
 var MAX_AD_DURATION_SECONDS = 300;