@tinybirdco/sdk 0.0.1

package/dist/cli/index.js

@@ -0,0 +1,337 @@
+#!/usr/bin/env node
+/**
+ * Tinybird CLI
+ * Commands for building and deploying Tinybird projects
+ */
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+import { Command } from "commander";
+import { runInit } from "./commands/init.js";
+import { runBuild } from "./commands/build.js";
+import { runDev } from "./commands/dev.js";
+import { runLogin } from "./commands/login.js";
+import { runBranchList, runBranchStatus, runBranchDelete, } from "./commands/branch.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageJson = JSON.parse(readFileSync(resolve(__dirname, "../../package.json"), "utf-8"));
+const VERSION = packageJson.version;
+/**
+ * Format timestamp for console output
+ */
+function formatTime() {
+    return new Date().toLocaleTimeString("en-US", { hour12: false });
+}
+/**
+ * Create and configure the CLI
+ */
+function createCli() {
+    const program = new Command();
+    program
+        .name("tinybird")
+        .description("Tinybird TypeScript SDK CLI")
+        .version(VERSION);
+    // Init command
+    program
+        .command("init")
+        .description("Initialize a new Tinybird TypeScript project")
+        .option("-f, --force", "Overwrite existing files")
+        .option("--skip-login", "Skip browser login flow")
+        .action(async (options) => {
+        console.log("Initializing Tinybird project...\n");
+        const result = await runInit({
+            force: options.force,
+            skipLogin: options.skipLogin,
+        });
+        if (!result.success) {
+            console.error(`Error: ${result.error}`);
+            process.exit(1);
+        }
+        if (result.created.length > 0) {
+            console.log("Created:");
+            result.created.forEach((file) => {
+                console.log(`  - ${file}`);
+            });
+        }
+        if (result.skipped.length > 0) {
+            console.log("\nSkipped (already exists):");
+            result.skipped.forEach((file) => {
+                console.log(`  - ${file}`);
+            });
+        }
+        if (result.loggedIn) {
+            console.log(`\nLogged in successfully!`);
+            if (result.workspaceName) {
+                console.log(`  Workspace: ${result.workspaceName}`);
+            }
+            if (result.userEmail) {
+                console.log(`  User: ${result.userEmail}`);
+            }
+            console.log("\nDone! Next steps:");
+            console.log("  1. Edit src/tinybird/schema.ts with your schema");
+            console.log("  2. Run 'npx tinybird dev' to start development");
+        }
+        else if (result.loggedIn === false) {
+            console.log("\nLogin was skipped or failed.");
+            console.log("\nDone! Next steps:");
+            console.log("  1. Run 'npx tinybird login' to authenticate");
+            console.log("  2. Edit src/tinybird/schema.ts with your schema");
+            console.log("  3. Run 'npx tinybird dev' to start development");
+        }
+        else {
+            console.log("\nDone! Next steps:");
+            console.log("  1. Edit src/tinybird/schema.ts with your schema");
+            console.log("  2. Run 'npx tinybird dev' to start development");
+        }
+    });
+    // Login command
+    program
+        .command("login")
+        .description("Authenticate with Tinybird via browser")
+        .action(async () => {
+        console.log("Starting authentication...\n");
+        const result = await runLogin();
+        if (!result.success) {
+            console.error(`Error: ${result.error}`);
+            process.exit(1);
+        }
+        console.log("\nAuthentication successful!");
+        if (result.workspaceName) {
+            console.log(`  Workspace: ${result.workspaceName}`);
+        }
+        if (result.userEmail) {
+            console.log(`  User: ${result.userEmail}`);
+        }
+        if (result.baseUrl) {
+            console.log(`  API Host: ${result.baseUrl}`);
+        }
+    });
+    // Build command
+    program
+        .command("build")
+        .description("Build and push resources to Tinybird")
+        .option("--dry-run", "Generate without pushing to API")
+        .option("--debug", "Show debug output including API requests/responses")
+        .action(async (options) => {
+        if (options.debug) {
+            process.env.TINYBIRD_DEBUG = "1";
+        }
+        console.log(`[${formatTime()}] Building...\n`);
+        const result = await runBuild({
+            dryRun: options.dryRun,
+        });
+        if (!result.success) {
+            console.error(`Error: ${result.error}`);
+            process.exit(1);
+        }
+        const { build, deploy } = result;
+        if (build) {
+            console.log(`Generated ${build.stats.datasourceCount} datasource(s), ${build.stats.pipeCount} pipe(s)`);
+        }
+        if (options.dryRun) {
+            console.log("\n[Dry run] Resources not deployed to API");
+            // Show generated content
+            if (build) {
+                console.log("\n--- Generated Datasources ---");
+                build.resources.datasources.forEach((ds) => {
+                    console.log(`\n${ds.name}.datasource:`);
+                    console.log(ds.content);
+                });
+                console.log("\n--- Generated Pipes ---");
+                build.resources.pipes.forEach((pipe) => {
+                    console.log(`\n${pipe.name}.pipe:`);
+                    console.log(pipe.content);
+                });
+            }
+        }
+        else if (deploy) {
+            if (deploy.result === "no_changes") {
+                console.log("No changes detected - already up to date");
+            }
+            else {
+                console.log(`Deployed to Tinybird successfully`);
+            }
+        }
+        console.log(`\n[${formatTime()}] Done in ${result.durationMs}ms`);
+    });
+    // Dev command
+    program
+        .command("dev")
+        .description("Watch for changes and sync with Tinybird")
+        .action(async () => {
+        console.log(`tinybird dev v${VERSION}`);
+        console.log("Loading config from tinybird.json...\n");
+        try {
+            const controller = await runDev({
+                onLoginComplete: (info) => {
+                    console.log("\nAuthentication successful!");
+                    if (info.workspaceName) {
+                        console.log(`  Workspace: ${info.workspaceName}`);
+                    }
+                    if (info.userEmail) {
+                        console.log(`  User: ${info.userEmail}`);
+                    }
+                    console.log("");
+                },
+                onBranchReady: (info) => {
+                    if (info.isMainBranch) {
+                        console.log("On main branch - deploying to workspace\n");
+                    }
+                    else if (info.gitBranch) {
+                        const tinybirdName = info.tinybirdBranch?.name ?? info.gitBranch;
+                        if (info.wasCreated) {
+                            console.log(`Detected git branch: ${info.gitBranch}`);
+                            console.log(`Creating Tinybird branch '${tinybirdName}'...`);
+                            console.log("Branch created and token cached.\n");
+                        }
+                        else {
+                            console.log(`Detected git branch: ${info.gitBranch}`);
+                            console.log(`Using existing Tinybird branch '${tinybirdName}'\n`);
+                        }
+                    }
+                    else {
+                        console.log("Not in a git repository - deploying to workspace\n");
+                    }
+                },
+                onBuildStart: () => {
+                    console.log(`[${formatTime()}] Building...`);
+                },
+                onBuildComplete: (result) => {
+                    if (!result.success) {
+                        console.error(`[${formatTime()}] Build failed: ${result.error}`);
+                        return;
+                    }
+                    const { deploy } = result;
+                    if (deploy) {
+                        if (deploy.result === "no_changes") {
+                            console.log(`[${formatTime()}] No changes detected`);
+                        }
+                        else {
+                            console.log(`[${formatTime()}] Built in ${result.durationMs}ms`);
+                            // Show datasource changes
+                            if (deploy.datasources) {
+                                for (const name of deploy.datasources.created) {
+                                    console.log(`  + datasource ${name} (created)`);
+                                }
+                                for (const name of deploy.datasources.changed) {
+                                    console.log(`  ~ datasource ${name} (changed)`);
+                                }
+                                for (const name of deploy.datasources.deleted) {
+                                    console.log(`  - datasource ${name} (deleted)`);
+                                }
+                            }
+                            // Show pipe changes
+                            if (deploy.pipes) {
+                                for (const name of deploy.pipes.created) {
+                                    console.log(`  + pipe ${name} (created)`);
+                                }
+                                for (const name of deploy.pipes.changed) {
+                                    console.log(`  ~ pipe ${name} (changed)`);
+                                }
+                                for (const name of deploy.pipes.deleted) {
+                                    console.log(`  - pipe ${name} (deleted)`);
+                                }
+                            }
+                        }
+                    }
+                },
+                onSchemaValidation: (validation) => {
+                    if (validation.issues.length > 0) {
+                        console.log(`[${formatTime()}] Schema validation:`);
+                        for (const issue of validation.issues) {
+                            if (issue.type === "error") {
+                                console.error(`  ERROR [${issue.pipeName}]: ${issue.message}`);
+                            }
+                            else {
+                                console.warn(`  WARN [${issue.pipeName}]: ${issue.message}`);
+                            }
+                        }
+                    }
+                },
+                onError: (error) => {
+                    console.error(`[${formatTime()}] Error: ${error.message}`);
+                },
+            });
+            console.log("Watching for changes... (Ctrl+C to stop)\n");
+            // Handle shutdown
+            const shutdown = async () => {
+                console.log("\nShutting down...");
+                await controller.stop();
+                process.exit(0);
+            };
+            process.on("SIGINT", shutdown);
+            process.on("SIGTERM", shutdown);
+            // Keep process alive
+            await new Promise(() => { });
+        }
+        catch (error) {
+            console.error(`Error: ${error.message}`);
+            process.exit(1);
+        }
+    });
+    // Branch command
+    const branchCommand = new Command("branch")
+        .description("Manage Tinybird branches");
+    branchCommand
+        .command("list")
+        .description("List all Tinybird branches")
+        .action(async () => {
+        const result = await runBranchList();
+        if (!result.success) {
+            console.error(`Error: ${result.error}`);
+            process.exit(1);
+        }
+        if (!result.branches || result.branches.length === 0) {
+            console.log("No branches found.");
+            return;
+        }
+        console.log("Branches:");
+        result.branches.forEach((branch) => {
+            console.log(`  - ${branch.name} (created: ${branch.created_at})`);
+        });
+    });
+    branchCommand
+        .command("status")
+        .description("Show current branch status")
+        .action(async () => {
+        const result = await runBranchStatus();
+        if (!result.success) {
+            console.error(`Error: ${result.error}`);
+            process.exit(1);
+        }
+        console.log("Branch Status:");
+        console.log(`  Git branch: ${result.gitBranch ?? "(not in git repo)"}`);
+        if (result.tinybirdBranchName && result.tinybirdBranchName !== result.gitBranch) {
+            console.log(`  Tinybird branch name: ${result.tinybirdBranchName} (sanitized)`);
+        }
+        console.log(`  Main branch: ${result.isMainBranch ? "yes" : "no"}`);
+        if (result.tinybirdBranch) {
+            console.log(`  Tinybird branch: ${result.tinybirdBranch.name}`);
+            console.log(`  Branch ID: ${result.tinybirdBranch.id}`);
+            console.log(`  Created: ${result.tinybirdBranch.created_at}`);
+        }
+        else if (!result.isMainBranch && result.tinybirdBranchName) {
+            console.log("  Tinybird branch: not created yet");
+            console.log("  (Run 'npx tinybird dev' to create it)");
+        }
+        console.log(`  Cached token: ${result.hasCachedToken ? "yes" : "no"}`);
+    });
+    branchCommand
+        .command("delete")
+        .description("Delete a Tinybird branch")
+        .argument("<name>", "Branch name to delete")
+        .action(async (name) => {
+        console.log(`Deleting branch '${name}'...`);
+        const result = await runBranchDelete(name);
+        if (!result.success) {
+            console.error(`Error: ${result.error}`);
+            process.exit(1);
+        }
+        console.log(`Branch '${name}' deleted successfully.`);
+    });
+    program.addCommand(branchCommand);
+    return program;
+}
+// Run CLI
+const program = createCli();
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/utils/schema-validation.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Schema validation for pipe output
+ * Validates that query responses match the declared output schema
+ */
+import type { ProjectDefinition } from "../../schema/project.js";
+import type { PipeDefinition, OutputDefinition } from "../../schema/pipe.js";
+import type { ColumnMeta } from "../../client/types.js";
+import type { LoadedEntities } from "../../generator/loader.js";
+/**
+ * Options for schema validation
+ */
+export interface SchemaValidationOptions {
+    /** The project definition containing pipe schemas (legacy) */
+    project?: ProjectDefinition;
+    /** The loaded entities containing pipe schemas (new) */
+    entities?: LoadedEntities;
+    /** Names of pipes to validate */
+    pipeNames: string[];
+    /** Tinybird API base URL */
+    baseUrl: string;
+    /** API token for authentication */
+    token: string;
+}
+/**
+ * A single validation issue
+ */
+export interface ValidationIssue {
+    /** Name of the pipe with the issue */
+    pipeName: string;
+    /** Issue severity */
+    type: "error" | "warning";
+    /** Human-readable description of the issue */
+    message: string;
+}
+/**
+ * Result of schema validation
+ */
+export interface SchemaValidationResult {
+    /** Whether all validations passed (no errors) */
+    valid: boolean;
+    /** List of validation issues found */
+    issues: ValidationIssue[];
+    /** Names of pipes that were successfully validated */
+    pipesValidated: string[];
+    /** Names of pipes that were skipped (e.g., require params) */
+    pipesSkipped: string[];
+}
+/**
+ * Internal result of validating a single pipe's output schema
+ */
+interface ColumnValidation {
+    valid: boolean;
+    missingColumns: {
+        name: string;
+        expectedType: string;
+    }[];
+    extraColumns: {
+        name: string;
+        actualType: string;
+    }[];
+    typeMismatches: {
+        name: string;
+        expectedType: string;
+        actualType: string;
+    }[];
+}
+/**
+ * Validate pipe schemas by querying them and comparing response to output definition
+ *
+ * @param options - Validation options
+ * @returns Validation result with issues found
+ */
+export declare function validatePipeSchemas(options: SchemaValidationOptions): Promise<SchemaValidationResult>;
+/**
+ * Check if a pipe has any required parameters without defaults
+ */
+declare function hasRequiredParams(pipe: PipeDefinition): boolean;
+/**
+ * Build a params object using default values from the pipe definition
+ */
+declare function buildDefaultParams(pipe: PipeDefinition): Record<string, unknown>;
+/**
+ * Validate response metadata against the expected output schema
+ */
+declare function validateOutputSchema(responseMeta: ColumnMeta[], outputSchema: OutputDefinition): ColumnValidation;
+/**
+ * Check if two ClickHouse types are compatible
+ * Handles Nullable, LowCardinality, and timezone variations
+ */
+declare function typesAreCompatible(actual: string, expected: string): boolean;
+export { typesAreCompatible as _typesAreCompatible };
+export { validateOutputSchema as _validateOutputSchema };
+export { hasRequiredParams as _hasRequiredParams };
+export { buildDefaultParams as _buildDefaultParams };
+//# sourceMappingURL=schema-validation.d.ts.map

package/dist/cli/utils/schema-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validation.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/schema-validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAmB,MAAM,yBAAyB,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,8DAA8D;IAC9D,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,iCAAiC;IACjC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,KAAK,EAAE,OAAO,CAAC;IACf,sCAAsC;IACtC,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,sDAAsD;IACtD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,8DAA8D;IAC9D,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,UAAU,gBAAgB;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,cAAc,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzD,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrD,cAAc,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC9E;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CA2FjC;AAED;;GAEG;AACH,iBAAS,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CASxD;AAED;;GAEG;AACH,iBAAS,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzE;AAED;;GAEG;AACH,iBAAS,oBAAoB,CAC3B,YAAY,EAAE,UAAU,EAAE,EAC1B,YAAY,EAAE,gBAAgB,GAC7B,gBAAgB,CAsClB;AAED;;;GAGG;AACH,iBAAS,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAoBrE;AAGD,OAAO,EAAE,kBAAkB,IAAI,mBAAmB,EAAE,CAAC;AACrD,OAAO,EAAE,oBAAoB,IAAI,qBAAqB,EAAE,CAAC;AACzD,OAAO,EAAE,iBAAiB,IAAI,kBAAkB,EAAE,CAAC;AACnD,OAAO,EAAE,kBAAkB,IAAI,mBAAmB,EAAE,CAAC"}

package/dist/cli/utils/schema-validation.js

@@ -0,0 +1,175 @@
+/**
+ * Schema validation for pipe output
+ * Validates that query responses match the declared output schema
+ */
+import { TinybirdClient } from "../../client/base.js";
+/**
+ * Validate pipe schemas by querying them and comparing response to output definition
+ *
+ * @param options - Validation options
+ * @returns Validation result with issues found
+ */
+export async function validatePipeSchemas(options) {
+    const client = new TinybirdClient({
+        baseUrl: options.baseUrl,
+        token: options.token,
+    });
+    const result = {
+        valid: true,
+        issues: [],
+        pipesValidated: [],
+        pipesSkipped: [],
+    };
+    // Get pipes from either project or entities
+    const pipes = options.entities
+        ? Object.fromEntries(Object.entries(options.entities.pipes).map(([name, { definition }]) => [name, definition]))
+        : options.project?.pipes ?? {};
+    // Only validate the specified pipes
+    for (const pipeName of options.pipeNames) {
+        // Find pipe by name
+        const pipe = Object.values(pipes).find((p) => p._name === pipeName);
+        if (!pipe) {
+            // Pipe exists in Tinybird but not in local schema (could be deleted or renamed)
+            continue;
+        }
+        // Skip if pipe has required params without defaults
+        if (hasRequiredParams(pipe)) {
+            result.pipesSkipped.push(pipeName);
+            continue;
+        }
+        // Skip if pipe has no output schema (reusable pipes)
+        if (!pipe._output) {
+            result.pipesSkipped.push(pipeName);
+            continue;
+        }
+        // Build params using defaults
+        const params = buildDefaultParams(pipe);
+        try {
+            const response = await client.query(pipeName, params);
+            const validation = validateOutputSchema(response.meta, pipe._output);
+            if (!validation.valid) {
+                result.valid = false;
+            }
+            // Add missing column errors
+            for (const missing of validation.missingColumns) {
+                result.issues.push({
+                    pipeName,
+                    type: "error",
+                    message: `Missing column '${missing.name}' (expected: ${missing.expectedType})`,
+                });
+            }
+            // Add type mismatch errors
+            for (const mismatch of validation.typeMismatches) {
+                result.issues.push({
+                    pipeName,
+                    type: "error",
+                    message: `Type mismatch '${mismatch.name}': expected ${mismatch.expectedType}, got ${mismatch.actualType}`,
+                });
+            }
+            // Add extra column warnings
+            for (const extra of validation.extraColumns) {
+                result.issues.push({
+                    pipeName,
+                    type: "warning",
+                    message: `Extra column '${extra.name}' (${extra.actualType}) not in output schema`,
+                });
+            }
+            result.pipesValidated.push(pipeName);
+        }
+        catch {
+            // Query failed - skip validation for this pipe
+            // This could happen if the pipe doesn't exist yet, network issues, etc.
+            result.pipesSkipped.push(pipeName);
+        }
+    }
+    return result;
+}
+/**
+ * Check if a pipe has any required parameters without defaults
+ */
+function hasRequiredParams(pipe) {
+    if (!pipe._params)
+        return false;
+    for (const param of Object.values(pipe._params)) {
+        if (param._required && param._default === undefined) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Build a params object using default values from the pipe definition
+ */
+function buildDefaultParams(pipe) {
+    const params = {};
+    if (!pipe._params)
+        return params;
+    for (const [name, param] of Object.entries(pipe._params)) {
+        if (param._default !== undefined) {
+            params[name] = param._default;
+        }
+    }
+    return params;
+}
+/**
+ * Validate response metadata against the expected output schema
+ */
+function validateOutputSchema(responseMeta, outputSchema) {
+    const result = {
+        valid: true,
+        missingColumns: [],
+        extraColumns: [],
+        typeMismatches: [],
+    };
+    // Build a map of response columns for lookup
+    const responseColumns = new Map(responseMeta.map((col) => [col.name, col.type]));
+    // Check each expected column from the schema
+    for (const [name, validator] of Object.entries(outputSchema)) {
+        const expectedType = validator._tinybirdType;
+        const actualType = responseColumns.get(name);
+        if (!actualType) {
+            // Column missing from response
+            result.missingColumns.push({ name, expectedType });
+            result.valid = false;
+        }
+        else if (!typesAreCompatible(actualType, expectedType)) {
+            // Column exists but type doesn't match
+            result.typeMismatches.push({ name, expectedType, actualType });
+            result.valid = false;
+        }
+        // Remove from map so we can find extra columns
+        responseColumns.delete(name);
+    }
+    // Remaining columns are extras (warnings, not errors)
+    for (const [name, actualType] of responseColumns) {
+        result.extraColumns.push({ name, actualType });
+    }
+    return result;
+}
+/**
+ * Check if two ClickHouse types are compatible
+ * Handles Nullable, LowCardinality, and timezone variations
+ */
+function typesAreCompatible(actual, expected) {
+    const normalize = (t) => {
+        let normalized = t;
+        // Remove LowCardinality(Nullable(...)) to just the inner type (must be before individual removals)
+        normalized = normalized.replace(/^LowCardinality\(Nullable\((.+)\)\)$/, "$1");
+        // Remove Nullable wrapper
+        normalized = normalized.replace(/^Nullable\((.+)\)$/, "$1");
+        // Remove LowCardinality wrapper
+        normalized = normalized.replace(/^LowCardinality\((.+)\)$/, "$1");
+        // Remove timezone from DateTime
+        normalized = normalized.replace(/^DateTime\('.+'\)$/, "DateTime");
+        // Remove precision and timezone from DateTime64
+        normalized = normalized.replace(/^DateTime64\(\d+(, '.+')?\)$/, "DateTime64");
+        return normalized;
+    };
+    return normalize(actual) === normalize(expected);
+}
+// Export internal functions for testing
+export { typesAreCompatible as _typesAreCompatible };
+export { validateOutputSchema as _validateOutputSchema };
+export { hasRequiredParams as _hasRequiredParams };
+export { buildDefaultParams as _buildDefaultParams };
+//# sourceMappingURL=schema-validation.js.map

package/dist/cli/utils/schema-validation.js.map

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

package/dist/cli/utils/schema-validation.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for schema validation utility
+ */
+export {};
+//# sourceMappingURL=schema-validation.test.d.ts.map

package/dist/cli/utils/schema-validation.test.d.ts.map

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