@clickhouse/client-common 1.20.0 → 1.21.0

package/dist/settings.d.ts

@@ -1,4 +1,4 @@
-import type { DataFormat } from './data_formatter';
+import type { DataFormat } from "./data_formatter";
 /**
  * @see {@link https://github.com/ClickHouse/ClickHouse/blob/46ed4f6cdf68fbbdc59fbe0f0bfa9a361cc0dec1/src/Core/Settings.h}
  * @see {@link https://github.com/ClickHouse/ClickHouse/blob/eae2667a1c29565c801be0ffd465f8bfcffe77ef/src/Storages/MergeTree/MergeTreeSettings.h}
@@ -1602,6 +1602,23 @@ interface ClickHouseHTTPSettings {
      *  Additionally, this is useful when executing DDLs on clustered environments,
      *  as the client will receive the response only when the DDL is applied on all nodes of the cluster. */
     wait_end_of_query: Bool;
+    /** Number of bytes in the result to buffer in the server memory.
+     *  If the result body is larger than this threshold, the buffer is written to the HTTP channel,
+     *  and the remaining data is sent directly to the HTTP channel. */
+    buffer_size: UInt64;
+    /** If enabled, the server compresses the data it sends to the client using the internal ClickHouse
+     *  compression format (not a standard HTTP one). The compressed data has a non-standard format,
+     *  and the `clickhouse-compressor` program is required to work with it.
+     *  For standard HTTP (gzip) compression, use the `compression` client configuration option instead. */
+    compress: Bool;
+    /** If enabled, the server decompresses the data passed in the POST request body, expecting it to be
+     *  compressed using the internal ClickHouse compression format (not a standard HTTP one). */
+    decompress: Bool;
+    /** Can be passed as the quota key (any string).
+     *  @see https://clickhouse.com/docs/operations/quotas */
+    quota_key: string;
+    /** If enabled, include the stack trace in the response body when an exception occurs. */
+    stacktrace: Bool;
     /** Format to use if a SELECT query is executed without a FORMAT clause.
      *  Only useful for the {@link ClickHouseClient.exec} method,
      *  as {@link ClickHouseClient.query} method always attaches this clause. */
@@ -1641,7 +1658,7 @@ export interface MergeTreeSettings {
     /** Check columns or columns by hash for sampling are unsigned integer. */
     check_sample_column_is_correct?: Bool;
     /** Is the Replicated Merge cleanup has to be done automatically at each merge or manually (possible values are 'Always'/'Never' (default)) */
-    clean_deleted_rows?: 'Always' | 'Never';
+    clean_deleted_rows?: "Always" | "Never";
     /** Minimum period to clean old queue logs, blocks hashes and parts. */
     cleanup_delay_period?: UInt64;
     /** Add uniformly distributed value from 0 to x seconds to cleanup_delay_period to avoid thundering herd effect and subsequent DoS of ZooKeeper in case of very large number of tables. */
@@ -1942,32 +1959,32 @@ export declare class SettingsMap {
     toString(): string;
     static from(record: Record<string, string>): SettingsMap;
 }
-export type LoadBalancing = 'random' | 'nearest_hostname' | 'in_order' | 'first_or_random' | 'round_robin';
-export type TotalsMode = 'before_having' | 'after_having_inclusive' | 'after_having_exclusive' | 'after_having_auto';
-export type DistributedProductMode = 'deny' | 'local' | 'global' | 'allow';
-export type LogsLevel = 'none' | 'fatal' | 'error' | 'warning' | 'information' | 'debug' | 'trace' | 'test';
-export type LogQueriesType = 'QUERY_START' | 'QUERY_FINISH' | 'EXCEPTION_BEFORE_START' | 'EXCEPTION_WHILE_PROCESSING';
-export type DefaultTableEngine = 'Memory' | 'ReplicatedMergeTree' | 'ReplacingMergeTree' | 'MergeTree' | 'StripeLog' | 'ReplicatedReplacingMergeTree' | 'Log' | 'None';
-export type MySQLDataTypesSupport = '' | 'date2String' | 'date2Date32' | 'datetime64' | 'decimal';
-export type DistributedDDLOutputMode = 'never_throw' | 'null_status_on_timeout' | 'throw' | 'none';
-export type ShortCircuitFunctionEvaluation = 'force_enable' | 'disable' | 'enable';
-export type TransactionsWaitCSNMode = 'wait_unknown' | 'wait' | 'async';
-export type EscapingRule = 'CSV' | 'JSON' | 'Quoted' | 'Raw' | 'XML' | 'Escaped' | 'None';
-export type DateTimeOutputFormat = 'simple' | 'iso' | 'unix_timestamp';
-export type DateTimeInputFormat = 'best_effort_us' | 'best_effort' | 'basic';
-export type MsgPackUUIDRepresentation = 'ext' | 'str' | 'bin';
-export type OverflowMode = 'break' | 'throw';
-export type OverflowModeGroupBy = OverflowMode | 'any';
-export type JoinStrictness = 'ANY' | 'ALL' | '';
-export type JoinAlgorithm = 'prefer_partial_merge' | 'hash' | 'parallel_hash' | 'partial_merge' | 'auto' | 'default' | 'direct' | 'full_sorting_merge' | 'grace_hash';
-export type Dialect = 'clickhouse' | 'kusto' | 'kusto_auto' | 'prql';
-export type CapnProtoEnumComparingMode = 'by_names' | 'by_values' | 'by_names_case_insensitive';
-export type ParquetCompression = 'none' | 'snappy' | 'zstd' | 'gzip' | 'lz4' | 'brotli';
-export type ArrowCompression = 'none' | 'lz4_frame' | 'zstd';
-export type ORCCompression = 'none' | 'snappy' | 'zstd' | 'gzip' | 'lz4';
-export type SetOperationMode = '' | 'ALL' | 'DISTINCT';
-export type LocalFSReadMethod = 'read' | 'pread' | 'mmap';
-export type ParallelReplicasCustomKeyFilterType = 'default' | 'range';
-export type IntervalOutputFormat = 'kusto' | 'numeric';
-export type ParquetVersion = '1.0' | '2.4' | '2.6' | '2.latest';
+export type LoadBalancing = "random" | "nearest_hostname" | "in_order" | "first_or_random" | "round_robin";
+export type TotalsMode = "before_having" | "after_having_inclusive" | "after_having_exclusive" | "after_having_auto";
+export type DistributedProductMode = "deny" | "local" | "global" | "allow";
+export type LogsLevel = "none" | "fatal" | "error" | "warning" | "information" | "debug" | "trace" | "test";
+export type LogQueriesType = "QUERY_START" | "QUERY_FINISH" | "EXCEPTION_BEFORE_START" | "EXCEPTION_WHILE_PROCESSING";
+export type DefaultTableEngine = "Memory" | "ReplicatedMergeTree" | "ReplacingMergeTree" | "MergeTree" | "StripeLog" | "ReplicatedReplacingMergeTree" | "Log" | "None";
+export type MySQLDataTypesSupport = "" | "date2String" | "date2Date32" | "datetime64" | "decimal";
+export type DistributedDDLOutputMode = "never_throw" | "null_status_on_timeout" | "throw" | "none";
+export type ShortCircuitFunctionEvaluation = "force_enable" | "disable" | "enable";
+export type TransactionsWaitCSNMode = "wait_unknown" | "wait" | "async";
+export type EscapingRule = "CSV" | "JSON" | "Quoted" | "Raw" | "XML" | "Escaped" | "None";
+export type DateTimeOutputFormat = "simple" | "iso" | "unix_timestamp";
+export type DateTimeInputFormat = "best_effort_us" | "best_effort" | "basic";
+export type MsgPackUUIDRepresentation = "ext" | "str" | "bin";
+export type OverflowMode = "break" | "throw";
+export type OverflowModeGroupBy = OverflowMode | "any";
+export type JoinStrictness = "ANY" | "ALL" | "";
+export type JoinAlgorithm = "prefer_partial_merge" | "hash" | "parallel_hash" | "partial_merge" | "auto" | "default" | "direct" | "full_sorting_merge" | "grace_hash";
+export type Dialect = "clickhouse" | "kusto" | "kusto_auto" | "prql";
+export type CapnProtoEnumComparingMode = "by_names" | "by_values" | "by_names_case_insensitive";
+export type ParquetCompression = "none" | "snappy" | "zstd" | "gzip" | "lz4" | "brotli";
+export type ArrowCompression = "none" | "lz4_frame" | "zstd";
+export type ORCCompression = "none" | "snappy" | "zstd" | "gzip" | "lz4";
+export type SetOperationMode = "" | "ALL" | "DISTINCT";
+export type LocalFSReadMethod = "read" | "pread" | "mmap";
+export type ParallelReplicasCustomKeyFilterType = "default" | "range";
+export type IntervalOutputFormat = "kusto" | "numeric";
+export type ParquetVersion = "1.0" | "2.4" | "2.6" | "2.latest";
 export {};

package/dist/settings.js

@@ -9,7 +9,7 @@ class SettingsMap {
     toString() {
         return `{${Object.entries(this.record)
             .map(([k, v]) => `'${k}':'${v}'`)
-            .join(',')}}`;
+            .join(",")}}`;
     }
     static from(record) {
         return new this(record);

package/dist/settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":";;;AA85DA,MAAa,WAAW;IACe;IAArC,YAAqC,MAA8B;QAA9B,WAAM,GAAN,MAAM,CAAwB;IAAG,CAAC;IAEvE,QAAQ;QACN,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;aACnC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;aAChC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA;IACjB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,MAA8B;QACxC,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,CAAA;IACzB,CAAC;CACF;AAZD,kCAYC"}
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":";;;AA+6DA,MAAa,WAAW;IACL,MAAM,CAAyB;IAChD,YAAoB,MAA8B;QAChD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;aACnC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;aAChC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAClB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,MAA8B;QACxC,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;CACF;AAfD,kCAeC"}

package/dist/tracing.d.ts

@@ -0,0 +1,146 @@
+/**
+ * A minimal, dependency-free tracer interface that is a structural subset of
+ * the {@link https://opentelemetry.io/docs/specs/otel/trace/api/#tracer OpenTelemetry `Tracer` API}.
+ *
+ * The shapes below are deliberately declared so that a raw OpenTelemetry
+ * tracer (the object returned by `trace.getTracer(...)` from
+ * `@opentelemetry/api`) is assignable to {@link ClickHouseTracer} **as-is**,
+ * with no adapter and no casts:
+ *
+ * ```ts
+ * import { trace } from '@opentelemetry/api'
+ * const client = createClient({ tracer: trace.getTracer('clickhouse-js') })
+ * ```
+ *
+ * At the same time, the client itself imports nothing from OpenTelemetry -
+ * non-OTEL backends (Prometheus counters, an `EventEmitter`, a plain logger)
+ * can implement the same small surface directly.
+ *
+ * When a {@link ClickHouseTracer} is provided via
+ * {@link BaseClickHouseClientConfigOptions.tracer}, the client runs each
+ * tracked operation (`query`, `command`, `exec`, `insert`, `ping`) inside
+ * {@link ClickHouseTracer.startActiveSpan}, mutates the provided
+ * {@link ClickHouseSpan} during the operation
+ * ({@link ClickHouseSpan.setAttributes}, {@link ClickHouseSpan.setStatus},
+ * {@link ClickHouseSpan.recordException}), and calls
+ * {@link ClickHouseSpan.end} exactly once. For `command`, `exec`, `insert`,
+ * and `ping`, the span ends when the operation settles (regardless of
+ * outcome). For `query`, two spans are emitted: the `clickhouse.query` span
+ * ends as soon as the HTTP response headers are received; a child
+ * `clickhouse.query.stream` span is then handed to the `ResultSet`, which
+ * tracks the streaming progress and ends it when the response stream is fully
+ * consumed, closed, or fails.
+ *
+ * Calls are inlined directly into the client's hot path - there is no
+ * defensive wrapper around them. Any exception thrown by a tracer or span
+ * method will propagate up to the caller of the corresponding client method
+ * (`query`/`command`/`exec`/`insert`/`ping`). Implementations are therefore
+ * expected to be non-throwing; a trivial e2e test against your tracer is
+ * usually enough to catch regressions.
+ */
+export interface ClickHouseTracer<TSpan extends ClickHouseSpan = ClickHouseSpan> {
+    /**
+     * Called when a tracked operation begins. Same shape as OpenTelemetry's
+     * `Tracer.startActiveSpan(name, options, fn)` overload: implementations
+     * must invoke `fn` with the new span and return `fn`'s result untouched.
+     * The client runs the entire operation (an `async` function) inside `fn`,
+     * mutates the span during the operation, and ends it exactly once.
+     *
+     * @note The callback is asynchronous under the hood: the client keeps using
+     * the span across `await` points inside `fn`. For OpenTelemetry, active-span
+     * context propagation across those `await`s requires the
+     * `AsyncLocalStorageContextManager` (from
+     * `@opentelemetry/context-async-hooks`) to be registered - which is the
+     * default context manager in the OpenTelemetry Node.js SDK
+     * (`@opentelemetry/sdk-node` / `NodeTracerProvider`). With it in place,
+     * auto-instrumented child spans (e.g. from
+     * `@opentelemetry/instrumentation-http`) are parented under the ClickHouse
+     * operation span.
+     */
+    startActiveSpan<T>(name: string, options: ClickHouseSpanOptions, fn: (span: TSpan) => T): T;
+}
+/** Structural subset of the OpenTelemetry `Span` interface - a real OTEL
+ *  `Span` is assignable to this type as-is. Methods are declared as
+ *  `void`-returning, so OTEL's chainable `this`-returning methods remain
+ *  compatible. */
+export interface ClickHouseSpan {
+    /** Attach additional attributes to an in-flight span. Called at least once
+     *  for every span - typically right before {@link ClickHouseSpan.end} -
+     *  with operation-specific attributes such as `clickhouse.request.query_id`. */
+    setAttributes(attributes: ClickHouseSpanAttributes): void;
+    /** Set the logical status of the span. The codes are value-identical to
+     *  OTEL's `SpanStatusCode`; see {@link ClickHouseSpanStatusCode}. */
+    setStatus(status: ClickHouseSpanStatus): void;
+    /** Attach an exception that occurred during the span. Called before
+     *  {@link ClickHouseSpan.setStatus} with the `ERROR` code, before
+     *  {@link ClickHouseSpan.end}. Non-`Error` throwables are normalized
+     *  to `Error` by the client before this call. */
+    recordException(error: Error): void;
+    /** Called exactly once per span, regardless of success or failure. */
+    end(): void;
+}
+/** Structural subset of OTEL's `SpanOptions`. */
+export interface ClickHouseSpanOptions {
+    /** Value-identical to OTEL's `SpanKind`; see {@link ClickHouseSpanKind}.
+     *  The client always passes {@link ClickHouseSpanKind.CLIENT}, per the
+     *  OTEL database semantic conventions. */
+    kind?: number;
+    /** Initial attributes for the span. */
+    attributes?: ClickHouseSpanAttributes;
+}
+/** Span status; `code` values are listed in {@link ClickHouseSpanStatusCode}
+ *  and are value-identical to OTEL's `SpanStatusCode`. */
+export interface ClickHouseSpanStatus {
+    code: number;
+    message?: string;
+}
+/** Value-identical to OTEL's `SpanStatusCode`, so non-OTEL implementations
+ *  do not have to deal with magic numbers. */
+export declare const ClickHouseSpanStatusCode: {
+    readonly UNSET: 0;
+    readonly OK: 1;
+    readonly ERROR: 2;
+};
+/** Value-identical to OTEL's `SpanKind`. The client only ever uses
+ *  {@link ClickHouseSpanKind.CLIENT}. */
+export declare const ClickHouseSpanKind: {
+    readonly INTERNAL: 0;
+    readonly SERVER: 1;
+    readonly CLIENT: 2;
+    readonly PRODUCER: 3;
+    readonly CONSUMER: 4;
+};
+/** Free-form attribute bag; a subset of OTEL's `Attributes`. Implementations
+ *  should be tolerant of `undefined` values (skip them) and stringify
+ *  non-primitive values as needed. */
+export type ClickHouseSpanAttributes = Record<string, string | number | boolean | undefined>;
+/** Span name constants used by the client when starting spans.
+ *  Exposed so that adapters and tests can match on them. */
+export declare const ClickHouseSpanNames: {
+    readonly query: "clickhouse.query";
+    /** A child of {@link ClickHouseSpanNames.query} that covers the lifetime
+     *  of the `ResultSet` stream - from the first byte read to full
+     *  consumption, cancellation, or failure.  Ends with
+     *  `clickhouse.response.decoded_bytes` and (for row-streaming paths)
+     *  `db.response.returned_rows`. */
+    readonly query_stream: "clickhouse.query.stream";
+    readonly command: "clickhouse.command";
+    readonly exec: "clickhouse.exec";
+    readonly insert: "clickhouse.insert";
+    readonly ping: "clickhouse.ping";
+};
+export type ClickHouseSpanName = (typeof ClickHouseSpanNames)[keyof typeof ClickHouseSpanNames];
+/** Shared no-op span handed out by {@link NoopClickHouseTracer}. @internal */
+export declare const NoopClickHouseSpan: ClickHouseSpan;
+/** No-op tracer assigned once at client creation when no tracer is
+ *  configured, so the hot path stays branch-free (monomorphic call sites
+ *  that the JIT can inline). @internal */
+export declare const NoopClickHouseTracer: ClickHouseTracer;
+/** Records the exception on the span and marks it with the ERROR status,
+ *  normalizing non-`Error` throwables to `Error`.
+ *
+ *  Sets the {@link https://opentelemetry.io/docs/specs/semconv/registry/attributes/error/#error-type `error.type`}
+ *  attribute to the error class name (e.g. `ClickHouseError`, `TypeError`),
+ *  and, for server-side errors ({@link ClickHouseError}), the numeric server
+ *  error code as `clickhouse.error.code`. */
+export declare function recordSpanError(span: ClickHouseSpan, err: unknown): void;

package/dist/tracing.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoopClickHouseTracer = exports.NoopClickHouseSpan = exports.ClickHouseSpanNames = exports.ClickHouseSpanKind = exports.ClickHouseSpanStatusCode = void 0;
+exports.recordSpanError = recordSpanError;
+const error_1 = require("./error");
+/** Value-identical to OTEL's `SpanStatusCode`, so non-OTEL implementations
+ *  do not have to deal with magic numbers. */
+exports.ClickHouseSpanStatusCode = {
+    UNSET: 0,
+    OK: 1,
+    ERROR: 2,
+};
+/** Value-identical to OTEL's `SpanKind`. The client only ever uses
+ *  {@link ClickHouseSpanKind.CLIENT}. */
+exports.ClickHouseSpanKind = {
+    INTERNAL: 0,
+    SERVER: 1,
+    CLIENT: 2,
+    PRODUCER: 3,
+    CONSUMER: 4,
+};
+/** Span name constants used by the client when starting spans.
+ *  Exposed so that adapters and tests can match on them. */
+exports.ClickHouseSpanNames = {
+    query: "clickhouse.query",
+    /** A child of {@link ClickHouseSpanNames.query} that covers the lifetime
+     *  of the `ResultSet` stream - from the first byte read to full
+     *  consumption, cancellation, or failure.  Ends with
+     *  `clickhouse.response.decoded_bytes` and (for row-streaming paths)
+     *  `db.response.returned_rows`. */
+    query_stream: "clickhouse.query.stream",
+    command: "clickhouse.command",
+    exec: "clickhouse.exec",
+    insert: "clickhouse.insert",
+    ping: "clickhouse.ping",
+};
+const noop = () => undefined;
+/** Shared no-op span handed out by {@link NoopClickHouseTracer}. @internal */
+exports.NoopClickHouseSpan = {
+    setAttributes: noop,
+    setStatus: noop,
+    recordException: noop,
+    end: noop,
+};
+/** No-op tracer assigned once at client creation when no tracer is
+ *  configured, so the hot path stays branch-free (monomorphic call sites
+ *  that the JIT can inline). @internal */
+exports.NoopClickHouseTracer = {
+    startActiveSpan: (_name, _options, fn) => fn(exports.NoopClickHouseSpan),
+};
+/** Records the exception on the span and marks it with the ERROR status,
+ *  normalizing non-`Error` throwables to `Error`.
+ *
+ *  Sets the {@link https://opentelemetry.io/docs/specs/semconv/registry/attributes/error/#error-type `error.type`}
+ *  attribute to the error class name (e.g. `ClickHouseError`, `TypeError`),
+ *  and, for server-side errors ({@link ClickHouseError}), the numeric server
+ *  error code as `clickhouse.error.code`. */
+function recordSpanError(span, err) {
+    const error = err instanceof Error ? err : new Error(String(err));
+    const attributes = {
+        "error.type": error.constructor.name,
+    };
+    if (error instanceof error_1.ClickHouseError) {
+        const code = Number(error.code);
+        attributes["clickhouse.error.code"] = Number.isNaN(code)
+            ? error.code
+            : code;
+    }
+    span.setAttributes(attributes);
+    span.recordException(error);
+    span.setStatus({
+        code: exports.ClickHouseSpanStatusCode.ERROR,
+        message: error.message,
+    });
+}
+//# sourceMappingURL=tracing.js.map

package/dist/tracing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../src/tracing.ts"],"names":[],"mappings":";;;AA+KA,0CAiBC;AAhMD,mCAA0C;AA4G1C;8CAC8C;AACjC,QAAA,wBAAwB,GAAG;IACtC,KAAK,EAAE,CAAC;IACR,EAAE,EAAE,CAAC;IACL,KAAK,EAAE,CAAC;CACA,CAAC;AAEX;yCACyC;AAC5B,QAAA,kBAAkB,GAAG;IAChC,QAAQ,EAAE,CAAC;IACX,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC;CACH,CAAC;AAUX;4DAC4D;AAC/C,QAAA,mBAAmB,GAAG;IACjC,KAAK,EAAE,kBAAkB;IACzB;;;;uCAImC;IACnC,YAAY,EAAE,yBAAyB;IACvC,OAAO,EAAE,oBAAoB;IAC7B,IAAI,EAAE,iBAAiB;IACvB,MAAM,EAAE,mBAAmB;IAC3B,IAAI,EAAE,iBAAiB;CACf,CAAC;AAIX,MAAM,IAAI,GAAG,GAAS,EAAE,CAAC,SAAS,CAAC;AACnC,8EAA8E;AACjE,QAAA,kBAAkB,GAAmB;IAChD,aAAa,EAAE,IAAI;IACnB,SAAS,EAAE,IAAI;IACf,eAAe,EAAE,IAAI;IACrB,GAAG,EAAE,IAAI;CACV,CAAC;AAEF;;0CAE0C;AAC7B,QAAA,oBAAoB,GAAqB;IACpD,eAAe,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,0BAAkB,CAAC;CACjE,CAAC;AAEF;;;;;;6CAM6C;AAC7C,SAAgB,eAAe,CAAC,IAAoB,EAAE,GAAY;IAChE,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAClE,MAAM,UAAU,GAA6B;QAC3C,YAAY,EAAE,KAAK,CAAC,WAAW,CAAC,IAAI;KACrC,CAAC;IACF,IAAI,KAAK,YAAY,uBAAe,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,UAAU,CAAC,uBAAuB,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;YACtD,CAAC,CAAC,KAAK,CAAC,IAAI;YACZ,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IACD,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAC/B,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,CAAC,SAAS,CAAC;QACb,IAAI,EAAE,gCAAwB,CAAC,KAAK;QACpC,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/connection.d.ts

@@ -1,4 +1,4 @@
-import type { ClickHouseSettings } from '../settings';
+import type { ClickHouseSettings } from "../settings";
 export type HttpHeader = number | string | string[];
 export type HttpHeaders = Record<string, HttpHeader | undefined>;
 export declare function withCompressionHeaders({ headers, enable_request_compression, enable_response_compression, }: {

package/dist/utils/connection.js

@@ -9,8 +9,8 @@ exports.isCredentialsAuth = isCredentialsAuth;
 function withCompressionHeaders({ headers, enable_request_compression, enable_response_compression, }) {
     return {
         ...headers,
-        ...(enable_response_compression ? { 'Accept-Encoding': 'gzip' } : {}),
-        ...(enable_request_compression ? { 'Content-Encoding': 'gzip' } : {}),
+        ...(enable_response_compression ? { "Accept-Encoding": "gzip" } : {}),
+        ...(enable_request_compression ? { "Content-Encoding": "gzip" } : {}),
     };
 }
 function withHttpSettings(clickhouse_settings, compression) {
@@ -27,13 +27,13 @@ function isSuccessfulResponse(statusCode) {
     return Boolean(statusCode && 200 <= statusCode && statusCode < 300);
 }
 function isJWTAuth(auth) {
-    return auth !== null && typeof auth === 'object' && 'access_token' in auth;
+    return auth !== null && typeof auth === "object" && "access_token" in auth;
 }
 function isCredentialsAuth(auth) {
     return (auth !== null &&
-        typeof auth === 'object' &&
-        'username' in auth &&
-        'password' in auth);
+        typeof auth === "object" &&
+        "username" in auth &&
+        "password" in auth);
 }
-exports.EXCEPTION_TAG_HEADER_NAME = 'x-clickhouse-exception-tag';
+exports.EXCEPTION_TAG_HEADER_NAME = "x-clickhouse-exception-tag";
 //# sourceMappingURL=connection.js.map

package/dist/utils/connection.js.map

@@ -1 +1 @@
-{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/utils/connection.ts"],"names":[],"mappings":";;;AAKA,wDAcC;AAED,4CAYC;AAED,oDAEC;AAED,8BAEC;AAED,8CASC;AA/CD,SAAgB,sBAAsB,CAAC,EACrC,OAAO,EACP,0BAA0B,EAC1B,2BAA2B,GAK5B;IACC,OAAO;QACL,GAAG,OAAO;QACV,GAAG,CAAC,2BAA2B,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,GAAG,CAAC,0BAA0B,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtE,CAAA;AACH,CAAC;AAED,SAAgB,gBAAgB,CAC9B,mBAAwC,EACxC,WAAqB;IAErB,OAAO;QACL,GAAG,CAAC,WAAW;YACb,CAAC,CAAC;gBACE,uBAAuB,EAAE,CAAC;aAC3B;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,mBAAmB;KACvB,CAAA;AACH,CAAC;AAED,SAAgB,oBAAoB,CAAC,UAAmB;IACtD,OAAO,OAAO,CAAC,UAAU,IAAI,GAAG,IAAI,UAAU,IAAI,UAAU,GAAG,GAAG,CAAC,CAAA;AACrE,CAAC;AAED,SAAgB,SAAS,CAAC,IAAa;IACrC,OAAO,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,cAAc,IAAI,IAAI,CAAA;AAC5E,CAAC;AAED,SAAgB,iBAAiB,CAC/B,IAAa;IAEb,OAAO,CACL,IAAI,KAAK,IAAI;QACb,OAAO,IAAI,KAAK,QAAQ;QACxB,UAAU,IAAI,IAAI;QAClB,UAAU,IAAI,IAAI,CACnB,CAAA;AACH,CAAC;AAEY,QAAA,yBAAyB,GAAG,4BAA4B,CAAA"}
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/utils/connection.ts"],"names":[],"mappings":";;;AAKA,wDAcC;AAED,4CAYC;AAED,oDAEC;AAED,8BAEC;AAED,8CASC;AA/CD,SAAgB,sBAAsB,CAAC,EACrC,OAAO,EACP,0BAA0B,EAC1B,2BAA2B,GAK5B;IACC,OAAO;QACL,GAAG,OAAO;QACV,GAAG,CAAC,2BAA2B,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,GAAG,CAAC,0BAA0B,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtE,CAAC;AACJ,CAAC;AAED,SAAgB,gBAAgB,CAC9B,mBAAwC,EACxC,WAAqB;IAErB,OAAO;QACL,GAAG,CAAC,WAAW;YACb,CAAC,CAAC;gBACE,uBAAuB,EAAE,CAAC;aAC3B;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,mBAAmB;KACvB,CAAC;AACJ,CAAC;AAED,SAAgB,oBAAoB,CAAC,UAAmB;IACtD,OAAO,OAAO,CAAC,UAAU,IAAI,GAAG,IAAI,UAAU,IAAI,UAAU,GAAG,GAAG,CAAC,CAAC;AACtE,CAAC;AAED,SAAgB,SAAS,CAAC,IAAa;IACrC,OAAO,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,cAAc,IAAI,IAAI,CAAC;AAC7E,CAAC;AAED,SAAgB,iBAAiB,CAC/B,IAAa;IAEb,OAAO,CACL,IAAI,KAAK,IAAI;QACb,OAAO,IAAI,KAAK,QAAQ;QACxB,UAAU,IAAI,IAAI;QAClB,UAAU,IAAI,IAAI,CACnB,CAAC;AACJ,CAAC;AAEY,QAAA,yBAAyB,GAAG,4BAA4B,CAAC"}

package/dist/utils/index.d.ts

@@ -1,4 +1,5 @@
-export * from './connection';
-export * from './sleep';
-export * from './stream';
-export * from './url';
+export * from "./connection";
+export * from "./multipart";
+export * from "./sleep";
+export * from "./stream";
+export * from "./url";

package/dist/utils/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./connection"), exports);
+__exportStar(require("./multipart"), exports);
 __exportStar(require("./sleep"), exports);
 __exportStar(require("./stream"), exports);
 __exportStar(require("./url"), exports);

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA4B;AAC5B,0CAAuB;AACvB,2CAAwB;AACxB,wCAAqB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,8CAA4B;AAC5B,0CAAwB;AACxB,2CAAyB;AACzB,wCAAsB"}

package/dist/utils/multipart.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Query parameters are URL-encoded into the request URL as `param_*` entries.
+ * Once their encoded length passes this budget, {@link serializeQueryParamsForUrl}
+ * returns null so that they are routed through the multipart body instead, keeping
+ * oversized payloads out of the URL where HTTP intermediaries (nginx, AWS ALB,
+ * CloudFront) reject them with HTTP 414 or 400. The threshold leaves ample
+ * headroom under common request line limits.
+ */
+export declare const MAX_URL_BIND_PARAM_LENGTH = 4096;
+/**
+ * Early-return variant of the `param_*` serialization performed by
+ * {@link toSearchParams}: serializes {@link query_params} into `param_*`
+ * URL entries, returning them so the caller can reuse the result without
+ * serializing the params a second time, or returns null as soon as the
+ * URL-encoded length exceeds {@link MAX_URL_BIND_PARAM_LENGTH} — in which
+ * case the params should be sent as a multipart/form-data body instead.
+ */
+export declare function serializeQueryParamsForUrl(query_params: Record<string, unknown>): [string, string][] | null;
+/**
+ * Builds a multipart/form-data body from a record of named string parts.
+ *
+ * Example output:
+ *
+ *   --BOUNDARY\r\n
+ *   Content-Disposition: form-data; name="query"\r\n
+ *   \r\n
+ *   SELECT * FROM t WHERE x IN {values:Array(String)}\r\n
+ *   --BOUNDARY\r\n
+ *   Content-Disposition: form-data; name="param_values"\r\n
+ *   \r\n
+ *   ['a@b.com','c@d.com']\r\n
+ *   --BOUNDARY--\r\n
+ */
+export declare function buildMultipartBody(parts: Record<string, string>, boundary: string): string;

package/dist/utils/multipart.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_URL_BIND_PARAM_LENGTH = void 0;
+exports.serializeQueryParamsForUrl = serializeQueryParamsForUrl;
+exports.buildMultipartBody = buildMultipartBody;
+const data_formatter_1 = require("../data_formatter");
+const SAFE_PART_NAME = /^[A-Za-z0-9_.-]+$/;
+/**
+ * Query parameters are URL-encoded into the request URL as `param_*` entries.
+ * Once their encoded length passes this budget, {@link serializeQueryParamsForUrl}
+ * returns null so that they are routed through the multipart body instead, keeping
+ * oversized payloads out of the URL where HTTP intermediaries (nginx, AWS ALB,
+ * CloudFront) reject them with HTTP 414 or 400. The threshold leaves ample
+ * headroom under common request line limits.
+ */
+exports.MAX_URL_BIND_PARAM_LENGTH = 4096;
+/**
+ * Early-return variant of the `param_*` serialization performed by
+ * {@link toSearchParams}: serializes {@link query_params} into `param_*`
+ * URL entries, returning them so the caller can reuse the result without
+ * serializing the params a second time, or returns null as soon as the
+ * URL-encoded length exceeds {@link MAX_URL_BIND_PARAM_LENGTH} — in which
+ * case the params should be sent as a multipart/form-data body instead.
+ */
+function serializeQueryParamsForUrl(query_params) {
+    const entries = [];
+    // Raw length is a lower bound on the encoded length, so large payloads
+    // short-circuit without materializing the encoded string.
+    let rawLength = 0;
+    for (const [key, value] of Object.entries(query_params)) {
+        const name = `param_${key}`;
+        const formatted = (0, data_formatter_1.formatQueryParams)({ value });
+        rawLength += name.length + formatted.length;
+        if (rawLength > exports.MAX_URL_BIND_PARAM_LENGTH) {
+            return null;
+        }
+        entries.push([name, formatted]);
+    }
+    // Measure the exact encoded length, accounting for percent-encoding expansion.
+    if (new URLSearchParams(entries).toString().length > exports.MAX_URL_BIND_PARAM_LENGTH) {
+        return null;
+    }
+    return entries;
+}
+/**
+ * Builds a multipart/form-data body from a record of named string parts.
+ *
+ * Example output:
+ *
+ *   --BOUNDARY\r\n
+ *   Content-Disposition: form-data; name="query"\r\n
+ *   \r\n
+ *   SELECT * FROM t WHERE x IN {values:Array(String)}\r\n
+ *   --BOUNDARY\r\n
+ *   Content-Disposition: form-data; name="param_values"\r\n
+ *   \r\n
+ *   ['a@b.com','c@d.com']\r\n
+ *   --BOUNDARY--\r\n
+ */
+function buildMultipartBody(parts, boundary) {
+    const chunks = [];
+    // Part names are validated against SAFE_PART_NAME to prevent header injection
+    // (a name could otherwise smuggle CRLF or quotes into the Content-Disposition
+    // line). Part values are intentionally NOT validated/escaped: the only way a
+    // value could forge a part delimiter is by containing the boundary, and the
+    // boundary is a random UUID generated per request by the caller, so it cannot
+    // be predicted or collided with by user-supplied input.
+    for (const [name, value] of Object.entries(parts)) {
+        if (!SAFE_PART_NAME.test(name)) {
+            throw new Error(`Invalid multipart part name: "${name}". ` +
+                `Part names must match ${SAFE_PART_NAME}.`);
+        }
+        chunks.push(`--${boundary}\r\n` +
+            `Content-Disposition: form-data; name="${name}"\r\n` +
+            `\r\n` +
+            `${value}\r\n`);
+    }
+    chunks.push(`--${boundary}--\r\n`);
+    return chunks.join("");
+}
+//# sourceMappingURL=multipart.js.map

package/dist/utils/multipart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipart.js","sourceRoot":"","sources":["../../src/utils/multipart.ts"],"names":[],"mappings":";;;AAsBA,gEAuBC;AAiBD,gDA8BC;AA5FD,sDAAsD;AAEtD,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAE3C;;;;;;;GAOG;AACU,QAAA,yBAAyB,GAAG,IAAI,CAAC;AAE9C;;;;;;;GAOG;AACH,SAAgB,0BAA0B,CACxC,YAAqC;IAErC,MAAM,OAAO,GAAuB,EAAE,CAAC;IACvC,uEAAuE;IACvE,0DAA0D;IAC1D,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,GAAG,SAAS,GAAG,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,IAAA,kCAAiB,EAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/C,SAAS,IAAI,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;QAC5C,IAAI,SAAS,GAAG,iCAAyB,EAAE,CAAC;YAC1C,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,+EAA+E;IAC/E,IACE,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,GAAG,iCAAyB,EAC1E,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,kBAAkB,CAChC,KAA6B,EAC7B,QAAgB;IAEhB,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,8EAA8E;IAC9E,8EAA8E;IAC9E,6EAA6E;IAC7E,4EAA4E;IAC5E,8EAA8E;IAC9E,wDAAwD;IACxD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CACb,iCAAiC,IAAI,KAAK;gBACxC,yBAAyB,cAAc,GAAG,CAC7C,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,IAAI,CACT,KAAK,QAAQ,MAAM;YACjB,yCAAyC,IAAI,OAAO;YACpD,MAAM;YACN,GAAG,KAAK,MAAM,CACjB,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAK,QAAQ,QAAQ,CAAC,CAAC;IAEnC,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC"}

package/dist/utils/sleep.js.map

@@ -1 +1 @@
-{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../src/utils/sleep.ts"],"names":[],"mappings":";;AAGA,sBAMC;AATD;;GAEG;AACI,KAAK,UAAU,KAAK,CAAC,EAAU;IACpC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAC5B,UAAU,CAAC,GAAG,EAAE;QACd,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;IACjB,CAAC,EAAE,EAAE,CAAC,CACP,CAAA;AACH,CAAC"}
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../src/utils/sleep.ts"],"names":[],"mappings":";;AAGA,sBAMC;AATD;;GAEG;AACI,KAAK,UAAU,KAAK,CAAC,EAAU;IACpC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAC5B,UAAU,CAAC,GAAG,EAAE;QACd,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAClB,CAAC,EAAE,EAAE,CAAC,CACP,CAAC;AACJ,CAAC"}

package/dist/utils/stream.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CARET_RETURN = void 0;
 exports.extractErrorAtTheEndOfChunk = extractErrorAtTheEndOfChunk;
 const error_1 = require("../error");
-const EXCEPTION_MARKER = '__exception__';
+const EXCEPTION_MARKER = "__exception__";
 const NEWLINE = 0x0a;
 exports.CARET_RETURN = 0x0d;
 /**
@@ -28,15 +28,15 @@ function extractErrorAtTheEndOfChunk(chunk, exceptionTag) {
             2; // \r\n
         let errMsgLenStartIdx = chunk.length - bytesCountAfterErrLenHint;
         if (errMsgLenStartIdx < 1) {
-            return new Error('there was an error in the stream, but the last chunk is malformed');
+            return new Error("there was an error in the stream, but the last chunk is malformed");
         }
         do {
             --errMsgLenStartIdx;
         } while (chunk[errMsgLenStartIdx] !== NEWLINE);
-        const textDecoder = new TextDecoder('utf-8');
+        const textDecoder = new TextDecoder("utf-8");
         const errMsgLen = parseInt(textDecoder.decode(chunk.subarray(errMsgLenStartIdx, -bytesCountAfterErrLenHint)));
         if (isNaN(errMsgLen) || errMsgLen <= 0) {
-            return new Error('there was an error in the stream; failed to parse the message length');
+            return new Error("there was an error in the stream; failed to parse the message length");
         }
         const errMsg = textDecoder.decode(chunk.subarray(errMsgLenStartIdx - errMsgLen + 1, // skipping the newline character
         errMsgLenStartIdx));

package/dist/utils/stream.js.map

@@ -1 +1 @@
-{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/utils/stream.ts"],"names":[],"mappings":";;;AAoBA,kEAiDC;AArED,oCAAqC;AAErC,MAAM,gBAAgB,GAAG,eAAe,CAAA;AAExC,MAAM,OAAO,GAAG,IAAa,CAAA;AAChB,QAAA,YAAY,GAAG,IAAa,CAAA;AAEzC;;;;;;;;;;;;GAYG;AACH,SAAgB,2BAA2B,CACzC,KAAiB,EACjB,YAAoB;IAEpB,IAAI,CAAC;QACH,MAAM,yBAAyB,GAC7B,CAAC,GAAG,QAAQ;YACZ,gBAAgB,CAAC,MAAM,GAAG,gBAAgB;YAC1C,CAAC,GAAG,OAAO;YACX,YAAY,CAAC,MAAM,GAAG,gCAAgC;YACtD,CAAC,CAAA,CAAC,OAAO;QAEX,IAAI,iBAAiB,GAAG,KAAK,CAAC,MAAM,GAAG,yBAAyB,CAAA;QAChE,IAAI,iBAAiB,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,KAAK,CACd,mEAAmE,CACpE,CAAA;QACH,CAAC;QAED,GAAG,CAAC;YACF,EAAE,iBAAiB,CAAA;QACrB,CAAC,QAAQ,KAAK,CAAC,iBAAiB,CAAC,KAAK,OAAO,EAAC;QAE9C,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAA;QAE5C,MAAM,SAAS,GAAG,QAAQ,CACxB,WAAW,CAAC,MAAM,CAChB,KAAK,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,yBAAyB,CAAC,CAC9D,CACF,CAAA;QAED,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACvC,OAAO,IAAI,KAAK,CACd,sEAAsE,CACvE,CAAA;QACH,CAAC;QAED,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAC/B,KAAK,CAAC,QAAQ,CACZ,iBAAiB,GAAG,SAAS,GAAG,CAAC,EAAE,iCAAiC;QACpE,iBAAiB,CAClB,CACF,CAAA;QAED,OAAO,IAAA,kBAAU,EAAC,MAAM,CAAC,CAAA;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,8DAA8D;QAC9D,OAAO,GAAY,CAAA;IACrB,CAAC;AACH,CAAC"}
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/utils/stream.ts"],"names":[],"mappings":";;;AAoBA,kEAiDC;AArED,oCAAsC;AAEtC,MAAM,gBAAgB,GAAG,eAAe,CAAC;AAEzC,MAAM,OAAO,GAAG,IAAa,CAAC;AACjB,QAAA,YAAY,GAAG,IAAa,CAAC;AAE1C;;;;;;;;;;;;GAYG;AACH,SAAgB,2BAA2B,CACzC,KAAiB,EACjB,YAAoB;IAEpB,IAAI,CAAC;QACH,MAAM,yBAAyB,GAC7B,CAAC,GAAG,QAAQ;YACZ,gBAAgB,CAAC,MAAM,GAAG,gBAAgB;YAC1C,CAAC,GAAG,OAAO;YACX,YAAY,CAAC,MAAM,GAAG,gCAAgC;YACtD,CAAC,CAAC,CAAC,OAAO;QAEZ,IAAI,iBAAiB,GAAG,KAAK,CAAC,MAAM,GAAG,yBAAyB,CAAC;QACjE,IAAI,iBAAiB,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,KAAK,CACd,mEAAmE,CACpE,CAAC;QACJ,CAAC;QAED,GAAG,CAAC;YACF,EAAE,iBAAiB,CAAC;QACtB,CAAC,QAAQ,KAAK,CAAC,iBAAiB,CAAC,KAAK,OAAO,EAAE;QAE/C,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;QAE7C,MAAM,SAAS,GAAG,QAAQ,CACxB,WAAW,CAAC,MAAM,CAChB,KAAK,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,yBAAyB,CAAC,CAC9D,CACF,CAAC;QAEF,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACvC,OAAO,IAAI,KAAK,CACd,sEAAsE,CACvE,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAC/B,KAAK,CAAC,QAAQ,CACZ,iBAAiB,GAAG,SAAS,GAAG,CAAC,EAAE,iCAAiC;QACpE,iBAAiB,CAClB,CACF,CAAC;QAEF,OAAO,IAAA,kBAAU,EAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,8DAA8D;QAC9D,OAAO,GAAY,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/utils/url.d.ts

@@ -1,4 +1,4 @@
-import type { ClickHouseSettings } from '../settings';
+import type { ClickHouseSettings } from "../settings";
 export declare function transformUrl({ url, pathname, searchParams, }: {
     url: URL;
     pathname?: string;
@@ -8,10 +8,13 @@ interface ToSearchParamsOptions {
     database: string | undefined;
     clickhouse_settings?: ClickHouseSettings;
     query_params?: Record<string, unknown>;
+    /** Pre-serialized `param_*` entries (e.g. from {@link serializeQueryParamsForUrl});
+     *  used as-is instead of serializing {@link query_params} again. */
+    param_entries?: [string, string][];
     query?: string;
     session_id?: string;
     query_id: string;
     role?: string | Array<string>;
 }
-export declare function toSearchParams({ database, query, query_params, clickhouse_settings, session_id, query_id, role, }: ToSearchParamsOptions): URLSearchParams;
+export declare function toSearchParams({ database, query, query_params, param_entries, clickhouse_settings, session_id, query_id, role, }: ToSearchParamsOptions): URLSearchParams;
 export {};