lunibee 0.3.1 → 0.3.3

package/dist/core/permissions.d.ts

@@ -1,404 +1,5 @@
-/** Permission overwrite target types. */
-export declare enum PermissionOverwriteEnum {
-    Role = 0,
-    Member = 1
-}
-/** Lunibee idiomatic camelCase permission bitflags. */
-export declare const Permission: {
-    readonly createInstantInvite: bigint;
-    readonly kickMembers: bigint;
-    readonly banMembers: bigint;
-    readonly administrator: bigint;
-    readonly manageChannels: bigint;
-    readonly manageGuild: bigint;
-    readonly addReactions: bigint;
-    readonly viewAuditLog: bigint;
-    readonly prioritySpeaker: bigint;
-    readonly stream: bigint;
-    readonly viewChannel: bigint;
-    readonly sendMessages: bigint;
-    readonly sendTTSMessages: bigint;
-    readonly manageMessages: bigint;
-    readonly embedLinks: bigint;
-    readonly attachFiles: bigint;
-    readonly readMessageHistory: bigint;
-    readonly mentionEveryone: bigint;
-    readonly useExternalEmojis: bigint;
-    readonly viewGuildInsights: bigint;
-    readonly connect: bigint;
-    readonly speak: bigint;
-    readonly muteMembers: bigint;
-    readonly deafenMembers: bigint;
-    readonly moveMembers: bigint;
-    readonly useVAD: bigint;
-    readonly changeNickname: bigint;
-    readonly manageNicknames: bigint;
-    readonly manageRoles: bigint;
-    readonly manageWebhooks: bigint;
-    readonly manageGuildExpressions: bigint;
-    readonly useApplicationCommands: bigint;
-    readonly requestToSpeak: bigint;
-    readonly manageEvents: bigint;
-    readonly manageThreads: bigint;
-    readonly createPublicThreads: bigint;
-    readonly createPrivateThreads: bigint;
-    readonly useExternalStickers: bigint;
-    readonly sendMessagesInThreads: bigint;
-    readonly useEmbeddedActivities: bigint;
-    readonly moderateMembers: bigint;
-    readonly viewCreatorMonetizationAnalytics: bigint;
-    readonly useSoundboard: bigint;
-    readonly createGuildExpressions: bigint;
-    readonly createEvents: bigint;
-    readonly useExternalSounds: bigint;
-    readonly sendVoiceMessages: bigint;
-    readonly setVoiceChannelStatus: bigint;
-    readonly sendPolls: bigint;
-    readonly useExternalApps: bigint;
-    readonly pinMessages: bigint;
-    readonly bypassSlowmode: bigint;
-};
-/** Canonical PascalCase permission constants. */
-export declare const Permissions: {
-    readonly CreateInstantInvite: bigint;
-    readonly KickMembers: bigint;
-    readonly BanMembers: bigint;
-    readonly Administrator: bigint;
-    readonly ManageChannels: bigint;
-    readonly ManageGuild: bigint;
-    readonly AddReactions: bigint;
-    readonly ViewAuditLog: bigint;
-    readonly PrioritySpeaker: bigint;
-    readonly Stream: bigint;
-    readonly ViewChannel: bigint;
-    readonly SendMessages: bigint;
-    readonly SendTTSMessages: bigint;
-    readonly ManageMessages: bigint;
-    readonly EmbedLinks: bigint;
-    readonly AttachFiles: bigint;
-    readonly ReadMessageHistory: bigint;
-    readonly MentionEveryone: bigint;
-    readonly UseExternalEmojis: bigint;
-    readonly ViewGuildInsights: bigint;
-    readonly Connect: bigint;
-    readonly Speak: bigint;
-    readonly MuteMembers: bigint;
-    readonly DeafenMembers: bigint;
-    readonly MoveMembers: bigint;
-    readonly UseVAD: bigint;
-    readonly ChangeNickname: bigint;
-    readonly ManageNicknames: bigint;
-    readonly ManageRoles: bigint;
-    readonly ManageWebhooks: bigint;
-    readonly ManageGuildExpressions: bigint;
-    readonly UseApplicationCommands: bigint;
-    readonly RequestToSpeak: bigint;
-    readonly ManageEvents: bigint;
-    readonly ManageThreads: bigint;
-    readonly CreatePublicThreads: bigint;
-    readonly CreatePrivateThreads: bigint;
-    readonly UseExternalStickers: bigint;
-    readonly SendMessagesInThreads: bigint;
-    readonly UseEmbeddedActivities: bigint;
-    readonly ModerateMembers: bigint;
-    readonly ViewCreatorMonetizationAnalytics: bigint;
-    readonly UseSoundboard: bigint;
-    readonly CreateGuildExpressions: bigint;
-    readonly CreateEvents: bigint;
-    readonly UseExternalSounds: bigint;
-    readonly SendVoiceMessages: bigint;
-    readonly SetVoiceChannelStatus: bigint;
-    readonly SendPolls: bigint;
-    readonly UseExternalApps: bigint;
-    readonly PinMessages: bigint;
-    readonly BypassSlowmode: bigint;
-};
 /**
- * Permission flag bits with **bigint** values matching Discord's permission bit
- * positions. Mirrors discord.js's `PermissionFlagsBits`, so bitwise composition
- * (`Flags.A | Flags.B`) OR-s the bits instead of concatenating strings.
- *
- * The same object as {@link Permissions}, under the discord.js name. It is a
- * `const` object rather than a TS `enum` because enums cannot hold bigint
- * members; the same-named union type below preserves usage as a type.
+ * Permission bits and math live in `@lunibee/structures`, which needs them at
+ * runtime (member and role permissions); they are re-exported here unchanged.
  */
-export declare const PermissionFlagsBits: {
-    readonly CreateInstantInvite: bigint;
-    readonly KickMembers: bigint;
-    readonly BanMembers: bigint;
-    readonly Administrator: bigint;
-    readonly ManageChannels: bigint;
-    readonly ManageGuild: bigint;
-    readonly AddReactions: bigint;
-    readonly ViewAuditLog: bigint;
-    readonly PrioritySpeaker: bigint;
-    readonly Stream: bigint;
-    readonly ViewChannel: bigint;
-    readonly SendMessages: bigint;
-    readonly SendTTSMessages: bigint;
-    readonly ManageMessages: bigint;
-    readonly EmbedLinks: bigint;
-    readonly AttachFiles: bigint;
-    readonly ReadMessageHistory: bigint;
-    readonly MentionEveryone: bigint;
-    readonly UseExternalEmojis: bigint;
-    readonly ViewGuildInsights: bigint;
-    readonly Connect: bigint;
-    readonly Speak: bigint;
-    readonly MuteMembers: bigint;
-    readonly DeafenMembers: bigint;
-    readonly MoveMembers: bigint;
-    readonly UseVAD: bigint;
-    readonly ChangeNickname: bigint;
-    readonly ManageNicknames: bigint;
-    readonly ManageRoles: bigint;
-    readonly ManageWebhooks: bigint;
-    readonly ManageGuildExpressions: bigint;
-    readonly UseApplicationCommands: bigint;
-    readonly RequestToSpeak: bigint;
-    readonly ManageEvents: bigint;
-    readonly ManageThreads: bigint;
-    readonly CreatePublicThreads: bigint;
-    readonly CreatePrivateThreads: bigint;
-    readonly UseExternalStickers: bigint;
-    readonly SendMessagesInThreads: bigint;
-    readonly UseEmbeddedActivities: bigint;
-    readonly ModerateMembers: bigint;
-    readonly ViewCreatorMonetizationAnalytics: bigint;
-    readonly UseSoundboard: bigint;
-    readonly CreateGuildExpressions: bigint;
-    readonly CreateEvents: bigint;
-    readonly UseExternalSounds: bigint;
-    readonly SendVoiceMessages: bigint;
-    readonly SetVoiceChannelStatus: bigint;
-    readonly SendPolls: bigint;
-    readonly UseExternalApps: bigint;
-    readonly PinMessages: bigint;
-    readonly BypassSlowmode: bigint;
-};
-/** Union of {@link PermissionFlagsBits} values (all bigint). */
-export type PermissionFlagsBits = (typeof PermissionFlagsBits)[keyof typeof PermissionFlagsBits];
-export type PermissionName = keyof typeof Permission | keyof typeof Permissions | keyof typeof PermissionFlagsBits;
-export type PermissionResolvable = bigint | number | string | PermissionName | PermissionFlagsBits | PermissionSet | PermissionResolvable[];
-/** Immutable permission bitfield with direct boolean getters. */
-export declare class PermissionSet {
-    #private;
-    /** Permission bitfield. */
-    readonly bitfield: bigint;
-    /** Creates a permission set. @param value Initial permission bitfield or array of permissions. @throws {RangeError} If the value is negative. @throws {TypeError} If the value is not a valid integer. */
-    constructor(value?: PermissionResolvable);
-    get createInstantInvite(): boolean;
-    get kickMembers(): boolean;
-    get banMembers(): boolean;
-    get administrator(): boolean;
-    get manageChannels(): boolean;
-    get manageGuild(): boolean;
-    get addReactions(): boolean;
-    get viewAuditLog(): boolean;
-    get prioritySpeaker(): boolean;
-    get stream(): boolean;
-    get viewChannel(): boolean;
-    get sendMessages(): boolean;
-    get sendTTSMessages(): boolean;
-    get manageMessages(): boolean;
-    get embedLinks(): boolean;
-    get attachFiles(): boolean;
-    get readMessageHistory(): boolean;
-    get mentionEveryone(): boolean;
-    get useExternalEmojis(): boolean;
-    get viewGuildInsights(): boolean;
-    get connect(): boolean;
-    get speak(): boolean;
-    get muteMembers(): boolean;
-    get deafenMembers(): boolean;
-    get moveMembers(): boolean;
-    get useVAD(): boolean;
-    get changeNickname(): boolean;
-    get manageNicknames(): boolean;
-    get manageRoles(): boolean;
-    get manageWebhooks(): boolean;
-    get manageGuildExpressions(): boolean;
-    get useApplicationCommands(): boolean;
-    get requestToSpeak(): boolean;
-    get manageEvents(): boolean;
-    get manageThreads(): boolean;
-    get createPublicThreads(): boolean;
-    get createPrivateThreads(): boolean;
-    get useExternalStickers(): boolean;
-    get sendMessagesInThreads(): boolean;
-    get useEmbeddedActivities(): boolean;
-    get moderateMembers(): boolean;
-    get viewCreatorMonetizationAnalytics(): boolean;
-    get useSoundboard(): boolean;
-    get createGuildExpressions(): boolean;
-    get createEvents(): boolean;
-    get useExternalSounds(): boolean;
-    get sendVoiceMessages(): boolean;
-    get sendPolls(): boolean;
-    get useExternalApps(): boolean;
-    /** Checks whether all supplied permissions are present (AND). @param permissions Permission names or raw bits. @returns True when every requested permission is present. */
-    has(...permissions: PermissionResolvable[]): boolean;
-    /** Checks whether any supplied permission is present (OR). @param permissions Permission names or raw bits. @returns True when at least one requested permission is present. */
-    any(...permissions: PermissionResolvable[]): boolean;
-    /** Returns the known permission names from `permissions` that this set lacks. @param permissions Permission names or raw bits. */
-    missing(...permissions: PermissionResolvable[]): PermissionName[];
-    /** Returns a new set with permissions added. @param permissions Permission names or raw bits. @returns A new permission set. */
-    add(...permissions: PermissionResolvable[]): PermissionSet;
-    /** Returns a new set with permissions removed. @param permissions Permission names or raw bits. @returns A new permission set. */
-    remove(...permissions: PermissionResolvable[]): PermissionSet;
-    /** Checks equality with another permission set or raw bitfield. @param other Permission set or raw bitfield. @returns True when both values are equal. */
-    equals(other: PermissionSet | bigint | number | string): boolean;
-    /** Returns the decimal permission representation. @returns Decimal permission bitfield. */
-    toString(): string;
-    /** Returns known permission names contained in this set. @returns Names of all enabled known permissions. */
-    toArray(): PermissionName[];
-}
-/** Permissions bitfield alias. */
-export declare class PermissionsBitField extends PermissionSet {
-    /** Permission flags bits enum. */
-    static readonly Flags: {
-        readonly CreateInstantInvite: bigint;
-        readonly KickMembers: bigint;
-        readonly BanMembers: bigint;
-        readonly Administrator: bigint;
-        readonly ManageChannels: bigint;
-        readonly ManageGuild: bigint;
-        readonly AddReactions: bigint;
-        readonly ViewAuditLog: bigint;
-        readonly PrioritySpeaker: bigint;
-        readonly Stream: bigint;
-        readonly ViewChannel: bigint;
-        readonly SendMessages: bigint;
-        readonly SendTTSMessages: bigint;
-        readonly ManageMessages: bigint;
-        readonly EmbedLinks: bigint;
-        readonly AttachFiles: bigint;
-        readonly ReadMessageHistory: bigint;
-        readonly MentionEveryone: bigint;
-        readonly UseExternalEmojis: bigint;
-        readonly ViewGuildInsights: bigint;
-        readonly Connect: bigint;
-        readonly Speak: bigint;
-        readonly MuteMembers: bigint;
-        readonly DeafenMembers: bigint;
-        readonly MoveMembers: bigint;
-        readonly UseVAD: bigint;
-        readonly ChangeNickname: bigint;
-        readonly ManageNicknames: bigint;
-        readonly ManageRoles: bigint;
-        readonly ManageWebhooks: bigint;
-        readonly ManageGuildExpressions: bigint;
-        readonly UseApplicationCommands: bigint;
-        readonly RequestToSpeak: bigint;
-        readonly ManageEvents: bigint;
-        readonly ManageThreads: bigint;
-        readonly CreatePublicThreads: bigint;
-        readonly CreatePrivateThreads: bigint;
-        readonly UseExternalStickers: bigint;
-        readonly SendMessagesInThreads: bigint;
-        readonly UseEmbeddedActivities: bigint;
-        readonly ModerateMembers: bigint;
-        readonly ViewCreatorMonetizationAnalytics: bigint;
-        readonly UseSoundboard: bigint;
-        readonly CreateGuildExpressions: bigint;
-        readonly CreateEvents: bigint;
-        readonly UseExternalSounds: bigint;
-        readonly SendVoiceMessages: bigint;
-        readonly SetVoiceChannelStatus: bigint;
-        readonly SendPolls: bigint;
-        readonly UseExternalApps: bigint;
-        readonly PinMessages: bigint;
-        readonly BypassSlowmode: bigint;
-    };
-    /** Permission flags constants. */
-    static readonly All: {
-        readonly createInstantInvite: bigint;
-        readonly kickMembers: bigint;
-        readonly banMembers: bigint;
-        readonly administrator: bigint;
-        readonly manageChannels: bigint;
-        readonly manageGuild: bigint;
-        readonly addReactions: bigint;
-        readonly viewAuditLog: bigint;
-        readonly prioritySpeaker: bigint;
-        readonly stream: bigint;
-        readonly viewChannel: bigint;
-        readonly sendMessages: bigint;
-        readonly sendTTSMessages: bigint;
-        readonly manageMessages: bigint;
-        readonly embedLinks: bigint;
-        readonly attachFiles: bigint;
-        readonly readMessageHistory: bigint;
-        readonly mentionEveryone: bigint;
-        readonly useExternalEmojis: bigint;
-        readonly viewGuildInsights: bigint;
-        readonly connect: bigint;
-        readonly speak: bigint;
-        readonly muteMembers: bigint;
-        readonly deafenMembers: bigint;
-        readonly moveMembers: bigint;
-        readonly useVAD: bigint;
-        readonly changeNickname: bigint;
-        readonly manageNicknames: bigint;
-        readonly manageRoles: bigint;
-        readonly manageWebhooks: bigint;
-        readonly manageGuildExpressions: bigint;
-        readonly useApplicationCommands: bigint;
-        readonly requestToSpeak: bigint;
-        readonly manageEvents: bigint;
-        readonly manageThreads: bigint;
-        readonly createPublicThreads: bigint;
-        readonly createPrivateThreads: bigint;
-        readonly useExternalStickers: bigint;
-        readonly sendMessagesInThreads: bigint;
-        readonly useEmbeddedActivities: bigint;
-        readonly moderateMembers: bigint;
-        readonly viewCreatorMonetizationAnalytics: bigint;
-        readonly useSoundboard: bigint;
-        readonly createGuildExpressions: bigint;
-        readonly createEvents: bigint;
-        readonly useExternalSounds: bigint;
-        readonly sendVoiceMessages: bigint;
-        readonly setVoiceChannelStatus: bigint;
-        readonly sendPolls: bigint;
-        readonly useExternalApps: bigint;
-        readonly pinMessages: bigint;
-        readonly bypassSlowmode: bigint;
-    };
-    /** Creates a permissions bitfield. @param value Initial permission bitfield or array of permissions. */
-    constructor(value?: PermissionResolvable);
-}
-/** A role as needed for permission resolution. */
-export interface PermissionRole {
-    id: string;
-    permissions: PermissionResolvable;
-}
-/** A channel permission overwrite (Discord's `permission_overwrites` entry). */
-export interface PermissionOverwrite {
-    id: string;
-    type: PermissionOverwriteEnum | number;
-    allow: PermissionResolvable;
-    deny: PermissionResolvable;
-}
-/** Everything needed to resolve a member's permissions. */
-export interface PermissionContext {
-    guildId: string;
-    /** Guild owner ID; the owner has every permission. */
-    ownerId?: string;
-    memberId: string;
-    memberRoleIds: readonly string[];
-    /** Guild roles, including `@everyone` (whose ID is the guild ID). */
-    roles: readonly PermissionRole[];
-    /** Channel overwrites; omit for guild-level permissions. */
-    overwrites?: readonly PermissionOverwrite[];
-    /** When the member's timeout ends; while it is in the future the member keeps only View Channel and Read Message History. */
-    timedOutUntil?: Date | number | null;
-}
-/**
- * Resolves a member's effective permissions the way Discord does: base
- * permissions from `@everyone` and the member's roles (owner and
- * administrator get everything), then the channel's `@everyone` overwrite,
- * the combined role overwrites, and finally the member overwrite. A member
- * whose timeout has not ended keeps only View Channel and Read Message History.
- */
-export declare function computePermissions(context: PermissionContext): PermissionSet;
+export { Permission, Permissions, PermissionFlagsBits, PermissionSet, PermissionsBitField, PermissionOverwriteEnum, computePermissions, type PermissionContext, type PermissionOverwrite, type PermissionRole, type PermissionName, type PermissionResolvable, } from "@lunibee/structures";

package/dist/core/redis-cache.d.ts

@@ -0,0 +1,85 @@
+/**
+ * A shared cache in Redis, beside the in-memory one.
+ *
+ * The in-memory cache of each process holds the guilds its shards receive.
+ * `RedisCache` mirrors the same Gateway events into Redis as raw Discord
+ * payloads, so any process — another cluster, a dashboard, a worker without
+ * a Gateway — can read any guild. It never replaces the synchronous cache.
+ */
+import type { RedisCommandClient } from "@lunibee/collection";
+export type { RedisCommandClient };
+/** What `attach()` listens to: a `Client` (its `raw` event) or a `Gateway` (`RAW`). */
+export interface RawDispatchSource {
+    on(event: any, listener: any): unknown;
+    off(event: any, listener: any): unknown;
+}
+/** Options for {@link RedisCache}. */
+export interface RedisCacheOptions {
+    /** The Redis client. `Bun.RedisClient` works as it is; for ioredis pass `{ send: (c, a) => redis.call(c, ...a) }`. */
+    client: RedisCommandClient;
+    /** Key prefix. Default `"lunibee:cache:"`; keys are versioned under it (`…v1:…`). */
+    prefix?: string;
+    /** Store members and their users. Default `true`. */
+    members?: boolean;
+    /** Expire every key this many seconds after its last write. Default: never. */
+    ttlSeconds?: number;
+    /** Called when a write fails. Writes never throw into the Gateway. */
+    onError?: (operation: string, error: unknown) => void;
+}
+/** Health of a {@link RedisCache}. */
+export interface RedisCacheDiagnostics {
+    /** Events written. */
+    writes: number;
+    /** Writes that failed. */
+    failures: number;
+    /** Events waiting to be written. */
+    pending: number;
+}
+type Payload = Record<string, unknown>;
+/**
+ * A Redis mirror of guilds, channels, roles, members and users.
+ *
+ * ```ts
+ * const shared = new RedisCache({ client: new Bun.RedisClient(process.env.REDIS_URL) });
+ * shared.attach(client);                  // or each shard's Gateway
+ * const guild = await shared.guild(id);   // from any process
+ * ```
+ *
+ * Writes for one guild are applied in Gateway order; a failed write is
+ * reported through `onError` and never reaches the Gateway. Reads throw on a
+ * Redis error. Values are raw Discord payloads (`APIGuild`-shaped JSON).
+ */
+export declare class RedisCache {
+    #private;
+    constructor(options: RedisCacheOptions);
+    /**
+     * Mirrors the dispatches of a `Client` (its `raw` event) or of one
+     * `Gateway` (`RAW`). Attach each shard's Gateway, or the client once.
+     */
+    attach(source: RawDispatchSource): this;
+    /** Stops mirroring `source` (or every source). */
+    detach(source?: RawDispatchSource): this;
+    /** Resolves when every write queued so far has been applied (or failed). */
+    flush(): Promise<void>;
+    diagnostics(): RedisCacheDiagnostics;
+    /**
+     * Applies one Gateway dispatch. `attach()` calls it; call it yourself to
+     * feed events from elsewhere (an IPC relay, a replay).
+     */
+    handle(event: string, data: unknown): void;
+    /** The guild document (without its channels, roles and members). */
+    guild<T extends object = Payload>(guildId: string): Promise<T | undefined>;
+    /** Ids of every guild in the cache. */
+    guildIds(): Promise<string[]>;
+    /** A channel or thread, with its `guild_id`. */
+    channel<T extends object = Payload>(channelId: string): Promise<T | undefined>;
+    /** Every channel and thread of a guild. */
+    channels<T extends object = Payload>(guildId: string): Promise<T[]>;
+    role<T extends object = Payload>(guildId: string, roleId: string): Promise<T | undefined>;
+    roles<T extends object = Payload>(guildId: string): Promise<T[]>;
+    user<T extends object = Payload>(userId: string): Promise<T | undefined>;
+    /** A member, with its `user` attached. */
+    member<T extends object = Payload>(guildId: string, userId: string): Promise<T | undefined>;
+    /** Every cached member of a guild, with users. Large guilds: mind the size. */
+    members<T extends object = Payload>(guildId: string): Promise<T[]>;
+}

package/dist/formatters/index.d.ts

@@ -46,5 +46,9 @@ export declare function subtext(text: string): string;
 export declare function orderedList(...items: string[]): string;
 /** Creates an unordered bullet list from items. */
 export declare function bulletList(...items: string[]): string;
-/** Escapes Discord markdown control characters in a string. */
+/**
+ * Escapes the inline Discord markdown characters `\ * _ ` ~ | >`. It does not
+ * neutralise headings, lists or `[label](url)` links: pair it with
+ * `allowedMentions` and never rely on it to sanitise untrusted text.
+ */
 export declare function escapeMarkdown(value: string): string;

package/dist/formatters/index.js

@@ -14,6 +14,8 @@ function timestamp(unixSeconds, style) {
     throw new TypeError("Timestamp must be a finite Unix timestamp.");
   if (style !== undefined && !/^[tTdDfFR]$/.test(style))
     throw new RangeError("Invalid Discord timestamp style.");
+  if (!Number.isSafeInteger(Math.floor(unixSeconds)))
+    throw new RangeError("Timestamp is out of range.");
   return `<t:${Math.floor(unixSeconds)}${style ? `:${style}` : ""}>`;
 }
 function bold(text) {
@@ -38,16 +40,18 @@ function inlineCode(text) {
   return `\`${text}\``;
 }
 function codeBlock(text, language = "") {
-  const safe = text.replace(/```/g, "`\u200B``");
+  const safe = text.replace(/`(?=`)/g, "`\u200B");
   const lang = language.replace(/[^\w+#.-]/g, "");
   return `\`\`\`${lang}
 ${safe}
 \`\`\``;
 }
 function link(label, url, title) {
+  if (!/^(?:https?|discord):\/\//i.test(url))
+    throw new TypeError("link() only accepts http, https or discord URLs.");
   const text = label.replace(/[[\]\\]/g, "\\$&").replace(/\n/g, " ");
   const target = url.replace(/[()\s"]/g, (c) => `%${c.charCodeAt(0).toString(16).toUpperCase().padStart(2, "0")}`);
-  const titlePart = title ? ` "${title.replace(/["\n]/g, "")}"` : "";
+  const titlePart = title ? ` "${title.replace(/["\n)]/g, "")}"` : "";
   return `[${text}](${target}${titlePart})`;
 }
 function blockQuote(text) {
@@ -107,4 +111,4 @@ export {
   userMention
 };
 
-//# debugId=8E29C8A8AAEFEA0D64756E2164756E21
+//# debugId=9B1DEB0C74BB980D64756E2164756E21

package/dist/formatters/index.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../packages/formatters/src/index.ts"],
   "sourcesContent": [
-    "// ─── Mentions ──────────────────────────────────────────────────────────────────\n\n/** Creates a user mention from a Discord snowflake. */\nexport function userMention(id: string): string {\n    return `<@${validateSnowflake(id, \"User ID\")}>`;\n}\n\n/** Creates a channel mention from a Discord snowflake. */\nexport function channelMention(id: string): string {\n    return `<#${validateSnowflake(id, \"Channel ID\")}>`;\n}\n\n/** Creates a role mention from a Discord snowflake. */\nexport function roleMention(id: string): string {\n    return `<@&${validateSnowflake(id, \"Role ID\")}>`;\n}\n\n// ─── Timestamps ────────────────────────────────────────────────────────────────\n\n/** Discord timestamp style formats. */\nexport type TimestampStyle = \"t\" | \"T\" | \"d\" | \"D\" | \"f\" | \"F\" | \"R\";\n\n/** Creates a Discord timestamp tag.\n * @param unixSeconds Unix timestamp in seconds.\n * @param style Optional display style: t=short time, T=long time, d=short date, D=long date, f=short datetime, F=long datetime, R=relative.\n */\nexport function timestamp(\n    unixSeconds: number,\n    style?: TimestampStyle | string,\n): string {\n    if (!Number.isFinite(unixSeconds))\n        throw new TypeError(\"Timestamp must be a finite Unix timestamp.\");\n    if (style !== undefined && !/^[tTdDfFR]$/.test(style))\n        throw new RangeError(\"Invalid Discord timestamp style.\");\n    return `<t:${Math.floor(unixSeconds)}${style ? `:${style}` : \"\"}>`;\n}\n\n// ─── Markdown ─────────────────────────────────────────────────────────────────\n\n/** Wraps text in Discord bold markdown. */\nexport function bold(text: string): string {\n    return `**${text}**`;\n}\n\n/** Wraps text in Discord italic markdown. */\nexport function italic(text: string): string {\n    return `_${text}_`;\n}\n\n/** Wraps text in Discord underline markdown. */\nexport function underline(text: string): string {\n    return `__${text}__`;\n}\n\n/** Wraps text in Discord strikethrough markdown. */\nexport function strikethrough(text: string): string {\n    return `~~${text}~~`;\n}\n\n/** Wraps text in a Discord spoiler tag (shown masked until clicked). */\nexport function spoiler(text: string): string {\n    return `||${text}||`;\n}\n\n/** Alias for spoiler — hides text until revealed. */\nexport function masked(text: string): string {\n    return spoiler(text);\n}\n\n/** Wraps text in Discord inline code. */\nexport function inlineCode(text: string): string {\n    return `\\`${text}\\``;\n}\n\n/** Wraps text in a Discord fenced code block.\n * @param text Code content.\n * @param language Optional language identifier for syntax highlighting.\n */\nexport function codeBlock(text: string, language = \"\"): string {\n    // A zero-width space between backticks keeps the text from closing the block.\n    const safe = text.replace(/```/g, \"`\\u200b``\");\n    const lang = language.replace(/[^\\w+#.-]/g, \"\");\n    return `\\`\\`\\`${lang}\\n${safe}\\n\\`\\`\\``;\n}\n\n/** Creates a Discord masked hyperlink: [label](url).\n * @param label Display text.\n * @param url Destination URL.\n * @param title Optional hover title.\n */\nexport function link(label: string, url: string, title?: string): string {\n    // Brackets in the label and parentheses, quotes or spaces in the URL would\n    // otherwise end the link early and let the rest render as a second link.\n    const text = label.replace(/[[\\]\\\\]/g, \"\\\\$&\").replace(/\\n/g, \" \");\n    const target = url.replace(\n        /[()\\s\"]/g,\n        (c) =>\n            `%${c.charCodeAt(0).toString(16).toUpperCase().padStart(2, \"0\")}`,\n    );\n    const titlePart = title ? ` \"${title.replace(/[\"\\n]/g, \"\")}\"` : \"\";\n    return `[${text}](${target}${titlePart})`;\n}\n\n/** Wraps each line of text in a Discord block quote (> prefix). */\nexport function blockQuote(text: string): string {\n    return text\n        .split(\"\\n\")\n        .map((line) => `> ${line}`)\n        .join(\"\\n\");\n}\n\n/** Creates a Discord heading at the given level (1–3). */\nexport function heading(text: string, level: 1 | 2 | 3 = 1): string {\n    return `${\"#\".repeat(level)} ${text}`;\n}\n\n/** Wraps text in Discord's subtext markdown (-# prefix). */\nexport function subtext(text: string): string {\n    return `-# ${text}`;\n}\n\n/** Creates a numbered ordered list from items. */\nexport function orderedList(...items: string[]): string {\n    return items.map((item, i) => `${i + 1}. ${item}`).join(\"\\n\");\n}\n\n/** Creates an unordered bullet list from items. */\nexport function bulletList(...items: string[]): string {\n    return items.map((item) => `- ${item}`).join(\"\\n\");\n}\n\n// ─── Utilities ─────────────────────────────────────────────────────────────────\n\n/** Escapes Discord markdown control characters in a string. */\nexport function escapeMarkdown(value: string): string {\n    return value.replace(/[\\\\*_`~|>]/g, \"\\\\$&\");\n}\n\nfunction validateSnowflake(id: string, field: string): string {\n    const len = id.length;\n    if (len < 1 || len > 20) {\n        throw new TypeError(`${field} must be a valid Discord snowflake.`);\n    }\n    for (let i = 0; i < len; i++) {\n        const code = id.charCodeAt(i);\n        if (code < 48 || code > 57) {\n            throw new TypeError(`${field} must be a valid Discord snowflake.`);\n        }\n    }\n    return id;\n}\n"
+    "// ─── Mentions ──────────────────────────────────────────────────────────────────\n\n/** Creates a user mention from a Discord snowflake. */\nexport function userMention(id: string): string {\n    return `<@${validateSnowflake(id, \"User ID\")}>`;\n}\n\n/** Creates a channel mention from a Discord snowflake. */\nexport function channelMention(id: string): string {\n    return `<#${validateSnowflake(id, \"Channel ID\")}>`;\n}\n\n/** Creates a role mention from a Discord snowflake. */\nexport function roleMention(id: string): string {\n    return `<@&${validateSnowflake(id, \"Role ID\")}>`;\n}\n\n// ─── Timestamps ────────────────────────────────────────────────────────────────\n\n/** Discord timestamp style formats. */\nexport type TimestampStyle = \"t\" | \"T\" | \"d\" | \"D\" | \"f\" | \"F\" | \"R\";\n\n/** Creates a Discord timestamp tag.\n * @param unixSeconds Unix timestamp in seconds.\n * @param style Optional display style: t=short time, T=long time, d=short date, D=long date, f=short datetime, F=long datetime, R=relative.\n */\nexport function timestamp(\n    unixSeconds: number,\n    style?: TimestampStyle | string,\n): string {\n    if (!Number.isFinite(unixSeconds))\n        throw new TypeError(\"Timestamp must be a finite Unix timestamp.\");\n    if (style !== undefined && !/^[tTdDfFR]$/.test(style))\n        throw new RangeError(\"Invalid Discord timestamp style.\");\n    if (!Number.isSafeInteger(Math.floor(unixSeconds)))\n        throw new RangeError(\"Timestamp is out of range.\");\n    return `<t:${Math.floor(unixSeconds)}${style ? `:${style}` : \"\"}>`;\n}\n\n// ─── Markdown ─────────────────────────────────────────────────────────────────\n\n/** Wraps text in Discord bold markdown. */\nexport function bold(text: string): string {\n    return `**${text}**`;\n}\n\n/** Wraps text in Discord italic markdown. */\nexport function italic(text: string): string {\n    return `_${text}_`;\n}\n\n/** Wraps text in Discord underline markdown. */\nexport function underline(text: string): string {\n    return `__${text}__`;\n}\n\n/** Wraps text in Discord strikethrough markdown. */\nexport function strikethrough(text: string): string {\n    return `~~${text}~~`;\n}\n\n/** Wraps text in a Discord spoiler tag (shown masked until clicked). */\nexport function spoiler(text: string): string {\n    return `||${text}||`;\n}\n\n/** Alias for spoiler — hides text until revealed. */\nexport function masked(text: string): string {\n    return spoiler(text);\n}\n\n/** Wraps text in Discord inline code. */\nexport function inlineCode(text: string): string {\n    return `\\`${text}\\``;\n}\n\n/** Wraps text in a Discord fenced code block.\n * @param text Code content.\n * @param language Optional language identifier for syntax highlighting.\n */\nexport function codeBlock(text: string, language = \"\"): string {\n    // A zero-width space between every two adjacent backticks: no run of any\n    // length (```` included) can then form a closing fence.\n    const safe = text.replace(/`(?=`)/g, \"`\\u200b\");\n    const lang = language.replace(/[^\\w+#.-]/g, \"\");\n    return `\\`\\`\\`${lang}\\n${safe}\\n\\`\\`\\``;\n}\n\n/** Creates a Discord masked hyperlink: [label](url).\n * @param label Display text.\n * @param url Destination URL.\n * @param title Optional hover title.\n */\nexport function link(label: string, url: string, title?: string): string {\n    // Brackets in the label and parentheses, quotes or spaces in the URL would\n    // otherwise end the link early and let the rest render as a second link.\n    if (!/^(?:https?|discord):\\/\\//i.test(url))\n        throw new TypeError(\"link() only accepts http, https or discord URLs.\");\n    const text = label.replace(/[[\\]\\\\]/g, \"\\\\$&\").replace(/\\n/g, \" \");\n    const target = url.replace(\n        /[()\\s\"]/g,\n        (c) =>\n            `%${c.charCodeAt(0).toString(16).toUpperCase().padStart(2, \"0\")}`,\n    );\n    const titlePart = title ? ` \"${title.replace(/[\"\\n)]/g, \"\")}\"` : \"\";\n    return `[${text}](${target}${titlePart})`;\n}\n\n/** Wraps each line of text in a Discord block quote (> prefix). */\nexport function blockQuote(text: string): string {\n    return text\n        .split(\"\\n\")\n        .map((line) => `> ${line}`)\n        .join(\"\\n\");\n}\n\n/** Creates a Discord heading at the given level (1–3). */\nexport function heading(text: string, level: 1 | 2 | 3 = 1): string {\n    return `${\"#\".repeat(level)} ${text}`;\n}\n\n/** Wraps text in Discord's subtext markdown (-# prefix). */\nexport function subtext(text: string): string {\n    return `-# ${text}`;\n}\n\n/** Creates a numbered ordered list from items. */\nexport function orderedList(...items: string[]): string {\n    return items.map((item, i) => `${i + 1}. ${item}`).join(\"\\n\");\n}\n\n/** Creates an unordered bullet list from items. */\nexport function bulletList(...items: string[]): string {\n    return items.map((item) => `- ${item}`).join(\"\\n\");\n}\n\n// ─── Utilities ─────────────────────────────────────────────────────────────────\n\n/**\n * Escapes the inline Discord markdown characters `\\ * _ ` ~ | >`. It does not\n * neutralise headings, lists or `[label](url)` links: pair it with\n * `allowedMentions` and never rely on it to sanitise untrusted text.\n */\nexport function escapeMarkdown(value: string): string {\n    return value.replace(/[\\\\*_`~|>]/g, \"\\\\$&\");\n}\n\nfunction validateSnowflake(id: string, field: string): string {\n    const len = id.length;\n    if (len < 1 || len > 20) {\n        throw new TypeError(`${field} must be a valid Discord snowflake.`);\n    }\n    for (let i = 0; i < len; i++) {\n        const code = id.charCodeAt(i);\n        if (code < 48 || code > 57) {\n            throw new TypeError(`${field} must be a valid Discord snowflake.`);\n        }\n    }\n    return id;\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "8E29C8A8AAEFEA0D64756E2164756E21",
+  "mappings": "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",
+  "debugId": "9B1DEB0C74BB980D64756E2164756E21",
   "names": []
 }

package/dist/handlers/index.js

@@ -18,8 +18,17 @@ class HandlerRegistry {
     return this;
   }
   async dispatch(event, ...args) {
+    const errors = [];
     for (const handler of this.#handlers[event] ?? [])
-      await handler(...args);
+      try {
+        await handler(...args);
+      } catch (error) {
+        errors.push(error);
+      }
+    if (errors.length === 1)
+      throw errors[0];
+    if (errors.length > 1)
+      throw new AggregateError(errors, "Several handlers failed.");
   }
   emit(event, ...args) {
     return this.dispatch(event, ...args);
@@ -29,4 +38,4 @@ export {
   HandlerRegistry
 };
 
-//# debugId=E15872A5899BA4D864756E2164756E21
+//# debugId=45F209F9FE619D0964756E2164756E21

package/dist/handlers/index.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../packages/handlers/src/index.ts"],
   "sourcesContent": [
-    "/** A typed handler registry for Lunibee events. */\nexport class HandlerRegistry<\n    Events extends { [K in keyof Events]: unknown[] },\n> {\n    /** Registered event handlers. */\n    readonly #handlers: {\n        [K in keyof Events]?: Set<(...args: Events[K]) => unknown>;\n    } = {};\n    /** Registers a handler for an event. @param event Event key. @param handler Handler callback. @returns This registry. */\n    public on<K extends keyof Events>(\n        event: K,\n        handler: (...args: Events[K]) => unknown,\n    ): this {\n        (this.#handlers[event] ??= new Set()).add(handler);\n        return this;\n    }\n    /** Registers a one-shot handler. @param event Event key. @param handler Handler callback. @returns This registry. */\n    public once<K extends keyof Events>(\n        event: K,\n        handler: (...args: Events[K]) => unknown,\n    ): this {\n        const wrapped = (...args: Events[K]) => {\n            this.off(event, wrapped);\n            return handler(...args);\n        };\n        return this.on(event, wrapped);\n    }\n    /** Removes a handler. @param event Event key. @param handler Handler callback. @returns This registry. */\n    public off<K extends keyof Events>(\n        event: K,\n        handler: (...args: Events[K]) => unknown,\n    ): this {\n        this.#handlers[event]?.delete(handler);\n        return this;\n    }\n    /** Dispatches an event to registered handlers. @param event Event key. @param args Event arguments. @returns A promise fulfilled after handlers complete. */\n    public async dispatch<K extends keyof Events>(\n        event: K,\n        ...args: Events[K]\n    ): Promise<void> {\n        for (const handler of this.#handlers[event] ?? [])\n            await handler(...args);\n    }\n    /** Emits an event using the conventional emitter name. @param event Event key. @param args Event arguments. @returns A promise fulfilled after handlers complete. */\n    public emit<K extends keyof Events>(\n        event: K,\n        ...args: Events[K]\n    ): Promise<void> {\n        return this.dispatch(event, ...args);\n    }\n}\n"
+    "/** A typed handler registry for Lunibee events. */\nexport class HandlerRegistry<\n    Events extends { [K in keyof Events]: unknown[] },\n> {\n    /** Registered event handlers. */\n    readonly #handlers: {\n        [K in keyof Events]?: Set<(...args: Events[K]) => unknown>;\n    } = {};\n    /** Registers a handler for an event. @param event Event key. @param handler Handler callback. @returns This registry. */\n    public on<K extends keyof Events>(\n        event: K,\n        handler: (...args: Events[K]) => unknown,\n    ): this {\n        (this.#handlers[event] ??= new Set()).add(handler);\n        return this;\n    }\n    /** Registers a one-shot handler. @param event Event key. @param handler Handler callback. @returns This registry. */\n    public once<K extends keyof Events>(\n        event: K,\n        handler: (...args: Events[K]) => unknown,\n    ): this {\n        const wrapped = (...args: Events[K]) => {\n            this.off(event, wrapped);\n            return handler(...args);\n        };\n        return this.on(event, wrapped);\n    }\n    /** Removes a handler. @param event Event key. @param handler Handler callback. @returns This registry. */\n    public off<K extends keyof Events>(\n        event: K,\n        handler: (...args: Events[K]) => unknown,\n    ): this {\n        this.#handlers[event]?.delete(handler);\n        return this;\n    }\n    /** Dispatches an event to registered handlers. @param event Event key. @param args Event arguments. @returns A promise fulfilled after handlers complete. */\n    public async dispatch<K extends keyof Events>(\n        event: K,\n        ...args: Events[K]\n    ): Promise<void> {\n        const errors: unknown[] = [];\n        for (const handler of this.#handlers[event] ?? [])\n            try {\n                await handler(...args);\n            } catch (error) {\n                errors.push(error);\n            }\n        if (errors.length === 1) throw errors[0];\n        if (errors.length > 1)\n            throw new AggregateError(errors, \"Several handlers failed.\");\n    }\n    /** Emits an event using the conventional emitter name. @param event Event key. @param args Event arguments. @returns A promise fulfilled after handlers complete. */\n    public emit<K extends keyof Events>(\n        event: K,\n        ...args: Events[K]\n    ): Promise<void> {\n        return this.dispatch(event, ...args);\n    }\n}\n"
   ],
-  "mappings": ";;AACO,MAAM,gBAEX;AAAA,EAEW,YAEL,CAAC;AAAA,EAEE,EAA0B,CAC7B,OACA,SACI;AAAA,KACH,KAAK,UAAU,WAAW,IAAI,KAAO,IAAI,OAAO;AAAA,IACjD,OAAO;AAAA;AAAA,EAGJ,IAA4B,CAC/B,OACA,SACI;AAAA,IACJ,MAAM,UAAU,IAAI,SAAoB;AAAA,MACpC,KAAK,IAAI,OAAO,OAAO;AAAA,MACvB,OAAO,QAAQ,GAAG,IAAI;AAAA;AAAA,IAE1B,OAAO,KAAK,GAAG,OAAO,OAAO;AAAA;AAAA,EAG1B,GAA2B,CAC9B,OACA,SACI;AAAA,IACJ,KAAK,UAAU,QAAQ,OAAO,OAAO;AAAA,IACrC,OAAO;AAAA;AAAA,OAGE,SAAgC,CACzC,UACG,MACU;AAAA,IACb,WAAW,WAAW,KAAK,UAAU,UAAU,CAAC;AAAA,MAC5C,MAAM,QAAQ,GAAG,IAAI;AAAA;AAAA,EAGtB,IAA4B,CAC/B,UACG,MACU;AAAA,IACb,OAAO,KAAK,SAAS,OAAO,GAAG,IAAI;AAAA;AAE3C;",
-  "debugId": "E15872A5899BA4D864756E2164756E21",
+  "mappings": ";;AACO,MAAM,gBAEX;AAAA,EAEW,YAEL,CAAC;AAAA,EAEE,EAA0B,CAC7B,OACA,SACI;AAAA,KACH,KAAK,UAAU,WAAW,IAAI,KAAO,IAAI,OAAO;AAAA,IACjD,OAAO;AAAA;AAAA,EAGJ,IAA4B,CAC/B,OACA,SACI;AAAA,IACJ,MAAM,UAAU,IAAI,SAAoB;AAAA,MACpC,KAAK,IAAI,OAAO,OAAO;AAAA,MACvB,OAAO,QAAQ,GAAG,IAAI;AAAA;AAAA,IAE1B,OAAO,KAAK,GAAG,OAAO,OAAO;AAAA;AAAA,EAG1B,GAA2B,CAC9B,OACA,SACI;AAAA,IACJ,KAAK,UAAU,QAAQ,OAAO,OAAO;AAAA,IACrC,OAAO;AAAA;AAAA,OAGE,SAAgC,CACzC,UACG,MACU;AAAA,IACb,MAAM,SAAoB,CAAC;AAAA,IAC3B,WAAW,WAAW,KAAK,UAAU,UAAU,CAAC;AAAA,MAC5C,IAAI;AAAA,QACA,MAAM,QAAQ,GAAG,IAAI;AAAA,QACvB,OAAO,OAAO;AAAA,QACZ,OAAO,KAAK,KAAK;AAAA;AAAA,IAEzB,IAAI,OAAO,WAAW;AAAA,MAAG,MAAM,OAAO;AAAA,IACtC,IAAI,OAAO,SAAS;AAAA,MAChB,MAAM,IAAI,eAAe,QAAQ,0BAA0B;AAAA;AAAA,EAG5D,IAA4B,CAC/B,UACG,MACU;AAAA,IACb,OAAO,KAAK,SAAS,OAAO,GAAG,IAAI;AAAA;AAE3C;",
+  "debugId": "45F209F9FE619D0964756E2164756E21",
   "names": []
 }