@loaders.gl/scan 5.0.0-alpha.3

package/dist/vector-table-scan-source.js

@@ -0,0 +1,215 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { convertArrowToSchema } from '@loaders.gl/schema-utils';
+import { createScanQueryMetadata, makeTableScanBatch } from '@loaders.gl/loader-utils';
+import { ARROW_TABLE_QUERY_CAPABILITIES, explainArrowTableQuery, queryArrowTable } from '@loaders.gl/sql';
+/**
+ * Base source for a physical vector selection that resolves to one Arrow feature table.
+ *
+ * The physical address is immutable and owned by a specialized adapter. Portable predicates,
+ * projection, ordering, aggregates, and limits are applied only after that selection resolves.
+ */
+export class AddressedVectorTableScanSource {
+    /** Stable adapter type reported by `getQueryMetadata()`. */
+    sourceType;
+    /** Optional display name shown by query controls. */
+    name;
+    /** Human-readable description of the bound physical selection. */
+    description;
+    /** Spatial extent of the bound physical selection. */
+    spatial;
+    tablePromise = null;
+    /** Creates a table-scan view over one immutable physical selection. */
+    constructor(options, defaults) {
+        this.sourceType = options.sourceType || defaults.sourceType;
+        this.name = options.name;
+        this.description = options.description || defaults.description;
+        this.spatial = defaults.spatial;
+    }
+    /** Discovers the addressed result schema and portable residual-query capabilities. */
+    async getQueryMetadata(options = {}) {
+        const table = await this.getTable(options.signal);
+        const schema = table.schema || convertArrowToSchema(table.data.schema);
+        return createScanQueryMetadata({
+            sourceType: this.sourceType,
+            queryType: 'table',
+            execution: { status: 'supported', method: 'read' },
+            name: this.name,
+            description: this.description,
+            schema,
+            capabilities: {
+                table: ARROW_TABLE_QUERY_CAPABILITIES,
+                bounds: 'unsupported',
+                levelOfDetail: 'unsupported'
+            },
+            columnRoles: inferVectorColumnRoles(schema.fields.map(field => field.name)),
+            spatial: this.spatial,
+            statistics: { rowCount: table.data.numRows }
+        });
+    }
+    /** Applies the portable Arrow query to the addressed feature table. */
+    async query(options = {}) {
+        const table = await this.getTable(options.signal);
+        return queryArrowTable(table, options);
+    }
+    /** Explains the residual Arrow plan after resolving the addressed feature table. */
+    async explain(options = {}) {
+        const table = await this.getTable(options.signal);
+        return explainArrowTableQuery(table, options);
+    }
+    /** Emits the portable query result as one bounded Arrow batch. */
+    async *read(options = {}) {
+        const result = await this.query(options);
+        yield makeTableScanBatch(result);
+    }
+    /** Resolves and caches the addressed table while allowing failed loads to be retried. */
+    async getTable(signal) {
+        throwIfAborted(signal);
+        if (!this.tablePromise) {
+            this.tablePromise = this.loadTable()
+                .then(table => {
+                if (!table) {
+                    throw new Error('The addressed vector selection did not return a feature table.');
+                }
+                if (table.shape !== 'arrow-table') {
+                    throw new Error('The addressed vector selection must return an Arrow table. Configure the source with shape "arrow-table".');
+                }
+                return table;
+            })
+                .catch(error => {
+                this.tablePromise = null;
+                throw error;
+            });
+        }
+        return await waitForPromise(this.tablePromise, signal);
+    }
+}
+/**
+ * Portable table-query view over one explicitly addressed vector tile.
+ *
+ * MVT and vector PMTiles sources participate when configured to return `shape: 'arrow-table'`.
+ * Tile coordinates and layer selection remain source parameters rather than relational operators.
+ */
+export class VectorTileTableScanSource extends AddressedVectorTableScanSource {
+    /** Specialized tile source that owns tile addressing and decoding. */
+    source;
+    /** Immutable tile address bound to this table view. */
+    tile;
+    /** Creates a portable table view over one vector tile. */
+    constructor(source, options) {
+        const tile = Object.freeze({
+            ...options.tile,
+            layers: cloneAndFreezeLayers(options.tile.layers)
+        });
+        super(options, {
+            sourceType: 'vector-tile-table',
+            description: `Vector tile ${tile.z}/${tile.x}/${tile.y}`,
+            spatial: {
+                bounds: getWGS84TileBounds(tile),
+                coordinateReferenceSystems: ['EPSG:4326']
+            }
+        });
+        this.source = source;
+        this.tile = tile;
+    }
+    /** Loads the bound vector tile using the source's requested Arrow output shape. */
+    loadTable(signal) {
+        return this.source.getVectorTile({ ...this.tile, signal });
+    }
+}
+/**
+ * Portable table-query view over one explicitly bounded vector-service request.
+ *
+ * WFS and ArcGIS feature sources participate through their existing Arrow feature output. Layers,
+ * service bounds, and output CRS remain source parameters rather than relational operators.
+ */
+export class VectorFeatureTableScanSource extends AddressedVectorTableScanSource {
+    /** Specialized vector source that owns service request construction and parsing. */
+    source;
+    /** Immutable bounded feature request bound to this table view. */
+    request;
+    /** Creates a portable table view over one bounded vector-service request. */
+    constructor(source, options) {
+        const request = Object.freeze({
+            ...options.request,
+            layers: cloneAndFreezeLayers(options.request.layers),
+            boundingBox: Object.freeze([
+                Object.freeze([...options.request.boundingBox[0]]),
+                Object.freeze([...options.request.boundingBox[1]])
+            ])
+        });
+        const coordinateReferenceSystems = typeof request.crs === 'string' ? [request.crs] : undefined;
+        super(options, {
+            sourceType: 'vector-feature-table',
+            description: `Vector feature request for ${normalizeLayers(request.layers).join(', ')}`,
+            spatial: {
+                bounds: {
+                    minimum: Object.freeze([...request.boundingBox[0]]),
+                    maximum: Object.freeze([...request.boundingBox[1]])
+                },
+                coordinateReferenceSystems
+            }
+        });
+        this.source = source;
+        this.request = request;
+    }
+    /** Loads the bound service request through the source's Arrow feature output. */
+    loadTable(signal) {
+        return this.source.getFeatures({
+            ...this.request,
+            format: 'arrow',
+            signal
+        });
+    }
+}
+/** Returns the WGS84 extent of one XYZ tile address. */
+function getWGS84TileBounds(tile) {
+    const scale = 2 ** tile.z;
+    return {
+        minimum: [(tile.x / scale) * 360 - 180, tileYToLatitude(tile.y + 1, scale)],
+        maximum: [((tile.x + 1) / scale) * 360 - 180, tileYToLatitude(tile.y, scale)]
+    };
+}
+/** Converts one XYZ tile row to its WGS84 latitude edge. */
+function tileYToLatitude(tileY, scale) {
+    return (Math.atan(Math.sinh(Math.PI * (1 - (2 * tileY) / scale))) * 180) / Math.PI;
+}
+/** Infers the small semantic-role set useful for vector feature query controls. */
+function inferVectorColumnRoles(columnNames) {
+    return Object.fromEntries(columnNames.map(columnName => [
+        columnName,
+        columnName.toLowerCase() === 'geometry' ? 'geometry' : 'attribute'
+    ]));
+}
+/** Normalizes a single layer name to the service API's list shape. */
+function normalizeLayers(layers) {
+    return Array.isArray(layers) ? layers : [layers];
+}
+/** Clones and freezes a possibly plural layer selection for an immutable physical address. */
+function cloneAndFreezeLayers(layers) {
+    return (Array.isArray(layers) ? Object.freeze([...layers]) : layers);
+}
+/** Waits for a shared cached load while preserving one caller's independent cancellation. */
+async function waitForPromise(promise, signal) {
+    if (!signal) {
+        return await promise;
+    }
+    throwIfAborted(signal);
+    return await new Promise((resolve, reject) => {
+        const abort = () => reject(getAbortReason(signal));
+        signal.addEventListener('abort', abort, { once: true });
+        void promise.then(resolve, reject).finally(() => signal.removeEventListener('abort', abort));
+    });
+}
+/** Throws before physical or residual work begins when cancellation was requested. */
+function throwIfAborted(signal) {
+    if (signal?.aborted) {
+        throw getAbortReason(signal);
+    }
+}
+/** Returns the caller's cancellation reason or a portable AbortError fallback. */
+function getAbortReason(signal) {
+    return signal.reason || new DOMException('Request aborted', 'AbortError');
+}
+//# sourceMappingURL=vector-table-scan-source.js.map

package/dist/vector-table-scan-source.js.map

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

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@loaders.gl/scan",
+  "description": "Optional scan planning and execution for loaders.gl",
+  "version": "5.0.0-alpha.3",
+  "license": "MIT",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/visgl/loaders.gl"
+  },
+  "keywords": [
+    "scan",
+    "arrow",
+    "query",
+    "columnar",
+    "geospatial"
+  ],
+  "types": "dist/index.d.ts",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./iceberg": {
+      "types": "./dist/iceberg.d.ts",
+      "import": "./dist/iceberg.js",
+      "require": "./dist/iceberg.cjs"
+    },
+    "./delta": {
+      "types": "./dist/delta.d.ts",
+      "import": "./dist/delta.js",
+      "require": "./dist/delta.cjs"
+    },
+    "./hudi": {
+      "types": "./dist/hudi.d.ts",
+      "import": "./dist/hudi.js",
+      "require": "./dist/hudi.cjs"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "src",
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "pre-build": "npm run build-bundle && npm run build-bundle -- --env=dev",
+    "build-bundle": "ocular-bundle ./bundle.ts --output=dist/dist.min.js"
+  },
+  "dependencies": {
+    "@loaders.gl/geoarrow": "5.0.0-alpha.3",
+    "@loaders.gl/loader-utils": "5.0.0-alpha.3",
+    "@loaders.gl/parquet": "5.0.0-alpha.3",
+    "@loaders.gl/schema": "5.0.0-alpha.3",
+    "@loaders.gl/schema-utils": "5.0.0-alpha.3",
+    "@loaders.gl/sql": "5.0.0-alpha.3",
+    "apache-arrow": ">= 17.0.0"
+  },
+  "gitHead": "6e6f532b04a2798191ee2d9a932ca73b7c7f3c8d"
+}

package/src/delta.ts

@@ -0,0 +1,18 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+/**
+ * Incubating Delta Lake table-format adapters.
+ *
+ * This entry point is intentionally separate from the scan package root. The adapter remains
+ * backed by the Parquet implementation while its transaction-log and snapshot APIs mature.
+ */
+export {DeltaTableSource, DeltaSourceLoaderWithParser} from '@loaders.gl/parquet/delta-source';
+export {DeltaSourceLoader} from '@loaders.gl/parquet/delta-source-loader-types';
+export type {DeltaSourceLoaderOptions} from '@loaders.gl/parquet/delta-source-loader-types';
+export type {
+  DeltaAction,
+  DeltaScanOptions,
+  DeltaSourceOptions
+} from '@loaders.gl/parquet/delta-types';