sa2kit 3.0.0 → 3.2.0

package/dist/chunk-QIF4MG5V.mjs

@@ -0,0 +1,283 @@
+// src/common/universalExport/types.ts
+var ExportServiceError = class extends Error {
+  constructor(message, code, details) {
+    super(message);
+    this.code = code;
+    this.details = details;
+    this.name = "ExportServiceError";
+  }
+};
+var ExportConfigError = class extends ExportServiceError {
+  constructor(message, details) {
+    super(message, "EXPORT_CONFIG_ERROR", details);
+    this.name = "ExportConfigError";
+  }
+};
+var ExportDataError = class extends ExportServiceError {
+  constructor(message, details) {
+    super(message, "EXPORT_DATA_ERROR", details);
+    this.name = "ExportDataError";
+  }
+};
+var ExportFileError = class extends ExportServiceError {
+  constructor(message, details) {
+    super(message, "EXPORT_FILE_ERROR", details);
+    this.name = "ExportFileError";
+  }
+};
+
+// src/common/universalExport/constants.ts
+var UNIVERSAL_EXPORT_VERSION = "1.0.0";
+var UNIVERSAL_EXPORT_NAME = "@lyricnote/universal-export";
+var DEFAULT_EXPORT_FORMAT = "csv";
+var DEFAULT_CSV_DELIMITER = ",";
+var DEFAULT_ENCODING = "utf-8";
+var DEFAULT_ADD_BOM = true;
+var DEFAULT_MAX_FILE_SIZE = 100 * 1024 * 1024;
+var DEFAULT_MAX_ROWS = 1e5;
+var DEFAULT_MAX_CONCURRENT_EXPORTS = 5;
+var DEFAULT_EXPORT_TIMEOUT = 3e5;
+var DEFAULT_CONFIG_CACHE_TTL = 3600;
+var DEFAULT_RESULT_CACHE_TTL = 1800;
+var EXPORT_FORMAT_EXTENSIONS = {
+  csv: "csv",
+  excel: "xlsx",
+  json: "json"
+};
+var EXPORT_FORMAT_MIME_TYPES = {
+  csv: "text/csv; charset=utf-8",
+  excel: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+  json: "application/json; charset=utf-8"
+};
+var API_BASE_PATH = "/api/universal-export";
+var API_ENDPOINTS = {
+  /** 获取配置列表 */
+  GET_CONFIGS: API_BASE_PATH + "/configs",
+  /** 创建配置 */
+  CREATE_CONFIG: API_BASE_PATH + "/configs",
+  /** 更新配置 */
+  UPDATE_CONFIG: (configId) => API_BASE_PATH + "/configs/" + configId,
+  /** 删除配置 */
+  DELETE_CONFIG: (configId) => API_BASE_PATH + "/configs/" + configId,
+  /** 触发导出 */
+  EXPORT_DATA: API_BASE_PATH + "/export",
+  /** 查询导出进度 */
+  GET_PROGRESS: (exportId) => API_BASE_PATH + "/export/" + exportId + "/progress",
+  /** 下载导出文件 */
+  DOWNLOAD_FILE: (exportId) => API_BASE_PATH + "/export/" + exportId + "/download"
+};
+var ERROR_CODES = {
+  /** 导出配置错误 */
+  EXPORT_CONFIG_ERROR: "EXPORT_CONFIG_ERROR",
+  /** 导出数据错误 */
+  EXPORT_DATA_ERROR: "EXPORT_DATA_ERROR",
+  /** 导出文件错误 */
+  EXPORT_FILE_ERROR: "EXPORT_FILE_ERROR",
+  /** 网络错误 */
+  NETWORK_ERROR: "NETWORK_ERROR",
+  /** 超时错误 */
+  TIMEOUT_ERROR: "TIMEOUT_ERROR",
+  /** 未授权 */
+  UNAUTHORIZED: "UNAUTHORIZED",
+  /** 服务器错误 */
+  SERVER_ERROR: "SERVER_ERROR"
+};
+
+// src/common/universalExport/utils.ts
+function generateExportFileName(template, format) {
+  const now = /* @__PURE__ */ new Date();
+  const dateStr = now.toISOString().split("T")[0] || "";
+  const timeStr = (now.toTimeString().split(" ")[0] || "").replace(/:/g, "-");
+  const extension = EXPORT_FORMAT_EXTENSIONS[format];
+  return template.replace("{date}", dateStr).replace("{time}", timeStr).replace("{timestamp}", now.getTime().toString()) + "." + extension;
+}
+function validateFileName(fileName) {
+  const invalidChars = /[<>:"|?*\/\\]/;
+  if (invalidChars.test(fileName)) {
+    return false;
+  }
+  if (fileName.length === 0 || fileName.length > 255) {
+    return false;
+  }
+  return true;
+}
+function sanitizeFileName(fileName) {
+  return fileName.replace(/[<>:"|?*\/\\]/g, "_").substring(0, 255);
+}
+function escapeCSVField(value, delimiter = ",") {
+  const valueStr = String(value || "");
+  if (valueStr.includes(delimiter) || valueStr.includes('"') || valueStr.includes("\n")) {
+    return '"' + valueStr.replace(/"/g, '""') + '"';
+  }
+  return valueStr;
+}
+function parseCSVField(field) {
+  if (field.startsWith('"') && field.endsWith('"')) {
+    return field.slice(1, -1).replace(/""/g, '"');
+  }
+  return field;
+}
+var DEFAULT_FORMATTERS = {
+  // 日期格式化
+  date: (value) => {
+    if (!value) return "";
+    const date = new Date(value);
+    if (isNaN(date.getTime())) return String(value);
+    return date.toISOString().split("T")[0] || "";
+  },
+  // 时间格式化
+  datetime: (value) => {
+    if (!value) return "";
+    const date = new Date(value);
+    if (isNaN(date.getTime())) return String(value);
+    return date.toLocaleString("zh-CN");
+  },
+  // 数字格式化
+  number: (value) => {
+    if (value === null || value === void 0) return "";
+    return String(value);
+  },
+  // 货币格式化
+  currency: (value) => {
+    if (value === null || value === void 0) return "";
+    return "\xA5" + Number(value).toFixed(2);
+  },
+  // 百分比格式化
+  percentage: (value) => {
+    if (value === null || value === void 0) return "";
+    return (Number(value) * 100).toFixed(2) + "%";
+  },
+  // 布尔值格式化
+  boolean: (value) => {
+    if (value === null || value === void 0) return "";
+    return value ? "\u662F" : "\u5426";
+  },
+  // 数组格式化
+  array: (value) => {
+    if (!Array.isArray(value)) return "";
+    return value.join(", ");
+  },
+  // 对象格式化
+  object: (value) => {
+    if (!value || typeof value !== "object") return "";
+    return JSON.stringify(value);
+  }
+};
+function applyFormatter(value, formatter, type) {
+  if (formatter) {
+    return formatter(value);
+  }
+  if (type && DEFAULT_FORMATTERS[type]) {
+    return DEFAULT_FORMATTERS[type](value);
+  }
+  return String(value || "");
+}
+function validateExportConfig(config) {
+  const errors = [];
+  if (!config.name || config.name.trim() === "") {
+    errors.push("\u914D\u7F6E\u540D\u79F0\u4E0D\u80FD\u4E3A\u7A7A");
+  }
+  if (!config.fields || !Array.isArray(config.fields) || config.fields.length === 0) {
+    errors.push("\u81F3\u5C11\u9700\u8981\u5B9A\u4E49\u4E00\u4E2A\u5B57\u6BB5");
+  }
+  if (config.fields) {
+    const enabledFields = config.fields.filter((f) => f.enabled);
+    if (enabledFields.length === 0) {
+      errors.push("\u81F3\u5C11\u9700\u8981\u542F\u7528\u4E00\u4E2A\u5B57\u6BB5");
+    }
+    const keys = config.fields.map((f) => f.key);
+    const uniqueKeys = new Set(keys);
+    if (keys.length !== uniqueKeys.size) {
+      errors.push("\u5B57\u6BB5\u952E\u540D\u5FC5\u987B\u552F\u4E00");
+    }
+  }
+  return {
+    valid: errors.length === 0,
+    errors
+  };
+}
+function validateExportRequest(request) {
+  const errors = [];
+  if (!request.configId) {
+    errors.push("\u5BFC\u51FA\u914D\u7F6EID\u4E0D\u80FD\u4E3A\u7A7A");
+  }
+  if (!request.dataSource) {
+    errors.push("\u6570\u636E\u6E90\u4E0D\u80FD\u4E3A\u7A7A");
+  }
+  return {
+    valid: errors.length === 0,
+    errors
+  };
+}
+function formatFileSize(bytes) {
+  if (bytes === 0) return "0 B";
+  const units = ["B", "KB", "MB", "GB", "TB"];
+  const k = 1024;
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  return (bytes / Math.pow(k, i)).toFixed(2) + " " + units[i];
+}
+function formatDuration(milliseconds) {
+  if (milliseconds < 1e3) {
+    return milliseconds + "ms";
+  }
+  const seconds = Math.floor(milliseconds / 1e3);
+  if (seconds < 60) {
+    return seconds + "\u79D2";
+  }
+  const minutes = Math.floor(seconds / 60);
+  const remainingSeconds = seconds % 60;
+  if (minutes < 60) {
+    return remainingSeconds > 0 ? minutes + "\u5206" + remainingSeconds + "\u79D2" : minutes + "\u5206\u949F";
+  }
+  const hours = Math.floor(minutes / 60);
+  const remainingMinutes = minutes % 60;
+  return remainingMinutes > 0 ? hours + "\u5C0F\u65F6" + remainingMinutes + "\u5206\u949F" : hours + "\u5C0F\u65F6";
+}
+function estimateEndTime(startTime, processedRows, totalRows) {
+  if (processedRows === 0 || totalRows === 0) {
+    return void 0;
+  }
+  const elapsed = Date.now() - startTime.getTime();
+  const avgTimePerRow = elapsed / processedRows;
+  const remainingRows = totalRows - processedRows;
+  const remainingTime = avgTimePerRow * remainingRows;
+  return new Date(Date.now() + remainingTime);
+}
+function getNestedValue(obj, path) {
+  return path.split(".").reduce((current, key) => {
+    return current && current[key] !== void 0 ? current[key] : null;
+  }, obj);
+}
+function setNestedValue(obj, path, value) {
+  const keys = path.split(".");
+  const lastKey = keys.pop();
+  if (!lastKey) return;
+  const target = keys.reduce((current, key) => {
+    if (!current[key] || typeof current[key] !== "object") {
+      current[key] = {};
+    }
+    return current[key];
+  }, obj);
+  target[lastKey] = value;
+}
+function createExportError(code, message, details) {
+  return {
+    code,
+    message,
+    details,
+    timestamp: /* @__PURE__ */ new Date()
+  };
+}
+function formatErrorMessage(error) {
+  if (error instanceof Error) {
+    return error.message;
+  }
+  if (typeof error === "string") {
+    return error;
+  }
+  return "\u672A\u77E5\u9519\u8BEF";
+}
+
+export { API_BASE_PATH, API_ENDPOINTS, DEFAULT_ADD_BOM, DEFAULT_CONFIG_CACHE_TTL, DEFAULT_CSV_DELIMITER, DEFAULT_ENCODING, DEFAULT_EXPORT_FORMAT, DEFAULT_EXPORT_TIMEOUT, DEFAULT_FORMATTERS, DEFAULT_MAX_CONCURRENT_EXPORTS, DEFAULT_MAX_FILE_SIZE, DEFAULT_MAX_ROWS, DEFAULT_RESULT_CACHE_TTL, ERROR_CODES, EXPORT_FORMAT_EXTENSIONS, EXPORT_FORMAT_MIME_TYPES, ExportConfigError, ExportDataError, ExportFileError, ExportServiceError, UNIVERSAL_EXPORT_NAME, UNIVERSAL_EXPORT_VERSION, applyFormatter, createExportError, escapeCSVField, estimateEndTime, formatDuration, formatErrorMessage, formatFileSize, generateExportFileName, getNestedValue, parseCSVField, sanitizeFileName, setNestedValue, validateExportConfig, validateExportRequest, validateFileName };
+//# sourceMappingURL=chunk-QIF4MG5V.mjs.map
+//# sourceMappingURL=chunk-QIF4MG5V.mjs.map

package/dist/chunk-QIF4MG5V.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/common/universalExport/types.ts","../src/common/universalExport/constants.ts","../src/common/universalExport/utils.ts"],"names":[],"mappings":"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","file":"chunk-QIF4MG5V.mjs","sourcesContent":["/**\n * 通用导出服务类型定义\n *\n * 定义了导出功能的核心接口和类型\n */\n\n// ============= 基础类型定义 =============\n\n/** 导出格式类型 */\nexport type ExportFormat = 'csv' | 'excel' | 'json';\n\n/** 字段类型 */\nexport type FieldType = 'string' | 'number' | 'date' | 'boolean' | 'array' | 'object';\n\n/** 字段对齐方式 */\nexport type FieldAlignment = 'left' | 'center' | 'right';\n\n/** 导出状态 */\nexport type ExportStatus = 'pending' | 'processing' | 'completed' | 'failed' | 'cancelled';\n\n/** 分组模式 */\nexport type GroupingMode = 'merge' | 'separate' | 'nested';\n\n/** 分组处理类型 */\nexport type GroupValueProcessing = 'first' | 'last' | 'concat' | 'sum' | 'count' | 'custom';\n\n// ============= 字段定义接口 =============\n\n/** 导出字段定义 */\nexport interface ExportField {\n  /** 字段键名 */\n  key: string;\n  /** 字段显示名称 */\n  label: string;\n  /** 字段类型 */\n  type: FieldType;\n  /** 是否启用 */\n  enabled: boolean;\n  /** 字段宽度 */\n  width?: number;\n  /** 对齐方式 */\n  alignment?: FieldAlignment;\n  /** 格式化函数 */\n  formatter?: (value: any) => string;\n  /** 排序权重 */\n  sortOrder?: number;\n  /** 是否必填 */\n  required?: boolean;\n  /** 字段描述 */\n  description?: string;\n  /** 自定义样式 */\n  style?: Record<string, any>;\n}\n\n/** 分组字段配置 */\nexport interface GroupingField {\n  /** 分组字段键名 */\n  key: string;\n  /** 分组字段显示名称 */\n  label: string;\n  /** 分组模式 */\n  mode: GroupingMode;\n  /** 其他字段的值处理方式 */\n  valueProcessing: GroupValueProcessing;\n  /** 自定义处理函数 */\n  customProcessor?: (values: any[]) => any;\n  /** 是否显示分组行 */\n  showGroupHeader: boolean;\n  /** 分组行模板 */\n  groupHeaderTemplate?: string;\n  /** 是否合并单元格（仅Excel格式支持） */\n  mergeCells: boolean;\n}\n\n/** 分组配置 */\nexport interface GroupingConfig {\n  /** 是否启用分组 */\n  enabled: boolean;\n  /** 分组字段列表（支持多级分组） */\n  fields: GroupingField[];\n  /** 分组后是否保持原始顺序 */\n  preserveOrder: boolean;\n  /** 空值处理方式 */\n  nullValueHandling: 'skip' | 'group' | 'separate';\n  /** 空值分组名称 */\n  nullGroupName?: string;\n}\n\n/** 导出配置 */\nexport interface ExportConfig {\n  /** 配置ID */\n  id: string;\n  /** 配置名称 */\n  name: string;\n  /** 配置描述 */\n  description?: string;\n  /** 导出格式 */\n  format: ExportFormat;\n  /** 字段定义 */\n  fields: ExportField[];\n  /** 分组配置 */\n  grouping?: GroupingConfig;\n  /** 文件名模板 */\n  fileNameTemplate: string;\n  /** 是否包含表头 */\n  includeHeader: boolean;\n  /** 分隔符 */\n  delimiter: string;\n  /** 编码格式 */\n  encoding: string;\n  /** 是否添加BOM */\n  addBOM: boolean;\n  /** 最大行数限制 */\n  maxRows?: number;\n  /** 创建时间 */\n  createdAt: Date;\n  /** 更新时间 */\n  updatedAt: Date;\n  /** 模块标识 */\n  moduleId: string;\n  /** 业务标识 */\n  businessId?: string;\n  /** 创建者ID */\n  createdBy?: string;\n}\n\n/** 导出请求 */\nexport interface ExportRequest {\n  /** 导出配置ID或配置对象 */\n  configId: string | ExportConfig;\n  /** 数据源 */\n  dataSource: string | (() => Promise<any[]>) | any[];\n  /** 查询参数 */\n  queryParams?: Record<string, any>;\n  /** 自定义字段映射 */\n  fieldMapping?: Record<string, string>;\n  /** 过滤条件 */\n  filters?: ExportFilter[];\n  /** 排序条件 */\n  sortBy?: ExportSort[];\n  /** 分页参数 */\n  pagination?: {\n    page: number;\n    pageSize: number;\n  };\n  /** 自定义文件名 */\n  customFileName?: string;\n  /** 回调函数 */\n  callbacks?: {\n    onProgress?: (progress: ExportProgress) => void;\n    onSuccess?: (result: ExportResult) => void;\n    onError?: (error: ExportError) => void;\n  };\n}\n\n/** 导出过滤器 */\nexport interface ExportFilter {\n  /** 字段名 */\n  field: string;\n  /** 操作符 */\n  operator:\n    | 'eq'\n    | 'ne'\n    | 'gt'\n    | 'gte'\n    | 'lt'\n    | 'lte'\n    | 'contains'\n    | 'startsWith'\n    | 'endsWith'\n    | 'in'\n    | 'notIn';\n  /** 值 */\n  value: any;\n}\n\n/** 导出排序 */\nexport interface ExportSort {\n  /** 字段名 */\n  field: string;\n  /** 排序方向 */\n  direction: 'asc' | 'desc';\n}\n\n/** 导出进度 */\nexport interface ExportProgress {\n  /** 导出ID */\n  exportId: string;\n  /** 状态 */\n  status: ExportStatus;\n  /** 进度百分比 */\n  progress: number;\n  /** 已处理行数 */\n  processedRows: number;\n  /** 总行数 */\n  totalRows: number;\n  /** 开始时间 */\n  startTime: Date;\n  /** 预计完成时间 */\n  estimatedEndTime?: Date;\n  /** 当前处理的数据 */\n  currentData?: any;\n  /** 错误信息 */\n  error?: string;\n}\n\n/** 导出结果 */\nexport interface ExportResult {\n  /** 导出ID */\n  exportId: string;\n  /** 文件名 */\n  fileName: string;\n  /** 文件大小 */\n  fileSize: number;\n  /** 文件URL */\n  fileUrl?: string;\n  /** 文件Blob */\n  fileBlob?: Blob;\n  /** 导出行数 */\n  exportedRows: number;\n  /** 开始时间 */\n  startTime: Date;\n  /** 完成时间 */\n  endTime: Date;\n  /** 耗时(毫秒) */\n  duration: number;\n  /** 统计信息 */\n  statistics?: {\n    totalRows: number;\n    filteredRows: number;\n    exportedRows: number;\n    skippedRows: number;\n  };\n}\n\n/** 导出错误 */\nexport interface ExportError {\n  /** 错误代码 */\n  code: string;\n  /** 错误消息 */\n  message: string;\n  /** 错误详情 */\n  details?: Record<string, any>;\n  /** 错误时间 */\n  timestamp: Date;\n}\n\n// ============= 服务配置接口 =============\n\n/** 通用导出服务配置 */\nexport interface UniversalExportServiceConfig {\n  /** 默认导出格式 */\n  defaultFormat: ExportFormat;\n  /** 默认分隔符 */\n  defaultDelimiter: string;\n  /** 默认编码 */\n  defaultEncoding: string;\n  /** 是否默认添加BOM */\n  defaultAddBOM: boolean;\n  /** 最大文件大小限制(字节) */\n  maxFileSize: number;\n  /** 最大行数限制 */\n  maxRowsLimit: number;\n  /** 并发导出数量限制 */\n  maxConcurrentExports: number;\n  /** 导出超时时间(毫秒) */\n  exportTimeout: number;\n  /** 缓存配置 */\n  cache: {\n    /** 配置缓存TTL(秒) */\n    configTTL: number;\n    /** 结果缓存TTL(秒) */\n    resultTTL: number;\n  };\n}\n\n// ============= 异常类定义 =============\n\n/** 导出服务基础异常 */\nexport class ExportServiceError 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 = 'ExportServiceError';\n  }\n}\n\n/** 导出配置错误 */\nexport class ExportConfigError extends ExportServiceError {\n  constructor(message: string, details?: Record<string, any>) {\n    super(message, 'EXPORT_CONFIG_ERROR', details);\n    this.name = 'ExportConfigError';\n  }\n}\n\n/** 导出数据处理错误 */\nexport class ExportDataError extends ExportServiceError {\n  constructor(message: string, details?: Record<string, any>) {\n    super(message, 'EXPORT_DATA_ERROR', details);\n    this.name = 'ExportDataError';\n  }\n}\n\n/** 导出文件生成错误 */\nexport class ExportFileError extends ExportServiceError {\n  constructor(message: string, details?: Record<string, any>) {\n    super(message, 'EXPORT_FILE_ERROR', details);\n    this.name = 'ExportFileError';\n  }\n}\n\n// ============= 事件类型定义 =============\n\n/** 导出事件类型 */\nexport type ExportEventType =\n  | 'export:start'\n  | 'export:progress'\n  | 'export:complete'\n  | 'export:error'\n  | 'export:cancel'\n  | 'config:save'\n  | 'config:delete';\n\n/** 导出事件 */\nexport interface ExportEvent {\n  /** 事件类型 */\n  type: ExportEventType;\n  /** 导出ID */\n  exportId: string;\n  /** 事件时间 */\n  timestamp: Date;\n  /** 事件数据 */\n  data?: Record<string, any>;\n  /** 错误信息 */\n  error?: string;\n}\n\n/** 导出事件监听器 */\nexport type ExportEventListener = (event: ExportEvent) => void | Promise<void>;\n\n// ============= 工具类型 =============\n\n/** 字段映射函数 */\nexport type FieldMapper<T = any> = (item: T, index: number) => Record<string, any>;\n\n/** 数据转换函数 */\nexport type DataTransformer<T = any, R = any> = (data: T[]) => R[];\n\n/** 验证函数 */\nexport type Validator<T = any> = (data: T) => boolean | string;\n\n/** 格式化函数 */\nexport type Formatter<T = any> = (value: T) => string;\n","/**\n * 通用导出服务常量定义\n */\n\nimport type { ExportFormat } from './types';\n\n// ============= 版本信息 =============\n\n/** 模块版本 */\nexport const UNIVERSAL_EXPORT_VERSION = '1.0.0';\n\n/** 模块名称 */\nexport const UNIVERSAL_EXPORT_NAME = '@lyricnote/universal-export';\n\n// ============= 默认配置 =============\n\n/** 默认导出格式 */\nexport const DEFAULT_EXPORT_FORMAT: ExportFormat = 'csv';\n\n/** 默认CSV分隔符 */\nexport const DEFAULT_CSV_DELIMITER = ',';\n\n/** 默认编码格式 */\nexport const DEFAULT_ENCODING = 'utf-8';\n\n/** 默认是否添加BOM */\nexport const DEFAULT_ADD_BOM = true;\n\n/** 默认最大文件大小(字节) - 100MB */\nexport const DEFAULT_MAX_FILE_SIZE = 100 * 1024 * 1024;\n\n/** 默认最大行数限制 */\nexport const DEFAULT_MAX_ROWS = 100000;\n\n/** 默认并发导出数量 */\nexport const DEFAULT_MAX_CONCURRENT_EXPORTS = 5;\n\n/** 默认导出超时时间(毫秒) - 5分钟 */\nexport const DEFAULT_EXPORT_TIMEOUT = 300000;\n\n/** 默认配置缓存TTL(秒) - 1小时 */\nexport const DEFAULT_CONFIG_CACHE_TTL = 3600;\n\n/** 默认结果缓存TTL(秒) - 30分钟 */\nexport const DEFAULT_RESULT_CACHE_TTL = 1800;\n\n// ============= 文件扩展名 =============\n\n/** 导出格式对应的文件扩展名 */\nexport const EXPORT_FORMAT_EXTENSIONS: Record<ExportFormat, string> = {\n  csv: 'csv',\n  excel: 'xlsx',\n  json: 'json',\n};\n\n/** 导出格式对应的MIME类型 */\nexport const EXPORT_FORMAT_MIME_TYPES: Record<ExportFormat, string> = {\n  csv: 'text/csv; charset=utf-8',\n  excel: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',\n  json: 'application/json; charset=utf-8',\n};\n\n// ============= API端点 =============\n\n/** API基础路径 */\nexport const API_BASE_PATH = '/api/universal-export';\n\n/** API端点 */\nexport const API_ENDPOINTS = {\n  /** 获取配置列表 */\n  GET_CONFIGS: (API_BASE_PATH) + '/configs',\n  /** 创建配置 */\n  CREATE_CONFIG: (API_BASE_PATH) + '/configs',\n  /** 更新配置 */\n  UPDATE_CONFIG: (configId: string) => (API_BASE_PATH) + '/configs/' + (configId),\n  /** 删除配置 */\n  DELETE_CONFIG: (configId: string) => (API_BASE_PATH) + '/configs/' + (configId),\n  /** 触发导出 */\n  EXPORT_DATA: (API_BASE_PATH) + '/export',\n  /** 查询导出进度 */\n  GET_PROGRESS: (exportId: string) => (API_BASE_PATH) + '/export/' + (exportId) + '/progress',\n  /** 下载导出文件 */\n  DOWNLOAD_FILE: (exportId: string) => (API_BASE_PATH) + '/export/' + (exportId) + '/download',\n} as const;\n\n// ============= 错误代码 =============\n\n/** 错误代码 */\nexport const ERROR_CODES = {\n  /** 导出配置错误 */\n  EXPORT_CONFIG_ERROR: 'EXPORT_CONFIG_ERROR',\n  /** 导出数据错误 */\n  EXPORT_DATA_ERROR: 'EXPORT_DATA_ERROR',\n  /** 导出文件错误 */\n  EXPORT_FILE_ERROR: 'EXPORT_FILE_ERROR',\n  /** 网络错误 */\n  NETWORK_ERROR: 'NETWORK_ERROR',\n  /** 超时错误 */\n  TIMEOUT_ERROR: 'TIMEOUT_ERROR',\n  /** 未授权 */\n  UNAUTHORIZED: 'UNAUTHORIZED',\n  /** 服务器错误 */\n  SERVER_ERROR: 'SERVER_ERROR',\n} as const;\n","/**\n * 通用导出服务工具函数\n */\n\nimport type { ExportFormat, Formatter } from './types';\nimport { EXPORT_FORMAT_EXTENSIONS } from './constants';\n\n// ============= 文件名处理 =============\n\n/**\n * 生成导出文件名\n */\nexport function generateExportFileName(template: string, format: ExportFormat): string {\n  const now = new Date();\n  const dateStr = now.toISOString().split('T')[0] || '';\n  const timeStr = (now.toTimeString().split(' ')[0] || '').replace(/:/g, '-');\n  const extension = EXPORT_FORMAT_EXTENSIONS[format];\n\n  return (\n    template\n      .replace('{date}', dateStr)\n      .replace('{time}', timeStr)\n      .replace('{timestamp}', now.getTime().toString()) + '.' + (extension)\n  );\n}\n\n/**\n * 验证文件名是否合法\n */\nexport function validateFileName(fileName: string): boolean {\n  // 检查是否包含非法字符\n  const invalidChars = /[<>:\"|?*\\/\\\\]/;\n  if (invalidChars.test(fileName)) {\n    return false;\n  }\n\n  // 检查长度\n  if (fileName.length === 0 || fileName.length > 255) {\n    return false;\n  }\n\n  return true;\n}\n\n/**\n * 清理文件名，移除非法字符\n */\nexport function sanitizeFileName(fileName: string): string {\n  return fileName.replace(/[<>:\"|?*\\/\\\\]/g, '_').substring(0, 255);\n}\n\n// ============= CSV处理 =============\n\n/**\n * 转义CSV字段\n */\nexport function escapeCSVField(value: string, delimiter: string = ','): string {\n  const valueStr = String(value || '');\n\n  // 如果包含分隔符、双引号或换行符，需要用双引号包裹并转义内部的双引号\n  if (valueStr.includes(delimiter) || valueStr.includes('\"') || valueStr.includes('\\n')) {\n    return '\"' + (valueStr.replace(/\"/g, '\"\"')) + '\"';\n  }\n\n  return valueStr;\n}\n\n/**\n * 解析CSV字段\n */\nexport function parseCSVField(field: string): string {\n  // 如果字段被双引号包裹，移除双引号并还原转义的双引号\n  if (field.startsWith('\"') && field.endsWith('\"')) {\n    return field.slice(1, -1).replace(/\"\"/g, '\"');\n  }\n\n  return field;\n}\n\n// ============= 数据格式化 =============\n\n/**\n * 内置格式化器集合\n */\nexport const DEFAULT_FORMATTERS: Record<string, Formatter> = {\n  // 日期格式化\n  date: (value: any) => {\n    if (!value) return '';\n    const date = new Date(value);\n    if (isNaN(date.getTime())) return String(value);\n    return date.toISOString().split('T')[0] || '';\n  },\n\n  // 时间格式化\n  datetime: (value: any) => {\n    if (!value) return '';\n    const date = new Date(value);\n    if (isNaN(date.getTime())) return String(value);\n    return date.toLocaleString('zh-CN');\n  },\n\n  // 数字格式化\n  number: (value: any) => {\n    if (value === null || value === undefined) return '';\n    return String(value);\n  },\n\n  // 货币格式化\n  currency: (value: any) => {\n    if (value === null || value === undefined) return '';\n    return '¥' + (Number(value).toFixed(2));\n  },\n\n  // 百分比格式化\n  percentage: (value: any) => {\n    if (value === null || value === undefined) return '';\n    return ((Number(value) * 100).toFixed(2)) + '%';\n  },\n\n  // 布尔值格式化\n  boolean: (value: any) => {\n    if (value === null || value === undefined) return '';\n    return value ? '是' : '否';\n  },\n\n  // 数组格式化\n  array: (value: any) => {\n    if (!Array.isArray(value)) return '';\n    return value.join(', ');\n  },\n\n  // 对象格式化\n  object: (value: any) => {\n    if (!value || typeof value !== 'object') return '';\n    return JSON.stringify(value);\n  },\n};\n\n/**\n * 应用格式化器\n */\nexport function applyFormatter(value: any, formatter?: Formatter, type?: string): string {\n  // 优先使用自定义格式化器\n  if (formatter) {\n    return formatter(value);\n  }\n\n  // 使用类型对应的默认格式化器\n  if (type && DEFAULT_FORMATTERS[type]) {\n    return DEFAULT_FORMATTERS[type](value);\n  }\n\n  // 默认转字符串\n  return String(value || '');\n}\n\n// ============= 数据验证 =============\n\n/**\n * 验证导出配置\n */\nexport function validateExportConfig(config: any): { valid: boolean; errors: string[] } {\n  const errors: string[] = [];\n\n  // 检查必填字段\n  if (!config.name || config.name.trim() === '') {\n    errors.push('配置名称不能为空');\n  }\n\n  if (!config.fields || !Array.isArray(config.fields) || config.fields.length === 0) {\n    errors.push('至少需要定义一个字段');\n  }\n\n  if (config.fields) {\n    const enabledFields = config.fields.filter((f: any) => f.enabled);\n    if (enabledFields.length === 0) {\n      errors.push('至少需要启用一个字段');\n    }\n\n    // 检查字段键名唯一性\n    const keys = config.fields.map((f: any) => f.key);\n    const uniqueKeys = new Set(keys);\n    if (keys.length !== uniqueKeys.size) {\n      errors.push('字段键名必须唯一');\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n  };\n}\n\n/**\n * 验证导出请求\n */\nexport function validateExportRequest(request: any): { valid: boolean; errors: string[] } {\n  const errors: string[] = [];\n\n  if (!request.configId) {\n    errors.push('导出配置ID不能为空');\n  }\n\n  if (!request.dataSource) {\n    errors.push('数据源不能为空');\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n  };\n}\n\n// ============= 文件大小格式化 =============\n\n/**\n * 格式化文件大小\n */\nexport function formatFileSize(bytes: number): string {\n  if (bytes === 0) return '0 B';\n\n  const units = ['B', 'KB', 'MB', 'GB', 'TB'];\n  const k = 1024;\n  const i = Math.floor(Math.log(bytes) / Math.log(k));\n\n  return ((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + (units[i]);\n}\n\n// ============= 时间处理 =============\n\n/**\n * 格式化持续时间\n */\nexport function formatDuration(milliseconds: number): string {\n  if (milliseconds < 1000) {\n    return (milliseconds) + 'ms';\n  }\n\n  const seconds = Math.floor(milliseconds / 1000);\n\n  if (seconds < 60) {\n    return (seconds) + '秒';\n  }\n\n  const minutes = Math.floor(seconds / 60);\n  const remainingSeconds = seconds % 60;\n\n  if (minutes < 60) {\n    return remainingSeconds > 0 ? (minutes) + '分' + (remainingSeconds) + '秒' : (minutes) + '分钟';\n  }\n\n  const hours = Math.floor(minutes / 60);\n  const remainingMinutes = minutes % 60;\n\n  return remainingMinutes > 0 ? (hours) + '小时' + (remainingMinutes) + '分钟' : (hours) + '小时';\n}\n\n/**\n * 计算预计完成时间\n */\nexport function estimateEndTime(\n  startTime: Date,\n  processedRows: number,\n  totalRows: number\n): Date | undefined {\n  if (processedRows === 0 || totalRows === 0) {\n    return undefined;\n  }\n\n  const elapsed = Date.now() - startTime.getTime();\n  const avgTimePerRow = elapsed / processedRows;\n  const remainingRows = totalRows - processedRows;\n  const remainingTime = avgTimePerRow * remainingRows;\n\n  return new Date(Date.now() + remainingTime);\n}\n\n// ============= 数据处理 =============\n\n/**\n * 获取嵌套对象的值\n */\nexport function getNestedValue(obj: any, path: string): any {\n  return path.split('.').reduce((current, key) => {\n    return current && current[key] !== undefined ? current[key] : null;\n  }, obj);\n}\n\n/**\n * 设置嵌套对象的值\n */\nexport function setNestedValue(obj: any, path: string, value: any): void {\n  const keys = path.split('.');\n  const lastKey = keys.pop();\n\n  if (!lastKey) return;\n\n  const target = keys.reduce((current, key) => {\n    if (!current[key] || typeof current[key] !== 'object') {\n      current[key] = {};\n    }\n    return current[key];\n  }, obj);\n\n  target[lastKey] = value;\n}\n\n// ============= 错误处理 =============\n\n/**\n * 创建导出错误对象\n */\nexport function createExportError(\n  code: string,\n  message: string,\n  details?: Record<string, any>\n): { code: string; message: string; details?: Record<string, any>; timestamp: Date } {\n  return {\n    code,\n    message,\n    details,\n    timestamp: new Date(),\n  };\n}\n\n/**\n * 格式化错误消息\n */\nexport function formatErrorMessage(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message;\n  }\n\n  if (typeof error === 'string') {\n    return error;\n  }\n\n  return '未知错误';\n}\n"]}