@loaders.gl/ogc 0.0.0-stage → 5.0.0-alpha.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (383) hide show
  1. package/LICENSE +52 -0
  2. package/README.md +10 -2
  3. package/dist/index.cjs +7052 -0
  4. package/dist/index.cjs.map +6 -0
  5. package/dist/index.d.ts +3 -0
  6. package/dist/index.d.ts.map +1 -0
  7. package/dist/index.js +6 -0
  8. package/dist/index.js.map +1 -0
  9. package/dist/stac/index.cjs +1095 -0
  10. package/dist/stac/index.cjs.map +6 -0
  11. package/dist/stac/index.d.ts +4 -0
  12. package/dist/stac/index.d.ts.map +1 -0
  13. package/dist/stac/index.js +5 -0
  14. package/dist/stac/index.js.map +1 -0
  15. package/dist/stac/stac-source-loader-types.d.ts +44 -0
  16. package/dist/stac/stac-source-loader-types.d.ts.map +1 -0
  17. package/dist/stac/stac-source-loader-types.js +43 -0
  18. package/dist/stac/stac-source-loader-types.js.map +1 -0
  19. package/dist/stac/stac-source.cjs +1544 -0
  20. package/dist/stac/stac-source.cjs.map +6 -0
  21. package/dist/stac/stac-source.d.ts +92 -0
  22. package/dist/stac/stac-source.d.ts.map +1 -0
  23. package/dist/stac/stac-source.js +500 -0
  24. package/dist/stac/stac-source.js.map +1 -0
  25. package/dist/stac/stac-types.d.ts +213 -0
  26. package/dist/stac/stac-types.d.ts.map +1 -0
  27. package/dist/stac/stac-types.js +5 -0
  28. package/dist/stac/stac-types.js.map +1 -0
  29. package/dist/wms/bundled.cjs +7295 -0
  30. package/dist/wms/bundled.cjs.map +6 -0
  31. package/dist/wms/bundled.d.ts +24 -0
  32. package/dist/wms/bundled.d.ts.map +1 -0
  33. package/dist/wms/bundled.js +18 -0
  34. package/dist/wms/bundled.js.map +1 -0
  35. package/dist/wms/capability-graph.d.ts +42 -0
  36. package/dist/wms/capability-graph.d.ts.map +1 -0
  37. package/dist/wms/capability-graph.js +118 -0
  38. package/dist/wms/capability-graph.js.map +1 -0
  39. package/dist/wms/crs-utils.d.ts +24 -0
  40. package/dist/wms/crs-utils.d.ts.map +1 -0
  41. package/dist/wms/crs-utils.js +57 -0
  42. package/dist/wms/crs-utils.js.map +1 -0
  43. package/dist/wms/csw-capabilities-loader-with-parser.d.ts +34 -0
  44. package/dist/wms/csw-capabilities-loader-with-parser.d.ts.map +1 -0
  45. package/dist/wms/csw-capabilities-loader-with-parser.js +15 -0
  46. package/dist/wms/csw-capabilities-loader-with-parser.js.map +1 -0
  47. package/dist/wms/csw-capabilities-loader.d.ts +56 -0
  48. package/dist/wms/csw-capabilities-loader.d.ts.map +1 -0
  49. package/dist/wms/csw-capabilities-loader.js +38 -0
  50. package/dist/wms/csw-capabilities-loader.js.map +1 -0
  51. package/dist/wms/csw-domain-loader-with-parser.d.ts +33 -0
  52. package/dist/wms/csw-domain-loader-with-parser.d.ts.map +1 -0
  53. package/dist/wms/csw-domain-loader-with-parser.js +15 -0
  54. package/dist/wms/csw-domain-loader-with-parser.js.map +1 -0
  55. package/dist/wms/csw-domain-loader.d.ts +55 -0
  56. package/dist/wms/csw-domain-loader.d.ts.map +1 -0
  57. package/dist/wms/csw-domain-loader.js +38 -0
  58. package/dist/wms/csw-domain-loader.js.map +1 -0
  59. package/dist/wms/csw-records-loader-with-parser.d.ts +33 -0
  60. package/dist/wms/csw-records-loader-with-parser.d.ts.map +1 -0
  61. package/dist/wms/csw-records-loader-with-parser.js +15 -0
  62. package/dist/wms/csw-records-loader-with-parser.js.map +1 -0
  63. package/dist/wms/csw-records-loader.d.ts +55 -0
  64. package/dist/wms/csw-records-loader.d.ts.map +1 -0
  65. package/dist/wms/csw-records-loader.js +38 -0
  66. package/dist/wms/csw-records-loader.js.map +1 -0
  67. package/dist/wms/csw-source-loader.d.ts +165 -0
  68. package/dist/wms/csw-source-loader.d.ts.map +1 -0
  69. package/dist/wms/csw-source-loader.js +203 -0
  70. package/dist/wms/csw-source-loader.js.map +1 -0
  71. package/dist/wms/feature-pagination.d.ts +34 -0
  72. package/dist/wms/feature-pagination.d.ts.map +1 -0
  73. package/dist/wms/feature-pagination.js +159 -0
  74. package/dist/wms/feature-pagination.js.map +1 -0
  75. package/dist/wms/gml-loader-types.d.ts +68 -0
  76. package/dist/wms/gml-loader-types.d.ts.map +1 -0
  77. package/dist/wms/gml-loader-types.js +38 -0
  78. package/dist/wms/gml-loader-types.js.map +1 -0
  79. package/dist/wms/gml-loader.cjs +5779 -0
  80. package/dist/wms/gml-loader.cjs.map +6 -0
  81. package/dist/wms/gml-loader.d.ts +38 -0
  82. package/dist/wms/gml-loader.d.ts.map +1 -0
  83. package/dist/wms/gml-loader.js +195 -0
  84. package/dist/wms/gml-loader.js.map +1 -0
  85. package/dist/wms/index.cjs +12416 -0
  86. package/dist/wms/index.cjs.map +6 -0
  87. package/dist/wms/index.d.ts +61 -0
  88. package/dist/wms/index.d.ts.map +1 -0
  89. package/dist/wms/index.js +36 -0
  90. package/dist/wms/index.js.map +1 -0
  91. package/dist/wms/lib/deprecated/create-image-source.d.ts +27 -0
  92. package/dist/wms/lib/deprecated/create-image-source.d.ts.map +1 -0
  93. package/dist/wms/lib/deprecated/create-image-source.js +44 -0
  94. package/dist/wms/lib/deprecated/create-image-source.js.map +1 -0
  95. package/dist/wms/lib/deprecated/image-source-compatibility.d.ts +14 -0
  96. package/dist/wms/lib/deprecated/image-source-compatibility.d.ts.map +1 -0
  97. package/dist/wms/lib/deprecated/image-source-compatibility.js +21 -0
  98. package/dist/wms/lib/deprecated/image-source-compatibility.js.map +1 -0
  99. package/dist/wms/lib/parsers/csw/parse-csw-capabilities.d.ts +79 -0
  100. package/dist/wms/lib/parsers/csw/parse-csw-capabilities.d.ts.map +1 -0
  101. package/dist/wms/lib/parsers/csw/parse-csw-capabilities.js +23 -0
  102. package/dist/wms/lib/parsers/csw/parse-csw-capabilities.js.map +1 -0
  103. package/dist/wms/lib/parsers/csw/parse-csw-domain.d.ts +17 -0
  104. package/dist/wms/lib/parsers/csw/parse-csw-domain.d.ts.map +1 -0
  105. package/dist/wms/lib/parsers/csw/parse-csw-domain.js +32 -0
  106. package/dist/wms/lib/parsers/csw/parse-csw-domain.js.map +1 -0
  107. package/dist/wms/lib/parsers/csw/parse-csw-records.d.ts +34 -0
  108. package/dist/wms/lib/parsers/csw/parse-csw-records.d.ts.map +1 -0
  109. package/dist/wms/lib/parsers/csw/parse-csw-records.js +56 -0
  110. package/dist/wms/lib/parsers/csw/parse-csw-records.js.map +1 -0
  111. package/dist/wms/lib/parsers/csw/parse-exception-report.d.ts +6 -0
  112. package/dist/wms/lib/parsers/csw/parse-exception-report.d.ts.map +1 -0
  113. package/dist/wms/lib/parsers/csw/parse-exception-report.js +29 -0
  114. package/dist/wms/lib/parsers/csw/parse-exception-report.js.map +1 -0
  115. package/dist/wms/lib/parsers/gml/deep-strict-equal.d.ts +3 -0
  116. package/dist/wms/lib/parsers/gml/deep-strict-equal.d.ts.map +1 -0
  117. package/dist/wms/lib/parsers/gml/deep-strict-equal.js +118 -0
  118. package/dist/wms/lib/parsers/gml/deep-strict-equal.js.map +1 -0
  119. package/dist/wms/lib/parsers/gml/parse-gml.d.ts +66 -0
  120. package/dist/wms/lib/parsers/gml/parse-gml.d.ts.map +1 -0
  121. package/dist/wms/lib/parsers/gml/parse-gml.js +641 -0
  122. package/dist/wms/lib/parsers/gml/parse-gml.js.map +1 -0
  123. package/dist/wms/lib/parsers/gml/rewind-geometry.d.ts +4 -0
  124. package/dist/wms/lib/parsers/gml/rewind-geometry.d.ts.map +1 -0
  125. package/dist/wms/lib/parsers/gml/rewind-geometry.js +45 -0
  126. package/dist/wms/lib/parsers/gml/rewind-geometry.js.map +1 -0
  127. package/dist/wms/lib/parsers/ogc-api/tile-matrix-limits.d.ts +19 -0
  128. package/dist/wms/lib/parsers/ogc-api/tile-matrix-limits.d.ts.map +1 -0
  129. package/dist/wms/lib/parsers/ogc-api/tile-matrix-limits.js +74 -0
  130. package/dist/wms/lib/parsers/ogc-api/tile-matrix-limits.js.map +1 -0
  131. package/dist/wms/lib/parsers/ogc-api/tile-matrix-set.d.ts +63 -0
  132. package/dist/wms/lib/parsers/ogc-api/tile-matrix-set.d.ts.map +1 -0
  133. package/dist/wms/lib/parsers/ogc-api/tile-matrix-set.js +82 -0
  134. package/dist/wms/lib/parsers/ogc-api/tile-matrix-set.js.map +1 -0
  135. package/dist/wms/lib/parsers/wfs/parse-wfs-capabilities.d.ts +97 -0
  136. package/dist/wms/lib/parsers/wfs/parse-wfs-capabilities.d.ts.map +1 -0
  137. package/dist/wms/lib/parsers/wfs/parse-wfs-capabilities.js +60 -0
  138. package/dist/wms/lib/parsers/wfs/parse-wfs-capabilities.js.map +1 -0
  139. package/dist/wms/lib/parsers/wfs/parse-wfs.d.ts +7 -0
  140. package/dist/wms/lib/parsers/wfs/parse-wfs.d.ts.map +1 -0
  141. package/dist/wms/lib/parsers/wfs/parse-wfs.js +31 -0
  142. package/dist/wms/lib/parsers/wfs/parse-wfs.js.map +1 -0
  143. package/dist/wms/lib/parsers/wms/parse-wms-capabilities.d.ts +126 -0
  144. package/dist/wms/lib/parsers/wms/parse-wms-capabilities.d.ts.map +1 -0
  145. package/dist/wms/lib/parsers/wms/parse-wms-capabilities.js +232 -0
  146. package/dist/wms/lib/parsers/wms/parse-wms-capabilities.js.map +1 -0
  147. package/dist/wms/lib/parsers/wms/parse-wms-error.d.ts +8 -0
  148. package/dist/wms/lib/parsers/wms/parse-wms-error.d.ts.map +1 -0
  149. package/dist/wms/lib/parsers/wms/parse-wms-error.js +21 -0
  150. package/dist/wms/lib/parsers/wms/parse-wms-error.js.map +1 -0
  151. package/dist/wms/lib/parsers/wms/parse-wms-features.d.ts +20 -0
  152. package/dist/wms/lib/parsers/wms/parse-wms-features.d.ts.map +1 -0
  153. package/dist/wms/lib/parsers/wms/parse-wms-features.js +26 -0
  154. package/dist/wms/lib/parsers/wms/parse-wms-features.js.map +1 -0
  155. package/dist/wms/lib/parsers/wms/parse-wms-layer-description.d.ts +11 -0
  156. package/dist/wms/lib/parsers/wms/parse-wms-layer-description.d.ts.map +1 -0
  157. package/dist/wms/lib/parsers/wms/parse-wms-layer-description.js +14 -0
  158. package/dist/wms/lib/parsers/wms/parse-wms-layer-description.js.map +1 -0
  159. package/dist/wms/lib/parsers/wmts/parse-wmts-capabilities.d.ts +101 -0
  160. package/dist/wms/lib/parsers/wmts/parse-wmts-capabilities.d.ts.map +1 -0
  161. package/dist/wms/lib/parsers/wmts/parse-wmts-capabilities.js +175 -0
  162. package/dist/wms/lib/parsers/wmts/parse-wmts-capabilities.js.map +1 -0
  163. package/dist/wms/lib/parsers/xml/parse-xml-helpers.d.ts +11 -0
  164. package/dist/wms/lib/parsers/xml/parse-xml-helpers.d.ts.map +1 -0
  165. package/dist/wms/lib/parsers/xml/parse-xml-helpers.js +63 -0
  166. package/dist/wms/lib/parsers/xml/parse-xml-helpers.js.map +1 -0
  167. package/dist/wms/lib/parsers/xml/parse-xml-text.d.ts +4 -0
  168. package/dist/wms/lib/parsers/xml/parse-xml-text.d.ts.map +1 -0
  169. package/dist/wms/lib/parsers/xml/parse-xml-text.js +9 -0
  170. package/dist/wms/lib/parsers/xml/parse-xml-text.js.map +1 -0
  171. package/dist/wms/lib/tile-grid.d.ts +14 -0
  172. package/dist/wms/lib/tile-grid.d.ts.map +1 -0
  173. package/dist/wms/lib/tile-grid.js +28 -0
  174. package/dist/wms/lib/tile-grid.js.map +1 -0
  175. package/dist/wms/managed-vector-source.d.ts +66 -0
  176. package/dist/wms/managed-vector-source.d.ts.map +1 -0
  177. package/dist/wms/managed-vector-source.js +307 -0
  178. package/dist/wms/managed-vector-source.js.map +1 -0
  179. package/dist/wms/ogc-api-coverages-source-loader.d.ts +64 -0
  180. package/dist/wms/ogc-api-coverages-source-loader.d.ts.map +1 -0
  181. package/dist/wms/ogc-api-coverages-source-loader.js +78 -0
  182. package/dist/wms/ogc-api-coverages-source-loader.js.map +1 -0
  183. package/dist/wms/ogc-api-edr-source-loader.d.ts +72 -0
  184. package/dist/wms/ogc-api-edr-source-loader.d.ts.map +1 -0
  185. package/dist/wms/ogc-api-edr-source-loader.js +82 -0
  186. package/dist/wms/ogc-api-edr-source-loader.js.map +1 -0
  187. package/dist/wms/ogc-api-source-loader.d.ts +223 -0
  188. package/dist/wms/ogc-api-source-loader.d.ts.map +1 -0
  189. package/dist/wms/ogc-api-source-loader.js +517 -0
  190. package/dist/wms/ogc-api-source-loader.js.map +1 -0
  191. package/dist/wms/service-capabilities.d.ts +17 -0
  192. package/dist/wms/service-capabilities.d.ts.map +1 -0
  193. package/dist/wms/service-capabilities.js +110 -0
  194. package/dist/wms/service-capabilities.js.map +1 -0
  195. package/dist/wms/service-runtime.d.ts +67 -0
  196. package/dist/wms/service-runtime.d.ts.map +1 -0
  197. package/dist/wms/service-runtime.js +165 -0
  198. package/dist/wms/service-runtime.js.map +1 -0
  199. package/dist/wms/unbundled.cjs +5995 -0
  200. package/dist/wms/unbundled.cjs.map +6 -0
  201. package/dist/wms/unbundled.d.ts +18 -0
  202. package/dist/wms/unbundled.d.ts.map +1 -0
  203. package/dist/wms/unbundled.js +12 -0
  204. package/dist/wms/unbundled.js.map +1 -0
  205. package/dist/wms/wcs-source-loader.d.ts +99 -0
  206. package/dist/wms/wcs-source-loader.d.ts.map +1 -0
  207. package/dist/wms/wcs-source-loader.js +178 -0
  208. package/dist/wms/wcs-source-loader.js.map +1 -0
  209. package/dist/wms/wfs-capabilities-loader-with-parser.d.ts +35 -0
  210. package/dist/wms/wfs-capabilities-loader-with-parser.d.ts.map +1 -0
  211. package/dist/wms/wfs-capabilities-loader-with-parser.js +17 -0
  212. package/dist/wms/wfs-capabilities-loader-with-parser.js.map +1 -0
  213. package/dist/wms/wfs-capabilities-loader.d.ts +59 -0
  214. package/dist/wms/wfs-capabilities-loader.d.ts.map +1 -0
  215. package/dist/wms/wfs-capabilities-loader.js +42 -0
  216. package/dist/wms/wfs-capabilities-loader.js.map +1 -0
  217. package/dist/wms/wfs-source-loader.d.ts +353 -0
  218. package/dist/wms/wfs-source-loader.d.ts.map +1 -0
  219. package/dist/wms/wfs-source-loader.js +606 -0
  220. package/dist/wms/wfs-source-loader.js.map +1 -0
  221. package/dist/wms/wip/data-source.d.ts +54 -0
  222. package/dist/wms/wip/data-source.d.ts.map +1 -0
  223. package/dist/wms/wip/data-source.js +62 -0
  224. package/dist/wms/wip/data-source.js.map +1 -0
  225. package/dist/wms/wip/lib/wcs/parse-wcs-capabilities.d.ts +78 -0
  226. package/dist/wms/wip/lib/wcs/parse-wcs-capabilities.d.ts.map +1 -0
  227. package/dist/wms/wip/lib/wcs/parse-wcs-capabilities.js +14 -0
  228. package/dist/wms/wip/lib/wcs/parse-wcs-capabilities.js.map +1 -0
  229. package/dist/wms/wip/lib/wmts/parse-wmts-capabilities.d.ts +87 -0
  230. package/dist/wms/wip/lib/wmts/parse-wmts-capabilities.d.ts.map +1 -0
  231. package/dist/wms/wip/lib/wmts/parse-wmts-capabilities.js +76 -0
  232. package/dist/wms/wip/lib/wmts/parse-wmts-capabilities.js.map +1 -0
  233. package/dist/wms/wip/lib/wmts/parse-wmts.d.ts +7 -0
  234. package/dist/wms/wip/lib/wmts/parse-wmts.d.ts.map +1 -0
  235. package/dist/wms/wip/lib/wmts/parse-wmts.js +34 -0
  236. package/dist/wms/wip/lib/wmts/parse-wmts.js.map +1 -0
  237. package/dist/wms/wip/wcs-capabilities-loader-with-parser.d.ts +12 -0
  238. package/dist/wms/wip/wcs-capabilities-loader-with-parser.d.ts.map +1 -0
  239. package/dist/wms/wip/wcs-capabilities-loader-with-parser.js +16 -0
  240. package/dist/wms/wip/wcs-capabilities-loader-with-parser.js.map +1 -0
  241. package/dist/wms/wip/wcs-capabilities-loader.d.ts +12 -0
  242. package/dist/wms/wip/wcs-capabilities-loader.d.ts.map +1 -0
  243. package/dist/wms/wip/wcs-capabilities-loader.js +36 -0
  244. package/dist/wms/wip/wcs-capabilities-loader.js.map +1 -0
  245. package/dist/wms/wip/wms-feature-info-loader-with-parser.d.ts +7 -0
  246. package/dist/wms/wip/wms-feature-info-loader-with-parser.d.ts.map +1 -0
  247. package/dist/wms/wip/wms-feature-info-loader-with-parser.js +15 -0
  248. package/dist/wms/wip/wms-feature-info-loader-with-parser.js.map +1 -0
  249. package/dist/wms/wip/wms-feature-info-loader.d.ts +7 -0
  250. package/dist/wms/wip/wms-feature-info-loader.d.ts.map +1 -0
  251. package/dist/wms/wip/wms-feature-info-loader.js +19 -0
  252. package/dist/wms/wip/wms-feature-info-loader.js.map +1 -0
  253. package/dist/wms/wip/wms-layer-description-loader-with-parser.d.ts +7 -0
  254. package/dist/wms/wip/wms-layer-description-loader-with-parser.d.ts.map +1 -0
  255. package/dist/wms/wip/wms-layer-description-loader-with-parser.js +15 -0
  256. package/dist/wms/wip/wms-layer-description-loader-with-parser.js.map +1 -0
  257. package/dist/wms/wip/wms-layer-description-loader.d.ts +7 -0
  258. package/dist/wms/wip/wms-layer-description-loader.d.ts.map +1 -0
  259. package/dist/wms/wip/wms-layer-description-loader.js +19 -0
  260. package/dist/wms/wip/wms-layer-description-loader.js.map +1 -0
  261. package/dist/wms/wip/wmts-capabilities-loader-with-parser.d.ts +11 -0
  262. package/dist/wms/wip/wmts-capabilities-loader-with-parser.d.ts.map +1 -0
  263. package/dist/wms/wip/wmts-capabilities-loader-with-parser.js +17 -0
  264. package/dist/wms/wip/wmts-capabilities-loader-with-parser.js.map +1 -0
  265. package/dist/wms/wip/wmts-capabilities-loader.d.ts +11 -0
  266. package/dist/wms/wip/wmts-capabilities-loader.d.ts.map +1 -0
  267. package/dist/wms/wip/wmts-capabilities-loader.js +36 -0
  268. package/dist/wms/wip/wmts-capabilities-loader.js.map +1 -0
  269. package/dist/wms/wms-capabilities-loader-with-parser.d.ts +40 -0
  270. package/dist/wms/wms-capabilities-loader-with-parser.d.ts.map +1 -0
  271. package/dist/wms/wms-capabilities-loader-with-parser.js +19 -0
  272. package/dist/wms/wms-capabilities-loader-with-parser.js.map +1 -0
  273. package/dist/wms/wms-capabilities-loader.d.ts +62 -0
  274. package/dist/wms/wms-capabilities-loader.d.ts.map +1 -0
  275. package/dist/wms/wms-capabilities-loader.js +38 -0
  276. package/dist/wms/wms-capabilities-loader.js.map +1 -0
  277. package/dist/wms/wms-error-loader-with-parser.d.ts +39 -0
  278. package/dist/wms/wms-error-loader-with-parser.d.ts.map +1 -0
  279. package/dist/wms/wms-error-loader-with-parser.js +28 -0
  280. package/dist/wms/wms-error-loader-with-parser.js.map +1 -0
  281. package/dist/wms/wms-error-loader.d.ts +64 -0
  282. package/dist/wms/wms-error-loader.d.ts.map +1 -0
  283. package/dist/wms/wms-error-loader.js +40 -0
  284. package/dist/wms/wms-error-loader.js.map +1 -0
  285. package/dist/wms/wms-format.d.ts +13 -0
  286. package/dist/wms/wms-format.d.ts.map +1 -0
  287. package/dist/wms/wms-format.js +25 -0
  288. package/dist/wms/wms-format.js.map +1 -0
  289. package/dist/wms/wms-source-loader.d.ts +226 -0
  290. package/dist/wms/wms-source-loader.d.ts.map +1 -0
  291. package/dist/wms/wms-source-loader.js +397 -0
  292. package/dist/wms/wms-source-loader.js.map +1 -0
  293. package/dist/wms/wmts-capabilities-loader-with-parser.cjs +2189 -0
  294. package/dist/wms/wmts-capabilities-loader-with-parser.cjs.map +6 -0
  295. package/dist/wms/wmts-capabilities-loader-with-parser.d.ts +3 -0
  296. package/dist/wms/wmts-capabilities-loader-with-parser.d.ts.map +1 -0
  297. package/dist/wms/wmts-capabilities-loader-with-parser.js +13 -0
  298. package/dist/wms/wmts-capabilities-loader-with-parser.js.map +1 -0
  299. package/dist/wms/wmts-capabilities-loader.d.ts +7 -0
  300. package/dist/wms/wmts-capabilities-loader.d.ts.map +1 -0
  301. package/dist/wms/wmts-capabilities-loader.js +24 -0
  302. package/dist/wms/wmts-capabilities-loader.js.map +1 -0
  303. package/dist/wms/wmts-source-loader.d.ts +120 -0
  304. package/dist/wms/wmts-source-loader.d.ts.map +1 -0
  305. package/dist/wms/wmts-source-loader.js +472 -0
  306. package/dist/wms/wmts-source-loader.js.map +1 -0
  307. package/package.json +89 -4
  308. package/src/index.ts +6 -0
  309. package/src/stac/index.ts +25 -0
  310. package/src/stac/stac-source-loader-types.ts +65 -0
  311. package/src/stac/stac-source.ts +635 -0
  312. package/src/stac/stac-types.ts +230 -0
  313. package/src/wms/bundled.ts +30 -0
  314. package/src/wms/capability-graph.ts +152 -0
  315. package/src/wms/crs-utils.ts +67 -0
  316. package/src/wms/csw-capabilities-loader-with-parser.ts +30 -0
  317. package/src/wms/csw-capabilities-loader.ts +54 -0
  318. package/src/wms/csw-domain-loader-with-parser.ts +28 -0
  319. package/src/wms/csw-domain-loader.ts +53 -0
  320. package/src/wms/csw-records-loader-with-parser.ts +28 -0
  321. package/src/wms/csw-records-loader.ts +52 -0
  322. package/src/wms/csw-source-loader.ts +330 -0
  323. package/src/wms/feature-pagination.ts +198 -0
  324. package/src/wms/gml-loader-types.ts +62 -0
  325. package/src/wms/gml-loader.ts +228 -0
  326. package/src/wms/index.ts +171 -0
  327. package/src/wms/lib/deprecated/create-image-service.ts.disabled +57 -0
  328. package/src/wms/lib/deprecated/create-image-source.ts +75 -0
  329. package/src/wms/lib/deprecated/image-source-compatibility.ts +28 -0
  330. package/src/wms/lib/deprecated/template-image-service.ts.disabled +68 -0
  331. package/src/wms/lib/parsers/csw/parse-csw-capabilities.ts +105 -0
  332. package/src/wms/lib/parsers/csw/parse-csw-domain.ts +47 -0
  333. package/src/wms/lib/parsers/csw/parse-csw-records.ts +94 -0
  334. package/src/wms/lib/parsers/csw/parse-exception-report.ts +33 -0
  335. package/src/wms/lib/parsers/gml/deep-strict-equal.ts +122 -0
  336. package/src/wms/lib/parsers/gml/parse-gml.ts +849 -0
  337. package/src/wms/lib/parsers/gml/rewind-geometry.ts +45 -0
  338. package/src/wms/lib/parsers/ogc-api/tile-matrix-limits.ts +107 -0
  339. package/src/wms/lib/parsers/ogc-api/tile-matrix-set.ts +167 -0
  340. package/src/wms/lib/parsers/wfs/parse-wfs-capabilities.ts +165 -0
  341. package/src/wms/lib/parsers/wfs/parse-wfs.ts +36 -0
  342. package/src/wms/lib/parsers/wms/parse-wms-capabilities.ts +427 -0
  343. package/src/wms/lib/parsers/wms/parse-wms-error.ts +24 -0
  344. package/src/wms/lib/parsers/wms/parse-wms-features.ts +41 -0
  345. package/src/wms/lib/parsers/wms/parse-wms-layer-description.ts +24 -0
  346. package/src/wms/lib/parsers/wmts/parse-wmts-capabilities.ts +281 -0
  347. package/src/wms/lib/parsers/xml/parse-xml-helpers.ts +67 -0
  348. package/src/wms/lib/parsers/xml/parse-xml-text.ts +11 -0
  349. package/src/wms/lib/tile-grid.ts +47 -0
  350. package/src/wms/managed-vector-source.ts +384 -0
  351. package/src/wms/ogc-api-coverages-source-loader.ts +109 -0
  352. package/src/wms/ogc-api-edr-source-loader.ts +127 -0
  353. package/src/wms/ogc-api-source-loader.ts +742 -0
  354. package/src/wms/service-capabilities.ts +147 -0
  355. package/src/wms/service-runtime.ts +225 -0
  356. package/src/wms/unbundled.ts +24 -0
  357. package/src/wms/wcs-source-loader.ts +260 -0
  358. package/src/wms/wfs-capabilities-loader-with-parser.ts +30 -0
  359. package/src/wms/wfs-capabilities-loader.ts +57 -0
  360. package/src/wms/wfs-source-loader.ts +987 -0
  361. package/src/wms/wip/data-source.ts +64 -0
  362. package/src/wms/wip/lib/wcs/parse-wcs-capabilities.ts +91 -0
  363. package/src/wms/wip/lib/wmts/parse-wmts-capabilities.ts +171 -0
  364. package/src/wms/wip/lib/wmts/parse-wmts.ts +39 -0
  365. package/src/wms/wip/services/wmts-service.ts.disabled +348 -0
  366. package/src/wms/wip/wcs-capabilities-loader-with-parser.ts +29 -0
  367. package/src/wms/wip/wcs-capabilities-loader.ts +50 -0
  368. package/src/wms/wip/wms-feature-info-loader-with-parser.ts +25 -0
  369. package/src/wms/wip/wms-feature-info-loader.ts +28 -0
  370. package/src/wms/wip/wms-layer-description-loader-with-parser.ts +25 -0
  371. package/src/wms/wip/wms-layer-description-loader.md.disabled.md +47 -0
  372. package/src/wms/wip/wms-layer-description-loader.ts +28 -0
  373. package/src/wms/wip/wmts-capabilities-loader-with-parser.ts +30 -0
  374. package/src/wms/wip/wmts-capabilities-loader.ts +52 -0
  375. package/src/wms/wms-capabilities-loader-with-parser.ts +45 -0
  376. package/src/wms/wms-capabilities-loader.ts +68 -0
  377. package/src/wms/wms-error-loader-with-parser.ts +44 -0
  378. package/src/wms/wms-error-loader.ts +56 -0
  379. package/src/wms/wms-format.ts +52 -0
  380. package/src/wms/wms-source-loader.ts +686 -0
  381. package/src/wms/wmts-capabilities-loader-with-parser.ts +17 -0
  382. package/src/wms/wmts-capabilities-loader.ts +30 -0
  383. package/src/wms/wmts-source-loader.ts +649 -0
@@ -0,0 +1,987 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+
5
+ import type {Schema, GeoJSONTable, Geometry} from '@loaders.gl/core/schema';
6
+ import {convertFeaturesToWKBArrowTable} from '@loaders.gl/arrow-geometry/feature-collection-to-arrow';
7
+ import {convertGeojsonToBinaryFeatureCollection} from '@loaders.gl/arrow-geometry/legacy-binary';
8
+ import type {
9
+ CoreAPI,
10
+ DataSourceOptions,
11
+ SourceLoader,
12
+ VectorSource,
13
+ VectorSourceMetadata,
14
+ GetFeaturesParameters,
15
+ VectorSourceData
16
+ } from '@loaders.gl/core/loader-utils';
17
+ import {DataSource, mergeOptions} from '@loaders.gl/core/loader-utils';
18
+
19
+ import type {WFSCapabilities} from './wfs-capabilities-loader';
20
+ import {WFSCapabilitiesLoaderWithParser} from './wfs-capabilities-loader-with-parser';
21
+
22
+ import type {WMSLoaderOptions} from './wms-error-loader';
23
+ import type {GMLLoaderOptions} from './gml-loader-types';
24
+ import {WMSErrorLoaderWithParser} from './wms-error-loader-with-parser';
25
+ import {parseGML} from './lib/parsers/gml/parse-gml';
26
+ import type {GMLFeatureCollection, GMLPropertyType} from './lib/parsers/gml/parse-gml';
27
+ import type {CRSIdentifier} from '@math.gl/geospatial/crs';
28
+ import {getServiceCRSAxisOrder, normalizeServiceCRS} from './crs-utils';
29
+ import type {FeaturePaginationOptions, FeaturePage} from './feature-pagination';
30
+ import {
31
+ addNextLinkHeader,
32
+ collectFeaturePages,
33
+ getPaginationOptions,
34
+ iterateFeaturePages
35
+ } from './feature-pagination';
36
+
37
+ /* eslint-disable camelcase */ // WFS XML parameters use snake_case
38
+
39
+ /** Properties for creating a enw WFS service */
40
+ export type WFSourceOptions = DataSourceOptions &
41
+ WMSLoaderOptions &
42
+ GMLLoaderOptions & {
43
+ wfs?: {
44
+ /** Opt-in bounded pagination for getFeatures(); omitted keeps the single-page behavior. */
45
+ pagination?: FeaturePaginationOptions;
46
+ /** In WFS 2.0.0, replaces references to EPSG:4326 with CRS:84. */
47
+ substituteCRS84?: boolean;
48
+ /** Default WFS parameters. If not provided here, must be provided in the various request */
49
+ wfsParameters?: WFSParameters;
50
+ /** Any additional service specific parameters */
51
+ vendorParameters?: Record<string, unknown>;
52
+ /** XML Schema scalar types for feature properties returned by GML. */
53
+ propertyTypes?: Record<string, GMLPropertyType>;
54
+ };
55
+ };
56
+
57
+ /** WFS protocol versions supported by the source URL builder. */
58
+ export type WFSVersion = '1.1.0' | '2.0.0';
59
+
60
+ /**
61
+ * Read-only WFS source supporting extent queries and GeoJSON/GML responses.
62
+ */
63
+ export const WFSSourceLoader = {
64
+ dataType: null as unknown as WFSVectorSource,
65
+ batchType: null as never,
66
+ name: 'WFS',
67
+ id: 'wfs',
68
+ module: 'ogc',
69
+ version: '0.0.0',
70
+ extensions: [],
71
+ mimeTypes: [],
72
+ type: 'wfs',
73
+ fromUrl: true,
74
+ fromBlob: false,
75
+
76
+ options: {
77
+ wfs: {}
78
+ },
79
+
80
+ defaultOptions: {
81
+ wfs: {}
82
+ },
83
+
84
+ testURL: (url: string): boolean => url.toLowerCase().includes('wfs'),
85
+ createDataSource: (url: string, options: WFSourceOptions, coreApi?: CoreAPI): WFSVectorSource =>
86
+ new WFSVectorSource(url, options, coreApi)
87
+ } as const satisfies SourceLoader<WFSVectorSource>;
88
+
89
+ // PARAMETER TYPES FOR WFS SOURCE
90
+
91
+ /**
92
+ * "Static" WFS parameters (not viewport or selected pixel dependent)
93
+ * These can be provided as defaults in the WFSVectorSource constructor
94
+ */
95
+ export type WFSParameters = {
96
+ /** WFS version (all requests) */
97
+ version?: WFSVersion;
98
+ /** Layers to render (GetMap, GetFeatureInfo) */
99
+ layers?: string[];
100
+ /** list of layers to query.. (GetFeatureInfo) */
101
+ query_layers?: string[];
102
+
103
+ /** Coordinate Reference System (CRS) for the image (not the bounding box) */
104
+ crs?: CRSIdentifier;
105
+ /** Output/input CRS parameter used by GetFeature requests. */
106
+ srsName?: CRSIdentifier;
107
+ /** Requested format for the return image (GetMap, GetLegendGraphic) */
108
+ format?: 'image/png';
109
+ /** Requested MIME type of returned feature info (GetFeatureInfo) */
110
+ info_format?: 'text/plain' | 'application/geojson' | 'application/vnd.ogc.gml';
111
+ /** Requested MIME type of WFS GetFeature responses. */
112
+ outputFormat?:
113
+ | 'application/json'
114
+ | 'application/geo+json'
115
+ | 'application/vnd.ogc.gml'
116
+ | 'application/gml+xml';
117
+ /** Maximum number of features returned by a WFS 2.0 request. */
118
+ count?: number;
119
+ /** Zero-based feature offset used for paging. */
120
+ startIndex?: number;
121
+ /** WFS 1.1 equivalent of `count`. */
122
+ maxFeatures?: number;
123
+ /** Comma-separated feature properties to return. */
124
+ propertyName?: string | string[];
125
+ /** OGC Filter XML or a server-specific filter expression. */
126
+ filter?: string;
127
+ /** Return only the result count when supported by the server. */
128
+ resultType?: 'results' | 'hits';
129
+ /** Server-side sort expression. */
130
+ sortBy?: string | string[];
131
+ /** Styling - Not yet supported */
132
+ styles?: unknown;
133
+ /** Any additional parameters specific to this WFSVectorSource (GetMap) */
134
+ transparent?: boolean;
135
+ /** If layer supports time dimension */
136
+ time?: string;
137
+ /** If layer supports elevation dimension */
138
+ elevation?: string;
139
+ };
140
+
141
+ /** Parameters for GetCapabilities */
142
+ export type WFSGetCapabilitiesParameters = {
143
+ /** In case the endpoint supports multiple WFS versions */
144
+ version?: WFSVersion;
145
+ };
146
+
147
+ /** Parameters for GetMap */
148
+ export type WFSGetMapParameters = {
149
+ /** In case the endpoint supports multiple WFS versions */
150
+ version?: WFSVersion;
151
+ /** WFS protocol bounding box of the requested map image. */
152
+ bbox: [number, number, number, number];
153
+ /** pixel width of returned image */
154
+ width: number;
155
+ /** pixels */
156
+ height: number;
157
+ /** requested format for the return image. can be provided in service constructor */
158
+ format?: 'image/png';
159
+ /** Layers to render - can be provided in service constructor */
160
+ layers?: string | string[];
161
+ /** Coordinate Reference System for the image (not bounding box). can be provided in service constructor. */
162
+ crs?: CRSIdentifier;
163
+ /** Styling. can be provided in service constructor */
164
+ styles?: unknown;
165
+ /** Don't render background when no data. can be provided in service constructor */
166
+ transparent?: boolean;
167
+ /** If layer supports time dimension */
168
+ time?: string;
169
+ /** If layer supports elevation dimension */
170
+ elevation?: string;
171
+ };
172
+
173
+ /** Parameters for GetFeature. */
174
+ export type WFSGetFeatureParameters = {
175
+ /** In case the endpoint supports multiple WFS versions. */
176
+ version?: WFSVersion;
177
+ /** Requested feature types. */
178
+ typeName?: string | string[];
179
+ /** Bounding box filter, optionally suffixed with the bbox CRS. */
180
+ bbox: [number, number, number, number] | [number, number, number, number, CRSIdentifier];
181
+ /** Output CRS for returned features. */
182
+ crs?: CRSIdentifier;
183
+ /** Output CRS for returned features. */
184
+ srsName?: CRSIdentifier;
185
+ /** Requested output format. */
186
+ outputFormat?:
187
+ | 'application/json'
188
+ | 'application/geo+json'
189
+ | 'application/vnd.ogc.gml'
190
+ | 'application/gml+xml';
191
+ /** Maximum number of features returned by a WFS 2.0 request. */
192
+ count?: number;
193
+ /** Zero-based feature offset used for paging. */
194
+ startIndex?: number;
195
+ /** WFS 1.1 equivalent of `count`. */
196
+ maxFeatures?: number;
197
+ /** Comma-separated feature properties to return. */
198
+ propertyName?: string | string[];
199
+ /** OGC Filter XML or a server-specific filter expression. */
200
+ filter?: string;
201
+ /** Return only the result count when supported by the server. */
202
+ resultType?: 'results' | 'hits';
203
+ /** Server-side sort expression. */
204
+ sortBy?: string | string[];
205
+ };
206
+
207
+ // /** GetMap parameters that are specific to the current view */
208
+ // export type WFSGetMapViewParameters = {
209
+ // /** pixel width of returned image */
210
+ // width: number;
211
+ // /** pixels */
212
+ // height: number;
213
+ // /** bounding box of the requested map image */
214
+ // bbox: [number, number, number, number];
215
+ // /** Coordinate Reference System for the image (not bounding box). can be provided in service constructor. */
216
+ // crs?: string;
217
+ // };
218
+
219
+ /**
220
+ * Parameters for GetFeatureInfo
221
+ * @see https://imagery.pasda.psu.edu/arcgis/services/pasda/UrbanTreeCanopy_Landcover/MapServer/WmsServer?SERVICE=WFS&
222
+ */
223
+ export type WFSGetFeatureInfoParameters = {
224
+ /** In case the endpoint supports multiple WFS versions */
225
+ version?: WFSVersion;
226
+ /** x coordinate for the feature info request */
227
+ x: number;
228
+ /** y coordinate for the feature info request */
229
+ y: number;
230
+ /** MIME type of returned feature info. Can be specified in service constructor */
231
+ info_format?: 'text/plain' | 'application/geojson' | 'application/vnd.ogc.gml';
232
+ /** list of layers to query. Required but can be specified in service constructor. */
233
+ query_layers?: string[];
234
+ /** Layers to render. Required, but can be specified in service constructor */
235
+ layers?: string[];
236
+ /** Styling */
237
+ styles?: unknown;
238
+ /** bounding box of the requested map image */
239
+ bbox: [number, number, number, number];
240
+ /** pixel width of returned image */
241
+ width: number;
242
+ /** pixels */
243
+ height: number;
244
+ /** srs for the image (not the bounding box) */
245
+ crs?: CRSIdentifier;
246
+ };
247
+
248
+ /** GetMap parameters that are specific to the current view */
249
+ export type WFSGetFeatureInfoViewParameters = {
250
+ /** x coordinate for the feature info request */
251
+ x: number;
252
+ /** y coordinate for the feature info request */
253
+ y: number;
254
+ /** pixel width of returned image */
255
+ width: number;
256
+ /** pixels */
257
+ height: number;
258
+ /** bounding box of the requested map image */
259
+ bbox: [number, number, number, number];
260
+ /** srs for the image (not the bounding box) */
261
+ crs?: CRSIdentifier;
262
+ };
263
+
264
+ /** Parameters for DescribeLayer */
265
+ export type WFSDescribeLayerParameters = {
266
+ /** In case the endpoint supports multiple WFS versions */
267
+ version?: WFSVersion;
268
+ };
269
+
270
+ /** Parameters for GetLegendGraphic */
271
+ export type WFSGetLegendGraphicParameters = {
272
+ /** In case the endpoint supports multiple WFS versions */
273
+ version?: WFSVersion;
274
+ };
275
+
276
+ //
277
+
278
+ /**
279
+ * The WFSVectorSource class provides
280
+ * - provides type safe methods to form URLs to a WFS service
281
+ * - provides type safe methods to query and parse results (and errors) from a WFS service
282
+ * - implements the VectorSource interface
283
+ * @note Only the URL parameter conversion is supported. XML posts are not supported.
284
+ */
285
+ export class WFSVectorSource extends DataSource<string, WFSourceOptions> implements VectorSource {
286
+ /** Default static vendor parameters */
287
+ vendorParameters?: Record<string, unknown>;
288
+
289
+ capabilities: WFSCapabilities | null = null;
290
+
291
+ /** Create a WFSVectorSource */
292
+ constructor(data: string, options: WFSourceOptions, coreApi?: CoreAPI) {
293
+ super(data, options, WFSSourceLoader.defaultOptions, coreApi);
294
+ this.vendorParameters = options.wfs?.vendorParameters;
295
+
296
+ // TODO - defaults such as version, layers etc could be extracted from a base URL with parameters
297
+ // This would make pasting in any WFS URL more likely to make this class just work.
298
+ // const {baseUrl, parameters} = this._parseWFSUrl(options.url);
299
+ }
300
+
301
+ async getSchema(): Promise<Schema> {
302
+ return {metadata: {}, fields: []};
303
+ }
304
+
305
+ // VectorSource implementation
306
+ async getMetadata(): Promise<VectorSourceMetadata> {
307
+ const capabilities = await this.getCapabilities();
308
+ return this.normalizeMetadata(capabilities);
309
+ }
310
+
311
+ /** Fetches one response, or gathers service pages when wfs.pagination is configured. */
312
+ async getFeatures(parameters: GetFeaturesParameters): Promise<VectorSourceData> {
313
+ const geoJsonTable = this.options.wfs?.pagination
314
+ ? await collectFeaturePages(this.getFeaturesInPages(parameters, this.options.wfs.pagination))
315
+ : (await this.fetchFeaturePage(this.getFeaturesURL(parameters), parameters.signal)).table;
316
+ const format = parameters.format || 'arrow';
317
+
318
+ switch (format) {
319
+ case 'binary':
320
+ return convertGeojsonToBinaryFeatureCollection(geoJsonTable.features);
321
+ case 'geojson':
322
+ return geoJsonTable;
323
+ case 'arrow':
324
+ default:
325
+ return convertFeaturesToWKBArrowTable(geoJsonTable.features, {
326
+ encodingPreference: parameters.geoarrow?.encodingPreference
327
+ });
328
+ }
329
+ }
330
+
331
+ /**
332
+ * Yields normalized GeoJSON pages, following next links or WFS 2.0 numeric-count offsets.
333
+ * Page boundaries differ from streaming GML batches. WFS 1.1 needs advertised next links.
334
+ * Bounds, output format, sort/filter settings and cancellation apply to every offset request.
335
+ */
336
+ getFeaturesInPages(
337
+ parameters: GetFeaturesParameters,
338
+ options: FeaturePaginationOptions = this.options.wfs?.pagination || {}
339
+ ): AsyncIterable<GeoJSONTable> {
340
+ const limits = getPaginationOptions(options);
341
+ const initialURL = new URL(this.getFeaturesURL(parameters, {count: limits.pageSize}));
342
+ if (
343
+ [...initialURL.searchParams].some(
344
+ ([name, value]) => name.toUpperCase() === 'RESULTTYPE' && value.toLowerCase() === 'hits'
345
+ )
346
+ )
347
+ throw new Error('Feature pagination requires resultType: results');
348
+ const version = initialURL.searchParams.get('VERSION');
349
+ const initialOffset = Number(
350
+ [...initialURL.searchParams].find(([name]) => name.toUpperCase() === 'STARTINDEX')?.[1] || 0
351
+ );
352
+ if (!Number.isSafeInteger(initialOffset) || initialOffset < 0)
353
+ throw new Error('Feature pagination requires a nonnegative integer startIndex');
354
+ return iterateFeaturePages(
355
+ initialURL.toString(),
356
+ url => this.fetchFeaturePage(url, parameters.signal),
357
+ limits,
358
+ parameters.signal,
359
+ (_pageURL, _table, featureCount, matched) => {
360
+ if (matched === undefined || initialOffset + featureCount >= matched) return undefined;
361
+ if (version !== '2.0.0')
362
+ throw new Error('WFS 1.1 pagination requires an advertised next link');
363
+ const nextURL = new URL(initialURL);
364
+ for (const name of [...nextURL.searchParams.keys()])
365
+ if (name.toUpperCase() === 'STARTINDEX') nextURL.searchParams.delete(name);
366
+ nextURL.searchParams.set('STARTINDEX', String(initialOffset + featureCount));
367
+ return nextURL.toString();
368
+ }
369
+ );
370
+ }
371
+
372
+ /** Fetches and validates one GeoJSON or GML page while preserving pagination metadata. */
373
+ private async fetchFeaturePage(url: string, signal?: AbortSignal): Promise<FeaturePage> {
374
+ const response = await this.fetch(url, signal ? {signal} : undefined);
375
+ const arrayBuffer = await response.arrayBuffer();
376
+ this._checkResponse(response, arrayBuffer);
377
+ const featureCollection = parseWFSFeatureCollection(
378
+ new TextDecoder().decode(arrayBuffer),
379
+ response.headers.get('content-type'),
380
+ {...this.loadOptions, propertyTypes: this.options.wfs?.propertyTypes}
381
+ );
382
+ return {
383
+ table: addNextLinkHeader(parseGeoJSONTable(featureCollection), response.headers.get('link')),
384
+ url: response.url || url
385
+ };
386
+ }
387
+
388
+ /**
389
+ * Streams a WFS GetFeature response as normalized vector batches.
390
+ *
391
+ * GML feature members are parsed as they arrive, allowing large WFS responses
392
+ * to be consumed without holding the complete XML document in memory.
393
+ */
394
+ async *getFeaturesInBatches(
395
+ parameters: GetFeaturesParameters,
396
+ options: {batchSize?: number} = {}
397
+ ): AsyncIterable<VectorSourceData> {
398
+ const url = this.getFeaturesURL(parameters, {
399
+ outputFormat: 'application/vnd.ogc.gml'
400
+ });
401
+ const response = await this.fetch(
402
+ url,
403
+ parameters.signal ? {signal: parameters.signal} : undefined
404
+ );
405
+ if (!response.ok) {
406
+ const arrayBuffer = await response.arrayBuffer();
407
+ this._checkResponse(response, arrayBuffer);
408
+ }
409
+ if (!response.body) {
410
+ const text = await response.text();
411
+ if (isWFSExceptionDocument(text, response.headers.get('content-type'))) {
412
+ throw new Error('WFS GetFeature returned an exception document');
413
+ }
414
+ yield convertWFSFeatures(
415
+ parseGML(text, {...this.loadOptions, propertyTypes: this.options.wfs?.propertyTypes}),
416
+ parameters.format,
417
+ parameters.geoarrow?.encodingPreference
418
+ );
419
+ return;
420
+ }
421
+
422
+ const reader = response.body.getReader();
423
+ const initialChunks: Uint8Array[] = [];
424
+ let initialText = '';
425
+ const textDecoder = new TextDecoder();
426
+ while (initialText.length < 4096 && !initialText.includes('>')) {
427
+ const {done, value} = await reader.read();
428
+ if (done) break;
429
+ if (value) {
430
+ initialChunks.push(value);
431
+ initialText += textDecoder.decode(value, {stream: true});
432
+ }
433
+ }
434
+ initialText += textDecoder.decode();
435
+ if (isWFSExceptionDocument(initialText, response.headers.get('content-type'))) {
436
+ reader.releaseLock();
437
+ throw new Error('WFS GetFeature returned an exception document');
438
+ }
439
+
440
+ const chunks = readResponseChunks(reader, initialChunks);
441
+ const {GMLLoaderWithParser} = await import('./gml-loader');
442
+ for await (const batch of GMLLoaderWithParser.parseInBatches!(chunks, {
443
+ ...this.loadOptions,
444
+ gml: {
445
+ ...this.loadOptions.gml,
446
+ shape: 'geojson',
447
+ batchSize: options.batchSize || 1000,
448
+ propertyTypes: this.options.wfs?.propertyTypes
449
+ }
450
+ })) {
451
+ yield convertWFSFeatures(
452
+ batch as GMLFeatureCollection,
453
+ parameters.format,
454
+ parameters.geoarrow?.encodingPreference
455
+ );
456
+ }
457
+ }
458
+
459
+ /** Exposes advertised feature types and projections through the vector-source contract. */
460
+ normalizeMetadata(capabilities: WFSCapabilities): VectorSourceMetadata {
461
+ return {
462
+ name: capabilities.serviceIdentification?.serviceType || 'WFS',
463
+ title: capabilities.serviceIdentification?.title,
464
+ abstract: capabilities.serviceIdentification?.abstract,
465
+ keywords: [],
466
+ layers: (capabilities.featureTypes || []).map(featureType => ({
467
+ name: featureType.name,
468
+ title: featureType.title,
469
+ crs: featureType.crs,
470
+ boundingBox: featureType.boundingBox
471
+ })),
472
+ formatSpecificMetadata: capabilities
473
+ };
474
+ }
475
+
476
+ // WFS Service API Stubs
477
+
478
+ /** Get Capabilities */
479
+ async getCapabilities(
480
+ wfsParameters?: WFSGetCapabilitiesParameters,
481
+ vendorParameters?: Record<string, unknown>
482
+ ): Promise<WFSCapabilities> {
483
+ const url = this.getCapabilitiesURL(wfsParameters, vendorParameters);
484
+ const response = await this.fetch(url);
485
+ const arrayBuffer = await response.arrayBuffer();
486
+ this._checkResponse(response, arrayBuffer);
487
+ const capabilities = await WFSCapabilitiesLoaderWithParser.parse(arrayBuffer, this.loadOptions);
488
+ this.capabilities = capabilities;
489
+ return capabilities;
490
+ }
491
+
492
+ /** Get a map image *
493
+ async getMap(
494
+ wfsParameters: WFSGetMapParameters,
495
+ vendorParameters?: Record<string, unknown>
496
+ ): Promise<ImageType> {
497
+ const url = this.getMapURL(wfsParameters, vendorParameters);
498
+ const response = await this.fetch(url);
499
+ const arrayBuffer = await response.arrayBuffer();
500
+ this._checkResponse(response, arrayBuffer);
501
+ try {
502
+ return await ImageLoader.parse(arrayBuffer, this.loadOptions);
503
+ } catch {
504
+ throw this._parseError(arrayBuffer);
505
+ }
506
+ }
507
+
508
+ /** Get Feature Info for a coordinate *
509
+ async getFeatureInfo(
510
+ wfsParameters: WFSGetFeatureInfoParameters,
511
+ vendorParameters?: Record<string, unknown>
512
+ ): Promise<WFSFeatureInfo> {
513
+ const url = this.getFeatureInfoURL(wfsParameters, vendorParameters);
514
+ const response = await this.fetch(url);
515
+ const arrayBuffer = await response.arrayBuffer();
516
+ this._checkResponse(response, arrayBuffer);
517
+ return await WFSFeatureInfoLoader.parse(arrayBuffer, this.loadOptions);
518
+ }
519
+
520
+ /** Get Feature Info for a coordinate *
521
+ async getFeatureInfoText(
522
+ wfsParameters: WFSGetFeatureInfoParameters,
523
+ vendorParameters?: Record<string, unknown>
524
+ ): Promise<string> {
525
+ const url = this.getFeatureInfoURL(wfsParameters, vendorParameters);
526
+ const response = await this.fetch(url);
527
+ const arrayBuffer = await response.arrayBuffer();
528
+ this._checkResponse(response, arrayBuffer);
529
+ return new TextDecoder().decode(arrayBuffer);
530
+ }
531
+
532
+ /** Get more information about a layer *
533
+ async describeLayer(
534
+ wfsParameters: WFSDescribeLayerParameters,
535
+ vendorParameters?: Record<string, unknown>
536
+ ): Promise<WFSLayerDescription> {
537
+ const url = this.describeLayerURL(wfsParameters, vendorParameters);
538
+ const response = await this.fetch(url);
539
+ const arrayBuffer = await response.arrayBuffer();
540
+ this._checkResponse(response, arrayBuffer);
541
+ return await WFSLayerDescriptionLoader.parse(arrayBuffer, this.loadOptions);
542
+ }
543
+
544
+ /** Get an image with a semantic legend *
545
+ async getLegendGraphic(
546
+ wfsParameters: WFSGetLegendGraphicParameters,
547
+ vendorParameters?: Record<string, unknown>
548
+ ): Promise<ImageType> {
549
+ const url = this.getLegendGraphicURL(wfsParameters, vendorParameters);
550
+ const response = await this.fetch(url);
551
+ const arrayBuffer = await response.arrayBuffer();
552
+ this._checkResponse(response, arrayBuffer);
553
+ try {
554
+ return await ImageLoader.parse(arrayBuffer, this.loadOptions);
555
+ } catch {
556
+ throw this._parseError(arrayBuffer);
557
+ }
558
+ }
559
+ */
560
+
561
+ // Typed URL creators
562
+ // For applications that want full control of fetching and parsing
563
+
564
+ /** Generate a URL for the GetCapabilities request */
565
+ getCapabilitiesURL(
566
+ wfsParameters?: WFSGetCapabilitiesParameters,
567
+ vendorParameters?: Record<string, unknown>
568
+ ): string {
569
+ const options: Required<WFSGetCapabilitiesParameters> = {
570
+ version: wfsParameters?.version || this.options.wfs?.wfsParameters?.version || '2.0.0',
571
+ ...wfsParameters
572
+ };
573
+ return this._getWFSUrl('GetCapabilities', options, vendorParameters);
574
+ }
575
+
576
+ /** Generate a URL for the GetMap request */
577
+ getMapURL(
578
+ wfsParameters: WFSGetMapParameters,
579
+ vendorParameters?: Record<string, unknown>
580
+ ): string {
581
+ wfsParameters = this._getWFS130Parameters(wfsParameters);
582
+ // @ts-expect-error
583
+ const options: Required<WFSGetMapParameters> = {
584
+ // version: this.wfsParameters.version,
585
+ // format: this.wfsParameters.format,
586
+ // transparent: this.wfsParameters.transparent,
587
+ // time: this.wfsParameters.time,
588
+ // elevation: this.wfsParameters.elevation,
589
+ // layers: this.wfsParameters.layers,
590
+ // styles: this.wfsParameters.styles,
591
+ // crs: this.wfsParameters.crs,
592
+ // bbox: [-77.87304, 40.78975, -77.85828, 40.80228],
593
+ // width: 1200,
594
+ // height: 900,
595
+ ...wfsParameters
596
+ };
597
+ return this._getWFSUrl('GetMap', options, vendorParameters);
598
+ }
599
+
600
+ /** Generate a URL for the GetFeature request. */
601
+ getFeaturesURL(
602
+ parameters: GetFeaturesParameters | WFSGetFeatureParameters,
603
+ vendorParameters?: Record<string, unknown>
604
+ ): string {
605
+ const requestParameters = this._normalizeGetFeatureParameters(parameters);
606
+ const defaultParameters = this.options.wfs?.wfsParameters || {};
607
+ const {layers: defaultLayers, crs: defaultCRS, ...defaultRequestParameters} = defaultParameters;
608
+ const options: WFSGetFeatureParameters & {version: WFSVersion} = {
609
+ ...defaultRequestParameters,
610
+ ...requestParameters,
611
+ version: requestParameters.version || defaultParameters.version || '2.0.0',
612
+ typeName: requestParameters.typeName || defaultLayers,
613
+ bbox: requestParameters.bbox,
614
+ srsName:
615
+ requestParameters.srsName ||
616
+ requestParameters.crs ||
617
+ defaultParameters.srsName ||
618
+ defaultCRS ||
619
+ 'EPSG:4326',
620
+ outputFormat:
621
+ requestParameters.outputFormat || defaultParameters.outputFormat || 'application/json'
622
+ };
623
+ delete options.crs;
624
+ return this._getWFSUrl('GetFeature', options, vendorParameters);
625
+ }
626
+
627
+ /** Generate a URL for the GetFeatureInfo request */
628
+ getFeatureInfoURL(
629
+ wfsParameters: WFSGetFeatureInfoParameters,
630
+ vendorParameters?: Record<string, unknown>
631
+ ): string {
632
+ wfsParameters = this._getWFS130Parameters(wfsParameters);
633
+
634
+ // @ts-expect-error
635
+ const options: Required<WFSGetFeatureInfoParameters> = {
636
+ // version: this.wfsParameters.version,
637
+ // // query_layers: [],
638
+ // // format: this.wfsParameters.format,
639
+ // info_format: this.wfsParameters.info_format,
640
+ // layers: this.wfsParameters.layers,
641
+ // query_layers: this.wfsParameters.query_layers,
642
+ // styles: this.wfsParameters.styles,
643
+ // crs: this.wfsParameters.crs,
644
+ // bbox: [-77.87304, 40.78975, -77.85828, 40.80228],
645
+ // width: 1200,
646
+ // height: 900,
647
+ // x: undefined!,
648
+ // y: undefined!,
649
+ ...wfsParameters
650
+ };
651
+ return this._getWFSUrl('GetFeatureInfo', options, vendorParameters);
652
+ }
653
+
654
+ /** Generate a URL for the GetFeatureInfo request */
655
+ describeLayerURL(
656
+ wfsParameters: WFSDescribeLayerParameters,
657
+ vendorParameters?: Record<string, unknown>
658
+ ): string {
659
+ // @ts-expect-error
660
+ const options: Required<WFSDescribeLayerParameters> = {
661
+ // version: this.wfsParameters.version,
662
+ ...wfsParameters
663
+ };
664
+ return this._getWFSUrl('DescribeLayer', options, vendorParameters);
665
+ }
666
+
667
+ getLegendGraphicURL(
668
+ wfsParameters: WFSGetLegendGraphicParameters,
669
+ vendorParameters?: Record<string, unknown>
670
+ ): string {
671
+ // @ts-expect-error
672
+ const options: Required<WFSGetLegendGraphicParameters> = {
673
+ // version: this.wfsParameters.version,
674
+ // format?
675
+ ...wfsParameters
676
+ };
677
+ return this._getWFSUrl('GetLegendGraphic', options, vendorParameters);
678
+ }
679
+
680
+ // INTERNAL METHODS
681
+
682
+ _parseWFSUrl(url: string): {url: string; parameters: Record<string, unknown>} {
683
+ const [baseUrl, search] = url.split('?');
684
+ const searchParams = search.split('&');
685
+
686
+ const parameters: Record<string, unknown> = {};
687
+ for (const parameter of searchParams) {
688
+ const [key, value] = parameter.split('=');
689
+ parameters[key] = value;
690
+ }
691
+
692
+ return {url: baseUrl, parameters};
693
+ }
694
+
695
+ /**
696
+ * Generate a URL with parameters
697
+ * @note case _getWFSUrl may need to be overridden to handle certain backends?
698
+ * @note at the moment, only URLs with parameters are supported (no XML payloads)
699
+ * */
700
+ protected _getWFSUrl(
701
+ request: string,
702
+ wfsParameters: {version?: WFSVersion; [key: string]: unknown},
703
+ vendorParameters?: Record<string, unknown>
704
+ ): string {
705
+ const url = new URL(this.url);
706
+
707
+ // Add any vendor searchParams
708
+ const allParameters = {
709
+ service: 'WFS',
710
+ version: wfsParameters.version,
711
+ request,
712
+ ...wfsParameters,
713
+ ...this.vendorParameters,
714
+ ...vendorParameters
715
+ };
716
+
717
+ // Encode the keys
718
+ const IGNORE_EMPTY_KEYS = ['transparent', 'time', 'elevation'];
719
+ for (const [key, value] of Object.entries(allParameters)) {
720
+ // hack to preserve test cases. Not super clear if keys should be included when values are undefined
721
+ if (value !== undefined && value !== null && (!IGNORE_EMPTY_KEYS.includes(key) || value)) {
722
+ const encodedParameter = new URLSearchParams(
723
+ this._getURLParameter(key, value, wfsParameters)
724
+ );
725
+ for (const [parameterName, parameterValue] of encodedParameter) {
726
+ for (const existingName of [...url.searchParams.keys()]) {
727
+ if (existingName.toUpperCase() === parameterName) url.searchParams.delete(existingName);
728
+ }
729
+ url.searchParams.set(parameterName, parameterValue);
730
+ }
731
+ }
732
+ }
733
+
734
+ // Parameter values are encoded individually in _getURLParameter. Encoding the
735
+ // complete URL here would encode the percent signs a second time.
736
+ return url.toString();
737
+ }
738
+
739
+ _getWFS130Parameters<ParametersT extends {crs?: CRSIdentifier; srs?: CRSIdentifier}>(
740
+ wfsParameters: ParametersT
741
+ ): ParametersT {
742
+ const newParameters = {...wfsParameters};
743
+ if (newParameters.srs) {
744
+ newParameters.crs = newParameters.crs || newParameters.srs;
745
+ delete newParameters.srs;
746
+ }
747
+ return newParameters;
748
+ }
749
+
750
+ // eslint-disable-next-line complexity
751
+ _getURLParameter(key: string, value: unknown, wfsParameters: WFSParameters): string {
752
+ // Substitute by key
753
+ switch (key) {
754
+ case 'crs':
755
+ // WFS 1.1.0 uses SRS; WFS 2.0.0 uses CRS.
756
+ if (wfsParameters.version !== '2.0.0') {
757
+ key = 'srs';
758
+ // } else if (this.substituteCRS84 && value === 'EPSG:4326') {
759
+ // /** In WFS 2.0.0, replace EPSG:4326 with the backwards-compatible CRS:84. */
760
+ // // Substitute by value
761
+ // value = 'CRS:84';
762
+ }
763
+ break;
764
+
765
+ case 'srs':
766
+ // WFS 1.1.0 uses SRS; WFS 2.0.0 uses CRS.
767
+ if (wfsParameters.version === '2.0.0') {
768
+ key = 'crs';
769
+ }
770
+ break;
771
+
772
+ case 'bbox':
773
+ // Coordinate order is flipped for certain CRS in WFS 1.1.0 and 2.0.0.
774
+ const bbox = this._flipBoundingBox(value, wfsParameters);
775
+ if (bbox) {
776
+ value = bbox;
777
+ }
778
+ break;
779
+
780
+ case 'typeName':
781
+ key = wfsParameters.version === '2.0.0' ? 'typeNames' : 'typeName';
782
+ break;
783
+
784
+ case 'srsName':
785
+ key = 'srsName';
786
+ break;
787
+
788
+ case 'count':
789
+ // WFS 1.1 uses maxFeatures for the equivalent page size.
790
+ if (wfsParameters.version === '1.1.0') {
791
+ key = 'maxFeatures';
792
+ }
793
+ break;
794
+
795
+ case 'maxFeatures':
796
+ // Keep the legacy spelling when targeting WFS 1.1; WFS 2.0 uses count.
797
+ if (wfsParameters.version === '2.0.0') {
798
+ key = 'count';
799
+ }
800
+ break;
801
+
802
+ case 'x':
803
+ // i is the parameter used in WFS 2.0.0.
804
+ if (wfsParameters.version === '2.0.0') {
805
+ key = 'i';
806
+ }
807
+ break;
808
+
809
+ case 'y':
810
+ // j is the parameter used in WFS 2.0.0.
811
+ if (wfsParameters.version === '2.0.0') {
812
+ key = 'j';
813
+ }
814
+ break;
815
+
816
+ default:
817
+ // do nothing
818
+ }
819
+
820
+ key = key.toUpperCase();
821
+
822
+ const parameterValue = Array.isArray(value) ? value.join(',') : String(value);
823
+ return `${key}=${encodeURIComponent(parameterValue)}`;
824
+ }
825
+
826
+ /** Coordinate order is flipped for certain CRS in WFS 1.1.0 and 2.0.0. */
827
+ _flipBoundingBox(
828
+ bboxValue: unknown,
829
+ wfsParameters: WFSParameters
830
+ ): [number, number, number, number] | [number, number, number, number, string] | null {
831
+ // Sanity checks
832
+ if (!Array.isArray(bboxValue) || (bboxValue.length !== 4 && bboxValue.length !== 5)) {
833
+ return null;
834
+ }
835
+
836
+ const normalizedCRS = normalizeServiceCRS(
837
+ bboxValue.length === 5 ? String(bboxValue[4]) : wfsParameters.srsName || wfsParameters.crs
838
+ );
839
+ const flipCoordinates =
840
+ (wfsParameters.version === '1.1.0' || wfsParameters.version === '2.0.0') &&
841
+ getServiceCRSAxisOrder(normalizedCRS) === 'yx' &&
842
+ !(this.options.wfs?.substituteCRS84 && normalizedCRS === 'EPSG:4326');
843
+
844
+ const bbox = bboxValue as
845
+ | [number, number, number, number]
846
+ | [number, number, number, number, string];
847
+ if (!flipCoordinates) {
848
+ return bbox;
849
+ }
850
+
851
+ return bbox.length === 5
852
+ ? [bbox[1], bbox[0], bbox[3], bbox[2], bbox[4]]
853
+ : [bbox[1], bbox[0], bbox[3], bbox[2]];
854
+ }
855
+
856
+ /** Fetches an array buffer and checks the response (boilerplate reduction) */
857
+ protected async _fetchArrayBuffer(url: string): Promise<ArrayBuffer> {
858
+ const response = await this.fetch(url);
859
+ const arrayBuffer = await response.arrayBuffer();
860
+ this._checkResponse(response, arrayBuffer);
861
+ return arrayBuffer;
862
+ }
863
+
864
+ /** Checks for and parses a WFS XML formatted ServiceError and throws an exception */
865
+ protected _checkResponse(response: Response, arrayBuffer: ArrayBuffer): void {
866
+ const contentType = response.headers.get('content-type') || '';
867
+ const responseText = new TextDecoder().decode(arrayBuffer);
868
+ if (!response.ok || isWFSExceptionDocument(responseText, contentType)) {
869
+ // We want error responses to throw exceptions, the WMSErrorLoaderWithParser can do this
870
+ const loadOptions = mergeOptions<WMSLoaderOptions>(this.loadOptions, {
871
+ wms: {throwOnError: true}
872
+ });
873
+ const error = WMSErrorLoaderWithParser.parseSync?.(arrayBuffer, loadOptions);
874
+ throw new Error(error);
875
+ }
876
+ }
877
+
878
+ /** Error situation detected */
879
+ protected _parseError(arrayBuffer: ArrayBuffer): Error {
880
+ const error = WMSErrorLoaderWithParser.parseSync?.(arrayBuffer, this.loadOptions);
881
+ return new Error(error);
882
+ }
883
+
884
+ /** Maps generic viewport parameters onto WFS GetFeature parameters. */
885
+ private _normalizeGetFeatureParameters(
886
+ parameters: GetFeaturesParameters | WFSGetFeatureParameters
887
+ ): WFSGetFeatureParameters {
888
+ if ('boundingBox' in parameters) {
889
+ const outputCrs =
890
+ parameters.crs ||
891
+ this.options.wfs?.wfsParameters?.srsName ||
892
+ this.options.wfs?.wfsParameters?.crs ||
893
+ 'EPSG:4326';
894
+ const requestCrs = parameters.requestCrs || outputCrs;
895
+ return {
896
+ version: this.options.wfs?.wfsParameters?.version || '2.0.0',
897
+ typeName: parameters.layers,
898
+ bbox: [
899
+ parameters.boundingBox[0][0],
900
+ parameters.boundingBox[0][1],
901
+ parameters.boundingBox[1][0],
902
+ parameters.boundingBox[1][1],
903
+ requestCrs
904
+ ],
905
+ crs: outputCrs,
906
+ srsName: outputCrs
907
+ };
908
+ }
909
+
910
+ return parameters;
911
+ }
912
+ }
913
+
914
+ /** Parses a GeoJSON FeatureCollection into the loaders.gl GeoJSON table shape. */
915
+ function parseGeoJSONTable(json: any): GeoJSONTable {
916
+ if (json?.type === 'FeatureCollection' && Array.isArray(json.features)) {
917
+ return {
918
+ ...json,
919
+ shape: 'geojson-table',
920
+ type: 'FeatureCollection',
921
+ features: json.features
922
+ };
923
+ }
924
+
925
+ throw new Error('WFS GetFeature did not return a GeoJSON FeatureCollection');
926
+ }
927
+
928
+ /** Parses a WFS response as GeoJSON or GML based on its content. */
929
+ function parseWFSFeatureCollection(
930
+ text: string,
931
+ contentType: string | null,
932
+ options: Record<string, unknown>
933
+ ): GMLFeatureCollection | any {
934
+ const trimmedText = text.trimStart();
935
+ if (contentType?.includes('xml') || trimmedText.startsWith('<')) {
936
+ return parseGML(text, options) as GMLFeatureCollection;
937
+ }
938
+ return JSON.parse(text);
939
+ }
940
+
941
+ /** Detects WFS exception reports without treating ordinary XML as an error. */
942
+ function isWFSExceptionDocument(text: string, contentType: string | null): boolean {
943
+ return (
944
+ contentType?.includes('application/vnd.ogc.se_xml') === true ||
945
+ /<(?:[\w-]+:)?ServiceExceptionReport\b/i.test(text) ||
946
+ /<(?:[\w-]+:)?ExceptionReport\b/i.test(text)
947
+ );
948
+ }
949
+
950
+ /** Converts a GML feature collection into the generic vector source result. */
951
+ function convertWFSFeatures(
952
+ parsed: Geometry | GMLFeatureCollection | null,
953
+ format?: string,
954
+ encodingPreference?: import('@loaders.gl/core/schema').GeoArrowEncodingPreference
955
+ ): VectorSourceData {
956
+ if (!parsed || parsed.type !== 'FeatureCollection') {
957
+ throw new Error('WFS GetFeature did not return a GML FeatureCollection');
958
+ }
959
+ if (format === 'geojson') {
960
+ return {shape: 'geojson-table', type: 'FeatureCollection', features: parsed.features as any};
961
+ }
962
+ if (format === 'binary') {
963
+ return convertGeojsonToBinaryFeatureCollection(parsed.features as any);
964
+ }
965
+ return convertFeaturesToWKBArrowTable(parsed.features as any, {
966
+ encodingPreference
967
+ });
968
+ }
969
+
970
+ /** Adapts a browser response stream to the chunk iterator expected by GML. */
971
+ async function* readResponseChunks(
972
+ reader: ReadableStreamDefaultReader<Uint8Array>,
973
+ initialChunks: Uint8Array[] = []
974
+ ): AsyncIterable<Uint8Array> {
975
+ for (const chunk of initialChunks) {
976
+ yield chunk;
977
+ }
978
+ try {
979
+ while (true) {
980
+ const {done, value} = await reader.read();
981
+ if (done) return;
982
+ if (value) yield value;
983
+ }
984
+ } finally {
985
+ reader.releaseLock();
986
+ }
987
+ }