@chipmobilesdk/rn-payment 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,116 @@
 # @chipmobilesdk/rn-payment
 
+## 0.7.0
+
+### Minor Changes
+
+- Every package now ships built JavaScript with declaration files, instead of asking the
+  app to compile its TypeScript. ([#22](https://github.com/operationd8979/chip-mobile-sdk/pull/22))
+
+  Each tarball carries `lib/commonjs`, `lib/module` and `lib/typescript` (built with
+  `react-native-builder-bob`), and `src/` alongside them. What that changes for a
+  consumer:
+
+  - **Nothing to add to `transformIgnorePatterns`.** `require` resolves to the CommonJS
+    build, so an app's Jest loads this package without being told to transform it. That
+    was the one thing every consuming app had to know about us (DEP-04).
+  - **Typechecking reads our `.d.ts`** rather than compiling our source under our
+    `tsconfig`. A consumer's stricter — or looser — settings no longer meet our code.
+  - **`import` resolves to ESM**, so a bundler can tree-shake what it does not use.
+
+  No exported name changed, and no subpath moved: `.`, `./testing`, `./push`,
+  `./advanced`, `./app-auth`, `./keychain` and rn-core's twelve subpaths resolve exactly
+  as before, each now with its own declarations for both module systems. publint and
+  `attw --profile node16` pass on all twelve packages, which they could not before.
+
+  Inside the monorepo nothing changed either, and that is deliberate: every subpath also
+  declares a private `chipmobilesdk-source` condition pointing at its TypeScript, and
+  Metro, Jest and `tsc` here ask for that condition first. The demo app bundles 371
+  modules straight from `packages/*/src`, so editing a package still changes the app with
+  no build step, and coverage is still measured on the source. The condition is named for
+  this organization rather than using the conventional `source` because third-party
+  packages declare that one too — `@dr.pogodin/react-native-fs` does — and asking for it
+  pulled their sources into our stricter compile.
+
+  `npm run build:packages` builds everything, `prepack` rebuilds before any `npm pack`,
+  and `lib/` is git-ignored: the published bytes are produced by the release, never
+  committed. `npm run check:manifests` now fails a package whose `main`, `module`,
+  `types`, `source` condition, `files`, build script or `prepack` do not match this shape.
+
+### Patch Changes
+
+- Every peer range has an upper bound, and no package declares a peer it does not use. ([#21](https://github.com/operationd8979/chip-mobile-sdk/pull/21))
+
+  A peer range is now a caret, a tilde or an explicit `<`, except for `react` and
+  `react-native`: an app brings exactly one of each, so a floor is the only useful thing
+  to say about them. Every other peer is a library the app installs beside us, and an
+  open `>=` was a promise about versions nobody had run — mmkv 3→4 lost entitlements and
+  pending purchases exactly that way.
+
+  **Four of the new ceilings exclude a version that is already published**, so an app
+  that took the open range at its word may now see a peer warning. The new bound is the
+  major this release is tested against, which is the thing the old range failed to say:
+
+  | Peer | Was | Now | Published above the ceiling |
+  |---|---|---|---|
+  | `react-native-app-auth` (rn-auth) | `>=8` | `^8.0.0` | 9.0.0 |
+  | `react-native-keychain` (rn-auth) | `>=10` | `^10.0.0` | 11.0.0 |
+  | `@op-engineering/op-sqlite` (rn-local-db) | `>=17.1.0` | `^17.1.0` | 18.x, 19.x |
+  | `@react-native-firebase/messaging` (rn-notification) | `>=26.0.0` | `^26.0.0` | 27.x |
+
+  The others — `react-native-vision-camera` `^5.1.1`, `react-native-svg` `^15.15.0`,
+  `react-native-unistyles` `^3.2.0`, `@dr.pogodin/react-native-fs` `^2.39.2`,
+  `react-native-quick-crypto` `^1.0.0`, `react-native-notify-kit` `^10.5.0`,
+  `react-native-localize` `^3.7.0`, `react-native-mmkv` `^4.0.0` — exclude nothing that
+  exists today. rn-payment's mmkv range was already bounded (`>=4.0.0 <5`) and is now
+  written as the caret that means the same thing.
+
+  Peers nothing imports are gone. `rn-theme`, `rn-local-db` and `rn-notification` asked
+  for `react` without having a component or a hook between them; `rn-auth`, `rn-ai` and
+  `rn-i18n` asked for `react-native` without touching a React Native API (rn-auth reaches
+  both native modules through `lazyPeer`, rn-i18n formats on `Intl`); `rn-notification`
+  asked for `@react-native-firebase/app`, which messaging declares itself. `rn-ai` no
+  longer peers on `@chipmobilesdk/rn-auth` at all — it asks for a `TokenProvider`, a
+  two-method interface rn-auth's `auth` satisfies, so an app with its own token source
+  installs nothing extra. An app that enables push or signs in through rn-auth installs
+  the same packages as before; it is the manifest that stopped overstating.
+
+  `react-native-localize` is declared optional, which is what the code already did: the
+  time-zone reader goes through `lazyPeer` and falls back to `Intl` without it. The
+  `peerDependenciesMeta` entries that said `optional: false` are gone — that is npm's
+  default, and writing it down only invited the question of which peers were undecided.
+
+  `npm run check:manifests` now fails on an unbounded peer range, a peer nothing in
+  `src/` imports, and a `peerDependenciesMeta` entry for either, so the policy holds
+  without anyone remembering it.
+
+- Each package's public API and its weight are now recorded in the repository, so a change
+  to either is reviewed rather than discovered. ([#23](https://github.com/operationd8979/chip-mobile-sdk/pull/23))
+
+  `packages/<pkg>/etc/*.api.md` is an api-extractor report per entrypoint — twenty-seven
+  of them, generated from the declarations the package publishes and committed. A renamed
+  type, a widened union, one more optional field: all of it shows up in a pull request's
+  diff. `npm run check:api` fails when a report is out of date and `npm run api:update`
+  rewrites them.
+
+  A report that moves now needs a **minor or major** changeset for that package.
+  `check:changesets` enforces it, because the report is generated from what the package
+  publishes, and a patch release that moves the public surface is how a consumer's build
+  breaks on `npm update`. A report added for the first time is a baseline, not a change.
+  `./testing` deliberately has no report: test doubles are not a surface a release is
+  gated on.
+
+  `npm run check:size` holds every entrypoint to a budget in `.size-limit.json`, measured
+  on the ESM build with peers and rn-core treated as external — they are what an app
+  installs beside us, not our weight. Each budget started at today's measurement plus five
+  per cent, so growth becomes a decision someone makes instead of a drift nobody sees. The
+  current figures run from 500 B (`rn-core/lazy`) to 19 kB (rn-notification).
+
+  No behaviour or API changed in this release; the entry is here so the changelog records
+  when the reports and the budgets began.
+- Updated dependencies ([#22](https://github.com/operationd8979/chip-mobile-sdk/pull/22), [#23](https://github.com/operationd8979/chip-mobile-sdk/pull/23)):
+  - @chipmobilesdk/rn-core@0.2.0
+
 ## 0.6.0
 
 ### Minor Changes

package/README.md

@@ -115,7 +115,7 @@ Verified against this repository's toolchain, not assumed:
 | Android `minSdk` / `compileSdk` / `targetSdk` | 24 / 36 / 36 |
 | Kotlin | 2.1.20 |
 | `react-native-iap` | >= 16.7.3 < 17 (verified 16.7.3) |
-| `react-native-mmkv` | >= 4.0.0 < 5 (the store uses v4's `createMMKV`) |
+| `react-native-mmkv` | `^4.0.0` (the store uses v4's `createMMKV`) |
 | `react-native-nitro-modules` | as required by `react-native-iap` (not a peer of this package) |
 
 **Why the `react-native-iap` ceiling is the next major.** Both the Nitro peer

package/lib/commonjs/adapter/createStoreProvider.js

@@ -0,0 +1,110 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createStoreProvider = createStoreProvider;
+exports.createUnsupportedProvider = createUnsupportedProvider;
+var _reactNative = require("react-native");
+var _iapAdapter = require("./iap-adapter.js");
+/**
+ * Platform selection for the store adapter.
+ *
+ * This exists so the public surface never names a store. An app writes
+ * `createStoreProvider()`, not `createIapAdapter()` — the same call will pick the
+ * StoreKit adapter once iOS exists, and no consumer line changes (FR-002, FR-004,
+ * FR-007).
+ *
+ * On a platform with no adapter the result is a stub that reports
+ * `platform_unsupported` rather than throwing. That is what lets a host app start
+ * and run normally where selling is impossible, losing only the ability to sell
+ * (FR-021, FR-023).
+ */
+
+const UNSUPPORTED_CAPABILITIES = {
+  supportsSubscriptions: false,
+  supportsPlanChange: false,
+  supportsPriceChangeConfirmation: false,
+  reportsGraceAndHoldDistinctly: false,
+  supportsExternalTransactions: false,
+  /** Nothing here can charge anyone, so the environment guard has nothing to block. */
+  createsRealTransactions: false,
+  purchaseOutcomeIncludesStoreTime: false
+};
+
+/**
+ * The no-adapter stub.
+ *
+ * Every operation fails safely and predictably. Notably `queryOwned` returns an
+ * empty list rather than throwing: the engine then computes `not_entitled` after a
+ * successful-but-empty sync, which is honest — on a platform with no store, the
+ * user genuinely holds nothing this package can verify.
+ */
+function createUnsupportedProvider() {
+  return {
+    async connect() {
+      return {
+        ok: false,
+        reason: 'platform_unsupported',
+        retryable: false
+      };
+    },
+    async disconnect() {
+      // Nothing was ever connected.
+    },
+    observeConnection() {
+      return () => undefined;
+    },
+    async queryProducts() {
+      return [];
+    },
+    async queryOwned() {
+      return [];
+    },
+    async launchPurchase() {
+      return {
+        ok: false,
+        reason: 'not_ready',
+        detail: 'platform_unsupported'
+      };
+    },
+    observePurchases() {
+      return () => undefined;
+    },
+    async acknowledge() {
+      // No transaction can exist to acknowledge.
+    },
+    async consume() {
+      // As above.
+    },
+    async openSubscriptionManagement() {
+      // No store screen to open.
+    },
+    async confirmPriceChange() {
+      return {
+        ok: false,
+        reason: 'not_ready'
+      };
+    },
+    capabilities: () => UNSUPPORTED_CAPABILITIES
+  };
+}
+/**
+ * The platform's store adapter.
+ *
+ * iOS deliberately returns the stub today rather than throwing: the contract is
+ * prepared for StoreKit, the implementation is not, and an app running on iOS
+ * should degrade to "cannot sell here" instead of crashing.
+ */
+function createStoreProvider(options = {}) {
+  if (options.forceUnsupported) {
+    return createUnsupportedProvider();
+  }
+  if (_reactNative.Platform.OS === 'android') {
+    return (0, _iapAdapter.createIapAdapter)();
+  }
+  return createUnsupportedProvider();
+}
+
+/** Exported for a test or a screen that needs the stub explicitly. */
+//# sourceMappingURL=createStoreProvider.js.map

package/lib/commonjs/adapter/createStoreProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","_iapAdapter","UNSUPPORTED_CAPABILITIES","supportsSubscriptions","supportsPlanChange","supportsPriceChangeConfirmation","reportsGraceAndHoldDistinctly","supportsExternalTransactions","createsRealTransactions","purchaseOutcomeIncludesStoreTime","createUnsupportedProvider","connect","ok","reason","retryable","disconnect","observeConnection","undefined","queryProducts","queryOwned","launchPurchase","detail","observePurchases","acknowledge","consume","openSubscriptionManagement","confirmPriceChange","capabilities","createStoreProvider","options","forceUnsupported","Platform","OS","createIapAdapter"],"sourceRoot":"../../../src","sources":["adapter/createStoreProvider.ts"],"mappings":";;;;;;;AAcA,IAAAA,YAAA,GAAAC,OAAA;AAEA,IAAAC,WAAA,GAAAD,OAAA;AAhBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAeA,MAAME,wBAA8C,GAAG;EACtDC,qBAAqB,EAAE,KAAK;EAC5BC,kBAAkB,EAAE,KAAK;EACzBC,+BAA+B,EAAE,KAAK;EACtCC,6BAA6B,EAAE,KAAK;EACpCC,4BAA4B,EAAE,KAAK;EACnC;EACAC,uBAAuB,EAAE,KAAK;EAC9BC,gCAAgC,EAAE;AACnC,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,yBAAyBA,CAAA,EAAiB;EAClD,OAAO;IACN,MAAMC,OAAOA,CAAA,EAAoC;MAChD,OAAO;QAAEC,EAAE,EAAE,KAAK;QAAEC,MAAM,EAAE,sBAAsB;QAAEC,SAAS,EAAE;MAAM,CAAC;IACvE,CAAC;IACD,MAAMC,UAAUA,CAAA,EAAkB;MACjC;IAAA,CACA;IACDC,iBAAiBA,CAAA,EAAgB;MAChC,OAAO,MAAMC,SAAS;IACvB,CAAC;IACD,MAAMC,aAAaA,CAAA,EAA+B;MACjD,OAAO,EAAE;IACV,CAAC;IACD,MAAMC,UAAUA,CAAA,EAAgC;MAC/C,OAAO,EAAE;IACV,CAAC;IACD,MAAMC,cAAcA,CAAA,EAAqC;MACxD,OAAO;QAAER,EAAE,EAAE,KAAK;QAAEC,MAAM,EAAE,WAAW;QAAEQ,MAAM,EAAE;MAAuB,CAAC;IAC1E,CAAC;IACDC,gBAAgBA,CAAA,EAAgB;MAC/B,OAAO,MAAML,SAAS;IACvB,CAAC;IACD,MAAMM,WAAWA,CAAA,EAAkB;MAClC;IAAA,CACA;IACD,MAAMC,OAAOA,CAAA,EAAkB;MAC9B;IAAA,CACA;IACD,MAAMC,0BAA0BA,CAAA,EAAkB;MACjD;IAAA,CACA;IACD,MAAMC,kBAAkBA,CAAA,EAAwC;MAC/D,OAAO;QAAEd,EAAE,EAAE,KAAK;QAAEC,MAAM,EAAE;MAAY,CAAC;IAC1C,CAAC;IACDc,YAAY,EAAEA,CAAA,KAAMzB;EACrB,CAAC;AACF;AAYA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS0B,mBAAmBA,CAACC,OAA6B,GAAG,CAAC,CAAC,EAAgB;EACrF,IAAIA,OAAO,CAACC,gBAAgB,EAAE;IAC7B,OAAOpB,yBAAyB,CAAC,CAAC;EACnC;EACA,IAAIqB,qBAAQ,CAACC,EAAE,KAAK,SAAS,EAAE;IAC9B,OAAO,IAAAC,4BAAgB,EAAC,CAAC;EAC1B;EACA,OAAOvB,yBAAyB,CAAC,CAAC;AACnC;;AAEA","ignoreList":[]}

package/lib/commonjs/adapter/iap-adapter.js

@@ -0,0 +1,393 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createIapAdapter = createIapAdapter;
+Object.defineProperty(exports, "toProviderPurchaseState", {
+  enumerable: true,
+  get: function () {
+    return _iapShapes.toProviderPurchaseState;
+  }
+});
+exports.toRequestProps = toRequestProps;
+var _rnCore = require("@chipmobilesdk/rn-core");
+var _iapShapes = require("./iapShapes.js");
+var _errors = require("../diagnostics/errors.js");
+/**
+ * Android adapter over `react-native-iap` (Play Billing).
+ *
+ * **The only file in this package that touches the billing library.** Everything
+ * above it talks to `ProviderPort`, which is what keeps the binding replaceable
+ * and lets an iOS adapter be added without changing a consumer call (FR-002,
+ * FR-007). ESLint enforces that boundary.
+ *
+ * ## Verified against react-native-iap 16.7.3
+ *
+ * 0.3.0 was written before the binding was installed, from its documentation, and
+ * no purchase could complete on a device. Checked against the installed 16.7.3
+ * source for 0.3.1, two facts shape the purchase path:
+ *
+ * - The request is keyed by store: `google` / `apple`. 0.3.0 sent `android`, which
+ *   the binding rejects (`empty-sku-list`) before Play opens. The request type is
+ *   now the binding's own `RequestPurchaseProps`, so a renamed key fails to
+ *   typecheck here instead of failing on a user's device.
+ * - On Android `requestPurchase` resolves with an **empty list** once the flow
+ *   ends, whatever happened. The outcome (bought, pending, cancelled, failed)
+ *   arrives only through `purchaseUpdatedListener` / `purchaseErrorListener`, so
+ *   `launchPurchase` waits for those events.
+ *
+ * The module is still required lazily, and `IapModule` still names exactly the
+ * surface used. `__tests__/iap-adapter.test.ts` drives this file through a fake
+ * binding that behaves as 16.7.3 does; the rest of the suite uses the fake store.
+ *
+ * ## Known upstream defect this guards against
+ *
+ * openiap#408: the Android bridge did not clear its internal `isInitialized` flag
+ * on disconnect, so `connected` stayed true, later calls failed with
+ * `E_NOT_PREPARED`, and `reconnect()` reported success without rebuilding
+ * anything. This adapter therefore (a) tracks connection state itself rather than
+ * trusting the binding's flag, and (b) always performs a full
+ * `endConnection` + `initConnection` cycle instead of calling any reconnect
+ * shortcut.
+ */
+
+// Translation lives in `iapShapes`; it is published from here, where every
+// consumer has always imported it from.
+
+/**
+ * Exactly what this adapter needs from the binding.
+ *
+ * Declared narrowly on purpose: it documents the coupling, and it means a binding
+ * upgrade that changes one of these shapes fails to typecheck here instead of
+ * failing silently at runtime on a user's device.
+ */
+
+/**
+ * How long to wait for the outcome event after `requestPurchase` has resolved.
+ * The binding emits the event before or as it resolves, so this only bounds the
+ * case where none ever comes; it never runs while the user is in Play's UI.
+ */
+const RESULT_EVENT_GRACE_MS = 2_000;
+
+/** Play's replacement modes, by the codes the engine passes (`engine/subscriptions.ts`). */
+const REPLACEMENT_MODES = {
+  WITH_TIME_PRORATION: 'with-time-proration',
+  CHARGE_FULL_PRICE: 'charge-full-price',
+  CHARGE_PRORATED_PRICE: 'charge-prorated-price',
+  DEFERRED: 'deferred'
+};
+
+/** The request in the binding's 16.7 shape: keyed `google`, not `android`. */
+function toRequestProps(request) {
+  const google = {
+    skus: [request.storeProductId],
+    ...(request.obfuscatedAccountId ? {
+      obfuscatedAccountId: request.obfuscatedAccountId
+    } : {})
+  };
+  if (request.productType !== 'subscription') {
+    return {
+      request: {
+        google
+      },
+      type: 'in-app'
+    };
+  }
+  const replacementMode = request.prorationMode ? REPLACEMENT_MODES[request.prorationMode] : undefined;
+  return {
+    request: {
+      google: {
+        ...google,
+        ...(request.offerKey ? {
+          subscriptionOffers: [{
+            sku: request.storeProductId,
+            offerToken: request.offerKey
+          }]
+        } : {}),
+        // A plan change: the token of the purchase being replaced, and — for
+        // the replacement mode to apply — its product id (Billing 8.1+).
+        ...(request.replacePurchaseToken ? {
+          purchaseToken: request.replacePurchaseToken
+        } : {}),
+        ...(request.replacePurchaseToken && request.replaceStoreProductId && replacementMode ? {
+          subscriptionProductReplacementParams: {
+            oldProductId: request.replaceStoreProductId,
+            replacementMode
+          }
+        } : {})
+      }
+    },
+    type: 'subs'
+  };
+}
+const iapPeer = (0, _rnCore.lazyPeer)('react-native-iap', () => {
+  // Inside `try`, so Metro bundles an app that leaves this optional peer out.
+  try {
+    return require('react-native-iap');
+  } catch (cause) {
+    throw cause;
+  }
+});
+function loadModule() {
+  return iapPeer.require((peer, cause) => new _errors.PaymentError({
+    code: 'PAYMENT_UNAVAILABLE',
+    message: `${peer} is not installed or its native module is not linked`,
+    operation: 'initialize',
+    cause: (0, _errors.redact)(cause)
+  }));
+}
+const ANDROID_CAPABILITIES = {
+  supportsSubscriptions: true,
+  supportsPlanChange: true,
+  supportsPriceChangeConfirmation: false,
+  /**
+   * False, and this is a platform fact rather than a gap in this adapter.
+   *
+   * Client-side Play Billing cannot separate grace period from account hold: a
+   * grace-period subscription is still returned as active, and one in account
+   * hold stops being returned at all — indistinguishable from expired, cancelled,
+   * or refunded. The entitlement layer reads this flag and reports
+   * `indeterminate` rather than inventing a distinction (research.md R5).
+   */
+  reportsGraceAndHoldDistinctly: false,
+  supportsExternalTransactions: false,
+  /** This one really does move money, which is what arms the environment guard. */
+  createsRealTransactions: true,
+  /** The outcome event comes only when the user leaves Play's purchase UI. */
+  purchaseOutcomeIncludesStoreTime: true
+};
+function createIapAdapter(options = {}) {
+  let iap = options.module;
+
+  /** Tracked here, never read from the binding — see the openiap#408 note above. */
+  let connected = false;
+  const connectionListeners = (0, _rnCore.createListenerSet)();
+  const purchaseListeners = (0, _rnCore.createListenerSet)();
+  /** Only an in-flight `launchPurchase` listens here; see there. */
+  const purchaseErrorListeners = (0, _rnCore.createListenerSet)();
+  let updateSub;
+  let errorSub;
+  const module = () => {
+    if (!iap) {
+      iap = loadModule();
+    }
+    return iap;
+  };
+  const notifyConnection = (next, reason) => {
+    if (connected === next) {
+      return;
+    }
+    connected = next;
+    connectionListeners.notify(next, reason);
+  };
+  const attachListeners = () => {
+    // Every connect attaches, so whatever an earlier connect left must go first.
+    // Overwriting the handles orphaned the old native listeners, which kept
+    // firing — every purchase update reached the engine once per connect.
+    detachListeners();
+    const mod = module();
+    updateSub = mod.purchaseUpdatedListener(raw => {
+      purchaseListeners.notify((0, _iapShapes.normalizePurchase)(raw));
+    });
+    errorSub = mod.purchaseErrorListener(error => {
+      // A `not-prepared` error is the one signal the binding gives that the
+      // service went away underneath us, so it is treated as a disconnect
+      // rather than as a purchase failure.
+      if ((0, _iapShapes.mapErrorCode)(error.code) === 'not_ready') {
+        notifyConnection(false, 'not_prepared');
+      }
+      purchaseErrorListeners.notify(error);
+    });
+  };
+  const detachListeners = () => {
+    updateSub?.remove();
+    updateSub = undefined;
+    errorSub?.remove();
+    errorSub = undefined;
+  };
+  return {
+    async connect() {
+      try {
+        const mod = module();
+        // Always a full cycle. The binding's own reconnect has reported success
+        // without rebuilding anything, so we never rely on it (openiap#408).
+        if (connected) {
+          await mod.endConnection().catch(() => undefined);
+          connected = false;
+        }
+        const ok = await mod.initConnection();
+        if (!ok) {
+          return {
+            ok: false,
+            reason: 'no_billing_service',
+            retryable: true
+          };
+        }
+        attachListeners();
+        notifyConnection(true);
+        return {
+          ok: true
+        };
+      } catch (error) {
+        const code = error.code;
+        // A missing or too-old Play Services install is not the same as a
+        // transient error, and the app shows different things for each (FR-021).
+        if (code === 'E_IAP_NOT_AVAILABLE' || code === 'iap-not-available') {
+          return {
+            ok: false,
+            reason: 'no_billing_service',
+            retryable: false
+          };
+        }
+        if (code === 'E_SERVICE_ERROR') {
+          return {
+            ok: false,
+            reason: 'billing_service_outdated',
+            retryable: true
+          };
+        }
+        return {
+          ok: false,
+          reason: 'store_error',
+          retryable: true
+        };
+      }
+    },
+    async disconnect() {
+      detachListeners();
+      try {
+        await module().endConnection();
+      } catch {
+        // Already down; nothing to tear down.
+      }
+      notifyConnection(false, 'disconnect');
+    },
+    observeConnection(listener) {
+      return connectionListeners.add(listener);
+    },
+    async queryProducts(storeProductIds, productType) {
+      const raw = await module().fetchProducts({
+        skus: storeProductIds,
+        type: productType === 'subscription' ? 'subs' : 'in-app'
+      });
+      return raw.map(product => (0, _iapShapes.normalizeProduct)(product, productType));
+    },
+    async queryOwned() {
+      const raw = await module().getAvailablePurchases();
+      // Pending purchases are mapped through, flagged rather than filtered: the
+      // engine needs to see them to raise the pending signal (FR-038).
+      return raw.map(_iapShapes.normalizePurchase);
+    },
+    /**
+     * Settles on the first outcome event for this product: a purchase update
+     * (bought or pending) or a purchase error (cancelled, already owned, …).
+     *
+     * The binding's promise is not the outcome: on Android it resolves with an
+     * empty list when the flow ends, whatever happened. Its listeners also feed
+     * `observePurchases`, so the engine sees a bought purchase twice — here and
+     * as a store update — and grants it once (FR-044).
+     */
+    launchPurchase(request) {
+      const sku = request.storeProductId;
+      return new Promise(resolve => {
+        let settled = false;
+        let grace;
+        const onPurchase = purchase => {
+          if (purchase.storeProductId === sku) {
+            finish({
+              ok: true,
+              purchase
+            });
+          }
+        };
+        const onError = error => {
+          if (error.productId && error.productId !== sku) {
+            return;
+          }
+          finish({
+            ok: false,
+            reason: (0, _iapShapes.mapErrorCode)(error.code),
+            detail: error.code
+          });
+        };
+        const fail = error => {
+          const code = error?.code;
+          finish({
+            ok: false,
+            reason: (0, _iapShapes.mapErrorCode)(code),
+            detail: code
+          });
+        };
+        function finish(outcome) {
+          if (settled) {
+            return;
+          }
+          settled = true;
+          clearTimeout(grace);
+          stopPurchase();
+          stopError();
+          resolve(outcome);
+        }
+        const stopPurchase = purchaseListeners.add(onPurchase);
+        const stopError = purchaseErrorListeners.add(onError);
+        try {
+          module().requestPurchase(toRequestProps(request)).then(() => {
+            if (!settled) {
+              grace = setTimeout(() => finish({
+                ok: false,
+                reason: 'store_error',
+                detail: 'no purchase event'
+              }), RESULT_EVENT_GRACE_MS);
+            }
+          }, fail);
+        } catch (error) {
+          fail(error);
+        }
+      });
+    },
+    observePurchases(listener) {
+      return purchaseListeners.add(listener);
+    },
+    async acknowledge(token) {
+      // Idempotent at the store: acknowledging an already-acknowledged purchase
+      // is accepted, which is what FR-044 relies on.
+      await module().finishTransaction({
+        purchase: {
+          purchaseToken: token
+        },
+        isConsumable: false
+      });
+    },
+    async consume(token) {
+      await module().finishTransaction({
+        purchase: {
+          purchaseToken: token
+        },
+        isConsumable: true
+      });
+    },
+    async openSubscriptionManagement(storeProductId) {
+      // The store's own screen. Platforms forbid a self-built cancellation
+      // screen, so there is deliberately no alternative path here (FR-066).
+      const mod = module();
+      if (!mod.deepLinkToSubscriptions) {
+        return;
+      }
+      await mod.deepLinkToSubscriptions({
+        skuAndroid: storeProductId
+      });
+    },
+    async confirmPriceChange() {
+      // Play has no client-side price-change confirmation flow; it notifies the
+      // user itself. Reported as unsupported rather than faked, matching
+      // `supportsPriceChangeConfirmation: false` (FR-067).
+      return {
+        ok: false,
+        reason: 'store_error'
+      };
+    },
+    capabilities: () => ANDROID_CAPABILITIES
+  };
+}
+//# sourceMappingURL=iap-adapter.js.map

package/lib/commonjs/adapter/iap-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_rnCore","require","_iapShapes","_errors","RESULT_EVENT_GRACE_MS","REPLACEMENT_MODES","WITH_TIME_PRORATION","CHARGE_FULL_PRICE","CHARGE_PRORATED_PRICE","DEFERRED","toRequestProps","request","google","skus","storeProductId","obfuscatedAccountId","productType","type","replacementMode","prorationMode","undefined","offerKey","subscriptionOffers","sku","offerToken","replacePurchaseToken","purchaseToken","replaceStoreProductId","subscriptionProductReplacementParams","oldProductId","iapPeer","lazyPeer","cause","loadModule","peer","PaymentError","code","message","operation","redact","ANDROID_CAPABILITIES","supportsSubscriptions","supportsPlanChange","supportsPriceChangeConfirmation","reportsGraceAndHoldDistinctly","supportsExternalTransactions","createsRealTransactions","purchaseOutcomeIncludesStoreTime","createIapAdapter","options","iap","module","connected","connectionListeners","createListenerSet","purchaseListeners","purchaseErrorListeners","updateSub","errorSub","notifyConnection","next","reason","notify","attachListeners","detachListeners","mod","purchaseUpdatedListener","raw","normalizePurchase","purchaseErrorListener","error","mapErrorCode","remove","connect","endConnection","catch","ok","initConnection","retryable","disconnect","observeConnection","listener","add","queryProducts","storeProductIds","fetchProducts","map","product","normalizeProduct","queryOwned","getAvailablePurchases","launchPurchase","Promise","resolve","settled","grace","onPurchase","purchase","finish","onError","productId","detail","fail","outcome","clearTimeout","stopPurchase","stopError","requestPurchase","then","setTimeout","observePurchases","acknowledge","token","finishTransaction","isConsumable","consume","openSubscriptionManagement","deepLinkToSubscriptions","skuAndroid","confirmPriceChange","capabilities"],"sourceRoot":"../../../src","sources":["adapter/iap-adapter.ts"],"mappings":"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","ignoreList":[]}