dcsv.js 1.0.0 → 1.0.1

package/README.md

@@ -93,6 +93,67 @@ 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)
+            });
+        }
+    }
+});
+```
+
 ## 🤝 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dcsv.js",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Ultra High Performance, Stackless Discord Interaction Library. Optimized for low memory usage and high scale.",
   "main": "index.js",
   "scripts": {
@@ -27,4 +27,4 @@
     "type": "git",
     "url": "https://github.com/dcsv-project/dcsv.js"
   }
-}
+}