import type { Client } from "basic-ftp";
import type { Workbook as ExcelJSWorkbook } from "exceljs";
import { WindowsDriver } from "../driver/windows/windows-driver";
import type { AutomationDriver } from "../driver/types";

/** 人为拟真操作的开关与随机参数（desktop 能力的进程级设置）。 */
export interface ManualOperationSettings {
  enabled: boolean;
  randomMove: boolean;
  randomClick: boolean;
  randomSleep: boolean;
  minMs: number;
  maxMs: number;
}

/**
 * 引擎实例状态容器（任务 1.3，R4：模块级全局状态收拢）。
 *
 * 折中方案（决策记录 2026-11-04）：能力文件的 register() 调用与全局注册表保持不变，
 * 但 Excel 缓存、数据库连接、FTP 客户端等进程级可变状态统一挂到引擎实例上。
 * 包内各能力模块通过 defaultEngine 访问；宿主/CLI 可用 createEngine() 产生隔离实例，
 * 或拿到 defaultEngine 做测试间重置。
 */
export class RpaEngine {
  /** excel-store：路径 → ExcelJS 工作簿共享缓存 */
  readonly excelCache = new Map<string, ExcelJSWorkbook>();
  /** office.ts：Excel 句柄 id → 工作簿 */
  readonly excelHandles = new Map<string, ExcelJSWorkbook>();
  /** remaining-core：连接 id → 数据库连接（mysql2/pg/mssql） */
  readonly dbConnections = new Map<string, unknown>();
  /** ftp.ts：当前 FTP 连接 */
  ftpClient?: Client;
  /** ocr-caps.ts：懒加载的 OCR 实例 */
  ocrInstance?: unknown;
  /** desktop.ts：人为拟真操作设置 */
  manualOperation: ManualOperationSettings = {
    enabled: false,
    randomMove: true,
    randomClick: true,
    randomSleep: true,
    minMs: 1000,
    maxMs: 3000
  };
  /** 桌面自动化驱动（任务 3.4 注入点，默认 PowerShell 版 WindowsDriver） */
  readonly driver: AutomationDriver = new WindowsDriver();
}

export function createEngine(): RpaEngine {
  return new RpaEngine();
}

/** 能力模块内部使用的默认引擎实例（与全局注册表配套的进程级单例）。 */
export const defaultEngine = createEngine();