@tinybirdco/sdk 0.0.1

package/dist/cli/commands/build.js

@@ -0,0 +1,138 @@
+/**
+ * Build command - generates and pushes resources to Tinybird
+ */
+import { loadConfig } 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";
+/**
+ * Run the build command
+ *
+ * Loads the schema, generates resources, and pushes to Tinybird API.
+ *
+ * @param options - Build options
+ * @returns Build command result
+ */
+export async function runBuild(options = {}) {
+    const startTime = Date.now();
+    const cwd = options.cwd ?? process.cwd();
+    // Load config
+    let config;
+    try {
+        config = loadConfig(cwd);
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error.message,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    // Build resources from include paths
+    let buildResult;
+    try {
+        buildResult = await buildFromInclude({
+            includePaths: config.include,
+            cwd: config.cwd,
+        });
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `Build failed: ${error.message}`,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    // If dry run, return without pushing
+    if (options.dryRun) {
+        return {
+            success: true,
+            build: buildResult,
+            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
+    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}`);
+    }
+    if (!config.isMainBranch && config.tinybirdBranch && !options.tokenOverride) {
+        if (debug) {
+            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,
+            };
+        }
+    }
+    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,
+            build: buildResult,
+            deploy: deployResult,
+            error: deployResult.error,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    return {
+        success: true,
+        build: buildResult,
+        deploy: deployResult,
+        durationMs: Date.now() - startTime,
+    };
+}
+//# sourceMappingURL=build.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,78 @@
+/**
+ * Dev command - watch mode with automatic sync
+ */
+import { type ResolvedConfig } from "../config.js";
+import { type BuildCommandResult } from "./build.js";
+import { type TinybirdBranch } from "../../api/branches.js";
+import { type SchemaValidationResult } from "../utils/schema-validation.js";
+/**
+ * Login result info
+ */
+export interface LoginInfo {
+    /** Workspace name */
+    workspaceName?: string;
+    /** User email */
+    userEmail?: string;
+}
+/**
+ * Dev command options
+ */
+export interface DevCommandOptions {
+    /** Working directory (defaults to cwd) */
+    cwd?: string;
+    /** Debounce delay in milliseconds (default: 100) */
+    debounce?: number;
+    /** Callback when build starts */
+    onBuildStart?: () => void;
+    /** Callback when build completes */
+    onBuildComplete?: (result: BuildCommandResult) => void;
+    /** Callback when an error occurs */
+    onError?: (error: Error) => void;
+    /** Callback when branch is created/detected */
+    onBranchReady?: (info: BranchReadyInfo) => void;
+    /** Callback when login is needed and completed */
+    onLoginComplete?: (info: LoginInfo) => void;
+    /** Callback when schema validation completes */
+    onSchemaValidation?: (result: SchemaValidationResult) => void;
+}
+/**
+ * Information about the branch being used
+ */
+export interface BranchReadyInfo {
+    /** Git branch name */
+    gitBranch: string | null;
+    /** Whether we're on the main branch */
+    isMainBranch: boolean;
+    /** Tinybird branch info (null if on main) */
+    tinybirdBranch?: TinybirdBranch;
+    /** Whether the branch was newly created */
+    wasCreated?: boolean;
+}
+/**
+ * Dev command controller
+ */
+export interface DevController {
+    /** Stop watching and clean up */
+    stop: () => Promise<void>;
+    /** Trigger a manual rebuild */
+    rebuild: () => Promise<BuildCommandResult>;
+    /** The configuration being used */
+    config: ResolvedConfig;
+    /** The effective token (branch token or main token) */
+    effectiveToken: string;
+    /** Branch info */
+    branchInfo: BranchReadyInfo;
+}
+/**
+ * Run the dev command
+ *
+ * Watches for file changes and automatically rebuilds and pushes to Tinybird.
+ * Automatically manages Tinybird branches based on git branch:
+ * - Main branch: uses workspace token and /v1/deploy
+ * - Feature branches: creates/reuses Tinybird branch and uses /v1/build
+ *
+ * @param options - Dev options
+ * @returns Dev controller
+ */
+export declare function runDev(options?: DevCommandOptions): Promise<DevController>;
+//# sourceMappingURL=dev.d.ts.map

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

@@ -0,0 +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"}

package/dist/cli/commands/dev.js

@@ -0,0 +1,226 @@
+/**
+ * Dev command - watch mode with automatic sync
+ */
+import * as path from "path";
+import { watch } from "chokidar";
+import { loadConfig, configExists, findConfigFile, hasValidToken, updateConfig } 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";
+/**
+ * Run the dev command
+ *
+ * Watches for file changes and automatically rebuilds and pushes to Tinybird.
+ * Automatically manages Tinybird branches based on git branch:
+ * - Main branch: uses workspace token and /v1/deploy
+ * - Feature branches: creates/reuses Tinybird branch and uses /v1/build
+ *
+ * @param options - Dev options
+ * @returns Dev controller
+ */
+export async function runDev(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const debounceMs = options.debounce ?? 100;
+    // Check if project is initialized
+    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)) {
+        console.log("No authentication found. Starting login flow...\n");
+        const authResult = await browserLogin();
+        if (!authResult.success || !authResult.token) {
+            throw new Error(authResult.error ?? "Login failed. Run 'npx tinybird login' to authenticate.");
+        }
+        // Find the config file (may be in parent directory)
+        const configPath = findConfigFile(cwd);
+        if (!configPath) {
+            throw new Error("No tinybird.json found. Run 'npx tinybird init' first.");
+        }
+        // Save token to .env.local (in same directory as tinybird.json)
+        const configDir = path.dirname(configPath);
+        saveTinybirdToken(configDir, authResult.token);
+        // Update baseUrl in tinybird.json if it changed
+        if (authResult.baseUrl) {
+            updateConfig(configPath, {
+                baseUrl: authResult.baseUrl,
+            });
+        }
+        // Set the token in the environment for this session
+        process.env.TINYBIRD_TOKEN = authResult.token;
+        options.onLoginComplete?.({
+            workspaceName: authResult.workspaceName,
+            userEmail: authResult.userEmail,
+        });
+    }
+    // Load config (now should have valid token)
+    let config;
+    try {
+        config = loadConfig(cwd);
+    }
+    catch (error) {
+        throw error;
+    }
+    // Determine effective token based on git branch
+    let effectiveToken = config.token;
+    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;
+        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
+    const watchDirs = new Set();
+    for (const includePath of config.include) {
+        const absolutePath = path.isAbsolute(includePath)
+            ? includePath
+            : path.resolve(config.cwd, includePath);
+        watchDirs.add(path.dirname(absolutePath));
+    }
+    // Debounce state
+    let debounceTimer = null;
+    let isBuilding = false;
+    let pendingBuild = false;
+    // Build function
+    async function doBuild() {
+        if (isBuilding) {
+            pendingBuild = true;
+            return { success: false, error: "Build already in progress", durationMs: 0 };
+        }
+        isBuilding = true;
+        options.onBuildStart?.();
+        try {
+            const result = await runBuild({
+                cwd: config.cwd,
+                tokenOverride: effectiveToken,
+                useDeployEndpoint: config.isMainBranch,
+            });
+            options.onBuildComplete?.(result);
+            // Validate pipe schemas after successful deploy
+            if (result.success &&
+                result.build?.entities &&
+                result.deploy?.pipes &&
+                options.onSchemaValidation) {
+                // Get changed pipes from deploy result
+                const changedPipes = [
+                    ...result.deploy.pipes.created,
+                    ...result.deploy.pipes.changed,
+                ];
+                if (changedPipes.length > 0) {
+                    try {
+                        const validation = await validatePipeSchemas({
+                            entities: result.build.entities,
+                            pipeNames: changedPipes,
+                            baseUrl: config.baseUrl,
+                            token: effectiveToken,
+                        });
+                        options.onSchemaValidation(validation);
+                    }
+                    catch (validationError) {
+                        // Don't fail the build due to validation errors
+                        options.onError?.(validationError);
+                    }
+                }
+            }
+            return result;
+        }
+        catch (error) {
+            const result = {
+                success: false,
+                error: error.message,
+                durationMs: 0,
+            };
+            options.onBuildComplete?.(result);
+            return result;
+        }
+        finally {
+            isBuilding = false;
+            // If there was a pending build, trigger it
+            if (pendingBuild) {
+                pendingBuild = false;
+                scheduleBuild();
+            }
+        }
+    }
+    // Schedule a debounced build
+    function scheduleBuild() {
+        if (debounceTimer) {
+            clearTimeout(debounceTimer);
+        }
+        debounceTimer = setTimeout(() => {
+            debounceTimer = null;
+            doBuild().catch((error) => {
+                options.onError?.(error);
+            });
+        }, debounceMs);
+    }
+    // Set up file watcher for all include directories
+    const watcher = watch(Array.from(watchDirs), {
+        ignored: [
+            /(^|[\/\\])\../, // Ignore dotfiles
+            /node_modules/,
+            /\.tinybird-schema-.*\.mjs$/, // Ignore temporary bundle files
+            /\.tinybird-entities-.*\.mjs$/, // Ignore temporary entity files
+        ],
+        persistent: true,
+        ignoreInitial: true,
+    });
+    // Watch for changes
+    watcher.on("change", (filePath) => {
+        if (filePath.endsWith(".ts") || filePath.endsWith(".js")) {
+            scheduleBuild();
+        }
+    });
+    watcher.on("add", (filePath) => {
+        if (filePath.endsWith(".ts") || filePath.endsWith(".js")) {
+            scheduleBuild();
+        }
+    });
+    watcher.on("unlink", (filePath) => {
+        if (filePath.endsWith(".ts") || filePath.endsWith(".js")) {
+            scheduleBuild();
+        }
+    });
+    watcher.on("error", (error) => {
+        options.onError?.(error instanceof Error ? error : new Error(String(error)));
+    });
+    // Do initial build
+    await doBuild();
+    // Return controller
+    return {
+        stop: async () => {
+            if (debounceTimer) {
+                clearTimeout(debounceTimer);
+            }
+            await watcher.close();
+        },
+        rebuild: doBuild,
+        config,
+        effectiveToken,
+        branchInfo,
+    };
+}
+//# sourceMappingURL=dev.js.map

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

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

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

@@ -0,0 +1,45 @@
+/**
+ * Init command - scaffolds a new Tinybird TypeScript project
+ */
+/**
+ * Init command options
+ */
+export interface InitOptions {
+    /** Working directory (defaults to cwd) */
+    cwd?: string;
+    /** Force overwrite existing files */
+    force?: boolean;
+    /** Skip the login flow */
+    skipLogin?: boolean;
+}
+/**
+ * Init command result
+ */
+export interface InitResult {
+    /** Whether initialization was successful */
+    success: boolean;
+    /** Files that were created */
+    created: string[];
+    /** Files that were skipped (already exist) */
+    skipped: string[];
+    /** Error message if failed */
+    error?: string;
+    /** Whether login was completed */
+    loggedIn?: boolean;
+    /** Workspace name after login */
+    workspaceName?: string;
+    /** User email after login */
+    userEmail?: string;
+}
+/**
+ * Run the init command
+ *
+ * Creates:
+ * - tinybird.json in the project root
+ * - src/tinybird/ folder with datasources.ts, pipes.ts, and client.ts
+ *
+ * @param options - Init options
+ * @returns Init result
+ */
+export declare function runInit(options?: InitOptions): Promise<InitResult>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA;;GAEG;AA8HH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iCAAiC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAwJ5E"}