@oasiz/sdk 1.5.3 → 1.5.5

package/dist/index.js

@@ -1,4 +1,4 @@
-// src/haptics.ts
+// src/character.ts
 function isDevelopment() {
   const nodeEnv = globalThis.process?.env?.NODE_ENV;
   return nodeEnv !== "production";
@@ -9,13 +9,48 @@ function getBridgeWindow() {
   }
   return window;
 }
-function triggerHaptic(type) {
+function warnMissingBridge(methodName) {
+  if (isDevelopment()) {
+    console.warn(
+      "[oasiz/sdk] " + methodName + " bridge is unavailable. This is expected in local development."
+    );
+  }
+}
+async function getPlayerCharacter() {
   const bridge = getBridgeWindow();
+  if (typeof bridge?.__oasizGetPlayerCharacter !== "function") {
+    warnMissingBridge("getPlayerCharacter");
+    return null;
+  }
+  try {
+    const result = await bridge.__oasizGetPlayerCharacter();
+    return result ?? null;
+  } catch (error) {
+    if (isDevelopment()) {
+      console.error("[oasiz/sdk] getPlayerCharacter failed:", error);
+    }
+    return null;
+  }
+}
+
+// src/haptics.ts
+function isDevelopment2() {
+  const nodeEnv = globalThis.process?.env?.NODE_ENV;
+  return nodeEnv !== "production";
+}
+function getBridgeWindow2() {
+  if (typeof window === "undefined") {
+    return void 0;
+  }
+  return window;
+}
+function triggerHaptic(type) {
+  const bridge = getBridgeWindow2();
   if (typeof bridge?.triggerHaptic === "function") {
     bridge.triggerHaptic(type);
     return;
   }
-  if (isDevelopment()) {
+  if (isDevelopment2()) {
     console.warn(
       "[oasiz/sdk] triggerHaptic bridge is unavailable. This is expected in local development."
     );
@@ -914,70 +949,74 @@ function enableLogOverlay(options = {}) {
 }
 
 // src/multiplayer.ts
-function isDevelopment2() {
+function isDevelopment3() {
   const nodeEnv = globalThis.process?.env?.NODE_ENV;
   return nodeEnv !== "production";
 }
-function getBridgeWindow2() {
+function getBridgeWindow3() {
   if (typeof window === "undefined") {
     return void 0;
   }
   return window;
 }
 function shareRoomCode(roomCode, options) {
-  const bridge = getBridgeWindow2();
+  const bridge = getBridgeWindow3();
   if (typeof bridge?.shareRoomCode === "function") {
     bridge.shareRoomCode(roomCode, options);
     return;
   }
-  if (isDevelopment2()) {
+  if (isDevelopment3()) {
     console.warn(
       "[oasiz/sdk] shareRoomCode bridge is unavailable. This is expected in local development."
     );
   }
 }
 function openInviteModal() {
-  const bridge = getBridgeWindow2();
+  const bridge = getBridgeWindow3();
   if (typeof bridge?.openInviteModal === "function") {
     bridge.openInviteModal();
     return;
   }
-  if (isDevelopment2()) {
+  if (isDevelopment3()) {
     console.warn(
       "[oasiz/sdk] openInviteModal bridge is unavailable. This is expected in local development."
     );
   }
 }
 function getGameId() {
-  const bridge = getBridgeWindow2();
+  const bridge = getBridgeWindow3();
   return bridge?.__GAME_ID__;
 }
 function getRoomCode() {
-  const bridge = getBridgeWindow2();
+  const bridge = getBridgeWindow3();
   return bridge?.__ROOM_CODE__;
 }
+function getPlayerId() {
+  const bridge = getBridgeWindow3();
+  return bridge?.__PLAYER_ID__;
+}
 function getPlayerName() {
-  const bridge = getBridgeWindow2();
+  const bridge = getBridgeWindow3();
   return bridge?.__PLAYER_NAME__;
 }
 function getPlayerAvatar() {
-  const bridge = getBridgeWindow2();
+  const bridge = getBridgeWindow3();
   return bridge?.__PLAYER_AVATAR__;
 }
 
 // src/score.ts
-function isDevelopment3() {
+function isDevelopment4() {
   const nodeEnv = globalThis.process?.env?.NODE_ENV;
   return nodeEnv !== "production";
 }
-function warnMissingBridge(methodName) {
-  if (isDevelopment3()) {
+function warnMissingBridge2(methodName) {
+  if (isDevelopment4()) {
     console.warn(
       "[oasiz/sdk] " + methodName + " bridge is unavailable. This is expected in local development."
     );
   }
 }
-function getBridgeWindow3() {
+function getBridgeWindow4() {
   if (typeof window === "undefined") {
     return void 0;
   }
@@ -985,33 +1024,92 @@ function getBridgeWindow3() {
 }
 function submitScore(score) {
   if (!Number.isFinite(score)) {
-    if (isDevelopment3()) {
+    if (isDevelopment4()) {
       console.warn("[oasiz/sdk] submitScore expected a finite number:", score);
     }
     return;
   }
-  const bridge = getBridgeWindow3();
+  const bridge = getBridgeWindow4();
   const normalizedScore = Math.max(0, Math.floor(score));
   if (typeof bridge?.submitScore === "function") {
     bridge.submitScore(normalizedScore);
     return;
   }
-  warnMissingBridge("submitScore");
+  warnMissingBridge2("submitScore");
+}
+
+// src/score-edit.ts
+function isDevelopment5() {
+  const nodeEnv = globalThis.process?.env?.NODE_ENV;
+  return nodeEnv !== "production";
+}
+function getBridgeWindow5() {
+  if (typeof window === "undefined") {
+    return void 0;
+  }
+  return window;
+}
+function warnMissingBridge3(methodName) {
+  if (isDevelopment5()) {
+    console.warn(
+      "[oasiz/sdk] " + methodName + " bridge is unavailable. This is expected in local development."
+    );
+  }
+}
+async function editScore(payload, methodName) {
+  const bridge = getBridgeWindow5();
+  if (typeof bridge?.__oasizEditScore !== "function") {
+    warnMissingBridge3(methodName);
+    return null;
+  }
+  try {
+    const result = await bridge.__oasizEditScore(payload);
+    return result ?? null;
+  } catch (error) {
+    if (isDevelopment5()) {
+      console.error("[oasiz/sdk] " + methodName + " failed:", error);
+    }
+    return null;
+  }
+}
+async function addScore(delta) {
+  if (!Number.isInteger(delta)) {
+    if (isDevelopment5()) {
+      console.warn("[oasiz/sdk] addScore expected an integer:", delta);
+    }
+    return null;
+  }
+  if (delta === 0) {
+    return null;
+  }
+  return editScore({ delta }, "addScore");
+}
+async function setScore(score) {
+  if (!Number.isInteger(score) || score < 0) {
+    if (isDevelopment5()) {
+      console.warn(
+        "[oasiz/sdk] setScore expected a non-negative integer:",
+        score
+      );
+    }
+    return null;
+  }
+  return editScore({ score }, "setScore");
 }
 
 // src/share.ts
-function isDevelopment4() {
+function isDevelopment6() {
   const nodeEnv = globalThis.process?.env?.NODE_ENV;
   return nodeEnv !== "production";
 }
-function getBridgeWindow4() {
+function getBridgeWindow6() {
   if (typeof window === "undefined") {
     return void 0;
   }
   return window;
 }
-function warnMissingBridge2(methodName) {
-  if (isDevelopment4()) {
+function warnMissingBridge4(methodName) {
+  if (isDevelopment6()) {
     console.warn(
       "[oasiz/sdk] " + methodName + " share bridge is unavailable. This is expected in local development."
     );
@@ -1054,20 +1152,20 @@ function validateRequest(options) {
 }
 async function share(options) {
   const request = validateRequest(options);
-  const bridge = getBridgeWindow4();
+  const bridge = getBridgeWindow6();
   if (typeof bridge?.__oasizShareRequest !== "function") {
-    warnMissingBridge2("__oasizShareRequest");
+    warnMissingBridge4("__oasizShareRequest");
     throw new Error("Share bridge unavailable");
   }
   await bridge.__oasizShareRequest(request);
 }
 
 // src/state.ts
-function isDevelopment5() {
+function isDevelopment7() {
   const nodeEnv = globalThis.process?.env?.NODE_ENV;
   return nodeEnv !== "production";
 }
-function getBridgeWindow5() {
+function getBridgeWindow7() {
   if (typeof window === "undefined") {
     return void 0;
   }
@@ -1080,22 +1178,22 @@ function isPlainObject(value) {
   const proto = Object.getPrototypeOf(value);
   return proto === Object.prototype || proto === null;
 }
-function warnMissingBridge3(methodName) {
-  if (isDevelopment5()) {
+function warnMissingBridge5(methodName) {
+  if (isDevelopment7()) {
     console.warn(
       "[oasiz/sdk] " + methodName + " bridge is unavailable. This is expected in local development."
     );
   }
 }
 function loadGameState() {
-  const bridge = getBridgeWindow5();
+  const bridge = getBridgeWindow7();
   if (typeof bridge?.loadGameState !== "function") {
-    warnMissingBridge3("loadGameState");
+    warnMissingBridge5("loadGameState");
     return {};
   }
   const state = bridge.loadGameState();
   if (!isPlainObject(state)) {
-    if (isDevelopment5()) {
+    if (isDevelopment7()) {
       console.warn(
         "[oasiz/sdk] loadGameState returned invalid data. Falling back to empty object."
       );
@@ -1106,35 +1204,35 @@ function loadGameState() {
 }
 function saveGameState(state) {
   if (!isPlainObject(state)) {
-    if (isDevelopment5()) {
+    if (isDevelopment7()) {
       console.warn("[oasiz/sdk] saveGameState expected a plain object:", state);
     }
     return;
   }
-  const bridge = getBridgeWindow5();
+  const bridge = getBridgeWindow7();
   if (typeof bridge?.saveGameState === "function") {
     bridge.saveGameState(state);
     return;
   }
-  warnMissingBridge3("saveGameState");
+  warnMissingBridge5("saveGameState");
 }
 function flushGameState() {
-  const bridge = getBridgeWindow5();
+  const bridge = getBridgeWindow7();
   if (typeof bridge?.flushGameState === "function") {
     bridge.flushGameState();
     return;
   }
-  warnMissingBridge3("flushGameState");
+  warnMissingBridge5("flushGameState");
 }
 
 // src/lifecycle.ts
-function isDevelopment6() {
+function isDevelopment8() {
   const nodeEnv = globalThis.process?.env?.NODE_ENV;
   return nodeEnv !== "production";
 }
 function addLifecycleListener(eventName, callback) {
   if (typeof window === "undefined") {
-    if (isDevelopment6()) {
+    if (isDevelopment8()) {
       console.warn(
         "[oasiz/sdk] " + eventName + " listener registered without a browser window. This is expected in local development."
       );
@@ -1154,74 +1252,187 @@ function onResume(callback) {
 }
 
 // src/layout.ts
-function isDevelopment7() {
+function isDevelopment9() {
   const nodeEnv = globalThis.process?.env?.NODE_ENV;
   return nodeEnv !== "production";
 }
-function getBridgeWindow6() {
+function getBridgeWindow8() {
   if (typeof window === "undefined") {
     return void 0;
   }
   return window;
 }
-function warnMissingBridge4(methodName) {
-  if (isDevelopment7()) {
+function warnMissingBridge6(methodName) {
+  if (isDevelopment9()) {
     console.warn(
       "[oasiz/sdk] " + methodName + " bridge is unavailable. This is expected in local development."
     );
   }
 }
-function normalizeSafeAreaTopPixels(value) {
+function toFiniteNumber(value) {
   if (typeof value !== "number" || !Number.isFinite(value)) {
+    if (typeof value !== "string") {
+      return void 0;
+    }
+    const parsed = Number.parseFloat(value.trim());
+    if (!Number.isFinite(parsed)) {
+      return void 0;
+    }
+    return parsed;
+  }
+  return value;
+}
+function clampSafeAreaTopPixels(value) {
+  const numeric = toFiniteNumber(value);
+  if (typeof numeric === "undefined") {
     return 0;
   }
-  return Math.max(0, value);
+  return Math.max(0, numeric);
 }
 function normalizeSafeAreaTopPercent(value) {
-  if (typeof value !== "number" || !Number.isFinite(value)) {
-    return 0;
+  const numeric = toFiniteNumber(value);
+  if (typeof numeric === "undefined") {
+    return void 0;
   }
-  return Math.min(100, Math.max(0, value));
+  return Math.min(100, Math.max(0, numeric));
+}
+function getViewportHeight(bridge) {
+  const visualViewportHeight = bridge.visualViewport?.height;
+  if (typeof visualViewportHeight === "number" && Number.isFinite(visualViewportHeight) && visualViewportHeight > 0) {
+    return visualViewportHeight;
+  }
+  const innerHeight = bridge.innerHeight;
+  if (typeof innerHeight === "number" && Number.isFinite(innerHeight) && innerHeight > 0) {
+    return innerHeight;
+  }
+  const documentHeight = bridge.document?.documentElement?.clientHeight;
+  if (typeof documentHeight === "number" && Number.isFinite(documentHeight) && documentHeight > 0) {
+    return documentHeight;
+  }
+  const bodyHeight = bridge.document?.body?.clientHeight;
+  if (typeof bodyHeight === "number" && Number.isFinite(bodyHeight) && bodyHeight > 0) {
+    return bodyHeight;
+  }
+  return 0;
 }
-function viewportInnerHeight(bridge) {
-  const h = bridge.innerHeight;
-  if (typeof h !== "number" || !Number.isFinite(h) || h <= 0) {
+function readCssSafeAreaValue(bridge, cssValue) {
+  const doc = bridge.document;
+  const root = doc?.body ?? doc?.documentElement;
+  if (!doc || !root || typeof doc.createElement !== "function" || typeof root.appendChild !== "function" || typeof bridge.getComputedStyle !== "function") {
     return 0;
   }
-  return h;
+  const probe = doc.createElement("div");
+  probe.style.position = "fixed";
+  probe.style.top = "0";
+  probe.style.left = "0";
+  probe.style.width = "0";
+  probe.style.height = "0";
+  probe.style.visibility = "hidden";
+  probe.style.pointerEvents = "none";
+  probe.style.paddingTop = cssValue;
+  root.appendChild(probe);
+  try {
+    return clampSafeAreaTopPixels(bridge.getComputedStyle(probe).paddingTop);
+  } finally {
+    if (typeof probe.remove === "function") {
+      probe.remove();
+    } else {
+      probe.parentNode?.removeChild(probe);
+    }
+  }
+}
+function readCssSafeAreaTopPixels(bridge) {
+  const envPixels = readCssSafeAreaValue(bridge, "env(safe-area-inset-top)");
+  if (envPixels > 0) {
+    return envPixels;
+  }
+  return readCssSafeAreaValue(bridge, "constant(safe-area-inset-top)");
+}
+function getDevicePixelRatio(bridge) {
+  const dpr = bridge.devicePixelRatio;
+  if (typeof dpr !== "number" || !Number.isFinite(dpr) || dpr <= 0) {
+    return 1;
+  }
+  return dpr;
+}
+function roughlyEqualPixels(a, b) {
+  return Math.abs(a - b) <= 2;
+}
+function normalizeSafeAreaTopPixels(value, bridge) {
+  const pixels = clampSafeAreaTopPixels(value);
+  const cssEnvPixels = readCssSafeAreaTopPixels(bridge);
+  if (pixels <= 0) {
+    return cssEnvPixels;
+  }
+  const dpr = getDevicePixelRatio(bridge);
+  if (cssEnvPixels > 0 && dpr > 1 && roughlyEqualPixels(pixels / dpr, cssEnvPixels)) {
+    return cssEnvPixels;
+  }
+  return pixels;
 }
 function pixelsTopToPercentOfViewport(pixels, bridge) {
-  const h = viewportInnerHeight(bridge);
+  const h = getViewportHeight(bridge);
   if (h <= 0) {
     return 0;
   }
-  return normalizeSafeAreaTopPercent(pixels / h * 100);
+  return normalizeSafeAreaTopPercent(pixels / h * 100) ?? 0;
+}
+function cssSafeAreaTopPercent(bridge) {
+  return pixelsTopToPercentOfViewport(readCssSafeAreaTopPixels(bridge), bridge);
+}
+function resolvePercentValue(value, bridge) {
+  const percent = normalizeSafeAreaTopPercent(value);
+  if (typeof percent === "undefined") {
+    return void 0;
+  }
+  return percent > 0 ? percent : cssSafeAreaTopPercent(bridge);
+}
+function resolvePixelValue(value, bridge) {
+  const numeric = toFiniteNumber(value);
+  if (typeof numeric === "undefined") {
+    return void 0;
+  }
+  return pixelsTopToPercentOfViewport(normalizeSafeAreaTopPixels(numeric, bridge), bridge);
 }
 function getSafeAreaTop() {
-  const bridge = getBridgeWindow6();
+  const bridge = getBridgeWindow8();
   if (!bridge) {
     return 0;
   }
   if (typeof bridge.getSafeAreaTopPercent === "function") {
-    return normalizeSafeAreaTopPercent(bridge.getSafeAreaTopPercent());
+    const percent = resolvePercentValue(bridge.getSafeAreaTopPercent(), bridge);
+    if (typeof percent !== "undefined") {
+      return percent;
+    }
   }
   if (typeof bridge.__OASIZ_SAFE_AREA_TOP_PERCENT__ !== "undefined") {
-    return normalizeSafeAreaTopPercent(bridge.__OASIZ_SAFE_AREA_TOP_PERCENT__);
+    const percent = resolvePercentValue(bridge.__OASIZ_SAFE_AREA_TOP_PERCENT__, bridge);
+    if (typeof percent !== "undefined") {
+      return percent;
+    }
   }
   if (typeof bridge.getSafeAreaTop === "function") {
-    const px = normalizeSafeAreaTopPixels(bridge.getSafeAreaTop());
-    return pixelsTopToPercentOfViewport(px, bridge);
+    const percent = resolvePixelValue(bridge.getSafeAreaTop(), bridge);
+    if (typeof percent !== "undefined") {
+      return percent;
+    }
   }
   if (typeof bridge.__OASIZ_SAFE_AREA_TOP__ !== "undefined") {
-    const px = normalizeSafeAreaTopPixels(bridge.__OASIZ_SAFE_AREA_TOP__);
-    return pixelsTopToPercentOfViewport(px, bridge);
+    const percent = resolvePixelValue(bridge.__OASIZ_SAFE_AREA_TOP__, bridge);
+    if (typeof percent !== "undefined") {
+      return percent;
+    }
+  }
+  const cssPercent = cssSafeAreaTopPercent(bridge);
+  if (cssPercent > 0) {
+    return cssPercent;
   }
-  warnMissingBridge4("getSafeAreaTop");
+  warnMissingBridge6("getSafeAreaTop");
   return 0;
 }
 function setLeaderboardVisible(visible) {
   if (typeof visible !== "boolean") {
-    if (isDevelopment7()) {
+    if (isDevelopment9()) {
       console.warn(
         "[oasiz/sdk] setLeaderboardVisible expected a boolean:",
         visible
@@ -1229,28 +1440,28 @@ function setLeaderboardVisible(visible) {
     }
     return;
   }
-  const bridge = getBridgeWindow6();
+  const bridge = getBridgeWindow8();
   if (typeof bridge?.__oasizSetLeaderboardVisible === "function") {
     bridge.__oasizSetLeaderboardVisible(visible);
     return;
   }
-  warnMissingBridge4("__oasizSetLeaderboardVisible");
+  warnMissingBridge6("__oasizSetLeaderboardVisible");
 }
 
 // src/navigation.ts
 var activeBackListeners = 0;
-function isDevelopment8() {
+function isDevelopment10() {
   const nodeEnv = globalThis.process?.env?.NODE_ENV;
   return nodeEnv !== "production";
 }
-function getBridgeWindow7() {
+function getBridgeWindow9() {
   if (typeof window === "undefined") {
     return void 0;
   }
   return window;
 }
-function warnMissingBridge5(methodName) {
-  if (isDevelopment8()) {
+function warnMissingBridge7(methodName) {
+  if (isDevelopment10()) {
     console.warn(
       "[oasiz/sdk] " + methodName + " bridge is unavailable. This is expected in local development."
     );
@@ -1266,7 +1477,7 @@ function normalizeNavigationError(error) {
 }
 function addNavigationListener(eventName, callback) {
   if (typeof window === "undefined") {
-    if (isDevelopment8()) {
+    if (isDevelopment10()) {
       console.warn(
         "[oasiz/sdk] " + eventName + " listener registered without a browser window. This is expected in local development."
       );
@@ -1287,24 +1498,24 @@ function onBackButton(callback) {
       throw normalizeNavigationError(error);
     }
   });
-  const bridge = getBridgeWindow7();
+  const bridge = getBridgeWindow9();
   activeBackListeners += 1;
   if (activeBackListeners === 1) {
     if (typeof bridge?.__oasizSetBackOverride === "function") {
       bridge.__oasizSetBackOverride(true);
     } else {
-      warnMissingBridge5("__oasizSetBackOverride");
+      warnMissingBridge7("__oasizSetBackOverride");
     }
   }
   return () => {
     off();
     activeBackListeners = Math.max(0, activeBackListeners - 1);
     if (activeBackListeners === 0) {
-      const currentBridge = getBridgeWindow7();
+      const currentBridge = getBridgeWindow9();
       if (typeof currentBridge?.__oasizSetBackOverride === "function") {
         currentBridge.__oasizSetBackOverride(false);
       } else {
-        warnMissingBridge5("__oasizSetBackOverride");
+        warnMissingBridge7("__oasizSetBackOverride");
       }
     }
   };
@@ -1313,17 +1524,20 @@ function onLeaveGame(callback) {
   return addNavigationListener("oasiz:leave", callback);
 }
 function leaveGame() {
-  const bridge = getBridgeWindow7();
+  const bridge = getBridgeWindow9();
   if (typeof bridge?.__oasizLeaveGame === "function") {
     bridge.__oasizLeaveGame();
     return;
   }
-  warnMissingBridge5("__oasizLeaveGame");
+  warnMissingBridge7("__oasizLeaveGame");
 }
 
 // src/index.ts
 var oasiz = {
   submitScore,
+  addScore,
+  setScore,
+  getPlayerCharacter,
   share,
   triggerHaptic,
   enableLogOverlay,
@@ -1345,6 +1559,9 @@ var oasiz = {
   get roomCode() {
     return getRoomCode();
   },
+  get playerId() {
+    return getPlayerId();
+  },
   get playerName() {
     return getPlayerName();
   },
@@ -1356,10 +1573,13 @@ var oasiz = {
   }
 };
 export {
+  addScore,
   enableLogOverlay,
   flushGameState,
   getGameId,
   getPlayerAvatar,
+  getPlayerCharacter,
+  getPlayerId,
   getPlayerName,
   getRoomCode,
   getSafeAreaTop,
@@ -1373,6 +1593,7 @@ export {
   openInviteModal,
   saveGameState,
   setLeaderboardVisible,
+  setScore,
   share,
   shareRoomCode,
   submitScore,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oasiz/sdk",
-  "version": "1.5.3",
+  "version": "1.5.5",
   "description": "Typed SDK for Oasiz game platform bridge APIs.",
   "type": "module",
   "main": "./dist/index.cjs",