@lcap/wave-sandbox-sdk 0.0.1 → 0.0.2

package/README.md

@@ -232,6 +232,28 @@ items.forEach(([name, type]) => {
 });
 ```
 
+##### `files(dirPath: string): Promise<Record<string, ProjectFile>>`
+
+获取指定目录下的所有文件（递归）。
+
+**参数：**
+- `dirPath`: 目录路径
+
+**返回：** Promise<Record<string, ProjectFile>> 文件路径到文件信息的映射
+
+**示例：**
+```typescript
+const files = await client.fs.files('.');
+Object.entries(files).forEach(([path, file]) => {
+  console.log(`文件路径: ${path}`);
+  console.log(`文件名: ${file.name}`);
+  console.log(`MIME类型: ${file.type}`);
+  console.log(`是否二进制: ${file.isBinary}`);
+  console.log(`最后修改时间: ${new Date(file.lastModified)}`);
+  console.log(`文件大小: ${file.size} 字节`);
+});
+```
+
 ##### `writeFile(filePath: string, data: string | Blob | ArrayBuffer | Uint8Array, chunkSize?: number): Promise<void>`
 
 写入文件（流式）。
@@ -427,7 +449,7 @@ console.log('工作空间模式:', info.workspace);
 
 ##### `getFiles(): Promise<ProjectFile[]>`
 
-获取项目文件列表。
+获取项目文件列表（仅返回文件，不包含目录）。
 
 **返回：** Promise<ProjectFile[]> 项目文件数组
 
@@ -435,7 +457,12 @@ console.log('工作空间模式:', info.workspace);
 ```typescript
 const files = await client.project.getFiles();
 files.forEach((file) => {
-  console.log('文件:', file.path);
+  console.log('文件路径:', file.path);
+  console.log('文件名:', file.name);
+  console.log('MIME类型:', file.type);
+  console.log('是否二进制:', file.isBinary);
+  console.log('最后修改时间:', new Date(file.lastModified));
+  console.log('文件大小:', file.size, '字节');
 });
 ```
 
@@ -860,6 +887,12 @@ enum FileType {
 interface FileChangeEvent {
   type: 'add' | 'change' | 'unlink' | 'addDir' | 'unlinkDir';
   path: string;
+  /** 是否为二进制文件（仅在 add 和 change 事件中存在） */
+  isBinary?: boolean;
+  /** 最后修改时间（毫秒时间戳，仅在文件事件中存在） */
+  lastModified?: number;
+  /** 文件大小（字节，仅在文件事件中存在） */
+  size?: number;
 }
 ```
 
@@ -882,6 +915,19 @@ interface ProjectInfo {
 }
 ```
 
+### ProjectFile
+
+```typescript
+interface ProjectFile {
+  path: string;           // 文件相对路径
+  name: string;            // 文件名
+  type: string;            // MIME 类型
+  isBinary: boolean;       // 是否为二进制文件
+  lastModified: number;    // 最后修改时间（毫秒时间戳）
+  size: number;           // 文件大小（字节）
+}
+```
+
 ### SendMessageOptions
 
 ```typescript

package/dist/modules/file-system.d.ts

@@ -1,5 +1,5 @@
 import type { Socket } from 'socket.io-client';
-import type { FileStat, DirectoryItem, FileChangeEvent } from '../types/index.js';
+import type { FileStat, DirectoryItem, FileChangeEvent, ProjectFile } from '../types/index.js';
 /**
  * 文件系统模块
  */
@@ -12,6 +12,10 @@ export declare class FileSystemModule {
      * 获取查询参数
      */
     private getQueryParams;
+    /**
+     * 获取查询参数（用于目录路径）
+     */
+    private getDirQueryParams;
     /**
      * 获取文件状态
      */
@@ -34,6 +38,12 @@ export declare class FileSystemModule {
      * 读取目录
      */
     readdir(filePath: string): Promise<DirectoryItem[]>;
+    /**
+     * 获取指定目录下的所有文件
+     * @param dirPath 目录路径
+     * @returns Promise<Record<string, ProjectFile>> 文件路径到文件信息的映射
+     */
+    files(dirPath: string): Promise<Record<string, ProjectFile>>;
     /**
      * 写入文件（流式）
      * @param filePath 文件路径

package/dist/modules/file-system.js

@@ -18,6 +18,16 @@ export class FileSystemModule {
         }
         return params.toString();
     }
+    /**
+     * 获取查询参数（用于目录路径）
+     */
+    getDirQueryParams(dirPath) {
+        const params = new URLSearchParams({ dirPath });
+        if (this.projectId) {
+            params.set('projectId', this.projectId);
+        }
+        return params.toString();
+    }
     /**
      * 获取文件状态
      */
@@ -71,6 +81,20 @@ export class FileSystemModule {
         }
         return result.data;
     }
+    /**
+     * 获取指定目录下的所有文件
+     * @param dirPath 目录路径
+     * @returns Promise<Record<string, ProjectFile>> 文件路径到文件信息的映射
+     */
+    async files(dirPath) {
+        const url = `${this.baseUrl}/api/fs/files?${this.getDirQueryParams(dirPath)}`;
+        const response = await fetch(url);
+        const result = await response.json();
+        if (result.status === 'error') {
+            throw new Error(result.message);
+        }
+        return result.data;
+    }
     /**
      * 写入文件（流式）
      * @param filePath 文件路径

package/dist/types/index.d.ts

@@ -56,6 +56,10 @@ export interface FileChangeEvent {
     path: string;
     /** 是否为二进制文件（仅在 add 和 change 事件中存在） */
     isBinary?: boolean;
+    /** 最后修改时间（毫秒时间戳，仅在文件事件中存在） */
+    lastModified?: number;
+    /** 文件大小（字节，仅在文件事件中存在） */
+    size?: number;
 }
 /**
  * 端口状态类型
@@ -81,6 +85,11 @@ export interface ProjectInfo {
  */
 export interface ProjectFile {
     path: string;
+    name: string;
+    type: string;
+    isBinary: boolean;
+    lastModified: number;
+    size: number;
 }
 /**
  * SDK 配置选项

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lcap/wave-sandbox-sdk",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "SDK for Wave Sandbox Client",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -10,8 +10,17 @@
     "src",
     "README.md"
   ],
+  "scripts": {
+    "build": "rimraf dist && tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",
+    "type-check": "tsc --noEmit",
+    "dev": "tsc -p tsconfig.build.json --watch & tsc-alias -p tsconfig.build.json --watch",
+    "test": "vitest run",
+    "lint": "eslint --cache",
+    "format": "prettier --write .",
+    "prepublishOnly": "pnpm run build"
+  },
   "dependencies": {
-    "socket.io-client": "^4.8.1"
+    "socket.io-client": "^4.8.3"
   },
   "devDependencies": {
     "rimraf": "^6.1.2",
@@ -22,13 +31,5 @@
   "engines": {
     "node": ">=16.0.0"
   },
-  "license": "MIT",
-  "scripts": {
-    "build": "rimraf dist && tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",
-    "type-check": "tsc --noEmit",
-    "dev": "tsc -p tsconfig.build.json --watch & tsc-alias -p tsconfig.build.json --watch",
-    "test": "vitest run",
-    "lint": "eslint --cache",
-    "format": "prettier --write ."
-  }
-}
+  "license": "MIT"
+}

package/src/modules/file-system.ts

@@ -1,6 +1,6 @@
 import type { Socket } from 'socket.io-client';
 import { createSocketHandler, onSocketEvent } from '../utils/socket.js';
-import type { FileStat, DirectoryItem, FileChangeEvent, HttpResponse } from '../types/index.js';
+import type { FileStat, DirectoryItem, FileChangeEvent, HttpResponse, ProjectFile } from '../types/index.js';
 
 /**
  * 文件系统模块
@@ -23,6 +23,17 @@ export class FileSystemModule {
     return params.toString();
   }
 
+  /**
+   * 获取查询参数（用于目录路径）
+   */
+  private getDirQueryParams(dirPath: string): string {
+    const params = new URLSearchParams({ dirPath });
+    if (this.projectId) {
+      params.set('projectId', this.projectId);
+    }
+    return params.toString();
+  }
+
   /**
    * 获取文件状态
    */
@@ -93,6 +104,23 @@ export class FileSystemModule {
     return result.data;
   }
 
+  /**
+   * 获取指定目录下的所有文件
+   * @param dirPath 目录路径
+   * @returns Promise<Record<string, ProjectFile>> 文件路径到文件信息的映射
+   */
+  async files(dirPath: string): Promise<Record<string, ProjectFile>> {
+    const url = `${this.baseUrl}/api/fs/files?${this.getDirQueryParams(dirPath)}`;
+    const response = await fetch(url);
+    const result: HttpResponse<Record<string, ProjectFile>> = await response.json();
+
+    if (result.status === 'error') {
+      throw new Error(result.message);
+    }
+
+    return result.data;
+  }
+
   /**
    * 写入文件（流式）
    * @param filePath 文件路径

package/src/types/index.ts

@@ -66,6 +66,10 @@ export interface FileChangeEvent {
   path: string;
   /** 是否为二进制文件（仅在 add 和 change 事件中存在） */
   isBinary?: boolean;
+  /** 最后修改时间（毫秒时间戳，仅在文件事件中存在） */
+  lastModified?: number;
+  /** 文件大小（字节，仅在文件事件中存在） */
+  size?: number;
 }
 
 /**
@@ -95,7 +99,11 @@ export interface ProjectInfo {
  */
 export interface ProjectFile {
   path: string;
-  // 可以根据实际需要添加更多字段
+  name: string;
+  type: string;
+  isBinary: boolean;
+  lastModified: number;
+  size: number;
 }
 
 /**