@loaders.gl/arcgis 5.0.0-alpha.10

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

@@ -0,0 +1,280 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { ArcGISAuthentication } from "../authentication.js";
+import { ARCGIS_FEATURE_SERVER_SOURCE_LOADER_METADATA } from "../arcgis-source-types.js";
+import { convertFeaturesToWKBArrowTable, convertGeojsonToBinaryFeatureCollection } from '@loaders.gl/gis';
+import { DataSource } from '@loaders.gl/loader-utils';
+import { buildArcGISResourceURL } from "./arcgis-url-utils.js";
+import { ArcGISFeatureQueryClient } from "./arcgis-feature-query.js";
+export { ArcGISFeatureQueryError } from "./arcgis-feature-query.js";
+/** Runtime service loader for synchronous construction. */
+export const ArcGISFeatureServerSourceLoaderWithParser = {
+    ...ARCGIS_FEATURE_SERVER_SOURCE_LOADER_METADATA,
+    dataType: null,
+    batchType: null,
+    preload: undefined,
+    /** Supplies ArcGIS credentials after loading the selected implementation. */
+    getAuthentications: () => [ArcGISAuthentication],
+    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;
+    /** Creates a query source for a FeatureServer or queryable MapServer layer. */
+    constructor(url, options, coreApi) {
+        super(url, options, ARCGIS_FEATURE_SERVER_SOURCE_LOADER_METADATA.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;
+    }
+    /** Retrieves the complete filtered query, rejecting partial results before format conversion. */
+    async getFeatures(parameters) {
+        const result = await this.queryFeatures(parameters);
+        if (!result.complete) {
+            throw new Error(`Incomplete ArcGIS query (${result.reason}): ${result.loaded}/${result.expectedCount}. Use queryFeatures() to inspect partial results.`);
+        }
+        const features = result.data.features;
+        switch (parameters.format || 'arrow') {
+            case 'binary':
+                if (features.some(feature => !feature.geometry)) {
+                    throw new Error('Binary output cannot retain null geometries; use geojson or arrow');
+                }
+                return convertGeojsonToBinaryFeatureCollection(features);
+            case 'geojson':
+                return result.data;
+            default:
+                return convertFeaturesToWKBArrowTable(features, {
+                    encodingPreference: parameters.geoarrow?.encodingPreference
+                });
+        }
+    }
+    /** Collects a bounded query and returns explicit completeness evidence alongside its data. */
+    async queryFeatures(parameters = {}) {
+        let result;
+        const features = [];
+        for await (const page of this.queryFeaturePages(parameters)) {
+            for (const feature of page.data.features)
+                features.push(feature);
+            result = page;
+        }
+        return { ...result, data: { shape: 'geojson-table', type: 'FeatureCollection', features } };
+    }
+    /** Streams unique records with cumulative progress; breaking iteration stops subsequent work. */
+    queryFeaturePages(parameters = {}) {
+        return this.createQueryClient(parameters).getPages(parameters);
+    }
+    /** Requests one page, explicitly marked incomplete regardless of the server transfer flag. */
+    queryFeaturePage(parameters = {}) {
+        return this.createQueryClient(parameters).getPage(parameters);
+    }
+    /** Returns the current count for the selected query filters. */
+    queryCount(parameters = {}) {
+        return this.createQueryClient(parameters).getCount();
+    }
+    /** Returns object IDs with truncation information; use queryFeatures() for complete retrieval. */
+    queryObjectIds(parameters = {}) {
+        return this.createQueryClient(parameters).getObjectIds();
+    }
+    /** Returns query bounds and their explicit spatial reference. */
+    queryExtent(parameters = {}) {
+        return this.createQueryClient(parameters).getExtent();
+    }
+    /** Shares transport and query filters across summary and data operations. */
+    createQueryClient(parameters) {
+        return new ArcGISFeatureQueryClient(this.getLayerURL(parameters), this.fetch.bind(this), this.getQueryParameters(parameters), parameters.signal);
+    }
+    /** Requests the raw ArcGIS FeatureServer metadata document. */
+    async _getFormatSpecificMetadata() {
+        // PJSON is formatted by a bit slower than JSON
+        const url = this.metadataURL();
+        return await new ArcGISFeatureQueryClient(url, this.fetch.bind(this), {}).request('');
+    }
+    /** Loads and caches the raw ArcGIS FeatureServer metadata. */
+    async getFormatSpecificMetadata() {
+        this.formatSpecificMetadata ||= this._getFormatSpecificMetadata().catch(error => {
+            this.formatSpecificMetadata = null;
+            throw error;
+        });
+        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) {
+        return buildArcGISResourceURL(this.getLayerURL(parameters), 'query', this.getQueryParameters(parameters));
+    }
+    /** Selects exactly one layer; service roots must not silently query an unspecified layer. */
+    getLayerURL(parameters) {
+        const url = new URL(this.url);
+        const layerIdentifiers = Array.isArray(parameters.layers)
+            ? parameters.layers
+            : parameters.layers === undefined
+                ? []
+                : [parameters.layers];
+        if (layerIdentifiers.length > 1)
+            throw new Error('ArcGIS feature queries require exactly one layer');
+        const match = /\/(?:FeatureServer|MapServer)(?:\/(\d+))?\/?$/i.exec(url.pathname);
+        if (!match)
+            throw new Error('Expected an ArcGIS FeatureServer or MapServer layer URL');
+        const layer = layerIdentifiers[0];
+        if (match[1]) {
+            if (layer !== undefined && String(layer) !== match[1])
+                throw new Error('Layer selection conflicts with the endpoint URL');
+            return url.toString();
+        }
+        if (layer === undefined || !/^\d+$/.test(String(layer)))
+            throw new Error('Select a layer ID when querying an ArcGIS service root');
+        return buildArcGISResourceURL(this.url, String(layer), {});
+    }
+    /** Applies source defaults and per-request filters consistently across all query operations. */
+    getQueryParameters(parameters) {
+        const defaultParameters = this.options['arcgis-feature-server']?.queryParameters || {};
+        const outputSpatialReference = normalizeArcGISSpatialReference(parameters.crs) || 4326;
+        const requestSpatialReference = normalizeArcGISSpatialReference(parameters.requestCrs) || outputSpatialReference;
+        const queryParameters = {
+            returnGeometry: true,
+            where: '1=1',
+            outFields: '*',
+            outSR: outputSpatialReference,
+            inSR: requestSpatialReference,
+            f: 'geojson',
+            ...defaultParameters,
+            ...parameters.query
+        };
+        if (parameters.crs !== undefined)
+            queryParameters.outSR = outputSpatialReference;
+        if (parameters.requestCrs !== undefined)
+            queryParameters.inSR = requestSpatialReference;
+        if (parameters.boundingBox) {
+            const coordinates = parameters.boundingBox.flat();
+            if (!coordinates.every(Number.isFinite) ||
+                coordinates[0] > coordinates[2] ||
+                coordinates[1] > coordinates[3]) {
+                throw new Error('ArcGIS boundingBox must contain finite ordered coordinates; split antimeridian queries');
+            }
+            queryParameters.geometry = coordinates.join(',');
+            queryParameters.geometryType = 'esriGeometryEnvelope';
+            queryParameters.spatialRel ||= 'esriSpatialRelIntersects';
+        }
+        return queryParameters;
+    }
+    /** Builds an ArcGIS FeatureServer URL. */
+    getUrl(path, options, extra) {
+        return buildArcGISResourceURL(this.url, path, { ...options, ...extra });
+    }
+}
+/** Normalizes layer and nonspatial table metadata. */
+function parseArcGISFeatureServerMetadata(json) {
+    const layers = [];
+    for (const layer of [...(json.layers || []), ...(json.tables || [])]) {
+        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];
+        }
+    }
+    if (spatialReference !== undefined && !/^\d+$/.test(String(spatialReference))) {
+        throw new Error('ArcGIS query CRS must be a numeric WKID or EPSG identifier');
+    }
+    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: field.type === 'esriFieldTypeOID' && field.length === 8
+                ? 'int64'
+                : 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 'esriFieldTypeSmallInteger':
+            return 'int16';
+        case 'esriFieldTypeBigInteger':
+            return 'int64';
+        case 'esriFieldTypeInteger':
+        case 'esriFieldTypeOID':
+            return 'int32';
+        case 'esriFieldTypeDate':
+            return 'timestamp-millisecond';
+        default:
+            return 'utf8';
+    }
+}
+//# 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":"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"}

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

@@ -0,0 +1,31 @@
+import type { CoreAPI, SourceLoader } from '@loaders.gl/loader-utils';
+import type { ArcGISImageSource } from "./arcgis-image-server-source-loader.js";
+import type { ArcGISImageSourceLoaderProps } from "../arcgis-source-types.js";
+/** Loads the ArcGISImageServerSourceLoader implementation on first asynchronous use. */
+declare function preloadArcGISImageServerSourceLoader(): Promise<SourceLoader<ArcGISImageSource>>;
+/** Lightweight service descriptor; use load() or the synchronous /bundled entrypoint. */
+export declare const ArcGISImageServerSourceLoader: {
+    readonly dataType: ArcGISImageSource;
+    readonly batchType: never;
+    readonly preload: typeof preloadArcGISImageServerSourceLoader;
+    /** Requires the runtime loader when constructing a source synchronously. */
+    readonly createDataSource: (_url: string, _options: ArcGISImageSourceLoaderProps, _coreApi?: CoreAPI) => ArcGISImageSource;
+    readonly name: "ArcGISImageServer";
+    readonly id: "arcgis-image-server";
+    readonly module: "arcgis";
+    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;
+};
+export {};
+//# sourceMappingURL=arcgis-image-server-source-loader-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"arcgis-image-server-source-loader-types.d.ts","sourceRoot":"","sources":["../../src/arcgis/arcgis-image-server-source-loader-types.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,OAAO,EAAE,YAAY,EAAC,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAC,iBAAiB,EAAC,+CAA4C;AAC3E,OAAO,KAAK,EAAC,4BAA4B,EAAC,kCAA+B;AAEzE,wFAAwF;AACxF,iBAAe,oCAAoC,IAAI,OAAO,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC,CAK9F;AAED,yFAAyF;AACzF,eAAO,MAAM,6BAA6B;uBAEX,iBAAiB;wBAC3B,KAAK;;IAExB,4EAA4E;sCAEpE,MAAM,YACF,4BAA4B,aAC3B,OAAO,KACjB,iBAAiB;;;;;;;;;;;;;;;;;CAK8B,CAAC"}

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

@@ -0,0 +1,21 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { ARCGIS_IMAGE_SERVER_SOURCE_LOADER_METADATA } from "../arcgis-source-types.js";
+/** Loads the ArcGISImageServerSourceLoader implementation on first asynchronous use. */
+async function preloadArcGISImageServerSourceLoader() {
+    const { ArcGISImageServerSourceLoaderWithParser } = await import('@loaders.gl/arcgis/arcgis-image-server-source-loader');
+    return ArcGISImageServerSourceLoaderWithParser;
+}
+/** Lightweight service descriptor; use load() or the synchronous /bundled entrypoint. */
+export const ArcGISImageServerSourceLoader = {
+    ...ARCGIS_IMAGE_SERVER_SOURCE_LOADER_METADATA,
+    dataType: null,
+    batchType: null,
+    preload: preloadArcGISImageServerSourceLoader,
+    /** Requires the runtime loader when constructing a source synchronously. */
+    createDataSource(_url, _options, _coreApi) {
+        throw new Error('ArcGISImageServerSourceLoader requires async load() or an @loaders.gl/arcgis/bundled import');
+    }
+};
+//# sourceMappingURL=arcgis-image-server-source-loader-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"arcgis-image-server-source-loader-types.js","sourceRoot":"","sources":["../../src/arcgis/arcgis-image-server-source-loader-types.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC,OAAO,EAAC,0CAA0C,EAAC,kCAA+B;AAKlF,wFAAwF;AACxF,KAAK,UAAU,oCAAoC;IACjD,MAAM,EAAC,uCAAuC,EAAC,GAAG,MAAM,MAAM,CAC5D,sDAAsD,CACvD,CAAC;IACF,OAAO,uCAAuC,CAAC;AACjD,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,GAAG,0CAA0C;IAC7C,QAAQ,EAAE,IAAoC;IAC9C,SAAS,EAAE,IAAa;IACxB,OAAO,EAAE,oCAAoC;IAC7C,4EAA4E;IAC5E,gBAAgB,CACd,IAAY,EACZ,QAAsC,EACtC,QAAkB;QAElB,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAC;IACJ,CAAC;CACiD,CAAC"}

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

@@ -0,0 +1,60 @@
+import { ArcGISAuthentication } from "../authentication.js";
+import type { ArcGISImageSourceLoaderProps, ArcGISExportImageParameters } from "../arcgis-source-types.js";
+import type { ImageType } from '@loaders.gl/images';
+import type { CoreAPI, ImageSource, ImageSourceMetadata, GetImageParameters } from '@loaders.gl/loader-utils';
+import { DataSource } from '@loaders.gl/loader-utils';
+import type { LERCData } from '@loaders.gl/lerc';
+/** Runtime service loader for synchronous construction. */
+export declare const ArcGISImageServerSourceLoaderWithParser: {
+    readonly dataType: ArcGISImageSource;
+    readonly batchType: never;
+    readonly preload: undefined;
+    /** Supplies ArcGIS credentials after loading the selected implementation. */
+    readonly getAuthentications: () => (typeof ArcGISAuthentication)[];
+    readonly createDataSource: (url: string, props: ArcGISImageSourceLoaderProps, coreApi?: CoreAPI) => ArcGISImageSource;
+    readonly name: "ArcGISImageServer";
+    readonly id: "arcgis-image-server";
+    readonly module: "arcgis";
+    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;
+};
+/**
+ * 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":"AAIA,OAAO,EAAC,oBAAoB,EAAC,6BAA0B;AAEvD,OAAO,KAAK,EACV,4BAA4B,EAC5B,2BAA2B,EAC5B,kCAA+B;AAEhC,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EACV,OAAO,EAEP,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAC,UAAU,EAAC,MAAM,0BAA0B,CAAC;AACpD,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAI/C,2DAA2D;AAC3D,eAAO,MAAM,uCAAuC;uBAErB,iBAAiB;wBAC3B,KAAK;;IAExB,6EAA6E;;qCAGtE,MAAM,SACJ,4BAA4B,YACzB,OAAO,KAChB,iBAAiB;;;;;;;;;;;;;;;;;CAC8B,CAAC;AAErD;;;;GAIG;AACH,qBAAa,iBACX,SAAQ,UAAU,CAAC,MAAM,EAAE,4BAA4B,CACvD,YAAW,WAAW;gBAEV,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,4BAA4B,EAAE,OAAO,CAAC,EAAE,OAAO;IAI/E,+CAA+C;IACzC,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAIjD,6DAA6D;IACvD,QAAQ,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC;IAclE,yDAAyD;IACnD,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAMlC,uEAAuE;IACjE,WAAW,CACf,OAAO,EAAE,2BAA2B,EACpC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,CAAC;IAOrB,+EAA+E;IACzE,YAAY,CAChB,OAAO,EAAE,2BAA2B,EACpC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,QAAQ,CAAC;IAapB,iEAAiE;IACjE,WAAW,CAAC,OAAO,CAAC,EAAE;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAC,GAAG,MAAM;IAIrE,qEAAqE;IACrE,cAAc,CAAC,OAAO,EAAE,2BAA2B,GAAG,MAAM;IAW5D,wCAAwC;IACxC,SAAS,CAAC,MAAM,CACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM;IAIT,6CAA6C;cAC7B,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAOjE"}

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

@@ -0,0 +1,130 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { ArcGISAuthentication } from "../authentication.js";
+import { ARCGIS_IMAGE_SERVER_SOURCE_LOADER_METADATA } from "../arcgis-source-types.js";
+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";
+/** Runtime service loader for synchronous construction. */
+export const ArcGISImageServerSourceLoaderWithParser = {
+    ...ARCGIS_IMAGE_SERVER_SOURCE_LOADER_METADATA,
+    dataType: null,
+    batchType: null,
+    preload: undefined,
+    /** Supplies ArcGIS credentials after loading the selected implementation. */
+    getAuthentications: () => [ArcGISAuthentication],
+    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, ARCGIS_IMAGE_SERVER_SOURCE_LOADER_METADATA.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, width, height, crs, format, signal } = parameters;
+        const spatialReference = normalizeArcGISSpatialReference(crs) || '4326';
+        const imageParameters = {
+            bbox: [...boundingBox[0], ...boundingBox[1]],
+            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":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC,OAAO,EAAC,oBAAoB,EAAC,6BAA0B;AACvD,OAAO,EAAC,0CAA0C,EAAC,kCAA+B;AAOlF,OAAO,EAAC,WAAW,EAAC,MAAM,oBAAoB,CAAC;AAQ/C,OAAO,EAAC,UAAU,EAAC,MAAM,0BAA0B,CAAC;AAEpD,OAAO,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAC,sBAAsB,EAAC,8BAA2B;AAE1D,2DAA2D;AAC3D,MAAM,CAAC,MAAM,uCAAuC,GAAG;IACrD,GAAG,0CAA0C;IAC7C,QAAQ,EAAE,IAAoC;IAC9C,SAAS,EAAE,IAAa;IACxB,OAAO,EAAE,SAAS;IAClB,6EAA6E;IAC7E,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC,oBAAoB,CAAC;IAChD,gBAAgB,EAAE,CAChB,GAAW,EACX,KAAmC,EACnC,OAAiB,EACE,EAAE,CAAC,IAAI,iBAAiB,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAErD;;;;GAIG;AACH,MAAM,OAAO,iBACX,SAAQ,UAAgD;IAGxD,YAAY,GAAW,EAAE,KAAmC,EAAE,OAAiB;QAC7E,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,0CAA0C,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACxF,CAAC;IAED,+CAA+C;IAC/C,KAAK,CAAC,WAAW;QACf,OAAO,kCAAkC,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,QAAQ,CAAC,UAA8B;QAC3C,MAAM,EAAC,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAC,GAAG,UAAU,CAAC;QACrE,MAAM,gBAAgB,GAAG,+BAA+B,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC;QACxE,MAAM,eAAe,GAAgC;YACnD,IAAI,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAC5C,MAAM,EAAE,gBAAgB;YACxB,OAAO,EAAE,gBAAgB;YACzB,KAAK;YACL,MAAM;YACN,MAAM,EAAE,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;SACnD,CAAC;QACF,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,QAAQ;QACZ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACtD,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,WAAW,CACf,OAAoC,EACpC,MAAoB;QAEpB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAC,MAAM,EAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC/F,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;QACjD,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,CAAc,CAAC;IAC7F,CAAC;IAED,+EAA+E;IAC/E,KAAK,CAAC,YAAY,CAChB,OAAoC,EACpC,MAAoB;QAEpB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAC/B,IAAI,CAAC,cAAc,CAAC,EAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAC,CAAC,EACjD,MAAM,CAAC,CAAC,CAAC,EAAC,MAAM,EAAC,CAAC,CAAC,CAAC,SAAS,CAC9B,CAAC;QACF,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAC9B,MAAM,QAAQ,CAAC,WAAW,EAAE,EAC5B,UAAU,EACV,IAAI,CAAC,WAAW,CACjB,CAAa,CAAC;IACjB,CAAC;IAED,iEAAiE;IACjE,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,qEAAqE;IACrE,cAAc,CAAC,OAAoC;QACjD,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,EAAE,qBAAqB,IAAI,EAAE,CAAC;QAC3F,MAAM,EAAC,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,EAAC,GAAG,EAAC,GAAG,iBAAiB,EAAE,GAAG,OAAO,EAAC,CAAC;QAC1E,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE;YAChC,GAAG,UAAU;YACb,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;YACrB,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,OAAO;SAC3B,CAAC,CAAC;IACL,CAAC;IAED,wCAAwC;IAC9B,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,6CAA6C;IACnC,KAAK,CAAC,aAAa,CAAC,QAAkB;QAC9C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,QAAQ,CAAC,UAAU,IAAI,sCAAsC,QAAQ,CAAC,MAAM,EAAE,CAC/E,CAAC;QACJ,CAAC;IACH,CAAC;CACF;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,wFAAwF;AACxF,SAAS,kCAAkC,CAAC,QAAiB;IAC3D,MAAM,cAAc,GAAG,QAAe,CAAC;IACvC,MAAM,MAAM,GAAG,cAAc,CAAC,UAAU,IAAI,cAAc,CAAC,MAAM,CAAC;IAClE,MAAM,gBAAgB,GAAG,cAAc,CAAC,gBAAgB,IAAI,MAAM,EAAE,gBAAgB,CAAC;IACrF,MAAM,mBAAmB,GAAG,gBAAgB,EAAE,UAAU,IAAI,gBAAgB,EAAE,IAAI,CAAC;IACnF,MAAM,WAAW,GACf,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;QACnF,CAAC,CAAE;YACC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;YAC1B,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;SACc;QAC5C,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,IAAI,cAAc,CAAC,kBAAkB,IAAI,EAAE,CAAC;IAC5E,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,cAAc,CAAC,WAAW,IAAI,cAAc,CAAC,kBAAkB,IAAI,EAAE;QAC/E,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;QAC/E,MAAM,EAAE;YACN;gBACE,IAAI;gBACJ,KAAK,EAAE,IAAI;gBACX,GAAG,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,QAAQ,mBAAmB,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;gBACtE,WAAW;aACZ;SACF;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,31 @@
+import type { CoreAPI, SourceLoader } from '@loaders.gl/loader-utils';
+import type { ArcGISImageTileSource } from "./arcgis-image-tile-source-loader.js";
+import type { ArcGISImageTileSourceLoaderOptions } from "../arcgis-source-types.js";
+/** Loads the ArcGISImageTileSourceLoader implementation on first asynchronous use. */
+declare function preloadArcGISImageTileSourceLoader(): Promise<SourceLoader<ArcGISImageTileSource>>;
+/** Lightweight service descriptor; use load() or the synchronous /bundled entrypoint. */
+export declare const ArcGISImageTileSourceLoader: {
+    readonly dataType: ArcGISImageTileSource;
+    readonly batchType: never;
+    readonly preload: typeof preloadArcGISImageTileSourceLoader;
+    /** Requires the runtime loader when constructing a source synchronously. */
+    readonly createDataSource: (_url: string, _options: ArcGISImageTileSourceLoaderOptions, _coreApi?: CoreAPI) => ArcGISImageTileSource;
+    readonly name: "ArcGIS ImageServer tiles";
+    readonly id: "arcgis-image-server-tiles";
+    readonly module: "arcgis";
+    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;
+};
+export {};
+//# sourceMappingURL=arcgis-image-tile-source-loader-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"arcgis-image-tile-source-loader-types.d.ts","sourceRoot":"","sources":["../../src/arcgis/arcgis-image-tile-source-loader-types.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,OAAO,EAAE,YAAY,EAAC,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAC,qBAAqB,EAAC,6CAA0C;AAC7E,OAAO,KAAK,EAAC,kCAAkC,EAAC,kCAA+B;AAE/E,sFAAsF;AACtF,iBAAe,kCAAkC,IAAI,OAAO,CAAC,YAAY,CAAC,qBAAqB,CAAC,CAAC,CAKhG;AAED,yFAAyF;AACzF,eAAO,MAAM,2BAA2B;uBAET,qBAAqB;wBAC/B,KAAK;;IAExB,4EAA4E;sCAEpE,MAAM,YACF,kCAAkC,aACjC,OAAO,KACjB,qBAAqB;;;;;;;;;;;;;;;;;CAK8B,CAAC"}

package/dist/arcgis/arcgis-image-tile-source-loader-types.js

@@ -0,0 +1,21 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { ARCGIS_IMAGE_TILE_SOURCE_LOADER_METADATA } from "../arcgis-source-types.js";
+/** Loads the ArcGISImageTileSourceLoader implementation on first asynchronous use. */
+async function preloadArcGISImageTileSourceLoader() {
+    const { ArcGISImageTileSourceLoaderWithParser } = await import('@loaders.gl/arcgis/arcgis-image-tile-source-loader');
+    return ArcGISImageTileSourceLoaderWithParser;
+}
+/** Lightweight service descriptor; use load() or the synchronous /bundled entrypoint. */
+export const ArcGISImageTileSourceLoader = {
+    ...ARCGIS_IMAGE_TILE_SOURCE_LOADER_METADATA,
+    dataType: null,
+    batchType: null,
+    preload: preloadArcGISImageTileSourceLoader,
+    /** Requires the runtime loader when constructing a source synchronously. */
+    createDataSource(_url, _options, _coreApi) {
+        throw new Error('ArcGISImageTileSourceLoader requires async load() or an @loaders.gl/arcgis/bundled import');
+    }
+};
+//# sourceMappingURL=arcgis-image-tile-source-loader-types.js.map

package/dist/arcgis/arcgis-image-tile-source-loader-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arcgis-image-tile-source-loader-types.js","sourceRoot":"","sources":["../../src/arcgis/arcgis-image-tile-source-loader-types.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC,OAAO,EAAC,wCAAwC,EAAC,kCAA+B;AAKhF,sFAAsF;AACtF,KAAK,UAAU,kCAAkC;IAC/C,MAAM,EAAC,qCAAqC,EAAC,GAAG,MAAM,MAAM,CAC1D,oDAAoD,CACrD,CAAC;IACF,OAAO,qCAAqC,CAAC;AAC/C,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,GAAG,wCAAwC;IAC3C,QAAQ,EAAE,IAAwC;IAClD,SAAS,EAAE,IAAa;IACxB,OAAO,EAAE,kCAAkC;IAC3C,4EAA4E;IAC5E,gBAAgB,CACd,IAAY,EACZ,QAA4C,EAC5C,QAAkB;QAElB,MAAM,IAAI,KAAK,CACb,2FAA2F,CAC5F,CAAC;IACJ,CAAC;CACqD,CAAC"}