@applicaster/zapp-react-native-utils 15.1.13-alpha.1034774223 → 15.1.13

package/actionsExecutor/actions/openBottomSheet.ts

@@ -1,325 +0,0 @@
-/// <reference types="@applicaster/applicaster-types" />
-import {
-  PipesClientResponseHelper,
-  RequestBuilder,
-} from "@applicaster/zapp-pipes-v2-client";
-import uuidv4 from "uuid/v4";
-import { modalOrchestrator } from "../../modalState/ModalOrchestrator";
-import { openBottomSheetModal } from "../../modalState/store";
-import {
-  DynamicCollectionOptions,
-  getMenuItemActions,
-  isPresentSubMenuAction,
-  Menu,
-  MenuItem,
-  Operation,
-  SelectionBehavior,
-} from "../../modalState/types";
-import { actionExecutor, ActionResult } from "../ActionExecutor";
-import { createLogger } from "../../logger";
-
-const { log_info, log_error } = createLogger({
-  subsystem: "ActionExecutorContext",
-  category: "General",
-});
-
-export type LoadedSheetContent = {
-  items: MenuItem[];
-  role?: string;
-  behavior?: SelectionBehavior;
-  dynamicCollection?: DynamicCollectionOptions;
-};
-
-/**
- * Parse a raw `dynamic_collection_options` block (feed or inline content) into
- * the typed `DynamicCollectionOptions`. `operations` accepts either a CSV
- * string (feed) or an array (already parsed).
- */
-export function parseDynamicCollectionOptions(
-  raw:
-    | {
-        operations?: string | string[];
-        postUrl?: string;
-        provider?: string;
-        events?: Record<string, any[]>;
-      }
-    | undefined
-): DynamicCollectionOptions | undefined {
-  if (!raw) {
-    return undefined;
-  }
-
-  const operations = Array.isArray(raw.operations)
-    ? (raw.operations as Operation[])
-    : ((raw.operations || "").split(",").filter(Boolean) as Operation[]);
-
-  return {
-    operations,
-    postUrl: raw.postUrl,
-    provider: raw.provider,
-    events: raw.events,
-  };
-}
-
-/**
- * Converts a ZappEntry from a pipes feed into a MenuItem.
- * - Icon: first src found in the image media_group.
- * - Primary action: taken from tap_actions.actions[0].
- * - isSelected: true when entry.id is in currentSelection.
- */
-export function entryToMenuItem(
-  entry: ZappEntry,
-  currentSelection: string[] = []
-): MenuItem {
-  const imageGroup = entry.media_group?.find((g) => g.type === "image");
-
-  const firstImage = Array.isArray(imageGroup?.media_item)
-    ? imageGroup.media_item[0]
-    : imageGroup?.media_item;
-
-  // Primary action — first tap_action on the entry
-  const tapActions = entry.extensions?.tap_actions?.actions || [];
-  const primaryAction = tapActions.length > 0 ? tapActions[0] : undefined;
-
-  const summary = entry.summary as string;
-
-  const itemId = String(entry.id ?? entry.title ?? uuidv4());
-
-  return {
-    id: itemId,
-    title: entry.title as string,
-    summary,
-    icon: firstImage?.src,
-    isSelected: currentSelection.includes(itemId),
-    action: primaryAction,
-    actions: tapActions,
-    entryActions: entry.extensions?.entry_action || [],
-  };
-}
-
-function parseCurrentSelection(rawSelection: unknown): string[] {
-  if (Array.isArray(rawSelection)) {
-    return (rawSelection as any[]).map(String);
-  }
-
-  if (rawSelection !== undefined && rawSelection !== null) {
-    return [String(rawSelection)];
-  }
-
-  return [];
-}
-
-function parseBehaviorFromFeed(
-  feed: ZappFeed | undefined,
-  currentSelection: string[]
-): SelectionBehavior | undefined {
-  const raw = feed?.extensions?.behavior;
-
-  if (!raw && currentSelection.length === 0) {
-    return undefined;
-  }
-
-  return {
-    selectMode: raw?.select_mode,
-    currentSelection,
-    selector: raw?.selector,
-  };
-}
-
-function parseBehaviorFromContentOptions(
-  content: Record<string, any> | undefined
-): SelectionBehavior | undefined {
-  const raw = content?.behavior ?? content?.extensions?.behavior;
-
-  if (!raw) {
-    return undefined;
-  }
-
-  return {
-    selectMode: raw.selectMode ?? raw.select_mode,
-    currentSelection: parseCurrentSelection(
-      raw.currentSelection ?? raw.current_selection
-    ),
-    selector: raw.selector,
-  };
-}
-
-// Exported so MultiLevelBottomSheetContent can lazy-load sub-levels
-export async function loadItemsFromSource(
-  source: string,
-  context?: Record<string, any>
-): Promise<LoadedSheetContent> {
-  const requestBuilder = new RequestBuilder()
-    .setEntryContext(context?.entry || {})
-    .setScreenContext(context?.screenData || {})
-    .setUrl(source);
-
-  await requestBuilder.buildAxiosRequest();
-
-  const responseData = await requestBuilder.call<ZappFeed>();
-
-  const responseHelper = new PipesClientResponseHelper(responseData);
-
-  if (responseHelper.error) {
-    throw responseHelper.error;
-  }
-
-  const feed = responseData?.response as ZappFeed;
-
-  const currentSelection = parseCurrentSelection(
-    feed?.extensions?.behavior?.current_selection
-  );
-
-  const items = (feed?.entry || []).map((entry) =>
-    entryToMenuItem(entry, currentSelection)
-  );
-
-  const dynamicCollectionOptions = feed?.extensions?.dynamic_collection_options;
-
-  const dynamicCollection = parseDynamicCollectionOptions(
-    dynamicCollectionOptions
-  );
-
-  return {
-    items,
-    role: feed?.extensions?.role,
-    behavior: parseBehaviorFromFeed(feed, currentSelection),
-    dynamicCollection,
-  };
-}
-
-export async function openBottomSheetAction(
-  action: ActionType,
-  context?: Record<string, any>
-): Promise<ActionResult> {
-  try {
-    const { content, header, themePluginId, styleOverrides } =
-      action.options || {};
-
-    // Custom body component — keep default ModalComponent so standard header
-    // (dismiss x) is used; content.component is body-only (e.g. TextInputContent).
-    if (content?.component) {
-      log_info("openBottomSheet: using custom content component");
-
-      openBottomSheetModal({
-        modalBottomSheetContentProps: {
-          title: header?.title,
-          summary: header?.subtitle,
-          items: [],
-          onPress: () => {},
-          contentComponent: content.component,
-          contentComponentProps: content.props || {},
-        },
-      });
-
-      return ActionResult.Success;
-    }
-
-    const inlineItems: ZappEntry[] = content?.items;
-    const itemsUrl: string = content?.itemsUrl;
-
-    let items: MenuItem[];
-    let role: string | undefined;
-    let behavior: SelectionBehavior | undefined;
-
-    let dynamicCollection: DynamicCollectionOptions | undefined;
-
-    if (Array.isArray(inlineItems) && inlineItems.length > 0) {
-      log_info("openBottomSheet: using inline items from action options", {
-        count: inlineItems.length,
-      });
-
-      role = content?.role ?? content?.extensions?.role;
-      behavior = parseBehaviorFromContentOptions(content);
-
-      items = inlineItems.map((entry) =>
-        entryToMenuItem(entry, behavior?.currentSelection ?? [])
-      );
-
-      dynamicCollection = parseDynamicCollectionOptions(
-        content?.dynamicCollection ??
-          content?.extensions?.dynamic_collection_options
-      );
-    } else if (itemsUrl) {
-      log_info(`openBottomSheet: loading items from source: ${itemsUrl}`);
-
-      const loaded = await loadItemsFromSource(itemsUrl, context);
-      items = loaded.items;
-      role = loaded.role ?? content?.role ?? content?.extensions?.role;
-      behavior = loaded.behavior ?? parseBehaviorFromContentOptions(content);
-      dynamicCollection = loaded.dynamicCollection;
-
-      log_info(
-        `openBottomSheet: loaded ${items.length} items from source: ${itemsUrl}`
-      );
-    } else {
-      log_error(
-        "openBottomSheet: no itemsUrl, items, or content.component provided in action options"
-      );
-
-      return ActionResult.Error;
-    }
-
-    const menu: Menu = {
-      header: header
-        ? {
-            title: header.title,
-            subtitle: header.subtitle,
-            icon: header.icon,
-          }
-        : undefined,
-      content: {
-        title: content?.title ?? "",
-        items,
-        itemsUrl, // stored so the component can reload after an action
-        role,
-        behavior,
-        dynamicCollection,
-        themePluginId,
-        styleOverrides: styleOverrides ?? content?.styleOverrides,
-      },
-    };
-
-    /**
-     * Called when the user taps a menu item.
-     *
-     * - PresentSubMenuAction  → handled by the orchestrator (pushes sub-menu)
-     * - Any other Action type → forwarded to the action executor, keeping the
-     *   original execution context so screen/entry data is available to handlers.
-     *   The pressed item is also added as `entry` so downstream actions can
-     *   reference it.
-     */
-    const onItemPress = async (item: MenuItem): Promise<void> => {
-      const actions = getMenuItemActions(item);
-
-      const executableActions = actions.filter(
-        (action) => !isPresentSubMenuAction(action)
-      );
-
-      if (executableActions.length > 0) {
-        await actionExecutor.handleActions(
-          executableActions as ActionType[],
-          {
-            ...context,
-            entry: item as any,
-          } as any
-        );
-      }
-    };
-
-    if (action.options?.replace) {
-      modalOrchestrator.replace(menu, onItemPress);
-    } else {
-      modalOrchestrator.open(menu, onItemPress);
-    }
-
-    return ActionResult.Success;
-  } catch (error) {
-    log_error("openBottomSheet: failed to open bottom sheet", {
-      error,
-      action,
-    });
-
-    return ActionResult.Error;
-  }
-}

package/appUtils/playerManager/OverlayObserver/getUpcomingQueue.android.tv.ts

@@ -1,4 +0,0 @@
-/** `queue-action` is not supported on this platform. See getUpcomingQueue.ts */
-export const getUpcomingQueue = async (
-  _plugin?: QuickBrickPlugin | ZappPlugin
-): Promise<unknown[] | null> => null;

package/appUtils/playerManager/OverlayObserver/getUpcomingQueue.ios.tv.ts

@@ -1,4 +0,0 @@
-/** `queue-action` is not supported on this platform. See getUpcomingQueue.ts */
-export const getUpcomingQueue = async (
-  _plugin?: QuickBrickPlugin | ZappPlugin
-): Promise<unknown[] | null> => null;

package/appUtils/playerManager/OverlayObserver/getUpcomingQueue.ts

@@ -1,11 +0,0 @@
-export const getUpcomingQueue = async (
-  plugin?: QuickBrickPlugin | ZappPlugin
-): Promise<unknown[] | null> => {
-  const QueueManager = (plugin as any)?.module?.QueueManager;
-
-  if (!QueueManager?.instance) {
-    return null;
-  }
-
-  return QueueManager.instance.getUpcomingQueue();
-};

package/appUtils/playerManager/OverlayObserver/getUpcomingQueue.web.ts

@@ -1,4 +0,0 @@
-/** `queue-action` is not supported on this platform. See getUpcomingQueue.ts */
-export const getUpcomingQueue = async (
-  _plugin?: QuickBrickPlugin | ZappPlugin
-): Promise<unknown[] | null> => null;

package/arrayUtils/__tests__/reorderByIds.test.ts

@@ -1,50 +0,0 @@
-import { reorderByIds } from "../index";
-
-describe("reorderByIds", () => {
-  const items = [
-    { id: "1", title: "Track 1" },
-    { id: "2", title: "Track 2" },
-    { id: "3", title: "Track 3" },
-    { id: "4", title: "Track 4" },
-  ];
-
-  it("returns an empty array if items is empty or nullish", () => {
-    expect(reorderByIds([], ["1"])).toEqual([]);
-    expect(reorderByIds(null as any, ["1"])).toEqual([]);
-  });
-
-  it("returns a copy of items if orderedIds is empty or nullish", () => {
-    expect(reorderByIds(items, [])).toEqual(items);
-    expect(reorderByIds(items, null as any)).toEqual(items);
-  });
-
-  it("reorders items based on the provided orderedIds sequence", () => {
-    const result = reorderByIds(items, ["3", "1", "4", "2"]);
-
-    expect(result.map((i) => i.id)).toEqual(["3", "1", "4", "2"]);
-  });
-
-  it("replaces items in their original slots when reordering a subset", () => {
-    const result = reorderByIds(items, ["4", "2"]);
-
-    expect(result.map((i) => i.id)).toEqual(["1", "4", "3", "2"]);
-  });
-
-  it("ignores IDs in orderedIds that do not exist in items", () => {
-    const result = reorderByIds(items, ["unknown", "3", "99", "1"]);
-
-    expect(result.map((i) => i.id)).toEqual(["3", "2", "1", "4"]);
-  });
-
-  it("supports custom getId selector function", () => {
-    const customItems = [
-      { key: "a", name: "Alpha" },
-      { key: "b", name: "Beta" },
-      { key: "c", name: "Gamma" },
-    ];
-
-    const result = reorderByIds(customItems, ["c", "a"], (item) => item.key);
-
-    expect(result.map((i) => i.key)).toEqual(["c", "b", "a"]);
-  });
-});

package/configurationUtils/__tests__/modalBlocksParser.test.ts

@@ -1,260 +0,0 @@
-import { parseModalBlocksConfiguration } from "../modalBlocksParser";
-
-// Mock the platform selection logic so it's consistent
-jest.mock("../../reactUtils", () => ({
-  platformSelect: jest.fn().mockReturnValue("ios"),
-}));
-
-describe("parseModalBlocksConfiguration", () => {
-  beforeEach(() => {
-    jest.clearAllMocks();
-  });
-
-  it("should return empty structures for missing config or componentName", () => {
-    const result1 = parseModalBlocksConfiguration(
-      undefined as any,
-      "queue_action"
-    );
-
-    expect(result1.header.container).toEqual({});
-
-    const result2 = parseModalBlocksConfiguration({ foo: "bar" }, "");
-    expect(result2.item.background).toEqual({});
-  });
-
-  it("should correctly parse the specified flat keys into nested objects", () => {
-    // The keys follow: <component_name>_style_<blockName>_<subComponent>_[platform_][state_]<styleName>
-    const config = {
-      // Header container - default platform, default state
-      queue_action_style_header_container_backgroundColor: "#000000",
-
-      // Header title - default platform, pressed state
-      queue_action_style_header_title_pressed_fontColor: "#ffffff",
-
-      // Item background - ios platform, default state
-      queue_action_style_item_background_ios_backgroundColor: "blue",
-
-      // Item textLabel1 - default platform, focused state
-      queue_action_style_item_text_label_1_focused_fontSize: 16,
-
-      // Ignored key (unrelated to building blocks or queue_action)
-      other_action_style_header_title_fontColor: "red",
-      some_random_key: "value",
-
-      // Ignored non-style data keys (should NEVER be parsed as styles)
-      item_data_source: "http://pipes.example.com",
-      item_url: "http://example.com",
-
-      // New dot notation from manifest-generator (without plugin prefix)
-      "item.text_label_2.fontColor": "green",
-      "action.background.pressed_backgroundColor": "black",
-
-      // New now_playing_item block
-      "now_playing_item.text_label_1.fontColor": "yellow",
-      "now_playing_item.now_playing_asset.asset": "equalizer.png",
-    };
-
-    const componentName = "queue_action";
-
-    const result = parseModalBlocksConfiguration(config, componentName);
-
-    // Assert header container default state
-    expect(result.header.container.default).toEqual({
-      backgroundColor: "#000000",
-    });
-
-    // Assert header title pressed state
-    // (pressed state will inherit default styles in getAllSpecificStyles if any,
-    // but here we just have pressed, so it has default empty from the parser)
-    expect(result.header.title.pressed).toEqual({
-      fontColor: "#ffffff",
-    });
-
-    // Assert item background ios default state
-    // (mocked platform is ios, so it should be accepted and assigned to default)
-    expect(result.item.background.default).toEqual({
-      backgroundColor: "blue",
-    });
-
-    // Assert item textLabel1 focused state
-    expect(result.item.textLabel1.focused).toEqual({
-      fontSize: 16,
-    });
-
-    // Assert dot notation textLabel2 default state
-    expect(result.item.textLabel2.default).toEqual({
-      fontColor: "green",
-    });
-
-    // Assert dot notation action background pressed state
-    expect(result.action.background.pressed).toEqual({
-      backgroundColor: "black",
-    });
-
-    // Assert nowPlayingItem states
-    expect(result.nowPlayingItem?.textLabel1.default).toEqual({
-      fontColor: "yellow",
-    });
-
-    expect(result.nowPlayingItem?.nowPlayingAsset.default).toEqual({
-      asset: "equalizer.png",
-    });
-
-    // Assert untouched properties remain empty default style objects
-    expect(result.button.title).toEqual({ default: {} });
-    expect(result.action.leadingIcon).toEqual({ default: {} });
-  });
-
-  it("should map Studio item.background.focus.* onto focused state", () => {
-    const result = parseModalBlocksConfiguration(
-      {
-        "item.background.default.background_color": "transparent",
-        "item.background.focus.background_color": "#FF3B30",
-      },
-      "playlist-experience"
-    );
-
-    expect(result.item.background.default).toEqual(
-      expect.objectContaining({
-        backgroundColor: "transparent",
-      })
-    );
-
-    expect(result.item.background.focused).toEqual(
-      expect.objectContaining({
-        backgroundColor: "#FF3B30",
-      })
-    );
-  });
-
-  it("should accept Studio text_label1 keys without underscore before digit", () => {
-    const result = parseModalBlocksConfiguration(
-      {
-        "item.text_label1.font_color": "#00FF00",
-        "item.text_label1.font_size": 28,
-        "item.text_label2.font_color": "#00FFFF",
-      },
-      "playlist-experience"
-    );
-
-    expect(result.item.textLabel1.default).toEqual(
-      expect.objectContaining({
-        fontColor: "#00FF00",
-        fontSize: 28,
-      })
-    );
-
-    expect(result.item.textLabel2.default).toEqual(
-      expect.objectContaining({
-        fontColor: "#00FFFF",
-      })
-    );
-  });
-
-  it("should map button.create_new_playlist_asset onto leadingIcon.asset", () => {
-    const result = parseModalBlocksConfiguration(
-      {
-        "button.create_new_playlist_asset":
-          "https://placehold.co/24x24/FF00FF/FFFFFF/png?text=CN",
-      },
-      "playlist-experience"
-    );
-
-    expect(result.button.leadingIcon.default).toEqual(
-      expect.objectContaining({
-        asset: "https://placehold.co/24x24/FF00FF/FFFFFF/png?text=CN",
-      })
-    );
-  });
-
-  it("should map item.checkbox_asset and checked_checkbox_asset onto item.checkbox", () => {
-    const result = parseModalBlocksConfiguration(
-      {
-        "item.checkbox_asset":
-          "https://placehold.co/24x24/FF3B30/FFFFFF/png?text=CB",
-        "item.checked_checkbox_asset":
-          "https://placehold.co/24x24/FFD60A/000000/png?text=CK",
-      },
-      "playlist-experience"
-    );
-
-    expect(result.item.checkbox.default).toEqual(
-      expect.objectContaining({
-        asset: "https://placehold.co/24x24/FF3B30/FFFFFF/png?text=CB",
-        checkedAsset: "https://placehold.co/24x24/FFD60A/000000/png?text=CK",
-      })
-    );
-  });
-
-  it("should map reorder/remove Studio assets onto item.actionButtons", () => {
-    const result = parseModalBlocksConfiguration(
-      {
-        "reorder_playlist_item.remove_from_playlist_asset":
-          "https://placehold.co/24x24/00FF00/000000/png?text=RM",
-        "reorder_playlist_item.reorder_handle_asset":
-          "https://placehold.co/24x24/FF3B30/FFFFFF/png?text=RH",
-      },
-      "playlist-experience"
-    );
-
-    expect(result.item.actionButtons.default).toEqual(
-      expect.objectContaining({
-        removeAsset: "https://placehold.co/24x24/00FF00/000000/png?text=RM",
-        dragAsset: "https://placehold.co/24x24/FF3B30/FFFFFF/png?text=RH",
-      })
-    );
-  });
-
-  it("should fall back to flavor1 reorder/remove assets", () => {
-    const result = parseModalBlocksConfiguration(
-      {
-        "playlist_experience_assets_flavor1.remove_from_playlist_asset":
-          "https://placehold.co/24x24/00FF00/000000/png?text=RM",
-        "playlist_experience_assets_flavor1.reorder_handle_asset":
-          "https://placehold.co/24x24/FF3B30/FFFFFF/png?text=RH",
-      },
-      "playlist-experience"
-    );
-
-    expect(result.item.actionButtons.default).toEqual(
-      expect.objectContaining({
-        removeAsset: "https://placehold.co/24x24/00FF00/000000/png?text=RM",
-        dragAsset: "https://placehold.co/24x24/FF3B30/FFFFFF/png?text=RH",
-      })
-    );
-  });
-
-  it("should fall back to flavor2 reorder/remove assets", () => {
-    const result = parseModalBlocksConfiguration(
-      {
-        "playlist_experience_assets_flavor2.remove_from_playlist_asset":
-          "https://placehold.co/24x24/00FF00/000000/png?text=RM",
-        "playlist_experience_assets_flavor2.reorder_handle_asset":
-          "https://placehold.co/24x24/FF3B30/FFFFFF/png?text=RH",
-      },
-      "playlist-experience"
-    );
-
-    expect(result.item.actionButtons.default).toEqual(
-      expect.objectContaining({
-        removeAsset: "https://placehold.co/24x24/00FF00/000000/png?text=RM",
-        dragAsset: "https://placehold.co/24x24/FF3B30/FFFFFF/png?text=RH",
-      })
-    );
-  });
-
-  it("should ignore playlist-only asset keys for other theme plugins", () => {
-    const result = parseModalBlocksConfiguration(
-      {
-        "button.create_new_playlist_asset":
-          "https://placehold.co/24x24/FF00FF/FFFFFF/png?text=CN",
-        "playlist_experience_assets_flavor1.reorder_handle_asset":
-          "https://placehold.co/24x24/FF3B30/FFFFFF/png?text=RH",
-      },
-      "queue-action"
-    );
-
-    expect(result.button.leadingIcon.default?.asset).toBeUndefined();
-    expect(result.item.actionButtons.default?.dragAsset).toBeUndefined();
-  });
-});