supertelegram 0.3.1 → 0.4.0

package/README.md

@@ -2,6 +2,8 @@
 
 telegram cli for ai to read/write messages using gramjs.
 
+> **warning:** don't use this to send spam or abuse the telegram api. your account can get banned.
+
 ## installation
 
 ```bash
@@ -30,9 +32,11 @@ that's it! now you're ready to use telegram from the cli.
 ### messages
 
 ```bash
-# send a message
+# send a message — chat can be @username, a numeric id, or a name
 telegram send @username "hello there"
-telegram send "me" "note to self"  # use "me" for saved messages
+telegram send 7069934904 "hey"      # by id (for chats with no username)
+telegram send "Ben YC" "hello"      # by name (partial, case-insensitive)
+telegram send "me" "note to self"   # use "me" for saved messages
 
 # read messages (shows [photo], [video], [file] indicators)
 telegram read @username 10
@@ -43,7 +47,7 @@ telegram reply "John" "hey back!"
 # get unread messages (json output with media info)
 telegram unread 20
 
-# list dialogs
+# list dialogs (shows @username and [id: ...] for each chat)
 telegram dialogs 10
 ```
 
@@ -99,8 +103,8 @@ telegram send @friend "hey" --session ./custom.txt
 
 clone repo and install:
 ```bash
-git clone https://github.com/caffeinum/telegram-cli.git
-cd telegram-cli
+git clone https://github.com/caffeinum/supertelegram.git
+cd supertelegram
 bun install
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "supertelegram",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "telegram cli for humans and bots",
   "module": "index.ts",
   "type": "module",

package/src/cli/commands.ts

@@ -71,8 +71,16 @@ export async function dialogs(limit = 10) {
 
   const dialogList = await getDialogs(limit);
   for (const dialog of dialogList) {
-    console.log(`- ${dialog.title}`);
-  }
+    const entity = dialog.entity;
+    const username =
+      entity && "username" in entity && entity.username
+        ? ` @${entity.username}`
+        : "";
+    const id = dialog.id?.toString() ?? entity?.id?.toString() ?? "?";
+    const unread = dialog.unreadCount > 0 ? ` (${dialog.unreadCount} unread)` : "";
+    console.log(`- ${dialog.title}${username} [id: ${id}]${unread}`);
+  }
+  console.log("\nsend with: telegram send <@username|id> \"your message\"");
   await disconnect();
 }
 

package/src/cli/run.ts

@@ -1,8 +1,9 @@
 #!/usr/bin/env bun
 import { send, read, dialogs, unread, reply, login, config, sendFile, downloadMedia } from "./commands";
 import { setVerbose, setSessionPath } from "../client/telegram";
+import pkg from "../../package.json";
 
-const VERSION = "0.1.0";
+const VERSION = pkg.version;
 const NAME = "telegram";
 
 const HELP = `
@@ -12,7 +13,7 @@ usage:
   ${NAME} <command> [options]
 
 commands:
-  send <chat> <message>      send a message to a chat
+  send <chat> <message>      send a message (chat = @username, id, or name)
   send-file <chat> <path>    send a file/image/video (optional: caption)
   read <chat> [limit]        read messages from a chat (default: 10)
   download <chat> <id> [out] download media from message id

package/src/client/telegram.ts

@@ -76,12 +76,60 @@ export async function login(callbacks: {
   console.log("session saved!");
 }
 
+// a chat can be addressed by @username, "me", phone (+123), t.me link,
+// or a numeric id copied from `telegram dialogs`. usernames/links resolve
+// natively; numeric ids and bare names need the dialog entity cache, so we
+// look them up here.
+export async function resolveEntity(
+  identifier: string
+): Promise<string | Api.TypeEntityLike> {
+  const c = await getClient();
+  const id = identifier.trim();
+
+  // things gramjs resolves on its own
+  if (
+    id === "me" ||
+    id.startsWith("@") ||
+    id.startsWith("+") ||
+    id.startsWith("http")
+  ) {
+    return id;
+  }
+
+  // numeric id (users positive, chats/channels may be negative)
+  if (/^-?\d+$/.test(id)) {
+    try {
+      // fast path: entity already in the session cache
+      return await c.getInputEntity(id);
+    } catch {
+      // slow path: fetch dialogs to populate + match the entity
+      const match = (await c.getDialogs({ limit: 200 })).find(
+        (d) => d.id?.toString() === id || d.entity?.id?.toString() === id
+      );
+      if (match?.entity) return match.entity;
+      throw new Error(
+        `chat with id ${id} not found in your dialogs. run: telegram dialogs 200`
+      );
+    }
+  }
+
+  // bare name: partial, case-insensitive match against dialog titles
+  const match = (await c.getDialogs({ limit: 200 })).find((d) =>
+    d.title?.toLowerCase().includes(id.toLowerCase())
+  );
+  if (match?.entity) return match.entity;
+
+  // let gramjs take a final shot (e.g. a username without the @)
+  return id;
+}
+
 export async function sendMessage(
   username: string,
   message: string
 ): Promise<Api.Message> {
   const c = await getClient();
-  return c.sendMessage(username, { message });
+  const entity = await resolveEntity(username);
+  return c.sendMessage(entity, { message });
 }
 
 export async function sendFile(
@@ -90,7 +138,8 @@ export async function sendFile(
   caption?: string
 ): Promise<Api.Message> {
   const c = await getClient();
-  return c.sendFile(username, {
+  const entity = await resolveEntity(username);
+  return c.sendFile(entity, {
     file: filePath,
     caption: caption,
   });
@@ -117,7 +166,8 @@ export async function getMessages(
   limit = 10
 ): Promise<Api.Message[]> {
   const c = await getClient();
-  const messages = await c.getMessages(username, { limit });
+  const entity = await resolveEntity(username);
+  const messages = await c.getMessages(entity, { limit });
   return messages as Api.Message[];
 }
 

package/tsconfig.json

@@ -11,6 +11,7 @@
     // Bundler mode
     "moduleResolution": "bundler",
     "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
     "verbatimModuleSyntax": true,
     "noEmit": true,