@azurioh/discord-kernel 0.1.0 → 1.0.0

package/dist/settings/settings-validation-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-validation-error.js","sourceRoot":"","sources":["../../src/settings/settings-validation-error.ts"],"names":[],"mappings":";;;AAAA,4DAAiF;AA8BjF;;;GAGG;AACH,MAAa,uBAAwB,SAAQ,gCAAe;IACtC;IAArB,YAAqB,MAAgC;QACpD,KAAK,CACJ,qBAAqB,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACzF,CAAC;QAHkB,WAAM,GAAN,MAAM,CAA0B;IAIrD,CAAC;CACD;AAND,0DAMC"}

package/dist/settings/status.d.ts

@@ -0,0 +1,16 @@
+import type { SettingsDeclaration } from "../settings/define-settings";
+/** Whether a module can run on a guild: what an administrator still has to set. */
+export interface SettingsStatus {
+    /** Keys of the required fields without default the guild left unset, in declared order. */
+    readonly missing: readonly string[];
+}
+/**
+ * The configuration status of a module's values on one guild (FR-040). A
+ * required field with a default always has a value, so it is never missing.
+ *
+ * @param declaration - the module's settings declaration.
+ * @param values - the guild's values as the service reads them: an unset (or
+ * invalid) field is `undefined` unless it has a default.
+ */
+export declare function settingsStatus(declaration: SettingsDeclaration, values: Readonly<Record<string, unknown>>): SettingsStatus;
+//# sourceMappingURL=status.d.ts.map

package/dist/settings/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/settings/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,mFAAmF;AACnF,MAAM,WAAW,cAAc;IAC9B,2FAA2F;IAC3F,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC7B,WAAW,EAAE,mBAAmB,EAChC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACvC,cAAc,CAKhB"}

package/dist/settings/status.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.settingsStatus = settingsStatus;
+/**
+ * The configuration status of a module's values on one guild (FR-040). A
+ * required field with a default always has a value, so it is never missing.
+ *
+ * @param declaration - the module's settings declaration.
+ * @param values - the guild's values as the service reads them: an unset (or
+ * invalid) field is `undefined` unless it has a default.
+ */
+function settingsStatus(declaration, values) {
+    const missing = Object.entries(declaration.fields)
+        .filter(([key, declared]) => declared.required && values[key] === undefined)
+        .map(([key]) => key);
+    return { missing };
+}
+//# sourceMappingURL=status.js.map

package/dist/settings/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/settings/status.ts"],"names":[],"mappings":";;AAgBA,wCAQC;AAhBD;;;;;;;GAOG;AACH,SAAgB,cAAc,CAC7B,WAAgC,EAChC,MAAyC;IAEzC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC;SAChD,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;SAC3E,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;IACtB,OAAO,EAAE,OAAO,EAAE,CAAC;AACpB,CAAC"}

package/dist/settings/suggest.d.ts

@@ -0,0 +1,77 @@
+import type { Translator } from "../i18n/translator";
+import type { Logger } from "../logger";
+import type { Choice } from "../settings/choice";
+import { type DynamicSuggestions, type FieldSpec, type SuggestionContext } from "../settings/fields/field";
+import type { GuildDirectory } from "../settings/ports/guild-directory";
+/**
+ * The ports suggestions read: the guild's directory, the translator of static
+ * labels, and where a slow or failed search is logged.
+ */
+export interface SuggestionPorts {
+    readonly guilds: GuildDirectory;
+    readonly translator: Translator;
+    readonly logger: Logger;
+}
+/** What one field's suggestions are computed with: the ports, the field, and who asks. */
+export interface SuggestionScope extends SuggestionPorts {
+    readonly moduleId: string;
+    /** The field's key, named in logs. */
+    readonly key: string;
+    readonly ctx: SuggestionContext;
+}
+/** A search the kernel runs on the module's behalf, whatever the value type it suggests. */
+type AnyDynamicSuggestions = DynamicSuggestions<unknown>;
+/**
+ * The suggestions of one field for `query` (FR-021, FR-025): a channel, role
+ * or member field searches the guild; an enum and static suggestions offer
+ * their choices translated to the requester's locale, those whose name or
+ * value contains the query (case-insensitive); a dynamic search gets the
+ * query and the context as is. A list suggests for its item. At most
+ * {@link MAX_AUTOCOMPLETE_CHOICES} results, the first ones kept; a search
+ * slower than the budget or failing yields none (logged). Never throws.
+ *
+ * @param params.scope - who asks and the ports the search reads.
+ * @param params.spec - the field's kind and constraints.
+ * @param params.query - what was typed so far; empty for a first page.
+ * @returns the suggestions, labels already translated.
+ */
+export declare function suggestChoices(params: {
+    scope: SuggestionScope;
+    spec: FieldSpec;
+    query: string;
+}): Promise<readonly Choice[]>;
+/**
+ * The readable label of one stored value of a field, in the requester's
+ * locale: a channel, role or member's name on the guild, a static choice's
+ * translated label, or what a dynamic search says (see {@link dynamicLabel}).
+ * A list reads `value` as one of its items. Never throws.
+ *
+ * @param params.scope - who asks and the ports the label reads.
+ * @param params.spec - the field's kind and constraints.
+ * @param params.value - the stored value.
+ * @returns the label, or `undefined` when none is known.
+ */
+export declare function suggestionLabel(params: {
+    scope: SuggestionScope;
+    spec: FieldSpec;
+    value: unknown;
+}): Promise<string | undefined>;
+/**
+ * What a dynamic search calls `value` (FR-022): its own `label` when it
+ * declares one, otherwise the name of the result of `resolve(String(value))`
+ * whose value is exactly `value`. `undefined` when the search does not know
+ * the value, or runs past the budget or fails (logged). A strict field
+ * accepts exactly the values this labels (FR-023).
+ *
+ * @param params.scope - who asks, and where a slow or failed search is logged.
+ * @param params.suggest - the field's search.
+ * @param params.value - the value to label.
+ * @returns the label, or `undefined`.
+ */
+export declare function dynamicLabel(params: {
+    scope: SuggestionScope;
+    suggest: AnyDynamicSuggestions;
+    value: unknown;
+}): Promise<string | undefined>;
+export {};
+//# sourceMappingURL=suggest.d.ts.map

package/dist/settings/suggest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../src/settings/suggest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACN,KAAK,kBAAkB,EAEvB,KAAK,SAAS,EACd,KAAK,iBAAiB,EAGtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAGvE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,0FAA0F;AAC1F,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sCAAsC;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAC;CAChC;AAED,4FAA4F;AAC5F,KAAK,qBAAqB,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAEzD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC5C,KAAK,EAAE,eAAe,CAAC;IACvB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAG7B;AAgED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE;IAC7C,KAAK,EAAE,eAAe,CAAC;IACvB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgC9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACpC,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,qBAAqB,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAc9B"}

package/dist/settings/suggest.js

@@ -0,0 +1,192 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.suggestChoices = suggestChoices;
+exports.suggestionLabel = suggestionLabel;
+exports.dynamicLabel = dynamicLabel;
+const autocomplete_limits_1 = require("../discord/command/autocomplete-limits");
+const locale_1 = require("../i18n/locale");
+const field_1 = require("../settings/fields/field");
+const timed_search_1 = require("../settings/timed-search");
+/**
+ * The suggestions of one field for `query` (FR-021, FR-025): a channel, role
+ * or member field searches the guild; an enum and static suggestions offer
+ * their choices translated to the requester's locale, those whose name or
+ * value contains the query (case-insensitive); a dynamic search gets the
+ * query and the context as is. A list suggests for its item. At most
+ * {@link MAX_AUTOCOMPLETE_CHOICES} results, the first ones kept; a search
+ * slower than the budget or failing yields none (logged). Never throws.
+ *
+ * @param params.scope - who asks and the ports the search reads.
+ * @param params.spec - the field's kind and constraints.
+ * @param params.query - what was typed so far; empty for a first page.
+ * @returns the suggestions, labels already translated.
+ */
+async function suggestChoices(params) {
+    const choices = await allChoices(params);
+    return choices.slice(0, autocomplete_limits_1.MAX_AUTOCOMPLETE_CHOICES);
+}
+async function allChoices(params) {
+    const { scope, spec, query } = params;
+    const { guilds, ctx } = scope;
+    switch (spec.kind) {
+        case "channel":
+            return timed({
+                scope,
+                fallback: [],
+                search: async () => named(await guilds.searchChannels(ctx.guildId, query, spec.types)),
+            });
+        case "role":
+            return timed({
+                scope,
+                fallback: [],
+                search: async () => named(await guilds.searchRoles(ctx.guildId, query)),
+            });
+        case "user":
+            return timed({
+                scope,
+                fallback: [],
+                search: async () => named(await guilds.searchMembers(ctx.guildId, query)),
+            });
+        case "enum":
+            return matching({ choices: translated({ scope, choices: spec.choices }), query });
+        case "integer":
+        case "text":
+            return declaredChoices({ scope, suggest: spec.suggest, query });
+        case "list":
+            return allChoices({ scope, spec: spec.item.spec, query });
+        case "color":
+        case "duration":
+        case "number":
+        case "boolean":
+        case "secret":
+        case "toggles":
+            return [];
+        default:
+            return (0, field_1.unhandledFieldKind)(spec);
+    }
+}
+/** The suggestions a module declared on an integer or text field, if any. */
+async function declaredChoices(params) {
+    const { scope, suggest, query } = params;
+    if (suggest === undefined) {
+        return [];
+    }
+    if ("choices" in suggest) {
+        return matching({ choices: translated({ scope, choices: suggest.choices }), query });
+    }
+    const search = suggest;
+    return timed({ scope, fallback: [], search: () => search.resolve(query, scope.ctx) });
+}
+/**
+ * The readable label of one stored value of a field, in the requester's
+ * locale: a channel, role or member's name on the guild, a static choice's
+ * translated label, or what a dynamic search says (see {@link dynamicLabel}).
+ * A list reads `value` as one of its items. Never throws.
+ *
+ * @param params.scope - who asks and the ports the label reads.
+ * @param params.spec - the field's kind and constraints.
+ * @param params.value - the stored value.
+ * @returns the label, or `undefined` when none is known.
+ */
+async function suggestionLabel(params) {
+    const { scope, spec, value } = params;
+    const { guilds, ctx } = scope;
+    switch (spec.kind) {
+        case "channel":
+            return entityName({ scope, find: (id) => guilds.channel(ctx.guildId, id), value });
+        case "role":
+            return entityName({ scope, find: (id) => guilds.role(ctx.guildId, id), value });
+        case "user":
+            return entityName({ scope, find: (id) => guilds.member(ctx.guildId, id), value });
+        case "enum":
+            return staticLabel({ scope, choices: spec.choices, value });
+        case "integer":
+        case "text":
+            if (spec.suggest === undefined) {
+                return undefined;
+            }
+            return "choices" in spec.suggest
+                ? staticLabel({ scope, choices: spec.suggest.choices, value })
+                : dynamicLabel({ scope, suggest: spec.suggest, value });
+        case "list":
+            return suggestionLabel({ scope, spec: spec.item.spec, value });
+        case "color":
+        case "duration":
+        case "number":
+        case "boolean":
+        case "secret":
+        case "toggles":
+            return undefined;
+        default:
+            return (0, field_1.unhandledFieldKind)(spec);
+    }
+}
+/**
+ * What a dynamic search calls `value` (FR-022): its own `label` when it
+ * declares one, otherwise the name of the result of `resolve(String(value))`
+ * whose value is exactly `value`. `undefined` when the search does not know
+ * the value, or runs past the budget or fails (logged). A strict field
+ * accepts exactly the values this labels (FR-023).
+ *
+ * @param params.scope - who asks, and where a slow or failed search is logged.
+ * @param params.suggest - the field's search.
+ * @param params.value - the value to label.
+ * @returns the label, or `undefined`.
+ */
+function dynamicLabel(params) {
+    const { scope, suggest, value } = params;
+    const { label } = suggest;
+    if (label !== undefined) {
+        return timed({ scope, fallback: undefined, search: () => label(value, scope.ctx) });
+    }
+    return timed({
+        scope,
+        fallback: undefined,
+        search: async () => {
+            const results = await suggest.resolve(String(value), scope.ctx);
+            return results.find((choice) => choice.value === value)?.name;
+        },
+    });
+}
+/** A search within the suggestion budget, logged under the scope's module, field and guild. */
+function timed(params) {
+    const { scope, fallback, search } = params;
+    return (0, timed_search_1.timedSearch)({
+        search,
+        fallback,
+        logger: scope.logger,
+        at: { moduleId: scope.moduleId, field: scope.key, guildId: scope.ctx.guildId },
+    });
+}
+/** The name of the guild entity a stored id names, if the guild still has it. */
+function entityName(params) {
+    const { scope, find, value } = params;
+    if (typeof value !== "string") {
+        return Promise.resolve(undefined);
+    }
+    return timed({ scope, fallback: undefined, search: async () => (await find(value))?.name });
+}
+/** Guild entities as choices: their name shown, their id stored. */
+function named(entities) {
+    return entities.map((entity) => ({ name: entity.name, value: entity.id }));
+}
+/** Static choices with their labels translated to the requester's locale. */
+function translated(params) {
+    const { scope, choices } = params;
+    const locale = (0, locale_1.resolveLocale)([scope.ctx.locale], scope.translator.defaultLocale);
+    return choices.map((choice) => ({
+        name: scope.translator.translate(locale, choice.label),
+        value: choice.value,
+    }));
+}
+/** The choices whose name or value contains `query`, case-insensitive; all of them for an empty query. */
+function matching(params) {
+    const needle = params.query.trim().toLowerCase();
+    return params.choices.filter((choice) => choice.name.toLowerCase().includes(needle) ||
+        String(choice.value).toLowerCase().includes(needle));
+}
+/** The translated label of the static choice storing `value`. */
+function staticLabel(params) {
+    return translated(params).find((choice) => choice.value === params.value)?.name;
+}
+//# sourceMappingURL=suggest.js.map

package/dist/settings/suggest.js.map

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

package/dist/settings/system/kernel-settings.d.ts

@@ -0,0 +1,43 @@
+/** Id of the kernel's own settings declaration. */
+export declare const KERNEL_SETTINGS_ID = "kernel";
+/**
+ * What the kernel declaration needs to know of a module. A `BotModule`
+ * satisfies it as is, so the composition root passes its modules unchanged.
+ */
+export interface ModuleEnablement {
+    readonly name: string;
+    /**
+     * Catalog key of the module's name as administrators read it, shown on its
+     * toggle. Without one the toggle shows the raw module name, and the translator
+     * logs it as an unknown key: give every toggleable module a label.
+     */
+    readonly label?: string;
+    /** Whether the module starts enabled in a guild that never toggled it. Defaults to `true`. */
+    readonly defaultEnabled?: boolean;
+}
+/**
+ * The kernel's own settings, declared like any module's (FR-039): which
+ * modules are enabled on the guild, and the bot's language there.
+ *
+ * A factory rather than a constant because the module names are only known at
+ * composition: `createSettingsRegistry` calls it with the modules it receives.
+ *
+ * @param modules - the registered modules, in registration order.
+ * @returns the declaration of id {@link KERNEL_SETTINGS_ID}.
+ * @throws SettingsDeclarationError when two modules share a name.
+ */
+export declare function kernelSettings(modules: readonly ModuleEnablement[]): {
+    readonly id: "kernel";
+    readonly version: 1;
+    readonly labels: {
+        readonly title: "core.settings.kernel.title";
+        readonly description: "core.settings.kernel.description";
+    };
+    readonly fields: {
+        readonly modules: import("..").Field<Readonly<Record<string, boolean>>, "defined">;
+        readonly locale: import("..").Field<"en" | "fr", "optional">;
+    };
+};
+/** The kernel's settings declaration, as built by {@link kernelSettings}. */
+export type KernelSettings = ReturnType<typeof kernelSettings>;
+//# sourceMappingURL=kernel-settings.d.ts.map

package/dist/settings/system/kernel-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-settings.d.ts","sourceRoot":"","sources":["../../../src/settings/system/kernel-settings.ts"],"names":[],"mappings":"AAKA,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,8FAA8F;IAC9F,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CAClC;AAOD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE;;;;;;;;;;;EA8BlE;AAED,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/settings/system/kernel-settings.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KERNEL_SETTINGS_ID = void 0;
+exports.kernelSettings = kernelSettings;
+const locale_1 = require("../../i18n/locale");
+const define_settings_1 = require("../../settings/define-settings");
+const builders_1 = require("../../settings/fields/builders");
+const messages_1 = require("../../settings/messages");
+/** Id of the kernel's own settings declaration. */
+exports.KERNEL_SETTINGS_ID = "kernel";
+const LOCALE_LABELS = {
+    en: messages_1.KERNEL_SETTINGS_MESSAGES.localeEn,
+    fr: messages_1.KERNEL_SETTINGS_MESSAGES.localeFr,
+};
+/**
+ * The kernel's own settings, declared like any module's (FR-039): which
+ * modules are enabled on the guild, and the bot's language there.
+ *
+ * A factory rather than a constant because the module names are only known at
+ * composition: `createSettingsRegistry` calls it with the modules it receives.
+ *
+ * @param modules - the registered modules, in registration order.
+ * @returns the declaration of id {@link KERNEL_SETTINGS_ID}.
+ * @throws SettingsDeclarationError when two modules share a name.
+ */
+function kernelSettings(modules) {
+    return (0, define_settings_1.defineSettings)({
+        id: exports.KERNEL_SETTINGS_ID,
+        version: 1,
+        labels: {
+            title: messages_1.KERNEL_SETTINGS_MESSAGES.title,
+            description: messages_1.KERNEL_SETTINGS_MESSAGES.description,
+        },
+        fields: {
+            modules: builders_1.field.toggles({
+                label: messages_1.KERNEL_SETTINGS_MESSAGES.modules,
+                description: messages_1.KERNEL_SETTINGS_MESSAGES.modulesDescription,
+                keys: modules.map(({ name }) => name),
+                keyLabels: Object.fromEntries(modules.flatMap(({ name, label }) => (label === undefined ? [] : [[name, label]]))),
+                default: Object.fromEntries(modules.map(({ name, defaultEnabled }) => [name, defaultEnabled ?? true])),
+            }),
+            locale: builders_1.field.enum({
+                label: messages_1.KERNEL_SETTINGS_MESSAGES.locale,
+                description: messages_1.KERNEL_SETTINGS_MESSAGES.localeDescription,
+                choices: locale_1.SUPPORTED_LOCALES.map((locale) => ({
+                    value: locale,
+                    label: LOCALE_LABELS[locale],
+                })),
+            }),
+        },
+    });
+}
+//# sourceMappingURL=kernel-settings.js.map

package/dist/settings/system/kernel-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel-settings.js","sourceRoot":"","sources":["../../../src/settings/system/kernel-settings.ts"],"names":[],"mappings":";;;AAwCA,wCA8BC;AAtED,0CAA+D;AAC/D,gEAA4D;AAC5D,yDAAmD;AACnD,kDAA+D;AAE/D,mDAAmD;AACtC,QAAA,kBAAkB,GAAG,QAAQ,CAAC;AAkB3C,MAAM,aAAa,GAAqC;IACvD,EAAE,EAAE,mCAAwB,CAAC,QAAQ;IACrC,EAAE,EAAE,mCAAwB,CAAC,QAAQ;CACrC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,SAAgB,cAAc,CAAC,OAAoC;IAClE,OAAO,IAAA,gCAAc,EAAC;QACrB,EAAE,EAAE,0BAAkB;QACtB,OAAO,EAAE,CAAC;QACV,MAAM,EAAE;YACP,KAAK,EAAE,mCAAwB,CAAC,KAAK;YACrC,WAAW,EAAE,mCAAwB,CAAC,WAAW;SACjD;QACD,MAAM,EAAE;YACP,OAAO,EAAE,gBAAK,CAAC,OAAO,CAAS;gBAC9B,KAAK,EAAE,mCAAwB,CAAC,OAAO;gBACvC,WAAW,EAAE,mCAAwB,CAAC,kBAAkB;gBACxD,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC;gBACrC,SAAS,EAAE,MAAM,CAAC,WAAW,CAC5B,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAClF;gBACD,OAAO,EAAE,MAAM,CAAC,WAAW,CAC1B,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,cAAc,IAAI,IAAI,CAAC,CAAC,CACzE;aACD,CAAC;YACF,MAAM,EAAE,gBAAK,CAAC,IAAI,CAAC;gBAClB,KAAK,EAAE,mCAAwB,CAAC,MAAM;gBACtC,WAAW,EAAE,mCAAwB,CAAC,iBAAiB;gBACvD,OAAO,EAAE,0BAAiB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;oBAC3C,KAAK,EAAE,MAAM;oBACb,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC;iBAC5B,CAAC,CAAC;aACH,CAAC;SACF;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/settings/system/module-gate.d.ts

@@ -0,0 +1,31 @@
+import type { Logger } from "../../logger";
+import type { SettingsRegistry } from "../../settings/registry";
+import type { SettingsService } from "../../settings/settings-service";
+/**
+ * Whether a module runs on a guild. The command, component and event routers
+ * check it before running a module's handler there; scheduled jobs call it
+ * themselves (FR-036).
+ */
+export interface ModuleGate {
+    isEnabled(moduleName: string, guildId: string): Promise<boolean>;
+}
+/**
+ * Create the gate over the guild's kernel settings (`registry.kernel`), read
+ * through the service's cache, so checking it on every interaction does not
+ * hit the store.
+ *
+ * A module the kernel declaration does not know is never gated. When the
+ * settings cannot be read, the module runs and the error is logged: a store
+ * outage must not switch every module off.
+ *
+ * @param deps.service - reads the guild's kernel settings.
+ * @param deps.registry - holds the kernel declaration built from the modules.
+ * @param deps.logger - where a failed read is reported.
+ * @returns the gate shared by the routers and the scheduled jobs.
+ */
+export declare function createModuleGate(deps: {
+    service: SettingsService;
+    registry: SettingsRegistry;
+    logger: Logger;
+}): ModuleGate;
+//# sourceMappingURL=module-gate.d.ts.map

package/dist/settings/system/module-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-gate.d.ts","sourceRoot":"","sources":["../../../src/settings/system/module-gate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE;;;;GAIG;AACH,MAAM,WAAW,UAAU;IAC1B,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACtC,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CACf,GAAG,UAAU,CAgBb"}

package/dist/settings/system/module-gate.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createModuleGate = createModuleGate;
+const error_message_1 = require("../../errors/error-message");
+/**
+ * Create the gate over the guild's kernel settings (`registry.kernel`), read
+ * through the service's cache, so checking it on every interaction does not
+ * hit the store.
+ *
+ * A module the kernel declaration does not know is never gated. When the
+ * settings cannot be read, the module runs and the error is logged: a store
+ * outage must not switch every module off.
+ *
+ * @param deps.service - reads the guild's kernel settings.
+ * @param deps.registry - holds the kernel declaration built from the modules.
+ * @param deps.logger - where a failed read is reported.
+ * @returns the gate shared by the routers and the scheduled jobs.
+ */
+function createModuleGate(deps) {
+    const { service, registry, logger } = deps;
+    return {
+        async isEnabled(moduleName, guildId) {
+            try {
+                const { modules } = await service.get(registry.kernel, guildId);
+                return modules[moduleName] ?? true;
+            }
+            catch (error) {
+                logger.error({ module: moduleName, guildId, err: (0, error_message_1.errorMessage)(error) }, "Could not read whether the module is enabled; letting it run");
+                return true;
+            }
+        },
+    };
+}
+//# sourceMappingURL=module-gate.js.map

package/dist/settings/system/module-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-gate.js","sourceRoot":"","sources":["../../../src/settings/system/module-gate.ts"],"names":[],"mappings":";;AA4BA,4CAoBC;AAhDD,0DAAsD;AActD;;;;;;;;;;;;;GAaG;AACH,SAAgB,gBAAgB,CAAC,IAIhC;IACA,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC3C,OAAO;QACN,KAAK,CAAC,SAAS,CAAC,UAAkB,EAAE,OAAe;YAClD,IAAI,CAAC;gBACJ,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAChE,OAAO,OAAO,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;YACpC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,CAAC,KAAK,CACX,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,IAAA,4BAAY,EAAC,KAAK,CAAC,EAAE,EACzD,8DAA8D,CAC9D,CAAC;gBACF,OAAO,IAAI,CAAC;YACb,CAAC;QACF,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/settings/testing/index.d.ts

@@ -0,0 +1,2 @@
+export { type ContractAssertion, type DescribeFn, type ExpectFn, type ItFn, runSettingsStoreContract, } from "../../settings/testing/settings-store-contract";
+//# sourceMappingURL=index.d.ts.map

package/dist/settings/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/settings/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,IAAI,EACT,wBAAwB,GACxB,MAAM,4CAA4C,CAAC"}

package/dist/settings/testing/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSettingsStoreContract = void 0;
+var settings_store_contract_1 = require("../../settings/testing/settings-store-contract");
+Object.defineProperty(exports, "runSettingsStoreContract", { enumerable: true, get: function () { return settings_store_contract_1.runSettingsStoreContract; } });
+//# sourceMappingURL=index.js.map

package/dist/settings/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/settings/testing/index.ts"],"names":[],"mappings":";;;AAAA,sFAMoD;AADnD,mIAAA,wBAAwB,OAAA"}

package/dist/settings/testing/settings-store-contract.d.ts

@@ -0,0 +1,29 @@
+import type { SettingsStore } from "../../settings/ports/settings-store";
+/** Minimal shape of a test runner's `describe`, so this suite imports no framework. */
+export type DescribeFn = (name: string, body: () => void) => void;
+/** Minimal shape of a test runner's `it`. */
+export type ItFn = (name: string, body: () => Promise<void>) => void;
+/** The assertions this suite relies on; Vitest's and Jest's `expect` both satisfy it. */
+export interface ContractAssertion {
+    toBe(expected: unknown): void;
+    toEqual(expected: unknown): void;
+    toBeNull(): void;
+    toBeInstanceOf(expected: abstract new (...args: never[]) => unknown): void;
+}
+/** Minimal shape of a test runner's `expect`. */
+export type ExpectFn = (actual: unknown) => ContractAssertion;
+/**
+ * Behaviour every {@link SettingsStore} implementation must have: one case per
+ * guarantee stated on the port. Run it from the adapter's own test file with
+ * the test runner's `describe`, `it` and `expect`:
+ * `runSettingsStoreContract(createMyStore, { describe, it, expect })`.
+ *
+ * @param createStore - returns a store with no record in it; called once per case.
+ * @param runner - the test runner's functions, so this suite imports no framework.
+ */
+export declare function runSettingsStoreContract(createStore: () => SettingsStore | Promise<SettingsStore>, runner: {
+    describe: DescribeFn;
+    it: ItFn;
+    expect: ExpectFn;
+}): void;
+//# sourceMappingURL=settings-store-contract.d.ts.map

package/dist/settings/testing/settings-store-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-store-contract.d.ts","sourceRoot":"","sources":["../../../src/settings/testing/settings-store-contract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,iCAAiC,CAAC;AAErF,uFAAuF;AACvF,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;AAElE,6CAA6C;AAC7C,MAAM,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;AAErE,yFAAyF;AACzF,MAAM,WAAW,iBAAiB;IACjC,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,QAAQ,IAAI,IAAI,CAAC;IACjB,cAAc,CAAC,QAAQ,EAAE,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,GAAG,IAAI,CAAC;CAC3E;AAED,iDAAiD;AACjD,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,iBAAiB,CAAC;AAkC9D;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACvC,WAAW,EAAE,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,EACzD,MAAM,EAAE;IAAE,QAAQ,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,GAC1D,IAAI,CAqNN"}