@umicat/platform-sdk 0.4.0 → 0.5.0

package/dist/core/transports/PostMessageTransport.d.ts

@@ -26,6 +26,8 @@ export declare class PostMessageTransport implements Transport {
      * longer to boot. One-shot hello was losing the handshake on Android.
      */
     static connect(timeoutMs?: number, sdkVersion?: string, helloRetryMs?: number): Promise<PostMessageTransport | null>;
+    /** The most recent host push of each type, for subscribers that arrive late. */
+    private readonly lastEvent;
     private installResultListener;
     on(event: string, handler: (payload: unknown) => void): () => void;
     call<T = unknown>(method: string, params?: unknown, timeoutMs?: number): Promise<T>;

package/dist/core/transports/PostMessageTransport.js

@@ -14,6 +14,8 @@ export class PostMessageTransport {
         this.pending = new Map();
         this.seq = 0;
         this.eventHandlers = new Map();
+        /** The most recent host push of each type, for subscribers that arrive late. */
+        this.lastEvent = new Map();
     }
     /**
      * Perform the handshake. Resolves once parent has replied with `umicat:init`.
@@ -95,6 +97,17 @@ export class PostMessageTransport {
                 return;
             }
             // Host-pushed event stream (e.g. 'umicat:voice') → registered handlers.
+            //
+            // Remembered as well as delivered. A host pushes STATE as soon as the
+            // handshake completes, and the modules that want it are constructed after
+            // `connect()` returns — so the first push of a fold arrived with nobody
+            // listening and was never repeated. The symptom is a game laid out for one
+            // screen on a device that is already folded, which then fixes itself the
+            // moment anything moves.
+            //
+            // Only the LAST of each type: this is for state, and a replayed queue of
+            // old transcript fragments would be worse than dropping them.
+            this.lastEvent.set(data.type, data);
             const handlers = this.eventHandlers.get(data.type);
             if (handlers)
                 for (const handler of handlers)
@@ -108,6 +121,10 @@ export class PostMessageTransport {
             this.eventHandlers.set(event, handlers);
         }
         handlers.add(handler);
+        // Catch up, if this type already arrived before anyone subscribed.
+        const last = this.lastEvent.get(event);
+        if (last !== undefined)
+            handler(last);
         return () => { handlers.delete(handler); };
     }
     call(method, params, timeoutMs = 10000) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umicat/platform-sdk",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Umicat's platform layer, independent of any rendering engine: identity, cloud saves, shared game data, multiplayer, runtime AI, voice and scripted dialogue. Consumed by @umicat/phaser-sdk and @umicat/three-sdk alike.",
   "type": "module",
   "main": "dist/index.js",