buncord-transcript 1.0.0

package/.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Luigi Colantuono
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,49 @@
+# Buncord-Transcript
+
+<div align="center">
+  <img src="https://github.com/user-attachments/assets/70e8758e-f363-478a-a013-fd46ca3cf3ec" alt="Buncord Logo" width="180"/>
+  <p><b>The fastest, lightest, and most faithful Discord HTML transcript generator.</b></p>
+  <p><i>Built exclusively for the Bun ecosystem.</i></p>
+</div>
+
+---
+
+Stop simulating browsers to generate simple text logs. **Buncord-Transcript** purges the bloat of JSDOM and React, replacing them with a high-performance, string-based rendering engine powered by Bun and a specialized fork of Mustache.
+
+## ⚡ Blazingly Fast
+
+*   **Zero Node Dependencies**: No `ws`, no `http` legacy, no `JSDOM`. Pure Bun-native execution.
+*   **Mustache Powered**: Generates complex transcripts in milliseconds using optimized string templates instead of heavy, recursive DOM manipulation.
+*   **Zero Memory Overhead**: While other libraries require hundreds of MBs to "render" a virtual DOM, Buncord processes messages through a stream-like logic that keeps your RAM footprint invisible.
+
+## 🎨 Absolute Cinema UI
+
+*   **Discord v2 Native**: First-class support for modern components: **Buttons**, **Select Menus**, and the new **Containers**.
+*   **1:1 Visual Fidelity**: Unlike libraries with hardcoded styles, Buncord uses a dynamic CSS variable system mirrored directly from the official Discord client.
+*   **Media-First**: Native support for **Multi-image Media Galleries**, high-res avatars, and custom emoji rendering.
+*   **Smart Mentions**: Intelligently resolves user mentions and relative timestamps within the transcript context.
+
+## 📦 Installation
+
+```bash
+bun add github:LuigiColantuono/buncord-transcript
+```
+
+## 🚀 Quick Start
+
+```typescript
+import { createTranscript } from 'buncord-transcript';
+
+const messages = [...]; // Your Discord.js / Buncord messages
+const channel = { name: 'ticket-001' };
+
+const html = await createTranscript(messages, channel);
+// Output is a high-performance HTML buffer/string ready to be served or saved.
+```
+
+## 🛠️ The Philosophy
+
+Built out of frustration with outdated, bloated libraries that fail to render modern Discord components. Buncord-Transcript is a **"Performance Tier 1"** tool for developers who prioritize speed, code purity, and production stability.
+
+---
+> This project was created using `bun init` in bun v1.3.6. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.

package/bun.lock

@@ -0,0 +1,31 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "buncord-transcript",
+      "dependencies": {
+        "mustache": "luigicolantuono/mustache",
+      },
+      "devDependencies": {
+        "@types/bun": "latest",
+      },
+      "peerDependencies": {
+        "typescript": "^5",
+      },
+    },
+  },
+  "packages": {
+    "@types/bun": ["@types/bun@1.3.6", "", { "dependencies": { "bun-types": "1.3.6" } }, "sha512-uWCv6FO/8LcpREhenN1d1b6fcspAB+cefwD7uti8C8VffIv0Um08TKMn98FynpTiU38+y2dUO55T11NgDt8VAA=="],
+
+    "@types/node": ["@types/node@25.0.10", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-zWW5KPngR/yvakJgGOmZ5vTBemDoSqF3AcV/LrO5u5wTWyEAVVh+IT39G4gtyAkh3CtTZs8aX/yRM82OfzHJRg=="],
+
+    "bun-types": ["bun-types@1.3.6", "", { "dependencies": { "@types/node": "*" } }, "sha512-OlFwHcnNV99r//9v5IIOgQ9Uk37gZqrNMCcqEaExdkVq3Avwqok1bJFmvGMCkCE0FqzdY8VMOZpfpR3lwI+CsQ=="],
+
+    "mustache": ["mustache@github:luigicolantuono/mustache#9a14e96", { "bin": { "mustache": "./bin/mustache" } }, "LuigiColantuono-mustache-9a14e96"],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
+  }
+}

package/index.ts

@@ -0,0 +1 @@
+console.log("Hello via Bun!");

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "buncord-transcript",
+  "version": "1.0.0",
+  "description": "A high-performance Discord transcript generator built for Bun.",
+  "module": "src/index.ts",
+  "main": "src/index.ts",
+  "type": "module",
+  "author": {
+    "name": "Luigi Colantuono",
+    "url": "https://github.com/LuigiColantuono"
+  },
+  "homepage": "https://github.com/LuigiColantuono",
+  "license": "MIT",
+  "funding": {
+    "type": "individual",
+    "url": "https://paypal.me/l0g4n7"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LuigiColantuono/Buncord-Transcript.git"
+  },
+  "keywords": [
+    "discord",
+    "transcript",
+    "bun",
+    "html",
+    "generator"
+  ],
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "5.9.3"
+  },
+  "dependencies": {
+    "mustache": "github:LuigiColantuono/mustache"
+  }
+}

package/src/generator.ts

@@ -0,0 +1,245 @@
+import mustache from 'mustache/mustache.js';
+import { htmlTemplate, css } from './template';
+import type { Message, TranscriptOptions, ChannelInfo, Embed, Button, SelectMenu, AnyComponent, ContainerComponent, TextDisplayComponent, SeparatorComponent, ActionRow } from './types';
+// Helper to format Date
+function formatDate(dateString: string): string {
+    const date = new Date(dateString);
+    return date.toLocaleString('en-US', {
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        hour12: true
+    });
+}
+// Simple Markdown Formatter (Zero-dependency)
+function formatContent(content: string, userMap?: Map<string, string>): string {
+    if (!content) return '';
+    let html = content
+        // Escape HTML
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        
+        // Headers (must be at start of line or after newline)
+        .replace(/^### (.*$)/gm, '<h3>$1</h3>')
+        .replace(/^## (.*$)/gm, '<h2>$1</h2>')
+        .replace(/^# (.*$)/gm, '<h1>$1</h1>')
+        
+        // Code Blocks (multiline)
+        .replace(/```(\w+)?\n([\s\S]*?)```/g, '<pre><code class="language-$1">$2</code></pre>')
+        // Code Blocks (simple)
+        .replace(/```([\s\S]*?)```/g, '<pre><code>$1</code></pre>')
+        
+        // Inline Code
+        .replace(/`([^`]+)`/g, '<code>$1</code>')
+        
+        // Links [text](url)
+        .replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2" target="_blank">$1</a>')
+        // Bold
+        .replace(/\*\*([^*]+)\*\*/g, '<b>$1</b>')
+        
+        // Italic
+        .replace(/\*([^*]+)\*/g, '<i>$1</i>')
+        .replace(/_([^_]+)_/g, '<i>$1</i>')
+        
+        // Underline
+        .replace(/__([^_]+)__/g, '<u>$1</u>')
+        
+        // Strikethrough
+        .replace(/~~([^~]+)~~/g, '<s>$1</s>')
+        
+        // Newlines
+        .replace(/\n/g, '<br>');
+    // Mentions (User) <@123456>
+    html = html.replace(/&lt;@!?(\d+)&gt;/g, (match, id) => {
+        const username = userMap?.get(id) || 'User';
+        return `<span class="mention">@${username}</span>`;
+    });
+    // Mentions (Channel) <#123456>
+    html = html.replace(/&lt;#(\d+)&gt;/g, '<span class="mention">#channel</span>');
+    // Mentions (Role) <@&123456>
+    html = html.replace(/&lt;@&(\d+)&gt;/g, '<span class="mention">@role</span>');
+    // Timestamps <t:123456:R>
+    html = html.replace(/&lt;t:(\d+):?([A-Z])?&gt;/g, (match, timestamp, style) => {
+        const date = new Date(parseInt(timestamp) * 1000);
+        return `<span class="timestamp">${date.toLocaleString()}</span>`;
+    });
+    return html;
+}
+// Helper to render V2 Components to HTML string
+function renderComponent(component: AnyComponent, userMap?: Map<string, string>): string {
+    if (component.type === 17) { // Container
+        const container = component as ContainerComponent;
+        const children = container.components.map(c => renderComponent(c, userMap)).join('');
+        return children;
+    }
+    if (component.type === 10) { // Text Display
+        const text = component as TextDisplayComponent;
+        const content = formatContent(text.content, userMap);
+        return `<div class="discord-section"><div class="discord-section-content">${content}</div></div>`;
+    }
+    if (component.type === 14) { // Separator
+        const sep = component as SeparatorComponent;
+        const style = sep.divider ? 'height: 1px;' : 'height: 0px;';
+        const margin = sep.spacing === 3 ? 'margin: 8px 0;' : sep.spacing === 2 ? 'margin: 4px 0;' : 'margin: 0;';
+        return `<div class="discord-separator" style="${style} ${margin}"></div>`;
+    }
+    if (component.type === 1) { // Action Row
+        const row = component as ActionRow;
+        const children = row.components.map(c => renderComponent(c, userMap)).join('');
+        return `<div class="message-component-group">${children}</div>`;
+    }
+    if (component.type === 2) { // Button
+        const btn = component as Button;
+        const styleClass = btn.style === 1 ? 'primary' :
+                          btn.style === 2 ? 'secondary' :
+                          btn.style === 3 ? 'success' :
+                          btn.style === 4 ? 'destructive' : 
+                          btn.style === 5 ? 'secondary' : 'primary';
+        
+        let content = '';
+        if (btn.emoji) {
+             if (btn.emoji.id) {
+                 content += `<span style="display: flex; align-items: center;"><img src="https://cdn.discordapp.com/emojis/${btn.emoji.id}.webp?size=44&quality=lossless" alt="${btn.emoji.name}" style="width: 16px; height: 16px; margin-right: 8px;"></span>`;
+             } else if (btn.emoji.name) {
+                 content += `<span style="display: flex; align-items: center; margin-right: 8px;">${btn.emoji.name}</span>`;
+             }
+        }
+        if (btn.label) {
+            content += `<span style="display: flex; align-items: center;">${btn.label}</span>`;
+        }
+        if (btn.style === 5) {
+             content += `<span style="margin-left: 8px; display: flex; align-items: center;"><svg role="img" xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 24 24"><path fill="currentColor" d="M15 2a1 1 0 0 1 1-1h6a1 1 0 0 1 1 1v6a1 1 0 1 1-2 0V4.41l-4.3 4.3a1 1 0 1 1-1.4-1.42L19.58 3H16a1 1 0 0 1-1-1Z"/><path fill="currentColor" d="M5 2a3 3 0 0 0-3 3v14a3 3 0 0 0 3 3h14a3 3 0 0 0 3-3v-6a1 1 0 1 0-2 0v6a1 1 0 0 1-1 1H5a1 1 0 0 1-1-1V5a1 1 0 0 1 1-1h6a1 1 0 1 0 0-2H5Z"/></svg></span>`;
+        }
+        const disabledAttr = btn.disabled ? 'disabled' : '';
+        if (btn.style === 5 && btn.url) {
+             return `<a class="discord-button discord-button-secondary" href="${btn.url}" target="_blank" ${disabledAttr}>${content}</a>`;
+        }
+        return `<button class="discord-button discord-button-${styleClass}" type="button" ${disabledAttr}>${content}</button>`;
+    }
+    
+    if (component.type === 3 || component.type === 5 || component.type === 6 || component.type === 7 || component.type === 8) {
+        const menu = component as SelectMenu;
+        return `<div class="discord-select-menu">
+            <div style="overflow: hidden; text-overflow: ellipsis; white-space: nowrap;">${menu.placeholder || 'Select...'}</div>
+            <div style="display: flex; align-items: center; margin-left: 8px;">
+                <svg width="24" height="24" viewBox="0 0 24 24"><path fill="currentColor" d="M7 10L12 15L17 10H7Z" /></svg>
+            </div>
+        </div>`;
+    }
+    return '';
+}
+export async function generateTranscript(messages: Message[], channel: ChannelInfo, options: TranscriptOptions = {}) {
+    // Build user map
+    const userMap = new Map<string, string>();
+    for (const msg of messages) {
+        if (msg.author && msg.author.id && msg.author.username) {
+            userMap.set(msg.author.id, msg.author.username);
+        }
+        // Also check replyTo author
+        if (msg.replyTo?.author?.id && msg.replyTo?.author?.username) {
+            userMap.set(msg.replyTo.author.id, msg.replyTo.author.username);
+        }
+    }
+
+    const processedMessages = messages.map(msg => {
+        return {
+            ...msg,
+            timestamp: formatDate(msg.timestamp),
+            content: formatContent(msg.content, userMap),
+            embeds: msg.embeds?.map(embed => ({
+                ...embed,
+                description: embed.description ? formatContent(embed.description, userMap) : undefined,
+                fields: embed.fields?.map(field => ({
+                    ...field,
+                    value: formatContent(field.value, userMap)
+                })),
+                hexColor: embed.color ? '#' + embed.color.toString(16).padStart(6, '0') : undefined,
+            })),
+            containers: [
+                ...(msg.containers?.map(container => ({
+                    ...container,
+                    content: container.content
+                })) || []),
+                ...(msg.components?.filter(c => c.type === 17).map(container => ({
+                    content: renderComponent(container, userMap)
+                })) || [])
+            ],
+            components: [
+                ...(msg.components?.filter(c => c.type === 1).map(c => {
+                    const row = c as ActionRow;
+                    return {
+                        ...row,
+                        components: row.components.map(component => {
+                            if (component.type === 2) {
+                                const btn = component as Button;
+                                return {
+                                    ...btn,
+                                    isButton: true,
+                                    styleClass: btn.style === 1 ? 'primary' :
+                                                btn.style === 2 ? 'secondary' :
+                                                btn.style === 3 ? 'success' :
+                                                btn.style === 4 ? 'destructive' : 
+                                                btn.style === 5 ? 'secondary' : 'primary',
+                                    isLink: btn.style === 5,
+                                    emoji: btn.emoji
+                                };
+                            } else {
+                                return {
+                                    ...component,
+                                    isSelectMenu: true
+                                };
+                            }
+                        })
+                    };
+                }) || []),
+                ...(msg.components?.some(c => c.type !== 1 && c.type !== 17) ? [{
+                    type: 1,
+                    components: msg.components.filter(c => c.type !== 1 && c.type !== 17).map(component => {
+                        if (component.type === 2) {
+                            const btn = component as Button;
+                            return {
+                                ...btn,
+                                isButton: true,
+                                styleClass: btn.style === 1 ? 'primary' :
+                                            btn.style === 2 ? 'secondary' :
+                                            btn.style === 3 ? 'success' :
+                                            btn.style === 4 ? 'destructive' : 
+                                            btn.style === 5 ? 'secondary' : 'primary',
+                                isLink: btn.style === 5,
+                                emoji: btn.emoji
+                            };
+                        } else if (component.type === 3 || component.type === 5 || component.type === 6 || component.type === 7 || component.type === 8) {
+                            return {
+                                ...component,
+                                isSelectMenu: true
+                            };
+                        }
+                        return component;
+                    })
+                }] : [])
+            ],
+            mediaGalleries: msg.mediaGalleries,
+            separators: msg.separators?.map(sep => ({
+                ...sep,
+                isLarge: sep.spacing === 3
+            })),
+            replyTo: msg.replyTo ? {
+                ...msg.replyTo,
+                contentSnippet: msg.replyTo.content.substring(0, 50) + (msg.replyTo.content.length > 50 ? '...' : '')
+            } : undefined
+        };
+    });
+    const view = {
+        channel,
+        messages: processedMessages,
+        css
+    };
+    const output = (mustache as any).render(htmlTemplate, view);
+    if (options.returnType === 'buffer') {
+        return Buffer.from(output);
+    }
+    return output;
+}

package/src/index.ts

@@ -0,0 +1,6 @@
+
+import { generateTranscript } from './generator';
+export * from './types';
+
+// Facade for the user
+export const createTranscript = generateTranscript;

package/src/mustache.d.ts

@@ -0,0 +1,8 @@
+declare module 'mustache/mustache.js' {
+    export interface MustacheStatic {
+        render(template: string, view: any, partials?: any, tags?: any): string;
+        escape(text: string): string;
+    }
+    const mustache: MustacheStatic;
+    export default mustache;
+}