@hypequery/cli 1.3.0 → 1.4.0

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];

package/dist/templates/client.d.ts

@@ -1,5 +1,10 @@
+export interface ClientTemplateOptions {
+    database?: 'clickhouse' | 'chdb';
+    /** On-disk chDB session directory; omit for an in-memory session. */
+    chdbPath?: string;
+}
 /**
- * Generate client.ts file for ClickHouse
+ * Generate client.ts file for ClickHouse (HTTP) or embedded chDB
  */
-export declare function generateClientTemplate(): string;
+export declare function generateClientTemplate(options?: ClientTemplateOptions): string;
 //# sourceMappingURL=client.d.ts.map

package/dist/templates/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/templates/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAW/C"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/templates/client.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IACjC,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,qBAA0B,GAAG,MAAM,CAiClF"}

package/dist/templates/client.js

@@ -1,7 +1,28 @@
 /**
- * Generate client.ts file for ClickHouse
+ * Generate client.ts file for ClickHouse (HTTP) or embedded chDB
  */
-export function generateClientTemplate() {
+export function generateClientTemplate(options = {}) {
+    if (options.database === 'chdb') {
+        // JSON.stringify produces a valid JS string literal for any path
+        // (quotes, backslashes) — raw interpolation would break the scaffold.
+        const sessionArg = options.chdbPath ? JSON.stringify(options.chdbPath) : '';
+        const safePathForComment = options.chdbPath?.replace(/[\r\n\u2028\u2029]/g, '') ?? '';
+        const storageComment = options.chdbPath
+            ? `// Embedded ClickHouse — data persists in ${safePathForComment}`
+            : '// Embedded ClickHouse — in-memory session (data is discarded on exit).\n// Pass a directory path to new Session(...) to persist between runs.';
+        return `import { createQueryBuilder } from '@hypequery/clickhouse';
+import { Session } from 'chdb';
+import { chdbAdapter } from 'chdb/hypequery';
+import type { IntrospectedSchema } from './schema.js';
+
+${storageComment}
+export const session = new Session(${sessionArg});
+
+export const db = createQueryBuilder<IntrospectedSchema>({
+  adapter: chdbAdapter({ session }),
+});
+`;
+    }
     return `import { createQueryBuilder } from '@hypequery/clickhouse';
 import type { IntrospectedSchema } from './schema.js';
 

package/dist/templates/gitignore.d.ts

@@ -9,5 +9,5 @@ export declare function hasHypequeryEntries(content: string): boolean;
 /**
  * Append hypequery entries to .gitignore
  */
-export declare function appendToGitignore(existingContent: string): string;
+export declare function appendToGitignore(existingContent: string, additionalEntries?: readonly string[]): string;
 //# sourceMappingURL=gitignore.d.ts.map

package/dist/templates/gitignore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gitignore.d.ts","sourceRoot":"","sources":["../../src/templates/gitignore.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,iBAAiB,0BAG7B,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAUjE"}
+{"version":3,"file":"gitignore.d.ts","sourceRoot":"","sources":["../../src/templates/gitignore.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,iBAAiB,0BAG7B,CAAC;AAQF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,MAAM,EACvB,iBAAiB,GAAE,SAAS,MAAM,EAAO,GACxC,MAAM,CAuBR"}

package/dist/templates/gitignore.js

@@ -5,21 +5,35 @@ export const GITIGNORE_CONTENT = `
 # Hypequery
 .env
 `;
+function hasEntry(content, entry) {
+    return content
+        .split(/\r?\n/)
+        .some((line) => line.trim() === entry);
+}
 /**
  * Check if .gitignore already has hypequery entries
  */
 export function hasHypequeryEntries(content) {
-    return content.includes('# Hypequery') || content.includes('.env');
+    return hasEntry(content, '# Hypequery') || hasEntry(content, '.env');
 }
 /**
  * Append hypequery entries to .gitignore
  */
-export function appendToGitignore(existingContent) {
-    if (hasHypequeryEntries(existingContent)) {
+export function appendToGitignore(existingContent, additionalEntries = []) {
+    const entries = ['.env', ...additionalEntries];
+    const missingEntries = entries.filter((entry, index) => entry.length > 0 && entries.indexOf(entry) === index && !hasEntry(existingContent, entry));
+    if (missingEntries.length === 0) {
         return existingContent;
     }
-    if (!existingContent.endsWith('\n')) {
-        existingContent += '\n';
+    let updatedContent = existingContent;
+    if (updatedContent.length > 0 && !updatedContent.endsWith('\n')) {
+        updatedContent += '\n';
+    }
+    if (!hasHypequeryEntries(existingContent)) {
+        if (updatedContent.length > 0 && !updatedContent.endsWith('\n\n')) {
+            updatedContent += '\n';
+        }
+        updatedContent += '# Hypequery\n';
     }
-    return existingContent + GITIGNORE_CONTENT;
+    return `${updatedContent}${missingEntries.join('\n')}\n`;
 }

package/dist/utils/chdb-client.d.ts

@@ -0,0 +1,36 @@
+import type { TypeGenerationClickHouseClient } from '@hypequery/clickhouse/cli';
+interface ChdbSession {
+    queryAsync(sql: string, options?: {
+        format?: string;
+    }): Promise<{
+        text(): string;
+    }>;
+    close(): void;
+}
+export declare class ChdbNotInstalledError extends Error {
+    readonly code = "CHDB_NOT_INSTALLED";
+    constructor();
+}
+/**
+ * Get (or create) the embedded chDB session. `path` selects the on-disk
+ * database directory; omit it for an ephemeral in-memory session. The session
+ * is cached per path — chDB allows one active data directory per process.
+ */
+export declare function getChdbSession(dbPath?: string): Promise<ChdbSession>;
+/**
+ * The type generator only needs `query({ query, format }) → { json() }` —
+ * the `TypeGenerationClickHouseClient` seam — so the embedded session can
+ * stand in for an HTTP client without touching the generator itself.
+ */
+export declare function getChdbTypeGenerationClient(dbPath?: string): TypeGenerationClickHouseClient;
+/**
+ * Throws the actionable install-hint error when `chdb` is missing. Init calls
+ * this before the connection test so "package not installed" surfaces as its
+ * own message instead of a generic connection failure.
+ */
+export declare function ensureChdbInstalled(): Promise<void>;
+export declare function validateChdb(dbPath?: string): Promise<boolean>;
+export declare function getChdbTables(dbPath?: string): Promise<string[]>;
+export declare function closeChdbSessionForTesting(): Promise<void>;
+export {};
+//# sourceMappingURL=chdb-client.d.ts.map

package/dist/utils/chdb-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chdb-client.d.ts","sourceRoot":"","sources":["../../src/utils/chdb-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAYhF,UAAU,WAAW;IACnB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,IAAI,MAAM,CAAA;KAAE,CAAC,CAAC;IACpF,KAAK,IAAI,IAAI,CAAC;CACf;AAKD,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,wBAAwB;;CAQtC;AA6CD;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAY1E;AAYD;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,8BAA8B,CAQ3F;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEzD;AAED,wBAAsB,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOpE;AAED,wBAAsB,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOtE;AAED,wBAAsB,0BAA0B,kBAM/C"}

package/dist/utils/chdb-client.js

@@ -0,0 +1,122 @@
+import { createRequire } from 'node:module';
+import path from 'node:path';
+let session = null;
+let sessionPath;
+export class ChdbNotInstalledError extends Error {
+    code = 'CHDB_NOT_INSTALLED';
+    constructor() {
+        super('The embedded driver needs the `chdb` package. Install it with `npm install chdb` (or your package manager\'s equivalent) and re-run.');
+        this.name = 'ChdbNotInstalledError';
+    }
+}
+function isModuleNotFound(error) {
+    return (error instanceof Error &&
+        'code' in error &&
+        (error.code === 'MODULE_NOT_FOUND' ||
+            error.code === 'ERR_MODULE_NOT_FOUND'));
+}
+function resolveChdb(requireFn) {
+    try {
+        return requireFn.resolve('chdb');
+    }
+    catch (error) {
+        if (isModuleNotFound(error)) {
+            return undefined;
+        }
+        throw error;
+    }
+}
+async function loadChdb() {
+    // Resolve chdb from the USER'S project, not from where the CLI happens to
+    // be installed — under `npx` the CLI runs out of the npx cache, where a
+    // bare import('chdb') would never see the project's node_modules.
+    const requireFromProject = createRequire(path.join(process.cwd(), 'package.json'));
+    const projectChdb = resolveChdb(requireFromProject);
+    if (projectChdb) {
+        // Resolving first lets us distinguish an absent package from failures
+        // while loading an installed package (for example, a native ABI error).
+        return requireFromProject(projectChdb);
+    }
+    // Retain the fallback for installations where chdb is visible beside the
+    // CLI rather than from the project package.json.
+    const requireFromCli = createRequire(import.meta.url);
+    const cliChdb = resolveChdb(requireFromCli);
+    if (cliChdb) {
+        return requireFromCli(cliChdb);
+    }
+    throw new ChdbNotInstalledError();
+}
+/**
+ * Get (or create) the embedded chDB session. `path` selects the on-disk
+ * database directory; omit it for an ephemeral in-memory session. The session
+ * is cached per path — chDB allows one active data directory per process.
+ */
+export async function getChdbSession(dbPath) {
+    if (session && sessionPath === dbPath) {
+        return session;
+    }
+    if (session) {
+        session.close();
+        session = null;
+    }
+    const chdb = await loadChdb();
+    session = new chdb.Session(dbPath);
+    sessionPath = dbPath;
+    return session;
+}
+async function queryJsonRows(sql, dbPath) {
+    const s = await getChdbSession(dbPath);
+    const result = await s.queryAsync(sql, { format: 'JSONEachRow' });
+    return result
+        .text()
+        .split('\n')
+        .filter((line) => line.trim() !== '')
+        .map((line) => JSON.parse(line));
+}
+/**
+ * The type generator only needs `query({ query, format }) → { json() }` —
+ * the `TypeGenerationClickHouseClient` seam — so the embedded session can
+ * stand in for an HTTP client without touching the generator itself.
+ */
+export function getChdbTypeGenerationClient(dbPath) {
+    return {
+        async query({ query }) {
+            return {
+                json: async () => queryJsonRows(query, dbPath),
+            };
+        },
+    };
+}
+/**
+ * Throws the actionable install-hint error when `chdb` is missing. Init calls
+ * this before the connection test so "package not installed" surfaces as its
+ * own message instead of a generic connection failure.
+ */
+export async function ensureChdbInstalled() {
+    await loadChdb();
+}
+export async function validateChdb(dbPath) {
+    try {
+        const rows = await queryJsonRows('SELECT 1 AS ok', dbPath);
+        return rows.length === 1;
+    }
+    catch {
+        return false;
+    }
+}
+export async function getChdbTables(dbPath) {
+    try {
+        const rows = await queryJsonRows('SHOW TABLES', dbPath);
+        return rows.map((row) => row.name);
+    }
+    catch {
+        return [];
+    }
+}
+export async function closeChdbSessionForTesting() {
+    if (session) {
+        session.close();
+        session = null;
+        sessionPath = undefined;
+    }
+}

package/dist/utils/dependency-installer.d.ts

@@ -1,6 +1,7 @@
 type ScaffoldStyle = 'queries' | 'datasets';
-export declare function resolveScaffoldPackages(cliVersion: string | undefined, style?: ScaffoldStyle): string[];
-export declare function installScaffoldDependencies(style?: ScaffoldStyle): Promise<void>;
+type ScaffoldDatabase = 'clickhouse' | 'chdb';
+export declare function resolveScaffoldPackages(cliVersion: string | undefined, style?: ScaffoldStyle, database?: ScaffoldDatabase): string[];
+export declare function installScaffoldDependencies(style?: ScaffoldStyle, database?: ScaffoldDatabase): Promise<void>;
 export declare const installServeDependencies: typeof installScaffoldDependencies;
 export {};
 //# sourceMappingURL=dependency-installer.d.ts.map

package/dist/utils/dependency-installer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dependency-installer.d.ts","sourceRoot":"","sources":["../../src/utils/dependency-installer.ts"],"names":[],"mappings":"AASA,KAAK,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;AA0F5C,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,GAAE,aAAyB,GAAG,MAAM,EAAE,CAgBlH;AAsBD,wBAAsB,2BAA2B,CAAC,KAAK,GAAE,aAAyB,iBAiDjF;AAED,eAAO,MAAM,wBAAwB,oCAA8B,CAAC"}
+{"version":3,"file":"dependency-installer.d.ts","sourceRoot":"","sources":["../../src/utils/dependency-installer.ts"],"names":[],"mappings":"AAWA,KAAK,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;AAC5C,KAAK,gBAAgB,GAAG,YAAY,GAAG,MAAM,CAAC;AA0F9C,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,KAAK,GAAE,aAAyB,EAChC,QAAQ,GAAE,gBAA+B,GACxC,MAAM,EAAE,CAmBV;AAsBD,wBAAsB,2BAA2B,CAC/C,KAAK,GAAE,aAAyB,EAChC,QAAQ,GAAE,gBAA+B,iBAkD1C;AAED,eAAO,MAAM,wBAAwB,oCAA8B,CAAC"}

package/dist/utils/dependency-installer.js

@@ -5,6 +5,8 @@ import { spawn } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { logger } from './logger.js';
 const ZOD_SCAFFOLD_VERSION = '^3.23.8';
+// chdb/hypequery (the embedded adapter subpath) ships from chdb 3.2.0.
+const CHDB_SCAFFOLD_VERSION = '^3.2.0';
 const STABLE_SCAFFOLD_PACKAGES = ['@hypequery/clickhouse', '@hypequery/serve', `zod@${ZOD_SCAFFOLD_VERSION}`];
 const CLI_PACKAGE_PATH = fileURLToPath(new URL('../../package.json', import.meta.url));
 const MANUAL_COMMANDS = {
@@ -82,19 +84,22 @@ function getInstallArgs(manager, packages) {
 function formatManualCommand(manager, packages) {
     return `${MANUAL_COMMANDS[manager]} ${packages.join(' ')}`;
 }
-export function resolveScaffoldPackages(cliVersion, style = 'queries') {
+export function resolveScaffoldPackages(cliVersion, style = 'queries', database = 'clickhouse') {
     const includeDatasets = style === 'datasets';
+    const includeChdb = database === 'chdb';
     if (cliVersion?.includes('canary')) {
         return [
             `@hypequery/clickhouse@${cliVersion}`,
             `@hypequery/serve@${cliVersion}`,
             ...(includeDatasets ? [`@hypequery/datasets@${cliVersion}`] : []),
             `zod@${ZOD_SCAFFOLD_VERSION}`,
+            ...(includeChdb ? [`chdb@${CHDB_SCAFFOLD_VERSION}`] : []),
         ];
     }
     return [
         ...STABLE_SCAFFOLD_PACKAGES,
         ...(includeDatasets ? ['@hypequery/datasets'] : []),
+        ...(includeChdb ? [`chdb@${CHDB_SCAFFOLD_VERSION}`] : []),
     ];
 }
 function shouldInstallPackage(pkgJson, specifier) {
@@ -112,7 +117,7 @@ function shouldInstallPackage(pkgJson, specifier) {
     const desiredVersion = specifier.slice(name.length + 1);
     return existingVersion !== desiredVersion;
 }
-export async function installScaffoldDependencies(style = 'queries') {
+export async function installScaffoldDependencies(style = 'queries', database = 'clickhouse') {
     if (process.env.HYPEQUERY_SKIP_INSTALL === '1') {
         return;
     }
@@ -125,7 +130,7 @@ export async function installScaffoldDependencies(style = 'queries') {
         logger.warn(`package.json not found. Install @hypequery/clickhouse, @hypequery/serve${extra}, and zod manually.`);
         return;
     }
-    const requestedPackages = resolveScaffoldPackages(cliPkgJson?.version, style);
+    const requestedPackages = resolveScaffoldPackages(cliPkgJson?.version, style, database);
     const missing = requestedPackages.filter(pkg => shouldInstallPackage(pkgJson, pkg));
     if (missing.length === 0) {
         return;

package/dist/utils/detect-database.d.ts

@@ -1,7 +1,14 @@
 /**
  * Database type detection result
  */
-export type DatabaseType = 'clickhouse' | 'bigquery' | 'unknown';
+export type DatabaseType = 'clickhouse' | 'chdb' | 'bigquery' | 'unknown';
+/**
+ * Options threaded through to drivers that need more than env vars —
+ * currently only the embedded chDB session directory.
+ */
+export interface DatabaseOptions {
+    chdbPath?: string;
+}
 /**
  * Auto-detect database type from environment or config files
  */
@@ -9,13 +16,13 @@ export declare function detectDatabase(): Promise<DatabaseType>;
 /**
  * Validate database connection
  */
-export declare function validateConnection(dbType: DatabaseType): Promise<boolean>;
+export declare function validateConnection(dbType: DatabaseType, options?: DatabaseOptions): Promise<boolean>;
 /**
  * Get table count from database
  */
-export declare function getTableCount(dbType: DatabaseType): Promise<number>;
+export declare function getTableCount(dbType: DatabaseType, options?: DatabaseOptions): Promise<number>;
 /**
  * Get list of tables from database
  */
-export declare function getTables(dbType: DatabaseType): Promise<string[]>;
+export declare function getTables(dbType: DatabaseType, options?: DatabaseOptions): Promise<string[]>;
 //# sourceMappingURL=detect-database.d.ts.map

package/dist/utils/detect-database.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detect-database.d.ts","sourceRoot":"","sources":["../../src/utils/detect-database.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,CAAC;AAEjE;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,YAAY,CAAC,CAyC5D;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAS/E;AAuBD;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAOzE;AAyBD;;GAEG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOvE"}
+{"version":3,"file":"detect-database.d.ts","sourceRoot":"","sources":["../../src/utils/detect-database.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;AAE1E;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,YAAY,CAAC,CAuD5D;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAWlB;AAuBD;;GAEG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CASjB;AAyBD;;GAEG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,MAAM,EAAE,CAAC,CASnB"}

package/dist/utils/detect-database.js

@@ -1,6 +1,7 @@
-import { access } from 'node:fs/promises';
+import { access, readFile } from 'node:fs/promises';
 import path from 'node:path';
 import { getClickHouseClient } from './clickhouse-client.js';
+import { validateChdb, getChdbTables } from './chdb-client.js';
 /**
  * Auto-detect database type from environment or config files
  */
@@ -18,7 +19,6 @@ export async function detectDatabase() {
     try {
         const envPath = path.join(process.cwd(), '.env');
         await access(envPath);
-        const { readFile } = await import('node:fs/promises');
         const envContent = await readFile(envPath, 'utf-8');
         if (envContent.includes('CLICKHOUSE_') ||
             envContent.includes('CLICKHOUSE_HOST')) {
@@ -32,15 +32,29 @@ export async function detectDatabase() {
     catch {
         // .env doesn't exist, continue
     }
+    // A project that depends on chdb but has no ClickHouse connection config is
+    // running on the embedded engine.
+    try {
+        const pkgContent = await readFile(path.join(process.cwd(), 'package.json'), 'utf-8');
+        const pkg = JSON.parse(pkgContent);
+        if (pkg.dependencies?.chdb || pkg.devDependencies?.chdb) {
+            return 'chdb';
+        }
+    }
+    catch {
+        // package.json missing or unparsable, continue
+    }
     return 'unknown';
 }
 /**
  * Validate database connection
  */
-export async function validateConnection(dbType) {
+export async function validateConnection(dbType, options = {}) {
     switch (dbType) {
         case 'clickhouse':
             return validateClickHouse();
+        case 'chdb':
+            return validateChdb(options.chdbPath);
         case 'bigquery':
             return validateBigQuery();
         default:
@@ -68,10 +82,12 @@ async function validateBigQuery() {
 /**
  * Get table count from database
  */
-export async function getTableCount(dbType) {
+export async function getTableCount(dbType, options = {}) {
     switch (dbType) {
         case 'clickhouse':
             return getClickHouseTableCount();
+        case 'chdb':
+            return (await getChdbTables(options.chdbPath)).length;
         default:
             return 0;
     }
@@ -99,10 +115,12 @@ async function getClickHouseTableCount() {
 /**
  * Get list of tables from database
  */
-export async function getTables(dbType) {
+export async function getTables(dbType, options = {}) {
     switch (dbType) {
         case 'clickhouse':
             return getClickHouseTables();
+        case 'chdb':
+            return getChdbTables(options.chdbPath);
         default:
             return [];
     }

package/dist/utils/prompts.d.ts

@@ -7,6 +7,12 @@ export declare function promptClickHouseConnection(): Promise<{
     username: string;
     password: string;
 } | null>;
+/**
+ * Prompt for embedded chDB storage: ephemeral in-memory session, or an
+ * on-disk directory that persists between runs. Returns the session path,
+ * or undefined for in-memory.
+ */
+export declare function promptChdbStorage(): Promise<string | undefined>;
 /**
  * Prompt for output directory
  */
@@ -37,12 +43,4 @@ export declare function promptRetry(message: string): Promise<boolean>;
  * Ask if user wants to continue without DB connection
  */
 export declare function promptContinueWithoutDb(): Promise<boolean>;
-/**
- * Confirm destructive operations (DROP TABLE, DROP COLUMN)
- */
-export declare function confirmDestructiveOperation(operations: string[]): Promise<boolean>;
-/**
- * Confirm mutation operations (type changes that trigger ClickHouse mutations)
- */
-export declare function confirmMutationOperation(): Promise<boolean>;
 //# sourceMappingURL=prompts.d.ts.map

package/dist/utils/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/utils/prompts.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAAC,CAkCR;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,CA6B7D;AAED,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAE/C,wBAAsB,eAAe,IAAI,OAAO,CAAC,SAAS,CAAC,CAa1D;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,CAS9D;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA0BnF;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,MAAM,EAAE,EAChB,aAAa,GAAE,MAAM,EAAO,GAC3B,OAAO,CAAC,MAAM,EAAE,CAAC,CA2BnB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CASxE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASnE;AAED;;GAEG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC,CAShE;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CASxF;AAED;;GAEG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,OAAO,CAAC,CASjE"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/utils/prompts.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAAC,CAkCR;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA4BrE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,CA6B7D;AAED,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAE/C,wBAAsB,eAAe,IAAI,OAAO,CAAC,SAAS,CAAC,CAa1D;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,CAS9D;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA0BnF;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,MAAM,EAAE,EAChB,aAAa,GAAE,MAAM,EAAO,GAC3B,OAAO,CAAC,MAAM,EAAE,CAAC,CA2BnB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CASxE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASnE;AAED;;GAEG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC,CAShE"}

package/dist/utils/prompts.js

@@ -39,6 +39,37 @@ export async function promptClickHouseConnection() {
     }
     return response;
 }
+/**
+ * Prompt for embedded chDB storage: ephemeral in-memory session, or an
+ * on-disk directory that persists between runs. Returns the session path,
+ * or undefined for in-memory.
+ */
+export async function promptChdbStorage() {
+    const response = await prompts({
+        type: 'select',
+        name: 'storage',
+        message: 'Where should embedded chDB store data?',
+        choices: [
+            { title: 'In-memory (discarded on exit)', value: 'memory' },
+            { title: 'Local directory (./analytics.chdb)', value: 'file' },
+            { title: 'Custom path...', value: 'custom' },
+        ],
+        initial: 0,
+    });
+    if (!response.storage || response.storage === 'memory') {
+        return undefined;
+    }
+    if (response.storage === 'custom') {
+        const customResponse = await prompts({
+            type: 'text',
+            name: 'path',
+            message: 'Enter chDB data directory:',
+            initial: './analytics.chdb',
+        });
+        return customResponse.path || './analytics.chdb';
+    }
+    return './analytics.chdb';
+}
 /**
  * Prompt for output directory
  */
@@ -183,27 +214,3 @@ export async function promptContinueWithoutDb() {
     });
     return response.continue ?? false;
 }
-/**
- * Confirm destructive operations (DROP TABLE, DROP COLUMN)
- */
-export async function confirmDestructiveOperation(operations) {
-    const response = await prompts({
-        type: 'confirm',
-        name: 'confirm',
-        message: `This migration includes ${operations.length} destructive operation(s). Continue?`,
-        initial: false,
-    });
-    return response.confirm ?? false;
-}
-/**
- * Confirm mutation operations (type changes that trigger ClickHouse mutations)
- */
-export async function confirmMutationOperation() {
-    const response = await prompts({
-        type: 'confirm',
-        name: 'confirm',
-        message: 'This migration will trigger ClickHouse mutations. Continue?',
-        initial: false,
-    });
-    return response.confirm ?? false;
-}

package/dist/utils/redact-connection-url.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns enough endpoint information for diagnostics without exposing URL
+ * userinfo, query parameters, or fragments that may contain credentials.
+ */
+export declare function redactConnectionUrl(value: string | undefined): string;
+//# sourceMappingURL=redact-connection-url.d.ts.map

package/dist/utils/redact-connection-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact-connection-url.d.ts","sourceRoot":"","sources":["../../src/utils/redact-connection-url.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAarE"}

package/dist/utils/redact-connection-url.js

@@ -0,0 +1,18 @@
+/**
+ * Returns enough endpoint information for diagnostics without exposing URL
+ * userinfo, query parameters, or fragments that may contain credentials.
+ */
+export function redactConnectionUrl(value) {
+    if (!value)
+        return 'not set';
+    const trimmed = value.trim();
+    const hasScheme = /^[a-z][a-z\d+.-]*:\/\//i.test(trimmed);
+    try {
+        const url = new URL(hasScheme ? trimmed : `http://${trimmed}`);
+        const pathname = url.pathname === '/' ? '' : url.pathname;
+        return `${hasScheme ? `${url.protocol}//` : ''}${url.host}${pathname}`;
+    }
+    catch {
+        return '[configured connection URL]';
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypequery/cli",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Command-line interface for hypequery",
   "license": "Apache-2.0",
   "type": "module",
@@ -35,8 +35,8 @@
     "@vitest/coverage-v8": "^3.2.6",
     "typescript": "^5.7.3",
     "vitest": "^3.2.6",
-    "@hypequery/clickhouse": "2.1.2",
-    "@hypequery/serve": "0.6.0"
+    "@hypequery/clickhouse": "2.4.0",
+    "@hypequery/serve": "0.11.0"
   },
   "repository": {
     "type": "git",

package/dist/utils/clickhouse-sql.d.ts

@@ -1,6 +0,0 @@
-export declare function quoteIdentifier(identifier: string): string;
-export declare function assertValidIdentifier(identifier: string): void;
-export declare function sqlString(value: string): string;
-export declare function sqlStringArray(values: string[]): string;
-export declare function sqlDateTime(value: Date): string;
-//# sourceMappingURL=clickhouse-sql.d.ts.map

package/dist/utils/clickhouse-sql.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"clickhouse-sql.d.ts","sourceRoot":"","sources":["../../src/utils/clickhouse-sql.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,QAIvD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,UAEtC;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,UAE9C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,UAEtC"}