@mtkruto/node 0.125.0 → 0.127.0

package/script/client/6_client_dispatcher.js

@@ -2043,6 +2043,34 @@ class ClientDispatcher extends _5_composer_js_1.Composer {
     async getSimilarBots(chatId) {
         return await this.#dispatch("getSimilarBots", chatId);
     }
+    /**
+     * Get the count of online members in a chat. User-only.
+     *
+     * @method ch
+     * @param chatId The identifier of a chat.
+     * @returns The count of online members in the chat.
+     */
+    async getOnlineCount(chatId) {
+        return await this.#dispatch("getOnlineCount", chatId);
+    }
+    /**
+     * Enable chat history for new members. User-only.
+     *
+     * @method ch
+     * @param chatId The identifier of a chat.
+     */
+    async enableChatHistoryForNewMembers(chatId) {
+        return await this.#dispatch("enableChatHistoryForNewMembers", chatId);
+    }
+    /**
+     * Disable chat history for new members. User-only.
+     *
+     * @method ch
+     * @param chatId The identifier of a chat.
+     */
+    async disableChatHistoryForNewMembers(chatId) {
+        return await this.#dispatch("disableChatHistoryForNewMembers", chatId);
+    }
     //
     // ========================= CALLBACK QUERIES ========================= //
     //
@@ -2297,6 +2325,105 @@ class ClientDispatcher extends _5_composer_js_1.Composer {
         return await this.#dispatch("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.#dispatch("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.#dispatch("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.#dispatch("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.#dispatch("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.#dispatch("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.#dispatch("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.#dispatch("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.#dispatch("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.#dispatch("getStoriesInAlbum", chatId, albumId);
+    }
+    //
     // ========================= MISC ========================= //
     //
     /**
@@ -2563,7 +2690,7 @@ class ClientDispatcher 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.
@@ -2572,7 +2699,7 @@ class ClientDispatcher extends _5_composer_js_1.Composer {
         return await this.#dispatch("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.
@@ -2583,7 +2710,7 @@ class ClientDispatcher extends _5_composer_js_1.Composer {
         return await this.#dispatch("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.
@@ -2594,7 +2721,7 @@ class ClientDispatcher extends _5_composer_js_1.Composer {
         return await this.#dispatch("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.
@@ -2605,7 +2732,7 @@ class ClientDispatcher extends _5_composer_js_1.Composer {
         return await this.#dispatch("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.
@@ -2616,7 +2743,7 @@ class ClientDispatcher extends _5_composer_js_1.Composer {
         return await this.#dispatch("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.
@@ -2627,7 +2754,7 @@ class ClientDispatcher extends _5_composer_js_1.Composer {
         return await this.#dispatch("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/types/2_story_album_icon.d.ts

@@ -0,0 +1,35 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2026 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import type { Document } from "./1_document.js";
+import type { Photo } from "./1_photo.js";
+/** @unlisted */
+export interface StoryAlbumIconPhoto {
+    /** @discriminator */
+    type: "photo";
+    photo: Photo;
+}
+/** @unlisted */
+export interface StoryAlbumIconVideo {
+    /** @discriminator */
+    type: "video";
+    video: Document;
+}
+export type StoryAlbumIcon = StoryAlbumIconPhoto | StoryAlbumIconVideo;
+//# sourceMappingURL=2_story_album_icon.d.ts.map

package/script/types/2_story_album_icon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"2_story_album_icon.d.ts","sourceRoot":"","sources":["../../src/types/2_story_album_icon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,gBAAgB;AAChB,MAAM,WAAW,mBAAmB;IAClC,qBAAqB;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;CACd;AAED,gBAAgB;AAChB,MAAM,WAAW,mBAAmB;IAClC,qBAAqB;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,mBAAmB,GAAG,mBAAmB,CAAC"}

package/script/types/2_story_album_icon.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2026 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/script/types/3_story_album.d.ts

@@ -0,0 +1,32 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2026 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import { Api } from "../2_tl.js";
+import type { StoryAlbumIcon } from "./2_story_album_icon.js";
+/** A story album. */
+export interface StoryAlbum {
+    /** The identifier of the album. */
+    id: number;
+    /** The name of the album. */
+    name: string;
+    /** The icon of the album. */
+    icon?: StoryAlbumIcon;
+}
+export declare function constructStoryAlbum(album: Api.StoryAlbum): StoryAlbum;
+//# sourceMappingURL=3_story_album.d.ts.map

package/script/types/3_story_album.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"3_story_album.d.ts","sourceRoot":"","sources":["../../src/types/3_story_album.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAIjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,qBAAqB;AACrB,MAAM,WAAW,UAAU;IACzB,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,GAAG,CAAC,UAAU,GAAG,UAAU,CAwBrE"}

package/script/types/3_story_album.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2026 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.constructStoryAlbum = constructStoryAlbum;
+const _1_utilities_js_1 = require("../1_utilities.js");
+const _2_tl_js_1 = require("../2_tl.js");
+const _file_id_js_1 = require("./_file_id.js");
+const _1_document_js_1 = require("./1_document.js");
+const _1_photo_js_1 = require("./1_photo.js");
+function constructStoryAlbum(album) {
+    let icon;
+    if (album.icon_photo) {
+        icon = {
+            type: "photo",
+            photo: (0, _1_photo_js_1.constructPhoto)(_2_tl_js_1.Api.as("photo", album.icon_photo)),
+        };
+    }
+    else if (_2_tl_js_1.Api.is("document", album.icon_video)) {
+        const fileId = {
+            type: _file_id_js_1.FileType.Video,
+            dcId: album.icon_video.dc_id,
+            fileReference: album.icon_video.file_reference,
+            location: { type: "common", id: album.icon_video.id, accessHash: album.icon_video.access_hash },
+        };
+        icon = {
+            type: "video",
+            video: (0, _1_document_js_1.constructDocument)(album.icon_video, { _: "documentAttributeFilename", file_name: "video.mp4" }, (0, _file_id_js_1.serializeFileId)(fileId), (0, _file_id_js_1.toUniqueFileId)(fileId)),
+        };
+    }
+    return (0, _1_utilities_js_1.cleanObject)({
+        id: album.album_id,
+        name: album.title,
+        icon,
+    });
+}

package/script/types/4_album_story_list.d.ts

@@ -0,0 +1,33 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2026 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import { Api } from "../2_tl.js";
+import type { PeerGetter } from "./1_chat_p.js";
+import { type Story } from "./3_story.js";
+/** A list of stories in a specific album. */
+export interface AlbumStoryList {
+    /** The stories. */
+    stories: Story[];
+    /** The identifiers of the pinned stories. */
+    pinnedStoryIds: number[];
+    /** The total number of stories in this album. */
+    count: number;
+}
+export declare function constructAlbumStoryList(result: Api.stories_stories, peer: Api.peerUser | Api.peerChat | Api.peerChannel, getPeer: PeerGetter): AlbumStoryList;
+//# sourceMappingURL=4_album_story_list.d.ts.map

package/script/types/4_album_story_list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"4_album_story_list.d.ts","sourceRoot":"","sources":["../../src/types/4_album_story_list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAkB,KAAK,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1D,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,mBAAmB;IACnB,OAAO,EAAE,KAAK,EAAE,CAAC;IACjB,6CAA6C;IAC7C,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,UAAU,GAAG,cAAc,CAS7J"}

package/script/types/4_album_story_list.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2026 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.constructAlbumStoryList = constructAlbumStoryList;
+const _1_utilities_js_1 = require("../1_utilities.js");
+const _2_tl_js_1 = require("../2_tl.js");
+const _3_story_js_1 = require("./3_story.js");
+function constructAlbumStoryList(result, peer, getPeer) {
+    const stories = result.stories.filter((v) => _2_tl_js_1.Api.is("storyItem", v)).map((v) => (0, _3_story_js_1.constructStory)(v, peer, getPeer));
+    const pinnedStoryIds = result.pinned_to_top ?? [];
+    const count = result.count;
+    return (0, _1_utilities_js_1.cleanObject)({
+        stories,
+        pinnedStoryIds,
+        count,
+    });
+}