@tinybirdco/sdk 0.0.1

package/dist/client/types.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Client types for Tinybird API interactions
+ */
+/**
+ * Configuration for the Tinybird client
+ */
+export interface ClientConfig {
+    /** Tinybird API base URL (e.g., 'https://api.tinybird.co' or 'https://api.us-east.tinybird.co') */
+    baseUrl: string;
+    /** API token for authentication */
+    token: string;
+    /** Custom fetch implementation (optional, defaults to global fetch) */
+    fetch?: typeof fetch;
+    /** Default timeout in milliseconds (optional) */
+    timeout?: number;
+    /**
+     * Enable dev mode to automatically use branch tokens when on a feature branch.
+     * When enabled, the client will detect the git branch and use the corresponding
+     * Tinybird branch token instead of the workspace token.
+     */
+    devMode?: boolean;
+}
+/**
+ * Column metadata from query response
+ */
+export interface ColumnMeta {
+    /** Column name */
+    name: string;
+    /** Column type (Tinybird/ClickHouse type) */
+    type: string;
+}
+/**
+ * Query statistics from response
+ */
+export interface QueryStatistics {
+    /** Time elapsed in seconds */
+    elapsed: number;
+    /** Number of rows read */
+    rows_read: number;
+    /** Number of bytes read */
+    bytes_read: number;
+}
+/**
+ * Result of a query operation
+ */
+export interface QueryResult<T> {
+    /** Query result data */
+    data: T[];
+    /** Column metadata */
+    meta: ColumnMeta[];
+    /** Number of rows returned */
+    rows: number;
+    /** Query statistics */
+    statistics: QueryStatistics;
+}
+/**
+ * Result of an ingest operation
+ */
+export interface IngestResult {
+    /** Number of rows successfully ingested */
+    successful_rows: number;
+    /** Number of rows that failed to ingest */
+    quarantined_rows: number;
+}
+/**
+ * Error response from Tinybird API
+ */
+export interface TinybirdErrorResponse {
+    /** Error message */
+    error: string;
+    /** HTTP status code */
+    status?: number;
+    /** Additional error details */
+    documentation?: string;
+}
+/**
+ * Custom error class for Tinybird API errors
+ */
+export declare class TinybirdError extends Error {
+    /** HTTP status code */
+    readonly statusCode: number;
+    /** Raw error response */
+    readonly response?: TinybirdErrorResponse;
+    constructor(message: string, statusCode: number, response?: TinybirdErrorResponse);
+    /**
+     * Check if this is a rate limit error
+     */
+    isRateLimitError(): boolean;
+    /**
+     * Check if this is an authentication error
+     */
+    isAuthError(): boolean;
+    /**
+     * Check if this is a not found error
+     */
+    isNotFoundError(): boolean;
+    /**
+     * Check if this is a server error
+     */
+    isServerError(): boolean;
+}
+/**
+ * Options for query requests
+ */
+export interface QueryOptions {
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** AbortController signal for cancellation */
+    signal?: AbortSignal;
+}
+/**
+ * Options for ingest requests
+ */
+export interface IngestOptions {
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** AbortController signal for cancellation */
+    signal?: AbortSignal;
+    /** Wait for the ingestion to complete before returning */
+    wait?: boolean;
+}
+/**
+ * Base interface for typed pipe endpoints
+ */
+export interface TypedPipeEndpoint<TParams, TOutput> {
+    (params: TParams, options?: QueryOptions): Promise<QueryResult<TOutput>>;
+}
+/**
+ * Base interface for typed datasource ingestion
+ */
+export interface TypedDatasourceIngest<TRow> {
+    /** Send a single event */
+    send(event: TRow, options?: IngestOptions): Promise<IngestResult>;
+    /** Send multiple events in a batch */
+    sendBatch(events: TRow[], options?: IngestOptions): Promise<IngestResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mGAAmG;IACnG,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,wBAAwB;IACxB,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,sBAAsB;IACtB,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,UAAU,EAAE,eAAe,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,uBAAuB;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yBAAyB;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;gBAE9B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,qBAAqB;IAOjF;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAI3B;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,aAAa,IAAI,OAAO;CAGzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,0DAA0D;IAC1D,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,OAAO,EAAE,OAAO;IACjD,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;CAC1E;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,IAAI;IACzC,0BAA0B;IAC1B,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAClE,sCAAsC;IACtC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC3E"}

package/dist/client/types.js

@@ -0,0 +1,43 @@
+/**
+ * Client types for Tinybird API interactions
+ */
+/**
+ * Custom error class for Tinybird API errors
+ */
+export class TinybirdError extends Error {
+    /** HTTP status code */
+    statusCode;
+    /** Raw error response */
+    response;
+    constructor(message, statusCode, response) {
+        super(message);
+        this.name = "TinybirdError";
+        this.statusCode = statusCode;
+        this.response = response;
+    }
+    /**
+     * Check if this is a rate limit error
+     */
+    isRateLimitError() {
+        return this.statusCode === 429;
+    }
+    /**
+     * Check if this is an authentication error
+     */
+    isAuthError() {
+        return this.statusCode === 401 || this.statusCode === 403;
+    }
+    /**
+     * Check if this is a not found error
+     */
+    isNotFoundError() {
+        return this.statusCode === 404;
+    }
+    /**
+     * Check if this is a server error
+     */
+    isServerError() {
+        return this.statusCode >= 500;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgFH;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,uBAAuB;IACd,UAAU,CAAS;IAC5B,yBAAyB;IAChB,QAAQ,CAAyB;IAE1C,YAAY,OAAe,EAAE,UAAkB,EAAE,QAAgC;QAC/E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,UAAU,KAAK,GAAG,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,UAAU,KAAK,GAAG,IAAI,IAAI,CAAC,UAAU,KAAK,GAAG,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,UAAU,KAAK,GAAG,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC;IAChC,CAAC;CACF"}

package/dist/generator/client.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Client file generator
+ * Generates a typed tinybird.ts client file from discovered entities
+ */
+import type { LoadedEntities } from "./loader.js";
+/**
+ * Options for generating the client file
+ */
+export interface GenerateClientOptions {
+    /** Loaded entities from source files */
+    entities: LoadedEntities;
+    /** Output file path (relative to cwd) */
+    outputPath: string;
+    /** Working directory */
+    cwd: string;
+}
+/**
+ * Result of generating the client file
+ */
+export interface GeneratedClient {
+    /** The generated file content */
+    content: string;
+    /** Absolute path to output file */
+    absolutePath: string;
+}
+/**
+ * Generate the client file content
+ *
+ * @param options - Generation options
+ * @returns Generated client file info
+ *
+ * @example
+ * ```ts
+ * const result = generateClientFile({
+ *   entities: loadedEntities,
+ *   outputPath: 'src/tinybird.ts',
+ *   cwd: '/path/to/project',
+ * });
+ *
+ * fs.writeFileSync(result.absolutePath, result.content);
+ * ```
+ */
+export declare function generateClientFile(options: GenerateClientOptions): GeneratedClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/generator/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/generator/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,QAAQ,EAAE,cAAc,CAAC;IACzB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;CACtB;AAkCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,qBAAqB,GAAG,eAAe,CAkHlF"}

package/dist/generator/client.js

@@ -0,0 +1,144 @@
+/**
+ * Client file generator
+ * Generates a typed tinybird.ts client file from discovered entities
+ */
+import * as path from "path";
+/**
+ * Convert a file path to a relative import path
+ * e.g., "src/datasources.ts" -> "./datasources" when output is "src/tinybird.ts"
+ */
+function toRelativeImport(fromPath, toPath) {
+    // Get directory of the from file
+    const fromDir = path.dirname(fromPath);
+    // Get relative path from output dir to source file
+    let relativePath = path.relative(fromDir, toPath);
+    // Normalize Windows separators to forward slashes for TS imports
+    relativePath = relativePath.replace(/\\/g, "/");
+    // Remove .ts extension
+    relativePath = relativePath.replace(/\.tsx?$/, "");
+    // Ensure it starts with ./ or ../
+    if (!relativePath.startsWith(".") && !relativePath.startsWith("/")) {
+        relativePath = "./" + relativePath;
+    }
+    return relativePath;
+}
+/**
+ * Convert camelCase to PascalCase
+ */
+function toPascalCase(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+/**
+ * Generate the client file content
+ *
+ * @param options - Generation options
+ * @returns Generated client file info
+ *
+ * @example
+ * ```ts
+ * const result = generateClientFile({
+ *   entities: loadedEntities,
+ *   outputPath: 'src/tinybird.ts',
+ *   cwd: '/path/to/project',
+ * });
+ *
+ * fs.writeFileSync(result.absolutePath, result.content);
+ * ```
+ */
+export function generateClientFile(options) {
+    const { entities, outputPath, cwd } = options;
+    const absolutePath = path.isAbsolute(outputPath) ? outputPath : path.join(cwd, outputPath);
+    // Group entities by source file for imports
+    const importsByFile = new Map();
+    for (const [name, { info }] of Object.entries(entities.datasources)) {
+        if (!importsByFile.has(info.sourceFile)) {
+            importsByFile.set(info.sourceFile, { datasources: [], pipes: [] });
+        }
+        importsByFile.get(info.sourceFile).datasources.push(name);
+    }
+    for (const [name, { info }] of Object.entries(entities.pipes)) {
+        if (!importsByFile.has(info.sourceFile)) {
+            importsByFile.set(info.sourceFile, { datasources: [], pipes: [] });
+        }
+        importsByFile.get(info.sourceFile).pipes.push(name);
+    }
+    // Build import statements
+    const importLines = [];
+    const reexportLines = [];
+    // SDK imports
+    const sdkTypes = ["InferRow"];
+    if (Object.keys(entities.pipes).length > 0) {
+        sdkTypes.push("InferParams", "InferOutputRow");
+    }
+    importLines.push(`import { createTinybirdClient, type ${sdkTypes.join(", type ")} } from "@tinybirdco/sdk";`);
+    importLines.push("");
+    // Entity imports and re-exports
+    for (const [sourceFile, { datasources, pipes }] of importsByFile) {
+        const allExports = [...datasources, ...pipes];
+        if (allExports.length === 0)
+            continue;
+        // Resolve to absolute paths for correct relative path calculation
+        const sourceAbsolute = path.isAbsolute(sourceFile) ? sourceFile : path.join(cwd, sourceFile);
+        const relativePath = toRelativeImport(absolutePath, sourceAbsolute);
+        importLines.push(`import { ${allExports.join(", ")} } from "${relativePath}";`);
+        reexportLines.push(`export { ${allExports.join(", ")} } from "${relativePath}";`);
+    }
+    // Build createTinybirdClient call
+    const datasourceNames = Object.keys(entities.datasources);
+    const pipeNames = Object.keys(entities.pipes);
+    const clientLines = [];
+    clientLines.push("export const tinybird = createTinybirdClient({");
+    if (datasourceNames.length > 0) {
+        clientLines.push(`  datasources: { ${datasourceNames.join(", ")} },`);
+    }
+    else {
+        clientLines.push("  datasources: {},");
+    }
+    if (pipeNames.length > 0) {
+        clientLines.push(`  pipes: { ${pipeNames.join(", ")} },`);
+    }
+    else {
+        clientLines.push("  pipes: {},");
+    }
+    clientLines.push("});");
+    // Build type exports
+    const typeLines = [];
+    for (const name of datasourceNames) {
+        const pascalName = toPascalCase(name);
+        typeLines.push(`export type ${pascalName}Row = InferRow<typeof ${name}>;`);
+    }
+    for (const name of pipeNames) {
+        const { definition } = entities.pipes[name];
+        const pascalName = toPascalCase(name);
+        typeLines.push(`export type ${pascalName}Params = InferParams<typeof ${name}>;`);
+        // Only generate Output type for pipes with output schema
+        if (definition._output) {
+            typeLines.push(`export type ${pascalName}Output = InferOutputRow<typeof ${name}>;`);
+        }
+    }
+    // Combine all sections
+    const sections = [
+        "// Auto-generated by @tinybirdco/sdk - DO NOT EDIT",
+        "// This file is regenerated on every build. Manual changes will be overwritten.",
+        "",
+        importLines.join("\n"),
+        "",
+        "// Typed Tinybird client",
+        clientLines.join("\n"),
+        "",
+        "// Re-export entities for convenience",
+        reexportLines.join("\n"),
+    ];
+    if (typeLines.length > 0) {
+        sections.push("");
+        sections.push("// Inferred types from entity definitions");
+        sections.push(typeLines.join("\n"));
+    }
+    sections.push(""); // Trailing newline
+    const content = sections.join("\n");
+    return {
+        content,
+        absolutePath,
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/generator/client.js.map

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

package/dist/generator/datasource.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Datasource content generator
+ * Converts DatasourceDefinition to native .datasource file format
+ */
+import type { DatasourceDefinition } from "../schema/datasource.js";
+/**
+ * Generated datasource content
+ */
+export interface GeneratedDatasource {
+    /** Datasource name */
+    name: string;
+    /** The generated .datasource file content */
+    content: string;
+}
+/**
+ * Generate a .datasource file content from a DatasourceDefinition
+ *
+ * @param datasource - The datasource definition
+ * @returns Generated datasource content
+ *
+ * @example
+ * ```ts
+ * const events = defineDatasource('events', {
+ *   description: 'User events',
+ *   schema: {
+ *     timestamp: t.dateTime(),
+ *     user_id: t.string(),
+ *     event: t.string(),
+ *   },
+ *   engine: engine.mergeTree({
+ *     sortingKey: ['user_id', 'timestamp'],
+ *   }),
+ * });
+ *
+ * const { content } = generateDatasource(events);
+ * // Returns:
+ * // DESCRIPTION >
+ * //     User events
+ * //
+ * // SCHEMA >
+ * //     timestamp DateTime,
+ * //     user_id String,
+ * //     event String
+ * //
+ * // ENGINE "MergeTree"
+ * // ENGINE_SORTING_KEY "user_id, timestamp"
+ * ```
+ */
+export declare function generateDatasource(datasource: DatasourceDefinition): GeneratedDatasource;
+/**
+ * Generate .datasource files for all datasources in a project
+ *
+ * @param datasources - Record of datasource definitions
+ * @returns Array of generated datasource content
+ */
+export declare function generateAllDatasources(datasources: Record<string, DatasourceDefinition>): GeneratedDatasource[];
+//# sourceMappingURL=datasource.d.ts.map

package/dist/generator/datasource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datasource.d.ts","sourceRoot":"","sources":["../../src/generator/datasource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAsC,MAAM,yBAAyB,CAAC;AAKxG;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;CACjB;AA+HD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,oBAAoB,GAC/B,mBAAmB,CAuBrB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAChD,mBAAmB,EAAE,CAEvB"}

package/dist/generator/datasource.js

@@ -0,0 +1,169 @@
+/**
+ * Datasource content generator
+ * Converts DatasourceDefinition to native .datasource file format
+ */
+import { getColumnType, getColumnJsonPath } from "../schema/datasource.js";
+import { getEngineClause } from "../schema/engines.js";
+/**
+ * Get the Tinybird type string from a type validator
+ * Handles the internal structure of validators
+ */
+function getTinybirdTypeFromValidator(validator) {
+    // The validator has _tinybirdType as the type string
+    return validator._tinybirdType;
+}
+/**
+ * Get modifiers from a validator
+ */
+function getModifiersFromValidator(validator) {
+    return validator._modifiers;
+}
+/**
+ * Format a default value for the datasource file
+ */
+function formatDefaultValue(value, tinybirdType) {
+    if (value === null) {
+        return "NULL";
+    }
+    if (typeof value === "string") {
+        // Escape single quotes
+        return `'${value.replace(/'/g, "\\'")}'`;
+    }
+    if (typeof value === "number" || typeof value === "bigint") {
+        return String(value);
+    }
+    if (typeof value === "boolean") {
+        return value ? "1" : "0";
+    }
+    if (value instanceof Date) {
+        // Format based on type
+        if (tinybirdType.startsWith("Date") && !tinybirdType.includes("Time")) {
+            return `'${value.toISOString().split("T")[0]}'`;
+        }
+        return `'${value.toISOString().replace("T", " ").slice(0, 19)}'`;
+    }
+    // For arrays and objects, use raw JSON (no quotes)
+    if (Array.isArray(value)) {
+        return JSON.stringify(value);
+    }
+    if (typeof value === "object" && value !== null) {
+        return JSON.stringify(value);
+    }
+    // Fallback for other types - stringify as string literal
+    return `'${String(value).replace(/'/g, "\\'")}'`;
+}
+/**
+ * Generate a column definition line for the schema
+ */
+function generateColumnLine(columnName, column, includeJsonPaths) {
+    const validator = getColumnType(column);
+    const jsonPath = getColumnJsonPath(column);
+    const tinybirdType = getTinybirdTypeFromValidator(validator);
+    const modifiers = getModifiersFromValidator(validator);
+    const parts = [`    ${columnName} ${tinybirdType}`];
+    // Add JSON path for Events API ingestion support if enabled
+    // Use explicit jsonPath if defined, otherwise default to $.columnName
+    if (includeJsonPaths) {
+        const effectiveJsonPath = jsonPath ?? `$.${columnName}`;
+        parts.push(`\`json:${effectiveJsonPath}\``);
+    }
+    // Add default value if defined
+    if (modifiers.hasDefault && modifiers.defaultValue !== undefined) {
+        const defaultStr = formatDefaultValue(modifiers.defaultValue, tinybirdType);
+        parts.push(`DEFAULT ${defaultStr}`);
+    }
+    // Add codec if defined
+    if (modifiers.codec) {
+        parts.push(`CODEC(${modifiers.codec})`);
+    }
+    return parts.join(" ");
+}
+/**
+ * Generate the SCHEMA section
+ */
+function generateSchema(schema, includeJsonPaths) {
+    const lines = ["SCHEMA >"];
+    const columnNames = Object.keys(schema);
+    columnNames.forEach((name, index) => {
+        const column = schema[name];
+        const line = generateColumnLine(name, column, includeJsonPaths);
+        // Add comma if not the last column
+        const suffix = index < columnNames.length - 1 ? "," : "";
+        lines.push(line + suffix);
+    });
+    return lines.join("\n");
+}
+/**
+ * Generate the engine configuration
+ * Uses the helper from engines.ts if an engine is provided
+ */
+function generateEngineConfig(engine) {
+    if (!engine) {
+        // Default to MergeTree with first column as sorting key
+        return 'ENGINE "MergeTree"';
+    }
+    return getEngineClause(engine);
+}
+/**
+ * Generate a .datasource file content from a DatasourceDefinition
+ *
+ * @param datasource - The datasource definition
+ * @returns Generated datasource content
+ *
+ * @example
+ * ```ts
+ * const events = defineDatasource('events', {
+ *   description: 'User events',
+ *   schema: {
+ *     timestamp: t.dateTime(),
+ *     user_id: t.string(),
+ *     event: t.string(),
+ *   },
+ *   engine: engine.mergeTree({
+ *     sortingKey: ['user_id', 'timestamp'],
+ *   }),
+ * });
+ *
+ * const { content } = generateDatasource(events);
+ * // Returns:
+ * // DESCRIPTION >
+ * //     User events
+ * //
+ * // SCHEMA >
+ * //     timestamp DateTime,
+ * //     user_id String,
+ * //     event String
+ * //
+ * // ENGINE "MergeTree"
+ * // ENGINE_SORTING_KEY "user_id, timestamp"
+ * ```
+ */
+export function generateDatasource(datasource) {
+    const parts = [];
+    // Add description if present
+    if (datasource.options.description) {
+        parts.push(`DESCRIPTION >\n    ${datasource.options.description}`);
+        parts.push("");
+    }
+    // Check if JSON paths should be included (defaults to true)
+    const includeJsonPaths = datasource.options.jsonPaths !== false;
+    // Add schema
+    parts.push(generateSchema(datasource._schema, includeJsonPaths));
+    parts.push("");
+    // Add engine configuration
+    parts.push(generateEngineConfig(datasource.options.engine));
+    return {
+        name: datasource._name,
+        content: parts.join("\n"),
+    };
+}
+/**
+ * Generate .datasource files for all datasources in a project
+ *
+ * @param datasources - Record of datasource definitions
+ * @returns Array of generated datasource content
+ */
+export function generateAllDatasources(datasources) {
+    return Object.values(datasources).map(generateDatasource);
+}
+//# sourceMappingURL=datasource.js.map

package/dist/generator/datasource.js.map

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

package/dist/generator/datasource.test.d.ts

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

package/dist/generator/datasource.test.d.ts.map

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