@fraqjs/fraq 0.6.0 → 0.6.2

package/dist/index.d.mts

@@ -5624,6 +5624,7 @@ interface Disposable {
   dispose(): void | Promise<void>;
 }
 declare function isDisposable(service: object): service is Disposable;
+declare function implementsESNextDisposable(service: object): boolean;
 //#endregion
 //#region src/core/plugin.d.ts
 type ParameterList = Array<any>;
@@ -5646,6 +5647,7 @@ interface Plugin<
   optionalInject?: OI;
   provides?: readonly ServiceClass[];
   apply(ctx: Context & InjectedServices<I> & OptionalInjectedServices<OI>, ...args: T): void | Promise<void>;
+  start?(ctx: Context & InjectedServices<I> & OptionalInjectedServices<OI>): void | Promise<void>;
 }
 declare function definePlugin<
   T extends ParameterList,
@@ -5706,12 +5708,14 @@ declare class Context {
   private stopEventStream;
   private acceptsParentEvent;
   private applyPlugins;
+  private startPlugins;
   private sortPlugins;
   private collectPendingProvidedServices;
   private areRequiredServicesAvailable;
   private areOptionalServicesReady;
   private collectAvailableServices;
   private createUnresolvablePluginError;
+  private getPluginContext;
   private createProxyContextForPlugin;
   private runEventStream;
   private waitForReconnectDelay;
@@ -5794,6 +5798,7 @@ export {
   createMilkyClient,
   definePlugin,
   filter,
+  implementsESNextDisposable,
   isDisposable,
   type types_d_exports as milky,
   milkyPackageVersion,

package/dist/index.mjs

@@ -363,6 +363,9 @@ function combineLogHandlers(...handlers) {
 function isDisposable(service) {
 	return "dispose" in service && typeof service.dispose === "function";
 }
+function implementsESNextDisposable(service) {
+	return Symbol.dispose in service && typeof service[Symbol.dispose] === "function";
+}
 //#endregion
 //#region src/core/context.ts
 const DEFAULT_INITIAL_RECONNECT_DELAY_MS = 1e3;
@@ -436,6 +439,14 @@ var Context = class Context {
 	}
 	provide(service, instance) {
 		if (this.services.has(service)) throw new Error(`Service ${service.name} has already been provided in this context.`);
+		if (implementsESNextDisposable(instance) && !isDisposable(instance)) throw new Error(`
+Service ${service.name} implements ESNext Disposable but not Fraq Disposable.
+Please explicitly import the interface like this:
+
+import type { Disposable } from '@fraqjs/fraq';
+
+and implement the dispose method to clean up resources when the context stops.
+    `.trim());
 		this.services.set(service, instance);
 	}
 	resolve(service) {
@@ -516,7 +527,9 @@ var Context = class Context {
 	}
 	async startInternal() {
 		try {
-			await this.applyPlugins();
+			const sortedPlugins = this.sortPlugins();
+			await this.applyPlugins(sortedPlugins);
+			await this.startPlugins(sortedPlugins);
 		} catch (error) {
 			this.state = "idle";
 			throw error;
@@ -569,13 +582,21 @@ var Context = class Context {
 		const predicate = this.filter[type];
 		return predicate?.(event) === true;
 	}
-	async applyPlugins() {
-		for (const { plugin, args } of this.sortPlugins()) {
+	async applyPlugins(sortedPlugins) {
+		for (const installedPlugin of sortedPlugins) {
+			const { plugin, args } = installedPlugin;
 			const providedBeforeApply = new Set(this.services.keys());
-			this.logger.info(`Applying plugin ${plugin.name}`);
-			await plugin.apply(this.createProxyContextForPlugin(plugin), ...args);
+			this.logger.debug(`Applying plugin ${plugin.name}`);
+			await plugin.apply(this.getPluginContext(installedPlugin), ...args);
 			for (const service of plugin.provides ?? []) if (!this.services.has(service) || providedBeforeApply.has(service)) throw new Error(`${plugin.name} declares service ${service.name} but did not provide it.`);
-			this.logger.debug(`Applied plugin ${plugin.name}`);
+		}
+	}
+	async startPlugins(sortedPlugins) {
+		for (const installedPlugin of sortedPlugins) {
+			const { plugin } = installedPlugin;
+			if (!plugin.start) continue;
+			this.logger.debug(`Plugin ${plugin.name} is starting...`);
+			await plugin.start(this.getPluginContext(installedPlugin));
 		}
 	}
 	sortPlugins() {
@@ -637,6 +658,10 @@ var Context = class Context {
 		});
 		return /* @__PURE__ */ new Error(`Unable to resolve plugin service dependencies: ${lines.join("; ")}.`);
 	}
+	getPluginContext(installedPlugin) {
+		installedPlugin.proxy ??= this.createProxyContextForPlugin(installedPlugin.plugin);
+		return installedPlugin.proxy;
+	}
 	createProxyContextForPlugin(plugin) {
 		const proxyLogger = new Logger((message) => this.logHandler?.(message), plugin.name);
 		let proxyInjections;
@@ -1088,4 +1113,4 @@ let param;
 	_param.segment = segment;
 })(param || (param = {}));
 //#endregion
-export { Context, Logger, Parameter, Router, combineLogHandlers, createMilkyClient, definePlugin, filter, isDisposable, milkyPackageVersion, milkyVersion, msg, param, seg };
+export { Context, Logger, Parameter, Router, combineLogHandlers, createMilkyClient, definePlugin, filter, implementsESNextDisposable, isDisposable, milkyPackageVersion, milkyVersion, msg, param, seg };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fraqjs/fraq",
   "type": "module",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Milky Bot framework",
   "files": [
     "dist"