react-native-firework-sdk 1.9.0-beta.3 → 1.9.0

package/lib/typescript/models/FWEvents.d.ts

@@ -25,6 +25,10 @@ export interface VideoPlaybackEvent {
 export interface VideoFeedClickEvent {
     info: FeedItemDetails;
 }
+/**
+ * @deprecated The interface will be removed since RN SDK V2.1.
+ * Use {@link ShoppingCTAEvent} instead.
+ */
 export interface AddToCartEvent {
     /**
      * A unique identifier of the product.
@@ -35,6 +39,20 @@ export interface AddToCartEvent {
      */
     unitId: string;
 }
+export interface ShoppingCTAEvent {
+    /**
+     * The url for the product unit
+     */
+    url: string;
+    /**
+     * A unique identifier of the product.
+     */
+    productId: string;
+    /**
+     * A unique identifier of the product unit.
+     */
+    unitId: string;
+}
 export interface UpdateProductDetailsEvent {
     /**
      * A unique identifier list of the products.
@@ -57,7 +75,16 @@ export interface LiveStreamChatEvent {
     liveStream: LiveStreamEventDetails;
 }
 export interface CustomClickLinkButtonEvent {
+    /**
+     * The url for the product unit
+     */
     url: string;
+    /**
+     * A unique identifier of the product.
+     */
     productId: string;
+    /**
+     * A unique identifier of the product unit.
+     */
     unitId: string;
 }

package/lib/typescript/models/ProductInfoViewConfiguration.d.ts

@@ -1,4 +1,8 @@
 import type IOSFontInfo from './IOSFontInfo';
+/**
+ * @deprecated The interface will be removed since RN SDK V2.1.
+ * Use {@link ShoppingCTAButtonConfiguration} instead.
+ */
 export interface AddToCartButtonConfiguration {
     /**
      * The background color of "Add to cart" button.
@@ -19,14 +23,45 @@ export interface AddToCartButtonConfiguration {
      */
     iOSFontInfo?: IOSFontInfo;
 }
+export type ShoppingCTAButtonText = 'addToCart' | 'shopNow';
+export interface ShoppingCTAButtonConfiguration {
+    /**
+     * The text of shopping CTA button.
+     */
+    text?: ShoppingCTAButtonText;
+    /**
+     * The background color of CTA button.
+     */
+    backgroundColor?: string;
+    /**
+     * The text color of CTA button.
+     */
+    textColor?: string;
+    /**
+     * The font size of CTA button.
+     */
+    fontSize?: number;
+    /**
+     * The iOS font info of "Add to cart" button.
+     * The property is ignored when fontSize is not set.
+     */
+    iOSFontInfo?: IOSFontInfo;
+}
 export interface LinkButtonConfiguration {
     isHidden?: boolean;
 }
 export default interface ProductInfoViewConfiguration {
     /**
      * Configuration of "Add to cart" button. Only supported on iOS.
+     *
+     * @deprecated The property will be removed since RN SDK V2.1.
+     * Use {@link ctaButton} instead.
      */
     addToCartButton?: AddToCartButtonConfiguration;
+    /**
+     * Configuration of shopping CTA button. Only supported on iOS.
+     */
+    ctaButton?: ShoppingCTAButtonConfiguration;
     /**
      * Configuration of link button next to "Add to cart" button. Only supported on iOS.
      */

package/lib/typescript/models/ShoppingCTAResult.d.ts

@@ -0,0 +1,11 @@
+export default interface ShoppingCTAResult {
+    /**
+     * The result of shopping CTA button
+     */
+    res: 'success' | 'fail';
+    /**
+     * We will show a toast to display the tips.
+     * If the property is undefined or empty string, we don't show a toast.
+     */
+    tips?: string;
+}

package/lib/typescript/models/VideoFeedConfiguration.d.ts

@@ -84,7 +84,8 @@ export default interface VideoFeedConfiguration {
     /**
      * Please use the enablePictureInPicture in IVideoFeedProps. Only supported on iOS.
      *
-     * @deprecated The property will be deprecated since RN SDK V2.
+     * @deprecated The property will be deprecated since RN SDK V2.0.
+     * Use {@link IVideoFeedProps.enablePictureInPicture} of {@link IVideoFeedProps} instead.
      */
     enablePictureInPicture?: boolean;
 }

package/lib/typescript/models/VideoPlayerConfiguration.d.ts

@@ -60,6 +60,8 @@ export default interface VideoPlayerConfiguration {
     showMuteButton?: boolean;
     /**
      * Specifies the video player launch behavior.
+     *
+     * @deprecated The type will be deprecated since RN SDK V2.0.
      */
     launchBehavior?: VideoLaunchBehavior;
     /**

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

@@ -12,8 +12,7 @@ interface IFireworkSDKModule extends NativeModule {
     setAdBadgeConfiguration(config?: AdBadgeConfiguration): Promise<any>;
     setAppComponentName(name?: string): Promise<any>;
     trackPurchase(parameters: TrackPurchaseParameters): void;
-    changeAppLanguage(language: string): Promise<boolean>;
-    restart(): Promise<void>;
+    changeAppLanguage(language?: string | null): Promise<boolean>;
 }
 declare const FireworkSDKModuleEventEmitter: NativeEventEmitter;
 export { FireworkSDKModuleEventEmitter };

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

@@ -2,10 +2,12 @@ import { NativeEventEmitter, NativeModule } from 'react-native';
 import type { NewNativeContainerProps } from '../models/NewNativeContainerProps';
 import type Product from '../models/Product';
 import type ProductInfoViewConfiguration from '../models/ProductInfoViewConfiguration';
+import type ShoppingCTAResult from '../models/ShoppingCTAResult';
 interface IShoppingModule extends NativeModule {
     init(): void;
     updateVideoProducts(products: Product[], callbackId: number | string): void;
     updateAddToCartStatus(res: string, tips: string, callbackId: number | string): void;
+    updateShoppingCTAResult(result: ShoppingCTAResult, callbackId: number | string): void;
     jumpToCartPage(callbackId: number | string, props: NewNativeContainerProps): void;
     setCartIconVisible(visible: boolean): void;
     setCartItemCount(count: number): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-firework-sdk",
-  "version": "1.9.0-beta.3",
+  "version": "1.9.0",
   "description": "Firework React Native SDK",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -34,7 +34,7 @@
     "android"
   ],
   "repository": "",
-  "author": "",
+  "author": "Loop Now Technologies, Inc.",
   "license": "Apache-2.0",
   "bugs": {
     "url": "https://github.com/loopsocial/react-native-firework-sdk/issues"
@@ -60,7 +60,7 @@
     "react-native": "0.66.4",
     "react-native-builder-bob": "^0.18.0",
     "typedoc": "^0.23.27",
-    "typescript": "^4.6.2"
+    "typescript": "^4.9.5"
   },
   "peerDependencies": {
     "react": "*",
@@ -101,7 +101,8 @@
   },
   "eslintIgnore": [
     "node_modules/",
-    "lib/"
+    "lib/",
+    "docs/"
   ],
   "prettier": {
     "quoteProps": "consistent",

package/react-native-firework-sdk.podspec

@@ -14,15 +14,20 @@ Pod::Spec.new do |s|
   s.source       = { git: 'https://github.com/loopsocial/bogano.git', tag: "#{s.version}" }
 
   s.swift_version = '5.0'
-  # s.header_dir = "ios"
-  # s.public_header_files = "ios/*.h"
+  # s.header_dir = 'ios'
+  # s.public_header_files = 'ios/*.h'
   s.source_files = 'ios/**/*.{h,m,mm,swift}'
-  s.script_phase = { name: 'Copy module header files', script: 'echo "react-native-firework-sdk module_header_path path is"
-module_header_path=${PODS_TARGET_SRCROOT}"/ios/react_native_firework_sdk.h"
-echo $module_header_path
-cp $module_header_path "${PODS_ROOT}/Headers/Public/react_native_firework_sdk/"', execution_position: :before_compile }
-
+  s.exclude_files = 'ios/Support/**/*.{h,m,mm,swift}'
+  s.script_phase = { name: 'Copy module header files', script: '
+module_header_path="${PODS_TARGET_SRCROOT}/ios/react_native_firework_sdk.h"
+target_header_directory="${PODS_ROOT}/Headers/Public/react_native_firework_sdk/"
+echo "module_header_path $module_header_path"
+echo "target_header_directory $target_header_directory"
+if [ -d $target_header_directory ]
+then
+  cp -f $module_header_path $target_header_directory
+fi
+', execution_position: :before_compile }
   s.dependency 'React-Core'
-
-  s.dependency 'FireworkVideo', '1.7.0'
+  s.dependency 'FireworkVideo', '1.8.0'
 end

package/src/FWNavigator.ts

@@ -5,6 +5,9 @@ import FWNavigatorModule, {
 } from './modules/FWNavigatorModule';
 import FWLoggerUtil from './utils/FWLoggerUtil';
 
+/**
+ * @deprecated The type will be deprecated since RN SDK V2.0.
+ */
 export type FWNativeContainerProps = {
   [key: string]: any;
 };
@@ -33,7 +36,7 @@ class FWNavigator {
    * @param {FWNativeContainerProps} props We will pass the props to your app component.
    * @returns {Promise<boolean>} The result of pushing RN page from native page.
    *
-   * @deprecated The property will be deprecated since RN SDK V2.
+   * @deprecated The method will be deprecated since RN SDK V2.0.
    */
   public pushNativeContainer(props: FWNativeContainerProps): Promise<boolean> {
     FWLoggerUtil.log(`Enter pushNewNativeContainer`);
@@ -54,7 +57,7 @@ class FWNavigator {
    * @returns {Promise<boolean>} If the result is true,
    * we could call popNativeContainer to pop top-most native container.
    *
-   * @deprecated The property will be deprecated since RN SDK V2.
+   * @deprecated The method will be deprecated since RN SDK V2.0.
    */
   public canPopNativeContainer(): Promise<boolean> {
     return FWNavigatorModule.canPopNativeContainer();

package/src/FireworkSDK.ts

@@ -56,10 +56,15 @@ class FireworkSDK {
 
   /**
    * The custom CTA link content page route name.
+   *
+   * @deprecated The get accessor will be deprecated since RN SDK V2.0.
    */
   public get customCTALinkContentPageRouteName(): string | undefined {
     return this._customCTALinkContentPageRouteName;
   }
+  /**
+   * @deprecated The set accessor will be deprecated since RN SDK V2.0.
+   */
   public set customCTALinkContentPageRouteName(value: string | undefined) {
     this._customCTALinkContentPageRouteName = value;
     FireworkSDKModule.setCustomCTALinkContentPageRouteName(value ?? '');
@@ -120,20 +125,25 @@ class FireworkSDK {
 
   /**
    * The app component name.
+   *
+   * @deprecated The get accessor will be deprecated since RN SDK V2.0.
    */
   public get appComponentName(): string | undefined {
     return this._appComponentName;
   }
+  /**
+   * @deprecated The set accessor will be deprecated since RN SDK V2.0.
+   */
   public set appComponentName(value: string | undefined) {
     this._appComponentName = value;
     FireworkSDKModule.setAppComponentName(value ?? '');
   }
   private _appComponentName: string | undefined;
 
-  public get appLanguage(): string | undefined {
+  public get appLanguage(): string | undefined | null {
     return this._appLanguage;
   }
-  private _appLanguage: string | undefined;
+  private _appLanguage: string | undefined | null;
 
   /**
    * Defaults to false. You can enable debug logs by setting this property to true.
@@ -259,10 +269,11 @@ class FireworkSDK {
 
   /**
    * Change App level language.
-   * @param {string} language Such as en, ar and en-US
+   * @param {string | undefined | null} language Such as en, ar and en-US
+   * If language is null or undefined or empty string, we will use system language.
    * @returns
    */
-  public async changeAppLanguage(language: string): Promise<boolean> {
+  public async changeAppLanguage(language?: string | null): Promise<boolean> {
     const result = await FireworkSDKModule.changeAppLanguage(language);
     if (result) {
       const valueHasChanged = this._appLanguage !== language;

package/src/VideoShopping.ts

@@ -4,6 +4,7 @@ import type AddToCartResult from './models/AddToCartResult';
 import type {
   AddToCartEvent,
   CustomClickLinkButtonEvent,
+  ShoppingCTAEvent,
   UpdateProductDetailsEvent,
   WillDisplayProductEvent,
 } from './models/FWEvents';
@@ -15,11 +16,22 @@ import ShoppingModule, {
 } from './modules/ShoppingModule';
 import type { NewNativeContainerProps } from './models/NewNativeContainerProps';
 import FWLoggerUtil from './utils/FWLoggerUtil';
+import type ShoppingCTAResult from './models/ShoppingCTAResult';
 
+/**
+ * @deprecated The type will be deprecated since RN SDK V2.1.
+ */
 export type AddToCartCallback = (
   event: AddToCartEvent
 ) => Promise<AddToCartResult | undefined | null>;
 
+export type ShoppingCTACallback = (
+  event: ShoppingCTAEvent
+) => Promise<ShoppingCTAResult>;
+
+/**
+ * @deprecated The type will be deprecated since RN SDK V2.0.
+ */
 export type ClickCartIconCallback = () => Promise<
   NewNativeContainerProps | undefined | null
 >;
@@ -30,6 +42,9 @@ export type UpdateProductDetailsCallback = (
   event: UpdateProductDetailsEvent
 ) => Promise<Product[] | undefined | null>;
 
+/**
+ * @deprecated The type will be deprecated since RN SDK V2.0.
+ */
 export type WillDisplayProductCallback = (
   event: WillDisplayProductEvent
 ) => Promise<ProductInfoViewConfiguration | undefined | null>;
@@ -49,14 +64,23 @@ class VideoShopping {
    *
    * The host apps can return an AddToCartResult object to tell FireworkSDK the result of adding to cart.
    * If the host apps want to customize the processing logic of clicking "Add to cart" button, they could return null or undefined in the callback.
+   * @deprecated The callback will be deprecated since RN SDK V2.1.
    */
   public onAddToCart?: AddToCartCallback;
 
+  /**
+   * This callback is triggered when the user clicks the "Add to cart" or "Shop now" button.
+   * The host app can return a ShoppingCTAResult object to tell SDK how to handle the result.
+   */
+  public onShoppingCTA?: ShoppingCTACallback;
+
   /**
    * This callback is triggered when the user clicks the shopping cart icon.
    *
    * The host app can return NewNativeContainerProps object
    * and we will push a new native container with the props.
+   *
+   * @deprecated The property will be deprecated since RN SDK V2.0.
    */
   public onClickCartIcon?: ClickCartIconCallback;
 
@@ -89,7 +113,8 @@ class VideoShopping {
   /**
    * Please use productInfoViewConfiguration property. Only supported on iOS.
    *
-   * @deprecated The property will be deprecated since RN SDK V2.
+   * @deprecated The property will be deprecated since RN SDK V2.0.
+   * Use {@link productInfoViewConfiguration} instead.
    */
   public onWillDisplayProduct?: WillDisplayProductCallback;
 
@@ -107,8 +132,9 @@ class VideoShopping {
   private _cartIconVisible: boolean = true;
 
   /**
-   * The host app can use this property to configure "Add to cart" button style
-   * and hide the link button next to "Add to cart" button. Only supported on iOS.
+   * The configuration of product info view.
+   * Please refer to {@link ProductInfoViewConfiguration} for more details.
+   * Only supported on iOS.
    */
   public get productInfoViewConfiguration():
     | ProductInfoViewConfiguration
@@ -145,9 +171,7 @@ class VideoShopping {
     value: CustomClickLinkButtonCallback | undefined
   ) {
     this._onCustomClickLinkButton = value;
-    if (Platform.OS === 'android') {
-      ShoppingModule.setCustomClickLinkButtonEnabled(!!value);
-    }
+    ShoppingModule.setCustomClickLinkButtonEnabled(!!value);
   }
   private _onCustomClickLinkButton?: CustomClickLinkButtonCallback | undefined;
 
@@ -165,12 +189,26 @@ class VideoShopping {
   }
 
   private constructor() {
-    this.eventEmitter.addListener(FWEventName.AddToCart, (event) => {
-      FWLoggerUtil.log(
-        `Receive AddToCart event productId: ${event?.productId} unitId: ${event?.unitId}`
+    if (Platform.OS === 'android') {
+      this.eventEmitter.addListener(FWEventName.AddToCart, (event) => {
+        FWLoggerUtil.log(
+          `Receive AddToCart event productId: ${event?.productId} unitId: ${event?.unitId}`
+        );
+        this.handleShoppingCTAEvent(event);
+      });
+    }
+
+    if (Platform.OS === 'ios') {
+      this.eventEmitter.addListener(
+        FWEventName.ShoppingCTAButtonClick,
+        (event) => {
+          FWLoggerUtil.log(
+            `Receive ShoppingCTA event productId: ${event?.productId} unitId: ${event?.unitId} url: ${event?.url}`
+          );
+          this.handleShoppingCTAEvent(event);
+        }
       );
-      this.handleAddToCartEvent(event);
-    });
+    }
 
     this.eventEmitter.addListener(FWEventName.ClickCartIcon, (event) => {
       FWLoggerUtil.log('Receive ClickCartIcon event');
@@ -192,17 +230,15 @@ class VideoShopping {
     });
     this.eventEmitter.addListener(FWEventName.LogMessage, () => {});
 
-    if (Platform.OS === 'android') {
-      this.eventEmitter.addListener(
-        FWEventName.CustomLinkButtonClick,
-        (event) => {
-          FWLoggerUtil.log(
-            `Receive CustomLinkButtonClick event url: ${event?.url}`
-          );
-          this.handleCustomLinkButtonClickEvent(event);
-        }
-      );
-    }
+    this.eventEmitter.addListener(
+      FWEventName.CustomLinkButtonClick,
+      (event) => {
+        FWLoggerUtil.log(
+          `Receive CustomLinkButtonClick event url: ${event?.url}`
+        );
+        this.handleCustomLinkButtonClickEvent(event);
+      }
+    );
   }
 
   /**
@@ -217,30 +253,69 @@ class VideoShopping {
     ShoppingModule.setCartItemCount(count);
   }
 
-  private async handleAddToCartEvent(event: any) {
+  private async handleShoppingCTAEvent(event: any) {
     const callbackId = event.callbackId;
     delete event.callbackId;
-    if (this.onAddToCart) {
+    let isShopNowCTA = false;
+    if (
+      Platform.OS === 'ios' &&
+      this.productInfoViewConfiguration?.ctaButton?.text === 'shopNow'
+    ) {
+      isShopNowCTA = true;
+    }
+
+    if (this.onShoppingCTA) {
+      const result = await this.onShoppingCTA(event as ShoppingCTAEvent);
+      if (callbackId) {
+        if (Platform.OS === 'ios') {
+          ShoppingModule.updateShoppingCTAResult(result, callbackId);
+        } else {
+          if (result.tips) {
+            ShoppingModule.updateAddToCartStatus(
+              result.res,
+              result.tips,
+              callbackId
+            );
+          }
+        }
+      }
+    } else if (this.onAddToCart && !isShopNowCTA) {
+      if (event.url) {
+        delete event.url;
+      }
       const result = await this.onAddToCart(event as AddToCartEvent);
       if (result) {
         if (callbackId) {
-          ShoppingModule.updateAddToCartStatus(
-            result.res,
-            result.tips,
-            callbackId
-          );
+          if (Platform.OS === 'ios') {
+            ShoppingModule.updateShoppingCTAResult(
+              { res: result.res, tips: result.tips },
+              callbackId
+            );
+          } else {
+            ShoppingModule.updateAddToCartStatus(
+              result.res,
+              result.tips ?? '',
+              callbackId
+            );
+          }
         }
       } else {
         if (callbackId) {
           if (Platform.OS === 'ios') {
-            ShoppingModule.clearCallbackId(callbackId, FWEventName.AddToCart);
+            ShoppingModule.clearCallbackId(
+              callbackId,
+              FWEventName.ShoppingCTAButtonClick
+            );
           }
         }
       }
     } else {
       if (callbackId) {
         if (Platform.OS === 'ios') {
-          ShoppingModule.clearCallbackId(callbackId, FWEventName.AddToCart);
+          ShoppingModule.clearCallbackId(
+            callbackId,
+            FWEventName.ShoppingCTAButtonClick
+          );
         }
       }
     }
@@ -314,7 +389,7 @@ class VideoShopping {
         event as WillDisplayProductEvent
       );
       if (config) {
-        ShoppingModule.setProductInfoViewConfiguration(config);
+        this.productInfoViewConfiguration = config;
       }
     }
   }