stream-chat-react-native-core 9.4.0-beta.9 → 9.4.1-beta.1

package/src/components/ChannelDetails/__tests__/useFileAttachmentListSections.test.tsx

@@ -0,0 +1,159 @@
+import React, { type PropsWithChildren } from 'react';
+
+import { renderHook } from '@testing-library/react-native';
+
+import type { Attachment, MessageResponse } from 'stream-chat';
+
+import {
+  TranslationProvider,
+  type TranslationContextValue,
+} from '../../../contexts/translationContext/TranslationContext';
+import {
+  generateAudioAttachment,
+  generateFileAttachment,
+  generateImageAttachment,
+} from '../../../mock-builders/generator/attachment';
+import { generateMessage } from '../../../mock-builders/generator/message';
+import { Streami18n } from '../../../utils/i18n/Streami18n';
+import { useFileAttachmentListSections } from '../hooks/useFileAttachmentListSections';
+
+let translators: TranslationContextValue;
+
+beforeAll(async () => {
+  const i18nInstance = new Streami18n();
+  translators = (await i18nInstance.getTranslators()) as unknown as TranslationContextValue;
+});
+
+const wrapper = ({ children }: PropsWithChildren) => (
+  <TranslationProvider value={translators}>{children}</TranslationProvider>
+);
+
+const messageAt = (
+  id: string,
+  createdAt: string,
+  attachments: Attachment[] = [generateFileAttachment()],
+): MessageResponse =>
+  generateMessage({
+    attachments: attachments as never,
+    created_at: new Date(createdAt),
+    id,
+  }) as unknown as MessageResponse;
+
+describe('useFileAttachmentListSections', () => {
+  it('returns an empty array when there are no messages', () => {
+    const { result } = renderHook(() => useFileAttachmentListSections(undefined), { wrapper });
+    expect(result.current).toEqual([]);
+
+    const { result: emptyResult } = renderHook(() => useFileAttachmentListSections([]), {
+      wrapper,
+    });
+    expect(emptyResult.current).toEqual([]);
+  });
+
+  it('gathers only file and audio attachments, skipping images', () => {
+    const message = messageAt('m-1', '2026-03-15T00:00:00.000Z', [
+      generateFileAttachment({ title: 'a-file.pdf' }),
+      generateImageAttachment({ title: 'a-photo.png' }),
+      generateAudioAttachment({ title: 'a-clip.mp3' }),
+    ]);
+
+    const { result } = renderHook(() => useFileAttachmentListSections([message]), { wrapper });
+
+    expect(result.current).toHaveLength(1);
+    expect(result.current[0].data.map((tile) => tile.attachment.title)).toEqual([
+      'a-file.pdf',
+      'a-clip.mp3',
+    ]);
+    expect(result.current[0].data.every((tile) => tile.message === message)).toBe(true);
+  });
+
+  it('skips OG/scraped link-preview attachments', () => {
+    const message = messageAt('m-og', '2026-03-15T00:00:00.000Z', [
+      generateFileAttachment({ title: 'a-file.pdf' }),
+      generateFileAttachment({
+        og_scrape_url: 'https://example.com',
+        title: 'link-preview',
+        title_link: 'https://example.com',
+      }),
+    ]);
+
+    const { result } = renderHook(() => useFileAttachmentListSections([message]), { wrapper });
+
+    expect(result.current[0].data.map((tile) => tile.attachment.title)).toEqual(['a-file.pdf']);
+  });
+
+  it('produces no section for a message without file or audio attachments', () => {
+    const message = messageAt('m-1', '2026-03-15T00:00:00.000Z', [generateImageAttachment()]);
+
+    const { result } = renderHook(() => useFileAttachmentListSections([message]), { wrapper });
+
+    expect(result.current).toEqual([]);
+  });
+
+  it('groups messages into month sections in newest-first order', () => {
+    const february = messageAt('m-feb', '2026-02-10T00:00:00.000Z');
+    const march = messageAt('m-mar', '2026-03-15T00:00:00.000Z');
+
+    // The search source returns messages newest-first; the hook only groups consecutive months.
+    const { result } = renderHook(() => useFileAttachmentListSections([march, february]), {
+      wrapper,
+    });
+
+    expect(result.current.map((section) => section.title)).toEqual(['March 2026', 'February 2026']);
+    expect(result.current[0].data.map((tile) => tile.message.id)).toEqual(['m-mar']);
+    expect(result.current[1].data.map((tile) => tile.message.id)).toEqual(['m-feb']);
+  });
+
+  it('keeps attachments from the same month under a single section', () => {
+    const early = messageAt('m-1', '2026-03-02T00:00:00.000Z');
+    const late = messageAt('m-2', '2026-03-28T00:00:00.000Z');
+
+    // Provided newest-first, as the search source returns them.
+    const { result } = renderHook(() => useFileAttachmentListSections([late, early]), { wrapper });
+
+    expect(result.current).toHaveLength(1);
+    expect(result.current[0].title).toBe('March 2026');
+    expect(result.current[0].data.map((tile) => tile.message.id)).toEqual(['m-2', 'm-1']);
+  });
+
+  it('emits one tile per file attachment within a message', () => {
+    const message = messageAt('m-1', '2026-03-15T00:00:00.000Z', [
+      generateFileAttachment({ title: 'one.pdf' }),
+      generateFileAttachment({ title: 'two.pdf' }),
+    ]);
+
+    const { result } = renderHook(() => useFileAttachmentListSections([message]), { wrapper });
+
+    expect(result.current[0].data.map((tile) => tile.attachment.title)).toEqual([
+      'one.pdf',
+      'two.pdf',
+    ]);
+  });
+
+  it('formats the section title via the timestamp/FileAttachmentListSection translation key', () => {
+    const customTranslators = {
+      t: jest.fn((key: string) =>
+        key === 'timestamp/FileAttachmentListSection' ? 'CUSTOM TITLE' : key,
+      ),
+      tDateTimeParser: translators.tDateTimeParser,
+      userLanguage: 'en',
+    } as unknown as TranslationContextValue;
+
+    const customWrapper = ({ children }: PropsWithChildren) => (
+      <TranslationProvider value={customTranslators}>{children}</TranslationProvider>
+    );
+
+    const { result } = renderHook(
+      () => useFileAttachmentListSections([messageAt('m-1', '2026-03-15T00:00:00.000Z')]),
+      { wrapper: customWrapper },
+    );
+
+    expect(result.current[0].title).toBe('CUSTOM TITLE');
+    // The MMMM YYYY format lives in the translation string itself, so the hook only forwards
+    // the timestamp to `t` — it does not pass a `format` option.
+    expect(customTranslators.t).toHaveBeenCalledWith(
+      'timestamp/FileAttachmentListSection',
+      expect.objectContaining({ timestamp: expect.any(Date) }),
+    );
+  });
+});

package/src/components/ChannelDetails/__tests__/useMediaList.test.tsx

@@ -0,0 +1,53 @@
+import { renderHook } from '@testing-library/react-native';
+
+import type { MessageResponse } from 'stream-chat';
+
+import {
+  generateImageAttachment,
+  generateVideoAttachment,
+} from '../../../mock-builders/generator/attachment';
+import { generateMessage } from '../../../mock-builders/generator/message';
+import { useMediaList } from '../hooks/useMediaList';
+
+const messageWithAttachments = (id: string, attachments: unknown[]): MessageResponse =>
+  generateMessage({ attachments: attachments as never, id }) as unknown as MessageResponse;
+
+describe('useMediaList', () => {
+  it('returns an empty array when there are no messages', () => {
+    const { result } = renderHook(() => useMediaList(undefined));
+    expect(result.current).toEqual([]);
+
+    const { result: emptyResult } = renderHook(() => useMediaList([]));
+    expect(emptyResult.current).toEqual([]);
+  });
+
+  it('returns one tile per image/video attachment and skips non-media and scraped attachments', () => {
+    const messageA = messageWithAttachments('m-1', [
+      generateImageAttachment(),
+      generateVideoAttachment(),
+    ]);
+    const messageB = messageWithAttachments('m-2', [
+      // excluded: image used as a link preview / og scrape
+      generateImageAttachment({ og_scrape_url: 'https://example.com' }),
+      generateImageAttachment({ title_link: 'https://example.com' }),
+      // excluded: not media
+      { type: 'file' },
+      // included
+      generateImageAttachment(),
+    ]);
+
+    const { result } = renderHook(() => useMediaList([messageA, messageB]));
+
+    expect(result.current.map((tile) => `${tile.message.id}-${tile.attachment.type}`)).toEqual([
+      'm-1-image',
+      'm-1-video',
+      'm-2-image',
+    ]);
+  });
+
+  it('skips messages without attachments', () => {
+    const message = generateMessage({ id: 'm-1' }) as unknown as MessageResponse;
+    const { result } = renderHook(() => useMediaList([message]));
+    expect(result.current).toEqual([]);
+  });
+});

package/src/components/ChannelDetails/components/ChannelDetailsActionItem.tsx

@@ -77,7 +77,12 @@ export const ChannelDetailsActionItem = ({
       onPress={onPress}
       style={({ pressed }) => [
         styles.row,
-        pressed ? { backgroundColor: semantics.backgroundUtilityPressed } : null,
+        pressed
+          ? {
+              backgroundColor: semantics.backgroundUtilityPressed,
+              borderRadius: primitives.radiusLg,
+            }
+          : null,
       ]}
       testID={testID}
     >

package/src/components/ChannelDetails/components/ChannelDetailsEditButton.tsx

@@ -0,0 +1,50 @@
+import React, { useCallback, useState } from 'react';
+
+import { ChannelEditDetailsModal } from './ChannelEditDetailsModal';
+
+import { useChannelDetailsContext } from '../../../contexts/channelDetailsContext/channelDetailsContext';
+import { useTranslationContext } from '../../../contexts/translationContext/TranslationContext';
+import { useChannelOwnCapabilities } from '../../../hooks/useChannelOwnCapabilities';
+import { useIsDirectChat } from '../../../hooks/useIsDirectChat';
+import { Button } from '../../ui/Button/Button';
+
+/**
+ * @experimental This component is experimental and is subject to change.
+ */
+export const ChannelDetailsEditButton = () => {
+  const { channel, onEditChannelPress } = useChannelDetailsContext();
+  const { t } = useTranslationContext();
+  const ownCapabilities = useChannelOwnCapabilities(channel);
+  const canUpdateChannel = ownCapabilities?.includes('update-channel') ?? false;
+  const isDirect = useIsDirectChat(channel);
+  const [editModalVisible, setEditModalVisible] = useState(false);
+
+  const handleEditPress = useCallback(() => {
+    if (onEditChannelPress) {
+      onEditChannelPress();
+      return;
+    }
+    setEditModalVisible(true);
+  }, [onEditChannelPress]);
+
+  const handleEditModalClose = useCallback(() => setEditModalVisible(false), []);
+
+  if (!canUpdateChannel || isDirect) {
+    return null;
+  }
+
+  return (
+    <>
+      <Button
+        accessibilityLabelKey='a11y/Edit channel'
+        label={t('Edit')}
+        onPress={handleEditPress}
+        size='sm'
+        testID='channel-details-edit-button'
+        type='outline'
+        variant='secondary'
+      />
+      <ChannelEditDetailsModal onClose={handleEditModalClose} visible={editModalVisible} />
+    </>
+  );
+};

package/src/components/ChannelDetails/components/ChannelDetailsNavHeader.tsx

@@ -1,20 +1,19 @@
-import React, { useCallback, useMemo, useState } from 'react';
+import React, { useMemo } from 'react';
 import { I18nManager, StyleSheet, Text, View } from 'react-native';
 
 import { useSafeAreaInsets } from 'react-native-safe-area-context';
 
-import { ChannelEditDetailsModal } from './ChannelEditDetailsModal';
-
 import { useChannelDetailsContext } from '../../../contexts/channelDetailsContext/channelDetailsContext';
 import { useTheme } from '../../../contexts/themeContext/ThemeContext';
 import { useTranslationContext } from '../../../contexts/translationContext/TranslationContext';
-import { useChannelOwnCapabilities } from '../../../hooks/useChannelOwnCapabilities';
 import { useIsDirectChat } from '../../../hooks/useIsDirectChat';
 import { ChevronLeft } from '../../../icons/chevron-left';
 import { primitives } from '../../../theme';
 import { Button } from '../../ui/Button/Button';
 
 export type ChannelDetailsNavHeaderProps = {
+  /** Content rendered on the trailing side of the header (e.g. the edit button). */
+  action?: React.ReactNode;
   /** Override the auto-resolved screen title (1:1 → "Contact Info", group → "Group Info"). */
   title?: string;
 };
@@ -22,11 +21,9 @@ export type ChannelDetailsNavHeaderProps = {
 /**
  * @experimental This component is experimental and is subject to change.
  */
-export const ChannelDetailsNavHeader = ({ title }: ChannelDetailsNavHeaderProps) => {
-  const { channel, onBack, onEditChannelPress } = useChannelDetailsContext();
+export const ChannelDetailsNavHeader = ({ action, title }: ChannelDetailsNavHeaderProps) => {
+  const { channel, onBack } = useChannelDetailsContext();
   const { t } = useTranslationContext();
-  const ownCapabilities = useChannelOwnCapabilities(channel);
-  const canUpdateChannel = ownCapabilities?.includes('update-channel') ?? false;
   const {
     theme: {
       channelDetails: {
@@ -37,20 +34,9 @@ export const ChannelDetailsNavHeader = ({ title }: ChannelDetailsNavHeaderProps)
   } = useTheme();
   const isDirect = useIsDirectChat(channel);
   const styles = useStyles();
-  const [editModalVisible, setEditModalVisible] = useState(false);
 
   const resolvedTitle = title ?? (isDirect ? t('Contact Info') : t('Group Info'));
 
-  const handleEditPress = useCallback(() => {
-    if (onEditChannelPress) {
-      onEditChannelPress();
-      return;
-    }
-    setEditModalVisible(true);
-  }, [onEditChannelPress]);
-
-  const handleEditModalClose = useCallback(() => setEditModalVisible(false), []);
-
   return (
     <View
       style={[
@@ -83,20 +69,7 @@ export const ChannelDetailsNavHeader = ({ title }: ChannelDetailsNavHeaderProps)
           {resolvedTitle}
         </Text>
       </View>
-      <View style={[styles.sideContainer, styles.sideContainerRight]}>
-        {canUpdateChannel && !isDirect ? (
-          <Button
-            accessibilityLabelKey='a11y/Edit channel'
-            label={t('Edit')}
-            onPress={handleEditPress}
-            size='sm'
-            testID='channel-details-edit-button'
-            type='outline'
-            variant='secondary'
-          />
-        ) : null}
-      </View>
-      <ChannelEditDetailsModal onClose={handleEditModalClose} visible={editModalVisible} />
+      <View style={[styles.sideContainer, styles.sideContainerRight]}>{action ?? null}</View>
     </View>
   );
 };

package/src/components/ChannelDetails/components/ChannelDetailsNavigationSection.tsx

@@ -1,21 +1,26 @@
-import React, { useMemo } from 'react';
+import React, { useCallback, useMemo, useState } from 'react';
 import { StyleSheet, View } from 'react-native';
 
 import { ChannelDetailsActionItem } from './ChannelDetailsActionItem';
+import { ChannelDetailsModal } from './modal/Modal';
+import { ModalHeader } from './modal/ModalHeader';
 
+import { useComponentsContext } from '../../../contexts/componentsContext/ComponentsContext';
+import { useOverlayContext } from '../../../contexts/overlayContext/OverlayContext';
 import { useTheme } from '../../../contexts/themeContext/ThemeContext';
-import { useTranslationContext } from '../../../contexts/translationContext/TranslationContext';
 import { ChevronRight } from '../../../icons';
-import { File } from '../../../icons/file';
-import { ImageGrid } from '../../../icons/gallery';
-import { Pin } from '../../../icons/pin';
+import { ChevronLeft } from '../../../icons/chevron-left';
 import { primitives } from '../../../theme';
+import { ImageGallery } from '../../ImageGallery/ImageGallery';
+import {
+  type ChannelDetailsNavigationSectionType,
+  useChannelDetailsNavigationItems,
+} from '../hooks/useChannelDetailsNavigationItems';
 
 /**
  * @experimental This component is experimental and is subject to change.
  */
 export const ChannelDetailsNavigationSection = () => {
-  const { t } = useTranslationContext();
   const {
     theme: {
       channelDetails: { sectionCard: sectionCardOverride },
@@ -23,6 +28,36 @@ export const ChannelDetailsNavigationSection = () => {
     },
   } = useTheme();
   const styles = useStyles();
+  const { FileAttachmentList, MediaList, PinnedMessageList } = useComponentsContext();
+  const items = useChannelDetailsNavigationItems();
+  const [activeSection, setActiveSection] = useState<ChannelDetailsNavigationSectionType | null>(
+    null,
+  );
+  const { overlayOpacity, overlay } = useOverlayContext();
+  const closeModal = useCallback(() => setActiveSection(null), []);
+
+  const modalContent = useMemo(() => {
+    switch (activeSection) {
+      case 'pinned-messages':
+        return <PinnedMessageList />;
+      case 'photos-and-videos':
+        return (
+          <>
+            <MediaList />
+            {overlay === 'gallery' ? <ImageGallery overlayOpacity={overlayOpacity} /> : null}
+          </>
+        );
+      case 'files':
+        return <FileAttachmentList />;
+      default:
+        return null;
+    }
+  }, [activeSection, FileAttachmentList, MediaList, PinnedMessageList, overlayOpacity, overlay]);
+
+  const activeItem = useMemo(
+    () => items.find((item) => item.section === activeSection),
+    [activeSection, items],
+  );
 
   const chevron = useMemo(
     () => (
@@ -33,33 +68,46 @@ export const ChannelDetailsNavigationSection = () => {
     [semantics.textTertiary],
   );
 
+  const closeButtonProps = useMemo(
+    () => ({ type: 'ghost' as const, LeadingIcon: ChevronLeft }),
+    [],
+  );
+
   return (
-    <View
-      style={[
-        styles.sectionCard,
-        { backgroundColor: semantics.backgroundCoreSurfaceCard },
-        sectionCardOverride,
-      ]}
-    >
-      <ChannelDetailsActionItem
-        Icon={Pin}
-        label={t('Pinned Messages')}
-        testID='channel-details-pinned-messages'
-        trailing={chevron}
-      />
-      <ChannelDetailsActionItem
-        Icon={ImageGrid}
-        label={t('Photos & Videos')}
-        testID='channel-details-photos-and-videos'
-        trailing={chevron}
-      />
-      <ChannelDetailsActionItem
-        Icon={File}
-        label={t('Files')}
-        testID='channel-details-files'
-        trailing={chevron}
-      />
-    </View>
+    <>
+      <View
+        style={[
+          styles.sectionCard,
+          { backgroundColor: semantics.backgroundCoreSurfaceCard },
+          sectionCardOverride,
+        ]}
+      >
+        {items.map((item) => (
+          <ChannelDetailsActionItem
+            Icon={item.Icon}
+            key={item.section}
+            label={item.label}
+            onPress={item.onPress ?? (() => setActiveSection(item.section))}
+            testID={`channel-details-${item.section}`}
+            trailing={chevron}
+          />
+        ))}
+      </View>
+      <ChannelDetailsModal
+        onClose={closeModal}
+        visible={activeSection !== null}
+        presentationStyle='fullScreen'
+      >
+        {activeItem ? (
+          <ModalHeader
+            onClose={closeModal}
+            title={activeItem.label}
+            additionalCloseButtonProps={closeButtonProps}
+          />
+        ) : null}
+        {modalContent}
+      </ChannelDetailsModal>
+    </>
   );
 };
 

package/src/components/ChannelDetails/components/ChannelDetailsProfile.tsx

@@ -81,10 +81,11 @@ const useStyles = () => {
         container: {
           alignItems: 'center',
           gap: primitives.spacingMd,
+          paddingBottom: primitives.spacing2xl,
         },
         heading: {
           alignItems: 'center',
-          gap: primitives.spacingXs,
+          gap: primitives.spacingXxs,
           width: '100%',
         },
         subtitle: {

package/src/components/ChannelDetails/components/ChannelEditImageSheet.tsx

@@ -19,7 +19,7 @@ import { Camera } from '../../../icons/camera';
 import { Delete } from '../../../icons/delete';
 import { Picture } from '../../../icons/image';
 import type { IconProps } from '../../../icons/utils/base';
-import { NewClose } from '../../../icons/xmark';
+import { Cross } from '../../../icons/xmark-1';
 import type {
   EditChannelDetailsState,
   EditChannelImagePendingAction,
@@ -136,7 +136,7 @@ const ChannelEditImageSheetInner = () => {
           <Button
             accessibilityLabelKey='a11y/Close edit picture sheet'
             iconOnly
-            LeadingIcon={NewClose}
+            LeadingIcon={Cross}
             onPress={() => close()}
             size='md'
             testID='channel-edit-picture-sheet-close-button'

package/src/components/ChannelDetails/components/__tests__/navigation-section/FileAttachmentItem.test.tsx

@@ -0,0 +1,80 @@
+import React from 'react';
+
+import { fireEvent, render, screen } from '@testing-library/react-native';
+
+import type { Attachment, MessageResponse } from 'stream-chat';
+
+import { ThemeProvider } from '../../../../../contexts/themeContext/ThemeContext';
+import { defaultTheme } from '../../../../../contexts/themeContext/utils/theme';
+import { generateFileAttachment } from '../../../../../mock-builders/generator/attachment';
+import { generateMessage } from '../../../../../mock-builders/generator/message';
+import { FileAttachmentItem } from '../../navigation-section/FileAttachmentItem';
+
+const mockOpenUrlSafely = jest.fn();
+
+jest.mock('../../../../Attachment/utils/openUrlSafely', () => ({
+  openUrlSafely: (url?: string) => mockOpenUrlSafely(url),
+}));
+
+const mockFilePreviewProbe: { title?: string }[] = [];
+
+jest.mock('../../../../Attachment/FilePreview', () => {
+  const ReactLib = require('react');
+  const { Text } = require('react-native');
+  return {
+    FilePreview: ({ attachment }: { attachment: { title?: string } }) => {
+      mockFilePreviewProbe.push({ title: attachment.title });
+      return ReactLib.createElement(Text, null, attachment.title);
+    },
+  };
+});
+
+const tree = (
+  attachment: Attachment,
+  message: MessageResponse,
+  onPress?: React.ComponentProps<typeof FileAttachmentItem>['onPress'],
+) => (
+  <ThemeProvider theme={defaultTheme}>
+    <FileAttachmentItem attachment={attachment} message={message} onPress={onPress} />
+  </ThemeProvider>
+);
+
+describe('FileAttachmentItem', () => {
+  beforeEach(() => {
+    mockFilePreviewProbe.length = 0;
+  });
+
+  afterEach(() => jest.clearAllMocks());
+
+  it('renders the attachment preview', () => {
+    const file = generateFileAttachment({ title: 'a-file.pdf' });
+    const message = generateMessage({ id: 'm-1' }) as unknown as MessageResponse;
+
+    render(tree(file, message));
+
+    expect(mockFilePreviewProbe.map((p) => p.title)).toEqual(['a-file.pdf']);
+    expect(screen.getByTestId('file-attachment-item-m-1')).toBeTruthy();
+  });
+
+  it('opens the attachment url when a row is pressed', () => {
+    const file = generateFileAttachment({ asset_url: 'https://example.com/a.pdf', title: 'a.pdf' });
+    const message = generateMessage({ id: 'm-3' }) as unknown as MessageResponse;
+
+    render(tree(file, message));
+
+    fireEvent.press(screen.getByTestId('file-attachment-row-m-3'));
+    expect(mockOpenUrlSafely).toHaveBeenCalledWith('https://example.com/a.pdf');
+  });
+
+  it('calls the provided onPress with the attachment and message, overriding the default', () => {
+    const file = generateFileAttachment({ asset_url: 'https://example.com/a.pdf', title: 'a.pdf' });
+    const message = generateMessage({ id: 'm-4' }) as unknown as MessageResponse;
+    const onPress = jest.fn();
+
+    render(tree(file, message, onPress));
+
+    fireEvent.press(screen.getByTestId('file-attachment-row-m-4'));
+    expect(onPress).toHaveBeenCalledWith({ attachment: file, message });
+    expect(mockOpenUrlSafely).not.toHaveBeenCalled();
+  });
+});