@chatbi-v/vue 3.0.0 → 3.1.1

package/dist/core/src/api/engine.d.ts

@@ -0,0 +1,101 @@
+import { ApiAdapter, ApiConfig, ApiEndpointConfig, ApiInterceptor, RequestOptions } from '../ports/api-port';
+/**
+ * API 引擎核心类
+ * @description 负责加载配置并执行请求，支持策略模式切换底层请求实现
+ */
+export declare class ApiEngine {
+    private adapter;
+    private config;
+    private interceptors;
+    /** 可配置的成功码 */
+    private successCodes;
+    constructor(adapter?: ApiAdapter);
+    /**
+     * 注册拦截器
+     */
+    registerInterceptor(interceptor: ApiInterceptor): void;
+    /**
+     * 移除拦截器
+     */
+    unregisterInterceptor(interceptor: ApiInterceptor): void;
+    /**
+     * 设置成功码
+     */
+    setSuccessCodes(codes: string[]): void;
+    /**
+     * 切换请求适配器
+     * @param adapter 新的适配器实例
+     */
+    useAdapter(adapter: ApiAdapter): void;
+    /**
+     * 注册 API 配置
+     * @param config 配置对象
+     */
+    register(config: ApiConfig): void;
+    /**
+     * 获取接口配置
+     */
+    getEndpoint(module: string, action: string): ApiEndpointConfig | undefined;
+    /**
+     * 发起 API 请求
+     * @param module 模块名
+     * @param action 动作名
+     * @param data 请求数据 (Body 或 Query)
+     * @param options 请求选项
+     */
+    call<T = any>(module: string, action: string, data?: any, options?: RequestOptions): Promise<T>;
+    /**
+     * 发起流式请求
+     * @param module 模块名
+     * @param action 动作名
+     * @param data 请求数据
+     * @param options 请求选项
+     */
+    stream(module: string, action: string, data?: any, options?: RequestOptions): Promise<void>;
+    /**
+     * 准备请求配置，应用 URL 参数替换和请求拦截器
+     */
+    private prepareRequestConfig;
+    /**
+     * 应用所有请求拦截器
+     */
+    private applyRequestInterceptors;
+    /**
+     * 应用所有响应拦截器
+     * @returns 是否被劫持
+     */
+    private applyResponseInterceptors;
+    /**
+     * 检查 HTTP 状态码
+     */
+    private checkHttpStatus;
+    /**
+     * 提取响应数据
+     */
+    private extractResponseData;
+    /**
+     * 处理业务错误
+     */
+    private handleBusinessError;
+    /**
+     * 检查响应是否成功
+     */
+    protected isSuccess(response: any): boolean;
+    /**
+     * 处理响应错误
+     */
+    protected handleResponseError(response: any, context: any): void;
+    /**
+     * 判断是否为 BaseResponse
+     */
+    private isBaseResponse;
+    /**
+     * 严格判断是否为 AxiosResponse
+     */
+    private isAxiosResponse;
+    /**
+     * 创建拦截上下文
+     */
+    private createInterceptorContext;
+}
+export declare const apiEngine: ApiEngine;

package/dist/core/src/api/index.d.ts

@@ -0,0 +1,5 @@
+export * from './adapters/axios-adapter';
+export * from './engine';
+export * from './utils';
+export * from '../domain/models';
+export * from '../ports/api-port';

package/dist/core/src/api/utils.d.ts

@@ -0,0 +1,14 @@
+import { ApiConfig } from '../ports/api-port';
+/**
+ * 自动检测是否处于 Mock 模式
+ */
+export declare function isMockMode(): boolean;
+/**
+ * 从文件模块映射中解析 API 配置
+ * @description 配合 Vite 的 import.meta.glob 使用，自动匹配定义文件和 Mock 文件
+ * @param definitionsMap API 定义文件映射 (import.meta.glob('./modules/*.ts', { eager: true }))
+ * @param mocksMap Mock 文件映射 (import.meta.glob('./modules/*.mock.ts', { eager: true }))
+ * @param useMock 是否启用 Mock (如果不传，将自动调用 isMockMode())
+ * @returns 合并后的 ApiConfig
+ */
+export declare function resolveApiModules(definitionsMap: Record<string, any>, mocksMap?: Record<string, any>): ApiConfig;

package/dist/core/src/application/service-registry.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 服务注册中心 (Service Registry)
+ * @description 核心应用层服务，作为微内核架构中的“中枢调度员”。
+ * 主要职责：
+ * 1. 服务解耦：允许插件将其内部功能暴露为“服务”，而无需与其他插件产生物理依赖。
+ * 2. 动态发现：提供按名称查找服务的能力，支持服务热插拔。
+ * 3. 依赖协调：通过 `waitFor` 机制解决插件间由于加载顺序导致的初始化依赖问题。
+ *
+ * 建议的服务命名规范: `pluginId.serviceName` (例如: `auth.sessionService`)
+ */
+export declare class ServiceRegistry {
+    /** 存储已注册服务的 Map 对象 */
+    private services;
+    /** 存储正在等待特定服务的监听器集合 */
+    private listeners;
+    /**
+     * 注册一个服务实现
+     * @param name - 唯一的服务名称
+     * @param service - 服务实例或对象
+     */
+    register(name: string, service: any): void;
+    /**
+     * 同步获取服务实例
+     * @template T - 服务类型的泛型
+     * @param name - 服务名称
+     * @returns 服务实例，若不存在则返回 undefined
+     */
+    get<T = any>(name: string): T | undefined;
+    /**
+     * 异步等待并获取服务
+     * @description 如果服务尚未注册，将返回一个 Promise，直到该服务被注册时 resolve。
+     * 支持设置超时时间，防止因插件加载失败导致的永久挂起。
+     *
+     * @template T - 服务类型的泛型
+     * @param name - 待等待的服务名称
+     * @param timeout - 超时时间 (毫秒)，默认 10000ms (10秒)。若为 0 则永不超时。
+     * @returns 包含服务实例的 Promise
+     * @throws {Error} 若在规定时间内服务未注册，则抛出超时异常。
+     */
+    waitFor<T = any>(name: string, timeout?: number): Promise<T>;
+    /**
+     * 检查服务是否已注册
+     * @param name - 服务名称
+     */
+    has(name: string): boolean;
+    /**
+     * 注销特定的服务
+     * @param name - 服务名称
+     */
+    unregister(name: string): void;
+    /**
+     * 清除所有已注册的服务和监听器
+     * @description 通常仅在系统重置或大型热更新时使用。
+     */
+    clear(): void;
+}
+export declare const serviceRegistry: ServiceRegistry;

package/dist/core/src/config-manager.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 配置管理器
+ * @description 核心工具类，负责管理应用的全局系统配置以及各插件的初始化业务配置。
+ * 配置数据通常在应用启动时通过 `usePluginLoader` 注入，并作为插件运行时的取值回退来源。
+ */
+export declare class ConfigManager<T = Record<string, unknown>> {
+    /** 内部存储配置的 Map 对象 */
+    private config;
+    /**
+     * 设置特定的配置项
+     * @param key - 配置键名（如 'system' 或插件 ID）
+     * @param value - 配置内容对象
+     */
+    set<K extends keyof T>(key: K, value: T[K]): void;
+    set(key: string, value: unknown): void;
+    /**
+     * 获取指定的配置项
+     * @param key - 配置键名
+     * @returns 配置内容，若不存在则返回 undefined
+     */
+    get<K extends keyof T>(key: K): T[K] | undefined;
+    get(key: string): unknown;
+    /**
+     * 深度合并配置对象
+     * @description 对配置进行深度合并，嵌套对象会被递归合并而非完全覆盖。
+     * @param config - 待合并的配置对象映射
+     */
+    merge(config: Partial<T> & Record<string, unknown>): void;
+    /**
+     * 深度合并两个对象
+     */
+    private deepMerge;
+    /**
+     * 获取当前存储的所有配置快照
+     * @returns 包含所有配置的普通对象
+     */
+    getAll(): T;
+    /**
+     * 检查配置项是否存在
+     */
+    has(key: string): boolean;
+    /**
+     * 删除指定配置项
+     */
+    delete(key: string): boolean;
+    /**
+     * 清空所有配置
+     */
+    clear(): void;
+}
+/** 全局配置管理器单例 */
+export declare const configManager: ConfigManager<Record<string, unknown>>;

package/dist/core/src/dependency/ConflictResolver.d.ts

@@ -0,0 +1,46 @@
+import type { SharedDependencyResult } from './SharedDepsDetector.js';
+/** 冲突解决结果 */
+export interface ConflictResolution {
+    /** 包 ID */
+    packageId: string;
+    /** 请求的版本列表 */
+    requestedVersions: string[];
+    /** 解析后的版本 */
+    resolvedVersion: string;
+    /** 解决策略 */
+    strategy: 'highest' | 'lowest' | 'user-selected';
+    /** 请求者列表 */
+    requestedBy: string[];
+}
+/**
+ * 版本冲突解决器
+ * @description 使用最高版本策略 (默认) 解决版本冲突
+ */
+export declare class ConflictResolver {
+    /**
+     * 解决版本冲突
+     * @param deps 共享依赖检测结果
+     * @param strategy 解决策略，默认 highest
+     * @returns 冲突解决结果
+     */
+    resolve(deps: SharedDependencyResult[], strategy?: 'highest' | 'lowest'): ConflictResolution[];
+    /**
+     * 使用最高版本策略解决
+     * @param dep 共享依赖
+     * @returns 解决的版本
+     */
+    resolveHighest(dep: SharedDependencyResult): string;
+    /**
+     * 使用最低版本策略解决
+     * @param dep 共享依赖
+     * @returns 解决的版本
+     */
+    resolveLowest(dep: SharedDependencyResult): string;
+    /**
+     * 使用 maxSatisfying 解析版本范围
+     * @param range 版本范围
+     * @param versions 可用版本列表
+     * @returns 满足范围的最高版本
+     */
+    resolveWithRange(range: string, versions: string[]): string | null;
+}

package/dist/core/src/dependency/CycleDetector.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 循环依赖检测
+ * @description 使用 DFS 检测插件依赖中的循环引用，生成警告日志
+ */
+import type { Dependency } from '../manifest/PluginManifest.js';
+/** 插件依赖输入 */
+export interface CycleDetectorInput {
+    id: string;
+    dependencies: Dependency[];
+}
+/** 循环警告 */
+export interface CycleWarning {
+    /** 循环路径 */
+    cycle: string[];
+    /** 完整路径 */
+    path: string[];
+}
+/**
+ * 循环依赖检测器
+ * @description 使用 DFS 检测循环依赖，生成警告但不阻断加载
+ */
+export declare class CycleDetector {
+    /**
+     * 检测循环依赖
+     * @param plugins 插件列表
+     * @returns 循环警告列表
+     */
+    detect(plugins: CycleDetectorInput[]): CycleWarning[];
+    /**
+     * 从依赖图检测循环
+     * @param graph 依赖图
+     * @returns 循环警告列表
+     */
+    detectFromGraph(graph: Map<string, string[]>): CycleWarning[];
+    /**
+     * 生成循环警告消息
+     * @param warning 循环警告
+     * @returns 警告消息
+     */
+    formatWarning(warning: CycleWarning): string;
+    /**
+     * 格式化所有警告
+     * @param warnings 循环警告列表
+     * @returns 警告消息列表
+     */
+    formatWarnings(warnings: CycleWarning[]): string[];
+}

package/dist/core/src/dependency/DependencyGraph.d.ts

@@ -0,0 +1,85 @@
+/**
+ * 依赖图构建器
+ * @description 提供插件依赖拓扑构建、依赖查询功能
+ */
+/** 依赖节点 */
+export interface DependencyNode {
+    /** 节点 ID (插件或包名) */
+    id: string;
+    /** 直接依赖列表 */
+    dependencies: string[];
+    /** 版本 */
+    version: string;
+}
+/** 依赖边 */
+export interface DependencyEdge {
+    from: string;
+    to: string;
+}
+/**
+ * 依赖图
+ * @description 构建和管理插件依赖拓扑
+ */
+export declare class DependencyGraph {
+    private nodes;
+    private edges;
+    /**
+     * 添加依赖节点
+     * @param node 依赖节点
+     */
+    addNode(node: DependencyNode): void;
+    /**
+     * 添加依赖边
+     * @param from 依赖者 ID
+     * @param to 被依赖者 ID
+     */
+    addEdge(from: string, to: string): void;
+    /**
+     * 获取依赖指定包的所有插件
+     * @param packageId 包 ID
+     * @returns 依赖该包的插件列表
+     */
+    getDependents(packageId: string): string[];
+    /**
+     * 获取指定插件的所有依赖
+     * @param pluginId 插件 ID
+     * @returns 依赖列表
+     */
+    getDependencies(pluginId: string): string[];
+    /**
+     * 获取完整依赖图
+     * @returns 节点 ID 到依赖列表的映射
+     */
+    getGraph(): Map<string, string[]>;
+    /**
+     * 获取所有节点
+     * @returns 节点列表
+     */
+    getNodes(): DependencyNode[];
+    /**
+     * 获取所有边
+     * @returns 边列表
+     */
+    getEdges(): DependencyEdge[];
+    /**
+     * 检查节点是否存在
+     * @param id 节点 ID
+     * @returns 是否存在
+     */
+    hasNode(id: string): boolean;
+    /**
+     * 获取节点
+     * @param id 节点 ID
+     * @returns 节点，不存在返回 undefined
+     */
+    getNode(id: string): DependencyNode | undefined;
+    /**
+     * 清空图
+     */
+    clear(): void;
+    /**
+     * 获取图的大小
+     * @returns 节点数量
+     */
+    size(): number;
+}

package/dist/core/src/dependency/NpmRegistry.d.ts

@@ -0,0 +1,78 @@
+/** npm 包元数据 */
+export interface NpmPackageMeta {
+    name: string;
+    versions: Record<string, unknown>;
+    'dist-tags': Record<string, string>;
+    time?: Record<string, string>;
+}
+/** 版本信息 */
+export interface VersionInfo {
+    version: string;
+    date?: string;
+    deprecated?: boolean;
+}
+/**
+ * NPM Registry 客户端
+ * @description 集成 npm Registry API，支持包元数据查询、版本解析和缓存
+ */
+export declare class NpmRegistry {
+    private client;
+    private cache;
+    /**
+     * 创建 NPM Registry 客户端
+     * @param baseUrl Registry 基础 URL，默认 https://registry.npmjs.org
+     */
+    constructor(baseUrl?: string);
+    /**
+     * 获取包元数据
+     * @param packageName 包名
+     * @param useCache 是否使用缓存，默认 true
+     * @returns 包元数据，不存在返回 null
+     */
+    getPackageMeta(packageName: string, useCache?: boolean): Promise<NpmPackageMeta | null>;
+    /**
+     * 获取包的所有版本
+     * @param packageName 包名
+     * @returns 版本列表
+     */
+    getVersions(packageName: string): Promise<string[]>;
+    /**
+     * 获取包的最新版本
+     * @param packageName 包名
+     * @returns 最新版本，不存在返回 null
+     */
+    getLatestVersion(packageName: string): Promise<string | null>;
+    /**
+     * 从版本范围解析最佳版本
+     * @param packageName 包名
+     * @param range 版本范围 (如 ^1.0.0, >=1.0.0)
+     * @returns 满足范围的最高版本，不存在返回 null
+     */
+    resolveVersion(packageName: string, range: string): Promise<string | null>;
+    /**
+     * 获取指定版本的详细信息
+     * @param packageName 包名
+     * @param version 版本号
+     * @returns 版本信息，不存在返回 null
+     */
+    getVersionInfo(packageName: string, version: string): Promise<VersionInfo | null>;
+    /**
+     * 批量解析依赖
+     * @param dependencies 依赖列表 [{ id, version }]
+     * @returns 包名到解析后版本的映射
+     */
+    resolveDependencies(dependencies: Array<{
+        id: string;
+        version: string;
+    }>): Promise<Map<string, string>>;
+    /**
+     * 清除缓存
+     * @param packageName 包名，不提供则清除所有缓存
+     */
+    clearCache(packageName?: string): void;
+}
+/**
+ * 获取默认 Registry 实例
+ * @returns 默认 NpmRegistry 实例
+ */
+export declare function getDefaultRegistry(): NpmRegistry;

package/dist/core/src/dependency/SharedDepsDetector.d.ts

@@ -0,0 +1,49 @@
+import type { Dependency } from '../manifest/PluginManifest.js';
+/** 插件依赖输入 */
+export interface PluginDependencyInput {
+    id: string;
+    dependencies: Dependency[];
+}
+/** 共享依赖检测结果 */
+export interface SharedDependencyResult {
+    /** 包 ID */
+    packageId: string;
+    /** 请求的版本列表 */
+    requestedVersions: string[];
+    /** 解析后的版本 */
+    resolvedVersion: string;
+    /** 请求者列表 */
+    requestedBy: string[];
+    /** 是否有冲突 */
+    hasConflict: boolean;
+}
+/**
+ * 共享依赖检测器
+ * @description 识别多个插件共享的 npm 包，检查版本冲突，使用最高版本策略解决
+ */
+export declare class SharedDepsDetector {
+    /**
+     * 检测共享依赖
+     * @param plugins 插件列表
+     * @returns 共享依赖检测结果
+     */
+    detect(plugins: PluginDependencyInput[]): SharedDependencyResult[];
+    /**
+     * 检查版本是否冲突
+     * @param versions 版本列表
+     * @returns 是否有冲突
+     */
+    private checkConflict;
+    /**
+     * 最高版本策略
+     * @param versions 版本列表
+     * @returns 最高兼容版本
+     */
+    resolveHighest(versions: string[]): string;
+    /**
+     * 最低版本策略
+     * @param versions 版本列表
+     * @returns 最低兼容版本
+     */
+    resolveLowest(versions: string[]): string;
+}

package/dist/core/src/dependency/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 依赖解析模块
+ * @description 提供共享依赖解析系统，包括依赖图构建、共享依赖检测、npm Registry 集成、版本冲突解决和循环依赖检测
+ */
+export * from './ConflictResolver';
+export * from './CycleDetector';
+export * from './DependencyGraph';
+export * from './NpmRegistry';
+export * from './SharedDepsDetector';

package/dist/core/src/domain/auto-loader.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 插件注册表接口
+ * @description 键为插件 ID，值为一个返回插件定义的异步加载函数。
+ */
+export interface PluginRegistry {
+    [pluginId: string]: () => Promise<any>;
+}
+/**
+ * 插件自动发现规则
+ */
+export interface DiscoveryRule {
+    /**
+     * 路径匹配标识。
+     * @example 'plugins' 或 '@chatbi-plugins'
+     */
+    pathSegment: string;
+    /**
+     * 生成插件 ID 时的前缀。
+     * @example '@chatbi-v/plugin'，最终生成如 '@chatbi-v/plugin-demo'
+     */
+    idPrefix: string;
+}
+/**
+ * 解析插件注册表
+ * @description 核心逻辑：将 Vite 的 `import.meta.glob` 结果映射为标准的插件注册表。
+ * 它会根据预定义的路径匹配规则，从文件路径中提取插件目录名，并拼接前缀生成唯一的插件 ID。
+ *
+ * @param options - 包含待处理模块和匹配规则的选项对象
+ * @returns 解析后的 PluginRegistry 对象
+ */
+export declare const resolvePluginRegistry: (options: {
+    /** 原始模块映射 (来自 Vite glob) */
+    modules: Record<string, () => Promise<any>>;
+    /** 自定义发现规则 (可选) */
+    rules?: DiscoveryRule[];
+}) => PluginRegistry;

package/dist/core/src/domain/errors.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @file errors.ts
+ * @description Core 层统一错误处理定义
+ */
+import { createLogger } from '../utils/logger';
+/**
+ * 核心错误码枚举
+ */
+export declare enum CoreErrorCode {
+    UNKNOWN = "1000",
+    NOT_FOUND = "1001",
+    INVALID_PARAMS = "1002",
+    TIMEOUT = "1003",
+    PLUGIN_NOT_FOUND = "2001",
+    PLUGIN_LOAD_FAILED = "2002",
+    PLUGIN_MOUNT_FAILED = "2003",
+    PLUGIN_UNMOUNT_FAILED = "2004",
+    PLUGIN_DEPENDENCY_MISSING = "2005",
+    PLUGIN_CIRCULAR_DEPENDENCY = "2006",
+    PLUGIN_INIT_FAILED = "2007",
+    STORAGE_READ_FAILED = "3001",
+    STORAGE_WRITE_FAILED = "3002",
+    STORAGE_SCHEMA_VIOLATION = "3003",
+    STORAGE_QUOTA_EXCEEDED = "3004",
+    API_REQUEST_FAILED = "4001",
+    API_RESPONSE_INVALID = "4002",
+    API_NETWORK_ERROR = "4003",
+    API_TIMEOUT = "4004",
+    API_UNAUTHORIZED = "4005",
+    SANDBOX_EVAL_FAILED = "5001",
+    SANDBOX_ISOLATION_BREACHED = "5002",
+    SANDBOX_MEMORY_LIMIT = "5003",
+    SERVICE_NOT_FOUND = "6001",
+    SERVICE_REGISTER_FAILED = "6002",
+    SERVICE_WAIT_TIMEOUT = "6003"
+}
+/**
+ * 错误处理策略
+ */
+export declare enum CoreErrorStrategy {
+    THROW = "throw",// 抛出异常
+    RESOLVE = "resolve",// 返回默认值
+    REJECT = "reject",// 返回 Promise reject
+    SILENT = "silent"
+}
+/**
+ * 错误处理选项
+ */
+export interface ErrorHandlerOptions {
+    code: CoreErrorCode;
+    strategy: CoreErrorStrategy;
+    defaultValue?: any;
+    logger?: ReturnType<typeof createLogger>;
+    context?: Record<string, any>;
+}
+/**
+ * 核心错误类
+ */
+export declare class CoreError extends Error {
+    readonly code: CoreErrorCode;
+    readonly originalError?: Error;
+    readonly context?: Record<string, any>;
+    constructor(code: CoreErrorCode, message: string, originalError?: Error, context?: Record<string, any>);
+}
+/**
+ * 统一错误处理函数
+ */
+export declare function handleError(error: unknown, options: ErrorHandlerOptions): any;