@mpgd/capacitor-play-billing 0.2.1 → 0.2.3

package/README.md

@@ -122,6 +122,27 @@ discarded. The plugin still never acknowledges or consumes;
 `isAcknowledged: false` on a purchased entry marks it unfinished for the
 backend finalizer.
 
+### Generated games
+
+Games generated by `mpgd game create` (and the kit's private starter) ship
+this wiring in `src/platform/buildGateways/capacitorAndroid.ts` (commerce v2
+PR C3): the service provider is registered for every catalog product whose
+`platformProductIds.android` names a Play SKU (subscriptions are skipped),
+and `accountBinding` is the reference binding in
+`src/platform/commerceAccountBinding.ts`, the 64-character hex SHA-256 of
+`mpgd-commerce-account:<playerId>` for the authenticated player (a guest
+session binds nothing, so the purchase is refused with
+`ACCOUNT_BINDING_REQUIRED`). The backend's `resolveObfuscatedAccountId`
+must derive the same value, or both are replaced together.
+
+`mpgd target init capacitor --providers play-billing` installs this package
+into the game-owned shell and the game at one exact version and lets
+`cap add` or `cap sync` register its native module; 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 module still runs: the plugin answers
+Capacitor's `UNIMPLEMENTED`, which the SDK reports as
+`configuration-required`, so no purchase UI opens.
+
 ### Migrating from the v1 provider
 
 `createCapacitorPlayBillingProvider` and `recoverOwnedPlayPurchases` are
@@ -132,9 +153,13 @@ into an `accountBinding` resolver returning `{ kind: 'obfuscated-account-id',
 value }`, rename `id`/`storeId`/`type` to `logicalId`/`storeSku`/`kind`
 (`non_consumable` becomes `durable`) and `offerToken` to `offerId`, and stop
 calling `recoverOwnedPlayPurchases`: it is deprecated in favour of the single
-reconciler landing in `@mpgd/game-services` (PR C1), which reads
-`getAvailablePurchases` and `purchaseUpdated` from `gateway.commerceV2`. The
-backend contract is unchanged, since the evidence payload is the same.
+reconciler in `@mpgd/game-services` (`createCommerceReconciler`, behind
+`createGameServicesClient` and `monetizationRecovery.reconcile()` whenever
+`gateway.commerceV2` exists), which reads `getAvailablePurchases` and
+`purchaseUpdated` from the provider and verifies each purchase under the same
+`play-token-sha256` key. The backend contract is unchanged, since the
+evidence payload is the same; `src/commerce-reconciler-play-smoke.test.ts`
+shows both paths reaching the same outcomes over the fake plugin.
 
 ## v1 provider
 

package/dist/store-sdk.js

@@ -42,6 +42,8 @@ const obfuscatedAccountIdPattern = /^[A-Za-z0-9._-]{1,64}$/u;
 const maximumProducts = 100;
 const maximumPurchaseTimeMillis = 8_640_000_000_000_000;
 const configurationErrorCodes = new Set([
+    // Capacitor's `UNIMPLEMENTED`: the native plugin is not installed in the shell.
+    'UNIMPLEMENTED',
     'PLAY_BILLING_CONFIGURATION_ERROR',
     'PLAY_BILLING_PRODUCT_UNAVAILABLE',
     'PLAY_BILLING_OFFER_REQUIRED',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mpgd/capacitor-play-billing",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Opt-in Android Google Play Billing purchase collector for mpgd Capacitor games.",
   "license": "MIT",
   "repository": {
@@ -38,9 +38,9 @@
   ],
   "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",
@@ -48,10 +48,10 @@
     "ttsc": "0.30.4",
     "typescript": "7.0.2",
     "vitest": "^4.0.0",
-    "@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/bridge": "0.12.3",
+    "@mpgd/platform": "0.22.0",
+    "@mpgd/game-services": "0.23.0"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",