@vlian/infrastructure 0.9.10

package/dist/types/managers/UserManager/utils/DataManagerUtils.d.ts

@@ -0,0 +1,60 @@
+/**
+ * 数据管理工具函数
+ * 提取 UserInfoManager 和 UserSettingsManager 的公共逻辑
+ */
+import type { AuthManager } from '../types';
+import type { CacheManager } from '../core/CacheManager';
+import type { StateManagerWrapper } from '../core/StateManagerWrapper';
+import type { ErrorHandler } from '../modules/ErrorHandler';
+import type { PerformanceMonitor } from '../observability/PerformanceMonitor';
+import type { EventManager } from '../observability/EventManager';
+import type { UserEventType } from '../types';
+/**
+ * 验证数据
+ */
+export declare function validateData<T>(data: Partial<T>, validator?: (data: Partial<T>) => boolean | string): void;
+/**
+ * 要求用户已认证
+ */
+export declare function requireAuthenticatedUser(authManager: AuthManager<unknown>, operation: string, errorHandler: ErrorHandler): string;
+/**
+ * 检查是否是首次加载
+ */
+export declare function isFirstLoad<T>(currentData: T | null): boolean;
+/**
+ * 合并数据
+ */
+export declare function mergeData<T>(current: T | null, partial: Partial<T>): T;
+/**
+ * 更新缓存（如果启用）
+ */
+export declare function updateCacheIfEnabled<T>(enableCache: boolean, cacheManager: CacheManager<T>, key: string, value: T, expiry?: number): void;
+/**
+ * 更新状态管理（如果存在）
+ */
+export declare function updateStateIfEnabled<T>(stateManager: StateManagerWrapper | undefined, key: string, value: T): void;
+/**
+ * 从缓存或状态管理获取数据
+ */
+export declare function getDataFromCacheOrState<T>(cacheManager: CacheManager<T>, stateManager: StateManagerWrapper | undefined, enableCache: boolean, cacheKey: string): T | null;
+/**
+ * 触发加载或刷新事件
+ */
+export declare function emitLoadOrRefreshEvent<EventData extends Record<string, unknown>>(eventManager: EventManager, isFirstLoad: boolean, loadedEvent: UserEventType, refreshedEvent: UserEventType, data: EventData, userId: string): void;
+/**
+ * 检查缓存是否有效（非强制刷新时）
+ */
+export declare function shouldUseCache<T>(force: boolean, enableCache: boolean, cacheManager: CacheManager<T>, cacheKey: string): boolean;
+/**
+ * 性能监控包装器
+ */
+export declare function withPerformanceMonitor<T>(operation: string, performanceMonitor: PerformanceMonitor, fn: () => Promise<T>, metadata?: Record<string, unknown>): Promise<T>;
+/**
+ * 错误处理包装器
+ */
+export declare function withErrorHandler<T>(errorHandler: ErrorHandler, operation: string, fn: () => Promise<T>, context?: Record<string, unknown>): Promise<T>;
+/**
+ * 完整的异步操作包装器（性能监控 + 错误处理）
+ */
+export declare function withAsyncOperation<T>(operation: string, performanceMonitor: PerformanceMonitor, errorHandler: ErrorHandler, fn: () => Promise<T>, context?: Record<string, unknown>): Promise<T>;
+//# sourceMappingURL=DataManagerUtils.d.ts.map

package/dist/types/managers/UserManager/utils/DataManagerUtils.d.ts.map

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

package/dist/types/managers/UserManager/utils/LoggingUtils.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 日志工具函数
+ * 统一日志格式和日志记录逻辑
+ */
+import type { Logger } from '../types';
+/**
+ * 日志上下文
+ */
+export interface LogContext {
+    operation?: string;
+    userId?: string;
+    [key: string]: unknown;
+}
+/**
+ * 记录操作开始日志
+ */
+export declare function logOperationStart(logger: Logger | undefined, operation: string, context?: LogContext): void;
+/**
+ * 记录操作成功日志
+ */
+export declare function logOperationSuccess(logger: Logger | undefined, operation: string, context?: LogContext): void;
+/**
+ * 记录操作失败日志
+ */
+export declare function logOperationError(logger: Logger | undefined, operation: string, error: unknown, context?: LogContext): void;
+/**
+ * 记录警告日志
+ */
+export declare function logWarning(logger: Logger | undefined, message: string, context?: LogContext): void;
+/**
+ * 记录信息日志
+ */
+export declare function logInfo(logger: Logger | undefined, message: string, context?: LogContext): void;
+//# sourceMappingURL=LoggingUtils.d.ts.map

package/dist/types/managers/UserManager/utils/LoggingUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoggingUtils.d.ts","sourceRoot":"","sources":["../../../../../src/managers/UserManager/utils/LoggingUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,UAAU,GACnB,IAAI,CAKN;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,UAAU,GACnB,IAAI,CAKN;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,UAAU,GACnB,IAAI,CASN;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,UAAU,GACnB,IAAI,CAKN;AAED;;GAEG;AACH,wBAAgB,OAAO,CACrB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,UAAU,GACnB,IAAI,CAKN"}

package/dist/types/managers/UserManager/utils/MonitoringUtils.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 监控工具函数
+ * 统一监控上报逻辑
+ */
+import type { MonitoringService } from '../types';
+/**
+ * 上报错误到监控服务
+ */
+export declare function reportError(monitoring: MonitoringService | undefined, error: unknown, context?: Record<string, unknown>): void;
+/**
+ * 上报事件到监控服务
+ */
+export declare function reportEvent(monitoring: MonitoringService | undefined, eventName: string, properties?: Record<string, unknown>): void;
+/**
+ * 上报性能指标到监控服务
+ */
+export declare function reportPerformance(monitoring: MonitoringService | undefined, metrics: Record<string, number>, context?: Record<string, unknown>): void;
+//# sourceMappingURL=MonitoringUtils.d.ts.map

package/dist/types/managers/UserManager/utils/MonitoringUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MonitoringUtils.d.ts","sourceRoot":"","sources":["../../../../../src/managers/UserManager/utils/MonitoringUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD;;GAEG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,iBAAiB,GAAG,SAAS,EACzC,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAUN;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,iBAAiB,GAAG,SAAS,EACzC,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,IAAI,CAUN;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,iBAAiB,GAAG,SAAS,EACzC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAUN"}

package/dist/types/managers/UserManager/utils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 工具函数导出
+ */
+export * from './DataManagerUtils';
+export * from './LoggingUtils';
+export * from './MonitoringUtils';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/managers/UserManager/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/managers/UserManager/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@vlian/infrastructure",
+  "version": "0.9.10",
+  "description": "通用业务基础设施包，提供业务无关的通用能力",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "pnpm run clean && pnpm run build:esm && pnpm run build:cjs && pnpm run build:types",
+    "build:esm": "swc src -d dist/esm --config-file .swcrc.esm.json",
+    "build:cjs": "swc src -d dist/cjs --config-file .swcrc.cjs.json",
+    "build:types": "tsc --emitDeclarationOnly --outDir dist/types",
+    "build:esm:watch": "swc src -d dist/esm --config-file .swcrc.esm.json --watch",
+    "build:cjs:watch": "swc src -d dist/cjs --config-file .swcrc.cjs.json --watch",
+    "build:types:watch": "tsc --emitDeclarationOnly --outDir dist/types --watch",
+    "clean": "rm -rf dist",
+    "dev": "pnpm run clean && pnpm run build:esm && pnpm run build:cjs && pnpm run build:types && pnpm run dev:watch",
+    "dev:watch": "pnpm run build:esm:watch & pnpm run build:cjs:watch & pnpm run build:types:watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "pnpm run build",
+    "prepack": "pnpm run build",
+    "publish": "npm publish --access public"
+  },
+  "keywords": [
+    "infrastructure",
+    "manager",
+    "auth",
+    "permission",
+    "theme",
+    "notification",
+    "dictionary",
+    "user",
+    "system-config",
+    "typescript",
+    "framework"
+  ],
+  "author": {
+    "name": "vlian",
+    "email": "support@vlian.com"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@swc/cli": "^0.1.62",
+    "@swc/core": "^1.3.92",
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.3",
+    "@vlian/framework": "^1.1.0",
+    "chokidar": "^3.6.0",
+    "vitest": "^2.1.8",
+    "@vitest/coverage-v8": "^2.1.8"
+  },
+  "peerDependencies": {
+    "@vlian/framework": "^1.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@vlian/framework": {
+      "optional": false
+    }
+  },
+  "packageManager": "pnpm@10.27.0+sha512.72d699da16b1179c14ba9e64dc71c9a40988cbdc65c264cb0e489db7de917f20dcf4d64d8723625f2969ba52d4b7e2a1170682d9ac2a5dcaeaab732b7e16f04a"
+}