teledzik 1.0.5 → 1.0.6

package/README.md

@@ -588,9 +588,9 @@ await ctx.sendRichMessage(msg, {
 
 ---
 
-### Universal `editRichMessage` (Omni-Format Support)
+### Native `editRichMessage` (Preserving 100% Rich UI)
 
-Update existing messages or media captions in-place with **any** content format. It automatically detects Text vs Media (Photo/Video/Audio/Doc) and silently handles Telegram's `message is not modified` without throwing errors:
+Edit a rich message in-place while preserving 100% Native Rich UI layout (tables, headings, cards, collapsibles):
 
 ```ts
 import { Telegraf, RichHTMLBuilder, Markup } from 'teledzik'
@@ -605,23 +605,12 @@ bot.action('btn:update', async (ctx) => {
       ['VPS-02', '7.2 GB', 'ONLINE 🟢']
     ], { bordered: true, striped: true, hasHeader: true })
 
+  // Edit in-place with native Rich UI preservation
   await ctx.editRichMessage(rich, {
     reply_markup: Markup.inlineKeyboard([
       [Markup.button.primary('🔄 Refresh', 'btn:update')]
     ]).reply_markup
   })
-
-  // 2. Or using an Object
-  await ctx.editRichMessage({
-    html: '<b>New Content</b>',
-    reply_markup: { inline_keyboard: [] }
-  })
-
-  // 3. Or using Raw HTML String
-  await ctx.editRichMessage('<b>Updated via raw string</b>')
-
-  // 4. Or specifying a custom messageId
-  await ctx.editRichMessage(12345, '<b>Edit specific message ID</b>')
 })
 ```
 

package/lib/context.js

@@ -1069,39 +1069,21 @@ class Context {
         this.assert(this.chat, 'sendRichMessageDraft');
         return this.telegram.sendRichMessageDraft(this.chat.id, draftId, richMessage, extra);
     }
-    async editRichMessage(a, b, c) {
-        let targetMsgId;
-        let content;
-        let extra = {};
-        if (typeof a === 'number' ||
-            (typeof a === 'string' && !isNaN(Number(a)) && b !== undefined)) {
-            targetMsgId = a;
-            content = b;
-            extra = c || {};
-        }
-        else {
-            targetMsgId =
-                this.callbackQuery?.message?.message_id ??
-                    (this.message && 'message_id' in this.message ? this.message.message_id : undefined) ??
-                    (this.update && 'edited_message' in this.update && this.update.edited_message
-                        ? this.update.edited_message.message_id
-                        : undefined) ??
-                    this.msgId;
-            content = a;
-            extra = b || {};
-        }
-        const chatId = this.chat?.id ??
-            (this.callbackQuery?.message && 'chat' in this.callbackQuery.message
-                ? this.callbackQuery.message.chat.id
-                : undefined);
-        const inlineMsgId = this.inlineMessageId ?? extra?.inline_message_id;
-        if (!inlineMsgId && (!chatId || targetMsgId == null)) {
-            throw new Error('[teledzik] Tidak dapat menemukan chatId atau messageId dari konteks pesan saat ini.');
-        }
-        if (inlineMsgId && !extra.inline_message_id) {
-            extra.inline_message_id = inlineMsgId;
+    /**
+     * Context-aware shorthand for {@link Telegram.editRichMessage}.
+     */
+    editRichMessage(richMessage, extra) {
+        this.assert(this.chat, 'editRichMessage');
+        const messageId = this.callbackQuery?.message?.message_id ||
+            (this.message && 'message_id' in this.message ? this.message.message_id : undefined) ||
+            (this.update && 'edited_message' in this.update && this.update.edited_message
+                ? this.update.edited_message.message_id
+                : undefined) ||
+            this.msgId;
+        if (!messageId) {
+            throw new Error('[teledzik] Tidak dapat menemukan message_id untuk diedit.');
         }
-        return this.telegram.editRichMessage(chatId, targetMsgId, content, extra);
+        return this.telegram.editRichMessage(this.chat.id, messageId, richMessage, extra);
     }
     /**
      * Enqueue a Telegram API call for the current chat to prevent 429 Too Many Requests errors.

package/lib/telegram.js

@@ -1271,92 +1271,23 @@ class Telegram extends client_1.default {
             ...extra,
         });
     }
-    async editRichMessage(chatId, messageId, contentOrInline, contentOrExtra, maybeExtra) {
-        let inlineMessageId;
-        let content;
-        let extra = {};
-        if (typeof contentOrInline === 'string' &&
-            (typeof contentOrExtra === 'object' || typeof contentOrExtra === 'string') &&
-            maybeExtra !== undefined) {
-            inlineMessageId = contentOrInline;
-            content = contentOrExtra;
-            extra = maybeExtra || {};
-        }
-        else {
-            content = contentOrInline;
-            extra = contentOrExtra || {};
-            inlineMessageId = extra?.inline_message_id;
-        }
-        let htmlText = '';
-        let replyMarkup = extra?.reply_markup;
-        // 1. Omni-format input extraction
-        if (content && typeof content.build === 'function') {
-            const built = content.build();
-            if (typeof built === 'object' && built !== null) {
-                htmlText = built.html || built.text || built.caption || '';
-                if (built.reply_markup) {
-                    replyMarkup = replyMarkup || built.reply_markup;
-                }
-            }
-            else {
-                htmlText = String(built || '');
-            }
-        }
-        else if (typeof content === 'object' && content !== null) {
-            htmlText = content.html || content.text || content.caption || content.markdown || '';
-            if (content.reply_markup) {
-                replyMarkup = replyMarkup || content.reply_markup;
-            }
-        }
-        else if (typeof content === 'string') {
-            htmlText = content;
-        }
-        // Sanitize rich HTML formatting (tables, headers, details, etc.)
-        htmlText = (0, rich_sanitizer_1.sanitizeRichHtml)(htmlText);
-        // 2. Prepare Base Payload
-        const isInline = Boolean(inlineMessageId || extra?.inline_message_id);
-        const basePayload = {
-            parse_mode: 'HTML',
+    /**
+     * Edit a rich message in-place while preserving 100% Native Rich UI layout (tables, headings, cards).
+     * @see https://core.telegram.org/bots/api#editrichmessage
+     */
+    async editRichMessage(chatId, messageId, richMessage, extra) {
+        const payload = {
+            chat_id: chatId,
+            message_id: Number(messageId),
+            rich_message: typeof richMessage?.build === 'function' ? richMessage.build() : richMessage,
             ...extra,
         };
-        if (isInline) {
-            basePayload.inline_message_id = inlineMessageId || extra.inline_message_id;
-        }
-        else {
-            basePayload.chat_id = chatId;
-            basePayload.message_id = messageId != null ? Number(messageId) : undefined;
-        }
-        if (replyMarkup) {
-            basePayload.reply_markup = replyMarkup;
-        }
-        // 3. Execution with Auto-Detect (Text -> Caption Fallback) and Silent Error Handling
         try {
-            return await this.callApi('editMessageText', {
-                ...basePayload,
-                text: htmlText,
-            });
+            return await this.callApi('editRichMessage', payload);
         }
         catch (err) {
             const desc = String(err?.description || err?.message || '');
-            // Fallback: If target is a Media message (Photo, Video, Audio, Document, Animation)
-            if (desc.includes('no text in the message') ||
-                desc.includes('there is no text in the message to edit') ||
-                desc.includes('message to edit not found')) {
-                try {
-                    return await this.callApi('editMessageCaption', {
-                        ...basePayload,
-                        caption: htmlText,
-                    });
-                }
-                catch (captionErr) {
-                    const capDesc = String(captionErr?.description || captionErr?.message || '');
-                    if (capDesc.includes('message is not modified')) {
-                        return false;
-                    }
-                    throw captionErr;
-                }
-            }
-            // Gracefully handle 'message is not modified'
+            // Silent ignore jika konten pesan tidak mengalami perubahan
             if (desc.includes('message is not modified')) {
                 return false;
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "teledzik",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "Modern Telegram Bot Framework",
   "keywords": [
     "telekaf",

package/src/context.ts

@@ -1407,61 +1407,22 @@ export class Context<U extends Deunionize<tg.Update> = tg.Update> {
   }
 
   /**
-   * Universal Context shortcut to edit message with Omni-Format support (RichHTMLBuilder, Object, or String),
-   * auto-detection of Text vs Media Caption, and silent 'not modified' error handling.
-   */
-  editRichMessage(
-    content: tg.RichContentInput,
-    extra?: tg.EditRichOptions
-  ): Promise<any>
-  editRichMessage(
-    messageId: number | string,
-    content: tg.RichContentInput,
-    extra?: tg.EditRichOptions
-  ): Promise<any>
-  async editRichMessage(a: any, b?: any, c?: any): Promise<any> {
-    let targetMsgId: number | string | undefined
-    let content: any
-    let extra: any = {}
-
-    if (
-      typeof a === 'number' ||
-      (typeof a === 'string' && !isNaN(Number(a)) && b !== undefined)
-    ) {
-      targetMsgId = a
-      content = b
-      extra = c || {}
-    } else {
-      targetMsgId =
-        this.callbackQuery?.message?.message_id ??
-        (this.message && 'message_id' in this.message ? this.message.message_id : undefined) ??
-        (this.update && 'edited_message' in this.update && this.update.edited_message
-          ? this.update.edited_message.message_id
-          : undefined) ??
-        this.msgId
-      content = a
-      extra = b || {}
+   * Context-aware shorthand for {@link Telegram.editRichMessage}.
+   */
+  editRichMessage(richMessage: any, extra?: any): Promise<any> {
+    this.assert(this.chat, 'editRichMessage')
+    const messageId =
+      this.callbackQuery?.message?.message_id ||
+      (this.message && 'message_id' in this.message ? this.message.message_id : undefined) ||
+      (this.update && 'edited_message' in this.update && this.update.edited_message
+        ? this.update.edited_message.message_id
+        : undefined) ||
+      this.msgId
+
+    if (!messageId) {
+      throw new Error('[teledzik] Tidak dapat menemukan message_id untuk diedit.')
     }
-
-    const chatId =
-      this.chat?.id ??
-      (this.callbackQuery?.message && 'chat' in this.callbackQuery.message
-        ? this.callbackQuery.message.chat.id
-        : undefined)
-
-    const inlineMsgId = this.inlineMessageId ?? extra?.inline_message_id
-
-    if (!inlineMsgId && (!chatId || targetMsgId == null)) {
-      throw new Error(
-        '[teledzik] Tidak dapat menemukan chatId atau messageId dari konteks pesan saat ini.'
-      )
-    }
-
-    if (inlineMsgId && !extra.inline_message_id) {
-      extra.inline_message_id = inlineMsgId
-    }
-
-    return this.telegram.editRichMessage(chatId, targetMsgId, content, extra)
+    return this.telegram.editRichMessage(this.chat.id, messageId, richMessage, extra)
   }
 
   /**

package/src/telegram.ts

@@ -1680,125 +1680,29 @@ export class Telegram extends ApiClient {
   }
 
   /**
-   * Universal editRichMessage to update text or media captions in-place with Omni-Format support.
-   * Auto-detects Text vs Media Caption and gracefully handles 'message is not modified'.
+   * Edit a rich message in-place while preserving 100% Native Rich UI layout (tables, headings, cards).
+   * @see https://core.telegram.org/bots/api#editrichmessage
    */
   async editRichMessage(
-    chatId: number | string | undefined,
-    messageId: number | string | undefined,
-    content: any,
-    extra?: any
-  ): Promise<any>
-  async editRichMessage(
-    chatId: number | string | undefined,
-    messageId: number | string | undefined,
-    inlineMessageId: string | undefined,
-    content: any,
+    chatId: number | string,
+    messageId: number | string,
+    richMessage: any,
     extra?: any
-  ): Promise<any>
-  async editRichMessage(
-    chatId: number | string | undefined,
-    messageId: number | string | undefined,
-    contentOrInline: any,
-    contentOrExtra?: any,
-    maybeExtra?: any
   ): Promise<any> {
-    let inlineMessageId: string | undefined
-    let content: any
-    let extra: any = {}
-
-    if (
-      typeof contentOrInline === 'string' &&
-      (typeof contentOrExtra === 'object' || typeof contentOrExtra === 'string') &&
-      maybeExtra !== undefined
-    ) {
-      inlineMessageId = contentOrInline
-      content = contentOrExtra
-      extra = maybeExtra || {}
-    } else {
-      content = contentOrInline
-      extra = contentOrExtra || {}
-      inlineMessageId = extra?.inline_message_id
-    }
-
-    let htmlText = ''
-    let replyMarkup = extra?.reply_markup
-
-    // 1. Omni-format input extraction
-    if (content && typeof content.build === 'function') {
-      const built = content.build()
-      if (typeof built === 'object' && built !== null) {
-        htmlText = built.html || built.text || built.caption || ''
-        if (built.reply_markup) {
-          replyMarkup = replyMarkup || built.reply_markup
-        }
-      } else {
-        htmlText = String(built || '')
-      }
-    } else if (typeof content === 'object' && content !== null) {
-      htmlText = content.html || content.text || content.caption || content.markdown || ''
-      if (content.reply_markup) {
-        replyMarkup = replyMarkup || content.reply_markup
-      }
-    } else if (typeof content === 'string') {
-      htmlText = content
-    }
-
-    // Sanitize rich HTML formatting (tables, headers, details, etc.)
-    htmlText = sanitizeRichHtml(htmlText)
-
-    // 2. Prepare Base Payload
-    const isInline = Boolean(inlineMessageId || extra?.inline_message_id)
-    const basePayload: any = {
-      parse_mode: 'HTML',
+    const payload: Record<string, any> = {
+      chat_id: chatId,
+      message_id: Number(messageId),
+      rich_message: typeof richMessage?.build === 'function' ? richMessage.build() : richMessage,
       ...extra,
     }
-
-    if (isInline) {
-      basePayload.inline_message_id = inlineMessageId || extra.inline_message_id
-    } else {
-      basePayload.chat_id = chatId
-      basePayload.message_id = messageId != null ? Number(messageId) : undefined
-    }
-
-    if (replyMarkup) {
-      basePayload.reply_markup = replyMarkup
-    }
-
-    // 3. Execution with Auto-Detect (Text -> Caption Fallback) and Silent Error Handling
     try {
-      return await this.callApi('editMessageText' as never, {
-        ...basePayload,
-        text: htmlText,
-      } as never)
+      return await this.callApi('editRichMessage' as never, payload as never)
     } catch (err: any) {
       const desc = String(err?.description || err?.message || '')
-
-      // Fallback: If target is a Media message (Photo, Video, Audio, Document, Animation)
-      if (
-        desc.includes('no text in the message') ||
-        desc.includes('there is no text in the message to edit') ||
-        desc.includes('message to edit not found')
-      ) {
-        try {
-          return await this.callApi('editMessageCaption' as never, {
-            ...basePayload,
-            caption: htmlText,
-          } as never)
-        } catch (captionErr: any) {
-          const capDesc = String(captionErr?.description || captionErr?.message || '')
-          if (capDesc.includes('message is not modified')) {
-            return false
-          }
-          throw captionErr
-        }
-      }
-
-      // Gracefully handle 'message is not modified'
+      // Silent ignore jika konten pesan tidak mengalami perubahan
       if (desc.includes('message is not modified')) {
         return false
       }
-
       throw err
     }
   }

package/typings/context.d.ts

@@ -591,11 +591,9 @@ export declare class Context<U extends Deunionize<tg.Update> = tg.Update> {
      */
     sendRichMessageDraft(draftId: number, richMessage: tg.InputRichMessage, extra?: tt.ExtraSendRichMessageDraft): Promise<never>;
     /**
-     * Universal Context shortcut to edit message with Omni-Format support (RichHTMLBuilder, Object, or String),
-     * auto-detection of Text vs Media Caption, and silent 'not modified' error handling.
+     * Context-aware shorthand for {@link Telegram.editRichMessage}.
      */
-    editRichMessage(content: tg.RichContentInput, extra?: tg.EditRichOptions): Promise<any>;
-    editRichMessage(messageId: number | string, content: tg.RichContentInput, extra?: tg.EditRichOptions): Promise<any>;
+    editRichMessage(richMessage: any, extra?: any): Promise<any>;
     /**
      * Enqueue a Telegram API call for the current chat to prevent 429 Too Many Requests errors.
      */

package/typings/telegram.d.ts

@@ -690,10 +690,9 @@ export declare class Telegram extends ApiClient {
      */
     sendRichMessageDraft(chatId: number, draftId: number, richMessage: tg.InputRichMessage, extra?: tt.ExtraSendRichMessageDraft): Promise<never>;
     /**
-     * Universal editRichMessage to update text or media captions in-place with Omni-Format support.
-     * Auto-detects Text vs Media Caption and gracefully handles 'message is not modified'.
+     * Edit a rich message in-place while preserving 100% Native Rich UI layout (tables, headings, cards).
+     * @see https://core.telegram.org/bots/api#editrichmessage
      */
-    editRichMessage(chatId: number | string | undefined, messageId: number | string | undefined, content: any, extra?: any): Promise<any>;
-    editRichMessage(chatId: number | string | undefined, messageId: number | string | undefined, inlineMessageId: string | undefined, content: any, extra?: any): Promise<any>;
+    editRichMessage(chatId: number | string, messageId: number | string, richMessage: any, extra?: any): Promise<any>;
 }
 export default Telegram;