@loaders.gl/parquet 4.5.3 → 5.0.0-alpha.10

package/dist/geoparquet-loader.d.ts

@@ -0,0 +1,59 @@
+import type { ArrowTable, ArrowTableBatch, GeoJSONTable, GeoJSONTableBatch } from '@loaders.gl/schema';
+import { type ParquetLoaderOptions as SharedParquetLoaderOptions } from "./parquet-loader-options.js";
+/** Options for the GeoParquet loader. */
+export type GeoParquetLoaderOptions = SharedParquetLoaderOptions;
+/** Preloads the parser-bearing GeoParquet loader implementation. */
+declare function preloadGeoParquetLoader(): Promise<{
+    readonly parse: (arrayBuffer: ArrayBuffer, options?: GeoParquetLoaderOptions) => Promise<ArrowTable | GeoJSONTable>;
+    readonly parseFile: (file: import("@loaders.gl/loader-utils").ReadableFile, options?: GeoParquetLoaderOptions) => Promise<ArrowTable | GeoJSONTable>;
+    readonly parseFileInBatches: (file: import("@loaders.gl/loader-utils").ReadableFile, options?: GeoParquetLoaderOptions) => AsyncIterable<ArrowTableBatch | GeoJSONTableBatch>;
+    readonly parseInBatches: (asyncIterator: AsyncIterable<ArrayBufferLike | ArrayBufferView> | Iterable<ArrayBufferLike | ArrayBufferView>, options?: GeoParquetLoaderOptions, _context?: unknown) => AsyncGenerator<ArrowTableBatch | GeoJSONTableBatch, void, any>;
+    readonly dataType: GeoJSONTable | ArrowTable;
+    readonly batchType: GeoJSONTableBatch | ArrowTableBatch;
+    readonly id: "parquet";
+    readonly module: "parquet";
+    readonly version: any;
+    readonly worker: false;
+    readonly options: {
+        readonly parquet: {
+            readonly columns: undefined;
+            readonly preserveBinary: false;
+            readonly shape: "arrow-table";
+        };
+    };
+    readonly name: "Apache Parquet";
+    readonly category: "table";
+    readonly encoding: "parquet";
+    readonly format: "parquet";
+    readonly extensions: ["parquet"];
+    readonly mimeTypes: ["application/octet-stream"];
+    readonly binary: true;
+    readonly tests: ["PAR1", "PARE"];
+}>;
+/** Metadata-only GeoParquet table loader. */
+export declare const GeoParquetLoader: {
+    readonly dataType: GeoJSONTable | ArrowTable;
+    readonly batchType: GeoJSONTableBatch | ArrowTableBatch;
+    readonly id: "parquet";
+    readonly module: "parquet";
+    readonly version: any;
+    readonly worker: false;
+    readonly options: {
+        readonly parquet: {
+            readonly columns: undefined;
+            readonly preserveBinary: false;
+            readonly shape: "arrow-table";
+        };
+    };
+    readonly preload: typeof preloadGeoParquetLoader;
+    readonly name: "Apache Parquet";
+    readonly category: "table";
+    readonly encoding: "parquet";
+    readonly format: "parquet";
+    readonly extensions: ["parquet"];
+    readonly mimeTypes: ["application/octet-stream"];
+    readonly binary: true;
+    readonly tests: ["PAR1", "PARE"];
+};
+export {};
+//# sourceMappingURL=geoparquet-loader.d.ts.map

package/dist/geoparquet-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geoparquet-loader.d.ts","sourceRoot":"","sources":["../src/geoparquet-loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,YAAY,EACZ,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAEL,KAAK,oBAAoB,IAAI,0BAA0B,EACxD,oCAAiC;AAMlC,yCAAyC;AACzC,MAAM,MAAM,uBAAuB,GAAG,0BAA0B,CAAC;AAEjE,oEAAoE;AACpE,iBAAe,uBAAuB;;;;;uBASP,YAAY,GAAG,UAAU;wBACxB,iBAAiB,GAAG,eAAe;;;;;;;;;;;;;;;;;;;;GAPlE;AAED,6CAA6C;AAC7C,eAAO,MAAM,gBAAgB;uBAGE,YAAY,GAAG,UAAU;wBACxB,iBAAiB,GAAG,eAAe;;;;;;;;;;;;;;;;;;;;;CAiBlE,CAAC"}

package/dist/geoparquet-loader.js

@@ -0,0 +1,30 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { ParquetFormat } from "./parquet-format.js";
+import { PARQUET_LOADER_DEFAULT_OPTIONS } from "./parquet-loader-options.js";
+// __VERSION__ is injected by babel-plugin-version-inline
+// @ts-ignore TS2304: Cannot find name '__VERSION__'.
+const VERSION = typeof "5.0.0-alpha.10" !== 'undefined' ? "5.0.0-alpha.10" : 'latest';
+/** Preloads the parser-bearing GeoParquet loader implementation. */
+async function preloadGeoParquetLoader() {
+    const { GeoParquetLoaderWithParser } = await import("./geoparquet-loader-with-parser.js");
+    return GeoParquetLoaderWithParser;
+}
+/** Metadata-only GeoParquet table loader. */
+export const GeoParquetLoader = {
+    ...ParquetFormat,
+    dataType: null,
+    batchType: null,
+    id: 'parquet',
+    module: 'parquet',
+    version: VERSION,
+    worker: false,
+    options: {
+        parquet: {
+            ...PARQUET_LOADER_DEFAULT_OPTIONS
+        }
+    },
+    preload: preloadGeoParquetLoader
+};
+//# sourceMappingURL=geoparquet-loader.js.map

package/dist/geoparquet-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geoparquet-loader.js","sourceRoot":"","sources":["../src/geoparquet-loader.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAUpC,OAAO,EAAC,aAAa,EAAC,4BAAyB;AAC/C,OAAO,EACL,8BAA8B,EAE/B,oCAAiC;AAElC,yDAAyD;AACzD,qDAAqD;AACrD,MAAM,OAAO,GAAG,uBAAkB,KAAK,WAAW,CAAC,CAAC,kBAAa,CAAC,CAAC,QAAQ,CAAC;AAK5E,oEAAoE;AACpE,KAAK,UAAU,uBAAuB;IACpC,MAAM,EAAC,0BAA0B,EAAC,GAAG,MAAM,MAAM,sCAAmC,CAAC;IACrF,OAAO,0BAA0B,CAAC;AACpC,CAAC;AAED,6CAA6C;AAC7C,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,GAAG,aAAa;IAEhB,QAAQ,EAAE,IAA4C;IACtD,SAAS,EAAE,IAAsD;IAEjE,EAAE,EAAE,SAAS;IACb,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,KAAK;IAEb,OAAO,EAAE;QACP,OAAO,EAAE;YACP,GAAG,8BAA8B;SAClC;KACF;IACD,OAAO,EAAE,uBAAuB;CAKjC,CAAC"}

package/dist/iceberg-rest-catalog.d.ts

@@ -0,0 +1,49 @@
+import { IcebergTableSource } from "./iceberg-table-source.js";
+import type { IcebergTableMetadata } from "./iceberg-types.js";
+import type { RequestScheduler } from '@loaders.gl/loader-utils';
+/** Configuration for the minimal Iceberg REST Catalog adapter. */
+export type IcebergRestCatalogOptions = {
+    /** Catalog base URL, for example `https://catalog.example.com`. */
+    readonly endpoint: string;
+    /** Headers sent to catalog and metadata requests. */
+    readonly headers?: HeadersInit;
+    /** Fetch implementation, useful for browser auth and deterministic tests. */
+    readonly fetch?: (url: string, options?: RequestInit) => Promise<Response>;
+    /** Optional shared request gate for catalog metadata calls. */
+    readonly requestScheduler?: RequestScheduler;
+};
+/** Fully qualified Iceberg REST table identifier. */
+export type IcebergRestTableIdentifier = {
+    /** Namespace components in catalog order. */
+    readonly namespace: readonly string[];
+    /** Table name within the namespace. */
+    readonly table: string;
+};
+/** A table source returned by the REST Catalog adapter. */
+export type IcebergRestTable = {
+    /** Inline metadata returned by the catalog, when available. */
+    readonly metadata?: IcebergTableMetadata;
+    /** Metadata location returned by the catalog, when available. */
+    readonly metadataLocation?: string;
+    /** Read-only source that plans and scans the table. */
+    readonly source: IcebergTableSource;
+};
+/**
+ * Minimal read-only Iceberg REST Catalog client.
+ *
+ * This deliberately stops at table loading. Scan planning and file access remain in
+ * `IcebergTableSource`, so catalog authentication and table-format decoding stay separate.
+ */
+export declare class IcebergRestCatalog {
+    private readonly options;
+    constructor(options: IcebergRestCatalogOptions);
+    /** Loads one table's metadata through the Iceberg REST Catalog `/v1` endpoint. */
+    loadTable(identifier: IcebergRestTableIdentifier, signal?: AbortSignal): Promise<IcebergRestTable>;
+    /** Fetches one catalog response through the optional shared request scheduler. */
+    private fetchJson;
+    /** Builds the standard REST Catalog table endpoint. */
+    private getTableUrl;
+    /** Carries catalog headers and fetch through to the metadata/data source. */
+    private getSourceOptions;
+}
+//# sourceMappingURL=iceberg-rest-catalog.d.ts.map

package/dist/iceberg-rest-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iceberg-rest-catalog.d.ts","sourceRoot":"","sources":["../src/iceberg-rest-catalog.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,kBAAkB,EAAC,kCAA+B;AAE1D,OAAO,KAAK,EAAC,oBAAoB,EAAC,2BAAwB;AAC1D,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,0BAA0B,CAAC;AAE/D,kEAAkE;AAClE,MAAM,MAAM,yBAAyB,GAAG;IACtC,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,qDAAqD;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3E,+DAA+D;IAC/D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CAC9C,CAAC;AAEF,qDAAqD;AACrD,MAAM,MAAM,0BAA0B,GAAG;IACvC,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,2DAA2D;AAC3D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IACzC,iEAAiE;IACjE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;CACrC,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;gBAExC,OAAO,EAAE,yBAAyB;IAI9C,kFAAkF;IAC5E,SAAS,CACb,UAAU,EAAE,0BAA0B,EACtC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,gBAAgB,CAAC;IAoB5B,kFAAkF;YACpE,SAAS;IAgBvB,uDAAuD;IACvD,OAAO,CAAC,WAAW;IAKnB,6EAA6E;IAC7E,OAAO,CAAC,gBAAgB;CAOzB"}

package/dist/iceberg-rest-catalog.js

@@ -0,0 +1,78 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { IcebergTableSource } from "./iceberg-table-source.js";
+/**
+ * Minimal read-only Iceberg REST Catalog client.
+ *
+ * This deliberately stops at table loading. Scan planning and file access remain in
+ * `IcebergTableSource`, so catalog authentication and table-format decoding stay separate.
+ */
+export class IcebergRestCatalog {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    /** Loads one table's metadata through the Iceberg REST Catalog `/v1` endpoint. */
+    async loadTable(identifier, signal) {
+        const tableUrl = this.getTableUrl(identifier);
+        const response = await this.fetchJson(tableUrl, signal);
+        if (!response.ok) {
+            throw new Error(`Iceberg REST Catalog request failed: ${response.status} ${response.statusText}`);
+        }
+        const responseJson = (await response.json());
+        const metadataLocation = getString(responseJson['metadata-location']);
+        const metadata = isIcebergMetadata(responseJson.metadata) ? responseJson.metadata : undefined;
+        if (!metadataLocation && !metadata) {
+            throw new Error('Iceberg REST Catalog response did not include table metadata');
+        }
+        const source = metadata
+            ? new IcebergTableSource(createMetadataUrl(metadata), this.getSourceOptions())
+            : new IcebergTableSource(metadataLocation, this.getSourceOptions());
+        return { metadata, metadataLocation, source };
+    }
+    /** Fetches one catalog response through the optional shared request scheduler. */
+    async fetchJson(url, signal) {
+        const scheduler = this.options.requestScheduler;
+        const request = scheduler
+            ? await scheduler.scheduleRequest(url, () => (signal?.aborted ? -1 : 0))
+            : { done: () => { } };
+        if (!request)
+            throw new DOMException('The operation was aborted', 'AbortError');
+        try {
+            return await (this.options.fetch ?? fetch)(url, {
+                headers: this.options.headers,
+                signal
+            });
+        }
+        finally {
+            request.done();
+        }
+    }
+    /** Builds the standard REST Catalog table endpoint. */
+    getTableUrl(identifier) {
+        const namespace = identifier.namespace.map(encodeURIComponent).join('%1F');
+        return `${this.options.endpoint.replace(/\/$/, '')}/v1/namespaces/${namespace}/tables/${encodeURIComponent(identifier.table)}`;
+    }
+    /** Carries catalog headers and fetch through to the metadata/data source. */
+    getSourceOptions() {
+        const options = { iceberg: { headers: this.options.headers } };
+        if (this.options.fetch) {
+            options.core = { fetch: this.options.fetch };
+        }
+        return options;
+    }
+}
+function getString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function isIcebergMetadata(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const metadata = value;
+    return typeof metadata['format-version'] === 'number' && typeof metadata.location === 'string';
+}
+function createMetadataUrl(metadata) {
+    return `data:application/json,${encodeURIComponent(JSON.stringify(metadata))}`;
+}
+//# sourceMappingURL=iceberg-rest-catalog.js.map

package/dist/iceberg-rest-catalog.js.map

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

package/dist/iceberg-table-source.d.ts

@@ -0,0 +1,63 @@
+import type { CoreAPI, ScanQueryMetadata, ScanQueryMetadataOptions, TableScanSource } from '@loaders.gl/loader-utils';
+import { DataSource as BaseDataSource } from '@loaders.gl/loader-utils';
+import type { IcebergSpatialFilter, IcebergDeleteFile, IcebergParquetFile, IcebergScanPlan, IcebergSnapshot, IcebergTableMetadata, IcebergTableSourceOptions } from "./iceberg-types.js";
+import type { ParquetDatasetBatch, ParquetPredicate, ParquetDatasetReadOptions, ParquetDatasetExplain, ParquetDatasetSourceOptions } from "./parquet-source-types.js";
+/** Options accepted by `IcebergTableSource`. */
+export type IcebergSourceOptions = ParquetDatasetSourceOptions & {
+    iceberg?: IcebergTableSourceOptions;
+};
+/** Options for scanning the current Iceberg snapshot as Parquet batches. */
+export type IcebergScanOptions = ParquetDatasetReadOptions & {
+    /** Reads a specific snapshot instead of the table's current snapshot. */
+    snapshotId?: number;
+    /** Reads the snapshot selected by a named Iceberg branch or tag. */
+    snapshotRef?: string;
+    /** Applies Iceberg position deletes after Parquet batches are decoded. */
+    applyDeletes?: boolean;
+    /** Conservatively prunes files whose declared geometry bounds miss this envelope. */
+    spatialFilter?: IcebergSpatialFilter;
+};
+/**
+ * Read-only Iceberg table metadata source.
+ *
+ * The source owns Iceberg metadata and manifest discovery, then delegates selected data files to
+ * `ParquetDatasetSource` for projection, filtering, range access, workers, and Arrow materialization.
+ */
+export declare class IcebergTableSource extends BaseDataSource<string, IcebergSourceOptions> implements TableScanSource<ParquetDatasetBatch, ParquetPredicate> {
+    private metadataPromise;
+    private readonly closeController;
+    private closed;
+    constructor(data: string, options?: IcebergSourceOptions, coreApi?: CoreAPI);
+    /** Loads and validates the table metadata JSON. Results are cached for the source lifetime. */
+    getMetadata(signal?: AbortSignal): Promise<IcebergTableMetadata>;
+    /** Returns the snapshot selected by the table metadata, if one exists. */
+    getCurrentSnapshot(signal?: AbortSignal): Promise<IcebergSnapshot | undefined>;
+    /** Returns a selected snapshot, defaulting to the table's current snapshot. */
+    private getSnapshot;
+    /** Builds a data and delete-file plan from one snapshot without opening data files. */
+    getScanPlan(signal?: AbortSignal, snapshotId?: number, snapshotRef?: string): Promise<IcebergScanPlan>;
+    /** Reads the selected snapshot's active Parquet data files. */
+    getParquetFiles(signal?: AbortSignal, snapshotId?: number, snapshotRef?: string): Promise<readonly IcebergParquetFile[]>;
+    /** Reads delete files from the selected snapshot without applying them to Parquet rows. */
+    getDeleteFiles(signal?: AbortSignal, snapshotId?: number, snapshotRef?: string): Promise<readonly IcebergDeleteFile[]>;
+    /** Discovers the current snapshot schema and aggregate file statistics without decoding rows. */
+    getQueryMetadata(options?: ScanQueryMetadataOptions): Promise<ScanQueryMetadata>;
+    /** Explains Iceberg manifest pruning and the delegated Parquet dataset plan. */
+    explain(options?: IcebergScanOptions): Promise<ParquetDatasetExplain>;
+    /** Common table-scan entry point for the selected Iceberg snapshot. */
+    read(options?: IcebergScanOptions): AsyncIterable<ParquetDatasetBatch>;
+    /** Reads the current snapshot as Arrow batches through the existing Parquet dataset source. */
+    scan(options?: IcebergScanOptions): AsyncIterable<ParquetDatasetBatch>;
+    /** Creates the delegated Parquet dataset after Iceberg metadata-level pruning. */
+    private createParquetDataset;
+    /** Permanently closes the source and aborts an in-flight metadata request. */
+    close(): Promise<void>;
+    private loadMetadata;
+    private readAvroRecords;
+    /** Reads position-delete files into a source-file to row-position index. */
+    private loadPositionDeletes;
+    /** Reads equality-delete files and resolves their Iceberg field IDs to current schema names. */
+    private loadEqualityDeletes;
+    private assertOpen;
+}
+//# sourceMappingURL=iceberg-table-source.d.ts.map

package/dist/iceberg-table-source.d.ts.map

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