@chipmobilesdk/rn-payment 0.6.0 → 0.7.0

package/lib/commonjs/adapter/iapShapes.js

@@ -0,0 +1,169 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.mapErrorCode = mapErrorCode;
+exports.normalizeOffer = normalizeOffer;
+exports.normalizeProduct = normalizeProduct;
+exports.normalizePurchase = normalizePurchase;
+exports.toMicros = toMicros;
+exports.toProviderPurchaseState = toProviderPurchaseState;
+/**
+ * The binding's shapes, and their translation into the port's vocabulary
+ * (PAY-12).
+ *
+ * The binding speaks Google Play: prices as micros in strings, offer tokens,
+ * numeric purchase states, store error codes. The port speaks this package's
+ * own. Keeping the translation here, with no I/O, no listeners and no module
+ * loading, is what makes it checkable against recorded payloads — and leaves
+ * the adapter next door about the calls it actually makes.
+ *
+ * The raw types are declared narrowly on purpose: they document the coupling,
+ * and a binding upgrade that changes one of these shapes fails to typecheck
+ * here rather than failing silently on a user's device.
+ */
+
+/** What `purchaseErrorListener` delivers. */
+
+/** Play's `PurchaseState`: 0 unspecified, 1 purchased, 2 pending. */
+const PLAY_STATE_PURCHASED = 1;
+const PLAY_STATE_PENDING = 2;
+
+// Required lazily (rn-core's lazy peer) so importing the package does not require
+// the native module.
+
+function toMicros(value) {
+  if (typeof value === 'number') {
+    return value;
+  }
+  if (typeof value === 'string') {
+    const parsed = Number.parseInt(value, 10);
+    return Number.isFinite(parsed) ? parsed : 0;
+  }
+  return 0;
+}
+function normalizeProduct(raw, productType) {
+  const oneTime = raw.oneTimePurchaseOfferDetails;
+  const currencyCode = oneTime?.priceCurrencyCode ?? raw.currencyCode ?? raw.currency ?? '';
+  return {
+    storeProductId: raw.id ?? raw.productId ?? '',
+    productType,
+    title: raw.title ?? raw.name ?? '',
+    description: raw.description ?? '',
+    // Store-formatted, never built here: only the store knows the right currency
+    // symbol, separator, and placement for the user's locale (FR-028).
+    formattedPrice: oneTime?.formattedPrice ?? raw.displayPrice ?? raw.localizedPrice ?? '',
+    currencyCode,
+    priceAmountMicros: toMicros(oneTime?.priceAmountMicros ?? raw.price),
+    offers: (raw.subscriptionOfferDetails ?? []).map(offer => normalizeOffer(offer, currencyCode))
+  };
+}
+function normalizeOffer(offer, fallbackCurrency) {
+  const phases = offer.pricingPhases?.pricingPhaseList ?? [];
+  // The last phase is the recurring price; earlier ones are trial or
+  // introductory. Play orders them that way.
+  const recurring = phases[phases.length - 1];
+  const intro = phases.length > 1 ? phases[0] : undefined;
+  const isFreeTrial = intro !== undefined && toMicros(intro.priceAmountMicros) === 0;
+  return {
+    offerKey: offer.offerToken ?? offer.offerId ?? offer.basePlanId ?? '',
+    billingPeriod: recurring?.billingPeriod ?? '',
+    formattedPrice: recurring?.formattedPrice ?? '',
+    priceAmountMicros: toMicros(recurring?.priceAmountMicros),
+    currencyCode: recurring?.priceCurrencyCode ?? fallbackCurrency,
+    trialPeriod: isFreeTrial ? intro?.billingPeriod : undefined,
+    introductoryPrice: intro && !isFreeTrial ? {
+      formattedPrice: intro.formattedPrice ?? '',
+      period: intro.billingPeriod ?? '',
+      cycles: intro.billingCycleCount ?? 1
+    } : undefined,
+    // Play decides eligibility by only returning offers the user qualifies for,
+    // so forwarding `true` reports the store's determination rather than
+    // computing our own (FR-026).
+    isEligible: true
+  };
+}
+
+/**
+ * Reads the purchase state from whichever field the binding filled.
+ *
+ * Pending is preserved, never flattened to purchased: that distinction is what
+ * stops an entitlement being granted for money that has not arrived (FR-037).
+ * And an unrecognized or missing state is `unspecified`, never `purchased`.
+ *
+ * 0.1.0 read only Play's numeric state and treated anything else as purchased.
+ * The 16.x binding hands JavaScript the *string* state and does not carry the
+ * numeric one across, so on a device every pending purchase arrived as a string,
+ * fell through to the default, and was granted. Unit tests could not see it: they
+ * drive the fake store, which never passes through here.
+ */
+function toProviderPurchaseState(raw) {
+  let numeric;
+  if (typeof raw.purchaseStateAndroid === 'number') {
+    numeric = raw.purchaseStateAndroid;
+  } else if (typeof raw.purchaseState === 'number') {
+    numeric = raw.purchaseState;
+  }
+  if (numeric !== undefined) {
+    if (numeric === PLAY_STATE_PENDING) {
+      return 'pending';
+    }
+    return numeric === PLAY_STATE_PURCHASED ? 'purchased' : 'unspecified';
+  }
+  switch (typeof raw.purchaseState === 'string' ? raw.purchaseState.toLowerCase() : '') {
+    case 'purchased':
+    case 'restored':
+      return 'purchased';
+    case 'pending':
+    case 'deferred':
+      return 'pending';
+    default:
+      return 'unspecified';
+  }
+}
+function normalizePurchase(raw) {
+  return {
+    storeProductId: raw.productId ?? raw.ids?.[0] ?? '',
+    transactionId: raw.id ?? raw.transactionId ?? raw.purchaseToken ?? '',
+    token: raw.purchaseToken ?? '',
+    state: toProviderPurchaseState(raw),
+    purchasedAt: raw.transactionDate ?? Date.now(),
+    isAcknowledged: raw.isAcknowledgedAndroid ?? raw.isAcknowledged ?? false,
+    expiresAt: raw.expirationDateAndroid,
+    willAutoRenew: raw.autoRenewingAndroid ?? raw.isAutoRenewing,
+    // Opaque material for the app's backend. Carried here and handed to the
+    // validation hook only — never logged or put in an event (FR-074).
+    verificationPayload: raw.transactionReceipt ?? raw.dataAndroid
+  };
+}
+
+/** Maps a binding error code onto the port's vocabulary, so no store code escapes. */
+function mapErrorCode(code) {
+  switch (code) {
+    case 'E_USER_CANCELLED':
+    case 'user-cancelled':
+      return 'user_cancelled';
+    case 'E_ALREADY_OWNED':
+    case 'already-owned':
+    case 'item-already-owned':
+      return 'already_owned';
+    case 'E_ITEM_UNAVAILABLE':
+    case 'item-unavailable':
+    case 'sku-not-found':
+      return 'unknown_product';
+    case 'E_NOT_PREPARED':
+    case 'not-prepared':
+      return 'not_ready';
+    case 'E_NETWORK_ERROR':
+    case 'network-error':
+      return 'network_error';
+    case 'E_DEFERRED_PAYMENT':
+      // Not a failure — a pending purchase. The caller resolves it from the
+      // purchase update rather than from this error.
+      return 'store_error';
+    default:
+      return 'store_error';
+  }
+}
+//# sourceMappingURL=iapShapes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["PLAY_STATE_PURCHASED","PLAY_STATE_PENDING","toMicros","value","parsed","Number","parseInt","isFinite","normalizeProduct","raw","productType","oneTime","oneTimePurchaseOfferDetails","currencyCode","priceCurrencyCode","currency","storeProductId","id","productId","title","name","description","formattedPrice","displayPrice","localizedPrice","priceAmountMicros","price","offers","subscriptionOfferDetails","map","offer","normalizeOffer","fallbackCurrency","phases","pricingPhases","pricingPhaseList","recurring","length","intro","undefined","isFreeTrial","offerKey","offerToken","offerId","basePlanId","billingPeriod","trialPeriod","introductoryPrice","period","cycles","billingCycleCount","isEligible","toProviderPurchaseState","numeric","purchaseStateAndroid","purchaseState","toLowerCase","normalizePurchase","ids","transactionId","purchaseToken","token","state","purchasedAt","transactionDate","Date","now","isAcknowledged","isAcknowledgedAndroid","expiresAt","expirationDateAndroid","willAutoRenew","autoRenewingAndroid","isAutoRenewing","verificationPayload","transactionReceipt","dataAndroid","mapErrorCode","code"],"sourceRoot":"../../../src","sources":["adapter/iapShapes.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/adapter/port.js

@@ -0,0 +1,6 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+//# sourceMappingURL=port.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["adapter/port.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/config/types.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=types.js.map

package/lib/commonjs/config/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["config/types.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/config/validate.js

@@ -0,0 +1,181 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.assertEnvironmentSafe = assertEnvironmentSafe;
+exports.mayCreateRealTransaction = mayCreateRealTransaction;
+exports.validateConfig = validateConfig;
+var _errors = require("../diagnostics/errors.js");
+var _timers = require("../core/timers.js");
+/**
+ * Catalog validation (FR-011).
+ *
+ * Runs at `configure`, before any connection is opened, so a bad catalog fails
+ * at configuration time rather than at the moment a user taps Buy. Every failure
+ * **names the offending entry** — "invalid catalog" alone is useless in an app
+ * with thirty products.
+ *
+ * All problems are collected rather than thrown one at a time, so a developer
+ * fixes the catalog in one pass instead of rerunning to find the next fault.
+ */
+
+const PRODUCT_TYPES = ['one_time_permanent', 'one_time_consumable', 'subscription'];
+
+/** The platform whose store identifiers a catalog must supply. */
+
+/**
+ * A validated, indexed catalog plus every resolved policy value.
+ *
+ * Produced once so the hot paths never re-derive it, and so `getEntitlement` can
+ * stay a synchronous in-memory read (PERF-001).
+ */
+
+function validateConfig(config, platform = 'android') {
+  const problems = [];
+  const offenders = [];
+  const entries = new Map();
+  const grants = new Map();
+  const sources = new Map();
+  const byStoreId = new Map();
+  if (config.catalog.length === 0) {
+    problems.push('catalog is empty');
+    offenders.push('catalog');
+  }
+  for (const entry of config.catalog) {
+    const key = entry.productKey;
+    if (!key || key.trim() === '') {
+      problems.push('a catalog entry has an empty productKey');
+      offenders.push('(empty productKey)');
+      continue;
+    }
+    if (entries.has(key)) {
+      problems.push(`duplicate productKey "${key}"`);
+      offenders.push(key);
+      continue;
+    }
+    if (!PRODUCT_TYPES.includes(entry.productType)) {
+      problems.push(`productKey "${key}" has invalid productType "${String(entry.productType)}"`);
+      offenders.push(key);
+    }
+    const storeId = entry.storeProductIds[platform];
+    if (!storeId || storeId.trim() === '') {
+      problems.push(`productKey "${key}" is missing a store product id for platform "${platform}"`);
+      offenders.push(key);
+    } else {
+      const existing = byStoreId.get(storeId);
+      if (existing !== undefined) {
+        // Two product keys pointing at one store id would make a store callback
+        // ambiguous, so the wrong entitlement could be granted.
+        problems.push(`store product id "${storeId}" is used by both "${existing}" and "${key}"`);
+        offenders.push(key);
+      } else {
+        byStoreId.set(storeId, key);
+      }
+    }
+    if (!Array.isArray(entry.grants) || entry.grants.length === 0) {
+      problems.push(`productKey "${key}" grants no entitlement`);
+      offenders.push(key);
+    }
+    entries.set(key, entry);
+    grants.set(key, [...(entry.grants ?? [])]);
+    for (const entitlement of entry.grants ?? []) {
+      const list = sources.get(entitlement);
+      if (list) {
+        list.push(key);
+      } else {
+        sources.set(entitlement, [key]);
+      }
+    }
+  }
+
+  // An entitlement the app intends to query but no product can grant is almost
+  // always a typo, and it would otherwise sit at `not_entitled` forever with no
+  // indication why.
+  for (const entitlement of config.entitlements) {
+    if (!sources.has(entitlement)) {
+      problems.push(`entitlement "${entitlement}" is declared but no catalog product grants it`);
+      offenders.push(entitlement);
+    }
+  }
+
+  // A product granting something the app never declared is the mirror problem:
+  // harmless at runtime, but a strong signal of a rename half-applied.
+  const declared = new Set(config.entitlements);
+  for (const entitlement of sources.keys()) {
+    if (!declared.has(entitlement)) {
+      problems.push(`entitlement "${entitlement}" is granted by a product but not declared in config.entitlements`);
+      offenders.push(entitlement);
+    }
+  }
+  if (problems.length > 0) {
+    throw new _errors.PaymentConfigError({
+      code: 'PAYMENT_INVALID_CATALOG',
+      message: `Payment catalog is invalid: ${problems.join('; ')}`,
+      operation: 'configure',
+      offenders: [...new Set(offenders)]
+    });
+  }
+  return {
+    entries,
+    grants,
+    sources: new Map([...sources].map(([k, v]) => [k, [...v]])),
+    byStoreId,
+    entitlementKeys: [...config.entitlements],
+    platform,
+    enabled: config.enabled ?? true,
+    gracePolicy: config.gracePolicy ?? 'grant',
+    holdPolicy: config.holdPolicy ?? 'withhold',
+    staleAfterMs: (0, _timers.resolveStaleAfterMs)(config.staleAfterMs),
+    productCacheTtlMs: (0, _timers.resolveProductCacheTtlMs)(config.productCacheTtlMs),
+    foregroundSyncMinIntervalMs: (0, _timers.resolveForegroundSyncMinIntervalMs)(config.foregroundSyncMinIntervalMs),
+    timeouts: (0, _timers.resolveTimeouts)(config.timeouts),
+    retry: (0, _timers.resolveRetry)(config.retry),
+    onValidationUnavailable: config.onValidationUnavailable ?? 'grant_and_queue'
+  };
+}
+
+/**
+ * The fail-closed environment guard (FR-015).
+ *
+ * Separate from catalog validation because it is not about the catalog's shape
+ * but about whether this binary is allowed to move real money at all. Checked
+ * before connecting, and it refuses rather than warns: a non-production build
+ * that declares `production` is one tap away from charging a real card, and
+ * continuing silently is exactly the failure this package exists to prevent.
+ */
+function assertEnvironmentSafe(config) {
+  if (config.allowStoreTestPurchases === true && config.environment !== 'test') {
+    throw new _errors.PaymentConfigError({
+      code: 'PAYMENT_INVALID_CONFIG',
+      message: `allowStoreTestPurchases is only accepted with environment "test", not ` + `"${config.environment}": it exists for license testers, not for real users.`,
+      operation: 'configure',
+      offenders: ['allowStoreTestPurchases']
+    });
+  }
+  if (config.environment === 'production' && !config.isProductionBuild) {
+    throw new _errors.PaymentConfigError({
+      code: 'PAYMENT_PRODUCTION_CONFIG_IN_NON_PRODUCTION_BUILD',
+      message: 'environment is "production" but isProductionBuild is false. Refusing to ' + 'initialize: a non-production build must not be able to create a real ' + 'transaction.',
+      operation: 'configure',
+      offenders: ['environment']
+    });
+  }
+}
+
+/**
+ * Whether this configuration may hand a purchase to a real store (FR-014).
+ *
+ * True in a production build configured for production, and in a `test`
+ * environment that opted in with `allowStoreTestPurchases` (PAY-16). False
+ * everywhere else. The engine records each refusal in observable status so a
+ * test can assert the block happened — the difference between a guarantee and a
+ * hope.
+ */
+function mayCreateRealTransaction(config) {
+  if (config.environment === 'test' && config.allowStoreTestPurchases === true) {
+    return true;
+  }
+  return config.environment === 'production' && config.isProductionBuild;
+}
+//# sourceMappingURL=validate.js.map

package/lib/commonjs/config/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_errors","require","_timers","PRODUCT_TYPES","validateConfig","config","platform","problems","offenders","entries","Map","grants","sources","byStoreId","catalog","length","push","entry","key","productKey","trim","has","includes","productType","String","storeId","storeProductIds","existing","get","undefined","set","Array","isArray","entitlement","list","entitlements","declared","Set","keys","PaymentConfigError","code","message","join","operation","map","k","v","entitlementKeys","enabled","gracePolicy","holdPolicy","staleAfterMs","resolveStaleAfterMs","productCacheTtlMs","resolveProductCacheTtlMs","foregroundSyncMinIntervalMs","resolveForegroundSyncMinIntervalMs","timeouts","resolveTimeouts","retry","resolveRetry","onValidationUnavailable","assertEnvironmentSafe","allowStoreTestPurchases","environment","isProductionBuild","mayCreateRealTransaction"],"sourceRoot":"../../../src","sources":["config/validate.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/core/mutex.js

@@ -0,0 +1,31 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "createExclusive", {
+  enumerable: true,
+  get: function () {
+    return _rnCore.createExclusive;
+  }
+});
+Object.defineProperty(exports, "createRateLimiter", {
+  enumerable: true,
+  get: function () {
+    return _rnCore.createRateLimiter;
+  }
+});
+Object.defineProperty(exports, "createSingleFlight", {
+  enumerable: true,
+  get: function () {
+    return _rnCore.createSingleFlight;
+  }
+});
+Object.defineProperty(exports, "withTimeout", {
+  enumerable: true,
+  get: function () {
+    return _rnCore.withTimeout;
+  }
+});
+var _rnCore = require("@chipmobilesdk/rn-core");
+//# sourceMappingURL=mutex.js.map

package/lib/commonjs/core/mutex.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_rnCore","require"],"sourceRoot":"../../../src","sources":["core/mutex.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkBA,IAAAA,OAAA,GAAAC,OAAA","ignoreList":[]}

package/lib/commonjs/core/retry.js

@@ -0,0 +1,37 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.backoffDelayMs = backoffDelayMs;
+var _rnCore = require("@chipmobilesdk/rn-core");
+/**
+ * Bounded backoff.
+ *
+ * "Bounded" is the whole point (FR-020, FR-045): an unbounded reconnect loop
+ * against a billing service that is down drains battery and hammers a system
+ * service, and an unbounded finalize loop hides a real failure behind noise.
+ *
+ * Delay computation is pure and separated from waiting so tests can assert the
+ * schedule without burning real time.
+ */
+
+/**
+ * Delay before `attempt` (1-based), capped and optionally jittered.
+ *
+ * Jitter is full jitter over [0, capped]: several devices that lost the billing
+ * connection at the same moment should not retry in lockstep.
+ */
+function backoffDelayMs(attempt, config, random = Math.random) {
+  return (0, _rnCore.computeBackoff)(attempt, toSpec(config), random);
+}
+function toSpec(config) {
+  return {
+    initialDelayMs: config.initialDelayMs,
+    maxDelayMs: config.maxDelayMs,
+    factor: config.factor,
+    jitter: config.jitter ? 'full' : 'none',
+    maxAttempts: config.maxAttempts
+  };
+}
+//# sourceMappingURL=retry.js.map

package/lib/commonjs/core/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_rnCore","require","backoffDelayMs","attempt","config","random","Math","computeBackoff","toSpec","initialDelayMs","maxDelayMs","factor","jitter","maxAttempts"],"sourceRoot":"../../../src","sources":["core/retry.ts"],"mappings":";;;;;;AAWA,IAAAA,OAAA,GAAAC,OAAA;AAXA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,cAAcA,CAC7BC,OAAe,EACfC,MAA+B,EAC/BC,MAAoB,GAAGC,IAAI,CAACD,MAAM,EACzB;EACT,OAAO,IAAAE,sBAAc,EAACJ,OAAO,EAAEK,MAAM,CAACJ,MAAM,CAAC,EAAEC,MAAM,CAAC;AACvD;AAEA,SAASG,MAAMA,CAACJ,MAA+B,EAAE;EAChD,OAAO;IACNK,cAAc,EAAEL,MAAM,CAACK,cAAc;IACrCC,UAAU,EAAEN,MAAM,CAACM,UAAU;IAC7BC,MAAM,EAAEP,MAAM,CAACO,MAAM;IACrBC,MAAM,EAAER,MAAM,CAACQ,MAAM,GAAI,MAAM,GAAc,MAAgB;IAC7DC,WAAW,EAAET,MAAM,CAACS;EACrB,CAAC;AACF","ignoreList":[]}