teledzik 1.0.4 → 1.0.6

package/README.md

@@ -588,6 +588,32 @@ await ctx.sendRichMessage(msg, {
 
 ---
 
+### Native `editRichMessage` (Preserving 100% Rich UI)
+
+Edit a rich message in-place while preserving 100% Native Rich UI layout (tables, headings, cards, collapsibles):
+
+```ts
+import { Telegraf, RichHTMLBuilder, Markup } from 'teledzik'
+
+bot.action('btn:update', async (ctx) => {
+  // 1. Using RichHTMLBuilder instance directly
+  const rich = new RichHTMLBuilder()
+    .heading(1, '⚡ Server Stats Updated')
+    .table([
+      ['Node', 'RAM', 'Status'],
+      ['VPS-01', '3.8 GB', 'ONLINE 🟢'],
+      ['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
+  })
+})
+```
+
 ### Inline / Web App Queries
 
 Use `InputRichMessageContent` as `input_message_content` in inline query results:

package/lib/context.js

@@ -1070,11 +1070,20 @@ class Context {
         return this.telegram.sendRichMessageDraft(this.chat.id, draftId, richMessage, extra);
     }
     /**
-     * Edit current message with a rich message format.
+     * Context-aware shorthand for {@link Telegram.editRichMessage}.
      */
     editRichMessage(richMessage, extra) {
-        this.assert(this.msgId ?? this.inlineMessageId, 'editRichMessage');
-        return this.telegram.editRichMessage(this.chat?.id, this.msgId, this.inlineMessageId, 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(this.chat.id, messageId, richMessage, extra);
     }
     /**
      * Enqueue a Telegram API call for the current chat to prevent 429 Too Many Requests errors.
@@ -1241,9 +1250,7 @@ const Msg = {
         return 'date' in this && this.date !== 0;
     },
     has(...keys) {
-        return keys.some((key) => 
-        // @ts-expect-error TS doesn't understand key
-        this[key] != undefined);
+        return keys.some((key) => this[key] != undefined);
     },
 };
 function getMessageFromAnySource(ctx) {

package/lib/index.js

@@ -23,7 +23,7 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InputBox = exports.FormScene = exports.PaginatedBuilder = exports.sanitizeRichHtml = exports.AIStreamAdapter = exports.SmartQueue = exports.RichMessage = exports.Scenes = exports.MemorySessionStore = exports.session = exports.deunionize = exports.Format = exports.Input = exports.Markup = exports.Types = exports.Telegram = exports.TelegramError = exports.Router = exports.Composer = exports.Context = exports.Telegraf = void 0;
+exports.InputBox = exports.FormScene = exports.PaginatedBuilder = exports.sanitizeRichHtml = exports.AIStreamAdapter = exports.SmartQueue = exports.MD = exports.HTML = exports.RichMarkdownBuilder = exports.RichHTMLBuilder = exports.RichMessage = exports.Scenes = exports.MemorySessionStore = exports.session = exports.deunionize = exports.Format = exports.Input = exports.Markup = exports.Types = exports.Telegram = exports.TelegramError = exports.Router = exports.Composer = exports.Context = exports.Telegraf = void 0;
 var telegraf_1 = require("./telegraf");
 Object.defineProperty(exports, "Telegraf", { enumerable: true, get: function () { return telegraf_1.Telegraf; } });
 var context_1 = require("./context");
@@ -47,6 +47,11 @@ Object.defineProperty(exports, "session", { enumerable: true, get: function () {
 Object.defineProperty(exports, "MemorySessionStore", { enumerable: true, get: function () { return session_1.MemorySessionStore; } });
 exports.Scenes = __importStar(require("./scenes"));
 exports.RichMessage = __importStar(require("./core/types/rich-message"));
+var rich_message_1 = require("./core/types/rich-message");
+Object.defineProperty(exports, "RichHTMLBuilder", { enumerable: true, get: function () { return rich_message_1.RichHTMLBuilder; } });
+Object.defineProperty(exports, "RichMarkdownBuilder", { enumerable: true, get: function () { return rich_message_1.RichMarkdownBuilder; } });
+Object.defineProperty(exports, "HTML", { enumerable: true, get: function () { return rich_message_1.RichHTMLBuilder; } });
+Object.defineProperty(exports, "MD", { enumerable: true, get: function () { return rich_message_1.MD; } });
 var smart_queue_1 = require("./core/helpers/smart-queue");
 Object.defineProperty(exports, "SmartQueue", { enumerable: true, get: function () { return smart_queue_1.SmartQueue; } });
 var ai_stream_1 = require("./core/helpers/ai-stream");

package/lib/telegram.js

@@ -1272,17 +1272,27 @@ class Telegram extends client_1.default {
         });
     }
     /**
-     * Edit a sent rich message.
+     * 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, messageId, inlineMessageId, richMessage, extra) {
-        return this.callApi('editMessageText', {
+    async editRichMessage(chatId, messageId, richMessage, extra) {
+        const payload = {
             chat_id: chatId,
-            message_id: messageId,
-            inline_message_id: inlineMessageId,
-            text: richMessage.html ?? richMessage.markdown ?? '',
-            parse_mode: richMessage.html ? 'HTML' : richMessage.markdown ? 'MarkdownV2' : undefined,
+            message_id: Number(messageId),
+            rich_message: typeof richMessage?.build === 'function' ? richMessage.build() : richMessage,
             ...extra,
-        });
+        };
+        try {
+            return await this.callApi('editRichMessage', payload);
+        }
+        catch (err) {
+            const desc = String(err?.description || err?.message || '');
+            // Silent ignore jika konten pesan tidak mengalami perubahan
+            if (desc.includes('message is not modified')) {
+                return false;
+            }
+            throw err;
+        }
     }
 }
 exports.Telegram = Telegram;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "teledzik",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "Modern Telegram Bot Framework",
   "keywords": [
     "telekaf",
@@ -12,7 +12,7 @@
     "botapi",
     "bot framework",
     "rich messages",
-    "bot api 1.0.1"
+    "bot api 1.0.5"
   ],
   "homepage": "https://telegraf.js.org",
   "bugs": {

package/src/context.ts

@@ -1407,17 +1407,22 @@ export class Context<U extends Deunionize<tg.Update> = tg.Update> {
   }
 
   /**
-   * Edit current message with a rich message format.
-   */
-  editRichMessage(richMessage: tg.InputRichMessage, extra?: object) {
-    this.assert(this.msgId ?? this.inlineMessageId, 'editRichMessage')
-    return this.telegram.editRichMessage(
-      this.chat?.id,
-      this.msgId,
-      this.inlineMessageId,
-      richMessage,
-      extra
-    )
+   * 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.')
+    }
+    return this.telegram.editRichMessage(this.chat.id, messageId, richMessage, extra)
   }
 
   /**
@@ -1650,18 +1655,14 @@ interface Msg {
   ): this is MaybeMessage<Keyed<tg.Message, Ks[number]>>
 }
 
-const Msg: Msg = {
-  isAccessible() {
+const Msg = {
+  isAccessible(this: any) {
     return 'date' in this && this.date !== 0
   },
-  has(...keys) {
-    return keys.some(
-      (key) =>
-        // @ts-expect-error TS doesn't understand key
-        this[key] != undefined
-    )
+  has(this: any, ...keys: string[]) {
+    return keys.some((key) => this[key] != undefined)
   },
-}
+} as Msg
 
 export type MaybeMessage<
   M extends tg.MaybeInaccessibleMessage = tg.MaybeInaccessibleMessage,

package/src/core/types/rich-message.ts

@@ -32,6 +32,21 @@ export interface InputRichMessageContent {
   rich_message: InputRichMessage
 }
 
+export interface EditRichOptions {
+  reply_markup?: any
+  disable_web_page_preview?: boolean
+  link_preview_options?: any
+  inline_message_id?: string
+  [key: string]: any
+}
+
+export type RichContentInput =
+  | string
+  | { html?: string; text?: string; caption?: string; markdown?: string; reply_markup?: any }
+  | { build(): string | InputRichMessage | { html?: string; text?: string; reply_markup?: any } }
+  | InputRichMessage
+
+
 // ---------------------------------------------------------------------------
 // HTML Builder
 // ---------------------------------------------------------------------------

package/src/index.ts

@@ -16,6 +16,7 @@ export { session, MemorySessionStore, SessionStore } from './session'
 
 export * as Scenes from './scenes'
 export * as RichMessage from './core/types/rich-message'
+export { RichHTMLBuilder, RichMarkdownBuilder, RichHTMLBuilder as HTML, MD } from './core/types/rich-message'
 
 export { SmartQueue } from './core/helpers/smart-queue'
 export { AIStreamAdapter } from './core/helpers/ai-stream'

package/src/telegram.ts

@@ -1680,23 +1680,31 @@ export class Telegram extends ApiClient {
   }
 
   /**
-   * Edit a sent rich message.
+   * 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 | undefined,
-    inlineMessageId: string | undefined,
-    richMessage: tg.InputRichMessage,
-    extra?: object
-  ) {
-    return this.callApi('editMessageText' as never, {
+  async editRichMessage(
+    chatId: number | string,
+    messageId: number | string,
+    richMessage: any,
+    extra?: any
+  ): Promise<any> {
+    const payload: Record<string, any> = {
       chat_id: chatId,
-      message_id: messageId,
-      inline_message_id: inlineMessageId,
-      text: richMessage.html ?? richMessage.markdown ?? '',
-      parse_mode: richMessage.html ? 'HTML' : richMessage.markdown ? 'MarkdownV2' : undefined,
+      message_id: Number(messageId),
+      rich_message: typeof richMessage?.build === 'function' ? richMessage.build() : richMessage,
       ...extra,
-    } as never)
+    }
+    try {
+      return await this.callApi('editRichMessage' as never, payload as never)
+    } catch (err: any) {
+      const desc = String(err?.description || err?.message || '')
+      // 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,9 +591,9 @@ export declare class Context<U extends Deunionize<tg.Update> = tg.Update> {
      */
     sendRichMessageDraft(draftId: number, richMessage: tg.InputRichMessage, extra?: tt.ExtraSendRichMessageDraft): Promise<never>;
     /**
-     * Edit current message with a rich message format.
+     * Context-aware shorthand for {@link Telegram.editRichMessage}.
      */
-    editRichMessage(richMessage: tg.InputRichMessage, extra?: object): Promise<never>;
+    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/core/types/rich-message.d.ts

@@ -24,6 +24,26 @@ export interface InputRichMessage {
 export interface InputRichMessageContent {
     rich_message: InputRichMessage;
 }
+export interface EditRichOptions {
+    reply_markup?: any;
+    disable_web_page_preview?: boolean;
+    link_preview_options?: any;
+    inline_message_id?: string;
+    [key: string]: any;
+}
+export type RichContentInput = string | {
+    html?: string;
+    text?: string;
+    caption?: string;
+    markdown?: string;
+    reply_markup?: any;
+} | {
+    build(): string | InputRichMessage | {
+        html?: string;
+        text?: string;
+        reply_markup?: any;
+    };
+} | InputRichMessage;
 /**
  * Fluent builder for Rich Messages using HTML format.
  *

package/typings/index.d.ts

@@ -13,6 +13,7 @@ export { deunionize } from './core/helpers/deunionize';
 export { session, MemorySessionStore, SessionStore } from './session';
 export * as Scenes from './scenes';
 export * as RichMessage from './core/types/rich-message';
+export { RichHTMLBuilder, RichMarkdownBuilder, RichHTMLBuilder as HTML, MD } from './core/types/rich-message';
 export { SmartQueue } from './core/helpers/smart-queue';
 export { AIStreamAdapter } from './core/helpers/ai-stream';
 export { sanitizeRichHtml } from './core/helpers/rich-sanitizer';

package/typings/telegram.d.ts

@@ -690,8 +690,9 @@ export declare class Telegram extends ApiClient {
      */
     sendRichMessageDraft(chatId: number, draftId: number, richMessage: tg.InputRichMessage, extra?: tt.ExtraSendRichMessageDraft): Promise<never>;
     /**
-     * Edit a sent rich message.
+     * 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 | undefined, inlineMessageId: string | undefined, richMessage: tg.InputRichMessage, extra?: object): Promise<never>;
+    editRichMessage(chatId: number | string, messageId: number | string, richMessage: any, extra?: any): Promise<any>;
 }
 export default Telegram;