@seedcord/http 0.1.0-next.2 → 0.1.0

package/dist/{edge.index-joDL39cK.cjs → edge.index-CweiaQ5R.cjs}

@@ -1,7 +1,9 @@
 //#region \0rolldown/runtime.js
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __exportAll = (all, no_symbols) => {
 	let target = {};
@@ -31,6 +33,10 @@ var __copyProps = (to, from, except, desc) => {
 	return to;
 };
 var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
 
 //#endregion
 let _seedcord_errors_internal = require("@seedcord/errors/internal");
@@ -54,11 +60,12 @@ function wireAllowedMentions(mentions) {
 	};
 }
 function wireAttachments(files) {
-	if (!files?.some((file) => file.description)) return null;
+	if (!files?.some((file) => file.description ?? file.title)) return null;
 	return files.map((file, index) => ({
 		id: index,
-		...file.name && { filename: file.name },
-		...file.description && { description: file.description }
+		filename: file.name,
+		...file.description && { description: file.description },
+		...file.title && { title: file.title }
 	}));
 }
 function callbackData(reply, flags) {
@@ -143,9 +150,9 @@ var ReplySender = class extends _seedcord_core_internal.BaseReplySender {
 		});
 	}
 	rawFiles(files) {
-		return files.map((file, index) => ({
-			name: file.name ?? `file-${index}`,
-			data: file.attachment
+		return files.map((file) => ({
+			name: file.name,
+			data: file.data
 		}));
 	}
 	createdMessage(result) {
@@ -177,6 +184,10 @@ function apiFor(rest) {
 * @typeParam Event - The repliable interaction type this handler processes
 */
 var RepliableHandler = class extends _seedcord_core.RepliableHandler {
+	/** @internal */
+	getEvent() {
+		return this.event;
+	}
 	buildSender(event, core, routeId) {
 		return new ReplySender({
 			application_id: event.application_id,
@@ -401,7 +412,7 @@ async function handleRawFault(error, uuid, scope) {
 }
 async function handleFault(caught, scope) {
 	if (caught instanceof _seedcord_core.Silence) {
-		if (caught.reason !== void 0) logger().debug(`Silence: ${caught.reason}`);
+		if (caught.reason !== void 0 && (scope.core.config.errors?.logSilences ?? true)) logger().debug(`Silence: ${caught.reason}`);
 		return;
 	}
 	const uuid = crypto.randomUUID();
@@ -475,8 +486,8 @@ async function loadHandlerCtor(match, payload, core, report) {
 }
 /**
 * Runs the pre-ack phase for a matched interaction. Loads the route's handler class, constructs it, and
-* runs its gates, and the sender posts any refusal. Returns the post-ack execute continuation, or null
-* when a gate refuses or nothing can run.
+* runs its gates. The sender posts any refusal. Returns the post-ack execute continuation, or null when a
+* gate refuses or nothing can run.
 */
 async function dispatchInteraction(args) {
 	const { match, payload, core } = args;
@@ -1056,6 +1067,114 @@ function createSeedcord(config, manifest) {
 	return buildEngine(core, buildRouteMaps(manifest)).handle;
 }
 
+//#endregion
+//#region src/applicationId.ts
+/**
+* Reads the bot's own application id over REST. A gateway host takes it off the logged-in client, and
+* an http host has no session to read it from.
+*
+* @internal
+*/
+async function fetchApplicationId(rest) {
+	try {
+		return (await rest.get(discord_api_types_v10.Routes.currentApplication())).id;
+	} catch (error) {
+		throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.CoreApplicationUnavailable, { cause: error });
+	}
+}
+
+//#endregion
+//#region src/emojis/EmojiInjector.ts
+var Emoji = class {
+	name;
+	id;
+	animated;
+	constructor(name, id, animated = false) {
+		this.name = name;
+		this.id = id;
+		this.animated = animated;
+	}
+	toString() {
+		return `<${this.animated ? "a" : ""}:${this.name}:${this.id}>`;
+	}
+};
+const emojiStorage = (0, _seedcord_core_internal.accessorStore)();
+function reasonOf(error) {
+	return Error.isError(error) ? error.message : String(error);
+}
+function byName(list) {
+	const map = /* @__PURE__ */ new Map();
+	for (const entry of list) if (entry.name) map.set(entry.name, entry);
+	return map;
+}
+/**
+* The bot's resolved emojis, keyed by {@link EmojiMap}. Filled by {@link EmojiInjector} during startup.
+* A read before that throws.
+*/
+const Emojis = (0, _seedcord_core_internal.guardedAccessor)("Emojis", emojiStorage);
+/**
+* Resolves the configured emojis over REST at startup.
+*
+* @internal
+*/
+var EmojiInjector = class {
+	core;
+	applicationId;
+	logger = new _seedcord_logger.Logger("Emojis", { channel: "bot" });
+	constructor(core, applicationId = () => fetchApplicationId(core.rest)) {
+		this.core = core;
+		this.applicationId = applicationId;
+	}
+	async init() {
+		(0, _seedcord_core_internal.clearStore)(emojiStorage);
+		const configured = this.core.config.bot.emojis;
+		if (!configured || Object.keys(configured).length === 0) {
+			this.logger.debug("No emojis configured, skipping emoji injection.");
+			return;
+		}
+		const failures = [];
+		const guilds = /* @__PURE__ */ new Map();
+		let application;
+		for (const [key, value] of Object.entries(configured)) if ((0, _seedcord_core_internal.isEmojiTuple)(value)) await this.resolveTuple(key, value, guilds, failures);
+		else if (typeof value === "string") {
+			application ??= await this.applicationEmojis(failures);
+			this.resolve(key, value, application, failures, "the application");
+		} else failures.push(`  - "${key}" has an invalid value (expected a name or [name, guildId])`);
+		if (failures.length > 0) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.ConfigEmojiUnresolved, [failures.length, failures.join("\n")]);
+		this.logger.utils.summary("Loaded emojis", { emojis: Object.keys(emojiStorage).length });
+	}
+	async applicationEmojis(failures) {
+		try {
+			const appId = await this.applicationId();
+			return byName((await this.core.rest.get(discord_api_types_v10.Routes.applicationEmojis(appId))).items);
+		} catch (error) {
+			failures.push(`  - the application emojis could not be read (${reasonOf(error)})`);
+			return /* @__PURE__ */ new Map();
+		}
+	}
+	async resolveTuple(key, [name, guildId], guilds, failures) {
+		let guild = guilds.get(guildId);
+		if (!guild) {
+			try {
+				guild = byName(await this.core.rest.get(discord_api_types_v10.Routes.guildEmojis(guildId)));
+			} catch (error) {
+				failures.push(`  - "${name}" for "${key}" targets guild ${guildId}, which could not be read (${reasonOf(error)})`);
+				return;
+			}
+			guilds.set(guildId, guild);
+		}
+		this.resolve(key, name, guild, failures, `guild ${guildId}`);
+	}
+	resolve(key, name, source, failures, where) {
+		const found = source.get(name);
+		if (!found?.id) {
+			failures.push(`  - "${name}" for "${key}" was not found in ${where}`);
+			return;
+		}
+		emojiStorage[key] = new Emoji(name, found.id, found.animated ?? false);
+	}
+};
+
 //#endregion
 //#region src/handlers/interaction/SlashHandler.ts
 /**
@@ -1236,12 +1355,12 @@ var SelectMenuHandler = class extends ComponentHandler {};
 * @typeParam Defs - The customId definitions this handler decodes, e.g. `[typeof ConfigId]`.
 */
 var ModalHandler = class extends ComponentHandler {
-	/** Rewrite the message this modal was opened from (only when a component opened it). */
+	/** Rewrite the message this modal was opened from. Throws when a command opened the modal. */
 	update(response) {
 		this.ensureSourceMessage("update");
 		return super.update(response);
 	}
-	/** Silently acknowledge, leaving the source message untouched. */
+	/** Acknowledge the submit without changing the source message. Throws when a command opened the modal. */
 	deferUpdate() {
 		this.ensureSourceMessage("deferUpdate");
 		return super.deferUpdate();
@@ -1268,6 +1387,82 @@ var Subscriber = class extends _seedcord_core.Subscriber {};
 */
 var WebhookLog = class extends _seedcord_core.WebhookLog {};
 
+//#endregion
+//#region src/pagination/Paginator.ts
+function contextOf(interaction, core) {
+	return {
+		interaction,
+		user: interaction.member?.user ?? interaction.user,
+		guildId: interaction.guild_id ?? null,
+		core
+	};
+}
+/**
+* A restart-proof paginator. Each nav button's customId encodes its full target page, so clicks are
+* idempotent and survive a restart. A persistent `@ButtonRoute` on `Handler` dispatches the clicks.
+*
+* @typeParam Item - The item type, inferred from the source.
+* @typeParam Prefix - The route prefix, inferred from `config.prefix`.
+*
+* @example
+* ```ts
+* export const Bans = new Paginator({
+*     prefix: 'bans',
+*     source: new ArraySource((ctx) => loadBans(ctx.guildId), { perPage: 10 }),
+*     renderItem: (ban) => ban.user.username
+* });
+*
+* \@ButtonRoute(Bans.cursor)
+* export class BansNav extends Bans.Handler {}
+* ```
+*/
+var Paginator = class extends _seedcord_core.PaginatorBase {
+	/** The nav handler base. Extend it with an empty body and decorate it, `@ButtonRoute(p.cursor)`. */
+	Handler;
+	constructor(config) {
+		super(config);
+		const loadPage = (ctx, n) => this.page(ctx, n);
+		this.Handler = class Nav extends ButtonHandler {
+			async execute() {
+				await this.deferUpdate();
+				const response = await loadPage(contextOf(this.event, this.core), this.params.page);
+				await this.update(response);
+			}
+		};
+	}
+	/**
+	* Render page 0 and send it through the handler's sender, which picks reply, edit, or followUp from its
+	* ack state.
+	*
+	* @param handler - The handler starting the paginator, normally `this`.
+	*/
+	async start(handler) {
+		const interaction = handler.getEvent();
+		const response = await this.page(contextOf(interaction, handler.core), 0);
+		return handler.getSender().send(response, { ephemeral: this.config.ephemeral ?? false });
+	}
+};
+
+//#endregion
+//#region src/pagination/sources.ts
+/**
+* A source for a bounded list you can load whole. It loads the full list on every click, then slices the
+* page, so the real total is known (a real last button, "Page X of Y"). Cache inside your loader if the
+* load is expensive.
+*
+* @typeParam Item - The item type, inferred from the loader's return.
+*/
+var ArraySource = class extends _seedcord_core.ArraySource {};
+/**
+* A source for a large or unknown-length set you fetch one page at a time (SQL LIMIT/OFFSET, a paged API).
+* The fetcher receives the page index and the page size and reports whether a next page exists. A cursor
+* source has no cheap total, so `totalPages` is undefined, the last button is omitted, and the indicator
+* reads "Page X".
+*
+* @typeParam Item - The item type, inferred from the fetcher's slice.
+*/
+var CursorSource = class extends _seedcord_core.CursorSource {};
+
 //#endregion
 //#region src/gates/Gated.ts
 /**
@@ -1312,9 +1507,15 @@ function Gated(...gates) {
 //#endregion
 //#region src/version.ts
 /** Package version */
-const version = "0.1.0-next.2";
+const version = "0.1.0";
 
 //#endregion
+Object.defineProperty(exports, 'ArraySource', {
+  enumerable: true,
+  get: function () {
+    return ArraySource;
+  }
+});
 Object.defineProperty(exports, 'AutocompleteHandler', {
   enumerable: true,
   get: function () {
@@ -1339,6 +1540,24 @@ Object.defineProperty(exports, 'ContextMenuHandler', {
     return ContextMenuHandler;
   }
 });
+Object.defineProperty(exports, 'CursorSource', {
+  enumerable: true,
+  get: function () {
+    return CursorSource;
+  }
+});
+Object.defineProperty(exports, 'EmojiInjector', {
+  enumerable: true,
+  get: function () {
+    return EmojiInjector;
+  }
+});
+Object.defineProperty(exports, 'Emojis', {
+  enumerable: true,
+  get: function () {
+    return Emojis;
+  }
+});
 Object.defineProperty(exports, 'Gated', {
   enumerable: true,
   get: function () {
@@ -1357,6 +1576,12 @@ Object.defineProperty(exports, 'ModalHandler', {
     return ModalHandler;
   }
 });
+Object.defineProperty(exports, 'Paginator', {
+  enumerable: true,
+  get: function () {
+    return Paginator;
+  }
+});
 Object.defineProperty(exports, 'RepliableHandler', {
   enumerable: true,
   get: function () {
@@ -1399,6 +1624,12 @@ Object.defineProperty(exports, '__reExport', {
     return __reExport;
   }
 });
+Object.defineProperty(exports, '__toESM', {
+  enumerable: true,
+  get: function () {
+    return __toESM;
+  }
+});
 Object.defineProperty(exports, 'buildEngine', {
   enumerable: true,
   get: function () {
@@ -1417,10 +1648,16 @@ Object.defineProperty(exports, 'createSeedcord', {
     return createSeedcord;
   }
 });
+Object.defineProperty(exports, 'fetchApplicationId', {
+  enumerable: true,
+  get: function () {
+    return fetchApplicationId;
+  }
+});
 Object.defineProperty(exports, 'version', {
   enumerable: true,
   get: function () {
     return version;
   }
 });
-//# sourceMappingURL=edge.index-joDL39cK.cjs.map
+//# sourceMappingURL=edge.index-CweiaQ5R.cjs.map