feat: add logging options for chat ID and topic in README and implement logging functionality in handleBiliLink

Author: Ovler-Young

README.md

@@ -20,6 +20,8 @@ docker run -d \
   -e BILIARCHIVER_API={THE_API_URL_OF_BILIARCHIVER}\
   -e BILIARCHIVER_BOT={YOUR_BOT_TOKEN}\
   -e BILIARCHIVER_ENABLE_BLACKLIST=true\ # Optional, if you want to enable blacklist feature, don't forget to trigger /addadmin command first
+  -e BILIARCHIVER_LOG_INTO_CHAT_ID={YOUR_CHAT_ID}\ # Optional, if you want to log into a specific chat group, you can set the chat ID here.
+  -e BILIARCHIVER_LOG_INTO_CHAT_TOPIC={YOUR_CHAT_TOPIC}\ # Optional, if you want to log into a specific chat topic, you can set the topic here.
   --restart always \
   ghcr.io/saveweb/biliarchiverbot:latest
 ```
@@ -55,6 +57,8 @@ If you don't have public IP, you can use [ngrok](https://ngrok.com/) to expose y
     BILIARCHIVER_USERNAME=<THE_TELEGRAM_USERNAME_OF_BILIARCHIVER_BOT>
     BILIARCHIVER_API=<THE_API_URL_OF_BILIARCHIVER>
     BILIARCHIVER_BOT=<YOUR_BOT_TOKEN>
+    BILIARCHIVER_LOG_INTO_CHAT_ID=<YOUR_CHAT_ID> # Optional, if you want to log into a specific chat group, you can set the chat ID here.
+    BILIARCHIVER_LOG_INTO_CHAT_TOPIC=<YOUR_CHAT_TOPIC> # Optional, if you want to log into a specific chat topic, you can set the topic here.
    ```
 
 5. deploy
@@ -79,6 +83,9 @@ If you don't have public IP, you can use [ngrok](https://ngrok.com/) to expose y
     BILIARCHIVER_USERNAME=<THE_TELEGRAM_USERNAME_OF_BILIARCHIVER_BOT>
     BILIARCHIVER_API=<THE_API_URL_OF_BILIARCHIVER>
     BILIARCHIVER_BOT=<YOUR_BOT_TOKEN>
+    BILIARCHIVER_ENABLE_BLACKLIST=true # Optional, if you want to enable blacklist feature, don't forget to trigger /addadmin command first
+    BILIARCHIVER_LOG_INTO_CHAT_ID=<YOUR_CHAT_ID> # Optional, if you want to log into a specific chat group, you can set the chat ID here.
+    BILIARCHIVER_LOG_INTO_CHAT_TOPIC=<YOUR_CHAT_TOPIC> # Optional, if you want to log into a specific chat topic, you can set the topic here.
    ```
 4. start the development server
 

src/lib/server/utils.ts

@@ -68,13 +68,51 @@ const handleBiliLink = async (ctx: Context, includeReplyTo: boolean) => {
     // log found
     const { from } = ctx;
     const user = from?.username ?? from?.first_name ?? from?.id?.toString();
-    console.log("Found", {
+    const logData = {
       chatId: chat.id ?? "unknown",
       chatType: chat.type ?? "unknown",
       fromUser: user ?? "unknown",
       text: originalText ?? "no text",
       replyText: replyToText ?? "no text",
-    });
+    };
+    console.info("Found", logData);
+
+    if (env.BILIARCHIVER_LOG_INTO_CHAT_ID) {
+      const logChatId = Number(env.BILIARCHIVER_LOG_INTO_CHAT_ID);
+
+      const logMessage =
+        `<b>✅ Archive Request Received</b>` +
+        `<br>-------------------------` +
+        `<br><b>Chat Type:</b> <code>${logData.chatType}</code>` +
+        `<a href="tg://user?id=${logData.chatId}">From</a>` +
+        `<b>User:</b> ${escapeHtml(logData.fromUser)}` +
+        `<b>BiliLink:</b> <a href="https://www.bilibili.com/video/${bv}">${bv}</a>` +
+        `<b>Original Text:</b>` +
+        `<pre>${escapeHtml(logData.text)}</pre>`;
+
+      const options: any = { parse_mode: "HTML" };
+      if (env.BILIARCHIVER_LOG_INTO_CHAT_TOPIC) {
+        try {
+          options.message_thread_id = Number(
+            env.BILIARCHIVER_LOG_INTO_CHAT_TOPIC
+          );
+        } catch (e) {
+          console.error(
+            "Invalid BILIARCHIVER_LOG_INTO_CHAT_TOPIC:",
+            env.BILIARCHIVER_LOG_INTO_CHAT_TOPIC
+          );
+        }
+      }
+
+      try {
+        await ctx.api.sendMessage(logChatId, logMessage, options);
+      } catch (error) {
+        console.error(
+          `Error sending log message to chat ID ${logChatId}:`,
+          error
+        );
+      }
+    }
   }
 
   let pending: Message.TextMessage;
@@ -502,4 +540,17 @@ const handle_source = async (
   checkArchives();
 };
 
+/**
+ * Escapes HTML special characters to prevent formatting issues in Telegram messages.
+ * @param unsafe The string to escape.
+ * @returns The escaped string.
+ */
+function escapeHtml(unsafe: string | undefined | null): string {
+  if (!unsafe) return "N/A"; // Return 'N/A' or an empty string if input is null/undefined
+  return unsafe
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;");
+}
+
 export { handleBiliLink };