@vlian/infrastructure 0.9.10

package/dist/types/managers/DictionaryManager/constants.d.ts

@@ -0,0 +1,47 @@
+/**
+ * DictionaryManager 常量定义
+ */
+import { DictionaryEventType } from './types';
+/**
+ * 默认配置值
+ */
+export declare const DEFAULT_OPTIONS: {
+    readonly eventNamespace: "dictionary:";
+    readonly enableEvents: false;
+    readonly dictionaryKeyPrefix: "dictionary:";
+    readonly enablePersistentCache: false;
+    readonly keyField: "key";
+    readonly labelField: "label";
+    readonly enableCache: true;
+    readonly cacheExpiry: undefined;
+    readonly enableIndex: true;
+    readonly concurrencyStrategy: "auto";
+    readonly maxQueueSize: 100;
+    readonly operationTimeout: 30000;
+    readonly enableDiff: true;
+    readonly enableLogging: false;
+    readonly enableMonitoring: false;
+    readonly enableDetailedMetrics: false;
+    readonly isolationMode: "isolated";
+    readonly devMode: boolean;
+    readonly validateConfig: true;
+};
+/**
+ * 生产环境配置覆盖
+ */
+export declare const PRODUCTION_OVERRIDES: {
+    readonly devMode: false;
+    readonly enableDetailedMetrics: false;
+};
+/**
+ * 事件类型映射（用于类型检查）
+ */
+export declare const DICTIONARY_EVENT_TYPES: {
+    readonly DICTIONARY_LOADED: DictionaryEventType.DICTIONARY_LOADED;
+    readonly DICTIONARY_UPDATED: DictionaryEventType.DICTIONARY_UPDATED;
+    readonly DICTIONARY_REFRESHED: DictionaryEventType.DICTIONARY_REFRESHED;
+    readonly DICTIONARY_CACHED: DictionaryEventType.DICTIONARY_CACHED;
+    readonly DICTIONARY_CACHE_CLEARED: DictionaryEventType.DICTIONARY_CACHE_CLEARED;
+    readonly DICTIONARY_PRELOADED: DictionaryEventType.DICTIONARY_PRELOADED;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/managers/DictionaryManager/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/managers/DictionaryManager/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AA6B9C;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;CAyClB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;CAGvB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;CAOzB,CAAC"}

package/dist/types/managers/DictionaryManager/core/CacheManager.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 缓存管理模块
+ * 负责内存缓存管理
+ */
+/**
+ * 缓存管理器
+ */
+export declare class CacheManager<T> {
+    private cache;
+    private defaultTTL?;
+    private maxSize?;
+    private hits;
+    private misses;
+    constructor(options?: {
+        defaultTTL?: number;
+        maxSize?: number;
+    });
+    /**
+     * 获取缓存值
+     */
+    get(key: string): T | null;
+    /**
+     * 设置缓存值
+     */
+    set(key: string, value: T, ttl?: number): void;
+    /**
+     * 检查是否存在
+     */
+    has(key: string): boolean;
+    /**
+     * 删除缓存
+     */
+    delete(key: string): boolean;
+    /**
+     * 清除所有缓存
+     */
+    clear(): void;
+    /**
+     * 获取缓存大小
+     */
+    size(): number;
+    /**
+     * 获取所有键
+     */
+    keys(): string[];
+    /**
+     * 获取最旧的键
+     */
+    private getOldestKey;
+    /**
+     * 获取缓存统计信息
+     */
+    getStatistics(): {
+        size: number;
+        hits: number;
+        misses: number;
+        hitRate: number;
+        keys: string[];
+    };
+    /**
+     * 重置统计信息
+     */
+    resetStatistics(): void;
+}
+//# sourceMappingURL=CacheManager.d.ts.map

package/dist/types/managers/DictionaryManager/core/CacheManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.d.ts","sourceRoot":"","sources":["../../../../../src/managers/DictionaryManager/core/CacheManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH;;GAEG;AACH,qBAAa,YAAY,CAAC,CAAC;IACzB,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;gBAEP,OAAO,CAAC,EAAE;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;IAKD;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAkB1B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAyB9C;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAezB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;IAIhB;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,aAAa,IAAI;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB;IAaD;;OAEG;IACH,eAAe,IAAI,IAAI;CAIxB"}

package/dist/types/managers/DictionaryManager/core/ConcurrencyController.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 并发控制模块
+ * 控制字典管理操作的并发执行
+ * 支持 auto/queue/latest 三种策略
+ */
+/**
+ * 并发控制器
+ */
+export declare class ConcurrencyController {
+    private strategy;
+    private maxQueueSize;
+    private operationTimeout;
+    private queue;
+    private isProcessing;
+    private versionCounter;
+    constructor(options: {
+        strategy: 'auto' | 'queue' | 'latest';
+        maxQueueSize: number;
+        operationTimeout: number;
+    });
+    /**
+     * 执行操作（带并发控制）
+     */
+    execute<T>(operation: () => Promise<T>, operationType?: string): Promise<T>;
+    /**
+     * 根据操作类型选择策略（auto 模式）
+     */
+    private selectStrategy;
+    /**
+     * 处理队列
+     */
+    private processQueue;
+    /**
+     * 执行任务
+     */
+    private executeTask;
+    /**
+     * 清除队列
+     */
+    clear(): void;
+    /**
+     * 获取队列长度
+     */
+    getQueueLength(): number;
+}
+//# sourceMappingURL=ConcurrencyController.d.ts.map

package/dist/types/managers/DictionaryManager/core/ConcurrencyController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConcurrencyController.d.ts","sourceRoot":"","sources":["../../../../../src/managers/DictionaryManager/core/ConcurrencyController.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH;;GAEG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,cAAc,CAAK;gBAEf,OAAO,EAAE;QACnB,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;QACtC,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;KAC1B;IAMD;;OAEG;IACG,OAAO,CAAC,CAAC,EACb,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,CAAC,CAAC;IAoDb;;OAEG;IACH,OAAO,CAAC,cAAc;IAmBtB;;OAEG;YACW,YAAY;IAsC1B;;OAEG;YACW,WAAW;IAczB;;OAEG;IACH,KAAK,IAAI,IAAI;IAgBb;;OAEG;IACH,cAAc,IAAI,MAAM;CAGzB"}

package/dist/types/managers/DictionaryManager/core/DictionaryDataManager.d.ts

@@ -0,0 +1,92 @@
+/**
+ * 字典数据管理模块（Core 层）
+ * 负责字典数据的获取、更新、缓存管理
+ */
+import type { DictionaryItem, DictionaryData } from '../types';
+import { CacheManager } from './CacheManager';
+import { StateManagerWrapper } from './StateManagerWrapper';
+import { IndexManager } from './IndexManager';
+import { DictionaryValidator } from './DictionaryValidator';
+import { StorageManager } from '../modules/StorageManager';
+/**
+ * 字典数据管理器
+ */
+export declare class DictionaryDataManager<TDictionaryItem = DictionaryItem> {
+    private cacheManager;
+    private stateManager?;
+    private storageManager?;
+    private indexManager;
+    private validator;
+    private dictionaryFetcher?;
+    private dictionariesFetcher?;
+    private dictionaryConfig?;
+    private enableCache;
+    private enablePersistentCache;
+    private cacheExpiry?;
+    private dictionaryKeyPrefix;
+    constructor(options: {
+        cacheManager: CacheManager<DictionaryData<TDictionaryItem>>;
+        stateManager?: StateManagerWrapper;
+        storageManager?: StorageManager;
+        indexManager: IndexManager<TDictionaryItem>;
+        validator: DictionaryValidator<TDictionaryItem>;
+        dictionaryFetcher?: (code: string) => Promise<TDictionaryItem[]>;
+        dictionariesFetcher?: (codes: string[]) => Promise<Record<string, TDictionaryItem[]>>;
+        dictionaryConfig?: Record<string, TDictionaryItem[]>;
+        enableCache: boolean;
+        enablePersistentCache: boolean;
+        cacheExpiry?: number;
+        dictionaryKeyPrefix: string;
+    });
+    /**
+     * 获取字典数据（异步）
+     */
+    getDictionary(code: string, options?: {
+        force?: boolean;
+        usePersistentCache?: boolean;
+    }): Promise<TDictionaryItem[]>;
+    /**
+     * 获取字典数据（同步，仅读取缓存）
+     */
+    getDictionarySync(code: string): TDictionaryItem[] | null;
+    /**
+     * 从缓存获取字典数据
+     */
+    private getDictionaryFromCache;
+    /**
+     * 设置字典数据
+     * @returns 返回旧数据和新数据，用于 Diff 计算
+     */
+    setDictionary(code: string, items: TDictionaryItem[], usePersistentCache: boolean): Promise<{
+        oldItems: TDictionaryItem[];
+        newItems: TDictionaryItem[];
+    }>;
+    /**
+     * 获取字典数据对象（包含索引）
+     */
+    getDictionaryData(code: string): DictionaryData<TDictionaryItem> | null;
+    /**
+     * 批量获取字典数据（异步）
+     */
+    getDictionaries(codes: string[], options?: {
+        force?: boolean;
+        usePersistentCache?: boolean;
+    }): Promise<Record<string, TDictionaryItem[]>>;
+    /**
+     * 批量获取字典数据（同步，仅读取缓存）
+     */
+    getDictionariesSync(codes: string[]): Record<string, TDictionaryItem[]>;
+    /**
+     * 清除字典缓存
+     */
+    clearCache(code?: string): Promise<void>;
+    /**
+     * 获取缓存键
+     */
+    private getCacheKey;
+    /**
+     * 获取可用字典列表（从缓存）
+     */
+    getAvailableDictionariesSync(): string[];
+}
+//# sourceMappingURL=DictionaryDataManager.d.ts.map

package/dist/types/managers/DictionaryManager/core/DictionaryDataManager.d.ts.map

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

package/dist/types/managers/DictionaryManager/core/DictionaryValidator.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 字典数据验证模块
+ * 验证字典数据的有效性
+ */
+/**
+ * 字典验证器
+ */
+export declare class DictionaryValidator<TDictionaryItem> {
+    private validator?;
+    constructor(options?: {
+        validator?: (data: TDictionaryItem[]) => true | string;
+    });
+    /**
+     * 验证字典数据
+     */
+    validate(data: TDictionaryItem[]): {
+        valid: boolean;
+        error?: string;
+    };
+    /**
+     * 基本验证
+     */
+    private basicValidate;
+}
+//# sourceMappingURL=DictionaryValidator.d.ts.map

package/dist/types/managers/DictionaryManager/core/DictionaryValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DictionaryValidator.d.ts","sourceRoot":"","sources":["../../../../../src/managers/DictionaryManager/core/DictionaryValidator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,qBAAa,mBAAmB,CAAC,eAAe;IAC9C,OAAO,CAAC,SAAS,CAAC,CAA6C;gBAEnD,OAAO,CAAC,EAAE;QACpB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,IAAI,GAAG,MAAM,CAAC;KACxD;IAID;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAkBrE;;OAEG;IACH,OAAO,CAAC,aAAa;CAUtB"}

package/dist/types/managers/DictionaryManager/core/DiffCalculator.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 差异计算模块
+ * 计算字典数据的差异信息（added、removed、changed）
+ */
+/**
+ * 字典差异信息
+ */
+export interface DictionaryDiff<TDictionaryItem> {
+    added: TDictionaryItem[];
+    removed: TDictionaryItem[];
+    changed: Array<{
+        before: TDictionaryItem;
+        after: TDictionaryItem;
+    }>;
+}
+/**
+ * 差异计算器
+ */
+export declare class DiffCalculator<TDictionaryItem> {
+    private itemChangeDetector;
+    private indexKeyField;
+    constructor(options: {
+        itemComparator?: (item1: TDictionaryItem, item2: TDictionaryItem) => boolean;
+        itemChangeDetector?: (before: TDictionaryItem, after: TDictionaryItem) => boolean;
+        indexKeyField: string | ((item: TDictionaryItem) => string);
+    });
+    /**
+     * 计算字典差异
+     */
+    calculateDiff(newItems: TDictionaryItem[], oldItems: TDictionaryItem[]): DictionaryDiff<TDictionaryItem>;
+    /**
+     * 获取索引键
+     */
+    private getIndexKey;
+}
+//# sourceMappingURL=DiffCalculator.d.ts.map

package/dist/types/managers/DictionaryManager/core/DiffCalculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiffCalculator.d.ts","sourceRoot":"","sources":["../../../../../src/managers/DictionaryManager/core/DiffCalculator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,eAAe;IAC7C,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,OAAO,EAAE,KAAK,CAAC;QACb,MAAM,EAAE,eAAe,CAAC;QACxB,KAAK,EAAE,eAAe,CAAC;KACxB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,qBAAa,cAAc,CAAC,eAAe;IACzC,OAAO,CAAC,kBAAkB,CAA+D;IACzF,OAAO,CAAC,aAAa,CAA+C;gBAExD,OAAO,EAAE;QACnB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC;QAC7E,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC;QAClF,aAAa,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,eAAe,KAAK,MAAM,CAAC,CAAC;KAC7D;IASD;;OAEG;IACH,aAAa,CACX,QAAQ,EAAE,eAAe,EAAE,EAC3B,QAAQ,EAAE,eAAe,EAAE,GAC1B,cAAc,CAAC,eAAe,CAAC;IA4DlC;;OAEG;IACH,OAAO,CAAC,WAAW;CAapB"}

package/dist/types/managers/DictionaryManager/core/IndexManager.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 索引管理模块
+ * 管理字典项的 Map 索引，提升查询性能
+ */
+/**
+ * 索引管理器
+ */
+export declare class IndexManager<TDictionaryItem> {
+    private indexKeyField;
+    private enableIndex;
+    constructor(options: {
+        indexKeyField?: string | ((item: TDictionaryItem) => string);
+        keyField: string;
+        enableIndex: boolean;
+    });
+    /**
+     * 构建索引
+     */
+    buildIndex(items: TDictionaryItem[]): Map<string, TDictionaryItem>;
+    /**
+     * 更新索引（增量更新）
+     */
+    updateIndex(index: Map<string, TDictionaryItem>, added: TDictionaryItem[], removed: TDictionaryItem[], changed?: Array<{
+        before: TDictionaryItem;
+        after: TDictionaryItem;
+    }>): void;
+    /**
+     * 获取索引键
+     */
+    private getIndexKey;
+    /**
+     * 通过索引键获取字典项
+     */
+    getItemByIndex(index: Map<string, TDictionaryItem>, indexKey: string): TDictionaryItem | null;
+}
+//# sourceMappingURL=IndexManager.d.ts.map

package/dist/types/managers/DictionaryManager/core/IndexManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexManager.d.ts","sourceRoot":"","sources":["../../../../../src/managers/DictionaryManager/core/IndexManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,qBAAa,YAAY,CAAC,eAAe;IACvC,OAAO,CAAC,aAAa,CAA+C;IACpE,OAAO,CAAC,WAAW,CAAU;gBAEjB,OAAO,EAAE;QACnB,aAAa,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,eAAe,KAAK,MAAM,CAAC,CAAC;QAC7D,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,OAAO,CAAC;KACtB;IAYD;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC;IAiBlE;;OAEG;IACH,WAAW,CACT,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,EACnC,KAAK,EAAE,eAAe,EAAE,EACxB,OAAO,EAAE,eAAe,EAAE,EAC1B,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,eAAe,CAAC;QAAC,KAAK,EAAE,eAAe,CAAA;KAAE,CAAC,GACnE,IAAI;IAwCP;;OAEG;IACH,OAAO,CAAC,WAAW;IAcnB;;OAEG;IACH,cAAc,CACZ,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,EACnC,QAAQ,EAAE,MAAM,GACf,eAAe,GAAG,IAAI;CAO1B"}

package/dist/types/managers/DictionaryManager/core/StateManagerWrapper.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 状态管理封装模块
+ * 封装 @vlian/framework StateManager，负责状态管理实例初始化
+ */
+import type { StateManagerInstance } from '../types';
+/**
+ * 状态管理器封装
+ */
+export declare class StateManagerWrapper {
+    private stateManager;
+    private namespace;
+    private logger?;
+    private memoryStore;
+    private subscribers;
+    constructor(options: {
+        stateManager?: {
+            instance?: StateManagerInstance;
+            namespace?: string;
+        };
+        logger?: {
+            warn: (message: string, ...args: unknown[]) => void;
+            error: (message: string, ...args: unknown[]) => void;
+        };
+    });
+    /**
+     * 初始化状态管理实例
+     */
+    private initStateManager;
+    /**
+     * 获取键名（带命名空间）
+     */
+    private getKey;
+    /**
+     * 获取值
+     */
+    get<T>(key: string): T | null;
+    /**
+     * 设置值
+     */
+    set<T>(key: string, value: T): void;
+    /**
+     * 删除值
+     */
+    remove(key: string): void;
+    /**
+     * 订阅值变化
+     */
+    subscribe<T>(key: string, callback: (value: T) => void): () => void;
+}
+//# sourceMappingURL=StateManagerWrapper.d.ts.map

package/dist/types/managers/DictionaryManager/core/StateManagerWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateManagerWrapper.d.ts","sourceRoot":"","sources":["../../../../../src/managers/DictionaryManager/core/StateManagerWrapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,YAAY,CAAqC;IACzD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAC,CAAgH;IAG/H,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,WAAW,CAAyD;gBAG1E,OAAO,EAAE;QACP,YAAY,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,oBAAoB,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACvE,MAAM,CAAC,EAAE;YAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;YAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;SAAE,CAAC;KACxH;IAOH;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuCxB;;OAEG;IACH,OAAO,CAAC,MAAM;IAId;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAY7B;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAuBnC;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAWzB;;OAEG;IACH,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;CAwBpE"}

package/dist/types/managers/DictionaryManager/core/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 核心层导出
+ */
+export { CacheManager } from './CacheManager';
+export { ConcurrencyController } from './ConcurrencyController';
+export { IndexManager } from './IndexManager';
+export { DiffCalculator } from './DiffCalculator';
+export { DictionaryValidator } from './DictionaryValidator';
+export { StateManagerWrapper } from './StateManagerWrapper';
+export { DictionaryDataManager } from './DictionaryDataManager';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/managers/DictionaryManager/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/managers/DictionaryManager/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/types/managers/DictionaryManager/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * DictionaryManager 导出文件
+ */
+export { DictionaryManager } from './DictionaryManager';
+export type { DictionaryOptions, DictionaryItem, DictionaryData, GetDictionaryOptions, GetDictionarySyncOptions, FormatDictionaryOptions, DictionaryValueQuery, PreloadStatus, HealthCheckResult, PerformanceMetrics, CacheStatistics, DictionaryDiff, DictionaryLoadedEventData, DictionaryUpdatedEventData, EventMetadata, EventListenerOptions, AppEventBus, Logger, MonitoringService, StorageInstance, StateManagerInstance, StorageStrategy, Environment, } from './types';
+export { DictionaryError, DictionaryErrorCode, DictionaryEventType, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/managers/DictionaryManager/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/managers/DictionaryManager/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,yBAAyB,EACzB,0BAA0B,EAC1B,aAAa,EACb,oBAAoB,EACpB,WAAW,EACX,MAAM,EACN,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,WAAW,GACZ,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,SAAS,CAAC"}

package/dist/types/managers/DictionaryManager/modules/EnvironmentDetector.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 环境检测模块
+ */
+import type { Environment } from '../types';
+/**
+ * 环境检测器
+ */
+export declare class EnvironmentDetector {
+    /**
+     * 检测运行环境
+     */
+    static detectEnvironment(): Environment;
+    /**
+     * 检查是否为生产环境
+     */
+    static checkIsProduction(): boolean;
+}
+//# sourceMappingURL=EnvironmentDetector.d.ts.map

package/dist/types/managers/DictionaryManager/modules/EnvironmentDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvironmentDetector.d.ts","sourceRoot":"","sources":["../../../../../src/managers/DictionaryManager/modules/EnvironmentDetector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;GAEG;AACH,qBAAa,mBAAmB;IAC9B;;OAEG;IACH,MAAM,CAAC,iBAAiB,IAAI,WAAW;IA+BvC;;OAEG;IACH,MAAM,CAAC,iBAAiB,IAAI,OAAO;CAapC"}

package/dist/types/managers/DictionaryManager/modules/ErrorHandler.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 错误处理模块
+ * 使用 @vlian/framework Logger 和 MonitoringService 进行错误处理
+ */
+import type { Logger, MonitoringService } from '../types';
+import { DictionaryError } from '../types';
+/**
+ * 错误处理器
+ */
+export declare class ErrorHandler {
+    private logger?;
+    private monitoring?;
+    private sanitizeErrors;
+    constructor(options?: {
+        logger?: Logger;
+        monitoring?: MonitoringService;
+        sanitizeErrors?: boolean;
+    });
+    /**
+     * 处理错误
+     */
+    handleError(error: unknown, context?: {
+        operation?: string;
+        [key: string]: unknown;
+    }): DictionaryError;
+    /**
+     * 标准化错误
+     */
+    private normalizeError;
+    /**
+     * 记录错误日志
+     */
+    private logError;
+    /**
+     * 上报错误到监控服务
+     */
+    private reportError;
+    /**
+     * 脱敏错误消息
+     */
+    private sanitizeErrorMessage;
+}
+//# sourceMappingURL=ErrorHandler.d.ts.map

package/dist/types/managers/DictionaryManager/modules/ErrorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorHandler.d.ts","sourceRoot":"","sources":["../../../../../src/managers/DictionaryManager/modules/ErrorHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAuB,MAAM,UAAU,CAAC;AAEhE;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,UAAU,CAAC,CAAoB;IACvC,OAAO,CAAC,cAAc,CAAU;gBAEpB,OAAO,CAAC,EAAE;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,iBAAiB,CAAC;QAC/B,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B;IAMD;;OAEG;IACH,WAAW,CACT,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,GACA,eAAe;IAelB;;OAEG;IACH,OAAO,CAAC,cAAc;IAsCtB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAiBhB;;OAEG;IACH,OAAO,CAAC,WAAW;IAenB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAO7B"}

package/dist/types/managers/DictionaryManager/modules/StorageManager.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 存储管理模块
+ * 封装 @vlian/framework Storage，负责存储实例初始化
+ */
+import type { StorageInstance, StorageStrategy, Environment } from '../types';
+/**
+ * 存储管理器
+ */
+export declare class StorageManager {
+    private storage;
+    private environment;
+    private logger?;
+    private static storageCache;
+    constructor(options: {
+        storage: {
+            instance?: StorageInstance;
+            strategy?: StorageStrategy;
+        };
+        environment: Environment;
+        logger?: {
+            warn: (message: string, ...args: unknown[]) => void;
+            error: (message: string, ...args: unknown[]) => void;
+        };
+    });
+    /**
+     * 初始化存储实例（带缓存优化）
+     */
+    private initStorage;
+    /**
+     * 获取存储实例
+     */
+    getStorage(): StorageInstance;
+    /**
+     * 获取值
+     */
+    get(key: string): Promise<string | null>;
+    /**
+     * 设置值
+     */
+    set(key: string, value: string): Promise<void>;
+    /**
+     * 删除值
+     */
+    remove(key: string): Promise<void>;
+}
+//# sourceMappingURL=StorageManager.d.ts.map

package/dist/types/managers/DictionaryManager/modules/StorageManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageManager.d.ts","sourceRoot":"","sources":["../../../../../src/managers/DictionaryManager/modules/StorageManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG9E;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,MAAM,CAAC,CAAgH;IAG/H,OAAO,CAAC,MAAM,CAAC,YAAY,CAA2C;gBAGpE,OAAO,EAAE;QACP,OAAO,EAAE;YAAE,QAAQ,CAAC,EAAE,eAAe,CAAC;YAAC,QAAQ,CAAC,EAAE,eAAe,CAAA;SAAE,CAAC;QACpE,WAAW,EAAE,WAAW,CAAC;QACzB,MAAM,CAAC,EAAE;YAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;YAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;SAAE,CAAC;KACxH;IAOH;;OAEG;IACH,OAAO,CAAC,WAAW;IAwHnB;;OAEG;IACH,UAAU,IAAI,eAAe;IAI7B;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI9C;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGzC"}

package/dist/types/managers/DictionaryManager/modules/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 公共模块导出
+ */
+export { EnvironmentDetector } from './EnvironmentDetector';
+export { ErrorHandler } from './ErrorHandler';
+export { StorageManager } from './StorageManager';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/managers/DictionaryManager/modules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/managers/DictionaryManager/modules/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}