lunibee 0.2.1 → 0.2.3

package/dist/managers/member.d.ts

@@ -2,6 +2,8 @@ import { REST } from "@lunibee/rest";
 import { GuildMember, type ResourceContext } from "@lunibee/structures";
 import { ResourceManager } from "./base.js";
 export interface MemberEditOptions {
+    /** Audit-log reason. */
+    reason?: string;
     nick?: string | null;
     roles?: string[];
     mute?: boolean;
@@ -23,9 +25,9 @@ export declare class GuildMemberManager extends ResourceManager<string, GuildMem
     kick(userId: string, reason?: string): Promise<void>;
     /** Bans a user from the guild. */
     ban(userId: string, options?: BanOptions): Promise<void>;
-    /** Unbans a user from the guild. */
-    unban(userId: string): Promise<void>;
-    /** Edits a guild member (nickname, roles, timeout, mute, deaf). @param reason Audit-log reason. */
+    /** Unbans a user from the guild. @param reason Audit-log reason. */
+    unban(userId: string, reason?: string): Promise<void>;
+    /** Edits a guild member (nickname, roles, timeout, mute, deaf). Put the audit-log reason in `options.reason`. @param reason Deprecated: use `options.reason`. Removed in 0.3.0. */
     edit(userId: string, options: MemberEditOptions, reason?: string): Promise<GuildMember>;
     /** Adds a role to a member. @param reason Audit-log reason. */
     addRole(userId: string, roleId: string, reason?: string): Promise<void>;

package/dist/managers/message.d.ts

@@ -21,13 +21,17 @@ export type MessageCreateOptions = Record<string, unknown> & {
     files?: MessageFile[];
 };
 export type MessageEditOptions = MessageCreateOptions;
-/** Splits `files` out of a message payload into a REST upload, encoding string data as UTF-8. */
-export declare function toRequest(options: MessageCreateOptions): unknown;
+/**
+ * Splits `files` out of a message payload into a REST upload, encoding string
+ * data as UTF-8. `allowedMentions` is the client's default, applied only when
+ * the payload has no `allowed_mentions` of its own.
+ */
+export declare function toRequest(options: MessageCreateOptions, allowedMentions?: unknown): unknown;
 export declare class MessageManager {
     #private;
     /** Cached messages; always empty unless a message cache is configured. */
     readonly cache: Collection<string, Message>;
-    constructor(rest: REST, context: ResourceContext, channelId: string, cache?: MessageCacheOptions);
+    constructor(rest: REST, context: ResourceContext, channelId: string, cache?: MessageCacheOptions, allowedMentions?: unknown);
     resolve(messageId: string): Promise<Message>;
     send(options: MessageCreateOptions): Promise<Message>;
     fetch(messageId: string): Promise<Message>;

package/dist/managers/role.d.ts

@@ -29,6 +29,18 @@ export declare class RoleManager extends ResourceManager<string, Role> {
     create(options: RoleCreateOptions): Promise<Role>;
     /** Edits an existing role. */
     edit(roleId: string, options: RoleEditOptions): Promise<Role>;
-    /** Deletes a role from the guild. */
+    /** Deletes a role. @param reason Audit-log reason. */
+    remove(roleId: string, reason?: string): Promise<void>;
+    /**
+     * Moves roles in the hierarchy. Discord shifts the other roles around them.
+     * @param positions Each role's ID and its new position.
+     * @param reason Audit-log reason.
+     * @returns Every role in the guild, in their new order.
+     */
+    setPositions(positions: readonly {
+        id: string;
+        position: number;
+    }[], reason?: string): Promise<Role[]>;
+    /** @deprecated Use {@link RoleManager.remove}, which also takes an audit-log reason. Removed in 0.3.0. */
     deleteRole(roleId: string): Promise<void>;
 }

package/dist/rest/error-codes.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Discord JSON error codes that bots commonly handle, by name, for comparing
+ * with `RESTError.code`: `if (error.code === RESTErrorCode.UnknownMessage) …`.
+ *
+ * Values are from Discord's "JSON Error Codes" table
+ * (discord/discord-api-docs, developers/topics/opcodes-and-status-codes.mdx,
+ * checked at commit 86f0a46). Any other code is still available as a number
+ * on `RESTError.code`.
+ */
+export declare const RESTErrorCode: {
+    readonly UnknownAccount: 10001;
+    readonly UnknownChannel: 10003;
+    readonly UnknownGuild: 10004;
+    readonly UnknownInvite: 10006;
+    readonly UnknownMember: 10007;
+    readonly UnknownMessage: 10008;
+    readonly UnknownPermissionOverwrite: 10009;
+    readonly UnknownRole: 10011;
+    readonly UnknownUser: 10013;
+    readonly UnknownEmoji: 10014;
+    readonly UnknownWebhook: 10015;
+    readonly UnknownBan: 10026;
+    readonly UnknownSticker: 10060;
+    readonly UnknownInteraction: 10062;
+    readonly UnknownScheduledEvent: 10070;
+    readonly BotsCannotUseEndpoint: 20001;
+    readonly MaxGuilds: 30001;
+    readonly MaxPins: 30003;
+    readonly MaxRoles: 30005;
+    readonly MaxWebhooks: 30007;
+    readonly MaxEmojis: 30008;
+    readonly MaxReactions: 30010;
+    readonly MaxChannels: 30013;
+    readonly InteractionAlreadyAcknowledged: 40060;
+    readonly MissingAccess: 50001;
+    readonly CannotExecuteInDM: 50003;
+    readonly CannotEditOthersMessage: 50005;
+    readonly CannotSendEmptyMessage: 50006;
+    readonly CannotSendMessagesToUser: 50007;
+    readonly MissingPermissions: 50013;
+    readonly InvalidToken: 50014;
+    readonly MessageTooOldToBulkDelete: 50034;
+    readonly InvalidFormBody: 50035;
+    readonly ThreadArchived: 50083;
+    readonly CannotReplyWithoutReadHistory: 160002;
+};
+/** One {@link RESTErrorCode} value, usable as a type. */
+export type RESTErrorCode = (typeof RESTErrorCode)[keyof typeof RESTErrorCode];

package/dist/rest/errors.d.ts

@@ -34,6 +34,7 @@ export declare class RESTError extends Error {
     /** Raw Discord validation/error payload. */ readonly errors?: unknown;
     /** HTTP method used for the failed request. */ readonly method?: string;
     /** API path used for the failed request. */ readonly path?: string;
+    /** What to check next, for errors with a common cause (missing access or permissions). */ readonly hint?: string;
     /** Creates a REST error with request context. @param message Error message. @param status HTTP status. @param code Discord error code. @param errors Raw error payload. @param options Request context and cause. */
     constructor(message: string, status: number, code?: number, errors?: unknown, options?: {
         method?: string;

package/dist/rest/index.d.ts

@@ -161,6 +161,7 @@ export declare class REST {
 }
 export { Routes } from "./routes.js";
 export { RESTError, abortError, redactPath, type RESTErrorKind, } from "./errors.js";
+export { RESTErrorCode } from "./error-codes.js";
 export { createRouteKey, normalizeRoutePath, majorParameter, scopeBucket, serializeQuery, type RouteKey, type RESTQuery, } from "./route.js";
 export { RequestScheduler } from "./scheduler.js";
 export { RateLimiter } from "./limiter.js";

package/dist/rest/index.js

@@ -2,12 +2,15 @@
 // packages/rest/package.json
 var package_default = {
   name: "@lunibee/rest",
-  version: "0.2.1",
+  version: "0.2.3",
   type: "module",
   module: "./src/index.ts",
   types: "./src/index.ts",
   exports: {
     ".": "./src/index.ts"
+  },
+  dependencies: {
+    "@lunibee/types": "workspace:*"
   }
 };
 
@@ -82,6 +85,10 @@ function kindFromStatus(status) {
 function redactPath(path) {
   return path.replace(/^(\/webhooks\/[^/?]+\/)[^/?]+/, "$1:token").replace(/^(\/interactions\/[^/?]+\/)[^/?]+/, "$1:token");
 }
+var HINTS = {
+  50001: "The bot cannot see this resource: check that it is in the guild and has View Channel there.",
+  50013: "The bot lacks a permission for this action, or the target role or member is at or above the bot's highest role."
+};
 
 class RESTError extends Error {
   kind;
@@ -90,12 +97,14 @@ class RESTError extends Error {
   errors;
   method;
   path;
+  hint;
   constructor(message, status, code, errors, options = {}) {
     super(message, options.cause === undefined ? undefined : { cause: options.cause });
     this.name = "RESTError";
     this.status = status;
     this.kind = options.kind ?? kindFromStatus(status);
     this.code = code;
+    this.hint = code === undefined ? undefined : HINTS[code];
     this.errors = errors;
     this.method = options.method;
     this.path = options.path === undefined ? undefined : redactPath(options.path);
@@ -404,6 +413,8 @@ var Routes = {
   crosspostMessage: (channelId, messageId) => `${Routes.message(channelId, messageId)}/crosspost`,
   messageReactions: (channelId, messageId, emoji) => `${Routes.message(channelId, messageId)}/reactions/${encodeURIComponent(emoji)}`,
   messageReactionsAll: (channelId, messageId) => `${Routes.message(channelId, messageId)}/reactions`,
+  channelMessagesPins: (channelId) => `/channels/${snowflake(channelId, "Channel ID")}/messages/pins`,
+  channelMessagesPin: (channelId, messageId) => `/channels/${snowflake(channelId, "Channel ID")}/messages/pins/${snowflake(messageId, "Message ID")}`,
   channelPins: (channelId) => `/channels/${snowflake(channelId, "Channel ID")}/pins`,
   channelPin: (channelId, messageId) => `/channels/${snowflake(channelId, "Channel ID")}/pins/${snowflake(messageId, "Message ID")}`,
   messageThread: (channelId, messageId) => `${Routes.message(channelId, messageId)}/threads`,
@@ -462,6 +473,44 @@ function snowflake(value, field) {
     throw new TypeError(`${field} must be a valid Discord snowflake.`);
   return value;
 }
+// packages/rest/src/error-codes.ts
+var RESTErrorCode = {
+  UnknownAccount: 10001,
+  UnknownChannel: 10003,
+  UnknownGuild: 10004,
+  UnknownInvite: 10006,
+  UnknownMember: 10007,
+  UnknownMessage: 10008,
+  UnknownPermissionOverwrite: 10009,
+  UnknownRole: 10011,
+  UnknownUser: 10013,
+  UnknownEmoji: 10014,
+  UnknownWebhook: 10015,
+  UnknownBan: 10026,
+  UnknownSticker: 10060,
+  UnknownInteraction: 10062,
+  UnknownScheduledEvent: 10070,
+  BotsCannotUseEndpoint: 20001,
+  MaxGuilds: 30001,
+  MaxPins: 30003,
+  MaxRoles: 30005,
+  MaxWebhooks: 30007,
+  MaxEmojis: 30008,
+  MaxReactions: 30010,
+  MaxChannels: 30013,
+  InteractionAlreadyAcknowledged: 40060,
+  MissingAccess: 50001,
+  CannotExecuteInDM: 50003,
+  CannotEditOthersMessage: 50005,
+  CannotSendEmptyMessage: 50006,
+  CannotSendMessagesToUser: 50007,
+  MissingPermissions: 50013,
+  InvalidToken: 50014,
+  MessageTooOldToBulkDelete: 50034,
+  InvalidFormBody: 50035,
+  ThreadArchived: 50083,
+  CannotReplyWithoutReadHistory: 160002
+};
 // packages/rest/src/redis.ts
 var RESERVE_SCRIPT = `
 local raw = redis.call('GET', KEYS[1])
@@ -643,7 +692,7 @@ class WebhookClient {
 // packages/rest/src/index.ts
 var LIBRARY_VERSION = package_default.version;
 var LIBRARY_URL = "https://github.com/Ekretos/lunibee";
-var USER_AGENT = `DiscordBot (${LIBRARY_URL}, ${package_default.version})`;
+var USER_AGENT = `DiscordBot (${LIBRARY_URL}, ${LIBRARY_VERSION})`;
 var REQUEST_DATA_KEYS = new Set([
   "body",
   "files",
@@ -882,6 +931,7 @@ export {
   MemoryRateLimitStore,
   REST,
   RESTError,
+  RESTErrorCode,
   RateLimiter,
   RedisRateLimitStore,
   RequestScheduler,
@@ -899,4 +949,4 @@ export {
   serializeQuery
 };
 
-//# debugId=DB3368A765BDA92764756E2164756E21
+//# debugId=0345D6D5C65D143C64756E2164756E21