stream-chat 9.15.0 → 9.17.0

package/dist/types/channel_state.d.ts

@@ -175,7 +175,7 @@ export declare class ChannelState {
      * @param {UserResponse} user
      * @param {boolean} hardDelete
      */
-    deleteUserMessages: (user: UserResponse, hardDelete?: boolean) => void;
+    deleteUserMessages: (user: UserResponse, hardDelete?: boolean, deletedAt?: LocalMessage["deleted_at"]) => void;
     /**
      * filterErrorMessages - Removes error messages from the channel state.
      *

package/dist/types/client.d.ts

@@ -432,7 +432,7 @@ export declare class StreamChat {
      * @param {UserResponse} user
      * @param {boolean} hardDelete
      */
-    _deleteUserMessageReference: (user: UserResponse, hardDelete?: boolean) => void;
+    _deleteUserMessageReference: (user: UserResponse, hardDelete?: boolean, deletedAt?: LocalMessage["deleted_at"]) => void;
     /**
      * @private
      *

package/dist/types/events.d.ts

@@ -45,6 +45,7 @@ export declare const EVENT_MAP: {
     'typing.stop': boolean;
     'user.banned': boolean;
     'user.deleted': boolean;
+    'user.messages.deleted': boolean;
     'user.presence.changed': boolean;
     'user.unbanned': boolean;
     'user.unread_message_reminder': boolean;

package/dist/types/pagination/FilterBuilder.d.ts

@@ -0,0 +1,41 @@
+import { StateStore } from '../store';
+import type { ArrayOneOrMore, ArrayTwoOrMore, QueryFilter } from '../types';
+type ElementType<T> = T extends (infer U)[] ? U : T;
+export type ExtendedQueryFilter<T = string> = QueryFilter<T> & {
+    $autocomplete?: T extends string ? string : never;
+    $contains?: ElementType<T>;
+    $in?: ElementType<T>[];
+    $q?: T extends string ? string : never;
+};
+export type ExtendedQueryLogicalOperators<T> = {
+    $and?: ArrayOneOrMore<ExtendedQueryFilters<T>>;
+    $nor?: ArrayOneOrMore<ExtendedQueryFilters<T>>;
+    $or?: ArrayTwoOrMore<ExtendedQueryFilters<T>>;
+};
+export type ExtendedQueryFilters<T> = {
+    [K in keyof T]?: ExtendedQueryFilter<T[K]>;
+} & ExtendedQueryLogicalOperators<T>;
+export type FilterBuilderGenerators<TFilters, TContext extends Record<string, unknown> = {}> = {
+    [K in string]: {
+        enabled: boolean;
+        generate: (context: TContext) => Partial<TFilters> | null;
+    };
+};
+export type FilterBuilderOptions<TFilters, TContext extends Record<string, unknown>> = {
+    initialFilterConfig?: FilterBuilderGenerators<TFilters, TContext>;
+    initialContext?: TContext;
+};
+export declare class FilterBuilder<TFilters, TContext extends Record<string, unknown> = {}> {
+    filterConfig: StateStore<FilterBuilderGenerators<TFilters, TContext>>;
+    context: StateStore<TContext>;
+    constructor(params?: FilterBuilderOptions<TFilters, TContext>);
+    updateFilterConfig(config: Partial<FilterBuilderGenerators<TFilters, TContext>>): void;
+    enableFilter(filterKey: keyof FilterBuilderGenerators<TFilters, TContext>): void;
+    disableFilter(filterKey: keyof FilterBuilderGenerators<TFilters, TContext>): void;
+    updateContext(newContext: Partial<TContext>): void;
+    buildFilters(params?: {
+        context?: Partial<TContext>;
+        baseFilters?: Partial<TFilters>;
+    }): Partial<TFilters>;
+}
+export {};

package/dist/types/pagination/index.d.ts

@@ -1,2 +1,3 @@
 export * from './BasePaginator';
+export * from './FilterBuilder';
 export * from './ReminderPaginator';

package/dist/types/search/BaseSearchSource.d.ts

@@ -35,7 +35,7 @@ export interface SearchSourceSync<T = any> extends ISearchSource<T> {
 }
 declare abstract class BaseSearchSourceBase<T> implements ISearchSource<T> {
     state: StateStore<SearchSourceState<T>>;
-    protected pageSize: number;
+    pageSize: number;
     abstract readonly type: SearchSourceType;
     protected constructor(options?: SearchSourceOptions);
     get lastQueryError(): Error | undefined;

package/dist/types/search/ChannelSearchSource.d.ts

@@ -1,17 +1,25 @@
 import { BaseSearchSource } from './BaseSearchSource';
+import type { FilterBuilderOptions } from '../pagination';
+import { FilterBuilder } from '../pagination';
 import type { Channel } from '../channel';
 import type { StreamChat } from '../client';
 import type { ChannelFilters, ChannelOptions, ChannelSort } from '../types';
 import type { SearchSourceOptions } from './types';
-export declare class ChannelSearchSource extends BaseSearchSource<Channel> {
+type CustomContext = Record<string, unknown>;
+export type ChannelSearchSourceFilterBuilderContext<C extends CustomContext = CustomContext> = {
+    searchQuery?: string;
+} & C;
+export declare class ChannelSearchSource<TFilterContext extends CustomContext = CustomContext> extends BaseSearchSource<Channel> {
     readonly type = "channels";
-    private client;
+    client: StreamChat;
     filters: ChannelFilters | undefined;
     sort: ChannelSort | undefined;
     searchOptions: Omit<ChannelOptions, 'limit' | 'offset'> | undefined;
-    constructor(client: StreamChat, options?: SearchSourceOptions);
+    filterBuilder: FilterBuilder<ChannelFilters, ChannelSearchSourceFilterBuilderContext<TFilterContext>>;
+    constructor(client: StreamChat, options?: SearchSourceOptions, filterBuilderOptions?: FilterBuilderOptions<ChannelFilters, ChannelSearchSourceFilterBuilderContext<TFilterContext>>);
     protected query(searchQuery: string): Promise<{
         items: Channel[];
     }>;
     protected filterQueryResults(items: Channel[]): Channel[];
 }
+export {};

package/dist/types/search/MessageSearchSource.d.ts

@@ -2,7 +2,31 @@ import { BaseSearchSource } from './BaseSearchSource';
 import type { ChannelFilters, ChannelOptions, ChannelSort, MessageFilters, MessageResponse, SearchMessageSort } from '../types';
 import type { StreamChat } from '../client';
 import type { SearchSourceOptions } from './types';
-export declare class MessageSearchSource extends BaseSearchSource<MessageResponse> {
+import { FilterBuilder, type FilterBuilderOptions } from '../pagination';
+type CustomContext = Record<string, unknown>;
+type BuiltInContexts = {
+    messageSearchChannel: {
+        searchQuery?: string;
+    };
+    messageSearch: {
+        searchQuery?: string;
+    };
+    channelQuery: {
+        cids?: string[];
+    };
+};
+type MergeContext<B extends Record<string, unknown>, C extends CustomContext | undefined> = B & (C extends object ? C : {});
+type MessageSearchSourceContexts = Partial<{
+    messageSearchChannelContext: Record<string, unknown>;
+    messageSearchContext: Record<string, unknown>;
+    channelQueryContext: Record<string, unknown>;
+}>;
+export type MessageSearchSourceFilterBuilderOptions<TContexts extends MessageSearchSourceContexts = {}> = Partial<{
+    messageSearchChannel: FilterBuilderOptions<ChannelFilters, MergeContext<BuiltInContexts['messageSearchChannel'], TContexts['messageSearchChannelContext']>>;
+    messageSearch: FilterBuilderOptions<MessageFilters, MergeContext<BuiltInContexts['messageSearch'], TContexts['messageSearchContext']>>;
+    channelQuery: FilterBuilderOptions<ChannelFilters, MergeContext<BuiltInContexts['channelQuery'], TContexts['channelQueryContext']>>;
+}>;
+export declare class MessageSearchSource<TContexts extends MessageSearchSourceContexts = {}> extends BaseSearchSource<MessageResponse> {
     readonly type = "messages";
     private client;
     messageSearchChannelFilters: ChannelFilters | undefined;
@@ -11,7 +35,10 @@ export declare class MessageSearchSource extends BaseSearchSource<MessageRespons
     channelQueryFilters: ChannelFilters | undefined;
     channelQuerySort: ChannelSort | undefined;
     channelQueryOptions: Omit<ChannelOptions, 'limit' | 'offset'> | undefined;
-    constructor(client: StreamChat, options?: SearchSourceOptions);
+    messageSearchChannelFilterBuilder: FilterBuilder<ChannelFilters, MergeContext<BuiltInContexts['messageSearchChannel'], TContexts['messageSearchChannelContext']>>;
+    messageSearchFilterBuilder: FilterBuilder<MessageFilters, MergeContext<BuiltInContexts['messageSearch'], TContexts['messageSearchContext']>>;
+    channelQueryFilterBuilder: FilterBuilder<ChannelFilters, MergeContext<BuiltInContexts['channelQuery'], TContexts['channelQueryContext']>>;
+    constructor(client: StreamChat, options?: SearchSourceOptions, filterBuilderOptions?: MessageSearchSourceFilterBuilderOptions<TContexts>);
     protected query(searchQuery: string): Promise<{
         items: never[];
         next?: undefined;
@@ -21,3 +48,4 @@ export declare class MessageSearchSource extends BaseSearchSource<MessageRespons
     }>;
     protected filterQueryResults(items: MessageResponse[]): MessageResponse[];
 }
+export {};

package/dist/types/search/UserSearchSource.d.ts

@@ -1,16 +1,23 @@
 import { BaseSearchSource } from './BaseSearchSource';
+import { FilterBuilder, type FilterBuilderOptions } from '../pagination';
 import type { StreamChat } from '../client';
 import type { UserFilters, UserOptions, UserResponse, UserSort } from '../types';
 import type { SearchSourceOptions } from './types';
-export declare class UserSearchSource extends BaseSearchSource<UserResponse> {
+type CustomContext = Record<string, unknown>;
+export type UserSearchSourceFilterBuilderContext<C extends CustomContext = CustomContext> = {
+    searchQuery?: string;
+} & C;
+export declare class UserSearchSource<TFilterContext extends CustomContext = CustomContext> extends BaseSearchSource<UserResponse> {
     readonly type = "users";
-    private client;
+    client: StreamChat;
     filters: UserFilters | undefined;
     sort: UserSort | undefined;
     searchOptions: Omit<UserOptions, 'limit' | 'offset'> | undefined;
-    constructor(client: StreamChat, options?: SearchSourceOptions);
+    filterBuilder: FilterBuilder<UserFilters, UserSearchSourceFilterBuilderContext<TFilterContext>>;
+    constructor(client: StreamChat, options?: SearchSourceOptions, filterBuilderOptions?: FilterBuilderOptions<UserFilters, UserSearchSourceFilterBuilderContext<TFilterContext>>);
     protected query(searchQuery: string): Promise<{
         items: UserResponse[];
     }>;
     protected filterQueryResults(items: UserResponse[]): UserResponse[];
 }
+export {};

package/dist/types/search/index.d.ts

@@ -1,6 +1,6 @@
 export * from './BaseSearchSource';
 export * from './SearchController';
-export { UserSearchSource } from './UserSearchSource';
-export { ChannelSearchSource } from './ChannelSearchSource';
-export { MessageSearchSource } from './MessageSearchSource';
+export * from './UserSearchSource';
+export * from './ChannelSearchSource';
+export * from './MessageSearchSource';
 export * from './types';

package/dist/types/types.d.ts

@@ -236,6 +236,7 @@ export type ChannelResponse = CustomChannelData & {
     last_message_at?: string;
     member_count?: number;
     members?: ChannelMemberResponse[];
+    message_count?: number;
     muted?: boolean;
     mute_expires_at?: string;
     own_capabilities?: string[];
@@ -1250,6 +1251,8 @@ export type Event = CustomEventData & {
     ai_message?: string;
     ai_state?: AIState;
     channel?: ChannelResponse;
+    channel_custom?: CustomChannelData;
+    channel_member_count?: number;
     channel_id?: string;
     channel_type?: string;
     cid?: string;
@@ -1837,6 +1840,7 @@ export type ChannelConfigFields = {
     replies?: boolean;
     search?: boolean;
     shared_locations?: boolean;
+    count_messages?: boolean;
     typing_events?: boolean;
     uploads?: boolean;
     url_enrichment?: boolean;

package/dist/types/utils.d.ts

@@ -1,5 +1,5 @@
 import FormData from 'form-data';
-import type { AscDesc, ChannelFilters, ChannelQueryOptions, ChannelSort, ChannelSortBase, LocalMessage, Logger, Message, MessagePaginationOptions, MessageResponse, MessageResponseBase, MessageSet, OwnUserResponse, PromoteChannelParams, UpdatedMessage, UserResponse } from './types';
+import type { AscDesc, ChannelFilters, ChannelQueryOptions, ChannelSort, ChannelSortBase, LocalMessage, LocalMessageBase, Logger, Message, MessagePaginationOptions, MessageResponse, MessageResponseBase, MessageSet, OwnUserResponse, PromoteChannelParams, ReactionGroupResponse, UpdatedMessage, UserResponse } from './types';
 import type { StreamChat } from './client';
 import type { Channel } from './channel';
 import type { AxiosRequestConfig } from 'axios';
@@ -63,6 +63,91 @@ export declare function formatMessage(message: MessageResponse | MessageResponse
 export declare function unformatMessage(message: LocalMessage): MessageResponse;
 export declare const localMessageToNewMessagePayload: (localMessage: LocalMessage) => Message;
 export declare const toUpdatedMessagePayload: (message: LocalMessage | Partial<MessageResponse>) => UpdatedMessage;
+export declare const toDeletedMessage: ({ message, deletedAt, hardDelete, }: {
+    message: LocalMessage | LocalMessageBase;
+    deletedAt: LocalMessage["deleted_at"];
+    hardDelete: boolean;
+}) => {
+    attachments: never[];
+    cid: string | undefined;
+    created_at: Date;
+    deleted_at: Date | null;
+    id: string;
+    latest_reactions: never[];
+    mentioned_users: never[];
+    own_reactions: never[];
+    parent_id: string | undefined;
+    reply_count: number | undefined;
+    status: string;
+    thread_participants: UserResponse[] | undefined;
+    type: "deleted";
+    updated_at: Date;
+    user: UserResponse | null | undefined;
+} | {
+    attachments: never[];
+    type: string;
+    deleted_at: Date | null;
+    id: string;
+    html?: string | undefined;
+    mml?: string | undefined;
+    parent_id?: string | undefined;
+    pin_expires?: string | null | undefined;
+    pinned?: boolean | undefined;
+    poll_id?: string | undefined;
+    quoted_message_id?: string | undefined;
+    restricted_visibility?: string[] | undefined;
+    show_in_channel?: boolean | undefined;
+    silent?: boolean | undefined;
+    text?: string | undefined;
+    user?: (UserResponse | null) | undefined;
+    user_id?: string | undefined;
+    args?: string | undefined;
+    before_message_send_failed?: boolean | undefined;
+    channel?: import("./types").ChannelResponse | undefined;
+    cid?: string | undefined;
+    command?: string | undefined;
+    command_info?: {
+        name?: string;
+    } | undefined;
+    deleted_reply_count?: number | undefined;
+    i18n?: (import("./types").RequireAtLeastOne<Record<`${import("./types").TranslationLanguages}_text`, string>> & {
+        language: import("./types").TranslationLanguages;
+    }) | undefined;
+    latest_reactions?: import("./types").ReactionResponse[] | undefined;
+    mentioned_users?: UserResponse[] | undefined;
+    message_text_updated_at?: string | undefined;
+    moderation?: import("./types").ModerationResponse | undefined;
+    moderation_details?: import("./types").ModerationDetailsResponse | undefined;
+    own_reactions?: import("./types").ReactionResponse[] | null | undefined;
+    pinned_by?: (UserResponse | null) | undefined;
+    poll?: import("./types").PollResponse | undefined;
+    reaction_counts?: {
+        [key: string]: number;
+    } | null | undefined;
+    reaction_groups?: {
+        [key: string]: ReactionGroupResponse;
+    } | null | undefined;
+    reaction_scores?: {
+        [key: string]: number;
+    } | null | undefined;
+    reminder?: import("./types").ReminderResponseBase | undefined;
+    reply_count?: number | undefined;
+    shadowed?: boolean | undefined;
+    shared_location?: import("./types").SharedLocationResponse | undefined;
+    thread_participants?: UserResponse[] | undefined;
+    created_at: Date;
+    pinned_at: Date | null;
+    status: string;
+    updated_at: Date;
+    error?: import("./types").ErrorFromResponse<import("./types").APIErrorResponse>;
+    quoted_message?: LocalMessageBase;
+};
+export declare const deleteUserMessages: ({ messages, user, hardDelete, deletedAt, }: {
+    messages: Array<LocalMessage>;
+    user: UserResponse;
+    hardDelete: boolean;
+    deletedAt: LocalMessage["deleted_at"];
+}) => void;
 export declare const findIndexInSortedArray: <T, L>({ needle, sortedArray, selectKey, selectValueToCompare, sortDirection, }: {
     needle: T;
     sortedArray: readonly T[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stream-chat",
-  "version": "9.15.0",
+  "version": "9.17.0",
   "description": "JS SDK for the Stream Chat API",
   "homepage": "https://getstream.io/chat/",
   "author": {
@@ -56,7 +56,7 @@
     "form-data": "^4.0.4",
     "isomorphic-ws": "^5.0.0",
     "jsonwebtoken": "^9.0.2",
-    "linkifyjs": "^4.2.0",
+    "linkifyjs": "^4.3.2",
     "ws": "^8.18.1"
   },
   "devDependencies": {

package/src/channel.ts

@@ -1903,6 +1903,15 @@ export class Channel {
           }
         }
         break;
+      case 'user.messages.deleted':
+        if (event.user) {
+          this.state.deleteUserMessages(
+            event.user,
+            !!event.hard_delete,
+            new Date(event.created_at ?? Date.now()),
+          );
+        }
+        break;
       case 'message.new':
         if (event.message) {
           /* if message belongs to current user, always assume timestamp is changed to filter it out and add again to avoid duplication */

package/src/channel_state.ts

@@ -11,7 +11,11 @@ import type {
   ReactionResponse,
   UserResponse,
 } from './types';
-import { addToMessageList, formatMessage } from './utils';
+import {
+  deleteUserMessages as _deleteUserMessages,
+  addToMessageList,
+  formatMessage,
+} from './utils';
 import { DEFAULT_MESSAGE_SET_PAGINATION } from './constants';
 
 type ChannelReadStatus = Record<
@@ -712,58 +716,30 @@ export class ChannelState {
    * @param {UserResponse} user
    * @param {boolean} hardDelete
    */
-  deleteUserMessages = (user: UserResponse, hardDelete = false) => {
-    const _deleteUserMessages = (
-      messages: Array<ReturnType<ChannelState['formatMessage']>>,
-      user: UserResponse,
-      hardDelete = false,
-    ) => {
-      for (let i = 0; i < messages.length; i++) {
-        const m = messages[i];
-        if (m.user?.id !== user.id) {
-          continue;
-        }
-
-        if (hardDelete) {
-          /**
-           * In case of hard delete, we need to strip down all text, html,
-           * attachments and all the custom properties on message
-           */
-          messages[i] = {
-            cid: m.cid,
-            created_at: m.created_at,
-            deleted_at: user.deleted_at,
-            id: m.id,
-            latest_reactions: [],
-            mentioned_users: [],
-            own_reactions: [],
-            parent_id: m.parent_id,
-            reply_count: m.reply_count,
-            status: m.status,
-            thread_participants: m.thread_participants,
-            type: 'deleted',
-            updated_at: m.updated_at,
-            user: m.user,
-          } as unknown as ReturnType<ChannelState['formatMessage']>;
-        } else {
-          messages[i] = {
-            ...m,
-            type: 'deleted',
-            deleted_at: user.deleted_at ? new Date(user.deleted_at) : null,
-          };
-        }
-      }
-    };
-
-    this.messageSets.forEach((set) =>
-      _deleteUserMessages(set.messages, user, hardDelete),
+  deleteUserMessages = (
+    user: UserResponse,
+    hardDelete = false,
+    deletedAt?: LocalMessage['deleted_at'],
+  ) => {
+    this.messageSets.forEach(({ messages }) =>
+      _deleteUserMessages({ messages, user, hardDelete, deletedAt: deletedAt ?? null }),
     );
 
     for (const parentId in this.threads) {
-      _deleteUserMessages(this.threads[parentId], user, hardDelete);
+      _deleteUserMessages({
+        messages: this.threads[parentId],
+        user,
+        hardDelete,
+        deletedAt: deletedAt ?? null,
+      });
     }
 
-    _deleteUserMessages(this.pinnedMessages, user, hardDelete);
+    _deleteUserMessages({
+      messages: this.pinnedMessages,
+      user,
+      hardDelete,
+      deletedAt: deletedAt ?? null,
+    });
   };
 
   /**

package/src/client.ts

@@ -1404,7 +1404,11 @@ export class StreamChat {
    * @param {UserResponse} user
    * @param {boolean} hardDelete
    */
-  _deleteUserMessageReference = (user: UserResponse, hardDelete = false) => {
+  _deleteUserMessageReference = (
+    user: UserResponse,
+    hardDelete = false,
+    deletedAt?: LocalMessage['deleted_at'],
+  ) => {
     const refMap = this.state.userChannelReferences[user.id] || {};
 
     for (const channelID in refMap) {
@@ -1413,7 +1417,7 @@ export class StreamChat {
         const state = channel.state;
 
         /** deleted the messages from this user. */
-        state?.deleteUserMessages(user, hardDelete);
+        state?.deleteUserMessages(user, hardDelete, deletedAt);
       }
     }
   };
@@ -1478,7 +1482,11 @@ export class StreamChat {
       event.user.deleted_at &&
       (event.mark_messages_deleted || event.hard_delete)
     ) {
-      this._deleteUserMessageReference(event.user, event.hard_delete);
+      this._deleteUserMessageReference(
+        event.user,
+        event.hard_delete,
+        event.user.deleted_at ? new Date(event.user.deleted_at) : null,
+      );
     }
   };
 
@@ -1503,6 +1511,14 @@ export class StreamChat {
       this._handleUserEvent(event);
     }
 
+    if (event.type === 'user.messages.deleted' && !event.cid && event.user) {
+      this._deleteUserMessageReference(
+        event.user,
+        event.hard_delete,
+        event.created_at ? new Date(event.created_at) : null,
+      );
+    }
+
     if (event.type === 'health.check' && event.me) {
       client.user = event.me;
       client.state.updateUser(event.me);

package/src/events.ts

@@ -45,6 +45,7 @@ export const EVENT_MAP = {
   'typing.stop': true,
   'user.banned': true,
   'user.deleted': true,
+  'user.messages.deleted': true,
   'user.presence.changed': true,
   'user.unbanned': true,
   'user.unread_message_reminder': true,

package/src/pagination/FilterBuilder.ts

@@ -0,0 +1,104 @@
+import { StateStore } from '../store';
+import type { ArrayOneOrMore, ArrayTwoOrMore, QueryFilter } from '../types';
+
+type ElementType<T> = T extends (infer U)[] ? U : T;
+
+// redeclared because QueryFilter does not account for the additional operators
+export type ExtendedQueryFilter<T = string> = QueryFilter<T> & {
+  $autocomplete?: T extends string ? string : never;
+  $contains?: ElementType<T>;
+  $in?: ElementType<T>[];
+  $q?: T extends string ? string : never;
+};
+
+export type ExtendedQueryLogicalOperators<T> = {
+  $and?: ArrayOneOrMore<ExtendedQueryFilters<T>>;
+  $nor?: ArrayOneOrMore<ExtendedQueryFilters<T>>;
+  $or?: ArrayTwoOrMore<ExtendedQueryFilters<T>>;
+};
+
+export type ExtendedQueryFilters<T> = {
+  [K in keyof T]?: ExtendedQueryFilter<T[K]>;
+} & ExtendedQueryLogicalOperators<T>;
+
+export type FilterBuilderGenerators<
+  TFilters,
+  TContext extends Record<string, unknown> = {},
+> = {
+  [K in string]: {
+    enabled: boolean;
+    generate: (context: TContext) => Partial<TFilters> | null;
+  };
+};
+
+export type FilterBuilderOptions<TFilters, TContext extends Record<string, unknown>> = {
+  initialFilterConfig?: FilterBuilderGenerators<TFilters, TContext>;
+  initialContext?: TContext;
+};
+
+export class FilterBuilder<TFilters, TContext extends Record<string, unknown> = {}> {
+  filterConfig: StateStore<FilterBuilderGenerators<TFilters, TContext>>;
+  context: StateStore<TContext>;
+
+  constructor(params?: FilterBuilderOptions<TFilters, TContext>) {
+    this.context = new StateStore(params?.initialContext ?? ({} as TContext));
+    this.filterConfig = new StateStore(
+      params?.initialFilterConfig ?? ({} as FilterBuilderGenerators<TFilters, TContext>),
+    );
+  }
+
+  updateFilterConfig(config: Partial<FilterBuilderGenerators<TFilters, TContext>>) {
+    this.filterConfig.partialNext(config);
+  }
+
+  enableFilter(filterKey: keyof FilterBuilderGenerators<TFilters, TContext>) {
+    const config = this.filterConfig.getLatestValue();
+    if (config[filterKey]) {
+      this.filterConfig.partialNext({
+        [filterKey]: {
+          ...config[filterKey],
+          enabled: true,
+        },
+      });
+    }
+  }
+
+  disableFilter(filterKey: keyof FilterBuilderGenerators<TFilters, TContext>) {
+    const config = this.filterConfig.getLatestValue();
+    if (config[filterKey]) {
+      this.filterConfig.partialNext({
+        [filterKey]: {
+          ...config[filterKey],
+          enabled: false,
+        },
+      });
+    }
+  }
+
+  updateContext(newContext: Partial<TContext>) {
+    this.context.partialNext(newContext);
+  }
+
+  buildFilters(params?: {
+    context?: Partial<TContext>;
+    baseFilters?: Partial<TFilters>;
+  }): Partial<TFilters> {
+    const filters: Partial<TFilters> = {
+      ...(params?.baseFilters ?? {}),
+    } as Partial<TFilters>;
+
+    const filterConfig = this.filterConfig.getLatestValue();
+    for (const key in filterConfig) {
+      const configItem = filterConfig[key];
+      if (!configItem?.enabled) continue;
+
+      const generated = configItem.generate({
+        ...this.context.getLatestValue(),
+        ...(params?.context ?? {}),
+      });
+      if (generated) Object.assign(filters, generated);
+    }
+
+    return filters;
+  }
+}

package/src/pagination/index.ts

@@ -1,2 +1,3 @@
 export * from './BasePaginator';
+export * from './FilterBuilder';
 export * from './ReminderPaginator';

package/src/search/BaseSearchSource.ts

@@ -59,7 +59,7 @@ const DEFAULT_SEARCH_SOURCE_OPTIONS: Required<SearchSourceOptions> = {
 
 abstract class BaseSearchSourceBase<T> implements ISearchSource<T> {
   state: StateStore<SearchSourceState<T>>;
-  protected pageSize: number;
+  pageSize: number;
   abstract readonly type: SearchSourceType;
 
   protected constructor(options?: SearchSourceOptions) {