@chipmobilesdk/rn-payment 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -7,6 +7,29 @@ product keys, error codes, event names, state values, message keys, and the
 public API shape are this package's contract: renaming any of them is a breaking
 change.
 
+## [0.2.1] — 2026-10-12
+
+Patch release. **Upgrade before shipping**: on a device, `0.2.0` and earlier persisted
+nothing.
+
+### Fixed
+
+- **The purchase snapshot never reached the device's storage.** The store opened MMKV
+  with `new MMKV()`, the react-native-mmkv **v3** constructor. In v4 — the only major the
+  peer range (`>=4.0.0`) allows — `MMKV` is a type, not a value, so the call threw and the
+  store fell back to memory on every device. Consequences: entitlements read `unknown`
+  after every cold start until a sync, an owner with no connection stayed `unknown`, and a
+  pending purchase was forgotten after an app kill. The store now uses v4's `createMMKV`
+  and `remove`. Found on an emulator: the app's `files/mmkv` held no
+  `chipmobilesdk.payment` instance.
+- The engine did report the fallback, as a `config_warning` ("Local storage
+  unavailable"), but nothing in the tests could trigger it: the repository's test double
+  exported a v3 `MMKV` class. The double now mirrors v4 exactly, and the persistence suite
+  fails against the old code.
+
+No API, storage format or behaviour change otherwise. Records written by a working
+install are read as before; there were none from `0.2.0` on a device to migrate.
+
 ## [0.2.0] — 2026-10-12
 
 Additive minor release closing one gap that surfaced when `0.1.0` met an app that

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@chipmobilesdk/rn-payment",
-	"version": "0.2.0",
+	"version": "0.2.1",
 	"private": false,
 	"license": "UNLICENSED",
 	"description": "Reusable in-app payment and entitlement capability for ChipMobileSdk React Native apps",

package/skills/sdk-rn-payment/SKILL.md

@@ -3,7 +3,7 @@ name: sdk-rn-payment
 description: "In-app payments via @chipmobilesdk/rn-payment: Play Billing one-time/consumable/subscription behind a store-neutral contract, entitlement keys with a required unknown state, pending purchases visible across sessions, guaranteed transaction finalization, per-environment production-transaction blocking. Use when selling a feature, gating on an entitlement, showing a payment still pending after a restart, debugging a purchase that returns environment_blocked or an entitlement stuck at unknown, mapping Play products to entitlement keys, or answering a Data safety question about purchases."
 metadata:
   package: "@chipmobilesdk/rn-payment"
-  packageVersion: "0.2.0"
+  packageVersion: "0.2.1"
 user-invocable: true
 disable-model-invocation: false
 ---

package/src/persistence/mmkv-store.ts

@@ -23,10 +23,11 @@ import {
 const INSTANCE_ID = 'chipmobilesdk.payment';
 const KEY_PREFIX = 'snapshot';
 
+/** The slice of a react-native-mmkv v4 instance this store uses (v4 names). */
 interface MmkvLike {
 	getString(key: string): string | undefined;
 	set(key: string, value: string): void;
-	delete(key: string): void;
+	remove(key: string): unknown;
 	clearAll(): void;
 	getAllKeys(): string[];
 }
@@ -54,21 +55,28 @@ function createMemoryBacking(): MmkvLike {
 		set(key, value) {
 			map.set(key, value);
 		},
-		delete(key) {
-			map.delete(key);
-		},
+		remove: key => map.delete(key),
 		clearAll: () => map.clear(),
 		getAllKeys: () => [...map.keys()],
 	};
 }
 
+/**
+ * Opens the MMKV instance through v4's `createMMKV`.
+ *
+ * Up to 0.2.0 this called `new MMKV()`, the v3 constructor. In v4 — the only
+ * major the peer range allows — `MMKV` is a type, not a value, so the call threw
+ * and the store fell back to memory on every device: entitlements read `unknown`
+ * after each cold start, and a pending purchase was forgotten after an app kill.
+ * Tests could not see it, because the test double still exported a v3 class.
+ */
 function resolveBacking(): { backing: MmkvLike; durable: boolean } {
 	try {
 		// Required lazily so the package loads where the native module is absent.
-		const mod = require('react-native-mmkv') as {
-			MMKV: new (config?: { id?: string }) => MmkvLike;
+		const { createMMKV } = require('react-native-mmkv') as {
+			createMMKV: (config?: { id?: string }) => MmkvLike;
 		};
-		return { backing: new mod.MMKV({ id: INSTANCE_ID }), durable: true };
+		return { backing: createMMKV({ id: INSTANCE_ID }), durable: true };
 	} catch {
 		return { backing: createMemoryBacking(), durable: false };
 	}
@@ -132,7 +140,7 @@ export function createSnapshotStore(
 			try {
 				for (const key of backing.getAllKeys()) {
 					if (key.startsWith(`${KEY_PREFIX}:`)) {
-						backing.delete(key);
+						backing.remove(key);
 					}
 				}
 			} catch {