@azurioh/discord-kernel 0.1.0 → 1.0.0

package/dist/settings/messages.d.ts

@@ -0,0 +1,61 @@
+import type { KeyedCatalog, MessageKey } from "../i18n/catalog";
+/**
+ * Catalog key of each validation issue. Typed over every {@link SettingsIssueCode}
+ * so adding a code without its wording fails to compile.
+ *
+ * Placeholders: `min` / `minLength` / `minItems` take `{min}`, `max` /
+ * `maxLength` / `maxItems` take `{max}`; the others take none.
+ */
+export declare const SETTINGS_ISSUE_MESSAGES: {
+    readonly required: "core.settings.issue.required";
+    readonly type: "core.settings.issue.type";
+    readonly min: "core.settings.issue.min";
+    readonly max: "core.settings.issue.max";
+    readonly minLength: "core.settings.issue.min-length";
+    readonly maxLength: "core.settings.issue.max-length";
+    readonly minItems: "core.settings.issue.min-items";
+    readonly maxItems: "core.settings.issue.max-items";
+    readonly duplicate: "core.settings.issue.duplicate";
+    readonly channelType: "core.settings.issue.channel-type";
+    readonly notFound: "core.settings.issue.not-found";
+    readonly unknownChoice: "core.settings.issue.unknown-choice";
+    readonly unknownField: "core.settings.issue.unknown-field";
+};
+/** Catalog keys for the settings feature's own wording outside validation. */
+export declare const SETTINGS_MESSAGES: {
+    /** Shown instead of a secret's value, which no surface ever reads back. */
+    readonly secretSet: "core.settings.secret.set";
+    readonly secretNotSet: "core.settings.secret.not-set";
+    /** Shown for a stored channel, role or member the guild no longer has. */
+    readonly valueUnavailable: "core.settings.value.unavailable";
+    /** Shown for a setting that holds no value. */
+    readonly valueNotSet: "core.settings.value.not-set";
+    /** Shown for a toggles setting with none of its toggles on. */
+    readonly valueNone: "core.settings.value.none";
+    /** The two options a yes/no setting is picked from. */
+    readonly booleanTrue: "core.settings.boolean.true";
+    readonly booleanFalse: "core.settings.boolean.false";
+    /** Reply when a module disabled on the guild is used there. */
+    readonly moduleDisabled: "core.settings.module.disabled";
+    /** Reply when a module still lacks a required setting. */
+    readonly moduleNotConfigured: "core.settings.module.not-configured";
+    /** The missing settings, listed only to members who can fix them. */
+    readonly moduleNotConfiguredMissing: "core.settings.module.not-configured-missing";
+};
+/** Catalog keys of the kernel's own settings declaration (`kernelSettings`). */
+export declare const KERNEL_SETTINGS_MESSAGES: {
+    readonly title: "core.settings.kernel.title";
+    readonly description: "core.settings.kernel.description";
+    readonly modules: "core.settings.kernel.modules";
+    readonly modulesDescription: "core.settings.kernel.modules-description";
+    readonly locale: "core.settings.kernel.locale";
+    readonly localeDescription: "core.settings.kernel.locale-description";
+    readonly localeEn: "core.settings.kernel.locale-en";
+    readonly localeFr: "core.settings.kernel.locale-fr";
+};
+/**
+ * The settings feature's strings, registered by the composition root alongside
+ * the core catalog.
+ */
+export declare const SETTINGS_CATALOG: KeyedCatalog<MessageKey<typeof SETTINGS_ISSUE_MESSAGES> | MessageKey<typeof SETTINGS_MESSAGES> | MessageKey<typeof KERNEL_SETTINGS_MESSAGES>>;
+//# sourceMappingURL=messages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/settings/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG/D;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;CAc4B,CAAC;AAEjE,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB;IAC7B,2EAA2E;;;IAG3E,0EAA0E;;IAE1E,+CAA+C;;IAE/C,+DAA+D;;IAE/D,uDAAuD;;;IAGvD,+DAA+D;;IAE/D,0DAA0D;;IAE1D,qEAAqE;;CAE5D,CAAC;AAEX,gFAAgF;AAChF,eAAO,MAAM,wBAAwB;;;;;;;;;CAS3B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,YAAY,CACxC,UAAU,CAAC,OAAO,uBAAuB,CAAC,GAC1C,UAAU,CAAC,OAAO,iBAAiB,CAAC,GACpC,UAAU,CAAC,OAAO,wBAAwB,CAAC,CA6F7C,CAAC"}

package/dist/settings/messages.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SETTINGS_CATALOG = exports.KERNEL_SETTINGS_MESSAGES = exports.SETTINGS_MESSAGES = exports.SETTINGS_ISSUE_MESSAGES = void 0;
+/**
+ * Catalog key of each validation issue. Typed over every {@link SettingsIssueCode}
+ * so adding a code without its wording fails to compile.
+ *
+ * Placeholders: `min` / `minLength` / `minItems` take `{min}`, `max` /
+ * `maxLength` / `maxItems` take `{max}`; the others take none.
+ */
+exports.SETTINGS_ISSUE_MESSAGES = {
+    required: "core.settings.issue.required",
+    type: "core.settings.issue.type",
+    min: "core.settings.issue.min",
+    max: "core.settings.issue.max",
+    minLength: "core.settings.issue.min-length",
+    maxLength: "core.settings.issue.max-length",
+    minItems: "core.settings.issue.min-items",
+    maxItems: "core.settings.issue.max-items",
+    duplicate: "core.settings.issue.duplicate",
+    channelType: "core.settings.issue.channel-type",
+    notFound: "core.settings.issue.not-found",
+    unknownChoice: "core.settings.issue.unknown-choice",
+    unknownField: "core.settings.issue.unknown-field",
+};
+/** Catalog keys for the settings feature's own wording outside validation. */
+exports.SETTINGS_MESSAGES = {
+    /** Shown instead of a secret's value, which no surface ever reads back. */
+    secretSet: "core.settings.secret.set",
+    secretNotSet: "core.settings.secret.not-set",
+    /** Shown for a stored channel, role or member the guild no longer has. */
+    valueUnavailable: "core.settings.value.unavailable",
+    /** Shown for a setting that holds no value. */
+    valueNotSet: "core.settings.value.not-set",
+    /** Shown for a toggles setting with none of its toggles on. */
+    valueNone: "core.settings.value.none",
+    /** The two options a yes/no setting is picked from. */
+    booleanTrue: "core.settings.boolean.true",
+    booleanFalse: "core.settings.boolean.false",
+    /** Reply when a module disabled on the guild is used there. */
+    moduleDisabled: "core.settings.module.disabled",
+    /** Reply when a module still lacks a required setting. */
+    moduleNotConfigured: "core.settings.module.not-configured",
+    /** The missing settings, listed only to members who can fix them. */
+    moduleNotConfiguredMissing: "core.settings.module.not-configured-missing",
+};
+/** Catalog keys of the kernel's own settings declaration (`kernelSettings`). */
+exports.KERNEL_SETTINGS_MESSAGES = {
+    title: "core.settings.kernel.title",
+    description: "core.settings.kernel.description",
+    modules: "core.settings.kernel.modules",
+    modulesDescription: "core.settings.kernel.modules-description",
+    locale: "core.settings.kernel.locale",
+    localeDescription: "core.settings.kernel.locale-description",
+    localeEn: "core.settings.kernel.locale-en",
+    localeFr: "core.settings.kernel.locale-fr",
+};
+/**
+ * The settings feature's strings, registered by the composition root alongside
+ * the core catalog.
+ */
+exports.SETTINGS_CATALOG = {
+    [exports.SETTINGS_ISSUE_MESSAGES.required]: {
+        en: "This setting is required.",
+        fr: "Ce paramètre est obligatoire.",
+    },
+    [exports.SETTINGS_ISSUE_MESSAGES.type]: {
+        en: "This value is not of the expected kind.",
+        fr: "Cette valeur n'est pas du type attendu.",
+    },
+    [exports.SETTINGS_ISSUE_MESSAGES.min]: {
+        en: "Must be at least {min}.",
+        fr: "Doit être au moins {min}.",
+    },
+    [exports.SETTINGS_ISSUE_MESSAGES.max]: {
+        en: "Must be at most {max}.",
+        fr: "Doit être au plus {max}.",
+    },
+    [exports.SETTINGS_ISSUE_MESSAGES.minLength]: {
+        en: "Must be at least {min} characters long.",
+        fr: "Doit contenir au moins {min} caractères.",
+    },
+    [exports.SETTINGS_ISSUE_MESSAGES.maxLength]: {
+        en: "Must be at most {max} characters long.",
+        fr: "Doit contenir au plus {max} caractères.",
+    },
+    [exports.SETTINGS_ISSUE_MESSAGES.minItems]: {
+        en: "Pick at least {min} items.",
+        fr: "Choisissez au moins {min} éléments.",
+    },
+    [exports.SETTINGS_ISSUE_MESSAGES.maxItems]: {
+        en: "Pick at most {max} items.",
+        fr: "Choisissez au plus {max} éléments.",
+    },
+    [exports.SETTINGS_ISSUE_MESSAGES.duplicate]: {
+        en: "The same value is listed more than once.",
+        fr: "La même valeur apparaît plusieurs fois.",
+    },
+    [exports.SETTINGS_ISSUE_MESSAGES.channelType]: {
+        en: "This type of channel is not allowed here.",
+        fr: "Ce type de salon n'est pas autorisé ici.",
+    },
+    [exports.SETTINGS_ISSUE_MESSAGES.notFound]: {
+        en: "This no longer exists on this server.",
+        fr: "Cet élément n'existe plus sur ce serveur.",
+    },
+    [exports.SETTINGS_ISSUE_MESSAGES.unknownChoice]: {
+        en: "This value is not one of the allowed choices.",
+        fr: "Cette valeur ne fait pas partie des choix autorisés.",
+    },
+    [exports.SETTINGS_ISSUE_MESSAGES.unknownField]: {
+        en: "This setting does not exist.",
+        fr: "Ce paramètre n'existe pas.",
+    },
+    [exports.SETTINGS_MESSAGES.secretSet]: { en: "Set", fr: "Défini" },
+    [exports.SETTINGS_MESSAGES.secretNotSet]: { en: "Not set", fr: "Non défini" },
+    [exports.SETTINGS_MESSAGES.valueUnavailable]: {
+        en: "A saved value is unavailable: it no longer exists on this server.",
+        fr: "Une valeur enregistrée est indisponible : elle n'existe plus sur ce serveur.",
+    },
+    [exports.SETTINGS_MESSAGES.valueNotSet]: { en: "Not set", fr: "Non défini" },
+    [exports.SETTINGS_MESSAGES.valueNone]: { en: "None", fr: "Aucun" },
+    [exports.SETTINGS_MESSAGES.booleanTrue]: { en: "Yes", fr: "Oui" },
+    [exports.SETTINGS_MESSAGES.booleanFalse]: { en: "No", fr: "Non" },
+    [exports.SETTINGS_MESSAGES.moduleDisabled]: {
+        en: "This feature is disabled on this server.",
+        fr: "Cette fonctionnalité est désactivée sur ce serveur.",
+    },
+    [exports.SETTINGS_MESSAGES.moduleNotConfigured]: {
+        en: "This feature is not configured on this server yet: an administrator must set it up first.",
+        fr: "Cette fonctionnalité n'est pas encore configurée sur ce serveur : un administrateur doit d'abord la configurer.",
+    },
+    [exports.SETTINGS_MESSAGES.moduleNotConfiguredMissing]: {
+        en: "Missing settings: {fields}.",
+        fr: "Paramètres manquants : {fields}.",
+    },
+    [exports.KERNEL_SETTINGS_MESSAGES.title]: { en: "Server", fr: "Serveur" },
+    [exports.KERNEL_SETTINGS_MESSAGES.description]: {
+        en: "Features enabled on this server and the bot's language.",
+        fr: "Fonctionnalités activées sur ce serveur et langue du bot.",
+    },
+    [exports.KERNEL_SETTINGS_MESSAGES.modules]: { en: "Features", fr: "Fonctionnalités" },
+    [exports.KERNEL_SETTINGS_MESSAGES.modulesDescription]: {
+        en: "Turn a feature off to stop its commands, buttons and events on this server.",
+        fr: "Désactivez une fonctionnalité pour arrêter ses commandes, boutons et événements sur ce serveur.",
+    },
+    [exports.KERNEL_SETTINGS_MESSAGES.locale]: { en: "Language", fr: "Langue" },
+    [exports.KERNEL_SETTINGS_MESSAGES.localeDescription]: {
+        en: "The bot's language on this server, when a member's own language is not supported.",
+        fr: "La langue du bot sur ce serveur, lorsque la langue d'un membre n'est pas prise en charge.",
+    },
+    [exports.KERNEL_SETTINGS_MESSAGES.localeEn]: { en: "English", fr: "Anglais" },
+    [exports.KERNEL_SETTINGS_MESSAGES.localeFr]: { en: "French", fr: "Français" },
+};
+//# sourceMappingURL=messages.js.map

package/dist/settings/messages.js.map

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

package/dist/settings/migrate.d.ts

@@ -0,0 +1,35 @@
+import type { SettingsDeclaration } from "../settings/define-settings";
+import type { StoredSettings } from "../settings/ports/settings-store";
+/**
+ * Outcome of {@link migrateStored}. Either way, `values` are the valid declared
+ * fields a guild reads; only an `ok` outcome may be written back (FR-018).
+ */
+export type MigrationOutcome = {
+    readonly ok: true;
+    readonly values: Readonly<Record<string, unknown>>;
+} | {
+    readonly ok: false;
+    readonly values: Readonly<Record<string, unknown>>;
+    /** The declared fields whose migrated value fails validation. */
+    readonly invalidKeys: readonly string[];
+    /** What the migration threw, or why its result was refused. */
+    readonly error?: unknown;
+};
+/**
+ * Reshape values stored under an older declaration version with the
+ * declaration's `migrate`, then validate the result through the same checks
+ * as any stored value. Pure: it reads and writes nothing, and hands `migrate` a
+ * copy, so the stored record is never touched.
+ *
+ * - `migrate` throws, is missing, or returns anything but a plain object: not
+ *   `ok`, and `values` are the stored values that still validate as they are.
+ * - Some migrated field fails validation: not `ok`, and `values` are the
+ *   migrated fields that validate.
+ * - Otherwise `ok`, with every migrated declared field; undeclared keys the
+ *   migration returns are dropped.
+ *
+ * @param declaration - the module's current declaration.
+ * @param stored - a record whose `version` is below `declaration.version`.
+ */
+export declare function migrateStored(declaration: SettingsDeclaration, stored: Pick<StoredSettings, "version" | "values">): MigrationOutcome;
+//# sourceMappingURL=migrate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/settings/migrate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GACzB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAAE,GACzE;IACA,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,iEAAiE;IACjE,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEL;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAC5B,WAAW,EAAE,mBAAmB,EAChC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,QAAQ,CAAC,GAChD,gBAAgB,CAkBlB"}

package/dist/settings/migrate.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.migrateStored = migrateStored;
+const decode_stored_1 = require("../settings/decode-stored");
+const is_plain_object_1 = require("../settings/is-plain-object");
+/**
+ * Reshape values stored under an older declaration version with the
+ * declaration's `migrate`, then validate the result through the same checks
+ * as any stored value. Pure: it reads and writes nothing, and hands `migrate` a
+ * copy, so the stored record is never touched.
+ *
+ * - `migrate` throws, is missing, or returns anything but a plain object: not
+ *   `ok`, and `values` are the stored values that still validate as they are.
+ * - Some migrated field fails validation: not `ok`, and `values` are the
+ *   migrated fields that validate.
+ * - Otherwise `ok`, with every migrated declared field; undeclared keys the
+ *   migration returns are dropped.
+ *
+ * @param declaration - the module's current declaration.
+ * @param stored - a record whose `version` is below `declaration.version`.
+ */
+function migrateStored(declaration, stored) {
+    let migrated;
+    try {
+        if (declaration.migrate === undefined) {
+            throw new Error(`module "${declaration.id}" declares no migration`);
+        }
+        migrated = declaration.migrate(stored.version, structuredClone(stored.values));
+    }
+    catch (error) {
+        return { ok: false, error, ...(0, decode_stored_1.decodeStored)(declaration, stored.values) };
+    }
+    if (!(0, is_plain_object_1.isPlainObject)(migrated)) {
+        const error = new Error(`the migration of module "${declaration.id}" returned no plain object`);
+        return { ok: false, error, ...(0, decode_stored_1.decodeStored)(declaration, stored.values) };
+    }
+    const decoded = (0, decode_stored_1.decodeStored)(declaration, migrated);
+    return decoded.invalidKeys.length === 0
+        ? { ok: true, values: decoded.values }
+        : { ok: false, ...decoded };
+}
+//# sourceMappingURL=migrate.js.map

package/dist/settings/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../src/settings/migrate.ts"],"names":[],"mappings":";;AAoCA,sCAqBC;AAzDD,4DAAwD;AAExD,gEAA2D;AAkB3D;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,aAAa,CAC5B,WAAgC,EAChC,MAAkD;IAElD,IAAI,QAAiB,CAAC;IACtB,IAAI,CAAC;QACJ,IAAI,WAAW,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,WAAW,WAAW,CAAC,EAAE,yBAAyB,CAAC,CAAC;QACrE,CAAC;QACD,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAChF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,IAAA,4BAAY,EAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;IAC1E,CAAC;IACD,IAAI,CAAC,IAAA,+BAAa,EAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,4BAA4B,WAAW,CAAC,EAAE,4BAA4B,CAAC,CAAC;QAChG,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,IAAA,4BAAY,EAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;IAC1E,CAAC;IACD,MAAM,OAAO,GAAG,IAAA,4BAAY,EAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACpD,OAAO,OAAO,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;QACtC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;QACtC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC;AAC9B,CAAC"}

package/dist/settings/ports/guild-directory.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Vendor-free channel category a channel field can be restricted to. Each
+ * member maps one to one to a guild channel type of Discord's `ChannelType`.
+ */
+export type ChannelKind = 
+/** `ChannelType.GuildText` */
+"text"
+/** `ChannelType.GuildVoice` */
+ | "voice"
+/** `ChannelType.GuildCategory` */
+ | "category"
+/** `ChannelType.GuildAnnouncement` */
+ | "announcement"
+/** `ChannelType.AnnouncementThread` */
+ | "announcementThread"
+/** `ChannelType.PublicThread` */
+ | "publicThread"
+/** `ChannelType.PrivateThread` */
+ | "privateThread"
+/** `ChannelType.GuildStageVoice` */
+ | "stage"
+/** `ChannelType.GuildDirectory` */
+ | "directory"
+/** `ChannelType.GuildForum` */
+ | "forum"
+/** `ChannelType.GuildMedia` */
+ | "media";
+/**
+ * Read-only view of a guild's channels, roles and members. Settings logic uses
+ * it to check that a referenced entity exists and to suggest candidates,
+ * without depending on discord.js.
+ */
+export interface GuildDirectory {
+    channel(guildId: string, id: string): Promise<{
+        id: string;
+        name: string;
+        kind: ChannelKind;
+    } | null>;
+    role(guildId: string, id: string): Promise<{
+        id: string;
+        name: string;
+    } | null>;
+    member(guildId: string, id: string): Promise<{
+        id: string;
+        name: string;
+    } | null>;
+    searchChannels(guildId: string, query: string, kinds?: readonly ChannelKind[]): Promise<readonly {
+        id: string;
+        name: string;
+        kind: ChannelKind;
+    }[]>;
+    searchRoles(guildId: string, query: string): Promise<readonly {
+        id: string;
+        name: string;
+    }[]>;
+    searchMembers(guildId: string, query: string): Promise<readonly {
+        id: string;
+        name: string;
+    }[]>;
+}
+//# sourceMappingURL=guild-directory.d.ts.map

package/dist/settings/ports/guild-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guild-directory.d.ts","sourceRoot":"","sources":["../../../src/settings/ports/guild-directory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,WAAW;AACtB,8BAA8B;AAC5B,MAAM;AACR,+BAA+B;GAC7B,OAAO;AACT,kCAAkC;GAChC,UAAU;AACZ,sCAAsC;GACpC,cAAc;AAChB,uCAAuC;GACrC,oBAAoB;AACtB,iCAAiC;GAC/B,cAAc;AAChB,kCAAkC;GAChC,eAAe;AACjB,oCAAoC;GAClC,OAAO;AACT,mCAAmC;GACjC,WAAW;AACb,+BAA+B;GAC7B,OAAO;AACT,+BAA+B;GAC7B,OAAO,CAAC;AAEX;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B,OAAO,CACN,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,GACR,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,WAAW,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACnE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAChF,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAClF,cAAc,CACb,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,SAAS,WAAW,EAAE,GAC5B,OAAO,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,WAAW,CAAA;KAAE,EAAE,CAAC,CAAC;IACvE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC;IAC9F,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC;CAChG"}

package/dist/settings/ports/guild-directory.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=guild-directory.js.map

package/dist/settings/ports/guild-directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guild-directory.js","sourceRoot":"","sources":["../../../src/settings/ports/guild-directory.ts"],"names":[],"mappings":""}

package/dist/settings/ports/settings-changed-notifier.d.ts

@@ -0,0 +1,20 @@
+/** Emitted after a module's settings changed for a guild. */
+export interface SettingsChangedEvent {
+    readonly guildId: string;
+    readonly moduleId: string;
+    readonly changedKeys: readonly string[];
+    /** Revision of the record after the change. */
+    readonly revision: number;
+    /** Snowflake of the user who made the change. */
+    readonly changedBy?: string;
+}
+/**
+ * Broadcasts settings changes, e.g. so read caches can invalidate. The default
+ * implementation is in-process; distributed delivery is a separate adapter.
+ */
+export interface SettingsChangedNotifier {
+    notify(event: SettingsChangedEvent): void;
+    /** Register `listener`; the returned function unsubscribes it. */
+    subscribe(listener: (event: SettingsChangedEvent) => void): () => void;
+}
+//# sourceMappingURL=settings-changed-notifier.d.ts.map

package/dist/settings/ports/settings-changed-notifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-changed-notifier.d.ts","sourceRoot":"","sources":["../../../src/settings/ports/settings-changed-notifier.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACvC,MAAM,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC1C,kEAAkE;IAClE,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACvE"}

package/dist/settings/ports/settings-changed-notifier.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=settings-changed-notifier.js.map

package/dist/settings/ports/settings-changed-notifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-changed-notifier.js","sourceRoot":"","sources":["../../../src/settings/ports/settings-changed-notifier.ts"],"names":[],"mappings":""}

package/dist/settings/ports/settings-store.d.ts

@@ -0,0 +1,76 @@
+/**
+ * The record a {@link SettingsStore} persists, one per `(guildId, moduleId)`.
+ * Every field is JSON-serialisable, so an adapter may store the record as one
+ * document, one row with a JSON column, or one hash; it must give back an equal
+ * record (`updatedBy` absent stays absent).
+ */
+export interface StoredSettings {
+    readonly guildId: string;
+    /** Equals the declaration id of the module that owns these values. */
+    readonly moduleId: string;
+    /** Declaration version the values were written under. */
+    readonly version: number;
+    /**
+     * Starts at 1 on first write; +1 on each write. Used for optimistic
+     * concurrency. The caller computes it; the store persists it as given.
+     */
+    readonly revision: number;
+    /**
+     * Only declared, valid fields; unset fields are absent. Every value is plain
+     * JSON (string, finite number, boolean, `null`, arrays and objects of those),
+     * so `JSON.stringify` then `JSON.parse` gives back an equal object.
+     */
+    readonly values: Readonly<Record<string, unknown>>;
+    /** ISO-8601 timestamp from the `Clock` port. */
+    readonly updatedAt: string;
+    /** Snowflake of the user who made the change. */
+    readonly updatedBy?: string;
+}
+/**
+ * Persistence port for module settings: the kernel's only view of a database.
+ * An adapter over any engine (a JSON file, SQLite, Postgres, MongoDB, Redis)
+ * implements it in the bot or in an opt-in package, never in the kernel, and
+ * proves it with `runSettingsStoreContract` from
+ * `@azurioh/discord-kernel/settings/testing`.
+ *
+ * Guarantees every implementation must honour:
+ *
+ * - **Isolation.** A record is keyed by `(guildId, moduleId)`; reading, writing
+ *   or deleting one key never touches another.
+ * - **Atomic compare-and-set.** `write` checks the stored revision and replaces
+ *   the record in one atomic step of the engine, so that of several writers
+ *   holding the same `expectedRevision` (Discord shards, an HTTP API) exactly
+ *   one wins and the others get `ConflictError`.
+ * - **Independent copies.** The store never keeps a reference to the record it
+ *   was given nor hands out one it keeps: callers may mutate what they pass in
+ *   or get back without changing what is stored.
+ * - **Errors are real.** Only a revision mismatch is a `ConflictError`; any
+ *   other failure (connection lost, corrupt data) is thrown as it is.
+ */
+export interface SettingsStore {
+    /**
+     * The record of one module in one guild.
+     *
+     * @returns a copy of the stored record, or `null` when none was written yet
+     * (or it was deleted).
+     */
+    read(guildId: string, moduleId: string): Promise<StoredSettings | null>;
+    /**
+     * Persist `record` as a whole, replacing any stored one, if and only if the
+     * stored revision is `expectedRevision`.
+     *
+     * @param opts.expectedRevision - the revision the caller read; `null` means
+     * no record may exist yet (a create).
+     * @throws ConflictError when the stored revision (or `null` for no record)
+     * differs from `expectedRevision`. The stored record is then left unchanged.
+     */
+    write(record: StoredSettings, opts: {
+        expectedRevision: number | null;
+    }): Promise<void>;
+    /**
+     * Remove the record of one module in one guild, whatever its revision.
+     * Idempotent: deleting a missing record succeeds and does nothing.
+     */
+    delete(guildId: string, moduleId: string): Promise<void>;
+}
+//# sourceMappingURL=settings-store.d.ts.map

package/dist/settings/ports/settings-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-store.d.ts","sourceRoot":"","sources":["../../../src/settings/ports/settings-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,gDAAgD;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,aAAa;IAC7B;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACxE;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE;QAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxF;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD"}

package/dist/settings/ports/settings-store.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=settings-store.js.map

package/dist/settings/ports/settings-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-store.js","sourceRoot":"","sources":["../../../src/settings/ports/settings-store.ts"],"names":[],"mappings":""}

package/dist/settings/registry.d.ts

@@ -0,0 +1,31 @@
+import type { TranslationRegistry } from "../i18n/catalog";
+import type { SettingsDeclaration } from "../settings/define-settings";
+import { type KernelSettings, type ModuleEnablement } from "../settings/system/kernel-settings";
+/** Every settings declaration of the bot, checked at boot. */
+export interface SettingsRegistry {
+    /** The kernel's own declaration first, then the modules' in registration order. */
+    readonly declarations: readonly SettingsDeclaration[];
+    /** The kernel's own declaration (id `kernel`), built from the registered modules. */
+    readonly kernel: KernelSettings;
+    get(id: string): SettingsDeclaration | undefined;
+}
+/**
+ * Collect the modules' settings declarations at boot, after the kernel's own
+ * declaration ({@link kernelSettings}), which is always included.
+ *
+ * @param input.declarations - every module's declaration.
+ * @param input.translations - must already contain the modules' catalogs and
+ * `SETTINGS_CATALOG`, which holds the kernel declaration's texts.
+ * @param input.modules - the registered modules (a `BotModule` fits), whose
+ * names and `defaultEnabled` build the kernel's module toggles. None by default.
+ * @returns the registry of declarations, by id.
+ * @throws SettingsDeclarationError when two declarations share an id (FR-005)
+ * or a declaration references a catalog key without an English source (FR-028),
+ * or two modules share a name.
+ */
+export declare function createSettingsRegistry(input: {
+    declarations: readonly SettingsDeclaration[];
+    translations: TranslationRegistry;
+    modules?: readonly ModuleEnablement[];
+}): SettingsRegistry;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/settings/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAStE,OAAO,EACN,KAAK,cAAc,EAEnB,KAAK,gBAAgB,EACrB,MAAM,mCAAmC,CAAC;AAE3C,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAChC,mFAAmF;IACnF,QAAQ,CAAC,YAAY,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACtD,qFAAqF;IACrF,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAC;CACjD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC7C,YAAY,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC7C,YAAY,EAAE,mBAAmB,CAAC;IAClC,OAAO,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACtC,GAAG,gBAAgB,CAenB"}