@perses-dev/greptimedb-plugin 0.1.0-beta.0

package/lib/queries/greptimedb-trace-query/GreptimeDBTraceQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GreptimeDBTraceQuery.d.ts","sourceRoot":"","sources":["../../../../src/queries/greptimedb-trace-query/GreptimeDBTraceQuery.tsx"],"names":[],"mappings":"AAaA,OAAO,EAAkB,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAI1E,eAAO,MAAM,oBAAoB,EAAE,gBAAgB,CAAC,wBAAwB,CAY3E,CAAC"}

package/lib/queries/greptimedb-trace-query/GreptimeDBTraceQuery.js

@@ -0,0 +1,32 @@
+// Copyright The Perses Authors
+// 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.
+import { parseVariables } from '@perses-dev/plugin-system';
+import { getGreptimeDBTraceData } from './get-greptimedb-trace-data';
+import { GreptimeDBTraceQueryEditor } from './GreptimeDBTraceQueryEditor';
+export const GreptimeDBTraceQuery = {
+    getTraceData: getGreptimeDBTraceData,
+    OptionsEditorComponent: GreptimeDBTraceQueryEditor,
+    createInitialOptions: ()=>({
+            query: ''
+        }),
+    dependsOn: (spec)=>{
+        const queryVariables = parseVariables(spec.query);
+        return {
+            variables: [
+                ...new Set(queryVariables)
+            ]
+        };
+    }
+};
+
+//# sourceMappingURL=GreptimeDBTraceQuery.js.map

package/lib/queries/greptimedb-trace-query/GreptimeDBTraceQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/queries/greptimedb-trace-query/GreptimeDBTraceQuery.tsx"],"sourcesContent":["// Copyright The Perses Authors\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n// http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport { parseVariables, TraceQueryPlugin } from '@perses-dev/plugin-system';\nimport { GreptimeDBTraceQuerySpec } from './greptimedb-trace-query-types';\nimport { getGreptimeDBTraceData } from './get-greptimedb-trace-data';\nimport { GreptimeDBTraceQueryEditor } from './GreptimeDBTraceQueryEditor';\n\nexport const GreptimeDBTraceQuery: TraceQueryPlugin<GreptimeDBTraceQuerySpec> = {\n  getTraceData: getGreptimeDBTraceData,\n  OptionsEditorComponent: GreptimeDBTraceQueryEditor,\n  createInitialOptions: () => ({\n    query: '',\n  }),\n  dependsOn: (spec) => {\n    const queryVariables = parseVariables(spec.query);\n    return {\n      variables: [...new Set(queryVariables)],\n    };\n  },\n};\n"],"names":["parseVariables","getGreptimeDBTraceData","GreptimeDBTraceQueryEditor","GreptimeDBTraceQuery","getTraceData","OptionsEditorComponent","createInitialOptions","query","dependsOn","spec","queryVariables","variables","Set"],"mappings":"AAAA,+BAA+B;AAC/B,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,6CAA6C;AAC7C,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,SAASA,cAAc,QAA0B,4BAA4B;AAE7E,SAASC,sBAAsB,QAAQ,8BAA8B;AACrE,SAASC,0BAA0B,QAAQ,+BAA+B;AAE1E,OAAO,MAAMC,uBAAmE;IAC9EC,cAAcH;IACdI,wBAAwBH;IACxBI,sBAAsB,IAAO,CAAA;YAC3BC,OAAO;QACT,CAAA;IACAC,WAAW,CAACC;QACV,MAAMC,iBAAiBV,eAAeS,KAAKF,KAAK;QAChD,OAAO;YACLI,WAAW;mBAAI,IAAIC,IAAIF;aAAgB;QACzC;IACF;AACF,EAAE"}

package/lib/queries/greptimedb-trace-query/GreptimeDBTraceQueryEditor.d.ts

@@ -0,0 +1,7 @@
+import { OptionsEditorProps } from '@perses-dev/plugin-system';
+import { ReactElement } from 'react';
+import { GreptimeDBTraceQuerySpec } from './greptimedb-trace-query-types';
+type GreptimeDBTraceQueryEditorProps = OptionsEditorProps<GreptimeDBTraceQuerySpec>;
+export declare function GreptimeDBTraceQueryEditor(props: GreptimeDBTraceQueryEditorProps): ReactElement;
+export {};
+//# sourceMappingURL=GreptimeDBTraceQueryEditor.d.ts.map

package/lib/queries/greptimedb-trace-query/GreptimeDBTraceQueryEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GreptimeDBTraceQueryEditor.d.ts","sourceRoot":"","sources":["../../../../src/queries/greptimedb-trace-query/GreptimeDBTraceQueryEditor.tsx"],"names":[],"mappings":"AAeA,OAAO,EAIL,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,YAAY,EAAe,MAAM,OAAO,CAAC;AAIlD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAE1E,KAAK,+BAA+B,GAAG,kBAAkB,CAAC,wBAAwB,CAAC,CAAC;AAEpF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,+BAA+B,GAAG,YAAY,CAwD/F"}

package/lib/queries/greptimedb-trace-query/GreptimeDBTraceQueryEditor.js

@@ -0,0 +1,71 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// Copyright The Perses Authors
+// 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.
+import { Stack } from '@mui/material';
+import { produce } from 'immer';
+import { DatasourceSelect, isVariableDatasource } from '@perses-dev/plugin-system';
+import { useCallback } from 'react';
+import { GreptimeDBQLEditor } from '../../components';
+import { DATASOURCE_KIND, DEFAULT_DATASOURCE } from '../constants';
+import { useQueryState } from '../query-editor-model';
+export function GreptimeDBTraceQueryEditor(props) {
+    const { onChange, value } = props;
+    const { datasource } = value;
+    const selectedDatasource = datasource ?? DEFAULT_DATASOURCE;
+    const { query, handleQueryChange, handleQueryBlur } = useQueryState(props);
+    const handleDatasourceChange = (newDatasourceSelection)=>{
+        if (!isVariableDatasource(newDatasourceSelection) && newDatasourceSelection.kind === DATASOURCE_KIND) {
+            onChange(produce(value, (draft)=>{
+                draft.datasource = newDatasourceSelection;
+            }));
+            return;
+        }
+        throw new Error('Got unexpected non GreptimeDB datasource selection');
+    };
+    const handleQueryExecute = (queryValue)=>{
+        onChange(produce(value, (draft)=>{
+            draft.query = queryValue;
+        }));
+    };
+    const handleGreptimeDBQueryChange = useCallback((next)=>{
+        handleQueryChange(next);
+    }, [
+        handleQueryChange
+    ]);
+    return /*#__PURE__*/ _jsxs(Stack, {
+        spacing: 1.5,
+        children: [
+            /*#__PURE__*/ _jsx(DatasourceSelect, {
+                datasourcePluginKind: DATASOURCE_KIND,
+                value: selectedDatasource,
+                onChange: handleDatasourceChange,
+                label: "GreptimeDB Datasource",
+                notched: true
+            }),
+            /*#__PURE__*/ _jsx(GreptimeDBQLEditor, {
+                value: query,
+                onChange: handleGreptimeDBQueryChange,
+                onBlur: handleQueryBlur,
+                onKeyDown: (event)=>{
+                    if (event.key === 'Enter' && (event.ctrlKey || event.metaKey)) {
+                        event.preventDefault();
+                        handleQueryExecute(query);
+                    }
+                },
+                placeholder: "Enter SQL for trace search or trace details"
+            })
+        ]
+    });
+}
+
+//# sourceMappingURL=GreptimeDBTraceQueryEditor.js.map

package/lib/queries/greptimedb-trace-query/GreptimeDBTraceQueryEditor.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/queries/greptimedb-trace-query/GreptimeDBTraceQueryEditor.tsx"],"sourcesContent":["// Copyright The Perses Authors\n// Licensed under the Apache License, Version 2.0 (the \"License\");\n// you may not use this file except in compliance with the License.\n// You may obtain a copy of the License at\n//\n// http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing, software\n// distributed under the License is distributed on an \"AS IS\" BASIS,\n// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n// See the License for the specific language governing permissions and\n// limitations under the License.\n\nimport { Stack } from '@mui/material';\nimport { produce } from 'immer';\nimport {\n  DatasourceSelect,\n  DatasourceSelectProps,\n  isVariableDatasource,\n  OptionsEditorProps,\n} from '@perses-dev/plugin-system';\nimport { ReactElement, useCallback } from 'react';\nimport { GreptimeDBQLEditor } from '../../components';\nimport { DATASOURCE_KIND, DEFAULT_DATASOURCE } from '../constants';\nimport { useQueryState } from '../query-editor-model';\nimport { GreptimeDBTraceQuerySpec } from './greptimedb-trace-query-types';\n\ntype GreptimeDBTraceQueryEditorProps = OptionsEditorProps<GreptimeDBTraceQuerySpec>;\n\nexport function GreptimeDBTraceQueryEditor(props: GreptimeDBTraceQueryEditorProps): ReactElement {\n  const { onChange, value } = props;\n  const { datasource } = value;\n  const selectedDatasource = datasource ?? DEFAULT_DATASOURCE;\n  const { query, handleQueryChange, handleQueryBlur } = useQueryState(props);\n\n  const handleDatasourceChange: DatasourceSelectProps['onChange'] = (newDatasourceSelection) => {\n    if (!isVariableDatasource(newDatasourceSelection) && newDatasourceSelection.kind === DATASOURCE_KIND) {\n      onChange(\n        produce(value, (draft) => {\n          draft.datasource = newDatasourceSelection;\n        })\n      );\n      return;\n    }\n    throw new Error('Got unexpected non GreptimeDB datasource selection');\n  };\n\n  const handleQueryExecute = (queryValue: string): void => {\n    onChange(\n      produce(value, (draft) => {\n        draft.query = queryValue;\n      })\n    );\n  };\n\n  const handleGreptimeDBQueryChange = useCallback(\n    (next: string) => {\n      handleQueryChange(next);\n    },\n    [handleQueryChange]\n  );\n\n  return (\n    <Stack spacing={1.5}>\n      <DatasourceSelect\n        datasourcePluginKind={DATASOURCE_KIND}\n        value={selectedDatasource}\n        onChange={handleDatasourceChange}\n        label=\"GreptimeDB Datasource\"\n        notched\n      />\n      <GreptimeDBQLEditor\n        value={query}\n        onChange={handleGreptimeDBQueryChange}\n        onBlur={handleQueryBlur}\n        onKeyDown={(event) => {\n          if (event.key === 'Enter' && (event.ctrlKey || event.metaKey)) {\n            event.preventDefault();\n            handleQueryExecute(query);\n          }\n        }}\n        placeholder=\"Enter SQL for trace search or trace details\"\n      />\n    </Stack>\n  );\n}\n"],"names":["Stack","produce","DatasourceSelect","isVariableDatasource","useCallback","GreptimeDBQLEditor","DATASOURCE_KIND","DEFAULT_DATASOURCE","useQueryState","GreptimeDBTraceQueryEditor","props","onChange","value","datasource","selectedDatasource","query","handleQueryChange","handleQueryBlur","handleDatasourceChange","newDatasourceSelection","kind","draft","Error","handleQueryExecute","queryValue","handleGreptimeDBQueryChange","next","spacing","datasourcePluginKind","label","notched","onBlur","onKeyDown","event","key","ctrlKey","metaKey","preventDefault","placeholder"],"mappings":";AAAA,+BAA+B;AAC/B,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,6CAA6C;AAC7C,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,SAASA,KAAK,QAAQ,gBAAgB;AACtC,SAASC,OAAO,QAAQ,QAAQ;AAChC,SACEC,gBAAgB,EAEhBC,oBAAoB,QAEf,4BAA4B;AACnC,SAAuBC,WAAW,QAAQ,QAAQ;AAClD,SAASC,kBAAkB,QAAQ,mBAAmB;AACtD,SAASC,eAAe,EAAEC,kBAAkB,QAAQ,eAAe;AACnE,SAASC,aAAa,QAAQ,wBAAwB;AAKtD,OAAO,SAASC,2BAA2BC,KAAsC;IAC/E,MAAM,EAAEC,QAAQ,EAAEC,KAAK,EAAE,GAAGF;IAC5B,MAAM,EAAEG,UAAU,EAAE,GAAGD;IACvB,MAAME,qBAAqBD,cAAcN;IACzC,MAAM,EAAEQ,KAAK,EAAEC,iBAAiB,EAAEC,eAAe,EAAE,GAAGT,cAAcE;IAEpE,MAAMQ,yBAA4D,CAACC;QACjE,IAAI,CAAChB,qBAAqBgB,2BAA2BA,uBAAuBC,IAAI,KAAKd,iBAAiB;YACpGK,SACEV,QAAQW,OAAO,CAACS;gBACdA,MAAMR,UAAU,GAAGM;YACrB;YAEF;QACF;QACA,MAAM,IAAIG,MAAM;IAClB;IAEA,MAAMC,qBAAqB,CAACC;QAC1Bb,SACEV,QAAQW,OAAO,CAACS;YACdA,MAAMN,KAAK,GAAGS;QAChB;IAEJ;IAEA,MAAMC,8BAA8BrB,YAClC,CAACsB;QACCV,kBAAkBU;IACpB,GACA;QAACV;KAAkB;IAGrB,qBACE,MAAChB;QAAM2B,SAAS;;0BACd,KAACzB;gBACC0B,sBAAsBtB;gBACtBM,OAAOE;gBACPH,UAAUO;gBACVW,OAAM;gBACNC,OAAO;;0BAET,KAACzB;gBACCO,OAAOG;gBACPJ,UAAUc;gBACVM,QAAQd;gBACRe,WAAW,CAACC;oBACV,IAAIA,MAAMC,GAAG,KAAK,WAAYD,CAAAA,MAAME,OAAO,IAAIF,MAAMG,OAAO,AAAD,GAAI;wBAC7DH,MAAMI,cAAc;wBACpBd,mBAAmBR;oBACrB;gBACF;gBACAuB,aAAY;;;;AAIpB"}

package/lib/queries/greptimedb-trace-query/get-greptimedb-trace-data.d.ts

@@ -0,0 +1,11 @@
+import { TraceQueryPlugin } from '@perses-dev/plugin-system';
+import { GreptimeDBTraceQuerySpec } from './greptimedb-trace-query-types';
+export declare const getGreptimeDBTraceData: TraceQueryPlugin<GreptimeDBTraceQuerySpec>['getTraceData'];
+/**
+ * SQL column values only (timestamp, timestamp_end, duration_nano, …).
+ * Requires data_type from getColumnDataType. GreptimeDB /v1/sql returns numeric cells (and numeric strings).
+ * - Timestamp* (TIMESTAMP(9) on opentelemetry_traces) → scale to nanoseconds.
+ * - Int64/UInt64 (duration_nano) → already nanoseconds, no scaling.
+ */
+export declare function toNanoString(value: unknown, dataType: string): string | undefined;
+//# sourceMappingURL=get-greptimedb-trace-data.d.ts.map

package/lib/queries/greptimedb-trace-query/get-greptimedb-trace-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-greptimedb-trace-data.d.ts","sourceRoot":"","sources":["../../../../src/queries/greptimedb-trace-query/get-greptimedb-trace-data.ts"],"names":[],"mappings":"AAaA,OAAO,EAAoB,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAY/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAe1E,eAAO,MAAM,sBAAsB,EAAE,gBAAgB,CAAC,wBAAwB,CAAC,CAAC,cAAc,CAuC7F,CAAC;AAsNF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAYjF"}

package/lib/queries/greptimedb-trace-query/get-greptimedb-trace-data.js

@@ -0,0 +1,466 @@
+// Copyright The Perses Authors
+// 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.
+import { replaceVariables } from '@perses-dev/plugin-system';
+import * as otlptracev1 from '@perses-dev/spec/dist/dashboard/query-type/otlp/trace/v1/trace';
+import { DEFAULT_DATASOURCE } from '../constants';
+import { normalizeRecords, toTimestampMs } from '../greptimedb-query-data-model';
+import { isLikelyTraceDetailSQL } from './trace-query-sql';
+export const getGreptimeDBTraceData = async (spec, context)=>{
+    const rawQuery = replaceVariables(spec.query ?? '', context.variableState).trim();
+    if (rawQuery.length === 0) {
+        return {
+            searchResult: []
+        };
+    }
+    const datasourceSelector = normalizeDatasourceSelector(spec.datasource);
+    const client = await context.datasourceStore.getDatasourceClient(datasourceSelector ?? DEFAULT_DATASOURCE);
+    const start = context.absoluteTimeRange?.start.getTime().toString() ?? '0';
+    const end = context.absoluteTimeRange?.end.getTime().toString() ?? '0';
+    const response = await client.query({
+        query: rawQuery,
+        start,
+        end
+    });
+    if (response.status === 'error') {
+        throw new Error(response.error ?? 'GreptimeDB trace query failed');
+    }
+    const records = normalizeRecords(response.data);
+    const isDetailQuery = isLikelyTraceDetailSQL(rawQuery);
+    if (isDetailQuery && isTraceDetailsResult(records)) {
+        return {
+            trace: convertRowsToTrace(records),
+            metadata: {
+                executedQueryString: rawQuery
+            }
+        };
+    }
+    return {
+        searchResult: buildSearchResult(records),
+        metadata: {
+            executedQueryString: rawQuery
+        }
+    };
+};
+function normalizeDatasourceSelector(datasource) {
+    if (!datasource) {
+        return undefined;
+    }
+    // Deep links may carry an empty datasource name. Treat it as "default datasource for this kind".
+    if (typeof datasource.name === 'string' && datasource.name.trim() === '') {
+        const { kind } = datasource;
+        return kind ? {
+            kind
+        } : undefined;
+    }
+    return datasource;
+}
+function buildColumnIndexMap(columns) {
+    const map = {};
+    (columns ?? []).forEach((c, index)=>{
+        map[c.name.toLowerCase()] = index;
+    });
+    return map;
+}
+/** GreptimeDB /v1/sql includes data_type on every column_schemas entry. */ function getColumnDataType(columns, index) {
+    const column = columns[index];
+    if (!column) {
+        throw new Error(`GreptimeDB SQL response missing column at index ${index}`);
+    }
+    const dataType = column.data_type;
+    if (!dataType) {
+        throw new Error(`GreptimeDB SQL response missing data_type for column "${column.name}"`);
+    }
+    return dataType;
+}
+function isTraceDetailsResult(records) {
+    const columns = records?.schema?.column_schemas ?? [];
+    if (columns.length === 0) return false;
+    const map = buildColumnIndexMap(columns);
+    // Trace detail queries should return span-level columns for gantt visualization.
+    return map.trace_id !== undefined && map.span_id !== undefined;
+}
+function getCell(row, map, names) {
+    for (const name of names){
+        const idx = map[name.toLowerCase()];
+        if (idx !== undefined) {
+            return row[idx];
+        }
+    }
+    return undefined;
+}
+function getString(value) {
+    if (value === null || value === undefined) return undefined;
+    return String(value);
+}
+function getNumber(value) {
+    if (value === null || value === undefined) return undefined;
+    if (typeof value === 'number') return Number.isFinite(value) ? value : undefined;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+function isErrorStatus(value) {
+    const normalized = String(value ?? '').trim().toUpperCase();
+    return normalized === 'STATUS_CODE_ERROR' || normalized === 'ERROR' || normalized === '2';
+}
+function getDurationMs(row, columns, map) {
+    const durationMs = getNumber(getCell(row, map, [
+        'duration_ms'
+    ]));
+    if (durationMs !== undefined) return durationMs;
+    const durationNano = getNumber(getCell(row, map, [
+        'duration_nano',
+        'duration_ns'
+    ]));
+    if (durationNano !== undefined) return durationNano / 1_000_000;
+    const startIndex = map.timestamp ?? map.start_time ?? map.start_time_unix_nano;
+    const endIndex = map.timestamp_end ?? map.end_time ?? map.end_time_unix_nano;
+    if (columns && startIndex !== undefined && endIndex !== undefined) {
+        const startMs = toTimestampMs(row[startIndex], getColumnDataType(columns, startIndex));
+        const endMs = toTimestampMs(row[endIndex], getColumnDataType(columns, endIndex));
+        if (startMs !== null && endMs !== null) return Math.max(0, endMs - startMs);
+    }
+    return 0;
+}
+function getStartMs(row, columns, map) {
+    const candidates = [
+        'timestamp',
+        'start_time',
+        'start_time_unix_nano',
+        'start_time_unix_ns',
+        'start_time_unix_ms',
+        'start_time_unix'
+    ];
+    for (const c of candidates){
+        const idx = map[c];
+        if (idx === undefined) continue;
+        if (!columns) continue;
+        const ts = toTimestampMs(row[idx], getColumnDataType(columns, idx));
+        if (ts !== null) return ts;
+    }
+    return undefined;
+}
+function getEndMs(row, columns, map) {
+    const candidates = [
+        'timestamp_end',
+        'end_time',
+        'end_time_unix_nano',
+        'end_time_unix_ns',
+        'end_time_unix_ms'
+    ];
+    for (const c of candidates){
+        const idx = map[c];
+        if (idx === undefined) continue;
+        if (!columns) continue;
+        const ts = toTimestampMs(row[idx], getColumnDataType(columns, idx));
+        if (ts !== null) return ts;
+    }
+    return undefined;
+}
+function buildSearchResult(records) {
+    const columns = records?.schema?.column_schemas ?? [];
+    const rows = records?.rows ?? [];
+    if (!columns.length || !rows.length) return [];
+    const map = buildColumnIndexMap(columns);
+    const traceMap = new Map();
+    rows.forEach((row)=>{
+        const traceId = getString(getCell(row, map, [
+            'trace_id',
+            'traceid',
+            'traceId'
+        ]));
+        if (!traceId) return;
+        const startMs = getStartMs(row, columns, map);
+        const durationMs = getDurationMs(row, columns, map);
+        const endMs = getEndMs(row, columns, map) ?? (startMs !== undefined ? startMs + durationMs : undefined);
+        const serviceName = getString(getCell(row, map, [
+            'service_name',
+            'root_service_name'
+        ])) ?? 'unknown';
+        const spanName = getString(getCell(row, map, [
+            'span_name',
+            'root_trace_name',
+            'operation_name',
+            'name'
+        ])) ?? '(unknown span)';
+        const parentSpanId = getString(getCell(row, map, [
+            'parent_span_id',
+            'parentspanid',
+            'parentSpanId'
+        ]));
+        const existing = traceMap.get(traceId);
+        if (!existing) {
+            traceMap.set(traceId, {
+                traceId,
+                startTimeUnixMs: startMs ?? 0,
+                endTimeUnixMs: endMs ?? startMs ?? 0,
+                rootServiceName: serviceName,
+                rootTraceName: spanName,
+                serviceStats: {
+                    [serviceName]: {
+                        spanCount: 1,
+                        errorCount: isErrorStatus(getCell(row, map, [
+                            'span_status_code',
+                            'status_code'
+                        ])) ? 1 : 0
+                    }
+                }
+            });
+            return;
+        }
+        if (startMs !== undefined) {
+            existing.startTimeUnixMs = existing.startTimeUnixMs === 0 ? startMs : Math.min(existing.startTimeUnixMs, startMs);
+        }
+        if (endMs !== undefined) {
+            existing.endTimeUnixMs = Math.max(existing.endTimeUnixMs, endMs);
+        }
+        if (!parentSpanId) {
+            existing.rootTraceName = spanName;
+            existing.rootServiceName = serviceName;
+        }
+        if (!existing.serviceStats[serviceName]) {
+            existing.serviceStats[serviceName] = {
+                spanCount: 0,
+                errorCount: 0
+            };
+        }
+        existing.serviceStats[serviceName].spanCount += 1;
+        if (isErrorStatus(getCell(row, map, [
+            'span_status_code',
+            'status_code'
+        ]))) {
+            existing.serviceStats[serviceName].errorCount += 1;
+        }
+    });
+    return Array.from(traceMap.values()).map((entry)=>({
+            traceId: entry.traceId,
+            startTimeUnixMs: entry.startTimeUnixMs,
+            durationMs: Math.max(0, entry.endTimeUnixMs - entry.startTimeUnixMs),
+            rootServiceName: entry.rootServiceName,
+            rootTraceName: entry.rootTraceName,
+            serviceStats: entry.serviceStats
+        })).sort((a, b)=>b.startTimeUnixMs - a.startTimeUnixMs);
+}
+function isIntegerGreptimeDataType(dataType) {
+    const normalized = dataType.toLowerCase();
+    return normalized.includes('int') || normalized.includes('uint') || normalized === 'bigint';
+}
+/**
+ * span_events JSON only: OTLP timeUnixNano is already nanoseconds (not a GreptimeDB TIMESTAMP column).
+ * @see https://docs.greptime.com/user-guide/traces/data-model/
+ */ function otlpEventTimeToNanoString(value) {
+    if (value === undefined || value === null) return undefined;
+    const raw = getNumber(value);
+    if (raw !== undefined) return String(BigInt(Math.trunc(raw)));
+    const dateMs = new Date(String(value)).getTime();
+    if (!Number.isNaN(dateMs)) return String(BigInt(Math.trunc(dateMs)) * 1_000_000n);
+    return undefined;
+}
+/**
+ * SQL column values only (timestamp, timestamp_end, duration_nano, …).
+ * Requires data_type from getColumnDataType. GreptimeDB /v1/sql returns numeric cells (and numeric strings).
+ * - Timestamp* (TIMESTAMP(9) on opentelemetry_traces) → scale to nanoseconds.
+ * - Int64/UInt64 (duration_nano) → already nanoseconds, no scaling.
+ */ export function toNanoString(value, dataType) {
+    if (value === undefined || value === null) return undefined;
+    const raw = getNumber(value);
+    if (raw === undefined) return undefined;
+    const normalized = dataType.toLowerCase();
+    if (normalized.includes('nanosecond')) return String(BigInt(Math.trunc(raw)));
+    if (normalized.includes('microsecond')) return String(BigInt(Math.trunc(raw)) * 1000n);
+    if (normalized.includes('millisecond')) return String(BigInt(Math.trunc(raw)) * 1_000_000n);
+    if (normalized.includes('second')) return String(BigInt(Math.trunc(raw)) * 1_000_000_000n);
+    if (isIntegerGreptimeDataType(dataType)) return String(BigInt(Math.trunc(raw)));
+    throw new Error(`Unsupported GreptimeDB data_type: ${dataType}`);
+}
+function parseJsonArray(value) {
+    if (Array.isArray(value)) return value;
+    if (typeof value === 'string') {
+        try {
+            const parsed = JSON.parse(value);
+            return Array.isArray(parsed) ? parsed : [];
+        } catch  {
+            return [];
+        }
+    }
+    return [];
+}
+function toAnyValue(value) {
+    return {
+        stringValue: typeof value === 'string' ? value : JSON.stringify(value)
+    };
+}
+function toKeyValue(key, value) {
+    return {
+        key,
+        value: toAnyValue(value)
+    };
+}
+function parseStatusCode(value) {
+    const normalized = String(value ?? '').trim().toUpperCase();
+    if (!normalized) return undefined;
+    if (normalized === 'STATUS_CODE_OK' || normalized === 'OK' || normalized === '1') {
+        return otlptracev1.StatusCodeOk;
+    }
+    if (normalized === 'STATUS_CODE_ERROR' || normalized === 'ERROR' || normalized === '2') {
+        return otlptracev1.StatusCodeError;
+    }
+    return otlptracev1.StatusCodeUnset;
+}
+function convertRowsToTrace(records) {
+    const columns = records?.schema?.column_schemas ?? [];
+    const rows = records?.rows ?? [];
+    if (!columns.length || !rows.length) return {
+        resourceSpans: []
+    };
+    const map = buildColumnIndexMap(columns);
+    const spanColumns = columns.filter((col)=>col.name.startsWith('span_attributes.'));
+    const resourceColumns = columns.filter((col)=>col.name.startsWith('resource_attributes.'));
+    const byService = new Map();
+    rows.forEach((row)=>{
+        const traceId = getString(getCell(row, map, [
+            'trace_id',
+            'traceid',
+            'traceId'
+        ]));
+        const spanId = getString(getCell(row, map, [
+            'span_id',
+            'spanid',
+            'spanId'
+        ]));
+        if (!traceId || !spanId) return;
+        const parentSpanId = getString(getCell(row, map, [
+            'parent_span_id',
+            'parentspanid',
+            'parentSpanId'
+        ]));
+        const name = getString(getCell(row, map, [
+            'span_name',
+            'name',
+            'operation_name'
+        ])) ?? '(unknown span)';
+        const kind = getString(getCell(row, map, [
+            'span_kind',
+            'kind'
+        ])) ?? 'SPAN_KIND_UNSPECIFIED';
+        const serviceName = getString(getCell(row, map, [
+            'service_name'
+        ])) ?? 'unknown';
+        const scopeName = getString(getCell(row, map, [
+            'scope_name'
+        ])) ?? '';
+        const scopeVersion = getString(getCell(row, map, [
+            'scope_version'
+        ])) ?? '';
+        const startIndex = map.timestamp ?? map.start_time ?? map.start_time_unix_nano;
+        const endIndex = map.timestamp_end ?? map.end_time ?? map.end_time_unix_nano;
+        const durationIndex = map.duration_nano ?? map.duration_ns;
+        const startTimeUnixNano = startIndex !== undefined ? toNanoString(row[startIndex], getColumnDataType(columns, startIndex)) ?? '0' : '0';
+        const endTimeUnixNano = (endIndex !== undefined ? toNanoString(row[endIndex], getColumnDataType(columns, endIndex)) ?? '0' : undefined) ?? (durationIndex !== undefined ? String(BigInt(startTimeUnixNano) + BigInt(toNanoString(row[durationIndex], getColumnDataType(columns, durationIndex)) ?? '0')) : startTimeUnixNano);
+        const spanAttributes = spanColumns.map((c)=>{
+            const idx = map[c.name.toLowerCase()];
+            if (idx === undefined) return undefined;
+            const value = row[idx];
+            if (value === undefined || value === null || value === '') return undefined;
+            return toKeyValue(c.name.replace(/^span_attributes\./, ''), value);
+        }).filter((v)=>v !== undefined);
+        // span_events / span_links: JSON columns (data_type Json). Only events need OTLP time parsing.
+        const spanEvents = parseJsonArray(getCell(row, map, [
+            'span_events'
+        ])).map((event)=>{
+            const e = event;
+            const eventTime = otlpEventTimeToNanoString(e.timeUnixNano ?? e.time_unix_nano) ?? startTimeUnixNano;
+            const eventName = getString(e.name) ?? 'event';
+            const attrs = e.attributes;
+            const attributes = attrs ? Object.entries(attrs).map(([k, v])=>toKeyValue(k, v)) : [];
+            return {
+                timeUnixNano: eventTime,
+                name: eventName,
+                attributes
+            };
+        });
+        const spanLinks = parseJsonArray(getCell(row, map, [
+            'span_links'
+        ])).map((link)=>{
+            const l = link;
+            const attrs = l.attributes;
+            const attributes = attrs ? Object.entries(attrs).map(([k, v])=>toKeyValue(k, v)) : [];
+            return {
+                traceId: getString(l.traceId ?? l.trace_id) ?? '',
+                spanId: getString(l.spanId ?? l.span_id) ?? '',
+                attributes
+            };
+        });
+        const statusMessage = getString(getCell(row, map, [
+            'span_status_message'
+        ])) ?? '';
+        const statusCode = parseStatusCode(getCell(row, map, [
+            'span_status_code',
+            'status_code'
+        ]));
+        const span = {
+            traceId,
+            spanId,
+            parentSpanId,
+            name,
+            kind,
+            startTimeUnixNano,
+            endTimeUnixNano,
+            attributes: spanAttributes,
+            events: spanEvents,
+            links: spanLinks,
+            status: {
+                message: statusMessage,
+                code: statusCode
+            }
+        };
+        if (!byService.has(serviceName)) {
+            const resourceAttrs = [
+                toKeyValue('service.name', serviceName)
+            ];
+            resourceColumns.forEach((c)=>{
+                const idx = map[c.name.toLowerCase()];
+                if (idx === undefined) return;
+                const value = row[idx];
+                if (value === undefined || value === null || value === '') return;
+                resourceAttrs.push(toKeyValue(c.name.replace(/^resource_attributes\./, ''), value));
+            });
+            byService.set(serviceName, {
+                resourceAttrs,
+                scopeSpans: new Map()
+            });
+        }
+        const serviceGroup = byService.get(serviceName);
+        const scopeKey = `${scopeName}|${scopeVersion}`;
+        if (!serviceGroup.scopeSpans.has(scopeKey)) {
+            serviceGroup.scopeSpans.set(scopeKey, {
+                scope: {
+                    name: scopeName,
+                    version: scopeVersion
+                },
+                spans: []
+            });
+        }
+        serviceGroup.scopeSpans.get(scopeKey).spans.push(span);
+    });
+    const resourceSpans = Array.from(byService.entries()).map(([_, value])=>({
+            resource: {
+                attributes: value.resourceAttrs
+            },
+            scopeSpans: Array.from(value.scopeSpans.values())
+        }));
+    return {
+        resourceSpans
+    };
+}
+
+//# sourceMappingURL=get-greptimedb-trace-data.js.map