@chipmobilesdk/rn-payment 0.4.0 → 0.5.0

package/src/adapter/createStoreProvider.ts

@@ -1,118 +1,116 @@
-/**
- * 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 { Platform } from 'react-native';
-import type { ProductType, Unsubscribe } from '../config/types';
-import { createIapAdapter } from './iap-adapter';
-import type {
-	ProviderCapabilities,
-	ProviderConnectOutcome,
-	ProviderPort,
-	ProviderPriceChangeOutcome,
-	ProviderProduct,
-	ProviderPurchase,
-	ProviderPurchaseOutcome,
-} from './port';
-
-const UNSUPPORTED_CAPABILITIES: ProviderCapabilities = {
-	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(): ProviderPort {
-	return {
-		async connect(): Promise<ProviderConnectOutcome> {
-			return { ok: false, reason: 'platform_unsupported', retryable: false };
-		},
-		async disconnect(): Promise<void> {
-			// Nothing was ever connected.
-		},
-		observeConnection(): Unsubscribe {
-			return () => undefined;
-		},
-		async queryProducts(): Promise<ProviderProduct[]> {
-			return [];
-		},
-		async queryOwned(): Promise<ProviderPurchase[]> {
-			return [];
-		},
-		async launchPurchase(): Promise<ProviderPurchaseOutcome> {
-			return { ok: false, reason: 'not_ready', detail: 'platform_unsupported' };
-		},
-		observePurchases(): Unsubscribe {
-			return () => undefined;
-		},
-		async acknowledge(): Promise<void> {
-			// No transaction can exist to acknowledge.
-		},
-		async consume(): Promise<void> {
-			// As above.
-		},
-		async openSubscriptionManagement(): Promise<void> {
-			// No store screen to open.
-		},
-		async confirmPriceChange(): Promise<ProviderPriceChangeOutcome> {
-			return { ok: false, reason: 'not_ready' };
-		},
-		capabilities: () => UNSUPPORTED_CAPABILITIES,
-	};
-}
-
-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 function createStoreProvider(
-	options: StoreProviderOptions = {},
-): ProviderPort {
-	if (options.forceUnsupported) {
-		return createUnsupportedProvider();
-	}
-	if (Platform.OS === 'android') {
-		return createIapAdapter();
-	}
-	return createUnsupportedProvider();
-}
-
-/** Exported for a test or a screen that needs the stub explicitly. */
-export { createUnsupportedProvider };
-
-export type { ProductType };
+/**
+ * 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 { Platform } from 'react-native';
+import type { ProductType, Unsubscribe } from '../config/types';
+import { createIapAdapter } from './iap-adapter';
+import type {
+	ProviderCapabilities,
+	ProviderConnectOutcome,
+	ProviderPort,
+	ProviderPriceChangeOutcome,
+	ProviderProduct,
+	ProviderPurchase,
+	ProviderPurchaseOutcome,
+} from './port';
+
+const UNSUPPORTED_CAPABILITIES: ProviderCapabilities = {
+	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(): ProviderPort {
+	return {
+		async connect(): Promise<ProviderConnectOutcome> {
+			return { ok: false, reason: 'platform_unsupported', retryable: false };
+		},
+		async disconnect(): Promise<void> {
+			// Nothing was ever connected.
+		},
+		observeConnection(): Unsubscribe {
+			return () => undefined;
+		},
+		async queryProducts(): Promise<ProviderProduct[]> {
+			return [];
+		},
+		async queryOwned(): Promise<ProviderPurchase[]> {
+			return [];
+		},
+		async launchPurchase(): Promise<ProviderPurchaseOutcome> {
+			return { ok: false, reason: 'not_ready', detail: 'platform_unsupported' };
+		},
+		observePurchases(): Unsubscribe {
+			return () => undefined;
+		},
+		async acknowledge(): Promise<void> {
+			// No transaction can exist to acknowledge.
+		},
+		async consume(): Promise<void> {
+			// As above.
+		},
+		async openSubscriptionManagement(): Promise<void> {
+			// No store screen to open.
+		},
+		async confirmPriceChange(): Promise<ProviderPriceChangeOutcome> {
+			return { ok: false, reason: 'not_ready' };
+		},
+		capabilities: () => UNSUPPORTED_CAPABILITIES,
+	};
+}
+
+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 function createStoreProvider(options: StoreProviderOptions = {}): ProviderPort {
+	if (options.forceUnsupported) {
+		return createUnsupportedProvider();
+	}
+	if (Platform.OS === 'android') {
+		return createIapAdapter();
+	}
+	return createUnsupportedProvider();
+}
+
+/** Exported for a test or a screen that needs the stub explicitly. */
+export { createUnsupportedProvider };
+
+export type { ProductType };