dcsv.js 1.0.0 → 1.1.0

package/README.md

@@ -11,6 +11,7 @@ dcsv.js is a lightweight, raw-performance focused Discord library designed for m
 
 - **Stackless Architecture**: Zero caching. 100% control.
 - **Auto-Sharding**: Built-in, zero-config sharding. Just set `shards: 'auto'`.
+- **Container UI**: 💎 **Exclusive:** Built-in helper for beautiful, professional "Container" style layouts (Ansi-enhanced).
 - **Memory Efficient**: Runs 20,000+ server bots on <500MB RAM.
 - **Raw Events**: Listen to any Discord event directly.
 - **Interaction Focused**: Optimized for Slash Commands and Buttons.
@@ -93,6 +94,82 @@ dcsv.js emits standard Discord event names as per [Discord API Docs](https://dis
 - `VOICE_STATE_UPDATE`
 - ...and all others!
 
+## 🍳 Cookbook / Recipes
+
+Since **dcsv.js** is stackless, you rely on the **Discord API** for data. Here are common patterns:
+
+### 1. Fetching User Banner
+We don't cache users. To get a banner, fetch the user profile dynamically.
+
+```javascript
+// GET /users/{id}
+const user = await client.request('GET', `/users/${userId}`);
+
+if (user.banner) {
+    const ext = user.banner.startsWith('a_') ? 'gif' : 'png';
+    const url = `https://cdn.discordapp.com/banners/${user.id}/${user.banner}.${ext}?size=1024`;
+    console.log(url);
+}
+```
+
+### 2. Fetching Server Details
+Need member counts? Ask the API.
+
+```javascript
+// GET /guilds/{id}?with_counts=true
+const guild = await client.request('GET', `/guilds/${guildId}?with_counts=true`);
+
+console.log(`Server: ${guild.name}`);
+console.log(`Members: ${guild.approximate_member_count}`);
+console.log(`Online: ${guild.approximate_presence_count}`);
+```
+
+### 3. Sending an Embed
+We support standard Discord Embed objects.
+
+```javascript
+await client.createMessage(channelId, {
+    content: "Here is your info:",
+    embeds: [{
+        title: "Hello World",
+        color: 0x00FF00, // Hex Color
+        description: "This is a stackless embed.",
+        fields: [
+            { name: "Field 1", value: "Value 1", inline: true }
+        ]
+    }]
+});
+```
+
+### 4. Handling Buttons (Interactions)
+```javascript
+client.on('interactionCreate', async (interaction) => {
+    if (interaction.isButton()) {
+        if (interaction.customId === 'click_me') {
+            await interaction.reply({ 
+                content: "You clicked the button!", 
+                flags: 64 // Ephemeral (Hidden)
+            });
+        }
+    }
+});
+```
+
+### 5. ✨ Exclusive: Create Container Message
+Build professional, modern UIs instantly.
+
+```javascript
+await client.createContainer(channelId, {
+    title: "SERVER STATUS",
+    color: 0x5865F2, // Blurple
+    sections: [
+        { title: "Performance", content: " [32mStable [0m" },
+        { title: "Uptime", content: " [34m99.9% [0m", inline: true }
+    ],
+    footer: "Powered by dcsv.js"
+});
+```
+
 ## 🤝 Contributing
 Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
 

package/examples/advanced.js

@@ -0,0 +1,82 @@
+const { Client, GatewayIntentBits } = require('../index');
+
+// 1. Setup Client
+const client = new Client({
+    intents: GatewayIntentBits.Guilds | GatewayIntentBits.GuildMessages | GatewayIntentBits.MessageContent | GatewayIntentBits.GuildMembers,
+    shards: 'auto',
+    debug: true
+});
+
+client.on('ready', () => {
+    console.log(`logged in as ${client.user.username}`);
+});
+
+client.on('messageCreate', async (msg) => {
+    if (msg.author.bot) return;
+
+    // EXAMPLE 1: Fetching User Banner (Stackless)
+    // Since we don't cache users, we fetch fresh data from API
+    if (msg.content === '!banner') {
+        try {
+            // Raw API Call: GET /users/{id}
+            const user = await client.request('GET', `/users/${msg.author.id}`);
+
+            if (user.banner) {
+                // Construct CDN URL
+                const extension = user.banner.startsWith('a_') ? 'gif' : 'png';
+                const url = `https://cdn.discordapp.com/banners/${user.id}/${user.banner}.${extension}?size=512`;
+
+                await client.createMessage(msg.channel_id, {
+                    content: `Here is your banner: ${url}`
+                });
+            } else {
+                await client.createMessage(msg.channel_id, { content: 'You have no banner set.' });
+            }
+        } catch (err) {
+            console.error(err);
+        }
+    }
+
+    // EXAMPLE 2: Fetching Server Details (Stackless)
+    if (msg.content === '!serverinfo') {
+        try {
+            // We can use the helper client.getGuild() or raw request
+            // with_counts=true key to get exact member counts
+            const guild = await client.request('GET', `/guilds/${msg.guild_id}?with_counts=true`);
+
+            const embed = {
+                title: guild.name,
+                description: guild.description || 'No description',
+                fields: [
+                    { name: 'Owner ID', value: guild.owner_id, inline: true },
+                    { name: 'Members', value: String(guild.approximate_member_count), inline: true },
+                    { name: 'Boosts', value: String(guild.premium_subscription_count), inline: true }
+                ],
+                thumbnail: {
+                    url: guild.icon ? `https://cdn.discordapp.com/icons/${guild.id}/${guild.icon}.png` : null
+                }
+            };
+
+            await client.createMessage(msg.channel_id, { embeds: [embed] });
+        } catch (err) {
+            console.error(err);
+        }
+    }
+});
+
+// EXAMPLE 3: Handling Raw Events (e.g., specific reaction add)
+client.on('MESSAGE_REACTION_ADD', async (event) => {
+    // event contains { user_id, channel_id, message_id, emoji ... }
+    console.log(`User ${event.user_id} reacted with ${event.emoji.name}`);
+
+    // We can interact immediately without fetching the message object!
+    if (event.emoji.name === '⭐') {
+        await client.createMessage(event.channel_id, {
+            content: `<@${event.user_id}> you starred a message!`
+        });
+    }
+});
+
+
+//client.login('TOKEN');
+console.log("Edit this file and add your token to test!");

package/index.js

@@ -370,6 +370,44 @@ class Client extends EventEmitter {
         this.emit('raw', { event, data, shardId: shard.id });
     }
 
+    /**
+     * DCSV Exclusive: Create a "Container" style message
+     * Auto-formats a modern Discord UI using native Embeds
+     * @param {string} channelId 
+     * @param {Object} options { title, color, sections: [{ title, content, inline }] }
+     */
+    async createContainer(channelId, options) {
+        const embed = {
+            title: options.title,
+            color: options.color || 0x2f3136, // Standard Dark
+            description: options.description || null,
+            fields: [],
+            footer: options.footer ? { text: options.footer } : null,
+            timestamp: options.timestamp ? new Date().toISOString() : null
+        };
+
+        if (options.sections) {
+            for (const section of options.sections) {
+                // Add separator if needed
+                if (embed.fields.length > 0) {
+                    embed.fields.push({ name: '\u200b', value: '\u200b', inline: false });
+                }
+
+                embed.fields.push({
+                    name: section.title.toUpperCase(),
+                    value: `\`\`\`ansi\n${section.content}\n\`\`\``,
+                    inline: section.inline || false
+                });
+            }
+        }
+
+        return this.createMessage(channelId, {
+            content: options.content || null,
+            embeds: [embed],
+            components: options.components || []
+        });
+    }
+
     async request(method, endpoint, body = null, retries = 0) {
         await this.rateLimiter.wait(endpoint);
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dcsv.js",
-  "version": "1.0.0",
-  "description": "Ultra High Performance, Stackless Discord Interaction Library. Optimized for low memory usage and high scale.",
+  "version": "1.1.0",
+  "description": "Ultra High Performance, Stackless Discord Library + Container UI System",
   "main": "index.js",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
@@ -27,4 +27,4 @@
     "type": "git",
     "url": "https://github.com/dcsv-project/dcsv.js"
   }
-}
+}