buncord-transcript 1.0.0

package/tests/test_gen.ts

@@ -0,0 +1,192 @@
+
+import { createTranscript, type Message, type ChannelInfo } from '../src/index';
+
+const channel: ChannelInfo = {
+    id: '123456789',
+    name: 'ticket-001',
+    topic: 'Support ticket for User #123',
+    guildName: 'Support Server',
+    guildIconUrl: 'https://cdn.discordapp.com/icons/887462826343510046/c9066666879e69c4fae958155bb3a8f9.png'
+};
+
+const messages: Message[] = [
+    {
+        id: '1',
+        content: 'Hello, I need help with my account.',
+        author: {
+            id: 'user1',
+            username: 'Customer',
+            avatarURL: 'https://cdn.discordapp.com/embed/avatars/0.png',
+            bot: false
+        },
+        timestamp: new Date(Date.now() - 1000000).toISOString(),
+        attachments: [],
+        embeds: [],
+        reactions: []
+    },
+    {
+        id: '2',
+        content: 'Hi! **Support Bot** here. What seems to be the issue?',
+        author: {
+            id: 'bot1',
+            username: 'Support Bot',
+            avatarURL: 'https://cdn.discordapp.com/embed/avatars/1.png',
+            bot: true
+        },
+        timestamp: new Date(Date.now() - 900000).toISOString(),
+        attachments: [],
+        embeds: [],
+        reactions: []
+    },
+    {
+        id: '3',
+        content: 'I cannot login. Here is a screenshot:',
+        author: {
+            id: 'user1',
+            username: 'Customer',
+            avatarURL: 'https://cdn.discordapp.com/embed/avatars/0.png',
+            bot: false
+        },
+        timestamp: new Date(Date.now() - 800000).toISOString(),
+        attachments: [
+            {
+                id: 'att1',
+                name: 'screenshot.png',
+                url: 'https://via.placeholder.com/350x150',
+                contentType: 'image/png'
+            }
+        ],
+        embeds: [],
+        reactions: []
+    },
+    {
+        id: '4',
+        content: '',
+        author: {
+            id: 'bot1',
+            username: 'Support Bot',
+            avatarURL: 'https://cdn.discordapp.com/embed/avatars/1.png',
+            bot: true
+        },
+        timestamp: new Date(Date.now() - 600000).toISOString(),
+        attachments: [],
+        embeds: [
+            {
+                title: 'Login Troubleshooting',
+                description: 'Please try the following steps:\n1. Reset password\n2. Clear cache',
+                color: 0x5865F2,
+                fields: [
+                    { name: 'Step 1', value: 'Click [here](https://example.com) to reset.', inline: true },
+                    { name: 'Step 2', value: 'Settings > Privacy > Clear', inline: true }
+                ],
+                footer: {
+                    text: 'Automated Response'
+                }
+            }
+        ],
+        reactions: []
+    },
+    {
+        id: '5',
+        content: 'This message uses the new **Container** component:',
+        author: {
+            id: 'bot1',
+            username: 'Support Bot',
+            avatarURL: 'https://cdn.discordapp.com/embed/avatars/1.png',
+            bot: true
+        },
+        timestamp: new Date().toISOString(),
+        attachments: [],
+        embeds: [],
+        containers: [
+            {
+                content: "**Container Title**\nThis is content inside a container.\nIt has a different style than embeds."
+            }
+        ],
+        reactions: []
+    },
+    {
+        id: '6',
+        content: 'This message has interactive **components**:',
+        author: {
+            id: 'bot1',
+            username: 'Support Bot',
+            avatarURL: 'https://cdn.discordapp.com/embed/avatars/1.png',
+            bot: true
+        },
+        timestamp: new Date().toISOString(),
+        attachments: [],
+        embeds: [],
+        components: [
+            {
+                type: 1,
+                components: [
+                    { type: 2, style: 1, label: 'Claim Ticket', customId: 'claim', emoji: { name: 'User', id: '123456789' } },
+                    { type: 2, style: 4, label: 'Close Ticket', customId: 'close', emoji: { name: '🔒' } }
+                ]
+            },
+            {
+                type: 1,
+                components: [
+                    { 
+                        type: 3, 
+                        customId: 'category', 
+                        placeholder: 'Select a category...', 
+                        options: [
+                            { label: 'Support', value: 'support' },
+                            { label: 'Billing', value: 'billing' }
+                        ]
+                    }
+                ]
+            }
+        ],
+        mediaGalleries: [
+            {
+                items: [
+                    { media: { url: 'https://cdn.discordapp.com/embed/avatars/0.png' }, description: 'Gallery Image 1' },
+                    { media: { url: 'https://cdn.discordapp.com/embed/avatars/1.png' }, description: 'Gallery Image 2' },
+                    { media: { url: 'https://cdn.discordapp.com/embed/avatars/2.png' }, description: 'Gallery Image 3' }
+                ]
+            }
+        ],
+        separators: [
+            { divider: true, spacing: 3 }
+        ],
+        reactions: []
+    },
+    {
+        id: '7',
+        content: 'This message uses V2 Components (Type 17 Container):',
+        author: {
+            id: 'bot1',
+            username: 'Support Bot',
+            avatarURL: 'https://cdn.discordapp.com/embed/avatars/1.png',
+            bot: true
+        },
+        timestamp: new Date().toISOString(),
+        attachments: [],
+        embeds: [],
+        components: [
+            {
+                type: 17,
+                components: [
+                    { type: 10, content: '**Text Display** inside container.' },
+                    { type: 14, divider: true, spacing: 2 },
+                    { 
+                        type: 1, 
+                        components: [
+                            { type: 2, style: 1, label: 'Button Inside', customId: 'btn_in' }
+                        ] 
+                    }
+                ]
+            }
+        ] as any, // Cast to avoid strict type checking in test file if types aren't fully updated in index export yet
+        reactions: []
+    }
+];
+
+// Run
+const htmlBuffer = await createTranscript(messages, channel, { returnType: 'buffer' });
+const fs = require('fs');
+fs.writeFileSync('test_transcript.html', htmlBuffer);
+console.log('Transcript generated at test_transcript.html');

package/tests/test_mentions.ts

@@ -0,0 +1,78 @@
+
+import { createTranscript, type Message, type ChannelInfo } from '../src/index';
+import fs from 'fs';
+
+const channel: ChannelInfo = {
+    id: '123456789',
+    name: 'mention-test',
+    topic: 'Testing mentions and timestamps',
+};
+
+const messages: Message[] = [
+    {
+        id: '1',
+        content: 'Hi <@22222>, I am <@11111>!',
+        author: {
+            id: '11111',
+            username: 'Customer',
+            avatarURL: 'https://cdn.discordapp.com/embed/avatars/0.png',
+            bot: false
+        },
+        timestamp: new Date().toISOString(),
+        attachments: [],
+        embeds: [],
+        reactions: []
+    },
+    {
+        id: '2',
+        content: 'Hello <@11111>! This ticket was claimed at <t:1737800000:R>. Mentioning unknown: <@99999>',
+        author: {
+            id: '22222',
+            username: 'Support Bot',
+            avatarURL: 'https://cdn.discordapp.com/embed/avatars/1.png',
+            bot: true
+        },
+        timestamp: new Date().toISOString(),
+        attachments: [],
+        embeds: [
+            {
+                description: 'Embed mentioning <@11111> and timestamp <t:1737801000:R>',
+                fields: [
+                    { name: 'User', value: '<@11111>', inline: true }
+                ]
+            }
+        ],
+        reactions: []
+    }
+];
+
+// Run
+const html = await createTranscript(messages, channel, { returnType: 'string' }) as string;
+fs.writeFileSync('test_mentions.html', html);
+console.log('Transcript generated at test_mentions.html');
+
+// Simple verification in console
+if (html.includes('@Customer')) {
+    console.log('✅ Mention @Customer found');
+} else {
+    console.log('❌ Mention @Customer NOT found');
+}
+
+if (html.includes('@Support Bot')) {
+    console.log('✅ Mention @Support Bot found');
+} else {
+    console.log('❌ Mention @Support Bot NOT found');
+}
+
+if (html.includes('relative time')) {
+    console.log('❌ "relative time" found (should be formatted)');
+} else {
+    console.log('✅ "relative time" NOT found');
+}
+
+if (html.includes('@User')) {
+    // Falls back to @User if id not in map?
+    // In my code: const username = userMap?.get(id) || 'User';
+    // So <@99999> becomes @User
+    console.log('✅ Mention @User (fallback) found');
+}

package/tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "compilerOptions": {
+    // Environment setup & latest features
+    "lib": ["ESNext"],
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleDetection": "force",
+    "jsx": "react-jsx",
+    "allowJs": true,
+
+    // Bundler mode
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false
+  }
+}