@tinybirdco/sdk 0.0.19 → 0.0.20

package/README.md

@@ -175,6 +175,53 @@ const result = await tinybird.query.topPages({
 // result.data is fully typed: { pathname: string, views: bigint }[]
 ```
 
+## Public Tinybird API (Optional)
+
+If you want a low-level API wrapper that is decoupled from the typed client layer,
+you can use `createTinybirdApi()` directly with just `baseUrl` and `token`:
+
+```typescript
+import { createTinybirdApi } from "@tinybirdco/sdk";
+
+const api = createTinybirdApi({
+  baseUrl: "https://api.tinybird.co",
+  token: process.env.TINYBIRD_TOKEN!,
+});
+
+// Query endpoint pipe (with optional type parameters)
+interface TopPagesRow { pathname: string; visits: number }
+interface TopPagesParams { start_date: string; end_date: string; limit?: number }
+
+const topPages = await api.query<TopPagesRow, TopPagesParams>("top_pages", {
+  start_date: "2024-01-01",
+  end_date: "2024-01-31",
+  limit: 5,
+});
+
+// Ingest one row into datasource (with optional type parameter)
+interface EventRow { timestamp: Date; event_name: string; pathname: string }
+
+await api.ingest<EventRow>("events", {
+  timestamp: new Date(),
+  event_name: "page_view",
+  pathname: "/home",
+});
+
+// Execute raw SQL (with optional type parameter)
+interface CountResult { total: number }
+
+const sqlResult = await api.sql<CountResult>("SELECT count() AS total FROM events");
+
+// Optional per-request token override
+await api.request("/v1/workspace", {
+  token: process.env.TINYBIRD_BRANCH_TOKEN,
+});
+```
+
+This Tinybird API is standalone and can be used without `createClient()` or `createTinybirdClient()`.
+It is intended for cases where you want a simple public API that remains
+decoupled from the higher-level typed client APIs.
+
 ## CLI Commands
 
 ### `npx tinybird init`

package/dist/api/api.d.ts

@@ -0,0 +1,89 @@
+import type { IngestOptions, IngestResult, QueryOptions, QueryResult, TinybirdErrorResponse } from "../client/types.js";
+/**
+ * Public, decoupled Tinybird API wrapper configuration
+ */
+export interface TinybirdApiConfig {
+    /** Tinybird API base URL (e.g. https://api.tinybird.co) */
+    baseUrl: string;
+    /** Tinybird token used for Authorization bearer header */
+    token: string;
+    /** Custom fetch implementation (optional) */
+    fetch?: typeof fetch;
+    /** Default timeout in milliseconds (optional) */
+    timeout?: number;
+}
+/**
+ * Request options for the API layer
+ */
+export interface TinybirdApiRequestInit extends RequestInit {
+    /** Optional token override for a specific request */
+    token?: string;
+}
+export interface TinybirdApiQueryOptions extends QueryOptions {
+    /** Optional token override for this request */
+    token?: string;
+}
+export interface TinybirdApiIngestOptions extends IngestOptions {
+    /** Optional token override for this request */
+    token?: string;
+}
+/**
+ * Error thrown by TinybirdApi when a response is not OK
+ */
+export declare class TinybirdApiError extends Error {
+    readonly statusCode: number;
+    readonly responseBody?: string;
+    readonly response?: TinybirdErrorResponse;
+    constructor(message: string, statusCode: number, responseBody?: string, response?: TinybirdErrorResponse);
+}
+/**
+ * Low-level Tinybird API wrapper.
+ *
+ * This layer is intentionally decoupled from the typed TinybirdClient layer
+ * so it can be used standalone with just baseUrl + token.
+ */
+export declare class TinybirdApi {
+    private readonly config;
+    private readonly baseUrl;
+    private readonly defaultToken;
+    private readonly fetchFn;
+    constructor(config: TinybirdApiConfig);
+    /**
+     * Execute a request against Tinybird API.
+     */
+    request(path: string, init?: TinybirdApiRequestInit): Promise<Response>;
+    /**
+     * Execute a request and parse JSON response.
+     */
+    requestJson<T = unknown>(path: string, init?: TinybirdApiRequestInit): Promise<T>;
+    /**
+     * Query a Tinybird endpoint
+     */
+    query<T = unknown, P extends Record<string, unknown> = Record<string, unknown>>(endpointName: string, params?: P, options?: TinybirdApiQueryOptions): Promise<QueryResult<T>>;
+    /**
+     * Ingest a single row into a datasource
+     */
+    ingest<T extends Record<string, unknown>>(datasourceName: string, event: T, options?: TinybirdApiIngestOptions): Promise<IngestResult>;
+    /**
+     * Ingest a batch of rows into a datasource
+     */
+    ingestBatch<T extends Record<string, unknown>>(datasourceName: string, events: T[], options?: TinybirdApiIngestOptions): Promise<IngestResult>;
+    /**
+     * Execute raw SQL against Tinybird
+     */
+    sql<T = unknown>(sql: string, options?: TinybirdApiQueryOptions): Promise<QueryResult<T>>;
+    private createAbortSignal;
+    private serializeEvent;
+    private serializeValue;
+    private handleErrorResponse;
+    private resolveUrl;
+}
+/**
+ * Create a decoupled Tinybird API wrapper.
+ */
+export declare function createTinybirdApi(config: TinybirdApiConfig): TinybirdApi;
+/**
+ * Alias for teams that prefer "wrapper" naming.
+ */
+export declare const createTinybirdApiWrapper: typeof createTinybirdApi;
+//# sourceMappingURL=api.d.ts.map

package/dist/api/api.d.ts.map

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

package/dist/api/api.js

@@ -0,0 +1,218 @@
+import { createTinybirdFetcher } from "./fetcher.js";
+const DEFAULT_TIMEOUT = 30000;
+/**
+ * Error thrown by TinybirdApi when a response is not OK
+ */
+export class TinybirdApiError extends Error {
+    statusCode;
+    responseBody;
+    response;
+    constructor(message, statusCode, responseBody, response) {
+        super(message);
+        this.name = "TinybirdApiError";
+        this.statusCode = statusCode;
+        this.responseBody = responseBody;
+        this.response = response;
+    }
+}
+/**
+ * Low-level Tinybird API wrapper.
+ *
+ * This layer is intentionally decoupled from the typed TinybirdClient layer
+ * so it can be used standalone with just baseUrl + token.
+ */
+export class TinybirdApi {
+    config;
+    baseUrl;
+    defaultToken;
+    fetchFn;
+    constructor(config) {
+        if (!config.baseUrl) {
+            throw new Error("baseUrl is required");
+        }
+        if (!config.token) {
+            throw new Error("token is required");
+        }
+        this.config = config;
+        this.baseUrl = config.baseUrl.replace(/\/$/, "");
+        this.defaultToken = config.token;
+        this.fetchFn = createTinybirdFetcher(config.fetch ?? globalThis.fetch);
+    }
+    /**
+     * Execute a request against Tinybird API.
+     */
+    request(path, init = {}) {
+        const { token, headers, ...requestInit } = init;
+        const authToken = token ?? this.defaultToken;
+        const requestHeaders = new Headers(headers);
+        if (!requestHeaders.has("Authorization")) {
+            requestHeaders.set("Authorization", `Bearer ${authToken}`);
+        }
+        return this.fetchFn(this.resolveUrl(path), {
+            ...requestInit,
+            headers: requestHeaders,
+        });
+    }
+    /**
+     * Execute a request and parse JSON response.
+     */
+    async requestJson(path, init = {}) {
+        const response = await this.request(path, init);
+        if (!response.ok) {
+            await this.handleErrorResponse(response);
+        }
+        return (await response.json());
+    }
+    /**
+     * Query a Tinybird endpoint
+     */
+    async query(endpointName, params = {}, options = {}) {
+        const url = new URL(`/v0/pipes/${endpointName}.json`, `${this.baseUrl}/`);
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined || value === null) {
+                continue;
+            }
+            if (Array.isArray(value)) {
+                for (const item of value) {
+                    url.searchParams.append(key, String(item));
+                }
+                continue;
+            }
+            if (value instanceof Date) {
+                url.searchParams.set(key, value.toISOString());
+                continue;
+            }
+            url.searchParams.set(key, String(value));
+        }
+        const response = await this.request(url.toString(), {
+            method: "GET",
+            token: options.token,
+            signal: this.createAbortSignal(options.timeout, options.signal),
+        });
+        if (!response.ok) {
+            await this.handleErrorResponse(response);
+        }
+        return (await response.json());
+    }
+    /**
+     * Ingest a single row into a datasource
+     */
+    async ingest(datasourceName, event, options = {}) {
+        return this.ingestBatch(datasourceName, [event], options);
+    }
+    /**
+     * Ingest a batch of rows into a datasource
+     */
+    async ingestBatch(datasourceName, events, options = {}) {
+        if (events.length === 0) {
+            return { successful_rows: 0, quarantined_rows: 0 };
+        }
+        const url = new URL("/v0/events", `${this.baseUrl}/`);
+        url.searchParams.set("name", datasourceName);
+        if (options.wait !== false) {
+            url.searchParams.set("wait", "true");
+        }
+        const ndjson = events
+            .map((event) => JSON.stringify(this.serializeEvent(event)))
+            .join("\n");
+        const response = await this.request(url.toString(), {
+            method: "POST",
+            token: options.token,
+            headers: {
+                "Content-Type": "application/x-ndjson",
+            },
+            body: ndjson,
+            signal: this.createAbortSignal(options.timeout, options.signal),
+        });
+        if (!response.ok) {
+            await this.handleErrorResponse(response);
+        }
+        return (await response.json());
+    }
+    /**
+     * Execute raw SQL against Tinybird
+     */
+    async sql(sql, options = {}) {
+        const response = await this.request("/v0/sql", {
+            method: "POST",
+            token: options.token,
+            headers: {
+                "Content-Type": "text/plain",
+            },
+            body: sql,
+            signal: this.createAbortSignal(options.timeout, options.signal),
+        });
+        if (!response.ok) {
+            await this.handleErrorResponse(response);
+        }
+        return (await response.json());
+    }
+    createAbortSignal(timeout, existingSignal) {
+        const timeoutMs = timeout ?? this.config.timeout ?? DEFAULT_TIMEOUT;
+        if (!timeoutMs && !existingSignal) {
+            return undefined;
+        }
+        if (!timeoutMs && existingSignal) {
+            return existingSignal;
+        }
+        const timeoutSignal = AbortSignal.timeout(timeoutMs);
+        if (!existingSignal) {
+            return timeoutSignal;
+        }
+        return AbortSignal.any([timeoutSignal, existingSignal]);
+    }
+    serializeEvent(event) {
+        const serialized = {};
+        for (const [key, value] of Object.entries(event)) {
+            serialized[key] = this.serializeValue(value);
+        }
+        return serialized;
+    }
+    serializeValue(value) {
+        if (value instanceof Date) {
+            return value.toISOString();
+        }
+        if (value instanceof Map) {
+            return Object.fromEntries(value);
+        }
+        if (typeof value === "bigint") {
+            return value.toString();
+        }
+        if (Array.isArray(value)) {
+            return value.map((item) => this.serializeValue(item));
+        }
+        if (typeof value === "object" && value !== null) {
+            return this.serializeEvent(value);
+        }
+        return value;
+    }
+    async handleErrorResponse(response) {
+        const rawBody = await response.text();
+        let errorResponse;
+        try {
+            errorResponse = JSON.parse(rawBody);
+        }
+        catch {
+            // ignore parse error and keep raw body
+        }
+        const message = errorResponse?.error ??
+            (rawBody
+                ? `Request failed with status ${response.status}: ${rawBody}`
+                : `Request failed with status ${response.status}`);
+        throw new TinybirdApiError(message, response.status, rawBody || undefined, errorResponse);
+    }
+    resolveUrl(path) {
+        return new URL(path, `${this.baseUrl}/`).toString();
+    }
+}
+/**
+ * Create a decoupled Tinybird API wrapper.
+ */
+export function createTinybirdApi(config) {
+    return new TinybirdApi(config);
+}
+/**
+ * Alias for teams that prefer "wrapper" naming.
+ */
+export const createTinybirdApiWrapper = createTinybirdApi;
+//# sourceMappingURL=api.js.map

package/dist/api/api.js.map

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

package/dist/api/api.test.d.ts

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

package/dist/api/api.test.d.ts.map

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

package/dist/api/api.test.js

@@ -0,0 +1,226 @@
+import { afterAll, afterEach, beforeAll, describe, expect, it } from "vitest";
+import { setupServer } from "msw/node";
+import { http, HttpResponse } from "msw";
+import { createTinybirdApi } from "./api.js";
+import { TINYBIRD_FROM_PARAM } from "./fetcher.js";
+import { BASE_URL } from "../test/handlers.js";
+const server = setupServer();
+beforeAll(() => server.listen({ onUnhandledRequest: "error" }));
+afterEach(() => server.resetHandlers());
+afterAll(() => server.close());
+describe("TinybirdApi", () => {
+    it("sends authorization header and from=ts-sdk param", async () => {
+        let authorizationHeader = null;
+        let fromParam = null;
+        server.use(http.get(`${BASE_URL}/v1/workspace`, ({ request }) => {
+            authorizationHeader = request.headers.get("Authorization");
+            const url = new URL(request.url);
+            fromParam = url.searchParams.get("from");
+            return HttpResponse.json({ ok: true });
+        }));
+        const api = createTinybirdApi({
+            baseUrl: BASE_URL,
+            token: "p.default-token",
+        });
+        await api.request("/v1/workspace");
+        expect(authorizationHeader).toBe("Bearer p.default-token");
+        expect(fromParam).toBe(TINYBIRD_FROM_PARAM);
+    });
+    it("resolves relative paths and preserves query params", async () => {
+        let fooParam = null;
+        let fromParam = null;
+        server.use(http.get(`${BASE_URL}/v1/build`, ({ request }) => {
+            const url = new URL(request.url);
+            fooParam = url.searchParams.get("foo");
+            fromParam = url.searchParams.get("from");
+            return HttpResponse.json({ ok: true });
+        }));
+        const api = createTinybirdApi({
+            baseUrl: `${BASE_URL}/`,
+            token: "p.default-token",
+        });
+        await api.request("v1/build?foo=bar");
+        expect(fooParam).toBe("bar");
+        expect(fromParam).toBe(TINYBIRD_FROM_PARAM);
+    });
+    it("allows per-request token override", async () => {
+        let authorizationHeader = null;
+        server.use(http.get(`${BASE_URL}/v1/workspace`, ({ request }) => {
+            authorizationHeader = request.headers.get("Authorization");
+            return HttpResponse.json({ ok: true });
+        }));
+        const api = createTinybirdApi({
+            baseUrl: BASE_URL,
+            token: "p.default-token",
+        });
+        await api.request("/v1/workspace", { token: "p.override-token" });
+        expect(authorizationHeader).toBe("Bearer p.override-token");
+    });
+    it("queries endpoint params via tinybirdApi.query", async () => {
+        let fromParam = null;
+        let startDateParam = null;
+        let limitParam = null;
+        let tagsParams = [];
+        server.use(http.get(`${BASE_URL}/v0/pipes/top_pages.json`, ({ request }) => {
+            const url = new URL(request.url);
+            fromParam = url.searchParams.get("from");
+            startDateParam = url.searchParams.get("start_date");
+            limitParam = url.searchParams.get("limit");
+            tagsParams = url.searchParams.getAll("tags");
+            return HttpResponse.json({
+                data: [{ pathname: "/", views: 1 }],
+                meta: [
+                    { name: "pathname", type: "String" },
+                    { name: "views", type: "UInt64" },
+                ],
+                rows: 1,
+                statistics: {
+                    elapsed: 0.001,
+                    rows_read: 1,
+                    bytes_read: 10,
+                },
+            });
+        }));
+        const api = createTinybirdApi({
+            baseUrl: BASE_URL,
+            token: "p.default-token",
+        });
+        const result = await api.query("top_pages", {
+            start_date: new Date("2024-01-01T00:00:00.000Z"),
+            limit: 5,
+            tags: ["a", "b"],
+        });
+        expect(result.rows).toBe(1);
+        expect(result.data[0]).toEqual({ pathname: "/", views: 1 });
+        expect(fromParam).toBe(TINYBIRD_FROM_PARAM);
+        expect(startDateParam).toBe("2024-01-01T00:00:00.000Z");
+        expect(limitParam).toBe("5");
+        expect(tagsParams).toEqual(["a", "b"]);
+    });
+    it("ingests rows via tinybirdApi.ingest", async () => {
+        let datasourceName = null;
+        let waitParam = null;
+        let fromParam = null;
+        let contentType = null;
+        let parsedBody = null;
+        server.use(http.post(`${BASE_URL}/v0/events`, async ({ request }) => {
+            const url = new URL(request.url);
+            datasourceName = url.searchParams.get("name");
+            waitParam = url.searchParams.get("wait");
+            fromParam = url.searchParams.get("from");
+            contentType = request.headers.get("content-type");
+            const rawBody = await request.text();
+            parsedBody = JSON.parse(rawBody);
+            return HttpResponse.json({
+                successful_rows: 1,
+                quarantined_rows: 0,
+            });
+        }));
+        const api = createTinybirdApi({
+            baseUrl: BASE_URL,
+            token: "p.default-token",
+        });
+        const result = await api.ingest("events", {
+            timestamp: new Date("2024-01-01T00:00:00.000Z"),
+            count: 10n,
+            payload: new Map([["k", "v"]]),
+            nested: {
+                when: new Date("2024-01-02T00:00:00.000Z"),
+            },
+        });
+        expect(result).toEqual({ successful_rows: 1, quarantined_rows: 0 });
+        expect(datasourceName).toBe("events");
+        expect(waitParam).toBe("true");
+        expect(fromParam).toBe(TINYBIRD_FROM_PARAM);
+        expect(contentType).toBe("application/x-ndjson");
+        expect(parsedBody).toEqual({
+            timestamp: "2024-01-01T00:00:00.000Z",
+            count: "10",
+            payload: { k: "v" },
+            nested: { when: "2024-01-02T00:00:00.000Z" },
+        });
+    });
+    it("executes raw SQL via tinybirdApi.sql", async () => {
+        let rawSql = null;
+        let contentType = null;
+        server.use(http.post(`${BASE_URL}/v0/sql`, async ({ request }) => {
+            contentType = request.headers.get("content-type");
+            rawSql = await request.text();
+            return HttpResponse.json({
+                data: [{ value: 1 }],
+                meta: [{ name: "value", type: "UInt8" }],
+                rows: 1,
+                statistics: {
+                    elapsed: 0.001,
+                    rows_read: 1,
+                    bytes_read: 1,
+                },
+            });
+        }));
+        const api = createTinybirdApi({
+            baseUrl: BASE_URL,
+            token: "p.default-token",
+        });
+        const result = await api.sql("SELECT 1 AS value");
+        expect(result.data[0]?.value).toBe(1);
+        expect(contentType).toBe("text/plain");
+        expect(rawSql).toBe("SELECT 1 AS value");
+    });
+    it("returns zero counts for empty ingest batches", async () => {
+        const api = createTinybirdApi({
+            baseUrl: BASE_URL,
+            token: "p.default-token",
+        });
+        const result = await api.ingestBatch("events", []);
+        expect(result).toEqual({ successful_rows: 0, quarantined_rows: 0 });
+    });
+    it("parses JSON responses", async () => {
+        server.use(http.get(`${BASE_URL}/v1/workspace`, () => {
+            return HttpResponse.json({ id: "ws_123", name: "main" });
+        }));
+        const api = createTinybirdApi({
+            baseUrl: BASE_URL,
+            token: "p.default-token",
+        });
+        const result = await api.requestJson("/v1/workspace");
+        expect(result.id).toBe("ws_123");
+        expect(result.name).toBe("main");
+    });
+    it("throws TinybirdApiError for non-OK responses", async () => {
+        server.use(http.get(`${BASE_URL}/v1/workspace`, () => {
+            return new HttpResponse("Unauthorized", { status: 401 });
+        }));
+        const api = createTinybirdApi({
+            baseUrl: BASE_URL,
+            token: "p.default-token",
+        });
+        await expect(api.requestJson("/v1/workspace")).rejects.toMatchObject({
+            name: "TinybirdApiError",
+            statusCode: 401,
+            responseBody: "Unauthorized",
+        });
+    });
+    it("throws TinybirdApiError with parsed API details", async () => {
+        server.use(http.get(`${BASE_URL}/v0/pipes/broken.json`, () => {
+            return HttpResponse.json({
+                error: "Invalid query",
+                status: 400,
+                documentation: "https://www.tinybird.co/docs",
+            }, { status: 400 });
+        }));
+        const api = createTinybirdApi({
+            baseUrl: BASE_URL,
+            token: "p.default-token",
+        });
+        await expect(api.query("broken")).rejects.toMatchObject({
+            name: "TinybirdApiError",
+            statusCode: 400,
+            message: "Invalid query",
+            response: {
+                error: "Invalid query",
+                status: 400,
+            },
+        });
+    });
+});
+//# sourceMappingURL=api.test.js.map

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

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

package/dist/client/base.d.ts

@@ -32,7 +32,7 @@ import type { ClientConfig, QueryResult, IngestResult, QueryOptions, IngestOptio
  */
 export declare class TinybirdClient {
     private readonly config;
-    private readonly fetchFn;
+    private readonly apisByToken;
     private tokenPromise;
     private resolvedToken;
     constructor(config: ClientConfig);
@@ -79,22 +79,8 @@ export declare class TinybirdClient {
      * @returns Query result
      */
     sql<T = unknown>(sql: string, options?: QueryOptions): Promise<QueryResult<T>>;
-    /**
-     * Serialize an event for ingestion, handling Date objects and other special types
-     */
-    private serializeEvent;
-    /**
-     * Create an AbortSignal with timeout
-     */
-    private createAbortSignal;
-    /**
-     * Handle error responses from the API
-     */
-    private handleErrorResponse;
-    /**
-     * Internal fetch wrapper
-     */
-    private fetch;
+    private getApi;
+    private rethrowApiError;
 }
 /**
  * Create a Tinybird client