@vlian/infrastructure 0.9.10

package/dist/cjs/managers/NotificationManager/types.js

@@ -0,0 +1,169 @@
+/**
+ * NotificationManager 类型定义
+ * 完全泛型化的通知管理类型
+ */ // ========== 框架服务类型声明 ==========
+/**
+ * @vlian/framework AppEventBus 类型声明
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get NotificationError () {
+        return NotificationError;
+    },
+    get NotificationErrorCode () {
+        return NotificationErrorCode;
+    },
+    get NotificationEventType () {
+        return NotificationEventType;
+    },
+    get OperationPriority () {
+        return OperationPriority;
+    },
+    get OperationStatus () {
+        return OperationStatus;
+    },
+    get OperationType () {
+        return OperationType;
+    },
+    get TransactionError () {
+        return TransactionError;
+    },
+    get TransactionIsolationLevel () {
+        return TransactionIsolationLevel;
+    },
+    get TransactionRollbackError () {
+        return TransactionRollbackError;
+    },
+    get TransactionStatus () {
+        return TransactionStatus;
+    },
+    get TransactionTimeoutError () {
+        return TransactionTimeoutError;
+    },
+    get VersionConflictError () {
+        return VersionConflictError;
+    }
+});
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+var NotificationEventType = /*#__PURE__*/ function(NotificationEventType) {
+    NotificationEventType["NOTIFICATION_LOADED"] = "notification:loaded";
+    NotificationEventType["NOTIFICATION_UPDATED"] = "notification:updated";
+    NotificationEventType["NOTIFICATION_READ"] = "notification:read";
+    NotificationEventType["NOTIFICATION_DELETED"] = "notification:deleted";
+    NotificationEventType["NOTIFICATION_RECEIVED"] = "notification:received";
+    NotificationEventType["NOTIFICATIONS_REFRESHED"] = "notification:refreshed";
+    NotificationEventType["UNREAD_COUNT_CHANGED"] = "notification:unread:changed";
+    NotificationEventType["PUSH_CONNECTED"] = "notification:push:connected";
+    NotificationEventType["PUSH_DISCONNECTED"] = "notification:push:disconnected";
+    NotificationEventType["PUSH_ERROR"] = "notification:push:error";
+    return NotificationEventType;
+}({});
+var OperationPriority = /*#__PURE__*/ function(OperationPriority) {
+    OperationPriority[OperationPriority["DELETE"] = 100] = "DELETE";
+    OperationPriority[OperationPriority["BATCH_DELETE"] = 90] = "BATCH_DELETE";
+    OperationPriority[OperationPriority["BATCH_MARK_READ"] = 80] = "BATCH_MARK_READ";
+    OperationPriority[OperationPriority["MARK_READ"] = 70] = "MARK_READ";
+    OperationPriority[OperationPriority["UPDATE"] = 60] = "UPDATE";
+    OperationPriority[OperationPriority["FETCH"] = 10] = "FETCH";
+    return OperationPriority;
+}({});
+var TransactionStatus = /*#__PURE__*/ function(TransactionStatus) {
+    TransactionStatus["PENDING"] = "pending";
+    TransactionStatus["COMMITTING"] = "committing";
+    TransactionStatus["COMMITTED"] = "committed";
+    TransactionStatus["ROLLING_BACK"] = "rolling_back";
+    TransactionStatus["ROLLED_BACK"] = "rolled_back";
+    TransactionStatus["FAILED"] = "failed";
+    return TransactionStatus;
+}({});
+var OperationType = /*#__PURE__*/ function(OperationType) {
+    OperationType["MARK_READ"] = "markRead";
+    OperationType["BATCH_MARK_READ"] = "batchMarkRead";
+    OperationType["DELETE"] = "delete";
+    OperationType["BATCH_DELETE"] = "batchDelete";
+    OperationType["UPDATE"] = "update";
+    OperationType["BATCH_UPDATE"] = "batchUpdate";
+    return OperationType;
+}({});
+var OperationStatus = /*#__PURE__*/ function(OperationStatus) {
+    OperationStatus["PENDING"] = "pending";
+    OperationStatus["EXECUTING"] = "executing";
+    OperationStatus["SUCCESS"] = "success";
+    OperationStatus["FAILED"] = "failed";
+    OperationStatus["ROLLED_BACK"] = "rolled_back";
+    return OperationStatus;
+}({});
+var TransactionIsolationLevel = /*#__PURE__*/ function(TransactionIsolationLevel) {
+    TransactionIsolationLevel["READ_UNCOMMITTED"] = "read_uncommitted";
+    TransactionIsolationLevel["READ_COMMITTED"] = "read_committed";
+    TransactionIsolationLevel["REPEATABLE_READ"] = "repeatable_read";
+    TransactionIsolationLevel["SERIALIZABLE"] = "serializable";
+    return TransactionIsolationLevel;
+}({});
+var NotificationErrorCode = /*#__PURE__*/ function(NotificationErrorCode) {
+    NotificationErrorCode["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+    NotificationErrorCode["NOTIFICATION_NOT_FOUND"] = "NOTIFICATION_NOT_FOUND";
+    NotificationErrorCode["VERSION_CONFLICT"] = "VERSION_CONFLICT";
+    NotificationErrorCode["TRANSACTION_ERROR"] = "TRANSACTION_ERROR";
+    NotificationErrorCode["TRANSACTION_TIMEOUT"] = "TRANSACTION_TIMEOUT";
+    NotificationErrorCode["TRANSACTION_ROLLBACK_ERROR"] = "TRANSACTION_ROLLBACK_ERROR";
+    NotificationErrorCode["INVALID_CONFIG"] = "INVALID_CONFIG";
+    NotificationErrorCode["OPERATION_FAILED"] = "OPERATION_FAILED";
+    NotificationErrorCode["CACHE_ERROR"] = "CACHE_ERROR";
+    NotificationErrorCode["STORAGE_ERROR"] = "STORAGE_ERROR";
+    NotificationErrorCode["PUSH_ERROR"] = "PUSH_ERROR";
+    return NotificationErrorCode;
+}({});
+let NotificationError = class NotificationError extends Error {
+    constructor(message, code, cause){
+        super(message), _define_property(this, "code", void 0), _define_property(this, "cause", void 0), this.code = code, this.cause = cause;
+        this.name = 'NotificationError';
+        Object.setPrototypeOf(this, NotificationError.prototype);
+    }
+};
+let VersionConflictError = class VersionConflictError extends NotificationError {
+    constructor(id, expectedVersion, actualVersion, operation){
+        super(`Version conflict for notification ${id}: expected ${expectedVersion}, got ${actualVersion}`, "VERSION_CONFLICT"), _define_property(this, "id", void 0), _define_property(this, "expectedVersion", void 0), _define_property(this, "actualVersion", void 0), _define_property(this, "operation", void 0), this.id = id, this.expectedVersion = expectedVersion, this.actualVersion = actualVersion, this.operation = operation;
+        this.name = 'VersionConflictError';
+    }
+};
+let TransactionError = class TransactionError extends NotificationError {
+    constructor(transactionId, message, cause){
+        super(message, "TRANSACTION_ERROR", cause), _define_property(this, "transactionId", void 0), this.transactionId = transactionId;
+        this.name = 'TransactionError';
+    }
+};
+let TransactionTimeoutError = class TransactionTimeoutError extends TransactionError {
+    constructor(transactionId, timeout){
+        super(transactionId, `Transaction timeout after ${timeout}ms`, new Error('Transaction timeout'));
+        this.name = 'TransactionTimeoutError';
+    }
+};
+let TransactionRollbackError = class TransactionRollbackError extends TransactionError {
+    constructor(transactionId, failedOperations, cause){
+        super(transactionId, `Transaction rollback failed for operations: ${failedOperations.join(', ')}`, cause), _define_property(this, "failedOperations", void 0), this.failedOperations = failedOperations;
+        this.name = 'TransactionRollbackError';
+    }
+};
+
+//# sourceMappingURL=types.js.map

package/dist/cjs/managers/NotificationManager/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/managers/NotificationManager/types.ts"],"sourcesContent":["/**\n * NotificationManager 类型定义\n * 完全泛型化的通知管理类型\n */\n\n// ========== 框架服务类型声明 ==========\n\n/**\n * @vlian/framework AppEventBus 类型声明\n */\nexport interface AppEventBus {\n  on<T = unknown>(\n    event: string,\n    listener: (data: T, metadata: EventMetadata) => void | Promise<void>,\n    options?: EventListenerOptions\n  ): () => void;\n  \n  off<T = unknown>(\n    event: string,\n    listener?: (data: T, metadata: EventMetadata) => void | Promise<void>\n  ): void;\n  \n  once<T = unknown>(\n    event: string,\n    listener: (data: T, metadata: EventMetadata) => void | Promise<void>,\n    options?: Omit<EventListenerOptions, 'once'>\n  ): () => void;\n  \n  emit<T = unknown>(\n    event: string,\n    data: T,\n    metadata?: Partial<EventMetadata>\n  ): void | Promise<void>;\n}\n\n/**\n * @vlian/framework Logger 类型声明\n */\nexport interface Logger {\n  info(message: string, ...args: unknown[]): void;\n  warn(message: string, ...args: unknown[]): void;\n  error(message: string, ...args: unknown[]): void;\n  debug(message: string, ...args: unknown[]): void;\n}\n\n/**\n * @vlian/framework MonitoringService 类型声明\n */\nexport interface MonitoringService {\n  captureError(error: unknown, context?: Record<string, unknown>): void;\n  captureMessage(message: string, level?: 'info' | 'warning' | 'error', context?: Record<string, unknown>): void;\n  addBreadcrumb(breadcrumb: { message: string; category?: string; level?: 'info' | 'warning' | 'error'; data?: Record<string, unknown> }): void;\n  setUser(user: { id?: string; username?: string; email?: string }): void;\n  setContext(key: string, context: Record<string, unknown>): void;\n  measurePerformance(name: string, duration: number, tags?: Record<string, string>): void;\n}\n\n/**\n * @vlian/framework StorageInstance 类型声明\n */\nexport interface StorageInstance {\n  get<T = unknown>(key: string): Promise<T | null>;\n  set<T = unknown>(key: string, value: T): Promise<void>;\n  remove(key: string): Promise<void>;\n  clear(): Promise<void>;\n  keys(): Promise<string[]>;\n  has(key: string): Promise<boolean>;\n}\n\n/**\n * @vlian/framework StateManagerInstance 类型声明\n */\nexport interface StateManagerInstance {\n  get<T = unknown>(key: string): T | null;\n  set<T = unknown>(key: string, value: T): void;\n  remove(key: string): void;\n  clear(): void;\n  keys(): string[];\n  has(key: string): boolean;\n  subscribe<T = unknown>(key: string, callback: (value: T | null) => void): () => void;\n}\n\n/**\n * @vlian/framework AuthManager 类型声明\n */\nexport interface AuthManager<TUser = unknown> {\n  getToken(): string | null;\n  getRefreshToken(): string | null;\n  isAuthenticated(): boolean;\n  getUserInfo(): TUser | null;\n  getUserId(): string | null;\n}\n\n/**\n * @vlian/framework UserManager 类型声明\n */\nexport interface UserManager<TUserInfo = unknown, TUserSettings = unknown> {\n  getUserInfo(): Promise<TUserInfo | null>;\n  getUserSettings(): Promise<TUserSettings | null>;\n}\n\n// ========== 存储策略类型 ==========\n\nexport type StorageStrategy = 'local' | 'session' | 'indexedDB' | 'memory';\n\n// ========== 环境类型 ==========\n\nexport type Environment = 'browser' | 'node' | 'ssr' | 'worker';\n\n// ========== 事件相关类型 ==========\n\n/**\n * 事件元数据\n */\nexport interface EventMetadata {\n  timestamp: number;\n  instanceId?: string;\n  userId?: string;\n  [key: string]: unknown;\n}\n\n/**\n * 事件监听器选项\n */\nexport interface EventListenerOptions {\n  once?: boolean;\n  priority?: number;\n}\n\n/**\n * 通知事件类型枚举\n */\nexport enum NotificationEventType {\n  NOTIFICATION_LOADED = 'notification:loaded',\n  NOTIFICATION_UPDATED = 'notification:updated',\n  NOTIFICATION_READ = 'notification:read',\n  NOTIFICATION_DELETED = 'notification:deleted',\n  NOTIFICATION_RECEIVED = 'notification:received',\n  NOTIFICATIONS_REFRESHED = 'notification:refreshed',\n  UNREAD_COUNT_CHANGED = 'notification:unread:changed',\n  PUSH_CONNECTED = 'notification:push:connected',\n  PUSH_DISCONNECTED = 'notification:push:disconnected',\n  PUSH_ERROR = 'notification:push:error',\n}\n\n// ========== 通知类型定义 ==========\n\n/**\n * 通知接口（基础接口，用户可扩展）\n */\nexport interface Notification {\n  /**\n   * 通知ID（必需）\n   */\n  id: string;\n  \n  /**\n   * 通知标题（可选）\n   */\n  title?: string;\n  \n  /**\n   * 通知内容（可选）\n   */\n  content?: string;\n  \n  /**\n   * 通知分类（可选）\n   */\n  category?: string;\n  \n  /**\n   * 是否已读（可选，默认：false）\n   */\n  read?: boolean;\n  \n  /**\n   * 版本号（可选，用于并发控制）\n   */\n  version?: number;\n  \n  /**\n   * 创建时间（可选）\n   */\n  createdAt?: number | Date;\n  \n  /**\n   * 更新时间（可选）\n   */\n  updatedAt?: number | Date;\n  \n  /**\n   * 其他自定义字段\n   */\n  [key: string]: unknown;\n}\n\n/**\n * 通知列表\n * @template TNotification 通知类型\n */\nexport interface NotificationList<TNotification = unknown> {\n  /**\n   * 通知列表\n   */\n  items: TNotification[];\n  \n  /**\n   * 总数\n   */\n  total: number;\n  \n  /**\n   * 分页信息\n   */\n  pagination?: {\n    page: number;\n    pageSize: number;\n    totalPages: number;\n  };\n}\n\n/**\n * 通知分类配置\n */\nexport interface NotificationCategory {\n  /**\n   * 分类名称\n   */\n  name: string;\n  \n  /**\n   * 分类图标（可选）\n   */\n  icon?: string;\n  \n  /**\n   * 分类颜色（可选）\n   */\n  color?: string;\n  \n  /**\n   * 是否启用（默认：true）\n   */\n  enabled?: boolean;\n}\n\n// ========== 事件数据类型 ==========\n\n/**\n * 通知更新事件数据\n */\nexport interface NotificationUpdatedEventData {\n  id: string;\n  notification: unknown;\n  previousNotification?: unknown;\n  timestamp: number;\n}\n\n/**\n * 通知已读事件数据\n */\nexport interface NotificationReadEventData {\n  id: string;\n  timestamp: number;\n}\n\n/**\n * 通知删除事件数据\n */\nexport interface NotificationDeletedEventData {\n  id: string;\n  timestamp: number;\n}\n\n/**\n * 新通知到达事件数据\n */\nexport interface NotificationReceivedEventData {\n  notification: unknown;\n  timestamp: number;\n}\n\n/**\n * 未读数量变化事件数据\n */\nexport interface UnreadCountChangedEventData {\n  count: number;\n  previousCount: number;\n  byCategory?: Record<string, number>;\n  timestamp: number;\n}\n\n/**\n * 推送连接状态\n */\nexport interface PushConnectionStatus {\n  /**\n   * 连接状态\n   */\n  status: 'connected' | 'disconnected' | 'connecting' | 'error';\n  \n  /**\n   * 推送策略（websocket/polling）\n   */\n  strategy: 'websocket' | 'polling' | 'disabled';\n  \n  /**\n   * 连接时间（可选）\n   */\n  connectedAt?: number;\n  \n  /**\n   * 断开时间（可选）\n   */\n  disconnectedAt?: number;\n  \n  /**\n   * 错误信息（可选）\n   */\n  error?: string;\n  \n  /**\n   * 重连次数（可选）\n   */\n  reconnectCount?: number;\n}\n\n// ========== 配置选项类型 ==========\n\n/**\n * 通知获取函数选项\n */\nexport interface NotificationFetcherOptions {\n  pagination?: {\n    page?: number;\n    pageSize?: number;\n  };\n  filter?: NotificationFilter;\n  sort?: {\n    field: string;\n    order: 'asc' | 'desc';\n  };\n  force?: boolean;\n}\n\n/**\n * 获取通知选项（异步）\n */\nexport interface GetNotificationsOptions {\n  /**\n   * 分页信息\n   */\n  pagination?: {\n    page?: number;\n    pageSize?: number;\n  };\n  \n  /**\n   * 过滤条件\n   */\n  filter?: NotificationFilter;\n  \n  /**\n   * 排序方式（可选）\n   */\n  sort?: {\n    field: string;\n    order: 'asc' | 'desc';\n  };\n  \n  /**\n   * 是否强制刷新（忽略缓存）\n   */\n  force?: boolean;\n  \n  /**\n   * 是否使用持久化缓存\n   */\n  usePersistentCache?: boolean;\n  \n  /**\n   * 并发策略（可选，覆盖全局配置）\n   */\n  concurrencyStrategy?: 'auto' | 'queue' | 'latest';\n}\n\n/**\n * 获取通知选项（同步）\n */\nexport interface GetNotificationsSyncOptions {\n  /**\n   * 过滤条件\n   */\n  filter?: NotificationFilter;\n  \n  /**\n   * 排序方式（可选）\n   */\n  sort?: {\n    field: string;\n    order: 'asc' | 'desc';\n  };\n  \n  /**\n   * 如果缓存中不存在，是否返回空数组（默认：true）\n   */\n  returnEmptyIfNotCached?: boolean;\n}\n\n/**\n * 获取单个通知选项\n */\nexport interface GetNotificationOptions {\n  /**\n   * 是否强制刷新（忽略缓存）\n   */\n  force?: boolean;\n  \n  /**\n   * 是否使用持久化缓存\n   */\n  usePersistentCache?: boolean;\n}\n\n/**\n * 获取单个通知选项（同步）\n */\nexport interface GetNotificationSyncOptions {\n  /**\n   * 如果缓存中不存在，是否返回 null（默认：true）\n   */\n  returnNullIfNotCached?: boolean;\n}\n\n/**\n * 通知过滤条件\n */\nexport interface NotificationFilter {\n  /**\n   * 按分类过滤\n   */\n  category?: string | string[];\n  \n  /**\n   * 按状态过滤（已读/未读）\n   */\n  read?: boolean;\n  \n  /**\n   * 按时间范围过滤\n   */\n  timeRange?: {\n    start?: number | Date;\n    end?: number | Date;\n  };\n  \n  /**\n   * 自定义过滤函数\n   */\n  custom?: (notification: unknown) => boolean;\n}\n\n/**\n * 更新通知选项\n */\nexport interface UpdateNotificationOptions {\n  /**\n   * 期望的版本号（可选）\n   * 如果提供，会检查版本号是否匹配，不匹配时抛出 VersionConflictError\n   */\n  expectedVersion?: number;\n  \n  /**\n   * 是否强制更新（忽略版本检查，默认：false）\n   */\n  force?: boolean;\n  \n  /**\n   * 是否同步到服务器（默认：true）\n   */\n  syncToServer?: boolean;\n}\n\n/**\n * 删除通知选项\n */\nexport interface DeleteNotificationOptions {\n  /**\n   * 是否同步到服务器（默认：true）\n   */\n  syncToServer?: boolean;\n}\n\n/**\n * 批量更新结果\n */\nexport interface BatchUpdateResult {\n  successCount: number;\n  failureCount: number;\n  totalCount: number;\n  errors?: Array<{ id: string; error: Error }>;\n}\n\n/**\n * 获取未读数量选项\n */\nexport interface GetUnreadCountOptions {\n  /**\n   * 分类（可选，如果提供则只统计该分类）\n   */\n  category?: string;\n  \n  /**\n   * 是否强制刷新（忽略缓存）\n   */\n  force?: boolean;\n}\n\n/**\n * 获取未读数量选项（同步）\n */\nexport interface GetUnreadCountSyncOptions {\n  /**\n   * 分类（可选，如果提供则只统计该分类）\n   */\n  category?: string;\n}\n\n/**\n * 刷新通知选项\n */\nexport interface RefreshNotificationsOptions {\n  /**\n   * 是否清除缓存\n   */\n  clearCache?: boolean;\n}\n\n/**\n * 清除缓存选项\n */\nexport interface ClearCacheOptions {\n  /**\n   * 是否清除持久化缓存\n   */\n  clearPersistentCache?: boolean;\n}\n\n/**\n * 启动实时推送选项\n */\nexport interface StartRealtimePushOptions {\n  /**\n   * 推送策略（可选，覆盖全局配置）\n   */\n  strategy?: 'auto' | 'websocket' | 'polling' | 'disabled';\n}\n\n/**\n * 搜索通知选项\n */\nexport interface SearchNotificationsOptions {\n  /**\n   * 搜索字段（可选，默认搜索所有字段）\n   */\n  fields?: string[];\n  \n  /**\n   * 是否区分大小写（默认：false）\n   */\n  caseSensitive?: boolean;\n}\n\n// ========== 版本控制和一致性类型 ==========\n\n/**\n * 更新操作\n */\nexport interface UpdateOperation {\n  id: string;\n  expectedVersion: number;\n  updates: Partial<Notification>;\n  operationType: string;\n  priority?: number;\n}\n\n/**\n * 冲突类型\n */\nexport type ConflictType = 'same_operation' | 'mutex_operation' | 'field_conflict' | 'unmergeable';\n\n/**\n * 操作优先级\n */\nexport enum OperationPriority {\n  DELETE = 100,\n  BATCH_DELETE = 90,\n  BATCH_MARK_READ = 80,\n  MARK_READ = 70,\n  UPDATE = 60,\n  FETCH = 10,\n}\n\n// ========== 事务类型 ==========\n\n/**\n * 事务状态\n */\nexport enum TransactionStatus {\n  PENDING = 'pending',\n  COMMITTING = 'committing',\n  COMMITTED = 'committed',\n  ROLLING_BACK = 'rolling_back',\n  ROLLED_BACK = 'rolled_back',\n  FAILED = 'failed',\n}\n\n/**\n * 操作类型\n */\nexport enum OperationType {\n  MARK_READ = 'markRead',\n  BATCH_MARK_READ = 'batchMarkRead',\n  DELETE = 'delete',\n  BATCH_DELETE = 'batchDelete',\n  UPDATE = 'update',\n  BATCH_UPDATE = 'batchUpdate',\n}\n\n/**\n * 操作状态\n */\nexport enum OperationStatus {\n  PENDING = 'pending',\n  EXECUTING = 'executing',\n  SUCCESS = 'success',\n  FAILED = 'failed',\n  ROLLED_BACK = 'rolled_back',\n}\n\n/**\n * 事务隔离级别\n */\nexport enum TransactionIsolationLevel {\n  READ_UNCOMMITTED = 'read_uncommitted',\n  READ_COMMITTED = 'read_committed',\n  REPEATABLE_READ = 'repeatable_read',\n  SERIALIZABLE = 'serializable',\n}\n\n/**\n * 事务\n */\nexport interface Transaction {\n  id: string;\n  operations: TransactionOperation[];\n  status: TransactionStatus;\n  createdAt: number;\n  committedAt?: number;\n  rolledBackAt?: number;\n}\n\n/**\n * 事务操作\n */\nexport interface TransactionOperation {\n  id: string;\n  type: OperationType;\n  targetId: string;\n  data: unknown;\n  status: OperationStatus;\n  error?: Error;\n  rollback?: () => Promise<void>;\n  snapshot?: unknown;\n}\n\n/**\n * 事务选项\n */\nexport interface TransactionOptions {\n  /**\n   * 事务隔离级别（可选，覆盖全局配置）\n   */\n  isolationLevel?: TransactionIsolationLevel;\n  \n  /**\n   * 事务超时时间（毫秒，可选，覆盖全局配置）\n   */\n  timeout?: number;\n  \n  /**\n   * 是否自动提交（默认：true）\n   */\n  autoCommit?: boolean;\n  \n  /**\n   * 失败时是否自动回滚（默认：true）\n   */\n  autoRollback?: boolean;\n  \n  /**\n   * 事务描述（可选，用于日志和调试）\n   */\n  description?: string;\n}\n\n/**\n * 混合操作\n */\nexport interface MixedOperation {\n  type: OperationType;\n  id: string;\n  data: unknown;\n}\n\n/**\n * 事务结果\n */\nexport interface TransactionResult {\n  transactionId: string;\n  status: TransactionStatus;\n  successCount: number;\n  failureCount: number;\n  totalCount: number;\n  operations: TransactionOperationResult[];\n  error?: Error;\n}\n\n/**\n * 事务操作结果\n */\nexport interface TransactionOperationResult {\n  id: string;\n  type: OperationType;\n  targetId: string;\n  status: OperationStatus;\n  error?: Error;\n}\n\n// ========== NotificationManager 配置选项 ==========\n\n/**\n * NotificationManager 配置选项\n * @template TNotification 通知类型，完全由用户定义\n */\nexport interface NotificationManagerOptions<TNotification = unknown> {\n  // ========== 依赖注入（必需）==========\n  /**\n   * AuthManager 实例（必需）\n   * 用于获取当前用户ID和认证信息\n   */\n  authManager: AuthManager<unknown>;\n  \n  /**\n   * UserManager 实例（可选）\n   * 用于获取用户信息（用于通知个性化）\n   */\n  userManager?: UserManager<unknown, unknown>;\n  \n  // ========== @vlian/framework 依赖注入 ==========\n  /**\n   * @vlian/framework Storage 配置（可选）\n   * 用于通知数据持久化缓存\n   */\n  storage?: {\n    instance?: StorageInstance;\n    strategy?: StorageStrategy;\n  };\n  \n  /**\n   * @vlian/framework StateManager 配置（可选）\n   * 用于通知数据状态管理，支持跨组件共享\n   */\n  stateManager?: {\n    instance?: StateManagerInstance;\n    namespace?: string;\n  };\n  \n  // ========== 可观测性配置（完全可选，默认禁用）==========\n  /**\n   * 是否启用日志（默认：false）\n   */\n  enableLogging?: boolean;\n  \n  /**\n   * @vlian/framework Logger 实例（可选）\n   * 仅在 enableLogging=true 时使用\n   */\n  logger?: Logger;\n  \n  /**\n   * 是否启用监控（默认：false）\n   */\n  enableMonitoring?: boolean;\n  \n  /**\n   * @vlian/framework MonitoringService 实例（可选）\n   * 仅在 enableMonitoring=true 时使用\n   */\n  monitoring?: MonitoringService;\n  \n  /**\n   * 是否启用事件（默认：false）\n   */\n  enableEvents?: boolean;\n  \n  /**\n   * @vlian/framework AppEventBus 实例（可选）\n   * 仅在 enableEvents=true 时使用\n   */\n  eventBus?: AppEventBus;\n  \n  // ========== 实例隔离配置 ==========\n  /**\n   * 实例隔离模式（默认：'isolated'）\n   */\n  isolationMode?: 'isolated' | 'shared' | 'hybrid';\n  \n  // ========== 通知数据来源配置 ==========\n  /**\n   * 通知获取函数（可选）\n   */\n  notificationFetcher?: (options?: NotificationFetcherOptions) => Promise<NotificationList<TNotification>>;\n  \n  /**\n   * 通知更新函数（可选）\n   */\n  notificationUpdater?: (id: string, updates: Partial<TNotification>) => Promise<void>;\n  \n  /**\n   * 批量通知更新函数（可选）\n   */\n  notificationBatchUpdater?: (updates: Array<{ id: string; updates: Partial<TNotification> }>) => Promise<void>;\n  \n  /**\n   * 通知删除函数（可选）\n   */\n  notificationDeleter?: (id: string) => Promise<void>;\n  \n  /**\n   * 批量通知删除函数（可选）\n   */\n  notificationBatchDeleter?: (ids: string[]) => Promise<void>;\n  \n  // ========== 实时推送配置 ==========\n  /**\n   * 推送策略（默认：'auto'）\n   */\n  pushStrategy?: 'auto' | 'websocket' | 'polling' | 'disabled';\n  \n  /**\n   * WebSocket 配置\n   */\n  websocket?: {\n    url: string | (() => string);\n    protocols?: string | string[];\n    getToken?: () => Promise<string>;\n    heartbeatInterval?: number;\n    reconnect?: {\n      enabled?: boolean;\n      maxRetries?: number;\n      initialDelay?: number;\n      maxDelay?: number;\n      backoffMultiplier?: number;\n    };\n  };\n  \n  /**\n   * 轮询配置\n   */\n  polling?: {\n    interval?: number;\n    pollOnVisible?: boolean;\n    stopOnHidden?: boolean;\n  };\n  \n  // ========== 通知分类配置 ==========\n  /**\n   * 通知分类定义（可选）\n   */\n  categories?: Record<string, NotificationCategory>;\n  \n  /**\n   * 默认分类（可选）\n   */\n  defaultCategory?: string;\n  \n  // ========== 存储配置 ==========\n  /**\n   * 通知数据存储键名前缀（默认：'notifications:'）\n   */\n  notificationKeyPrefix?: string;\n  \n  /**\n   * 是否启用持久化缓存（默认：false）\n   */\n  enablePersistentCache?: boolean;\n  \n  // ========== 事件配置 ==========\n  /**\n   * 事件命名空间前缀（默认：'notification:'）\n   */\n  eventNamespace?: string;\n  \n  // ========== 验证配置 ==========\n  /**\n   * 通知验证函数（可选）\n   */\n  notificationValidator?: (notification: TNotification) => true | string;\n  \n  // ========== 缓存配置 ==========\n  /**\n   * 是否启用通知缓存（默认：true）\n   */\n  enableCache?: boolean;\n  \n  /**\n   * 缓存过期时间（毫秒，默认：不过期）\n   */\n  cacheExpiry?: number;\n  \n  /**\n   * 最大缓存数量（默认：1000）\n   */\n  maxCacheSize?: number;\n  \n  // ========== 分页配置 ==========\n  /**\n   * 默认分页大小（默认：20）\n   */\n  defaultPageSize?: number;\n  \n  /**\n   * 最大分页大小（默认：100）\n   */\n  maxPageSize?: number;\n  \n  // ========== 性能配置 ==========\n  /**\n   * 是否启用详细性能指标（默认：false）\n   */\n  enableDetailedMetrics?: boolean;\n  \n  // ========== 并发控制配置 ==========\n  /**\n   * 并发控制策略（默认：'auto'）\n   */\n  concurrencyStrategy?: 'auto' | 'queue' | 'latest';\n  \n  /**\n   * 队列最大长度（默认：100）\n   */\n  maxQueueSize?: number;\n  \n  /**\n   * 操作超时时间（毫秒，默认：30000）\n   */\n  operationTimeout?: number;\n  \n  // ========== 一致性配置 ==========\n  /**\n   * 是否启用版本号机制（默认：true）\n   */\n  enableVersionControl?: boolean;\n  \n  /**\n   * 冲突处理策略（默认：'auto'）\n   */\n  conflictStrategy?: 'auto' | 'reject' | 'retry';\n  \n  /**\n   * 冲突重试次数（默认：3）\n   */\n  conflictRetryCount?: number;\n  \n  /**\n   * 冲突重试延迟（毫秒，默认：100）\n   */\n  conflictRetryDelay?: number;\n  \n  /**\n   * 是否启用操作优先级（默认：true）\n   */\n  enableOperationPriority?: boolean;\n  \n  // ========== 事务配置 ==========\n  /**\n   * 是否启用事务支持（默认：true）\n   */\n  enableTransaction?: boolean;\n  \n  /**\n   * 事务隔离级别（默认：'read_committed'）\n   */\n  transactionIsolationLevel?: TransactionIsolationLevel;\n  \n  /**\n   * 事务超时时间（毫秒，默认：30000）\n   */\n  transactionTimeout?: number;\n  \n  /**\n   * 事务最大操作数（默认：100）\n   */\n  maxTransactionOperations?: number;\n  \n  /**\n   * 是否自动清理已完成的事务（默认：true）\n   */\n  autoCleanupTransactions?: boolean;\n  \n  /**\n   * 事务清理间隔（毫秒，默认：60000）\n   */\n  transactionCleanupInterval?: number;\n  \n  // ========== 其他配置 ==========\n  /**\n   * 实例 ID（可选）\n   */\n  instanceId?: string;\n  \n  /**\n   * 是否启用开发模式（默认：自动检测）\n   */\n  devMode?: boolean;\n  \n  /**\n   * 是否启用配置验证（默认：true）\n   */\n  validateConfig?: boolean;\n}\n\n// ========== 错误类型 ==========\n\n/**\n * 通知错误代码\n */\nexport enum NotificationErrorCode {\n  UNKNOWN_ERROR = 'UNKNOWN_ERROR',\n  NOTIFICATION_NOT_FOUND = 'NOTIFICATION_NOT_FOUND',\n  VERSION_CONFLICT = 'VERSION_CONFLICT',\n  TRANSACTION_ERROR = 'TRANSACTION_ERROR',\n  TRANSACTION_TIMEOUT = 'TRANSACTION_TIMEOUT',\n  TRANSACTION_ROLLBACK_ERROR = 'TRANSACTION_ROLLBACK_ERROR',\n  INVALID_CONFIG = 'INVALID_CONFIG',\n  OPERATION_FAILED = 'OPERATION_FAILED',\n  CACHE_ERROR = 'CACHE_ERROR',\n  STORAGE_ERROR = 'STORAGE_ERROR',\n  PUSH_ERROR = 'PUSH_ERROR',\n}\n\n/**\n * 通知错误\n */\nexport class NotificationError extends Error {\n  constructor(\n    message: string,\n    public code: NotificationErrorCode,\n    public cause?: Error\n  ) {\n    super(message);\n    this.name = 'NotificationError';\n    Object.setPrototypeOf(this, NotificationError.prototype);\n  }\n}\n\n/**\n * 版本冲突错误\n */\nexport class VersionConflictError extends NotificationError {\n  constructor(\n    public id: string,\n    public expectedVersion: number,\n    public actualVersion: number,\n    public operation: string\n  ) {\n    super(\n      `Version conflict for notification ${id}: expected ${expectedVersion}, got ${actualVersion}`,\n      NotificationErrorCode.VERSION_CONFLICT\n    );\n    this.name = 'VersionConflictError';\n  }\n}\n\n/**\n * 事务错误\n */\nexport class TransactionError extends NotificationError {\n  constructor(\n    public transactionId: string,\n    message: string,\n    cause?: Error\n  ) {\n    super(message, NotificationErrorCode.TRANSACTION_ERROR, cause);\n    this.name = 'TransactionError';\n  }\n}\n\n/**\n * 事务超时错误\n */\nexport class TransactionTimeoutError extends TransactionError {\n  constructor(transactionId: string, timeout: number) {\n    super(\n      transactionId,\n      `Transaction timeout after ${timeout}ms`,\n      new Error('Transaction timeout')\n    );\n    this.name = 'TransactionTimeoutError';\n  }\n}\n\n/**\n * 事务回滚错误\n */\nexport class TransactionRollbackError extends TransactionError {\n  constructor(\n    transactionId: string,\n    public failedOperations: string[],\n    cause?: Error\n  ) {\n    super(\n      transactionId,\n      `Transaction rollback failed for operations: ${failedOperations.join(', ')}`,\n      cause\n    );\n    this.name = 'TransactionRollbackError';\n  }\n}\n\n// ========== 健康检查和性能指标类型 ==========\n\n/**\n * 健康检查结果\n */\nexport interface HealthCheckResult {\n  healthy: boolean;\n  checks: {\n    storage?: { healthy: boolean; error?: string };\n    stateManager?: { healthy: boolean; error?: string };\n    eventBus?: { healthy: boolean; error?: string };\n    pushConnection?: { healthy: boolean; error?: string };\n  };\n  timestamp: number;\n}\n\n/**\n * 性能指标\n */\nexport interface PerformanceMetrics {\n  name: string;\n  duration: number;\n  timestamp: number;\n  tags?: Record<string, string>;\n}\n\n/**\n * 缓存统计信息\n */\nexport interface CacheStatistics {\n  hits: number;\n  misses: number;\n  size: number;\n  hitRate: number;\n}\n\n/**\n * 配置验证结果\n */\nexport interface ConfigValidationResult {\n  valid: boolean;\n  errors: string[];\n  warnings: string[];\n}\n"],"names":["NotificationError","NotificationErrorCode","NotificationEventType","OperationPriority","OperationStatus","OperationType","TransactionError","TransactionIsolationLevel","TransactionRollbackError","TransactionStatus","TransactionTimeoutError","VersionConflictError","Error","message","code","cause","name","Object","setPrototypeOf","prototype","id","expectedVersion","actualVersion","operation","transactionId","timeout","failedOperations","join"],"mappings":"AAAA;;;CAGC,GAED,iCAAiC;AAEjC;;CAEC;;;;;;;;;;;QAuhCYA;eAAAA;;QAjBDC;eAAAA;;QA34BAC;eAAAA;;QA+cAC;eAAAA;;QAsCAC;eAAAA;;QAZAC;eAAAA;;QAodCC;eAAAA;;QA7bDC;eAAAA;;QAydCC;eAAAA;;QA5fDC;eAAAA;;QA8eCC;eAAAA;;QAhCAC;eAAAA;;;;;;;;;;;;;;;;AA36BN,IAAA,AAAKT,+CAAAA;;;;;;;;;;;WAAAA;;AA+cL,IAAA,AAAKC,2CAAAA;;;;;;;WAAAA;;AAcL,IAAA,AAAKM,2CAAAA;;;;;;;WAAAA;;AAYL,IAAA,AAAKJ,uCAAAA;;;;;;;WAAAA;;AAYL,IAAA,AAAKD,yCAAAA;;;;;;WAAAA;;AAWL,IAAA,AAAKG,mDAAAA;;;;;WAAAA;;AA2YL,IAAA,AAAKN,+CAAAA;;;;;;;;;;;;WAAAA;;AAiBL,IAAA,AAAMD,oBAAN,MAAMA,0BAA0BY;IACrC,YACEC,OAAe,EACf,AAAOC,IAA2B,EAClC,AAAOC,KAAa,CACpB;QACA,KAAK,CAACF,gGAHCC,OAAAA,WACAC,QAAAA;QAGP,IAAI,CAACC,IAAI,GAAG;QACZC,OAAOC,cAAc,CAAC,IAAI,EAAElB,kBAAkBmB,SAAS;IACzD;AACF;AAKO,IAAA,AAAMR,uBAAN,MAAMA,6BAA6BX;IACxC,YACE,AAAOoB,EAAU,EACjB,AAAOC,eAAuB,EAC9B,AAAOC,aAAqB,EAC5B,AAAOC,SAAiB,CACxB;QACA,KAAK,CACH,CAAC,kCAAkC,EAAEH,GAAG,WAAW,EAAEC,gBAAgB,MAAM,EAAEC,eAAe,mNANvFF,KAAAA,SACAC,kBAAAA,sBACAC,gBAAAA,oBACAC,YAAAA;QAMP,IAAI,CAACP,IAAI,GAAG;IACd;AACF;AAKO,IAAA,AAAMV,mBAAN,MAAMA,yBAAyBN;IACpC,YACE,AAAOwB,aAAqB,EAC5BX,OAAe,EACfE,KAAa,CACb;QACA,KAAK,CAACF,8BAAkDE,8DAJjDS,gBAAAA;QAKP,IAAI,CAACR,IAAI,GAAG;IACd;AACF;AAKO,IAAA,AAAMN,0BAAN,MAAMA,gCAAgCJ;IAC3C,YAAYkB,aAAqB,EAAEC,OAAe,CAAE;QAClD,KAAK,CACHD,eACA,CAAC,0BAA0B,EAAEC,QAAQ,EAAE,CAAC,EACxC,IAAIb,MAAM;QAEZ,IAAI,CAACI,IAAI,GAAG;IACd;AACF;AAKO,IAAA,AAAMR,2BAAN,MAAMA,iCAAiCF;IAC5C,YACEkB,aAAqB,EACrB,AAAOE,gBAA0B,EACjCX,KAAa,CACb;QACA,KAAK,CACHS,eACA,CAAC,4CAA4C,EAAEE,iBAAiBC,IAAI,CAAC,OAAO,EAC5EZ,iEANKW,mBAAAA;QAQP,IAAI,CAACV,IAAI,GAAG;IACd;AACF"}

package/dist/cjs/managers/NotificationManager/utils/IsolationUtils.js

@@ -0,0 +1,56 @@
+/**
+ * 实例隔离工具
+ * 用于处理多实例隔离的场景
+ */ /**
+ * 隔离工具
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "IsolationUtils", {
+    enumerable: true,
+    get: function() {
+        return IsolationUtils;
+    }
+});
+let IsolationUtils = class IsolationUtils {
+    /**
+   * 生成隔离键名
+   */ static generateIsolatedKey(baseKey, instanceId, isolationMode = 'isolated') {
+        if (isolationMode === 'shared') {
+            return baseKey;
+        }
+        if (isolationMode === 'hybrid') {
+            // 混合模式：部分共享，部分隔离
+            // 这里可以根据具体需求实现
+            return instanceId ? `${instanceId}:${baseKey}` : baseKey;
+        }
+        // isolated 模式：完全隔离
+        return instanceId ? `${instanceId}:${baseKey}` : baseKey;
+    }
+    /**
+   * 生成事件命名空间
+   */ static generateEventNamespace(baseNamespace, instanceId, isolationMode = 'isolated') {
+        if (isolationMode === 'shared') {
+            return baseNamespace;
+        }
+        if (isolationMode === 'hybrid') {
+            return instanceId ? `${baseNamespace}${instanceId}:` : baseNamespace;
+        }
+        // isolated 模式
+        return instanceId ? `${baseNamespace}${instanceId}:` : baseNamespace;
+    }
+    /**
+   * 检查键名是否属于当前实例
+   */ static isKeyForInstance(key, instanceId, isolationMode = 'isolated') {
+        if (isolationMode === 'shared') {
+            return true;
+        }
+        if (!instanceId) {
+            return true;
+        }
+        return key.startsWith(`${instanceId}:`);
+    }
+};
+
+//# sourceMappingURL=IsolationUtils.js.map

package/dist/cjs/managers/NotificationManager/utils/IsolationUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/NotificationManager/utils/IsolationUtils.ts"],"sourcesContent":["/**\n * 实例隔离工具\n * 用于处理多实例隔离的场景\n */\n\n/**\n * 隔离工具\n */\nexport class IsolationUtils {\n  /**\n   * 生成隔离键名\n   */\n  static generateIsolatedKey(\n    baseKey: string,\n    instanceId?: string,\n    isolationMode: 'isolated' | 'shared' | 'hybrid' = 'isolated'\n  ): string {\n    if (isolationMode === 'shared') {\n      return baseKey;\n    }\n    \n    if (isolationMode === 'hybrid') {\n      // 混合模式：部分共享，部分隔离\n      // 这里可以根据具体需求实现\n      return instanceId ? `${instanceId}:${baseKey}` : baseKey;\n    }\n    \n    // isolated 模式：完全隔离\n    return instanceId ? `${instanceId}:${baseKey}` : baseKey;\n  }\n  \n  /**\n   * 生成事件命名空间\n   */\n  static generateEventNamespace(\n    baseNamespace: string,\n    instanceId?: string,\n    isolationMode: 'isolated' | 'shared' | 'hybrid' = 'isolated'\n  ): string {\n    if (isolationMode === 'shared') {\n      return baseNamespace;\n    }\n    \n    if (isolationMode === 'hybrid') {\n      return instanceId ? `${baseNamespace}${instanceId}:` : baseNamespace;\n    }\n    \n    // isolated 模式\n    return instanceId ? `${baseNamespace}${instanceId}:` : baseNamespace;\n  }\n  \n  /**\n   * 检查键名是否属于当前实例\n   */\n  static isKeyForInstance(\n    key: string,\n    instanceId?: string,\n    isolationMode: 'isolated' | 'shared' | 'hybrid' = 'isolated'\n  ): boolean {\n    if (isolationMode === 'shared') {\n      return true;\n    }\n    \n    if (!instanceId) {\n      return true;\n    }\n    \n    return key.startsWith(`${instanceId}:`);\n  }\n}\n"],"names":["IsolationUtils","generateIsolatedKey","baseKey","instanceId","isolationMode","generateEventNamespace","baseNamespace","isKeyForInstance","key","startsWith"],"mappings":"AAAA;;;CAGC,GAED;;CAEC;;;;+BACYA;;;eAAAA;;;AAAN,IAAA,AAAMA,iBAAN,MAAMA;IACX;;GAEC,GACD,OAAOC,oBACLC,OAAe,EACfC,UAAmB,EACnBC,gBAAkD,UAAU,EACpD;QACR,IAAIA,kBAAkB,UAAU;YAC9B,OAAOF;QACT;QAEA,IAAIE,kBAAkB,UAAU;YAC9B,iBAAiB;YACjB,eAAe;YACf,OAAOD,aAAa,GAAGA,WAAW,CAAC,EAAED,SAAS,GAAGA;QACnD;QAEA,mBAAmB;QACnB,OAAOC,aAAa,GAAGA,WAAW,CAAC,EAAED,SAAS,GAAGA;IACnD;IAEA;;GAEC,GACD,OAAOG,uBACLC,aAAqB,EACrBH,UAAmB,EACnBC,gBAAkD,UAAU,EACpD;QACR,IAAIA,kBAAkB,UAAU;YAC9B,OAAOE;QACT;QAEA,IAAIF,kBAAkB,UAAU;YAC9B,OAAOD,aAAa,GAAGG,gBAAgBH,WAAW,CAAC,CAAC,GAAGG;QACzD;QAEA,cAAc;QACd,OAAOH,aAAa,GAAGG,gBAAgBH,WAAW,CAAC,CAAC,GAAGG;IACzD;IAEA;;GAEC,GACD,OAAOC,iBACLC,GAAW,EACXL,UAAmB,EACnBC,gBAAkD,UAAU,EACnD;QACT,IAAIA,kBAAkB,UAAU;YAC9B,OAAO;QACT;QAEA,IAAI,CAACD,YAAY;YACf,OAAO;QACT;QAEA,OAAOK,IAAIC,UAAU,CAAC,GAAGN,WAAW,CAAC,CAAC;IACxC;AACF"}

package/dist/cjs/managers/NotificationManager/utils/index.js

@@ -0,0 +1,15 @@
+/**
+ * 工具函数导出
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "IsolationUtils", {
+    enumerable: true,
+    get: function() {
+        return _IsolationUtils.IsolationUtils;
+    }
+});
+const _IsolationUtils = require("./IsolationUtils");
+
+//# sourceMappingURL=index.js.map

package/dist/cjs/managers/NotificationManager/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/managers/NotificationManager/utils/index.ts"],"sourcesContent":["/**\n * 工具函数导出\n */\n\nexport { IsolationUtils } from './IsolationUtils';\n"],"names":["IsolationUtils"],"mappings":"AAAA;;CAEC;;;;+BAEQA;;;eAAAA,8BAAc;;;gCAAQ"}