@hypequery/cli 1.3.1 → 1.4.0

package/README.md

@@ -4,7 +4,7 @@ CLI for scaffolding and running the main hypequery path.
 
 Use it to:
 
-- generate schema types from ClickHouse
+- generate schema types from ClickHouse or embedded chDB
 - scaffold `analytics/` files
 - run the local dev server with docs
 
@@ -36,27 +36,36 @@ npx hypequery init
 
 It will:
 
-- generate schema types
+- connect to ClickHouse or start an embedded chDB session
+- generate schema types when the database is available
 - create client and query files
-- write `.env` values
-- update `.gitignore`
-- install scaffold dependencies, including `zod`
+- write `.env` values for ClickHouse connections
+- update `.gitignore`, including a project-local persistent chDB directory
+- install scaffold dependencies, including `zod` and the selected database adapter
 
 Options:
 
 - `--path <path>`: output directory, default `analytics/`
 - `--style <style>`: `queries` (default) or `datasets`
+- `--database <type>`: `clickhouse` (default) or `chdb`
+- `--chdb-path <path>`: persistent chDB data directory; omit for an in-memory session
 - `--auth <mode>`: `none` (default) or `context`
 - `--all-tables`: with `--style datasets`, scaffold every table
 - `--tables <names>`: with `--style datasets`, scaffold these comma-separated tables
 - `--exclude-tables <names>`: with `--style datasets`, exclude these comma-separated tables
 - `--no-example`: skip the example query
-- `--no-interactive`: read connection details from env vars
+- `--no-interactive`: skip prompts; ClickHouse connection details come from env vars
 - `--force`: overwrite existing scaffold files
-- `--skip-connection`: skip testing the ClickHouse connection before scaffolding
+- `--skip-connection`: skip testing the selected database before scaffolding
 
 Set `HYPEQUERY_SKIP_INSTALL=1` to skip the automatic dependency install.
 
+To scaffold against persistent embedded chDB without server credentials:
+
+```bash
+npx hypequery init --database chdb --chdb-path ./analytics.chdb --no-interactive
+```
+
 ### `hypequery dev`
 
 Runs the local serve runtime with docs and hot reload.
@@ -78,7 +87,7 @@ The CLI understands TypeScript entry files directly, so `analytics/queries.ts` w
 
 ### `hypequery generate`
 
-Regenerates schema types from ClickHouse.
+Regenerates schema types from ClickHouse or embedded chDB.
 
 ```bash
 npx hypequery generate
@@ -89,7 +98,14 @@ Options:
 - `--output <path>`: default `analytics/schema.ts`
 - `--path <path>`: analytics directory (derives `<path>/schema.ts`)
 - `--tables <names>`: comma-separated table list
-- `--database <type>`: currently `clickhouse`
+- `--database <type>`: `clickhouse` or `chdb`; chDB generation must be selected explicitly
+- `--chdb-path <path>`: persistent chDB data directory; omit for an in-memory session
+
+For a persistent chDB scaffold, pass the same path used by `init`:
+
+```bash
+npx hypequery generate --database chdb --chdb-path ./analytics.chdb
+```
 
 `hypequery generate:types` is an alias for `hypequery generate`.
 
@@ -121,7 +137,7 @@ semantic keys such as `dataset:orders`.
 
 ## Non-interactive Setup
 
-`hypequery init --no-interactive` reads:
+For ClickHouse, `hypequery init --no-interactive` reads:
 
 - `CLICKHOUSE_URL` or deprecated `CLICKHOUSE_HOST`
 - `CLICKHOUSE_DATABASE`
@@ -133,6 +149,7 @@ semantic keys such as `dataset:orders`.
 - generated scaffold files use NodeNext-safe local `.js` imports
 - `CLICKHOUSE_URL` is now the preferred connection variable
 - the CLI bundles the ClickHouse driver for schema generation
+- chDB runs in memory unless `--chdb-path` is provided; persistent paths must be reused by later `generate` commands
 
 ## Docs
 

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AAa9B,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;EAKpE;AAgID,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AAa9B,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;EAKpE;AAmID,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/cli.js

@@ -43,7 +43,8 @@ function addTypeGenerationOptions(command) {
         .option('-o, --output <path>', 'Output file (default: analytics/schema.ts)')
         .option('--path <path>', 'Analytics directory (derives <path>/schema.ts)')
         .option('--tables <names>', 'Only generate for specific tables (comma-separated)')
-        .option('--database <type>', 'Database driver to use (default: auto-detect)');
+        .option('--database <type>', 'Database driver to use: clickhouse or chdb (default: auto-detect)')
+        .option('--chdb-path <path>', 'Embedded chDB data directory (with --database chdb; omit for in-memory)');
 }
 // Init command
 program
@@ -51,6 +52,8 @@ program
     .description('Initialize a new hypequery project')
     .option('--path <path>', 'Output directory (default: analytics/)')
     .option('--style <style>', 'Scaffold style: queries or datasets')
+    .option('--database <type>', 'Database driver: clickhouse (default) or chdb for embedded, zero-server ClickHouse')
+    .option('--chdb-path <path>', 'Embedded chDB data directory (with --database chdb; omit for in-memory)')
     .option('--auth <mode>', 'Auth scaffold mode: none or context')
     .option('--all-tables', 'Generate datasets for all discovered tables when using --style datasets')
     .option('--tables <names>', 'Generate datasets for specific tables when using --style datasets (comma-separated)')

package/dist/commands/generate.d.ts

@@ -4,6 +4,7 @@ export interface GenerateOptions {
     path?: string;
     tables?: string;
     database?: DatabaseType;
+    chdbPath?: string;
     commandName?: string;
 }
 export declare function generateCommand(options?: GenerateOptions): Promise<void>;

package/dist/commands/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiC,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAI/F,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,eAAe,CAAC,OAAO,GAAE,eAAoB,iBA4HlE"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiC,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAK/F,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,eAAe,CAAC,OAAO,GAAE,eAAoB,iBAoJlE"}

package/dist/commands/generate.js

@@ -3,6 +3,7 @@ import ora from 'ora';
 import { logger } from '../utils/logger.js';
 import { findSchemaFile } from '../utils/find-files.js';
 import { detectDatabase, getTableCount } from '../utils/detect-database.js';
+import { ensureChdbInstalled } from '../utils/chdb-client.js';
 import { getTypeGenerator } from '../generators/index.js';
 import { redactConnectionUrl } from '../utils/redact-connection-url.js';
 export async function generateCommand(options = {}) {
@@ -33,20 +34,38 @@ export async function generateCommand(options = {}) {
         : undefined;
     const requestedDbType = options.database;
     const dbType = requestedDbType ?? (await detectDatabase());
+    const chdbPath = dbType === 'chdb' ? options.chdbPath : undefined;
+    if (dbType === 'chdb' && !requestedDbType) {
+        throw new Error('chDB generation must be explicit. Re-run with --database chdb and add --chdb-path <dir> for persistent storage.');
+    }
     logger.newline();
     logger.header(options.commandName ?? 'hypequery generate');
     const spinner = ora(`Connecting to ${dbType}...`).start();
+    let activeSpinner = spinner;
+    let failureMessage = dbType === 'chdb'
+        ? 'Failed to start embedded chDB'
+        : 'Failed to generate types';
     try {
         const generator = getTypeGenerator(dbType);
+        // Surface a missing chdb install as the connection failure it is —
+        // getTableCount swallows errors, so without this probe the spinner
+        // would report a successful connection and 0 tables before type
+        // generation fails.
+        if (dbType === 'chdb') {
+            await ensureChdbInstalled();
+        }
         // Get table count
-        const tableCount = await getTableCount(dbType);
-        spinner.succeed(`Connected to ${dbType === 'clickhouse' ? 'ClickHouse' : dbType}`);
+        const tableCount = await getTableCount(dbType, { chdbPath });
+        spinner.succeed(`Connected to ${dbType === 'clickhouse' ? 'ClickHouse' : dbType === 'chdb' ? 'embedded chDB' : dbType}`);
         logger.success(`Found ${tableCount} tables`);
         // Generate types
         const typeSpinner = ora('Generating types...').start();
+        activeSpinner = typeSpinner;
+        failureMessage = 'Failed to generate types';
         await generator({
             outputPath,
             includeTables: parsedTables,
+            chdbPath,
         });
         typeSpinner.succeed(`Generated types for ${tableCount} tables`);
         logger.success(`Updated ${path.relative(process.cwd(), outputPath)}`);
@@ -55,7 +74,7 @@ export async function generateCommand(options = {}) {
         logger.newline();
     }
     catch (error) {
-        spinner.fail('Failed to generate types');
+        activeSpinner.fail(failureMessage);
         logger.newline();
         if (error instanceof Error) {
             logger.error(error.message);

package/dist/commands/init.d.ts

@@ -3,6 +3,8 @@ import { type AuthTemplateMode } from '../templates/queries.js';
 export interface InitOptions {
     path?: string;
     style?: InitStyle;
+    database?: string;
+    chdbPath?: string;
     allTables?: boolean;
     tables?: string;
     excludeTables?: string;

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAIA,OAAO,EAUL,KAAK,SAAS,EACf,MAAM,qBAAqB,CAAC;AAS7B,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAQzF,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AAwFD,wBAAsB,WAAW,CAAC,OAAO,GAAE,WAAgB,iBAsT1D"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAIA,OAAO,EAWL,KAAK,SAAS,EACf,MAAM,qBAAqB,CAAC;AAe7B,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAQzF,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AA4JD,wBAAsB,WAAW,CAAC,OAAO,GAAE,WAAgB,iBAyZ1D"}

package/dist/commands/init.js

@@ -2,8 +2,9 @@ import { mkdir, writeFile, readFile, access } from 'node:fs/promises';
 import path from 'node:path';
 import ora from 'ora';
 import { logger } from '../utils/logger.js';
-import { promptClickHouseConnection, promptOutputDirectory, promptInitStyle, promptGenerateExample, promptTableSelection, promptDatasetTableSelection, confirmOverwrite, promptRetry, promptContinueWithoutDb, } from '../utils/prompts.js';
+import { promptClickHouseConnection, promptChdbStorage, promptOutputDirectory, promptInitStyle, promptGenerateExample, promptTableSelection, promptDatasetTableSelection, confirmOverwrite, promptRetry, promptContinueWithoutDb, } from '../utils/prompts.js';
 import { validateConnection, getTableCount, getTables, } from '../utils/detect-database.js';
+import { ChdbNotInstalledError, ensureChdbInstalled, getChdbTypeGenerationClient, } from '../utils/chdb-client.js';
 import { hasEnvFile, hasGitignore } from '../utils/find-files.js';
 import { generateEnvTemplate, appendToEnv } from '../templates/env.js';
 import { generateClientTemplate } from '../templates/client.js';
@@ -14,6 +15,15 @@ import { appendToGitignore } from '../templates/gitignore.js';
 import { getTypeGenerator } from '../generators/index.js';
 import { generateDatasets } from '../generators/dataset-generator.js';
 import { installScaffoldDependencies } from '../utils/dependency-installer.js';
+function normalizeInitDatabase(database) {
+    if (!database || database === 'clickhouse') {
+        return 'clickhouse';
+    }
+    if (database === 'chdb') {
+        return 'chdb';
+    }
+    throw new Error(`Unsupported database "${database}". Use "clickhouse" or "chdb".`);
+}
 function normalizeInitStyle(style) {
     return style === 'datasets' ? 'datasets' : 'queries';
 }
@@ -33,6 +43,22 @@ function parseTableList(value) {
         .filter(Boolean);
     return parsed && parsed.length > 0 ? parsed : undefined;
 }
+function getChdbGitignoreEntry(chdbPath) {
+    if (!chdbPath || /[\0\r\n]/.test(chdbPath)) {
+        return undefined;
+    }
+    const cwd = path.resolve(process.cwd());
+    const relativePath = path.relative(cwd, path.resolve(cwd, chdbPath));
+    if (relativePath.length === 0 ||
+        relativePath === '..' ||
+        relativePath.startsWith(`..${path.sep}`) ||
+        path.isAbsolute(relativePath)) {
+        return undefined;
+    }
+    const normalizedPath = relativePath.split(path.sep).join('/');
+    const escapedPath = normalizedPath.replace(/[\\*?[\]]/g, '\\$&');
+    return `/${escapedPath}/`;
+}
 async function resolveConnectionConfig(options) {
     if (options.noInteractive) {
         const required = (keys) => {
@@ -52,6 +78,34 @@ async function resolveConnectionConfig(options) {
     }
     return promptClickHouseConnection();
 }
+async function testChdbConnection(chdbPath) {
+    const spinner = ora('Starting embedded chDB...').start();
+    try {
+        await ensureChdbInstalled();
+    }
+    catch (error) {
+        const isNotInstalled = error instanceof ChdbNotInstalledError;
+        spinner.fail(isNotInstalled ? 'chdb is not installed' : 'Embedded chDB failed to load');
+        logger.newline();
+        logger.error(error instanceof Error ? error.message : String(error));
+        logger.newline();
+        return { ok: false, reason: isNotInstalled ? 'not-installed' : 'engine-error' };
+    }
+    const isValid = await validateConnection('chdb', { chdbPath });
+    if (!isValid) {
+        spinner.fail('Embedded chDB failed to run a query');
+        logger.newline();
+        logger.info('Common issues:');
+        logger.indent('• Unsupported platform (chdb ships linux/macOS binaries; Windows needs WSL2)');
+        logger.indent(`• The session directory is locked by another process${chdbPath ? ` (${chdbPath})` : ''}`);
+        logger.newline();
+        return { ok: false, reason: 'engine-error' };
+    }
+    const tableCount = await getTableCount('chdb', { chdbPath });
+    spinner.succeed(`Embedded chDB ready (${chdbPath ? `${tableCount} tables in ${chdbPath}` : 'in-memory session'})`);
+    logger.newline();
+    return { ok: true };
+}
 async function testConnection(connectionConfig) {
     const spinner = ora('Testing connection...').start();
     process.env.CLICKHOUSE_URL = connectionConfig.host;
@@ -80,43 +134,58 @@ async function testConnection(connectionConfig) {
 }
 export async function initCommand(options = {}) {
     const noInteractive = options.noInteractive === true || options.interactive === false;
+    const database = normalizeInitDatabase(options.database);
     logger.newline();
     logger.header('Welcome to hypequery!');
-    logger.info("Let's set up your analytics layer.");
+    logger.info(database === 'chdb'
+        ? "Let's set up your analytics layer on embedded ClickHouse (chDB)."
+        : "Let's set up your analytics layer.");
     logger.newline();
     // Step 2: Get connection details
-    let connectionConfig = await resolveConnectionConfig(options);
+    let connectionConfig = null;
     let hasValidConnection = false;
-    // Handle user skipping connection details
-    if (!connectionConfig) {
-        logger.info('Skipping database connection for now.');
-        logger.newline();
-    }
-    else if (options.skipConnection) {
-        logger.info('Skipping database connection test (requested).');
-        logger.newline();
+    let chdbPath = options.chdbPath;
+    let chdbFailureReason;
+    if (database === 'chdb') {
+        // No server, no credentials — the only connection question is where the
+        // embedded session stores its data.
+        if (!chdbPath && !noInteractive) {
+            chdbPath = await promptChdbStorage();
+        }
     }
     else {
-        const { hasValidConnection: valid } = await testConnection(connectionConfig);
-        hasValidConnection = valid;
-        if (!hasValidConnection) {
-            if (noInteractive) {
-                throw new Error('Failed to connect to ClickHouse in non-interactive mode. Check your environment variables or use interactive setup.');
-            }
-            const retry = await promptRetry('Try again?');
-            if (retry) {
-                return initCommand(options);
-            }
-            const continueWithout = await promptContinueWithoutDb();
-            if (!continueWithout) {
-                logger.info('Setup cancelled');
-                process.exit(0);
-            }
+        connectionConfig = await resolveConnectionConfig(options);
+        // Handle user skipping connection details
+        if (!connectionConfig) {
+            logger.info('Skipping database connection for now.');
             logger.newline();
-            logger.info('Continuing without database connection.');
-            logger.info('You can configure the connection later in .env');
+        }
+        else if (options.skipConnection) {
+            logger.info('Skipping database connection test (requested).');
             logger.newline();
-            connectionConfig = null;
+        }
+        else {
+            const { hasValidConnection: valid } = await testConnection(connectionConfig);
+            hasValidConnection = valid;
+            if (!hasValidConnection) {
+                if (noInteractive) {
+                    throw new Error('Failed to connect to ClickHouse in non-interactive mode. Check your environment variables or use interactive setup.');
+                }
+                const retry = await promptRetry('Try again?');
+                if (retry) {
+                    return initCommand(options);
+                }
+                const continueWithout = await promptContinueWithoutDb();
+                if (!continueWithout) {
+                    logger.info('Setup cancelled');
+                    process.exit(0);
+                }
+                logger.newline();
+                logger.info('Continuing without database connection.');
+                logger.info('You can configure the connection later in .env');
+                logger.newline();
+                connectionConfig = null;
+            }
         }
     }
     // Step 4: Get output directory
@@ -166,6 +235,37 @@ export async function initCommand(options = {}) {
         }
         logger.newline();
     }
+    if (database === 'chdb') {
+        // All prompts and overwrite checks are complete, so installing packages
+        // here cannot leave a cancelled scaffold with unexpected dependencies.
+        await installScaffoldDependencies(style, 'chdb');
+        if (options.skipConnection) {
+            logger.info('Skipping embedded chDB test (requested).');
+            logger.newline();
+        }
+        else {
+            const chdbTest = await testChdbConnection(chdbPath);
+            hasValidConnection = chdbTest.ok;
+            if (!chdbTest.ok) {
+                chdbFailureReason = chdbTest.reason;
+            }
+            if (!hasValidConnection) {
+                if (noInteractive) {
+                    throw new Error(chdbFailureReason === 'not-installed'
+                        ? 'Embedded chDB failed to start in non-interactive mode. Install the chdb package and re-run.'
+                        : 'Embedded chDB failed to start in non-interactive mode. Resolve the engine error shown above and re-run.');
+                }
+                const continueWithout = await promptContinueWithoutDb();
+                if (!continueWithout) {
+                    logger.info('Setup cancelled');
+                    process.exit(0);
+                }
+                logger.newline();
+                logger.info('Continuing without a working embedded engine.');
+                logger.newline();
+            }
+        }
+    }
     // Step 6: Ask about example query (only if we have a valid connection)
     let generateExample = !options.noExample && hasValidConnection;
     let selectedTable = null;
@@ -173,7 +273,7 @@ export async function initCommand(options = {}) {
     if (generateExample && !noInteractive && hasValidConnection) {
         generateExample = await promptGenerateExample();
         if (generateExample) {
-            discoveredTables = await getTables('clickhouse');
+            discoveredTables = await getTables(database, { chdbPath });
             selectedTable = await promptTableSelection(discoveredTables);
             generateExample = selectedTable !== null;
         }
@@ -185,14 +285,19 @@ export async function initCommand(options = {}) {
         !options.allTables &&
         !datasetTables &&
         !noInteractive) {
-        discoveredTables ??= await getTables('clickhouse');
+        discoveredTables ??= await getTables(database, { chdbPath });
         datasetTables = await promptDatasetTableSelection(discoveredTables, selectedTable ? [selectedTable] : []);
     }
     logger.newline();
     // Step 7: Create directory
     await mkdir(resolvedOutputDir, { recursive: true });
-    // Step 8: Save credentials to .env (if we have connection config)
-    if (connectionConfig) {
+    // Step 8: Save credentials to .env (if we have connection config).
+    // Embedded chDB has no credentials — the storage path lives in client.ts —
+    // so the chdb scaffold writes no .env at all.
+    if (database === 'chdb') {
+        // nothing to persist
+    }
+    else if (connectionConfig) {
         const envPath = path.join(process.cwd(), '.env');
         const envExists = await hasEnvFile();
         if (envExists) {
@@ -226,8 +331,8 @@ export async function initCommand(options = {}) {
     if (hasValidConnection) {
         const typeSpinner = ora('Generating TypeScript types...').start();
         try {
-            const generator = getTypeGenerator('clickhouse');
-            await generator({ outputPath: schemaPath });
+            const generator = getTypeGenerator(database);
+            await generator({ outputPath: schemaPath, chdbPath });
             typeSpinner.succeed(`Generated TypeScript types (${path.relative(process.cwd(), schemaPath)})`);
         }
         catch (error) {
@@ -238,8 +343,11 @@ export async function initCommand(options = {}) {
     }
     else {
         // Create placeholder schema file
+        const regenerateHint = database === 'chdb'
+            ? "// Run 'npx hypequery generate --database chdb --chdb-path <dir>' after creating persistent tables"
+            : "// Run 'npx hypequery generate' after configuring your database connection";
         await writeFile(schemaPath, `// Generated by hypequery
-// Run 'npx hypequery generate' after configuring your database connection
+${regenerateHint}
 
 export interface IntrospectedSchema {
   // Your table types will appear here after generation
@@ -249,8 +357,8 @@ export interface IntrospectedSchema {
     }
     // Step 10: Create client.ts
     const clientPath = path.join(resolvedOutputDir, 'client.ts');
-    await writeFile(clientPath, generateClientTemplate());
-    logger.success(`Created ClickHouse client (${path.relative(process.cwd(), clientPath)})`);
+    await writeFile(clientPath, generateClientTemplate({ database, chdbPath }));
+    logger.success(`Created ${database === 'chdb' ? 'embedded chDB' : 'ClickHouse'} client (${path.relative(process.cwd(), clientPath)})`);
     // Step 11: Create API entrypoint
     let apiPath;
     let generatedAnyDatasets = false;
@@ -264,6 +372,9 @@ export interface IntrospectedSchema {
                 outputPath: datasetsPath,
                 includeTables: options.allTables ? undefined : datasetTables,
                 excludeTables: excludedDatasetTables,
+                ...(database === 'chdb'
+                    ? { client: getChdbTypeGenerationClient(chdbPath) }
+                    : {}),
             });
             generatedAnyDatasets = true;
             generatedSelectedDataset = selectedTable !== null && (options.allTables === true ||
@@ -295,20 +406,24 @@ export interface IntrospectedSchema {
     // Step 12: Update .gitignore
     const gitignorePath = path.join(process.cwd(), '.gitignore');
     const gitignoreExists = await hasGitignore();
+    const chdbGitignoreEntry = database === 'chdb'
+        ? getChdbGitignoreEntry(chdbPath)
+        : undefined;
+    const gitignoreEntries = chdbGitignoreEntry ? [chdbGitignoreEntry] : [];
     if (gitignoreExists) {
         const existingGitignore = await readFile(gitignorePath, 'utf-8');
-        const newGitignore = appendToGitignore(existingGitignore);
+        const newGitignore = appendToGitignore(existingGitignore, gitignoreEntries);
         if (newGitignore !== existingGitignore) {
             await writeFile(gitignorePath, newGitignore);
             logger.success('Updated .gitignore');
         }
     }
     else {
-        await writeFile(gitignorePath, appendToGitignore(''));
+        await writeFile(gitignorePath, appendToGitignore('', gitignoreEntries));
         logger.success('Created .gitignore');
     }
     // Step 13: Ensure required hypequery packages are installed
-    await installScaffoldDependencies(style);
+    await installScaffoldDependencies(style, database);
     // Step 14: Success message
     logger.newline();
     logger.header('Setup complete!');
@@ -342,6 +457,24 @@ export interface IntrospectedSchema {
             logger.newline();
         }
     }
+    else if (database === 'chdb') {
+        logger.info('Next steps:');
+        logger.newline();
+        // chdb is normally installed by the scaffold itself — only tell the user
+        // to install when that is actually what failed, not when an installed
+        // engine could not run (unsupported platform, locked session directory).
+        const firstStep = options.skipConnection
+            ? '1. Verify the embedded engine and create your tables'
+            : chdbFailureReason === 'engine-error'
+                ? '1. Resolve the engine error shown above'
+                : '1. Install the embedded engine: npm install chdb';
+        logger.indent(firstStep);
+        logger.indent(chdbPath
+            ? `2. Run: npx hypequery generate --database chdb --chdb-path ${chdbPath}`
+            : '2. Re-run init with --chdb-path <dir> if later generate commands must see your tables');
+        logger.indent('3. Run: npx hypequery dev          (to start dev server)');
+        logger.newline();
+    }
     else {
         logger.info('Next steps:');
         logger.newline();
@@ -350,6 +483,12 @@ export interface IntrospectedSchema {
         logger.indent('3. Run: npx hypequery dev          (to start dev server)');
         logger.newline();
     }
+    if (database === 'chdb' && hasValidConnection) {
+        logger.indent(chdbPath
+            ? `hypequery generate --database chdb --chdb-path ${chdbPath}   Refresh types after creating tables`
+            : 'In-memory chDB is process-local; use --chdb-path <dir> for later type generation');
+        logger.newline();
+    }
     logger.info('Docs: https://hypequery.com/docs');
     logger.newline();
 }

package/dist/generators/chdb.d.ts

@@ -0,0 +1,13 @@
+export interface ChdbGeneratorOptions {
+    outputPath: string;
+    includeTables?: string[];
+    excludeTables?: string[];
+    chdbPath?: string;
+}
+/**
+ * Same generator as ClickHouse — the introspection SQL (SHOW TABLES,
+ * DESCRIBE TABLE) is identical on the embedded engine — but the client seam
+ * is backed by a chDB session instead of an HTTP connection.
+ */
+export declare function generateChdbTypes(options: ChdbGeneratorOptions): Promise<void>;
+//# sourceMappingURL=chdb.d.ts.map

package/dist/generators/chdb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chdb.d.ts","sourceRoot":"","sources":["../../src/generators/chdb.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,iBAUpE"}

package/dist/generators/chdb.js

@@ -0,0 +1,17 @@
+import { generateTypes } from '@hypequery/clickhouse/cli';
+import { getChdbTypeGenerationClient } from '../utils/chdb-client.js';
+/**
+ * Same generator as ClickHouse — the introspection SQL (SHOW TABLES,
+ * DESCRIBE TABLE) is identical on the embedded engine — but the client seam
+ * is backed by a chDB session instead of an HTTP connection.
+ */
+export async function generateChdbTypes(options) {
+    const generatorOptions = {
+        client: getChdbTypeGenerationClient(options.chdbPath),
+        generatedBy: 'hypequery',
+        includeUsageExample: false,
+        ...(options.includeTables ? { includeTables: options.includeTables } : {}),
+        ...(options.excludeTables ? { excludeTables: options.excludeTables } : {}),
+    };
+    await generateTypes(options.outputPath, generatorOptions);
+}

package/dist/generators/dataset-generator.d.ts

@@ -4,10 +4,12 @@
  * Generates dataset DSL code from ClickHouse schema introspection.
  * This reduces quickstart friction by auto-scaffolding dataset definitions.
  */
+import type { TypeGenerationClickHouseClient } from '@hypequery/clickhouse/cli';
 export interface DatasetGeneratorOptions {
     outputPath: string;
     includeTables?: string[];
     excludeTables?: string[];
+    client?: TypeGenerationClickHouseClient;
 }
 /**
  * Generate dataset definitions from ClickHouse schema

package/dist/generators/dataset-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dataset-generator.d.ts","sourceRoot":"","sources":["../../src/generators/dataset-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAuPD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,iBAyDtE"}
+{"version":3,"file":"dataset-generator.d.ts","sourceRoot":"","sources":["../../src/generators/dataset-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAGhF,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,8BAA8B,CAAC;CACzC;AAuPD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,iBAyDtE"}

package/dist/generators/dataset-generator.js

@@ -199,7 +199,7 @@ ${configLines.join('\n')}
  * Generate dataset definitions from ClickHouse schema
  */
 export async function generateDatasets(options) {
-    const client = getClickHouseClient();
+    const client = options.client ?? getClickHouseClient();
     // Get all tables
     const tablesQuery = await client.query({
         query: 'SHOW TABLES',

package/dist/generators/index.d.ts

@@ -1,6 +1,7 @@
 import type { DatabaseType } from '../utils/detect-database.js';
 import { type ClickHouseGeneratorOptions } from './clickhouse.js';
-export type TypeGeneratorOptions = ClickHouseGeneratorOptions;
+import { type ChdbGeneratorOptions } from './chdb.js';
+export type TypeGeneratorOptions = ClickHouseGeneratorOptions & ChdbGeneratorOptions;
 type GeneratorFn = (options: TypeGeneratorOptions) => Promise<void>;
 export declare function getTypeGenerator(dbType: DatabaseType): GeneratorFn;
 export {};

package/dist/generators/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAA2B,KAAK,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAE3F,MAAM,MAAM,oBAAoB,GAAG,0BAA0B,CAAC;AAE9D,KAAK,WAAW,GAAG,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAMpE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW,CAYlE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAA2B,KAAK,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC3F,OAAO,EAAqB,KAAK,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEzE,MAAM,MAAM,oBAAoB,GAAG,0BAA0B,GAAG,oBAAoB,CAAC;AAErF,KAAK,WAAW,GAAG,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAOpE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW,CAYlE"}

package/dist/generators/index.js

@@ -1,6 +1,8 @@
 import { generateClickHouseTypes } from './clickhouse.js';
+import { generateChdbTypes } from './chdb.js';
 const generators = {
     clickhouse: generateClickHouseTypes,
+    chdb: generateChdbTypes,
 };
 export function getTypeGenerator(dbType) {
     const generator = generators[dbType];