sa2kit 1.6.52 → 1.6.58

package/dist/utils/index.js

@@ -1,46 +1,46 @@
 'use strict';
 
-var chunkDVENFCQY_js = require('../chunk-DVENFCQY.js');
-require('../chunk-ACLOJXXE.js');
+var chunkZWQJSZEY_js = require('../chunk-ZWQJSZEY.js');
+require('../chunk-25OFOKNF.js');
 require('../chunk-Z6ZWNWWR.js');
 
 
 
 Object.defineProperty(exports, "arrayUtils", {
   enumerable: true,
-  get: function () { return chunkDVENFCQY_js.arrayUtils; }
+  get: function () { return chunkZWQJSZEY_js.arrayUtils; }
 });
 Object.defineProperty(exports, "cn", {
   enumerable: true,
-  get: function () { return chunkDVENFCQY_js.cn; }
+  get: function () { return chunkZWQJSZEY_js.cn; }
 });
 Object.defineProperty(exports, "debugUtils", {
   enumerable: true,
-  get: function () { return chunkDVENFCQY_js.debugUtils; }
+  get: function () { return chunkZWQJSZEY_js.debugUtils; }
 });
 Object.defineProperty(exports, "errorUtils", {
   enumerable: true,
-  get: function () { return chunkDVENFCQY_js.errorUtils; }
+  get: function () { return chunkZWQJSZEY_js.errorUtils; }
 });
 Object.defineProperty(exports, "fileUtils", {
   enumerable: true,
-  get: function () { return chunkDVENFCQY_js.fileUtils; }
+  get: function () { return chunkZWQJSZEY_js.fileUtils; }
 });
 Object.defineProperty(exports, "formatTime", {
   enumerable: true,
-  get: function () { return chunkDVENFCQY_js.formatTime; }
+  get: function () { return chunkZWQJSZEY_js.formatTime; }
 });
 Object.defineProperty(exports, "japaneseUtils", {
   enumerable: true,
-  get: function () { return chunkDVENFCQY_js.japaneseUtils; }
+  get: function () { return chunkZWQJSZEY_js.japaneseUtils; }
 });
 Object.defineProperty(exports, "stringUtils", {
   enumerable: true,
-  get: function () { return chunkDVENFCQY_js.stringUtils; }
+  get: function () { return chunkZWQJSZEY_js.stringUtils; }
 });
 Object.defineProperty(exports, "validators", {
   enumerable: true,
-  get: function () { return chunkDVENFCQY_js.validators; }
+  get: function () { return chunkZWQJSZEY_js.validators; }
 });
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/utils/index.mjs

@@ -1,5 +1,5 @@
-export { arrayUtils, cn, debugUtils, errorUtils, fileUtils, formatTime, japaneseUtils, stringUtils, validators } from '../chunk-4VJQZSPU.mjs';
-import '../chunk-PXWDQFWV.mjs';
+export { arrayUtils, cn, debugUtils, errorUtils, fileUtils, formatTime, japaneseUtils, stringUtils, validators } from '../chunk-3NHAT7D4.mjs';
+import '../chunk-3DXPQ4YV.mjs';
 import '../chunk-WMJKH4XE.mjs';
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sa2kit",
-  "version": "1.6.52",
+  "version": "1.6.58",
   "description": "A modern, type-safe React utility library with cross-platform support and platform adapters",
   "keywords": [
     "react",
@@ -283,6 +283,26 @@
       "import": "./dist/showmasterpiece/index.mjs",
       "require": "./dist/showmasterpiece/index.js"
     },
+    "./showmasterpiece/ui/web": {
+      "types": "./dist/showmasterpiece/ui/web/index.d.ts",
+      "import": "./dist/showmasterpiece/ui/web/index.mjs",
+      "require": "./dist/showmasterpiece/ui/web/index.js"
+    },
+    "./showmasterpiece/ui/miniapp": {
+      "types": "./dist/showmasterpiece/ui/miniapp/index.d.ts",
+      "import": "./dist/showmasterpiece/ui/miniapp/index.mjs",
+      "require": "./dist/showmasterpiece/ui/miniapp/index.js"
+    },
+    "./showmasterpiece/logic": {
+      "types": "./dist/showmasterpiece/logic/index.d.ts",
+      "import": "./dist/showmasterpiece/logic/index.mjs",
+      "require": "./dist/showmasterpiece/logic/index.js"
+    },
+    "./showmasterpiece/db": {
+      "types": "./dist/showmasterpiece/db/index.d.ts",
+      "import": "./dist/showmasterpiece/db/index.mjs",
+      "require": "./dist/showmasterpiece/db/index.js"
+    },
     "./showmasterpiece/server": {
       "types": "./dist/showmasterpiece/server/index.d.ts",
       "import": "./dist/showmasterpiece/server/index.mjs",
@@ -335,6 +355,7 @@
   "peerDependencies": {
     "@imgly/background-removal": "^1.7.0",
     "@xenova/transformers": "^2.17.2",
+    "@tarojs/components": "^4.1.1",
     "lucide-react": "^0.263.0 || ^0.300.0 || ^0.400.0 || ^0.500.0",
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0",
@@ -355,6 +376,9 @@
     "lucide-react": {
       "optional": true
     },
+    "@tarojs/components": {
+      "optional": true
+    },
     "@xenova/transformers": {
       "optional": true
     },
@@ -381,6 +405,7 @@
     "@types/three": "^0.181.0",
     "@types/uuid": "^11.0.0",
     "@types/ws": "^8.18.1",
+    "@tarojs/components": "^4.1.1",
     "@typescript-eslint/eslint-plugin": "^6.19.0",
     "@typescript-eslint/parser": "^6.19.0",
     "@vitest/ui": "^1.2.0",

package/dist/AliyunOSSProvider-2FARPAQD.js

@@ -1,15 +0,0 @@
-'use strict';
-
-var chunkCFGX3EKK_js = require('./chunk-CFGX3EKK.js');
-require('./chunk-4NFOSCM6.js');
-require('./chunk-ACLOJXXE.js');
-require('./chunk-Z6ZWNWWR.js');
-
-chunkCFGX3EKK_js.init_AliyunOSSProvider();
-
-Object.defineProperty(exports, "AliyunOSSProvider", {
-  enumerable: true,
-  get: function () { return chunkCFGX3EKK_js.AliyunOSSProvider; }
-});
-//# sourceMappingURL=AliyunOSSProvider-2FARPAQD.js.map
-//# sourceMappingURL=AliyunOSSProvider-2FARPAQD.js.map

package/dist/AliyunOSSProvider-UMVGVBDJ.mjs

@@ -1,9 +0,0 @@
-import { init_AliyunOSSProvider } from './chunk-K7WNCB4V.mjs';
-export { AliyunOSSProvider } from './chunk-K7WNCB4V.mjs';
-import './chunk-AEXPAH7Z.mjs';
-import './chunk-PXWDQFWV.mjs';
-import './chunk-WMJKH4XE.mjs';
-
-init_AliyunOSSProvider();
-//# sourceMappingURL=AliyunOSSProvider-UMVGVBDJ.mjs.map
-//# sourceMappingURL=AliyunOSSProvider-UMVGVBDJ.mjs.map

package/dist/LocalStorageProvider-JQF5WK5H.js

@@ -1,15 +0,0 @@
-'use strict';
-
-var chunk6AHYPPUP_js = require('./chunk-6AHYPPUP.js');
-require('./chunk-4NFOSCM6.js');
-require('./chunk-ACLOJXXE.js');
-require('./chunk-Z6ZWNWWR.js');
-
-chunk6AHYPPUP_js.init_LocalStorageProvider();
-
-Object.defineProperty(exports, "LocalStorageProvider", {
-  enumerable: true,
-  get: function () { return chunk6AHYPPUP_js.LocalStorageProvider; }
-});
-//# sourceMappingURL=LocalStorageProvider-JQF5WK5H.js.map
-//# sourceMappingURL=LocalStorageProvider-JQF5WK5H.js.map

package/dist/LocalStorageProvider-PYOHETJV.mjs

@@ -1,9 +0,0 @@
-import { init_LocalStorageProvider } from './chunk-VTGPHE4Z.mjs';
-export { LocalStorageProvider } from './chunk-VTGPHE4Z.mjs';
-import './chunk-AEXPAH7Z.mjs';
-import './chunk-PXWDQFWV.mjs';
-import './chunk-WMJKH4XE.mjs';
-
-init_LocalStorageProvider();
-//# sourceMappingURL=LocalStorageProvider-PYOHETJV.mjs.map
-//# sourceMappingURL=LocalStorageProvider-PYOHETJV.mjs.map

package/dist/UniversalFileService-RBV6EN5J.js

@@ -1,15 +0,0 @@
-'use strict';
-
-var chunkM4HGHTIC_js = require('./chunk-M4HGHTIC.js');
-require('./chunk-ACLOJXXE.js');
-require('./chunk-D2HXMGXS.js');
-require('./chunk-Z6ZWNWWR.js');
-
-chunkM4HGHTIC_js.init_UniversalFileService();
-
-Object.defineProperty(exports, "UniversalFileService", {
-  enumerable: true,
-  get: function () { return chunkM4HGHTIC_js.UniversalFileService; }
-});
-//# sourceMappingURL=UniversalFileService-RBV6EN5J.js.map
-//# sourceMappingURL=UniversalFileService-RBV6EN5J.js.map

package/dist/UniversalFileService-TNYKO6JN.mjs

@@ -1,9 +0,0 @@
-import { init_UniversalFileService } from './chunk-76V7EKBX.mjs';
-export { UniversalFileService } from './chunk-76V7EKBX.mjs';
-import './chunk-PXWDQFWV.mjs';
-import './chunk-L4ZYBFB2.mjs';
-import './chunk-WMJKH4XE.mjs';
-
-init_UniversalFileService();
-//# sourceMappingURL=UniversalFileService-TNYKO6JN.mjs.map
-//# sourceMappingURL=UniversalFileService-TNYKO6JN.mjs.map

package/dist/chunk-4NFOSCM6.js

@@ -1,34 +0,0 @@
-'use strict';
-
-var chunkZ6ZWNWWR_js = require('./chunk-Z6ZWNWWR.js');
-
-// src/universalFile/server/types.ts
-var FileServiceError; exports.StorageProviderError = void 0; exports.CDNProviderError = void 0;
-var init_types = chunkZ6ZWNWWR_js.__esm({
-  "src/universalFile/server/types.ts"() {
-    FileServiceError = class extends Error {
-      constructor(message, code, details) {
-        super(message);
-        this.code = code;
-        this.details = details;
-        this.name = "FileServiceError";
-      }
-    };
-    exports.StorageProviderError = class extends FileServiceError {
-      constructor(message, details) {
-        super(message, "STORAGE_PROVIDER_ERROR", details);
-        this.name = "StorageProviderError";
-      }
-    };
-    exports.CDNProviderError = class extends FileServiceError {
-      constructor(message, details) {
-        super(message, "CDN_PROVIDER_ERROR", details);
-        this.name = "CDNProviderError";
-      }
-    };
-  }
-});
-
-exports.init_types = init_types;
-//# sourceMappingURL=chunk-4NFOSCM6.js.map
-//# sourceMappingURL=chunk-4NFOSCM6.js.map

package/dist/chunk-4NFOSCM6.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/universalFile/server/types.ts"],"names":["StorageProviderError","CDNProviderError","__esm"],"mappings":";;;;;AAAA,IA8ca,kBA4BAA,qCAAA,CAAA,CAQAC;AAlfb,IAAA,UAAA,GAAAC,sBAAA,CAAA;AAAA,EAAA,mCAAA,GAAA;AA8cO,IAAM,gBAAA,GAAN,cAA+B,KAAA,CAAM;AAAA,MAC1C,WAAA,CACE,OAAA,EACgB,IAAA,EACA,OAAA,EAChB;AACA,QAAA,KAAA,CAAM,OAAO,CAAA;AAHG,QAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AACA,QAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AAGhB,QAAA,IAAA,CAAK,IAAA,GAAO,kBAAA;AAAA,MACd;AAAA,KACF;AAmBO,IAAMF,4BAAA,GAAN,cAAmC,gBAAA,CAAiB;AAAA,MACzD,WAAA,CAAY,SAAiB,OAAA,EAA+B;AAC1D,QAAA,KAAA,CAAM,OAAA,EAAS,0BAA0B,OAAO,CAAA;AAChD,QAAA,IAAA,CAAK,IAAA,GAAO,sBAAA;AAAA,MACd;AAAA,KACF;AAGO,IAAMC,wBAAA,GAAN,cAA+B,gBAAA,CAAiB;AAAA,MACrD,WAAA,CAAY,SAAiB,OAAA,EAA+B;AAC1D,QAAA,KAAA,CAAM,OAAA,EAAS,sBAAsB,OAAO,CAAA;AAC5C,QAAA,IAAA,CAAK,IAAA,GAAO,kBAAA;AAAA,MACd;AAAA,KACF;AAAA,EAAA;AAAA,CAAA","file":"chunk-4NFOSCM6.js","sourcesContent":["/**\n * UniversalFile Server 端类型定义\n */\n\nimport type {\n  StorageType as _StorageType,\n  CDNType as _CDNType,\n  ProcessorType as _ProcessorType,\n  FileMetadata,\n  UploadStatus,\n  AccessPermission,\n  UploadFileInfo as _UploadFileInfo,\n  ProcessingOptions as _ProcessingOptions,\n} from '../types';\n\n// Re-export client types for server use\nexport type StorageType = _StorageType;\nexport type CDNType = _CDNType;\nexport type ProcessorType = _ProcessorType;\nexport type UploadFileInfo = _UploadFileInfo;\nexport type ProcessingOptions = _ProcessingOptions;\n\n// ============= Provider 接口 =============\n\n/** 存储提供者接口 */\nexport interface IStorageProvider {\n  /** 提供者类型 */\n  readonly type: StorageType;\n\n  /** 初始化 */\n  initialize(config: StorageConfig): Promise<void>;\n\n  /** 上传文件 */\n  upload(fileInfo: UploadFileInfo, path: string): Promise<StorageResult>;\n\n  /** 下载文件 */\n  download(path: string): Promise<Buffer>;\n\n  /** 删除文件 */\n  delete(path: string): Promise<StorageResult>;\n\n  /** 获取文件信息 */\n  getFileInfo(path: string): Promise<StorageResult>;\n\n  /** 生成访问URL */\n  getAccessUrl(path: string, expiresIn?: number): Promise<string>;\n\n  /** 生成预签名上传URL */\n  getUploadUrl(path: string, expiresIn?: number): Promise<string>;\n\n  /** 检查文件是否存在 */\n  exists(path: string): Promise<boolean>;\n\n  /** 列出文件 */\n  list(prefix: string, maxKeys?: number): Promise<string[]>;\n}\n\n/** CDN 提供者接口 */\nexport interface ICDNProvider {\n  /** 提供者类型 */\n  readonly type: CDNType;\n\n  /** 初始化 */\n  initialize(config: CDNConfig): Promise<void>;\n\n  /** 生成CDN URL */\n  generateUrl(originalUrl: string): Promise<string>;\n\n  /** 刷新缓存 */\n  refreshCache(urls: string[]): Promise<CDNResult>;\n\n  /** 预热缓存 */\n  preheatCache(urls: string[]): Promise<CDNResult>;\n\n  /** 获取访问统计 */\n  getAccessStats(startTime: Date, endTime: Date): Promise<CDNResult>;\n}\n\n/** 文件处理器接口 */\nexport interface IFileProcessor {\n  /** 处理器类型 */\n  readonly type: ProcessorType;\n\n  /** 初始化 */\n  initialize(): Promise<void>;\n\n  /** 处理文件 */\n  process(\n    inputPath: string,\n    outputPath: string,\n    options: ProcessingOptions\n  ): Promise<ProcessingResult>;\n\n  /** 检查文件是否支持处理 */\n  supports(mimeType: string): boolean;\n\n  /** 获取文件信息 */\n  getFileInfo(filePath: string): Promise<Record<string, any>>;\n}\n\n// ============= 配置接口 =============\n\n/** 存储配置基础接口 */\nexport interface StorageConfig {\n  /** 存储类型 */\n  type: StorageType;\n  /** 是否启用 */\n  enabled: boolean;\n}\n\n/** 本地存储配置 */\nexport interface LocalStorageConfig extends StorageConfig {\n  type: 'local';\n  /** 存储根目录 */\n  rootPath: string;\n  /** 基础URL */\n  baseUrl: string;\n}\n\n/** 阿里云 OSS 配置 */\nexport interface AliyunOSSConfig extends StorageConfig {\n  type: 'aliyun-oss';\n  /** 地域 */\n  region: string;\n  /** 存储桶名称 */\n  bucket: string;\n  /** 访问密钥ID */\n  accessKeyId: string;\n  /** 访问密钥密码 */\n  accessKeySecret: string;\n  /** 自定义域名 */\n  customDomain?: string;\n  /** 是否使用HTTPS */\n  secure?: boolean;\n  /** 是否使用内网访问 */\n  internal?: boolean;\n}\n\n/** CDN配置基础接口 */\nexport interface CDNConfig {\n  /** CDN类型 */\n  type: CDNType;\n  /** 是否启用 */\n  enabled: boolean;\n}\n\n/** 阿里云 CDN 配置 */\nexport interface AliyunCDNConfig extends CDNConfig {\n  type: 'aliyun-cdn';\n  /** CDN域名 */\n  domain: string;\n  /** 访问密钥ID */\n  accessKeyId: string;\n  /** 访问密钥密码 */\n  accessKeySecret: string;\n  /** 地域 */\n  region?: string;\n}\n\n/** 缓存配置 */\nexport interface CacheConfig {\n  /** 是否启用缓存 */\n  enabled: boolean;\n  /** 最大缓存大小 */\n  maxSize?: number;\n  /** 缓存 TTL（秒） */\n  ttl?: number;\n  /** 是否使用 Redis */\n  useRedis?: boolean;\n  /** Redis 配置 */\n  redisConfig?: {\n    host: string;\n    port: number;\n    password?: string;\n    db?: number;\n  };\n}\n\n/** 文件服务配置 */\n/** 缓存配置扩展 */\nexport interface CacheConfig {\n  /** 是否启用缓存 */\n  enabled: boolean;\n  /** 元数据缓存TTL（秒） */\n  metadataTTL?: number;\n  /** URL缓存TTL（秒） */\n  urlTTL?: number;\n  /** 最大缓存条目数 */\n  maxSize?: number;\n}\n\nexport interface UniversalFileServiceConfig {\n  /** 存储配置 */\n  storage: StorageConfig;\n  /** CDN 配置（可选） */\n  cdn?: CDNConfig;\n  /** 缓存配置（可选） */\n  cache?: CacheConfig;\n  /** 数据库持久化配置（可选） */\n  persistence?: FileServicePersistenceConfig;\n  /** 启用的处理器 */\n  processors?: ProcessorType[];\n  /** 数据库连接（可选） @deprecated 使用 persistence.repository 代替 */\n  db?: any;\n  /** 最大文件大小（字节） */\n  maxFileSize?: number;\n  /** 允许的文件类型 */\n  allowedMimeTypes?: string[];\n  /** 是否启用监控 */\n  enableMonitoring?: boolean;\n\n  // 运行时字段（由服务类内部管理）\n  /** 存储提供者映射（内部使用） */\n  storageProviders?: Map<StorageType, IStorageProvider>;\n  /** 默认存储类型 */\n  defaultStorage?: StorageType;\n  /** 默认CDN类型 */\n  defaultCDN?: CDNType;\n}\n\n// ============= 结果类型 =============\n\n/** 存储结果 */\n/** 存储操作结果 */\nexport interface StorageResult {\n  /** 是否成功 */\n  success: boolean;\n  /** 存储路径 */\n  path?: string;\n  /** 访问URL */\n  url?: string;\n  /** 文件大小 */\n  size?: number;\n  /** 错误信息 */\n  error?: string;\n  /** 额外数据 */\n  data?: Record<string, any>;\n}\n\n/** 存储元数据 */\nexport interface StorageMetadata {\n  /** 文件大小 */\n  size: number;\n  /** MIME 类型 */\n  mimeType: string;\n  /** 最后修改时间 */\n  lastModified: Date;\n  /** 自定义元数据 */\n  metadata?: Record<string, any>;\n}\n\n/** CDN 结果 */\n/** CDN操作结果 */\nexport interface CDNResult {\n  /** 是否成功 */\n  success: boolean;\n  /** CDN URL */\n  url?: string;\n  /** 错误信息 */\n  error?: string;\n  /** 额外数据 */\n  data?: Record<string, any>;\n}\n\n/** CDN 统计信息 */\nexport interface CDNStats {\n  /** 带宽（字节/秒） */\n  bandwidth: number;\n  /** 请求数 */\n  requests: number;\n  /** 流量（字节） */\n  traffic: number;\n  /** 统计时间范围 */\n  timeRange: {\n    start: Date;\n    end: Date;\n  };\n}\n\n/** 处理结果 */\nexport interface ProcessingResult {\n  /** 是否成功 */\n  success: boolean;\n  /** 处理后的文件路径 */\n  processedPath?: string;\n  /** 处理后的文件大小 */\n  processedSize?: number;\n  /** 缩略图路径 */\n  thumbnailPath?: string;\n  /** 错误信息 */\n  error?: string;\n  /** 处理耗时(毫秒) */\n  processingTime?: number;\n  /** 额外数据 */\n  data?: Record<string, any>;\n}\n\n/** 处理器信息 */\nexport interface ProcessorInfo {\n  /** 处理器名称 */\n  name: string;\n  /** 处理器版本 */\n  version: string;\n  /** 支持的格式 */\n  supportedFormats: string[];\n  /** 支持的操作 */\n  supportedOperations: string[];\n}\n\n// ============= 数据库相关类型 =============\n\n/** 文件数据库记录 */\nexport interface FileRecord extends FileMetadata {\n  /** 创建时间 */\n  createdAt: Date | string;\n  /** 更新时间 */\n  updatedAt: Date | string;\n}\n\n/** 文件查询选项 */\nexport interface FileQueryOptions {\n  /** 模块 ID */\n  moduleId?: string;\n  /** 业务 ID */\n  businessId?: string;\n  /** 上传者 ID */\n  uploaderId?: string;\n  /** 文件类型 */\n  mimeType?: string;\n  /** 访问权限 */\n  permission?: AccessPermission;\n  /** 状态 */\n  status?: UploadStatus;\n  /** 分页 */\n  page?: number;\n  pageSize?: number;\n  /** 排序 */\n  orderBy?: string;\n  orderDirection?: 'asc' | 'desc';\n}\n\n/** 分页结果 */\nexport interface PaginatedResult<T> {\n  /** 数据列表 */\n  items: T[];\n  /** 总数 */\n  total: number;\n  /** 当前页 */\n  page: number;\n  /** 每页大小 */\n  pageSize: number;\n  /** 总页数 */\n  totalPages: number;\n}\n\n// ============= 事件类型 =============\n\n/** 文件事件类型 */\nexport type FileEventType =\n  | 'upload:start'\n  | 'upload:progress'\n  | 'upload:complete'\n  | 'upload:error'\n  | 'download:start'\n  | 'download:complete'\n  | 'download:error'\n  | 'delete:complete'\n  | 'delete:error'\n  | 'process:start'\n  | 'process:complete'\n  | 'process:error';\n\n/** 文件事件 */\nexport interface FileEvent {\n  /** 事件类型 */\n  type: FileEventType;\n  /** 文件 ID */\n  fileId: string;\n  /** 事件数据 */\n  data?: any;\n  /** 时间戳 */\n  timestamp: Date;\n}\n\n/** 事件监听器 */\nexport type FileEventListener = (event: FileEvent) => void | Promise<void>;\n\n// ============= 数据库持久化接口 =============\n\n/**\n * 文件元数据数据库持久化接口\n *\n * 实现此接口以提供自定义的数据库持久化支持\n *\n * @example\n * ```typescript\n * // Drizzle ORM 实现\n * class DrizzleFileRepository implements IFileMetadataRepository {\n *   async save(metadata: FileMetadata): Promise<void> {\n *     await db.insert(fileMetadata).values(metadata);\n *   }\n *   // ... 其他方法\n * }\n * ```\n */\nexport interface IFileMetadataRepository {\n  /**\n   * 保存文件元数据到数据库\n   */\n  save(metadata: FileMetadata): Promise<void>;\n\n  /**\n   * 从数据库获取文件元数据\n   */\n  get(fileId: string): Promise<FileMetadata | null>;\n\n  /**\n   * 查询文件列表\n   */\n  query(options: FileQueryOptions): Promise<PaginatedResult<FileMetadata>>;\n\n  /**\n   * 从数据库删除文件元数据\n   */\n  delete(fileId: string): Promise<void>;\n\n  /**\n   * 批量删除文件元数据\n   */\n  batchDelete(fileIds: string[]): Promise<void>;\n}\n\n/**\n * 数据库持久化配置\n */\nexport interface FileServicePersistenceConfig {\n  /**\n   * 是否启用持久化\n   */\n  enabled: boolean;\n\n  /**\n   * 持久化仓储实现\n   */\n  repository: IFileMetadataRepository;\n\n  /**\n   * 是否自动持久化（默认 true）\n   * 如果为 true，文件上传完成后自动保存到数据库\n   */\n  autoPersist?: boolean;\n\n  /**\n   * 是否优先使用缓存（默认 false）\n   * 如果为 true，查询时优先从缓存获取\n   */\n  cacheFirst?: boolean;\n}\n\n// ============= 异常类型定义 =============\n\n/** 文件服务异常基类 */\nexport class FileServiceError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly details?: Record<string, any>\n  ) {\n    super(message);\n    this.name = 'FileServiceError';\n  }\n}\n\n/** 文件上传异常 */\nexport class FileUploadError extends FileServiceError {\n  constructor(message: string, details?: Record<string, any>) {\n    super(message, 'FILE_UPLOAD_ERROR', details);\n    this.name = 'FileUploadError';\n  }\n}\n\n/** 文件处理异常 */\nexport class FileProcessingError extends FileServiceError {\n  constructor(message: string, details?: Record<string, any>) {\n    super(message, 'FILE_PROCESSING_ERROR', details);\n    this.name = 'FileProcessingError';\n  }\n}\n\n/** 存储提供者异常 */\nexport class StorageProviderError extends FileServiceError {\n  constructor(message: string, details?: Record<string, any>) {\n    super(message, 'STORAGE_PROVIDER_ERROR', details);\n    this.name = 'StorageProviderError';\n  }\n}\n\n/** CDN提供者异常 */\nexport class CDNProviderError extends FileServiceError {\n  constructor(message: string, details?: Record<string, any>) {\n    super(message, 'CDN_PROVIDER_ERROR', details);\n    this.name = 'CDNProviderError';\n  }\n}\n"]}

package/dist/chunk-4VJQZSPU.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/utils/time.ts","../src/utils/japanese.ts","../src/utils/validators.ts","../src/utils/file.ts","../src/utils/array.ts","../src/utils/string.ts","../src/utils/debug.ts","../src/utils/error.ts","../src/utils/cn.ts"],"names":[],"mappings":"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","file":"chunk-4VJQZSPU.mjs","sourcesContent":["/**\n * 时间格式化工具\n */\n\nexport const formatTime = {\n  /**\n   * 将秒数转换为 MM:SS 格式\n   */\n  toMinutesSeconds(seconds: number): string {\n    const minutes = Math.floor(seconds / 60);\n    const remainingSeconds = Math.floor(seconds % 60);\n    return minutes + ':' + remainingSeconds.toString().padStart(2, '0');\n  },\n\n  /**\n   * 将秒数转换为 HH:MM:SS 格式\n   */\n  toHoursMinutesSeconds(seconds: number): string {\n    const hours = Math.floor(seconds / 3600);\n    const minutes = Math.floor((seconds % 3600) / 60);\n    const remainingSeconds = Math.floor(seconds % 60);\n\n    if (hours > 0) {\n      return hours + ':' + minutes.toString().padStart(2, '0') + ':' + remainingSeconds.toString().padStart(2, '0');\n    }\n    return minutes + ':' + remainingSeconds.toString().padStart(2, '0');\n  },\n\n  /**\n   * 格式化日期为用户友好的格式\n   */\n  formatDate(date: string | Date, locale = 'zh-CN'): string {\n    const d = new Date(date);\n    const now = new Date();\n    const diffMs = now.getTime() - d.getTime();\n    const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));\n\n    if (diffDays === 0) {\n      return locale === 'zh-CN' ? '今天' : 'Today';\n    } else if (diffDays === 1) {\n      return locale === 'zh-CN' ? '昨天' : 'Yesterday';\n    } else if (diffDays < 7) {\n      return locale === 'zh-CN' ? diffDays + '天前' : diffDays + ' days ago';\n    } else {\n      return d.toLocaleDateString(locale);\n    }\n  },\n};\n\n","/**\n * 日语文本处理工具\n */\n\nexport const japaneseUtils = {\n  /**\n   * 提取文本中的汉字\n   */\n  extractKanji(text: string): string[] {\n    return text.match(/[\\u4E00-\\u9FAF]/g) || [];\n  },\n\n  /**\n   * 提取文本中的假名\n   */\n  extractKana(text: string): string[] {\n    return text.match(/[\\u3040-\\u309F\\u30A0-\\u30FF]/g) || [];\n  },\n\n  /**\n   * 清理文本，移除特殊字符但保留日语字符\n   */\n  cleanText(text: string): string {\n    return text.replace(/[^\\u3040-\\u309F\\u30A0-\\u30FF\\u4E00-\\u9FAF\\w\\s]/g, '');\n  },\n};\n","/**\n * 验证工具\n */\n\nexport const validators = {\n  /**\n   * 验证邮箱格式\n   */\n  isValidEmail(email: string): boolean {\n    const emailRegex = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/;\n    return emailRegex.test(email);\n  },\n\n  /**\n   * 验证密码强度\n   */\n  isValidPassword(password: string): {\n    isValid: boolean;\n    errors: string[];\n  } {\n    const errors: string[] = [];\n\n    if (password.length < 6) {\n      errors.push('Password must be at least 6 characters');\n    }\n\n    if (password.length > 50) {\n      errors.push('Password must not exceed 50 characters');\n    }\n\n    if (!/[a-zA-Z]/.test(password)) {\n      errors.push('Password must contain at least one letter');\n    }\n\n    if (!/[0-9]/.test(password)) {\n      errors.push('Password must contain at least one number');\n    }\n\n    return {\n      isValid: errors.length === 0,\n      errors,\n    };\n  },\n\n  /**\n   * 验证用户名格式\n   */\n  isValidUsername(username: string): boolean {\n    const usernameRegex = /^[a-zA-Z0-9_]{3,20}$/;\n    return usernameRegex.test(username);\n  },\n\n  /**\n   * 验证文件大小\n   */\n  isValidFileSize(size: number, maxSize: number): boolean {\n    return size > 0 && size <= maxSize;\n  },\n\n  /**\n   * 验证文件类型\n   */\n  isValidFileType(type: string, supportedTypes: string[]): boolean {\n    return supportedTypes.includes(type);\n  },\n\n  /**\n   * 验证 URL 格式\n   */\n  isValidUrl(url: string): boolean {\n    try {\n      new URL(url);\n      return true;\n    } catch {\n      return false;\n    }\n  },\n};\n\n","/**\n * 文件处理工具\n */\n\nexport const fileUtils = {\n  /**\n   * 格式化文件大小\n   */\n  formatFileSize(bytes: number): string {\n    if (bytes === 0) return '0 Bytes';\n\n    const k = 1024;\n    const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];\n    const i = Math.floor(Math.log(bytes) / Math.log(k));\n\n    return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];\n  },\n\n  /**\n   * 获取文件扩展名\n   */\n  getFileExtension(filename: string): string {\n    return filename.slice(((filename.lastIndexOf('.') - 1) >>> 0) + 2);\n  },\n\n  /**\n   * 生成唯一文件名\n   */\n  generateUniqueFileName(originalName: string): string {\n    const timestamp = Date.now();\n    const random = Math.random().toString(36).substring(2, 15);\n    const extension = this.getFileExtension(originalName);\n    const baseName = originalName.replace('.' + (extension), '');\n    return extension ? (baseName) + '_' + (timestamp) + '_' + (random) + '.' + (extension) : (baseName) + '_' + (timestamp) + '_' + (random);\n  },\n\n  /**\n   * 验证文件名是否有效\n   */\n  isValidFilename(filename: string): boolean {\n    // 不允许包含特殊字符\n    const invalidChars = /[<>:\"/\\\\|?*\\x00-\\x1F]/g;\n    return !invalidChars.test(filename) && filename.length > 0 && filename.length <= 255;\n  },\n};\n\n","/**\n * 数组和对象工具\n */\n\nexport const arrayUtils = {\n  /**\n   * 数组去重\n   */\n  unique<T>(array: T[]): T[] {\n    return [...new Set(array)];\n  },\n\n  /**\n   * 数组分组\n   */\n  groupBy<T>(array: T[], key: keyof T): Record<string, T[]> {\n    return array.reduce(\n      (groups, item) => {\n        const groupKey = String(item[key]);\n        const group = groups[groupKey] || [];\n        group.push(item);\n        groups[groupKey] = group;\n        return groups;\n      },\n      {} as Record<string, T[]>\n    );\n  },\n\n  /**\n   * 数组分页\n   */\n  paginate<T>(\n    array: T[],\n    page: number,\n    limit: number\n  ): {\n    data: T[];\n    total: number;\n    page: number;\n    pages: number;\n    hasNext: boolean;\n    hasPrev: boolean;\n  } {\n    const total = array.length;\n    const pages = Math.ceil(total / limit);\n    const start = (page - 1) * limit;\n    const end = start + limit;\n    const data = array.slice(start, end);\n\n    return {\n      data,\n      total,\n      page,\n      pages,\n      hasNext: page < pages,\n      hasPrev: page > 1,\n    };\n  },\n\n  /**\n   * 数组随机排序\n   */\n  shuffle<T>(array: T[]): T[] {\n    const shuffled = [...array];\n    for (let i = shuffled.length - 1; i > 0; i--) {\n      const j = Math.floor(Math.random() * (i + 1));\n      [shuffled[i], shuffled[j]] = [shuffled[j]!, shuffled[i]!];\n    }\n    return shuffled;\n  },\n};\n\n","/**\n * 字符串工具\n */\n\nexport const stringUtils = {\n  /**\n   * 截断文本\n   */\n  truncate(text: string, length: number, suffix = '...'): string {\n    if (text.length <= length) return text;\n    return text.substring(0, length - suffix.length) + suffix;\n  },\n\n  /**\n   * 首字母大写\n   */\n  capitalize(text: string): string {\n    if (!text) return '';\n    return text.charAt(0).toUpperCase() + text.slice(1).toLowerCase();\n  },\n\n  /**\n   * 驼峰转下划线\n   */\n  camelToSnake(text: string): string {\n    return text.replace(/[A-Z]/g, (letter) => '_' + (letter.toLowerCase()));\n  },\n\n  /**\n   * 下划线转驼峰\n   */\n  snakeToCamel(text: string): string {\n    return text.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());\n  },\n\n  /**\n   * 生成随机字符串\n   */\n  generateRandom(length: number): string {\n    const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';\n    let result = '';\n    for (let i = 0; i < length; i++) {\n      result += chars.charAt(Math.floor(Math.random() * chars.length));\n    }\n    return result;\n  },\n};\n\n","/**\n * 调试工具\n */\n\nimport { logger } from '../logger';\nimport { fileUtils } from './file';\n\nexport const debugUtils = {\n  /**\n   * 安全的 JSON 序列化\n   */\n  safeStringify(obj: any): string {\n    try {\n      return JSON.stringify(obj, null, 2);\n    } catch (error) {\n      return '[Circular Reference or Invalid JSON: ' + (error) + ']';\n    }\n  },\n\n  /**\n   * 性能计时器\n   */\n  createTimer(label?: string) {\n    const start = typeof performance !== 'undefined' ? performance.now() : Date.now();\n    return {\n      end: () => {\n        const end = typeof performance !== 'undefined' ? performance.now() : Date.now();\n        const duration = end - start;\n        const message = (label || 'Timer') + ': ' + (duration.toFixed(2)) + 'ms';\n        logger.info(message);\n        return duration;\n      },\n    };\n  },\n\n  /**\n   * 内存使用情况（仅在 Node.js 环境）\n   */\n  getMemoryUsage(): Record<string, string> | null {\n    if (typeof process !== 'undefined' && process.memoryUsage) {\n      const usage = process.memoryUsage();\n      return {\n        rss: fileUtils.formatFileSize(usage.rss),\n        heapTotal: fileUtils.formatFileSize(usage.heapTotal),\n        heapUsed: fileUtils.formatFileSize(usage.heapUsed),\n        external: fileUtils.formatFileSize(usage.external),\n      };\n    }\n    return null;\n  },\n};\n\n","/**\n * 错误处理工具\n */\n\nexport const errorUtils = {\n  /**\n   * 创建标准化的错误对象\n   */\n  createError(\n    code: string,\n    message: string,\n    details?: any\n  ): Error & { code: string; details?: any } {\n    const error = new Error(message) as Error & { code: string; details?: any };\n    error.code = code;\n    if (details) {\n      error.details = details;\n    }\n    return error;\n  },\n\n  /**\n   * 安全的错误信息提取\n   */\n  extractErrorMessage(error: unknown): string {\n    if (error instanceof Error) {\n      return error.message;\n    }\n    if (typeof error === 'string') {\n      return error;\n    }\n    if (error && typeof error === 'object' && 'message' in error) {\n      return String(error.message);\n    }\n    return 'Unknown error';\n  },\n\n  /**\n   * 错误重试机制\n   */\n  async retry<T>(fn: () => Promise<T>, maxAttempts = 3, delay = 1000): Promise<T> {\n    let lastError: Error;\n\n    for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n      try {\n        return await fn();\n      } catch (error) {\n        lastError = error instanceof Error ? error : new Error(String(error));\n\n        if (attempt === maxAttempts) {\n          throw lastError;\n        }\n\n        // 指数退避延迟\n        await new Promise((resolve) => setTimeout(resolve, delay * Math.pow(2, attempt - 1)));\n      }\n    }\n\n    throw lastError!;\n  },\n};\n\n","import { clsx, type ClassValue } from \"clsx\"\nimport { twMerge } from \"tailwind-merge\"\n\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs))\n}\n\n"]}