@squord/sdk 0.0.0-stage → 0.1.0

package/dist/api-DbHoBFJY.d.cts

@@ -0,0 +1,726 @@
+/**
+ * Tipos primitivos usados em toda a API do Squord.
+ *
+ * Convenções da plataforma (https://docs.squord.com.br/referencia/convencoes):
+ * - Todo id é uma **string** opaca (Snowflake decimal de até 20 dígitos, ou o
+ *   formato antigo de 24 caracteres hexadecimais). Nunca converta para número.
+ * - Datas em ISO 8601, UTC.
+ * - Permissões trafegam como **string decimal** e devem ser calculadas com
+ *   `BigInt` (veja {@link Permissions}).
+ */
+/** Id opaco de qualquer entidade do Squord. Trate como string. */
+type Snowflake = string;
+/** Data no formato ISO 8601 em UTC, ex.: `"2026-10-05T14:30:00.000Z"`. */
+type ISODate = string;
+/** Conjunto de permissões como string decimal. Calcule com `BigInt`. */
+type PermissionBits = string;
+/** Cursor opaco de paginação gerado pela API. */
+type Cursor = string;
+/** Menções permitidas em uma mensagem. Seguras por padrão. */
+interface AllowedMentions {
+    /** Menções de pessoas (`<@id>`) notificam. Padrão: `true`. */
+    users?: boolean;
+    /** Menções de cargos (`<@&id>`) notificam. Padrão: `false` (removidas do texto). */
+    roles?: boolean;
+    /** `@everyone` notifica. Padrão: `false` (vira texto simples). */
+    everyone?: boolean;
+}
+/** Formato de página devolvido pelas rotas paginadas por cursor. */
+interface Page<T> {
+    /** Itens da página. */
+    items: T[];
+    /** Passe como `before` para a página anterior (mais antiga). `null` no início. */
+    prevCursor: Cursor | null;
+    /** Passe como `after` para a página seguinte (mais nova). `null` no fim. */
+    nextCursor: Cursor | null;
+    /** Se há mais itens na direção consultada. */
+    hasMore: boolean;
+}
+/** Parâmetros de listagem com paginação por cursor. */
+interface CursorPaginationParams {
+    /** Tamanho da página (padrão e máximo dependem da rota). */
+    limit?: number;
+    /** Cursor da resposta anterior: devolve a página mais antiga. */
+    before?: Cursor;
+    /** Cursor da resposta anterior: devolve a página mais nova. */
+    after?: Cursor;
+}
+/** Chave de idempotência de mensagens: repetir o envio com o mesmo `nonce` devolve a mensagem original. */
+type Nonce = string;
+
+/**
+ * Tipos dos payloads reais da API REST do Squord (v1).
+ *
+ * Espelham o contrato publicado em https://docs.squord.com.br (OpenAPI).
+ * Todos os objetos trafegam em JSON UTF-8 com campos em `camelCase`.
+ */
+
+/** Flags de uma conta, somadas em `flags`. */
+declare const UserFlags: {
+    readonly STAFF: number;
+    readonly EARLY_SUPPORTER: number;
+    readonly VERIFIED_BOT: number;
+    readonly SYSTEM: number;
+    readonly VERIFIED: number;
+    readonly BOT: number;
+};
+/** Estilo de nome de usuário (Squord Plus). */
+interface APIUserNameStyle {
+    font: string;
+    effect: string;
+    colors: string[];
+}
+/** Perfil público de uma conta, embutido em mensagens, membros e interações. */
+interface APIUser {
+    id: Snowflake;
+    /** Handle único em minúsculas. O de um bot começa com `bot~`. */
+    username: string;
+    displayName: string;
+    avatarUrl: string | null;
+    /** Só preenchido enquanto o usuário tem Squord Plus. */
+    avatarAnimatedUrl: string | null;
+    nameStyle: APIUserNameStyle | null;
+    flags: number;
+    deleted: boolean;
+    suspended: boolean;
+    premium: boolean;
+}
+/** Visão da própria conta (`GET /users/@me`). Em um bot, quase tudo é padrão. */
+interface APICurrentUser extends APIUser {
+    email: string | null;
+    [key: string]: unknown;
+}
+/** O bot na visão do dono (`GET /bots/@me`). */
+interface APIBot {
+    id: Snowflake;
+    user: APIUser;
+    description: string | null;
+    ownerUsername: string;
+    public: boolean;
+    verified: boolean;
+    installCount: number;
+    termsUrl: string | null;
+    privacyUrl: string | null;
+    createdAt: ISODate;
+    /** Soma de bits das intents configuradas (veja {@link Intents}). */
+    intents?: number;
+}
+/** Flags de um Space, somadas em `flags`. */
+declare const GuildFlags: {
+    readonly OFFICIAL: number;
+    readonly PARTNER: number;
+    readonly DISCOVERY_BLOCKED: number;
+    readonly VERIFIED: number;
+    readonly DISCOVERY_AGE_WAIVED: number;
+};
+/** Uma regra publicada do Space. */
+interface APIGuildRule {
+    title: string;
+    description: string;
+}
+/** O bot (ou quem chama) dentro de um Space. */
+interface APIGuildSelf {
+    memberId: Snowflake;
+    roleIds: Snowflake[];
+    /** Permissões no nível do Space (overwrites de canal ainda se aplicam). */
+    permissions: PermissionBits;
+    isOwner: boolean;
+}
+/** Um Space: comunidade com membros, cargos, canais e regras próprias. */
+interface APIGuild {
+    id: Snowflake;
+    ownerId: Snowflake;
+    name: string;
+    slug: string;
+    description: string | null;
+    iconUrl: string | null;
+    iconAnimatedUrl: string | null;
+    bannerUrl: string | null;
+    bannerAnimatedUrl: string | null;
+    bannerPlaceholder: string | null;
+    defaultChannelId: Snowflake | null;
+    systemChannelId: Snowflake | null;
+    visibility: string;
+    verificationLevel: string;
+    accessMode: "INVITE_ONLY" | "LINK" | "REQUEST";
+    requireVerifiedEmail: boolean;
+    requireTwoFactor: boolean;
+    moderationMfaRequired: boolean;
+    joinRequestRoleIds: Snowflake[];
+    requireJoinMessage: boolean;
+    joinRequestRetryDays: number;
+    /** Quantas pessoas são membros (não conta bots nem webhooks). */
+    memberCount: number;
+    flags: number;
+    planId: string;
+    vanityLapsesAt: ISODate | null;
+    vanityInvite: boolean;
+    boostCount: number;
+    boostLevel: number;
+    boostMessages: boolean;
+    discoveryCategory: string | null;
+    locale: string | null;
+    rules: APIGuildRule[];
+    rulesUpdatedAt: ISODate | null;
+    discoverable: boolean;
+    discoverableSince: ISODate | null;
+    minAccountAgeDays: number;
+    createdAt: ISODate;
+    updatedAt: ISODate;
+    self: APIGuildSelf;
+}
+type ChannelType = "TEXT" | "ANNOUNCEMENT" | "CATEGORY" | "FORUM" | "VOICE" | "STAGE" | "THREAD";
+/** Exceção de permissão de um cargo ou membro em um canal. */
+interface APIChannelOverwrite {
+    targetId: Snowflake;
+    targetType: "ROLE" | "MEMBER";
+    allow: PermissionBits;
+    deny: PermissionBits;
+}
+/** Tag de um canal de fórum. */
+interface APIForumTag {
+    id: Snowflake;
+    name: string;
+    emoji: string | null;
+    moderated: boolean;
+}
+/** Um canal do Space (threads têm o formato próprio {@link APIThread}). */
+interface APIChannel {
+    id: Snowflake;
+    guildId: Snowflake;
+    categoryId: Snowflake | null;
+    name: string;
+    type: ChannelType;
+    position: number;
+    topic: string | null;
+    topicUpdatedAt: ISODate | null;
+    topicUpdatedById: Snowflake | null;
+    isPrivate: boolean;
+    /** Modo lento: segundos entre mensagens. `0` desliga. */
+    rateLimitPerUser: number;
+    bitrate: number | null;
+    userLimit: number | null;
+    chatEnabled: boolean;
+    lastMessageId: Snowflake | null;
+    overwrites: APIChannelOverwrite[];
+    availableTags: APIForumTag[];
+    requireTag: boolean;
+    defaultAutoArchiveMinutes: number | null;
+    createdAt: ISODate;
+    updatedAt: ISODate;
+}
+/** Um grupo da árvore de canais de um Space. */
+interface APIChannelTreeNode {
+    category: APIChannel | null;
+    channels: APIChannel[];
+}
+type ThreadAutoArchiveMinutes = 60 | 1440 | 4320 | 10080;
+/** A primeira mensagem de um post de fórum, como o card mostra. */
+interface APIThreadPostPreview {
+    messageId: Snowflake;
+    author: APIUser;
+    content: string;
+    hasAttachment: boolean;
+    hasImage: boolean;
+    hasSticker: boolean;
+    deleted: boolean;
+    moderated: boolean;
+}
+/** Uma thread ou post de fórum. Use o `id` como `channelId` nas rotas de mensagem. */
+interface APIThread {
+    id: Snowflake;
+    guildId: Snowflake;
+    type: "THREAD";
+    /** Canal de texto, de anúncios ou fórum de onde ela parte. */
+    parentId: Snowflake;
+    name: string;
+    ownerId: Snowflake;
+    starterMessageId: Snowflake | null;
+    isForumPost: boolean;
+    archived: boolean;
+    archivedAt: ISODate | null;
+    locked: boolean;
+    autoArchiveMinutes: ThreadAutoArchiveMinutes;
+    rateLimitPerUser: number;
+    messageCount: number;
+    lastMessageId: Snowflake | null;
+    lastMessageAt: ISODate;
+    appliedTagIds: Snowflake[];
+    postPreview: APIThreadPostPreview | null;
+    createdAt: ISODate;
+    updatedAt: ISODate;
+}
+interface APIThreadPage extends Page<APIThread> {
+}
+/** Corpo de criar thread em canal de texto/anúncios ou a partir de uma mensagem. */
+interface APIThreadCreateBody {
+    name: string;
+    autoArchiveMinutes?: ThreadAutoArchiveMinutes;
+    rateLimitPerUser?: number;
+}
+/** Corpo de criar um post em fórum. */
+interface APIForumPostCreateBody {
+    name: string;
+    /** A primeira mensagem: corpo de criar mensagem, sem `replyToId`. */
+    message: APIMessageCreateBody;
+    appliedTagIds?: Snowflake[];
+    autoArchiveMinutes?: ThreadAutoArchiveMinutes;
+}
+interface APIThreadListParams extends CursorPaginationParams {
+    /** `true` lista as arquivadas; `false` (padrão), as ativas. */
+    archived?: "true" | "false";
+    /** Só em fórum: posts com esta tag. */
+    tagId?: Snowflake;
+}
+type RoleManagedKind = "BOOSTER" | "BOT";
+/** Um cargo agrupa permissões e uma aparência. Hierárquico por `position`. */
+interface APIRole {
+    id: Snowflake;
+    guildId: Snowflake;
+    name: string;
+    color: string | null;
+    position: number;
+    permissions: PermissionBits;
+    hoist: boolean;
+    mentionable: boolean;
+    managed: boolean;
+    managedKind: RoleManagedKind | null;
+    botId: Snowflake | null;
+    icon: string | null;
+    selfAssignable: boolean;
+    createdAt: ISODate;
+    updatedAt: ISODate;
+}
+type MemberType = "INTERNAL" | "BOT" | "WEBHOOK";
+interface APIMemberNameStyle {
+    font: string;
+    effect: string;
+    colors: string[];
+}
+/** Perfil de um usuário dentro de um Space, com o `user` embutido. */
+interface APIMember {
+    id: Snowflake;
+    guildId: Snowflake;
+    userId: Snowflake;
+    user: APIUser;
+    type: MemberType;
+    nickname: string | null;
+    avatarUrl: string | null;
+    avatarAnimatedUrl: string | null;
+    bannerUrl: string | null;
+    bannerAnimatedUrl: string | null;
+    bio: string | null;
+    bioEmojis: Array<{
+        id: Snowflake;
+        name: string;
+        animated: boolean;
+        url: string;
+    }>;
+    nameStyle: APIMemberNameStyle | null;
+    profileFont: string | null;
+    profileTheme: string[] | null;
+    roleIds: Snowflake[];
+    joinedAt: ISODate;
+    timeoutUntil: ISODate | null;
+    deaf: boolean;
+    mute: boolean;
+    pending: boolean;
+    boostingSince: ISODate | null;
+    createdAt: ISODate;
+    updatedAt: ISODate;
+}
+interface APIMemberPage extends Page<APIMember> {
+}
+/** Corpo de `PATCH /guilds/{guildId}/members/{userId}` (todos os campos opcionais). */
+interface APIMemberEditBody {
+    /** `null` limpa o apelido. */
+    nickname?: string | null;
+    /** **Substitui** o conjunto de cargos. */
+    roleIds?: Snowflake[];
+    /** Data futura aplica timeout; `null` retira. */
+    timeoutUntil?: ISODate | null;
+    deaf?: boolean;
+    mute?: boolean;
+}
+interface APIMemberBanBody {
+    reason?: string | null;
+    /** Quanto do histórico recente apagar, em segundos (até 7 dias). */
+    deleteMessageSeconds?: number;
+}
+/** Um banimento. */
+interface APIMemberBan {
+    id: Snowflake;
+    guildId: Snowflake;
+    userId: Snowflake;
+    moderatorId: Snowflake;
+    byPlatform: boolean;
+    reason: string | null;
+    createdAt: ISODate;
+}
+type MessageType = "DEFAULT" | "REPLY" | "POLL" | "SYSTEM_MEMBER_JOIN" | "SYSTEM_MEMBER_LEAVE" | "SYSTEM_CHANNEL_PINNED" | "SYSTEM_CALL_STARTED" | "SYSTEM_GROUP_CREATED" | "SYSTEM_MEMBER_ADDED" | "SYSTEM_MEMBER_REMOVED" | "SYSTEM_GROUP_LEFT" | "SYSTEM_CHANNEL_FOLLOWED" | "SYSTEM_GUILD_BOOST" | "SYSTEM_THREAD_CREATED" | "SYSTEM_AUTOMOD_ALERT";
+type AttachmentScanStatus = "NOT_REQUIRED" | "PENDING" | "CLEAN" | "INFECTED" | "FAILED" | "EXPLICIT";
+/** Arquivo anexado a uma mensagem. Para enviar, veja {@link APIUpload}. */
+interface APIAttachment {
+    id: Snowflake;
+    kind: string;
+    source: "UPLOAD" | "KLIPY";
+    providerId: string | null;
+    filename: string;
+    contentType: string;
+    size: number;
+    url: string;
+    thumbnailUrl: string | null;
+    width: number | null;
+    height: number | null;
+    durationMs: number | null;
+    placeholder: string | null;
+    scanStatus: AttachmentScanStatus;
+}
+/** Embed como é **lido**. O que se envia usa {@link APIEmbedInput}. */
+interface APIEmbed {
+    type: "RICH" | "LINK" | "IMAGE" | "VIDEO";
+    url: string | null;
+    title: string | null;
+    description: string | null;
+    siteName: string | null;
+    thumbnailUrl: string | null;
+    color: string | null;
+    author: {
+        name: string;
+        url?: string | null;
+        iconUrl?: string | null;
+    } | null;
+    fields: Array<{
+        name: string;
+        value: string;
+        inline?: boolean;
+    }>;
+    image: {
+        url: string;
+    } | null;
+    footer: {
+        text: string;
+        iconUrl?: string | null;
+    } | null;
+    timestamp: ISODate | null;
+    video: {
+        url: string;
+    } | null;
+}
+/** Embed que se **envia** (formato aceito pelo Squord). */
+interface APIEmbedInput {
+    title?: string | null;
+    description?: string | null;
+    /** Só `http://` ou `https://`. */
+    url?: string | null;
+    /** Inteiro de 0 a 16777215, ou `#rrggbb`. */
+    color?: number | string | null;
+    /** ISO 8601 com fuso. */
+    timestamp?: string | null;
+    author?: {
+        name: string;
+        url?: string | null; /** snake_case na API. */
+        icon_url?: string | null;
+    } | null;
+    footer?: {
+        text: string;
+        icon_url?: string | null;
+    } | null;
+    image?: {
+        url: string;
+    } | null;
+    thumbnail?: {
+        url: string;
+    } | null;
+    fields?: Array<{
+        name: string;
+        value: string;
+        inline?: boolean;
+    }>;
+}
+interface APIReaction {
+    /** Emoji Unicode, ou `<:nome:id>` / `<a:nome:id>` para um personalizado. */
+    emoji: string;
+    count: number;
+    userIds: Snowflake[];
+    me: boolean;
+}
+interface APIMessageEmoji {
+    id: Snowflake;
+    name: string;
+    animated: boolean;
+    url: string;
+}
+interface APIMessageMentions {
+    userIds: Snowflake[];
+    roleIds: Snowflake[];
+    channelIds: Snowflake[];
+    everyone: boolean;
+}
+interface APIMessageInteractionMeta {
+    id: Snowflake;
+    type: string;
+    name: string | null;
+    userId: Snowflake;
+}
+interface APIStickerItem {
+    id: Snowflake;
+    guildId: Snowflake;
+    name: string;
+    format: string;
+    url: string;
+}
+/** A mensagem citada em uma resposta. */
+interface APIMessageReplyTo {
+    id: Snowflake;
+    authorId: Snowflake;
+    author: APIUser;
+    content: string;
+    deleted: boolean;
+    moderated: boolean;
+    preview?: Record<string, unknown>;
+}
+/** Uma mensagem com o autor. */
+interface APIMessage {
+    id: Snowflake;
+    /** `null` em mensagem direta (bots não acessam DMs). */
+    guildId: Snowflake | null;
+    channelId: Snowflake;
+    authorId: Snowflake;
+    type: MessageType;
+    content: string;
+    replyToId: Snowflake | null;
+    attachments: APIAttachment[];
+    embeds: APIEmbed[];
+    components: APIComponentRow[];
+    interaction: APIMessageInteractionMeta | null;
+    mentions: APIMessageMentions;
+    reactions: APIReaction[];
+    pinned: boolean;
+    editedAt: ISODate | null;
+    deletedAt: ISODate | null;
+    moderated: boolean;
+    nonce: Nonce | null;
+    call: Record<string, unknown> | null;
+    poll: Record<string, unknown> | null;
+    forward: Record<string, unknown> | null;
+    relay: Record<string, unknown> | null;
+    relayedCount: number | null;
+    stickers: APIStickerItem[];
+    emojis: APIMessageEmoji[];
+    thread: Record<string, unknown> | null;
+    automod: Record<string, unknown> | null;
+    createdAt: ISODate;
+    updatedAt: ISODate;
+    author: APIUser;
+    memberNickname: string | null;
+    memberAvatarUrl: string | null;
+    memberNameStyle: APIMemberNameStyle | null;
+    replyTo: APIMessageReplyTo | null;
+}
+interface APIMessagePage extends Page<APIMessage> {
+}
+/** Corpo de criar mensagem. Ao menos um entre `content`, `embeds`, `components` e `attachmentIds`. */
+interface APIMessageCreateBody {
+    content?: string;
+    embeds?: APIEmbedInput[];
+    components?: APIComponentRow[];
+    allowedMentions?: AllowedMentions;
+    replyToId?: Snowflake | null;
+    attachmentIds?: Snowflake[];
+    /** Chave de idempotência (até 64 caracteres): repetir devolve a original. */
+    nonce?: Nonce | null;
+}
+/** Corpo de editar mensagem. `embeds`/`components` substituem a lista inteira. */
+interface APIMessageEditBody {
+    content?: string;
+    embeds?: APIEmbedInput[];
+    components?: APIComponentRow[];
+    allowedMentions?: AllowedMentions;
+}
+interface APIMessageListParams extends CursorPaginationParams {
+}
+type ButtonStyle = "primary" | "secondary" | "danger" | "link";
+interface APIButton {
+    type: "button";
+    style: ButtonStyle;
+    label: string;
+    customId?: string;
+    url?: string;
+    disabled?: boolean;
+}
+interface APISelectOption {
+    label: string;
+    value: string;
+    description?: string;
+}
+interface APISelectMenu {
+    type: "select";
+    customId: string;
+    placeholder?: string;
+    minValues?: number;
+    maxValues?: number;
+    disabled?: boolean;
+    options: APISelectOption[];
+}
+/** Uma linha de componentes: 1 a 5 botões **ou** exatamente 1 menu. */
+interface APIComponentRow {
+    type: "row";
+    components: Array<APIButton | APISelectMenu>;
+}
+type CommandOptionType = "STRING" | "INTEGER" | "BOOLEAN" | "USER" | "CHANNEL" | "ROLE";
+interface APICommandOptionChoice {
+    name: string;
+    value: string | number;
+}
+/** Uma opção na **definição** de um comando. */
+interface APICommandOptionInput {
+    type: CommandOptionType;
+    /** Letras minúsculas, números, `_` e `-` (até 32 caracteres). */
+    name: string;
+    description: string;
+    required?: boolean;
+    choices?: APICommandOptionChoice[];
+}
+/** Uma opção no objeto comando devolvido pela API. */
+interface APICommandOption extends APICommandOptionInput {
+    required: boolean;
+}
+/** Um comando de barra registrado por um bot. */
+interface APICommand {
+    id: Snowflake;
+    botId: Snowflake;
+    guildId: Snowflake | null;
+    name: string;
+    description: string;
+    options: APICommandOption[];
+    updatedAt: ISODate;
+}
+/** Um comando no corpo do `PUT` em bloco. */
+interface APICommandInput {
+    name: string;
+    description: string;
+    options?: APICommandOptionInput[];
+}
+type InteractionType = "COMMAND" | "COMPONENT";
+type InteractionCallbackType = "MESSAGE" | "DEFERRED" | "UPDATE" | "DEFERRED_UPDATE";
+/** Dados de um comando invocado: as opções já validadas pelo Squord. */
+interface APIInteractionCommandData {
+    id: Snowflake;
+    name: string;
+    options: Array<{
+        name: string;
+        type: CommandOptionType;
+        value: string | number | boolean;
+    }>;
+}
+/** Dados de um clique/uso de componente. */
+interface APIInteractionComponentData {
+    messageId: Snowflake;
+    customId: string;
+    type: "button" | "select";
+    /** Valores escolhidos em um menu; vazio em um botão. */
+    values: string[];
+}
+/** O `d` do evento `interaction.created`. Nenhuma rota REST devolve este objeto. */
+interface APIInteraction {
+    id: Snowflake;
+    /** Credencial da interação, válida por 15 minutos. Trate como segredo. */
+    token: string;
+    type: InteractionType;
+    guildId: Snowflake;
+    channelId: Snowflake;
+    user: APIUser;
+    member: APIMember | null;
+    command?: APIInteractionCommandData;
+    component?: APIInteractionComponentData;
+    createdAt: ISODate;
+}
+/** Dados da resposta de uma interação ou follow-up. */
+interface APIInteractionReplyData {
+    content?: string;
+    embeds?: APIEmbedInput[];
+    components?: APIComponentRow[];
+    allowedMentions?: AllowedMentions;
+    /** Só a pessoa que invocou vê. Não é salva; só aceita botões de link. */
+    ephemeral?: boolean;
+}
+interface APIInteractionCallbackBody {
+    type: InteractionCallbackType;
+    data?: APIInteractionReplyData;
+}
+/** Estado de um upload. */
+type UploadStatus = "PENDING" | "READY" | "ATTACHED";
+/** Um upload reservado/confirmado. */
+interface APIUpload {
+    id: Snowflake;
+    scope: string;
+    filename: string;
+    contentType: string;
+    size: number;
+    status: UploadStatus;
+    url: string | null;
+    thumbnailUrl: string | null;
+    guildId: Snowflake | null;
+    storageKey: string;
+    scanStatus: AttachmentScanStatus;
+    animated: boolean;
+    animatedUrl: string | null;
+    createdAt: ISODate;
+    expiresAt: ISODate;
+}
+/** Alvo do `PUT` dos bytes, devolvido só na reserva. */
+interface APIUploadTarget {
+    uploadUrl: string;
+    method: "PUT";
+    /** Cabeçalhos que o `PUT` precisa repetir exatamente. */
+    headers: Record<string, string>;
+    storageKey: string;
+    publicUrl: string;
+    expiresAt: ISODate;
+}
+interface APIUploadReservation {
+    upload: APIUpload;
+    target: APIUploadTarget;
+}
+interface APIUploadCreateBody {
+    /** Para bots, sempre `attachments`. */
+    scope: string;
+    filename: string;
+    contentType: string;
+    size: number;
+    guildId: Snowflake | null;
+}
+/** Corpo da confirmação de upload. Pode ser `{}`. */
+interface APIUploadConfirmBody {
+    crop?: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    } | null;
+    placeholder?: string | null;
+}
+/** Envelope de todo erro da API. Decida pelo `code`, nunca pela `message`. */
+interface APIErrorBody {
+    statusCode: number;
+    code: string;
+    message: string;
+    details?: unknown;
+    requestId?: string;
+}
+/** Item de validação de um `422 VALIDATION_FAILED`. */
+interface APIValidationIssue {
+    path: string;
+    code: string;
+    message: string;
+    params?: Record<string, unknown>;
+}
+/** Menção de pessoa: `<@ID>`. */
+declare function userMention(id: Snowflake): string;
+/** Menção de cargo: `<@&ID>`. */
+declare function roleMention(id: Snowflake): string;
+/** Menção de canal: `<#ID>`. */
+declare function channelMention(id: Snowflake): string;
+
+export { type APIValidationIssue as $, type APIButton as A, type ButtonStyle as B, type CursorPaginationParams as C, type APIMemberBan as D, type APIMessage as E, type APIMessageListParams as F, type APIMessagePage as G, type APIReaction as H, type ISODate as I, type APIUploadCreateBody as J, type APIUploadReservation as K, type APIUploadConfirmBody as L, type APIUpload as M, type APIUser as N, type MessageType as O, type ChannelType as P, type APIInteraction as Q, type APIInteractionCommandData as R, type Snowflake as S, type ThreadAutoArchiveMinutes as T, type APIInteractionComponentData as U, type CommandOptionType as V, type PermissionBits as W, type APIChannelOverwrite as X, type APICommandOptionInput as Y, type Page as Z, type APIErrorBody as _, type APISelectOption as a, type APIAttachment as a0, type APICommandOption as a1, type APICommandOptionChoice as a2, type APIForumTag as a3, type APIGuildRule as a4, type APIGuildSelf as a5, type APIMessageEditBody as a6, type APIMessageReplyTo as a7, type APIUploadTarget as a8, type AttachmentScanStatus as a9, type Cursor as aa, GuildFlags as ab, type InteractionCallbackType as ac, type InteractionType as ad, type MemberType as ae, type Nonce as af, type RoleManagedKind as ag, type UploadStatus as ah, UserFlags as ai, channelMention as aj, roleMention as ak, userMention as al, type APISelectMenu as b, type APIComponentRow as c, type APIEmbedInput as d, type APIEmbed as e, type AllowedMentions as f, type APIMessageCreateBody as g, type APICommand as h, type APICommandInput as i, type APIBot as j, type APICurrentUser as k, type APIChannel as l, type APIChannelTreeNode as m, type APIThreadCreateBody as n, type APIThread as o, type APIForumPostCreateBody as p, type APIThreadListParams as q, type APIThreadPage as r, type APIInteractionCallbackBody as s, type APIInteractionReplyData as t, type APIGuild as u, type APIMember as v, type APIMemberPage as w, type APIMemberEditBody as x, type APIRole as y, type APIMemberBanBody as z };