/**
 * Engine configurations for Tinybird datasources
 * ClickHouse table engines determine how data is stored and queried
 */
/**
 * Base configuration shared by all MergeTree engines
 */
export interface BaseMergeTreeConfig {
    /** Columns used for sorting data within parts (required for all MergeTree engines) */
    sortingKey: string | readonly string[];
    /** Expression for partitioning data (e.g., 'toYYYYMM(timestamp)') */
    partitionKey?: string;
    /** Primary key columns (defaults to sortingKey if not specified) */
    primaryKey?: string | readonly string[];
    /** TTL expression for automatic data expiration (e.g., 'timestamp + INTERVAL 90 DAY') */
    ttl?: string;
    /** Additional engine settings */
    settings?: Record<string, string | number | boolean>;
}
/**
 * MergeTree engine configuration
 * The most universal and functional table engine for high-load tasks
 */
export interface MergeTreeConfig extends BaseMergeTreeConfig {
    type: "MergeTree";
}
/**
 * ReplacingMergeTree engine configuration
 * Removes duplicate rows with the same sorting key during merges
 */
export interface ReplacingMergeTreeConfig extends BaseMergeTreeConfig {
    type: "ReplacingMergeTree";
    /** Optional version column - rows with highest version are kept */
    ver?: string;
    /** Optional flag to enable clean mode (ClickHouse 23.2+) */
    isDeleted?: string;
}
/**
 * SummingMergeTree engine configuration
 * Sums numeric columns for rows with the same sorting key during merges
 */
export interface SummingMergeTreeConfig extends BaseMergeTreeConfig {
    type: "SummingMergeTree";
    /** Columns to sum (if not specified, all numeric columns are summed) */
    columns?: readonly string[];
}
/**
 * AggregatingMergeTree engine configuration
 * For incremental data aggregation with AggregateFunction columns
 */
export interface AggregatingMergeTreeConfig extends BaseMergeTreeConfig {
    type: "AggregatingMergeTree";
}
/**
 * CollapsingMergeTree engine configuration
 * For collapsing rows that cancel each other out
 */
export interface CollapsingMergeTreeConfig extends BaseMergeTreeConfig {
    type: "CollapsingMergeTree";
    /** Column containing sign (1 for state, -1 for cancel) */
    sign: string;
}
/**
 * VersionedCollapsingMergeTree engine configuration
 * For collapsing with versioning when events may arrive out of order
 */
export interface VersionedCollapsingMergeTreeConfig extends BaseMergeTreeConfig {
    type: "VersionedCollapsingMergeTree";
    /** Column containing sign (1 for state, -1 for cancel) */
    sign: string;
    /** Column containing version number */
    version: string;
}
/**
 * Null engine configuration
 * Discards inserted rows and returns an empty response when read
 */
export interface NullEngineConfig {
    type: "Null";
}
/**
 * Union type of all engine configurations
 */
export type MergeTreeEngineConfig = MergeTreeConfig | ReplacingMergeTreeConfig | SummingMergeTreeConfig | AggregatingMergeTreeConfig | CollapsingMergeTreeConfig | VersionedCollapsingMergeTreeConfig;
export type EngineConfig = MergeTreeEngineConfig | NullEngineConfig;
/**
 * Engine configuration builders
 *
 * @example
 * ```ts
 * import { engine } from '@tinybirdco/sdk';
 *
 * // Basic MergeTree
 * engine.mergeTree({
 *   sortingKey: ['user_id', 'timestamp'],
 *   partitionKey: 'toYYYYMM(timestamp)',
 * });
 *
 * // ReplacingMergeTree for upserts
 * engine.replacingMergeTree({
 *   sortingKey: ['id'],
 *   ver: 'updated_at',
 * });
 *
 * // SummingMergeTree for counters
 * engine.summingMergeTree({
 *   sortingKey: ['date', 'metric_name'],
 *   columns: ['value'],
 * });
 *
 * // Null engine for materialized view source tables
 * engine.null();
 * ```
 */
export declare const engine: {
    /**
     * MergeTree - The most universal engine for high-load tasks
     * Best for: General-purpose analytics, logs, events
     */
    readonly mergeTree: (config: Omit<MergeTreeConfig, "type">) => MergeTreeConfig;
    /**
     * ReplacingMergeTree - Removes duplicates during background merges
     * Best for: Maintaining latest state, upserts, slowly changing dimensions
     *
     * @param config.ver - Optional version column. Rows with highest version are kept.
     */
    readonly replacingMergeTree: (config: Omit<ReplacingMergeTreeConfig, "type">) => ReplacingMergeTreeConfig;
    /**
     * SummingMergeTree - Sums numeric columns during background merges
     * Best for: Counters, metrics aggregation, pre-aggregated data
     *
     * @param config.columns - Columns to sum. If not specified, all numeric columns are summed.
     */
    readonly summingMergeTree: (config: Omit<SummingMergeTreeConfig, "type">) => SummingMergeTreeConfig;
    /**
     * AggregatingMergeTree - For incremental aggregation with AggregateFunction columns
     * Best for: Materialized views, incremental aggregation pipelines
     */
    readonly aggregatingMergeTree: (config: Omit<AggregatingMergeTreeConfig, "type">) => AggregatingMergeTreeConfig;
    /**
     * CollapsingMergeTree - For collapsing state/cancel row pairs
     * Best for: Changelog-style updates, mutable data with deletes
     *
     * @param config.sign - Column containing 1 (state) or -1 (cancel)
     */
    readonly collapsingMergeTree: (config: Omit<CollapsingMergeTreeConfig, "type">) => CollapsingMergeTreeConfig;
    /**
     * VersionedCollapsingMergeTree - Collapsing with versioning for out-of-order events
     * Best for: Changelog-style updates with potential out-of-order arrival
     *
     * @param config.sign - Column containing 1 (state) or -1 (cancel)
     * @param config.version - Column containing version number for ordering
     */
    readonly versionedCollapsingMergeTree: (config: Omit<VersionedCollapsingMergeTreeConfig, "type">) => VersionedCollapsingMergeTreeConfig;
    /**
     * Null - Discards inserted rows and returns no rows when read
     * Best for: Materialized view source tables that transform and discard raw input
     */
    readonly null: () => NullEngineConfig;
};
/**
 * Get the sorting key as an array
 */
export declare function getSortingKey(config: MergeTreeEngineConfig): readonly string[];
/**
 * Get the primary key as an array (defaults to sorting key)
 */
export declare function getPrimaryKey(config: MergeTreeEngineConfig): readonly string[];
/**
 * Generate the engine clause for a datasource file
 */
export declare function getEngineClause(config: EngineConfig): string;
//# sourceMappingURL=engines.d.ts.map