@loaders.gl/wms 3.3.0-alpha.9 → 3.4.0-alpha.1

package/src/wip/wfs-capabilities-loader.ts

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

package/src/{wms-feature-info-loader.ts → wip/wms-feature-info-loader.ts}

@@ -1,8 +1,8 @@
 // loaders.gl, MIT license
 
 import type {LoaderWithParser} from '@loaders.gl/loader-utils';
-import {WMSCapabilitiesLoader, WMSLoaderOptions} from './wms-capabilities-loader';
-import {parseWMSFeatureInfo} from './lib/parse-wms';
+import {WMSCapabilitiesLoader, WMSLoaderOptions} from '../wms-capabilities-loader';
+import {parseWMSFeatureInfo} from '../lib/wms/parse-wms';
 
 /**
  * Loader for the response to the WMS GetFeatureInfo request
@@ -10,8 +10,8 @@ import {parseWMSFeatureInfo} from './lib/parse-wms';
 export const WMSFeatureInfoLoader = {
   ...WMSCapabilitiesLoader,
 
-  name: 'WMS FeatureInfo',
   id: 'wms-feature-info',
+  name: 'WMS FeatureInfo',
 
   parse: async (arrayBuffer: ArrayBuffer, options?: WMSLoaderOptions) =>
     parseWMSFeatureInfo(new TextDecoder().decode(arrayBuffer), options),

package/src/wip/wms-layer-description-loader.md.disabled.md

@@ -0,0 +1,47 @@
+# WMSLayerDescriptionLoader
+
+<p class="badges">
+  <img src="https://img.shields.io/badge/From-v3.3-blue.svg?style=flat-square" alt="From-v3.3" />
+	<img src="https://img.shields.io/badge/-BETA-teal.svg" alt="BETA" />
+</p>
+
+The `WMSLayerDescriptionLoader` parses the XML-formatted response from the 
+the [OGC](https://www.opengeospatial.org/) [WMS](https://www.ogc.org/standards/wms) (Web Map Service) standard `DescribeLayer` request into a typed JavaScript data structure.
+
+> Note that the WMS standard is rather verbose and the XML responses can contain many rarely used metadata fields, not all of which are extracted by this loader. If this is a problem, it is possible to use the `XMLLoader` directly though the result will be untyped and not normalized.
+
+| Loader                | Characteristic                                       |
+| --------------------- | ---------------------------------------------------- |
+| File Extension        | `.xml`                                               |
+| File Type             | Text                                                 |
+| File Format           | [WMS](https://en.wikipedia.org/wiki/Web_Map_Service) |
+| Data Format           | Data structure         |
+| Decoder Type          | Synchronous                                          |
+| Worker Thread Support | No                                                  |
+| Streaming Support     | No                                                   |
+
+## Usage
+
+```js
+import {WMSLayerDescriptionLoader} from '@loaders.gl/wms';
+import {load} from '@loaders.gl/core';
+
+// Form a WMS request
+const url = `${WMS_SERVICE_URL}?REQUEST=DescribeLayer&LAYER=...`;
+
+const data = await load(url, WMSLayerDescriptionLoader, options);
+```
+
+## Parsed Data Format
+
+```typescript
+/** All capabilities of a WMS service. Typed data structure extracted from XML */
+export type WMSLayerDescription = {
+  // TO BE DOCUMENTED
+}
+```
+
+## Options
+
+| Option | Type | Default | Description |
+| ------ | ---- | ------- | ----------- |

package/src/{wms-layer-description-loader.ts → wip/wms-layer-description-loader.ts}

@@ -1,21 +1,21 @@
 // loaders.gl, MIT license
 
 import type {LoaderWithParser} from '@loaders.gl/loader-utils';
-import {WMSCapabilitiesLoader, WMSLoaderOptions} from './wms-capabilities-loader';
-import {parseWMSFeatureInfo} from './lib/parse-wms';
+import {WMSCapabilitiesLoader, WMSLoaderOptions} from '../wms-capabilities-loader';
+import {parseWMSLayerDescription} from '../lib/wms/parse-wms';
 
 /**
- * Loader for the response to the WMS GetFeatureInfo request
+ * Loader for the response to the WMS DescribeLayer request
  */
 export const WMSLayerDescriptionLoader = {
   ...WMSCapabilitiesLoader,
 
-  name: 'WMS DescribeLayer',
   id: 'wms-layer-description',
+  name: 'WMS DescribeLayer',
 
   parse: async (arrayBuffer: ArrayBuffer, options?: WMSLoaderOptions) =>
-    parseWMSFeatureInfo(new TextDecoder().decode(arrayBuffer), options),
-  parseTextSync: (text: string, options?: WMSLoaderOptions) => parseWMSFeatureInfo(text, options)
+    parseWMSLayerDescription(new TextDecoder().decode(arrayBuffer), options),
+  parseTextSync: (text: string, options?: WMSLoaderOptions) => parseWMSLayerDescription(text, options)
 };
 
 export const _typecheckWMSFeatureInfoLoader: LoaderWithParser = WMSLayerDescriptionLoader;

package/src/wip/wmts-capabilities-loader.ts

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

package/src/wms-capabilities-loader.ts

@@ -1,7 +1,7 @@
 // loaders.gl, MIT license
 
 import type {LoaderWithParser, LoaderOptions} from '@loaders.gl/loader-utils';
-import {parseWMSCapabilities} from './lib/parse-wms';
+import {parseWMSCapabilities} from './lib/wms/parse-wms';
 
 // __VERSION__ is injected by babel-plugin-version-inline
 // @ts-ignore TS2304: Cannot find name '__VERSION__'.
@@ -15,8 +15,8 @@ export type WMSLoaderOptions = LoaderOptions & {
  * Loader for the response to the WMS GetCapability request
  */
 export const WMSCapabilitiesLoader = {
-  name: 'WMS Capabilities',
   id: 'wms-capabilities',
+  name: 'WMS Capabilities',
 
   module: 'wms',
   version: VERSION,

package/src/wms-error-loader.ts

@@ -0,0 +1,59 @@
+// loaders.gl, MIT license
+
+import type {LoaderWithParser, LoaderOptions} from '@loaders.gl/loader-utils';
+import {parseWMSError} from './lib/wms/parse-wms';
+
+// __VERSION__ is injected by babel-plugin-version-inline
+// @ts-ignore TS2304: Cannot find name '__VERSION__'.
+const VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'latest';
+
+export type WMSLoaderOptions = LoaderOptions & {
+  wms?: {
+    /** By default the error loader will throw an error with the parsed error message */
+    throwOnError?: boolean;
+    /** Do not add any text to errors */
+    minimalErrors?: boolean;
+  };
+};
+
+/**
+ * Loader for the response to the WMS GetCapability request
+ */
+export const WMSErrorLoader = {
+  id: 'wms-error',
+  name: 'WMS Error',
+
+  module: 'wms',
+  version: VERSION,
+  worker: false,
+  extensions: ['xml'],
+  mimeTypes: ['application/vnd.ogc.se_xml', 'application/xml', 'text/xml'],
+  testText: testXMLFile,
+  options: {
+    wms: {
+      throwOnError: false
+    }
+  },
+  parse: async (arrayBuffer: ArrayBuffer, options?: WMSLoaderOptions): Promise<string> =>
+    parseTextSync(new TextDecoder().decode(arrayBuffer), options),
+  parseSync: (arrayBuffer: ArrayBuffer, options?: WMSLoaderOptions): string =>
+    parseTextSync(new TextDecoder().decode(arrayBuffer), options),
+  parseTextSync: (text: string, options?: WMSLoaderOptions): string => parseTextSync(text, options)
+};
+
+function testXMLFile(text: string): boolean {
+  // TODO - There could be space first.
+  return text.startsWith('<?xml');
+}
+
+function parseTextSync(text: string, options?: WMSLoaderOptions): string {
+  const wmsOptions: WMSLoaderOptions['wms'] = {...WMSErrorLoader.options.wms, ...options?.wms};
+  const error = parseWMSError(text, wmsOptions);
+  const message = wmsOptions.minimalErrors ? error : `WMS Service error: ${error}`;
+  if (wmsOptions.throwOnError) {
+    throw new Error(message);
+  }
+  return message;
+}
+
+export const _typecheckWMSErrorLoader: LoaderWithParser = WMSErrorLoader;

package/dist/es5/lib/data-sources/image-data-source.js

@@ -1,4 +0,0 @@
-
-
-"use strict";
-//# sourceMappingURL=image-data-source.js.map

package/dist/es5/lib/data-sources/image-data-source.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"image-data-source.js","names":[],"sources":["../../../../src/lib/data-sources/image-data-source.ts"],"sourcesContent":["// loaders.gl, MIT license\n\n/*\nimport {ImageType} from '@loaders.gl/images';\n\n/** General data source class *\nexport abstract class DataSource {};\n\n/** Data source that serves data by tile index *\nexport abstract class TileDataSource extends DataSource {};\n\nexport type ImageFeatureInfo = {};\n\nexport type ImageLayerInfo = {};\n\nexport type ImageDataSourceCapabilities = {}\n\n/**\n * ImageDataSource - data sources that allow data to be queried by (geospatial) extents\n * @note\n * - If geospatial, bounding box is expected to be in web mercator coordinates\n *\nexport abstract class ImageDataSource extends DataSource {\n  abstract getCapabilities(): Promise<ImageDataSourceCapabilities>;\n  abstract getImage({boundingBox, width, height, layers, parameters}): Promise<ImageType>;\n  getFeatureInfo({layers, parameters}): Promise<ImageFeatureInfo> {\n    throw new Error('not implemented');\n  }\n  getLayerInfo({layers, parameters}): Promise<ImageLayerInfo> {\n    throw new Error('not implemented');\n  }\n  getLegendImage({layers, parameters}): Promise<ImageType> {\n    throw new Error('not implemented');\n  }\n}\n\n// Vector Tile Data Source\n\nexport type VectorTileDataSourceCapabilities = {\n  // check tile.json\n}\n\nexport type VectorTile = Record<string, any>;\n\nexport abstract class VectorTileDataSource extends TileDataSource {\n  abstract getCapabilities(): Promise<VectorTileDataSourceCapabilities>;\n  abstract getTile({x, y, z, width, height, layers, parameters}): Promise<VectorTile>;\n}\n\n// Image Tile Data Source\n\nexport type ImageTileDataSourceCapabilities = {\n}\n\nexport type ImageTile = Record<string, any>;\n\nexport type FeatureInfo = {};\n\nexport abstract class ImageTileDataSource extends TileDataSource {\n  source: ImageDataSource;\n  \n  constructor(source: ImageDataSource) {\n    super();\n    this.source = source;\n  }\n\n  getCapabilities(): Promise<ImageTileDataSourceCapabilities> {\n    return this.source.getCapabilities();\n  }\n\n  getTile({x, y, z, width, height, layers, parameters}): Promise<ImageType> {\n    const boundingBox = this.getBoundingBoxFromTileIndex(x, y, z);\n    return this.source.getImage({boundingBox, width, height, layers, parameters});\n  }\n\n  getFeatureInfo(): FeatureInfo | null {\n    return null;\n  }\n\n  getBoundingBoxFromTileIndex(x: number, y: number, z: number): [number, number, number, number] {\n    return [0, 0, 1, 1];\n  }\n}\n*/\n"],"mappings":""}

package/dist/es5/lib/data-sources/wms-data-source.js

@@ -1,223 +0,0 @@
-"use strict";
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.WMSDataSource = void 0;
-var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
-var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
-var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
-var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
-var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
-var _wms = require("@loaders.gl/wms");
-var _images = require("@loaders.gl/images");
-function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
-function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
-var WMSDataSource = function () {
-
-  function WMSDataSource(props) {
-    (0, _classCallCheck2.default)(this, WMSDataSource);
-    (0, _defineProperty2.default)(this, "url", void 0);
-    (0, _defineProperty2.default)(this, "loadOptions", void 0);
-    (0, _defineProperty2.default)(this, "fetch", void 0);
-    this.url = props.url;
-    this.loadOptions = props.loadOptions || {};
-    this.fetch = props.fetch || fetch;
-  }
-  (0, _createClass2.default)(WMSDataSource, [{
-    key: "getCapabilities",
-    value: function () {
-      var _getCapabilities = (0, _asyncToGenerator2.default)(_regenerator.default.mark(function _callee(options) {
-        var url, response, arrayBuffer;
-        return _regenerator.default.wrap(function _callee$(_context) {
-          while (1) {
-            switch (_context.prev = _context.next) {
-              case 0:
-                url = this.getUrl(_objectSpread({
-                  request: 'GetCapabilities'
-                }, options));
-                _context.next = 3;
-                return this.fetch(url, this.loadOptions);
-              case 3:
-                response = _context.sent;
-                _context.next = 6;
-                return response.arrayBuffer();
-              case 6:
-                arrayBuffer = _context.sent;
-                _context.next = 9;
-                return _wms.WMSCapabilitiesLoader.parse(arrayBuffer, this.loadOptions);
-              case 9:
-                return _context.abrupt("return", _context.sent);
-              case 10:
-              case "end":
-                return _context.stop();
-            }
-          }
-        }, _callee, this);
-      }));
-      function getCapabilities(_x) {
-        return _getCapabilities.apply(this, arguments);
-      }
-      return getCapabilities;
-    }()
-  }, {
-    key: "getImage",
-    value: function () {
-      var _getImage = (0, _asyncToGenerator2.default)(_regenerator.default.mark(function _callee2(options) {
-        var url, response, arrayBuffer;
-        return _regenerator.default.wrap(function _callee2$(_context2) {
-          while (1) {
-            switch (_context2.prev = _context2.next) {
-              case 0:
-                url = this.getUrl(_objectSpread({
-                  request: 'GetMap'
-                }, options));
-                _context2.next = 3;
-                return this.fetch(url, this.loadOptions);
-              case 3:
-                response = _context2.sent;
-                _context2.next = 6;
-                return response.arrayBuffer();
-              case 6:
-                arrayBuffer = _context2.sent;
-                _context2.next = 9;
-                return _images.ImageLoader.parse(arrayBuffer, this.loadOptions);
-              case 9:
-                return _context2.abrupt("return", _context2.sent);
-              case 10:
-              case "end":
-                return _context2.stop();
-            }
-          }
-        }, _callee2, this);
-      }));
-      function getImage(_x2) {
-        return _getImage.apply(this, arguments);
-      }
-      return getImage;
-    }()
-  }, {
-    key: "getFeatureInfo",
-    value: function () {
-      var _getFeatureInfo = (0, _asyncToGenerator2.default)(_regenerator.default.mark(function _callee3(options) {
-        var url, response, arrayBuffer;
-        return _regenerator.default.wrap(function _callee3$(_context3) {
-          while (1) {
-            switch (_context3.prev = _context3.next) {
-              case 0:
-                url = this.getUrl(_objectSpread({
-                  request: 'GetFeatureInfo'
-                }, options));
-                _context3.next = 3;
-                return this.fetch(url, this.loadOptions);
-              case 3:
-                response = _context3.sent;
-                _context3.next = 6;
-                return response.arrayBuffer();
-              case 6:
-                arrayBuffer = _context3.sent;
-                _context3.next = 9;
-                return _wms.WMSFeatureInfoLoader.parse(arrayBuffer, this.loadOptions);
-              case 9:
-                return _context3.abrupt("return", _context3.sent);
-              case 10:
-              case "end":
-                return _context3.stop();
-            }
-          }
-        }, _callee3, this);
-      }));
-      function getFeatureInfo(_x3) {
-        return _getFeatureInfo.apply(this, arguments);
-      }
-      return getFeatureInfo;
-    }()
-  }, {
-    key: "getLayerInfo",
-    value: function () {
-      var _getLayerInfo = (0, _asyncToGenerator2.default)(_regenerator.default.mark(function _callee4(options) {
-        var url, response, arrayBuffer;
-        return _regenerator.default.wrap(function _callee4$(_context4) {
-          while (1) {
-            switch (_context4.prev = _context4.next) {
-              case 0:
-                url = this.getUrl(_objectSpread({
-                  request: 'GetLayerInfo'
-                }, options));
-                _context4.next = 3;
-                return this.fetch(url, this.loadOptions);
-              case 3:
-                response = _context4.sent;
-                _context4.next = 6;
-                return response.arrayBuffer();
-              case 6:
-                arrayBuffer = _context4.sent;
-                _context4.next = 9;
-                return _wms.WMSLayerDescriptionLoader.parse(arrayBuffer, this.loadOptions);
-              case 9:
-                return _context4.abrupt("return", _context4.sent);
-              case 10:
-              case "end":
-                return _context4.stop();
-            }
-          }
-        }, _callee4, this);
-      }));
-      function getLayerInfo(_x4) {
-        return _getLayerInfo.apply(this, arguments);
-      }
-      return getLayerInfo;
-    }()
-  }, {
-    key: "getLegendImage",
-    value: function () {
-      var _getLegendImage = (0, _asyncToGenerator2.default)(_regenerator.default.mark(function _callee5(options) {
-        var url, response, arrayBuffer;
-        return _regenerator.default.wrap(function _callee5$(_context5) {
-          while (1) {
-            switch (_context5.prev = _context5.next) {
-              case 0:
-                url = this.getUrl(_objectSpread({
-                  request: 'GetLegendImage'
-                }, options));
-                _context5.next = 3;
-                return this.fetch(url, this.loadOptions);
-              case 3:
-                response = _context5.sent;
-                _context5.next = 6;
-                return response.arrayBuffer();
-              case 6:
-                arrayBuffer = _context5.sent;
-                _context5.next = 9;
-                return _images.ImageLoader.parse(arrayBuffer, this.loadOptions);
-              case 9:
-                return _context5.abrupt("return", _context5.sent);
-              case 10:
-              case "end":
-                return _context5.stop();
-            }
-          }
-        }, _callee5, this);
-      }));
-      function getLegendImage(_x5) {
-        return _getLegendImage.apply(this, arguments);
-      }
-      return getLegendImage;
-    }()
-  }, {
-    key: "getUrl",
-    value:
-    function getUrl(options) {
-      var _options$layers;
-      var url = "".concat(this.url, "?REQUEST=").concat(options.request);
-      if ((_options$layers = options.layers) !== null && _options$layers !== void 0 && _options$layers.length) {
-        url += "&LAYERS=[".concat(options.layers.join(','), "]");
-      }
-      return url;
-    }
-  }]);
-  return WMSDataSource;
-}();
-exports.WMSDataSource = WMSDataSource;
-//# sourceMappingURL=wms-data-source.js.map

package/dist/es5/lib/data-sources/wms-data-source.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"wms-data-source.js","names":["WMSDataSource","props","url","loadOptions","fetch","options","getUrl","request","response","arrayBuffer","WMSCapabilitiesLoader","parse","ImageLoader","WMSFeatureInfoLoader","WMSLayerDescriptionLoader","layers","length","join"],"sources":["../../../../src/lib/data-sources/wms-data-source.ts"],"sourcesContent":["// loaders.gl, MIT license\n\nimport type {WMSCapabilities, WMSFeatureInfo, WMSLayerDescription} from '@loaders.gl/wms';\nimport {\n  WMSCapabilitiesLoader,\n  WMSFeatureInfoLoader,\n  WMSLayerDescriptionLoader\n} from '@loaders.gl/wms';\nimport {ImageLoader, ImageType} from '@loaders.gl/images';\nimport {LoaderOptions} from '@loaders.gl/loader-utils';\n\n// import {ImageDataSource} from './image-data-sources';\n\ntype FetchLike = (url: string, options?: RequestInit) => Promise<Response>;\n\nexport type WMSDataSourceProps = {\n  url: string;\n  loadOptions?: LoaderOptions;\n  fetch?: typeof fetch | FetchLike;\n};\n\nexport class WMSDataSource {\n  // implements ImageDataSource {\n  url: string;\n  loadOptions: LoaderOptions;\n  fetch: typeof fetch | FetchLike;\n\n  constructor(props: WMSDataSourceProps) {\n    this.url = props.url;\n    this.loadOptions = props.loadOptions || {};\n    this.fetch = props.fetch || fetch;\n  }\n\n  async getCapabilities(options: {parameters?: Record<string, unknown>}): Promise<WMSCapabilities> {\n    const url = this.getUrl({request: 'GetCapabilities', ...options});\n    const response = await this.fetch(url, this.loadOptions);\n    const arrayBuffer = await response.arrayBuffer();\n    return await WMSCapabilitiesLoader.parse(arrayBuffer, this.loadOptions);\n  }\n\n  async getImage(options: {\n    boundingBox;\n    width;\n    height;\n    layers: string[];\n    parameters?: Record<string, unknown>;\n  }): Promise<ImageType> {\n    const url = this.getUrl({request: 'GetMap', ...options});\n    const response = await this.fetch(url, this.loadOptions);\n    const arrayBuffer = await response.arrayBuffer();\n    return await ImageLoader.parse(arrayBuffer, this.loadOptions);\n  }\n\n  async getFeatureInfo(options: {\n    layers: string[];\n    parameters?: Record<string, unknown>;\n  }): Promise<WMSFeatureInfo> {\n    const url = this.getUrl({request: 'GetFeatureInfo', ...options});\n    const response = await this.fetch(url, this.loadOptions);\n    const arrayBuffer = await response.arrayBuffer();\n    return await WMSFeatureInfoLoader.parse(arrayBuffer, this.loadOptions);\n  }\n\n  async getLayerInfo(options: {\n    layers: string[];\n    parameters?: Record<string, unknown>;\n  }): Promise<WMSLayerDescription> {\n    const url = this.getUrl({request: 'GetLayerInfo', ...options});\n    const response = await this.fetch(url, this.loadOptions);\n    const arrayBuffer = await response.arrayBuffer();\n    return await WMSLayerDescriptionLoader.parse(arrayBuffer, this.loadOptions);\n  }\n\n  async getLegendImage(options: {\n    layers: string[];\n    parameters?: Record<string, unknown>;\n  }): Promise<ImageType> {\n    const url = this.getUrl({request: 'GetLegendImage', ...options});\n    const response = await this.fetch(url, this.loadOptions);\n    const arrayBuffer = await response.arrayBuffer();\n    return await ImageLoader.parse(arrayBuffer, this.loadOptions);\n  }\n\n  /**\n   * @note protected, since perhaps getUrl may need to be overridden to handle certain backends?\n   * @note if override is common, maybe add a callback prop?\n   * */\n  protected getUrl(options: {\n    request: string;\n    layers?: string[];\n    parameters?: Record<string, unknown>;\n  }): string {\n    let url = `${this.url}?REQUEST=${options.request}`;\n    if (options.layers?.length) {\n      url += `&LAYERS=[${options.layers.join(',')}]`;\n    }\n    return url;\n  }\n}\n"],"mappings":"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"}

package/dist/es5/lib/parse-wms.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"parse-wms.js","names":["parseWMSCapabilities","text","options","parsedXML","XMLLoader","parseTextSync","xmlCapabilities","WMT_MS_Capabilities","WMS_Capabilities","extractCapabilities","xml","capabilities","name","Service","Name","title","Title","keywords","requests","layer","extractLayer","Capability","Layer","raw","KeywordList","Keyword","keyword","push","Object","entries","Request","xmlRequest","extractRequest","format","Format","mimeTypes","Array","isArray","xmlLayer","srs","SRS","layers","xmlSubLayer","parseWMSFeatureInfo","xmlFeatureInfo","FeatureInfoResponse","FIELDS","xmlFeatures","features","map","xmlFeature","extractFeature","xmlFields","attributes"],"sources":["../../../src/lib/parse-wms.ts"],"sourcesContent":["// loaders.gl, MIT license\n\nimport type {\n  WMSCapabilities,\n  WMSLayer,\n  WMSRequest,\n  WMSFeatureInfo\n  // WMSFeature,\n  // WMSLayerDescription\n} from '../wms-types';\n\nimport {XMLLoader} from '@loaders.gl/xml';\n\n// GetCapabilities\n\n/**\n * Parses a typed data structure from raw XML for `GetCapabilities` response\n * @note Error handlings is fairly weak\n */\nexport function parseWMSCapabilities(text: string, options): WMSCapabilities {\n  const parsedXML = XMLLoader.parseTextSync(text, options);\n  const xmlCapabilities: any =\n    parsedXML.WMT_MS_Capabilities || parsedXML.WMS_Capabilities || parsedXML;\n  return extractCapabilities(xmlCapabilities);\n}\n\n/** Extract typed capability data from XML */\nfunction extractCapabilities(xml: any): WMSCapabilities {\n  const capabilities: WMSCapabilities = {\n    name: xml.Service?.Name || 'unnamed',\n    title: xml.Service?.Title,\n    keywords: [],\n    requests: {},\n    layer: extractLayer(xml.Capability?.Layer),\n    raw: xml\n  };\n\n  for (const keyword of xml.Service?.KeywordList?.Keyword || []) {\n    capabilities.keywords.push(keyword);\n  }\n\n  for (const [name, xmlRequest] of Object.entries(xml.Capability?.Request || {})) {\n    capabilities.requests[name] = extractRequest(name, xmlRequest);\n  }\n\n  return capabilities;\n}\n\n/** Extract typed request data from XML */\nfunction extractRequest(name: string, xmlRequest: any): WMSRequest {\n  const format: string | string[] = xmlRequest?.Format;\n  const mimeTypes: string[] = Array.isArray(format) ? format : [format];\n  return {name, mimeTypes};\n}\n\n/** Extract request data */\nfunction extractLayer(xmlLayer: any): WMSLayer {\n  const layer: WMSLayer = {\n    name: xmlLayer?.Name,\n    title: xmlLayer?.Title,\n    srs: xmlLayer?.SRS || [],\n    layers: []\n  };\n\n  for (const xmlSubLayer of xmlLayer?.Layer || []) {\n    layer.layers?.push(extractLayer(xmlSubLayer));\n  }\n\n  return layer;\n}\n\n// GetFeatureInfo\n\n/**\n * Parses a typed data structure from raw XML for `GetFeatureInfo` response\n * @note Error handlings is fairly weak\n */\nexport function parseWMSFeatureInfo(text: string, options): WMSFeatureInfo {\n  const parsedXML = XMLLoader.parseTextSync(text, options);\n  const xmlFeatureInfo: any = parsedXML.FeatureInfoResponse?.FIELDS || [];\n\n  const xmlFeatures = Array.isArray(xmlFeatureInfo) ? xmlFeatureInfo : [xmlFeatureInfo];\n\n  return {\n    features: xmlFeatures.map((xmlFeature) => extractFeature(xmlFeature))\n  };\n}\n\nfunction extractFeature(xmlFeature: any) {\n  const xmlFields = xmlFeature || {};\n  return {attributes: xmlFields};\n}\n"],"mappings":"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"}

package/dist/es5/wms-feature-info-loader.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"wms-feature-info-loader.js","names":["WMSFeatureInfoLoader","WMSCapabilitiesLoader","name","id","parse","arrayBuffer","options","parseWMSFeatureInfo","TextDecoder","decode","parseTextSync","text","_typecheckWMSFeatureInfoLoader"],"sources":["../../src/wms-feature-info-loader.ts"],"sourcesContent":["// loaders.gl, MIT license\n\nimport type {LoaderWithParser} from '@loaders.gl/loader-utils';\nimport {WMSCapabilitiesLoader, WMSLoaderOptions} from './wms-capabilities-loader';\nimport {parseWMSFeatureInfo} from './lib/parse-wms';\n\n/**\n * Loader for the response to the WMS GetFeatureInfo request\n */\nexport const WMSFeatureInfoLoader = {\n  ...WMSCapabilitiesLoader,\n\n  name: 'WMS FeatureInfo',\n  id: 'wms-feature-info',\n\n  parse: async (arrayBuffer: ArrayBuffer, options?: WMSLoaderOptions) =>\n    parseWMSFeatureInfo(new TextDecoder().decode(arrayBuffer), options),\n  parseTextSync: (text: string, options?: WMSLoaderOptions) => parseWMSFeatureInfo(text, options)\n};\n\nexport const _typecheckWMSFeatureInfoLoader: LoaderWithParser = WMSFeatureInfoLoader;\n"],"mappings":";;;;;;;;;;AAGA;AACA;AAAoD;AAAA;AAK7C,IAAMA,oBAAoB,mCAC5BC,4CAAqB;EAExBC,IAAI,EAAE,iBAAiB;EACvBC,EAAE,EAAE,kBAAkB;EAEtBC,KAAK;IAAA,uEAAE,iBAAOC,WAAwB,EAAEC,OAA0B;MAAA;QAAA;UAAA;YAAA;cAAA,iCAChE,IAAAC,6BAAmB,EAAC,IAAIC,WAAW,EAAE,CAACC,MAAM,CAACJ,WAAW,CAAC,EAAEC,OAAO,CAAC;YAAA;YAAA;cAAA;UAAA;QAAA;MAAA;IAAA;IAAA;MAAA;IAAA;IAAA;EAAA;EACrEI,aAAa,EAAE,uBAACC,IAAY,EAAEL,OAA0B;IAAA,OAAK,IAAAC,6BAAmB,EAACI,IAAI,EAAEL,OAAO,CAAC;EAAA;AAAA,EAChG;AAAC;AAEK,IAAMM,8BAAgD,GAAGZ,oBAAoB;AAAC"}

package/dist/es5/wms-layer-description-loader.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"wms-layer-description-loader.js","names":["WMSLayerDescriptionLoader","WMSCapabilitiesLoader","name","id","parse","arrayBuffer","options","parseWMSFeatureInfo","TextDecoder","decode","parseTextSync","text","_typecheckWMSFeatureInfoLoader"],"sources":["../../src/wms-layer-description-loader.ts"],"sourcesContent":["// loaders.gl, MIT license\n\nimport type {LoaderWithParser} from '@loaders.gl/loader-utils';\nimport {WMSCapabilitiesLoader, WMSLoaderOptions} from './wms-capabilities-loader';\nimport {parseWMSFeatureInfo} from './lib/parse-wms';\n\n/**\n * Loader for the response to the WMS GetFeatureInfo request\n */\nexport const WMSLayerDescriptionLoader = {\n  ...WMSCapabilitiesLoader,\n\n  name: 'WMS DescribeLayer',\n  id: 'wms-layer-description',\n\n  parse: async (arrayBuffer: ArrayBuffer, options?: WMSLoaderOptions) =>\n    parseWMSFeatureInfo(new TextDecoder().decode(arrayBuffer), options),\n  parseTextSync: (text: string, options?: WMSLoaderOptions) => parseWMSFeatureInfo(text, options)\n};\n\nexport const _typecheckWMSFeatureInfoLoader: LoaderWithParser = WMSLayerDescriptionLoader;\n"],"mappings":";;;;;;;;;;AAGA;AACA;AAAoD;AAAA;AAK7C,IAAMA,yBAAyB,mCACjCC,4CAAqB;EAExBC,IAAI,EAAE,mBAAmB;EACzBC,EAAE,EAAE,uBAAuB;EAE3BC,KAAK;IAAA,uEAAE,iBAAOC,WAAwB,EAAEC,OAA0B;MAAA;QAAA;UAAA;YAAA;cAAA,iCAChE,IAAAC,6BAAmB,EAAC,IAAIC,WAAW,EAAE,CAACC,MAAM,CAACJ,WAAW,CAAC,EAAEC,OAAO,CAAC;YAAA;YAAA;cAAA;UAAA;QAAA;MAAA;IAAA;IAAA;MAAA;IAAA;IAAA;EAAA;EACrEI,aAAa,EAAE,uBAACC,IAAY,EAAEL,OAA0B;IAAA,OAAK,IAAAC,6BAAmB,EAACI,IAAI,EAAEL,OAAO,CAAC;EAAA;AAAA,EAChG;AAAC;AAEK,IAAMM,8BAAgD,GAAGZ,yBAAyB;AAAC"}