@mks2508/telegram-message-builder 0.2.0 → 0.3.1

package/dist/index.js

@@ -13,6 +13,435 @@ const DEFAULT_PREFIX = "Hello";
 */
 const DEFAULT_SUFFIX = "!";
 
+//#endregion
+//#region src/formatters/markdown.ts
+/**
+* @fileoverview Markdown (Legacy) Formatters
+* @description Text formatting functions for Telegram's legacy Markdown parse mode
+* @module telegram-message-builder/formatters
+*
+* @see {@link https://core.telegram.org/bots/api#formatting-options | Telegram Bot API - Formatting Options}
+*/
+/**
+* Formats text as bold in Markdown
+*
+* @param text - The text to format
+* @returns Bold formatted text
+* @example
+* ```typescript
+* boldMD("Hello") // "*Hello*"
+* ```
+*/
+function boldMD(text) {
+	return `*${text}*`;
+}
+/**
+* Formats text as italic in Markdown
+*
+* @param text - The text to format
+* @returns Italic formatted text
+* @example
+* ```typescript
+* italicMD("Hello") // "_Hello_"
+* ```
+*/
+function italicMD(text) {
+	return `_${text}_`;
+}
+/**
+* Formats text as monospace code in Markdown
+*
+* @param text - The text to format
+* @returns Code formatted text
+* @example
+* ```typescript
+* codeMD("const x = 1") // "`const x = 1`"
+* ```
+*/
+function codeMD(text) {
+	return `\`${text}\``;
+}
+/**
+* Formats text as a code block in Markdown
+*
+* @param text - The code to format
+* @param language - Optional programming language for syntax highlighting
+* @returns Code block formatted text
+* @example
+* ```typescript
+* codeBlockMD("console.log('Hello')") // "```console.log('Hello')```"
+* codeBlockMD("const x = 1", "javascript") // "```javascript\nconst x = 1\n```"
+* ```
+*/
+function codeBlockMD(text, language) {
+	return language ? `${language}\n${text}\n` : `${text}\n`;
+}
+/**
+* Creates a link in Markdown format
+*
+* @param text - The link text
+* @param url - The URL to link to
+* @returns Link formatted text
+* @example
+* ```typescript
+* linkMD("Google", "https://google.com") // "[Google](https://google.com)"
+* ```
+*/
+function linkMD(text, url$1) {
+	return `[${text}](${url$1})`;
+}
+/**
+* Creates a user mention link in Markdown format
+*
+* @param userId - The user's ID
+* @param name - Optional display name
+* @returns Mention formatted text
+* @example
+* ```typescript
+* mentionMD(123456) // "tg://user?id=123456"
+* mentionMD(123456, "John") // "tg://user?id=123456"
+* ```
+*/
+function mentionMD(userId, _name) {
+	return `tg://user?id=${userId}`;
+}
+/**
+* Creates a hashtag link in Markdown format
+*
+* @param tag - The hashtag text (without #)
+* @returns Hashtag formatted text
+* @example
+* ```typescript
+* hashtagMD("test") // "#test"
+* ```
+*/
+function hashtagMD(tag) {
+	return `#${tag}`;
+}
+/**
+* Formats text as underline in Markdown (limited support)
+*
+* Note: Standard Markdown doesn't support underline. This uses HTML which
+* may not work in all Telegram clients.
+*
+* @param text - The text to format
+* @returns Underline formatted text (HTML fallback)
+* @example
+* ```typescript
+* underlineMD("Hello") // "<u>Hello</u>"
+* ```
+*/
+function underlineMD(text) {
+	return `<u>${text}</u>`;
+}
+/**
+* Formats text as strikethrough in Markdown (limited support)
+*
+* Note: Standard Markdown doesn't support strikethrough. This uses HTML which
+* may not work in all Telegram clients.
+*
+* @param text - The text to format
+* @returns Strikethrough formatted text (HTML fallback)
+* @example
+* ```typescript
+* strikethroughMD("Hello") // "<s>Hello</s>"
+* ```
+*/
+function strikethroughMD(text) {
+	return `<s>${text}</s>`;
+}
+/**
+* Formats text as spoiler in Markdown (limited support)
+*
+* Note: Standard Markdown doesn't support spoiler. This uses HTML which
+* may not work in all Telegram clients.
+*
+* @param text - The text to format
+* @returns Spoiler formatted text (HTML fallback)
+* @example
+* ```typescript
+* spoilerMD("Secret") // "<tg-spoiler>Secret</tg-spoiler>"
+* ```
+*/
+function spoilerMD(text) {
+	return `<tg-spoiler>${text}</tg-spoiler>`;
+}
+/**
+* Creates an email link in Markdown format
+*
+* @param email - The email address
+* @returns Email link formatted text
+* @example
+* ```typescript
+* emailMD("test@example.com") // "[test@example.com](mailto:test@example.com)"
+* ```
+*/
+function emailMD(email$1) {
+	return `[${email$1}](mailto:${email$1})`;
+}
+/**
+* Creates a URL link in Markdown format
+*
+* @param url - The URL
+* @returns URL link formatted text
+* @example
+* ```typescript
+* urlMD("https://example.com") // "[https://example.com](https://example.com)"
+* ```
+*/
+function urlMD(url$1) {
+	return `[${url$1}](${url$1})`;
+}
+/**
+* Creates a custom emoji in Markdown format (limited support)
+*
+* Note: Standard Markdown doesn't support custom emoji. This uses HTML which
+* may not work in all Telegram clients.
+*
+* @param emojiId - The custom emoji ID
+* @returns Custom emoji formatted text (HTML fallback)
+* @example
+* ```typescript
+* customEmojiMD("5368324170672642286") // "<tg-emoji emoji-id=\"5368324170672642286\">👻</tg-emoji>"
+* ```
+*/
+function customEmojiMD(emojiId) {
+	return `<tg-emoji emoji-id="${emojiId}">👻</tg-emoji>`;
+}
+/**
+* Raw Markdown string - bypasses any automatic formatting
+*
+* @param markdown - Pre-formatted Markdown string
+* @returns The Markdown string unchanged
+* @example
+* ```typescript
+* rawMD("*Hello*") // "*Hello*"
+* ```
+*/
+function rawMD(markdown) {
+	return markdown;
+}
+
+//#endregion
+//#region src/formatters/markdownv2.ts
+/**
+* @fileoverview MarkdownV2 Formatters
+* @description Text formatting functions for Telegram's MarkdownV2 parse mode
+* @module telegram-message-builder/formatters
+*
+* @see {@link https://core.telegram.org/bots/api#markdownv2-style | Telegram Bot API - MarkdownV2 Style}
+*/
+/**
+* Formats text as bold in MarkdownV2
+*
+* @param text - The text to format
+* @returns Bold formatted text
+* @example
+* ```typescript
+* boldMDv2("Hello") // "*Hello*"
+* ```
+*/
+function boldMDv2(text) {
+	return `*${text}*`;
+}
+/**
+* Formats text as italic in MarkdownV2
+*
+* @param text - The text to format
+* @returns Italic formatted text
+* @example
+* ```typescript
+* italicMDv2("Hello") // "_Hello_"
+* ```
+*/
+function italicMDv2(text) {
+	return `_${text}_`;
+}
+/**
+* Formats text as underline in MarkdownV2
+*
+* @param text - The text to format
+* @returns Underline formatted text
+* @example
+* ```typescript
+* underlineMDv2("Hello") // "__Hello__"
+* ```
+*/
+function underlineMDv2(text) {
+	return `__${text}__`;
+}
+/**
+* Formats text as strikethrough in MarkdownV2
+*
+* @param text - The text to format
+* @returns Strikethrough formatted text
+* @example
+* ```typescript
+* strikethroughMDv2("Hello") // "~Hello~"
+* ```
+*/
+function strikethroughMDv2(text) {
+	return `~${text}~`;
+}
+/**
+* Formats text as spoiler in MarkdownV2
+*
+* @param text - The text to format
+* @returns Spoiler formatted text
+* @example
+* ```typescript
+* spoilerMDv2("Secret") // "||Secret||"
+* ```
+*/
+function spoilerMDv2(text) {
+	return `||${text}||`;
+}
+/**
+* Formats text as monospace code in MarkdownV2
+*
+* @param text - The text to format
+* @returns Code formatted text
+* @example
+* ```typescript
+* codeMDv2("const x = 1") // "`const x = 1`"
+* ```
+*/
+function codeMDv2(text) {
+	return `\`${text}\``;
+}
+/**
+* Formats text as a code block in MarkdownV2
+*
+* @param text - The code to format
+* @param language - Optional programming language for syntax highlighting
+* @returns Code block formatted text
+* @example
+* ```typescript
+* codeBlockMDv2("console.log('Hello')") // "```console.log('Hello')```"
+* codeBlockMDv2("const x = 1", "javascript") // "```javascript\nconst x = 1\n```"
+* ```
+*/
+function codeBlockMDv2(text, language) {
+	return language ? `${language}\n${text}\n` : `${text}\n`;
+}
+/**
+* Creates a link in MarkdownV2 format
+*
+* @param text - The link text
+* @param url - The URL to link to
+* @returns Link formatted text
+* @example
+* ```typescript
+* linkMDv2("Google", "https://google.com") // "[Google](https://google.com)"
+* ```
+*/
+function linkMDv2(text, url$1) {
+	return `[${text}](${url$1})`;
+}
+/**
+* Creates a user mention link in MarkdownV2 format
+*
+* @param userId - The user's ID
+* @param name - Optional display name (ignored in MarkdownV2)
+* @returns Mention formatted text
+* @example
+* ```typescript
+* mentionMDv2(123456) // "[user](tg://user?id=123456)"
+* mentionMDv2(123456, "John") // "[John](tg://user?id=123456)"
+* ```
+*/
+function mentionMDv2(userId, name) {
+	const display = name || `user`;
+	return `[${display}](tg://user?id=${userId})`;
+}
+/**
+* Creates a hashtag link in MarkdownV2 format
+*
+* @param tag - The hashtag text (without #)
+* @returns Hashtag formatted text
+* @example
+* ```typescript
+* hashtagMDv2("test") // "#test"
+* ```
+*/
+function hashtagMDv2(tag) {
+	return `#${tag}`;
+}
+/**
+* Creates an email link in MarkdownV2 format
+*
+* @param email - The email address
+* @returns Email link formatted text
+* @example
+* ```typescript
+* emailMDv2("test@example.com") // "[test@example.com](mailto:test@example.com)"
+* ```
+*/
+function emailMDv2(email$1) {
+	return `[${email$1}](mailto:${email$1})`;
+}
+/**
+* Creates a URL link in MarkdownV2 format
+*
+* @param url - The URL
+* @returns URL link formatted text
+* @example
+* ```typescript
+* urlMDv2("https://example.com") // "[https://example.com](https://example.com)"
+* ```
+*/
+function urlMDv2(url$1) {
+	return `[${url$1}](${url$1})`;
+}
+/**
+* Creates a custom emoji in MarkdownV2 format
+*
+* Note: Custom emoji syntax in MarkdownV2 uses a special format with the emoji
+* ID wrapped in special syntax.
+*
+* @param emojiId - The custom emoji ID
+* @returns Custom emoji formatted text
+* @example
+* ```typescript
+* customEmojiMDv2("5368324170672642286") // "👻 [Custom emoji](tg://emoji?id=5368324170672642286)"
+* ```
+*/
+function customEmojiMDv2(emojiId) {
+	return `[👻](tg://emoji?id=${emojiId})`;
+}
+/**
+* Raw MarkdownV2 string - bypasses any automatic formatting
+*
+* @param markdown - Pre-formatted MarkdownV2 string
+* @returns The MarkdownV2 string unchanged
+* @example
+* ```typescript
+* rawMDv2("*Hello*") // "*Hello*"
+* ```
+*/
+function rawMDv2(markdown) {
+	return markdown;
+}
+/**
+* Pre-escapes text for safe use in MarkdownV2 formatting
+*
+* MarkdownV2 requires careful character escaping. This function escapes
+* all reserved characters for safe use in formatted text.
+*
+* @param text - The text to escape
+* @returns Escaped text safe for MarkdownV2
+* @example
+* ```typescript
+* escapeMDv2("Hello_World") // "Hello\\_World"
+* ```
+*/
+function escapeMDv2(text) {
+	const reserved = "_*[]()~`>#+-=|{}.!";
+	let result = text;
+	for (const char of reserved) result = result.split(char).join(`\\${char}`);
+	return result;
+}
+
 //#endregion
 //#region src/formatters/index.ts
 function escapeHTML(text) {
@@ -49,7 +478,7 @@ function pre(text) {
 	return `<pre>${escapeHTML(text)}</pre>`;
 }
 function codeBlock(text, language) {
-	return language ? `<pre><code class="language-${language}">${escapeHTML(text)}</code></pre>` : `<pre>${escapeHTML(text)}</pre>`;
+	return language ? `<pre><code class="language-${language}">${escapeHTML(text)}</code></pre>` : `<pre><code>${escapeHTML(text)}</code></pre>`;
 }
 function link(text, url$1) {
 	return `<a href="${escapeHTML(url$1)}">${escapeHTML(text)}</a>`;
@@ -70,6 +499,21 @@ function email(email$1) {
 function url(link$1) {
 	return `<a href="${escapeHTML(link$1)}">${escapeHTML(link$1)}</a>`;
 }
+/**
+* Raw HTML string - bypasses escaping for combining pre-formatted content
+*
+* @example
+* ```typescript
+* // Instead of this (which escapes inner tags):
+* fmt.bold(fmt.italic("Text")) // <b>&lt;i&gt;Text&lt;/i&gt;</b>
+*
+* // Use this:
+* fmt.bold(fmt.raw(fmt.italic("Text"))) // <b><i>Text</i></b>
+* ```
+*/
+function raw(html) {
+	return html;
+}
 function escape(text, mode = "html") {
 	switch (mode) {
 		case "html": return escapeHTML(text);
@@ -95,7 +539,37 @@ const fmt = {
 	escape,
 	escapeHTML,
 	escapeMarkdown,
-	escapeMarkdownV2
+	escapeMarkdownV2,
+	raw,
+	boldMD,
+	italicMD,
+	codeMD,
+	codeBlockMD,
+	linkMD,
+	mentionMD,
+	hashtagMD,
+	underlineMD,
+	strikethroughMD,
+	spoilerMD,
+	emailMD,
+	urlMD,
+	customEmojiMD,
+	rawMD,
+	boldMDv2,
+	italicMDv2,
+	underlineMDv2,
+	strikethroughMDv2,
+	spoilerMDv2,
+	codeMDv2,
+	codeBlockMDv2,
+	linkMDv2,
+	mentionMDv2,
+	hashtagMDv2,
+	emailMDv2,
+	urlMDv2,
+	customEmojiMDv2,
+	rawMDv2,
+	escapeMDv2
 };
 
 //#endregion
@@ -330,6 +804,29 @@ var TelegramKeyboardBuilder = class TelegramKeyboardBuilder {
 //#region src/builder/builder.ts
 /**
 * Telegram Message Builder - Fluent API for building formatted Telegram messages
+*
+* Supports all three Telegram parse modes: HTML, Markdown, and MarkdownV2
+*
+* @example
+* ```typescript
+* // HTML mode (default)
+* const msg1 = TelegramMessageBuilder.text()
+*   .title("Welcome")
+*   .line("Status", "Active", { bold: true })
+*   .build();
+*
+* // Markdown mode
+* const msg2 = TelegramMessageBuilder.text()
+*   .setParseMode("markdown")
+*   .title("Welcome")
+*   .build();
+*
+* // MarkdownV2 mode
+* const msg3 = TelegramMessageBuilder.text()
+*   .setParseMode("markdownv2")
+*   .title("Welcome")
+*   .build();
+* ```
 */
 var TelegramMessageBuilder = class TelegramMessageBuilder {
 	parts = [];
@@ -345,25 +842,105 @@ var TelegramMessageBuilder = class TelegramMessageBuilder {
 		this.parseMode = mode;
 		return this;
 	}
+	/**
+	* Formats text as bold based on current parse mode
+	*/
+	bold(text) {
+		switch (this.parseMode) {
+			case "html": return bold(text);
+			case "markdown": return boldMD(text);
+			case "markdownv2": return boldMDv2(text);
+		}
+	}
+	/**
+	* Formats text as italic based on current parse mode
+	*/
+	italic(text) {
+		switch (this.parseMode) {
+			case "html": return italic(text);
+			case "markdown": return italicMD(text);
+			case "markdownv2": return italicMDv2(text);
+		}
+	}
+	/**
+	* Formats text as underline based on current parse mode
+	*/
+	underline(text) {
+		switch (this.parseMode) {
+			case "html": return underline(text);
+			case "markdown": return underlineMD(text);
+			case "markdownv2": return underlineMDv2(text);
+		}
+	}
+	/**
+	* Formats text as code based on current parse mode
+	*/
+	code(text) {
+		switch (this.parseMode) {
+			case "html": return code(text);
+			case "markdown": return codeMD(text);
+			case "markdownv2": return codeMDv2(text);
+		}
+	}
+	/**
+	* Formats text as code block based on current parse mode
+	*/
+	codeBlockFormat(text, language) {
+		switch (this.parseMode) {
+			case "html": return codeBlock(text, language);
+			case "markdown": return codeBlockMD(text, language);
+			case "markdownv2": return codeBlockMDv2(text, language);
+		}
+	}
+	/**
+	* Creates a link based on current parse mode
+	*/
+	linkFormat(text, url$1) {
+		switch (this.parseMode) {
+			case "html": return link(text, url$1);
+			case "markdown": return linkMD(text, url$1);
+			case "markdownv2": return linkMDv2(text, url$1);
+		}
+	}
+	/**
+	* Creates a mention based on current parse mode
+	*/
+	mentionFormat(userId, name) {
+		switch (this.parseMode) {
+			case "html": return mention(userId, name);
+			case "markdown": return mentionMD(userId, name);
+			case "markdownv2": return mentionMDv2(userId, name);
+		}
+	}
+	/**
+	* Creates a hashtag based on current parse mode
+	*/
+	hashtagFormat(tag) {
+		switch (this.parseMode) {
+			case "html": return hashtag(tag);
+			case "markdown": return hashtagMD(tag);
+			case "markdownv2": return hashtagMDv2(tag);
+		}
+	}
 	title(text) {
-		this.parts.push(bold(text));
+		this.parts.push(this.bold(text));
 		return this;
 	}
 	section(text) {
-		this.parts.push(underline(text));
+		this.parts.push(this.underline(text));
 		return this;
 	}
 	line(key, value, opts) {
 		let formattedValue = value;
-		if (opts?.bold) formattedValue = bold(value);
-		else if (opts?.italic) formattedValue = italic(value);
-		else if (opts?.code) formattedValue = code(value);
-		else if (opts?.underline) formattedValue = underline(value);
+		if (opts?.bold) formattedValue = this.bold(value);
+		else if (opts?.italic) formattedValue = this.italic(value);
+		else if (opts?.code) formattedValue = this.code(value);
+		else if (opts?.underline) formattedValue = this.underline(value);
 		this.parts.push(`${key}: ${formattedValue}`);
 		return this;
 	}
 	codeBlock(text, language) {
-		this.parts.push(codeBlock(text, language));
+		this.parts.push(this.codeBlockFormat(text, language));
 		return this;
 	}
 	listItem(text) {
@@ -383,15 +960,15 @@ var TelegramMessageBuilder = class TelegramMessageBuilder {
 		return this;
 	}
 	link(text, url$1) {
-		this.parts.push(link(text, url$1));
+		this.parts.push(this.linkFormat(text, url$1));
 		return this;
 	}
 	mention(userId, name) {
-		this.parts.push(mention(userId, name));
+		this.parts.push(this.mentionFormat(userId, name));
 		return this;
 	}
 	hashtag(tag) {
-		this.parts.push(hashtag(tag));
+		this.parts.push(this.hashtagFormat(tag));
 		return this;
 	}
 	build() {
@@ -418,5 +995,437 @@ var TelegramMessageBuilder = class TelegramMessageBuilder {
 };
 
 //#endregion
-export { DEFAULT_PREFIX, DEFAULT_SUFFIX, TelegramKeyboardBuilder, TelegramMessageBuilder, bold, code, codeBlock, customEmoji, email, escape, escapeHTML, escapeMarkdown, escapeMarkdownV2, fmt, hashtag, italic, link, mention, pre, spoiler, strikethrough, underline, url };
+//#region src/builder/media.ts
+/**
+* Telegram Media Builder - Fluent API for building media messages
+*
+* Provides a type-safe, fluent interface for constructing media messages
+* compatible with Telegram Bot API v9.3+.
+*
+* Supports all three Telegram parse modes (HTML, Markdown, MarkdownV2) for caption formatting.
+*
+* @example
+* ```typescript
+* // Simple photo with caption
+* const photo = TelegramMediaBuilder.photo("photo.jpg")
+*   .caption("My photo")
+*   .build();
+*
+* // Video with caption and options
+* const video = TelegramMediaBuilder.video("video.mp4")
+*   .caption("My video")
+*   .duration(120)
+*   .thumbnail("thumb.jpg")
+*   .setParseMode("markdown")
+*   .build();
+*
+* // Document with custom options
+* const doc = TelegramMediaBuilder.document("report.pdf")
+*   .caption("Q4 Report")
+*   .fileName("q4_2024.pdf")
+*   .mimeType("application/pdf")
+*   .build();
+* ```
+*/
+var TelegramMediaBuilder = class {
+	source;
+	mediaType;
+	_caption;
+	parseMode = "html";
+	options = {};
+	constructor(source, mediaType) {
+		this.source = source;
+		this.mediaType = mediaType;
+	}
+	/**
+	* Create a photo message builder
+	*
+	* @param source - File ID, URL, Buffer, or file path
+	* @returns Photo media builder with thumbnail() method
+	*
+	* @example
+	* ```typescript
+	* const photo = TelegramMediaBuilder.photo("https://example.com/photo.jpg")
+	*   .caption("Beautiful sunset")
+	*   .thumbnail("thumb.jpg")
+	*   .build();
+	* ```
+	*/
+	static photo(source) {
+		return new PhotoBuilder(source, "photo");
+	}
+	/**
+	* Create a video message builder
+	*
+	* @param source - File ID, URL, Buffer, or file path
+	* @returns Video media builder with duration(), width(), height(), thumbnail(), enableStreaming() methods
+	*
+	* @example
+	* ```typescript
+	* const video = TelegramMediaBuilder.video("video.mp4")
+	*   .caption("My video")
+	*   .duration(120)
+	*   .width(1920)
+	*   .height(1080)
+	*   .build();
+	* ```
+	*/
+	static video(source) {
+		return new VideoBuilder(source, "video");
+	}
+	/**
+	* Create a document message builder
+	*
+	* @param source - File ID, URL, Buffer, or file path
+	* @returns Document media builder with thumbnail(), fileName(), mimeType(), disableContentTypeDetection() methods
+	*
+	* @example
+	* ```typescript
+	* const doc = TelegramMediaBuilder.document("report.pdf")
+	*   .caption("Q4 Report")
+	*   .fileName("q4_2024.pdf")
+	*   .mimeType("application/pdf")
+	*   .build();
+	* ```
+	*/
+	static document(source) {
+		return new DocumentBuilder(source, "document");
+	}
+	/**
+	* Create an audio message builder
+	*
+	* @param source - File ID, URL, Buffer, or file path
+	* @returns Audio media builder with duration(), performer(), title(), thumbnail() methods
+	*
+	* @example
+	* ```typescript
+	* const audio = TelegramMediaBuilder.audio("song.mp3")
+	*   .caption("My favorite song")
+	*   .duration(180)
+	*   .performer("Artist Name")
+	*   .title("Song Title")
+	*   .build();
+	* ```
+	*/
+	static audio(source) {
+		return new AudioBuilder(source, "audio");
+	}
+	/**
+	* Create a voice message builder
+	*
+	* @param source - File ID, URL, Buffer, or file path
+	* @returns Voice media builder with duration() method
+	*
+	* @example
+	* ```typescript
+	* const voice = TelegramMediaBuilder.voice("voice.ogg")
+	*   .caption("Listen to this")
+	*   .duration(30)
+	*   .build();
+	* ```
+	*/
+	static voice(source) {
+		return new VoiceBuilder(source, "voice");
+	}
+	/**
+	* Set caption for the media
+	*
+	* @param text - Caption text (0-1024 characters)
+	* @returns This builder for chaining
+	*/
+	caption(text) {
+		this._caption = text;
+		return this;
+	}
+	/**
+	* Set parse mode for caption formatting
+	*
+	* @param mode - Parse mode (html, markdown, or markdownv2)
+	* @returns This builder for chaining
+	*/
+	setParseMode(mode) {
+		this.parseMode = mode;
+		return this;
+	}
+	/**
+	* Set a custom option
+	*
+	* @param key - Option name
+	* @param value - Option value
+	* @returns This builder for chaining
+	*/
+	setOption(key, value) {
+		this.options[key] = value;
+		return this;
+	}
+	/**
+	* Set multiple options at once
+	*
+	* @param opts - Object with options to set
+	* @returns This builder for chaining
+	*/
+	setOptions(opts) {
+		this.options = {
+			...this.options,
+			...opts
+		};
+		return this;
+	}
+	/**
+	* Build the media message object
+	*
+	* @returns Complete media message ready for Telegram Bot API
+	*/
+	build() {
+		const result = {
+			media: this.source,
+			type: this.mediaType
+		};
+		if (this._caption !== void 0) {
+			result.caption = this.formatCaption(this._caption);
+			result.parse_mode = this.parseMode;
+		}
+		Object.assign(result, this.options);
+		return result;
+	}
+	/**
+	* Format caption based on current parse mode
+	*
+	* @param text - Caption text to format
+	* @returns Formatted caption
+	*/
+	formatCaption(text) {
+		switch (this.parseMode) {
+			case "html": return escapeHTML(text);
+			case "markdown": return escapeMarkdown(text);
+			case "markdownv2": return escapeMarkdownV2(text);
+		}
+	}
+};
+/**
+* Photo-specific builder with convenience methods
+*
+* @example
+* ```typescript
+* const photo = TelegramMediaBuilder.photo("photo.jpg")
+*   .caption("My photo")
+*   .thumbnail("thumb.jpg")
+*   .build();
+* ```
+*/
+var PhotoBuilder = class extends TelegramMediaBuilder {
+	/**
+	* Set thumbnail for the photo
+	*
+	* @param thumb - Thumbnail as Buffer or file path
+	* @returns This builder for chaining
+	*/
+	thumbnail(thumb) {
+		this.setOption("thumb", thumb);
+		return this;
+	}
+};
+/**
+* Video-specific builder with convenience methods
+*
+* @example
+* ```typescript
+* const video = TelegramMediaBuilder.video("video.mp4")
+*   .caption("My video")
+*   .duration(120)
+*   .width(1920)
+*   .height(1080)
+*   .thumbnail("thumb.jpg")
+*   .enableStreaming()
+*   .build();
+* ```
+*/
+var VideoBuilder = class extends TelegramMediaBuilder {
+	/**
+	* Set video duration
+	*
+	* @param seconds - Duration in seconds
+	* @returns This builder for chaining
+	*/
+	duration(seconds) {
+		this.setOption("duration", seconds);
+		return this;
+	}
+	/**
+	* Set video width
+	*
+	* @param px - Width in pixels
+	* @returns This builder for chaining
+	*/
+	width(px) {
+		this.setOption("width", px);
+		return this;
+	}
+	/**
+	* Set video height
+	*
+	* @param px - Height in pixels
+	* @returns This builder for chaining
+	*/
+	height(px) {
+		this.setOption("height", px);
+		return this;
+	}
+	/**
+	* Set thumbnail for the video
+	*
+	* @param thumb - Thumbnail as Buffer or file path
+	* @returns This builder for chaining
+	*/
+	thumbnail(thumb) {
+		this.setOption("thumb", thumb);
+		return this;
+	}
+	/**
+	* Enable streaming for the video
+	*
+	* @returns This builder for chaining
+	*/
+	enableStreaming() {
+		this.setOption("support_streaming", true);
+		return this;
+	}
+};
+/**
+* Document-specific builder with convenience methods
+*
+* @example
+* ```typescript
+* const doc = TelegramMediaBuilder.document("report.pdf")
+*   .caption("Q4 Report")
+*   .thumbnail("thumb.jpg")
+*   .fileName("q4_2024.pdf")
+*   .mimeType("application/pdf")
+*   .disableContentTypeDetection()
+*   .build();
+* ```
+*/
+var DocumentBuilder = class extends TelegramMediaBuilder {
+	/**
+	* Set thumbnail for the document
+	*
+	* @param thumb - Thumbnail as Buffer or file path
+	* @returns This builder for chaining
+	*/
+	thumbnail(thumb) {
+		this.setOption("thumb", thumb);
+		return this;
+	}
+	/**
+	* Set original filename
+	*
+	* @param name - File name
+	* @returns This builder for chaining
+	*/
+	fileName(name) {
+		this.setOption("file_name", name);
+		return this;
+	}
+	/**
+	* Set MIME type
+	*
+	* @param type - MIME type string
+	* @returns This builder for chaining
+	*/
+	mimeType(type) {
+		this.setOption("mime_type", type);
+		return this;
+	}
+	/**
+	* Disable automatic file type detection
+	*
+	* @returns This builder for chaining
+	*/
+	disableContentTypeDetection() {
+		this.setOption("disable_content_type_detection", true);
+		return this;
+	}
+};
+/**
+* Audio-specific builder with convenience methods
+*
+* @example
+* ```typescript
+* const audio = TelegramMediaBuilder.audio("song.mp3")
+*   .caption("My favorite song")
+*   .duration(180)
+*   .performer("Artist Name")
+*   .title("Song Title")
+*   .thumbnail("album_art.jpg")
+*   .build();
+* ```
+*/
+var AudioBuilder = class extends TelegramMediaBuilder {
+	/**
+	* Set audio duration
+	*
+	* @param seconds - Duration in seconds
+	* @returns This builder for chaining
+	*/
+	duration(seconds) {
+		this.setOption("duration", seconds);
+		return this;
+	}
+	/**
+	* Set performer name
+	*
+	* @param name - Performer name
+	* @returns This builder for chaining
+	*/
+	performer(name) {
+		this.setOption("performer", name);
+		return this;
+	}
+	/**
+	* Set track title
+	*
+	* @param name - Track title
+	* @returns This builder for chaining
+	*/
+	title(name) {
+		this.setOption("title", name);
+		return this;
+	}
+	/**
+	* Set thumbnail (album cover)
+	*
+	* @param thumb - Thumbnail as Buffer or file path
+	* @returns This builder for chaining
+	*/
+	thumbnail(thumb) {
+		this.setOption("thumb", thumb);
+		return this;
+	}
+};
+/**
+* Voice-specific builder with convenience methods
+*
+* @example
+* ```typescript
+* const voice = TelegramMediaBuilder.voice("voice.ogg")
+*   .caption("Listen to this")
+*   .duration(30)
+*   .build();
+* ```
+*/
+var VoiceBuilder = class extends TelegramMediaBuilder {
+	/**
+	* Set voice duration
+	*
+	* @param seconds - Duration in seconds
+	* @returns This builder for chaining
+	*/
+	duration(seconds) {
+		this.setOption("duration", seconds);
+		return this;
+	}
+};
+
+//#endregion
+export { AudioBuilder, DEFAULT_PREFIX, DEFAULT_SUFFIX, DocumentBuilder, PhotoBuilder, TelegramKeyboardBuilder, TelegramMediaBuilder, TelegramMessageBuilder, VideoBuilder, VoiceBuilder, bold, boldMD, boldMDv2, code, codeBlock, codeBlockMD, codeBlockMDv2, codeMD, codeMDv2, customEmoji, customEmojiMD, customEmojiMDv2, email, emailMD, emailMDv2, escape, escapeHTML, escapeMDv2, escapeMarkdown, escapeMarkdownV2, fmt, hashtag, hashtagMD, hashtagMDv2, italic, italicMD, italicMDv2, link, linkMD, linkMDv2, mention, mentionMD, mentionMDv2, pre, raw, rawMD, rawMDv2, spoiler, spoilerMD, spoilerMDv2, strikethrough, strikethroughMD, strikethroughMDv2, underline, underlineMD, underlineMDv2, url, urlMD, urlMDv2 };
 //# sourceMappingURL=index.js.map