@bountyboard/arcade-sdk 1.0.1 → 1.2.0

package/dist/global.js

@@ -12,6 +12,8 @@
   var AD_PLACEMENT_SCRIPT_ID = "bb-arcade-h5-ads";
   var DEFAULT_AD_LOAD_TIMEOUT_MS = 6e3;
   var SAVE_TIMEOUT_MS = 15e3;
+  var LOCK_TIMEOUT_MS = 5e3;
+  var MAX_SAVE_BYTES = 1024 * 1024;
   var INIT_CONFIG_GRACE_MS = 1500;
   var DEFAULT_ALLOW = [
     "bountyboard.gg",
@@ -36,6 +38,14 @@
     if (typeof value !== "string") return fallback || "";
     return value.replace(/[^\w:.-]+/g, "_").slice(0, max || 80) || fallback || "";
   }
+  var cachedTextEncoder = null;
+  function utf8ByteLength(value) {
+    if (typeof TextEncoder !== "undefined") {
+      cachedTextEncoder = cachedTextEncoder || new TextEncoder();
+      return cachedTextEncoder.encode(value).length;
+    }
+    return new Blob([value]).size;
+  }
   function toBoolean(value) {
     return value === true || value === "true" || value === "1";
   }
@@ -155,13 +165,14 @@
     };
     let hostConfigReceived = false;
     let hostPlayer = null;
+    const playerChangeHandlers = [];
     let blocked = false;
     const pending = {};
     let seq = 0;
     function post(type, score, extra) {
       if (blocked) return;
       const message = { source: SDK_MESSAGE_SOURCE, v: VERSION, type };
-      if (typeof score === "number" && isFinite(score)) message.score = Math.floor(score);
+      if (typeof score === "number" && isFinite(score)) message.score = Math.trunc(score);
       if (extra && typeof extra === "object") {
         const fields = extra;
         for (const key in fields) {
@@ -182,7 +193,7 @@
         return true;
       }
     }
-    function request(type, payload) {
+    function request(type, payload, timeoutMs = SAVE_TIMEOUT_MS) {
       return new Promise(function(resolve, reject) {
         if (blocked) return reject(sdkError("error"));
         if (!isEmbedded()) return reject(sdkError("unsupported"));
@@ -192,7 +203,7 @@
             delete pending[requestId];
             reject(sdkError("error"));
           }
-        }, SAVE_TIMEOUT_MS);
+        }, timeoutMs);
         pending[requestId] = { resolve, reject, timer };
         try {
           window.parent.postMessage(
@@ -284,7 +295,7 @@
         if (!hostnameAllowed(origin, allow)) blockHost(options);
         return;
       }
-      request("host").then(
+      request("host", void 0, LOCK_TIMEOUT_MS).then(
         function(res) {
           const r = res;
           if (!hostnameAllowed(r && r.origin, allow)) blockHost(options);
@@ -308,7 +319,7 @@
           lockToHostBestEffort(opts, allow);
           return;
         }
-        request("host_attest").then(
+        request("host_attest", void 0, LOCK_TIMEOUT_MS).then(
           function(res) {
             const r = res;
             if (!r || !r.attestation) {
@@ -370,7 +381,15 @@
       if (msg.source !== HOST_MESSAGE_SOURCE || msg.type !== "config") return;
       hostConfigReceived = true;
       if (msg.player !== void 0) {
-        hostPlayer = sanitizePlayer(msg.player);
+        const nextPlayer = sanitizePlayer(msg.player);
+        const changed = nextPlayer === null ? hostPlayer !== null : hostPlayer === null || nextPlayer.name !== hostPlayer.name || nextPlayer.avatarUrl !== hostPlayer.avatarUrl;
+        hostPlayer = nextPlayer;
+        if (changed) {
+          const snapshot = nextPlayer ? { name: nextPlayer.name, avatarUrl: nextPlayer.avatarUrl } : null;
+          for (let i = 0; i < playerChangeHandlers.length; i++) {
+            safeCall(playerChangeHandlers[i], snapshot);
+          }
+        }
       }
       const rewardedAds = msg.rewardedAds;
       if (rewardedAds && typeof rewardedAds === "object") {
@@ -502,6 +521,7 @@
           let resolved = false;
           let status = "unavailable";
           let rewardOffered = false;
+          let adShown = false;
           const waitTimer = setTimeout(function() {
             if (rewardOffered || resolved) return;
             const timeout = Object.assign(
@@ -546,6 +566,7 @@
               }
               post("rewarded_ad", void 0, Object.assign({ event: "started" }, base));
               try {
+                adShown = true;
                 showAdFn();
               } catch (err) {
                 const showError = Object.assign(
@@ -595,7 +616,13 @@
               },
               adBreakDone: function(placementInfo) {
                 if (resolved) return;
-                const result = rewardOffered || status !== "unavailable" ? { status } : { status: "unavailable", error: "no_rewarded_ad" };
+                const result = rewardOffered || status !== "unavailable" ? {
+                  // A reward was offered but the ad never reached the screen
+                  // (the game retained show() and let the break lapse): the
+                  // break is over without a view, so resolve 'dismissed',
+                  // not the non-terminal-looking 'ready'.
+                  status: status === "ready" && !adShown ? "dismissed" : status
+                } : { status: "unavailable", error: "no_rewarded_ad" };
                 if (placementInfo && typeof placementInfo === "object") {
                   result.breakStatus = cleanText(
                     placementInfo.breakStatus
@@ -798,12 +825,25 @@
       prepareRewardedBreak: prepareRewardedAd,
       rewardedBreak,
       save: function(blob) {
-        return request("save", String(blob));
+        const data = String(blob);
+        if (utf8ByteLength(data) > MAX_SAVE_BYTES) {
+          return Promise.reject(sdkError("too_large"));
+        }
+        return request("save", data);
       },
       load: function() {
         return request("load");
       },
       getPlayer,
+      onPlayerChange: function(handler) {
+        if (typeof handler !== "function") return function() {
+        };
+        playerChangeHandlers.push(handler);
+        return function() {
+          const idx = playerChangeHandlers.indexOf(handler);
+          if (idx !== -1) playerChangeHandlers.splice(idx, 1);
+        };
+      },
       getVariant: function(key, variants) {
         const sorted = Array.isArray(variants) ? variants.slice().sort() : [];
         const fallback = sorted.length > 0 ? sorted[0] : null;
@@ -870,6 +910,8 @@
       save: () => Promise.reject(sdkError2("unsupported")),
       load: () => Promise.reject(sdkError2("unsupported")),
       getPlayer: () => Promise.resolve(null),
+      onPlayerChange: () => () => {
+      },
       getVariant: (key, variants) => {
         const sorted = Array.isArray(variants) ? variants.slice().sort() : [];
         return Promise.resolve(sorted.length > 0 ? sorted[0] : null);
@@ -883,12 +925,17 @@
 
   // src/multiplayer.ts
   var WELCOME_TIMEOUT_MS = 1e4;
+  var MIN_WELCOME_TIMEOUT_MS = 1e3;
+  var MAX_WELCOME_TIMEOUT_MS = 6e4;
   var MAX_RECONNECT_ATTEMPTS = 3;
+  var MAX_JOIN_DATA_BYTES = 1024;
+  var SEAT_FULL_CLOSE_CODE = 4005;
   var CODE_ALPHABET = "ABCDEFGHJKLMNPQRSTUVWXYZ23456789";
   var CODE_LENGTH = 4;
-  function sdkError3(code) {
+  function sdkError3(code, detail) {
     const err = new Error(code);
     err.code = code;
+    if (detail) err.detail = detail;
     return err;
   }
   function randomChars(length) {
@@ -905,27 +952,51 @@
   function generateCode() {
     return randomChars(CODE_LENGTH);
   }
-  var guestKey = null;
-  function getGuestKey() {
-    if (!guestKey) guestKey = randomChars(16);
-    return guestKey;
+  var cachedTextEncoder2 = null;
+  function utf8ByteLength2(value) {
+    if (typeof TextEncoder !== "undefined") {
+      cachedTextEncoder2 = cachedTextEncoder2 || new TextEncoder();
+      return cachedTextEncoder2.encode(value).length;
+    }
+    return new Blob([value]).size;
   }
-  function requestTicket(roomId) {
+  function serializeJoinData(data) {
+    if (data === void 0) return null;
+    if (!data || typeof data !== "object" || Array.isArray(data)) throw sdkError3("rejected");
+    let serialized;
+    try {
+      serialized = JSON.stringify(data);
+    } catch (e) {
+      throw sdkError3("rejected");
+    }
+    if (!serialized || utf8ByteLength2(serialized) > MAX_JOIN_DATA_BYTES) {
+      throw sdkError3("rejected");
+    }
+    return serialized;
+  }
+  function requestTicket(payload) {
     const request = BBArcade._request;
     if (typeof request !== "function") return Promise.reject(sdkError3("unsupported"));
-    return request("mp_ticket", { roomId, guestKey: getGuestKey() }).then((grant) => {
+    return request("mp_ticket", payload).then((grant) => {
       const g = grant;
       if (!g || typeof g.ticket !== "string" || typeof g.roomUrl !== "string") {
         throw sdkError3("error");
       }
-      return { ticket: g.ticket, roomUrl: g.roomUrl, expiresAt: Number(g.expiresAt) || 0 };
+      return {
+        ticket: g.ticket,
+        roomUrl: g.roomUrl,
+        expiresAt: Number(g.expiresAt) || 0,
+        roomId: typeof g.roomId === "string" && g.roomId ? g.roomId : null
+      };
     });
   }
   var RoomConnection = class {
-    constructor(code, devGrant) {
+    constructor(code, devGrant, joinData, welcomeTimeoutMs = WELCOME_TIMEOUT_MS) {
       this.playerId = "";
       this.players = [];
       this.state = null;
+      this.connected = false;
+      this.latencyMs = null;
       this.ws = null;
       // Keyed by event name; values are erased to (unknown) => void internally and
       // retyped at the on()/emit() boundary, which keeps the public API strictly
@@ -938,14 +1009,20 @@
       // or the welcome timed out — permanent outcomes that must not reconnect.
       this.terminal = false;
       this.reconnectAttempts = 0;
+      // The in-flight connect()'s settlement, so leave() can reject a join that
+      // is still waiting on its welcome instead of stranding it on the timeout.
+      this.pendingConnect = null;
       this.code = code;
       this.devGrant = devGrant;
+      this.joinData = joinData;
+      this.welcomeTimeoutMs = welcomeTimeoutMs;
     }
     /** Connect and resolve on the server's welcome (post-ticket-verification). */
     connect(grant) {
       return new Promise((resolve, reject) => {
         let settled = false;
-        const url = grant.roomUrl + (grant.roomUrl.indexOf("?") === -1 ? "?" : "&") + "ticket=" + encodeURIComponent(grant.ticket);
+        const url = grant.roomUrl + (grant.roomUrl.indexOf("?") === -1 ? "?" : "&") + "ticket=" + encodeURIComponent(grant.ticket) + (this.joinData === null ? "" : "&join=" + encodeURIComponent(this.joinData));
+        const connectStartedAt = Date.now();
         let ws;
         try {
           ws = new WebSocket(url);
@@ -956,13 +1033,15 @@
         const welcomeTimer = setTimeout(() => {
           if (settled) return;
           settled = true;
+          this.pendingConnect = null;
           this.terminal = true;
           try {
             ws.close();
           } catch (err) {
           }
           reject(sdkError3("error"));
-        }, WELCOME_TIMEOUT_MS);
+        }, this.welcomeTimeoutMs);
+        this.pendingConnect = { reject, timer: welcomeTimer };
         ws.onmessage = (event) => {
           var _a, _b, _c, _d, _e;
           let msg;
@@ -973,15 +1052,27 @@
           }
           if (!msg || typeof msg.t !== "string") return;
           if (msg.t === "welcome") {
+            if (this.intentionalClose) {
+              try {
+                ws.close();
+              } catch (err) {
+              }
+              return;
+            }
+            const reconnected = this.reconnectAttempts > 0;
             this.playerId = String((_a = msg.playerId) != null ? _a : "");
             this.players = Array.isArray(msg.players) ? msg.players : [];
             this.state = (_b = msg.state) != null ? _b : null;
+            this.connected = true;
             this.reconnectAttempts = 0;
+            this.latencyMs = Math.max(0, Date.now() - connectStartedAt);
             if (!settled) {
               settled = true;
+              this.pendingConnect = null;
               clearTimeout(welcomeTimer);
               resolve(this);
             }
+            if (reconnected) this.emit("connection", { connected: true, reconnecting: false });
             return;
           }
           if (msg.t === "snapshot") {
@@ -1019,25 +1110,30 @@
             if (!settled) {
               settled = true;
               this.terminal = true;
+              this.pendingConnect = null;
               clearTimeout(welcomeTimer);
               try {
                 ws.close();
               } catch (err) {
               }
-              reject(sdkError3(code === "unauthenticated" ? "unauthenticated" : "rejected"));
+              reject(sdkError3(code === "unauthenticated" ? "unauthenticated" : "rejected", code));
               return;
             }
             this.emit("error", { code });
           }
         };
-        ws.onclose = () => {
+        ws.onclose = (event) => {
+          this.connected = false;
+          if (event && event.code === SEAT_FULL_CLOSE_CODE) this.terminal = true;
           if (!settled) {
             settled = true;
+            this.pendingConnect = null;
             clearTimeout(welcomeTimer);
             reject(sdkError3("error"));
             return;
           }
           if (this.intentionalClose || this.ended || this.terminal) {
+            this.emit("connection", { connected: false, reconnecting: false });
             this.emit("close", { reconnecting: false });
             return;
           }
@@ -1055,11 +1151,12 @@
         return;
       }
       this.reconnectAttempts += 1;
+      this.emit("connection", { connected: false, reconnecting: true });
       this.emit("close", { reconnecting: true });
       await new Promise((r) => setTimeout(r, 400 * this.reconnectAttempts));
       if (this.intentionalClose || this.ended || this.terminal) return;
       try {
-        const grant = (_a = this.devGrant) != null ? _a : await requestTicket(this.code);
+        const grant = (_a = this.devGrant) != null ? _a : await requestTicket({ roomId: this.code });
         if (this.intentionalClose || this.ended || this.terminal) return;
         await this.connect(grant);
         if (this.intentionalClose) this.leave();
@@ -1068,11 +1165,16 @@
       }
     }
     send(input) {
-      if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;
+      this.trySend(input);
+    }
+    trySend(input) {
+      if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return false;
       this.seq += 1;
       try {
         this.ws.send(JSON.stringify({ t: "input", seq: this.seq, data: input }));
+        return true;
       } catch (err) {
+        return false;
       }
     }
     on(event, handler) {
@@ -1088,6 +1190,13 @@
     leave() {
       var _a;
       this.intentionalClose = true;
+      this.connected = false;
+      if (this.pendingConnect) {
+        const pending = this.pendingConnect;
+        this.pendingConnect = null;
+        clearTimeout(pending.timer);
+        pending.reject(sdkError3("error"));
+      }
       try {
         (_a = this.ws) == null ? void 0 : _a.close(1e3);
       } catch (err) {
@@ -1107,17 +1216,57 @@
       }
     }
   };
+  var MATCH_ATTEMPTS = 3;
+  function normalizeWelcomeTimeoutMs(value) {
+    if (typeof value !== "number" || !isFinite(value)) return WELCOME_TIMEOUT_MS;
+    return Math.min(MAX_WELCOME_TIMEOUT_MS, Math.max(MIN_WELCOME_TIMEOUT_MS, Math.floor(value)));
+  }
+  async function matchJoin(joinData, timeoutMs) {
+    let lastError = sdkError3("error");
+    for (let attempt = 0; attempt < MATCH_ATTEMPTS; attempt++) {
+      const grant = await requestTicket({ matchmake: true });
+      if (!grant.roomId) throw sdkError3("error");
+      try {
+        return await new RoomConnection(grant.roomId, null, joinData, timeoutMs).connect(grant);
+      } catch (error) {
+        lastError = error;
+        const detail = error == null ? void 0 : error.detail;
+        if (detail !== "room_full" && detail !== "room_over") throw error;
+      }
+    }
+    throw lastError;
+  }
   function joinRoom(options) {
     const opts = options != null ? options : {};
     if (typeof window === "undefined" || typeof WebSocket === "undefined") {
       return Promise.reject(sdkError3("unsupported"));
     }
+    let joinData;
+    try {
+      joinData = serializeJoinData(opts.joinData);
+    } catch (err) {
+      return Promise.reject(err);
+    }
+    const timeoutMs = normalizeWelcomeTimeoutMs(opts.timeoutMs);
+    if (opts.match) {
+      if (opts.code || opts.create || opts.roomUrl || opts.ticket) {
+        return Promise.reject(sdkError3("rejected"));
+      }
+      return matchJoin(joinData, timeoutMs);
+    }
     const code = opts.create || !opts.code ? generateCode() : opts.code.toUpperCase();
     if (opts.roomUrl && opts.ticket) {
-      const devGrant = { ticket: opts.ticket, roomUrl: opts.roomUrl, expiresAt: 0 };
-      return new RoomConnection(code, devGrant).connect(devGrant);
+      const devGrant = {
+        ticket: opts.ticket,
+        roomUrl: opts.roomUrl,
+        expiresAt: 0,
+        roomId: code
+      };
+      return new RoomConnection(code, devGrant, joinData, timeoutMs).connect(devGrant);
     }
-    return requestTicket(code).then((grant) => new RoomConnection(code, null).connect(grant));
+    return requestTicket({ roomId: code }).then(
+      (grant) => new RoomConnection(code, null, joinData, timeoutMs).connect(grant)
+    );
   }
   var multiplayer = { joinRoom };
 

package/dist/index.cjs

@@ -38,6 +38,8 @@ var AD_PLACEMENT_SRC = "https://pagead2.googlesyndication.com/pagead/js/adsbygoo
 var AD_PLACEMENT_SCRIPT_ID = "bb-arcade-h5-ads";
 var DEFAULT_AD_LOAD_TIMEOUT_MS = 6e3;
 var SAVE_TIMEOUT_MS = 15e3;
+var LOCK_TIMEOUT_MS = 5e3;
+var MAX_SAVE_BYTES = 1024 * 1024;
 var INIT_CONFIG_GRACE_MS = 1500;
 var DEFAULT_ALLOW = [
   "bountyboard.gg",
@@ -62,6 +64,14 @@ function cleanText(value, fallback, max) {
   if (typeof value !== "string") return fallback || "";
   return value.replace(/[^\w:.-]+/g, "_").slice(0, max || 80) || fallback || "";
 }
+var cachedTextEncoder = null;
+function utf8ByteLength(value) {
+  if (typeof TextEncoder !== "undefined") {
+    cachedTextEncoder = cachedTextEncoder || new TextEncoder();
+    return cachedTextEncoder.encode(value).length;
+  }
+  return new Blob([value]).size;
+}
 function toBoolean(value) {
   return value === true || value === "true" || value === "1";
 }
@@ -181,13 +191,14 @@ function createBBArcade() {
   };
   let hostConfigReceived = false;
   let hostPlayer = null;
+  const playerChangeHandlers = [];
   let blocked = false;
   const pending = {};
   let seq = 0;
   function post(type, score, extra) {
     if (blocked) return;
     const message = { source: SDK_MESSAGE_SOURCE, v: VERSION, type };
-    if (typeof score === "number" && isFinite(score)) message.score = Math.floor(score);
+    if (typeof score === "number" && isFinite(score)) message.score = Math.trunc(score);
     if (extra && typeof extra === "object") {
       const fields = extra;
       for (const key in fields) {
@@ -208,7 +219,7 @@ function createBBArcade() {
       return true;
     }
   }
-  function request(type, payload) {
+  function request(type, payload, timeoutMs = SAVE_TIMEOUT_MS) {
     return new Promise(function(resolve, reject) {
       if (blocked) return reject(sdkError("error"));
       if (!isEmbedded()) return reject(sdkError("unsupported"));
@@ -218,7 +229,7 @@ function createBBArcade() {
           delete pending[requestId];
           reject(sdkError("error"));
         }
-      }, SAVE_TIMEOUT_MS);
+      }, timeoutMs);
       pending[requestId] = { resolve, reject, timer };
       try {
         window.parent.postMessage(
@@ -310,7 +321,7 @@ function createBBArcade() {
       if (!hostnameAllowed(origin, allow)) blockHost(options);
       return;
     }
-    request("host").then(
+    request("host", void 0, LOCK_TIMEOUT_MS).then(
       function(res) {
         const r = res;
         if (!hostnameAllowed(r && r.origin, allow)) blockHost(options);
@@ -334,7 +345,7 @@ function createBBArcade() {
         lockToHostBestEffort(opts, allow);
         return;
       }
-      request("host_attest").then(
+      request("host_attest", void 0, LOCK_TIMEOUT_MS).then(
         function(res) {
           const r = res;
           if (!r || !r.attestation) {
@@ -396,7 +407,15 @@ function createBBArcade() {
     if (msg.source !== HOST_MESSAGE_SOURCE || msg.type !== "config") return;
     hostConfigReceived = true;
     if (msg.player !== void 0) {
-      hostPlayer = sanitizePlayer(msg.player);
+      const nextPlayer = sanitizePlayer(msg.player);
+      const changed = nextPlayer === null ? hostPlayer !== null : hostPlayer === null || nextPlayer.name !== hostPlayer.name || nextPlayer.avatarUrl !== hostPlayer.avatarUrl;
+      hostPlayer = nextPlayer;
+      if (changed) {
+        const snapshot = nextPlayer ? { name: nextPlayer.name, avatarUrl: nextPlayer.avatarUrl } : null;
+        for (let i = 0; i < playerChangeHandlers.length; i++) {
+          safeCall(playerChangeHandlers[i], snapshot);
+        }
+      }
     }
     const rewardedAds = msg.rewardedAds;
     if (rewardedAds && typeof rewardedAds === "object") {
@@ -528,6 +547,7 @@ function createBBArcade() {
         let resolved = false;
         let status = "unavailable";
         let rewardOffered = false;
+        let adShown = false;
         const waitTimer = setTimeout(function() {
           if (rewardOffered || resolved) return;
           const timeout = Object.assign(
@@ -572,6 +592,7 @@ function createBBArcade() {
             }
             post("rewarded_ad", void 0, Object.assign({ event: "started" }, base));
             try {
+              adShown = true;
               showAdFn();
             } catch (err) {
               const showError = Object.assign(
@@ -621,7 +642,13 @@ function createBBArcade() {
             },
             adBreakDone: function(placementInfo) {
               if (resolved) return;
-              const result = rewardOffered || status !== "unavailable" ? { status } : { status: "unavailable", error: "no_rewarded_ad" };
+              const result = rewardOffered || status !== "unavailable" ? {
+                // A reward was offered but the ad never reached the screen
+                // (the game retained show() and let the break lapse): the
+                // break is over without a view, so resolve 'dismissed',
+                // not the non-terminal-looking 'ready'.
+                status: status === "ready" && !adShown ? "dismissed" : status
+              } : { status: "unavailable", error: "no_rewarded_ad" };
               if (placementInfo && typeof placementInfo === "object") {
                 result.breakStatus = cleanText(
                   placementInfo.breakStatus
@@ -824,12 +851,25 @@ function createBBArcade() {
     prepareRewardedBreak: prepareRewardedAd,
     rewardedBreak,
     save: function(blob) {
-      return request("save", String(blob));
+      const data = String(blob);
+      if (utf8ByteLength(data) > MAX_SAVE_BYTES) {
+        return Promise.reject(sdkError("too_large"));
+      }
+      return request("save", data);
     },
     load: function() {
       return request("load");
     },
     getPlayer,
+    onPlayerChange: function(handler) {
+      if (typeof handler !== "function") return function() {
+      };
+      playerChangeHandlers.push(handler);
+      return function() {
+        const idx = playerChangeHandlers.indexOf(handler);
+        if (idx !== -1) playerChangeHandlers.splice(idx, 1);
+      };
+    },
     getVariant: function(key, variants) {
       const sorted = Array.isArray(variants) ? variants.slice().sort() : [];
       const fallback = sorted.length > 0 ? sorted[0] : null;
@@ -896,6 +936,8 @@ function createInertBBArcade() {
     save: () => Promise.reject(sdkError2("unsupported")),
     load: () => Promise.reject(sdkError2("unsupported")),
     getPlayer: () => Promise.resolve(null),
+    onPlayerChange: () => () => {
+    },
     getVariant: (key, variants) => {
       const sorted = Array.isArray(variants) ? variants.slice().sort() : [];
       return Promise.resolve(sorted.length > 0 ? sorted[0] : null);