@hypequery/clickhouse 1.6.0 → 1.6.1

package/dist/dataset/sql-tag.d.ts

@@ -0,0 +1,51 @@
+/**
+ * SQL Tagged Template Literal
+ *
+ * Marks a string as a SQL expression rather than a column reference.
+ * Used to distinguish between:
+ * - Simple column: 'region' (string)
+ * - SQL expression: sql`DATE(created_at)` (SQLExpression)
+ *
+ * @example
+ * ```typescript
+ * dimensions: {
+ *   region: 'region',  // Simple column reference
+ *   date: sql`DATE(created_at)`,  // SQL expression
+ *   hour: sql`toHour(created_at)`  // SQL expression
+ * }
+ * ```
+ */
+/**
+ * Represents a SQL expression with metadata
+ */
+export interface SQLExpression {
+    readonly __brand: 'SQLExpression';
+    readonly sql: string;
+    readonly raw: boolean;
+}
+/**
+ * Tagged template literal for SQL expressions
+ *
+ * @param strings - Template string array
+ * @param values - Interpolated values
+ * @returns SQLExpression object
+ */
+export declare function sql(strings: TemplateStringsArray, ...values: unknown[]): SQLExpression;
+/**
+ * Type guard to check if a value is a SQLExpression
+ *
+ * @param value - Value to check
+ * @returns True if value is a SQLExpression
+ */
+export declare function isSQLExpression(value: unknown): value is SQLExpression;
+/**
+ * Convert a value to a SQL string
+ * - If it's a SQLExpression, return the sql property
+ * - If it's a string, return it as-is (assumed to be a column name)
+ * - Otherwise, throw an error
+ *
+ * @param value - Value to convert
+ * @returns SQL string
+ */
+export declare function toSQLString(value: string | SQLExpression): string;
+//# sourceMappingURL=sql-tag.d.ts.map

package/dist/dataset/sql-tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-tag.d.ts","sourceRoot":"","sources":["../../src/dataset/sql-tag.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,GAAG,CACjB,OAAO,EAAE,oBAAoB,EAC7B,GAAG,MAAM,EAAE,OAAO,EAAE,GACnB,aAAa,CA+Bf;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAOtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,CAYjE"}

package/dist/dataset/sql-tag.js

@@ -0,0 +1,86 @@
+/**
+ * SQL Tagged Template Literal
+ *
+ * Marks a string as a SQL expression rather than a column reference.
+ * Used to distinguish between:
+ * - Simple column: 'region' (string)
+ * - SQL expression: sql`DATE(created_at)` (SQLExpression)
+ *
+ * @example
+ * ```typescript
+ * dimensions: {
+ *   region: 'region',  // Simple column reference
+ *   date: sql`DATE(created_at)`,  // SQL expression
+ *   hour: sql`toHour(created_at)`  // SQL expression
+ * }
+ * ```
+ */
+/**
+ * Tagged template literal for SQL expressions
+ *
+ * @param strings - Template string array
+ * @param values - Interpolated values
+ * @returns SQLExpression object
+ */
+export function sql(strings, ...values) {
+    // Build the SQL string by interleaving strings and values
+    let result = strings[0];
+    for (let i = 0; i < values.length; i++) {
+        const value = values[i];
+        // Handle nested SQL expressions
+        if (isSQLExpression(value)) {
+            result += value.sql;
+        }
+        else if (typeof value === 'string') {
+            // For security, we should escape string values
+            // In production, this would use proper escaping
+            result += value;
+        }
+        else if (typeof value === 'number') {
+            result += String(value);
+        }
+        else if (value === null || value === undefined) {
+            result += 'NULL';
+        }
+        else {
+            // For other types, convert to string
+            result += String(value);
+        }
+        result += strings[i + 1];
+    }
+    return {
+        __brand: 'SQLExpression',
+        sql: result,
+        raw: true,
+    };
+}
+/**
+ * Type guard to check if a value is a SQLExpression
+ *
+ * @param value - Value to check
+ * @returns True if value is a SQLExpression
+ */
+export function isSQLExpression(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        '__brand' in value &&
+        value.__brand === 'SQLExpression');
+}
+/**
+ * Convert a value to a SQL string
+ * - If it's a SQLExpression, return the sql property
+ * - If it's a string, return it as-is (assumed to be a column name)
+ * - Otherwise, throw an error
+ *
+ * @param value - Value to convert
+ * @returns SQL string
+ */
+export function toSQLString(value) {
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (isSQLExpression(value)) {
+        return value.sql;
+    }
+    throw new Error(`Expected string or SQLExpression, got ${typeof value}`);
+}

package/dist/dataset/types.d.ts

@@ -0,0 +1,300 @@
+/**
+ * Dataset API Type Definitions
+ *
+ * Comprehensive type system for the dataset API, including:
+ * - Dataset definitions
+ * - Dimension and metric types
+ * - Filter operators and types
+ * - Query execution types
+ * - Type inference utilities
+ */
+import type { SQLExpression } from './sql-tag.js';
+/**
+ * Dimension value types
+ */
+export type DimensionType = 'string' | 'number' | 'date' | 'boolean';
+/**
+ * Simple dimension definition (column name as string)
+ */
+export type SimpleDimension = string;
+/**
+ * Complex dimension definition with metadata
+ */
+export interface DimensionDefinition {
+    /** SQL expression or column name */
+    sql: string | SQLExpression;
+    /** Data type of the dimension */
+    type: DimensionType;
+    /** Human-readable description (for AI agents) */
+    description: string;
+    /** Example values (for AI context) */
+    examples?: string[];
+    /** Whether this dimension requires a join */
+    join?: string;
+}
+/**
+ * Dimension definition (simple or complex)
+ */
+export type Dimension = SimpleDimension | SQLExpression | DimensionDefinition;
+/**
+ * Map of dimension names to definitions
+ */
+export type DimensionsMap = Record<string, Dimension>;
+/**
+ * Supported metric aggregation types
+ */
+export type MetricAggregationType = 'count' | 'sum' | 'avg' | 'min' | 'max' | 'countDistinct' | 'custom';
+/**
+ * Metric format hints
+ */
+export type MetricFormat = 'currency' | 'percent' | 'number' | 'bytes';
+/**
+ * Metric definition
+ */
+export interface MetricDefinition {
+    /** Aggregation type */
+    type: MetricAggregationType;
+    /** SQL expression or column name */
+    sql: string | SQLExpression;
+    /** Human-readable description (for AI agents) */
+    description: string;
+    /** Format hint for display */
+    format?: MetricFormat;
+    /** Whether this metric requires a join */
+    join?: string;
+    /** Allow fan-out (for oneToMany joins) - advanced use only */
+    allowFanout?: boolean;
+}
+/**
+ * Map of metric names to definitions
+ */
+export type MetricsMap = Record<string, MetricDefinition>;
+/**
+ * Multi-tenancy configuration
+ */
+export interface TenantConfig {
+    /** Column name for tenant isolation */
+    column: string;
+    /** Whether tenant filtering is required */
+    required?: boolean;
+}
+/**
+ * Complexity limits to prevent expensive queries
+ */
+export interface DatasetLimits {
+    /** Maximum number of dimensions in a query */
+    maxDimensions?: number;
+    /** Maximum number of metrics in a query */
+    maxMetrics?: number;
+    /** Maximum number of filters in a query */
+    maxFilters?: number;
+    /** Maximum result set size */
+    maxResultSize?: number;
+}
+/**
+ * Complete dataset definition
+ */
+export interface DatasetDefinition<TDimensions extends DimensionsMap = DimensionsMap, TMetrics extends MetricsMap = MetricsMap> {
+    /** Unique dataset name */
+    name: string;
+    /** Human-readable description (for AI agents) */
+    description: string;
+    /** Source table name */
+    table: string;
+    /** Schema type (for type inference) */
+    schema?: unknown;
+    /** Dimension definitions */
+    dimensions: TDimensions;
+    /** Metric definitions */
+    metrics: TMetrics;
+    /** Multi-tenancy configuration */
+    tenant?: TenantConfig;
+    /** Complexity guardrails */
+    limits?: DatasetLimits;
+}
+/**
+ * Map of dataset names to definitions
+ */
+export type DatasetsMap = Record<string, DatasetDefinition>;
+/**
+ * Filter operator types
+ */
+export type FilterOperator = 'eq' | 'ne' | 'gt' | 'lt' | 'gte' | 'lte' | 'in' | 'notIn' | 'between' | 'like' | 'notLike' | 'isNull' | 'isNotNull' | 'inDateRange';
+/**
+ * Date range helper values
+ */
+export type DateRangeValue = 'today' | 'yesterday' | 'last_7_days' | 'last_30_days' | 'this_week' | 'last_week' | 'this_month' | 'last_month' | 'this_quarter' | 'last_quarter' | 'this_year' | 'last_year' | {
+    start: string;
+    end: string;
+};
+/**
+ * Filter value type based on operator
+ */
+export type FilterValue<TOperator extends FilterOperator = FilterOperator> = TOperator extends 'in' | 'notIn' ? unknown[] : TOperator extends 'between' ? [unknown, unknown] : TOperator extends 'isNull' | 'isNotNull' ? never : TOperator extends 'inDateRange' ? DateRangeValue : unknown;
+/**
+ * Filter definition
+ */
+export interface FilterDefinition<TOperator extends FilterOperator = FilterOperator> {
+    /** Dimension to filter on */
+    dimension: string;
+    /** Filter operator */
+    operator: TOperator;
+    /** Filter value (type depends on operator) */
+    value?: FilterValue<TOperator>;
+}
+/**
+ * Array of filters
+ */
+export type Filters = FilterDefinition[];
+/**
+ * Sort direction
+ */
+export type SortDirection = 'asc' | 'desc';
+/**
+ * Order by dimension
+ */
+export interface OrderByDimension {
+    dimension: string;
+    direction: SortDirection;
+}
+/**
+ * Order by metric
+ */
+export interface OrderByMetric {
+    metric: string;
+    direction: SortDirection;
+}
+/**
+ * Order definition (dimension or metric)
+ */
+export type OrderBy = OrderByDimension | OrderByMetric;
+/**
+ * Cache options for query results
+ */
+export interface CacheOptions {
+    /** Time-to-live in seconds */
+    ttl?: number;
+    /** Custom cache key */
+    key?: string;
+}
+/**
+ * Dataset query definition
+ */
+export interface DatasetQuery<TDataset extends DatasetDefinition = DatasetDefinition> {
+    /** Dimensions to include in the query */
+    dimensions: Array<keyof TDataset['dimensions'] & string>;
+    /** Metrics to include in the query */
+    metrics: Array<keyof TDataset['metrics'] & string>;
+    /** Filters to apply */
+    filters?: Filters;
+    /** Ordering */
+    order?: OrderBy[];
+    /** Result limit */
+    limit?: number;
+    /** Result offset (for pagination) */
+    offset?: number;
+    /** Cache options */
+    cache?: CacheOptions;
+}
+/**
+ * Query execution context (for multi-tenancy)
+ */
+export interface QueryContext {
+    /** Tenant ID for multi-tenant isolation */
+    tenantId?: string;
+}
+/**
+ * Query result metadata
+ */
+export interface QueryResultMetadata {
+    /** Dimensions included in the result */
+    dimensions: string[];
+    /** Metrics included in the result */
+    metrics: string[];
+    /** Number of rows returned */
+    rowCount: number;
+    /** Whether the result was served from cache */
+    cached: boolean;
+    /** Execution time in milliseconds */
+    executionTime?: number;
+    /** Generated SQL query */
+    sql?: string;
+}
+/**
+ * Query result
+ */
+export interface QueryResult<TRow = Record<string, unknown>> {
+    /** Result data */
+    data: TRow[];
+    /** Result metadata */
+    metadata: QueryResultMetadata;
+}
+/**
+ * Infer the TypeScript type from a dimension definition
+ */
+export type InferDimensionType<T> = T extends string ? string : T extends SQLExpression ? unknown : T extends DimensionDefinition ? T['type'] extends 'string' ? string : T['type'] extends 'number' ? number : T['type'] extends 'date' ? Date : T['type'] extends 'boolean' ? boolean : unknown : unknown;
+/**
+ * Infer the TypeScript type from a metric definition
+ * All metrics return numbers
+ */
+export type InferMetricType<T> = T extends MetricDefinition ? number : number;
+/**
+ * Infer the row type from a dataset query
+ */
+export type InferQueryRowType<TDataset extends DatasetDefinition, TDimensions extends Array<keyof TDataset['dimensions'] & string>, TMetrics extends Array<keyof TDataset['metrics'] & string>> = {
+    [K in TDimensions[number]]: InferDimensionType<TDataset['dimensions'][K]>;
+} & {
+    [K in TMetrics[number]]: InferMetricType<TDataset['metrics'][K]>;
+};
+/**
+ * Infer the complete result type from a dataset query
+ */
+export type InferQueryResult<TDataset extends DatasetDefinition, TQuery extends DatasetQuery<TDataset>> = QueryResult<InferQueryRowType<TDataset, TQuery['dimensions'], TQuery['metrics']>>;
+/**
+ * Introspected dimension schema (for AI agents)
+ */
+export interface IntrospectedDimension {
+    /** Dimension type */
+    type: DimensionType;
+    /** Human-readable description */
+    description?: string;
+    /** Example values */
+    examples?: string[];
+    /** SQL expression */
+    sql: string;
+}
+/**
+ * Introspected metric schema (for AI agents)
+ */
+export interface IntrospectedMetric {
+    /** Always 'number' for metrics */
+    type: 'number';
+    /** Aggregation type */
+    aggregationType: MetricAggregationType;
+    /** Human-readable description */
+    description: string;
+    /** Format hint */
+    format?: MetricFormat;
+    /** SQL expression */
+    sql: string;
+}
+/**
+ * Introspected dataset schema (for AI agents)
+ */
+export interface IntrospectedDataset {
+    /** Dataset name */
+    name: string;
+    /** Dataset description */
+    description: string;
+    /** Source table */
+    table: string;
+    /** Introspected dimensions */
+    dimensions: Record<string, IntrospectedDimension>;
+    /** Introspected metrics */
+    metrics: Record<string, IntrospectedMetric>;
+    /** Whether multi-tenancy is required */
+    tenantRequired?: boolean;
+    /** Complexity limits */
+    limits?: DatasetLimits;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/dataset/types.js

@@ -0,0 +1,11 @@
+/**
+ * Dataset API Type Definitions
+ *
+ * Comprehensive type system for the dataset API, including:
+ * - Dataset definitions
+ * - Dimension and metric types
+ * - Filter operators and types
+ * - Query execution types
+ * - Type inference utilities
+ */
+export {};

package/dist/index.d.ts

@@ -1,6 +1,10 @@
 export { createQueryBuilder, QueryBuilder } from './core/query-builder.js';
 export { ClickHouseConnection } from './core/connection.js';
 export { JoinRelationships } from './core/join-relationships.js';
+export { createClickHouseAdapter, ClickHouseAdapter } from './core/adapters/clickhouse-adapter.js';
+export { ClickHouseDialect } from './core/dialects/clickhouse-dialect.js';
+export type { DatabaseAdapter } from './core/adapters/database-adapter.js';
+export type { SqlDialect } from './core/dialects/sql-dialect.js';
 export type { ClickHouseConfig, ClickHouseClientConfig, CreateQueryBuilderConfig, ExecuteOptions } from './core/query-builder.js';
 export { isClientConfig } from './core/query-builder.js';
 export type { CacheOptions, CacheConfig, CacheProvider, CacheEntry, CacheStatus } from './core/cache/types.js';
@@ -17,4 +21,21 @@ export { logger } from './core/utils/logger.js';
 export { raw, rawAs, selectExpr, toDateTime, formatDateTime, toStartOfInterval, datePart } from './core/utils/sql-expressions.js';
 export type { SqlExpression, FormatDateTimeOptions, AliasedExpression } from './core/utils/sql-expressions.js';
 export type { PredicateExpression, PredicateLiteral, PredicateBuilder, PredicateArg } from './core/utils/predicate-builder.js';
+export { sql, isSQLExpression, toSQLString } from './dataset/sql-tag.js';
+export type { SQLExpression } from './dataset/sql-tag.js';
+export { dimension, metric } from './dataset/helpers.js';
+export type { DimensionOptions, MetricOptions } from './dataset/helpers.js';
+export type { DimensionType, SimpleDimension, DimensionDefinition, Dimension, DimensionsMap, MetricAggregationType, MetricFormat, MetricDefinition, MetricsMap, DatasetDefinition, DatasetsMap, TenantConfig, DatasetLimits, DateRangeValue, FilterValue, FilterDefinition, Filters, SortDirection, OrderByDimension, OrderByMetric, OrderBy, DatasetQuery, QueryContext, QueryResultMetadata, QueryResult, InferDimensionType, InferMetricType, InferQueryRowType, InferQueryResult, IntrospectedDimension, IntrospectedMetric, IntrospectedDataset, } from './dataset/types.js';
+export { validateDatasetDefinition, validateDatasets, normalizeDimension, normalizeDimensions, inferDimensionType, getDimensionSQL, getMetricSQL, getDataset, listDatasets, hasDataset, getDimensionNames, getMetricNames, hasDimension, hasMetric, getDimension, getMetric, } from './dataset/definition.js';
+export { introspectDimension, introspectMetric, getDatasetSchema, getAllDatasetSchemas, summarizeDataset, datasetsToJSON, summarizeAllDatasets, } from './dataset/introspection.js';
+export { defineConfig, resolveClickHouseConfig, DEFAULT_MIGRATIONS_OUT_DIR, DEFAULT_MIGRATIONS_PREFIX, DEFAULT_MIGRATIONS_TABLE, } from './migrations/config/index.js';
+export { column, ClickHouseColumnBuilder, defineMaterializedView, defineSchema, defineTable, } from './migrations/schema/index.js';
+export { diffSnapshots, } from './migrations/diff/index.js';
+export { serializeSchemaToSnapshot, snapshotToStableJson, hashSnapshot, } from './migrations/snapshot/index.js';
+export { renderMigrationArtifacts, writeMigrationArtifacts, } from './migrations/sql/index.js';
+export type { ClickHouseClusterConfig, ClickHouseMigrationDbCredentials, ClickHouseMigrationDirectoryConfig, HypequeryClickHouseConfig, MigrationFilePrefix, ResolvedHypequeryClickHouseConfig, } from './migrations/config/index.js';
+export type { ClickHouseColumnDefinition, ClickHouseColumnBuilderLike, ClickHouseColumnDefaultValue, ClickHouseColumnType, ClickHouseDefaultInput, ClickHouseLowCardinalityColumnType, ClickHouseLiteralDefaultValue, ClickHouseMaterializedViewDefinition, ClickHouseMaterializedViewInputDefinition, ClickHouseNamedColumnType, ClickHouseNullableColumnType, ClickHouseSqlDefaultValue, ClickHouseSchemaAst, ClickHouseSchemaDefinition, ClickHouseSqlExpression, ClickHouseTableDefinition, ClickHouseTableInputDefinition, ClickHouseTableEngine, } from './migrations/schema/index.js';
+export type { AddColumnOperation, AlterTableWithDependentViewsOperation, CreateMaterializedViewOperation, CreateTableOperation, DiffWarning, DropColumnOperation, DropMaterializedViewOperation, DropTableOperation, MigrationOperation, ModifyColumnDefaultOperation, ModifyColumnTypeOperation, RecreateMaterializedViewOperation, SnapshotDiffResult, TableMutationOperation, UnsupportedChange, } from './migrations/diff/index.js';
+export type { MigrationMeta, RenderMigrationArtifactsOptions, RenderMigrationArtifactsResult, WriteMigrationArtifactsOptions, WriteMigrationArtifactsResult, } from './migrations/sql/index.js';
+export type { Snapshot, SnapshotColumn, SnapshotColumnDefault, SnapshotDependencyEdge, SnapshotMaterializedView, SnapshotTable, SnapshotTableEngine, } from './migrations/snapshot/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGjE,YAAY,EACV,gBAAgB,EAChB,sBAAsB,EACtB,wBAAwB,EACxB,cAAc,EACf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,YAAY,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EACb,UAAU,EACV,WAAW,EACZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,IAAI,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AACrG,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAGnE,YAAY,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,cAAc,EACd,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,cAAc,EACd,WAAW,EACX,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAGhD,OAAO,EACL,GAAG,EACH,KAAK,EACL,UAAU,EACV,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,QAAQ,EACT,MAAM,iCAAiC,CAAC;AAGzC,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,iCAAiC,CAAC;AAGzC,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACb,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,21 +1,31 @@
-// Main entry point
-export { createQueryBuilder } from './core/query-builder.js';
+export { createQueryBuilder, QueryBuilder } from './core/query-builder.js';
 export { ClickHouseConnection } from './core/connection.js';
 export { JoinRelationships } from './core/join-relationships.js';
-export { CrossFilter } from './core/cross-filter.js';
-export { logger } from './core/utils/logger.js';
+export { createClickHouseAdapter, ClickHouseAdapter } from './core/adapters/clickhouse-adapter.js';
+export { ClickHouseDialect } from './core/dialects/clickhouse-dialect.js';
+export { isClientConfig } from './core/query-builder.js';
 export { CacheController } from './core/cache/controller.js';
 export { MemoryCacheProvider } from './core/cache/providers/memory-lru.js';
 export { MemoryCacheProvider as MemoryLRUCacheProvider } from './core/cache/providers/memory-lru.js';
 export { NoopCacheProvider } from './core/cache/providers/noop.js';
-export {
-  raw,
-  rawAs,
-  toDateTime,
-  formatDateTime,
-  toStartOfInterval,
-  datePart
-} from './core/utils/sql-expressions.js';
-
-// Note: CLI functionality is deliberately not exported from the main package
-// This prevents Node.js-specific modules from being included in browser bundles
+export { CrossFilter } from './core/cross-filter.js';
+export { logger } from './core/utils/logger.js';
+// Re-export SQL expression utilities
+export { raw, rawAs, selectExpr, toDateTime, formatDateTime, toStartOfInterval, datePart } from './core/utils/sql-expressions.js';
+// =============================================================================
+// DATASET API (Phase 1)
+// =============================================================================
+// SQL tagged template
+export { sql, isSQLExpression, toSQLString } from './dataset/sql-tag.js';
+// Dimension and metric helpers
+export { dimension, metric } from './dataset/helpers.js';
+// Dataset definition utilities
+export { validateDatasetDefinition, validateDatasets, normalizeDimension, normalizeDimensions, inferDimensionType, getDimensionSQL, getMetricSQL, getDataset, listDatasets, hasDataset, getDimensionNames, getMetricNames, hasDimension, hasMetric, getDimension, getMetric, } from './dataset/definition.js';
+// Dataset introspection
+export { introspectDimension, introspectMetric, getDatasetSchema, getAllDatasetSchemas, summarizeDataset, datasetsToJSON, summarizeAllDatasets, } from './dataset/introspection.js';
+// Migrations foundations
+export { defineConfig, resolveClickHouseConfig, DEFAULT_MIGRATIONS_OUT_DIR, DEFAULT_MIGRATIONS_PREFIX, DEFAULT_MIGRATIONS_TABLE, } from './migrations/config/index.js';
+export { column, ClickHouseColumnBuilder, defineMaterializedView, defineSchema, defineTable, } from './migrations/schema/index.js';
+export { diffSnapshots, } from './migrations/diff/index.js';
+export { serializeSchemaToSnapshot, snapshotToStableJson, hashSnapshot, } from './migrations/snapshot/index.js';
+export { renderMigrationArtifacts, writeMigrationArtifacts, } from './migrations/sql/index.js';

package/dist/migrations/config/index.d.ts

@@ -0,0 +1,3 @@
+export { DEFAULT_MIGRATIONS_OUT_DIR, DEFAULT_MIGRATIONS_PREFIX, DEFAULT_MIGRATIONS_TABLE, defineConfig, resolveClickHouseConfig, } from './types.js';
+export type { ClickHouseClusterConfig, ClickHouseMigrationDbCredentials, ClickHouseMigrationDirectoryConfig, HypequeryClickHouseConfig, MigrationFilePrefix, ResolvedHypequeryClickHouseConfig, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/migrations/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/migrations/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,YAAY,EACZ,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,uBAAuB,EACvB,gCAAgC,EAChC,kCAAkC,EAClC,yBAAyB,EACzB,mBAAmB,EACnB,iCAAiC,GAClC,MAAM,YAAY,CAAC"}

package/dist/migrations/config/index.js

@@ -0,0 +1 @@
+export { DEFAULT_MIGRATIONS_OUT_DIR, DEFAULT_MIGRATIONS_PREFIX, DEFAULT_MIGRATIONS_TABLE, defineConfig, resolveClickHouseConfig, } from './types.js';

package/dist/migrations/config/types.d.ts

@@ -0,0 +1,45 @@
+export declare const DEFAULT_MIGRATIONS_OUT_DIR = "./migrations";
+export declare const DEFAULT_MIGRATIONS_TABLE = "_hypequery_migrations";
+export declare const DEFAULT_MIGRATIONS_PREFIX: "timestamp";
+export type MigrationFilePrefix = typeof DEFAULT_MIGRATIONS_PREFIX;
+export interface ClickHouseMigrationDirectoryConfig {
+    out: string;
+    table: string;
+    prefix: MigrationFilePrefix;
+}
+export interface ClickHouseMigrationDbCredentials {
+    host: string;
+    port?: number;
+    username: string;
+    password?: string;
+    database: string;
+    secure?: boolean;
+}
+export interface ClickHouseClusterConfig {
+    name: string;
+}
+export interface HypequeryClickHouseConfig {
+    dialect: 'clickhouse';
+    schema: string;
+    migrations?: Partial<ClickHouseMigrationDirectoryConfig>;
+    dbCredentials: ClickHouseMigrationDbCredentials;
+    cluster?: ClickHouseClusterConfig;
+}
+export interface ResolvedHypequeryClickHouseConfig extends Omit<HypequeryClickHouseConfig, 'migrations'> {
+    migrations: ClickHouseMigrationDirectoryConfig;
+}
+/**
+ * Defines a ClickHouse migration configuration while preserving literal TypeScript types.
+ *
+ * Use this from `hypequery.config.ts` so the CLI can load database credentials,
+ * schema entry points, and migration output settings from one typed object.
+ */
+export declare function defineConfig(config: HypequeryClickHouseConfig): HypequeryClickHouseConfig;
+/**
+ * Applies default migration settings to a user-provided ClickHouse config.
+ *
+ * This keeps CLI and programmatic callers aligned on the default output directory,
+ * migration table name, and timestamp-based file prefix strategy.
+ */
+export declare function resolveClickHouseConfig(config: HypequeryClickHouseConfig): ResolvedHypequeryClickHouseConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/migrations/config/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/migrations/config/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,0BAA0B,iBAAiB,CAAC;AACzD,eAAO,MAAM,wBAAwB,0BAA0B,CAAC;AAChE,eAAO,MAAM,yBAAyB,EAAG,WAAoB,CAAC;AAE9D,MAAM,MAAM,mBAAmB,GAAG,OAAO,yBAAyB,CAAC;AAEnE,MAAM,WAAW,kCAAkC;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED,MAAM,WAAW,gCAAgC;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC,kCAAkC,CAAC,CAAC;IACzD,aAAa,EAAE,gCAAgC,CAAC;IAChD,OAAO,CAAC,EAAE,uBAAuB,CAAC;CACnC;AAED,MAAM,WAAW,iCACf,SAAQ,IAAI,CAAC,yBAAyB,EAAE,YAAY,CAAC;IACrD,UAAU,EAAE,kCAAkC,CAAC;CAChD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,yBAAyB,GAAG,yBAAyB,CAEzF;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,yBAAyB,GAChC,iCAAiC,CASnC"}

package/dist/migrations/config/types.js

@@ -0,0 +1,28 @@
+export const DEFAULT_MIGRATIONS_OUT_DIR = './migrations';
+export const DEFAULT_MIGRATIONS_TABLE = '_hypequery_migrations';
+export const DEFAULT_MIGRATIONS_PREFIX = 'timestamp';
+/**
+ * Defines a ClickHouse migration configuration while preserving literal TypeScript types.
+ *
+ * Use this from `hypequery.config.ts` so the CLI can load database credentials,
+ * schema entry points, and migration output settings from one typed object.
+ */
+export function defineConfig(config) {
+    return config;
+}
+/**
+ * Applies default migration settings to a user-provided ClickHouse config.
+ *
+ * This keeps CLI and programmatic callers aligned on the default output directory,
+ * migration table name, and timestamp-based file prefix strategy.
+ */
+export function resolveClickHouseConfig(config) {
+    return {
+        ...config,
+        migrations: {
+            out: config.migrations?.out ?? DEFAULT_MIGRATIONS_OUT_DIR,
+            table: config.migrations?.table ?? DEFAULT_MIGRATIONS_TABLE,
+            prefix: config.migrations?.prefix ?? DEFAULT_MIGRATIONS_PREFIX,
+        },
+    };
+}