@hypequery/clickhouse 0.2.1 → 0.2.3

package/dist/core/utils/logger.js

@@ -63,6 +63,8 @@ class Logger {
         }
     }
     logQuery(log) {
+        if (!this.enabled)
+            return;
         if (this.onQueryLog) {
             this.onQueryLog(log);
         }
@@ -72,8 +74,6 @@ class Logger {
                 subscribers.forEach(callback => callback(log));
             }
         }
-        if (!this.enabled)
-            return;
         const { query, parameters, duration, status, error, rowCount } = log;
         const message = `Query ${status}: ${query}`;
         const details = {

package/dist/core/utils/sql-expressions.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Represents a raw SQL expression that can be used in queries
+ */
+export interface SqlExpression {
+    __type: string;
+    toSql(): string;
+}
+/**
+ * Represents an aliased SQL expression that can be used in select clauses
+ */
+export interface AliasedExpression extends SqlExpression {
+    __type: 'aliased_expression';
+    alias: string;
+}
+/**
+ * Creates a raw SQL expression
+ * @param sql The SQL expression string
+ * @returns A SqlExpression object
+ */
+export declare function raw(sql: string): SqlExpression;
+/**
+ * Creates an aliased SQL expression for use in SELECT clauses
+ * @param sql The SQL expression string
+ * @param alias The alias to use for the expression
+ * @returns An AliasedExpression object
+ */
+export declare function rawAs(sql: string, alias: string): AliasedExpression;
+/**
+ * Converts a value to DateTime format
+ * @param field The field or expression to convert
+ * @param alias Optional alias for the result
+ * @returns SQL expression or aliased expression
+ */
+export declare function toDateTime(field: string, alias?: string): SqlExpression | AliasedExpression;
+/**
+ * Formats a DateTime value using the specified format
+ * @param field The field or expression to format
+ * @param format The date format string
+ * @param alias Optional alias for the result
+ * @returns SQL expression or aliased expression
+ */
+export declare function formatDateTime(field: string, format: string, alias?: string): SqlExpression | AliasedExpression;
+/**
+ * Truncates a date/time value to the start of the specified interval
+ * @param field The field to truncate
+ * @param interval The interval (e.g., '1 day', '15 minute')
+ * @param alias Optional alias for the result
+ * @returns SQL expression or aliased expression
+ */
+export declare function toStartOfInterval(field: string, interval: string, alias?: string): SqlExpression | AliasedExpression;
+/**
+ * Extracts the specified part from a date/time value
+ * @param part The part to extract (year, month, day, etc.)
+ * @param field The field to extract from
+ * @param alias Optional alias for the result
+ * @returns SQL expression or aliased expression
+ */
+export declare function datePart(part: 'year' | 'quarter' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second', field: string, alias?: string): SqlExpression | AliasedExpression;
+//# sourceMappingURL=sql-expressions.d.ts.map

package/dist/core/utils.d.ts

@@ -0,0 +1,3 @@
+export declare function escapeValue(value: any): string;
+export declare function substituteParameters(sql: string, params: any[]): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/core/validators/filter-validator.d.ts

@@ -0,0 +1,8 @@
+import { ColumnType, FilterConditionInput } from '../../types';
+export declare class FilterValidator {
+    static validateFilterCondition<T = any>(condition: FilterConditionInput<T>, columnType?: ColumnType, options?: {
+        allowNull?: boolean;
+    }): void;
+    static validateJoinedColumn(column: string): boolean;
+}
+//# sourceMappingURL=filter-validator.d.ts.map

package/dist/core/validators/value-validator.d.ts

@@ -0,0 +1,6 @@
+import { ColumnType, FilterOperator } from '../../types';
+export declare class ValueValidator {
+    static validateFilterValue(columnType: ColumnType, operator: FilterOperator, value: any, columnName: string): void;
+    private static validateSingleValue;
+}
+//# sourceMappingURL=value-validator.d.ts.map

package/dist/formatters/index.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts

@@ -1,30 +1,13 @@
-/**
- * Main ClickHouse connection class
- */
-export declare class ClickHouseConnection {
-  static client: any;
-  static config: any;
-  
-  /**
-   * Initialize the connection with configuration
-   */
-  static initialize(config: {
-    host: string;
-    username: string;
-    password: string;
-    database: string;
-  }): typeof ClickHouseConnection;
-  
-  /**
-   * Get the ClickHouse client instance
-   */
-  static getClient(): any;
-  
-  /**
-   * Get the current configuration
-   */
-  static getConfig(): any;
-}
+export { createQueryBuilder } from './core/query-builder.js';
+export { ClickHouseConnection } from './core/connection.js';
+export { JoinRelationships } from './core/join-relationships.js';
+export type { TableSchema, QueryConfig, ColumnType, WhereExpression, GroupByExpression, TableRecord, DatabaseSchema, PaginatedResult, PageInfo, PaginationOptions } from './types/base';
+export type { JoinPath, JoinPathOptions } from './core/join-relationships.js';
+export { CrossFilter } from './core/cross-filter.js';
+export { logger } from './core/utils/logger.js';
+export { raw, rawAs, toDateTime, formatDateTime, toStartOfInterval, datePart } from './core/utils/sql-expressions.js';
+export type { SqlExpression, AliasedExpression } from './core/utils/sql-expressions.js';
+//# sourceMappingURL=index.d.ts.map
 
 /**
  * Generates TypeScript type definitions from ClickHouse schema

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,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,YAAY,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,eAAe,EACf,QAAQ,EACR,iBAAiB,EAClB,MAAM,cAAc,CAAC;AACtB,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;AAChD,OAAO,EACL,GAAG,EACH,KAAK,EACL,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,QAAQ,EACT,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,aAAa,EACb,iBAAiB,EAClB,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,YAAY,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,eAAe,EACf,QAAQ,EACR,iBAAiB,EAClB,MAAM,cAAc,CAAC;AACtB,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;AAChD,OAAO,EACL,GAAG,EACH,KAAK,EACL,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,QAAQ,EACT,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,aAAa,EACb,iBAAiB,EAClB,MAAM,iCAAiC,CAAC"}

package/dist/index.js

@@ -1,5 +1,17 @@
 // Main entry point
+export { createQueryBuilder } 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 {
+  raw,
+  rawAs,
+  toDateTime,
+  formatDateTime,
+  toStartOfInterval,
+  datePart
+} from './core/utils/sql-expressions.js';
 
-// CLI exports
-export { generateTypes } from './cli/generate-types.js';
+// Note: CLI functionality is deliberately not exported from the main package
+// This prevents Node.js-specific modules from being included in browser bundles

package/dist/types/base.d.ts

@@ -0,0 +1,77 @@
+import { ClickHouseType, InferClickHouseType } from "./clickhouse-types";
+import { FilterOperator } from "./filters";
+export interface QueryConfig<T, Schema> {
+    select?: Array<keyof T | string>;
+    where?: WhereCondition[];
+    groupBy?: string[];
+    having?: string[];
+    limit?: number;
+    offset?: number;
+    distinct?: boolean;
+    orderBy?: Array<{
+        column: keyof T | TableColumn<Schema>;
+        direction: OrderDirection;
+    }>;
+    joins?: JoinClause[];
+    parameters?: any[];
+    ctes?: string[];
+    unionQueries?: string[];
+    settings?: string;
+}
+export interface TableSchema<T> {
+    name: string;
+    columns: T;
+}
+export type DatabaseSchema = Record<string, Record<string, ColumnType>>;
+export type WhereExpression = string;
+export type GroupByExpression<T> = keyof T | Array<keyof T>;
+export type TableRecord<T> = {
+    [K in keyof T]: T[K] extends ColumnType ? InferColumnType<T[K]> : never;
+};
+export type ColumnType = ClickHouseType;
+export type InferColumnType<T extends ColumnType> = InferClickHouseType<T>;
+export type OrderDirection = 'ASC' | 'DESC';
+export interface WhereCondition {
+    column: string;
+    operator: FilterOperator;
+    value: any;
+    conjunction: 'AND' | 'OR';
+    type?: 'condition' | 'group-start' | 'group-end';
+}
+export type JoinType = 'INNER' | 'LEFT' | 'RIGHT' | 'FULL';
+export interface JoinClause {
+    type: JoinType;
+    table: string;
+    leftColumn: string;
+    rightColumn: string;
+    alias?: string;
+}
+export type TableColumn<Schema> = {
+    [Table in keyof Schema]: `${string & Table}.${string & keyof Schema[Table]}`;
+}[keyof Schema] | keyof Schema[keyof Schema];
+export type AggregationType<T, Aggregations, Column, A extends string, Suffix extends string, HasSelect extends boolean> = HasSelect extends true ? {
+    [K in keyof T | A]: K extends keyof T ? T[K] : string;
+} : Aggregations extends Record<string, string> ? Aggregations & Record<A extends undefined ? `${Column & string}_${Suffix}` : A, string> : Record<A extends undefined ? `${Column & string}_${Suffix}` : A, string>;
+export interface PaginationOptions<T> {
+    pageSize: number;
+    after?: string;
+    before?: string;
+    orderBy?: Array<{
+        column: keyof T | TableColumn<any>;
+        direction: OrderDirection;
+    }>;
+}
+export interface PageInfo {
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    startCursor: string;
+    endCursor: string;
+    totalCount: number;
+    totalPages: number;
+    pageSize: number;
+}
+export interface PaginatedResult<T> {
+    data: T[];
+    pageInfo: PageInfo;
+}
+//# sourceMappingURL=base.d.ts.map

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

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

package/dist/types/clickhouse-types.d.ts

@@ -0,0 +1,13 @@
+export type ClickHouseInteger = 'Int8' | 'Int16' | 'Int32' | 'Int64' | 'Int128' | 'Int256' | 'UInt8' | 'UInt16' | 'UInt32' | 'UInt64' | 'UInt128' | 'UInt256';
+export type ClickHouseFloat = 'Float32' | 'Float64';
+export type ClickHouseDecimal = 'Decimal32' | 'Decimal64' | 'Decimal128' | 'Decimal256' | `Decimal(${number}, ${number})`;
+export type ClickHouseDateTime = 'Date' | 'Date32' | 'DateTime' | `DateTime64(${number})` | `DateTime64(${number}, '${string}')`;
+export type ClickHouseString = 'String' | `FixedString(${number})` | 'UUID';
+export type ClickHouseArray = `Array(${ClickHouseBaseType})`;
+export type ClickHouseNullable = `Nullable(${ClickHouseBaseType})`;
+export type ClickHouseLowCardinality = `LowCardinality(${ClickHouseString})`;
+export type ClickHouseMap = `Map(${ClickHouseBaseType}, ${ClickHouseBaseType})`;
+export type ClickHouseBaseType = ClickHouseInteger | ClickHouseFloat | ClickHouseDecimal | ClickHouseDateTime | ClickHouseString;
+export type ClickHouseType = ClickHouseBaseType | ClickHouseArray | ClickHouseNullable | ClickHouseLowCardinality | ClickHouseMap;
+export type InferClickHouseType<T extends ClickHouseType> = T extends ClickHouseInteger ? number : T extends ClickHouseFloat ? number : T extends ClickHouseDecimal ? number : T extends ClickHouseDateTime ? Date : T extends ClickHouseString ? string : T extends `Array(${infer U extends ClickHouseBaseType})` ? Array<InferClickHouseType<U>> : T extends `Nullable(${infer U extends ClickHouseBaseType})` ? InferClickHouseType<U> | null : T extends `LowCardinality(${infer U extends ClickHouseString})` ? InferClickHouseType<U> : T extends `Map(${infer K extends ClickHouseBaseType}, ${infer V extends ClickHouseBaseType})` ? Map<InferClickHouseType<K>, InferClickHouseType<V>> : never;
+//# sourceMappingURL=clickhouse-types.d.ts.map

package/dist/types/filters.d.ts

@@ -0,0 +1,37 @@
+import { TableColumn } from "./base";
+export type FilterValue<T> = T extends Date ? Date | string : T extends number ? number : T extends string ? string : T extends boolean ? boolean : never;
+export type FilterCondition<T> = {
+    eq: FilterValue<T>;
+    neq: FilterValue<T>;
+    gt: T extends number | Date ? FilterValue<T> : never;
+    gte: T extends number | Date ? FilterValue<T> : never;
+    lt: T extends number | Date ? FilterValue<T> : never;
+    lte: T extends number | Date ? FilterValue<T> : never;
+    in: FilterValue<T>[];
+    notIn: FilterValue<T>[];
+    between: [FilterValue<T>, FilterValue<T>] | [string, string];
+    like: T extends string ? string : never;
+    notLike: T extends string ? string : never;
+};
+export type FilterValueType<T, Op extends FilterOperator> = Op extends 'in' | 'notIn' ? T extends (infer U)[] ? U[] : T[] : Op extends 'between' ? [T, T] | [string, string] : T;
+export type OperatorValueMap<T> = {
+    'eq': T | string;
+    'neq': T | string;
+    'gt': T extends string | number | Date ? T | string : never;
+    'lt': T extends string | number | Date ? T | string : never;
+    'gte': T extends string | number | Date ? T | string : never;
+    'lte': T extends string | number | Date ? T | string : never;
+    'in': (T | string)[];
+    'notIn': (T | string)[];
+    'between': [T | string, T | string] | [string, string];
+    'like': T extends string ? string : never;
+    'notLike': T extends string ? string : never;
+};
+export type FilterOperator = keyof OperatorValueMap<any>;
+export interface FilterConditionInput<T = any, Schema extends Record<string, Record<string, any>> = any, OriginalT extends Record<string, any> = any> {
+    column: keyof OriginalT | TableColumn<Schema>;
+    operator: FilterOperator;
+    value: T;
+    conjunction?: 'AND' | 'OR';
+}
+//# sourceMappingURL=filters.d.ts.map

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from './base';
+export * from './filters';
+//# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,27 +1,30 @@
 {
   "name": "@hypequery/clickhouse",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "ClickHouse typescript query builder",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
   "scripts": {
     "build": "npm run build:main && npm run build:cli && npm run fix-typedefs && npm run verify-build || npm run diagnose-ci",
-    "build:main": "tsc",
-    "build:cli": "node scripts/ensure-core-files.js && node scripts/create-bin-file.js && node scripts/handle-cli-files.js",
-    "build:ci": "npm run build:main && node scripts/create-bin-file.js && node scripts/ensure-core-files.js && node scripts/handle-cli-files.js && npm run fix-typedefs && npm run verify-build || npm run diagnose-ci",
+    "build:main": "tsc --project tsconfig.json",
+    "build:cli": "node scripts/ensure-core-files.js && node scripts/handle-cli-files.js",
+    "build:ci": "npm run build:main && node scripts/ensure-core-files.js && node scripts/handle-cli-files.js && npm run fix-typedefs && npm run verify-build || npm run diagnose-ci",
     "fix-typedefs": "node scripts/fix-typedefs.js",
     "verify-build": "node scripts/verify-build.js",
     "diagnose-ci": "node scripts/diagnose-ci.js",
     "dev": "tsc --watch",
     "test": "npm run test:unit",
-    "test:unit": "jest --testPathIgnorePatterns='integration'",
-    "test:watch": "jest  --testPathIgnorePatterns='integration' --watch",
-    "test:coverage": "jest --coverage",
+    "test:unit": "jest --testPathIgnorePatterns='integration' --config=jest.config.cjs",
+    "test:integration": "node scripts/run-integration-tests.js",
+    "test:watch": "jest --testPathIgnorePatterns='integration' --watch --config=jest.config.cjs",
+    "test:coverage": "jest --coverage --config=jest.config.cjs",
     "test:cli": "node scripts/test-cli-integration.js",
     "lint": "eslint src/**/*.ts",
     "semantic-release": "npx semantic-release",
-    "release": "npx semantic-release --extends ./.releaserc.cjs --no-ci"
+    "release": "npx semantic-release --extends ./.releaserc.cjs --no-ci",
+    "docs:api": "typedoc --options typedoc.json",
+    "docs:mdx": "npm run docs:api && node scripts/process-typedoc-markdown.js"
   },
   "bin": {
     "hypequery-generate-types": "./dist/cli/bin.js"
@@ -35,6 +38,7 @@
     "dotenv": "^16.0.0"
   },
   "devDependencies": {
+    "@babel/plugin-transform-modules-commonjs": "^7.26.3",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^11.1.0",
     "@semantic-release/git": "^10.0.1",
@@ -44,9 +48,12 @@
     "@types/jest": "^29.5.11",
     "@types/node": "^18.19.80",
     "jest": "^29.7.0",
+    "jest-esbuild": "^0.3.0",
     "semantic-release": "^23.0.2",
     "ts-jest": "^29.1.1",
     "ts-node": "^10.9.0",
+    "typedoc": "^0.28.1",
+    "typedoc-plugin-markdown": "^4.6.0",
     "typescript": "^5.7.3"
   },
   "ts-node": {