refactor: stop creating sdk paginator

[isekovanic]

🎯 Goal

Make <ChannelList> render an app-owned ChannelPaginator instead of creating one. The SDK used to build a paginator from the list's props and dispose it on unmount, so a list that mounted again (for example after search results replaced it) queried again from scratch. The integration can then decide when (and if) they want to dispose it.

Stacked on the <Channel> lifecycle PR.

🛠 Implementation details

- <ChannelList filters={filters} sort={sort} options={options} />
+ // next to connectUser
+ const paginator = new ChannelPaginator({ client, filters, id: 'channel-list', requestOptions: options, sort });
+ client.channelManager.insertPaginator({ paginator });
+
+ <ChannelList paginator={paginator} />
+
+ // on logout
+ client.channelManager.removePaginator(paginator);
+ paginator.dispose();

• usePaginatedChannels no longer creates, registers, disposes or re-queries on prop changes. It loads the first page only when the paginator has none: on first mount, after disconnectUser resets it, or when a different paginator is passed.
• The list never removes or disposes the paginator, so a list that mounts again shows its channels without a query.
• The sample apps create the paginator with the user (SampleApp in useChatClient, the Expo apps in AppProvider) and remove it on logout, since disconnectUser empties registered lists but keeps them registered.
• The gauntlet transformer patches the channel list query wherever it is defined.

Breaking changes

• paginator is a required prop.
• filters, sort, options, lockChannelOrder and queryChannelsOverride are removed, along with the ChannelListQueryChannelsOverride type. They are now set on the ChannelPaginator: in its constructor or requestOptions, through paginatorOptions.lockItemOrder and paginatorOptions.doRequest.
• Changing the query is a paginator change: set its staticFilters / sort / options and call reload(), or pass a new paginator.

🎨 UI Changes

/

🧪 Testing

/

☑️ Checklist

• I have signed the Stream CLA (required)
• PR targets the develop branch
• Documentation is updated
• New code is tested in main example apps, including all possible scenarios
  • SampleApp iOS and Android
  • Expo iOS and Android

[Stream-SDK-Bot]

SDK Size

title	develop	branch	diff	status
js_bundle_size	2036 KB	2018 KB	-18614 B	🚀
ai_components_size	130 KB	130 KB	0 B	🟢