@loaders.gl/services 5.0.0-alpha.3

package/dist/arcgis/arcgis-feature-server-source-loader.js

@@ -0,0 +1,228 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { convertFeaturesToWKBArrowTable, convertGeojsonToBinaryFeatureCollection } from '@loaders.gl/gis';
+import { DataSource } from '@loaders.gl/loader-utils';
+import { buildArcGISResourceURL } from "./arcgis-url-utils.js";
+/**
+ * @see https://developers.arcgis.com/rest/services-reference/enterprise/feature-service.htm
+ */
+export const ArcGISFeatureServerSourceLoader = {
+    dataType: null,
+    batchType: null,
+    name: 'ArcGISFeatureServer',
+    id: 'arcgis-feature-server',
+    module: 'services',
+    version: '0.0.0',
+    extensions: [],
+    mimeTypes: [],
+    type: 'arcgis-feature-server',
+    fromUrl: true,
+    fromBlob: false,
+    options: {
+        url: undefined,
+        'arcgis-feature-server': {}
+    },
+    defaultOptions: {
+        url: undefined,
+        'arcgis-feature-server': {}
+    },
+    testURL: (url) => url.toLowerCase().includes('featureserver'),
+    createDataSource: (url, options, coreApi) => new ArcGISVectorSource(url, options, coreApi)
+};
+/**
+ * ArcGIS FeatureServer
+ * Note - exports a big API, that could be exposed here if there is a use case
+ * @see https://developers.arcgis.com/rest/services-reference/enterprise/feature-service.htm
+ */
+export class ArcGISVectorSource extends DataSource {
+    /** Cached ArcGIS FeatureServer metadata request. */
+    formatSpecificMetadata = null;
+    constructor(url, options, coreApi) {
+        super(url, options, ArcGISFeatureServerSourceLoader.defaultOptions, coreApi);
+    }
+    /** Returns a schema inferred from ArcGIS FeatureServer metadata fields. */
+    async getSchema() {
+        const metadata = await this.getFormatSpecificMetadata();
+        return parseArcGISFeatureServerSchema(metadata);
+    }
+    /** Returns normalized VectorSource metadata. */
+    async getMetadata(options = {}) {
+        // Wait for raw metadata to load
+        const formatSpecificMetadata = await this.getFormatSpecificMetadata();
+        const metadata = parseArcGISFeatureServerMetadata(formatSpecificMetadata);
+        // Only add the big blob of source metadata if explicitly requested
+        if (options.formatSpecificMetadata) {
+            metadata.formatSpecificMetadata = formatSpecificMetadata;
+        }
+        return metadata;
+    }
+    /** Requests features from the ArcGIS FeatureServer query endpoint. */
+    async getFeatures(parameters) {
+        const url = this.getFeaturesURL(parameters);
+        const response = await this.fetch(url, parameters.signal ? { signal: parameters.signal } : undefined);
+        await this.checkResponse(response);
+        const geoJsonTable = parseGeoJSONTable(await response.json());
+        const format = parameters.format || 'arrow';
+        switch (format) {
+            case 'binary':
+                return convertGeojsonToBinaryFeatureCollection(geoJsonTable.features);
+            case 'geojson':
+                return geoJsonTable;
+            case 'arrow':
+            default:
+                return convertFeaturesToWKBArrowTable(geoJsonTable.features);
+        }
+    }
+    /** Requests the raw ArcGIS FeatureServer metadata document. */
+    async _getFormatSpecificMetadata() {
+        // PJSON is formatted by a bit slower than JSON
+        const url = this.metadataURL();
+        const response = await this.fetch(url);
+        await this.checkResponse(response);
+        return await response.json();
+    }
+    /** Loads and caches the raw ArcGIS FeatureServer metadata. */
+    async getFormatSpecificMetadata() {
+        this.formatSpecificMetadata ||= this._getFormatSpecificMetadata();
+        return await this.formatSpecificMetadata;
+    }
+    /** Builds a metadata URL for the ArcGIS FeatureServer endpoint. */
+    metadataURL(options) {
+        return this.getUrl('', { f: 'pjson', ...options?.parameters });
+    }
+    /** Builds a query URL from generic vector source parameters. */
+    getFeaturesURL(parameters) {
+        const defaultParameters = this.options['arcgis-feature-server']?.queryParameters || {};
+        const spatialReference = normalizeArcGISSpatialReference(parameters.crs) || 4326;
+        const queryParameters = {
+            returnGeometry: true,
+            where: '1=1',
+            outFields: '*',
+            outSR: spatialReference,
+            inSR: spatialReference,
+            f: 'geojson',
+            ...defaultParameters
+        };
+        if (parameters.boundingBox) {
+            queryParameters.geometry = [
+                parameters.boundingBox[0][0],
+                parameters.boundingBox[0][1],
+                parameters.boundingBox[1][0],
+                parameters.boundingBox[1][1]
+            ].join(',');
+            queryParameters.geometryType = 'esriGeometryEnvelope';
+            queryParameters.spatialRel ||= 'esriSpatialRelIntersects';
+        }
+        const layer = Array.isArray(parameters.layers) ? parameters.layers[0] : parameters.layers;
+        const isLayerEndpoint = /\/FeatureServer\/\d+\/?(?:\?|$)/i.test(this.url);
+        const resourcePath = isLayerEndpoint || !layer ? 'query' : `${layer}/query`;
+        return this.getUrl(resourcePath, queryParameters);
+    }
+    /** Builds an ArcGIS FeatureServer URL. */
+    getUrl(path, options, extra) {
+        return buildArcGISResourceURL(this.url, path, { ...options, ...extra });
+    }
+    /** Checks an ArcGIS FeatureServer response. */
+    async checkResponse(response) {
+        if (!response.ok) {
+            throw new Error(response.statusText || `ArcGIS FeatureServer request failed: ${response.status}`);
+        }
+    }
+}
+function parseArcGISFeatureServerMetadata(json) {
+    const layers = [];
+    for (const layer of json.layers || []) {
+        const extent = layer.extent;
+        const spatialReference = layer.spatialReference || extent?.spatialReference;
+        layers.push({
+            name: layer.id === undefined ? layer.name : String(layer.id),
+            title: layer.name,
+            crs: getArcGISCoordinateReferenceSystems(spatialReference),
+            boundingBox: normalizeArcGISExtent(extent)
+        });
+    }
+    if (!layers.length && (json.id !== undefined || json.name)) {
+        const extent = json.extent;
+        layers.push({
+            name: json.id === undefined ? json.name : String(json.id),
+            title: json.name,
+            crs: getArcGISCoordinateReferenceSystems(json.spatialReference || extent?.spatialReference),
+            boundingBox: normalizeArcGISExtent(extent)
+        });
+    }
+    return {
+        // version: json.currentVersion || '',
+        title: json.serviceDescription || '',
+        name: json.serviceDescription || '',
+        abstract: json.description || '',
+        keywords: [],
+        // attrribution: json.copyrightText || ''.
+        // crs: 'EPSG:4326',
+        layers
+    };
+}
+/** Normalizes an ArcGIS spatial reference to a one-element CRS list. */
+function getArcGISCoordinateReferenceSystems(spatialReference) {
+    const wellKnownIdentifier = spatialReference?.latestWkid || spatialReference?.wkid;
+    return wellKnownIdentifier ? [`EPSG:${wellKnownIdentifier}`] : undefined;
+}
+/** Normalizes an ArcGIS extent to the loaders.gl two-corner shape. */
+function normalizeArcGISExtent(extent) {
+    return extent && [extent.xmin, extent.ymin, extent.xmax, extent.ymax].every(Number.isFinite)
+        ? [
+            [extent.xmin, extent.ymin],
+            [extent.xmax, extent.ymax]
+        ]
+        : undefined;
+}
+/** Normalizes EPSG-prefixed CRS strings to ArcGIS WKID values. */
+function normalizeArcGISSpatialReference(spatialReference) {
+    if (typeof spatialReference === 'string') {
+        const match = /^EPSG:(\d+)$/i.exec(spatialReference);
+        if (match) {
+            return match[1];
+        }
+    }
+    return spatialReference;
+}
+/** Builds a schema from ArcGIS FeatureServer metadata fields. */
+function parseArcGISFeatureServerSchema(json) {
+    const fields = Array.isArray(json.fields)
+        ? json.fields.map((field) => ({
+            name: field.name,
+            type: getSchemaTypeFromArcGISFieldType(field.type),
+            nullable: field.nullable
+        }))
+        : [];
+    return { metadata: {}, fields };
+}
+/** Maps common ArcGIS field types to loaders.gl schema type strings. */
+function getSchemaTypeFromArcGISFieldType(type) {
+    switch (type) {
+        case 'esriFieldTypeDouble':
+            return 'float64';
+        case 'esriFieldTypeSingle':
+            return 'float32';
+        case 'esriFieldTypeInteger':
+        case 'esriFieldTypeSmallInteger':
+        case 'esriFieldTypeOID':
+            return 'int32';
+        case 'esriFieldTypeDate':
+            return 'timestamp-millisecond';
+        default:
+            return 'utf8';
+    }
+}
+/** Parses a GeoJSON FeatureCollection into the loaders.gl GeoJSON table shape. */
+function parseGeoJSONTable(json) {
+    if (json?.type === 'FeatureCollection' && Array.isArray(json.features)) {
+        return {
+            shape: 'geojson-table',
+            type: 'FeatureCollection',
+            features: json.features
+        };
+    }
+    throw new Error('ArcGIS FeatureServer query did not return a GeoJSON FeatureCollection');
+}
+//# sourceMappingURL=arcgis-feature-server-source-loader.js.map

package/dist/arcgis/arcgis-feature-server-source-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arcgis-feature-server-source-loader.js","sourceRoot":"","sources":["../../src/arcgis/arcgis-feature-server-source-loader.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAGpC,OAAO,EACL,8BAA8B,EAC9B,uCAAuC,EACxC,MAAM,iBAAiB,CAAC;AAUzB,OAAO,EAAC,UAAU,EAAC,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAC,sBAAsB,EAAC,8BAA2B;AAgD1D;;GAEG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,QAAQ,EAAE,IAAqC;IAC/C,SAAS,EAAE,IAAa;IACxB,IAAI,EAAE,qBAAqB;IAC3B,EAAE,EAAE,uBAAuB;IAC3B,MAAM,EAAE,UAAU;IAClB,OAAO,EAAE,OAAO;IAChB,UAAU,EAAE,EAAE;IACd,SAAS,EAAE,EAAE;IACb,IAAI,EAAE,uBAAuB;IAC7B,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,KAAK;IAEf,OAAO,EAAE;QACP,GAAG,EAAE,SAAU;QACf,uBAAuB,EAAE,EAAE;KAC5B;IAED,cAAc,EAAE;QACd,GAAG,EAAE,SAAU;QACf,uBAAuB,EAAE,EAAE;KAC5B;IAED,OAAO,EAAE,CAAC,GAAW,EAAW,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;IAC9E,gBAAgB,EAAE,CAChB,GAAW,EACX,OAA+C,EAC/C,OAAiB,EACG,EAAE,CAAC,IAAI,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC;CACnB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,OAAO,kBACX,SAAQ,UAA0D;IAGlE,oDAAoD;IAC1C,sBAAsB,GAAwB,IAAI,CAAC;IAE7D,YAAY,GAAW,EAAE,OAA+C,EAAE,OAAiB;QACzF,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,+BAA+B,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IAC/E,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,SAAS;QACb,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,yBAAyB,EAAE,CAAC;QACxD,OAAO,8BAA8B,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,gDAAgD;IAChD,KAAK,CAAC,WAAW,CACf,UAA8C,EAAE;QAEhD,gCAAgC;QAChC,MAAM,sBAAsB,GAAG,MAAM,IAAI,CAAC,yBAAyB,EAAE,CAAC;QAEtE,MAAM,QAAQ,GAAG,gCAAgC,CAAC,sBAAsB,CAAC,CAAC;QAE1E,mEAAmE;QACnE,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC;YACnC,QAAQ,CAAC,sBAAsB,GAAG,sBAAsB,CAAC;QAC3D,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,sEAAsE;IACtE,KAAK,CAAC,WAAW,CAAC,UAAiC;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAC/B,GAAG,EACH,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAC,MAAM,EAAE,UAAU,CAAC,MAAM,EAAC,CAAC,CAAC,CAAC,SAAS,CAC5D,CAAC;QACF,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,YAAY,GAAG,iBAAiB,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,IAAI,OAAO,CAAC;QAE5C,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,QAAQ;gBACX,OAAO,uCAAuC,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YACxE,KAAK,SAAS;gBACZ,OAAO,YAAY,CAAC;YACtB,KAAK,OAAO,CAAC;YACb;gBACE,OAAO,8BAA8B,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,+DAA+D;IACrD,KAAK,CAAC,0BAA0B;QACxC,+CAA+C;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,8DAA8D;IACpD,KAAK,CAAC,yBAAyB;QACvC,IAAI,CAAC,sBAAsB,KAAK,IAAI,CAAC,0BAA0B,EAAE,CAAC;QAClE,OAAO,MAAM,IAAI,CAAC,sBAAsB,CAAC;IAC3C,CAAC;IAED,mEAAmE;IACnE,WAAW,CAAC,OAAgD;QAC1D,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAC,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,UAAU,EAAC,CAAC,CAAC;IAC/D,CAAC;IAED,gEAAgE;IAChE,cAAc,CAAC,UAAiC;QAC9C,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,uBAAuB,CAAC,EAAE,eAAe,IAAI,EAAE,CAAC;QACvF,MAAM,gBAAgB,GAAG,+BAA+B,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;QACjF,MAAM,eAAe,GAAqC;YACxD,cAAc,EAAE,IAAI;YACpB,KAAK,EAAE,KAAK;YACZ,SAAS,EAAE,GAAG;YACd,KAAK,EAAE,gBAAgB;YACvB,IAAI,EAAE,gBAAgB;YACtB,CAAC,EAAE,SAAS;YACZ,GAAG,iBAAiB;SACrB,CAAC;QAEF,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;YAC3B,eAAe,CAAC,QAAQ,GAAG;gBACzB,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC5B,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC5B,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC5B,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;aAC7B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACZ,eAAe,CAAC,YAAY,GAAG,sBAAsB,CAAC;YACtD,eAAe,CAAC,UAAU,KAAK,0BAA0B,CAAC;QAC5D,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC;QAC1F,MAAM,eAAe,GAAG,kCAAkC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1E,MAAM,YAAY,GAAG,eAAe,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC;QAC5E,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IACpD,CAAC;IAED,0CAA0C;IAChC,MAAM,CACd,IAAY,EACZ,OAAgC,EAChC,KAA+B;QAE/B,OAAO,sBAAsB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,EAAC,GAAG,OAAO,EAAE,GAAG,KAAK,EAAC,CAAC,CAAC;IACxE,CAAC;IAED,+CAA+C;IACrC,KAAK,CAAC,aAAa,CAAC,QAAkB;QAC9C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,QAAQ,CAAC,UAAU,IAAI,wCAAwC,QAAQ,CAAC,MAAM,EAAE,CACjF,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAED,SAAS,gCAAgC,CAAC,IAAS;IACjD,MAAM,MAAM,GAAmC,EAAE,CAAC;IAClD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC5B,MAAM,gBAAgB,GAAG,KAAK,CAAC,gBAAgB,IAAI,MAAM,EAAE,gBAAgB,CAAC;QAC5E,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5D,KAAK,EAAE,KAAK,CAAC,IAAI;YACjB,GAAG,EAAE,mCAAmC,CAAC,gBAAgB,CAAC;YAC1D,WAAW,EAAE,qBAAqB,CAAC,MAAM,CAAC;SAC3C,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACzD,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,GAAG,EAAE,mCAAmC,CAAC,IAAI,CAAC,gBAAgB,IAAI,MAAM,EAAE,gBAAgB,CAAC;YAC3F,WAAW,EAAE,qBAAqB,CAAC,MAAM,CAAC;SAC3C,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,sCAAsC;QACtC,KAAK,EAAE,IAAI,CAAC,kBAAkB,IAAI,EAAE;QACpC,IAAI,EAAE,IAAI,CAAC,kBAAkB,IAAI,EAAE;QACnC,QAAQ,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;QAChC,QAAQ,EAAE,EAAE;QACZ,0CAA0C;QAC1C,oBAAoB;QACpB,MAAM;KACP,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,SAAS,mCAAmC,CAC1C,gBAAkE;IAElE,MAAM,mBAAmB,GAAG,gBAAgB,EAAE,UAAU,IAAI,gBAAgB,EAAE,IAAI,CAAC;IACnF,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,QAAQ,mBAAmB,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC;AAED,sEAAsE;AACtE,SAAS,qBAAqB,CAC5B,MAAgF;IAEhF,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC1F,CAAC,CAAC;YACE,CAAC,MAAM,CAAC,IAAK,EAAE,MAAM,CAAC,IAAK,CAAC;YAC5B,CAAC,MAAM,CAAC,IAAK,EAAE,MAAM,CAAC,IAAK,CAAC;SAC7B;QACH,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,kEAAkE;AAClE,SAAS,+BAA+B,CACtC,gBAA6C;IAE7C,IAAI,OAAO,gBAAgB,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACrD,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,iEAAiE;AACjE,SAAS,8BAA8B,CAAC,IAAS;IAC/C,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;QACvC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,CAAC;YAC/B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,gCAAgC,CAAC,KAAK,CAAC,IAAI,CAAC;YAClD,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC,CAAC;QACL,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,EAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAC,CAAC;AAChC,CAAC;AAED,wEAAwE;AACxE,SAAS,gCAAgC,CAAC,IAAY;IACpD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,qBAAqB;YACxB,OAAO,SAAS,CAAC;QACnB,KAAK,qBAAqB;YACxB,OAAO,SAAS,CAAC;QACnB,KAAK,sBAAsB,CAAC;QAC5B,KAAK,2BAA2B,CAAC;QACjC,KAAK,kBAAkB;YACrB,OAAO,OAAO,CAAC;QACjB,KAAK,mBAAmB;YACtB,OAAO,uBAAuB,CAAC;QACjC;YACE,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,SAAS,iBAAiB,CAAC,IAAS;IAClC,IAAI,IAAI,EAAE,IAAI,KAAK,mBAAmB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvE,OAAO;YACL,KAAK,EAAE,eAAe;YACtB,IAAI,EAAE,mBAAmB;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;AAC3F,CAAC"}

package/dist/arcgis/arcgis-image-server-source-loader.d.ts

@@ -0,0 +1,96 @@
+import type { ImageType } from '@loaders.gl/images';
+import type { CoreAPI, DataSourceOptions, ImageSourceMetadata, GetImageParameters } from '@loaders.gl/loader-utils';
+import { DataSource, ImageSource } from '@loaders.gl/loader-utils';
+import type { LERCData } from '@loaders.gl/lerc';
+/** Options for the ArcGIS ImageServer source. */
+export type ArcGISImageSourceLoaderProps = DataSourceOptions & {
+    'arcgis-image-server'?: {
+        /** Default ArcGIS exportImage request parameters. */
+        exportImageParameters?: Partial<ArcGISExportImageParameters>;
+    };
+};
+/** Parameters for ArcGIS ImageServer exportImage requests. */
+export type ArcGISExportImageParameters = {
+    /** Bounding box of the requested image. */
+    bbox: [number, number, number, number];
+    /** Spatial reference of the supplied bbox. */
+    bboxSR?: string | number;
+    /** Pixel width of returned image. */
+    width: number;
+    /** Pixel height of returned image. */
+    height: number;
+    /** Spatial reference of the returned image. */
+    imageSR?: string | number;
+    /** Requested image format. */
+    format?: 'jpgpng' | 'png' | 'png8' | 'png24' | 'jpg' | 'bmp' | 'gif' | 'tiff' | 'png32' | 'lerc';
+    /** Requested pixel type. */
+    pixelType?: 'U1' | 'U2' | 'U4' | 'U8' | 'S8' | 'U16' | 'S16' | 'U32' | 'S32' | 'F32' | 'F64';
+    /** NoData pixel value. */
+    noData?: string | number;
+    /** NoData interpretation mode. */
+    noDataInterpretation?: 'esriNoDataMatchAny' | 'esriNoDataMatchAll';
+    /** Resampling interpolation. */
+    interpolation?: string;
+    /** Compression type. */
+    compression?: string;
+    /** Compression quality. */
+    compressionQuality?: number;
+    /** Band ids to export. */
+    bandIds?: string | number[];
+    /** Mosaic rule JSON string or object. */
+    mosaicRule?: string | Record<string, unknown>;
+    /** Rendering rule JSON string or object. */
+    renderingRule?: string | Record<string, unknown>;
+    /** ArcGIS response format. */
+    f?: 'image' | 'json' | 'pjson';
+};
+export declare const ArcGISImageServerSourceLoader: {
+    readonly dataType: ArcGISImageSource;
+    readonly batchType: never;
+    readonly name: "ArcGISImageServer";
+    readonly id: "arcgis-image-server";
+    readonly module: "services";
+    readonly version: "0.0.0";
+    readonly extensions: [];
+    readonly mimeTypes: [];
+    readonly type: "arcgis-image-server";
+    readonly fromUrl: true;
+    readonly fromBlob: false;
+    readonly options: {
+        readonly 'arcgis-image-server': {};
+    };
+    readonly defaultOptions: {
+        readonly 'arcgis-image-server': {};
+    };
+    readonly testURL: (url: string) => boolean;
+    readonly createDataSource: (url: string, props: ArcGISImageSourceLoaderProps, coreApi?: CoreAPI) => ArcGISImageSource;
+};
+/**
+ * ArcGIS ImageServer
+ * Note - exports a big API, that could be exposed here if there is a use case
+ * @see https://developers.arcgis.com/rest/services-reference/enterprise/image-service.htm
+ */
+export declare class ArcGISImageSource extends DataSource<string, ArcGISImageSourceLoaderProps> implements ImageSource {
+    constructor(url: string, props: ArcGISImageSourceLoaderProps, coreApi?: CoreAPI);
+    /** Returns normalized ImageSource metadata. */
+    getMetadata(): Promise<ImageSourceMetadata>;
+    /** Requests an image from generic ImageSource parameters. */
+    getImage(parameters: GetImageParameters): Promise<ImageType>;
+    /** Requests the ArcGIS ImageServer metadata document. */
+    metadata(): Promise<unknown>;
+    /** Requests an exported image from the ArcGIS ImageServer endpoint. */
+    exportImage(options: ArcGISExportImageParameters, signal?: AbortSignal): Promise<ImageType>;
+    /** Requests an analytical LERC raster from the ArcGIS ImageServer endpoint. */
+    exportRaster(options: ArcGISExportImageParameters, signal?: AbortSignal): Promise<LERCData>;
+    /** Builds a metadata URL for the ArcGIS ImageServer endpoint. */
+    metadataURL(options?: {
+        parameters?: Record<string, unknown>;
+    }): string;
+    /** Builds an exportImage URL for the ArcGIS ImageServer endpoint. */
+    exportImageURL(options: ArcGISExportImageParameters): string;
+    /** Builds an ArcGIS ImageServer URL. */
+    protected getUrl(path: string, options: Record<string, unknown>, extra?: Record<string, unknown>): string;
+    /** Checks an ArcGIS ImageServer response. */
+    protected checkResponse(response: Response): Promise<void>;
+}
+//# sourceMappingURL=arcgis-image-server-source-loader.d.ts.map

package/dist/arcgis/arcgis-image-server-source-loader.d.ts.map

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

package/dist/arcgis/arcgis-image-server-source-loader.js

@@ -0,0 +1,143 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { ImageLoader } from '@loaders.gl/images';
+import { DataSource } from '@loaders.gl/loader-utils';
+import { LERCLoader } from '@loaders.gl/lerc';
+import { buildArcGISResourceURL } from "./arcgis-url-utils.js";
+export const ArcGISImageServerSourceLoader = {
+    dataType: null,
+    batchType: null,
+    name: 'ArcGISImageServer',
+    id: 'arcgis-image-server',
+    module: 'services',
+    version: '0.0.0',
+    extensions: [],
+    mimeTypes: [],
+    type: 'arcgis-image-server',
+    fromUrl: true,
+    fromBlob: false,
+    options: {
+        'arcgis-image-server': {
+        // TODO - add options here
+        }
+    },
+    defaultOptions: {
+        'arcgis-image-server': {
+        // TODO - add options here
+        }
+    },
+    testURL: (url) => url.toLowerCase().includes('imageserver'),
+    createDataSource: (url, props, coreApi) => new ArcGISImageSource(url, props, coreApi)
+};
+/**
+ * ArcGIS ImageServer
+ * Note - exports a big API, that could be exposed here if there is a use case
+ * @see https://developers.arcgis.com/rest/services-reference/enterprise/image-service.htm
+ */
+export class ArcGISImageSource extends DataSource {
+    constructor(url, props, coreApi) {
+        super(url, props, ArcGISImageServerSourceLoader.defaultOptions, coreApi);
+    }
+    /** Returns normalized ImageSource metadata. */
+    async getMetadata() {
+        return normalizeArcGISImageServerMetadata(await this.metadata());
+    }
+    /** Requests an image from generic ImageSource parameters. */
+    async getImage(parameters) {
+        const { boundingBox, bbox, width, height, crs, format, signal } = parameters;
+        const spatialReference = normalizeArcGISSpatialReference(crs) || '4326';
+        const imageParameters = {
+            bbox: boundingBox ? [...boundingBox[0], ...boundingBox[1]] : bbox,
+            bboxSR: spatialReference,
+            imageSR: spatialReference,
+            width,
+            height,
+            format: format === 'image/png' ? 'png' : undefined
+        };
+        return await this.exportImage(imageParameters, signal);
+    }
+    /** Requests the ArcGIS ImageServer metadata document. */
+    async metadata() {
+        const response = await this.fetch(this.metadataURL());
+        await this.checkResponse(response);
+        return await response.json();
+    }
+    /** Requests an exported image from the ArcGIS ImageServer endpoint. */
+    async exportImage(options, signal) {
+        const response = await this.fetch(this.exportImageURL(options), signal ? { signal } : undefined);
+        await this.checkResponse(response);
+        const arrayBuffer = await response.arrayBuffer();
+        return (await this.coreApi.parse(arrayBuffer, ImageLoader, this.loadOptions));
+    }
+    /** Requests an analytical LERC raster from the ArcGIS ImageServer endpoint. */
+    async exportRaster(options, signal) {
+        const response = await this.fetch(this.exportImageURL({ ...options, format: 'lerc' }), signal ? { signal } : undefined);
+        await this.checkResponse(response);
+        return (await this.coreApi.parse(await response.arrayBuffer(), LERCLoader, this.loadOptions));
+    }
+    /** Builds a metadata URL for the ArcGIS ImageServer endpoint. */
+    metadataURL(options) {
+        return this.getUrl('', { f: 'pjson', ...options?.parameters });
+    }
+    /** Builds an exportImage URL for the ArcGIS ImageServer endpoint. */
+    exportImageURL(options) {
+        const defaultParameters = this.options['arcgis-image-server']?.exportImageParameters || {};
+        const { width, height, ...parameters } = { ...defaultParameters, ...options };
+        return this.getUrl('exportImage', {
+            ...parameters,
+            bbox: parameters.bbox,
+            size: [width, height],
+            f: parameters.f || 'image'
+        });
+    }
+    /** Builds an ArcGIS ImageServer URL. */
+    getUrl(path, options, extra) {
+        return buildArcGISResourceURL(this.url, path, { ...options, ...extra });
+    }
+    /** Checks an ArcGIS ImageServer response. */
+    async checkResponse(response) {
+        if (!response.ok) {
+            throw new Error(response.statusText || `ArcGIS ImageServer request failed: ${response.status}`);
+        }
+    }
+}
+/** Normalizes EPSG-prefixed CRS strings to ArcGIS WKID values. */
+function normalizeArcGISSpatialReference(spatialReference) {
+    if (typeof spatialReference === 'string') {
+        const match = /^EPSG:(\d+)$/i.exec(spatialReference);
+        if (match) {
+            return match[1];
+        }
+    }
+    return spatialReference;
+}
+/** Normalizes ArcGIS ImageServer metadata to the generic ImageSource metadata shape. */
+function normalizeArcGISImageServerMetadata(metadata) {
+    const arcgisMetadata = metadata;
+    const extent = arcgisMetadata.fullExtent || arcgisMetadata.extent;
+    const spatialReference = arcgisMetadata.spatialReference || extent?.spatialReference;
+    const wellKnownIdentifier = spatialReference?.latestWkid || spatialReference?.wkid;
+    const boundingBox = extent && [extent.xmin, extent.ymin, extent.xmax, extent.ymax].every(Number.isFinite)
+        ? [
+            [extent.xmin, extent.ymin],
+            [extent.xmax, extent.ymax]
+        ]
+        : undefined;
+    const name = arcgisMetadata.name || arcgisMetadata.serviceDescription || '';
+    return {
+        name,
+        title: name,
+        abstract: arcgisMetadata.description || arcgisMetadata.serviceDescription || '',
+        keywords: Array.isArray(arcgisMetadata.keywords) ? arcgisMetadata.keywords : [],
+        layers: [
+            {
+                name,
+                title: name,
+                crs: wellKnownIdentifier ? [`EPSG:${wellKnownIdentifier}`] : undefined,
+                boundingBox
+            }
+        ]
+    };
+}
+//# sourceMappingURL=arcgis-image-server-source-loader.js.map

package/dist/arcgis/arcgis-image-server-source-loader.js.map

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

package/dist/arcgis/arcgis-image-tile-source-loader.d.ts

@@ -0,0 +1,71 @@
+import type { ImageType } from '@loaders.gl/images';
+import type { CoreAPI, DataSourceOptions, GetTileDataParameters, GetTileParameters, TileSource, TileSourceMetadata } from '@loaders.gl/loader-utils';
+import { DataSource } from '@loaders.gl/loader-utils';
+import type { LERCData } from '@loaders.gl/lerc';
+/** Options for the ArcGIS ImageServer tile source. */
+export type ArcGISImageTileSourceLoaderOptions = DataSourceOptions & {
+    'arcgis-image-server-tiles'?: {
+        /** Tile size used for exportImage requests. */
+        tileSize?: number;
+        /** Optional service URL pool for simple request distribution. */
+        urls?: string[];
+        /** Additional exportImage parameters. */
+        parameters?: Record<string, string | number | boolean>;
+        /** Response format, using LERC for analytical raster tiles. */
+        format?: 'png32' | 'lerc';
+    };
+};
+/** A tile source that renders ArcGIS ImageServer exports as deck.gl tiles. */
+export declare class ArcGISImageTileSource extends DataSource<string, ArcGISImageTileSourceLoaderOptions> implements TileSource {
+    /** MIME type represented by the tile response. */
+    readonly mimeType: string;
+    /** Cached ImageServer metadata. */
+    private _metadata;
+    /** In-flight metadata request shared by concurrent callers. */
+    private _metadataPromise;
+    /** Parameters applied to subsequent export requests. */
+    private _runtimeParameters;
+    /** Creates an ArcGIS ImageServer tile source. */
+    constructor(url: string, options?: ArcGISImageTileSourceLoaderOptions, coreApi?: CoreAPI);
+    /** Returns normalized ImageServer metadata. */
+    getMetadata(): Promise<TileSourceMetadata>;
+    /** Fetches one ImageServer export tile. */
+    getTile(parameters: GetTileParameters, signal?: AbortSignal): Promise<ImageType | LERCData | null>;
+    /** Fetches a tile using the deck.gl-compatible request shape. */
+    getTileData(parameters: GetTileDataParameters): Promise<ImageType | LERCData | null>;
+    /** Updates parameters applied to subsequent ImageServer export requests. */
+    updateParameters(parameters: Record<string, string | number | boolean>): void;
+    /** Builds an ImageServer exportImage URL for one web-mercator tile. */
+    getTileURL(parameters: GetTileParameters, tileSize?: number): string;
+    /** Fetches the ImageServer metadata document. */
+    private _loadMetadata;
+    /** Returns cached metadata and shares a single request among concurrent callers. */
+    private _getMetadata;
+    /** Selects a service endpoint for a tile using a stable URL-pool mapping. */
+    private getServiceURL;
+    /** Returns the response format after applying configured and runtime overrides. */
+    private _getResponseFormat;
+}
+/** Source loader for ArcGIS ImageServer export tiles. */
+export declare const ArcGISImageTileSourceLoader: {
+    readonly dataType: ArcGISImageTileSource;
+    readonly batchType: never;
+    readonly name: "ArcGIS ImageServer tiles";
+    readonly id: "arcgis-image-server-tiles";
+    readonly module: "services";
+    readonly version: "0.0.0";
+    readonly extensions: [];
+    readonly mimeTypes: [];
+    readonly type: "arcgis-image-server-tiles";
+    readonly fromUrl: true;
+    readonly fromBlob: false;
+    readonly options: {
+        readonly 'arcgis-image-server-tiles': {};
+    };
+    readonly defaultOptions: {
+        readonly 'arcgis-image-server-tiles': {};
+    };
+    readonly testURL: (url: string) => boolean;
+    readonly createDataSource: (url: string, options?: ArcGISImageTileSourceLoaderOptions, coreApi?: CoreAPI) => ArcGISImageTileSource;
+};
+//# sourceMappingURL=arcgis-image-tile-source-loader.d.ts.map

package/dist/arcgis/arcgis-image-tile-source-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arcgis-image-tile-source-loader.d.ts","sourceRoot":"","sources":["../../src/arcgis/arcgis-image-tile-source-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EACV,OAAO,EACP,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EAEjB,UAAU,EACV,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAC,UAAU,EAAC,MAAM,0BAA0B,CAAC;AACpD,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAG/C,sDAAsD;AACtD,MAAM,MAAM,kCAAkC,GAAG,iBAAiB,GAAG;IACnE,2BAA2B,CAAC,EAAE;QAC5B,+CAA+C;QAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,iEAAiE;QACjE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,yCAAyC;QACzC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;QACvD,+DAA+D;QAC/D,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;KAC3B,CAAC;CACH,CAAC;AAEF,8EAA8E;AAC9E,qBAAa,qBACX,SAAQ,UAAU,CAAC,MAAM,EAAE,kCAAkC,CAC7D,YAAW,UAAU;IAErB,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,mCAAmC;IACnC,OAAO,CAAC,SAAS,CAAoB;IACrC,+DAA+D;IAC/D,OAAO,CAAC,gBAAgB,CAA6B;IACrD,wDAAwD;IACxD,OAAO,CAAC,kBAAkB,CAAiD;IAE3E,iDAAiD;gBACrC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,kCAAuC,EAAE,OAAO,CAAC,EAAE,OAAO;IAM5F,+CAA+C;IACzC,WAAW,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAuBhD,2CAA2C;IACrC,OAAO,CACX,UAAU,EAAE,iBAAiB,EAC7B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC;IAevC,iEAAiE;IAC3D,WAAW,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC;IAI1F,4EAA4E;IAC5E,gBAAgB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI;IAI7E,uEAAuE;IACvE,UAAU,CAAC,UAAU,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAuBpE,iDAAiD;YACnC,aAAa;IAU3B,oFAAoF;YACtE,YAAY;IAc1B,6EAA6E;IAC7E,OAAO,CAAC,aAAa;IAKrB,mFAAmF;IACnF,OAAO,CAAC,kBAAkB;CAK3B;AAED,yDAAyD;AACzD,eAAO,MAAM,2BAA2B;uBACT,qBAAqB;wBAC/B,KAAK;;;;;;;;;;;;;;;;4BAYT,MAAM,KAAG,OAAO;qCAExB,MAAM,YACF,kCAAkC,YACjC,OAAO;CAEmC,CAAC"}