@openplait/adapter-clickhouse 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,101 @@
+# `@openplait/adapter-clickhouse`
+
+The first OpenPlait datasource adapter. It compiles portable semantic queries
+to parameterized ClickHouse SQL and normalizes ClickHouse responses into
+`@openplait/core` dataframes.
+
+The default mappings cover the standard OpenTelemetry ClickHouse tables:
+
+| Logical dataset | Physical table |
+| --- | --- |
+| `otel.spans` | `otel_traces` |
+| `otel.logs` | `otel_logs` |
+| `otel.metrics.gauge` | `otel_metrics_gauge` |
+| `otel.metrics.sum` | `otel_metrics_sum` |
+| `otel.metrics.histogram` | `otel_metrics_histogram` |
+
+Application-specific mappings are supplied through `config.datasets`. The
+package exports `OPENLIT_CLICKHOUSE_DATASETS` as an optional preset for OpenLIT;
+it is not part of the adapter's defaults.
+
+## Usage
+
+```ts
+import {
+  ClickHouseAdapter,
+} from "@openplait/adapter-clickhouse";
+
+const adapter = new ClickHouseAdapter({
+  url: "https://clickhouse.example.com:8443",
+  username: process.env.CLICKHOUSE_USER,
+  password: process.env.CLICKHOUSE_PASSWORD,
+  database: "observability",
+  httpHeaders: { "X-ClickHouse-Quota": "openlit" },
+  maxResultRows: 10_000,
+  maxRowsToRead: 10_000_000,
+  maxTimeRangeMs: 31 * 24 * 60 * 60 * 1_000,
+  queryTimeoutMs: 30_000,
+});
+
+const compiled = await adapter.compile(query, {
+  variables: {
+    __from: "2026-08-05T00:00:00.000Z",
+    __to: "2026-08-05T01:00:00.000Z",
+  },
+});
+
+const result = await adapter.execute(compiled, {
+  audit: { requestId: "dashboard-request-123", actorId: "user-42" },
+});
+
+await adapter.close();
+```
+
+OpenLIT can opt into its additional logical datasets without changing the
+generic adapter contract:
+
+```ts
+import {
+  ClickHouseAdapter,
+  OPENLIT_CLICKHOUSE_DATASETS,
+} from "@openplait/adapter-clickhouse";
+
+const adapter = new ClickHouseAdapter({
+  url: clickhouseUrl,
+  datasets: [...OPENLIT_CLICKHOUSE_DATASETS],
+});
+```
+
+Do not put credentials in dashboard resources. Resolve them on the server and
+construct each named adapter instance behind the consuming application's
+server-side datasource registry.
+
+## Safety defaults
+
+- Canonical fields resolve only through the selected dataset's allowlist.
+- Tables are selected only through registered logical datasets.
+- Values use ClickHouse query parameters and are never interpolated into SQL.
+- A time range is required by default and capped at 31 days.
+- Results, rows read, and execution time are capped at both SQL and server
+  setting boundaries.
+- Queries execute with ClickHouse `readonly=1`.
+- Tenant predicates are adapter-owned and cannot be removed by a query.
+- Compiled queries must originate from the executing adapter instance.
+- Execution requires a safe audit request ID.
+- Native SQL is disabled unless `allowNativeQueries: true` is set by the server
+  administrator. When enabled, it remains single-statement and read-only, and
+  every declared parameter must be referenced through ClickHouse bindings.
+
+Native mode intentionally bypasses semantic field and table allowlists. Treat
+it as a privileged server-side feature, never as an end-user SQL console.
+
+## Supported semantic operations
+
+Select, recursive filters, aggregation, grouping, time buckets, ordering,
+limits, percentiles, distinct count, rate, histogram, and arithmetic are
+supported. Semantic joins are reported as unsupported because the current core
+join expression cannot identify the left and right operands unambiguously.
+
+`discoverSchema()` returns the canonical fields and types for all registered
+datasets. `explain()` returns the generated SQL, bound parameters, output field
+contract, and compilation steps without contacting ClickHouse.

package/dist/src/adapter.d.ts

@@ -0,0 +1,23 @@
+import type { NativeQuery, QueryResult, SemanticQuery, SemanticSchema } from "@openplait/core";
+import { type AdapterManifest, type AdapterValidationResult, type CompileContext, type CompiledQuery, type DatasourceAdapter, type DatasourceCapabilities, type DiscoveryContext, type ExecutionContext, type QueryExplanation } from "@openplait/adapter-sdk";
+import type { ClickHouseAdapterConfig, ClickHouseAdapterOptions, ClickHouseCompiledStatement } from "./types.js";
+export declare const CLICKHOUSE_ADAPTER_MANIFEST: AdapterManifest;
+export declare const CLICKHOUSE_CAPABILITIES: DatasourceCapabilities;
+export declare function validateClickHouseConfig(config: ClickHouseAdapterConfig): AdapterValidationResult<ClickHouseAdapterConfig>;
+export declare class ClickHouseAdapter implements DatasourceAdapter<ClickHouseAdapterConfig, ClickHouseCompiledStatement> {
+    readonly manifest: AdapterManifest;
+    private readonly config;
+    private readonly client;
+    private readonly ownsClient;
+    private readonly now;
+    private readonly compiledQueries;
+    constructor(config: ClickHouseAdapterConfig, options?: ClickHouseAdapterOptions);
+    validateConfig(config: ClickHouseAdapterConfig): AdapterValidationResult<ClickHouseAdapterConfig>;
+    getCapabilities(config: ClickHouseAdapterConfig): Promise<DatasourceCapabilities>;
+    compile(query: SemanticQuery, context: CompileContext): Promise<CompiledQuery<ClickHouseCompiledStatement>>;
+    execute(query: CompiledQuery<ClickHouseCompiledStatement> | NativeQuery, context: ExecutionContext): Promise<QueryResult>;
+    explain(query: SemanticQuery, context: CompileContext): Promise<QueryExplanation<ClickHouseCompiledStatement>>;
+    discoverSchema(_context: DiscoveryContext): Promise<SemanticSchema>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/src/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/adapter.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,aAAa,EACb,cAAc,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAIL,KAAK,eAAe,EAEpB,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAShC,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAG5B,MAAM,YAAY,CAAC;AAWpB,eAAO,MAAM,2BAA2B,EAAE,eAMzC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,sBAoBrC,CAAC;AAwDF,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,uBAAuB,GAC9B,uBAAuB,CAAC,uBAAuB,CAAC,CAiClD;AAiDD,qBAAa,iBACX,YAAW,iBAAiB,CAAC,uBAAuB,EAAE,2BAA2B,CAAC;IAElF,QAAQ,CAAC,QAAQ,kBAA+B;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;gBAE7C,MAAM,EAAE,uBAAuB,EAAE,OAAO,GAAE,wBAA6B;IAgCnF,cAAc,CACZ,MAAM,EAAE,uBAAuB,GAC9B,uBAAuB,CAAC,uBAAuB,CAAC;IAI7C,eAAe,CACnB,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,sBAAsB,CAAC;IAa5B,OAAO,CACX,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,2BAA2B,CAAC,CAAC;IAMhD,OAAO,CACX,KAAK,EAAE,aAAa,CAAC,2BAA2B,CAAC,GAAG,WAAW,EAC/D,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,WAAW,CAAC;IAkFjB,OAAO,CACX,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,gBAAgB,CAAC,2BAA2B,CAAC,CAAC;IAoBnD,cAAc,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC;IAInE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/src/adapter.js

@@ -0,0 +1,319 @@
+import { createClient, } from "@clickhouse/client";
+import { AdapterError, isAbortError, isCompiledQuery, } from "@openplait/adapter-sdk";
+import { compileClickHouseQuery } from "./compiler.js";
+import { createDatasetRegistry, datasetsToSemanticSchema } from "./datasets.js";
+import { compileNativeQuery } from "./native.js";
+import { normalizeClickHouseResponse, } from "./normalization.js";
+const ADAPTER_VERSION = "0.1.0-alpha.0";
+const DEFAULT_QUERY_TIMEOUT_MS = 30_000;
+const DEFAULT_MAX_RESULT_ROWS = 10_000;
+const DEFAULT_MAX_ROWS_TO_READ = 10_000_000;
+const SAFE_QUERY_ID = /^[A-Za-z0-9_.:-]{1,128}$/;
+const SAFE_DATASET_NAME = /^[a-z][a-z0-9]*(?:\.[a-z0-9_]+)+$/;
+const SAFE_TABLE_NAME = /^[A-Za-z_][A-Za-z0-9_]*(?:\.[A-Za-z_][A-Za-z0-9_]*)?$/;
+const UNSAFE_MAPPING_EXPRESSION = /;|--|\/\*|\*\/|\0/;
+export const CLICKHOUSE_ADAPTER_MANIFEST = {
+    name: "clickhouse",
+    displayName: "ClickHouse",
+    version: ADAPTER_VERSION,
+    queryLanguages: ["openplait-semantic", "sql"],
+    signals: ["traces", "logs", "metrics", "tabular"],
+};
+export const CLICKHOUSE_CAPABILITIES = {
+    signals: ["traces", "logs", "metrics", "tabular"],
+    operations: [
+        "select",
+        "filter",
+        "aggregate",
+        "group",
+        "order",
+        "limit",
+        "timeBucket",
+        "rate",
+        "percentile",
+        "distinctCount",
+        "histogram",
+        "arithmetic",
+    ],
+    joins: { local: false, crossDatasource: false },
+    nativeQueryLanguages: ["sql"],
+    explain: true,
+    schemaDiscovery: true,
+};
+function positiveIntegerIssue(value, path) {
+    if (value === undefined || (Number.isInteger(value) && value > 0))
+        return undefined;
+    return { code: "CONFIG_INVALID", path, message: "Value must be a positive integer." };
+}
+function validateDataset(dataset, index) {
+    const path = `/datasets/${index}`;
+    const issues = [];
+    if (!SAFE_DATASET_NAME.test(dataset.name)) {
+        issues.push({
+            code: "CONFIG_INVALID",
+            path: `${path}/name`,
+            message: "Dataset names must be dot-separated lowercase identifiers.",
+        });
+    }
+    if (!SAFE_TABLE_NAME.test(dataset.table)) {
+        issues.push({
+            code: "CONFIG_INVALID",
+            path: `${path}/table`,
+            message: "Dataset table must be an allowlisted ClickHouse identifier.",
+        });
+    }
+    if (!(dataset.timeField in dataset.fields)) {
+        issues.push({
+            code: "CONFIG_INVALID",
+            path: `${path}/timeField`,
+            message: "Dataset timeField must reference one of its fields.",
+        });
+    }
+    if (dataset.arrayJoin && !/^[A-Za-z_][A-Za-z0-9_]*$/.test(dataset.arrayJoin)) {
+        issues.push({
+            code: "CONFIG_INVALID",
+            path: `${path}/arrayJoin`,
+            message: "Dataset arrayJoin must be a single ClickHouse identifier.",
+        });
+    }
+    for (const [field, mapping] of Object.entries(dataset.fields)) {
+        if (!field || !mapping.expression || UNSAFE_MAPPING_EXPRESSION.test(mapping.expression)) {
+            issues.push({
+                code: "CONFIG_INVALID",
+                path: `${path}/fields/${field}/expression`,
+                message: "Field mapping expressions cannot be empty or contain statement/comment delimiters.",
+            });
+        }
+    }
+    return issues;
+}
+export function validateClickHouseConfig(config) {
+    const errors = [];
+    try {
+        const url = new URL(config.url);
+        if (url.protocol !== "http:" && url.protocol !== "https:") {
+            errors.push({
+                code: "CONFIG_INVALID",
+                path: "/url",
+                message: "ClickHouse URL must use http or https.",
+            });
+        }
+    }
+    catch {
+        errors.push({
+            code: "CONFIG_INVALID",
+            path: "/url",
+            message: "ClickHouse URL is invalid.",
+        });
+    }
+    for (const issue of [
+        positiveIntegerIssue(config.requestTimeoutMs, "/requestTimeoutMs"),
+        positiveIntegerIssue(config.queryTimeoutMs, "/queryTimeoutMs"),
+        positiveIntegerIssue(config.maxResultRows, "/maxResultRows"),
+        positiveIntegerIssue(config.maxRowsToRead, "/maxRowsToRead"),
+        positiveIntegerIssue(config.maxTimeRangeMs, "/maxTimeRangeMs"),
+    ]) {
+        if (issue)
+            errors.push(issue);
+    }
+    for (const [index, dataset] of (config.datasets ?? []).entries()) {
+        errors.push(...validateDataset(dataset, index));
+    }
+    return errors.length ? { valid: false, errors } : { valid: true, value: config, errors: [] };
+}
+function abortScope(external, timeoutMs) {
+    const controller = new AbortController();
+    let didTimeOut = false;
+    const onAbort = () => controller.abort(external?.reason);
+    if (external?.aborted)
+        onAbort();
+    else
+        external?.addEventListener("abort", onAbort, { once: true });
+    const timeout = setTimeout(() => {
+        didTimeOut = true;
+        controller.abort(new DOMException("Query timed out.", "TimeoutError"));
+    }, timeoutMs);
+    return {
+        signal: controller.signal,
+        timedOut: () => didTimeOut,
+        dispose: () => {
+            clearTimeout(timeout);
+            external?.removeEventListener("abort", onAbort);
+        },
+    };
+}
+function queryId(context) {
+    const id = context.queryId ?? context.audit?.requestId;
+    if (!id || !SAFE_QUERY_ID.test(id)) {
+        throw new AdapterError("QUERY_VALIDATION_FAILED", "Execution requires a safe audit request ID or query ID.", { path: "/execution/audit/requestId" });
+    }
+    return id;
+}
+function deepFreeze(value) {
+    if (typeof value !== "object" || value === null || Object.isFrozen(value)) {
+        return value;
+    }
+    for (const child of Object.values(value))
+        deepFreeze(child);
+    return Object.freeze(value);
+}
+export class ClickHouseAdapter {
+    manifest = CLICKHOUSE_ADAPTER_MANIFEST;
+    config;
+    client;
+    ownsClient;
+    now;
+    compiledQueries = new WeakSet();
+    constructor(config, options = {}) {
+        const validation = validateClickHouseConfig(config);
+        if (!validation.valid) {
+            throw new AdapterError("CONFIG_INVALID", "ClickHouse adapter config is invalid.", {
+                details: { errors: validation.errors },
+            });
+        }
+        this.config = structuredClone(config);
+        this.client =
+            options.client ??
+                createClient({
+                    url: this.config.url,
+                    ...(this.config.username === undefined
+                        ? {}
+                        : { username: this.config.username }),
+                    ...(this.config.password === undefined
+                        ? {}
+                        : { password: this.config.password }),
+                    ...(this.config.database === undefined
+                        ? {}
+                        : { database: this.config.database }),
+                    ...(this.config.httpHeaders === undefined
+                        ? {}
+                        : { http_headers: this.config.httpHeaders }),
+                    application: this.config.applicationName ?? "openplait",
+                    request_timeout: this.config.requestTimeoutMs ?? DEFAULT_QUERY_TIMEOUT_MS,
+                    use_multipart_params_auto: true,
+                });
+        this.ownsClient = options.client === undefined;
+        this.now = options.now ?? Date.now;
+    }
+    validateConfig(config) {
+        return validateClickHouseConfig(config);
+    }
+    async getCapabilities(config) {
+        const validation = validateClickHouseConfig(config);
+        if (!validation.valid) {
+            throw new AdapterError("CONFIG_INVALID", "ClickHouse adapter config is invalid.", {
+                details: { errors: validation.errors },
+            });
+        }
+        return {
+            ...CLICKHOUSE_CAPABILITIES,
+            nativeQueryLanguages: config.allowNativeQueries ? ["sql"] : [],
+        };
+    }
+    async compile(query, context) {
+        const compiled = deepFreeze(compileClickHouseQuery(query, this.config, context));
+        this.compiledQueries.add(compiled);
+        return compiled;
+    }
+    async execute(query, context) {
+        let statement;
+        let parameters;
+        let fields;
+        let frameName;
+        if (isCompiledQuery(query)) {
+            if (!this.compiledQueries.has(query)) {
+                throw new AdapterError("QUERY_VALIDATION_FAILED", "Compiled query was not produced by this adapter instance.");
+            }
+            statement = query.compiled.statement;
+            parameters = query.parameters;
+            fields = query.fields;
+            frameName = query.source.resourceName;
+        }
+        else {
+            if (!this.config.allowNativeQueries) {
+                throw new AdapterError("NATIVE_QUERY_REJECTED", "Native SQL is disabled for this ClickHouse datasource.", { path: "/spec/native" });
+            }
+            const native = compileNativeQuery(query, context.variables);
+            statement = native.statement;
+            parameters = native.parameters;
+            frameName = query.metadata.name;
+        }
+        const timeoutMs = Math.min(context.timeoutMs ?? this.config.queryTimeoutMs ?? DEFAULT_QUERY_TIMEOUT_MS, this.config.queryTimeoutMs ?? DEFAULT_QUERY_TIMEOUT_MS);
+        const scope = abortScope(context.abortSignal, timeoutMs);
+        const started = this.now();
+        const settings = {
+            readonly: "1",
+            max_execution_time: Math.max(1, Math.ceil(timeoutMs / 1_000)),
+            max_result_rows: String(this.config.maxResultRows ?? DEFAULT_MAX_RESULT_ROWS),
+            result_overflow_mode: "throw",
+            max_rows_to_read: String(this.config.maxRowsToRead ?? DEFAULT_MAX_ROWS_TO_READ),
+            read_overflow_mode: "throw",
+        };
+        try {
+            const resultSet = await this.client.query({
+                query: statement,
+                format: "JSON",
+                query_params: parameters,
+                clickhouse_settings: settings,
+                abort_signal: scope.signal,
+                query_id: queryId(context),
+            });
+            const response = (await resultSet.json());
+            return normalizeClickHouseResponse(response, fields, {
+                frameName,
+                adapterVersion: ADAPTER_VERSION,
+                executionTimeMs: Math.max(0, this.now() - started),
+            });
+        }
+        catch (error) {
+            if (scope.timedOut()) {
+                throw new AdapterError("TIMEOUT", `ClickHouse query exceeded ${timeoutMs}ms.`, {
+                    cause: error,
+                    details: { timeoutMs },
+                });
+            }
+            if (context.abortSignal?.aborted || isAbortError(error)) {
+                throw new AdapterError("ABORTED", "ClickHouse query was cancelled.", {
+                    cause: error,
+                });
+            }
+            throw new AdapterError("EXECUTION_FAILED", "ClickHouse query execution failed.", {
+                cause: error,
+            });
+        }
+        finally {
+            scope.dispose();
+        }
+    }
+    async explain(query, context) {
+        const compiledQuery = await this.compile(query, context);
+        const steps = [
+            `Resolve logical dataset '${query.spec.input.entity}'.`,
+            `Map ${query.spec.select.length} selected expression(s) to allowlisted ClickHouse expressions.`,
+            "Bind all values as ClickHouse query parameters.",
+        ];
+        if (query.spec.timeRange)
+            steps.push("Apply and validate the bounded time range.");
+        if (this.config.tenant)
+            steps.push("Apply the adapter-owned tenant predicate.");
+        if (query.spec.where)
+            steps.push("Compile the portable boolean filter tree.");
+        if (query.spec.groupBy?.length)
+            steps.push("Compile grouping and time buckets.");
+        steps.push("Apply the configured maximum result limit.");
+        return {
+            summary: `Compile '${query.metadata.name}' to a read-only ClickHouse SQL query.`,
+            steps,
+            compiledQuery,
+            warnings: compiledQuery.warnings,
+        };
+    }
+    async discoverSchema(_context) {
+        return datasetsToSemanticSchema(createDatasetRegistry(this.config.datasets ?? []));
+    }
+    async close() {
+        if (this.ownsClient)
+            await this.client.close();
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/src/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,GAIb,MAAM,oBAAoB,CAAC;AAO5B,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,GAWhB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,2BAA2B,GAE5B,MAAM,oBAAoB,CAAC;AAS5B,MAAM,eAAe,GAAG,eAAe,CAAC;AACxC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AACxC,MAAM,uBAAuB,GAAG,MAAM,CAAC;AACvC,MAAM,wBAAwB,GAAG,UAAU,CAAC;AAC5C,MAAM,aAAa,GAAG,0BAA0B,CAAC;AACjD,MAAM,iBAAiB,GAAG,mCAAmC,CAAC;AAC9D,MAAM,eAAe,GAAG,uDAAuD,CAAC;AAChF,MAAM,yBAAyB,GAAG,mBAAmB,CAAC;AAEtD,MAAM,CAAC,MAAM,2BAA2B,GAAoB;IAC1D,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,YAAY;IACzB,OAAO,EAAE,eAAe;IACxB,cAAc,EAAE,CAAC,oBAAoB,EAAE,KAAK,CAAC;IAC7C,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC;CAClD,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAA2B;IAC7D,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC;IACjD,UAAU,EAAE;QACV,QAAQ;QACR,QAAQ;QACR,WAAW;QACX,OAAO;QACP,OAAO;QACP,OAAO;QACP,YAAY;QACZ,MAAM;QACN,YAAY;QACZ,eAAe;QACf,WAAW;QACX,YAAY;KACb;IACD,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE;IAC/C,oBAAoB,EAAE,CAAC,KAAK,CAAC;IAC7B,OAAO,EAAE,IAAI;IACb,eAAe,EAAE,IAAI;CACtB,CAAC;AAEF,SAAS,oBAAoB,CAC3B,KAAyB,EACzB,IAAY;IAEZ,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACpF,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;AACxF,CAAC;AAED,SAAS,eAAe,CACtB,OAA0B,EAC1B,KAAa;IAEb,MAAM,IAAI,GAAG,aAAa,KAAK,EAAE,CAAC;IAClC,MAAM,MAAM,GAA6B,EAAE,CAAC;IAC5C,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,GAAG,IAAI,OAAO;YACpB,OAAO,EAAE,4DAA4D;SACtE,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,GAAG,IAAI,QAAQ;YACrB,OAAO,EAAE,6DAA6D;SACvE,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,GAAG,IAAI,YAAY;YACzB,OAAO,EAAE,qDAAqD;SAC/D,CAAC,CAAC;IACL,CAAC;IACD,IAAI,OAAO,CAAC,SAAS,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7E,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,GAAG,IAAI,YAAY;YACzB,OAAO,EAAE,2DAA2D;SACrE,CAAC,CAAC;IACL,CAAC;IACD,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9D,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACxF,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,GAAG,IAAI,WAAW,KAAK,aAAa;gBAC1C,OAAO,EAAE,oFAAoF;aAC9F,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,MAA+B;IAE/B,MAAM,MAAM,GAA6B,EAAE,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC1D,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,wCAAwC;aAClD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,4BAA4B;SACtC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,KAAK,IAAI;QAClB,oBAAoB,CAAC,MAAM,CAAC,gBAAgB,EAAE,mBAAmB,CAAC;QAClE,oBAAoB,CAAC,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC;QAC9D,oBAAoB,CAAC,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC;QAC5D,oBAAoB,CAAC,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC;QAC5D,oBAAoB,CAAC,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC;KAC/D,EAAE,CAAC;QACF,IAAI,KAAK;YAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QACjE,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAC/F,CAAC;AAQD,SAAS,UAAU,CAAC,QAAiC,EAAE,SAAiB;IACtE,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,MAAM,OAAO,GAAG,GAAS,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/D,IAAI,QAAQ,EAAE,OAAO;QAAE,OAAO,EAAE,CAAC;;QAC5B,QAAQ,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;QAC9B,UAAU,GAAG,IAAI,CAAC;QAClB,UAAU,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,kBAAkB,EAAE,cAAc,CAAC,CAAC,CAAC;IACzE,CAAC,EAAE,SAAS,CAAC,CAAC;IAEd,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,QAAQ,EAAE,GAAG,EAAE,CAAC,UAAU;QAC1B,OAAO,EAAE,GAAG,EAAE;YACZ,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,QAAQ,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,OAAyB;IACxC,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC;IACvD,IAAI,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,YAAY,CACpB,yBAAyB,EACzB,yDAAyD,EACzD,EAAE,IAAI,EAAE,4BAA4B,EAAE,CACvC,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,UAAU,CAAI,KAAQ;IAC7B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAC5D,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,OAAO,iBAAiB;IAGnB,QAAQ,GAAG,2BAA2B,CAAC;IAC/B,MAAM,CAA0B;IAChC,MAAM,CAAmB;IACzB,UAAU,CAAU;IACpB,GAAG,CAAe;IAClB,eAAe,GAAG,IAAI,OAAO,EAAU,CAAC;IAEzD,YAAY,MAA+B,EAAE,UAAoC,EAAE;QACjF,MAAM,UAAU,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YACtB,MAAM,IAAI,YAAY,CAAC,gBAAgB,EAAE,uCAAuC,EAAE;gBAChF,OAAO,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE;aACvC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM;YACT,OAAO,CAAC,MAAM;gBACd,YAAY,CAAC;oBACX,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG;oBACpB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS;wBACpC,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACvC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS;wBACpC,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACvC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS;wBACpC,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACvC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS;wBACvC,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;oBAC9C,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,WAAW;oBACvD,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,gBAAgB,IAAI,wBAAwB;oBACzE,yBAAyB,EAAE,IAAI;iBAChC,CAAC,CAAC;QACL,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC;QAC/C,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACrC,CAAC;IAED,cAAc,CACZ,MAA+B;QAE/B,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,MAA+B;QAE/B,MAAM,UAAU,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YACtB,MAAM,IAAI,YAAY,CAAC,gBAAgB,EAAE,uCAAuC,EAAE;gBAChF,OAAO,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE;aACvC,CAAC,CAAC;QACL,CAAC;QACD,OAAO;YACL,GAAG,uBAAuB;YAC1B,oBAAoB,EAAE,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;SAC/D,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CACX,KAAoB,EACpB,OAAuB;QAEvB,MAAM,QAAQ,GAAG,UAAU,CAAC,sBAAsB,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACjF,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,OAAO,CACX,KAA+D,EAC/D,OAAyB;QAEzB,IAAI,SAAiB,CAAC;QACtB,IAAI,UAAmC,CAAC;QACxC,IAAI,MAAwE,CAAC;QAC7E,IAAI,SAAiB,CAAC;QAEtB,IAAI,eAAe,CAA8B,KAAK,CAAC,EAAE,CAAC;YACxD,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrC,MAAM,IAAI,YAAY,CACpB,yBAAyB,EACzB,2DAA2D,CAC5D,CAAC;YACJ,CAAC;YACD,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;YACrC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;YAC9B,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YACtB,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;gBACpC,MAAM,IAAI,YAAY,CACpB,uBAAuB,EACvB,wDAAwD,EACxD,EAAE,IAAI,EAAE,cAAc,EAAE,CACzB,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;YAC5D,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;YAC7B,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;YAC/B,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QAClC,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CACxB,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,wBAAwB,EAC3E,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,wBAAwB,CACvD,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE3B,MAAM,QAAQ,GAAuB;YACnC,QAAQ,EAAE,GAAG;YACb,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC;YAC7D,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,uBAAuB,CAAC;YAC7E,oBAAoB,EAAE,OAAO;YAC7B,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,wBAAwB,CAAC;YAC/E,kBAAkB,EAAE,OAAO;SAC5B,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;gBACxC,KAAK,EAAE,SAAS;gBAChB,MAAM,EAAE,MAAM;gBACd,YAAY,EAAE,UAAU;gBACxB,mBAAmB,EAAE,QAAQ;gBAC7B,YAAY,EAAE,KAAK,CAAC,MAAM;gBAC1B,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC;aAC3B,CAAC,CAAC;YACH,MAAM,QAAQ,GAAG,CAAC,MAAM,SAAS,CAAC,IAAI,EAAiB,CAAgC,CAAC;YACxF,OAAO,2BAA2B,CAAC,QAA8B,EAAE,MAAM,EAAE;gBACzE,SAAS;gBACT,cAAc,EAAE,eAAe;gBAC/B,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;aACnD,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;gBACrB,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,6BAA6B,SAAS,KAAK,EAAE;oBAC7E,KAAK,EAAE,KAAK;oBACZ,OAAO,EAAE,EAAE,SAAS,EAAE;iBACvB,CAAC,CAAC;YACL,CAAC;YACD,IAAI,OAAO,CAAC,WAAW,EAAE,OAAO,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxD,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,iCAAiC,EAAE;oBACnE,KAAK,EAAE,KAAK;iBACb,CAAC,CAAC;YACL,CAAC;YACD,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,oCAAoC,EAAE;gBAC/E,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CACX,KAAoB,EACpB,OAAuB;QAEvB,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG;YACZ,4BAA4B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI;YACvD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,gEAAgE;YAC/F,iDAAiD;SAClD,CAAC;QACF,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;QACnF,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QAChF,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QAC9E,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;QACjF,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;QACzD,OAAO;YACL,OAAO,EAAE,YAAY,KAAK,CAAC,QAAQ,CAAC,IAAI,wCAAwC;YAChF,KAAK;YACL,aAAa;YACb,QAAQ,EAAE,aAAa,CAAC,QAAQ;SACjC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,QAA0B;QAC7C,OAAO,wBAAwB,CAAC,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;IACrF,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACjD,CAAC;CACF"}