@zhin.js/core 1.0.0 → 1.0.2

package/lib/app.d.ts

@@ -0,0 +1,115 @@
+import { SideEffect, GlobalContext, Models } from "@zhin.js/types";
+import { HMR, Context, Logger } from "@zhin.js/hmr";
+import { AdapterMessage, AppConfig, BeforeSendHandler, RegisteredAdapter, SendOptions } from "./types.js";
+import { Message } from "./message.js";
+import { MessageMiddleware, Plugin } from "./plugin.js";
+import { Adapter } from "./adapter";
+import { MessageCommand } from "./command";
+import { Component } from "./component";
+import { RelatedDatabase, DocumentDatabase, KeyValueDatabase, Schema } from "@zhin.js/database";
+/**
+ * App类：Zhin.js 应用主入口，负责插件热重载、配置管理、消息分发等。
+ * 继承自 HMR，支持插件生命周期、适配器管理、数据库集成等。
+ */
+export declare class App extends HMR<Plugin> {
+    static currentPlugin: Plugin;
+    private config;
+    adapters: string[];
+    database?: RelatedDatabase<any, Models> | DocumentDatabase<any, Models> | KeyValueDatabase<any, Models>;
+    /**
+     * 构造函数：初始化应用，加载配置，注册全局异常处理
+     * @param config 可选的应用配置，若为空则自动查找配置文件
+     */
+    constructor(config?: Partial<AppConfig>);
+    /** 默认配置 */
+    /**
+     * 默认配置
+     * - plugin_dirs: 插件目录
+     * - plugins: 启用插件
+     * - bots: 机器人配置
+     * - debug: 是否调试模式
+     */
+    static defaultConfig: AppConfig;
+    /**
+     * 发送消息到指定适配器和机器人
+     * @param options 消息发送参数（包含 context、bot、内容等）
+     * @throws 找不到适配器或机器人时抛出异常
+     */
+    sendMessage(options: SendOptions): Promise<void>;
+    /** 同步加载配置文件 */
+    /**
+     * 同步加载配置文件（暂不支持，建议使用异步创建）
+     * @throws 始终抛出异常，提示使用异步方法
+     */
+    static loadConfigSync(): AppConfig;
+    /** 创建插件依赖 */
+    /**
+     * 创建插件依赖
+     * @param name 插件名
+     * @param filePath 插件文件路径
+     */
+    createDependency(name: string, filePath: string): Plugin;
+    /** 获取App配置 */
+    /**
+     * 获取App配置（只读）
+     */
+    getConfig(): Readonly<AppConfig>;
+    /** 更新App配置 */
+    /**
+     * 更新App配置
+     * @param config 部分配置项，将与现有配置合并
+     */
+    updateConfig(config: Partial<AppConfig>): void;
+    get schemas(): Map<string, Schema<any>>;
+    /** 使用插件 */
+    use(filePath: string): void;
+    /** 启动App */
+    start(mode?: "dev" | "prod"): Promise<void>;
+    /** 停止App */
+    stop(): Promise<void>;
+    getContext<T>(name: string): T;
+    handleBeforeSend(options: SendOptions): Promise<SendOptions>;
+}
+/** 获取App实例 */
+export declare function useApp(): App;
+export declare function defineModel<T extends Record<string, any>>(name: string, schema: Schema<T>): Plugin;
+/** 获取当前插件实例 */
+export declare function usePlugin(): Plugin;
+export declare function beforeSend(handler: BeforeSendHandler): void;
+/** 创建Context */
+export declare function register<T>(context: Context<T, Plugin>): Context<T, Plugin>;
+export declare function registerAdapter<T extends Adapter>(adapter: T): void;
+/** 标记必需的Context */
+export declare function useContext<T extends (keyof GlobalContext)[]>(...args: [...T, sideEffect: SideEffect<T>]): void;
+/** 添加中间件 */
+export declare function addMiddleware(middleware: MessageMiddleware): void;
+export declare function onDatabaseReady(callback: (database: RelatedDatabase<any, Models> | DocumentDatabase<any, Models> | KeyValueDatabase<any, Models>) => PromiseLike<void>): void;
+export declare function useDatabase(): RelatedDatabase<any, Models> | DocumentDatabase<any, Models> | KeyValueDatabase<any, Models> | undefined;
+export declare function onAppReady(callback: () => PromiseLike<void>): void;
+/** 添加指令 */
+export declare function addCommand(command: MessageCommand): void;
+/** 添加组件 */
+export declare function addComponent<P = any>(component: Component<P>): void;
+/** 监听事件 */
+export declare function onEvent(event: string, listener: (...args: any[]) => any): void;
+/** 监听群组消息 */
+export declare function onGroupMessage(handler: (message: Message) => void | Promise<void>): void;
+/** 监听私聊消息 */
+export declare function onPrivateMessage(handler: (message: Message) => void | Promise<void>): void;
+/** 监听所有消息 */
+export declare function onMessage<T extends RegisteredAdapter>(handler: (message: Message<AdapterMessage<T>>) => void | Promise<void>): void;
+/** 获取下一条消息 */
+export declare function usePrompt<P extends RegisteredAdapter>(message: Message<AdapterMessage<P>>): import("./prompt.js").Prompt<P>;
+/** 监听插件挂载事件 */
+export declare function onMounted(hook: (plugin: Plugin) => Promise<void> | void): void;
+/** 监听插件销毁事件 */
+export declare function onDispose(hook: () => void): void;
+/** 发送消息 */
+export declare function sendMessage(options: SendOptions): Promise<void>;
+/** 获取App实例（用于高级操作） */
+export declare function getAppInstance(): App;
+/** 获取插件日志记录器 */
+export declare function useLogger(): Logger;
+/** 创建App实例的工厂函数 */
+export declare function createApp(config?: Partial<AppConfig>): Promise<App>;
+//# sourceMappingURL=app.d.ts.map

package/lib/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"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"}

package/{dist → lib}/app.js

@@ -1,32 +1,43 @@
-import path from 'path';
-import * as fs from 'fs';
-import { HMR, ConsoleLogger, getCallerFile, getCallerFiles } from '@zhin.js/hmr';
-import { loadConfig } from './config.js';
-import { fileURLToPath } from 'url';
-import { generateEnvTypes } from './types-generator.js';
-import { logger } from './logger.js';
+import path from "path";
+import { HMR, getCallerFile, getCallerFiles, } from "@zhin.js/hmr";
+import { fileURLToPath } from "url";
+import { generateEnvTypes } from "./types-generator.js";
+import logger, { setName } from "@zhin.js/logger";
+import { sleep } from "./utils.js";
+// 创建静态logger用于配置加载等静态操作
+setName("Zhin");
 import { Plugin } from "./plugin.js";
+import { Registry } from "@zhin.js/database";
 // ============================================================================
-// App 类
+// App 类（Zhin.js 应用主入口，负责插件热重载、配置管理、消息分发等）
 // ============================================================================
 /**
- * App类：继承自HMR，提供热更新的机器人框架
+ * App类：Zhin.js 应用主入口，负责插件热重载、配置管理、消息分发等。
+ * 继承自 HMR，支持插件生命周期、适配器管理、数据库集成等。
  */
 export class App extends HMR {
     static currentPlugin;
     config;
+    adapters = [];
+    database;
+    /**
+     * 构造函数：初始化应用，加载配置，注册全局异常处理
+     * @param config 可选的应用配置，若为空则自动查找配置文件
+     */
     constructor(config) {
         // 如果没有传入配置或配置为空对象，尝试自动加载配置文件
         let finalConfig;
         if (!config || Object.keys(config).length === 0) {
             try {
                 // 异步加载配置，这里需要改为同步初始化
-                logger.info('🔍 正在查找配置文件...');
+                logger.info("🔍 正在查找配置文件...");
                 finalConfig = App.loadConfigSync();
-                logger.info('✅ 配置文件加载成功');
+                logger.info("✅ 配置文件加载成功");
             }
             catch (error) {
-                logger.warn('⚠️  配置文件加载失败，使用默认配置:', error instanceof Error ? error.message : error);
+                logger.warn("⚠️  配置文件加载失败，使用默认配置", {
+                    error: error instanceof Error ? error.message : String(error),
+                });
                 finalConfig = Object.assign({}, App.defaultConfig);
             }
         }
@@ -35,46 +46,80 @@ export class App extends HMR {
             finalConfig = Object.assign({}, App.defaultConfig, config);
         }
         // 调用父类构造函数
-        super('Zhin', {
-            logger: new ConsoleLogger('[Zhin]'),
+        super("Zhin", {
+            logger,
             dirs: finalConfig.plugin_dirs || [],
-            extensions: new Set(['.js', '.ts']),
-            debug: finalConfig.debug
+            extensions: new Set([".js", ".ts", ".jsx", ".tsx"]),
+            debug: finalConfig.debug,
+        });
+        this.on("message.send", this.sendMessage.bind(this));
+        process.on("uncaughtException", (e) => {
+            this.logger.error(e);
+        });
+        process.on("unhandledRejection", (e) => {
+            this.logger.error(e);
         });
-        this.on('message.send', this.sendMessage.bind(this));
         this.config = finalConfig;
     }
     /** 默认配置 */
+    /**
+     * 默认配置
+     * - plugin_dirs: 插件目录
+     * - plugins: 启用插件
+     * - bots: 机器人配置
+     * - debug: 是否调试模式
+     */
     static defaultConfig = {
-        plugin_dirs: ['./plugins'],
+        plugin_dirs: ["./plugins"],
         plugins: [],
         bots: [],
         debug: false,
     };
+    /**
+     * 发送消息到指定适配器和机器人
+     * @param options 消息发送参数（包含 context、bot、内容等）
+     * @throws 找不到适配器或机器人时抛出异常
+     */
     async sendMessage(options) {
         const adapter = this.getContext(options.context);
         if (!adapter)
             throw new Error(`can't find adapter for name ${options.context}`);
         const bot = adapter.bots.get(options.bot);
         if (!bot)
-            throw new Error(`can't find bot ${options.bot} for adapter ${options.bot}`);
-        return bot.sendMessage(options);
+            throw new Error(`can't find bot ${options.bot} for adapter ${options.context}`);
+        return bot.$sendMessage(options);
     }
     /** 同步加载配置文件 */
+    /**
+     * 同步加载配置文件（暂不支持，建议使用异步创建）
+     * @throws 始终抛出异常，提示使用异步方法
+     */
     static loadConfigSync() {
         // 由于loadConfig是异步的，我们需要创建一个同步版本
         // 或者在这里简化处理，让用户使用异步创建方法
-        throw new Error('同步加载配置暂不支持，请使用 App.createAsync() 方法');
+        throw new Error("同步加载配置暂不支持，请使用 App.createAsync() 方法");
     }
     /** 创建插件依赖 */
+    /**
+     * 创建插件依赖
+     * @param name 插件名
+     * @param filePath 插件文件路径
+     */
     createDependency(name, filePath) {
         return new Plugin(this, name, filePath);
     }
     /** 获取App配置 */
+    /**
+     * 获取App配置（只读）
+     */
     getConfig() {
         return { ...this.config };
     }
     /** 更新App配置 */
+    /**
+     * 更新App配置
+     * @param config 部分配置项，将与现有配置合并
+     */
     updateConfig(config) {
         this.config = { ...this.config, ...config };
         // 更新HMR配置
@@ -95,29 +140,52 @@ export class App extends HMR {
                 }
             }
         }
-        this.logger.info('App configuration updated', this.config);
+        this.logger.info("App configuration updated", this.config);
+    }
+    get schemas() {
+        return this.dependencyList.reduce((result, plugin) => {
+            plugin.schemas.forEach((schema, name) => {
+                result.set(name, schema);
+            });
+            return result;
+        }, new Map());
     }
     /** 使用插件 */
     use(filePath) {
-        this.emit('internal.add', filePath);
+        this.emit("internal.add", filePath);
     }
     /** 启动App */
-    async start(mode = 'prod') {
+    async start(mode = "prod") {
         await generateEnvTypes(process.cwd());
         // 加载插件
         for (const pluginName of this.config.plugins || []) {
             this.use(pluginName);
         }
+        await sleep(200);
+        const schemas = {};
+        for (const [name, schema] of this.schemas) {
+            schemas[name] = schema;
+        }
+        if (this.config.database) {
+            this.database = Registry.create(this.config.database.dialect, this.config.database, schemas);
+            await this.database?.start();
+            this.logger.info(`database init success`);
+        }
+        else {
+            this.logger.info(`database not configured, skipping database init`);
+        }
+        this.dispatch("database.ready", this.database);
         // 等待所有插件就绪
         await this.waitForReady();
-        this.logger.info('started successfully');
+        this.logger.info("started successfully");
+        this.dispatch("app.ready");
     }
     /** 停止App */
     async stop() {
-        this.logger.info('Stopping app...');
+        this.logger.info("Stopping app...");
         // 销毁所有插件
         this.dispose();
-        this.logger.info('App stopped');
+        this.logger.info("App stopped");
     }
     getContext(name) {
         for (const dep of this.dependencyList) {
@@ -134,7 +202,7 @@ export class App extends HMR {
     }
     async handleBeforeSend(options) {
         const handlers = this.dependencyList.reduce((result, plugin) => {
-            result.push(...plugin.listeners('before-message.send'));
+            result.push(...plugin.listeners("before-message.send"));
             return result;
         }, []);
         for (const handler of handlers) {
@@ -144,15 +212,12 @@ export class App extends HMR {
         }
         return options;
     }
-    getLogger(...names) {
-        return new ConsoleLogger(`[${[...names].join('/')}]`, process.env.NODE_ENV === 'development');
-    }
 }
 // ============================================================================
 // Hooks API
 // ============================================================================
 function getPlugin(hmr, filename) {
-    const name = path.basename(filename).replace(path.extname(filename), '');
+    const name = path.basename(filename).replace(path.extname(filename), "");
     // 尝试从当前依赖中查找插件
     const childPlugin = hmr.findChild(filename);
     if (childPlugin) {
@@ -165,47 +230,22 @@ function getPlugin(hmr, filename) {
     parent.dependencies.set(filename, newPlugin);
     return newPlugin;
 }
-export async function createApp(config) {
-    let finalConfig, configPath = '';
-    const envFiles = ['.env', `.env.${process.env.NODE_ENV}`]
-        .filter(filename => fs.existsSync(path.join(process.cwd(), filename)));
-    if (!config || Object.keys(config).length === 0) {
-        try {
-            logger.info('🔍 正在查找配置文件...');
-            [configPath, finalConfig] = await loadConfig();
-            logger.info('✅ 配置文件加载成功');
-        }
-        catch (error) {
-            logger.warn('⚠️  配置文件加载失败，使用默认配置:', error instanceof Error ? error.message : error);
-            finalConfig = Object.assign({}, App.defaultConfig);
-        }
-    }
-    else {
-        finalConfig = Object.assign({}, App.defaultConfig, config);
-    }
-    const app = new App(finalConfig);
-    app.watching(envFiles, () => {
-        process.exit(51);
-    });
-    if (configPath) {
-        app.watching(configPath, () => {
-            process.exit(51);
-        });
-    }
-    return app;
-}
 /** 获取App实例 */
 export function useApp() {
     const hmr = HMR.currentHMR;
     if (!hmr)
-        throw new Error('useApp must be called within a App Context');
+        throw new Error("useApp must be called within a App Context");
     return hmr;
 }
+export function defineModel(name, schema) {
+    const plugin = usePlugin();
+    return plugin.defineModel(name, schema);
+}
 /** 获取当前插件实例 */
 export function usePlugin() {
     const hmr = HMR.currentHMR;
     if (!hmr)
-        throw new Error('usePlugin must be called within a App Context');
+        throw new Error("usePlugin must be called within a App Context");
     try {
         const currentFile = getCallerFile(import.meta.url);
         return getPlugin(hmr, currentFile);
@@ -229,21 +269,19 @@ export function register(context) {
 }
 export function registerAdapter(adapter) {
     const plugin = usePlugin();
+    plugin.app.adapters.push(adapter.name);
     plugin.register({
         name: adapter.name,
+        description: `adapter for ${adapter.name}`,
         async mounted(plugin) {
             await adapter.start(plugin);
             return adapter;
         },
         dispose() {
             return adapter.stop(plugin);
-        }
+        },
     });
 }
-export function use(name) {
-    const plugin = usePlugin();
-    return plugin.use(name);
-}
 /** 标记必需的Context */
 export function useContext(...args) {
     const plugin = usePlugin();
@@ -254,6 +292,32 @@ export function addMiddleware(middleware) {
     const plugin = usePlugin();
     plugin.addMiddleware(middleware);
 }
+export function onDatabaseReady(callback) {
+    const plugin = usePlugin();
+    if (plugin.app.database?.isStarted)
+        callback(plugin.app.database);
+    plugin.on("database.ready", callback);
+}
+export function useDatabase() {
+    const plugin = usePlugin();
+    return plugin.app.database;
+}
+export function onAppReady(callback) {
+    const plugin = usePlugin();
+    if (plugin.app.isReady)
+        callback();
+    plugin.on("app.ready", callback);
+}
+/** 添加指令 */
+export function addCommand(command) {
+    const plugin = usePlugin();
+    plugin.addCommand(command);
+}
+/** 添加组件 */
+export function addComponent(component) {
+    const plugin = usePlugin();
+    plugin.addComponent(component);
+}
 /** 监听事件 */
 export function onEvent(event, listener) {
     const plugin = usePlugin();
@@ -261,34 +325,34 @@ export function onEvent(event, listener) {
 }
 /** 监听群组消息 */
 export function onGroupMessage(handler) {
-    onEvent('message.group.receive', handler);
+    onEvent("message.group.receive", handler);
 }
 /** 监听私聊消息 */
 export function onPrivateMessage(handler) {
-    onEvent('message.private.receive', handler);
+    onEvent("message.private.receive", handler);
 }
 /** 监听所有消息 */
 export function onMessage(handler) {
-    onEvent('message.receive', handler);
+    onEvent("message.receive", handler);
+}
+/** 获取下一条消息 */
+export function usePrompt(message) {
+    const plugin = usePlugin();
+    return plugin.prompt(message);
 }
 /** 监听插件挂载事件 */
 export function onMounted(hook) {
     const plugin = usePlugin();
     if (plugin.isReady)
         hook(plugin);
-    plugin.on('self.mounted', hook);
+    plugin.on("self.mounted", hook);
 }
 /** 监听插件销毁事件 */
 export function onDispose(hook) {
     const plugin = usePlugin();
     if (plugin.isDispose)
         hook();
-    plugin.on('self.dispose', hook);
-}
-/** 添加定时任务 */
-export function addCronJob(job) {
-    const plugin = usePlugin();
-    plugin.addCronJob(job);
+    plugin.on("self.dispose", hook);
 }
 /** 发送消息 */
 export async function sendMessage(options) {
@@ -304,4 +368,10 @@ export function useLogger() {
     const plugin = usePlugin();
     return plugin.logger;
 }
+/** 创建App实例的工厂函数 */
+export async function createApp(config) {
+    const app = new App(config);
+    await app.start();
+    return app;
+}
 //# sourceMappingURL=app.js.map

package/lib/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"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"}

package/lib/bot.d.ts

@@ -0,0 +1,31 @@
+import type { SendOptions } from "./types.js";
+import { Message } from "./message.js";
+/**
+ * Bot接口：所有平台机器人需实现的统一接口。
+ * 负责消息格式化、连接、断开、消息发送等。
+ * @template M 消息类型
+ * @template T 配置类型
+ */
+export interface Bot<M extends object = {}, T extends BotConfig = BotConfig> {
+    /** 机器人配置 */
+    $config: T;
+    /** 是否已连接 */
+    $connected?: boolean;
+    /** 格式化平台消息为标准Message结构 */
+    $formatMessage(message: M): Message<M>;
+    /** 连接机器人 */
+    $connect(): Promise<void>;
+    /** 断开机器人 */
+    $disconnect(): Promise<void>;
+    /** 发送消息 */
+    $sendMessage(options: SendOptions): Promise<void>;
+}
+/**
+ * Bot配置类型，所有平台机器人通用
+ */
+export interface BotConfig {
+    context: string;
+    name: string;
+    [key: string]: any;
+}
+//# sourceMappingURL=bot.d.ts.map

package/lib/bot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../src/bot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,WAAW,EAAe,MAAM,YAAY,CAAC;AAC9E,OAAO,EAAC,OAAO,EAAC,MAAM,cAAc,CAAC;AACrC;;;;;GAKG;AACH,MAAM,WAAW,GAAG,CAAC,CAAC,SAAS,MAAM,GAAC,EAAE,EAAC,CAAC,SAAS,SAAS,GAAC,SAAS;IAClE,YAAY;IACZ,OAAO,EAAE,CAAC,CAAC;IACX,YAAY;IACZ,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0BAA0B;IAC1B,cAAc,CAAC,OAAO,EAAC,CAAC,GAAE,OAAO,CAAC,CAAC,CAAC,CAAA;IACpC,YAAY;IACZ,QAAQ,IAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxB,YAAY;IACZ,WAAW,IAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3B,WAAW;IACX,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACpD;AACD;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,OAAO,EAAC,MAAM,CAAA;IACd,IAAI,EAAC,MAAM,CAAA;IACX,CAAC,GAAG,EAAC,MAAM,GAAE,GAAG,CAAA;CACnB"}

package/lib/command.d.ts

@@ -0,0 +1,32 @@
+import { MatchResult, SegmentMatcher } from "segment-matcher";
+import { AdapterMessage, RegisteredAdapters, SendContent } from "./types.js";
+import type { Message } from "./message.js";
+import { MaybePromise } from "@zhin.js/types";
+/**
+ * MessageCommand类：命令系统核心，基于segment-matcher实现。
+ * 支持多平台命令注册、作用域限制、参数解析、异步处理等。
+ */
+export declare class MessageCommand<T extends keyof RegisteredAdapters = keyof RegisteredAdapters> extends SegmentMatcher {
+    #private;
+    /**
+     * 限定命令作用域（适配器名）
+     * @param scopes 适配器名列表
+     */
+    scope<R extends T>(...scopes: R[]): MessageCommand<R>;
+    /**
+     * 注册命令回调
+     * @param callback 命令处理函数
+     */
+    action(callback: MessageCommand.Callback<T>): MessageCommand<T>;
+    /**
+     * 处理消息，自动匹配命令并执行回调
+     * @param message 消息对象
+     * @returns 命令返回内容或undefined
+     */
+    handle(message: Message<AdapterMessage<T>>): Promise<SendContent | undefined>;
+}
+export declare namespace MessageCommand {
+    type Callback<T extends keyof RegisteredAdapters> = (message: Message<AdapterMessage<T>>, result: MatchResult) => MaybePromise<SendContent | void>;
+    type Checker<T extends keyof RegisteredAdapters> = (message: Message<AdapterMessage<T>>) => MaybePromise<boolean>;
+}
+//# sourceMappingURL=command.d.ts.map

package/lib/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAE,cAAc,EAAC,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAC,cAAc,EAAE,kBAAkB,EAAE,WAAW,EAAC,MAAM,YAAY,CAAC;AAC3E,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAE5C;;;GAGG;AACH,qBAAa,cAAc,CAAC,CAAC,SAAS,MAAM,kBAAkB,GAAC,MAAM,kBAAkB,CAAE,SAAQ,cAAc;;IAG3G;;;OAGG;IACH,KAAK,CAAC,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,EAAC,CAAC,EAAE,GAAE,cAAc,CAAC,CAAC,CAAC;IAInD;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,GAEvB,cAAc,CAAC,CAAC,CAAC;IAEpC;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAE,OAAO,CAAC,WAAW,GAAC,SAAS,CAAC;CAYlF;AACD,yBAAiB,cAAc,CAAA;IAC3B,KAAY,QAAQ,CAAC,CAAC,SAAS,MAAM,kBAAkB,IAAE,CAAC,OAAO,EAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAC,MAAM,EAAC,WAAW,KAAG,YAAY,CAAC,WAAW,GAAC,IAAI,CAAC,CAAC;IACjJ,KAAY,OAAO,CAAC,CAAC,SAAS,MAAM,kBAAkB,IAAE,CAAC,OAAO,EAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,KAAG,YAAY,CAAC,OAAO,CAAC,CAAA;CACtH"}

package/lib/command.js

@@ -0,0 +1,46 @@
+import { SegmentMatcher } from "segment-matcher";
+/**
+ * MessageCommand类：命令系统核心，基于segment-matcher实现。
+ * 支持多平台命令注册、作用域限制、参数解析、异步处理等。
+ */
+export class MessageCommand extends SegmentMatcher {
+    #callbacks = [];
+    #checkers = [];
+    /**
+     * 限定命令作用域（适配器名）
+     * @param scopes 适配器名列表
+     */
+    scope(...scopes) {
+        this.#checkers.push((m) => scopes.includes(m.$adapter));
+        return this;
+    }
+    /**
+     * 注册命令回调
+     * @param callback 命令处理函数
+     */
+    action(callback) {
+        this.#callbacks.push(callback);
+        return this;
+    }
+    /**
+     * 处理消息，自动匹配命令并执行回调
+     * @param message 消息对象
+     * @returns 命令返回内容或undefined
+     */
+    async handle(message) {
+        for (const check of this.#checkers) {
+            const result = await check(message);
+            if (!result)
+                return;
+        }
+        const matched = this.match(message.$content);
+        if (!matched)
+            return;
+        for (const handler of this.#callbacks) {
+            const result = await handler(message, matched);
+            if (result)
+                return result;
+        }
+    }
+}
+//# sourceMappingURL=command.js.map