@adadapted/react-native-sdk 3.4.0 → 3.5.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adadapted/react-native-sdk",
-  "version": "3.4.0",
+  "version": "3.5.1",
   "description": "The AdAdapted react-native SDK.",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -21,13 +21,17 @@
     "lint": "eslint --version && eslint ./",
     "compile": "tsc --version && tsc --project tsconfig.json --noEmit --noErrorTruncation --pretty",
     "test-coverage": "rm -rf coverage && jest --version --clearCache && jest --coverage --clearCache",
-    "enable-git-hooks": "git config core.hooksPath .git-hooks",
-    "test": "jest --version --clearCache && jest",
+    "enable-pre-commit": "pre-commit install",
+    "test": "jest --version --clearCache && jest --passWithNoTests",
     "prettier": "prettier --list-different \"*.{ts,tsx,js,jsx,json,css,scss,md}\" \"src/**/*.{ts,tsx,js,jsx,json,css,scss,md}\"",
     "prepack": "bob build",
     "example-app-install-pods": "cd example/ios && pod install",
     "npm-check-outdated": "npm outdated",
     "check-peer-dependencies": "npx check-peer-dependencies --npm",
+    "update-packages-semver-safe": "npm update",
+    "update-packages-latest-available": "npx npm-check-updates -u",
+    "install-packages": "npm install",
+    "audit-fix-packages": "npm audit fix",
     "prepare": "bob build"
   },
   "keywords": [
@@ -41,18 +45,17 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://gitlab.com/adadapted/adadapted-react-native-sdk"
+    "url": "https://github.com/adadaptedinc/adadapted-react-native-sdk"
   },
-  "author": "Jeramy Usher <jusher@adadapted.com> (https://gitlab.com/adadapted/adadapted-react-native-sdk)",
+  "author": "Jeramy Usher <jusher@adadapted.com> (https://github.com/adadaptedinc/adadapted-react-native-sdk)",
   "license": "AdAdapted Platform License",
   "bugs": {
-    "url": "https://gitlab.com/adadapted/adadapted-react-native-sdk/issues"
+    "url": "https://github.com/adadaptedinc/adadapted-react-native-sdk/issues"
   },
-  "homepage": "https://gitlab.com/adadapted/adadapted-react-native-sdk#readme",
+  "homepage": "https://github.com/adadaptedinc/adadapted-react-native-sdk",
   "dependencies": {
-    "@react-native-community/eslint-config": "^3.2.0",
     "axios": "^1.7.9",
-    "react-native-base64": "0.2.1",
+    "react-native-base64": "^0.2.2",
     "type-zoo": "3.4.1"
   },
   "peerDependencies": {
@@ -62,32 +65,38 @@
   },
   "devDependencies": {
     "@babel/plugin-proposal-private-property-in-object": "^7.21.11",
-    "@babel/plugin-transform-typescript": "7.22.5",
-    "@babel/preset-env": "7.22.5",
-    "@babel/preset-react": "7.22.5",
-    "@babel/preset-typescript": "7.22.5",
-    "@react-native/typescript-config": "0.74.88",
-    "@types/jest": "29.5.2",
-    "@types/react": "18.3.1",
-    "@types/react-native-base64": "0.2.0",
-    "@typescript-eslint/eslint-plugin": "^5.62.0",
-    "@typescript-eslint/parser": "5.60.0",
-    "eslint": "^8.19.0",
-    "eslint-config-standard-with-typescript": "^36.0.0",
-    "eslint-plugin-import": "^2.27.5",
-    "eslint-plugin-jest": "27.2.2",
-    "eslint-plugin-jsdoc": "46.2.6",
-    "eslint-plugin-n": "^15.7.0",
+    "@babel/plugin-transform-typescript": "^7.28.6",
+    "@babel/preset-env": "^7.29.2",
+    "@babel/preset-react": "^7.28.5",
+    "@babel/preset-typescript": "^7.28.5",
+    "@eslint/eslintrc": "^3.0.0",
+    "@eslint/js": "^9.0.0",
+    "@react-native/typescript-config": "^0.85.2",
+    "@types/react": "^19.0.0",
+    "@testing-library/jest-dom": "^6.0.0",
+    "@types/react-native-base64": "^0.2.2",
+    "@typescript-eslint/eslint-plugin": "^8.59.0",
+    "@typescript-eslint/parser": "^8.59.0",
+    "eslint": "^9.0.0",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-jest": "^29.15.0",
+    "eslint-plugin-jsdoc": "^62.9.0",
+    "eslint-plugin-n": "^17.24.0",
     "eslint-plugin-prefer-arrow": "1.2.3",
-    "eslint-plugin-promise": "^6.1.1",
-    "eslint-plugin-react": "^7.32.2",
-    "eslint-plugin-react-hooks": "^5.1.0",
-    "eslint-plugin-react-native": "^4.0.0",
-    "jest": "^29.6.3",
-    "prettier": "2.8.8",
-    "react-native-builder-bob": "0.33.3",
-    "ts-jest": "29.1.0",
-    "typescript": "5.0.4"
+    "eslint-plugin-promise": "^7.3.0",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^7.1.1",
+    "eslint-plugin-react-native": "^5.0.0",
+    "globals": "^17.0.0",
+    "jest": "^30.3.0",
+    "prettier": "^3.8.3",
+    "react": "^19.0.0",
+    "react-native": "^0.80.0",
+    "react-native-builder-bob": "^0.41.0",
+    "react-native-webview": "^13.16.1",
+    "ts-jest": "^29.4.9",
+    "typescript": "^6.0.0",
+    "typescript-eslint": "^8.59.0"
   },
   "jest": {
     "preset": "react-native",

package/src/api/adadaptedApiRequests.mock.ts

@@ -119,7 +119,7 @@ export function reportInterceptEvent(): Promise<
                 status: 200,
                 statusText: "200",
             });
-        }
+        },
     );
 }
 
@@ -197,7 +197,7 @@ export function retrievePayloadContent(): Promise<
                 status: 200,
                 statusText: "200",
             });
-        }
+        },
     );
 }
 

package/src/api/adadaptedApiRequests.ts

@@ -19,7 +19,8 @@ import {
 } from "./adadaptedApiTypes";
 import axios, { AxiosResponse } from "axios";
 import * as adadaptedApiRequestMocks from "./adadaptedApiRequests.mock";
-import { ApiEnv, DeviceOS, ListManagerApiEnv, PayloadApiEnv } from "../index";
+import { DeviceTypes } from "../componentTypes/Device";
+import { EnvironmentTypes } from "../componentTypes/Environment";
 
 /**
  * Makes an API request to initialize the session for the AdAdapted API.
@@ -30,10 +31,10 @@ import { ApiEnv, DeviceOS, ListManagerApiEnv, PayloadApiEnv } from "../index";
  */
 export function initializeSession(
     requestData: InitializeSessionRequest,
-    deviceOS: DeviceOS,
-    apiEnv: ApiEnv
+    deviceOS: DeviceTypes.DeviceOS,
+    apiEnv: EnvironmentTypes.ApiEnv,
 ): Promise<AxiosResponse<InitializeSessionResponse>> {
-    return apiEnv === ApiEnv.Mock
+    return apiEnv === EnvironmentTypes.ApiEnv.Mock
         ? adadaptedApiRequestMocks.initializeSession()
         : axios(`${apiEnv}/v/0.9.5/${deviceOS}/sessions/initialize`, {
               method: "POST",
@@ -54,19 +55,19 @@ export function initializeSession(
  */
 export function refreshSessionData(
     requestData: RefreshSessionDataRequest,
-    deviceOS: DeviceOS,
-    apiEnv: ApiEnv
+    deviceOS: DeviceTypes.DeviceOS,
+    apiEnv: EnvironmentTypes.ApiEnv,
 ): Promise<AxiosResponse<RefreshSessionDataResponse>> {
-    return apiEnv === ApiEnv.Mock
+    return apiEnv === EnvironmentTypes.ApiEnv.Mock
         ? adadaptedApiRequestMocks.refreshSessionData()
         : axios(
-              `${apiEnv}/v/0.9.5/${deviceOS}/ads/retrieve?aid=${requestData.aid}&sid=${requestData.sid}&uid=${requestData.uid}`,
+              `${apiEnv}/v/0.9.5/${deviceOS}/ads/retrieve?aid=${requestData.aid}&sid=${requestData.sid}&uid=${requestData.uid}&sdk=${requestData.sdkVersion}&contextID=${requestData.adContext?.contextIds}&zoneID=${requestData.adContext?.zoneIds}`,
               {
                   method: "GET",
                   headers: {
                       accept: "application/json",
                   },
-              }
+              },
           );
 }
 
@@ -80,10 +81,10 @@ export function refreshSessionData(
  */
 export function reportAdEvent(
     requestData: ReportAdEventRequest,
-    deviceOS: DeviceOS,
-    apiEnv: ApiEnv
+    deviceOS: DeviceTypes.DeviceOS,
+    apiEnv: EnvironmentTypes.ApiEnv,
 ): Promise<AxiosResponse<ReportAdEventResponse>> {
-    return apiEnv === ApiEnv.Mock
+    return apiEnv === EnvironmentTypes.ApiEnv.Mock
         ? adadaptedApiRequestMocks.reportAdEvent()
         : axios(`${apiEnv}/v/0.9.5/${deviceOS}/ads/events`, {
               method: "POST",
@@ -104,10 +105,10 @@ export function reportAdEvent(
  */
 export function getKeywordIntercepts(
     requestData: KeywordInterceptsRequest,
-    deviceOS: DeviceOS,
-    apiEnv: ApiEnv
+    deviceOS: DeviceTypes.DeviceOS,
+    apiEnv: EnvironmentTypes.ApiEnv,
 ): Promise<AxiosResponse<KeywordInterceptsResponse>> {
-    return apiEnv === ApiEnv.Mock
+    return apiEnv === EnvironmentTypes.ApiEnv.Mock
         ? adadaptedApiRequestMocks.getKeywordIntercepts()
         : axios(
               `${apiEnv}/v/0.9.5/${deviceOS}/intercepts/retrieve?aid=${requestData.aid}&sid=${requestData.sid}&uid=${requestData.uid}`,
@@ -116,7 +117,7 @@ export function getKeywordIntercepts(
                   headers: {
                       accept: "application/json",
                   },
-              }
+              },
           );
 }
 
@@ -130,10 +131,10 @@ export function getKeywordIntercepts(
  */
 export function reportInterceptEvent(
     requestData: ReportInterceptEventRequest,
-    deviceOS: DeviceOS,
-    apiEnv: ApiEnv
+    deviceOS: DeviceTypes.DeviceOS,
+    apiEnv: EnvironmentTypes.ApiEnv,
 ): Promise<AxiosResponse<ReportInterceptEventResponse>> {
-    return apiEnv === ApiEnv.Mock
+    return apiEnv === EnvironmentTypes.ApiEnv.Mock
         ? adadaptedApiRequestMocks.reportInterceptEvent()
         : axios(`${apiEnv}/v/0.9.5/${deviceOS}/intercepts/events`, {
               method: "POST",
@@ -154,10 +155,10 @@ export function reportInterceptEvent(
  */
 export function reportListManagerEvents(
     requestData: ReportListManagerDataRequest,
-    deviceOS: DeviceOS,
-    apiEnv: ListManagerApiEnv
+    deviceOS: DeviceTypes.DeviceOS,
+    apiEnv: EnvironmentTypes.ListManagerApiEnv,
 ): Promise<AxiosResponse<void>> {
-    return apiEnv === ListManagerApiEnv.Mock
+    return apiEnv === EnvironmentTypes.ListManagerApiEnv.Mock
         ? adadaptedApiRequestMocks.reportListManagerEvents()
         : axios(`${apiEnv}/v/1/${deviceOS}/events`, {
               method: "POST",
@@ -178,9 +179,9 @@ export function reportListManagerEvents(
  */
 export function reportPayloadContentStatus(
     requestData: ReportPayloadDataRequest,
-    apiEnv: PayloadApiEnv
+    apiEnv: EnvironmentTypes.PayloadApiEnv,
 ): Promise<AxiosResponse<void>> {
-    return apiEnv === PayloadApiEnv.Mock
+    return apiEnv === EnvironmentTypes.PayloadApiEnv.Mock
         ? adadaptedApiRequestMocks.reportPayloadContentStatus()
         : axios(`${apiEnv}/v/1/tracking`, {
               method: "POST",
@@ -200,9 +201,9 @@ export function reportPayloadContentStatus(
  */
 export function retrievePayloadContent(
     requestData: RetrievePayloadItemDataRequest,
-    apiEnv: PayloadApiEnv
+    apiEnv: EnvironmentTypes.PayloadApiEnv,
 ): Promise<AxiosResponse<RetrievePayloadItemDataResponse>> {
-    return apiEnv === PayloadApiEnv.Mock
+    return apiEnv === EnvironmentTypes.PayloadApiEnv.Mock
         ? adadaptedApiRequestMocks.retrievePayloadContent()
         : axios(`${apiEnv}/v/1/pickup`, {
               method: "POST",

package/src/api/adadaptedApiTypes.ts

@@ -156,11 +156,6 @@ export interface OutOfAppDataPayload {
     detailed_list_items: DetailedListItem[];
 }
 
-export interface AdZoneDetailedListItemInfo {
-    zoneId: string;
-    items: DetailedListItem[];
-}
-
 /**
  * The definition of a Detailed List Item.
  */
@@ -571,6 +566,17 @@ export interface RefreshSessionDataRequest {
      * The current session ID.
      */
     sid: string;
+    /**
+     * The current sdk version.
+     */
+    sdkVersion: string;
+    /**
+     * The context IDs and associated zone IDs.
+     */
+    adContext?: {
+        contextIds: string[] | undefined;
+        zoneIds: string[];
+    };
 }
 
 /**

package/src/componentTypes/AdZone.ts

@@ -0,0 +1,97 @@
+import { ViewStyle } from "react-native";
+import { Zone, DetailedListItem } from "src/api/adadaptedApiTypes";
+import { DeviceTypes } from "./Device";
+import { EnvironmentTypes } from "./Environment";
+
+/**
+ * Namespace for AdZone types.
+ */
+export namespace AdZoneTypes {
+    /**
+     * Props interface for an ad zone.
+     */
+    export interface Props {
+        /**
+         * The app ID.
+         */
+        appId: string;
+        /**
+         * The session ID.
+         */
+        sessionId: string;
+        /**
+         * The UDID.
+         */
+        udid: string;
+        /**
+         * 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
+         * Ad Zone is being touched by the user as a regular touch or while
+         * scrolling the view. If the amount of touch "drag" distance in either
+         * X or Y direction is less than this value, we will treat the action as
+         * a click/press on the Ad Zone.
+         */
+        xyDragDistanceAllowed: number;
+        /**
+         * The device OS used for API requests.
+         */
+        deviceOs: DeviceTypes.DeviceOS;
+        /**
+         * The API environment to use when making an API request.
+         */
+        apiEnv: EnvironmentTypes.ApiEnv;
+        /**
+         * The ad zone data.
+         */
+        adZoneData: Zone;
+        /**
+         * Callback that gets triggered when an "add to list" item/items are clicked.
+         * @param items - The array of items to "add to list".
+         */
+        onAddToListTriggered?(items: DetailedListItem[]): void;
+        /**
+         * An ad zone that is not visible on screen for the initial render.
+         */
+        offScreenAdZone: boolean;
+        /**
+         * Track the ad zone visibility in parent component. (for off-screen ads)
+         */
+        isAdZoneVisible?: boolean;
+        /**
+         * Flag to determine if the ad is contextual.
+         */
+        isContextualAd?: boolean;
+    }
+
+    /**
+     * Interface for tracking "touch" coordinates.
+     */
+    export interface TouchCoordinates {
+        /**
+         * The X coordinate for the touch.
+         */
+        x: number;
+        /**
+         * The Y coordinate for the touch.
+         */
+        y: number;
+    }
+
+    /**
+     * Defines the style typing for the component.
+     */
+    export interface StyleDef {
+        /**
+         * Styles for the main View element.
+         */
+        mainView: ViewStyle;
+        /**
+         * Styles for the WebView element.
+         */
+        webView: ViewStyle;
+        /**
+         * Styles for the ReportAdButton.
+         */
+        reportAd: ViewStyle;
+    }
+}

package/src/componentTypes/Device.ts

@@ -0,0 +1,79 @@
+/**
+ * Namespace for Device types.
+ */
+export namespace DeviceTypes {
+    /**
+     * Enum representing possible device operating systems.
+     */
+    export enum DeviceOS {
+        /**
+         * Represents the Android operating system.
+         */
+        ANDROID = "android",
+        /**
+         * Represents the iOS operating system.
+         */
+        IOS = "ios",
+    }
+    /**
+     * Interface defining properties of a user's Device.
+     */
+    export interface DeviceInfo {
+        /**
+         * The unique device ID.
+         */
+        udid: string;
+        /**
+         * The device name.
+         */
+        deviceName: string;
+        /**
+         * The operating system name.
+         */
+        systemName: string;
+        /**
+         * The operating system version.
+         */
+        systemVersion: string;
+        /**
+         * The device model.
+         */
+        deviceModel: string;
+        /**
+         * The device screen width.
+         */
+        deviceWidth: string;
+        /**
+         * The device screen height.
+         */
+        deviceHeight: string;
+        /**
+         * The device screen density.
+         */
+        deviceScreenDensity: string;
+        /**
+         * The current device local.
+         */
+        deviceLocale: string;
+        /**
+         * The device carrier name.
+         */
+        deviceCarrier: string;
+        /**
+         * The bundle ID.
+         */
+        bundleId: string;
+        /**
+         * The bundle version.
+         */
+        bundleVersion: string;
+        /**
+         * The current device timezone.
+         */
+        deviceTimezone: string;
+        /**
+         * If true, ad tracking is enabled for the device.
+         */
+        isAdTrackingEnabled: boolean;
+    }
+}

package/src/componentTypes/Environment.ts

@@ -0,0 +1,58 @@
+/**
+ * Namespace for environment types.
+ */
+export namespace EnvironmentTypes {
+    /**
+     * Enum defining the different API environments.
+     */
+    export enum ApiEnv {
+        /**
+         * The production API environment.
+         */
+        Prod = "https://ads.adadapted.com",
+        /**
+         * The development API environment.
+         */
+        Dev = "https://sandbox.adadapted.com",
+        /**
+         * Used only for unit testing/mock data.
+         */
+        Mock = "MOCK_DATA",
+    }
+
+    /**
+     * Enum defining the different API environments for List Manager.
+     */
+    export enum ListManagerApiEnv {
+        /**
+         * The production API environment.
+         */
+        Prod = "https://ec.adadapted.com",
+        /**
+         * The development API environment.
+         */
+        Dev = "https://sandec.adadapted.com",
+        /**
+         * Used only for unit testing/mocking data.
+         */
+        Mock = "MOCK_DATA",
+    }
+
+    /**
+     * Enum defining the different API environments for the Payload Server.
+     */
+    export enum PayloadApiEnv {
+        /**
+         * The production API environment.
+         */
+        Prod = "https://payload.adadapted.com",
+        /**
+         * The development API environment.
+         */
+        Dev = "https://sandpayload.adadapted.com",
+        /**
+         * Used only for unit testing/mocking data.
+         */
+        Mock = "MOCK_DATA",
+    }
+}