@fraqjs/fraq 0.9.0 → 0.9.1

package/dist/index.d.mts

@@ -5514,6 +5514,9 @@ interface Command<P extends Pattern> {
   name: string;
   pattern: P;
   execute: Executor<P>;
+  description?: string;
+  aliases?: string[];
+  hidden?: boolean;
 }
 interface RawPattern<P extends Pattern> {
   pattern: P;
@@ -5528,6 +5531,9 @@ declare class CommandBuilder<P extends Pattern = {}, S = Command<P>> {
   private readonly sink;
   private readonly pattern;
   private executor?;
+  private description?;
+  private aliases?;
+  private hidden?;
   constructor(name: string, sink?: (command: Command<P>) => S);
   arg<K extends string, T>(
     key: K,
@@ -5540,6 +5546,9 @@ declare class CommandBuilder<P extends Pattern = {}, S = Command<P>> {
         ? RawPattern<P & { [K2 in K]: Parameter<T> }>
         : S
   >;
+  describe(description: string): CommandBuilder<P, S>;
+  alias(...aliases: string[]): CommandBuilder<P, S>;
+  hide(): CommandBuilder<P, S>;
   execute(executor: Executor<P>): S;
 }
 //#endregion
@@ -5598,6 +5607,7 @@ declare class Router {
   group(name: string): Router;
   filter(predicate: SessionPredicate): Router;
   routes(): RouteEntry[];
+  aliasesOf(name: string): string[];
   branches(session: Session): RouteBranch[];
   match(session: Session, message: IncomingMessage): RouteMatchResult | undefined;
   dispatch(session: Session, message: IncomingMessage): Promise<boolean>;
@@ -5607,6 +5617,7 @@ declare class Router {
   private matchGroup;
   private matchRawPattern;
   private branchesFrom;
+  private resolveAliasConflicts;
   private validatePattern;
   private capturePattern;
 }

package/dist/index.mjs

@@ -70,6 +70,9 @@ var CommandBuilder = class {
 	sink;
 	pattern = {};
 	executor;
+	description;
+	aliases;
+	hidden;
 	constructor(name, sink = (command) => command) {
 		this.name = name;
 		this.sink = sink;
@@ -78,6 +81,19 @@ var CommandBuilder = class {
 		this.pattern[key] = parameter;
 		return this;
 	}
+	describe(description) {
+		this.description = description;
+		return this;
+	}
+	alias(...aliases) {
+		if (!this.aliases) this.aliases = [];
+		this.aliases.push(...aliases);
+		return this;
+	}
+	hide() {
+		this.hidden = true;
+		return this;
+	}
 	execute(executor) {
 		this.executor = executor;
 		const command = {
@@ -85,6 +101,9 @@ var CommandBuilder = class {
 			pattern: this.pattern,
 			execute: this.executor
 		};
+		if (this.description !== void 0) command.description = this.description;
+		if (this.aliases !== void 0) command.aliases = this.aliases;
+		if (this.hidden !== void 0) command.hidden = this.hidden;
 		return this.sink(command);
 	}
 };
@@ -222,6 +241,7 @@ var Router = class Router {
 			return builtCommand;
 		});
 		this.validatePattern(command.pattern);
+		this.resolveAliasConflicts(command);
 		this.entries.push({
 			type: "command",
 			command
@@ -265,6 +285,10 @@ var Router = class Router {
 	routes() {
 		return this.entries;
 	}
+	aliasesOf(name) {
+		for (const entry of this.entries) if (entry.type === "command" && entry.command.name === name) return entry.command.aliases ? [...entry.command.aliases] : [];
+		return [];
+	}
 	branches(session) {
 		return this.branchesFrom(session, []);
 	}
@@ -306,7 +330,7 @@ var Router = class Router {
 	}
 	matchCommand(command, tokenizer, path) {
 		const token = tokenizer.peek();
-		if (typeof token !== "string" || token !== command.name) return;
+		if (typeof token !== "string" || token !== command.name && !command.aliases?.includes(token)) return;
 		tokenizer.next();
 		const params = this.capturePattern(command.pattern, tokenizer);
 		if (params === void 0 || tokenizer.hasNext()) return;
@@ -337,7 +361,7 @@ var Router = class Router {
 		const branches = [];
 		for (const entry of this.entries) switch (entry.type) {
 			case "command":
-				branches.push({
+				if (!entry.command.hidden) branches.push({
 					type: "command",
 					path: [...path],
 					command: entry.command
@@ -359,6 +383,27 @@ var Router = class Router {
 		}
 		return branches;
 	}
+	resolveAliasConflicts(command) {
+		for (const entry of this.entries) {
+			if (entry.type !== "command") continue;
+			const existing = entry.command;
+			if (existing.aliases?.includes(command.name)) {
+				existing.aliases = existing.aliases.filter((a) => a !== command.name);
+				console.warn(`Command "${command.name}" conflicts with alias of existing command "${existing.name}". The alias "${command.name}" has been removed from "${existing.name}".`);
+			}
+			if (command.aliases) {
+				const dropped = [];
+				for (const alias of command.aliases) if (existing.name === alias) {
+					dropped.push(alias);
+					console.warn(`Alias "${alias}" of command "${command.name}" conflicts with existing command name "${existing.name}". The alias has been dropped.`);
+				} else if (existing.aliases?.includes(alias)) {
+					existing.aliases = existing.aliases.filter((a) => a !== alias);
+					console.warn(`Alias "${alias}" of command "${command.name}" conflicts with alias of existing command "${existing.name}". The alias has been removed from "${existing.name}".`);
+				}
+				if (dropped.length > 0) command.aliases = command.aliases.filter((a) => !dropped.includes(a));
+			}
+		}
+	}
 	validatePattern(pattern, options) {
 		const entries = Object.entries(pattern);
 		if (options?.rawPattern && entries.length === 0) throw new Error("Raw pattern must have at least one parameter.");
@@ -681,7 +726,15 @@ and implement the dispose method to clean up resources when the context stops.
 		for (const installedPlugin of sortedPlugins) {
 			const { plugin, args } = installedPlugin;
 			const providedBeforeApply = new Set(this.services.keys());
-			this.logger.debug(`Applying plugin ${plugin.name}`);
+			let debugMessage = `Applying plugin ${plugin.name}`;
+			const requiredServices = [];
+			const providedServices = [];
+			if (plugin.requires) for (const service of plugin.requires) requiredServices.push(service.name);
+			if (plugin.optionalRequires) for (const service of plugin.optionalRequires) requiredServices.push(`${service.name}?`);
+			if (plugin.provides) for (const service of plugin.provides) providedServices.push(service.name);
+			if (requiredServices.length > 0) debugMessage += `, requires: [${requiredServices.join(", ")}]`;
+			if (providedServices.length > 0) debugMessage += `, provides: [${providedServices.join(", ")}]`;
+			this.logger.debug(debugMessage);
 			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.`);
 		}
@@ -780,10 +833,6 @@ and implement the dispose method to clean up resources when the context stops.
 	}
 	createProxyContextForPlugin(plugin) {
 		const proxyLogger = new Logger((message) => this.logHandler?.(message), plugin.name);
-		const proxyProvide = (service, instance) => {
-			this.provide(service, instance);
-			this.logger.debug(`Plugin ${plugin.name} provided ${service.name}`);
-		};
 		let proxyInjections;
 		if (plugin.inject) {
 			proxyInjections = {};
@@ -795,7 +844,6 @@ and implement the dispose method to clean up resources when the context stops.
 		}
 		return new Proxy(this, { get(target, prop, receiver) {
 			if (prop === "logger") return proxyLogger;
-			else if (prop === "provide") return proxyProvide;
 			else if (proxyInjections && prop in proxyInjections) return proxyInjections[prop];
 			else return Reflect.get(target, prop, receiver);
 		} });

package/package.json

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