@mpgd/game-runtime 0.4.0 → 0.5.0

package/dist/ads/index.d.ts

@@ -1,4 +1,4 @@
-import type { PlatformEvidenceEnvelope, PlatformGateway, PurchaseResult } from '@mpgd/platform';
+import type { PlatformEvidenceEnvelope, PlatformGateway, PlatformPurchasePresentationEvent, PurchaseResult } from '@mpgd/platform';
 import type { GameServicesRewardedAdResult } from '@mpgd/game-services/operations';
 import { type AdPlacementInput, type AdProvider, type AdShowInput, type AdShowResult } from '@mpgd/platform/ads';
 import { type ObserverErrorHandler } from '../observers.js';
@@ -44,11 +44,7 @@ export declare function createCoordinatedAdProvider(input: {
     readonly result: AdShowResult;
   }) => void | Promise<void>;
 }): CoordinatedAdProvider;
-export interface PurchasePresentationEvent {
-  readonly idempotencyKey: string;
-  readonly sequence: number;
-  readonly state: 'open' | 'closed' | 'not-started' | 'unknown';
-}
+export type PurchasePresentationEvent = PlatformPurchasePresentationEvent;
 export interface CoordinatedPlatformGateway extends PlatformGateway {
   dispose(): void;
 }

package/dist/ads/index.js

@@ -475,7 +475,8 @@ export function createCoordinatedPlatformGateway(input) {
         }
         maybeDetach();
     }
-    const unsubscribe = input.purchasePresentation?.subscribe((event) => {
+    const purchasePresentation = input.purchasePresentation ?? input.gateway.commerce.presentation;
+    const unsubscribe = purchasePresentation?.subscribe((event) => {
         observe(() => {
             const flight = purchases.get(event.idempotencyKey);
             if (flight === undefined || !flight.called || flight.closed) {

package/dist/game/index.d.ts

@@ -27,6 +27,9 @@ export interface GamePlatformRuntime<T extends PlatformGateway = PlatformGateway
   readonly services: S;
   readonly actions?: GameActionCoordinator;
   createGameplayScope(): GameGameplayScope;
+  setLoadingProgress(progress: number): void;
+  /** Complete host loading before opening a play scene. Rejected starts remain blocked. */
+  completeLoading(): Promise<void>;
   /** Reconcile existing journal entries only; this method never opens platform UI. */
   reconcile(): Promise<void>;
   /** Game teardown; native observers and application-owned late recovery may continue. */
@@ -44,4 +47,6 @@ export declare function createGamePlatformRuntime<T extends PlatformGateway, S e
     subscribe(listener: (event: PurchasePresentationEvent) => void): () => void;
   };
   readonly onObserverError?: ObserverErrorHandler;
+  /** Must complete synchronously; asynchronous uploads belong at earlier checkpoints. */
+  readonly onExit?: () => void;
 }): GamePlatformRuntime<T, S>;

package/dist/game/index.js

@@ -39,6 +39,47 @@ export function createGamePlatformRuntime(input) {
     let actions;
     let unsubscribeResume;
     let disposed = false;
+    let unsubscribeExit;
+    let startupBlock = input.gateway.gameLoading === undefined
+        ? undefined
+        : execution.acquireBlock({
+            reason: 'game-runtime:loading',
+            channels: ['simulation', 'gameplay-input', 'audio'],
+        });
+    let loadingCompletion;
+    const setLoadingProgress = (progress) => {
+        if (!disposed && loadingCompletion === undefined) {
+            observe(() => gateway.gameLoading?.setProgress(Math.max(0, Math.min(100, Number(progress) || 0))), input.onObserverError);
+        }
+    };
+    const completeLoading = () => {
+        if (disposed) {
+            return Promise.reject(new Error('Game runtime is disposed.'));
+        }
+        if (loadingCompletion !== undefined) {
+            return loadingCompletion;
+        }
+        const attempt = Promise.resolve().then(async () => {
+            if (disposed) {
+                throw new Error('Game runtime is disposed.');
+            }
+            gateway.gameLoading?.setProgress(100);
+            await gateway.gameLoading?.complete();
+            if (disposed) {
+                throw new Error('Game runtime was disposed during loading.');
+            }
+            const owned = startupBlock;
+            startupBlock = undefined;
+            owned?.release();
+        });
+        loadingCompletion = attempt;
+        void attempt.catch(() => {
+            if (loadingCompletion === attempt) {
+                loadingCompletion = undefined;
+            }
+        });
+        return attempt;
+    };
     let hostAudio;
     let unsubscribeHostAudio;
     const gameplayScopes = new Map();
@@ -108,6 +149,7 @@ export function createGamePlatformRuntime(input) {
             }, input.onObserverError);
         }
         unsubscribeActivity?.();
+        unsubscribeExit?.();
         gameplayScopes.clear();
         execution.destroy();
         if (unsubscribeHostAudio !== undefined) {
@@ -156,6 +198,14 @@ export function createGamePlatformRuntime(input) {
             ...(input.onObserverError === undefined ? {} : { onError: input.onObserverError }),
         });
         unsubscribeResume = gateway.lifecycle.onResume(() => { observe(reconcile, input.onObserverError); });
+        unsubscribeExit = gateway.lifecycle.onExit?.(() => {
+            observe(() => input.onExit?.(), input.onObserverError);
+            dispose();
+        });
+        if (disposed) {
+            unsubscribeExit?.();
+            throw new Error('Game exited during runtime initialization.');
+        }
         const settings = gateway.gameSettings;
         if (settings !== undefined) {
             const updateMute = (muted) => {
@@ -182,6 +232,8 @@ export function createGamePlatformRuntime(input) {
             presentation,
             services,
             createGameplayScope,
+            setLoadingProgress,
+            completeLoading,
             ...(actions === undefined ? {} : { actions }),
             reconcile,
             dispose,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/game-runtime",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Gameplay execution, scoped UI and action coordination with optional Phaser scene bindings.",
   "license": "MIT",
   "keywords": [
@@ -64,8 +64,8 @@
     "@types/node": "^24.0.0"
   },
   "dependencies": {
-    "@mpgd/game-services": "0.18.1",
-    "@mpgd/platform": "0.16.0"
+    "@mpgd/game-services": "0.19.0",
+    "@mpgd/platform": "0.17.0"
   },
   "repository": {
     "type": "git",