@azurioh/discord-kernel 0.1.0

package/dist/discord/command/cooldown-guard.d.ts

@@ -0,0 +1,25 @@
+import { type Clock } from "../../clock";
+import type { Guard } from "../../discord/command/guard";
+import type { LocalizedText } from "../../i18n";
+/** How a cooldown window is shared between callers. */
+export type CooldownScope = "user" | "guild" | "global";
+export interface CooldownOptions {
+    /** Minimum delay between two accepted invocations, in milliseconds. */
+    windowMs: number;
+    /** Who shares the window. Defaults to `user`. */
+    scope?: CooldownScope;
+    /** Denial message; receives the whole seconds left before the next attempt. */
+    message?: (secondsLeft: number) => LocalizedText;
+    /** Injected for tests; defaults to the system clock. */
+    clock?: Clock;
+}
+/**
+ * Rate-limit a command per user, per guild or globally.
+ *
+ * Expired entries are pruned on access rather than by a timer: the map is only
+ * read when the command runs, so a background interval would keep the process
+ * awake for no benefit. Each guard instance owns its map, so two commands never
+ * share a window unless they share the guard.
+ */
+export declare function createCooldownGuard(options: CooldownOptions): Guard;
+//# sourceMappingURL=cooldown-guard.d.ts.map

package/dist/discord/command/cooldown-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cooldown-guard.d.ts","sourceRoot":"","sources":["../../../src/discord/command/cooldown-guard.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,KAAK,EAAe,MAAM,SAAS,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,yBAAyB,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAK5C,uDAAuD;AACvD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAExD,MAAM,WAAW,eAAe;IAC/B,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,aAAa,CAAC;IACjD,wDAAwD;IACxD,KAAK,CAAC,EAAE,KAAK,CAAC;CACd;AAsBD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,KAAK,CAoBnE"}

package/dist/discord/command/cooldown-guard.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCooldownGuard = createCooldownGuard;
+const clock_1 = require("../../clock");
+const i18n_1 = require("../../discord/i18n");
+const ALLOW = { ok: true };
+const MILLISECONDS_PER_SECOND = 1000;
+function defaultMessage(secondsLeft) {
+    return { key: i18n_1.CORE_MESSAGES.cooldownWait, params: { seconds: secondsLeft } };
+}
+/**
+ * The key sharing one cooldown window. `global` is a constant so every caller
+ * collides on purpose; `guild` falls back to the user outside a guild, so a DM
+ * can never bypass a guild-scoped cooldown by having no guild id.
+ */
+function cooldownKey(interaction, scope) {
+    switch (scope) {
+        case "global":
+            return `${interaction.commandName}:global`;
+        case "guild":
+            return `${interaction.commandName}:guild:${interaction.guildId ?? interaction.user.id}`;
+        case "user":
+            return `${interaction.commandName}:user:${interaction.user.id}`;
+    }
+}
+/**
+ * Rate-limit a command per user, per guild or globally.
+ *
+ * Expired entries are pruned on access rather than by a timer: the map is only
+ * read when the command runs, so a background interval would keep the process
+ * awake for no benefit. Each guard instance owns its map, so two commands never
+ * share a window unless they share the guard.
+ */
+function createCooldownGuard(options) {
+    const { windowMs, scope = "user", message = defaultMessage, clock = clock_1.systemClock } = options;
+    const lastUsed = new Map();
+    return {
+        check(interaction) {
+            const now = clock.now().getTime();
+            const key = cooldownKey(interaction, scope);
+            const previous = lastUsed.get(key);
+            if (previous !== undefined && now - previous < windowMs) {
+                const secondsLeft = Math.ceil((windowMs - (now - previous)) / MILLISECONDS_PER_SECOND);
+                return { ok: false, message: message(secondsLeft) };
+            }
+            lastUsed.set(key, now);
+            pruneExpired(lastUsed, now, windowMs);
+            return ALLOW;
+        },
+    };
+}
+/** Drop entries whose window has elapsed, so the map cannot grow without bound. */
+function pruneExpired(lastUsed, now, windowMs) {
+    for (const [key, timestamp] of lastUsed) {
+        if (now - timestamp >= windowMs) {
+            lastUsed.delete(key);
+        }
+    }
+}
+//# sourceMappingURL=cooldown-guard.js.map

package/dist/discord/command/cooldown-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cooldown-guard.js","sourceRoot":"","sources":["../../../src/discord/command/cooldown-guard.ts"],"names":[],"mappings":";;AAmDA,kDAoBC;AAtED,mCAAkD;AAElD,yCAA+C;AAG/C,MAAM,KAAK,GAAgB,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACxC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAgBrC,SAAS,cAAc,CAAC,WAAmB;IAC1C,OAAO,EAAE,GAAG,EAAE,oBAAa,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,CAAC;AAC9E,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,WAA+B,EAAE,KAAoB;IACzE,QAAQ,KAAK,EAAE,CAAC;QACf,KAAK,QAAQ;YACZ,OAAO,GAAG,WAAW,CAAC,WAAW,SAAS,CAAC;QAC5C,KAAK,OAAO;YACX,OAAO,GAAG,WAAW,CAAC,WAAW,UAAU,WAAW,CAAC,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACzF,KAAK,MAAM;YACV,OAAO,GAAG,WAAW,CAAC,WAAW,SAAS,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;IAClE,CAAC;AACF,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,mBAAmB,CAAC,OAAwB;IAC3D,MAAM,EAAE,QAAQ,EAAE,KAAK,GAAG,MAAM,EAAE,OAAO,GAAG,cAAc,EAAE,KAAK,GAAG,mBAAW,EAAE,GAAG,OAAO,CAAC;IAC5F,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE3C,OAAO;QACN,KAAK,CAAC,WAA+B;YACpC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,GAAG,GAAG,WAAW,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAC5C,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAEnC,IAAI,QAAQ,KAAK,SAAS,IAAI,GAAG,GAAG,QAAQ,GAAG,QAAQ,EAAE,CAAC;gBACzD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC,GAAG,GAAG,QAAQ,CAAC,CAAC,GAAG,uBAAuB,CAAC,CAAC;gBACvF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YACrD,CAAC;YAED,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACvB,YAAY,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;YACtC,OAAO,KAAK,CAAC;QACd,CAAC;KACD,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,SAAS,YAAY,CAAC,QAA6B,EAAE,GAAW,EAAE,QAAgB;IACjF,KAAK,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzC,IAAI,GAAG,GAAG,SAAS,IAAI,QAAQ,EAAE,CAAC;YACjC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/discord/command/create-command.d.ts

@@ -0,0 +1,100 @@
+import { type LocalizationMap } from "discord.js";
+import { type Context } from "../../discord/command/context";
+import type { Guard } from "../../discord/command/guard";
+import type { Options } from "../../discord/command/options";
+import type { SlashCommand } from "../../discord/command/types";
+import { type PermissionBit } from "../../discord/permissions";
+import { type LocalizedText } from "../../i18n";
+export interface SubcommandDef<O extends Options> {
+    description: string;
+    /** Translated names, keyed by Discord locale (e.g. `{ fr: "ajouter" }`). */
+    nameLocalizations?: LocalizationMap;
+    /** Translated descriptions, keyed by Discord locale. */
+    descriptionLocalizations?: LocalizationMap;
+    options?: O;
+    guard?: Guard;
+    /** Fallback message shown for unexpected (non-business) errors. */
+    fallbackError?: LocalizedText;
+    /** Defer the reply before running the handler (for work that may exceed 3s). */
+    defer?: boolean;
+    /** Whether replies (and the defer) are ephemeral. Defaults to true. */
+    ephemeral?: boolean;
+    handler: (ctx: Context<O>) => Promise<void>;
+}
+/**
+ * Type-erased subcommand. `createSubCommand()` captures the per-subcommand option
+ * generic `O` inside `invoke`, so a single command can hold subcommands with
+ * differing option shapes in one record without leaking `any`.
+ */
+export interface CompiledSubcommand {
+    description: string;
+    nameLocalizations?: LocalizationMap;
+    descriptionLocalizations?: LocalizationMap;
+    guard?: Guard;
+    fallbackError?: LocalizedText;
+    defer: boolean;
+    ephemeral: boolean;
+    options: Options;
+    invoke(ctx: Context<Options>): Promise<void>;
+}
+export declare function createSubCommand<O extends Options>(def: SubcommandDef<O>): CompiledSubcommand;
+interface GroupDef {
+    description: string;
+    nameLocalizations?: LocalizationMap;
+    descriptionLocalizations?: LocalizationMap;
+    subcommands: Record<string, CompiledSubcommand>;
+}
+/**
+ * A command is either *flat* (a single `handler`, like `/ping`) or *grouped*
+ * (`subcommands`/`groups`, like `/notes add`). Provide `handler` for the
+ * former; `handler` takes precedence over `subcommands`/`groups` if both are set.
+ */
+export interface CommandDef<O extends Options = Options> {
+    name: string;
+    description: string;
+    /** Translated names, keyed by Discord locale (e.g. `{ fr: "notes" }`). */
+    nameLocalizations?: LocalizationMap;
+    /** Translated descriptions, keyed by Discord locale. */
+    descriptionLocalizations?: LocalizationMap;
+    guard?: Guard;
+    /**
+     * Permissions a member must hold for Discord to *show* the command. This is a
+     * display filter, never a security boundary: a server admin can override it in
+     * the Integrations UI, so always pair it with a guard (see `permission-guard.ts`).
+     * Only meaningful on the root command — Discord has no per-subcommand equivalent.
+     */
+    defaultMemberPermissions?: readonly PermissionBit[];
+    /** Restrict the command to guild contexts (no DM, no user-app install). */
+    guildOnly?: boolean;
+    /** Restrict deployment to specific guild(s); omit to deploy globally (all servers). */
+    guildIds?: readonly string[];
+    /** Flat command: typed options for the single handler. */
+    options?: O;
+    /** Flat command: defer the reply before running the handler. */
+    defer?: boolean;
+    /** Flat command: whether replies (and the defer) are ephemeral. Defaults to true. */
+    ephemeral?: boolean;
+    /** Flat command: fallback message for unexpected errors. */
+    fallbackError?: LocalizedText;
+    /** Flat command: the single handler invoked when the command runs. */
+    handler?: (ctx: Context<O>) => Promise<void>;
+    /** Grouped command: named subcommands. */
+    subcommands?: Record<string, CompiledSubcommand>;
+    /** Grouped command: named subcommand groups. */
+    groups?: Record<string, GroupDef>;
+}
+/**
+ * The key a subcommand is stored and looked up under. Exported because dispatch
+ * and autocomplete must agree on it: if they ever built it differently, an
+ * autocomplete inside a group would silently resolve to no options instead of
+ * failing loudly.
+ */
+export declare function routeKey(group: string | null, name: string): string;
+/**
+ * Build a {@link SlashCommand} from a declarative definition: it produces the
+ * discord.js builder *and* the routing/guard/error pipeline. The runtime
+ * (presenter, logger) is injected per-dispatch by the command router.
+ */
+export declare function createCommand<O extends Options = Options>(def: CommandDef<O>): SlashCommand;
+export {};
+//# sourceMappingURL=create-command.d.ts.map

package/dist/discord/command/create-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-command.d.ts","sourceRoot":"","sources":["../../../src/discord/command/create-command.ts"],"names":[],"mappings":"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"}

package/dist/discord/command/create-command.js

@@ -0,0 +1,245 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSubCommand = createSubCommand;
+exports.routeKey = routeKey;
+exports.createCommand = createCommand;
+const discord_js_1 = require("discord.js");
+const autocomplete_1 = require("../../discord/command/autocomplete");
+const context_1 = require("../../discord/command/context");
+const i18n_1 = require("../../discord/i18n");
+const permissions_1 = require("../../discord/permissions");
+const errors_1 = require("../../errors");
+const i18n_2 = require("../../i18n");
+function createSubCommand(def) {
+    return {
+        description: def.description,
+        nameLocalizations: def.nameLocalizations,
+        descriptionLocalizations: def.descriptionLocalizations,
+        guard: def.guard,
+        fallbackError: def.fallbackError,
+        defer: def.defer ?? false,
+        ephemeral: def.ephemeral ?? true,
+        options: def.options ?? {},
+        invoke: (ctx) => def.handler(ctx),
+    };
+}
+/** Resolve the reply locale for an interaction handled outside `createContext`. */
+function interactionLocale(interaction, runtime) {
+    return (0, i18n_2.resolveLocale)([interaction.locale, interaction.guildLocale], runtime.translator.defaultLocale);
+}
+/**
+ * The key a subcommand is stored and looked up under. Exported because dispatch
+ * and autocomplete must agree on it: if they ever built it differently, an
+ * autocomplete inside a group would silently resolve to no options instead of
+ * failing loudly.
+ */
+function routeKey(group, name) {
+    return group ? `${group}/${name}` : name;
+}
+/**
+ * Apply the settings that only exist on the root command: localisations, the
+ * visibility filter and the context restriction.
+ *
+ * `defaultMemberPermissions` is resolved from flags into the single bitfield the
+ * API expects. An empty array is meaningful — it means "administrators only" to
+ * Discord — so it is passed through rather than skipped.
+ */
+function applyRootSettings(builder, def) {
+    if (def.nameLocalizations) {
+        builder.setNameLocalizations(def.nameLocalizations);
+    }
+    if (def.descriptionLocalizations) {
+        builder.setDescriptionLocalizations(def.descriptionLocalizations);
+    }
+    if (def.defaultMemberPermissions) {
+        builder.setDefaultMemberPermissions((0, permissions_1.resolvePermissions)(def.defaultMemberPermissions));
+    }
+    if (def.guildOnly) {
+        builder.setContexts(discord_js_1.InteractionContextType.Guild);
+    }
+}
+function applySubcommand(container, name, def) {
+    container.addSubcommand((subBuilder) => {
+        subBuilder.setName(name).setDescription(def.description);
+        if (def.nameLocalizations) {
+            subBuilder.setNameLocalizations(def.nameLocalizations);
+        }
+        if (def.descriptionLocalizations) {
+            subBuilder.setDescriptionLocalizations(def.descriptionLocalizations);
+        }
+        for (const [optionName, option] of Object.entries(def.options)) {
+            option.apply(subBuilder, optionName);
+        }
+        return subBuilder;
+    });
+}
+function readOptions(options, interaction) {
+    const values = {};
+    for (const [name, option] of Object.entries(options)) {
+        values[name] = option.read(interaction, name);
+    }
+    return values;
+}
+function ephemeralReplyOptions(ephemeral) {
+    if (ephemeral) {
+        return { flags: discord_js_1.MessageFlags.Ephemeral };
+    }
+    return {};
+}
+/** Run a guard if present; reply with a denial and return `false` when it fails. */
+async function passesGuard(interaction, guard, runtime) {
+    if (!guard) {
+        return true;
+    }
+    const result = await guard.check(interaction);
+    if (!result.ok) {
+        const locale = interactionLocale(interaction, runtime);
+        await interaction.reply({
+            embeds: [
+                runtime.presenter.denial(runtime.translator.resolve(locale, result.message), locale),
+            ],
+            flags: discord_js_1.MessageFlags.Ephemeral,
+        });
+        return false;
+    }
+    return true;
+}
+/** Read options, optionally defer, build the context and invoke the handler. */
+async function executeRoute(interaction, route, label, runtime) {
+    const { presenter, logger, translator } = runtime;
+    try {
+        const values = readOptions(route.options, interaction);
+        if (route.defer) {
+            await interaction.deferReply(ephemeralReplyOptions(route.ephemeral));
+        }
+        const ctx = (0, context_1.createContext)(interaction, values, route.ephemeral, presenter, logger, translator);
+        await route.invoke(ctx);
+    }
+    catch (error) {
+        await renderError(interaction, route, label, error, runtime);
+    }
+}
+async function dispatchFlat(interaction, root, runtime) {
+    if (!(await passesGuard(interaction, root.guard, runtime))) {
+        return;
+    }
+    await executeRoute(interaction, root, interaction.commandName, runtime);
+}
+async function dispatchGrouped(interaction, routes, commandGuard, runtime) {
+    const group = interaction.options.getSubcommandGroup(false);
+    const name = interaction.options.getSubcommand();
+    const label = routeKey(group, name);
+    const route = routes.get(label);
+    if (!route) {
+        const locale = interactionLocale(interaction, runtime);
+        await interaction.reply({
+            embeds: [
+                runtime.presenter.error(runtime.translator.translate(locale, i18n_1.CORE_MESSAGES.unknownSubcommand), locale),
+            ],
+            flags: discord_js_1.MessageFlags.Ephemeral,
+        });
+        return;
+    }
+    if (!(await passesGuard(interaction, route.guard ?? commandGuard, runtime))) {
+        return;
+    }
+    await executeRoute(interaction, route, label, runtime);
+}
+async function renderError(interaction, route, label, error, runtime) {
+    const { presenter, logger, translator } = runtime;
+    const locale = interactionLocale(interaction, runtime);
+    if (error instanceof errors_1.BusinessError) {
+        const text = error.translation
+            ? translator.translate(locale, error.translation.key, error.translation.params)
+            : error.message;
+        const embed = error.severity === "warning"
+            ? presenter.warning(text, locale)
+            : presenter.error(text, locale);
+        await (0, context_1.sendEmbed)(interaction, embed, route.ephemeral, logger);
+        return;
+    }
+    const ref = (0, errors_1.createIncidentRef)();
+    logger.error({
+        command: interaction.commandName,
+        subcommand: label,
+        userId: interaction.user.id,
+        ref,
+        err: error instanceof Error ? error.message : String(error),
+        stack: error instanceof Error ? error.stack : undefined,
+    }, "Command handler failed");
+    await (0, context_1.sendEmbed)(interaction, presenter.systemError(translator.resolve(locale, route.fallbackError ?? { key: i18n_1.CORE_MESSAGES.genericError }), ref, locale), route.ephemeral, logger);
+}
+/**
+ * Build a {@link SlashCommand} from a declarative definition: it produces the
+ * discord.js builder *and* the routing/guard/error pipeline. The runtime
+ * (presenter, logger) is injected per-dispatch by the command router.
+ */
+function createCommand(def) {
+    const builder = new discord_js_1.SlashCommandBuilder().setName(def.name).setDescription(def.description);
+    // Configured before the flat/grouped branching below: both return paths share
+    // this builder, so root-level settings must not be duplicated per branch.
+    applyRootSettings(builder, def);
+    if (def.handler) {
+        const handler = def.handler;
+        const root = {
+            description: def.description,
+            guard: def.guard,
+            fallbackError: def.fallbackError,
+            defer: def.defer ?? false,
+            ephemeral: def.ephemeral ?? true,
+            options: def.options ?? {},
+            invoke: (ctx) => handler(ctx),
+        };
+        for (const [optionName, option] of Object.entries(root.options)) {
+            option.apply(builder, optionName);
+        }
+        return {
+            data: builder,
+            guildIds: def.guildIds,
+            dispatch: (interaction, runtime) => dispatchFlat(interaction, root, runtime),
+            autocomplete: hasAutocomplete(root.options)
+                ? (interaction) => (0, autocomplete_1.respondWithSuggestions)(interaction, root.options)
+                : undefined,
+        };
+    }
+    const routes = new Map();
+    if (def.subcommands) {
+        for (const [name, subDef] of Object.entries(def.subcommands)) {
+            applySubcommand(builder, name, subDef);
+            routes.set(name, subDef);
+        }
+    }
+    if (def.groups) {
+        for (const [groupName, group] of Object.entries(def.groups)) {
+            builder.addSubcommandGroup((groupBuilder) => {
+                groupBuilder.setName(groupName).setDescription(group.description);
+                if (group.nameLocalizations) {
+                    groupBuilder.setNameLocalizations(group.nameLocalizations);
+                }
+                if (group.descriptionLocalizations) {
+                    groupBuilder.setDescriptionLocalizations(group.descriptionLocalizations);
+                }
+                for (const [name, subDef] of Object.entries(group.subcommands)) {
+                    applySubcommand(groupBuilder, name, subDef);
+                }
+                return groupBuilder;
+            });
+            for (const [name, subDef] of Object.entries(group.subcommands)) {
+                routes.set(routeKey(groupName, name), subDef);
+            }
+        }
+    }
+    return {
+        data: builder,
+        guildIds: def.guildIds,
+        dispatch: (interaction, runtime) => dispatchGrouped(interaction, routes, def.guard, runtime),
+        autocomplete: [...routes.values()].some((route) => hasAutocomplete(route.options))
+            ? (interaction) => (0, autocomplete_1.respondWithSuggestions)(interaction, (0, autocomplete_1.resolveRouteOptions)(interaction, routes, null))
+            : undefined,
+    };
+}
+/** Whether any option of a route declares a resolver, so the seam stays absent otherwise. */
+function hasAutocomplete(options) {
+    return Object.values(options).some((option) => option.autocomplete !== undefined);
+}
+//# sourceMappingURL=create-command.js.map

package/dist/discord/command/create-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-command.js","sourceRoot":"","sources":["../../../src/discord/command/create-command.ts"],"names":[],"mappings":"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"}

package/dist/discord/command/create-context-menu-command.d.ts

@@ -0,0 +1,51 @@
+import { type ContextMenuCommandInteraction, type LocalizationMap, type Message, type User } from "discord.js";
+import type { Guard } from "../../discord/command/guard";
+import type { ContextMenuCommand } from "../../discord/command/types";
+import { type PermissionBit } from "../../discord/permissions";
+import { type Locale, type LocalizedText, type TranslationParams } from "../../i18n";
+/**
+ * Context-menu commands: the entries a user reaches by right-clicking a member
+ * ("user" target) or a message ("message" target), under the Apps submenu.
+ *
+ * They are declared here rather than through `createCommand` because they are a
+ * different application command type: no name is typed, no options are parsed —
+ * the interaction carries the clicked target instead. Everything else (guards,
+ * permissions, error rendering) mirrors the slash-command pipeline so a module
+ * writes both the same way.
+ */
+/** The target handed to the handler, discriminated by the command's kind. */
+export interface ContextMenuTarget {
+    readonly user: User;
+    readonly message: Message;
+}
+export interface ContextMenuContext<K extends keyof ContextMenuTarget> {
+    readonly interaction: ContextMenuCommandInteraction;
+    /** The right-clicked member or message. */
+    readonly target: ContextMenuTarget[K];
+    /** Reply language: user's client locale → guild locale → configured default. */
+    readonly locale: Locale;
+    /** Translate a catalog key for this interaction's locale. */
+    t(key: string, params?: TranslationParams): string;
+    confirm(message: string): Promise<void>;
+    error(message: string): Promise<void>;
+    deny(message: string): Promise<void>;
+}
+export interface ContextMenuCommandDef<K extends keyof ContextMenuTarget> {
+    /** Displayed verbatim in the context menu, so spaces and capitals are allowed. */
+    name: string;
+    /** Which right-click surface the entry appears on. */
+    target: K;
+    nameLocalizations?: LocalizationMap;
+    guard?: Guard;
+    /** Display filter — pair it with a guard, it is not a security boundary. */
+    defaultMemberPermissions?: readonly PermissionBit[];
+    guildOnly?: boolean;
+    guildIds?: readonly string[];
+    /** Whether replies are ephemeral. Defaults to true. */
+    ephemeral?: boolean;
+    defer?: boolean;
+    fallbackError?: LocalizedText;
+    handler: (ctx: ContextMenuContext<K>) => Promise<void>;
+}
+export declare function createContextMenuCommand<K extends keyof ContextMenuTarget>(def: ContextMenuCommandDef<K>): ContextMenuCommand;
+//# sourceMappingURL=create-context-menu-command.d.ts.map

package/dist/discord/command/create-context-menu-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-context-menu-command.d.ts","sourceRoot":"","sources":["../../../src/discord/command/create-context-menu-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,KAAK,6BAA6B,EAGlC,KAAK,eAAe,EACpB,KAAK,OAAO,EAEZ,KAAK,IAAI,EACT,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAkB,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElF,OAAO,EAAE,KAAK,aAAa,EAAsB,MAAM,uBAAuB,CAAC;AAE/E,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,aAAa,EAAiB,KAAK,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAGhG;;;;;;;;;GASG;AAEH,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM,iBAAiB;IACpE,QAAQ,CAAC,WAAW,EAAE,6BAA6B,CAAC;IACpD,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IACtC,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC;IACnD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,MAAM,iBAAiB;IACvE,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,MAAM,EAAE,CAAC,CAAC;IACV,iBAAiB,CAAC,EAAE,eAAe,CAAC;IACpC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,4EAA4E;IAC5E,wBAAwB,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACpD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,uDAAuD;IACvD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,OAAO,EAAE,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AA6BD,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,MAAM,iBAAiB,EACzE,GAAG,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAC3B,kBAAkB,CAqBpB"}

package/dist/discord/command/create-context-menu-command.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createContextMenuCommand = createContextMenuCommand;
+const discord_js_1 = require("discord.js");
+const errors_1 = require("../../discord/command/errors");
+const i18n_1 = require("../../discord/i18n");
+const permissions_1 = require("../../discord/permissions");
+const errors_2 = require("../../errors");
+const i18n_2 = require("../../i18n");
+const COMMAND_TYPES = {
+    user: discord_js_1.ApplicationCommandType.User,
+    message: discord_js_1.ApplicationCommandType.Message,
+};
+/**
+ * Resolve the clicked target. discord.js exposes it through kind-specific
+ * getters, so the narrowing happens once here rather than in every handler.
+ *
+ * The kind cannot actually mismatch at runtime — Discord routes an interaction
+ * to the command it was registered as — but the resolver still asserts it, so a
+ * misroute surfaces as a named error instead of an undefined target reaching the
+ * handler.
+ */
+function resolveTarget(interaction, kind) {
+    if (kind === "user" && interaction.isUserContextMenuCommand()) {
+        return interaction.targetUser;
+    }
+    if (kind === "message" && interaction.isMessageContextMenuCommand()) {
+        return interaction.targetMessage;
+    }
+    throw new errors_1.ContextMenuTargetError(interaction.commandName, kind);
+}
+function createContextMenuCommand(def) {
+    const ephemeral = def.ephemeral ?? true;
+    const builder = new discord_js_1.ContextMenuCommandBuilder()
+        .setName(def.name)
+        .setType(COMMAND_TYPES[def.target]);
+    if (def.nameLocalizations) {
+        builder.setNameLocalizations(def.nameLocalizations);
+    }
+    if (def.defaultMemberPermissions) {
+        builder.setDefaultMemberPermissions((0, permissions_1.resolvePermissions)(def.defaultMemberPermissions));
+    }
+    if (def.guildOnly) {
+        builder.setContexts(discord_js_1.InteractionContextType.Guild);
+    }
+    return {
+        data: builder,
+        guildIds: def.guildIds,
+        dispatch: (interaction, runtime) => dispatch(interaction, def, ephemeral, runtime),
+    };
+}
+async function dispatch(interaction, def, ephemeral, runtime) {
+    const { presenter, logger, translator } = runtime;
+    const locale = (0, i18n_2.resolveLocale)([interaction.locale, interaction.guildLocale], translator.defaultLocale);
+    if (def.guard) {
+        const result = await def.guard.check(interaction);
+        if (!result.ok) {
+            await interaction.reply({
+                embeds: [presenter.denial(translator.resolve(locale, result.message), locale)],
+                flags: discord_js_1.MessageFlags.Ephemeral,
+            });
+            return;
+        }
+    }
+    try {
+        if (def.defer) {
+            await interaction.deferReply(ephemeral ? { flags: discord_js_1.MessageFlags.Ephemeral } : {});
+        }
+        await def.handler({
+            interaction,
+            target: resolveTarget(interaction, def.target),
+            locale,
+            t: (key, params) => translator.translate(locale, key, params),
+            confirm: (message) => send(interaction, presenter.confirmation(message, locale), ephemeral, logger),
+            error: (message) => send(interaction, presenter.error(message, locale), ephemeral, logger),
+            deny: (message) => send(interaction, presenter.denial(message, locale), ephemeral, logger),
+        });
+    }
+    catch (error) {
+        if (error instanceof errors_2.BusinessError) {
+            const text = error.translation
+                ? translator.translate(locale, error.translation.key, error.translation.params)
+                : error.message;
+            const embed = error.severity === "warning"
+                ? presenter.warning(text, locale)
+                : presenter.error(text, locale);
+            await send(interaction, embed, ephemeral, logger);
+            return;
+        }
+        const ref = (0, errors_2.createIncidentRef)();
+        logger.error({
+            command: interaction.commandName,
+            userId: interaction.user.id,
+            ref,
+            err: error instanceof Error ? error.message : String(error),
+            stack: error instanceof Error ? error.stack : undefined,
+        }, "Context menu handler failed");
+        await send(interaction, presenter.systemError(translator.resolve(locale, def.fallbackError ?? { key: i18n_1.CORE_MESSAGES.genericError }), ref, locale), ephemeral, logger);
+    }
+}
+/**
+ * Deliver an embed whatever the interaction's lifecycle state, and never throw:
+ * a failed delivery (e.g. an expired interaction) must not escape into the
+ * client's unhandled `error` event. Mirrors the command pipeline's `sendEmbed`,
+ * which is typed for chat-input interactions only.
+ */
+async function send(interaction, embed, ephemeral, logger) {
+    const flags = ephemeral ? discord_js_1.MessageFlags.Ephemeral : undefined;
+    try {
+        if (interaction.deferred) {
+            await interaction.editReply({ embeds: [embed] });
+            return;
+        }
+        if (interaction.replied) {
+            await interaction.followUp({ embeds: [embed], flags });
+            return;
+        }
+        await interaction.reply({ embeds: [embed], flags });
+    }
+    catch (error) {
+        logger.error({
+            commandName: interaction.commandName,
+            interactionId: interaction.id,
+            err: error instanceof Error ? error.message : String(error),
+        }, "Failed to deliver interaction response");
+    }
+}
+//# sourceMappingURL=create-context-menu-command.js.map