yuzuha 0.2.0 → 0.3.0

package/src/infrastructure/fluxer/resources.ts

@@ -1,11 +1,15 @@
 import type { Client } from '@fluxerjs/core';
 import type { Resources } from '../../ports/resources.js';
+import { createCacheResources } from './resources/cache.js';
 import { createChannelsResources } from './resources/channels.js';
 import { createCollectorsResources } from './resources/collectors.js';
 import { createExpressionsResources } from './resources/expressions.js';
+import { createGatewayResources } from './resources/gateway.js';
+import { createInstanceResources } from './resources/instance.js';
 import { createInvitesResources } from './resources/invites.js';
 import { createMessagesResources } from './resources/messages.js';
 import { createRolesResources } from './resources/roles.js';
+import { createSelfResources } from './resources/self.js';
 import { createThreadsResources } from './resources/threads.js';
 import { createUsersResources } from './resources/users.js';
 import { createWebhooksResources } from './resources/webhooks.js';
@@ -21,6 +25,10 @@ export class FluxerResources implements Resources {
   readonly expressions;
   readonly threads;
   readonly invites;
+  readonly gateway;
+  readonly instance;
+  readonly self;
+  readonly cache;
 
   constructor(client: Client) {
     this.users = createUsersResources(client);
@@ -32,5 +40,9 @@ export class FluxerResources implements Resources {
     this.expressions = createExpressionsResources(client);
     this.threads = createThreadsResources(client);
     this.invites = createInvitesResources(client);
+    this.gateway = createGatewayResources(client);
+    this.instance = createInstanceResources(client);
+    this.self = createSelfResources(client);
+    this.cache = createCacheResources(client);
   }
 }

package/src/ports/resources/cache.ts

@@ -0,0 +1,81 @@
+import type { MessageInfo } from './messages.js';
+import type { ChannelInfo } from './channels.js';
+import type { GuildInfo, MemberInfo, UserInfo } from './users.js';
+
+/** Limites resolvidos do cache; `null` indica ilimitado. */
+export interface CacheLimitsInfo {
+  guilds: number | null;
+  channels: number | null;
+  users: number | null;
+  members: number | null;
+  /** `false` quando o cache de mensagens está desabilitado. */
+  messages: number | false | null;
+  roles: number | null;
+  emojis: number | null;
+  stickers: number | null;
+  cascading?: boolean;
+}
+
+/** Tamanhos atuais dos buckets de cache com os limites aplicados. */
+export interface CacheStatsInfo {
+  guilds: number;
+  channels: number;
+  users: number;
+  members: number;
+  messages: number;
+  messageChannels: number;
+  roles: number;
+  emojis: number;
+  stickers: number;
+  limits: CacheLimitsInfo;
+}
+
+/**
+ * Filtro de limpeza do cache de mensagens. Sem `maxAgeMs` nem `keep`,
+ * todas as mensagens do escopo são removidas. `keep` retorna verdadeiro
+ * para manter a mensagem no cache.
+ */
+export interface MessageSweepInput {
+  channelID?: string;
+  maxAgeMs?: number;
+  keep?: (message: MessageInfo, channelID: string) => boolean;
+}
+
+/**
+ * Filtro de limpeza do cache de membros. Sem `keep`, todos os membros
+ * do escopo são removidos. `keep` retorna verdadeiro para manter o membro.
+ */
+export interface MemberSweepInput {
+  guildID?: string;
+  keep?: (member: MemberInfo, guildID: string) => boolean;
+}
+
+/**
+ * Filtro de limpeza do cache de usuários. Sem `keep`, todos os usuários
+ * do escopo são removidos. `keep` retorna verdadeiro para manter o usuário.
+ */
+export interface UserSweepInput {
+  keep?: (user: UserInfo, userID: string) => boolean;
+}
+
+/** Filtro de limpeza do cache de canais. `keep` retorna verdadeiro para manter o canal. */
+export interface ChannelSweepInput {
+  keep?: (channel: ChannelInfo, channelID: string) => boolean;
+}
+
+/** Filtro de limpeza do cache de servidores. `keep` retorna verdadeiro para manter o servidor. */
+export interface GuildSweepInput {
+  keep?: (guild: GuildInfo, guildID: string) => boolean;
+}
+
+/** Inspeção e limpeza dos caches locais do client. */
+export interface CacheResources {
+  stats(): Promise<CacheStatsInfo>;
+  sweepMessages(input?: MessageSweepInput): Promise<number>;
+  sweepMembers(input?: MemberSweepInput): Promise<number>;
+  sweepUsers(input?: UserSweepInput): Promise<number>;
+  sweepChannels(input?: ChannelSweepInput): Promise<number>;
+  sweepGuilds(input?: GuildSweepInput): Promise<number>;
+  cascadeChannel(channelID: string): Promise<void>;
+  cascadeGuild(guildID: string): Promise<void>;
+}

package/src/ports/resources/channels.ts

@@ -1,3 +1,4 @@
+import type { ThreadDefaultsInput } from './threads.js';
 export interface ChannelInfo {
   id: string;
   name: string;
@@ -9,6 +10,8 @@ export interface ChannelInfo {
   slowmode: number;
   nsfw: boolean;
   url?: string | null;
+  recipientIDs?: string[];
+  ownerID?: string | null;
   contentWarningLevel?: number | null;
   contentWarningText?: string | null;
 }
@@ -47,13 +50,22 @@ export interface ChannelOverwriteInput {
 
 export interface ChannelsResources {
   get(channelID: string): Promise<ChannelInfo>;
+  addRecipient(channelID: string, userID: string): Promise<void>;
+  removeRecipient(channelID: string, userID: string, options?: { silent?: boolean }): Promise<void>;
   list(guildID: string, limit?: number): Promise<ChannelInfo[]>;
   create(guildID: string, input: ChannelCreateInput): Promise<ChannelInfo>;
   edit(channelID: string, input: ChannelEditInput): Promise<ChannelInfo>;
   delete(channelID: string, reason?: string): Promise<void>;
   setSlowmode(channelID: string, seconds: number, reason?: string): Promise<void>;
+  slowmode(channelID: string): Promise<number>;
+  sendTyping(channelID: string): Promise<void>;
+  rtcRegions(channelID: string): Promise<RtcRegionInfo[]>;
   overwrite(channelID: string, targetID: string, input: ChannelOverwriteInput): Promise<void>;
   permissionsFor(guildID: string, channelID: string, userID: string): Promise<string>;
+  editThreadDefaults(channelID: string, input: ThreadDefaultsInput): Promise<void>;
+  setDefaultForumLayout(channelID: string, layout: 'default' | 'list' | 'grid' | null, reason?: string): Promise<void>;
   move(channelID: string, position: number): Promise<void>;
   setCategory(channelID: string, parentID: string | null, reason?: string): Promise<ChannelInfo>;
 }
+
+export interface RtcRegionInfo { id: string; name: string; emoji: string }

package/src/ports/resources/collectors.ts

@@ -5,6 +5,23 @@ export interface AwaitMessageInput {
   signal?: AbortSignal;
 }
 
+export interface CollectMessagesInput {
+  userID?: string;
+  contains?: string;
+  timeMs?: number;
+  max?: number;
+  signal?: AbortSignal;
+}
+
+export interface CollectReactionsInput {
+  messageID: string;
+  emojis?: string | string[];
+  userID?: string;
+  timeMs?: number;
+  max?: number;
+  signal?: AbortSignal;
+}
+
 export interface CollectedMessageInfo {
   id: string;
   channelID: string;
@@ -15,10 +32,13 @@ export interface CollectedMessageInfo {
 export interface ReactionVote {
   userID: string;
   emoji: string;
+  messageID?: string;
 }
 
 export interface CollectorsResources {
   awaitMessage(channelID: string, input: AwaitMessageInput): Promise<CollectedMessageInfo | null>;
   awaitReaction(channelID: string, messageID: string, emojis: string | string[],
     timeMs: number, userID?: string, signal?: AbortSignal): Promise<ReactionVote | null>;
+  collectMessages(channelID: string, input: CollectMessagesInput): AsyncIterable<CollectedMessageInfo>;
+  collectReactions(channelID: string, input: CollectReactionsInput): AsyncIterable<ReactionVote>;
 }

package/src/ports/resources/common.ts

@@ -3,12 +3,14 @@ export interface AttachmentSpec {
   url: string;
   name: string;
   description?: string;
+  spoiler?: boolean;
 }
 
 export interface BinaryAttachmentSpec {
   data: Uint8Array;
   name: string;
   description?: string;
+  spoiler?: boolean;
 }
 
 export type PresenceStatus = 'online' | 'idle' | 'dnd' | 'invisible';

package/src/ports/resources/expressions.ts

@@ -22,6 +22,7 @@ export interface ExpressionsResources {
   stickers(guildID: string): Promise<StickerInfo[]>;
   editEmoji(guildID: string, nameOrID: string, name: string, reason?: string): Promise<EmojiInfo>;
   createSticker(guildID: string, input: StickerCreateInput): Promise<StickerInfo>;
+  createStickersBulk(guildID: string, inputs: StickerCreateInput[]): Promise<StickerBulkResult>;
   editSticker(guildID: string, nameOrID: string, input: StickerEditInput): Promise<StickerInfo>;
   deleteSticker(guildID: string, nameOrID: string, reason?: string): Promise<void>;
   cloneEmoji(guildID: string, sourceID: string): Promise<EmojiInfo>;
@@ -34,6 +35,11 @@ export interface EmojiBulkResult {
   failed: { name: string; error: string }[];
 }
 
+export interface StickerBulkResult {
+  success: StickerInfo[];
+  failed: { name: string; error: string }[];
+}
+
 export interface StickerEditInput {
   name?: string;
   description?: string;

package/src/ports/resources/gateway.ts

@@ -0,0 +1,49 @@
+import type { GatewaySendPayload } from '@fluxerjs/types';
+
+/** Pedido de membros de servidor pelo gateway (opcode 8). */
+export interface GatewayMembersRequest {
+  guildID?: string;
+  guildIDs?: string[];
+  query?: string;
+  limit?: number;
+  userIDs?: string[];
+  presences?: boolean;
+  nonce?: string;
+}
+
+/** Pedido de contagens de membros por canal dentro de um servidor (opcode 16). */
+export interface ChannelCountsRequest {
+  guildID: string;
+  channelID?: string;
+  channelIDs?: string[];
+  nonce?: string;
+}
+
+/** Pedido de não lidos de posts em um canal de fórum ou mídia (opcode 28). */
+export interface ForumUnreadsRequest {
+  guildID: string;
+  channelID: string;
+  threads: { threadID: string; ackMessageID?: string }[];
+}
+
+/** Assinatura de tráfego de threads em um servidor (opcode 14). */
+export interface ThreadSubscriptionInput {
+  guildID: string;
+  threads?: boolean;
+  threadIDs?: string[];
+}
+
+/**
+ * Pedidos brutos ao gateway. São fire-and-forget: os resultados chegam por
+ * eventos do client (ex.: `guildCountsUpdate`, `channelMemberCountsUpdate`,
+ * `forumUnreads`, `threadMemberListUpdate`). Para aguardar a resposta use
+ * `users.guildCounts` e `users.channelCounts`, que encapsulam pedido e espera.
+ */
+export interface GatewayResources {
+  requestMembers(input: GatewayMembersRequest): void;
+  requestGuildCounts(guildIDs: string[], nonce?: string): void;
+  requestChannelCounts(input: ChannelCountsRequest): void;
+  requestForumUnreads(input: ForumUnreadsRequest): void;
+  subscribeThreads(input: ThreadSubscriptionInput): void;
+  send(shardID: number, payload: GatewaySendPayload): void;
+}

package/src/ports/resources/instance.ts

@@ -0,0 +1,109 @@
+/** URLs de endpoint resolvidas da instância Fluxer. */
+export interface InstanceEndpointsInfo {
+  api: string;
+  apiClient: string;
+  apiPublic: string;
+  gateway: string;
+  media: string;
+  staticCDN: string;
+  marketing: string;
+  admin: string;
+  invite: string;
+  gift: string;
+  webapp: string;
+}
+
+/** Flags de recursos do documento de descoberta da instância. */
+export interface InstanceFeaturesInfo {
+  voiceEnabled: boolean;
+  stripeEnabled: boolean;
+  selfHosted: boolean;
+  presignedAttachmentUploads: boolean;
+  emailsEnabled: boolean;
+}
+
+/** Integrações opcionais de terceiros habilitadas na instância. */
+export interface InstanceServicesInfo {
+  gif: boolean;
+  youtube: boolean;
+  bluesky: boolean;
+}
+
+/** Descrição normalizada da instância: endpoints resolvidos e descoberta. */
+export interface InstanceInfo {
+  apiCodeVersion: number | null;
+  codename: string | null;
+  endpoints: InstanceEndpointsInfo;
+  features: InstanceFeaturesInfo | null;
+  registrationMode: 'open' | 'approval' | 'closed' | null;
+  ssoEnabled: boolean | null;
+  ssoEnforced: boolean | null;
+  singleCommunity: boolean | null;
+  singleCommunityGuildID: string | null;
+  directMessagesDisabled: boolean | null;
+  services: InstanceServicesInfo | null;
+}
+
+/** Informações de conexão do gateway (`GET /gateway/bot`). */
+export interface GatewayInfo {
+  url: string;
+  shards: number;
+  sessionStartLimit: {
+    total: number;
+    remaining: number;
+    resetAfter: number;
+    maxConcurrency: number;
+  } | null;
+}
+
+/** Aplicação normalizada de `applications/@me` e `oauth2/applications/@me`. */
+export interface ApplicationInfo {
+  id: string;
+  name: string;
+  icon: string | null;
+  description: string | null;
+  botPublic: boolean | null;
+  botRequireCodeGrant: boolean | null;
+  verifyKey: string | null;
+  flags: number | null;
+  ownerID: string | null;
+  botID: string | null;
+  redirectURIs: string[];
+  clientSecret: string | null;
+}
+
+/** Metadados de emoji (`GET /emojis/{id}/metadata`). */
+export interface EmojiMetadataInfo {
+  id: string;
+  guildID: string;
+  name: string;
+  animated: boolean;
+  allowCloning: boolean;
+}
+
+/** Metadados de sticker (`GET /stickers/{id}/metadata`). */
+export interface StickerMetadataInfo {
+  id: string;
+  guildID: string;
+  name: string;
+  animated: boolean;
+  allowCloning: boolean;
+}
+
+/** Referência de emoji aceita por `resolveEmoji` além do texto. */
+export interface EmojiReference {
+  name: string;
+  id?: string;
+  animated?: boolean;
+}
+
+/** Introspecção da instância, do gateway e da aplicação do client. */
+export interface InstanceResources {
+  describe(): Promise<InstanceInfo>;
+  gatewayInfo(): Promise<GatewayInfo>;
+  application(): Promise<ApplicationInfo>;
+  oauthApplications(): Promise<ApplicationInfo[]>;
+  emojiMetadata(emojiID: string): Promise<EmojiMetadataInfo>;
+  stickerMetadata(stickerID: string): Promise<StickerMetadataInfo>;
+  resolveEmoji(emoji: string | EmojiReference, guildID?: string): Promise<string>;
+}

package/src/ports/resources/messages.ts

@@ -1,4 +1,5 @@
 import type { AttachmentSpec, BinaryAttachmentSpec } from './common.js';
+import type { APIMessage } from '@fluxerjs/types';
 import type { MessageSearchInput, PinnedMessagesInput } from '../../domain/message-query.js';
 import type { ReceivedEmbed } from '../../domain/messages.js';
 export type { MessageSearchInput, PinnedMessagesInput } from '../../domain/message-query.js';
@@ -40,8 +41,17 @@ export interface MessagesResources {
   dm(userID: string, content: string): Promise<string>;
   forward(channelID: string, sourceChannelID: string, messageID: string): Promise<string>;
   search(input: MessageSearchInput): Promise<MessageSearchPage>;
+  searchAll(input: MessageSearchInput): Promise<MessageSearchPage>;
+  bulkFetch(requests: BulkFetchRequest[], input?: BulkFetchInput): Promise<MessageInfo[] | BulkFetchRawChannel[]>;
   sendBytes(channelID: string, files: BinaryAttachmentSpec[], content?: string): Promise<string>;
   sendAttachments(channelID: string, files: (AttachmentSpec | BinaryAttachmentSpec)[], content?: string): Promise<string>;
+  deleteAttachment(channelID: string, messageID: string, attachmentID: string): Promise<void>;
+  sendTo(channelID: string, content: string): Promise<string>;
+  bulkDelete(channelID: string, messageIDs: string[]): Promise<string[]>;
+  bulkDeleteOwn(channelID: string): Promise<void>;
+  acknowledgePins(channelID: string): Promise<void>;
+  clearReadState(channelID: string): Promise<void>;
+  purgeDM(channelID: string): Promise<number>;
 }
 
 export interface MessageCursor { before?: string; after?: string; around?: string }
@@ -62,3 +72,23 @@ export interface MessageSearchPage {
   total: number;
   cursor: string[] | null;
 }
+
+/** Janela de mensagens de um canal dentro de um `bulkFetch`. */
+export interface BulkFetchRequest {
+  channelID: string;
+  limit: number;
+  before?: string;
+  after?: string;
+  around?: string;
+}
+
+export interface BulkFetchInput {
+  /** `false` retorna o payload bruto da API; o padrão hidrata e normaliza. */
+  hydrate?: boolean;
+}
+
+/** Canal do retorno bruto de `bulkFetch` quando `hydrate` é `false`. */
+export interface BulkFetchRawChannel {
+  channelID: string;
+  messages: APIMessage[];
+}

package/src/ports/resources/roles.ts

@@ -5,6 +5,7 @@ export interface RoleInfo {
   position: number;
   permissions: string;
   hoist: boolean;
+  hoistPosition?: number | null;
   mentionable: boolean;
   unicodeEmoji: string | null;
   managed: boolean;
@@ -38,4 +39,6 @@ export interface RolesResources {
   edit(guildID: string, role: string, input: RoleEditInput): Promise<RoleInfo>;
   delete(guildID: string, role: string, reason?: string): Promise<void>;
   move(guildID: string, role: string, position: number): Promise<void>;
+  setRoleHoistPositions(guildID: string, updates: { id: string; position: number | null }[]): Promise<RoleInfo[]>;
+  resetRoleHoistPositions(guildID: string): Promise<RoleInfo[]>;
 }

package/src/ports/resources/self.ts

@@ -0,0 +1,30 @@
+import type { UserInfo } from './users.js';
+
+/** Credenciais para verificação sudo (ações elevadas): senha e/ou MFA. */
+export interface SudoVerification {
+  password?: string;
+  mfaMethod?: 'totp' | 'webauthn';
+  mfaCode?: string;
+  webauthnResponse?: Record<string, unknown>;
+  webauthnChallenge?: string;
+}
+
+/** Servidor parcial retornado por `GET /users/@me/guilds`. */
+export interface SelfGuildInfo {
+  id: string;
+  name: string;
+  icon: string | null;
+  owner: boolean;
+  permissions: string | null;
+  features: string[];
+  memberCount: number | null;
+  onlineCount: number | null;
+}
+
+/** Operações sobre o usuário autenticado (`client.user`). */
+export interface SelfResources {
+  fetch(): Promise<UserInfo>;
+  guilds(input?: { withCounts?: boolean }): Promise<SelfGuildInfo[]>;
+  leaveGuild(guildID: string, verification?: SudoVerification): Promise<void>;
+  deleteMyMessages(guildID: string, verification?: SudoVerification): Promise<void>;
+}

package/src/ports/resources/threads.ts

@@ -48,11 +48,26 @@ export interface ThreadsResources {
   edit(threadID: string, input: ThreadEditInput): Promise<ThreadInfo>;
   join(threadID: string): Promise<void>;
   leave(threadID: string): Promise<void>;
+  setLocked(threadID: string, locked: boolean, reason?: string): Promise<void>;
+  editSelf(threadID: string, input: ThreadSelfEditInput): Promise<ThreadMemberInfo | null>;
+  editDefaults(parentID: string, input: ThreadDefaultsInput): Promise<void>;
   search(channelID: string, input: ThreadSearchInput): Promise<ThreadSearchPage>;
   active(guildID: string): Promise<ThreadListPage>;
   archived(channelID: string, input?: ArchivedThreadsInput): Promise<ThreadListPage>;
 }
 
+export interface ThreadSelfEditInput {
+  flags?: number;
+  muted?: boolean;
+  muteConfig?: { endTime?: string | number | null; selectedTimeWindow: number } | null;
+}
+
+export interface ThreadDefaultsInput {
+  autoArchiveDuration?: number | null;
+  slowmode?: number | null;
+  reason?: string;
+}
+
 export interface ThreadEditInput {
   name?: string;
   archived?: boolean;

package/src/ports/resources/users.ts

@@ -1,4 +1,5 @@
 import type { ActivityInfo, PresenceStatus } from './common.js';
+import type { ChannelInfo } from './channels.js';
 
 export interface UserInfo {
   id: string;
@@ -59,6 +60,13 @@ export interface UsersResources {
   searchMembers(guildID: string, query: string, limit?: number, offset?: number): Promise<MemberSearchPage>;
   setNickname(guildID: string, userID: string, nickname: string | null, reason: string): Promise<MemberInfo>;
   editGuild(guildID: string, input: GuildEditInput): Promise<GuildInfo>;
+  me(guildID: string): Promise<MemberInfo>;
+  transferOwnership(guildID: string, userID: string): Promise<void>;
+  withdrawDiscoveryApplication(guildID: string): Promise<void>;
+  discoveryStatus(guildID: string): Promise<DiscoveryStatusInfo>;
+  applyForDiscovery(guildID: string, input: DiscoveryApplicationInput): Promise<DiscoveryApplicationInfo>;
+  editDiscoveryApplication(guildID: string, input: DiscoveryApplicationInput): Promise<DiscoveryApplicationInfo>;
+  createDM(userID: string): Promise<ChannelInfo>;
   leaveGuild?(guildID: string): Promise<void>;
 }
 
@@ -101,6 +109,31 @@ export interface MemberSearchPage {
   hasMore: boolean;
   indexing: boolean;
 }
+export interface DiscoveryApplicationInput {
+  description?: string;
+  primaryCategoryId?: number | string;
+  keywords?: string[];
+  primaryLanguage?: string;
+}
+
+export interface DiscoveryApplicationInfo {
+  guildID: string;
+  status: string;
+  description: string;
+  categoryType: number;
+  primaryLanguage?: string | null;
+  customTags?: string[];
+  appliedAt?: string;
+  reviewedAt?: string | null;
+  guildNsfwLevel?: number | null;
+}
+
+export interface DiscoveryStatusInfo {
+  application: DiscoveryApplicationInfo | null;
+  eligible: boolean;
+  minMemberCount: number;
+}
+
 export interface GuildEditInput {
   name?: string;
   icon?: string | null;

package/src/ports/resources/webhooks.ts

@@ -12,6 +12,10 @@ export interface WebhookSendInput {
   avatarURL?: string;
 }
 
+export interface WebhookMessageEditInput {
+  content?: string;
+}
+
 export interface WebhooksResources {
   fetch(webhookID: string): Promise<WebhookInfo>;
   create(channelID: string, name: string, reason?: string): Promise<WebhookInfo>;
@@ -19,4 +23,6 @@ export interface WebhooksResources {
   send(webhookID: string, token: string, input: WebhookSendInput): Promise<string | null>;
   edit(webhookID: string, token: string | null, name: string): Promise<void>;
   delete(webhookID: string, token: string | null): Promise<void>;
+  editMessage(webhookID: string, token: string, messageID: string, input: WebhookMessageEditInput): Promise<string>;
+  deleteMessage(webhookID: string, token: string, messageID: string): Promise<void>;
 }

package/src/ports/resources.ts

@@ -1,9 +1,13 @@
+import type { CacheResources } from './resources/cache.js';
 import type { ChannelsResources } from './resources/channels.js';
 import type { CollectorsResources } from './resources/collectors.js';
 import type { ExpressionsResources } from './resources/expressions.js';
+import type { GatewayResources } from './resources/gateway.js';
+import type { InstanceResources } from './resources/instance.js';
 import type { InvitesResources } from './resources/invites.js';
 import type { MessagesResources } from './resources/messages.js';
 import type { RolesResources } from './resources/roles.js';
+import type { SelfResources } from './resources/self.js';
 import type { ThreadsResources } from './resources/threads.js';
 import type { UsersResources } from './resources/users.js';
 import type { WebhooksResources } from './resources/webhooks.js';
@@ -19,4 +23,8 @@ export interface Resources {
   readonly expressions: ExpressionsResources;
   readonly threads: ThreadsResources;
   readonly invites: InvitesResources;
+  readonly gateway: GatewayResources;
+  readonly instance: InstanceResources;
+  readonly self: SelfResources;
+  readonly cache: CacheResources;
 }

package/src/ports/script-engine.ts

@@ -0,0 +1,42 @@
+export interface ScriptLimits { calls: number; depth: number; output: number; timeoutMs: number }
+
+/** Chamada de função `$` vista pela framework; a forma completa vive em `yuzuha/functions`. */
+export interface ScriptFunctionCall {
+  /** O contexto concreto é fornecido pelo engine; em `yuzuha/functions` ele é tipado. */
+  ctx: any;
+  count: number;
+  arg(index: number): Promise<unknown>;
+  fresh(index: number): Promise<unknown>;
+  text(index: number): Promise<string>;
+  all(): Promise<unknown[]>;
+  checkOutput(value: unknown): void;
+  wait<T>(promise: Promise<T>): Promise<T>;
+}
+
+export interface ScriptFunctionDefinition {
+  name: string;
+  aliases?: string[];
+  description: string;
+  category: string;
+  minArgs: number;
+  maxArgs: number;
+  usage: string;
+  execute: (call: ScriptFunctionCall) => unknown | Promise<unknown>;
+}
+
+/**
+ * Motor de function mode instalado no bot. O programa compilado e o contexto
+ * de execução são opacos para a framework; `yuzuha/functions` provê a
+ * implementação de referência via `functions()`.
+ */
+/** Programas compilados executam na engine que compilou o programa. */
+export interface ScriptEngine {
+  readonly limits: Readonly<ScriptLimits>;
+  compile(code: string, name?: string): unknown;
+  execute(program: unknown, ctx: unknown): Promise<unknown>;
+  functions(): ScriptFunctionDefinition[];
+  registerAll(definitions: ScriptFunctionDefinition[]): unknown;
+  /** Cópia temporária para validar instalações antes de confirmá-las. */
+  fork(): ScriptEngine;
+  text(value: unknown): string;
+}

package/src/sdk/builders.ts

@@ -0,0 +1 @@
+export * from '@fluxerjs/builders';

package/src/sdk/client.ts

@@ -0,0 +1 @@
+export * from '@fluxerjs/core/client';

package/src/sdk/cluster.ts

@@ -0,0 +1 @@
+export * from '@fluxerjs/core/cluster';

package/src/sdk/collection.ts

@@ -0,0 +1 @@
+export * from '@fluxerjs/collection';

package/src/sdk/errors.ts

@@ -0,0 +1 @@
+export * from '@fluxerjs/core/errors';

package/src/sdk/internal.ts

@@ -0,0 +1 @@
+export * from '@fluxerjs/core/internal';

package/src/sdk/message.ts

@@ -0,0 +1 @@
+export * from '@fluxerjs/core/message';

package/src/sdk/rest/request-manager.ts

@@ -0,0 +1 @@
+export * from '@fluxerjs/rest/request-manager';

package/src/sdk/rest.ts

@@ -0,0 +1 @@
+export * from '@fluxerjs/rest';