@clickhouse/client-common 1.20.0 → 1.21.0-head.68dd619.1

package/dist/data_formatter/formatter.js

@@ -7,23 +7,23 @@ exports.isSupportedRawFormat = isSupportedRawFormat;
 exports.validateStreamFormat = validateStreamFormat;
 exports.encodeJSON = encodeJSON;
 exports.StreamableJSONFormats = [
-    'JSONEachRow',
-    'JSONStringsEachRow',
-    'JSONCompactEachRow',
-    'JSONCompactStringsEachRow',
-    'JSONCompactEachRowWithNames',
-    'JSONCompactEachRowWithNamesAndTypes',
-    'JSONCompactStringsEachRowWithNames',
-    'JSONCompactStringsEachRowWithNamesAndTypes',
-    'JSONEachRowWithProgress',
+    "JSONEachRow",
+    "JSONStringsEachRow",
+    "JSONCompactEachRow",
+    "JSONCompactStringsEachRow",
+    "JSONCompactEachRowWithNames",
+    "JSONCompactEachRowWithNamesAndTypes",
+    "JSONCompactStringsEachRowWithNames",
+    "JSONCompactStringsEachRowWithNamesAndTypes",
+    "JSONEachRowWithProgress",
 ];
-exports.RecordsJSONFormats = ['JSONObjectEachRow'];
+exports.RecordsJSONFormats = ["JSONObjectEachRow"];
 exports.SingleDocumentJSONFormats = [
-    'JSON',
-    'JSONStrings',
-    'JSONCompact',
-    'JSONCompactStrings',
-    'JSONColumnsWithMetadata',
+    "JSON",
+    "JSONStrings",
+    "JSONCompact",
+    "JSONCompactStrings",
+    "JSONColumnsWithMetadata",
 ];
 exports.SupportedJSONFormats = [
     ...exports.RecordsJSONFormats,
@@ -31,17 +31,17 @@ exports.SupportedJSONFormats = [
     ...exports.StreamableJSONFormats,
 ];
 exports.SupportedRawFormats = [
-    'CSV',
-    'CSVWithNames',
-    'CSVWithNamesAndTypes',
-    'TabSeparated',
-    'TabSeparatedRaw',
-    'TabSeparatedWithNames',
-    'TabSeparatedWithNamesAndTypes',
-    'CustomSeparated',
-    'CustomSeparatedWithNames',
-    'CustomSeparatedWithNamesAndTypes',
-    'Parquet',
+    "CSV",
+    "CSVWithNames",
+    "CSVWithNamesAndTypes",
+    "TabSeparated",
+    "TabSeparatedRaw",
+    "TabSeparatedWithNames",
+    "TabSeparatedWithNamesAndTypes",
+    "CustomSeparated",
+    "CustomSeparatedWithNames",
+    "CustomSeparatedWithNamesAndTypes",
+    "Parquet",
 ];
 exports.StreamableFormats = [
     ...exports.StreamableJSONFormats,
@@ -59,7 +59,7 @@ function isSupportedRawFormat(dataFormat) {
 }
 function validateStreamFormat(format) {
     if (!exports.StreamableFormats.includes(format)) {
-        throw new Error(`${format} format is not streamable. Streamable formats: ${exports.StreamableFormats.join(',')}`);
+        throw new Error(`${format} format is not streamable. Streamable formats: ${exports.StreamableFormats.join(",")}`);
     }
     return true;
 }
@@ -71,7 +71,7 @@ function validateStreamFormat(format) {
  */
 function encodeJSON(value, format, stringifyFn) {
     if (exports.SupportedJSONFormats.includes(format)) {
-        return stringifyFn(value) + '\n';
+        return stringifyFn(value) + "\n";
     }
     throw new Error(`The client does not support JSON encoding in [${format}] format.`);
 }

package/dist/data_formatter/formatter.js.map

@@ -1 +1 @@
-{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../src/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,CAAA;AACG,QAAA,kBAAkB,GAAG,CAAC,mBAAmB,CAAU,CAAA;AACnD,QAAA,yBAAyB,GAAG;IACvC,MAAM;IACN,aAAa;IACb,aAAa;IACb,oBAAoB;IACpB,yBAAyB;CACjB,CAAA;AACG,QAAA,oBAAoB,GAAG;IAClC,GAAG,0BAAkB;IACrB,GAAG,iCAAyB;IAC5B,GAAG,6BAAqB;CAChB,CAAA;AACG,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,CAAA;AACG,QAAA,iBAAiB,GAAG;IAC/B,GAAG,6BAAqB;IACxB,GAAG,2BAAmB;CACd,CAAA;AAoCV,SAAgB,yBAAyB,CACvC,MAAkB;IAElB,OAAO,CACJ,iCAA+C,CAAC,QAAQ,CAAC,MAAM,CAAC;QAChE,0BAAwC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAC3D,CAAA;AACH,CAAC;AAED,SAAgB,sBAAsB,CACpC,MAAkB;IAElB,OAAQ,6BAA2C,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;AACtE,CAAC;AAED,SAAgB,oBAAoB,CAAC,UAAsB;IACzD,OAAQ,2BAAyC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;AACxE,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,CAAA;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,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,CAAA;IAClC,CAAC;IACD,MAAM,IAAI,KAAK,CACb,iDAAiD,MAAM,WAAW,CACnE,CAAA;AACH,CAAC"}
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../src/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/data_formatter/index.d.ts

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

package/dist/data_formatter/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/data_formatter/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,8CAA2B;AAC3B,6DAAqE;AAA5D,iHAAA,UAAU,OAAA;AAAE,wHAAA,iBAAiB,OAAA;AACtC,iEAA6D;AAApD,4HAAA,mBAAmB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/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/error/error.js

@@ -4,7 +4,21 @@ exports.ClickHouseError = void 0;
 exports.parseError = parseError;
 exports.getCurrentStackTrace = getCurrentStackTrace;
 exports.enhanceStackTrace = enhanceStackTrace;
-const errorRe = /(Code|Error): (?<code>\d+).*Exception: (?<message>.+)\((?<type>(?=.+[A-Z]{3})[A-Z0-9_]+?)\)/s;
+// 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;
@@ -36,20 +50,20 @@ function parseError(input) {
 function getCurrentStackTrace() {
     const stack = new Error().stack;
     if (!stack)
-        return '';
+        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');
+    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 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}`;

package/dist/error/error.js.map

@@ -1 +1 @@
-{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/error/error.ts"],"names":[],"mappings":";;;AAwBA,gCAUC;AAID,oDAUC;AAKD,8CAWC;AAhED,MAAM,OAAO,GACX,8FAA8F,CAAA;AAQhG,wDAAwD;AACxD,MAAa,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAAQ;IACZ,IAAI,CAAoB;IACjC,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAyB;QACxD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAEhB,qCAAqC;QACrC,gIAAgI;QAChI,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAA;IACxD,CAAC;CACF;AAZD,0CAYC;AAED,SAAgB,UAAU,CAAC,KAAqB;IAC9C,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAA;IAC3C,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAA;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACpC,MAAM,MAAM,GAAG,KAAK,EAAE,MAA2C,CAAA;IACjE,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,IAAI,eAAe,CAAC,MAAM,CAAC,CAAA;IACpC,CAAC;SAAM,CAAC;QACN,OAAO,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAA;IAChD,CAAC;AACH,CAAC;AAED;sGACsG;AACtG,SAAgB,oBAAoB;IAClC,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC,KAAK,CAAA;IAC/B,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAA;IAErB,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,CAAA;AACxD,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,CAAA;QACjD,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAA;QAC3D,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAA;QAC3D,GAAG,CAAC,KAAK,GAAG,GAAG,SAAS,KAAK,UAAU,KAAK,QAAQ,EAAE,CAAA;IACxD,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/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/error/index.d.ts

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

package/dist/error/index.js.map

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

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 /** 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';
+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, 
@@ -19,40 +19,41 @@ 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';
+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';
+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';
+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';
+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';
+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';
+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, 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, 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';
+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, 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/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.enhanceStackTrace = exports.getCurrentStackTrace = exports.DefaultLogger = exports.LogWriter = exports.CARET_RETURN = exports.extractErrorAtTheEndOfChunk = exports.isJWTAuth = exports.isCredentialsAuth = exports.withHttpSettings = exports.withCompressionHeaders = exports.transformUrl = exports.toSearchParams = 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.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.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. */
@@ -45,6 +46,11 @@ Object.defineProperty(exports, "SimpleColumnTypes", { enumerable: true, get: fun
 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; } });
@@ -63,6 +69,9 @@ 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; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,kDAAkD;AAClD,mCAgBiB;AAVf,mOAAmO;AACnO,0GAAA,gBAAgB,OAAA;AA2BlB,mDAeyB;AAdvB,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,iCAKgB;AAJd,uLAAuL;AACvL,wGAAA,eAAe,OAAA;AACf,kLAAkL;AAClL,mGAAA,UAAU,OAAA;AAEZ,mCAOiB;AANf,0LAA0L;AAC1L,4GAAA,kBAAkB,OAAA;AAoBpB,uDAO2B;AANzB,qLAAqL;AACrL,iHAAA,aAAa,OAAA;AACb,6KAA6K;AAC7K,yGAAA,KAAK,OAAA;AACL,mLAAmL;AACnL,+GAAA,WAAW,OAAA;AAEb,uCAKmB;AAFjB,mLAAmL;AACnL,uGAAA,WAAW,OAAA;AAiBb,iCAOgB;AANd,yLAAyL;AACzL,0GAAA,iBAAiB,OAAA;AACjB,uLAAuL;AACvL,wGAAA,eAAe,OAAA;AACf,2LAA2L;AAC3L,4GAAA,mBAAmB,OAAA;AAGrB,gEAAgE;AAChE,mDAQyB;AAPvB,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,mCAUiB;AAJf,+GAAA,qBAAqB,OAAA;AACrB,4GAAA,kBAAkB,OAAA;AAClB,6GAAA,mBAAmB,OAAA;AACnB,8GAAA,oBAAoB,OAAA;AAEtB,iCAYgB;AAXd,kHAAA,yBAAyB,OAAA;AACzB,6GAAA,oBAAoB,OAAA;AACpB,8FAAA,KAAK,OAAA;AACL,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,mCAAyE;AAAhE,mGAAA,SAAS,OAAA;AAAE,uGAAA,aAAa,OAAA;AACjC,iCAAiE;AAAxD,6GAAA,oBAAoB,OAAA;AAAE,0GAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;AAAA,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/logger.d.ts

@@ -23,7 +23,7 @@ export declare class DefaultLogger implements Logger {
     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'> & {
+export type LogWriterParams<Method extends keyof Logger> = Omit<Parameters<Logger[Method]>[0], "module"> & {
     module?: string;
 };
 export declare class LogWriter {
@@ -31,35 +31,50 @@ export declare class LogWriter {
     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;
+    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;
 }
-export declare enum ClickHouseLogLevel {
+/**
+ * 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.
      */
-    TRACE = 0,
+    readonly TRACE: 0;
     /**
      * A debugging event. Useful for debugging, but generally not needed in production. Includes technical values that might require redacting.
      */
-    DEBUG = 1,
+    readonly DEBUG: 1;
     /**
      * An informational event. Indicates that an event happened.
      */
-    INFO = 2,
+    readonly INFO: 2;
     /**
      * A warning event. Not an error, but is likely more important than an informational event. Addressing should help prevent potential issues.
      */
-    WARN = 3,
+    readonly WARN: 3;
     /**
      * An error event. Something went wrong.
      */
-    ERROR = 4,
+    readonly ERROR: 4;
     /**
      * Logging is turned off.
      */
-    OFF = 127
-}
+    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;

package/dist/logger.js

@@ -4,51 +4,51 @@ exports.ClickHouseLogLevel = exports.LogWriter = exports.DefaultLogger = void 0;
 class DefaultLogger {
     trace({ module, message, args }) {
         const params = [
-            formatMessage({ module, message, level: 'TRACE' }),
+            formatMessage({ module, message, level: "TRACE" }),
         ];
         if (args) {
-            params.push('\nArguments:', args);
+            params.push("\nArguments:", args);
         }
         console.debug(...params);
     }
     debug({ module, message, args }) {
         const params = [
-            formatMessage({ module, message, level: 'DEBUG' }),
+            formatMessage({ module, message, level: "DEBUG" }),
         ];
         if (args) {
-            params.push('\nArguments:', args);
+            params.push("\nArguments:", args);
         }
         console.debug(...params);
     }
     info({ module, message, args }) {
         const params = [
-            formatMessage({ module, message, level: 'INFO' }),
+            formatMessage({ module, message, level: "INFO" }),
         ];
         if (args) {
-            params.push('\nArguments:', args);
+            params.push("\nArguments:", args);
         }
         console.info(...params);
     }
     warn({ module, message, args, err }) {
         const params = [
-            formatMessage({ module, message, level: 'WARN' }),
+            formatMessage({ module, message, level: "WARN" }),
         ];
         if (args) {
-            params.push('\nArguments:', args);
+            params.push("\nArguments:", args);
         }
         if (err) {
-            params.push('\nCaused by:', err);
+            params.push("\nCaused by:", err);
         }
         console.warn(...params);
     }
     error({ module, message, args, err }) {
         const params = [
-            formatMessage({ module, message, level: 'ERROR' }),
+            formatMessage({ module, message, level: "ERROR" }),
         ];
         if (args) {
-            params.push('\nArguments:', args);
+            params.push("\nArguments:", args);
         }
-        params.push('\nCaused by:', err);
+        params.push("\nCaused by:", err);
         console.error(...params);
     }
 }
@@ -62,11 +62,11 @@ class LogWriter {
         this.module = module;
         this.logLevel = logLevel;
         this.info({
-            message: `Log level is set to ${ClickHouseLogLevel[this.logLevel]}`,
+            message: `Log level is set to ${exports.ClickHouseLogLevel[this.logLevel]}`,
         });
     }
     trace(params) {
-        if (this.logLevel <= ClickHouseLogLevel.TRACE) {
+        if (this.logLevel <= exports.ClickHouseLogLevel.TRACE) {
             this.logger.trace({
                 ...params,
                 module: params.module ?? this.module,
@@ -74,7 +74,7 @@ class LogWriter {
         }
     }
     debug(params) {
-        if (this.logLevel <= ClickHouseLogLevel.DEBUG) {
+        if (this.logLevel <= exports.ClickHouseLogLevel.DEBUG) {
             this.logger.debug({
                 ...params,
                 module: params.module ?? this.module,
@@ -82,7 +82,7 @@ class LogWriter {
         }
     }
     info(params) {
-        if (this.logLevel <= ClickHouseLogLevel.INFO) {
+        if (this.logLevel <= exports.ClickHouseLogLevel.INFO) {
             this.logger.info({
                 ...params,
                 module: params.module ?? this.module,
@@ -90,7 +90,7 @@ class LogWriter {
         }
     }
     warn(params) {
-        if (this.logLevel <= ClickHouseLogLevel.WARN) {
+        if (this.logLevel <= exports.ClickHouseLogLevel.WARN) {
             this.logger.warn({
                 ...params,
                 module: params.module ?? this.module,
@@ -98,7 +98,7 @@ class LogWriter {
         }
     }
     error(params) {
-        if (this.logLevel <= ClickHouseLogLevel.ERROR) {
+        if (this.logLevel <= exports.ClickHouseLogLevel.ERROR) {
             this.logger.error({
                 ...params,
                 module: params.module ?? this.module,
@@ -107,33 +107,46 @@ class LogWriter {
     }
 }
 exports.LogWriter = LogWriter;
-var ClickHouseLogLevel;
-(function (ClickHouseLogLevel) {
+/**
+ * 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).
+ */
+exports.ClickHouseLogLevel = {
     /**
      * A fine-grained debugging event. Might produce a lot of logs, so use with caution.
      */
-    ClickHouseLogLevel[ClickHouseLogLevel["TRACE"] = 0] = "TRACE";
+    TRACE: 0,
     /**
      * A debugging event. Useful for debugging, but generally not needed in production. Includes technical values that might require redacting.
      */
-    ClickHouseLogLevel[ClickHouseLogLevel["DEBUG"] = 1] = "DEBUG";
+    DEBUG: 1,
     /**
      * An informational event. Indicates that an event happened.
      */
-    ClickHouseLogLevel[ClickHouseLogLevel["INFO"] = 2] = "INFO";
+    INFO: 2,
     /**
      * A warning event. Not an error, but is likely more important than an informational event. Addressing should help prevent potential issues.
      */
-    ClickHouseLogLevel[ClickHouseLogLevel["WARN"] = 3] = "WARN";
+    WARN: 3,
     /**
      * An error event. Something went wrong.
      */
-    ClickHouseLogLevel[ClickHouseLogLevel["ERROR"] = 4] = "ERROR";
+    ERROR: 4,
     /**
      * Logging is turned off.
      */
-    ClickHouseLogLevel[ClickHouseLogLevel["OFF"] = 127] = "OFF";
-})(ClickHouseLogLevel || (exports.ClickHouseLogLevel = ClickHouseLogLevel = {}));
+    OFF: 127,
+    0: "TRACE",
+    1: "DEBUG",
+    2: "INFO",
+    3: "WARN",
+    4: "ERROR",
+    127: "OFF",
+};
 function formatMessage({ level, module, message, }) {
     const ts = new Date().toISOString();
     return `[${ts}][${level}][@clickhouse/client][${module}] ${message}`;

package/dist/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}