@chatman-media/channel-telegram 1.9.0 → 1.11.0

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

@@ -72,6 +72,11 @@ export interface TgDocument {
     mime_type?: string;
     file_size?: number;
 }
+export interface TgLocation {
+    latitude: number;
+    longitude: number;
+    horizontal_accuracy?: number;
+}
 export interface TgMessage {
     message_id: number;
     from?: TgUser;
@@ -92,6 +97,7 @@ export interface TgMessage {
     /** «Кружок» — видео-сообщение (video note). Для видео-верификации. */
     video_note?: TgVideoNote;
     document?: TgDocument;
+    location?: TgLocation;
     /** When this message is a reply to another, Telegram inlines the
      *  parent message here. We use it to detect operator replies to lead
      *  cards (matched by the parent's `message_id` against

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

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

package/dist/bot-api/update-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-parser.d.ts","sourceRoot":"","sources":["../../src/bot-api/update-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAyB,MAAM,6BAA6B,CAAC;AAClF,OAAO,KAAK,EAA0B,QAAQ,EAAE,MAAM,YAAY,CAAC;AAuEnE;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,CAwC/E"}
+{"version":3,"file":"update-parser.d.ts","sourceRoot":"","sources":["../../src/bot-api/update-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAyB,MAAM,6BAA6B,CAAC;AAClF,OAAO,KAAK,EAA0B,QAAQ,EAAE,MAAM,YAAY,CAAC;AA4EnE;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,CA0C/E"}

package/dist/index.js

@@ -32845,6 +32845,11 @@ function partsFromMessage(channelId, msg) {
       ...msg.document.mime_type ? { mimeType: msg.document.mime_type } : {},
       ...msg.document.file_name ? { fileName: msg.document.file_name } : {}
     });
+  } else if (msg.location) {
+    parts.push({
+      kind: "text",
+      text: `\uD83D\uDCCD Геолокация: ${msg.location.latitude}, ${msg.location.longitude}`
+    });
   } else if (!msg.text && msg.caption) {
     parts.push({ kind: "text", text: msg.caption });
   }
@@ -32861,10 +32866,9 @@ function parseUpdate(channelId, update) {
       externalMessageId: String(cb.message?.message_id ?? cb.id),
       externalUserId: String(cb.from.id),
       ...cb.from.username ? { externalUsername: cb.from.username } : {},
-      parts: [
-        { kind: "callback_query", data: cb.data, originalMessageId: String(messageId) }
-      ],
+      parts: [{ kind: "callback_query", data: cb.data, originalMessageId: String(messageId) }],
       receivedAt: Math.floor(Date.now() / 1000),
+      ...cb.from.language_code ? { channelLangHint: cb.from.language_code } : {},
       raw: update
     };
   }
@@ -32885,6 +32889,7 @@ function parseUpdate(channelId, update) {
     parts,
     receivedAt: msg.date,
     ...isEdit ? { edited: true } : {},
+    ...msg.from.language_code ? { channelLangHint: msg.from.language_code } : {},
     raw: update
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chatman-media/channel-telegram",
-  "version": "1.9.0",
+  "version": "1.11.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.7.0"
+    "@chatman-media/channel-core": "1.10.0"
   },
   "peerDependencies": {
     "telegram": ">=2.26.0"

package/src/bot-api/types.ts

@@ -82,6 +82,12 @@ export interface TgDocument {
   file_size?: number;
 }
 
+export interface TgLocation {
+  latitude: number;
+  longitude: number;
+  horizontal_accuracy?: number;
+}
+
 export interface TgMessage {
   message_id: number;
   from?: TgUser;
@@ -102,6 +108,7 @@ export interface TgMessage {
   /** «Кружок» — видео-сообщение (video note). Для видео-верификации. */
   video_note?: TgVideoNote;
   document?: TgDocument;
+  location?: TgLocation;
   /** When this message is a reply to another, Telegram inlines the
    *  parent message here. We use it to detect operator replies to lead
    *  cards (matched by the parent's `message_id` against

package/src/bot-api/update-parser.test.ts

@@ -285,4 +285,52 @@ describe("parseUpdate", () => {
     };
     expect(parseUpdate(CH, update)).toBeNull();
   });
+
+  // #735 — слабый bootstrap-сигнал языка из Telegram language_code.
+  it("пробрасывает from.language_code → Inbound.channelLangHint", () => {
+    const update: TgUpdate = {
+      update_id: 10,
+      message: {
+        message_id: 1,
+        chat: { id: 1, type: "private" },
+        from: { id: 1, language_code: "ko" },
+        date: 1700000000,
+        text: "안녕",
+      },
+    };
+    expect(parseUpdate(CH, update)?.channelLangHint).toBe("ko");
+  });
+
+  it("без language_code — channelLangHint отсутствует", () => {
+    const update: TgUpdate = {
+      update_id: 11,
+      message: {
+        message_id: 2,
+        chat: { id: 2, type: "private" },
+        from: { id: 2 },
+        date: 1700000000,
+        text: "hi",
+      },
+    };
+    const inbound = parseUpdate(CH, update);
+    expect(inbound).not.toBeNull();
+    expect(inbound?.channelLangHint).toBeUndefined();
+  });
+
+  it("пробрасывает language_code из callback_query.from", () => {
+    const update: TgUpdate = {
+      update_id: 12,
+      callback_query: {
+        id: "cb1",
+        from: { id: 99, language_code: "en-US" },
+        data: "ok",
+        message: {
+          message_id: 50,
+          chat: { id: 99, type: "private" },
+          date: 1700000000,
+        },
+      },
+    };
+    expect(parseUpdate(CH, update)?.channelLangHint).toBe("en-US");
+  });
 });

package/src/bot-api/update-parser.ts

@@ -62,6 +62,11 @@ function partsFromMessage(channelId: string, msg: TgMessage): InboundPart[] {
       ...(msg.document.mime_type ? { mimeType: msg.document.mime_type } : {}),
       ...(msg.document.file_name ? { fileName: msg.document.file_name } : {}),
     });
+  } else if (msg.location) {
+    parts.push({
+      kind: "text",
+      text: `📍 Геолокация: ${msg.location.latitude}, ${msg.location.longitude}`,
+    });
   } else if (!msg.text && msg.caption) {
     // Caption без media — теоретически невозможно по Bot API, но обработаем как text.
     parts.push({ kind: "text", text: msg.caption });
@@ -85,10 +90,10 @@ export function parseUpdate(channelId: string, update: TgUpdate): Inbound | null
       externalMessageId: String(cb.message?.message_id ?? cb.id),
       externalUserId: String(cb.from.id),
       ...(cb.from.username ? { externalUsername: cb.from.username } : {}),
-      parts: [
-        { kind: "callback_query", data: cb.data, originalMessageId: String(messageId) },
-      ],
+      parts: [{ kind: "callback_query", data: cb.data, originalMessageId: String(messageId) }],
       receivedAt: Math.floor(Date.now() / 1000),
+      // #735 — слабый bootstrap-сигнал языка (язык интерфейса клиента, не переписки).
+      ...(cb.from.language_code ? { channelLangHint: cb.from.language_code } : {}),
       raw: update,
     };
   }
@@ -113,6 +118,8 @@ export function parseUpdate(channelId: string, update: TgUpdate): Inbound | null
     parts,
     receivedAt: msg.date,
     ...(isEdit ? { edited: true } : {}),
+    // #735 — слабый bootstrap-сигнал языка (язык интерфейса клиента, не переписки).
+    ...(msg.from.language_code ? { channelLangHint: msg.from.language_code } : {}),
     raw: update,
   };
 }