@oasiz/sdk 1.3.0 → 1.4.1

package/README.md

@@ -35,12 +35,6 @@ oasiz.triggerHaptic("medium");
 
 // 5. Submit score when the game ends
 oasiz.submitScore(score);
-
-// 6. Optionally surface console logs in-game while debugging
-oasiz.enableLogOverlay({
-  enabled: new URLSearchParams(window.location.search).has("oasizLogs"),
-  collapsed: true,
-});
 ```
 
 ---
@@ -134,34 +128,6 @@ Haptics are throttled internally (50ms cooldown) to prevent spam.
 
 ---
 
-## Debugging
-
-### `oasiz.enableLogOverlay(options?: LogOverlayOptions)`
-
-Mount an opt-in in-game console viewer for local debugging, QA sessions, or creator support. It mirrors `console.log`, `console.info`, `console.warn`, `console.error`, and `console.debug` into a floating overlay inside the game iframe. The overlay can be collapsed, repositioned by dragging the top bar, and resized from the bottom-right corner while the action buttons remain clickable.
-
-```ts
-const logOverlay = oasiz.enableLogOverlay({
-  enabled: new URLSearchParams(window.location.search).has("oasizLogs"),
-  collapsed: true,
-});
-
-console.log("[Boot] Scene ready");
-
-// Optional cleanup if your game tears down and remounts
-logOverlay.destroy();
-```
-
-Options:
-- `enabled`: defaults to `true`. Pass your own flag or query-param check here.
-- `collapsed`: start with only the toggle pill visible.
-- `maxEntries`: cap retained log lines. Defaults to `200`.
-- `title`: optional label shown at the top of the panel. Defaults to `SDK Logs`.
-
-The returned handle supports `show()`, `hide()`, `clear()`, `isVisible()`, and `destroy()`.
-
----
-
 ## Game state persistence
 
 Persist cross-session data such as unlocked levels, inventory, or lifetime stats. State is stored per-user per-game in the Oasiz backend — available across devices and app reinstalls.
@@ -253,6 +219,8 @@ Registers a callback for platform back actions. While at least one back listener
 
 Use this for pause menus, in-game overlays, or custom back-stack behavior.
 
+If your callback throws, Oasiz falls back to closing the game and returning the player to Oasiz home before rethrowing the error for debugging/reporting.
+
 ```ts
 const offBack = oasiz.onBackButton(() => {
   if (this.isPauseMenuOpen) {
@@ -276,6 +244,17 @@ quitButton.addEventListener("click", () => {
 });
 ```
 
+### `oasiz.share(options: { text?: string; score?: number; image?: string }): Promise<void>`
+
+Ask the host to open the same share flow Oasiz already uses today. Use `text` to customize the share message, `score` to trigger a challenge-style share, and `image` to share an `http(s)` URL or `data:image/...` payload.
+
+```ts
+await oasiz.share({
+  text: "I made it to level 9!",
+  score: 4200,
+});
+```
+
 ### `oasiz.onLeaveGame(callback: () => void): Unsubscribe`
 
 Registers a callback fired when the host initiates closing the game (for example, close button, gesture, or host navigation). Use this for lightweight cleanup.
@@ -294,12 +273,10 @@ offLeave();
 
 ## Multiplayer
 
-### `oasiz.shareRoomCode(code: string | null, options?: { inviteOverride?: boolean })`
+### `oasiz.shareRoomCode(code: string | null)`
 
 Notify the platform of the active multiplayer room so friends can join via the invite system. Pass `null` when leaving a room.
 
-Set `inviteOverride: true` when your game wants to hide the platform invite pill and render its own invite button/UI. The platform still tracks the room code, but your game owns the invite entry point.
-
 ```ts
 import { insertCoin, getRoomCode } from "playroomkit";
 import { oasiz } from "@oasiz/sdk";
@@ -311,23 +288,6 @@ oasiz.shareRoomCode(getRoomCode());
 oasiz.shareRoomCode(null);
 ```
 
-```ts
-// Game-owned invite UI: hide the platform pill, keep room tracking
-oasiz.shareRoomCode(getRoomCode(), { inviteOverride: true });
-```
-
-If you still want to use the platform invite sheet from your own in-game button, combine it with `openInviteModal()`:
-
-```ts
-import { openInviteModal, shareRoomCode } from "@oasiz/sdk";
-
-shareRoomCode("ABCD", { inviteOverride: true });
-
-inviteButton.addEventListener("click", () => {
-  openInviteModal();
-});
-```
-
 ### Read-only injected values
 
 These are populated by the platform before the game loads. Always check for `undefined` before using.
@@ -361,7 +321,6 @@ import {
   saveGameState,
   flushGameState,
   shareRoomCode,
-  enableLogOverlay,
   onPause,
   onResume,
   onBackButton,
@@ -379,14 +338,7 @@ import {
 ## TypeScript types
 
 ```ts
-import type {
-  GameState,
-  HapticType,
-  LogOverlayHandle,
-  LogOverlayOptions,
-  ScoreAnchor,
-  ScoreConfig,
-} from "@oasiz/sdk";
+import type { HapticType, ScoreConfig, ScoreAnchor, GameState } from "@oasiz/sdk";
 ```
 
 ---