@mtcute/dispatcher 0.17.0 → 0.18.0-rc.5

package/callback-data-builder.cjs

@@ -0,0 +1,126 @@
+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 core = require("@mtcute/core");
+class CallbackDataBuilder {
+  /**
+   * @param prefix  Prefix for the data. Use something unique across your bot.
+   * @param fields  Field names in the order they will be serialized.
+   */
+  constructor(prefix, ...fields) {
+    this.prefix = prefix;
+    this._fields = fields;
+  }
+  _fields;
+  sep = ":";
+  /**
+   * Build a callback data string
+   *
+   * @param obj  Object containing the data
+   */
+  build(obj) {
+    const ret = this.prefix + this.sep + this._fields.map((f) => {
+      const val = obj[f];
+      if (val.includes(this.sep)) {
+        throw new core.MtArgumentError(
+          `Value for ${f} ${val} contains separator ${this.sep} and cannot be used.`
+        );
+      }
+      return val;
+    }).join(this.sep);
+    if (ret.length > 64) {
+      throw new core.MtArgumentError("Resulting callback data is too long.");
+    }
+    return ret;
+  }
+  parse(data, safe = false) {
+    const parts = data.split(this.sep);
+    if (parts[0] !== this.prefix) {
+      if (safe) return null;
+      throw new core.MtArgumentError(
+        `Invalid data passed: "${data}" (bad prefix, expected ${this.prefix}, got ${parts[0]})`
+      );
+    }
+    if (parts.length !== this._fields.length + 1) {
+      if (safe) return null;
+      throw new core.MtArgumentError(
+        `Invalid data passed: "${data}" (bad parts count, expected ${this._fields.length}, got ${parts.length - 1})`
+      );
+    }
+    const ret = {};
+    parts.forEach((it, idx) => {
+      if (idx === 0) return;
+      ret[this._fields[idx - 1]] = it;
+    });
+    return ret;
+  }
+  /**
+   * Create a filter for this callback data.
+   *
+   * You can either pass an object with field names as keys and values as strings or regexes,
+   * which will be compiled to a RegExp, or a function that will be called with the parsed data.
+   * Note that the strings will be passed to `RegExp` **directly**, so you may want to escape them.
+   *
+   * When using a function, you can either return a boolean, or an object with field names as keys
+   * and values as strings or regexes. In the latter case, the resulting object will be matched
+   * against the parsed data the same way as if you passed it directly.
+   *
+   * @param params
+   */
+  filter(params = {}) {
+    if (typeof params === "function") {
+      return async (query) => {
+        if (!query.dataStr) return false;
+        const data = this.parse(query.dataStr, true);
+        if (!data) return false;
+        const fnResult = await params(query, data);
+        if (typeof fnResult === "boolean") {
+          query.match = data;
+          return fnResult;
+        }
+        for (const key in fnResult) {
+          const value = data[key];
+          if (value === void 0) return false;
+          let matchers = fnResult[key];
+          if (!Array.isArray(matchers)) matchers = [matchers];
+          for (const matcher of matchers) {
+            if (typeof matcher === "string") {
+              if (value !== matcher) return false;
+            } else if (!matcher.test(value)) {
+              return false;
+            }
+          }
+        }
+        query.match = data;
+        return true;
+      };
+    }
+    const parts = [];
+    this._fields.forEach((field) => {
+      if (!(field in params)) {
+        parts.push(`[^${this.sep}]*?`);
+        return;
+      }
+      const value = params[field];
+      if (Array.isArray(value)) {
+        parts.push(`(${value.map((i) => typeof i === "string" ? i : i.source).join("|")})`);
+      } else {
+        parts.push(typeof value === "string" ? value : value.source);
+      }
+    });
+    const regex = new RegExp(`^${this.prefix}${this.sep}${parts.join(this.sep)}$`);
+    return (query) => {
+      const m = query.dataStr?.match(regex);
+      if (!m) {
+        return false;
+      }
+      query.match = this.parse(m[0]);
+      return true;
+    };
+  }
+}
+exports.CallbackDataBuilder = CallbackDataBuilder;

package/callback-data-builder.js

@@ -0,0 +1,121 @@
+import { MtArgumentError } from "@mtcute/core";
+class CallbackDataBuilder {
+  /**
+   * @param prefix  Prefix for the data. Use something unique across your bot.
+   * @param fields  Field names in the order they will be serialized.
+   */
+  constructor(prefix, ...fields) {
+    this.prefix = prefix;
+    this._fields = fields;
+  }
+  _fields;
+  sep = ":";
+  /**
+   * Build a callback data string
+   *
+   * @param obj  Object containing the data
+   */
+  build(obj) {
+    const ret = this.prefix + this.sep + this._fields.map((f) => {
+      const val = obj[f];
+      if (val.includes(this.sep)) {
+        throw new MtArgumentError(
+          `Value for ${f} ${val} contains separator ${this.sep} and cannot be used.`
+        );
+      }
+      return val;
+    }).join(this.sep);
+    if (ret.length > 64) {
+      throw new MtArgumentError("Resulting callback data is too long.");
+    }
+    return ret;
+  }
+  parse(data, safe = false) {
+    const parts = data.split(this.sep);
+    if (parts[0] !== this.prefix) {
+      if (safe) return null;
+      throw new MtArgumentError(
+        `Invalid data passed: "${data}" (bad prefix, expected ${this.prefix}, got ${parts[0]})`
+      );
+    }
+    if (parts.length !== this._fields.length + 1) {
+      if (safe) return null;
+      throw new MtArgumentError(
+        `Invalid data passed: "${data}" (bad parts count, expected ${this._fields.length}, got ${parts.length - 1})`
+      );
+    }
+    const ret = {};
+    parts.forEach((it, idx) => {
+      if (idx === 0) return;
+      ret[this._fields[idx - 1]] = it;
+    });
+    return ret;
+  }
+  /**
+   * Create a filter for this callback data.
+   *
+   * You can either pass an object with field names as keys and values as strings or regexes,
+   * which will be compiled to a RegExp, or a function that will be called with the parsed data.
+   * Note that the strings will be passed to `RegExp` **directly**, so you may want to escape them.
+   *
+   * When using a function, you can either return a boolean, or an object with field names as keys
+   * and values as strings or regexes. In the latter case, the resulting object will be matched
+   * against the parsed data the same way as if you passed it directly.
+   *
+   * @param params
+   */
+  filter(params = {}) {
+    if (typeof params === "function") {
+      return async (query) => {
+        if (!query.dataStr) return false;
+        const data = this.parse(query.dataStr, true);
+        if (!data) return false;
+        const fnResult = await params(query, data);
+        if (typeof fnResult === "boolean") {
+          query.match = data;
+          return fnResult;
+        }
+        for (const key in fnResult) {
+          const value = data[key];
+          if (value === void 0) return false;
+          let matchers = fnResult[key];
+          if (!Array.isArray(matchers)) matchers = [matchers];
+          for (const matcher of matchers) {
+            if (typeof matcher === "string") {
+              if (value !== matcher) return false;
+            } else if (!matcher.test(value)) {
+              return false;
+            }
+          }
+        }
+        query.match = data;
+        return true;
+      };
+    }
+    const parts = [];
+    this._fields.forEach((field) => {
+      if (!(field in params)) {
+        parts.push(`[^${this.sep}]*?`);
+        return;
+      }
+      const value = params[field];
+      if (Array.isArray(value)) {
+        parts.push(`(${value.map((i) => typeof i === "string" ? i : i.source).join("|")})`);
+      } else {
+        parts.push(typeof value === "string" ? value : value.source);
+      }
+    });
+    const regex = new RegExp(`^${this.prefix}${this.sep}${parts.join(this.sep)}$`);
+    return (query) => {
+      const m = query.dataStr?.match(regex);
+      if (!m) {
+        return false;
+      }
+      query.match = this.parse(m[0]);
+      return true;
+    };
+  }
+}
+export {
+  CallbackDataBuilder
+};

package/context/business-message.cjs

@@ -0,0 +1,143 @@
+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 core = require("@mtcute/core");
+class BusinessMessageContext extends core.BusinessMessage {
+  constructor(client, message) {
+    const msg = Array.isArray(message) ? message[message.length - 1] : message;
+    super(msg.update, msg._peers);
+    this.client = client;
+    this.messages = Array.isArray(message) ? message.map((it) => new BusinessMessageContext(client, it)) : [this];
+    this.isMessageGroup = Array.isArray(message);
+  }
+  // this is primarily for proper types in filters, so don't bother much with actual value
+  _name = "new_business_message";
+  /**
+   * List of messages in the message group.
+   *
+   * For other updates, this is a list with a single element (`this`).
+   */
+  messages;
+  /** Whether this update is about a message group */
+  isMessageGroup;
+  /** Get all custom emojis contained in this message (message group), if any */
+  getCustomEmojis() {
+    return this.client.getCustomEmojisFromMessages(this.messages);
+  }
+  /** Send a text message to the same chat (and topic, if applicable) as a given message */
+  answerText(...params) {
+    const [send, params_ = {}] = params;
+    params_.businessConnectionId = this.update.connectionId;
+    return this.client.answerText(this, send, params_);
+  }
+  /** Send a media to the same chat (and topic, if applicable) as a given message */
+  answerMedia(...params) {
+    const [send, params_ = {}] = params;
+    params_.businessConnectionId = this.update.connectionId;
+    return this.client.answerMedia(this, send, params_);
+  }
+  /** Send a media group to the same chat (and topic, if applicable) as a given message */
+  answerMediaGroup(...params) {
+    const [send, params_ = {}] = params;
+    params_.businessConnectionId = this.update.connectionId;
+    return this.client.answerMediaGroup(this, send, params_);
+  }
+  /** Send a text message in reply to this message */
+  replyText(...params) {
+    const [send, params_ = {}] = params;
+    params_.businessConnectionId = this.update.connectionId;
+    return this.client.replyText(this, send, params_);
+  }
+  /** Send a media in reply to this message */
+  replyMedia(...params) {
+    const [send, params_ = {}] = params;
+    params_.businessConnectionId = this.update.connectionId;
+    return this.client.replyMedia(this, send, params_);
+  }
+  /** Send a media group in reply to this message */
+  replyMediaGroup(...params) {
+    const [send, params_ = {}] = params;
+    params_.businessConnectionId = this.update.connectionId;
+    return this.client.replyMediaGroup(this, send, params_);
+  }
+  /** Send a text message in reply to this message */
+  quoteWithText(params) {
+    params.businessConnectionId = this.update.connectionId;
+    return this.client.quoteWithText(this, params);
+  }
+  /** Send a media in reply to this message */
+  quoteWithMedia(params) {
+    params.businessConnectionId = this.update.connectionId;
+    return this.client.quoteWithMedia(this, params);
+  }
+  /** Send a media group in reply to this message */
+  quoteWithMediaGroup(params) {
+    params.businessConnectionId = this.update.connectionId;
+    return this.client.quoteWithMediaGroup(this, params);
+  }
+  /** Delete this message (message group) */
+  delete(params) {
+    return this.client.deleteMessagesById(
+      this.chat.inputPeer,
+      this.messages.map((it) => it.id),
+      params
+    );
+  }
+  /** Pin this message */
+  pin(params) {
+    return this.client.pinMessage({
+      chatId: this.chat.inputPeer,
+      message: this.id,
+      ...params
+    });
+  }
+  /** Unpin this message */
+  unpin() {
+    return this.client.unpinMessage({
+      chatId: this.chat.inputPeer,
+      message: this.id
+    });
+  }
+  /** Edit this message */
+  edit(params) {
+    return this.client.editMessage({
+      chatId: this.chat.inputPeer,
+      message: this.id,
+      ...params
+    });
+  }
+  /** Forward this message (message group) */
+  forwardTo(params) {
+    return this.client.forwardMessagesById({
+      fromChatId: this.chat.inputPeer,
+      messages: this.messages.map((it) => it.id),
+      ...params
+    });
+  }
+  /** Send a copy of this message (message group) */
+  copy(params) {
+    if (this.isMessageGroup) {
+      return this.client.sendCopyGroup({
+        messages: this.messages,
+        ...params
+      });
+    }
+    return this.client.sendCopy({
+      message: this,
+      ...params
+    });
+  }
+  /** React to this message */
+  react(params) {
+    return this.client.sendReaction({
+      chatId: this.chat.inputPeer,
+      message: this.id,
+      ...params
+    });
+  }
+}
+exports.BusinessMessageContext = BusinessMessageContext;

package/context/business-message.js

@@ -0,0 +1,138 @@
+import { BusinessMessage } from "@mtcute/core";
+class BusinessMessageContext extends BusinessMessage {
+  constructor(client, message) {
+    const msg = Array.isArray(message) ? message[message.length - 1] : message;
+    super(msg.update, msg._peers);
+    this.client = client;
+    this.messages = Array.isArray(message) ? message.map((it) => new BusinessMessageContext(client, it)) : [this];
+    this.isMessageGroup = Array.isArray(message);
+  }
+  // this is primarily for proper types in filters, so don't bother much with actual value
+  _name = "new_business_message";
+  /**
+   * List of messages in the message group.
+   *
+   * For other updates, this is a list with a single element (`this`).
+   */
+  messages;
+  /** Whether this update is about a message group */
+  isMessageGroup;
+  /** Get all custom emojis contained in this message (message group), if any */
+  getCustomEmojis() {
+    return this.client.getCustomEmojisFromMessages(this.messages);
+  }
+  /** Send a text message to the same chat (and topic, if applicable) as a given message */
+  answerText(...params) {
+    const [send, params_ = {}] = params;
+    params_.businessConnectionId = this.update.connectionId;
+    return this.client.answerText(this, send, params_);
+  }
+  /** Send a media to the same chat (and topic, if applicable) as a given message */
+  answerMedia(...params) {
+    const [send, params_ = {}] = params;
+    params_.businessConnectionId = this.update.connectionId;
+    return this.client.answerMedia(this, send, params_);
+  }
+  /** Send a media group to the same chat (and topic, if applicable) as a given message */
+  answerMediaGroup(...params) {
+    const [send, params_ = {}] = params;
+    params_.businessConnectionId = this.update.connectionId;
+    return this.client.answerMediaGroup(this, send, params_);
+  }
+  /** Send a text message in reply to this message */
+  replyText(...params) {
+    const [send, params_ = {}] = params;
+    params_.businessConnectionId = this.update.connectionId;
+    return this.client.replyText(this, send, params_);
+  }
+  /** Send a media in reply to this message */
+  replyMedia(...params) {
+    const [send, params_ = {}] = params;
+    params_.businessConnectionId = this.update.connectionId;
+    return this.client.replyMedia(this, send, params_);
+  }
+  /** Send a media group in reply to this message */
+  replyMediaGroup(...params) {
+    const [send, params_ = {}] = params;
+    params_.businessConnectionId = this.update.connectionId;
+    return this.client.replyMediaGroup(this, send, params_);
+  }
+  /** Send a text message in reply to this message */
+  quoteWithText(params) {
+    params.businessConnectionId = this.update.connectionId;
+    return this.client.quoteWithText(this, params);
+  }
+  /** Send a media in reply to this message */
+  quoteWithMedia(params) {
+    params.businessConnectionId = this.update.connectionId;
+    return this.client.quoteWithMedia(this, params);
+  }
+  /** Send a media group in reply to this message */
+  quoteWithMediaGroup(params) {
+    params.businessConnectionId = this.update.connectionId;
+    return this.client.quoteWithMediaGroup(this, params);
+  }
+  /** Delete this message (message group) */
+  delete(params) {
+    return this.client.deleteMessagesById(
+      this.chat.inputPeer,
+      this.messages.map((it) => it.id),
+      params
+    );
+  }
+  /** Pin this message */
+  pin(params) {
+    return this.client.pinMessage({
+      chatId: this.chat.inputPeer,
+      message: this.id,
+      ...params
+    });
+  }
+  /** Unpin this message */
+  unpin() {
+    return this.client.unpinMessage({
+      chatId: this.chat.inputPeer,
+      message: this.id
+    });
+  }
+  /** Edit this message */
+  edit(params) {
+    return this.client.editMessage({
+      chatId: this.chat.inputPeer,
+      message: this.id,
+      ...params
+    });
+  }
+  /** Forward this message (message group) */
+  forwardTo(params) {
+    return this.client.forwardMessagesById({
+      fromChatId: this.chat.inputPeer,
+      messages: this.messages.map((it) => it.id),
+      ...params
+    });
+  }
+  /** Send a copy of this message (message group) */
+  copy(params) {
+    if (this.isMessageGroup) {
+      return this.client.sendCopyGroup({
+        messages: this.messages,
+        ...params
+      });
+    }
+    return this.client.sendCopy({
+      message: this,
+      ...params
+    });
+  }
+  /** React to this message */
+  react(params) {
+    return this.client.sendReaction({
+      chatId: this.chat.inputPeer,
+      message: this.id,
+      ...params
+    });
+  }
+}
+export {
+  BusinessMessageContext
+};

package/context/callback-query.cjs

@@ -0,0 +1,92 @@
+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 core = require("@mtcute/core");
+class CallbackQueryContext extends core.CallbackQuery {
+  constructor(client, query) {
+    super(query.raw, query._peers);
+    this.client = client;
+  }
+  _name = "callback_query";
+  /** Answer to this callback query */
+  answer(params) {
+    return this.client.answerCallbackQuery(this.id, params);
+  }
+  /**
+   * Get the message containing the callback button being clicked.
+   *
+   * Note that the message may have been deleted, in which case
+   * `null` will be returned.
+   */
+  async getMessage() {
+    return this.client.getCallbackQueryMessage(this);
+  }
+  /**
+   * Edit the message that contained the callback button that was clicked.
+   */
+  async editMessage(params) {
+    return this.client.editMessage({
+      chatId: this.raw.peer,
+      message: this.raw.msgId,
+      ...params
+    });
+  }
+  /**
+   * Shortcut for getting the message and editing it.
+   */
+  async editMessageWith(handler) {
+    const msg = await this.getMessage();
+    if (!msg) return;
+    const res = await handler(msg);
+    if (!res) return;
+    return this.editMessage(res);
+  }
+}
+class InlineCallbackQueryContext extends core.InlineCallbackQuery {
+  constructor(client, query) {
+    super(query.raw, query._peers);
+    this.client = client;
+  }
+  _name = "inline_callback_query";
+  /** Answer to this callback query */
+  answer(params) {
+    return this.client.answerCallbackQuery(this.id, params);
+  }
+  /**
+   * Edit the message that contained the callback button that was clicked.
+   */
+  async editMessage(params) {
+    return this.client.editInlineMessage({
+      messageId: this.raw.msgId,
+      ...params
+    });
+  }
+}
+class BusinessCallbackQueryContext extends core.BusinessCallbackQuery {
+  constructor(client, query) {
+    super(query.raw, query._peers);
+    this.client = client;
+  }
+  _name = "business_callback_query";
+  /** Answer to this callback query */
+  answer(params) {
+    return this.client.answerCallbackQuery(this.id, params);
+  }
+  /**
+   * Edit the message that contained the callback button that was clicked.
+   */
+  async editMessage(params) {
+    return this.client.editMessage({
+      message: this.message,
+      businessConnectionId: this.connectionId,
+      ...params
+    });
+  }
+}
+exports.BusinessCallbackQueryContext = BusinessCallbackQueryContext;
+exports.CallbackQueryContext = CallbackQueryContext;
+exports.InlineCallbackQueryContext = InlineCallbackQueryContext;