@trillboards/ads-sdk 2.0.0 → 2.1.0

package/dist/index.mjs

@@ -1,5 +1,5 @@
 // src/core/config.ts
-var SDK_VERSION = "2.0.0";
+var SDK_VERSION = "2.1.0";
 var DEFAULT_CONFIG = {
   API_BASE: "https://api.trillboards.com/v1/partner",
   CDN_BASE: "https://cdn.trillboards.com",
@@ -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,67 @@ 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();
+function setLogLevel(level) {
+  logger.setLevel(level);
+}
+
 // src/api/client.ts
 function getPlayerTruth(container) {
   if (typeof window === "undefined") {
@@ -218,6 +280,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 +315,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 +325,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 +342,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 +366,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 +389,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",
@@ -1734,6 +1802,75 @@ var _TrillboardsAds = class _TrillboardsAds {
 _TrillboardsAds._instance = null;
 var TrillboardsAds = _TrillboardsAds;
 
-export { ApiClient, CircuitBreaker, DEFAULT_CONFIG, DEFAULT_PUBLIC_STATE, EventEmitter, SDK_VERSION, Telemetry, TrillboardsAds, WaterfallEngine, createInitialState, getPublicState, resolveConfig };
+// src/errors.ts
+var TrillboardsError = class extends Error {
+  constructor(message, options = {}) {
+    super(message);
+    this.name = "TrillboardsError";
+    this.type = options.type ?? "api_error";
+    this.code = options.code ?? "unknown_error";
+    this.statusCode = options.statusCode ?? 500;
+    this.help = options.help;
+    this.param = options.param;
+  }
+};
+var TrillboardsAuthenticationError = class extends TrillboardsError {
+  constructor(message) {
+    super(
+      message ?? "Invalid API key. Check your key at https://trillboards.com/developers",
+      {
+        type: "authentication_error",
+        code: "invalid_api_key",
+        statusCode: 401,
+        help: "https://trillboards.com/developers"
+      }
+    );
+    this.name = "TrillboardsAuthenticationError";
+  }
+};
+var TrillboardsRateLimitError = class extends TrillboardsError {
+  constructor(retryAfter, message) {
+    super(
+      message ?? `Rate limit exceeded. Retry after ${retryAfter} seconds.`,
+      {
+        type: "rate_limit_error",
+        code: "rate_limited",
+        statusCode: 429
+      }
+    );
+    this.name = "TrillboardsRateLimitError";
+    this.retryAfter = retryAfter;
+  }
+};
+var TrillboardsNotFoundError = class extends TrillboardsError {
+  constructor(message) {
+    super(
+      message ?? "The requested resource was not found.",
+      {
+        type: "not_found_error",
+        code: "resource_not_found",
+        statusCode: 404,
+        help: "Verify the ID is correct and belongs to your account."
+      }
+    );
+    this.name = "TrillboardsNotFoundError";
+  }
+};
+var TrillboardsValidationError = class extends TrillboardsError {
+  constructor(message, param) {
+    super(
+      message ?? "The request was invalid.",
+      {
+        type: "validation_error",
+        code: "invalid_request",
+        statusCode: 400,
+        param
+      }
+    );
+    this.name = "TrillboardsValidationError";
+  }
+};
+
+export { ApiClient, CircuitBreaker, DEFAULT_CONFIG, DEFAULT_PUBLIC_STATE, EventEmitter, SDK_VERSION, Telemetry, TrillboardsAds, TrillboardsAuthenticationError, TrillboardsError, TrillboardsNotFoundError, TrillboardsRateLimitError, TrillboardsValidationError, WaterfallEngine, createInitialState, getPublicState, logger, resolveConfig, setLogLevel };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map