@chipmobilesdk/rn-payment 0.5.0 → 0.7.0

package/lib/module/persistence/snapshot.js

@@ -0,0 +1,221 @@
+"use strict";
+
+/**
+ * The persisted snapshot: schema, versioning, and migration.
+ *
+ * What is stored here is **exhaustively** what the package keeps on the device,
+ * and the README repeats this list so an app owner can complete a Data safety
+ * declaration accurately (FR-056, POL-002).
+ *
+ * Deliberately absent: payment details, card data, billing address, user
+ * identity, raw receipts, verification payloads, and backend tokens.
+ */
+
+/**
+ * 2 since 0.6.0: the never-written `entitlements` map and `finalized` state are
+ * gone (PAY-12). Entitlements are always derived from purchases, never stored.
+ */
+export const SNAPSHOT_SCHEMA_VERSION = 2;
+
+/** Where a transaction stands with the store. */
+
+/**
+ * Where a transaction stands in the finalization queue.
+ *
+ * `queued` is the load-bearing value: it is written **before** the store call is
+ * attempted, so an app killed mid-finalize leaves a recoverable record rather
+ * than a paid purchase that Google will auto-refund (FR-041, FR-042).
+ */
+
+/** Whether the app's backend has ruled on this transaction (FR-072a). */
+
+export function emptySnapshot(scopeToken) {
+  return {
+    schemaVersion: SNAPSHOT_SCHEMA_VERSION,
+    scopeToken,
+    purchases: [],
+    lastSyncedAt: undefined
+  };
+}
+
+/**
+ * A migration from one schema version to the next.
+ *
+ * Kept as an ordered chain rather than a switch so each step stays small and
+ * independently testable, and so a device several versions behind is carried
+ * forward one hop at a time (NFR-009).
+ */
+
+/** Registered migrations, one hop each. */
+export const SNAPSHOT_MIGRATIONS = [{
+  // v1 stored an `entitlements` map nothing ever wrote to, and a `finalized`
+  // purchase state nothing ever set (PAY-12). Both go; a `finalized` record,
+  // should one exist, is a purchased one whose finalize progress is kept.
+  from: 1,
+  to: 2,
+  migrate(input) {
+    const rest = {
+      ...input
+    };
+    delete rest.entitlements;
+    const purchases = Array.isArray(rest.purchases) ? rest.purchases.map(record => typeof record === 'object' && record !== null && record.state === 'finalized' ? {
+      ...record,
+      state: 'purchased'
+    } : record) : rest.purchases;
+    return {
+      ...rest,
+      schemaVersion: 2,
+      purchases
+    };
+  }
+}];
+export function migrateSnapshot(raw) {
+  if (typeof raw !== 'object' || raw === null) {
+    return {
+      ok: false,
+      reason: 'unreadable'
+    };
+  }
+  let working = {
+    ...raw
+  };
+  const version = working.schemaVersion;
+  if (typeof version !== 'number' || !Number.isInteger(version) || version < 1) {
+    return {
+      ok: false,
+      reason: 'unreadable'
+    };
+  }
+  if (version > SNAPSHOT_SCHEMA_VERSION) {
+    // A newer app version wrote this. Downgrading cannot know what was added,
+    // so refuse rather than silently drop fields.
+    return {
+      ok: false,
+      reason: 'unsupported_version'
+    };
+  }
+  let current = version;
+  let migrated = false;
+  while (current < SNAPSHOT_SCHEMA_VERSION) {
+    const step = SNAPSHOT_MIGRATIONS.find(m => m.from === current);
+    if (!step) {
+      return {
+        ok: false,
+        reason: 'unsupported_version'
+      };
+    }
+    working = step.migrate(working);
+    current = step.to;
+    migrated = true;
+  }
+  const snapshot = coerceSnapshot(working);
+  return snapshot ? {
+    ok: true,
+    snapshot,
+    migrated
+  } : {
+    ok: false,
+    reason: 'unreadable'
+  };
+}
+
+/**
+ * Validates shape after migration.
+ *
+ * Runs even on a non-migrated record because the bytes came off a device where
+ * anything could have happened to them — a partial write, a rooted user, a
+ * truncated file.
+ */
+function coerceSnapshot(input) {
+  const purchases = input.purchases;
+  if (!Array.isArray(purchases)) {
+    return null;
+  }
+  const lastSyncedAt = typeof input.lastSyncedAt === 'number' ? input.lastSyncedAt : undefined;
+  const scopeToken = typeof input.scopeToken === 'string' ? input.scopeToken : undefined;
+  return {
+    schemaVersion: SNAPSHOT_SCHEMA_VERSION,
+    scopeToken,
+    // Record by record: one damaged entry is dropped, not trusted and not
+    // allowed to discard the rest (PAY-13). A dropped record comes back with the
+    // next sync, if the store still reports it.
+    purchases: purchases.flatMap(record => {
+      const valid = coercePurchase(record);
+      return valid ? [valid] : [];
+    }),
+    lastSyncedAt
+  };
+}
+const PURCHASE_STATES = new Set(['pending', 'purchased', 'consumed', 'revoked']);
+const FINALIZE_STATES = new Set(['not_required', 'queued', 'in_flight', 'done', 'failed']);
+const VALIDATION_STATES = new Set(['not_required', 'approved', 'rejected', 'queued_for_revalidation']);
+const PRODUCT_TYPES = new Set(['one_time_permanent', 'one_time_consumable', 'subscription']);
+
+/** A persisted purchase with every field checked, or null when any is wrong. */
+function coercePurchase(input) {
+  if (typeof input !== 'object' || input === null) {
+    return null;
+  }
+  const record = input;
+  const text = value => typeof value === 'string' && value !== '';
+  const count = value => typeof value === 'number' && Number.isFinite(value) && value >= 0;
+  if (!text(record.transactionId) || !text(record.productKey) || !text(record.token) || !PRODUCT_TYPES.has(record.productType) || !PURCHASE_STATES.has(record.state) || !FINALIZE_STATES.has(record.finalizeState) || !VALIDATION_STATES.has(record.validationState) || !count(record.purchasedAt) || !count(record.attempts) || record.expiresAt !== undefined && !count(record.expiresAt) || record.willAutoRenew !== undefined && typeof record.willAutoRenew !== 'boolean') {
+    return null;
+  }
+  return {
+    transactionId: record.transactionId,
+    productKey: record.productKey,
+    productType: record.productType,
+    token: record.token,
+    state: record.state,
+    purchasedAt: record.purchasedAt,
+    finalizeState: record.finalizeState,
+    attempts: record.attempts,
+    validationState: record.validationState,
+    expiresAt: record.expiresAt,
+    willAutoRenew: record.willAutoRenew
+  };
+}
+
+/**
+ * Decides a purchase's finalization state from the store's view plus what we
+ * already knew.
+ *
+ * Shared by the sync path and the purchase path so they cannot drift — and they
+ * must not, because a disagreement here is how a paid transaction goes
+ * unacknowledged and gets auto-refunded three days later.
+ *
+ * The subtle case is a **pending purchase that settles**. Its record was written
+ * with `not_required`, which was correct while the money had not arrived. Once the
+ * store reports it `purchased`, that value must be re-evaluated rather than
+ * preserved — otherwise the transaction is never queued, never acknowledged, and
+ * Google revokes it. Progress is preserved only for a transaction that was
+ * already in the queue.
+ */
+export function resolveFinalizeState(incoming, existing) {
+  if (incoming.state === 'pending') {
+    // Nothing to settle: there is no entitlement to report as delivered.
+    return 'not_required';
+  }
+
+  // Already settled at the store, whatever we thought locally.
+  if (incoming.isAcknowledged) {
+    return 'done';
+  }
+
+  // Genuine in-queue progress is preserved, so a sync cannot reset an attempt
+  // count or lose an in-flight finalize.
+  if (existing && existing.finalizeState !== 'not_required' && existing.finalizeState !== 'done') {
+    return existing.finalizeState;
+  }
+
+  // Covers both a brand-new purchase and a previously-pending one that just
+  // settled. Either way it is now owed a finalize call.
+  return 'queued';
+}
+
+/** Transactions still owed a finalize call, drained at startup and on foreground (FR-042). */
+export function pendingFinalizations(snapshot) {
+  return snapshot.purchases.filter(p => (p.finalizeState === 'queued' || p.finalizeState === 'in_flight' || p.finalizeState === 'failed') && p.state !== 'revoked');
+}
+//# sourceMappingURL=snapshot.js.map

package/lib/module/persistence/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SNAPSHOT_SCHEMA_VERSION","emptySnapshot","scopeToken","schemaVersion","purchases","lastSyncedAt","undefined","SNAPSHOT_MIGRATIONS","from","to","migrate","input","rest","entitlements","Array","isArray","map","record","state","migrateSnapshot","raw","ok","reason","working","version","Number","isInteger","current","migrated","step","find","m","snapshot","coerceSnapshot","flatMap","valid","coercePurchase","PURCHASE_STATES","Set","FINALIZE_STATES","VALIDATION_STATES","PRODUCT_TYPES","text","value","count","isFinite","transactionId","productKey","token","has","productType","finalizeState","validationState","purchasedAt","attempts","expiresAt","willAutoRenew","resolveFinalizeState","incoming","existing","isAcknowledged","pendingFinalizations","filter","p"],"sourceRoot":"../../../src","sources":["persistence/snapshot.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/react/PaymentProvider.js

@@ -0,0 +1,90 @@
+"use strict";
+
+/**
+ * React integration.
+ *
+ * The provider owns the engine's lifecycle so an app does not have to remember to
+ * clean up. It renders nothing of its own — no paywall, no price table, no
+ * button. Every surface belongs to the app (UX-001).
+ */
+
+import React, { createContext, useContext, useEffect, useRef, useState } from 'react';
+import { createEngine } from "../engine/engine.js";
+import { syncOnForeground as watchForeground } from "../engine/foreground.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+const PaymentContext = /*#__PURE__*/createContext(null);
+export function PaymentProvider(props) {
+  const {
+    autoInitialize = true,
+    syncOnForeground = false,
+    children
+  } = props;
+  const external = props.engine;
+  const key = props.engine ? undefined : props.engineKey ?? props.config.scopeToken;
+
+  // The latest config and deps, read only when an engine is built.
+  const latest = useRef(props);
+  latest.current = props;
+  const build = () => {
+    const current = latest.current;
+    if (current.engine) {
+      return current.engine;
+    }
+    return createEngine(current.config, current.deps);
+  };
+
+  // Built once, not once per render: validating the catalog and opening storage
+  // are not render work, and a new engine per render reconnected to the billing
+  // service every time the app's root re-rendered (FR-018, PAY-07).
+  const [owned, setOwned] = useState(() => external ? null : build());
+  const builtFor = useRef(key);
+  const cleanedUp = useRef(new WeakSet());
+  const engine = external ?? owned ?? build();
+  useEffect(() => {
+    if (external) {
+      // The app's engine, so the app's lifecycle.
+      return undefined;
+    }
+    const cleaned = cleanedUp.current;
+    // An engine cleaned up by an earlier run of this effect — StrictMode's
+    // mount-unmount-mount in development, or a changed `engineKey` — is never
+    // reused: it would answer every call with "cleaned up". A fresh one replaces
+    // it and this effect runs again for that one.
+    if (!owned || cleaned.has(owned) || builtFor.current !== key) {
+      builtFor.current = key;
+      setOwned(build());
+      return undefined;
+    }
+    if (autoInitialize) {
+      owned.initialize().catch(() => undefined);
+    }
+    // Cleanup on unmount is the whole reason the provider owns the engine:
+    // after it, no event fires and no timer survives (FR-082).
+    return () => {
+      cleaned.add(owned);
+      owned.cleanup();
+    };
+    // `build` reads the latest props through a ref, so it is not a dependency.
+  }, [external, owned, key, autoInitialize]);
+  useEffect(() => syncOnForeground ? watchForeground(engine) : undefined, [engine, syncOnForeground]);
+  return /*#__PURE__*/_jsx(PaymentContext.Provider, {
+    value: engine,
+    children: children
+  });
+}
+
+/**
+ * The engine from context.
+ *
+ * Throws when used outside a provider, deliberately: returning null would push a
+ * null check into every consumer and let a genuine wiring mistake read as "no
+ * entitlement" — the exact conflation this package exists to prevent.
+ */
+export function usePaymentEngine() {
+  const engine = useContext(PaymentContext);
+  if (!engine) {
+    throw new Error('usePaymentEngine must be used inside a <PaymentProvider>. Wrap your app ' + 'or the screen that reads entitlements.');
+  }
+  return engine;
+}
+//# sourceMappingURL=PaymentProvider.js.map

package/lib/module/react/PaymentProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","createContext","useContext","useEffect","useRef","useState","createEngine","syncOnForeground","watchForeground","jsx","_jsx","PaymentContext","PaymentProvider","props","autoInitialize","children","external","engine","key","undefined","engineKey","config","scopeToken","latest","current","build","deps","owned","setOwned","builtFor","cleanedUp","WeakSet","cleaned","has","initialize","catch","add","cleanup","Provider","value","usePaymentEngine","Error"],"sourceRoot":"../../../src","sources":["react/PaymentProvider.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/react/hooks.js

@@ -0,0 +1,192 @@
+"use strict";
+
+/**
+ * Hooks over the engine.
+ *
+ * Each subscribes on mount and unsubscribes on unmount, so repeated mount/unmount
+ * leaves no duplicate subscription and no surviving listener (FR-006, PERF-002).
+ *
+ * Reads are synchronous: the engine holds entitlements in memory, so a hook never
+ * returns a loading placeholder for an entitlement it already knows (PERF-001).
+ */
+
+import { useExternalStore } from '@chipmobilesdk/rn-core/react';
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { usePaymentEngine } from "./PaymentProvider.js";
+/**
+ * One entitlement, re-rendering only when that one changes.
+ *
+ * The returned `status` is `unknown` until the first sync completes. That is the
+ * point: an app must be able to tell "not yet known" from "not entitled" so a
+ * paying user never sees the unpaid experience flash (FR-047).
+ */
+export function useEntitlement(key) {
+  const engine = usePaymentEngine();
+  // The engine keeps an unchanged entitlement's object across recomputes, so this
+  // selection only changes, and the component only re-renders, when it changes.
+  const select = useCallback(map => map[key] ?? engine.getEntitlement(key), [engine, key]);
+  return useExternalStore(engine.subscribeEntitlements, engine.getAllEntitlements, select);
+}
+
+/** Every entitlement at once, for a screen that shows overall plan state. */
+export function useEntitlements() {
+  const engine = usePaymentEngine();
+  return useExternalStore(engine.subscribeEntitlements, engine.getAllEntitlements);
+}
+function narrowPending(state, keys) {
+  return keys ? {
+    ...state,
+    purchases: state.purchases.filter(p => keys.includes(p.productKey))
+  } : state;
+}
+
+/**
+ * Pending purchases, in this session or an earlier one (FR-101). Added in 0.2.0.
+ *
+ * Pass product keys to narrow it to the products one screen sells. Read
+ * `status` before the list: under `unknown`, an empty list is not "nothing
+ * pending", and a Buy button shown on it could charge a user twice.
+ */
+export function usePendingPurchases(productKeys) {
+  const engine = usePaymentEngine();
+  // Joined so a caller passing a literal array does not resubscribe each render.
+  const keyToken = productKeys ? productKeys.join('|') : null;
+  const [state, setState] = useState(() => narrowPending(engine.getPendingPurchases(), productKeys ?? null));
+  useEffect(() => {
+    const keys = keyToken === null ? null : keyToken.split('|').filter(Boolean);
+    setState(narrowPending(engine.getPendingPurchases(), keys));
+    return engine.subscribePendingPurchases(next => setState(narrowPending(next, keys)));
+  }, [engine, keyToken]);
+  return state;
+}
+
+/** Package status, so an app can tell "cannot sell here" from "not paid" (FR-022). */
+export function usePaymentStatus() {
+  const engine = usePaymentEngine();
+  return useExternalStore(engine.subscribeStatus, engine.getStatus);
+}
+/**
+ * Starting a purchase.
+ *
+ * `lastResult` is the full typed union rather than a boolean, because a screen has
+ * to treat `user_cancelled` differently from `store_error` — showing an error
+ * banner to someone who simply changed their mind is the most common paywall bug.
+ */
+export function usePurchase() {
+  const engine = usePaymentEngine();
+  const [isPurchasing, setIsPurchasing] = useState(false);
+  const [lastResult, setLastResult] = useState();
+  const purchase = useCallback(async (productKey, options) => {
+    setIsPurchasing(true);
+    try {
+      const result = await engine.purchase(productKey, options);
+      setLastResult(result);
+      return result;
+    } finally {
+      setIsPurchasing(false);
+    }
+  }, [engine]);
+  const consume = useCallback(ref => engine.consume(ref), [engine]);
+  return {
+    purchase,
+    consume,
+    isPurchasing,
+    lastResult
+  };
+}
+/**
+ * Store-supplied product information for a paywall.
+ *
+ * Every price here is already formatted by the store for the user's locale. An app
+ * must render `formattedPrice` and never build its own string from
+ * `priceAmountMicros` — that field exists for sorting and comparison only
+ * (FR-028).
+ */
+export function useProducts(productKeys) {
+  const engine = usePaymentEngine();
+  const [products, setProducts] = useState([]);
+  const [missing, setMissing] = useState([]);
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState();
+
+  // Joined so the effect depends on the contents rather than the array identity:
+  // a caller passing a literal would otherwise re-query on every render.
+  const keyToken = productKeys.join('|');
+  // Each load's number. Only the latest may write: when the keys change while a
+  // query is out, the older answer must not overwrite the newer one (PAY-20).
+  const latestRequest = useRef(0);
+  const load = useCallback(async fresh => {
+    const request = ++latestRequest.current;
+    const keys = keyToken === '' ? [] : keyToken.split('|');
+    if (keys.length === 0) {
+      setProducts([]);
+      setMissing([]);
+      return;
+    }
+    setIsLoading(true);
+    try {
+      const result = fresh ? await engine.refreshProducts(keys) : await engine.getProducts(keys);
+      if (request !== latestRequest.current) {
+        return;
+      }
+      if (result.ok) {
+        setProducts(result.products);
+        setMissing(result.missing);
+        setError(undefined);
+      } else {
+        setError(result.error);
+      }
+    } finally {
+      if (request === latestRequest.current) {
+        setIsLoading(false);
+      }
+    }
+  }, [engine, keyToken]);
+  useEffect(() => {
+    load(false).catch(() => undefined);
+  }, [load]);
+  const refresh = useCallback(() => load(true), [load]);
+  return {
+    products,
+    missing,
+    isLoading,
+    error,
+    refresh
+  };
+}
+/**
+ * Sync and restore, for a "Restore purchases" control.
+ *
+ * `restore`'s outcome distinguishes "restored" from "nothing found", so the app
+ * can avoid telling a user their purchases came back when none existed (FR-061).
+ */
+export function useSync() {
+  const engine = usePaymentEngine();
+  const [isSyncing, setIsSyncing] = useState(false);
+  const [lastSyncedAt, setLastSyncedAt] = useState(() => engine.getLastSyncedAt());
+  const sync = useCallback(async () => {
+    setIsSyncing(true);
+    try {
+      return await engine.sync('manual');
+    } finally {
+      setIsSyncing(false);
+      setLastSyncedAt(engine.getLastSyncedAt());
+    }
+  }, [engine]);
+  const restore = useCallback(async () => {
+    setIsSyncing(true);
+    try {
+      return await engine.restore();
+    } finally {
+      setIsSyncing(false);
+      setLastSyncedAt(engine.getLastSyncedAt());
+    }
+  }, [engine]);
+  return {
+    sync,
+    restore,
+    isSyncing,
+    lastSyncedAt
+  };
+}
+//# sourceMappingURL=hooks.js.map

package/lib/module/react/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useExternalStore","useCallback","useEffect","useRef","useState","usePaymentEngine","useEntitlement","key","engine","select","map","getEntitlement","subscribeEntitlements","getAllEntitlements","useEntitlements","narrowPending","state","keys","purchases","filter","p","includes","productKey","usePendingPurchases","productKeys","keyToken","join","setState","getPendingPurchases","split","Boolean","subscribePendingPurchases","next","usePaymentStatus","subscribeStatus","getStatus","usePurchase","isPurchasing","setIsPurchasing","lastResult","setLastResult","purchase","options","result","consume","ref","useProducts","products","setProducts","missing","setMissing","isLoading","setIsLoading","error","setError","latestRequest","load","fresh","request","current","length","refreshProducts","getProducts","ok","undefined","catch","refresh","useSync","isSyncing","setIsSyncing","lastSyncedAt","setLastSyncedAt","getLastSyncedAt","sync","restore"],"sourceRoot":"../../../src","sources":["react/hooks.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/testing/conformance.js

@@ -0,0 +1,130 @@
+"use strict";
+
+/**
+ * What any `ProviderPort` must do (IOS-12, PAY-13).
+ *
+ * The same checks run against the fake store and against the Play adapter over a
+ * simulated binding (or the real one, from a demo screen on a device), so a test
+ * that drives the fake proves something about the device path. Each check builds
+ * its own port over the same small store, through a harness.
+ */
+import { ensure, runChecks } from '@chipmobilesdk/rn-core/testing';
+/** The store every check runs against. */
+export const CONFORMANCE_STORE = {
+  products: [{
+    storeProductId: 'conformance.remove_ads',
+    productType: 'one_time_permanent',
+    formattedPrice: '€1.99'
+  }, {
+    storeProductId: 'conformance.coins',
+    productType: 'one_time_consumable',
+    formattedPrice: '€0.99'
+  }],
+  owned: [{
+    storeProductId: 'conformance.remove_ads',
+    token: 'token-owned',
+    state: 'purchased'
+  }, {
+    storeProductId: 'conformance.coins',
+    token: 'token-pending',
+    state: 'pending'
+  }]
+};
+export const providerPortChecks = [{
+  name: 'connects, and disconnects safely before a connect and twice',
+  async run(harness) {
+    const {
+      port
+    } = harness.create(CONFORMANCE_STORE);
+    await port.disconnect();
+    const outcome = await port.connect();
+    ensure(outcome.ok, `connect failed: ${JSON.stringify(outcome)}`);
+    await port.disconnect();
+    await port.disconnect();
+  }
+}, {
+  name: 'reports a dropped service to observers, and nothing after unsubscribing',
+  async run(harness) {
+    const subject = harness.create(CONFORMANCE_STORE);
+    const seen = [];
+    const stop = subject.port.observeConnection(connected => seen.push(connected));
+    await subject.port.connect();
+    ensure(seen.at(-1) === true, `after connect observers saw ${JSON.stringify(seen)}`);
+    subject.dropService();
+    ensure(seen.at(-1) === false, `after the drop observers saw ${JSON.stringify(seen)}`);
+    stop();
+    const before = seen.length;
+    await subject.port.connect();
+    ensure(seen.length === before, 'notified after unsubscribing');
+  }
+}, {
+  name: 'returns the requested products with the store-formatted price',
+  async run(harness) {
+    const {
+      port
+    } = harness.create(CONFORMANCE_STORE);
+    await port.connect();
+    const products = await port.queryProducts(['conformance.remove_ads'], 'one_time_permanent');
+    ensure(products.length === 1, `expected one product, got ${products.length}`);
+    const [product] = products;
+    ensure(product?.storeProductId === 'conformance.remove_ads', 'wrong product returned');
+    ensure(product.productType === 'one_time_permanent', `product type ${product.productType}`);
+    ensure(product.formattedPrice === '€1.99', `price ${product.formattedPrice}`);
+  }
+}, {
+  name: 'flags a pending purchase rather than filtering it out',
+  async run(harness) {
+    const {
+      port
+    } = harness.create(CONFORMANCE_STORE);
+    await port.connect();
+    const owned = await port.queryOwned();
+    const pending = owned.find(purchase => purchase.token === 'token-pending');
+    const bought = owned.find(purchase => purchase.token === 'token-owned');
+    ensure(pending?.state === 'pending', `pending purchase reported as ${pending?.state}`);
+    ensure(bought?.state === 'purchased', `bought purchase reported as ${bought?.state}`);
+  }
+}, {
+  name: 'reports a bought purchase for the product that was requested',
+  async run(harness) {
+    const subject = harness.create(CONFORMANCE_STORE);
+    await subject.port.connect();
+    subject.nextPurchaseEnds('bought');
+    const outcome = await subject.port.launchPurchase({
+      storeProductId: 'conformance.coins',
+      productType: 'one_time_consumable'
+    });
+    ensure(outcome.ok, `purchase failed: ${JSON.stringify(outcome)}`);
+    ensure(outcome.purchase.storeProductId === 'conformance.coins', 'purchase for another product');
+    ensure(outcome.purchase.token !== '', 'purchase has no token to finalize');
+  }
+}, {
+  name: 'reports a cancelled flow as user_cancelled',
+  async run(harness) {
+    const subject = harness.create(CONFORMANCE_STORE);
+    await subject.port.connect();
+    subject.nextPurchaseEnds('cancelled');
+    const outcome = await subject.port.launchPurchase({
+      storeProductId: 'conformance.remove_ads',
+      productType: 'one_time_permanent'
+    });
+    ensure(!outcome.ok, 'a cancelled flow reported a purchase');
+    ensure(outcome.reason === 'user_cancelled', `reason ${outcome.reason}`);
+  }
+}, {
+  name: 'acknowledges and consumes safely twice',
+  async run(harness) {
+    const {
+      port
+    } = harness.create(CONFORMANCE_STORE);
+    await port.connect();
+    await port.acknowledge('token-owned');
+    await port.acknowledge('token-owned');
+    await port.consume('token-pending');
+    await port.consume('token-pending');
+  }
+}];
+export function runProviderPortConformance(harness) {
+  return runChecks(() => harness, providerPortChecks);
+}
+//# sourceMappingURL=conformance.js.map