@bountyboard/arcade-sdk 1.0.1 → 1.2.0

package/dist/multiplayer.js

@@ -1,15 +1,20 @@
 import {
   BBArcade
-} from "./chunk-OWOESH4X.js";
+} from "./chunk-KDBBR532.js";
 
 // 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 sdkError(code) {
+function sdkError(code, detail) {
   const err = new Error(code);
   err.code = code;
+  if (detail) err.detail = detail;
   return err;
 }
 function randomChars(length) {
@@ -26,27 +31,51 @@ function randomChars(length) {
 function generateCode() {
   return randomChars(CODE_LENGTH);
 }
-var guestKey = null;
-function getGuestKey() {
-  if (!guestKey) guestKey = randomChars(16);
-  return guestKey;
+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 serializeJoinData(data) {
+  if (data === void 0) return null;
+  if (!data || typeof data !== "object" || Array.isArray(data)) throw sdkError("rejected");
+  let serialized;
+  try {
+    serialized = JSON.stringify(data);
+  } catch (e) {
+    throw sdkError("rejected");
+  }
+  if (!serialized || utf8ByteLength(serialized) > MAX_JOIN_DATA_BYTES) {
+    throw sdkError("rejected");
+  }
+  return serialized;
 }
-function requestTicket(roomId) {
+function requestTicket(payload) {
   const request = BBArcade._request;
   if (typeof request !== "function") return Promise.reject(sdkError("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 sdkError("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
@@ -59,14 +88,20 @@ var RoomConnection = class {
     // 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);
@@ -77,13 +112,15 @@ var RoomConnection = class {
       const welcomeTimer = setTimeout(() => {
         if (settled) return;
         settled = true;
+        this.pendingConnect = null;
         this.terminal = true;
         try {
           ws.close();
         } catch (err) {
         }
         reject(sdkError("error"));
-      }, WELCOME_TIMEOUT_MS);
+      }, this.welcomeTimeoutMs);
+      this.pendingConnect = { reject, timer: welcomeTimer };
       ws.onmessage = (event) => {
         var _a, _b, _c, _d, _e;
         let msg;
@@ -94,15 +131,27 @@ var RoomConnection = class {
         }
         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") {
@@ -140,25 +189,30 @@ var RoomConnection = class {
           if (!settled) {
             settled = true;
             this.terminal = true;
+            this.pendingConnect = null;
             clearTimeout(welcomeTimer);
             try {
               ws.close();
             } catch (err) {
             }
-            reject(sdkError(code === "unauthenticated" ? "unauthenticated" : "rejected"));
+            reject(sdkError(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(sdkError("error"));
           return;
         }
         if (this.intentionalClose || this.ended || this.terminal) {
+          this.emit("connection", { connected: false, reconnecting: false });
           this.emit("close", { reconnecting: false });
           return;
         }
@@ -176,11 +230,12 @@ var RoomConnection = class {
       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();
@@ -189,11 +244,16 @@ var RoomConnection = class {
     }
   }
   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) {
@@ -209,6 +269,13 @@ var RoomConnection = class {
   leave() {
     var _a;
     this.intentionalClose = true;
+    this.connected = false;
+    if (this.pendingConnect) {
+      const pending = this.pendingConnect;
+      this.pendingConnect = null;
+      clearTimeout(pending.timer);
+      pending.reject(sdkError("error"));
+    }
     try {
       (_a = this.ws) == null ? void 0 : _a.close(1e3);
     } catch (err) {
@@ -228,17 +295,57 @@ var RoomConnection = class {
     }
   }
 };
+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 = sdkError("error");
+  for (let attempt = 0; attempt < MATCH_ATTEMPTS; attempt++) {
+    const grant = await requestTicket({ matchmake: true });
+    if (!grant.roomId) throw sdkError("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(sdkError("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(sdkError("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 };
 export {

package/dist/multiplayer.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/multiplayer.ts"],"sourcesContent":["/**\n * Multiplayer client for the Bounty Board arcade room server\n * (packages/arcade-mp-server — authoritative Durable-Object rooms).\n *\n * Trust model: the game NEVER holds credentials. joinRoom() asks the embedding\n * Bounty Board host for a short-lived signed ticket (postMessage `mp_ticket`,\n * answered by the host frame which holds the player's session), then opens a\n * WebSocket to the room URL the ticket API returned. The room server verifies\n * the ticket before accepting, runs the simulation itself, and reports match\n * results to Bounty Board over a server-to-server channel — so nothing a\n * modified client sends can forge an identity or a recorded outcome. Clients\n * send INPUTS; the server sends per-viewer-filtered snapshots.\n */\nimport { BBArcade } from './index';\nimport type {\n  BBArcadeErrorCode,\n  BBArcadeMpJoinOptions,\n  BBArcadeMpPlayer,\n  BBArcadeMpResult,\n  BBArcadeMpRoom,\n  BBArcadeMpRoomEvents,\n  BBArcadeMultiplayer,\n} from './types';\n\nexport type {\n  BBArcadeMpJoinOptions,\n  BBArcadeMpPlayer,\n  BBArcadeMpResult,\n  BBArcadeMpRoom,\n  BBArcadeMpRoomEvents,\n  BBArcadeMultiplayer,\n} from './types';\n\nconst WELCOME_TIMEOUT_MS = 10_000;\nconst MAX_RECONNECT_ATTEMPTS = 3;\n// Unambiguous alphabet (no 0/O/1/I) for share codes friends read aloud.\nconst CODE_ALPHABET = 'ABCDEFGHJKLMNPQRSTUVWXYZ23456789';\nconst CODE_LENGTH = 4;\n\ninterface TicketGrant {\n  ticket: string;\n  roomUrl: string;\n  expiresAt: number;\n}\n\ninterface SdkError extends Error {\n  code: BBArcadeErrorCode;\n}\n\nfunction sdkError(code: BBArcadeErrorCode): SdkError {\n  const err = new Error(code) as SdkError;\n  err.code = code;\n  return err;\n}\n\nfunction randomChars(length: number): string {\n  const indices = new Uint8Array(length);\n  if (typeof crypto !== 'undefined' && typeof crypto.getRandomValues === 'function') {\n    crypto.getRandomValues(indices);\n  } else {\n    for (let i = 0; i < length; i++) indices[i] = Math.floor(Math.random() * 256);\n  }\n  let out = '';\n  // 256 is an exact multiple of the 32-char alphabet, so no modulo bias.\n  for (let i = 0; i < length; i++) out += CODE_ALPHABET[indices[i] % CODE_ALPHABET.length];\n  return out;\n}\n\nfunction generateCode(): string {\n  return randomChars(CODE_LENGTH);\n}\n\n// Stable for the page load so a GUEST's reconnect (which mints a fresh ticket)\n// resumes the same room seat: the ticket API folds this key into the guest\n// subject instead of rolling a new random one per ticket. Logged-in players\n// don't need it (their subject is the stable profile id).\nlet guestKey: string | null = null;\nfunction getGuestKey(): string {\n  if (!guestKey) guestKey = randomChars(16);\n  return guestKey;\n}\n\n/** The host-frame handshake, riding the core SDK's request/response transport. */\nfunction requestTicket(roomId: string): Promise<TicketGrant> {\n  const request = (\n    BBArcade as unknown as { _request?: (type: string, payload?: unknown) => Promise<unknown> }\n  )._request;\n  if (typeof request !== 'function') return Promise.reject(sdkError('unsupported'));\n  return request('mp_ticket', { roomId, guestKey: getGuestKey() }).then(grant => {\n    const g = grant as Partial<TicketGrant> | null;\n    if (!g || typeof g.ticket !== 'string' || typeof g.roomUrl !== 'string') {\n      throw sdkError('error');\n    }\n    return { ticket: g.ticket, roomUrl: g.roomUrl, expiresAt: Number(g.expiresAt) || 0 };\n  });\n}\n\nclass RoomConnection implements BBArcadeMpRoom {\n  code: string;\n  playerId = '';\n  players: BBArcadeMpPlayer[] = [];\n  state: unknown = null;\n\n  private ws: WebSocket | null = null;\n  // Keyed by event name; values are erased to (unknown) => void internally and\n  // retyped at the on()/emit() boundary, which keeps the public API strictly\n  // typed without fighting generic index-assignment rules.\n  private handlers: Record<string, Array<(data: unknown) => void> | undefined> = {};\n  private seq = 0;\n  private intentionalClose = false;\n  private ended = false;\n  // Set when the server definitively rejected us (bad ticket, room full/over)\n  // or the welcome timed out — permanent outcomes that must not reconnect.\n  private terminal = false;\n  private reconnectAttempts = 0;\n  private readonly devGrant: TicketGrant | null;\n\n  constructor(code: string, devGrant: TicketGrant | null) {\n    this.code = code;\n    this.devGrant = devGrant;\n  }\n\n  /** Connect and resolve on the server's welcome (post-ticket-verification). */\n  connect(grant: TicketGrant): Promise<this> {\n    return new Promise((resolve, reject) => {\n      let settled = false;\n      const url =\n        grant.roomUrl +\n        (grant.roomUrl.indexOf('?') === -1 ? '?' : '&') +\n        'ticket=' +\n        encodeURIComponent(grant.ticket);\n      let ws: WebSocket;\n      try {\n        ws = new WebSocket(url);\n      } catch (err) {\n        return reject(sdkError('error'));\n      }\n      this.ws = ws;\n\n      const welcomeTimer = setTimeout(() => {\n        if (settled) return;\n        settled = true;\n        this.terminal = true; // the join already failed — closing must not retry\n        try {\n          ws.close();\n        } catch (err) {\n          /* already closing */\n        }\n        reject(sdkError('error'));\n      }, WELCOME_TIMEOUT_MS);\n\n      ws.onmessage = event => {\n        let msg: { t?: string } & Record<string, unknown>;\n        try {\n          msg = JSON.parse(String(event.data));\n        } catch (err) {\n          return; // non-JSON frames are not part of the protocol\n        }\n        if (!msg || typeof msg.t !== 'string') return;\n\n        if (msg.t === 'welcome') {\n          this.playerId = String(msg.playerId ?? '');\n          this.players = Array.isArray(msg.players) ? (msg.players as BBArcadeMpPlayer[]) : [];\n          this.state = msg.state ?? null;\n          this.reconnectAttempts = 0;\n          if (!settled) {\n            settled = true;\n            clearTimeout(welcomeTimer);\n            resolve(this);\n          }\n          return;\n        }\n        if (msg.t === 'snapshot') {\n          this.state = msg.state ?? this.state;\n          this.emit('snapshot', { tick: Number(msg.tick) || 0, state: this.state });\n          return;\n        }\n        if (msg.t === 'player_join') {\n          const player = msg.player as BBArcadeMpPlayer;\n          if (player && player.id && !this.players.some(p => p.id === player.id)) {\n            this.players.push(player);\n          }\n          this.emit('playerJoin', { player });\n          return;\n        }\n        if (msg.t === 'player_leave') {\n          const playerId = String(msg.playerId ?? '');\n          this.players = this.players.filter(p => p.id !== playerId);\n          this.emit('playerLeave', { playerId });\n          return;\n        }\n        if (msg.t === 'event') {\n          this.emit('event', msg.data);\n          return;\n        }\n        if (msg.t === 'match_end') {\n          this.ended = true;\n          this.emit('end', {\n            results: Array.isArray(msg.results) ? (msg.results as BBArcadeMpResult[]) : [],\n          });\n          return;\n        }\n        if (msg.t === 'error') {\n          const code = String(msg.code ?? 'error');\n          if (!settled) {\n            // A pre-welcome error is a DEFINITIVE rejection (bad ticket, room\n            // full/over, unknown game) — reconnecting would just repeat it.\n            settled = true;\n            this.terminal = true;\n            clearTimeout(welcomeTimer);\n            try {\n              ws.close();\n            } catch (err) {\n              /* already closing */\n            }\n            reject(sdkError(code === 'unauthenticated' ? 'unauthenticated' : 'rejected'));\n            return;\n          }\n          this.emit('error', { code });\n        }\n      };\n\n      ws.onclose = () => {\n        if (!settled) {\n          settled = true;\n          clearTimeout(welcomeTimer);\n          reject(sdkError('error'));\n          return;\n        }\n        if (this.intentionalClose || this.ended || this.terminal) {\n          this.emit('close', { reconnecting: false });\n          return;\n        }\n        void this.reconnect();\n      };\n\n      ws.onerror = () => {\n        /* onclose always follows and carries the handling */\n      };\n    });\n  }\n\n  private async reconnect(): Promise<void> {\n    if (this.intentionalClose || this.ended || this.terminal) return;\n    if (this.reconnectAttempts >= MAX_RECONNECT_ATTEMPTS) {\n      this.emit('close', { reconnecting: false });\n      return;\n    }\n    this.reconnectAttempts += 1;\n    this.emit('close', { reconnecting: true });\n    await new Promise(r => setTimeout(r, 400 * this.reconnectAttempts));\n    // leave() may have been called during the backoff — opening a new socket\n    // then would strand a connection the caller can no longer close.\n    if (this.intentionalClose || this.ended || this.terminal) return;\n    try {\n      // Tickets are 60s single-purpose grants — always fetch a fresh one\n      // (except in dev-override mode, where the dev ticket is reused).\n      const grant = this.devGrant ?? (await requestTicket(this.code));\n      if (this.intentionalClose || this.ended || this.terminal) return;\n      await this.connect(grant);\n      // leave() raced the reconnect while the socket was opening: close it.\n      if (this.intentionalClose) this.leave();\n    } catch (err) {\n      void this.reconnect();\n    }\n  }\n\n  send(input: unknown): void {\n    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;\n    this.seq += 1;\n    try {\n      this.ws.send(JSON.stringify({ t: 'input', seq: this.seq, data: input }));\n    } catch (err) {\n      /* socket raced shut — the close handler owns recovery */\n    }\n  }\n\n  on<K extends keyof BBArcadeMpRoomEvents>(\n    event: K,\n    handler: (data: BBArcadeMpRoomEvents[K]) => void\n  ): () => void {\n    const list = (this.handlers[event] ??= []);\n    const entry = handler as (data: unknown) => void;\n    list.push(entry);\n    return () => {\n      const idx = list.indexOf(entry);\n      if (idx !== -1) list.splice(idx, 1);\n    };\n  }\n\n  leave(): void {\n    this.intentionalClose = true;\n    try {\n      this.ws?.close(1000);\n    } catch (err) {\n      /* already closed */\n    }\n  }\n\n  private emit<K extends keyof BBArcadeMpRoomEvents>(event: K, data: BBArcadeMpRoomEvents[K]) {\n    const list = this.handlers[event];\n    if (!list) return;\n    for (const handler of list.slice()) {\n      try {\n        handler(data);\n      } catch (err) {\n        setTimeout(() => {\n          throw err;\n        }, 0);\n      }\n    }\n  }\n}\n\nexport function joinRoom(options?: BBArcadeMpJoinOptions): Promise<BBArcadeMpRoom> {\n  const opts = options ?? {};\n  if (typeof window === 'undefined' || typeof WebSocket === 'undefined') {\n    return Promise.reject(sdkError('unsupported'));\n  }\n\n  const code = opts.create || !opts.code ? generateCode() : opts.code.toUpperCase();\n\n  // Dev override: straight to a local room server, no host handshake.\n  if (opts.roomUrl && opts.ticket) {\n    const devGrant: TicketGrant = { ticket: opts.ticket, roomUrl: opts.roomUrl, expiresAt: 0 };\n    return new RoomConnection(code, devGrant).connect(devGrant);\n  }\n\n  return requestTicket(code).then(grant => new RoomConnection(code, null).connect(grant));\n}\n\nexport const multiplayer: BBArcadeMultiplayer = { joinRoom };\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/multiplayer.ts"],"sourcesContent":["/**\n * Multiplayer client for the Bounty Board arcade room server\n * (packages/arcade-mp-server — authoritative Durable-Object rooms).\n *\n * Trust model: the game NEVER holds credentials. joinRoom() asks the embedding\n * Bounty Board host for a short-lived signed ticket (postMessage `mp_ticket`,\n * answered by the host frame which holds the player's session), then opens a\n * WebSocket to the room URL the ticket API returned. The room server verifies\n * the ticket before accepting, runs the simulation itself, and reports match\n * results to Bounty Board over a server-to-server channel — so nothing a\n * modified client sends can forge an identity or a recorded outcome. Clients\n * send INPUTS; the server sends per-viewer-filtered snapshots.\n */\nimport { BBArcade } from './index';\nimport type {\n  BBArcadeErrorCode,\n  BBArcadeMpJoinOptions,\n  BBArcadeMpPlayer,\n  BBArcadeMpResult,\n  BBArcadeMpRoom,\n  BBArcadeMpRoomEvents,\n  BBArcadeMultiplayer,\n} from './types';\n\nexport type {\n  BBArcadeMpJoinOptions,\n  BBArcadeMpPlayer,\n  BBArcadeMpResult,\n  BBArcadeMpRoom,\n  BBArcadeMpRoomEvents,\n  BBArcadeMultiplayer,\n} from './types';\n\nconst WELCOME_TIMEOUT_MS = 10_000;\nconst MIN_WELCOME_TIMEOUT_MS = 1_000;\nconst MAX_WELCOME_TIMEOUT_MS = 60_000;\nconst MAX_RECONNECT_ATTEMPTS = 3;\nconst MAX_JOIN_DATA_BYTES = 1_024;\n/** Server closes with this code when the seat already has its max sockets. */\nconst SEAT_FULL_CLOSE_CODE = 4005;\n// Unambiguous alphabet (no 0/O/1/I) for share codes friends read aloud.\nconst CODE_ALPHABET = 'ABCDEFGHJKLMNPQRSTUVWXYZ23456789';\nconst CODE_LENGTH = 4;\n\ninterface TicketGrant {\n  ticket: string;\n  roomUrl: string;\n  expiresAt: number;\n  /** The room the ticket is bound to — how quick match learns its code. */\n  roomId: string | null;\n}\n\ninterface SdkError extends Error {\n  code: BBArcadeErrorCode;\n  detail?: string;\n}\n\nfunction sdkError(code: BBArcadeErrorCode, detail?: string): SdkError {\n  const err = new Error(code) as SdkError;\n  err.code = code;\n  if (detail) err.detail = detail;\n  return err;\n}\n\nfunction randomChars(length: number): string {\n  const indices = new Uint8Array(length);\n  if (typeof crypto !== 'undefined' && typeof crypto.getRandomValues === 'function') {\n    crypto.getRandomValues(indices);\n  } else {\n    for (let i = 0; i < length; i++) indices[i] = Math.floor(Math.random() * 256);\n  }\n  let out = '';\n  // 256 is an exact multiple of the 32-char alphabet, so no modulo bias.\n  for (let i = 0; i < length; i++) out += CODE_ALPHABET[indices[i] % CODE_ALPHABET.length];\n  return out;\n}\n\nfunction generateCode(): string {\n  return randomChars(CODE_LENGTH);\n}\n\n// Lazy: import must stay clean even where TextEncoder is missing (some\n// test/SSR shims); Blob gives the same exact UTF-8 byte count as a fallback.\nlet cachedTextEncoder: TextEncoder | null = null;\n\nfunction utf8ByteLength(value: string): number {\n  if (typeof TextEncoder !== 'undefined') {\n    cachedTextEncoder = cachedTextEncoder || new TextEncoder();\n    return cachedTextEncoder.encode(value).length;\n  }\n  return new Blob([value]).size;\n}\n\nfunction serializeJoinData(data: BBArcadeMpJoinOptions['joinData']): string | null {\n  if (data === undefined) return null;\n  if (!data || typeof data !== 'object' || Array.isArray(data)) throw sdkError('rejected');\n\n  let serialized: string;\n  try {\n    serialized = JSON.stringify(data);\n  } catch {\n    throw sdkError('rejected');\n  }\n  if (!serialized || utf8ByteLength(serialized) > MAX_JOIN_DATA_BYTES) {\n    throw sdkError('rejected');\n  }\n  return serialized;\n}\n\n/** The host-frame handshake, riding the core SDK's request/response transport. */\nfunction requestTicket(payload: { roomId: string } | { matchmake: true }): Promise<TicketGrant> {\n  const request = (\n    BBArcade as unknown as { _request?: (type: string, payload?: unknown) => Promise<unknown> }\n  )._request;\n  if (typeof request !== 'function') return Promise.reject(sdkError('unsupported'));\n  return request('mp_ticket', payload).then(grant => {\n    const g = grant as Partial<TicketGrant> | null;\n    if (!g || typeof g.ticket !== 'string' || typeof g.roomUrl !== 'string') {\n      throw sdkError('error');\n    }\n    return {\n      ticket: g.ticket,\n      roomUrl: g.roomUrl,\n      expiresAt: Number(g.expiresAt) || 0,\n      roomId: typeof g.roomId === 'string' && g.roomId ? g.roomId : null,\n    };\n  });\n}\n\nclass RoomConnection implements BBArcadeMpRoom {\n  code: string;\n  playerId = '';\n  players: BBArcadeMpPlayer[] = [];\n  state: unknown = null;\n  connected = false;\n  latencyMs: number | null = null;\n\n  private ws: WebSocket | null = null;\n  // Keyed by event name; values are erased to (unknown) => void internally and\n  // retyped at the on()/emit() boundary, which keeps the public API strictly\n  // typed without fighting generic index-assignment rules.\n  private handlers: Record<string, Array<(data: unknown) => void> | undefined> = {};\n  private seq = 0;\n  private intentionalClose = false;\n  private ended = false;\n  // Set when the server definitively rejected us (bad ticket, room full/over)\n  // or the welcome timed out — permanent outcomes that must not reconnect.\n  private terminal = false;\n  private reconnectAttempts = 0;\n  private readonly devGrant: TicketGrant | null;\n  private readonly joinData: string | null;\n  private readonly welcomeTimeoutMs: number;\n  // The in-flight connect()'s settlement, so leave() can reject a join that\n  // is still waiting on its welcome instead of stranding it on the timeout.\n  private pendingConnect: {\n    reject: (err: SdkError) => void;\n    timer: ReturnType<typeof setTimeout>;\n  } | null = null;\n\n  constructor(\n    code: string,\n    devGrant: TicketGrant | null,\n    joinData: string | null,\n    welcomeTimeoutMs: number = WELCOME_TIMEOUT_MS\n  ) {\n    this.code = code;\n    this.devGrant = devGrant;\n    this.joinData = joinData;\n    this.welcomeTimeoutMs = welcomeTimeoutMs;\n  }\n\n  /** Connect and resolve on the server's welcome (post-ticket-verification). */\n  connect(grant: TicketGrant): Promise<this> {\n    return new Promise((resolve, reject) => {\n      let settled = false;\n      const url =\n        grant.roomUrl +\n        (grant.roomUrl.indexOf('?') === -1 ? '?' : '&') +\n        'ticket=' +\n        encodeURIComponent(grant.ticket) +\n        (this.joinData === null ? '' : '&join=' + encodeURIComponent(this.joinData));\n      const connectStartedAt = Date.now();\n      let ws: WebSocket;\n      try {\n        ws = new WebSocket(url);\n      } catch (err) {\n        return reject(sdkError('error'));\n      }\n      this.ws = ws;\n\n      const welcomeTimer = setTimeout(() => {\n        if (settled) return;\n        settled = true;\n        this.pendingConnect = null;\n        this.terminal = true; // the join already failed — closing must not retry\n        try {\n          ws.close();\n        } catch (err) {\n          /* already closing */\n        }\n        reject(sdkError('error'));\n      }, this.welcomeTimeoutMs);\n      this.pendingConnect = { reject, timer: welcomeTimer };\n\n      ws.onmessage = event => {\n        let msg: { t?: string } & Record<string, unknown>;\n        try {\n          msg = JSON.parse(String(event.data));\n        } catch (err) {\n          return; // non-JSON frames are not part of the protocol\n        }\n        if (!msg || typeof msg.t !== 'string') return;\n\n        if (msg.t === 'welcome') {\n          // leave() beat the welcome: the join already rejected, so this late\n          // welcome must not resurrect a room the caller walked away from.\n          if (this.intentionalClose) {\n            try {\n              ws.close();\n            } catch (err) {\n              /* already closing */\n            }\n            return;\n          }\n          const reconnected = this.reconnectAttempts > 0;\n          this.playerId = String(msg.playerId ?? '');\n          this.players = Array.isArray(msg.players) ? (msg.players as BBArcadeMpPlayer[]) : [];\n          this.state = msg.state ?? null;\n          this.connected = true;\n          this.reconnectAttempts = 0;\n          // Join-handshake latency: socket open → server welcome (ticket verify\n          // + one round trip). A tuning estimate, not a measured RTT.\n          this.latencyMs = Math.max(0, Date.now() - connectStartedAt);\n          if (!settled) {\n            settled = true;\n            this.pendingConnect = null;\n            clearTimeout(welcomeTimer);\n            resolve(this);\n          }\n          if (reconnected) this.emit('connection', { connected: true, reconnecting: false });\n          return;\n        }\n        if (msg.t === 'snapshot') {\n          this.state = msg.state ?? this.state;\n          this.emit('snapshot', { tick: Number(msg.tick) || 0, state: this.state });\n          return;\n        }\n        if (msg.t === 'player_join') {\n          const player = msg.player as BBArcadeMpPlayer;\n          if (player && player.id && !this.players.some(p => p.id === player.id)) {\n            this.players.push(player);\n          }\n          this.emit('playerJoin', { player });\n          return;\n        }\n        if (msg.t === 'player_leave') {\n          const playerId = String(msg.playerId ?? '');\n          this.players = this.players.filter(p => p.id !== playerId);\n          this.emit('playerLeave', { playerId });\n          return;\n        }\n        if (msg.t === 'event') {\n          this.emit('event', msg.data);\n          return;\n        }\n        if (msg.t === 'match_end') {\n          this.ended = true;\n          this.emit('end', {\n            results: Array.isArray(msg.results) ? (msg.results as BBArcadeMpResult[]) : [],\n          });\n          return;\n        }\n        if (msg.t === 'error') {\n          const code = String(msg.code ?? 'error');\n          if (!settled) {\n            // A pre-welcome error is a DEFINITIVE rejection (bad ticket, room\n            // full/over, unknown game) — reconnecting would just repeat it.\n            settled = true;\n            this.terminal = true;\n            this.pendingConnect = null;\n            clearTimeout(welcomeTimer);\n            try {\n              ws.close();\n            } catch (err) {\n              /* already closing */\n            }\n            // The raw server code rides along as `detail` so quick match can\n            // distinguish a lost seat race (room_full/room_over) from a hard no.\n            reject(sdkError(code === 'unauthenticated' ? 'unauthenticated' : 'rejected', code));\n            return;\n          }\n          this.emit('error', { code });\n        }\n      };\n\n      ws.onclose = (event: CloseEvent) => {\n        this.connected = false;\n        // 4005: the server rejected/superseded this socket because the seat is\n        // at capacity. Reconnecting would immediately re-trigger it (or evict a\n        // sibling), so it is permanent for this Room instance.\n        if (event && event.code === SEAT_FULL_CLOSE_CODE) this.terminal = true;\n        if (!settled) {\n          settled = true;\n          this.pendingConnect = null;\n          clearTimeout(welcomeTimer);\n          reject(sdkError('error'));\n          return;\n        }\n        if (this.intentionalClose || this.ended || this.terminal) {\n          this.emit('connection', { connected: false, reconnecting: false });\n          this.emit('close', { reconnecting: false });\n          return;\n        }\n        void this.reconnect();\n      };\n\n      ws.onerror = () => {\n        /* onclose always follows and carries the handling */\n      };\n    });\n  }\n\n  private async reconnect(): Promise<void> {\n    if (this.intentionalClose || this.ended || this.terminal) return;\n    if (this.reconnectAttempts >= MAX_RECONNECT_ATTEMPTS) {\n      this.emit('close', { reconnecting: false });\n      return;\n    }\n    this.reconnectAttempts += 1;\n    this.emit('connection', { connected: false, reconnecting: true });\n    this.emit('close', { reconnecting: true });\n    await new Promise(r => setTimeout(r, 400 * this.reconnectAttempts));\n    // leave() may have been called during the backoff — opening a new socket\n    // then would strand a connection the caller can no longer close.\n    if (this.intentionalClose || this.ended || this.terminal) return;\n    try {\n      // Tickets are 60s single-purpose grants — always fetch a fresh one\n      // (except in dev-override mode, where the dev ticket is reused).\n      const grant = this.devGrant ?? (await requestTicket({ roomId: this.code }));\n      if (this.intentionalClose || this.ended || this.terminal) return;\n      await this.connect(grant);\n      // leave() raced the reconnect while the socket was opening: close it.\n      if (this.intentionalClose) this.leave();\n    } catch (err) {\n      void this.reconnect();\n    }\n  }\n\n  send(input: unknown): void {\n    this.trySend(input);\n  }\n\n  trySend(input: unknown): boolean {\n    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return false;\n    this.seq += 1;\n    try {\n      this.ws.send(JSON.stringify({ t: 'input', seq: this.seq, data: input }));\n      return true;\n    } catch (err) {\n      /* socket raced shut — the close handler owns recovery */\n      return false;\n    }\n  }\n\n  on<K extends keyof BBArcadeMpRoomEvents>(\n    event: K,\n    handler: (data: BBArcadeMpRoomEvents[K]) => void\n  ): () => void {\n    const list = (this.handlers[event] ??= []);\n    const entry = handler as (data: unknown) => void;\n    list.push(entry);\n    return () => {\n      const idx = list.indexOf(entry);\n      if (idx !== -1) list.splice(idx, 1);\n    };\n  }\n\n  leave(): void {\n    this.intentionalClose = true;\n    this.connected = false;\n    // A join still waiting on its welcome settles now (not on the welcome\n    // timeout), and the welcome handler's intentionalClose guard keeps a late\n    // welcome from resurrecting the room.\n    if (this.pendingConnect) {\n      const pending = this.pendingConnect;\n      this.pendingConnect = null;\n      clearTimeout(pending.timer);\n      pending.reject(sdkError('error'));\n    }\n    try {\n      this.ws?.close(1000);\n    } catch (err) {\n      /* already closed */\n    }\n  }\n\n  private emit<K extends keyof BBArcadeMpRoomEvents>(event: K, data: BBArcadeMpRoomEvents[K]) {\n    const list = this.handlers[event];\n    if (!list) return;\n    for (const handler of list.slice()) {\n      try {\n        handler(data);\n      } catch (err) {\n        setTimeout(() => {\n          throw err;\n        }, 0);\n      }\n    }\n  }\n}\n\n/**\n * Quick match can lose the last seat of the room it was pointed at (another\n * player connected first, or the match just ended). Those two outcomes are\n * races, not verdicts — re-matchmake and land in the next open room.\n */\nconst MATCH_ATTEMPTS = 3;\n\nfunction normalizeWelcomeTimeoutMs(value: unknown): number {\n  if (typeof value !== 'number' || !isFinite(value)) return WELCOME_TIMEOUT_MS;\n  return Math.min(MAX_WELCOME_TIMEOUT_MS, Math.max(MIN_WELCOME_TIMEOUT_MS, Math.floor(value)));\n}\n\nasync function matchJoin(joinData: string | null, timeoutMs: number): Promise<BBArcadeMpRoom> {\n  let lastError: unknown = sdkError('error');\n  for (let attempt = 0; attempt < MATCH_ATTEMPTS; attempt++) {\n    // Host/ticket failures reject immediately: they are not seat races.\n    const grant = await requestTicket({ matchmake: true });\n    if (!grant.roomId) throw sdkError('error');\n    try {\n      return await new RoomConnection(grant.roomId, null, joinData, timeoutMs).connect(grant);\n    } catch (error) {\n      lastError = error;\n      const detail = (error as SdkError | null)?.detail;\n      if (detail !== 'room_full' && detail !== 'room_over') throw error;\n    }\n  }\n  throw lastError;\n}\n\nexport function joinRoom(options?: BBArcadeMpJoinOptions): Promise<BBArcadeMpRoom> {\n  const opts = options ?? {};\n  if (typeof window === 'undefined' || typeof WebSocket === 'undefined') {\n    return Promise.reject(sdkError('unsupported'));\n  }\n\n  let joinData: string | null;\n  try {\n    joinData = serializeJoinData(opts.joinData);\n  } catch (err) {\n    return Promise.reject(err);\n  }\n\n  const timeoutMs = normalizeWelcomeTimeoutMs(opts.timeoutMs);\n\n  if (opts.match) {\n    // Quick match picks the room itself — no code, no create, no dev override.\n    if (opts.code || opts.create || opts.roomUrl || opts.ticket) {\n      return Promise.reject(sdkError('rejected'));\n    }\n    return matchJoin(joinData, timeoutMs);\n  }\n\n  const code = opts.create || !opts.code ? generateCode() : opts.code.toUpperCase();\n\n  // Dev override: straight to a local room server, no host handshake.\n  if (opts.roomUrl && opts.ticket) {\n    const devGrant: TicketGrant = {\n      ticket: opts.ticket,\n      roomUrl: opts.roomUrl,\n      expiresAt: 0,\n      roomId: code,\n    };\n    return new RoomConnection(code, devGrant, joinData, timeoutMs).connect(devGrant);\n  }\n\n  return requestTicket({ roomId: code }).then(grant =>\n    new RoomConnection(code, null, joinData, timeoutMs).connect(grant)\n  );\n}\n\nexport const multiplayer: BBArcadeMultiplayer = { joinRoom };\n"],"mappings":"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","names":[]}

package/dist/{types-BKChtV3H.d.cts → types-dtsNXYZW.d.cts}

@@ -22,6 +22,8 @@ type BBArcadeErrorCode =
 /** Rejection reason for save()/load(): a real Error that also carries `code`. */
 interface BBArcadeError extends Error {
     code: BBArcadeErrorCode;
+    /** Optional server detail for 'rejected' errors (e.g. 'room_full'). */
+    detail?: string;
 }
 /** Rewarded-ads settings accepted by init()/configure(). */
 interface BBArcadeRewardedAdsConfig {
@@ -73,7 +75,17 @@ interface BBArcadeLockToHostOptions {
     redirect?: string;
 }
 /** Outcome of a rewarded placement. */
-type BBArcadeRewardedAdStatus = 'viewed' | 'dismissed' | 'ready' | 'unavailable' | 'error';
+type BBArcadeRewardedAdStatus = 
+/** The player watched the ad to completion — the only status that grants. */
+'viewed'
+/** The player closed the ad early, or a prepared ad ended before it was ever shown. */
+ | 'dismissed'
+/** An ad is ready to show (preparation result; terminal only in the legacy shown-but-unreported edge). */
+ | 'ready'
+/** No ad could be offered. */
+ | 'unavailable'
+/** The placement failed. */
+ | 'error';
 /** Resolution value of rewardedAd()/showRewardedAd(). */
 interface BBArcadeRewardedAdResult {
     /** 'viewed' is the only status that should grant the reward. */
@@ -196,6 +208,22 @@ interface BBArcadeMpJoinOptions {
     code?: string;
     /** Create a new room (a share code is generated for you). */
     create?: boolean;
+    /**
+     * Public quick match: join your game's open public room, or start a fresh
+     * one when no seat is free. Mutually exclusive with code/create. Rooms fill
+     * to the game's player cap (at most 64), and a matched room still exposes
+     * room.code so the player can invite friends into the same room. If the
+     * last free seat is lost to a race, the SDK re-matchmakes automatically a
+     * couple of times before rejecting.
+     */
+    match?: boolean;
+    /**
+     * Game-defined, JSON-serializable data supplied to the authoritative module
+     * before it admits this player (avatar/loadout/mode selections, for example).
+     * The room server treats this as untrusted input and limits it to 1 KiB.
+     * Never put credentials or other secrets here.
+     */
+    joinData?: Readonly<Record<string, unknown>>;
     /**
      * Local development only: connect straight to a room server (e.g. wrangler
      * dev with DEV_ALLOW_UNSIGNED=1) instead of asking the Bounty Board host for
@@ -203,6 +231,12 @@ interface BBArcadeMpJoinOptions {
      */
     roomUrl?: string;
     ticket?: string;
+    /**
+     * How long to wait for the room server's welcome before the join rejects
+     * with code 'error', in ms (default 10000, clamped to 1000–60000). Applies
+     * to the initial join and to every automatic reconnect attempt.
+     */
+    timeoutMs?: number;
 }
 /** Events a multiplayer room emits. */
 interface BBArcadeMpRoomEvents {
@@ -226,6 +260,11 @@ interface BBArcadeMpRoomEvents {
     error: {
         code: string;
     };
+    /** Connection state, including successful automatic reconnection. */
+    connection: {
+        connected: boolean;
+        reconnecting: boolean;
+    };
     /** Connection dropped. reconnecting: true means the SDK is retrying. */
     close: {
         reconnecting: boolean;
@@ -241,8 +280,19 @@ interface BBArcadeMpRoom {
     players: BBArcadeMpPlayer[];
     /** Latest authoritative state snapshot (as filtered for you). */
     state: unknown;
+    /** Whether the room currently has an accepted WebSocket connection. */
+    connected: boolean;
+    /**
+     * Join-handshake latency in ms (socket open → server welcome, so ticket
+     * verification plus one round trip), refreshed on every successful
+     * (re)connect; null until the first welcome arrives. A tuning estimate for
+     * render-side smoothing, not a measured RTT.
+     */
+    latencyMs: number | null;
     /** Send an INPUT to the server (never authoritative state — the server simulates). */
     send(input: unknown): void;
+    /** Like send(), but reports false when disconnected or the socket raced closed. */
+    trySend(input: unknown): boolean;
     /** Subscribe to a room event; returns an unsubscribe function. */
     on<K extends keyof BBArcadeMpRoomEvents>(event: K, handler: (data: BBArcadeMpRoomEvents[K]) => void): () => void;
     /** Leave the room and close the connection (no reconnect). */
@@ -270,6 +320,9 @@ interface BBArcadeSDK {
     /**
      * Refuse to run unless embedded on a Bounty Board host (anti
      * scrape-and-reupload deterrent — not DRM). Call once, early, before boot.
+     * When the embedder can't be determined from browser signals (opaque-origin
+     * sandboxed builds), the SDK asks the embedding page and blocks if nothing
+     * answers within ~5 seconds.
      */
     lockToHost(options?: BBArcadeLockToHostOptions): void;
     /**
@@ -337,12 +390,16 @@ interface BBArcadeSDK {
      * Save the player's progress (a string blob, ~1MB max) to their Bounty Board
      * account. Requires a Bounty-Board-hosted build upload and a logged-in
      * player; rejects with a BBArcadeError otherwise (code 'unsupported' /
-     * 'unauthenticated' / 'too_large' / 'rejected' / 'error').
+     * 'unauthenticated' / 'too_large' / 'rejected' / 'error'). Oversized blobs
+     * reject 'too_large' immediately (client-side precheck against the same 1
+     * MiB cap the server enforces); a host that never answers rejects 'error'
+     * after a 15s request timeout.
      */
     save(blob: string): Promise<void>;
     /**
      * Load the player's saved blob. Resolves with the string, or null when there
-     * is no save yet. Rejects like save() ('unauthenticated' when logged out).
+     * is no save yet. Rejects like save() ('unauthenticated' when logged out,
+     * 'error' after the same 15s request timeout when no host answers).
      */
     load(): Promise<string | null>;
     /**
@@ -353,6 +410,15 @@ interface BBArcadeSDK {
      * display name + avatar only, never ids, emails, or roles.
      */
     getPlayer(): Promise<BBArcadePlayer | null>;
+    /**
+     * Subscribe to CHANGES in the player's display identity (e.g. the player
+     * logs in or out mid-session and the host pushes a fresh config). The
+     * handler runs only when the identity actually changes — subscribing does
+     * not replay the current value; call getPlayer() for that. Receives the
+     * same { name, avatarUrl } | null shape as getPlayer(). Returns an
+     * unsubscribe function.
+     */
+    onPlayerChange(handler: (player: BBArcadePlayer | null) => void): () => void;
     /**
      * Deterministic A/B variant for this player (even split; stable per
      * player+game+key). Resolves the alphabetically-first variant as the

package/dist/{types-BKChtV3H.d.ts → types-dtsNXYZW.d.ts}

@@ -22,6 +22,8 @@ type BBArcadeErrorCode =
 /** Rejection reason for save()/load(): a real Error that also carries `code`. */
 interface BBArcadeError extends Error {
     code: BBArcadeErrorCode;
+    /** Optional server detail for 'rejected' errors (e.g. 'room_full'). */
+    detail?: string;
 }
 /** Rewarded-ads settings accepted by init()/configure(). */
 interface BBArcadeRewardedAdsConfig {
@@ -73,7 +75,17 @@ interface BBArcadeLockToHostOptions {
     redirect?: string;
 }
 /** Outcome of a rewarded placement. */
-type BBArcadeRewardedAdStatus = 'viewed' | 'dismissed' | 'ready' | 'unavailable' | 'error';
+type BBArcadeRewardedAdStatus = 
+/** The player watched the ad to completion — the only status that grants. */
+'viewed'
+/** The player closed the ad early, or a prepared ad ended before it was ever shown. */
+ | 'dismissed'
+/** An ad is ready to show (preparation result; terminal only in the legacy shown-but-unreported edge). */
+ | 'ready'
+/** No ad could be offered. */
+ | 'unavailable'
+/** The placement failed. */
+ | 'error';
 /** Resolution value of rewardedAd()/showRewardedAd(). */
 interface BBArcadeRewardedAdResult {
     /** 'viewed' is the only status that should grant the reward. */
@@ -196,6 +208,22 @@ interface BBArcadeMpJoinOptions {
     code?: string;
     /** Create a new room (a share code is generated for you). */
     create?: boolean;
+    /**
+     * Public quick match: join your game's open public room, or start a fresh
+     * one when no seat is free. Mutually exclusive with code/create. Rooms fill
+     * to the game's player cap (at most 64), and a matched room still exposes
+     * room.code so the player can invite friends into the same room. If the
+     * last free seat is lost to a race, the SDK re-matchmakes automatically a
+     * couple of times before rejecting.
+     */
+    match?: boolean;
+    /**
+     * Game-defined, JSON-serializable data supplied to the authoritative module
+     * before it admits this player (avatar/loadout/mode selections, for example).
+     * The room server treats this as untrusted input and limits it to 1 KiB.
+     * Never put credentials or other secrets here.
+     */
+    joinData?: Readonly<Record<string, unknown>>;
     /**
      * Local development only: connect straight to a room server (e.g. wrangler
      * dev with DEV_ALLOW_UNSIGNED=1) instead of asking the Bounty Board host for
@@ -203,6 +231,12 @@ interface BBArcadeMpJoinOptions {
      */
     roomUrl?: string;
     ticket?: string;
+    /**
+     * How long to wait for the room server's welcome before the join rejects
+     * with code 'error', in ms (default 10000, clamped to 1000–60000). Applies
+     * to the initial join and to every automatic reconnect attempt.
+     */
+    timeoutMs?: number;
 }
 /** Events a multiplayer room emits. */
 interface BBArcadeMpRoomEvents {
@@ -226,6 +260,11 @@ interface BBArcadeMpRoomEvents {
     error: {
         code: string;
     };
+    /** Connection state, including successful automatic reconnection. */
+    connection: {
+        connected: boolean;
+        reconnecting: boolean;
+    };
     /** Connection dropped. reconnecting: true means the SDK is retrying. */
     close: {
         reconnecting: boolean;
@@ -241,8 +280,19 @@ interface BBArcadeMpRoom {
     players: BBArcadeMpPlayer[];
     /** Latest authoritative state snapshot (as filtered for you). */
     state: unknown;
+    /** Whether the room currently has an accepted WebSocket connection. */
+    connected: boolean;
+    /**
+     * Join-handshake latency in ms (socket open → server welcome, so ticket
+     * verification plus one round trip), refreshed on every successful
+     * (re)connect; null until the first welcome arrives. A tuning estimate for
+     * render-side smoothing, not a measured RTT.
+     */
+    latencyMs: number | null;
     /** Send an INPUT to the server (never authoritative state — the server simulates). */
     send(input: unknown): void;
+    /** Like send(), but reports false when disconnected or the socket raced closed. */
+    trySend(input: unknown): boolean;
     /** Subscribe to a room event; returns an unsubscribe function. */
     on<K extends keyof BBArcadeMpRoomEvents>(event: K, handler: (data: BBArcadeMpRoomEvents[K]) => void): () => void;
     /** Leave the room and close the connection (no reconnect). */
@@ -270,6 +320,9 @@ interface BBArcadeSDK {
     /**
      * Refuse to run unless embedded on a Bounty Board host (anti
      * scrape-and-reupload deterrent — not DRM). Call once, early, before boot.
+     * When the embedder can't be determined from browser signals (opaque-origin
+     * sandboxed builds), the SDK asks the embedding page and blocks if nothing
+     * answers within ~5 seconds.
      */
     lockToHost(options?: BBArcadeLockToHostOptions): void;
     /**
@@ -337,12 +390,16 @@ interface BBArcadeSDK {
      * Save the player's progress (a string blob, ~1MB max) to their Bounty Board
      * account. Requires a Bounty-Board-hosted build upload and a logged-in
      * player; rejects with a BBArcadeError otherwise (code 'unsupported' /
-     * 'unauthenticated' / 'too_large' / 'rejected' / 'error').
+     * 'unauthenticated' / 'too_large' / 'rejected' / 'error'). Oversized blobs
+     * reject 'too_large' immediately (client-side precheck against the same 1
+     * MiB cap the server enforces); a host that never answers rejects 'error'
+     * after a 15s request timeout.
      */
     save(blob: string): Promise<void>;
     /**
      * Load the player's saved blob. Resolves with the string, or null when there
-     * is no save yet. Rejects like save() ('unauthenticated' when logged out).
+     * is no save yet. Rejects like save() ('unauthenticated' when logged out,
+     * 'error' after the same 15s request timeout when no host answers).
      */
     load(): Promise<string | null>;
     /**
@@ -353,6 +410,15 @@ interface BBArcadeSDK {
      * display name + avatar only, never ids, emails, or roles.
      */
     getPlayer(): Promise<BBArcadePlayer | null>;
+    /**
+     * Subscribe to CHANGES in the player's display identity (e.g. the player
+     * logs in or out mid-session and the host pushes a fresh config). The
+     * handler runs only when the identity actually changes — subscribing does
+     * not replay the current value; call getPlayer() for that. Receives the
+     * same { name, avatarUrl } | null shape as getPlayer(). Returns an
+     * unsubscribe function.
+     */
+    onPlayerChange(handler: (player: BBArcadePlayer | null) => void): () => void;
     /**
      * Deterministic A/B variant for this player (even split; stable per
      * player+game+key). Resolves the alphabetically-first variant as the