@tinybirdco/sdk 0.0.2 → 0.0.4

package/dist/api/local.test.js

@@ -0,0 +1,182 @@
+import { describe, it, expect, beforeAll, afterEach, afterAll } from "vitest";
+import { setupServer } from "msw/node";
+import { http, HttpResponse } from "msw";
+import { getLocalTokens, listLocalWorkspaces, createLocalWorkspace, getOrCreateLocalWorkspace, isLocalRunning, getLocalWorkspaceName, LocalNotRunningError, LocalApiError, } from "./local.js";
+import { LOCAL_BASE_URL } from "../cli/config.js";
+const server = setupServer();
+beforeAll(() => server.listen({ onUnhandledRequest: "error" }));
+afterEach(() => server.resetHandlers());
+afterAll(() => server.close());
+describe("Local API", () => {
+    describe("isLocalRunning", () => {
+        it("returns true when local container is running", async () => {
+            server.use(http.get(`${LOCAL_BASE_URL}/tokens`, () => {
+                return HttpResponse.json({
+                    user_token: "user-token",
+                    admin_token: "admin-token",
+                    workspace_admin_token: "workspace-token",
+                });
+            }));
+            const result = await isLocalRunning();
+            expect(result).toBe(true);
+        });
+        it("returns false when local container is not running", async () => {
+            server.use(http.get(`${LOCAL_BASE_URL}/tokens`, () => {
+                return HttpResponse.error();
+            }));
+            const result = await isLocalRunning();
+            expect(result).toBe(false);
+        });
+    });
+    describe("getLocalTokens", () => {
+        it("returns tokens from local container", async () => {
+            server.use(http.get(`${LOCAL_BASE_URL}/tokens`, () => {
+                return HttpResponse.json({
+                    user_token: "user-token-123",
+                    admin_token: "admin-token-456",
+                    workspace_admin_token: "workspace-token-789",
+                });
+            }));
+            const tokens = await getLocalTokens();
+            expect(tokens.user_token).toBe("user-token-123");
+            expect(tokens.admin_token).toBe("admin-token-456");
+            expect(tokens.workspace_admin_token).toBe("workspace-token-789");
+        });
+        it("throws LocalNotRunningError when container is not running", async () => {
+            server.use(http.get(`${LOCAL_BASE_URL}/tokens`, () => {
+                return HttpResponse.error();
+            }));
+            await expect(getLocalTokens()).rejects.toThrow(LocalNotRunningError);
+        });
+        it("throws LocalApiError when response is invalid", async () => {
+            server.use(http.get(`${LOCAL_BASE_URL}/tokens`, () => {
+                return HttpResponse.json({
+                    // Missing required fields
+                    user_token: "user-token",
+                });
+            }));
+            await expect(getLocalTokens()).rejects.toThrow(LocalApiError);
+        });
+    });
+    describe("listLocalWorkspaces", () => {
+        it("returns list of workspaces", async () => {
+            server.use(http.get(`${LOCAL_BASE_URL}/v1/user/workspaces`, () => {
+                return HttpResponse.json({
+                    organization_id: "org-123",
+                    workspaces: [
+                        { id: "ws-1", name: "Workspace1", token: "token-1" },
+                        { id: "ws-2", name: "Workspace2", token: "token-2" },
+                    ],
+                });
+            }));
+            const result = await listLocalWorkspaces("admin-token");
+            expect(result.organizationId).toBe("org-123");
+            expect(result.workspaces).toHaveLength(2);
+            expect(result.workspaces[0]).toEqual({
+                id: "ws-1",
+                name: "Workspace1",
+                token: "token-1",
+            });
+        });
+        it("throws LocalApiError on failure", async () => {
+            server.use(http.get(`${LOCAL_BASE_URL}/v1/user/workspaces`, () => {
+                return new HttpResponse("Not found", { status: 404 });
+            }));
+            await expect(listLocalWorkspaces("admin-token")).rejects.toThrow(LocalApiError);
+        });
+    });
+    describe("createLocalWorkspace", () => {
+        it("creates a new workspace", async () => {
+            server.use(http.post(`${LOCAL_BASE_URL}/v1/workspaces`, async ({ request }) => {
+                const formData = await request.text();
+                const params = new URLSearchParams(formData);
+                return HttpResponse.json({
+                    id: "new-ws-id",
+                    name: params.get("name"),
+                    token: "new-ws-token",
+                });
+            }));
+            const result = await createLocalWorkspace("user-token", "TestWorkspace");
+            expect(result.id).toBe("new-ws-id");
+            expect(result.name).toBe("TestWorkspace");
+            expect(result.token).toBe("new-ws-token");
+        });
+        it("throws LocalApiError on failure", async () => {
+            server.use(http.post(`${LOCAL_BASE_URL}/v1/workspaces`, () => {
+                return new HttpResponse("Server error", { status: 500 });
+            }));
+            await expect(createLocalWorkspace("user-token", "TestWorkspace")).rejects.toThrow(LocalApiError);
+        });
+    });
+    describe("getOrCreateLocalWorkspace", () => {
+        const tokens = {
+            user_token: "user-token",
+            admin_token: "admin-token",
+            workspace_admin_token: "default-token",
+        };
+        it("returns existing workspace if found", async () => {
+            server.use(http.get(`${LOCAL_BASE_URL}/v1/user/workspaces`, () => {
+                return HttpResponse.json({
+                    organization_id: "org-123",
+                    workspaces: [
+                        { id: "existing-ws", name: "MyWorkspace", token: "existing-token" },
+                    ],
+                });
+            }));
+            const result = await getOrCreateLocalWorkspace(tokens, "MyWorkspace");
+            expect(result.wasCreated).toBe(false);
+            expect(result.workspace.name).toBe("MyWorkspace");
+            expect(result.workspace.token).toBe("existing-token");
+        });
+        it("creates new workspace if not found", async () => {
+            let createCalled = false;
+            server.use(http.get(`${LOCAL_BASE_URL}/v1/user/workspaces`, () => {
+                // Return different response based on whether create was called
+                if (createCalled) {
+                    return HttpResponse.json({
+                        organization_id: "org-123",
+                        workspaces: [
+                            { id: "new-ws", name: "NewWorkspace", token: "new-token" },
+                        ],
+                    });
+                }
+                return HttpResponse.json({
+                    organization_id: "org-123",
+                    workspaces: [], // Empty initially
+                });
+            }), http.post(`${LOCAL_BASE_URL}/v1/workspaces`, () => {
+                createCalled = true;
+                return HttpResponse.json({
+                    id: "new-ws",
+                    name: "NewWorkspace",
+                    token: "new-token",
+                });
+            }));
+            const result = await getOrCreateLocalWorkspace(tokens, "NewWorkspace");
+            expect(result.wasCreated).toBe(true);
+            expect(result.workspace.name).toBe("NewWorkspace");
+            expect(result.workspace.token).toBe("new-token");
+        });
+    });
+    describe("getLocalWorkspaceName", () => {
+        it("uses branch name when available", () => {
+            const name = getLocalWorkspaceName("feature_branch", "/some/path");
+            expect(name).toBe("feature_branch");
+        });
+        it("uses hash-based name when no branch", () => {
+            const name = getLocalWorkspaceName(null, "/some/path");
+            expect(name).toMatch(/^Build_[a-f0-9]{16}$/);
+        });
+        it("generates consistent hash for same path", () => {
+            const name1 = getLocalWorkspaceName(null, "/same/path");
+            const name2 = getLocalWorkspaceName(null, "/same/path");
+            expect(name1).toBe(name2);
+        });
+        it("generates different hash for different paths", () => {
+            const name1 = getLocalWorkspaceName(null, "/path/one");
+            const name2 = getLocalWorkspaceName(null, "/path/two");
+            expect(name1).not.toBe(name2);
+        });
+    });
+});
+//# sourceMappingURL=local.test.js.map

package/dist/api/local.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.test.js","sourceRoot":"","sources":["../../src/api/local.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,KAAK,CAAC;AACzC,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;AAE7B,SAAS,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;AAChE,SAAS,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;AACxC,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;AAE/B,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;YAC5D,MAAM,CAAC,GAAG,CACR,IAAI,CAAC,GAAG,CAAC,GAAG,cAAc,SAAS,EAAE,GAAG,EAAE;gBACxC,OAAO,YAAY,CAAC,IAAI,CAAC;oBACvB,UAAU,EAAE,YAAY;oBACxB,WAAW,EAAE,aAAa;oBAC1B,qBAAqB,EAAE,iBAAiB;iBACzC,CAAC,CAAC;YACL,CAAC,CAAC,CACH,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;YACjE,MAAM,CAAC,GAAG,CACR,IAAI,CAAC,GAAG,CAAC,GAAG,cAAc,SAAS,EAAE,GAAG,EAAE;gBACxC,OAAO,YAAY,CAAC,KAAK,EAAE,CAAC;YAC9B,CAAC,CAAC,CACH,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;YACnD,MAAM,CAAC,GAAG,CACR,IAAI,CAAC,GAAG,CAAC,GAAG,cAAc,SAAS,EAAE,GAAG,EAAE;gBACxC,OAAO,YAAY,CAAC,IAAI,CAAC;oBACvB,UAAU,EAAE,gBAAgB;oBAC5B,WAAW,EAAE,iBAAiB;oBAC9B,qBAAqB,EAAE,qBAAqB;iBAC7C,CAAC,CAAC;YACL,CAAC,CAAC,CACH,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE,CAAC;YAEtC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACjD,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YACnD,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;YACzE,MAAM,CAAC,GAAG,CACR,IAAI,CAAC,GAAG,CAAC,GAAG,cAAc,SAAS,EAAE,GAAG,EAAE;gBACxC,OAAO,YAAY,CAAC,KAAK,EAAE,CAAC;YAC9B,CAAC,CAAC,CACH,CAAC;YAEF,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;YAC7D,MAAM,CAAC,GAAG,CACR,IAAI,CAAC,GAAG,CAAC,GAAG,cAAc,SAAS,EAAE,GAAG,EAAE;gBACxC,OAAO,YAAY,CAAC,IAAI,CAAC;oBACvB,0BAA0B;oBAC1B,UAAU,EAAE,YAAY;iBACzB,CAAC,CAAC;YACL,CAAC,CAAC,CACH,CAAC;YAEF,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;YAC1C,MAAM,CAAC,GAAG,CACR,IAAI,CAAC,GAAG,CAAC,GAAG,cAAc,qBAAqB,EAAE,GAAG,EAAE;gBACpD,OAAO,YAAY,CAAC,IAAI,CAAC;oBACvB,eAAe,EAAE,SAAS;oBAC1B,UAAU,EAAE;wBACV,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE;wBACpD,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE;qBACrD;iBACF,CAAC,CAAC;YACL,CAAC,CAAC,CACH,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,aAAa,CAAC,CAAC;YAExD,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC9C,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC1C,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBACnC,EAAE,EAAE,MAAM;gBACV,IAAI,EAAE,YAAY;gBAClB,KAAK,EAAE,SAAS;aACjB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;YAC/C,MAAM,CAAC,GAAG,CACR,IAAI,CAAC,GAAG,CAAC,GAAG,cAAc,qBAAqB,EAAE,GAAG,EAAE;gBACpD,OAAO,IAAI,YAAY,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACxD,CAAC,CAAC,CACH,CAAC;YAEF,MAAM,MAAM,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAClF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;QACpC,EAAE,CAAC,yBAAyB,EAAE,KAAK,IAAI,EAAE;YACvC,MAAM,CAAC,GAAG,CACR,IAAI,CAAC,IAAI,CAAC,GAAG,cAAc,gBAAgB,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;gBACjE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;gBACtC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,QAAQ,CAAC,CAAC;gBAC7C,OAAO,YAAY,CAAC,IAAI,CAAC;oBACvB,EAAE,EAAE,WAAW;oBACf,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;oBACxB,KAAK,EAAE,cAAc;iBACtB,CAAC,CAAC;YACL,CAAC,CAAC,CACH,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;YAEzE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACpC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC1C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;YAC/C,MAAM,CAAC,GAAG,CACR,IAAI,CAAC,IAAI,CAAC,GAAG,cAAc,gBAAgB,EAAE,GAAG,EAAE;gBAChD,OAAO,IAAI,YAAY,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YAC3D,CAAC,CAAC,CACH,CAAC;YAEF,MAAM,MAAM,CAAC,oBAAoB,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAC/E,aAAa,CACd,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACzC,MAAM,MAAM,GAAG;YACb,UAAU,EAAE,YAAY;YACxB,WAAW,EAAE,aAAa;YAC1B,qBAAqB,EAAE,eAAe;SACvC,CAAC;QAEF,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;YACnD,MAAM,CAAC,GAAG,CACR,IAAI,CAAC,GAAG,CAAC,GAAG,cAAc,qBAAqB,EAAE,GAAG,EAAE;gBACpD,OAAO,YAAY,CAAC,IAAI,CAAC;oBACvB,eAAe,EAAE,SAAS;oBAC1B,UAAU,EAAE;wBACV,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,gBAAgB,EAAE;qBACpE;iBACF,CAAC,CAAC;YACL,CAAC,CAAC,CACH,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;YAEtE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAClD,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;YAClD,IAAI,YAAY,GAAG,KAAK,CAAC;YAEzB,MAAM,CAAC,GAAG,CACR,IAAI,CAAC,GAAG,CAAC,GAAG,cAAc,qBAAqB,EAAE,GAAG,EAAE;gBACpD,+DAA+D;gBAC/D,IAAI,YAAY,EAAE,CAAC;oBACjB,OAAO,YAAY,CAAC,IAAI,CAAC;wBACvB,eAAe,EAAE,SAAS;wBAC1B,UAAU,EAAE;4BACV,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE;yBAC3D;qBACF,CAAC,CAAC;gBACL,CAAC;gBACD,OAAO,YAAY,CAAC,IAAI,CAAC;oBACvB,eAAe,EAAE,SAAS;oBAC1B,UAAU,EAAE,EAAE,EAAE,kBAAkB;iBACnC,CAAC,CAAC;YACL,CAAC,CAAC,EACF,IAAI,CAAC,IAAI,CAAC,GAAG,cAAc,gBAAgB,EAAE,GAAG,EAAE;gBAChD,YAAY,GAAG,IAAI,CAAC;gBACpB,OAAO,YAAY,CAAC,IAAI,CAAC;oBACvB,EAAE,EAAE,QAAQ;oBACZ,IAAI,EAAE,cAAc;oBACpB,KAAK,EAAE,WAAW;iBACnB,CAAC,CAAC;YACL,CAAC,CAAC,CACH,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;YAEvE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACnD,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;QACrC,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YACzC,MAAM,IAAI,GAAG,qBAAqB,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;YACnE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC7C,MAAM,IAAI,GAAG,qBAAqB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YACvD,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YACjD,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YACxD,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YACxD,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YACvD,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YACvD,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/cli/commands/build.d.ts

@@ -1,6 +1,7 @@
 /**
  * Build command - generates and pushes resources to Tinybird
  */
+import { type DevMode } from "../config.js";
 import { type BuildFromIncludeResult } from "../../generator/index.js";
 import { type BuildApiResult } from "../../api/build.js";
 /**
@@ -15,6 +16,8 @@ export interface BuildCommandOptions {
     tokenOverride?: string;
     /** Use /v1/deploy instead of /v1/build (for main branch) */
     useDeployEndpoint?: boolean;
+    /** Override the devMode from config */
+    devModeOverride?: DevMode;
 }
 /**
  * Build command result

package/dist/cli/commands/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/build.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAoB,KAAK,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACzF,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAI1E;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,wCAAwC;IACxC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAsI7F"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/build.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAmD,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAC7F,OAAO,EAAoB,KAAK,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACzF,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAU1E;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,uCAAuC;IACvC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,wCAAwC;IACxC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAgM7F"}

package/dist/cli/commands/build.js

@@ -1,11 +1,12 @@
 /**
  * Build command - generates and pushes resources to Tinybird
  */
-import { loadConfig } from "../config.js";
+import { loadConfig, LOCAL_BASE_URL } from "../config.js";
 import { buildFromInclude } from "../../generator/index.js";
 import { buildToTinybird } from "../../api/build.js";
 import { deployToMain } from "../../api/deploy.js";
 import { getOrCreateBranch } from "../../api/branches.js";
+import { getLocalTokens, getOrCreateLocalWorkspace, getLocalWorkspaceName, LocalNotRunningError, } from "../../api/local.js";
 /**
  * Run the build command
  *
@@ -52,73 +53,122 @@ export async function runBuild(options = {}) {
             durationMs: Date.now() - startTime,
         };
     }
-    // Deploy to Tinybird
-    // Determine token and endpoint based on git branch
-    let effectiveToken = options.tokenOverride ?? config.token;
-    let useDeployEndpoint = options.useDeployEndpoint ?? config.isMainBranch;
-    // For feature branches, get or create the Tinybird branch and use its token
+    // Determine devMode
+    const devMode = options.devModeOverride ?? config.devMode;
     const debug = !!process.env.TINYBIRD_DEBUG;
     if (debug) {
-        console.log(`[debug] isMainBranch: ${config.isMainBranch}`);
-        console.log(`[debug] tinybirdBranch: ${config.tinybirdBranch}`);
-        console.log(`[debug] tokenOverride: ${!!options.tokenOverride}`);
+        console.log(`[debug] devMode: ${devMode}`);
     }
-    if (!config.isMainBranch && config.tinybirdBranch && !options.tokenOverride) {
-        if (debug) {
-            console.log(`[debug] Getting/creating Tinybird branch: ${config.tinybirdBranch}`);
-        }
+    let deployResult;
+    // Handle local mode
+    if (devMode === "local") {
         try {
-            const tinybirdBranch = await getOrCreateBranch({
-                baseUrl: config.baseUrl,
-                token: config.token,
-            }, config.tinybirdBranch);
-            if (!tinybirdBranch.token) {
+            // Get tokens from local container
+            if (debug) {
+                console.log(`[debug] Getting local tokens from ${LOCAL_BASE_URL}/tokens`);
+            }
+            const localTokens = await getLocalTokens();
+            // Get or create workspace based on branch name
+            const workspaceName = getLocalWorkspaceName(config.tinybirdBranch, config.cwd);
+            if (debug) {
+                console.log(`[debug] Using local workspace: ${workspaceName}`);
+            }
+            const { workspace, wasCreated } = await getOrCreateLocalWorkspace(localTokens, workspaceName);
+            if (debug) {
+                console.log(`[debug] Workspace ${wasCreated ? "created" : "found"}: ${workspace.name}`);
+            }
+            // Always use /v1/build for local (no deploy endpoint)
+            deployResult = await buildToTinybird({
+                baseUrl: LOCAL_BASE_URL,
+                token: workspace.token,
+            }, buildResult.resources);
+        }
+        catch (error) {
+            if (error instanceof LocalNotRunningError) {
                 return {
                     success: false,
                     build: buildResult,
-                    error: `Branch '${config.tinybirdBranch}' was created but no token was returned.`,
+                    error: error.message,
                     durationMs: Date.now() - startTime,
                 };
             }
-            effectiveToken = tinybirdBranch.token;
-            useDeployEndpoint = false; // Always use /v1/build for branches
+            return {
+                success: false,
+                build: buildResult,
+                error: `Local build failed: ${error.message}`,
+                durationMs: Date.now() - startTime,
+            };
+        }
+    }
+    else {
+        // Branch mode (default) - existing logic
+        // Deploy to Tinybird
+        // Determine token and endpoint based on git branch
+        let effectiveToken = options.tokenOverride ?? config.token;
+        // Use deploy endpoint if on main branch OR if no branch can be detected
+        let useDeployEndpoint = options.useDeployEndpoint ?? (config.isMainBranch || !config.tinybirdBranch);
+        if (debug) {
+            console.log(`[debug] isMainBranch: ${config.isMainBranch}`);
+            console.log(`[debug] tinybirdBranch: ${config.tinybirdBranch}`);
+            console.log(`[debug] tokenOverride: ${!!options.tokenOverride}`);
+        }
+        // For feature branches, get or create the Tinybird branch and use its token
+        if (!config.isMainBranch && config.tinybirdBranch && !options.tokenOverride) {
             if (debug) {
-                console.log(`[debug] Using branch token for branch: ${config.tinybirdBranch}`);
+                console.log(`[debug] Getting/creating Tinybird branch: ${config.tinybirdBranch}`);
+            }
+            try {
+                const tinybirdBranch = await getOrCreateBranch({
+                    baseUrl: config.baseUrl,
+                    token: config.token,
+                }, config.tinybirdBranch);
+                if (!tinybirdBranch.token) {
+                    return {
+                        success: false,
+                        build: buildResult,
+                        error: `Branch '${config.tinybirdBranch}' was created but no token was returned.`,
+                        durationMs: Date.now() - startTime,
+                    };
+                }
+                effectiveToken = tinybirdBranch.token;
+                useDeployEndpoint = false; // Always use /v1/build for branches
+                if (debug) {
+                    console.log(`[debug] Using branch token for branch: ${config.tinybirdBranch}`);
+                }
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    build: buildResult,
+                    error: `Failed to get/create branch: ${error.message}`,
+                    durationMs: Date.now() - startTime,
+                };
+            }
+        }
+        try {
+            // Use /v1/deploy for main branch, /v1/build for feature branches
+            if (useDeployEndpoint) {
+                deployResult = await deployToMain({
+                    baseUrl: config.baseUrl,
+                    token: effectiveToken,
+                }, buildResult.resources);
+            }
+            else {
+                deployResult = await buildToTinybird({
+                    baseUrl: config.baseUrl,
+                    token: effectiveToken,
+                }, buildResult.resources);
             }
         }
         catch (error) {
             return {
                 success: false,
                 build: buildResult,
-                error: `Failed to get/create branch: ${error.message}`,
+                error: `Deploy failed: ${error.message}`,
                 durationMs: Date.now() - startTime,
             };
         }
     }
-    let deployResult;
-    try {
-        // Use /v1/deploy for main branch, /v1/build for feature branches
-        if (useDeployEndpoint) {
-            deployResult = await deployToMain({
-                baseUrl: config.baseUrl,
-                token: effectiveToken,
-            }, buildResult.resources);
-        }
-        else {
-            deployResult = await buildToTinybird({
-                baseUrl: config.baseUrl,
-                token: effectiveToken,
-            }, buildResult.resources);
-        }
-    }
-    catch (error) {
-        return {
-            success: false,
-            build: buildResult,
-            error: `Deploy failed: ${error.message}`,
-            durationMs: Date.now() - startTime,
-        };
-    }
     if (!deployResult.success) {
         return {
             success: false,

package/dist/cli/commands/build.js.map

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

package/dist/cli/commands/dev.d.ts

@@ -1,10 +1,11 @@
 /**
  * Dev command - watch mode with automatic sync
  */
-import { type ResolvedConfig } from "../config.js";
+import { type ResolvedConfig, type DevMode } from "../config.js";
 import { type BuildCommandResult } from "./build.js";
 import { type TinybirdBranch } from "../../api/branches.js";
 import { type SchemaValidationResult } from "../utils/schema-validation.js";
+import { type LocalWorkspace } from "../../api/local.js";
 /**
  * Login result info
  */
@@ -34,6 +35,8 @@ export interface DevCommandOptions {
     onLoginComplete?: (info: LoginInfo) => void;
     /** Callback when schema validation completes */
     onSchemaValidation?: (result: SchemaValidationResult) => void;
+    /** Override the devMode from config */
+    devModeOverride?: DevMode;
 }
 /**
  * Information about the branch being used
@@ -43,10 +46,14 @@ export interface BranchReadyInfo {
     gitBranch: string | null;
     /** Whether we're on the main branch */
     isMainBranch: boolean;
-    /** Tinybird branch info (null if on main) */
+    /** Tinybird branch info (null if on main or local mode) */
     tinybirdBranch?: TinybirdBranch;
     /** Whether the branch was newly created */
     wasCreated?: boolean;
+    /** Whether using local mode */
+    isLocal?: boolean;
+    /** Local workspace info (only in local mode) */
+    localWorkspace?: LocalWorkspace;
 }
 /**
  * Dev command controller

package/dist/cli/commands/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/dev.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAyE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC1H,OAAO,EAAY,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG/E,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,+BAA+B,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,oCAAoC;IACpC,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACvD,oCAAoC;IACpC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,+CAA+C;IAC/C,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC;IAChD,kDAAkD;IAClD,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAC5C,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,sBAAsB,KAAK,IAAI,CAAC;CAC/D;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sBAAsB;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,uCAAuC;IACvC,YAAY,EAAE,OAAO,CAAC;IACtB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,2CAA2C;IAC3C,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,+BAA+B;IAC/B,OAAO,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC3C,mCAAmC;IACnC,MAAM,EAAE,cAAc,CAAC;IACvB,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB;IAClB,UAAU,EAAE,eAAe,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,MAAM,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,aAAa,CAAC,CAoPpF"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/dev.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAyF,KAAK,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AACxJ,OAAO,EAAY,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG/E,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,oCAAoC;IACpC,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACvD,oCAAoC;IACpC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,+CAA+C;IAC/C,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC;IAChD,kDAAkD;IAClD,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAC5C,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,sBAAsB,KAAK,IAAI,CAAC;IAC9D,uCAAuC;IACvC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sBAAsB;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,uCAAuC;IACvC,YAAY,EAAE,OAAO,CAAC;IACtB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,2CAA2C;IAC3C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,+BAA+B;IAC/B,OAAO,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC3C,mCAAmC;IACnC,MAAM,EAAE,cAAc,CAAC;IACvB,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB;IAClB,UAAU,EAAE,eAAe,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,MAAM,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,aAAa,CAAC,CA8QpF"}

package/dist/cli/commands/dev.js

@@ -3,12 +3,13 @@
  */
 import * as path from "path";
 import { watch } from "chokidar";
-import { loadConfig, configExists, findConfigFile, hasValidToken, updateConfig } from "../config.js";
+import { loadConfig, configExists, findConfigFile, hasValidToken, updateConfig, LOCAL_BASE_URL } from "../config.js";
 import { runBuild } from "./build.js";
 import { getOrCreateBranch } from "../../api/branches.js";
 import { browserLogin } from "../auth.js";
 import { saveTinybirdToken } from "../env.js";
 import { validatePipeSchemas, } from "../utils/schema-validation.js";
+import { getLocalTokens, getOrCreateLocalWorkspace, getLocalWorkspaceName, } from "../../api/local.js";
 /**
  * Run the dev command
  *
@@ -27,8 +28,18 @@ export async function runDev(options = {}) {
     if (!configExists(cwd)) {
         throw new Error("No tinybird.json found. Run 'npx tinybird init' to initialize a project.");
     }
-    // Check if authentication is set up, if not trigger login
-    if (!hasValidToken(cwd)) {
+    // Load config first to determine devMode
+    let config;
+    try {
+        config = loadConfig(cwd);
+    }
+    catch (error) {
+        throw error;
+    }
+    // Determine devMode
+    const devMode = options.devModeOverride ?? config.devMode;
+    // Check if authentication is set up, if not trigger login (skip for local mode)
+    if (devMode !== "local" && !hasValidToken(cwd)) {
         console.log("No authentication found. Starting login flow...\n");
         const authResult = await browserLogin();
         if (!authResult.success || !authResult.token) {
@@ -54,42 +65,55 @@ export async function runDev(options = {}) {
             workspaceName: authResult.workspaceName,
             userEmail: authResult.userEmail,
         });
-    }
-    // Load config (now should have valid token)
-    let config;
-    try {
+        // Reload config after login
         config = loadConfig(cwd);
     }
-    catch (error) {
-        throw error;
-    }
-    // Determine effective token based on git branch
+    // Determine effective token and branch info based on devMode
     let effectiveToken = config.token;
+    let effectiveBaseUrl = config.baseUrl;
     let branchInfo = {
         gitBranch: config.gitBranch,
         isMainBranch: config.isMainBranch,
     };
-    // If we're on a feature branch, get or create the Tinybird branch
-    // Use tinybirdBranch (sanitized name) for Tinybird API, gitBranch for display
-    if (!config.isMainBranch && config.tinybirdBranch) {
-        const branchName = config.tinybirdBranch; // Sanitized name for Tinybird
-        // Always fetch fresh from API to avoid stale cache issues
-        const tinybirdBranch = await getOrCreateBranch({
-            baseUrl: config.baseUrl,
-            token: config.token,
-        }, branchName);
-        if (!tinybirdBranch.token) {
-            throw new Error(`Branch '${branchName}' was created but no token was returned. ` +
-                `This may be an API issue.`);
-        }
-        effectiveToken = tinybirdBranch.token;
+    if (devMode === "local") {
+        // Local mode: get tokens from local container and set up workspace
+        const localTokens = await getLocalTokens();
+        const workspaceName = getLocalWorkspaceName(config.tinybirdBranch, config.cwd);
+        const { workspace, wasCreated } = await getOrCreateLocalWorkspace(localTokens, workspaceName);
+        effectiveToken = workspace.token;
+        effectiveBaseUrl = LOCAL_BASE_URL;
         branchInfo = {
-            gitBranch: config.gitBranch, // Original git branch name for display
-            isMainBranch: false,
-            tinybirdBranch,
-            wasCreated: tinybirdBranch.wasCreated ?? false,
+            gitBranch: config.gitBranch,
+            isMainBranch: false, // Local mode always uses build, not deploy
+            isLocal: true,
+            localWorkspace: workspace,
+            wasCreated,
         };
     }
+    else {
+        // Branch mode: use Tinybird cloud with branches
+        // If we're on a feature branch, get or create the Tinybird branch
+        // Use tinybirdBranch (sanitized name) for Tinybird API, gitBranch for display
+        if (!config.isMainBranch && config.tinybirdBranch) {
+            const branchName = config.tinybirdBranch; // Sanitized name for Tinybird
+            // Always fetch fresh from API to avoid stale cache issues
+            const tinybirdBranch = await getOrCreateBranch({
+                baseUrl: config.baseUrl,
+                token: config.token,
+            }, branchName);
+            if (!tinybirdBranch.token) {
+                throw new Error(`Branch '${branchName}' was created but no token was returned. ` +
+                    `This may be an API issue.`);
+            }
+            effectiveToken = tinybirdBranch.token;
+            branchInfo = {
+                gitBranch: config.gitBranch, // Original git branch name for display
+                isMainBranch: false,
+                tinybirdBranch,
+                wasCreated: tinybirdBranch.wasCreated ?? false,
+            };
+        }
+    }
     // Notify about branch readiness
     options.onBranchReady?.(branchInfo);
     // Get directories to watch from include paths
@@ -116,7 +140,8 @@ export async function runDev(options = {}) {
             const result = await runBuild({
                 cwd: config.cwd,
                 tokenOverride: effectiveToken,
-                useDeployEndpoint: config.isMainBranch,
+                useDeployEndpoint: devMode !== "local" && config.isMainBranch,
+                devModeOverride: devMode,
             });
             options.onBuildComplete?.(result);
             // Validate pipe schemas after successful deploy
@@ -134,7 +159,7 @@ export async function runDev(options = {}) {
                         const validation = await validatePipeSchemas({
                             entities: result.build.entities,
                             pipeNames: changedPipes,
-                            baseUrl: config.baseUrl,
+                            baseUrl: effectiveBaseUrl,
                             token: effectiveToken,
                         });
                         options.onSchemaValidation(validation);