@azurioh/discord-kernel 0.1.0 → 1.0.0

package/src/discord/components/settings-editor/settings-editor-card.view.ts

@@ -1,7 +1,10 @@
-import type { InteractiveView } from "@/discord/components/interactive-message";
+import { subtext, TimestampStyles, time } from "discord.js";
+import type { InteractiveView } from "@/discord/components/interactive-message/interactive-message-collector";
 import {
 	canReturn,
 	currentLevelKey,
+	indexLevels,
+	levelTrail,
 	ROOT_LEVEL_KEY,
 	type SettingsEditorLevel,
 } from "@/discord/components/settings-editor/navigation";
@@ -20,7 +23,9 @@ import { SETTINGS_EDITOR_MESSAGES } from "@/discord/i18n";
 import { type Button, createActionRow } from "@/discord/interaction/button";
 import { type CardBlock, type CardDef, createCard } from "@/discord/ui/card";
 import { EMBED_COLORS } from "@/discord/ui/colors";
-import type { Locale, Translator } from "@/i18n";
+import { truncateText } from "@/discord/ui/truncate-text";
+import type { Locale } from "@/i18n/locale";
+import type { Translator } from "@/i18n/translator";
 
 /**
  * Discord refuses a card carrying more than {@link import("@/discord/ui/card").MAX_CARD_COMPONENTS}
@@ -68,6 +73,23 @@ export const MAX_CARD_BUTTON_LEVEL_ENTRIES = 20;
  */
 const ENTRY_ACTIONS_RESERVE = 2;
 
+/**
+ * The most characters an entry's "Current: …" line may take. Well under the
+ * 4000 a card's text may hold in total: ten entries each showing a long value
+ * must still leave room for the preview and the chrome around them.
+ */
+const MAX_CURRENT_VALUE_LENGTH = 200;
+
+/** Separates a group's members on its one "Current: …" line. */
+const GROUP_MEMBER_SEPARATOR = " · ";
+
+/** A value's own line breaks, folded so it stays on the one line it is given. */
+const LINE_BREAKS = /\s*\r?\n\s*/g;
+
+function oneLine(value: string): string {
+	return value.replace(LINE_BREAKS, " ");
+}
+
 /**
  * The button a menu entry's own `Section` carries, derived from the field's
  * key rather than declared alongside it — the same relationship `ids.field`
@@ -102,30 +124,24 @@ export function createCardEditorView<S, A, F extends string>(
 	translator: Translator,
 	locale: Locale,
 	dressing: SettingsEditorDressing,
+	displayValue?: (subject: S, field: F) => string | null,
 ): InteractiveView<SettingsEditorState<S, A>> {
 	const screenTitle = translator.translate(locale, chrome.titleKey);
-	// Separates the levels in the breadcrumb trail.
-	const BREADCRUMB_SEPARATOR = " › ";
 
-	// The root is a level like any other, named after the screen itself, so
-	// rendering never special-cases "no depth declared" — the same bargain
-	// `createEditorView` strikes for the embeds layout. Its own `entryLayout`
-	// is the chrome's, mirroring `SettingsEditorLevel.entryLayout` for the one
-	// level that is never itself a `SettingsEditorLevel`.
-	const root: SettingsEditorLevel<F> = {
-		key: ROOT_LEVEL_KEY,
-		titleKey: chrome.titleKey,
-		fields,
-		entryLayout: chrome.entryLayout,
-	};
-	const allLevels: readonly SettingsEditorLevel<F>[] = [root, ...(levels ?? [])];
+	// The root's own `entryLayout` is the chrome's, mirroring
+	// `SettingsEditorLevel.entryLayout` for the one level that is never itself a
+	// `SettingsEditorLevel`.
+	const allLevels = indexLevels(
+		{ key: ROOT_LEVEL_KEY, titleKey: chrome.titleKey, fields, entryLayout: chrome.entryLayout },
+		levels,
+	);
 
 	// A level's fields are authored, not accumulated: passing more entries than a
 	// card can carry is a mistake in the declaration, and Discord would reject
 	// the whole message rather than show the first ones that fit. Failing here
 	// names the level; failing at render time would only say the message was
 	// invalid.
-	for (const level of allLevels) {
+	for (const level of allLevels.all) {
 		// A `"buttons"` level spends its budget on rows of `ActionRow`s rather
 		// than `Section`s, so it is checked against its own, higher cap instead
 		// of the `"sections"` one — failing here names the level rather than the
@@ -149,18 +165,10 @@ export function createCardEditorView<S, A, F extends string>(
 		}
 	}
 
-	function levelAt(key: string): SettingsEditorLevel<F> {
-		return allLevels.find((level) => level.key === key) ?? root;
-	}
-
-	/**
-	 * Where the reader is, as a trail rather than only the current name: a level
-	 * called "Roles" says nothing on its own about which type it belongs to.
-	 */
 	function heading(state: SettingsEditorState<S, A>): string {
-		return state.path
-			.map((key) => translator.translate(locale, levelAt(key).titleKey))
-			.join(BREADCRUMB_SEPARATOR);
+		return levelTrail(state.path, allLevels, (level) =>
+			translator.translate(locale, level.titleKey),
+		);
 	}
 
 	/**
@@ -170,19 +178,54 @@ export function createCardEditorView<S, A, F extends string>(
 	 * an embed's timestamp already did.
 	 */
 	function signature(): string {
-		const unixSeconds = Math.floor(dressing.clock.now().getTime() / 1000);
-		return `-# ${screenTitle} • <t:${unixSeconds}:t>`;
+		return subtext(`${screenTitle} • ${time(dressing.clock.now(), TimestampStyles.ShortTime)}`);
+	}
+
+	/**
+	 * What an entry currently holds, as the text after the "Current:" prefix:
+	 * the hook's own answer for a single field, one `label: value` per member
+	 * holding one for a group, nothing for a level. `null` when there is
+	 * nothing to show — no hook, or a hook answering `null` throughout.
+	 */
+	function currentText(field: SettingsEditorField<F>, subject: S): string | null {
+		if (displayValue === undefined || field.kind === "level") {
+			return null;
+		}
+		if (field.kind !== "group") {
+			return displayValue(subject, field.key);
+		}
+		const members = field.fields.flatMap((member) => {
+			const value = displayValue(subject, member.key);
+			return value === null ? [] : [`${translator.translate(locale, member.labelKey)}: ${value}`];
+		});
+		return members.length === 0 ? null : members.join(GROUP_MEMBER_SEPARATOR);
+	}
+
+	/** {@link currentText}, prefixed and cut to {@link MAX_CURRENT_VALUE_LENGTH}; none when it is `null`. */
+	function currentLines(field: SettingsEditorField<F>, subject: S): string[] {
+		const value = currentText(field, subject);
+		if (value === null) {
+			return [];
+		}
+		const line = translator.translate(locale, SETTINGS_EDITOR_MESSAGES.currentValue, {
+			value: oneLine(value),
+		});
+		return [truncateText(line, MAX_CURRENT_VALUE_LENGTH)];
 	}
 
 	/**
 	 * One menu entry, as the `Section` that replaces it: its label as the title,
-	 * its hint as the line under it, and the button `mountSettingsEditor`
+	 * its hint as the line under it, what it currently holds under that when the
+	 * screen declares `displayValue`, and the button `mountSettingsEditor`
 	 * registered for it as the accessory — the very button that opens its modal
 	 * or descends into it, reached by a click instead of a pick.
 	 */
-	function entrySection(field: SettingsEditorField<F>): CardBlock<SettingsEditorState<S, A>> {
+	function entrySection(
+		field: SettingsEditorField<F>,
+		subject: S,
+	): CardBlock<SettingsEditorState<S, A>> {
 		const title = translator.translate(locale, field.labelKey);
-		const lines = [translator.translate(locale, field.hintKey)];
+		const lines = [translator.translate(locale, field.hintKey), ...currentLines(field, subject)];
 		const action = fieldButtons.get(field.key);
 		return action === undefined
 			? { kind: "entry", title, lines }
@@ -287,7 +330,7 @@ export function createCardEditorView<S, A, F extends string>(
 		state: SettingsEditorState<S, A>,
 	): readonly (CardBlock<SettingsEditorState<S, A>> | null)[] {
 		const confirmingReset = state.confirming === SETTINGS_EDITOR_RESET_CONFIRMING;
-		const level = levelAt(currentLevelKey(state.path));
+		const level = allLevels.at(currentLevelKey(state.path));
 
 		const notice: CardBlock<SettingsEditorState<S, A>> | null = confirmingReset
 			? {
@@ -302,10 +345,10 @@ export function createCardEditorView<S, A, F extends string>(
 		const entries: CardBlock<SettingsEditorState<S, A>>[] =
 			level.entryLayout === "buttons"
 				? buttonRows(levelButtons(level, state))
-				: level.fields.map((field) => entrySection(field));
+				: level.fields.map((field) => entrySection(field, state.subject));
 
 		return [
-			{ kind: "text", content: `-# ${heading(state)}` },
+			{ kind: "text", content: subtext(heading(state)) },
 			notice,
 			...(chrome.extraBlocks?.(state, confirmingReset) ?? []),
 			{ kind: "separator" },

package/src/discord/components/settings-editor/settings-editor-field-modal.ts

@@ -17,12 +17,15 @@ import {
 	type ChannelFieldDef,
 	createModal,
 	type ModalFields,
+	type ModalValues,
 	type RoleFieldDef,
 	type SelectFieldDef,
 	type TextFieldDef,
 	type UserFieldDef,
 } from "@/discord/interaction/modal";
-import type { Locale, Translator } from "@/i18n";
+import type { SelectBounds } from "@/discord/interaction/select-bounds";
+import type { Locale } from "@/i18n/locale";
+import type { Translator } from "@/i18n/translator";
 
 const EDITOR_FIELD_MODAL_ID = "settings-editor:field-value";
 const EDITOR_GROUP_MODAL_ID = "settings-editor:group-value";
@@ -125,8 +128,23 @@ export async function promptEditorFieldValue<F extends string>(
 			? createImageModal(field, current, translator, locale)
 			: createTextModal(field, current, translator, locale);
 
+	const submitted = await collectModalSubmission(
+		interaction,
+		modal.build(nextModalOpenState(field.key)),
+	);
+	return submitted === null ? null : { interaction: submitted, ...modal.read(submitted) };
+}
+
+/**
+ * Show `built` and wait for this very opening's submission. `null` on timeout,
+ * on any failure to show or collect it, and on a submission that did not come
+ * from a message.
+ */
+async function collectModalSubmission(
+	interaction: MessageComponentInteraction,
+	built: ModalBuilder,
+): Promise<ModalMessageModalSubmitInteraction | null> {
 	try {
-		const built = modal.build(nextModalOpenState(field.key));
 		const expectedCustomId = customIdOf(built);
 		await interaction.showModal(built);
 		const submitted = await interaction.awaitModalSubmit({
@@ -141,7 +159,7 @@ export async function promptEditorFieldValue<F extends string>(
 		if (!submitted.isFromMessage()) {
 			return null;
 		}
-		return { interaction: submitted, ...modal.read(submitted) };
+		return submitted;
 	} catch {
 		return null;
 	}
@@ -192,22 +210,11 @@ export async function promptEditorGroupValue<F extends string>(
 	locale: Locale,
 ): Promise<SettingsEditorGroupPrompt<F> | null> {
 	const modal = createGroupModal(group, currentValue, legend, translator, locale);
-	try {
-		const built = modal.build(nextModalOpenState(group.key));
-		const expectedCustomId = customIdOf(built);
-		await interaction.showModal(built);
-		const submitted = await interaction.awaitModalSubmit({
-			time: MODAL_TIMEOUT_MS,
-			filter: (submission) =>
-				submission.user.id === interaction.user.id && submission.customId === expectedCustomId,
-		});
-		if (!submitted.isFromMessage()) {
-			return null;
-		}
-		return { interaction: submitted, values: modal.read(submitted) };
-	} catch {
-		return null;
-	}
+	const submitted = await collectModalSubmission(
+		interaction,
+		modal.build(nextModalOpenState(group.key)),
+	);
+	return submitted === null ? null : { interaction: submitted, values: modal.read(submitted) };
 }
 
 /** Reading a group's submission back — the group's own counterpart of {@link EditorFieldModal}. */
@@ -340,25 +347,44 @@ function valueFieldDefOf<F extends string>(
 	};
 }
 
-/** Every field but the images: one optional text input, emptied to clear. */
-function createTextModal<F extends string>(
-	field: SettingsEditorValueField<F>,
-	current: SettingsEditorFieldValue,
+/**
+ * The one modal a single field opens: titled after the field, carrying
+ * `fields`, and read back into the shape every single-field caller shares.
+ */
+function createFieldModal<const M extends ModalFields>(
+	labelKey: string,
+	fields: M,
 	translator: Translator,
 	locale: Locale,
+	toSubmission: (values: ModalValues<M>) => ReturnType<EditorFieldModal["read"]>,
 ): EditorFieldModal {
-	const label = translator.translate(locale, field.labelKey);
 	const modal = createModal({
 		id: EDITOR_FIELD_MODAL_ID,
-		title: modalTitle(label, translator, locale),
-		fields: { value: valueFieldDefOf(field, current, translator, locale) },
+		title: modalTitle(translator.translate(locale, labelKey), translator, locale),
+		fields,
 	});
 	return {
 		build: (state) => modal.build(state),
-		read: (interaction) => ({ value: modal.read(interaction).value, upload: null, ids: null }),
+		read: (interaction) => toSubmission(modal.read(interaction)),
 	};
 }
 
+/** Every field but the images: one optional text input, emptied to clear. */
+function createTextModal<F extends string>(
+	field: SettingsEditorValueField<F>,
+	current: SettingsEditorFieldValue,
+	translator: Translator,
+	locale: Locale,
+): EditorFieldModal {
+	return createFieldModal(
+		field.labelKey,
+		{ value: valueFieldDefOf(field, current, translator, locale) },
+		translator,
+		locale,
+		(values) => ({ value: values.value, upload: null, ids: null }),
+	);
+}
+
 /**
  * An image field: a file upload and the address input side by side, both
  * optional, two of the five components a modal may carry.
@@ -373,11 +399,9 @@ function createImageModal<F extends string>(
 	translator: Translator,
 	locale: Locale,
 ): EditorFieldModal {
-	const label = translator.translate(locale, field.labelKey);
-	const modal = createModal({
-		id: EDITOR_FIELD_MODAL_ID,
-		title: modalTitle(label, translator, locale),
-		fields: {
+	return createFieldModal(
+		field.labelKey,
+		{
 			upload: {
 				kind: "file",
 				label: translator.translate(locale, SETTINGS_EDITOR_MESSAGES.modalUploadLabel),
@@ -402,14 +426,10 @@ function createImageModal<F extends string>(
 				...(current.text === null ? {} : { value: current.text }),
 			},
 		},
-	});
-	return {
-		build: (state) => modal.build(state),
-		read: (interaction) => {
-			const values = modal.read(interaction);
-			return { value: values.value, upload: values.upload?.[0] ?? null, ids: null };
-		},
-	};
+		translator,
+		locale,
+		(values) => ({ value: values.value, upload: values.upload?.[0] ?? null, ids: null }),
+	);
 }
 
 /**
@@ -426,11 +446,9 @@ function createPickerModal<F extends string>(
 	translator: Translator,
 	locale: Locale,
 ): EditorFieldModal {
-	const label = translator.translate(locale, field.labelKey);
-	const modal = createModal({
-		id: EDITOR_FIELD_MODAL_ID,
-		title: modalTitle(label, translator, locale),
-		fields: {
+	return createFieldModal(
+		field.labelKey,
+		{
 			value: pickerFieldDef(
 				field,
 				pickerShared(field, translator, locale),
@@ -439,14 +457,16 @@ function createPickerModal<F extends string>(
 				locale,
 			),
 		},
-	});
-	return {
-		build: (state) => modal.build(state),
-		read: (interaction) => {
-			const read = modal.read(interaction) as { value: readonly string[] | null };
-			return { value: null, upload: null, ids: read.value };
-		},
-	};
+		translator,
+		locale,
+		(values) => ({ value: null, upload: null, ids: values.value as readonly string[] | null }),
+	);
+}
+
+/** The part of a picker component every kind of picker declares alike. */
+interface PickerShared extends SelectBounds {
+	label: string;
+	required: boolean;
 }
 
 /**
@@ -457,13 +477,7 @@ function pickerShared<F extends string>(
 	field: SettingsEditorPickerField<F>,
 	translator: Translator,
 	locale: Locale,
-): {
-	label: string;
-	required: boolean;
-	minValues?: number;
-	maxValues?: number;
-	placeholder?: string;
-} {
+): PickerShared {
 	const placeholder =
 		field.pickerPlaceholderKey === undefined
 			? undefined
@@ -483,13 +497,7 @@ function pickerShared<F extends string>(
 /** The one component a picker modal carries, in the shape its field's kind names. */
 function pickerFieldDef<F extends string>(
 	field: SettingsEditorPickerField<F>,
-	shared: {
-		label: string;
-		required: boolean;
-		minValues?: number;
-		maxValues?: number;
-		placeholder?: string;
-	},
+	shared: PickerShared,
 	held: readonly string[],
 	translator: Translator,
 	locale: Locale,
@@ -522,7 +530,7 @@ function pickerFieldDef<F extends string>(
 				kind: "select",
 				...shared,
 				options: field.choices.map((choice) => ({
-					label: translator.translate(locale, choice.labelKey),
+					label: translator.translate(locale, choice.labelKey, choice.labelParams),
 					value: choice.value,
 					...(choice.descriptionKey === undefined
 						? {}

package/src/discord/components/settings-editor/settings-editor-field-values.ts

@@ -0,0 +1,11 @@
+import type { SettingsEditorFieldValue } from "@/discord/components/settings-editor/settings-editor-fields";
+
+/** A text override, as the modal editing it opens on. */
+export function textFieldValue(value: string | null): SettingsEditorFieldValue {
+	return { text: value, uploaded: false, picked: [] };
+}
+
+/** A picker override, as the modal editing it opens on — prefilled from what it already holds. */
+export function pickedFieldValue(ids: readonly string[]): SettingsEditorFieldValue {
+	return { text: null, uploaded: false, picked: ids };
+}

package/src/discord/components/settings-editor/settings-editor-fields.ts

@@ -1,6 +1,6 @@
 import type { ChannelType } from "discord.js";
 import type { TextFieldStyleName } from "@/discord/interaction/modal";
-import type { TranslationParams } from "@/i18n";
+import type { TranslationParams } from "@/i18n/translator";
 
 /**
  * How a field is entered.
@@ -129,6 +129,11 @@ export interface SettingsEditorChoice {
 	/** What is stored — never shown, so it is not translated. */
 	readonly value: string;
 	readonly labelKey: string;
+	/**
+	 * Placeholders of `labelKey`, for a label computed at run time (a search
+	 * result) rather than declared.
+	 */
+	readonly labelParams?: TranslationParams;
 	/** Shown under the label, as a menu entry's hint is. Optional: a two-way toggle rarely needs one. */
 	readonly descriptionKey?: string;
 }
@@ -244,16 +249,6 @@ export interface SettingsEditorFieldValue {
 	readonly picked: readonly string[];
 }
 
-/** A text override, as the modal editing it opens on. */
-export function textFieldValue(value: string | null): SettingsEditorFieldValue {
-	return { text: value, uploaded: false, picked: [] };
-}
-
-/** A picker override, as the modal editing it opens on — prefilled from what it already holds. */
-export function pickedFieldValue(ids: readonly string[]): SettingsEditorFieldValue {
-	return { text: null, uploaded: false, picked: ids };
-}
-
 /** Discord's own cap on a modal text input, whatever the embed itself would take. */
 export const MAX_MODAL_INPUT_LENGTH = 4000;
 

package/src/discord/components/settings-editor/settings-editor.view.ts

@@ -8,10 +8,12 @@ import type { Clock } from "@/clock";
 import type {
 	InteractiveMessagePayload,
 	InteractiveView,
-} from "@/discord/components/interactive-message";
+} from "@/discord/components/interactive-message/interactive-message-collector";
 import {
 	canReturn,
 	currentLevelKey,
+	indexLevels,
+	levelTrail,
 	ROOT_LEVEL_KEY,
 	type SettingsEditorLevel,
 	type SettingsEditorPath,
@@ -33,7 +35,8 @@ import { createSelectRow, createStringSelect } from "@/discord/interaction/selec
 import type { CardBlock } from "@/discord/ui/card";
 import { EMBED_COLORS } from "@/discord/ui/colors";
 import type { MessageFile } from "@/discord/ui/message-attachments";
-import type { Locale, Translator } from "@/i18n";
+import type { Locale } from "@/i18n/locale";
+import type { Translator } from "@/i18n/translator";
 
 /**
  * The row type this file's own rendering builds — and, since the card layout
@@ -456,16 +459,11 @@ export function createEditorView<S, A, F extends string>(
 	const screenTitle = translator.translate(locale, chrome.titleKey);
 	const intro =
 		chrome.introKey === undefined ? null : translator.translate(locale, chrome.introKey);
-	// Separates the levels in the heading trail.
-	const BREADCRUMB_SEPARATOR = " › ";
 	const body = [intro, chrome.legend].filter(
 		(part): part is string => part !== undefined && part !== null,
 	);
 
-	// The root is a level like any other, named after the screen itself, so
-	// rendering never special-cases "no depth declared".
-	const root: SettingsEditorLevel<F> = { key: ROOT_LEVEL_KEY, titleKey: chrome.titleKey, fields };
-	const allLevels: readonly SettingsEditorLevel<F>[] = [root, ...(levels ?? [])];
+	const allLevels = indexLevels({ key: ROOT_LEVEL_KEY, titleKey: chrome.titleKey, fields }, levels);
 
 	// A level's fields are authored, not accumulated: passing more than a menu can
 	// hold is a mistake in the declaration, and Discord would reject the whole
@@ -474,7 +472,7 @@ export function createEditorView<S, A, F extends string>(
 	//
 	// Lists that *grow* — a guild's ticket types, its permission grants — are the
 	// screen's own to page, through `extraRows`. See research D7.
-	for (const level of allLevels) {
+	for (const level of allLevels.all) {
 		if (level.fields.length > MAX_SELECT_OPTIONS) {
 			throw new Error(
 				`Settings editor level "${level.key}" declares ${level.fields.length} entries; a select menu holds ${MAX_SELECT_OPTIONS}. Split it into a deeper level.`,
@@ -497,17 +495,10 @@ export function createEditorView<S, A, F extends string>(
 		}
 	}
 
-	// A path entry naming no declared level cannot happen — only a level field
-	// puts one there — but falling back to the root keeps a corrupted state
-	// showing a usable screen rather than an empty one.
-	function levelAt(key: string): SettingsEditorLevel<F> {
-		return allLevels.find((level) => level.key === key) ?? root;
-	}
-
 	// One menu per level, built once: the options of a level never vary with the
 	// state, only which level is showing does.
 	const menus = new Map(
-		allLevels.map((level) => [
+		allLevels.all.map((level) => [
 			level.key,
 			createStringSelect({
 				id: ids.field,
@@ -525,14 +516,10 @@ export function createEditorView<S, A, F extends string>(
 		return menus.get(currentLevelKey(state.path)) ?? menus.get(ROOT_LEVEL_KEY);
 	}
 
-	/**
-	 * Where the reader is, as a trail rather than only the current name: a level
-	 * called "Roles" says nothing on its own about which type it belongs to.
-	 */
 	function heading(state: SettingsEditorState<S, A>): string {
-		return state.path
-			.map((key) => translator.translate(locale, levelAt(key).titleKey))
-			.join(BREADCRUMB_SEPARATOR);
+		return levelTrail(state.path, allLevels, (level) =>
+			translator.translate(locale, level.titleKey),
+		);
 	}
 
 	/**

package/src/discord/events/event-guild-id.ts

@@ -0,0 +1,35 @@
+import { Guild } from "discord.js";
+
+/**
+ * The guild a gateway event concerns, read from its arguments: a `Guild`
+ * itself (`guildCreate`), or the first argument carrying a `guildId` (a
+ * message, a channel, an interaction) or a `guild` (a member, a ban, a role).
+ *
+ * @param args - the arguments discord.js passed to the listener.
+ * @returns the guild id, or `undefined` for an event bound to no guild.
+ */
+export function eventGuildId(args: readonly unknown[]): string | undefined {
+	for (const arg of args) {
+		const guildId = guildIdOf(arg);
+		if (guildId !== undefined) {
+			return guildId;
+		}
+	}
+	return undefined;
+}
+
+function guildIdOf(arg: unknown): string | undefined {
+	if (arg instanceof Guild) {
+		return arg.id;
+	}
+	if (typeof arg !== "object" || arg === null) {
+		return undefined;
+	}
+	if ("guildId" in arg && typeof arg.guildId === "string") {
+		return arg.guildId;
+	}
+	if ("guild" in arg && typeof arg.guild === "object" && arg.guild !== null && "id" in arg.guild) {
+		return typeof arg.guild.id === "string" ? arg.guild.id : undefined;
+	}
+	return undefined;
+}