@remix-gg/sdk 0.8.0 → 0.8.2

package/dist/index.js

@@ -1,120 +1,67 @@
-(() => {
-  var __defProp = Object.defineProperty;
-  var __getOwnPropNames = Object.getOwnPropertyNames;
-  var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-  var __hasOwnProp = Object.prototype.hasOwnProperty;
-  var __moduleCache = /* @__PURE__ */ new WeakMap;
-  var __toCommonJS = (from) => {
-    var entry = __moduleCache.get(from), desc;
-    if (entry)
-      return entry;
-    entry = __defProp({}, "__esModule", { value: true });
-    if (from && typeof from === "object" || typeof from === "function")
-      __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-        get: () => from[key],
-        enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-      }));
-    __moduleCache.set(from, entry);
-    return entry;
-  };
-  var __export = (target, all) => {
-    for (var name in all)
-      __defProp(target, name, {
-        get: all[name],
-        enumerable: true,
-        configurable: true,
-        set: (newValue) => all[name] = () => newValue
-      });
-  };
-
-  // src/index.ts
-  var exports_src = {};
-  __export(exports_src, {
-    sdk: () => sdk,
-    ZERO_SAFE_AREA_INSET: () => ZERO_SAFE_AREA_INSET,
-    RemixSDK: () => RemixSDK
-  });
-  var ZERO_SAFE_AREA_INSET = {
-    top: 0,
-    right: 0,
-    bottom: 0,
-    left: 0
-  };
-
-  class RemixSDK {
-    isClient;
-    target = null;
-    eventListeners = new Map;
-    readyPromiseResolve = null;
-    purchasePromiseResolve = null;
-    _gameInfo;
-    _gameState;
-    constructor() {
-      this.isClient = typeof window !== "undefined";
-      this.target = this.isClient ? window.parent : null;
-      if (this.isClient) {
-        window.addEventListener("message", this.handleMessage);
-        window.addEventListener("error", this.handleGlobalError);
-        window.addEventListener("unhandledrejection", this.handleUnhandledRejection);
-        this.sendMessage("ready", undefined);
-      }
-    }
-    on(eventType, callback) {
-      if (!this.eventListeners.has(eventType)) {
-        this.eventListeners.set(eventType, new Set);
-      }
-      this.eventListeners.get(eventType)?.add(callback);
-    }
-    off(eventType, callback) {
-      this.eventListeners.get(eventType)?.delete(callback);
-    }
-    onPlayAgain(callback) {
-      this.on("play_again", () => callback());
-    }
-    onToggleMute(callback) {
-      this.on("toggle_mute", (data) => callback(data));
-    }
-    onGameStateUpdated(callback) {
-      this.on("game_state_updated", (data) => callback(data));
-    }
-    onGameInfo(callback) {
-      this.on("game_info", (data) => callback(data));
-    }
-    onPurchaseComplete(callback) {
-      this.on("purchase_complete", (data) => callback(data));
-    }
-    setTarget(target) {
-      this.target = target;
-    }
-    get purchasedItems() {
-      return this._gameInfo?.player.purchasedItems || [];
-    }
-    get inventory() {
-      const counts = new Map;
-      for (const item of this.purchasedItems) {
-        counts.set(item, (counts.get(item) || 0) + 1);
-      }
-      return [...counts.entries()].map(([slug, quantity]) => ({ slug, quantity }));
-    }
-    get shopItems() {
-      return this._gameInfo?.shopItems || [];
-    }
-    get gameInfo() {
-      return this._gameInfo;
-    }
-    get gameState() {
-      return this._gameState;
-    }
-    get players() {
-      return this._gameInfo?.players;
+"use strict";
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
     }
-    get player() {
-      return this._gameInfo?.player;
-    }
-    get isReady() {
-      return !!this._gameInfo;
-    }
-    ready = () => {
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  RemixSDK: () => RemixSDK,
+  ZERO_SAFE_AREA_INSET: () => ZERO_SAFE_AREA_INSET,
+  sdk: () => sdk
+});
+module.exports = __toCommonJS(src_exports);
+var ZERO_SAFE_AREA_INSET = {
+  top: 0,
+  right: 0,
+  bottom: 0,
+  left: 0
+};
+var SDK_VERSION = true ? "0.8.2" : UNKNOWN_SDK_VERSION;
+var RemixSDK = class {
+  constructor() {
+    /**
+     * The published version of this bundle. The host compares it against the
+     * version it asked the browser to load, so a cached bundle from a previous
+     * release can be detected before any game code runs.
+     */
+    this.version = SDK_VERSION;
+    this.target = null;
+    this.eventListeners = /* @__PURE__ */ new Map();
+    this.readyPromiseResolve = null;
+    this.purchasePromiseResolve = null;
+    this.ready = () => {
       if (this._gameInfo) {
         return Promise.resolve(this._gameInfo);
       }
@@ -122,29 +69,29 @@
         this.readyPromiseResolve = resolve;
       });
     };
-    purchase = (data) => {
+    this.purchase = (data) => {
       this.sendMessage("purchase", data);
       return new Promise((resolve) => {
         this.purchasePromiseResolve = resolve;
       });
     };
-    reportError = (data) => {
+    this.reportError = (data) => {
       this.sendMessage("error", data);
     };
-    hapticFeedback = (type) => {
-      this.sendMessage("haptic_feedback", type ? { type } : undefined);
+    this.hapticFeedback = (type) => {
+      this.sendMessage("haptic_feedback", type ? { type } : void 0);
     };
-    hasItem = (item) => {
+    this.hasItem = (item) => {
       return this.getItemPurchaseCount(item) > 0;
     };
-    getItemPurchaseCount = (item) => {
+    this.getItemPurchaseCount = (item) => {
       const inventoryItem = this.inventory.find((entry) => entry.slug === item);
-      return inventoryItem?.quantity || 0;
+      return (inventoryItem == null ? void 0 : inventoryItem.quantity) || 0;
     };
-    getShopItem = (slug) => {
+    this.getShopItem = (slug) => {
       return this.shopItems.find((item) => item.slug === slug);
     };
-    singlePlayer = {
+    this.singlePlayer = {
       actions: {
         ready: this.ready,
         hapticFeedback: this.hapticFeedback,
@@ -158,9 +105,8 @@
         }
       }
     };
-    multiplayer = {
-      actions: {
-        ...this.singlePlayer.actions,
+    this.multiplayer = {
+      actions: __spreadProps(__spreadValues({}, this.singlePlayer.actions), {
         gameOver: (data) => {
           this.sendMessage("multiplayer_game_over", data);
         },
@@ -170,54 +116,21 @@
         saveGameState: (data) => {
           this.sendMessage("multiplayer_save_game_state", data);
         }
-      }
+      })
     };
-    emit(eventType, data) {
-      if (eventType === "game_info") {
-        const eventData = data;
-        this._gameInfo = eventData;
-        if (!this._gameState && eventData.initialGameState) {
-          this._gameState = eventData.initialGameState.gameState;
-        }
-        if (this.readyPromiseResolve) {
-          this.readyPromiseResolve(this._gameInfo);
-          this.readyPromiseResolve = null;
-        }
-      }
-      if (eventType === "purchase_complete") {
-        const eventData = data;
-        if (eventData.success && eventData.item && this._gameInfo?.player) {
-          this.applyPurchaseToCurrentPlayer(eventData.item);
-        }
-        if (this.purchasePromiseResolve) {
-          this.purchasePromiseResolve(eventData);
-          this.purchasePromiseResolve = null;
-        }
-      }
-      if (eventType === "game_state_updated") {
-        const eventData = data;
-        if (eventData) {
-          this._gameState = eventData.gameState;
-        } else {
-          this._gameState = null;
-        }
-      }
-      for (const callback of this.eventListeners.get(eventType) || []) {
-        callback(data);
-      }
-    }
-    handleMessage = (event) => {
-      if (event.data?.type !== "game_event")
+    this.handleMessage = (event) => {
+      var _a;
+      if (((_a = event.data) == null ? void 0 : _a.type) !== "game_event")
         return;
       this.emit(event.data.event.type, event.data.event.data);
     };
-    sendMessage = (type, data) => {
+    this.sendMessage = (type, data) => {
       if (!this.isClient || !this.target)
         return;
       const gameEvent = { type: "game_event", event: { type, data } };
       this.target.postMessage(gameEvent, "*");
     };
-    handleGlobalError = (event) => {
+    this.handleGlobalError = (event) => {
       this.sendMessage("error", {
         message: event.message || "Unknown error",
         source: event.filename,
@@ -226,33 +139,192 @@
         error: event.error
       });
     };
-    handleUnhandledRejection = (event) => {
+    this.handleUnhandledRejection = (event) => {
       const error = event.reason instanceof Error ? event.reason : new Error(String(event.reason));
       this.sendMessage("error", {
         message: error.message,
         error
       });
     };
-    applyPurchaseToCurrentPlayer(item) {
-      if (!this._gameInfo)
-        return;
-      const currentPlayer = this._gameInfo.player;
-      currentPlayer.purchasedItems = [...currentPlayer.purchasedItems, item];
-      this._gameInfo.players = this._gameInfo.players.map((player) => {
-        if (player.id !== currentPlayer.id)
-          return player;
-        return {
-          ...player,
-          purchasedItems: currentPlayer.purchasedItems
-        };
-      });
+    this.isClient = typeof window !== "undefined";
+    this.target = this.isClient ? window.parent : null;
+    if (this.isClient) {
+      window.addEventListener("message", this.handleMessage);
+      window.addEventListener("error", this.handleGlobalError);
+      window.addEventListener("unhandledrejection", this.handleUnhandledRejection);
+      this.sendMessage("ready", void 0);
     }
   }
-  var sdk = new RemixSDK;
-  if (typeof window !== "undefined") {
-    window.FarcadeSDK = sdk;
-    window.RemixSDK = sdk;
+  on(eventType, callback) {
+    var _a;
+    if (!this.eventListeners.has(eventType)) {
+      this.eventListeners.set(eventType, /* @__PURE__ */ new Set());
+    }
+    (_a = this.eventListeners.get(eventType)) == null ? void 0 : _a.add(callback);
   }
-})();
-
-//# debugId=5DCD609576A0948564756E2164756E21
+  off(eventType, callback) {
+    var _a;
+    (_a = this.eventListeners.get(eventType)) == null ? void 0 : _a.delete(callback);
+  }
+  // explicitly named event listeners for better understanding and type safety
+  /**
+   * Listen for the host starting play: a replay after game over, or — for level
+   * games — a host-directed level via `data.levelIndex`. `data` may be omitted
+   * for a plain restart.
+   */
+  onPlay(callback) {
+    this.on("play_again", (data) => callback(data));
+  }
+  /** Alias of {@link onPlay}. */
+  onPlayAgain(callback) {
+    this.onPlay(callback);
+  }
+  onToggleMute(callback) {
+    this.on("toggle_mute", (data) => callback(data));
+  }
+  onGameStateUpdated(callback) {
+    this.on("game_state_updated", (data) => callback(data));
+  }
+  onGameInfo(callback) {
+    this.on("game_info", (data) => callback(data));
+  }
+  onPurchaseComplete(callback) {
+    this.on("purchase_complete", (data) => callback(data));
+  }
+  // end of explicitly named event listeners
+  setTarget(target) {
+    this.target = target;
+  }
+  get purchasedItems() {
+    var _a;
+    return ((_a = this._gameInfo) == null ? void 0 : _a.player.purchasedItems) || [];
+  }
+  get inventory() {
+    const counts = /* @__PURE__ */ new Map();
+    for (const item of this.purchasedItems) {
+      counts.set(item, (counts.get(item) || 0) + 1);
+    }
+    return [...counts.entries()].map(([slug, quantity]) => ({ slug, quantity }));
+  }
+  get shopItems() {
+    var _a;
+    return ((_a = this._gameInfo) == null ? void 0 : _a.shopItems) || [];
+  }
+  get gameInfo() {
+    return this._gameInfo;
+  }
+  get gameState() {
+    return this._gameState;
+  }
+  get players() {
+    var _a;
+    return (_a = this._gameInfo) == null ? void 0 : _a.players;
+  }
+  get player() {
+    var _a;
+    return (_a = this._gameInfo) == null ? void 0 : _a.player;
+  }
+  get isReady() {
+    return !!this._gameInfo;
+  }
+  /** True when the host configured this game with a fixed level count. */
+  get isLevelBased() {
+    var _a, _b;
+    const levelCount = (_b = (_a = this._gameInfo) == null ? void 0 : _a.levelBased) == null ? void 0 : _b.levelCount;
+    return levelCount != null && levelCount > 0;
+  }
+  /** Total levels for level-based games (from host metadata). */
+  get levelCount() {
+    var _a, _b;
+    const levelCount = (_b = (_a = this._gameInfo) == null ? void 0 : _a.levelBased) == null ? void 0 : _b.levelCount;
+    return levelCount != null && levelCount > 0 ? levelCount : void 0;
+  }
+  /** 1-based level index from score-derived progression, defaulting to 1. */
+  get currentLevelIndex() {
+    var _a, _b, _c;
+    const value = (_c = (_b = (_a = this._gameInfo) == null ? void 0 : _a.levelBased) == null ? void 0 : _b.progress) == null ? void 0 : _c.currentLevelIndex;
+    return typeof value === "number" && Number.isFinite(value) && value >= 1 ? value : 1;
+  }
+  /** Best stars per level from score-derived progression. Keys are 1-based level indices. */
+  get levelStars() {
+    var _a, _b, _c;
+    const raw = (_c = (_b = (_a = this._gameInfo) == null ? void 0 : _a.levelBased) == null ? void 0 : _b.progress) == null ? void 0 : _c.levelStars;
+    const levelStars = {};
+    if (raw && typeof raw === "object" && !Array.isArray(raw)) {
+      for (const [key, starValue] of Object.entries(raw)) {
+        if (starValue === 1 || starValue === 2 || starValue === 3)
+          levelStars[key] = starValue;
+      }
+    }
+    return levelStars;
+  }
+  /** Highest unlocked level from score-derived progression, defaulting to 1. */
+  get highestUnlockedLevel() {
+    var _a, _b, _c;
+    const value = (_c = (_b = (_a = this._gameInfo) == null ? void 0 : _a.levelBased) == null ? void 0 : _b.progress) == null ? void 0 : _c.highestUnlockedLevel;
+    return typeof value === "number" && Number.isFinite(value) && value >= 1 ? value : 1;
+  }
+  /** Sum of best stars across all completed levels. */
+  get totalStars() {
+    return Object.values(this.levelStars).reduce((sum, stars) => sum + stars, 0);
+  }
+  emit(eventType, data) {
+    var _a;
+    if (eventType === "game_info") {
+      const eventData = data;
+      this._gameInfo = eventData;
+      if (!this._gameState && eventData.initialGameState) {
+        this._gameState = eventData.initialGameState.gameState;
+      }
+      if (this.readyPromiseResolve) {
+        this.readyPromiseResolve(this._gameInfo);
+        this.readyPromiseResolve = null;
+      }
+    }
+    if (eventType === "purchase_complete") {
+      const eventData = data;
+      if (eventData.success && eventData.item && ((_a = this._gameInfo) == null ? void 0 : _a.player)) {
+        this.applyPurchaseToCurrentPlayer(eventData.item);
+      }
+      if (this.purchasePromiseResolve) {
+        this.purchasePromiseResolve(eventData);
+        this.purchasePromiseResolve = null;
+      }
+    }
+    if (eventType === "game_state_updated") {
+      const eventData = data;
+      if (eventData) {
+        this._gameState = eventData.gameState;
+      } else {
+        this._gameState = null;
+      }
+    }
+    for (const callback of this.eventListeners.get(eventType) || []) {
+      callback(data);
+    }
+  }
+  applyPurchaseToCurrentPlayer(item) {
+    if (!this._gameInfo)
+      return;
+    const currentPlayer = this._gameInfo.player;
+    currentPlayer.purchasedItems = [...currentPlayer.purchasedItems, item];
+    this._gameInfo.players = this._gameInfo.players.map((player) => {
+      if (player.id !== currentPlayer.id)
+        return player;
+      return __spreadProps(__spreadValues({}, player), {
+        purchasedItems: currentPlayer.purchasedItems
+      });
+    });
+  }
+};
+var sdk = new RemixSDK();
+if (typeof window !== "undefined") {
+  window.FarcadeSDK = sdk;
+  window.RemixSDK = sdk;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RemixSDK,
+  ZERO_SAFE_AREA_INSET,
+  sdk
+});

package/dist/index.min.js

@@ -40,8 +40,10 @@
     bottom: 0,
     left: 0
   };
+  var SDK_VERSION = "0.8.2";
 
   class RemixSDK {
+    version = SDK_VERSION;
     isClient;
     target = null;
     eventListeners = new Map;
@@ -68,8 +70,11 @@
     off(eventType, callback) {
       this.eventListeners.get(eventType)?.delete(callback);
     }
+    onPlay(callback) {
+      this.on("play_again", (data) => callback(data));
+    }
     onPlayAgain(callback) {
-      this.on("play_again", () => callback());
+      this.onPlay(callback);
     }
     onToggleMute(callback) {
       this.on("toggle_mute", (data) => callback(data));
@@ -114,6 +119,36 @@
     get isReady() {
       return !!this._gameInfo;
     }
+    get isLevelBased() {
+      const levelCount = this._gameInfo?.levelBased?.levelCount;
+      return levelCount != null && levelCount > 0;
+    }
+    get levelCount() {
+      const levelCount = this._gameInfo?.levelBased?.levelCount;
+      return levelCount != null && levelCount > 0 ? levelCount : undefined;
+    }
+    get currentLevelIndex() {
+      const value = this._gameInfo?.levelBased?.progress?.currentLevelIndex;
+      return typeof value === "number" && Number.isFinite(value) && value >= 1 ? value : 1;
+    }
+    get levelStars() {
+      const raw = this._gameInfo?.levelBased?.progress?.levelStars;
+      const levelStars = {};
+      if (raw && typeof raw === "object" && !Array.isArray(raw)) {
+        for (const [key, starValue] of Object.entries(raw)) {
+          if (starValue === 1 || starValue === 2 || starValue === 3)
+            levelStars[key] = starValue;
+        }
+      }
+      return levelStars;
+    }
+    get highestUnlockedLevel() {
+      const value = this._gameInfo?.levelBased?.progress?.highestUnlockedLevel;
+      return typeof value === "number" && Number.isFinite(value) && value >= 1 ? value : 1;
+    }
+    get totalStars() {
+      return Object.values(this.levelStars).reduce((sum, stars) => sum + stars, 0);
+    }
     ready = () => {
       if (this._gameInfo) {
         return Promise.resolve(this._gameInfo);
@@ -255,4 +290,4 @@
   }
 })();
 
-//# debugId=5C4052FCC20A9CB164756E2164756E21
+//# debugId=806FC7E16EA1A87164756E2164756E21