@seedcord/http 0.9.1 → 0.10.0

package/dist/{edge.index-BjggaX6p.mjs → edge.index-Cmd1CLAd.mjs}

@@ -1,5 +1,5 @@
 import "reflect-metadata";
-import { GatedMetadataKey, MiddlewareRegistry, PublishDefault, RegisterDefaults, RegisterSubscriber, accessorStore, asError, clearStore, decodeComponentRoute, deferFlags, guardedAccessor, interactionMiddleware, isEmojiTuple, outcomeFor, queuedMsFor, reportDispatch, reportedWrite, resultFor, runAfter, runHandlerGates, sendFlags, slowGateMonitor } from "@seedcord/core/internal";
+import { GatedMetadataKey, MiddlewareRegistry, PublishDefault, RegisterDefaults, RegisterSubscriber, SubscribeMetadataKey, accessorStore, asError, clearStore, decodeComponentRoute, deferFlags, guardedAccessor, interactionMiddleware, interactionRoutesOf, isEmojiTuple, outcomeFor, queuedMsFor, registrationFor, reportDispatch, reportedWrite, resultFor, runAfter, runHandlerGates, sendFlags, slowGateMonitor } from "@seedcord/core/internal";
 import { SeedcordError, SeedcordTypeError, applicationIdFromToken, validateDiscordToken } from "@seedcord/errors/internal";
 import { Logger } from "@seedcord/logger";
 import { Converters, Envapter } from "envapt";
@@ -296,9 +296,6 @@ function createCore(config, token) {
 	draft.bus = new Bus(draft);
 	return draft;
 }
-function isHandlerCtor(value) {
-	return typeof value === "function" && value.prototype instanceof BaseHandler;
-}
 const HARMLESS_API_CODES = /* @__PURE__ */ new Set([
 	RESTJSONErrorCodes.UnknownInteraction,
 	RESTJSONErrorCodes.InteractionHasAlreadyBeenAcknowledged,
@@ -426,21 +423,6 @@ async function answer(caught, scope, report, outcome = outcomeFor(caught)) {
 		report(outcome);
 	}
 }
-async function loadHandlerCtor(match, payload, core, dispatch, report) {
-	const routeId = unhandledRouteId(match);
-	let exported;
-	try {
-		exported = await match.load();
-	} catch (caught) {
-		logger().error(`Route ${paint.sky.bold(routeId)} failed to load its handler.`, caught);
-		await answer(caught, freshScope(match, payload, core, dispatch), report, "failed");
-		return null;
-	}
-	if (isHandlerCtor(exported)) return exported;
-	logger().error(`Route ${paint.sky.bold(routeId)} loaded an export that is not a handler class.`);
-	await answer(/* @__PURE__ */ new Error(`route ${routeId} loaded an export that is not a handler class`), freshScope(match, payload, core, dispatch), report, "failed");
-	return null;
-}
 async function runMiddlewares(step, kind, sender) {
 	const { args, dispatch, ran } = step;
 	for (const Middleware of args.middlewares.chainFor(kind)) {
@@ -465,8 +447,7 @@ async function dispatchInteraction(args) {
 	const routeId = unhandledRouteId(match);
 	const dispatch = new DispatchContext(routeId);
 	const report = dispatchReporter(match, payload, core, dispatch.id);
-	const Handler = await loadHandlerCtor(match, payload, core, dispatch, report);
-	if (!Handler) return null;
+	const Handler = match.ctor;
 	logger().debug(`Processing ${paint.sky.bold(routeId)} with ${paint.mute(Handler.name)}`);
 	let handler;
 	try {
@@ -526,36 +507,6 @@ async function gateRefusal(step) {
 	}
 }
 
-//#endregion
-//#region src/dispatch/registerSubscribers.ts
-function registerSubscribers(bus, manifest) {
-	for (const row of manifest.subscriberRoutes) bus[RegisterSubscriber]({
-		keys: row.keys,
-		frequency: row.frequency,
-		resolve: async () => {
-			const keys = row.keys.join(", ");
-			let module;
-			try {
-				module = await row.load();
-			} catch (caught) {
-				throw new SeedcordError(SeedcordErrorCode.RouteModuleLoadFailed, [keys, row.from], { cause: caught });
-			}
-			if (!Object.hasOwn(module, row.exportName)) throw new SeedcordError(SeedcordErrorCode.InteractionRouteExportMissing, [
-				keys,
-				row.exportName,
-				row.from
-			]);
-			const exported = module[row.exportName];
-			if (typeof exported !== "function" || !(exported.prototype instanceof Subscriber)) throw new SeedcordTypeError(SeedcordErrorCode.SubscriberRouteNotASubscriber, [
-				keys,
-				row.exportName,
-				row.from
-			]);
-			return exported;
-		}
-	});
-}
-
 //#endregion
 //#region src/inputs/HttpSlashOptions.ts
 var HttpSlashOptions = class {
@@ -711,14 +662,6 @@ var AutocompleteHandler = class extends BaseHandler {
 	}
 };
 
-//#endregion
-//#region src/handlers/defaults/UnhandledAutocomplete.ts
-var UnhandledAutocomplete = class extends AutocompleteHandler {
-	async execute() {
-		await this.respond([]);
-	}
-};
-
 //#endregion
 //#region src/handlers/interaction/InteractionHandler.ts
 /**
@@ -743,6 +686,80 @@ var InteractionHandler = class extends RepliableHandler$1 {
 	}
 };
 
+//#endregion
+//#region src/handlers/interaction/InteractionMiddleware.ts
+/**
+* Base class for interaction middleware on the HTTP transport.
+*
+* Middleware runs after the dispatcher builds the handler and before the gates, over the handler's own
+* reply surface. Name the kinds in the generic and list the same ones in `{ kinds }`. Several kinds give
+* `this.event` a union. Narrow it on `type` and `data.component_type`. A catchall reads every repliable
+* kind.
+*
+* @typeParam Kind - One or more {@link InteractionKind} members. Defaults to every repliable kind.
+*
+* @example
+* ```ts
+* \@RegisterInteractionMiddleware({ kinds: [InteractionKind.Button] })
+* class Audit extends InteractionMiddleware<InteractionKind.Button> {
+*     async execute() {
+*         this.logger.info(this.event.data.custom_id);
+*     }
+* }
+* ```
+*/
+var InteractionMiddleware = class extends RepliableHandler$1 {
+	constructor(event, core, dispatch, sender) {
+		super(event, core, dispatch, sender);
+	}
+};
+
+//#endregion
+//#region src/manifest/entries.ts
+function isHandlerClass(value) {
+	if (typeof value !== "function") return false;
+	return value.prototype instanceof InteractionHandler || value.prototype instanceof AutocompleteHandler;
+}
+function isMiddlewareClass(value) {
+	return typeof value === "function" && value.prototype instanceof InteractionMiddleware;
+}
+function isSubscriberClass(value) {
+	return typeof value === "function" && value.prototype instanceof Subscriber;
+}
+function wrongClass(array, value, base) {
+	const name = typeof value === "function" ? value.name : String(value);
+	return new SeedcordTypeError(SeedcordErrorCode.ManifestEntryWrongClass, [
+		array,
+		name,
+		base
+	]);
+}
+function noRoutes(array, className, decorator) {
+	return new SeedcordError(SeedcordErrorCode.ManifestEntryNoRoutes, [
+		array,
+		className,
+		decorator
+	]);
+}
+
+//#endregion
+//#region src/dispatch/registerSubscribers.ts
+function registerSubscribers(bus, subscribers) {
+	for (const ctor of subscribers) {
+		if (!isSubscriberClass(ctor)) throw wrongClass("subscribers", ctor, "Subscriber");
+		if (!Reflect.hasMetadata(SubscribeMetadataKey, ctor)) throw noRoutes("subscribers", ctor.name, "@Subscribe");
+		bus[RegisterSubscriber](registrationFor(ctor));
+	}
+}
+
+//#endregion
+//#region src/handlers/defaults/UnhandledAutocomplete.ts
+var UnhandledAutocomplete = class extends AutocompleteHandler {
+	async execute() {
+		await this.respond([]);
+	}
+};
+
 //#endregion
 //#region src/handlers/defaults/UnhandledRepliable.ts
 var UnhandledRepliable = class extends InteractionHandler {
@@ -772,32 +789,8 @@ function componentMapKey(type) {
 		default: return null;
 	}
 }
-function namedExport(routeId, row) {
-	return async () => {
-		let moduleExports;
-		try {
-			moduleExports = await row.load();
-		} catch (caught) {
-			throw new SeedcordError(SeedcordErrorCode.RouteModuleLoadFailed, [routeId, row.from], { cause: caught });
-		}
-		if (!Object.hasOwn(moduleExports, row.exportName)) throw new SeedcordError(SeedcordErrorCode.InteractionRouteExportMissing, [
-			routeId,
-			row.exportName,
-			row.from
-		]);
-		return moduleExports[row.exportName];
-	};
-}
-function describeRow(row) {
-	return `${row.exportName} (${row.from})`;
-}
-/**
-* Builds the per-kind lookup maps.
-*
-* @throws A **SeedcordError** when two rows resolve to the same route.
-*/
-function buildRouteMaps(manifest) {
-	const maps = {
+function emptyRouteMaps() {
+	return {
 		[InteractionKind.Slash]: /* @__PURE__ */ new Map(),
 		[InteractionKind.UserContextMenu]: /* @__PURE__ */ new Map(),
 		[InteractionKind.MessageContextMenu]: /* @__PURE__ */ new Map(),
@@ -810,44 +803,20 @@ function buildRouteMaps(manifest) {
 		[InteractionKind.MentionableMenu]: /* @__PURE__ */ new Map(),
 		[InteractionKind.Modal]: /* @__PURE__ */ new Map()
 	};
-	const owners = /* @__PURE__ */ new Map();
-	function set(kind, key, row) {
-		const routeId = `${kind}:${key}`;
-		const owner = owners.get(routeId);
-		if (owner) throw new SeedcordError(SeedcordErrorCode.InteractionDuplicateRoute, [
-			routeId,
-			describeRow(owner),
-			describeRow(row)
-		]);
-		owners.set(routeId, row);
-		maps[kind].set(key, {
-			kind,
-			routeId,
-			load: namedExport(routeId, row)
-		});
-	}
-	for (const row of manifest.commandRoutes) {
-		const kind = commandKind(row.type);
-		if (kind) set(kind, row.name, row);
-	}
-	for (const row of manifest.autocompleteRoutes) set(InteractionKind.Autocomplete, row.name, row);
-	for (const row of manifest.componentRoutes) set(row.kind, row.prefix, row);
-	return maps;
 }
 function unhandled(kind, attemptedKey) {
 	return {
 		kind,
 		routeId: null,
 		attemptedKey,
-		load: () => Promise.resolve(kind === InteractionKind.Autocomplete ? UnhandledAutocomplete : UnhandledRepliable)
+		ctor: kind === InteractionKind.Autocomplete ? UnhandledAutocomplete : UnhandledRepliable
 	};
 }
 /**
-* Matches a verified non-PING interaction to its manifest row. A known kind with no row resolves to the
-* unhandled default, whose handler replies "Feature not implemented yet." (empty choices on autocomplete).
-* Null is an unrecognized payload shape, which the engine acks with a 202 without dispatching.
-* Components and modals route by the stable customId prefix, so a wire whose layout hash drifted still
-* routes to its handler, where decode refuses with `StaleCustomId`.
+* Matches a verified non-PING interaction to a registered handler. A known kind with no handler resolves
+* to the unhandled default. Null is an unrecognized payload shape, which the engine acks with a 202
+* without dispatching. Components and modals route by the stable customId prefix. A wire whose layout
+* hash drifted still reaches its handler, where decode refuses with `StaleCustomId`.
 */
 function resolve(maps, interaction) {
 	switch (interaction.type) {
@@ -877,6 +846,65 @@ function resolve(maps, interaction) {
 	}
 }
 
+//#endregion
+//#region src/dispatch/RouteRegistry.ts
+var RouteRegistry = class {
+	maps = emptyRouteMaps();
+	owners = /* @__PURE__ */ new Map();
+	get size() {
+		return this.owners.size;
+	}
+	/**
+	* Writes every route the class declares. A class declaring none returns false.
+	*
+	* @throws A **SeedcordError** when another class already holds one of them.
+	*/
+	register(ctor, from) {
+		const writes = [];
+		for (const [kind, keys] of interactionRoutesOf(ctor)) for (const key of keys) {
+			const existing = this.owners.get(`${kind}:${key}`);
+			if (existing && existing.ctor !== ctor) throw new SeedcordError(SeedcordErrorCode.InteractionDuplicateRoute, [
+				`${kind}:${key}`,
+				`${existing.ctor.name} (${existing.from})`,
+				`${ctor.name} (${from})`
+			]);
+			writes.push({
+				kind,
+				key
+			});
+		}
+		if (writes.length === 0) return false;
+		for (const { kind, key } of writes) {
+			const routeId = `${kind}:${key}`;
+			this.maps[kind].set(key, {
+				kind,
+				routeId,
+				ctor
+			});
+			this.owners.set(routeId, {
+				ctor,
+				kind,
+				key,
+				from
+			});
+		}
+		return true;
+	}
+	unregister(ctor, routeIds) {
+		for (const routeId of routeIds ?? this.routesOf(ctor)) {
+			const owner = this.owners.get(routeId);
+			if (owner?.ctor !== ctor) continue;
+			this.owners.delete(routeId);
+			this.maps[owner.kind].delete(owner.key);
+		}
+	}
+	routesOf(ctor) {
+		const routeIds = [];
+		for (const [routeId, owner] of this.owners) if (owner.ctor === ctor) routeIds.push(routeId);
+		return routeIds;
+	}
+};
+
 //#endregion
 //#region src/receiver/Ed25519Verifier.ts
 const PUBLIC_KEY_BYTES = 32;
@@ -1020,6 +1048,7 @@ function buildEngine(core, maps, middlewares) {
 
 //#endregion
 //#region src/createSeedcord.ts
+const MANIFEST_ORIGIN = "the manifest";
 /**
 * Builds the HTTP-interactions engine, a `(request, ctx?) => Promise<Response>` handler.
 *
@@ -1041,8 +1070,18 @@ function createSeedcord(config, manifest) {
 	const token = validateDiscordToken(Envapter.get("DISCORD_BOT_TOKEN"));
 	const core = createCore(config, token);
 	core.bus[RegisterDefaults]();
-	registerSubscribers(core.bus, manifest);
-	return buildEngine(core, buildRouteMaps(manifest), new MiddlewareRegistry(interactionMiddleware)).handle;
+	registerSubscribers(core.bus, manifest.subscribers);
+	const routes = new RouteRegistry();
+	for (const handler of manifest.handlers) {
+		if (!isHandlerClass(handler)) throw wrongClass("handlers", handler, "InteractionHandler or AutocompleteHandler");
+		if (!routes.register(handler, MANIFEST_ORIGIN)) throw noRoutes("handlers", handler.name, "route decorator");
+	}
+	const middlewares = new MiddlewareRegistry(interactionMiddleware);
+	for (const middleware of manifest.middleware) {
+		if (!isMiddlewareClass(middleware)) throw wrongClass("middleware", middleware, "InteractionMiddleware");
+		if (!middlewares.register(middleware)) throw noRoutes("middleware", middleware.name, "@RegisterInteractionMiddleware");
+	}
+	return buildEngine(core, routes.maps, middlewares).handle;
 }
 
 //#endregion
@@ -1290,34 +1329,6 @@ var EmojiInjector = class {
 	}
 };
 
-//#endregion
-//#region src/handlers/interaction/InteractionMiddleware.ts
-/**
-* Base class for interaction middleware on the HTTP transport.
-*
-* Middleware runs after the dispatcher builds the handler and before the gates, over the handler's own
-* reply surface. Name the kinds in the generic and list the same ones in `{ kinds }`. Several kinds give
-* `this.event` a union. Narrow it on `type` and `data.component_type`. A catchall reads every repliable
-* kind.
-*
-* @typeParam Kind - One or more {@link InteractionKind} members. Defaults to every repliable kind.
-*
-* @example
-* ```ts
-* \@RegisterInteractionMiddleware({ kinds: [InteractionKind.Button] })
-* class Audit extends InteractionMiddleware<InteractionKind.Button> {
-*     async execute() {
-*         this.logger.info(this.event.data.custom_id);
-*     }
-* }
-* ```
-*/
-var InteractionMiddleware = class extends RepliableHandler$1 {
-	constructor(event, core, dispatch, sender) {
-		super(event, core, dispatch, sender);
-	}
-};
-
 //#endregion
 //#region src/handlers/interaction/SlashHandler.ts
 /**
@@ -1895,8 +1906,8 @@ function Gated(...gates) {
 
 //#endregion
 //#region src/version.ts
-const version = "0.9.1";
+const version = "0.10.0";
 
 //#endregion
-export { ReplySender as A, ModalFields as C, InteractionHandler as D, buildRouteMaps as E, AutocompleteHandler as O, Emojis as S, buildEngine as T, MessageContextMenuHandler as _, Paginator as a, InteractionMiddleware as b, ChannelMenuHandler as c, SelectMenuHandler as d, StringMenuHandler as f, ComponentHandler as g, ButtonHandler as h, CursorSource as i, RepliableHandler$1 as k, MentionableMenuHandler as l, ModalHandler as m, Gated as n, Subscriber$1 as o, UserMenuHandler as p, ArraySource as r, WebhookLog$1 as s, version as t, RoleMenuHandler as u, UserContextMenuHandler as v, createSeedcord as w, EmojiInjector as x, SlashHandler as y };
-//# sourceMappingURL=edge.index-BjggaX6p.mjs.map
+export { InteractionHandler as A, createSeedcord as C, isHandlerClass as D, emptyRouteMaps as E, RepliableHandler$1 as M, ReplySender as N, isMiddlewareClass as O, ModalFields as S, RouteRegistry as T, MessageContextMenuHandler as _, Paginator as a, EmojiInjector as b, ChannelMenuHandler as c, SelectMenuHandler as d, StringMenuHandler as f, ComponentHandler as g, ButtonHandler as h, CursorSource as i, AutocompleteHandler as j, InteractionMiddleware as k, MentionableMenuHandler as l, ModalHandler as m, Gated as n, Subscriber$1 as o, UserMenuHandler as p, ArraySource as r, WebhookLog$1 as s, version as t, RoleMenuHandler as u, UserContextMenuHandler as v, buildEngine as w, Emojis as x, SlashHandler as y };
+//# sourceMappingURL=edge.index-Cmd1CLAd.mjs.map