Interface HonuaStacSearchAllRequest

Subset of the STAC core API search request shape.

interface HonuaStacSearchAllRequest {
    bbox?: readonly [number, number, number, number];
    collections?: readonly string[];
    datetime?: string;
    fields?: {
        exclude?: readonly string[];
        include?: readonly string[];
    };
    filter?: string;
    filterLang?: "cql2-text" | "cql2-json";
    ids?: readonly string[];
    intersects?: Record<string, unknown>;
    limit?: number;
    maxPages?: number;
    next?: string;
    offset?: number;
    pageSize?: number;
    signal?: AbortSignal;
    sortby?: string;
    stacBasePath?: string;
    usePost?: boolean;
}

Hierarchy (view full)

Properties

bbox?: readonly [number, number, number, number]
collections?: readonly string[]
datetime?: string
fields?: {
    exclude?: readonly string[];
    include?: readonly string[];
}

Subset of asset / item properties to return.

filter?: string
filterLang?: "cql2-text" | "cql2-json"
ids?: readonly string[]
intersects?: Record<string, unknown>
limit?: number
maxPages?: number

Hard cap on the number of pages to fetch (defaults to 100).

next?: string

Server-driven page token. Optional support for STAC servers that advertise an opaque ?next=… token instead of offset.

offset?: number

Numeric page offset. honua-server's /stac/search uses offset as the canonical paging token (its rel=next link href carries ?offset=N). Prefer this over next for honua-server compatibility.

pageSize?: number

Maximum number of items to materialize across pages.

signal?: AbortSignal
sortby?: string
stacBasePath?: string

Path prefix the STAC endpoints are mounted under. Defaults to /stac (the Honua Server facade). Backend-agnostic callers pointing at a raw STAC API root (e.g. Earth Search at .../v1) pass "" so the search and collection paths resolve directly under the client baseUrl.

usePost?: boolean

When true, the adapter posts the body to /search.