@bountyboard/arcade-sdk 1.0.0 → 1.0.1

package/dist/global.js

@@ -42,6 +42,11 @@
   function cleanRewardedSize(value) {
     return value === "small" || value === "medium" || value === "large" ? value : "";
   }
+  function hasTransientUserActivation() {
+    if (typeof navigator === "undefined") return false;
+    const activation = navigator.userActivation;
+    return (activation == null ? void 0 : activation.isActive) === true;
+  }
   function safeCall(fn, arg) {
     if (typeof fn !== "function") return;
     try {
@@ -118,7 +123,7 @@
   function createBBArcade() {
     let adPlacementLoad = null;
     let adPreloadConfigured = false;
-    let rewardedBreakActive = false;
+    let rewardedBreakActive = null;
     let rewardedBreakSequence = 0;
     function isLocalAdHost() {
       try {
@@ -529,6 +534,16 @@
             function show() {
               if (shown) return;
               shown = true;
+              if (!hasTransientUserActivation()) {
+                const activationError = Object.assign(
+                  { status: "error", error: "direct_user_action_required" },
+                  base
+                );
+                post("rewarded_ad", void 0, Object.assign({ event: "error" }, activationError));
+                safeCall(options.onError, activationError);
+                done(activationError);
+                return;
+              }
               post("rewarded_ad", void 0, Object.assign({ event: "started" }, base));
               try {
                 showAdFn();
@@ -552,6 +567,7 @@
                 base
               );
               post("rewarded_ad", void 0, Object.assign({ event: "error" }, beforeError));
+              if (shown) return;
               safeCall(options.onError, beforeError);
               done(beforeError);
             }
@@ -560,9 +576,9 @@
             adBreak({
               type: "reward",
               name: options.placement,
-              size: options.size || void 0,
               beforeReward: startAd,
               adViewed: function() {
+                if (resolved) return;
                 status = "viewed";
                 const viewed = Object.assign({ status }, base);
                 post("rewarded_ad", void 0, Object.assign({ event: "viewed" }, viewed));
@@ -570,6 +586,7 @@
                 safeCall(options.onReward, viewed);
               },
               adDismissed: function() {
+                if (resolved) return;
                 if (status !== "viewed") status = "dismissed";
                 const dismissed = Object.assign({ status }, base);
                 post("rewarded_ad", void 0, Object.assign({ event: "dismissed" }, dismissed));
@@ -577,6 +594,7 @@
                 safeCall(options.onDismissed, dismissed);
               },
               adBreakDone: function(placementInfo) {
+                if (resolved) return;
                 const result = rewardOffered || status !== "unavailable" ? { status } : { status: "unavailable", error: "no_rewarded_ad" };
                 if (placementInfo && typeof placementInfo === "object") {
                   result.breakStatus = cleanText(
@@ -610,6 +628,52 @@
         });
       });
     }
+    function prepareRewardedAd(rawOptions) {
+      const normalized = normalizeRewardedOptions(rawOptions);
+      const base = {
+        placement: normalized.placement,
+        reward: normalized.reward,
+        adBreakId: normalized.adBreakId
+      };
+      if (normalized.size) base.size = normalized.size;
+      let ready2 = false;
+      let finalPromise;
+      return new Promise(function(resolvePreparation) {
+        finalPromise = rewardedAd(
+          Object.assign({}, rawOptions, {
+            // Preserve the id used by the ready handle and every lifecycle event;
+            // rewardedAd normalizes again, but this explicit id keeps both stages
+            // tied to the same placement.
+            adBreakId: normalized.adBreakId,
+            beforeReward: function(showAd) {
+              if (ready2) return;
+              ready2 = true;
+              let shown = false;
+              const prepared = Object.assign(
+                { status: "ready" },
+                base,
+                {
+                  show: function() {
+                    if (!shown) {
+                      shown = true;
+                      if (hasTransientUserActivation()) {
+                        safeCall(rawOptions && rawOptions.onStart);
+                      }
+                      showAd();
+                    }
+                    return finalPromise;
+                  }
+                }
+              );
+              resolvePreparation(prepared);
+            }
+          })
+        );
+        finalPromise.then(function(result) {
+          if (!ready2) resolvePreparation(result);
+        });
+      });
+    }
     function preloadRewardedAds(rawOptions) {
       const options = normalizeRewardedOptions(rawOptions);
       if (!areRewardedAdsEnabled()) return Promise.resolve(false);
@@ -656,7 +720,7 @@
         reward: normalized.reward
       };
       if (normalized.size) base.size = normalized.size;
-      if (rewardedBreakActive) {
+      if (rewardedBreakActive && rewardedBreakActive.state !== "ready") {
         post(
           "rewarded_ad",
           void 0,
@@ -667,24 +731,32 @@
         );
         return Promise.resolve(false);
       }
-      rewardedBreakActive = true;
+      const activeBreak = { state: "loading" };
+      rewardedBreakActive = activeBreak;
       let startCalled = false;
+      const callerBeforeReward = rawOptions.beforeReward;
       return rewardedAd(
         Object.assign({}, rawOptions, {
           beforeReward: function(showAd) {
-            if (startCalled) return;
-            startCalled = true;
-            safeCall(rawOptions.onStart);
-            showAd();
+            if (rewardedBreakActive === activeBreak) activeBreak.state = "ready";
+            const showWithStart = function() {
+              if (startCalled || rewardedBreakActive !== activeBreak) return;
+              startCalled = true;
+              activeBreak.state = "showing";
+              if (hasTransientUserActivation()) safeCall(rawOptions.onStart);
+              showAd();
+            };
+            if (typeof callerBeforeReward === "function") callerBeforeReward(showWithStart);
+            else showWithStart();
           }
         })
       ).then(
         function(result) {
-          rewardedBreakActive = false;
+          if (rewardedBreakActive === activeBreak) rewardedBreakActive = null;
           return Boolean(result && result.status === "viewed");
         },
         function() {
-          rewardedBreakActive = false;
+          if (rewardedBreakActive === activeBreak) rewardedBreakActive = null;
           return false;
         }
       );
@@ -722,6 +794,8 @@
       },
       rewardedAd,
       showRewardedAd: rewardedAd,
+      prepareRewardedAd,
+      prepareRewardedBreak: prepareRewardedAd,
       rewardedBreak,
       save: function(blob) {
         return request("save", String(blob));
@@ -767,6 +841,13 @@
       reward: "reward",
       adBreakId: "bbad_inert"
     });
+    const prepareUnavailable = () => Promise.resolve({
+      status: "unavailable",
+      error: "ad_break_unavailable",
+      placement: "rewarded",
+      reward: "reward",
+      adBreakId: "bbad_inert"
+    });
     return {
       lockToHost: noop,
       init: () => Promise.resolve(),
@@ -783,6 +864,8 @@
       xrSessionEnd: noop,
       rewardedAd: unavailable,
       showRewardedAd: unavailable,
+      prepareRewardedAd: prepareUnavailable,
+      prepareRewardedBreak: prepareUnavailable,
       rewardedBreak: () => Promise.resolve(false),
       save: () => Promise.reject(sdkError2("unsupported")),
       load: () => Promise.reject(sdkError2("unsupported")),

package/dist/index.cjs

@@ -68,6 +68,11 @@ function toBoolean(value) {
 function cleanRewardedSize(value) {
   return value === "small" || value === "medium" || value === "large" ? value : "";
 }
+function hasTransientUserActivation() {
+  if (typeof navigator === "undefined") return false;
+  const activation = navigator.userActivation;
+  return (activation == null ? void 0 : activation.isActive) === true;
+}
 function safeCall(fn, arg) {
   if (typeof fn !== "function") return;
   try {
@@ -144,7 +149,7 @@ function sanitizePlayer(value) {
 function createBBArcade() {
   let adPlacementLoad = null;
   let adPreloadConfigured = false;
-  let rewardedBreakActive = false;
+  let rewardedBreakActive = null;
   let rewardedBreakSequence = 0;
   function isLocalAdHost() {
     try {
@@ -555,6 +560,16 @@ function createBBArcade() {
           function show() {
             if (shown) return;
             shown = true;
+            if (!hasTransientUserActivation()) {
+              const activationError = Object.assign(
+                { status: "error", error: "direct_user_action_required" },
+                base
+              );
+              post("rewarded_ad", void 0, Object.assign({ event: "error" }, activationError));
+              safeCall(options.onError, activationError);
+              done(activationError);
+              return;
+            }
             post("rewarded_ad", void 0, Object.assign({ event: "started" }, base));
             try {
               showAdFn();
@@ -578,6 +593,7 @@ function createBBArcade() {
               base
             );
             post("rewarded_ad", void 0, Object.assign({ event: "error" }, beforeError));
+            if (shown) return;
             safeCall(options.onError, beforeError);
             done(beforeError);
           }
@@ -586,9 +602,9 @@ function createBBArcade() {
           adBreak({
             type: "reward",
             name: options.placement,
-            size: options.size || void 0,
             beforeReward: startAd,
             adViewed: function() {
+              if (resolved) return;
               status = "viewed";
               const viewed = Object.assign({ status }, base);
               post("rewarded_ad", void 0, Object.assign({ event: "viewed" }, viewed));
@@ -596,6 +612,7 @@ function createBBArcade() {
               safeCall(options.onReward, viewed);
             },
             adDismissed: function() {
+              if (resolved) return;
               if (status !== "viewed") status = "dismissed";
               const dismissed = Object.assign({ status }, base);
               post("rewarded_ad", void 0, Object.assign({ event: "dismissed" }, dismissed));
@@ -603,6 +620,7 @@ function createBBArcade() {
               safeCall(options.onDismissed, dismissed);
             },
             adBreakDone: function(placementInfo) {
+              if (resolved) return;
               const result = rewardOffered || status !== "unavailable" ? { status } : { status: "unavailable", error: "no_rewarded_ad" };
               if (placementInfo && typeof placementInfo === "object") {
                 result.breakStatus = cleanText(
@@ -636,6 +654,52 @@ function createBBArcade() {
       });
     });
   }
+  function prepareRewardedAd(rawOptions) {
+    const normalized = normalizeRewardedOptions(rawOptions);
+    const base = {
+      placement: normalized.placement,
+      reward: normalized.reward,
+      adBreakId: normalized.adBreakId
+    };
+    if (normalized.size) base.size = normalized.size;
+    let ready2 = false;
+    let finalPromise;
+    return new Promise(function(resolvePreparation) {
+      finalPromise = rewardedAd(
+        Object.assign({}, rawOptions, {
+          // Preserve the id used by the ready handle and every lifecycle event;
+          // rewardedAd normalizes again, but this explicit id keeps both stages
+          // tied to the same placement.
+          adBreakId: normalized.adBreakId,
+          beforeReward: function(showAd) {
+            if (ready2) return;
+            ready2 = true;
+            let shown = false;
+            const prepared = Object.assign(
+              { status: "ready" },
+              base,
+              {
+                show: function() {
+                  if (!shown) {
+                    shown = true;
+                    if (hasTransientUserActivation()) {
+                      safeCall(rawOptions && rawOptions.onStart);
+                    }
+                    showAd();
+                  }
+                  return finalPromise;
+                }
+              }
+            );
+            resolvePreparation(prepared);
+          }
+        })
+      );
+      finalPromise.then(function(result) {
+        if (!ready2) resolvePreparation(result);
+      });
+    });
+  }
   function preloadRewardedAds(rawOptions) {
     const options = normalizeRewardedOptions(rawOptions);
     if (!areRewardedAdsEnabled()) return Promise.resolve(false);
@@ -682,7 +746,7 @@ function createBBArcade() {
       reward: normalized.reward
     };
     if (normalized.size) base.size = normalized.size;
-    if (rewardedBreakActive) {
+    if (rewardedBreakActive && rewardedBreakActive.state !== "ready") {
       post(
         "rewarded_ad",
         void 0,
@@ -693,24 +757,32 @@ function createBBArcade() {
       );
       return Promise.resolve(false);
     }
-    rewardedBreakActive = true;
+    const activeBreak = { state: "loading" };
+    rewardedBreakActive = activeBreak;
     let startCalled = false;
+    const callerBeforeReward = rawOptions.beforeReward;
     return rewardedAd(
       Object.assign({}, rawOptions, {
         beforeReward: function(showAd) {
-          if (startCalled) return;
-          startCalled = true;
-          safeCall(rawOptions.onStart);
-          showAd();
+          if (rewardedBreakActive === activeBreak) activeBreak.state = "ready";
+          const showWithStart = function() {
+            if (startCalled || rewardedBreakActive !== activeBreak) return;
+            startCalled = true;
+            activeBreak.state = "showing";
+            if (hasTransientUserActivation()) safeCall(rawOptions.onStart);
+            showAd();
+          };
+          if (typeof callerBeforeReward === "function") callerBeforeReward(showWithStart);
+          else showWithStart();
         }
       })
     ).then(
       function(result) {
-        rewardedBreakActive = false;
+        if (rewardedBreakActive === activeBreak) rewardedBreakActive = null;
         return Boolean(result && result.status === "viewed");
       },
       function() {
-        rewardedBreakActive = false;
+        if (rewardedBreakActive === activeBreak) rewardedBreakActive = null;
         return false;
       }
     );
@@ -748,6 +820,8 @@ function createBBArcade() {
     },
     rewardedAd,
     showRewardedAd: rewardedAd,
+    prepareRewardedAd,
+    prepareRewardedBreak: prepareRewardedAd,
     rewardedBreak,
     save: function(blob) {
       return request("save", String(blob));
@@ -793,6 +867,13 @@ function createInertBBArcade() {
     reward: "reward",
     adBreakId: "bbad_inert"
   });
+  const prepareUnavailable = () => Promise.resolve({
+    status: "unavailable",
+    error: "ad_break_unavailable",
+    placement: "rewarded",
+    reward: "reward",
+    adBreakId: "bbad_inert"
+  });
   return {
     lockToHost: noop,
     init: () => Promise.resolve(),
@@ -809,6 +890,8 @@ function createInertBBArcade() {
     xrSessionEnd: noop,
     rewardedAd: unavailable,
     showRewardedAd: unavailable,
+    prepareRewardedAd: prepareUnavailable,
+    prepareRewardedBreak: prepareUnavailable,
     rewardedBreak: () => Promise.resolve(false),
     save: () => Promise.reject(sdkError2("unsupported")),
     load: () => Promise.reject(sdkError2("unsupported")),