feat: add Future Channel Bans support [CHA-1696] (#1677)

## Summary

Add support for the Future Channel Bans feature.

### New Parameters

- `ban_from_future_channels` parameter in `channel.banUser()` options
- `remove_future_channels_ban` parameter in `client.unbanUser()` options

### Usage

```typescript
// Ban user from current channel and all future channels created by banner
await channel.banUser('user-id', {
  ban_from_future_channels: true,
  reason: 'spam',
});

// Remove future channel ban (does NOT remove existing channel bans)
await client.unbanUser('user-id', {
  channel_cid: 'messaging:channel-id',
  created_by: 'banner-user-id',
  remove_future_channels_ban: true,
});

// Query future channel bans
const response = await client.queryFutureChannelBans({
  created_by_id: 'banner-user-id',
});
```

## Related PRs

- Backend: GetStream/chat#11390

## Linear

- CHA-1696

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 4.5 <[email protected]>

Author: totalimmersion

src/channel.ts

@@ -69,6 +69,7 @@ import type {
   StaticLocationPayload,
   TruncateChannelAPIResponse,
   TruncateOptions,
+  UnBanUserOptions,
   UpdateChannelAPIResponse,
   UpdateChannelOptions,
   UpdateLocationPayload,
@@ -1659,11 +1660,13 @@ export class Channel {
    * unbanUser - Removes the bans for a user on a channel
    *
    * @param {string} targetUserID
+   * @param {UnBanUserOptions} options
    * @returns {Promise<APIResponse>}
    */
-  async unbanUser(targetUserID: string) {
+  async unbanUser(targetUserID: string, options?: UnBanUserOptions) {
     this._checkInitialized();
     return await this.getClient().unbanUser(targetUserID, {
+      ...options,
       type: this.type,
       id: this.id,
     });

src/client.ts

@@ -106,6 +106,7 @@ import type {
   FlagsPaginationOptions,
   FlagsResponse,
   FlagUserResponse,
+  FutureChannelBansResponse,
   GetBlockedUsersAPIResponse,
   GetCampaignOptions,
   GetChannelTypeResponse,
@@ -166,6 +167,7 @@ import type {
   PushProviderUpsertResponse,
   QueryChannelsAPIResponse,
   QueryDraftsResponse,
+  QueryFutureChannelBansOptions,
   QueryMessageHistoryFilters,
   QueryMessageHistoryOptions,
   QueryMessageHistoryResponse,
@@ -1822,6 +1824,21 @@ export class StreamChat {
     });
   }
 
+  /**
+   * queryFutureChannelBans - Query future channel bans created by a user
+   *
+   * @param {QueryFutureChannelBansOptions} options Option object with user_id, exclude_expired_bans, limit, offset
+   * @returns {Promise<FutureChannelBansResponse>} Future Channel Bans Response
+   */
+  async queryFutureChannelBans(options: QueryFutureChannelBansOptions = {}) {
+    return await this.get<FutureChannelBansResponse>(
+      this.baseURL + '/query_future_channel_bans',
+      {
+        payload: options,
+      },
+    );
+  }
+
   /**
    * queryMessageFlags - Query message flags
    *

src/types.ts

@@ -284,6 +284,26 @@ export type BannedUsersResponse = APIResponse & {
   }>;
 };
 
+export type FutureChannelBan = {
+  user: UserResponse;
+  expires?: string;
+  reason?: string;
+  shadow?: boolean;
+  created_at: string;
+};
+
+export type FutureChannelBansResponse = APIResponse & {
+  bans: FutureChannelBan[];
+};
+
+export type QueryFutureChannelBansOptions = {
+  user_id?: string;
+  target_user_id?: string;
+  exclude_expired_bans?: boolean;
+  limit?: number;
+  offset?: number;
+};
+
 export type BlockListResponse = BlockList & {
   created_at?: string;
   type?: string;
@@ -994,6 +1014,7 @@ export type BannedUsersPaginationOptions = Omit<
 };
 
 export type BanUserOptions = UnBanUserOptions & {
+  ban_from_future_channels?: boolean;
   banned_by?: UserResponse;
   banned_by_id?: string;
   ip_ban?: boolean;
@@ -1493,6 +1514,7 @@ export type UnBanUserOptions = {
   client_id?: string;
   connection_id?: string;
   id?: string;
+  remove_future_channels_ban?: boolean;
   shadow?: boolean;
   target_user_id?: string;
   type?: string;