@went.tf/discord-bot-framework 2.0.0

package/build/commands/schema/context-menu-command.schema.js

@@ -0,0 +1,32 @@
+import { applicationIntegrationTypeSchema } from './application-integration-type.schema.js';
+import { contextMenuNameSchema } from './context-menu-name.schema.js';
+import { defaultMemberPermissionsSchema } from './default-member-permissions.schema.js';
+import { interactionContextTypeSchema } from './interaction-context-type.schema.js';
+/**
+ * One USER or MESSAGE context-menu command entry. No description/options -
+ * Discord doesn't accept them for context-menu commands, and
+ * additionalProperties:false enforces that here (nothing enforced this before).
+ */
+export const contextMenuCommandSchema = {
+    $id: 'https://schema.went.tf/discord-bot-framework/context-menu-command.json',
+    type: 'object',
+    properties: {
+        type: { enum: [2, 3] },
+        name: { $ref: contextMenuNameSchema.$id },
+        default_member_permissions: { $ref: defaultMemberPermissionsSchema.$id },
+        contexts: {
+            type: 'array',
+            items: { $ref: interactionContextTypeSchema.$id },
+            uniqueItems: true,
+        },
+        integration_types: {
+            type: 'array',
+            items: { $ref: applicationIntegrationTypeSchema.$id },
+            uniqueItems: true,
+        },
+        nsfw: { type: 'boolean' },
+    },
+    required: ['type', 'name'],
+    additionalProperties: false,
+};
+//# sourceMappingURL=context-menu-command.schema.js.map

package/build/commands/schema/context-menu-command.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-menu-command.schema.js","sourceRoot":"","sources":["../../../src/commands/schema/context-menu-command.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,0CAA0C,CAAC;AAC5F,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AAEpF;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,GAAG,EAAE,wEAAwE;IAC7E,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;QACtB,IAAI,EAAE,EAAE,IAAI,EAAE,qBAAqB,CAAC,GAAG,EAAE;QACzC,0BAA0B,EAAE,EAAE,IAAI,EAAE,8BAA8B,CAAC,GAAG,EAAE;QACxE,QAAQ,EAAE;YACR,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,4BAA4B,CAAC,GAAG,EAAE;YACjD,WAAW,EAAE,IAAI;SAClB;QACD,iBAAiB,EAAE;YACjB,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,gCAAgC,CAAC,GAAG,EAAE;YACrD,WAAW,EAAE,IAAI;SAClB;QACD,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;KAC1B;IACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,KAAK;CACnB,CAAC"}

package/build/commands/schema/context-menu-command.schema.json

@@ -0,0 +1,40 @@
+{
+  "$id": "https://schema.went.tf/discord-bot-framework/context-menu-command.json",
+  "type": "object",
+  "properties": {
+    "type": {
+      "enum": [
+        2,
+        3
+      ]
+    },
+    "name": {
+      "$ref": "https://schema.went.tf/discord-bot-framework/context-menu-name.json"
+    },
+    "default_member_permissions": {
+      "$ref": "https://schema.went.tf/discord-bot-framework/default-member-permissions.json"
+    },
+    "contexts": {
+      "type": "array",
+      "items": {
+        "$ref": "https://schema.went.tf/discord-bot-framework/interaction-context-type.json"
+      },
+      "uniqueItems": true
+    },
+    "integration_types": {
+      "type": "array",
+      "items": {
+        "$ref": "https://schema.went.tf/discord-bot-framework/application-integration-type.json"
+      },
+      "uniqueItems": true
+    },
+    "nsfw": {
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "type",
+    "name"
+  ],
+  "additionalProperties": false
+}

package/build/commands/schema/context-menu-name.schema.d.ts

@@ -0,0 +1,7 @@
+export declare const contextMenuNameSchema: {
+    readonly $id: "https://schema.went.tf/discord-bot-framework/context-menu-name.json";
+    readonly description: "Discord's name pattern for USER/MESSAGE context-menu commands - mixed case allowed, spaces allowed, 1-32 characters. Narrowed to ASCII for the same regex-flag reason documented in option-name.schema.ts.";
+    readonly type: "string";
+    readonly pattern: "^[-' _a-zA-Z0-9]{1,32}$";
+};
+//# sourceMappingURL=context-menu-name.schema.d.ts.map

package/build/commands/schema/context-menu-name.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-menu-name.schema.d.ts","sourceRoot":"","sources":["../../../src/commands/schema/context-menu-name.schema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB;;;;;CAMxB,CAAC"}

package/build/commands/schema/context-menu-name.schema.js

@@ -0,0 +1,7 @@
+export const contextMenuNameSchema = {
+    $id: 'https://schema.went.tf/discord-bot-framework/context-menu-name.json',
+    description: "Discord's name pattern for USER/MESSAGE context-menu commands - mixed case allowed, spaces allowed, 1-32 characters. Narrowed to ASCII for the same regex-flag reason documented in option-name.schema.ts.",
+    type: 'string',
+    pattern: "^[-' _a-zA-Z0-9]{1,32}$",
+};
+//# sourceMappingURL=context-menu-name.schema.js.map

package/build/commands/schema/context-menu-name.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-menu-name.schema.js","sourceRoot":"","sources":["../../../src/commands/schema/context-menu-name.schema.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,GAAG,EAAE,qEAAqE;IAC1E,WAAW,EACT,4MAA4M;IAC9M,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,yBAAyB;CAC1B,CAAC"}

package/build/commands/schema/context-menu-name.schema.json

@@ -0,0 +1,6 @@
+{
+  "$id": "https://schema.went.tf/discord-bot-framework/context-menu-name.json",
+  "description": "Discord's name pattern for USER/MESSAGE context-menu commands - mixed case allowed, spaces allowed, 1-32 characters. Narrowed to ASCII for the same regex-flag reason documented in option-name.schema.ts.",
+  "type": "string",
+  "pattern": "^[-' _a-zA-Z0-9]{1,32}$"
+}

package/build/commands/schema/default-member-permissions.schema.d.ts

@@ -0,0 +1,7 @@
+export declare const defaultMemberPermissionsSchema: {
+    readonly $id: "https://schema.went.tf/discord-bot-framework/default-member-permissions.json";
+    readonly description: "Discord sends default_member_permissions as a stringified permissions bitfield integer.";
+    readonly type: "string";
+    readonly pattern: "^-?[0-9]+$";
+};
+//# sourceMappingURL=default-member-permissions.schema.d.ts.map

package/build/commands/schema/default-member-permissions.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-member-permissions.schema.d.ts","sourceRoot":"","sources":["../../../src/commands/schema/default-member-permissions.schema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,8BAA8B;;;;;CAKjC,CAAC"}

package/build/commands/schema/default-member-permissions.schema.js

@@ -0,0 +1,7 @@
+export const defaultMemberPermissionsSchema = {
+    $id: 'https://schema.went.tf/discord-bot-framework/default-member-permissions.json',
+    description: 'Discord sends default_member_permissions as a stringified permissions bitfield integer.',
+    type: 'string',
+    pattern: '^-?[0-9]+$',
+};
+//# sourceMappingURL=default-member-permissions.schema.js.map

package/build/commands/schema/default-member-permissions.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-member-permissions.schema.js","sourceRoot":"","sources":["../../../src/commands/schema/default-member-permissions.schema.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,GAAG,EAAE,8EAA8E;IACnF,WAAW,EAAE,yFAAyF;IACtG,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,YAAY;CACb,CAAC"}

package/build/commands/schema/default-member-permissions.schema.json

@@ -0,0 +1,6 @@
+{
+  "$id": "https://schema.went.tf/discord-bot-framework/default-member-permissions.json",
+  "description": "Discord sends default_member_permissions as a stringified permissions bitfield integer.",
+  "type": "string",
+  "pattern": "^-?[0-9]+$"
+}

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

@@ -0,0 +1,77 @@
+import type { Ajv } from 'ajv';
+import type { FromSchema } from 'json-schema-to-ts';
+import { applicationCommandLeafOptionSchema } from './application-command-leaf-option.schema.js';
+import { applicationCommandOptionChoiceSchema } from './application-command-option-choice.schema.js';
+import { applicationCommandOptionSchema } from './application-command-option.schema.js';
+import { applicationCommandSubcommandGroupSchema } from './application-command-subcommand-group.schema.js';
+import { applicationCommandSubcommandSchema } from './application-command-subcommand.schema.js';
+import { applicationCommandTypeSchema } from './application-command-type.schema.js';
+import { applicationIntegrationTypeSchema } from './application-integration-type.schema.js';
+import { channelTypeSchema } from './channel-type.schema.js';
+import { chatInputCommandSchema } from './chat-input-command.schema.js';
+import { commandsFileSchema } from './commands-file.schema.js';
+import { contextMenuCommandSchema } from './context-menu-command.schema.js';
+import { contextMenuNameSchema } from './context-menu-name.schema.js';
+import { defaultMemberPermissionsSchema } from './default-member-permissions.schema.js';
+import { interactionContextTypeSchema } from './interaction-context-type.schema.js';
+import { optionNameSchema } from './option-name.schema.js';
+export { parseCommandsFile } from './parse-commands-file.js';
+export type { ParseCommandsFileOptions } from './parse-commands-file.js';
+export { applicationCommandTypeSchema, interactionContextTypeSchema, applicationIntegrationTypeSchema, channelTypeSchema, optionNameSchema, contextMenuNameSchema, applicationCommandOptionChoiceSchema, defaultMemberPermissionsSchema, applicationCommandLeafOptionSchema, applicationCommandSubcommandSchema, applicationCommandSubcommandGroupSchema, applicationCommandOptionSchema, chatInputCommandSchema, contextMenuCommandSchema, commandsFileSchema, };
+/**
+ * Registers every generic fragment this package ships onto a bot's own ajv
+ * instance, so the bot's own composed commands.schema.json can `$ref` them
+ * by `$id`. Call this before `ajv.compile()`-ing the bot's own schema.
+ */
+export declare function registerFrameworkSchemas(ajv: Ajv): void;
+export type ApplicationCommandOptionChoice = FromSchema<typeof applicationCommandOptionChoiceSchema>;
+export type ApplicationCommandLeafOption = FromSchema<typeof applicationCommandLeafOptionSchema, {
+    references: [typeof optionNameSchema, typeof applicationCommandOptionChoiceSchema, typeof channelTypeSchema];
+}>;
+export type ApplicationCommandSubcommand = FromSchema<typeof applicationCommandSubcommandSchema, {
+    references: [typeof optionNameSchema, typeof applicationCommandLeafOptionSchema, typeof applicationCommandOptionChoiceSchema, typeof channelTypeSchema];
+}>;
+export type ApplicationCommandSubcommandGroup = FromSchema<typeof applicationCommandSubcommandGroupSchema, {
+    references: [
+        typeof optionNameSchema,
+        typeof applicationCommandSubcommandSchema,
+        typeof applicationCommandLeafOptionSchema,
+        typeof applicationCommandOptionChoiceSchema,
+        typeof channelTypeSchema
+    ];
+}>;
+type ApplicationCommandOptionReferences = [
+    typeof optionNameSchema,
+    typeof applicationCommandLeafOptionSchema,
+    typeof applicationCommandSubcommandSchema,
+    typeof applicationCommandSubcommandGroupSchema,
+    typeof applicationCommandOptionChoiceSchema,
+    typeof channelTypeSchema
+];
+export type ApplicationCommandOption = FromSchema<typeof applicationCommandOptionSchema, {
+    references: ApplicationCommandOptionReferences;
+}>;
+export type ChatInputCommandFileEntry = FromSchema<typeof chatInputCommandSchema, {
+    references: [
+        ...ApplicationCommandOptionReferences,
+        typeof applicationCommandOptionSchema,
+        typeof defaultMemberPermissionsSchema,
+        typeof interactionContextTypeSchema,
+        typeof applicationIntegrationTypeSchema
+    ];
+}>;
+export type ContextMenuCommandFileEntry = FromSchema<typeof contextMenuCommandSchema, {
+    references: [typeof contextMenuNameSchema, typeof defaultMemberPermissionsSchema, typeof interactionContextTypeSchema, typeof applicationIntegrationTypeSchema];
+}>;
+export type CommandFileEntry = ChatInputCommandFileEntry | ContextMenuCommandFileEntry;
+/**
+ * Composed from the already-derived per-entry types rather than a second
+ * `FromSchema<typeof commandsFileSchema, ...>` call - deriving the whole-file
+ * array type by re-walking the same deeply-nested option oneOf structure one
+ * level up hits TS's type-instantiation depth limit (TS2589), confirmed
+ * during implementation. `commandsFileSchema` itself remains the runtime
+ * source of truth for ajv validation; only its *type* derivation is composed
+ * this way.
+ */
+export type CommandsFile = readonly CommandFileEntry[];
+//# sourceMappingURL=index.d.ts.map

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

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

package/build/commands/schema/index.js

@@ -0,0 +1,48 @@
+import { applicationCommandLeafOptionSchema } from './application-command-leaf-option.schema.js';
+import { applicationCommandOptionChoiceSchema } from './application-command-option-choice.schema.js';
+import { applicationCommandOptionSchema } from './application-command-option.schema.js';
+import { applicationCommandSubcommandGroupSchema } from './application-command-subcommand-group.schema.js';
+import { applicationCommandSubcommandSchema } from './application-command-subcommand.schema.js';
+import { applicationCommandTypeSchema } from './application-command-type.schema.js';
+import { applicationIntegrationTypeSchema } from './application-integration-type.schema.js';
+import { channelTypeSchema } from './channel-type.schema.js';
+import { chatInputCommandSchema } from './chat-input-command.schema.js';
+import { commandsFileSchema } from './commands-file.schema.js';
+import { contextMenuCommandSchema } from './context-menu-command.schema.js';
+import { contextMenuNameSchema } from './context-menu-name.schema.js';
+import { defaultMemberPermissionsSchema } from './default-member-permissions.schema.js';
+import { interactionContextTypeSchema } from './interaction-context-type.schema.js';
+import { optionNameSchema } from './option-name.schema.js';
+export { parseCommandsFile } from './parse-commands-file.js';
+export { applicationCommandTypeSchema, interactionContextTypeSchema, applicationIntegrationTypeSchema, channelTypeSchema, optionNameSchema, contextMenuNameSchema, applicationCommandOptionChoiceSchema, defaultMemberPermissionsSchema, applicationCommandLeafOptionSchema, applicationCommandSubcommandSchema, applicationCommandSubcommandGroupSchema, applicationCommandOptionSchema, chatInputCommandSchema, contextMenuCommandSchema, commandsFileSchema, };
+/** Every fragment this package ships, in an order safe to `ajv.addSchema()` sequentially. */
+const frameworkSchemas = [
+    applicationCommandTypeSchema,
+    interactionContextTypeSchema,
+    applicationIntegrationTypeSchema,
+    channelTypeSchema,
+    optionNameSchema,
+    contextMenuNameSchema,
+    applicationCommandOptionChoiceSchema,
+    defaultMemberPermissionsSchema,
+    applicationCommandLeafOptionSchema,
+    applicationCommandSubcommandSchema,
+    applicationCommandSubcommandGroupSchema,
+    applicationCommandOptionSchema,
+    chatInputCommandSchema,
+    contextMenuCommandSchema,
+    commandsFileSchema,
+];
+/**
+ * Registers every generic fragment this package ships onto a bot's own ajv
+ * instance, so the bot's own composed commands.schema.json can `$ref` them
+ * by `$id`. Call this before `ajv.compile()`-ing the bot's own schema.
+ */
+export function registerFrameworkSchemas(ajv) {
+    for (const schema of frameworkSchemas) {
+        if (!ajv.getSchema(schema.$id)) {
+            ajv.addSchema(schema);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/build/commands/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/schema/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kCAAkC,EAAE,MAAM,6CAA6C,CAAC;AACjG,OAAO,EAAE,oCAAoC,EAAE,MAAM,+CAA+C,CAAC;AACrG,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,EAAE,uCAAuC,EAAE,MAAM,kDAAkD,CAAC;AAC3G,OAAO,EAAE,kCAAkC,EAAE,MAAM,4CAA4C,CAAC;AAChG,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,gCAAgC,EAAE,MAAM,0CAA0C,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC5B,gCAAgC,EAChC,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,oCAAoC,EACpC,8BAA8B,EAC9B,kCAAkC,EAClC,kCAAkC,EAClC,uCAAuC,EACvC,8BAA8B,EAC9B,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,GACnB,CAAC;AAEF,6FAA6F;AAC7F,MAAM,gBAAgB,GAAG;IACvB,4BAA4B;IAC5B,4BAA4B;IAC5B,gCAAgC;IAChC,iBAAiB;IACjB,gBAAgB;IAChB,qBAAqB;IACrB,oCAAoC;IACpC,8BAA8B;IAC9B,kCAAkC;IAClC,kCAAkC;IAClC,uCAAuC;IACvC,8BAA8B;IAC9B,sBAAsB;IACtB,wBAAwB;IACxB,kBAAkB;CACV,CAAC;AAEX;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAQ;IAC/C,KAAK,MAAM,MAAM,IAAI,gBAAgB,EAAE,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;AACH,CAAC"}

package/build/commands/schema/interaction-context-type.schema.d.ts

@@ -0,0 +1,6 @@
+export declare const interactionContextTypeSchema: {
+    readonly $id: "https://schema.went.tf/discord-bot-framework/interaction-context-type.json";
+    readonly description: "InteractionContextType (discord-api-types): 0 Guild, 1 BotDM, 2 PrivateChannel.";
+    readonly enum: readonly [0, 1, 2];
+};
+//# sourceMappingURL=interaction-context-type.schema.d.ts.map

package/build/commands/schema/interaction-context-type.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-context-type.schema.d.ts","sourceRoot":"","sources":["../../../src/commands/schema/interaction-context-type.schema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B;;;;CAI/B,CAAC"}

package/build/commands/schema/interaction-context-type.schema.js

@@ -0,0 +1,6 @@
+export const interactionContextTypeSchema = {
+    $id: 'https://schema.went.tf/discord-bot-framework/interaction-context-type.json',
+    description: 'InteractionContextType (discord-api-types): 0 Guild, 1 BotDM, 2 PrivateChannel.',
+    enum: [0, 1, 2],
+};
+//# sourceMappingURL=interaction-context-type.schema.js.map

package/build/commands/schema/interaction-context-type.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-context-type.schema.js","sourceRoot":"","sources":["../../../src/commands/schema/interaction-context-type.schema.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,GAAG,EAAE,4EAA4E;IACjF,WAAW,EAAE,iFAAiF;IAC9F,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;CACP,CAAC"}

package/build/commands/schema/interaction-context-type.schema.json

@@ -0,0 +1,9 @@
+{
+  "$id": "https://schema.went.tf/discord-bot-framework/interaction-context-type.json",
+  "description": "InteractionContextType (discord-api-types): 0 Guild, 1 BotDM, 2 PrivateChannel.",
+  "enum": [
+    0,
+    1,
+    2
+  ]
+}

package/build/commands/schema/option-name.schema.d.ts

@@ -0,0 +1,7 @@
+export declare const optionNameSchema: {
+    readonly $id: "https://schema.went.tf/discord-bot-framework/option-name.json";
+    readonly description: "Discord's name pattern for CHAT_INPUT commands, subcommands, subcommand groups, and every option name - always lowercase regardless of the parent command's own type. Discord's real rule permits non-Latin scripts (Devanagari, Thai, any lowercase/caseless Unicode letter) via \\p{} regex classes, but JSON Schema's `pattern` keyword has no way to request the `u` RegExp flag those classes require, and ajv compiles patterns without it by default - so this is deliberately narrowed to ASCII lowercase/digits/hyphen/underscore. Bots needing non-Latin command/option names can loosen this in their own composed schema.";
+    readonly type: "string";
+    readonly pattern: "^[-_a-z0-9]{1,32}$";
+};
+//# sourceMappingURL=option-name.schema.d.ts.map

package/build/commands/schema/option-name.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"option-name.schema.d.ts","sourceRoot":"","sources":["../../../src/commands/schema/option-name.schema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB;;;;;CAMnB,CAAC"}

package/build/commands/schema/option-name.schema.js

@@ -0,0 +1,7 @@
+export const optionNameSchema = {
+    $id: 'https://schema.went.tf/discord-bot-framework/option-name.json',
+    description: "Discord's name pattern for CHAT_INPUT commands, subcommands, subcommand groups, and every option name - always lowercase regardless of the parent command's own type. Discord's real rule permits non-Latin scripts (Devanagari, Thai, any lowercase/caseless Unicode letter) via \\p{} regex classes, but JSON Schema's `pattern` keyword has no way to request the `u` RegExp flag those classes require, and ajv compiles patterns without it by default - so this is deliberately narrowed to ASCII lowercase/digits/hyphen/underscore. Bots needing non-Latin command/option names can loosen this in their own composed schema.",
+    type: 'string',
+    pattern: '^[-_a-z0-9]{1,32}$',
+};
+//# sourceMappingURL=option-name.schema.js.map

package/build/commands/schema/option-name.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"option-name.schema.js","sourceRoot":"","sources":["../../../src/commands/schema/option-name.schema.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,GAAG,EAAE,+DAA+D;IACpE,WAAW,EACT,umBAAumB;IACzmB,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,oBAAoB;CACrB,CAAC"}

package/build/commands/schema/option-name.schema.json

@@ -0,0 +1,6 @@
+{
+  "$id": "https://schema.went.tf/discord-bot-framework/option-name.json",
+  "description": "Discord's name pattern for CHAT_INPUT commands, subcommands, subcommand groups, and every option name - always lowercase regardless of the parent command's own type. Discord's real rule permits non-Latin scripts (Devanagari, Thai, any lowercase/caseless Unicode letter) via \\p{} regex classes, but JSON Schema's `pattern` keyword has no way to request the `u` RegExp flag those classes require, and ajv compiles patterns without it by default - so this is deliberately narrowed to ASCII lowercase/digits/hyphen/underscore. Bots needing non-Latin command/option names can loosen this in their own composed schema.",
+  "type": "string",
+  "pattern": "^[-_a-z0-9]{1,32}$"
+}

package/build/commands/schema/parse-commands-file.d.ts

@@ -0,0 +1,19 @@
+import type { ValidateFunction } from 'ajv';
+export interface ParseCommandsFileOptions {
+    /**
+     * A pre-compiled ajv validate function for the bot's own composed
+     * commands.schema (e.g. from `ajv.compile(myCommandsSchema)`, after calling
+     * `registerFrameworkSchemas(ajv)`).
+     */
+    validate: ValidateFunction;
+}
+/**
+ * Validates already-parsed commands.json data (e.g. from a native JSON
+ * import, or `JSON.parse(readFileSync(...))`) against a bot-supplied ajv
+ * validate function, throwing one formatted error listing every failing
+ * path. This is the structural pass only - it runs right after parsing and
+ * cannot validate description-completeness, since descriptions may be
+ * legitimately absent pending i18n resolution in `buildApplicationCommandsBody`.
+ */
+export declare function parseCommandsFile<T>(data: unknown, options: ParseCommandsFileOptions): T;
+//# sourceMappingURL=parse-commands-file.d.ts.map

package/build/commands/schema/parse-commands-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-commands-file.d.ts","sourceRoot":"","sources":["../../../src/commands/schema/parse-commands-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,gBAAgB,EAAE,MAAM,KAAK,CAAC;AAEzD,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAOD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,wBAAwB,GAAG,CAAC,CAMxF"}

package/build/commands/schema/parse-commands-file.js

@@ -0,0 +1,19 @@
+const formatAjvErrors = (errors) => {
+    const lines = errors.map((error) => `  - ${error.instancePath || '(root)'}: ${error.message}`);
+    return `commands.json validation failed:\n${lines.join('\n')}`;
+};
+/**
+ * Validates already-parsed commands.json data (e.g. from a native JSON
+ * import, or `JSON.parse(readFileSync(...))`) against a bot-supplied ajv
+ * validate function, throwing one formatted error listing every failing
+ * path. This is the structural pass only - it runs right after parsing and
+ * cannot validate description-completeness, since descriptions may be
+ * legitimately absent pending i18n resolution in `buildApplicationCommandsBody`.
+ */
+export function parseCommandsFile(data, options) {
+    if (!options.validate(data)) {
+        throw new Error(formatAjvErrors(options.validate.errors ?? []));
+    }
+    return data;
+}
+//# sourceMappingURL=parse-commands-file.js.map

package/build/commands/schema/parse-commands-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-commands-file.js","sourceRoot":"","sources":["../../../src/commands/schema/parse-commands-file.ts"],"names":[],"mappings":"AAWA,MAAM,eAAe,GAAG,CAAC,MAA8B,EAAU,EAAE;IACjE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,CAAC,YAAY,IAAI,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/F,OAAO,qCAAqC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACjE,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAI,IAAa,EAAE,OAAiC;IACnF,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,IAAS,CAAC;AACnB,CAAC"}

package/build/db/create-postgres-prisma-db.d.ts

@@ -0,0 +1,20 @@
+import { PrismaPg } from '@prisma/adapter-pg';
+export interface CreatePostgresPrismaDbOptions {
+    connectionString: string;
+}
+/**
+ * Constructs a Prisma client backed by the `@prisma/adapter-pg` driver
+ * adapter (Prisma's Postgres-only, ORM-optional pattern). The generated
+ * Prisma client is always bot-specific, so its constructor is passed in
+ * rather than imported here. Only importing this module (the `./db`
+ * subpath) requires `@prisma/adapter-pg`/`@prisma/client` to be installed —
+ * bots that never import it don't need those peer dependencies at all.
+ *
+ * @example
+ * import { PrismaClient } from './generated/prisma/client.js';
+ * const db = createPostgresPrismaDb(PrismaClient, { connectionString: env.DATABASE_URL });
+ */
+export declare function createPostgresPrismaDb<Client>(PrismaClientCtor: new (options: {
+    adapter: PrismaPg;
+}) => Client, options: CreatePostgresPrismaDbOptions): Client;
+//# sourceMappingURL=create-postgres-prisma-db.d.ts.map

package/build/db/create-postgres-prisma-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-postgres-prisma-db.d.ts","sourceRoot":"","sources":["../../src/db/create-postgres-prisma-db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,WAAW,6BAA6B;IAC5C,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAC3C,gBAAgB,EAAE,KAAK,OAAO,EAAE;IAAE,OAAO,EAAE,QAAQ,CAAA;CAAE,KAAK,MAAM,EAChE,OAAO,EAAE,6BAA6B,GACrC,MAAM,CAER"}

package/build/db/create-postgres-prisma-db.js

@@ -0,0 +1,17 @@
+import { PrismaPg } from '@prisma/adapter-pg';
+/**
+ * Constructs a Prisma client backed by the `@prisma/adapter-pg` driver
+ * adapter (Prisma's Postgres-only, ORM-optional pattern). The generated
+ * Prisma client is always bot-specific, so its constructor is passed in
+ * rather than imported here. Only importing this module (the `./db`
+ * subpath) requires `@prisma/adapter-pg`/`@prisma/client` to be installed —
+ * bots that never import it don't need those peer dependencies at all.
+ *
+ * @example
+ * import { PrismaClient } from './generated/prisma/client.js';
+ * const db = createPostgresPrismaDb(PrismaClient, { connectionString: env.DATABASE_URL });
+ */
+export function createPostgresPrismaDb(PrismaClientCtor, options) {
+    return new PrismaClientCtor({ adapter: new PrismaPg({ connectionString: options.connectionString }) });
+}
+//# sourceMappingURL=create-postgres-prisma-db.js.map

package/build/db/create-postgres-prisma-db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-postgres-prisma-db.js","sourceRoot":"","sources":["../../src/db/create-postgres-prisma-db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAM9C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CACpC,gBAAgE,EAChE,OAAsC;IAEtC,OAAO,IAAI,gBAAgB,CAAC,EAAE,OAAO,EAAE,IAAI,QAAQ,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC,EAAE,CAAC,CAAC;AACzG,CAAC"}

package/build/db/index.d.ts

@@ -0,0 +1,2 @@
+export * from './create-postgres-prisma-db.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC"}

package/build/db/index.js

@@ -0,0 +1,2 @@
+export * from './create-postgres-prisma-db.js';
+//# sourceMappingURL=index.js.map

package/build/db/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC"}

package/build/dev/create-handler-watcher.d.ts

@@ -0,0 +1,23 @@
+import { NestableLogger } from '../logger/index.js';
+export interface HandlerWatcherOptions {
+    /** One or more root directories to watch recursively (e.g. `build/commands`). */
+    paths: string[];
+    /** Called once per settled file change, after debouncing. Errors are caught and logged, never thrown. */
+    onChange: (filePath: string) => void | Promise<void>;
+    /** Debounce window per file path, in ms. Default 250. */
+    debounceMs?: number;
+    /** Only invoke `onChange` for paths matching this filter. Default: matches `.js`/`.mjs`/`.cjs` (compiled output). */
+    filter?: (filePath: string) => boolean;
+    logger?: NestableLogger;
+}
+export interface HandlerWatcher {
+    close: () => void;
+}
+/**
+ * A generic, dependency-free file watcher for reloading compiled handler
+ * implementations in development. It only watches paths, debounces/coalesces
+ * fs events per file, and invokes `onChange` — it has no opinion on how to
+ * re-import a module or merge it into a registry, since that varies per bot.
+ */
+export declare function createHandlerWatcher(options: HandlerWatcherOptions): HandlerWatcher;
+//# sourceMappingURL=create-handler-watcher.d.ts.map

package/build/dev/create-handler-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-handler-watcher.d.ts","sourceRoot":"","sources":["../../src/dev/create-handler-watcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,WAAW,qBAAqB;IACpC,iFAAiF;IACjF,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,yGAAyG;IACzG,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qHAAqH;IACrH,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IACvC,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAKD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CA8CnF"}

package/build/dev/create-handler-watcher.js

@@ -0,0 +1,55 @@
+import { watch } from 'node:fs';
+import { resolve } from 'node:path';
+const DEFAULT_DEBOUNCE_MS = 250;
+const DEFAULT_FILTER = (filePath) => /\.(m|c)?js$/.test(filePath);
+/**
+ * A generic, dependency-free file watcher for reloading compiled handler
+ * implementations in development. It only watches paths, debounces/coalesces
+ * fs events per file, and invokes `onChange` — it has no opinion on how to
+ * re-import a module or merge it into a registry, since that varies per bot.
+ */
+export function createHandlerWatcher(options) {
+    const debounceMs = options.debounceMs ?? DEFAULT_DEBOUNCE_MS;
+    const filter = options.filter ?? DEFAULT_FILTER;
+    const timers = new Map();
+    const watchers = [];
+    const scheduleChange = (filePath) => {
+        if (!filter(filePath))
+            return;
+        const existing = timers.get(filePath);
+        if (existing)
+            clearTimeout(existing);
+        timers.set(filePath, setTimeout(() => {
+            timers.delete(filePath);
+            Promise.resolve()
+                .then(() => options.onChange(filePath))
+                .catch((error) => {
+                options.logger?.error(`Handler watcher onChange callback threw (file=${filePath})`, error);
+            });
+        }, debounceMs));
+    };
+    for (const root of options.paths) {
+        const absoluteRoot = resolve(root);
+        const watcher = watch(absoluteRoot, { recursive: true }, (_eventType, filename) => {
+            if (!filename)
+                return;
+            scheduleChange(resolve(absoluteRoot, filename.toString()));
+        });
+        watcher.on('error', (error) => {
+            options.logger?.error(`Handler watcher failed for path (path=${absoluteRoot})`, error);
+        });
+        watchers.push(watcher);
+        options.logger?.log(`Watching for handler changes (path=${absoluteRoot})`);
+    }
+    return {
+        close: () => {
+            for (const timer of timers.values())
+                clearTimeout(timer);
+            timers.clear();
+            for (const watcher of watchers)
+                watcher.close();
+            options.logger?.log('Handler watcher closed');
+        },
+    };
+}
+//# sourceMappingURL=create-handler-watcher.js.map

package/build/dev/create-handler-watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-handler-watcher.js","sourceRoot":"","sources":["../../src/dev/create-handler-watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBpC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAChC,MAAM,cAAc,GAAG,CAAC,QAAgB,EAAW,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA8B;IACjE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC;IAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC;IAChD,MAAM,MAAM,GAAG,IAAI,GAAG,EAA0B,CAAC;IACjD,MAAM,QAAQ,GAAgB,EAAE,CAAC;IAEjC,MAAM,cAAc,GAAG,CAAC,QAAgB,EAAQ,EAAE;QAChD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;YAAE,OAAO;QAE9B,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,QAAQ;YAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;QAErC,MAAM,CAAC,GAAG,CACR,QAAQ,EACR,UAAU,CAAC,GAAG,EAAE;YACd,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,CAAC,OAAO,EAAE;iBACd,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;iBACtC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBACxB,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,iDAAiD,QAAQ,GAAG,EAAE,KAAK,CAAC,CAAC;YAC7F,CAAC,CAAC,CAAC;QACP,CAAC,EAAE,UAAU,CAAC,CACf,CAAC;IACJ,CAAC,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACjC,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,KAAK,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,EAAE;YAChF,IAAI,CAAC,QAAQ;gBAAE,OAAO;YACtB,cAAc,CAAC,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAc,EAAE,EAAE;YACrC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,yCAAyC,YAAY,GAAG,EAAE,KAAK,CAAC,CAAC;QACzF,CAAC,CAAC,CAAC;QACH,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,sCAAsC,YAAY,GAAG,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO;QACL,KAAK,EAAE,GAAS,EAAE;YAChB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YACzD,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,KAAK,MAAM,OAAO,IAAI,QAAQ;gBAAE,OAAO,CAAC,KAAK,EAAE,CAAC;YAChD,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,wBAAwB,CAAC,CAAC;QAChD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/build/dev/create-source-reloader.d.ts

@@ -0,0 +1,37 @@
+import type { NestableLogger } from '../logger/index.js';
+export interface SourceReloaderOptions {
+    /**
+     * Absolute path to the source root whose modules should be hot-reloaded (e.g. the
+     * app's `src/` directory). Anything resolved outside this root — node_modules, this
+     * framework, compiled output elsewhere — is left untouched and stays on Node's normal
+     * module cache, so singletons living there (a DB pool, the gateway client) are never
+     * duplicated or reconnected by a reload.
+     */
+    rootDir: string;
+    logger?: NestableLogger;
+}
+export interface SourceReloader {
+    /**
+     * Re-imports `specifier` (an absolute path or `file://` URL under `rootDir`) as a
+     * brand new module instance, along with every module under `rootDir` it transitively
+     * imports. Intended for a small, side-effect-free aggregator module (e.g. one that
+     * only builds command/component registries from plain object exports) — reloading a
+     * module with top-level side effects (opening a DB pool, connecting a client) will
+     * duplicate those side effects on every call.
+     */
+    reimport: <T = unknown>(specifier: string | URL) => Promise<T>;
+}
+/**
+ * Sets up cache-busted re-importing of a local module subtree for development hot
+ * reload, via a `module.register()` hook that tags every module resolved under
+ * `rootDir` with a shared, incrementing epoch — forcing Node to treat it as a new
+ * module instance on each `reimport()` call, without needing to restart the process
+ * (and, for a Discord bot, without reconnecting the gateway).
+ *
+ * Pair with `createHandlerWatcher` to trigger `reimport()` on file changes, then merge
+ * the returned module's exports into whatever long-lived registries/objects your
+ * running process already holds live references to (mutate them in place — replacing
+ * the binding itself isn't possible from outside the module that declared it).
+ */
+export declare function createSourceReloader({ rootDir, logger }: SourceReloaderOptions): SourceReloader;
+//# sourceMappingURL=create-source-reloader.d.ts.map

package/build/dev/create-source-reloader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-source-reloader.d.ts","sourceRoot":"","sources":["../../src/dev/create-source-reloader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B;;;;;;;OAOG;IACH,QAAQ,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;CAChE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,qBAAqB,GAAG,cAAc,CA2B/F"}