@applicaster/zapp-react-native-utils 15.1.6-alpha.2015591222 → 15.1.6

package/actionsExecutor/actions/__tests__/dismissBottomSheet.test.ts

@@ -1,22 +0,0 @@
-import { dismissBottomSheetAction } from "../dismissBottomSheet";
-import { dismissModal } from "../../../modalState";
-import { ActionResult } from "../../ActionExecutor";
-
-jest.mock("../../../modalState", () => ({
-  dismissModal: jest.fn(),
-}));
-
-describe("dismissBottomSheetAction", () => {
-  beforeEach(() => {
-    jest.clearAllMocks();
-  });
-
-  it("calls dismissModal and returns ActionResult.Success", async () => {
-    const result = await dismissBottomSheetAction({
-      type: "dismissBottomSheet",
-    });
-
-    expect(dismissModal).toHaveBeenCalledTimes(1);
-    expect(result).toBe(ActionResult.Success);
-  });
-});

package/actionsExecutor/actions/__tests__/loadItemsFromSource.test.ts

@@ -1,88 +0,0 @@
-import { loadItemsFromSource } from "../openBottomSheet";
-
-const mockCall = jest.fn();
-
-jest.mock("@applicaster/zapp-pipes-v2-client", () => ({
-  RequestBuilder: jest.fn().mockImplementation(() => ({
-    setEntryContext: jest.fn().mockReturnThis(),
-    setScreenContext: jest.fn().mockReturnThis(),
-    setUrl: jest.fn().mockReturnThis(),
-    buildAxiosRequest: jest.fn().mockResolvedValue(undefined),
-    call: (...args: any[]) => mockCall(...args),
-  })),
-  PipesClientResponseHelper: jest.fn().mockImplementation(() => ({
-    error: null,
-  })),
-}));
-
-describe("loadItemsFromSource", () => {
-  beforeEach(() => {
-    jest.clearAllMocks();
-  });
-
-  it("returns items plus role and behavior from feed.extensions", async () => {
-    mockCall.mockResolvedValueOnce({
-      response: {
-        entry: [{ id: "a", title: "Playlist A", media_group: [] }],
-        extensions: {
-          role: "collection_selector",
-          behavior: {
-            select_mode: "multi",
-            current_selection: ["a"],
-            selector: "extensions.tag",
-          },
-        },
-      },
-    });
-
-    const result = await loadItemsFromSource("https://example.com/feed");
-
-    expect(result.role).toBe("collection_selector");
-
-    expect(result.behavior).toEqual({
-      selectMode: "multi",
-      currentSelection: ["a"],
-      selector: "extensions.tag",
-    });
-
-    expect(result.items).toHaveLength(1);
-    expect(result.items[0].isSelected).toBe(true);
-    expect(result.items[0].title).toBe("Playlist A");
-  });
-
-  it("returns undefined role/behavior when feed has no extensions", async () => {
-    mockCall.mockResolvedValueOnce({
-      response: {
-        entry: [{ id: "1", title: "Plain", media_group: [] }],
-      },
-    });
-
-    const result = await loadItemsFromSource("https://example.com/plain");
-
-    expect(result.role).toBeUndefined();
-    expect(result.behavior).toBeUndefined();
-    expect(result.items).toHaveLength(1);
-  });
-
-  it("preserves events in dynamic_collection_options", async () => {
-    mockCall.mockResolvedValueOnce({
-      response: {
-        entry: [],
-        extensions: {
-          dynamic_collection_options: {
-            operations: "add,remove",
-            events: {
-              add: [{ type: "showTextInput", options: {} }],
-            },
-          },
-        },
-      },
-    });
-
-    const result = await loadItemsFromSource("https://example.com/feed");
-
-    expect(result.dynamicCollection?.events).toEqual({
-      add: [{ type: "showTextInput", options: {} }],
-    });
-  });
-});

package/actionsExecutor/actions/__tests__/openBottomSheet.customContent.test.ts

@@ -1,76 +0,0 @@
-import { openBottomSheetAction } from "../openBottomSheet";
-import { ActionResult } from "../../ActionExecutor";
-import { openBottomSheetModal } from "../../../modalState/store";
-import { modalOrchestrator } from "../../../modalState/ModalOrchestrator";
-
-jest.mock("../../../modalState/store", () => ({
-  openBottomSheetModal: jest.fn(),
-}));
-
-jest.mock("../../../modalState/ModalOrchestrator", () => ({
-  modalOrchestrator: {
-    open: jest.fn(),
-  },
-  isPresentSubMenuAction: jest.requireActual("../../../modalState/types")
-    .isPresentSubMenuAction,
-}));
-
-describe("openBottomSheetAction custom content", () => {
-  beforeEach(() => {
-    jest.clearAllMocks();
-  });
-
-  it("opens default sheet with contentComponent body props", async () => {
-    const CustomContent = function CustomContent() {
-      return null;
-    };
-
-    const result = await openBottomSheetAction({
-      type: "openBottomSheet",
-      options: {
-        header: { title: "Create Playlist" },
-        content: {
-          component: CustomContent,
-          props: {
-            inputLabel: "Name your playlist",
-            buttonLabel: "Create",
-            defaultValue: "",
-            submitAction: { type: "sendCloudEvent", options: {} },
-          },
-        },
-      },
-    } as any);
-
-    expect(result).toBe(ActionResult.Success);
-    expect(openBottomSheetModal).toHaveBeenCalledTimes(1);
-    expect(modalOrchestrator.open).not.toHaveBeenCalled();
-
-    const args = (openBottomSheetModal as jest.Mock).mock.calls[0][0];
-    // Default ModalComponent provides the standard header
-    expect(args.ModalBottomSheetContent).toBeUndefined();
-
-    expect(args.modalBottomSheetContentProps).toMatchObject({
-      title: "Create Playlist",
-      contentComponent: CustomContent,
-      contentComponentProps: {
-        inputLabel: "Name your playlist",
-        buttonLabel: "Create",
-        defaultValue: "",
-      },
-    });
-  });
-
-  it("returns Error when neither list data nor content.component is provided", async () => {
-    const result = await openBottomSheetAction({
-      type: "openBottomSheet",
-      options: {
-        header: { title: "Empty" },
-        content: {},
-      },
-    } as any);
-
-    expect(result).toBe(ActionResult.Error);
-    expect(openBottomSheetModal).not.toHaveBeenCalled();
-    expect(modalOrchestrator.open).not.toHaveBeenCalled();
-  });
-});

package/actionsExecutor/actions/dismissBottomSheet.ts

@@ -1,22 +0,0 @@
-/// <reference types="@applicaster/applicaster-types" />
-import { dismissModal } from "../../modalState";
-import { ActionResult } from "../ActionExecutor";
-import { ActionHandler } from "../types";
-import { createLogger } from "../../logger";
-
-const { log_info } = createLogger({
-  subsystem: "ActionExecutorContext",
-  category: "General",
-});
-
-/**
- * Dismisses the active bottom sheet / modal.
- */
-export const dismissBottomSheetAction: ActionHandler<
-  any
-> = async (): Promise<ActionResult> => {
-  log_info("handleAction: dismissBottomSheet");
-  dismissModal();
-
-  return ActionResult.Success;
-};

package/actionsExecutor/actions/openBottomSheet.ts

@@ -1,318 +0,0 @@
-/// <reference types="@applicaster/applicaster-types" />
-import {
-  PipesClientResponseHelper,
-  RequestBuilder,
-} from "@applicaster/zapp-pipes-v2-client";
-import { modalOrchestrator } from "../../modalState/ModalOrchestrator";
-import { openBottomSheetModal } from "../../modalState/store";
-import {
-  DynamicCollectionOptions,
-  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;
-
-  let summary = entry.summary as string;
-
-  // TODO: remove just a small logic for debugging
-
-  if (
-    !summary &&
-    entry.extensions &&
-    typeof entry.extensions.item_count === "number"
-  ) {
-    const count = entry.extensions.item_count;
-    summary = `${count} ${count === 1 ? "Item" : "Items"}`;
-  }
-
-  return {
-    id: entry.id as string,
-    title: entry.title as string,
-    summary,
-    icon: firstImage?.src,
-    isSelected: currentSelection.includes(String(entry.id)),
-    action: primaryAction,
-    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 } = 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,
-      });
-
-      items = inlineItems.map((entry) => entryToMenuItem(entry));
-      role = content?.role ?? content?.extensions?.role;
-      behavior = parseBehaviorFromContentOptions(content);
-
-      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,
-      },
-    };
-
-    /**
-     * 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> => {
-      if (!item.action || isPresentSubMenuAction(item.action)) {
-        // Submenu navigation is handled internally by the orchestrator
-        return;
-      }
-
-      await actionExecutor.handleAction(
-        item.action as ActionType,
-        {
-          ...context,
-          entry: item as any,
-        } as any
-      );
-    };
-
-    modalOrchestrator.open(menu, onItemPress);
-
-    return ActionResult.Success;
-  } catch (error) {
-    log_error("openBottomSheet: failed to open bottom sheet", {
-      error,
-      action,
-    });
-
-    return ActionResult.Error;
-  }
-}

package/modalState/ContentViewModel.ts

@@ -1,111 +0,0 @@
-import { BehaviorSubject, Observable } from "rxjs";
-import {
-  Content,
-  MenuItem,
-  SelectionBehavior,
-  DynamicCollectionOptions,
-} from "./types";
-import { loadItemsFromSource } from "../actionsExecutor/actions/openBottomSheet";
-import { resolveEditableCollection } from "./EditableCollectionRegistry";
-import { EditableCollection } from "./EditableCollection";
-
-export interface ContentState {
-  items: MenuItem[];
-  isLoading: boolean;
-  error?: Error | string;
-  role?: string;
-  behavior?: SelectionBehavior;
-  dynamicCollection?: DynamicCollectionOptions;
-}
-
-export class ContentViewModel {
-  private state$: BehaviorSubject<ContentState>;
-  readonly itemsUrl?: string;
-  public editableCollection: EditableCollection | null = null;
-  private content: Content;
-
-  constructor(content: Content) {
-    this.content = content;
-    this.itemsUrl = content.itemsUrl;
-
-    this.state$ = new BehaviorSubject<ContentState>({
-      items: content.items || [],
-      isLoading: false,
-      role: content.role,
-      behavior: content.behavior,
-      dynamicCollection: content.dynamicCollection,
-    });
-
-    this.initEditableCollection(content);
-
-    if (this.itemsUrl && this.state$.value.items.length === 0) {
-      this.refetch();
-    }
-  }
-
-  private initEditableCollection(content: Content) {
-    this.editableCollection = resolveEditableCollection(content, this.refetch);
-  }
-
-  getState = (): ContentState => this.state$.value;
-
-  get stateObservable(): Observable<ContentState> {
-    return this.state$.asObservable();
-  }
-
-  subscribe = (listener: (state: ContentState) => void) => {
-    const subscription = this.state$.subscribe(listener);
-
-    return () => subscription.unsubscribe();
-  };
-
-  private updateState(partialState: Partial<ContentState>) {
-    this.state$.next({ ...this.state$.value, ...partialState });
-  }
-
-  refetch = async () => {
-    if (!this.itemsUrl) return;
-
-    this.updateState({ isLoading: true, error: undefined });
-
-    try {
-      const separator = this.itemsUrl.includes("?") ? "&" : "?";
-      const cacheBustedUrl = `${this.itemsUrl}${separator}_t=${Date.now()}`;
-
-      const { items, role, behavior, dynamicCollection } =
-        await loadItemsFromSource(cacheBustedUrl);
-
-      this.content = {
-        ...this.content,
-        items,
-        role,
-        behavior,
-        dynamicCollection,
-      };
-
-      this.updateState({
-        items,
-        role,
-        behavior,
-        dynamicCollection,
-        isLoading: false,
-      });
-
-      if (this.editableCollection) {
-        // Reuse the existing collection instance. Pushing the freshly loaded
-        // server items replaces any optimistic local state with the
-        // authoritative result (and rolls forward a successful mutation).
-        this.editableCollection.sync?.(items);
-      } else {
-        // The collection may only become resolvable once options arrive from
-        // the feed (e.g. inline content had none). Create it lazily here.
-        this.initEditableCollection(this.content);
-      }
-    } catch (err) {
-      this.updateState({
-        error: err?.message || "Failed to load",
-        isLoading: false,
-      });
-    }
-  };
-}

package/modalState/EditableCollection.ts

@@ -1,17 +0,0 @@
-import { Observable } from "rxjs";
-import { MenuItem, Operation } from "./types";
-
-export interface EditableCollection {
-  items$: Observable<MenuItem[]>;
-  operations: Operation[];
-  add?(item?: MenuItem): void | Promise<void>;
-  remove?(index: number): void | Promise<void>;
-  move?(itemIds: string[]): void | Promise<void>;
-  deleteCollection?(): void | Promise<void>;
-  /**
-   * Push authoritative items (e.g. a fresh server feed after a mutation) into
-   * the collection, replacing any optimistic local state. Called by the
-   * ContentViewModel on refetch so the instance is reused instead of recreated.
-   */
-  sync?(items: MenuItem[]): void;
-}

package/modalState/EditableCollectionRegistry.ts

@@ -1,51 +0,0 @@
-import { Content } from "./types";
-import { EditableCollection } from "./EditableCollection";
-import { RemoteEditableCollection } from "./RemoteEditableCollection";
-import { createLogger } from "../logger";
-
-const { log_error } = createLogger({
-  subsystem: "modalState",
-  category: "EditableCollectionRegistry",
-});
-
-type ProviderFactory = () => EditableCollection;
-
-export class EditableCollectionRegistry {
-  private static providers: Record<string, ProviderFactory> = {};
-
-  static register(token: string, factory: ProviderFactory) {
-    this.providers[token] = factory;
-  }
-
-  static getProvider(token: string): EditableCollection | null {
-    const factory = this.providers[token];
-
-    return factory ? factory() : null;
-  }
-}
-
-export function resolveEditableCollection(
-  content: Content,
-  refetch: () => Promise<void>
-): EditableCollection | null {
-  const options = content.dynamicCollection;
-  if (!options) return null;
-
-  if (options.provider) {
-    const provider = EditableCollectionRegistry.getProvider(options.provider);
-
-    if (!provider) {
-      log_error(
-        `No EditableCollection provider registered for token "${options.provider}"`
-      );
-    }
-
-    return provider;
-  }
-
-  if (options.postUrl) {
-    return new RemoteEditableCollection(content, refetch);
-  }
-
-  return null;
-}