@vlian/infrastructure 0.9.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 vlian
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,242 @@
+# @vlian/infrastructure
+
+通用业务基础设施包，提供业务无关的通用能力，可以被多个业务模块复用。
+
+## 特性
+
+- 🎯 **业务无关性**：所有功能不绑定特定业务场景，通过配置适配不同场景
+- ⚙️ **可配置性**：通过配置参数适配不同业务需求
+- 🧩 **可组合性**：按需使用，不强制全量引入
+- 🔌 **框架无关性**：可以独立使用，也可以与框架集成
+- 💻 **纯逻辑层**：不包含 UI 实现，只提供业务逻辑和 API
+- 📦 **TypeScript 支持**：完整的类型定义，提供优秀的开发体验
+- 🚀 **高性能**：内置缓存机制，支持并发控制，优化性能
+
+## 安装
+
+```bash
+npm install @vlian/infrastructure
+# 或
+pnpm add @vlian/infrastructure
+# 或
+yarn add @vlian/infrastructure
+```
+
+## 核心模块
+
+### AuthManager（认证管理）
+
+提供登录/登出、Token 管理、用户信息管理等核心认证能力。
+
+```typescript
+import { AuthManager } from '@vlian/infrastructure';
+
+const authManager = new AuthManager({
+  storage: { strategy: 'local' },
+  tokenKey: 'auth_token'
+});
+
+await authManager.login('username', 'password');
+const isAuth = authManager.isAuthenticated();
+```
+
+### PermissionManager（权限管理）
+
+提供角色管理、权限点管理、权限检查等能力。
+
+```typescript
+import { PermissionManager } from '@vlian/infrastructure';
+
+const permissionManager = new PermissionManager({
+  authManager,
+  cacheEnabled: true
+});
+
+const canEdit = permissionManager.hasPermission('user:edit');
+const isAdmin = permissionManager.hasRole('admin');
+```
+
+### ThemeManager（主题管理）
+
+提供主题切换、主题配置、主题持久化等能力。
+
+```typescript
+import { ThemeManager } from '@vlian/infrastructure';
+
+const themeManager = new ThemeManager({
+  defaultTheme: 'light',
+  enableCache: true
+});
+
+themeManager.setTheme('dark');
+const currentTheme = themeManager.getTheme();
+```
+
+### UserManager（用户管理）
+
+提供用户信息获取/更新、用户设置管理等能力。
+
+```typescript
+import { UserManager } from '@vlian/infrastructure';
+
+const userManager = new UserManager({
+  authManager,
+  enableCache: true
+});
+
+const userInfo = await userManager.getUserInfo();
+await userManager.updateUserInfo({ email: 'new@example.com' });
+```
+
+### NotificationManager（通知管理）
+
+提供系统通知、消息通知、待办事项等能力。
+
+```typescript
+import { NotificationManager } from '@vlian/infrastructure';
+
+const notificationManager = new NotificationManager({
+  notificationFetcher: async () => {
+    const response = await fetch('/api/notifications');
+    return response.json();
+  },
+  enableCache: true
+});
+
+const notifications = await notificationManager.getNotifications();
+const unreadCount = await notificationManager.getUnreadCount();
+```
+
+### DictionaryManager（数据字典）
+
+提供字典数据获取、字典缓存、字典格式化等能力。
+
+```typescript
+import { DictionaryManager } from '@vlian/infrastructure';
+
+const dictionaryManager = new DictionaryManager({
+  dictionaryFetcher: async (code) => {
+    const response = await fetch(`/api/dictionaries/${code}`);
+    return response.json();
+  },
+  enableCache: true
+});
+
+const statusDict = await dictionaryManager.getDictionary('status');
+const label = await dictionaryManager.getDictionaryValue('status', 'active');
+```
+
+### SystemConfigManager（系统配置）
+
+提供配置获取/更新、配置缓存等能力。
+
+```typescript
+import { SystemConfigManager } from '@vlian/infrastructure';
+
+const systemConfigManager = new SystemConfigManager({
+  configFetcher: async (key) => {
+    const response = await fetch(`/api/config${key ? `/${key}` : ''}`);
+    return response.json();
+  },
+  enableCache: true
+});
+
+const theme = await systemConfigManager.getConfig('theme');
+await systemConfigManager.updateConfig('theme', 'dark');
+```
+
+## 快速开始
+
+### 基础示例
+
+```typescript
+import { AuthManager, PermissionManager } from '@vlian/infrastructure';
+import { Storage, Logger } from '@vlian/framework';
+
+// 初始化依赖
+const storage = new Storage();
+const logger = new Logger();
+
+// 创建 Manager 实例
+const authManager = new AuthManager({
+  storage,
+  logger,
+  tokenKey: 'auth_token',
+  refreshTokenKey: 'refresh_token'
+});
+
+const permissionManager = new PermissionManager({
+  authManager,
+  cacheEnabled: true
+});
+
+// 使用
+await authManager.login('username', 'password');
+const canEdit = permissionManager.hasPermission('user:edit');
+```
+
+## 文档
+
+详细的文档请参考：
+
+- [认证管理使用手册](./docs/认证管理/使用手册.md)
+- [权限管理使用手册](./docs/权限管理/使用手册.md)
+- [主题管理使用手册](./docs/主题管理/使用手册.md)
+- [用户管理使用手册](./docs/用户管理/使用手册.md)
+- [通知管理使用手册](./docs/通知管理/使用手册.md)
+- [数据字典使用手册](./docs/数据字典/使用手册.md)
+- [系统配置使用手册](./docs/系统配置/使用手册.md)
+
+## 依赖
+
+- **必需依赖**：`@vlian/framework` (^1.1.0)
+- **开发依赖**：TypeScript, SWC, Vitest
+
+## 架构设计
+
+本项目遵循以下核心原则：
+
+1. **业务无关性**：配置类型完全泛型化，由用户定义
+2. **依赖注入**：依赖 @vlian/framework，通过依赖注入解耦
+3. **单一职责**：每个模块职责单一，便于维护和测试
+4. **方法复用**：公共逻辑提取到工具模块，避免重复代码
+5. **框架依赖明确**：所有日志、监控、存储、状态管理、事件总线都使用 @vlian/framework 提供的服务
+6. **可选依赖**：日志、监控、事件可完全禁用，降低小项目使用成本
+7. **实例隔离**：支持实例隔离模式，避免 SSR/微前端中的全局单例争抢
+8. **并发控制**：支持串行队列和版本号机制，保证操作一致性
+
+## 开发
+
+```bash
+# 安装依赖
+pnpm install
+
+# 构建
+pnpm run build
+
+# 开发模式（监听文件变化）
+pnpm run dev
+
+# 运行测试
+pnpm run test
+
+# 测试覆盖率
+pnpm run test:coverage
+```
+
+## 许可证
+
+MIT
+
+## 更新日志
+
+详细的更新日志请参考 [CHANGELOG.md](./CHANGELOG.md)
+
+## 贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+## 相关链接
+
+- [GitHub](https://github.com/vlian/infrastructure)
+- [问题反馈](https://github.com/vlian/infrastructure/issues)

package/dist/cjs/index.js

@@ -0,0 +1,124 @@
+/**
+ * @vlian/infrastructure
+ * 通用业务基础设施包
+ * 
+ * 提供业务无关的通用能力，可以被多个业务模块复用
+ */ // 导出所有 Manager
+"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 AuthError () {
+        return _AuthManager.AuthError;
+    },
+    get AuthErrorCode () {
+        return _AuthManager.AuthErrorCode;
+    },
+    get AuthEventType () {
+        return _AuthManager.AuthEventType;
+    },
+    get AuthManager () {
+        return _AuthManager.AuthManager;
+    },
+    get DictionaryError () {
+        return _DictionaryManager.DictionaryError;
+    },
+    get DictionaryErrorCode () {
+        return _DictionaryManager.DictionaryErrorCode;
+    },
+    get DictionaryEventType () {
+        return _DictionaryManager.DictionaryEventType;
+    },
+    get DictionaryManager () {
+        return _DictionaryManager.DictionaryManager;
+    },
+    get NotificationError () {
+        return _NotificationManager.NotificationError;
+    },
+    get NotificationErrorCode () {
+        return _NotificationManager.NotificationErrorCode;
+    },
+    get NotificationEventType () {
+        return _NotificationManager.NotificationEventType;
+    },
+    get NotificationManager () {
+        return _NotificationManager.NotificationManager;
+    },
+    get PermissionError () {
+        return _PermissionManager.PermissionError;
+    },
+    get PermissionEventType () {
+        return _PermissionManager.PermissionEventType;
+    },
+    get PermissionManager () {
+        return _PermissionManager.PermissionManager;
+    },
+    get SystemConfigError () {
+        return _SystemConfigManager.SystemConfigError;
+    },
+    get SystemConfigErrorCode () {
+        return _SystemConfigManager.SystemConfigErrorCode;
+    },
+    get SystemConfigEventType () {
+        return _SystemConfigManager.SystemConfigEventType;
+    },
+    get SystemConfigManager () {
+        return _SystemConfigManager.SystemConfigManager;
+    },
+    get ThemeError () {
+        return _ThemeManager.ThemeError;
+    },
+    get ThemeErrorCode () {
+        return _ThemeManager.ThemeErrorCode;
+    },
+    get ThemeEventType () {
+        return _ThemeManager.ThemeEventType;
+    },
+    get ThemeManager () {
+        return _ThemeManager.ThemeManager;
+    },
+    get TransactionError () {
+        return _NotificationManager.TransactionError;
+    },
+    get TransactionRollbackError () {
+        return _NotificationManager.TransactionRollbackError;
+    },
+    get TransactionTimeoutError () {
+        return _NotificationManager.TransactionTimeoutError;
+    },
+    get UserError () {
+        return _UserManager.UserError;
+    },
+    get UserErrorCode () {
+        return _UserManager.UserErrorCode;
+    },
+    get UserEventType () {
+        return _UserManager.UserEventType;
+    },
+    get UserManager () {
+        return _UserManager.UserManager;
+    },
+    get VersionConflictError () {
+        return _NotificationManager.VersionConflictError;
+    },
+    get version () {
+        return version;
+    }
+});
+const _AuthManager = require("./managers/AuthManager");
+const _PermissionManager = require("./managers/PermissionManager");
+const _ThemeManager = require("./managers/ThemeManager");
+const _UserManager = require("./managers/UserManager");
+const _NotificationManager = require("./managers/NotificationManager");
+const _DictionaryManager = require("./managers/DictionaryManager");
+const _SystemConfigManager = require("./managers/SystemConfigManager");
+const version = '0.2.0';
+
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/index.ts"],"sourcesContent":["/**\n * @vlian/infrastructure\n * 通用业务基础设施包\n * \n * 提供业务无关的通用能力，可以被多个业务模块复用\n */\n\n// 导出所有 Manager\nexport { AuthManager } from './managers/AuthManager';\nexport { PermissionManager } from './managers/PermissionManager';\nexport { ThemeManager } from './managers/ThemeManager';\nexport { UserManager } from './managers/UserManager';\nexport { NotificationManager } from './managers/NotificationManager';\nexport { DictionaryManager } from './managers/DictionaryManager';\nexport { SystemConfigManager } from './managers/SystemConfigManager';\n\n// 导出枚举和类（值导出）\nexport {\n  AuthEventType,\n  AuthError,\n  AuthErrorCode,\n} from './managers/AuthManager';\nexport {\n  PermissionEventType,\n} from './managers/PermissionManager';\nexport {\n  ThemeEventType,\n  ThemeError,\n  ThemeErrorCode,\n} from './managers/ThemeManager';\nexport {\n  UserEventType,\n  UserError,\n  UserErrorCode,\n} from './managers/UserManager';\nexport {\n  DictionaryEventType,\n  DictionaryError,\n  DictionaryErrorCode,\n} from './managers/DictionaryManager';\nexport {\n  SystemConfigEventType,\n  SystemConfigError,\n  SystemConfigErrorCode,\n} from './managers/SystemConfigManager';\nexport {\n  NotificationEventType,\n  NotificationError,\n  NotificationErrorCode,\n  VersionConflictError,\n  TransactionError,\n  TransactionTimeoutError,\n  TransactionRollbackError,\n} from './managers/NotificationManager';\n\n// 导出类型定义\nexport type {\n  AuthOptions,\n  AuthData,\n  TokenInfo,\n  RefreshTokenFunction,\n  StorageStrategy,\n  EventMetadata,\n  EventListenerOptions,\n  AuthSetEventData,\n  AuthClearEventData,\n  TokenUpdateEventData,\n  TokenRefreshEventData,\n  TokenRefreshFailureEventData,\n  AuthStateChangeEventData,\n  Environment,\n  HealthCheckResult,\n  PerformanceMetrics,\n  ConfigValidationResult,\n  RefreshRetryConfig,\n  NetworkStatusListener,\n  LifecycleHooks,\n  Middleware,\n  MiddlewareContext,\n} from './managers/AuthManager';\nexport type {\n  PermissionOptions,\n  ExtendedPermissionOptions,\n  PermissionData,\n  PermissionTree,\n  PermissionTreeNode,\n  PermissionTreeConfig,\n  PerformanceStatistics,\n  DebugInfo,\n  HealthCheckDiagnostics,\n  AuditLogEntry,\n  PermissionChangeHistory,\n  PermissionCheckResult,\n  PermissionStateChangeData,\n  PermissionErrorCode,\n  PermissionConfigPreset,\n  PermissionConfigGroups,\n  PermissionCheckStrategy,\n  PermissionCheckMiddleware,\n  PermissionPlugin,\n  PermissionDataSource,\n  DataSourceMergeStrategy,\n  PermissionMatcher,\n  CacheItem,\n  RateLimitConfig,\n  EnvironmentAdapter,\n} from './managers/PermissionManager';\nexport {\n  PermissionError,\n} from './managers/PermissionManager';\nexport type {\n  ThemeOptions,\n  ThemeConfig,\n  ThemeChangedEventData,\n  ThemeConfigUpdatedEventData,\n  HealthCheckResult as ThemeHealthCheckResult,\n  PerformanceMetrics as ThemePerformanceMetrics,\n  ConfigValidationResult as ThemeConfigValidationResult,\n  LifecycleHooks as ThemeLifecycleHooks,\n  LifecycleHook as ThemeLifecycleHook,\n  BeforeThemeChangeContext,\n  AfterThemeChangeContext,\n  BeforeConfigUpdateContext,\n  AfterConfigUpdateContext,\n  CacheStatistics,\n  BatchUpdateItem,\n  BatchUpdateResult,\n} from './managers/ThemeManager';\nexport type {\n  UserOptions,\n  EventMetadata as UserEventMetadata,\n  EventListenerOptions as UserEventListenerOptions,\n  SyncQueueStatus,\n  HealthCheckResult as UserHealthCheckResult,\n  PerformanceMetrics as UserPerformanceMetrics,\n  ConfigValidationResult as UserConfigValidationResult,\n  AppEventBus,\n  Logger,\n  MonitoringService,\n  StorageInstance,\n  StateManagerInstance,\n  StorageStrategy as UserStorageStrategy,\n  Environment as UserEnvironment,\n  AuthManager as UserAuthManager,\n} from './managers/UserManager';\nexport type {\n  DictionaryOptions,\n  DictionaryItem,\n  DictionaryData,\n  GetDictionaryOptions,\n  GetDictionarySyncOptions,\n  FormatDictionaryOptions,\n  DictionaryValueQuery,\n  PreloadStatus,\n  HealthCheckResult as DictionaryHealthCheckResult,\n  PerformanceMetrics as DictionaryPerformanceMetrics,\n  CacheStatistics as DictionaryCacheStatistics,\n  DictionaryDiff,\n  DictionaryLoadedEventData,\n  DictionaryUpdatedEventData,\n  EventMetadata as DictionaryEventMetadata,\n  EventListenerOptions as DictionaryEventListenerOptions,\n  AppEventBus as DictionaryAppEventBus,\n  Logger as DictionaryLogger,\n  MonitoringService as DictionaryMonitoringService,\n  StorageInstance as DictionaryStorageInstance,\n  StateManagerInstance as DictionaryStateManagerInstance,\n  StorageStrategy as DictionaryStorageStrategy,\n  Environment as DictionaryEnvironment,\n} from './managers/DictionaryManager';\nexport type {\n  SystemConfigOptions,\n  SystemConfigEventType as SystemConfigEventTypeEnum,\n  EventMetadata as SystemConfigEventMetadata,\n  EventListenerOptions as SystemConfigEventListenerOptions,\n  GetConfigOptions,\n  GetConfigSyncOptions,\n  UpdateConfigOptions,\n  ConsistencyLevel,\n  ConfigDiff,\n  ValidationResult,\n  BatchUpdateResult as SystemConfigBatchUpdateResult,\n  HealthCheckResult as SystemConfigHealthCheckResult,\n  PerformanceMetrics as SystemConfigPerformanceMetrics,\n  CacheStatistics as SystemConfigCacheStatistics,\n  Environment as SystemConfigEnvironment,\n  ConfigTypeDefinition,\n  ConfigUpdatedEventData,\n  ConfigBatchUpdatedEventData,\n  AppEventBus as SystemConfigAppEventBus,\n  Logger as SystemConfigLogger,\n  MonitoringService as SystemConfigMonitoringService,\n  StorageInstance as SystemConfigStorageInstance,\n  StateManagerInstance as SystemConfigStateManagerInstance,\n  StorageStrategy as SystemConfigStorageStrategy,\n} from './managers/SystemConfigManager';\nexport type {\n  NotificationManagerOptions,\n  Notification,\n  NotificationList,\n  NotificationCategory,\n  GetNotificationsOptions,\n  GetNotificationsSyncOptions,\n  GetNotificationOptions,\n  GetNotificationSyncOptions,\n  UpdateNotificationOptions,\n  DeleteNotificationOptions,\n  BatchUpdateResult as NotificationBatchUpdateResult,\n  GetUnreadCountOptions,\n  GetUnreadCountSyncOptions,\n  RefreshNotificationsOptions,\n  ClearCacheOptions,\n  StartRealtimePushOptions,\n  PushConnectionStatus,\n  NotificationFilter,\n  SearchNotificationsOptions,\n  EventMetadata as NotificationEventMetadata,\n  EventListenerOptions as NotificationEventListenerOptions,\n  HealthCheckResult as NotificationHealthCheckResult,\n  PerformanceMetrics as NotificationPerformanceMetrics,\n  CacheStatistics as NotificationCacheStatistics,\n  ConfigValidationResult as NotificationConfigValidationResult,\n  TransactionOptions,\n  TransactionResult,\n  MixedOperation,\n  NotificationUpdatedEventData,\n  NotificationReadEventData,\n  NotificationDeletedEventData,\n  NotificationReceivedEventData,\n  UnreadCountChangedEventData,\n  AppEventBus as NotificationAppEventBus,\n  Logger as NotificationLogger,\n  MonitoringService as NotificationMonitoringService,\n  StorageInstance as NotificationStorageInstance,\n  StateManagerInstance as NotificationStateManagerInstance,\n  StorageStrategy as NotificationStorageStrategy,\n  Environment as NotificationEnvironment,\n  AuthManager as NotificationAuthManager,\n  UserManager as NotificationUserManager,\n} from './managers/NotificationManager';\n\n// 临时导出，用于验证构建\nexport const version = '0.2.0';\n"],"names":["AuthError","AuthErrorCode","AuthEventType","AuthManager","DictionaryError","DictionaryErrorCode","DictionaryEventType","DictionaryManager","NotificationError","NotificationErrorCode","NotificationEventType","NotificationManager","PermissionError","PermissionEventType","PermissionManager","SystemConfigError","SystemConfigErrorCode","SystemConfigEventType","SystemConfigManager","ThemeError","ThemeErrorCode","ThemeEventType","ThemeManager","TransactionError","TransactionRollbackError","TransactionTimeoutError","UserError","UserErrorCode","UserEventType","UserManager","VersionConflictError","version"],"mappings":"AAAA;;;;;CAKC,GAED,eAAe;;;;;;;;;;;;QAYbA;eAAAA,sBAAS;;QACTC;eAAAA,0BAAa;;QAFbC;eAAAA,0BAAa;;QAVNC;eAAAA,wBAAW;;QA6BlBC;eAAAA,kCAAe;;QACfC;eAAAA,sCAAmB;;QAFnBC;eAAAA,sCAAmB;;QAvBZC;eAAAA,oCAAiB;;QAkCxBC;eAAAA,sCAAiB;;QACjBC;eAAAA,0CAAqB;;QAFrBC;eAAAA,0CAAqB;;QAlCdC;eAAAA,wCAAmB;;QAgG1BC;eAAAA,kCAAe;;QArFfC;eAAAA,sCAAmB;;QAdZC;eAAAA,oCAAiB;;QAiCxBC;eAAAA,sCAAiB;;QACjBC;eAAAA,0CAAqB;;QAFrBC;eAAAA,0CAAqB;;QA3BdC;eAAAA,wCAAmB;;QAa1BC;eAAAA,wBAAU;;QACVC;eAAAA,4BAAc;;QAFdC;eAAAA,4BAAc;;QAhBPC;eAAAA,0BAAY;;QAwCnBC;eAAAA,qCAAgB;;QAEhBC;eAAAA,6CAAwB;;QADxBC;eAAAA,4CAAuB;;QAnBvBC;eAAAA,sBAAS;;QACTC;eAAAA,0BAAa;;QAFbC;eAAAA,0BAAa;;QApBNC;eAAAA,wBAAW;;QAsClBC;eAAAA,yCAAoB;;QAiMTC;eAAAA;;;6BA1Oe;mCACM;8BACL;6BACD;qCACQ;mCACF;qCACE;AAoO7B,MAAMA,UAAU"}