@hypequery/clickhouse 1.6.2 → 2.0.0

package/README-CLI.md

@@ -1,123 +1,78 @@
-# hypequery TypeScript Generator
+# hypequery Type Generator
 
-This tool automatically generates TypeScript type definitions from your ClickHouse database schema.
+`hypequery-generate-types` introspects your ClickHouse schema and writes a TypeScript interface you can use with `createQueryBuilder()`.
 
-## Installation
+Most users should prefer:
 
-The TypeScript generator is included with the `@hypequery/clickhouse` package:
+```bash
+npx hypequery generate
+```
+
+This file documents the lower-level binary that ships with `@hypequery/clickhouse`.
+
+## Install
 
 ```bash
 npm install @hypequery/clickhouse
 ```
 
-## Quick Start
-
-Generate TypeScript types for your ClickHouse database:
+## Usage
 
 ```bash
 npx hypequery-generate-types
 ```
 
-This will:
-1. Connect to your ClickHouse database using environment variables
-2. Introspect all tables in your database
-3. Generate TypeScript definitions in `./generated-schema.ts`
+By default it:
 
-## Example Usage
+- reads ClickHouse connection details from environment variables
+- introspects tables in the target database
+- writes `generated-schema.ts` in the current working directory
 
-**Generate types with a custom output path:**
+Custom output path:
 
 ```bash
 npx hypequery-generate-types ./src/types/db-schema.ts
 ```
 
-**Specify database connection directly:**
+## Environment Variables
+
+| Variable | Description |
+| --- | --- |
+| `CLICKHOUSE_URL` | Preferred ClickHouse URL |
+| `CLICKHOUSE_HOST` | Deprecated alias for `CLICKHOUSE_URL` |
+| `CLICKHOUSE_USER` | ClickHouse username |
+| `CLICKHOUSE_PASSWORD` | ClickHouse password |
+| `CLICKHOUSE_DATABASE` | ClickHouse database |
+
+Example:
 
 ```bash
-CLICKHOUSE_HOST=http://clickhouse.example.com:8123 \
-CLICKHOUSE_USER=myuser \
-CLICKHOUSE_PASSWORD=mypassword \
+CLICKHOUSE_URL=http://localhost:8123 \
+CLICKHOUSE_USER=default \
+CLICKHOUSE_PASSWORD=secret \
 CLICKHOUSE_DATABASE=analytics \
-npx hypequery-generate-types
+npx hypequery-generate-types ./analytics/schema.ts
 ```
 
-## Configuration
-
-Configure the connection using environment variables:
-
-| Variable | Description | Default |
-|----------|-------------|---------|
-| `CLICKHOUSE_HOST` | ClickHouse server URL | `http://localhost:8123` |
-| `CLICKHOUSE_USER` | ClickHouse username | `default` |
-| `CLICKHOUSE_PASSWORD` | ClickHouse password | _(empty)_ |
-| `CLICKHOUSE_DATABASE` | ClickHouse database name | `default` |
-
-You can set these in:
-- A `.env` file in your project root
-- Your system environment
-- Directly when running the command
-
-## Using Generated Types
+## Using The Generated Types
 
-Import the generated types in your code:
-
-```typescript
+```ts
 import { createQueryBuilder } from '@hypequery/clickhouse';
-import { IntrospectedSchema } from './generated-schema';
+import type { IntrospectedSchema } from './analytics/schema.js';
 
-// Create a type-safe query builder
 const db = createQueryBuilder<IntrospectedSchema>({
-  host: process.env.CLICKHOUSE_HOST,
-  username: process.env.CLICKHOUSE_USER,
-  password: process.env.CLICKHOUSE_PASSWORD,
-  database: process.env.CLICKHOUSE_DATABASE,
-});
-
-// Enjoy complete type safety!
-const results = await db
-  .table('users')          // TypeScript checks table exists
-  .select(['id', 'name'])  // TypeScript checks columns exist
-  .where('id', 'gt', 10)   // TypeScript validates types
-  .execute();
-
-// Results are properly typed
-results.forEach(user => {
-  console.log(user.name);  // TypeScript knows this is a string
+  url: process.env.CLICKHOUSE_URL!,
+  username: process.env.CLICKHOUSE_USER!,
+  password: process.env.CLICKHOUSE_PASSWORD ?? '',
+  database: process.env.CLICKHOUSE_DATABASE!,
 });
 ```
 
-## Adding to Your Workflow
-
-Add it to your npm scripts:
-
-```json
-{
-  "scripts": {
-    "generate-types": "hypequery-generate-types ./src/types/db-schema.ts",
-    "prebuild": "npm run generate-types",
-    "build": "tsc"
-  }
-}
-```
-
-## Troubleshooting
-
-If you encounter issues:
+## Docs
 
-1. **Connection problems**
-   - Make sure ClickHouse is running and accessible
-   - Check your firewall settings
+- [Quick start](https://hypequery.com/docs/quick-start)
+- [CLI reference](https://hypequery.com/docs/reference/api/cli)
 
-2. **Authentication failures**
-   - Verify your username and password
-   - Ensure the user has sufficient permissions
+## License
 
-3. **Missing tables**
-   - Confirm you're connecting to the correct database
-   - Verify the tables exist in your ClickHouse instance
-
-For more help, run:
-
-```bash
-npx hypequery-generate-types --help
-``` 
+Apache-2.0.

package/README.md

@@ -1,321 +1,152 @@
-<div align="center">
-  <h1>@hypequery/clickhouse</h1>
-  <p>A TypeScript-first query builder for ClickHouse and the foundation of the hypequery path.</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>
+# @hypequery/clickhouse
 
+Typed ClickHouse query builder for hypequery.
 
-## Overview
+Use it when you want schema-aware queries, typed results, and a fluent API that stays close to how ClickHouse actually works.
 
-`@hypequery/clickhouse` is the first step in the main hypequery flow. Generate types from your ClickHouse schema, build typed queries locally, then promote important queries into `query({ ... })` and `serve({ queries })` when they need to be reused across your app.
+## Install
 
-## Features
+Node:
 
-- 🎯 **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
 ```
 
-### For browser/universal environments
+Browser or shared client setup:
+
 ```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
+`url` is the preferred connection field. `host` is still supported as a deprecated alias.
 
 ## Quick Start
 
-Main path:
-
-1. Generate schema types
-2. Create a typed `db` with `createQueryBuilder(...)`
-3. Build and execute queries locally
-4. Add `@hypequery/serve` later if a query needs a reusable contract or HTTP surface
-
-### Node.js Environments
-
-```typescript
+```ts
 import { createQueryBuilder } from '@hypequery/clickhouse';
-import type { IntrospectedSchema } from './generated-schema';
+import type { IntrospectedSchema } from './analytics/schema.js';
 
-// Initialize the query builder
 const db = createQueryBuilder<IntrospectedSchema>({
-  host: 'your-clickhouse-host',
-  username: 'default',
-  password: 'your-password',
-  database: 'default'
+  url: process.env.CLICKHOUSE_URL!,
+  username: process.env.CLICKHOUSE_USERNAME!,
+  password: process.env.CLICKHOUSE_PASSWORD ?? '',
+  database: process.env.CLICKHOUSE_DATABASE!,
 });
 
-// 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)
+const recentOrders = await db
+  .table('orders')
+  .select(['id', 'user_id', 'total', 'created_at'])
+  .where('created_at', 'gte', '2026-01-01')
+  .orderBy('created_at', 'DESC')
+  .limit(20)
   .execute();
 ```
 
-### Browser Environments
+## Main Path
 
-```typescript
-import { createQueryBuilder } from '@hypequery/clickhouse';
-import { createClient } from '@clickhouse/client-web';
-import type { IntrospectedSchema } from './generated-schema';
+1. Generate schema types with the CLI
+2. Create a typed `db`
+3. Write and execute queries locally
+4. Promote important queries into `@hypequery/serve` when they need a shared contract or HTTP surface
 
-// Create the ClickHouse client explicitly
-const client = createClient({
-  host: 'your-clickhouse-host',
-  username: 'default',
-  password: '',
-  database: 'default'
-});
+## Common Patterns
 
-// Initialize the query builder with the client
-const db = createQueryBuilder<IntrospectedSchema>({
-  client // Explicitly provide the client
-});
+### Aggregation
 
-// 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)
+```ts
+const revenueByRegion = await db
+  .table('orders')
+  .select(['region'])
+  .sum('total', 'revenue')
+  .groupBy('region')
+  .orderBy('revenue', 'DESC')
   .execute();
 ```
 
-## Caching (Experimental)
-
-The query builder can cache results with deterministic keys, stale-while-revalidate behavior, and pluggable providers.
-
-```typescript
-import { createQueryBuilder, MemoryCacheProvider } from '@hypequery/clickhouse';
-
-const db = createQueryBuilder<IntrospectedSchema>({
-  host: 'your-clickhouse-host',
-  username: 'default',
-  password: '',
-  database: 'default',
-  cache: {
-    mode: 'stale-while-revalidate',
-    ttlMs: 2_000,
-    staleTtlMs: 30_000,
-    provider: new MemoryCacheProvider({ maxEntries: 5_000 })
-  }
-});
+### Joins
 
-const rows = await db
-  .table('users')
-  .select(['id', 'email'])
-  .where('active', '=', true)
-  .cache({ tags: ['users'] })
+```ts
+const ordersWithUsers = await db
+  .table('orders')
+  .innerJoin('users', 'user_id', 'users.id')
+  .select(['orders.id', 'users.email', 'orders.total'])
+  .where('users.status', 'eq', 'active')
   .execute();
-
-// Programmatic invalidation
-await db.cache.invalidateTags(['users']);
-```
-
-Use `.cache()` to attach defaults to a fluent chain, pass `execute({ cache: { ... } })` for one-off overrides, or call `db.cache.*` for manual invalidation. For a deep dive on cache modes, invalidation, advanced serialization, and bring-your-own-provider recipes (Redis/Upstash, compression, etc.), see the [Caching guide](https://hypequery.com/docs/caching).
-
-## Schema Generation
-
-Use the hypequery CLI to generate TypeScript types from your ClickHouse schema:
-
-```bash
-npm install -D @hypequery/cli
-npx hypequery generate
-```
-
-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:
+### ClickHouse-specific features
 
-```typescript
-// Column names are type-checked
-const query = db.table('trips')
-  .select(['pickup_datetime', 'total_amount']) 
-  .where('total_amount', 'gt', 50)
+```ts
+const topProductsPerCategory = await db
+  .table('products')
+  .select(['category', 'id', 'score'])
+  .orderBy('score', 'DESC')
+  .limitBy(3, 'category')
   .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)
+```ts
+const explodedTags = await db
+  .table('products')
+  .select(['id', 'tags'])
+  .arrayJoin('tags')
   .execute();
 ```
 
-### Advanced Queries
-
-hypequery supports complex queries including joins, aggregations, and subqueries:
+`arrayJoin()` and `leftArrayJoin()` only accept array-typed columns.
 
-```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();
+## Browser Use
 
-// Joins
-const tripsWithDrivers = await db.table('trips')
-  .select(['trips.trip_id', 'trips.total_amount', 'drivers.name'])
-  .join('drivers', 'trips.driver_id', 'drivers.id')
-  .execute();
+In browser environments, create the ClickHouse client explicitly and inject it:
 
-// After joining, TypeScript understands the expanded scope
-const tripsWithUsers = await db.table('trips')
-  .innerJoin('users', 'trips.user_id', 'users.id')
-  .select(['users.email', 'trips.trip_id'])
-  .where('users.email', 'like', '%@example.com')
-  .execute();
-
-// Keep literal column inference with selectConst and reuse joined columns in ORDER BY / HAVING
-const sortedTrips = await db.table('trips')
-  .innerJoin('users', 'trips.user_id', 'users.id')
-  .selectConst('users.email', 'trips.trip_id')
-  .groupBy(['users.email', 'trips.trip_id'])
-  .having('COUNT(*) > 1')
-  .orderBy('users.email', 'DESC')
-  .execute();
-
-```
-
-`selectConst()` preserves literal column names (including aliases like `users.email`), which means TypeScript keeps those identifiers available for downstream `orderBy`, `groupBy`, and `having` calls.
-
-**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
+```ts
+import { createClient } from '@clickhouse/client-web';
+import { createQueryBuilder } from '@hypequery/clickhouse';
+import type { IntrospectedSchema } from './analytics/schema.js';
 
-#### 2. Auto-Detection with Fallback (Node.js Environments Only)
+const client = createClient({
+  url: process.env.NEXT_PUBLIC_CLICKHOUSE_URL!,
+  username: process.env.NEXT_PUBLIC_CLICKHOUSE_USERNAME!,
+  password: process.env.NEXT_PUBLIC_CLICKHOUSE_PASSWORD ?? '',
+  database: process.env.NEXT_PUBLIC_CLICKHOUSE_DATABASE!,
+});
 
-```typescript
 const db = createQueryBuilder<IntrospectedSchema>({
-  host: 'your-clickhouse-host',
-  username: 'default',
-  password: '',
-  database: 'default'
+  client,
 });
 ```
 
+## Schema Generation
 
-## Testing
-
-Run the fast feedback loop with:
+The usual path is through the CLI:
 
 ```bash
-npm run test
+npm install -D @hypequery/cli
+npx hypequery generate
 ```
 
-This command runs type checks + unit tests only. To exercise the ClickHouse-backed integration suite, copy `.env.test.example` to `.env.test`, point it at a ClickHouse instance, and run:
+The package also ships the lower-level generator binary:
 
 ```bash
-npm run test:integration
+npx hypequery-generate-types
 ```
 
-## Versioning and Release Channels
+More details: [README-CLI.md](./README-CLI.md)
 
-hypequery follows semantic versioning and provides multiple release channels:
+## Useful Exports
 
-- **Latest**: Stable releases (`npm install @hypequery/clickhouse`)
-- **Beta**: Pre-release versions (`npm install @hypequery/clickhouse@beta`)
+- SQL helpers like `raw`, `rawAs`, `selectExpr`, and `toDateTime`
+- exported time helpers like `toStartOfMinute`, `toStartOfHour`, `toStartOfDay`, `toStartOfWeek`, `toStartOfMonth`, `toStartOfQuarter`, and `toStartOfYear`
+- cache primitives like `MemoryCacheProvider`
 
-## Documentation
+## Docs
 
-For detailed documentation and examples, visit the main docs flow.
-
-- [Quick Start](https://hypequery.com/docs/quick-start)
-- [Core Concepts](https://hypequery.com/docs/core-concepts)
-- [Query Building](https://hypequery.com/docs/query-building/basics)
+- [Query builder basics](https://hypequery.com/docs/query-building/basics)
 - [Filtering](https://hypequery.com/docs/query-building/where)
-- [API Reference](https://hypequery.com/docs/reference/query-builder)
-
-
-## 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.
-
+- [Joins](https://hypequery.com/docs/query-building/joins)
+- [Aggregation](https://hypequery.com/docs/query-building/aggregation)
+- [Connection reference](https://hypequery.com/docs/reference/connection)
 
 ## 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> 
+Apache-2.0.

package/dist/cli/bin.js

@@ -41,7 +41,8 @@ ${colors.bright}Usage:${colors.reset}
 
 ${colors.bright}Options:${colors.reset}
   --output=<path>            Path where TypeScript definitions will be saved (default: "./generated-schema.ts")
-  --host=<url>               ClickHouse server URL (default: http://localhost:8123)
+  --url=<url>                ClickHouse server URL (default: http://localhost:8123)
+  --host=<url>               Deprecated alias for --url
   --username=<user>          ClickHouse username (default: default)
   --password=<password>      ClickHouse password
   --database=<db>            ClickHouse database name (default: default)
@@ -53,9 +54,12 @@ ${colors.bright}Options:${colors.reset}
 ${colors.dim}Note: All options support both formats: --option=value or --option value${colors.reset}
 
 ${colors.bright}Environment variables:${colors.reset}
-  CLICKHOUSE_HOST            ClickHouse server URL
-  VITE_CLICKHOUSE_HOST       Alternative variable for Vite projects
-  NEXT_PUBLIC_CLICKHOUSE_HOST Alternative variable for Next.js projects
+  CLICKHOUSE_URL             ClickHouse server URL
+  VITE_CLICKHOUSE_URL        Alternative variable for Vite projects
+  NEXT_PUBLIC_CLICKHOUSE_URL Alternative variable for Next.js projects
+  CLICKHOUSE_HOST            Deprecated alternative
+  VITE_CLICKHOUSE_HOST       Deprecated alternative for Vite projects
+  NEXT_PUBLIC_CLICKHOUSE_HOST Deprecated alternative for Next.js projects
   
   CLICKHOUSE_USER            ClickHouse username
   VITE_CLICKHOUSE_USER       Alternative variable for Vite projects
@@ -73,8 +77,8 @@ ${colors.bright}Examples:${colors.reset}
   npx hypequery-generate-types
   npx hypequery-generate-types --output=./src/types/db-schema.ts
   npx hypequery-generate-types --output ./src/types/db-schema.ts
-  npx hypequery-generate-types --host=https://your-instance.clickhouse.cloud:8443 --secure
-  npx hypequery-generate-types --host http://localhost:8123 --username default --password password --database my_db
+  npx hypequery-generate-types --url=https://your-instance.clickhouse.cloud:8443 --secure
+  npx hypequery-generate-types --url http://localhost:8123 --username default --password password --database my_db
   npx hypequery-generate-types --include-tables=users,orders,products
   npx hypequery-generate-types --include-tables users,orders,products
   `);
@@ -107,6 +111,7 @@ function parseArguments(args) {
   // Parameter handlers map
   const paramHandlers = {
     '--output': (value) => config.output = value,
+    '--url': (value) => config.host = value,
     '--host': (value) => config.host = value,
     '--username': (value) => config.username = value,
     '--password': (value) => config.password = value,
@@ -176,6 +181,9 @@ async function main() {
   try {
     // Get connection parameters from args and environment variables
     const host = config.host ||
+      process.env.CLICKHOUSE_URL ||
+      process.env.VITE_CLICKHOUSE_URL ||
+      process.env.NEXT_PUBLIC_CLICKHOUSE_URL ||
       process.env.CLICKHOUSE_HOST ||
       process.env.VITE_CLICKHOUSE_HOST ||
       process.env.NEXT_PUBLIC_CLICKHOUSE_HOST ||
@@ -237,7 +245,7 @@ import { createQueryBuilder } from '@hypequery/clickhouse';
 import { IntrospectedSchema } from '${config.output.replace(/\.ts$/, '')}';
 
 const db = createQueryBuilder<IntrospectedSchema>({
-  host: '${host}',
+  url: '${host}',
   username: '${username}',
   password: '********',
   database: '${database}'
@@ -282,4 +290,4 @@ ${colors.yellow}SSL/TLS certificate issue.${colors.reset} For secure connections
 }
 
 // Execute the main function
-main(); 
+main(); 

package/dist/core/adapters/clickhouse-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clickhouse-adapter.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/clickhouse-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAGpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AA2B5D,qBAAa,iBAAkB,YAAW,eAAe;IAK3C,OAAO,CAAC,MAAM;IAJ1B,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,MAAM,CAAmB;gBAEb,MAAM,EAAE,gBAAgB;IAKtC,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAW5F,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC;IAYnH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,MAAM;CAGpD;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,GAAG,eAAe,CAEjF"}
+{"version":3,"file":"clickhouse-adapter.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/clickhouse-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAGpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AA4B5D,qBAAa,iBAAkB,YAAW,eAAe;IAK3C,OAAO,CAAC,MAAM;IAJ1B,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,MAAM,CAAmB;gBAEb,MAAM,EAAE,gBAAgB;IAKtC,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAW5F,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC;IAYnH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,MAAM;CAGpD;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,GAAG,eAAe,CAEjF"}

package/dist/core/adapters/clickhouse-adapter.js

@@ -1,5 +1,6 @@
 import { isClientConfig } from '../query-builder.js';
 import { substituteParameters } from '../utils.js';
+import { getConnectionEndpoint } from '../utils/connection-endpoint.js';
 import { createJsonEachRowStream } from '../utils/streaming-helpers.js';
 import { getAutoClientModule } from '../env/auto-client.js';
 function createClickHouseClient(config) {
@@ -13,10 +14,10 @@ function deriveNamespace(config) {
     if ('client' in config && config.client) {
         return 'client';
     }
-    const host = 'host' in config ? config.host : 'unknown-host';
+    const endpoint = getConnectionEndpoint(config);
     const database = 'database' in config ? config.database : 'default';
     const username = 'username' in config ? config.username : 'default';
-    return `${host || 'unknown-host'}|${database || 'default'}|${username || 'default'}`;
+    return `${endpoint || 'unknown-host'}|${database || 'default'}|${username || 'default'}`;
 }
 export class ClickHouseAdapter {
     config;