@mpgd/game-services 0.29.0 → 0.30.0

package/dist/commerce-reconciler.js

@@ -461,22 +461,49 @@ export function createCommerceReconciler(input) {
         trigger();
         scheduleRun();
     };
-    const readAvailable = async (capabilitiesNow) => {
+    /**
+     * Reads the store's available purchases into the inbox. `restore` is the
+     * player's Restore Purchases read only: the store also lists owned
+     * non-consumables its recovery list hides (acknowledged on Play, bound to
+     * another guest's token on StoreKit), so a reinstall or a new device can
+     * restore them. Startup and resume recovery never set it, so an
+     * acknowledged durable is not sent again on every launch.
+     */
+    const readAvailable = async (capabilitiesNow, restore = false) => {
         if (!capabilitiesNow.lifecycle.availablePurchases) {
             return true;
         }
-        try {
+        const read = async (withRestore) => {
             const available = await provider.getAvailablePurchases({
                 includePending: capabilitiesNow.lifecycle.pending,
+                ...(withRestore ? { restore: true } : {}),
             });
             for (const purchase of available) {
                 inbox.push({ type: 'purchaseUpdated', purchase });
             }
+        };
+        try {
+            await read(restore);
             return true;
         }
         catch (error) {
+            if (!restore) {
+                fail('available', error);
+                return false;
+            }
+            // A failed restore read still makes the recovery read, so Restore
+            // Purchases never finds less than a recovery pass: a bridge host built
+            // before `restore` rejects the field, and a store may fail only the
+            // wider read. The restore failure is still reported.
             fail('available', error);
-            return false;
+            try {
+                await read(false);
+                return true;
+            }
+            catch (fallbackError) {
+                fail('available', fallbackError);
+                return false;
+            }
         }
     };
     const buildRequest = (record) => {
@@ -852,7 +879,8 @@ export function createCommerceReconciler(input) {
         // read again until it succeeds, so a purchase that predates the
         // subscription is not missed for the session.
         if (capabilitiesNow !== undefined && (!capabilitiesNow.lifecycle.events || initialScanPending)) {
-            initialScanPending = !(await readAvailable(capabilitiesNow)) && capabilitiesNow.lifecycle.events;
+            initialScanPending = !(await readAvailable(capabilitiesNow, options.restore === true))
+                && capabilitiesNow.lifecycle.events;
         }
         // An event for a product whose store call is still running waits for that
         // call to journal the store answer: matched then, it is never journaled
@@ -1297,11 +1325,18 @@ export function createCommerceReconciler(input) {
                     await loadRecords();
                 }
                 const capabilitiesNow = await readCapabilities(true);
-                // A polled provider is read by the pass itself.
+                // A polled provider is read by the pass itself. Either read is a
+                // restore read: owned non-consumables the store's recovery list
+                // hides (a reinstall, a new device) reach the backend as restores.
+                let restoreRead = false;
                 if (capabilitiesNow !== undefined && capabilitiesNow.lifecycle.events) {
-                    await readAvailable(capabilitiesNow);
+                    restoreRead = await readAvailable(capabilitiesNow, true);
+                    if (restoreRead) {
+                        // This read covers a start-time read that failed.
+                        initialScanPending = false;
+                    }
                 }
-                await pass({ explicit: true, refreshCapabilities: false });
+                await pass({ explicit: true, refreshCapabilities: false, restore: !restoreRead });
             });
             await runUntilIdle();
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/game-services",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "description": "Client, contract, server, store, and test helpers for authoritative mpgd game services.",
   "license": "MIT",
   "repository": {
@@ -231,9 +231,9 @@
     "@orpc/client": "2.0.0-beta.14",
     "@orpc/contract": "2.0.0-beta.14",
     "@orpc/server": "2.0.0-beta.14",
-    "@mpgd/analytics": "0.5.2",
-    "@mpgd/platform": "0.29.0",
-    "@mpgd/catalog": "0.11.0"
+    "@mpgd/catalog": "0.11.1",
+    "@mpgd/platform": "0.30.0",
+    "@mpgd/analytics": "0.5.3"
   },
   "peerDependencies": {
     "@apple/app-store-server-library": "^3.1.0"