@lcap/wave-sandbox-sdk 0.0.4 → 0.0.6

package/dist/client.js

@@ -13,14 +13,14 @@ export class WaveSandboxClient {
         return this.fileSystem;
     }
     constructor(options) {
-        const { url, projectId, options: socketOptions } = options;
+        const { url, projectId, authToken, options: socketOptions } = options;
         const uri = new URL(url);
         let pathname = uri.pathname;
         if (pathname.endsWith('/')) {
             pathname = pathname.slice(0, pathname.length - 1);
         }
         pathname = pathname + '/socket.io/';
-        // 构建 Socket.IO 连接选项
+        // 构建 Socket.IO 连接选项（Authorization 供服务端 auth 中间件校验）
         const connectOptions = {
             autoConnect: socketOptions?.autoConnect ?? true,
             reconnection: socketOptions?.reconnection ?? true,
@@ -28,15 +28,25 @@ export class WaveSandboxClient {
             reconnectionAttempts: socketOptions?.reconnectionAttempts ?? 5,
             query: projectId ? { projectId } : undefined,
             path: pathname,
+            ...(authToken
+                ? {
+                    extraHeaders: { Authorization: authToken },
+                    transportOptions: {
+                        polling: {
+                            extraHeaders: { Authorization: authToken },
+                        },
+                    },
+                }
+                : {}),
         };
         // 创建 Socket.IO 连接
         this.socket = io(uri.host, connectOptions);
         // 初始化各个模块
         this.exec = new ExecModule(this.socket);
-        this.fileSystem = new FileSystemModule(this.socket, url, projectId);
+        this.fileSystem = new FileSystemModule(this.socket, url, projectId, authToken);
         this.port = new PortModule(this.socket);
-        this.project = new ProjectModule(this.socket, url, projectId);
-        this.agent = new AgentModule(this.socket, url, projectId);
+        this.project = new ProjectModule(this.socket, url, projectId, authToken);
+        this.agent = new AgentModule(this.socket, url, projectId, authToken);
     }
     /**
      * 连接到服务器

package/dist/modules/agent.d.ts

@@ -253,13 +253,6 @@ export interface AskUserQuestion {
     options: AskUserQuestionOption[];
     multiSelect?: boolean;
 }
-/**
- * 询问用户问题事件数据
- */
-export interface AskUserQuestionEvent {
-    questionId: string;
-    questions: AskUserQuestion[];
-}
 /**
  * Ask 信息状态
  */
@@ -271,6 +264,10 @@ export interface AskInfo {
     answered: boolean;
     answer?: string;
 }
+/**
+ * 询问用户问题事件数据（与 AskInfo 相同）
+ */
+export type AskUserQuestionEvent = AskInfo;
 /**
  * 客户端回调选项
  */
@@ -317,7 +314,8 @@ export declare class AgentModule {
     private socket;
     private baseUrl;
     private projectId?;
-    constructor(socket: Socket, baseUrl: string, projectId?: string | undefined);
+    private authToken?;
+    constructor(socket: Socket, baseUrl: string, projectId?: string | undefined, authToken?: string | undefined);
     /**
      * 获取查询参数
      */

package/dist/modules/agent.js

@@ -1,12 +1,14 @@
 import { createSocketHandler, onSocketEvent } from '../utils/socket.js';
+import { fetchWithAuth } from '../utils/fetch-auth.js';
 /**
  * Agent 模块
  */
 export class AgentModule {
-    constructor(socket, baseUrl, projectId) {
+    constructor(socket, baseUrl, projectId, authToken) {
         this.socket = socket;
         this.baseUrl = baseUrl;
         this.projectId = projectId;
+        this.authToken = authToken;
     }
     /**
      * 获取查询参数
@@ -61,7 +63,7 @@ export class AgentModule {
     async getCurrentState() {
         const queryParams = this.getQueryParams();
         const url = `${this.baseUrl}/api/agent/currentState${queryParams ? `?${queryParams}` : ''}`;
-        const response = await fetch(url);
+        const response = await fetchWithAuth(url, this.authToken);
         const result = await response.json();
         if (result.status === 'error') {
             throw new Error(result.message);
@@ -78,7 +80,7 @@ export class AgentModule {
         const sessionIdParam = `sessionId=${encodeURIComponent(sessionId)}`;
         const params = queryParams ? `${queryParams}&${sessionIdParam}` : sessionIdParam;
         const url = `${this.baseUrl}/api/agent/askInfo?${params}`;
-        const response = await fetch(url);
+        const response = await fetchWithAuth(url, this.authToken);
         const result = await response.json();
         if (result.status === 'error') {
             throw new Error(result.message);

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

@@ -7,7 +7,8 @@ export declare class FileSystemModule {
     private socket;
     private baseUrl;
     private projectId?;
-    constructor(socket: Socket, baseUrl: string, projectId?: string | undefined);
+    private authToken?;
+    constructor(socket: Socket, baseUrl: string, projectId?: string | undefined, authToken?: string | undefined);
     /**
      * 获取查询参数
      */

package/dist/modules/file-system.js

@@ -1,12 +1,14 @@
 import { createSocketHandler, onSocketEvent } from '../utils/socket.js';
+import { fetchWithAuth } from '../utils/fetch-auth.js';
 /**
  * 文件系统模块
  */
 export class FileSystemModule {
-    constructor(socket, baseUrl, projectId) {
+    constructor(socket, baseUrl, projectId, authToken) {
         this.socket = socket;
         this.baseUrl = baseUrl;
         this.projectId = projectId;
+        this.authToken = authToken;
     }
     /**
      * 获取查询参数
@@ -33,7 +35,7 @@ export class FileSystemModule {
      */
     async stat(filePath) {
         const url = `${this.baseUrl}/api/fs/stat?${this.getQueryParams(filePath)}`;
-        const response = await fetch(url);
+        const response = await fetchWithAuth(url, this.authToken);
         const result = await response.json();
         if (result.status === 'error') {
             throw new Error(result.message);
@@ -44,7 +46,7 @@ export class FileSystemModule {
         if (asText) {
             // 使用 readFile 端点获取文本内容
             const url = `${this.baseUrl}/api/fs/readFile?${this.getQueryParams(filePath)}`;
-            const response = await fetch(url);
+            const response = await fetchWithAuth(url, this.authToken);
             const result = await response.json();
             if (result.status === 'error') {
                 throw new Error(result.message);
@@ -54,7 +56,7 @@ export class FileSystemModule {
         else {
             // 使用 read 端点获取原始文件（支持二进制）
             const url = `${this.baseUrl}/api/fs/read?${this.getQueryParams(filePath)}`;
-            const response = await fetch(url);
+            const response = await fetchWithAuth(url, this.authToken);
             if (!response.ok) {
                 throw new Error(`Failed to read file: ${response.statusText}`);
             }
@@ -74,7 +76,7 @@ export class FileSystemModule {
      */
     async readdir(filePath) {
         const url = `${this.baseUrl}/api/fs/readdir?${this.getQueryParams(filePath)}`;
-        const response = await fetch(url);
+        const response = await fetchWithAuth(url, this.authToken);
         const result = await response.json();
         if (result.status === 'error') {
             throw new Error(result.message);
@@ -88,7 +90,7 @@ export class FileSystemModule {
      */
     async files(dirPath) {
         const url = `${this.baseUrl}/api/fs/files?${this.getDirQueryParams(dirPath)}`;
-        const response = await fetch(url);
+        const response = await fetchWithAuth(url, this.authToken);
         const result = await response.json();
         if (result.status === 'error') {
             throw new Error(result.message);

package/dist/modules/project.d.ts

@@ -7,7 +7,8 @@ export declare class ProjectModule {
     private socket;
     private baseUrl;
     private projectId?;
-    constructor(socket: Socket, baseUrl: string, projectId?: string | undefined);
+    private authToken?;
+    constructor(socket: Socket, baseUrl: string, projectId?: string | undefined, authToken?: string | undefined);
     /**
      * 获取查询参数
      */

package/dist/modules/project.js

@@ -1,12 +1,14 @@
 import { createSocketHandler, onSocketEvent } from '../utils/socket.js';
+import { fetchWithAuth } from '../utils/fetch-auth.js';
 /**
  * 项目模块
  */
 export class ProjectModule {
-    constructor(socket, baseUrl, projectId) {
+    constructor(socket, baseUrl, projectId, authToken) {
         this.socket = socket;
         this.baseUrl = baseUrl;
         this.projectId = projectId;
+        this.authToken = authToken;
     }
     /**
      * 获取查询参数
@@ -22,7 +24,7 @@ export class ProjectModule {
      */
     async getInfo() {
         const url = `${this.baseUrl}/project/info${this.projectId ? `?${this.getQueryParams()}` : ''}`;
-        const response = await fetch(url);
+        const response = await fetchWithAuth(url, this.authToken);
         const result = await response.json();
         if (result.status === 'error') {
             throw new Error(result.message);
@@ -34,7 +36,7 @@ export class ProjectModule {
      */
     async getFiles() {
         const url = `${this.baseUrl}/project/files${this.projectId ? `?${this.getQueryParams()}` : ''}`;
-        const response = await fetch(url);
+        const response = await fetchWithAuth(url, this.authToken);
         const result = await response.json();
         if (result.status === 'error') {
             throw new Error(result.message);

package/dist/types/index.d.ts

@@ -99,6 +99,11 @@ export interface SDKOptions {
     url: string;
     /** 项目 ID（可选，用于工作空间模式） */
     projectId?: string;
+    /**
+     * 与服务器 `authToken` 一致时启用；HTTP 与 Socket 握手会携带 `Authorization` 头
+     *（例如 spec-server：`[naslStorageAppId, SBX_SANDBOX_ID].join('|')`）
+     */
+    authToken?: string;
     /** 连接选项 */
     options?: {
         /** 自动连接 */

package/dist/utils/fetch-auth.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 带可选 Authorization 的 fetch，与 wave-sandbox-server 的 authToken 鉴权一致
+ */
+export declare function fetchWithAuth(url: string | URL, authToken: string | undefined, init?: RequestInit): Promise<Response>;

package/dist/utils/fetch-auth.js

@@ -0,0 +1,11 @@
+/**
+ * 带可选 Authorization 的 fetch，与 wave-sandbox-server 的 authToken 鉴权一致
+ */
+export function fetchWithAuth(url, authToken, init) {
+    if (!authToken) {
+        return fetch(url, init);
+    }
+    const headers = new Headers(init?.headers);
+    headers.set('Authorization', authToken);
+    return fetch(url, { ...init, headers });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lcap/wave-sandbox-sdk",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "SDK for Wave Sandbox Client",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -10,6 +10,15 @@
     "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.3"
   },
@@ -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/client.ts

@@ -22,7 +22,7 @@ export class WaveSandboxClient {
   public readonly agent: AgentModule;
 
   constructor(options: SDKOptions) {
-    const { url, projectId, options: socketOptions } = options;
+    const { url, projectId, authToken, options: socketOptions } = options;
 
     const uri = new URL(url);
     let pathname = uri.pathname;
@@ -33,7 +33,7 @@ export class WaveSandboxClient {
 
     pathname = pathname + '/socket.io/';
 
-    // 构建 Socket.IO 连接选项
+    // 构建 Socket.IO 连接选项（Authorization 供服务端 auth 中间件校验）
     const connectOptions = {
       autoConnect: socketOptions?.autoConnect ?? true,
       reconnection: socketOptions?.reconnection ?? true,
@@ -41,6 +41,16 @@ export class WaveSandboxClient {
       reconnectionAttempts: socketOptions?.reconnectionAttempts ?? 5,
       query: projectId ? { projectId } : undefined,
       path: pathname,
+      ...(authToken
+        ? {
+            extraHeaders: { Authorization: authToken },
+            transportOptions: {
+              polling: {
+                extraHeaders: { Authorization: authToken },
+              },
+            },
+          }
+        : {}),
     };
 
     // 创建 Socket.IO 连接
@@ -48,10 +58,10 @@ export class WaveSandboxClient {
 
     // 初始化各个模块
     this.exec = new ExecModule(this.socket);
-    this.fileSystem = new FileSystemModule(this.socket, url, projectId);
+    this.fileSystem = new FileSystemModule(this.socket, url, projectId, authToken);
     this.port = new PortModule(this.socket);
-    this.project = new ProjectModule(this.socket, url, projectId);
-    this.agent = new AgentModule(this.socket, url, projectId);
+    this.project = new ProjectModule(this.socket, url, projectId, authToken);
+    this.agent = new AgentModule(this.socket, url, projectId, authToken);
   }
 
   /**

package/src/modules/agent.ts

@@ -9,6 +9,7 @@ import type {
 } from '../types/agent-types.js';
 import type { HttpResponse } from '../types/index.js';
 import { createSocketHandler, onSocketEvent } from '../utils/socket.js';
+import { fetchWithAuth } from '../utils/fetch-auth.js';
 
 /**
  * 附件接口
@@ -289,14 +290,6 @@ export interface AskUserQuestion {
   multiSelect?: boolean;
 }
 
-/**
- * 询问用户问题事件数据
- */
-export interface AskUserQuestionEvent {
-  questionId: string;
-  questions: AskUserQuestion[];
-}
-
 /**
  * Ask 信息状态
  */
@@ -309,6 +302,11 @@ export interface AskInfo {
   answer?: string;
 }
 
+/**
+ * 询问用户问题事件数据（与 AskInfo 相同）
+ */
+export type AskUserQuestionEvent = AskInfo;
+
 /**
  * 客户端回调选项
  */
@@ -358,7 +356,8 @@ export class AgentModule {
   constructor(
     private socket: Socket,
     private baseUrl: string,
-    private projectId?: string
+    private projectId?: string,
+    private authToken?: string
   ) {}
 
   /**
@@ -427,7 +426,7 @@ export class AgentModule {
   async getCurrentState(): Promise<MessageQueueChangedEvent | null> {
     const queryParams = this.getQueryParams();
     const url = `${this.baseUrl}/api/agent/currentState${queryParams ? `?${queryParams}` : ''}`;
-    const response = await fetch(url);
+    const response = await fetchWithAuth(url, this.authToken);
     const result: HttpResponse<MessageQueueChangedEvent | null> = await response.json();
 
     if (result.status === 'error') {
@@ -447,7 +446,7 @@ export class AgentModule {
     const sessionIdParam = `sessionId=${encodeURIComponent(sessionId)}`;
     const params = queryParams ? `${queryParams}&${sessionIdParam}` : sessionIdParam;
     const url = `${this.baseUrl}/api/agent/askInfo?${params}`;
-    const response = await fetch(url);
+    const response = await fetchWithAuth(url, this.authToken);
     const result: HttpResponse<AskInfo | null> = await response.json();
 
     if (result.status === 'error') {

package/src/modules/file-system.ts

@@ -1,5 +1,6 @@
 import type { Socket } from 'socket.io-client';
 import { createSocketHandler, onSocketEvent } from '../utils/socket.js';
+import { fetchWithAuth } from '../utils/fetch-auth.js';
 import type { FileStat, DirectoryItem, FileChangeEvent, HttpResponse, ProjectFile } from '../types/index.js';
 
 /**
@@ -9,7 +10,8 @@ export class FileSystemModule {
   constructor(
     private socket: Socket,
     private baseUrl: string,
-    private projectId?: string
+    private projectId?: string,
+    private authToken?: string
   ) {}
 
   /**
@@ -39,7 +41,7 @@ export class FileSystemModule {
    */
   async stat(filePath: string): Promise<FileStat> {
     const url = `${this.baseUrl}/api/fs/stat?${this.getQueryParams(filePath)}`;
-    const response = await fetch(url);
+    const response = await fetchWithAuth(url, this.authToken);
     const result: HttpResponse<FileStat> = await response.json();
 
     if (result.status === 'error') {
@@ -61,7 +63,7 @@ export class FileSystemModule {
     if (asText) {
       // 使用 readFile 端点获取文本内容
       const url = `${this.baseUrl}/api/fs/readFile?${this.getQueryParams(filePath)}`;
-      const response = await fetch(url);
+      const response = await fetchWithAuth(url, this.authToken);
       const result: HttpResponse<string> = await response.json();
 
       if (result.status === 'error') {
@@ -72,7 +74,7 @@ export class FileSystemModule {
     } else {
       // 使用 read 端点获取原始文件（支持二进制）
       const url = `${this.baseUrl}/api/fs/read?${this.getQueryParams(filePath)}`;
-      const response = await fetch(url);
+      const response = await fetchWithAuth(url, this.authToken);
       if (!response.ok) {
         throw new Error(`Failed to read file: ${response.statusText}`);
       }
@@ -94,7 +96,7 @@ export class FileSystemModule {
    */
   async readdir(filePath: string): Promise<DirectoryItem[]> {
     const url = `${this.baseUrl}/api/fs/readdir?${this.getQueryParams(filePath)}`;
-    const response = await fetch(url);
+    const response = await fetchWithAuth(url, this.authToken);
     const result: HttpResponse<DirectoryItem[]> = await response.json();
 
     if (result.status === 'error') {
@@ -111,7 +113,7 @@ export class FileSystemModule {
    */
   async files(dirPath: string): Promise<Record<string, ProjectFile>> {
     const url = `${this.baseUrl}/api/fs/files?${this.getDirQueryParams(dirPath)}`;
-    const response = await fetch(url);
+    const response = await fetchWithAuth(url, this.authToken);
     const result: HttpResponse<Record<string, ProjectFile>> = await response.json();
 
     if (result.status === 'error') {

package/src/modules/project.ts

@@ -1,5 +1,6 @@
 import type { Socket } from 'socket.io-client';
 import { createSocketHandler, onSocketEvent } from '../utils/socket.js';
+import { fetchWithAuth } from '../utils/fetch-auth.js';
 import type { ProjectInfo, ProjectFile, HttpResponse, FileChangeEvent } from '../types/index.js';
 
 /**
@@ -9,7 +10,8 @@ export class ProjectModule {
   constructor(
     private socket: Socket,
     private baseUrl: string,
-    private projectId?: string
+    private projectId?: string,
+    private authToken?: string
   ) {}
 
   /**
@@ -27,7 +29,7 @@ export class ProjectModule {
    */
   async getInfo(): Promise<ProjectInfo> {
     const url = `${this.baseUrl}/project/info${this.projectId ? `?${this.getQueryParams()}` : ''}`;
-    const response = await fetch(url);
+    const response = await fetchWithAuth(url, this.authToken);
     const result: HttpResponse<ProjectInfo> = await response.json();
 
     if (result.status === 'error') {
@@ -42,7 +44,7 @@ export class ProjectModule {
    */
   async getFiles(): Promise<ProjectFile[]> {
     const url = `${this.baseUrl}/project/files${this.projectId ? `?${this.getQueryParams()}` : ''}`;
-    const response = await fetch(url);
+    const response = await fetchWithAuth(url, this.authToken);
     const result: HttpResponse<{ files: ProjectFile[] }> = await response.json();
 
     if (result.status === 'error') {

package/src/types/index.ts

@@ -114,6 +114,11 @@ export interface SDKOptions {
   url: string;
   /** 项目 ID（可选，用于工作空间模式） */
   projectId?: string;
+  /**
+   * 与服务器 `authToken` 一致时启用；HTTP 与 Socket 握手会携带 `Authorization` 头
+   *（例如 spec-server：`[naslStorageAppId, SBX_SANDBOX_ID].join('|')`）
+   */
+  authToken?: string;
   /** 连接选项 */
   options?: {
     /** 自动连接 */

package/src/utils/fetch-auth.ts

@@ -0,0 +1,11 @@
+/**
+ * 带可选 Authorization 的 fetch，与 wave-sandbox-server 的 authToken 鉴权一致
+ */
+export function fetchWithAuth(url: string | URL, authToken: string | undefined, init?: RequestInit): Promise<Response> {
+  if (!authToken) {
+    return fetch(url, init);
+  }
+  const headers = new Headers(init?.headers);
+  headers.set('Authorization', authToken);
+  return fetch(url, { ...init, headers });
+}