Merge pull request #47 from KnightNiwrem/master

Bot API 9.1

Author: KnightNiwrem

.devcontainer/devcontainer.json

@@ -0,0 +1,15 @@
+{
+  "name": "Deno",
+  "image": "ghcr.io/knightniwrem/devcontainer-deno:latest",
+  "customizations": {
+    "vscode": {
+      "settings": {},
+      "extensions": [
+        "denoland.vscode-deno",
+        "github.copilot",
+        "github.copilot-chat",
+        "kilocode.kilo-code"
+      ]
+    }
+  }
+}

src/format.ts

@@ -17,6 +17,35 @@ export interface Stringable {
   toString(): string;
 }
 
+/**
+ * Represents caption object with optional formatting entities.
+ *
+ * This interface is used to store plain caption along with its associated
+ * formatting information (such as bold, italic, links, etc.) as message entities.
+ *
+ * @example
+ * ```typescript
+ * const formattedCaption: CaptionWithEntities = {
+ *   caption: "Hello world!",
+ *   caption_entities: [
+ *     { type: "bold", offset: 0, length: 5 },
+ *     { type: "italic", offset: 6, length: 5 }
+ *   ]
+ * };
+ * ```
+ */
+export interface CaptionWithEntities {
+  /**
+   * Plain caption value for this `FormattedString`
+   */
+  caption: string;
+
+  /**
+   * Format caption_entities for this `FormattedString`
+   */
+  caption_entities?: MessageEntity[];
+}
+
 /**
  * Represents text object with optional formatting entities.
  *
@@ -47,32 +76,59 @@ export interface TextWithEntities {
 }
 
 /**
- * Represents caption object with optional formatting entities.
+ * Represents text object with optional formatting entities.
  *
- * This interface is used to store plain caption along with its associated
+ * This interface is used to store plain text along with its associated
  * formatting information (such as bold, italic, links, etc.) as message entities.
  *
  * @example
  * ```typescript
- * const formattedCaption: CaptionWithEntities = {
- *   caption: "Hello world!",
- *   caption_entities: [
+ * const formattedText: TextWithTextEntities = {
+ *   text: "Hello world!",
+ *   text_entities: [
  *     { type: "bold", offset: 0, length: 5 },
  *     { type: "italic", offset: 6, length: 5 }
  *   ]
  * };
  * ```
  */
-export interface CaptionWithEntities {
+export interface TextWithTextEntities {
   /**
-   * Plain caption value for this `FormattedString`
+   * Plain text value for this `FormattedString`
    */
-  caption: string;
+  text: string;
+  /**
+   * Format entities for this `FormattedString`
+   */
+  text_entities?: MessageEntity[];
+}
 
+/**
+ * Represents title object with optional formatting entities.
+ *
+ * This interface is used to store plain title along with its associated
+ * formatting information (such as bold, italic, links, etc.) as message entities.
+ *
+ * @example
+ * ```typescript
+ * const formattedTitle: TitleWithTitleEntities = {
+ *   title: "Hello world!",
+ *   title_entities: [
+ *     { type: "bold", offset: 0, length: 5 },
+ *     { type: "italic", offset: 6, length: 5 }
+ *   ]
+ * };
+ * ```
+ */
+export interface TitleWithTitleEntities {
   /**
-   * Format caption_entities for this `FormattedString`
+   * Plain text value for this `FormattedString`
    */
-  caption_entities?: MessageEntity[];
+  title: string;
+  /**
+   * Format entities for this `FormattedString`
+   */
+  title_entities?: MessageEntity[];
 }
 
 /**
@@ -81,7 +137,12 @@ export interface CaptionWithEntities {
  * and caption content in Telegram Bot API calls.
  */
 export class FormattedString
-  implements TextWithEntities, CaptionWithEntities, Stringable {
+  implements
+    CaptionWithEntities,
+    TextWithEntities,
+    TextWithTextEntities,
+    TitleWithTitleEntities,
+    Stringable {
   /**
    * The entities backing this FormattedString.
    */
@@ -121,6 +182,30 @@ export class FormattedString
     return this.rawText;
   }
 
+  /**
+   * Gets the title. Alias for rawText.
+   * Used when this FormattedString is used as title.
+   */
+  get title() {
+    return this.rawText;
+  }
+
+  /**
+   * Gets the text_entities. Alias for rawEntities.
+   * Used when this FormattedString is used as text with text_entities.
+   */
+  get text_entities() {
+    return this.rawEntities;
+  }
+
+  /**
+   * Gets the title_entities. Alias for rawEntities.
+   * Used when this FormattedString is used as title_entities.
+   */
+  get title_entities() {
+    return this.rawEntities;
+  }
+
   /**
    * Gets the caption entities. This is an alias for the raw entities.
    * Used when this FormattedString is used as caption content.
@@ -1202,7 +1287,7 @@ export function linkMessage(
       "linkMessage can only be used for supergroups and channel messages. Refusing to transform into link.",
     );
     return fmt`${stringLike}`;
-  } else if (chatId < -1002147483647 || chatId > -1000000000000) {
+  } else if (chatId < -1997852516352 || chatId > -1000000000001) {
     console.warn(
       "linkMessage is not able to link messages whose chatIds are greater than -1000000000000 or less than -1002147483647 at this moment. Refusing to transform into link.",
     );