@vlian/infrastructure 0.9.10

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

@@ -0,0 +1,95 @@
+/**
+ * NotificationManager 常量定义
+ */
+import { NotificationEventType } from './types';
+/**
+ * 默认配置值
+ */
+export declare const DEFAULT_OPTIONS: {
+    readonly eventNamespace: "notification:";
+    readonly enableEvents: false;
+    readonly notificationKeyPrefix: "notifications:";
+    readonly enablePersistentCache: false;
+    readonly enableCache: true;
+    readonly cacheExpiry: undefined;
+    readonly maxCacheSize: 1000;
+    readonly defaultPageSize: 20;
+    readonly maxPageSize: 100;
+    readonly concurrencyStrategy: "auto";
+    readonly maxQueueSize: 100;
+    readonly operationTimeout: 30000;
+    readonly pushStrategy: "auto";
+    readonly websocket: {
+        readonly heartbeatInterval: 30000;
+        readonly reconnect: {
+            readonly enabled: true;
+            readonly maxRetries: number;
+            readonly initialDelay: 1000;
+            readonly maxDelay: 30000;
+            readonly backoffMultiplier: 2;
+        };
+    };
+    readonly polling: {
+        readonly interval: 30000;
+        readonly pollOnVisible: true;
+        readonly stopOnHidden: true;
+    };
+    readonly enableVersionControl: true;
+    readonly conflictStrategy: "auto";
+    readonly conflictRetryCount: 3;
+    readonly conflictRetryDelay: 100;
+    readonly enableOperationPriority: true;
+    readonly enableTransaction: true;
+    readonly transactionIsolationLevel: "read_committed";
+    readonly transactionTimeout: 30000;
+    readonly maxTransactionOperations: 100;
+    readonly autoCleanupTransactions: true;
+    readonly transactionCleanupInterval: 60000;
+    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;
+    readonly enableLogging: false;
+};
+/**
+ * 事件类型映射（用于类型检查）
+ */
+export declare const NOTIFICATION_EVENT_TYPES: {
+    readonly NOTIFICATION_LOADED: NotificationEventType.NOTIFICATION_LOADED;
+    readonly NOTIFICATION_UPDATED: NotificationEventType.NOTIFICATION_UPDATED;
+    readonly NOTIFICATION_READ: NotificationEventType.NOTIFICATION_READ;
+    readonly NOTIFICATION_DELETED: NotificationEventType.NOTIFICATION_DELETED;
+    readonly NOTIFICATION_RECEIVED: NotificationEventType.NOTIFICATION_RECEIVED;
+    readonly NOTIFICATIONS_REFRESHED: NotificationEventType.NOTIFICATIONS_REFRESHED;
+    readonly UNREAD_COUNT_CHANGED: NotificationEventType.UNREAD_COUNT_CHANGED;
+    readonly PUSH_CONNECTED: NotificationEventType.PUSH_CONNECTED;
+    readonly PUSH_DISCONNECTED: NotificationEventType.PUSH_DISCONNECTED;
+    readonly PUSH_ERROR: NotificationEventType.PUSH_ERROR;
+};
+/**
+ * 默认通知分类
+ */
+export declare const DEFAULT_CATEGORIES: {
+    readonly system: {
+        readonly name: "系统通知";
+        readonly enabled: true;
+    };
+    readonly message: {
+        readonly name: "消息通知";
+        readonly enabled: true;
+    };
+    readonly todo: {
+        readonly name: "待办事项";
+        readonly enabled: true;
+    };
+};
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/managers/NotificationManager/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AA6BhD;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqElB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;CAIvB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;CAW3B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;CAarB,CAAC"}

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

@@ -0,0 +1,64 @@
+/**
+ * 缓存管理模块
+ * 负责内存缓存管理
+ */
+/**
+ * 缓存管理器
+ */
+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;
+    };
+    /**
+     * 重置统计信息
+     */
+    resetStatistics(): void;
+}
+//# sourceMappingURL=CacheManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CacheManager.d.ts","sourceRoot":"","sources":["../../../../../src/managers/NotificationManager/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;IAMb;;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;KACjB;IAYD;;OAEG;IACH,eAAe,IAAI,IAAI;CAIxB"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConcurrencyController.d.ts","sourceRoot":"","sources":["../../../../../src/managers/NotificationManager/core/ConcurrencyController.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH;;GAEG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,cAAc,CAAK;gBAEf,OAAO,EAAE;QACnB,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;QAC/C,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;IAiEb;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkC5B;;OAEG;YACW,YAAY;IAsC1B;;OAEG;YACW,WAAW;IAiBzB;;OAEG;IACH,KAAK,IAAI,IAAI;IAgBb;;OAEG;IACH,cAAc,IAAI,MAAM;CAGzB"}

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

@@ -0,0 +1,70 @@
+/**
+ * 一致性管理模块
+ * 负责管理通知的版本号和冲突检测
+ */
+import type { UpdateOperation, ConflictType, Notification } from '../types';
+/**
+ * 一致性管理器
+ */
+export declare class ConsistencyManager {
+    private versions;
+    private pendingOperations;
+    private enableVersionControl;
+    private enableOperationPriority;
+    constructor(options: {
+        enableVersionControl?: boolean;
+        conflictStrategy?: 'auto' | 'reject' | 'retry';
+        conflictRetryCount?: number;
+        conflictRetryDelay?: number;
+        enableOperationPriority?: boolean;
+    });
+    /**
+     * 检查版本号是否匹配
+     */
+    checkVersion(id: string, expectedVersion: number): boolean;
+    /**
+     * 获取通知当前版本号
+     */
+    getVersion(id: string): number | null;
+    /**
+     * 更新通知版本号
+     */
+    updateVersion(id: string, newVersion: number): void;
+    /**
+     * 初始化版本号（从通知对象）
+     */
+    initVersion(notification: Notification): void;
+    /**
+     * 递增版本号
+     */
+    incrementVersion(id: string): number;
+    /**
+     * 检测操作冲突
+     */
+    detectConflict(operation1: UpdateOperation, operation2: UpdateOperation): ConflictType | null;
+    /**
+     * 合并冲突操作
+     */
+    mergeOperations(operation1: UpdateOperation, operation2: UpdateOperation): UpdateOperation | null;
+    /**
+     * 注册待处理操作（用于冲突检测）
+     */
+    registerPendingOperation(operation: UpdateOperation): void;
+    /**
+     * 清除待处理操作
+     */
+    clearPendingOperation(id: string): void;
+    /**
+     * 获取待处理操作
+     */
+    getPendingOperations(id: string): UpdateOperation[];
+    /**
+     * 清除所有版本号
+     */
+    clear(): void;
+    /**
+     * 获取操作优先级
+     */
+    getOperationPriority(operationType: string): number;
+}
+//# sourceMappingURL=ConsistencyManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConsistencyManager.d.ts","sourceRoot":"","sources":["../../../../../src/managers/NotificationManager/core/ConsistencyManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,YAAY,EACb,MAAM,UAAU,CAAC;AAKlB;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,iBAAiB,CAA6C;IACtE,OAAO,CAAC,oBAAoB,CAAU;IACtC,OAAO,CAAC,uBAAuB,CAAU;gBAE7B,OAAO,EAAE;QACnB,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,gBAAgB,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;QAC/C,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,uBAAuB,CAAC,EAAE,OAAO,CAAC;KACnC;IASD;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO;IAS1D;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIrC;;OAEG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAQnD;;OAEG;IACH,WAAW,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI;IAY7C;;OAEG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAWpC;;OAEG;IACH,cAAc,CACZ,UAAU,EAAE,eAAe,EAC3B,UAAU,EAAE,eAAe,GAC1B,YAAY,GAAG,IAAI;IAyCtB;;OAEG;IACH,eAAe,CACb,UAAU,EAAE,eAAe,EAC3B,UAAU,EAAE,eAAe,GAC1B,eAAe,GAAG,IAAI;IA2CzB;;OAEG;IACH,wBAAwB,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI;IAO1D;;OAEG;IACH,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIvC;;OAEG;IACH,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,EAAE;IAInD;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;CAmBpD"}

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

@@ -0,0 +1,105 @@
+/**
+ * 通知数据管理模块
+ * 负责通知数据的获取、更新、缓存
+ */
+import type { NotificationList, NotificationFetcherOptions, GetNotificationOptions, GetNotificationsOptions } from '../types';
+import { CacheManager } from './CacheManager';
+import { StateManagerWrapper } from './StateManagerWrapper';
+import { StorageManager } from './StorageManager';
+import { ConsistencyManager } from './ConsistencyManager';
+import { ConcurrencyController } from './ConcurrencyController';
+/**
+ * 通知数据管理器
+ */
+export declare class NotificationDataManager<TNotification = unknown> {
+    private cacheManager;
+    private stateManager?;
+    private storageManager?;
+    private consistencyManager;
+    private concurrencyController;
+    private notificationFetcher?;
+    private notificationUpdater?;
+    private notificationBatchUpdater?;
+    private notificationDeleter?;
+    private notificationBatchDeleter?;
+    private notificationValidator?;
+    private enableCache;
+    private enablePersistentCache;
+    private cacheExpiry?;
+    private notificationKeyPrefix;
+    private userId;
+    constructor(options: {
+        cacheManager: CacheManager<NotificationList<TNotification>>;
+        stateManager?: StateManagerWrapper;
+        storageManager?: StorageManager;
+        consistencyManager: ConsistencyManager;
+        concurrencyController: ConcurrencyController;
+        notificationFetcher?: (options?: NotificationFetcherOptions) => Promise<NotificationList<TNotification>>;
+        notificationUpdater?: (id: string, updates: Partial<TNotification>) => Promise<void>;
+        notificationBatchUpdater?: (updates: Array<{
+            id: string;
+            updates: Partial<TNotification>;
+        }>) => Promise<void>;
+        notificationDeleter?: (id: string) => Promise<void>;
+        notificationBatchDeleter?: (ids: string[]) => Promise<void>;
+        notificationValidator?: (notification: TNotification) => true | string;
+        enableCache: boolean;
+        enablePersistentCache: boolean;
+        cacheExpiry?: number;
+        notificationKeyPrefix: string;
+        userId: string | null;
+    });
+    /**
+     * 设置用户ID
+     */
+    setUserId(userId: string | null): void;
+    /**
+     * 获取通知列表
+     */
+    getNotifications(options?: GetNotificationsOptions): Promise<NotificationList<TNotification>>;
+    /**
+     * 获取通知列表（同步，仅读取缓存）
+     */
+    getNotificationsSync(options?: {
+        returnEmptyIfNotCached?: boolean;
+    }): NotificationList<TNotification>;
+    /**
+     * 获取单个通知
+     */
+    getNotification(id: string, options?: GetNotificationOptions): Promise<TNotification | null>;
+    /**
+     * 获取单个通知（同步）
+     */
+    getNotificationSync(id: string, options?: {
+        returnNullIfNotCached?: boolean;
+    }): TNotification | null;
+    /**
+     * 从服务器获取通知列表
+     */
+    private fetchNotifications;
+    /**
+     * 从服务器获取单个通知
+     */
+    private fetchNotification;
+    /**
+     * 更新通知
+     */
+    updateNotification(id: string, updates: Partial<TNotification>, expectedVersion?: number): Promise<void>;
+    /**
+     * 内部更新通知方法（不经过并发控制，用于避免死锁）
+     */
+    updateNotificationInternal(id: string, updates: Partial<TNotification>, expectedVersion?: number): Promise<void>;
+    /**
+     * 删除通知
+     */
+    deleteNotification(id: string): Promise<void>;
+    /**
+     * 清除缓存
+     */
+    clearCache(clearPersistentCache?: boolean): void;
+    /**
+     * 获取缓存键名
+     */
+    private getCacheKey;
+}
+//# sourceMappingURL=NotificationDataManager.d.ts.map

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

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

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

@@ -0,0 +1,77 @@
+/**
+ * 通知状态管理模块
+ * 负责管理通知状态（已读/未读）
+ */
+import type { GetUnreadCountOptions, UpdateNotificationOptions, BatchUpdateResult } from '../types';
+import { NotificationDataManager } from './NotificationDataManager';
+import { ConsistencyManager } from './ConsistencyManager';
+import { ConcurrencyController } from './ConcurrencyController';
+/**
+ * 通知状态管理器
+ */
+export declare class NotificationStateManager<TNotification = unknown> {
+    private dataManager;
+    private consistencyManager;
+    private concurrencyController;
+    private unreadCountCache;
+    constructor(options: {
+        dataManager: NotificationDataManager<TNotification>;
+        consistencyManager: ConsistencyManager;
+        concurrencyController: ConcurrencyController;
+    });
+    /**
+     * 内部标记通知为已读方法（不经过并发控制，用于避免死锁）
+     */
+    private markAsReadInternal;
+    /**
+     * 标记通知为已读
+     */
+    markAsRead(id: string, options?: UpdateNotificationOptions): Promise<void>;
+    /**
+     * 批量标记通知为已读
+     */
+    batchMarkAsRead(ids: string[], options?: UpdateNotificationOptions): Promise<BatchUpdateResult>;
+    /**
+     * 标记所有通知为已读
+     */
+    markAllAsRead(options?: UpdateNotificationOptions): Promise<void>;
+    /**
+     * 获取未读通知数量
+     */
+    getUnreadCount(options?: GetUnreadCountOptions): Promise<number>;
+    /**
+     * 获取未读通知数量（同步）
+     */
+    getUnreadCountSync(options?: {
+        category?: string;
+    }): number;
+    /**
+     * 按分类获取未读通知数量
+     */
+    getUnreadCountByCategory(options?: GetUnreadCountOptions): Promise<Record<string, number>>;
+    /**
+     * 按分类获取未读通知数量（同步）
+     */
+    getUnreadCountByCategorySync(): Record<string, number>;
+    /**
+     * 计算未读数量
+     */
+    private calculateUnreadCount;
+    /**
+     * 从列表中计算未读数量
+     */
+    private calculateUnreadCountFromList;
+    /**
+     * 从列表中按分类计算未读数量
+     */
+    private calculateUnreadCountByCategoryFromList;
+    /**
+     * 清除未读数量缓存（内部方法）
+     */
+    private clearUnreadCountCacheInternal;
+    /**
+     * 清除所有未读数量缓存
+     */
+    clearUnreadCountCache(): void;
+}
+//# sourceMappingURL=NotificationStateManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationStateManager.d.ts","sourceRoot":"","sources":["../../../../../src/managers/NotificationManager/core/NotificationStateManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAEV,qBAAqB,EACrB,yBAAyB,EACzB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGhE;;GAEG;AACH,qBAAa,wBAAwB,CAAC,aAAa,GAAG,OAAO;IAC3D,OAAO,CAAC,WAAW,CAAyC;IAC5D,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,qBAAqB,CAAwB;IACrD,OAAO,CAAC,gBAAgB,CAAkC;gBAE9C,OAAO,EAAE;QACnB,WAAW,EAAE,uBAAuB,CAAC,aAAa,CAAC,CAAC;QACpD,kBAAkB,EAAE,kBAAkB,CAAC;QACvC,qBAAqB,EAAE,qBAAqB,CAAC;KAC9C;IAMD;;OAEG;YACW,kBAAkB;IAwChC;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IAShF;;OAEG;IACG,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAkCrG;;OAEG;IACG,aAAa,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BvE;;OAEG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAyBtE;;OAEG;IACH,kBAAkB,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAgB3D;;OAEG;IACG,wBAAwB,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAyBhG;;OAEG;IACH,4BAA4B,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAStD;;OAEG;YACW,oBAAoB;IAKlC;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAepC;;OAEG;IACH,OAAO,CAAC,sCAAsC;IAgB9C;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAOrC;;OAEG;IACH,qBAAqB,IAAI,IAAI;CAG9B"}

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

@@ -0,0 +1,117 @@
+/**
+ * 实时推送管理模块
+ * 负责管理 WebSocket 和轮询推送
+ */
+import type { PushConnectionStatus, StartRealtimePushOptions, Notification } from '../types';
+/**
+ * 实时推送管理器
+ */
+export declare class RealtimePushManager {
+    private pushStrategy;
+    private websocketConfig?;
+    private pollingConfig?;
+    private environment;
+    private connectionStatus;
+    private websocket?;
+    private pollingTimer?;
+    private reconnectTimer?;
+    private reconnectCount;
+    private heartbeatTimer?;
+    private onNotificationReceived?;
+    private isPolling;
+    constructor(options: {
+        pushStrategy: 'auto' | 'websocket' | 'polling' | 'disabled';
+        websocket?: {
+            url: string | (() => string);
+            protocols?: string | string[];
+            getToken?: () => Promise<string>;
+            heartbeatInterval?: number;
+            reconnect?: {
+                enabled?: boolean;
+                maxRetries?: number;
+                initialDelay?: number;
+                maxDelay?: number;
+                backoffMultiplier?: number;
+            };
+        };
+        polling?: {
+            interval?: number;
+            pollOnVisible?: boolean;
+            stopOnHidden?: boolean;
+        };
+        onNotificationReceived?: (notification: Notification) => void;
+    });
+    /**
+     * 启动实时推送
+     */
+    startRealtimePush(options?: StartRealtimePushOptions): Promise<void>;
+    /**
+     * 停止实时推送
+     */
+    stopRealtimePush(): void;
+    /**
+     * 获取推送连接状态
+     */
+    getPushConnectionStatus(): PushConnectionStatus;
+    /**
+     * 手动触发轮询
+     */
+    triggerPolling(): Promise<void>;
+    /**
+     * 检查是否可以使用 WebSocket
+     */
+    private canUseWebSocket;
+    /**
+     * 启动 WebSocket
+     */
+    private startWebSocket;
+    /**
+     * 停止 WebSocket
+     */
+    private stopWebSocket;
+    /**
+     * 启动轮询
+     */
+    private startPolling;
+    /**
+     * 停止轮询
+     */
+    private stopPolling;
+    /**
+     * 安排轮询
+     */
+    private schedulePolling;
+    /**
+     * 处理页面可见性变化
+     */
+    private handleVisibilityChange;
+    /**
+     * 启动心跳
+     */
+    private startHeartbeat;
+    /**
+     * 停止心跳
+     */
+    private stopHeartbeat;
+    /**
+     * 处理 WebSocket 错误
+     */
+    private handleWebSocketError;
+    /**
+     * 处理 WebSocket 关闭
+     */
+    private handleWebSocketClose;
+    /**
+     * 安排重连
+     */
+    private scheduleReconnect;
+    /**
+     * 停止重连
+     */
+    private stopReconnect;
+    /**
+     * 销毁推送管理器
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=RealtimePushManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RealtimePushManager.d.ts","sourceRoot":"","sources":["../../../../../src/managers/NotificationManager/core/RealtimePushManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,wBAAwB,EACxB,YAAY,EACb,MAAM,UAAU,CAAC;AAIlB;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,YAAY,CAAgD;IACpE,OAAO,CAAC,eAAe,CAAC,CAYtB;IACF,OAAO,CAAC,aAAa,CAAC,CAIpB;IACF,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,gBAAgB,CAGtB;IACF,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,YAAY,CAAC,CAAiB;IACtC,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,sBAAsB,CAAC,CAAuC;IACtE,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,EAAE;QACnB,YAAY,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;QAC5D,SAAS,CAAC,EAAE;YACV,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;YAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;YAC9B,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;YACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;YAC3B,SAAS,CAAC,EAAE;gBACV,OAAO,CAAC,EAAE,OAAO,CAAC;gBAClB,UAAU,CAAC,EAAE,MAAM,CAAC;gBACpB,YAAY,CAAC,EAAE,MAAM,CAAC;gBACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;aAC5B,CAAC;SACH,CAAC;QACF,OAAO,CAAC,EAAE;YACR,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,aAAa,CAAC,EAAE,OAAO,CAAC;YACxB,YAAY,CAAC,EAAE,OAAO,CAAC;SACxB,CAAC;QACF,sBAAsB,CAAC,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,IAAI,CAAC;KAC/D;IAQD;;OAEG;IACG,iBAAiB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwC1E;;OAEG;IACH,gBAAgB,IAAI,IAAI;IASxB;;OAEG;IACH,uBAAuB,IAAI,oBAAoB;IAI/C;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAQrC;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;YACW,cAAc;IA+E5B;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;YACW,YAAY;IA4B1B;;OAEG;IACH,OAAO,CAAC,WAAW;IAenB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;IACH,OAAO,CAAC,sBAAsB,CAmB5B;IAEF;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAO5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAO5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAQrB;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/dist/types/managers/NotificationManager/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 | null) => void): () => void;
+}
+//# sourceMappingURL=StateManagerWrapper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StateManagerWrapper.d.ts","sourceRoot":"","sources":["../../../../../src/managers/NotificationManager/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;IAUzB;;OAEG;IACH,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,GAAG,MAAM,IAAI;CAuB3E"}