@walkthru-earth/objex 1.3.1 → 1.5.0

package/dist/utils/evidence-context.d.ts

@@ -1,22 +0,0 @@
-import type { QueryResult } from '../query/engine';
-export declare class EvidenceContext {
-    private connId;
-    private prefix;
-    private results;
-    constructor(connId: string, prefix?: string);
-    /**
-     * Execute a SQL query and store the result under the given name.
-     */
-    executeSql(sql: string, queryName: string): Promise<Record<string, any>[]>;
-    /**
-     * Transform relative file paths in SQL to full S3 URLs.
-     * e.g., read_parquet('data.parquet') → read_parquet('s3://bucket/prefix/data.parquet')
-     */
-    private transformPaths;
-    getResult(queryName: string): {
-        result: QueryResult;
-        rows: Record<string, any>[];
-    } | undefined;
-    getAllResults(): Map<string, Record<string, any>[]>;
-    getColumns(queryName: string): string[];
-}

package/dist/utils/evidence-context.js

@@ -1,56 +0,0 @@
-import { getQueryEngine } from '../query/index.js';
-export class EvidenceContext {
-    connId;
-    prefix;
-    results = new Map();
-    constructor(connId, prefix = '') {
-        this.connId = connId;
-        this.prefix = prefix;
-    }
-    /**
-     * Execute a SQL query and store the result under the given name.
-     */
-    async executeSql(sql, queryName) {
-        const engine = await getQueryEngine();
-        // Transform relative file paths to full paths
-        const transformedSql = this.transformPaths(sql);
-        const result = await engine.query(this.connId, transformedSql);
-        const rows = result.rows ?? [];
-        this.results.set(queryName, { result, rows });
-        return rows;
-    }
-    /**
-     * Transform relative file paths in SQL to full S3 URLs.
-     * e.g., read_parquet('data.parquet') → read_parquet('s3://bucket/prefix/data.parquet')
-     */
-    transformPaths(sql) {
-        if (!this.connId || !this.prefix)
-            return sql;
-        // Match read_parquet('path'), read_csv('path'), read_json('path')
-        return sql.replace(/(read_(?:parquet|csv|json|csv_auto))\('([^']+)'\)/g, (match, fn, path) => {
-            // Skip absolute paths and URLs
-            if (path.startsWith('s3://') || path.startsWith('http') || path.startsWith('/')) {
-                return match;
-            }
-            // Resolve relative path
-            const fullPath = `s3://${this.prefix}/${path}`;
-            return `${fn}('${fullPath}')`;
-        });
-    }
-    getResult(queryName) {
-        return this.results.get(queryName);
-    }
-    getAllResults() {
-        const map = new Map();
-        for (const [name, { rows }] of this.results) {
-            map.set(name, rows);
-        }
-        return map;
-    }
-    getColumns(queryName) {
-        const entry = this.results.get(queryName);
-        if (!entry)
-            return [];
-        return entry.result.columns;
-    }
-}

package/dist/utils/export.d.ts

@@ -1,22 +0,0 @@
-/**
- * Escape a CSV field value per RFC 4180.
- */
-export declare function escapeCsvField(value: string): string;
-/**
- * Serialize column/row data to a CSV string.
- * Pure function — no browser APIs, works in Node.js.
- */
-export declare function serializeToCsv(columns: string[], rows: Record<string, unknown>[]): string;
-/**
- * Serialize column/row data to a formatted JSON string.
- * Pure function — no browser APIs, works in Node.js.
- */
-export declare function serializeToJson(columns: string[], rows: Record<string, unknown>[]): string;
-/**
- * Export data as CSV file (triggers browser download).
- */
-export declare function exportToCsv(columns: string[], rows: Record<string, unknown>[], filename: string): void;
-/**
- * Export data as JSON file (triggers browser download).
- */
-export declare function exportToJson(columns: string[], rows: Record<string, unknown>[], filename: string): void;

package/dist/utils/export.js

@@ -1,76 +0,0 @@
-import { jsonReplacerBigInt } from './format.js';
-function triggerDownload(content, filename, mimeType) {
-    const blob = new Blob([content], { type: mimeType });
-    const url = URL.createObjectURL(blob);
-    const a = document.createElement('a');
-    a.href = url;
-    a.download = filename;
-    document.body.appendChild(a);
-    a.click();
-    document.body.removeChild(a);
-    URL.revokeObjectURL(url);
-}
-/** Format a cell value for export (empty string for null/undefined). */
-function formatCellValue(value) {
-    if (value === null || value === undefined)
-        return '';
-    if (value instanceof Date)
-        return value.toISOString();
-    if (typeof value === 'bigint')
-        return value.toString();
-    if (typeof value === 'object')
-        return JSON.stringify(value, jsonReplacerBigInt);
-    return String(value);
-}
-/**
- * Escape a CSV field value per RFC 4180.
- */
-export function escapeCsvField(value) {
-    if (value.includes(',') || value.includes('"') || value.includes('\n') || value.includes('\r')) {
-        return `"${value.replace(/"/g, '""')}"`;
-    }
-    return value;
-}
-/**
- * Serialize column/row data to a CSV string.
- * Pure function — no browser APIs, works in Node.js.
- */
-export function serializeToCsv(columns, rows) {
-    const header = columns.map(escapeCsvField).join(',');
-    const body = rows
-        .map((row) => columns.map((col) => escapeCsvField(formatCellValue(row[col]))).join(','))
-        .join('\n');
-    return `${header}\n${body}`;
-}
-/**
- * Serialize column/row data to a formatted JSON string.
- * Pure function — no browser APIs, works in Node.js.
- */
-export function serializeToJson(columns, rows) {
-    const data = rows.map((row) => {
-        const obj = {};
-        for (const col of columns) {
-            const val = row[col];
-            if (val instanceof Date) {
-                obj[col] = val.toISOString();
-            }
-            else {
-                obj[col] = val ?? null;
-            }
-        }
-        return obj;
-    });
-    return JSON.stringify(data, jsonReplacerBigInt, 2);
-}
-/**
- * Export data as CSV file (triggers browser download).
- */
-export function exportToCsv(columns, rows, filename) {
-    triggerDownload(serializeToCsv(columns, rows), filename.endsWith('.csv') ? filename : `${filename}.csv`, 'text/csv;charset=utf-8;');
-}
-/**
- * Export data as JSON file (triggers browser download).
- */
-export function exportToJson(columns, rows, filename) {
-    triggerDownload(serializeToJson(columns, rows), filename.endsWith('.json') ? filename : `${filename}.json`, 'application/json');
-}

package/dist/utils/file-sort.d.ts

@@ -1,20 +0,0 @@
-/**
- * Pure file entry sorting — framework-agnostic, works in Node.js.
- */
-import type { FileEntry } from '../types.js';
-export type SortField = 'name' | 'size' | 'modified' | 'extension';
-export type SortDirection = 'asc' | 'desc';
-export interface SortConfig {
-    field: SortField;
-    direction: SortDirection;
-}
-/**
- * Sort file entries by the given config.
- * Directories always sort before files regardless of sort field.
- * Returns a new array (does not mutate the input).
- */
-export declare function sortFileEntries(entries: FileEntry[], config: SortConfig): FileEntry[];
-/**
- * Toggle sort config: same field flips direction, new field starts ascending.
- */
-export declare function toggleSortField(current: SortConfig, field: SortField): SortConfig;

package/dist/utils/file-sort.js

@@ -1,41 +0,0 @@
-/**
- * Pure file entry sorting — framework-agnostic, works in Node.js.
- */
-/**
- * Sort file entries by the given config.
- * Directories always sort before files regardless of sort field.
- * Returns a new array (does not mutate the input).
- */
-export function sortFileEntries(entries, config) {
-    const sorted = [...entries];
-    const dir = config.direction === 'asc' ? 1 : -1;
-    sorted.sort((a, b) => {
-        // Directories always come first
-        if (a.is_dir && !b.is_dir)
-            return -1;
-        if (!a.is_dir && b.is_dir)
-            return 1;
-        switch (config.field) {
-            case 'name':
-                return dir * a.name.localeCompare(b.name, undefined, { sensitivity: 'base' });
-            case 'size':
-                return dir * (a.size - b.size);
-            case 'modified':
-                return dir * (a.modified - b.modified);
-            case 'extension':
-                return dir * a.extension.localeCompare(b.extension, undefined, { sensitivity: 'base' });
-            default:
-                return 0;
-        }
-    });
-    return sorted;
-}
-/**
- * Toggle sort config: same field flips direction, new field starts ascending.
- */
-export function toggleSortField(current, field) {
-    if (current.field === field) {
-        return { field, direction: current.direction === 'asc' ? 'desc' : 'asc' };
-    }
-    return { field, direction: 'asc' };
-}

package/dist/utils/format.d.ts

@@ -1,24 +0,0 @@
-/**
- * Formats a byte count into a human-readable string.
- */
-export declare function formatFileSize(bytes: number): string;
-/**
- * Formats a unix timestamp (milliseconds) to a human-readable date string.
- * Shows relative time for recent dates, absolute for older ones.
- */
-export declare function formatDate(timestamp: number): string;
-/**
- * Extracts the file extension from a filename, including the leading dot.
- * Returns an empty string if no extension is found.
- */
-export declare function getFileExtension(filename: string): string;
-/**
- * JSON replacer that converts BigInt values to strings.
- * Use with `JSON.stringify(value, jsonReplacerBigInt)`.
- */
-export declare function jsonReplacerBigInt(_key: string, value: unknown): unknown;
-/**
- * Format a value for display in tables, attribute panels, and exports.
- * Handles null, undefined, Date, BigInt, and objects uniformly.
- */
-export declare function formatValue(value: unknown): string;

package/dist/utils/format.js

@@ -1,78 +0,0 @@
-/**
- * Formats a byte count into a human-readable string.
- */
-export function formatFileSize(bytes) {
-    if (bytes < 0)
-        return '0 B';
-    if (bytes === 0)
-        return '0 B';
-    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
-    const base = 1024;
-    const exponent = Math.min(Math.floor(Math.log(bytes) / Math.log(base)), units.length - 1);
-    const value = bytes / base ** exponent;
-    // Use integer display for bytes, one decimal for everything else
-    if (exponent === 0)
-        return `${bytes} B`;
-    return `${value.toFixed(1)} ${units[exponent]}`;
-}
-/**
- * Formats a unix timestamp (milliseconds) to a human-readable date string.
- * Shows relative time for recent dates, absolute for older ones.
- */
-export function formatDate(timestamp) {
-    if (!timestamp || timestamp <= 0 || !Number.isFinite(timestamp))
-        return '--';
-    const date = new Date(timestamp);
-    const now = Date.now();
-    const diffMs = now - timestamp;
-    const diffSeconds = Math.floor(diffMs / 1000);
-    const diffMinutes = Math.floor(diffSeconds / 60);
-    const diffHours = Math.floor(diffMinutes / 60);
-    const diffDays = Math.floor(diffHours / 24);
-    if (diffSeconds < 60)
-        return 'Just now';
-    if (diffMinutes < 60)
-        return `${diffMinutes}m ago`;
-    if (diffHours < 24)
-        return `${diffHours}h ago`;
-    if (diffDays < 7)
-        return `${diffDays}d ago`;
-    // For older dates, show absolute date
-    return date.toLocaleDateString(undefined, {
-        year: 'numeric',
-        month: 'short',
-        day: 'numeric'
-    });
-}
-/**
- * Extracts the file extension from a filename, including the leading dot.
- * Returns an empty string if no extension is found.
- */
-export function getFileExtension(filename) {
-    const lastDot = filename.lastIndexOf('.');
-    if (lastDot <= 0)
-        return '';
-    return filename.slice(lastDot).toLowerCase();
-}
-/**
- * JSON replacer that converts BigInt values to strings.
- * Use with `JSON.stringify(value, jsonReplacerBigInt)`.
- */
-export function jsonReplacerBigInt(_key, value) {
-    return typeof value === 'bigint' ? value.toString() : value;
-}
-/**
- * Format a value for display in tables, attribute panels, and exports.
- * Handles null, undefined, Date, BigInt, and objects uniformly.
- */
-export function formatValue(value) {
-    if (value === null || value === undefined)
-        return 'NULL';
-    if (value instanceof Date)
-        return value.toISOString();
-    if (typeof value === 'bigint')
-        return value.toString();
-    if (typeof value === 'object')
-        return JSON.stringify(value, jsonReplacerBigInt);
-    return String(value);
-}

package/dist/utils/geoarrow.d.ts

@@ -1,32 +0,0 @@
-/**
- * Direct WKB → GeoArrow bridge (zero-copy).
- *
- * Reads raw WKB binary directly into pre-allocated Arrow typed arrays
- * without any intermediate JS object allocation. No parseWKB(), no GeoJSON.
- *
- * Data flow: WKB Uint8Array[] → DataView binary reads → Float64Array/Int32Array
- *            → arrow.makeData() → arrow.Table with ARROW:extension:name metadata
- */
-import { Table } from 'apache-arrow';
-export type GeoArrowGeomType = 'point' | 'linestring' | 'polygon' | 'multipoint' | 'multilinestring' | 'multipolygon';
-export interface GeoArrowResult {
-    table: Table;
-    geometryType: GeoArrowGeomType;
-    bounds: [number, number, number, number];
-    /** Maps local table row index → original WKB array index (for selection lookup). */
-    sourceIndices: number[];
-}
-/** Map DuckDB ST_GeometryType output to our normalized type. */
-export declare function normalizeGeomType(raw: string): GeoArrowGeomType;
-/**
- * Build GeoArrow tables from raw WKB arrays, automatically splitting by geometry type.
- * Returns one GeoArrowResult per non-empty type group, with shared merged bounds.
- *
- * @param wkbArrays Raw WKB binary arrays from DuckDB
- * @param attributes Attribute columns (non-geometry)
- * @param knownGeomType If provided (e.g. from GeoParquet metadata), skip classification
- */
-export declare function buildGeoArrowTables(wkbArrays: Uint8Array[], attributes: Map<string, {
-    values: any[];
-    type: string;
-}>, knownGeomType?: GeoArrowGeomType): GeoArrowResult[];