@honua/react 0.1.0-beta.0 → 0.1.1-beta.0

package/core/ogc-tiles.js

@@ -11,42 +11,72 @@ import { encodePathSegments, trimTrailingSlashes } from "./path-utils.js";
 import { createOgcMetadataParams } from "./wire-shared.js";
 /** Default OGC tile-matrix-set used when none is specified (Web Mercator XYZ). */
 export const DEFAULT_OGC_TILE_MATRIX_SET = "WebMercatorQuad";
+/** Honua facade path prefix for OGC API Tiles. */
+const TILES_FACADE_BASE = "/ogc/tiles";
+/**
+ * Resolve the OGC API Tiles path prefix: the caller-supplied raw `basePath` (a
+ * `connect()`-discovered third-party service root) or the Honua facade default.
+ * Trailing slashes are trimmed so a discovered root and the facade compose the
+ * same sub-paths. Mirrors the OGC API Records seam in `ogc-records.ts`.
+ */
+function tilesBase(request) {
+    // An omitted basePath uses the Honua facade; an explicit "" is a legitimate
+    // root-mounted raw service and must NOT fall back to the facade prefix.
+    if (request.basePath === undefined)
+        return TILES_FACADE_BASE;
+    const base = request.basePath;
+    let end = base.length;
+    while (end > 0 && base.charCodeAt(end - 1) === 0x2f)
+        end--;
+    return base.slice(0, end);
+}
+/** Cache-key discriminator so a discovered root never collides with the facade. */
+function tilesBaseKey(request) {
+    const base = tilesBase(request);
+    return base === TILES_FACADE_BASE ? "" : `${base}:`;
+}
 /**
  * Top-level OGC API Tiles handle. Mirrors `HonuaOgcFeatures` for the
  * tiles conformance classes.
  */
 export class HonuaOgcTiles {
     client;
+    basePath;
     constructor(options) {
         this.client = options.client;
+        this.basePath = options.basePath;
+    }
+    withBase(request) {
+        return this.basePath !== undefined ? { ...request, basePath: this.basePath } : request;
     }
     tileset(collectionId, tileMatrixSetId) {
         return new HonuaOgcTileset({
             client: this.client,
             collectionId,
             tileMatrixSetId,
+            ...(this.basePath !== undefined ? { basePath: this.basePath } : {}),
         });
     }
     async landing(request = {}) {
-        return this.client.getOgcTilesLanding(request);
+        return this.client.getOgcTilesLanding(this.withBase(request));
     }
     async conformance(request = {}) {
-        return this.client.getOgcTilesConformance(request);
+        return this.client.getOgcTilesConformance(this.withBase(request));
     }
     async tileMatrixSets(request = {}) {
-        return this.client.listOgcTileMatrixSets(request);
+        return this.client.listOgcTileMatrixSets(this.withBase(request));
     }
     async tileMatrixSet(tileMatrixSetId, request = {}) {
-        return this.client.getOgcTileMatrixSet({ ...request, tileMatrixSetId });
+        return this.client.getOgcTileMatrixSet(this.withBase({ ...request, tileMatrixSetId }));
     }
     async tilesets(request) {
-        return this.client.listOgcCollectionTilesets(request);
+        return this.client.listOgcCollectionTilesets(this.withBase(request));
     }
     async tilesetMetadata(request) {
-        return this.client.getOgcCollectionTileset(request);
+        return this.client.getOgcCollectionTileset(this.withBase(request));
     }
     async tile(request) {
-        return this.client.fetchOgcTile(request);
+        return this.client.fetchOgcTile(this.withBase(request));
     }
     /**
      * Build a MapLibre-ready vector source definition for a tiled collection.
@@ -67,7 +97,8 @@ export class HonuaOgcTiles {
         const baseUrl = trimTrailingSlashes(this.client.serverBaseUrl);
         const collection = encodePathSegments(serviceId);
         const matrixSet = encodeURIComponent(tileMatrixSetId);
-        const template = `${baseUrl}/ogc/tiles/collections/${collection}/tiles/${matrixSet}/{z}/{y}/{x}`;
+        const base = tilesBase({ ...(this.basePath !== undefined ? { basePath: this.basePath } : {}) });
+        const template = `${baseUrl}${base}/collections/${collection}/tiles/${matrixSet}/{z}/{y}/{x}`;
         const source = {
             type: "vector",
             tiles: [template],
@@ -112,16 +143,19 @@ export class HonuaOgcTileset {
     client;
     collectionId;
     tileMatrixSetId;
+    basePath;
     constructor(options) {
         this.client = options.client;
         this.collectionId = options.collectionId;
         this.tileMatrixSetId = options.tileMatrixSetId;
+        this.basePath = options.basePath;
     }
     async metadata(request = {}) {
         return this.client.getOgcCollectionTileset({
             ...request,
             collectionId: this.collectionId,
             tileMatrixSetId: this.tileMatrixSetId,
+            ...(this.basePath !== undefined ? { basePath: this.basePath } : {}),
         });
     }
     async tile(request) {
@@ -129,6 +163,7 @@ export class HonuaOgcTileset {
             ...request,
             collectionId: this.collectionId,
             tileMatrixSetId: this.tileMatrixSetId,
+            ...(this.basePath !== undefined ? { basePath: this.basePath } : {}),
         });
     }
 }
@@ -142,30 +177,34 @@ export function createHonuaOgcTiles(client) {
 // exposes thin `get*/list*/fetch*` delegators that call these.
 export async function getOgcTilesLanding(transport, request = {}) {
     const params = createOgcMetadataParams(request);
-    return transport.requestCachedMetadataJson(`ogc-tiles:landing:${params.toString()}`, `/ogc/tiles?${params.toString()}`, request);
+    const base = tilesBase(request);
+    return transport.requestCachedMetadataJson(`ogc-tiles:landing:${tilesBaseKey(request)}${params.toString()}`, `${base}?${params.toString()}`, request);
 }
 export async function getOgcTilesConformance(transport, request = {}) {
     const params = createOgcMetadataParams(request);
-    return transport.requestCachedMetadataJson(`ogc-tiles:conformance:${params.toString()}`, `/ogc/tiles/conformance?${params.toString()}`, request);
+    const base = tilesBase(request);
+    return transport.requestCachedMetadataJson(`ogc-tiles:conformance:${tilesBaseKey(request)}${params.toString()}`, `${base}/conformance?${params.toString()}`, request);
 }
 export async function listOgcTileMatrixSets(transport, request = {}) {
     const params = createOgcMetadataParams(request);
-    return transport.requestCachedMetadataJson(`ogc-tiles:tile-matrix-sets:${params.toString()}`, `/ogc/tiles/tileMatrixSets?${params.toString()}`, request);
+    const base = tilesBase(request);
+    return transport.requestCachedMetadataJson(`ogc-tiles:tile-matrix-sets:${tilesBaseKey(request)}${params.toString()}`, `${base}/tileMatrixSets?${params.toString()}`, request);
 }
 export async function getOgcTileMatrixSet(transport, request) {
     const params = createOgcMetadataParams(request);
-    return transport.requestCachedMetadataJson(`ogc-tiles:tile-matrix-set:${request.tileMatrixSetId}:${params.toString()}`, `/ogc/tiles/tileMatrixSets/${encodeURIComponent(request.tileMatrixSetId)}?${params.toString()}`, request);
+    const base = tilesBase(request);
+    return transport.requestCachedMetadataJson(`ogc-tiles:tile-matrix-set:${tilesBaseKey(request)}${request.tileMatrixSetId}:${params.toString()}`, `${base}/tileMatrixSets/${encodeURIComponent(request.tileMatrixSetId)}?${params.toString()}`, request);
 }
 export async function listOgcCollectionTilesets(transport, request) {
     const params = createOgcMetadataParams(request);
-    const path = `/ogc/tiles/collections/${encodeURIComponent(String(request.collectionId))}/tiles`;
-    return transport.requestCachedMetadataJson(`ogc-tiles:tilesets:${request.collectionId}:${params.toString()}`, `${path}?${params.toString()}`, request);
+    const path = `${tilesBase(request)}/collections/${encodeURIComponent(String(request.collectionId))}/tiles`;
+    return transport.requestCachedMetadataJson(`ogc-tiles:tilesets:${tilesBaseKey(request)}${request.collectionId}:${params.toString()}`, `${path}?${params.toString()}`, request);
 }
 export async function getOgcCollectionTileset(transport, request) {
     const params = createOgcMetadataParams(request);
-    const path = `/ogc/tiles/collections/${encodeURIComponent(String(request.collectionId))}` +
+    const path = `${tilesBase(request)}/collections/${encodeURIComponent(String(request.collectionId))}` +
         `/tiles/${encodeURIComponent(request.tileMatrixSetId)}`;
-    return transport.requestCachedMetadataJson(`ogc-tiles:tileset:${request.collectionId}:${request.tileMatrixSetId}:${params.toString()}`, `${path}?${params.toString()}`, request);
+    return transport.requestCachedMetadataJson(`ogc-tiles:tileset:${tilesBaseKey(request)}${request.collectionId}:${request.tileMatrixSetId}:${params.toString()}`, `${path}?${params.toString()}`, request);
 }
 export async function fetchOgcTile(transport, request) {
     const params = new URLSearchParams();
@@ -178,6 +217,6 @@ export async function fetchOgcTile(transport, request) {
     const matrixSet = encodeURIComponent(request.tileMatrixSetId);
     const matrix = encodeURIComponent(String(request.tileMatrix));
     const query = params.size > 0 ? `?${params.toString()}` : "";
-    const path = `/ogc/tiles/collections/${collection}/tiles/${matrixSet}/${matrix}/${request.tileRow}/${request.tileCol}${query}`;
+    const path = `${tilesBase(request)}/collections/${collection}/tiles/${matrixSet}/${matrix}/${request.tileRow}/${request.tileCol}${query}`;
     return transport.requestBytes("GET", path, request.accept, undefined, request.signal);
 }

package/core/path-utils.d.ts

@@ -21,6 +21,15 @@ export declare function trimSurroundingSlashes(value: string): string;
  * or `_` padding) without anchored `^x+|x+$` regexes.
  */
 export declare function trimChar(value: string, char: string): string;
+/**
+ * Remove a trailing run of characters from `value` that belong to `chars`.
+ *
+ * Equivalent to `value.replace(new RegExp(\`[${chars}]+$\`), "")` but avoids
+ * building an anchored character-class regex (which can exhibit polynomial
+ * matching on adversarial input) by scanning backward from the end with
+ * simple index arithmetic instead.
+ */
+export declare function trimTrailingCharsIn(value: string, chars: string): string;
 /**
  * Return `value` with any `?query` and `#fragment` suffix removed.
  *

package/core/path-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../../../src/core/path-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,wDAAwD;AACxD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED,uDAAuD;AACvD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED,oEAAoE;AACpE,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAW5D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAU3D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAS7D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQxD"}
+{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../../../src/core/path-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,wDAAwD;AACxD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED,uDAAuD;AACvD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED,oEAAoE;AACpE,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAW5D;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAUxE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAU3D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAS7D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQxD"}

package/core/path-utils.js

@@ -46,6 +46,25 @@ export function trimChar(value, char) {
     }
     return start === 0 && end === value.length ? value : value.slice(start, end);
 }
+/**
+ * Remove a trailing run of characters from `value` that belong to `chars`.
+ *
+ * Equivalent to `value.replace(new RegExp(\`[${chars}]+$\`), "")` but avoids
+ * building an anchored character-class regex (which can exhibit polynomial
+ * matching on adversarial input) by scanning backward from the end with
+ * simple index arithmetic instead.
+ */
+export function trimTrailingCharsIn(value, chars) {
+    const allowed = new Set();
+    for (let i = 0; i < chars.length; i += 1) {
+        allowed.add(chars.charCodeAt(i));
+    }
+    let end = value.length;
+    while (end > 0 && allowed.has(value.charCodeAt(end - 1))) {
+        end -= 1;
+    }
+    return end === value.length ? value : value.slice(0, end);
+}
 /**
  * Return `value` with any `?query` and `#fragment` suffix removed.
  *

package/core/protocol-transport.d.ts

@@ -66,6 +66,7 @@ export interface HonuaProtocolTransport {
      */
     pipelineFetch(method: QueryMethod, path: string, init?: RequestInit, callerSignal?: AbortSignal, options?: {
         okStatuses?: readonly number[];
+        redirect?: "safe-follow" | "error";
     }): Promise<Response>;
     /**
      * Request a PBF binary response and decode it, transparently falling back to

package/core/protocol-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol-transport.d.ts","sourceRoot":"","sources":["../../../src/core/protocol-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;IACH,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAElH;;;OAGG;IACH,WAAW,CACT,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACzF,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAElE;;;OAGG;IACH,YAAY,CACV,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,CAAC,EAAE,WAAW,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAEvE;;;OAGG;IACH,yBAAyB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEhH;;;OAGG;IACH,aAAa,CACX,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,WAAW,EAClB,YAAY,CAAC,EAAE,WAAW,EAC1B,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,GAC3C,OAAO,CAAC,QAAQ,CAAC,CAAC;IAErB;;;OAGG;IACH,6BAA6B,CAAC,CAAC,GAAG,OAAO,EACvC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,EACvB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,CAAC,CAAC,CAAC;CACf"}
+{"version":3,"file":"protocol-transport.d.ts","sourceRoot":"","sources":["../../../src/core/protocol-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;IACH,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAElH;;;OAGG;IACH,WAAW,CACT,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACzF,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAElE;;;OAGG;IACH,YAAY,CACV,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,CAAC,EAAE,WAAW,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAEvE;;;OAGG;IACH,yBAAyB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEhH;;;OAGG;IACH,aAAa,CACX,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,WAAW,EAClB,YAAY,CAAC,EAAE,WAAW,EAC1B,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAA;KAAE,GAC/E,OAAO,CAAC,QAAQ,CAAC,CAAC;IAErB;;;OAGG;IACH,6BAA6B,CAAC,CAAC,GAAG,OAAO,EACvC,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,EACvB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,CAAC,CAAC,CAAC;CACf"}

package/core/request-pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-pipeline.d.ts","sourceRoot":"","sources":["../../../src/core/request-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,cAAc,EAAwC,MAAM,aAAa,CAAC;AACpG,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEjE;;;;;;;GAOG;AAEH,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACpC;AAED,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,MAAM,CAAiC,CAAC;AACzF,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,WAAW,CAAqC,CAAC;AAEjG,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKpF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,sBAAsB,GAAG,SAAS,CAsChH;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM,GAAG,SAAS,CAgBzF;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAExE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,sBAAsB,GAAG,SAAS,EAChD,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,KAAK,EAAE,OAAO,GACb,OAAO,CAkBT;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,sBAAsB,GAAG,SAAS,EAChD,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,QAAQ,GAClB,MAAM,CAWR;AAED;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,EAAE,WAAW,CAAC,MAAM,CAK3D,CAAC;AAKH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAUnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,sBAAsB,GAAG,SAAS,EAChD,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,GACf,OAAO,CAYT;AAYD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,sBAAsB,GAAG,SAAS,EAChD,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GACb,MAAM,CAOR;AAED,wBAAsB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB3E;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAQ3D;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,EAC9C,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,aAAa,CA8Cf;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,cAAc,CAgB7E"}
+{"version":3,"file":"request-pipeline.d.ts","sourceRoot":"","sources":["../../../src/core/request-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,cAAc,EAAwC,MAAM,aAAa,CAAC;AACpG,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEjE;;;;;;;GAOG;AAEH,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACpC;AAED,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,MAAM,CAAiC,CAAC;AACzF,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,WAAW,CAA6C,CAAC;AAEzG,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKpF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,sBAAsB,GAAG,SAAS,CAsChH;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM,GAAG,SAAS,CAgBzF;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAExE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,sBAAsB,GAAG,SAAS,EAChD,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,KAAK,EAAE,OAAO,GACb,OAAO,CAkBT;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,sBAAsB,GAAG,SAAS,EAChD,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,QAAQ,GAClB,MAAM,CAWR;AAED;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,EAAE,WAAW,CAAC,MAAM,CAK3D,CAAC;AAKH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAUnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,sBAAsB,GAAG,SAAS,EAChD,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,GACf,OAAO,CAYT;AAYD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,sBAAsB,GAAG,SAAS,EAChD,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GACb,MAAM,CAOR;AAED,wBAAsB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB3E;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAQ3D;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,EAC9C,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,aAAa,CA8Cf;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,cAAc,CAgB7E"}

package/core/request-pipeline.js

@@ -1,6 +1,6 @@
 import { HonuaAbortError, HonuaHttpError, HonuaNetworkError, HonuaTimeoutError } from "./errors.js";
 export const DEFAULT_RETRY_STATUSES = new Set([429, 502, 503, 504]);
-export const DEFAULT_RETRY_METHODS = new Set(["GET", "PUT", "DELETE"]);
+export const DEFAULT_RETRY_METHODS = new Set(["GET", "HEAD", "PUT", "DELETE"]);
 export function normalizeTimeoutMs(timeoutMs) {
     if (typeof timeoutMs !== "number" || !Number.isFinite(timeoutMs)) {
         return undefined;

package/core/spatial-filter.d.ts

@@ -45,8 +45,12 @@ export declare function point(x: number, y: number, spatialReference?: HonuaSpat
  */
 export declare function polygon(rings: number[][][], spatialReference?: HonuaSpatialReference): SpatialFilter;
 /**
- * Create an envelope spatial filter centered on a point, approximating a
- * circular buffer as a bounding box.
+ * Create an axis-aligned envelope spatial filter centered on a point.
+ *
+ * This is a planar expansion in the input coordinate system's units. It is an
+ * envelope approximation, not a circular, geodesic, or topological geometry
+ * buffer. Use `buffer` from `@honua/sdk-js/geometry` when a true geometry
+ * buffer is required.
  *
  * @param x - Center x coordinate
  * @param y - Center y coordinate
@@ -58,11 +62,11 @@ export declare function polygon(rings: number[][][], spatialReference?: HonuaSpa
  * // 0.5-degree bounding box around a point
  * const req: QueryFeaturesRequest = {
  *   serviceId: "svc", layerId: 0,
- *   ...buffer(-118.24, 34.05, 0.5),
+ *   ...bufferEnvelope(-118.24, 34.05, 0.5),
  * };
  * ```
  */
-export declare function buffer(x: number, y: number, distance: number, spatialReference?: HonuaSpatialReference): SpatialFilter;
+export declare function bufferEnvelope(x: number, y: number, distance: number, spatialReference?: HonuaSpatialReference): SpatialFilter;
 /**
  * Wrap an existing geometry with `esriSpatialRelIntersects`.
  *

package/core/spatial-filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spatial-filter.d.ts","sourceRoot":"","sources":["../../../src/core/spatial-filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAE1F;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,YAAY,EAAE,gBAAgB,CAAC;IAC/B,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,gBAAgB,CAAC,EAAE,qBAAqB,GACvC,aAAa,CAQf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,qBAAqB,GAAG,aAAa,CAQnG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,gBAAgB,CAAC,EAAE,qBAAqB,GAAG,aAAa,CAQpG;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,MAAM,CACpB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,QAAQ,EAAE,MAAM,EAChB,gBAAgB,CAAC,EAAE,qBAAqB,GACvC,aAAa,CAEf;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CAMlF;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CAMhF;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CAM9E"}
+{"version":3,"file":"spatial-filter.d.ts","sourceRoot":"","sources":["../../../src/core/spatial-filter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAE1F;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,YAAY,EAAE,gBAAgB,CAAC;IAC/B,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,gBAAgB,CAAC,EAAE,qBAAqB,GACvC,aAAa,CAQf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,qBAAqB,GAAG,aAAa,CAQnG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,gBAAgB,CAAC,EAAE,qBAAqB,GAAG,aAAa,CAQpG;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAC5B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,QAAQ,EAAE,MAAM,EAChB,gBAAgB,CAAC,EAAE,qBAAqB,GACvC,aAAa,CAuBf;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CAMlF;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CAMhF;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CAM9E"}

package/core/spatial-filter.js

@@ -1,3 +1,4 @@
+import { HonuaGeometryError } from "./errors.js";
 /**
  * Create an envelope (bounding box) spatial filter.
  *
@@ -62,8 +63,12 @@ export function polygon(rings, spatialReference) {
     };
 }
 /**
- * Create an envelope spatial filter centered on a point, approximating a
- * circular buffer as a bounding box.
+ * Create an axis-aligned envelope spatial filter centered on a point.
+ *
+ * This is a planar expansion in the input coordinate system's units. It is an
+ * envelope approximation, not a circular, geodesic, or topological geometry
+ * buffer. Use `buffer` from `@honua/sdk-js/geometry` when a true geometry
+ * buffer is required.
  *
  * @param x - Center x coordinate
  * @param y - Center y coordinate
@@ -75,12 +80,25 @@ export function polygon(rings, spatialReference) {
  * // 0.5-degree bounding box around a point
  * const req: QueryFeaturesRequest = {
  *   serviceId: "svc", layerId: 0,
- *   ...buffer(-118.24, 34.05, 0.5),
+ *   ...bufferEnvelope(-118.24, 34.05, 0.5),
  * };
  * ```
  */
-export function buffer(x, y, distance, spatialReference) {
-    return envelope(x - distance, y - distance, x + distance, y + distance, spatialReference);
+export function bufferEnvelope(x, y, distance, spatialReference) {
+    if (![x, y, distance].every(isFiniteNumber) || distance < 0) {
+        throw new HonuaGeometryError("malformed-geometry", "Cannot create a buffer envelope: x, y, and distance must be finite numbers and distance must be non-negative", {
+            operation: "buffer-envelope",
+            reason: "invalid-coordinate-or-distance",
+        });
+    }
+    const bounds = [x - distance, y - distance, x + distance, y + distance];
+    if (!bounds.every(isFiniteNumber)) {
+        throw new HonuaGeometryError("malformed-geometry", "Cannot create a buffer envelope: computed bounds must be finite", {
+            operation: "buffer-envelope",
+            reason: "computed-bounds-not-finite",
+        });
+    }
+    return envelope(...bounds, spatialReference);
 }
 /**
  * Wrap an existing geometry with `esriSpatialRelIntersects`.
@@ -131,23 +149,195 @@ export function spatialWithin(geometry) {
  * Detect the Esri geometry type from a plain geometry object by inspecting
  * its shape (duck-typing).
  *
+ * @see https://developers.arcgis.com/rest/services-reference/enterprise/geometry-objects/
  * @internal
  */
 function detectGeometryType(geometry) {
-    if ("xmin" in geometry && "ymin" in geometry && "xmax" in geometry && "ymax" in geometry) {
-        return "esriGeometryEnvelope";
+    if (!isGeometryRecord(geometry)) {
+        throw new HonuaGeometryError("malformed-geometry", "Unable to classify geometry: geometry must be a non-null object", {
+            operation: "classify",
+            reason: "geometry-must-be-object",
+            keys: [],
+        });
+    }
+    const keys = Object.keys(geometry).sort();
+    const candidates = [
+        hasAnyOwn(geometry, ["xmin", "ymin", "xmax", "ymax"]) ? "envelope" : undefined,
+        hasOwn(geometry, "rings") ? "polygon" : undefined,
+        hasOwn(geometry, "paths") ? "polyline" : undefined,
+        hasOwn(geometry, "points") ? "multipoint" : undefined,
+        hasAnyOwn(geometry, ["x", "y"]) ? "point" : undefined,
+    ].filter((candidate) => candidate !== undefined);
+    if (candidates.length === 0) {
+        throw geometryClassificationError("unknown-geometry", "no supported Esri geometry shape was found", keys);
+    }
+    if (candidates.length > 1) {
+        throw geometryClassificationError("malformed-geometry", `geometry contains conflicting shape discriminators: ${candidates.join(", ")}`, keys);
+    }
+    const candidate = candidates[0];
+    switch (candidate) {
+        case "envelope":
+            assertEnvelope(geometry, keys);
+            return "esriGeometryEnvelope";
+        case "polygon":
+            assertParts(geometry, "rings", "polygon", 4, true, keys);
+            return "esriGeometryPolygon";
+        case "polyline":
+            assertParts(geometry, "paths", "polyline", 2, false, keys);
+            return "esriGeometryPolyline";
+        case "multipoint":
+            assertPositions(geometry, keys);
+            return "esriGeometryMultipoint";
+        case "point":
+            assertPoint(geometry, keys);
+            return "esriGeometryPoint";
+    }
+}
+function isGeometryRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function hasOwn(value, key) {
+    return Object.prototype.hasOwnProperty.call(value, key);
+}
+function hasAnyOwn(value, keys) {
+    return keys.some((key) => hasOwn(value, key));
+}
+function isFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value);
+}
+function assertPoint(geometry, keys) {
+    if (hasOwn(geometry, "x") && geometry.x === null) {
+        assertEmptyMembers(geometry, ["y", "z", "m", "id"], "point", keys);
+        return;
     }
-    if ("rings" in geometry) {
-        return "esriGeometryPolygon";
+    if (!isFiniteNumber(geometry.x) || !isFiniteNumber(geometry.y)) {
+        throw geometryClassificationError("malformed-geometry", "point requires finite numeric x and y coordinates", keys, "point");
+    }
+    assertOptionalFiniteMember(geometry, "z", "point", keys);
+    assertOptionalFiniteMember(geometry, "m", "point", keys, true);
+    assertOptionalFiniteMember(geometry, "id", "point", keys);
+}
+function assertEnvelope(geometry, keys) {
+    if (hasOwn(geometry, "xmin") && geometry.xmin === null) {
+        assertEmptyMembers(geometry, ["ymin", "xmax", "ymax", "zmin", "zmax", "mmin", "mmax", "idmin", "idmax"], "envelope", keys);
+        return;
     }
-    if ("paths" in geometry) {
-        return "esriGeometryPolyline";
+    const { xmin, ymin, xmax, ymax } = geometry;
+    if (![xmin, ymin, xmax, ymax].every(isFiniteNumber)) {
+        throw geometryClassificationError("malformed-geometry", "envelope requires finite numeric xmin, ymin, xmax, and ymax coordinates", keys, "envelope");
     }
-    if ("points" in geometry) {
-        return "esriGeometryMultipoint";
+    if (xmin > xmax || ymin > ymax) {
+        throw geometryClassificationError("malformed-geometry", "envelope minimum coordinates must not exceed maximum coordinates", keys, "envelope");
     }
-    if ("x" in geometry && "y" in geometry) {
-        return "esriGeometryPoint";
+    assertOptionalBounds(geometry, "zmin", "zmax", "envelope", keys);
+    assertOptionalBounds(geometry, "mmin", "mmax", "envelope", keys);
+    assertOptionalBounds(geometry, "idmin", "idmax", "envelope", keys);
+}
+function assertPositions(geometry, keys) {
+    const value = geometry.points;
+    if (!Array.isArray(value)) {
+        throw geometryClassificationError("malformed-geometry", "multipoint points must be an array of coordinate positions", keys, "multipoint");
+    }
+    const dimensions = geometryDimensions(geometry, "multipoint", keys);
+    for (const position of value) {
+        // ArcGIS permits empty point slots in multipoints and ignores them during
+        // spatial evaluation. Preserve that wire-compatible behavior while still
+        // rejecting every non-empty malformed position.
+        if (Array.isArray(position) && position.length === 0)
+            continue;
+        assertPosition(position, dimensions, "multipoint", keys);
+    }
+}
+function assertParts(geometry, property, shape, minimumPositions, requireClosure, keys) {
+    const value = geometry[property];
+    if (!Array.isArray(value)) {
+        throw geometryClassificationError("malformed-geometry", `${shape} ${property} must be an array of coordinate arrays`, keys, shape);
     }
-    return "esriGeometryPoint";
+    const dimensions = geometryDimensions(geometry, shape, keys);
+    for (const part of value) {
+        if (!Array.isArray(part)) {
+            throw geometryClassificationError("malformed-geometry", `${shape} ${property} must contain coordinate arrays`, keys, shape);
+        }
+        // The REST empty sentinel is an empty outer paths/rings array. Empty inner
+        // parts are not canonical and cannot be mixed with populated parts.
+        if (part.length < minimumPositions) {
+            throw geometryClassificationError("malformed-geometry", `${shape} ${property} parts require at least ${minimumPositions} positions`, keys, shape);
+        }
+        for (const position of part)
+            assertPosition(position, dimensions, shape, keys);
+        if (requireClosure) {
+            const first = part[0];
+            const last = part[part.length - 1];
+            if (first[0] !== last[0] || first[1] !== last[1]) {
+                throw geometryClassificationError("malformed-geometry", `${shape} ${property} parts must be closed`, keys, shape);
+            }
+        }
+    }
+}
+function geometryDimensions(geometry, shape, keys) {
+    return {
+        hasZ: geometryBooleanFlag(geometry, "hasZ", shape, keys),
+        hasM: geometryBooleanFlag(geometry, "hasM", shape, keys),
+    };
+}
+function geometryBooleanFlag(geometry, property, shape, keys) {
+    if (!hasOwn(geometry, property))
+        return false;
+    if (typeof geometry[property] !== "boolean") {
+        throw geometryClassificationError("malformed-geometry", `${shape} ${property} must be a boolean when present`, keys, shape);
+    }
+    return geometry[property];
+}
+function assertPosition(value, dimensions, shape, keys) {
+    const minimumArity = dimensions.hasZ ? 3 : 2;
+    const maximumArity = minimumArity + (dimensions.hasM ? 1 : 0);
+    if (!Array.isArray(value) || value.length < minimumArity || value.length > maximumArity || value.length > 4) {
+        throw geometryClassificationError("malformed-geometry", `${shape} positions must match declared hasZ/hasM dimensions and contain at most four ordinates`, keys, shape);
+    }
+    if (!isFiniteNumber(value[0]) || !isFiniteNumber(value[1])) {
+        throw geometryClassificationError("malformed-geometry", `${shape} positions require finite numeric x and y ordinates`, keys, shape);
+    }
+    if (dimensions.hasZ && !isFiniteNumber(value[2])) {
+        throw geometryClassificationError("malformed-geometry", `${shape} positions require a finite z ordinate when hasZ is true`, keys, shape);
+    }
+    if (dimensions.hasM && value.length === maximumArity) {
+        const measure = value[maximumArity - 1];
+        if (measure !== null && !isFiniteNumber(measure)) {
+            throw geometryClassificationError("malformed-geometry", `${shape} m ordinates must be finite numbers, null, or omitted`, keys, shape);
+        }
+    }
+}
+function assertEmptyMembers(geometry, members, shape, keys) {
+    const contradictory = members.filter((member) => hasOwn(geometry, member) && geometry[member] !== null);
+    if (contradictory.length > 0) {
+        throw geometryClassificationError("malformed-geometry", `${shape} empty sentinel conflicts with non-null members: ${contradictory.join(", ")}`, keys, shape);
+    }
+}
+function assertOptionalFiniteMember(geometry, property, shape, keys, allowNull = false) {
+    if (!hasOwn(geometry, property))
+        return;
+    const value = geometry[property];
+    if ((allowNull && value === null) || isFiniteNumber(value))
+        return;
+    const expectation = allowNull ? "a finite number or null" : "a finite number";
+    throw geometryClassificationError("malformed-geometry", `${shape} ${property} must be ${expectation} when present`, keys, shape);
+}
+function assertOptionalBounds(geometry, minimumProperty, maximumProperty, shape, keys) {
+    const hasMinimum = hasOwn(geometry, minimumProperty);
+    const hasMaximum = hasOwn(geometry, maximumProperty);
+    if (!hasMinimum && !hasMaximum)
+        return;
+    const minimum = geometry[minimumProperty];
+    const maximum = geometry[maximumProperty];
+    if (!hasMinimum || !hasMaximum || !isFiniteNumber(minimum) || !isFiniteNumber(maximum) || minimum > maximum) {
+        throw geometryClassificationError("malformed-geometry", `envelope ${minimumProperty}/${maximumProperty} must be a complete ordered pair of finite numbers`, keys, shape);
+    }
+}
+function geometryClassificationError(code, reason, keys, shape) {
+    return new HonuaGeometryError(code, `Unable to classify geometry: ${reason}`, {
+        operation: "classify",
+        reason,
+        keys,
+        ...(shape === undefined ? {} : { shape }),
+    });
 }

package/core/stac-static.d.ts

@@ -15,6 +15,7 @@
  *
  * @module
  */
+import type { SourceLocator } from "../contract/types.js";
 import type { HonuaClient } from "./client.js";
 import type { HonuaStacItemCollectionResponse } from "./types.js";
 /** Bounded search parameters for a static catalog traversal. */
@@ -34,7 +35,8 @@ export interface StacStaticSearchParams {
 export declare class HonuaStacStaticCatalog {
     readonly client: HonuaClient;
     private readonly rootUrl;
-    constructor(client: HonuaClient, rootUrl?: string);
+    private readonly policy;
+    constructor(client: HonuaClient, rootUrl?: string, policy?: SourceLocator["stacStatic"]);
     /**
      * Traverse the catalog tree, collect matching items, and return them in
      * the STAC search envelope shape.
@@ -44,7 +46,9 @@ export declare class HonuaStacStaticCatalog {
     /**
      * Breadth-first walk collecting item documents. Descends `rel="child"`
      * links; a `collections` filter prunes Collection subtrees whose `id`
-     * is not requested. Bounded by {@link MAX_DOCUMENTS} and the item cap.
+     * is not requested. Every attempted document, traversal depth, per-document
+     * link list, response body, redirect, and origin is bounded by the locator's
+     * admitted policy.
      */
     private collectItems;
 }

package/core/stac-static.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stac-static.d.ts","sourceRoot":"","sources":["../../../src/core/stac-static.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAE,+BAA+B,EAAyB,MAAM,YAAY,CAAC;AAEzF,gEAAgE;AAChE,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAeD;;;;;GAKG;AACH,qBAAa,sBAAsB;IACjC,SAAgB,MAAM,EAAE,WAAW,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAEd,MAAM,EAAE,WAAW,EAAE,OAAO,SAAK;IAKpD;;;OAGG;IACU,MAAM,CAAC,MAAM,GAAE,sBAA2B,GAAG,OAAO,CAAC,+BAA+B,CAAC;YAcpF,QAAQ;IAMtB;;;;OAIG;YACW,YAAY;CA6D3B"}
+{"version":3,"file":"stac-static.d.ts","sourceRoot":"","sources":["../../../src/core/stac-static.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAE,+BAA+B,EAAyB,MAAM,YAAY,CAAC;AAEzF,gEAAgE;AAChE,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AA6CD;;;;;GAKG;AACH,qBAAa,sBAAsB;IACjC,SAAgB,MAAM,EAAE,WAAW,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;gBAE7B,MAAM,EAAE,WAAW,EAAE,OAAO,SAAK,EAAE,MAAM,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC;IAM1F;;;OAGG;IACU,MAAM,CAAC,MAAM,GAAE,sBAA2B,GAAG,OAAO,CAAC,+BAA+B,CAAC;YAcpF,QAAQ;IA0BtB;;;;;;OAMG;YACW,YAAY;CAkE3B"}