@codebam/cf-workers-telegram-bot 12.6.1 → 12.6.4

package/README.md

@@ -119,6 +119,33 @@ npx wrangler deploy
 
 To automate deployments, use the [Wrangler Action](https://github.com/cloudflare/wrangler-action) or Cloudflare's built-in [GitHub integration](https://developers.cloudflare.com/workers/ci-cd/github-actions/).
 
+## Development
+
+### Setup
+
+1. **Install dependencies**:
+   ```sh
+   npm install
+   ```
+
+2. **Set up Git hooks**:
+   This project uses custom Git hooks for quality control. Run the following script to enable them:
+   ```sh
+   ./setup_hooks.sh
+   ```
+
+### Scripts
+
+- `npm run lint`: Run ESLint on the source code.
+- `npm run format`: Format the code using Prettier.
+- `npm run build`: Compile TypeScript and run type checks.
+- `npm run test`: Run unit tests with Vitest.
+- `npm run lint:all`: Run linting for the root project and all subprojects.
+- `npm run build:all`: Run build for the root project and all subprojects.
+- `npm run test:all`: Run tests for the root project and all subprojects.
+
+The pre-commit hook automatically runs formatting and linting on staged files (via `lint-staged`), followed by a full project type check and tests before every commit.
+
 ## API Documentation
 
 Detailed API documentation is available at [cf-workers-telegram-bot.codebam.ca](https://cf-workers-telegram-bot.codebam.ca).

package/dist/history_manager.js

@@ -36,7 +36,7 @@ export class HistoryManager {
         history.push({ role: 'assistant', content: response });
         const trimmedHistory = history.slice(-20);
         await this.kv.put(this.getKey(userId, threadId), JSON.stringify(trimmedHistory), {
-            expirationTtl: 86400
+            expirationTtl: 86400,
         });
     }
     /**

package/dist/telegram_api.d.ts

@@ -9,7 +9,7 @@ export interface TelegramApiBaseParams {
 /** Interface for message parameters */
 export interface SendMessageParams extends TelegramApiBaseParams {
     text: string;
-    parse_mode: string;
+    parse_mode?: string;
     reply_to_message_id?: number | string;
     disable_web_page_preview?: boolean;
     disable_notification?: boolean;

package/dist/telegram_execution_context.d.ts

@@ -1,5 +1,5 @@
 import { Update as TelegramUpdate, InlineQueryResult as TelegramInlineQueryResult } from '@grammyjs/types';
-import TelegramApi from './telegram_api.js';
+import TelegramApi, { SendMessageParams, SendPhotoParams, SendVideoParams, SendVoiceParams, SendMessageDraftParams } from './telegram_api.js';
 import TelegramBot from './telegram_bot.js';
 /** Class representing the context of execution */
 export default class TelegramExecutionContext {
@@ -83,7 +83,7 @@ export default class TelegramExecutionContext {
      * Helper to handle business connection fallbacks
      */
     private withBusinessFallback;
-    replyVideo(video: string, options?: Record<string, number | string | boolean>): Promise<Response | null>;
+    replyVideo(video: string, options?: Partial<SendVideoParams>): Promise<Response | null>;
     /**
      * Get File from telegram file_id
      * @param file_id - telegram file_id
@@ -97,7 +97,7 @@ export default class TelegramExecutionContext {
      * @param options - any additional options to pass to sendPhoto
      * @returns Promise with the API response
      */
-    replyPhoto(photo: string, caption?: string, options?: Record<string, number | string | boolean>): Promise<Response | null>;
+    replyPhoto(photo: string, caption?: string, options?: Partial<SendPhotoParams>): Promise<Response | null>;
     /**
      * Reply to the last message with a voice message
      * @param voice - url or file_id to voice
@@ -105,7 +105,7 @@ export default class TelegramExecutionContext {
      * @param options - any additional options to pass to sendVoice
      * @returns Promise with the API response
      */
-    replyVoice(voice: string, caption?: string, options?: Record<string, number | string | boolean>): Promise<Response | null>;
+    replyVoice(voice: string, caption?: string, options?: Partial<SendVoiceParams>): Promise<Response | null>;
     /**
      * Send typing in a chat
      * @returns Promise with the API response
@@ -166,8 +166,8 @@ export default class TelegramExecutionContext {
      * @param options - any additional options to pass to sendMessage/editMessageText
      * @returns Promise with the API response
      */
-    streamReply(message: string, draft_id: number, parse_mode?: string, options?: Record<string, number | string | boolean | object>, finish?: boolean): Promise<Response | null>;
-    reply(message: string, parse_mode?: string, reply?: boolean, options?: Record<string, number | string | boolean>): Promise<Response | null>;
+    streamReply(message: string, draft_id: number, parse_mode?: string, options?: Partial<SendMessageDraftParams>, finish?: boolean): Promise<Response | null>;
+    reply(message: string, parse_mode?: string, reply?: boolean, options?: Partial<SendMessageParams>): Promise<Response | null>;
     /**
      * Send an invoice for Telegram Stars
      * @param title - product name

package/dist/telegram_execution_context.js

@@ -52,10 +52,7 @@ export default class TelegramExecutionContext {
      * @returns True if the sender is a bot
      */
     get isBot() {
-        return (this.update.message?.from?.is_bot ??
-            this.update.business_message?.from?.is_bot ??
-            this.update.guest_message?.from?.is_bot ??
-            false);
+        return (this.update.message?.from?.is_bot ?? this.update.business_message?.from?.is_bot ?? this.update.guest_message?.from?.is_bot ?? false);
     }
     /**
      * Parse arguments from the update
@@ -66,7 +63,7 @@ export default class TelegramExecutionContext {
             case 'message':
             case 'business_message':
             case 'guest_message':
-                return (this.update.message?.text ?? this.update.business_message?.text ?? this.update.guest_message?.text)?.toString().split(' ') ?? [];
+                return ((this.update.message?.text ?? this.update.business_message?.text ?? this.update.guest_message?.text)?.toString().split(' ') ?? []);
             case 'inline':
                 return this.update.inline_query?.query.split(' ') ?? [];
             default:
@@ -97,7 +94,7 @@ export default class TelegramExecutionContext {
             try {
                 const response = await this.api.getBusinessConnection(this.bot.api.toString(), connectionId);
                 if (response.status === 200) {
-                    const json = await response.json();
+                    const json = (await response.json());
                     if (json.ok && json.result) {
                         ownerId = json.result.user?.id || json.result.user_chat_id;
                         if (ownerId) {
@@ -217,7 +214,7 @@ export default class TelegramExecutionContext {
                 try {
                     const response = await this.api.getBusinessConnection(this.bot.api.toString(), connectionId);
                     if (response.status === 200) {
-                        const json = await response.json();
+                        const json = (await response.json());
                         if (json.ok && json.result) {
                             ownerId = json.result.user?.id || json.result.user_chat_id;
                             if (ownerId) {
@@ -278,7 +275,9 @@ export default class TelegramExecutionContext {
             return await this.api.answerInline(this.bot.api.toString(), {
                 ...options,
                 inline_query_id: this.update.inline_query?.id.toString() ?? '',
-                results: [{ type: 'video', id: crypto.randomUUID(), video_url: video, mime_type: 'video/mp4', thumbnail_url: video, title: 'Video' }],
+                results: [
+                    { type: 'video', id: crypto.randomUUID(), video_url: video, mime_type: 'video/mp4', thumbnail_url: video, title: 'Video' },
+                ],
             });
         }
         return await this.api.sendVideo(this.bot.api.toString(), params);
@@ -377,7 +376,14 @@ export default class TelegramExecutionContext {
         if (this.update_type === 'inline') {
             return await this.api.answerInline(this.bot.api.toString(), {
                 inline_query_id: this.update.inline_query?.id.toString() ?? '',
-                results: [{ type: 'article', id: crypto.randomUUID(), title: title ?? '', input_message_content: { message_text: message, parse_mode: parse_mode } }],
+                results: [
+                    {
+                        type: 'article',
+                        id: crypto.randomUUID(),
+                        title: title ?? '',
+                        input_message_content: { message_text: message, parse_mode: parse_mode },
+                    },
+                ],
             });
         }
         return null;
@@ -400,7 +406,12 @@ export default class TelegramExecutionContext {
      * @returns Promise with the API response
      */
     async answerGuestQueryText(message, parse_mode = '') {
-        return await this.answerGuestQuery({ type: 'article', id: crypto.randomUUID(), title: 'Response', input_message_content: { message_text: message, parse_mode: parse_mode } });
+        return await this.answerGuestQuery({
+            type: 'article',
+            id: crypto.randomUUID(),
+            title: 'Response',
+            input_message_content: { message_text: message, parse_mode: parse_mode },
+        });
     }
     /**
      * Answer a guest query with a photo
@@ -410,7 +421,14 @@ export default class TelegramExecutionContext {
      * @returns Promise with the API response
      */
     async answerGuestQueryPhoto(photo, caption = '', parse_mode = '') {
-        return await this.answerGuestQuery({ type: 'photo', id: crypto.randomUUID(), photo_url: photo, thumbnail_url: photo, caption, parse_mode: parse_mode });
+        return await this.answerGuestQuery({
+            type: 'photo',
+            id: crypto.randomUUID(),
+            photo_url: photo,
+            thumbnail_url: photo,
+            caption,
+            parse_mode: parse_mode,
+        });
     }
     /**
      * Answer a guest query with a video
@@ -420,7 +438,16 @@ export default class TelegramExecutionContext {
      * @returns Promise with the API response
      */
     async answerGuestQueryVideo(video, caption = '', parse_mode = '') {
-        return await this.answerGuestQuery({ type: 'video', id: crypto.randomUUID(), video_url: video, mime_type: 'video/mp4', thumbnail_url: video, title: 'Video', caption, parse_mode: parse_mode });
+        return await this.answerGuestQuery({
+            type: 'video',
+            id: crypto.randomUUID(),
+            video_url: video,
+            mime_type: 'video/mp4',
+            thumbnail_url: video,
+            title: 'Video',
+            caption,
+            parse_mode: parse_mode,
+        });
     }
     /**
      * Answer a guest query with a voice message
@@ -430,7 +457,14 @@ export default class TelegramExecutionContext {
      * @returns Promise with the API response
      */
     async answerGuestQueryVoice(voice, caption = '', parse_mode = '') {
-        return await this.answerGuestQuery({ type: 'voice', id: crypto.randomUUID(), voice_url: voice, title: 'Voice', caption, parse_mode: parse_mode });
+        return await this.answerGuestQuery({
+            type: 'voice',
+            id: crypto.randomUUID(),
+            voice_url: voice,
+            title: 'Voice',
+            caption,
+            parse_mode: parse_mode,
+        });
     }
     /** Map of draft IDs to message IDs for streaming */
     drafts = new Map();

package/dist/utils.js

@@ -21,7 +21,7 @@ export async function markdownToHtml(s) {
         let result = '';
         for (let i = 0; i < items.length; i++) {
             const item = items[i];
-            const prefix = ordered ? `${(start !== '' && start !== undefined) ? Number(start) + i : i + 1}. ` : '• ';
+            const prefix = ordered ? `${start !== '' && start !== undefined ? Number(start) + i : i + 1}. ` : '• ';
             result += `${prefix}${renderer.listitem(item)}\n`;
         }
         return result;
@@ -50,8 +50,21 @@ export async function markdownToHtml(s) {
     // html tag pass-through for supported tags or escaping
     renderer.html = ({ text }) => {
         const allowedTags = [
-            'b', 'strong', 'i', 'em', 'u', 'ins', 's', 'strike', 'del',
-            'span', 'tg-spoiler', 'a', 'code', 'pre', 'blockquote'
+            'b',
+            'strong',
+            'i',
+            'em',
+            'u',
+            'ins',
+            's',
+            'strike',
+            'del',
+            'span',
+            'tg-spoiler',
+            'a',
+            'code',
+            'pre',
+            'blockquote',
         ];
         const match = /^<\/?([a-z0-9-]+)(?:\s+[^>]*)?>/i.exec(text);
         if (match) {
@@ -87,9 +100,9 @@ export const fetchTool = {
             url: { type: 'string', description: 'The URL to fetch' },
             method: { type: 'string', enum: ['GET', 'POST', 'PUT', 'DELETE'], default: 'GET' },
             headers: { type: 'object', description: 'HTTP headers to include in the request' },
-            body: { type: 'string', description: 'The request body' }
+            body: { type: 'string', description: 'The request body' },
         },
-        required: ['url']
+        required: ['url'],
     },
     function: async ({ url, method, headers, body }) => {
         try {
@@ -97,9 +110,9 @@ export const fetchTool = {
                 method: method || 'GET',
                 headers: {
                     'User-Agent': 'Mozilla/5.0 (Cloudflare Worker Telegram Bot)',
-                    ...headers
+                    ...headers,
                 },
-                body: body ? (typeof body === 'string' ? body : JSON.stringify(body)) : undefined
+                body: body ? (typeof body === 'string' ? body : JSON.stringify(body)) : undefined,
             });
             const text = await res.text();
             return text.slice(0, 10000);
@@ -107,5 +120,5 @@ export const fetchTool = {
         catch (e) {
             return `Error executing fetch: ${String(e)}`;
         }
-    }
+    },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@codebam/cf-workers-telegram-bot",
-	"version": "12.6.1",
+	"version": "12.6.4",
 	"description": "serverless telegram bot on cf workers",
 	"main": "./dist/main.js",
 	"module": "./dist/main.js",
@@ -22,11 +22,18 @@
 	},
 	"scripts": {
 		"build": "tsc --project tsconfig.json",
+		"build:all": "npm run build && npm run build --prefix ai-workflow && npm run build --prefix consumer && npm run build --prefix webapp",
 		"lint": "eslint src",
+		"lint:all": "npm run lint && npm run lint --prefix ai-workflow && npm run lint --prefix consumer && npm run lint --prefix webapp",
 		"test": "vitest --config vitest.config.js",
+		"test:all": "npm test && npm test --prefix ai-workflow && npm test --prefix consumer && npm test --prefix webapp",
+		"format": "prettier --write src test *.json *.js *.mjs",
+		"format:check": "prettier --check src test *.json *.js *.mjs",
 		"docs": "typedoc --options typedoc.json",
 		"deploy:docs": "npm run docs && wrangler pages deploy docs",
-		"ncu": "npx npm-check-updates -i --root -u"
+		"ncu": "npx npm-check-updates -u --root",
+		"ncu:interactive": "npx npm-check-updates -i --root",
+		"prepare": "./setup_hooks.sh"
 	},
 	"author": "codebam",
 	"license": "Apache-2.0",
@@ -35,13 +42,15 @@
 		"url": "git+https://github.com/codebam/cf-workers-telegram-bot.git"
 	},
 	"devDependencies": {
-		"@cloudflare/workers-types": "^4.20260511.1",
+		"@cloudflare/vitest-pool-workers": "^0.16.6",
 		"@eslint/js": "^10.0.1",
+		"@types/node": "^25.8.0",
 		"@typescript-eslint/eslint-plugin": "^8.59.3",
 		"@typescript-eslint/parser": "^8.59.3",
-		"eslint": "^10.3.0",
+		"eslint": "^10.4.0",
 		"eslint-config-prettier": "^10.1.8",
 		"globals": "^17.6.0",
+		"lint-staged": "^17.0.5",
 		"npm-check-updates": "^22.2.0",
 		"prettier": "^3.8.3",
 		"typedoc": "^0.28.19",
@@ -49,16 +58,22 @@
 		"typescript": "^6.0.3",
 		"typescript-eslint": "^8.59.3",
 		"vitest": "^4.1.6",
-		"wrangler": "^4.90.1"
+		"wrangler": "^4.92.0"
 	},
 	"dependencies": {
 		"@eslint/eslintrc": "^3.3.5",
-		"@grammyjs/types": "^3.27.2",
+		"@grammyjs/types": "^3.27.3",
 		"marked": "^18.0.3"
 	},
 	"typedocOptions": {
 		"entryPoints": [
 			"./src/main.ts"
 		]
+	},
+	"lint-staged": {
+		"*.{ts,js,mjs,json}": [
+			"prettier --write",
+			"eslint --fix"
+		]
 	}
 }