@tinybirdco/sdk 0.0.11 → 0.0.13

package/dist/cli/output.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Console output utilities with color support
+ * Provides consistent formatting similar to the Python CLI
+ */
+/**
+ * Output a success message (green)
+ */
+export declare function success(message: string): void;
+/**
+ * Output an error message (red)
+ */
+export declare function error(message: string): void;
+/**
+ * Output a warning message (yellow/orange)
+ */
+export declare function warning(message: string): void;
+/**
+ * Output an info message (default color)
+ */
+export declare function info(message: string): void;
+/**
+ * Output a highlighted message (blue)
+ */
+export declare function highlight(message: string): void;
+/**
+ * Output a gray message (dimmed)
+ */
+export declare function gray(message: string): void;
+/**
+ * Output a bold message
+ */
+export declare function bold(message: string): void;
+/**
+ * Format a timestamp for console output
+ */
+export declare function formatTime(): string;
+/**
+ * Format duration in human-readable format
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Show a resource change (checkmark + path + status)
+ */
+export declare function showResourceChange(path: string, status: "created" | "changed" | "deleted"): void;
+/**
+ * Show a warning for a resource
+ */
+export declare function showResourceWarning(level: string, resource: string, message: string): void;
+/**
+ * Show build errors in formatted style
+ */
+export declare function showBuildErrors(errors: Array<{
+    filename?: string;
+    error: string;
+}>): void;
+/**
+ * Show final build success message
+ */
+export declare function showBuildSuccess(durationMs: number, isRebuild?: boolean): void;
+/**
+ * Show final build failure message
+ */
+export declare function showBuildFailure(isRebuild?: boolean): void;
+/**
+ * Show no changes message
+ */
+export declare function showNoChanges(): void;
+/**
+ * Output object containing all output functions
+ */
+export declare const output: {
+    success: typeof success;
+    error: typeof error;
+    warning: typeof warning;
+    info: typeof info;
+    highlight: typeof highlight;
+    gray: typeof gray;
+    bold: typeof bold;
+    formatTime: typeof formatTime;
+    formatDuration: typeof formatDuration;
+    showResourceChange: typeof showResourceChange;
+    showResourceWarning: typeof showResourceWarning;
+    showBuildErrors: typeof showBuildErrors;
+    showBuildSuccess: typeof showBuildSuccess;
+    showBuildFailure: typeof showBuildFailure;
+    showNoChanges: typeof showNoChanges;
+};
+//# sourceMappingURL=output.d.ts.map

package/dist/cli/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GACxC,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,CAczF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,IAAI,CAG5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,UAAQ,GAAG,IAAI,CAGxD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED;;GAEG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;CAgBlB,CAAC"}

package/dist/cli/output.js

@@ -0,0 +1,150 @@
+/**
+ * Console output utilities with color support
+ * Provides consistent formatting similar to the Python CLI
+ */
+// ANSI color codes
+const colors = {
+    reset: "\x1b[0m",
+    bold: "\x1b[1m",
+    red: "\x1b[91m",
+    green: "\x1b[92m",
+    yellow: "\x1b[38;5;208m",
+    blue: "\x1b[94m",
+    gray: "\x1b[90m",
+};
+// Check if colors should be disabled
+const noColor = process.env.NO_COLOR !== undefined || !process.stdout.isTTY;
+function colorize(text, color) {
+    if (noColor)
+        return text;
+    return `${colors[color]}${text}${colors.reset}`;
+}
+/**
+ * Output a success message (green)
+ */
+export function success(message) {
+    console.log(colorize(message, "green"));
+}
+/**
+ * Output an error message (red)
+ */
+export function error(message) {
+    console.error(colorize(message, "red"));
+}
+/**
+ * Output a warning message (yellow/orange)
+ */
+export function warning(message) {
+    console.log(colorize(message, "yellow"));
+}
+/**
+ * Output an info message (default color)
+ */
+export function info(message) {
+    console.log(message);
+}
+/**
+ * Output a highlighted message (blue)
+ */
+export function highlight(message) {
+    console.log(colorize(message, "blue"));
+}
+/**
+ * Output a gray message (dimmed)
+ */
+export function gray(message) {
+    console.log(colorize(message, "gray"));
+}
+/**
+ * Output a bold message
+ */
+export function bold(message) {
+    console.log(colorize(message, "bold"));
+}
+/**
+ * Format a timestamp for console output
+ */
+export function formatTime() {
+    return new Date().toLocaleTimeString("en-US", { hour12: false });
+}
+/**
+ * Format duration in human-readable format
+ */
+export function formatDuration(ms) {
+    if (ms < 1000) {
+        return `${ms}ms`;
+    }
+    return `${(ms / 1000).toFixed(1)}s`;
+}
+/**
+ * Show a resource change (checkmark + path + status)
+ */
+export function showResourceChange(path, status) {
+    console.log(`✓ ${path} ${status}`);
+}
+/**
+ * Show a warning for a resource
+ */
+export function showResourceWarning(level, resource, message) {
+    warning(`△ ${level}: ${resource}: ${message}`);
+}
+/**
+ * Show build errors in formatted style
+ */
+export function showBuildErrors(errors) {
+    for (const err of errors) {
+        if (err.filename) {
+            error(`${err.filename}`);
+            // Indent the error message
+            const lines = err.error.split("\n");
+            for (const line of lines) {
+                error(`  ${line}`);
+            }
+        }
+        else {
+            error(err.error);
+        }
+        console.log(); // Empty line between errors
+    }
+}
+/**
+ * Show final build success message
+ */
+export function showBuildSuccess(durationMs, isRebuild = false) {
+    const prefix = isRebuild ? "Rebuild" : "Build";
+    success(`\n✓ ${prefix} completed in ${formatDuration(durationMs)}`);
+}
+/**
+ * Show final build failure message
+ */
+export function showBuildFailure(isRebuild = false) {
+    const prefix = isRebuild ? "Rebuild" : "Build";
+    error(`\n✗ ${prefix} failed`);
+}
+/**
+ * Show no changes message
+ */
+export function showNoChanges() {
+    info("No changes. Build skipped.");
+}
+/**
+ * Output object containing all output functions
+ */
+export const output = {
+    success,
+    error,
+    warning,
+    info,
+    highlight,
+    gray,
+    bold,
+    formatTime,
+    formatDuration,
+    showResourceChange,
+    showResourceWarning,
+    showBuildErrors,
+    showBuildSuccess,
+    showBuildFailure,
+    showNoChanges,
+};
+//# sourceMappingURL=output.js.map

package/dist/cli/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mBAAmB;AACnB,MAAM,MAAM,GAAG;IACb,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,UAAU;IACf,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,gBAAgB;IACxB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;CACR,CAAC;AAEX,qCAAqC;AACrC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;AAE5E,SAAS,QAAQ,CAAC,IAAY,EAAE,KAA0B;IACxD,IAAI,OAAO;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,OAAe;IACnC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,IAAI,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AACnE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;QACd,OAAO,GAAG,EAAE,IAAI,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,MAAyC;IAEzC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,MAAM,EAAE,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAa,EACb,QAAgB,EAChB,OAAe;IAEf,OAAO,CAAC,KAAK,KAAK,KAAK,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAmD;IACjF,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YACjB,KAAK,CAAC,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;YACzB,2BAA2B;YAC3B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,4BAA4B;IAC7C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB,EAAE,SAAS,GAAG,KAAK;IACpE,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;IAC/C,OAAO,CAAC,OAAO,MAAM,iBAAiB,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;AACtE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAS,GAAG,KAAK;IAChD,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;IAC/C,KAAK,CAAC,OAAO,MAAM,SAAS,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,4BAA4B,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,OAAO;IACP,KAAK;IACL,OAAO;IACP,IAAI;IACJ,SAAS;IACT,IAAI;IACJ,IAAI;IACJ,UAAU;IACV,cAAc;IACd,kBAAkB;IAClB,mBAAmB;IACnB,eAAe;IACf,gBAAgB;IAChB,gBAAgB;IAChB,aAAa;CACd,CAAC"}

package/dist/cli/output.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for CLI output utilities
+ */
+export {};
+//# sourceMappingURL=output.test.d.ts.map

package/dist/cli/output.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.test.d.ts","sourceRoot":"","sources":["../../src/cli/output.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/cli/output.test.js

@@ -0,0 +1,119 @@
+/**
+ * Tests for CLI output utilities
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { formatDuration, showResourceChange, showBuildErrors, showBuildSuccess, showBuildFailure, showNoChanges, } from "./output.js";
+describe("output utilities", () => {
+    let consoleLogSpy;
+    let consoleErrorSpy;
+    beforeEach(() => {
+        consoleLogSpy = vi.spyOn(console, "log").mockImplementation(() => { });
+        consoleErrorSpy = vi.spyOn(console, "error").mockImplementation(() => { });
+    });
+    afterEach(() => {
+        consoleLogSpy.mockRestore();
+        consoleErrorSpy.mockRestore();
+    });
+    describe("formatDuration", () => {
+        it("formats milliseconds for durations under 1 second", () => {
+            expect(formatDuration(500)).toBe("500ms");
+            expect(formatDuration(0)).toBe("0ms");
+            expect(formatDuration(999)).toBe("999ms");
+        });
+        it("formats seconds for durations 1 second or more", () => {
+            expect(formatDuration(1000)).toBe("1.0s");
+            expect(formatDuration(1500)).toBe("1.5s");
+            expect(formatDuration(2345)).toBe("2.3s");
+            expect(formatDuration(10000)).toBe("10.0s");
+        });
+    });
+    describe("showResourceChange", () => {
+        it("shows created resource", () => {
+            showResourceChange("events.datasource", "created");
+            expect(consoleLogSpy).toHaveBeenCalledWith("✓ events.datasource created");
+        });
+        it("shows changed resource", () => {
+            showResourceChange("top_pages.pipe", "changed");
+            expect(consoleLogSpy).toHaveBeenCalledWith("✓ top_pages.pipe changed");
+        });
+        it("shows deleted resource", () => {
+            showResourceChange("old_data.datasource", "deleted");
+            expect(consoleLogSpy).toHaveBeenCalledWith("✓ old_data.datasource deleted");
+        });
+    });
+    describe("showBuildErrors", () => {
+        it("shows errors with filename", () => {
+            showBuildErrors([
+                { filename: "events.datasource", error: "Invalid column type" },
+            ]);
+            expect(consoleErrorSpy).toHaveBeenCalledWith("events.datasource");
+            expect(consoleErrorSpy).toHaveBeenCalledWith("  Invalid column type");
+        });
+        it("shows errors without filename", () => {
+            showBuildErrors([{ error: "General build error" }]);
+            expect(consoleErrorSpy).toHaveBeenCalledWith("General build error");
+        });
+        it("shows multiple errors", () => {
+            showBuildErrors([
+                { filename: "a.datasource", error: "Error A" },
+                { filename: "b.pipe", error: "Error B" },
+            ]);
+            expect(consoleErrorSpy).toHaveBeenCalledWith("a.datasource");
+            expect(consoleErrorSpy).toHaveBeenCalledWith("  Error A");
+            expect(consoleErrorSpy).toHaveBeenCalledWith("b.pipe");
+            expect(consoleErrorSpy).toHaveBeenCalledWith("  Error B");
+        });
+        it("handles multi-line errors", () => {
+            showBuildErrors([
+                { filename: "test.pipe", error: "Line 1\nLine 2\nLine 3" },
+            ]);
+            expect(consoleErrorSpy).toHaveBeenCalledWith("test.pipe");
+            expect(consoleErrorSpy).toHaveBeenCalledWith("  Line 1");
+            expect(consoleErrorSpy).toHaveBeenCalledWith("  Line 2");
+            expect(consoleErrorSpy).toHaveBeenCalledWith("  Line 3");
+        });
+    });
+    describe("showBuildSuccess", () => {
+        it("shows build success with duration in ms", () => {
+            showBuildSuccess(500);
+            expect(consoleLogSpy).toHaveBeenCalled();
+            const call = consoleLogSpy.mock.calls[0][0];
+            expect(call).toContain("✓");
+            expect(call).toContain("Build completed in 500ms");
+        });
+        it("shows build success with duration in seconds", () => {
+            showBuildSuccess(2500);
+            expect(consoleLogSpy).toHaveBeenCalled();
+            const call = consoleLogSpy.mock.calls[0][0];
+            expect(call).toContain("Build completed in 2.5s");
+        });
+        it("shows rebuild success when isRebuild is true", () => {
+            showBuildSuccess(1000, true);
+            expect(consoleLogSpy).toHaveBeenCalled();
+            const call = consoleLogSpy.mock.calls[0][0];
+            expect(call).toContain("Rebuild completed in 1.0s");
+        });
+    });
+    describe("showBuildFailure", () => {
+        it("shows build failure", () => {
+            showBuildFailure();
+            expect(consoleErrorSpy).toHaveBeenCalled();
+            const call = consoleErrorSpy.mock.calls[0][0];
+            expect(call).toContain("✗");
+            expect(call).toContain("Build failed");
+        });
+        it("shows rebuild failure when isRebuild is true", () => {
+            showBuildFailure(true);
+            expect(consoleErrorSpy).toHaveBeenCalled();
+            const call = consoleErrorSpy.mock.calls[0][0];
+            expect(call).toContain("Rebuild failed");
+        });
+    });
+    describe("showNoChanges", () => {
+        it("shows no changes message", () => {
+            showNoChanges();
+            expect(consoleLogSpy).toHaveBeenCalledWith("No changes. Build skipped.");
+        });
+    });
+});
+//# sourceMappingURL=output.test.js.map

package/dist/cli/output.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.test.js","sourceRoot":"","sources":["../../src/cli/output.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tinybirdco/sdk",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "description": "TypeScript SDK for Tinybird Forward - define datasources and pipes as TypeScript",
   "type": "module",
   "main": "./dist/index.js",

package/src/api/branches.test.ts

@@ -7,6 +7,7 @@ import {
   deleteBranch,
   branchExists,
   getOrCreateBranch,
+  clearBranch,
   type BranchApiConfig,
 } from "./branches.js";
 
@@ -271,16 +272,39 @@ describe("Branch API client", () => {
 
   describe("deleteBranch", () => {
     it("deletes a branch successfully", async () => {
+      const mockBranch = {
+        id: "branch-123",
+        name: "my-feature",
+        token: "p.branch-token",
+        created_at: "2024-01-01T00:00:00Z",
+      };
+
+      // 1. getBranch to get the ID
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: () => Promise.resolve(mockBranch),
+      });
+
+      // 2. DELETE the branch by ID
       mockFetch.mockResolvedValueOnce({
         ok: true,
       });
 
       await deleteBranch(config, "my-feature");
 
-      const [url, init] = mockFetch.mock.calls[0];
-      const parsed = expectFromParam(url);
-      expect(parsed.pathname).toBe("/v1/environments/my-feature");
-      expect(init).toEqual({
+      expect(mockFetch).toHaveBeenCalledTimes(2);
+
+      // First call: get branch
+      const [getUrl, getInit] = mockFetch.mock.calls[0];
+      const getParsed = expectFromParam(getUrl);
+      expect(getParsed.pathname).toBe("/v0/environments/my-feature");
+      expect(getInit.method).toBe("GET");
+
+      // Second call: delete branch by ID
+      const [deleteUrl, deleteInit] = mockFetch.mock.calls[1];
+      const deleteParsed = expectFromParam(deleteUrl);
+      expect(deleteParsed.pathname).toBe("/v0/environments/branch-123");
+      expect(deleteInit).toEqual({
         method: "DELETE",
         headers: {
           Authorization: "Bearer p.test-token",
@@ -382,4 +406,92 @@ describe("Branch API client", () => {
       expect(mockFetch).toHaveBeenCalledTimes(4);
     });
   });
+
+  describe("clearBranch", () => {
+    it("clears a branch by deleting and recreating it", async () => {
+      const existingBranch = {
+        id: "branch-old",
+        name: "my-feature",
+        token: "p.old-token",
+        created_at: "2024-01-01T00:00:00Z",
+      };
+
+      const newBranch = {
+        id: "branch-new",
+        name: "my-feature",
+        token: "p.new-token",
+        created_at: "2024-01-02T00:00:00Z",
+      };
+
+      // 1. GET branch to get ID (for delete)
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: () => Promise.resolve(existingBranch),
+      });
+
+      // 2. DELETE branch by ID
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+      });
+
+      // 3. POST to /v1/environments returns a job
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: () => Promise.resolve({
+          job: { id: "job-789", status: "waiting" },
+          workspace: { id: "ws-789" },
+        }),
+      });
+
+      // 4. Poll job - done
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: () => Promise.resolve({ id: "job-789", status: "done" }),
+      });
+
+      // 5. Get branch with token (after create)
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: () => Promise.resolve(newBranch),
+      });
+
+      const result = await clearBranch(config, "my-feature");
+
+      expect(mockFetch).toHaveBeenCalledTimes(5);
+
+      // Verify get was called first
+      const [getUrl, getInit] = mockFetch.mock.calls[0];
+      const getParsed = expectFromParam(getUrl);
+      expect(getParsed.pathname).toBe("/v0/environments/my-feature");
+      expect(getInit.method).toBe("GET");
+
+      // Verify delete was called with ID
+      const [deleteUrl, deleteInit] = mockFetch.mock.calls[1];
+      const deleteParsed = expectFromParam(deleteUrl);
+      expect(deleteParsed.pathname).toBe("/v0/environments/branch-old");
+      expect(deleteInit.method).toBe("DELETE");
+
+      // Verify create was called
+      const [createUrl, createInit] = mockFetch.mock.calls[2];
+      const createParsed = expectFromParam(createUrl);
+      expect(createParsed.pathname).toBe("/v1/environments");
+      expect(createParsed.searchParams.get("name")).toBe("my-feature");
+      expect(createInit.method).toBe("POST");
+
+      expect(result).toEqual(newBranch);
+    });
+
+    it("throws BranchApiError when branch does not exist", async () => {
+      mockFetch.mockResolvedValueOnce({
+        ok: false,
+        status: 404,
+        statusText: "Not Found",
+        text: () => Promise.resolve("Branch not found"),
+      });
+
+      await expect(clearBranch(config, "nonexistent")).rejects.toThrow(
+        BranchApiError
+      );
+    });
+  });
 });

package/src/api/branches.ts

@@ -264,7 +264,10 @@ export async function getBranch(
 
 /**
  * Delete a branch
- * DELETE /v1/environments/{name}
+ * DELETE /v0/environments/{id}
+ *
+ * Note: The API requires the branch ID, not name. This function first
+ * fetches the branch to get its ID, then deletes it.
  *
  * @param config - API configuration
  * @param name - Branch name to delete
@@ -273,7 +276,10 @@ export async function deleteBranch(
   config: BranchApiConfig,
   name: string
 ): Promise<void> {
-  const url = new URL(`/v1/environments/${encodeURIComponent(name)}`, config.baseUrl);
+  // First get the branch to find its ID
+  const branch = await getBranch(config, name);
+
+  const url = new URL(`/v0/environments/${branch.id}`, config.baseUrl);
 
   const response = await tinybirdFetch(url.toString(), {
     method: "DELETE",
@@ -334,3 +340,23 @@ export async function getOrCreateBranch(
     throw error;
   }
 }
+
+/**
+ * Clear a branch by deleting and recreating it
+ *
+ * @param config - API configuration
+ * @param name - Branch name to clear
+ * @returns The recreated branch with token
+ */
+export async function clearBranch(
+  config: BranchApiConfig,
+  name: string
+): Promise<TinybirdBranch> {
+  // Delete the branch
+  await deleteBranch(config, name);
+
+  // Recreate the branch
+  const branch = await createBranch(config, name);
+
+  return branch;
+}

package/src/api/build.ts

@@ -83,8 +83,10 @@ export interface BuildApiResult {
   success: boolean;
   /** Result status from API */
   result: "success" | "failed" | "no_changes";
-  /** Error message if failed */
+  /** Error message if failed (formatted for display) */
   error?: string;
+  /** Detailed errors array from the API */
+  errors?: BuildError[];
   /** Number of datasources deployed */
   datasourceCount: number;
   /** Number of pipes deployed */
@@ -233,6 +235,7 @@ export async function buildToTinybird(
       success: false,
       result: "failed",
       error: formatErrors(),
+      errors: body.errors,
       datasourceCount: resources.datasources.length,
       pipeCount: resources.pipes.length,
       connectionCount: resources.connections?.length ?? 0,
@@ -245,6 +248,7 @@ export async function buildToTinybird(
       success: false,
       result: "failed",
       error: formatErrors(),
+      errors: body.errors,
       datasourceCount: resources.datasources.length,
       pipeCount: resources.pipes.length,
       connectionCount: resources.connections?.length ?? 0,