@tinybirdco/sdk 0.0.35 → 0.0.36

package/dist/cli/region-selector.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Region selection utility for CLI commands
+ *
+ * Provides interactive region selection using @clack/prompts
+ */
+/**
+ * Result of region selection
+ */
+export interface RegionSelectionResult {
+    /** Whether selection was successful (not cancelled) */
+    success: boolean;
+    /** Selected API host URL */
+    apiHost?: string;
+    /** Selected region name (for display) */
+    regionName?: string;
+    /** Whether user cancelled */
+    cancelled?: boolean;
+}
+/**
+ * Prompt user to select a Tinybird region
+ *
+ * Fetches available regions from the API and presents an interactive selection.
+ * Falls back to hardcoded regions if the API call fails.
+ *
+ * @param defaultApiHost - Optional API host to pre-select in the prompt
+ * @returns Selected region info or cancellation result
+ */
+export declare function selectRegion(defaultApiHost?: string): Promise<RegionSelectionResult>;
+/**
+ * Get API host from config file or prompt for region selection
+ *
+ * @param configPath - Path to config file (or null if no config)
+ * @returns API host URL and source, or null if cancelled
+ */
+export declare function getApiHostWithRegionSelection(configPath: string | null): Promise<{
+    apiHost: string;
+    fromConfig: boolean;
+} | null>;
+//# sourceMappingURL=region-selector.d.ts.map

package/dist/cli/region-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"region-selector.d.ts","sourceRoot":"","sources":["../../src/cli/region-selector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA2BH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,qBAAqB,CAAC,CA2DhC;AAED;;;;;GAKG;AACH,wBAAsB,6BAA6B,CACjD,UAAU,EAAE,MAAM,GAAG,IAAI,GACxB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC,CAyB1D"}

package/dist/cli/region-selector.js

@@ -0,0 +1,118 @@
+/**
+ * Region selection utility for CLI commands
+ *
+ * Provides interactive region selection using @clack/prompts
+ */
+import * as fs from "fs";
+import * as p from "@clack/prompts";
+import { fetchRegions } from "../api/regions.js";
+/**
+ * Default fallback regions if API call fails
+ */
+const FALLBACK_REGIONS = [
+    {
+        name: "EU (GCP)",
+        api_host: "https://api.europe-west2.gcp.tinybird.co",
+        provider: "gcp",
+    },
+    {
+        name: "US East (AWS)",
+        api_host: "https://api.us-east.aws.tinybird.co",
+        provider: "aws",
+    },
+    {
+        name: "EU (Default)",
+        api_host: "https://api.tinybird.co",
+        provider: "gcp",
+    },
+];
+/**
+ * Prompt user to select a Tinybird region
+ *
+ * Fetches available regions from the API and presents an interactive selection.
+ * Falls back to hardcoded regions if the API call fails.
+ *
+ * @param defaultApiHost - Optional API host to pre-select in the prompt
+ * @returns Selected region info or cancellation result
+ */
+export async function selectRegion(defaultApiHost) {
+    let regions;
+    // Try to fetch regions from API
+    try {
+        regions = await fetchRegions();
+    }
+    catch {
+        // Fall back to hardcoded regions
+        regions = FALLBACK_REGIONS;
+    }
+    // Ensure we have at least one region
+    if (regions.length === 0) {
+        regions = FALLBACK_REGIONS;
+    }
+    // Sort regions: GCP first, then AWS
+    regions.sort((a, b) => {
+        if (a.provider === b.provider)
+            return 0;
+        return a.provider === "gcp" ? -1 : 1;
+    });
+    // Build options for p.select
+    const options = regions.map((region) => ({
+        value: region.api_host,
+        label: `${region.provider} | ${region.name}`,
+        hint: region.api_host.replace("https://", ""),
+    }));
+    // Find initial value if defaultApiHost is provided and matches a region
+    // Normalize URLs for comparison (remove trailing slashes, lowercase)
+    const normalizeUrl = (url) => url.toLowerCase().replace(/\/+$/, "");
+    const initialValue = defaultApiHost
+        ? regions.find((r) => normalizeUrl(r.api_host) === normalizeUrl(defaultApiHost))?.api_host
+        : undefined;
+    const selected = await p.select({
+        message: "Select your Tinybird region",
+        options,
+        initialValue,
+    });
+    if (p.isCancel(selected)) {
+        p.cancel("Operation cancelled");
+        return {
+            success: false,
+            cancelled: true,
+        };
+    }
+    const selectedRegion = regions.find((r) => r.api_host === selected);
+    return {
+        success: true,
+        apiHost: selected,
+        regionName: selectedRegion?.name,
+    };
+}
+/**
+ * Get API host from config file or prompt for region selection
+ *
+ * @param configPath - Path to config file (or null if no config)
+ * @returns API host URL and source, or null if cancelled
+ */
+export async function getApiHostWithRegionSelection(configPath) {
+    let existingBaseUrl;
+    // If we have a JSON config file, try to read baseUrl from it
+    if (configPath && configPath.endsWith(".json")) {
+        try {
+            const content = fs.readFileSync(configPath, "utf-8");
+            const config = JSON.parse(content);
+            existingBaseUrl = config.baseUrl;
+        }
+        catch {
+            // Ignore errors reading config
+        }
+    }
+    // Prompt for region selection, pre-selecting existing baseUrl if available
+    const result = await selectRegion(existingBaseUrl);
+    if (!result.success || !result.apiHost) {
+        return null;
+    }
+    return {
+        apiHost: result.apiHost,
+        fromConfig: false,
+    };
+}
+//# sourceMappingURL=region-selector.js.map

package/dist/cli/region-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"region-selector.js","sourceRoot":"","sources":["../../src/cli/region-selector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,YAAY,EAAuB,MAAM,mBAAmB,CAAC;AAEtE;;GAEG;AACH,MAAM,gBAAgB,GAAqB;IACzC;QACE,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,0CAA0C;QACpD,QAAQ,EAAE,KAAK;KAChB;IACD;QACE,IAAI,EAAE,eAAe;QACrB,QAAQ,EAAE,qCAAqC;QAC/C,QAAQ,EAAE,KAAK;KAChB;IACD;QACE,IAAI,EAAE,cAAc;QACpB,QAAQ,EAAE,yBAAyB;QACnC,QAAQ,EAAE,KAAK;KAChB;CACF,CAAC;AAgBF;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,cAAuB;IAEvB,IAAI,OAAyB,CAAC;IAE9B,gCAAgC;IAChC,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,YAAY,EAAE,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,iCAAiC;QACjC,OAAO,GAAG,gBAAgB,CAAC;IAC7B,CAAC;IAED,qCAAqC;IACrC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,GAAG,gBAAgB,CAAC;IAC7B,CAAC;IAED,oCAAoC;IACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACpB,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ;YAAE,OAAO,CAAC,CAAC;QACxC,OAAO,CAAC,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,6BAA6B;IAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACvC,KAAK,EAAE,MAAM,CAAC,QAAQ;QACtB,KAAK,EAAE,GAAG,MAAM,CAAC,QAAQ,MAAM,MAAM,CAAC,IAAI,EAAE;QAC5C,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;KAC9C,CAAC,CAAC,CAAC;IAEJ,wEAAwE;IACxE,qEAAqE;IACrE,MAAM,YAAY,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5E,MAAM,YAAY,GAAG,cAAc;QACjC,CAAC,CAAC,OAAO,CAAC,IAAI,CACV,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,YAAY,CAAC,cAAc,CAAC,CACjE,EAAE,QAAQ;QACb,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC;QAC9B,OAAO,EAAE,6BAA6B;QACtC,OAAO;QACP,YAAY;KACb,CAAC,CAAC;IAEH,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,CAAC,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAChC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,IAAI;SAChB,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IAEpE,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,QAAkB;QAC3B,UAAU,EAAE,cAAc,EAAE,IAAI;KACjC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,UAAyB;IAEzB,IAAI,eAAmC,CAAC;IAExC,6DAA6D;IAC7D,IAAI,UAAU,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACnC,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;QACjC,CAAC;IACH,CAAC;IAED,2EAA2E;IAC3E,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,eAAe,CAAC,CAAC;IAEnD,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU,EAAE,KAAK;KAClB,CAAC;AACJ,CAAC"}

package/dist/cli/region-selector.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=region-selector.test.d.ts.map

package/dist/cli/region-selector.test.d.ts.map

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

package/dist/cli/region-selector.test.js

@@ -0,0 +1,176 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+import { selectRegion, getApiHostWithRegionSelection } from "./region-selector.js";
+// Mock the regions API
+vi.mock("../api/regions.js", () => ({
+    fetchRegions: vi.fn(),
+}));
+// Mock @clack/prompts
+vi.mock("@clack/prompts", () => ({
+    select: vi.fn(),
+    isCancel: vi.fn(),
+    cancel: vi.fn(),
+}));
+import { fetchRegions } from "../api/regions.js";
+import * as p from "@clack/prompts";
+const mockedFetchRegions = vi.mocked(fetchRegions);
+const mockedSelect = vi.mocked(p.select);
+const mockedIsCancel = vi.mocked(p.isCancel);
+describe("selectRegion", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockedIsCancel.mockReturnValue(false);
+    });
+    it("fetches regions and shows selection prompt with GCP first", async () => {
+        mockedFetchRegions.mockResolvedValue([
+            { name: "us-east-1", api_host: "https://api.us.tinybird.co", provider: "aws" },
+            { name: "europe-west3", api_host: "https://api.eu.tinybird.co", provider: "gcp" },
+        ]);
+        mockedSelect.mockResolvedValue("https://api.eu.tinybird.co");
+        const result = await selectRegion();
+        expect(result.success).toBe(true);
+        expect(result.apiHost).toBe("https://api.eu.tinybird.co");
+        expect(result.regionName).toBe("europe-west3");
+        // GCP regions should appear first, then AWS
+        expect(mockedSelect).toHaveBeenCalledWith({
+            message: "Select your Tinybird region",
+            options: [
+                { value: "https://api.eu.tinybird.co", label: "gcp | europe-west3", hint: "api.eu.tinybird.co" },
+                { value: "https://api.us.tinybird.co", label: "aws | us-east-1", hint: "api.us.tinybird.co" },
+            ],
+            initialValue: undefined,
+        });
+    });
+    it("uses fallback regions when API fails", async () => {
+        mockedFetchRegions.mockRejectedValue(new Error("Network error"));
+        mockedSelect.mockResolvedValue("https://api.europe-west2.gcp.tinybird.co");
+        const result = await selectRegion();
+        expect(result.success).toBe(true);
+        expect(result.apiHost).toBe("https://api.europe-west2.gcp.tinybird.co");
+        expect(mockedSelect).toHaveBeenCalled();
+    });
+    it("returns cancelled when user cancels", async () => {
+        mockedFetchRegions.mockResolvedValue([
+            { name: "EU", api_host: "https://api.eu.tinybird.co", provider: "gcp" },
+        ]);
+        mockedSelect.mockResolvedValue(Symbol("cancel"));
+        mockedIsCancel.mockReturnValue(true);
+        const result = await selectRegion();
+        expect(result.success).toBe(false);
+        expect(result.cancelled).toBe(true);
+    });
+    it("uses fallback regions when API returns empty array", async () => {
+        mockedFetchRegions.mockResolvedValue([]);
+        mockedSelect.mockResolvedValue("https://api.tinybird.co");
+        const result = await selectRegion();
+        expect(result.success).toBe(true);
+        // Should have used fallback regions
+        expect(mockedSelect).toHaveBeenCalled();
+    });
+    it("pre-selects region when defaultApiHost is provided", async () => {
+        mockedFetchRegions.mockResolvedValue([
+            { name: "EU", api_host: "https://api.eu.tinybird.co", provider: "gcp" },
+            { name: "US", api_host: "https://api.us.tinybird.co", provider: "aws" },
+        ]);
+        mockedSelect.mockResolvedValue("https://api.us.tinybird.co");
+        const result = await selectRegion("https://api.us.tinybird.co");
+        expect(result.success).toBe(true);
+        expect(mockedSelect).toHaveBeenCalledWith(expect.objectContaining({
+            initialValue: "https://api.us.tinybird.co",
+        }));
+    });
+    it("does not set initialValue when defaultApiHost does not match any region", async () => {
+        mockedFetchRegions.mockResolvedValue([
+            { name: "EU", api_host: "https://api.eu.tinybird.co", provider: "gcp" },
+        ]);
+        mockedSelect.mockResolvedValue("https://api.eu.tinybird.co");
+        await selectRegion("https://api.unknown.tinybird.co");
+        expect(mockedSelect).toHaveBeenCalledWith(expect.objectContaining({
+            initialValue: undefined,
+        }));
+    });
+});
+describe("getApiHostWithRegionSelection", () => {
+    let tempDir;
+    beforeEach(() => {
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "region-selector-test-"));
+        vi.clearAllMocks();
+        mockedIsCancel.mockReturnValue(false);
+    });
+    afterEach(() => {
+        try {
+            fs.rmSync(tempDir, { recursive: true });
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    });
+    it("pre-selects baseUrl from config when present", async () => {
+        const configPath = path.join(tempDir, "tinybird.config.json");
+        fs.writeFileSync(configPath, JSON.stringify({ baseUrl: "https://api.us-east.tinybird.co" }));
+        mockedFetchRegions.mockResolvedValue([
+            { name: "EU", api_host: "https://api.eu.tinybird.co", provider: "gcp" },
+            { name: "US East", api_host: "https://api.us-east.tinybird.co", provider: "aws" },
+        ]);
+        mockedSelect.mockResolvedValue("https://api.us-east.tinybird.co");
+        const result = await getApiHostWithRegionSelection(configPath);
+        expect(result).toEqual({
+            apiHost: "https://api.us-east.tinybird.co",
+            fromConfig: false,
+        });
+        // Should have called select with initialValue
+        expect(mockedSelect).toHaveBeenCalledWith(expect.objectContaining({
+            initialValue: "https://api.us-east.tinybird.co",
+        }));
+    });
+    it("prompts for region when config has no baseUrl", async () => {
+        const configPath = path.join(tempDir, "tinybird.config.json");
+        fs.writeFileSync(configPath, JSON.stringify({ token: "test" }));
+        mockedFetchRegions.mockResolvedValue([
+            { name: "EU", api_host: "https://api.eu.tinybird.co", provider: "gcp" },
+        ]);
+        mockedSelect.mockResolvedValue("https://api.eu.tinybird.co");
+        const result = await getApiHostWithRegionSelection(configPath);
+        expect(result).toEqual({
+            apiHost: "https://api.eu.tinybird.co",
+            fromConfig: false,
+        });
+        expect(mockedSelect).toHaveBeenCalled();
+    });
+    it("prompts for region when config file is null", async () => {
+        mockedFetchRegions.mockResolvedValue([
+            { name: "EU", api_host: "https://api.eu.tinybird.co", provider: "gcp" },
+        ]);
+        mockedSelect.mockResolvedValue("https://api.eu.tinybird.co");
+        const result = await getApiHostWithRegionSelection(null);
+        expect(result).toEqual({
+            apiHost: "https://api.eu.tinybird.co",
+            fromConfig: false,
+        });
+    });
+    it("prompts for region when config is not JSON", async () => {
+        mockedFetchRegions.mockResolvedValue([
+            { name: "EU", api_host: "https://api.eu.tinybird.co", provider: "gcp" },
+        ]);
+        mockedSelect.mockResolvedValue("https://api.eu.tinybird.co");
+        const result = await getApiHostWithRegionSelection("/path/to/config.mjs");
+        expect(result).toEqual({
+            apiHost: "https://api.eu.tinybird.co",
+            fromConfig: false,
+        });
+    });
+    it("returns null when user cancels region selection", async () => {
+        const configPath = path.join(tempDir, "tinybird.config.json");
+        fs.writeFileSync(configPath, JSON.stringify({ token: "test" }));
+        mockedFetchRegions.mockResolvedValue([
+            { name: "EU", api_host: "https://api.eu.tinybird.co", provider: "gcp" },
+        ]);
+        mockedSelect.mockResolvedValue(Symbol("cancel"));
+        mockedIsCancel.mockReturnValue(true);
+        const result = await getApiHostWithRegionSelection(configPath);
+        expect(result).toBeNull();
+    });
+});
+//# sourceMappingURL=region-selector.test.js.map

package/dist/cli/region-selector.test.js.map

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

package/package.json

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

package/src/api/regions.test.ts

@@ -0,0 +1,89 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { fetchRegions, RegionsApiError } from "./regions.js";
+
+// Mock the fetcher module
+vi.mock("./fetcher.js", () => ({
+  tinybirdFetch: vi.fn(),
+}));
+
+import { tinybirdFetch } from "./fetcher.js";
+
+const mockedFetch = vi.mocked(tinybirdFetch);
+
+describe("fetchRegions", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it("returns regions from API", async () => {
+    mockedFetch.mockResolvedValue({
+      ok: true,
+      json: () =>
+        Promise.resolve({
+          regions: [
+            {
+              name: "EU (GCP)",
+              api_host: "https://api.europe-west2.gcp.tinybird.co",
+              provider: "gcp",
+            },
+            {
+              name: "US East (AWS)",
+              api_host: "https://api.us-east.aws.tinybird.co",
+              provider: "aws",
+            },
+          ],
+        }),
+    } as Response);
+
+    const regions = await fetchRegions();
+
+    expect(regions).toHaveLength(2);
+    expect(regions[0].name).toBe("EU (GCP)");
+    expect(regions[0].api_host).toBe("https://api.europe-west2.gcp.tinybird.co");
+    expect(regions[1].provider).toBe("aws");
+  });
+
+  it("calls the correct endpoint", async () => {
+    mockedFetch.mockResolvedValue({
+      ok: true,
+      json: () => Promise.resolve({ regions: [] }),
+    } as Response);
+
+    await fetchRegions();
+
+    expect(mockedFetch).toHaveBeenCalledWith(
+      "https://api.tinybird.co/v0/regions",
+      { method: "GET" }
+    );
+  });
+
+  it("throws RegionsApiError on non-ok response", async () => {
+    mockedFetch.mockResolvedValue({
+      ok: false,
+      status: 500,
+      statusText: "Internal Server Error",
+      text: () => Promise.resolve("Server error"),
+    } as Response);
+
+    await expect(fetchRegions()).rejects.toThrow(RegionsApiError);
+    await expect(fetchRegions()).rejects.toThrow("Failed to fetch regions: 500");
+  });
+
+  it("throws RegionsApiError on network error", async () => {
+    mockedFetch.mockRejectedValue(new Error("Network error"));
+
+    await expect(fetchRegions()).rejects.toThrow(RegionsApiError);
+    await expect(fetchRegions()).rejects.toThrow("Network error");
+  });
+
+  it("returns empty array when API returns empty regions", async () => {
+    mockedFetch.mockResolvedValue({
+      ok: true,
+      json: () => Promise.resolve({ regions: [] }),
+    } as Response);
+
+    const regions = await fetchRegions();
+
+    expect(regions).toEqual([]);
+  });
+});

package/src/api/regions.ts

@@ -0,0 +1,75 @@
+/**
+ * Tinybird Regions API client
+ *
+ * Fetches available regions from the Tinybird API
+ */
+
+import { tinybirdFetch } from "./fetcher.js";
+
+/**
+ * Default API host used to fetch regions
+ * (regions endpoint is available from any host)
+ */
+const DEFAULT_HOST = "https://api.tinybird.co";
+
+/**
+ * Region information from Tinybird API
+ */
+export interface TinybirdRegion {
+  /** Region name (e.g., "EU (GCP)") */
+  name: string;
+  /** API host URL (e.g., "https://api.europe-west2.gcp.tinybird.co") */
+  api_host: string;
+  /** Cloud provider (e.g., "gcp", "aws") */
+  provider: string;
+}
+
+/**
+ * Error thrown by regions API operations
+ */
+export class RegionsApiError extends Error {
+  constructor(
+    message: string,
+    public readonly status?: number,
+    public readonly body?: unknown
+  ) {
+    super(message);
+    this.name = "RegionsApiError";
+  }
+}
+
+/**
+ * Fetch available Tinybird regions
+ *
+ * Note: This endpoint doesn't require authentication.
+ *
+ * @returns Array of available regions
+ */
+export async function fetchRegions(): Promise<TinybirdRegion[]> {
+  const url = new URL("/v0/regions", DEFAULT_HOST);
+
+  try {
+    const response = await tinybirdFetch(url.toString(), {
+      method: "GET",
+    });
+
+    if (!response.ok) {
+      const body = await response.text();
+      throw new RegionsApiError(
+        `Failed to fetch regions: ${response.status} ${response.statusText}`,
+        response.status,
+        body
+      );
+    }
+
+    const data = (await response.json()) as { regions: TinybirdRegion[] };
+    return data.regions;
+  } catch (error) {
+    if (error instanceof RegionsApiError) {
+      throw error;
+    }
+    throw new RegionsApiError(
+      `Failed to fetch regions: ${(error as Error).message}`
+    );
+  }
+}

package/src/cli/commands/init.test.ts

@@ -9,6 +9,14 @@ vi.mock("../auth.js", () => ({
   browserLogin: vi.fn().mockResolvedValue({ success: false }),
 }));
 
+// Mock the region-selector module to avoid interactive prompts
+vi.mock("../region-selector.js", () => ({
+  selectRegion: vi.fn().mockResolvedValue({
+    success: true,
+    apiHost: "https://api.tinybird.co",
+  }),
+}));
+
 describe("Init Command", () => {
   let tempDir: string;
 

package/src/cli/commands/init.ts

@@ -17,6 +17,7 @@ import {
 } from "../config.js";
 import { browserLogin } from "../auth.js";
 import { saveTinybirdToken } from "../env.js";
+import { selectRegion } from "../region-selector.js";
 import { getGitRoot } from "../git.js";
 import { fetchAllResources } from "../../api/resources.js";
 import { generateCombinedFile } from "../../codegen/index.js";
@@ -893,7 +894,25 @@ export async function runInit(options: InitOptions = {}): Promise<InitResult> {
   if (!skipLogin && !hasValidToken(cwd)) {
     console.log("\nNo authentication found. Starting login flow...\n");
 
-    const authResult = await browserLogin();
+    // Select region before login (init creates fresh config, so always prompt)
+    const regionResult = await selectRegion();
+    if (!regionResult.success || !regionResult.apiHost) {
+      return {
+        success: true,
+        created,
+        skipped,
+        loggedIn: false,
+        devMode,
+        clientPath: relativeTinybirdDir,
+        existingDatafiles:
+          existingDatafiles.length > 0 ? existingDatafiles : undefined,
+        ciWorkflowCreated,
+        cdWorkflowCreated,
+        workflowProvider,
+      };
+    }
+
+    const authResult = await browserLogin({ apiHost: regionResult.apiHost });
 
     if (authResult.success && authResult.token) {
       // Save token to .env.local
@@ -903,13 +922,11 @@ export async function runInit(options: InitOptions = {}): Promise<InitResult> {
           created.push(".env.local");
         }
 
-        // If custom base URL, update config file
-        const baseUrl = authResult.baseUrl ?? "https://api.tinybird.co";
-        if (baseUrl !== "https://api.tinybird.co") {
-          const currentConfigPath = findExistingConfigPath(cwd);
-          if (currentConfigPath && currentConfigPath.endsWith(".json")) {
-            updateConfig(currentConfigPath, { baseUrl });
-          }
+        // Update config with selected region's baseUrl
+        const baseUrl = authResult.baseUrl ?? regionResult.apiHost;
+        const currentConfigPath = findExistingConfigPath(cwd);
+        if (currentConfigPath && currentConfigPath.endsWith(".json")) {
+          updateConfig(currentConfigPath, { baseUrl });
         }
 
         // Generate TypeScript from existing Tinybird resources if requested

package/src/cli/commands/login.test.ts

@@ -9,10 +9,17 @@ vi.mock("../auth.js", () => ({
   browserLogin: vi.fn(),
 }));
 
-// Import the mocked function
+// Mock the region-selector module to avoid interactive prompts
+vi.mock("../region-selector.js", () => ({
+  getApiHostWithRegionSelection: vi.fn(),
+}));
+
+// Import the mocked functions
 import { browserLogin } from "../auth.js";
+import { getApiHostWithRegionSelection } from "../region-selector.js";
 
 const mockedBrowserLogin = vi.mocked(browserLogin);
+const mockedGetApiHost = vi.mocked(getApiHostWithRegionSelection);
 
 describe("Login Command", () => {
   let tempDir: string;
@@ -20,6 +27,11 @@ describe("Login Command", () => {
   beforeEach(() => {
     tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "tinybird-login-test-"));
     vi.clearAllMocks();
+    // Default mock for region selection - returns a default apiHost
+    mockedGetApiHost.mockResolvedValue({
+      apiHost: "https://api.tinybird.co",
+      fromConfig: false,
+    });
   });
 
   afterEach(() => {