@loaders.gl/wms 3.4.0-alpha.1 → 3.4.0-alpha.3

package/dist/wms-capabilities-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wms-capabilities-loader.d.ts","sourceRoot":"","sources":["../src/wms-capabilities-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,gBAAgB,EAAE,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAO9E,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG;IAC7C,GAAG,CAAC,EAAE,EAAE,CAAC;CACV,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;yBAaL,WAAW,YAAY,gBAAgB;0BAE5C,MAAM,YAAY,gBAAgB;CACzD,CAAC;AAEF,iBAAS,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG1C;AAED,eAAO,MAAM,+BAA+B,EAAE,gBAAwC,CAAC"}
+{"version":3,"file":"wms-capabilities-loader.d.ts","sourceRoot":"","sources":["../src/wms-capabilities-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,gBAAgB,EAAE,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAC9E,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,0CAA0C,CAAC;AAQ9E,YAAY,EAAC,eAAe,EAAC,CAAC;AAE9B,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG;IAC7C,GAAG,CAAC,EAAE;QACJ,oDAAoD;QACpD,mBAAmB,CAAC,EAAE,OAAO,CAAC;QAC9B,gDAAgD;QAChD,GAAG,CAAC,EAAE,OAAO,CAAC;KACf,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;yBAaL,WAAW,YAAY,gBAAgB;0BAE5C,MAAM,YAAY,gBAAgB;CAEzD,CAAC;AAEF,iBAAS,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG1C;AAED,eAAO,MAAM,+BAA+B,EAAE,gBAAwC,CAAC"}

package/dist/wms-capabilities-loader.js

@@ -2,7 +2,7 @@
 // loaders.gl, MIT license
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._typecheckWMSCapabilitiesLoader = exports.WMSCapabilitiesLoader = void 0;
-const parse_wms_1 = require("./lib/wms/parse-wms");
+const parse_wms_capabilities_1 = require("./lib/parsers/wms/parse-wms-capabilities");
 // __VERSION__ is injected by babel-plugin-version-inline
 // @ts-ignore TS2304: Cannot find name '__VERSION__'.
 const VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'latest';
@@ -21,8 +21,8 @@ exports.WMSCapabilitiesLoader = {
     options: {
         wms: {}
     },
-    parse: async (arrayBuffer, options) => (0, parse_wms_1.parseWMSCapabilities)(new TextDecoder().decode(arrayBuffer), options),
-    parseTextSync: (text, options) => (0, parse_wms_1.parseWMSCapabilities)(text, options)
+    parse: async (arrayBuffer, options) => (0, parse_wms_capabilities_1.parseWMSCapabilities)(new TextDecoder().decode(arrayBuffer), options?.wms),
+    parseTextSync: (text, options) => (0, parse_wms_capabilities_1.parseWMSCapabilities)(text, options?.wms)
 };
 function testXMLFile(text) {
     // TODO - There could be space first.

package/dist/wms-error-loader.js

@@ -2,7 +2,7 @@
 // loaders.gl, MIT license
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._typecheckWMSErrorLoader = exports.WMSErrorLoader = void 0;
-const parse_wms_1 = require("./lib/wms/parse-wms");
+const parse_wms_error_1 = require("./lib/parsers/wms/parse-wms-error");
 // __VERSION__ is injected by babel-plugin-version-inline
 // @ts-ignore TS2304: Cannot find name '__VERSION__'.
 const VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'latest';
@@ -33,7 +33,7 @@ function testXMLFile(text) {
 }
 function parseTextSync(text, options) {
     const wmsOptions = { ...exports.WMSErrorLoader.options.wms, ...options?.wms };
-    const error = (0, parse_wms_1.parseWMSError)(text, wmsOptions);
+    const error = (0, parse_wms_error_1.parseWMSError)(text, wmsOptions);
     const message = wmsOptions.minimalErrors ? error : `WMS Service error: ${error}`;
     if (wmsOptions.throwOnError) {
         throw new Error(message);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loaders.gl/wms",
-  "version": "3.4.0-alpha.1",
+  "version": "3.4.0-alpha.3",
   "description": "Framework-independent loaders for the WMS (Web Map Service) standard",
   "license": "MIT",
   "publishConfig": {
@@ -35,14 +35,14 @@
   ],
   "scripts": {
     "pre-build": "npm run build-bundle",
-    "build-bundle": "esbuild src/bundle.ts --bundle --outfile=dist/dist.min.js --platform=node"
+    "build-bundle": "esbuild src/bundle.ts --bundle --outfile=dist/dist.min.js"
   },
   "dependencies": {
     "@babel/runtime": "^7.3.1",
-    "@loaders.gl/images": "3.4.0-alpha.1",
-    "@loaders.gl/loader-utils": "3.4.0-alpha.1",
-    "@loaders.gl/schema": "3.4.0-alpha.1",
-    "@loaders.gl/xml": "3.4.0-alpha.1",
+    "@loaders.gl/images": "3.4.0-alpha.3",
+    "@loaders.gl/loader-utils": "3.4.0-alpha.3",
+    "@loaders.gl/schema": "3.4.0-alpha.3",
+    "@loaders.gl/xml": "3.4.0-alpha.3",
     "@turf/rewind": "^5.1.5",
     "deep-strict-equal": "^0.2.0",
     "lerc": "^4.0.1"
@@ -50,5 +50,5 @@
   "devDependencies": {
     "xmldom": "0.6.0"
   },
-  "gitHead": "4085b0323050e4361614471319a1fb4729547bbf"
+  "gitHead": "a954528dd1d78a1f128d8f6b07e4baeb7a296924"
 }

package/src/csw-capabilities-loader.ts

@@ -0,0 +1,46 @@
+// loaders.gl, MIT license
+
+import type {LoaderWithParser} from '@loaders.gl/loader-utils';
+import type {XMLLoaderOptions} from '@loaders.gl/xml';
+import type {CSWCapabilities} from './lib/parsers/csw/parse-csw-capabilities';
+import {parseCSWCapabilities} from './lib/parsers/csw/parse-csw-capabilities';
+
+// __VERSION__ is injected by babel-plugin-version-inline
+// @ts-ignore TS2304: Cannot find name '__VERSION__'.
+const VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'latest';
+
+// parsed data type
+export type {CSWCapabilities};
+
+/** CSW loader options */
+export type CSWLoaderOptions = XMLLoaderOptions & {
+  csw?: {};
+};
+
+/**
+ * Loader for the response to the CSW GetCapability request
+ */
+export const CSWCapabilitiesLoader = {
+  id: 'csw-capabilities',
+  name: 'CSW Capabilities',
+
+  module: 'wms',
+  version: VERSION,
+  worker: false,
+  extensions: ['xml'],
+  mimeTypes: ['application/vnd.ogc.csw_xml', 'application/xml', 'text/xml'],
+  testText: testXMLFile,
+  options: {
+    csw: {}
+  },
+  parse: async (arrayBuffer: ArrayBuffer, options?: CSWLoaderOptions) =>
+    parseCSWCapabilities(new TextDecoder().decode(arrayBuffer), options),
+  parseTextSync: (text: string, options?: CSWLoaderOptions) => parseCSWCapabilities(text, options)
+};
+
+function testXMLFile(text: string): boolean {
+  // TODO - There could be space first.
+  return text.startsWith('<?xml');
+}
+
+export const _typecheckCSWCapabilitiesLoader: LoaderWithParser = CSWCapabilitiesLoader;

package/src/csw-domain-loader.ts

@@ -0,0 +1,44 @@
+// loaders.gl, MIT license
+
+import type {LoaderWithParser} from '@loaders.gl/loader-utils';
+import type {XMLLoaderOptions} from '@loaders.gl/xml';
+import type {CSWDomain} from './lib/parsers/csw/parse-csw-domain';
+import {parseCSWDomain} from './lib/parsers/csw/parse-csw-domain';
+
+// __VERSION__ is injected by babel-plugin-version-inline
+// @ts-ignore TS2304: Cannot find name '__VERSION__'.
+const VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'latest';
+
+export type {CSWDomain};
+
+export type CSWLoaderOptions = XMLLoaderOptions & {
+  csw?: {};
+};
+
+/**
+ * Loader for the response to the CSW GetCapability request
+ */
+export const CSWDomainLoader = {
+  id: 'csw-domain',
+  name: 'CSW Domain',
+
+  module: 'wms',
+  version: VERSION,
+  worker: false,
+  extensions: ['xml'],
+  mimeTypes: ['application/vnd.ogc.csw_xml', 'application/xml', 'text/xml'],
+  testText: testXMLFile,
+  options: {
+    csw: {}
+  },
+  parse: async (arrayBuffer: ArrayBuffer, options?: CSWLoaderOptions) =>
+    parseCSWDomain(new TextDecoder().decode(arrayBuffer), options),
+  parseTextSync: (text: string, options?: CSWLoaderOptions) => parseCSWDomain(text, options)
+};
+
+function testXMLFile(text: string): boolean {
+  // TODO - There could be space first.
+  return text.startsWith('<?xml');
+}
+
+export const _typecheckCSWDomainLoader: LoaderWithParser = CSWDomainLoader;

package/src/csw-records-loader.ts

@@ -0,0 +1,42 @@
+// loaders.gl, MIT license
+
+import type {LoaderWithParser} from '@loaders.gl/loader-utils';
+import type {XMLLoaderOptions} from '@loaders.gl/xml';
+import type {CSWRecords} from './lib/parsers/csw/parse-csw-records';
+import {parseCSWRecords} from './lib/parsers/csw/parse-csw-records';
+
+// __VERSION__ is injected by babel-plugin-version-inline
+// @ts-ignore TS2304: Cannot find name '__VERSION__'.
+const VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'latest';
+
+export {CSWRecords};
+
+export type CSWLoaderOptions = XMLLoaderOptions & {
+  csw?: {};
+};
+
+/**
+ * Loader for the response to the CSW GetCapability request
+ */
+export const CSWRecordsLoader: LoaderWithParser = {
+  id: 'csw-records',
+  name: 'CSW Domain',
+
+  module: 'wms',
+  version: VERSION,
+  worker: false,
+  extensions: ['xml'],
+  mimeTypes: ['application/vnd.ogc.csw_xml', 'application/xml', 'text/xml'],
+  testText: testXMLFile,
+  options: {
+    csw: {}
+  },
+  parse: async (arrayBuffer: ArrayBuffer, options?: CSWLoaderOptions) =>
+    parseCSWRecords(new TextDecoder().decode(arrayBuffer), options),
+  parseTextSync: (text: string, options?: CSWLoaderOptions) => parseCSWRecords(text, options)
+};
+
+function testXMLFile(text: string): boolean {
+  // TODO - There could be space first.
+  return text.startsWith('<?xml');
+}

package/src/{wip/gml-loader.ts → gml-loader.ts}

@@ -1,7 +1,7 @@
 // loaders.gl, MIT license
 
 import type {LoaderWithParser, LoaderOptions} from '@loaders.gl/loader-utils';
-import {parseGML} from '../lib/gml/parse-gml';
+import {parseGML} from './lib/parsers/gml/parse-gml';
 
 // __VERSION__ is injected by babel-plugin-version-inline
 // @ts-ignore TS2304: Cannot find name '__VERSION__'.
@@ -22,7 +22,7 @@ export const GMLLoader = {
   version: VERSION,
   worker: false,
   extensions: ['xml'],
-  mimeTypes: ['application/vnd.ogc.gml_xml', 'application/xml', 'text/xml'],
+  mimeTypes: ['application/vnd.ogc.gml', 'application/xml', 'text/xml'],
   testText: testXMLFile,
   options: {
     gml: {}

package/src/index.ts

@@ -1,58 +1,77 @@
 // loaders.gl, MIT license
 
-// WMS
+// CSW - Catalog Service for the Web
 
-export {WMSErrorLoader} from './wms-error-loader';
+export type {CSWLoaderOptions} from './csw-capabilities-loader';
 
-export type {WMSLoaderOptions} from './wms-capabilities-loader';
+export type {CSWCapabilities} from './csw-capabilities-loader';
+export {CSWCapabilitiesLoader} from './csw-capabilities-loader';
 
-export type {WMSCapabilities} from './lib/wms/wms-types';
-export {WMSCapabilitiesLoader} from './wms-capabilities-loader';
+export type {CSWDomain} from './csw-domain-loader';
+export {CSWDomainLoader} from './csw-domain-loader';
 
-// NOTE: Will likely move to tiles module
-export type {ImageSourceMetadata} from './lib/data-sources/image-source';
-export type {ImageType} from '@loaders.gl/images';
-export {ImageSource} from './lib/data-sources/image-source';
+export type {CSWRecords} from './csw-records-loader';
+export {CSWRecordsLoader} from './csw-records-loader';
 
-export type {ImageServiceType} from './lib/data-sources/create-image-source';
-export {createImageSource} from './lib/data-sources/create-image-source';
+// WMS - Web Map Service
 
-export type {ImageServiceProps} from './lib/data-sources/image-services/image-service';
-export {ImageService} from './lib/data-sources/image-services/image-service';
-export {WMSService} from './lib/data-sources/image-services/wms-service';
-export {ArcGISImageService as _ArcGISImageService} from './lib/data-sources/image-services/arcgis-image-service';
+export {WMSErrorLoader} from './wms-error-loader';
 
-// WIP /////////////////////////////////////////////////////////////////
-// Plumbing set up but details of parsing and typing not yet completed
+export type {WMSLoaderOptions} from './wms-capabilities-loader';
 
-// WMS
+export type {WMSCapabilities} from './wms-capabilities-loader';
+export {WMSCapabilitiesLoader} from './wms-capabilities-loader';
 
-export type {WMSFeatureInfo as _WMSFeatureInfo} from './lib/wms/wms-types';
+export type {WMSFeatureInfo as _WMSFeatureInfo} from './wip/wms-feature-info-loader';
 export {WMSFeatureInfoLoader as _WMSFeatureInfoLoader} from './wip/wms-feature-info-loader';
 
-export type {WMSLayerDescription as _WMSLayerDescription} from './lib/wms/wms-types';
+export type {WMSLayerDescription as _WMSLayerDescription} from './wip/wms-layer-description-loader';
 export {WMSLayerDescriptionLoader as _WMSLayerDescriptionLoader} from './wip/wms-layer-description-loader';
 
-// WMTS
+// WMTS - Web Map Tile Service
 
-export type {WMTSCapabilities as _WMTSCapabilities} from './lib/wmts/wmts-types';
-export type {WMTSLoaderOptions as _WMTSLoaderOptions} from './wip/wmts-capabilities-loader';
-export {WMTSCapabilitiesLoader as _WMTSCapabilitiesLoader} from './wip/wmts-capabilities-loader';
+// export type {WMTSLoaderOptions as _WMTSLoaderOptions} from './wip/wmts-capabilities-loader';
+// export type {WMTSCapabilities as _WMTSCapabilities} from './wip/wmts-capabilities-loader';
+// export {WMTSCapabilitiesLoader as _WMTSCapabilitiesLoader} from './wip/wmts-capabilities-loader';
 
-// WFS
+// WFS - Web Feature Service
 
-export type {WFSCapabilities as _WFSCapabilities} from './lib/wfs/wfs-types';
 export type {WFSLoaderOptions as _WFSLoaderOptions} from './wip/wfs-capabilities-loader';
+
+export type {WFSCapabilities as _WFSCapabilities} from './wip/wfs-capabilities-loader';
 export {WFSCapabilitiesLoader as _WFSCapabilitiesLoader} from './wip/wfs-capabilities-loader';
 
-// GML
+// GML - Geographic Markup Language
 
 export type {GeoJSON as _GeoJSON} from '@loaders.gl/schema';
-export type {GMLLoaderOptions as _GMLLoaderOptions} from './wip/gml-loader';
-export {GMLLoader as _GMLLoader} from './wip/gml-loader';
+export type {GMLLoaderOptions as _GMLLoaderOptions} from './gml-loader';
+export {GMLLoader as _GMLLoader} from './gml-loader';
+
+// EXPERIMENTAL: DATA SOURCES
+
+export type {ImageSourceMetadata} from './lib/sources/image-source';
+export type {ImageType} from '@loaders.gl/images';
+export {ImageSource} from './lib/sources/image-source';
+
+export type {ImageServiceType} from './lib/create-image-source';
+export {createImageSource} from './lib/create-image-source';
+
+// Generic (Template URL) Services
+
+export type {ImageServiceProps} from './lib/services/generic/image-service';
+export {ImageService} from './lib/services/generic/image-service';
+
+// OGC Services
+
+export {CSWService} from './lib/services/ogc/csw-service';
+export {WMSService} from './lib/services/ogc/wms-service';
+
+// ArcGIS Services
 
-// LERC
+export {getArcGISServices as _getArcGISServices} from './lib/services/arcgis/arcgis-server';
+export {ArcGISImageServer as _ArcGISImageServer} from './lib/services/arcgis/arcgis-image-service';
 
+// LERC - Limited Error Raster Compression
 // TODO - restore once esbuild bundling issues have been resolved
 // export type {LERCData} from './lib/lerc/lerc-types';
 // export {LERCLoader} from './lerc-loader';

package/src/lerc-loader.ts

@@ -1,7 +1,7 @@
 // loaders.gl, MIT license
 
 import type {LoaderWithParser, LoaderOptions} from '@loaders.gl/loader-utils';
-import type {LERCData} from './lib/lerc/lerc-types';
+import type {LERCData} from './lib/parsers/lerc/lerc-types';
 import * as Lerc from 'lerc';
 
 // __VERSION__ is injected by babel-plugin-version-inline

package/src/lib/{data-sources/create-image-source.ts → create-image-source.ts}

@@ -1,26 +1,28 @@
 // loaders.gl, MIT license
 
-import {ImageSource} from './image-source';
-import {ImageService, ImageServiceProps} from './image-services/image-service';
-import {WMSService} from './image-services/wms-service';
-import {ArcGISImageService} from './image-services/arcgis-image-service';
+import {ImageSource} from './sources/image-source';
+import {ImageService, ImageServiceProps} from './services/generic/image-service';
+import type {WMSServiceProps} from './services/ogc/wms-service';
+import {WMSService} from './services/ogc/wms-service';
+import {ArcGISImageServer} from './services/arcgis/arcgis-image-service';
 
 export type ImageServiceType = 'wms' | 'arcgis-image-server' | 'template';
 
-const SERVICES = [WMSService, ArcGISImageService, ImageService];
+const SERVICES = [WMSService, ArcGISImageServer, ImageService];
 
-type Props = ImageServiceProps & {
-  type?: ImageServiceType | 'auto';
-};
+type ImageSourceProps = ImageServiceProps &
+  WMSServiceProps & {
+    type?: ImageServiceType | 'auto';
+  };
 
 /**
  * Creates an image source
- * If type is not supplied, will try to automatically detec the the
+ * If type is not supplied, will try to automatically detect the the
  * @param url URL to the image source
  * @param type type of source. if not known, set to 'auto'
  * @returns an ImageSource instance
  */
-export function createImageSource(props: Props): ImageSource {
+export function createImageSource(props: ImageSourceProps): ImageSource {
   const {type = 'auto'} = props;
   const serviceType = type === 'auto' ? guessServiceType(props.url) : type;
   switch (serviceType) {

package/src/lib/parsers/csw/parse-csw-capabilities.ts

@@ -0,0 +1,103 @@
+// loaders.gl, MIT license
+
+import type {XMLLoaderOptions} from '@loaders.gl/xml';
+import {XMLLoader} from '@loaders.gl/xml';
+import {parseExceptionReport} from './parse-exception-report';
+
+// CSW:GetCapabilitiesResponse
+
+/** All capabilities of a CSW service - response to a CSW `GetCapabilities` data structure extracted from XML */
+export type CSWCapabilities = {
+  serviceIdentification: {
+    title: string;
+    serviceTypeVersion: string;
+    serviceType: string;
+  };
+
+  serviceProvider: {
+    providerName: string;
+    providerSite: string;
+    serviceContact: {
+      individualName: string;
+      positionName: string;
+      contactInfo: {
+        address: {
+          administrativeArea: string;
+          city: string;
+          country: string;
+          deliveryPoint: string;
+          electronicMailAddress: string;
+          postalCode: string;
+        };
+        phone: {
+          voice: string;
+        };
+      };
+    };
+  };
+
+  operationsMetadata: {
+    GetCapabilities: any;
+    GetFeatureInfo: any;
+    GetTile: any;
+  };
+
+  contents: {
+    layers: {
+      abstract: string;
+      identifier: string;
+      title: string;
+      formats: string[];
+      styles: {
+        identifier: string;
+        isDefault: string;
+        title: string;
+        abstract?: string;
+      }[];
+      bounds: {
+        left: number;
+        right: number;
+        bottom: number;
+        top: number;
+      };
+      tileMatrixSetLinks: {
+        tileMatrixSet: string;
+      }[];
+      tileMatrixSets: {
+        identifier: string;
+        matrixIds: {
+          identifier: string;
+          matrixHeight: number;
+          matrixWidth: number;
+          scaleDenominator: number;
+          tileWidth: number;
+          tileHeight: number;
+          topLeftCorner: {
+            lon: number;
+            lat: number;
+          };
+        }[];
+      };
+    }[];
+  };
+};
+
+/**
+ * Parses a typed data structure from raw XML for `GetCapabilities` response
+ * @note Error handlings is fairly weak
+ */
+export function parseCSWCapabilities(text: string, options?: XMLLoaderOptions): CSWCapabilities {
+  const parsedXML = XMLLoader.parseTextSync(text, {
+    ...options,
+    xml: {
+      ...options?.xml,
+      removeNSPrefix: true,
+      uncapitalizeKeys: true
+    }
+  });
+
+  parseExceptionReport(parsedXML);
+
+  const xmlCapabilities: any = parsedXML.capabilities || parsedXML;
+  return xmlCapabilities;
+}

package/src/lib/parsers/csw/parse-csw-domain.ts

@@ -0,0 +1,45 @@
+// loaders.gl, MIT license
+
+import type {XMLLoaderOptions} from '@loaders.gl/xml';
+import {XMLLoader} from '@loaders.gl/xml';
+import {parseExceptionReport} from './parse-exception-report';
+
+/** Describes the values of resource */
+export type CSWDomain = {
+  domainValues: {
+    type: string;
+    propertyName: string;
+    values: {
+      [key: string]: unknown;
+    }[];
+  }[];
+};
+
+/**
+ * Parses a typed data structure from raw XML for `GetDomain` response
+ * @note Error handlings is fairly weak
+ */
+export function parseCSWDomain(text: string, options?: XMLLoaderOptions): CSWDomain {
+  const parsedXML = XMLLoader.parseTextSync(text, {
+    ...options,
+    xml: {
+      ...options?.xml,
+      removeNSPrefix: true,
+      uncapitalizeKeys: true,
+      arrayPaths: [
+        'GetDomainResponse.DomainValues',
+        'GetDomainResponse.DomainValues.ListOfValues.value'
+      ]
+    }
+  });
+
+  parseExceptionReport(parsedXML);
+
+  const xmlDomain: any = parsedXML.getDomainResponse;
+  for (const domainValue of xmlDomain.domainValues) {
+    // Drop the nested <listOfValues><value><value><listOfValues>  => values[]
+    domainValue.values = domainValue.listOfValues?.value;
+    delete domainValue.listOfValues;
+  }
+  return xmlDomain as CSWDomain;
+}

package/src/lib/parsers/csw/parse-csw-records.ts

@@ -0,0 +1,90 @@
+// loaders.gl, MIT license
+
+import {XMLLoaderOptions, convertXMLFieldToArrayInPlace} from '@loaders.gl/xml';
+import {XMLLoader} from '@loaders.gl/xml';
+import {parseExceptionReport} from './parse-exception-report';
+
+export type CSWRecords = {
+  searchStatus: {
+    timestamp?: string;
+  };
+  searchResults: {
+    numberOfRecordsMatched: number;
+    numberOfRecordsReturned: number;
+    elementSet: string;
+    nextRecord: number;
+  };
+  records: {
+    type: string;
+    title: string;
+    abstract: string;
+    subject: string[];
+    boundingBoxes: {
+      crs: string;
+      value: [number, number, number, number];
+    }[];
+    references: {
+      value: string;
+      scheme: string;
+    }[];
+  }[];
+};
+
+/**
+ * Parses a typed data structure from raw XML for `GetRecords` response
+ * @note Error handlings is fairly weak
+ */
+export function parseCSWRecords(text: string, options?: XMLLoaderOptions): CSWRecords {
+  const parsedXML = XMLLoader.parseTextSync(text, {
+    ...options,
+    xml: {
+      ...options?.xml,
+      removeNSPrefix: true,
+      uncapitalizeKeys: true,
+      arrayPaths: []
+    },
+    _fastXML: {
+      ...options?._fastXML,
+      parseAttributeValue: true
+    }
+  });
+
+  parseExceptionReport(parsedXML);
+
+  const xmlRecords: any = parsedXML.getRecordsResponse;
+
+  // Move results to top
+  const elementSet = xmlRecords.searchResults.elementSet;
+  const recordsFieldName = `${elementSet}Record`;
+  xmlRecords.records = xmlRecords.searchResults[recordsFieldName];
+  delete xmlRecords.searchResults[recordsFieldName];
+
+  convertXMLFieldToArrayInPlace(xmlRecords, 'records');
+
+  for (const record of xmlRecords.records) {
+    record.boundingBoxes = record.boundingBox;
+    delete record.boundingBox;
+
+    convertXMLFieldToArrayInPlace(record, 'boundingBoxes');
+
+    for (const boundingBox of record.boundingBoxes) {
+      boundingBox.value = [
+        boundingBox.upperCorner[0],
+        boundingBox.upperCorner[1],
+        boundingBox.lowerCorner[0],
+        boundingBox.lowerCorner[1]
+      ];
+      delete boundingBox.upperCorner;
+      delete boundingBox.lowerCorner;
+    }
+  }
+
+  return xmlRecords as CSWRecords;
+}
+
+export function renameXMLTags(xml: any, renameKeys: Record<string, string>): void {
+  for (const [oldKey, newKey] of Object.entries(renameKeys)) {
+    xml[newKey] = xml[oldKey];
+    delete xml[oldKey];
+  }
+}

package/src/lib/parsers/csw/parse-exception-report.ts

@@ -0,0 +1,31 @@
+// loaders.gl, MIT license
+
+// import type {XMLLoaderOptions} from '@loaders.gl/xml';
+// import {XMLLoader} from '@loaders.gl/xml';
+
+/**
+ * Parses a typed data structure from raw XML for `GetDomain` response
+ * @note Error handlings is fairly weak
+ */
+export function parseExceptionReport(parsedXML: any): void {
+  // const parsedXML = XMLLoader.parseTextSync(text, {
+  //   ...options,
+  //   xml: {
+  //     ...options?.xml,
+  //     removeNSPrefix: true,
+  //     uncapitalizeKeys: true
+  //   }
+  // });
+
+  const exceptionReport: any = parsedXML.exceptionReport;
+  if (!exceptionReport) {
+    return;
+  }
+  const errorMessage =
+    exceptionReport.exception?.exceptionText ||
+    exceptionReport.exception?.exceptionCode ||
+    exceptionReport.exception?.locator ||
+    'server error';
+
+  throw new Error(`Catalog Server: ${errorMessage}`);
+}