@housekit/orm 0.1.1

package/dist/modules/conditional.d.ts

@@ -0,0 +1,110 @@
+import { ClickHouseColumn } from '../core';
+import { SQLExpression } from '../expressions';
+/**
+ * Return alternative value if column is null
+ * @param col - Column to check
+ * @param alt - Alternative value
+ */
+export declare function ifNull(col: ClickHouseColumn | SQLExpression, alt: any): SQLExpression;
+/**
+ * Simple if-then-else conditional
+ * @param condition - Condition to evaluate
+ * @param trueVal - Value if condition is true
+ * @param falseVal - Value if condition is false
+ */
+export declare function sqlIf(condition: SQLExpression, trueVal: any, falseVal: any): SQLExpression;
+/**
+ * Multi-conditional function for ClickHouse case-like logic
+ * Usage: multiIf(cond1, val1, cond2, val2, ..., default)
+ */
+export declare function multiIf(...args: (ClickHouseColumn | SQLExpression | any)[]): SQLExpression;
+/**
+ * Case When builder for analytics queries
+ * Compiles to multiIf for better DX
+ *
+ * @example
+ * caseWhen()
+ *   .when(gt(events.count, 100), sql`'high'`)
+ *   .when(gt(events.count, 50), sql`'medium'`)
+ *   .otherwise(sql`'low'`)
+ */
+export declare function caseWhen(): CaseWhenBuilder;
+declare class CaseWhenBuilder {
+    private conditions;
+    private values;
+    private defaultValue?;
+    /**
+     * Add a condition-value pair
+     * @param condition - The condition to evaluate
+     * @param value - The value to return if condition is true
+     */
+    when(condition: ClickHouseColumn | SQLExpression, value: ClickHouseColumn | SQLExpression | any): this;
+    /**
+     * Set the default value (required)
+     * @param value - The default value to return if all conditions are false
+     */
+    otherwise(value: ClickHouseColumn | SQLExpression | any): SQLExpression;
+    /**
+     * Build the final multiIf expression
+     */
+    private build;
+}
+/**
+ * Return first non-null value
+ * @param args - Values to check
+ */
+export declare function coalesce(...args: (ClickHouseColumn | SQLExpression | any)[]): SQLExpression;
+/**
+ * Return greatest value
+ * @param args - Values to compare
+ */
+export declare function greatest(...args: (ClickHouseColumn | SQLExpression | any)[]): SQLExpression;
+/**
+ * Return smallest value
+ * @param args - Values to compare
+ */
+export declare function least(...args: (ClickHouseColumn | SQLExpression | any)[]): SQLExpression;
+/**
+ * Check if value is null
+ * @param col - Column or expression to check
+ */
+export declare function isNull(col: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Check if value is not null
+ * @param col - Column or expression to check
+ */
+export declare function isNotNull(col: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Convert to null if condition is met
+ * @param condition - Condition to check
+ * @param col - Column to convert to null
+ */
+export declare function nullIf(condition: SQLExpression, col: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Convert to null if value matches
+ * @param col - Column to check
+ * @param value - Value to match
+ */
+export declare function nullIfEqual(col: ClickHouseColumn | SQLExpression, value: any): SQLExpression;
+/**
+ * Logical NOT
+ * @param expr - Expression to negate
+ */
+export declare function not(expr: SQLExpression): SQLExpression;
+/**
+ * Logical AND (multiple conditions)
+ * @param exprs - Conditions to AND together
+ */
+export declare function and(...exprs: (SQLExpression | undefined | null | false)[]): SQLExpression | undefined;
+/**
+ * Logical OR (multiple conditions)
+ * @param exprs - Conditions to OR together
+ */
+export declare function or(...exprs: (SQLExpression | undefined | null | false)[]): SQLExpression | undefined;
+/**
+ * Logical XOR (exclusive or)
+ * @param expr1 - First expression
+ * @param expr2 - Second expression
+ */
+export declare function xor(expr1: SQLExpression, expr2: SQLExpression): SQLExpression;
+export {};

package/dist/modules/conversion.d.ts

@@ -0,0 +1,189 @@
+import { ClickHouseColumn } from '../core';
+import { SQLExpression } from '../expressions';
+type Expr<T = any> = ClickHouseColumn<T, any, any> | SQLExpression<T>;
+/**
+ * Convert to string
+ * @param col - Column or expression to convert
+ */
+export declare function toString(col: Expr): SQLExpression<string>;
+export declare function toInt32(col: Expr): SQLExpression<number>;
+/**
+ * Convert to integer (alias for toInt32)
+ */
+export declare const toInteger: typeof toInt32;
+/**
+ * Convert to 64-bit integer
+ * @param col - Column or expression to convert
+ */
+export declare function toInt64(col: Expr): SQLExpression<number>;
+/**
+ * Convert to 32-bit unsigned integer
+ * @param col - Column or expression to convert
+ */
+export declare function toUInt32(col: Expr): SQLExpression<number>;
+/**
+ * Convert to 64-bit unsigned integer
+ * @param col - Column or expression to convert
+ */
+export declare function toUInt64(col: Expr): SQLExpression<number>;
+/**
+ * Convert to 32-bit float
+ * @param col - Column or expression to convert
+ */
+export declare function toFloat32(col: Expr): SQLExpression<number>;
+/**
+ * Convert to 64-bit float
+ * @param col - Column or expression to convert
+ */
+export declare function toFloat64(col: Expr): SQLExpression<number>;
+export declare function toBool(col: Expr): SQLExpression<boolean>;
+/**
+ * Convert to boolean (alias for toBool)
+ */
+export declare const toBoolean: typeof toBool;
+/**
+ * Convert to UUID
+ * @param col - Column or expression to convert
+ */
+export declare function toUUID(col: Expr): SQLExpression<string>;
+/**
+ * Convert to Date type (without time)
+ * @param col - Column or expression to convert
+ */
+export declare function toDate(col: Expr): SQLExpression<string>;
+export declare function toDateTime(col: Expr): SQLExpression<string>;
+/**
+ * Convert to timestamp (alias for toDateTime)
+ */
+export declare const toTimestamp: typeof toDateTime;
+/**
+ * Convert to DateTime64 type
+ * @param col - Column or expression to convert
+ * @param precision - DateTime precision (default: 3)
+ */
+export declare function toDateTime64(col: Expr, precision?: number): SQLExpression<string>;
+/**
+ * Convert to lowercase
+ * @param col - Column or expression to convert
+ */
+export declare function toLowercase(col: Expr): SQLExpression<string>;
+/**
+ * Convert to uppercase
+ * @param col - Column or expression to convert
+ */
+export declare function toUppercase(col: Expr): SQLExpression<string>;
+/**
+ * Convert to title case (first letter uppercase, rest lowercase)
+ * @param col - Column or expression to convert
+ */
+export declare function toTitleCase(col: Expr): SQLExpression<string>;
+/**
+ * Trim whitespace from string
+ * @param col - Column or expression to trim
+ */
+export declare function convertTrim(col: Expr): SQLExpression<string>;
+/**
+ * Trim left whitespace
+ * @param col - Column or expression to trim
+ */
+export declare function convertTrimLeft(col: Expr): SQLExpression<string>;
+/**
+ * Trim right whitespace
+ * @param col - Column or expression to trim
+ */
+export declare function convertTrimRight(col: Expr): SQLExpression<string>;
+/**
+ * Left pad string
+ * @param col - Column or expression to pad
+ * @param length - Target length
+ * @param fill - Fill character (default: space)
+ */
+export declare function leftPad(col: Expr, length: number, fill?: string): SQLExpression<string>;
+/**
+ * Right pad string
+ * @param col - Column or expression to pad
+ * @param length - Target length
+ * @param fill - Fill character (default: space)
+ */
+export declare function rightPad(col: Expr, length: number, fill?: string): SQLExpression<string>;
+/**
+ * Convert to hexadecimal string
+ * @param col - Column or expression to convert
+ */
+export declare function toHex(col: Expr): SQLExpression<string>;
+/**
+ * Convert from hexadecimal string
+ * @param col - Column or expression to convert
+ */
+export declare function fromHex(col: Expr): SQLExpression<string>;
+/**
+ * Convert to base64 string
+ * @param col - Column or expression to convert
+ */
+export declare function toBase64(col: Expr): SQLExpression<string>;
+/**
+ * Convert from base64 string
+ * @param col - Column or expression to convert
+ */
+export declare function fromBase64(col: Expr): SQLExpression<string>;
+/**
+ * Convert to binary string
+ * @param col - Column or expression to convert
+ */
+export declare function toBin(col: Expr): SQLExpression<string>;
+/**
+ * Convert from binary string
+ * @param col - Column or expression to convert
+ */
+export declare function fromBin(col: Expr): SQLExpression<string>;
+/**
+ * URL encode string
+ * @param col - Column or expression to encode
+ */
+export declare function urlEncode(col: Expr): SQLExpression<string>;
+/**
+ * URL decode string
+ * @param col - Column or expression to decode
+ */
+export declare function urlDecode(col: Expr): SQLExpression<string>;
+/**
+ * HTML escape string
+ * @param col - Column or expression to escape
+ */
+export declare function htmlEscape(col: Expr): SQLExpression<string>;
+/**
+ * HTML unescape string
+ * @param col - Column or expression to unescape
+ */
+export declare function htmlUnescape(col: Expr): SQLExpression<string>;
+/**
+ * Format number with specified decimal places
+ * @param col - Column or expression to format
+ * @param precision - Number of decimal places
+ */
+export declare function formatDecimal(col: Expr, precision: number): SQLExpression<string>;
+/**
+ * Format number in human-readable format
+ * @param col - Column or expression to format
+ * @param precision - Number of decimal places
+ */
+export declare function formatReadableDecimal(col: Expr, precision: number): SQLExpression<string>;
+/**
+ * Format number with specified number of digits
+ * @param col - Column or expression to format
+ * @param digits - Total number of digits
+ */
+export declare function formatNumber(col: Expr, digits: number): SQLExpression<string>;
+/**
+ * Format bytes in human-readable format
+ * @param col - Column or expression to format
+ * @param precision - Number of decimal places
+ */
+export declare function formatBytes(col: Expr, precision?: number): SQLExpression<string>;
+/**
+ * Format percentage
+ * @param col - Column or expression to format
+ * @param precision - Number of decimal places
+ */
+export declare function formatPercentage(col: Expr, precision?: number): SQLExpression<string>;
+export {};

package/dist/modules/geo.d.ts

@@ -0,0 +1,202 @@
+import { ClickHouseColumn } from '../core';
+import { SQLExpression } from '../expressions';
+/**
+ * Calculate great circle distance between two points using Haversine formula
+ * @param point1 - First point (longitude, latitude)
+ * @param point2 - Second point (longitude, latitude)
+ * @param unit - Distance unit ('km' or 'mi')
+ */
+export declare function geoDistance(point1: ClickHouseColumn | SQLExpression, point2: ClickHouseColumn | SQLExpression, unit?: 'km' | 'mi'): SQLExpression;
+/**
+ * Calculate great circle distance between two points (ClickHouse native)
+ * @param point1 - First point (longitude, latitude)
+ * @param point2 - Second point (longitude, latitude)
+ */
+export declare function greatCircleDistance(point1: ClickHouseColumn | SQLExpression, point2: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Calculate distance between two points using Euclidean distance
+ * @param point1 - First point (x, y)
+ * @param point2 - Second point (x, y)
+ */
+export declare function euclideanDistance(point1: ClickHouseColumn | SQLExpression, point2: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Calculate Manhattan distance between two points
+ * @param point1 - First point (x, y)
+ * @param point2 - Second point (x, y)
+ */
+export declare function manhattanDistance(point1: ClickHouseColumn | SQLExpression, point2: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Create a point from longitude and latitude
+ * @param longitude - Longitude coordinate
+ * @param latitude - Latitude coordinate
+ */
+export declare function geoPoint(longitude: ClickHouseColumn | SQLExpression | number, latitude: ClickHouseColumn | SQLExpression | number): SQLExpression;
+/**
+ * Extract longitude from point
+ * @param point - Point column or expression
+ */
+export declare function geoLongitude(point: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Extract latitude from point
+ * @param point - Point column or expression
+ */
+export declare function geoLatitude(point: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Extract x coordinate from point
+ * @param point - Point column or expression
+ */
+export declare function geoX(point: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Extract y coordinate from point
+ * @param point - Point column or expression
+ */
+export declare function geoY(point: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Check if point is within polygon
+ * @param point - Point to check
+ * @param polygon - Polygon to check against
+ */
+export declare function pointInPolygon(point: ClickHouseColumn | SQLExpression, polygon: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Check if polygon contains another polygon
+ * @param polygon1 - First polygon
+ * @param polygon2 - Second polygon
+ */
+export declare function polygonContains(polygon1: ClickHouseColumn | SQLExpression, polygon2: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Check if two polygons intersect
+ * @param polygon1 - First polygon
+ * @param polygon2 - Second polygon
+ */
+export declare function polygonsIntersect(polygon1: ClickHouseColumn | SQLExpression, polygon2: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Create a bounding box from two points (bottom-left and top-right)
+ * @param point1 - Bottom-left point
+ * @param point2 - Top-right point
+ */
+export declare function boundingBox(point1: ClickHouseColumn | SQLExpression, point2: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Check if point is within bounding box
+ * @param point - Point to check
+ * @param bbox - Bounding box
+ */
+export declare function pointInBoundingBox(point: ClickHouseColumn | SQLExpression, bbox: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Get the minimum point of a bounding box
+ * @param bbox - Bounding box
+ */
+export declare function bboxMin(bbox: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Get the maximum point of a bounding box
+ * @param bbox - Bounding box
+ */
+export declare function bboxMax(bbox: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Calculate area of a polygon
+ * @param polygon - Polygon column or expression
+ */
+export declare function polygonArea(polygon: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Calculate perimeter of a polygon
+ * @param polygon - Polygon column or expression
+ */
+export declare function polygonPerimeter(polygon: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Get the centroid of a polygon
+ * @param polygon - Polygon column or expression
+ */
+export declare function polygonCentroid(polygon: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Simplify a polygon (reduce number of points)
+ * @param polygon - Polygon to simplify
+ * @param epsilon - Simplification tolerance
+ */
+export declare function polygonSimplify(polygon: ClickHouseColumn | SQLExpression, epsilon: number): SQLExpression;
+/**
+ * Buffer a polygon (expand/contract by distance)
+ * @param polygon - Polygon to buffer
+ * @param distance - Buffer distance
+ */
+export declare function polygonBuffer(polygon: ClickHouseColumn | SQLExpression, distance: number): SQLExpression;
+/**
+ * Encode a point as geohash
+ * @param point - Point to encode
+ * @param precision - Geohash precision (1-12)
+ */
+export declare function geoHashEncode(point: ClickHouseColumn | SQLExpression, precision?: number): SQLExpression;
+/**
+ * Decode a geohash to a point
+ * @param geohash - Geohash string to decode
+ */
+export declare function geoHashDecode(geohash: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Get neighbors of a geohash
+ * @param geohash - Geohash string
+ */
+export declare function geoHashNeighbors(geohash: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Check if two geohashes are neighbors
+ * @param geohash1 - First geohash
+ * @param geohash2 - Second geohash
+ */
+export declare function geoHashAreNeighbors(geohash1: ClickHouseColumn | SQLExpression, geohash2: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Find points within radius of a center point
+ * @param center - Center point
+ * @param radius - Search radius
+ * @param points - Points to search
+ */
+export declare function pointsWithinRadius(center: ClickHouseColumn | SQLExpression, radius: number, points: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Find nearest neighbors to a point
+ * @param point - Reference point
+ * @param points - Array of points to search
+ * @param k - Number of neighbors to find
+ */
+export declare function nearestNeighbors(point: ClickHouseColumn | SQLExpression, points: ClickHouseColumn | SQLExpression, k: number): SQLExpression;
+/**
+ * Cluster points using k-means
+ * @param points - Array of points to cluster
+ * @param k - Number of clusters
+ */
+export declare function kMeansClustering(points: ClickHouseColumn | SQLExpression, k: number): SQLExpression;
+/**
+ * Convert degrees to radians
+ * @param degrees - Degrees value
+ */
+export declare function degreesToRadians(degrees: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Convert radians to degrees
+ * @param radians - Radians value
+ */
+export declare function radiansToDegrees(radians: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Convert Web Mercator to WGS84
+ * @param point - Point in Web Mercator coordinates
+ */
+export declare function webMercatorToWGS84(point: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Convert WGS84 to Web Mercator
+ * @param point - Point in WGS84 coordinates
+ */
+export declare function wGS84ToWebMercator(point: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Check if a geometry is valid
+ * @param geometry - Geometry to validate
+ */
+export declare function isValidGeometry(geometry: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Get the geometry type
+ * @param geometry - Geometry column or expression
+ */
+export declare function geometryType(geometry: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Get the number of points in a geometry
+ * @param geometry - Geometry column or expression
+ */
+export declare function geometryNumPoints(geometry: ClickHouseColumn | SQLExpression): SQLExpression;
+/**
+ * Get the number of interior rings in a polygon
+ * @param polygon - Polygon column or expression
+ */
+export declare function polygonNumInteriorRings(polygon: ClickHouseColumn | SQLExpression): SQLExpression;

package/dist/modules/hash.d.ts

@@ -0,0 +1,7 @@
+import { ClickHouseColumn } from '../core';
+import { type SQLExpression } from '../expressions';
+type Expr<T = any> = ClickHouseColumn<T, any, any> | SQLExpression<T>;
+export declare const cityHash64: (col: Expr) => SQLExpression<number>;
+export declare const md5: (col: Expr) => SQLExpression<string>;
+export declare const sha256: (col: Expr) => SQLExpression<string>;
+export {};

package/dist/modules/index.d.ts

@@ -0,0 +1,12 @@
+export * from './array';
+export * from './json';
+export * from './geo';
+export * from './time';
+export * from './types';
+export * from './aggregates';
+export * from './conditional';
+export * from './conversion';
+export * from './string';
+export * from './math';
+export * from './hash';
+export * from './window';

package/dist/modules/json.d.ts

@@ -0,0 +1,130 @@
+import { ClickHouseColumn } from '../core';
+import { SQLExpression } from '../expressions';
+type Expr<T = any> = ClickHouseColumn<T, any, any> | SQLExpression<T>;
+/**
+ * Extract string value from JSON
+ * @param col - JSON column or expression
+ * @param path - JSONPath expression (e.g., 'user.name', '$.items[0].price')
+ */
+export declare function jsonExtractString(col: Expr, path: string): SQLExpression<string>;
+/**
+ * Extract integer value from JSON
+ * @param col - JSON column or expression
+ * @param path - JSONPath expression (e.g., 'user.age', '$.count')
+ */
+export declare function jsonExtractInt(col: Expr, path: string): SQLExpression<number>;
+/**
+ * Extract float value from JSON
+ * @param col - JSON column or expression
+ * @param path - JSONPath expression (e.g., 'user.score', '$.price')
+ */
+export declare function jsonExtractFloat(col: Expr, path: string): SQLExpression<number>;
+/**
+ * Extract boolean value from JSON
+ * @param col - JSON column or expression
+ * @param path - JSONPath expression (e.g., 'user.active', '$.enabled')
+ */
+export declare function jsonExtractBool(col: Expr, path: string): SQLExpression<boolean>;
+/**
+ * Generic JSON extraction with type specification
+ * @param col - JSON column or expression
+ * @param path - JSONPath expression
+ * @param type - ClickHouse type literal (e.g., 'String', 'Int', 'Float', 'Bool', 'Array(String)')
+ */
+export declare function jsonExtract(col: Expr, path: string, type: string): SQLExpression<any>;
+/**
+ * Extract raw JSON value as string
+ * Useful when you want to preserve the JSON structure
+ * @param col - JSON column or expression
+ * @param path - JSONPath expression
+ */
+export declare function jsonExtractRaw(col: Expr, path: string): SQLExpression<string>;
+/**
+ * Check if JSON has a specific path
+ * @param col - JSON column or expression
+ * @param path - JSONPath expression
+ */
+export declare function jsonHas(col: Expr, path: string): SQLExpression<boolean>;
+/**
+ * Extract all keys from JSON object at specified path
+ * Useful for introspecting JSON blobs
+ * @param col - JSON column or expression
+ * @param path - JSONPath expression (optional, defaults to root)
+ */
+export declare function jsonExtractKeys(col: Expr, path?: string): SQLExpression<any>;
+/**
+ * Extract all values from JSON object at specified path
+ * Useful for introspecting JSON blobs
+ * @param col - JSON column or expression
+ * @param path - JSONPath expression (optional, defaults to root)
+ */
+export declare function jsonExtractValues(col: Expr, path?: string): SQLExpression<any>;
+/**
+ * Extract keys and values as tuples from JSON object
+ * Useful for introspecting JSON blobs
+ * @param col - JSON column or expression
+ * @param path - JSONPath expression (optional, defaults to root)
+ */
+export declare function jsonExtractKeysAndValues(col: Expr, path?: string): SQLExpression<any>;
+/**
+ * Get the length of JSON array or object
+ * @param col - JSON column or expression
+ * @param path - JSONPath expression (optional, defaults to root)
+ */
+export declare function jsonLength(col: Expr, path?: string): SQLExpression<number>;
+/**
+ * Get the type of JSON value at specified path
+ * Returns: 'null', 'bool', 'number', 'string', 'array', 'object'
+ * @param col - JSON column or expression
+ * @param path - JSONPath expression (optional, defaults to root)
+ */
+export declare function jsonType(col: Expr, path?: string): SQLExpression<string>;
+/**
+ * Insert value into JSON at specified path
+ * @param col - JSON column or expression
+ * @param path - JSONPath expression
+ * @param value - Value to insert
+ */
+export declare function jsonInsert(col: Expr, path: string, value: any): SQLExpression<any>;
+/**
+ * Replace value in JSON at specified path
+ * @param col - JSON column or expression
+ * @param path - JSONPath expression
+ * @param value - Value to replace with
+ */
+export declare function jsonReplace(col: Expr, path: string, value: any): SQLExpression<any>;
+/**
+ * Remove value from JSON at specified path
+ * @param col - JSON column or expression
+ * @param path - JSONPath expression
+ */
+export declare function jsonRemove(col: Expr, path: string): SQLExpression<any>;
+/**
+ * Parse string as JSON
+ * @param col - String column or expression containing JSON
+ */
+export declare function parseJSON(col: Expr): SQLExpression<any>;
+/**
+ * Parse string as JSONBestEffort (more tolerant)
+ * @param col - String column or expression containing JSON
+ */
+export declare function parseJSONBestEffort(col: Expr): SQLExpression<any>;
+/**
+ * Convert JSON to string
+ * @param col - JSON column or expression
+ */
+export declare function jsonStringify(col: Expr): SQLExpression<string>;
+/**
+ * Extract JSON array as ClickHouse array
+ * @param col - JSON column or expression
+ * @param path - JSONPath expression
+ * @param type - ClickHouse type for array elements (e.g., 'String', 'Int')
+ */
+export declare function jsonArrayExtract(col: Expr, path: string, type: string): SQLExpression<any>;
+/**
+ * Get length of JSON array
+ * @param col - JSON column or expression
+ * @param path - JSONPath expression
+ */
+export declare function jsonArrayLength(col: Expr, path: string): SQLExpression<number>;
+export {};

package/dist/modules/math.d.ts

@@ -0,0 +1,28 @@
+import { ClickHouseColumn } from '../core';
+import { type SQLExpression } from '../expressions';
+export declare const abs: (col: ClickHouseColumn | SQLExpression) => SQLExpression<any>;
+export declare const round: (col: ClickHouseColumn | SQLExpression, precision?: number) => SQLExpression<any>;
+export declare const floor: (col: ClickHouseColumn | SQLExpression) => SQLExpression<any>;
+export declare const ceil: (col: ClickHouseColumn | SQLExpression) => SQLExpression<any>;
+export declare const sqrt: (col: ClickHouseColumn | SQLExpression) => SQLExpression<any>;
+export declare const power: (col: ClickHouseColumn | SQLExpression, exponent: number) => SQLExpression<any>;
+/**
+ * ⚠️ Advanced: Low-value arithmetic wrapper.
+ * Consider using `sql`${a} + ${b}`` directly.
+ */
+export declare const plus: (a: ClickHouseColumn | SQLExpression | number, b: ClickHouseColumn | SQLExpression | number) => SQLExpression<any>;
+/**
+ * ⚠️ Advanced: Low-value arithmetic wrapper.
+ * Consider using `sql`${a} - ${b}`` directly.
+ */
+export declare const minus: (a: ClickHouseColumn | SQLExpression | number, b: ClickHouseColumn | SQLExpression | number) => SQLExpression<any>;
+/**
+ * ⚠️ Advanced: Low-value arithmetic wrapper.
+ * Consider using `sql`${a} * ${b}`` directly.
+ */
+export declare const mult: (a: ClickHouseColumn | SQLExpression | number, b: ClickHouseColumn | SQLExpression | number) => SQLExpression<any>;
+/**
+ * ⚠️ Advanced: Low-value arithmetic wrapper.
+ * Consider using `sql`${a} / ${b}`` directly.
+ */
+export declare const div: (a: ClickHouseColumn | SQLExpression | number, b: ClickHouseColumn | SQLExpression | number) => SQLExpression<any>;