@zhin.js/core 1.0.16 → 1.0.18

package/lib/app.d.ts

@@ -1,191 +0,0 @@
-import { SideEffect, GlobalContext, Models } from "@zhin.js/types";
-import { Schema } from '@zhin.js/hmr';
-import { HMR, Context, Logger } from "@zhin.js/hmr";
-import { AdapterMessage, AppConfig, BeforeSendHandler, RegisteredAdapter, SendOptions, MessageMiddleware } from "./types.js";
-import { Config } from "./config.js";
-import { Message } from "./message.js";
-import { PermissionChecker, Permissions } from "./permissions.js";
-import { Plugin } from "./plugin.js";
-import { Adapter } from "./adapter";
-import { MessageCommand } from "./command";
-import { Component } from "./component";
-import { RelatedDatabase, DocumentDatabase, KeyValueDatabase, Definition } from "@zhin.js/database";
-import { SystemLog } from "./models/system-log.js";
-import { User } from "./models/user.js";
-declare module "@zhin.js/types" {
-    interface Models {
-        SystemLog: SystemLog;
-        User: User;
-    }
-}
-/**
- * App类：Zhin.js 应用主入口，负责插件热重载、配置管理、消息分发等。
- * 继承自 HMR，支持插件生命周期、适配器管理、数据库集成等。
- */
-export declare class App extends HMR<Plugin> {
-    #private;
-    static currentPlugin: Plugin;
-    middlewares: MessageMiddleware[];
-    adapters: string[];
-    database?: RelatedDatabase<any, Models> | DocumentDatabase<any, Models> | KeyValueDatabase<any, Models>;
-    permissions: Permissions;
-    private logTransport?;
-    /** 配置变更处理锁 */
-    private configChangeLock;
-    /**
-     * 构造函数：初始化应用，加载配置，注册全局异常处理
-     * @param config 可选，应用配置，若为空则自动查找配置文件
-     */
-    constructor(config: AppConfig);
-    /**
-     * 构造函数：初始化应用，加载配置，注册全局异常处理
-     * @param config_file 可选，配置文件路径，默认为 'zhin.config.yml'
-     */
-    constructor(config_file?: string);
-    /**
-     * 处理配置变更
-     * 如果上一次变更未完成，等待其完成后再处理新的变更
-     */
-    private handleConfigChange;
-    /**
-     * 应用配置变更
-     */
-    private applyConfigChanges;
-    /**
-     * 更新监听目录
-     */
-    private updateWatchDirs;
-    /**
-     * 更新插件加载
-     */
-    private updatePlugins;
-    /**
-     * 卸载插件
-     */
-    private unloadPlugin;
-    receiveMessage<P extends RegisteredAdapter>(message: Message<AdapterMessage<P>>): Promise<void>;
-    messageMiddleware(message: Message, next: () => Promise<void>): Promise<void>;
-    get commands(): MessageCommand<never>[];
-    /** 默认配置 */
-    /**
-     * 默认配置
-     * - plugin_dirs: 插件目录
-     * - plugins: 启用插件
-     * - bots: 机器人配置
-     * - debug: 是否调试模式
-     */
-    static defaultConfig: AppConfig;
-    middleware(middleware: MessageMiddleware): void;
-    /**
-     * 发送消息到指定适配器和机器人
-     * @param options 消息发送参数（包含 context、bot、内容等）
-     * @throws 找不到适配器或机器人时抛出异常
-     */
-    sendMessage(options: SendOptions): Promise<string>;
-    recallMessage(adapter_name: string, bot_name: string, id: string): Promise<void>;
-    /** 同步加载配置文件 */
-    /**
-     * 同步加载配置文件（暂不支持，建议使用异步创建）
-     * @throws 始终抛出异常，提示使用异步方法
-     */
-    static loadConfigSync(): AppConfig;
-    /** 创建插件依赖 */
-    /**
-     * 创建插件依赖
-     * @param name 插件名
-     * @param filePath 插件文件路径
-     */
-    createDependency(name: string, filePath: string): Plugin;
-    /** 获取App配置 */
-    /**
-     * 获取App配置（只读）
-     */
-    getConfig(): Readonly<AppConfig>;
-    getConfig<T extends Config.Paths<AppConfig>>(key: T): Readonly<Config.Value<AppConfig, T>>;
-    setConfig(value: AppConfig): void;
-    setConfig<T extends Config.Paths<AppConfig>>(key: T, value: Config.Value<AppConfig, T>): void;
-    changeSchema(key: string, value: Schema): void;
-    get config(): AppConfig;
-    set config(newConfig: AppConfig);
-    get definitions(): Map<string, Definition<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>;
-}
-export declare namespace App {
-    const schema: Schema<{
-        database?: any;
-        bots?: any[] | undefined;
-        log_level?: number | undefined;
-        log?: {
-            maxDays?: number | undefined;
-            maxRecords?: number | undefined;
-            cleanupInterval?: number | undefined;
-        } | undefined;
-        plugin_dirs?: string[] | undefined;
-        plugins?: string[] | undefined;
-        debug?: boolean | undefined;
-    }, {
-        database?: any;
-        bots?: any[] | undefined;
-        log_level?: number | undefined;
-        log?: {
-            maxDays?: number | undefined;
-            maxRecords?: number | undefined;
-            cleanupInterval?: number | undefined;
-        } | undefined;
-        plugin_dirs?: string[] | undefined;
-        plugins?: string[] | undefined;
-        debug?: boolean | undefined;
-    }>;
-}
-/** 获取App实例 */
-export declare function useApp(): App;
-export declare function defineModel<T extends Record<string, any>>(name: string, schema: Definition<T>): Plugin;
-export declare function addPermit<T extends RegisteredAdapter>(name: string | RegExp, checker: PermissionChecker<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>;
-export declare function defineSchema<S extends Schema>(rules: S): S;
-/** 获取App实例（用于高级操作） */
-export declare function getAppInstance(): App;
-/** 获取插件日志记录器 */
-export declare function useLogger(): Logger;
-/** 创建App实例的工厂函数 */
-export declare function createApp(config_file?: string): Promise<App>;
-//# sourceMappingURL=app.d.ts.map

package/lib/app.d.ts.map

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