@oasiz/sdk 1.2.0 → 1.2.1

package/dist/index.d.cts

@@ -1,4 +1,24 @@
 type HapticType = "light" | "medium" | "heavy" | "success" | "error";
+type LogOverlayLevel = "debug" | "log" | "info" | "warn" | "error";
+interface LogOverlayEntry {
+    id: number;
+    level: LogOverlayLevel;
+    message: string;
+    timestamp: number;
+}
+interface LogOverlayOptions {
+    collapsed?: boolean;
+    enabled?: boolean;
+    maxEntries?: number;
+    title?: string;
+}
+interface LogOverlayHandle {
+    clear: () => void;
+    destroy: () => void;
+    hide: () => void;
+    isVisible: () => boolean;
+    show: () => void;
+}
 interface ScoreAnchor {
     raw: number;
     normalized: 100 | 300 | 600 | 950;
@@ -10,6 +30,8 @@ type GameState = Record<string, unknown>;
 
 declare function triggerHaptic(type: HapticType): void;
 
+declare function enableLogOverlay(options?: LogOverlayOptions): LogOverlayHandle;
+
 interface ShareRoomCodeOptions {
     inviteOverride?: boolean;
 }
@@ -49,6 +71,7 @@ declare const oasiz: {
     submitScore: typeof submitScore;
     emitScoreConfig: typeof emitScoreConfig;
     triggerHaptic: typeof triggerHaptic;
+    enableLogOverlay: typeof enableLogOverlay;
     loadGameState: typeof loadGameState;
     saveGameState: typeof saveGameState;
     flushGameState: typeof flushGameState;
@@ -65,4 +88,4 @@ declare const oasiz: {
     readonly playerAvatar: string | undefined;
 };
 
-export { type GameState, type HapticType, type ScoreAnchor, type ScoreConfig, type ShareRoomCodeOptions, type Unsubscribe, emitScoreConfig, flushGameState, getGameId, getPlayerAvatar, getPlayerName, getRoomCode, leaveGame, loadGameState, oasiz, onBackButton, onLeaveGame, onPause, onResume, openInviteModal, saveGameState, shareRoomCode, submitScore, triggerHaptic };
+export { type GameState, type HapticType, type LogOverlayEntry, type LogOverlayHandle, type LogOverlayLevel, type LogOverlayOptions, type ScoreAnchor, type ScoreConfig, type ShareRoomCodeOptions, type Unsubscribe, emitScoreConfig, enableLogOverlay, flushGameState, getGameId, getPlayerAvatar, getPlayerName, getRoomCode, leaveGame, loadGameState, oasiz, onBackButton, onLeaveGame, onPause, onResume, openInviteModal, saveGameState, shareRoomCode, submitScore, triggerHaptic };

package/dist/index.d.ts

@@ -1,4 +1,24 @@
 type HapticType = "light" | "medium" | "heavy" | "success" | "error";
+type LogOverlayLevel = "debug" | "log" | "info" | "warn" | "error";
+interface LogOverlayEntry {
+    id: number;
+    level: LogOverlayLevel;
+    message: string;
+    timestamp: number;
+}
+interface LogOverlayOptions {
+    collapsed?: boolean;
+    enabled?: boolean;
+    maxEntries?: number;
+    title?: string;
+}
+interface LogOverlayHandle {
+    clear: () => void;
+    destroy: () => void;
+    hide: () => void;
+    isVisible: () => boolean;
+    show: () => void;
+}
 interface ScoreAnchor {
     raw: number;
     normalized: 100 | 300 | 600 | 950;
@@ -10,6 +30,8 @@ type GameState = Record<string, unknown>;
 
 declare function triggerHaptic(type: HapticType): void;
 
+declare function enableLogOverlay(options?: LogOverlayOptions): LogOverlayHandle;
+
 interface ShareRoomCodeOptions {
     inviteOverride?: boolean;
 }
@@ -49,6 +71,7 @@ declare const oasiz: {
     submitScore: typeof submitScore;
     emitScoreConfig: typeof emitScoreConfig;
     triggerHaptic: typeof triggerHaptic;
+    enableLogOverlay: typeof enableLogOverlay;
     loadGameState: typeof loadGameState;
     saveGameState: typeof saveGameState;
     flushGameState: typeof flushGameState;
@@ -65,4 +88,4 @@ declare const oasiz: {
     readonly playerAvatar: string | undefined;
 };
 
-export { type GameState, type HapticType, type ScoreAnchor, type ScoreConfig, type ShareRoomCodeOptions, type Unsubscribe, emitScoreConfig, flushGameState, getGameId, getPlayerAvatar, getPlayerName, getRoomCode, leaveGame, loadGameState, oasiz, onBackButton, onLeaveGame, onPause, onResume, openInviteModal, saveGameState, shareRoomCode, submitScore, triggerHaptic };
+export { type GameState, type HapticType, type LogOverlayEntry, type LogOverlayHandle, type LogOverlayLevel, type LogOverlayOptions, type ScoreAnchor, type ScoreConfig, type ShareRoomCodeOptions, type Unsubscribe, emitScoreConfig, enableLogOverlay, flushGameState, getGameId, getPlayerAvatar, getPlayerName, getRoomCode, leaveGame, loadGameState, oasiz, onBackButton, onLeaveGame, onPause, onResume, openInviteModal, saveGameState, shareRoomCode, submitScore, triggerHaptic };

package/dist/index.global.js

@@ -0,0 +1,252 @@
+"use strict";
+var oasiz = (() => {
+  var __defProp = Object.defineProperty;
+  var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+  var __getOwnPropNames = Object.getOwnPropertyNames;
+  var __hasOwnProp = Object.prototype.hasOwnProperty;
+  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 index_exports = {};
+  __export(index_exports, {
+    flushGameState: () => flushGameState,
+    getGameId: () => getGameId,
+    getPlayerAvatar: () => getPlayerAvatar,
+    getPlayerName: () => getPlayerName,
+    getRoomCode: () => getRoomCode,
+    loadGameState: () => loadGameState,
+    oasiz: () => oasiz,
+    onPause: () => onPause,
+    onResume: () => onResume,
+    saveGameState: () => saveGameState,
+    shareRoomCode: () => shareRoomCode,
+    submitScore: () => submitScore,
+    triggerHaptic: () => triggerHaptic
+  });
+
+  // src/haptics.ts
+  function isDevelopment() {
+    const nodeEnv = globalThis.process?.env?.NODE_ENV;
+    return nodeEnv !== "production";
+  }
+  function getBridgeWindow() {
+    if (typeof window === "undefined") {
+      return void 0;
+    }
+    return window;
+  }
+  function triggerHaptic(type) {
+    const bridge = getBridgeWindow();
+    if (typeof bridge?.triggerHaptic === "function") {
+      bridge.triggerHaptic(type);
+      return;
+    }
+    if (isDevelopment()) {
+      console.warn(
+        "[oasiz/sdk] triggerHaptic bridge is unavailable. This is expected in local development."
+      );
+    }
+  }
+
+  // src/multiplayer.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 shareRoomCode(roomCode) {
+    const bridge = getBridgeWindow2();
+    if (typeof bridge?.shareRoomCode === "function") {
+      bridge.shareRoomCode(roomCode);
+      return;
+    }
+    if (isDevelopment2()) {
+      console.warn(
+        "[oasiz/sdk] shareRoomCode bridge is unavailable. This is expected in local development."
+      );
+    }
+  }
+  function getGameId() {
+    const bridge = getBridgeWindow2();
+    return bridge?.__GAME_ID__;
+  }
+  function getRoomCode() {
+    const bridge = getBridgeWindow2();
+    return bridge?.__ROOM_CODE__;
+  }
+  function getPlayerName() {
+    const bridge = getBridgeWindow2();
+    return bridge?.__PLAYER_NAME__;
+  }
+  function getPlayerAvatar() {
+    const bridge = getBridgeWindow2();
+    return bridge?.__PLAYER_AVATAR__;
+  }
+
+  // src/score.ts
+  function isDevelopment3() {
+    const nodeEnv = globalThis.process?.env?.NODE_ENV;
+    return nodeEnv !== "production";
+  }
+  function warnMissingBridge(methodName) {
+    if (isDevelopment3()) {
+      console.warn(
+        "[oasiz/sdk] " + methodName + " bridge is unavailable. This is expected in local development."
+      );
+    }
+  }
+  function getBridgeWindow3() {
+    if (typeof window === "undefined") {
+      return void 0;
+    }
+    return window;
+  }
+  function submitScore(score) {
+    if (!Number.isFinite(score)) {
+      if (isDevelopment3()) {
+        console.warn("[oasiz/sdk] submitScore expected a finite number:", score);
+      }
+      return;
+    }
+    const bridge = getBridgeWindow3();
+    const normalizedScore = Math.max(0, Math.floor(score));
+    if (typeof bridge?.submitScore === "function") {
+      bridge.submitScore(normalizedScore);
+      return;
+    }
+    warnMissingBridge("submitScore");
+  }
+
+  // src/state.ts
+  function isDevelopment4() {
+    const nodeEnv = globalThis.process?.env?.NODE_ENV;
+    return nodeEnv !== "production";
+  }
+  function getBridgeWindow4() {
+    if (typeof window === "undefined") {
+      return void 0;
+    }
+    return window;
+  }
+  function isPlainObject(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+      return false;
+    }
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+  }
+  function warnMissingBridge2(methodName) {
+    if (isDevelopment4()) {
+      console.warn(
+        "[oasiz/sdk] " + methodName + " bridge is unavailable. This is expected in local development."
+      );
+    }
+  }
+  function loadGameState() {
+    const bridge = getBridgeWindow4();
+    if (typeof bridge?.loadGameState !== "function") {
+      warnMissingBridge2("loadGameState");
+      return {};
+    }
+    const state = bridge.loadGameState();
+    if (!isPlainObject(state)) {
+      if (isDevelopment4()) {
+        console.warn(
+          "[oasiz/sdk] loadGameState returned invalid data. Falling back to empty object."
+        );
+      }
+      return {};
+    }
+    return state;
+  }
+  function saveGameState(state) {
+    if (!isPlainObject(state)) {
+      if (isDevelopment4()) {
+        console.warn("[oasiz/sdk] saveGameState expected a plain object:", state);
+      }
+      return;
+    }
+    const bridge = getBridgeWindow4();
+    if (typeof bridge?.saveGameState === "function") {
+      bridge.saveGameState(state);
+      return;
+    }
+    warnMissingBridge2("saveGameState");
+  }
+  function flushGameState() {
+    const bridge = getBridgeWindow4();
+    if (typeof bridge?.flushGameState === "function") {
+      bridge.flushGameState();
+      return;
+    }
+    warnMissingBridge2("flushGameState");
+  }
+
+  // src/lifecycle.ts
+  function isDevelopment5() {
+    const nodeEnv = globalThis.process?.env?.NODE_ENV;
+    return nodeEnv !== "production";
+  }
+  function addLifecycleListener(eventName, callback) {
+    if (typeof window === "undefined") {
+      if (isDevelopment5()) {
+        console.warn(
+          "[oasiz/sdk] " + eventName + " listener registered without a browser window. This is expected in local development."
+        );
+      }
+      return () => {
+      };
+    }
+    const handler = () => callback();
+    window.addEventListener(eventName, handler);
+    return () => window.removeEventListener(eventName, handler);
+  }
+  function onPause(callback) {
+    return addLifecycleListener("oasiz:pause", callback);
+  }
+  function onResume(callback) {
+    return addLifecycleListener("oasiz:resume", callback);
+  }
+
+  // src/index.ts
+  var oasiz = {
+    submitScore,
+    triggerHaptic,
+    loadGameState,
+    saveGameState,
+    flushGameState,
+    shareRoomCode,
+    onPause,
+    onResume,
+    get gameId() {
+      return getGameId();
+    },
+    get roomCode() {
+      return getRoomCode();
+    },
+    get playerName() {
+      return getPlayerName();
+    },
+    get playerAvatar() {
+      return getPlayerAvatar();
+    }
+  };
+  return __toCommonJS(index_exports);
+})();