sa2kit 1.0.0 → 1.0.2

package/dist/universalFile/server/index.mjs

@@ -11,7 +11,8 @@ import { EventEmitter } from 'events';
 import { v4 } from 'uuid';
 import { LRUCache } from 'lru-cache';
 import { NextResponse } from 'next/server';
-import { sql, eq, and, desc } from 'drizzle-orm';
+import { relations, sql, eq, and, desc } from 'drizzle-orm';
+import { pgTable, timestamp, json, bigint, integer, boolean, varchar, serial, index, text, uuid } from 'drizzle-orm/pg-core';
 
 // src/universalFile/server/factory.ts
 function createFileServiceConfig(options) {
@@ -449,10 +450,10 @@ var AliyunCDNProvider = class {
         return cdnUrl;
       }
       const parsedUrl = new URL(cdnUrl);
-      const timestamp = Math.floor(Date.now() / 1e3) + expiresIn;
-      const signString = `${parsedUrl.pathname}-${timestamp}-0-0-${authKey}`;
+      const timestamp2 = Math.floor(Date.now() / 1e3) + expiresIn;
+      const signString = `${parsedUrl.pathname}-${timestamp2}-0-0-${authKey}`;
       const authValue = createHash("md5").update(signString).digest("hex");
-      const signedUrl = `${cdnUrl}?auth_key=${timestamp}-0-0-${authValue}`;
+      const signedUrl = `${cdnUrl}?auth_key=${timestamp2}-0-0-${authValue}`;
       logger.info(`\u2705 [AliyunCDNProvider] \u9632\u76D7\u94FE\u7B7E\u540DURL\u751F\u6210\u5B8C\u6210`);
       return signedUrl;
     } catch (error) {
@@ -1291,7 +1292,7 @@ var ImageProcessor = class {
   /**
    * 创建文字水印SVG
    */
-  createTextWatermarkSvg(text, opacity) {
+  createTextWatermarkSvg(text2, opacity) {
     const fontSize = 24;
     const padding = 10;
     return `
@@ -1307,7 +1308,7 @@ var ImageProcessor = class {
           stroke-width="1"
           stroke-opacity="${opacity * 0.8}"
         >
-          ${text}
+          ${text2}
         </text>
       </svg>
     `.trim();
@@ -2994,13 +2995,9 @@ var UniversalFileService = class extends EventEmitter {
   async reinitializeStorageProviders() {
     logger6.info("\u{1F504} [UniversalFileService] \u91CD\u65B0\u521D\u59CB\u5316\u5B58\u50A8\u63D0\u4F9B\u8005...");
     try {
-      const ossConfig = this.config.storageProviders["aliyun-oss"];
-      if (ossConfig && ossConfig.enabled) {
-        const ossProvider = this.storageProviders.get("aliyun-oss");
-        if (ossProvider && "reinitialize" in ossProvider) {
-          logger6.info("\u{1F504} [UniversalFileService] \u91CD\u65B0\u521D\u59CB\u5316\u963F\u91CC\u4E91OSS\u63D0\u4F9B\u8005...");
-          await ossProvider.reinitialize(ossConfig);
-        }
+      const ossProvider = this.storageProviders.get("aliyun-oss");
+      if (ossProvider && "reinitialize" in ossProvider) {
+        logger6.info("\u{1F504} [UniversalFileService] \u91CD\u65B0\u521D\u59CB\u5316\u963F\u91CC\u4E91OSS\u63D0\u4F9B\u8005...");
       }
       logger6.info("\u2705 [UniversalFileService] \u5B58\u50A8\u63D0\u4F9B\u8005\u91CD\u65B0\u521D\u59CB\u5316\u5B8C\u6210");
     } catch (error) {
@@ -3154,68 +3151,54 @@ var UniversalFileService = class extends EventEmitter {
     if (this.storageProviders.size === 0) {
       await this.registerDefaultStorageProviders();
     }
-    for (const [type, config] of Object.entries(this.config.storageProviders)) {
-      if (config.enabled) {
-        const provider = this.storageProviders.get(type);
-        if (provider) {
-          try {
-            await provider.initialize(config);
-            logger6.info(`\u2705 [UniversalFileService] \u5B58\u50A8\u63D0\u4F9B\u8005\u521D\u59CB\u5316\u5B8C\u6210: ${type}`);
-          } catch (error) {
-            console.warn(`\u26A0\uFE0F [UniversalFileService] \u5B58\u50A8\u63D0\u4F9B\u8005\u521D\u59CB\u5316\u5931\u8D25: ${type}:`, error);
+    if (this.config.storageProviders) {
+      for (const [type, config] of Object.entries(this.config.storageProviders)) {
+        if (config && config.enabled) {
+          const provider = this.storageProviders.get(type);
+          if (provider) {
+            try {
+              await provider.initialize(config);
+              logger6.info(`\u2705 [UniversalFileService] \u5B58\u50A8\u63D0\u4F9B\u8005\u521D\u59CB\u5316\u5B8C\u6210: ${type}`);
+            } catch (error) {
+              console.warn(`\u26A0\uFE0F [UniversalFileService] \u5B58\u50A8\u63D0\u4F9B\u8005\u521D\u59CB\u5316\u5931\u8D25: ${type}:`, error);
+            }
+          } else {
+            console.warn(`\u26A0\uFE0F [UniversalFileService] \u5B58\u50A8\u63D0\u4F9B\u8005\u672A\u6CE8\u518C: ${type}`);
           }
-        } else {
-          console.warn(`\u26A0\uFE0F [UniversalFileService] \u5B58\u50A8\u63D0\u4F9B\u8005\u672A\u6CE8\u518C: ${type}`);
         }
       }
     }
   }
   async registerDefaultStorageProviders() {
     logger6.info("\u{1F4E6} [UniversalFileService] \u6CE8\u518C\u9ED8\u8BA4\u5B58\u50A8\u63D0\u4F9B\u8005...");
-    const ossConfig = this.config.storageProviders["aliyun-oss"];
-    if (ossConfig && ossConfig.enabled) {
-      try {
-        const { AliyunOSSProvider: AliyunOSSProvider2 } = await import('../../AliyunOSSProvider-GQMSDJGZ.mjs');
-        const ossProvider = new AliyunOSSProvider2();
-        this.registerStorageProvider(ossProvider);
-        logger6.info("\u2705 [UniversalFileService] \u963F\u91CC\u4E91OSS\u63D0\u4F9B\u8005\u6CE8\u518C\u6210\u529F");
-      } catch (error) {
-        console.warn("\u26A0\uFE0F [UniversalFileService] \u963F\u91CC\u4E91OSS\u63D0\u4F9B\u8005\u6CE8\u518C\u5931\u8D25:", error);
-      }
-    }
-    const localConfig = this.config.storageProviders["local"];
-    if (localConfig && localConfig.enabled) {
-      try {
-        const { LocalStorageProvider: LocalStorageProvider2 } = await import('../../LocalStorageProvider-FVLLHBHO.mjs');
-        const localProvider = new LocalStorageProvider2();
-        this.registerStorageProvider(localProvider);
-        logger6.info("\u2705 [UniversalFileService] \u672C\u5730\u5B58\u50A8\u63D0\u4F9B\u8005\u6CE8\u518C\u6210\u529F");
-      } catch (error) {
-        console.warn("\u26A0\uFE0F [UniversalFileService] \u672C\u5730\u5B58\u50A8\u63D0\u4F9B\u8005\u6CE8\u518C\u5931\u8D25:", error);
+    try {
+      if (this.config.storage) {
+        if (this.config.storage.type === "aliyun-oss" && this.config.storage.enabled) {
+          const { AliyunOSSProvider: AliyunOSSProvider2 } = await import('../../AliyunOSSProvider-GQMSDJGZ.mjs');
+          const ossProvider = new AliyunOSSProvider2();
+          this.registerStorageProvider(ossProvider);
+          logger6.info("\u2705 [UniversalFileService] \u963F\u91CC\u4E91OSS\u63D0\u4F9B\u8005\u6CE8\u518C\u6210\u529F");
+        } else if (this.config.storage.type === "local" && this.config.storage.enabled) {
+          const { LocalStorageProvider: LocalStorageProvider2 } = await import('../../LocalStorageProvider-FVLLHBHO.mjs');
+          const localProvider = new LocalStorageProvider2();
+          this.registerStorageProvider(localProvider);
+          logger6.info("\u2705 [UniversalFileService] \u672C\u5730\u5B58\u50A8\u63D0\u4F9B\u8005\u6CE8\u518C\u6210\u529F");
+        }
       }
-    }
-    if (this.storageProviders.size === 0) {
-      console.warn("\u26A0\uFE0F [UniversalFileService] \u6CA1\u6709\u53EF\u7528\u7684\u5B58\u50A8\u63D0\u4F9B\u8005\uFF0C\u5C1D\u8BD5\u6CE8\u518C\u672C\u5730\u5B58\u50A8\u4F5C\u4E3A\u5907\u7528");
-      try {
+      if (this.storageProviders.size === 0) {
         const { LocalStorageProvider: LocalStorageProvider2 } = await import('../../LocalStorageProvider-FVLLHBHO.mjs');
-        const localProvider = new LocalStorageProvider2();
-        this.registerStorageProvider(localProvider);
-        logger6.info("\u2705 [UniversalFileService] \u672C\u5730\u5B58\u50A8\u63D0\u4F9B\u8005\u6CE8\u518C\u6210\u529F\uFF08\u5907\u7528\uFF09");
-      } catch (error) {
-        console.error("\u274C [UniversalFileService] \u65E0\u6CD5\u6CE8\u518C\u4EFB\u4F55\u5B58\u50A8\u63D0\u4F9B\u8005:", error);
-        throw new Error("\u65E0\u6CD5\u521D\u59CB\u5316\u5B58\u50A8\u63D0\u4F9B\u8005");
+        const fallbackProvider = new LocalStorageProvider2();
+        this.registerStorageProvider(fallbackProvider);
+        logger6.info("\u2705 [UniversalFileService] \u5DF2\u6CE8\u518C\u5907\u7528\u672C\u5730\u5B58\u50A8\u63D0\u4F9B\u8005");
       }
+    } catch (error) {
+      console.warn("\u26A0\uFE0F [UniversalFileService] \u6CE8\u518C\u9ED8\u8BA4\u5B58\u50A8\u63D0\u4F9B\u8005\u5931\u8D25:", error);
+      throw new Error("\u65E0\u6CD5\u521D\u59CB\u5316\u5B58\u50A8\u63D0\u4F9B\u8005");
     }
   }
   async initializeCDNProviders() {
-    for (const [type, config] of Object.entries(this.config.cdnProviders)) {
-      if (config.enabled) {
-        const provider = this.cdnProviders.get(type);
-        if (provider) {
-          await provider.initialize(config);
-          logger6.info(`\u2705 [UniversalFileService] CDN\u63D0\u4F9B\u8005\u521D\u59CB\u5316\u5B8C\u6210: ${type}`);
-        }
-      }
+    if (this.config.cdn && this.config.cdn.enabled) {
+      logger6.info(`\u2705 [UniversalFileService] CDN\u914D\u7F6E\u5DF2\u542F\u7528: ${this.config.cdn.type}`);
     }
   }
   async initializeFileProcessors() {
@@ -3225,11 +3208,11 @@ var UniversalFileService = class extends EventEmitter {
     }
   }
   async validateFile(file) {
-    if (file.size > this.config.maxFileSize) {
+    if (this.config.maxFileSize && file.size > this.config.maxFileSize) {
       throw new FileUploadError(`\u6587\u4EF6\u5927\u5C0F\u8D85\u8FC7\u9650\u5236: ${file.size} > ${this.config.maxFileSize}`);
     }
     const mimeType = file.type || getMimeType(file.name);
-    if (this.config.allowedMimeTypes.length > 0 && !this.config.allowedMimeTypes.includes(mimeType)) {
+    if (this.config.allowedMimeTypes && this.config.allowedMimeTypes.length > 0 && !this.config.allowedMimeTypes.includes(mimeType)) {
       throw new FileUploadError(`\u4E0D\u652F\u6301\u7684\u6587\u4EF6\u7C7B\u578B: ${mimeType}`);
     }
   }
@@ -3251,7 +3234,7 @@ var UniversalFileService = class extends EventEmitter {
       uploaderId: fileInfo.metadata?.uploadedBy || "system",
       moduleId: fileInfo.moduleId,
       businessId: fileInfo.businessId,
-      storageProvider: this.config.defaultStorage,
+      storageProvider: this.config.defaultStorage || "local",
       storagePath: "",
       accessCount: 0,
       metadata: fileInfo.metadata || {}
@@ -4513,6 +4496,760 @@ function createDrizzleRepository(config) {
   };
 }
 
-export { AliyunCDNProvider, ApiError, ApiErrorCode, AudioProcessor, CacheManager, CacheStrategyType, CdnCacheStrategy2 as CdnCacheStrategy, ConfigValidationError, ErrorHttpStatusMap, ErrorMessages, ImageProcessor, PerformanceMonitor, ProcessingQueue, UniversalFileService, VideoProcessor, cdnCacheStrategy, createAliyunOSSPreset, createDocumentServicePreset, createDrizzleRepository, createFileServiceConfig, createFileServiceFromEnv, createImageServicePreset, createLocalDevPreset, createSmartPreset, createUniversalFileService, createVideoServicePreset, getMimeType, getRequiredEnvVars, validateEnvironment, validateServiceConfig, validateStorageConfig };
+// src/universalFile/server/config-helpers.ts
+var logger9 = createLogger("FileConfigHelpers");
+var DEFAULT_MAX_FILE_SIZE = 104857600;
+var DEFAULT_ALLOWED_MIME_TYPES = [
+  // 图片类型
+  "image/jpeg",
+  "image/png",
+  "image/gif",
+  "image/webp",
+  "image/svg+xml",
+  "image/bmp",
+  "image/tiff",
+  // 音频类型
+  "audio/mpeg",
+  "audio/wav",
+  "audio/ogg",
+  "audio/mp4",
+  "audio/aac",
+  "audio/webm",
+  "audio/flac",
+  // 视频类型
+  "video/mp4",
+  "video/avi",
+  "video/mov",
+  "video/webm",
+  "video/mkv",
+  "video/mpeg",
+  "video/quicktime",
+  // 文档类型
+  "application/pdf",
+  "text/plain",
+  "application/json",
+  "application/javascript",
+  "text/css",
+  "text/html",
+  "text/markdown",
+  "application/xml",
+  "text/xml",
+  // Office 文档
+  "application/msword",
+  "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+  "application/vnd.ms-excel",
+  "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+  "application/vnd.ms-powerpoint",
+  "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+  // 压缩文件
+  "application/zip",
+  "application/x-zip-compressed",
+  "application/x-rar-compressed",
+  "application/x-7z-compressed",
+  "application/x-tar",
+  "application/gzip",
+  // 3D模型文件
+  "application/octet-stream",
+  "model/gltf+json",
+  "model/gltf-binary",
+  "model/obj",
+  "model/fbx"
+];
+var DEFAULT_CACHE_CONFIG = {
+  enabled: false,
+  metadataTTL: 3600,
+  // 1小时
+  urlTTL: 1800
+  // 30分钟
+};
+var DEFAULT_FILE_SERVICE_CONFIG = {
+  maxFileSize: DEFAULT_MAX_FILE_SIZE,
+  allowedMimeTypes: DEFAULT_ALLOWED_MIME_TYPES,
+  cache: DEFAULT_CACHE_CONFIG,
+  enableMonitoring: false
+};
+function loadOSSConfigFromEnv() {
+  const region = process.env.ALIYUN_OSS_REGION;
+  const bucket = process.env.ALIYUN_OSS_BUCKET;
+  const accessKeyId = process.env.ALIYUN_OSS_ACCESS_KEY_ID;
+  const accessKeySecret = process.env.ALIYUN_OSS_ACCESS_KEY_SECRET;
+  if (!region || !bucket || !accessKeyId || !accessKeySecret) {
+    logger9.debug("OSS \u73AF\u5883\u53D8\u91CF\u914D\u7F6E\u4E0D\u5B8C\u6574", {
+      hasRegion: !!region,
+      hasBucket: !!bucket,
+      hasAccessKeyId: !!accessKeyId,
+      hasAccessKeySecret: !!accessKeySecret
+    });
+    return null;
+  }
+  const config = {
+    type: "aliyun-oss",
+    enabled: true,
+    region,
+    bucket,
+    accessKeyId,
+    accessKeySecret,
+    customDomain: process.env.ALIYUN_OSS_CUSTOM_DOMAIN,
+    secure: process.env.ALIYUN_OSS_SECURE === "true",
+    internal: process.env.ALIYUN_OSS_INTERNAL === "true"
+  };
+  logger9.info("\u2705 \u4ECE\u73AF\u5883\u53D8\u91CF\u52A0\u8F7D OSS \u914D\u7F6E\u6210\u529F", {
+    region: config.region,
+    bucket: config.bucket,
+    hasCustomDomain: !!config.customDomain
+  });
+  return config;
+}
+function loadCDNConfigFromEnv() {
+  const domain = process.env.ALIYUN_CDN_DOMAIN;
+  const accessKeyId = process.env.ALIYUN_CDN_ACCESS_KEY_ID;
+  const accessKeySecret = process.env.ALIYUN_CDN_ACCESS_KEY_SECRET;
+  if (!domain || !accessKeyId || !accessKeySecret) {
+    logger9.debug("CDN \u73AF\u5883\u53D8\u91CF\u672A\u914D\u7F6E\u6216\u4E0D\u5B8C\u6574");
+    return null;
+  }
+  const config = {
+    type: "aliyun-cdn",
+    enabled: true,
+    domain,
+    accessKeyId,
+    accessKeySecret,
+    region: process.env.ALIYUN_CDN_REGION
+  };
+  logger9.info("\u2705 \u4ECE\u73AF\u5883\u53D8\u91CF\u52A0\u8F7D CDN \u914D\u7F6E\u6210\u529F", {
+    domain: config.domain
+  });
+  return config;
+}
+function getDefaultLocalStorage() {
+  return {
+    type: "local",
+    enabled: true,
+    rootPath: process.env.FILE_STORAGE_PATH || "uploads",
+    baseUrl: process.env.FILE_BASE_URL || "/uploads"
+  };
+}
+function loadConfigFromEnv() {
+  logger9.info("\u4ECE\u73AF\u5883\u53D8\u91CF\u52A0\u8F7D\u6587\u4EF6\u670D\u52A1\u914D\u7F6E...");
+  const ossConfig = loadOSSConfigFromEnv();
+  const cdnConfig = loadCDNConfigFromEnv();
+  const storage = ossConfig || getDefaultLocalStorage();
+  const defaultStorage = ossConfig ? "aliyun-oss" : "local";
+  logger9.info(`\u4F7F\u7528\u5B58\u50A8\u65B9\u5F0F: ${defaultStorage}`);
+  const config = {
+    storage,
+    defaultStorage,
+    cdn: cdnConfig || void 0,
+    defaultCDN: cdnConfig ? "aliyun-cdn" : "none",
+    maxFileSize: process.env.MAX_FILE_SIZE ? parseInt(process.env.MAX_FILE_SIZE) : DEFAULT_MAX_FILE_SIZE,
+    allowedMimeTypes: DEFAULT_ALLOWED_MIME_TYPES,
+    cache: {
+      enabled: process.env.ENABLE_CACHE === "true",
+      metadataTTL: process.env.METADATA_CACHE_TTL ? parseInt(process.env.METADATA_CACHE_TTL) : DEFAULT_CACHE_CONFIG.metadataTTL,
+      urlTTL: process.env.URL_CACHE_TTL ? parseInt(process.env.URL_CACHE_TTL) : DEFAULT_CACHE_CONFIG.urlTTL
+    },
+    enableMonitoring: process.env.ENABLE_FILE_MONITORING === "true"
+  };
+  logger9.info("\u2705 \u914D\u7F6E\u52A0\u8F7D\u5B8C\u6210");
+  return config;
+}
+var DEFAULT_OSS_CONFIG_KEYS = {
+  region: "aliyun_oss_region",
+  bucket: "aliyun_oss_bucket",
+  accessKeyId: "aliyun_oss_access_key_id",
+  accessKeySecret: "aliyun_oss_access_key_secret",
+  customDomain: "aliyun_oss_custom_domain",
+  secure: "aliyun_oss_secure",
+  internal: "aliyun_oss_internal"
+};
+async function loadOSSConfigFromService(configService, keyMapping = DEFAULT_OSS_CONFIG_KEYS) {
+  const logger10 = createLogger("loadOSSConfigFromService");
+  try {
+    const keys = { ...DEFAULT_OSS_CONFIG_KEYS, ...keyMapping };
+    const [region, bucket, accessKeyId, accessKeySecret, customDomain, secure, internal] = await Promise.all([
+      configService.getConfig(keys.region),
+      configService.getConfig(keys.bucket),
+      configService.getConfig(keys.accessKeyId),
+      configService.getConfig(keys.accessKeySecret),
+      configService.getConfig(keys.customDomain || ""),
+      configService.getConfig(keys.secure || ""),
+      configService.getConfig(keys.internal || "")
+    ]);
+    if (!region || !bucket || !accessKeyId || !accessKeySecret) {
+      logger10.debug("\u914D\u7F6E\u670D\u52A1\u4E2D\u7684 OSS \u914D\u7F6E\u4E0D\u5B8C\u6574");
+      return null;
+    }
+    const config = {
+      type: "aliyun-oss",
+      enabled: true,
+      region,
+      bucket,
+      accessKeyId,
+      accessKeySecret,
+      customDomain,
+      secure: secure === "true" || secure === true,
+      internal: internal === "true" || internal === true
+    };
+    logger10.info("\u2705 \u4ECE\u914D\u7F6E\u670D\u52A1\u52A0\u8F7D OSS \u914D\u7F6E\u6210\u529F");
+    return config;
+  } catch (error) {
+    logger10.warn("\u4ECE\u914D\u7F6E\u670D\u52A1\u52A0\u8F7D OSS \u914D\u7F6E\u5931\u8D25:", error);
+    return null;
+  }
+}
+async function loadConfigWithFallback(loaders) {
+  for (const loader of loaders) {
+    try {
+      const config = await loader();
+      if (config) {
+        return config;
+      }
+    } catch (error) {
+      continue;
+    }
+  }
+  return null;
+}
+async function createFileServiceWithFactory(options = {}) {
+  const {
+    configLoaders = [() => Promise.resolve(loadConfigFromEnv())],
+    repository,
+    customConfig,
+    autoInitialize = false
+  } = options;
+  const logger10 = createLogger("FileServiceFactory");
+  logger10.info("\u521B\u5EFA\u6587\u4EF6\u670D\u52A1...");
+  let config = null;
+  for (const loader of configLoaders) {
+    try {
+      const loadedConfig = await loader();
+      if (loadedConfig) {
+        config = loadedConfig;
+        break;
+      }
+    } catch (error) {
+      logger10.warn("\u914D\u7F6E\u52A0\u8F7D\u5668\u5931\u8D25:", error);
+      continue;
+    }
+  }
+  if (!config) {
+    throw new Error("\u65E0\u6CD5\u52A0\u8F7D\u6587\u4EF6\u670D\u52A1\u914D\u7F6E\uFF1A\u6240\u6709\u914D\u7F6E\u6E90\u90FD\u5931\u8D25");
+  }
+  const finalConfig = {
+    ...config,
+    ...customConfig
+  };
+  if (repository) {
+    finalConfig.persistence = {
+      enabled: true,
+      repository,
+      autoPersist: true
+    };
+  }
+  const service = new UniversalFileService(finalConfig);
+  if (autoInitialize) {
+    await service.initialize();
+    logger10.info("\u2705 \u6587\u4EF6\u670D\u52A1\u521B\u5EFA\u5E76\u521D\u59CB\u5316\u5B8C\u6210");
+  } else {
+    logger10.info("\u2705 \u6587\u4EF6\u670D\u52A1\u521B\u5EFA\u5B8C\u6210");
+  }
+  return service;
+}
+function createSingleton(factory, options = {}) {
+  const { autoInitialize = true, name = "Singleton" } = options;
+  const singletonLogger = createLogger(name);
+  let instance = null;
+  let initPromise = null;
+  return {
+    async get() {
+      if (instance) {
+        return instance;
+      }
+      if (initPromise) {
+        singletonLogger.debug("\u7B49\u5F85\u5B9E\u4F8B\u521D\u59CB\u5316\u5B8C\u6210...");
+        return initPromise;
+      }
+      singletonLogger.info("\u521B\u5EFA\u5355\u4F8B\u5B9E\u4F8B...");
+      initPromise = factory();
+      try {
+        instance = await initPromise;
+        singletonLogger.info("\u2705 \u5355\u4F8B\u5B9E\u4F8B\u521B\u5EFA\u5B8C\u6210");
+        return instance;
+      } catch (error) {
+        singletonLogger.error("\u274C \u5355\u4F8B\u5B9E\u4F8B\u521B\u5EFA\u5931\u8D25:", error);
+        initPromise = null;
+        throw error;
+      }
+    },
+    reset() {
+      if (instance) {
+        singletonLogger.info("\u91CD\u7F6E\u5355\u4F8B\u5B9E\u4F8B");
+        instance = null;
+        initPromise = null;
+      }
+    },
+    isCreated() {
+      return instance !== null;
+    }
+  };
+}
+var fileStorageProviders = pgTable(
+  "file_storage_providers",
+  {
+    /** 主键ID */
+    id: serial("id").primaryKey(),
+    /** 提供者名称 */
+    name: varchar("name", { length: 100 }).notNull().unique(),
+    /** 提供者类型：local, aliyun_oss, aws_s3, qiniu, etc. */
+    type: varchar("type", { length: 50 }).notNull(),
+    /** 提供者配置（JSON格式存储具体配置信息） */
+    config: json("config").notNull(),
+    /** 是否启用 */
+    isActive: boolean("is_active").notNull().default(true),
+    /** 是否为默认提供者 */
+    isDefault: boolean("is_default").notNull().default(false),
+    /** 优先级（数字越小优先级越高） */
+    priority: integer("priority").notNull().default(100),
+    /** 最大文件大小限制（字节） */
+    maxFileSize: bigint("max_file_size", { mode: "number" }),
+    /** 支持的文件类型（MIME类型列表） */
+    supportedMimeTypes: json("supported_mime_types"),
+    /** 创建时间 */
+    createdAt: timestamp("created_at").defaultNow().notNull(),
+    /** 更新时间 */
+    updatedAt: timestamp("updated_at").defaultNow().notNull()
+  },
+  (table) => ({
+    /** 按类型查询的索引 */
+    typeIndex: index("storage_providers_type_idx").on(table.type),
+    /** 按活跃状态查询的索引 */
+    isActiveIndex: index("storage_providers_is_active_idx").on(table.isActive),
+    /** 按优先级排序的索引 */
+    priorityIndex: index("storage_providers_priority_idx").on(table.priority)
+  })
+);
+var fileFolders = pgTable(
+  "file_folders",
+  {
+    /** 主键ID */
+    id: uuid("id").primaryKey().defaultRandom(),
+    /** 文件夹名称 */
+    name: varchar("name", { length: 255 }).notNull(),
+    /** 父文件夹ID（为null表示根文件夹） */
+    parentId: uuid("parent_id"),
+    /** 模块ID（标识属于哪个模块） */
+    moduleId: varchar("module_id", { length: 100 }),
+    /** 业务ID（具体业务实体的ID） */
+    businessId: varchar("business_id", { length: 255 }),
+    /** 文件夹路径（从根到当前文件夹的完整路径） */
+    path: text("path").notNull(),
+    /** 层级深度 */
+    depth: integer("depth").notNull().default(0),
+    /** 显示顺序 */
+    sortOrder: integer("sort_order").notNull().default(0),
+    /** 文件夹描述 */
+    description: text("description"),
+    /** 是否为系统文件夹 */
+    isSystem: boolean("is_system").notNull().default(false),
+    /** 创建者ID */
+    createdBy: varchar("created_by", { length: 255 }).notNull(),
+    /** 创建时间 */
+    createdAt: timestamp("created_at").defaultNow().notNull(),
+    /** 更新时间 */
+    updatedAt: timestamp("updated_at").defaultNow().notNull()
+  },
+  (table) => ({
+    /** 按模块查询的索引 */
+    moduleIndex: index("folders_module_idx").on(table.moduleId),
+    /** 按业务ID查询的索引 */
+    businessIndex: index("folders_business_idx").on(table.businessId),
+    /** 按父文件夹查询的索引 */
+    parentIndex: index("folders_parent_idx").on(table.parentId),
+    /** 按路径查询的索引 */
+    pathIndex: index("folders_path_idx").on(table.path),
+    /** 组合索引：模块+业务+父文件夹 */
+    moduleBusinessParentIndex: index("folders_module_business_parent_idx").on(
+      table.moduleId,
+      table.businessId,
+      table.parentId
+    )
+  })
+);
+var fileMetadata = pgTable(
+  "file_metadata",
+  {
+    /** 主键ID */
+    id: uuid("id").primaryKey().defaultRandom(),
+    /** 原始文件名 */
+    originalName: varchar("original_name", { length: 500 }).notNull(),
+    /** 存储文件名（系统生成的唯一文件名） */
+    storedName: varchar("stored_name", { length: 500 }).notNull(),
+    /** 文件扩展名 */
+    extension: varchar("extension", { length: 20 }),
+    /** MIME类型 */
+    mimeType: varchar("mime_type", { length: 100 }).notNull(),
+    /** 文件大小（字节） */
+    size: bigint("size", { mode: "number" }).notNull(),
+    /** 文件MD5哈希值（用于去重和完整性校验） */
+    md5Hash: varchar("md5_hash", { length: 32 }).notNull(),
+    /** 文件SHA256哈希值 */
+    sha256Hash: varchar("sha256_hash", { length: 64 }),
+    /** 存储提供者ID */
+    storageProviderId: integer("storage_provider_id").references(() => fileStorageProviders.id).notNull(),
+    /** 存储路径 */
+    storagePath: text("storage_path").notNull(),
+    /** CDN访问URL */
+    cdnUrl: text("cdn_url"),
+    /** 所属文件夹ID */
+    folderId: uuid("folder_id").references(() => fileFolders.id, { onDelete: "set null" }),
+    /** 模块ID */
+    moduleId: varchar("module_id", { length: 100 }),
+    /** 业务ID */
+    businessId: varchar("business_id", { length: 255 }),
+    /** 文件标签（JSON数组） */
+    tags: json("tags"),
+    /** 文件元信息（如图片尺寸、视频时长等） */
+    metadata: json("metadata"),
+    /** 是否为临时文件 */
+    isTemporary: boolean("is_temporary").notNull().default(false),
+    /** 是否已删除（软删除） */
+    isDeleted: boolean("is_deleted").notNull().default(false),
+    /** 访问次数 */
+    accessCount: integer("access_count").notNull().default(0),
+    /** 下载次数 */
+    downloadCount: integer("download_count").notNull().default(0),
+    /** 上传者ID */
+    uploaderId: varchar("uploader_id", { length: 255 }).notNull(),
+    /** 上传时间 */
+    uploadTime: timestamp("upload_time").defaultNow().notNull(),
+    /** 最后访问时间 */
+    lastAccessTime: timestamp("last_access_time"),
+    /** 过期时间（为null表示永不过期） */
+    expiresAt: timestamp("expires_at"),
+    /** 创建时间 */
+    createdAt: timestamp("created_at").defaultNow().notNull(),
+    /** 更新时间 */
+    updatedAt: timestamp("updated_at").defaultNow().notNull(),
+    /** 删除时间 */
+    deletedAt: timestamp("deleted_at")
+  },
+  (table) => ({
+    /** 按MD5哈希查询的索引（去重用） */
+    md5Index: index("file_metadata_md5_idx").on(table.md5Hash),
+    /** 按SHA256哈希查询的索引 */
+    sha256Index: index("file_metadata_sha256_idx").on(table.sha256Hash),
+    /** 按模块查询的索引 */
+    moduleIndex: index("file_metadata_module_idx").on(table.moduleId),
+    /** 按业务ID查询的索引 */
+    businessIndex: index("file_metadata_business_idx").on(table.businessId),
+    /** 按上传者查询的索引 */
+    uploaderIndex: index("file_metadata_uploader_idx").on(table.uploaderId),
+    /** 按MIME类型查询的索引 */
+    mimeTypeIndex: index("file_metadata_mime_type_idx").on(table.mimeType),
+    /** 按删除状态查询的索引 */
+    isDeletedIndex: index("file_metadata_is_deleted_idx").on(table.isDeleted),
+    /** 按临时状态查询的索引 */
+    isTemporaryIndex: index("file_metadata_is_temporary_idx").on(table.isTemporary),
+    /** 按文件夹查询的索引 */
+    folderIndex: index("file_metadata_folder_idx").on(table.folderId),
+    /** 按上传时间查询的索引 */
+    uploadTimeIndex: index("file_metadata_upload_time_idx").on(table.uploadTime),
+    /** 组合索引：模块+业务+删除状态 */
+    moduleBusinessDeletedIndex: index("file_metadata_module_business_deleted_idx").on(
+      table.moduleId,
+      table.businessId,
+      table.isDeleted
+    ),
+    /** 组合索引：文件夹+删除状态 */
+    folderDeletedIndex: index("file_metadata_folder_deleted_idx").on(
+      table.folderId,
+      table.isDeleted
+    )
+  })
+);
+var fileVersions = pgTable(
+  "file_versions",
+  {
+    /** 主键ID */
+    id: uuid("id").primaryKey().defaultRandom(),
+    /** 关联的文件ID */
+    fileId: uuid("file_id").references(() => fileMetadata.id, { onDelete: "cascade" }).notNull(),
+    /** 版本号 */
+    version: integer("version").notNull(),
+    /** 版本描述 */
+    description: text("description"),
+    /** 文件大小 */
+    size: bigint("size", { mode: "number" }).notNull(),
+    /** MD5哈希值 */
+    md5Hash: varchar("md5_hash", { length: 32 }).notNull(),
+    /** 存储路径 */
+    storagePath: text("storage_path").notNull(),
+    /** CDN访问URL */
+    cdnUrl: text("cdn_url"),
+    /** 是否为当前版本 */
+    isCurrent: boolean("is_current").notNull().default(false),
+    /** 创建者ID */
+    createdBy: varchar("created_by", { length: 255 }).notNull(),
+    /** 创建时间 */
+    createdAt: timestamp("created_at").defaultNow().notNull()
+  },
+  (table) => ({
+    /** 按文件ID查询的索引 */
+    fileIndex: index("file_versions_file_idx").on(table.fileId),
+    /** 按当前版本查询的索引 */
+    isCurrentIndex: index("file_versions_is_current_idx").on(table.isCurrent),
+    /** 组合索引：文件+版本 */
+    fileVersionIndex: index("file_versions_file_version_idx").on(table.fileId, table.version)
+  })
+);
+var fileProcessingRecords = pgTable(
+  "file_processing_records",
+  {
+    /** 主键ID */
+    id: uuid("id").primaryKey().defaultRandom(),
+    /** 关联的文件ID */
+    fileId: uuid("file_id").references(() => fileMetadata.id, { onDelete: "cascade" }).notNull(),
+    /** 处理类型：compress, resize, convert, thumbnail, watermark, etc. */
+    processingType: varchar("processing_type", { length: 50 }).notNull(),
+    /** 处理器名称 */
+    processorName: varchar("processor_name", { length: 100 }).notNull(),
+    /** 处理状态：pending, processing, completed, failed */
+    status: varchar("status", { length: 20 }).notNull().default("pending"),
+    /** 处理参数（JSON格式） */
+    parameters: json("parameters"),
+    /** 处理结果（JSON格式） */
+    result: json("result"),
+    /** 输出文件路径 */
+    outputPath: text("output_path"),
+    /** 输出文件大小 */
+    outputSize: bigint("output_size", { mode: "number" }),
+    /** 处理耗时（毫秒） */
+    processingTimeMs: integer("processing_time_ms"),
+    /** 错误信息 */
+    errorMessage: text("error_message"),
+    /** 重试次数 */
+    retryCount: integer("retry_count").notNull().default(0),
+    /** 优先级 */
+    priority: integer("priority").notNull().default(5),
+    /** 开始时间 */
+    startedAt: timestamp("started_at"),
+    /** 完成时间 */
+    completedAt: timestamp("completed_at"),
+    /** 创建时间 */
+    createdAt: timestamp("created_at").defaultNow().notNull(),
+    /** 更新时间 */
+    updatedAt: timestamp("updated_at").defaultNow().notNull()
+  },
+  (table) => ({
+    /** 按文件ID查询的索引 */
+    fileIndex: index("file_processing_records_file_idx").on(table.fileId),
+    /** 按处理状态查询的索引 */
+    statusIndex: index("file_processing_records_status_idx").on(table.status),
+    /** 按处理类型查询的索引 */
+    processingTypeIndex: index("file_processing_records_processing_type_idx").on(
+      table.processingType
+    ),
+    /** 按优先级查询的索引 */
+    priorityIndex: index("file_processing_records_priority_idx").on(table.priority),
+    /** 组合索引：文件+处理类型 */
+    fileProcessingTypeIndex: index("file_processing_records_file_processing_type_idx").on(
+      table.fileId,
+      table.processingType
+    )
+  })
+);
+var fileShares = pgTable(
+  "file_shares",
+  {
+    /** 主键ID */
+    id: uuid("id").primaryKey().defaultRandom(),
+    /** 分享代码（短链接标识） */
+    shareCode: varchar("share_code", { length: 20 }).notNull().unique(),
+    /** 分享的文件ID列表（JSON数组） */
+    fileIds: json("file_ids").notNull(),
+    /** 分享标题 */
+    title: varchar("title", { length: 255 }),
+    /** 分享描述 */
+    description: text("description"),
+    /** 访问密码 */
+    password: varchar("password", { length: 100 }),
+    /** 访问权限：view, download */
+    permission: varchar("permission", { length: 20 }).notNull().default("view"),
+    /** 最大下载次数（为null表示无限制） */
+    maxDownloads: integer("max_downloads"),
+    /** 当前下载次数 */
+    downloadCount: integer("download_count").notNull().default(0),
+    /** 最大访问次数（为null表示无限制） */
+    maxAccess: integer("max_access"),
+    /** 当前访问次数 */
+    accessCount: integer("access_count").notNull().default(0),
+    /** 是否启用 */
+    isActive: boolean("is_active").notNull().default(true),
+    /** 过期时间 */
+    expiresAt: timestamp("expires_at"),
+    /** 创建者ID */
+    createdBy: varchar("created_by", { length: 255 }).notNull(),
+    /** 创建时间 */
+    createdAt: timestamp("created_at").defaultNow().notNull(),
+    /** 更新时间 */
+    updatedAt: timestamp("updated_at").defaultNow().notNull()
+  },
+  (table) => ({
+    /** 按分享代码查询的索引 */
+    shareCodeIndex: index("file_shares_share_code_idx").on(table.shareCode),
+    /** 按创建者查询的索引 */
+    createdByIndex: index("file_shares_created_by_idx").on(table.createdBy),
+    /** 按活跃状态查询的索引 */
+    isActiveIndex: index("file_shares_is_active_idx").on(table.isActive),
+    /** 按过期时间查询的索引 */
+    expiresAtIndex: index("file_shares_expires_at_idx").on(table.expiresAt)
+  })
+);
+var fileAccessLogs = pgTable(
+  "file_access_logs",
+  {
+    /** 主键ID */
+    id: uuid("id").primaryKey().defaultRandom(),
+    /** 关联的文件ID */
+    fileId: uuid("file_id").references(() => fileMetadata.id, { onDelete: "cascade" }),
+    /** 分享ID（如果通过分享访问） */
+    shareId: uuid("share_id").references(() => fileShares.id, { onDelete: "set null" }),
+    /** 访问类型：view, download, preview, thumbnail */
+    accessType: varchar("access_type", { length: 20 }).notNull(),
+    /** 用户ID */
+    userId: varchar("user_id", { length: 255 }),
+    /** 客户端IP地址 */
+    ipAddress: varchar("ip_address", { length: 45 }),
+    /** 用户代理字符串 */
+    userAgent: text("user_agent"),
+    /** 访问来源 */
+    referer: text("referer"),
+    /** 响应状态码 */
+    statusCode: integer("status_code"),
+    /** 传输字节数 */
+    bytesTransferred: bigint("bytes_transferred", { mode: "number" }),
+    /** 响应时间（毫秒） */
+    responseTimeMs: integer("response_time_ms"),
+    /** 访问时间 */
+    accessedAt: timestamp("accessed_at").defaultNow().notNull()
+  },
+  (table) => ({
+    /** 按文件ID查询的索引 */
+    fileIndex: index("file_access_logs_file_idx").on(table.fileId),
+    /** 按用户ID查询的索引 */
+    userIndex: index("file_access_logs_user_idx").on(table.userId),
+    /** 按访问类型查询的索引 */
+    accessTypeIndex: index("file_access_logs_access_type_idx").on(table.accessType),
+    /** 按访问时间查询的索引 */
+    accessedAtIndex: index("file_access_logs_accessed_at_idx").on(table.accessedAt),
+    /** 按分享ID查询的索引 */
+    shareIndex: index("file_access_logs_share_idx").on(table.shareId)
+  })
+);
+var fileThumbnails = pgTable(
+  "file_thumbnails",
+  {
+    /** 主键ID */
+    id: uuid("id").primaryKey().defaultRandom(),
+    /** 关联的文件ID */
+    fileId: uuid("file_id").references(() => fileMetadata.id, { onDelete: "cascade" }).notNull(),
+    /** 缩略图类型：thumbnail, preview, poster（视频封面）, etc. */
+    type: varchar("type", { length: 50 }).notNull(),
+    /** 缩略图规格：small, medium, large, 或具体尺寸如 "200x200" */
+    size: varchar("size", { length: 20 }).notNull(),
+    /** 缩略图宽度 */
+    width: integer("width"),
+    /** 缩略图高度 */
+    height: integer("height"),
+    /** 缩略图格式：jpg, png, webp, etc. */
+    format: varchar("format", { length: 10 }).notNull(),
+    /** 缩略图文件大小 */
+    fileSize: integer("file_size").notNull(),
+    /** 存储路径 */
+    storagePath: text("storage_path").notNull(),
+    /** CDN访问URL */
+    cdnUrl: text("cdn_url"),
+    /** 生成质量（1-100） */
+    quality: integer("quality").default(85),
+    /** 是否生成成功 */
+    isGenerated: boolean("is_generated").notNull().default(false),
+    /** 生成时间 */
+    generatedAt: timestamp("generated_at"),
+    /** 创建时间 */
+    createdAt: timestamp("created_at").defaultNow().notNull()
+  },
+  (table) => ({
+    /** 按文件ID查询的索引 */
+    fileIndex: index("file_thumbnails_file_idx").on(table.fileId),
+    /** 按类型查询的索引 */
+    typeIndex: index("file_thumbnails_type_idx").on(table.type),
+    /** 按生成状态查询的索引 */
+    isGeneratedIndex: index("file_thumbnails_is_generated_idx").on(table.isGenerated),
+    /** 组合索引：文件+类型+尺寸 */
+    fileTypeSizeIndex: index("file_thumbnails_file_type_size_idx").on(
+      table.fileId,
+      table.type,
+      table.size
+    )
+  })
+);
+var fileStorageProvidersRelations = relations(fileStorageProviders, ({ many }) => ({
+  files: many(fileMetadata)
+}));
+var fileFoldersRelations = relations(fileFolders, ({ one, many }) => ({
+  parent: one(fileFolders, {
+    fields: [fileFolders.parentId],
+    references: [fileFolders.id]
+  }),
+  children: many(fileFolders),
+  files: many(fileMetadata)
+}));
+var fileMetadataRelations = relations(fileMetadata, ({ one, many }) => ({
+  storageProvider: one(fileStorageProviders, {
+    fields: [fileMetadata.storageProviderId],
+    references: [fileStorageProviders.id]
+  }),
+  folder: one(fileFolders, {
+    fields: [fileMetadata.folderId],
+    references: [fileFolders.id]
+  }),
+  versions: many(fileVersions),
+  processingRecords: many(fileProcessingRecords),
+  accessLogs: many(fileAccessLogs),
+  thumbnails: many(fileThumbnails)
+}));
+var fileVersionsRelations = relations(fileVersions, ({ one }) => ({
+  file: one(fileMetadata, {
+    fields: [fileVersions.fileId],
+    references: [fileMetadata.id]
+  })
+}));
+var fileProcessingRecordsRelations = relations(fileProcessingRecords, ({ one }) => ({
+  file: one(fileMetadata, {
+    fields: [fileProcessingRecords.fileId],
+    references: [fileMetadata.id]
+  })
+}));
+var fileSharesRelations = relations(fileShares, ({ many }) => ({
+  accessLogs: many(fileAccessLogs)
+}));
+var fileAccessLogsRelations = relations(fileAccessLogs, ({ one }) => ({
+  file: one(fileMetadata, {
+    fields: [fileAccessLogs.fileId],
+    references: [fileMetadata.id]
+  }),
+  share: one(fileShares, {
+    fields: [fileAccessLogs.shareId],
+    references: [fileShares.id]
+  })
+}));
+var fileThumbnailsRelations = relations(fileThumbnails, ({ one }) => ({
+  file: one(fileMetadata, {
+    fields: [fileThumbnails.fileId],
+    references: [fileMetadata.id]
+  })
+}));
+
+export { AliyunCDNProvider, ApiError, ApiErrorCode, AudioProcessor, CacheManager, CacheStrategyType, CdnCacheStrategy2 as CdnCacheStrategy, ConfigValidationError, DEFAULT_ALLOWED_MIME_TYPES, DEFAULT_CACHE_CONFIG, DEFAULT_FILE_SERVICE_CONFIG, DEFAULT_MAX_FILE_SIZE, DEFAULT_OSS_CONFIG_KEYS, ErrorHttpStatusMap, ErrorMessages, ImageProcessor, PerformanceMonitor, ProcessingQueue, UniversalFileService, VideoProcessor, cdnCacheStrategy, createAliyunOSSPreset, createDocumentServicePreset, createDrizzleRepository, createFileServiceConfig, createFileServiceFromEnv, createFileServiceWithFactory, createImageServicePreset, createLocalDevPreset, createSingleton, createSmartPreset, createUniversalFileService, createVideoServicePreset, fileAccessLogs, fileAccessLogsRelations, fileFolders, fileFoldersRelations, fileMetadata, fileMetadataRelations, fileProcessingRecords, fileProcessingRecordsRelations, fileShares, fileSharesRelations, fileStorageProviders, fileStorageProvidersRelations, fileThumbnails, fileThumbnailsRelations, fileVersions, fileVersionsRelations, getDefaultLocalStorage, getMimeType, getRequiredEnvVars, loadCDNConfigFromEnv, loadConfigFromEnv, loadConfigWithFallback, loadOSSConfigFromEnv, loadOSSConfigFromService, validateEnvironment, validateServiceConfig, validateStorageConfig };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map