@chatu-ai/builder-sdk 0.1.0 → 0.1.1

package/dist/client.d.ts

@@ -89,6 +89,16 @@ export interface BuilderClient {
         }): Promise<string>;
         downloadUrl(conversationId: string): string;
     };
+    export: {
+        /**
+         * 导出应用源码 ZIP（含 Dockerfile/DEPLOY.md）。沙箱未运行时服务端返回 409 SANDBOX_NOT_RUNNING —— 调用方先 sandbox.wake()。
+         * 返回 Blob 与建议文件名（取自 Content-Disposition）
+         */
+        zip(conversationId: string): Promise<{
+            blob: Blob;
+            fileName: string;
+        }>;
+    };
 }
 export declare function createBuilderClient(options: BuilderClientOptions): BuilderClient;
 export declare class BuilderApiError extends Error {

package/dist/client.js

@@ -76,6 +76,17 @@ export function createBuilderClient(options) {
             read: (id, path, opts) => req(`/${id}/files/read?${qs({ path, ...opts })}`),
             downloadUrl: id => `${restBase}/${id}/files/download`,
         },
+        export: {
+            zip: async (id) => {
+                const res = await doFetch(`${restBase}/${id}/export/zip`, auth.apply({}));
+                if (!res.ok)
+                    throw new BuilderApiError(res.status, await res.text().catch(() => ''));
+                const cd = res.headers.get('content-disposition') ?? '';
+                const m = /filename\*?=(?:UTF-8'')?"?([^";]+)"?/i.exec(cd);
+                const fileName = m?.[1] ? decodeURIComponent(m[1]) : 'app.zip';
+                return { blob: await res.blob(), fileName };
+            },
+        },
     };
 }
 /**

package/dist/parse.test.js

@@ -60,3 +60,28 @@ describe('client req envelope unwrap', () => {
         await expect(c.sandbox.status('c1')).rejects.toThrow('会话不存在');
     });
 });
+describe('client export.zip', () => {
+    it('returns blob and filename from content-disposition', async () => {
+        const c = createBuilderClient({
+            restBase: 'https://api.test/web/Builder',
+            auth: new CookieAuth(),
+            transport: { stream: async function* () { }, resubscribe: async function* () { }, cancel: async () => { } },
+            fetchImpl: (async () => new Response(new Uint8Array([0x50, 0x4b]), {
+                status: 200,
+                headers: { 'content-type': 'application/zip', 'content-disposition': 'attachment; filename="my-app.zip"' },
+            })),
+        });
+        const r = await c.export.zip('c1');
+        expect(r.fileName).toBe('my-app.zip');
+        expect(r.blob.size).toBe(2);
+    });
+    it('throws BuilderApiError 409 when sandbox not running', async () => {
+        const c = createBuilderClient({
+            restBase: 'https://api.test/web/Builder',
+            auth: new CookieAuth(),
+            transport: { stream: async function* () { }, resubscribe: async function* () { }, cancel: async () => { } },
+            fetchImpl: (async () => new Response('{"error":"SANDBOX_NOT_RUNNING"}', { status: 409 })),
+        });
+        await expect(c.export.zip('c1')).rejects.toMatchObject({ status: 409 });
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chatu-ai/builder-sdk",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "ChatU Builder client SDK core: REST + streaming client, zod event schemas, seq resume",
   "license": "MIT",
   "type": "module",