yuzuha 0.2.0 → 0.2.1

package/docs/NATIVE.md

@@ -187,6 +187,15 @@ Yuzuha. Chamadas diretas ao client exigem mocks ou fixtures próprios.
 importar `Events`, `AttachmentBuilder`, `EmbedBuilder` e os tipos do Fluxer.js.
 A assinatura completa dessas classes pertence ao SDK fixado em 3.3.0.
 
+Os subpaths do SDK também são espelhados: `yuzuha/sdk/client`, `yuzuha/sdk/errors`,
+`yuzuha/sdk/message`, `yuzuha/sdk/cluster` e `yuzuha/sdk/internal` equivalem aos
+caminhos homônimos de `@fluxerjs/core`. Os pacotes satélites aparecem como
+`yuzuha/sdk/types` (com `yuzuha/sdk/types/routes`), `yuzuha/sdk/rest` (com
+`yuzuha/sdk/rest/request-manager`), `yuzuha/sdk/ws`, `yuzuha/sdk/builders`,
+`yuzuha/sdk/collection` e `yuzuha/sdk/util`. `yuzuha/sdk/voice` e
+`yuzuha/sdk/sharding` reexportam os pacotes opcionais homônimos e só funcionam
+quando o peer correspondente está instalado.
+
 ## Recursos nativos
 
 As funções `$...` de usuários, cargos, canais, mensagens, coletores, webhooks,
@@ -206,8 +215,12 @@ await ctx.reply(`${membro.displayName}: ${canais.length} canais, ${fixadas.lengt
 | `users` | `user`, `member`, `members`, `memberCount`, `guild`, `bans`, `auditLogs`, `setPresence`, `searchMembers`, `setNickname`, `editGuild` |
 | `roles` | `list`, `resolve`, `has`, `create`, `edit`, `delete`, `add`, `remove`, `move` |
 | `channels` | `list`, `get`, `create`, `edit`, `delete`, `setSlowmode`, `overwrite`, `permissionsFor`, `move`, `setCategory` |
-| `messages` | Histórico com cursores, `pinnedPage`, `reactionUsersPage`, `dm`, `forward`, `search` com filtros avançados, `sendFiles`, `sendBytes`, `sendAttachments` |
-| `collectors` | `awaitMessage`, `awaitReaction` |
+| `messages` | Histórico com cursores, `pinnedPage`, `reactionUsersPage`, `dm`, `forward`, `search`/`searchAll` com filtros avançados, `bulkFetch`, `sendFiles`, `sendBytes`, `sendAttachments` |
+| `collectors` | `awaitMessage`, `awaitReaction`, streams `collectMessages`/`collectReactions` (AsyncIterable) |
+| `gateway` | `requestMembers`, `requestGuildCounts`, `requestChannelCounts`, `requestForumUnreads`, `subscribeThreads`, `send` (fire-and-forget) |
+| `instance` | `describe`, `gatewayInfo`, `application`, `oauthApplications`, `emojiMetadata`, `stickerMetadata`, `resolveEmoji` |
+| `self` | `fetch`, `guilds`, `leaveGuild` e `deleteMyMessages` com verificação sudo |
+| `cache` | `stats`, `sweepMessages`, `sweepMembers` |
 | `webhooks` | `list`, `create`, `send`, `edit`, `delete` |
 | `expressions` | CRUD de emojis/stickers, `cloneEmoji`, `cloneSticker` |
 | `threads` | `create`, `archive`, `unarchive`, `forumPost`, `addMember`, `removeMember`, `members`, `member`, `edit`, `join`, `leave`, `search` |
@@ -252,9 +265,23 @@ o SDK. `$createEmoji[nome;url]` faz o download e a conversão com `ctx.http`;
 `$createSticker` recebe base64 diretamente. Edição de sticker suporta nome,
 descrição e motivo; tags são aceitas na criação.
 
-Implementações próprias dos contratos `MessagesResources`, `ThreadsResources`,
-`ExpressionsResources`, `UsersResources`, `InvitesResources`, `ChannelsResources` e `RolesResources` precisam fornecer
-as novas operações da 0.1.2. Para testes que exercitam apenas parte dos recursos,
+`collectors.collectMessages` e `collectors.collectReactions` retornam um
+`AsyncIterable` que emite cada item coletado até o limite (`timeMs`, `max` ou
+`signal`) ou o cancelamento do comando. Reações exigem `messageID`: o coletor do
+SDK é por mensagem. Iteradores são de uso único; cada chamada cria um novo stream.
+
+`messages.bulkFetch` agrupa pedidos de janela por canal e hidrata as mensagens
+por padrão; `hydrate: false` devolve os payloads brutos da API. `searchAll` é a
+busca global do client com os mesmos filtros e paginação de `search`.
+
+`gateway` envia pedidos brutos ao gateway sem aguardar resposta — os resultados
+chegam pelos eventos do client. `users.guildCounts` e `users.channelCounts`
+continuam sendo o caminho quando se espera o valor de volta.
+
+Implementações próprias dos contratos `Resources` devem fornecer as áreas
+`gateway`, `instance`, `self` e `cache` além das anteriores; `CollectorsResources`
+ganhou `collectMessages`/`collectReactions` e `MessagesResources` ganhou
+`searchAll`/`bulkFetch`. Para testes que exercitam apenas parte dos recursos,
 use `mockResources`, que aceita implementações parciais por método.
 
 ## Membros, mensagens e transações

package/docs/PARITY-MATRIX.md

@@ -17,9 +17,9 @@ A cobertura é por nome: um método `send` de uma classe conta como coberto se q
 | Status | Exports de runtime | Membros |
 |---|---:|---:|
 | coberto-script | 50 | 414 |
-| coberto-nativo | 4 | 62 |
+| coberto-nativo | 4 | 85 |
 | só-SDK | 3 | 0 |
-| lacuna | 60 | 246 |
+| lacuna | 60 | 223 |
 
 Pacotes: @fluxerjs/core, @fluxerjs/builders, @fluxerjs/types. Tipos e enums são listados, mas não contam como lacuna.
 
@@ -192,11 +192,11 @@ Pacotes: @fluxerjs/core, @fluxerjs/builders, @fluxerjs/types. Tipos e enums são
 | `CacheController` | `cascadeGuild` | método | lacuna |
 | `CacheController` | `cascading` | acessor | lacuna |
 | `CacheController` | `limits` | propriedade | coberto-nativo |
-| `CacheController` | `stats` | método | lacuna |
+| `CacheController` | `stats` | método | coberto-nativo |
 | `CacheController` | `sweepChannels` | método | lacuna |
 | `CacheController` | `sweepGuilds` | método | lacuna |
-| `CacheController` | `sweepMembers` | método | lacuna |
-| `CacheController` | `sweepMessages` | método | lacuna |
+| `CacheController` | `sweepMembers` | método | coberto-nativo |
+| `CacheController` | `sweepMessages` | método | coberto-nativo |
 | `CacheController` | `sweepUsers` | método | lacuna |
 | `Channel` | `_patch` | método | lacuna |
 | `Channel` | `acknowledgePins` | método | lacuna |
@@ -216,7 +216,7 @@ Pacotes: @fluxerjs/core, @fluxerjs/builders, @fluxerjs/types. Tipos e enums são
 | `Channel` | `fetchSlowmode` | método | lacuna |
 | `Channel` | `from` | método | coberto-script |
 | `Channel` | `fromOrCreate` | método | lacuna |
-| `Channel` | `icon` | propriedade | lacuna |
+| `Channel` | `icon` | propriedade | coberto-nativo |
 | `Channel` | `id` | propriedade | coberto-script |
 | `Channel` | `isAnnouncement` | método | lacuna |
 | `Channel` | `isCategory` | método | coberto-script |
@@ -249,7 +249,7 @@ Pacotes: @fluxerjs/core, @fluxerjs/builders, @fluxerjs/types. Tipos e enums são
 | `Client` | `_finalizeReady` | método | lacuna |
 | `Client` | `_getMessageCache` | método | lacuna |
 | `Client` | `_guildStreamSettleTimeout` | propriedade | lacuna |
-| `Client` | `_messageCacheStats` | método | lacuna |
+| `Client` | `_messageCacheStats` | método | coberto-nativo |
 | `Client` | `_onGuildReceived` | método | lacuna |
 | `Client` | `_pendingGuildIds` | propriedade | lacuna |
 | `Client` | `_readyStubGuildIds` | propriedade | lacuna |
@@ -257,22 +257,22 @@ Pacotes: @fluxerjs/core, @fluxerjs/builders, @fluxerjs/types. Tipos e enums são
 | `Client` | `_sendToAllShards` | método | lacuna |
 | `Client` | `_ws` | propriedade | lacuna |
 | `Client` | `assertReady` | método | lacuna |
-| `Client` | `bulkFetchMessages` | método | lacuna |
+| `Client` | `bulkFetchMessages` | método | coberto-nativo |
 | `Client` | `cache` | propriedade | coberto-nativo |
 | `Client` | `channels` | propriedade | coberto-script |
 | `Client` | `destroy` | método | coberto-nativo |
 | `Client` | `emit` | método | coberto-nativo |
 | `Client` | `events` | propriedade | coberto-nativo |
-| `Client` | `fetchApplication` | método | lacuna |
-| `Client` | `fetchEmojiMetadata` | método | lacuna |
-| `Client` | `fetchGatewayInfo` | método | lacuna |
-| `Client` | `fetchInstance` | método | lacuna |
-| `Client` | `fetchOAuthApplications` | método | lacuna |
-| `Client` | `fetchStickerMetadata` | método | lacuna |
+| `Client` | `fetchApplication` | método | coberto-nativo |
+| `Client` | `fetchEmojiMetadata` | método | coberto-nativo |
+| `Client` | `fetchGatewayInfo` | método | coberto-nativo |
+| `Client` | `fetchInstance` | método | coberto-nativo |
+| `Client` | `fetchOAuthApplications` | método | coberto-nativo |
+| `Client` | `fetchStickerMetadata` | método | coberto-nativo |
 | `Client` | `fromDiscovery` | método | lacuna |
 | `Client` | `getOrCreateUser` | método | lacuna |
 | `Client` | `guilds` | propriedade | coberto-script |
-| `Client` | `instance` | propriedade | lacuna |
+| `Client` | `instance` | propriedade | coberto-nativo |
 | `Client` | `isReady` | método | lacuna |
 | `Client` | `logger` | propriedade | lacuna |
 | `Client` | `login` | método | coberto-nativo |
@@ -284,17 +284,17 @@ Pacotes: @fluxerjs/core, @fluxerjs/builders, @fluxerjs/types. Tipos e enums são
 | `Client` | `preloadMessagesAlt` | método | lacuna |
 | `Client` | `readyAt` | propriedade | coberto-nativo |
 | `Client` | `requestChannelMemberCounts` | método | coberto-script |
-| `Client` | `requestForumUnreads` | método | lacuna |
+| `Client` | `requestForumUnreads` | método | coberto-nativo |
 | `Client` | `requestGuildCounts` | método | coberto-script |
-| `Client` | `requestGuildMembers` | método | lacuna |
+| `Client` | `requestGuildMembers` | método | coberto-nativo |
 | `Client` | `resolveEmoji` | método | coberto-script |
 | `Client` | `rest` | propriedade | lacuna |
 | `Client` | `Routes` | acessor | lacuna |
 | `Client` | `searchMessages` | método | coberto-script |
-| `Client` | `sendToGateway` | método | lacuna |
-| `Client` | `subscribeThreads` | método | lacuna |
-| `Client` | `sweepMembers` | método | lacuna |
-| `Client` | `sweepMessages` | método | lacuna |
+| `Client` | `sendToGateway` | método | coberto-nativo |
+| `Client` | `subscribeThreads` | método | coberto-nativo |
+| `Client` | `sweepMembers` | método | coberto-nativo |
+| `Client` | `sweepMessages` | método | coberto-nativo |
 | `Client` | `uptime` | acessor | lacuna |
 | `Client` | `user` | propriedade | coberto-script |
 | `Client` | `users` | propriedade | coberto-script |
@@ -313,10 +313,10 @@ Pacotes: @fluxerjs/core, @fluxerjs/builders, @fluxerjs/types. Tipos e enums são
 | `ClientCluster` | `runtimeValues` | método | lacuna |
 | `ClientCluster` | `size` | acessor | coberto-script |
 | `ClientCluster` | `values` | método | coberto-script |
-| `ClientUser` | `bulkDeleteMyMessagesInGuild` | método | lacuna |
+| `ClientUser` | `bulkDeleteMyMessagesInGuild` | método | coberto-nativo |
 | `ClientUser` | `client` | propriedade | coberto-script |
 | `ClientUser` | `fetch` | método | coberto-script |
-| `ClientUser` | `fetchGuilds` | método | lacuna |
+| `ClientUser` | `fetchGuilds` | método | coberto-nativo |
 | `ClientUser` | `leaveGuild` | método | coberto-nativo |
 | `ClientUser` | `setPresence` | método | coberto-script |
 | `DMChannel` | `_patch` | método | lacuna |
@@ -419,7 +419,7 @@ Pacotes: @fluxerjs/core, @fluxerjs/builders, @fluxerjs/types. Tipos e enums são
 | `Guild` | `fetchStickers` | método | coberto-script |
 | `Guild` | `fetchVanityURL` | método | coberto-script |
 | `Guild` | `fetchWebhooks` | método | coberto-script |
-| `Guild` | `icon` | propriedade | lacuna |
+| `Guild` | `icon` | propriedade | coberto-nativo |
 | `Guild` | `iconURL` | método | coberto-script |
 | `Guild` | `id` | propriedade | coberto-script |
 | `Guild` | `kick` | método | coberto-nativo |
@@ -606,7 +606,7 @@ Pacotes: @fluxerjs/core, @fluxerjs/builders, @fluxerjs/types. Tipos e enums são
 | `Message` | `mentions` | propriedade | coberto-script |
 | `Message` | `messageReference` | propriedade | lacuna |
 | `Message` | `messageSnapshots` | propriedade | lacuna |
-| `Message` | `nonce` | propriedade | lacuna |
+| `Message` | `nonce` | propriedade | coberto-nativo |
 | `Message` | `nsfwEmojis` | propriedade | lacuna |
 | `Message` | `partial` | propriedade | coberto-nativo |
 | `Message` | `pin` | método | coberto-script |

package/docs/PARITY.md

@@ -17,27 +17,39 @@ públicos da raiz do pacote e seus tipos. `bot.client` é uma instância real de
 `Client`; `SDK` na raiz do Yuzuha é um namespace do mesmo pacote. O acesso nativo
 não é uma reprodução parcial do client.
 
-Isso não significa que cada método tem uma função `$...`, nem que pacotes opcionais
-ou subpaths do SDK foram incorporados à raiz. O teste de consumidor compara os
-exports de `yuzuha/sdk` aos da dependência instalada.
+Os subpaths do pacote e os pacotes satélites do monorepo também são espelhados:
+`yuzuha/sdk/client`, `yuzuha/sdk/errors`, `yuzuha/sdk/message`,
+`yuzuha/sdk/cluster` e `yuzuha/sdk/internal` equivalem a `@fluxerjs/core/*`;
+`yuzuha/sdk/types`, `yuzuha/sdk/types/routes`, `yuzuha/sdk/rest`,
+`yuzuha/sdk/rest/request-manager`, `yuzuha/sdk/ws`, `yuzuha/sdk/builders`,
+`yuzuha/sdk/collection` e `yuzuha/sdk/util` reexportam os pacotes homônimos, que
+passam a ser dependências diretas do Yuzuha. `yuzuha/sdk/voice` e
+`yuzuha/sdk/sharding` reexportam os pacotes opcionais homônimos, exigindo o peer
+instalado. O teste de consumidor compara os exports de cada subpath `yuzuha/sdk*`
+aos do pacote correspondente instalado.
+
+Isso não significa que cada método tem uma função `$...`. `@fluxerjs/sharding`
+declara peer em `@fluxerjs/core` 3.0.0 exato; consumidores que o instalarem
+precisam de `overrides` para o core fixado, como no manifesto do Yuzuha.
 
 | Área | JS/TS pelo client/SDK | Function mode |
 |---|---|---|
-| Gateway, conexão, heartbeat e reconexão | Herdado do SDK | Via inicialização do bot |
+| Gateway, conexão, heartbeat e reconexão | Herdado do SDK; pedidos brutos por `ctx.resources.gateway` (membros, contagens, não lidos de fórum, assinatura de threads, envio por shard) | Via inicialização do bot |
 | Eventos | `bot.on/once/off`, `bot.event`, `bot.scriptEvent` e `bot.client.on` | Eventos de membros, edição/exclusão de mensagens e reações, com contexto próprio |
 | Mensagens e replies | API completa do SDK | reply, sendMessage, editMessage, deleteMessage, fetchMessage, messages com cursores, pin/unpin, pinnedMessagesPage, dm, forward, searchMessages, searchMessagesAdvanced e preloadMessages |
-| Reações e collectors | API do SDK | react, removeReaction, clearReactions, reactionUsers e reactionUsersPage com metadados de paginação, awaitMessage, awaitReaction, confirm |
+| Reações e collectors | API do SDK; streams `collectMessages`/`collectReactions` como `AsyncIterable` | react, removeReaction, clearReactions, reactionUsers e reactionUsersPage com metadados de paginação, awaitMessage, awaitReaction, confirm |
 | Embeds e anexos | Builders do SDK, sendBytes e sendAttachments | Embeds completos (autor, link, data, campos, alt text e rodapé com ícone), até 10 embeds, opções de envio com autorização, anexos URL/base64 e múltiplos anexos; leitura normalizada em `$fetchMessage` |
 | Membros, cargos, canais e permissões | API do SDK e `ctx.members` | User/member, perfil completo, contagens ao vivo, nickname, roles, canais de link, avisos, posição, categorias e overwrites |
 | Ban, kick, timeout, unban e moderação de voz | SDK + `ctx.mod` e `ctx.moderate` | Versões simples e mod* com casos, incluindo move/mute/deafen |
 | Servidor, convites, webhooks e expressões | API do SDK e auxiliares autorizados | guildFeatures, leaveGuild, editGuild, convites/vanity, clonagem e mutações de emojis/stickers, createEmojisBulk; CRUD e envio de webhooks |
 | Threads e fóruns | API do SDK | Criação, edição, busca, posts, membros, threadMember e listagens ativas/arquivadas com paginação |
 | Presença | `client.user.setPresence` | setPresence, setStatus e setActivity |
-| Cache e presença | Opções e métodos do SDK | Acesso nativo |
-| Instância própria/discovery | `Client.fromDiscovery`, client injetado | Mesmo adaptador do client |
+| Cache e presença | `ctx.resources.cache` (estatísticas, limites e limpezas) e opções do SDK | Acesso nativo |
+| Usuário autenticado | `ctx.resources.self` (fetch, guilds, saída e limpeza com verificação sudo) | setPresence, setStatus, setActivity e leaveGuild |
+| Instância e aplicação | `ctx.resources.instance` (describe, gatewayInfo, application, oauthApplications, metadados de emoji/sticker, resolveEmoji); `Client.fromDiscovery`, client injetado | Mesmo adaptador do client |
 | Áudio em voz | `FluxerVoice` sobre `@fluxerjs/voice` opcional; Lavalink v4 com plugin de áudio, `FluxerLavalinkBridge`, filas editáveis e recuperação em `yuzuha/music` | Sem wrappers de reprodução; moderação de membros usa o SDK core |
-| Sharding | Pacote separado `@fluxerjs/sharding` | Sem coordenação própria |
-| Cluster/subpaths | Imports diretos de `@fluxerjs/core/cluster` | Sem wrapper próprio |
+| Sharding | `yuzuha/sdk/sharding` reexporta `@fluxerjs/sharding` (peer opcional) | Sem coordenação própria |
+| Cluster/subpaths | `yuzuha/sdk/cluster` e demais subpaths `yuzuha/sdk/*` espelham `@fluxerjs/core/*` e os pacotes satélites | Sem wrapper próprio |
 | Estado e casos | `ctx.data`, TTL, userFor, transaction entre chaves e stores | Variáveis, TTL, incrementos, listas, casos e dataTransaction com operações declarativas |
 | Agendamentos | `ctx.scheduler`, cron/fusos, concorrência limitada, histórico, heartbeat e controles | schedule, scheduleEvery, scheduleCron, controles, histórico, reexecução e retry com jitter |
 | HTTP | `request`, `requestBytes`, `stream`, `multipart`, `withPolicy` e cancelamento | `$http`, `$httpJson`, `$httpMultipart` e download de imagens com política de rede por comando |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yuzuha",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Fluxer bots with simple scripts and typed JavaScript/TypeScript.",
   "type": "module",
   "license": "MIT",
@@ -26,6 +26,10 @@
       "types": "./dist/sdk.d.ts",
       "import": "./dist/sdk.js"
     },
+    "./sdk/*": {
+      "types": "./dist/sdk/*.d.ts",
+      "import": "./dist/sdk/*.js"
+    },
     "./testing": {
       "types": "./dist/testing.d.ts",
       "import": "./dist/testing.js"
@@ -93,11 +97,19 @@
     "package:editor": "node scripts/package-editor.mjs"
   },
   "dependencies": {
+    "@fluxerjs/builders": "3.0.0",
+    "@fluxerjs/collection": "3.0.0",
     "@fluxerjs/core": "3.3.0",
+    "@fluxerjs/rest": "3.1.0",
+    "@fluxerjs/types": "3.3.0",
+    "@fluxerjs/util": "3.1.0",
+    "@fluxerjs/ws": "3.1.0",
     "tsx": "^4.20.0",
     "ws": "^8.22.0"
   },
   "devDependencies": {
+    "@fluxerjs/sharding": "^3.0.0",
+    "@fluxerjs/voice": "^3.1.0",
     "@napi-rs/canvas": "1.0.13",
     "@types/node": "^22.0.0",
     "@types/vscode": "^1.140.0",
@@ -106,11 +118,15 @@
     "typescript": "^5.9.0"
   },
   "peerDependencies": {
+    "@fluxerjs/sharding": "^3.0.0",
     "@fluxerjs/voice": "^3.1.0",
     "@napi-rs/canvas": "^1.0.13",
     "sharp": "^0.35.5"
   },
   "peerDependenciesMeta": {
+    "@fluxerjs/sharding": {
+      "optional": true
+    },
     "@fluxerjs/voice": {
       "optional": true
     },
@@ -120,5 +136,10 @@
     "@napi-rs/canvas": {
       "optional": true
     }
+  },
+  "overrides": {
+    "@fluxerjs/sharding": {
+      "@fluxerjs/core": "3.3.0"
+    }
   }
 }

package/src/commands/context.ts

@@ -186,11 +186,16 @@ export class CommandContext {
     const source = bindAuthorizedResources(this.nativeResources, this.transport, { guildID: this.guildID, authorID: this.authorID }), collectors = source.collectors;
     return this.scopedResources = { users: source.users, roles: source.roles, channels: source.channels,
       messages: source.messages, webhooks: source.webhooks, expressions: source.expressions,
-      threads: source.threads, invites: source.invites, collectors: {
+      threads: source.threads, invites: source.invites, gateway: source.gateway,
+      instance: source.instance, self: source.self, cache: source.cache, collectors: {
         awaitMessage: (channelID, input) => collectors.awaitMessage(channelID, { ...input,
           signal: input.signal ? AbortSignal.any([this.signal, input.signal]) : this.signal }),
         awaitReaction: (channelID, messageID, emojis, timeMs, userID, signal) => collectors.awaitReaction(
           channelID, messageID, emojis, timeMs, userID, signal ? AbortSignal.any([this.signal, signal]) : this.signal),
+        collectMessages: (channelID, input) => collectors.collectMessages(channelID, { ...input,
+          signal: input.signal ? AbortSignal.any([this.signal, input.signal]) : this.signal }),
+        collectReactions: (channelID, input) => collectors.collectReactions(channelID, { ...input,
+          signal: input.signal ? AbortSignal.any([this.signal, input.signal]) : this.signal }),
       } };
   }
   get scheduler(): Scheduler {

package/src/index.ts

@@ -28,12 +28,18 @@ export type {
   ChannelInfo, ChannelCreateInput, ChannelEditInput, ChannelOverwriteInput, ChannelsResources,
 } from './ports/resources/channels.js';
 export type { AttachmentInfo, MessageInfo, MessagesResources, MessageCursor, MessageSearchInput, MessageSearchPage,
-  PinnedMessagesInput, PinnedMessagesPage, ReactionUsersPage } from './ports/resources/messages.js';
-export type { AwaitMessageInput, CollectedMessageInfo, CollectorsResources, ReactionVote } from './ports/resources/collectors.js';
+  PinnedMessagesInput, PinnedMessagesPage, ReactionUsersPage,
+  BulkFetchRequest, BulkFetchInput, BulkFetchRawChannel } from './ports/resources/messages.js';
+export type { AwaitMessageInput, CollectedMessageInfo, CollectMessagesInput, CollectReactionsInput, CollectorsResources, ReactionVote } from './ports/resources/collectors.js';
 export type { WebhookInfo, WebhookSendInput, WebhooksResources } from './ports/resources/webhooks.js';
 export type { EmojiInfo, EmojiCreateInput, EmojiBulkResult, StickerInfo, StickerCreateInput, StickerEditInput, ExpressionsResources } from './ports/resources/expressions.js';
 export type { ThreadInfo, ThreadMemberInfo, ThreadMemberDetails, ThreadCreateInput, ForumPostInput, ThreadsResources, ThreadEditInput, ThreadSearchInput, ThreadSearchPage, ArchivedThreadsInput, ThreadListPage } from './ports/resources/threads.js';
 export type { InviteInfo, InviteCreateInput, InvitesResources } from './ports/resources/invites.js';
+export type { GatewayMembersRequest, ChannelCountsRequest, ForumUnreadsRequest, ThreadSubscriptionInput, GatewayResources } from './ports/resources/gateway.js';
+export type { InstanceEndpointsInfo, InstanceFeaturesInfo, InstanceServicesInfo, InstanceInfo, GatewayInfo, ApplicationInfo,
+  EmojiMetadataInfo, StickerMetadataInfo, EmojiReference, InstanceResources } from './ports/resources/instance.js';
+export type { SudoVerification, SelfGuildInfo, SelfResources } from './ports/resources/self.js';
+export type { CacheLimitsInfo, CacheStatsInfo, MessageSweepInput, MemberSweepInput, CacheResources } from './ports/resources/cache.js';
 export type { AttachmentSpec, BinaryAttachmentSpec, PresenceStatus, ActivityType, ActivityInfo } from './ports/resources/common.js';
 export { NativeModeration } from './services/native-moderation.js';
 export type { NativeModerationOptions, NativeBanOptions, NativeTimeoutOptions, NativeMoveOptions, NativeVoiceOptions, ModerationTarget } from './services/native-moderation.js';

package/src/infrastructure/fluxer/resources/cache.ts

@@ -0,0 +1,52 @@
+import type { Client } from '@fluxerjs/core';
+import { YuzuhaError } from '../../../errors.js';
+import type { CacheResources } from '../../../ports/resources/cache.js';
+import { toMessageInfo } from './messages.js';
+import { toMemberInfo } from './users.js';
+
+function bounded(value: number): number | null {
+  return Number.isFinite(value) ? value : null;
+}
+
+export function createCacheResources(client: Client): CacheResources {
+  return {
+    async stats() {
+      const sizes = client.cache.stats();
+      const messages = client._messageCacheStats();
+      const limits = client.cache.limits;
+      return {
+        ...sizes,
+        messages: messages.messages,
+        messageChannels: messages.channels,
+        limits: {
+          guilds: bounded(limits.guilds),
+          channels: bounded(limits.channels),
+          users: bounded(limits.users),
+          members: bounded(limits.members),
+          messages: limits.messages === false ? false : bounded(limits.messages),
+          roles: bounded(limits.roles),
+          emojis: bounded(limits.emojis),
+          stickers: bounded(limits.stickers),
+        },
+      };
+    },
+    async sweepMessages(input = {}) {
+      const { channelID, maxAgeMs, keep } = input;
+      if (maxAgeMs !== undefined && (!Number.isSafeInteger(maxAgeMs) || maxAgeMs < 0)) {
+        throw new YuzuhaError('SWEEP_AGE', 'maxAgeMs deve ser um inteiro não negativo.');
+      }
+      const cutoff = maxAgeMs === undefined ? null : Date.now() - maxAgeMs;
+      return client.sweepMessages((message, channelId) => {
+        if (cutoff !== null && message.createdAt.getTime() >= cutoff) return false;
+        return keep ? !keep(toMessageInfo(message), channelId) : true;
+      }, channelID);
+    },
+    async sweepMembers(input = {}) {
+      const { guildID, keep } = input;
+      return client.sweepMembers((member, guildId) => {
+        if (guildID !== undefined && guildId !== guildID) return false;
+        return keep ? !keep(toMemberInfo(member), guildId) : true;
+      });
+    },
+  };
+}

package/src/infrastructure/fluxer/resources/collectors.ts

@@ -1,7 +1,10 @@
 import type { Client, Message } from '@fluxerjs/core';
 import { MessageCollector, ReactionCollector } from '@fluxerjs/core';
-import type { AwaitMessageInput, CollectedMessageInfo, CollectorsResources, ReactionVote } from '../../../ports/resources/collectors.js';
+import type { AwaitMessageInput, CollectedMessageInfo, CollectMessagesInput, CollectReactionsInput, CollectorsResources, ReactionVote } from '../../../ports/resources/collectors.js';
 import { cancellationError } from '../../../services/cancellation.js';
+import { YuzuhaError } from '../../../errors.js';
+
+type ReactionLike = { emojiIdentifier: string; emoji: { name: string }; messageId: string };
 
 function info(message: Message): CollectedMessageInfo {
   return { id: message.id, channelID: message.channelId, authorID: message.author.id, content: message.content };
@@ -11,11 +14,47 @@ function targets(emojis: string | string[]): string[] {
   return (Array.isArray(emojis) ? emojis : [emojis]).map(value => value.trim().toLowerCase()).filter(Boolean);
 }
 
-function vote(reaction: { emojiIdentifier: string; emoji: { name: string } }, userID: string, wanted: string[]): ReactionVote | null {
+function matches(reaction: ReactionLike, wanted: string[]): boolean {
   const identifier = reaction.emojiIdentifier.toLowerCase();
   const name = reaction.emoji.name.toLowerCase();
-  if (!wanted.includes(identifier) && !wanted.includes(name)) return null;
-  return { userID, emoji: reaction.emoji.name };
+  return wanted.includes(identifier) || wanted.includes(name);
+}
+
+function voteInfo(reaction: ReactionLike, userID: string): ReactionVote {
+  return { userID, emoji: reaction.emoji.name, messageID: reaction.messageId };
+}
+
+function vote(reaction: ReactionLike, userID: string, wanted: string[]): ReactionVote | null {
+  return matches(reaction, wanted) ? voteInfo(reaction, userID) : null;
+}
+
+function positiveBound(value: number | undefined): number {
+  return value !== undefined && Number.isFinite(value) && value > 0 ? value : 0;
+}
+
+function requireBounds(time: number, max: number, signal: AbortSignal | undefined): void {
+  if (time <= 0 && max <= 0 && signal === undefined) {
+    throw new YuzuhaError('COLLECTOR_BOUNDS', 'Informe um limite para o coletor: timeMs, max ou signal.');
+  }
+}
+
+/** Itera itens de um coletor do SDK: enfileira 'collect', encerra no 'end' e limpa ao sair. */
+async function* pump<T>(attach: (push: (item: T) => void, finish: () => void) => () => void): AsyncGenerator<T, void> {
+  const queue: T[] = [];
+  let ended = false;
+  let waiting: (() => void) | undefined;
+  const notify = (): void => { const wake = waiting; waiting = undefined; wake?.(); };
+  const detach = attach(item => { queue.push(item); notify(); }, () => { ended = true; notify(); });
+  try {
+    for (;;) {
+      const item = queue.shift();
+      if (item !== undefined) { yield item; continue; }
+      if (ended) return;
+      await new Promise<void>(resolve => { waiting = resolve; });
+    }
+  } finally {
+    detach();
+  }
 }
 
 export function createCollectorsResources(client: Client): CollectorsResources {
@@ -85,5 +124,49 @@ export function createCollectorsResources(client: Client): CollectorsResources {
         if (signal?.aborted) abort();
       });
     },
+    collectMessages(channelID: string, input: CollectMessagesInput): AsyncIterable<CollectedMessageInfo> {
+      const time = positiveBound(input.timeMs);
+      const max = positiveBound(input.max);
+      requireBounds(time, max, input.signal);
+      const filter = input.userID === undefined && input.contains === undefined
+        ? undefined
+        : (message: Message) =>
+          (input.userID === undefined || message.author.id === input.userID) &&
+          (input.contains === undefined || message.content.includes(input.contains));
+      const signal = input.signal;
+      return pump<CollectedMessageInfo>((push, finish) => {
+        // O SDK exige time ou max; com só signal o teto de max é inalcançável e o abort encerra.
+        const collector = new MessageCollector(client, channelID, {
+          filter, time, max: time > 0 || max > 0 ? max : Number.MAX_SAFE_INTEGER,
+        });
+        const abort = (): void => collector.stop('user');
+        collector.on('collect', message => push(info(message)));
+        collector.on('end', () => finish());
+        signal?.addEventListener('abort', abort, { once: true });
+        if (signal?.aborted) collector.stop('user');
+        return () => { signal?.removeEventListener('abort', abort); collector.stop('user'); };
+      });
+    },
+    collectReactions(channelID: string, input: CollectReactionsInput): AsyncIterable<ReactionVote> {
+      const time = positiveBound(input.timeMs);
+      const max = positiveBound(input.max);
+      requireBounds(time, max, input.signal);
+      if (!input.messageID) throw new YuzuhaError('COLLECTOR_MESSAGE', 'Informe a mensagem (messageID) para coletar reações.');
+      const wanted = targets(input.emojis ?? []);
+      const signal = input.signal;
+      return pump<ReactionVote>((push, finish) => {
+        const collector = new ReactionCollector(client, input.messageID, channelID, {
+          time, max,
+          filter: (reaction, user) => (input.userID === undefined || user.id === input.userID)
+            && (wanted.length === 0 || matches(reaction, wanted)),
+        });
+        const abort = (): void => collector.stop('user');
+        collector.on('collect', (reaction, user) => push(voteInfo(reaction, user.id)));
+        collector.on('end', () => finish());
+        signal?.addEventListener('abort', abort, { once: true });
+        if (signal?.aborted) collector.stop('user');
+        return () => { signal?.removeEventListener('abort', abort); collector.stop('user'); };
+      });
+    },
   };
 }

package/src/infrastructure/fluxer/resources/gateway.ts

@@ -0,0 +1,33 @@
+import type { Client } from '@fluxerjs/core';
+import type { GatewayResources } from '../../../ports/resources/gateway.js';
+
+export function createGatewayResources(client: Client): GatewayResources {
+  return {
+    requestMembers(input) {
+      client.requestGuildMembers({
+        guildId: input.guildID, guildIds: input.guildIDs, query: input.query, limit: input.limit,
+        userIds: input.userIDs, presences: input.presences, nonce: input.nonce,
+      });
+    },
+    requestGuildCounts(guildIDs, nonce) {
+      client.requestGuildCounts({ guildIds: guildIDs, nonce });
+    },
+    requestChannelCounts(input) {
+      client.requestChannelMemberCounts({
+        guildId: input.guildID, channelId: input.channelID, channelIds: input.channelIDs, nonce: input.nonce,
+      });
+    },
+    requestForumUnreads(input) {
+      client.requestForumUnreads({
+        guildId: input.guildID, channelId: input.channelID,
+        threads: input.threads.map(thread => ({ threadId: thread.threadID, ackMessageId: thread.ackMessageID })),
+      });
+    },
+    subscribeThreads(input) {
+      client.subscribeThreads({ guildId: input.guildID, threads: input.threads, threadIds: input.threadIDs });
+    },
+    send(shardID, payload) {
+      client.sendToGateway(shardID, payload);
+    },
+  };
+}