@walkthru-earth/objex-utils 1.1.0 → 1.2.1

package/dist/index.d.cts

@@ -11,8 +11,12 @@ declare const STORAGE_KEYS: {
 };
 /** EPSG codes considered WGS84 (no reprojection needed). */
 declare const WGS84_CODES: Set<number>;
-/** Default target CRS for ST_Transform. */
-declare const DEFAULT_TARGET_CRS = "EPSG:4326";
+/**
+ * Default target CRS for ST_Transform. Uses OGC:CRS84 (longitude, latitude)
+ * to match GeoParquet 1.1+ spec and DuckDB v1.5's canonical form.
+ * Functionally equivalent to EPSG:4326 under `geometry_always_xy = true`.
+ */
+declare const DEFAULT_TARGET_CRS = "OGC:CRS84";
 /** DuckDB-WASM initialization timeout in ms. */
 declare const DUCKDB_INIT_TIMEOUT_MS = 30000;
 /** Maximum entries kept in query history. */
@@ -119,15 +123,27 @@ interface SchemaField {
     type: string;
     nullable: boolean;
 }
+/**
+ * Abstraction over a DuckDB query source. Decouples schema / CRS / count
+ * helpers from assuming a file-backed path. `ref` is the FROM-clause target
+ * inserted into generated SQL (e.g. `read_parquet('url')` for files, or
+ * `attached_db."schema"."table"` for attached databases). `filePath` is
+ * optional and only used as a shortcut for Parquet file-level metadata
+ * queries (`parquet_kv_metadata`, `parquet_file_metadata`), not for SQL.
+ */
+interface QuerySource {
+    ref: string;
+    filePath?: string;
+}
 interface QueryEngine {
     query(connId: string, sql: string): Promise<QueryResult>;
     queryForMap(connId: string, sql: string, geomCol: string, geomColType: string, sourceCrs?: string | null): Promise<MapQueryResult>;
-    getSchema(connId: string, path: string): Promise<SchemaField[]>;
-    getRowCount(connId: string, path: string): Promise<number>;
+    getSchema(connId: string, source: QuerySource): Promise<SchemaField[]>;
+    getRowCount(connId: string, source: QuerySource): Promise<number>;
     /** Detect CRS from GeoParquet metadata. Returns e.g. 'EPSG:27700' or null if WGS84/unknown. */
-    detectCrs(connId: string, path: string, geomCol: string): Promise<string | null>;
+    detectCrs(connId: string, source: QuerySource, geomCol: string): Promise<string | null>;
     /** Combined schema + CRS detection in a single connection (fewer web worker round-trips). */
-    getSchemaAndCrs?(connId: string, path: string, findGeoCol: (schema: SchemaField[]) => string | null): Promise<{
+    getSchemaAndCrs?(connId: string, source: QuerySource, findGeoCol: (schema: SchemaField[]) => string | null): Promise<{
         schema: SchemaField[];
         geomCol: string | null;
         crs: string | null;
@@ -135,6 +151,10 @@ interface QueryEngine {
     queryCancellable?(connId: string, sql: string): QueryHandle;
     queryForMapCancellable?(connId: string, sql: string, geomCol: string, geomColType: string, sourceCrs?: string | null): MapQueryHandle;
     forceCancel?(): Promise<void>;
+    /** Register a file buffer in DuckDB-WASM's virtual filesystem for ATTACH. */
+    registerFileBuffer?(name: string, buffer: Uint8Array): Promise<void>;
+    /** Drop a previously registered file from DuckDB-WASM's virtual filesystem. */
+    dropFile?(name: string): Promise<void>;
     releaseMemory(): Promise<void>;
     dispose(): Promise<void>;
 }
@@ -179,6 +199,17 @@ interface Tab {
     connectionId?: string;
     extension: string;
     size?: number;
+    /**
+     * When set, the tab reads data from a SQL FROM-clause target (e.g. an
+     * attached DuckLake/DuckDB/SQLite table) rather than a file URL. The ref
+     * is inserted directly into generated SQL, so it must be fully-qualified
+     * and pre-quoted, e.g. `__objex_db__."main"."air_quality"`.
+     *
+     * When `sourceRef` is set, file-specific loading paths (hyparquet
+     * metadata, `parquet_kv_metadata`, etc.) are skipped, and schema / CRS /
+     * row count are derived from the SQL source directly via DuckDB.
+     */
+    sourceRef?: string;
 }
 interface WriteResult {
     key: string;
@@ -254,6 +285,12 @@ declare const PROVIDER_IDS: ProviderId[];
 declare function getProvider(id: string): ProviderDef;
 /** Build endpoint URL from template + region. */
 declare function buildEndpointFromTemplate(id: ProviderId, region: string): string;
+/**
+ * Resolve an endpoint URL for a provider using its registered template,
+ * falling back to the provider's default region when none is supplied.
+ * Returns '' when the provider has no template (e.g. plain S3 or MinIO).
+ */
+declare function resolveProviderEndpoint(provider: string, region?: string): string;
 /**
  * Build the base URL for API requests (endpoint + bucket).
  * Used by browser-cloud adapter and url-state.
@@ -261,6 +298,33 @@ declare function buildEndpointFromTemplate(id: ProviderId, region: string): stri
 declare function buildProviderBaseUrl(provider: ProviderId, endpoint: string, bucket: string, region: string): string;
 /** Check if a provider uses the GCS JSON API (not S3 XML). */
 declare function isGcsProvider(provider: string, endpoint: string): boolean;
+/**
+ * Minimal connection shape needed to decide access mode.
+ * Kept loose so callers don't need to import the full Connection type.
+ */
+interface AccessModeInput {
+    provider: string;
+    anonymous?: boolean;
+    endpoint?: string;
+}
+/**
+ * How a connection's files can be read by the browser:
+ *
+ * - `public-https`: plain HTTPS via any HTTP client. No auth, no signing.
+ *   Covers anonymous AWS/GCS/R2/Storj/Wasabi/etc.
+ * - `sas-https`: HTTPS with SAS token embedded in the URL. Still works with
+ *   any HTTP client. Azure only.
+ * - `signed-s3`: requires SigV4 signing. DuckDB uses the `s3://` URI and
+ *   signs it via its S3 config; other viewers must go through the storage
+ *   adapter (which returns a blob) instead of streaming the HTTPS URL.
+ */
+type AccessMode = 'public-https' | 'sas-https' | 'signed-s3';
+declare function getAccessMode(conn: AccessModeInput): AccessMode;
+/**
+ * True when the connection's files can be fetched by any HTTP client
+ * (fetch/img/video/DuckDB httpfs/COG/Zarr/etc.) without the storage adapter.
+ */
+declare function isPubliclyStreamable(conn: AccessModeInput): boolean;
 
 /**
  * Minimal adapter for direct HTTPS URLs (source: 'url').
@@ -308,6 +372,32 @@ declare function safeDecodeURIComponent(s: string): string;
  */
 declare function resolveCloudUrl(url: string): string;
 
+/** SampleFormat tag value → human label. */
+declare const SF_LABELS: Record<number, string>;
+interface GeoBounds {
+    west: number;
+    south: number;
+    east: number;
+    north: number;
+}
+interface CogInfo {
+    width: number;
+    height: number;
+    bandCount: number;
+    dataType: string;
+    bounds: GeoBounds;
+    downsampled?: boolean;
+}
+/** Safely clamp a number to a range, treating NaN/Infinity as the fallback. */
+declare function safeClamp(v: number, lo: number, hi: number, fallback: number): number;
+/** Clamp geographic bounds to valid MapLibre web-Mercator range. */
+declare function clampBounds(b: GeoBounds): GeoBounds;
+/**
+ * Build a data-type label from GeoTIFF sample format and bits per sample.
+ * e.g. "uint8", "float32", "int16"
+ */
+declare function buildDataTypeLabel(sampleFormat: number, bitsPerSample: number): string;
+
 type TypeCategory = 'number' | 'string' | 'date' | 'boolean' | 'geo' | 'binary' | 'json' | 'other';
 declare function classifyType(duckdbType: string): TypeCategory;
 declare function typeColor(category: TypeCategory): string;
@@ -337,6 +427,14 @@ declare function serializeToCsv(columns: string[], rows: Record<string, unknown>
  * Pure function — no browser APIs, works in Node.js.
  */
 declare function serializeToJson(columns: string[], rows: Record<string, unknown>[]): string;
+/**
+ * Export data as CSV file (triggers browser download).
+ */
+declare function exportToCsv(columns: string[], rows: Record<string, unknown>[], filename: string): void;
+/**
+ * Export data as JSON file (triggers browser download).
+ */
+declare function exportToJson(columns: string[], rows: Record<string, unknown>[], filename: string): void;
 
 /**
  * Pure file entry sorting — framework-agnostic, works in Node.js.
@@ -464,7 +562,7 @@ interface ParsedMarkdownDocument {
  * SELECT * FROM table
  * ```
  */
-declare function parseMarkdownDocument(markdown: string): ParsedMarkdownDocument;
+declare function parseMarkdownDocument(markdown: string): Promise<ParsedMarkdownDocument>;
 /**
  * Interpolate template variables in markdown text.
  * Supports {queryName.rows[0].columnName} syntax.
@@ -644,4 +742,4 @@ declare function findGeoColumnFromRows(rows: Record<string, unknown>[], schema:
     type: string;
 }[]): string | null;
 
-export { COPY_FEEDBACK_MS, type Connection, type ConnectionConfig, DEFAULT_TARGET_CRS, DUCKDB_INIT_TIMEOUT_MS, type Defaults, type DuckDbReadFn, type FileCategory, type FileEntry, type FileTypeInfo, type GeoArrowGeomType, type GeoArrowResult, type GeoColumnMeta, type GeoParquetMeta, type GeoType, type HexRow, LAYER_HUE_MULTIPLIER, type ListPage, MAX_QUERY_HISTORY_ENTRIES, type MapQueryHandle, type MapQueryResult, PROVIDERS, PROVIDER_IDS, type ParquetFileMetadata, type ParsedGeometry, type ParsedMarkdownDocument, type ParsedStorageUrl, type ProviderDef, type ProviderId, type ProviderRegion, QueryCancelledError, type QueryEngine, type QueryHandle, type QueryResult, SQL_PREVIEW_LENGTH, STORAGE_KEYS, type SchemaField, type SortConfig, type SortDirection, type SortField, type SqlBlock, type StorageAdapter, type StorageProvider, type Tab, type Theme, type TypeCategory, UrlAdapter, VIEWER_DIR_EXTENSIONS, type ViewerKind, WGS84_CODES, type WriteResult, buildDuckDbSource, buildEndpointFromTemplate, buildGeoArrowTables, buildProviderBaseUrl, classifyType, describeParseResult, escapeCsvField, extractBounds, extractEpsgFromGeoMeta, extractGeometryTypes, findGeoColumn, findGeoColumnFromRows, formatDate, formatFileSize, formatValue, generateHexDump, getDuckDbReadFn, getFileExtension, getFileTypeInfo, getMimeType, getNativeScheme, getProvider, getViewerKind, handleLoadError, interpolateTemplates, isCloudNativeFormat, isGcsProvider, isQueryable, jsonReplacerBigInt, loadFromStorage, looksLikeUrl, markSqlBlocks, normalizeGeomType, parseMarkdownDocument, parseStorageUrl, parseWKB, persistToStorage, readParquetMetadata, resolveCloudUrl, safeDecodeURIComponent, serializeToCsv, serializeToJson, sortFileEntries, toBinary, toggleSortField, typeBadgeClass, typeColor, typeLabel };
+export { type AccessMode, type AccessModeInput, COPY_FEEDBACK_MS, type CogInfo, type Connection, type ConnectionConfig, DEFAULT_TARGET_CRS, DUCKDB_INIT_TIMEOUT_MS, type Defaults, type DuckDbReadFn, type FileCategory, type FileEntry, type FileTypeInfo, type GeoArrowGeomType, type GeoArrowResult, type GeoBounds, type GeoColumnMeta, type GeoParquetMeta, type GeoType, type HexRow, LAYER_HUE_MULTIPLIER, type ListPage, MAX_QUERY_HISTORY_ENTRIES, type MapQueryHandle, type MapQueryResult, PROVIDERS, PROVIDER_IDS, type ParquetFileMetadata, type ParsedGeometry, type ParsedMarkdownDocument, type ParsedStorageUrl, type ProviderDef, type ProviderId, type ProviderRegion, QueryCancelledError, type QueryEngine, type QueryHandle, type QueryResult, type QuerySource, SF_LABELS, SQL_PREVIEW_LENGTH, STORAGE_KEYS, type SchemaField, type SortConfig, type SortDirection, type SortField, type SqlBlock, type StorageAdapter, type StorageProvider, type Tab, type Theme, type TypeCategory, UrlAdapter, VIEWER_DIR_EXTENSIONS, type ViewerKind, WGS84_CODES, type WriteResult, buildDataTypeLabel, buildDuckDbSource, buildEndpointFromTemplate, buildGeoArrowTables, buildProviderBaseUrl, clampBounds, classifyType, describeParseResult, escapeCsvField, exportToCsv, exportToJson, extractBounds, extractEpsgFromGeoMeta, extractGeometryTypes, findGeoColumn, findGeoColumnFromRows, formatDate, formatFileSize, formatValue, generateHexDump, getAccessMode, getDuckDbReadFn, getFileExtension, getFileTypeInfo, getMimeType, getNativeScheme, getProvider, getViewerKind, handleLoadError, interpolateTemplates, isCloudNativeFormat, isGcsProvider, isPubliclyStreamable, isQueryable, jsonReplacerBigInt, loadFromStorage, looksLikeUrl, markSqlBlocks, normalizeGeomType, parseMarkdownDocument, parseStorageUrl, parseWKB, persistToStorage, readParquetMetadata, resolveCloudUrl, resolveProviderEndpoint, safeClamp, safeDecodeURIComponent, serializeToCsv, serializeToJson, sortFileEntries, toBinary, toggleSortField, typeBadgeClass, typeColor, typeLabel };

package/dist/index.d.ts

@@ -11,8 +11,12 @@ declare const STORAGE_KEYS: {
 };
 /** EPSG codes considered WGS84 (no reprojection needed). */
 declare const WGS84_CODES: Set<number>;
-/** Default target CRS for ST_Transform. */
-declare const DEFAULT_TARGET_CRS = "EPSG:4326";
+/**
+ * Default target CRS for ST_Transform. Uses OGC:CRS84 (longitude, latitude)
+ * to match GeoParquet 1.1+ spec and DuckDB v1.5's canonical form.
+ * Functionally equivalent to EPSG:4326 under `geometry_always_xy = true`.
+ */
+declare const DEFAULT_TARGET_CRS = "OGC:CRS84";
 /** DuckDB-WASM initialization timeout in ms. */
 declare const DUCKDB_INIT_TIMEOUT_MS = 30000;
 /** Maximum entries kept in query history. */
@@ -119,15 +123,27 @@ interface SchemaField {
     type: string;
     nullable: boolean;
 }
+/**
+ * Abstraction over a DuckDB query source. Decouples schema / CRS / count
+ * helpers from assuming a file-backed path. `ref` is the FROM-clause target
+ * inserted into generated SQL (e.g. `read_parquet('url')` for files, or
+ * `attached_db."schema"."table"` for attached databases). `filePath` is
+ * optional and only used as a shortcut for Parquet file-level metadata
+ * queries (`parquet_kv_metadata`, `parquet_file_metadata`), not for SQL.
+ */
+interface QuerySource {
+    ref: string;
+    filePath?: string;
+}
 interface QueryEngine {
     query(connId: string, sql: string): Promise<QueryResult>;
     queryForMap(connId: string, sql: string, geomCol: string, geomColType: string, sourceCrs?: string | null): Promise<MapQueryResult>;
-    getSchema(connId: string, path: string): Promise<SchemaField[]>;
-    getRowCount(connId: string, path: string): Promise<number>;
+    getSchema(connId: string, source: QuerySource): Promise<SchemaField[]>;
+    getRowCount(connId: string, source: QuerySource): Promise<number>;
     /** Detect CRS from GeoParquet metadata. Returns e.g. 'EPSG:27700' or null if WGS84/unknown. */
-    detectCrs(connId: string, path: string, geomCol: string): Promise<string | null>;
+    detectCrs(connId: string, source: QuerySource, geomCol: string): Promise<string | null>;
     /** Combined schema + CRS detection in a single connection (fewer web worker round-trips). */
-    getSchemaAndCrs?(connId: string, path: string, findGeoCol: (schema: SchemaField[]) => string | null): Promise<{
+    getSchemaAndCrs?(connId: string, source: QuerySource, findGeoCol: (schema: SchemaField[]) => string | null): Promise<{
         schema: SchemaField[];
         geomCol: string | null;
         crs: string | null;
@@ -135,6 +151,10 @@ interface QueryEngine {
     queryCancellable?(connId: string, sql: string): QueryHandle;
     queryForMapCancellable?(connId: string, sql: string, geomCol: string, geomColType: string, sourceCrs?: string | null): MapQueryHandle;
     forceCancel?(): Promise<void>;
+    /** Register a file buffer in DuckDB-WASM's virtual filesystem for ATTACH. */
+    registerFileBuffer?(name: string, buffer: Uint8Array): Promise<void>;
+    /** Drop a previously registered file from DuckDB-WASM's virtual filesystem. */
+    dropFile?(name: string): Promise<void>;
     releaseMemory(): Promise<void>;
     dispose(): Promise<void>;
 }
@@ -179,6 +199,17 @@ interface Tab {
     connectionId?: string;
     extension: string;
     size?: number;
+    /**
+     * When set, the tab reads data from a SQL FROM-clause target (e.g. an
+     * attached DuckLake/DuckDB/SQLite table) rather than a file URL. The ref
+     * is inserted directly into generated SQL, so it must be fully-qualified
+     * and pre-quoted, e.g. `__objex_db__."main"."air_quality"`.
+     *
+     * When `sourceRef` is set, file-specific loading paths (hyparquet
+     * metadata, `parquet_kv_metadata`, etc.) are skipped, and schema / CRS /
+     * row count are derived from the SQL source directly via DuckDB.
+     */
+    sourceRef?: string;
 }
 interface WriteResult {
     key: string;
@@ -254,6 +285,12 @@ declare const PROVIDER_IDS: ProviderId[];
 declare function getProvider(id: string): ProviderDef;
 /** Build endpoint URL from template + region. */
 declare function buildEndpointFromTemplate(id: ProviderId, region: string): string;
+/**
+ * Resolve an endpoint URL for a provider using its registered template,
+ * falling back to the provider's default region when none is supplied.
+ * Returns '' when the provider has no template (e.g. plain S3 or MinIO).
+ */
+declare function resolveProviderEndpoint(provider: string, region?: string): string;
 /**
  * Build the base URL for API requests (endpoint + bucket).
  * Used by browser-cloud adapter and url-state.
@@ -261,6 +298,33 @@ declare function buildEndpointFromTemplate(id: ProviderId, region: string): stri
 declare function buildProviderBaseUrl(provider: ProviderId, endpoint: string, bucket: string, region: string): string;
 /** Check if a provider uses the GCS JSON API (not S3 XML). */
 declare function isGcsProvider(provider: string, endpoint: string): boolean;
+/**
+ * Minimal connection shape needed to decide access mode.
+ * Kept loose so callers don't need to import the full Connection type.
+ */
+interface AccessModeInput {
+    provider: string;
+    anonymous?: boolean;
+    endpoint?: string;
+}
+/**
+ * How a connection's files can be read by the browser:
+ *
+ * - `public-https`: plain HTTPS via any HTTP client. No auth, no signing.
+ *   Covers anonymous AWS/GCS/R2/Storj/Wasabi/etc.
+ * - `sas-https`: HTTPS with SAS token embedded in the URL. Still works with
+ *   any HTTP client. Azure only.
+ * - `signed-s3`: requires SigV4 signing. DuckDB uses the `s3://` URI and
+ *   signs it via its S3 config; other viewers must go through the storage
+ *   adapter (which returns a blob) instead of streaming the HTTPS URL.
+ */
+type AccessMode = 'public-https' | 'sas-https' | 'signed-s3';
+declare function getAccessMode(conn: AccessModeInput): AccessMode;
+/**
+ * True when the connection's files can be fetched by any HTTP client
+ * (fetch/img/video/DuckDB httpfs/COG/Zarr/etc.) without the storage adapter.
+ */
+declare function isPubliclyStreamable(conn: AccessModeInput): boolean;
 
 /**
  * Minimal adapter for direct HTTPS URLs (source: 'url').
@@ -308,6 +372,32 @@ declare function safeDecodeURIComponent(s: string): string;
  */
 declare function resolveCloudUrl(url: string): string;
 
+/** SampleFormat tag value → human label. */
+declare const SF_LABELS: Record<number, string>;
+interface GeoBounds {
+    west: number;
+    south: number;
+    east: number;
+    north: number;
+}
+interface CogInfo {
+    width: number;
+    height: number;
+    bandCount: number;
+    dataType: string;
+    bounds: GeoBounds;
+    downsampled?: boolean;
+}
+/** Safely clamp a number to a range, treating NaN/Infinity as the fallback. */
+declare function safeClamp(v: number, lo: number, hi: number, fallback: number): number;
+/** Clamp geographic bounds to valid MapLibre web-Mercator range. */
+declare function clampBounds(b: GeoBounds): GeoBounds;
+/**
+ * Build a data-type label from GeoTIFF sample format and bits per sample.
+ * e.g. "uint8", "float32", "int16"
+ */
+declare function buildDataTypeLabel(sampleFormat: number, bitsPerSample: number): string;
+
 type TypeCategory = 'number' | 'string' | 'date' | 'boolean' | 'geo' | 'binary' | 'json' | 'other';
 declare function classifyType(duckdbType: string): TypeCategory;
 declare function typeColor(category: TypeCategory): string;
@@ -337,6 +427,14 @@ declare function serializeToCsv(columns: string[], rows: Record<string, unknown>
  * Pure function — no browser APIs, works in Node.js.
  */
 declare function serializeToJson(columns: string[], rows: Record<string, unknown>[]): string;
+/**
+ * Export data as CSV file (triggers browser download).
+ */
+declare function exportToCsv(columns: string[], rows: Record<string, unknown>[], filename: string): void;
+/**
+ * Export data as JSON file (triggers browser download).
+ */
+declare function exportToJson(columns: string[], rows: Record<string, unknown>[], filename: string): void;
 
 /**
  * Pure file entry sorting — framework-agnostic, works in Node.js.
@@ -464,7 +562,7 @@ interface ParsedMarkdownDocument {
  * SELECT * FROM table
  * ```
  */
-declare function parseMarkdownDocument(markdown: string): ParsedMarkdownDocument;
+declare function parseMarkdownDocument(markdown: string): Promise<ParsedMarkdownDocument>;
 /**
  * Interpolate template variables in markdown text.
  * Supports {queryName.rows[0].columnName} syntax.
@@ -644,4 +742,4 @@ declare function findGeoColumnFromRows(rows: Record<string, unknown>[], schema:
     type: string;
 }[]): string | null;
 
-export { COPY_FEEDBACK_MS, type Connection, type ConnectionConfig, DEFAULT_TARGET_CRS, DUCKDB_INIT_TIMEOUT_MS, type Defaults, type DuckDbReadFn, type FileCategory, type FileEntry, type FileTypeInfo, type GeoArrowGeomType, type GeoArrowResult, type GeoColumnMeta, type GeoParquetMeta, type GeoType, type HexRow, LAYER_HUE_MULTIPLIER, type ListPage, MAX_QUERY_HISTORY_ENTRIES, type MapQueryHandle, type MapQueryResult, PROVIDERS, PROVIDER_IDS, type ParquetFileMetadata, type ParsedGeometry, type ParsedMarkdownDocument, type ParsedStorageUrl, type ProviderDef, type ProviderId, type ProviderRegion, QueryCancelledError, type QueryEngine, type QueryHandle, type QueryResult, SQL_PREVIEW_LENGTH, STORAGE_KEYS, type SchemaField, type SortConfig, type SortDirection, type SortField, type SqlBlock, type StorageAdapter, type StorageProvider, type Tab, type Theme, type TypeCategory, UrlAdapter, VIEWER_DIR_EXTENSIONS, type ViewerKind, WGS84_CODES, type WriteResult, buildDuckDbSource, buildEndpointFromTemplate, buildGeoArrowTables, buildProviderBaseUrl, classifyType, describeParseResult, escapeCsvField, extractBounds, extractEpsgFromGeoMeta, extractGeometryTypes, findGeoColumn, findGeoColumnFromRows, formatDate, formatFileSize, formatValue, generateHexDump, getDuckDbReadFn, getFileExtension, getFileTypeInfo, getMimeType, getNativeScheme, getProvider, getViewerKind, handleLoadError, interpolateTemplates, isCloudNativeFormat, isGcsProvider, isQueryable, jsonReplacerBigInt, loadFromStorage, looksLikeUrl, markSqlBlocks, normalizeGeomType, parseMarkdownDocument, parseStorageUrl, parseWKB, persistToStorage, readParquetMetadata, resolveCloudUrl, safeDecodeURIComponent, serializeToCsv, serializeToJson, sortFileEntries, toBinary, toggleSortField, typeBadgeClass, typeColor, typeLabel };
+export { type AccessMode, type AccessModeInput, COPY_FEEDBACK_MS, type CogInfo, type Connection, type ConnectionConfig, DEFAULT_TARGET_CRS, DUCKDB_INIT_TIMEOUT_MS, type Defaults, type DuckDbReadFn, type FileCategory, type FileEntry, type FileTypeInfo, type GeoArrowGeomType, type GeoArrowResult, type GeoBounds, type GeoColumnMeta, type GeoParquetMeta, type GeoType, type HexRow, LAYER_HUE_MULTIPLIER, type ListPage, MAX_QUERY_HISTORY_ENTRIES, type MapQueryHandle, type MapQueryResult, PROVIDERS, PROVIDER_IDS, type ParquetFileMetadata, type ParsedGeometry, type ParsedMarkdownDocument, type ParsedStorageUrl, type ProviderDef, type ProviderId, type ProviderRegion, QueryCancelledError, type QueryEngine, type QueryHandle, type QueryResult, type QuerySource, SF_LABELS, SQL_PREVIEW_LENGTH, STORAGE_KEYS, type SchemaField, type SortConfig, type SortDirection, type SortField, type SqlBlock, type StorageAdapter, type StorageProvider, type Tab, type Theme, type TypeCategory, UrlAdapter, VIEWER_DIR_EXTENSIONS, type ViewerKind, WGS84_CODES, type WriteResult, buildDataTypeLabel, buildDuckDbSource, buildEndpointFromTemplate, buildGeoArrowTables, buildProviderBaseUrl, clampBounds, classifyType, describeParseResult, escapeCsvField, exportToCsv, exportToJson, extractBounds, extractEpsgFromGeoMeta, extractGeometryTypes, findGeoColumn, findGeoColumnFromRows, formatDate, formatFileSize, formatValue, generateHexDump, getAccessMode, getDuckDbReadFn, getFileExtension, getFileTypeInfo, getMimeType, getNativeScheme, getProvider, getViewerKind, handleLoadError, interpolateTemplates, isCloudNativeFormat, isGcsProvider, isPubliclyStreamable, isQueryable, jsonReplacerBigInt, loadFromStorage, looksLikeUrl, markSqlBlocks, normalizeGeomType, parseMarkdownDocument, parseStorageUrl, parseWKB, persistToStorage, readParquetMetadata, resolveCloudUrl, resolveProviderEndpoint, safeClamp, safeDecodeURIComponent, serializeToCsv, serializeToJson, sortFileEntries, toBinary, toggleSortField, typeBadgeClass, typeColor, typeLabel };

package/dist/index.js

@@ -1,5 +1,9 @@
+import '@developmentseed/epsg/all';
+import '@developmentseed/epsg/all.csv.gz?url';
+import '@developmentseed/geotiff';
+import '@developmentseed/proj';
+import 'proj4';
 import { Field, Float64, FixedSizeList, Schema, Struct, makeData, RecordBatch, Table, List, Utf8 } from 'apache-arrow';
-import YAML from 'yaml';
 
 // ../../src/lib/constants.ts
 var STORAGE_KEYS = {
@@ -8,7 +12,7 @@ var STORAGE_KEYS = {
   QUERY_HISTORY: "obstore-explore-query-history"
 };
 var WGS84_CODES = /* @__PURE__ */ new Set([4326, 4979]);
-var DEFAULT_TARGET_CRS = "EPSG:4326";
+var DEFAULT_TARGET_CRS = "OGC:CRS84";
 var DUCKDB_INIT_TIMEOUT_MS = 3e4;
 var MAX_QUERY_HISTORY_ENTRIES = 200;
 var SQL_PREVIEW_LENGTH = 120;
@@ -888,6 +892,16 @@ var EXTENSIONS = {
     duckdbReadFn: null,
     mimeType: "application/octet-stream"
   },
+  ".ducklake": {
+    icon: "Database",
+    color: "text-teal-600 dark:text-teal-400",
+    label: "DuckLake",
+    category: "database",
+    viewer: "database",
+    queryable: true,
+    duckdbReadFn: null,
+    mimeType: "application/octet-stream"
+  },
   ".sqlite": {
     icon: "Database",
     color: "text-sky-600 dark:text-sky-400",
@@ -1035,7 +1049,7 @@ function buildDuckDbSource(pathOrExt, url) {
   const readFn = EXTENSIONS[ext]?.duckdbReadFn ?? "read_parquet";
   return `${readFn}('${url}')`;
 }
-var CLOUD_NATIVE_EXTS = /* @__PURE__ */ new Set([".parquet", ".geoparquet", ".gpq", ".gparquet"]);
+var CLOUD_NATIVE_EXTS = /* @__PURE__ */ new Set([".parquet", ".geoparquet", ".gpq", ".gparquet", ".ducklake"]);
 function isCloudNativeFormat(pathOrExt) {
   const ext = pathOrExt.includes(".") ? `.${pathOrExt.split(".").pop().toLowerCase()}` : "";
   return CLOUD_NATIVE_EXTS.has(ext);
@@ -1341,6 +1355,11 @@ function buildEndpointFromTemplate(id, region) {
   if (!def?.endpointTemplate) return "";
   return def.endpointTemplate.replace("{region}", region);
 }
+function resolveProviderEndpoint(provider, region) {
+  const def = PROVIDERS[provider];
+  if (!def?.endpointTemplate) return "";
+  return buildEndpointFromTemplate(provider, region || def.defaultRegion);
+}
 function buildProviderBaseUrl(provider, endpoint, bucket, region) {
   if (endpoint) {
     return `${endpoint.replace(/\/$/, "")}/${bucket}`;
@@ -1355,6 +1374,15 @@ function buildProviderBaseUrl(provider, endpoint, bucket, region) {
 function isGcsProvider(provider, endpoint) {
   return provider === "gcs" || !!endpoint && /storage\.googleapis\.com/i.test(endpoint);
 }
+function getAccessMode(conn) {
+  if (conn.provider === "azure") return "sas-https";
+  if (conn.anonymous) return "public-https";
+  return "signed-s3";
+}
+function isPubliclyStreamable(conn) {
+  const mode = getAccessMode(conn);
+  return mode === "public-https" || mode === "sas-https";
+}
 
 // ../../src/lib/storage/url-adapter.ts
 var UrlAdapter = class {
@@ -1432,6 +1460,28 @@ function resolveCloudUrl(url) {
   }
   return url;
 }
+var SF_LABELS = {
+  1: "uint",
+  2: "int",
+  3: "float",
+  4: "void",
+  5: "complex int",
+  6: "complex float"
+};
+function safeClamp(v, lo, hi, fallback) {
+  return Number.isFinite(v) ? Math.max(lo, Math.min(hi, v)) : fallback;
+}
+function clampBounds(b) {
+  return {
+    west: safeClamp(b.west, -180, 180, -180),
+    south: safeClamp(b.south, -85.051129, 85.051129, -85.051129),
+    east: safeClamp(b.east, -180, 180, 180),
+    north: safeClamp(b.north, -85.051129, 85.051129, 85.051129)
+  };
+}
+function buildDataTypeLabel(sampleFormat, bitsPerSample) {
+  return `${SF_LABELS[sampleFormat] ?? `sf${sampleFormat}`}${bitsPerSample ?? ""}`;
+}
 
 // ../../src/lib/utils/column-types.ts
 var NUMBER_TYPES = [
@@ -1602,6 +1652,17 @@ function formatValue(value) {
 }
 
 // ../../src/lib/utils/export.ts
+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);
+}
 function formatCellValue(value) {
   if (value === null || value === void 0) return "";
   if (value instanceof Date) return value.toISOString();
@@ -1636,6 +1697,20 @@ function serializeToJson(columns, rows) {
   });
   return JSON.stringify(data, jsonReplacerBigInt, 2);
 }
+function exportToCsv(columns, rows, filename) {
+  triggerDownload(
+    serializeToCsv(columns, rows),
+    filename.endsWith(".csv") ? filename : `${filename}.csv`,
+    "text/csv;charset=utf-8;"
+  );
+}
+function exportToJson(columns, rows, filename) {
+  triggerDownload(
+    serializeToJson(columns, rows),
+    filename.endsWith(".json") ? filename : `${filename}.json`,
+    "application/json"
+  );
+}
 
 // ../../src/lib/utils/file-sort.ts
 function sortFileEntries(entries, config) {
@@ -2283,12 +2358,15 @@ function persistToStorage(key, value) {
   } catch {
   }
 }
-function parseMarkdownDocument(markdown) {
+
+// ../../src/lib/utils/markdown-sql.ts
+async function parseMarkdownDocument(markdown) {
   let frontmatter = {};
   let content = markdown;
   const fmMatch = markdown.match(/^---\n([\s\S]*?)\n---\n/);
   if (fmMatch) {
     try {
+      const { default: YAML } = await import('yaml');
       frontmatter = YAML.parse(fmMatch[1]) || {};
     } catch {
     }
@@ -2959,7 +3037,10 @@ var GEO_TYPE_KEYWORDS = [
   "geometrycollection",
   "sdo_geometry"
 ];
-var GEO_NAME_HINTS = ["geom", "geometry", "geo_", "_geo", "wkb", "wkt", "shape", "spatial"];
+var GEO_NAME_HINTS = ["geom", "geometry", "wkb", "wkt", "shape", "spatial", "geo"];
+function tokenizeColumnName(name) {
+  return name.replace(/([a-z])([A-Z])/g, "$1_$2").replace(/([a-z])([0-9])/g, "$1_$2").toLowerCase().split(/[^a-z0-9]+/).filter(Boolean);
+}
 var GEOJSON_TYPES = [
   "Point",
   "LineString",
@@ -2989,14 +3070,14 @@ function findGeoColumn(schema) {
     if (GEO_NAMES.includes(f.name.toLowerCase())) return f.name;
   }
   for (const f of schema) {
-    const n = f.name.toLowerCase();
+    const tokens = tokenizeColumnName(f.name);
     const t = f.type.toLowerCase();
     const isBinary = t.includes("blob") || t.includes("binary") || t.includes("bytea");
-    if (isBinary && GEO_NAME_HINTS.some((hint) => n.includes(hint))) return f.name;
+    if (isBinary && tokens.some((tok) => GEO_NAME_HINTS.includes(tok))) return f.name;
   }
   for (const f of schema) {
-    const n = f.name.toLowerCase();
-    if (GEO_NAME_HINTS.some((hint) => n.includes(hint))) return f.name;
+    const tokens = tokenizeColumnName(f.name);
+    if (tokens.some((tok) => GEO_NAME_HINTS.includes(tok))) return f.name;
   }
   return null;
 }
@@ -3053,6 +3134,6 @@ function isWKT(value) {
   return WKT_TYPES.some((t) => s.startsWith(t) || s.startsWith(`MULTI${t}`));
 }
 
-export { COPY_FEEDBACK_MS, DEFAULT_TARGET_CRS, DUCKDB_INIT_TIMEOUT_MS, LAYER_HUE_MULTIPLIER, MAX_QUERY_HISTORY_ENTRIES, PROVIDERS, PROVIDER_IDS, QueryCancelledError, SQL_PREVIEW_LENGTH, STORAGE_KEYS, UrlAdapter, VIEWER_DIR_EXTENSIONS, WGS84_CODES, buildDuckDbSource, buildEndpointFromTemplate, buildGeoArrowTables, buildProviderBaseUrl, classifyType, describeParseResult, escapeCsvField, extractBounds, extractEpsgFromGeoMeta, extractGeometryTypes, findGeoColumn, findGeoColumnFromRows, formatDate, formatFileSize, formatValue, generateHexDump, getDuckDbReadFn, getFileExtension, getFileTypeInfo, getMimeType, getNativeScheme, getProvider, getViewerKind, handleLoadError, interpolateTemplates, isCloudNativeFormat, isGcsProvider, isQueryable, jsonReplacerBigInt, loadFromStorage, looksLikeUrl, markSqlBlocks, normalizeGeomType, parseMarkdownDocument, parseStorageUrl, parseWKB, persistToStorage, readParquetMetadata, resolveCloudUrl, safeDecodeURIComponent, serializeToCsv, serializeToJson, sortFileEntries, toBinary, toggleSortField, typeBadgeClass, typeColor, typeLabel };
+export { COPY_FEEDBACK_MS, DEFAULT_TARGET_CRS, DUCKDB_INIT_TIMEOUT_MS, LAYER_HUE_MULTIPLIER, MAX_QUERY_HISTORY_ENTRIES, PROVIDERS, PROVIDER_IDS, QueryCancelledError, SF_LABELS, SQL_PREVIEW_LENGTH, STORAGE_KEYS, UrlAdapter, VIEWER_DIR_EXTENSIONS, WGS84_CODES, buildDataTypeLabel, buildDuckDbSource, buildEndpointFromTemplate, buildGeoArrowTables, buildProviderBaseUrl, clampBounds, classifyType, describeParseResult, escapeCsvField, exportToCsv, exportToJson, extractBounds, extractEpsgFromGeoMeta, extractGeometryTypes, findGeoColumn, findGeoColumnFromRows, formatDate, formatFileSize, formatValue, generateHexDump, getAccessMode, getDuckDbReadFn, getFileExtension, getFileTypeInfo, getMimeType, getNativeScheme, getProvider, getViewerKind, handleLoadError, interpolateTemplates, isCloudNativeFormat, isGcsProvider, isPubliclyStreamable, isQueryable, jsonReplacerBigInt, loadFromStorage, looksLikeUrl, markSqlBlocks, normalizeGeomType, parseMarkdownDocument, parseStorageUrl, parseWKB, persistToStorage, readParquetMetadata, resolveCloudUrl, resolveProviderEndpoint, safeClamp, safeDecodeURIComponent, serializeToCsv, serializeToJson, sortFileEntries, toBinary, toggleSortField, typeBadgeClass, typeColor, typeLabel };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map