@chatu-ai/builder-sdk 0.1.0 → 0.2.0

package/dist/client.d.ts

@@ -48,6 +48,52 @@ export interface FileNode {
     type: 'file' | 'dir';
     children?: FileNode[];
 }
+export type CredentialScope = 'organization' | 'user' | 'conversation';
+export interface CredentialView {
+    id: string;
+    scope: CredentialScope;
+    provider: string;
+    label: string;
+    hint?: string | null;
+    meta?: Record<string, unknown> | null;
+    createdTime: string;
+    lastUsedTime?: string | null;
+    readOnly: boolean;
+}
+export interface DeploySettingView {
+    target: string;
+    credentialId?: string | null;
+    config: Record<string, unknown>;
+    lastRunTime?: string | null;
+    lastRunStatus?: string | null;
+    lastRunMessage?: string | null;
+    lastRunUrl?: string | null;
+    updatedTime: string;
+}
+export interface GitPushInput {
+    remoteUrl: string;
+    branch?: string;
+    /** 二选一：凭据库 id */
+    credentialId?: string;
+    /** 二选一：仅本次使用的令牌；save=true 时同时存为用户级凭据 */
+    token?: string;
+    username?: string;
+    save?: boolean;
+    label?: string;
+    force?: boolean;
+    commitMessage?: string;
+}
+export interface GitPushResult {
+    ok: boolean;
+    error?: string;
+    state?: string;
+    remoteUrl?: string;
+    branch?: string;
+    sha?: string;
+    output?: string;
+    webUrl?: string;
+    credentialId?: string | null;
+}
 export interface BuilderClient {
     chat: {
         stream(conversationId: string, prompt: string, opts?: {
@@ -89,6 +135,40 @@ export interface BuilderClient {
         }): Promise<string>;
         downloadUrl(conversationId: string): string;
     };
+    /** 凭据库（技术方案 14 §2）：列表脱敏，永不返回明文 */
+    credentials: {
+        list(conversationId?: string): Promise<CredentialView[]>;
+        save(input: {
+            provider: string;
+            label: string;
+            secret: string;
+            scope: 'user' | 'conversation';
+            conversationId?: string;
+            meta?: Record<string, unknown>;
+        }): Promise<CredentialView>;
+        remove(id: string): Promise<void>;
+    };
+    /** 设置库 + 发布动作 */
+    deploy: {
+        settings(conversationId: string): Promise<DeploySettingView[]>;
+        saveSetting(conversationId: string, input: {
+            target: string;
+            credentialId?: string | null;
+            config?: Record<string, unknown>;
+        }): Promise<DeploySettingView>;
+        /** 推送到用户 Git 仓库；沙箱未运行时 ok=false, error='SANDBOX_NOT_RUNNING' */
+        pushGit(conversationId: string, input: GitPushInput): Promise<GitPushResult>;
+    };
+    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,27 @@ export function createBuilderClient(options) {
             read: (id, path, opts) => req(`/${id}/files/read?${qs({ path, ...opts })}`),
             downloadUrl: id => `${restBase}/${id}/files/download`,
         },
+        credentials: {
+            list: conversationId => req(`/credentials${conversationId ? `?conversationId=${encodeURIComponent(conversationId)}` : ''}`),
+            save: input => req('/credentials', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(input) }),
+            remove: async (id) => { await req(`/credentials/${id}`, { method: 'DELETE' }); },
+        },
+        deploy: {
+            settings: id => req(`/${id}/deploy-settings`),
+            saveSetting: (id, input) => req(`/${id}/deploy-settings`, { method: 'PUT', headers: { 'content-type': 'application/json' }, body: JSON.stringify(input) }),
+            pushGit: (id, input) => req(`/${id}/export/git`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(input) }),
+        },
+        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,46 @@ 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 });
+    });
+});
+describe('client credentials/deploy', () => {
+    it('posts pushGit body and unwraps envelope', async () => {
+        let captured;
+        const c = createBuilderClient({
+            restBase: 'https://api.test/web/Builder',
+            auth: new CookieAuth(),
+            transport: { stream: async function* () { }, resubscribe: async function* () { }, cancel: async () => { } },
+            fetchImpl: (async (url, init) => {
+                captured = { url, init };
+                return new Response(JSON.stringify({ code: 0, data: { ok: true, sha: 'abc', branch: 'main' } }), { status: 200, headers: { 'content-type': 'application/json' } });
+            }),
+        });
+        const r = await c.deploy.pushGit('c1', { remoteUrl: 'https://github.com/a/b.git', credentialId: 'cred-1' });
+        expect(r.ok).toBe(true);
+        expect(captured?.url).toBe('https://api.test/web/Builder/c1/export/git');
+        expect(JSON.parse(String(captured?.init?.body))).toMatchObject({ remoteUrl: 'https://github.com/a/b.git', credentialId: 'cred-1' });
+    });
+});

package/package.json

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