sa2kit 3.0.0 → 3.2.0

package/dist/chunk-S3K4LTRI.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/common/ossFile/shared/httpClient.ts","../src/common/ossFile/client.ts"],"names":[],"mappings":"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","file":"chunk-S3K4LTRI.mjs","sourcesContent":["import type { RequestAdapter, RequestConfig } from '../../request/types/types';\nimport type { PlatformAdapter } from '../../platform/types';\n\n/** 与标准 fetch 兼容，供 ossFile 客户端注入（Taro / Hono SSR 等） */\nexport type OssFileFetchFn = (\n  url: string,\n  init?: RequestInit,\n) => Promise<Response>;\n\nexport type OssFileHttpConfig = {\n  fetch?: OssFileFetchFn;\n};\n\nlet globalHttpConfig: OssFileHttpConfig = {};\n\nexport function configureOssFileHttp(config: OssFileHttpConfig): void {\n  globalHttpConfig = { ...globalHttpConfig, ...config };\n}\n\n/** @internal 测试重置 */\nexport function resetOssFileHttpForTesting(): void {\n  globalHttpConfig = {};\n}\n\nfunction isMultipartBody(body: BodyInit | null | undefined): boolean {\n  return (\n    body instanceof FormData ||\n    body instanceof Blob ||\n    body instanceof URLSearchParams\n  );\n}\n\nfunction headersToRecord(headers?: HeadersInit): Record<string, string> {\n  const out: Record<string, string> = {};\n  if (!headers) {\n    return out;\n  }\n  if (headers instanceof Headers) {\n    headers.forEach((value, key) => {\n      out[key] = value;\n    });\n    return out;\n  }\n  if (Array.isArray(headers)) {\n    for (const [key, value] of headers) {\n      out[key] = value;\n    }\n    return out;\n  }\n  return { ...headers };\n}\n\n/**\n * 将 RequestAdapter 桥接为 fetch 形态（JSON 请求）。\n * multipart 上传需通过 `configureOssFileHttp({ fetch })` 注入完整 fetch。\n */\nexport function createOssFileFetchFromAdapter(\n  adapter: RequestAdapter,\n): OssFileFetchFn {\n  return async (url, init = {}) => {\n    if (isMultipartBody(init.body ?? null)) {\n      throw new Error(\n        '[ossFile] RequestAdapter 不支持 multipart；请注入支持 FormData 的 fetch',\n      );\n    }\n\n    const method = (init.method ?? 'GET').toUpperCase() as NonNullable<\n      RequestConfig['method']\n    >;\n    let body: unknown;\n    if (typeof init.body === 'string' && init.body) {\n      try {\n        body = JSON.parse(init.body) as unknown;\n      } catch {\n        body = init.body;\n      }\n    }\n\n    const payload = await adapter.request({\n      url,\n      method,\n      headers: headersToRecord(init.headers),\n      body,\n    });\n\n    const success = (payload as { success?: boolean } | null)?.success;\n    const status = success === false ? 400 : 200;\n    return new Response(JSON.stringify(payload), {\n      status,\n      headers: { 'Content-Type': 'application/json' },\n    });\n  };\n}\n\n/**\n * 从 PlatformAdapter 配置 ossFile HTTP（R2-223）\n *\n * - JSON GET/POST：走 `platform.fetch`（RequestAdapter）\n * - FormData 上传：走 `uploadFetch`，默认回退全局 `fetch`\n */\nexport function configureOssFileFromPlatform(\n  platform: PlatformAdapter,\n  options: {\n    uploadFetch?: OssFileFetchFn;\n  } = {},\n): void {\n  const jsonFetch = createOssFileFetchFromAdapter(platform.fetch);\n  const uploadFetch =\n    options.uploadFetch ??\n    (typeof fetch !== 'undefined' ? fetch.bind(globalThis) : undefined);\n\n  configureOssFileHttp({\n    fetch: async (url, init) => {\n      if (isMultipartBody(init?.body ?? null)) {\n        if (!uploadFetch) {\n          throw new Error(\n            '[ossFile] multipart 上传需要 uploadFetch 或浏览器 fetch 环境',\n          );\n        }\n        return uploadFetch(url, { credentials: 'include', ...init });\n      }\n      return jsonFetch(url, init);\n    },\n  });\n}\n\nexport function getOssFileFetch(override?: OssFileFetchFn): OssFileFetchFn {\n  const fn = override ?? globalHttpConfig.fetch;\n  if (fn) {\n    return fn;\n  }\n  if (typeof fetch === 'undefined') {\n    throw new Error(\n      '[ossFile] 无可用 fetch；请先调用 configureOssFileHttp 或 configureOssFileFromPlatform',\n    );\n  }\n  return fetch.bind(globalThis);\n}\n\nexport async function ossFileFetch(\n  url: string,\n  init?: RequestInit,\n  override?: OssFileFetchFn,\n): Promise<Response> {\n  return getOssFileFetch(override)(url, {\n    credentials: 'include',\n    ...init,\n  });\n}\n","import {\n  universalFileClient,\n  createFileClient,\n  type UniversalFileClientConfig,\n} from '../universalFile/client';\nimport { API_ENDPOINTS } from '../universalFile/constants';\nimport {\n  STANDARD_ALIYUN_OSS_KEYS,\n  parseAliyunOssConfigFromMap,\n  isCompleteOssConfig,\n  getOssStorageModeLabelFromConfig,\n} from './shared/ossConfig';\nimport { buildModuleUploadPath, resolveUploadFolderPath } from './shared/path';\nimport {\n  configureOssFileFromPlatform,\n  configureOssFileHttp,\n  createOssFileFetchFromAdapter,\n  ossFileFetch,\n  type OssFileFetchFn,\n  type OssFileHttpConfig,\n} from './shared/httpClient';\n\nexport {\n  configureOssFileHttp,\n  configureOssFileFromPlatform,\n  createOssFileFetchFromAdapter,\n  type OssFileFetchFn,\n  type OssFileHttpConfig,\n};\n\nexport type { UniversalFileClientConfig };\n\nexport {\n  universalFileClient,\n  createFileClient,\n  STANDARD_ALIYUN_OSS_KEYS,\n  parseAliyunOssConfigFromMap,\n  buildModuleUploadPath,\n  resolveUploadFolderPath,\n};\n\nexport interface UploadModuleFileOptions {\n  file: File | Blob;\n  moduleId: string;\n  businessId?: string;\n  uploadUrl?: string;\n  /** 与 universalFile 的 customPath 等价 */\n  folderPath?: string;\n  customPath?: string;\n  needsProcessing?: boolean;\n  permission?: 'public' | 'private' | 'authenticated' | 'owner-only';\n  metadata?: Record<string, unknown>;\n  extraFields?: Record<string, string>;\n  /** 单次请求覆盖全局注入的 fetch（R2-223） */\n  fetch?: OssFileFetchFn;\n}\n\nexport interface UploadModuleFileResult {\n  fileId: string;\n  accessUrl: string;\n}\n\nexport async function uploadModuleFile(\n  options: UploadModuleFileOptions,\n): Promise<UploadModuleFileResult> {\n  const uploadUrl = options.uploadUrl ?? API_ENDPOINTS.UPLOAD;\n  const fileName = options.file instanceof File ? options.file.name : 'upload.jpg';\n  const folderPath = resolveUploadFolderPath({\n    moduleId: options.moduleId,\n    businessId: options.businessId,\n    fileName,\n    folderPath: options.folderPath,\n    customPath: options.customPath,\n  });\n\n  const formData = new FormData();\n  formData.append('file', options.file);\n  formData.append('moduleId', options.moduleId);\n  formData.append('businessId', options.businessId ?? 'default');\n  formData.append('folderPath', folderPath);\n  if (options.permission) {\n    formData.append('permission', options.permission);\n  }\n  if (options.metadata) {\n    formData.append('metadata', JSON.stringify(options.metadata));\n  }\n  if (options.needsProcessing !== undefined) {\n    formData.append('needsProcessing', String(options.needsProcessing));\n  }\n  if (options.extraFields) {\n    for (const [key, value] of Object.entries(options.extraFields)) {\n      formData.append(key, value);\n    }\n  }\n\n  const response = await ossFileFetch(\n    uploadUrl,\n    {\n      method: 'POST',\n      body: formData,\n    },\n    options.fetch,\n  );\n\n  const payload = await response.json().catch(() => ({}));\n  if (!response.ok || payload.success === false) {\n    throw new Error(payload.error || payload.message || `HTTP ${response.status}`);\n  }\n\n  const data = payload.data ?? payload;\n  const fileId = data.fileId ?? data.id;\n  const accessUrl = data.accessUrl ?? data.url;\n  if (!fileId || !accessUrl) {\n    throw new Error('上传响应缺少 fileId 或 accessUrl');\n  }\n\n  return { fileId, accessUrl };\n}\n\nexport async function uploadArtworkImage(\n  file: File,\n  collectionId?: number,\n): Promise<UploadModuleFileResult> {\n  return uploadModuleFile({\n    file,\n    moduleId: 'showmasterpiece',\n    businessId: collectionId ? `collection-${collectionId}` : 'artwork',\n    needsProcessing: true,\n  });\n}\n\nexport async function getModuleFileAccessUrl(\n  fileId: string,\n  apiBase = '',\n  fetchOverride?: OssFileFetchFn,\n): Promise<string> {\n  const response = await ossFileFetch(\n    `${apiBase}/api/universal-file/${fileId}`,\n    { method: 'GET' },\n    fetchOverride,\n  );\n  if (!response.ok) {\n    throw new Error(`获取文件 URL 失败: HTTP ${response.status}`);\n  }\n  const payload = await response.json();\n  if (payload.success === false) {\n    throw new Error(payload.error || '获取文件 URL 失败');\n  }\n  const url = payload.data?.accessUrl ?? payload.accessUrl;\n  if (!url) {\n    throw new Error('响应缺少 accessUrl');\n  }\n  return url;\n}\n\nexport const getArtworkImageUrl = getModuleFileAccessUrl;\n\nlet cachedOssConfig: ReturnType<typeof parseAliyunOssConfigFromMap> = null;\n\nasync function loadOssConfigFromItemsApi(\n  itemsApiUrl: string,\n  fetchOverride?: OssFileFetchFn,\n) {\n  const keys = Object.values(STANDARD_ALIYUN_OSS_KEYS).join(',');\n  const url = `${itemsApiUrl}${itemsApiUrl.includes('?') ? '&' : '?'}keys=${encodeURIComponent(keys)}`;\n  const response = await ossFileFetch(url, { method: 'GET' }, fetchOverride);\n  if (!response.ok) return null;\n\n  const data = await response.json();\n  if (!data.success || !Array.isArray(data.items)) return null;\n\n  const configMap: Record<string, string> = {};\n  for (const item of data.items) {\n    if (item?.key && item?.value) {\n      configMap[item.key] = item.value;\n    }\n  }\n  return parseAliyunOssConfigFromMap(configMap);\n}\n\nasync function getCachedOssConfig(itemsApiUrl?: string) {\n  if (cachedOssConfig !== null) {\n    return cachedOssConfig;\n  }\n  if (typeof window !== 'undefined' && itemsApiUrl) {\n    cachedOssConfig = await loadOssConfigFromItemsApi(itemsApiUrl);\n  }\n  return cachedOssConfig;\n}\n\nexport async function shouldUseOssFileService(\n  itemsApiUrl?: string,\n): Promise<boolean> {\n  try {\n    await getCachedOssConfig(itemsApiUrl);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nexport async function getOssStorageModeDisplayName(\n  itemsApiUrl?: string,\n): Promise<string> {\n  const config = await getCachedOssConfig(itemsApiUrl);\n  return getOssStorageModeLabelFromConfig(config);\n}\n\nexport function clearOssFileConfigCache(): void {\n  cachedOssConfig = null;\n}\n\nexport async function refreshOssFileConfigCache(\n  itemsApiUrl?: string,\n): Promise<void> {\n  clearOssFileConfigCache();\n  await getCachedOssConfig(itemsApiUrl);\n}\n\nexport const shouldUseUniversalFileService = shouldUseOssFileService;\nexport const getStorageModeDisplayName = getOssStorageModeDisplayName;\nexport const clearConfigCache = clearOssFileConfigCache;\nexport const refreshFileServiceConfig = refreshOssFileConfigCache;\n\nexport async function fetchOssConfigManagerFromItemsApi(\n  itemsApiUrl: string,\n): Promise<ReturnType<typeof parseAliyunOssConfigFromMap>> {\n  return loadOssConfigFromItemsApi(itemsApiUrl);\n}\n\nexport function isOssConfigured(config: ReturnType<typeof parseAliyunOssConfigFromMap>): boolean {\n  return isCompleteOssConfig(config);\n}\n"]}

package/dist/chunk-SWZ5XNF6.js

@@ -0,0 +1,158 @@
+'use strict';
+
+var chunkFCLS5R24_js = require('./chunk-FCLS5R24.js');
+var chunk7VVZHFEM_js = require('./chunk-7VVZHFEM.js');
+var chunk3QCATFQV_js = require('./chunk-3QCATFQV.js');
+var chunkNSBPE2FW_js = require('./chunk-NSBPE2FW.js');
+
+// src/common/platform/index.ts
+var platform_exports = {};
+chunkNSBPE2FW_js.__export(platform_exports, {
+  createElectronPlatformAdapter: () => createElectronPlatformAdapter,
+  createNodeHonoPlatformAdapter: () => createNodeHonoPlatformAdapter,
+  createTaroPlatformAdapter: () => createTaroPlatformAdapter,
+  createWebPlatformAdapter: () => createWebPlatformAdapter
+});
+
+// src/common/platform/adapters/web.ts
+function createWebFilePickAdapter() {
+  return {
+    async pickFiles(options) {
+      if (typeof document === "undefined") {
+        throw new Error("[PlatformAdapter:web] filePick \u9700\u8981\u6D4F\u89C8\u5668 document");
+      }
+      return new Promise((resolve, reject) => {
+        const input = document.createElement("input");
+        input.type = "file";
+        input.style.display = "none";
+        if (options?.accept) {
+          input.accept = options.accept;
+        }
+        if (options?.multiple) {
+          input.multiple = true;
+        }
+        input.onchange = () => {
+          const files = Array.from(input.files ?? []);
+          input.remove();
+          resolve(
+            files.map((file) => ({
+              name: file.name,
+              mimeType: file.type || void 0,
+              size: file.size,
+              blob: file
+            }))
+          );
+        };
+        input.oncancel = () => {
+          input.remove();
+          resolve([]);
+        };
+        document.body.appendChild(input);
+        input.click();
+        input.addEventListener("error", () => {
+          input.remove();
+          reject(new Error("[PlatformAdapter:web] filePick \u5931\u8D25"));
+        });
+      });
+    }
+  };
+}
+function createWebPlatformAdapter(options = {}) {
+  return {
+    storage: new chunk7VVZHFEM_js.WebStorageAdapter(),
+    fetch: new chunk3QCATFQV_js.WebRequestAdapter(),
+    filePick: options.filePick === false ? void 0 : createWebFilePickAdapter()
+  };
+}
+
+// src/common/platform/adapters/taro.ts
+function createTaroPlatformAdapter(partial) {
+  if (!partial.storage || !partial.fetch) {
+    throw new Error(
+      "[PlatformAdapter:taro] \u8BF7\u6CE8\u5165 storage \u4E0E fetch\uFF08\u57FA\u4E8E Taro.getStorage / Taro.request\uFF09"
+    );
+  }
+  return {
+    storage: partial.storage,
+    fetch: partial.fetch,
+    filePick: partial.filePick
+  };
+}
+
+// src/common/platform/adapters/electron.ts
+function createElectronPlatformAdapter(options = {}) {
+  try {
+    return {
+      storage: new chunkFCLS5R24_js.ElectronStorageAdapter(),
+      fetch: new chunk3QCATFQV_js.WebRequestAdapter(),
+      filePick: options.filePick === false ? void 0 : createWebPlatformAdapter({ filePick: true }).filePick
+    };
+  } catch {
+    return createWebPlatformAdapter(options);
+  }
+}
+
+// src/common/platform/adapters/node-hono.ts
+var MemoryStorageAdapter = class {
+  constructor() {
+    this.store = /* @__PURE__ */ new Map();
+  }
+  async getItem(key) {
+    return this.store.get(key) ?? null;
+  }
+  async setItem(key, value) {
+    this.store.set(key, value);
+  }
+  async removeItem(key) {
+    this.store.delete(key);
+  }
+};
+var NodeFetchAdapter = class {
+  async request(config) {
+    let fullUrl = config.url;
+    if (config.params) {
+      const search = new URLSearchParams();
+      for (const [key, value] of Object.entries(config.params)) {
+        if (value !== void 0 && value !== null) {
+          search.append(key, String(value));
+        }
+      }
+      const qs = search.toString();
+      if (qs) {
+        fullUrl += (fullUrl.includes("?") ? "&" : "?") + qs;
+      }
+    }
+    const response = await fetch(fullUrl, {
+      method: config.method ?? "GET",
+      headers: {
+        "Content-Type": "application/json",
+        ...config.headers
+      },
+      body: config.body ? JSON.stringify(config.body) : void 0
+    });
+    if (!response.ok) {
+      throw new Error(`[PlatformAdapter:node-hono] HTTP ${response.status}`);
+    }
+    return await response.json();
+  }
+};
+var unsupportedFilePick = {
+  async pickFiles() {
+    throw new Error("[PlatformAdapter:node-hono] filePick \u9700\u5728\u5BBF\u4E3B\u6CE8\u5165");
+  }
+};
+function createNodeHonoPlatformAdapter(overrides = {}) {
+  return {
+    storage: overrides.storage ?? new MemoryStorageAdapter(),
+    fetch: overrides.fetch ?? new NodeFetchAdapter(),
+    filePick: overrides.filePick ?? unsupportedFilePick
+  };
+}
+
+exports.createElectronPlatformAdapter = createElectronPlatformAdapter;
+exports.createNodeHonoPlatformAdapter = createNodeHonoPlatformAdapter;
+exports.createTaroPlatformAdapter = createTaroPlatformAdapter;
+exports.createWebPlatformAdapter = createWebPlatformAdapter;
+exports.platform_exports = platform_exports;
+//# sourceMappingURL=chunk-SWZ5XNF6.js.map
+//# sourceMappingURL=chunk-SWZ5XNF6.js.map

package/dist/chunk-SWZ5XNF6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/common/platform/index.ts","../src/common/platform/adapters/web.ts","../src/common/platform/adapters/taro.ts","../src/common/platform/adapters/electron.ts","../src/common/platform/adapters/node-hono.ts"],"names":["__export","WebStorageAdapter","WebRequestAdapter","ElectronStorageAdapter"],"mappings":"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","file":"chunk-SWZ5XNF6.js","sourcesContent":["/**\n * @package sa2kit/common/platform\n *\n * 跨平台运行时适配（storage / fetch / filePick）\n */\nexport type {\n  PlatformAdapter,\n  PlatformId,\n  FilePickAdapter,\n  FilePickOptions,\n  PickedFile,\n} from './types';\n\nexport {\n  createWebPlatformAdapter,\n  createTaroPlatformAdapter,\n  createElectronPlatformAdapter,\n  createNodeHonoPlatformAdapter,\n} from './adapters';\n","import { WebRequestAdapter } from '../../request/adapters/web-adapter';\nimport { WebStorageAdapter } from '../../storage/adapters/web-adapter';\nimport type {\n  FilePickAdapter,\n  FilePickOptions,\n  PlatformAdapter,\n  PickedFile,\n} from '../types';\n\nfunction createWebFilePickAdapter(): FilePickAdapter {\n  return {\n    async pickFiles(options?: FilePickOptions): Promise<PickedFile[]> {\n      if (typeof document === 'undefined') {\n        throw new Error('[PlatformAdapter:web] filePick 需要浏览器 document');\n      }\n\n      return new Promise((resolve, reject) => {\n        const input = document.createElement('input');\n        input.type = 'file';\n        input.style.display = 'none';\n        if (options?.accept) {\n          input.accept = options.accept;\n        }\n        if (options?.multiple) {\n          input.multiple = true;\n        }\n\n        input.onchange = () => {\n          const files = Array.from(input.files ?? []);\n          input.remove();\n          resolve(\n            files.map(file => ({\n              name: file.name,\n              mimeType: file.type || undefined,\n              size: file.size,\n              blob: file,\n            })),\n          );\n        };\n\n        input.oncancel = () => {\n          input.remove();\n          resolve([]);\n        };\n\n        document.body.appendChild(input);\n        input.click();\n        input.addEventListener('error', () => {\n          input.remove();\n          reject(new Error('[PlatformAdapter:web] filePick 失败'));\n        });\n      });\n    },\n  };\n}\n\n/** 浏览器 / Next.js CSR 官方 adapter */\nexport function createWebPlatformAdapter(\n  options: { filePick?: boolean } = {},\n): PlatformAdapter {\n  return {\n    storage: new WebStorageAdapter(),\n    fetch: new WebRequestAdapter(),\n    filePick: options.filePick === false ? undefined : createWebFilePickAdapter(),\n  };\n}\n","import type { PlatformAdapter } from '../types';\n\n/**\n * Taro 小程序 adapter 骨架（R2-222）\n *\n * 宿主需传入已初始化的 Taro storage / request 实现。\n */\nexport function createTaroPlatformAdapter(partial: PlatformAdapter): PlatformAdapter {\n  if (!partial.storage || !partial.fetch) {\n    throw new Error(\n      '[PlatformAdapter:taro] 请注入 storage 与 fetch（基于 Taro.getStorage / Taro.request）',\n    );\n  }\n  return {\n    storage: partial.storage,\n    fetch: partial.fetch,\n    filePick: partial.filePick,\n  };\n}\n","import { WebRequestAdapter } from '../../request/adapters/web-adapter';\nimport { ElectronStorageAdapter } from '../../storage/adapters/electron-adapter';\nimport { createWebPlatformAdapter } from './web';\nimport type { PlatformAdapter } from '../types';\n\n/**\n * Electron 桌面 adapter 骨架（R2-222）\n *\n * 默认复用 Web fetch + Electron storage；filePick 回退 Web input。\n */\nexport function createElectronPlatformAdapter(\n  options: { filePick?: boolean } = {},\n): PlatformAdapter {\n  try {\n    return {\n      storage: new ElectronStorageAdapter(),\n      fetch: new WebRequestAdapter(),\n      filePick:\n        options.filePick === false\n          ? undefined\n          : createWebPlatformAdapter({ filePick: true }).filePick,\n    };\n  } catch {\n    return createWebPlatformAdapter(options);\n  }\n}\n","import type { FilePickAdapter, PlatformAdapter } from '../types';\nimport type { RequestAdapter } from '../../request/types/types';\nimport type { StorageAdapter } from '../../storage/types';\n\n/** 内存 storage，适用于无持久化需求的 Node / Hono SSR */\nclass MemoryStorageAdapter implements StorageAdapter {\n  private readonly store = new Map<string, string>();\n\n  async getItem(key: string): Promise<string | null> {\n    return this.store.get(key) ?? null;\n  }\n\n  async setItem(key: string, value: string): Promise<void> {\n    this.store.set(key, value);\n  }\n\n  async removeItem(key: string): Promise<void> {\n    this.store.delete(key);\n  }\n}\n\n/** 基于全局 fetch 的 Node 请求适配器 */\nclass NodeFetchAdapter implements RequestAdapter {\n  async request<T>(config: {\n    url: string;\n    method?: string;\n    headers?: Record<string, string>;\n    body?: unknown;\n    params?: Record<string, unknown>;\n  }): Promise<T> {\n    let fullUrl = config.url;\n    if (config.params) {\n      const search = new URLSearchParams();\n      for (const [key, value] of Object.entries(config.params)) {\n        if (value !== undefined && value !== null) {\n          search.append(key, String(value));\n        }\n      }\n      const qs = search.toString();\n      if (qs) {\n        fullUrl += (fullUrl.includes('?') ? '&' : '?') + qs;\n      }\n    }\n\n    const response = await fetch(fullUrl, {\n      method: config.method ?? 'GET',\n      headers: {\n        'Content-Type': 'application/json',\n        ...config.headers,\n      },\n      body: config.body ? JSON.stringify(config.body) : undefined,\n    });\n\n    if (!response.ok) {\n      throw new Error(`[PlatformAdapter:node-hono] HTTP ${response.status}`);\n    }\n\n    return (await response.json()) as T;\n  }\n}\n\nconst unsupportedFilePick: FilePickAdapter = {\n  async pickFiles() {\n    throw new Error('[PlatformAdapter:node-hono] filePick 需在宿主注入');\n  },\n};\n\n/** Hono / Node API 官方 adapter 骨架（R2-222） */\nexport function createNodeHonoPlatformAdapter(\n  overrides: Partial<Pick<PlatformAdapter, 'storage' | 'fetch' | 'filePick'>> = {},\n): PlatformAdapter {\n  return {\n    storage: overrides.storage ?? new MemoryStorageAdapter(),\n    fetch: overrides.fetch ?? new NodeFetchAdapter(),\n    filePick: overrides.filePick ?? unsupportedFilePick,\n  };\n}\n"]}

package/dist/chunk-TNJ6LYX7.mjs

@@ -0,0 +1,18 @@
+import { createAuthClient } from 'better-auth/client';
+import { emailOTPClient, phoneNumberClient } from 'better-auth/client/plugins';
+
+// src/common/auth/client/create-auth-client.ts
+function buildSa2kitAuthClient(options) {
+  return createAuthClient({
+    baseURL: options.baseURL.replace(/\/+$/, ""),
+    basePath: options.basePath ?? "/api/auth",
+    plugins: [emailOTPClient(), phoneNumberClient()]
+  });
+}
+function createSa2kitAuthClient(options) {
+  return buildSa2kitAuthClient(options);
+}
+
+export { createSa2kitAuthClient };
+//# sourceMappingURL=chunk-TNJ6LYX7.mjs.map
+//# sourceMappingURL=chunk-TNJ6LYX7.mjs.map

package/dist/chunk-TNJ6LYX7.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/common/auth/client/create-auth-client.ts"],"names":[],"mappings":";;;;AAYA,SAAS,sBAAsB,OAAA,EAAkC;AAC/D,EAAA,OAAO,gBAAA,CAAiB;AAAA,IACtB,OAAA,EAAS,OAAA,CAAQ,OAAA,CAAQ,OAAA,CAAQ,QAAQ,EAAE,CAAA;AAAA,IAC3C,QAAA,EAAU,QAAQ,QAAA,IAAY,WAAA;AAAA,IAC9B,OAAA,EAAS,CAAC,cAAA,EAAe,EAAG,mBAAmB;AAAA,GAChD,CAAA;AACH;AAIO,SAAS,uBAAuB,OAAA,EAAoD;AACzF,EAAA,OAAO,sBAAsB,OAAO,CAAA;AACtC","file":"chunk-TNJ6LYX7.mjs","sourcesContent":["/**\n * Better Auth 客户端（vanilla — RN / 小程序 / Node fetch）\n */\nimport { createAuthClient } from 'better-auth/client';\nimport { emailOTPClient } from 'better-auth/client/plugins';\nimport { phoneNumberClient } from 'better-auth/client/plugins';\n\nexport type Sa2kitAuthClientOptions = {\n  baseURL: string;\n  basePath?: string;\n};\n\nfunction buildSa2kitAuthClient(options: Sa2kitAuthClientOptions) {\n  return createAuthClient({\n    baseURL: options.baseURL.replace(/\\/+$/, ''),\n    basePath: options.basePath ?? '/api/auth',\n    plugins: [emailOTPClient(), phoneNumberClient()],\n  });\n}\n\nexport type Sa2kitAuthClient = ReturnType<typeof buildSa2kitAuthClient>;\n\nexport function createSa2kitAuthClient(options: Sa2kitAuthClientOptions): Sa2kitAuthClient {\n  return buildSa2kitAuthClient(options);\n}\n"]}

package/dist/chunk-U7HNBCBS.js

@@ -0,0 +1,207 @@
+'use strict';
+
+var chunkKRBSTLKC_js = require('./chunk-KRBSTLKC.js');
+var chunkV7RLIZMN_js = require('./chunk-V7RLIZMN.js');
+
+// src/common/ossFile/server/config.ts
+function createOssFileConfigManager(options = {}) {
+  const { ossConfig, fallbackToLocal = true, customConfig } = options;
+  const manager = new chunkKRBSTLKC_js.FileServiceConfigManager(customConfig);
+  const resolvedOss = ossConfig ?? chunkKRBSTLKC_js.loadOSSConfigFromEnv();
+  if (chunkV7RLIZMN_js.isCompleteOssConfig(resolvedOss)) {
+    manager.enableStorageProvider("aliyun-oss", resolvedOss);
+    manager.updateConfig({ defaultStorage: "aliyun-oss" });
+    return manager;
+  }
+  if (fallbackToLocal) {
+    manager.enableStorageProvider("local");
+    manager.updateConfig({ defaultStorage: "local" });
+  }
+  return manager;
+}
+async function createOssFileConfigManagerFromEnv(customConfig) {
+  return chunkKRBSTLKC_js.createFileServiceConfigWithConfigManager(customConfig);
+}
+function getOssStorageModeLabel(config) {
+  const oss = config.storageProviders["aliyun-oss"];
+  if (oss?.enabled) {
+    return oss.customDomain ? "\u963F\u91CC\u4E91 OSS + \u81EA\u5B9A\u4E49\u57DF\u540D" : "\u963F\u91CC\u4E91 OSS";
+  }
+  return "\u672C\u5730\u5B58\u50A8";
+}
+function isOssEnabledInConfig(config) {
+  const oss = config.storageProviders["aliyun-oss"];
+  return Boolean(oss?.enabled);
+}
+
+// src/common/ossFile/server/service.ts
+async function createOssFileServiceWithDrizzlePersistence(options) {
+  const configManager = options.configManager ?? await createOssFileConfigManagerFromEnv();
+  const repository = chunkKRBSTLKC_js.createDrizzleFileRepository({
+    db: options.persistence.db,
+    fileMetadata: options.persistence.fileMetadata,
+    fileStorageProviders: options.persistence.fileStorageProviders
+  });
+  return createUniversalFileServiceFromConfigManager(configManager, repository);
+}
+async function resolveUploadAccessUrl(service, fileId, options) {
+  if (options?.cdnUrl) {
+    return options.cdnUrl;
+  }
+  try {
+    const url = await service.getFileUrl(fileId, options?.userId);
+    if (url) return url;
+  } catch {
+  }
+  return options?.fallbackPath ?? `/uploads/${fileId}`;
+}
+async function uploadFileAndResolveAccessUrl(service, uploadInfo, userId) {
+  const uploadResult = await service.uploadFile(uploadInfo);
+  const accessUrl = await resolveUploadAccessUrl(service, uploadResult.id, {
+    cdnUrl: uploadResult.cdnUrl,
+    userId,
+    fallbackPath: `/uploads/${uploadResult.storagePath}`
+  });
+  return {
+    fileId: uploadResult.id,
+    accessUrl,
+    uploadResult
+  };
+}
+async function createUniversalFileServiceFromConfigManager(configManager, repository) {
+  const config = configManager.getConfig();
+  const serviceConfig = {
+    storage: config.storageProviders[config.defaultStorage],
+    defaultStorage: config.defaultStorage,
+    defaultCDN: config.defaultCDN,
+    storageProviders: config.storageProviders,
+    cdnProviders: config.cdnProviders,
+    maxFileSize: config.maxFileSize,
+    allowedMimeTypes: config.allowedMimeTypes,
+    cache: {
+      enabled: true,
+      metadataTTL: config.cache.metadataTTL,
+      urlTTL: config.cache.urlTTL
+    },
+    ...repository ? {
+      persistence: {
+        enabled: true,
+        repository,
+        autoPersist: true
+      }
+    } : {}
+  };
+  const service = new chunkKRBSTLKC_js.UniversalFileService(serviceConfig);
+  await service.initialize();
+  return service;
+}
+async function getFileUrlByFileId(fileId, options) {
+  try {
+    if (options?.service) {
+      return await options.service.getFileUrl(fileId, options.userId);
+    }
+    if (options?.configManager) {
+      const service2 = await createUniversalFileServiceFromConfigManager(
+        options.configManager
+      );
+      return await service2.getFileUrl(fileId, options.userId);
+    }
+    const service = await chunkKRBSTLKC_js.createUniversalFileServiceWithConfigManager();
+    return await service.getFileUrl(fileId, options?.userId);
+  } catch {
+    return null;
+  }
+}
+async function resolveFileUrlMap(fileIds, options) {
+  const map = /* @__PURE__ */ new Map();
+  const uniqueIds = [...new Set(fileIds.filter(Boolean))];
+  await Promise.all(
+    uniqueIds.map(async (fileId) => {
+      let url;
+      if (options?.resolver) {
+        url = await options.resolver(fileId);
+      } else {
+        url = await getFileUrlByFileId(fileId, {
+          configManager: options?.configManager,
+          userId: options?.userId
+        });
+      }
+      if (url) {
+        map.set(fileId, url);
+      }
+    })
+  );
+  return map;
+}
+function createFileUrlResolver(options = {}) {
+  let configManagerPromise = null;
+  async function getConfigManager() {
+    if (options.configManager) {
+      return options.configManager;
+    }
+    if (options.loadConfigManager) {
+      configManagerPromise ?? (configManagerPromise = options.loadConfigManager());
+      return configManagerPromise;
+    }
+    configManagerPromise ?? (configManagerPromise = createOssFileConfigManagerFromEnv());
+    return configManagerPromise;
+  }
+  return async (fileId, userId) => getFileUrlByFileId(fileId, {
+    configManager: await getConfigManager(),
+    userId: userId ?? options.userId
+  });
+}
+async function createOssFileService(options = {}) {
+  return chunkKRBSTLKC_js.createFileServiceWithFactory({
+    configLoaders: [() => Promise.resolve(chunkKRBSTLKC_js.loadConfigFromEnv())],
+    autoInitialize: true,
+    ...options
+  });
+}
+
+// src/common/ossFile/server/bootstrap.ts
+function createOssFileBootstrap(options = {}) {
+  let configManagerPromise = null;
+  const getConfigManager = async () => {
+    configManagerPromise ?? (configManagerPromise = options.loadConfigManager?.() ?? createOssFileConfigManagerFromEnv());
+    return configManagerPromise;
+  };
+  return {
+    getConfigManager,
+    createFileService: async () => {
+      const configManager = await getConfigManager();
+      return createUniversalFileServiceFromConfigManager(configManager);
+    },
+    createPersistentFileService: async () => {
+      const configManager = await getConfigManager();
+      if (options.persistence) {
+        return createOssFileServiceWithDrizzlePersistence({
+          configManager,
+          persistence: options.persistence
+        });
+      }
+      return createUniversalFileServiceFromConfigManager(configManager);
+    },
+    createFileUrlResolver: () => createFileUrlResolver({ loadConfigManager: getConfigManager }),
+    getFileUrl: async (fileId, userId) => {
+      const configManager = await getConfigManager();
+      return getFileUrlByFileId(fileId, { configManager, userId });
+    }
+  };
+}
+
+exports.createFileUrlResolver = createFileUrlResolver;
+exports.createOssFileBootstrap = createOssFileBootstrap;
+exports.createOssFileConfigManager = createOssFileConfigManager;
+exports.createOssFileConfigManagerFromEnv = createOssFileConfigManagerFromEnv;
+exports.createOssFileService = createOssFileService;
+exports.createOssFileServiceWithDrizzlePersistence = createOssFileServiceWithDrizzlePersistence;
+exports.createUniversalFileServiceFromConfigManager = createUniversalFileServiceFromConfigManager;
+exports.getFileUrlByFileId = getFileUrlByFileId;
+exports.getOssStorageModeLabel = getOssStorageModeLabel;
+exports.isOssEnabledInConfig = isOssEnabledInConfig;
+exports.resolveFileUrlMap = resolveFileUrlMap;
+exports.resolveUploadAccessUrl = resolveUploadAccessUrl;
+exports.uploadFileAndResolveAccessUrl = uploadFileAndResolveAccessUrl;
+//# sourceMappingURL=chunk-U7HNBCBS.js.map
+//# sourceMappingURL=chunk-U7HNBCBS.js.map

package/dist/chunk-U7HNBCBS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/common/ossFile/server/config.ts","../src/common/ossFile/server/service.ts","../src/common/ossFile/server/bootstrap.ts"],"names":["FileServiceConfigManager","loadOSSConfigFromEnv","isCompleteOssConfig","createFileServiceConfigWithConfigManager","createDrizzleFileRepository","UniversalFileService","service","createUniversalFileServiceWithConfigManager","createFileServiceWithFactory","loadConfigFromEnv"],"mappings":"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","file":"chunk-U7HNBCBS.js","sourcesContent":["import type { AliyunOSSConfig } from '../../universalFile/server/types';\nimport type { FileServiceConfig } from '../../universalFile/server/config-manager';\nimport {\n  FileServiceConfigManager,\n  createFileServiceConfigWithConfigManager,\n} from '../../universalFile/server/config-manager';\nimport { loadOSSConfigFromEnv } from '../../universalFile/server/config-helpers';\nimport {\n  parseAliyunOssConfigFromMap,\n  isCompleteOssConfig,\n  STANDARD_ALIYUN_OSS_KEYS,\n  type OssConfigKeyMap,\n} from '../shared/ossConfig';\n\nexport {\n  STANDARD_ALIYUN_OSS_KEYS,\n  parseAliyunOssConfigFromMap,\n  type OssConfigKeyMap,\n};\n\nexport interface CreateOssFileConfigManagerOptions {\n  ossConfig?: AliyunOSSConfig | null;\n  fallbackToLocal?: boolean;\n  customConfig?: Partial<FileServiceConfig>;\n}\n\nexport function createOssFileConfigManager(\n  options: CreateOssFileConfigManagerOptions = {},\n): FileServiceConfigManager {\n  const { ossConfig, fallbackToLocal = true, customConfig } = options;\n  const manager = new FileServiceConfigManager(customConfig);\n\n  const resolvedOss = ossConfig ?? loadOSSConfigFromEnv();\n  if (isCompleteOssConfig(resolvedOss)) {\n    manager.enableStorageProvider('aliyun-oss', resolvedOss);\n    manager.updateConfig({ defaultStorage: 'aliyun-oss' });\n    return manager;\n  }\n\n  if (fallbackToLocal) {\n    manager.enableStorageProvider('local');\n    manager.updateConfig({ defaultStorage: 'local' });\n  }\n\n  return manager;\n}\n\nexport async function createOssFileConfigManagerFromEnv(\n  customConfig?: Partial<FileServiceConfig>,\n): Promise<FileServiceConfigManager> {\n  return createFileServiceConfigWithConfigManager(customConfig);\n}\n\nexport function getOssStorageModeLabel(config: FileServiceConfig): string {\n  const oss = config.storageProviders['aliyun-oss'] as AliyunOSSConfig | undefined;\n  if (oss?.enabled) {\n    return oss.customDomain\n      ? '阿里云 OSS + 自定义域名'\n      : '阿里云 OSS';\n  }\n  return '本地存储';\n}\n\nexport function isOssEnabledInConfig(config: FileServiceConfig): boolean {\n  const oss = config.storageProviders['aliyun-oss'];\n  return Boolean(oss?.enabled);\n}\n\n/** @deprecated 使用 createOssFileConfigManagerFromEnv */\nexport async function getShowMasterpieceFileConfig(): Promise<FileServiceConfigManager> {\n  return createOssFileConfigManagerFromEnv();\n}\n","import {\n  UniversalFileService,\n  createFileServiceWithFactory,\n  loadConfigFromEnv,\n  createDrizzleFileRepository,\n} from '../../universalFile/server';\nimport type { FileServiceFactoryOptions } from '../../universalFile/server/config-helpers';\nimport type { UploadFileInfo } from '../../universalFile/types';\nimport {\n  FileServiceConfigManager,\n  type FileServiceConfig,\n} from '../../universalFile/server/config-manager';\nimport { createUniversalFileServiceWithConfigManager } from '../../universalFile/server/service-helpers';\nimport { createOssFileConfigManagerFromEnv } from './config';\n\nexport { UniversalFileService, createUniversalFileServiceWithConfigManager };\n\nexport interface DrizzlePersistenceOptions {\n  db: unknown;\n  fileMetadata: unknown;\n  fileStorageProviders: unknown;\n}\n\nexport async function createOssFileServiceWithDrizzlePersistence(options: {\n  configManager?: FileServiceConfigManager;\n  persistence: DrizzlePersistenceOptions;\n}): Promise<UniversalFileService> {\n  const configManager = options.configManager\n    ?? await createOssFileConfigManagerFromEnv();\n  const repository = createDrizzleFileRepository({\n    db: options.persistence.db,\n    fileMetadata: options.persistence.fileMetadata,\n    fileStorageProviders: options.persistence.fileStorageProviders,\n  });\n  return createUniversalFileServiceFromConfigManager(configManager, repository);\n}\n\nexport async function resolveUploadAccessUrl(\n  service: UniversalFileService,\n  fileId: string,\n  options?: { cdnUrl?: string | null; userId?: string; fallbackPath?: string },\n): Promise<string> {\n  if (options?.cdnUrl) {\n    return options.cdnUrl;\n  }\n  try {\n    const url = await service.getFileUrl(fileId, options?.userId);\n    if (url) return url;\n  } catch {\n    // fall through\n  }\n  return options?.fallbackPath ?? `/uploads/${fileId}`;\n}\n\nexport async function uploadFileAndResolveAccessUrl(\n  service: UniversalFileService,\n  uploadInfo: UploadFileInfo,\n  userId?: string,\n): Promise<{ fileId: string; accessUrl: string; uploadResult: Awaited<ReturnType<UniversalFileService['uploadFile']>> }> {\n  const uploadResult = await service.uploadFile(uploadInfo);\n  const accessUrl = await resolveUploadAccessUrl(service, uploadResult.id, {\n    cdnUrl: uploadResult.cdnUrl,\n    userId,\n    fallbackPath: `/uploads/${uploadResult.storagePath}`,\n  });\n  return {\n    fileId: uploadResult.id,\n    accessUrl,\n    uploadResult,\n  };\n}\n\n/**\n * 基于配置管理器创建并初始化 UniversalFileService。\n */\nexport async function createUniversalFileServiceFromConfigManager(\n  configManager: FileServiceConfigManager,\n  repository?: unknown,\n): Promise<UniversalFileService> {\n  const config = configManager.getConfig();\n  const serviceConfig = {\n    storage: config.storageProviders[config.defaultStorage],\n    defaultStorage: config.defaultStorage,\n    defaultCDN: config.defaultCDN,\n    storageProviders: config.storageProviders,\n    cdnProviders: config.cdnProviders,\n    maxFileSize: config.maxFileSize,\n    allowedMimeTypes: config.allowedMimeTypes,\n    cache: {\n      enabled: true,\n      metadataTTL: config.cache.metadataTTL,\n      urlTTL: config.cache.urlTTL,\n    },\n    ...(repository\n      ? {\n          persistence: {\n            enabled: true,\n            repository,\n            autoPersist: true,\n          },\n        }\n      : {}),\n  };\n\n  const service = new UniversalFileService(serviceConfig as any);\n  await service.initialize();\n  return service;\n}\n\n/**\n * 通过 fileId 解析访问 URL（需已初始化的 UniversalFileService 或全局 ConfigManager）。\n */\nexport async function getFileUrlByFileId(\n  fileId: string,\n  options?: {\n    configManager?: FileServiceConfigManager;\n    service?: UniversalFileService;\n    userId?: string;\n  },\n): Promise<string | null> {\n  try {\n    if (options?.service) {\n      return await options.service.getFileUrl(fileId, options.userId);\n    }\n    if (options?.configManager) {\n      const service = await createUniversalFileServiceFromConfigManager(\n        options.configManager,\n      );\n      return await service.getFileUrl(fileId, options.userId);\n    }\n    const service = await createUniversalFileServiceWithConfigManager();\n    return await service.getFileUrl(fileId, options?.userId);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * 批量解析 fileId → URL。\n */\nexport async function resolveFileUrlMap(\n  fileIds: string[],\n  options?: {\n    resolver?: (fileId: string) => Promise<string | null | undefined>;\n    configManager?: FileServiceConfigManager;\n    userId?: string;\n  },\n): Promise<Map<string, string>> {\n  const map = new Map<string, string>();\n  const uniqueIds = [...new Set(fileIds.filter(Boolean))];\n\n  await Promise.all(\n    uniqueIds.map(async (fileId) => {\n      let url: string | null | undefined;\n      if (options?.resolver) {\n        url = await options.resolver(fileId);\n      } else {\n        url = await getFileUrlByFileId(fileId, {\n          configManager: options?.configManager,\n          userId: options?.userId,\n        });\n      }\n      if (url) {\n        map.set(fileId, url);\n      }\n    }),\n  );\n\n  return map;\n}\n\nexport type FileUrlResolver = (\n  fileId: string,\n  userId?: string,\n) => Promise<string | null | undefined>;\n\nexport interface CreateFileUrlResolverOptions {\n  configManager?: FileServiceConfigManager;\n  loadConfigManager?: () => Promise<FileServiceConfigManager>;\n  userId?: string;\n}\n\n/**\n * 显式创建 fileId → URL 解析器（替代 globalThis 单例，R2-203）。\n */\nexport function createFileUrlResolver(\n  options: CreateFileUrlResolverOptions = {},\n): FileUrlResolver {\n  let configManagerPromise: Promise<FileServiceConfigManager> | null = null;\n\n  async function getConfigManager(): Promise<FileServiceConfigManager> {\n    if (options.configManager) {\n      return options.configManager;\n    }\n    if (options.loadConfigManager) {\n      configManagerPromise ??= options.loadConfigManager();\n      return configManagerPromise;\n    }\n    configManagerPromise ??= createOssFileConfigManagerFromEnv();\n    return configManagerPromise;\n  }\n\n  return async (fileId: string, userId?: string) =>\n    getFileUrlByFileId(fileId, {\n      configManager: await getConfigManager(),\n      userId: userId ?? options.userId,\n    });\n}\n\nexport async function createOssFileService(\n  options: FileServiceFactoryOptions = {},\n): Promise<UniversalFileService> {\n  return createFileServiceWithFactory({\n    configLoaders: [() => Promise.resolve(loadConfigFromEnv())],\n    autoInitialize: true,\n    ...options,\n  });\n}\n\nexport type { FileServiceConfig, FileServiceConfigManager };\n","import type { FileServiceConfigManager } from '../../universalFile/server/config-manager';\nimport type { UniversalFileService } from '../../universalFile/server';\nimport { createOssFileConfigManagerFromEnv } from './config';\nimport {\n  createOssFileServiceWithDrizzlePersistence,\n  createUniversalFileServiceFromConfigManager,\n  createFileUrlResolver,\n  getFileUrlByFileId,\n  type DrizzlePersistenceOptions,\n  type FileUrlResolver,\n} from './service';\n\nexport interface OssFileBootstrapOptions {\n  /** 自定义配置加载（如从 DB 注入 env 后再 createOssFileConfigManagerFromEnv） */\n  loadConfigManager?: () => Promise<FileServiceConfigManager>;\n  /** Drizzle 持久化；传入后 createPersistentFileService 会写入 file_metadata */\n  persistence?: DrizzlePersistenceOptions;\n}\n\nexport interface OssFileBootstrap {\n  getConfigManager(): Promise<FileServiceConfigManager>;\n  /** 无 Drizzle 持久化的 UniversalFileService（如 skill-manager 自行写 metadata） */\n  createFileService(): Promise<UniversalFileService>;\n  createPersistentFileService(): Promise<UniversalFileService>;\n  createFileUrlResolver(): FileUrlResolver;\n  getFileUrl(fileId: string, userId?: string): Promise<string | null>;\n}\n\n/**\n * 一站式 OSS / universal-file 服务端 bootstrap（R2-205）。\n */\nexport function createOssFileBootstrap(\n  options: OssFileBootstrapOptions = {},\n): OssFileBootstrap {\n  let configManagerPromise: Promise<FileServiceConfigManager> | null = null;\n\n  const getConfigManager = async (): Promise<FileServiceConfigManager> => {\n    configManagerPromise ??=\n      options.loadConfigManager?.() ?? createOssFileConfigManagerFromEnv();\n    return configManagerPromise;\n  };\n\n  return {\n    getConfigManager,\n    createFileService: async () => {\n      const configManager = await getConfigManager();\n      return createUniversalFileServiceFromConfigManager(configManager);\n    },\n    createPersistentFileService: async () => {\n      const configManager = await getConfigManager();\n      if (options.persistence) {\n        return createOssFileServiceWithDrizzlePersistence({\n          configManager,\n          persistence: options.persistence,\n        });\n      }\n      return createUniversalFileServiceFromConfigManager(configManager);\n    },\n    createFileUrlResolver: () =>\n      createFileUrlResolver({ loadConfigManager: getConfigManager }),\n    getFileUrl: async (fileId, userId) => {\n      const configManager = await getConfigManager();\n      return getFileUrlByFileId(fileId, { configManager, userId });\n    },\n  };\n}\n"]}

package/dist/chunk-UJS3YSD3.mjs

@@ -0,0 +1,37 @@
+// src/common/universalFile/types.ts
+var FileServiceError = class extends Error {
+  constructor(message, code, details) {
+    super(message);
+    this.code = code;
+    this.details = details;
+    this.name = "FileServiceError";
+  }
+};
+var FileUploadError = class extends FileServiceError {
+  constructor(message, details) {
+    super(message, "FILE_UPLOAD_ERROR", details);
+    this.name = "FileUploadError";
+  }
+};
+var FileProcessingError = class extends FileServiceError {
+  constructor(message, details) {
+    super(message, "FILE_PROCESSING_ERROR", details);
+    this.name = "FileProcessingError";
+  }
+};
+var StorageProviderError = class extends FileServiceError {
+  constructor(message, details) {
+    super(message, "STORAGE_PROVIDER_ERROR", details);
+    this.name = "StorageProviderError";
+  }
+};
+var CDNProviderError = class extends FileServiceError {
+  constructor(message, details) {
+    super(message, "CDN_PROVIDER_ERROR", details);
+    this.name = "CDNProviderError";
+  }
+};
+
+export { CDNProviderError, FileProcessingError, FileServiceError, FileUploadError, StorageProviderError };
+//# sourceMappingURL=chunk-UJS3YSD3.mjs.map
+//# sourceMappingURL=chunk-UJS3YSD3.mjs.map

package/dist/chunk-UJS3YSD3.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/common/universalFile/types.ts"],"names":[],"mappings":";AAmSO,IAAM,gBAAA,GAAN,cAA+B,KAAA,CAAM;AAAA,EAC1C,WAAA,CACE,OAAA,EACgB,IAAA,EACA,OAAA,EAChB;AACA,IAAA,KAAA,CAAM,OAAO,CAAA;AAHG,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AACA,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AAGhB,IAAA,IAAA,CAAK,IAAA,GAAO,kBAAA;AAAA,EACd;AACF;AAGO,IAAM,eAAA,GAAN,cAA8B,gBAAA,CAAiB;AAAA,EACpD,WAAA,CAAY,SAAiB,OAAA,EAA+B;AAC1D,IAAA,KAAA,CAAM,OAAA,EAAS,qBAAqB,OAAO,CAAA;AAC3C,IAAA,IAAA,CAAK,IAAA,GAAO,iBAAA;AAAA,EACd;AACF;AAGO,IAAM,mBAAA,GAAN,cAAkC,gBAAA,CAAiB;AAAA,EACxD,WAAA,CAAY,SAAiB,OAAA,EAA+B;AAC1D,IAAA,KAAA,CAAM,OAAA,EAAS,yBAAyB,OAAO,CAAA;AAC/C,IAAA,IAAA,CAAK,IAAA,GAAO,qBAAA;AAAA,EACd;AACF;AAGO,IAAM,oBAAA,GAAN,cAAmC,gBAAA,CAAiB;AAAA,EACzD,WAAA,CAAY,SAAiB,OAAA,EAA+B;AAC1D,IAAA,KAAA,CAAM,OAAA,EAAS,0BAA0B,OAAO,CAAA;AAChD,IAAA,IAAA,CAAK,IAAA,GAAO,sBAAA;AAAA,EACd;AACF;AAGO,IAAM,gBAAA,GAAN,cAA+B,gBAAA,CAAiB;AAAA,EACrD,WAAA,CAAY,SAAiB,OAAA,EAA+B;AAC1D,IAAA,KAAA,CAAM,OAAA,EAAS,sBAAsB,OAAO,CAAA;AAC5C,IAAA,IAAA,CAAK,IAAA,GAAO,kBAAA;AAAA,EACd;AACF","file":"chunk-UJS3YSD3.mjs","sourcesContent":["/**\n * 通用文件服务类型定义\n *\n * 定义了文件存储、上传、下载等核心接口和类型\n */\n\n// ============= 基础类型定义 =============\n\n/** 文件存储类型 */\nexport type StorageType = 'local' | 'aliyun-oss' | 'aws-s3' | 'qcloud-cos';\n\n/** CDN提供者类型 */\nexport type CDNType = 'none' | 'aliyun-cdn' | 'aws-cloudfront' | 'qcloud-cdn';\n\n/** 文件处理类型 */\nexport type ProcessorType = 'image' | 'audio' | 'video' | 'document';\n\n/** 文件上传状态 */\nexport type UploadStatus = 'pending' | 'uploading' | 'processing' | 'completed' | 'failed';\n\n/** 访问权限类型 */\nexport type AccessPermission = 'public' | 'private' | 'authenticated' | 'owner-only';\n\n// ============= 文件元数据接口 =============\n\n/** 文件元数据基础接口 */\nexport interface FileMetadata {\n  /** 文件ID */\n  id: string;\n  /** 原始文件名 */\n  originalName: string;\n  /** 存储文件名 */\n  storageName: string;\n  /** 文件大小(字节) */\n  size: number;\n  /** MIME类型 */\n  mimeType: string;\n  /** 文件扩展名 */\n  extension: string;\n  /** 文件哈希值 */\n  hash?: string;\n  /** 上传时间 */\n  uploadTime: Date;\n  /** 访问权限 */\n  permission: AccessPermission;\n  /** 上传者ID */\n  uploaderId: string;\n  /** 模块标识 */\n  moduleId: string;\n  /** 业务标识 */\n  businessId?: string;\n  /** 存储提供者 */\n  storageProvider: StorageType;\n  /** 存储路径 */\n  storagePath: string;\n  /** CDN URL */\n  cdnUrl?: string;\n  /** 访问次数 */\n  accessCount: number;\n  /** 最后访问时间 */\n  lastAccessTime?: Date;\n  /** 过期时间 */\n  expiresAt?: Date;\n  /** 自定义元数据 */\n  metadata?: Record<string, any>;\n}\n\n/** 上传文件信息（客户端使用） */\nexport interface UploadFileInfo {\n  /** 文件对象 */\n  file: File;\n  /** 模块标识 */\n  moduleId: string;\n  /** 业务标识 */\n  businessId?: string;\n  /** 访问权限 */\n  permission?: AccessPermission;\n  /** 自定义存储路径 */\n  customPath?: string;\n  /** 自定义元数据 */\n  metadata?: Record<string, any>;\n  /** 是否需要处理 */\n  needsProcessing?: boolean;\n  /** 处理选项 */\n  processingOptions?: ProcessingOptions;\n}\n\n/** 文件处理选项基础接口 */\nexport interface ProcessingOptions {\n  /** 处理器类型 */\n  type: ProcessorType;\n  /** 处理参数 */\n  params?: Record<string, any>;\n}\n\n/** 图片处理选项 */\nexport interface ImageProcessingOptions extends ProcessingOptions {\n  type: 'image';\n  /** 压缩质量 0-100 */\n  quality?: number;\n  /** 目标宽度 */\n  width?: number;\n  /** 目标高度 */\n  height?: number;\n  /** 格式转换 */\n  format?: 'jpeg' | 'png' | 'webp' | 'avif';\n  /** 是否添加水印 */\n  watermark?: boolean;\n  /** 水印配置 */\n  watermarkOptions?: {\n    text?: string;\n    image?: string;\n    position?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'center';\n    opacity?: number;\n  };\n}\n\n/** 音频处理选项 */\nexport interface AudioProcessingOptions extends ProcessingOptions {\n  type: 'audio';\n  /** 比特率 */\n  bitrate?: number;\n  /** 格式转换 */\n  format?: 'mp3' | 'wav' | 'ogg' | 'aac';\n  /** 采样率 */\n  sampleRate?: number;\n  /** 声道数 */\n  channels?: number;\n}\n\n/** 视频处理选项 */\nexport interface VideoProcessingOptions extends ProcessingOptions {\n  type: 'video';\n  /** 视频质量 */\n  quality?: number;\n  /** 格式转换 */\n  format?: 'mp4' | 'avi' | 'mov' | 'webm';\n  /** 生成缩略图 */\n  generateThumbnail?: boolean;\n  /** 缩略图时间点(秒) */\n  thumbnailTime?: number;\n}\n\n// ============= 上传相关接口 =============\n\n/** 上传进度 */\nexport interface UploadProgress {\n  /** 文件ID */\n  fileId: string;\n  /** 上传状态 */\n  status: UploadStatus;\n  /** 进度百分比(0-100) */\n  progress: number;\n  /** 已上传字节数 */\n  uploadedBytes: number;\n  /** 总字节数 */\n  totalBytes: number;\n  /** 上传速度(字节/秒) */\n  speed: number;\n  /** 剩余时间(秒) */\n  remainingTime: number;\n  /** 错误信息 */\n  error?: string;\n}\n\n/** 上传结果 */\nexport interface UploadResult {\n  /** 是否成功 */\n  success: boolean;\n  /** 文件元数据 */\n  file?: FileMetadata;\n  /** 文件访问URL */\n  url?: string;\n  /** 错误信息 */\n  error?: string;\n}\n\n/** 批量操作结果 */\nexport interface BatchOperationResult {\n  /** 成功数量 */\n  successCount: number;\n  /** 失败数量 */\n  failureCount: number;\n  /** 失败详情 */\n  failures: Array<{\n    fileId: string;\n    error: string;\n  }>;\n}\n\n// ============= 查询相关接口 =============\n\n/** 文件查询选项 */\nexport interface FileQueryOptions {\n  /** 模块标识 */\n  moduleId?: string;\n  /** 业务标识 */\n  businessId?: string;\n  /** 上传者ID */\n  uploaderId?: string;\n  /** MIME类型过滤 */\n  mimeType?: string;\n  /** 最小文件大小 */\n  minSize?: number;\n  /** 最大文件大小 */\n  maxSize?: number;\n  /** 开始时间 */\n  startTime?: Date;\n  /** 结束时间 */\n  endTime?: Date;\n  /** 搜索关键词 */\n  keyword?: string;\n  /** 标签 */\n  tags?: string[];\n  /** 排序字段 */\n  sortBy?: string;\n  /** 排序方向 */\n  sortOrder?: 'asc' | 'desc';\n  /** 页码 */\n  page?: number;\n  /** 每页数量 */\n  pageSize?: number;\n}\n\n/** 分页结果 */\nexport interface PaginatedResult<T> {\n  /** 数据项 */\n  items: T[];\n  /** 总数 */\n  total: number;\n  /** 当前页码 */\n  page: number;\n  /** 每页数量 */\n  pageSize: number;\n  /** 总页数 */\n  totalPages: number;\n  /** 是否有下一页 */\n  hasNext: boolean;\n  /** 是否有上一页 */\n  hasPrev: boolean;\n}\n\n/** 批量操作结果 */\nexport interface BatchOperationResult {\n  /** 成功数量 */\n  successCount: number;\n  /** 失败数量 */\n  failureCount: number;\n  /** 失败详情 */\n  failures: Array<{\n    fileId: string;\n    error: string;\n  }>;\n}\n\n// ============= 事件相关接口 =============\n\n/** 文件事件类型 */\nexport type FileEventType =\n  | 'upload:start'\n  | 'upload:progress'\n  | 'upload:complete'\n  | 'upload:error'\n  | 'download:start'\n  | 'download:complete'\n  | 'download:error'\n  | 'delete:complete'\n  | 'processing:start'\n  | 'processing:complete'\n  | 'processing:error';\n\n/** 文件事件 */\nexport interface FileEvent {\n  /** 事件类型 */\n  type: FileEventType;\n  /** 文件ID */\n  fileId: string;\n  /** 事件时间 */\n  timestamp: Date;\n  /** 事件数据 */\n  data?: Record<string, any>;\n  /** 错误信息 */\n  error?: string;\n}\n\n/** 文件事件监听器 */\nexport type FileEventListener = (event: FileEvent) => void | Promise<void>;\n\n// ============= 异常类定义 =============\n\n/** 文件服务基础异常 */\nexport class FileServiceError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly details?: Record<string, any>\n  ) {\n    super(message);\n    this.name = 'FileServiceError';\n  }\n}\n\n/** 文件上传错误 */\nexport class FileUploadError extends FileServiceError {\n  constructor(message: string, details?: Record<string, any>) {\n    super(message, 'FILE_UPLOAD_ERROR', details);\n    this.name = 'FileUploadError';\n  }\n}\n\n/** 文件处理错误 */\nexport class FileProcessingError extends FileServiceError {\n  constructor(message: string, details?: Record<string, any>) {\n    super(message, 'FILE_PROCESSING_ERROR', details);\n    this.name = 'FileProcessingError';\n  }\n}\n\n/** 存储提供者错误 */\nexport class StorageProviderError extends FileServiceError {\n  constructor(message: string, details?: Record<string, any>) {\n    super(message, 'STORAGE_PROVIDER_ERROR', details);\n    this.name = 'StorageProviderError';\n  }\n}\n\n/** CDN提供者错误 */\nexport class CDNProviderError extends FileServiceError {\n  constructor(message: string, details?: Record<string, any>) {\n    super(message, 'CDN_PROVIDER_ERROR', details);\n    this.name = 'CDNProviderError';\n  }\n}\n\n"]}