@vlian/infrastructure 0.9.10

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

@@ -0,0 +1,462 @@
+/**
+ * DictionaryManager 类型定义
+ * 完全泛型化的字典管理类型
+ */
+/**
+ * @vlian/framework AppEventBus 类型声明
+ */
+export interface AppEventBus {
+    on<T = unknown>(event: string, listener: (data: T, metadata: EventMetadata) => void | Promise<void>, options?: EventListenerOptions): () => void;
+    off<T = unknown>(event: string, listener?: (data: T, metadata: EventMetadata) => void | Promise<void>): void;
+    once<T = unknown>(event: string, listener: (data: T, metadata: EventMetadata) => void | Promise<void>, options?: Omit<EventListenerOptions, 'once'>): () => void;
+    emit<T = unknown>(event: string, data: T, metadata?: Partial<EventMetadata>): void | Promise<void>;
+}
+/**
+ * @vlian/framework Logger 类型声明
+ */
+export interface Logger {
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    debug(message: string, ...args: unknown[]): void;
+}
+/**
+ * @vlian/framework MonitoringService 类型声明
+ */
+export interface MonitoringService {
+    captureError(error: unknown, context?: Record<string, unknown>): void;
+    trackEvent(eventName: string, properties?: Record<string, unknown>): void;
+    reportPerformance(metrics: Record<string, number>, context?: Record<string, unknown>): void;
+}
+/**
+ * @vlian/framework StorageInstance 类型声明
+ */
+export interface StorageInstance {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string): Promise<void>;
+    remove(key: string): Promise<void>;
+}
+/**
+ * @vlian/framework StateManagerInstance 类型声明
+ */
+export interface StateManagerInstance {
+    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;
+}
+/**
+ * 存储策略
+ */
+export type StorageStrategy = 'local' | 'session' | 'indexedDB' | 'memory';
+/**
+ * 环境类型
+ */
+export type Environment = 'browser' | 'node' | 'ssr' | 'worker' | 'unknown';
+/**
+ * 默认字典项接口（可选，用户可自定义）
+ */
+export interface DictionaryItem {
+    /**
+     * 字典键值
+     */
+    key: string | number;
+    /**
+     * 字典值文本
+     */
+    label: string;
+    /**
+     * 字典值（可选，通常与 key 相同）
+     */
+    value?: string | number;
+    /**
+     * 排序顺序（可选）
+     */
+    order?: number;
+    /**
+     * 是否禁用（可选）
+     */
+    disabled?: boolean;
+    /**
+     * 扩展属性（可选）
+     */
+    [key: string]: unknown;
+}
+/**
+ * 字典数据
+ * @template TDictionaryItem 字典项类型，完全由用户定义
+ */
+export interface DictionaryData<TDictionaryItem = DictionaryItem> {
+    /**
+     * 字典编码
+     */
+    code: string;
+    /**
+     * 字典项数组
+     */
+    items: TDictionaryItem[];
+    /**
+     * 字典项索引（可选，启用索引时自动维护）
+     * Map<索引键, 字典项>
+     */
+    index?: Map<string, TDictionaryItem>;
+    /**
+     * 数据更新时间戳
+     */
+    updatedAt?: number;
+    /**
+     * 数据过期时间戳（可选）
+     */
+    expiresAt?: number;
+}
+/**
+ * 字典事件类型枚举
+ */
+export declare enum DictionaryEventType {
+    DICTIONARY_LOADED = "dictionary:loaded",
+    DICTIONARY_UPDATED = "dictionary:updated",
+    DICTIONARY_REFRESHED = "dictionary:refreshed",
+    DICTIONARY_CACHED = "dictionary:cached",
+    DICTIONARY_CACHE_CLEARED = "dictionary:cache:cleared",
+    DICTIONARY_PRELOADED = "dictionary:preloaded"
+}
+/**
+ * 事件元数据
+ */
+export interface EventMetadata {
+    timestamp: number;
+    instanceId?: string;
+    traceId?: string;
+    eventType?: string;
+}
+/**
+ * 事件监听器选项
+ */
+export interface EventListenerOptions {
+    once?: boolean;
+    priority?: number;
+}
+/**
+ * 字典加载事件数据
+ */
+export interface DictionaryLoadedEventData<TDictionaryItem = DictionaryItem> {
+    code: string;
+    items: TDictionaryItem[];
+    timestamp: number;
+}
+/**
+ * 字典更新事件数据（包含 Diff 信息）
+ */
+export interface DictionaryUpdatedEventData<TDictionaryItem = DictionaryItem> {
+    code: string;
+    items: TDictionaryItem[];
+    previousItems?: TDictionaryItem[];
+    diff: DictionaryDiff<TDictionaryItem>;
+    timestamp: number;
+}
+/**
+ * 字典差异信息
+ * @template TDictionaryItem 字典项类型
+ */
+export interface DictionaryDiff<TDictionaryItem = DictionaryItem> {
+    /**
+     * 新增的字典项
+     */
+    added: TDictionaryItem[];
+    /**
+     * 删除的字典项
+     */
+    removed: TDictionaryItem[];
+    /**
+     * 变更的字典项（包含变更前后的值）
+     */
+    changed: Array<{
+        before: TDictionaryItem;
+        after: TDictionaryItem;
+    }>;
+}
+/**
+ * DictionaryManager 配置选项
+ * @template TDictionaryItem 字典项类型，完全由用户定义
+ */
+export interface DictionaryOptions<TDictionaryItem = DictionaryItem> {
+    /**
+     * @vlian/framework Storage 配置（可选）
+     * 用于字典数据持久化缓存
+     */
+    storage?: {
+        instance?: StorageInstance;
+        strategy?: StorageStrategy;
+    };
+    /**
+     * @vlian/framework StateManager 配置（可选）
+     * 用于字典数据状态管理，支持跨组件共享
+     */
+    stateManager?: {
+        instance?: StateManagerInstance;
+        namespace?: string;
+    };
+    /**
+     * 是否启用日志（默认：false）
+     */
+    enableLogging?: boolean;
+    /**
+     * @vlian/framework Logger 实例（可选）
+     */
+    logger?: Logger;
+    /**
+     * 是否启用监控（默认：false）
+     */
+    enableMonitoring?: boolean;
+    /**
+     * @vlian/framework MonitoringService 实例（可选）
+     */
+    monitoring?: MonitoringService;
+    /**
+     * 是否启用事件（默认：false）
+     */
+    enableEvents?: boolean;
+    /**
+     * @vlian/framework AppEventBus 实例（可选）
+     */
+    eventBus?: AppEventBus;
+    /**
+     * 实例隔离模式（默认：'isolated'）
+     */
+    isolationMode?: 'isolated' | 'shared' | 'hybrid';
+    /**
+     * 字典数据获取函数（可选）
+     */
+    dictionaryFetcher?: (code: string) => Promise<TDictionaryItem[]>;
+    /**
+     * 字典数据获取函数（批量版本，可选）
+     */
+    dictionariesFetcher?: (codes: string[]) => Promise<Record<string, TDictionaryItem[]>>;
+    /**
+     * 字典数据配置（可选）
+     * 静态字典数据配置
+     */
+    dictionaryConfig?: Record<string, TDictionaryItem[]>;
+    /**
+     * 字典数据存储键名前缀（默认：'dictionary:'）
+     */
+    dictionaryKeyPrefix?: string;
+    /**
+     * 是否启用持久化缓存（默认：false）
+     */
+    enablePersistentCache?: boolean;
+    /**
+     * 事件命名空间前缀（默认：'dictionary:'）
+     */
+    eventNamespace?: string;
+    /**
+     * 字典数据验证函数（可选）
+     */
+    dictionaryValidator?: (data: TDictionaryItem[]) => true | string;
+    /**
+     * 字典值格式化函数（可选）
+     */
+    formatter?: (item: TDictionaryItem, value: string | number) => string;
+    /**
+     * 字典值键名配置（可选）
+     * 默认：'key'
+     */
+    keyField?: string;
+    /**
+     * 字典值文本键名配置（可选）
+     * 默认：'label'
+     */
+    labelField?: string;
+    /**
+     * 是否启用字典数据缓存（默认：true）
+     */
+    enableCache?: boolean;
+    /**
+     * 缓存过期时间（毫秒，默认：不过期）
+     */
+    cacheExpiry?: number;
+    /**
+     * 预加载字典列表（可选）
+     */
+    preloadDictionaries?: string[];
+    /**
+     * 是否启用详细性能指标（默认：false）
+     */
+    enableDetailedMetrics?: boolean;
+    /**
+     * 索引键字段名（可选）
+     * 默认使用 keyField 配置
+     */
+    indexKeyField?: string | ((item: TDictionaryItem) => string);
+    /**
+     * 是否启用索引（默认：true）
+     */
+    enableIndex?: boolean;
+    /**
+     * 并发控制策略（默认：'auto'）
+     */
+    concurrencyStrategy?: 'auto' | 'queue' | 'latest';
+    /**
+     * 队列最大长度（默认：100）
+     */
+    maxQueueSize?: number;
+    /**
+     * 操作超时时间（毫秒，默认：30000）
+     */
+    operationTimeout?: number;
+    /**
+     * 是否启用字典差异计算（默认：true）
+     */
+    enableDiff?: boolean;
+    /**
+     * 字典项比较函数（可选）
+     */
+    itemComparator?: (item1: TDictionaryItem, item2: TDictionaryItem) => boolean;
+    /**
+     * 字典项变更检测函数（可选）
+     */
+    itemChangeDetector?: (before: TDictionaryItem, after: TDictionaryItem) => boolean;
+    /**
+     * 实例 ID（可选）
+     */
+    instanceId?: string;
+    /**
+     * 是否启用开发模式（默认：自动检测）
+     */
+    devMode?: boolean;
+    /**
+     * 是否启用配置验证（默认：true）
+     */
+    validateConfig?: boolean;
+}
+/**
+ * 获取字典选项（异步）
+ */
+export interface GetDictionaryOptions {
+    /**
+     * 是否强制刷新（忽略缓存）
+     */
+    force?: boolean;
+    /**
+     * 是否使用持久化缓存
+     */
+    usePersistentCache?: boolean;
+    /**
+     * 并发策略（可选，覆盖全局配置）
+     */
+    concurrencyStrategy?: 'auto' | 'queue' | 'latest';
+}
+/**
+ * 获取字典选项（同步）
+ */
+export interface GetDictionarySyncOptions {
+    /**
+     * 如果缓存中不存在，是否返回空数组/null（默认：true）
+     */
+    returnEmptyIfNotCached?: boolean;
+}
+/**
+ * 格式化字典选项
+ */
+export interface FormatDictionaryOptions {
+    /**
+     * 默认值（如果找不到字典项）
+     */
+    defaultValue?: string;
+    /**
+     * 是否使用自定义格式化函数
+     */
+    useCustomFormatter?: boolean;
+}
+/**
+ * 字典值查询项
+ */
+export interface DictionaryValueQuery {
+    code: string;
+    key: string | number;
+}
+/**
+ * 预加载状态
+ */
+export interface PreloadStatus {
+    code: string;
+    status: 'pending' | 'loading' | 'loaded' | 'error';
+    error?: Error;
+}
+/**
+ * 字典错误代码
+ */
+export declare enum DictionaryErrorCode {
+    UNKNOWN_ERROR = "UNKNOWN_ERROR",
+    STORAGE_ERROR = "STORAGE_ERROR",
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    FETCH_ERROR = "FETCH_ERROR",
+    CACHE_ERROR = "CACHE_ERROR",
+    CONCURRENCY_ERROR = "CONCURRENCY_ERROR",
+    CONFIG_ERROR = "CONFIG_ERROR"
+}
+/**
+ * 字典错误类
+ */
+export declare class DictionaryError extends Error {
+    code: DictionaryErrorCode;
+    context?: Record<string, unknown> | undefined;
+    cause?: Error | undefined;
+    constructor(message: string, code: DictionaryErrorCode, context?: Record<string, unknown> | undefined, cause?: Error | undefined);
+}
+/**
+ * 健康检查结果
+ */
+export interface HealthCheckResult {
+    healthy: boolean;
+    checks: {
+        storage?: {
+            healthy: boolean;
+            error?: string;
+        };
+        stateManager?: {
+            healthy: boolean;
+            error?: string;
+        };
+        eventBus?: {
+            healthy: boolean;
+            error?: string;
+        };
+        logger?: {
+            healthy: boolean;
+            error?: string;
+        };
+        monitoring?: {
+            healthy: boolean;
+            error?: string;
+        };
+    };
+}
+/**
+ * 性能指标
+ */
+export interface PerformanceMetrics {
+    operation: string;
+    duration: number;
+    timestamp: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * 缓存统计信息
+ */
+export interface CacheStatistics {
+    size: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
+    keys: string[];
+}
+/**
+ * 配置验证结果
+ */
+export interface ConfigValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/types/managers/NotificationManager/NotificationManager.d.ts

@@ -0,0 +1,163 @@
+/**
+ * NotificationManager - 通知管理器
+ *
+ * 提供通知管理能力
+ * 完全泛型化，通知类型由用户定义
+ * 基于 @vlian/framework 的 Storage、StateManager 和 AppEventBus
+ */
+import type { NotificationManagerOptions, NotificationList, GetNotificationsOptions, GetNotificationsSyncOptions, GetNotificationOptions, GetNotificationSyncOptions, UpdateNotificationOptions, DeleteNotificationOptions, BatchUpdateResult, GetUnreadCountOptions, GetUnreadCountSyncOptions, RefreshNotificationsOptions, ClearCacheOptions, StartRealtimePushOptions, PushConnectionStatus, NotificationFilter, SearchNotificationsOptions, EventMetadata, EventListenerOptions, HealthCheckResult, PerformanceMetrics, CacheStatistics } from './types';
+import { NotificationEventType } from './types';
+/**
+ * NotificationManager 类
+ */
+export declare class NotificationManager<TNotification = unknown> {
+    private options;
+    private environment;
+    private isProduction;
+    private storageManager?;
+    private stateManager?;
+    private cacheManager;
+    private concurrencyController;
+    private consistencyManager;
+    private transactionManager?;
+    private dataManager;
+    private stateManagerCore;
+    private pushManager?;
+    private loggingManager;
+    private monitoringManager;
+    private performanceMonitor;
+    private eventManager;
+    /**
+     * 构造函数
+     */
+    constructor(options: NotificationManagerOptions<TNotification>);
+    /**
+     * 初始化所有模块
+     */
+    private initializeModules;
+    /**
+     * 处理新通知到达
+     */
+    private handleNotificationReceived;
+    /**
+     * 验证配置
+     */
+    private validateConfig;
+    /**
+     * 获取通知列表
+     */
+    getNotifications(options?: GetNotificationsOptions): Promise<NotificationList<TNotification>>;
+    /**
+     * 获取通知列表（同步）
+     */
+    getNotificationsSync(options?: GetNotificationsSyncOptions): NotificationList<TNotification>;
+    /**
+     * 获取单个通知
+     */
+    getNotification(id: string, options?: GetNotificationOptions): Promise<TNotification | null>;
+    /**
+     * 获取单个通知（同步）
+     */
+    getNotificationSync(id: string, options?: GetNotificationSyncOptions): TNotification | null;
+    /**
+     * 标记通知为已读
+     */
+    markAsRead(id: string, options?: UpdateNotificationOptions): Promise<void>;
+    /**
+     * 批量标记通知为已读
+     */
+    batchMarkAsRead(ids: string[], options?: UpdateNotificationOptions): Promise<BatchUpdateResult>;
+    /**
+     * 标记所有通知为已读
+     */
+    markAllAsRead(options?: UpdateNotificationOptions): Promise<void>;
+    /**
+     * 删除通知
+     */
+    deleteNotification(id: string, _options?: DeleteNotificationOptions): Promise<void>;
+    /**
+     * 获取未读通知数量
+     */
+    getUnreadCount(options?: GetUnreadCountOptions): Promise<number>;
+    /**
+     * 获取未读通知数量（同步）
+     */
+    getUnreadCountSync(options?: GetUnreadCountSyncOptions): number;
+    /**
+     * 按分类获取未读通知数量
+     */
+    getUnreadCountByCategory(options?: GetUnreadCountOptions): Promise<Record<string, number>>;
+    /**
+     * 按分类获取未读通知数量（同步）
+     */
+    getUnreadCountByCategorySync(): Record<string, number>;
+    /**
+     * 刷新通知列表
+     */
+    refreshNotifications(force?: boolean, _options?: RefreshNotificationsOptions): Promise<void>;
+    /**
+     * 清除通知缓存
+     */
+    clearCache(options?: ClearCacheOptions): Promise<void>;
+    /**
+     * 启动实时推送
+     */
+    startRealtimePush(options?: StartRealtimePushOptions): Promise<void>;
+    /**
+     * 停止实时推送
+     */
+    stopRealtimePush(): void;
+    /**
+     * 获取推送连接状态
+     */
+    getPushConnectionStatus(): PushConnectionStatus;
+    /**
+     * 手动触发轮询
+     */
+    triggerPolling(): Promise<void>;
+    /**
+     * 过滤通知列表
+     */
+    filterNotifications(notifications: TNotification[], filter: NotificationFilter): TNotification[];
+    /**
+     * 搜索通知列表
+     */
+    searchNotifications(notifications: TNotification[], keyword: string, options?: SearchNotificationsOptions): TNotification[];
+    /**
+     * 订阅事件
+     */
+    on<EventData = unknown>(event: NotificationEventType, listener: (data: EventData, metadata: EventMetadata) => void | Promise<void>, options?: EventListenerOptions): () => void;
+    /**
+     * 取消订阅
+     */
+    off<EventData = unknown>(event: NotificationEventType, listener?: (data: EventData, metadata: EventMetadata) => void | Promise<void>): void;
+    /**
+     * 一次性订阅
+     */
+    once<EventData = unknown>(event: NotificationEventType, listener: (data: EventData, metadata: EventMetadata) => void | Promise<void>): () => void;
+    /**
+     * 健康检查
+     */
+    healthCheck(): Promise<HealthCheckResult>;
+    /**
+     * 获取性能指标
+     */
+    getPerformanceMetrics(): PerformanceMetrics[];
+    /**
+     * 清除性能指标
+     */
+    clearPerformanceMetrics(): void;
+    /**
+     * 获取缓存统计信息
+     */
+    getCacheStatistics(): CacheStatistics;
+    /**
+     * 重置缓存统计信息
+     */
+    resetCacheStatistics(): void;
+    /**
+     * 销毁实例（清理资源）
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=NotificationManager.d.ts.map

package/dist/types/managers/NotificationManager/NotificationManager.d.ts.map

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