@loaders.gl/services 5.0.0-alpha.6 → 5.0.0-alpha.8

package/dist/arcgis/arcgis-vector-tile-server-source-loader.js

@@ -1,156 +0,0 @@
-// loaders.gl
-// SPDX-License-Identifier: MIT
-// Copyright (c) vis.gl contributors
-import { DataSource } from '@loaders.gl/loader-utils';
-import { MVTLoader } from '@loaders.gl/mvt';
-/** A source for ArcGIS VectorTileServer metadata and PBF tiles. */
-export class ArcGISVectorTileServerSource extends DataSource {
-    /** Decoded tile family consumed by generic tile renderers. */
-    mimeType = 'application/vnd.mapbox-vector-tile';
-    /** ArcGIS tiles are decoded to WGS84 coordinates before rendering. */
-    localCoordinates = false;
-    /** Cached service metadata request. */
-    serviceMetadata = null;
-    /** Query parameters supplied with the service URL, such as an access token. */
-    serviceQueryParameters;
-    /** Creates an ArcGIS VectorTileServer source. */
-    constructor(url, options = {}, coreApi) {
-        const serviceURL = new URL(url);
-        serviceURL.pathname = serviceURL.pathname.replace(/\/$/, '');
-        super(`${serviceURL.origin}${serviceURL.pathname}`, options, ArcGISVectorTileServerSourceLoader.defaultOptions, coreApi);
-        this.serviceQueryParameters = new URLSearchParams(serviceURL.search);
-    }
-    /** Returns normalized service and tile-grid metadata. */
-    async getMetadata() {
-        const metadata = await this.getServiceMetadata();
-        const tileInfo = metadata.tileInfo;
-        const lods = tileInfo?.lods || [];
-        const extent = metadata.fullExtent || metadata.initialExtent;
-        return {
-            name: metadata.mapName || this.url.split('/').pop() || '',
-            title: metadata.mapName,
-            abstract: metadata.serviceDescription,
-            format: 'application/vnd.mapbox-vector-tile',
-            minZoom: lods[0]?.level,
-            maxZoom: lods.at(-1)?.level,
-            boundingBox: extent
-                ? [
-                    [extent.xmin, extent.ymin],
-                    [extent.xmax, extent.ymax]
-                ]
-                : undefined,
-            layer: {
-                name: metadata.mapName || '',
-                srs: tileInfo?.spatialReference ? [getSpatialReference(tileInfo.spatialReference)] : [],
-                layers: []
-            },
-            formatHeader: {
-                tileInfo,
-                styleURL: this.getStyleURL(),
-                spriteURL: this.getSpriteURL()
-            }
-        };
-    }
-    /** Fetches one raw PBF tile from the ArcGIS tile endpoint. */
-    async getTile(parameters, signal) {
-        const response = await this.fetch(this.getTileURL(parameters), {
-            signal,
-            headers: { Accept: 'application/vnd.mapbox-vector-tile, application/x-protobuf' }
-        });
-        if (!response.ok)
-            return null;
-        return response.arrayBuffer();
-    }
-    /** Returns the schema advertised by decoded vector tiles. */
-    async getSchema() {
-        return { fields: [], metadata: {} };
-    }
-    /** Fetches and decodes one ArcGIS vector tile to geographic coordinates. */
-    async getVectorTile(parameters) {
-        const arrayBuffer = await this.getTile(parameters, parameters.signal);
-        if (!arrayBuffer) {
-            return null;
-        }
-        const inheritedOptions = this.loadOptions.mvt;
-        const sourceOptions = this.options['arcgis-vector-tile-server']?.mvt;
-        return (await this.coreApi.parse(arrayBuffer, MVTLoader, {
-            ...this.loadOptions,
-            mvt: {
-                ...inheritedOptions,
-                ...sourceOptions,
-                coordinates: 'wgs84',
-                tileIndex: { x: parameters.x, y: parameters.y, z: parameters.z },
-                layers: normalizeLayers(parameters.layers) || sourceOptions?.layers || inheritedOptions?.layers
-            }
-        }));
-    }
-    /** Provides decoded vector tiles through the deck.gl source interface. */
-    async getTileData(parameters) {
-        return this.getVectorTile({ ...parameters.index, signal: parameters.signal });
-    }
-    /** Builds the ArcGIS cached vector tile URL. */
-    getTileURL(parameters) {
-        return this.getResourceURL(`/tile/${parameters.z}/${parameters.y}/${parameters.x}.pbf`);
-    }
-    /** Returns the service metadata URL. */
-    getMetadataURL() {
-        const url = new URL(this.getResourceURL(''));
-        url.searchParams.set('f', 'pjson');
-        return url.toString();
-    }
-    /** Returns the ArcGIS Mapbox style resource URL. */
-    getStyleURL() {
-        return this.getResourceURL('/resources/styles/root.json');
-    }
-    /** Returns the ArcGIS sprite resource base URL. */
-    getSpriteURL() {
-        return this.getResourceURL('/resources/sprites/sprite');
-    }
-    /** Loads and caches the ArcGIS VectorTileServer metadata document. */
-    async getServiceMetadata() {
-        this.serviceMetadata ||= this.fetch(this.getMetadataURL()).then(async (response) => {
-            if (!response.ok)
-                throw new Error(`ArcGIS VectorTileServer request failed: ${response.status}`);
-            return (await response.json());
-        });
-        return this.serviceMetadata;
-    }
-    /** Builds a resource URL while retaining service query parameters. */
-    getResourceURL(resourcePath) {
-        const url = new URL(this.url);
-        url.pathname = `${url.pathname.replace(/\/$/, '')}${resourcePath}`;
-        for (const [key, value] of this.serviceQueryParameters) {
-            url.searchParams.set(key, value);
-        }
-        return url.toString();
-    }
-}
-/** Source loader for ArcGIS VectorTileServer services. */
-export const ArcGISVectorTileServerSourceLoader = {
-    dataType: null,
-    batchType: null,
-    name: 'ArcGIS VectorTileServer',
-    id: 'arcgis-vector-tile-server',
-    module: 'services',
-    version: '0.0.0',
-    extensions: [],
-    mimeTypes: ['application/vnd.mapbox-vector-tile', 'application/x-protobuf'],
-    type: 'arcgis-vector-tile-server',
-    fromUrl: true,
-    fromBlob: false,
-    options: { 'arcgis-vector-tile-server': {} },
-    defaultOptions: { 'arcgis-vector-tile-server': {} },
-    testURL: (url) => /\/vectortileserver(?:[\/?#]|$)/i.test(url),
-    createDataSource: (url, options = {}, coreApi) => new ArcGISVectorTileServerSource(url, options, coreApi)
-};
-/** Converts an ArcGIS spatial reference to an EPSG identifier. */
-function getSpatialReference(spatialReference) {
-    return `EPSG:${spatialReference.latestWkid || spatialReference.wkid}`;
-}
-/** Normalizes generic tile layer selection for the MVT parser. */
-function normalizeLayers(layers) {
-    if (!layers)
-        return undefined;
-    return Array.isArray(layers) ? layers : [layers];
-}
-//# sourceMappingURL=arcgis-vector-tile-server-source-loader.js.map

package/dist/arcgis/arcgis-vector-tile-server-source-loader.js.map

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

package/dist/service-registry.d.ts

@@ -1,18 +0,0 @@
-import { ArcGISFeatureServerSourceLoader } from "./arcgis/arcgis-feature-server-source-loader.js";
-import { ArcGISImageServerSourceLoader } from "./arcgis/arcgis-image-server-source-loader.js";
-import { ArcGISImageTileSourceLoader } from "./arcgis/arcgis-image-tile-source-loader.js";
-import { ArcGISMapTileSourceLoader } from "./arcgis/arcgis-map-tile-source-loader.js";
-import { ArcGISSceneServerSourceLoader } from "./arcgis/arcgis-scene-server-source-loader.js";
-import { ArcGISVectorTileServerSourceLoader } from "./arcgis/arcgis-vector-tile-server-source-loader.js";
-/** A source loader currently exposed through the services package. */
-export type ServiceLoader = typeof ArcGISFeatureServerSourceLoader | typeof ArcGISImageServerSourceLoader | typeof ArcGISImageTileSourceLoader | typeof ArcGISMapTileSourceLoader | typeof ArcGISVectorTileServerSourceLoader | typeof ArcGISSceneServerSourceLoader;
-/** All source loaders owned by `@loaders.gl/services`, in URL-selection order. */
-export declare const SERVICE_LOADERS: ServiceLoader[];
-/**
- * Finds a service loader by its canonical loader id or service type.
- *
- * The lookup is intentionally small and explicit. It provides discovery without
- * introducing a second request lifecycle or hiding provider-specific options.
- */
-export declare function getServiceLoader(serviceType: string): ServiceLoader | undefined;
-//# sourceMappingURL=service-registry.d.ts.map

package/dist/service-registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"service-registry.d.ts","sourceRoot":"","sources":["../src/service-registry.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,+BAA+B,EAAC,wDAAqD;AAC7F,OAAO,EAAC,6BAA6B,EAAC,sDAAmD;AACzF,OAAO,EAAC,2BAA2B,EAAC,oDAAiD;AACrF,OAAO,EAAC,yBAAyB,EAAC,kDAA+C;AACjF,OAAO,EAAC,6BAA6B,EAAC,sDAAmD;AACzF,OAAO,EAAC,kCAAkC,EAAC,4DAAyD;AAEpG,sEAAsE;AACtE,MAAM,MAAM,aAAa,GACrB,OAAO,+BAA+B,GACtC,OAAO,6BAA6B,GACpC,OAAO,2BAA2B,GAClC,OAAO,yBAAyB,GAChC,OAAO,kCAAkC,GACzC,OAAO,6BAA6B,CAAC;AAEzC,kFAAkF;AAClF,eAAO,MAAM,eAAe,EAAE,aAAa,EAO1C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAM/E"}

package/dist/service-registry.js

@@ -1,29 +0,0 @@
-// loaders.gl
-// SPDX-License-Identifier: MIT
-// Copyright (c) vis.gl contributors
-import { ArcGISFeatureServerSourceLoader } from "./arcgis/arcgis-feature-server-source-loader.js";
-import { ArcGISImageServerSourceLoader } from "./arcgis/arcgis-image-server-source-loader.js";
-import { ArcGISImageTileSourceLoader } from "./arcgis/arcgis-image-tile-source-loader.js";
-import { ArcGISMapTileSourceLoader } from "./arcgis/arcgis-map-tile-source-loader.js";
-import { ArcGISSceneServerSourceLoader } from "./arcgis/arcgis-scene-server-source-loader.js";
-import { ArcGISVectorTileServerSourceLoader } from "./arcgis/arcgis-vector-tile-server-source-loader.js";
-/** All source loaders owned by `@loaders.gl/services`, in URL-selection order. */
-export const SERVICE_LOADERS = [
-    ArcGISFeatureServerSourceLoader,
-    ArcGISImageServerSourceLoader,
-    ArcGISImageTileSourceLoader,
-    ArcGISMapTileSourceLoader,
-    ArcGISVectorTileServerSourceLoader,
-    ArcGISSceneServerSourceLoader
-];
-/**
- * Finds a service loader by its canonical loader id or service type.
- *
- * The lookup is intentionally small and explicit. It provides discovery without
- * introducing a second request lifecycle or hiding provider-specific options.
- */
-export function getServiceLoader(serviceType) {
-    const normalizedServiceType = serviceType.toLowerCase();
-    return SERVICE_LOADERS.find(serviceLoader => serviceLoader.id === normalizedServiceType || serviceLoader.type === normalizedServiceType);
-}
-//# sourceMappingURL=service-registry.js.map

package/dist/service-registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"service-registry.js","sourceRoot":"","sources":["../src/service-registry.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC,OAAO,EAAC,+BAA+B,EAAC,wDAAqD;AAC7F,OAAO,EAAC,6BAA6B,EAAC,sDAAmD;AACzF,OAAO,EAAC,2BAA2B,EAAC,oDAAiD;AACrF,OAAO,EAAC,yBAAyB,EAAC,kDAA+C;AACjF,OAAO,EAAC,6BAA6B,EAAC,sDAAmD;AACzF,OAAO,EAAC,kCAAkC,EAAC,4DAAyD;AAWpG,kFAAkF;AAClF,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC9C,+BAA+B;IAC/B,6BAA6B;IAC7B,2BAA2B;IAC3B,yBAAyB;IACzB,kCAAkC;IAClC,6BAA6B;CAC9B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,MAAM,qBAAqB,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;IACxD,OAAO,eAAe,CAAC,IAAI,CACzB,aAAa,CAAC,EAAE,CACd,aAAa,CAAC,EAAE,KAAK,qBAAqB,IAAI,aAAa,CAAC,IAAI,KAAK,qBAAqB,CAC7F,CAAC;AACJ,CAAC"}

package/src/arcgis/arcgis-capability-graph.ts

@@ -1,295 +0,0 @@
-// loaders.gl
-// SPDX-License-Identifier: MIT
-// Copyright (c) vis.gl contributors
-
-import {getArcGISServices} from './arcgis-server';
-import type {ServiceCapabilities} from '@loaders.gl/loader-utils';
-import type {Service as ArcGISService} from './arcgis-server';
-
-/** 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 async function discoverArcGISCapabilities(
-  url: string,
-  options: ArcGISCapabilityGraphOptions = {}
-): Promise<ArcGISCapabilityGraph | null> {
-  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: ArcGISCapabilityGraph,
-  requirements: ArcGISServiceSelection = {}
-): ArcGISServiceCapabilities | undefined {
-  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: string,
-  fetchFile: typeof fetch
-): Promise<Record<string, unknown>> {
-  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()) as Record<string, unknown>;
-}
-
-/** Fetches layer documents so SceneServer profile selection uses authoritative store metadata. */
-async function enrichSceneServerMetadata(
-  serviceUrl: string,
-  metadata: Record<string, unknown>,
-  fetchFile: typeof fetch
-): Promise<Record<string, unknown>> {
-  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 as Record<string, unknown>;
-      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: ArcGISService,
-  metadata: Record<string, unknown>
-): ArcGISServiceCapabilities {
-  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: ServiceCapabilities = {
-    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: Record<string, unknown>): ServiceCapabilities['layers'] {
-  const layerValues = Array.isArray(metadata.layers) ? metadata.layers : [];
-  return layerValues.flatMap(value => {
-    if (!value || typeof value !== 'object') return [];
-    const layer = value as Record<string, unknown>;
-    const spatialReference = layer.spatialReference as
-      | {wkid?: number; latestWkid?: number}
-      | undefined;
-    const wkid = spatialReference?.latestWkid || spatialReference?.wkid;
-    const extent = layer.extent as
-      | {xmin?: number; ymin?: number; xmax?: number; ymax?: number}
-      | undefined;
-    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 as Record<string, unknown>).profile === 'string'
-              ? ((layer.store as Record<string, unknown>).profile as string)
-              : 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 as Record<string, unknown>).version === 'string'
-              ? ((layer.store as Record<string, unknown>).version as string)
-              : undefined
-      }
-    ];
-  });
-}
-
-/** Extracts operation names when a service advertises them. */
-function getServiceOperations(metadata: Record<string, unknown>): string[] {
-  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: string): ServiceCapabilities['type'] {
-  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: string): ArcGISServiceCapabilities['kind'] {
-  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: Record<string, unknown>): string[] {
-  const formats = new Set<string>();
-  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 as {format?: string} | undefined;
-  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: Record<string, unknown>): string[] {
-  const spatialReferences = new Set<string>();
-  for (const value of [metadata.spatialReference, (metadata.fullExtent as any)?.spatialReference]) {
-    const spatialReference = value as {wkid?: number; latestWkid?: number} | undefined;
-    for (const wkid of [spatialReference?.wkid, spatialReference?.latestWkid]) {
-      if (wkid) spatialReferences.add(`EPSG:${wkid}`);
-    }
-  }
-  return [...spatialReferences].sort();
-}