@hypequery/cli 1.1.2 → 1.2.1

package/dist/templates/auth-scaffold.js

@@ -0,0 +1,41 @@
+/**
+ * Type guards that pull a trusted `HostUser` off the underlying request. The
+ * host framework is expected to have already authenticated the request and
+ * attached the user to `request.raw.user`.
+ */
+export const hostUserHelpers = `type HostUser = {
+  id: string;
+  orgId: string;
+  roles?: string[];
+};
+
+const isRecord = (value: unknown): value is Record<string, unknown> =>
+  typeof value === 'object' && value !== null;
+
+const isHostUser = (value: unknown): value is HostUser => {
+  if (!isRecord(value)) return false;
+  const roles = value.roles;
+  return typeof value.id === 'string' &&
+    typeof value.orgId === 'string' &&
+    (roles === undefined || (Array.isArray(roles) && roles.every((role) => typeof role === 'string')));
+};
+
+const getUserFromRequest = (raw: unknown): HostUser | null => {
+  const user = isRecord(raw) ? raw.user : null;
+  return isHostUser(user) ? user : null;
+};`;
+/**
+ * The `auth` + `tenant` config block wired to {@link hostUserHelpers}.
+ * Indented two spaces so it drops straight into the config object literal.
+ */
+export const contextAuthConfig = `  auth: fromContext(({ request }) => {
+    const user = getUserFromRequest(request.raw);
+    return user
+      ? { userId: user.id, tenantId: user.orgId, roles: user.roles }
+      : null;
+  }),
+  tenant: {
+    extract: (auth: { tenantId?: string }) => auth.tenantId,
+    column: 'tenant_id',
+    mode: 'auto-inject',
+  },`;

package/dist/templates/client.js

@@ -2,5 +2,14 @@
  * Generate client.ts file for ClickHouse
  */
 export function generateClientTemplate() {
-    return "import { createQueryBuilder } from '@hypequery/clickhouse';\nimport type { IntrospectedSchema } from './schema.js';\n\nexport const db = createQueryBuilder<IntrospectedSchema>({\n  url: process.env.CLICKHOUSE_URL ?? process.env.CLICKHOUSE_HOST!,\n  database: process.env.CLICKHOUSE_DATABASE!,\n  username: process.env.CLICKHOUSE_USERNAME!,\n  password: process.env.CLICKHOUSE_PASSWORD,\n});\n";
+    return `import { createQueryBuilder } from '@hypequery/clickhouse';
+import type { IntrospectedSchema } from './schema.js';
+
+export const db = createQueryBuilder<IntrospectedSchema>({
+  url: process.env.CLICKHOUSE_URL ?? process.env.CLICKHOUSE_HOST!,
+  database: process.env.CLICKHOUSE_DATABASE!,
+  username: process.env.CLICKHOUSE_USERNAME!,
+  password: process.env.CLICKHOUSE_PASSWORD,
+});
+`;
 }

package/dist/templates/datasets.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generate placeholder datasets.ts file for no-connection init.
+ */
+export declare function generateDatasetsPlaceholderTemplate(): string;
+//# sourceMappingURL=datasets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"datasets.d.ts","sourceRoot":"","sources":["../../src/templates/datasets.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,mCAAmC,IAAI,MAAM,CAmB5D"}

package/dist/templates/datasets.js

@@ -0,0 +1,23 @@
+/**
+ * Generate placeholder datasets.ts file for no-connection init.
+ */
+export function generateDatasetsPlaceholderTemplate() {
+    return `import { dataset, dimension, measure } from '@hypequery/datasets';
+
+const exampleEvents = dataset('example_events', {
+  source: 'example_events',
+  timeKey: 'created_at',
+  dimensions: {
+    id: dimension.string(),
+    createdAt: dimension.timestamp({ column: 'created_at' }),
+  },
+  measures: {
+    eventCount: measure.count('id', { label: 'Event Count' }),
+  },
+});
+
+export const datasets = {
+  exampleEvents,
+};
+`;
+}

package/dist/templates/env.js

@@ -2,13 +2,24 @@
  * Generate .env file content for ClickHouse
  */
 export function generateEnvTemplate(config) {
-    var _a, _b;
-    var connectionUrl = (_b = (_a = config.url) !== null && _a !== void 0 ? _a : config.host) !== null && _b !== void 0 ? _b : '';
-    var isPlaceholder = connectionUrl.includes('YOUR_');
+    const connectionUrl = config.url ?? config.host ?? '';
+    const isPlaceholder = connectionUrl.includes('YOUR_');
     if (isPlaceholder) {
-        return "# Hypequery Configuration\n# Replace these placeholder values with your actual ClickHouse credentials\n\nCLICKHOUSE_URL=".concat(connectionUrl, "\nCLICKHOUSE_DATABASE=").concat(config.database, "\nCLICKHOUSE_USERNAME=").concat(config.username, "\nCLICKHOUSE_PASSWORD=").concat(config.password, "\n");
+        return `# Hypequery Configuration
+# Replace these placeholder values with your actual ClickHouse credentials
+
+CLICKHOUSE_URL=${connectionUrl}
+CLICKHOUSE_DATABASE=${config.database}
+CLICKHOUSE_USERNAME=${config.username}
+CLICKHOUSE_PASSWORD=${config.password}
+`;
     }
-    return "# Hypequery Configuration\nCLICKHOUSE_URL=".concat(connectionUrl, "\nCLICKHOUSE_DATABASE=").concat(config.database, "\nCLICKHOUSE_USERNAME=").concat(config.username, "\nCLICKHOUSE_PASSWORD=").concat(config.password, "\n");
+    return `# Hypequery Configuration
+CLICKHOUSE_URL=${connectionUrl}
+CLICKHOUSE_DATABASE=${config.database}
+CLICKHOUSE_USERNAME=${config.username}
+CLICKHOUSE_PASSWORD=${config.password}
+`;
 }
 /**
  * Append to existing .env file
@@ -17,11 +28,11 @@ export function appendToEnv(existingContent, newContent) {
     // Check if hypequery section already exists
     if (existingContent.includes('# Hypequery Configuration')) {
         // Replace existing section
-        var lines = existingContent.split('\n');
-        var startIndex = lines.findIndex(function (l) { return l.includes('# Hypequery Configuration'); });
+        const lines = existingContent.split('\n');
+        const startIndex = lines.findIndex(l => l.includes('# Hypequery Configuration'));
         if (startIndex !== -1) {
             // Find the end of the hypequery section
-            var endIndex = startIndex + 1;
+            let endIndex = startIndex + 1;
             while (endIndex < lines.length &&
                 (lines[endIndex].startsWith('CLICKHOUSE_') || lines[endIndex].trim() === '')) {
                 endIndex++;

package/dist/templates/gitignore.js

@@ -1,7 +1,10 @@
 /**
  * Content to append to .gitignore
  */
-export var GITIGNORE_CONTENT = "\n# Hypequery\n.env\n";
+export const GITIGNORE_CONTENT = `
+# Hypequery
+.env
+`;
 /**
  * Check if .gitignore already has hypequery entries
  */

package/dist/templates/queries.d.ts

@@ -1,8 +1,11 @@
+import { type AuthTemplateMode } from './auth-scaffold.js';
+export type { AuthTemplateMode };
 /**
  * Generate queries.ts file
  */
 export declare function generateQueriesTemplate(options: {
     hasExample: boolean;
     tableName?: string;
+    auth?: AuthTemplateMode;
 }): string;
 //# sourceMappingURL=queries.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../src/templates/queries.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAiET"}
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../src/templates/queries.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gBAAgB,EAGtB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB,GAAG,MAAM,CAwET"}

package/dist/templates/queries.js

@@ -1,28 +1,84 @@
+import { hostUserHelpers, contextAuthConfig, } from './auth-scaffold.js';
 /**
  * Generate queries.ts file
  */
 export function generateQueriesTemplate(options) {
-    var hasExample = options.hasExample, tableName = options.tableName;
-    var metricKey = hasExample && tableName ? "".concat(camelCase(tableName), "Query") : 'exampleMetric';
-    var typeAlias = "".concat(pascalCase(metricKey), "Result");
-    var routePath = "/metrics/".concat(metricKey);
-    var template = "import { initServe } from '@hypequery/serve';\nimport type { InferApiType } from '@hypequery/serve';\nimport { z } from 'zod';\nimport { db } from './client.js';\n\nconst { query, serve } = initServe({\n  context: () => ({ db }),\n});\n\n";
+    const { hasExample, tableName, auth = 'none' } = options;
+    const metricKey = hasExample && tableName ? `${camelCase(tableName)}Query` : 'exampleMetric';
+    const typeAlias = `${pascalCase(metricKey)}Result`;
+    const routePath = `/metrics/${metricKey}`;
+    const serveImports = auth === 'context' ? 'fromContext, initServe' : 'initServe';
+    const authHelpers = auth === 'context'
+        ? `\n${hostUserHelpers}\n`
+        : '';
+    const authConfig = auth === 'context'
+        ? `${contextAuthConfig}\n`
+        : '';
+    let template = `import { ${serveImports} } from '@hypequery/serve';
+import type { InferApiType } from '@hypequery/serve';
+import { z } from 'zod';
+import { db } from './client.js';
+${authHelpers}
+const { query, serve } = initServe({
+  context: () => ({ db }),
+${authConfig}});
+
+`;
     if (hasExample && tableName) {
-        template += "\nconst ".concat(camelCase(tableName), "Query = query({\n  description: 'Example query using the ").concat(tableName, " table',\n  query: async ({ ctx }) =>\n    ctx.db\n      .table('").concat(tableName, "')\n      .select('*')\n      .limit(10)\n      .execute(),\n});");
+        template += `
+const ${camelCase(tableName)}Query = query({
+  description: 'Example query using the ${tableName} table',
+  query: async ({ ctx }) =>
+    ctx.db
+      .table('${tableName}')
+      .select('*')
+      .limit(10)
+      .execute(),
+});`;
     }
     else {
-        template += "\nconst exampleMetric = query({\n  description: 'Example metric that returns a simple value',\n  output: z.object({ ok: z.boolean() }),\n  query: async () => ({ ok: true }),\n});";
+        template += `
+const exampleMetric = query({
+  description: 'Example metric that returns a simple value',
+  output: z.object({ ok: z.boolean() }),
+  query: async () => ({ ok: true }),
+});`;
     }
-    template += "\nexport const api = serve({\n  queries: {\n    ".concat(metricKey, ",\n  },\n});\napi.route('").concat(routePath, "', api.queries.").concat(metricKey, ");\n\nexport type ApiDefinition = InferApiType<typeof api>;\n\n/**\n * Inline usage example:\n *\n * const result = await api.execute('").concat(metricKey, "');\n * console.log(result);\n *\n * // import type { InferQueryResult } from '@hypequery/serve';\n * type ").concat(typeAlias, " = InferQueryResult<typeof api, '").concat(metricKey, "'>;\n *\n * HTTP route:\n * ").concat(routePath, "\n *\n * Dev server:\n * npx hypequery dev analytics/queries.ts\n */\n");
+    template += `
+export const api = serve({
+  queries: {
+    ${metricKey},
+  },
+});
+api.route('${routePath}', api.queries.${metricKey});
+
+export type ApiDefinition = InferApiType<typeof api>;
+
+/**
+ * Inline usage example:
+ *
+ * const result = await api.execute('${metricKey}');
+ * console.log(result);
+ *
+ * // import type { InferQueryResult } from '@hypequery/serve';
+ * type ${typeAlias} = InferQueryResult<typeof api, '${metricKey}'>;
+ *
+ * HTTP route:
+ * ${routePath}
+ *
+ * Dev server:
+ * npx hypequery dev analytics/queries.ts
+ */
+`;
     return template;
 }
 /**
  * Convert table name to camelCase
  */
 function camelCase(str) {
-    return str.replace(/_([a-z])/g, function (_, letter) { return letter.toUpperCase(); });
+    return str.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
 }
 function pascalCase(str) {
-    var camel = camelCase(str);
+    const camel = camelCase(str);
     return camel.charAt(0).toUpperCase() + camel.slice(1);
 }

package/dist/test-utils.d.ts

@@ -1,75 +1,4 @@
 import type { Mock } from 'vitest';
-/**
- * Mock prompts module for testing
- */
-export declare function createMockPrompts(): {
-    promptClickHouseConnection: Mock<(...args: any[]) => any>;
-    promptOutputDirectory: Mock<(...args: any[]) => any>;
-    promptGenerateExample: Mock<(...args: any[]) => any>;
-    promptTableSelection: Mock<(...args: any[]) => any>;
-    confirmOverwrite: Mock<(...args: any[]) => any>;
-    promptRetry: Mock<(...args: any[]) => any>;
-    promptContinueWithoutDb: Mock<(...args: any[]) => any>;
-};
-/**
- * Mock database detection utilities
- */
-export declare function createMockDatabaseUtils(): {
-    validateConnection: Mock<(...args: any[]) => any>;
-    getTableCount: Mock<(...args: any[]) => any>;
-    getTables: Mock<(...args: any[]) => any>;
-};
-/**
- * Mock file system utilities
- */
-export declare function createMockFileUtils(): {
-    hasEnvFile: Mock<(...args: any[]) => any>;
-    hasGitignore: Mock<(...args: any[]) => any>;
-    findQueriesFile: Mock<(...args: any[]) => any>;
-    findSchemaFile: Mock<(...args: any[]) => any>;
-};
-/**
- * Mock logger to capture output
- */
-export declare function createMockLogger(): {
-    success: Mock<(...args: any[]) => any>;
-    error: Mock<(...args: any[]) => any>;
-    warn: Mock<(...args: any[]) => any>;
-    info: Mock<(...args: any[]) => any>;
-    reload: Mock<(...args: any[]) => any>;
-    header: Mock<(...args: any[]) => any>;
-    newline: Mock<(...args: any[]) => any>;
-    indent: Mock<(...args: any[]) => any>;
-    box: Mock<(...args: any[]) => any>;
-    table: Mock<(...args: any[]) => any>;
-    raw: Mock<(...args: any[]) => any>;
-};
-/**
- * Mock ora spinner
- */
-export declare function createMockSpinner(): Mock<() => {
-    start: Mock<(...args: any[]) => any>;
-    succeed: Mock<(...args: any[]) => any>;
-    fail: Mock<(...args: any[]) => any>;
-    stop: Mock<(...args: any[]) => any>;
-}>;
-/**
- * Mock fs/promises for file operations
- */
-export declare function createMockFs(): {
-    mkdir: Mock<(...args: any[]) => any>;
-    writeFile: Mock<(...args: any[]) => any>;
-    readFile: Mock<(...args: any[]) => any>;
-    access: Mock<(...args: any[]) => any>;
-};
-/**
- * Capture console output
- */
-export declare function captureConsole(): {
-    logs: string[];
-    errors: string[];
-    restore: () => void;
-};
 /**
  * Mock process.exit to prevent tests from exiting
  * Throws a special error to stop execution

package/dist/test-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../src/test-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC;;GAEG;AACH,wBAAgB,iBAAiB;;;;;;;;EAUhC;AAED;;GAEG;AACH,wBAAgB,uBAAuB;;;;EAMtC;AAED;;GAEG;AACH,wBAAgB,mBAAmB;;;;;EAOlC;AAED;;GAEG;AACH,wBAAgB,gBAAgB;;;;;;;;;;;;EAc/B;AAED;;GAEG;AACH,wBAAgB,iBAAiB;;;;;GAQhC;AAED;;GAEG;AACH,wBAAgB,YAAY;;;;;EAO3B;AAED;;GAEG;AACH,wBAAgB,cAAc;;;;EAuB7B;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACtB,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAIhC;AAED,wBAAgB,eAAe;;;EAc9B"}
+{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../src/test-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACtB,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAIhC;AAED,wBAAgB,eAAe;;;EAc9B"}

package/dist/test-utils.js

@@ -1,150 +1,25 @@
-var __extends = (this && this.__extends) || (function () {
-    var extendStatics = function (d, b) {
-        extendStatics = Object.setPrototypeOf ||
-            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
-        return extendStatics(d, b);
-    };
-    return function (d, b) {
-        if (typeof b !== "function" && b !== null)
-            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-        extendStatics(d, b);
-        function __() { this.constructor = d; }
-        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-    };
-})();
 import { vi } from 'vitest';
-/**
- * Mock prompts module for testing
- */
-export function createMockPrompts() {
-    return {
-        promptClickHouseConnection: vi.fn(),
-        promptOutputDirectory: vi.fn(),
-        promptGenerateExample: vi.fn(),
-        promptTableSelection: vi.fn(),
-        confirmOverwrite: vi.fn(),
-        promptRetry: vi.fn(),
-        promptContinueWithoutDb: vi.fn(),
-    };
-}
-/**
- * Mock database detection utilities
- */
-export function createMockDatabaseUtils() {
-    return {
-        validateConnection: vi.fn(),
-        getTableCount: vi.fn(),
-        getTables: vi.fn(),
-    };
-}
-/**
- * Mock file system utilities
- */
-export function createMockFileUtils() {
-    return {
-        hasEnvFile: vi.fn(),
-        hasGitignore: vi.fn(),
-        findQueriesFile: vi.fn(),
-        findSchemaFile: vi.fn(),
-    };
-}
-/**
- * Mock logger to capture output
- */
-export function createMockLogger() {
-    return {
-        success: vi.fn(),
-        error: vi.fn(),
-        warn: vi.fn(),
-        info: vi.fn(),
-        reload: vi.fn(),
-        header: vi.fn(),
-        newline: vi.fn(),
-        indent: vi.fn(),
-        box: vi.fn(),
-        table: vi.fn(),
-        raw: vi.fn(),
-    };
-}
-/**
- * Mock ora spinner
- */
-export function createMockSpinner() {
-    var spinner = {
-        start: vi.fn().mockReturnThis(),
-        succeed: vi.fn().mockReturnThis(),
-        fail: vi.fn().mockReturnThis(),
-        stop: vi.fn().mockReturnThis(),
-    };
-    return vi.fn(function () { return spinner; });
-}
-/**
- * Mock fs/promises for file operations
- */
-export function createMockFs() {
-    return {
-        mkdir: vi.fn().mockResolvedValue(undefined),
-        writeFile: vi.fn().mockResolvedValue(undefined),
-        readFile: vi.fn().mockResolvedValue(''),
-        access: vi.fn().mockResolvedValue(undefined),
-    };
-}
-/**
- * Capture console output
- */
-export function captureConsole() {
-    var logs = [];
-    var errors = [];
-    var originalLog = console.log;
-    var originalError = console.error;
-    console.log = vi.fn(function () {
-        var args = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            args[_i] = arguments[_i];
-        }
-        logs.push(args.join(' '));
-    });
-    console.error = vi.fn(function () {
-        var args = [];
-        for (var _i = 0; _i < arguments.length; _i++) {
-            args[_i] = arguments[_i];
-        }
-        errors.push(args.join(' '));
-    });
-    return {
-        logs: logs,
-        errors: errors,
-        restore: function () {
-            console.log = originalLog;
-            console.error = originalError;
-        },
-    };
-}
 /**
  * Mock process.exit to prevent tests from exiting
  * Throws a special error to stop execution
  */
-var ProcessExitError = /** @class */ (function (_super) {
-    __extends(ProcessExitError, _super);
-    function ProcessExitError(code) {
-        var _this = _super.call(this, "process.exit called with code ".concat(code)) || this;
-        _this.code = code;
-        _this.name = 'ProcessExitError';
-        return _this;
+export class ProcessExitError extends Error {
+    code;
+    constructor(code) {
+        super(`process.exit called with code ${code}`);
+        this.code = code;
+        this.name = 'ProcessExitError';
     }
-    return ProcessExitError;
-}(Error));
-export { ProcessExitError };
+}
 export function mockProcessExit() {
-    var originalExit = process.exit;
-    var exitMock = vi.fn(function (code) {
-        throw new ProcessExitError(code !== null && code !== void 0 ? code : 0);
+    const originalExit = process.exit;
+    const exitMock = vi.fn((code) => {
+        throw new ProcessExitError(code ?? 0);
     });
     process.exit = exitMock;
     return {
-        exitMock: exitMock,
-        restore: function () {
+        exitMock,
+        restore: () => {
             process.exit = originalExit;
         },
     };

package/dist/utils/clickhouse-client.js

@@ -1,53 +1,16 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
-    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (g && (g = 0, op[0] && (_ = 0)), _) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-};
 import { createClient } from '@clickhouse/client';
-var client = null;
+let client = null;
 function readEnv(name, fallback) {
-    var value = process.env[name];
+    const value = process.env[name];
     return value === undefined || value === '' ? fallback : value;
 }
 export function getClickHouseConfigFromEnv() {
-    var _a;
-    var url = (_a = readEnv('CLICKHOUSE_URL')) !== null && _a !== void 0 ? _a : readEnv('CLICKHOUSE_HOST');
+    const url = readEnv('CLICKHOUSE_URL') ?? readEnv('CLICKHOUSE_HOST');
     if (!url) {
         return null;
     }
     return {
-        url: url,
+        url,
         username: readEnv('CLICKHOUSE_USERNAME', readEnv('CLICKHOUSE_USER', 'default')),
         password: readEnv('CLICKHOUSE_PASSWORD', readEnv('CLICKHOUSE_PASS', '')),
         database: readEnv('CLICKHOUSE_DATABASE', 'default'),
@@ -55,7 +18,7 @@ export function getClickHouseConfigFromEnv() {
 }
 export function getClickHouseClient() {
     if (!client) {
-        var config = getClickHouseConfigFromEnv();
+        const config = getClickHouseConfigFromEnv();
         if (!config) {
             throw new Error('ClickHouse connection details are missing. Set CLICKHOUSE_URL (or CLICKHOUSE_HOST), CLICKHOUSE_DATABASE, CLICKHOUSE_USERNAME, and CLICKHOUSE_PASSWORD.');
         }
@@ -68,19 +31,9 @@ export function getClickHouseClient() {
     }
     return client;
 }
-export function resetClickHouseClientForTesting() {
-    return __awaiter(this, void 0, void 0, function () {
-        return __generator(this, function (_a) {
-            switch (_a.label) {
-                case 0:
-                    if (!client) return [3 /*break*/, 2];
-                    return [4 /*yield*/, client.close()];
-                case 1:
-                    _a.sent();
-                    client = null;
-                    _a.label = 2;
-                case 2: return [2 /*return*/];
-            }
-        });
-    });
+export async function resetClickHouseClientForTesting() {
+    if (client) {
+        await client.close();
+        client = null;
+    }
 }

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

@@ -0,0 +1,6 @@
+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

@@ -0,0 +1 @@
+{"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"}

package/dist/utils/clickhouse-sql.js

@@ -0,0 +1,18 @@
+export function quoteIdentifier(identifier) {
+    assertValidIdentifier(identifier);
+    return `\`${identifier.replace(/`/g, '``')}\``;
+}
+export function assertValidIdentifier(identifier) {
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(identifier)) {
+        throw new Error(`Invalid ClickHouse identifier: ${identifier}`);
+    }
+}
+export function sqlString(value) {
+    return `'${value.replace(/\\/g, '\\\\').replace(/'/g, "\\'")}'`;
+}
+export function sqlStringArray(values) {
+    return `[${values.map(sqlString).join(', ')}]`;
+}
+export function sqlDateTime(value) {
+    return `parseDateTime64BestEffort(${sqlString(value.toISOString())}, 3)`;
+}

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

@@ -0,0 +1,6 @@
+export declare function splitTopLevelArgs(value: string): string[];
+export declare function unwrapType(type: string, wrapperName: string): string | null;
+export declare function matchTypeCall(type: string, name: string): string[] | null;
+export declare function unquoteClickHouseString(value: string): string;
+export declare function isIntegerLiteral(value: string): boolean;
+//# sourceMappingURL=clickhouse-type-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clickhouse-type-utils.d.ts","sourceRoot":"","sources":["../../src/utils/clickhouse-type-utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA+CzD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG3E;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAGzE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,UASpD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,WAE7C"}