@honua/react 0.0.20-alpha.0 → 0.1.1-beta.0

package/core/ogc-endpoint-layout.d.ts

@@ -0,0 +1,70 @@
+/**
+ * OGC API endpoint-layout resolution.
+ *
+ * The SDK's headline claim is one typed contract against ANY standards
+ * server. For OGC API Features / Records that means the client must not
+ * assume a fixed path prefix: a Honua Server mounts the facade at
+ * `/ogc/features/...`, but pygeoapi, ldproxy, and GeoServer's OGC API each
+ * serve the landing page at their own root and advertise their collections
+ * and conformance URLs through the landing page's `links` array
+ * (OGC API - Common Requirement 5).
+ *
+ * This module produces an {@link OgcEndpointLayout} — the concrete set of
+ * resource paths a Features client addresses:
+ *
+ *  - {@link honuaFacadeFeaturesLayout} is the fixed facade layout and the
+ *    default. It performs no network round-trips, so existing callers see
+ *    zero behaviour change.
+ *  - {@link resolveOgcEndpointLayout} discovers the layout from the landing
+ *    page (`ogc-api` mode) or auto-detects the facade first and falls back
+ *    to discovery (`auto` mode).
+ *
+ * Per OGC API - Features Requirement 17 the items resource is always at
+ * `{collections}/{collectionId}/items`, so a single landing-page fetch is
+ * enough to derive every per-collection path from the discovered
+ * collections URL.
+ *
+ * @module
+ */
+import type { HonuaProtocolTransport } from "./protocol-transport.js";
+import type { OgcEndpointLayout } from "./types.js";
+/** Discovery mode carried on a source locator. */
+export type OgcApiLayoutMode = "honua-facade" | "ogc-api" | "auto";
+/**
+ * The Honua Server facade layout (`/ogc/features/...`). No network access;
+ * this is the default fast path and preserves the pre-existing behaviour of
+ * every OGC Features caller that points at a Honua Server.
+ */
+export declare function honuaFacadeFeaturesLayout(base?: string): OgcEndpointLayout;
+/**
+ * A raw OGC API layout built from a discovered (or configured) landing +
+ * collections + conformance URL triple. Per-collection paths are templated
+ * off the collections URL per OGC API - Features Requirement 17.
+ */
+export declare function ogcApiFeaturesLayout(options: {
+    landingUrl: string;
+    collectionsUrl: string;
+    conformanceUrl: string;
+}): OgcEndpointLayout;
+/**
+ * Find the first link whose `rel` matches one of `rels` (exact or as the
+ * final path segment of a full OGC relation URI, e.g.
+ * `http://www.opengis.net/def/rel/ogc/1.0/data`).
+ */
+export declare function findOgcLink(links: ReadonlyArray<{
+    href?: string;
+    rel?: string;
+}> | undefined, ...rels: string[]): string | undefined;
+/**
+ * Resolve the endpoint layout for the requested `mode`:
+ *
+ *  - `honua-facade` (default) — the fixed facade layout, no round-trips.
+ *  - `ogc-api` — discover from the landing page at the client baseUrl.
+ *  - `auto` — probe the facade landing; use it when valid, otherwise
+ *    discover from the root.
+ *
+ * Discovery failures surface as {@link HonuaCapabilityNotSupportedError}
+ * (per the SDK convention of throwing rather than returning empty data).
+ */
+export declare function resolveOgcEndpointLayout(transport: HonuaProtocolTransport, mode?: OgcApiLayoutMode): Promise<OgcEndpointLayout>;
+//# sourceMappingURL=ogc-endpoint-layout.d.ts.map

package/core/ogc-endpoint-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ogc-endpoint-layout.d.ts","sourceRoot":"","sources":["../../../src/core/ogc-endpoint-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,KAAK,EAA2B,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE7E,kDAAkD;AAClD,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG,SAAS,GAAG,MAAM,CAAC;AAcnE;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,GAAE,MAA4B,GAAG,iBAAiB,CAY/F;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,iBAAiB,CAiBpB;AAgBD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,aAAa,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,EACjE,GAAG,IAAI,EAAE,MAAM,EAAE,GAChB,MAAM,GAAG,SAAS,CAWpB;AAyCD;;;;;;;;;;GAUG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,sBAAsB,EACjC,IAAI,GAAE,gBAAiC,GACtC,OAAO,CAAC,iBAAiB,CAAC,CAe5B"}

package/core/ogc-endpoint-layout.js

@@ -0,0 +1,173 @@
+/**
+ * OGC API endpoint-layout resolution.
+ *
+ * The SDK's headline claim is one typed contract against ANY standards
+ * server. For OGC API Features / Records that means the client must not
+ * assume a fixed path prefix: a Honua Server mounts the facade at
+ * `/ogc/features/...`, but pygeoapi, ldproxy, and GeoServer's OGC API each
+ * serve the landing page at their own root and advertise their collections
+ * and conformance URLs through the landing page's `links` array
+ * (OGC API - Common Requirement 5).
+ *
+ * This module produces an {@link OgcEndpointLayout} — the concrete set of
+ * resource paths a Features client addresses:
+ *
+ *  - {@link honuaFacadeFeaturesLayout} is the fixed facade layout and the
+ *    default. It performs no network round-trips, so existing callers see
+ *    zero behaviour change.
+ *  - {@link resolveOgcEndpointLayout} discovers the layout from the landing
+ *    page (`ogc-api` mode) or auto-detects the facade first and falls back
+ *    to discovery (`auto` mode).
+ *
+ * Per OGC API - Features Requirement 17 the items resource is always at
+ * `{collections}/{collectionId}/items`, so a single landing-page fetch is
+ * enough to derive every per-collection path from the discovered
+ * collections URL.
+ *
+ * @module
+ */
+import { HonuaCapabilityNotSupportedError } from "./errors.js";
+const DEFAULT_FACADE_BASE = "/ogc/features";
+function enc(id) {
+    return encodeURIComponent(String(id));
+}
+function trimTrailingSlash(url) {
+    let end = url.length;
+    while (end > 0 && url.charCodeAt(end - 1) === 0x2f)
+        end--;
+    return url.slice(0, end);
+}
+/**
+ * The Honua Server facade layout (`/ogc/features/...`). No network access;
+ * this is the default fast path and preserves the pre-existing behaviour of
+ * every OGC Features caller that points at a Honua Server.
+ */
+export function honuaFacadeFeaturesLayout(base = DEFAULT_FACADE_BASE) {
+    const root = trimTrailingSlash(base) || DEFAULT_FACADE_BASE;
+    return {
+        mode: "honua-facade",
+        landing: () => root,
+        conformance: () => `${root}/conformance`,
+        collections: () => `${root}/collections`,
+        collection: (id) => `${root}/collections/${enc(id)}`,
+        queryables: (id) => `${root}/collections/${enc(id)}/queryables`,
+        items: (id) => `${root}/collections/${enc(id)}/items`,
+        item: (id, featureId) => `${root}/collections/${enc(id)}/items/${enc(featureId)}`,
+    };
+}
+/**
+ * A raw OGC API layout built from a discovered (or configured) landing +
+ * collections + conformance URL triple. Per-collection paths are templated
+ * off the collections URL per OGC API - Features Requirement 17.
+ */
+export function ogcApiFeaturesLayout(options) {
+    const landing = trimTrailingSlash(options.landingUrl);
+    const collections = trimTrailingSlash(options.collectionsUrl);
+    const conformance = trimTrailingSlash(options.conformanceUrl);
+    return {
+        mode: "ogc-api",
+        // A bare landing path can be empty (the client baseUrl is the landing
+        // root); the wire layer still appends the `f=` param, producing
+        // `${baseUrl}?f=json`.
+        landing: () => landing,
+        conformance: () => conformance,
+        collections: () => collections,
+        collection: (id) => `${collections}/${enc(id)}`,
+        queryables: (id) => `${collections}/${enc(id)}/queryables`,
+        items: (id) => `${collections}/${enc(id)}/items`,
+        item: (id, featureId) => `${collections}/${enc(id)}/items/${enc(featureId)}`,
+    };
+}
+/**
+ * Resolve a link href to an absolute URL against a base. Absolute hrefs are
+ * returned unchanged; relative hrefs resolve against `${baseUrl}/`.
+ */
+function absolutize(href, baseUrl) {
+    if (/^https?:\/\//i.test(href))
+        return href;
+    const root = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
+    try {
+        return new URL(href, root).toString();
+    }
+    catch {
+        return href;
+    }
+}
+/**
+ * Find the first link whose `rel` matches one of `rels` (exact or as the
+ * final path segment of a full OGC relation URI, e.g.
+ * `http://www.opengis.net/def/rel/ogc/1.0/data`).
+ */
+export function findOgcLink(links, ...rels) {
+    if (!links)
+        return undefined;
+    const wanted = new Set(rels.map((r) => r.toLowerCase()));
+    for (const link of links) {
+        if (typeof link.href !== "string" || link.href.length === 0)
+            continue;
+        const rel = (link.rel ?? "").toLowerCase();
+        if (wanted.has(rel))
+            return link.href;
+        const tail = rel.slice(rel.lastIndexOf("/") + 1);
+        if (tail && wanted.has(tail))
+            return link.href;
+    }
+    return undefined;
+}
+/**
+ * Discover an OGC API layout from the landing page. The client `baseUrl`
+ * IS the landing page root; the collections and conformance URLs are read
+ * from the landing `links` (falling back to the mandated relative
+ * `collections` / `conformance` sub-paths when a server omits them).
+ */
+async function discoverOgcApiLayout(transport) {
+    const landing = await transport.requestCachedMetadataJson("ogc-features:layout:landing", "?f=json", {});
+    const baseUrl = trimTrailingSlash(transport.baseUrl);
+    const links = landing?.links;
+    const dataHref = findOgcLink(links, "data");
+    const conformanceHref = findOgcLink(links, "conformance");
+    const collectionsUrl = dataHref ? absolutize(dataHref, baseUrl) : `${baseUrl}/collections`;
+    const conformanceUrl = conformanceHref ? absolutize(conformanceHref, baseUrl) : `${baseUrl}/conformance`;
+    return ogcApiFeaturesLayout({ landingUrl: baseUrl, collectionsUrl, conformanceUrl });
+}
+/**
+ * Probe whether the Honua facade landing (`/ogc/features`) exists. Used by
+ * `auto` mode: a valid OGC landing document there confirms the facade
+ * fast path; anything else falls through to landing-page discovery.
+ */
+async function facadeLandingLooksValid(transport) {
+    try {
+        const landing = await transport.requestCachedMetadataJson("ogc-features:layout:facade-probe", `${DEFAULT_FACADE_BASE}?f=json`, {});
+        return Array.isArray(landing?.links);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Resolve the endpoint layout for the requested `mode`:
+ *
+ *  - `honua-facade` (default) — the fixed facade layout, no round-trips.
+ *  - `ogc-api` — discover from the landing page at the client baseUrl.
+ *  - `auto` — probe the facade landing; use it when valid, otherwise
+ *    discover from the root.
+ *
+ * Discovery failures surface as {@link HonuaCapabilityNotSupportedError}
+ * (per the SDK convention of throwing rather than returning empty data).
+ */
+export async function resolveOgcEndpointLayout(transport, mode = "honua-facade") {
+    if (mode === "honua-facade")
+        return honuaFacadeFeaturesLayout();
+    if (mode === "auto") {
+        if (await facadeLandingLooksValid(transport))
+            return honuaFacadeFeaturesLayout();
+    }
+    try {
+        return await discoverOgcApiLayout(transport);
+    }
+    catch (err) {
+        if (err instanceof HonuaCapabilityNotSupportedError)
+            throw err;
+        throw new HonuaCapabilityNotSupportedError("query", "ogc-features", `ogc-api layout discovery failed for ${transport.baseUrl}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}

package/core/ogc-features.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ogc-features.d.ts","sourceRoot":"","sources":["../../../src/core/ogc-features.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,KAAK,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,iCAAiC,EACjC,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAGpB,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,sBAAsB,EACjC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,uBAAuB,CAAC,CAOlC;AAED,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,sBAAsB,EACjC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,2BAA2B,CAAC,CAOtC;AAED,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,sBAAsB,EACjC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,2BAA2B,CAAC,CAOtC;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,0BAA0B,CAAC,CAQrC;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,0BAA0B,CAAC,CAQrC;AAED,wBAAsB,YAAY,CAChC,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,iCAAiC,CAAC,CAoC5C;AAED,wBAAsB,UAAU,CAC9B,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,uBAAuB,CAAC,CAclC;AAED,wBAAsB,aAAa,CACjC,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CAYlC;AAED,wBAAsB,cAAc,CAClC,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,uBAAuB,CAAC,CAiBlC;AAED,wBAAsB,YAAY,CAChC,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,uBAAuB,CAAC,CAiBlC;AAED,wBAAsB,aAAa,CAAC,SAAS,EAAE,sBAAsB,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CASnH"}
+{"version":3,"file":"ogc-features.d.ts","sourceRoot":"","sources":["../../../src/core/ogc-features.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,KAAK,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,iCAAiC,EACjC,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EAEpB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAoBpB,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,sBAAsB,EACjC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,uBAAuB,CAAC,CAQlC;AAED,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,sBAAsB,EACjC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,2BAA2B,CAAC,CAQtC;AAED,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,sBAAsB,EACjC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,2BAA2B,CAAC,CAQtC;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,0BAA0B,CAAC,CAQrC;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,0BAA0B,CAAC,CAQrC;AAED,wBAAsB,YAAY,CAChC,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,iCAAiC,CAAC,CAuC5C;AAED,wBAAsB,UAAU,CAC9B,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,uBAAuB,CAAC,CAYlC;AAED,wBAAsB,aAAa,CACjC,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CAYlC;AAED,wBAAsB,cAAc,CAClC,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,uBAAuB,CAAC,CAelC;AAED,wBAAsB,YAAY,CAChC,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,uBAAuB,CAAC,CAelC;AAED,wBAAsB,aAAa,CAAC,SAAS,EAAE,sBAAsB,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAOnH"}

package/core/ogc-features.js

@@ -7,28 +7,47 @@
  *
  * @module
  */
+import { honuaFacadeFeaturesLayout } from "./ogc-endpoint-layout.js";
 import { createOgcMetadataParams, mergeHeaders, normalizeCsv } from "./wire-shared.js";
+/**
+ * The endpoint layout to build paths against. Defaults to the Honua facade
+ * fast path (`/ogc/features/...`); backend-agnostic callers thread a
+ * spec-discovered layout onto `request.layout`.
+ */
+function layoutOf(request) {
+    return request.layout ?? honuaFacadeFeaturesLayout();
+}
+/**
+ * A layout key fragment for cache keys so the facade and a discovered raw
+ * layout never collide in the metadata cache.
+ */
+function layoutKey(layout) {
+    return layout.mode === "honua-facade" ? "facade" : layout.collections();
+}
 export async function getOgcFeaturesLanding(transport, request = {}) {
     const params = createOgcMetadataParams(request);
-    return transport.requestCachedMetadataJson(`ogc-features:landing:${params.toString()}`, `/ogc/features?${params.toString()}`, request);
+    const layout = layoutOf(request);
+    return transport.requestCachedMetadataJson(`ogc-features:landing:${layoutKey(layout)}:${params.toString()}`, `${layout.landing()}?${params.toString()}`, request);
 }
 export async function getOgcFeaturesConformance(transport, request = {}) {
     const params = createOgcMetadataParams(request);
-    return transport.requestCachedMetadataJson(`ogc-features:conformance:${params.toString()}`, `/ogc/features/conformance?${params.toString()}`, request);
+    const layout = layoutOf(request);
+    return transport.requestCachedMetadataJson(`ogc-features:conformance:${layoutKey(layout)}:${params.toString()}`, `${layout.conformance()}?${params.toString()}`, request);
 }
 export async function listOgcCollections(transport, request = {}) {
     const params = createOgcMetadataParams(request);
-    return transport.requestCachedMetadataJson(`ogc-features:collections:${params.toString()}`, `/ogc/features/collections?${params.toString()}`, request);
+    const layout = layoutOf(request);
+    return transport.requestCachedMetadataJson(`ogc-features:collections:${layoutKey(layout)}:${params.toString()}`, `${layout.collections()}?${params.toString()}`, request);
 }
 export async function getOgcCollection(transport, request) {
     const params = createOgcMetadataParams(request);
-    const path = `/ogc/features/collections/${encodeURIComponent(String(request.collectionId))}`;
-    return transport.requestCachedMetadataJson(`ogc-features:collection:${request.collectionId}:${params.toString()}`, `${path}?${params.toString()}`, request);
+    const layout = layoutOf(request);
+    return transport.requestCachedMetadataJson(`ogc-features:collection:${layoutKey(layout)}:${request.collectionId}:${params.toString()}`, `${layout.collection(request.collectionId)}?${params.toString()}`, request);
 }
 export async function getOgcQueryables(transport, request) {
     const params = createOgcMetadataParams(request);
-    const path = `/ogc/features/collections/${encodeURIComponent(String(request.collectionId))}/queryables`;
-    return transport.requestCachedMetadataJson(`ogc-features:queryables:${request.collectionId}:${params.toString()}`, `${path}?${params.toString()}`, request);
+    const layout = layoutOf(request);
+    return transport.requestCachedMetadataJson(`ogc-features:queryables:${layoutKey(layout)}:${request.collectionId}:${params.toString()}`, `${layout.queryables(request.collectionId)}?${params.toString()}`, request);
 }
 export async function listOgcItems(transport, request) {
     const params = createOgcMetadataParams(request);
@@ -47,6 +66,9 @@ export async function listOgcItems(transport, request) {
     if (request.filter !== undefined) {
         params.set("filter", request.filter);
     }
+    if (request.filterLang !== undefined) {
+        params.set("filter-lang", request.filterLang);
+    }
     if (request.ids !== undefined) {
         params.set("ids", normalizeCsv(request.ids));
     }
@@ -59,7 +81,7 @@ export async function listOgcItems(transport, request) {
     if (request.crs !== undefined) {
         params.set("crs", request.crs);
     }
-    const path = `/ogc/features/collections/${encodeURIComponent(String(request.collectionId))}/items`;
+    const path = layoutOf(request).items(request.collectionId);
     return transport.requestJson("GET", `${path}?${params.toString()}`, undefined, request.signal);
 }
 export async function getOgcItem(transport, request) {
@@ -67,13 +89,12 @@ export async function getOgcItem(transport, request) {
     if (request.crs !== undefined) {
         params.set("crs", request.crs);
     }
-    const path = `/ogc/features/collections/${encodeURIComponent(String(request.collectionId))}` +
-        `/items/${encodeURIComponent(String(request.featureId))}`;
+    const path = layoutOf(request).item(request.collectionId, request.featureId);
     return transport.requestJson("GET", `${path}?${params.toString()}`, undefined, request.signal);
 }
 export async function createOgcItem(transport, request) {
     const params = createOgcMetadataParams(request);
-    const path = `/ogc/features/collections/${encodeURIComponent(String(request.collectionId))}/items`;
+    const path = layoutOf(request).items(request.collectionId);
     return transport.requestJson("POST", `${path}?${params.toString()}`, {
         headers: mergeHeaders({ "Content-Type": "application/geo+json" }, request.headers),
         body: JSON.stringify(request.feature),
@@ -84,8 +105,7 @@ export async function replaceOgcItem(transport, request) {
     if (request.crs !== undefined) {
         params.set("crs", request.crs);
     }
-    const path = `/ogc/features/collections/${encodeURIComponent(String(request.collectionId))}` +
-        `/items/${encodeURIComponent(String(request.featureId))}`;
+    const path = layoutOf(request).item(request.collectionId, request.featureId);
     return transport.requestJson("PUT", `${path}?${params.toString()}`, {
         headers: mergeHeaders({ "Content-Type": "application/geo+json" }, request.headers),
         body: JSON.stringify(request.feature),
@@ -96,8 +116,7 @@ export async function patchOgcItem(transport, request) {
     if (request.crs !== undefined) {
         params.set("crs", request.crs);
     }
-    const path = `/ogc/features/collections/${encodeURIComponent(String(request.collectionId))}` +
-        `/items/${encodeURIComponent(String(request.featureId))}`;
+    const path = layoutOf(request).item(request.collectionId, request.featureId);
     return transport.requestJson("PATCH", `${path}?${params.toString()}`, {
         headers: mergeHeaders({ "Content-Type": "application/merge-patch+json" }, request.headers),
         body: JSON.stringify(request.patch),
@@ -108,7 +127,6 @@ export async function deleteOgcItem(transport, request) {
     if (request.crs !== undefined) {
         params.set("crs", request.crs);
     }
-    const path = `/ogc/features/collections/${encodeURIComponent(String(request.collectionId))}` +
-        `/items/${encodeURIComponent(String(request.featureId))}`;
+    const path = layoutOf(request).item(request.collectionId, request.featureId);
     await transport.requestJson("DELETE", `${path}?${params.toString()}`, undefined, request.signal);
 }

package/core/ogc-maps.d.ts

@@ -12,11 +12,15 @@ import type { HonuaProtocolTransport } from "./protocol-transport.js";
 import type { HonuaOgcConformanceResponse, HonuaOgcLandingResponse, HonuaOgcMapImageResponse, OgcMapImageRequest, OgcMetadataRequest } from "./types.js";
 export interface HonuaOgcMapsOptions {
     client: HonuaClient;
+    /** Raw endpoint path prefix (defaults to the Honua facade `/ogc/maps`). */
+    basePath?: string;
 }
 export interface HonuaOgcCollectionMapOptions {
     client: HonuaClient;
     collectionId: string | number;
     styleId?: string;
+    /** Raw endpoint path prefix (defaults to the Honua facade `/ogc/maps`). */
+    basePath?: string;
 }
 export type HonuaOgcCollectionMapImageRequest = Omit<OgcMapImageRequest, "collectionId" | "styleId"> & {
     styleId?: string;
@@ -24,7 +28,9 @@ export type HonuaOgcCollectionMapImageRequest = Omit<OgcMapImageRequest, "collec
 /** Top-level OGC API Maps handle. */
 export declare class HonuaOgcMaps {
     readonly client: HonuaClient;
+    private readonly basePath;
     constructor(options: HonuaOgcMapsOptions);
+    private withBase;
     collection(collectionId: string | number, styleId?: string): HonuaOgcCollectionMap;
     landing(request?: OgcMetadataRequest): Promise<HonuaOgcLandingResponse>;
     conformance(request?: OgcMetadataRequest): Promise<HonuaOgcConformanceResponse>;
@@ -39,6 +45,7 @@ export declare class HonuaOgcCollectionMap {
     readonly client: HonuaClient;
     readonly collectionId: string | number;
     readonly styleId: string | undefined;
+    private readonly basePath;
     constructor(options: HonuaOgcCollectionMapOptions);
     map(request?: HonuaOgcCollectionMapImageRequest): Promise<HonuaOgcMapImageResponse>;
 }

package/core/ogc-maps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ogc-maps.d.ts","sourceRoot":"","sources":["../../../src/core/ogc-maps.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,KAAK,EACV,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,iCAAiC,GAAG,IAAI,CAAC,kBAAkB,EAAE,cAAc,GAAG,SAAS,CAAC,GAAG;IACrG,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,qCAAqC;AACrC,qBAAa,YAAY;IACvB,SAAgB,MAAM,EAAE,WAAW,CAAC;gBAEjB,OAAO,EAAE,mBAAmB;IAIxC,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,qBAAqB;IAI5E,OAAO,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAI3E,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAIhG,mEAAmE;IACtD,GAAG,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC;CAGtF;AAED;;;GAGG;AACH,qBAAa,qBAAqB;IAChC,SAAgB,MAAM,EAAE,WAAW,CAAC;IACpC,SAAgB,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9C,SAAgB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEzB,OAAO,EAAE,4BAA4B;IAM3C,GAAG,CAAC,OAAO,GAAE,iCAAsC,GAAG,OAAO,CAAC,wBAAwB,CAAC;CAOrG;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,CAEpE;AAID,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,sBAAsB,EACjC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,uBAAuB,CAAC,CAOlC;AAED,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,sBAAsB,EACjC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,2BAA2B,CAAC,CAOtC;AAED,wBAAsB,cAAc,CAClC,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,wBAAwB,CAAC,CASnC"}
+{"version":3,"file":"ogc-maps.d.ts","sourceRoot":"","sources":["../../../src/core/ogc-maps.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,KAAK,EACV,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AA4BpB,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,WAAW,CAAC;IACpB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,iCAAiC,GAAG,IAAI,CAAC,kBAAkB,EAAE,cAAc,GAAG,SAAS,CAAC,GAAG;IACrG,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,qCAAqC;AACrC,qBAAa,YAAY;IACvB,SAAgB,MAAM,EAAE,WAAW,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;gBAE3B,OAAO,EAAE,mBAAmB;IAK/C,OAAO,CAAC,QAAQ;IAIT,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,qBAAqB;IAS5E,OAAO,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAI3E,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAIhG,mEAAmE;IACtD,GAAG,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC;CAGtF;AAED;;;GAGG;AACH,qBAAa,qBAAqB;IAChC,SAAgB,MAAM,EAAE,WAAW,CAAC;IACpC,SAAgB,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9C,SAAgB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;gBAE3B,OAAO,EAAE,4BAA4B;IAO3C,GAAG,CAAC,OAAO,GAAE,iCAAsC,GAAG,OAAO,CAAC,wBAAwB,CAAC;CAQrG;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,CAEpE;AAID,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,sBAAsB,EACjC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,uBAAuB,CAAC,CAQlC;AAED,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,sBAAsB,EACjC,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,2BAA2B,CAAC,CAQtC;AAED,wBAAsB,cAAc,CAClC,SAAS,EAAE,sBAAsB,EACjC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,wBAAwB,CAAC,CASnC"}

package/core/ogc-maps.js

@@ -8,24 +8,58 @@
  * @module
  */
 import { createOgcMetadataParams } from "./wire-shared.js";
+/** Honua facade path prefix for OGC API Maps. */
+const MAPS_FACADE_BASE = "/ogc/maps";
+/**
+ * Resolve the OGC API Maps 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 mapsBase(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 MAPS_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 mapsBaseKey(request) {
+    const base = mapsBase(request);
+    return base === MAPS_FACADE_BASE ? "" : `${base}:`;
+}
 /** Top-level OGC API Maps handle. */
 export class HonuaOgcMaps {
     client;
+    basePath;
     constructor(options) {
         this.client = options.client;
+        this.basePath = options.basePath;
+    }
+    withBase(request) {
+        return this.basePath !== undefined ? { ...request, basePath: this.basePath } : request;
     }
     collection(collectionId, styleId) {
-        return new HonuaOgcCollectionMap({ client: this.client, collectionId, styleId });
+        return new HonuaOgcCollectionMap({
+            client: this.client,
+            collectionId,
+            styleId,
+            ...(this.basePath !== undefined ? { basePath: this.basePath } : {}),
+        });
     }
     async landing(request = {}) {
-        return this.client.getOgcMapsLanding(request);
+        return this.client.getOgcMapsLanding(this.withBase(request));
     }
     async conformance(request = {}) {
-        return this.client.getOgcMapsConformance(request);
+        return this.client.getOgcMapsConformance(this.withBase(request));
     }
     /** Render a dataset-level map (across one or more collections). */
     async map(request = {}) {
-        return this.client.getOgcMapImage(request);
+        return this.client.getOgcMapImage(this.withBase(request));
     }
 }
 /**
@@ -36,16 +70,19 @@ export class HonuaOgcCollectionMap {
     client;
     collectionId;
     styleId;
+    basePath;
     constructor(options) {
         this.client = options.client;
         this.collectionId = options.collectionId;
         this.styleId = options.styleId;
+        this.basePath = options.basePath;
     }
     async map(request = {}) {
         return this.client.getOgcMapImage({
             ...request,
             collectionId: this.collectionId,
             styleId: request.styleId ?? this.styleId,
+            ...(this.basePath !== undefined ? { basePath: this.basePath } : {}),
         });
     }
 }
@@ -55,17 +92,19 @@ export function createHonuaOgcMaps(client) {
 // ── OGC API Maps wire methods ───────────────────────────────────
 export async function getOgcMapsLanding(transport, request = {}) {
     const params = createOgcMetadataParams(request);
-    return transport.requestCachedMetadataJson(`ogc-maps:landing:${params.toString()}`, `/ogc/maps?${params.toString()}`, request);
+    const base = mapsBase(request);
+    return transport.requestCachedMetadataJson(`ogc-maps:landing:${mapsBaseKey(request)}${params.toString()}`, `${base}?${params.toString()}`, request);
 }
 export async function getOgcMapsConformance(transport, request = {}) {
     const params = createOgcMetadataParams(request);
-    return transport.requestCachedMetadataJson(`ogc-maps:conformance:${params.toString()}`, `/ogc/maps/conformance?${params.toString()}`, request);
+    const base = mapsBase(request);
+    return transport.requestCachedMetadataJson(`ogc-maps:conformance:${mapsBaseKey(request)}${params.toString()}`, `${base}/conformance?${params.toString()}`, request);
 }
 export async function getOgcMapImage(transport, request) {
     const params = serializeOgcMapImageParams(request);
     const collectionPart = request.collectionId !== undefined ? `/collections/${encodeURIComponent(String(request.collectionId))}` : "";
     const stylePart = request.styleId ? `/styles/${encodeURIComponent(request.styleId)}` : "";
-    const path = `/ogc/maps${collectionPart}${stylePart}/map${params.size > 0 ? `?${params.toString()}` : ""}`;
+    const path = `${mapsBase(request)}${collectionPart}${stylePart}/map${params.size > 0 ? `?${params.toString()}` : ""}`;
     const accept = ogcMapAcceptHeader(request.format) ?? "image/png";
     const response = await transport.requestBytes("GET", path, accept, undefined, request.signal);
     return { bytes: response.bytes, contentType: response.contentType };

package/core/ogc-processes.d.ts

@@ -8,6 +8,7 @@
  */
 import type { IJobRun, JobProgress, JobResult, JobResultsOptions, JobSnapshot, JobSnapshotListener, JobStatus } from "../contract/jobs.js";
 import type { HonuaClient } from "./client.js";
+import { HonuaSdkError } from "./error-envelope.js";
 import type { HonuaProtocolTransport } from "./protocol-transport.js";
 import type { HonuaOgcConformanceResponse, HonuaOgcLandingResponse, HonuaOgcProcessDescription, HonuaOgcProcessJobAccepted, HonuaOgcProcessJobResults, HonuaOgcProcessJobStatus, HonuaOgcProcessesResponse, OgcMetadataRequest, OgcProcessExecuteRequest, OgcProcessStatus } from "./types.js";
 export interface HonuaOgcProcessesOptions {
@@ -81,7 +82,7 @@ export declare class HonuaOgcProcessJobRun<T = unknown> implements IJobRun<T> {
     private notify;
 }
 /** Error thrown when `IJobRun.results()` resolves a non-success terminal. */
-export declare class HonuaJobFailedError extends Error {
+export declare class HonuaJobFailedError extends HonuaSdkError {
     readonly status: JobStatus;
     readonly errorCode: string | undefined;
     readonly details: unknown;

package/core/ogc-processes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ogc-processes.d.ts","sourceRoot":"","sources":["../../../src/core/ogc-processes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ogc-processes.d.ts","sourceRoot":"","sources":["../../../src/core/ogc-processes.ts"],"names":[],"mappings":"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"}

package/core/ogc-processes.js

@@ -7,8 +7,33 @@
  * @module
  */
 import { HonuaJobPollTimeoutError, isJobTerminal } from "../contract/jobs.js";
+import { HonuaSdkError } from "./error-envelope.js";
 import { createOgcMetadataParams, mergeHeaders } from "./wire-shared.js";
 const DEFAULT_POLL_INTERVAL_MS = 1_000;
+/** Honua facade path prefix for OGC API Processes. */
+const PROCESSES_FACADE_BASE = "/ogc/processes";
+/**
+ * Resolve the OGC API Processes path prefix: the caller-supplied raw `basePath`
+ * (a `discoverOgcProcesses()`-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.
+ */
+function processesBase(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 PROCESSES_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 processesBaseKey(request) {
+    const base = processesBase(request);
+    return base === PROCESSES_FACADE_BASE ? "" : `${base}:`;
+}
 /** Top-level OGC API Processes handle. */
 export class HonuaOgcProcesses {
     client;
@@ -271,12 +296,12 @@ export class HonuaOgcProcessJobRun {
     }
 }
 /** Error thrown when `IJobRun.results()` resolves a non-success terminal. */
-export class HonuaJobFailedError extends Error {
+export class HonuaJobFailedError extends HonuaSdkError {
     status;
     errorCode;
     details;
     constructor(message, status, errorCode, details) {
-        super(message);
+        super("core.job-failed", message, { context: { status, errorCode } });
         this.name = "HonuaJobFailedError";
         this.status = status;
         this.errorCode = errorCode;
@@ -371,15 +396,18 @@ export function createHonuaOgcProcesses(client) {
 // ── OGC API Processes wire methods ──────────────────────────────
 export async function getOgcProcessesLanding(transport, request = {}) {
     const params = createOgcMetadataParams(request);
-    return transport.requestCachedMetadataJson(`ogc-processes:landing:${params.toString()}`, `/ogc/processes?${params.toString()}`, request);
+    const base = processesBase(request);
+    return transport.requestCachedMetadataJson(`ogc-processes:landing:${processesBaseKey(request)}${params.toString()}`, `${base}?${params.toString()}`, request);
 }
 export async function getOgcProcessesConformance(transport, request = {}) {
     const params = createOgcMetadataParams(request);
-    return transport.requestCachedMetadataJson(`ogc-processes:conformance:${params.toString()}`, `/ogc/processes/conformance?${params.toString()}`, request);
+    const base = processesBase(request);
+    return transport.requestCachedMetadataJson(`ogc-processes:conformance:${processesBaseKey(request)}${params.toString()}`, `${base}/conformance?${params.toString()}`, request);
 }
 export async function listOgcProcesses(transport, request = {}) {
     const params = createOgcMetadataParams(request);
-    return transport.requestCachedMetadataJson(`ogc-processes:processes:${params.toString()}`, `/ogc/processes/processes?${params.toString()}`, request);
+    const base = processesBase(request);
+    return transport.requestCachedMetadataJson(`ogc-processes:processes:${processesBaseKey(request)}${params.toString()}`, `${base}/processes?${params.toString()}`, request);
 }
 export async function getOgcProcess(transport, request) {
     const params = createOgcMetadataParams(request);