@honua/sdk-esri-compat 0.0.6-alpha.0

package/contract/types.d.ts

@@ -0,0 +1,542 @@
+/**
+ * Shared client contract — canonical nouns that all protocol adapters
+ * (`HonuaFeatureLayer`, `HonuaMapService`, `HonuaOgcFeatureCollection`, plus
+ * future WFS / WMS / OData adapters) must speak. The contract is documented
+ * in `docs/shared-client-contract.md`; capability coverage by protocol is
+ * documented in `docs/protocol-capability-matrix.md`.
+ *
+ * The runtime classes in `src/core/surfaces.ts` are not replaced — they
+ * remain the implementation. The contract here wraps their request /
+ * response shapes (`QueryFeaturesRequest`, `OgcItemsRequest`,
+ * `HonuaTypedQueryResponse`, `HonuaOgcFeatureCollectionResponse`) so that
+ * cross-protocol code can speak one vocabulary without re-litigating the
+ * surface in every downstream ticket.
+ *
+ * @module
+ */
+import type { HonuaClient } from "../core/client.js";
+import type { SpatialFilter } from "../core/spatial-filter.js";
+import type { HonuaExtent, HonuaFieldInfo, HonuaServerCompatibilityFeature, HonuaTypedFeature } from "../core/types.js";
+/**
+ * Canonical protocol identifiers. Spatial / tabular protocols served
+ * behind a `Source` come first, then the render-only OGC tile and map
+ * adapters (reachable through `Source.protocol()`), then the STAC API
+ * search adapter, the WFS / WMS / OData adapters, and finally the
+ * MapLibre-native sources composed alongside protocol sources by
+ * `HonuaMap` and `MapBinding`.
+ *
+ * The five GeoServices identifiers correspond to the five Esri service
+ * types Honua Server publishes: FeatureServer, MapServer, ImageServer,
+ * Geometry Service, and GP Service. Geometry and GP services do not host
+ * features, so their `Source` instances expose only the typed `protocol()`
+ * escape hatch — every cross-protocol request shape goes through one
+ * vocabulary even when the underlying protocol is utility-only.
+ */
+export type Protocol = "geoservices-feature-service" | "geoservices-map-service" | "geoservices-image-service" | "geoservices-geometry-service" | "geoservices-gp-service" | "ogc-features" | "ogc-tiles" | "ogc-maps" | "stac" | "wfs" | "wms" | "wmts" | "odata" | "maplibre-vector" | "maplibre-raster" | "maplibre-geojson";
+/** All protocol identifiers, in declaration order. */
+export declare const PROTOCOLS: readonly Protocol[];
+/**
+ * Coarse-grained protocol capabilities negotiated across the canonical
+ * `Source` methods and the typed `Source.adapter()` escape hatch. This
+ * ticket intentionally standardizes only the query-family subset on
+ * `Source`; capabilities such as `render`, `tiles`, `sql`, and
+ * `queryObjectIds` stay in the shared registry so downstream adapter
+ * tickets can reuse one vocabulary without widening the top-level API.
+ *
+ * Keep this list aligned with `docs/protocol-capability-matrix.md`.
+ */
+export type Capability = "query" | "queryAggregate" | "spatialAggregate" | "queryExtent" | "queryObjectIds" | "queryRelated" | "applyEdits" | "attachments" | "render" | "tiles" | "sql" | "stream" | "pbf" | "connect" | "image" | "geometry" | "geoprocess" | "processes";
+/** All capability identifiers, in declaration order. */
+export declare const CAPABILITIES: readonly Capability[];
+/**
+ * Per-source capability registry. Set membership = first-party support
+ * (the adapter can fulfill the capability without client-side fallback).
+ * Capabilities that require a client-side fallback should be omitted from
+ * the set; callers either swap to a different protocol or opt into a
+ * `degraded: true` policy at the `ExplorationContext` level.
+ */
+export type Capabilities = ReadonlySet<Capability>;
+/**
+ * Build a `Capabilities` set from a readonly array. Provided as a tiny
+ * helper so callers do not need to import `Set` literals at every adapter
+ * site.
+ */
+export declare function capabilities(values: readonly Capability[]): Capabilities;
+/**
+ * Compute the **weakest** (intersected) capability set across one or
+ * more participating sources / descriptors. This is the canonical helper
+ * for cross-protocol capability negotiation in a mixed-source
+ * composition (`#22`): a composition supports a capability only when
+ * **every** participating source supports it.
+ *
+ * Promising a capability the weakest source lacks is the worst possible
+ * mixed-source failure mode (silent wrong result), so consumers should
+ * always intersect before fanning a query out to a heterogeneous set.
+ *
+ * Accepts anything with a `capabilities` field (live `Source` instances
+ * or plain `SourceDescriptor`s). Empty input returns an empty set.
+ *
+ * For per-operation reasoning across a heterogeneous mix, partition
+ * sources first (e.g., feature sources only) and intersect on the
+ * partition; intersecting a render-only source with a feature source
+ * yields the empty set, which is honest but rarely actionable on its
+ * own.
+ */
+export declare function intersectCapabilities(participants: ReadonlyArray<{
+    readonly capabilities: Capabilities;
+}>): Capabilities;
+/**
+ * Companion of {@link intersectCapabilities}: the union (best-case)
+ * capability set across participants. Useful for documenting what
+ * capability fan-out under `degraded` policy could reach if every
+ * source were queried independently — never use this to gate a single
+ * fan-out call (that needs the intersection).
+ */
+export declare function unionCapabilities(participants: ReadonlyArray<{
+    readonly capabilities: Capabilities;
+}>): Capabilities;
+/**
+ * Default capability sets keyed by protocol. Callers that need a narrower
+ * surface for a specific source must intersect the default set themselves
+ * and pass the result on `SourceDescriptor.capabilities`; the built-in
+ * adapter constructors do not read service metadata today.
+ *
+ * The matrix here mirrors the one in `docs/protocol-capability-matrix.md`.
+ * Update both together.
+ */
+export declare const PROTOCOL_DEFAULT_CAPABILITIES: Readonly<Record<Protocol, Capabilities>>;
+export type SourceId = string;
+export type DatasetId = string;
+export type FeatureId = number | string;
+/**
+ * Protocol-specific endpoint information. Field-compatible with the server
+ * `SourceBinding.locator` shape documented in
+ * `docs/source-binding-alignment.md` (a Honua SDK `SourceDescriptor` may be
+ * exported into a server `SourceBinding` without re-shaping the locator).
+ */
+export interface SourceLocator {
+    /** Fully qualified URL to the protocol endpoint. */
+    url: string;
+    /** GeoServices service identifier (FeatureServer / MapServer / ImageServer / Geometry / GP). */
+    serviceId?: string;
+    /** GeoServices layer identifier within the service. */
+    layerId?: number;
+    /** OGC API Features / Tiles / Maps collection identifier. */
+    collectionId?: string | number;
+    /** OGC API Tiles tile-matrix-set identifier (e.g. `WebMercatorQuad`). */
+    tileMatrixSetId?: string;
+    /** OGC API Maps / Tiles style identifier for styled-output endpoints. */
+    styleId?: string;
+    /** WFS / WMS type-name identifier. */
+    typeName?: string;
+    /**
+     * WFS feature namespace URI bound to the prefix in `typeName`. Required for
+     * WFS-T `applyEdits` when `typeName` carries a namespace prefix
+     * (e.g. `parcels:lot`) — the prefix is declared on the
+     * `<wfs:Transaction>` root with this URI so the per-handle feature
+     * element resolves to the schema element the server expects. The
+     * namespace URI typically appears on the `<wfs:WFS_Capabilities>` root
+     * (`xmlns:<prefix>=…`); record it on the descriptor so applyEdits does
+     * not have to fetch capabilities synchronously.
+     */
+    featureNamespace?: string;
+    /** OData entity-set identifier. */
+    entitySet?: string;
+    /** GP Service task identifier (for `geoservices-gp-service`). */
+    taskName?: string;
+}
+/** Optional schema description; mirrors `HonuaLayerMetadata.fields`. */
+export interface SourceSchema {
+    fields?: readonly HonuaFieldInfo[];
+    primaryKey?: string;
+    /** Hint that the source's records carry temporal validity. */
+    timeField?: string;
+}
+/**
+ * Canonical descriptor for one protocol-backed data source. Carries
+ * everything required to construct a `Source`, negotiate capabilities, and
+ * project the source onto a server `SourceBinding`.
+ */
+export interface SourceDescriptor {
+    id: SourceId;
+    protocol: Protocol;
+    locator: SourceLocator;
+    capabilities: Capabilities;
+    schema?: SourceSchema;
+    attribution?: string;
+}
+export interface PaginationSpec {
+    /** Zero-based offset of the first record. */
+    offset?: number;
+    /** Maximum records per page. Implementation may clamp. */
+    limit?: number;
+}
+export interface SortSpec {
+    field: string;
+    direction?: "asc" | "desc";
+}
+export type AggregationFn = "count" | "sum" | "avg" | "min" | "max" | "stddev" | "var";
+export interface AggregationSpec {
+    /** Optional grouping fields. Empty / omitted = single-row aggregate. */
+    groupBy?: readonly string[];
+    /** Aggregation expressions. */
+    metrics: readonly AggregationMetric[];
+}
+export interface AggregationMetric {
+    fn: AggregationFn;
+    field: string;
+    alias?: string;
+}
+/**
+ * Protocol-neutral query intent. `Source.query()` adapters translate this
+ * into a `QueryFeaturesRequest`, `MapLayerQueryRequest`, `OgcItemsRequest`,
+ * or the corresponding WFS / OData request.
+ */
+export interface Query<_T = Record<string, unknown>> {
+    /** Logical filter expression. SQL-92 WHERE for GeoServices, CQL2 for OGC. */
+    where?: string;
+    /** Spatial constraint. Reuses `core/spatial-filter.ts`. */
+    spatialFilter?: SpatialFilter;
+    /** Subset of fields to return. Adapters default to all when omitted. */
+    outFields?: readonly string[];
+    /** Sort order. */
+    orderBy?: readonly SortSpec[];
+    /** Pagination. */
+    pagination?: PaginationSpec;
+    /** Aggregation request; if present the `Result` contains aggregate rows. */
+    aggregation?: AggregationSpec;
+    /** Whether the result envelope should include geometry. */
+    returnGeometry?: boolean;
+    /** Output spatial reference (WKID, "auto", or full reference object). */
+    outSr?: string | number;
+    /** Caller-supplied cancellation. */
+    signal?: AbortSignal;
+}
+/**
+ * Reasons that a `Source` may have fulfilled a `Query` with a degraded
+ * strategy. Surfaced in `Result.degraded`. Downstream views should check
+ * this field before reporting numbers as authoritative.
+ *
+ * `sourceId` is populated by mixed-source consumers (`#22`) so a fan-out
+ * across multiple sources can attribute each degradation back to the
+ * exact source that triggered it without parsing the human-readable
+ * `reason`.
+ */
+export interface DegradedReason {
+    /** The capability that was missing or partially supported. */
+    capability: Capability;
+    /** Human-readable explanation. */
+    reason: string;
+    /** Which protocol the degradation was relative to. */
+    protocol?: Protocol;
+    /**
+     * Optional id of the source that emitted this degradation. Set by the
+     * adapter when the degradation can be attributed to a specific source
+     * (the common case once mixed-source compositions are in play).
+     */
+    sourceId?: SourceId;
+}
+/**
+ * Unified query result envelope. Wraps (does not replace)
+ * `HonuaTypedQueryResponse<T>` and `HonuaOgcFeatureCollectionResponse`;
+ * adapters fill the optional fields that their underlying response carries
+ * and leave the rest undefined.
+ */
+export interface Result<T = Record<string, unknown>> {
+    /** Returned features. Empty array (not undefined) when nothing matched. */
+    features: readonly HonuaTypedFeature<T>[];
+    /** True if the server signalled that more records exist than were returned. */
+    exceededTransferLimit: boolean;
+    /** Total count when known (counts request, OGC `numberMatched`). */
+    totalCount?: number;
+    /** Aggregated rows when the query carried an `aggregation` spec. */
+    aggregateRows?: ReadonlyArray<Record<string, unknown>>;
+    /** Spatial extent of the returned features (extent-only query response). */
+    extent?: HonuaExtent;
+    /** Field schema as returned by the protocol, when the response carried one. */
+    fields?: readonly HonuaFieldInfo[];
+    /** Degradation flags emitted by the source while serving this query. */
+    degraded?: readonly DegradedReason[];
+}
+/**
+ * Canonical feature shape used by edit envelopes. Mirrors the canonical
+ * `HonuaTypedFeature<T>` (attributes + optional geometry) so the same value
+ * an adapter returns from `query()` may be fed back into `applyEdits()`.
+ */
+export interface CanonicalFeature<T = Record<string, unknown>> {
+    /** Optional row identity. Required for updates and deletes. */
+    id?: FeatureId;
+    attributes: T;
+    geometry?: Record<string, unknown> | null;
+}
+/**
+ * Single-source edit envelope. Adapters that do not advertise `applyEdits`
+ * throw `HonuaCapabilityNotSupportedError` rather than dropping records.
+ */
+export interface EditEnvelope<T = Record<string, unknown>> {
+    adds?: ReadonlyArray<CanonicalFeature<T>>;
+    updates?: ReadonlyArray<CanonicalFeature<T>>;
+    deletes?: ReadonlyArray<FeatureId>;
+    /** When true (and the protocol honors it) the edit batch is atomic. */
+    rollbackOnFailure?: boolean;
+    /** Caller-supplied cancellation. */
+    signal?: AbortSignal;
+}
+/** Per-feature edit outcome. */
+export interface EditOutcome {
+    id?: FeatureId;
+    success: boolean;
+    error?: {
+        code: number;
+        description: string;
+    };
+}
+/** Canonical edit response. Buckets mirror `EditEnvelope`. */
+export interface EditResult {
+    added: ReadonlyArray<EditOutcome>;
+    updated: ReadonlyArray<EditOutcome>;
+    deleted: ReadonlyArray<EditOutcome>;
+    /** Degradation flags for partial-success or fallback paths. */
+    degraded?: readonly DegradedReason[];
+}
+/**
+ * Canonical related-records request. The `relationshipId` is protocol-specific
+ * (GeoServices uses numeric ids; OData uses navigation property names) so
+ * adapters that lack relationships throw `HonuaCapabilityNotSupportedError`
+ * rather than silently dropping the request.
+ */
+export interface RelatedQuery {
+    relationshipId: number;
+    /** Source feature ids whose related records to return. */
+    sourceIds: ReadonlyArray<FeatureId>;
+    where?: string;
+    outFields?: readonly string[];
+    returnGeometry?: boolean;
+    signal?: AbortSignal;
+}
+/** One source feature plus its related records. */
+export interface RelatedGroup<T = Record<string, unknown>> {
+    sourceId: FeatureId;
+    features: ReadonlyArray<HonuaTypedFeature<T>>;
+}
+/** Canonical related-records response. */
+export interface RelatedResult<T = Record<string, unknown>> {
+    groups: ReadonlyArray<RelatedGroup<T>>;
+    fields?: readonly HonuaFieldInfo[];
+    degraded?: readonly DegradedReason[];
+}
+/** Metadata for a single attachment on a feature. */
+export interface AttachmentInfo {
+    id: FeatureId;
+    parentId: FeatureId;
+    name?: string;
+    contentType?: string;
+    size?: number;
+}
+/** Canonical attachment-query envelope. */
+export interface AttachmentQuery {
+    /** Optional caller-supplied parent ids. Empty = all matching `where`. */
+    parentIds?: ReadonlyArray<FeatureId>;
+    where?: string;
+    signal?: AbortSignal;
+}
+/** Group of attachments for a single parent feature. */
+export interface AttachmentGroup {
+    parentId: FeatureId;
+    attachments: ReadonlyArray<AttachmentInfo>;
+}
+/** Add-attachment request. `attachment` accepts `Blob`, `File`, or string. */
+export interface AttachmentAdd {
+    parentId: FeatureId;
+    attachment: Blob | File | string;
+    name?: string;
+    contentType?: string;
+    signal?: AbortSignal;
+}
+/** Update an existing attachment in place. */
+export interface AttachmentUpdate extends AttachmentAdd {
+    attachmentId: FeatureId;
+}
+/** Delete one or more attachments from a parent feature. */
+export interface AttachmentDelete {
+    parentId: FeatureId;
+    attachmentIds: ReadonlyArray<FeatureId>;
+    signal?: AbortSignal;
+}
+/** Outcome envelope for add / update / delete operations. */
+export interface AttachmentEditOutcome {
+    parentId?: FeatureId;
+    attachmentId?: FeatureId;
+    success: boolean;
+    error?: {
+        code: number;
+        description: string;
+    };
+}
+/**
+ * Namespace returned by `Source.attachments`. Adapters that do not advertise
+ * the `attachments` capability throw `HonuaCapabilityNotSupportedError`
+ * from each method rather than ship a `null`-ish placeholder.
+ */
+export interface AttachmentApi {
+    query(request?: AttachmentQuery): Promise<ReadonlyArray<AttachmentGroup>>;
+    list(parentId: FeatureId, options?: {
+        signal?: AbortSignal;
+    }): Promise<ReadonlyArray<AttachmentInfo>>;
+    add(request: AttachmentAdd): Promise<AttachmentEditOutcome>;
+    update(request: AttachmentUpdate): Promise<AttachmentEditOutcome>;
+    delete(request: AttachmentDelete): Promise<ReadonlyArray<AttachmentEditOutcome>>;
+}
+/**
+ * Formalizes the `HonuaMap.addSource` / `addLayer` binding. A `MapBinding`
+ * names the source that backs one or more rendering layers and carries an
+ * optional partial style block. `MapBinding` arrays serialize to
+ * `MapPackage.sourceBindings` + `MapPackage.mapSpec` on the server side.
+ */
+export interface MapBinding {
+    /** ID of the `Source` whose data backs the layers. */
+    sourceId: SourceId;
+    /** Layer ids consuming the source. */
+    layerIds: readonly string[];
+    /** Style overrides; merged with the source-driven defaults. */
+    style?: Record<string, unknown>;
+    /** Optional minimum zoom for visibility (forwarded to layer specs). */
+    minzoom?: number;
+    /** Optional maximum zoom for visibility (forwarded to layer specs). */
+    maxzoom?: number;
+}
+/**
+ * Discriminated union of the runtime adapter classes that implement
+ * `Source`. `Source.protocol()` (and the legacy `Source.adapter()` alias)
+ * narrows the typed escape hatch to one of these without forcing callers
+ * to cast through `unknown`.
+ */
+export type AdapterKind = "geoservices-feature-service" | "geoservices-map-service" | "geoservices-map-layer" | "geoservices-image-service" | "geoservices-geometry-service" | "geoservices-gp-service" | "ogc-features" | "ogc-tiles" | "ogc-maps" | "ogc-processes" | "stac" | "wfs" | "wms" | "wms-layer" | "wmts" | "wmts-layer" | "wmts-tileset" | "odata";
+/**
+ * Compile-time map from `AdapterKind` → underlying class instance. Adapter
+ * tickets extend this map by augmenting the `AdapterTypeMap` interface in
+ * their own module so `Source.protocol("wfs")` returns the right type
+ * without a cast. The interface ships empty by design — built-in adapters
+ * augment it from `src/contract/source.ts`.
+ */
+export interface AdapterTypeMap {
+}
+export type AdapterFor<K extends AdapterKind> = K extends keyof AdapterTypeMap ? AdapterTypeMap[K] : unknown;
+/**
+ * Protocol-neutral data-source handle. Adapters returned by
+ * `Dataset.source()` implement this interface directly; the existing
+ * `HonuaFeatureLayer`, `HonuaMapService`, and `HonuaOgcFeatureCollection`
+ * classes are reachable through the typed `protocol()` escape hatch
+ * (alias `adapter()`).
+ *
+ * The canonical surface covers the query family plus edit / related /
+ * attachment operations. Operations that are protocol-specific (raw
+ * `where`, raw `outFields`, GeoServices `calculate` / `validateSQL` /
+ * `replica` etc.) live behind `protocol()` so the top-level API stays
+ * free of ArcGIS-typed structures.
+ */
+export interface Source<T = Record<string, unknown>> {
+    readonly descriptor: SourceDescriptor;
+    readonly capabilities: Capabilities;
+    /** Single-page query. */
+    query(request?: Query<T>): Promise<Result<T>>;
+    /** Drain all pages into a single result. Honors `Query.pagination.limit`. */
+    queryAll(request?: Query<T>): Promise<Result<T>>;
+    /** Server-side aggregation; falls back to client-side under `degraded` policy. */
+    queryAggregate(request: Query<T> & {
+        aggregation: AggregationSpec;
+    }): Promise<Result<T>>;
+    /** Extent of the records that match `request`. */
+    queryExtent(request?: Query<T>): Promise<{
+        extent: HonuaExtent | null;
+        count?: number;
+    }>;
+    /** Async-generator paging stream. */
+    stream(request?: Query<T>): AsyncGenerator<Result<T>, void, undefined>;
+    /** Object ids of the records matching `request`. */
+    queryObjectIds(request?: Query<T>): Promise<readonly FeatureId[]>;
+    /** Apply add / update / delete edits to the source. */
+    applyEdits(envelope: EditEnvelope<T>): Promise<EditResult>;
+    /** Pull related records for the addressed source ids. */
+    queryRelated<R = Record<string, unknown>>(request: RelatedQuery): Promise<RelatedResult<R>>;
+    /** Attachment operations namespace; methods throw if `attachments` is missing. */
+    readonly attachments: AttachmentApi;
+    /**
+     * Typed escape hatch to the underlying protocol-specific class. Use this
+     * when a caller needs raw protocol semantics (e.g. raw `where`, raw
+     * `outFields`, GeoServices `calculate` / `validateSQL` / replica /
+     * `queryBins` / `getEstimates`) that the canonical surface intentionally
+     * does not expose.
+     */
+    protocol<K extends AdapterKind>(kind: K): AdapterFor<K> | undefined;
+    /**
+     * Legacy alias of {@link Source.protocol}. Retained for callers written
+     * against the original ticket-23 surface; new code should prefer
+     * `protocol()` because the name reflects the design intent of
+     * protocol-namespaced escape hatches.
+     */
+    adapter<K extends AdapterKind>(kind: K): AdapterFor<K> | undefined;
+}
+/**
+ * Logical grouping of one or more sources sharing identity and (optionally)
+ * a field schema. `Dataset` is the canonical entry point: `createDataset`
+ * gates the compatibility check and caches it per `HonuaClient`.
+ */
+export interface Dataset {
+    readonly id: DatasetId;
+    readonly client: HonuaClient;
+    readonly sourceDescriptors: ReadonlyArray<SourceDescriptor>;
+    /** Get a `Source` handle by id. Returns `undefined` if not registered. */
+    source<T = Record<string, unknown>>(id: SourceId): Source<T> | undefined;
+    /** Iterate registered source ids, in registration order. */
+    sourceIds(): readonly SourceId[];
+    /**
+     * Returns `true` when `client.checkCompatibility()` reported a supported
+     * server. The dataset caches the negotiation per `HonuaClient` instance.
+     */
+    isCompatible(): Promise<boolean>;
+    /** Server-feature gate that mirrors `HonuaClient.supportsFeature`. */
+    supportsFeature(feature: HonuaServerCompatibilityFeature): Promise<boolean>;
+}
+export type CapabilityPolicy = "strict" | "degraded";
+/**
+ * Context passed to a `SourceResolver`. Carries the active `HonuaClient`
+ * and the dataset's capability policy so adapters can react to either.
+ */
+export interface ResolveSourceContext {
+    readonly client: HonuaClient;
+    readonly capabilityPolicy: CapabilityPolicy;
+}
+/**
+ * Adapter factory invoked for descriptors the built-in resolvers cannot
+ * handle (today: `wfs`, `wms`, MapLibre-native sources). Downstream
+ * tickets register their adapters by passing one through
+ * `CreateDatasetOptions.resolveSource`.
+ */
+export type SourceResolver = (descriptor: SourceDescriptor, ctx: ResolveSourceContext) => Source | undefined;
+export interface CreateDatasetOptions {
+    id: DatasetId;
+    client: HonuaClient;
+    /** Source descriptors; `Source` instances are constructed lazily. */
+    sources: ReadonlyArray<SourceDescriptor>;
+    /**
+     * Capability policy. `"strict"` (default) refuses to construct a `Source`
+     * whose required capability is missing. `"degraded"` allows client-side
+     * fallback paths that report via `Result.degraded`.
+     */
+    capabilityPolicy?: CapabilityPolicy;
+    /**
+     * When `true`, skips the `client.checkCompatibility()` gate. Reserved for
+     * test fixtures and conformance suites; production code should leave this
+     * unset.
+     */
+    skipCompatibilityCheck?: boolean;
+    /**
+     * Resolver invoked for descriptors the built-in resolvers do not know how
+     * to handle. Built-in coverage today is `geoservices-feature-service`,
+     * `geoservices-map-service`, `ogc-features`. Downstream WFS / WMS / OData
+     * tickets supply their adapter here.
+     */
+    resolveSource?: SourceResolver;
+}
+//# sourceMappingURL=types.d.ts.map

package/contract/types.d.ts.map

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