@panoboard/core 1.1.5

package/dist/connectors/snowflake.js

@@ -0,0 +1,181 @@
+// Copyright 2026 Mataki Labs LLC
+//
+// Licensed under the Business Source License 1.1 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://github.com/panoboard/panoboard/blob/main/LICENSE
+//
+// 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 snowflake from "snowflake-sdk";
+import fs from "fs";
+import crypto from "crypto";
+import { normalizeParams } from "./params";
+export function mapSnowflakeType(sfType) {
+    switch (sfType.toUpperCase()) {
+        case "VARCHAR":
+        case "CHAR":
+        case "STRING":
+        case "TEXT":
+            return "string";
+        case "NUMBER":
+        case "DECIMAL":
+        case "NUMERIC":
+        case "INT":
+        case "INTEGER":
+        case "BIGINT":
+        case "SMALLINT":
+        case "TINYINT":
+        case "BYTEINT":
+        case "FLOAT":
+        case "FLOAT4":
+        case "FLOAT8":
+        case "DOUBLE":
+        case "DOUBLE PRECISION":
+        case "REAL":
+            return "number";
+        case "BOOLEAN":
+            return "boolean";
+        case "DATE":
+        case "DATETIME":
+        case "TIME":
+        case "TIMESTAMP":
+        case "TIMESTAMP_LTZ":
+        case "TIMESTAMP_NTZ":
+        case "TIMESTAMP_TZ":
+            return "date";
+        default:
+            return "string";
+    }
+}
+/**
+ * Reads a PEM key and exports it as unencrypted PKCS8.
+ * Snowflake SDK requires decrypted keys — the `privateKeyPass` option
+ * is unreliable (see snowflake-connector-nodejs#855).
+ */
+function loadPrivateKey(auth) {
+    let pem;
+    try {
+        pem = auth.private_key_file
+            ? fs.readFileSync(auth.private_key_file, "utf-8")
+            : auth.private_key;
+    }
+    catch (err) {
+        throw new Error(`Private key file not found: ${auth.private_key_file}: ${err.message}`);
+    }
+    const keyObj = crypto.createPrivateKey({
+        key: pem,
+        format: "pem",
+        ...(auth.passphrase ? { passphrase: auth.passphrase } : {}),
+    });
+    return keyObj.export({ format: "pem", type: "pkcs8" });
+}
+export class SnowflakeConnector {
+    id;
+    type = "snowflake";
+    connection;
+    connected = false;
+    constructor(config) {
+        this.id = config.id;
+        const baseOpts = {
+            account: config.account,
+            warehouse: config.warehouse,
+            database: config.database,
+            schema: config.schema,
+            role: config.role,
+        };
+        if (config.auth.type === "password") {
+            this.connection = snowflake.createConnection({
+                ...baseOpts,
+                username: config.auth.user,
+                password: config.auth.password,
+            });
+        }
+        else {
+            const privateKey = loadPrivateKey(config.auth);
+            this.connection = snowflake.createConnection({
+                ...baseOpts,
+                username: config.auth.user,
+                authenticator: "SNOWFLAKE_JWT",
+                privateKey,
+            });
+        }
+    }
+    async ensureConnected() {
+        if (this.connected)
+            return;
+        return new Promise((resolve, reject) => {
+            this.connection.connect((err) => {
+                if (err)
+                    reject(new Error(`Failed to connect to Snowflake: ${err.message}`));
+                else {
+                    this.connected = true;
+                    resolve();
+                }
+            });
+        });
+    }
+    async query(request, options) {
+        if (request.type !== "sql") {
+            throw new Error("[SnowflakeConnector] only supports SQL queries");
+        }
+        const start = Date.now();
+        await this.ensureConnected();
+        const params = request.params ?? options?.params ?? {};
+        const { normalizedSql, values } = normalizeParams(request.sql, params, "positional");
+        return new Promise((resolve, reject) => {
+            this.connection.execute({
+                sqlText: normalizedSql,
+                binds: values,
+                complete(err, stmt, rows) {
+                    if (err) {
+                        reject(new Error(`Snowflake query error: ${err.message}`));
+                        return;
+                    }
+                    const resultRows = (rows ?? []);
+                    const colMeta = (stmt.getColumns() ?? []).map((col) => ({
+                        name: col.getName(),
+                        type: mapSnowflakeType(col.getType()),
+                        nullable: true,
+                    }));
+                    resolve({
+                        columns: colMeta,
+                        rows: resultRows,
+                        rowCount: resultRows.length,
+                        durationMs: Date.now() - start,
+                        fromCache: false,
+                    });
+                },
+            });
+        });
+    }
+    async testConnection() {
+        const start = Date.now();
+        try {
+            await this.query({ type: "sql", sql: "SELECT 1" });
+            return { ok: true, latencyMs: Date.now() - start };
+        }
+        catch (error) {
+            return {
+                ok: false,
+                latencyMs: Date.now() - start,
+                error: error.message,
+            };
+        }
+    }
+    async close() {
+        return new Promise((resolve, reject) => {
+            this.connection.destroy((err) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            });
+        });
+    }
+}
+//# sourceMappingURL=snowflake.js.map

package/dist/connectors/snowflake.js.map

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

package/dist/connectors/types.d.ts

@@ -0,0 +1,41 @@
+export type DatasourceType = "postgres" | "bigquery" | "redshift" | "redshift-data" | "url" | "snowflake";
+export type QueryRequest = {
+    type: "sql";
+    sql: string;
+    params?: Record<string, unknown>;
+} | {
+    type: "http";
+    path: string;
+    params?: Record<string, unknown>;
+};
+export interface ColumnMeta {
+    name: string;
+    type: "string" | "number" | "boolean" | "date" | "null";
+    nullable: boolean;
+}
+export interface QueryResult {
+    columns: ColumnMeta[];
+    rows: Record<string, unknown>[];
+    rowCount: number;
+    durationMs: number;
+    fromCache: boolean;
+}
+export interface QueryOptions {
+    params?: Record<string, unknown>;
+    timeoutMs?: number;
+    /** Panel-level column definitions, used by URL connector for schema-less formats */
+    panelColumns?: ColumnMeta[];
+}
+export interface ConnectionTestResult {
+    ok: boolean;
+    latencyMs: number;
+    error?: string;
+}
+export interface Connector {
+    readonly id: string;
+    readonly type: DatasourceType;
+    query(request: QueryRequest, options?: QueryOptions): Promise<QueryResult>;
+    testConnection(): Promise<ConnectionTestResult>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/connectors/types.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,UAAU,GACV,UAAU,GACV,eAAe,GACf,KAAK,GACL,WAAW,CAAC;AAEhB,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC;AAErE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IACxD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3E,cAAc,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAChD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/connectors/types.js

@@ -0,0 +1,15 @@
+// Copyright 2026 Mataki Labs LLC
+//
+// Licensed under the Business Source License 1.1 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://github.com/panoboard/panoboard/blob/main/LICENSE
+//
+// 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.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/connectors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/connectors/types.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,+DAA+D;AAC/D,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC"}

package/dist/connectors/url-parsers.d.ts

@@ -0,0 +1,13 @@
+import type { ColumnMeta } from "./types";
+interface ParsedResponse {
+    columns: ColumnMeta[];
+    rows: Record<string, unknown>[];
+    rowCount: number;
+}
+export declare function parsePanoboard(body: unknown): ParsedResponse;
+export declare function parseArray(body: unknown, panelColumns: ColumnMeta[]): ParsedResponse;
+export declare function parseGrafana(body: unknown): ParsedResponse;
+export declare function parseDatasette(body: unknown, panelColumns?: ColumnMeta[]): ParsedResponse;
+export declare function parseJsonl(body: string, panelColumns: ColumnMeta[]): ParsedResponse;
+export {};
+//# sourceMappingURL=url-parsers.d.ts.map

package/dist/connectors/url-parsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-parsers.d.ts","sourceRoot":"","sources":["../../src/connectors/url-parsers.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,UAAU,cAAc;IACtB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAuBD,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAoB5D;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,OAAO,EACb,YAAY,EAAE,UAAU,EAAE,GACzB,cAAc,CAShB;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAc1D;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,OAAO,EACb,YAAY,CAAC,EAAE,UAAU,EAAE,GAC1B,cAAc,CAchB;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,UAAU,EAAE,GACzB,cAAc,CAUhB"}

package/dist/connectors/url-parsers.js

@@ -0,0 +1,95 @@
+// Copyright 2026 Mataki Labs LLC
+//
+// Licensed under the Business Source License 1.1 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://github.com/panoboard/panoboard/blob/main/LICENSE
+//
+// 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.
+/** Map user-facing column types to ColumnMeta types */
+function mapColumnType(type) {
+    if (type === "integer")
+        return "number";
+    if (["string", "number", "boolean", "date", "null"].includes(type)) {
+        return type;
+    }
+    return "string";
+}
+function toColumnMeta(name, type, nullable) {
+    return {
+        name,
+        type: mapColumnType(type ?? "string"),
+        nullable: nullable ?? true,
+    };
+}
+export function parsePanoboard(body) {
+    const b = body;
+    if (!b.columns || !Array.isArray(b.columns)) {
+        throw new Error("Missing or invalid 'columns' in panoboard response");
+    }
+    if (!Array.isArray(b.rows)) {
+        throw new Error("Missing or invalid 'rows' in panoboard response");
+    }
+    const columns = b.columns.map((c) => toColumnMeta(c.name, c.type));
+    return {
+        columns,
+        rows: b.rows,
+        rowCount: b.row_count ?? b.rows.length,
+    };
+}
+export function parseArray(body, panelColumns) {
+    if (!Array.isArray(body)) {
+        throw new Error("Expected array response, got " + typeof body);
+    }
+    return {
+        columns: panelColumns,
+        rows: body,
+        rowCount: body.length,
+    };
+}
+export function parseGrafana(body) {
+    const b = body;
+    const columns = b.columns.map((c) => toColumnMeta(c.text, c.type));
+    const rows = b.rows.map((row) => {
+        const obj = {};
+        b.columns.forEach((col, i) => {
+            obj[col.text] = row[i];
+        });
+        return obj;
+    });
+    return { columns, rows, rowCount: rows.length };
+}
+export function parseDatasette(body, panelColumns) {
+    const b = body;
+    const columns = b.columns.map((name, i) => {
+        if (panelColumns && panelColumns[i])
+            return panelColumns[i];
+        return toColumnMeta(name);
+    });
+    const rows = b.rows.map((row) => {
+        const obj = {};
+        b.columns.forEach((name, i) => {
+            obj[name] = row[i];
+        });
+        return obj;
+    });
+    return { columns, rows, rowCount: rows.length };
+}
+export function parseJsonl(body, panelColumns) {
+    const lines = body.split("\n").filter((line) => line.trim().length > 0);
+    const rows = lines.map((line, i) => {
+        try {
+            return JSON.parse(line);
+        }
+        catch {
+            throw new Error(`Invalid JSON on line ${i + 1}: ${line.slice(0, 100)}`);
+        }
+    });
+    return { columns: panelColumns, rows, rowCount: rows.length };
+}
+//# sourceMappingURL=url-parsers.js.map

package/dist/connectors/url-parsers.js.map

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

package/dist/connectors/url.d.ts

@@ -0,0 +1,36 @@
+import type { Connector, QueryRequest, QueryOptions, QueryResult, ConnectionTestResult } from "./types";
+type UrlAuthConfig = {
+    type: "bearer";
+    token: string;
+} | {
+    type: "basic";
+    user: string;
+    password: string;
+} | {
+    type: "header";
+    headers: Record<string, string>;
+};
+type ResponseFormat = "panoboard" | "array" | "grafana" | "datasette" | "jsonl";
+export interface UrlConnectorConfig {
+    id: string;
+    base_url: string;
+    method: "get" | "post";
+    request_body?: string;
+    response_format: ResponseFormat;
+    timeout: number;
+    health_check_path?: string;
+    auth?: UrlAuthConfig;
+}
+export declare class UrlConnector implements Connector {
+    readonly id: string;
+    readonly type: "url";
+    private config;
+    constructor(config: UrlConnectorConfig);
+    query(request: QueryRequest, options?: QueryOptions): Promise<QueryResult>;
+    testConnection(): Promise<ConnectionTestResult>;
+    close(): Promise<void>;
+    private buildAuthHeaders;
+    private parseResponse;
+}
+export {};
+//# sourceMappingURL=url.d.ts.map

package/dist/connectors/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/connectors/url.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,oBAAoB,EAErB,MAAM,SAAS,CAAC;AASjB,KAAK,aAAa,GACd;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAExD,KAAK,cAAc,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;AAEhF,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,cAAc,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB;AAED,qBAAa,YAAa,YAAW,SAAS;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAU;IAC/B,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,EAAE,kBAAkB;IAKhC,KAAK,CACT,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,WAAW,CAAC;IAkEjB,cAAc,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAgC/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAE5B,OAAO,CAAC,gBAAgB;YAaV,aAAa;CA8B5B"}

package/dist/connectors/url.js

@@ -0,0 +1,139 @@
+// Copyright 2026 Mataki Labs LLC
+//
+// Licensed under the Business Source License 1.1 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://github.com/panoboard/panoboard/blob/main/LICENSE
+//
+// 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 { parsePanoboard, parseArray, parseGrafana, parseDatasette, parseJsonl, } from "./url-parsers";
+export class UrlConnector {
+    id;
+    type = "url";
+    config;
+    constructor(config) {
+        this.id = config.id;
+        this.config = config;
+    }
+    async query(request, options) {
+        if (request.type !== "http") {
+            throw new Error("UrlConnector only supports HTTP queries");
+        }
+        const start = Date.now();
+        const url = new URL(this.config.base_url + request.path);
+        if (request.params) {
+            for (const [key, value] of Object.entries(request.params)) {
+                if (value !== null && value !== undefined) {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        const headers = {};
+        if (this.config.auth) {
+            Object.assign(headers, this.buildAuthHeaders(this.config.auth));
+        }
+        const fetchOptions = {
+            method: this.config.method.toUpperCase(),
+            headers,
+            signal: AbortSignal.timeout(this.config.timeout),
+        };
+        if (this.config.method === "post") {
+            headers["Content-Type"] = "application/json";
+            fetchOptions.body = this.config.request_body ?? "{}";
+        }
+        const response = await fetch(url, fetchOptions).catch((err) => {
+            if (err.name === "TimeoutError") {
+                throw new Error(`Request to ${this.config.base_url}${request.path} timed out after ${this.config.timeout}ms`);
+            }
+            throw new Error(`Failed to connect to ${this.config.base_url}: ${err.message}`);
+        });
+        if (!response.ok) {
+            let errorMsg;
+            try {
+                const errorBody = (await response.json());
+                errorMsg = errorBody.error
+                    ? `Upstream error: ${errorBody.error}`
+                    : `Upstream returned HTTP ${response.status}`;
+            }
+            catch {
+                errorMsg = `Upstream returned HTTP ${response.status}`;
+            }
+            throw new Error(errorMsg);
+        }
+        const panelColumns = options?.panelColumns;
+        const parsed = await this.parseResponse(response, panelColumns);
+        return {
+            ...parsed,
+            durationMs: Date.now() - start,
+            fromCache: false,
+        };
+    }
+    async testConnection() {
+        const start = Date.now();
+        const path = this.config.health_check_path ?? "";
+        const url = `${this.config.base_url}${path}`;
+        try {
+            const response = await fetch(url, {
+                method: "GET",
+                signal: AbortSignal.timeout(this.config.timeout),
+                headers: this.config.auth
+                    ? this.buildAuthHeaders(this.config.auth)
+                    : {},
+            });
+            if (response.status >= 500) {
+                return {
+                    ok: false,
+                    latencyMs: Date.now() - start,
+                    error: `Upstream returned HTTP ${response.status}`,
+                };
+            }
+            return { ok: true, latencyMs: Date.now() - start };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                latencyMs: Date.now() - start,
+                error: `Failed to connect to ${this.config.base_url}: ${err.message}`,
+            };
+        }
+    }
+    async close() { }
+    buildAuthHeaders(auth) {
+        switch (auth.type) {
+            case "bearer":
+                return { Authorization: `Bearer ${auth.token}` };
+            case "basic":
+                return {
+                    Authorization: `Basic ${btoa(`${auth.user}:${auth.password}`)}`,
+                };
+            case "header":
+                return { ...auth.headers };
+        }
+    }
+    async parseResponse(response, panelColumns) {
+        const format = this.config.response_format;
+        if (format === "jsonl") {
+            const text = await response.text();
+            return parseJsonl(text, panelColumns);
+        }
+        const json = await response.json();
+        switch (format) {
+            case "panoboard":
+                return parsePanoboard(json);
+            case "array":
+                return parseArray(json, panelColumns);
+            case "grafana":
+                return parseGrafana(json);
+            case "datasette":
+                return parseDatasette(json, panelColumns);
+            default:
+                throw new Error(`Unsupported response format: ${format}`);
+        }
+    }
+}
+//# sourceMappingURL=url.js.map

package/dist/connectors/url.js.map

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

package/dist/filters/cascade.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Resolves cascading (parent→child) filter params.
+ *
+ * If `filter` has a `depends_on` field, extracts the parent filter's current
+ * value from `searchParams` and returns it as a named param record so it can
+ * be forwarded into the child filter's `options_query` execution.
+ *
+ * Returns an empty object when there is no dependency or no parent value.
+ */
+export declare function resolveCascadingParams(searchParams: URLSearchParams, filter: {
+    depends_on?: string;
+}): Record<string, string>;
+//# sourceMappingURL=cascade.d.ts.map

package/dist/filters/cascade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade.d.ts","sourceRoot":"","sources":["../../src/filters/cascade.ts"],"names":[],"mappings":"AAcA;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,eAAe,EAC7B,MAAM,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxB"}

package/dist/filters/cascade.js

@@ -0,0 +1,32 @@
+// Copyright 2026 Mataki Labs LLC
+//
+// Licensed under the Business Source License 1.1 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://github.com/panoboard/panoboard/blob/main/LICENSE
+//
+// 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.
+/**
+ * Resolves cascading (parent→child) filter params.
+ *
+ * If `filter` has a `depends_on` field, extracts the parent filter's current
+ * value from `searchParams` and returns it as a named param record so it can
+ * be forwarded into the child filter's `options_query` execution.
+ *
+ * Returns an empty object when there is no dependency or no parent value.
+ */
+export function resolveCascadingParams(searchParams, filter) {
+    const parentId = filter.depends_on;
+    if (!parentId)
+        return {};
+    const parentValue = searchParams.get(parentId);
+    if (parentValue === null)
+        return {};
+    return { [parentId]: parentValue };
+}
+//# sourceMappingURL=cascade.js.map

package/dist/filters/cascade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade.js","sourceRoot":"","sources":["../../src/filters/cascade.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,+DAA+D;AAC/D,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CACpC,YAA6B,EAC7B,MAA+B;IAE/B,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC;IACnC,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IAEzB,MAAM,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAEpC,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;AACrC,CAAC"}

package/dist/filters/daterange.d.ts

@@ -0,0 +1,8 @@
+export interface DateRange {
+    start: string;
+    end: string;
+    priorStart: string;
+    priorEnd: string;
+}
+export declare function resolveDateRange(preset: string, timezone?: string, referenceDate?: Date): DateRange;
+//# sourceMappingURL=daterange.d.ts.map

package/dist/filters/daterange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daterange.d.ts","sourceRoot":"","sources":["../../src/filters/daterange.ts"],"names":[],"mappings":"AAkCA,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAAc,EACxB,aAAa,CAAC,EAAE,IAAI,GACnB,SAAS,CA2GX"}