react-native-iap 11.0.0-rc.2 → 11.0.0-rc.3

package/lib/typescript/eventEmitter.d.ts

@@ -1,17 +1,150 @@
 import { EmitterSubscription } from 'react-native';
+import { TransactionEvent } from './types/appleSk2';
 import type { PurchaseError } from './purchaseError';
 import type { Purchase } from './types';
 /**
  * Add IAP purchase event
+ * Register a callback that gets called when the store has any updates to purchases that have not yet been finished, consumed or acknowledged. Returns a React Native `EmitterSubscription` on which you can call `.remove()` to stop receiving updates. Register you listener as soon as possible and react to updates at all times.
+
+## Signature
+
+```ts
+purchaseUpdatedListener((purchase: Purchase) => {});
+```
+
+## Usage
+
+```tsx
+import React, {useEffect} from 'react';
+import {View} from 'react-native';
+import {purchaseUpdatedListener} from 'react-native-iap';
+
+const App = () => {
+  useEffect(() => {
+    const subscription = purchaseUpdatedListener((purchase: Purchase) => {
+      console.log(purchase);
+    });
+
+    return () => {
+      subscription.remove();
+    };
+  }, []);
+
+  return <View />;
+};
+```
  */
 export declare const purchaseUpdatedListener: (listener: (event: Purchase) => void) => EmitterSubscription;
 /**
  * Add IAP purchase error event
+ * Register a callback that gets called when there has been an error with a purchase. Returns a React Native `EmitterSubscription` on which you can call `.remove()` to stop receiving updates.
+
+## Signature
+
+```ts
+purchaseErrorListener((error: PurchaseError) => {});
+```
+
+## Usage
+
+```tsx
+import React, {useEffect} from 'react';
+import {View} from 'react-native';
+import {purchaseErrorListener} from 'react-native-iap';
+
+const App = () => {
+  useEffect(() => {
+    const subscription = purchaseErrorListener((error: PurchaseError) => {
+      console.log(error);
+    });
+
+    return () => {
+      subscription.remove();
+    };
+  }, []);
+
+  return <View />;
+};
+```
+
  */
 export declare const purchaseErrorListener: (listener: (error: PurchaseError) => void) => EmitterSubscription;
 /**
  * Add IAP promoted subscription event
+ * Add IAP promoted subscription event.
+
+## Signature
+
+```ts
+promotedProductListener((productId?: string) => {});
+```
+
+## Usage
+
+```tsx
+import React, {useEffect} from 'react';
+import {View} from 'react-native';
+import {promotedProductListener} from 'react-native-iap';
+
+const App = () => {
+  useEffect(() => {
+    const subscription = promotedProductListener((productId) => {
+      console.log(productId);
+    });
+
+    return () => {
+      subscription.remove();
+    };
+  }, []);
+
+  return <View />;
+};
+```
+
  *
  * @platform iOS
  */
 export declare const promotedProductListener: (listener: () => void) => EmitterSubscription | null;
+/**
+ * Updated transactions for iOS Sk2
+ * Register a callback that gets called when the store has any updates to transactions related to purchases that have not yet been finished, consumed or acknowledged.
+ * Returns a React Native `EmitterSubscription` on which you can call `.remove()` to stop receiving updates. Register you listener as soon as possible and react to updates at all times.
+
+**Warning**
+This is only available for iOS 15 and higher and Storekit 2 is activated
+
+## Signature
+
+```ts
+purchaseUpdatedListener((transactionOrError: TransactionOrError) => {});
+```
+
+## Usage
+
+```tsx
+import React, {useEffect} from 'react';
+import {View} from 'react-native';
+import {purchaseUpdatedListener} from 'react-native-iap';
+
+const App = () => {
+  useEffect(() => {
+    const subscription = purchaseUpdatedListener((transactionOrError: TransactionOrError) => {
+      if(transactionOrError.transaction){
+        console.log("There's an update to a transaction", transactionOrError.transaction);
+      }else{
+        console.log("There's been an error with a received transaction")
+      }
+    });
+
+    return () => {
+      subscription.remove();
+    };
+  }, []);
+
+  return <View />;
+};
+```
+ *
+ * @platform iOS (Sk2)
+ */
+export declare const transactionListener: (listener: (event: TransactionEvent) => void) => EmitterSubscription | null;

package/lib/typescript/hooks/withIAPContext.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
 import type { PurchaseError } from '../purchaseError';
 import type { Product, Purchase, Subscription } from '../types';
+import type { TransactionSk2 } from '../types/appleSk2';
 declare type IAPContextType = {
     connected: boolean;
     products: Product[];
@@ -9,6 +10,7 @@ declare type IAPContextType = {
     purchaseHistory: Purchase[];
     availablePurchases: Purchase[];
     currentPurchase?: Purchase;
+    currentTransaction?: TransactionSk2;
     currentPurchaseError?: PurchaseError;
     initConnectionError?: Error;
     setProducts: (products: Product[]) => void;

package/lib/typescript/iap.d.ts

@@ -143,8 +143,12 @@ const App = () => {
   return <View />;
 };
 ```
+@param {alsoPublishToEventListener}:boolean When `true`, every element will also be pushed to the purchaseUpdated listener.
+Note that this is only for backaward compatiblity. It won't publish to transactionUpdated (Storekit2) Defaults to `false`
  */
-export declare const getPurchaseHistory: () => Promise<(ProductPurchase | SubscriptionPurchase)[]>;
+export declare const getPurchaseHistory: ({ alsoPublishToEventListener, }?: {
+    alsoPublishToEventListener?: boolean | undefined;
+}) => Promise<(ProductPurchase | SubscriptionPurchase)[]>;
 /**
  * Get all purchases made by the user (either non-consumable, or haven't been consumed yet)
  * ## Usage
@@ -221,9 +225,13 @@ const App = () => {
   )
 };
 ```
+@param {alsoPublishToEventListener}:boolean When `true`, every element will also be pushed to the purchaseUpdated listener.
+Note that this is only for backaward compatiblity. It won't publish to transactionUpdated (Storekit2) Defaults to `false`
  *
  */
-export declare const getAvailablePurchases: () => Promise<(ProductPurchase | SubscriptionPurchase)[]>;
+export declare const getAvailablePurchases: ({ alsoPublishToEventListener, }?: {
+    alsoPublishToEventListener?: boolean | undefined;
+}) => Promise<(ProductPurchase | SubscriptionPurchase)[]>;
 /**
  * Request a purchase for product. This will be received in `PurchaseUpdatedListener`.
  * Request a purchase for a product (consumables or non-consumables).

package/lib/typescript/modules/iosSk2.d.ts

@@ -2,7 +2,7 @@ import type { Product, ProductPurchase, Purchase, Sku } from '../types';
 import type { PaymentDiscountSk2, ProductSk2, ProductStatus, TransactionSk2 } from '../types/appleSk2';
 import type { NativeModuleProps } from './common';
 declare type getItems = (skus: Sku[]) => Promise<ProductSk2[]>;
-declare type getAvailableItems = () => Promise<Purchase[]>;
+declare type getAvailableItems = (alsoPublishToEventListener?: boolean) => Promise<Purchase[]>;
 export declare type BuyProduct = (sku: Sku, andDangerouslyFinishTransactionAutomaticallyIOS: boolean, applicationUsername: string | undefined, quantity: number, withOffer: PaymentDiscountSk2 | undefined) => Promise<Purchase>;
 declare type clearTransaction = () => Promise<void>;
 declare type clearProducts = () => Promise<void>;

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

@@ -1,5 +1,26 @@
+import type { PurchaseError } from '../purchaseError';
 import type { ProductIOS, Purchase, SubscriptionIOS } from '.';
 import type * as Apple from './apple';
+export declare type SubscriptionPeriod = {
+    unit: 'day' | 'week' | 'month' | 'year';
+    value: number;
+};
+export declare type PaymentMode = 'freeTrial' | 'payAsYouGo' | 'payUpFront';
+export declare type SubscriptionOffer = {
+    displayPrice: string;
+    id: string;
+    paymentMode: PaymentMode;
+    period: SubscriptionPeriod;
+    periodCount: number;
+    price: number;
+    type: 'introductory' | 'promotional';
+};
+export declare type SubscriptionInfo = {
+    introductoryOffer?: SubscriptionOffer;
+    promotionalOffers?: SubscriptionOffer[];
+    subscriptionGroupID: string;
+    subscriptionPeriod: SubscriptionPeriod;
+};
 export declare type ProductSk2 = {
     description: string;
     displayName: string;
@@ -8,7 +29,7 @@ export declare type ProductSk2 = {
     isFamilyShareable: boolean;
     jsonRepresentation: string;
     price: number;
-    subscription: any;
+    subscription: SubscriptionInfo;
     type: 'autoRenewable' | 'consumable' | 'nonConsumable' | 'nonRenewable';
 };
 export declare const productSk2Map: ({ id, description, displayName, price, displayPrice, }: ProductSk2) => ProductIOS;
@@ -38,6 +59,14 @@ export declare type TransactionSk2 = {
     subscriptionGroupID: number;
     webOrderLineItemID: number;
 };
+export declare type TransactionError = PurchaseError;
+/**
+ * Only one of `transaction` and `error` is not undefined at the time
+ */
+export declare type TransactionEvent = {
+    transaction?: TransactionSk2;
+    error?: TransactionError;
+};
 export declare type SubscriptionStatus = 'expired' | 'inBillingRetryPeriod' | 'inGracePeriod' | 'revoked' | 'subscribed';
 export declare type ProductStatus = {
     state: SubscriptionStatus;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-iap",
-  "version": "11.0.0-rc.2",
+  "version": "11.0.0-rc.3",
   "description": "React Native In App Purchase Module.",
   "repository": "https://github.com/dooboolab/react-native-iap",
   "author": "dooboolab <support@dooboolab.com> (https://github.com/dooboolab)",

package/src/eventEmitter.ts

@@ -1,6 +1,6 @@
 import {EmitterSubscription, NativeEventEmitter} from 'react-native';
 
-import {transactionSk2Map} from './types/appleSk2';
+import {TransactionEvent, transactionSk2Map} from './types/appleSk2';
 import {isIosStorekit2} from './iap';
 import {
   getAndroidModule,
@@ -14,6 +14,35 @@ import type {Purchase} from './types';
 
 /**
  * Add IAP purchase event
+ * Register a callback that gets called when the store has any updates to purchases that have not yet been finished, consumed or acknowledged. Returns a React Native `EmitterSubscription` on which you can call `.remove()` to stop receiving updates. Register you listener as soon as possible and react to updates at all times.
+
+## Signature
+
+```ts
+purchaseUpdatedListener((purchase: Purchase) => {});
+```
+
+## Usage
+
+```tsx
+import React, {useEffect} from 'react';
+import {View} from 'react-native';
+import {purchaseUpdatedListener} from 'react-native-iap';
+
+const App = () => {
+  useEffect(() => {
+    const subscription = purchaseUpdatedListener((purchase: Purchase) => {
+      console.log(purchase);
+    });
+
+    return () => {
+      subscription.remove();
+    };
+  }, []);
+
+  return <View />;
+};
+```
  */
 export const purchaseUpdatedListener = (
   listener: (event: Purchase) => void,
@@ -38,6 +67,36 @@ export const purchaseUpdatedListener = (
 
 /**
  * Add IAP purchase error event
+ * Register a callback that gets called when there has been an error with a purchase. Returns a React Native `EmitterSubscription` on which you can call `.remove()` to stop receiving updates.
+
+## Signature
+
+```ts
+purchaseErrorListener((error: PurchaseError) => {});
+```
+
+## Usage
+
+```tsx
+import React, {useEffect} from 'react';
+import {View} from 'react-native';
+import {purchaseErrorListener} from 'react-native-iap';
+
+const App = () => {
+  useEffect(() => {
+    const subscription = purchaseErrorListener((error: PurchaseError) => {
+      console.log(error);
+    });
+
+    return () => {
+      subscription.remove();
+    };
+  }, []);
+
+  return <View />;
+};
+```
+
  */
 export const purchaseErrorListener = (
   listener: (error: PurchaseError) => void,
@@ -48,14 +107,97 @@ export const purchaseErrorListener = (
 
 /**
  * Add IAP promoted subscription event
+ * Add IAP promoted subscription event.
+
+## Signature
+
+```ts
+promotedProductListener((productId?: string) => {});
+```
+
+## Usage
+
+```tsx
+import React, {useEffect} from 'react';
+import {View} from 'react-native';
+import {promotedProductListener} from 'react-native-iap';
+
+const App = () => {
+  useEffect(() => {
+    const subscription = promotedProductListener((productId) => {
+      console.log(productId);
+    });
+
+    return () => {
+      subscription.remove();
+    };
+  }, []);
+
+  return <View />;
+};
+```
+
  *
  * @platform iOS
  */
 export const promotedProductListener = (listener: () => void) => {
-  if (isIos) {
+  if (isIos && !isIosStorekit2()) {
     const eventEmitter = new NativeEventEmitter(getIosModule());
     return eventEmitter.addListener('iap-promoted-product', listener);
   }
 
   return null;
 };
+
+/**
+ * Updated transactions for iOS Sk2
+ * Register a callback that gets called when the store has any updates to transactions related to purchases that have not yet been finished, consumed or acknowledged. 
+ * Returns a React Native `EmitterSubscription` on which you can call `.remove()` to stop receiving updates. Register you listener as soon as possible and react to updates at all times.
+
+**Warning**
+This is only available for iOS 15 and higher and Storekit 2 is activated
+
+## Signature
+
+```ts
+purchaseUpdatedListener((transactionOrError: TransactionOrError) => {});
+```
+
+## Usage
+
+```tsx
+import React, {useEffect} from 'react';
+import {View} from 'react-native';
+import {purchaseUpdatedListener} from 'react-native-iap';
+
+const App = () => {
+  useEffect(() => {
+    const subscription = purchaseUpdatedListener((transactionOrError: TransactionOrError) => {
+      if(transactionOrError.transaction){
+        console.log("There's an update to a transaction", transactionOrError.transaction);
+      }else{
+        console.log("There's been an error with a received transaction")
+      }
+    });
+
+    return () => {
+      subscription.remove();
+    };
+  }, []);
+
+  return <View />;
+};
+```
+ *
+ * @platform iOS (Sk2)
+ */
+export const transactionListener = (
+  listener: (event: TransactionEvent) => void,
+) => {
+  if (isIos && isIosStorekit2()) {
+    const eventEmitter = new NativeEventEmitter(getIosModule());
+    return eventEmitter.addListener('iap-transaction-updated', listener);
+  }
+
+  return null;
+};

package/src/hooks/withIAPContext.tsx

@@ -4,6 +4,7 @@ import {
   promotedProductListener,
   purchaseErrorListener,
   purchaseUpdatedListener,
+  transactionListener,
 } from '../eventEmitter';
 import {IapIos, initConnection} from '../iap';
 import type {PurchaseError} from '../purchaseError';
@@ -14,6 +15,7 @@ import type {
   Subscription,
   SubscriptionPurchase,
 } from '../types';
+import type {TransactionEvent, TransactionSk2} from '../types/appleSk2';
 
 type IAPContextType = {
   connected: boolean;
@@ -23,6 +25,7 @@ type IAPContextType = {
   purchaseHistory: Purchase[];
   availablePurchases: Purchase[];
   currentPurchase?: Purchase;
+  currentTransaction?: TransactionSk2;
   currentPurchaseError?: PurchaseError;
   initConnectionError?: Error;
   setProducts: (products: Product[]) => void;
@@ -63,6 +66,8 @@ export function withIAPContext<T>(Component: React.ComponentType<T>) {
       [],
     );
     const [currentPurchase, setCurrentPurchase] = useState<Purchase>();
+    const [currentTransaction, setCurrentTransaction] =
+      useState<TransactionSk2>();
 
     const [currentPurchaseError, setCurrentPurchaseError] =
       useState<PurchaseError>();
@@ -78,6 +83,7 @@ export function withIAPContext<T>(Component: React.ComponentType<T>) {
         purchaseHistory,
         availablePurchases,
         currentPurchase,
+        currentTransaction,
         currentPurchaseError,
         initConnectionError,
         setProducts,
@@ -95,6 +101,7 @@ export function withIAPContext<T>(Component: React.ComponentType<T>) {
         purchaseHistory,
         availablePurchases,
         currentPurchase,
+        currentTransaction,
         currentPurchaseError,
         initConnectionError,
         setProducts,
@@ -127,6 +134,13 @@ export function withIAPContext<T>(Component: React.ComponentType<T>) {
         },
       );
 
+      const transactionUpdateSubscription = transactionListener(
+        async (transactionOrError: TransactionEvent) => {
+          setCurrentPurchaseError(transactionOrError?.error);
+          setCurrentTransaction(transactionOrError?.transaction);
+        },
+      );
+
       const purchaseErrorSubscription = purchaseErrorListener(
         (error: PurchaseError) => {
           setCurrentPurchase(undefined);
@@ -147,6 +161,7 @@ export function withIAPContext<T>(Component: React.ComponentType<T>) {
         purchaseUpdateSubscription.remove();
         purchaseErrorSubscription.remove();
         promotedProductSubscription?.remove();
+        transactionUpdateSubscription?.remove();
       };
     }, [connected]);
 

package/src/iap.ts

@@ -248,14 +248,18 @@ const App = () => {
   return <View />;
 };
 ```
+@param {alsoPublishToEventListener}:boolean When `true`, every element will also be pushed to the purchaseUpdated listener.
+Note that this is only for backaward compatiblity. It won't publish to transactionUpdated (Storekit2) Defaults to `false`
  */
-export const getPurchaseHistory = (): Promise<
-  (ProductPurchase | SubscriptionPurchase)[]
-> =>
+export const getPurchaseHistory = ({
+  alsoPublishToEventListener = false,
+}: {
+  alsoPublishToEventListener?: boolean;
+} = {}): Promise<(ProductPurchase | SubscriptionPurchase)[]> =>
   (
     Platform.select({
       ios: async () => {
-        return getIosModule().getAvailableItems();
+        return getIosModule().getAvailableItems(alsoPublishToEventListener);
       },
       android: async () => {
         if (RNIapAmazonModule) {
@@ -351,15 +355,19 @@ const App = () => {
   )
 };
 ```
+@param {alsoPublishToEventListener}:boolean When `true`, every element will also be pushed to the purchaseUpdated listener.
+Note that this is only for backaward compatiblity. It won't publish to transactionUpdated (Storekit2) Defaults to `false`
  * 
  */
-export const getAvailablePurchases = (): Promise<
+export const getAvailablePurchases = ({
+  alsoPublishToEventListener = false,
+}: {alsoPublishToEventListener?: boolean} = {}): Promise<
   (ProductPurchase | SubscriptionPurchase)[]
 > =>
   (
     Platform.select({
       ios: async () => {
-        return getIosModule().getAvailableItems();
+        return getIosModule().getAvailableItems(alsoPublishToEventListener);
       },
       android: async () => {
         if (RNIapAmazonModule) {

package/src/modules/ios.ts

@@ -84,7 +84,7 @@ export const getPromotedProductIOS = (): Promise<Product | null> => {
   if (!isIosStorekit2()) {
     return getIosModule().promotedProduct();
   } else {
-    return Promise.reject('Only available on SK1');
+    return Promise.reject('Only available on Sk1');
   }
 };
 
@@ -146,7 +146,10 @@ export const validateReceiptIos = async ({
     ? 'https://sandbox.itunes.apple.com/verifyReceipt'
     : 'https://buy.itunes.apple.com/verifyReceipt';
 
-  return await enhancedFetch<ReceiptValidationResponse>(url);
+  return await enhancedFetch<ReceiptValidationResponse>(url, {
+    method: 'POST',
+    body: receiptBody,
+  });
 };
 
 /**

package/src/modules/iosSk2.ts

@@ -13,7 +13,9 @@ const {RNIapIosSk2} = NativeModules;
 
 type getItems = (skus: Sku[]) => Promise<ProductSk2[]>;
 
-type getAvailableItems = () => Promise<Purchase[]>;
+type getAvailableItems = (
+  alsoPublishToEventListener?: boolean,
+) => Promise<Purchase[]>;
 
 export type BuyProduct = (
   sku: Sku,

package/src/types/appleSk2.ts

@@ -1,5 +1,32 @@
+import type {PurchaseError} from '../purchaseError';
+
 import type {ProductIOS, Purchase, SubscriptionIOS} from '.';
 import type * as Apple from './apple';
+
+export type SubscriptionPeriod = {
+  unit: 'day' | 'week' | 'month' | 'year';
+  value: number;
+};
+
+export type PaymentMode = 'freeTrial' | 'payAsYouGo' | 'payUpFront';
+
+export type SubscriptionOffer = {
+  displayPrice: string;
+  id: string;
+  paymentMode: PaymentMode;
+  period: SubscriptionPeriod;
+  periodCount: number;
+  price: number;
+  type: 'introductory' | 'promotional';
+};
+
+export type SubscriptionInfo = {
+  introductoryOffer?: SubscriptionOffer;
+  promotionalOffers?: SubscriptionOffer[];
+  subscriptionGroupID: string;
+  subscriptionPeriod: SubscriptionPeriod;
+};
+
 export type ProductSk2 = {
   description: string;
   displayName: string;
@@ -8,7 +35,7 @@ export type ProductSk2 = {
   isFamilyShareable: boolean;
   jsonRepresentation: string;
   price: number;
-  subscription: any; //TODO
+  subscription: SubscriptionInfo;
   type: 'autoRenewable' | 'consumable' | 'nonConsumable' | 'nonRenewable';
 };
 export const productSk2Map = ({
@@ -25,7 +52,7 @@ export const productSk2Map = ({
     type: 'iap',
     price: String(price),
     localizedPrice: displayPrice,
-    currency: '', //TODO: Not avaiable on new API, use localizedPrice instead?
+    currency: '', // Not avaiable on new API, use localizedPrice instead
   };
   return prod;
 };
@@ -44,7 +71,7 @@ export const subscriptionSk2Map = ({
     type: 'subs',
     price: String(price),
     localizedPrice: displayPrice,
-    currency: '', //TODO: Not avaiable on new API, use localizedPrice instead?
+    currency: '', // Not avaiable on new API, use localizedPrice instead
   };
   return prod;
 };
@@ -75,6 +102,16 @@ export type TransactionSk2 = {
   webOrderLineItemID: number;
 };
 
+export type TransactionError = PurchaseError;
+
+/**
+ * Only one of `transaction` and `error` is not undefined at the time
+ */
+export type TransactionEvent = {
+  transaction?: TransactionSk2;
+  error?: TransactionError;
+};
+
 export type SubscriptionStatus =
   | 'expired'
   | 'inBillingRetryPeriod'