@chipmobilesdk/rn-payment 0.5.0 → 0.7.0

package/lib/typescript/commonjs/entitlements/policy.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Grace and hold entitlement policy.
+ *
+ * This is a **business decision, not a technical constant** (FR-049), so it is
+ * configurable with documented defaults.
+ *
+ * ## The defaults, and why
+ *
+ * `gracePolicy: 'grant'` — a grace period means the store is still retrying a
+ * payment method that failed for reasons usually outside the user's control: an
+ * expired card, a bank decline, a temporary hold. Revoking immediately punishes a
+ * paying customer for a billing hiccup they may not know about yet.
+ *
+ * `holdPolicy: 'withhold'` — account hold means the store has given up retrying.
+ * The subscription is effectively unpaid, and continuing to serve paid features
+ * indefinitely is giving away the product.
+ *
+ * ## What Android can actually tell us
+ *
+ * Client-side Play Billing **cannot** separate grace from 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.
+ *
+ * Fortunately the platform's own behavior matches the defaults above. Play keeps
+ * returning a grace-period purchase, so the entitlement holds. Play stops
+ * returning a held one, so it lapses at the next sync. **The default policy is
+ * therefore correct with no backend at all.**
+ *
+ * What is *not* achievable client-side is a non-default policy — withholding
+ * during grace, or granting during hold — because that needs the state the client
+ * cannot see. Such an app supplies it through the validation hook (FR-069). This
+ * limitation is documented rather than papered over (FR-058).
+ */
+import type { LapsePolicy } from '../config/types';
+/**
+ * A subscription's renewal state as far as the package can honestly tell.
+ *
+ * `indeterminate` is not a failure — it is the truthful answer when the platform
+ * reports a subscription as active but cannot say whether that is a healthy
+ * renewal, a cancelled-but-still-paid period, or a grace period.
+ */
+export type RenewalState = 'active' | 'cancelled_valid' | 'grace' | 'hold' | 'indeterminate';
+export interface LapsePolicyConfig {
+    gracePolicy: LapsePolicy;
+    holdPolicy: LapsePolicy;
+}
+export interface SubscriptionFacts {
+    expiresAt?: number;
+    willAutoRenew?: boolean;
+    /** True only where the provider genuinely distinguishes grace/hold. */
+    reportsGraceAndHoldDistinctly: boolean;
+    /** Provider-reported, only meaningful when the flag above is true. */
+    providerRenewalState?: 'active' | 'grace' | 'hold';
+}
+/**
+ * Derives the renewal state without inventing information.
+ *
+ * The temptation is to read `willAutoRenew === false` as "grace period", but that
+ * same value is what a deliberate cancellation looks like. Guessing would mean
+ * showing "there's a problem with your payment method" to someone who simply
+ * chose not to renew — so when the provider cannot distinguish, neither do we.
+ */
+export declare function deriveRenewalState(facts: SubscriptionFacts): RenewalState;
+/**
+ * Whether a subscription in this state should confer its entitlement.
+ *
+ * `hold` reaching this function at all requires a provider that reports it,
+ * which Android does not. On Android a held subscription simply stops being
+ * returned, so it never becomes a source and the entitlement lapses — the same
+ * result the `withhold` default expresses.
+ */
+export declare function grantsUnderPolicy(state: RenewalState, policy: LapsePolicyConfig): boolean;
+/** True once a subscription's paid period has genuinely elapsed (FR-048). */
+export declare function hasExpired(expiresAt: number | undefined, now: number): boolean;
+//# sourceMappingURL=policy.d.ts.map

package/lib/typescript/commonjs/entitlements/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../../../src/entitlements/policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,iBAAiB,GAAG,OAAO,GAAG,MAAM,GAAG,eAAe,CAAC;AAE7F,MAAM,WAAW,iBAAiB;IACjC,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uEAAuE;IACvE,6BAA6B,EAAE,OAAO,CAAC;IACvC,sEAAsE;IACtE,oBAAoB,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;CACnD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CAwBzE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAczF;AAED,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9E"}

package/lib/typescript/commonjs/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * `@chipmobilesdk/rn-payment` — reusable in-app payment and entitlement
+ * capability for ChipMobileSdk-family React Native apps.
+ *
+ * This is the public entrypoint (LIB-003). Modules under `config/`, `core/`,
+ * `engine/`, `entitlements/`, `persistence/`, `adapter/`, `diagnostics/`, and
+ * `react/` are private; import them only through this file. The fake store lives
+ * behind `@chipmobilesdk/rn-payment/testing` so test doubles cannot reach a
+ * production bundle.
+ *
+ * Nothing exported here names Google, Play Billing, or `react-native-iap`
+ * (FR-002). `src/__tests__/public-api.test.ts` asserts that mechanically.
+ *
+ * The package owns **capability**: a safe, consistent way to sell, finalize,
+ * restore, and report entitlements. The consuming app owns **policy** — what is
+ * sold, at what price, on which screen, at which moment, what each entitlement
+ * unlocks, and how generous the grace policy is. There is no product identifier,
+ * no screen name, and no business rule in this package (FR-016).
+ *
+ * The one output that matters most is the **entitlement key**: an app-chosen key
+ * such as `no_ads`. Business logic asks about entitlement keys and never about
+ * store product identifiers, product types, or which store sold the thing.
+ */
+export type { BackoffConfig, BlockedOperation, CatalogEntry, EntitlementKey, Environment, FinalizeResult, LapsePolicy, LoggerAdapter, PaymentConfig, PaymentStatus, PaymentStatusKind, PendingPurchase, PendingPurchasesState, PendingResolution, ProductKey, ProductType, PurchaseOptions, PurchaseResult, RetryConfig, StoreProductIds, TimeoutConfig, TransactionRef, UnavailableReason, UnfinalizedSummary, Unsubscribe, ValidationCandidate, ValidationDecision, ValidationHook, ValidationUnavailablePolicy, } from './config/types';
+export { BACKOFF_ATTEMPT_BOUNDS, BACKOFF_MAX_DELAY_BOUNDS, CONNECT_TIMEOUT_BOUNDS, DEFAULT_CONNECT_TIMEOUT_MS, DEFAULT_FINALIZE_ATTEMPT_TIMEOUT_MS, DEFAULT_FINALIZE_BACKOFF, DEFAULT_FOREGROUND_SYNC_MIN_INTERVAL_MS, DEFAULT_PRODUCT_CACHE_TTL_MS, DEFAULT_PRODUCT_QUERY_TIMEOUT_MS, DEFAULT_PURCHASE_LAUNCH_TIMEOUT_MS, DEFAULT_RECONNECT_BACKOFF, DEFAULT_STALE_AFTER_MS, DEFAULT_SYNC_TIMEOUT_MS, FINALIZE_ATTEMPT_TIMEOUT_BOUNDS, FOREGROUND_SYNC_MIN_INTERVAL_BOUNDS, PRODUCT_CACHE_TTL_BOUNDS, PRODUCT_QUERY_TIMEOUT_BOUNDS, PURCHASE_LAUNCH_TIMEOUT_BOUNDS, STALE_AFTER_BOUNDS, SYNC_TIMEOUT_BOUNDS, } from './core/timers';
+export type { MissingProduct, MissingProductReason, Offer, ProductInfo, ProductQueryResult, } from './engine/products';
+export type { PriceChangeResult, ProrationMode } from './engine/subscriptions';
+export type { EntitlementMap, EntitlementState, EntitlementStatus, SubscriptionDetail, } from './entitlements/aggregate';
+export type { RenewalState } from './entitlements/policy';
+export { createStoreProvider } from './adapter/createStoreProvider';
+export type { StoreProviderOptions } from './adapter/createStoreProvider';
+export { createEngine } from './engine/engine';
+export type { EngineDeps, InitOutcome, PaymentEngine, RestoreOutcome, SyncOutcome, } from './engine/engine';
+export { syncOnForeground } from './engine/foreground';
+export { PaymentProvider, usePaymentEngine } from './react/PaymentProvider';
+export type { PaymentProviderProps } from './react/PaymentProvider';
+export { useEntitlement, useEntitlements, usePaymentStatus, usePendingPurchases, useProducts, usePurchase, useSync, } from './react/hooks';
+export type { UseProductsResult, UsePurchaseResult, UseSyncResult } from './react/hooks';
+export { PaymentConfigError, PaymentError, PAYMENT_ERROR_CODES } from './diagnostics/errors';
+export type { PaymentErrorCode, PaymentOperation } from './diagnostics/errors';
+export type { PaymentEvent, PaymentEventListener, PaymentEventType, SyncTrigger, } from './diagnostics/events';
+export { DEFAULT_DEVELOPER_MESSAGES, DEFAULT_MESSAGES, paymentMessages, DEFAULT_USER_MESSAGES, DEVELOPER_MESSAGE_KEYS, USER_MESSAGE_KEYS, isUserMessageKey, } from './diagnostics/messageKeys';
+export type { PaymentDeveloperMessageKey, PaymentDeveloperMessageMap, PaymentMessageKey, PaymentMessageMap, PaymentUserMessageKey, PaymentUserMessageMap, } from './diagnostics/messageKeys';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,YAAY,EACX,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,cAAc,EACd,WAAW,EACX,aAAa,EACb,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,eAAe,EACf,cAAc,EACd,WAAW,EACX,eAAe,EACf,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,2BAA2B,GAC3B,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EACN,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,mCAAmC,EACnC,wBAAwB,EACxB,uCAAuC,EACvC,4BAA4B,EAC5B,gCAAgC,EAChC,kCAAkC,EAClC,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,+BAA+B,EAC/B,mCAAmC,EACnC,wBAAwB,EACxB,4BAA4B,EAC5B,8BAA8B,EAC9B,kBAAkB,EAClB,mBAAmB,GACnB,MAAM,eAAe,CAAC;AAGvB,YAAY,EACX,cAAc,EACd,oBAAoB,EACpB,KAAK,EACL,WAAW,EACX,kBAAkB,GAClB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAG/E,YAAY,EACX,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GAClB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAO1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,YAAY,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAG1E,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EACX,UAAU,EACV,WAAW,EACX,aAAa,EACb,cAAc,EACd,WAAW,GACX,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC5E,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EACN,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,WAAW,EACX,OAAO,GACP,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGzF,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC7F,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,YAAY,EACX,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,GACX,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EACN,0BAA0B,EAC1B,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,GAChB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACX,0BAA0B,EAC1B,0BAA0B,EAC1B,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,GACrB,MAAM,2BAA2B,CAAC"}

package/lib/typescript/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/lib/typescript/commonjs/persistence/mmkv-store.d.ts

@@ -0,0 +1,45 @@
+/**
+ * MMKV-backed snapshot store.
+ *
+ * Every MMKV import is confined to this file, so the rest of the package stays
+ * testable without a native module.
+ *
+ * MMKV is chosen because it is **synchronous**, which is what lets
+ * `getEntitlement` be an in-memory read with no I/O on render paths (PERF-001).
+ * An async store would force either an async entitlement read or a hidden
+ * hydration race on every call.
+ *
+ * Records are partitioned by cache-scope token (FR-057a). The token is a
+ * partition key and nothing more: never interpreted, never transmitted, never
+ * attached to a transaction.
+ */
+import { type MmkvLike } from '@chipmobilesdk/rn-core';
+import { type PersistedSnapshot } from './snapshot';
+export interface SnapshotStore {
+    load(scopeToken?: string): PersistedSnapshot;
+    /**
+     * Writes the snapshot. Returns false when the write failed, so the engine can
+     * say so; a store returning nothing is taken to have succeeded.
+     */
+    save(snapshot: PersistedSnapshot): boolean | void;
+    /** Clears every scope — for logout and data-deletion requests (FR-057). */
+    clearAll(): void;
+    /** Whether writes actually persist. False means the memory fallback is active. */
+    isDurable(): boolean;
+}
+/**
+ * Creates the store.
+ *
+ * The memory fallback is a **documented degradation**, not a silent one: without
+ * MMKV the snapshot does not survive a cold start, so entitlements read `unknown`
+ * until the first sync. That is safe by construction — `unknown`, never
+ * `not_entitled` (FR-047) — and FR-059's startup sync repairs it. `isDurable()`
+ * lets the engine warn, so the condition is visible rather than mysterious.
+ */
+export declare function createSnapshotStore(injected?: {
+    backing: MmkvLike;
+    durable: boolean;
+}): SnapshotStore;
+/** Test seam for driving the store without the native module. */
+export declare function createMemorySnapshotStore(): SnapshotStore;
+//# sourceMappingURL=mmkv-store.d.ts.map

package/lib/typescript/commonjs/persistence/mmkv-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mmkv-store.d.ts","sourceRoot":"","sources":["../../../../src/persistence/mmkv-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAA+C,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEpG,OAAO,EAAkC,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAcpF,MAAM,WAAW,aAAa;IAC7B,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAAC;IAC7C;;;OAGG;IACH,IAAI,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,GAAG,IAAI,CAAC;IAClD,2EAA2E;IAC3E,QAAQ,IAAI,IAAI,CAAC;IACjB,kFAAkF;IAClF,SAAS,IAAI,OAAO,CAAC;CACrB;AAkCD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,CAAC,EAAE;IAC9C,OAAO,EAAE,QAAQ,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CACjB,GAAG,aAAa,CA4DhB;AAED,iEAAiE;AACjE,wBAAgB,yBAAyB,IAAI,aAAa,CAYzD"}

package/lib/typescript/commonjs/persistence/snapshot.d.ts

@@ -0,0 +1,106 @@
+/**
+ * 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.
+ */
+import type { ProductKey, ProductType } from '../config/types';
+/**
+ * 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 declare const SNAPSHOT_SCHEMA_VERSION = 2;
+/** Where a transaction stands with the store. */
+export type PersistedPurchaseState = 'pending' | 'purchased' | 'consumed' | 'revoked';
+/**
+ * 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).
+ */
+export type PersistedFinalizeState = 'not_required' | 'queued' | 'in_flight' | 'done' | 'failed';
+/** Whether the app's backend has ruled on this transaction (FR-072a). */
+export type PersistedValidationState = 'not_required' | 'approved' | 'rejected' | 'queued_for_revalidation';
+export interface PersistedPurchase {
+    transactionId: string;
+    productKey: ProductKey;
+    productType: ProductType;
+    token: string;
+    state: PersistedPurchaseState;
+    purchasedAt: number;
+    finalizeState: PersistedFinalizeState;
+    /** Attempts consumed. Carried across sessions so retry stays bounded per session. */
+    attempts: number;
+    validationState: PersistedValidationState;
+    expiresAt?: number;
+    willAutoRenew?: boolean;
+}
+export interface PersistedSnapshot {
+    schemaVersion: number;
+    /** Opaque partition key. Stored only to scope this record (FR-057a). */
+    scopeToken?: string;
+    purchases: PersistedPurchase[];
+    lastSyncedAt?: number;
+}
+export declare function emptySnapshot(scopeToken?: string): PersistedSnapshot;
+/**
+ * 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).
+ */
+export interface SnapshotMigration {
+    from: number;
+    to: number;
+    migrate(input: Record<string, unknown>): Record<string, unknown>;
+}
+/** Registered migrations, one hop each. */
+export declare const SNAPSHOT_MIGRATIONS: readonly SnapshotMigration[];
+export type MigrationOutcome = {
+    ok: true;
+    snapshot: PersistedSnapshot;
+    migrated: boolean;
+}
+/**
+ * Unreadable records are discarded, not repaired.
+ *
+ * Safe because discarding yields `unknown`, never a false `not_entitled`
+ * (FR-055a), and the next sync rebuilds from the store — the authoritative
+ * source anyway. Guessing at a corrupt record risks granting or withholding
+ * wrongly, which is worse than a short `unknown` window.
+ */
+ | {
+    ok: false;
+    reason: 'unreadable' | 'unsupported_version';
+};
+export declare function migrateSnapshot(raw: unknown): MigrationOutcome;
+/**
+ * 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 declare function resolveFinalizeState(incoming: {
+    state: 'purchased' | 'pending' | 'unspecified';
+    isAcknowledged: boolean;
+}, existing: {
+    finalizeState: PersistedFinalizeState;
+} | undefined): PersistedFinalizeState;
+/** Transactions still owed a finalize call, drained at startup and on foreground (FR-042). */
+export declare function pendingFinalizations(snapshot: PersistedSnapshot): PersistedPurchase[];
+//# sourceMappingURL=snapshot.d.ts.map

package/lib/typescript/commonjs/persistence/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../../src/persistence/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,iDAAiD;AACjD,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAEtF;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAAG,cAAc,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEjG,yEAAyE;AACzE,MAAM,MAAM,wBAAwB,GACnC,cAAc,GAAG,UAAU,GAAG,UAAU,GAAG,yBAAyB,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,sBAAsB,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,sBAAsB,CAAC;IACtC,qFAAqF;IACrF,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,wBAAwB,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAOpE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjE;AAED,2CAA2C;AAC3C,eAAO,MAAM,mBAAmB,EAAE,SAAS,iBAAiB,EAsB3D,CAAC;AAEF,MAAM,MAAM,gBAAgB,GACzB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,iBAAiB,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE;AAC9D;;;;;;;GAOG;GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,YAAY,GAAG,qBAAqB,CAAA;CAAE,CAAC;AAE/D,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAgC9D;AAgGD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CACnC,QAAQ,EAAE;IAAE,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,aAAa,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAE,EACrF,QAAQ,EAAE;IAAE,aAAa,EAAE,sBAAsB,CAAA;CAAE,GAAG,SAAS,GAC7D,sBAAsB,CAoBxB;AAED,8FAA8F;AAC9F,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,iBAAiB,EAAE,CAQrF"}

package/lib/typescript/commonjs/react/PaymentProvider.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 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, { type PropsWithChildren } from 'react';
+import { type EngineDeps, type PaymentEngine } from '../engine/engine';
+import type { PaymentConfig } from '../config/types';
+interface OwnedEngineProps {
+    config: PaymentConfig;
+    /**
+     * The store provider and storage. Usually `{ provider: createStoreProvider() }`;
+     * a test or the demo app supplies the fake store here.
+     */
+    deps: EngineDeps;
+    /**
+     * When this changes, the provider builds a new engine. Defaults to
+     * `config.scopeToken`, so switching accounts gets a fresh one. `config` and
+     * `deps` themselves are read when an engine is built and may be inline objects:
+     * a new object on every render no longer reconnects to the store (PAY-07).
+     */
+    engineKey?: string;
+    engine?: undefined;
+}
+interface ExternalEngineProps {
+    /**
+     * An engine the app created and owns. The provider shares it with the tree and
+     * neither initializes nor cleans it up.
+     */
+    engine: PaymentEngine;
+    config?: undefined;
+    deps?: undefined;
+    engineKey?: undefined;
+}
+export type PaymentProviderProps = (OwnedEngineProps | ExternalEngineProps) & {
+    /** Skip automatic initialization when the app wants to control the moment. */
+    autoInitialize?: boolean;
+    /**
+     * Call `handleForeground()` each time the app returns from the background, through
+     * rn-core's shared lifecycle port. Off by default: what counts as a foreground
+     * return is the app's decision (FR-059).
+     */
+    syncOnForeground?: boolean;
+};
+export declare function PaymentProvider(props: PropsWithChildren<PaymentProviderProps>): React.ReactElement;
+/**
+ * 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 declare function usePaymentEngine(): PaymentEngine;
+export {};
+//# sourceMappingURL=PaymentProvider.d.ts.map

package/lib/typescript/commonjs/react/PaymentProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PaymentProvider.d.ts","sourceRoot":"","sources":["../../../../src/react/PaymentProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,EAMb,KAAK,iBAAiB,EACtB,MAAM,OAAO,CAAC;AACf,OAAO,EAAgB,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAErF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIrD,UAAU,gBAAgB;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB;;;OAGG;IACH,IAAI,EAAE,UAAU,CAAC;IACjB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,UAAU,mBAAmB;IAC5B;;;OAGG;IACH,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,SAAS,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,gBAAgB,GAAG,mBAAmB,CAAC,GAAG;IAC7E,8EAA8E;IAC9E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,wBAAgB,eAAe,CAC9B,KAAK,EAAE,iBAAiB,CAAC,oBAAoB,CAAC,GAC5C,KAAK,CAAC,YAAY,CAyDpB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAShD"}

package/lib/typescript/commonjs/react/hooks.d.ts

@@ -0,0 +1,80 @@
+/**
+ * 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 type { EntitlementKey, FinalizeResult, PaymentStatus, PendingPurchasesState, ProductKey, PurchaseOptions, PurchaseResult, TransactionRef } from '../config/types';
+import type { EntitlementMap, EntitlementState } from '../entitlements/aggregate';
+import type { PaymentError } from '../diagnostics/errors';
+import type { MissingProduct, ProductInfo } from '../engine/products';
+import type { RestoreOutcome, SyncOutcome } from '../engine/engine';
+/**
+ * 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 declare function useEntitlement(key: EntitlementKey): EntitlementState;
+/** Every entitlement at once, for a screen that shows overall plan state. */
+export declare function useEntitlements(): EntitlementMap;
+/**
+ * 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 declare function usePendingPurchases(productKeys?: readonly string[]): PendingPurchasesState;
+/** Package status, so an app can tell "cannot sell here" from "not paid" (FR-022). */
+export declare function usePaymentStatus(): PaymentStatus;
+export interface UsePurchaseResult {
+    purchase: (productKey: ProductKey, options?: PurchaseOptions) => Promise<PurchaseResult>;
+    consume: (ref: TransactionRef) => Promise<FinalizeResult>;
+    isPurchasing: boolean;
+    /** The last outcome, so a screen can render cancellation differently from failure. */
+    lastResult: PurchaseResult | undefined;
+}
+/**
+ * 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 declare function usePurchase(): UsePurchaseResult;
+export interface UseProductsResult {
+    products: ProductInfo[];
+    /** Reported so a paywall explains an absent row instead of rendering a blank. */
+    missing: MissingProduct[];
+    isLoading: boolean;
+    error: PaymentError | undefined;
+    refresh: () => Promise<void>;
+}
+/**
+ * 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 declare function useProducts(productKeys: readonly string[]): UseProductsResult;
+export interface UseSyncResult {
+    sync: () => Promise<SyncOutcome>;
+    restore: () => Promise<RestoreOutcome>;
+    isSyncing: boolean;
+    lastSyncedAt: number | undefined;
+}
+/**
+ * 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 declare function useSync(): UseSyncResult;
+//# sourceMappingURL=hooks.d.ts.map

package/lib/typescript/commonjs/react/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../../src/react/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EACX,cAAc,EACd,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,UAAU,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpE;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,gBAAgB,CASpE;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,IAAI,cAAc,CAGhD;AAWD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,qBAAqB,CAe1F;AAED,sFAAsF;AACtF,wBAAgB,gBAAgB,IAAI,aAAa,CAGhD;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACzF,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1D,YAAY,EAAE,OAAO,CAAC;IACtB,sFAAsF;IACtF,UAAU,EAAE,cAAc,GAAG,SAAS,CAAC;CACvC;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,IAAI,iBAAiB,CAyB/C;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,iFAAiF;IACjF,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,YAAY,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,iBAAiB,CAoD7E;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,IAAI,aAAa,CA4BvC"}

package/lib/typescript/commonjs/testing/conformance.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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 { type Check, type ConformanceReport } from '@chipmobilesdk/rn-core/testing';
+import type { ProviderPort } from '../adapter/port';
+import type { ProductType } from '../config/types';
+export interface StoreProductSpec {
+    readonly storeProductId: string;
+    readonly productType: ProductType;
+    /** As the store formats it; the port must pass it through untouched. */
+    readonly formattedPrice: string;
+}
+export interface OwnedPurchaseSpec {
+    readonly storeProductId: string;
+    readonly token: string;
+    readonly state: 'purchased' | 'pending';
+}
+export interface StoreScenario {
+    readonly products: readonly StoreProductSpec[];
+    readonly owned: readonly OwnedPurchaseSpec[];
+}
+export interface ProviderSubject {
+    readonly port: ProviderPort;
+    /** How the next purchase flow the user starts ends. */
+    nextPurchaseEnds(outcome: 'bought' | 'cancelled'): void;
+    /** The billing service goes away underneath the app. */
+    dropService(): void;
+}
+export interface ProviderHarness {
+    create(scenario: StoreScenario): ProviderSubject;
+}
+/** The store every check runs against. */
+export declare const CONFORMANCE_STORE: StoreScenario;
+export declare const providerPortChecks: readonly Check<ProviderHarness>[];
+export declare function runProviderPortConformance(harness: ProviderHarness): Promise<ConformanceReport>;
+//# sourceMappingURL=conformance.d.ts.map

package/lib/typescript/commonjs/testing/conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.d.ts","sourceRoot":"","sources":["../../../../src/testing/conformance.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAGN,KAAK,KAAK,EACV,KAAK,iBAAiB,EACtB,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,wEAAwE;IACxE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,uDAAuD;IACvD,gBAAgB,CAAC,OAAO,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI,CAAC;IACxD,wDAAwD;IACxD,WAAW,IAAI,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC/B,MAAM,CAAC,QAAQ,EAAE,aAAa,GAAG,eAAe,CAAC;CACjD;AAED,0CAA0C;AAC1C,eAAO,MAAM,iBAAiB,EAAE,aAiB/B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,SAAS,KAAK,CAAC,eAAe,CAAC,EAgG/D,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAE/F"}

package/lib/typescript/commonjs/testing/fakeStore.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Fake store — a full `ProviderPort` implementation for automated tests.
+ *
+ * Lives behind `@chipmobilesdk/rn-payment/testing` so test doubles cannot reach a
+ * production bundle.
+ *
+ * Nearly every requirement in this package concerns a rare ordering or failure
+ * path — a pending purchase settling two sessions later, an app killed between
+ * payment and acknowledgement, a billing connection dropping mid-sync. None of
+ * those are reachable on a real device on demand, so this is what makes them
+ * testable at all (NFR-007, SC-008).
+ */
+import type { ProviderCapabilities, ProviderConnectOutcome, ProviderFailureReason, ProviderPort, ProviderProduct, ProviderPurchase, ProviderToken, StoreProductId } from '../adapter/port';
+export interface FakeStoreOptions {
+    /** Fails `connect` until `setConnectOutcome` says otherwise. */
+    connectOutcome?: ProviderConnectOutcome;
+    capabilities?: Partial<ProviderCapabilities>;
+    products?: ProviderProduct[];
+    owned?: ProviderPurchase[];
+    /**
+     * `'android-16.7'` mirrors the Play binding the real adapter wraps: a launched
+     * purchase is also delivered through `observePurchases`, so the engine sees it
+     * twice, and capabilities match Android's. The default delivers it once, which
+     * is simpler but hides any double-settle on the device path.
+     */
+    mode?: 'default' | 'android-16.7';
+}
+export interface FakeStore extends ProviderPort {
+    /** Next `launchPurchase` succeeds and yields this purchase. */
+    scriptPurchaseSuccess(overrides?: Partial<ProviderPurchase>): void;
+    /** Next `launchPurchase` fails with this reason — cancellation included (FR-032). */
+    scriptPurchaseFailure(reason: ProviderFailureReason): void;
+    /** Next `launchPurchase` returns a purchase in the pending state (FR-037). */
+    scriptPurchasePending(overrides?: Partial<ProviderPurchase>): void;
+    setOwned(purchases: ProviderPurchase[]): void;
+    /** Push a purchase through `observePurchases`, as a settling pending one does. */
+    pushPurchaseUpdate(purchase: ProviderPurchase): void;
+    /** Stop reporting a transaction as valid — a refund or revocation (FR-064). */
+    revoke(transactionId: string): void;
+    /** The money arrives: the owned record turns `purchased` (FR-039). */
+    settlePending(transactionId: string): void;
+    /** The payment is declined or abandoned: the store stops reporting it (FR-040). */
+    cancelPending(transactionId: string): void;
+    /**
+     * The pending window runs out. Reported through `pendingEndReason`, which a
+     * store that knows implements — Play does not, so on device this is
+     * indistinguishable from `cancelPending` (FR-102).
+     */
+    expirePending(transactionId: string): void;
+    setProducts(products: ProviderProduct[]): void;
+    setConnectOutcome(outcome: ProviderConnectOutcome): void;
+    /** Drop the connection, as the billing service does (FR-020). */
+    dropConnection(reason?: string): void;
+    restoreConnection(): void;
+    /** Make `acknowledge`/`consume` fail, to exercise bounded retry (FR-045). */
+    setFinalizeFailure(failing: boolean): void;
+    acknowledged(): ProviderToken[];
+    consumed(): ProviderToken[];
+    connectCount(): number;
+    launchCount(): number;
+    queryOwnedCount(): number;
+    disconnectCount(): number;
+    subscriptionManagementOpenedFor(): (StoreProductId | undefined)[];
+    reset(): void;
+}
+/** A purchase with sensible defaults, so tests state only what they care about. */
+export declare function makePurchase(overrides?: Partial<ProviderPurchase>): ProviderPurchase;
+export declare function createFakeStore(options?: FakeStoreOptions): FakeStore;
+//# sourceMappingURL=fakeStore.d.ts.map

package/lib/typescript/commonjs/testing/fakeStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fakeStore.d.ts","sourceRoot":"","sources":["../../../../src/testing/fakeStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EACX,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,YAAY,EAEZ,eAAe,EACf,gBAAgB,EAGhB,aAAa,EACb,cAAc,EACd,MAAM,iBAAiB,CAAC;AAGzB,MAAM,WAAW,gBAAgB;IAChC,gEAAgE;IAChE,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,YAAY,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC7C,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC3B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,cAAc,CAAC;CAClC;AAED,MAAM,WAAW,SAAU,SAAQ,YAAY;IAE9C,+DAA+D;IAC/D,qBAAqB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;IACnE,qFAAqF;IACrF,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC3D,8EAA8E;IAC9E,qBAAqB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;IAGnE,QAAQ,CAAC,SAAS,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;IAC9C,kFAAkF;IAClF,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACrD,+EAA+E;IAC/E,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAMpC,sEAAsE;IACtE,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,mFAAmF;IACnF,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C;;;;OAIG;IACH,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,WAAW,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;IAG/C,iBAAiB,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACzD,iEAAiE;IACjE,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,iBAAiB,IAAI,IAAI,CAAC;IAG1B,6EAA6E;IAC7E,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAG3C,YAAY,IAAI,aAAa,EAAE,CAAC;IAChC,QAAQ,IAAI,aAAa,EAAE,CAAC;IAC5B,YAAY,IAAI,MAAM,CAAC;IACvB,WAAW,IAAI,MAAM,CAAC;IACtB,eAAe,IAAI,MAAM,CAAC;IAC1B,eAAe,IAAI,MAAM,CAAC;IAC1B,+BAA+B,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC,EAAE,CAAC;IAClE,KAAK,IAAI,IAAI,CAAC;CACd;AAoBD,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,SAAS,GAAE,OAAO,CAAC,gBAAgB,CAAM,GAAG,gBAAgB,CAaxF;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,SAAS,CAmOzE"}

package/lib/typescript/commonjs/testing/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `@chipmobilesdk/rn-payment/testing` — test doubles.
+ *
+ * A separate entrypoint so the fake store cannot reach a production bundle
+ * (LIB-003). Nothing here is part of the package's public runtime contract.
+ */
+export { createFakeStore, makePurchase } from './fakeStore';
+export type { FakeStore, FakeStoreOptions } from './fakeStore';
+export { createMemorySnapshotStore } from '../persistence/mmkv-store';
+export { CONFORMANCE_STORE, providerPortChecks, runProviderPortConformance } from './conformance';
+export type { OwnedPurchaseSpec, ProviderHarness, ProviderSubject, StoreProductSpec, StoreScenario, } from './conformance';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC5D,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAClG,YAAY,EACX,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,aAAa,GACb,MAAM,eAAe,CAAC"}

package/lib/typescript/module/adapter/createStoreProvider.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 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).
+ */
+import type { ProductType } from '../config/types.js';
+import type { ProviderPort } from './port.js';
+/**
+ * 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.
+ */
+declare function createUnsupportedProvider(): ProviderPort;
+export interface StoreProviderOptions {
+    /**
+     * Force the unsupported stub regardless of platform.
+     *
+     * Useful for an app that wants to ship one build with selling switched off at
+     * the provider level rather than through the `enabled` flag.
+     */
+    forceUnsupported?: boolean;
+}
+/**
+ * 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.
+ */
+export declare function createStoreProvider(options?: StoreProviderOptions): ProviderPort;
+/** Exported for a test or a screen that needs the stub explicitly. */
+export { createUnsupportedProvider };
+export type { ProductType };
+//# sourceMappingURL=createStoreProvider.d.ts.map

package/lib/typescript/module/adapter/createStoreProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createStoreProvider.d.ts","sourceRoot":"","sources":["../../../../src/adapter/createStoreProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,oBAAiB,CAAC;AAEhE,OAAO,KAAK,EAGX,YAAY,EAKZ,MAAM,WAAQ,CAAC;AAahB;;;;;;;GAOG;AACH,iBAAS,yBAAyB,IAAI,YAAY,CAqCjD;AAED,MAAM,WAAW,oBAAoB;IACpC;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG,YAAY,CAQpF;AAED,sEAAsE;AACtE,OAAO,EAAE,yBAAyB,EAAE,CAAC;AAErC,YAAY,EAAE,WAAW,EAAE,CAAC"}