stream-chat 9.31.0 → 9.32.0

package/dist/types/client.d.ts

@@ -8,7 +8,7 @@ import { WSConnectionFallback } from './connection_fallback';
 import { Campaign } from './campaign';
 import { ChannelBatchUpdater } from './channel_batch_updater';
 import { Segment } from './segment';
-import type { ActiveLiveLocationsAPIResponse, APIErrorResponse, APIResponse, AppSettings, AppSettingsAPIResponse, BannedUsersFilters, BannedUsersPaginationOptions, BannedUsersResponse, BannedUsersSort, BanUserOptions, BaseDeviceFields, BlockList, BlockListResponse, BlockUserAPIResponse, CampaignData, CampaignFilters, CampaignQueryOptions, CampaignResponse, CampaignSort, CastVoteAPIResponse, ChannelAPIResponse, ChannelData, ChannelFilters, ChannelMute, ChannelOptions, ChannelResponse, ChannelSort, ChannelStateOptions, CheckPushResponse, CheckSNSResponse, CheckSQSResponse, Configs, ConnectAPIResponse, CreateChannelOptions, CreateChannelResponse, CreateCommandOptions, CreateCommandResponse, CreateImportOptions, CreateImportResponse, CreateImportURLResponse, CreatePollAPIResponse, CreatePollData, CreatePollOptionAPIResponse, CreatePredefinedFilterOptions, CreateReminderOptions, CustomPermissionOptions, DeactivateUsersOptions, DeleteCommandResponse, DeleteMessageOptions, DeleteUserOptions, Device, DeviceIdentifier, DraftFilters, DraftSort, EndpointName, Event, EventAPIResponse, EventHandler, ExportChannelOptions, ExportChannelRequest, ExportChannelResponse, ExportChannelStatusResponse, ExportUsersRequest, ExportUsersResponse, FlagMessageResponse, FlagReportsFilters, FlagReportsPaginationOptions, FlagReportsResponse, FlagsFilters, FlagsPaginationOptions, FlagsResponse, FlagUserResponse, FutureChannelBansResponse, GetBlockedUsersAPIResponse, GetCampaignOptions, GetChannelTypeResponse, GetCommandResponse, GetHookEventsResponse, GetImportResponse, GetMessageOptions, GetPollAPIResponse, GetRateLimitsResponse, GetThreadAPIResponse, GetThreadOptions, GetUnreadCountAPIResponse, GetUnreadCountBatchAPIResponse, ListChannelResponse, ListCommandsResponse, ListImportsPaginationOptions, ListImportsResponse, ListPredefinedFiltersOptions, ListPredefinedFiltersResponse, LocalMessage, Logger, MarkChannelsReadOptions, MarkDeliveredOptions, MessageFilters, MessageFlagsFilters, MessageFlagsPaginationOptions, MessageFlagsResponse, MessageResponse, Mute, MuteUserOptions, MuteUserResponse, OGAttachment, OwnUserResponse, Pager, PartialMessageUpdate, PartialPollUpdate, PartialThreadUpdate, PartialUserUpdate, PermissionAPIResponse, PermissionsAPIResponse, PollAnswersAPIResponse, PollData, PollOptionData, PollSort, PollVote, PollVoteData, PollVotesAPIResponse, PredefinedFilterResponse, Product, PushPreference, PushProvider, PushProviderConfig, PushProviderID, PushProviderListResponse, PushProviderUpsertResponse, QueryDraftsResponse, QueryFutureChannelBansOptions, QueryMessageHistoryFilters, QueryMessageHistoryOptions, QueryMessageHistoryResponse, QueryMessageHistorySort, QueryPollsFilters, QueryPollsOptions, QueryPollsResponse, QueryReactionsAPIResponse, QueryReactionsOptions, QueryRemindersOptions, QueryRemindersResponse, QuerySegmentsOptions, QuerySegmentTargetsFilter, QueryThreadsOptions, QueryVotesFilters, QueryVotesOptions, ReactionFilters, ReactionResponse, ReactionSort, ReactivateUserOptions, ReactivateUsersOptions, ReminderAPIResponse, ReviewFlagReportOptions, ReviewFlagReportResponse, SdkIdentifier, SearchAPIResponse, SearchOptions, SegmentData, SegmentResponse, SegmentTargetsResponse, SegmentType, SendFileAPIResponse, SharedLocationResponse, SortParam, StreamChatOptions, SyncOptions, SyncResponse, TaskResponse, TaskStatus, TestPushDataInput, TestSNSDataInput, TestSQSDataInput, TokenOrProvider, TranslateResponse, UnBanUserOptions, UpdateChannelsBatchOptions, UpdateChannelTypeRequest, UpdateChannelTypeResponse, UpdateCommandOptions, UpdateCommandResponse, UpdateLocationPayload, UpdateMessageAPIResponse, UpdateMessageOptions, UpdatePollAPIResponse, UpdatePredefinedFilterOptions, UpdateReminderOptions, UpdateSegmentData, UpdateUsersAPIResponse, UpsertPushPreferencesResponse, UserCustomEvent, UserFilters, UserOptions, UserResponse, UserSort, VoteSort } from './types';
+import type { ActiveLiveLocationsAPIResponse, APIErrorResponse, APIResponse, AppSettings, AppSettingsAPIResponse, BannedUsersFilters, BannedUsersPaginationOptions, BannedUsersResponse, BannedUsersSort, BanUserOptions, BaseDeviceFields, BlockList, BlockListResponse, BlockUserAPIResponse, CampaignData, CampaignFilters, CampaignQueryOptions, CampaignResponse, CampaignSort, CastVoteAPIResponse, ChannelAPIResponse, ChannelData, ChannelFilters, ChannelMute, ChannelOptions, ChannelResponse, ChannelSort, ChannelStateOptions, CheckPushResponse, CheckSNSResponse, CheckSQSResponse, Configs, ConnectAPIResponse, CreateChannelOptions, CreateChannelResponse, CreateCommandOptions, CreateCommandResponse, CreateImportOptions, CreateImportResponse, CreateImportURLResponse, CreatePollAPIResponse, CreatePollData, CreatePollOptionAPIResponse, CreatePredefinedFilterOptions, CreateReminderOptions, CustomPermissionOptions, DeactivateUsersOptions, DeleteCommandResponse, DeleteMessageOptions, DeleteUserOptions, Device, DeviceIdentifier, DraftFilters, DraftSort, EndpointName, Event, EventAPIResponse, EventHandler, ExportChannelOptions, ExportChannelRequest, ExportChannelResponse, ExportChannelStatusResponse, ExportUsersRequest, ExportUsersResponse, FlagMessageResponse, FlagReportsFilters, FlagReportsPaginationOptions, FlagReportsResponse, FlagsFilters, FlagsPaginationOptions, FlagsResponse, FlagUserResponse, FutureChannelBansResponse, GetBlockedUsersAPIResponse, GetCampaignOptions, GetChannelTypeResponse, GetCommandResponse, GetHookEventsResponse, GetImportResponse, GetMessageOptions, GetPollAPIResponse, GetRateLimitsResponse, GetThreadAPIResponse, GetThreadOptions, GetUnreadCountAPIResponse, GetUnreadCountBatchAPIResponse, ListChannelResponse, ListCommandsResponse, ListImportsPaginationOptions, ListImportsResponse, ListPredefinedFiltersOptions, ListPredefinedFiltersResponse, LocalMessage, Logger, MarkChannelsReadOptions, MarkDeliveredOptions, MessageFilters, MessageFlagsFilters, MessageFlagsPaginationOptions, MessageFlagsResponse, MessageResponse, Mute, MuteUserOptions, MuteUserResponse, OGAttachment, OwnUserResponse, Pager, PartialMessageUpdate, PartialPollUpdate, PartialThreadUpdate, PartialUserUpdate, PermissionAPIResponse, PermissionsAPIResponse, PollAnswersAPIResponse, PollData, PollOptionData, PollSort, PollVote, PollVoteData, PollVotesAPIResponse, PredefinedFilterResponse, Product, PushPreference, PushProvider, PushProviderConfig, PushProviderID, PushProviderListResponse, PushProviderUpsertResponse, QueryDraftsResponse, QueryFutureChannelBansOptions, QueryMessageHistoryFilters, QueryMessageHistoryOptions, QueryMessageHistoryResponse, QueryMessageHistorySort, QueryPollsFilters, QueryPollsOptions, QueryPollsResponse, QueryReactionsAPIResponse, QueryReactionsOptions, QueryRemindersOptions, QueryRemindersResponse, QuerySegmentsOptions, QuerySegmentTargetsFilter, QueryTeamUsageStatsOptions, QueryTeamUsageStatsResponse, QueryThreadsOptions, QueryVotesFilters, QueryVotesOptions, ReactionFilters, ReactionResponse, ReactionSort, ReactivateUserOptions, ReactivateUsersOptions, ReminderAPIResponse, ReviewFlagReportOptions, ReviewFlagReportResponse, SdkIdentifier, SearchAPIResponse, SearchOptions, SegmentData, SegmentResponse, SegmentTargetsResponse, SegmentType, SendFileAPIResponse, SharedLocationResponse, SortParam, StreamChatOptions, SyncOptions, SyncResponse, TaskResponse, TaskStatus, TestPushDataInput, TestSNSDataInput, TestSQSDataInput, TokenOrProvider, TranslateResponse, UnBanUserOptions, UpdateChannelsBatchOptions, UpdateChannelTypeRequest, UpdateChannelTypeResponse, UpdateCommandOptions, UpdateCommandResponse, UpdateLocationPayload, UpdateMessageAPIResponse, UpdateMessageOptions, UpdatePollAPIResponse, UpdatePredefinedFilterOptions, UpdateReminderOptions, UpdateSegmentData, UpdateUsersAPIResponse, UpsertPushPreferencesResponse, UserCustomEvent, UserFilters, UserOptions, UserResponse, UserSort, VoteSort } from './types';
 import { ErrorFromResponse } from './types';
 import { InsightMetrics } from './insights';
 import { Thread } from './thread';
@@ -1018,6 +1018,7 @@ export declare class StreamChat {
         latest_reactions?: ReactionResponse[];
         member?: import("./types").ChannelMemberResponse;
         mentioned_users?: UserResponse[];
+        mentioned_channel?: boolean;
         message_text_updated_at?: string;
         moderation?: import("./types").ModerationResponse;
         moderation_details?: import("./types").ModerationDetailsResponse;
@@ -1711,6 +1712,7 @@ export declare class StreamChat {
         latest_reactions?: ReactionResponse[];
         member?: import("./types").ChannelMemberResponse;
         mentioned_users?: UserResponse[];
+        mentioned_channel?: boolean;
         message_text_updated_at?: string;
         moderation?: import("./types").ModerationResponse;
         moderation_details?: import("./types").ModerationDetailsResponse;
@@ -1930,6 +1932,22 @@ export declare class StreamChat {
      * @returns {Promise<QueryRemindersResponse>}
      */
     queryReminders({ filter, sort, ...rest }?: QueryRemindersOptions): Promise<QueryRemindersResponse>;
+    /**
+     * queryTeamUsageStats - Queries team-level usage statistics from the warehouse database
+     *
+     * Returns all 16 metrics grouped by team with cursor-based pagination.
+     *
+     * Date Range Options (mutually exclusive):
+     * - Use 'month' parameter (YYYY-MM format) for monthly aggregated values
+     * - Use 'start_date'/'end_date' parameters (YYYY-MM-DD format) for daily breakdown
+     * - If neither provided, defaults to current month (monthly mode)
+     *
+     * This endpoint is server-side only.
+     *
+     * @param {QueryTeamUsageStatsOptions} options The options for querying team usage stats
+     * @returns {Promise<QueryTeamUsageStatsResponse>}
+     */
+    queryTeamUsageStats(options?: QueryTeamUsageStatsOptions): Promise<QueryTeamUsageStatsResponse>;
     /**
      * updateLocation - Updates a location
      *

package/dist/types/messageComposer/attachmentIdentity.d.ts

@@ -1,5 +1,5 @@
 import type { Attachment, SharedLocationResponse } from '../types';
-import type { AudioAttachment, FileAttachment, ImageAttachment, LocalAttachment, LocalAudioAttachment, LocalFileAttachment, LocalImageAttachment, LocalUploadAttachment, LocalVideoAttachment, LocalVoiceRecordingAttachment, UploadedAttachment, VideoAttachment, VoiceRecordingAttachment } from './types';
+import type { AudioAttachment, FileAttachment, GiphyAttachment, ImageAttachment, LocalAttachment, LocalAudioAttachment, LocalFileAttachment, LocalImageAttachment, LocalUploadAttachment, LocalVideoAttachment, LocalVoiceRecordingAttachment, UploadedAttachment, VideoAttachment, VoiceRecordingAttachment } from './types';
 export declare const isScrapedContent: (attachment: Attachment) => boolean;
 export declare const isLocalAttachment: (attachment: unknown) => attachment is LocalAttachment;
 export declare const isLocalUploadAttachment: (attachment: unknown) => attachment is LocalUploadAttachment;
@@ -15,3 +15,4 @@ export declare const isVideoAttachment: (attachment: Attachment | LocalAttachmen
 export declare const isLocalVideoAttachment: (attachment: Attachment | LocalAttachment) => attachment is LocalVideoAttachment;
 export declare const isUploadedAttachment: (attachment: Attachment) => attachment is UploadedAttachment;
 export declare const isSharedLocationResponse: (location: unknown) => location is SharedLocationResponse;
+export declare const isGiphyAttachment: (attachment: Attachment) => attachment is GiphyAttachment;

package/dist/types/messageComposer/middleware/textComposer/commands.d.ts

@@ -21,12 +21,12 @@ export declare class CommandSearchSource extends BaseSearchSourceSync<CommandSug
     };
     query(searchQuery: string): {
         items: {
-            id: "all" | "mute" | "unmute" | "giphy" | "ban" | "fun_set" | "moderation_set" | "unban";
+            id: "all" | "giphy" | "mute" | "unmute" | "ban" | "fun_set" | "moderation_set" | "unban";
             created_at?: string | undefined;
             updated_at?: string | undefined;
             args?: string;
             description?: string;
-            name: "all" | "mute" | "unmute" | "giphy" | "ban" | "fun_set" | "moderation_set" | "unban";
+            name: "all" | "giphy" | "mute" | "unmute" | "ban" | "fun_set" | "moderation_set" | "unban";
             set?: import("../../..").CommandVariants;
         }[];
         next: null;

package/dist/types/messageComposer/types.d.ts

@@ -1,4 +1,4 @@
-import type { Attachment, FileUploadConfig } from '../types';
+import type { Attachment, FileUploadConfig, GiphyData } from '../types';
 export type LocalAttachment = AnyLocalAttachment | LocalUploadAttachment;
 export type LocalUploadAttachment = LocalFileAttachment | LocalImageAttachment | LocalAudioAttachment | LocalVideoAttachment | LocalVoiceRecordingAttachment;
 export type LocalVoiceRecordingAttachment<CustomLocalMetadata = Record<string, unknown>> = LocalAttachmentCast<VoiceRecordingAttachment, LocalAttachmentUploadMetadata & CustomLocalMetadata>;
@@ -50,6 +50,13 @@ export type ImageAttachment = Attachment & {
     original_height?: number;
     original_width?: number;
 };
+export type GiphyAttachment = Attachment & {
+    type: 'giphy';
+    giphy?: GiphyData;
+    title?: string;
+    title_link?: string;
+    thumbnail_url?: string;
+};
 export type BaseLocalAttachmentMetadata = {
     id: string;
 };

package/dist/types/types.d.ts

@@ -626,6 +626,7 @@ export type MessageResponseBase = MessageBase & {
     latest_reactions?: ReactionResponse[];
     member?: ChannelMemberResponse;
     mentioned_users?: UserResponse[];
+    mentioned_channel?: boolean;
     message_text_updated_at?: string;
     moderation?: ModerationResponse;
     moderation_details?: ModerationDetailsResponse;
@@ -955,6 +956,7 @@ export type CreateChannelOptions = {
     url_enrichment?: boolean;
     user_message_reminders?: boolean;
     count_messages?: boolean;
+    push_level?: 'all' | 'all_mentions' | 'direct_mentions' | 'mentions' | 'none';
 };
 export type CreateCommandOptions = {
     description: string;
@@ -1051,6 +1053,7 @@ export type UpdateChannelTypeRequest = Partial<{
     uploads?: boolean;
     url_enrichment?: boolean;
     count_messages?: boolean;
+    push_level?: 'all' | 'all_mentions' | 'direct_mentions' | 'mentions' | 'none';
 };
 export type UpdateChannelTypeResponse = {
     automod: Automod;
@@ -1091,6 +1094,7 @@ export type UpdateChannelTypeResponse = {
     partition_ttl?: string;
     count_messages?: boolean;
     user_message_reminders?: boolean;
+    push_level?: string;
 };
 export type GetChannelTypeResponse = {
     automod: Automod;
@@ -1131,6 +1135,7 @@ export type GetChannelTypeResponse = {
     partition_ttl?: string;
     count_messages?: boolean;
     user_message_reminders?: boolean;
+    push_level?: string;
 };
 export type UpdateChannelOptions = Partial<{
     accept_invite: boolean;
@@ -2109,8 +2114,8 @@ type GiphyVersionInfo = {
     frames?: string;
     size?: string;
 };
-type GiphyVersions = 'original' | 'fixed_height' | 'fixed_height_still' | 'fixed_height_downsampled' | 'fixed_width' | 'fixed_width_still' | 'fixed_width_downsampled';
-type GiphyData = {
+export type GiphyVersions = 'original' | 'fixed_height' | 'fixed_height_still' | 'fixed_height_downsampled' | 'fixed_width' | 'fixed_width_still' | 'fixed_width_downsampled';
+export type GiphyData = {
     [key in GiphyVersions]: GiphyVersionInfo;
 };
 export type HuaweiConfig = {
@@ -2129,6 +2134,7 @@ export type Logger = (logLevel: LogLevel, message: string, extraData?: Record<st
 export type Message = Partial<MessageBase & {
     mentioned_users: string[];
     shared_location?: StaticLocationPayload | LiveLocationPayload;
+    mentioned_channel?: boolean;
 }>;
 export type MessageBase = CustomMessageData & {
     id: string;
@@ -3462,4 +3468,100 @@ export type PredefinedFilterSort = SortParam[];
 export type ListPredefinedFiltersOptions = Pager & {
     sort?: PredefinedFilterSort;
 };
+/**
+ * Team Usage Stats Types
+ */
+/**
+ * Represents a metric value for a specific date
+ */
+export type DailyValue = {
+    /** Date in YYYY-MM-DD format */
+    date: string;
+    /** Metric value for this date */
+    value: number;
+};
+/**
+ * Statistics for a single metric with optional daily breakdown
+ */
+export type MetricStats = {
+    /** Per-day values (only present in daily mode) */
+    daily?: DailyValue[];
+    /** Aggregated total value */
+    total: number;
+};
+/**
+ * Usage statistics for a single team containing all 16 metrics
+ */
+export type TeamUsageStats = {
+    /** Team identifier (empty string for users not assigned to any team) */
+    team: string;
+    /** Daily active users */
+    users_daily: MetricStats;
+    /** Daily messages sent */
+    messages_daily: MetricStats;
+    /** Daily translations */
+    translations_daily: MetricStats;
+    /** Daily image moderations */
+    image_moderations_daily: MetricStats;
+    /** Peak concurrent users */
+    concurrent_users: MetricStats;
+    /** Peak concurrent connections */
+    concurrent_connections: MetricStats;
+    /** Total users */
+    users_total: MetricStats;
+    /** Users active in last 24 hours */
+    users_last_24_hours: MetricStats;
+    /** MAU - users active in last 30 days */
+    users_last_30_days: MetricStats;
+    /** Users active this month */
+    users_month_to_date: MetricStats;
+    /** Engaged MAU */
+    users_engaged_last_30_days: MetricStats;
+    /** Engaged users this month */
+    users_engaged_month_to_date: MetricStats;
+    /** Total messages */
+    messages_total: MetricStats;
+    /** Messages in last 24 hours */
+    messages_last_24_hours: MetricStats;
+    /** Messages in last 30 days */
+    messages_last_30_days: MetricStats;
+    /** Messages this month */
+    messages_month_to_date: MetricStats;
+};
+/**
+ * Options for querying team-level usage statistics
+ */
+export type QueryTeamUsageStatsOptions = {
+    /**
+     * Month in YYYY-MM format (e.g., '2026-01').
+     * Mutually exclusive with start_date/end_date.
+     * Returns aggregated monthly values.
+     */
+    month?: string;
+    /**
+     * Start date in YYYY-MM-DD format.
+     * Used with end_date for custom date range.
+     * Returns daily breakdown.
+     */
+    start_date?: string;
+    /**
+     * End date in YYYY-MM-DD format.
+     * Used with start_date for custom date range.
+     * Returns daily breakdown.
+     */
+    end_date?: string;
+    /** Maximum number of teams to return per page (default: 30, max: 30) */
+    limit?: number;
+    /** Cursor for pagination to fetch next page of teams */
+    next?: string;
+};
+/**
+ * Response containing team-level usage statistics
+ */
+export type QueryTeamUsageStatsResponse = APIResponse & {
+    /** Array of team usage statistics */
+    teams: TeamUsageStats[];
+    /** Cursor for pagination to fetch next page */
+    next?: string;
+};
 export {};

package/dist/types/utils.d.ts

@@ -121,6 +121,7 @@ export declare const toDeletedMessage: ({ message, deletedAt, hardDelete, }: {
     } | undefined;
     deleted_reply_count?: number | undefined;
     member?: import("./types").ChannelMemberResponse | undefined;
+    mentioned_channel?: boolean | undefined;
     message_text_updated_at?: string | undefined;
     moderation?: import("./types").ModerationResponse | undefined;
     moderation_details?: import("./types").ModerationDetailsResponse | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stream-chat",
-  "version": "9.31.0",
+  "version": "9.32.0",
   "description": "JS SDK for the Stream Chat API",
   "homepage": "https://getstream.io/chat/",
   "author": {

package/src/client.ts

@@ -181,6 +181,8 @@ import type {
   QueryRemindersResponse,
   QuerySegmentsOptions,
   QuerySegmentTargetsFilter,
+  QueryTeamUsageStatsOptions,
+  QueryTeamUsageStatsResponse,
   QueryThreadsAPIResponse,
   QueryThreadsOptions,
   QueryVotesFilters,
@@ -4748,6 +4750,28 @@ export class StreamChat {
     });
   }
 
+  /**
+   * queryTeamUsageStats - Queries team-level usage statistics from the warehouse database
+   *
+   * Returns all 16 metrics grouped by team with cursor-based pagination.
+   *
+   * Date Range Options (mutually exclusive):
+   * - Use 'month' parameter (YYYY-MM format) for monthly aggregated values
+   * - Use 'start_date'/'end_date' parameters (YYYY-MM-DD format) for daily breakdown
+   * - If neither provided, defaults to current month (monthly mode)
+   *
+   * This endpoint is server-side only.
+   *
+   * @param {QueryTeamUsageStatsOptions} options The options for querying team usage stats
+   * @returns {Promise<QueryTeamUsageStatsResponse>}
+   */
+  async queryTeamUsageStats(options: QueryTeamUsageStatsOptions = {}) {
+    return await this.post<QueryTeamUsageStatsResponse>(
+      `${this.baseURL}/stats/team_usage`,
+      options,
+    );
+  }
+
   /**
    * updateLocation - Updates a location
    *

package/src/messageComposer/attachmentIdentity.ts

@@ -2,6 +2,7 @@ import type { Attachment, SharedLocationResponse } from '../types';
 import type {
   AudioAttachment,
   FileAttachment,
+  GiphyAttachment,
   ImageAttachment,
   LocalAttachment,
   LocalAudioAttachment,
@@ -97,3 +98,7 @@ export const isSharedLocationResponse = (
   !!(location as SharedLocationResponse).latitude &&
   !!(location as SharedLocationResponse).longitude &&
   !!(location as SharedLocationResponse).channel_cid;
+
+export const isGiphyAttachment = (
+  attachment: Attachment,
+): attachment is GiphyAttachment => attachment.type === 'giphy';

package/src/messageComposer/types.ts

@@ -1,4 +1,4 @@
-import type { Attachment, FileUploadConfig } from '../types';
+import type { Attachment, FileUploadConfig, GiphyData } from '../types';
 
 export type LocalAttachment = AnyLocalAttachment | LocalUploadAttachment;
 
@@ -99,6 +99,14 @@ export type ImageAttachment = Attachment & {
   original_width?: number;
 };
 
+export type GiphyAttachment = Attachment & {
+  type: 'giphy';
+  giphy?: GiphyData;
+  title?: string;
+  title_link?: string;
+  thumbnail_url?: string;
+};
+
 export type BaseLocalAttachmentMetadata = {
   id: string;
 };

package/src/types.ts

@@ -743,6 +743,7 @@ export type MessageResponseBase = MessageBase & {
   latest_reactions?: ReactionResponse[];
   member?: ChannelMemberResponse;
   mentioned_users?: UserResponse[];
+  mentioned_channel?: boolean;
   message_text_updated_at?: string;
   moderation?: ModerationResponse; // present only with Moderation v2
   moderation_details?: ModerationDetailsResponse; // present only with Moderation v1
@@ -1110,6 +1111,7 @@ export type CreateChannelOptions = {
   url_enrichment?: boolean;
   user_message_reminders?: boolean;
   count_messages?: boolean;
+  push_level?: 'all' | 'all_mentions' | 'direct_mentions' | 'mentions' | 'none';
 };
 
 export type CreateCommandOptions = {
@@ -1217,6 +1219,7 @@ export type UpdateChannelTypeRequest =
     uploads?: boolean;
     url_enrichment?: boolean;
     count_messages?: boolean;
+    push_level?: 'all' | 'all_mentions' | 'direct_mentions' | 'mentions' | 'none';
   };
 
 export type UpdateChannelTypeResponse = {
@@ -1258,6 +1261,7 @@ export type UpdateChannelTypeResponse = {
   partition_ttl?: string;
   count_messages?: boolean;
   user_message_reminders?: boolean;
+  push_level?: string;
 };
 
 export type GetChannelTypeResponse = {
@@ -1299,6 +1303,7 @@ export type GetChannelTypeResponse = {
   partition_ttl?: string;
   count_messages?: boolean;
   user_message_reminders?: boolean;
+  push_level?: string;
 };
 
 export type UpdateChannelOptions = Partial<{
@@ -2809,7 +2814,7 @@ type GiphyVersionInfo = {
   size?: string;
 };
 
-type GiphyVersions =
+export type GiphyVersions =
   | 'original'
   | 'fixed_height'
   | 'fixed_height_still'
@@ -2818,7 +2823,7 @@ type GiphyVersions =
   | 'fixed_width_still'
   | 'fixed_width_downsampled';
 
-type GiphyData = {
+export type GiphyData = {
   [key in GiphyVersions]: GiphyVersionInfo;
 };
 
@@ -2848,6 +2853,7 @@ export type Message = Partial<
   MessageBase & {
     mentioned_users: string[];
     shared_location?: StaticLocationPayload | LiveLocationPayload;
+    mentioned_channel?: boolean;
   }
 >;
 
@@ -4708,3 +4714,111 @@ export type PredefinedFilterSort = SortParam[];
 export type ListPredefinedFiltersOptions = Pager & {
   sort?: PredefinedFilterSort;
 };
+
+/**
+ * Team Usage Stats Types
+ */
+
+/**
+ * Represents a metric value for a specific date
+ */
+export type DailyValue = {
+  /** Date in YYYY-MM-DD format */
+  date: string;
+  /** Metric value for this date */
+  value: number;
+};
+
+/**
+ * Statistics for a single metric with optional daily breakdown
+ */
+export type MetricStats = {
+  /** Per-day values (only present in daily mode) */
+  daily?: DailyValue[];
+  /** Aggregated total value */
+  total: number;
+};
+
+/**
+ * Usage statistics for a single team containing all 16 metrics
+ */
+export type TeamUsageStats = {
+  /** Team identifier (empty string for users not assigned to any team) */
+  team: string;
+
+  // Daily activity metrics (total = SUM of daily values)
+  /** Daily active users */
+  users_daily: MetricStats;
+  /** Daily messages sent */
+  messages_daily: MetricStats;
+  /** Daily translations */
+  translations_daily: MetricStats;
+  /** Daily image moderations */
+  image_moderations_daily: MetricStats;
+
+  // Peak metrics (total = MAX of daily values)
+  /** Peak concurrent users */
+  concurrent_users: MetricStats;
+  /** Peak concurrent connections */
+  concurrent_connections: MetricStats;
+
+  // Rolling/cumulative metrics (total = LATEST daily value)
+  /** Total users */
+  users_total: MetricStats;
+  /** Users active in last 24 hours */
+  users_last_24_hours: MetricStats;
+  /** MAU - users active in last 30 days */
+  users_last_30_days: MetricStats;
+  /** Users active this month */
+  users_month_to_date: MetricStats;
+  /** Engaged MAU */
+  users_engaged_last_30_days: MetricStats;
+  /** Engaged users this month */
+  users_engaged_month_to_date: MetricStats;
+  /** Total messages */
+  messages_total: MetricStats;
+  /** Messages in last 24 hours */
+  messages_last_24_hours: MetricStats;
+  /** Messages in last 30 days */
+  messages_last_30_days: MetricStats;
+  /** Messages this month */
+  messages_month_to_date: MetricStats;
+};
+
+/**
+ * Options for querying team-level usage statistics
+ */
+export type QueryTeamUsageStatsOptions = {
+  /**
+   * Month in YYYY-MM format (e.g., '2026-01').
+   * Mutually exclusive with start_date/end_date.
+   * Returns aggregated monthly values.
+   */
+  month?: string;
+  /**
+   * Start date in YYYY-MM-DD format.
+   * Used with end_date for custom date range.
+   * Returns daily breakdown.
+   */
+  start_date?: string;
+  /**
+   * End date in YYYY-MM-DD format.
+   * Used with start_date for custom date range.
+   * Returns daily breakdown.
+   */
+  end_date?: string;
+  /** Maximum number of teams to return per page (default: 30, max: 30) */
+  limit?: number;
+  /** Cursor for pagination to fetch next page of teams */
+  next?: string;
+};
+
+/**
+ * Response containing team-level usage statistics
+ */
+export type QueryTeamUsageStatsResponse = APIResponse & {
+  /** Array of team usage statistics */
+  teams: TeamUsageStats[];
+  /** Cursor for pagination to fetch next page */
+  next?: string;
+};