@adadapted/react-native-sdk 3.1.12 → 3.3.0

package/src/index.tsx

@@ -3,7 +3,7 @@
  */
 import * as React from "react";
 import {
-    AppState,
+    DeviceEventEmitter,
     EmitterSubscription,
     Linking,
     NativeModules,
@@ -99,7 +99,7 @@ export enum PayloadApiEnv {
 }
 
 /**
- * Interface defining inputs to the {@link Sdk.initialize} method.
+ * Interface defining inputs to the {@link Sdk.initialize: AdadaptedReactNativeSdk} method.
  */
 export interface InitializeProps {
     /**
@@ -140,6 +140,10 @@ export interface InitializeProps {
      * @param payloads - All payloads the client must go through.
      */
     onOutOfAppPayloadAvailable?(payloads: OutOfAppDataPayload[]): void;
+    /**
+     * Ad zones that contain off-screen ads.
+     */
+    offScreenAdZone?: [number];
 }
 
 /**
@@ -267,6 +271,10 @@ export class AdadaptedReactNativeSdk {
      * The available ad zones.
      */
     private adZones: AdZoneInfo[] | undefined;
+    /**
+     * The available off-screen ad zones.
+     */
+    private offScreenAdZones: AdZoneInfo[] = [];
     /**
      * The touch sensitivity of the Ad Zone in both the X and Y directions.
      * This is used to determine the click/press sensitivity when the
@@ -324,6 +332,14 @@ export class AdadaptedReactNativeSdk {
      * AppState event listener.
      */
     private AppStateOnEventListener: EmitterSubscription | undefined;
+    /**
+     * Track ad zone visibility for off-screen ads.
+     */
+    private isAdZoneVisible: boolean = true;
+    /**
+     * Ad zones that contain off-screen ads..
+     */
+    private offScreenAdZone: [number] | undefined;
     /**
      * Gets the Session ID.
      * @returns the Session ID.
@@ -348,6 +364,14 @@ export class AdadaptedReactNativeSdk {
         return this.adZones;
     }
 
+    /**
+     * Gets the list of available off-screen Ad Zones.
+     * @returns all available off-screen ad zones.
+     */
+    public getOffScreenAdZones(): AdZoneInfo[] | undefined {
+        return this.offScreenAdZones;
+    }
+
     /**
      * @inheritDoc
      */
@@ -396,29 +420,83 @@ export class AdadaptedReactNativeSdk {
 
         for (const adZoneId in adZones) {
             if (Object.prototype.hasOwnProperty.call(adZones, adZoneId)) {
-                adZoneInfoList.push({
-                    zoneId: adZones[adZoneId].id,
-                    adZone: (
-                        <AdZone
-                            key={adZoneId}
-                            appId={this.appId}
-                            sessionId={this.sessionId!}
-                            udid={this.deviceInfo!.udid}
-                            deviceOs={this.deviceOs!}
-                            apiEnv={this.apiEnv}
-                            xyDragDistanceAllowed={
-                                this.xyAdZoneDragDistanceAllowed || 25
-                            }
-                            adZoneData={adZones[adZoneId]}
-                            onAddToListTriggered={(items) => {
-                                safeInvoke(this.onAddToListTriggered, items);
-                            }}
-                        />
-                    ),
+                this.offScreenAdZone?.forEach((zone) => {
+                    if (Number(adZones[adZoneId].id) !== zone) {
+                        adZoneInfoList.push({
+                            zoneId: adZones[adZoneId].id,
+                            adZone: (
+                                <AdZone
+                                    key={adZoneId}
+                                    appId={this.appId}
+                                    sessionId={this.sessionId!}
+                                    udid={this.deviceInfo!.udid}
+                                    deviceOs={this.deviceOs!}
+                                    apiEnv={this.apiEnv}
+                                    xyDragDistanceAllowed={
+                                        this.xyAdZoneDragDistanceAllowed || 25
+                                    }
+                                    adZoneData={adZones[adZoneId]}
+                                    onAddToListTriggered={(items) => {
+                                        safeInvoke(
+                                            this.onAddToListTriggered,
+                                            items
+                                        );
+                                    }}
+                                    isAdZoneVisible={true}
+                                    offScreenAdZone={false}
+                                />
+                            ),
+                        });
+                    }
                 });
             }
         }
+        return adZoneInfoList;
+    }
 
+    /**
+     * Creates all off-screen Ad Zone Info objects based on provided off-screen Ad Zones.
+     * @param adZones - The object of available zones.
+     * @returns the array of off-screen Ad Zone Info objects.
+     */
+    private generateOffScreenAdZones(adZones: {
+        [key: number]: Zone;
+    }): AdZoneInfo[] {
+        const adZoneInfoList: AdZoneInfo[] = [];
+
+        for (const adZoneId in adZones) {
+            if (Object.prototype.hasOwnProperty.call(adZones, adZoneId)) {
+                this.offScreenAdZone?.forEach((zone) => {
+                    if (Number(adZones[adZoneId].id) === zone) {
+                        adZoneInfoList.push({
+                            zoneId: adZones[adZoneId].id,
+                            adZone: (
+                                <AdZone
+                                    key={adZoneId}
+                                    appId={this.appId}
+                                    sessionId={this.sessionId!}
+                                    udid={this.deviceInfo!.udid}
+                                    deviceOs={this.deviceOs!}
+                                    apiEnv={this.apiEnv}
+                                    xyDragDistanceAllowed={
+                                        this.xyAdZoneDragDistanceAllowed || 25
+                                    }
+                                    adZoneData={adZones[adZoneId]}
+                                    onAddToListTriggered={(items) => {
+                                        safeInvoke(
+                                            this.onAddToListTriggered,
+                                            items
+                                        );
+                                    }}
+                                    isAdZoneVisible={this.isAdZoneVisible}
+                                    offScreenAdZone={true}
+                                />
+                            ),
+                        });
+                    }
+                });
+            }
+        }
         return adZoneInfoList;
     }
 
@@ -449,6 +527,9 @@ export class AdadaptedReactNativeSdk {
                 .then((response) => {
                     this.sessionInfo = response.data;
                     this.adZones = this.generateAdZones(response.data.zones);
+                    this.offScreenAdZones = this.generateOffScreenAdZones(
+                        response.data.zones
+                    );
 
                     // Call the user defined callback indicating
                     // the session data has been refreshed.
@@ -484,8 +565,6 @@ export class AdadaptedReactNativeSdk {
             )
             .then((response) => {
                 this.keywordIntercepts = response.data;
-
-                this.performKeywordSearch("mil");
             });
     }
 
@@ -561,13 +640,15 @@ export class AdadaptedReactNativeSdk {
      */
     private handleDeepLink(event: any): void {
         const searchStr = "data=";
-        const dataIndex: number = event["url"].indexOf(searchStr);
+        const dataIndex: number = event.url.indexOf(searchStr);
 
         if (dataIndex !== -1) {
-            const encodedData = event.url.substr(dataIndex + searchStr.length);
+            const encodedData: string = event.url.substr(
+                `${dataIndex}${searchStr.length}`
+            );
             const payloadData = JSON.parse(base64.decode(encodedData));
-            const payloadId = payloadData["payload_id"];
-            const itemDataList = payloadData["detailed_list_items"];
+            const payloadId = payloadData.payload_id;
+            const itemDataList = payloadData.detailed_list_items;
 
             if (itemDataList && itemDataList.length > 0) {
                 const finalItemList: OutOfAppDataPayload[] = [];
@@ -577,13 +658,13 @@ export class AdadaptedReactNativeSdk {
                         payload_id: payloadId,
                         detailed_list_items: [
                             {
-                                product_title: itemData["product_title"],
-                                product_brand: itemData["product_brand"],
-                                product_category: itemData["product_category"],
-                                product_barcode: itemData["product_barcode"],
-                                product_discount: itemData["product_discount"],
-                                product_image: itemData["product_image"],
-                                product_sku: itemData["product_sku"],
+                                product_title: itemData.product_title,
+                                product_brand: itemData.product_brand,
+                                product_category: itemData.product_category,
+                                product_barcode: itemData.product_barcode,
+                                product_discount: itemData.product_discount,
+                                product_image: itemData.product_image,
+                                product_sku: itemData.product_sku,
                             },
                         ],
                     });
@@ -627,16 +708,13 @@ export class AdadaptedReactNativeSdk {
                             payload_id: payload.payload_id,
                             detailed_list_items: [
                                 {
-                                    product_title: itemData["product_title"],
-                                    product_brand: itemData["product_brand"],
-                                    product_category:
-                                        itemData["product_category"],
-                                    product_barcode:
-                                        itemData["product_barcode"],
-                                    product_discount:
-                                        itemData["product_discount"],
-                                    product_image: itemData["product_image"],
-                                    product_sku: itemData["product_sku"],
+                                    product_title: itemData.product_title,
+                                    product_brand: itemData.product_brand,
+                                    product_category: itemData.product_category,
+                                    product_barcode: itemData.product_barcode,
+                                    product_discount: itemData.product_discount,
+                                    product_image: itemData.product_image,
+                                    product_sku: itemData.product_sku,
                                 },
                             ],
                         });
@@ -651,6 +729,23 @@ export class AdadaptedReactNativeSdk {
             });
     }
 
+    /**
+     * Notify the ad zone of visibility status change for off-screen ads.
+     * @param isVisible - Ad Zone visibility tracking.
+     */
+    public onAdZoneVisibilityChanged(isVisible: boolean): void {
+        this.isAdZoneVisible = isVisible;
+        DeviceEventEmitter.emit("visibility-event", isVisible);
+    }
+
+    /**
+     * Notify the adZone to send ad interaction report.
+     * @param itemName - Detailed list item title from ad that was clicked.
+     */
+    public acknowledge(itemName: string): void {
+        DeviceEventEmitter.emit("acknowledge", itemName);
+    }
+
     /**
      * Initializes the session for the AdAdapted API and sets up the SDK.
      * @param props - The props used to initialize the SDK.
@@ -703,6 +798,11 @@ export class AdadaptedReactNativeSdk {
             this.onOutOfAppPayloadAvailable = props.onOutOfAppPayloadAvailable;
         }
 
+        // If provided set any off-screen ad zones.
+        if (props.offScreenAdZone) {
+            this.offScreenAdZone = props.offScreenAdZone;
+        }
+
         return new Promise<void>((resolve, reject) => {
             this.getDeviceInformation()
                 .then((deviceInfoObj) => {
@@ -758,6 +858,10 @@ export class AdadaptedReactNativeSdk {
                             this.adZones = this.generateAdZones(
                                 response.data.zones
                             );
+                            this.offScreenAdZones =
+                                this.generateOffScreenAdZones(
+                                    response.data.zones
+                                );
 
                             // Start the session data refresh timer.
                             this.onRefreshAdZones();
@@ -783,18 +887,18 @@ export class AdadaptedReactNativeSdk {
                             this.getPayloadItemData();
 
                             // Initialize an event listener to intercept deep links while the app is running.
-
-                            this.deepLinkOnEventListener = Linking.addEventListener(
-                                "url",
-                                this.handleDeepLink
-                            );
-
-                            // Initialize an event listener to intercept App state changes.
-
-                            this.AppStateOnEventListener = AppState.addEventListener(
-                                "change",
-                                this.handleAppStateChange
-                            );
+                            this.deepLinkOnEventListener =
+                                Linking.addEventListener(
+                                    "url",
+                                    this.handleDeepLink
+                                );
+
+                            // // Initialize an event listener to intercept App state changes.
+                            // this.AppStateOnEventListener =
+                            //     AppState.addEventListener(
+                            //         "change",
+                            //         this.handleAppStateChange
+                            //     );
 
                             resolve();
                         })

package/src/util.ts

@@ -14,6 +14,8 @@ export function safeInvoke<R>(func: (() => R) | nil): R | undefined;
  * See main definition above.
  * @param func - The function to call.
  * @param arg1 - Function argument.
+ * @returns The return value of the executed function, or undefined if
+ *      the function is null/undefined
  */
 export function safeInvoke<A1, R>(
     func: ((arg1: A1) => R) | nil,
@@ -24,6 +26,8 @@ export function safeInvoke<A1, R>(
  * @param func - The function to call.
  * @param arg1 - Function argument.
  * @param arg2 - Function argument.
+ * @returns The return value of the executed function, or undefined if
+ *      the function is null/undefined
  */
 export function safeInvoke<A1, A2, R>(
     func: ((arg1: A1, arg2: A2) => R) | nil,
@@ -36,6 +40,8 @@ export function safeInvoke<A1, A2, R>(
  * @param arg1 - Function argument.
  * @param arg2 - Function argument.
  * @param arg3 - Function argument.
+ * @returns The return value of the executed function, or undefined if
+ *      the function is null/undefined
  */
 export function safeInvoke<A1, A2, A3, R>(
     func: ((arg1: A1, arg2: A2, arg3: A3) => R) | nil,
@@ -50,6 +56,8 @@ export function safeInvoke<A1, A2, A3, R>(
  * @param arg2 - Function argument.
  * @param arg3 - Function argument.
  * @param arg4 - Function argument.
+ * @returns The return value of the executed function, or undefined if
+ *      the function is null/undefined
  */
 export function safeInvoke<A1, A2, A3, A4, R>(
     func: ((arg1: A1, arg2: A2, arg3: A3, arg4: A4) => R) | nil,
@@ -66,6 +74,8 @@ export function safeInvoke<A1, A2, A3, A4, R>(
  * @param arg3 - Function argument.
  * @param arg4 - Function argument.
  * @param arg5 - Function argument.
+ * @returns The return value of the executed function, or undefined if
+ *      the function is null/undefined
  */
 export function safeInvoke<A1, A2, A3, A4, A5, R>(
     func: ((arg1: A1, arg2: A2, arg3: A3, arg4: A4, arg5: A5) => R) | nil,
@@ -84,6 +94,8 @@ export function safeInvoke<A1, A2, A3, A4, A5, R>(
  * @param arg4 - Function argument.
  * @param arg5 - Function argument.
  * @param arg6 - Function argument.
+ * @returns The return value of the executed function, or undefined if
+ *      the function is null/undefined
  */
 export function safeInvoke<A1, A2, A3, A4, A5, A6, R>(
     func:
@@ -105,6 +117,7 @@ export function safeInvoke<A1, A2, A3, A4, A5, A6, R>(
 // eslint-disable-next-line @typescript-eslint/ban-types
 export function safeInvoke(func: Function | nil, ...args: any[]): any {
     if (func) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
         return func(...args);
     }
 }