@clickhouse/client 1.22.0 → 1.23.0-head.c8dc8d8.1

package/dist/common/data_formatter/format_query_settings.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatQuerySettings = formatQuerySettings;
+const settings_1 = require("../settings");
+function formatQuerySettings(value) {
+    if (typeof value === "boolean")
+        return value ? "1" : "0";
+    if (typeof value === "number")
+        return String(value);
+    if (typeof value === "string")
+        return value;
+    // ClickHouse requires a specific, non-JSON format for passing maps
+    // as a setting value - single quotes instead of double
+    // Example: {'system.numbers':'number != 3'}
+    if (value instanceof settings_1.SettingsMap) {
+        return value.toString();
+    }
+    throw new Error(`Unsupported value in query settings: [${value}].`);
+}
+//# sourceMappingURL=format_query_settings.js.map

package/dist/common/data_formatter/format_query_settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format_query_settings.js","sourceRoot":"","sources":["../../../src/common/data_formatter/format_query_settings.ts"],"names":[],"mappings":";;AAEA,kDAaC;AAfD,0CAA0C;AAE1C,SAAgB,mBAAmB,CACjC,KAA8C;IAE9C,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,mEAAmE;IACnE,uDAAuD;IACvD,4CAA4C;IAC5C,IAAI,KAAK,YAAY,sBAAW,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,yCAAyC,KAAK,IAAI,CAAC,CAAC;AACtE,CAAC"}

package/dist/common/data_formatter/formatter.d.ts

@@ -0,0 +1,41 @@
+import type { JSONHandling } from "../parse";
+export declare const StreamableJSONFormats: readonly ["JSONEachRow", "JSONStringsEachRow", "JSONCompactEachRow", "JSONCompactStringsEachRow", "JSONCompactEachRowWithNames", "JSONCompactEachRowWithNamesAndTypes", "JSONCompactStringsEachRowWithNames", "JSONCompactStringsEachRowWithNamesAndTypes", "JSONEachRowWithProgress"];
+export declare const RecordsJSONFormats: readonly ["JSONObjectEachRow"];
+export declare const SingleDocumentJSONFormats: readonly ["JSON", "JSONStrings", "JSONCompact", "JSONCompactStrings", "JSONColumnsWithMetadata"];
+export declare const SupportedJSONFormats: readonly ["JSONObjectEachRow", "JSON", "JSONStrings", "JSONCompact", "JSONCompactStrings", "JSONColumnsWithMetadata", "JSONEachRow", "JSONStringsEachRow", "JSONCompactEachRow", "JSONCompactStringsEachRow", "JSONCompactEachRowWithNames", "JSONCompactEachRowWithNamesAndTypes", "JSONCompactStringsEachRowWithNames", "JSONCompactStringsEachRowWithNamesAndTypes", "JSONEachRowWithProgress"];
+export declare const SupportedRawFormats: readonly ["CSV", "CSVWithNames", "CSVWithNamesAndTypes", "TabSeparated", "TabSeparatedRaw", "TabSeparatedWithNames", "TabSeparatedWithNamesAndTypes", "CustomSeparated", "CustomSeparatedWithNames", "CustomSeparatedWithNamesAndTypes", "Parquet"];
+export declare const StreamableFormats: readonly ["JSONEachRow", "JSONStringsEachRow", "JSONCompactEachRow", "JSONCompactStringsEachRow", "JSONCompactEachRowWithNames", "JSONCompactEachRowWithNamesAndTypes", "JSONCompactStringsEachRowWithNames", "JSONCompactStringsEachRowWithNamesAndTypes", "JSONEachRowWithProgress", "CSV", "CSVWithNames", "CSVWithNamesAndTypes", "TabSeparated", "TabSeparatedRaw", "TabSeparatedWithNames", "TabSeparatedWithNamesAndTypes", "CustomSeparated", "CustomSeparatedWithNames", "CustomSeparatedWithNamesAndTypes", "Parquet"];
+/** CSV, TSV, etc. - can be streamed, but cannot be decoded as JSON. */
+export type RawDataFormat = (typeof SupportedRawFormats)[number];
+/** Each row is returned as a separate JSON object or an array, and these formats can be streamed. */
+export type StreamableJSONDataFormat = (typeof StreamableJSONFormats)[number];
+/** Returned as a single {@link ResponseJSON} object, cannot be streamed. */
+export type SingleDocumentJSONFormat = (typeof SingleDocumentJSONFormats)[number];
+/** Returned as a single object { row_1: T, row_2: T, ...} <br/>
+ *  (i.e. Record<string, T>), cannot be streamed. */
+export type RecordsJSONFormat = (typeof RecordsJSONFormats)[number];
+/** All allowed JSON formats, whether streamable or not. */
+export type JSONDataFormat = StreamableJSONDataFormat | SingleDocumentJSONFormat | RecordsJSONFormat;
+/** Data formats that are currently supported by the client. <br/>
+ *  This is a union of the following types:<br/>
+ *  * {@link JSONDataFormat}
+ *  * {@link RawDataFormat}
+ *  * {@link StreamableDataFormat}
+ *  * {@link StreamableJSONDataFormat}
+ *  * {@link SingleDocumentJSONFormat}
+ *  * {@link RecordsJSONFormat}
+ *  @see https://clickhouse.com/docs/en/interfaces/formats */
+export type DataFormat = JSONDataFormat | RawDataFormat;
+/** All data formats that can be streamed, whether it can be decoded as JSON or not. */
+export type StreamableDataFormat = (typeof StreamableFormats)[number];
+export declare function isNotStreamableJSONFamily(format: DataFormat): format is SingleDocumentJSONFormat;
+export declare function isStreamableJSONFamily(format: DataFormat): format is StreamableJSONDataFormat;
+export declare function isSupportedRawFormat(dataFormat: DataFormat): boolean;
+export declare function validateStreamFormat(format: any): format is StreamableDataFormat;
+/**
+ * Encodes a single row of values into a string in a JSON format acceptable by ClickHouse.
+ * @param value a single value to encode.
+ * @param format One of the supported JSON formats: https://clickhouse.com/docs/en/interfaces/formats/
+ * @returns string
+ */
+export declare function encodeJSON(value: any, format: DataFormat, stringifyFn: JSONHandling["stringify"]): string;

package/dist/common/data_formatter/formatter.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StreamableFormats = exports.SupportedRawFormats = exports.SupportedJSONFormats = exports.SingleDocumentJSONFormats = exports.RecordsJSONFormats = exports.StreamableJSONFormats = void 0;
+exports.isNotStreamableJSONFamily = isNotStreamableJSONFamily;
+exports.isStreamableJSONFamily = isStreamableJSONFamily;
+exports.isSupportedRawFormat = isSupportedRawFormat;
+exports.validateStreamFormat = validateStreamFormat;
+exports.encodeJSON = encodeJSON;
+exports.StreamableJSONFormats = [
+    "JSONEachRow",
+    "JSONStringsEachRow",
+    "JSONCompactEachRow",
+    "JSONCompactStringsEachRow",
+    "JSONCompactEachRowWithNames",
+    "JSONCompactEachRowWithNamesAndTypes",
+    "JSONCompactStringsEachRowWithNames",
+    "JSONCompactStringsEachRowWithNamesAndTypes",
+    "JSONEachRowWithProgress",
+];
+exports.RecordsJSONFormats = ["JSONObjectEachRow"];
+exports.SingleDocumentJSONFormats = [
+    "JSON",
+    "JSONStrings",
+    "JSONCompact",
+    "JSONCompactStrings",
+    "JSONColumnsWithMetadata",
+];
+exports.SupportedJSONFormats = [
+    ...exports.RecordsJSONFormats,
+    ...exports.SingleDocumentJSONFormats,
+    ...exports.StreamableJSONFormats,
+];
+exports.SupportedRawFormats = [
+    "CSV",
+    "CSVWithNames",
+    "CSVWithNamesAndTypes",
+    "TabSeparated",
+    "TabSeparatedRaw",
+    "TabSeparatedWithNames",
+    "TabSeparatedWithNamesAndTypes",
+    "CustomSeparated",
+    "CustomSeparatedWithNames",
+    "CustomSeparatedWithNamesAndTypes",
+    "Parquet",
+];
+exports.StreamableFormats = [
+    ...exports.StreamableJSONFormats,
+    ...exports.SupportedRawFormats,
+];
+function isNotStreamableJSONFamily(format) {
+    return (exports.SingleDocumentJSONFormats.includes(format) ||
+        exports.RecordsJSONFormats.includes(format));
+}
+function isStreamableJSONFamily(format) {
+    return exports.StreamableJSONFormats.includes(format);
+}
+function isSupportedRawFormat(dataFormat) {
+    return exports.SupportedRawFormats.includes(dataFormat);
+}
+function validateStreamFormat(format) {
+    if (!exports.StreamableFormats.includes(format)) {
+        throw new Error(`${format} format is not streamable. Streamable formats: ${exports.StreamableFormats.join(",")}`);
+    }
+    return true;
+}
+/**
+ * Encodes a single row of values into a string in a JSON format acceptable by ClickHouse.
+ * @param value a single value to encode.
+ * @param format One of the supported JSON formats: https://clickhouse.com/docs/en/interfaces/formats/
+ * @returns string
+ */
+function encodeJSON(value, format, stringifyFn) {
+    if (exports.SupportedJSONFormats.includes(format)) {
+        return stringifyFn(value) + "\n";
+    }
+    throw new Error(`The client does not support JSON encoding in [${format}] format.`);
+}
+//# sourceMappingURL=formatter.js.map

package/dist/common/data_formatter/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../../src/common/data_formatter/formatter.ts"],"names":[],"mappings":";;;AA8EA,8DAOC;AAED,wDAIC;AAED,oDAEC;AAED,oDAWC;AAQD,gCAWC;AA7HY,QAAA,qBAAqB,GAAG;IACnC,aAAa;IACb,oBAAoB;IACpB,oBAAoB;IACpB,2BAA2B;IAC3B,6BAA6B;IAC7B,qCAAqC;IACrC,oCAAoC;IACpC,4CAA4C;IAC5C,yBAAyB;CACjB,CAAC;AACE,QAAA,kBAAkB,GAAG,CAAC,mBAAmB,CAAU,CAAC;AACpD,QAAA,yBAAyB,GAAG;IACvC,MAAM;IACN,aAAa;IACb,aAAa;IACb,oBAAoB;IACpB,yBAAyB;CACjB,CAAC;AACE,QAAA,oBAAoB,GAAG;IAClC,GAAG,0BAAkB;IACrB,GAAG,iCAAyB;IAC5B,GAAG,6BAAqB;CAChB,CAAC;AACE,QAAA,mBAAmB,GAAG;IACjC,KAAK;IACL,cAAc;IACd,sBAAsB;IACtB,cAAc;IACd,iBAAiB;IACjB,uBAAuB;IACvB,+BAA+B;IAC/B,iBAAiB;IACjB,0BAA0B;IAC1B,kCAAkC;IAClC,SAAS;CACD,CAAC;AACE,QAAA,iBAAiB,GAAG;IAC/B,GAAG,6BAAqB;IACxB,GAAG,2BAAmB;CACd,CAAC;AAoCX,SAAgB,yBAAyB,CACvC,MAAkB;IAElB,OAAO,CACJ,iCAA+C,CAAC,QAAQ,CAAC,MAAM,CAAC;QAChE,0BAAwC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAC3D,CAAC;AACJ,CAAC;AAED,SAAgB,sBAAsB,CACpC,MAAkB;IAElB,OAAQ,6BAA2C,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACvE,CAAC;AAED,SAAgB,oBAAoB,CAAC,UAAsB;IACzD,OAAQ,2BAAyC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AACzE,CAAC;AAED,SAAgB,oBAAoB,CAClC,MAAW;IAEX,IAAI,CAAC,yBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,GAAG,MAAM,kDAAkD,yBAAiB,CAAC,IAAI,CAC/E,GAAG,CACJ,EAAE,CACJ,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAgB,UAAU,CACxB,KAAU,EACV,MAAkB,EAClB,WAAsC;IAEtC,IAAK,4BAA0C,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACjE,OAAO,WAAW,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IACnC,CAAC;IACD,MAAM,IAAI,KAAK,CACb,iDAAiD,MAAM,WAAW,CACnE,CAAC;AACJ,CAAC"}

package/dist/common/data_formatter/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./formatter";
+export { TupleParam, formatQueryParams } from "./format_query_params";
+export { formatQuerySettings } from "./format_query_settings";

package/dist/common/data_formatter/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatQuerySettings = exports.formatQueryParams = exports.TupleParam = void 0;
+__exportStar(require("./formatter"), exports);
+var format_query_params_1 = require("./format_query_params");
+Object.defineProperty(exports, "TupleParam", { enumerable: true, get: function () { return format_query_params_1.TupleParam; } });
+Object.defineProperty(exports, "formatQueryParams", { enumerable: true, get: function () { return format_query_params_1.formatQueryParams; } });
+var format_query_settings_1 = require("./format_query_settings");
+Object.defineProperty(exports, "formatQuerySettings", { enumerable: true, get: function () { return format_query_settings_1.formatQuerySettings; } });
+//# sourceMappingURL=index.js.map

package/dist/common/data_formatter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/data_formatter/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,6DAAsE;AAA7D,iHAAA,UAAU,OAAA;AAAE,wHAAA,iBAAiB,OAAA;AACtC,iEAA8D;AAArD,4HAAA,mBAAmB,OAAA"}

package/dist/common/error/error.d.ts

@@ -0,0 +1,20 @@
+interface ParsedClickHouseError {
+    message: string;
+    code: string;
+    type?: string;
+}
+/** An error that is thrown by the ClickHouse server. */
+export declare class ClickHouseError extends Error {
+    readonly code: string;
+    readonly type: string | undefined;
+    constructor({ message, code, type }: ParsedClickHouseError);
+}
+export declare function parseError(input: string | Error): ClickHouseError | Error;
+/** Captures the current stack trace from the sync context before going async.
+ *  It is necessary since the majority of the stack trace is lost when an async callback is called. */
+export declare function getCurrentStackTrace(): string;
+/** Having the stack trace produced by the {@link getCurrentStackTrace} function,
+ *  add it to an arbitrary error stack trace. No-op if there is no additional stack trace to add.
+ *  It could happen if this feature was disabled due to its performance overhead. */
+export declare function enhanceStackTrace<E extends Error>(err: E, stackTrace: string | undefined): E;
+export {};

package/dist/common/error/error.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClickHouseError = void 0;
+exports.parseError = parseError;
+exports.getCurrentStackTrace = getCurrentStackTrace;
+exports.enhanceStackTrace = enhanceStackTrace;
+// In cluster mode, the server wraps the original exception, repeating the
+// `Code`/`Exception`/`(TYPE)` markers, e.g.:
+//   Code: 57. DB::Exception: There was an error on [host:9000]: Code: 57. DB::Exception: <message>. (TABLE_ALREADY_EXISTS) (version ...). (TABLE_ALREADY_EXISTS) (version ...)
+// The leading `.*Exception: ` is greedy so we anchor on the innermost (last)
+// exception, while `(?<message>.+?)` is lazy so the message stops at the first
+// `(TYPE)` marker rather than swallowing the repeated suffixes. The type
+// lookahead requires at least three consecutive uppercase letters so that
+// parenthesised groups like `(2)` or `(official build)` are not mistaken for it.
+//
+// NOTE: In normal usage, the string fed to `parseError` comes from ClickHouse,
+// but it may still include user-controlled fragments (e.g. parts of a query) or
+// even non-ClickHouse payloads (proxy/HTML errors) when parsing failed requests.
+// Keep this regex simple to avoid excessive backtracking on large/unexpected input.
+// (If this ever becomes a concern, consider a non-regex parser or input length limits.)
+const errorRe = /(Code|Error): (?<code>\d+).*Exception: (?<message>.+?)\((?<type>(?=[A-Z0-9_]*[A-Z]{3})[A-Z0-9_]+)\)/s;
+/** An error that is thrown by the ClickHouse server. */
+class ClickHouseError extends Error {
+    code;
+    type;
+    constructor({ message, code, type }) {
+        super(message);
+        this.code = code;
+        this.type = type;
+        // Set the prototype explicitly, see:
+        // https://github.com/Microsoft/TypeScript/wiki/Breaking-Changes#extending-built-ins-like-error-array-and-map-may-no-longer-work
+        Object.setPrototypeOf(this, ClickHouseError.prototype);
+    }
+}
+exports.ClickHouseError = ClickHouseError;
+function parseError(input) {
+    const inputIsError = input instanceof Error;
+    const message = inputIsError ? input.message : input;
+    const match = message.match(errorRe);
+    const groups = match?.groups;
+    if (groups) {
+        return new ClickHouseError(groups);
+    }
+    else {
+        return inputIsError ? input : new Error(input);
+    }
+}
+/** Captures the current stack trace from the sync context before going async.
+ *  It is necessary since the majority of the stack trace is lost when an async callback is called. */
+function getCurrentStackTrace() {
+    const stack = new Error().stack;
+    if (!stack)
+        return "";
+    // Skip the first three lines of the stack trace, containing useless information
+    // - Text `Error`
+    // - Info about this function call
+    // - Info about the originator of this function call, e.g., `request`
+    // Additionally, the original stack trace is, in fact, reversed.
+    return stack.split("\n").slice(3).reverse().join("\n");
+}
+/** Having the stack trace produced by the {@link getCurrentStackTrace} function,
+ *  add it to an arbitrary error stack trace. No-op if there is no additional stack trace to add.
+ *  It could happen if this feature was disabled due to its performance overhead. */
+function enhanceStackTrace(err, stackTrace) {
+    if (err.stack && stackTrace) {
+        const firstNewlineIndex = err.stack.indexOf("\n");
+        const firstLine = err.stack.substring(0, firstNewlineIndex);
+        const errStack = err.stack.substring(firstNewlineIndex + 1);
+        err.stack = `${firstLine}\n${stackTrace}\n${errStack}`;
+    }
+    return err;
+}
+//# sourceMappingURL=error.js.map

package/dist/common/error/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../../src/common/error/error.ts"],"names":[],"mappings":";;;AAsCA,gCAUC;AAID,oDAUC;AAKD,8CAWC;AA9ED,0EAA0E;AAC1E,6CAA6C;AAC7C,+KAA+K;AAC/K,6EAA6E;AAC7E,+EAA+E;AAC/E,yEAAyE;AACzE,0EAA0E;AAC1E,iFAAiF;AACjF,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAChF,iFAAiF;AACjF,oFAAoF;AACpF,wFAAwF;AACxF,MAAM,OAAO,GACX,sGAAsG,CAAC;AAQzG,wDAAwD;AACxD,MAAa,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAAS;IACb,IAAI,CAAqB;IAClC,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAyB;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAEjB,qCAAqC;QACrC,gIAAgI;QAChI,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;CACF;AAZD,0CAYC;AAED,SAAgB,UAAU,CAAC,KAAqB;IAC9C,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC;IAC5C,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IACrD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,KAAK,EAAE,MAA2C,CAAC;IAClE,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;SAAM,CAAC;QACN,OAAO,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED;sGACsG;AACtG,SAAgB,oBAAoB;IAClC,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC,KAAK,CAAC;IAChC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IAEtB,gFAAgF;IAChF,iBAAiB;IACjB,kCAAkC;IAClC,qEAAqE;IACrE,gEAAgE;IAChE,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzD,CAAC;AAED;;oFAEoF;AACpF,SAAgB,iBAAiB,CAC/B,GAAM,EACN,UAA8B;IAE9B,IAAI,GAAG,CAAC,KAAK,IAAI,UAAU,EAAE,CAAC;QAC5B,MAAM,iBAAiB,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;QAC5D,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC;QAC5D,GAAG,CAAC,KAAK,GAAG,GAAG,SAAS,KAAK,UAAU,KAAK,QAAQ,EAAE,CAAC;IACzD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/common/error/index.d.ts

@@ -0,0 +1 @@
+export * from "./error";

package/dist/common/error/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./error"), exports);
+//# sourceMappingURL=index.js.map

package/dist/common/error/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/error/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB"}

package/dist/common/index.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @deprecated The `@clickhouse/client-common` package is deprecated. It is no longer used by
+ * `@clickhouse/client` or `@clickhouse/client-web`; the shared code is bundled into each client
+ * package instead. Import everything from `@clickhouse/client` (Node.js) or
+ * `@clickhouse/client-web` (Web) instead.
+ *
+ * @packageDocumentation
+ */
+/** Should be re-exported by the implementation */
+export { type BaseQueryParams, type QueryParams, type QueryResult, type ExecParams, type InsertParams, 
+/** @deprecated Import `ClickHouseClient` from `@clickhouse/client` instead. In Web projects, use `import type { ClickHouseClient } from '@clickhouse/client-web'`. Importing it from `@clickhouse/client-common` is deprecated. */
+ClickHouseClient, type CommandParams, type CommandResult, type ExecResult, type InsertResult, type PingResult, type PingParams, type PingParamsWithSelectQuery, type PingParamsWithEndpoint, } from "./client";
+export { type BaseClickHouseClientConfigOptions } from "./config";
+export type { Row, RowOrProgress, BaseResultSet, ResultJSONType, RowJSONType, ResultStream, } from "./result";
+export type { DataFormat, RawDataFormat, JSONDataFormat, StreamableDataFormat, StreamableJSONDataFormat, SingleDocumentJSONFormat, } from "./data_formatter";
+export { 
+/** @deprecated Import `SupportedJSONFormats` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+SupportedJSONFormats, 
+/** @deprecated Import `SupportedRawFormats` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+SupportedRawFormats, 
+/** @deprecated Import `StreamableFormats` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+StreamableFormats, 
+/** @deprecated Import `StreamableJSONFormats` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+StreamableJSONFormats, 
+/** @deprecated Import `SingleDocumentJSONFormats` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+SingleDocumentJSONFormats, 
+/** @deprecated Import `RecordsJSONFormats` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+RecordsJSONFormats, 
+/** @deprecated Import `TupleParam` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+TupleParam, } from "./data_formatter";
+export { 
+/** @deprecated Import `ClickHouseError` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+ClickHouseError, 
+/** @deprecated Import `parseError` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+parseError, } from "./error";
+export { 
+/** @deprecated Import `ClickHouseLogLevel` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+ClickHouseLogLevel, type ErrorLogParams, type WarnLogParams, type Logger, type LogParams, } from "./logger";
+export type { ClickHouseSummary, InputJSON, InputJSONObjectEachRow, ResponseJSON, ResponseHeaders, WithClickHouseSummary, WithResponseHeaders, ProgressRow, InsertValues, ClickHouseAuth, ClickHouseJWTAuth, ClickHouseCredentialsAuth, } from "./clickhouse_types";
+export { 
+/** @deprecated Import `isProgressRow` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+isProgressRow, 
+/** @deprecated Import `isRow` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+isRow, 
+/** @deprecated Import `isException` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+isException, } from "./clickhouse_types";
+export { type ClickHouseSettings, type MergeTreeSettings, 
+/** @deprecated Import `SettingsMap` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+SettingsMap, } from "./settings";
+export type { SimpleColumnType, ParsedColumnSimple, ParsedColumnEnum, ParsedColumnFixedString, ParsedColumnNullable, ParsedColumnDecimal, ParsedColumnDateTime, ParsedColumnDateTime64, ParsedColumnArray, ParsedColumnTuple, ParsedColumnMap, ParsedColumnType, JSONHandling, } from "./parse";
+export { 
+/** @deprecated Import `SimpleColumnTypes` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+SimpleColumnTypes, 
+/** @deprecated Import `parseColumnType` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+parseColumnType, 
+/** @deprecated Import `defaultJSONHandling` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+defaultJSONHandling, } from "./parse";
+export { type ClickHouseTracer, type ClickHouseSpan, type ClickHouseSpanOptions, type ClickHouseSpanAttributes, type ClickHouseSpanStatus, type ClickHouseSpanName, ClickHouseSpanStatusCode, ClickHouseSpanKind, ClickHouseSpanNames, recordSpanError, } from "./tracing";
+/** For implementation usage only - should not be re-exported */
+export { formatQuerySettings, formatQueryParams, encodeJSON, isSupportedRawFormat, isStreamableJSONFamily, isNotStreamableJSONFamily, validateStreamFormat, } from "./data_formatter";
+export { type ValuesEncoder, type MakeResultSet, type MakeConnection, type HandleImplSpecificURLParams, type ImplementationDetails, booleanConfigURLValue, enumConfigURLValue, getConnectionParams, numberConfigURLValue, } from "./config";
+export { EXCEPTION_TAG_HEADER_NAME, isSuccessfulResponse, sleep, buildMultipartBody, MAX_URL_BIND_PARAM_LENGTH, serializeQueryParamsForUrl, toSearchParams, transformUrl, withCompressionHeaders, withHttpSettings, isCredentialsAuth, isJWTAuth, extractErrorAtTheEndOfChunk, CARET_RETURN, } from "./utils";
+export { LogWriter, DefaultLogger, type LogWriterParams } from "./logger";
+export { getCurrentStackTrace, enhanceStackTrace } from "./error";
+export type { CompressionSettings, CompressionMethod, RequestCompression, ResponseCompression, Connection, ConnectionParams, ConnInsertResult, ConnExecParams, ConnExecResult, ConnQueryResult, ConnBaseQueryParams, ConnBaseResult, ConnInsertParams, ConnPingResult, ConnCommandResult, ConnOperation, ConnPingParams, } from "./connection";
+export type { QueryParamsWithFormat } from "./client";
+export type { IsSame } from "./ts_utils";

package/dist/common/index.js

@@ -0,0 +1,97 @@
+"use strict";
+/**
+ * @deprecated The `@clickhouse/client-common` package is deprecated. It is no longer used by
+ * `@clickhouse/client` or `@clickhouse/client-web`; the shared code is bundled into each client
+ * package instead. Import everything from `@clickhouse/client` (Node.js) or
+ * `@clickhouse/client-web` (Web) instead.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCurrentStackTrace = exports.DefaultLogger = exports.LogWriter = exports.CARET_RETURN = exports.extractErrorAtTheEndOfChunk = exports.isJWTAuth = exports.isCredentialsAuth = exports.withHttpSettings = exports.withCompressionHeaders = exports.transformUrl = exports.toSearchParams = exports.serializeQueryParamsForUrl = exports.MAX_URL_BIND_PARAM_LENGTH = exports.buildMultipartBody = exports.sleep = exports.isSuccessfulResponse = exports.EXCEPTION_TAG_HEADER_NAME = exports.numberConfigURLValue = exports.getConnectionParams = exports.enumConfigURLValue = exports.booleanConfigURLValue = exports.validateStreamFormat = exports.isNotStreamableJSONFamily = exports.isStreamableJSONFamily = exports.isSupportedRawFormat = exports.encodeJSON = exports.formatQueryParams = exports.formatQuerySettings = exports.recordSpanError = exports.ClickHouseSpanNames = exports.ClickHouseSpanKind = exports.ClickHouseSpanStatusCode = exports.defaultJSONHandling = exports.parseColumnType = exports.SimpleColumnTypes = exports.SettingsMap = exports.isException = exports.isRow = exports.isProgressRow = exports.ClickHouseLogLevel = exports.parseError = exports.ClickHouseError = exports.TupleParam = exports.RecordsJSONFormats = exports.SingleDocumentJSONFormats = exports.StreamableJSONFormats = exports.StreamableFormats = exports.SupportedRawFormats = exports.SupportedJSONFormats = exports.ClickHouseClient = void 0;
+exports.enhanceStackTrace = void 0;
+/** Should be re-exported by the implementation */
+var client_1 = require("./client");
+/** @deprecated Import `ClickHouseClient` from `@clickhouse/client` instead. In Web projects, use `import type { ClickHouseClient } from '@clickhouse/client-web'`. Importing it from `@clickhouse/client-common` is deprecated. */
+Object.defineProperty(exports, "ClickHouseClient", { enumerable: true, get: function () { return client_1.ClickHouseClient; } });
+var data_formatter_1 = require("./data_formatter");
+/** @deprecated Import `SupportedJSONFormats` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+Object.defineProperty(exports, "SupportedJSONFormats", { enumerable: true, get: function () { return data_formatter_1.SupportedJSONFormats; } });
+/** @deprecated Import `SupportedRawFormats` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+Object.defineProperty(exports, "SupportedRawFormats", { enumerable: true, get: function () { return data_formatter_1.SupportedRawFormats; } });
+/** @deprecated Import `StreamableFormats` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+Object.defineProperty(exports, "StreamableFormats", { enumerable: true, get: function () { return data_formatter_1.StreamableFormats; } });
+/** @deprecated Import `StreamableJSONFormats` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+Object.defineProperty(exports, "StreamableJSONFormats", { enumerable: true, get: function () { return data_formatter_1.StreamableJSONFormats; } });
+/** @deprecated Import `SingleDocumentJSONFormats` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+Object.defineProperty(exports, "SingleDocumentJSONFormats", { enumerable: true, get: function () { return data_formatter_1.SingleDocumentJSONFormats; } });
+/** @deprecated Import `RecordsJSONFormats` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+Object.defineProperty(exports, "RecordsJSONFormats", { enumerable: true, get: function () { return data_formatter_1.RecordsJSONFormats; } });
+/** @deprecated Import `TupleParam` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+Object.defineProperty(exports, "TupleParam", { enumerable: true, get: function () { return data_formatter_1.TupleParam; } });
+var error_1 = require("./error");
+/** @deprecated Import `ClickHouseError` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+Object.defineProperty(exports, "ClickHouseError", { enumerable: true, get: function () { return error_1.ClickHouseError; } });
+/** @deprecated Import `parseError` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+Object.defineProperty(exports, "parseError", { enumerable: true, get: function () { return error_1.parseError; } });
+var logger_1 = require("./logger");
+/** @deprecated Import `ClickHouseLogLevel` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+Object.defineProperty(exports, "ClickHouseLogLevel", { enumerable: true, get: function () { return logger_1.ClickHouseLogLevel; } });
+var clickhouse_types_1 = require("./clickhouse_types");
+/** @deprecated Import `isProgressRow` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+Object.defineProperty(exports, "isProgressRow", { enumerable: true, get: function () { return clickhouse_types_1.isProgressRow; } });
+/** @deprecated Import `isRow` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+Object.defineProperty(exports, "isRow", { enumerable: true, get: function () { return clickhouse_types_1.isRow; } });
+/** @deprecated Import `isException` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+Object.defineProperty(exports, "isException", { enumerable: true, get: function () { return clickhouse_types_1.isException; } });
+var settings_1 = require("./settings");
+/** @deprecated Import `SettingsMap` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+Object.defineProperty(exports, "SettingsMap", { enumerable: true, get: function () { return settings_1.SettingsMap; } });
+var parse_1 = require("./parse");
+/** @deprecated Import `SimpleColumnTypes` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+Object.defineProperty(exports, "SimpleColumnTypes", { enumerable: true, get: function () { return parse_1.SimpleColumnTypes; } });
+/** @deprecated Import `parseColumnType` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+Object.defineProperty(exports, "parseColumnType", { enumerable: true, get: function () { return parse_1.parseColumnType; } });
+/** @deprecated Import `defaultJSONHandling` from `@clickhouse/client` (Node.js) or `@clickhouse/client-web` (Web) instead. Importing it from `@clickhouse/client-common` is deprecated. */
+Object.defineProperty(exports, "defaultJSONHandling", { enumerable: true, get: function () { return parse_1.defaultJSONHandling; } });
+var tracing_1 = require("./tracing");
+Object.defineProperty(exports, "ClickHouseSpanStatusCode", { enumerable: true, get: function () { return tracing_1.ClickHouseSpanStatusCode; } });
+Object.defineProperty(exports, "ClickHouseSpanKind", { enumerable: true, get: function () { return tracing_1.ClickHouseSpanKind; } });
+Object.defineProperty(exports, "ClickHouseSpanNames", { enumerable: true, get: function () { return tracing_1.ClickHouseSpanNames; } });
+Object.defineProperty(exports, "recordSpanError", { enumerable: true, get: function () { return tracing_1.recordSpanError; } });
+/** For implementation usage only - should not be re-exported */
+var data_formatter_2 = require("./data_formatter");
+Object.defineProperty(exports, "formatQuerySettings", { enumerable: true, get: function () { return data_formatter_2.formatQuerySettings; } });
+Object.defineProperty(exports, "formatQueryParams", { enumerable: true, get: function () { return data_formatter_2.formatQueryParams; } });
+Object.defineProperty(exports, "encodeJSON", { enumerable: true, get: function () { return data_formatter_2.encodeJSON; } });
+Object.defineProperty(exports, "isSupportedRawFormat", { enumerable: true, get: function () { return data_formatter_2.isSupportedRawFormat; } });
+Object.defineProperty(exports, "isStreamableJSONFamily", { enumerable: true, get: function () { return data_formatter_2.isStreamableJSONFamily; } });
+Object.defineProperty(exports, "isNotStreamableJSONFamily", { enumerable: true, get: function () { return data_formatter_2.isNotStreamableJSONFamily; } });
+Object.defineProperty(exports, "validateStreamFormat", { enumerable: true, get: function () { return data_formatter_2.validateStreamFormat; } });
+var config_1 = require("./config");
+Object.defineProperty(exports, "booleanConfigURLValue", { enumerable: true, get: function () { return config_1.booleanConfigURLValue; } });
+Object.defineProperty(exports, "enumConfigURLValue", { enumerable: true, get: function () { return config_1.enumConfigURLValue; } });
+Object.defineProperty(exports, "getConnectionParams", { enumerable: true, get: function () { return config_1.getConnectionParams; } });
+Object.defineProperty(exports, "numberConfigURLValue", { enumerable: true, get: function () { return config_1.numberConfigURLValue; } });
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "EXCEPTION_TAG_HEADER_NAME", { enumerable: true, get: function () { return utils_1.EXCEPTION_TAG_HEADER_NAME; } });
+Object.defineProperty(exports, "isSuccessfulResponse", { enumerable: true, get: function () { return utils_1.isSuccessfulResponse; } });
+Object.defineProperty(exports, "sleep", { enumerable: true, get: function () { return utils_1.sleep; } });
+Object.defineProperty(exports, "buildMultipartBody", { enumerable: true, get: function () { return utils_1.buildMultipartBody; } });
+Object.defineProperty(exports, "MAX_URL_BIND_PARAM_LENGTH", { enumerable: true, get: function () { return utils_1.MAX_URL_BIND_PARAM_LENGTH; } });
+Object.defineProperty(exports, "serializeQueryParamsForUrl", { enumerable: true, get: function () { return utils_1.serializeQueryParamsForUrl; } });
+Object.defineProperty(exports, "toSearchParams", { enumerable: true, get: function () { return utils_1.toSearchParams; } });
+Object.defineProperty(exports, "transformUrl", { enumerable: true, get: function () { return utils_1.transformUrl; } });
+Object.defineProperty(exports, "withCompressionHeaders", { enumerable: true, get: function () { return utils_1.withCompressionHeaders; } });
+Object.defineProperty(exports, "withHttpSettings", { enumerable: true, get: function () { return utils_1.withHttpSettings; } });
+Object.defineProperty(exports, "isCredentialsAuth", { enumerable: true, get: function () { return utils_1.isCredentialsAuth; } });
+Object.defineProperty(exports, "isJWTAuth", { enumerable: true, get: function () { return utils_1.isJWTAuth; } });
+Object.defineProperty(exports, "extractErrorAtTheEndOfChunk", { enumerable: true, get: function () { return utils_1.extractErrorAtTheEndOfChunk; } });
+Object.defineProperty(exports, "CARET_RETURN", { enumerable: true, get: function () { return utils_1.CARET_RETURN; } });
+var logger_2 = require("./logger");
+Object.defineProperty(exports, "LogWriter", { enumerable: true, get: function () { return logger_2.LogWriter; } });
+Object.defineProperty(exports, "DefaultLogger", { enumerable: true, get: function () { return logger_2.DefaultLogger; } });
+var error_2 = require("./error");
+Object.defineProperty(exports, "getCurrentStackTrace", { enumerable: true, get: function () { return error_2.getCurrentStackTrace; } });
+Object.defineProperty(exports, "enhanceStackTrace", { enumerable: true, get: function () { return error_2.enhanceStackTrace; } });
+//# sourceMappingURL=index.js.map

package/dist/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;AAEH,kDAAkD;AAClD,mCAgBkB;AAVhB,mOAAmO;AACnO,0GAAA,gBAAgB,OAAA;AA2BlB,mDAe0B;AAdxB,4LAA4L;AAC5L,sHAAA,oBAAoB,OAAA;AACpB,2LAA2L;AAC3L,qHAAA,mBAAmB,OAAA;AACnB,yLAAyL;AACzL,mHAAA,iBAAiB,OAAA;AACjB,6LAA6L;AAC7L,uHAAA,qBAAqB,OAAA;AACrB,iMAAiM;AACjM,2HAAA,yBAAyB,OAAA;AACzB,0LAA0L;AAC1L,oHAAA,kBAAkB,OAAA;AAClB,kLAAkL;AAClL,4GAAA,UAAU,OAAA;AAEZ,iCAKiB;AAJf,uLAAuL;AACvL,wGAAA,eAAe,OAAA;AACf,kLAAkL;AAClL,mGAAA,UAAU,OAAA;AAEZ,mCAOkB;AANhB,0LAA0L;AAC1L,4GAAA,kBAAkB,OAAA;AAoBpB,uDAO4B;AAN1B,qLAAqL;AACrL,iHAAA,aAAa,OAAA;AACb,6KAA6K;AAC7K,yGAAA,KAAK,OAAA;AACL,mLAAmL;AACnL,+GAAA,WAAW,OAAA;AAEb,uCAKoB;AAFlB,mLAAmL;AACnL,uGAAA,WAAW,OAAA;AAiBb,iCAOiB;AANf,yLAAyL;AACzL,0GAAA,iBAAiB,OAAA;AACjB,uLAAuL;AACvL,wGAAA,eAAe,OAAA;AACf,2LAA2L;AAC3L,4GAAA,mBAAmB,OAAA;AAErB,qCAWmB;AAJjB,mHAAA,wBAAwB,OAAA;AACxB,6GAAA,kBAAkB,OAAA;AAClB,8GAAA,mBAAmB,OAAA;AACnB,0GAAA,eAAe,OAAA;AAGjB,gEAAgE;AAChE,mDAQ0B;AAPxB,qHAAA,mBAAmB,OAAA;AACnB,mHAAA,iBAAiB,OAAA;AACjB,4GAAA,UAAU,OAAA;AACV,sHAAA,oBAAoB,OAAA;AACpB,wHAAA,sBAAsB,OAAA;AACtB,2HAAA,yBAAyB,OAAA;AACzB,sHAAA,oBAAoB,OAAA;AAEtB,mCAUkB;AAJhB,+GAAA,qBAAqB,OAAA;AACrB,4GAAA,kBAAkB,OAAA;AAClB,6GAAA,mBAAmB,OAAA;AACnB,8GAAA,oBAAoB,OAAA;AAEtB,iCAeiB;AAdf,kHAAA,yBAAyB,OAAA;AACzB,6GAAA,oBAAoB,OAAA;AACpB,8FAAA,KAAK,OAAA;AACL,2GAAA,kBAAkB,OAAA;AAClB,kHAAA,yBAAyB,OAAA;AACzB,mHAAA,0BAA0B,OAAA;AAC1B,uGAAA,cAAc,OAAA;AACd,qGAAA,YAAY,OAAA;AACZ,+GAAA,sBAAsB,OAAA;AACtB,yGAAA,gBAAgB,OAAA;AAChB,0GAAA,iBAAiB,OAAA;AACjB,kGAAA,SAAS,OAAA;AACT,oHAAA,2BAA2B,OAAA;AAC3B,qGAAA,YAAY,OAAA;AAEd,mCAA0E;AAAjE,mGAAA,SAAS,OAAA;AAAE,uGAAA,aAAa,OAAA;AACjC,iCAAkE;AAAzD,6GAAA,oBAAoB,OAAA;AAAE,0GAAA,iBAAiB,OAAA"}

package/dist/common/logger.d.ts

@@ -0,0 +1,80 @@
+export interface LogParams {
+    module: string;
+    message: string;
+    args?: Record<string, unknown>;
+}
+export type ErrorLogParams = LogParams & {
+    err: Error;
+};
+export type WarnLogParams = LogParams & {
+    err?: Error;
+};
+export interface Logger {
+    trace(params: LogParams): void;
+    debug(params: LogParams): void;
+    info(params: LogParams): void;
+    warn(params: WarnLogParams): void;
+    error(params: ErrorLogParams): void;
+}
+export declare class DefaultLogger implements Logger {
+    trace({ module, message, args }: LogParams): void;
+    debug({ module, message, args }: LogParams): void;
+    info({ module, message, args }: LogParams): void;
+    warn({ module, message, args, err }: WarnLogParams): void;
+    error({ module, message, args, err }: ErrorLogParams): void;
+}
+export type LogWriterParams<Method extends keyof Logger> = Omit<Parameters<Logger[Method]>[0], "module"> & {
+    module?: string;
+};
+export declare class LogWriter {
+    private readonly logger;
+    private readonly module;
+    private readonly logLevel;
+    constructor(logger: Logger, module: string, logLevel: ClickHouseLogLevel);
+    trace(params: LogWriterParams<"trace">): void;
+    debug(params: LogWriterParams<"debug">): void;
+    info(params: LogWriterParams<"info">): void;
+    warn(params: LogWriterParams<"warn">): void;
+    error(params: LogWriterParams<"error">): void;
+}
+/**
+ * Mimics the runtime shape of a numeric TypeScript `enum`: an object with both
+ * forward (`Name -> number`) and reverse (`number -> Name`) mappings. This
+ * preserves backwards compatibility with the previous `enum ClickHouseLogLevel`
+ * — both `ClickHouseLogLevel.TRACE` (returns `0`) and `ClickHouseLogLevel[0]`
+ * (returns `'TRACE'`) continue to work — while staying compatible with the
+ * `--erasableSyntaxOnly` TypeScript option (no TS `enum` declaration).
+ */
+export declare const ClickHouseLogLevel: {
+    /**
+     * A fine-grained debugging event. Might produce a lot of logs, so use with caution.
+     */
+    readonly TRACE: 0;
+    /**
+     * A debugging event. Useful for debugging, but generally not needed in production. Includes technical values that might require redacting.
+     */
+    readonly DEBUG: 1;
+    /**
+     * An informational event. Indicates that an event happened.
+     */
+    readonly INFO: 2;
+    /**
+     * A warning event. Not an error, but is likely more important than an informational event. Addressing should help prevent potential issues.
+     */
+    readonly WARN: 3;
+    /**
+     * An error event. Something went wrong.
+     */
+    readonly ERROR: 4;
+    /**
+     * Logging is turned off.
+     */
+    readonly OFF: 127;
+    readonly 0: "TRACE";
+    readonly 1: "DEBUG";
+    readonly 2: "INFO";
+    readonly 3: "WARN";
+    readonly 4: "ERROR";
+    readonly 127: "OFF";
+};
+export type ClickHouseLogLevel = 0 | 1 | 2 | 3 | 4 | 127;