@trillboards/ads-sdk 2.0.0 → 2.1.0

package/dist/react-native.d.mts

@@ -15,6 +15,7 @@ interface TrillboardsConfig {
     programmaticRetry?: number;
     programmaticBackoffMax?: number;
     cacheSize?: number;
+    debug?: boolean;
 }
 type WaterfallMode = 'programmatic_only' | 'programmatic_then_direct' | 'direct_only';
 interface AdItem {

package/dist/react-native.d.ts

@@ -15,6 +15,7 @@ interface TrillboardsConfig {
     programmaticRetry?: number;
     programmaticBackoffMax?: number;
     cacheSize?: number;
+    debug?: boolean;
 }
 type WaterfallMode = 'programmatic_only' | 'programmatic_then_direct' | 'direct_only';
 interface AdItem {

package/dist/react.d.mts

@@ -16,6 +16,7 @@ interface TrillboardsConfig {
     programmaticRetry?: number;
     programmaticBackoffMax?: number;
     cacheSize?: number;
+    debug?: boolean;
 }
 type WaterfallMode = 'programmatic_only' | 'programmatic_then_direct' | 'direct_only';
 interface AdItem {

package/dist/react.d.ts

@@ -16,6 +16,7 @@ interface TrillboardsConfig {
     programmaticRetry?: number;
     programmaticBackoffMax?: number;
     cacheSize?: number;
+    debug?: boolean;
 }
 type WaterfallMode = 'programmatic_only' | 'programmatic_then_direct' | 'direct_only';
 interface AdItem {

package/dist/react.js

@@ -42,7 +42,8 @@ function resolveConfig(userConfig) {
     programmaticMinInterval: Math.max(userConfig.programmaticMinInterval ?? DEFAULT_CONFIG.PROGRAMMATIC_MIN_INTERVAL_MS, 1e3),
     programmaticRetry: Math.max(userConfig.programmaticRetry ?? DEFAULT_CONFIG.PROGRAMMATIC_RETRY_MS, 1e3),
     programmaticBackoffMax: Math.max(userConfig.programmaticBackoffMax ?? DEFAULT_CONFIG.PROGRAMMATIC_BACKOFF_MAX_MS, 5e3),
-    cacheSize: Math.max(userConfig.cacheSize ?? DEFAULT_CONFIG.CACHE_SIZE, 1)
+    cacheSize: Math.max(userConfig.cacheSize ?? DEFAULT_CONFIG.CACHE_SIZE, 1),
+    debug: userConfig.debug ?? false
   };
 }
 
@@ -169,6 +170,64 @@ var EventEmitter = class {
   }
 };
 
+// src/logger.ts
+var LEVEL_PRIORITY = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3,
+  none: 4
+};
+var PREFIX = "[Trillboards]";
+var Logger = class {
+  constructor() {
+    this.level = "none";
+  }
+  setLevel(level) {
+    this.level = level;
+  }
+  getLevel() {
+    return this.level;
+  }
+  debug(message, data) {
+    if (LEVEL_PRIORITY[this.level] <= LEVEL_PRIORITY.debug) {
+      if (data !== void 0) {
+        console.debug(PREFIX, message, data);
+      } else {
+        console.debug(PREFIX, message);
+      }
+    }
+  }
+  info(message, data) {
+    if (LEVEL_PRIORITY[this.level] <= LEVEL_PRIORITY.info) {
+      if (data !== void 0) {
+        console.info(PREFIX, message, data);
+      } else {
+        console.info(PREFIX, message);
+      }
+    }
+  }
+  warn(message, data) {
+    if (LEVEL_PRIORITY[this.level] <= LEVEL_PRIORITY.warn) {
+      if (data !== void 0) {
+        console.warn(PREFIX, message, data);
+      } else {
+        console.warn(PREFIX, message);
+      }
+    }
+  }
+  error(message, data) {
+    if (LEVEL_PRIORITY[this.level] <= LEVEL_PRIORITY.error) {
+      if (data !== void 0) {
+        console.error(PREFIX, message, data);
+      } else {
+        console.error(PREFIX, message);
+      }
+    }
+  }
+};
+var logger = new Logger();
+
 // src/api/client.ts
 function getPlayerTruth(container) {
   if (typeof window === "undefined") {
@@ -218,6 +277,7 @@ var ApiClient = class {
    * The request is aborted after 10 seconds.
    */
   async fetchAds(deviceId, etag = null) {
+    logger.debug("Fetching ads", { deviceId });
     const headers = { Accept: "application/json" };
     if (etag) headers["If-None-Match"] = etag;
     const controller = new AbortController();
@@ -252,7 +312,7 @@ var ApiClient = class {
       }
       const data = await response.json();
       const newEtag = response.headers.get("ETag");
-      return {
+      const result = {
         ads: data.data?.ads ?? [],
         settings: data.data?.settings ?? {},
         programmatic: data.data?.header_bidding_settings ?? null,
@@ -262,6 +322,8 @@ var ApiClient = class {
         etag: newEtag,
         notModified: false
       };
+      logger.debug("Ads fetched", { deviceId, count: result.ads.length, notModified: false });
+      return result;
     } catch (error) {
       clearTimeout(timeoutId);
       throw error;
@@ -277,6 +339,7 @@ var ApiClient = class {
    * Returns `true` if the server acknowledged the impression.
    */
   async reportImpression(impression) {
+    logger.debug("Reporting impression", { adId: impression.adid, impressionId: impression.impid });
     try {
       const params = new URLSearchParams({
         adid: impression.adid,
@@ -300,6 +363,7 @@ var ApiClient = class {
    * Returns `true` on 2xx, `false` on any error.
    */
   async sendHeartbeat(deviceId, screenId) {
+    logger.debug("Sending heartbeat", { deviceId });
     try {
       const response = await fetch(`${this.apiBase}/device/${deviceId}/heartbeat`, {
         method: "POST",
@@ -322,6 +386,7 @@ var ApiClient = class {
    * error, etc.) to the analytics backend.
    */
   async reportProgrammaticEvent(event) {
+    logger.debug("Reporting programmatic event", { eventType: event.eventType });
     try {
       const response = await fetch(`${this.apiBase}/programmatic-event`, {
         method: "POST",