import Emitter from 'component-emitter';
import { RunningStatus } from './RunningStatus';
import type { ModuleManager } from './ModuleManager';
/**
 * 模块
 * @description 事件列表
 * ```typescript
 * on(event: 'error', listener: (error: Error) => void): Emitter
 * ```
 */
export declare abstract class Module extends Emitter {
    /**
     * 模块管理器
     */
    readonly manager: ModuleManager;
    /**
     * 索引其他模块
     */
    readonly modules: Record<string, Module | undefined>;
    /**
     * 当前模块的运行状态
     */
    readonly status: RunningStatus;
    /**
     * 当前模块的名称（默认是类名）
     */
    get name(): string;
    /**
     * 模块启动时要执行的代码
     * @description
     * 注意：启动过程中出现的错误要通过 Promise.reject() 来处理。
     * 启动之后(运行过程中)出现的错误，要通过 this.emit('error') 来处理。
     * 尽可能多地捕捉异常，然后在 onError 中处理，未捕捉到的异常根据平台的不同可能会导致程序直接被关闭。
     */
    abstract onStart(): Promise<void>;
    /**
     * 模块停止时要执行的代码
     * @description
     * 注意：停止过程中出现的错误要通过 Promise.reject() 来处理。
     */
    onStop(): Promise<void>;
    /**
     * 检查当前模块的运行是否正常（只有模块处于 Running 状态时才会被调用）
     * @description
     * 如果正常直接 Promise.resolve() ，如果异常直接 Promise.reject()
     */
    onHealthCheck(): Promise<void>;
    /**
     * 模块出现异常时要执行的代码
     * @description
     * 当模块发生异常时，该方法会在 ModuleManager 的 on('error') 之前被调用。
     * 注意：该方法只处理模块在运行过程中发生错误（通过 this.emit('error') 触发的错误）。
     * @param err 错误消息
     * @returns
     * 返回 false：错误将不再传递给 ModuleManager。
     *
     * 返回 undefined：错误将触发 ModuleManager 的 error 事件。
     * @throws 新的 Error 将触发 ModuleManager 的 error 事件。
     */
    onError(err: Error): Promise<false | void>;
    emit(event: 'error', error: Error): this;
    emit(event: string, ...args: any[]): this;
}