[isekovanic]

CLA

• I have signed the Stream CLA (required).
• Code changes are tested

Description of the changes, What, Why and How?

Fixes the "must fix" of the issues in section 1 of ai-docs/v10-followups.md. Each item is its own commit, linked below. Two parts of that list are not in this PR: the channel.query() message-set parameter is being fixed separately and the breaking removals listed at the end of section 1 get their own PR (probably tomorrow).

Behaviour fixes

• Typing indicators went stale after a composer reset (send, clear(), edit init, snapshot restore), because the text composer kept its own copy of the typing map. The copy is gone and channel.state is the only owner. Thread typing indicators that read the thread composer's copy, which was always empty, work once they read channel.state. (f97ddd8)
• One mark-read throttle was shared by every channel and thread, so channel → thread → channel inside one second dropped the thread's mark-read. Each channel and thread instance now has its own throttle. (312e2e5)
• When retries ran out, the rejection was a RetryError with no code or status, and offline operations queued it as transient. The last attempt's error is rethrown instead, so callers get the StreamAPIError. A 429 is no longer retried, as in v9; it used to hold the caller for about 100 s. (e295664)
• An expired static token was reloaded and retried 10 times. It fails on the first attempt again, as in v9. (eef8868)
• The channel skipped edits and undeletes of show_in_channel replies, so the channel list kept the old text unless a Thread for the parent was held. The channel applies them now, and leaves them to the thread when client.threads routes the edit to a held one, so each collection still publishes once. (dd1b8c7)
• user.messages.deleted only processed the active window, so after a jump to an older message the banned user's newest messages stayed visible. Every loaded interval is processed now. (45290f4)
• connectionRecovery.recover() did nothing when connectionRecovery.enabled was false. The flag now only switches off the automatic recovery on reconnect, and recover() always runs. With recovery disabled, connection.recovered is still not dispatched on reconnect, since it means a recovery finished; the JSDoc says so now. (311c28a)
• The reminder list published items: undefined on every load more, because the page cursor was part of the query shape. The cursor is applied per request instead. (73a8775)
• lastQueryError was published on every failed attempt, before the retries ran out, so React showed error toasts and RN flashed its error screen for a query that recovered. It is published once, after the last attempt. (9cc208f)
• messageSearchSort was appended after a fixed created_at: -1, so [{ field: 'created_at', direction: 1 }] sent a contradictory duplicate key. It is merged the v9 way: created_at stays the primary key and takes the caller's direction. (e32c8d5)

Type fixes

• on('all', cb) typed the event as never, while undeclared names (typos, connection.changed) compiled and never fired. 'all' now gets the full Event union, and on() / off() accept only an EventType, so custom events are declared through CustomEventTypes. off(type, handler) takes EventHandler<type>, so a typed handler can be removed again. (c103da0)
• client.on('*') type-checked but never fired. The spec's { type: '*' } & CustomEvent placeholder is dropped from the generated event unions. (79477d2)
• The created_at_* filters of QueryMembersPayload, QueryBannedUsersPayload and QueryFutureChannelBansPayload were typed TimestampNS, which the API rejects with Time.UnmarshalJSON: input is not a JSON string (checked against a live app). They are Date | string now, matching the spec's date-time. (202e690, which also rewrites the time.ts note from 8bc711c)

The generated-model changes are made by scripts/apply-custom-data-types.mts and a new scripts/drop-placeholder-request-params.mts, both run by generate-client.sh, so a regen keeps them.

Signature changes (breaking)

These are in be73434 unless noted:

• client.pinMessage({ id }, { pin_expires?, pinned_at? }) and client.unpinMessage({ id }) take the message (or { id }) and absolute dates. The relative-seconds number and the bare id string are gone.
• client.getThreadAndHydrate({ message_id }, options?), like getThread.
• channel.addMembers, inviteMembers and removeMembers take { members, message?, ...options }; addFilterTags and removeFilterTags take { tags, message?, ...options }.
• channel.deleteImage({ url }) and channel.deleteFile({ url }), like the client methods.
• client.polls.queryPolls(request?) takes the same request as client.queryPolls.
• client.moderation.flagMessage({ message_id, reason?, ...options }) and flagUser({ user_id, reason?, ...options }).
• PollComposer.updateFields({ data, injectedFieldErrors? }). (4f8f95c)
• The 26 body-less endpoints drop the unused _request?: Record<string, never> parameter, so requestOptions follows the path params directly (channel.pin({ signal }), client.getApp(requestOptions?)). (51fa769)

Every change is recorded in ai-docs/v10-breaking-changes.md with a migration line. The docs snippet tests use the new signatures; the matching getstream.io pages still need updating, and yarn test-docs-sync reports those regions until they are.

Testing

Each fix comes with unit or type tests that fail on the previous code. yarn test, yarn types, yarn lint and yarn types-docs pass. The two unhandled rejections the suite reports (from optimisticRouting.test.ts and poll.test.js) predate this branch.

Changelog

• fix: typing indicators no longer go stale after the composer resets; channel.state owns the typing map (f97ddd8)
• fix: throttle mark-read per channel and thread (312e2e5)
• fix: on('all') gets the full Event type; on() / off() accept only declared event names (c103da0)
• fix: remove the '*' placeholder from the event types (79477d2)
• fix: rethrow the API error when retries run out; stop retrying 429 (e295664)
• fix: fail expired static tokens immediately (eef8868)
• fix: apply edits of show_in_channel replies to the channel list (dd1b8c7)
• fix: user.messages.deleted processes every loaded message (45290f4)
• fix: connectionRecovery.recover() works when automatic recovery is disabled (311c28a)
• fix: reminder list no longer blanks on load more (73a8775)
• fix: publish lastQueryError only after the retries run out (9cc208f)
• fix: merge messageSearchSort under created_at like v9 (e32c8d5)
• fix: type member and ban query date filters as Date | string (202e690)
• refactor!: request objects for pinMessage, getThreadAndHydrate, channel member and filter-tag helpers, channel.deleteImage / deleteFile, polls.queryPolls, flagMessage / flagUser (be73434)
• refactor!: PollComposer.updateFields takes one object (4f8f95c)
• refactor!: drop the unused request parameter from body-less endpoints (51fa769)

[stream-ci-bot]

🎉 This PR is included in version 10.0.0-rc.23 🎉

The release is available on:

• GitHub release
• npm package (@rc dist-tag)

Your semantic-release bot 📦🚀