@hypequery/cli 1.21.2 → 1.23.0

package/dist/generators/clickhouse.d.ts

@@ -1,8 +1,10 @@
-import { clickhouseToTsType } from '../typegen/index.js';
+import { clickhouseToTsType, type GenerateTypesOptions } from '../typegen/index.js';
 export interface ClickHouseGeneratorOptions {
     outputPath: string;
     includeTables?: string[];
     excludeTables?: string[];
+    onColumn?: GenerateTypesOptions['onColumn'];
+    onUnsupportedType?: GenerateTypesOptions['onUnsupportedType'];
 }
 export { clickhouseToTsType };
 export declare function generateClickHouseTypes(options: ClickHouseGeneratorOptions): Promise<string[]>;

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

@@ -1 +1 @@
-{"version":3,"file":"clickhouse.d.ts","sourceRoot":"","sources":["../../src/generators/clickhouse.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAGnB,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,0BAA0B,qBAUhF"}
+{"version":3,"file":"clickhouse.d.ts","sourceRoot":"","sources":["../../src/generators/clickhouse.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAElB,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAC5C,iBAAiB,CAAC,EAAE,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;CAC/D;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,0BAA0B,qBAYhF"}

package/dist/generators/clickhouse.js

@@ -6,6 +6,8 @@ export async function generateClickHouseTypes(options) {
         client: getClickHouseClient(),
         generatedBy: 'hypequery',
         includeUsageExample: false,
+        ...(options.onColumn ? { onColumn: options.onColumn } : {}),
+        ...(options.onUnsupportedType ? { onUnsupportedType: options.onUnsupportedType } : {}),
         ...(options.includeTables ? { includeTables: options.includeTables } : {}),
         ...(options.excludeTables ? { excludeTables: options.excludeTables } : {}),
     };

package/dist/test-utils.d.ts

@@ -8,7 +8,7 @@ export declare class ProcessExitError extends Error {
     constructor(code: number);
 }
 export declare function mockProcessExit(): {
-    exitMock: Mock<(...args: any[]) => any>;
+    exitMock: Mock;
     restore: () => void;
 };
 //# sourceMappingURL=test-utils.d.ts.map

package/dist/typegen/generate-types.d.ts

@@ -33,6 +33,9 @@ export interface GenerateTypesOptions {
     generatedBy?: string;
     /** Append the historical usage-example comment block. */
     includeUsageExample?: boolean;
+    /** Optional aggregate-observation hooks; errors never affect generation. */
+    onColumn?: () => void;
+    onUnsupportedType?: (type: string) => void;
 }
 /**
  * Generates the TypeScript type definition source from a ClickHouse client.

package/dist/typegen/generate-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-types.d.ts","sourceRoot":"","sources":["../../src/typegen/generate-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C,KAAK,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,aAAa,CAAA;KAAE,GAAG,OAAO,CAAC;QAChE,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;KAChD,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,qCAAqC;IACrC,MAAM,EAAE,8BAA8B,CAAC;IACvC,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AA0HD;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,8BAA8B,EACtC,OAAO,GAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAM,GACjD,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,MAAM,EAAE,CAAC,CAYnB"}
+{"version":3,"file":"generate-types.d.ts","sourceRoot":"","sources":["../../src/typegen/generate-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C,KAAK,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,aAAa,CAAA;KAAE,GAAG,OAAO,CAAC;QAChE,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;KAChD,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,qCAAqC;IACrC,MAAM,EAAE,8BAA8B,CAAC;IACvC,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C;AA2HD;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,8BAA8B,EACtC,OAAO,GAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAM,GACjD,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,MAAM,EAAE,CAAC,CAYnB"}

package/dist/typegen/generate-types.js

@@ -72,7 +72,11 @@ export interface IntrospectedSchema {`;
         const columns = await describeTable(client, table.name);
         typeDefinitions += `export interface ${capitalizeFirstLetter(table.name)}Record {`;
         for (const column of columns) {
-            const tsType = clickhouseToTsType(column.type);
+            try {
+                options.onColumn?.();
+            }
+            catch { /* Preserve type output. */ }
+            const tsType = clickhouseToTsType(column.type, options.onUnsupportedType);
             typeDefinitions += `\n  '${column.name}': ${tsType};`;
         }
         typeDefinitions += '\n}\n\n';

package/dist/typegen/type-parsing.d.ts

@@ -2,5 +2,5 @@
  * Converts a ClickHouse type string, as returned by `DESCRIBE TABLE`, into the
  * equivalent TypeScript type string.
  */
-export declare const clickhouseToTsType: (type: string) => string;
+export declare const clickhouseToTsType: (type: string, onUnsupported?: (type: string) => void) => string;
 //# sourceMappingURL=type-parsing.d.ts.map

package/dist/typegen/type-parsing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type-parsing.d.ts","sourceRoot":"","sources":["../../src/typegen/type-parsing.ts"],"names":[],"mappings":"AAwLA;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,MA6CjD,CAAC"}
+{"version":3,"file":"type-parsing.d.ts","sourceRoot":"","sources":["../../src/typegen/type-parsing.ts"],"names":[],"mappings":"AAwLA;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,EAAE,gBAAgB,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,KAAG,MA8CzF,CAAC"}

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/deployment-target.d.ts

@@ -0,0 +1,7 @@
+import { type ProtocolDeploymentReleaseTarget } from '@hypequery/protocol';
+import type { StoredCloudCredential } from './cloud-credential-store.js';
+export declare function deploymentTargetFromOptions(options: {
+    readonly project?: string;
+    readonly environment?: string;
+}, credential: StoredCloudCredential | undefined): ProtocolDeploymentReleaseTarget;
+//# sourceMappingURL=deployment-target.d.ts.map

package/dist/utils/deployment-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-target.d.ts","sourceRoot":"","sources":["../../src/utils/deployment-target.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEzE,wBAAgB,2BAA2B,CACzC,OAAO,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EACrE,UAAU,EAAE,qBAAqB,GAAG,SAAS,GAC5C,+BAA+B,CAkBjC"}

package/dist/utils/deployment-target.js

@@ -0,0 +1,19 @@
+import { validateProtocolDeploymentReleaseTarget, } from '@hypequery/protocol';
+export function deploymentTargetFromOptions(options, credential) {
+    if ((options.project === undefined) !== (options.environment === undefined)) {
+        throw new Error('Pass both --project and --environment, or omit both.');
+    }
+    const input = options.project === undefined
+        ? credential?.target
+        : { project: options.project, environment: options.environment };
+    if (!input) {
+        throw new Error('Missing deployment target. Run `hypequery login` or pass both '
+            + '--project and --environment.');
+    }
+    try {
+        return validateProtocolDeploymentReleaseTarget(input);
+    }
+    catch {
+        throw new Error('The deployment target is invalid.');
+    }
+}

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/hosted-endpoints-output.d.ts

@@ -0,0 +1,4 @@
+import { type HostedEndpoints } from './hosted-endpoints.js';
+/** Print Cloud's URLs without ever reading or writing runtime API keys. */
+export declare function printHostedEndpoints(endpoints: HostedEndpoints, mcpConfig: boolean): void;
+//# sourceMappingURL=hosted-endpoints-output.d.ts.map

package/dist/utils/hosted-endpoints-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-endpoints-output.d.ts","sourceRoot":"","sources":["../../src/utils/hosted-endpoints-output.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAE/B,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAqBzF"}

package/dist/utils/hosted-endpoints-output.js

@@ -0,0 +1,27 @@
+import { logger } from './logger.js';
+import { MCP_API_KEY_VARIABLE, mcpClientConfiguration, } from './hosted-endpoints.js';
+/** Print Cloud's URLs without ever reading or writing runtime API keys. */
+export function printHostedEndpoints(endpoints, mcpConfig) {
+    logger.newline();
+    logger.info('Hosted endpoints');
+    logger.indent(`REST  ${endpoints.rest.baseUrl}`);
+    const width = Math.max(0, ...endpoints.rest.datasets.map((dataset) => dataset.name.length));
+    for (const dataset of endpoints.rest.datasets) {
+        logger.indent(`  ${dataset.name.padEnd(width)}  POST ${dataset.url}`);
+    }
+    logger.indent(`MCP   ${endpoints.mcp.url}`);
+    logger.newline();
+    if (endpoints.active) {
+        logger.info(`Set ${MCP_API_KEY_VARIABLE} from your secret store. Check MCP without running a query:`);
+        logger.indent(`hypequery mcp --self-test --url ${endpoints.mcp.url}`);
+    }
+    else {
+        logger.info('These URLs will serve the target after a release is live.');
+    }
+    if (mcpConfig) {
+        logger.newline();
+        logger.info(`MCP client configuration (the client reads the key from ${MCP_API_KEY_VARIABLE}):`);
+        for (const line of mcpClientConfiguration(endpoints.mcp.url).split('\n'))
+            logger.indent(line);
+    }
+}

package/dist/utils/hosted-endpoints.d.ts

@@ -0,0 +1,37 @@
+import type { ProtocolDeploymentReleaseTarget } from '@hypequery/protocol';
+import { type LiveDeploymentFetch } from './live-deployment.js';
+/** Where Cloud serves a deployed target. Cloud owns this layout, not the CLI. */
+export type HostedEndpoints = {
+    readonly active: boolean;
+    readonly rest: {
+        readonly baseUrl: string;
+        readonly datasets: readonly {
+            readonly name: string;
+            readonly url: string;
+        }[];
+    };
+    readonly mcp: {
+        readonly url: string;
+    };
+};
+export declare function parseHostedEndpoints(input: unknown): HostedEndpoints | undefined;
+/**
+ * Asks Cloud where the target is served. Never throws: the deployment has
+ * already succeeded, so an older Cloud (404), a network failure, or an
+ * unexpected response just means there is nothing to print.
+ */
+export declare function fetchHostedEndpoints(input: {
+    readonly endpoint: string;
+    readonly token: string;
+    readonly target: ProtocolDeploymentReleaseTarget;
+    readonly fetch?: LiveDeploymentFetch;
+}): Promise<HostedEndpoints | undefined>;
+/** The environment variable generated configuration reads the key from. */
+export declare const MCP_API_KEY_VARIABLE = "HYPEQUERY_API_KEY";
+/**
+ * Client configuration for the hosted MCP endpoint. The key is a placeholder
+ * the client expands from its environment: the CLI never writes a credential
+ * into anything it prints.
+ */
+export declare function mcpClientConfiguration(mcpUrl: string): string;
+//# sourceMappingURL=hosted-endpoints.d.ts.map

package/dist/utils/hosted-endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-endpoints.d.ts","sourceRoot":"","sources":["../../src/utils/hosted-endpoints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAW,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAIzE,iFAAiF;AACjF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS;YAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KAC/E,CAAC;IACF,QAAQ,CAAC,GAAG,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACxC,CAAC;AAYF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAkBhF;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,+BAA+B,CAAC;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,mBAAmB,CAAC;CACtC,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAiBvC;AAED,2EAA2E;AAC3E,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AAExD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAc7D"}

package/dist/utils/hosted-endpoints.js

@@ -0,0 +1,81 @@
+import { liveUrl } from './live-deployment.js';
+const MAX_RESPONSE_BYTES = 256 * 1024;
+function httpUrl(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    try {
+        const url = new URL(value);
+        return url.protocol === 'https:' || url.protocol === 'http:' ? url.toString() : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function parseHostedEndpoints(input) {
+    if (typeof input !== 'object' || input === null)
+        return undefined;
+    const value = input;
+    if (value.kind !== 'hypequery-hosted-endpoints' || value.version !== 1)
+        return undefined;
+    const baseUrl = httpUrl(value.rest?.baseUrl);
+    const mcp = httpUrl(value.mcp?.url);
+    if (!baseUrl || !mcp || !Array.isArray(value.rest?.datasets))
+        return undefined;
+    const datasets = [];
+    for (const dataset of value.rest.datasets) {
+        const url = httpUrl(dataset?.url);
+        if (typeof dataset?.name !== 'string' || !url)
+            return undefined;
+        datasets.push(Object.freeze({ name: dataset.name, url }));
+    }
+    return Object.freeze({
+        active: value.active === true,
+        rest: Object.freeze({ baseUrl, datasets: Object.freeze(datasets) }),
+        mcp: Object.freeze({ url: mcp }),
+    });
+}
+/**
+ * Asks Cloud where the target is served. Never throws: the deployment has
+ * already succeeded, so an older Cloud (404), a network failure, or an
+ * unexpected response just means there is nothing to print.
+ */
+export async function fetchHostedEndpoints(input) {
+    try {
+        const url = liveUrl(input.endpoint, input.target, 'endpoints');
+        if (!url)
+            return undefined;
+        const response = await (input.fetch ?? fetch)(url, {
+            method: 'GET',
+            headers: { Accept: 'application/json', Authorization: `Bearer ${input.token}` },
+            redirect: 'error',
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!response.ok)
+            return undefined;
+        const bytes = new Uint8Array(await response.arrayBuffer());
+        if (bytes.byteLength > MAX_RESPONSE_BYTES)
+            return undefined;
+        return parseHostedEndpoints(JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes)));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The environment variable generated configuration reads the key from. */
+export const MCP_API_KEY_VARIABLE = 'HYPEQUERY_API_KEY';
+/**
+ * Client configuration for the hosted MCP endpoint. The key is a placeholder
+ * the client expands from its environment: the CLI never writes a credential
+ * into anything it prints.
+ */
+export function mcpClientConfiguration(mcpUrl) {
+    return JSON.stringify({
+        mcpServers: {
+            hypequery: {
+                type: 'http',
+                url: mcpUrl,
+                headers: { Authorization: `Bearer \${${MCP_API_KEY_VARIABLE}}` },
+            },
+        },
+    }, null, 2);
+}

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/live-deployment.d.ts

@@ -26,6 +26,12 @@ export type LiveDeployment = {
     };
 };
 export type LiveDeploymentFetch = typeof fetch;
+/**
+ * The Cloud target resource beside a submissions endpoint, or undefined when
+ * the endpoint is not a Cloud submissions URL. Refuses anything but https (or
+ * loopback http) so a credential is never sent in the clear.
+ */
+export declare function liveUrl(endpoint: string, target: ProtocolDeploymentReleaseTarget, resource: 'state' | 'source' | 'endpoints'): string | undefined;
 export declare function fetchLiveDeployment(input: {
     readonly endpoint: string;
     readonly token: string;

package/dist/utils/live-deployment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"live-deployment.d.ts","sourceRoot":"","sources":["../../src/utils/live-deployment.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,+BAA+B,EACrC,MAAM,qBAAqB,CAAC;AAO7B,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;QACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;KACzB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,MAAM,EAAE,+BAA+B,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG;QACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;QACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;QAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC;KACxC,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,OAAO,KAAK,CAAC;AA8K/C,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,+BAA+B,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAAC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,mBAAmB,CAAC;CACtC,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAuCtC"}
+{"version":3,"file":"live-deployment.d.ts","sourceRoot":"","sources":["../../src/utils/live-deployment.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,+BAA+B,EACrC,MAAM,qBAAqB,CAAC;AAO7B,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;QACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;KACzB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,MAAM,EAAE,+BAA+B,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG;QACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;QACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;QAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC;KACxC,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,OAAO,KAAK,CAAC;AAE/C;;;;GAIG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,+BAA+B,EACvC,QAAQ,EAAE,OAAO,GAAG,QAAQ,GAAG,WAAW,GACzC,MAAM,GAAG,SAAS,CAkBpB;AAsJD,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,+BAA+B,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAAC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,mBAAmB,CAAC;CACtC,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAuCtC"}