Patch fix

Author: blstmo

apps/docs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluxerjs/docs",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "private": true,
   "license": "Apache-2.0",
   "type": "module",

apps/docs/public/docs/latest/guides.json

@@ -98,26 +98,32 @@
       },
       {
         "title": "client.channels.resolve() — get channel by ID",
-        "description": "Resolve a channel by ID from cache or API. Use channel.isSendable() before sending. For sending when you only have an ID, prefer client.channels.send() which skips the fetch.",
-        "code": "import { Client } from '@fluxerjs/core';\n\nconst client = new Client({ intents: 0 });\nawait client.login(process.env.FLUXER_BOT_TOKEN);\n\n// Fetch channel (from API if not cached)\nconst channel = await client.channels.resolve(channelId);\nif (channel?.isSendable()) {\n  await channel.send('Hello!');\n}\n// Or for webhooks: if (channel?.createWebhook) { ... }",
+        "description": "Resolve a channel by ID from cache or API. Use channel.canSendMessage() or channel.isTextBased() before sending. For sending when you only have an ID, prefer client.channels.send() which skips the fetch.",
+        "code": "import { Client } from '@fluxerjs/core';\n\nconst client = new Client({ intents: 0 });\nawait client.login(process.env.FLUXER_BOT_TOKEN);\n\n// Fetch channel (from API if not cached)\nconst channel = await client.channels.resolve(channelId);\nif (channel?.canSendMessage()) {\n  await channel.send('Hello!');\n}\n// Or for webhooks: if (channel?.createWebhook) { ... }",
         "language": "javascript"
       },
       {
         "title": "fetch message by id",
         "description": "Use channel.messages.fetch(messageId) when you have the channel. For IDs-only, fetch the channel first.",
-        "code": "// When you have the channel\nconst message = await channel.messages.fetch(messageId);\nif (message) {\n  await message.edit({ content: 'Updated!' });\n  await message.react('👍');\n}\n\n// When you only have IDs (e.g. from sqlite)\nconst ch = await client.channels.resolve(channelId);\nconst msg = await ch?.messages?.fetch(messageId);\nif (msg) await msg.delete();\n\n// When channel is cached\nconst m = client.channels.get(channelId);\nif (m?.isSendable()) {\n  const mes = await m.messages.fetch(messageId);\n  if (mes) await mes.edit({ content: 'Edited!' });\n}\n\n// Refresh a stale message instance\nconst updated = await message.fetch();\nif (updated) console.log(updated.content);",
+        "code": "// When you have the channel\nconst message = await channel.messages.fetch(messageId);\nif (message) {\n  await message.edit({ content: 'Updated!' });\n  await message.react('👍');\n}\n\n// When you only have IDs (e.g. from sqlite)\nconst ch = await client.channels.resolve(channelId);\nconst msg = await ch?.messages?.fetch(messageId);\nif (msg) await msg.delete();\n\n// When channel is cached\nconst m = client.channels.get(channelId);\nif (m?.canSendMessage()) {\n  const mes = await m.messages.fetch(messageId);\n  if (mes) await mes.edit({ content: 'Edited!' });\n}\n\n// Refresh a stale message instance\nconst updated = await message.fetch();\nif (updated) console.log(updated.content);",
         "language": "javascript"
       },
       {
-        "title": "message.channel and message.guild",
-        "description": "Access the channel or guild from a message. Resolved from cache; null if not cached (e.g. DM channel).",
-        "code": "client.on(Events.MessageCreate, async (message) => {\n  const channel = message.channel;   // TextChannel or DMChannel | null\n  const guild = message.guild;       // Guild | null (null for DMs)\n  if (message.channel?.isSendable()) {\n    await message.channel.send('Same channel, different API');\n  }\n});",
+        "title": "message.channel and message.channel.send()",
+        "description": "message.channel returns the channel (from cache); null if not cached. Messages only exist in text-based channels, so when non-null it always has send(). Use message.channel.send() for the same as message.send() but via the channel object.",
+        "code": "client.on(Events.MessageCreate, async (message) => {\n  const channel = message.channel;   // TextChannel | DMChannel | GuildChannel | null\n  const guild = message.guild;       // Guild | null (null for DMs)\n  if (channel) {\n    await channel.send('Same channel, different API');  // or message.send()\n  }\n});",
+        "language": "javascript"
+      },
+      {
+        "title": "channel.canSendMessage() — permission check",
+        "description": "Before sending, use canSendMessage() to check if the bot has ViewChannel and SendMessages. For DMs always true; for guild channels uses guild.members.me permissions.",
+        "code": "const channel = await client.channels.resolve(channelId);\nif (channel?.canSendMessage()) {\n  await channel.send('Hello!');\n}",
         "language": "javascript"
       },
       {
         "title": "Typing indicator",
         "description": "Use channel.sendTyping() before a slow operation so users see \"Bot is typing...\". Lasts ~10 seconds.",
-        "code": "const channel = message.channel ?? (await message.resolveChannel());\nif (channel?.isSendable?.()) {\n  await channel.sendTyping();\n  await slowOperation(); // e.g. fetch external API\n  await message.reply('Done!');\n}",
+        "code": "const channel = message.channel ?? (await message.resolveChannel());\nif (channel?.canSendMessage?.()) {\n  await channel.sendTyping();\n  await slowOperation(); // e.g. fetch external API\n  await message.reply('Done!');\n}",
         "language": "javascript"
       },
       {
@@ -573,6 +579,30 @@
       }
     ]
   },
+  {
+    "id": "wait-for-guilds",
+    "slug": "wait-for-guilds",
+    "title": "Wait for All Guilds",
+    "description": "Delay the Ready event until all guilds have been received. Use when your bot needs the full guild cache before handling Ready.",
+    "category": "events",
+    "sections": [
+      {
+        "title": "Overview",
+        "description": "By default, Ready fires as soon as the gateway sends the READY payload. Some guilds may be sent as unavailable stubs and arrive later via GUILD_CREATE. Enable waitForGuilds if your Ready handler needs every guild to be in client.guilds before proceeding."
+      },
+      {
+        "title": "Usage",
+        "description": "Pass waitForGuilds: true in ClientOptions. Ready will emit only after all guilds from READY (including those marked unavailable) have been received via GUILD_CREATE.",
+        "code": "import { Client, Events } from '@fluxerjs/core';\n\nconst client = new Client({\n  waitForGuilds: true,\n});\n\nclient.on(Events.Ready, () => {\n  // client.guilds now contains every guild — no stubs, all fully loaded\n  console.log(`Bot is in ${client.guilds.size} guilds`);\n  for (const [id, guild] of client.guilds) {\n    console.log(`- ${guild.name} (${guild.channels.size} channels)`);\n  }\n});\n\nawait client.login(process.env.FLUXER_BOT_TOKEN);",
+        "language": "javascript"
+      },
+      {
+        "title": "When to use it",
+        "description": "Use waitForGuilds when your bot iterates over all guilds in Ready (e.g. syncing state, broadcasting announcements, or building in-memory caches). Without it, client.guilds may be incomplete at Ready time.",
+        "tip": "If you only need a few guilds by ID, prefer client.guilds.resolve(guildId) instead — no need to wait for all guilds."
+      }
+    ]
+  },
   {
     "id": "events",
     "slug": "events",
@@ -976,7 +1006,7 @@
       {
         "title": "Channel-specific permissions",
         "description": "member.permissionsIn(channel) applies channel overwrites. Use it when checking if a user can send messages, read history, or connect to voice in a specific channel.",
-        "code": "const channel = message.channel;\nif (channel?.isSendable?.()) {\n  const perms = member.permissionsIn(channel);\n  if (perms.has(PermissionFlags.SendMessages)) {\n    await channel.send('You can send here!');\n  }\n}",
+        "code": "const channel = message.channel;\nif (channel?.canSendMessage?.()) {\n  const perms = member.permissionsIn(channel);\n  if (perms.has(PermissionFlags.SendMessages)) {\n    await channel.send('You can send here!');\n  }\n}",
         "language": "javascript"
       },
       {