@mpgd/capacitor-storekit 0.2.1 → 0.2.3

package/README.md

@@ -111,14 +111,19 @@ default) so the gateway serves the `commerce.v2.*` and v1 `commerce.*`
 bridge methods from it and exposes it as `gateway.commerceV2`.
 
 Finishing never grants. The v2 SDK finishes any transaction it is given a
-`ledgerEntryId` for: the commerce v2 reconciler is the gate, and it calls
-`finishTransaction` only after the backend ledger granted the purchase. The
-v1 `finishGrantedTransaction` allow-list guard is not reproduced; the real
-control stays server-side, in the verifier that checks the JWS before the
-ledger grant, and in the native plugin never granting anything on finish.
-The v1 recovery helpers (`recoverStoreKitPurchases`,
-`getRecoverableTransactions`, `finishGrantedTransaction`) are deprecated in
-favor of the single reconciler (RFC C1) and are removed in C4.
+`ledgerEntryId` for: the commerce v2 reconciler
+(`createCommerceReconciler` in `@mpgd/game-services`) is the gate, and it
+calls `finishTransaction` only for a journal record in `granted` or
+`finishing` that holds the ledger entry id the backend grant wrote
+(`assertCommerceFinishAllowed`). The v1 `finishGrantedTransaction`
+allow-list guard is not reproduced in the SDK: the journal revision the grant
+wrote is the pairing, and the real control stays server-side, in the verifier
+that checks the JWS before the ledger grant, and in the native plugin never
+granting anything on finish. The v1 recovery helpers
+(`recoverStoreKitPurchases`, `getRecoverableTransactions`,
+`finishGrantedTransaction`) are deprecated in favor of that reconciler (RFC
+C1) and are removed in C4; `src/commerce-reconciler-storekit-smoke.test.ts`
+shows both paths reaching the same outcomes over the fake plugin.
 
 The conformance test runs every store vector whose profile the App Store
 supports against a fake plugin, directly and through the gateway bridge path,
@@ -126,6 +131,27 @@ and lists each skipped vector with its reason (host or server finish,
 quantity, server-push, an asynchronous store error event StoreKit never
 emits, and a pending transaction state StoreKit never reports).
 
+### Generated games
+
+Games generated by `mpgd game create` (and the kit's private starter) ship
+this wiring in `src/platform/buildGateways/capacitorIos.ts` (commerce v2 PR
+C3): the service provider is registered for every catalog product whose
+`platformProductIds.ios` names an App Store product id (subscriptions are
+skipped), and `getAppAccountToken` is the reference binding in
+`src/platform/commerceAccountBinding.ts`, a UUID (version 5 layout) over the
+SHA-256 of `mpgd-commerce-account:<playerId>` for the authenticated player;
+a guest session throws, so no sheet opens without a binding. The backend's
+`resolveAppAccountToken` must derive the same UUID, or both are replaced
+together.
+
+`mpgd target init capacitor --providers storekit` installs this package into
+the game-owned shell and the game at one exact version and lets `cap add` or
+`cap sync` register its Swift package; on a game that still has the unwired
+gateway of an earlier template it also writes the wiring above. A build
+whose shell lacks the native plugin still runs: the plugin answers
+Capacitor's `UNIMPLEMENTED`, which the SDK reports as
+`configuration-required`, so no purchase sheet opens.
+
 ## v1 provider and recovery
 
 On startup, account restoration, and after a pending or uncertain checkout,

package/dist/store-sdk.js

@@ -396,7 +396,10 @@ export function createCapacitorStoreKitStoreSdk(input) {
             }
             catch (error) {
                 const code = isRecord(error) ? error.code : undefined;
-                return code === 'STOREKIT_INVALID_PRODUCTS' || code === 'STOREKIT_PRODUCT_UNAVAILABLE'
+                // Capacitor's `UNIMPLEMENTED` means the native plugin is not installed in the shell.
+                return code === 'STOREKIT_INVALID_PRODUCTS'
+                    || code === 'STOREKIT_PRODUCT_UNAVAILABLE'
+                    || code === 'UNIMPLEMENTED'
                     ? 'configuration-required'
                     : 'temporarily-unavailable';
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/capacitor-storekit",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Opt-in StoreKit 2 one-time purchase collector and commerce v2 provider for mpgd Capacitor games.",
   "license": "MIT",
   "repository": {
@@ -38,18 +38,18 @@
   ],
   "peerDependencies": {
     "@capacitor/core": "^8.5.1",
-    "@mpgd/adapter-capacitor": "^0.9.1",
-    "@mpgd/bridge": "^0.12.2",
-    "@mpgd/platform": "^0.21.0"
+    "@mpgd/adapter-capacitor": "^0.9.3",
+    "@mpgd/bridge": "^0.12.3",
+    "@mpgd/platform": "^0.22.0"
   },
   "devDependencies": {
     "@capacitor/core": "8.5.2",
     "ttsc": "0.30.4",
     "typescript": "7.0.2",
-    "@mpgd/adapter-capacitor": "0.9.1",
-    "@mpgd/bridge": "0.12.2",
-    "@mpgd/game-services": "0.21.1",
-    "@mpgd/platform": "0.21.0"
+    "@mpgd/adapter-capacitor": "0.9.3",
+    "@mpgd/platform": "0.22.0",
+    "@mpgd/game-services": "0.23.0",
+    "@mpgd/bridge": "0.12.3"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -59,6 +59,6 @@
   "scripts": {
     "check": "ttsc --noEmit",
     "lint": "ttsc --noEmit",
-    "test": "cd ../.. && node tools/run-ttsx.mjs --project native-plugins/capacitor-storekit/tsconfig.json native-plugins/capacitor-storekit/src/provider.test.ts && node tools/run-ttsx.mjs --project native-plugins/capacitor-storekit/tsconfig.json native-plugins/capacitor-storekit/src/store-sdk.test.ts && node tools/run-ttsx.mjs --project native-plugins/capacitor-storekit/tsconfig.json native-plugins/capacitor-storekit/src/commerce-provider.test.ts && node tools/run-ttsx.mjs --project native-plugins/capacitor-storekit/tsconfig.json native-plugins/capacitor-storekit/src/commerce-provider.conformance.test.ts"
+    "test": "cd ../.. && node tools/run-ttsx.mjs --project native-plugins/capacitor-storekit/tsconfig.json native-plugins/capacitor-storekit/src/provider.test.ts && node tools/run-ttsx.mjs --project native-plugins/capacitor-storekit/tsconfig.json native-plugins/capacitor-storekit/src/store-sdk.test.ts && node tools/run-ttsx.mjs --project native-plugins/capacitor-storekit/tsconfig.json native-plugins/capacitor-storekit/src/commerce-provider.test.ts && node tools/run-ttsx.mjs --project native-plugins/capacitor-storekit/tsconfig.json native-plugins/capacitor-storekit/src/commerce-provider.conformance.test.ts && node tools/run-ttsx.mjs --project native-plugins/capacitor-storekit/tsconfig.json native-plugins/capacitor-storekit/src/commerce-reconciler-storekit-smoke.test.ts"
   }
 }