@ebowwa/channel-telegram 1.17.1 → 1.17.2

package/dist/types.d.ts

@@ -223,4 +223,100 @@ export interface ConversationMessage {
     role: 'user' | 'assistant';
     content: string;
 }
+/**
+ * Extended location interface that includes all Telegram Bot API properties.
+ * The @types/node-telegram-bot-api only includes latitude/longitude.
+ * @see https://core.telegram.org/bots/api#location
+ */
+export interface TelegramLocation {
+    /** Longitude as defined by sender */
+    longitude: number;
+    /** Latitude as defined by sender */
+    latitude: number;
+    /** Optional. The radius of uncertainty for the location, measured in meters; 0-1500 */
+    horizontal_accuracy?: number;
+    /** Optional. Time relative to the message sending date, during which the location can be updated, in seconds */
+    live_period?: number;
+    /** Optional. The direction in which the user is moving, in degrees; 1-360 */
+    heading?: number;
+    /** Optional. The maximum distance for proximity alerts about approaching another chat member, in meters */
+    proximity_alert_radius?: number;
+}
+/**
+ * Represents a venue (location + name/address).
+ * @see https://core.telegram.org/bots/api#venue
+ */
+export interface TelegramVenue {
+    /** The location of the venue */
+    location: TelegramLocation;
+    /** Name of the venue */
+    title: string;
+    /** Address of the venue */
+    address: string;
+    /** Optional. Foursquare identifier of the venue */
+    foursquare_id?: string;
+    /** Optional. Foursquare type of the venue */
+    foursquare_type?: string;
+    /** Optional. Google Places identifier of the venue */
+    google_place_id?: string;
+    /** Optional. Google Places type of the venue */
+    google_place_type?: string;
+}
+/**
+ * Live location state for tracking active live locations.
+ */
+export interface LiveLocationState {
+    /** Chat ID where the live location was shared */
+    chatId: number;
+    /** Message ID of the location message */
+    messageId: number;
+    /** User ID who shared the location */
+    userId: number;
+    /** Current location data */
+    location: TelegramLocation;
+    /** When the live location was first received */
+    startedAt: Date;
+    /** When the live location expires (calculated from live_period) */
+    expiresAt?: Date;
+    /** Number of updates received */
+    updateCount: number;
+}
+/**
+ * Options for sending a location.
+ */
+export interface SendLocationOptions {
+    /** Unique identifier for the target message thread (topic) of the forum */
+    message_thread_id?: number;
+    /** Period in seconds for which the location will be updated (see Live Locations) */
+    live_period?: number;
+    /** Latitude of the location */
+    latitude: number;
+    /** Longitude of the location */
+    longitude: number;
+    /** The radius of uncertainty for the location, measured in meters; 0-1500 */
+    horizontal_accuracy?: number;
+    /** Direction in which the location moves, in degrees; 1-360 */
+    heading?: number;
+    /** Maximum distance for proximity alerts, in meters; 1-100000 */
+    proximity_alert_radius?: number;
+    /** Sends the message silently */
+    disable_notification?: boolean;
+    /** Protects the contents of the sent message from forwarding and saving */
+    protect_content?: boolean;
+}
+/**
+ * Options for editing a live location.
+ */
+export interface EditLiveLocationOptions {
+    /** Latitude of new location */
+    latitude: number;
+    /** Longitude of new location */
+    longitude: number;
+    /** The radius of uncertainty for the location, measured in meters; 0-1500 */
+    horizontal_accuracy?: number;
+    /** Direction in which the location moves, in degrees; 1-360 */
+    heading?: number;
+    /** Maximum distance for proximity alerts, in meters; 1-100000 */
+    proximity_alert_radius?: number;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ebowwa/channel-telegram",
-  "version": "1.17.1",
+  "version": "1.17.2",
   "description": "Pure Telegram protocol adapter implementing ChannelConnector",
   "type": "module",
   "main": "./dist/index.js",

package/src/index.ts

@@ -24,12 +24,51 @@ import {
   type MessageSender,
   type MessageContext,
   type MessageHandler,
+  type MediaAttachment,
+  type ChannelLocation,
   createChannelId,
 } from "@ebowwa/channel-types";
 
 import { ConversationMemory } from "./conversation-memory.js";
 import { registerAllCommands, isQuiet } from "./commands/index.js";
-import type { Tool } from "./types.js";
+import type { Tool, TelegramLocation, TelegramVenue, LiveLocationState, SendLocationOptions, EditLiveLocationOptions } from "./types.js";
+
+/**
+ * Extended Telegram Location type that includes all Bot API properties.
+ * The node-telegram-bot-api types only include latitude/longitude.
+ */
+interface TelegramLocationExtended {
+  latitude: number;
+  longitude: number;
+  horizontal_accuracy?: number;
+  live_period?: number;
+  heading?: number;
+  proximity_alert_radius?: number;
+}
+
+/**
+ * Location data storage for message metadata.
+ */
+interface LocationData {
+  type: "location" | "location_update";
+  location: TelegramLocation;
+  isLive: boolean;
+  venue?: TelegramVenue;
+  updateNumber?: number;
+}
+
+/**
+ * Extended Telegram Location type that includes all Bot API properties.
+ * The node-telegram-bot-api types only include latitude/longitude.
+ */
+interface TelegramLocationExtended {
+  latitude: number;
+  longitude: number;
+  horizontal_accuracy?: number;
+  live_period?: number;
+  heading?: number;
+  proximity_alert_radius?: number;
+}
 
 // ============================================================
 // PLUGIN EXPORTS (ChannelPlugin Pattern)
@@ -76,6 +115,12 @@ export type {
   SetChatMemberTagParams,
   PromoteChatMemberParams,
   LinkPreviewOptions,
+  // Location Types
+  TelegramLocation,
+  TelegramVenue,
+  LiveLocationState,
+  SendLocationOptions,
+  EditLiveLocationOptions,
 } from "./types.js";
 
 // Normalization utilities
@@ -149,6 +194,11 @@ export class TelegramChannel {
   private connected = false;
   // Streaming state
   private activeStreams: Map<string, { messageId?: number; lastText: string; lastUpdate: number; pendingPromise?: Promise<void> }> = new Map();
+  // Live location tracking state
+  private liveLocations: Map<string, LiveLocationState> = new Map();
+  private liveLocationCleanupInterval?: NodeJS.Timeout;
+  // Location data storage for message metadata
+  private locationData: Map<string, LocationData> = new Map();
 
   constructor(config: TelegramConfig) {
     this.config = config;
@@ -172,6 +222,9 @@ export class TelegramChannel {
         reactions: true,
         editing: true,
         streaming: this.nativeStreaming,
+        locations: true,
+        liveLocations: true,
+        venues: true,
       },
       media: {
         maxFileSize: 50 * 1024 * 1024, // 50MB
@@ -202,6 +255,9 @@ export class TelegramChannel {
       },
     });
 
+    // Start live location cleanup interval (every 5 minutes)
+    this.startLiveLocationCleanupTimer();
+
     // NOTE: Commands are NOT registered here with bot.onText() handlers.
     // Instead, all messages (including commands) flow through the message event
     // to the daemon's messageHandler, which uses @ebowwa/channel-command for unified handling.
@@ -220,6 +276,13 @@ export class TelegramChannel {
 
   async stop(): Promise<void> {
     console.log("[TelegramChannel] Stopping...");
+    // Stop live location cleanup timer
+    if (this.liveLocationCleanupInterval) {
+      clearInterval(this.liveLocationCleanupInterval);
+      this.liveLocationCleanupInterval = undefined;
+    }
+    // Clear all live locations
+    this.liveLocations.clear();
     await this.bot.stopPolling();
     this.connected = false;
   }
@@ -501,6 +564,389 @@ export class TelegramChannel {
     return false;
   }
 
+  // ============================================================
+  // Live Location Methods
+  // ============================================================
+
+  /**
+   * Send a static or live location.
+   * If live_period is set, the location can be updated with editLiveLocation.
+   */
+  async sendLocation(chatId: number, options: SendLocationOptions): Promise<TelegramBot.Message> {
+    const result = await this.bot.sendLocation(chatId, options.latitude, options.longitude, {
+      live_period: options.live_period,
+      disable_notification: options.disable_notification,
+    });
+
+    // Track live location if live_period is set
+    if (options.live_period && result.location) {
+      const key = `${chatId}:${result.message_id}`;
+      const expiresAt = options.live_period
+        ? new Date(Date.now() + options.live_period * 1000)
+        : undefined;
+
+      const locationData: TelegramLocationExtended = {
+        latitude: result.location.latitude,
+        longitude: result.location.longitude,
+        live_period: options.live_period,
+        heading: options.heading,
+        horizontal_accuracy: options.horizontal_accuracy,
+        proximity_alert_radius: options.proximity_alert_radius,
+      };
+
+      this.liveLocations.set(key, {
+        chatId,
+        messageId: result.message_id,
+        userId: result.from?.id || 0,
+        location: locationData,
+        startedAt: new Date(),
+        expiresAt,
+        updateCount: 0,
+      });
+
+      console.log(`[TelegramChannel] Started tracking live location: ${key}, expires in ${options.live_period}s`);
+    }
+
+    return result;
+  }
+
+  /**
+   * Edit a live location message.
+   * Updates the location and returns the edited message.
+   */
+  async editLiveLocation(
+    chatId: number,
+    messageId: number,
+    options: EditLiveLocationOptions
+  ): Promise<TelegramBot.Message | boolean> {
+    const result = await this.bot.editMessageLiveLocation(options.latitude, options.longitude, {
+      chat_id: chatId,
+      message_id: messageId,
+    });
+
+    // Update tracked state
+    const key = `${chatId}:${messageId}`;
+    const state = this.liveLocations.get(key);
+    if (state) {
+      state.location = {
+        ...state.location,
+        latitude: options.latitude,
+        longitude: options.longitude,
+        horizontal_accuracy: options.horizontal_accuracy,
+        heading: options.heading,
+        proximity_alert_radius: options.proximity_alert_radius,
+      };
+      state.updateCount++;
+      console.log(`[TelegramChannel] Updated live location: ${key} (update #${state.updateCount})`);
+    }
+
+    return result;
+  }
+
+  /**
+   * Stop a live location message.
+   * The location will no longer update.
+   */
+  async stopLiveLocation(chatId: number, messageId: number): Promise<TelegramBot.Message | boolean> {
+    const result = await this.bot.stopMessageLiveLocation({
+      chat_id: chatId,
+      message_id: messageId,
+    });
+
+    // Remove from tracking
+    const key = `${chatId}:${messageId}`;
+    const state = this.liveLocations.get(key);
+    if (state) {
+      console.log(`[TelegramChannel] Stopped live location: ${key} (had ${state.updateCount} updates)`);
+      this.liveLocations.delete(key);
+    }
+
+    return result;
+  }
+
+  /**
+   * Get live location state for a specific message.
+   */
+  getLiveLocation(chatId: number, messageId: number): LiveLocationState | undefined {
+    const key = `${chatId}:${messageId}`;
+    return this.liveLocations.get(key);
+  }
+
+  /**
+   * Get all active live locations being tracked.
+   */
+  getActiveLiveLocations(): LiveLocationState[] {
+    // Clean up expired locations first
+    this.cleanupExpiredLiveLocations();
+    return Array.from(this.liveLocations.values());
+  }
+
+  /**
+   * Get live locations shared by a specific user.
+   */
+  getLiveLocationsByUser(userId: number): LiveLocationState[] {
+    this.cleanupExpiredLiveLocations();
+    return Array.from(this.liveLocations.values()).filter(
+      (state) => state.userId === userId
+    );
+  }
+
+  /**
+   * Clean up expired live locations.
+   */
+  private cleanupExpiredLiveLocations(): void {
+    const now = new Date();
+    for (const [key, state] of this.liveLocations) {
+      if (state.expiresAt && state.expiresAt < now) {
+        console.log(`[TelegramChannel] Cleaned up expired live location: ${key}`);
+        this.liveLocations.delete(key);
+      }
+    }
+  }
+
+  /**
+   * Start the live location cleanup timer (runs every 5 minutes).
+   */
+  private startLiveLocationCleanupTimer(): void {
+    // Clean up every 5 minutes
+    this.liveLocationCleanupInterval = setInterval(() => {
+      this.cleanupExpiredLiveLocations();
+    }, 5 * 60 * 1000);
+    console.log("[TelegramChannel] Started live location cleanup timer");
+  }
+
+  /**
+   * Start periodic cleanup of expired live locations.
+   */
+  private startLiveLocationCleanup(): void {
+    // Clean up every 5 minutes
+    this.liveLocationCleanupInterval = setInterval(() => {
+      this.cleanupExpiredLiveLocations();
+    }, 5 * 60 * 1000);
+  }
+
+  /**
+   * Stop live location cleanup interval.
+   */
+  private stopLiveLocationCleanup(): void {
+    if (this.liveLocationCleanupInterval) {
+      clearInterval(this.liveLocationCleanupInterval);
+      this.liveLocationCleanupInterval = undefined;
+    }
+  }
+
+  /**
+   * Handle incoming location message (static or live).
+   * Updates internal tracking and routes to message handler.
+   */
+  private handleLocationMessage(msg: TelegramBot.Message): ChannelMessage | null {
+    if (!msg.location) return null;
+
+    // Cast to extended location type that includes all Telegram properties
+    const rawLocation = msg.location as TelegramLocation;
+    const location: TelegramLocation = {
+      latitude: rawLocation.latitude,
+      longitude: rawLocation.longitude,
+      horizontal_accuracy: rawLocation.horizontal_accuracy,
+      live_period: rawLocation.live_period,
+      heading: rawLocation.heading,
+      proximity_alert_radius: rawLocation.proximity_alert_radius,
+    };
+
+    // Track live locations from users
+    if (location.live_period) {
+      const key = `${msg.chat.id}:${msg.message_id}`;
+      const expiresAt = new Date(Date.now() + location.live_period * 1000);
+
+      this.liveLocations.set(key, {
+        chatId: msg.chat.id,
+        messageId: msg.message_id,
+        userId: msg.from?.id || 0,
+        location,
+        startedAt: new Date(),
+        expiresAt,
+        updateCount: 0,
+      });
+
+      console.log(`[TelegramChannel] Tracking user live location: ${key}, expires in ${location.live_period}s`);
+    }
+
+    // Create ChannelMessage
+    const sender: MessageSender = {
+      id: msg.from?.id?.toString() || msg.chat.id.toString(),
+      username: msg.from?.username,
+      displayName: msg.from?.first_name || msg.from?.username || "User",
+      isBot: msg.from?.is_bot || false,
+    };
+
+    const context: MessageContext = {
+      isDM: msg.chat.type === "private",
+      groupName: msg.chat.type !== "private" ? msg.chat.title : undefined,
+    };
+
+    const chatChannelId = createChannelId("telegram", msg.chat.id.toString());
+
+    // Build text representation for location
+    const locationText = location.live_period
+      ? `[Live Location] ${location.latitude.toFixed(6)}, ${location.longitude.toFixed(6)} (live for ${Math.floor(location.live_period / 60)}m)`
+      : `[Location] ${location.latitude.toFixed(6)}, ${location.longitude.toFixed(6)}`;
+
+    // Store location info in a separate map for retrieval
+    const locationKey = `${chatChannelId.accountId}:${msg.message_id}`;
+    this.locationData.set(locationKey, {
+      type: "location",
+      location,
+      isLive: !!location.live_period,
+      venue: msg.venue,
+    });
+
+    // Build media attachment with location data
+    const media: MediaAttachment[] = [];
+
+    if (location.live_period) {
+      // Live location
+      media.push({
+        type: "location",
+        location: {
+          type: "live",
+          latitude: location.latitude,
+          longitude: location.longitude,
+          accuracy: location.horizontal_accuracy,
+          heading: location.heading,
+          sessionId: `live_${msg.chat.id}_${msg.message_id}`,
+          startedAt: new Date(msg.date * 1000),
+          expiresAt: new Date(Date.now() + location.live_period * 1000),
+          livePeriod: location.live_period,
+          updateCount: 0,
+          status: "active",
+        },
+      });
+    } else {
+      // Static location
+      media.push({
+        type: "location",
+        location: {
+          type: "static",
+          latitude: location.latitude,
+          longitude: location.longitude,
+          accuracy: location.horizontal_accuracy,
+          heading: location.heading,
+          timestamp: new Date(msg.date * 1000),
+        },
+      });
+    }
+
+    // Add venue info if present
+    if (msg.venue) {
+      media.push({
+        type: "venue",
+        location: {
+          type: "static",
+          latitude: location.latitude,
+          longitude: location.longitude,
+          timestamp: new Date(msg.date * 1000),
+          label: msg.venue.title,
+          address: msg.venue.address,
+        },
+      });
+    }
+
+    return {
+      messageId: msg.message_id.toString(),
+      channelId: chatChannelId,
+      timestamp: new Date(msg.date * 1000),
+      sender,
+      text: locationText,
+      media,
+      context,
+    };
+  }
+
+  /**
+   * Handle live location update (edited_message with location).
+   */
+  private handleLocationUpdate(msg: TelegramBot.Message): ChannelMessage | null {
+    if (!msg.location) return null;
+
+    const key = `${msg.chat.id}:${msg.message_id}`;
+    const state = this.liveLocations.get(key);
+
+    // Cast to extended location type
+    const rawLocation = msg.location as TelegramLocation;
+
+    if (state) {
+      // Update tracked location
+      state.location = {
+        latitude: rawLocation.latitude,
+        longitude: rawLocation.longitude,
+        horizontal_accuracy: rawLocation.horizontal_accuracy,
+        heading: rawLocation.heading,
+        proximity_alert_radius: rawLocation.proximity_alert_radius,
+        live_period: rawLocation.live_period,
+      };
+      state.updateCount++;
+
+      console.log(`[TelegramChannel] Live location update: ${key} (update #${state.updateCount})`);
+    }
+
+    // Create ChannelMessage for the update
+    const sender: MessageSender = {
+      id: msg.from?.id?.toString() || msg.chat.id.toString(),
+      username: msg.from?.username,
+      displayName: msg.from?.first_name || msg.from?.username || "User",
+      isBot: msg.from?.is_bot || false,
+    };
+
+    const context: MessageContext = {
+      isDM: msg.chat.type === "private",
+      groupName: msg.chat.type !== "private" ? msg.chat.title : undefined,
+    };
+
+    const chatChannelId = createChannelId("telegram", msg.chat.id.toString());
+
+    // Store location update info
+    const locationKey = `${chatChannelId.accountId}:${msg.message_id}`;
+    this.locationData.set(locationKey, {
+      type: "location_update",
+      location: {
+        latitude: rawLocation.latitude,
+        longitude: rawLocation.longitude,
+        horizontal_accuracy: rawLocation.horizontal_accuracy,
+        heading: rawLocation.heading,
+        proximity_alert_radius: rawLocation.proximity_alert_radius,
+      },
+      isLive: true,
+      updateNumber: state?.updateCount || 0,
+    });
+
+    // Build media attachment with live location update data
+    const media: MediaAttachment[] = [{
+      type: "location",
+      location: {
+        type: "live",
+        latitude: rawLocation.latitude,
+        longitude: rawLocation.longitude,
+        accuracy: rawLocation.horizontal_accuracy,
+        heading: rawLocation.heading,
+        sessionId: `live_${msg.chat.id}_${msg.message_id}`,
+        startedAt: state?.startedAt || new Date(msg.date * 1000),
+        expiresAt: state?.expiresAt,
+        updateCount: state?.updateCount || 0,
+        status: "active",
+      },
+    }];
+
+    return {
+      messageId: msg.message_id.toString(),
+      channelId: chatChannelId,
+      timestamp: new Date(msg.date * 1000),
+      sender,
+      text: `[Live Location Update] ${rawLocation.latitude.toFixed(6)}, ${rawLocation.longitude.toFixed(6)}`,
+      media,
+      context,
+    };
+  }
+
   // ============================================================
   // Message Routing (Internal)
   // ============================================================
@@ -509,6 +955,25 @@ export class TelegramChannel {
     // Text messages - all go to the daemon's messageHandler (including commands)
     // The daemon uses @ebowwa/channel-command for unified command handling with full context
     this.bot.on("message", async (msg) => {
+      // Check for location messages first
+      if (msg.location) {
+        if (!this.isAllowed(msg.from?.id, msg.chat.id)) return;
+
+        const message = this.handleLocationMessage(msg);
+        if (message && this.messageHandler) {
+          console.log(`[TelegramChannel] Location from ${message.sender.displayName}: ${message.text}`);
+          try {
+            const response = await this.messageHandler(message);
+            if (response) {
+              await this.send(response);
+            }
+          } catch (error) {
+            console.error("[TelegramChannel] Location handler error:", error);
+          }
+        }
+        return;
+      }
+
       if (!msg.text) return;
       // All messages flow to the daemon, including commands
       if (!this.isAllowed(msg.from?.id, msg.chat.id)) return;
@@ -530,8 +995,27 @@ export class TelegramChannel {
       }
     });
 
-    // Edited messages
+    // Edited messages (includes live location updates)
     this.bot.on("edited_message", async (msg) => {
+      // Handle live location updates
+      if (msg.location) {
+        if (!this.isAllowed(msg.from?.id, msg.chat.id)) return;
+
+        const message = this.handleLocationUpdate(msg);
+        if (message && this.messageHandler) {
+          console.log(`[TelegramChannel] Live location update from ${message.sender.displayName}`);
+          try {
+            const response = await this.messageHandler(message);
+            if (response) {
+              await this.send(response);
+            }
+          } catch (error) {
+            console.error("[TelegramChannel] Location update handler error:", error);
+          }
+        }
+        return;
+      }
+
       if (!msg.text) return;
       if (!this.isAllowed(msg.from?.id, msg.chat.id)) return;