create-pardx-scaffold 0.1.0 → 0.1.2

package/template/apps/web/lib/logger.ts

@@ -0,0 +1,113 @@
+/**
+ * Frontend Logger
+ *
+ * 浏览器兼容的日志库，替代 console.log
+ * 支持日志级别控制和生产环境静默
+ */
+
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+
+interface LoggerConfig {
+  level: LogLevel;
+  prefix?: string;
+  enableInProduction?: boolean;
+}
+
+const LOG_LEVELS: Record<LogLevel, number> = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3,
+};
+
+class Logger {
+  private level: LogLevel;
+  private prefix: string;
+  private enableInProduction: boolean;
+
+  constructor(config: Partial<LoggerConfig> = {}) {
+    this.level = config.level ?? this.getDefaultLevel();
+    this.prefix = config.prefix ?? '[App]';
+    this.enableInProduction = config.enableInProduction ?? false;
+  }
+
+  private getDefaultLevel(): LogLevel {
+    if (typeof window === 'undefined') {
+      return 'info';
+    }
+    return process.env.NODE_ENV === 'production' ? 'warn' : 'debug';
+  }
+
+  private shouldLog(level: LogLevel): boolean {
+    // 在生产环境中，除非明确启用，否则只记录 warn 和 error
+    if (
+      process.env.NODE_ENV === 'production' &&
+      !this.enableInProduction &&
+      LOG_LEVELS[level] < LOG_LEVELS.warn
+    ) {
+      return false;
+    }
+    return LOG_LEVELS[level] >= LOG_LEVELS[this.level];
+  }
+
+  private formatMessage(level: LogLevel, message: string): string {
+    const timestamp = new Date().toISOString();
+    return `${timestamp} ${this.prefix} [${level.toUpperCase()}] ${message}`;
+  }
+
+  debug(message: string, ...args: unknown[]): void {
+    if (this.shouldLog('debug')) {
+      console.debug(this.formatMessage('debug', message), ...args);
+    }
+  }
+
+  info(message: string, ...args: unknown[]): void {
+    if (this.shouldLog('info')) {
+      console.info(this.formatMessage('info', message), ...args);
+    }
+  }
+
+  warn(message: string, ...args: unknown[]): void {
+    if (this.shouldLog('warn')) {
+      console.warn(this.formatMessage('warn', message), ...args);
+    }
+  }
+
+  error(message: string, ...args: unknown[]): void {
+    if (this.shouldLog('error')) {
+      console.error(this.formatMessage('error', message), ...args);
+    }
+  }
+
+  /**
+   * 设置日志级别
+   */
+  setLevel(level: LogLevel): void {
+    this.level = level;
+  }
+
+  /**
+   * 创建带有自定义前缀的子 logger
+   */
+  child(prefix: string): Logger {
+    return new Logger({
+      level: this.level,
+      prefix: `${this.prefix}:${prefix}`,
+      enableInProduction: this.enableInProduction,
+    });
+  }
+}
+
+// 默认 logger 实例
+export const logger = new Logger();
+
+// 创建模块专用 logger
+export const createLogger = (prefix: string): Logger => {
+  return logger.child(prefix);
+};
+
+// 导出类型
+export type { LogLevel, LoggerConfig };
+export { Logger };
+
+export default logger;

package/template/apps/web/lib/upload/api.ts

@@ -1,5 +1,13 @@
 import { uploaderClient } from '../api/contracts/client';
 import { UploadError, UploadErrorCode } from './errors';
+import type {
+  FileSourceResponse,
+  TokenResponse,
+  UploadMetadata,
+} from '@repo/contracts';
+
+// Re-export UploadMetadata type from contracts
+export type { UploadMetadata };
 
 // Helper function: extract error message from response (for logging only)
 function getErrorMsg(body: unknown, defaultMsg: string): string {
@@ -14,87 +22,38 @@ function getErrorMsg(body: unknown, defaultMsg: string): string {
   return defaultMsg;
 }
 
-// Type guard for folderId
-type FolderId = 'root' | `${string}-${string}-${string}-${string}-${string}`;
-
-function isValidFolderId(id: string): id is FolderId {
-  return (
-    id === 'root' ||
-    /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(id)
-  );
-}
-
 /**
- * 上传元数据（用于秒传后处理）
- */
-export interface UploadMetadata {
-  jobDescriptionId?: string; // 简历上传使用
-  meetingId?: string; // 会议录音上传使用
-  autoParse?: boolean; // 是否自动触发解析
-}
-
-/**
- * 获取私有上传 Token
+ * 获取私有上传 Token 参数
  */
 export interface GetUploadTokenParams {
   filename: string;
   signature: string;
   fsize: number;
-  folderId: string;
-  spaceId: string;
   thumbImg?: string;
-  domain?: string;
+  sha256?: string;
   metadata?: UploadMetadata;
 }
 
-export interface FileSystem {
-  id: string;
-  name: string;
-  type: string;
-  spaceId: string;
-  parentId: string | null;
-  fsize: number;
-  url?: string;
-  fileKeyId?: string;
-  origin?: string;
-  createdAt?: string;
-  updatedAt?: string;
-}
-
-export interface UploadTokenData {
-  // 文件不存在时返回的字段
-  token?: string;
-  key?: string;
-  fileId?: string;
-
-  // 文件已存在（秒传）时返回的字段
-  success?: boolean;
-  fileSystem?: FileSystem;
-  space?: Record<string, unknown>;
-  parent?: Record<string, unknown>;
-  usage?: Record<string, unknown>;
-}
+/**
+ * 上传 Token 响应数据
+ */
+export type UploadTokenData = TokenResponse;
 
 export async function getUploadTokenPrivate(
   params: GetUploadTokenParams,
 ): Promise<UploadTokenData> {
-  if (!isValidFolderId(params.folderId)) {
-    throw new UploadError(
-      UploadErrorCode.GET_UPLOAD_TOKEN_FAILED,
-      'Invalid folderId format',
-    );
-  }
-
   const response = await uploaderClient.getPrivateToken({
     body: {
       filename: params.filename,
       signature: params.signature,
       fsize: params.fsize,
+      sha256: params.sha256,
+      metadata: params.metadata,
     },
   });
 
   if (response.status === 200) {
-    return response.body.data as UploadTokenData;
+    return response.body.data;
   }
 
   console.error(getErrorMsg(response.body, 'Failed to get upload token'));
@@ -102,49 +61,36 @@ export async function getUploadTokenPrivate(
 }
 
 /**
- * 初始化分片上传
+ * 初始化分片上传参数
  */
 export interface InitMultipartUploadParams {
   signature: string;
   filename: string;
   fsize: number;
-  spaceId: string;
-  folderId: string;
+  sha256?: string;
   metadata?: UploadMetadata;
 }
 
-export interface InitMultipartUploadData {
-  uploadId?: string; // 秒传时可能没有 uploadId
-  fileId: string;
-  key: string;
-  spaceId: string;
-  // 秒传时可能返回完整的文件信息
-  success?: boolean;
-  fileSystem?: FileSystem;
-  space?: Record<string, unknown>;
-  parent?: Record<string, unknown>;
-}
+/**
+ * 初始化分片上传响应数据
+ */
+export type InitMultipartUploadData = TokenResponse;
 
 export async function initMultipartUpload(
   params: InitMultipartUploadParams,
 ): Promise<InitMultipartUploadData> {
-  if (!isValidFolderId(params.folderId)) {
-    throw new UploadError(
-      UploadErrorCode.INIT_MULTIPART_FAILED,
-      'Invalid folderId format',
-    );
-  }
-
   const response = await uploaderClient.initMultipart({
     body: {
       signature: params.signature,
       filename: params.filename,
       fsize: params.fsize,
+      sha256: params.sha256,
+      metadata: params.metadata,
     },
   });
 
   if (response.status === 200) {
-    return response.body.data as InitMultipartUploadData;
+    return response.body.data;
   }
 
   console.error(getErrorMsg(response.body, 'Failed to init multipart upload'));
@@ -152,7 +98,7 @@ export async function initMultipartUpload(
 }
 
 /**
- * 获取分片上传 Token
+ * 获取分片上传 Token 参数
  */
 export interface GetChunkUploadTokenParams {
   signature: string;
@@ -160,11 +106,12 @@ export interface GetChunkUploadTokenParams {
   uploadId: string;
   partNumber: number;
   fsize: number;
-  spaceId: string;
-  folderId: string;
   key: string;
 }
 
+/**
+ * 分片上传 Token 响应数据
+ */
 export interface ChunkUploadTokenData {
   token: string;
 }
@@ -192,30 +139,17 @@ export async function getChunkUploadToken(
 }
 
 /**
- * 完成上传
+ * 完成上传参数
  */
 export interface CompleteUploadParams {
   signature: string;
-  filename: string;
   fileId: string;
-  fsize: number;
-  spaceId: string;
-  uploadId?: string;
-  parts?: Array<{ ETag: string; PartNumber: number }>;
-  key?: string;
-  thumbImg?: string;
-  metadata?: UploadMetadata;
 }
 
-export interface CompleteUploadData {
-  data?: {
-    url?: string;
-    origin?: string;
-    fileSystem?: FileSystem;
-  };
-  fileSystem?: FileSystem;
-  success?: boolean;
-}
+/**
+ * 完成上传响应数据
+ */
+export type CompleteUploadData = FileSourceResponse;
 
 export async function completeUpload(
   params: CompleteUploadParams,
@@ -228,7 +162,7 @@ export async function completeUpload(
   });
 
   if (response.status === 200) {
-    return response.body.data as CompleteUploadData;
+    return response.body.data;
   }
 
   console.error(getErrorMsg(response.body, 'Failed to complete upload'));
@@ -236,12 +170,10 @@ export async function completeUpload(
 }
 
 /**
- * 取消上传
+ * 取消上传参数
  */
 export interface AbortUploadParams {
   signature: string;
-  uploadId: string;
-  spaceId: string;
   fileId: string;
 }
 

package/template/apps/web/lib/upload/batch-uploader.ts

@@ -29,8 +29,6 @@ export interface BatchUploadProgress {
 }
 
 export interface BatchUploadOptions {
-  spaceId: string;
-  folderId: string;
   files: File[];
   metadata?: UploadMetadata;
   onProgress?: (progress: BatchUploadProgress) => void;
@@ -47,39 +45,11 @@ const MAX_CONCURRENT_UPLOADS = 3;
 
 /**
  * 批量上传文件（带并发控制）
- * 支持素材空间和简历空间上传
  */
-export function uploadFiles(
-  options: BatchUploadOptions,
-): Promise<{ success: number; failed: number }>;
-/**
- * @deprecated 使用 uploadFiles(options) 代替
- */
-export function uploadFiles(
-  spaceId: string,
-  folderId: string,
-  files: File[],
-  onProgress?: (progress: BatchUploadProgress) => void,
-): Promise<{ success: number; failed: number }>;
 export async function uploadFiles(
-  optionsOrSpaceId: BatchUploadOptions | string,
-  folderIdArg?: string,
-  filesArg?: File[],
-  onProgressArg?: (progress: BatchUploadProgress) => void,
+  options: BatchUploadOptions,
 ): Promise<{ success: number; failed: number }> {
-  // 兼容旧的调用方式
-  const options: BatchUploadOptions =
-    typeof optionsOrSpaceId === 'string'
-      ? {
-          spaceId: optionsOrSpaceId,
-          folderId: folderIdArg!,
-          files: filesArg!,
-          onProgress: onProgressArg,
-        }
-      : optionsOrSpaceId;
-
-  const { spaceId, folderId, files, metadata, onProgress, onFileComplete } =
-    options;
+  const { files, metadata, onProgress, onFileComplete } = options;
 
   if (files.length === 0) {
     return { success: 0, failed: 0 };
@@ -138,8 +108,6 @@ export async function uploadFiles(
 
         const result = await uploadFile({
           file,
-          folderId,
-          spaceId,
           metadata,
           callbacks: {
             onCalculating: (progress) => {
@@ -173,18 +141,14 @@ export async function uploadFiles(
               updateProgress();
             },
             onComplete: (completeResult) => {
-              // 检查是否为秒传
-              const isInstant = isInstantUploadResult(completeResult);
-
-              // 从完成结果中提取 fileId（秒传时特别重要）
+              // 从完成结果中提取 fileId
               const completedFileId = getFileIdFromResult(completeResult);
               if (completedFileId) {
                 fileProgress.fileId = completedFileId;
               }
 
-              fileProgress.status = isInstant ? 'instant' : 'success';
+              fileProgress.status = 'success';
               fileProgress.progress = 100;
-              fileProgress.isInstantUpload = isInstant;
               fileProgress.uploadSpeed = undefined;
               completedCount++;
               updateProgress();
@@ -211,9 +175,8 @@ export async function uploadFiles(
         }
 
         // 调用文件完成回调
-        const isInstant = isInstantUploadResult(result);
         if (fileProgress.fileId) {
-          onFileComplete?.(file, fileProgress.fileId, result, isInstant);
+          onFileComplete?.(file, fileProgress.fileId, result, false);
         }
 
         return { success: true };
@@ -246,41 +209,11 @@ export async function uploadFiles(
  * 从上传结果中提取文件 ID
  */
 function getFileIdFromResult(result: UploadResult): string | null {
-  if ('fileSystem' in result && result.fileSystem?.id) {
-    return result.fileSystem.id;
+  if ('id' in result && result.id) {
+    return result.id;
   }
   if ('fileId' in result && result.fileId) {
     return result.fileId;
   }
-  if ('data' in result && result.data?.fileSystem?.id) {
-    return result.data.fileSystem.id;
-  }
   return null;
 }
-
-/**
- * 检查上传结果是否为秒传
- * 秒传的判断条件：
- * 1. fileSystem 存在（文件已存在）
- * 2. 满足以下任一条件：
- *    - success === true（普通上传秒传）
- *    - uploadId 不存在或为空（大文件分片上传秒传）
- */
-function isInstantUploadResult(result: UploadResult): boolean {
-  // 必须有 fileSystem 才可能是秒传
-  if (!('fileSystem' in result) || !result.fileSystem) {
-    return false;
-  }
-
-  // 普通上传秒传：success === true
-  if ('success' in result && result.success === true) {
-    return true;
-  }
-
-  // 大文件分片上传秒传：uploadId 不存在或为空
-  if (!('uploadId' in result) || !result.uploadId) {
-    return true;
-  }
-
-  return false;
-}