teledzik 1.0.7 → 1.0.9

package/README.md

@@ -8,21 +8,21 @@
 
 <div align="center">
 <img src="docs/assets/logo.svg" alt="logo" height="90" align="center">
-<h1 align="center">telegraf.js</h1>
+<h1 align="center">teledzik</h1>
 
-<p>Modern Telegram Bot API framework for Node.js</p>
+<p>Modern Telegram Bot API framework for Node.js (with Native Rich Messages &amp; Full In-Place Edit)</p>
 
-<a href="https://core.telegram.org/bots/api">
-	<img src="https://img.shields.io/badge/Bot%20API-v10.1-f36caf.svg?style=flat-square" alt="Bot API Version" />
+<a href="https://www.npmjs.com/package/teledzik">
+	<img src="https://img.shields.io/npm/v/teledzik.svg?style=flat-square" alt="npm version" />
 </a>
-<a href="https://packagephobia.com/result?p=telegraf,node-telegram-bot-api">
-	<img src="https://flat.badgen.net/packagephobia/install/telegraf" alt="install size" />
+<a href="https://core.telegram.org/bots/api">
+	<img src="https://img.shields.io/badge/Bot%20API-v10.1+-f36caf.svg?style=flat-square" alt="Bot API Version" />
 </a>
-<a href="https://github.com/telegraf/telegraf">
-	<img src="https://img.shields.io/github/languages/top/telegraf/telegraf?style=flat-square&logo=github" alt="GitHub top language" />
+<a href="https://packagephobia.com/result?p=teledzik">
+	<img src="https://flat.badgen.net/packagephobia/install/teledzik" alt="install size" />
 </a>
-<a href="https://telegram.me/TelegrafJSChat">
-	<img src="https://img.shields.io/badge/English%20chat-grey?style=flat-square&logo=telegram" alt="English chat" />
+<a href="https://t.me/lorddzik">
+	<img src="https://img.shields.io/badge/Telegram-@lorddzik-blue?style=flat-square&logo=telegram" alt="Maintainer Telegram" />
 </a>
 </div>
 
@@ -99,14 +99,16 @@ process.once('SIGTERM', () => bot.stop('SIGTERM'))
 
 ---
 
-### Sending Methods
+### Sending & Editing Methods
 
 | Method | Description |
 |---|---|
 | `ctx.sendRichMessage(msg, extra?)` | Send a rich message to the current chat |
 | `ctx.replyWithRichMessageContent(msg, extra?)` | Send a rich message quoting the current message |
+| `ctx.editRichMessage(msg, extra?)` | In-place edit of message with native Rich UI preservation (v1.0.8+) |
 | `ctx.sendRichMessageDraft(draftId, msg, extra?)` | Stream a partial draft (private chats only) |
-| `ctx.telegram.sendRichMessage(chatId, msg, extra?)` | Explicit call with chat ID |
+| `ctx.telegram.sendRichMessage(chatId, msg, extra?)` | Explicit send with chat ID |
+| `ctx.telegram.editRichMessage(chatId, messageId, msg, extra?)` | Explicit edit with chat ID and message ID |
 | `ctx.telegram.sendRichMessageDraft(chatId, draftId, msg, extra?)` | Explicit streaming with chat ID |
 
 **`extra` options for `sendRichMessage`:**
@@ -645,17 +647,30 @@ bot.on('inline_query', async (ctx) => {
 
 ## Exclusive Teledzik Enhancements
 
-### Auto HTML Sanitizer & Edit Rich Message
+### Native `editRichMessage` & Auto-Sanitizer (v1.0.8+)
 
-Standard Telegram Bot API's `editMessageText` (`parse_mode: 'HTML'`) fails with `400 CANNOT_PARSE_ENTITIES` when using block HTML tags like `<h1>`, `<h2>`, or `<p>`.
+Standard `editMessageText` (`parse_mode: 'HTML'`) fails or degrades layout when editing complex structured blocks. In `teledzik` v1.0.8+, `ctx.editRichMessage` passes the payload natively via Telegram's `rich_message` parameter:
 
-`teledzik` automatically sanitizes HTML strings on `editMessageText` to convert headers to supported bold text, preventing API errors:
+- **Preserves Full Rich UI**: In-place edits keep native `<table>`, `<h1>`-`<h6>`, collapsible cards (`<details>` / `<blockquote expandable>`), and styled elements without flattening them into plain text.
+- **Smart Key-Value Table Handling**: 2-column tables correctly retain all rows and headers without accidental truncation.
+- **Resilient Media & No-Op Handling**: Automatically falls back to `editMessageCaption` if editing a photo or video message, and silently resolves `message is not modified` instead of throwing unhandled exceptions.
 
 ```ts
-// Safely edits text containing <h1>/<h2> without throwing 400 CANNOT_PARSE_ENTITIES!
-await ctx.editMessageText('<h1>New Title</h1><p>Updated content</p>', { parse_mode: 'HTML' })
+// 1. Edit with RichHTMLBuilder
+const rich = new RichHTMLBuilder()
+  .heading(2, 'Order Confirmed')
+  .table([
+    ['Product', 'Status'],
+    ['VPS-01', 'ACTIVE 🟢']
+  ])
+
+await ctx.editRichMessage(rich, {
+  reply_markup: Markup.inlineKeyboard([
+    [Markup.button.callback('Back to Menu', 'menu')]
+  ]).reply_markup
+})
 
-// Or use the native rich message edit helper:
+// 2. Edit with raw HTML / Rich Object
 await ctx.editRichMessage({ html: '<h1>Title</h1><p>Body</p>' })
 ```
 

package/lib/core/helpers/rich-sanitizer.js

@@ -3,8 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.sanitizeRichHtml = void 0;
 function formatTableToCard(tableHtml) {
     const rows = [];
+    let hasHeader = false;
     const rowMatches = tableHtml.match(/<tr[^>]*>([\s\S]*?)<\/tr>/gi) || [];
     for (const row of rowMatches) {
+        if (/<th[^>]*>/i.test(row))
+            hasHeader = true;
         const cells = [];
         const cellMatches = row.match(/<(th|td)[^>]*>([\s\S]*?)<\/\1>/gi) || [];
         for (const cell of cellMatches) {
@@ -17,15 +20,18 @@ function formatTableToCard(tableHtml) {
     if (rows.length === 0)
         return '';
     // Header vs Row handling (Format sebagai Kartu Elegan)
-    const isKeyValue = rows.length > 1 && rows.every((r) => r.length === 2);
+    const isKeyValue = rows.length > 0 && rows.every((r) => r.length === 2);
     let cardText = '';
     if (isKeyValue) {
-        const lines = rows.slice(1).map((r) => `• <b>${r[0]}:</b> ${r[1]}`);
+        const isHeaderRow = hasHeader && rows.length > 1 && (/^(parameter|informasi|metrik|field|key|unit|format|statistik|opsi|nama|item)$/i.test(rows[0][0].replace(/<[^>]*>/g, '').trim()) ||
+            /^(status|keterangan|detail|nilai|value|jumlah|estimasi|tipe|contoh input)$/i.test(rows[0][1].replace(/<[^>]*>/g, '').trim()));
+        const dataRows = isHeaderRow ? rows.slice(1) : rows;
+        const lines = dataRows.map((r) => `• <b>${r[0]}:</b> ${r[1]}`);
         cardText = `<blockquote>\n${lines.join('\n')}\n</blockquote>\n\n`;
     }
     else {
         const lines = rows.map((r, idx) => {
-            if (idx === 0)
+            if (idx === 0 && hasHeader)
                 return `<b>${r.join(' │ ')}</b>`;
             return `${r.join(' │ ')}`;
         });

package/lib/telegram.js

@@ -1275,10 +1275,12 @@ class Telegram extends client_1.default {
      * Universal in-place message editor with Modern Rich UI formatting.
      */
     async editRichMessage(chatId, messageId, content, extra) {
+        let richPayload = content;
         let htmlText = '';
         let replyMarkup = extra?.reply_markup;
         if (typeof content?.build === 'function') {
             const built = content.build();
+            richPayload = built;
             if (typeof built === 'object' && built !== null) {
                 htmlText = built.html || built.text || built.caption || '';
                 if (built.reply_markup) {
@@ -1290,6 +1292,7 @@ class Telegram extends client_1.default {
             }
         }
         else if (typeof content === 'object' && content !== null) {
+            richPayload = content;
             htmlText = content.html || content.text || content.caption || '';
             if (content.reply_markup) {
                 replyMarkup = replyMarkup || content.reply_markup;
@@ -1297,14 +1300,12 @@ class Telegram extends client_1.default {
         }
         else if (typeof content === 'string') {
             htmlText = content;
+            richPayload = content.startsWith('{') || content.includes('<') ? content : { text: content };
         }
-        // Format ke Telegram Modern HTML
-        htmlText = (0, rich_sanitizer_1.sanitizeRichHtml)(htmlText);
         const payload = {
             chat_id: chatId,
             message_id: Number(messageId),
-            text: htmlText,
-            parse_mode: 'HTML',
+            rich_message: richPayload,
             ...extra,
         };
         if (replyMarkup)
@@ -1314,13 +1315,18 @@ class Telegram extends client_1.default {
         }
         catch (err) {
             const desc = String(err?.description || err?.message || '');
+            // Ignore if message is unchanged
+            if (desc.includes('message is not modified')) {
+                return false;
+            }
+            const fallbackHtml = (0, rich_sanitizer_1.sanitizeRichHtml)(htmlText);
             // Fallback jika pesan berupa Media (Foto/Video)
             if (desc.includes('no text in the message') || desc.includes('message to edit not found')) {
                 try {
                     return await this.callApi('editMessageCaption', {
                         chat_id: chatId,
                         message_id: Number(messageId),
-                        caption: htmlText,
+                        caption: fallbackHtml,
                         parse_mode: 'HTML',
                         reply_markup: replyMarkup,
                         ...extra,
@@ -1332,8 +1338,16 @@ class Telegram extends client_1.default {
                     throw captionErr;
                 }
             }
-            if (desc.includes('message is not modified')) {
-                return false;
+            // Fallback untuk Bot API versi lama tanpa parameter rich_message pada editMessageText
+            if (desc.includes('rich_message') || desc.includes('not supported') || desc.includes('wrong type')) {
+                return await this.callApi('editMessageText', {
+                    chat_id: chatId,
+                    message_id: Number(messageId),
+                    text: fallbackHtml,
+                    parse_mode: 'HTML',
+                    reply_markup: replyMarkup,
+                    ...extra,
+                });
             }
             throw err;
         }

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "teledzik",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Modern Telegram Bot Framework",
   "keywords": [
     "telekaf",
     "teledzik",
     "telegraf",
-    "telegram",
+    "telegram", 
     "telegram bot api",
     "bot",
     "botapi",

package/src/core/helpers/rich-sanitizer.ts

@@ -1,7 +1,9 @@
 function formatTableToCard(tableHtml: string): string {
   const rows: string[][] = []
+  let hasHeader = false
   const rowMatches = tableHtml.match(/<tr[^>]*>([\s\S]*?)<\/tr>/gi) || []
   for (const row of rowMatches) {
+    if (/<th[^>]*>/i.test(row)) hasHeader = true
     const cells: string[] = []
     const cellMatches = row.match(/<(th|td)[^>]*>([\s\S]*?)<\/\1>/gi) || []
     for (const cell of cellMatches) {
@@ -13,14 +15,19 @@ function formatTableToCard(tableHtml: string): string {
   if (rows.length === 0) return ''
 
   // Header vs Row handling (Format sebagai Kartu Elegan)
-  const isKeyValue = rows.length > 1 && rows.every((r) => r.length === 2)
-  let cardText = ''
+  const isKeyValue = rows.length > 0 && rows.every((r) => r.length === 2);
+  let cardText = '';
   if (isKeyValue) {
-    const lines = rows.slice(1).map((r) => `• <b>${r[0]}:</b> ${r[1]}`)
-    cardText = `<blockquote>\n${lines.join('\n')}\n</blockquote>\n\n`
+    const isHeaderRow = hasHeader && rows.length > 1 && (
+      /^(parameter|informasi|metrik|field|key|unit|format|statistik|opsi|nama|item)$/i.test(rows[0][0].replace(/<[^>]*>/g, '').trim()) ||
+      /^(status|keterangan|detail|nilai|value|jumlah|estimasi|tipe|contoh input)$/i.test(rows[0][1].replace(/<[^>]*>/g, '').trim())
+    );
+    const dataRows = isHeaderRow ? rows.slice(1) : rows;
+    const lines = dataRows.map((r) => `• <b>${r[0]}:</b> ${r[1]}`);
+    cardText = `<blockquote>\n${lines.join('\n')}\n</blockquote>\n\n`;
   } else {
     const lines = rows.map((r, idx) => {
-      if (idx === 0) return `<b>${r.join(' │ ')}</b>`
+      if (idx === 0 && hasHeader) return `<b>${r.join(' │ ')}</b>`
       return `${r.join(' │ ')}`
     })
     cardText = `<blockquote>\n${lines.join('\n')}\n</blockquote>\n\n`

package/src/telegram.ts

@@ -1688,11 +1688,13 @@ export class Telegram extends ApiClient {
     content: any,
     extra?: any
   ): Promise<any> {
+    let richPayload: any = content
     let htmlText = ''
     let replyMarkup = extra?.reply_markup
 
     if (typeof content?.build === 'function') {
       const built = content.build()
+      richPayload = built
       if (typeof built === 'object' && built !== null) {
         htmlText = built.html || built.text || built.caption || ''
         if (built.reply_markup) {
@@ -1702,22 +1704,20 @@ export class Telegram extends ApiClient {
         htmlText = String(built || '')
       }
     } else if (typeof content === 'object' && content !== null) {
+      richPayload = content
       htmlText = content.html || content.text || content.caption || ''
       if (content.reply_markup) {
         replyMarkup = replyMarkup || content.reply_markup
       }
     } else if (typeof content === 'string') {
       htmlText = content
+      richPayload = content.startsWith('{') || content.includes('<') ? content : { text: content }
     }
 
-    // Format ke Telegram Modern HTML
-    htmlText = sanitizeRichHtml(htmlText)
-
     const payload: Record<string, any> = {
       chat_id: chatId,
       message_id: Number(messageId),
-      text: htmlText,
-      parse_mode: 'HTML',
+      rich_message: richPayload,
       ...extra,
     }
 
@@ -1727,13 +1727,18 @@ export class Telegram extends ApiClient {
       return await this.callApi('editMessageText' as never, payload as never)
     } catch (err: any) {
       const desc = String(err?.description || err?.message || '')
+      // Ignore if message is unchanged
+      if (desc.includes('message is not modified')) {
+        return false
+      }
+      const fallbackHtml = sanitizeRichHtml(htmlText)
       // Fallback jika pesan berupa Media (Foto/Video)
       if (desc.includes('no text in the message') || desc.includes('message to edit not found')) {
         try {
           return await this.callApi('editMessageCaption' as never, {
             chat_id: chatId,
             message_id: Number(messageId),
-            caption: htmlText,
+            caption: fallbackHtml,
             parse_mode: 'HTML',
             reply_markup: replyMarkup,
             ...extra,
@@ -1743,8 +1748,16 @@ export class Telegram extends ApiClient {
           throw captionErr
         }
       }
-      if (desc.includes('message is not modified')) {
-        return false
+      // Fallback untuk Bot API versi lama tanpa parameter rich_message pada editMessageText
+      if (desc.includes('rich_message') || desc.includes('not supported') || desc.includes('wrong type')) {
+        return await this.callApi('editMessageText' as never, {
+          chat_id: chatId,
+          message_id: Number(messageId),
+          text: fallbackHtml,
+          parse_mode: 'HTML',
+          reply_markup: replyMarkup,
+          ...extra,
+        } as never)
       }
       throw err
     }