@erinjs/core 1.0.0

package/core/apps/docs/src/data/changelog.ts

@@ -0,0 +1,717 @@
+export interface ChangelogSection {
+  title: string;
+  items: string[];
+}
+
+export interface ChangelogEntry {
+  version: string;
+  date: string;
+  sections: ChangelogSection[];
+}
+
+export const changelogEntries: ChangelogEntry[] = [
+  {
+    version: '1.2.4',
+    date: '2026-03-19',
+    sections: [
+      {
+        title: '@erinjs/core — waitForGuilds fix',
+        items: [
+          'Fixed waitForGuilds: true — Ready event now receives populated client.guilds when the gateway sends READY with an empty guilds array and guilds via GUILD_CREATE; SDK defers Ready by 500ms so guild stream settles before emitting',
+        ],
+      },
+      {
+        title: '@erinjs/core — GuildMember.move()',
+        items: ['GuildMember.move(channelId) — move members between voice channels (#27)'],
+      },
+      {
+        title: '@erinjs/ws — Reconnect fixes',
+        items: [
+          'Close socket before reconnecting on invalid session (#25)',
+          'Add gateway close code 4013 (AckBackpressure) as reconnectable (#24)',
+        ],
+      },
+    ],
+  },
+  {
+    version: '1.2.3',
+    date: '2026-02-23',
+    sections: [
+      {
+        title: '@erinjs/core — Message.reply() fix',
+        items: [
+          'Fixed message.reply() not creating actual replies — SDK now sends message_reference (not referenced_message) in the request body per Discord/Fluxer API spec',
+          'Added !replytest command to ping-bot example for verification',
+          'Added structure tests (Message, User, GuildMember, Guild, Invite) including regression test for reply payload',
+        ],
+      },
+    ],
+  },
+  {
+    version: '1.2.2',
+    date: '2026-02-22',
+    sections: [
+      {
+        title: '@erinjs/voice — LiveKit inbound receive',
+        items: [
+          'LiveKit inbound audio receive APIs for participant subscriptions, audioFrame events, and speaking lifecycle events',
+          'VoiceManager helpers for channel participant subscriptions',
+          'Docs/examples for transcription-oriented usage',
+          'Fixed broken voice changes due to packing',
+        ],
+      },
+      {
+        title: '@erinjs/voice — ESM fix',
+        items: [
+          'Fixed "Dynamic require of path is not supported" when using @erinjs/voice in ESM projects',
+          'node-webcodecs is now loaded via dynamic import and externalized from the bundle',
+        ],
+      },
+      {
+        title: '@erinjs/core — Message.channel.send() & Channel.canSendMessage()',
+        items: [
+          'Message.channel — now typed as (TextChannel | DMChannel | GuildChannel) | null so message.channel.send() works (messages only exist in text-based channels)',
+          'Channel.canSendMessage() — returns true for DMs; for guild channels checks ViewChannel and SendMessages via guild.members.me permissions',
+          'GuildChannel.send() — added for guild channels that support messages (e.g. announcement channels); TextChannel and DMChannel already had send',
+        ],
+      },
+      {
+        title: '@erinjs/core — Ready & guilds',
+        items: [
+          'ClientOptions.waitForGuilds — when true, delays the Ready event until all guilds from READY (including unavailable stubs) have been received via GUILD_CREATE; opt-in for bots that need full guild cache before handling Ready',
+          'New guide: Wait for All Guilds',
+        ],
+      },
+      {
+        title: '@erinjs/core — Channel type guards',
+        items: [
+          'BREAKING: isSendable() renamed to isTextBased() — migrate callers to isTextBased()',
+          'Added isLink(), isDM(), isVoice() type guards on Channel',
+          'LinkChannel.url is now a required field',
+          'Refactored Message.send() and reply() for testability; added check for empty messages',
+        ],
+      },
+      {
+        title: 'Build & tooling',
+        items: [
+          'Added vite build artifacts to gitignore',
+          'Modernized vite config (const, modern syntax)',
+        ],
+      },
+      {
+        title: 'Docs & assets',
+        items: ['Docs improvements', 'Updated favicon', 'RAG generation updates'],
+      },
+    ],
+  },
+  {
+    version: '1.2.1',
+    date: '2026-02-21',
+    sections: [
+      {
+        title: 'BREAKING: MessageReaction events',
+        items: [
+          'MessageReactionAdd and MessageReactionRemove now emit (reaction, user) only — messageId, channelId, emoji, and userId are accessible via reaction.messageId, reaction.channelId, reaction.emoji, and user.id',
+          'Handlers that destructured the extra args (messageId, channelId, emoji, userId) will break; migrate to reaction/user properties',
+        ],
+      },
+      {
+        title: 'BREAKING: GuildMember.roles',
+        items: [
+          'member.roles is now GuildMemberRoleManager (was string[]). Migrate: member.roles.includes(roleId) → member.roles.cache.has(roleId); array iteration → member.roles.roleIds',
+          'member.addRole() and member.removeRole() still work; prefer member.roles.add() and member.roles.remove() for Discord.js parity',
+        ],
+      },
+      {
+        title: 'SDK — GuildMemberRoleManager',
+        items: [
+          'member.roles — add(roleOrId), remove(roleOrId), set(roleIds), cache (Collection of Role objects), roleIds, has(roleOrId). Discord.js parity.',
+          'GuildMemberRoleManager and RoleResolvable exported from @erinjs/core',
+        ],
+      },
+      {
+        title: 'SDK — Guild emojis',
+        items: [
+          'guild.emojis — Collection of GuildEmoji (cached after fetch)',
+          'guild.fetchEmojis() — fetch all emojis; cached in guild.emojis',
+          'guild.fetchEmoji(emojiId) — fetch single emoji; throws FluxerError with EmojiNotFound code on 404',
+        ],
+      },
+      {
+        title: 'SDK — Types & resolution',
+        items: [
+          'ChannelManager — return type now includes GuildChannel when fetching a guild channel; client.channels.get(guildChannelId) and fetch() return Channel | GuildChannel',
+          'GatewayReactionEmoji — id is now optional (id?: Snowflake) to match API; default/unicode emoji omit id',
+          '@erinjs/util BitField — BitFieldResolvable now accepts bigint',
+        ],
+      },
+      {
+        title: 'SDK — Error codes',
+        items: ['ErrorCodes.EmojiNotFound — used when fetchEmoji returns 404'],
+      },
+      {
+        title: 'Build & tooling',
+        items: [
+          'tsup configs added for all packages; build scripts simplified',
+          'Runtime dynamic imports removed in favor of compile-time imports — smaller bundle, faster startup (#17)',
+          'Emoji shortcodes generated file — minified format for smaller bundle',
+          'scripts/generate-ai-rag.ts — generate RAG index from docs for AI bot; pnpm run generate:rag',
+        ],
+      },
+      {
+        title: 'Docs site — Discord.js compatibility',
+        items: [
+          '@discordJsCompat JSDoc tag — docgen extracts and surfaces in API docs; classes, methods, properties can show "Discord.js compatible" badge with optional link',
+          'ApiDiscordCompat, GuideDiscordCompat, GuideDiscordCompatCallout — new components for badges and callouts',
+          'ClassPage, MethodsSection, PropertiesSection — green Discord.js compat styling and badges on compatible APIs',
+          'ClassPage — "Class not found in this version" shows link to latest docs when class may exist in newer release',
+        ],
+      },
+      {
+        title: 'Docs — Guides',
+        items: [
+          'New guide: Discord.js Compatibility — overview of member.roles, guild.members.me, client.channels.cache; migration from member.roles.includes() to member.roles.cache.has()',
+          'New guide: Channels — create, edit, delete; permission overwrites; roles; invites; emojis & stickers',
+          'Guides category order — channels category; Roles guide; discordJsCompat badges on relevant sections',
+          'Roles guide — new section "Add/remove roles from members (member.roles)" with Discord.js-style examples',
+          'Channels guide — new "Fetch Emojis" section (guild.fetchEmojis, guild.fetchEmoji, emoji.delete)',
+        ],
+      },
+      {
+        title: 'Examples',
+        items: [
+          'ping-bot — userinfo uses guild-specific avatar (cdnMemberAvatarURL) when member has one; improved embed layout with setAuthor',
+          'reaction-roles-bot — updated to member.roles.cache.has() for role checks',
+        ],
+      },
+      {
+        title: 'Chore',
+        items: ['.gitignore — removed IDE and OS-specific entries', '.env.example — minor cleanup'],
+      },
+    ],
+  },
+  {
+    version: '1.2.0',
+    date: '2026-02-20',
+    sections: [
+      {
+        title: 'Docs site',
+        items: [
+          'Support banner — closable with × button; preference persisted in localStorage',
+          'Guides page — wider content area and improved layout to use more screen space',
+          'Join our erin.js community — prominent callout on homepage, Guides sidebar, Docs sidebar, REST API sidebar, and Footer',
+          'CommunityCallout component with hero and sidebar variants linking to fluxer.gg/fluxer-js',
+        ],
+      },
+      {
+        title: 'SDK — Resolve helpers',
+        items: [
+          'client.channels.resolve(channelId) — get from cache or fetch; replaces common get(id) ?? fetch(id) pattern',
+          'client.guilds.resolve(guildId) — same pattern for guilds',
+          'guild.members.resolve(userId) — resolve member from cache or API',
+          'message.resolveChannel(), message.resolveGuild() — convenience for resolving message context',
+        ],
+      },
+      {
+        title: 'SDK — Cache & options',
+        items: [
+          'ClientOptions.cache — optional size limits (channels, guilds, users); FIFO eviction when exceeded',
+          'ChannelManager, GuildManager, UsersManager — respect cache limits when set; omit or 0 = unbounded',
+          'ClientOptions.suppressIntentWarning — silence warning when intents are set (Fluxer does not support intents yet)',
+        ],
+      },
+      {
+        title: 'SDK — Embeds',
+        items: [
+          'message.send(), message.sendTo(), channel.send(), webhook.send() — embeds accept EmbedBuilder directly; no need to call .toJSON()',
+        ],
+      },
+      {
+        title: 'SDK — Emoji',
+        items: [
+          'Client.resolveEmoji — Unicode emoji no longer double-encoded; fix for message.react() with shortcodes',
+        ],
+      },
+      {
+        title: 'SDK — Events & gateway',
+        items: [
+          'GUILD_CREATE, GUILD_UPDATE — use normalizeGuildPayload for Fluxer/Discord payload compatibility',
+          'GuildBanAdd — correct payload shape for GuildBan constructor',
+        ],
+      },
+      {
+        title: 'SDK — Bug fixes',
+        items: [
+          'guild.channels — now correctly populated when channels arrive via gateway (GUILD_CREATE, READY, CHANNEL_CREATE, CHANNEL_UPDATE) or client.channels.fetch(); previously guild.channels stayed empty while client.channels had them',
+        ],
+      },
+      {
+        title: '@erinjs/collection',
+        items: [
+          'findKey(predicate), some(predicate), every(predicate), partition(predicate)',
+          'clone(), concat(other), last(amount?), tap(fn), toString()',
+        ],
+      },
+      {
+        title: '@erinjs/rest',
+        items: [
+          'FluxerAPIError.isRetryable, HTTPError.isRetryable — true for 429 and 5xx; useful for retry logic',
+        ],
+      },
+    ],
+  },
+  {
+    version: '1.1.9',
+    date: '2026-02-19',
+    sections: [
+      {
+        title: 'SDK — Emoji shortcodes',
+        items: [
+          "Unicode emoji shortcodes now use Discord's official data (anyascii/discord-emojis) instead of emojilib — Fluxer Discord compatibility",
+          'message.react(:arrow_backward:), :flag_ad:, etc. resolve correctly per Discord naming',
+          'Removed emojilib dependency; generate script fetches from GitHub at build time',
+        ],
+      },
+    ],
+  },
+  {
+    version: '1.1.8',
+    date: '2026-02-18',
+    sections: [
+      {
+        title: 'Types',
+        items: ['GatewayMessageDeleteDispatchData — added content?, author_id? (Fluxer payload)'],
+      },
+      {
+        title: 'SDK — Events',
+        items: [
+          'GuildMemberRemove — always emits; builds partial member from payload when not cached (username fallback for Fluxer)',
+          'MessageDelete — PartialMessage now includes content?, authorId? from gateway payload',
+        ],
+      },
+      {
+        title: 'SDK — Reactions',
+        items: [
+          'message.react() — Unicode shortcodes (e.g. :red_square:, :light_blue_heart:) now resolve correctly; no longer misclassified as custom emojis requiring guild context; uses emojilib data (6k+ shortcodes) via getUnicodeFromShortcode',
+        ],
+      },
+      {
+        title: 'SDK — CDN / Avatars',
+        items: [
+          'displayAvatarURL, cdnDisplayAvatarURL, cdnDefaultAvatarURL — default avatars now use fluxerstatic.com (index = userId % 6) per Fluxer API',
+          'STATIC_CDN_URL exported for fluxerstatic.com; CDN_URL remains fluxerusercontent.com',
+        ],
+      },
+      {
+        title: '@erinjs/voice',
+        items: [
+          'LiveKitRtcConnection — setVolume(0-200), getVolume() for playback volume control',
+          'VoiceManager — multi-channel: connections keyed by channel_id; leave(guildId) leaves all channels; leaveChannel(channelId), getConnection(channelOrGuildId)',
+        ],
+      },
+      {
+        title: '@erinjs/ws',
+        items: [
+          'WebSocketManager — retry loop for getDefaultWebSocket() and gateway fetch with exponential backoff (1s → 45s max); no longer crashes when API or gateway is unreachable',
+          'WebSocketShard — max reconnect backoff increased from 30s to 45s; reconnects on additional close codes: 1005, 1006, 1012–1015 (Abnormal Closure, Service Restart, Bad Gateway, etc.)',
+          'destroy() — aborts retry loop when client is destroyed',
+        ],
+      },
+    ],
+  },
+  {
+    version: '1.1.6',
+    date: '2026-02-18',
+    sections: [
+      {
+        title: 'Routes',
+        items: [
+          'instance() — GET /instance',
+          'channelRecipient(channelId, userId) — PUT/DELETE recipients',
+          'channelMessageAttachment(channelId, messageId, attachmentId) — DELETE attachment',
+          'guilds() — POST /guilds',
+          'guildDelete(guildId) — POST guild delete',
+          'guildVanityUrl(guildId) — GET vanity URL',
+          'guildTextChannelFlexibleNames(guildId), guildDetachedBanner(guildId), guildDisallowUnclaimedAccounts(guildId) — PATCH feature toggles',
+          'guildTransferOwnership(guildId) — POST transfer ownership',
+          'guildRolesHoistPositions(guildId) — PATCH/DELETE role hoist positions',
+          'guildEmojisBulk(guildId), guildStickersBulk(guildId) — POST bulk emojis/stickers',
+        ],
+      },
+      {
+        title: 'Types',
+        items: [
+          'APIInstance — response for GET /instance',
+          'APIVanityURL — response for GET vanity-url',
+          'APIGuildFeatureToggle — body for guild feature toggles',
+        ],
+      },
+      {
+        title: 'SDK — Client',
+        items: ['client.fetchInstance() — unauthenticated instance info'],
+      },
+      {
+        title: 'SDK — Channel / GuildChannel',
+        items: [
+          'guildChannel.edit(options) — PATCH channel',
+          'guildChannel.delete(options?) — DELETE channel',
+          'guildChannel.editPermission(overwriteId, options) — PUT permission overwrite',
+          'guildChannel.deletePermission(overwriteId) — DELETE permission overwrite',
+        ],
+      },
+      {
+        title: 'SDK — DMChannel',
+        items: [
+          'dmChannel.addRecipient(userId) — add recipient in group DMs',
+          'dmChannel.removeRecipient(userId, options?) — remove recipient',
+        ],
+      },
+      {
+        title: 'SDK — Message',
+        items: ['message.deleteAttachment(attachmentId) — delete a single attachment'],
+      },
+      {
+        title: 'SDK — GuildManager',
+        items: ['client.guilds.create(options) — create guild'],
+      },
+      {
+        title: 'SDK — Guild',
+        items: [
+          'guild.edit(options) — PATCH guild',
+          'guild.delete() — delete guild',
+          'guild.fetchVanityURL() — fetch vanity URL',
+          'guild.transferOwnership(newOwnerId, password?) — transfer ownership',
+          'guild.setTextChannelFlexibleNames(enabled), guild.setDetachedBanner(enabled), guild.setDisallowUnclaimedAccounts(enabled) — feature toggles',
+          'guild.setRolePositions(updates), guild.setRoleHoistPositions(updates), guild.resetRoleHoistPositions() — reorder roles',
+          'guild.createEmojisBulk(emojis), guild.createStickersBulk(stickers) — bulk create',
+        ],
+      },
+      {
+        title: 'SDK — GuildMemberManager',
+        items: ['guild.members.fetch(options?) — list members with pagination'],
+      },
+      {
+        title: 'SDK — GuildMember',
+        items: ['member.edit(options) — PATCH member (including @me for the bot)'],
+      },
+    ],
+  },
+  {
+    version: '1.1.5',
+    date: '2026-02-18',
+    sections: [
+      {
+        title: 'Gateway events & docs',
+        items: [
+          'GatewayDispatchEvents — documented all 60+ events from fluxer_gateway with JSDoc; new payload types for ChannelUpdateBulk, ChannelRecipientAdd/Remove, ChannelPinsAck, GuildMembersChunk, GuildMemberListUpdate, GuildRoleUpdateBulk, MessageAck, and session/user/call/relationship events',
+          'Guides — proper HTML tables for Gateway Dispatch Events Reference and Event Payload Reference (replacing code blocks); new GuideTable component',
+        ],
+      },
+    ],
+  },
+  {
+    version: '1.1.4',
+    date: '2026-02-18',
+    sections: [
+      {
+        title: 'File attachments by URL',
+        items: [
+          'files option now accepts URL — pass { name, url } to attach files from a URL; SDK fetches automatically (channel.send, message.reply, webhook.send)',
+          '30s fetch timeout; URL validation with URL.canParse()',
+          'New guide: File Attachments by URL',
+        ],
+      },
+      {
+        title: 'Guides',
+        items: ['Guides index — category order and quick links for easier discovery'],
+      },
+    ],
+  },
+  {
+    version: '1.1.3',
+    date: '2026-02-18',
+    sections: [
+      {
+        title: 'Guild members cache',
+        items: [
+          'GUILD_CREATE — cache members from payload when gateway sends them (Discord.js parity; guild.members.me often populated on join)',
+        ],
+      },
+    ],
+  },
+  {
+    version: '1.1.2',
+    date: '2026-02-18',
+    sections: [
+      {
+        title: 'Guild members',
+        items: [
+          'guild.members.me — Discord.js parity: returns the current bot user as a GuildMember in that guild, or null if not cached',
+          "guild.members.fetchMe() — fetch and cache the bot's member when not in cache",
+          'GuildMemberManager — guild.members extends Collection with me getter and fetchMe()',
+        ],
+      },
+    ],
+  },
+  {
+    version: '1.1.0',
+    date: '2026-02-16',
+    sections: [
+      {
+        title: 'BREAKING: Reaction events',
+        items: [
+          'MessageReactionAdd and MessageReactionRemove now emit (reaction, user, messageId, channelId, emoji, userId). Migrate from (reaction, user) or raw data destructuring.',
+          'Handlers expecting message_id, channel_id, user_id from raw data will break. Use reaction.messageId, reaction.channelId, user.id or the new convenience args.',
+        ],
+      },
+      {
+        title: 'New: client.events API',
+        items: [
+          'client.events — typed shorthand for event handlers. client.events.MessageReactionAdd((reaction, user, messageId, channelId, emoji, userId) => {...}).',
+        ],
+      },
+      {
+        title: 'Typing',
+        items: [
+          'MessageSendOptions — shared type for Channel.send, User.send, DMChannel.send, Message.send, Message.reply; embeds accept (APIEmbed | EmbedBuilder)[]',
+          'Webhook.send — embeds typed as (APIEmbed | EmbedBuilder)[]; optional wait param returns Message when true',
+          'ClientEvents — GuildEmojisUpdate, GuildStickersUpdate, and other events now use typed dispatch data',
+          'Gateway dispatch types — GatewayGuildEmojisUpdateDispatchData, GatewayChannelPinsUpdateDispatchData, etc. exported from @erinjs/types',
+          'APIApplicationCommandInteraction — member and user fields typed as APIGuildMember and APIUser',
+          'APIGuildAuditLogEntry changes — old_value/new_value typed; fetchPinnedMessages pinned items typed',
+        ],
+      },
+      {
+        title: 'Webhook & message attachments',
+        items: [
+          'Webhook.send() — files and attachments support; multipart/form-data when files provided',
+          'Channel.send, Message.reply, Message.send, Message.sendTo, client.channels.send — files and attachments support',
+          'MessageSendOptions and WebhookSendOptions — files (Blob/ArrayBuffer/Uint8Array) and attachments metadata',
+          'REST RequestManager — builds FormData from body + files when files present',
+          'EmbedBuilder — JSDoc: embeds can use description-only (no title required)',
+        ],
+      },
+      {
+        title: 'Media & embeds',
+        items: [
+          '@erinjs/util — resolveTenorToImageUrl() — resolve Tenor view URLs to GIF URLs for embed images; returns { url, flags: IS_ANIMATED }; derives GIF from JSON-LD or oEmbed (embeds require GIF, not MP4)',
+          'EmbedBuilder — setImage/setThumbnail accept EmbedMediaOptions with flags (e.g. EmbedMediaFlags.IS_ANIMATED)',
+        ],
+      },
+      {
+        title: 'Profile URLs (avatars, banners)',
+        items: [
+          'User — avatarURL(), displayAvatarURL(), bannerURL(); auto-detects animated avatars (a_ → gif); optional banner from profile/member context',
+          'GuildMember — avatarURL(), displayAvatarURL(), bannerURL() for guild-specific avatars/banners',
+          'Webhook — avatarURL()',
+          'CDN helpers — cdnAvatarURL(), cdnDisplayAvatarURL(), cdnBannerURL(), cdnMemberAvatarURL(), cdnMemberBannerURL(), cdnDefaultAvatarURL() for raw API data',
+          'New guide: Profile URLs — User/Webhook/GuildMember methods and standalone CDN helpers',
+        ],
+      },
+      {
+        title: 'Deprecation warnings',
+        items: [
+          'Runtime deprecation warnings — deprecated APIs (e.g. ChannelManager.fetchMessage, Channel.fetchMessage, Client.fetchMessage) now emit a one-time console.warn when used',
+          'emitDeprecationWarning(symbol, message) — exported from @erinjs/util for SDK use',
+          'FLUXER_SUPPRESS_DEPRECATION=1 — set to silence all deprecation warnings',
+        ],
+      },
+      {
+        title: 'Permissions & guild owner',
+        items: [
+          'Guild owner override — server owner now receives all permissions in member.permissions and member.permissionsIn(channel)',
+          'GuildMember.permissions — guild-level permissions (roles only); GuildMember.permissionsIn(channel) — channel-specific permissions (includes overwrites)',
+          'Fluxer gateway compatibility — READY, GUILD_CREATE, GUILD_UPDATE now correctly parse GuildReadyData (properties.owner_id) so owner_id is available for permission checks',
+          'Guild constructor — supports both owner_id and ownerId; defensive fallback when missing',
+          'New guide: Permissions & Moderation — member.permissions, PermissionFlags, owner override, ban/kick examples',
+        ],
+      },
+      {
+        title: 'SDK missing properties',
+        items: [
+          'Channel — icon, lastPinTimestamp on base; permissionOverwrites on GuildChannel',
+          'DMChannel — ownerId, recipients (User[]), nicks (Group DM support)',
+          'Guild — splash, splashURL(), vanityURLCode, features, verificationLevel, defaultMessageNotifications, explicitContentFilter, afkChannelId, afkTimeout, systemChannelId, rulesChannelId, nsfwLevel, mfaLevel, bannerWidth/Height, splashWidth/Height',
+          'User — avatarColor, flags, system',
+          'Message — webhookId, mentions (User[]), mentionRoles, nonce',
+          'Role — hoistPosition',
+          'Webhook — user (creator)',
+        ],
+      },
+      {
+        title: 'Fluxer API alignment (bot features)',
+        items: [
+          'BREAKING: Guild.ban() — now uses delete_message_days (0–7) instead of delete_message_seconds; added ban_duration_seconds for temporary bans',
+          'Routes — currentUserGuilds(), leaveGuild(guildId)',
+          'ClientUser — fetchGuilds(), leaveGuild(guildId)',
+          'GuildChannel — createInvite(options?), fetchInvites()',
+          'Channel — bulkDeleteMessages(ids), sendTyping()',
+          'Guild — createChannel(data), fetchChannels(), setChannelPositions(updates)',
+          'Message — fetchReactionUsers(emoji, options?)',
+          'GuildBan and APIBan — expires_at for temporary bans',
+        ],
+      },
+      {
+        title: 'Docs',
+        items: [
+          'New guide: Webhook Attachments & Embeds — description-only embeds, file attachments, full examples',
+          'New guides (Media category): Embed Media — images, thumbnails, video, audio; GIFs (Tenor) — send URL as content for gifv, resolveTenorToImageUrl() for Tenor in embeds; File Attachments — files with metadata and flags (spoiler, animated, explicit)',
+          'Embeds guide expanded — full EmbedBuilder reference: title, description, URL, color, author, footer, timestamp, fields, image, thumbnail, video, audio, multiple embeds, EmbedBuilder.from(), limits',
+          'Docgen — getters (channel, guild, displayName) now appear in API docs',
+          'Docgen — AttachmentBuilder.setSpoiler param type fixed; Base class and Client properties documented',
+        ],
+      },
+    ],
+  },
+  {
+    version: '1.0.9',
+    date: '2026-02-15',
+    sections: [
+      {
+        title: 'OpenAPI gap fixes',
+        items: [
+          'Fixed pin/unpin route path — channelPinMessage() uses /channels/{id}/pins/{messageId} (was /messages/pins/...)',
+          'Message.pin() and Message.unpin() — pin or unpin a message',
+          'TextChannel.fetchPinnedMessages() and DMChannel.fetchPinnedMessages() — fetch pinned messages',
+          'Webhook.edit(options) — edit webhook name, avatar, and (with bot auth) channel_id; APIWebhookUpdateRequest and APIWebhookTokenUpdateRequest types',
+          'Guild.fetchAuditLogs(options?) — fetch guild audit logs with limit, before, after, userId, actionType filters',
+        ],
+      },
+      {
+        title: 'Invite metadata',
+        items: ['APIInvite and Invite class — temporary, createdAt, uses, maxUses, maxAge'],
+      },
+      {
+        title: 'Audit log types',
+        items: ['APIGuildAuditLog and APIGuildAuditLogEntry — types for guild audit log responses'],
+      },
+      {
+        title: 'Docs',
+        items: ['Webhooks guide — Editing a Webhook section with token vs bot auth examples'],
+      },
+    ],
+  },
+  {
+    version: '1.0.8',
+    date: '2026-02-15',
+    sections: [
+      {
+        title: 'Discord.js portability',
+        items: [
+          'Message.channel and Message.guild — getters that resolve from cache',
+          'MessageReaction — reaction events emit (reaction, user); use reaction.emoji, reaction.fetchMessage()',
+          'MessageManager — channel.messages.fetch(messageId) for Discord.js-style message access; client.fetchMessage and channel.fetchMessage deprecated',
+          'Role and guild.roles — Role class; guild.roles Collection',
+          'PartialMessage — MessageDelete emits { id, channelId, channel? }',
+          'client.guilds.fetch(guildId) — fetch guilds by ID',
+          'client.channels.cache and client.guilds.cache — Discord.js compatibility alias',
+        ],
+      },
+      {
+        title: 'Role management',
+        items: [
+          'Guild.addRoleToMember(userId, roleId) — assign a role by user ID and role ID without fetching the member',
+          'Guild.removeRoleFromMember(userId, roleId) — remove a role by user ID and role ID',
+          'Guild.resolveRoleId(arg) — resolve role mention (@role), raw snowflake ID, or role name to role ID (fetches guild roles when needed)',
+          'parseRoleMention(arg) in @erinjs/util — extract role ID from <@&id> format',
+        ],
+      },
+      {
+        title: 'Custom emoji resolution',
+        items: [
+          'Message.react(), removeReaction(), removeReactionEmoji() now accept :name:, name:id, <:name:id>, and unicode — custom emojis resolve via guild emoji lookup when message has guild context',
+          'Client.resolveEmoji(emoji, guildId?) — resolve any emoji input to API format for reactions; fetches guild emojis when id is missing',
+          'Extended parseEmoji() — supports :name: (colons), name:id (API format), and <a?:name:id> (mention)',
+        ],
+      },
+      {
+        title: 'Gateway event handlers',
+        items: [
+          'New handlers: MessageDeleteBulk, GuildBanAdd, GuildBanRemove, GuildEmojisUpdate, GuildStickersUpdate, GuildIntegrationsUpdate',
+          'GuildRoleCreate, GuildRoleUpdate, GuildRoleDelete',
+          'GuildScheduledEventCreate, GuildScheduledEventUpdate, GuildScheduledEventDelete',
+          'ChannelPinsUpdate, InviteCreate, InviteDelete',
+          'TypingStart, UserUpdate, PresenceUpdate, WebhooksUpdate, Resumed',
+          'USER_UPDATE patches client.user when the bot updates',
+        ],
+      },
+      {
+        title: 'Architecture',
+        items: [
+          'Event handler registry pattern — handleDispatch uses a Map of handlers instead of a switch; add handlers via eventHandlers.set()',
+          'User caching with getOrCreateUser — Message and GuildMember use client.getOrCreateUser(); User._patch() updates cached users',
+        ],
+      },
+      {
+        title: 'REST package',
+        items: [
+          'Fixed timeout leak — clearTimeout moved to finally block in RequestManager',
+          'Fixed rate limit race — proper mutex handling',
+          'Error chaining with { cause } on retries',
+          'NaN handling in RateLimitManager for malformed Retry-After headers',
+        ],
+      },
+      {
+        title: 'WebSocket package',
+        items: [
+          'Fixed double-reconnect race — scheduleReconnect guarded with reconnectTimeout check',
+          'Explicit reconnect on heartbeat ack timeout',
+          'try/catch around shard.connect() in WebSocketManager',
+          'Unhandled promise catch for connect',
+        ],
+      },
+      {
+        title: 'Voice package',
+        items: [
+          'Null guards for client.user before use',
+          'Buffer bounds check in VoiceConnection setupUDP (msg.length < 70)',
+          'currentStream cleanup in VoiceConnection.destroy()',
+          'Video cleanup race guard in LiveKitRtcConnection',
+          'MP4 track validation (info.tracks) in LiveKitRtcConnection',
+        ],
+      },
+      {
+        title: 'Core package',
+        items: [
+          'Double-login guard — throws FluxerError if already logged in',
+          'Unhandled dispatch promise — .catch() on handleDispatch so rejections emit as errors',
+        ],
+      },
+      {
+        title: 'Builders & util',
+        items: [
+          'EmbedBuilder.setURL() — URL validation with URL.canParse()',
+          'AttachmentBuilder — filename validation in constructor and setName()',
+          'parseEmoji() — null/undefined/empty checks',
+          'SnowflakeUtil.deconstruct — try/catch for BigInt with descriptive error',
+          'BitField — JSDoc for 32-bit limitation',
+        ],
+      },
+      {
+        title: 'Docs site',
+        items: [
+          '404 page and catch-all route for invalid URLs',
+          'Skip link, SearchModal aria-label and focus trap for accessibility',
+          'Changelog section anchors and copy-link buttons',
+          'Breadcrumbs on guide pages',
+          'On this page TOC on class docs (right sidebar)',
+          'Guides grouped by category on index',
+          'Minimal bot example and quick-start in examples README',
+          'robots.txt, sitemap.xml, SEO meta tags',
+        ],
+      },
+      {
+        title: 'Infrastructure & tooling',
+        items: [
+          'ESLint 9 flat config, Prettier, .editorconfig',
+          'Vitest with coverage — tests for collection and util',
+          'GitHub Actions: ci.yml, publish.yml, docs-deploy.yml, codeql.yml, dependabot.yml',
+          'Husky + lint-staged pre-commit hooks',
+          'Changesets for versioning; docs changelog in changelog.ts',
+          'Package metadata: repository, bugs, homepage, keywords, license on all packages',
+          'GitHub templates: bug_report, feature_request, PULL_REQUEST_TEMPLATE, CONTRIBUTING, SECURITY, CODE_OF_CONDUCT',
+        ],
+      },
+    ],
+  },
+];