@openplait/adapter-clickhouse 0.1.0-alpha.0

package/dist/src/datasets.js

@@ -0,0 +1,203 @@
+const stringField = (expression) => ({
+    expression,
+    type: "string",
+    clickhouseType: "String",
+});
+const numberField = (expression, unit) => ({
+    expression,
+    type: "number",
+    clickhouseType: "Float64",
+    ...(unit === undefined ? {} : { unit }),
+});
+const timeField = (expression) => ({
+    expression,
+    type: "time",
+    clickhouseType: "DateTime64(9)",
+});
+const durationField = (expression, unit) => ({
+    expression,
+    type: "duration",
+    clickhouseType: "UInt64",
+    unit,
+});
+const resourceAttribute = (name) => `ResourceAttributes['${name}']`;
+const spanAttribute = (name) => `SpanAttributes['${name}']`;
+const sharedResourceFields = {
+    "service.name": stringField("ServiceName"),
+    "service.namespace": stringField(resourceAttribute("service.namespace")),
+    "deployment.environment": stringField(resourceAttribute("deployment.environment")),
+};
+const metricFields = {
+    timestamp: timeField("TimeUnix"),
+    ...sharedResourceFields,
+    "metric.name": stringField("MetricName"),
+    "metric.description": stringField("MetricDescription"),
+    "metric.unit": stringField("MetricUnit"),
+    "metric.value": numberField("Value"),
+};
+export const OTEL_CLICKHOUSE_DATASETS = [
+    {
+        name: "otel.spans",
+        signal: "traces",
+        table: "otel_traces",
+        timeField: "timestamp",
+        fields: {
+            timestamp: timeField("Timestamp"),
+            duration: durationField("Duration", "ns"),
+            ...sharedResourceFields,
+            "trace.id": stringField("TraceId"),
+            "span.id": stringField("SpanId"),
+            "span.parent_id": stringField("ParentSpanId"),
+            "span.name": stringField("SpanName"),
+            "span.kind": stringField("SpanKind"),
+            "status.code": stringField("StatusCode"),
+            "status.message": stringField("StatusMessage"),
+            "gen_ai.system": stringField(spanAttribute("gen_ai.system")),
+            "gen_ai.provider.name": stringField(spanAttribute("gen_ai.provider.name")),
+            "gen_ai.request.model": stringField(spanAttribute("gen_ai.request.model")),
+            "gen_ai.operation.name": stringField(spanAttribute("gen_ai.operation.name")),
+            "gen_ai.usage.input_tokens": numberField(`toUInt64OrZero(${spanAttribute("gen_ai.usage.input_tokens")})`, "tokens"),
+            "gen_ai.usage.output_tokens": numberField(`toUInt64OrZero(${spanAttribute("gen_ai.usage.output_tokens")})`, "tokens"),
+            "gen_ai.usage.cost": numberField(`toFloat64OrZero(${spanAttribute("gen_ai.usage.cost")})`, "currencyUSD"),
+        },
+    },
+    {
+        name: "otel.logs",
+        signal: "logs",
+        table: "otel_logs",
+        timeField: "timestamp",
+        fields: {
+            timestamp: timeField("Timestamp"),
+            ...sharedResourceFields,
+            "trace.id": stringField("TraceId"),
+            "span.id": stringField("SpanId"),
+            "log.severity": stringField("SeverityText"),
+            "log.severity_number": numberField("SeverityNumber"),
+            "log.body": stringField("Body"),
+        },
+    },
+    {
+        name: "otel.metrics.gauge",
+        signal: "metrics",
+        table: "otel_metrics_gauge",
+        timeField: "timestamp",
+        fields: { ...metricFields },
+    },
+    {
+        name: "otel.metrics.sum",
+        signal: "metrics",
+        table: "otel_metrics_sum",
+        timeField: "timestamp",
+        fields: { ...metricFields },
+    },
+    {
+        name: "otel.metrics.histogram",
+        signal: "metrics",
+        table: "otel_metrics_histogram",
+        timeField: "timestamp",
+        fields: {
+            timestamp: timeField("TimeUnix"),
+            ...sharedResourceFields,
+            "metric.name": stringField("MetricName"),
+            "metric.description": stringField("MetricDescription"),
+            "metric.unit": stringField("MetricUnit"),
+            "metric.count": numberField("Count"),
+            "metric.sum": numberField("Sum"),
+            "metric.min": numberField("Min"),
+            "metric.max": numberField("Max"),
+        },
+    },
+];
+export const OPENLIT_CLICKHOUSE_DATASETS = [
+    {
+        name: "openlit.evaluations",
+        signal: "tabular",
+        table: "openlit_evaluation",
+        arrayJoin: "evaluationData",
+        timeField: "timestamp",
+        fields: {
+            timestamp: timeField("created_at"),
+            "span.id": stringField("span_id"),
+            "evaluation.name": stringField("evaluationData.evaluation"),
+            "evaluation.classification": stringField("evaluationData.classification"),
+            "evaluation.explanation": stringField("evaluationData.explanation"),
+            "evaluation.verdict": stringField("evaluationData.verdict"),
+            "evaluation.source": stringField("meta['source']"),
+        },
+    },
+    {
+        name: "openlit.exceptions",
+        signal: "logs",
+        table: "otel_logs",
+        timeField: "timestamp",
+        fields: {
+            timestamp: timeField("Timestamp"),
+            ...sharedResourceFields,
+            "trace.id": stringField("TraceId"),
+            "span.id": stringField("SpanId"),
+            "log.severity": stringField("SeverityText"),
+            "log.severity_number": numberField("SeverityNumber"),
+            "log.body": stringField("Body"),
+        },
+        defaultFilter: {
+            field: "log.severity_number",
+            operator: "greaterThanOrEqual",
+            value: 17,
+        },
+    },
+    {
+        name: "openlit.costs",
+        signal: "traces",
+        table: "otel_traces",
+        timeField: "timestamp",
+        fields: {
+            timestamp: timeField("Timestamp"),
+            ...sharedResourceFields,
+            "trace.id": stringField("TraceId"),
+            "span.id": stringField("SpanId"),
+            "gen_ai.request.model": stringField(spanAttribute("gen_ai.request.model")),
+            "gen_ai.usage.cost": numberField(`toFloat64OrZero(${spanAttribute("gen_ai.usage.cost")})`, "currencyUSD"),
+        },
+        defaultFilter: {
+            field: "gen_ai.usage.cost",
+            operator: "greaterThan",
+            value: 0,
+        },
+    },
+];
+export function createDatasetRegistry(overrides = []) {
+    const registry = new Map();
+    for (const dataset of [...OTEL_CLICKHOUSE_DATASETS, ...overrides]) {
+        registry.set(dataset.name, dataset);
+    }
+    return registry;
+}
+export function datasetsToSemanticSchema(datasets) {
+    return {
+        datasets: [...datasets.values()].map((dataset) => ({
+            name: dataset.name,
+            signal: dataset.signal,
+            fields: Object.entries(dataset.fields).map(([name, field]) => ({
+                name,
+                type: field.type,
+                ...(field.unit === undefined ? {} : { unit: field.unit }),
+                ...(field.description === undefined
+                    ? {}
+                    : { description: field.description }),
+                signals: [dataset.signal],
+            })),
+            supportedAggregations: [
+                "count",
+                "sum",
+                "avg",
+                "min",
+                "max",
+                "percentile",
+                "distinctCount",
+                "rate",
+                "histogram",
+            ],
+        })),
+    };
+}
+//# sourceMappingURL=datasets.js.map

package/dist/src/datasets.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,7 @@
+export { CLICKHOUSE_ADAPTER_MANIFEST, CLICKHOUSE_CAPABILITIES, ClickHouseAdapter, validateClickHouseConfig, } from "./adapter.js";
+export { compileClickHouseQuery } from "./compiler.js";
+export { OPENLIT_CLICKHOUSE_DATASETS, OTEL_CLICKHOUSE_DATASETS, createDatasetRegistry, datasetsToSemanticSchema, } from "./datasets.js";
+export { compileNativeQuery, validateNativeStatement } from "./native.js";
+export { normalizeClickHouseResponse, type ClickHouseResponse, } from "./normalization.js";
+export type { ClickHouseAdapterConfig, ClickHouseAdapterOptions, ClickHouseCompiledStatement, ClickHouseDataset, ClickHouseFieldMapping, ClickHouseRow, ClickHouseTenantPolicy, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EACL,2BAA2B,EAC3B,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,6 @@
+export { CLICKHOUSE_ADAPTER_MANIFEST, CLICKHOUSE_CAPABILITIES, ClickHouseAdapter, validateClickHouseConfig, } from "./adapter.js";
+export { compileClickHouseQuery } from "./compiler.js";
+export { OPENLIT_CLICKHOUSE_DATASETS, OTEL_CLICKHOUSE_DATASETS, createDatasetRegistry, datasetsToSemanticSchema, } from "./datasets.js";
+export { compileNativeQuery, validateNativeStatement } from "./native.js";
+export { normalizeClickHouseResponse, } from "./normalization.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EACL,2BAA2B,GAE5B,MAAM,oBAAoB,CAAC"}

package/dist/src/native.d.ts

@@ -0,0 +1,7 @@
+import type { NativeQuery, ParameterMap } from "@openplait/core";
+export declare function validateNativeStatement(statement: string): void;
+export declare function compileNativeQuery(query: NativeQuery, variables?: ParameterMap): {
+    statement: string;
+    parameters: Record<string, unknown>;
+};
+//# sourceMappingURL=native.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../src/native.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AA2FjE,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAkC/D;AAUD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,SAAS,CAAC,EAAE,YAAY,GACvB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAmC5D"}

package/dist/src/native.js

@@ -0,0 +1,128 @@
+import { AdapterError } from "@openplait/adapter-sdk";
+import { resolveParameterMap } from "./parameters.js";
+const FORBIDDEN_KEYWORDS = new Set([
+    "ALTER",
+    "ATTACH",
+    "CREATE",
+    "DELETE",
+    "DETACH",
+    "DROP",
+    "GRANT",
+    "INSERT",
+    "INTO",
+    "KILL",
+    "OPTIMIZE",
+    "OUTFILE",
+    "RENAME",
+    "REPLACE",
+    "REVOKE",
+    "SYSTEM",
+    "TRUNCATE",
+    "UPDATE",
+]);
+const ALLOWED_FIRST_KEYWORDS = new Set(["EXPLAIN", "SELECT", "WITH"]);
+const BOUND_PARAMETER = /\{([A-Za-z_][A-Za-z0-9_]*):[^{}]+\}/g;
+function codeOutsideLiterals(statement) {
+    let output = "";
+    let index = 0;
+    let state = "code";
+    while (index < statement.length) {
+        const character = statement[index] ?? "";
+        const next = statement[index + 1] ?? "";
+        if (state === "code") {
+            if (character === "'")
+                state = "single";
+            else if (character === '"')
+                state = "double";
+            else if (character === "`")
+                state = "backtick";
+            else if (character === "-" && next === "-") {
+                state = "line";
+                index += 1;
+            }
+            else if (character === "/" && next === "*") {
+                state = "block";
+                index += 1;
+            }
+            else
+                output += character;
+        }
+        else if (state === "line") {
+            if (character === "\n") {
+                state = "code";
+                output += "\n";
+            }
+        }
+        else if (state === "block") {
+            if (character === "*" && next === "/") {
+                state = "code";
+                index += 1;
+                output += " ";
+            }
+        }
+        else {
+            const quote = state === "single" ? "'" : state === "double" ? '"' : "`";
+            if (character === "\\") {
+                index += 1;
+            }
+            else if (character === quote) {
+                if (next === quote)
+                    index += 1;
+                else
+                    state = "code";
+            }
+        }
+        index += 1;
+    }
+    if (state === "single" || state === "double" || state === "backtick") {
+        throw new AdapterError("NATIVE_QUERY_REJECTED", "Native SQL contains an unterminated quoted value.", { path: "/spec/native/statement" });
+    }
+    if (state === "block") {
+        throw new AdapterError("NATIVE_QUERY_REJECTED", "Native SQL contains an unterminated block comment.", { path: "/spec/native/statement" });
+    }
+    return output;
+}
+export function validateNativeStatement(statement) {
+    const code = codeOutsideLiterals(statement).trim();
+    if (code.includes(";")) {
+        throw new AdapterError("NATIVE_QUERY_REJECTED", "Native SQL must not contain statement separators.", { path: "/spec/native/statement" });
+    }
+    const keywords = code.match(/[A-Za-z_][A-Za-z0-9_]*/g)?.map((word) => word.toUpperCase()) ?? [];
+    const first = keywords[0];
+    if (!first || !ALLOWED_FIRST_KEYWORDS.has(first)) {
+        throw new AdapterError("NATIVE_QUERY_REJECTED", "Native SQL must be a SELECT, WITH, or EXPLAIN query.", { path: "/spec/native/statement" });
+    }
+    const forbidden = keywords.find((keyword) => FORBIDDEN_KEYWORDS.has(keyword));
+    if (forbidden) {
+        throw new AdapterError("NATIVE_QUERY_REJECTED", `Native SQL keyword '${forbidden}' is not allowed.`, { path: "/spec/native/statement", details: { keyword: forbidden } });
+    }
+    if (keywords.includes("FORMAT")) {
+        throw new AdapterError("NATIVE_QUERY_REJECTED", "Native SQL must not include FORMAT; the adapter controls the result format.", { path: "/spec/native/statement" });
+    }
+}
+function referencedParameters(statement) {
+    return new Set([...codeOutsideLiterals(statement).matchAll(BOUND_PARAMETER)].map((match) => match[1]));
+}
+export function compileNativeQuery(query, variables) {
+    if (query.spec.mode !== "native" || query.spec.native.language.toLowerCase() !== "sql") {
+        throw new AdapterError("NATIVE_QUERY_REJECTED", "The ClickHouse adapter accepts only native SQL queries.", { path: "/spec/native/language" });
+    }
+    validateNativeStatement(query.spec.native.statement);
+    const supplied = resolveParameterMap(query.spec.parameters ?? {}, variables);
+    const referenced = referencedParameters(query.spec.native.statement);
+    for (const name of referenced) {
+        if (!(name in supplied)) {
+            throw new AdapterError("INVALID_PARAMETER", `Native SQL parameter '${name}' has not been supplied.`, { path: `/spec/parameters/${name}` });
+        }
+    }
+    for (const name of Object.keys(supplied)) {
+        if (!referenced.has(name)) {
+            throw new AdapterError("INVALID_PARAMETER", `Native SQL parameter '${name}' is not referenced by the statement.`, { path: `/spec/parameters/${name}` });
+        }
+    }
+    return {
+        statement: query.spec.native.statement.trim(),
+        parameters: supplied,
+    };
+}
+//# sourceMappingURL=native.js.map

package/dist/src/native.js.map

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

package/dist/src/normalization.d.ts

@@ -0,0 +1,22 @@
+import type { CompiledField } from "@openplait/adapter-sdk";
+import type { QueryResult } from "@openplait/core";
+import type { ClickHouseRow } from "./types.js";
+export interface ClickHouseResponse {
+    data: ClickHouseRow[];
+    meta?: Array<{
+        name: string;
+        type: string;
+    }>;
+    statistics?: {
+        elapsed: number;
+        rows_read: number;
+        bytes_read: number;
+    };
+    rows?: number;
+}
+export declare function normalizeClickHouseResponse(response: ClickHouseResponse, fields: readonly CompiledField[] | undefined, options: {
+    frameName?: string;
+    adapterVersion: string;
+    executionTimeMs: number;
+}): QueryResult;
+//# sourceMappingURL=normalization.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalization.d.ts","sourceRoot":"","sources":["../../src/normalization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACd,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAGV,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,UAAU,CAAC,EAAE;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAgDD,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,SAAS,EAC5C,OAAO,EAAE;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB,GACA,WAAW,CA2Bb"}

package/dist/src/normalization.js

@@ -0,0 +1,79 @@
+function typeFromClickHouse(type) {
+    const unwrapped = type.replace(/^(?:Nullable|LowCardinality)\((.*)\)$/, "$1");
+    if (/^(?:U?Int\d+|Float\d+|Decimal)/.test(unwrapped))
+        return "number";
+    if (unwrapped === "Bool")
+        return "boolean";
+    if (/^Date(?:Time)?/.test(unwrapped))
+        return "time";
+    if (/^(?:Array|Map|Tuple|Nested|JSON|Object)\b/.test(unwrapped))
+        return "json";
+    return "string";
+}
+function normalizeValue(value, type) {
+    if (value === null || value === undefined)
+        return null;
+    if (type === "number" || type === "duration") {
+        const number = Number(value);
+        return Number.isFinite(number) ? number : null;
+    }
+    if (type === "boolean") {
+        if (typeof value === "boolean")
+            return value;
+        if (value === 1 || value === "1" || value === "true")
+            return true;
+        if (value === 0 || value === "0" || value === "false")
+            return false;
+        return null;
+    }
+    return value;
+}
+function inferredFields(response) {
+    if (response.meta?.length) {
+        return response.meta.map((field) => ({
+            name: field.name,
+            type: typeFromClickHouse(field.type),
+        }));
+    }
+    const first = response.data[0];
+    if (!first)
+        return [];
+    return Object.entries(first).map(([name, value]) => ({
+        name,
+        type: typeof value === "number"
+            ? "number"
+            : typeof value === "boolean"
+                ? "boolean"
+                : typeof value === "object"
+                    ? "json"
+                    : "string",
+    }));
+}
+export function normalizeClickHouseResponse(response, fields, options) {
+    const resolvedFields = fields?.length ? fields : inferredFields(response);
+    const dataFields = resolvedFields.map((field) => ({
+        name: field.name,
+        type: field.type,
+        values: response.data.map((row) => normalizeValue(row[field.name], field.type)),
+        ...(field.unit === undefined ? {} : { unit: field.unit }),
+    }));
+    return {
+        frames: [
+            {
+                ...(options.frameName === undefined ? {} : { name: options.frameName }),
+                length: response.data.length,
+                fields: dataFields,
+            },
+        ],
+        metadata: {
+            datasource: "clickhouse",
+            adapterVersion: options.adapterVersion,
+            executionTimeMs: options.executionTimeMs,
+            rowsRead: response.statistics?.rows_read ?? response.data.length,
+            rowsReturned: response.data.length,
+            cache: "bypass",
+            warnings: [],
+        },
+    };
+}
+//# sourceMappingURL=normalization.js.map

package/dist/src/normalization.js.map

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

package/dist/src/parameters.d.ts

@@ -0,0 +1,5 @@
+import type { ParameterMap, ScalarValue } from "@openplait/core";
+export declare function resolveParameterValue(value: ScalarValue | ScalarValue[], queryParameters: ParameterMap, variables: ParameterMap | undefined, path: string, seen?: ReadonlySet<string>): ScalarValue | ScalarValue[];
+export declare function resolveParameterMap(parameters: ParameterMap, variables: ParameterMap | undefined): Record<string, ScalarValue | ScalarValue[]>;
+export declare function scalarClickHouseType(value: ScalarValue): string;
+//# sourceMappingURL=parameters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parameters.d.ts","sourceRoot":"","sources":["../../src/parameters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAKjE,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,WAAW,GAAG,WAAW,EAAE,EAClC,eAAe,EAAE,YAAY,EAC7B,SAAS,EAAE,YAAY,GAAG,SAAS,EACnC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,WAAW,CAAC,MAAM,CAAa,GACpC,WAAW,GAAG,WAAW,EAAE,CA+B7B;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,YAAY,EACxB,SAAS,EAAE,YAAY,GAAG,SAAS,GAClC,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC,CAiB7C;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAK/D"}

package/dist/src/parameters.js

@@ -0,0 +1,39 @@
+import { AdapterError } from "@openplait/adapter-sdk";
+const PARAMETER_REFERENCE = /^\$\{([A-Za-z_][A-Za-z0-9_]*)\}$/;
+export function resolveParameterValue(value, queryParameters, variables, path, seen = new Set()) {
+    if (typeof value !== "string")
+        return value;
+    const match = PARAMETER_REFERENCE.exec(value);
+    if (!match)
+        return value;
+    const name = match[1];
+    if (!name)
+        return value;
+    if (seen.has(name)) {
+        throw new AdapterError("INVALID_PARAMETER", `Parameter '${name}' contains a circular reference.`, { path });
+    }
+    const resolved = queryParameters[name] ?? variables?.[name];
+    if (resolved === undefined) {
+        throw new AdapterError("INVALID_PARAMETER", `Parameter '${name}' has not been resolved.`, { path, details: { parameter: name } });
+    }
+    return resolveParameterValue(resolved, queryParameters, variables, path, new Set([...seen, name]));
+}
+export function resolveParameterMap(parameters, variables) {
+    return Object.fromEntries(Object.entries(parameters).map(([name, value]) => {
+        const otherParameters = Object.fromEntries(Object.entries(parameters).filter(([candidate]) => candidate !== name));
+        return [
+            name,
+            resolveParameterValue(value, otherParameters, variables, `/spec/parameters/${name}`),
+        ];
+    }));
+}
+export function scalarClickHouseType(value) {
+    if (typeof value === "number")
+        return "Float64";
+    if (typeof value === "boolean")
+        return "Bool";
+    if (value === null)
+        return "Nullable(String)";
+    return "String";
+}
+//# sourceMappingURL=parameters.js.map

package/dist/src/parameters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameters.js","sourceRoot":"","sources":["../../src/parameters.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,mBAAmB,GAAG,kCAAkC,CAAC;AAE/D,MAAM,UAAU,qBAAqB,CACnC,KAAkC,EAClC,eAA6B,EAC7B,SAAmC,EACnC,IAAY,EACZ,OAA4B,IAAI,GAAG,EAAE;IAErC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5C,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,YAAY,CACpB,mBAAmB,EACnB,cAAc,IAAI,kCAAkC,EACpD,EAAE,IAAI,EAAE,CACT,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC;IAC5D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,YAAY,CACpB,mBAAmB,EACnB,cAAc,IAAI,0BAA0B,EAC5C,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CACvC,CAAC;IACJ,CAAC;IAED,OAAO,qBAAqB,CAC1B,QAAQ,EACR,eAAe,EACf,SAAS,EACT,IAAI,EACJ,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,CACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,UAAwB,EACxB,SAAmC;IAEnC,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;QAC/C,MAAM,eAAe,GAAG,MAAM,CAAC,WAAW,CACxC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,SAAS,KAAK,IAAI,CAAC,CACvE,CAAC;QACF,OAAO;YACL,IAAI;YACJ,qBAAqB,CACnB,KAAK,EACL,eAAe,EACf,SAAS,EACT,oBAAoB,IAAI,EAAE,CAC3B;SACF,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAkB;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAC9C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,kBAAkB,CAAC;IAC9C,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/src/types.d.ts

@@ -0,0 +1,49 @@
+import type { ClickHouseClient } from "@clickhouse/client";
+import type { BooleanExpression, DataFieldType, ScalarValue, SignalType } from "@openplait/core";
+export interface ClickHouseFieldMapping {
+    expression: string;
+    type: DataFieldType;
+    clickhouseType: string;
+    unit?: string;
+    description?: string;
+}
+export interface ClickHouseDataset {
+    name: string;
+    signal: SignalType;
+    table: string;
+    timeField: string;
+    fields: Record<string, ClickHouseFieldMapping>;
+    defaultFilter?: BooleanExpression;
+    arrayJoin?: string;
+}
+export interface ClickHouseTenantPolicy {
+    field: string;
+    value: ScalarValue;
+}
+export interface ClickHouseAdapterConfig {
+    url: string;
+    username?: string;
+    password?: string;
+    database?: string;
+    /** Additional HTTP headers required by managed ClickHouse endpoints. */
+    httpHeaders?: Record<string, string>;
+    applicationName?: string;
+    requestTimeoutMs?: number;
+    queryTimeoutMs?: number;
+    maxResultRows?: number;
+    maxRowsToRead?: number;
+    maxTimeRangeMs?: number;
+    requireTimeRange?: boolean;
+    allowNativeQueries?: boolean;
+    tenant?: ClickHouseTenantPolicy;
+    datasets?: ClickHouseDataset[];
+}
+export interface ClickHouseCompiledStatement {
+    statement: string;
+}
+export interface ClickHouseAdapterOptions {
+    client?: ClickHouseClient;
+    now?: () => number;
+}
+export type ClickHouseRow = Record<string, unknown>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,UAAU,EACX,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,aAAa,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAC/C,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

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