@hypequery/cli 1.22.0 → 1.24.0

package/dist/typegen/type-parsing.js

@@ -167,19 +167,19 @@ function getPrimitiveTsType(type) {
  * Converts a ClickHouse type string, as returned by `DESCRIBE TABLE`, into the
  * equivalent TypeScript type string.
  */
-export const clickhouseToTsType = (type) => {
+export const clickhouseToTsType = (type, onUnsupported) => {
     const normalizedType = type.trim();
     const wrappedArrayType = unwrapType(normalizedType, 'Array');
     if (wrappedArrayType) {
-        return `Array<${clickhouseToTsType(wrappedArrayType)}>`;
+        return `Array<${clickhouseToTsType(wrappedArrayType, onUnsupported)}>`;
     }
     const wrappedNullableType = unwrapType(normalizedType, 'Nullable');
     if (wrappedNullableType) {
-        return `${clickhouseToTsType(wrappedNullableType)} | null`;
+        return `${clickhouseToTsType(wrappedNullableType, onUnsupported)} | null`;
     }
     const wrappedLowCardinalityType = unwrapType(normalizedType, 'LowCardinality');
     if (wrappedLowCardinalityType) {
-        return clickhouseToTsType(wrappedLowCardinalityType);
+        return clickhouseToTsType(wrappedLowCardinalityType, onUnsupported);
     }
     const wrappedTupleType = unwrapType(normalizedType, 'Tuple');
     if (wrappedTupleType) {
@@ -187,10 +187,10 @@ export const clickhouseToTsType = (type) => {
         const namedParts = tupleParts.map(parseNamedTuplePart);
         if (namedParts.length > 0 && namedParts.every((part) => part !== null)) {
             return `{ ${namedParts
-                .map((part) => `${formatTypeScriptProperty(part.name)}: ${clickhouseToTsType(part.type)}`)
+                .map((part) => `${formatTypeScriptProperty(part.name)}: ${clickhouseToTsType(part.type, onUnsupported)}`)
                 .join('; ')} }`;
         }
-        return `[${tupleParts.map((part) => clickhouseToTsType(part)).join(', ')}]`;
+        return `[${tupleParts.map((part) => clickhouseToTsType(part, onUnsupported)).join(', ')}]`;
     }
     const wrappedMapType = unwrapType(normalizedType, 'Map');
     if (wrappedMapType) {
@@ -198,7 +198,7 @@ export const clickhouseToTsType = (type) => {
         if (mapParts.length === 2) {
             const [, valueType] = mapParts;
             // JSON object keys are strings even when ClickHouse map keys are numeric.
-            return `Record<string, ${clickhouseToTsType(valueType)}>`;
+            return `Record<string, ${clickhouseToTsType(valueType, onUnsupported)}>`;
         }
         return 'Record<string, unknown>';
     }
@@ -206,5 +206,9 @@ export const clickhouseToTsType = (type) => {
     if (primitiveType)
         return primitiveType;
     // Unsupported or more complex ClickHouse types currently preserve the historical fallback.
+    try {
+        onUnsupported?.(normalizedType);
+    }
+    catch { /* Optional observers cannot change generated types. */ }
     return 'string';
 };

package/dist/utils/chdb-gitignore-entry.d.ts

@@ -0,0 +1,2 @@
+export declare function getChdbGitignoreEntry(chdbPath: string | undefined, cwd: string): string | undefined;
+//# sourceMappingURL=chdb-gitignore-entry.d.ts.map

package/dist/utils/chdb-gitignore-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chdb-gitignore-entry.d.ts","sourceRoot":"","sources":["../../src/utils/chdb-gitignore-entry.ts"],"names":[],"mappings":"AAEA,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAmBnG"}

package/dist/utils/chdb-gitignore-entry.js

@@ -0,0 +1,17 @@
+import path from 'node:path';
+export function getChdbGitignoreEntry(chdbPath, cwd) {
+    if (!chdbPath || /[\0\r\n]/.test(chdbPath)) {
+        return undefined;
+    }
+    cwd = path.resolve(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}/`;
+}

package/dist/utils/cli-version.d.ts

@@ -0,0 +1,2 @@
+export declare function getCliVersion(): string;
+//# sourceMappingURL=cli-version.d.ts.map

package/dist/utils/cli-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-version.d.ts","sourceRoot":"","sources":["../../src/utils/cli-version.ts"],"names":[],"mappings":"AAGA,wBAAgB,aAAa,IAAI,MAAM,CAKtC"}

package/dist/utils/cli-version.js

@@ -0,0 +1,11 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+export function getCliVersion() {
+    try {
+        const pkg = JSON.parse(readFileSync(fileURLToPath(new URL('../../package.json', import.meta.url)), 'utf8'));
+        return pkg.version ?? '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}

package/dist/utils/cloud-credential-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloud-credential-store.d.ts","sourceRoot":"","sources":["../../src/utils/cloud-credential-store.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,qBAAqB,CAAC;AAI7B,eAAO,MAAM,sBAAsB,kBAAkB,CAAC;AACtD,eAAO,MAAM,kBAAkB,qCAAqC,CAAC;AAGrE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,+BAA+B,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAYD,UAAU,YAAY;IACpB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,WAAW,IAAI,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtD,cAAc,IAAI,OAAO,CAAC;CAC3B;AAQD,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,KACZ,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;IAC1C,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;CACrC;AAyCD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAc1D;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAClB,MAAM,CAmBR;AAmFD,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,qBAAqB,EACjC,YAAY,GAAE,gCAAqC,iBAkEpD;AAED,wBAAsB,mBAAmB,CACvC,YAAY,GAAE,gCAAqC,GAClD,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAsBvC;AA0BD,wBAAsB,qBAAqB,CACzC,YAAY,GAAE,gCAAqC,iBA0BpD"}
+{"version":3,"file":"cloud-credential-store.d.ts","sourceRoot":"","sources":["../../src/utils/cloud-credential-store.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,qBAAqB,CAAC;AAI7B,eAAO,MAAM,sBAAsB,kBAAkB,CAAC;AACtD,eAAO,MAAM,kBAAkB,qCAAqC,CAAC;AAGrE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,+BAA+B,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAYD,UAAU,YAAY;IACpB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,WAAW,IAAI,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtD,cAAc,IAAI,OAAO,CAAC;CAC3B;AAQD,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,KACZ,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;IAC1C,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;CACrC;AA2BD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAc1D;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAClB,MAAM,CAmBR;AAmFD,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,qBAAqB,EACjC,YAAY,GAAE,gCAAqC,iBAkEpD;AAED,wBAAsB,mBAAmB,CACvC,YAAY,GAAE,gCAAqC,GAClD,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAsBvC;AA0BD,wBAAsB,qBAAqB,CACzC,YAAY,GAAE,gCAAqC,iBA0BpD"}

package/dist/utils/cloud-credential-store.js

@@ -1,24 +1,13 @@
 import { randomUUID } from 'node:crypto';
 import { chmod, mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
-import { homedir } from 'node:os';
 import path from 'node:path';
+import { configDirectory } from './config-directory.js';
 import { validateProtocolDeploymentReleaseTarget, } from '@hypequery/protocol';
 const KEYCHAIN_SERVICE = 'dev.hypequery.cli';
 const PROFILE_FILE = 'cloud-profile.json';
 export const CLOUD_DEPLOYMENT_SCOPE = 'deploy:submit';
 export const CLOUD_SOURCE_SCOPE = 'deploy:submit deploy:read-source';
 const MAX_KEYCHAIN_ACCOUNT_LENGTH = 2048;
-function defaultConfigDirectory(env, platform) {
-    if (env.HYPEQUERY_CONFIG_DIR)
-        return env.HYPEQUERY_CONFIG_DIR;
-    if (platform === 'win32') {
-        return path.join(env.APPDATA ?? env.LOCALAPPDATA ?? homedir(), 'hypequery');
-    }
-    if (platform === 'darwin') {
-        return path.join(homedir(), 'Library', 'Application Support', 'hypequery');
-    }
-    return path.join(env.XDG_CONFIG_HOME ?? path.join(homedir(), '.config'), 'hypequery');
-}
 function vaultUnavailable(error) {
     return new Error('The operating-system credential vault is unavailable. '
         + 'Install its keyring service or use HYPEQUERY_API_TOKEN for manual authentication.', { cause: error });
@@ -36,7 +25,7 @@ function paths(dependencies) {
     const env = dependencies.env ?? process.env;
     const platform = dependencies.platform ?? process.platform;
     const directory = dependencies.configDirectory
-        ?? defaultConfigDirectory(env, platform);
+        ?? configDirectory(env, platform);
     return { directory, profile: path.join(directory, PROFILE_FILE) };
 }
 export function normalizeCloudOrigin(input) {

package/dist/utils/command-exit.d.ts

@@ -0,0 +1,13 @@
+import type { ERROR_CODES, OUTCOMES } from './telemetry/domains.js';
+export declare class CommandExit extends Error {
+    readonly exitCode: number;
+    readonly outcome: typeof OUTCOMES[number];
+    readonly errorCode?: (typeof ERROR_CODES)[number] | undefined;
+    constructor(exitCode: number, outcome: typeof OUTCOMES[number], errorCode?: (typeof ERROR_CODES)[number] | undefined);
+}
+/** Only the executable installs this; standalone command calls preserve their legacy exits. */
+export declare function installCommandExitFinalizer(finish: (exit: CommandExit) => Promise<void>): () => void;
+export declare function exitWith(code: number, outcome?: CommandExit['outcome'], errorCode?: CommandExit['errorCode']): never;
+/** Signal-driven shutdown runs after the owning command's resource cleanup. */
+export declare function finishAndExit(code: number, outcome: CommandExit['outcome'], errorCode?: CommandExit['errorCode']): Promise<never>;
+//# sourceMappingURL=command-exit.d.ts.map

package/dist/utils/command-exit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-exit.d.ts","sourceRoot":"","sources":["../../src/utils/command-exit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEpE,qBAAa,WAAY,SAAQ,KAAK;IAElC,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,QAAQ,CAAC,MAAM,CAAC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAA,OAAO,WAAW,EAAC,MAAM,CAAC;gBAFtC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,QAAQ,CAAC,MAAM,CAAC,EAChC,SAAS,CAAC,EAAE,CAAA,OAAO,WAAW,EAAC,MAAM,CAAC,YAAA;CAElD;AAID,+FAA+F;AAC/F,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAGpG;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAW,CAAC,SAAS,CAAwC,EAAE,SAAS,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,GAAG,KAAK,CAG1J;AAED,+EAA+E;AAC/E,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAGvI"}

package/dist/utils/command-exit.js

@@ -0,0 +1,31 @@
+export class CommandExit extends Error {
+    exitCode;
+    outcome;
+    errorCode;
+    constructor(exitCode, outcome, errorCode) {
+        super('Command requested exit');
+        this.exitCode = exitCode;
+        this.outcome = outcome;
+        this.errorCode = errorCode;
+    }
+}
+let finalizer;
+/** Only the executable installs this; standalone command calls preserve their legacy exits. */
+export function installCommandExitFinalizer(finish) {
+    finalizer = finish;
+    return () => { if (finalizer === finish)
+        finalizer = undefined; };
+}
+export function exitWith(code, outcome = code === 0 ? 'cancelled' : 'failure', errorCode) {
+    if (finalizer)
+        throw new CommandExit(code, outcome, errorCode);
+    return process.exit(code);
+}
+/** Signal-driven shutdown runs after the owning command's resource cleanup. */
+export async function finishAndExit(code, outcome, errorCode) {
+    try {
+        await finalizer?.(new CommandExit(code, outcome, errorCode));
+    }
+    catch { /* Preserve exit semantics. */ }
+    return process.exit(code);
+}

package/dist/utils/config-directory.d.ts

@@ -0,0 +1,3 @@
+/** Shared location for CLI settings and the Cloud credential profile. */
+export declare function configDirectory(env: Readonly<Record<string, string | undefined>>, platform: NodeJS.Platform, home?: string): string;
+//# sourceMappingURL=config-directory.d.ts.map

package/dist/utils/config-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-directory.d.ts","sourceRoot":"","sources":["../../src/utils/config-directory.ts"],"names":[],"mappings":"AAGA,yEAAyE;AACzE,wBAAgB,eAAe,CAC7B,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,EACjD,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,IAAI,SAAY,GACf,MAAM,CASR"}

package/dist/utils/config-directory.js

@@ -0,0 +1,14 @@
+import { homedir } from 'node:os';
+import path from 'node:path';
+/** Shared location for CLI settings and the Cloud credential profile. */
+export function configDirectory(env, platform, home = homedir()) {
+    if (env.HYPEQUERY_CONFIG_DIR)
+        return env.HYPEQUERY_CONFIG_DIR;
+    if (platform === 'win32') {
+        return path.join(env.APPDATA ?? env.LOCALAPPDATA ?? home, 'hypequery');
+    }
+    if (platform === 'darwin') {
+        return path.join(home, 'Library', 'Application Support', 'hypequery');
+    }
+    return path.join(env.XDG_CONFIG_HOME ?? path.join(home, '.config'), 'hypequery');
+}

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

@@ -0,0 +1,3 @@
+/** Detect backend intent without reading values into diagnostics or contacting a server. */
+export declare function detectDatabaseFromEnvironment(env: Readonly<Record<string, string | undefined>>): 'clickhouse' | 'bigquery' | undefined;
+//# sourceMappingURL=detect-database-environment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detect-database-environment.d.ts","sourceRoot":"","sources":["../../src/utils/detect-database-environment.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAChD,YAAY,GAAG,UAAU,GAAG,SAAS,CAIvC"}

package/dist/utils/detect-database-environment.js

@@ -0,0 +1,8 @@
+/** Detect backend intent without reading values into diagnostics or contacting a server. */
+export function detectDatabaseFromEnvironment(env) {
+    if (env.CLICKHOUSE_HOST || env.CLICKHOUSE_URL || env.CLICKHOUSE_DATABASE)
+        return 'clickhouse';
+    if (env.BIGQUERY_PROJECT_ID || env.GOOGLE_APPLICATION_CREDENTIALS)
+        return 'bigquery';
+    return undefined;
+}

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":"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"}
+{"version":3,"file":"detect-database.d.ts","sourceRoot":"","sources":["../../src/utils/detect-database.ts"],"names":[],"mappings":"AAMA;;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,CA8C5D;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

@@ -2,19 +2,15 @@ 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';
+import { detectDatabaseFromEnvironment } from './detect-database-environment.js';
 /**
  * Auto-detect database type from environment or config files
  */
 export async function detectDatabase() {
     // Check environment variables
-    if (process.env.CLICKHOUSE_HOST ||
-        process.env.CLICKHOUSE_URL ||
-        process.env.CLICKHOUSE_DATABASE) {
-        return 'clickhouse';
-    }
-    if (process.env.BIGQUERY_PROJECT_ID || process.env.GOOGLE_APPLICATION_CREDENTIALS) {
-        return 'bigquery';
-    }
+    const detected = detectDatabaseFromEnvironment(process.env);
+    if (detected)
+        return detected;
     // Check for .env file and parse it
     try {
         const envPath = path.join(process.cwd(), '.env');

package/dist/utils/init-options.d.ts

@@ -0,0 +1,11 @@
+import type { InitOptions } from '../commands/init.js';
+import type { InitStyle } from './prompts.js';
+import type { AuthTemplateMode } from '../templates/queries.js';
+import type { DatabaseType } from './detect-database.js';
+type InitDatabase = Extract<DatabaseType, 'clickhouse' | 'chdb'>;
+export declare function normalizeInitDatabase(database: InitOptions['database']): InitDatabase;
+export declare function normalizeInitStyle(style: InitOptions['style']): InitStyle;
+export declare function normalizeAuthMode(auth: InitOptions['auth']): AuthTemplateMode;
+export declare function parseTableList(value: string | undefined): string[] | undefined;
+export {};
+//# sourceMappingURL=init-options.d.ts.map

package/dist/utils/init-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-options.d.ts","sourceRoot":"","sources":["../../src/utils/init-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,KAAK,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAAC,CAAC;AAEjE,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,GAAG,YAAY,CAQrF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,SAAS,CAEzE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,gBAAgB,CAQ7E;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,GAAG,SAAS,CAO9E"}

package/dist/utils/init-options.js

@@ -0,0 +1,28 @@
+export function normalizeInitDatabase(database) {
+    if (!database || database === 'clickhouse') {
+        return 'clickhouse';
+    }
+    if (database === 'chdb') {
+        return 'chdb';
+    }
+    throw new Error(`Unsupported database "${database}". Use "clickhouse" or "chdb".`);
+}
+export function normalizeInitStyle(style) {
+    return style === 'datasets' ? 'datasets' : 'queries';
+}
+export function normalizeAuthMode(auth) {
+    if (!auth || auth === 'none') {
+        return 'none';
+    }
+    if (auth === 'context') {
+        return 'context';
+    }
+    throw new Error(`Unsupported auth mode "${auth}". Use "none" or "context".`);
+}
+export function parseTableList(value) {
+    const parsed = value
+        ?.split(',')
+        .map((table) => table.trim())
+        .filter(Boolean);
+    return parsed && parsed.length > 0 ? parsed : undefined;
+}

package/dist/utils/load-api.d.ts

@@ -1,4 +1,6 @@
 export declare function loadApiModule(modulePath: string): Promise<any>;
 export declare function loadModule(modulePath: string): Promise<any>;
+/** Remove this process's bundles; the CLI awaits this before it exits. */
+export declare function cleanupLoadedApiArtifacts(): Promise<void>;
 export declare function findNearestTsconfig(filePath: string): Promise<string | null>;
 //# sourceMappingURL=load-api.d.ts.map

package/dist/utils/load-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-api.d.ts","sourceRoot":"","sources":["../../src/utils/load-api.ts"],"names":[],"mappings":"AAaA,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,gBA2DrD;AAED,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,gBAkClD;AA0JD,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,0BA8BzD"}
+{"version":3,"file":"load-api.d.ts","sourceRoot":"","sources":["../../src/utils/load-api.ts"],"names":[],"mappings":"AAgBA,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,gBA2DrD;AAED,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,gBAwClD;AAuED,0EAA0E;AAC1E,wBAAsB,yBAAyB,kBAE9C;AAqED,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,0BA8BzD"}

package/dist/utils/load-api.js

@@ -1,8 +1,11 @@
 import { pathToFileURL } from 'node:url';
-import { access, mkdtemp, rm, mkdir, writeFile } from 'node:fs/promises';
+import { rmdirSync, rmSync } from 'node:fs';
+import { access, mkdtemp, mkdir, writeFile } from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
 import { build } from 'esbuild';
+import { loadEnvFiles } from './load-env-files.js';
+import { findProjectRoot } from './project-root.js';
 if (typeof process.setMaxListeners === 'function') {
     process.setMaxListeners(0);
 }
@@ -68,6 +71,11 @@ export async function loadModule(modulePath) {
         const relativePath = path.relative(process.cwd(), resolved);
         throw new Error(`File not found: ${relativePath}`);
     }
+    // The CLI loaded the launch directory's env files at startup. An entry in
+    // another project (`hypequery mcp /abs/path/api.ts`) reads its connection
+    // settings from that project's env files, so load those too before its
+    // client module runs. Values already set keep precedence.
+    await loadEnvFiles(await findProjectRoot(resolved));
     const extension = path.extname(resolved).toLowerCase();
     const isTypeScript = TYPESCRIPT_EXTENSIONS.has(extension);
     const moduleUrl = isTypeScript
@@ -92,23 +100,26 @@ export async function loadModule(modulePath) {
     }
 }
 const globalState = globalThis;
-let tempDirPromise = globalState.__hypequeryCliTempDirPromise ?? null;
-const tempFiles = globalState.__hypequeryCliTempFiles ?? new Set();
-const tempDirs = globalState.__hypequeryCliTempDirs ?? new Set();
+// One bundle directory per project root, keyed by that root.
+const tempDirPromises = globalState.__hypequeryCliTempDirPromises ??= new Map();
+const tempFiles = globalState.__hypequeryCliTempFiles ??= new Set();
+const tempDirs = globalState.__hypequeryCliTempDirs ??= new Set();
+const tempRoots = globalState.__hypequeryCliTempRoots ??= new Set();
 let cleanupHooksInstalled = globalState.__hypequeryCliCleanupInstalled ?? false;
-if (!globalState.__hypequeryCliTempFiles) {
-    globalState.__hypequeryCliTempFiles = tempFiles;
-}
-if (!globalState.__hypequeryCliTempDirs) {
-    globalState.__hypequeryCliTempDirs = tempDirs;
-}
-function ensureTempDir() {
+/**
+ * The bundle has to live inside the entry's project: its bare imports
+ * (`@hypequery/serve`, ...) resolve from the bundle's location, and the
+ * process's working directory may be anywhere (MCP clients launch from `/`).
+ */
+function ensureTempDir(projectRoot) {
     installCleanupHooks();
-    if (!tempDirPromise) {
-        tempDirPromise = (async () => {
-            const projectTempRoot = path.join(process.cwd(), '.hypequery', 'tmp');
+    let promise = tempDirPromises.get(projectRoot);
+    if (!promise) {
+        promise = (async () => {
+            const projectTempRoot = path.join(projectRoot, '.hypequery', 'tmp');
             try {
                 await mkdir(projectTempRoot, { recursive: true });
+                tempRoots.add(projectTempRoot);
                 const dir = await mkdtemp(path.join(projectTempRoot, 'bundle-'));
                 tempDirs.add(dir);
                 return dir;
@@ -119,65 +130,53 @@ function ensureTempDir() {
                 return fallbackDir;
             }
         })();
-        globalState.__hypequeryCliTempDirPromise = tempDirPromise;
+        tempDirPromises.set(projectRoot, promise);
     }
-    return tempDirPromise;
+    return promise;
 }
-async function cleanupTempFiles() {
-    if (tempFiles.size === 0)
-        return;
-    await Promise.all(Array.from(tempFiles).map(async (file) => {
+// Synchronous so it completes inside an 'exit' handler.
+function cleanupTempArtifacts() {
+    for (const target of [...tempFiles, ...tempDirs]) {
         try {
-            await rm(file, { force: true });
+            rmSync(target, { recursive: true, force: true });
         }
         catch {
             // ignore cleanup failures
         }
-    }));
+    }
     tempFiles.clear();
-}
-async function cleanupTempDirs() {
-    if (tempDirs.size === 0)
-        return;
-    await Promise.all(Array.from(tempDirs).map(async (dir) => {
+    tempDirs.clear();
+    tempDirPromises.clear();
+    // Only remove the shared tmp root once empty: another hypequery process in the
+    // same project (e.g. `hypequery dev` beside an MCP client) may still use it.
+    for (const root of tempRoots) {
         try {
-            await rm(dir, { recursive: true, force: true });
+            rmdirSync(root);
         }
         catch {
-            // ignore cleanup failures
+            // not empty or already gone
         }
-    }));
-    tempDirs.clear();
-    const projectTempRoot = path.join(process.cwd(), '.hypequery', 'tmp');
-    try {
-        await rm(projectTempRoot, { recursive: true, force: true });
-    }
-    catch {
-        // ignore cleanup failures
     }
+    tempRoots.clear();
 }
-async function cleanupTempArtifacts() {
-    await cleanupTempFiles();
-    await cleanupTempDirs();
+/** Remove this process's bundles; the CLI awaits this before it exits. */
+export async function cleanupLoadedApiArtifacts() {
+    cleanupTempArtifacts();
 }
 function installCleanupHooks() {
     if (cleanupHooksInstalled)
         return;
     cleanupHooksInstalled = true;
     globalState.__hypequeryCliCleanupInstalled = true;
-    process.once('exit', () => {
-        cleanupTempArtifacts().catch(() => undefined);
-    });
-    ['SIGINT', 'SIGTERM'].forEach(signal => {
-        process.once(signal, () => {
-            cleanupTempArtifacts().catch(() => undefined);
-            process.exit();
-        });
-    });
+    // Synchronous, so it still completes when this is the last thing to run.
+    process.once('exit', cleanupTempArtifacts);
+    // Signal shutdown belongs to the CLI/owning server. Exiting from a module
+    // cleanup listener bypassed server teardown and the bounded telemetry flush.
 }
 async function bundleTypeScriptModule(entryPath) {
     const relativePath = path.relative(process.cwd(), entryPath);
     const tsconfigPath = await findNearestTsconfig(entryPath);
+    const projectRoot = await findProjectRoot(entryPath);
     try {
         const result = await build({
             entryPoints: [entryPath],
@@ -188,7 +187,7 @@ async function bundleTypeScriptModule(entryPath) {
             sourcemap: 'inline',
             write: false,
             logLevel: 'silent',
-            absWorkingDir: process.cwd(),
+            absWorkingDir: projectRoot,
             packages: 'external',
             tsconfig: tsconfigPath ?? undefined,
             loader: {
@@ -202,7 +201,7 @@ async function bundleTypeScriptModule(entryPath) {
         if (!output) {
             throw new Error('esbuild produced no output');
         }
-        const tempDir = await ensureTempDir();
+        const tempDir = await ensureTempDir(projectRoot);
         const timestamp = Date.now();
         const tempFile = path.join(tempDir, `${path.basename(entryPath, path.extname(entryPath))}-${timestamp}.mjs`);
         const contents = `${output.text}\n` +

package/dist/utils/load-env-files.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Loads the `.env*` cascade from `directory` into `process.env`.
+ *
+ * `dotenv` never overwrites a variable that is already set, so a real
+ * environment variable beats every file, and a directory loaded earlier (the
+ * launch directory, at startup) beats one loaded later. Each directory is read
+ * once per process; `hypequery dev` reloads the API on every change.
+ */
+export declare function loadEnvFiles(directory: string): Promise<void>;
+//# sourceMappingURL=load-env-files.d.ts.map

package/dist/utils/load-env-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-env-files.d.ts","sourceRoot":"","sources":["../../src/utils/load-env-files.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAcnE"}

package/dist/utils/load-env-files.js

@@ -0,0 +1,27 @@
+import path from 'node:path';
+import { envFiles } from './env-files.js';
+const loadedDirectories = new Set();
+/**
+ * Loads the `.env*` cascade from `directory` into `process.env`.
+ *
+ * `dotenv` never overwrites a variable that is already set, so a real
+ * environment variable beats every file, and a directory loaded earlier (the
+ * launch directory, at startup) beats one loaded later. Each directory is read
+ * once per process; `hypequery dev` reloads the API on every change.
+ */
+export async function loadEnvFiles(directory) {
+    const resolved = path.resolve(directory);
+    if (loadedDirectories.has(resolved))
+        return;
+    loadedDirectories.add(resolved);
+    try {
+        const { config } = await import('dotenv');
+        for (const file of envFiles(process.env.NODE_ENV)) {
+            // Missing files are a no-op.
+            config({ path: path.join(resolved, file) });
+        }
+    }
+    catch {
+        // dotenv is optional; continue if not available
+    }
+}

package/dist/utils/project-root.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Finds the directory that owns `filePath`: the nearest ancestor with a
+ * `package.json`, or the file's own directory when there is none. Bare imports
+ * in the file resolve from here, whatever the process's working directory is.
+ */
+export declare function findProjectRoot(filePath: string): Promise<string>;
+/**
+ * Imports `specifier` as `fromFile` would see it, so a package installed in the
+ * user's project is found even when the CLI runs from elsewhere (for example
+ * through `npx -y @hypequery/cli`). Falls back to `fallback` — the CLI's own
+ * resolution — when the project does not have the package.
+ */
+export declare function importFromProject<T>(specifier: string, fromFile: string, fallback: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=project-root.d.ts.map

package/dist/utils/project-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-root.d.ts","sourceRoot":"","sources":["../../src/utils/project-root.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAcvE;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,CAAC,CAAC,CAQZ"}

package/dist/utils/project-root.js

@@ -0,0 +1,41 @@
+import { access } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+/**
+ * Finds the directory that owns `filePath`: the nearest ancestor with a
+ * `package.json`, or the file's own directory when there is none. Bare imports
+ * in the file resolve from here, whatever the process's working directory is.
+ */
+export async function findProjectRoot(filePath) {
+    const start = path.dirname(path.resolve(filePath));
+    let dir = start;
+    while (true) {
+        try {
+            await access(path.join(dir, 'package.json'));
+            return dir;
+        }
+        catch {
+            const parent = path.dirname(dir);
+            if (parent === dir)
+                return start;
+            dir = parent;
+        }
+    }
+}
+/**
+ * Imports `specifier` as `fromFile` would see it, so a package installed in the
+ * user's project is found even when the CLI runs from elsewhere (for example
+ * through `npx -y @hypequery/cli`). Falls back to `fallback` — the CLI's own
+ * resolution — when the project does not have the package.
+ */
+export async function importFromProject(specifier, fromFile, fallback) {
+    let resolved;
+    try {
+        resolved = createRequire(path.resolve(fromFile)).resolve(specifier);
+    }
+    catch {
+        return fallback();
+    }
+    return import(/* @vite-ignore */ pathToFileURL(resolved).href);
+}

package/dist/utils/telemetry/buckets.d.ts

@@ -0,0 +1,5 @@
+import { COUNT_BUCKETS, DURATION_BUCKETS } from './domains.js';
+/** Invalid measurements are omitted rather than coerced into a misleading bucket. */
+export declare function countBucket(count: number): typeof COUNT_BUCKETS[number] | undefined;
+export declare function durationBucket(milliseconds: number): typeof DURATION_BUCKETS[number] | undefined;
+//# sourceMappingURL=buckets.d.ts.map

package/dist/utils/telemetry/buckets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buckets.d.ts","sourceRoot":"","sources":["../../../src/utils/telemetry/buckets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE/D,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,CAQnF;AAED,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,gBAAgB,CAAC,MAAM,CAAC,GAAG,SAAS,CAIhG"}