@went.tf/discord-bot-framework 2.0.0

package/build/api-client/api-http-exception.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-http-exception.d.ts","sourceRoot":"","sources":["../../src/api-client/api-http-exception.ts"],"names":[],"mappings":"AAAA,qBAAa,gBAAiB,SAAQ,KAAK;aACb,OAAO,EAAE,MAAM;aAAkB,MAAM,EAAE,MAAM;aAAkB,KAAK,CAAC,EAAE,OAAO;gBAAhF,OAAO,EAAE,MAAM,EAAkB,MAAM,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,OAAO,YAAA;CAG7G"}

package/build/api-client/api-http-exception.js

@@ -0,0 +1,12 @@
+export class ApiHttpException extends Error {
+    message;
+    status;
+    cause;
+    constructor(message, status, cause) {
+        super(message);
+        this.message = message;
+        this.status = status;
+        this.cause = cause;
+    }
+}
+//# sourceMappingURL=api-http-exception.js.map

package/build/api-client/api-http-exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-http-exception.js","sourceRoot":"","sources":["../../src/api-client/api-http-exception.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACb;IAAiC;IAAgC;IAA7F,YAA4B,OAAe,EAAkB,MAAc,EAAkB,KAAe;QAC1G,KAAK,CAAC,OAAO,CAAC,CAAC;QADW,YAAO,GAAP,OAAO,CAAQ;QAAkB,WAAM,GAAN,MAAM,CAAQ;QAAkB,UAAK,GAAL,KAAK,CAAU;IAE5G,CAAC;CACF"}

package/build/api-client/index.d.ts

@@ -0,0 +1,4 @@
+export * from './api-client.js';
+export * from './api-http-exception.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/build/api-client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api-client/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC"}

package/build/api-client/index.js

@@ -0,0 +1,4 @@
+export * from './api-client.js';
+export * from './api-http-exception.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/build/api-client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api-client/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC"}

package/build/api-client/types.d.ts

@@ -0,0 +1,105 @@
+export declare enum ApiAuthType {
+    QUERY_PARAM = "query_param",
+    AUTHORIZATION_HEADER = "bearer",
+    CUSTOM_HEADER = "custom_header",
+    PATH_SEGMENT = "path_segment"
+}
+export interface BaseApiAuthMethod {
+    type: ApiAuthType;
+}
+export interface QueryParamApiAuthMethod extends BaseApiAuthMethod {
+    type: ApiAuthType.QUERY_PARAM;
+    paramName: string;
+    /** Returns the param value, e.g. `() => env.API_TOKEN` */
+    getValue: () => string;
+}
+export interface BearerTokenApiAuthMethod extends BaseApiAuthMethod {
+    type: ApiAuthType.AUTHORIZATION_HEADER;
+    /**
+     * @default 'Bearer'
+     */
+    tokenType?: string;
+    /** Returns the bearer token, e.g. `() => env.API_TOKEN` */
+    getValue: () => string;
+}
+export interface CustomHeaderApiAuthMethod extends BaseApiAuthMethod {
+    type: ApiAuthType.CUSTOM_HEADER;
+    headerName: string;
+    /** Returns the header value, e.g. `() => env.API_TOKEN` */
+    getValue: () => string;
+}
+export interface PathSegmentApiAuthMethod extends BaseApiAuthMethod {
+    type: ApiAuthType.PATH_SEGMENT;
+    /**
+     * Placeholder in `path` to substitute with the token value, e.g. `:token`
+     * @default ':token'
+     */
+    placeholder?: string;
+    /** Returns the value to substitute into the path, e.g. `() => env.API_TOKEN` */
+    getValue: () => string;
+}
+export type ApiAuthMethod = QueryParamApiAuthMethod | BearerTokenApiAuthMethod | PathSegmentApiAuthMethod | CustomHeaderApiAuthMethod;
+/**
+ * Structural subset of typia's `IValidation<T>` shape. Bots that already use
+ * typia can pass `typia.createValidate<T>()` directly; bots that don't can
+ * hand-write a check or omit `validator` entirely to get `response: unknown`.
+ */
+export type ValidationResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    errors: unknown[];
+};
+export interface ApiRequest<T> {
+    path: string;
+    method?: string;
+    query?: Record<string, string>;
+    body?: unknown;
+    /**
+     * If true, the response will not be JSON parsed and `raw` stream data is
+     * returned instead.
+     */
+    raw?: boolean;
+    /**
+     * Validates/narrows the parsed response. If omitted, `response` is typed
+     * as `unknown` and no validation is performed.
+     */
+    validator?: (data: unknown) => ValidationResult<T>;
+    /**
+     * Throw an error if the response does not pass validation
+     * @default true
+     */
+    failOnInvalidResponse?: boolean;
+}
+export interface ApiResponse<T> {
+    responseText: string | undefined;
+    response: T;
+    validation?: ValidationResult<T>;
+    ok: boolean;
+    status: number;
+}
+export interface RetryOptions {
+    /**
+     * Total number of attempts (first try + retries).
+     * @default 1 (no retries)
+     */
+    maxAttempts?: number;
+    /**
+     * Delay before the first retry in milliseconds. Doubles on each subsequent retry.
+     * @default 500
+     */
+    initialDelayMs?: number;
+    /**
+     * Return true to retry after this error. By default retries on 5xx and 429.
+     */
+    shouldRetry?: (error: unknown) => boolean;
+}
+export interface ApiClientOptions {
+    baseUrl: string;
+    authentication?: Readonly<ApiAuthMethod>;
+    fixedHeaders?: Readonly<Record<string, string>>;
+    userAgent?: string;
+    retry?: RetryOptions;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/api-client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/api-client/types.ts"],"names":[],"mappings":"AAAA,oBAAY,WAAW;IACrB,WAAW,gBAAgB;IAC3B,oBAAoB,WAAW;IAC/B,aAAa,kBAAkB;IAC/B,YAAY,iBAAiB;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,IAAI,EAAE,WAAW,CAAC,WAAW,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,wBAAyB,SAAQ,iBAAiB;IACjE,IAAI,EAAE,WAAW,CAAC,oBAAoB,CAAC;IACvC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAClE,IAAI,EAAE,WAAW,CAAC,aAAa,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,wBAAyB,SAAQ,iBAAiB;IACjE,IAAI,EAAE,WAAW,CAAC,YAAY,CAAC;IAC/B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,QAAQ,EAAE,MAAM,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,aAAa,GACrB,uBAAuB,GACvB,wBAAwB,GACxB,wBAAwB,GACxB,yBAAyB,CAAC;AAE9B;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAC1B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC;AAE1C,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACnD;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,EAAE,CAAC,CAAC;IACZ,UAAU,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CAC3C;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IACzC,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB"}

package/build/api-client/types.js

@@ -0,0 +1,8 @@
+export var ApiAuthType;
+(function (ApiAuthType) {
+    ApiAuthType["QUERY_PARAM"] = "query_param";
+    ApiAuthType["AUTHORIZATION_HEADER"] = "bearer";
+    ApiAuthType["CUSTOM_HEADER"] = "custom_header";
+    ApiAuthType["PATH_SEGMENT"] = "path_segment";
+})(ApiAuthType || (ApiAuthType = {}));
+//# sourceMappingURL=types.js.map

package/build/api-client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api-client/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,0CAA2B,CAAA;IAC3B,8CAA+B,CAAA;IAC/B,8CAA+B,CAAA;IAC/B,4CAA6B,CAAA;AAC/B,CAAC,EALW,WAAW,KAAX,WAAW,QAKtB"}

package/build/client/create-bot-client.d.ts

@@ -0,0 +1,14 @@
+import { Client, ClientOptions, Interaction } from 'discord.js';
+export interface CreateBotClientOptions extends Omit<ClientOptions, 'intents'> {
+    intents: ClientOptions['intents'];
+    token: string;
+    onReady?: (client: Client<true>) => void | Promise<void>;
+    onInteraction: (interaction: Interaction) => void | Promise<void>;
+}
+/**
+ * Creates and logs in a single (unsharded) discord.js Client, wiring the
+ * `ready` and `interactionCreate` events. For bots that shard, see
+ * `createShardManager` instead.
+ */
+export declare function createBotClient(options: CreateBotClientOptions): Promise<Client<true>>;
+//# sourceMappingURL=create-bot-client.d.ts.map

package/build/client/create-bot-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-bot-client.d.ts","sourceRoot":"","sources":["../../src/client/create-bot-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAU,WAAW,EAAE,MAAM,YAAY,CAAC;AAExE,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC;IAC5E,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,aAAa,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAa5F"}

package/build/client/create-bot-client.js

@@ -0,0 +1,19 @@
+import { Client, Events } from 'discord.js';
+/**
+ * Creates and logs in a single (unsharded) discord.js Client, wiring the
+ * `ready` and `interactionCreate` events. For bots that shard, see
+ * `createShardManager` instead.
+ */
+export async function createBotClient(options) {
+    const { token, onReady, onInteraction, ...clientOptions } = options;
+    const client = new Client(clientOptions);
+    if (onReady) {
+        client.on(Events.ClientReady, onReady);
+    }
+    client.on(Events.InteractionCreate, async (interaction) => {
+        await onInteraction(interaction);
+    });
+    await client.login(token);
+    return client;
+}
+//# sourceMappingURL=create-bot-client.js.map

package/build/client/create-bot-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-bot-client.js","sourceRoot":"","sources":["../../src/client/create-bot-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAiB,MAAM,EAAe,MAAM,YAAY,CAAC;AASxE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAA+B;IACnE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,CAAC;IACpE,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,aAAa,CAAC,CAAC;IAEzC,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,iBAAiB,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE;QACxD,MAAM,aAAa,CAAC,WAAW,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1B,OAAO,MAAsB,CAAC;AAChC,CAAC"}

package/build/client/create-shard-manager.d.ts

@@ -0,0 +1,17 @@
+import { ShardingManager, ShardingManagerOptions } from 'discord.js';
+import { NestableLogger } from '../logger/types.js';
+export interface CreateShardManagerOptions extends Omit<ShardingManagerOptions, 'token'> {
+    token: string;
+    botScriptPath: string;
+    logger: NestableLogger;
+    /** Runs once before shards are spawned, e.g. to sync slash commands. */
+    beforeSpawn?: () => Promise<void>;
+}
+/**
+ * Thin wrapper over discord.js's `ShardingManager`: forwards shard lifecycle
+ * events to the given logger and spawns shards, optionally running a
+ * `beforeSpawn` hook first. Kept deliberately minimal — orchestration logic
+ * specific to a bot (e.g. what exactly `beforeSpawn` does) stays bot-side.
+ */
+export declare function createShardManager(options: CreateShardManagerOptions): Promise<ShardingManager>;
+//# sourceMappingURL=create-shard-manager.d.ts.map

package/build/client/create-shard-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-shard-manager.d.ts","sourceRoot":"","sources":["../../src/client/create-shard-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,WAAW,yBAA0B,SAAQ,IAAI,CAAC,sBAAsB,EAAE,OAAO,CAAC;IACtF,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,cAAc,CAAC;IACvB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,eAAe,CAAC,CAqBrG"}

package/build/client/create-shard-manager.js

@@ -0,0 +1,26 @@
+import { ShardingManager } from 'discord.js';
+/**
+ * Thin wrapper over discord.js's `ShardingManager`: forwards shard lifecycle
+ * events to the given logger and spawns shards, optionally running a
+ * `beforeSpawn` hook first. Kept deliberately minimal — orchestration logic
+ * specific to a bot (e.g. what exactly `beforeSpawn` does) stays bot-side.
+ */
+export async function createShardManager(options) {
+    const { token, botScriptPath, logger, beforeSpawn, ...managerOptions } = options;
+    if (beforeSpawn) {
+        await beforeSpawn();
+    }
+    logger.log(`Starting recommended number of shards with path ${botScriptPath}`);
+    const manager = new ShardingManager(botScriptPath, { token, ...managerOptions });
+    manager.on('shardCreate', (shard) => {
+        logger.log(`Shard ${shard.id} created`);
+        shard.on('spawn', () => logger.log(`Shard ${shard.id} spawned`));
+        shard.on('ready', () => logger.log(`Shard ${shard.id} ready`));
+        shard.on('disconnect', () => logger.log(`Shard ${shard.id} disconnected`));
+        shard.on('reconnecting', () => logger.log(`Shard ${shard.id} reconnecting`));
+        shard.on('death', () => logger.log(`Shard ${shard.id} died`));
+    });
+    await manager.spawn();
+    return manager;
+}
+//# sourceMappingURL=create-shard-manager.js.map

package/build/client/create-shard-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-shard-manager.js","sourceRoot":"","sources":["../../src/client/create-shard-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA0B,MAAM,YAAY,CAAC;AAWrE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAkC;IACzE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,CAAC;IAEjF,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,WAAW,EAAE,CAAC;IACtB,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,mDAAmD,aAAa,EAAE,CAAC,CAAC;IAC/E,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,GAAG,cAAc,EAAE,CAAC,CAAC;IAEjF,OAAO,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE;QAClC,MAAM,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC;QACxC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;QACjE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC/D,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC;QAC3E,KAAK,CAAC,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC;QAC7E,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACtB,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/build/client/index.d.ts

@@ -0,0 +1,3 @@
+export * from './create-bot-client.js';
+export * from './create-shard-manager.js';
+//# sourceMappingURL=index.d.ts.map

package/build/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC"}

package/build/client/index.js

@@ -0,0 +1,3 @@
+export * from './create-bot-client.js';
+export * from './create-shard-manager.js';
+//# sourceMappingURL=index.js.map

package/build/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC"}

package/build/commands/build-application-commands-body.d.ts

@@ -0,0 +1,39 @@
+import { RESTPostAPIApplicationCommandsJSONBody } from 'discord-api-types/v10';
+import { NamedChatInputCommand, NamedContextMenuCommand, Registry } from '../interactions/registry.js';
+import { BaseInteractionContext } from '../interactions/types.js';
+import { CommandFileEntry } from './schema/index.js';
+export type DescriptionResolver = (path: readonly string[]) => string | undefined;
+export type LocalizationResolver = (path: readonly string[]) => Record<string, string> | undefined;
+export interface BuildApplicationCommandsBodyOptions {
+    /** Merged into every commands.json entry. The entry's own fields win on conflict. */
+    sharedMetadata?: Partial<RESTPostAPIApplicationCommandsJSONBody>;
+    /**
+     * Called with a dot-path-shaped key array (e.g. `['commands', 'search', 'description']`,
+     * or `['commands', 'search', 'options', 'query', 'description']`) for every
+     * command/option whose commands.json entry has no `description` of its own.
+     * Pass a `createCommandLocalizer(...).resolveDescription` here to fill
+     * descriptions from i18next at submission time instead of authoring them
+     * by hand in commands.json.
+     */
+    resolveDescription?: DescriptionResolver;
+    /** Same path convention as `resolveDescription`, but for `name`/`name_localizations`. */
+    localizeNames?: LocalizationResolver;
+    /** Same path convention as `resolveDescription`, but for `description_localizations`. */
+    localizeDescriptions?: LocalizationResolver;
+}
+export interface BuildApplicationCommandsBodyRegistries<Ctx extends BaseInteractionContext, ChatInputName extends string = string, ContextMenuName extends string = string> {
+    chatInput?: Registry<ChatInputName, NamedChatInputCommand<Ctx, ChatInputName>>;
+    contextMenu?: Registry<ContextMenuName, NamedContextMenuCommand<Ctx, ContextMenuName>>;
+}
+/**
+ * Builds the flat `RESTPostAPIApplicationCommandsJSONBody[]` `createCommandRegistrar`
+ * expects from a validated commands.json array plus the bot's handler registries.
+ * `commandsFile`'s own order drives the output order (not registry insertion order).
+ *
+ * Every commands.json entry must have a matching handler, and every handler must have
+ * a matching commands.json entry - both directions throw one combined error listing
+ * every offender, same as a command/option left with no resolvable description. This
+ * never silently sends an incomplete body to Discord's API.
+ */
+export declare function buildApplicationCommandsBody<Ctx extends BaseInteractionContext>(commandsFile: readonly CommandFileEntry[], registries: BuildApplicationCommandsBodyRegistries<Ctx>, options?: BuildApplicationCommandsBodyOptions): RESTPostAPIApplicationCommandsJSONBody[];
+//# sourceMappingURL=build-application-commands-body.d.ts.map

package/build/commands/build-application-commands-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-application-commands-body.d.ts","sourceRoot":"","sources":["../../src/commands/build-application-commands-body.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,sCAAsC,EAAE,MAAM,uBAAuB,CAAC;AAC5G,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvG,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAuD,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1G,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,MAAM,GAAG,SAAS,CAAC;AAClF,MAAM,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;AAEnG,MAAM,WAAW,mCAAmC;IAClD,qFAAqF;IACrF,cAAc,CAAC,EAAE,OAAO,CAAC,sCAAsC,CAAC,CAAC;IACjE;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;IACzC,yFAAyF;IACzF,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,yFAAyF;IACzF,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAED,MAAM,WAAW,sCAAsC,CACrD,GAAG,SAAS,sBAAsB,EAClC,aAAa,SAAS,MAAM,GAAG,MAAM,EACrC,eAAe,SAAS,MAAM,GAAG,MAAM;IAEvC,SAAS,CAAC,EAAE,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC;IAC/E,WAAW,CAAC,EAAE,QAAQ,CAAC,eAAe,EAAE,uBAAuB,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC;CACxF;AAmED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,SAAS,sBAAsB,EAC7E,YAAY,EAAE,SAAS,gBAAgB,EAAE,EACzC,UAAU,EAAE,sCAAsC,CAAC,GAAG,CAAC,EACvD,OAAO,GAAE,mCAAwC,GAChD,sCAAsC,EAAE,CAyE1C"}

package/build/commands/build-application-commands-body.js

@@ -0,0 +1,127 @@
+function sortRequiredOptionsFirst(options) {
+    if (!options)
+        return options;
+    return [...options]
+        .sort((a, b) => Number('required' in b && b.required === true) - Number('required' in a && a.required === true))
+        .map((option) => {
+        if ('options' in option && option.options) {
+            return { ...option, options: sortRequiredOptionsFirst(option.options) };
+        }
+        return option;
+    });
+}
+function resolveOptionsDescriptions(optionsList, basePath, ctx) {
+    if (!optionsList)
+        return undefined;
+    return optionsList.map((option) => {
+        const optionPath = [...basePath, 'options', option.name];
+        const description = option.description ?? ctx.resolveDescription?.([...optionPath, 'description']);
+        if (!description) {
+            ctx.missingDescriptions.push(`"${ctx.commandName}" > "${option.name}" (option)`);
+        }
+        const nameLocalizations = ctx.localizeNames?.([...optionPath, 'name']);
+        const descriptionLocalizations = ctx.localizeDescriptions?.([...optionPath, 'description']);
+        const nestedOptions = 'options' in option && option.options
+            ? resolveOptionsDescriptions(option.options, optionPath, ctx)
+            : undefined;
+        return {
+            ...option,
+            description: description ?? '',
+            ...(nameLocalizations ? { name_localizations: nameLocalizations } : {}),
+            ...(descriptionLocalizations ? { description_localizations: descriptionLocalizations } : {}),
+            ...(nestedOptions ? { options: nestedOptions } : {}),
+        };
+    });
+}
+function formatValidationErrors(unmatchedFileEntries, unmatchedHandlers, missingDescriptions) {
+    const sections = [];
+    if (unmatchedFileEntries.length) {
+        sections.push(['Commands in commands.json with no matching handler:', ...unmatchedFileEntries.map((n) => `  - "${n}"`)].join('\n'));
+    }
+    if (unmatchedHandlers.length) {
+        sections.push(['Handlers registered with no matching commands.json entry:', ...unmatchedHandlers.map((n) => `  - "${n}"`)].join('\n'));
+    }
+    if (missingDescriptions.length) {
+        sections.push(['Commands/options missing a description (in commands.json and localize hook):', ...missingDescriptions.map((n) => `  - ${n}`)].join('\n'));
+    }
+    return `Command registration validation failed:\n${sections.join('\n')}`;
+}
+/**
+ * Builds the flat `RESTPostAPIApplicationCommandsJSONBody[]` `createCommandRegistrar`
+ * expects from a validated commands.json array plus the bot's handler registries.
+ * `commandsFile`'s own order drives the output order (not registry insertion order).
+ *
+ * Every commands.json entry must have a matching handler, and every handler must have
+ * a matching commands.json entry - both directions throw one combined error listing
+ * every offender, same as a command/option left with no resolvable description. This
+ * never silently sends an incomplete body to Discord's API.
+ */
+export function buildApplicationCommandsBody(commandsFile, registries, options = {}) {
+    const { sharedMetadata = {}, resolveDescription, localizeNames, localizeDescriptions } = options;
+    const body = [];
+    const unmatchedFileEntries = [];
+    const missingDescriptions = [];
+    const chatInputFileNames = new Set();
+    const contextMenuFileNames = new Set();
+    for (const entry of commandsFile) {
+        const isChatInput = entry.type === 1;
+        if (isChatInput) {
+            chatInputFileNames.add(entry.name);
+        }
+        else {
+            contextMenuFileNames.add(entry.name);
+        }
+        const command = isChatInput ? registries.chatInput?.byName[entry.name] : registries.contextMenu?.byName[entry.name];
+        if (!command) {
+            unmatchedFileEntries.push(entry.name);
+            continue;
+        }
+        if (command.registerCondition && !command.registerCondition())
+            continue;
+        const nameLocalizations = localizeNames?.(['commands', entry.name, 'name']);
+        if (isChatInput) {
+            const chatEntry = entry;
+            const description = chatEntry.description ?? resolveDescription?.(['commands', chatEntry.name, 'description']);
+            if (!description) {
+                missingDescriptions.push(`"${chatEntry.name}" (command)`);
+            }
+            const resolvedOptions = resolveOptionsDescriptions(chatEntry.options, ['commands', chatEntry.name], {
+                resolveDescription,
+                localizeNames,
+                localizeDescriptions,
+                missingDescriptions,
+                commandName: chatEntry.name,
+            });
+            const descriptionLocalizations = localizeDescriptions?.(['commands', chatEntry.name, 'description']);
+            body.push({
+                ...sharedMetadata,
+                ...chatEntry,
+                description: description ?? '',
+                options: sortRequiredOptionsFirst(resolvedOptions),
+                ...(nameLocalizations ? { name_localizations: nameLocalizations } : {}),
+                ...(descriptionLocalizations ? { description_localizations: descriptionLocalizations } : {}),
+            });
+        }
+        else {
+            body.push({
+                ...sharedMetadata,
+                ...entry,
+                ...(nameLocalizations ? { name_localizations: nameLocalizations } : {}),
+            });
+        }
+    }
+    const unmatchedHandlers = [];
+    for (const name of registries.chatInput?.names ?? []) {
+        if (!chatInputFileNames.has(name))
+            unmatchedHandlers.push(name);
+    }
+    for (const name of registries.contextMenu?.names ?? []) {
+        if (!contextMenuFileNames.has(name))
+            unmatchedHandlers.push(name);
+    }
+    if (unmatchedFileEntries.length || unmatchedHandlers.length || missingDescriptions.length) {
+        throw new Error(formatValidationErrors(unmatchedFileEntries, unmatchedHandlers, missingDescriptions));
+    }
+    return body;
+}
+//# sourceMappingURL=build-application-commands-body.js.map

package/build/commands/build-application-commands-body.js.map

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

package/build/commands/fixed-reply-command-factory.d.ts

@@ -0,0 +1,10 @@
+import { BaseInteractionContext, BotChatInputCommand } from '../interactions/types.js';
+/**
+ * Builds a chat-input command handler that always replies with the same
+ * static content, for trivial "fun" commands with no logic (e.g. `/rekt`,
+ * `/yes`). The command's name/description now live in the bot's
+ * commands.json file, not here - pair this with a registry entry like
+ * `{ name: 'ping', ...fixedReplyCommandFactory('pong') }`.
+ */
+export declare function fixedReplyCommandFactory<Ctx extends BaseInteractionContext>(content: string, ephemeral?: boolean): BotChatInputCommand<Ctx>;
+//# sourceMappingURL=fixed-reply-command-factory.d.ts.map

package/build/commands/fixed-reply-command-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixed-reply-command-factory.d.ts","sourceRoot":"","sources":["../../src/commands/fixed-reply-command-factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEvF;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,SAAS,sBAAsB,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,mBAAmB,CAAC,GAAG,CAAC,CASzI"}

package/build/commands/fixed-reply-command-factory.js

@@ -0,0 +1,19 @@
+import { MessageFlags } from 'discord-api-types/v10';
+/**
+ * Builds a chat-input command handler that always replies with the same
+ * static content, for trivial "fun" commands with no logic (e.g. `/rekt`,
+ * `/yes`). The command's name/description now live in the bot's
+ * commands.json file, not here - pair this with a registry entry like
+ * `{ name: 'ping', ...fixedReplyCommandFactory('pong') }`.
+ */
+export function fixedReplyCommandFactory(content, ephemeral = false) {
+    return {
+        async handle(interaction) {
+            await interaction.reply({
+                content,
+                flags: ephemeral ? MessageFlags.Ephemeral : undefined,
+            });
+        },
+    };
+}
+//# sourceMappingURL=fixed-reply-command-factory.js.map

package/build/commands/fixed-reply-command-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixed-reply-command-factory.js","sourceRoot":"","sources":["../../src/commands/fixed-reply-command-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGrD;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAqC,OAAe,EAAE,SAAS,GAAG,KAAK;IAC7G,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,WAAW;YACtB,MAAM,WAAW,CAAC,KAAK,CAAC;gBACtB,OAAO;gBACP,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;aACtD,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/build/commands/index.d.ts

@@ -0,0 +1,4 @@
+export * from './registration.js';
+export * from './fixed-reply-command-factory.js';
+export * from './build-application-commands-body.js';
+//# sourceMappingURL=index.d.ts.map

package/build/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC"}

package/build/commands/index.js

@@ -0,0 +1,4 @@
+export * from './registration.js';
+export * from './fixed-reply-command-factory.js';
+export * from './build-application-commands-body.js';
+//# sourceMappingURL=index.js.map

package/build/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC"}

package/build/commands/registration.d.ts

@@ -0,0 +1,24 @@
+import { Snowflake } from 'discord-api-types/globals';
+import { RESTPostAPIApplicationCommandsJSONBody, RESTPutAPIApplicationCommandsResult, RESTPutAPIApplicationGuildCommandsResult } from 'discord-api-types/v10';
+import { REST } from '@discordjs/rest';
+import { NestableLogger } from '../logger/types.js';
+export interface CommandRegistrarOptions {
+    rest: REST;
+    applicationId: string;
+    logger: NestableLogger;
+}
+export interface CommandRegistrar {
+    getAuthorizedServers(): Promise<string[]>;
+    updateGuildCommands(guildId: Snowflake, body: RESTPostAPIApplicationCommandsJSONBody[]): Promise<RESTPutAPIApplicationGuildCommandsResult | undefined>;
+    cleanGuildCommands(guildId: Snowflake): Promise<void>;
+    updateGlobalCommands(body: RESTPostAPIApplicationCommandsJSONBody[]): Promise<RESTPutAPIApplicationCommandsResult | undefined>;
+    cleanGlobalCommands(): Promise<void>;
+}
+/**
+ * Wraps `@discordjs/rest` slash-command (re)registration/cleanup for both
+ * global and per-guild scopes. Exits the process on failure, matching the
+ * behavior every bot already relies on (a failed startup command sync should
+ * not silently continue running with stale commands).
+ */
+export declare function createCommandRegistrar({ rest, applicationId, logger: baseLogger }: CommandRegistrarOptions): CommandRegistrar;
+//# sourceMappingURL=registration.d.ts.map

package/build/commands/registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.d.ts","sourceRoot":"","sources":["../../src/commands/registration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAEL,sCAAsC,EACtC,mCAAmC,EACnC,wCAAwC,EAEzC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,IAAI,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C,mBAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,sCAAsC,EAAE,GAAG,OAAO,CAAC,wCAAwC,GAAG,SAAS,CAAC,CAAC;IACvJ,kBAAkB,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,oBAAoB,CAAC,IAAI,EAAE,sCAAsC,EAAE,GAAG,OAAO,CAAC,mCAAmC,GAAG,SAAS,CAAC,CAAC;IAC/H,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,uBAAuB,GAAG,gBAAgB,CAkE7H"}

package/build/commands/registration.js

@@ -0,0 +1,69 @@
+import { Routes, } from 'discord-api-types/v10';
+/**
+ * Wraps `@discordjs/rest` slash-command (re)registration/cleanup for both
+ * global and per-guild scopes. Exits the process on failure, matching the
+ * behavior every bot already relies on (a failed startup command sync should
+ * not silently continue running with stale commands).
+ */
+export function createCommandRegistrar({ rest, applicationId, logger: baseLogger }) {
+    return {
+        async getAuthorizedServers() {
+            const logger = baseLogger.nest('getAuthorizedServers');
+            logger.log('Getting authorized servers…');
+            const guilds = await rest.get(Routes.userGuilds());
+            logger.log(`Found ${guilds.length} authorized server${guilds.length === 1 ? '' : 's'}`);
+            return guilds.map((guild) => guild.id);
+        },
+        async updateGuildCommands(guildId, body) {
+            const logger = baseLogger.nest(['updateGuildCommands', `Guild#${guildId}`]);
+            try {
+                logger.log('Started reloading guild commands');
+                const result = await rest.put(Routes.applicationGuildCommands(applicationId, guildId), { body });
+                logger.log('Successfully reloaded guild commands');
+                return result;
+            }
+            catch (error) {
+                logger.error('Failed to reload guild commands', error);
+                process.exit(1);
+            }
+        },
+        async cleanGuildCommands(guildId) {
+            const logger = baseLogger.nest(['cleanGuildCommands', `Guild#${guildId}`]);
+            try {
+                logger.log('Started cleaning guild commands');
+                await rest.put(Routes.applicationGuildCommands(applicationId, guildId), { body: [] });
+                logger.log('Successfully cleaned guild commands');
+            }
+            catch (error) {
+                logger.error('Failed to clean guild commands', error);
+                process.exit(1);
+            }
+        },
+        async updateGlobalCommands(body) {
+            const logger = baseLogger.nest('updateGlobalCommands');
+            try {
+                logger.log('Started refreshing application commands');
+                const result = await rest.put(Routes.applicationCommands(applicationId), { body });
+                logger.log('Successfully reloaded application commands');
+                return result;
+            }
+            catch (error) {
+                logger.error('Failed to reload application commands', error);
+                process.exit(1);
+            }
+        },
+        async cleanGlobalCommands() {
+            const logger = baseLogger.nest('cleanGlobalCommands');
+            try {
+                logger.log('Started cleaning application commands');
+                await rest.put(Routes.applicationCommands(applicationId), { body: [] });
+                logger.log('Successfully cleaned application commands');
+            }
+            catch (error) {
+                logger.error('Failed to clean application commands', error);
+                process.exit(1);
+            }
+        },
+    };
+}
+//# sourceMappingURL=registration.js.map