@nanotoolkit/game-sdk 0.1.10 → 0.1.11

package/Lib/Bridge/GameBridge.js

@@ -1,7 +1,7 @@
 import { parseWireJSON, stringifyWireJSON } from './WireJSON.js';
 import { GameState } from './GameState.js';
 
-export const SDK_VERSION = '0.1.10';
+export const SDK_VERSION = '0.1.11';
 
 const REQUEST_TIMEOUT_MS = 10000;
 
@@ -123,6 +123,7 @@ export function ready(bundleId, onInit) {
         });
         subscribe('game:ping', (msg) => send({ type: 'game:pong', echo: msg.ts }));
         ensureBackListener();
+        ensureExitListener();
         ensureStateListeners();
         subscribe('game:init', (msg) => {
             if (initState) return;
@@ -132,7 +133,7 @@ export function ready(bundleId, onInit) {
             settleInit(publicInit(msg));
             for (const run of initWaiters.splice(0)) run();
         });
-        send({ type: 'game:ready', game: bundleId, sdk: SDK_VERSION });
+        send({ type: 'game:ready', game: bundleId, sdk: SDK_VERSION, exitLifecycle: 1 });
     }
     if (typeof onInit === 'function') initPromise.then(onInit);
     return initPromise;
@@ -155,6 +156,22 @@ export function serverNow() {
 }
 
 const backHandlers = new Set();
+const exitHandlers = new Set();
+
+function ensureExitListener() {
+    if (ensureExitListener.done) return;
+    ensureExitListener.done = true;
+    let lastSequence = null;
+    subscribe('game:will_exit', (msg) => {
+        if (msg.seq !== lastSequence) {
+            lastSequence = msg.seq;
+            for (const handler of [...exitHandlers]) {
+                try { handler(); } catch (error) { console.error('[game-sdk] handler error', error); }
+            }
+        }
+        send({ type: 'game:exit_ready', seq: msg.seq });
+    });
+}
 
 function ensureBackListener() {
     if (ensureBackListener.done) return;
@@ -205,6 +222,11 @@ function emitLocal(event, payload) {
 
 export function on(event, handler) {
     if (typeof handler !== 'function') throw new TypeError('invalid handler');
+    if (event === 'willExit') {
+        ensureExitListener();
+        exitHandlers.add(handler);
+        return () => exitHandlers.delete(handler);
+    }
     if (event === 'back') {
         ensureBackListener();
         backHandlers.add(handler);
@@ -225,7 +247,7 @@ export function on(event, handler) {
     const spec = EVENTS[event];
     if (!spec)
         throw new TypeError(
-            `invalid event: ${event} / ${[...Object.keys(EVENTS), 'back', ...Object.keys(localHandlers)].join(
+            `invalid event: ${event} / ${[...Object.keys(EVENTS), 'back', 'willExit', ...Object.keys(localHandlers)].join(
                 ' / ',
             )}`,
         );

package/index.d.ts

@@ -295,6 +295,7 @@ export function watchIssues(): () => void;
 export interface EventPayloads {
     pause: undefined;
     resume: undefined;
+    willExit: undefined;
     theme: { dark: boolean };
     lang: { lang: string };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanotoolkit/game-sdk",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "private": false,
   "license": "UNLICENSED",
   "type": "module",