Changelog

READY unavailable stubs land in client.guilds with available === false. Full startup / reconnect snapshots emit GuildAvailable, not GuildCreate. Set ClientOptions.emitGuildCreateOnStartup: true to keep the old startup GuildCreate behavior.

Bot REST calls use endpoints.api_public. Hosted defaults keep api / api_client on https://web.fluxer.app/api and api_public on https://api.fluxer.app. Client.fromDiscovery and fetchInstance use unversioned GET {origin}/.well-known/fluxer.

The bit layout exposes sequence instead of increment. processId is always 0 (deprecated alias). Update any code that read increment.

Leave and mute updates send connection_id. Leave without it throws VOICE_MISSING_CONNECTION_ID. Joins send mutation_id; a rejected VOICE_STATE_ACK fails the pending join.

Shards no longer send intents on Identify. properties.e2ee_capable defaults to true; pass e2eeCapable: false to opt out. Identify types no longer include compress or large_threshold.

Files larger than BOT_ATTACHMENT_MAX_BYTES fail before PUT with AttachmentTooLarge / ATTACHMENT_TOO_LARGE.

CdnUrlOptions.size is snapped via snapCdnSize / CDN_SIZE_LADDER and clamped by asset class (icon, banner, emoji, sticker). Arbitrary exact sizes no longer pass through.

If base roles include Administrator, computePermissions returns the full mask and does not apply channel overwrites (owner path unchanged).

The payload has id, channelId, guildId, channel, content, authorId, and author / createdAt when the message was cached. It has fetch() and resolveChannel(). It does not have edit, reply, or react. Use message.partial or Message.resolve(msg) when a handler accepts both Message and PartialMessage.

Cached edits still emit Message. Uncached edits emit PartialMessage. Check message.partial before reading content, author, or calling reply.

If the member was not in cache, you get a PartialGuildMember class (partial: true) with id, guildId, user, and guild. Check member.partial or fetch before using nick, roles, or kick.

The bulk payload still has the channel and ids. messages is the per-id list so you can fetch or inspect cached content without a second lookup.

client.channels.fetch(id) and message.resolveChannel() return Channel with those methods. send is on text-capable channels (guild text, guild voice, DMs). Category and link channels do not have send. You do not need a GuildChannel cast or a raw REST Routes.channel call for the usual case.

When the channel is in cache it is already a text-based structure (including voice), so reply and send type-check. When it is missing, it is null; call message.resolveChannel() then send or delete.

Attachments are MessageAttachment (proxyUrl, contentType). Embeds are MessageEmbed (iconUrl, proxyUrl, htmlWidth). messageReference, invite snapshots, and call.endedAt follow the same rule. Sending still uses EmbedBuilder. If you compared snake_case fields on received messages, update those reads.

They do not duck-type `'send' in this` or `'guildId' in this`. Custom subclasses that faked methods without setting type will fail the guard.

client.cache.sweepMessages((msg) => …) sees createdAt as a Date and the usual Message getters. Internal storage is still the wire object.

Use parentId and rateLimitPerUser (not parent_id / rate_limit_per_user). Same camelCase rule as guild.edit and channel.edit in 2.x.

Was Promise<string> (the token) in older lines. Chain login or ignore the resolved value.

Fluxer does not use Discord-style gateway intents. Omit intents; use ignoredEvents to suppress specific dispatches.

CollectorOptionsRequired. By default awaitMessages / awaitReactions reject on idle (CollectorIdle) and max (CollectorMax). Pass errors: ["time"] when max should resolve successfully.

Use .cache for the reaction collection. Not a bare array or map of wire reaction objects.

Not a raw number. Same bitfield pattern as permissions.

Pass a Buffer or URL plus options.name, then files: [builder] on send / reply / edit.

Metadata is guildSnapshot / channelSnapshot. Call resolveGuild() or resolveChannel() for live structures.

Omit the embeds field to leave existing embeds unchanged.

Prefer structure methods on domain objects. Import @fluxerjs/core/internal only when calling REST with raw camelCase→wire helpers. Pack* serializers are gone with the pack API.

PackManager, PackCreateOptions, PackInvitePayload, and the rest of the pack exports are gone. Use guild emoji/sticker CRUD (createEmoji, cloneEmoji, createSticker). InviteType.EmojiPack and InviteType.StickerPack are also gone; invites are guild or group-DM only.

CompactAttachments is no longer a MessageFlags member. GuildFeature no longer includes MT_MESSAGE_SCHEDULING or MT_EXPRESSION_PACKS. Align flag checks with the current OpenAPI snapshot.

It is no longer APIChannelOverwrite[]. channel.editPermission and channel.deletePermission are gone. Use channel.permissionOverwrites.edit(id, { type, allow, deny }) and .delete(id). Iterate .cache or the manager itself.

Each sticker is a domain object with name, tags, animated, and url. messageSnapshots use the same camelCase wrappers as the parent message.

2.2 emitted ({ oldRole, role }) and ({ role, guildId, roleId }). 3.0 emits (oldRole, role) and (role, guildId, roleId). oldRole / role are null when the role was uncached. GuildRoleCreate is still a single Role.

resolveTenorToImageUrl and related Tenor exports are removed. Use resolveKlipyToImageUrl (and KlipyMediaResult) from @fluxerjs/core or @fluxerjs/util. Fluxer’s unfurler expects Klipy page URLs in message content; see /guides/gifs/.

To match the rest of the cache options, a numeric 0 (and other documented numeric zeros) now means "unbounded / no limit" instead of "off". If you passed cache: { messages: 0 } to turn message caching off, it will now cache every message. Use cache: { messages: false } to disable it.

Internal layout was reorganized (guild/message structures, sdk options modules, util helpers). Paths like @fluxerjs/core/structures/Guild.ts no longer resolve. Import public names from the package root or documented subpaths (@fluxerjs/core, @fluxerjs/core/client, @fluxerjs/core/message, @fluxerjs/core/cluster, @fluxerjs/core/errors).

The leading colon was dropped from the custom-emoji form, and unicode emoji are no longer passed through encodeURIComponent. Update any code that parsed or compared the old :name:id shape.

GuildEmoji.identifier and MessageReaction.emojiIdentifier return a:name:id for animated emoji so they round-trip correctly through the API. Static emoji are unchanged and still return name:id.

Once the reaction request succeeds, the client emits messageReactionAdd with a structured emoji object ({ name, id?, animated? }) instead of putting the raw wire string into emoji.name. Your listeners and collectors now see the same shape whether the reaction came from you or from the gateway.

The description field was previously omitted when it had no value. If you snapshot or diff embed JSON, expect an explicit description: null to appear.

Fluxer ignores the legacy Discord-style intents value, so you can drop it entirely. If your code required intents: N, pass intents: 0 or simply omit it.

The vendored OpenAPI snapshot was refreshed against live Fluxer, which tightened nullability on some channel and guild request fields. Payloads that were loosely typed before may now be rejected; align them with the refreshed snapshot.