@trillboards/connect 1.0.0 → 1.1.0

package/dist/index.mjs

@@ -80,15 +80,26 @@ var require_device = __commonJS({
           ...metadata.custom
         }
       };
-      const response = await fetch(`${API_BASE}/device`, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          "Authorization": `Bearer ${apiKey}`,
-          "X-SDK-Version": "1.0.0"
-        },
-        body: JSON.stringify(body)
-      });
+      let response;
+      try {
+        response = await fetch(`${API_BASE}/device`, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${apiKey}`,
+            "X-SDK-Version": "1.0.0"
+          },
+          body: JSON.stringify(body)
+        });
+      } catch (fetchErr) {
+        const err = new Error(
+          `Network error during device registration: ${fetchErr.message}. If running from a browser, ensure your domain can reach api.trillboards.com. Test with: fetch("https://api.trillboards.com/v1/partner/ping").then(r => r.json()).then(console.log)`
+        );
+        err.statusCode = 0;
+        err.phase = "device_registration";
+        err.diagnosticUrl = `${API_BASE}/ping`;
+        throw err;
+      }
       if (!response.ok) {
         const errorData = await response.json().catch(() => ({}));
         const err = new Error(errorData.message || `Device registration failed: ${response.status}`);
@@ -1958,6 +1969,40 @@ var require_src = __commonJS({
           this.adRotation.start();
         }
       }
+      /**
+       * Request and display an ad in one call.
+       * Returns a Promise that resolves with ad result or rejects on failure.
+       *
+       * @param {Object} [options]
+       * @param {HTMLElement|string} [options.container] - DOM element or selector to render ad into (default: SDK's container)
+       * @param {number} [options.timeout] - Max ms to wait for ad fill (default: 10000)
+       * @param {boolean} [options.muted] - Start video muted (default: true)
+       * @returns {Promise<{ad: Object|null, controller: Object|null, filled: boolean}>}
+       */
+      async requestAd(options = {}) {
+        const container = options.container || resolveContainer(this.containerId);
+        const timeout = options.timeout || 1e4;
+        if (!this.initialized || !this.fingerprint) {
+          throw new Error('Device not registered. Call init() first and wait for "ready" event.');
+        }
+        const adResponse = await Promise.race([
+          fetchAds(this.fingerprint),
+          new Promise((_, reject) => setTimeout(() => reject(new Error("Ad request timed out")), timeout))
+        ]);
+        if (!adResponse || !adResponse.ads || adResponse.ads.length === 0) {
+          return { ad: null, controller: null, filled: false };
+        }
+        const ad = adResponse.ads[0];
+        const controller = renderAd(ad, container, {
+          muted: options.muted !== false,
+          onStart: (data) => this._emit("ad_started", { ad, ...data }),
+          onComplete: (data) => this._emit("ad_complete", { ad, ...data }),
+          onError: (err) => this._emit("ad_error", { ad, error: err })
+        });
+        trackImpression(ad, this.fingerprint).catch(() => {
+        });
+        return { ad, controller, filled: true };
+      }
       /**
        * Get the current state of all subsystems.
        *