react-native-iap 10.1.0 → 10.1.2

package/lib/module/types/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["ProrationModesAndroid","PurchaseStateAndroid","PROMOTED_PRODUCT","InstallSourceAndroid","ProductType"],"sources":["index.ts"],"sourcesContent":["import type {\n  AmazonModuleProps,\n  AndroidModuleProps,\n  IosModuleProps,\n} from '../modules';\n\nexport type Sku = string;\n\nexport enum ProrationModesAndroid {\n  IMMEDIATE_WITH_TIME_PRORATION = 1,\n  IMMEDIATE_AND_CHARGE_PRORATED_PRICE = 2,\n  IMMEDIATE_WITHOUT_PRORATION = 3,\n  DEFERRED = 4,\n  IMMEDIATE_AND_CHARGE_FULL_PRICE = 5,\n  UNKNOWN_SUBSCRIPTION_UPGRADE_DOWNGRADE_POLICY = 0,\n}\n\nexport enum PurchaseStateAndroid {\n  UNSPECIFIED_STATE = 0,\n  PURCHASED = 1,\n  PENDING = 2,\n}\n\nexport const PROMOTED_PRODUCT = 'iap-promoted-product';\n\nexport enum InstallSourceAndroid {\n  NOT_SET = 0,\n  GOOGLE_PLAY = 1,\n  AMAZON = 2,\n}\n\nexport enum ProductType {\n  /** Subscription */\n  subs = 'subs',\n\n  /** Subscription */\n  sub = 'sub',\n\n  /** Consumable */\n  inapp = 'inapp',\n\n  /** Consumable */\n  iap = 'iap',\n}\n\nexport interface ProductCommon {\n  type: 'subs' | 'sub' | 'inapp' | 'iap';\n  productId: string;\n  productIds?: string[];\n  title: string;\n  description: string;\n  price: string;\n  currency: string;\n  localizedPrice: string;\n  countryCode?: string;\n}\n\nexport interface ProductPurchase {\n  productId: string;\n  transactionId?: string;\n  transactionDate: number;\n  transactionReceipt: string;\n  purchaseToken?: string;\n  //iOS\n  quantityIOS?: number;\n  originalTransactionDateIOS?: string;\n  originalTransactionIdentifierIOS?: string;\n  //Android\n  productIds?: string[];\n  dataAndroid?: string;\n  signatureAndroid?: string;\n  autoRenewingAndroid?: boolean;\n  purchaseStateAndroid?: PurchaseStateAndroid;\n  isAcknowledgedAndroid?: boolean;\n  packageNameAndroid?: string;\n  developerPayloadAndroid?: string;\n  obfuscatedAccountIdAndroid?: string;\n  obfuscatedProfileIdAndroid?: string;\n  //Amazon\n  userIdAmazon?: string;\n  userMarketplaceAmazon?: string;\n  userJsonAmazon?: string;\n  isCanceledAmazon?: boolean;\n}\n\nexport interface PurchaseResult {\n  responseCode?: number;\n  debugMessage?: string;\n  code?: string;\n  message?: string;\n  purchaseToken?: string;\n}\n\nexport interface SubscriptionPurchase extends ProductPurchase {\n  autoRenewingAndroid?: boolean;\n  originalTransactionDateIOS?: string;\n  originalTransactionIdentifierIOS?: string;\n}\n\nexport type Purchase = ProductPurchase | SubscriptionPurchase;\n\nexport interface Discount {\n  identifier: string;\n  type: string;\n  numberOfPeriods: string;\n  price: string;\n  localizedPrice: string;\n  paymentMode: '' | 'FREETRIAL' | 'PAYASYOUGO' | 'PAYUPFRONT';\n  subscriptionPeriod: string;\n}\n\nexport interface Product extends ProductCommon {\n  type: 'inapp' | 'iap';\n  // Android V5\n  oneTimePurchaseOfferDetails?: {\n    priceCurrencyCode: string;\n    formattedPrice: string;\n    priceAmountMicros: string;\n  };\n}\n\n// Android V5\nexport interface SubscriptionAndroid extends ProductCommon {\n  type: 'subs';\n\n  productType?: string;\n  name?: string;\n  subscriptionOfferDetails?: {\n    offerToken: string;\n    pricingPhases: {\n      pricingPhaseList: {\n        formattedPrice: string;\n        priceCurrencyCode: string;\n        /**\n         * P1W, P1M, P1Y\n         */\n        billingPeriod: string;\n        billingCycleCount: number;\n        priceAmountMicros: string;\n        recurrenceMode: number;\n      }[];\n    };\n  }[];\n}\n\nexport interface SubscriptionIOS extends ProductCommon {\n  type: 'subs';\n\n  discounts?: Discount[];\n  introductoryPrice?: string;\n  introductoryPriceAsAmountIOS?: string;\n  introductoryPricePaymentModeIOS?:\n    | ''\n    | 'FREETRIAL'\n    | 'PAYASYOUGO'\n    | 'PAYUPFRONT';\n  introductoryPriceNumberOfPeriodsIOS?: string;\n  introductoryPriceSubscriptionPeriodIOS?:\n    | 'DAY'\n    | 'WEEK'\n    | 'MONTH'\n    | 'YEAR'\n    | '';\n\n  subscriptionPeriodNumberIOS?: string;\n  subscriptionPeriodUnitIOS?: '' | 'YEAR' | 'MONTH' | 'WEEK' | 'DAY';\n}\n\nexport type Subscription = SubscriptionAndroid & SubscriptionIOS;\n\n/**\n * In order to purchase a new subscription, every sku must have a selected offerToken\n * @see SubscriptionAndroid.subscriptionOfferDetails.offerToken\n */\nexport interface SubscriptionOffer {\n  sku: Sku;\n  offerToken: string;\n}\n\ndeclare module 'react-native' {\n  interface NativeModulesStatic {\n    RNIapIos: IosModuleProps;\n    RNIapModule: AndroidModuleProps;\n    RNIapAmazonModule: AmazonModuleProps;\n  }\n}\n"],"mappings":"AAQA,WAAYA,qBAAZ;;WAAYA,qB;EAAAA,qB,CAAAA,qB;EAAAA,qB,CAAAA,qB;EAAAA,qB,CAAAA,qB;EAAAA,qB,CAAAA,qB;EAAAA,qB,CAAAA,qB;EAAAA,qB,CAAAA,qB;GAAAA,qB,KAAAA,qB;;AASZ,WAAYC,oBAAZ;;WAAYA,oB;EAAAA,oB,CAAAA,oB;EAAAA,oB,CAAAA,oB;EAAAA,oB,CAAAA,oB;GAAAA,oB,KAAAA,oB;;AAMZ,OAAO,MAAMC,gBAAgB,GAAG,sBAAzB;AAEP,WAAYC,oBAAZ;;WAAYA,oB;EAAAA,oB,CAAAA,oB;EAAAA,oB,CAAAA,oB;EAAAA,oB,CAAAA,oB;GAAAA,oB,KAAAA,oB;;AAMZ,WAAYC,WAAZ;;WAAYA,W;EAAAA,W;EAAAA,W;EAAAA,W;EAAAA,W;GAAAA,W,KAAAA,W"}
+{"version":3,"names":["ProrationModesAndroid","PurchaseStateAndroid","PROMOTED_PRODUCT","InstallSourceAndroid","ProductType"],"sources":["index.ts"],"sourcesContent":["import type {\n  AmazonModuleProps,\n  AndroidModuleProps,\n  IosModuleProps,\n} from '../modules';\n\nimport type * as Apple from './apple';\n\nexport type Sku = string;\n\nexport enum ProrationModesAndroid {\n  IMMEDIATE_WITH_TIME_PRORATION = 1,\n  IMMEDIATE_AND_CHARGE_PRORATED_PRICE = 2,\n  IMMEDIATE_WITHOUT_PRORATION = 3,\n  DEFERRED = 4,\n  IMMEDIATE_AND_CHARGE_FULL_PRICE = 5,\n  UNKNOWN_SUBSCRIPTION_UPGRADE_DOWNGRADE_POLICY = 0,\n}\n\nexport enum PurchaseStateAndroid {\n  UNSPECIFIED_STATE = 0,\n  PURCHASED = 1,\n  PENDING = 2,\n}\n\nexport const PROMOTED_PRODUCT = 'iap-promoted-product';\n\nexport enum InstallSourceAndroid {\n  NOT_SET = 0,\n  GOOGLE_PLAY = 1,\n  AMAZON = 2,\n}\n\nexport enum ProductType {\n  /** Subscription */\n  subs = 'subs',\n\n  /** Subscription */\n  sub = 'sub',\n\n  /** Consumable */\n  inapp = 'inapp',\n\n  /** Consumable */\n  iap = 'iap',\n}\n\nexport interface ProductCommon {\n  type: 'subs' | 'sub' | 'inapp' | 'iap';\n  productId: string; //iOS\n  productIds?: string[];\n  title: string;\n  description: string;\n  price: string;\n  currency: string;\n  localizedPrice: string;\n  countryCode?: string;\n}\n\nexport interface ProductPurchase {\n  productId: string;\n  transactionId?: string;\n  transactionDate: number;\n  transactionReceipt: string;\n  purchaseToken?: string;\n  //iOS\n  quantityIOS?: number;\n  originalTransactionDateIOS?: string;\n  originalTransactionIdentifierIOS?: string;\n  //Android\n  productIds?: string[];\n  dataAndroid?: string;\n  signatureAndroid?: string;\n  autoRenewingAndroid?: boolean;\n  purchaseStateAndroid?: PurchaseStateAndroid;\n  isAcknowledgedAndroid?: boolean;\n  packageNameAndroid?: string;\n  developerPayloadAndroid?: string;\n  obfuscatedAccountIdAndroid?: string;\n  obfuscatedProfileIdAndroid?: string;\n  //Amazon\n  userIdAmazon?: string;\n  userMarketplaceAmazon?: string;\n  userJsonAmazon?: string;\n  isCanceledAmazon?: boolean;\n}\n\nexport interface PurchaseResult {\n  responseCode?: number;\n  debugMessage?: string;\n  code?: string;\n  message?: string;\n  purchaseToken?: string;\n}\n\nexport interface SubscriptionPurchase extends ProductPurchase {\n  autoRenewingAndroid?: boolean;\n  originalTransactionDateIOS?: string;\n  originalTransactionIdentifierIOS?: string;\n}\n\nexport type Purchase = ProductPurchase | SubscriptionPurchase;\n\nexport interface Discount {\n  identifier: string;\n  type: string;\n  numberOfPeriods: string;\n  price: string;\n  localizedPrice: string;\n  paymentMode: '' | 'FREETRIAL' | 'PAYASYOUGO' | 'PAYUPFRONT';\n  subscriptionPeriod: string;\n}\n\nexport interface ProductAndroid extends ProductCommon {\n  type: 'inapp' | 'iap';\n  oneTimePurchaseOfferDetails?: {\n    priceCurrencyCode: string;\n    formattedPrice: string;\n    priceAmountMicros: string;\n  };\n}\nexport interface ProductIOS extends ProductCommon {\n  type: 'inapp' | 'iap';\n}\n\nexport type Product = ProductAndroid & ProductIOS;\n\n// Android V5\nexport interface SubscriptionAndroid extends ProductCommon {\n  type: 'subs';\n\n  productType?: string;\n  name?: string;\n  subscriptionOfferDetails?: {\n    offerToken: string;\n    pricingPhases: {\n      pricingPhaseList: {\n        formattedPrice: string;\n        priceCurrencyCode: string;\n        /**\n         * P1W, P1M, P1Y\n         */\n        billingPeriod: string;\n        billingCycleCount: number;\n        priceAmountMicros: string;\n        recurrenceMode: number;\n      }[];\n    };\n    offerTags: string[];\n  }[];\n}\n\nexport interface SubscriptionIOS extends ProductCommon {\n  type: 'subs';\n  discounts?: Discount[];\n  introductoryPrice?: string;\n  introductoryPriceAsAmountIOS?: string;\n  introductoryPricePaymentModeIOS?:\n    | ''\n    | 'FREETRIAL'\n    | 'PAYASYOUGO'\n    | 'PAYUPFRONT';\n  introductoryPriceNumberOfPeriodsIOS?: string;\n  introductoryPriceSubscriptionPeriodIOS?:\n    | 'DAY'\n    | 'WEEK'\n    | 'MONTH'\n    | 'YEAR'\n    | '';\n\n  subscriptionPeriodNumberIOS?: string;\n  subscriptionPeriodUnitIOS?: '' | 'YEAR' | 'MONTH' | 'WEEK' | 'DAY';\n}\n\nexport type Subscription = SubscriptionAndroid & SubscriptionIOS;\nexport interface RequestPurchaseBaseAndroid {\n  obfuscatedAccountIdAndroid?: string;\n  obfuscatedProfileIdAndroid?: string;\n  isOfferPersonalized?: boolean; // For AndroidBilling V5 https://developer.android.com/google/play/billing/integrate#personalized-price\n}\n\nexport interface RequestPurchaseAndroid extends RequestPurchaseBaseAndroid {\n  skus?: Sku[];\n}\n\nexport interface RequestPurchaseIOS {\n  sku?: Sku;\n  andDangerouslyFinishTransactionAutomaticallyIOS?: boolean;\n  /**\n   * UUID representing user account\n   */\n  applicationUsername?: string;\n  quantity?: number;\n  withOffer?: Apple.PaymentDiscount;\n}\n\nexport type RequestPurchase = RequestPurchaseAndroid & RequestPurchaseIOS;\n\n/**\n * In order to purchase a new subscription, every sku must have a selected offerToken\n * @see SubscriptionAndroid.subscriptionOfferDetails.offerToken\n */\nexport interface SubscriptionOffer {\n  sku: Sku;\n  offerToken: string;\n}\n\nexport interface RequestSubscriptionAndroid extends RequestPurchaseBaseAndroid {\n  purchaseTokenAndroid?: string;\n  prorationModeAndroid?: ProrationModesAndroid;\n  subscriptionOffers?: SubscriptionOffer[]; // For AndroidBilling V5\n}\n\nexport type RequestSubscriptionIOS = RequestPurchaseIOS;\n\nexport type RequestSubscription = RequestSubscriptionAndroid &\n  RequestSubscriptionIOS;\n\ndeclare module 'react-native' {\n  interface NativeModulesStatic {\n    RNIapIos: IosModuleProps;\n    RNIapModule: AndroidModuleProps;\n    RNIapAmazonModule: AmazonModuleProps;\n  }\n}\n"],"mappings":"AAUA,WAAYA,qBAAZ;;WAAYA,qB;EAAAA,qB,CAAAA,qB;EAAAA,qB,CAAAA,qB;EAAAA,qB,CAAAA,qB;EAAAA,qB,CAAAA,qB;EAAAA,qB,CAAAA,qB;EAAAA,qB,CAAAA,qB;GAAAA,qB,KAAAA,qB;;AASZ,WAAYC,oBAAZ;;WAAYA,oB;EAAAA,oB,CAAAA,oB;EAAAA,oB,CAAAA,oB;EAAAA,oB,CAAAA,oB;GAAAA,oB,KAAAA,oB;;AAMZ,OAAO,MAAMC,gBAAgB,GAAG,sBAAzB;AAEP,WAAYC,oBAAZ;;WAAYA,oB;EAAAA,oB,CAAAA,oB;EAAAA,oB,CAAAA,oB;EAAAA,oB,CAAAA,oB;GAAAA,oB,KAAAA,oB;;AAMZ,WAAYC,WAAZ;;WAAYA,W;EAAAA,W;EAAAA,W;EAAAA,W;EAAAA,W;GAAAA,W,KAAAA,W"}

package/lib/typescript/iap.d.ts

@@ -2,7 +2,7 @@ import type { ResponseBody as ReceiptValidationResponse } from '@jeremybarbet/ap
 import type * as Amazon from './types/amazon';
 import type * as Android from './types/android';
 import type * as Apple from './types/apple';
-import { Product, ProductPurchase, ProrationModesAndroid, Purchase, PurchaseResult, Sku, Subscription, SubscriptionOffer, SubscriptionPurchase } from './types';
+import { Product, ProductPurchase, Purchase, PurchaseResult, RequestPurchase, RequestSubscription, Sku, Subscription, SubscriptionPurchase } from './types';
 import { InstallSourceAndroid } from './types';
 export declare const getInstallSourceAndroid: () => InstallSourceAndroid;
 export declare const setAndroidNativeModule: (nativeModule: import("./modules").AndroidModuleProps) => void;
@@ -11,11 +11,41 @@ export declare const getIosModule: () => import("./modules").IosModuleProps;
 export declare const getNativeModule: () => import("./modules").AmazonModuleProps | import("./modules").AndroidModuleProps | import("./modules").IosModuleProps;
 /**
  * Init module for purchase flow. Required on Android. In ios it will check whether user canMakePayment.
- * @returns {Promise<boolean>}
+ * ## Usage
+
+```tsx
+import React, {useEffect} from 'react';
+import {View} from 'react-native';
+import {initConnection} from 'react-native-iap';
+
+const App = () => {
+  useEffect(() => {
+    void initConnection();
+  }, []);
+
+  return <View />;
+};
+```
  */
 export declare const initConnection: () => Promise<boolean>;
 /**
- * End module for purchase flow.
+ * Disconnects from native SDK
+ * Usage
+ * ```tsx
+import React, {useEffect} from 'react';
+import {View} from 'react-native';
+import {endConnection} from 'react-native-iap';
+
+const App = () => {
+  useEffect(() => {
+    return () => {
+      void endConnection();
+    };
+  }, []);
+
+  return <View />;
+};
+```
  * @returns {Promise<void>}
  */
 export declare const endConnection: () => Promise<boolean>;
@@ -26,76 +56,324 @@ export declare const endConnection: () => Promise<boolean>;
 export declare const flushFailedPurchasesCachedAsPendingAndroid: () => Promise<boolean>;
 /**
  * Get a list of products (consumable and non-consumable items, but not subscriptions)
- * @param {string[]} skus The item skus
- * @returns {Promise<Product[]>}
+ ## Usage
+
+```ts
+import React, {useState} from 'react';
+import {Platform} from 'react-native';
+import {getProducts, Product} from 'react-native-iap';
+
+const skus = Platform.select({
+  ios: ['com.example.consumableIos'],
+  android: ['com.example.consumableAndroid'],
+});
+
+const App = () => {
+  const [products, setProducts] = useState<Product[]>([]);
+
+  const handleProducts = async () => {
+    const items = await getProducts({skus});
+
+    setProducts(items);
+  };
+
+  useEffect(() => {
+    void handleProducts();
+  }, []);
+
+  return (
+    <>
+      {products.map((product) => (
+        <Text key={product.productId}>{product.productId}</Text>
+      ))}
+    </>
+  );
+};
+```
+
+Just a few things to keep in mind:
+
+- You can get your products in `componentDidMount`, `useEffect` or another appropriate area of your app.
+- Since a user may start your app with a bad or no internet connection, preparing/getting the items more than once may be a good idea.
+- If the user has no IAPs available when the app starts first, you may want to check again when the user enters your IAP store.
+
  */
 export declare const getProducts: ({ skus, }: {
     skus: string[];
 }) => Promise<Array<Product>>;
 /**
  * Get a list of subscriptions
- * @param {string[]} skus The item skus
- * @returns {Promise<Subscription[]>}
+ * ## Usage
+
+```tsx
+import React, {useCallback} from 'react';
+import {View} from 'react-native';
+import {getSubscriptions} from 'react-native-iap';
+
+const App = () => {
+  const subscriptions = useCallback(
+    async () =>
+      await getSubscriptions(['com.example.product1', 'com.example.product2']),
+    [],
+  );
+
+  return <View />;
+};
+```
+
  */
 export declare const getSubscriptions: ({ skus, }: {
     skus: string[];
 }) => Promise<Subscription[]>;
 /**
  * Gets an inventory of purchases made by the user regardless of consumption status
- * @returns {Promise<(ProductPurchase | SubscriptionPurchase)[]>}
+ * ## Usage
+
+```tsx
+import React, {useCallback} from 'react';
+import {View} from 'react-native';
+import {getPurchaseHistory} from 'react-native-iap';
+
+const App = () => {
+  const history = useCallback(
+    async () =>
+      await getPurchaseHistory([
+        'com.example.product1',
+        'com.example.product2',
+      ]),
+    [],
+  );
+
+  return <View />;
+};
+```
  */
 export declare const getPurchaseHistory: () => Promise<(ProductPurchase | SubscriptionPurchase)[]>;
 /**
  * Get all purchases made by the user (either non-consumable, or haven't been consumed yet)
- * @returns {Promise<(ProductPurchase | SubscriptionPurchase)[]>}
+ * ## Usage
+
+```tsx
+import React, {useCallback} from 'react';
+import {View} from 'react-native';
+import {getAvailablePurchases} from 'react-native-iap';
+
+const App = () => {
+  const availablePurchases = useCallback(
+    async () => await getAvailablePurchases(),
+    [],
+  );
+
+  return <View />;
+};
+```
+
+## Restoring purchases
+
+You can use `getAvailablePurchases()` to do what's commonly understood as "restoring" purchases.
+
+:::note
+For debugging you may want to consume all items, you have then to iterate over the purchases returned by `getAvailablePurchases()`.
+:::
+
+:::warning
+Beware that if you consume an item without having recorded the purchase in your database the user may have paid for something without getting it delivered and you will have no way to recover the receipt to validate and restore their purchase.
+:::
+
+```tsx
+import React from 'react';
+import {Button} from 'react-native';
+import {getAvailablePurchases,finishTransaction} from 'react-native-iap';
+
+const App = () => {
+  handleRestore = async () => {
+    try {
+      const purchases = await getAvailablePurchases();
+      const newState = {premium: false, ads: true};
+      let titles = [];
+
+      await Promise.all(purchases.map(async purchase => {
+        switch (purchase.productId) {
+          case 'com.example.premium':
+            newState.premium = true;
+            titles.push('Premium Version');
+            break;
+
+          case 'com.example.no_ads':
+            newState.ads = false;
+            titles.push('No Ads');
+            break;
+
+          case 'com.example.coins100':
+            await finishTransaction(purchase.purchaseToken);
+            CoinStore.addCoins(100);
+        }
+      })
+
+      Alert.alert(
+        'Restore Successful',
+        `You successfully restored the following purchases: ${titles.join(', ')}`,
+      );
+    } catch (error) {
+      console.warn(error);
+      Alert.alert(error.message);
+    }
+  };
+
+  return (
+    <Button title="Restore purchases" onPress={handleRestore} />
+  )
+};
+```
+ *
  */
 export declare const getAvailablePurchases: () => Promise<(ProductPurchase | SubscriptionPurchase)[]>;
 /**
  * Request a purchase for product. This will be received in `PurchaseUpdatedListener`.
- * @param {string} sku The product's sku/ID
- * @param {string} [applicationUsername] The purchaser's user ID
- * @param {boolean} [andDangerouslyFinishTransactionAutomaticallyIOS] You should set this to false and call finishTransaction manually when you have delivered the purchased goods to the user. It defaults to true to provide backwards compatibility. Will default to false in version 4.0.0.
- * @param {string} [obfuscatedAccountIdAndroid] Specifies an optional obfuscated string that is uniquely associated with the user's account in your app.
- * @param {string} [obfuscatedProfileIdAndroid] Specifies an optional obfuscated string that is uniquely associated with the user's profile in your app.
- * @param {string[]} [skus] Product Ids to purchase. Note that this is only for Android. iOS only uses a single SKU. If not provided, it'll default to using [sku] for backward-compatibility
- * @param {boolean} [isOfferPersonalized] Defaults to false, Only for Android V5
- * @returns {Promise<ProductPurchase>}
- */
-export declare const requestPurchase: ({ sku, andDangerouslyFinishTransactionAutomaticallyIOS, applicationUsername, obfuscatedAccountIdAndroid, obfuscatedProfileIdAndroid, skus, isOfferPersonalized, }: {
-    sku?: string | undefined;
-    andDangerouslyFinishTransactionAutomaticallyIOS?: boolean | undefined;
-    applicationUsername?: string | undefined;
-    obfuscatedAccountIdAndroid?: string | undefined;
-    obfuscatedProfileIdAndroid?: string | undefined;
-    /** For Google Play Billing Library 5 https://developer.android.com/google/play/billing/integrate#personalized-price */
-    skus?: string[] | undefined;
-    isOfferPersonalized?: boolean | undefined;
-}) => Promise<ProductPurchase | void>;
+ * Request a purchase for a product (consumables or non-consumables).
+
+The response will be received through the `PurchaseUpdatedListener`.
+
+:::note
+`andDangerouslyFinishTransactionAutomatically` defaults to false. We recommend
+always keeping at false, and verifying the transaction receipts on the server-side.
+:::
+
+## Signature
+
+```ts
+requestPurchase(
+ The product's sku/ID
+  sku,
+
+  
+   * You should set this to false and call finishTransaction manually when you have delivered the purchased goods to the user.
+   * @default false
+   
+  andDangerouslyFinishTransactionAutomaticallyIOS = false,
+
+  /** Specifies an optional obfuscated string that is uniquely associated with the user's account in your app.
+  obfuscatedAccountIdAndroid,
+
+  Specifies an optional obfuscated string that is uniquely associated with the user's profile in your app.
+  obfuscatedProfileIdAndroid,
+
+   The purchaser's user ID
+  applicationUsername,
+): Promise<ProductPurchase>;
+```
+
+## Usage
+
+```tsx
+import React, {useCallback} from 'react';
+import {Button} from 'react-native';
+import {requestPurchase, Product, Sku, getProducts} from 'react-native-iap';
+
+const App = () => {
+  const products = useCallback(
+    async () => getProducts(['com.example.product']),
+    [],
+  );
+
+  const handlePurchase = async (sku: Sku) => {
+    await requestPurchase({sku});
+  };
+
+  return (
+    <>
+      {products.map((product) => (
+        <Button
+          key={product.productId}
+          title="Buy product"
+          onPress={() => handlePurchase(product.productId)}
+        />
+      ))}
+    </>
+  );
+};
+```
+
+ */
+export declare const requestPurchase: ({ sku, andDangerouslyFinishTransactionAutomaticallyIOS, applicationUsername, obfuscatedAccountIdAndroid, obfuscatedProfileIdAndroid, skus, isOfferPersonalized, }: RequestPurchase) => Promise<ProductPurchase | void>;
 /**
  * Request a purchase for product. This will be received in `PurchaseUpdatedListener`.
- * @param {string} [sku] The product's sku/ID
- * @param {string} [applicationUsername] The purchaser's user ID
- * @param {boolean} [andDangerouslyFinishTransactionAutomaticallyIOS] You should set this to false and call finishTransaction manually when you have delivered the purchased goods to the user. It defaults to true to provide backwards compatibility. Will default to false in version 4.0.0.
- * @param {string} [purchaseTokenAndroid] purchaseToken that the user is upgrading or downgrading from (Android).
- * @param {ProrationModesAndroid} [prorationModeAndroid] UNKNOWN_SUBSCRIPTION_UPGRADE_DOWNGRADE_POLICY, IMMEDIATE_WITH_TIME_PRORATION, IMMEDIATE_AND_CHARGE_PRORATED_PRICE, IMMEDIATE_WITHOUT_PRORATION, DEFERRED
- * @param {string} [obfuscatedAccountIdAndroid] Specifies an optional obfuscated string that is uniquely associated with the user's account in your app.
- * @param {string} [obfuscatedProfileIdAndroid] Specifies an optional obfuscated string that is uniquely associated with the user's profile in your app.
- * @param {SubscriptionOffers[]} [subscriptionOffers] Array of SubscriptionOffers. Every sku must be paired with a corresponding offerToken
- * @returns {Promise<SubscriptionPurchase | null>} Promise resolves to null when using proratioModesAndroid=DEFERRED, and to a SubscriptionPurchase otherwise
- */
-export declare const requestSubscription: ({ sku, andDangerouslyFinishTransactionAutomaticallyIOS, applicationUsername, purchaseTokenAndroid, prorationModeAndroid, subscriptionOffers, obfuscatedAccountIdAndroid, obfuscatedProfileIdAndroid, isOfferPersonalized, }: {
-    sku?: string | undefined;
-    andDangerouslyFinishTransactionAutomaticallyIOS?: boolean | undefined;
-    applicationUsername?: string | undefined;
-    purchaseTokenAndroid?: string | undefined;
-    prorationModeAndroid?: ProrationModesAndroid | undefined;
-    /** For Google Play Billing Library 5 */
-    subscriptionOffers?: SubscriptionOffer[] | undefined;
-    obfuscatedAccountIdAndroid?: string | undefined;
-    obfuscatedProfileIdAndroid?: string | undefined;
-    /** For Google Play Billing Library 5 https://developer.android.com/google/play/billing/integrate#personalized-price */
-    isOfferPersonalized?: boolean | undefined;
-}) => Promise<SubscriptionPurchase | null | void>;
+ * Request a purchase for a subscription.
+
+The response will be received through the `PurchaseUpdatedListener`.
+
+:::note
+`andDangerouslyFinishTransactionAutomatically` defaults to false. We recommend
+always keeping at false, and verifying the transaction receipts on the server-side.
+:::
+
+## Signature
+
+```ts
+requestSubscription(
+  The product's sku/ID
+  sku,
+
+
+   * You should set this to false and call finishTransaction manually when you have delivered the purchased goods to the user.
+   * @default false
+
+  andDangerouslyFinishTransactionAutomaticallyIOS = false,
+
+   purchaseToken that the user is upgrading or downgrading from (Android).
+  purchaseTokenAndroid,
+
+  UNKNOWN_SUBSCRIPTION_UPGRADE_DOWNGRADE_POLICY, IMMEDIATE_WITH_TIME_PRORATION, IMMEDIATE_AND_CHARGE_PRORATED_PRICE, IMMEDIATE_WITHOUT_PRORATION, DEFERRED
+  prorationModeAndroid = -1,
+
+  /** Specifies an optional obfuscated string that is uniquely associated with the user's account in your app.
+  obfuscatedAccountIdAndroid,
+
+  Specifies an optional obfuscated string that is uniquely associated with the user's profile in your app.
+  obfuscatedProfileIdAndroid,
+
+  The purchaser's user ID
+  applicationUsername,
+): Promise<SubscriptionPurchase>
+```
+
+## Usage
+
+```tsx
+import React, {useCallback} from 'react';
+import {Button} from 'react-native';
+import {
+  requestSubscription,
+  Product,
+  Sku,
+  getSubscriptions,
+} from 'react-native-iap';
+
+const App = () => {
+  const subscriptions = useCallback(
+    async () => getSubscriptions(['com.example.subscription']),
+    [],
+  );
+
+  const handlePurchase = async (sku: Sku) => {
+    await requestSubscription({sku});
+  };
+
+  return (
+    <>
+      {subscriptions.map((subscription) => (
+        <Button
+          key={subscription.productId}
+          title="Buy subscription"
+          onPress={() => handlePurchase(subscription.productId)}
+        />
+      ))}
+    </>
+  );
+};
+```
+ */
+export declare const requestSubscription: ({ sku, andDangerouslyFinishTransactionAutomaticallyIOS, applicationUsername, purchaseTokenAndroid, prorationModeAndroid, subscriptionOffers, obfuscatedAccountIdAndroid, obfuscatedProfileIdAndroid, isOfferPersonalized, }: RequestSubscription) => Promise<SubscriptionPurchase | null | void>;
 /**
  * Request a purchase for product. This will be received in `PurchaseUpdatedListener`.
  * @param {string} sku The product's sku/ID
@@ -112,10 +390,22 @@ export declare const requestPurchaseWithQuantityIOS: ({ sku, quantity, }: {
  *   Call this after you have persisted the purchased state to your server or local data in your app.
  *   `react-native-iap` will continue to deliver the purchase updated events with the successful purchase until you finish the transaction. **Even after the app has relaunched.**
  *   Android: it will consume purchase for consumables and acknowledge purchase for non-consumables.
- * @param {object} purchase The purchase that you would like to finish.
- * @param {boolean} isConsumable Checks if purchase is consumable. Has effect on `android`.
- * @param {string} developerPayloadAndroid Android developerPayload.
- * @returns {Promise<string | void> }
+ *
+```tsx
+import React from 'react';
+import {Button} from 'react-native';
+import {finishTransaction} from 'react-native-iap';
+
+const App = () => {
+  const handlePurchase = async () => {
+    // ... handle the purchase request
+
+    const result = finishTransaction(purchase);
+  };
+
+  return <Button title="Buy product" onPress={handlePurchase} />;
+};
+```
  */
 export declare const finishTransaction: ({ purchase, isConsumable, developerPayloadAndroid, }: {
     purchase: ProductPurchase | ProductPurchase;

package/lib/typescript/index.d.ts

@@ -4,3 +4,4 @@ export * from './eventEmitter';
 export * from './hooks/useIAP';
 export * from './hooks/withIAPContext';
 export * from './purchaseError';
+export * from './modules';

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

@@ -1,4 +1,5 @@
 import type { AmazonModuleProps, AndroidModuleProps, IosModuleProps } from '../modules';
+import type * as Apple from './apple';
 export declare type Sku = string;
 export declare enum ProrationModesAndroid {
     IMMEDIATE_WITH_TIME_PRORATION = 1,
@@ -86,7 +87,7 @@ export interface Discount {
     paymentMode: '' | 'FREETRIAL' | 'PAYASYOUGO' | 'PAYUPFRONT';
     subscriptionPeriod: string;
 }
-export interface Product extends ProductCommon {
+export interface ProductAndroid extends ProductCommon {
     type: 'inapp' | 'iap';
     oneTimePurchaseOfferDetails?: {
         priceCurrencyCode: string;
@@ -94,6 +95,10 @@ export interface Product extends ProductCommon {
         priceAmountMicros: string;
     };
 }
+export interface ProductIOS extends ProductCommon {
+    type: 'inapp' | 'iap';
+}
+export declare type Product = ProductAndroid & ProductIOS;
 export interface SubscriptionAndroid extends ProductCommon {
     type: 'subs';
     productType?: string;
@@ -113,6 +118,7 @@ export interface SubscriptionAndroid extends ProductCommon {
                 recurrenceMode: number;
             }[];
         };
+        offerTags: string[];
     }[];
 }
 export interface SubscriptionIOS extends ProductCommon {
@@ -127,6 +133,25 @@ export interface SubscriptionIOS extends ProductCommon {
     subscriptionPeriodUnitIOS?: '' | 'YEAR' | 'MONTH' | 'WEEK' | 'DAY';
 }
 export declare type Subscription = SubscriptionAndroid & SubscriptionIOS;
+export interface RequestPurchaseBaseAndroid {
+    obfuscatedAccountIdAndroid?: string;
+    obfuscatedProfileIdAndroid?: string;
+    isOfferPersonalized?: boolean;
+}
+export interface RequestPurchaseAndroid extends RequestPurchaseBaseAndroid {
+    skus?: Sku[];
+}
+export interface RequestPurchaseIOS {
+    sku?: Sku;
+    andDangerouslyFinishTransactionAutomaticallyIOS?: boolean;
+    /**
+     * UUID representing user account
+     */
+    applicationUsername?: string;
+    quantity?: number;
+    withOffer?: Apple.PaymentDiscount;
+}
+export declare type RequestPurchase = RequestPurchaseAndroid & RequestPurchaseIOS;
 /**
  * In order to purchase a new subscription, every sku must have a selected offerToken
  * @see SubscriptionAndroid.subscriptionOfferDetails.offerToken
@@ -135,6 +160,13 @@ export interface SubscriptionOffer {
     sku: Sku;
     offerToken: string;
 }
+export interface RequestSubscriptionAndroid extends RequestPurchaseBaseAndroid {
+    purchaseTokenAndroid?: string;
+    prorationModeAndroid?: ProrationModesAndroid;
+    subscriptionOffers?: SubscriptionOffer[];
+}
+export declare type RequestSubscriptionIOS = RequestPurchaseIOS;
+export declare type RequestSubscription = RequestSubscriptionAndroid & RequestSubscriptionIOS;
 declare module 'react-native' {
     interface NativeModulesStatic {
         RNIapIos: IosModuleProps;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-iap",
-  "version": "10.1.0",
+  "version": "10.1.2",
   "description": "React Native In App Purchase Module.",
   "repository": "https://github.com/dooboolab/react-native-iap",
   "author": "dooboolab <support@dooboolab.com> (https://github.com/dooboolab)",
@@ -65,7 +65,8 @@
     "lint:ci": "yarn lint:tsc && yarn lint:eslint -f ./node_modules/@firmnav/eslint-github-actions-formatter/dist/formatter.js && yarn lint:prettier",
     "lint:prettier": "prettier --write \"**/*.{md,js,jsx,ts,tsx}\"",
     "format": "git ls-files -m | xargs yarn prettier --write --ignore-unknown --no-error-on-unmatched-pattern",
-    "bootstrap": "yarn example && yarn && yarn example pods"
+    "bootstrap": "yarn example && yarn && yarn example pods",
+    "gen:doc": "typedoc"
   },
   "devDependencies": {
     "@babel/eslint-parser": "7.18.9",
@@ -96,6 +97,8 @@
     "react-native-builder-bob": "0.18.3",
     "release-it": "15.2.0",
     "ts-jest": "28.0.7",
+    "typedoc": "^0.23.14",
+    "typedoc-plugin-markdown": "^3.13.6",
     "typescript": "4.7.4"
   },
   "resolutions": {