/**
 * Column type validators for Tinybird datasources
 * Similar to Convex's `v.*` pattern, but for ClickHouse types
 */
declare const VALIDATOR_BRAND: unique symbol;
/**
 * Base interface for all type validators
 * The phantom types enable TypeScript to infer the correct types
 */
export interface TypeValidator<TType, TTinybirdType extends string = string, TModifiers extends TypeModifiers = TypeModifiers> {
    readonly [VALIDATOR_BRAND]: true;
    /** The inferred TypeScript type */
    readonly _type: TType;
    /** The Tinybird/ClickHouse type string */
    readonly _tinybirdType: TTinybirdType;
    /** Metadata about modifiers applied */
    readonly _modifiers: TModifiers;
    /** Mark this output field as optional (it may be absent from endpoint responses) */
    optional(): TypeValidator<TType, TTinybirdType, TModifiers & {
        optional: true;
    }>;
    /** Make this column nullable */
    nullable(): TypeValidator<TType | null, `Nullable(${TTinybirdType})`, TModifiers & {
        nullable: true;
    }>;
    /** Apply LowCardinality optimization (for strings with few unique values) */
    lowCardinality(): TypeValidator<TType, `LowCardinality(${TTinybirdType})`, TModifiers & {
        lowCardinality: true;
    }>;
    /** Set a default value for the column */
    default(value: TType): TypeValidator<TType, TTinybirdType, TModifiers & {
        hasDefault: true;
        defaultValue: TType;
    }>;
    /** Set a default SQL expression for the column (for example: generateUUIDv4()) */
    defaultExpr(expression: string): TypeValidator<TType, TTinybirdType, TModifiers & {
        hasDefault: true;
        defaultExpression: string;
    }>;
    /** Set a codec for compression */
    codec(codec: string): TypeValidator<TType, TTinybirdType, TModifiers & {
        codec: string;
    }>;
    /** Set an explicit JSON path for extraction (overrides autogenerated path) */
    jsonPath(path: string): TypeValidator<TType, TTinybirdType, TModifiers & {
        jsonPath: string;
    }>;
}
export interface TypeModifiers {
    optional?: boolean;
    nullable?: boolean;
    lowCardinality?: boolean;
    hasDefault?: boolean;
    defaultValue?: unknown;
    defaultExpression?: string;
    codec?: string;
    jsonPath?: string;
}
type AggregateFunctionValidator = {
    <TFunc extends string>(func: TFunc): TypeValidator<unknown, `AggregateFunction(${TFunc})`, TypeModifiers>;
    <TFunc extends string, TTypes extends readonly [
        TypeValidator<unknown, string, TypeModifiers>,
        ...TypeValidator<unknown, string, TypeModifiers>[]
    ]>(func: TFunc, ...types: TTypes): TypeValidator<AggregateFunctionValue<TTypes>, AggregateFunctionTinybirdType<TFunc, TTypes>, TypeModifiers>;
};
type AggregateFunctionValue<TTypes extends readonly TypeValidator<unknown, string, TypeModifiers>[]> = TTypes extends readonly [
    infer TFirst extends TypeValidator<unknown, string, TypeModifiers>,
    ...TypeValidator<unknown, string, TypeModifiers>[]
] ? TFirst["_type"] : unknown;
type AggregateFunctionArgs<TTypes extends readonly TypeValidator<unknown, string, TypeModifiers>[]> = TTypes extends readonly [
    infer TFirst extends TypeValidator<unknown, string, TypeModifiers>,
    ...infer TRest extends TypeValidator<unknown, string, TypeModifiers>[]
] ? TRest extends [] ? TFirst["_tinybirdType"] : `${TFirst["_tinybirdType"]}, ${AggregateFunctionArgs<TRest>}` : never;
type AggregateFunctionTinybirdType<TFunc extends string, TTypes extends readonly TypeValidator<unknown, string, TypeModifiers>[]> = TTypes extends [] ? `AggregateFunction(${TFunc})` : `AggregateFunction(${TFunc}, ${AggregateFunctionArgs<TTypes>})`;
/**
 * Type validators for Tinybird columns
 *
 * @example
 * ```ts
 * import { t } from '@tinybirdco/sdk';
 *
 * const schema = {
 *   id: t.string(),
 *   count: t.int32(),
 *   timestamp: t.dateTime(),
 *   tags: t.array(t.string()),
 *   metadata: t.json(),
 * };
 *
 * // With custom types for narrower type inference:
 * type UserId = string & { readonly __brand: 'UserId' };
 * type Timestamp = string & { readonly __brand: 'Timestamp' };
 *
 * const typedSchema = {
 *   user_id: t.string<UserId>(),
 *   created_at: t.dateTime<Timestamp>(),
 * };
 * ```
 */
export declare const t: {
    /** String type - variable length UTF-8 string */
    readonly string: <T extends string = string>() => TypeValidator<T, "String", TypeModifiers>;
    /** FixedString(N) - fixed length string, padded with null bytes */
    readonly fixedString: <T extends string = string>(length: number) => TypeValidator<T, `FixedString(${number})`, TypeModifiers>;
    /** UUID - 16-byte universally unique identifier */
    readonly uuid: <T extends string = string>() => TypeValidator<T, "UUID", TypeModifiers>;
    /** Int8 - signed 8-bit integer (-128 to 127) */
    readonly int8: <T extends number = number>() => TypeValidator<T, "Int8", TypeModifiers>;
    /** Int16 - signed 16-bit integer */
    readonly int16: <T extends number = number>() => TypeValidator<T, "Int16", TypeModifiers>;
    /** Int32 - signed 32-bit integer */
    readonly int32: <T extends number = number>() => TypeValidator<T, "Int32", TypeModifiers>;
    /** Int64 - signed 64-bit integer (represented as number, may lose precision) */
    readonly int64: <T extends number = number>() => TypeValidator<T, "Int64", TypeModifiers>;
    /** Int128 - signed 128-bit integer (represented as bigint) */
    readonly int128: <T extends bigint = bigint>() => TypeValidator<T, "Int128", TypeModifiers>;
    /** Int256 - signed 256-bit integer (represented as bigint) */
    readonly int256: <T extends bigint = bigint>() => TypeValidator<T, "Int256", TypeModifiers>;
    /** UInt8 - unsigned 8-bit integer (0 to 255) */
    readonly uint8: <T extends number = number>() => TypeValidator<T, "UInt8", TypeModifiers>;
    /** UInt16 - unsigned 16-bit integer */
    readonly uint16: <T extends number = number>() => TypeValidator<T, "UInt16", TypeModifiers>;
    /** UInt32 - unsigned 32-bit integer */
    readonly uint32: <T extends number = number>() => TypeValidator<T, "UInt32", TypeModifiers>;
    /** UInt64 - unsigned 64-bit integer (represented as number, may lose precision) */
    readonly uint64: <T extends number = number>() => TypeValidator<T, "UInt64", TypeModifiers>;
    /** UInt128 - unsigned 128-bit integer (represented as bigint) */
    readonly uint128: <T extends bigint = bigint>() => TypeValidator<T, "UInt128", TypeModifiers>;
    /** UInt256 - unsigned 256-bit integer (represented as bigint) */
    readonly uint256: <T extends bigint = bigint>() => TypeValidator<T, "UInt256", TypeModifiers>;
    /** Float32 - 32-bit floating point */
    readonly float32: <T extends number = number>() => TypeValidator<T, "Float32", TypeModifiers>;
    /** Float64 - 64-bit floating point (double precision) */
    readonly float64: <T extends number = number>() => TypeValidator<T, "Float64", TypeModifiers>;
    /** Decimal(precision, scale) - fixed-point decimal number */
    readonly decimal: <T extends number = number>(precision: number, scale: number) => TypeValidator<T, `Decimal(${number}, ${number})`, TypeModifiers>;
    /** Bool - boolean value (true/false) */
    readonly bool: <T extends boolean = boolean>() => TypeValidator<T, "Bool", TypeModifiers>;
    /** Date - string in YYYY-MM-DD format (e.g. 2024-01-15) */
    readonly date: <T extends string = string>() => TypeValidator<T, "Date", TypeModifiers>;
    /** Date32 - string in YYYY-MM-DD format (e.g. 2024-01-15, extended date range) */
    readonly date32: <T extends string = string>() => TypeValidator<T, "Date32", TypeModifiers>;
    /** DateTime - string in YYYY-MM-DD HH:MM:SS format (e.g. 2024-01-15 10:30:00) */
    readonly dateTime: <T extends string = string>(timezone?: string) => TypeValidator<T, `DateTime('${string}')`, TypeModifiers> | TypeValidator<T, "DateTime", TypeModifiers>;
    /** DateTime64 - string in YYYY-MM-DD HH:MM:SS[.fraction] format (e.g. 2024-01-15 10:30:00.123) */
    readonly dateTime64: <T extends string = string>(precision?: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9, timezone?: string) => TypeValidator<T, `DateTime64(${number}, '${string}')`, TypeModifiers> | TypeValidator<T, `DateTime64(${number})`, TypeModifiers>;
    /** Array(T) - array of elements of type T */
    readonly array: <TElement extends TypeValidator<unknown, string, TypeModifiers>>(element: TElement) => TypeValidator<TElement["_type"][], `Array(${TElement["_tinybirdType"]})`, TypeModifiers>;
    /** Tuple(T1, T2, ...) - tuple of heterogeneous types */
    readonly tuple: <TElements extends readonly TypeValidator<unknown, string, TypeModifiers>[]>(...elements: TElements) => TypeValidator<{ [K in keyof TElements]: TElements[K]["_type"]; }, `Tuple(${string})`, TypeModifiers>;
    /** Map(K, V) - dictionary/map type */
    readonly map: <TKey extends TypeValidator<string | number, string, TypeModifiers>, TValue extends TypeValidator<unknown, string, TypeModifiers>>(keyType: TKey, valueType: TValue) => TypeValidator<Map<TKey["_type"], TValue["_type"]>, `Map(${TKey["_tinybirdType"]}, ${TValue["_tinybirdType"]})`, TypeModifiers>;
    /** JSON - semi-structured JSON data */
    readonly json: <TShape = unknown>() => TypeValidator<TShape, "JSON", TypeModifiers>;
    /** Enum8 - enumeration stored as Int8 */
    readonly enum8: <TValues extends readonly string[]>(...values: TValues) => TypeValidator<TValues[number], `Enum8(${string})`, TypeModifiers>;
    /** Enum16 - enumeration stored as Int16 */
    readonly enum16: <TValues extends readonly string[]>(...values: TValues) => TypeValidator<TValues[number], `Enum16(${string})`, TypeModifiers>;
    /** IPv4 - IPv4 address */
    readonly ipv4: <T extends string = string>() => TypeValidator<T, "IPv4", TypeModifiers>;
    /** IPv6 - IPv6 address */
    readonly ipv6: <T extends string = string>() => TypeValidator<T, "IPv6", TypeModifiers>;
    /** SimpleAggregateFunction - for materialized views with simple aggregates */
    readonly simpleAggregateFunction: <TFunc extends string, TType extends TypeValidator<unknown, string, TypeModifiers>>(func: TFunc, type: TType) => TypeValidator<TType["_type"], `SimpleAggregateFunction(${TFunc}, ${TType["_tinybirdType"]})`, TypeModifiers>;
    /** AggregateFunction - for materialized views with complex aggregates */
    readonly aggregateFunction: AggregateFunctionValidator;
};
/** Type alias for any type validator */
export type AnyTypeValidator = TypeValidator<unknown, string, TypeModifiers>;
/** Extract the TypeScript type from a type validator */
export type InferType<T extends AnyTypeValidator> = T["_type"];
/** Extract the Tinybird type string from a type validator */
export type TinybirdType<T extends AnyTypeValidator> = T["_tinybirdType"];
/** Helper to check if a value is a type validator */
export declare function isTypeValidator(value: unknown): value is AnyTypeValidator;
/** Get the Tinybird type string from a validator */
export declare function getTinybirdType(validator: AnyTypeValidator): string;
/** Get the modifiers from a validator */
export declare function getModifiers(validator: AnyTypeValidator): TypeModifiers;
export {};
//# sourceMappingURL=types.d.ts.map