@mtkruto/node 0.124.0 → 0.126.0

package/script/client/6_client.js

@@ -44,6 +44,7 @@ const _2_network_statistics_manager_js_1 = require("./2_network_statistics_manag
 const _2_payment_manager_js_1 = require("./2_payment_manager.js");
 const _2_reaction_manager_js_1 = require("./2_reaction_manager.js");
 const _2_sign_in_js_1 = require("./2_sign_in.js");
+const _2_story_album_manager_js_1 = require("./2_story_album_manager.js");
 const _2_translations_manager_js_1 = require("./2_translations_manager.js");
 const _2_update_manager_js_1 = require("./2_update_manager.js");
 const _3_client_encrypted_pool_js_1 = require("./3_client_encrypted_pool.js");
@@ -85,6 +86,7 @@ class Client extends _5_composer_js_1.Composer {
     #networkStatisticsManager;
     #paymentManager;
     #reactionManager;
+    #storyAlbumManager;
     #translationsManager;
     #updateManager;
     // 3_
@@ -116,6 +118,7 @@ class Client extends _5_composer_js_1.Composer {
             networkStatisticsManager: this.#networkStatisticsManager,
             paymentManager: this.#paymentManager,
             reactionManager: this.#reactionManager,
+            storyAlbumManager: this.#storyAlbumManager,
             translationsManager: this.#translationsManager,
             updateManager: this.#updateManager,
             // 3_
@@ -241,6 +244,7 @@ class Client extends _5_composer_js_1.Composer {
         this.#networkStatisticsManager = new _2_network_statistics_manager_js_1.NetworkStatisticsManager(c);
         this.#paymentManager = new _2_payment_manager_js_1.PaymentManager(c);
         this.#reactionManager = new _2_reaction_manager_js_1.ReactionManager(c);
+        this.#storyAlbumManager = new _2_story_album_manager_js_1.StoryAlbumManager(c);
         this.#translationsManager = new _2_translations_manager_js_1.TranslationsManager(c);
         this.#updateManager = new _2_update_manager_js_1.UpdateManager(c);
         // 3_
@@ -1453,7 +1457,7 @@ class Client extends _5_composer_js_1.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.
@@ -1462,13 +1466,23 @@ class Client extends _5_composer_js_1.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 ========================= //
@@ -3013,7 +3027,7 @@ class Client extends _5_composer_js_1.Composer {
     /**
      * Set the bot's description in the given language. Bot-only.
      *
-     * @method bs
+     * @method bo
      */
     async setMyDescription(params) {
         await this.#botInfoManager.setMyDescription(params);
@@ -3021,7 +3035,7 @@ class Client extends _5_composer_js_1.Composer {
     /**
      * Set the bot's name in the given language. Bot-only.
      *
-     * @method bs
+     * @method bo
      */
     async setMyName(params) {
         await this.#botInfoManager.setMyName(params);
@@ -3029,7 +3043,7 @@ class Client extends _5_composer_js_1.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);
@@ -3037,7 +3051,7 @@ class Client extends _5_composer_js_1.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) {
@@ -3046,7 +3060,7 @@ class Client extends _5_composer_js_1.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) {
@@ -3055,7 +3069,7 @@ class Client extends _5_composer_js_1.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) {
@@ -3064,7 +3078,7 @@ class Client extends _5_composer_js_1.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) {
@@ -3073,7 +3087,7 @@ class Client extends _5_composer_js_1.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) {
@@ -3214,6 +3228,105 @@ class Client extends _5_composer_js_1.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 ========================= //
     //
     /**
@@ -3388,6 +3501,15 @@ class Client extends _5_composer_js_1.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 ========================= //
     //
@@ -3471,7 +3593,7 @@ class Client extends _5_composer_js_1.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.
@@ -3480,7 +3602,7 @@ class Client extends _5_composer_js_1.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.
@@ -3491,7 +3613,7 @@ class Client extends _5_composer_js_1.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.
@@ -3502,7 +3624,7 @@ class Client extends _5_composer_js_1.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.
@@ -3513,7 +3635,7 @@ class Client extends _5_composer_js_1.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.
@@ -3524,7 +3646,7 @@ class Client extends _5_composer_js_1.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.
@@ -3535,7 +3657,7 @@ class Client extends _5_composer_js_1.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/script/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.