@hypequery/clickhouse 1.1.0 → 1.1.1

package/README.md

@@ -0,0 +1,253 @@
+<div align="center">
+  <h1>@hypequery/clickhouse</h1>
+  <p>A typescript-first library for building type-safe dashboards with ClickHouse</p>
+  
+  [![GitHub license](https://img.shields.io/github/license/hypequery/hypequery)](https://github.com/hypequery/hypequery/blob/main/LICENSE)
+  [![npm version](https://badge.fury.io/js/@hypequery%2Fclickhouse.svg)](https://badge.fury.io/js/@hypequery%2Fclickhouse)
+  [![GitHub stars](https://img.shields.io/github/stars/hypequery/hypequery)](https://github.com/hypequery/hypequery/stargazers)
+</div>
+
+
+## Overview
+
+hypequery is a typescript-first query builder for ClickHouse designed specifically for building type-safe analytics dashboards. Unlike generic SQL query builders, hypequery understands your ClickHouse schema and provides full type checking, making it ideal for data-intensive applications.
+
+## Features
+
+- 🎯 **Type-Safe**: Full TypeScript support with types from your ClickHouse schema
+- 🚀 **Performant**: Built for real-time analytics with optimized query generation
+- 🔍 **Cross Filtering**: Powerful cross-filtering capabilities for interactive dashboards
+- 🛠️ **Developer Friendly**: Fluent API design for an intuitive development experience
+- 📱 **Platform Agnostic**: Works in both Node.js and browser environments
+- 🔄 **Schema Generation**: CLI tool to generate TypeScript types from your ClickHouse schema
+
+## Installation
+
+This library requires one of the following ClickHouse clients as a peer dependency:
+
+### For Node.js environments
+```bash
+npm install @hypequery/clickhouse @clickhouse/client
+```
+
+### For browser/universal environments
+```bash
+npm install @hypequery/clickhouse @clickhouse/client-web
+```
+
+**Note**: The library supports multiple client selection strategies:
+- **Manual injection**: Explicitly provide a client instance (required for browser environments)
+- **Auto-detection**: Automatically selects the client for Node.js environments
+
+## Quick Start
+
+### Node.js Environments
+
+```typescript
+import { createQueryBuilder } from '@hypequery/clickhouse';
+import type { IntrospectedSchema } from './generated-schema';
+
+// Initialize the query builder
+const db = createQueryBuilder<IntrospectedSchema>({
+  host: 'your-clickhouse-host',
+  username: 'default',
+  password: 'your-password',
+  database: 'default'
+});
+
+// Build and execute a query
+const results = await db
+  .table('trips')
+  .select(['pickup_datetime', 'dropoff_datetime', 'total_amount'])
+  .where('total_amount', '>', 50)
+  .orderBy('pickup_datetime', 'DESC')
+  .limit(10)
+  .execute();
+```
+
+### Browser Environments
+
+```typescript
+import { createQueryBuilder } from '@hypequery/clickhouse';
+import { createClient } from '@clickhouse/client-web';
+import type { IntrospectedSchema } from './generated-schema';
+
+// Create the ClickHouse client explicitly
+const client = createClient({
+  host: 'your-clickhouse-host',
+  username: 'default',
+  password: '',
+  database: 'default'
+});
+
+// Initialize the query builder with the client
+const db = createQueryBuilder<IntrospectedSchema>({
+  client // Explicitly provide the client
+});
+
+// Build and execute a query
+const results = await db
+  .table('trips')
+  .select(['pickup_datetime', 'dropoff_datetime', 'total_amount'])
+  .where('total_amount', '>', 50)
+  .orderBy('pickup_datetime', 'DESC')
+  .limit(10)
+  .execute();
+```
+
+## Schema Generation
+
+hypequery provides a CLI tool to generate TypeScript types from your ClickHouse schema:
+
+```bash
+# Install globally (optional)
+npm install -g @hypequery/clickhouse
+
+# Generate schema types
+npx hypequery-generate-types --host your-clickhouse-host --database your-database
+```
+
+This creates a `generated-schema.ts` file that you can import in your application:
+
+```typescript
+import { createQueryBuilder } from '@hypequery/clickhouse';
+import type { IntrospectedSchema } from './generated-schema';
+
+const db = createQueryBuilder<IntrospectedSchema>({
+  // connection details
+});
+```
+
+## Core Features
+
+### Type-Safe Queries
+
+hypequery provides full TypeScript support, ensuring your queries are type-safe:
+
+```typescript
+// Column names are type-checked
+const query = db.table('trips')
+  .select(['pickup_datetime', 'total_amount']) 
+  .where('total_amount', 'gt', 50)
+  .execute();
+
+// Type error if column doesn't exist
+db.table('trips').select(['non_existent_column']); // TypeScript error
+```
+
+### Cross Filtering
+
+Implement interactive dashboards with cross-filtering support:
+
+```typescript
+import { CrossFilter } from '@hypequery/clickhouse';
+
+// Create a filter
+const filter = new CrossFilter()
+  .add({
+    column: 'pickup_datetime',
+    operator: 'gte',
+    value: '2024-01-01'
+  })
+  .add({
+    column: 'total_amount',
+    operator: 'gt',
+    value: 20
+  });
+
+// Apply to multiple queries
+const query1 = db.table('trips')
+  .applyCrossFilters(filter)
+  .execute();
+
+const query2 = db.table('drivers')
+  .applyCrossFilters(filter)
+  .execute();
+```
+
+### Advanced Queries
+
+hypequery supports complex queries including joins, aggregations, and subqueries:
+
+```typescript
+// Aggregations
+const stats = await db.table('trips')
+  .avg('total_amount')
+  .max('trip_distance')
+  .count('trip_id')
+  .where('pickup_datetime', 'gte', '2024-01-01')
+  .execute();
+
+// Joins
+const tripsWithDrivers = await db.table('trips')
+  .select(['trips.trip_id', 'trips.total_amount', 'drivers.name'])
+  .join('drivers', 'trips.driver_id', 'drivers.id')
+  .execute();
+
+```
+
+
+**Benefits:**
+- ✅ Works in all environments (Node.js, browser, bundlers)
+- ✅ Explicit control over client configuration
+- ✅ Required for browser environments (require() doesn't work in browsers)
+- ✅ Synchronous API throughout
+
+#### 2. Auto-Detection with Fallback (Node.js Environments Only)
+
+```typescript
+const db = createQueryBuilder<IntrospectedSchema>({
+  host: 'your-clickhouse-host',
+  username: 'default',
+  password: '',
+  database: 'default'
+});
+```
+
+
+## Versioning and Release Channels
+
+hypequery follows semantic versioning and provides multiple release channels:
+
+- **Latest**: Stable releases (`npm install @hypequery/clickhouse`)
+- **Beta**: Pre-release versions (`npm install @hypequery/clickhouse@beta`)
+
+## Documentation
+
+For detailed documentation and examples, visit our [documentation site](https://hypequery.com/docs).
+
+- [Getting Started](https://hypequery.com/docs/installation)
+- [Query Building](https://hypequery.com/docs/guides/query-building)
+- [Filtering](https://hypequery.com/docs/guides/filtering)
+- [Pagination](https://hypequery.com/docs/features/pagination)
+- [API Reference](https://hypequery.com/docs/reference/api)
+
+
+## Troubleshooting
+
+### Common Issues
+
+- **Connection Errors**: Ensure your ClickHouse server is running and accessible
+- **CORS Issues**: Use a proxy server for browser environments
+- **Type Errors**: Make sure to regenerate your schema types after schema changes
+- **Client Not Found**: Make sure you have installed at least one of the required peer dependencies:
+  - `@clickhouse/client` (for Node.js environments)
+  - `@clickhouse/client-web` (for browser/universal environments)
+- **Browser Auto-Detection**: Auto-detection doesn't work in browsers because `require()` calls don't work. Use manual injection instead.
+
+
+## License
+
+This project is licensed under the Apache-2.0 License - see the [LICENSE](LICENSE) file for details.
+
+## Support
+
+- 📚 [Documentation](https://hypequery.com/docs)
+- 🐛 [Issue Tracker](https://github.com/hypequery/hypequery/issues)
+- 💬 [Discussions](https://github.com/hypequery/hypequery/discussions)
+
+---
+
+<div align="center">
+  <sub>Built with ❤️ by the hypequery team</sub>
+</div> 

package/dist/core/cross-filter.d.ts

@@ -8,17 +8,6 @@ export interface FilterGroup<Schema extends Record<string, Record<string, any>>
         direction: 'ASC' | 'DESC';
     };
 }
-export declare const DateRange: {
-    readonly TODAY: "today";
-    readonly YESTERDAY: "yesterday";
-    readonly LAST_7_DAYS: "last_7_days";
-    readonly LAST_30_DAYS: "last_30_days";
-    readonly THIS_MONTH: "this_month";
-    readonly LAST_MONTH: "last_month";
-    readonly THIS_QUARTER: "this_quarter";
-    readonly YEAR_TO_DATE: "year_to_date";
-};
-export type DateRangeType = typeof DateRange[keyof typeof DateRange];
 /**
  * A type-safe filter builder supporting both simple conditions and complex nested groups.
  * @template Schema - The full database schema type
@@ -69,11 +58,6 @@ export declare class CrossFilter<Schema extends {
      * Type guard to check if an item is a FilterGroup.
      */
     private isGroup;
-    private addDateCondition;
-    addDateRange<K extends keyof Schema[TableName]>(column: K extends keyof Schema[TableName] ? Schema[TableName][K] extends 'Date' | 'DateTime' ? K : never : never, range: DateRangeType): this;
-    lastNDays<K extends keyof Schema[TableName]>(column: K extends keyof Schema[TableName] ? Schema[TableName][K] extends 'Date' | 'DateTime' ? K : never : never, days: number): this;
-    addComparisonPeriod<K extends keyof Schema[TableName]>(column: K extends keyof Schema[TableName] ? Schema[TableName][K] extends 'Date' | 'DateTime' ? K : never : never, currentRange: [Date, Date]): this;
-    addYearOverYear<K extends keyof Schema[TableName]>(column: K extends keyof Schema[TableName] ? Schema[TableName][K] extends 'Date' | 'DateTime' ? K : never : never, currentRange: [Date, Date]): this;
     /**
      * Creates a filter for top N records by a value column
      * @param valueColumn - The column to filter and order by

package/dist/core/cross-filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cross-filter.d.ts","sourceRoot":"","sources":["../../src/core/cross-filter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cross-filter.d.ts","sourceRoot":"","sources":["../../src/core/cross-filter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAIlB,MAAM,WAAW,WAAW,CAC1B,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,EACxD,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG;IAE3C,QAAQ,EAAE,KAAK,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,KAAK,CACf,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAC9E,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE;QACR,MAAM,EAAE,MAAM,SAAS,CAAC;QACxB,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;KAC3B,CAAC;CACH;AAED;;;;GAIG;AACH,qBAAa,WAAW,CACtB,MAAM,SAAS;IAAE,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,CAAA;CAAE,GAAG,GAAG,EAClF,SAAS,SAAS,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,MAAM,EAAE,MAAM,CAAC;IAMlD,OAAO,CAAC,MAAM,CAAC;IAH3B,OAAO,CAAC,SAAS,CAAyC;gBAGtC,MAAM,CAAC,EAAE,MAAM,YAAA;IAInC;;;OAGG;IACH,GAAG,CACD,UAAU,SAAS,OAAO,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,EAC3D,EAAE,SAAS,cAAc,EAEzB,SAAS,EAAE,oBAAoB,CAC7B,gBAAgB,CAAC,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EACpE,MAAM,EACN,MAAM,CAAC,SAAS,CAAC,CAClB,GACA,IAAI;IA0BP;;OAEG;IACH,WAAW,CACT,UAAU,EAAE,KAAK,CAAC,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,GACtE,IAAI;IAQP;;;;OAIG;IACH,QAAQ,CACN,eAAe,EAAE,KAAK,CACpB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAC9F,EACD,QAAQ,EAAE,KAAK,GAAG,IAAI,GACrB,IAAI;IAYP;;OAEG;IACH,aAAa,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAIvD;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAarB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,aAAa;IAqBrB;;OAEG;IACH,OAAO,CAAC,OAAO;IAMf;;;;;OAKG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,CAAC,SAAS,CAAC,EACpC,WAAW,EAAE,CAAC,EACd,CAAC,EAAE,MAAM,EACT,OAAO,GAAE,MAAM,GAAG,KAAc,GAC/B,IAAI;CAmBR"}

package/dist/core/cross-filter.js

@@ -1,14 +1,4 @@
 import { FilterValidator } from './validators/filter-validator';
-export const DateRange = {
-    TODAY: 'today',
-    YESTERDAY: 'yesterday',
-    LAST_7_DAYS: 'last_7_days',
-    LAST_30_DAYS: 'last_30_days',
-    THIS_MONTH: 'this_month',
-    LAST_MONTH: 'last_month',
-    THIS_QUARTER: 'this_quarter',
-    YEAR_TO_DATE: 'year_to_date'
-};
 /**
  * A type-safe filter builder supporting both simple conditions and complex nested groups.
  * @template Schema - The full database schema type
@@ -120,78 +110,6 @@ export class CrossFilter {
     isGroup(item) {
         return typeof item.conditions !== 'undefined';
     }
-    addDateCondition(column, value) {
-        this.rootGroup.conditions.push({
-            column,
-            operator: 'between',
-            value: [value[0].toISOString(), value[1].toISOString()]
-        });
-        return this;
-    }
-    addDateRange(column, range) {
-        const now = new Date();
-        let start;
-        let end;
-        switch (range) {
-            case 'today':
-                start = new Date(now.setHours(0, 0, 0, 0));
-                end = new Date(now.setHours(23, 59, 59, 999));
-                break;
-            case 'yesterday':
-                start = new Date(now.setDate(now.getDate() - 1));
-                start.setHours(0, 0, 0, 0);
-                end = new Date(start);
-                end.setHours(23, 59, 59, 999);
-                break;
-            case 'last_7_days':
-                end = new Date(now);
-                start = new Date(now.setDate(now.getDate() - 7));
-                break;
-            case 'last_30_days':
-                end = new Date(now);
-                start = new Date(now.setDate(now.getDate() - 30));
-                break;
-            case 'this_month':
-                start = new Date(now.getFullYear(), now.getMonth(), 1);
-                end = new Date(now.getFullYear(), now.getMonth() + 1, 0);
-                break;
-            case 'last_month':
-                start = new Date(now.getFullYear(), now.getMonth() - 1, 1);
-                end = new Date(now.getFullYear(), now.getMonth(), 0);
-                break;
-            case 'this_quarter':
-                const quarter = Math.floor(now.getMonth() / 3);
-                start = new Date(now.getFullYear(), quarter * 3, 1);
-                end = new Date(now.getFullYear(), (quarter + 1) * 3, 0);
-                break;
-            case 'year_to_date':
-                start = new Date(now.getFullYear(), 0, 1);
-                end = new Date(now);
-                break;
-            default:
-                throw new Error(`Unsupported date range: ${range}`);
-        }
-        return this.addDateCondition(column, [start, end]);
-    }
-    lastNDays(column, days) {
-        const end = new Date();
-        const start = new Date();
-        start.setDate(start.getDate() - days);
-        return this.addDateCondition(column, [start, end]);
-    }
-    addComparisonPeriod(column, currentRange) {
-        const periodLength = currentRange[1].getTime() - currentRange[0].getTime();
-        const previousStart = new Date(currentRange[0].getTime() - periodLength);
-        const previousEnd = new Date(currentRange[1].getTime() - periodLength);
-        return this.addDateCondition(column, [previousStart, previousEnd]);
-    }
-    addYearOverYear(column, currentRange) {
-        const previousStart = new Date(currentRange[0]);
-        previousStart.setFullYear(previousStart.getFullYear() - 1);
-        const previousEnd = new Date(currentRange[1]);
-        previousEnd.setFullYear(previousEnd.getFullYear() - 1);
-        return this.addDateCondition(column, [previousStart, previousEnd]);
-    }
     /**
      * Creates a filter for top N records by a value column
      * @param valueColumn - The column to filter and order by

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-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 type { ClickHouseConfig, ClickHouseHostConfig, ClickHouseClientConfig } from './core/query-builder.js';

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,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACvE,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,EACR,qBAAqB,EACtB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,aAAa,EACb,iBAAiB,EAClB,MAAM,iCAAiC,CAAC"}
+{"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;AACjE,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACvE,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,EACR,qBAAqB,EACtB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,aAAa,EACb,iBAAiB,EAClB,MAAM,iCAAiC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypequery/clickhouse",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "ClickHouse typescript query builder",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",