@oasiz/sdk 0.1.0

package/README.md

@@ -0,0 +1,42 @@
+# @oasiz/sdk
+
+Typed SDK for Oasiz game bridge APIs.
+
+## Install
+
+```bash
+npm install @oasiz/sdk
+```
+
+## Usage
+
+```ts
+import { oasis } from "@oasiz/sdk";
+
+oasis.emitScoreConfig({
+  anchors: [
+    { raw: 30, normalized: 100 },
+    { raw: 60, normalized: 300 },
+    { raw: 120, normalized: 600 },
+    { raw: 300, normalized: 950 },
+  ],
+});
+
+const saved = oasis.loadGameState();
+oasis.saveGameState({ ...saved, level: 3 });
+oasis.triggerHaptic("light");
+oasis.submitScore(42);
+```
+
+## API
+
+- `submitScore(score)`
+- `emitScoreConfig(config)`
+- `triggerHaptic(type)`
+- `loadGameState()`
+- `saveGameState(state)`
+- `flushGameState()`
+- `shareRoomCode(code)`
+- `onPause(callback)`
+- `onResume(callback)`
+- `oasis.gameId`, `oasis.roomCode`, `oasis.playerName`, `oasis.playerAvatar`

package/dist/index.cjs

@@ -0,0 +1,277 @@
+"use strict";
+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, {
+  emitScoreConfig: () => emitScoreConfig,
+  flushGameState: () => flushGameState,
+  getGameId: () => getGameId,
+  getPlayerAvatar: () => getPlayerAvatar,
+  getPlayerName: () => getPlayerName,
+  getRoomCode: () => getRoomCode,
+  loadGameState: () => loadGameState,
+  oasis: () => oasis,
+  onPause: () => onPause,
+  onResume: () => onResume,
+  saveGameState: () => saveGameState,
+  shareRoomCode: () => shareRoomCode,
+  submitScore: () => submitScore,
+  triggerHaptic: () => triggerHaptic
+});
+module.exports = __toCommonJS(index_exports);
+
+// 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");
+}
+function emitScoreConfig(config) {
+  const bridge = getBridgeWindow3();
+  if (typeof bridge?.emitScoreConfig === "function") {
+    bridge.emitScoreConfig(config);
+    return;
+  }
+  warnMissingBridge("emitScoreConfig");
+}
+
+// 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 oasis = {
+  submitScore,
+  emitScoreConfig,
+  triggerHaptic,
+  loadGameState,
+  saveGameState,
+  flushGameState,
+  shareRoomCode,
+  onPause,
+  onResume,
+  get gameId() {
+    return getGameId();
+  },
+  get roomCode() {
+    return getRoomCode();
+  },
+  get playerName() {
+    return getPlayerName();
+  },
+  get playerAvatar() {
+    return getPlayerAvatar();
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  emitScoreConfig,
+  flushGameState,
+  getGameId,
+  getPlayerAvatar,
+  getPlayerName,
+  getRoomCode,
+  loadGameState,
+  oasis,
+  onPause,
+  onResume,
+  saveGameState,
+  shareRoomCode,
+  submitScore,
+  triggerHaptic
+});

package/dist/index.d.cts

@@ -0,0 +1,46 @@
+type HapticType = "light" | "medium" | "heavy" | "success" | "error";
+interface ScoreAnchor {
+    raw: number;
+    normalized: 100 | 300 | 600 | 950;
+}
+interface ScoreConfig {
+    anchors: [ScoreAnchor, ScoreAnchor, ScoreAnchor, ScoreAnchor];
+}
+type GameState = Record<string, unknown>;
+
+declare function triggerHaptic(type: HapticType): void;
+
+declare function shareRoomCode(roomCode: string | null): void;
+declare function getGameId(): string | undefined;
+declare function getRoomCode(): string | undefined;
+declare function getPlayerName(): string | undefined;
+declare function getPlayerAvatar(): string | undefined;
+
+declare function submitScore(score: number): void;
+declare function emitScoreConfig(config: ScoreConfig): void;
+
+declare function loadGameState(): GameState;
+declare function saveGameState(state: GameState): void;
+declare function flushGameState(): void;
+
+type Unsubscribe = () => void;
+declare function onPause(callback: () => void): Unsubscribe;
+declare function onResume(callback: () => void): Unsubscribe;
+
+declare const oasis: {
+    submitScore: typeof submitScore;
+    emitScoreConfig: typeof emitScoreConfig;
+    triggerHaptic: typeof triggerHaptic;
+    loadGameState: typeof loadGameState;
+    saveGameState: typeof saveGameState;
+    flushGameState: typeof flushGameState;
+    shareRoomCode: typeof shareRoomCode;
+    onPause: typeof onPause;
+    onResume: typeof onResume;
+    readonly gameId: string | undefined;
+    readonly roomCode: string | undefined;
+    readonly playerName: string | undefined;
+    readonly playerAvatar: string | undefined;
+};
+
+export { type GameState, type HapticType, type ScoreAnchor, type ScoreConfig, type Unsubscribe, emitScoreConfig, flushGameState, getGameId, getPlayerAvatar, getPlayerName, getRoomCode, loadGameState, oasis, onPause, onResume, saveGameState, shareRoomCode, submitScore, triggerHaptic };

package/dist/index.d.ts

@@ -0,0 +1,46 @@
+type HapticType = "light" | "medium" | "heavy" | "success" | "error";
+interface ScoreAnchor {
+    raw: number;
+    normalized: 100 | 300 | 600 | 950;
+}
+interface ScoreConfig {
+    anchors: [ScoreAnchor, ScoreAnchor, ScoreAnchor, ScoreAnchor];
+}
+type GameState = Record<string, unknown>;
+
+declare function triggerHaptic(type: HapticType): void;
+
+declare function shareRoomCode(roomCode: string | null): void;
+declare function getGameId(): string | undefined;
+declare function getRoomCode(): string | undefined;
+declare function getPlayerName(): string | undefined;
+declare function getPlayerAvatar(): string | undefined;
+
+declare function submitScore(score: number): void;
+declare function emitScoreConfig(config: ScoreConfig): void;
+
+declare function loadGameState(): GameState;
+declare function saveGameState(state: GameState): void;
+declare function flushGameState(): void;
+
+type Unsubscribe = () => void;
+declare function onPause(callback: () => void): Unsubscribe;
+declare function onResume(callback: () => void): Unsubscribe;
+
+declare const oasis: {
+    submitScore: typeof submitScore;
+    emitScoreConfig: typeof emitScoreConfig;
+    triggerHaptic: typeof triggerHaptic;
+    loadGameState: typeof loadGameState;
+    saveGameState: typeof saveGameState;
+    flushGameState: typeof flushGameState;
+    shareRoomCode: typeof shareRoomCode;
+    onPause: typeof onPause;
+    onResume: typeof onResume;
+    readonly gameId: string | undefined;
+    readonly roomCode: string | undefined;
+    readonly playerName: string | undefined;
+    readonly playerAvatar: string | undefined;
+};
+
+export { type GameState, type HapticType, type ScoreAnchor, type ScoreConfig, type Unsubscribe, emitScoreConfig, flushGameState, getGameId, getPlayerAvatar, getPlayerName, getRoomCode, loadGameState, oasis, onPause, onResume, saveGameState, shareRoomCode, submitScore, triggerHaptic };

package/dist/index.js

@@ -0,0 +1,237 @@
+// 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");
+}
+function emitScoreConfig(config) {
+  const bridge = getBridgeWindow3();
+  if (typeof bridge?.emitScoreConfig === "function") {
+    bridge.emitScoreConfig(config);
+    return;
+  }
+  warnMissingBridge("emitScoreConfig");
+}
+
+// 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 oasis = {
+  submitScore,
+  emitScoreConfig,
+  triggerHaptic,
+  loadGameState,
+  saveGameState,
+  flushGameState,
+  shareRoomCode,
+  onPause,
+  onResume,
+  get gameId() {
+    return getGameId();
+  },
+  get roomCode() {
+    return getRoomCode();
+  },
+  get playerName() {
+    return getPlayerName();
+  },
+  get playerAvatar() {
+    return getPlayerAvatar();
+  }
+};
+export {
+  emitScoreConfig,
+  flushGameState,
+  getGameId,
+  getPlayerAvatar,
+  getPlayerName,
+  getRoomCode,
+  loadGameState,
+  oasis,
+  onPause,
+  onResume,
+  saveGameState,
+  shareRoomCode,
+  submitScore,
+  triggerHaptic
+};

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@oasiz/sdk",
+  "version": "0.1.0",
+  "description": "Typed SDK for Oasiz game platform bridge APIs.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "prepack": "bun run build",
+    "test": "node --experimental-strip-types --test ./tests/**/*.test.ts"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "release": {
+    "branches": [
+      "main"
+    ]
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "semantic-release": "^25.0.3",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  }
+}