@applicaster/zapp-react-native-utils 15.0.0-rc.14 → 15.0.0-rc.141

package/manifestUtils/mobileAction/groups/index.js

@@ -0,0 +1,80 @@
+const { mobileActionButtonsContainer } = require("../container");
+const { mobileActionButton } = require("../button");
+
+const {
+  DEFAULT_MOBILE_ACTION_BUTTONS_CONTAINER_DEFAULTS,
+  DEFAULT_MOBILE_ACTION_BUTTON_SHARED_DEFAULTS,
+  DEFAULT_MOBILE_ACTION_BUTTON_PRESETS,
+} = require("./defaults");
+
+const CONTAINER_GROUP_LABEL = "Mobile Buttons Container"; // NOTE: used as key – "Mobile Buttons Container" -> "mobile_buttons_container"
+
+const CONTAINER_GROUP_DESCRIPTION =
+  "Configuration for mobile action buttons container";
+
+const BUTTON_GROUPS = [
+  {
+    index: 1,
+    label: "Mobile Button 1",
+    description: "Primary mobile action button",
+  },
+  {
+    index: 2,
+    label: "Mobile Button 2",
+    description: "Secondary mobile action button",
+  },
+  {
+    index: 3,
+    label: "Mobile Button 3",
+    description: "Tertiary mobile action button",
+  },
+];
+
+/**
+ * Builds the shared mobile action button manifest groups while letting each
+ * plugin supply only its supported insertion positions and explicit overrides.
+ *
+ * @param {object} options
+ * @param {object} [options.containerDefaults={}]
+ * @param {object} [options.sharedButtonDefaults={}]
+ * @param {Record<number, object>} [options.buttonOverrides={}]
+ * @returns {object[]}
+ */
+function buildMobileActionButtonGroups({
+  containerDefaults = {},
+  sharedButtonDefaults = {},
+  buttonOverrides = {},
+}) {
+  const groups = [
+    mobileActionButtonsContainer({
+      label: CONTAINER_GROUP_LABEL,
+      description: CONTAINER_GROUP_DESCRIPTION,
+      defaults: {
+        ...DEFAULT_MOBILE_ACTION_BUTTONS_CONTAINER_DEFAULTS,
+        ...containerDefaults,
+      },
+    }),
+  ];
+
+  BUTTON_GROUPS.forEach(({ index, label, description }) => {
+    groups.push(
+      mobileActionButton({
+        isFirstButton: index === 1,
+        label,
+        description,
+        defaults: {
+          ...DEFAULT_MOBILE_ACTION_BUTTON_SHARED_DEFAULTS,
+          ...sharedButtonDefaults,
+          ...DEFAULT_MOBILE_ACTION_BUTTON_PRESETS[index],
+          ...(buttonOverrides[index] || {}),
+        },
+      })
+    );
+  });
+
+  return groups;
+}
+
+module.exports = {
+  buildMobileActionButtonGroups,
+};

package/manifestUtils/platformIsTV.js

@@ -0,0 +1,13 @@
+function platformIsTV(platform) {
+  return [
+    "tvos_for_quickbrick",
+    "android_tv_for_quickbrick",
+    "amazon_fire_tv_for_quickbrick",
+    "lg_tv",
+    "samsung_tv",
+    "web",
+    "vizio",
+  ].includes(platform);
+}
+
+module.exports = { platformIsTV };

package/manifestUtils/sharedConfiguration/screenPicker/utils.js

@@ -3,6 +3,7 @@ const defaultPlatforms = {
   android_tv: "Android TV",
   lg_tv: "LG TV",
   samsung_tv: "Samsung TV",
+  roku: "Roku TV",
 };
 
 const global_defaults = {

package/manifestUtils/tvAction/container/index.js

@@ -38,7 +38,7 @@ function tvActionButtonsContainer({ label, description, defaults }) {
     generateFieldsFromDefaultsWithoutPrefixedLabel(
       label,
       defaults,
-      tvActionButtonContainerFields(defaults["position"])
+      tvActionButtonContainerFields(defaults.position)
     )
   );
 

package/navigationUtils/index.ts

@@ -5,7 +5,8 @@ import { layoutV2TypeMatcher } from "./layoutV2TypeMatcher";
 import { HOOKS_EVENTS } from "../appUtils/HooksManager/constants";
 import { HooksManager } from "../appUtils/HooksManager";
 import { appStore } from "@applicaster/zapp-react-native-redux/AppStore";
-import { HookModalContextT } from "@applicaster/zapp-react-native-ui-components/Contexts/ZappHookModalContext";
+
+import { zappHookModalStore } from "@applicaster/zapp-react-native-ui-components/Contexts/ZappHookModalContext";
 import { logger } from "@applicaster/zapp-react-native-utils/logger";
 import {
   isGeneralPlugin,
@@ -15,6 +16,8 @@ import {
 } from "./itemTypeMatchers";
 import { RootState } from "@applicaster/zapp-react-native-redux/store";
 
+import { pick } from "@applicaster/zapp-react-native-utils/utils";
+
 type PathAttribute = {
   screenType: string;
   screenId: string;
@@ -403,15 +406,22 @@ export const mapContentTypesToRivers = (
 };
 
 export const runZappHooksForEntry = async (
-  entry: HookPluginProps["payload"],
-  {
+  entry: HookPluginProps["payload"]
+): Promise<{ success: boolean; payload: ZappEntry }> => {
+  const {
     setState,
     resetState,
     setIsHooksExecutionInProgress,
     setIsPresentingFullScreen,
     setIsRunningInBackground,
-  }: Partial<HookModalContextT>
-): Promise<{ success: boolean; payload: ZappEntry }> => {
+  } = pick(zappHookModalStore.getState(), [
+    "setState",
+    "resetState",
+    "setIsHooksExecutionInProgress",
+    "setIsPresentingFullScreen",
+    "setIsRunningInBackground",
+  ]);
+
   resetState?.();
 
   let success;

package/numberUtils/__tests__/toNumber.test.ts

@@ -24,6 +24,8 @@ describe("toNumber", () => {
   it("return undefined if input is not a number", () => {
     const inputs = [
       "vfdvf",
+      "5n",
+      "-5n",
       null,
       undefined,
       NaN,
@@ -41,4 +43,29 @@ describe("toNumber", () => {
       expect(output).toBeUndefined();
     });
   });
+
+  describe("BigInt support", () => {
+    // Conditional test based on BigInt availability
+    const isBigIntSupported = typeof BigInt !== "undefined";
+
+    if (isBigIntSupported) {
+      it("converts BigInt to number when BigInt is supported", () => {
+        expect(toNumber(BigInt(5))).toBe(5);
+        expect(toNumber(BigInt(0))).toBe(0);
+        expect(toNumber(BigInt(-10))).toBe(-10);
+        expect(toNumber(BigInt(1000))).toBe(1000);
+      });
+
+      it("handles large BigInt values that may lose precision", () => {
+        const largeBigInt = BigInt(Number.MAX_SAFE_INTEGER) + BigInt(1);
+        const result = toNumber(largeBigInt);
+        expect(result).toBe(Number(largeBigInt));
+      });
+    } else {
+      it("skips BigInt tests when BigInt is not supported", () => {
+        // Placeholder test to indicate BigInt is not available
+        expect(typeof BigInt).toBe("undefined");
+      });
+    }
+  });
 });

package/numberUtils/__tests__/toPositiveNumber.test.ts

@@ -0,0 +1,193 @@
+import { toPositiveNumber } from "..";
+
+describe("toPositiveNumber", () => {
+  describe("valid positive numbers", () => {
+    it("returns the number for positive integers", () => {
+      expect(toPositiveNumber(5)).toBe(5);
+      expect(toPositiveNumber(1000)).toBe(1000);
+    });
+
+    it("returns the number for positive floats", () => {
+      expect(toPositiveNumber(0.1)).toBe(0.1);
+      expect(toPositiveNumber(3.14159)).toBe(3.14159);
+    });
+
+    it("returns the number for very small positive numbers", () => {
+      expect(toPositiveNumber(1e-300)).toBe(1e-300);
+    });
+
+    it("returns the number for very large positive numbers", () => {
+      expect(toPositiveNumber(1e300)).toBe(1e300);
+    });
+
+    it("returns Infinity for positive infinity", () => {
+      expect(toPositiveNumber(Infinity)).toBe(Infinity);
+    });
+
+    it("converts valid positive strings to numbers", () => {
+      expect(toPositiveNumber("5")).toBe(5);
+      expect(toPositiveNumber("3.14")).toBe(3.14);
+      expect(toPositiveNumber("  100  ")).toBe(100);
+    });
+
+    it("converts boolean true to undefined", () => {
+      expect(toPositiveNumber(true)).toBeUndefined();
+    });
+
+    it("converts single-element arrays to undefined", () => {
+      expect(toPositiveNumber([5])).toBeUndefined();
+      expect(toPositiveNumber(["10"])).toBeUndefined();
+    });
+  });
+
+  describe("invalid cases (return undefined)", () => {
+    describe("zero values", () => {
+      it("returns undefined for zero", () => {
+        expect(toPositiveNumber(0)).toBeUndefined();
+        expect(toPositiveNumber(-0)).toBeUndefined();
+      });
+
+      it("returns undefined for string zero", () => {
+        expect(toPositiveNumber("0")).toBeUndefined();
+        expect(toPositiveNumber("  0  ")).toBeUndefined();
+      });
+
+      it("returns undefined for boolean false", () => {
+        expect(toPositiveNumber(false)).toBeUndefined();
+      });
+
+      it("returns undefined for empty arrays", () => {
+        expect(toPositiveNumber([])).toBeUndefined();
+      });
+
+      it("returns undefined for empty strings", () => {
+        expect(toPositiveNumber("")).toBeUndefined();
+        expect(toPositiveNumber("   ")).toBeUndefined();
+      });
+    });
+
+    describe("negative values", () => {
+      it("returns undefined for negative numbers", () => {
+        expect(toPositiveNumber(-5)).toBeUndefined();
+        expect(toPositiveNumber(-0.1)).toBeUndefined();
+      });
+
+      it("returns undefined for negative strings", () => {
+        expect(toPositiveNumber("-5")).toBeUndefined();
+        expect(toPositiveNumber(" -10 ")).toBeUndefined();
+      });
+
+      it("returns undefined for negative infinity", () => {
+        expect(toPositiveNumber(-Infinity)).toBeUndefined();
+      });
+    });
+
+    describe("non-convertible values", () => {
+      it("returns undefined for null", () => {
+        expect(toPositiveNumber(null)).toBeUndefined();
+      });
+
+      it("returns undefined for undefined", () => {
+        expect(toPositiveNumber(undefined)).toBeUndefined();
+      });
+
+      it("returns undefined for objects", () => {
+        expect(toPositiveNumber({})).toBeUndefined();
+        expect(toPositiveNumber({ a: 1 })).toBeUndefined();
+      });
+
+      it("returns undefined for multi-element arrays", () => {
+        expect(toPositiveNumber([1, 2])).toBeUndefined();
+        expect(toPositiveNumber(["a", "b"])).toBeUndefined();
+      });
+
+      it("returns undefined for non-numeric strings", () => {
+        expect(toPositiveNumber("abc")).toBeUndefined();
+        expect(toPositiveNumber("5px")).toBeUndefined();
+        expect(toPositiveNumber("123.45.67")).toBeUndefined();
+      });
+
+      it("returns undefined for NaN", () => {
+        expect(toPositiveNumber(NaN)).toBeUndefined();
+        expect(toPositiveNumber(Number("abc"))).toBeUndefined();
+      });
+    });
+  });
+
+  describe("special cases", () => {
+    it("handles exponential notation correctly", () => {
+      expect(toPositiveNumber("1e5")).toBe(100000);
+      expect(toPositiveNumber("1e-5")).toBe(0.00001);
+      expect(toPositiveNumber("-1e5")).toBeUndefined();
+    });
+
+    it("preserves precision for decimal numbers", () => {
+      expect(toPositiveNumber(0.1 + 0.2)).toBeCloseTo(0.3);
+      expect(toPositiveNumber("0.1")).toBe(0.1);
+    });
+
+    it("handles numeric strings with leading zeros", () => {
+      expect(toPositiveNumber("005")).toBe(5);
+      expect(toPositiveNumber("0.5")).toBe(0.5);
+    });
+
+    it("returns undefined for numeric strings with trailing non-numeric characters", () => {
+      expect(toPositiveNumber("5px")).toBeUndefined();
+      expect(toPositiveNumber("10%")).toBeUndefined();
+    });
+
+    it("handles scientific notation correctly", () => {
+      expect(toPositiveNumber("1.5e2")).toBe(150);
+      expect(toPositiveNumber("-2.5e3")).toBeUndefined();
+    });
+  });
+
+  describe("type conversion behavior", () => {
+    it("converts Date objects correctly", () => {
+      const date = new Date(2026, 1, 17);
+      expect(toPositiveNumber(date)).toBeUndefined();
+    });
+
+    it("converts functions to NaN (returns undefined)", () => {
+      expect(toPositiveNumber(() => {})).toBeUndefined();
+      expect(toPositiveNumber(Math.sqrt)).toBeUndefined();
+    });
+
+    it("handles Symbol values", () => {
+      expect(toPositiveNumber(Symbol("test"))).toBeUndefined();
+    });
+  });
+
+  describe("BigInt support", () => {
+    // Conditional test based on BigInt availability
+    const isBigIntSupported = typeof BigInt !== "undefined";
+
+    if (isBigIntSupported) {
+      it("converts positive BigInt values to numbers when BigInt is supported", () => {
+        expect(toPositiveNumber(BigInt(5))).toBe(5);
+        expect(toPositiveNumber(BigInt(100))).toBe(100);
+        expect(toPositiveNumber(BigInt(1000))).toBe(1000);
+      });
+
+      it("returns undefined for zero BigInt", () => {
+        expect(toPositiveNumber(BigInt(0))).toBeUndefined();
+      });
+
+      it("returns undefined for negative BigInt values", () => {
+        expect(toPositiveNumber(BigInt(-5))).toBeUndefined();
+        expect(toPositiveNumber(BigInt(-100))).toBeUndefined();
+      });
+
+      it("handles large positive BigInt values", () => {
+        const largeBigInt = BigInt(Number.MAX_SAFE_INTEGER);
+        const result = toPositiveNumber(largeBigInt);
+        expect(result).toBe(Number(largeBigInt));
+      });
+    } else {
+      it("skips BigInt tests when BigInt is not supported", () => {
+        // Placeholder test to indicate BigInt is not available
+        expect(typeof BigInt).toBe("undefined");
+      });
+    }
+  });
+});

package/numberUtils/index.ts

@@ -8,7 +8,11 @@ export const toNumber = (value: unknown): number | undefined => {
     return undefined;
   }
 
-  if (R.is(Number, value) || R.is(String, value)) {
+  // Feature-detect BigInt support to avoid ReferenceError on older runtimes
+  const isBigIntSupported = typeof BigInt !== "undefined";
+  const isBigIntValue = isBigIntSupported && R.is(BigInt, value);
+
+  if (R.is(Number, value) || isBigIntValue || R.is(String, value)) {
     const numberOrNan = Number(value);
 
     return Number.isNaN(numberOrNan) ? undefined : numberOrNan;
@@ -69,6 +73,24 @@ export const isMinusZero = (value: number) => {
   return 1 / value === -Infinity;
 };
 
+export const toPositiveNumber = (value: unknown): number | undefined => {
+  const possibleNumber = toNumber(value);
+
+  if (R.isNil(possibleNumber)) {
+    return undefined;
+  }
+
+  if (possibleNumber < 0) {
+    return undefined;
+  }
+
+  if (isZero(possibleNumber)) {
+    return undefined;
+  }
+
+  return possibleNumber;
+};
+
 export const toPositiveNumberWithDefault = (
   defaultValue: number,
   value: unknown

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@applicaster/zapp-react-native-utils",
-  "version": "15.0.0-rc.14",
+  "version": "15.0.0-rc.141",
   "description": "Applicaster Zapp React Native utilities package",
   "main": "index.js",
   "types": "index.d.ts",
@@ -27,13 +27,13 @@
   },
   "homepage": "https://github.com/applicaster/quickbrick#readme",
   "dependencies": {
-    "@applicaster/applicaster-types": "15.0.0-rc.14",
+    "@applicaster/applicaster-types": "15.0.0-rc.141",
     "buffer": "^5.2.1",
     "camelize": "^1.0.0",
     "dayjs": "^1.11.10",
+    "handlebars": "4.7.9",
     "memoizee": "0.4.15",
-    "prop-types": "^15.0.0",
-    "react-native-handlebars": "^5.0.0-alpha.1"
+    "prop-types": "^15.0.0"
   },
   "peerDependencies": {
     "@applicaster/zapp-pipes-v2-client": "*",

package/playerUtils/usePlayerTTS.ts

@@ -1,14 +1,19 @@
 import * as React from "react";
 import { usePlayer } from "@applicaster/zapp-react-native-utils/appUtils/playerManager/usePlayer";
-import { useAccessibilityManager } from "@applicaster/zapp-react-native-utils/appUtils/accessibilityManager/hooks";
+import {
+  useAccessibilityManager,
+  useAccessibilityState,
+} from "@applicaster/zapp-react-native-utils/appUtils/accessibilityManager/hooks";
 import { PlayerTTS } from "@applicaster/zapp-react-native-utils/playerUtils/PlayerTTS";
 
 export const usePlayerTTS = () => {
   const player = usePlayer();
   const accessibilityManager = useAccessibilityManager({});
+  const accessibilityState = useAccessibilityState();
+  const isScreenReaderEnabled = accessibilityState.screenReaderEnabled;
 
   React.useEffect(() => {
-    if (player && accessibilityManager) {
+    if (player && accessibilityManager && isScreenReaderEnabled) {
       const playerTTS = new PlayerTTS(player, accessibilityManager);
       const unsubscribe = playerTTS.init();
 
@@ -17,5 +22,5 @@ export const usePlayerTTS = () => {
         playerTTS.destroy();
       };
     }
-  }, [player, accessibilityManager]);
+  }, [player, accessibilityManager, isScreenReaderEnabled]);
 };

package/pluginUtils/index.ts

@@ -6,6 +6,7 @@ import { deprecationMessage } from "../appUtils";
 
 import { pluginUtilsLogger } from "./logger";
 import { platformSelect } from "../reactUtils";
+import { get } from "../utils";
 
 type PluginModule = any;
 type Plugin = {
@@ -254,3 +255,6 @@ const getPluginType = R.pathOr("unknown_plugin_type", [
 
 export const isPlayerPlugin = (routeState): boolean =>
   getPluginType(routeState) === "player";
+
+export const getPluginModuleUrlScheme = (plugin) =>
+  get(plugin, ["module", "urlScheme"]);

package/reactHooks/advertising/index.ts

@@ -3,7 +3,7 @@ import { View } from "react-native";
 import * as R from "ramda";
 
 import { useNavigation } from "../navigation";
-import { usePickFromState } from "@applicaster/zapp-react-native-redux/hooks";
+import { usePlugins } from "@applicaster/zapp-react-native-redux/hooks";
 import { platformSelect } from "@applicaster/zapp-react-native-utils/reactUtils";
 import { dismissModal, openModal } from "../../modalState";
 
@@ -16,7 +16,7 @@ const ModalContainer = platformSelect({
 
 export function useAdvertisingInterstitial() {
   const { screenData, currentRoute } = useNavigation();
-  const { plugins } = usePickFromState();
+  const plugins = usePlugins();
 
   return useEffect(() => {
     // TODD: typing problem: fix any type