@loaders.gl/arcgis 5.0.0-alpha.8

package/README.md

@@ -0,0 +1,26 @@
+# @loaders.gl/arcgis
+
+Framework-independent ArcGIS REST data sources for geospatial visualization.
+
+```ts
+import {load} from '@loaders.gl/core';
+import {ArcGISFeatureServerSourceLoader} from '@loaders.gl/arcgis';
+
+const source = await load(featureLayerUrl, ArcGISFeatureServerSourceLoader);
+const features = await source.getFeatures({format: 'geojson'});
+```
+
+Import lightweight service loaders from `@loaders.gl/arcgis`. Authentication and discovery helpers
+have dedicated `/authentication` and `/discovery` entrypoints.
+Async `load()` and deck.gl `SourceLayer` import the selected service implementation on demand.
+For synchronous `createDataSource()` or direct source classes, import the same names from
+`@loaders.gl/arcgis/bundled`. Service requests remain asynchronous.
+
+FeatureServer, MapServer, ImageServer, VectorTileServer and SceneServer adapters implement specific
+read operations, not full ArcGIS API parity. Feature queries currently issue one request; automatic
+paging is not implemented. ImageServer tiles use dynamic exports, not native cached tiles.
+
+- [Developer guide](https://loaders.gl/docs/developer-guide/arcgis)
+- [Service inventory and limitations](https://loaders.gl/docs/modules/arcgis/services)
+- [Authentication](https://loaders.gl/docs/developer-guide/arcgis/authentication)
+- [Examples](https://loaders.gl/examples/arcgis)

package/dist/arcgis/arcgis-capability-graph.d.ts

@@ -0,0 +1,50 @@
+export { getArcGISServices } from "./arcgis-server.js";
+export type { Service as ArcGISService } from "./arcgis-server.js";
+import type { ServiceCapabilities } from '@loaders.gl/loader-utils';
+import type { Service as ArcGISService } from "./arcgis-server.js";
+/** Normalized capabilities discovered from one ArcGIS REST service. */
+export type ArcGISServiceCapabilities = ArcGISService & {
+    /** Stable identifier for the discovered service. */
+    id: string;
+    /** Broad service family used for selection. */
+    kind: 'vector' | 'image' | 'tile' | 'scene' | 'unknown';
+    /** Shared normalized service capability contract. */
+    capabilities: ServiceCapabilities;
+    /** Raw service metadata for provider-specific consumers. */
+    metadata: Record<string, unknown>;
+};
+/** A normalized graph of services discovered below an ArcGIS REST directory. */
+export type ArcGISCapabilityGraph = {
+    /** URL used as the discovery root. */
+    rootUrl: string;
+    /** Services discovered below the root, including normalized capabilities. */
+    nodes: ArcGISServiceCapabilities[];
+};
+/** Requirements used to select the best matching service node. */
+export type ArcGISServiceSelection = {
+    /** Preferred service family. */
+    kind?: ArcGISServiceCapabilities['kind'];
+    /** Required response or source format. */
+    format?: string;
+    /** Preferred coordinate system. */
+    crs?: string;
+    /** Required I3S layer profile for SceneServer nodes. */
+    profile?: string;
+    /** Required layer identifier for SceneServer nodes. */
+    layerId?: string | number;
+};
+/** Options controlling ArcGIS capability discovery. */
+export type ArcGISCapabilityGraphOptions = {
+    /** Optional fetch implementation for hermetic tests and custom transports. */
+    fetch?: typeof fetch;
+};
+/**
+ * Discovers an ArcGIS REST directory and normalizes the capabilities of each service.
+ *
+ * Capability requests are explicit and independent from source loading. Applications that
+ * already know the endpoint can continue using the source classes directly.
+ */
+export declare function discoverArcGISCapabilities(url: string, options?: ArcGISCapabilityGraphOptions): Promise<ArcGISCapabilityGraph | null>;
+/** Selects the first service satisfying all supplied requirements. */
+export declare function selectArcGISService(graph: ArcGISCapabilityGraph, requirements?: ArcGISServiceSelection): ArcGISServiceCapabilities | undefined;
+//# sourceMappingURL=arcgis-capability-graph.d.ts.map

package/dist/arcgis/arcgis-capability-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arcgis-capability-graph.d.ts","sourceRoot":"","sources":["../../src/arcgis/arcgis-capability-graph.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,iBAAiB,EAAC,2BAAwB;AAClD,YAAY,EAAC,OAAO,IAAI,aAAa,EAAC,2BAAwB;AAC9D,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAC,OAAO,IAAI,aAAa,EAAC,2BAAwB;AAE9D,uEAAuE;AACvE,MAAM,MAAM,yBAAyB,GAAG,aAAa,GAAG;IACtD,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACxD,qDAAqD;IACrD,YAAY,EAAE,mBAAmB,CAAC;IAClC,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF,gFAAgF;AAChF,MAAM,MAAM,qBAAqB,GAAG;IAClC,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,KAAK,EAAE,yBAAyB,EAAE,CAAC;CACpC,CAAC;AAEF,kEAAkE;AAClE,MAAM,MAAM,sBAAsB,GAAG;IACnC,gCAAgC;IAChC,IAAI,CAAC,EAAE,yBAAyB,CAAC,MAAM,CAAC,CAAC;IACzC,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B,CAAC;AAEF,uDAAuD;AACvD,MAAM,MAAM,4BAA4B,GAAG;IACzC,8EAA8E;IAC9E,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAgBvC;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,qBAAqB,EAC5B,YAAY,GAAE,sBAA2B,GACxC,yBAAyB,GAAG,SAAS,CAyBvC"}

package/dist/arcgis/arcgis-capability-graph.js

@@ -0,0 +1,221 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { getArcGISServices } from "./arcgis-server.js";
+export { getArcGISServices } from "./arcgis-server.js";
+/**
+ * Discovers an ArcGIS REST directory and normalizes the capabilities of each service.
+ *
+ * Capability requests are explicit and independent from source loading. Applications that
+ * already know the endpoint can continue using the source classes directly.
+ */
+export async function discoverArcGISCapabilities(url, options = {}) {
+    const fetchFile = options.fetch || fetch;
+    const services = await getArcGISServices(url, fetchFile);
+    if (!services)
+        return null;
+    const nodes = await Promise.all(services.map(async (service) => {
+        let metadata = await fetchServiceMetadata(service.url, fetchFile);
+        if (service.type.toLowerCase().includes('scene')) {
+            metadata = await enrichSceneServerMetadata(service.url, metadata, fetchFile);
+        }
+        return normalizeServiceCapabilities(service, metadata);
+    }));
+    return { rootUrl: url, nodes };
+}
+/** Selects the first service satisfying all supplied requirements. */
+export function selectArcGISService(graph, requirements = {}) {
+    return graph.nodes.find(node => {
+        if (requirements.kind && node.kind !== requirements.kind)
+            return false;
+        if (requirements.format &&
+            !node.capabilities.formats.includes(requirements.format.toLowerCase()))
+            return false;
+        if (requirements.crs && !node.capabilities.crs.includes(requirements.crs))
+            return false;
+        if (requirements.profile &&
+            node.metadata.profile !== requirements.profile &&
+            !node.capabilities.layers.some(layer => layer.profile === requirements.profile))
+            return false;
+        if (requirements.layerId !== undefined &&
+            !node.capabilities.layers.some(layer => layer.id === String(requirements.layerId) || layer.name === String(requirements.layerId)))
+            return false;
+        return true;
+    });
+}
+/** Fetches one service's provider-specific metadata document. */
+async function fetchServiceMetadata(serviceUrl, fetchFile) {
+    const url = new URL(serviceUrl);
+    url.searchParams.set('f', 'pjson');
+    const response = await fetchFile(url.toString());
+    if (!response.ok) {
+        throw new Error(`ArcGIS service metadata request failed: ${response.status}`);
+    }
+    return (await response.json());
+}
+/** Fetches layer documents so SceneServer profile selection uses authoritative store metadata. */
+async function enrichSceneServerMetadata(serviceUrl, metadata, fetchFile) {
+    const layers = Array.isArray(metadata.layers) ? metadata.layers : [];
+    if (!layers.length)
+        return metadata;
+    const enrichedLayers = await Promise.all(layers.map(async (value) => {
+        if (!value || typeof value !== 'object')
+            return value;
+        const layer = value;
+        if (layer.id === undefined)
+            return value;
+        const layerURL = `${serviceUrl.replace(/\/$/, '')}/layers/${encodeURIComponent(String(layer.id))}`;
+        try {
+            const layerMetadata = await fetchServiceMetadata(layerURL, fetchFile);
+            return { ...layer, ...layerMetadata, id: layer.id, name: layer.name ?? layerMetadata.name };
+        }
+        catch {
+            // Keep directory metadata when an individual layer is unavailable.
+            return value;
+        }
+    }));
+    return { ...metadata, layers: enrichedLayers };
+}
+/** Combines directory information and metadata into a normalized capability node. */
+function normalizeServiceCapabilities(service, metadata) {
+    const serviceType = service.type;
+    const kind = getServiceKind(serviceType);
+    const formats = getServiceFormats(metadata);
+    const crs = getServiceCrs(metadata);
+    const layers = getServiceLayers(metadata).map(layer => ({
+        ...layer,
+        url: layer.url ||
+            (serviceType.includes('scene') && layer.id
+                ? `${service.url.replace(/\/$/, '')}/layers/${encodeURIComponent(layer.id)}`
+                : undefined)
+    }));
+    const capabilities = {
+        url: service.url,
+        type: getServiceCapabilityType(serviceType),
+        name: service.name,
+        title: typeof metadata.name === 'string' ? metadata.name : undefined,
+        abstract: typeof metadata.description === 'string' ? metadata.description : undefined,
+        crs,
+        formats,
+        layers,
+        operations: getServiceOperations(metadata),
+        formatSpecificMetadata: metadata
+    };
+    return {
+        ...service,
+        id: service.url,
+        kind,
+        capabilities,
+        metadata
+    };
+}
+/** Extracts normalized layer entries from SceneServer and other service metadata. */
+function getServiceLayers(metadata) {
+    const layerValues = Array.isArray(metadata.layers) ? metadata.layers : [];
+    return layerValues.flatMap(value => {
+        if (!value || typeof value !== 'object')
+            return [];
+        const layer = value;
+        const spatialReference = layer.spatialReference;
+        const wkid = spatialReference?.latestWkid || spatialReference?.wkid;
+        const extent = layer.extent;
+        const bounds = extent && [extent.xmin, extent.ymin, extent.xmax, extent.ymax].every(Number.isFinite)
+            ? [extent.xmin, extent.ymin, extent.xmax, extent.ymax]
+            : undefined;
+        return [
+            {
+                name: layer.id === undefined ? String(layer.name || '') : String(layer.id),
+                id: layer.id === undefined ? undefined : String(layer.id),
+                url: typeof layer.url === 'string' ? layer.url : undefined,
+                title: typeof layer.name === 'string' ? layer.name : undefined,
+                crs: wkid ? [`EPSG:${wkid}`] : undefined,
+                bounds,
+                profile: typeof layer.profile === 'string'
+                    ? layer.profile
+                    : layer.store &&
+                        typeof layer.store === 'object' &&
+                        typeof layer.store.profile === 'string'
+                        ? layer.store.profile
+                        : undefined,
+                layerType: typeof layer.layerType === 'string' ? layer.layerType : undefined,
+                version: typeof layer.version === 'string'
+                    ? layer.version
+                    : layer.store &&
+                        typeof layer.store === 'object' &&
+                        typeof layer.store.version === 'string'
+                        ? layer.store.version
+                        : undefined
+            }
+        ];
+    });
+}
+/** Extracts operation names when a service advertises them. */
+function getServiceOperations(metadata) {
+    const capabilities = metadata.capabilities;
+    return typeof capabilities === 'string'
+        ? capabilities
+            .split(',')
+            .map(value => value.trim())
+            .filter(Boolean)
+        : [];
+}
+/** Maps a discovered ArcGIS family to the shared service capability type. */
+function getServiceCapabilityType(serviceType) {
+    if (serviceType.includes('vectortile') || serviceType.includes('vector-tile')) {
+        return 'arcgis-vector-tile-server';
+    }
+    if (serviceType.includes('feature'))
+        return 'arcgis-feature-server';
+    if (serviceType.includes('image'))
+        return 'arcgis-image-server';
+    if (serviceType.includes('scene'))
+        return 'arcgis-scene-server';
+    if (serviceType.includes('map'))
+        return 'arcgis-map-server';
+    return 'unknown';
+}
+/** Maps an ArcGIS service type to the generic source family. */
+function getServiceKind(serviceType) {
+    if (serviceType.includes('feature'))
+        return 'vector';
+    if (serviceType.includes('image'))
+        return 'image';
+    if (serviceType.includes('scene'))
+        return 'scene';
+    if (serviceType.includes('map') ||
+        serviceType.includes('vectortile') ||
+        serviceType.includes('vector-tile'))
+        return 'tile';
+    return 'unknown';
+}
+/** Extracts and canonicalizes formats advertised by an ArcGIS service. */
+function getServiceFormats(metadata) {
+    const formats = new Set();
+    const supportedFormats = metadata.supportedQueryFormats;
+    if (typeof supportedFormats === 'string') {
+        for (const format of supportedFormats.split(','))
+            formats.add(format.trim().toLowerCase());
+    }
+    const imageFormats = metadata.supportedImageFormatTypes;
+    if (typeof imageFormats === 'string') {
+        for (const format of imageFormats.split(','))
+            formats.add(format.trim().toLowerCase());
+    }
+    const tileInfo = metadata.tileInfo;
+    if (typeof tileInfo?.format === 'string')
+        formats.add(tileInfo.format.toLowerCase());
+    return [...formats].sort();
+}
+/** Extracts unique EPSG identifiers from common ArcGIS metadata locations. */
+function getServiceCrs(metadata) {
+    const spatialReferences = new Set();
+    for (const value of [metadata.spatialReference, metadata.fullExtent?.spatialReference]) {
+        const spatialReference = value;
+        for (const wkid of [spatialReference?.wkid, spatialReference?.latestWkid]) {
+            if (wkid)
+                spatialReferences.add(`EPSG:${wkid}`);
+        }
+    }
+    return [...spatialReferences].sort();
+}
+//# sourceMappingURL=arcgis-capability-graph.js.map

package/dist/arcgis/arcgis-capability-graph.js.map

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

package/dist/arcgis/arcgis-feature-query.d.ts

@@ -0,0 +1,53 @@
+import type { ArcGISFeatureExtent, ArcGISFeatureObjectIds, ArcGISFeatureQueryOptions, ArcGISFeatureQueryResult } from "../arcgis-feature-query-types.js";
+/** An HTTP or ArcGIS JSON error, without retaining a credential-bearing request URL. */
+export declare class ArcGISFeatureQueryError extends Error {
+    /** ArcGIS error code, or HTTP status when the response has no ArcGIS error. */
+    readonly code: number;
+    /** Additional service diagnostics. */
+    readonly details: string[];
+    /** Creates a structured service error. */
+    constructor(message: string, code: number, details?: string[]);
+}
+/** Fetch signature shared by source transport and the query client. */
+type QueryFetch = (url: string, options?: RequestInit) => Promise<Response>;
+/** Internal query client shared by FeatureServer and MapServer layer endpoints. */
+export declare class ArcGISFeatureQueryClient {
+    /** Layer URL, including caller-supplied authentication parameters. */
+    readonly url: string;
+    /** Authenticated source transport. */
+    readonly fetch: QueryFetch;
+    /** Filter parameters shared by counts, IDs and data requests. */
+    readonly parameters: Record<string, unknown>;
+    /** Signal applied to metadata and every subsequent request. */
+    readonly signal?: AbortSignal | undefined;
+    /** Creates a query client with one selected layer and normalized filters. */
+    constructor(
+    /** Layer URL, including caller-supplied authentication parameters. */
+    url: string, 
+    /** Authenticated source transport. */
+    fetch: QueryFetch, 
+    /** Filter parameters shared by counts, IDs and data requests. */
+    parameters: Record<string, unknown>, 
+    /** Signal applied to metadata and every subsequent request. */
+    signal?: AbortSignal | undefined);
+    /** Reads JSON while recognizing ArcGIS errors even on HTTP 200 responses. */
+    request(path: string, parameters?: Record<string, unknown>): Promise<any>;
+    /** Returns the count for the same filters used by data retrieval. */
+    getCount(): Promise<number>;
+    /** Returns unique object IDs and preserves explicit truncation information. */
+    getObjectIds(): Promise<ArcGISFeatureObjectIds>;
+    /** Requests an extent while retaining its spatial reference. */
+    getExtent(): Promise<ArcGISFeatureExtent>;
+    /** Reads layer metadata and rejects response formats this client cannot safely interpret. */
+    getMetadata(): Promise<any>;
+    /** Reads one page without implying that it represents a complete query. */
+    getPage(options: ArcGISFeatureQueryOptions): Promise<ArcGISFeatureQueryResult>;
+    /** Streams bounded pages and assesses completeness using the initial count and stable IDs. */
+    getPages(options: ArcGISFeatureQueryOptions): AsyncGenerator<ArcGISFeatureQueryResult>;
+    /** Removes data-only controls from a count, IDs or extent request. */
+    private getSummaryParameters;
+    /** Normalizes GeoJSON or nonspatial ArcGIS records without discarding null attributes. */
+    private readPage;
+}
+export {};
+//# sourceMappingURL=arcgis-feature-query.d.ts.map

package/dist/arcgis/arcgis-feature-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arcgis-feature-query.d.ts","sourceRoot":"","sources":["../../src/arcgis/arcgis-feature-query.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACtB,yBAAyB,EAEzB,wBAAwB,EACzB,yCAAsC;AAGvC,wFAAwF;AACxF,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAE3B,0CAA0C;gBAC9B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,EAAO;CAMlE;AAED,uEAAuE;AACvE,KAAK,UAAU,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE5E,mFAAmF;AACnF,qBAAa,wBAAwB;IAGjC,sEAAsE;IACtE,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,UAAU;IAC1B,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5C,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW;IAT/B,6EAA6E;;IAE3E,sEAAsE;IAC7D,GAAG,EAAE,MAAM;IACpB,sCAAsC;IAC7B,KAAK,EAAE,UAAU;IAC1B,iEAAiE;IACxD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5C,+DAA+D;IACtD,MAAM,CAAC,EAAE,WAAW,YAAA;IAG/B,6EAA6E;IACvE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAyCnF,qEAAqE;IAC/D,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAQjC,+EAA+E;IACzE,YAAY,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAarD,gEAAgE;IAC1D,SAAS,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAa/C,6FAA6F;IACvF,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC;IAuBjC,2EAA2E;IACrE,OAAO,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAwBpF,8FAA8F;IACvF,QAAQ,CAAC,OAAO,EAAE,yBAAyB,GAAG,cAAc,CAAC,wBAAwB,CAAC;IAgL7F,sEAAsE;IACtE,OAAO,CAAC,oBAAoB;IAgB5B,0FAA0F;YAC5E,QAAQ;CAyCvB"}