@gaias/basenode 1.6.2 → 1.6.4

package/dist/libs/telegram/MessageExamples.js

@@ -0,0 +1,728 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessageExamples = void 0;
+exports.example1_BasicTextMessage = example1_BasicTextMessage;
+exports.example2_RichTextFormatting = example2_RichTextFormatting;
+exports.example3_CodeBlocks = example3_CodeBlocks;
+exports.example4_CaptionItemsBuilder = example4_CaptionItemsBuilder;
+exports.example5_MessageOptionsBuilder = example5_MessageOptionsBuilder;
+exports.example6_InlineKeyboard = example6_InlineKeyboard;
+exports.example7_SinglePhoto = example7_SinglePhoto;
+exports.example8_PhotoGroup = example8_PhotoGroup;
+exports.example9_MediaGroupItemBuilder = example9_MediaGroupItemBuilder;
+exports.example10_ReplyToMessage = example10_ReplyToMessage;
+exports.example11_SendToMultipleBots = example11_SendToMultipleBots;
+exports.example12_StatusReport = example12_StatusReport;
+exports.example13_KeyValuePairs = example13_KeyValuePairs;
+exports.example14_CombiningBuilders = example14_CombiningBuilders;
+exports.example15_ConditionalFormatting = example15_ConditionalFormatting;
+exports.example16_MediaGroupFromPaths = example16_MediaGroupFromPaths;
+exports.example17_MediaGroupChaining = example17_MediaGroupChaining;
+exports.example18_MediaGroupToTelegram = example18_MediaGroupToTelegram;
+exports.example19_MediaGroupInstanceConversion = example19_MediaGroupInstanceConversion;
+exports.example20_MediaGroupMixedTypes = example20_MediaGroupMixedTypes;
+exports.example21_MediaGroupBatchPhotos = example21_MediaGroupBatchPhotos;
+exports.example22_MediaGroupCompleteWorkflow = example22_MediaGroupCompleteWorkflow;
+exports.example23_MediaGroupWithSpoiler = example23_MediaGroupWithSpoiler;
+exports.example24_MediaGroupDynamicBuilding = example24_MediaGroupDynamicBuilding;
+exports.runAllExamples = runAllExamples;
+const typedi_1 = require("typedi");
+const TelegramSender_1 = require("./TelegramSender");
+const ParseMode_1 = require("./ParseMode");
+const CaptionItemsBuilder_1 = require("./CaptionItemsBuilder");
+const MessageOptionsBuilder_1 = require("./MessageOptionsBuilder");
+const MediaGroupItemBuilder_1 = require("./MediaGroupItemBuilder");
+const MediaType_1 = require("./MediaType");
+async function example1_BasicTextMessage() {
+    const sender = typedi_1.Container.get(TelegramSender_1.TelegramSender);
+    await sender.parseMode(ParseMode_1.ParseMode.HTML).text('Hello ').bold('World').text('!').newLine().text('This is a ').italic('basic').text(' message.').send('ResearchBot');
+    console.log('✅ Example 1: Basic text message sent');
+}
+async function example2_RichTextFormatting() {
+    const sender = typedi_1.Container.get(TelegramSender_1.TelegramSender);
+    await sender.parseMode(ParseMode_1.ParseMode.HTML).bold('粗体文本 Bold Text').newLine().italic('斜体文本 Italic Text').newLine().code('内联代码 Inline Code').newLine().strike('删除线文本 Strikethrough').newLine().underline('下划线文本 Underline').newLine().link('链接文本 Link', 'https://example.com').newLine(2).separator('=', 30).newLine().listItem('列表项 1 List Item 1').listItem('列表项 2 List Item 2').listItem('列表项 3 List Item 3').send('ResearchBot');
+    console.log('✅ Example 2: Rich text formatting sent');
+}
+async function example3_CodeBlocks() {
+    const sender = typedi_1.Container.get(TelegramSender_1.TelegramSender);
+    const code = `function greet(name) {
+  console.log(\`Hello, \${name}!\`);
+}
+
+greet('World');`;
+    await sender.parseMode(ParseMode_1.ParseMode.HTML).bold('代码示例 Code Example:').newLine(2).codeBlock(code, 'javascript').newLine().text('这是一个 JavaScript 函数示例。').send('ResearchBot');
+    console.log('✅ Example 3: Code blocks sent');
+}
+async function example4_CaptionItemsBuilder() {
+    const sender = typedi_1.Container.get(TelegramSender_1.TelegramSender);
+    const caption = CaptionItemsBuilder_1.CaptionItemsBuilder.create()
+        .append({
+        index: 0,
+        key: '*项目名称*',
+        value: 'BaseNode Infrastructure',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 1,
+        key: '*版本*',
+        value: 'v1.6.3',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 2,
+        key: '*状态*',
+        value: '✅ 运行中',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 3,
+        key: '*最后更新*',
+        value: '2024-01-20 10:30',
+        hasKey: true,
+        hasValue: true,
+    })
+        .sort()
+        .toString();
+    await sender.parseMode(ParseMode_1.ParseMode.MARKDOWN).text(caption).send('ResearchBot');
+    console.log('✅ Example 4: CaptionItemsBuilder sent');
+}
+async function example5_MessageOptionsBuilder() {
+    const sender = typedi_1.Container.get(TelegramSender_1.TelegramSender);
+    const options = MessageOptionsBuilder_1.MessageOptionsBuilder.create()
+        .parseMode(ParseMode_1.ParseMode.MARKDOWN)
+        .disableNotification()
+        .protectContent()
+        .disableWebPagePreview()
+        .getOptions();
+    await sender.text('*受保护的消息*').newLine(2).text('此消息具有以下特性：').newLine().listItem('静默发送（不会通知用户）').listItem('内容受保护（无法转发）').listItem('禁用链接预览').option(options).send('ResearchBot');
+    console.log('✅ Example 5: MessageOptionsBuilder sent');
+}
+async function example6_InlineKeyboard() {
+    const sender = typedi_1.Container.get(TelegramSender_1.TelegramSender);
+    const caption = CaptionItemsBuilder_1.CaptionItemsBuilder.create()
+        .append({
+        index: 0,
+        key: '*操作提示*',
+        value: '请选择要执行的操作',
+        hasKey: true,
+        hasValue: true,
+    })
+        .sort()
+        .toString();
+    const options = MessageOptionsBuilder_1.MessageOptionsBuilder.create()
+        .parseMode(ParseMode_1.ParseMode.MARKDOWN)
+        .setInlineKeyboard([
+        [
+            { text: '✅ 确认', callback_data: 'confirm' },
+            { text: '❌ 取消', callback_data: 'cancel' },
+        ],
+        [
+            { text: '📊 查看详情', callback_data: 'view_details' },
+            { text: '🔄 刷新', callback_data: 'refresh' },
+        ],
+        [{ text: '🔗 访问官网', url: 'https://example.com' }],
+    ])
+        .getOptions();
+    await sender.text(caption).option(options).send('ResearchBot');
+    console.log('✅ Example 6: Inline keyboard sent');
+}
+async function example7_SinglePhoto() {
+    const sender = typedi_1.Container.get(TelegramSender_1.TelegramSender);
+    const caption = CaptionItemsBuilder_1.CaptionItemsBuilder.create()
+        .append({
+        index: 0,
+        key: '*图片名称*',
+        value: '日落海滩',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 1,
+        key: '*拍摄地点*',
+        value: '加利福尼亚',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 2,
+        key: '*拍摄日期*',
+        value: '2024-01-15',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 3,
+        key: '*分辨率*',
+        value: '4096x2160',
+        hasKey: true,
+        hasValue: true,
+    })
+        .sort()
+        .toString();
+    const options = MessageOptionsBuilder_1.MessageOptionsBuilder.create().parseMode(ParseMode_1.ParseMode.MARKDOWN).disableNotification().getOptions();
+    const mediaBuilder = MediaGroupItemBuilder_1.MediaGroupItemBuilder.create().append({
+        type: 'photo',
+        media: '/path/to/sunset.jpg',
+        caption: caption,
+        parse_mode: ParseMode_1.ParseMode.MARKDOWN,
+    });
+    await sender.parseMode(ParseMode_1.ParseMode.MARKDOWN).option(options)
+        .photos(mediaBuilder.medias()).sendMedia('ResearchBot');
+    console.log('✅ Example 7: Single photo sent');
+}
+async function example8_PhotoGroup() {
+    const sender = typedi_1.Container.get(TelegramSender_1.TelegramSender);
+    const caption = CaptionItemsBuilder_1.CaptionItemsBuilder.create()
+        .append({
+        index: 0,
+        key: '*相册名称*',
+        value: '日落系列',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 1,
+        key: '*照片数量*',
+        value: '3张',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 2,
+        key: '*拍摄地点*',
+        value: '海滩',
+        hasKey: true,
+        hasValue: true,
+    })
+        .sort()
+        .toString();
+    const options = MessageOptionsBuilder_1.MessageOptionsBuilder.create().parseMode(ParseMode_1.ParseMode.MARKDOWN).disableNotification().protectContent().getOptions();
+    const photoPaths = ['/path/to/photo1.jpg', '/path/to/photo2.jpg', '/path/to/photo3.jpg'];
+    const mediaBuilder = MediaGroupItemBuilder_1.MediaGroupItemBuilder.create().fromImages(photoPaths, {
+        captions: [caption],
+        parseMode: ParseMode_1.ParseMode.MARKDOWN,
+    });
+    await sender.parseMode(ParseMode_1.ParseMode.MARKDOWN).option(options).photos(mediaBuilder.medias()).sendMedia('ResearchBot');
+    console.log('✅ Example 8: Photo group sent');
+}
+async function example9_MediaGroupItemBuilder() {
+    const mediaGroup = MediaGroupItemBuilder_1.MediaGroupItemBuilder.create()
+        .append({
+        type: MediaType_1.MediaType.PHOTO,
+        media: '/path/to/photo1.jpg',
+        caption: '第一张照片 - 日出',
+        parse_mode: ParseMode_1.ParseMode.MARKDOWN,
+    })
+        .append({
+        type: MediaType_1.MediaType.PHOTO,
+        media: '/path/to/photo2.jpg',
+        caption: '第二张照片 - 中午',
+        parse_mode: ParseMode_1.ParseMode.MARKDOWN,
+    })
+        .append({
+        type: MediaType_1.MediaType.PHOTO,
+        media: '/path/to/photo3.jpg',
+        caption: '第三张照片 - 日落',
+        parse_mode: ParseMode_1.ParseMode.MARKDOWN,
+    })
+        .sortByType()
+        .build();
+    const validation = MediaGroupItemBuilder_1.MediaGroupItemBuilder.create().after(mediaGroup).validate();
+    if (!validation.isValid) {
+        console.error('媒体组验证失败:', validation.errors);
+        return;
+    }
+    console.log('✅ Example 9: MediaGroupItemBuilder completed');
+}
+async function example10_ReplyToMessage() {
+    const sender = typedi_1.Container.get(TelegramSender_1.TelegramSender);
+    const reply = CaptionItemsBuilder_1.CaptionItemsBuilder.create()
+        .append({
+        index: 0,
+        key: '*回复*',
+        value: '已收到您的反馈',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 1,
+        key: '*状态*',
+        value: '✅ 已处理',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 2,
+        key: '*处理时间*',
+        value: '2024-01-20 14:30',
+        hasKey: true,
+        hasValue: true,
+    })
+        .sort()
+        .toString();
+    const options = MessageOptionsBuilder_1.MessageOptionsBuilder.create()
+        .parseMode(ParseMode_1.ParseMode.MARKDOWN)
+        .replyToMessage(12345)
+        .disableNotification()
+        .getOptions();
+    await sender.text(reply).option(options).send('ResearchBot');
+    console.log('✅ Example 10: Reply to message sent');
+}
+async function example11_SendToMultipleBots() {
+    const sender = typedi_1.Container.get(TelegramSender_1.TelegramSender);
+    const broadcast = CaptionItemsBuilder_1.CaptionItemsBuilder.create()
+        .append({
+        index: 0,
+        key: '*广播通知*',
+        value: '系统维护公告',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 1,
+        key: '*维护时间*',
+        value: '2024-01-21 02:00-04:00',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 2,
+        key: '*影响范围*',
+        value: '所有服务暂时不可用',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 3,
+        key: '*预计恢复*',
+        value: '04:00',
+        hasKey: true,
+        hasValue: true,
+    })
+        .sort()
+        .toString();
+    const options = MessageOptionsBuilder_1.MessageOptionsBuilder.create().parseMode(ParseMode_1.ParseMode.MARKDOWN).disableNotification().getOptions();
+    await sender.text(broadcast).option(options).sendToMultiple(['ResearchBot', 'UserBot', 'AdminBot']);
+    console.log('✅ Example 11: Broadcast to multiple bots sent');
+}
+async function example12_StatusReport() {
+    const sender = typedi_1.Container.get(TelegramSender_1.TelegramSender);
+    const projectInfo = CaptionItemsBuilder_1.CaptionItemsBuilder.create()
+        .append({
+        index: 0,
+        key: '*项目名称*',
+        value: 'BaseNode Infrastructure',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 1,
+        key: '*版本*',
+        value: 'v1.6.3',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 2,
+        key: '*构建日期*',
+        value: '2024-01-20',
+        hasKey: true,
+        hasValue: true,
+    })
+        .sort()
+        .toString();
+    const performance = CaptionItemsBuilder_1.CaptionItemsBuilder.create()
+        .append({
+        index: 0,
+        key: '*CPU 使用率*',
+        value: '45%',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 1,
+        key: '*内存使用*',
+        value: '2.5GB / 8GB',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 2,
+        key: '*磁盘使用*',
+        value: '120GB / 500GB',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 3,
+        key: '*运行时间*',
+        value: '15天 3小时',
+        hasKey: true,
+        hasValue: true,
+    })
+        .sort()
+        .toString();
+    const taskStats = CaptionItemsBuilder_1.CaptionItemsBuilder.create()
+        .append({
+        index: 0,
+        key: '*总任务数*',
+        value: '150',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 1,
+        key: '*已完成*',
+        value: '145 (96.7%)',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 2,
+        key: '*进行中*',
+        value: '3',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 3,
+        key: '*待处理*',
+        value: '2',
+        hasKey: true,
+        hasValue: true,
+    })
+        .sort()
+        .toString();
+    const fullReport = `📊 *系统状态报告*\n\n` + `🏗️ *项目信息*\n${projectInfo}\n\n` + `⚡ *性能指标*\n${performance}\n\n` + `📋 *任务统计*\n${taskStats}\n\n` + `✅ 系统运行正常`;
+    const options = MessageOptionsBuilder_1.MessageOptionsBuilder.create()
+        .parseMode(ParseMode_1.ParseMode.MARKDOWN)
+        .disableWebPagePreview()
+        .setInlineKeyboard([
+        [
+            { text: '📈 详细报告', callback_data: 'detailed_report' },
+            { text: '🔄 刷新数据', callback_data: 'refresh_data' },
+        ],
+        [
+            { text: '⚙️ 系统设置', callback_data: 'settings' },
+            { text: '📊 历史数据', callback_data: 'history' },
+        ],
+    ])
+        .getOptions();
+    await sender.text(fullReport).option(options).send('ResearchBot');
+    console.log('✅ Example 12: Status report sent');
+}
+async function example13_KeyValuePairs() {
+    const sender = typedi_1.Container.get(TelegramSender_1.TelegramSender);
+    await sender.parseMode(ParseMode_1.ParseMode.HTML).bold('用户信息 User Information:').newLine(2).keyValue('姓名 Name', 'John Doe').keyValue('年龄 Age', '30').keyValue('邮箱 Email', 'john@example.com').keyValue('电话 Phone', '+1234567890').keyValue('地址 Address', 'California, USA').newLine().separator('─', 40).newLine().keyValue('注册日期 Registered', '2024-01-01').keyValue('最后登录 Last Login', '2024-01-20 10:30').send('ResearchBot');
+    console.log('✅ Example 13: Key-value pairs sent');
+}
+async function example14_CombiningBuilders() {
+    const sender = typedi_1.Container.get(TelegramSender_1.TelegramSender);
+    const header = CaptionItemsBuilder_1.CaptionItemsBuilder.create()
+        .append({
+        index: 0,
+        key: '*通知类型*',
+        value: '系统更新',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 1,
+        key: '*优先级*',
+        value: '🔴 高',
+        hasKey: true,
+        hasValue: true,
+    })
+        .sort()
+        .toString();
+    const details = CaptionItemsBuilder_1.CaptionItemsBuilder.create()
+        .append({
+        index: 0,
+        key: '*更新内容*',
+        value: '新增功能模块',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 1,
+        key: '*更新时间*',
+        value: '2024-01-20 15:00',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 2,
+        key: '*影响范围*',
+        value: '全部用户',
+        hasKey: true,
+        hasValue: true,
+    })
+        .sort()
+        .toString();
+    const options = MessageOptionsBuilder_1.MessageOptionsBuilder.create()
+        .parseMode(ParseMode_1.ParseMode.MARKDOWN)
+        .disableNotification(false)
+        .protectContent()
+        .setInlineKeyboard([
+        [
+            { text: '✅ 已知晓', callback_data: 'acknowledged' },
+            { text: '📖 查看详情', callback_data: 'view_more' },
+        ],
+    ])
+        .getOptions();
+    const message = `${header}\n\n📝 *详细信息*\n${details}\n\n请及时查看更新内容。`;
+    await sender.text(message).option(options).send('ResearchBot');
+    console.log('✅ Example 14: Combined builders sent');
+}
+async function example15_ConditionalFormatting() {
+    const sender = typedi_1.Container.get(TelegramSender_1.TelegramSender);
+    const status = 'success';
+    const percentage = 96.5;
+    const statusInfo = CaptionItemsBuilder_1.CaptionItemsBuilder.create()
+        .append({
+        index: 0,
+        key: '*状态*',
+        value: status === 'success' ? '✅ 成功' : status === 'warning' ? '⚠️ 警告' : '❌ 错误',
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 1,
+        key: '*完成度*',
+        value: `${percentage}%`,
+        hasKey: true,
+        hasValue: true,
+    })
+        .append({
+        index: 2,
+        key: '*评级*',
+        value: percentage >= 90 ? '⭐⭐⭐⭐⭐' : percentage >= 70 ? '⭐⭐⭐⭐' : '⭐⭐⭐',
+        hasKey: true,
+        hasValue: true,
+    })
+        .sort()
+        .toString();
+    const options = MessageOptionsBuilder_1.MessageOptionsBuilder.create()
+        .parseMode(ParseMode_1.ParseMode.MARKDOWN)
+        .disableNotification(status === 'success')
+        .getOptions();
+    await sender.text(statusInfo).option(options).send('ResearchBot');
+    console.log('✅ Example 15: Conditional formatting sent');
+}
+function example16_MediaGroupFromPaths() {
+    const imagePaths = ['/path/to/sunset1.jpg', '/path/to/sunset2.jpg', '/path/to/sunset3.jpg'];
+    const captions = ['美丽的日出', '中午的阳光', '浪漫的日落'];
+    const items = MediaGroupItemBuilder_1.MediaGroupItemBuilder.fromImagePaths(imagePaths, {
+        captions,
+        parseMode: ParseMode_1.ParseMode.MARKDOWN,
+        hasSpoiler: false,
+    });
+    console.log('✅ Example 16: 构建了', items.length, '个媒体项');
+    console.log('第一个项:', items[0]);
+}
+function example17_MediaGroupChaining() {
+    const imagePaths = ['/path/to/photo1.jpg', '/path/to/photo2.jpg'];
+    const captions = ['照片 1', '照片 2'];
+    const builder = MediaGroupItemBuilder_1.MediaGroupItemBuilder.create()
+        .fromImages(imagePaths, {
+        captions,
+        parseMode: ParseMode_1.ParseMode.MARKDOWN,
+    })
+        .sortByType();
+    const items = builder.build();
+    console.log('✅ Example 17: 构建并排序了', items.length, '个媒体项');
+    console.log(builder.toString());
+}
+function example18_MediaGroupToTelegram() {
+    const imagePaths = ['/path/to/photo1.jpg', '/path/to/photo2.jpg', '/path/to/photo3.jpg'];
+    const items = MediaGroupItemBuilder_1.MediaGroupItemBuilder.fromImagePaths(imagePaths, {
+        captions: ['第一张照片', '第二张照片', '第三张照片'],
+        parseMode: ParseMode_1.ParseMode.MARKDOWN,
+    });
+    const telegramMedia = items;
+    console.log('✅ Example 18: 转换为 Telegram 格式');
+    console.log('Telegram 媒体数组:', JSON.stringify(telegramMedia, null, 2));
+}
+function example19_MediaGroupInstanceConversion() {
+    const builder = MediaGroupItemBuilder_1.MediaGroupItemBuilder.create().fromImages(['/path/to/photo1.jpg', '/path/to/photo2.jpg'], {
+        captions: ['Photo 1', 'Photo 2'],
+        parseMode: ParseMode_1.ParseMode.HTML,
+    });
+    const telegramMedia = builder.build();
+    console.log('✅ Example 19: 实例方法转换');
+    console.log('媒体数量:', telegramMedia.length);
+}
+function example20_MediaGroupMixedTypes() {
+    const builder = MediaGroupItemBuilder_1.MediaGroupItemBuilder.create()
+        .fromImages(['/path/to/photo1.jpg', '/path/to/photo2.jpg'], {
+        captions: ['照片 1', '照片 2'],
+        parseMode: ParseMode_1.ParseMode.MARKDOWN,
+        type: 'photo',
+    })
+        .fromImages(['/path/to/video.mp4'], {
+        captions: ['视频片段'],
+        parseMode: ParseMode_1.ParseMode.MARKDOWN,
+        type: 'video',
+    })
+        .sortByType();
+    console.log('✅ Example 20: 混合媒体类型');
+    console.log(builder.toString());
+}
+function example21_MediaGroupBatchPhotos() {
+    const photosData = [
+        { path: '/path/to/sunrise.jpg', caption: '*日出* - 清晨的第一缕阳光' },
+        { path: '/path/to/noon.jpg', caption: '*正午* - 阳光明媚的时刻' },
+        { path: '/path/to/sunset.jpg', caption: '*日落* - 浪漫的黄昏' },
+        { path: '/path/to/night.jpg', caption: '*夜晚* - 星光璀璨' },
+    ];
+    const imagePaths = photosData.map((photo) => photo.path);
+    const captions = photosData.map((photo) => photo.caption);
+    const items = MediaGroupItemBuilder_1.MediaGroupItemBuilder.fromImagePaths(imagePaths, {
+        captions,
+        parseMode: ParseMode_1.ParseMode.MARKDOWN,
+    });
+    console.log('✅ Example 21: 批量创建了', items.length, '张带标题的照片');
+    items.forEach((item, index) => {
+        console.log(`  ${index + 1}. ${item.media} - ${item.caption}`);
+    });
+}
+function example22_MediaGroupCompleteWorkflow() {
+    console.log('\n===== MediaGroupItemBuilder 完整工作流程示例 =====\n');
+    const imagePaths = ['/path/to/project/screenshot1.png', '/path/to/project/screenshot2.png', '/path/to/project/screenshot3.png'];
+    const captions = ['*首页* - 用户登录界面', '*仪表板* - 数据可视化', '*设置* - 系统配置页面'];
+    const builder = MediaGroupItemBuilder_1.MediaGroupItemBuilder.create().fromImages(imagePaths, {
+        captions,
+        parseMode: ParseMode_1.ParseMode.MARKDOWN,
+        hasSpoiler: false,
+    });
+    const validation = builder.validate();
+    if (!validation.isValid) {
+        console.error('验证失败:', validation.errors);
+        return;
+    }
+    console.log('✅ 验证通过');
+    const telegramMedia = builder.build();
+    console.log('📤 已转换为 Telegram 格式，共', telegramMedia.length, '项');
+    console.log('\n📋 媒体组详情:');
+    console.log(builder.toString());
+    console.log('\n✅ 完整工作流程完成！');
+}
+function example23_MediaGroupWithSpoiler() {
+    const imagePaths = ['/path/to/spoiler1.jpg', '/path/to/spoiler2.jpg', '/path/to/spoiler3.jpg'];
+    const items = MediaGroupItemBuilder_1.MediaGroupItemBuilder.fromImagePaths(imagePaths, {
+        captions: ['剧透图 1', '剧透图 2', '剧透图 3'],
+        parseMode: ParseMode_1.ParseMode.MARKDOWN,
+        hasSpoiler: true,
+    });
+    console.log('✅ Example 23: 带 Spoiler 标记的媒体');
+    items.forEach((item, index) => {
+        console.log(`  ${index + 1}. ${item.media} - Spoiler: ${item.has_spoiler}`);
+    });
+}
+function example24_MediaGroupDynamicBuilding() {
+    const builder = MediaGroupItemBuilder_1.MediaGroupItemBuilder.create();
+    const photoFiles = [
+        { path: '/photos/photo1.jpg', caption: '照片 1' },
+        { path: '/photos/photo2.jpg', caption: '照片 2' },
+    ];
+    const videoFiles = [{ path: '/videos/video1.mp4', caption: '视频 1' }];
+    if (photoFiles.length > 0) {
+        const photoPaths = photoFiles.map((f) => f.path);
+        const photoCaptions = photoFiles.map((f) => f.caption);
+        builder.fromImages(photoPaths, {
+            captions: photoCaptions,
+            type: 'photo',
+            parseMode: ParseMode_1.ParseMode.MARKDOWN,
+        });
+    }
+    if (videoFiles.length > 0) {
+        const videoPaths = videoFiles.map((f) => f.path);
+        const videoCaptions = videoFiles.map((f) => f.caption);
+        builder.fromImages(videoPaths, {
+            captions: videoCaptions,
+            type: 'video',
+            parseMode: ParseMode_1.ParseMode.MARKDOWN,
+        });
+    }
+    builder.sortByType();
+    const validation = builder.validate();
+    console.log('✅ Example 24: 动态构建媒体组');
+    console.log('媒体数量:', builder.size());
+    console.log('验证结果:', validation.isValid ? '通过' : '失败');
+    console.log(builder.toString());
+}
+exports.MessageExamples = {
+    example1_BasicTextMessage,
+    example2_RichTextFormatting,
+    example3_CodeBlocks,
+    example4_CaptionItemsBuilder,
+    example5_MessageOptionsBuilder,
+    example6_InlineKeyboard,
+    example7_SinglePhoto,
+    example8_PhotoGroup,
+    example9_MediaGroupItemBuilder,
+    example10_ReplyToMessage,
+    example11_SendToMultipleBots,
+    example12_StatusReport,
+    example13_KeyValuePairs,
+    example14_CombiningBuilders,
+    example15_ConditionalFormatting,
+    example16_MediaGroupFromPaths,
+    example17_MediaGroupChaining,
+    example18_MediaGroupToTelegram,
+    example19_MediaGroupInstanceConversion,
+    example20_MediaGroupMixedTypes,
+    example21_MediaGroupBatchPhotos,
+    example22_MediaGroupCompleteWorkflow,
+    example23_MediaGroupWithSpoiler,
+    example24_MediaGroupDynamicBuilding,
+};
+async function runAllExamples() {
+    console.log('🚀 开始运行 Telegram 消息示例...\n');
+    const examples = [
+        { name: '基础文本消息', fn: example1_BasicTextMessage },
+        { name: '富文本格式化', fn: example2_RichTextFormatting },
+        { name: '代码块', fn: example3_CodeBlocks },
+        { name: 'CaptionItemsBuilder', fn: example4_CaptionItemsBuilder },
+        { name: 'MessageOptionsBuilder', fn: example5_MessageOptionsBuilder },
+        { name: '内联键盘', fn: example6_InlineKeyboard },
+        { name: '单张图片', fn: example7_SinglePhoto },
+        { name: '图片组', fn: example8_PhotoGroup },
+        { name: 'MediaGroupItemBuilder', fn: example9_MediaGroupItemBuilder },
+        { name: '回复消息', fn: example10_ReplyToMessage },
+        { name: '多 Bot 发送', fn: example11_SendToMultipleBots },
+        { name: '状态报告', fn: example12_StatusReport },
+        { name: '键值对', fn: example13_KeyValuePairs },
+        { name: '组合 Builders', fn: example14_CombiningBuilders },
+        { name: '条件格式化', fn: example15_ConditionalFormatting },
+        { name: 'MediaGroup - 从路径构建', fn: example16_MediaGroupFromPaths },
+        { name: 'MediaGroup - 链式调用', fn: example17_MediaGroupChaining },
+        { name: 'MediaGroup - Telegram 格式', fn: example18_MediaGroupToTelegram },
+        { name: 'MediaGroup - 实例转换', fn: example19_MediaGroupInstanceConversion },
+        { name: 'MediaGroup - 混合类型', fn: example20_MediaGroupMixedTypes },
+        { name: 'MediaGroup - 批量照片', fn: example21_MediaGroupBatchPhotos },
+        { name: 'MediaGroup - 完整流程', fn: example22_MediaGroupCompleteWorkflow },
+        { name: 'MediaGroup - Spoiler', fn: example23_MediaGroupWithSpoiler },
+        { name: 'MediaGroup - 动态构建', fn: example24_MediaGroupDynamicBuilding },
+    ];
+    for (const example of examples) {
+        try {
+            console.log(`\n📝 运行示例: ${example.name}...`);
+            example.fn();
+        }
+        catch (error) {
+            console.error(`❌ 示例 ${example.name} 失败:`, error);
+        }
+    }
+    console.log('\n✅ 所有示例运行完成！');
+}
+if (require.main === module) {
+    runAllExamples().catch((error) => {
+        console.error('运行示例时发生错误:', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=MessageExamples.js.map