@mtkruto/node 0.124.0 → 0.126.0

package/esm/client/6_client.js

@@ -41,6 +41,7 @@ import { NetworkStatisticsManager } from "./2_network_statistics_manager.js";
 import { PaymentManager } from "./2_payment_manager.js";
 import { ReactionManager } from "./2_reaction_manager.js";
 import { signIn } from "./2_sign_in.js";
+import { StoryAlbumManager } from "./2_story_album_manager.js";
 import { TranslationsManager } from "./2_translations_manager.js";
 import { UpdateManager } from "./2_update_manager.js";
 import { ClientEncryptedPool } from "./3_client_encrypted_pool.js";
@@ -81,6 +82,7 @@ export class Client extends Composer {
     #networkStatisticsManager;
     #paymentManager;
     #reactionManager;
+    #storyAlbumManager;
     #translationsManager;
     #updateManager;
     // 3_
@@ -112,6 +114,7 @@ export class Client extends Composer {
             networkStatisticsManager: this.#networkStatisticsManager,
             paymentManager: this.#paymentManager,
             reactionManager: this.#reactionManager,
+            storyAlbumManager: this.#storyAlbumManager,
             translationsManager: this.#translationsManager,
             updateManager: this.#updateManager,
             // 3_
@@ -237,6 +240,7 @@ export class Client extends Composer {
         this.#networkStatisticsManager = new NetworkStatisticsManager(c);
         this.#paymentManager = new PaymentManager(c);
         this.#reactionManager = new ReactionManager(c);
+        this.#storyAlbumManager = new StoryAlbumManager(c);
         this.#translationsManager = new TranslationsManager(c);
         this.#updateManager = new UpdateManager(c);
         // 3_
@@ -1449,7 +1453,7 @@ export class Client extends Composer {
         return await this.#accountManager.resolveUsername(username, params);
     }
     /**
-     * Resolve a phone number.
+     * Resolve a phone number. User-only.
      *
      * @method ac
      * @param username The phone number to resolve.
@@ -1458,13 +1462,23 @@ export class Client extends Composer {
         return await this.#accountManager.resolvePhoneNumber(phoneNumber);
     }
     /**
-     * Set the list of close friends.
+     * Set the list of close friends. User-only.
      *
      * @method ac
      * @param userIds The identifiers of users to set as close friends.
      */
     async setCloseFriends(userIds) {
-        return await this.#accountManager.setCloseFriends(userIds);
+        await this.#accountManager.setCloseFriends(userIds);
+    }
+    /**
+     * Suggest a birthday. User-only.
+     *
+     * @method ac
+     * @param userId The identifier of the user to suggest a birthday for.
+     * @param birthday The birthday to suggest.
+     */
+    async suggestBirthday(userId, birthday) {
+        await this.#accountManager.suggestBirthday(userId, birthday);
     }
     //
     // ========================= MESSAGES ========================= //
@@ -3009,7 +3023,7 @@ export class Client extends Composer {
     /**
      * Set the bot's description in the given language. Bot-only.
      *
-     * @method bs
+     * @method bo
      */
     async setMyDescription(params) {
         await this.#botInfoManager.setMyDescription(params);
@@ -3017,7 +3031,7 @@ export class Client extends Composer {
     /**
      * Set the bot's name in the given language. Bot-only.
      *
-     * @method bs
+     * @method bo
      */
     async setMyName(params) {
         await this.#botInfoManager.setMyName(params);
@@ -3025,7 +3039,7 @@ export class Client extends Composer {
     /**
      * Set the bot's short description in the given language. Bot-only.
      *
-     * @method bs
+     * @method bo
      */
     async setMyShortDescription(params) {
         await this.#botInfoManager.setMyShortDescription(params);
@@ -3033,7 +3047,7 @@ export class Client extends Composer {
     /**
      * Get the bot's description in the given language. Bot-only.
      *
-     * @method bs
+     * @method bo
      * @returns The current bot's description in the specified language.
      */
     async getMyDescription(params) {
@@ -3042,7 +3056,7 @@ export class Client extends Composer {
     /**
      * Get the bot's name in the given language. Bot-only.
      *
-     * @method bs
+     * @method bo
      * @returns The current bot's name in the specified language.
      */
     async getMyName(params) {
@@ -3051,7 +3065,7 @@ export class Client extends Composer {
     /**
      * Get the bot's short description in the given language. Bot-only.
      *
-     * @method bs
+     * @method bo
      * @returns The current bot's short description in the specified language.
      */
     async getMyShortDescription(params) {
@@ -3060,7 +3074,7 @@ export class Client extends Composer {
     /**
      * Set the bot's commands in the given scope and/or language. Bot-only.
      *
-     * @method bs
+     * @method bo
      * @param commands The commands to set.
      */
     async setMyCommands(commands, params) {
@@ -3069,7 +3083,7 @@ export class Client extends Composer {
     /**
      * Get the bot's commands in the given scope and/or language. Bot-only.
      *
-     * @method bs
+     * @method bo
      * @returns The current bot's commands in the specified language.
      */
     async getMyCommands(params) {
@@ -3210,6 +3224,105 @@ export class Client extends Composer {
         await this.#storyManager.removeStoryFromHighlights(chatId, storyId);
     }
     //
+    // ========================= STORY ALBUMS ========================= //
+    //
+    /**
+     * Create a story album. User-only.
+     *
+     * @method sa
+     * @param chatId The identifier of the chat to create the album in.
+     * @param name The name of the album.
+     * @param storyIds The initial stories inside the album.
+     */
+    async createStoryAlbum(chatId, name, storyIds) {
+        return await this.#storyAlbumManager.createStoryAlbum(chatId, name, storyIds);
+    }
+    /**
+     * Set the name of a story album. User-only.
+     *
+     * @method sa
+     * @param chatId The identifier of the chat including the album.
+     * @param albumId The identifier of the album to rename.
+     * @param name The new name of the album.
+     */
+    async setStoryAlbumName(chatId, albumId, name) {
+        return await this.#storyAlbumManager.setStoryAlbumName(chatId, albumId, name);
+    }
+    /**
+     * Add multiple stories to an album. User-only.
+     *
+     * @method sa
+     * @param chatId The identifier of the chat including the album.
+     * @param albumId The identifier of an album.
+     * @param storyIds The identifiers of the stories to add.
+     */
+    async addStoriesToAlbum(chatId, albumId, storyIds) {
+        return await this.#storyAlbumManager.addStoriesToAlbum(chatId, albumId, storyIds);
+    }
+    /**
+     * Add a single story to an album. User-only.
+     *
+     * @method sa
+     * @param chatId The identifier of the chat including the album.
+     * @param albumId The identifier of an album.
+     * @param storyIds The identifier of the story to add.
+     */
+    async addStoryToAlbum(chatId, albumId, storyId) {
+        return await this.#storyAlbumManager.addStoryToAlbum(chatId, albumId, storyId);
+    }
+    /**
+     * Remove multiple stories from an album. User-only.
+     *
+     * @method sa
+     * @param chatId The identifier of the chat including the album.
+     * @param albumId The identifier of an album.
+     * @param storyIds The identifiers of the stories to remove.
+     */
+    async removeStoriesFromAlbum(chatId, albumId, storyIds) {
+        return await this.#storyAlbumManager.removeStoriesFromAlbum(chatId, albumId, storyIds);
+    }
+    /**
+     * Remove a single story from an album. User-only.
+     *
+     * @method sa
+     * @param chatId The identifier of the chat including the album.
+     * @param albumId The identifier of an album.
+     * @param storyIds The identifier of the story to remove.
+     */
+    async removeStoryFromAlbum(chatId, albumId, storyId) {
+        return await this.#storyAlbumManager.removeStoryFromAlbum(chatId, albumId, storyId);
+    }
+    /**
+     * Reorder stories in an album. User-only.
+     *
+     * @method sa
+     * @param chatId The identifier of the chat including the album.
+     * @param albumId The identifier of an album.
+     * @param storyIds The new order of stories.
+     */
+    async reorderStoriesInAlbum(chatId, albumId, storyIds) {
+        return await this.#storyAlbumManager.reorderStoriesInAlbum(chatId, albumId, storyIds);
+    }
+    /**
+     * Get story albums in a chat. User-only.
+     *
+     * @method sa
+     * @param chatId The identifier of a chat including albums.
+     */
+    async getStoryAlbums(chatId) {
+        return await this.#storyAlbumManager.getStoryAlbums(chatId);
+    }
+    /**
+     * Get stories inside an album. User-only.
+     *
+     * @method sa
+     * @param chatId The identifier of the chat including albums.
+     * @param albumId The identifier of an album.
+     */
+    async getStoriesInAlbum(chatId, albumId) {
+        return await this.#storyAlbumManager.getStoriesInAlbum(chatId, albumId);
+    }
+    //
     // ========================= MISC ========================= //
     //
     /**
@@ -3384,6 +3497,15 @@ export class Client extends Composer {
     async addContact(userId, firstName, params) {
         await this.#contactManager.addContact(userId, firstName, params);
     }
+    /**
+     * Set a contact note.
+     *
+     * @method co
+     * @param userId The identifier of the user to update the note for.
+     */
+    async setContactNote(userId, params) {
+        await this.#contactManager.setContactNote(userId, params);
+    }
     //
     // ========================= TRANSLATIONS ========================= //
     //
@@ -3467,7 +3589,7 @@ export class Client extends Composer {
     // ========================= GIFT COLLECTIONS ========================= //
     //
     /**
-     * Get gift collections of a chat.
+     * Get gift collections of a chat. User-only.
      *
      * @method gc
      * @param chatId The identifier of a chat to get gift collections for.
@@ -3476,7 +3598,7 @@ export class Client extends Composer {
         return await this.#giftCollectionManager.getGiftCollections(chatId);
     }
     /**
-     * Create a gift collection.
+     * Create a gift collection. User-only.
      *
      * @method gc
      * @param chatId The identifier of a chat to create the gift collection in.
@@ -3487,7 +3609,7 @@ export class Client extends Composer {
         return await this.#giftCollectionManager.createGiftCollection(chatId, name, gifts);
     }
     /**
-     * Set the name of a gift collection.
+     * Set the name of a gift collection. User-only.
      *
      * @method gc
      * @param chatId The identifier of the chat that includes the gift collection.
@@ -3498,7 +3620,7 @@ export class Client extends Composer {
         return await this.#giftCollectionManager.setGiftCollectionName(chatId, collectionId, name);
     }
     /**
-     * Add gifts to a gift collection.
+     * Add gifts to a gift collection. User-only.
      *
      * @method gc
      * @param chatId The identifier of the chat that includes the gift collection.
@@ -3509,7 +3631,7 @@ export class Client extends Composer {
         return await this.#giftCollectionManager.addGiftsToCollection(chatId, collectionId, gifts);
     }
     /**
-     * Remove gifts from a gift collection.
+     * Remove gifts from a gift collection. User-only.
      *
      * @method gc
      * @param chatId The identifier of the chat that includes the gift collection.
@@ -3520,7 +3642,7 @@ export class Client extends Composer {
         return await this.#giftCollectionManager.removeGiftsFromCollection(chatId, collectionId, gifts);
     }
     /**
-     * Reorder gifts in a gift collection.
+     * Reorder gifts in a gift collection. User-only.
      *
      * @method gc
      * @param chatId The identifier of the chat that includes the gift collection.
@@ -3531,7 +3653,7 @@ export class Client extends Composer {
         return await this.#giftCollectionManager.reorderGiftsInCollection(chatId, collectionId, gifts);
     }
     /**
-     * Delete a gift collection.
+     * Delete a gift collection. User-only.
      *
      * @method gc
      * @param chatId The identifier of the chat that includes the gift collection.

package/esm/client/6_client_dispatcher.d.ts

@@ -1,7 +1,8 @@
 import type { Api, Mtproto } from "../2_tl.js";
 import type { DC } from "../3_transport.js";
-import type { BotCommand, BotTokenCheckResult, BusinessConnection, CallbackQueryAnswer, CallbackQueryQuestion, Chat, ChatActionType, ChatListItem, ChatMember, ChatP, ChatPChannel, ChatPGroup, ChatPPrivate, ChatPSupergroup, ChatSettings, ClaimedGifts, CodeCheckResult, FailedInvitation, FileSource, Gift, GiftCollection, ID, InactiveChat, InlineQueryAnswer, InlineQueryResult, InputChecklistItem, InputEmojiStatus, InputGift, InputMedia, InputPollOption, InputStoryContent, InviteLink, JoinRequest, LinkPreview, LiveStreamChannel, Message, MessageAnimation, MessageAudio, MessageChecklist, MessageContact, MessageDice, MessageDocument, MessageInvoice, MessageList, MessageLocation, MessagePhoto, MessagePoll, MessageReactionList, MessageSticker, MessageText, MessageVenue, MessageVideo, MessageVideoNote, MessageVoice, MiniAppInfo, NetworkStatistics, ParseMode, PasswordCheckResult, Poll, PriceTag, Reaction, SavedChats, SlowModeDuration, Sticker, StickerSet, Story, Topic, Translation, User, VideoChat, VideoChatActive, VideoChatScheduled, VoiceTranscription } from "../3_types.js";
-import type { AddChatMemberParams, AddContactParams, AddReactionParams, AnswerCallbackQueryParams, AnswerInlineQueryParams, AnswerPreCheckoutQueryParams, ApproveJoinRequestsParams, BanChatMemberParams, CheckUsernameParams, CreateChannelParams, CreateGroupParams, CreateInviteLinkParams, CreateStoryParams, CreateSupergroupParams, CreateTopicParams, DeclineJoinRequestsParams, DeleteMessageParams, DeleteMessagesParams, DownloadLiveStreamSegmentParams, DownloadParams, EditInlineMessageCaptionParams, EditInlineMessageMediaParams, EditInlineMessageTextParams, EditMessageCaptionParams, EditMessageLiveLocationParams, EditMessageMediaParams, EditMessageReplyMarkupParams, EditMessageTextParams, EditTopicParams, EnableSignaturesParams, ForwardMessagesParams, GetChatMembersParams, GetChatsParams, GetClaimedGiftsParams, GetCommonChatsParams, GetCreatedInviteLinksParams, GetHistoryParams, GetJoinRequestsParams, GetLinkPreviewParams, GetMessageReactionsParams, GetMyCommandsParams, GetSavedChatsParams, GetSavedMessagesParams, GetTranslationsParams, InvokeParams, JoinVideoChatParams, OpenChatParams, OpenMiniAppParams, PinMessageParams, PromoteChatMemberParams, ResolveUsernameParams, ScheduleVideoChatParams, SearchMessagesParams, SendAnimationParams, SendAudioParams, SendChecklistParams, SendContactParams, SendDiceParams, SendDocumentParams, SendGiftParams, SendInlineQueryParams, SendInvoiceParams, SendLocationParams, SendMediaGroupParams, SendMessageDraftParams, SendMessageParams, SendPhotoParams, SendPollParams, SendStickerParams, SendVenueParams, SendVideoNoteParams, SendVideoParams, SendVoiceParams, SetBirthdayParams, SetChatMemberRightsParams, SetChatMemberTagParams, SetChatPhotoParams, SetEmojiStatusParams, SetLocationParams, SetMyCommandsParams, SetNameColorParams, SetPersonalChannelParams, SetProfileColorParams, SetReactionsParams, SetWorkingHoursParams, SignInParams, StartBotParams, StartVideoChatParams, StopPollParams, UnpinMessageParams, UnpinMessagesParams, UpdateChecklistParams, UpdateProfileParams } from "./0_params.js";
+import type { Birthday, BotCommand, BotTokenCheckResult, BusinessConnection, CallbackQueryAnswer, CallbackQueryQuestion, Chat, ChatActionType, ChatListItem, ChatMember, ChatP, ChatPChannel, ChatPGroup, ChatPPrivate, ChatPSupergroup, ChatSettings, ClaimedGifts, CodeCheckResult, FailedInvitation, FileSource, Gift, GiftCollection, ID, InactiveChat, InlineQueryAnswer, InlineQueryResult, InputChecklistItem, InputEmojiStatus, InputGift, InputMedia, InputPollOption, InputStoryContent, InviteLink, JoinRequest, LinkPreview, LiveStreamChannel, Message, MessageAnimation, MessageAudio, MessageChecklist, MessageContact, MessageDice, MessageDocument, MessageInvoice, MessageList, MessageLocation, MessagePhoto, MessagePoll, MessageReactionList, MessageSticker, MessageText, MessageVenue, MessageVideo, MessageVideoNote, MessageVoice, MiniAppInfo, NetworkStatistics, ParseMode, PasswordCheckResult, Poll, PriceTag, Reaction, SavedChats, SlowModeDuration, Sticker, StickerSet, Story, StoryAlbum, Topic, Translation, User, VideoChat, VideoChatActive, VideoChatScheduled, VoiceTranscription } from "../3_types.js";
+import type { AlbumStoryList } from "../types/4_album_story_list.js";
+import type { AddChatMemberParams, AddContactParams, AddReactionParams, AnswerCallbackQueryParams, AnswerInlineQueryParams, AnswerPreCheckoutQueryParams, ApproveJoinRequestsParams, BanChatMemberParams, CheckUsernameParams, CreateChannelParams, CreateGroupParams, CreateInviteLinkParams, CreateStoryParams, CreateSupergroupParams, CreateTopicParams, DeclineJoinRequestsParams, DeleteMessageParams, DeleteMessagesParams, DownloadLiveStreamSegmentParams, DownloadParams, EditInlineMessageCaptionParams, EditInlineMessageMediaParams, EditInlineMessageTextParams, EditMessageCaptionParams, EditMessageLiveLocationParams, EditMessageMediaParams, EditMessageReplyMarkupParams, EditMessageTextParams, EditTopicParams, EnableSignaturesParams, ForwardMessagesParams, GetChatMembersParams, GetChatsParams, GetClaimedGiftsParams, GetCommonChatsParams, GetCreatedInviteLinksParams, GetHistoryParams, GetJoinRequestsParams, GetLinkPreviewParams, GetMessageReactionsParams, GetMyCommandsParams, GetSavedChatsParams, GetSavedMessagesParams, GetTranslationsParams, InvokeParams, JoinVideoChatParams, OpenChatParams, OpenMiniAppParams, PinMessageParams, PromoteChatMemberParams, ResolveUsernameParams, ScheduleVideoChatParams, SearchMessagesParams, SendAnimationParams, SendAudioParams, SendChecklistParams, SendContactParams, SendDiceParams, SendDocumentParams, SendGiftParams, SendInlineQueryParams, SendInvoiceParams, SendLocationParams, SendMediaGroupParams, SendMessageDraftParams, SendMessageParams, SendPhotoParams, SendPollParams, SendStickerParams, SendVenueParams, SendVideoNoteParams, SendVideoParams, SendVoiceParams, SetBirthdayParams, SetChatMemberRightsParams, SetChatMemberTagParams, SetChatPhotoParams, SetContactNoteParams, SetEmojiStatusParams, SetLocationParams, SetMyCommandsParams, SetNameColorParams, SetPersonalChannelParams, SetProfileColorParams, SetReactionsParams, SetWorkingHoursParams, SignInParams, StartBotParams, StartVideoChatParams, StopPollParams, UnpinMessageParams, UnpinMessagesParams, UpdateChecklistParams, UpdateProfileParams } from "./0_params.js";
 import type { WorkerRequest } from "./0_worker_request.js";
 import type { ClientGeneric } from "./1_client_generic.js";
 import { type InvokeErrorHandler } from "./1_invoke_middleware.js";
@@ -343,19 +344,27 @@ export declare class ClientDispatcher<C extends Context = Context> extends Compo
      */
     resolveUsername(username: string, params?: ResolveUsernameParams): Promise<ChatP>;
     /**
-     * Resolve a phone number.
+     * Resolve a phone number. User-only.
      *
      * @method ac
      * @param username The phone number to resolve.
      */
     resolvePhoneNumber(phoneNumber: string): Promise<User>;
     /**
-     * Set the list of close friends.
+     * Set the list of close friends. User-only.
      *
      * @method ac
      * @param userIds The identifiers of users to set as close friends.
      */
     setCloseFriends(userIds: ID[]): Promise<void>;
+    /**
+     * Suggest a birthday. User-only.
+     *
+     * @method ac
+     * @param userId The identifier of the user to suggest a birthday for.
+     * @param birthday The birthday to suggest.
+     */
+    suggestBirthday(userId: ID, birthday: Birthday): Promise<void>;
     /**
      * Send a text message.
      *
@@ -1566,7 +1575,7 @@ export declare class ClientDispatcher<C extends Context = Context> extends Compo
     /**
      * Set the bot's description in the given language. Bot-only.
      *
-     * @method bs
+     * @method bo
      */
     setMyDescription(params?: {
         description?: string;
@@ -1575,7 +1584,7 @@ export declare class ClientDispatcher<C extends Context = Context> extends Compo
     /**
      * Set the bot's name in the given language. Bot-only.
      *
-     * @method bs
+     * @method bo
      */
     setMyName(params?: {
         name?: string;
@@ -1584,7 +1593,7 @@ export declare class ClientDispatcher<C extends Context = Context> extends Compo
     /**
      * Set the bot's short description in the given language. Bot-only.
      *
-     * @method bs
+     * @method bo
      */
     setMyShortDescription(params?: {
         shortDescription?: string;
@@ -1593,7 +1602,7 @@ export declare class ClientDispatcher<C extends Context = Context> extends Compo
     /**
      * Get the bot's description in the given language. Bot-only.
      *
-     * @method bs
+     * @method bo
      * @returns The current bot's description in the specified language.
      */
     getMyDescription(params?: {
@@ -1602,7 +1611,7 @@ export declare class ClientDispatcher<C extends Context = Context> extends Compo
     /**
      * Get the bot's name in the given language. Bot-only.
      *
-     * @method bs
+     * @method bo
      * @returns The current bot's name in the specified language.
      */
     getMyName(params?: {
@@ -1611,7 +1620,7 @@ export declare class ClientDispatcher<C extends Context = Context> extends Compo
     /**
      * Get the bot's short description in the given language. Bot-only.
      *
-     * @method bs
+     * @method bo
      * @returns The current bot's short description in the specified language.
      */
     getMyShortDescription(params?: {
@@ -1620,14 +1629,14 @@ export declare class ClientDispatcher<C extends Context = Context> extends Compo
     /**
      * Set the bot's commands in the given scope and/or language. Bot-only.
      *
-     * @method bs
+     * @method bo
      * @param commands The commands to set.
      */
     setMyCommands(commands: BotCommand[], params?: SetMyCommandsParams): Promise<void>;
     /**
      * Get the bot's commands in the given scope and/or language. Bot-only.
      *
-     * @method bs
+     * @method bo
      * @returns The current bot's commands in the specified language.
      */
     getMyCommands(params?: GetMyCommandsParams): Promise<BotCommand[]>;
@@ -1732,6 +1741,84 @@ export declare class ClientDispatcher<C extends Context = Context> extends Compo
      * @param storyId The identifier of the story to remove from highlights.
      */
     removeStoryFromHighlights(chatId: ID, storyId: number): Promise<void>;
+    /**
+     * Create a story album. User-only.
+     *
+     * @method sa
+     * @param chatId The identifier of the chat to create the album in.
+     * @param name The name of the album.
+     * @param storyIds The initial stories inside the album.
+     */
+    createStoryAlbum(chatId: ID, name: string, storyIds: number[]): Promise<StoryAlbum>;
+    /**
+     * Set the name of a story album. User-only.
+     *
+     * @method sa
+     * @param chatId The identifier of the chat including the album.
+     * @param albumId The identifier of the album to rename.
+     * @param name The new name of the album.
+     */
+    setStoryAlbumName(chatId: ID, albumId: number, name: string): Promise<StoryAlbum>;
+    /**
+     * Add multiple stories to an album. User-only.
+     *
+     * @method sa
+     * @param chatId The identifier of the chat including the album.
+     * @param albumId The identifier of an album.
+     * @param storyIds The identifiers of the stories to add.
+     */
+    addStoriesToAlbum(chatId: ID, albumId: number, storyIds: number[]): Promise<StoryAlbum>;
+    /**
+     * Add a single story to an album. User-only.
+     *
+     * @method sa
+     * @param chatId The identifier of the chat including the album.
+     * @param albumId The identifier of an album.
+     * @param storyIds The identifier of the story to add.
+     */
+    addStoryToAlbum(chatId: ID, albumId: number, storyId: number): Promise<StoryAlbum>;
+    /**
+     * Remove multiple stories from an album. User-only.
+     *
+     * @method sa
+     * @param chatId The identifier of the chat including the album.
+     * @param albumId The identifier of an album.
+     * @param storyIds The identifiers of the stories to remove.
+     */
+    removeStoriesFromAlbum(chatId: ID, albumId: number, storyIds: number[]): Promise<StoryAlbum>;
+    /**
+     * Remove a single story from an album. User-only.
+     *
+     * @method sa
+     * @param chatId The identifier of the chat including the album.
+     * @param albumId The identifier of an album.
+     * @param storyIds The identifier of the story to remove.
+     */
+    removeStoryFromAlbum(chatId: ID, albumId: number, storyId: number): Promise<StoryAlbum>;
+    /**
+     * Reorder stories in an album. User-only.
+     *
+     * @method sa
+     * @param chatId The identifier of the chat including the album.
+     * @param albumId The identifier of an album.
+     * @param storyIds The new order of stories.
+     */
+    reorderStoriesInAlbum(chatId: ID, albumId: number, storyIds: number[]): Promise<StoryAlbum>;
+    /**
+     * Get story albums in a chat. User-only.
+     *
+     * @method sa
+     * @param chatId The identifier of a chat including albums.
+     */
+    getStoryAlbums(chatId: ID): Promise<StoryAlbum[]>;
+    /**
+     * Get stories inside an album. User-only.
+     *
+     * @method sa
+     * @param chatId The identifier of the chat including albums.
+     * @param albumId The identifier of an album.
+     */
+    getStoriesInAlbum(chatId: ID, albumId: number): Promise<AlbumStoryList>;
     /**
      * Get network statistics. This might not always be available.
      *
@@ -1861,6 +1948,13 @@ export declare class ClientDispatcher<C extends Context = Context> extends Compo
      * @param firstName The contact's first name.
      */
     addContact(userId: ID, firstName: string, params?: AddContactParams): Promise<void>;
+    /**
+     * Set a contact note.
+     *
+     * @method co
+     * @param userId The identifier of the user to update the note for.
+     */
+    setContactNote(userId: ID, params?: SetContactNoteParams): Promise<void>;
     /**
      * Get translations. User-only.
      *
@@ -1919,14 +2013,14 @@ export declare class ClientDispatcher<C extends Context = Context> extends Compo
      */
     transferGift(chatId: ID, gift: InputGift): Promise<void>;
     /**
-     * Get gift collections of a chat.
+     * Get gift collections of a chat. User-only.
      *
      * @method gc
      * @param chatId The identifier of a chat to get gift collections for.
      */
     getGiftCollections(chatId: ID): Promise<GiftCollection[]>;
     /**
-     * Create a gift collection.
+     * Create a gift collection. User-only.
      *
      * @method gc
      * @param chatId The identifier of a chat to create the gift collection in.
@@ -1935,7 +2029,7 @@ export declare class ClientDispatcher<C extends Context = Context> extends Compo
      */
     createGiftCollection(chatId: ID, name: string, gifts: InputGift[]): Promise<GiftCollection>;
     /**
-     * Set the name of a gift collection.
+     * Set the name of a gift collection. User-only.
      *
      * @method gc
      * @param chatId The identifier of the chat that includes the gift collection.
@@ -1944,7 +2038,7 @@ export declare class ClientDispatcher<C extends Context = Context> extends Compo
      */
     setGiftCollectionName(chatId: ID, collectionId: number, name: string): Promise<GiftCollection>;
     /**
-     * Add gifts to a gift collection.
+     * Add gifts to a gift collection. User-only.
      *
      * @method gc
      * @param chatId The identifier of the chat that includes the gift collection.
@@ -1953,7 +2047,7 @@ export declare class ClientDispatcher<C extends Context = Context> extends Compo
      */
     addGiftsToCollection(chatId: ID, collectionId: number, gifts: InputGift[]): Promise<GiftCollection>;
     /**
-     * Remove gifts from a gift collection.
+     * Remove gifts from a gift collection. User-only.
      *
      * @method gc
      * @param chatId The identifier of the chat that includes the gift collection.
@@ -1962,7 +2056,7 @@ export declare class ClientDispatcher<C extends Context = Context> extends Compo
      */
     removeGiftsFromCollection(chatId: ID, collectionId: number, gifts: InputGift[]): Promise<GiftCollection>;
     /**
-     * Reorder gifts in a gift collection.
+     * Reorder gifts in a gift collection. User-only.
      *
      * @method gc
      * @param chatId The identifier of the chat that includes the gift collection.
@@ -1971,7 +2065,7 @@ export declare class ClientDispatcher<C extends Context = Context> extends Compo
      */
     reorderGiftsInCollection(chatId: ID, collectionId: number, gifts: InputGift[]): Promise<GiftCollection>;
     /**
-     * Delete a gift collection.
+     * Delete a gift collection. User-only.
      *
      * @method gc
      * @param chatId The identifier of the chat that includes the gift collection.