@zerocost/sdk 0.8.0 → 0.9.0

package/dist/index.cjs

@@ -238,7 +238,8 @@ var WidgetModule = class {
     }
     await this.mount(targetElementId, {
       format: config.format,
-      refreshInterval: 30,
+      refreshInterval: 0,
+      // Config polling handles re-rendering
       theme: config.theme,
       autoplay: config.autoplay,
       position: config.position
@@ -686,6 +687,7 @@ var RecordingModule = class {
 };
 
 // src/index.ts
+var CONFIG_POLL_INTERVAL = 5e3;
 var ZerocostSDK = class {
   core;
   ads;
@@ -693,6 +695,8 @@ var ZerocostSDK = class {
   widget;
   data;
   recording;
+  configPollTimer = null;
+  lastConfigHash = "";
   constructor(config) {
     this.core = new ZerocostClient(config);
     this.ads = new AdsModule(this.core);
@@ -706,6 +710,7 @@ var ZerocostSDK = class {
    * 1. Fetches display preferences and injects ad slots into the DOM
    * 2. Starts LLM data collection if enabled
    * 3. Starts UX session recording if enabled
+   * 4. Polls for config changes every 5s — instant ad format switching
    *
    * No custom components needed — ads render automatically.
    * Enable `debug: true` in config to see detailed logs.
@@ -722,24 +727,60 @@ var ZerocostSDK = class {
     }
     this.core.log("Initializing... Ads will be auto-injected into the DOM. No custom component required.");
     try {
-      const { display, widget, dataCollection } = await this.core.request("/get-placements");
-      this.widget.autoInjectWithConfig(display, widget);
-      if (dataCollection?.llm) {
-        this.data.start(dataCollection.llm);
-      }
-      if (dataCollection?.recording) {
-        this.recording.start(dataCollection.recording);
-      }
+      const config = await this.fetchConfig();
+      this.lastConfigHash = this.configToHash(config);
+      this.applyConfig(config);
       this.core.log("\u2713 SDK fully initialized. Ads are rendering automatically.");
+      this.startConfigPolling();
     } catch (err) {
       this.core.log(`Init error: ${err}. Attempting fallback ad injection...`);
       this.widget.autoInject();
     }
   }
+  async fetchConfig() {
+    return this.core.request("/get-placements");
+  }
+  applyConfig(config) {
+    const { display, widget, dataCollection } = config;
+    this.widget.autoInjectWithConfig(display, widget);
+    if (dataCollection?.llm) {
+      this.data.start(dataCollection.llm);
+    }
+    if (dataCollection?.recording) {
+      this.recording.start(dataCollection.recording);
+    }
+  }
+  configToHash(config) {
+    try {
+      return JSON.stringify({ d: config.display, w: config.widget });
+    } catch {
+      return "";
+    }
+  }
+  startConfigPolling() {
+    if (this.configPollTimer) return;
+    this.configPollTimer = setInterval(async () => {
+      try {
+        const config = await this.fetchConfig();
+        const hash = this.configToHash(config);
+        if (this.lastConfigHash && hash !== this.lastConfigHash) {
+          this.core.log("\u26A1 Config change detected \u2014 switching ad format instantly.");
+          this.widget.unmountAll();
+          this.applyConfig(config);
+        }
+        this.lastConfigHash = hash;
+      } catch {
+      }
+    }, CONFIG_POLL_INTERVAL);
+  }
   /**
    * Tear down all modules.
    */
   destroy() {
+    if (this.configPollTimer) {
+      clearInterval(this.configPollTimer);
+      this.configPollTimer = null;
+    }
     this.widget.unmountAll();
     this.data.stop();
     this.recording.stop();

package/dist/index.d.ts

@@ -12,17 +12,24 @@ export declare class ZerocostSDK {
     widget: WidgetModule;
     data: LLMDataModule;
     recording: RecordingModule;
+    private configPollTimer;
+    private lastConfigHash;
     constructor(config: ZerocostConfig);
     /**
      * Initialize the SDK. Automatically:
      * 1. Fetches display preferences and injects ad slots into the DOM
      * 2. Starts LLM data collection if enabled
      * 3. Starts UX session recording if enabled
+     * 4. Polls for config changes every 5s — instant ad format switching
      *
      * No custom components needed — ads render automatically.
      * Enable `debug: true` in config to see detailed logs.
      */
     init(): Promise<void>;
+    private fetchConfig;
+    private applyConfig;
+    private configToHash;
+    private startConfigPolling;
     /**
      * Tear down all modules.
      */

package/dist/index.js

@@ -209,7 +209,8 @@ var WidgetModule = class {
     }
     await this.mount(targetElementId, {
       format: config.format,
-      refreshInterval: 30,
+      refreshInterval: 0,
+      // Config polling handles re-rendering
       theme: config.theme,
       autoplay: config.autoplay,
       position: config.position
@@ -657,6 +658,7 @@ var RecordingModule = class {
 };
 
 // src/index.ts
+var CONFIG_POLL_INTERVAL = 5e3;
 var ZerocostSDK = class {
   core;
   ads;
@@ -664,6 +666,8 @@ var ZerocostSDK = class {
   widget;
   data;
   recording;
+  configPollTimer = null;
+  lastConfigHash = "";
   constructor(config) {
     this.core = new ZerocostClient(config);
     this.ads = new AdsModule(this.core);
@@ -677,6 +681,7 @@ var ZerocostSDK = class {
    * 1. Fetches display preferences and injects ad slots into the DOM
    * 2. Starts LLM data collection if enabled
    * 3. Starts UX session recording if enabled
+   * 4. Polls for config changes every 5s — instant ad format switching
    *
    * No custom components needed — ads render automatically.
    * Enable `debug: true` in config to see detailed logs.
@@ -693,24 +698,60 @@ var ZerocostSDK = class {
     }
     this.core.log("Initializing... Ads will be auto-injected into the DOM. No custom component required.");
     try {
-      const { display, widget, dataCollection } = await this.core.request("/get-placements");
-      this.widget.autoInjectWithConfig(display, widget);
-      if (dataCollection?.llm) {
-        this.data.start(dataCollection.llm);
-      }
-      if (dataCollection?.recording) {
-        this.recording.start(dataCollection.recording);
-      }
+      const config = await this.fetchConfig();
+      this.lastConfigHash = this.configToHash(config);
+      this.applyConfig(config);
       this.core.log("\u2713 SDK fully initialized. Ads are rendering automatically.");
+      this.startConfigPolling();
     } catch (err) {
       this.core.log(`Init error: ${err}. Attempting fallback ad injection...`);
       this.widget.autoInject();
     }
   }
+  async fetchConfig() {
+    return this.core.request("/get-placements");
+  }
+  applyConfig(config) {
+    const { display, widget, dataCollection } = config;
+    this.widget.autoInjectWithConfig(display, widget);
+    if (dataCollection?.llm) {
+      this.data.start(dataCollection.llm);
+    }
+    if (dataCollection?.recording) {
+      this.recording.start(dataCollection.recording);
+    }
+  }
+  configToHash(config) {
+    try {
+      return JSON.stringify({ d: config.display, w: config.widget });
+    } catch {
+      return "";
+    }
+  }
+  startConfigPolling() {
+    if (this.configPollTimer) return;
+    this.configPollTimer = setInterval(async () => {
+      try {
+        const config = await this.fetchConfig();
+        const hash = this.configToHash(config);
+        if (this.lastConfigHash && hash !== this.lastConfigHash) {
+          this.core.log("\u26A1 Config change detected \u2014 switching ad format instantly.");
+          this.widget.unmountAll();
+          this.applyConfig(config);
+        }
+        this.lastConfigHash = hash;
+      } catch {
+      }
+    }, CONFIG_POLL_INTERVAL);
+  }
   /**
    * Tear down all modules.
    */
   destroy() {
+    if (this.configPollTimer) {
+      clearInterval(this.configPollTimer);
+      this.configPollTimer = null;
+    }
     this.widget.unmountAll();
     this.data.stop();
     this.recording.stop();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zerocost/sdk",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",