refactor: replace Record<string, unknown> with specific types

Cuts `Record<string, unknown>` uses from 57 → 22. The remaining 22 are
legitimate: generic parameter defaults on public API types
(`CustomLocalMetadata`), the `UnknownType` export, `Message.additionalInfo`
(genuine bag-of-data prop), `useStateStore` / `usePollStateStore` generic
constraints, `topologicalResolution` plain-object type guards,
`BetterSqlite.selectFromTable` default row type, the i18n formatter
`options` (matches i18next API shape), and the one remaining
`exception_fields` field on `mock-builders/api/error.ts` which matches
the real Stream API error shape.

**Source / mock-builders:**
- mock-builders/api/initiateClientWithChannels.ts: alias
  `ChannelData` as `Parameters<typeof generateChannel>[0]`.
- mock-builders/generator/channel.ts: drop unused `_client` field (only
  ever set to `{}`, no consumers).
- mock-builders/attachments.ts: narrow override arg to
  `Partial<LocalAttachmentData & { file: Partial<FileReference> }>`
  (both callers pass no overrides anyway).
- mock-builders/mock.ts: replace two `as unknown as Record<string,
  unknown>` + `as never` casts with a single `type WithPrivates` cast
  for `_setToken` / `_setupConnection` spies.
- components/UIComponents/SwipableWrapper.tsx: `Content` prop typed as
  bare `React.ComponentType` (rendered as `<Content />` with no props).

**Tests:**
- Channel.test.tsx: 9 uses replaced — `RenderComponentProps` becomes
  `Partial<ComponentProps<typeof Channel>>` (with `channel?: unknown` to
  allow the one test that passes an ad-hoc shape); context-cast sites
  use `typeof mockContext` so test mocks can mix fields from
  `ChatContextValue` + `MessagesContextValue`; `T extends object`
  generic; `typeof channel.state.messages`; `Partial<ReturnType<typeof
  MessageListPaginationHooks.useMessageListPagination>>`; `typeof
  channel.state.read`.
- Giphy.test.tsx: 10 uses replaced with `ComponentProps<typeof Image>`
  + `StyleProp<ImageStyle>` / `ImageStyle` from `react-native`.
- ChannelList.test.tsx: `filters` arg typed as
  `Parameters<typeof chatClient.queryChannels>[0]`.
- MessageContent.test.tsx: override-component prop types switched to
  `MessageHeaderProps` / `MessageFooterProps` from the component
  sources.
- useMessageListPagination.test.tsx: `mockedHook` args typed as
  `Partial<typeof channelInitialState>` and `Partial<ReturnType<
  typeof ChannelStateHooks.useChannelMessageDataState>>`.
- ChannelDetailsBottomSheet.test.tsx: 3 uses replaced with
  `ComponentProps<typeof StreamBottomSheetModalFlatList>`.
- ChannelSwipableWrapper.test.tsx: `ComponentProps<typeof
  SwipableWrapper>`.
- ChannelPreview.test.tsx: override-map types from
  `Parameters<typeof generateChannelResponse>[0]` and `Partial<Channel>`.

test:typecheck: 0 errors. Full test suite: same pre-existing
SQLite-isolation flake; no regressions.

Author: oliverlaz

package/src/components/Attachment/__tests__/Giphy.test.tsx

@@ -1,4 +1,5 @@
 import React, { ComponentProps } from 'react';
+import type { Image, ImageStyle, StyleProp } from 'react-native';
 
 import {
   act,
@@ -196,21 +197,15 @@ describe('Giphy', () => {
     render(getAttachmentComponent({ attachment, giphyVersion: 'fixed_height' }));
     await waitFor(() => {
       const checkImageProps = (
-        imageProps: Record<string, unknown>,
+        imageProps: ComponentProps<typeof Image>,
         specificSizedGiphyData: { height: string; url: string; width: string },
       ) => {
-        let imageStyle = imageProps.style as
-          | Record<string, unknown>
-          | Array<Record<string, unknown>>;
+        let imageStyle = imageProps.style as StyleProp<ImageStyle>;
         if (Array.isArray(imageStyle)) {
           imageStyle = Object.assign({}, ...imageStyle);
         }
-        expect((imageStyle as Record<string, unknown>).height).toBe(
-          parseFloat(specificSizedGiphyData.height),
-        );
-        expect((imageStyle as Record<string, unknown>).width).toBe(
-          parseFloat(specificSizedGiphyData.width),
-        );
+        expect((imageStyle as ImageStyle).height).toBe(parseFloat(specificSizedGiphyData.height));
+        expect((imageStyle as ImageStyle).width).toBe(parseFloat(specificSizedGiphyData.width));
         expect((imageProps.source as { uri: string }).uri).toBe(specificSizedGiphyData.url);
       };
       checkImageProps(
@@ -221,21 +216,15 @@ describe('Giphy', () => {
     render(getAttachmentComponent({ attachment, giphyVersion: 'original' }));
     await waitFor(() => {
       const checkImageProps = (
-        imageProps: Record<string, unknown>,
+        imageProps: ComponentProps<typeof Image>,
         specificSizedGiphyData: { height: string; url: string; width: string },
       ) => {
-        let imageStyle = imageProps.style as
-          | Record<string, unknown>
-          | Array<Record<string, unknown>>;
+        let imageStyle = imageProps.style as StyleProp<ImageStyle>;
         if (Array.isArray(imageStyle)) {
           imageStyle = Object.assign({}, ...imageStyle);
         }
-        expect((imageStyle as Record<string, unknown>).height).toBe(
-          parseFloat(specificSizedGiphyData.height),
-        );
-        expect((imageStyle as Record<string, unknown>).width).toBe(
-          parseFloat(specificSizedGiphyData.width),
-        );
+        expect((imageStyle as ImageStyle).height).toBe(parseFloat(specificSizedGiphyData.height));
+        expect((imageStyle as ImageStyle).width).toBe(parseFloat(specificSizedGiphyData.width));
         expect((imageProps.source as { uri: string }).uri).toBe(specificSizedGiphyData.url);
       };
       checkImageProps(

package/src/components/Channel/__tests__/Channel.test.tsx

@@ -1,4 +1,4 @@
-import React, { useContext, useEffect } from 'react';
+import React, { type ComponentProps, useContext, useEffect } from 'react';
 import { View } from 'react-native';
 
 import { act, cleanup, render, renderHook, waitFor } from '@testing-library/react-native';
@@ -73,7 +73,10 @@ let channel: ChannelType;
 const user = generateUser({ id: 'id', name: 'name' });
 const messages = [generateMessage({ cid: channelCid, user })];
 
-type RenderComponentProps = Record<string, unknown> & { children?: React.ReactNode };
+type RenderComponentProps = Partial<Omit<ComponentProps<typeof Channel>, 'channel'>> & {
+  channel?: unknown;
+  children?: React.ReactNode;
+};
 
 const renderComponent = (
   props: RenderComponentProps = {},
@@ -282,7 +285,7 @@ describe('Channel', () => {
 
       await waitFor(() => {
         expect(context).toBeInstanceOf(Object);
-        const ctx = context as unknown as Record<string, unknown>;
+        const ctx = context as unknown as typeof mockContext;
         expect(ctx.channel).toBeInstanceOf(Object);
         expect(ctx.client).toBeInstanceOf(StreamChat);
         expect(ctx.markRead).toBeInstanceOf(Function);
@@ -325,7 +328,7 @@ describe('Channel', () => {
 
       await waitFor(() => {
         expect(context).toBeInstanceOf(Object);
-        const ctx = context as unknown as Record<string, unknown>;
+        const ctx = context as unknown as typeof mockContext;
         expect(ctx.Attachment).toBeInstanceOf(Function);
         expect(ctx.editing).toBe(false);
         expect(ctx.messages).toBeInstanceOf(Array);
@@ -461,11 +464,7 @@ describe('Channel initial load useEffect', () => {
     await waitFor(() => expect(Object.keys(channelState.current.state.members!)).toHaveLength(10));
   });
 
-  function getElementsAround<T extends Record<string, unknown>>(
-    array: T[],
-    key: keyof T,
-    id: unknown,
-  ) {
+  function getElementsAround<T extends object>(array: T[], key: keyof T, id: unknown) {
     const index = array.findIndex((obj) => obj[key] === id);
 
     if (index === -1) {
@@ -490,7 +489,7 @@ describe('Channel initial load useEffect', () => {
 
     const loadMessageIntoState = jest.fn(() => {
       const newMessages = getElementsAround(
-        messages as unknown as Record<string, unknown>[],
+        messages as unknown as typeof channel.state.messages,
         'id',
         messageToSearch.id,
       );
@@ -532,7 +531,9 @@ describe('Channel initial load useEffect', () => {
       jest.restoreAllMocks();
       cleanup();
     });
-    const mockedHook = (values: Record<string, unknown>) =>
+    const mockedHook = (
+      values: Partial<ReturnType<typeof MessageListPaginationHooks.useMessageListPagination>>,
+    ) =>
       jest.spyOn(MessageListPaginationHooks, 'useMessageListPagination').mockImplementation(
         () =>
           ({
@@ -556,12 +557,12 @@ describe('Channel initial load useEffect', () => {
       const channel = chatClient.channel('messaging', mockedChannel.channel.id);
       await channel.watch();
       const user = generateUser();
-      const read_data: Record<string, unknown> = {};
+      const read_data: typeof channel.state.read = {};
 
       read_data[chatClient.user!.id] = {
         last_read: new Date(),
         user,
-      };
+      } as unknown as (typeof channel.state.read)[string];
 
       channel.state = {
         ...channelInitialState,
@@ -591,7 +592,7 @@ describe('Channel initial load useEffect', () => {
 
       const user = generateUser();
       const numberOfUnreadMessages = 15;
-      const read_data: Record<string, unknown> = {};
+      const read_data: typeof channel.state.read = {};
 
       read_data[chatClient.user!.id] = {
         last_read: new Date(),
@@ -626,7 +627,7 @@ describe('Channel initial load useEffect', () => {
 
       const user = generateUser();
       const numberOfUnreadMessages = 2;
-      const read_data: Record<string, unknown> = {};
+      const read_data: typeof channel.state.read = {};
 
       read_data[chatClient.user!.id] = {
         last_read: new Date(),

package/src/components/Channel/__tests__/useMessageListPagination.test.tsx

@@ -15,7 +15,10 @@ describe('useMessageListPagination', () => {
   let chatClient: StreamChat;
   let channel: ChannelType;
 
-  const mockedHook = (state: Record<string, unknown>, values?: Record<string, unknown>) =>
+  const mockedHook = (
+    state: Partial<typeof channelInitialState>,
+    values?: Partial<ReturnType<typeof ChannelStateHooks.useChannelMessageDataState>>,
+  ) =>
     jest.spyOn(ChannelStateHooks, 'useChannelMessageDataState').mockImplementation(
       () =>
         ({

package/src/components/ChannelList/__tests__/ChannelList.test.tsx

@@ -215,7 +215,7 @@ describe('ChannelList', () => {
     const staleChannel = [createMockChannel('stale-channel')];
     const freshChannel = [createMockChannel('new-channel')];
     const spy = jest.spyOn(chatClient, 'queryChannels');
-    spy.mockImplementation(((filters: Record<string, unknown> = {}) => {
+    spy.mockImplementation(((filters: Parameters<typeof chatClient.queryChannels>[0] = {}) => {
       if (Object.prototype.hasOwnProperty.call(filters, 'new-filter')) {
         return deferredCallForFreshFilter.promise;
       }

package/src/components/ChannelPreview/__tests__/ChannelDetailsBottomSheet.test.tsx

@@ -1,4 +1,4 @@
-import React from 'react';
+import React, { type ComponentProps } from 'react';
 import { Text } from 'react-native';
 
 import { render } from '@testing-library/react-native';
@@ -7,16 +7,19 @@ import type { Channel } from 'stream-chat';
 import { ThemeProvider, defaultTheme } from '../../../contexts';
 import { WithComponents } from '../../../contexts/componentsContext/ComponentsContext';
 import type { ChannelActionItem } from '../../ChannelList/hooks/useChannelActionItems';
+import { StreamBottomSheetModalFlatList } from '../../UIComponents/StreamBottomSheetModalFlatList';
 import type { ChannelDetailsHeaderProps } from '../ChannelDetailsBottomSheet';
 import { ChannelDetailsBottomSheet } from '../ChannelDetailsBottomSheet';
 
+type StreamBottomSheetModalFlatListProps = ComponentProps<typeof StreamBottomSheetModalFlatList>;
+
 const mockStreamBottomSheetModalFlatList = jest.fn(
   // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  (_props: Record<string, unknown>) => null,
+  (_props: StreamBottomSheetModalFlatListProps) => null,
 );
 
 jest.mock('../../UIComponents/StreamBottomSheetModalFlatList', () => ({
-  StreamBottomSheetModalFlatList: (...args: [Record<string, unknown>]) =>
+  StreamBottomSheetModalFlatList: (...args: [StreamBottomSheetModalFlatListProps]) =>
     mockStreamBottomSheetModalFlatList(...args),
 }));
 
@@ -77,7 +80,9 @@ describe('ChannelDetailsBottomSheet', () => {
 
     expect(mockStreamBottomSheetModalFlatList).toHaveBeenCalled();
     const flatListProps = (
-      mockStreamBottomSheetModalFlatList.mock.calls[0] as unknown as [Record<string, unknown>]
+      mockStreamBottomSheetModalFlatList.mock.calls[0] as unknown as [
+        StreamBottomSheetModalFlatListProps,
+      ]
     )?.[0];
     expect(flatListProps).toEqual(
       expect.objectContaining({

package/src/components/ChannelPreview/__tests__/ChannelPreview.test.tsx

@@ -57,7 +57,7 @@ const ChannelPreviewUIComponent = (props: ChannelPreviewUIComponentProps) => {
 
 const initChannelFromData = async (
   chatClient: StreamChat,
-  overrides: Record<string, unknown> = {},
+  overrides: Parameters<typeof generateChannelResponse>[0] = {},
 ) => {
   const mockedChannel = generateChannelResponse(overrides);
   useMockedApis(chatClient, [getOrCreateChannelApi(mockedChannel)]);
@@ -98,14 +98,14 @@ describe('ChannelPreview', () => {
     );
   };
 
-  const generateChannelWrapper = (overrides: Record<string, unknown>) =>
+  const generateChannelWrapper = (overrides: Partial<Channel>) =>
     generateChannel({
       countUnread: jest.fn().mockReturnValue(0),
       initialized: true,
       lastMessage: jest.fn().mockReturnValue(generateMessage()),
       muteStatus: jest.fn().mockReturnValue({ muted: false }),
       ...overrides,
-    });
+    } as unknown as Parameters<typeof generateChannel>[0]);
 
   const useInitializeChannel = async (c: GetOrCreateChannelApiParams) => {
     useMockedApis(chatClient, [getOrCreateChannelApi(c)]);

package/src/components/ChannelPreview/__tests__/ChannelSwipableWrapper.test.tsx

@@ -1,4 +1,4 @@
-import React from 'react';
+import React, { type ComponentProps } from 'react';
 import { Text } from 'react-native';
 
 import { act, render } from '@testing-library/react-native';
@@ -8,6 +8,7 @@ import { WithComponents } from '../../../contexts/componentsContext/ComponentsCo
 import type { ChannelActionItem } from '../../ChannelList/hooks/useChannelActionItems';
 import * as ChannelActionItemsModule from '../../ChannelList/hooks/useChannelActionItems';
 import * as ChannelActionsModule from '../../ChannelList/hooks/useChannelActions';
+import { SwipableWrapper } from '../../UIComponents/SwipableWrapper';
 import { ChannelSwipableWrapper } from '../ChannelSwipableWrapper';
 import * as UseIsChannelMutedModule from '../hooks/useIsChannelMuted';
 
@@ -60,7 +61,7 @@ jest.mock('../../UIComponents/SwipableWrapper', () => ({
     rightActionsProbe.items = items;
     return null;
   },
-  SwipableWrapper: (...args: [React.PropsWithChildren<Record<string, unknown>>]) =>
+  SwipableWrapper: (...args: [ComponentProps<typeof SwipableWrapper>]) =>
     mockSwipableWrapper(...args),
 }));
 

package/src/components/Message/MessageItemView/__tests__/MessageContent.test.tsx

@@ -23,6 +23,8 @@ import { getTestClientWithUser } from '../../../../mock-builders/mock';
 import { Channel } from '../../../Channel/Channel';
 import { Chat } from '../../../Chat/Chat';
 import { Message } from '../../Message';
+import type { MessageFooterProps } from '../MessageFooter';
+import type { MessageHeaderProps } from '../MessageHeader';
 
 describe('MessageContent', () => {
   let channel: ChannelType;
@@ -117,7 +119,7 @@ describe('MessageContent', () => {
     const user = generateUser();
     const message = generateMessage({ user });
 
-    const ContextMessageHeader = (props: Record<string, unknown>) => (
+    const ContextMessageHeader = (props: MessageHeaderProps) => (
       <View {...props} testID='message-header' />
     );
 
@@ -143,7 +145,7 @@ describe('MessageContent', () => {
     const user = generateUser();
     const message = generateMessage({ user });
 
-    const ContextMessageFooter = (props: Record<string, unknown>) => (
+    const ContextMessageFooter = (props: MessageFooterProps) => (
       <View {...props} testID='message-footer' />
     );
 

package/src/components/UIComponents/SwipableWrapper.tsx

@@ -32,7 +32,7 @@ const animationOptions = {
 export type SwipableActionItem = {
   action: () => void | Promise<void>;
   contentContainerStyle?: StyleProp<ViewStyle>;
-  Content: React.ComponentType<Record<string, unknown>>;
+  Content: React.ComponentType;
   id: string;
 };
 

package/src/mock-builders/api/initiateClientWithChannels.ts

@@ -8,7 +8,7 @@ import { generateMember } from '../generator/member';
 import { generateUser } from '../generator/user';
 import { getTestClientWithUser } from '../mock';
 
-type ChannelData = Record<string, unknown>;
+type ChannelData = Parameters<typeof generateChannel>[0];
 
 const initChannelFromData = async ({
   channelData,