@wolfstar/http-framework 2.3.1 → 3.0.0

package/dist/esm/index.js

@@ -408,6 +408,120 @@ var StringIdParser = class {
 	}
 };
 
+//#endregion
+//#region src/lib/types/Enums.ts
+let PluginHook = /* @__PURE__ */ function(PluginHook) {
+	PluginHook["PreGenericsInitialization"] = "preGenericsInitialization";
+	PluginHook["PreInitialization"] = "preInitialization";
+	PluginHook["PostInitialization"] = "postInitialization";
+	PluginHook["PreLoad"] = "preLoad";
+	PluginHook["PostListen"] = "postListen";
+	return PluginHook;
+}({});
+
+//#endregion
+//#region src/lib/plugins/symbols.ts
+const preGenericsInitialization = Symbol("HttpFrameworkPluginsPreGenericsInitialization");
+const preInitialization = Symbol("HttpFrameworkPluginsPreInitialization");
+const postInitialization = Symbol("HttpFrameworkPluginsPostInitialization");
+const preLoad = Symbol("HttpFrameworkPluginsPreLoad");
+const postListen = Symbol("HttpFrameworkPluginsPostListen");
+
+//#endregion
+//#region \0@oxc-project+runtime@0.137.0/helpers/esm/typeof.js
+function _typeof(o) {
+	"@babel/helpers - typeof";
+	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
+		return typeof o;
+	} : function(o) {
+		return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
+	}, _typeof(o);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.137.0/helpers/esm/toPrimitive.js
+function toPrimitive(t, r) {
+	if ("object" != _typeof(t) || !t) return t;
+	var e = t[Symbol.toPrimitive];
+	if (void 0 !== e) {
+		var i = e.call(t, r || "default");
+		if ("object" != _typeof(i)) return i;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return ("string" === r ? String : Number)(t);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.137.0/helpers/esm/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.137.0/helpers/esm/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
+
+//#endregion
+//#region src/lib/plugins/PluginManager.ts
+var PluginManager = class {
+	constructor() {
+		_defineProperty(this, "registry", /* @__PURE__ */ new Set());
+	}
+	registerHook(hook, type, name) {
+		if (typeof hook !== "function") throw new TypeError(`The provided hook ${name ? `(${name}) ` : ""}is not a function`);
+		this.registry.add({
+			hook,
+			type,
+			name
+		});
+		return this;
+	}
+	registerPreGenericsInitializationHook(hook, name) {
+		return this.registerHook(hook, "preGenericsInitialization", name);
+	}
+	registerPreInitializationHook(hook, name) {
+		return this.registerHook(hook, "preInitialization", name);
+	}
+	registerPostInitializationHook(hook, name) {
+		return this.registerHook(hook, "postInitialization", name);
+	}
+	registerPreLoadHook(hook, name) {
+		return this.registerHook(hook, "preLoad", name);
+	}
+	registerPostListenHook(hook, name) {
+		return this.registerHook(hook, "postListen", name);
+	}
+	use(plugin) {
+		const possibleSymbolHooks = [
+			[preGenericsInitialization, "preGenericsInitialization"],
+			[preInitialization, "preInitialization"],
+			[postInitialization, "postInitialization"],
+			[preLoad, "preLoad"],
+			[postListen, "postListen"]
+		];
+		for (const [hookSymbol, hookType] of possibleSymbolHooks) {
+			const hook = Reflect.get(plugin, hookSymbol);
+			if (typeof hook !== "function") continue;
+			this.registerHook(hook, hookType, plugin.name);
+		}
+		return this;
+	}
+	*values(hook) {
+		for (const plugin of this.registry) {
+			if (hook && plugin.type !== hook) continue;
+			yield plugin;
+		}
+	}
+};
+
 //#endregion
 //#region src/lib/interactions/decorators/_shared.ts
 function ensureChatInputCommandResolver(target) {
@@ -1390,48 +1504,6 @@ const Payloads = { Pong: JSON.stringify({ type: InteractionResponseType.Pong })
 const Data = Symbol("data");
 const Response = Symbol("response");
 
-//#endregion
-//#region \0@oxc-project+runtime@0.137.0/helpers/esm/typeof.js
-function _typeof(o) {
-	"@babel/helpers - typeof";
-	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
-		return typeof o;
-	} : function(o) {
-		return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
-	}, _typeof(o);
-}
-
-//#endregion
-//#region \0@oxc-project+runtime@0.137.0/helpers/esm/toPrimitive.js
-function toPrimitive(t, r) {
-	if ("object" != _typeof(t) || !t) return t;
-	var e = t[Symbol.toPrimitive];
-	if (void 0 !== e) {
-		var i = e.call(t, r || "default");
-		if ("object" != _typeof(i)) return i;
-		throw new TypeError("@@toPrimitive must return a primitive value.");
-	}
-	return ("string" === r ? String : Number)(t);
-}
-
-//#endregion
-//#region \0@oxc-project+runtime@0.137.0/helpers/esm/toPropertyKey.js
-function toPropertyKey(t) {
-	var i = toPrimitive(t, "string");
-	return "symbol" == _typeof(i) ? i : i + "";
-}
-
-//#endregion
-//#region \0@oxc-project+runtime@0.137.0/helpers/esm/defineProperty.js
-function _defineProperty(e, r, t) {
-	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
-		value: t,
-		enumerable: !0,
-		configurable: !0,
-		writable: !0
-	}) : e[r] = t, e;
-}
-
 //#endregion
 //#region src/lib/interactions/structures/interactions/base/BaseInteraction.ts
 var BaseInteraction = class {
@@ -3246,14 +3318,28 @@ container$1.stores.register(new CommandStore());
 container$1.stores.register(new InteractionHandlerStore());
 container$1.stores.register(new ListenerStore());
 var _discordPublicKey = /* @__PURE__ */ new WeakMap();
-var Client = class extends AsyncEventEmitter {
+var Client = class Client extends AsyncEventEmitter {
 	constructor(options = {}) {
 		super();
 		_defineProperty(this, "server", void 0);
 		_defineProperty(this, "id", void 0);
+		_defineProperty(this, "options", void 0);
 		_defineProperty(this, "bodySizeLimit", void 0);
 		_defineProperty(this, "httpReplyOnError", void 0);
 		_classPrivateFieldInitSpec(this, _discordPublicKey, void 0);
+		this.options = {
+			...options,
+			discordToken: void 0,
+			discordPublicKey: void 0
+		};
+		for (const plugin of Client.plugins.values("preGenericsInitialization")) {
+			plugin.hook.call(this, this.options);
+			this.emit("pluginLoaded", plugin.type, plugin.name);
+		}
+		for (const plugin of Client.plugins.values("preInitialization")) {
+			plugin.hook.call(this, this.options);
+			this.emit("pluginLoaded", plugin.type, plugin.name);
+		}
 		this.bodySizeLimit = options.bodySizeLimit ?? 1024 * 1024;
 		this.httpReplyOnError = options.httpReplyOnError ?? true;
 		const discordPublicKey = options.discordPublicKey ?? process.env.DISCORD_PUBLIC_KEY;
@@ -3271,6 +3357,20 @@ var Client = class extends AsyncEventEmitter {
 			rest: container$1.rest,
 			authPrefix: options.authPrefix
 		});
+		for (const plugin of Client.plugins.values("postInitialization")) {
+			plugin.hook.call(this, this.options);
+			this.emit("pluginLoaded", plugin.type, plugin.name);
+		}
+	}
+	/**
+	* Registers a plugin onto the {@link Client}, applying all of its hooks.
+	*
+	* @since 2.4.0
+	* @param plugin The plugin to register.
+	*/
+	static use(plugin) {
+		this.plugins.use(plugin);
+		return this;
 	}
 	/**
 	* Gets the application command registry.
@@ -3286,6 +3386,10 @@ var Client = class extends AsyncEventEmitter {
 	* @param options The load options.
 	*/
 	async load(options = {}) {
+		for (const plugin of Client.plugins.values("preLoad")) {
+			await plugin.hook.call(this, this.options);
+			this.emit("pluginLoaded", plugin.type, plugin.name);
+		}
 		if (options.baseUserDirectory !== null) container$1.stores.registerPath(options.baseUserDirectory);
 		await container$1.stores.load();
 	}
@@ -3298,11 +3402,20 @@ var Client = class extends AsyncEventEmitter {
 		const path = postPath ?? process.env.HTTP_POST_PATH ?? "/";
 		this.server = createServer(serverOptions ?? {});
 		this.server.on("request", (request, response) => void this.handleRawHttpMessage(request, response, path, key));
-		return new Promise((resolve) => this.server.listen({
+		await new Promise((resolve) => this.server.listen({
 			...listenOptions,
 			port,
 			host: address
 		}, resolve));
+		try {
+			for (const plugin of Client.plugins.values("postListen")) {
+				await plugin.hook.call(this, this.options);
+				this.emit("pluginLoaded", plugin.type, plugin.name);
+			}
+		} catch (error) {
+			await new Promise((resolve) => this.server.close(() => resolve()));
+			throw error;
+		}
 	}
 	async handleRawHttpMessage(request, response, path, key) {
 		response.setHeader("Content-Type", "application/json");
@@ -3348,7 +3461,23 @@ var Client = class extends AsyncEventEmitter {
 		}
 	}
 };
+_defineProperty(Client, "plugins", new PluginManager());
+
+//#endregion
+//#region src/lib/plugins/Plugin.ts
+/**
+* The base class for all plugins. Plugins hook into the {@link Client}'s lifecycle by defining static
+* methods keyed by the plugin symbols. Use {@link PluginManager.use} (via `Client.use`) to register a plugin.
+*
+* @since 2.4.0
+*/
+var Plugin = class {};
+_defineProperty(Plugin, preGenericsInitialization, void 0);
+_defineProperty(Plugin, preInitialization, void 0);
+_defineProperty(Plugin, postInitialization, void 0);
+_defineProperty(Plugin, preLoad, void 0);
+_defineProperty(Plugin, postListen, void 0);
 
 //#endregion
-export { AliasPiece, AliasStore, ApplicationCommandRegistry, ApplicationCommandRegistryEntry, AutocompleteInteraction, BaseInteraction, ChatInputCommandInteraction, Client, Command, CommandInteraction, CommandLoaderStrategy, CommandRouter, CommandStore, CommandStoreRouter, HttpCodes, InteractionHandler, InteractionHandlerStore, Listener, ListenerLoaderStrategy, ListenerStore, LoaderError, Message, MessageComponentButtonInteraction, MessageComponentChannelSelectInteraction, MessageComponentInteraction, MessageComponentMentionableSelectInteraction, MessageComponentRoleSelectInteraction, MessageComponentStringSelectInteraction as MessageComponentSelectMenuInteraction, MessageComponentStringSelectInteraction, MessageComponentUserSelectInteraction, MessageContextMenuCommandInteraction, MissingExportsError, ModalSubmitInteraction, PartialMessage, Piece, RegisterCommand, RegisterMessageCommand, RegisterSubcommand, RegisterSubcommandGroup, RegisterUserCommand, RestrictGuildIds, Store, StoreRegistry, StringIdParser, UserContextMenuCommandInteraction, applicationCommandRegistry, container, extractTopLevelOptions, makeInteraction, restrictedGuildIdRegistry, transformAutocompleteInteraction, transformInteraction, transformMessageInteraction, transformUserInteraction };
+export { AliasPiece, AliasStore, ApplicationCommandRegistry, ApplicationCommandRegistryEntry, AutocompleteInteraction, BaseInteraction, ChatInputCommandInteraction, Client, Command, CommandInteraction, CommandLoaderStrategy, CommandRouter, CommandStore, CommandStoreRouter, HttpCodes, InteractionHandler, InteractionHandlerStore, Listener, ListenerLoaderStrategy, ListenerStore, LoaderError, Message, MessageComponentButtonInteraction, MessageComponentChannelSelectInteraction, MessageComponentInteraction, MessageComponentMentionableSelectInteraction, MessageComponentRoleSelectInteraction, MessageComponentStringSelectInteraction as MessageComponentSelectMenuInteraction, MessageComponentStringSelectInteraction, MessageComponentUserSelectInteraction, MessageContextMenuCommandInteraction, MissingExportsError, ModalSubmitInteraction, PartialMessage, Piece, Plugin, PluginHook, PluginManager, RegisterCommand, RegisterMessageCommand, RegisterSubcommand, RegisterSubcommandGroup, RegisterUserCommand, RestrictGuildIds, Store, StoreRegistry, StringIdParser, UserContextMenuCommandInteraction, applicationCommandRegistry, container, extractTopLevelOptions, makeInteraction, postInitialization, postListen, preGenericsInitialization, preInitialization, preLoad, restrictedGuildIdRegistry, transformAutocompleteInteraction, transformInteraction, transformMessageInteraction, transformUserInteraction };
 //# sourceMappingURL=index.js.map