powered-ad-config 0.1.52 → 0.1.54

package/README.md

@@ -32,27 +32,40 @@ In your fireplace project, you load from CDN first and fall back to npm import i
 import poweredAdConfigNpm from 'powered-ad-config';
 
 export async function loadAdConfig() {
-    try {
-        await new Promise((resolve, reject) => {
-            const script = document.createElement('script');
-            // Intentionally using @latest so runtime always picks up newest published powered-ad-config release.
-            // Note: this can change behavior between deployments if a new version is published.
-            script.src = 'https://cdn.jsdelivr.net/npm/powered-ad-config@latest/dist/powered-ad-config.umd.js';
-            script.onload = resolve;
-            script.onerror = reject;
-            document.head.appendChild(script);
-        });
-
-        if (typeof window.poweredAdConfig === 'function') {
-            console.log('CDN loaded successfully');
-            return window.poweredAdConfig;
-        }
+  const expectedVersion = window.poweredAdConfigExpectedVersion || null;
+  const cdnUrl = new URL('https://cdn.jsdelivr.net/npm/powered-ad-config@latest/dist/powered-ad-config.umd.js');
+
+  cdnUrl.searchParams.set('v', expectedVersion || poweredAdConfigNpm.version || 'latest');
+
+  try {
+    await new Promise((resolve, reject) => {
+      const script = document.createElement('script');
+      // Intentionally using @latest so runtime always picks up newest published powered-ad-config release.
+      // Note: this can change behavior between deployments if a new version is published.
+      // The version query busts stale browser/ad-frame caches during validation.
+      script.src = cdnUrl.href;
+      script.onload = resolve;
+      script.onerror = reject;
+      document.head.appendChild(script);
+    });
 
-        throw new Error('poweredAdConfig global not available');
-    } catch (error) {
-        console.error('Failed to load from CDN, falling back to npm package:', error);
+    if (typeof window.poweredAdConfig === 'function') {
+      if (expectedVersion && window.poweredAdConfig.version !== expectedVersion) {
+        console.warn(
+          `[powered-ad-config] Stale CDN cache detected: loaded v${window.poweredAdConfig.version}, expected v${expectedVersion}. Falling back to bundled npm copy.`
+        );
         return poweredAdConfigNpm;
+      }
+
+      console.log(`CDN loaded successfully: v${window.poweredAdConfig.version || 'unknown'}`);
+      return window.poweredAdConfig;
     }
+
+    throw new Error('poweredAdConfig global not available');
+  } catch (error) {
+    console.error('Failed to load from CDN, falling back to npm package:', error);
+    return poweredAdConfigNpm;
+  }
 }
 ```
 
@@ -83,6 +96,7 @@ This pattern is useful when you want runtime fallback resilience while still bun
 
 If you use `@latest`, runtime behavior can change between deployments as soon as a new package version is published.
 If you need deterministic behavior, pin an explicit version in the CDN URL.
+During QA, set `window.poweredAdConfigExpectedVersion = '0.1.53'` before calling `loadAdConfig()` or pin the exact package version so an already-cached ad iframe cannot silently keep executing an older `@latest` response.
 
 ## API