@chatu-ai/builder-sdk 0.1.1 → 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,30 @@ 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()。

package/dist/client.js

@@ -76,6 +76,16 @@ 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({}));

package/dist/parse.test.js

@@ -85,3 +85,21 @@ describe('client export.zip', () => {
         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.1",
+  "version": "0.2.0",
   "description": "ChatU Builder client SDK core: REST + streaming client, zod event schemas, seq resume",
   "license": "MIT",
   "type": "module",