@loaders.gl/wms 4.0.0-alpha.23 → 4.0.0-alpha.24

package/dist/lib/parsers/xml/parse-xml-helpers.js

@@ -1,68 +0,0 @@
-"use strict";
-// loaders.gl, MIT license
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getXMLBoolean = exports.getXMLInteger = exports.getXMLFloat = exports.getXMLStringArray = exports.getXMLArray = void 0;
-/** A single element of an array is not represented as an array in XML */
-function getXMLArray(xmlValue) {
-    // Already an array, return as is
-    if (Array.isArray(xmlValue)) {
-        return xmlValue;
-    }
-    // Single value, wrap in array
-    if (xmlValue) {
-        return [xmlValue];
-    }
-    // nullish, return empty array
-    return [];
-}
-exports.getXMLArray = getXMLArray;
-/** Get a list of strings from XML */
-function getXMLStringArray(xmlValue) {
-    const xmlArray = getXMLArray(xmlValue);
-    if (xmlArray.length > 0 && xmlArray.every((_) => typeof _ === 'string')) {
-        return xmlArray;
-    }
-    // TODO - error handling?
-    return [];
-}
-exports.getXMLStringArray = getXMLStringArray;
-/** Get XML float */
-function getXMLFloat(xmlValue, defaultValue = undefined) {
-    switch (typeof xmlValue) {
-        case 'number':
-            return xmlValue;
-        case 'string':
-            return parseFloat(xmlValue);
-        default:
-            return undefined;
-    }
-}
-exports.getXMLFloat = getXMLFloat;
-/** Get XML integer */
-function getXMLInteger(xmlValue, defaultValue = undefined) {
-    switch (typeof xmlValue) {
-        case 'number':
-            return xmlValue;
-        case 'string':
-            return parseInt(xmlValue, 10);
-        default:
-            return undefined;
-    }
-}
-exports.getXMLInteger = getXMLInteger;
-/** Somewhat arbitrary boolean parsing */
-function getXMLBoolean(xmlValue) {
-    switch (xmlValue) {
-        case 'true':
-            return true;
-        case 'false':
-            return false;
-        case '1':
-            return true;
-        case '0':
-            return false;
-        default:
-            return false;
-    }
-}
-exports.getXMLBoolean = getXMLBoolean;

package/dist/lib/services/arcgis/arcgis-image-service.js

@@ -1,94 +0,0 @@
-"use strict";
-// loaders.gl, MIT license
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ArcGISImageServer = void 0;
-const image_source_1 = require("../../sources/image-source");
-/**
- * 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
- */
-class ArcGISImageServer extends image_source_1.ImageSource {
-    constructor(props) {
-        super(props);
-    }
-    // ImageSource (normalized endpoints)
-    async getMetadata() {
-        return (await this.metadata());
-        // TODO - normalize metadata
-    }
-    async getImage(parameters) {
-        throw new Error('not implemented');
-        // TODO - Map generic parameters to ArcGIS specific parameters
-        // return await this.exportImage(parameters);
-    }
-    // ImageServer endpoints
-    async metadata() {
-        // We just need a JSON parsing...
-        // return this.getUrl({path: '', ...options});
-        throw new Error('not implemented');
-    }
-    /**
-     * Form a URL to an ESRI ImageServer
-     // https://sampleserver6.arcgisonline.com/arcgis/rest/services/NLCDLandCover2001/ImageServer/exportImage?bbox=${bounds[0]},${bounds[1]},${bounds[2]},${bounds[3]}&bboxSR=4326&size=${width},${height}&imageSR=102100&time=&format=jpgpng&pixelType=U8&noData=&noDataInterpretation=esriNoDataMatchAny&interpolation=+RSP_NearestNeighbor&compression=&compressionQuality=&bandIds=&mosaicRule=&renderingRule=&f=image`,
-     */
-    exportImage(options) {
-        // See WMSService.getMap()
-        throw new Error('not implemented');
-    }
-    // URL creators
-    metadataURL(options) {
-        return `${this.props.url}?f=pjson`;
-    }
-    /**
-     * Form a URL to an ESRI ImageServer
-     // https://sampleserver6.arcgisonline.com/arcgis/rest/services/NLCDLandCover2001/ImageServer/exportImage?
-     //   bbox=${bounds[0]},${bounds[1]},${bounds[2]},${bounds[3]}&bboxSR=4326&
-     //   size=${width},${height}&imageSR=102100&time=&format=jpgpng&pixelType=U8&
-     //   noData=&noDataInterpretation=esriNoDataMatchAny&interpolation=+RSP_NearestNeighbor&compression=&
-     //   compressionQuality=&bandIds=&mosaicRule=&renderingRule=&
-     //   f=image
-     */
-    exportImageURL(options) {
-        const bbox = `bbox=${options.bbox[0]},${options.bbox[1]},${options.bbox[2]},${options.bbox[3]}`;
-        const size = `size=${options.width},${options.height}`;
-        const arcgisOptions = { ...options, bbox, size };
-        // @ts-expect-error
-        delete arcgisOptions.width;
-        // @ts-expect-error
-        delete arcgisOptions.height;
-        return this.getUrl('exportImage', arcgisOptions);
-    }
-    // INTERNAL METHODS
-    /**
-     * @note protected, since perhaps getWMSUrl may need to be overridden to handle certain backends?
-     * @note if override is common, maybe add a callback prop?
-     * */
-    getUrl(path, options, extra) {
-        let url = `${this.props.url}/${path}`;
-        let first = true;
-        for (const [key, value] of Object.entries(options)) {
-            url += first ? '?' : '&';
-            first = false;
-            if (Array.isArray(value)) {
-                url += `${key.toUpperCase()}=${value.join(',')}`;
-            }
-            else {
-                url += `${key.toUpperCase()}=${value ? String(value) : ''}`;
-            }
-        }
-        return url;
-    }
-    /** Checks for and parses a WMS XML formatted ServiceError and throws an exception */
-    async checkResponse(response) {
-        if (!response.ok) {
-            // } || response.headers['content-type'] === WMSErrorLoader.mimeTypes[0]) {
-            // const arrayBuffer = await response.arrayBuffer();
-            // const error = await WMSErrorLoader.parse(arrayBuffer, this.loadOptions);
-            throw new Error('error');
-        }
-    }
-}
-exports.ArcGISImageServer = ArcGISImageServer;
-ArcGISImageServer.type = 'arcgis-image-server';
-ArcGISImageServer.testURL = (url) => url.toLowerCase().includes('ImageServer');

package/dist/lib/services/arcgis/arcgis-server.js

@@ -1,42 +0,0 @@
-"use strict";
-// loaders.gl, MIT license
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getArcGISServices = void 0;
-/**
- * (Recursively) load the service directory from an ArcGIS Server URL
- * @param url
- * @param fetchFile= Optional fetch function override
- * @returns
- */
-async function getArcGISServices(url, fetchFile = fetch) {
-    if (url.includes('rest/services')) {
-        const serverUrl = url.replace(/rest\/services.*$/i, 'rest/services');
-        return loadServiceDirectory(serverUrl, fetchFile, []);
-    }
-    return null;
-}
-exports.getArcGISServices = getArcGISServices;
-async function loadServiceDirectory(serverUrl, fetch, path) {
-    const serviceUrl = `${serverUrl}/${path.join('/')}`;
-    const response = await fetch(`${serviceUrl}?f=pjson`);
-    const directory = await response.json();
-    const services = extractServices(directory, serviceUrl);
-    const folders = (directory.folders || []);
-    const promises = folders.map((folder) => loadServiceDirectory(`${serverUrl}`, fetch, [...path, folder]));
-    for (const folderServices of await Promise.all(promises)) {
-        services.push(...folderServices);
-    }
-    return services;
-}
-function extractServices(directory, url) {
-    const arcgisServices = (directory.services || []);
-    const services = [];
-    for (const service of arcgisServices) {
-        services.push({
-            name: service.name,
-            type: `arcgis-${service.type.toLocaleLowerCase().replace('server', '-server')}`,
-            url: `${url}${service.name}/${service.type}`
-        });
-    }
-    return services;
-}

package/dist/lib/services/generic/image-service.js

@@ -1,47 +0,0 @@
-"use strict";
-// loaders.gl, MIT license
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ImageService = void 0;
-const images_1 = require("@loaders.gl/images");
-const image_source_1 = require("../../sources/image-source");
-/**
- * Quickly connect to "ad hoc" image sources without subclassing ImageSource.
- * ImageSource allows template url strings to be used to ad hoc connect to arbitrary image data sources
- * Accepts a template url string and builds requests URLs
- */
-class ImageService extends image_source_1.ImageSource {
-    constructor(props) {
-        super(props);
-    }
-    // IMAGE SOURCE API
-    async getMetadata() {
-        throw new Error('ImageSource.getMetadata not implemented');
-    }
-    async getImage(parameters) {
-        const granularParameters = this.getGranularParameters(parameters);
-        const url = this.getURLFromTemplate(granularParameters);
-        const response = await this.fetch(url);
-        const arrayBuffer = await response.arrayBuffer();
-        return await images_1.ImageLoader.parse(arrayBuffer);
-    }
-    // HELPERS
-    /** Break up bounding box in east, north, south, west */
-    getGranularParameters(parameters) {
-        const [east, north, west, south] = parameters.bbox;
-        return { ...parameters, east, north, south, west };
-    }
-    /** Supports both ${} and {} notations */
-    getURLFromTemplate(parameters) {
-        let url = this.props.url;
-        for (const [key, value] of Object.entries(parameters)) {
-            // TODO - parameter could be repeated
-            // const regex = new RegExp(`\${${key}}`, 'g');
-            url = url.replace(`\${${key}}`, String(value));
-            url = url.replace(`{${key}}`, String(value));
-        }
-        return url;
-    }
-}
-exports.ImageService = ImageService;
-ImageService.type = 'template';
-ImageService.testURL = (url) => url.toLowerCase().includes('{');

package/dist/lib/services/ogc/csw-service.js

@@ -1,168 +0,0 @@
-"use strict";
-// loaders.gl, MIT license
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CSWService = void 0;
-const data_source_1 = require("../../sources/data-source");
-const csw_capabilities_loader_1 = require("../../../csw-capabilities-loader");
-const csw_records_loader_1 = require("../../../csw-records-loader");
-const csw_domain_loader_1 = require("../../../csw-domain-loader");
-const wms_error_loader_1 = require("../../../wms-error-loader");
-/**
- * The CSWService class
- * - provides type safe methods to form URLs to a CSW service
- * - provides type safe methods to query and parse results (and errors) from a CSW service
- * @note Only the URL parameter conversion is supported. XML posts are not supported.
- */
-class CSWService extends data_source_1.DataSource {
-    /** Create a CSWService */
-    constructor(props) {
-        super(props);
-        this.capabilities = null;
-        /** A list of loaders used by the CSWService methods */
-        this.loaders = [wms_error_loader_1.WMSErrorLoader, csw_capabilities_loader_1.CSWCapabilitiesLoader];
-    }
-    async getMetadata() {
-        const capabilities = await this.getCapabilities();
-        return this.normalizeMetadata(capabilities);
-    }
-    normalizeMetadata(capabilities) {
-        return capabilities;
-    }
-    async getServiceDirectory(options) {
-        const services = [];
-        const unknownServices = [];
-        const records = await this.getRecords();
-        for (const record of records.records) {
-            for (const reference of record.references) {
-                const url = reference.value;
-                switch (reference.scheme) {
-                    case 'OGC:WMS':
-                        services.push({ name: record.title, type: 'ogc-wms-service', ...this._parseOGCUrl(url) });
-                        break;
-                    case 'OGC:WMTS':
-                        services.push({
-                            name: record.title,
-                            type: 'ogc-wmts-service',
-                            ...this._parseOGCUrl(url)
-                        });
-                        break;
-                    case 'OGC:WFS':
-                        services.push({ name: record.title, type: 'ogc-wfs-service', ...this._parseOGCUrl(url) });
-                        break;
-                    default:
-                        unknownServices.push({
-                            name: record.title,
-                            type: 'unknown',
-                            url: reference.value,
-                            scheme: reference.scheme
-                        });
-                }
-            }
-        }
-        return options?.includeUnknown ? services.concat(unknownServices) : services;
-    }
-    _parseOGCUrl(url) {
-        const parts = url.split('?');
-        return {
-            url: parts[0],
-            params: parts[1] || ''
-        };
-    }
-    // CSW Service API Stubs
-    /** Get Capabilities */
-    async getCapabilities(wmsParameters, vendorParameters) {
-        const url = this.getCapabilitiesURL(wmsParameters, vendorParameters);
-        const response = await this.fetch(url);
-        const arrayBuffer = await response.arrayBuffer();
-        this._checkResponse(response, arrayBuffer);
-        const capabilities = await csw_capabilities_loader_1.CSWCapabilitiesLoader.parse(arrayBuffer, this.props.loadOptions);
-        return capabilities;
-    }
-    /** Get Records */
-    async getRecords(wmsParameters, vendorParameters) {
-        const url = this.getRecordsURL(wmsParameters, vendorParameters);
-        const response = await this.fetch(url);
-        const arrayBuffer = await response.arrayBuffer();
-        this._checkResponse(response, arrayBuffer);
-        return await csw_records_loader_1.CSWRecordsLoader.parse(arrayBuffer, this.props.loadOptions);
-    }
-    /** Get Domain */
-    async getDomain(wmsParameters, vendorParameters) {
-        const url = this.getDomainURL(wmsParameters, vendorParameters);
-        const response = await this.fetch(url);
-        const arrayBuffer = await response.arrayBuffer();
-        this._checkResponse(response, arrayBuffer);
-        return await csw_domain_loader_1.CSWDomainLoader.parse(arrayBuffer, this.props.loadOptions);
-    }
-    // Typed URL creators
-    // For applications that want full control of fetching and parsing
-    /** Generate a URL for the GetCapabilities request */
-    getCapabilitiesURL(wmsParameters, vendorParameters) {
-        const options = {
-            version: '3.0.0',
-            ...wmsParameters,
-            ...vendorParameters,
-            service: 'CSW',
-            request: 'GetCapabilities'
-        };
-        return this._getCSWUrl(options, vendorParameters);
-    }
-    /** Generate a URL for the GetCapabilities request */
-    getRecordsURL(wmsParameters, vendorParameters) {
-        const options = {
-            version: '3.0.0',
-            typenames: 'csw:Record',
-            ...wmsParameters,
-            ...vendorParameters,
-            service: 'CSW',
-            request: 'GetRecords'
-        };
-        return this._getCSWUrl(options, vendorParameters);
-    }
-    /** Generate a URL for the GetCapabilities request */
-    getDomainURL(wmsParameters, vendorParameters) {
-        const options = {
-            version: '3.0.0',
-            ...wmsParameters,
-            ...vendorParameters,
-            service: 'CSW',
-            request: 'GetDomain'
-        };
-        return this._getCSWUrl(options, vendorParameters);
-    }
-    // INTERNAL METHODS
-    /**
-     * @note case _getCSWUrl may need to be overridden to handle certain backends?
-     * */
-    _getCSWUrl(options, vendorParameters) {
-        let url = this.props.url;
-        let first = true;
-        for (const [key, value] of Object.entries(options)) {
-            url += first ? '?' : '&';
-            first = false;
-            if (Array.isArray(value)) {
-                url += `${key.toUpperCase()}=${value.join(',')}`;
-            }
-            else {
-                url += `${key.toUpperCase()}=${value ? String(value) : ''}`;
-            }
-        }
-        return encodeURI(url);
-    }
-    /** Checks for and parses a CSW XML formatted ServiceError and throws an exception */
-    _checkResponse(response, arrayBuffer) {
-        const contentType = response.headers['content-type'];
-        if (!response.ok || wms_error_loader_1.WMSErrorLoader.mimeTypes.includes(contentType)) {
-            const error = wms_error_loader_1.WMSErrorLoader.parseSync?.(arrayBuffer, this.props.loadOptions);
-            throw new Error(error);
-        }
-    }
-    /** Error situation detected */
-    _parseError(arrayBuffer) {
-        const error = wms_error_loader_1.WMSErrorLoader.parseSync?.(arrayBuffer, this.props.loadOptions);
-        return new Error(error);
-    }
-}
-exports.CSWService = CSWService;
-CSWService.type = 'csw';
-CSWService.testURL = (url) => url.toLowerCase().includes('csw');