@mtcute/core 0.17.1 → 0.18.0

package/utils/links/bots.cjs

@@ -0,0 +1,211 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const utils = require("../../types/utils.cjs");
+const typeAssertions = require("../type-assertions.cjs");
+const common = require("./common.cjs");
+const botStart = /* @__PURE__ */ common.deeplinkBuilder({
+  internalBuild: ({ username, parameter }) => ["resolve", { domain: username, start: parameter }],
+  internalParse: (path, query) => {
+    if (path !== "resolve") return null;
+    const username = query.get("domain");
+    const parameter = query.get("start");
+    if (!username || !parameter) return null;
+    return { username, parameter };
+  },
+  externalBuild: ({ username, parameter }) => [username, { start: parameter }],
+  externalParse: (path, query) => {
+    if (path.includes("/") || path[0] === "+" || path.length <= 2) return null;
+    const username = path;
+    const parameter = query.get("start");
+    if (!parameter) return null;
+    return { username, parameter };
+  }
+});
+function normalizeBotAdmin(rights) {
+  if (!rights?.length) return;
+  return rights.map((it) => {
+    switch (it) {
+      case "changeInfo":
+        return "change_info";
+      case "postMessages":
+        return "post_messages";
+      case "editMessages":
+        return "edit_messages";
+      case "deleteMessages":
+        return "delete_messages";
+      case "banUsers":
+        return "restrict_members";
+      case "inviteUsers":
+        return "invite_users";
+      case "pinMessages":
+        return "pin_messages";
+      case "manageTopics":
+        return "manage_topics";
+      case "addAdmins":
+        return "promote_members";
+      case "manageCall":
+        return "manage_video_chats";
+      case "anonymous":
+        return "anonymous";
+      case "other":
+        return "manage_chat";
+      case "postStories":
+        return "post_stories";
+      case "editStories":
+        return "edit_stories";
+      case "deleteStories":
+        return "delete_stories";
+      default:
+        utils.assertNever();
+        return "";
+    }
+  }).join("+");
+}
+function parseBotAdmin(rights) {
+  if (!rights) return;
+  return rights.split("+").map((it) => {
+    switch (it) {
+      case "change_info":
+        return "changeInfo";
+      case "post_messages":
+        return "postMessages";
+      case "edit_messages":
+        return "editMessages";
+      case "delete_messages":
+        return "deleteMessages";
+      case "restrict_members":
+        return "banUsers";
+      case "invite_users":
+        return "inviteUsers";
+      case "pin_messages":
+        return "pinMessages";
+      case "manage_topics":
+        return "manageTopics";
+      case "promote_members":
+        return "addAdmins";
+      case "manage_video_chats":
+        return "manageCall";
+      case "anonymous":
+        return "anonymous";
+      case "manage_chat":
+        return "other";
+      case "post_stories":
+        return "postStories";
+      case "edit_stories":
+        return "editStories";
+      case "delete_stories":
+        return "deleteStories";
+      default:
+        return null;
+    }
+  }).filter(typeAssertions.isPresent);
+}
+const botAddToGroup = /* @__PURE__ */ common.deeplinkBuilder({
+  internalBuild: ({ bot, parameter, admin }) => [
+    "resolve",
+    { domain: bot, startgroup: parameter ?? true, admin: normalizeBotAdmin(admin) }
+  ],
+  internalParse: (path, query) => {
+    if (path !== "resolve") return null;
+    const bot = query.get("domain");
+    const parameter = query.get("startgroup");
+    const admin = query.get("admin");
+    if (!bot || parameter === null) return null;
+    return {
+      bot,
+      parameter: parameter === "" ? void 0 : parameter,
+      admin: parseBotAdmin(admin)
+    };
+  },
+  externalBuild: ({ bot, parameter, admin }) => [
+    bot,
+    { startgroup: parameter ?? true, admin: normalizeBotAdmin(admin) }
+  ],
+  externalParse: (path, query) => {
+    if (path.includes("/") || path[0] === "+" || path.length <= 2) return null;
+    const bot = path;
+    const parameter = query.get("startgroup");
+    const admin = query.get("admin");
+    if (parameter === null) return null;
+    return {
+      bot,
+      parameter: parameter === "" ? void 0 : parameter,
+      admin: parseBotAdmin(admin)
+    };
+  }
+});
+const botAddToChannel = /* @__PURE__ */ common.deeplinkBuilder({
+  internalBuild: ({ bot, admin }) => [
+    "resolve",
+    { domain: bot, startchannel: true, admin: normalizeBotAdmin(admin) }
+  ],
+  internalParse: (path, query) => {
+    if (path !== "resolve") return null;
+    const bot = query.get("domain");
+    const parameter = query.get("startchannel");
+    const admin = query.get("admin");
+    if (!bot || parameter === null) return null;
+    return {
+      bot,
+      admin: parseBotAdmin(admin)
+    };
+  },
+  externalBuild: ({ bot, admin }) => [bot, { startchannel: true, admin: normalizeBotAdmin(admin) }],
+  externalParse: (path, query) => {
+    if (path.includes("/") || path[0] === "+" || path.length <= 2) return null;
+    const bot = path;
+    const parameter = query.get("startchannel");
+    const admin = query.get("admin");
+    if (parameter === null) return null;
+    return {
+      bot,
+      admin: parseBotAdmin(admin)
+    };
+  }
+});
+const botGame = /* @__PURE__ */ common.deeplinkBuilder({
+  internalBuild: ({ bot, game }) => ["resolve", { domain: bot, game }],
+  internalParse: (path, query) => {
+    if (path !== "resolve") return null;
+    const bot = query.get("domain");
+    const game = query.get("game");
+    if (!bot || !game) return null;
+    return { bot, game };
+  },
+  externalBuild: ({ bot, game }) => [bot, { game }],
+  externalParse: (path, query) => {
+    if (path.includes("/") || path[0] === "+" || path.length <= 2) return null;
+    const bot = path;
+    const game = query.get("game");
+    if (!game) return null;
+    return { bot, game };
+  }
+});
+const botWebApp = /* @__PURE__ */ common.deeplinkBuilder({
+  internalBuild: ({ bot, app, parameter }) => ["resolve", { domain: bot, appname: app, startapp: parameter }],
+  internalParse: (path, query) => {
+    if (path !== "resolve") return null;
+    const bot = query.get("domain");
+    const app = query.get("appname");
+    const parameter = query.get("startapp");
+    if (!bot || !app) return null;
+    return { bot, app, parameter: parameter || void 0 };
+  },
+  externalBuild: ({ bot, app, parameter }) => [`${bot}/${app}`, { startapp: parameter }],
+  externalParse: (path, query) => {
+    const [bot, app, rest] = path.split("/");
+    if (!app || rest) return null;
+    const parameter = query.get("startapp");
+    return { bot, app, parameter: parameter || void 0 };
+  }
+});
+exports.botAddToChannel = botAddToChannel;
+exports.botAddToGroup = botAddToGroup;
+exports.botGame = botGame;
+exports.botStart = botStart;
+exports.botWebApp = botWebApp;

package/utils/links/bots.d.cts

@@ -0,0 +1,72 @@
+import { tl } from '@mtcute/tl';
+import { Deeplink } from './common.js';
+/**
+ * Bot deeplinks
+ *
+ * Used to link to bots with a start parameter
+ */
+export declare const botStart: Deeplink<{
+    /** Bot username */
+    username: string;
+    /** Start parameter */
+    parameter: string;
+}>;
+type BotAdminRight = Exclude<keyof tl.RawChatAdminRights, '_'>;
+/**
+ * Bot add to group links
+ *
+ * Used to ask the user to add a bot to a group, optionally asking for admin rights.
+ * Note that the user is still free to choose which rights to grant, and
+ * whether to grant them at all.
+ */
+export declare const botAddToGroup: Deeplink<{
+    /** Bot username */
+    bot: string;
+    /** If specified, the client will call `/start parameter` on the bot once the bot has been added */
+    parameter?: string;
+    /** Admin rights to request */
+    admin?: BotAdminRight[];
+}>;
+/**
+ * Bot add to channel links
+ *
+ * Used to ask the user to add a bot to a channel, optionally with admin rights.
+ * Note that the user is still free to choose which rights to grant, and
+ * whether to grant them at all.
+ */
+export declare const botAddToChannel: Deeplink<{
+    /** Bot username */
+    bot: string;
+    /** Admin rights to request */
+    admin?: BotAdminRight[];
+}>;
+/**
+ * Game links
+ *
+ * Used to share games.
+ */
+export declare const botGame: Deeplink<{
+    /** Bot username */
+    bot: string;
+    /** Game short name */
+    game: string;
+}>;
+/**
+ * Named bot web app links
+ *
+ * Used to share named bot web apps.
+ *
+ * These links are different from bot attachment menu deep links,
+ * because they don't require the user to install an attachment menu,
+ * and a single bot can offer multiple named web apps, distinguished by
+ * their `short_name`.
+ */
+export declare const botWebApp: Deeplink<{
+    /** Bot username */
+    bot: string;
+    /** App short name */
+    app: string;
+    /** Parameter to be passed by the client to messages.requestAppWebView as `start_param` */
+    parameter?: string;
+}>;
+export {};

package/utils/links/bots.js

@@ -0,0 +1,206 @@
+import { assertNever } from "../../types/utils.js";
+import { isPresent } from "../type-assertions.js";
+import { deeplinkBuilder } from "./common.js";
+const botStart = /* @__PURE__ */ deeplinkBuilder({
+  internalBuild: ({ username, parameter }) => ["resolve", { domain: username, start: parameter }],
+  internalParse: (path, query) => {
+    if (path !== "resolve") return null;
+    const username = query.get("domain");
+    const parameter = query.get("start");
+    if (!username || !parameter) return null;
+    return { username, parameter };
+  },
+  externalBuild: ({ username, parameter }) => [username, { start: parameter }],
+  externalParse: (path, query) => {
+    if (path.includes("/") || path[0] === "+" || path.length <= 2) return null;
+    const username = path;
+    const parameter = query.get("start");
+    if (!parameter) return null;
+    return { username, parameter };
+  }
+});
+function normalizeBotAdmin(rights) {
+  if (!rights?.length) return;
+  return rights.map((it) => {
+    switch (it) {
+      case "changeInfo":
+        return "change_info";
+      case "postMessages":
+        return "post_messages";
+      case "editMessages":
+        return "edit_messages";
+      case "deleteMessages":
+        return "delete_messages";
+      case "banUsers":
+        return "restrict_members";
+      case "inviteUsers":
+        return "invite_users";
+      case "pinMessages":
+        return "pin_messages";
+      case "manageTopics":
+        return "manage_topics";
+      case "addAdmins":
+        return "promote_members";
+      case "manageCall":
+        return "manage_video_chats";
+      case "anonymous":
+        return "anonymous";
+      case "other":
+        return "manage_chat";
+      case "postStories":
+        return "post_stories";
+      case "editStories":
+        return "edit_stories";
+      case "deleteStories":
+        return "delete_stories";
+      default:
+        assertNever();
+        return "";
+    }
+  }).join("+");
+}
+function parseBotAdmin(rights) {
+  if (!rights) return;
+  return rights.split("+").map((it) => {
+    switch (it) {
+      case "change_info":
+        return "changeInfo";
+      case "post_messages":
+        return "postMessages";
+      case "edit_messages":
+        return "editMessages";
+      case "delete_messages":
+        return "deleteMessages";
+      case "restrict_members":
+        return "banUsers";
+      case "invite_users":
+        return "inviteUsers";
+      case "pin_messages":
+        return "pinMessages";
+      case "manage_topics":
+        return "manageTopics";
+      case "promote_members":
+        return "addAdmins";
+      case "manage_video_chats":
+        return "manageCall";
+      case "anonymous":
+        return "anonymous";
+      case "manage_chat":
+        return "other";
+      case "post_stories":
+        return "postStories";
+      case "edit_stories":
+        return "editStories";
+      case "delete_stories":
+        return "deleteStories";
+      default:
+        return null;
+    }
+  }).filter(isPresent);
+}
+const botAddToGroup = /* @__PURE__ */ deeplinkBuilder({
+  internalBuild: ({ bot, parameter, admin }) => [
+    "resolve",
+    { domain: bot, startgroup: parameter ?? true, admin: normalizeBotAdmin(admin) }
+  ],
+  internalParse: (path, query) => {
+    if (path !== "resolve") return null;
+    const bot = query.get("domain");
+    const parameter = query.get("startgroup");
+    const admin = query.get("admin");
+    if (!bot || parameter === null) return null;
+    return {
+      bot,
+      parameter: parameter === "" ? void 0 : parameter,
+      admin: parseBotAdmin(admin)
+    };
+  },
+  externalBuild: ({ bot, parameter, admin }) => [
+    bot,
+    { startgroup: parameter ?? true, admin: normalizeBotAdmin(admin) }
+  ],
+  externalParse: (path, query) => {
+    if (path.includes("/") || path[0] === "+" || path.length <= 2) return null;
+    const bot = path;
+    const parameter = query.get("startgroup");
+    const admin = query.get("admin");
+    if (parameter === null) return null;
+    return {
+      bot,
+      parameter: parameter === "" ? void 0 : parameter,
+      admin: parseBotAdmin(admin)
+    };
+  }
+});
+const botAddToChannel = /* @__PURE__ */ deeplinkBuilder({
+  internalBuild: ({ bot, admin }) => [
+    "resolve",
+    { domain: bot, startchannel: true, admin: normalizeBotAdmin(admin) }
+  ],
+  internalParse: (path, query) => {
+    if (path !== "resolve") return null;
+    const bot = query.get("domain");
+    const parameter = query.get("startchannel");
+    const admin = query.get("admin");
+    if (!bot || parameter === null) return null;
+    return {
+      bot,
+      admin: parseBotAdmin(admin)
+    };
+  },
+  externalBuild: ({ bot, admin }) => [bot, { startchannel: true, admin: normalizeBotAdmin(admin) }],
+  externalParse: (path, query) => {
+    if (path.includes("/") || path[0] === "+" || path.length <= 2) return null;
+    const bot = path;
+    const parameter = query.get("startchannel");
+    const admin = query.get("admin");
+    if (parameter === null) return null;
+    return {
+      bot,
+      admin: parseBotAdmin(admin)
+    };
+  }
+});
+const botGame = /* @__PURE__ */ deeplinkBuilder({
+  internalBuild: ({ bot, game }) => ["resolve", { domain: bot, game }],
+  internalParse: (path, query) => {
+    if (path !== "resolve") return null;
+    const bot = query.get("domain");
+    const game = query.get("game");
+    if (!bot || !game) return null;
+    return { bot, game };
+  },
+  externalBuild: ({ bot, game }) => [bot, { game }],
+  externalParse: (path, query) => {
+    if (path.includes("/") || path[0] === "+" || path.length <= 2) return null;
+    const bot = path;
+    const game = query.get("game");
+    if (!game) return null;
+    return { bot, game };
+  }
+});
+const botWebApp = /* @__PURE__ */ deeplinkBuilder({
+  internalBuild: ({ bot, app, parameter }) => ["resolve", { domain: bot, appname: app, startapp: parameter }],
+  internalParse: (path, query) => {
+    if (path !== "resolve") return null;
+    const bot = query.get("domain");
+    const app = query.get("appname");
+    const parameter = query.get("startapp");
+    if (!bot || !app) return null;
+    return { bot, app, parameter: parameter || void 0 };
+  },
+  externalBuild: ({ bot, app, parameter }) => [`${bot}/${app}`, { startapp: parameter }],
+  externalParse: (path, query) => {
+    const [bot, app, rest] = path.split("/");
+    if (!app || rest) return null;
+    const parameter = query.get("startapp");
+    return { bot, app, parameter: parameter || void 0 };
+  }
+});
+export {
+  botAddToChannel,
+  botAddToGroup,
+  botGame,
+  botStart,
+  botWebApp
+};

package/utils/links/bots.test.d.cts

@@ -0,0 +1 @@
+export {};

package/utils/links/bundle.cjs

@@ -0,0 +1,32 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const bots = require("./bots.cjs");
+const calls = require("./calls.cjs");
+const chat = require("./chat.cjs");
+const misc = require("./misc.cjs");
+const proxy = require("./proxy.cjs");
+const stickers = require("./stickers.cjs");
+const user = require("./user.cjs");
+exports.botAddToChannel = bots.botAddToChannel;
+exports.botAddToGroup = bots.botAddToGroup;
+exports.botGame = bots.botGame;
+exports.botStart = bots.botStart;
+exports.botWebApp = bots.botWebApp;
+exports.videoChat = calls.videoChat;
+exports.chatFolder = chat.chatFolder;
+exports.chatInvite = chat.chatInvite;
+exports.message = chat.message;
+exports.boost = misc.boost;
+exports.folder = misc.folder;
+exports.share = misc.share;
+exports.mtproxy = proxy.mtproxy;
+exports.socks5 = proxy.socks5;
+exports.stickerset = stickers.stickerset;
+exports.phoneNumber = user.phoneNumber;
+exports.publicUsername = user.publicUsername;
+exports.temporaryProfile = user.temporaryProfile;

package/utils/links/bundle.d.cts

@@ -0,0 +1,7 @@
+export * from './bots.js';
+export * from './calls.js';
+export * from './chat.js';
+export * from './misc.js';
+export * from './proxy.js';
+export * from './stickers.js';
+export * from './user.js';

package/utils/links/bundle.js

@@ -0,0 +1,27 @@
+import { botAddToChannel, botAddToGroup, botGame, botStart, botWebApp } from "./bots.js";
+import { videoChat } from "./calls.js";
+import { chatFolder, chatInvite, message } from "./chat.js";
+import { boost, folder, share } from "./misc.js";
+import { mtproxy, socks5 } from "./proxy.js";
+import { stickerset } from "./stickers.js";
+import { phoneNumber, publicUsername, temporaryProfile } from "./user.js";
+export {
+  boost,
+  botAddToChannel,
+  botAddToGroup,
+  botGame,
+  botStart,
+  botWebApp,
+  chatFolder,
+  chatInvite,
+  folder,
+  message,
+  mtproxy,
+  phoneNumber,
+  publicUsername,
+  share,
+  socks5,
+  stickerset,
+  temporaryProfile,
+  videoChat
+};

package/utils/links/calls.cjs

@@ -0,0 +1,52 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const common = require("./common.cjs");
+const videoChat = /* @__PURE__ */ common.deeplinkBuilder({
+  internalBuild: ({ username, inviteHash, isLivestream }) => [
+    "resolve",
+    {
+      domain: username,
+      [isLivestream ? "livestream" : "videochat"]: inviteHash || true
+    }
+  ],
+  externalBuild: ({ username, inviteHash, isLivestream }) => [
+    username,
+    {
+      [isLivestream ? "livestream" : "videochat"]: inviteHash || true
+    }
+  ],
+  internalParse: (path, query) => {
+    if (path !== "resolve") return null;
+    const domain = query.get("domain");
+    if (!domain) return null;
+    const livestream = query.get("livestream");
+    const videochat = query.get("videochat");
+    const voicechat = query.get("voicechat");
+    if (livestream === null && videochat === null && voicechat === null) return null;
+    const inviteHash = livestream || videochat || voicechat;
+    return {
+      username: domain,
+      inviteHash: inviteHash || void 0,
+      isLivestream: livestream !== null
+    };
+  },
+  externalParse: (path, query) => {
+    if (path.length <= 1 || path.includes("/") || path[0] === "+") return null;
+    const livestream = query.get("livestream");
+    const videochat = query.get("videochat");
+    const voicechat = query.get("voicechat");
+    if (livestream === null && videochat === null && voicechat === null) return null;
+    const inviteHash = livestream || videochat || voicechat;
+    return {
+      username: path,
+      inviteHash: inviteHash || void 0,
+      isLivestream: livestream !== null
+    };
+  }
+});
+exports.videoChat = videoChat;

package/utils/links/calls.d.cts

@@ -0,0 +1,17 @@
+import { Deeplink } from './common.js';
+/**
+ * Video chat/Livestream links
+ *
+ * Used to join video/voice chats in groups, and livestreams in channels.
+ * Such links are generated using phone.exportGroupCallInvite.
+ */
+export declare const videoChat: Deeplink<{
+    username: string;
+    /**
+     * Invite hash exported if the `can_self_unmute` flag is set when calling `phone.exportGroupCallInvite`:
+     * should be passed to `phone.joinGroupCall`, allows the user to speak in livestreams
+     * or muted group chats.
+     */
+    inviteHash?: string;
+    isLivestream?: boolean;
+}>;

package/utils/links/calls.js

@@ -0,0 +1,47 @@
+import { deeplinkBuilder } from "./common.js";
+const videoChat = /* @__PURE__ */ deeplinkBuilder({
+  internalBuild: ({ username, inviteHash, isLivestream }) => [
+    "resolve",
+    {
+      domain: username,
+      [isLivestream ? "livestream" : "videochat"]: inviteHash || true
+    }
+  ],
+  externalBuild: ({ username, inviteHash, isLivestream }) => [
+    username,
+    {
+      [isLivestream ? "livestream" : "videochat"]: inviteHash || true
+    }
+  ],
+  internalParse: (path, query) => {
+    if (path !== "resolve") return null;
+    const domain = query.get("domain");
+    if (!domain) return null;
+    const livestream = query.get("livestream");
+    const videochat = query.get("videochat");
+    const voicechat = query.get("voicechat");
+    if (livestream === null && videochat === null && voicechat === null) return null;
+    const inviteHash = livestream || videochat || voicechat;
+    return {
+      username: domain,
+      inviteHash: inviteHash || void 0,
+      isLivestream: livestream !== null
+    };
+  },
+  externalParse: (path, query) => {
+    if (path.length <= 1 || path.includes("/") || path[0] === "+") return null;
+    const livestream = query.get("livestream");
+    const videochat = query.get("videochat");
+    const voicechat = query.get("voicechat");
+    if (livestream === null && videochat === null && voicechat === null) return null;
+    const inviteHash = livestream || videochat || voicechat;
+    return {
+      username: path,
+      inviteHash: inviteHash || void 0,
+      isLivestream: livestream !== null
+    };
+  }
+});
+export {
+  videoChat
+};