@imessaging/max 0.7.0

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@imessaging/max",
+  "version": "0.7.0",
+  "description": "MAX Bot API transport for imessaging",
+  "keywords": [
+    "max",
+    "messaging",
+    "transport"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/iconicompany/imessaging.git",
+    "directory": "packages/max"
+  },
+  "files": [
+    "src"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "type-check": "bunx tsgo --noEmit -p tsconfig.json",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@imessaging/core": "0.7.0"
+  },
+  "peerDependencies": {
+    "@maxhub/max-bot-api": ">=0.3.1"
+  }
+}

package/src/index.ts

@@ -0,0 +1 @@
+export { MaxTransport, type MaxTransportOptions } from "./max-transport";

package/src/max-transport.ts

@@ -0,0 +1,159 @@
+import type {
+  EditableMessage,
+  EditableMessageTransport,
+  EditResult,
+  MessageTransport,
+  OutboundButton,
+  OutboundDocument,
+  OutboundMessage,
+  SendResult,
+  TransportStatus,
+} from "@imessaging/core";
+import { Bot, Keyboard } from "@maxhub/max-bot-api";
+import { Buffer } from "node:buffer";
+
+const DEFAULT_API_BASE_URL = "https://platform-api.max.ru";
+
+export type MaxTransportOptions = {
+  accountId: string;
+  token: string;
+  /** Базовый URL API — позволяет переопределить адрес или настроить тестовый сервер. По умолчанию https://platform-api.max.ru */
+  apiBaseUrl?: string;
+  /** Инжектированный экземпляр Bot — для модульных тестов без сетевых запросов. */
+  bot?: Bot;
+};
+
+/** Транспорт MAX поверх официального `@maxhub/max-bot-api`. */
+export class MaxTransport implements MessageTransport, EditableMessageTransport {
+  readonly id: string;
+  private readonly bot: Bot;
+  private connected = false;
+  private lastActivityAt?: Date;
+  private error?: string;
+
+  constructor(private readonly options: MaxTransportOptions) {
+    if (!options.accountId.trim()) throw new Error("accountId must not be empty");
+    if (!options.token.trim()) throw new Error("token must not be empty");
+    this.id = `max:${options.accountId}`;
+    const baseUrl = options.apiBaseUrl ?? DEFAULT_API_BASE_URL;
+    this.bot = options.bot ?? new Bot(options.token, { clientOptions: { baseUrl } });
+  }
+
+  /** Проверяет действительность токена, не запуская polling и не читая окружение. */
+  async connect(): Promise<void> {
+    try {
+      await this.bot.api.getMyInfo();
+      this.connected = true;
+      this.error = undefined;
+    } catch (cause) {
+      this.connected = false;
+      this.error = messageOf(cause);
+      throw cause;
+    }
+  }
+
+  async disconnect(): Promise<void> {
+    this.connected = false;
+  }
+
+  async send(message: OutboundMessage): Promise<SendResult> {
+    if (!this.connected) throw new Error(`${this.id} is not connected`);
+    if (message.recipient.type !== "max") {
+      throw new Error(`${this.id} sends MAX messages and cannot address ${message.recipient.type}`);
+    }
+    const rawChatId = message.recipient.chatId.trim();
+    if (rawChatId.startsWith("+") || !/^-?\d+$/.test(rawChatId)) {
+      throw new Error("MAX chatId must be an integer returned by MAX API (not a phone number)");
+    }
+    const chatId = Number(rawChatId);
+    if (!Number.isSafeInteger(chatId)) {
+      throw new Error("MAX chatId must be a safe integer returned by MAX API");
+    }
+
+    try {
+      const docAttachments = await Promise.all(
+        (message.documents ?? []).map((document) => this.upload(document)),
+      );
+      const keyboardAttachment = mapButtons(message.buttons);
+      const attachments = [...docAttachments, ...(keyboardAttachment ? [keyboardAttachment] : [])];
+
+      const sent = await this.bot.api.sendMessageToChat(chatId, message.text, {
+        attachments: attachments.length > 0 ? attachments : undefined,
+        format: mapFormat(message.parseMode),
+      });
+      this.lastActivityAt = new Date();
+      return {
+        transportId: this.id,
+        messageId: sent.body.mid,
+        recipientId: message.recipient.chatId,
+      };
+    } catch (cause) {
+      this.error = messageOf(cause);
+      throw cause;
+    }
+  }
+
+  async edit(message: EditableMessage): Promise<EditResult> {
+    if (!this.connected) throw new Error(`${this.id} is not connected`);
+    if (message.recipient.type !== "max") {
+      throw new Error(`${this.id} sends MAX messages and cannot address ${message.recipient.type}`);
+    }
+    try {
+      const keyboardAttachment = mapButtons(message.buttons);
+      await this.bot.api.editMessage(message.messageId, {
+        text: message.text,
+        attachments: keyboardAttachment ? [keyboardAttachment] : undefined,
+        format: mapFormat(message.parseMode),
+      });
+      this.lastActivityAt = new Date();
+      return {
+        transportId: this.id,
+        messageId: message.messageId,
+        recipientId: message.recipient.chatId,
+      };
+    } catch (cause) {
+      this.error = messageOf(cause);
+      throw cause;
+    }
+  }
+
+  async getStatus(): Promise<TransportStatus> {
+    return {
+      connected: this.connected,
+      transportId: this.id,
+      accountId: this.options.accountId,
+      lastActivityAt: this.lastActivityAt,
+      error: this.error,
+    };
+  }
+
+  private async upload(document: OutboundDocument) {
+    const source = Buffer.from(document.data);
+    const uploaded = document.mimeType?.startsWith("image/")
+      ? await this.bot.api.uploadImage({ source })
+      : await this.bot.api.uploadFile({ source });
+    return uploaded.toJson();
+  }
+}
+
+function mapFormat(parseMode?: OutboundMessage["parseMode"]): "html" | "markdown" {
+  if (parseMode === "Markdown" || parseMode === "MarkdownV2") return "markdown";
+  return "html";
+}
+
+function mapButtons(buttons?: OutboundButton[][]) {
+  if (!buttons || buttons.length === 0) return undefined;
+  const keyboardButtons = buttons.map((row) =>
+    row.map((button) => {
+      if (button.url) {
+        return Keyboard.button.link(button.text, button.url);
+      }
+      return Keyboard.button.callback(button.text, button.callbackData ?? "");
+    }),
+  );
+  return Keyboard.inlineKeyboard(keyboardButtons);
+}
+
+function messageOf(cause: unknown): string {
+  return cause instanceof Error ? cause.message : String(cause);
+}