@azurioh/discord-kernel 0.1.0

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

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

package/dist/discord/command/errors.d.ts

@@ -0,0 +1,19 @@
+import { ValidationError } from "../../errors";
+/**
+ * Raised when a slash command option is declared or read in a way discord.js
+ * cannot honour (an unsupported `choices` call, a value that fails parsing).
+ * A `ValidationError`, so the command pipeline renders it as user feedback
+ * rather than an incident.
+ */
+export declare class OptionValidationError extends ValidationError {
+}
+/**
+ * Raised when a context-menu interaction does not carry the target its command
+ * was declared for. Discord routes an interaction to the command it was
+ * registered as, so this signals a misregistration rather than user input —
+ * hence a plain `Error`, rendered as an incident with a reference.
+ */
+export declare class ContextMenuTargetError extends Error {
+    constructor(commandName: string, expected: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/discord/command/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/discord/command/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;;GAKG;AACH,qBAAa,qBAAsB,SAAQ,eAAe;CAAG;AAE7D;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;gBACpC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAIjD"}

package/dist/discord/command/errors.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextMenuTargetError = exports.OptionValidationError = void 0;
+const errors_1 = require("../../errors");
+/**
+ * Raised when a slash command option is declared or read in a way discord.js
+ * cannot honour (an unsupported `choices` call, a value that fails parsing).
+ * A `ValidationError`, so the command pipeline renders it as user feedback
+ * rather than an incident.
+ */
+class OptionValidationError extends errors_1.ValidationError {
+}
+exports.OptionValidationError = OptionValidationError;
+/**
+ * Raised when a context-menu interaction does not carry the target its command
+ * was declared for. Discord routes an interaction to the command it was
+ * registered as, so this signals a misregistration rather than user input —
+ * hence a plain `Error`, rendered as an incident with a reference.
+ */
+class ContextMenuTargetError extends Error {
+    constructor(commandName, expected) {
+        super(`Context menu command "${commandName}" expected a ${expected} target.`);
+        this.name = "ContextMenuTargetError";
+    }
+}
+exports.ContextMenuTargetError = ContextMenuTargetError;
+//# sourceMappingURL=errors.js.map

package/dist/discord/command/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/discord/command/errors.ts"],"names":[],"mappings":";;;AAAA,qCAA2C;AAE3C;;;;;GAKG;AACH,MAAa,qBAAsB,SAAQ,wBAAe;CAAG;AAA7D,sDAA6D;AAE7D;;;;;GAKG;AACH,MAAa,sBAAuB,SAAQ,KAAK;IAChD,YAAY,WAAmB,EAAE,QAAgB;QAChD,KAAK,CAAC,yBAAyB,WAAW,gBAAgB,QAAQ,UAAU,CAAC,CAAC;QAC9E,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACtC,CAAC;CACD;AALD,wDAKC"}

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

@@ -0,0 +1,30 @@
+import type { CommandInteraction } from "discord.js";
+import type { LocalizedText } from "../../i18n";
+export type GuardResult = {
+    ok: true;
+} | {
+    ok: false;
+    message: LocalizedText;
+};
+/**
+ * An authorization check run before a command/subcommand handler. Guards are
+ * generic by design: the core defines the contract, while concrete rules (admin,
+ * role, ownership…) live in the feature module that owns the relevant state.
+ *
+ * Typed on `CommandInteraction` — the base shared by chat-input and context-menu
+ * commands — so one guard protects both kinds without a cast.
+ *
+ * `check` is a *property* with a function type, not a method: TypeScript checks
+ * method parameters bivariantly, which would let a guard written for
+ * `ChatInputCommandInteraction` be attached to a context-menu command and read
+ * options that interaction never carries. As a property it is contravariant, so
+ * that mistake is a compile error.
+ */
+export interface Guard {
+    readonly check: (interaction: CommandInteraction) => GuardResult | Promise<GuardResult>;
+}
+/** Compose guards: every guard must pass, short-circuiting on the first denial. */
+export declare function allOf(...guards: Guard[]): Guard;
+/** Pass when any guard passes; otherwise deny with `denyMessage`. */
+export declare function anyOf(denyMessage: LocalizedText, ...guards: Guard[]): Guard;
+//# sourceMappingURL=guard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../../src/discord/command/guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE5C,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,aAAa,CAAA;CAAE,CAAC;AAE/E;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,KAAK;IACrB,QAAQ,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,kBAAkB,KAAK,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACxF;AAID,mFAAmF;AACnF,wBAAgB,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAY/C;AAED,qEAAqE;AACrE,wBAAgB,KAAK,CAAC,WAAW,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAY3E"}

package/dist/discord/command/guard.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allOf = allOf;
+exports.anyOf = anyOf;
+const ALLOW = { ok: true };
+/** Compose guards: every guard must pass, short-circuiting on the first denial. */
+function allOf(...guards) {
+    return {
+        async check(interaction) {
+            for (const guard of guards) {
+                const result = await guard.check(interaction);
+                if (!result.ok) {
+                    return result;
+                }
+            }
+            return ALLOW;
+        },
+    };
+}
+/** Pass when any guard passes; otherwise deny with `denyMessage`. */
+function anyOf(denyMessage, ...guards) {
+    return {
+        async check(interaction) {
+            for (const guard of guards) {
+                const result = await guard.check(interaction);
+                if (result.ok) {
+                    return ALLOW;
+                }
+            }
+            return { ok: false, message: denyMessage };
+        },
+    };
+}
+//# sourceMappingURL=guard.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../../../src/discord/command/guard.ts"],"names":[],"mappings":";;AA0BA,sBAYC;AAGD,sBAYC;AA9BD,MAAM,KAAK,GAAgB,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AAExC,mFAAmF;AACnF,SAAgB,KAAK,CAAC,GAAG,MAAe;IACvC,OAAO;QACN,KAAK,CAAC,KAAK,CAAC,WAAW;YACtB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC5B,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;gBAC9C,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;oBAChB,OAAO,MAAM,CAAC;gBACf,CAAC;YACF,CAAC;YACD,OAAO,KAAK,CAAC;QACd,CAAC;KACD,CAAC;AACH,CAAC;AAED,qEAAqE;AACrE,SAAgB,KAAK,CAAC,WAA0B,EAAE,GAAG,MAAe;IACnE,OAAO;QACN,KAAK,CAAC,KAAK,CAAC,WAAW;YACtB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC5B,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;gBAC9C,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;oBACf,OAAO,KAAK,CAAC;gBACd,CAAC;YACF,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;QAC5C,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/discord/command/localization.d.ts

@@ -0,0 +1,9 @@
+import type { LocalizationMap } from "discord.js";
+/**
+ * The single discord.js locale code for French, mapped to the given text. This
+ * bot's commands, subcommands and options default to English, so this is what
+ * adds the French translation without repeating `{ fr: ... }` at every call
+ * site.
+ */
+export declare function frenchLocalization(text: string): LocalizationMap;
+//# sourceMappingURL=localization.d.ts.map

package/dist/discord/command/localization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localization.d.ts","sourceRoot":"","sources":["../../../src/discord/command/localization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAEhE"}

package/dist/discord/command/localization.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.frenchLocalization = frenchLocalization;
+/**
+ * The single discord.js locale code for French, mapped to the given text. This
+ * bot's commands, subcommands and options default to English, so this is what
+ * adds the French translation without repeating `{ fr: ... }` at every call
+ * site.
+ */
+function frenchLocalization(text) {
+    return { fr: text };
+}
+//# sourceMappingURL=localization.js.map

package/dist/discord/command/localization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localization.js","sourceRoot":"","sources":["../../../src/discord/command/localization.ts"],"names":[],"mappings":";;AAQA,gDAEC;AARD;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,IAAY;IAC9C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACrB,CAAC"}

package/dist/discord/command/options.d.ts

@@ -0,0 +1,113 @@
+import type { ApplicationCommandOptionAllowedChannelTypes, Attachment, AutocompleteInteraction, ChannelType, ChatInputCommandInteraction, GuildBasedChannel, LocalizationMap, Role, SlashCommandAttachmentOption, SlashCommandBooleanOption, SlashCommandChannelOption, SlashCommandIntegerOption, SlashCommandMentionableOption, SlashCommandNumberOption, SlashCommandRoleOption, SlashCommandStringOption, SlashCommandUserOption, User } from "discord.js";
+/**
+ * Translated name/description for a single option, keyed by Discord locale
+ * (e.g. `{ nameLocalizations: { "en-US": "channel", "en-GB": "channel" } }`).
+ * Every `create*Option` factory accepts this so an option's picker label can be
+ * localised the same way a command/subcommand name already can.
+ */
+export interface OptionLocalizations {
+    nameLocalizations?: LocalizationMap;
+    descriptionLocalizations?: LocalizationMap;
+}
+/**
+ * The subset of a discord.js builder an option needs to register itself.
+ * Both `SlashCommandBuilder` (flat commands) and `SlashCommandSubcommandBuilder`
+ * satisfy this structurally, so the same option works on either.
+ */
+export interface OptionContainer {
+    addStringOption(input: (option: SlashCommandStringOption) => SlashCommandStringOption): unknown;
+    addUserOption(input: (option: SlashCommandUserOption) => SlashCommandUserOption): unknown;
+    addBooleanOption(input: (option: SlashCommandBooleanOption) => SlashCommandBooleanOption): unknown;
+    addIntegerOption(input: (option: SlashCommandIntegerOption) => SlashCommandIntegerOption): unknown;
+    addNumberOption(input: (option: SlashCommandNumberOption) => SlashCommandNumberOption): unknown;
+    addChannelOption(input: (option: SlashCommandChannelOption) => SlashCommandChannelOption): unknown;
+    addRoleOption(input: (option: SlashCommandRoleOption) => SlashCommandRoleOption): unknown;
+    addMentionableOption(input: (option: SlashCommandMentionableOption) => SlashCommandMentionableOption): unknown;
+    addAttachmentOption(input: (option: SlashCommandAttachmentOption) => SlashCommandAttachmentOption): unknown;
+}
+/** A single suggestion returned to Discord while the user types. */
+export interface Choice {
+    readonly name: string;
+    readonly value: string | number;
+}
+/**
+ * Computes the suggestions for a focused option. Sync resolvers are allowed so a
+ * static list does not have to pay for a promise.
+ */
+export type AutocompleteResolver = (interaction: AutocompleteInteraction) => Promise<readonly Choice[]> | readonly Choice[];
+export interface Option<TValue, TRequired extends boolean> {
+    readonly description: string;
+    readonly isRequired: TRequired;
+    /** Present only on the option types Discord lets us autocomplete. */
+    readonly autocomplete?: AutocompleteResolver;
+    required(): Option<TValue, true>;
+    choices<const C extends readonly TValue[]>(values: C): Option<C[number], TRequired>;
+    apply(container: OptionContainer, name: string): void;
+    read(interaction: ChatInputCommandInteraction, name: string): TRequired extends true ? TValue : TValue | null;
+}
+/**
+ * The option types Discord accepts `autocomplete` on (string, integer, number).
+ * `required()` is narrowed so `.withAutocomplete()` stays reachable after it,
+ * while `choices()` deliberately falls back to a plain `Option`: Discord forbids
+ * combining both, so the illegal chain is unrepresentable rather than merely
+ * rejected at registration.
+ */
+export interface AutocompletableOption<TValue, TRequired extends boolean> extends Option<TValue, TRequired> {
+    required(): AutocompletableOption<TValue, true>;
+    withAutocomplete(resolver: AutocompleteResolver): AutocompletableOption<TValue, TRequired>;
+}
+export type Options = Record<string, Option<unknown, boolean>>;
+export type Values<O extends Options> = {
+    [K in keyof O]: O[K] extends Option<infer V, infer R> ? (R extends true ? V : V | null) : never;
+};
+/** Length limits for a string option, mirroring the numeric bounds below. */
+interface StringLengthBounds {
+    minLength?: number;
+    maxLength?: number;
+}
+export declare function createStringOption(description: string, bounds?: StringLengthBounds, localizations?: OptionLocalizations): AutocompletableOption<string, false>;
+export declare function createUserOption(description: string, localizations?: OptionLocalizations): Option<User, false>;
+export declare function createBooleanOption(description: string, localizations?: OptionLocalizations): Option<boolean, false>;
+interface IntegerBounds {
+    min?: number;
+    max?: number;
+}
+export declare function createIntegerOption(description: string, bounds?: IntegerBounds, localizations?: OptionLocalizations): AutocompletableOption<number, false>;
+export declare function createNumberOption(description: string, bounds?: IntegerBounds, localizations?: OptionLocalizations): AutocompletableOption<number, false>;
+export declare function createDateTimeOption(description: string, localizations?: OptionLocalizations): Option<Date, false>;
+/**
+ * A `YYYY-MM-DD[ HH:MM[:SS]]` string option, validated against the wall-clock
+ * grammar but left unanchored (no `Date` conversion, no assumed timezone) — the
+ * caller anchors it with `zonedWallClockToUtc` once it knows the guild zone.
+ */
+export declare function createWallClockOption(description: string, localizations?: OptionLocalizations): Option<string, false>;
+/**
+ * A strict date-only (`YYYY-MM-DD`) option. The returned `Date` is UTC
+ * midnight of that calendar day — a caller that needs it anchored to a guild
+ * timezone (start/end of that guild-local day) uses `startOfGuildDay`/
+ * `endOfGuildDay` from `core/datetime`.
+ */
+export declare function createDateOption(description: string, localizations?: OptionLocalizations): Option<Date, false>;
+/** The channel types Discord accepts on a channel option (guild channels only). */
+type AllowedChannelType = ApplicationCommandOptionAllowedChannelTypes;
+/**
+ * Narrows the guild channel union to the declared channel types, mirroring the
+ * `Extract<>` mapping of `CommandInteractionOptionResolver.getChannel`. The
+ * thread ternary is load-bearing: `PublicThreadChannel.type` is
+ * `PublicThread | AnnouncementThread`, so extracting on a single one of them
+ * would collapse to `never`.
+ */
+export type ChannelOptionValue<TType extends AllowedChannelType> = Extract<GuildBasedChannel, {
+    type: TType extends ChannelType.PublicThread | ChannelType.AnnouncementThread ? ChannelType.PublicThread | ChannelType.AnnouncementThread : TType;
+}>;
+export declare function createChannelOption<const TType extends AllowedChannelType = AllowedChannelType>(description: string, channelTypes?: readonly TType[], localizations?: OptionLocalizations): Option<ChannelOptionValue<TType>, false>;
+export declare function createRoleOption(description: string, localizations?: OptionLocalizations): Option<Role, false>;
+export declare function createMentionableOption(description: string, localizations?: OptionLocalizations): Option<Role | User, false>;
+export declare function createAttachmentOption(description: string, localizations?: OptionLocalizations): Option<Attachment, false>;
+type AsRequired<O> = O extends Option<infer V, boolean> ? Option<V, true> : never;
+/** Turn every option in a record into its required variant. */
+export declare function allRequired<O extends Options>(fields: O): {
+    [K in keyof O]: AsRequired<O[K]>;
+};
+export {};
+//# sourceMappingURL=options.d.ts.map

package/dist/discord/command/options.d.ts.map

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