sa2kit 1.0.0

package/dist/universalExport/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/universalExport/server/factory.ts","../../../src/universalExport/server/presets.ts","../../../src/universalExport/server/validation.ts","../../../src/universalExport/server/utils/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * UniversalExport Service 工厂函数\n * 提供简化的服务初始化方式\n */\n\nimport type { UniversalExportServiceConfig } from './types';\n\n/**\n * 创建导出服务配置（带智能默认值）\n */\nexport function createExportServiceConfig(\n  options: Partial<UniversalExportServiceConfig> = {}\n): UniversalExportServiceConfig {\n  return {\n    db: options.db,\n    exportDir: options.exportDir || process.env.EXPORT_DIR || './exports',\n    tempDir: options.tempDir || process.env.TEMP_DIR || './temp',\n    maxRows: options.maxRows || 100000, // 默认最多导出 10 万行\n    enableStreaming: options.enableStreaming !== false, // 默认启用流式导出\n    timeout: options.timeout || 300000, // 默认超时 5 分钟\n  };\n}\n\n/**\n * 创建导出服务实例（简化版）\n *\n * @example\n * ```typescript\n * // 最简配置\n * const service = createUniversalExportService();\n *\n * // 标准配置\n * const service = createUniversalExportService({\n *   db: drizzleDb,\n *   exportDir: './exports',\n *   maxRows: 50000,\n * });\n * ```\n */\nexport function createUniversalExportService(\n  options: Partial<UniversalExportServiceConfig> = {}\n) {\n  const config = createExportServiceConfig(options);\n\n  // 注意：实际的 UniversalExportService 将在后续 Phase 中迁移\n  // 这里先返回一个占位对象，包含基本的类型信息\n  console.warn(\n    '⚠️  UniversalExportService 的完整实现将在后续 Phase 中迁移到 Sa2kit。\\n' +\n    '    当前版本仅包含类型定义和配置工厂函数。\\n' +\n    '    请暂时继续从 LyricNote 的 lib/universalExport 导入服务类。'\n  );\n\n  return {\n    config,\n    // 占位方法\n    async export() {\n      throw new Error('UniversalExportService 尚未完全迁移，请从 LyricNote 导入');\n    },\n    async createTask() {\n      throw new Error('UniversalExportService 尚未完全迁移，请从 LyricNote 导入');\n    },\n  };\n}\n\n/**\n * 从环境变量创建配置（便利函数）\n *\n * @example\n * ```typescript\n * // .env\n * // EXPORT_DIR=./exports\n * // EXPORT_MAX_ROWS=50000\n *\n * const service = createExportServiceFromEnv();\n * ```\n */\nexport function createExportServiceFromEnv(db?: any) {\n  return createUniversalExportService({\n    db,\n    exportDir: process.env.EXPORT_DIR,\n    tempDir: process.env.TEMP_DIR,\n    maxRows: process.env.EXPORT_MAX_ROWS\n      ? parseInt(process.env.EXPORT_MAX_ROWS)\n      : undefined,\n  });\n}\n\n","/**\n * UniversalExport 预设配置\n * 提供常见场景的开箱即用配置\n */\n\nimport type { UniversalExportServiceConfig } from './types';\n\n/**\n * 小型应用预设（数据量小）\n */\nexport function createSmallAppPreset(): Partial<UniversalExportServiceConfig> {\n  return {\n    maxRows: 10000, // 1万行\n    timeout: 60000, // 1分钟\n    enableStreaming: false, // 小数据量不需要流式导出\n  };\n}\n\n/**\n * 中型应用预设（默认配置）\n */\nexport function createMediumAppPreset(): Partial<UniversalExportServiceConfig> {\n  return {\n    maxRows: 100000, // 10万行\n    timeout: 300000, // 5分钟\n    enableStreaming: true,\n  };\n}\n\n/**\n * 大型应用预设（数据量大）\n */\nexport function createLargeAppPreset(): Partial<UniversalExportServiceConfig> {\n  return {\n    maxRows: 1000000, // 100万行\n    timeout: 600000, // 10分钟\n    enableStreaming: true,\n  };\n}\n\n/**\n * 实时导出预设（快速响应）\n */\nexport function createRealtimeExportPreset(): Partial<UniversalExportServiceConfig> {\n  return {\n    maxRows: 5000, // 5千行\n    timeout: 30000, // 30秒\n    enableStreaming: false,\n  };\n}\n\n/**\n * 批量导出预设（大批量、离线处理）\n */\nexport function createBatchExportPreset(): Partial<UniversalExportServiceConfig> {\n  return {\n    maxRows: Number.MAX_SAFE_INTEGER, // 不限制\n    timeout: 1800000, // 30分钟\n    enableStreaming: true,\n  };\n}\n\n/**\n * 智能预设：根据环境自动选择\n */\nexport function createSmartExportPreset(): Partial<UniversalExportServiceConfig> {\n  const envMaxRows = process.env.EXPORT_MAX_ROWS;\n\n  if (envMaxRows) {\n    const maxRows = parseInt(envMaxRows);\n\n    // 根据配置的最大行数自动选择合适的预设\n    if (maxRows <= 10000) {\n      return createSmallAppPreset();\n    } else if (maxRows <= 100000) {\n      return createMediumAppPreset();\n    } else {\n      return createLargeAppPreset();\n    }\n  }\n\n  // 默认使用中型应用预设\n  return createMediumAppPreset();\n}\n\n","/**\n * UniversalExport 配置验证\n */\n\nimport type { UniversalExportServiceConfig } from './types';\n\nexport class ConfigValidationError extends Error {\n  constructor(message: string, public field: string) {\n    super(message);\n    this.name = 'ConfigValidationError';\n  }\n}\n\n/**\n * 验证导出服务配置\n */\nexport function validateExportConfig(config: UniversalExportServiceConfig): void {\n  // 验证导出目录\n  if (!config.exportDir) {\n    throw new ConfigValidationError('exportDir is required', 'exportDir');\n  }\n\n  // 验证临时目录\n  if (!config.tempDir) {\n    throw new ConfigValidationError('tempDir is required', 'tempDir');\n  }\n\n  // 验证最大行数\n  if (config.maxRows && config.maxRows <= 0) {\n    throw new ConfigValidationError(\n      'maxRows must be greater than 0',\n      'maxRows'\n    );\n  }\n\n  // 验证超时时间\n  if (config.timeout && config.timeout <= 0) {\n    throw new ConfigValidationError(\n      'timeout must be greater than 0',\n      'timeout'\n    );\n  }\n\n  // 安全建议\n  if (config.maxRows && config.maxRows > 1000000) {\n    console.warn(\n      `⚠️  Warning: maxRows (${config.maxRows}) is very large. ` +\n      `Consider using pagination or streaming for better performance.`\n    );\n  }\n}\n\n/**\n * 验证环境变量\n */\nexport function validateEnvironment(requiredVars: string[]): void {\n  const missing: string[] = [];\n\n  for (const varName of requiredVars) {\n    if (!process.env[varName]) {\n      missing.push(varName);\n    }\n  }\n\n  if (missing.length > 0) {\n    throw new ConfigValidationError(\n      `Missing required environment variables: ${missing.join(', ')}`,\n      'environment'\n    );\n  }\n}\n\n","/**\n * UniversalExport Server 工具函数\n */\n\nimport type { ExportField, FieldType } from '../../types';\n\n/**\n * 格式化字段值\n *\n * @param value 原始值\n * @param field 字段定义\n * @returns 格式化后的值\n */\nexport function formatFieldValue(value: any, field: ExportField): string {\n  // 如果字段有自定义格式化函数，使用它\n  if (field.formatter) {\n    return field.formatter(value);\n  }\n\n  // 空值处理\n  if (value === null || value === undefined) {\n    return '';\n  }\n\n  // 根据字段类型进行默认格式化\n  switch (field.type) {\n    case 'date':\n      return value instanceof Date\n        ? (value.toISOString().split('T')[0] || '')\n        : String(value);\n\n    case 'boolean':\n      return value ? '是' : '否';\n\n    case 'array':\n      return Array.isArray(value) ? value.join(', ') : String(value);\n\n    case 'object':\n      return typeof value === 'object'\n        ? JSON.stringify(value)\n        : String(value);\n\n    case 'number':\n      return typeof value === 'number'\n        ? value.toLocaleString()\n        : String(value);\n\n    default:\n      return String(value);\n  }\n}\n\n/**\n * 验证字段值\n *\n * @param value 字段值\n * @param field 字段定义\n * @returns 是否有效\n */\nexport function validateFieldValue(value: any, field: ExportField): boolean {\n  // 必填字段检查\n  if (field.required && (value === null || value === undefined || value === '')) {\n    return false;\n  }\n\n  // 类型检查\n  switch (field.type) {\n    case 'number':\n      return typeof value === 'number' || !isNaN(Number(value));\n\n    case 'boolean':\n      return typeof value === 'boolean';\n\n    case 'array':\n      return Array.isArray(value);\n\n    case 'object':\n      return typeof value === 'object';\n\n    case 'date':\n      return value instanceof Date || !isNaN(Date.parse(value));\n\n    default:\n      return true;\n  }\n}\n\n/**\n * 转换字段类型\n *\n * @param value 原始值\n * @param targetType 目标类型\n * @returns 转换后的值\n */\nexport function convertFieldType(value: any, targetType: FieldType): any {\n  if (value === null || value === undefined) {\n    return value;\n  }\n\n  switch (targetType) {\n    case 'string':\n      return String(value);\n\n    case 'number':\n      return Number(value);\n\n    case 'boolean':\n      return Boolean(value);\n\n    case 'date':\n      return value instanceof Date ? value : new Date(value);\n\n    case 'array':\n      return Array.isArray(value) ? value : [value];\n\n    case 'object':\n      return typeof value === 'object' ? value : { value };\n\n    default:\n      return value;\n  }\n}\n\n/**\n * 安全获取嵌套属性值\n *\n * @param obj 对象\n * @param path 属性路径（支持点号分隔）\n * @returns 属性值\n *\n * @example\n * ```typescript\n * const obj = { user: { name: 'John', age: 30 } };\n * getNestedValue(obj, 'user.name')  // 'John'\n * getNestedValue(obj, 'user.email') // undefined\n * ```\n */\nexport function getNestedValue(obj: any, path: string): any {\n  return path.split('.').reduce((current, key) => current?.[key], obj);\n}\n\n/**\n * 转义 CSV 字段值\n *\n * @param value 字段值\n * @returns 转义后的值\n */\nexport function escapeCsvValue(value: string): string {\n  // 如果包含逗号、引号或换行符，需要用引号包裹并转义引号\n  if (value.includes(',') || value.includes('\"') || value.includes('\\n')) {\n    return `\"${value.replace(/\"/g, '\"\"')}\"`;\n  }\n  return value;\n}\n\n/**\n * 生成唯一的文件名\n *\n * @param prefix 前缀\n * @param extension 扩展名\n * @returns 唯一文件名\n *\n * @example\n * ```typescript\n * generateUniqueFilename('export', 'xlsx')\n * // 'export_20231111_123456_abc123.xlsx'\n * ```\n */\nexport function generateUniqueFilename(prefix: string, extension: string): string {\n  const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, -5);\n  const random = Math.random().toString(36).substring(2, 8);\n  return `${prefix}_${timestamp}_${random}.${extension}`;\n}\n\n/**\n * 计算导出进度百分比\n *\n * @param processed 已处理行数\n * @param total 总行数\n * @returns 百分比（0-100）\n */\nexport function calculateProgress(processed: number, total: number): number {\n  if (total === 0) return 0;\n  return Math.min(Math.round((processed / total) * 100), 100);\n}\n\n/**\n * 估算剩余时间（秒）\n *\n * @param processed 已处理行数\n * @param total 总行数\n * @param elapsedMs 已用时间（毫秒）\n * @returns 剩余时间（秒）\n */\nexport function estimateRemainingTime(\n  processed: number,\n  total: number,\n  elapsedMs: number\n): number {\n  if (processed === 0) return 0;\n  const avgTimePerRow = elapsedMs / processed;\n  const remainingRows = total - processed;\n  return Math.round((remainingRows * avgTimePerRow) / 1000);\n}\n\n"]}

package/dist/universalExport/server/index.mjs

@@ -0,0 +1,242 @@
+import '../../chunk-BJTO5JO5.mjs';
+
+// src/universalExport/server/factory.ts
+function createExportServiceConfig(options = {}) {
+  return {
+    db: options.db,
+    exportDir: options.exportDir || process.env.EXPORT_DIR || "./exports",
+    tempDir: options.tempDir || process.env.TEMP_DIR || "./temp",
+    maxRows: options.maxRows || 1e5,
+    // 默认最多导出 10 万行
+    enableStreaming: options.enableStreaming !== false,
+    // 默认启用流式导出
+    timeout: options.timeout || 3e5
+    // 默认超时 5 分钟
+  };
+}
+function createUniversalExportService(options = {}) {
+  const config = createExportServiceConfig(options);
+  console.warn(
+    "\u26A0\uFE0F  UniversalExportService \u7684\u5B8C\u6574\u5B9E\u73B0\u5C06\u5728\u540E\u7EED Phase \u4E2D\u8FC1\u79FB\u5230 Sa2kit\u3002\n    \u5F53\u524D\u7248\u672C\u4EC5\u5305\u542B\u7C7B\u578B\u5B9A\u4E49\u548C\u914D\u7F6E\u5DE5\u5382\u51FD\u6570\u3002\n    \u8BF7\u6682\u65F6\u7EE7\u7EED\u4ECE LyricNote \u7684 lib/universalExport \u5BFC\u5165\u670D\u52A1\u7C7B\u3002"
+  );
+  return {
+    config,
+    // 占位方法
+    async export() {
+      throw new Error("UniversalExportService \u5C1A\u672A\u5B8C\u5168\u8FC1\u79FB\uFF0C\u8BF7\u4ECE LyricNote \u5BFC\u5165");
+    },
+    async createTask() {
+      throw new Error("UniversalExportService \u5C1A\u672A\u5B8C\u5168\u8FC1\u79FB\uFF0C\u8BF7\u4ECE LyricNote \u5BFC\u5165");
+    }
+  };
+}
+function createExportServiceFromEnv(db) {
+  return createUniversalExportService({
+    db,
+    exportDir: process.env.EXPORT_DIR,
+    tempDir: process.env.TEMP_DIR,
+    maxRows: process.env.EXPORT_MAX_ROWS ? parseInt(process.env.EXPORT_MAX_ROWS) : void 0
+  });
+}
+
+// src/universalExport/server/presets.ts
+function createSmallAppPreset() {
+  return {
+    maxRows: 1e4,
+    // 1万行
+    timeout: 6e4,
+    // 1分钟
+    enableStreaming: false
+    // 小数据量不需要流式导出
+  };
+}
+function createMediumAppPreset() {
+  return {
+    maxRows: 1e5,
+    // 10万行
+    timeout: 3e5,
+    // 5分钟
+    enableStreaming: true
+  };
+}
+function createLargeAppPreset() {
+  return {
+    maxRows: 1e6,
+    // 100万行
+    timeout: 6e5,
+    // 10分钟
+    enableStreaming: true
+  };
+}
+function createRealtimeExportPreset() {
+  return {
+    maxRows: 5e3,
+    // 5千行
+    timeout: 3e4,
+    // 30秒
+    enableStreaming: false
+  };
+}
+function createBatchExportPreset() {
+  return {
+    maxRows: Number.MAX_SAFE_INTEGER,
+    // 不限制
+    timeout: 18e5,
+    // 30分钟
+    enableStreaming: true
+  };
+}
+function createSmartExportPreset() {
+  const envMaxRows = process.env.EXPORT_MAX_ROWS;
+  if (envMaxRows) {
+    const maxRows = parseInt(envMaxRows);
+    if (maxRows <= 1e4) {
+      return createSmallAppPreset();
+    } else if (maxRows <= 1e5) {
+      return createMediumAppPreset();
+    } else {
+      return createLargeAppPreset();
+    }
+  }
+  return createMediumAppPreset();
+}
+
+// src/universalExport/server/validation.ts
+var ConfigValidationError = class extends Error {
+  constructor(message, field) {
+    super(message);
+    this.field = field;
+    this.name = "ConfigValidationError";
+  }
+};
+function validateExportConfig(config) {
+  if (!config.exportDir) {
+    throw new ConfigValidationError("exportDir is required", "exportDir");
+  }
+  if (!config.tempDir) {
+    throw new ConfigValidationError("tempDir is required", "tempDir");
+  }
+  if (config.maxRows && config.maxRows <= 0) {
+    throw new ConfigValidationError(
+      "maxRows must be greater than 0",
+      "maxRows"
+    );
+  }
+  if (config.timeout && config.timeout <= 0) {
+    throw new ConfigValidationError(
+      "timeout must be greater than 0",
+      "timeout"
+    );
+  }
+  if (config.maxRows && config.maxRows > 1e6) {
+    console.warn(
+      `\u26A0\uFE0F  Warning: maxRows (${config.maxRows}) is very large. Consider using pagination or streaming for better performance.`
+    );
+  }
+}
+function validateEnvironment(requiredVars) {
+  const missing = [];
+  for (const varName of requiredVars) {
+    if (!process.env[varName]) {
+      missing.push(varName);
+    }
+  }
+  if (missing.length > 0) {
+    throw new ConfigValidationError(
+      `Missing required environment variables: ${missing.join(", ")}`,
+      "environment"
+    );
+  }
+}
+
+// src/universalExport/server/utils/index.ts
+function formatFieldValue(value, field) {
+  if (field.formatter) {
+    return field.formatter(value);
+  }
+  if (value === null || value === void 0) {
+    return "";
+  }
+  switch (field.type) {
+    case "date":
+      return value instanceof Date ? value.toISOString().split("T")[0] || "" : String(value);
+    case "boolean":
+      return value ? "\u662F" : "\u5426";
+    case "array":
+      return Array.isArray(value) ? value.join(", ") : String(value);
+    case "object":
+      return typeof value === "object" ? JSON.stringify(value) : String(value);
+    case "number":
+      return typeof value === "number" ? value.toLocaleString() : String(value);
+    default:
+      return String(value);
+  }
+}
+function validateFieldValue(value, field) {
+  if (field.required && (value === null || value === void 0 || value === "")) {
+    return false;
+  }
+  switch (field.type) {
+    case "number":
+      return typeof value === "number" || !isNaN(Number(value));
+    case "boolean":
+      return typeof value === "boolean";
+    case "array":
+      return Array.isArray(value);
+    case "object":
+      return typeof value === "object";
+    case "date":
+      return value instanceof Date || !isNaN(Date.parse(value));
+    default:
+      return true;
+  }
+}
+function convertFieldType(value, targetType) {
+  if (value === null || value === void 0) {
+    return value;
+  }
+  switch (targetType) {
+    case "string":
+      return String(value);
+    case "number":
+      return Number(value);
+    case "boolean":
+      return Boolean(value);
+    case "date":
+      return value instanceof Date ? value : new Date(value);
+    case "array":
+      return Array.isArray(value) ? value : [value];
+    case "object":
+      return typeof value === "object" ? value : { value };
+    default:
+      return value;
+  }
+}
+function getNestedValue(obj, path) {
+  return path.split(".").reduce((current, key) => current?.[key], obj);
+}
+function escapeCsvValue(value) {
+  if (value.includes(",") || value.includes('"') || value.includes("\n")) {
+    return `"${value.replace(/"/g, '""')}"`;
+  }
+  return value;
+}
+function generateUniqueFilename(prefix, extension) {
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, -5);
+  const random = Math.random().toString(36).substring(2, 8);
+  return `${prefix}_${timestamp}_${random}.${extension}`;
+}
+function calculateProgress(processed, total) {
+  if (total === 0) return 0;
+  return Math.min(Math.round(processed / total * 100), 100);
+}
+function estimateRemainingTime(processed, total, elapsedMs) {
+  if (processed === 0) return 0;
+  const avgTimePerRow = elapsedMs / processed;
+  const remainingRows = total - processed;
+  return Math.round(remainingRows * avgTimePerRow / 1e3);
+}
+
+export { ConfigValidationError as ExportConfigValidationError, calculateProgress, convertFieldType, createBatchExportPreset, createExportServiceConfig, createExportServiceFromEnv, createLargeAppPreset, createMediumAppPreset, createRealtimeExportPreset, createSmallAppPreset, createSmartExportPreset, createUniversalExportService, escapeCsvValue, estimateRemainingTime, formatFieldValue, generateUniqueFilename, getNestedValue, validateExportConfig, validateEnvironment as validateExportEnvironment, validateFieldValue };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/universalExport/server/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/universalExport/server/factory.ts","../../../src/universalExport/server/presets.ts","../../../src/universalExport/server/validation.ts","../../../src/universalExport/server/utils/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * UniversalExport Service 工厂函数\n * 提供简化的服务初始化方式\n */\n\nimport type { UniversalExportServiceConfig } from './types';\n\n/**\n * 创建导出服务配置（带智能默认值）\n */\nexport function createExportServiceConfig(\n  options: Partial<UniversalExportServiceConfig> = {}\n): UniversalExportServiceConfig {\n  return {\n    db: options.db,\n    exportDir: options.exportDir || process.env.EXPORT_DIR || './exports',\n    tempDir: options.tempDir || process.env.TEMP_DIR || './temp',\n    maxRows: options.maxRows || 100000, // 默认最多导出 10 万行\n    enableStreaming: options.enableStreaming !== false, // 默认启用流式导出\n    timeout: options.timeout || 300000, // 默认超时 5 分钟\n  };\n}\n\n/**\n * 创建导出服务实例（简化版）\n *\n * @example\n * ```typescript\n * // 最简配置\n * const service = createUniversalExportService();\n *\n * // 标准配置\n * const service = createUniversalExportService({\n *   db: drizzleDb,\n *   exportDir: './exports',\n *   maxRows: 50000,\n * });\n * ```\n */\nexport function createUniversalExportService(\n  options: Partial<UniversalExportServiceConfig> = {}\n) {\n  const config = createExportServiceConfig(options);\n\n  // 注意：实际的 UniversalExportService 将在后续 Phase 中迁移\n  // 这里先返回一个占位对象，包含基本的类型信息\n  console.warn(\n    '⚠️  UniversalExportService 的完整实现将在后续 Phase 中迁移到 Sa2kit。\\n' +\n    '    当前版本仅包含类型定义和配置工厂函数。\\n' +\n    '    请暂时继续从 LyricNote 的 lib/universalExport 导入服务类。'\n  );\n\n  return {\n    config,\n    // 占位方法\n    async export() {\n      throw new Error('UniversalExportService 尚未完全迁移，请从 LyricNote 导入');\n    },\n    async createTask() {\n      throw new Error('UniversalExportService 尚未完全迁移，请从 LyricNote 导入');\n    },\n  };\n}\n\n/**\n * 从环境变量创建配置（便利函数）\n *\n * @example\n * ```typescript\n * // .env\n * // EXPORT_DIR=./exports\n * // EXPORT_MAX_ROWS=50000\n *\n * const service = createExportServiceFromEnv();\n * ```\n */\nexport function createExportServiceFromEnv(db?: any) {\n  return createUniversalExportService({\n    db,\n    exportDir: process.env.EXPORT_DIR,\n    tempDir: process.env.TEMP_DIR,\n    maxRows: process.env.EXPORT_MAX_ROWS\n      ? parseInt(process.env.EXPORT_MAX_ROWS)\n      : undefined,\n  });\n}\n\n","/**\n * UniversalExport 预设配置\n * 提供常见场景的开箱即用配置\n */\n\nimport type { UniversalExportServiceConfig } from './types';\n\n/**\n * 小型应用预设（数据量小）\n */\nexport function createSmallAppPreset(): Partial<UniversalExportServiceConfig> {\n  return {\n    maxRows: 10000, // 1万行\n    timeout: 60000, // 1分钟\n    enableStreaming: false, // 小数据量不需要流式导出\n  };\n}\n\n/**\n * 中型应用预设（默认配置）\n */\nexport function createMediumAppPreset(): Partial<UniversalExportServiceConfig> {\n  return {\n    maxRows: 100000, // 10万行\n    timeout: 300000, // 5分钟\n    enableStreaming: true,\n  };\n}\n\n/**\n * 大型应用预设（数据量大）\n */\nexport function createLargeAppPreset(): Partial<UniversalExportServiceConfig> {\n  return {\n    maxRows: 1000000, // 100万行\n    timeout: 600000, // 10分钟\n    enableStreaming: true,\n  };\n}\n\n/**\n * 实时导出预设（快速响应）\n */\nexport function createRealtimeExportPreset(): Partial<UniversalExportServiceConfig> {\n  return {\n    maxRows: 5000, // 5千行\n    timeout: 30000, // 30秒\n    enableStreaming: false,\n  };\n}\n\n/**\n * 批量导出预设（大批量、离线处理）\n */\nexport function createBatchExportPreset(): Partial<UniversalExportServiceConfig> {\n  return {\n    maxRows: Number.MAX_SAFE_INTEGER, // 不限制\n    timeout: 1800000, // 30分钟\n    enableStreaming: true,\n  };\n}\n\n/**\n * 智能预设：根据环境自动选择\n */\nexport function createSmartExportPreset(): Partial<UniversalExportServiceConfig> {\n  const envMaxRows = process.env.EXPORT_MAX_ROWS;\n\n  if (envMaxRows) {\n    const maxRows = parseInt(envMaxRows);\n\n    // 根据配置的最大行数自动选择合适的预设\n    if (maxRows <= 10000) {\n      return createSmallAppPreset();\n    } else if (maxRows <= 100000) {\n      return createMediumAppPreset();\n    } else {\n      return createLargeAppPreset();\n    }\n  }\n\n  // 默认使用中型应用预设\n  return createMediumAppPreset();\n}\n\n","/**\n * UniversalExport 配置验证\n */\n\nimport type { UniversalExportServiceConfig } from './types';\n\nexport class ConfigValidationError extends Error {\n  constructor(message: string, public field: string) {\n    super(message);\n    this.name = 'ConfigValidationError';\n  }\n}\n\n/**\n * 验证导出服务配置\n */\nexport function validateExportConfig(config: UniversalExportServiceConfig): void {\n  // 验证导出目录\n  if (!config.exportDir) {\n    throw new ConfigValidationError('exportDir is required', 'exportDir');\n  }\n\n  // 验证临时目录\n  if (!config.tempDir) {\n    throw new ConfigValidationError('tempDir is required', 'tempDir');\n  }\n\n  // 验证最大行数\n  if (config.maxRows && config.maxRows <= 0) {\n    throw new ConfigValidationError(\n      'maxRows must be greater than 0',\n      'maxRows'\n    );\n  }\n\n  // 验证超时时间\n  if (config.timeout && config.timeout <= 0) {\n    throw new ConfigValidationError(\n      'timeout must be greater than 0',\n      'timeout'\n    );\n  }\n\n  // 安全建议\n  if (config.maxRows && config.maxRows > 1000000) {\n    console.warn(\n      `⚠️  Warning: maxRows (${config.maxRows}) is very large. ` +\n      `Consider using pagination or streaming for better performance.`\n    );\n  }\n}\n\n/**\n * 验证环境变量\n */\nexport function validateEnvironment(requiredVars: string[]): void {\n  const missing: string[] = [];\n\n  for (const varName of requiredVars) {\n    if (!process.env[varName]) {\n      missing.push(varName);\n    }\n  }\n\n  if (missing.length > 0) {\n    throw new ConfigValidationError(\n      `Missing required environment variables: ${missing.join(', ')}`,\n      'environment'\n    );\n  }\n}\n\n","/**\n * UniversalExport Server 工具函数\n */\n\nimport type { ExportField, FieldType } from '../../types';\n\n/**\n * 格式化字段值\n *\n * @param value 原始值\n * @param field 字段定义\n * @returns 格式化后的值\n */\nexport function formatFieldValue(value: any, field: ExportField): string {\n  // 如果字段有自定义格式化函数，使用它\n  if (field.formatter) {\n    return field.formatter(value);\n  }\n\n  // 空值处理\n  if (value === null || value === undefined) {\n    return '';\n  }\n\n  // 根据字段类型进行默认格式化\n  switch (field.type) {\n    case 'date':\n      return value instanceof Date\n        ? (value.toISOString().split('T')[0] || '')\n        : String(value);\n\n    case 'boolean':\n      return value ? '是' : '否';\n\n    case 'array':\n      return Array.isArray(value) ? value.join(', ') : String(value);\n\n    case 'object':\n      return typeof value === 'object'\n        ? JSON.stringify(value)\n        : String(value);\n\n    case 'number':\n      return typeof value === 'number'\n        ? value.toLocaleString()\n        : String(value);\n\n    default:\n      return String(value);\n  }\n}\n\n/**\n * 验证字段值\n *\n * @param value 字段值\n * @param field 字段定义\n * @returns 是否有效\n */\nexport function validateFieldValue(value: any, field: ExportField): boolean {\n  // 必填字段检查\n  if (field.required && (value === null || value === undefined || value === '')) {\n    return false;\n  }\n\n  // 类型检查\n  switch (field.type) {\n    case 'number':\n      return typeof value === 'number' || !isNaN(Number(value));\n\n    case 'boolean':\n      return typeof value === 'boolean';\n\n    case 'array':\n      return Array.isArray(value);\n\n    case 'object':\n      return typeof value === 'object';\n\n    case 'date':\n      return value instanceof Date || !isNaN(Date.parse(value));\n\n    default:\n      return true;\n  }\n}\n\n/**\n * 转换字段类型\n *\n * @param value 原始值\n * @param targetType 目标类型\n * @returns 转换后的值\n */\nexport function convertFieldType(value: any, targetType: FieldType): any {\n  if (value === null || value === undefined) {\n    return value;\n  }\n\n  switch (targetType) {\n    case 'string':\n      return String(value);\n\n    case 'number':\n      return Number(value);\n\n    case 'boolean':\n      return Boolean(value);\n\n    case 'date':\n      return value instanceof Date ? value : new Date(value);\n\n    case 'array':\n      return Array.isArray(value) ? value : [value];\n\n    case 'object':\n      return typeof value === 'object' ? value : { value };\n\n    default:\n      return value;\n  }\n}\n\n/**\n * 安全获取嵌套属性值\n *\n * @param obj 对象\n * @param path 属性路径（支持点号分隔）\n * @returns 属性值\n *\n * @example\n * ```typescript\n * const obj = { user: { name: 'John', age: 30 } };\n * getNestedValue(obj, 'user.name')  // 'John'\n * getNestedValue(obj, 'user.email') // undefined\n * ```\n */\nexport function getNestedValue(obj: any, path: string): any {\n  return path.split('.').reduce((current, key) => current?.[key], obj);\n}\n\n/**\n * 转义 CSV 字段值\n *\n * @param value 字段值\n * @returns 转义后的值\n */\nexport function escapeCsvValue(value: string): string {\n  // 如果包含逗号、引号或换行符，需要用引号包裹并转义引号\n  if (value.includes(',') || value.includes('\"') || value.includes('\\n')) {\n    return `\"${value.replace(/\"/g, '\"\"')}\"`;\n  }\n  return value;\n}\n\n/**\n * 生成唯一的文件名\n *\n * @param prefix 前缀\n * @param extension 扩展名\n * @returns 唯一文件名\n *\n * @example\n * ```typescript\n * generateUniqueFilename('export', 'xlsx')\n * // 'export_20231111_123456_abc123.xlsx'\n * ```\n */\nexport function generateUniqueFilename(prefix: string, extension: string): string {\n  const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, -5);\n  const random = Math.random().toString(36).substring(2, 8);\n  return `${prefix}_${timestamp}_${random}.${extension}`;\n}\n\n/**\n * 计算导出进度百分比\n *\n * @param processed 已处理行数\n * @param total 总行数\n * @returns 百分比（0-100）\n */\nexport function calculateProgress(processed: number, total: number): number {\n  if (total === 0) return 0;\n  return Math.min(Math.round((processed / total) * 100), 100);\n}\n\n/**\n * 估算剩余时间（秒）\n *\n * @param processed 已处理行数\n * @param total 总行数\n * @param elapsedMs 已用时间（毫秒）\n * @returns 剩余时间（秒）\n */\nexport function estimateRemainingTime(\n  processed: number,\n  total: number,\n  elapsedMs: number\n): number {\n  if (processed === 0) return 0;\n  const avgTimePerRow = elapsedMs / processed;\n  const remainingRows = total - processed;\n  return Math.round((remainingRows * avgTimePerRow) / 1000);\n}\n\n"]}

package/dist/universalFile/index.d.mts

@@ -0,0 +1,310 @@
+import { U as UploadFileInfo, a as UploadProgress, F as FileMetadata, b as FileQueryOptions, P as PaginatedResult, B as BatchOperationResult } from '../types-CoGG1rNV.mjs';
+export { A as AccessPermission, k as AudioProcessingOptions, C as CDNProviderError, g as CDNType, n as FileEvent, o as FileEventListener, m as FileEventType, e as FileProcessingError, c as FileServiceError, d as FileUploadError, I as ImageProcessingOptions, j as ProcessingOptions, h as ProcessorType, S as StorageProviderError, f as StorageType, l as UploadResult, i as UploadStatus, V as VideoProcessingOptions } from '../types-CoGG1rNV.mjs';
+
+/**
+ * 通用文件服务客户端SDK
+ *
+ * 提供文件上传、下载、查询等功能的客户端接口
+ */
+
+interface UniversalFileClientConfig {
+    /** API基础URL */
+    baseUrl?: string;
+    /** 请求超时时间(毫秒) */
+    timeout?: number;
+    /** 上传超时时间(毫秒) */
+    uploadTimeout?: number;
+    /** 自定义请求头 */
+    headers?: Record<string, string>;
+}
+/**
+ * 通用文件服务客户端
+ */
+declare class UniversalFileClient {
+    private config;
+    constructor(config?: UniversalFileClientConfig);
+    /**
+     * 上传文件
+     */
+    uploadFile(fileInfo: UploadFileInfo, onProgress?: (progress: UploadProgress) => void): Promise<FileMetadata>;
+    /**
+     * 获取文件访问URL
+     */
+    getFileUrl(fileId: string, expiresIn?: number): Promise<string>;
+    /**
+     * 获取文件元数据
+     */
+    getFileMetadata(fileId: string): Promise<FileMetadata>;
+    /**
+     * 查询文件列表
+     */
+    queryFiles(options: FileQueryOptions): Promise<PaginatedResult<FileMetadata>>;
+    /**
+     * 删除文件
+     */
+    deleteFile(fileId: string): Promise<void>;
+    /**
+     * 批量删除文件
+     */
+    batchDeleteFiles(fileIds: string[]): Promise<BatchOperationResult>;
+    /**
+     * 获取上传进度
+     */
+    getUploadProgress(fileId: string): Promise<UploadProgress>;
+    /**
+     * 获取请求头
+     */
+    private getHeaders;
+    /**
+     * 带超时的fetch请求
+     */
+    private fetchWithTimeout;
+    /**
+     * 转换API返回的文件元数据
+     */
+    private transformFileMetadataFromAPI;
+}
+/**
+ * 默认客户端实例
+ */
+declare const universalFileClient: UniversalFileClient;
+/**
+ * 创建自定义客户端实例
+ */
+declare function createFileClient(config?: UniversalFileClientConfig): UniversalFileClient;
+
+/**
+ * 通用文件服务常量定义
+ */
+/** 模块版本 */
+declare const UNIVERSAL_FILE_VERSION = "1.0.0";
+/** 模块名称 */
+declare const UNIVERSAL_FILE_NAME = "@qhr123/sa2kit/universalFile";
+/** 默认最大文件大小(字节) - 100MB */
+declare const DEFAULT_MAX_FILE_SIZE: number;
+/** 默认最大图片大小(字节) - 10MB */
+declare const DEFAULT_MAX_IMAGE_SIZE: number;
+/** 默认最大视频大小(字节) - 500MB */
+declare const DEFAULT_MAX_VIDEO_SIZE: number;
+/** 默认最大音频大小(字节) - 50MB */
+declare const DEFAULT_MAX_AUDIO_SIZE: number;
+/** 默认最大文档大小(字节) - 20MB */
+declare const DEFAULT_MAX_DOCUMENT_SIZE: number;
+/** 图片MIME类型 */
+declare const IMAGE_MIME_TYPES: string[];
+/** 视频MIME类型 */
+declare const VIDEO_MIME_TYPES: string[];
+/** 音频MIME类型 */
+declare const AUDIO_MIME_TYPES: string[];
+/** 文档MIME类型 */
+declare const DOCUMENT_MIME_TYPES: string[];
+/** 所有支持的MIME类型 */
+declare const ALL_SUPPORTED_MIME_TYPES: string[];
+/** 图片扩展名 */
+declare const IMAGE_EXTENSIONS: string[];
+/** 视频扩展名 */
+declare const VIDEO_EXTENSIONS: string[];
+/** 音频扩展名 */
+declare const AUDIO_EXTENSIONS: string[];
+/** 文档扩展名 */
+declare const DOCUMENT_EXTENSIONS: string[];
+/** API基础路径 */
+declare const API_BASE_PATH = "/api/universal-file";
+/** API端点 */
+declare const API_ENDPOINTS: {
+    /** 上传文件 */
+    readonly UPLOAD: "/api/universal-file/upload";
+    /** 获取文件URL */
+    readonly GET_URL: (fileId: string) => string;
+    /** 获取文件元数据 */
+    readonly GET_METADATA: (fileId: string) => string;
+    /** 删除文件 */
+    readonly DELETE: (fileId: string) => string;
+    /** 查询文件列表 */
+    readonly QUERY: "/api/universal-file/files";
+    /** 批量删除 */
+    readonly BATCH_DELETE: "/api/universal-file/files/batch-delete";
+    /** 获取上传进度 */
+    readonly GET_PROGRESS: (fileId: string) => string;
+};
+/** 错误代码 */
+declare const ERROR_CODES: {
+    /** 文件上传错误 */
+    readonly FILE_UPLOAD_ERROR: "FILE_UPLOAD_ERROR";
+    /** 文件大小超限 */
+    readonly FILE_SIZE_EXCEEDED: "FILE_SIZE_EXCEEDED";
+    /** 文件类型不支持 */
+    readonly FILE_TYPE_NOT_SUPPORTED: "FILE_TYPE_NOT_SUPPORTED";
+    /** 文件不存在 */
+    readonly FILE_NOT_FOUND: "FILE_NOT_FOUND";
+    /** 文件处理错误 */
+    readonly FILE_PROCESSING_ERROR: "FILE_PROCESSING_ERROR";
+    /** 存储提供者错误 */
+    readonly STORAGE_PROVIDER_ERROR: "STORAGE_PROVIDER_ERROR";
+    /** CDN提供者错误 */
+    readonly CDN_PROVIDER_ERROR: "CDN_PROVIDER_ERROR";
+    /** 网络错误 */
+    readonly NETWORK_ERROR: "NETWORK_ERROR";
+    /** 超时错误 */
+    readonly TIMEOUT_ERROR: "TIMEOUT_ERROR";
+    /** 未授权 */
+    readonly UNAUTHORIZED: "UNAUTHORIZED";
+    /** 权限不足 */
+    readonly FORBIDDEN: "FORBIDDEN";
+    /** 服务器错误 */
+    readonly SERVER_ERROR: "SERVER_ERROR";
+};
+/** 默认分页大小 */
+declare const DEFAULT_PAGE_SIZE = 20;
+/** 默认请求超时时间(毫秒) - 30秒 */
+declare const DEFAULT_REQUEST_TIMEOUT = 30000;
+/** 默认上传超时时间(毫秒) - 5分钟 */
+declare const DEFAULT_UPLOAD_TIMEOUT = 300000;
+/** 默认分片上传大小(字节) - 5MB */
+declare const DEFAULT_CHUNK_SIZE: number;
+
+/**
+ * 通用文件服务工具函数
+ */
+/**
+ * 格式化文件大小
+ */
+declare function formatFileSize(bytes: number): string;
+/**
+ * 解析文件大小字符串
+ */
+declare function parseFileSize(sizeStr: string): number;
+/**
+ * 获取文件扩展名
+ */
+declare function getFileExtension(fileName: string): string;
+/**
+ * 根据文件名获取MIME类型
+ */
+declare function getMimeTypeFromFileName(fileName: string): string;
+/**
+ * 检查MIME类型是否支持
+ */
+declare function isMimeTypeSupported(mimeType: string, allowedTypes?: string[]): boolean;
+/**
+ * 判断是否为图片类型
+ */
+declare function isImageFile(mimeType: string): boolean;
+/**
+ * 判断是否为视频类型
+ */
+declare function isVideoFile(mimeType: string): boolean;
+/**
+ * 判断是否为音频类型
+ */
+declare function isAudioFile(mimeType: string): boolean;
+/**
+ * 判断是否为文档类型
+ */
+declare function isDocumentFile(mimeType: string): boolean;
+/**
+ * 获取文件类型类别
+ */
+declare function getFileCategory(mimeType: string): 'image' | 'video' | 'audio' | 'document' | 'other';
+/**
+ * 验证文件名是否合法
+ */
+declare function validateFileName(fileName: string): boolean;
+/**
+ * 清理文件名，移除非法字符
+ */
+declare function sanitizeFileName(fileName: string): string;
+/**
+ * 生成唯一文件名
+ */
+declare function generateUniqueFileName(originalName: string, fileId: string): string;
+/**
+ * 生成存储路径
+ */
+declare function generateStoragePath(moduleId: string, fileName: string, options?: {
+    businessId?: string;
+    useDate?: boolean;
+    customPrefix?: string;
+}): string;
+/**
+ * 解析存储路径
+ */
+declare function parseStoragePath(path: string): {
+    moduleId?: string;
+    businessId?: string;
+    year?: string;
+    month?: string;
+    day?: string;
+    fileName: string;
+};
+/**
+ * 验证文件大小
+ */
+declare function validateFileSize(file: File, maxSize: number): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * 验证文件类型
+ */
+declare function validateFileType(file: File, allowedTypes?: string[]): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * 验证文件
+ */
+declare function validateFile(file: File, options?: {
+    maxSize?: number;
+    allowedTypes?: string[];
+}): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * 构建查询字符串
+ */
+declare function buildQueryString(params: Record<string, any>): string;
+/**
+ * 解析URL查询参数
+ */
+declare function parseQueryString(url: string): Record<string, string>;
+/**
+ * 计算上传进度
+ */
+declare function calculateProgress(uploadedBytes: number, totalBytes: number): number;
+/**
+ * 计算上传速度
+ */
+declare function calculateSpeed(uploadedBytes: number, elapsedTime: number): number;
+/**
+ * 计算剩余时间
+ */
+declare function calculateRemainingTime(uploadedBytes: number, totalBytes: number, speed: number): number;
+/**
+ * 创建文件错误对象
+ */
+declare function createFileError(code: string, message: string, details?: Record<string, any>): {
+    code: string;
+    message: string;
+    details?: Record<string, any>;
+    timestamp: Date;
+};
+/**
+ * 格式化错误消息
+ */
+declare function formatErrorMessage(error: unknown): string;
+/**
+ * 读取文件为Base64
+ */
+declare function readFileAsBase64(file: File): Promise<string>;
+/**
+ * 读取文件为ArrayBuffer
+ */
+declare function readFileAsArrayBuffer(file: File): Promise<ArrayBuffer>;
+/**
+ * 读取文件为文本
+ */
+declare function readFileAsText(file: File, encoding?: string): Promise<string>;
+
+export { ALL_SUPPORTED_MIME_TYPES, API_BASE_PATH, API_ENDPOINTS, AUDIO_EXTENSIONS, AUDIO_MIME_TYPES, BatchOperationResult, DEFAULT_CHUNK_SIZE, DEFAULT_MAX_AUDIO_SIZE, DEFAULT_MAX_DOCUMENT_SIZE, DEFAULT_MAX_FILE_SIZE, DEFAULT_MAX_IMAGE_SIZE, DEFAULT_MAX_VIDEO_SIZE, DEFAULT_PAGE_SIZE, DEFAULT_REQUEST_TIMEOUT, DEFAULT_UPLOAD_TIMEOUT, DOCUMENT_EXTENSIONS, DOCUMENT_MIME_TYPES, ERROR_CODES, FileMetadata, FileQueryOptions, IMAGE_EXTENSIONS, IMAGE_MIME_TYPES, PaginatedResult, UNIVERSAL_FILE_NAME, UNIVERSAL_FILE_VERSION, UniversalFileClient, type UniversalFileClientConfig, UploadFileInfo, UploadProgress, VIDEO_EXTENSIONS, VIDEO_MIME_TYPES, buildQueryString, calculateProgress, calculateRemainingTime, calculateSpeed, createFileClient, createFileError, formatErrorMessage, formatFileSize, generateStoragePath, generateUniqueFileName, getFileCategory, getFileExtension, getMimeTypeFromFileName, isAudioFile, isDocumentFile, isImageFile, isMimeTypeSupported, isVideoFile, parseFileSize, parseQueryString, parseStoragePath, readFileAsArrayBuffer, readFileAsBase64, readFileAsText, sanitizeFileName, universalFileClient, validateFile, validateFileName, validateFileSize, validateFileType };