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

package/dist/common/config.js

@@ -0,0 +1,364 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareConfigWithURL = prepareConfigWithURL;
+exports.getConnectionParams = getConnectionParams;
+exports.mergeConfigs = mergeConfigs;
+exports.createUrl = createUrl;
+exports.loadConfigOptionsFromURL = loadConfigOptionsFromURL;
+exports.booleanConfigURLValue = booleanConfigURLValue;
+exports.numberConfigURLValue = numberConfigURLValue;
+exports.enumConfigURLValue = enumConfigURLValue;
+const logger_1 = require("./logger");
+const json_handling_1 = require("./parse/json_handling");
+/** Normalizes the public request compression option into the internal codec
+ *  object, or `undefined` when disabled. `true` keeps gzip for backwards
+ *  compatibility; the object form (carrying its per-codec option) is passed
+ *  through verbatim, so untyped JS supplying an unknown codec still reaches the
+ *  Node guard, which rejects it with a clear error. */
+function normalizeRequestCompression(value) {
+    if (!value) {
+        return undefined;
+    }
+    if (value === true) {
+        return { codec: "gzip" };
+    }
+    return value;
+}
+/** Normalizes the public response compression option
+ *  (`false | true | { codec }`) into the internal codec object, or `undefined`
+ *  when disabled. `true` keeps gzip for backwards compatibility. */
+function normalizeResponseCompression(value) {
+    if (!value) {
+        return undefined;
+    }
+    if (value === true) {
+        return { codec: "gzip" };
+    }
+    return { codec: value.codec };
+}
+/**
+ * Validates and normalizes the provided "base" config.
+ * Warns about deprecated configuration parameters usage.
+ * Parses the common URL parameters into the configuration parameters (these are the same for all implementations).
+ * Parses implementation-specific URL parameters using the handler provided by that implementation.
+ * Merges these parameters with the base config and implementation-specific defaults.
+ * Enforces certain defaults in case of deprecated keys or readonly mode.
+ */
+function prepareConfigWithURL(baseConfigOptions, logger, handleImplURLParams) {
+    const baseConfig = { ...baseConfigOptions };
+    if (baseConfig.additional_headers !== undefined) {
+        logger.warn({
+            module: "Config",
+            message: '"additional_headers" is deprecated. Use "http_headers" instead.',
+        });
+        baseConfig.http_headers = baseConfig.additional_headers;
+        delete baseConfig.additional_headers;
+    }
+    let configURL;
+    if (baseConfig.host !== undefined) {
+        logger.warn({
+            module: "Config",
+            message: '"host" is deprecated. Use "url" instead.',
+        });
+        configURL = createUrl(baseConfig.host);
+        delete baseConfig.host;
+    }
+    else {
+        configURL = createUrl(baseConfig.url);
+    }
+    const [url, configFromURL] = loadConfigOptionsFromURL(configURL, handleImplURLParams);
+    const config = mergeConfigs(baseConfig, configFromURL, logger);
+    if (config.pathname !== undefined) {
+        url.pathname = config.pathname;
+    }
+    config.url = url;
+    return config;
+}
+function getConnectionParams(config, logger) {
+    let auth;
+    if (config.access_token !== undefined) {
+        if (config.username !== undefined || config.password !== undefined) {
+            throw new Error("Both access token and username/password are provided in the configuration. Please use only one authentication method.");
+        }
+        auth = { access_token: config.access_token, type: "JWT" };
+    }
+    else {
+        auth = {
+            username: config.username ?? "default",
+            password: config.password ?? "",
+            type: "Credentials",
+        };
+    }
+    const log_level = config.log?.level ?? logger_1.ClickHouseLogLevel.WARN;
+    const request_timeout = config.request_timeout ?? 30_000;
+    const clickhouse_settings = config.clickhouse_settings ?? {};
+    if (log_level <= logger_1.ClickHouseLogLevel.WARN) {
+        // Warn if request_timeout is high but progress headers are not configured
+        // This can lead to socket hang-up errors when long-running queries exceed load balancer idle timeouts
+        const THRESHOLD_MS = 60_000; // 60 seconds
+        if (request_timeout > THRESHOLD_MS) {
+            const send_progress = String(clickhouse_settings.send_progress_in_http_headers) === "1";
+            const progress_interval = clickhouse_settings.http_headers_progress_interval_ms;
+            if (!send_progress) {
+                logger.warn({
+                    module: "Config",
+                    message: `request_timeout is set to ${request_timeout}ms, but send_progress_in_http_headers is not enabled. Long-running queries may fail with socket hang-up errors if they exceed the load balancer idle timeout. Consider enabling progress headers with clickhouse_settings: { send_progress_in_http_headers: 1, http_headers_progress_interval_ms: '<interval>' }. See https://github.com/ClickHouse/clickhouse-js/blob/main/docs/howto/long_running_queries.md for more details.`,
+                });
+            }
+            else if (progress_interval === undefined) {
+                logger.warn({
+                    module: "Config",
+                    message: `request_timeout is set to ${request_timeout}ms and send_progress_in_http_headers is enabled, but http_headers_progress_interval_ms is not set. It is recommended to set http_headers_progress_interval_ms to a value slightly below your load balancer's idle timeout (e.g., '110000' for a 120s LB timeout). See https://github.com/ClickHouse/clickhouse-js/blob/main/docs/howto/long_running_queries.md for more details.`,
+                });
+            }
+        }
+    }
+    return {
+        auth,
+        url: config.url,
+        application_id: config.application,
+        request_timeout,
+        max_open_connections: config.max_open_connections ?? 10,
+        compression: {
+            decompress_response: normalizeResponseCompression(config.compression?.response),
+            compress_request: normalizeRequestCompression(config.compression?.request),
+        },
+        database: config.database ?? "default",
+        log_writer: new logger_1.LogWriter(logger, "Connection", log_level),
+        log_level: log_level,
+        keep_alive: { enabled: config.keep_alive?.enabled ?? true },
+        clickhouse_settings,
+        http_headers: config.http_headers ?? {},
+        json: {
+            ...json_handling_1.defaultJSONHandling,
+            ...config.json,
+        },
+        ...(config.use_multipart_params ? { use_multipart_params: true } : {}),
+        ...(config.use_multipart_params_auto
+            ? { use_multipart_params_auto: true }
+            : {}),
+    };
+}
+/**
+ * Merge two versions of the config: base (hardcoded) from the instance creation and the URL parsed one.
+ * URL config takes priority and overrides the base config parameters.
+ * If a value is overridden, then a warning will be logged (even if the log level is OFF).
+ */
+function mergeConfigs(baseConfig, configFromURL, logger) {
+    function deepMerge(base, fromURL, path = []) {
+        for (const key of Object.keys(fromURL)) {
+            if (typeof fromURL[key] === "object") {
+                deepMerge(base, fromURL[key], path.concat(key));
+            }
+            else {
+                let baseAtPath = base;
+                for (const key of path) {
+                    if (baseAtPath[key] === undefined) {
+                        baseAtPath[key] = {};
+                    }
+                    baseAtPath = baseAtPath[key];
+                }
+                const baseAtKey = baseAtPath[key];
+                if (baseAtKey !== undefined) {
+                    const fullPath = path.concat(key).join(".");
+                    logger.warn({
+                        module: "Config",
+                        message: `"${fullPath}" is overridden by a URL parameter.`,
+                    });
+                }
+                baseAtPath[key] = fromURL[key];
+            }
+        }
+    }
+    const config = { ...baseConfig };
+    deepMerge(config, configFromURL);
+    return config;
+}
+function createUrl(configURL) {
+    let url;
+    try {
+        if (typeof configURL === "string" || configURL instanceof URL) {
+            url = new URL(configURL);
+        }
+        else {
+            return new URL("http://localhost:8123");
+        }
+    }
+    catch (err) {
+        throw new Error("ClickHouse URL is malformed. Expected format: http[s]://[username:password@]hostname:port[/database][?param1=value1&param2=value2]", { cause: err });
+    }
+    if (url.protocol !== "http:" && url.protocol !== "https:") {
+        throw new Error(`ClickHouse URL protocol must be either http or https. Got: ${url.protocol}`);
+    }
+    return url;
+}
+/**
+ * @param url potentially contains auth, database and URL params to parse the configuration from
+ * @param handleExtraURLParams some platform-specific URL params might be unknown by the common package;
+ * use this function defined in the implementation to handle them. Logs warnings in case of hardcode overrides.
+ */
+function loadConfigOptionsFromURL(url, handleExtraURLParams) {
+    let config = {};
+    // trim is not needed, cause space is not allowed in the URL basic auth and should be encoded as %20
+    if (url.username !== "") {
+        config.username = decodeURIComponent(url.username);
+    }
+    if (url.password !== "") {
+        config.password = decodeURIComponent(url.password);
+    }
+    if (url.pathname.trim().length > 1) {
+        config.database = url.pathname.slice(1);
+    }
+    const urlSearchParamsKeys = [...url.searchParams.keys()];
+    if (urlSearchParamsKeys.length > 0) {
+        const unknownParams = new Set();
+        const settingPrefix = "clickhouse_setting_";
+        const settingShortPrefix = "ch_";
+        const httpHeaderPrefix = "http_header_";
+        urlSearchParamsKeys.forEach((key) => {
+            let paramWasProcessed = true;
+            const value = url.searchParams.get(key);
+            if (key.startsWith(settingPrefix)) {
+                // clickhouse_settings_*
+                const settingKey = key.slice(settingPrefix.length);
+                if (config.clickhouse_settings === undefined) {
+                    config.clickhouse_settings = {};
+                }
+                config.clickhouse_settings[settingKey] = value;
+            }
+            else if (key.startsWith(settingShortPrefix)) {
+                // ch_*
+                const settingKey = key.slice(settingShortPrefix.length);
+                if (config.clickhouse_settings === undefined) {
+                    config.clickhouse_settings = {};
+                }
+                config.clickhouse_settings[settingKey] = value;
+            }
+            else if (key.startsWith(httpHeaderPrefix)) {
+                // http_headers_*
+                const headerKey = key.slice(httpHeaderPrefix.length);
+                if (config.http_headers === undefined) {
+                    config.http_headers = {};
+                }
+                config.http_headers[headerKey] = value;
+            }
+            else {
+                // static known parameters
+                switch (key) {
+                    case "application":
+                        config.application = value;
+                        break;
+                    case "pathname":
+                        config.pathname = value;
+                        break;
+                    case "session_id":
+                        config.session_id = value;
+                        break;
+                    case "request_timeout":
+                        config.request_timeout = numberConfigURLValue({
+                            key,
+                            value,
+                            min: 0,
+                        });
+                        break;
+                    case "max_open_connections":
+                        config.max_open_connections = numberConfigURLValue({
+                            key,
+                            value,
+                            min: 1,
+                        });
+                        break;
+                    case "compression_request":
+                        if (config.compression === undefined) {
+                            config.compression = {};
+                        }
+                        config.compression.request = booleanConfigURLValue({ key, value });
+                        break;
+                    case "compression_response":
+                        if (config.compression === undefined) {
+                            config.compression = {};
+                        }
+                        config.compression.response = booleanConfigURLValue({
+                            key,
+                            value,
+                        });
+                        break;
+                    case "log_level":
+                        if (config.log === undefined) {
+                            config.log = {};
+                        }
+                        config.log.level = enumConfigURLValue({
+                            key,
+                            value,
+                            enumObject: logger_1.ClickHouseLogLevel,
+                        });
+                        break;
+                    case "keep_alive_enabled":
+                        if (config.keep_alive === undefined) {
+                            config.keep_alive = {};
+                        }
+                        config.keep_alive.enabled = booleanConfigURLValue({ key, value });
+                        break;
+                    case "access_token":
+                        config.access_token = value;
+                        break;
+                    default:
+                        paramWasProcessed = false;
+                        unknownParams.add(key);
+                        break;
+                }
+            }
+            if (paramWasProcessed) {
+                // so it won't be passed to the impl URL params handler
+                url.searchParams.delete(key);
+            }
+        });
+        if (handleExtraURLParams !== null) {
+            const res = handleExtraURLParams(config, url);
+            config = res.config;
+            if (unknownParams.size > 0) {
+                res.handled_params.forEach((k) => unknownParams.delete(k));
+            }
+            if (res.unknown_params.size > 0) {
+                res.unknown_params.forEach((k) => unknownParams.add(k));
+            }
+        }
+        if (unknownParams.size > 0) {
+            throw new Error(`Unknown URL parameters: ${Array.from(unknownParams).join(", ")}`);
+        }
+    }
+    // clean up the final ClickHouse URL to be used in the connection
+    const clickHouseURL = new URL(`${url.protocol}//${url.host}`);
+    return [clickHouseURL, config];
+}
+function booleanConfigURLValue({ key, value, }) {
+    const trimmed = value.trim();
+    if (trimmed === "true" || trimmed === "1")
+        return true;
+    if (trimmed === "false" || trimmed === "0")
+        return false;
+    throw new Error(`"${key}" has invalid boolean value: ${trimmed}. Expected one of: 0, 1, true, false.`);
+}
+function numberConfigURLValue({ key, value, min, max, }) {
+    const trimmed = value.trim();
+    const number = Number(trimmed);
+    if (isNaN(number))
+        throw new Error(`"${key}" has invalid numeric value: ${trimmed}`);
+    if (min !== undefined && number < min) {
+        throw new Error(`"${key}" value ${trimmed} is less than min allowed ${min}`);
+    }
+    if (max !== undefined && number > max) {
+        throw new Error(`"${key}" value ${trimmed} is greater than max allowed ${max}`);
+    }
+    return number;
+}
+function enumConfigURLValue({ key, value, enumObject, }) {
+    const values = Object.keys(enumObject).filter((item) => isNaN(Number(item)));
+    const trimmed = value.trim();
+    if (!values.includes(trimmed)) {
+        const expected = values.join(", ");
+        throw new Error(`"${key}" has invalid value: ${trimmed}. Expected one of: ${expected}.`);
+    }
+    return enumObject[trimmed];
+}
+//# sourceMappingURL=config.js.map

package/dist/common/config.js.map

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

package/dist/common/connection.d.ts

@@ -0,0 +1,124 @@
+import type { JSONHandling } from ".";
+import type { WithClickHouseSummary, WithHttpStatusCode, WithResponseHeaders } from "./clickhouse_types";
+import type { ClickHouseLogLevel, LogWriter } from "./logger";
+import type { ClickHouseSettings } from "./settings";
+export type ConnectionAuth = {
+    username: string;
+    password: string;
+    type: "Credentials";
+} | {
+    access_token: string;
+    type: "JWT";
+};
+export interface ConnectionParams {
+    url: URL;
+    request_timeout: number;
+    max_open_connections: number;
+    compression: CompressionSettings;
+    database: string;
+    clickhouse_settings: ClickHouseSettings;
+    log_writer: LogWriter;
+    log_level: ClickHouseLogLevel;
+    keep_alive: {
+        enabled: boolean;
+    };
+    application_id?: string;
+    http_headers?: Record<string, string>;
+    auth: ConnectionAuth;
+    json?: JSONHandling;
+    use_multipart_params?: boolean;
+    use_multipart_params_auto?: boolean;
+}
+/** Compression codecs supported for the HTTP request (insert) and response
+ *  (read) bodies. `zstd` requires Node.js >= 22.15.0 (zstd support in the
+ *  built-in `zlib` module); `br` (Brotli) is available on every supported
+ *  Node.js version. Request-body compression is performed only by
+ *  `@clickhouse/client` (Node.js); on the web client, response decompression is
+ *  handled by the browser and only `zstd` is rejected. */
+export type CompressionMethod = "gzip" | "zstd" | "br";
+/** Normalized request (insert) body compression, discriminated by codec so each
+ *  codec carries its own tuning option: a `level` for gzip/zstd, a `quality` for
+ *  Brotli. */
+export type RequestCompression = {
+    codec: "gzip";
+    level?: number;
+} | {
+    codec: "zstd";
+    level?: number;
+} | {
+    codec: "br";
+    quality?: number;
+};
+/** Normalized response (read) body compression. The compression options are
+ *  chosen by the ClickHouse server, so none are carried here. */
+export type ResponseCompression = {
+    codec: "gzip";
+} | {
+    codec: "zstd";
+} | {
+    codec: "br";
+};
+export interface CompressionSettings {
+    /** Response decompression codec, or `undefined` to disable. */
+    decompress_response: ResponseCompression | undefined;
+    /** Request compression codec (with an optional codec-specific level), or
+     *  `undefined` to disable. */
+    compress_request: RequestCompression | undefined;
+}
+export interface ConnBaseQueryParams {
+    query: string;
+    clickhouse_settings?: ClickHouseSettings;
+    query_params?: Record<string, unknown>;
+    abort_signal?: AbortSignal;
+    session_id?: string;
+    query_id?: string;
+    auth?: {
+        username: string;
+        password: string;
+    } | {
+        access_token: string;
+    };
+    role?: string | Array<string>;
+    http_headers?: Record<string, string>;
+    use_multipart_params?: boolean;
+    use_multipart_params_auto?: boolean;
+}
+export type ConnPingParams = {
+    select: boolean;
+} & Omit<ConnBaseQueryParams, "query" | "query_params">;
+export interface ConnCommandParams extends ConnBaseQueryParams {
+    ignore_error_response?: boolean;
+}
+export interface ConnInsertParams<Stream> extends ConnBaseQueryParams {
+    values: string | Stream;
+}
+export interface ConnExecParams<Stream> extends ConnBaseQueryParams {
+    values?: Stream;
+    decompress_response_stream?: boolean;
+    ignore_error_response?: boolean;
+}
+export interface ConnBaseResult extends WithResponseHeaders, WithHttpStatusCode {
+    query_id: string;
+}
+export interface ConnQueryResult<Stream> extends ConnBaseResult {
+    stream: Stream;
+    query_id: string;
+}
+export type ConnInsertResult = ConnBaseResult & WithClickHouseSummary;
+export type ConnExecResult<Stream> = ConnQueryResult<Stream> & WithClickHouseSummary;
+export type ConnCommandResult = ConnBaseResult & WithClickHouseSummary;
+export type ConnPingResult = {
+    success: true;
+} | {
+    success: false;
+    error: Error;
+};
+export type ConnOperation = "Ping" | "Query" | "Insert" | "Exec" | "Command";
+export interface Connection<Stream> {
+    ping(params: ConnPingParams): Promise<ConnPingResult>;
+    query(params: ConnBaseQueryParams): Promise<ConnQueryResult<Stream>>;
+    insert(params: ConnInsertParams<Stream>): Promise<ConnInsertResult>;
+    command(params: ConnCommandParams): Promise<ConnCommandResult>;
+    exec(params: ConnExecParams<Stream>): Promise<ConnExecResult<Stream>>;
+    close(): Promise<void>;
+}

package/dist/common/connection.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=connection.js.map

package/dist/common/connection.js.map

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

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

@@ -0,0 +1,11 @@
+export declare class TupleParam {
+    readonly values: readonly unknown[];
+    constructor(values: readonly unknown[]);
+}
+export declare function formatQueryParams({ value, wrapStringInQuotes, printNullAsKeyword, }: FormatQueryParamsOptions): string;
+interface FormatQueryParamsOptions {
+    value: unknown;
+    wrapStringInQuotes?: boolean;
+    printNullAsKeyword?: boolean;
+}
+export {};

package/dist/common/data_formatter/format_query_params.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TupleParam = void 0;
+exports.formatQueryParams = formatQueryParams;
+class TupleParam {
+    values;
+    constructor(values) {
+        this.values = values;
+    }
+}
+exports.TupleParam = TupleParam;
+function formatQueryParams({ value, wrapStringInQuotes, printNullAsKeyword, }) {
+    return formatQueryParamsInternal({
+        value,
+        wrapStringInQuotes,
+        printNullAsKeyword,
+        isInArrayOrTuple: false,
+    });
+}
+function formatQueryParamsInternal({ value, wrapStringInQuotes, printNullAsKeyword, isInArrayOrTuple, }) {
+    if (value === null || value === undefined) {
+        if (printNullAsKeyword)
+            return "NULL";
+        return "\\N";
+    }
+    if (Number.isNaN(value))
+        return "nan";
+    if (value === Number.POSITIVE_INFINITY)
+        return "+inf";
+    if (value === Number.NEGATIVE_INFINITY)
+        return "-inf";
+    if (typeof value === "number" || typeof value === "bigint")
+        return String(value);
+    if (typeof value === "boolean") {
+        if (isInArrayOrTuple) {
+            return value ? "TRUE" : "FALSE";
+        }
+        return value ? "1" : "0";
+    }
+    if (typeof value === "string") {
+        let result = "";
+        for (let i = 0; i < value.length; i++) {
+            switch (value.charCodeAt(i)) {
+                case TabASCII:
+                    result += "\\t";
+                    break;
+                case NewlineASCII:
+                    result += "\\n";
+                    break;
+                case CarriageReturnASCII:
+                    result += "\\r";
+                    break;
+                case SingleQuoteASCII:
+                    result += `\\'`;
+                    break;
+                case BackslashASCII:
+                    result += "\\\\";
+                    break;
+                default:
+                    result += value[i];
+            }
+        }
+        return wrapStringInQuotes ? `'${result}'` : result;
+    }
+    if (Array.isArray(value)) {
+        return `[${value
+            .map((v) => formatQueryParamsInternal({
+            value: v,
+            wrapStringInQuotes: true,
+            printNullAsKeyword: true,
+            isInArrayOrTuple: true,
+        }))
+            .join(",")}]`;
+    }
+    if (value instanceof Date) {
+        // The ClickHouse server parses numbers as time-zone-agnostic Unix timestamps
+        const unixTimestamp = Math.floor(value.getTime() / 1000)
+            .toString()
+            .padStart(10, "0");
+        const milliseconds = value.getUTCMilliseconds();
+        return milliseconds === 0
+            ? unixTimestamp
+            : `${unixTimestamp}.${milliseconds.toString().padStart(3, "0")}`;
+    }
+    // (42,'foo',NULL)
+    if (value instanceof TupleParam) {
+        return `(${value.values
+            .map((v) => formatQueryParamsInternal({
+            value: v,
+            wrapStringInQuotes: true,
+            printNullAsKeyword: true,
+            isInArrayOrTuple: true,
+        }))
+            .join(",")})`;
+    }
+    if (value instanceof Map) {
+        return formatObjectLikeParam(value.entries());
+    }
+    // This is only useful for simple maps where the keys are strings
+    if (typeof value === "object") {
+        return formatObjectLikeParam(Object.entries(value));
+    }
+    throw new Error(`Unsupported value in query parameters: [${value}].`);
+}
+// {'key1':'value1',42:'value2'}
+function formatObjectLikeParam(entries) {
+    const formatted = [];
+    for (const [key, val] of entries) {
+        formatted.push(`${formatQueryParamsInternal({
+            value: key,
+            wrapStringInQuotes: true,
+            printNullAsKeyword: true,
+            isInArrayOrTuple: true,
+        })}:${formatQueryParamsInternal({
+            value: val,
+            wrapStringInQuotes: true,
+            printNullAsKeyword: true,
+            isInArrayOrTuple: true,
+        })}`);
+    }
+    return `{${formatted.join(",")}}`;
+}
+const TabASCII = 9;
+const NewlineASCII = 10;
+const CarriageReturnASCII = 13;
+const SingleQuoteASCII = 39;
+const BackslashASCII = 92;
+//# sourceMappingURL=format_query_params.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format_query_params.js","sourceRoot":"","sources":["../../../src/common/data_formatter/format_query_params.ts"],"names":[],"mappings":";;;AAOA,8CAWC;AAlBD,MAAa,UAAU;IACZ,MAAM,CAAqB;IACpC,YAAY,MAA0B;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AALD,gCAKC;AAED,SAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,kBAAkB,EAClB,kBAAkB,GACO;IACzB,OAAO,yBAAyB,CAAC;QAC/B,KAAK;QACL,kBAAkB;QAClB,kBAAkB;QAClB,gBAAgB,EAAE,KAAK;KACxB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,yBAAyB,CAAC,EACjC,KAAK,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,GACyC;IACzD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,IAAI,kBAAkB;YAAE,OAAO,MAAM,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,KAAK,KAAK,MAAM,CAAC,iBAAiB;QAAE,OAAO,MAAM,CAAC;IACtD,IAAI,KAAK,KAAK,MAAM,CAAC,iBAAiB;QAAE,OAAO,MAAM,CAAC;IAEtD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ;QACxD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,gBAAgB,EAAE,CAAC;YACrB,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QAClC,CAAC;QACD,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3B,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,QAAQ,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5B,KAAK,QAAQ;oBACX,MAAM,IAAI,KAAK,CAAC;oBAChB,MAAM;gBACR,KAAK,YAAY;oBACf,MAAM,IAAI,KAAK,CAAC;oBAChB,MAAM;gBACR,KAAK,mBAAmB;oBACtB,MAAM,IAAI,KAAK,CAAC;oBAChB,MAAM;gBACR,KAAK,gBAAgB;oBACnB,MAAM,IAAI,KAAK,CAAC;oBAChB,MAAM;gBACR,KAAK,cAAc;oBACjB,MAAM,IAAI,MAAM,CAAC;oBACjB,MAAM;gBACR;oBACE,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QACD,OAAO,kBAAkB,CAAC,CAAC,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;IACrD,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,KAAK;aACb,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACT,yBAAyB,CAAC;YACxB,KAAK,EAAE,CAAC;YACR,kBAAkB,EAAE,IAAI;YACxB,kBAAkB,EAAE,IAAI;YACxB,gBAAgB,EAAE,IAAI;SACvB,CAAC,CACH;aACA,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAClB,CAAC;IAED,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1B,6EAA6E;QAC7E,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;aACrD,QAAQ,EAAE;aACV,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACrB,MAAM,YAAY,GAAG,KAAK,CAAC,kBAAkB,EAAE,CAAC;QAChD,OAAO,YAAY,KAAK,CAAC;YACvB,CAAC,CAAC,aAAa;YACf,CAAC,CAAC,GAAG,aAAa,IAAI,YAAY,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IACrE,CAAC;IAED,kBAAkB;IAClB,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,OAAO,IAAI,KAAK,CAAC,MAAM;aACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACT,yBAAyB,CAAC;YACxB,KAAK,EAAE,CAAC;YACR,kBAAkB,EAAE,IAAI;YACxB,kBAAkB,EAAE,IAAI;YACxB,gBAAgB,EAAE,IAAI;SACvB,CAAC,CACH;aACA,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAClB,CAAC;IAED,IAAI,KAAK,YAAY,GAAG,EAAE,CAAC;QACzB,OAAO,qBAAqB,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,iEAAiE;IACjE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,qBAAqB,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,2CAA2C,KAAK,IAAI,CAAC,CAAC;AACxE,CAAC;AAED,gCAAgC;AAChC,SAAS,qBAAqB,CAC5B,OAA+D;IAE/D,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;QACjC,SAAS,CAAC,IAAI,CACZ,GAAG,yBAAyB,CAAC;YAC3B,KAAK,EAAE,GAAG;YACV,kBAAkB,EAAE,IAAI;YACxB,kBAAkB,EAAE,IAAI;YACxB,gBAAgB,EAAE,IAAI;SACvB,CAAC,IAAI,yBAAyB,CAAC;YAC9B,KAAK,EAAE,GAAG;YACV,kBAAkB,EAAE,IAAI;YACxB,kBAAkB,EAAE,IAAI;YACxB,gBAAgB,EAAE,IAAI;SACvB,CAAC,EAAE,CACL,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AACpC,CAAC;AASD,MAAM,QAAQ,GAAG,CAAC,CAAC;AACnB,MAAM,YAAY,GAAG,EAAE,CAAC;AACxB,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAC/B,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,MAAM,cAAc,GAAG,EAAE,CAAC"}

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

@@ -0,0 +1,2 @@
+import { SettingsMap } from "../settings";
+export declare function formatQuerySettings(value: number | string | boolean | SettingsMap): string;