@chatman-media/channel-telegram 1.1.0 → 1.2.0

package/dist/bot-api/client.d.ts

@@ -115,6 +115,7 @@ export declare class TelegramClient {
         callbackQueryId: string;
         text?: string;
         showAlert?: boolean;
+        url?: string;
     }): Promise<true>;
     sendChatAction(input: {
         chatId: number | string;

package/dist/bot-api/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/bot-api/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/bot-api/client.ts"],"names":[],"mappings":"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"}

package/dist/bot-api/client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.test.d.ts.map

package/dist/bot-api/client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.test.d.ts","sourceRoot":"","sources":["../../src/bot-api/client.test.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -32668,6 +32668,8 @@ class TelegramClient {
       params.text = input.text;
     if (input.showAlert)
       params.show_alert = input.showAlert;
+    if (input.url)
+      params.url = input.url;
     return this.call("answerCallbackQuery", params);
   }
   sendChatAction(input) {
@@ -32972,6 +32974,16 @@ var import_telegram = __toESM(require_telegram(), 1);
 var import_events = __toESM(require_events(), 1);
 var import_Logger = __toESM(require_Logger(), 1);
 var import_sessions = __toESM(require_sessions(), 1);
+function defaultGramjsClientFactory(o) {
+  const session = new import_sessions.StringSession(o.sessionString);
+  const client = new import_telegram.TelegramClient(session, o.apiId, o.apiHash, {
+    connectionRetries: o.connectionRetries,
+    retryDelay: o.retryDelayMs,
+    timeout: 30
+  });
+  client.setLogLevel(import_Logger.LogLevel.NONE);
+  return client;
+}
 var TG_USERBOT_CAPABILITIES = {
   text: true,
   photo: true,
@@ -33004,13 +33016,13 @@ class TelegramUserbotAdapter {
   async connect() {
     if (this.client && this.client.connected)
       return;
-    const session = new import_sessions.StringSession(this.opts.sessionString);
-    const client = new import_telegram.TelegramClient(session, this.opts.apiId, this.opts.apiHash, {
+    const client = (this.opts.clientFactory ?? defaultGramjsClientFactory)({
+      sessionString: this.opts.sessionString,
+      apiId: this.opts.apiId,
+      apiHash: this.opts.apiHash,
       connectionRetries: this.opts.connectionRetries ?? 5,
-      retryDelay: this.opts.retryDelayMs ?? 3000,
-      timeout: 30
+      retryDelayMs: this.opts.retryDelayMs ?? 3000
     });
-    client.setLogLevel(import_Logger.LogLevel.NONE);
     const maxAttempts = this.opts.connectionRetries ?? 5;
     let lastErr = null;
     for (let attempt = 1;attempt <= maxAttempts; attempt++) {
@@ -33344,10 +33356,11 @@ function mapRpcError(err) {
   }
   return new UserbotLoginError("unknown", msg);
 }
+function defaultLoginClientFactory(apiId, apiHash) {
+  return new import_telegram2.TelegramClient(new import_sessions2.StringSession(""), apiId, apiHash, { connectionRetries: 3 });
+}
 async function startUserbotLogin(opts) {
-  const client = new import_telegram2.TelegramClient(new import_sessions2.StringSession(""), opts.apiId, opts.apiHash, {
-    connectionRetries: 3
-  });
+  const client = (opts.clientFactory ?? defaultLoginClientFactory)(opts.apiId, opts.apiHash);
   await client.connect();
   try {
     const { phoneCodeHash } = await client.sendCode({ apiId: opts.apiId, apiHash: opts.apiHash }, opts.phone);

package/dist/userbot/adapter.d.ts

@@ -1,4 +1,5 @@
 import type { ChannelAdapter, ChannelCapabilities, DeleteOpts, EditOpts, Inbound, MediaRef, OutboundEnvelope, Sent } from "@chatman-media/channel-core";
+import { TelegramClient as GramjsClient } from "telegram";
 /**
  * Healthcheck-статусы MTProto userbot'а. apps/worker отслеживает их через
  * healthEvents() async iterable и:
@@ -52,6 +53,19 @@ export interface TelegramUserbotAdapterOptions {
     connectionRetries?: number;
     /** ms между connect-попытками, default 5000. */
     retryDelayMs?: number;
+    /**
+     * Фабрика gramjs-клиента. По умолчанию — реальный конструктор
+     * (StringSession + GramjsClient + setLogLevel). Инъектируется в тестах,
+     * чтобы покрыть connect() без живого MTProto-соединения.
+     */
+    clientFactory?: (opts: GramjsClientFactoryOpts) => GramjsClient;
+}
+export interface GramjsClientFactoryOpts {
+    sessionString: string;
+    apiId: number;
+    apiHash: string;
+    connectionRetries: number;
+    retryDelayMs: number;
 }
 export declare class TelegramUserbotAdapter implements ChannelAdapter {
     readonly kind: "telegram_userbot";

package/dist/userbot/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/userbot/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,UAAU,EACV,QAAQ,EACR,OAAO,EAEP,QAAQ,EACR,gBAAgB,EAChB,IAAI,EACL,MAAM,6BAA6B,CAAC;AAMrC;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,qBAAqB,GAAG,mBAAmB,CAAC;AAE5F,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,6BAA6B;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACnE,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAcD,qBAAa,sBAAuB,YAAW,cAAc;IAC3D,QAAQ,CAAC,IAAI,EAAG,kBAAkB,CAAU;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,YAAY,sBAA2B;IAEhD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgC;IACrD,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;IACvC,OAAO,CAAC,OAAO,CAAmD;IAClE,OAAO,CAAC,MAAM,CAAS;IACvB;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAO;IAClD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA8B;IAC7D,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4B;IACxD,OAAO,CAAC,aAAa,CAA8D;gBAEvE,IAAI,EAAE,6BAA6B;IAK/C;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwD9B,OAAO,CAAC,UAAU;IAUlB;;;;;OAKG;IACH,YAAY,IAAI,aAAa,CAAC,kBAAkB,CAAC;IAqBjD,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,cAAc;IA+BtB,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,WAAW;IAgDnB,OAAO,CAAC,OAAO;IAST,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB5B,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,OAAO,CAAC;IAoC/C,IAAI,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsC/C,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpC,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB7C;;;;;;;;;;;OAWG;IACG,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;IA2BxF,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBzD,6DAA6D;YAC/C,WAAW;CAQ1B"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/userbot/adapter.ts"],"names":[],"mappings":"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"}

package/dist/userbot/adapter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapter.test.d.ts.map

package/dist/userbot/adapter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.test.d.ts","sourceRoot":"","sources":["../../src/userbot/adapter.test.ts"],"names":[],"mappings":""}

package/dist/userbot/login.d.ts

@@ -31,11 +31,15 @@ export interface FinishedUserbotLogin {
     username: string | null;
     phone: string | null;
 }
+/** Фабрика клиента для startUserbotLogin (по умолчанию — реальный конструктор). */
+export type LoginClientFactory = (apiId: number, apiHash: string) => TelegramClient;
 /** Шаг 1: подключиться и отправить код подтверждения на номер. */
 export declare function startUserbotLogin(opts: {
     apiId: number;
     apiHash: string;
     phone: string;
+    /** Инъекция клиента для тестов; по умолчанию — defaultLoginClientFactory. */
+    clientFactory?: LoginClientFactory;
 }): Promise<StartedUserbotLogin>;
 /**
  * Шаг 2: отправить код. Если у аккаунта включён 2FA — Telegram вернёт

package/dist/userbot/login.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/userbot/login.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,cAAc,EAAE,MAAM,UAAU,CAAC;AAI/C;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,qBAAqB,GAC7B,eAAe,GACf,cAAc,GACd,cAAc,GACd,kBAAkB,GAClB,YAAY,GACZ,SAAS,CAAC;AAEd,qBAAa,iBAAkB,SAAQ,KAAK;IAExC,QAAQ,CAAC,IAAI,EAAE,qBAAqB;IAEpC,6CAA6C;IAC7C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM;gBAHtB,IAAI,EAAE,qBAAqB,EACpC,OAAO,EAAE,MAAM;IACf,6CAA6C;IACpC,aAAa,CAAC,EAAE,MAAM,YAAA;CAKlC;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAgCD,kEAAkE;AAClE,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAe/B;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,IAAI,CAAA;CAAE,GAAG,CAAC;IAAE,QAAQ,EAAE,KAAK,CAAA;CAAE,GAAG,oBAAoB,CAAC,CAAC,CAoB7E;AAED,2DAA2D;AAC3D,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAShC;AAED,mEAAmE;AACnE,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAS9F"}
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/userbot/login.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,cAAc,EAAE,MAAM,UAAU,CAAC;AAI/C;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,qBAAqB,GAC7B,eAAe,GACf,cAAc,GACd,cAAc,GACd,kBAAkB,GAClB,YAAY,GACZ,SAAS,CAAC;AAEd,qBAAa,iBAAkB,SAAQ,KAAK;IAExC,QAAQ,CAAC,IAAI,EAAE,qBAAqB;IAEpC,6CAA6C;IAC7C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM;gBAHtB,IAAI,EAAE,qBAAqB,EACpC,OAAO,EAAE,MAAM;IACf,6CAA6C;IACpC,aAAa,CAAC,EAAE,MAAM,YAAA;CAKlC;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAgCD,mFAAmF;AACnF,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,cAAc,CAAC;AAMpF,kEAAkE;AAClE,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,aAAa,CAAC,EAAE,kBAAkB,CAAC;CACpC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAa/B;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,IAAI,CAAA;CAAE,GAAG,CAAC;IAAE,QAAQ,EAAE,KAAK,CAAA;CAAE,GAAG,oBAAoB,CAAC,CAAC,CAoB7E;AAED,2DAA2D;AAC3D,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAShC;AAED,mEAAmE;AACnE,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAS9F"}

package/dist/userbot/login.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=login.test.d.ts.map

package/dist/userbot/login.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.test.d.ts","sourceRoot":"","sources":["../../src/userbot/login.test.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chatman-media/channel-telegram",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Telegram-каналы (BotAPI + MTProto userbot) как реализация ChannelAdapter из @chatman-media/channel-core.",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,7 +37,7 @@
   "author": "Alexander Kireev",
   "license": "MIT",
   "dependencies": {
-    "@chatman-media/channel-core": "1.0.0"
+    "@chatman-media/channel-core": "1.2.0"
   },
   "peerDependencies": {
     "telegram": ">=2.26.0"
@@ -51,7 +51,7 @@
     "telegram": "^2.26.22"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.14",
+    "@biomejs/biome": "^2.4.16",
     "@types/bun": "1.3.14",
     "typescript": "^6.0.3"
   },

package/src/bot-api/client.test.ts

@@ -0,0 +1,129 @@
+import { describe, expect, it } from "bun:test";
+import { TelegramApiError, TelegramClient } from "./client.ts";
+import type { FetchLike } from "./client.ts";
+
+function envelope(result: unknown): Response {
+  return new Response(JSON.stringify({ ok: true, result }), { status: 200 });
+}
+function mock(handler: (url: string, init?: RequestInit) => Response | Promise<Response>) {
+  const calls: Array<{ url: string; init?: RequestInit }> = [];
+  const fn = (async (url: string, init?: RequestInit) => {
+    calls.push({ url: String(url), init });
+    return handler(String(url), init);
+  }) as unknown as FetchLike;
+  return { fn, calls };
+}
+const client = (fetch: FetchLike) => new TelegramClient({ token: "T", fetch });
+const bodyOf = (init?: RequestInit) => JSON.parse(init?.body as string);
+
+describe("TelegramClient constructor", () => {
+  it("требует token", () => {
+    expect(() => new TelegramClient({ token: "" })).toThrow("token is required");
+  });
+});
+
+describe("TelegramClient методы", () => {
+  it("getMe", async () => {
+    const { fn, calls } = mock(() => envelope({ id: 1, is_bot: true }));
+    expect((await client(fn).getMe()).id).toBe(1);
+    expect(calls[0]!.url).toBe("https://api.telegram.org/botT/getMe");
+  });
+
+  it("sendMessage — параметры и результат", async () => {
+    const { fn, calls } = mock(() => envelope({ message_id: 9 }));
+    const r = await client(fn).sendMessage({
+      chatId: "100",
+      text: "hi",
+      parseMode: "HTML",
+      replyMarkup: { inline_keyboard: [[{ text: "x", callback_data: "y" }]] },
+      disableWebPagePreview: true,
+      replyToMessageId: 5,
+    });
+    expect(r.message_id).toBe(9);
+    const b = bodyOf(calls[0]!.init);
+    expect(b).toMatchObject({ chat_id: "100", text: "hi", parse_mode: "HTML", disable_web_page_preview: true, reply_to_message_id: 5 });
+    expect(b.reply_markup.inline_keyboard).toBeDefined();
+  });
+
+  it("sendPhoto / sendVideo / sendDocument", async () => {
+    const { fn, calls } = mock(() => envelope({ message_id: 1 }));
+    const c = client(fn);
+    await c.sendPhoto({ chatId: 1, photoFileId: "p", caption: "c" });
+    await c.sendVideo({ chatId: 1, videoFileId: "v" });
+    await c.sendDocument({ chatId: 1, documentFileId: "d", caption: "cap" });
+    expect(calls[0]!.url).toContain("/sendPhoto");
+    expect(bodyOf(calls[0]!.init).photo).toBe("p");
+    expect(calls[1]!.url).toContain("/sendVideo");
+    expect(bodyOf(calls[2]!.init).document).toBe("d");
+  });
+
+  it("sendLocalVideo — не поддержано (throws)", () => {
+    expect(() => client(mock(() => envelope({})).fn).sendLocalVideo({ chatId: 1, localFilePath: "/x" })).toThrow();
+  });
+
+  it("editMessageText / deleteMessage", async () => {
+    const { fn, calls } = mock((url) => (url.includes("delete") ? envelope(true) : envelope({ message_id: 2 })));
+    const c = client(fn);
+    await c.editMessageText({ chatId: 1, messageId: 2, text: "new", parseMode: "HTML", replyMarkup: {} });
+    expect(await c.deleteMessage({ chatId: 1, messageId: 2 })).toBe(true);
+    expect(bodyOf(calls[0]!.init)).toMatchObject({ message_id: 2, text: "new" });
+  });
+
+  it("answerCallbackQuery — text + show_alert", async () => {
+    const { fn, calls } = mock(() => envelope(true));
+    await client(fn).answerCallbackQuery({ callbackQueryId: "cb", text: "ok", showAlert: true });
+    expect(bodyOf(calls[0]!.init)).toMatchObject({ callback_query_id: "cb", text: "ok", show_alert: true });
+  });
+
+  it("answerCallbackQuery — url", async () => {
+    const { fn, calls } = mock(() => envelope(true));
+    await client(fn).answerCallbackQuery({ callbackQueryId: "cb", url: "https://app.test/conversations/7" });
+    expect(bodyOf(calls[0]!.init)).toMatchObject({
+      callback_query_id: "cb",
+      url: "https://app.test/conversations/7",
+    });
+  });
+
+  it("sendChatAction", async () => {
+    const { fn, calls } = mock(() => envelope(true));
+    await client(fn).sendChatAction({ chatId: 1, action: "typing" });
+    expect(bodyOf(calls[0]!.init).action).toBe("typing");
+  });
+
+  it("setWebhook / deleteWebhook / getWebhookInfo", async () => {
+    const { fn, calls } = mock((url) =>
+      url.includes("getWebhookInfo") ? envelope({ url: "u", pending_update_count: 0 }) : envelope(true),
+    );
+    const c = client(fn);
+    await c.setWebhook({ url: "https://x", secretToken: "s", allowedUpdates: ["message"], dropPendingUpdates: true });
+    await c.deleteWebhook(true);
+    expect((await c.getWebhookInfo()).url).toBe("u");
+    expect(bodyOf(calls[0]!.init)).toMatchObject({ url: "https://x", secret_token: "s", drop_pending_updates: true });
+  });
+
+  it("getFile + downloadFile (two-step)", async () => {
+    const { fn } = mock((url) => (url.includes("/getFile") ? envelope({ file_path: "photos/a.jpg" }) : new Response("BYTES")));
+    const res = await client(fn).downloadFile("fid");
+    expect(await res.text()).toBe("BYTES");
+  });
+
+  it("downloadFile без file_path → throws", async () => {
+    const { fn } = mock(() => envelope({ file_id: "f" }));
+    await expect(client(fn).downloadFile("fid")).rejects.toThrow("no file_path");
+  });
+});
+
+describe("TelegramClient.call error-ветки", () => {
+  it("HTTP !ok → TelegramApiError", async () => {
+    const { fn } = mock(() => new Response(JSON.stringify({ ok: false, error_code: 401, description: "bad" }), { status: 401 }));
+    await expect(client(fn).getMe()).rejects.toBeInstanceOf(TelegramApiError);
+  });
+  it("body.ok=false → TelegramApiError с описанием", async () => {
+    const { fn } = mock(() => new Response(JSON.stringify({ ok: false, description: "nope" }), { status: 200 }));
+    await expect(client(fn).getMe()).rejects.toThrow("nope");
+  });
+  it("non-JSON → TelegramApiError", async () => {
+    const { fn } = mock(() => new Response("<html>", { status: 200 }));
+    await expect(client(fn).getMe()).rejects.toBeInstanceOf(TelegramApiError);
+  });
+});

package/src/bot-api/client.ts

@@ -230,12 +230,14 @@ export class TelegramClient {
     callbackQueryId: string;
     text?: string;
     showAlert?: boolean;
+    url?: string;
   }): Promise<true> {
     const params: Record<string, unknown> = {
       callback_query_id: input.callbackQueryId,
     };
     if (input.text) params.text = input.text;
     if (input.showAlert) params.show_alert = input.showAlert;
+    if (input.url) params.url = input.url;
     return this.call<true>("answerCallbackQuery", params);
   }
 

package/src/userbot/adapter.test.ts

@@ -0,0 +1,253 @@
+import type { Inbound } from "@chatman-media/channel-core";
+import { describe, expect, it } from "bun:test";
+import { TelegramUserbotAdapter } from "./adapter.ts";
+
+function make() {
+  return new TelegramUserbotAdapter({ id: "ub1", apiId: 1, apiHash: "h", sessionString: "" });
+}
+// Доступ к приватам/инъекция фейкового gramjs-клиента.
+// biome-ignore lint/suspicious/noExplicitAny: тестовый доступ к приватам
+const priv = (a: TelegramUserbotAdapter) => a as any;
+
+function event(over: Record<string, unknown> = {}) {
+  return {
+    message: {
+      senderId: { toString: () => "123" },
+      peerId: { className: "PeerUser" },
+      message: "hi",
+      id: 5,
+      ...over,
+    },
+  };
+}
+
+describe("TelegramUserbotAdapter базовое", () => {
+  it("kind/id/capabilities", () => {
+    const a = make();
+    expect(a.kind).toBe("telegram_userbot");
+    expect(a.id).toBe("ub1");
+    expect(a.capabilities.text).toBe(true);
+    expect(a.capabilities.callbackQuery).toBe(false);
+  });
+});
+
+describe("eventToInbound", () => {
+  it("текст → text-part", () => {
+    const inb = priv(make()).eventToInbound(event());
+    expect(inb.externalUserId).toBe("123");
+    expect(inb.externalMessageId).toBe("5");
+    expect(inb.parts).toEqual([{ kind: "text", text: "hi" }]);
+  });
+  it("фото → photo-part с caption", () => {
+    const inb = priv(make()).eventToInbound(event({ message: "подпись", photo: {}, id: 7 }));
+    expect(inb.parts[0]).toMatchObject({ kind: "photo", caption: "подпись" });
+  });
+  it("video / voice / document", () => {
+    const a = priv(make());
+    expect(a.eventToInbound(event({ message: "", video: { duration: 3 }, photo: undefined })).parts[0].kind).toBe("video");
+    expect(a.eventToInbound(event({ message: "", voice: { duration: 2 } })).parts[0]).toMatchObject({ kind: "voice", durationSec: 2 });
+    expect(
+      a.eventToInbound(event({ message: "", document: { mimeType: "application/pdf", attributes: [{ fileName: "x.pdf" }] } })).parts[0],
+    ).toMatchObject({ kind: "document", mimeType: "application/pdf", fileName: "x.pdf" });
+  });
+  it("не-private peer → null", () => {
+    expect(priv(make()).eventToInbound(event({ peerId: { className: "PeerChannel" } }))).toBeNull();
+  });
+  it("нет senderId → null", () => {
+    expect(priv(make()).eventToInbound(event({ senderId: undefined }))).toBeNull();
+  });
+  it("пустой текст без медиа → null", () => {
+    expect(priv(make()).eventToInbound(event({ message: "" }))).toBeNull();
+  });
+});
+
+describe("cacheMessage LRU", () => {
+  it("вытесняет старейшие при превышении лимита", () => {
+    const a = priv(make());
+    for (let i = 0; i < 300; i++) a.cacheMessage("u", String(i), { i });
+    expect(a.recentMessages.size).toBe(256);
+    expect(a.recentMessages.has("u:0")).toBe(false); // старейшие вытеснены
+    expect(a.recentMessages.has("u:299")).toBe(true);
+  });
+});
+
+describe("receive() очередь", () => {
+  it("отдаёт заэнкью'енные inbound, затем done после close", async () => {
+    const a = make();
+    priv(a).enqueue({ channelId: "ub1", externalMessageId: "1", externalUserId: "123", parts: [], receivedAt: 0 } as unknown as Inbound);
+    const it = a.receive()[Symbol.asyncIterator]();
+    expect((await it.next()).value.externalMessageId).toBe("1");
+    await a.close();
+    expect((await it.next()).done).toBe(true);
+  });
+});
+
+describe("healthEvents()", () => {
+  it("эмит → читается из итератора", async () => {
+    const a = make();
+    priv(a).emitHealth({ status: "connected" });
+    const it = a.healthEvents()[Symbol.asyncIterator]();
+    expect((await it.next()).value.status).toBe("connected");
+  });
+});
+
+describe("send / delete / downloadMedia / signalTyping", () => {
+  const fakeClient = () => ({
+    sendMessage: async () => ({ id: 42 }),
+    deleteMessages: async () => {},
+    downloadMedia: async () => Buffer.from("MEDIA"),
+    getInputEntity: async (id: number) => ({ id }),
+    invoke: async () => ({}),
+    disconnect: async () => {},
+    connected: true,
+  });
+
+  it("send до connect → throws", async () => {
+    await expect(make().send({ externalUserId: "1", parts: [{ kind: "text", text: "x" }] } as never)).rejects.toThrow("before connect");
+  });
+  it("send пустые parts → throws", async () => {
+    const a = make();
+    priv(a).client = fakeClient();
+    await expect(a.send({ externalUserId: "1", parts: [] } as never)).rejects.toThrow("non-empty");
+  });
+  it("send текст → Sent с id", async () => {
+    const a = make();
+    priv(a).client = fakeClient();
+    const sent = await a.send({ externalUserId: "999", parts: [{ kind: "text", text: "hi" }] } as never);
+    expect(sent.externalMessageId).toBe("42");
+    expect(sent.channelId).toBe("ub1");
+  });
+  it("send неподдержанный part.kind → throws", async () => {
+    const a = make();
+    priv(a).client = fakeClient();
+    await expect(a.send({ externalUserId: "1", parts: [{ kind: "photo", mediaRef: { channelId: "ub1", externalRef: "r" } }] } as never)).rejects.toThrow("unsupported");
+  });
+
+  it("delete до connect → throws; NaN id → throws; ok с клиентом", async () => {
+    await expect(make().delete({ externalUserId: "1", externalMessageId: "2" } as never)).rejects.toThrow("before connect");
+    const a = make();
+    priv(a).client = fakeClient();
+    await expect(a.delete({ externalUserId: "1", externalMessageId: "nope" } as never)).rejects.toThrow("numeric");
+    await a.delete({ externalUserId: "1", externalMessageId: "2" } as never); // не бросает
+  });
+
+  it("downloadMedia: guards + успех из кэша", async () => {
+    await expect(make().downloadMedia({ channelId: "ub1", externalRef: "7" })).rejects.toThrow("before connect");
+    const a = make();
+    priv(a).client = fakeClient();
+    await expect(a.downloadMedia({ channelId: "ub1", externalRef: "7" })).rejects.toThrow("externalUserId");
+    await expect(a.downloadMedia({ channelId: "ub1", externalRef: "7" }, { externalUserId: "123" })).rejects.toThrow("evicted");
+    priv(a).recentMessages.set("123:7", { msg: true });
+    const res = await a.downloadMedia({ channelId: "ub1", externalRef: "7" }, { externalUserId: "123" });
+    expect(await res.text()).toBe("MEDIA");
+  });
+
+  it("signalTyping: без клиента no-op; с клиентом invoke", async () => {
+    await make().signalTyping("1"); // no-op, не бросает
+    const a = make();
+    let invoked = false;
+    priv(a).client = { ...fakeClient(), invoke: async () => { invoked = true; } };
+    await a.signalTyping("123");
+    expect(invoked).toBe(true);
+  });
+
+  it("resolvePeer NaN → throws", async () => {
+    const a = make();
+    priv(a).client = fakeClient();
+    await expect(priv(a).resolvePeer("not-a-number")).rejects.toThrow("invalid externalUserId");
+  });
+
+  it("edit всегда throws (capability disabled)", async () => {
+    await expect(make().edit({} as never)).rejects.toThrow("disabled");
+  });
+});
+
+describe("registerHandler + receive abort", () => {
+  it("registerHandler ставит обработчик, эмитит connected, входящее → inbox+cache", async () => {
+    const a = make();
+    let handler: ((e: unknown) => Promise<void>) | null = null;
+    priv(a).registerHandler({ addEventHandler: (h: (e: unknown) => Promise<void>) => { handler = h; } });
+    // эмит "connected"
+    const hIt = a.healthEvents()[Symbol.asyncIterator]();
+    expect((await hIt.next()).value.status).toBe("connected");
+    // прогоняем входящее сообщение через захваченный обработчик
+    expect(handler).not.toBeNull();
+    await handler!(event());
+    expect(priv(a).recentMessages.has("123:5")).toBe(true);
+    const rIt = a.receive()[Symbol.asyncIterator]();
+    expect((await rIt.next()).value.externalUserId).toBe("123");
+  });
+
+  it("registerHandler пропускает свои исходящие (out)", async () => {
+    const a = make();
+    let handler: ((e: unknown) => Promise<void>) | null = null;
+    priv(a).registerHandler({ addEventHandler: (h: (e: unknown) => Promise<void>) => { handler = h; } });
+    await handler!({ message: { out: true, senderId: { toString: () => "1" }, peerId: { className: "PeerUser" }, message: "x", id: 1 } });
+    expect(priv(a).inbox.length).toBe(0);
+  });
+
+  it("receive(): abort прерывает ожидание (done)", async () => {
+    const a = make();
+    const ctrl = new AbortController();
+    const it = a.receive(ctrl.signal)[Symbol.asyncIterator]();
+    const p = it.next(); // нет элементов → ждёт
+    ctrl.abort();
+    expect((await p).done).toBe(true);
+  });
+});
+
+describe("connect() (через clientFactory)", () => {
+  const fakeGramjs = (over: Record<string, unknown> = {}) => ({
+    connect: async () => true,
+    session: { save: () => "NEWSESS" },
+    addEventHandler: () => {},
+    disconnect: async () => {},
+    connected: false,
+    ...over,
+  });
+  const withFactory = (fc: unknown, over: Record<string, unknown> = {}) =>
+    new TelegramUserbotAdapter({
+      id: "ub1",
+      apiId: 1,
+      apiHash: "h",
+      sessionString: "",
+      connectionRetries: 1,
+      retryDelayMs: 0,
+      clientFactory: (() => fc) as never,
+      ...over,
+    });
+
+  it("успех: client установлен, emitted connected, onSessionUpdated при смене сессии", async () => {
+    const updated: string[] = [];
+    const a = withFactory(fakeGramjs(), { onSessionUpdated: (s: string) => updated.push(s) });
+    await a.connect();
+    expect((await a.healthEvents()[Symbol.asyncIterator]().next()).value.status).toBe("connected");
+    expect(updated).toEqual(["NEWSESS"]);
+  });
+
+  it("AUTH_KEY_DUPLICATED → health auth_key_duplicated + throw", async () => {
+    const a = withFactory(fakeGramjs({ connect: async () => { throw new Error("AUTH_KEY_DUPLICATED"); } }));
+    await expect(a.connect()).rejects.toThrow("auth key revoked");
+    expect((await a.healthEvents()[Symbol.asyncIterator]().next()).value.status).toBe("auth_key_duplicated");
+  });
+
+  it("connect бросает (non-auth) на всех попытках → connection_failed + throw", async () => {
+    const a = withFactory(fakeGramjs({ connect: async () => { throw new Error("network blip"); } }));
+    await expect(a.connect()).rejects.toThrow("connect failed");
+    expect((await a.healthEvents()[Symbol.asyncIterator]().next()).value.status).toBe("connection_failed");
+  });
+
+  it("connect возвращает false → connection_failed", async () => {
+    const a = withFactory(fakeGramjs({ connect: async () => false }));
+    await expect(a.connect()).rejects.toThrow("connect failed");
+  });
+
+  it("идемпотентность: уже connected → фабрика не зовётся", async () => {
+    const a = new TelegramUserbotAdapter({
+      id: "ub1", apiId: 1, apiHash: "h", sessionString: "",
+      clientFactory: (() => { throw new Error("должен быть no-op"); }) as never,
+    });
+    priv(a).client = { connected: true };
+    await a.connect(); // не бросает → фабрика не вызвана
+  });
+});

package/src/userbot/adapter.ts

@@ -69,6 +69,36 @@ export interface TelegramUserbotAdapterOptions {
   connectionRetries?: number;
   /** ms между connect-попытками, default 5000. */
   retryDelayMs?: number;
+  /**
+   * Фабрика gramjs-клиента. По умолчанию — реальный конструктор
+   * (StringSession + GramjsClient + setLogLevel). Инъектируется в тестах,
+   * чтобы покрыть connect() без живого MTProto-соединения.
+   */
+  clientFactory?: (opts: GramjsClientFactoryOpts) => GramjsClient;
+}
+
+export interface GramjsClientFactoryOpts {
+  sessionString: string;
+  apiId: number;
+  apiHash: string;
+  connectionRetries: number;
+  retryDelayMs: number;
+}
+
+/** Реальная фабрика gramjs-клиента (production-путь connect()). */
+function defaultGramjsClientFactory(o: GramjsClientFactoryOpts): GramjsClient {
+  const session = new StringSession(o.sessionString);
+  const client = new GramjsClient(session, o.apiId, o.apiHash, {
+    // count, not flag — 5 = разумный лимит чтобы supervisor мог перерестартить.
+    connectionRetries: o.connectionRetries,
+    retryDelay: o.retryDelayMs,
+    timeout: 30,
+  });
+  // GramJS на уровне ERROR console.error'ит рутинные ping-timeout'ы своего
+  // update-loop'а (он сам их ловит и reconnect'ит). Для long-running SaaS это
+  // шум; значимые статусы отдаём через healthEvents().
+  client.setLogLevel(LogLevel.NONE);
+  return client;
 }
 
 const TG_USERBOT_CAPABILITIES: ChannelCapabilities = {
@@ -117,19 +147,13 @@ export class TelegramUserbotAdapter implements ChannelAdapter {
    */
   async connect(): Promise<void> {
     if (this.client && this.client.connected) return;
-    const session = new StringSession(this.opts.sessionString);
-    const client = new GramjsClient(session, this.opts.apiId, this.opts.apiHash, {
-      // count, not flag — Infinity = бесконечно, 5 = разумный лимит чтобы
-      // supervisor мог перерестартить вместо infinite-spin'а.
+    const client = (this.opts.clientFactory ?? defaultGramjsClientFactory)({
+      sessionString: this.opts.sessionString,
+      apiId: this.opts.apiId,
+      apiHash: this.opts.apiHash,
       connectionRetries: this.opts.connectionRetries ?? 5,
-      retryDelay: this.opts.retryDelayMs ?? 3000,
-      timeout: 30,
+      retryDelayMs: this.opts.retryDelayMs ?? 3000,
     });
-    // GramJS на уровне ERROR console.error'ит рутинные ping-timeout'ы своего
-    // update-loop'а (он сам их ловит и делает reconnect — см. updates.js).
-    // Для long-running SaaS это шум; значимые статусы (connected /
-    // connection_failed / auth_key_duplicated) мы отдаём через healthEvents().
-    client.setLogLevel(LogLevel.NONE);
 
     const maxAttempts = this.opts.connectionRetries ?? 5;
     let lastErr: string | null = null;

package/src/userbot/login.test.ts

@@ -0,0 +1,118 @@
+import type { TelegramClient } from "telegram";
+import { describe, expect, it } from "bun:test";
+import {
+  finishUserbotLogin,
+  startUserbotLogin,
+  submitUserbot2fa,
+  submitUserbotCode,
+  UserbotLoginError,
+  type UserbotLoginErrorCode,
+} from "./login.ts";
+
+function fc(over: Record<string, unknown> = {}): TelegramClient {
+  return {
+    invoke: async () => ({}),
+    getMe: async () => ({ id: 777, username: "u", phone: "+1" }),
+    session: { save: () => "SESSION" },
+    ...over,
+  } as unknown as TelegramClient;
+}
+const throwing = (msg: string) =>
+  fc({
+    invoke: async () => {
+      throw new Error(msg);
+    },
+  });
+const code = (client: TelegramClient) =>
+  submitUserbotCode({ client, phone: "+100", phoneCodeHash: "h", code: "12345" });
+
+describe("UserbotLoginError", () => {
+  it("несёт code/retryAfterSec/name", () => {
+    const e = new UserbotLoginError("flood_wait", "msg", 30);
+    expect(e.code).toBe("flood_wait");
+    expect(e.retryAfterSec).toBe(30);
+    expect(e.name).toBe("UserbotLoginError");
+  });
+});
+
+describe("finishUserbotLogin", () => {
+  it("собирает session + идентификаторы", async () => {
+    expect(await finishUserbotLogin(fc())).toEqual({
+      sessionString: "SESSION",
+      userId: "777",
+      username: "u",
+      phone: "+1",
+    });
+  });
+  it("null username/phone когда их нет", async () => {
+    const r = await finishUserbotLogin(fc({ getMe: async () => ({ id: 1 }) }));
+    expect(r.username).toBeNull();
+    expect(r.phone).toBeNull();
+  });
+});
+
+describe("submitUserbotCode", () => {
+  it("успех → needs2fa:false + session", async () => {
+    const r = await code(fc());
+    expect(r).toMatchObject({ needs2fa: false, sessionString: "SESSION", userId: "777" });
+  });
+  it("SESSION_PASSWORD_NEEDED → needs2fa:true", async () => {
+    expect(await code(throwing("SESSION_PASSWORD_NEEDED"))).toEqual({ needs2fa: true });
+  });
+});
+
+describe("mapRpcError (через submitUserbotCode)", () => {
+  const cases: Array<[string, UserbotLoginErrorCode, number | undefined]> = [
+    ["FLOOD_WAIT_30", "flood_wait", 30],
+    ["PHONE_NUMBER_INVALID", "phone_invalid", undefined],
+    ["PHONE_CODE_EXPIRED", "code_expired", undefined],
+    ["PHONE_CODE_INVALID", "code_invalid", undefined],
+    ["что-то совсем другое", "unknown", undefined],
+  ];
+  for (const [raw, expectedCode, retry] of cases) {
+    it(`${raw} → ${expectedCode}`, async () => {
+      try {
+        await code(throwing(raw));
+        throw new Error("ожидалась ошибка");
+      } catch (err) {
+        expect(err).toBeInstanceOf(UserbotLoginError);
+        expect((err as UserbotLoginError).code).toBe(expectedCode);
+        if (retry !== undefined) expect((err as UserbotLoginError).retryAfterSec).toBe(retry);
+      }
+    });
+  }
+});
+
+describe("submitUserbot2fa", () => {
+  it("ошибка invoke → password_invalid", async () => {
+    await expect(
+      submitUserbot2fa({ client: throwing("PASSWORD_HASH_INVALID"), password: "p" }),
+    ).rejects.toMatchObject({ code: "password_invalid" });
+  });
+});
+
+describe("startUserbotLogin (через clientFactory)", () => {
+  it("успех → { client, phoneCodeHash }", async () => {
+    const fc = { connect: async () => {}, sendCode: async () => ({ phoneCodeHash: "hash" }), disconnect: async () => {} };
+    const r = await startUserbotLogin({ apiId: 1, apiHash: "h", phone: "+100", clientFactory: (() => fc) as never });
+    expect(r.phoneCodeHash).toBe("hash");
+    expect(r.client).toBe(fc as never);
+  });
+
+  it("ошибка sendCode → disconnect + mapRpcError", async () => {
+    let disconnected = false;
+    const fc = {
+      connect: async () => {},
+      sendCode: async () => {
+        throw new Error("PHONE_NUMBER_INVALID");
+      },
+      disconnect: async () => {
+        disconnected = true;
+      },
+    };
+    await expect(
+      startUserbotLogin({ apiId: 1, apiHash: "h", phone: "+100", clientFactory: (() => fc) as never }),
+    ).rejects.toMatchObject({ code: "phone_invalid" });
+    expect(disconnected).toBe(true);
+  });
+});

package/src/userbot/login.ts

@@ -78,15 +78,22 @@ function mapRpcError(err: unknown): UserbotLoginError {
   return new UserbotLoginError("unknown", msg);
 }
 
+/** Фабрика клиента для startUserbotLogin (по умолчанию — реальный конструктор). */
+export type LoginClientFactory = (apiId: number, apiHash: string) => TelegramClient;
+
+function defaultLoginClientFactory(apiId: number, apiHash: string): TelegramClient {
+  return new TelegramClient(new StringSession(""), apiId, apiHash, { connectionRetries: 3 });
+}
+
 /** Шаг 1: подключиться и отправить код подтверждения на номер. */
 export async function startUserbotLogin(opts: {
   apiId: number;
   apiHash: string;
   phone: string;
+  /** Инъекция клиента для тестов; по умолчанию — defaultLoginClientFactory. */
+  clientFactory?: LoginClientFactory;
 }): Promise<StartedUserbotLogin> {
-  const client = new TelegramClient(new StringSession(""), opts.apiId, opts.apiHash, {
-    connectionRetries: 3,
-  });
+  const client = (opts.clientFactory ?? defaultLoginClientFactory)(opts.apiId, opts.apiHash);
   await client.connect();
   try {
     const { phoneCodeHash } = await client.sendCode(