@went.tf/discord-bot-framework 2.0.0

package/build/dev/create-source-reloader.js

@@ -0,0 +1,42 @@
+import { existsSync } from 'node:fs';
+import { register } from 'node:module';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+/**
+ * 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 function createSourceReloader({ rootDir, logger }) {
+    const sab = new SharedArrayBuffer(4);
+    const epoch = new Int32Array(sab);
+    const rootUrl = pathToFileURL(rootDir.endsWith('/') ? rootDir : `${rootDir}/`).href;
+    // Only `build/` (compiled .js) is published; running this package's own tests/dev
+    // straight against `src/` (no build step yet) leaves just the .ts sibling on disk —
+    // Node 24's native type-stripping loads that directly since it's plain erasable syntax
+    const compiledHookUrl = new URL('./reload-loader.js', import.meta.url);
+    const hookUrl = existsSync(fileURLToPath(compiledHookUrl))
+        ? compiledHookUrl
+        : new URL('./reload-loader.ts', import.meta.url);
+    register(hookUrl, {
+        parentURL: import.meta.url,
+        data: { rootUrl, sab },
+    });
+    logger?.log(`Source reloader active (root=${rootDir})`);
+    return {
+        reimport: async (specifier) => {
+            Atomics.add(epoch, 0, 1);
+            const url = typeof specifier === 'string' && !specifier.startsWith('file://')
+                ? pathToFileURL(specifier).href
+                : specifier.toString();
+            return import(url);
+        },
+    };
+}
+//# sourceMappingURL=create-source-reloader.js.map

package/build/dev/create-source-reloader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-source-reloader.js","sourceRoot":"","sources":["../../src/dev/create-source-reloader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AA2BxD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAyB;IAC7E,MAAM,GAAG,GAAG,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC;IACpF,kFAAkF;IAClF,oFAAoF;IACpF,uFAAuF;IACvF,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvE,MAAM,OAAO,GAAG,UAAU,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;QACxD,CAAC,CAAC,eAAe;QACjB,CAAC,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEnD,QAAQ,CAAC,OAAO,EAAE;QAChB,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG;QAC1B,IAAI,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE;KACvB,CAAC,CAAC;IACH,MAAM,EAAE,GAAG,CAAC,gCAAgC,OAAO,GAAG,CAAC,CAAC;IAExD,OAAO;QACL,QAAQ,EAAE,KAAK,EAAK,SAAuB,EAAc,EAAE;YACzD,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACzB,MAAM,GAAG,GAAG,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC;gBAC3E,CAAC,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,IAAI;gBAC/B,CAAC,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC,GAAG,CAAe,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/build/dev/index.d.ts

@@ -0,0 +1,3 @@
+export * from './create-handler-watcher.js';
+export * from './create-source-reloader.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/build/dev/index.js

@@ -0,0 +1,3 @@
+export * from './create-handler-watcher.js';
+export * from './create-source-reloader.js';
+//# sourceMappingURL=index.js.map

package/build/dev/index.js.map

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

package/build/dev/reload-loader.d.ts

@@ -0,0 +1,11 @@
+import type { InitializeHook, LoadHook, ResolveHook } from 'node:module';
+export interface ReloadLoaderData {
+    /** file:// URL prefix (with trailing slash) of the directory whose modules should be cache-busted on reload. Everything outside it (node_modules, this framework) is left untouched. */
+    rootUrl: string;
+    /** Shared 4-byte counter bumped on the main thread before each reload; read here to tag freshly-resolved local modules. */
+    sab: SharedArrayBuffer;
+}
+export declare const initialize: InitializeHook<ReloadLoaderData>;
+export declare const resolve: ResolveHook;
+export declare const load: LoadHook;
+//# sourceMappingURL=reload-loader.d.ts.map

package/build/dev/reload-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reload-loader.d.ts","sourceRoot":"","sources":["../../src/dev/reload-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAEd,QAAQ,EAER,WAAW,EACZ,MAAM,aAAa,CAAC;AAUrB,MAAM,WAAW,gBAAgB;IAC/B,wLAAwL;IACxL,OAAO,EAAE,MAAM,CAAC;IAChB,2HAA2H;IAC3H,GAAG,EAAE,iBAAiB,CAAC;CACxB;AAED,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,gBAAgB,CAGvD,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WASrB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,QAQlB,CAAC"}

package/build/dev/reload-loader.js

@@ -0,0 +1,28 @@
+// Runs in Node's dedicated loader thread (see `module.register()`), separate from the
+// main thread — state here can only be shared back via the SharedArrayBuffer passed
+// through `initialize`'s `data`, never via plain module-level variables on the main side.
+const EPOCH_PARAM = 'reloadEpoch';
+let rootUrl;
+let epochView;
+export const initialize = (data) => {
+    rootUrl = data.rootUrl;
+    epochView = new Int32Array(data.sab);
+};
+export const resolve = async (specifier, context, nextResolve) => {
+    const result = await nextResolve(specifier, context);
+    if (!rootUrl || !epochView || !result.url.startsWith(rootUrl)) {
+        return result;
+    }
+    const url = new URL(result.url);
+    url.searchParams.set(EPOCH_PARAM, String(Atomics.load(epochView, 0)));
+    return { ...result, url: url.href };
+};
+export const load = async (url, context, nextLoad) => {
+    if (!url.includes(EPOCH_PARAM)) {
+        return nextLoad(url, context);
+    }
+    const parsed = new URL(url);
+    parsed.searchParams.delete(EPOCH_PARAM);
+    return nextLoad(parsed.href, context);
+};
+//# sourceMappingURL=reload-loader.js.map

package/build/dev/reload-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reload-loader.js","sourceRoot":"","sources":["../../src/dev/reload-loader.ts"],"names":[],"mappings":"AAQA,sFAAsF;AACtF,oFAAoF;AACpF,0FAA0F;AAC1F,MAAM,WAAW,GAAG,aAAa,CAAC;AAElC,IAAI,OAA2B,CAAC;AAChC,IAAI,SAAiC,CAAC;AAStC,MAAM,CAAC,MAAM,UAAU,GAAqC,CAAC,IAAI,EAAE,EAAE;IACnE,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IACvB,SAAS,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAgB,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE;IAC5E,MAAM,MAAM,GAAoB,MAAM,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtE,IAAI,CAAC,OAAO,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9D,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;AACtC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAa,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;IAC7D,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/B,OAAO,QAAQ,CAAC,GAAG,EAAE,OAAO,CAA0B,CAAC;IACzD,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACxC,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAA0B,CAAC;AACjE,CAAC,CAAC"}

package/build/env/define-env.d.ts

@@ -0,0 +1,25 @@
+import { DotenvConfigOptions } from 'dotenv';
+import { z, ZodRawShape } from 'zod';
+export interface DefineEnvOptions {
+    /**
+     * Passed through to dotenv's `config()`. Defaults to `{ quiet: true }`.
+     * Pass `false` to skip loading a `.env` file entirely (e.g. a queue-worker
+     * process that inherits its environment from pm2).
+     */
+    dotenv?: DotenvConfigOptions | false;
+    /**
+     * Source object to validate. Defaults to `process.env`. Overriding this is
+     * primarily useful in tests, to validate a fixture object instead of the
+     * real environment.
+     */
+    source?: NodeJS.ProcessEnv;
+}
+/**
+ * Loads `.env` (via dotenv) and validates `process.env` against a zod shape,
+ * throwing a single formatted error listing every failing key. Required vs.
+ * optional vs. defaulted fields are expressed directly in the schema (e.g.
+ * `z.string().min(1)` vs `z.string().optional()` vs `.default(...)`) rather
+ * than via a separate required-keys list.
+ */
+export declare function defineEnv<Schema extends ZodRawShape>(schema: Schema, options?: DefineEnvOptions): Readonly<z.infer<z.ZodObject<Schema>>>;
+//# sourceMappingURL=define-env.d.ts.map

package/build/env/define-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-env.d.ts","sourceRoot":"","sources":["../../src/env/define-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AACnE,OAAO,EAAE,CAAC,EAAY,WAAW,EAAE,MAAM,KAAK,CAAC;AAE/C,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,MAAM,CAAC,EAAE,mBAAmB,GAAG,KAAK,CAAC;IACrC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAC5B;AAOD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,MAAM,SAAS,WAAW,EAClD,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,gBAAqB,GAC7B,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAWxC"}

package/build/env/define-env.js

@@ -0,0 +1,24 @@
+import { config as loadDotenv } from 'dotenv';
+import { z } from 'zod';
+const formatZodError = (error) => {
+    const lines = error.issues.map((issue) => `  - ${issue.path.join('.')}: ${issue.message}`);
+    return `Environment validation failed:\n${lines.join('\n')}`;
+};
+/**
+ * Loads `.env` (via dotenv) and validates `process.env` against a zod shape,
+ * throwing a single formatted error listing every failing key. Required vs.
+ * optional vs. defaulted fields are expressed directly in the schema (e.g.
+ * `z.string().min(1)` vs `z.string().optional()` vs `.default(...)`) rather
+ * than via a separate required-keys list.
+ */
+export function defineEnv(schema, options = {}) {
+    if (options.dotenv !== false) {
+        loadDotenv(options.dotenv ?? { quiet: true });
+    }
+    const result = z.object(schema).safeParse(options.source ?? process.env);
+    if (!result.success) {
+        throw new Error(formatZodError(result.error));
+    }
+    return Object.freeze(result.data);
+}
+//# sourceMappingURL=define-env.js.map

package/build/env/define-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-env.js","sourceRoot":"","sources":["../../src/env/define-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,UAAU,EAAuB,MAAM,QAAQ,CAAC;AACnE,OAAO,EAAE,CAAC,EAAyB,MAAM,KAAK,CAAC;AAiB/C,MAAM,cAAc,GAAG,CAAC,KAAe,EAAU,EAAE;IACjD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3F,OAAO,mCAAmC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC/D,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CACvB,MAAc,EACd,UAA4B,EAAE;IAE9B,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QAC7B,UAAU,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;IACzE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC"}

package/build/env/helpers.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+/**
+ * Reproduces the `VAR === 'true'` string-boolean convention used across the
+ * legacy bots' env files (e.g. `LOCAL`, `DEBUG_I18N`, `DISABLE_SETTINGS`).
+ * Any value other than the literal string `"true"` (including undefined/empty)
+ * resolves to `false`, matching the previous behavior exactly.
+ */
+export declare const boolFromString: () => z.ZodPreprocess<z.ZodBoolean>;
+//# sourceMappingURL=helpers.d.ts.map

package/build/env/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/env/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,eAAO,MAAM,cAAc,qCAG1B,CAAC"}

package/build/env/helpers.js

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+/**
+ * Reproduces the `VAR === 'true'` string-boolean convention used across the
+ * legacy bots' env files (e.g. `LOCAL`, `DEBUG_I18N`, `DISABLE_SETTINGS`).
+ * Any value other than the literal string `"true"` (including undefined/empty)
+ * resolves to `false`, matching the previous behavior exactly.
+ */
+export const boolFromString = () => z.preprocess((value) => value === 'true', z.boolean());
+//# sourceMappingURL=helpers.js.map

package/build/env/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/env/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,UAAU,CAC9C,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,MAAM,EAC3B,CAAC,CAAC,OAAO,EAAE,CACZ,CAAC"}

package/build/env/index.d.ts

@@ -0,0 +1,3 @@
+export * from './define-env.js';
+export * from './helpers.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/build/env/index.js

@@ -0,0 +1,3 @@
+export * from './define-env.js';
+export * from './helpers.js';
+//# sourceMappingURL=index.js.map

package/build/env/index.js.map

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

package/build/i18n/create-command-localizer.d.ts

@@ -0,0 +1,27 @@
+import { TFunction } from 'i18next';
+export interface CreateCommandLocalizerOptions {
+    /** All locale codes to attempt name_localizations/description_localizations for. */
+    locales: readonly string[];
+    /** The base/default locale whose translation (if present) also becomes the plain `description` fallback value. */
+    baseLocale: string;
+    t: TFunction;
+}
+export interface CommandLocalizer {
+    /** Matches `DescriptionResolver`'s shape - pass directly as `buildApplicationCommandsBody`'s `resolveDescription`. */
+    resolveDescription: (path: readonly string[]) => string | undefined;
+    /** Matches `LocalizationResolver`'s shape - pass directly as `buildApplicationCommandsBody`'s `localizeNames`. */
+    localizeName: (path: readonly string[]) => Record<string, string> | undefined;
+    /** Matches `LocalizationResolver`'s shape - pass directly as `buildApplicationCommandsBody`'s `localizeDescriptions`. */
+    localizeDescription: (path: readonly string[]) => Record<string, string> | undefined;
+}
+/**
+ * Generic i18next-backed localizer for commands.json entries, replacing a
+ * bot's own bespoke `getLocalizedObject`/`getCommonOptionMeta`-style helpers.
+ * Every method takes the same dot-path-shaped key array
+ * `buildApplicationCommandsBody` builds internally (e.g.
+ * `['commands', 'search', 'description']`), so its three hook slots
+ * (`resolveDescription`, `localizeNames`, `localizeDescriptions`) can be
+ * wired straight to this object's methods with no glue code.
+ */
+export declare function createCommandLocalizer(options: CreateCommandLocalizerOptions): CommandLocalizer;
+//# sourceMappingURL=create-command-localizer.d.ts.map

package/build/i18n/create-command-localizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-command-localizer.d.ts","sourceRoot":"","sources":["../../src/i18n/create-command-localizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,MAAM,WAAW,6BAA6B;IAC5C,oFAAoF;IACpF,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,kHAAkH;IAClH,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,EAAE,SAAS,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,sHAAsH;IACtH,kBAAkB,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,MAAM,GAAG,SAAS,CAAC;IACpE,kHAAkH;IAClH,YAAY,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC9E,yHAAyH;IACzH,mBAAmB,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CACtF;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG,gBAAgB,CAgC/F"}

package/build/i18n/create-command-localizer.js

@@ -0,0 +1,40 @@
+/**
+ * Generic i18next-backed localizer for commands.json entries, replacing a
+ * bot's own bespoke `getLocalizedObject`/`getCommonOptionMeta`-style helpers.
+ * Every method takes the same dot-path-shaped key array
+ * `buildApplicationCommandsBody` builds internally (e.g.
+ * `['commands', 'search', 'description']`), so its three hook slots
+ * (`resolveDescription`, `localizeNames`, `localizeDescriptions`) can be
+ * wired straight to this object's methods with no glue code.
+ */
+export function createCommandLocalizer(options) {
+    const { locales, baseLocale, t } = options;
+    function translate(path, lng) {
+        const key = path.join('.');
+        // fallbackLng disabled so each locale's own coverage is checked
+        // independently - otherwise a configured fallback chain would silently
+        // fill in every locale from the fallback language, and localizeName/
+        // localizeDescription could never produce a sparse per-locale dictionary.
+        // i18next echoes the key back unchanged when no translation exists (no
+        // returnNull/parseMissingKeyHandler configured) - that echo is the only
+        // signal available to detect "not found" with a plain TFunction.
+        const value = t(key, { lng, fallbackLng: false });
+        return value === key ? undefined : value;
+    }
+    function localizeAll(path) {
+        const result = {};
+        for (const locale of locales) {
+            const value = translate(path, locale);
+            if (value !== undefined) {
+                result[locale] = value;
+            }
+        }
+        return Object.keys(result).length > 0 ? result : undefined;
+    }
+    return {
+        resolveDescription: (path) => translate(path, baseLocale),
+        localizeName: (path) => localizeAll(path),
+        localizeDescription: (path) => localizeAll(path),
+    };
+}
+//# sourceMappingURL=create-command-localizer.js.map

package/build/i18n/create-command-localizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-command-localizer.js","sourceRoot":"","sources":["../../src/i18n/create-command-localizer.ts"],"names":[],"mappings":"AAmBA;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAsC;IAC3E,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC;IAE3C,SAAS,SAAS,CAAC,IAAuB,EAAE,GAAW;QACrD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3B,gEAAgE;QAChE,uEAAuE;QACvE,qEAAqE;QACrE,0EAA0E;QAC1E,uEAAuE;QACvE,wEAAwE;QACxE,iEAAiE;QACjE,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;QAClD,OAAO,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3C,CAAC;IAED,SAAS,WAAW,CAAC,IAAuB;QAC1C,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACtC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;YACzB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7D,CAAC;IAED,OAAO;QACL,kBAAkB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC;QACzD,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC;QACzC,mBAAmB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC;KACjD,CAAC;AACJ,CAAC"}

package/build/i18n/create-i18n-initializer.d.ts

@@ -0,0 +1,18 @@
+import { i18n } from 'i18next';
+import { NestableLogger } from '../logger/types.js';
+export interface CreateI18nInitializerOptions {
+    /** Directory containing `{{lng}}/{{ns}}.json` locale files. */
+    localesDir: string;
+    supportedLngs: string[];
+    fallbackLng: string;
+    debug?: boolean;
+}
+/**
+ * Wraps the i18next + i18next-fs-backend bootstrap shared by bots that use
+ * localized commands. Returns an initializer function that lazily
+ * initializes i18next on first call and reuses the same instance on
+ * subsequent calls (matching the singleton-init-promise pattern the source
+ * bots already use).
+ */
+export declare function createI18nInitializer(options: CreateI18nInitializerOptions): (logger: NestableLogger) => Promise<i18n>;
+//# sourceMappingURL=create-i18n-initializer.d.ts.map

package/build/i18n/create-i18n-initializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-i18n-initializer.d.ts","sourceRoot":"","sources":["../../src/i18n/create-i18n-initializer.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAExC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,WAAW,4BAA4B;IAC3C,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CA2BtH"}

package/build/i18n/create-i18n-initializer.js

@@ -0,0 +1,34 @@
+import i18next from 'i18next';
+import Backend from 'i18next-fs-backend';
+/**
+ * Wraps the i18next + i18next-fs-backend bootstrap shared by bots that use
+ * localized commands. Returns an initializer function that lazily
+ * initializes i18next on first call and reuses the same instance on
+ * subsequent calls (matching the singleton-init-promise pattern the source
+ * bots already use).
+ */
+export function createI18nInitializer(options) {
+    let initPromise = null;
+    return (logger) => {
+        if (initPromise !== null) {
+            return initPromise;
+        }
+        logger.log('Initializing i18n');
+        initPromise = i18next.use(Backend).init({
+            lng: options.fallbackLng,
+            fallbackLng: options.fallbackLng,
+            debug: options.debug ?? false,
+            preload: options.supportedLngs,
+            backend: {
+                loadPath: `${options.localesDir}/{{lng}}/{{ns}}.json`,
+            },
+            interpolation: {
+                escapeValue: false,
+            },
+            overloadTranslationOptionHandler: () => ({}),
+            showSupportNotice: false,
+        }).then(() => i18next);
+        return initPromise;
+    };
+}
+//# sourceMappingURL=create-i18n-initializer.js.map

package/build/i18n/create-i18n-initializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-i18n-initializer.js","sourceRoot":"","sources":["../../src/i18n/create-i18n-initializer.ts"],"names":[],"mappings":"AAAA,OAAO,OAAiB,MAAM,SAAS,CAAC;AACxC,OAAO,OAAO,MAAM,oBAAoB,CAAC;AAWzC;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAqC;IACzE,IAAI,WAAW,GAAyB,IAAI,CAAC;IAE7C,OAAO,CAAC,MAAsB,EAAiB,EAAE;QAC/C,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;QAEhC,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;YACtC,GAAG,EAAE,OAAO,CAAC,WAAW;YACxB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK;YAC7B,OAAO,EAAE,OAAO,CAAC,aAAa;YAC9B,OAAO,EAAE;gBACP,QAAQ,EAAE,GAAG,OAAO,CAAC,UAAU,sBAAsB;aACtD;YACD,aAAa,EAAE;gBACb,WAAW,EAAE,KAAK;aACnB;YACD,gCAAgC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;YAC5C,iBAAiB,EAAE,KAAK;SACzB,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC;QAEvB,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC;AACJ,CAAC"}

package/build/i18n/index.d.ts

@@ -0,0 +1,3 @@
+export * from './create-i18n-initializer.js';
+export * from './create-command-localizer.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC"}

package/build/i18n/index.js

@@ -0,0 +1,3 @@
+export * from './create-i18n-initializer.js';
+export * from './create-command-localizer.js';
+//# sourceMappingURL=index.js.map

package/build/i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC"}

package/build/index.d.ts

@@ -0,0 +1,8 @@
+export * from './logger/index.js';
+export * from './env/index.js';
+export * from './api-client/index.js';
+export * from './interactions/index.js';
+export * from './commands/index.js';
+export * from './client/index.js';
+export * from './utils/index.js';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}

package/build/index.js

@@ -0,0 +1,12 @@
+// Core (non-optional) modules. Optional pieces (Postgres/Prisma, i18next)
+// are only available via their own subpaths:
+//   @went.tf/discord-bot-framework/db
+//   @went.tf/discord-bot-framework/i18n
+export * from './logger/index.js';
+export * from './env/index.js';
+export * from './api-client/index.js';
+export * from './interactions/index.js';
+export * from './commands/index.js';
+export * from './client/index.js';
+export * from './utils/index.js';
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,6CAA6C;AAC7C,sCAAsC;AACtC,wCAAwC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}

package/build/interactions/custom-id.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Splits a component/modal customId of the form `id:resourceId` into its
+ * parts. `resourceId` is undefined when no separator is present.
+ */
+export declare function parseCustomIdSegments(customId: string, separator?: string): {
+    id: string;
+    resourceId?: string;
+};
+//# sourceMappingURL=custom-id.d.ts.map

package/build/interactions/custom-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-id.d.ts","sourceRoot":"","sources":["../../src/interactions/custom-id.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAS5G"}

package/build/interactions/custom-id.js

@@ -0,0 +1,15 @@
+/**
+ * Splits a component/modal customId of the form `id:resourceId` into its
+ * parts. `resourceId` is undefined when no separator is present.
+ */
+export function parseCustomIdSegments(customId, separator = ':') {
+    const separatorIndex = customId.indexOf(separator);
+    if (separatorIndex === -1) {
+        return { id: customId };
+    }
+    return {
+        id: customId.substring(0, separatorIndex),
+        resourceId: customId.substring(separatorIndex + separator.length),
+    };
+}
+//# sourceMappingURL=custom-id.js.map

package/build/interactions/custom-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-id.js","sourceRoot":"","sources":["../../src/interactions/custom-id.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,SAAS,GAAG,GAAG;IACrE,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACnD,IAAI,cAAc,KAAK,CAAC,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;IAC1B,CAAC;IACD,OAAO;QACL,EAAE,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,cAAc,CAAC;QACzC,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC;KAClE,CAAC;AACJ,CAAC"}

package/build/interactions/dispatch.d.ts

@@ -0,0 +1,35 @@
+import { AutocompleteInteraction, ChatInputCommandInteraction, MessageComponentInteraction, ModalSubmitInteraction, UserContextMenuCommandInteraction, MessageContextMenuCommandInteraction } from 'discord.js';
+import { BaseInteractionContext, BotChatInputCommand, BotContextMenuCommand, BotMessageComponent, BotModal } from './types.js';
+export type OnDispatchError<Ctx> = (interaction: unknown, context: Ctx, error: unknown) => void | Promise<void>;
+export interface DispatchChatInputCommandOptions<Ctx extends BaseInteractionContext> {
+    commands: Record<string, BotChatInputCommand<Ctx>>;
+    onUnknownCommand?: (interaction: ChatInputCommandInteraction, context: Ctx) => void | Promise<void>;
+    onError: OnDispatchError<Ctx>;
+}
+export declare function dispatchChatInputCommand<Ctx extends BaseInteractionContext>(interaction: ChatInputCommandInteraction, context: Ctx, options: DispatchChatInputCommandOptions<Ctx>): Promise<void>;
+export interface DispatchAutocompleteOptions<Ctx extends BaseInteractionContext> {
+    commands: Record<string, BotChatInputCommand<Ctx>>;
+    onError: OnDispatchError<Ctx>;
+}
+export declare function dispatchAutocomplete<Ctx extends BaseInteractionContext>(interaction: AutocompleteInteraction, context: Ctx, options: DispatchAutocompleteOptions<Ctx>): Promise<void>;
+export interface DispatchComponentOptions<Ctx extends BaseInteractionContext> {
+    components: Record<string, BotMessageComponent<Ctx>>;
+    customIdSeparator?: string;
+    onUnknownComponent?: (interaction: MessageComponentInteraction, context: Ctx) => void | Promise<void>;
+    onError: OnDispatchError<Ctx>;
+}
+export declare function dispatchComponent<Ctx extends BaseInteractionContext>(interaction: MessageComponentInteraction, context: Ctx, options: DispatchComponentOptions<Ctx>): Promise<void>;
+export interface DispatchModalOptions<Ctx extends BaseInteractionContext> {
+    modals: Record<string, BotModal<Ctx>>;
+    customIdSeparator?: string;
+    onUnknownModal?: (interaction: ModalSubmitInteraction, context: Ctx) => void | Promise<void>;
+    onError: OnDispatchError<Ctx>;
+}
+export declare function dispatchModal<Ctx extends BaseInteractionContext>(interaction: ModalSubmitInteraction, context: Ctx, options: DispatchModalOptions<Ctx>): Promise<void>;
+export interface DispatchContextMenuOptions<Ctx extends BaseInteractionContext> {
+    contextMenuCommands: Record<string, BotContextMenuCommand<Ctx>>;
+    onUnknownCommand?: (interaction: UserContextMenuCommandInteraction | MessageContextMenuCommandInteraction, context: Ctx) => void | Promise<void>;
+    onError: OnDispatchError<Ctx>;
+}
+export declare function dispatchContextMenu<Ctx extends BaseInteractionContext>(interaction: UserContextMenuCommandInteraction | MessageContextMenuCommandInteraction, context: Ctx, options: DispatchContextMenuOptions<Ctx>): Promise<void>;
+//# sourceMappingURL=dispatch.d.ts.map

package/build/interactions/dispatch.d.ts.map

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

package/build/interactions/dispatch.js

@@ -0,0 +1,87 @@
+import { parseCustomIdSegments } from './custom-id.js';
+export async function dispatchChatInputCommand(interaction, context, options) {
+    const command = options.commands[interaction.commandName];
+    if (!command) {
+        if (options.onUnknownCommand) {
+            await options.onUnknownCommand(interaction, context);
+            return;
+        }
+        throw new Error(`Unknown command ${interaction.commandName}`);
+    }
+    try {
+        await command.handle(interaction, context);
+    }
+    catch (e) {
+        context.logger.error(`Error while responding to command interaction (commandName=${interaction.commandName})`, e);
+        await options.onError(interaction, context, e);
+    }
+}
+export async function dispatchAutocomplete(interaction, context, options) {
+    const command = options.commands[interaction.commandName];
+    try {
+        const focusedOption = interaction.options.getFocused(true);
+        const handler = command?.autocomplete?.[focusedOption.name];
+        if (!handler) {
+            throw new Error(`Unknown autocomplete option ${focusedOption.name} for command ${interaction.commandName}`);
+        }
+        await handler(interaction, context, focusedOption.name);
+    }
+    catch (e) {
+        context.logger.error(`Error while responding to command autocomplete (commandName=${interaction.commandName})`, e);
+        await options.onError(interaction, context, e);
+    }
+}
+export async function dispatchComponent(interaction, context, options) {
+    const { id, resourceId } = parseCustomIdSegments(interaction.customId, options.customIdSeparator);
+    const component = options.components[id];
+    if (!component) {
+        if (options.onUnknownComponent) {
+            await options.onUnknownComponent(interaction, context);
+            return;
+        }
+        throw new Error(`Unknown component customId ${id}`);
+    }
+    try {
+        await component.handle(interaction, context, resourceId);
+    }
+    catch (e) {
+        context.logger.error(`Error while responding to component interaction (customId=${id},resourceId=${resourceId})`, e);
+        await options.onError(interaction, context, e);
+    }
+}
+export async function dispatchModal(interaction, context, options) {
+    const { id, resourceId } = parseCustomIdSegments(interaction.customId, options.customIdSeparator);
+    const modal = options.modals[id];
+    if (!modal) {
+        if (options.onUnknownModal) {
+            await options.onUnknownModal(interaction, context);
+            return;
+        }
+        throw new Error(`Unknown modal customId ${id}`);
+    }
+    try {
+        await modal.handle(interaction, context, resourceId);
+    }
+    catch (e) {
+        context.logger.error(`Error while responding to modal submit interaction (customId=${id},resourceId=${resourceId})`, e);
+        await options.onError(interaction, context, e);
+    }
+}
+export async function dispatchContextMenu(interaction, context, options) {
+    const command = options.contextMenuCommands[interaction.commandName];
+    if (!command) {
+        if (options.onUnknownCommand) {
+            await options.onUnknownCommand(interaction, context);
+            return;
+        }
+        throw new Error(`Unknown context menu command ${interaction.commandName}`);
+    }
+    try {
+        await command.handle(interaction, context);
+    }
+    catch (e) {
+        context.logger.error(`Error while responding to context menu interaction (commandName=${interaction.commandName})`, e);
+        await options.onError(interaction, context, e);
+    }
+}
+//# sourceMappingURL=dispatch.js.map

package/build/interactions/dispatch.js.map

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

package/build/interactions/handle-interaction-error.d.ts

@@ -0,0 +1,22 @@
+import { AutocompleteInteraction, InteractionReplyOptions, RepliableInteraction } from 'discord.js';
+import { NestableLogger } from '../logger/types.js';
+export interface HandleInteractionErrorOptions {
+    /** Builds the (already-localized, if applicable) error message text shown to the user. */
+    buildMessage: () => string;
+    /**
+     * Sends the initial ephemeral error reply. Defaults to a plain
+     * `interaction.reply(options)`. Override to plug in bot-specific reply
+     * wrapping (e.g. ComponentsV2 upgrades, translation footers).
+     */
+    reply?: (interaction: RepliableInteraction, options: InteractionReplyOptions) => Promise<unknown>;
+    /**
+     * Called once, only on the "first reply" path (not the edit-existing-reply
+     * fallback), when an error is about to be shown to the user for the first
+     * time. Useful for e.g. @mentioning a bot owner.
+     */
+    onUnexpectedError?: () => void | Promise<void>;
+}
+export declare const handleInteractionError: (interaction: RepliableInteraction | AutocompleteInteraction, context: {
+    logger: NestableLogger;
+}, options: HandleInteractionErrorOptions) => Promise<void>;
+//# sourceMappingURL=handle-interaction-error.d.ts.map