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

package/contract/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shared client contract — canonical types and source factories that all
+ * protocol adapters speak. Re-exported from `@honua/sdk-js/contract`.
+ *
+ * The runtime classes in `src/core/surfaces.ts` remain the implementation;
+ * this module is the protocol-neutral vocabulary layered over them. See
+ * `docs/shared-client-contract.md` for the full design.
+ *
+ * @module
+ */
+export type { AdapterFor, AdapterKind, AdapterTypeMap, AggregationFn, AggregationMetric, AggregationSpec, AttachmentAdd, AttachmentApi, AttachmentDelete, AttachmentEditOutcome, AttachmentGroup, AttachmentInfo, AttachmentQuery, AttachmentUpdate, CanonicalFeature, Capabilities, Capability, CapabilityPolicy, CreateDatasetOptions, Dataset, DatasetId, DegradedReason, EditEnvelope, EditOutcome, EditResult, FeatureId, MapBinding, PaginationSpec, Protocol, Query, RelatedGroup, RelatedQuery, RelatedResult, ResolveSourceContext, Result, SortSpec, Source, SourceDescriptor, SourceId, SourceLocator, SourceResolver, SourceSchema, } from "./types.js";
+export type { SpatialAggregationCacheMetadata, SpatialAggregationCategoryBucket, SpatialAggregationCategorySummarySpec, SpatialAggregationCategoryValue, SpatialAggregationCell, SpatialAggregationCellGeometry, SpatialAggregationContractFixture, SpatialAggregationCountSummarySpec, SpatialAggregationCountValue, SpatialAggregationDomainValue, SpatialAggregationGroupByMetadata, SpatialAggregationGroupBySpec, SpatialAggregationGroupedSummary, SpatialAggregationHistogramBucket, SpatialAggregationHistogramSummarySpec, SpatialAggregationHistogramValue, SpatialAggregationInclude, SpatialAggregationIndexModelMetadata, SpatialAggregationIndexSelection, SpatialAggregationIndexState, SpatialAggregationMetadata, SpatialAggregationMetricKind, SpatialAggregationMetricSummarySpec, SpatialAggregationMetricValue, SpatialAggregationPageInfo, SpatialAggregationPageRequest, SpatialAggregationProgressRefinement, SpatialAggregationProgressStatus, SpatialAggregationProgressiveState, SpatialAggregationRangeBucketSpec, SpatialAggregationRangeBucketValue, SpatialAggregationRangeSummarySpec, SpatialAggregationRangeValue, SpatialAggregationRequest, SpatialAggregationResolutionInput, SpatialAggregationResult, SpatialAggregationSummaryBag, SpatialAggregationSummaryBase, SpatialAggregationSummaryKind, SpatialAggregationSummaryMetadata, SpatialAggregationSummarySpec, SpatialAggregationSummaryValue, SpatialAggregationValidationIssue, SpatialAggregationValueType, SpatialAggregationViewport, SpatialAggregationWidgetKind, SpatialAggregationWidgetMetadata, } from "./spatial-aggregation.js";
+export { CAPABILITIES, PROTOCOL_DEFAULT_CAPABILITIES, PROTOCOLS, capabilities, intersectCapabilities, unionCapabilities, } from "./types.js";
+export { EditWorkflowSession, createEditSession, normalizeEditWorkflowFailures } from "./edit-session.js";
+export type { CreateEditSessionOptions, EditAttachmentMutation, EditAttachmentMutationOutcome, EditFieldDomain, EditFieldDomainCodedValue, EditWorkflowCapabilityState, EditWorkflowCapabilitySummary, EditWorkflowConflictInfo, EditWorkflowConflictState, EditWorkflowFailure, EditWorkflowFailureKind, EditWorkflowField, EditWorkflowKind, EditWorkflowMetadata, EditWorkflowMetadataOptions, EditWorkflowOperation, EditWorkflowOptimisticHooks, EditWorkflowRelationship, EditWorkflowSnapshot, EditWorkflowStatus, EditWorkflowSubmitResult, EditWorkflowValidationError, EditWorkflowValidationResult, NormalizeEditWorkflowFailuresOptions, } from "./edit-session.js";
+export { SPATIAL_AGGREGATION_CAPABILITY, SPATIAL_AGGREGATION_METADATA_SCHEMA_VERSION, SPATIAL_AGGREGATION_SCHEMA_VERSION, assertValidSpatialAggregationRequest, isSpatialAggregationComplete, spatialAggregationProgress, spatialAggregationSummaryKindRequiresField, spatialAggregationWidgets, validateSpatialAggregationRequest, } from "./spatial-aggregation.js";
+export { ALL_CAPABILITIES, FIRST_PARTY_PROTOCOLS, createDataset, geoServicesFeatureSource, geoServicesGPServiceSource, geoServicesGeometryServiceSource, geoServicesImageSource, geoServicesMapServiceSource, odataSource, ogcFeaturesSource, ogcTilesSource, ogcMapsSource, stacSearchSource, wfsSource, wmsSource, wmtsSource, } from "./source.js";
+export type { IJobRun, JobError, JobProgress, JobResult, JobSnapshot, JobSnapshotListener, JobStatus, } from "./jobs.js";
+export { isJobTerminal } from "./jobs.js";
+//# sourceMappingURL=index.d.ts.map

package/contract/index.d.ts.map

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

package/contract/index.js

@@ -0,0 +1,15 @@
+/**
+ * Shared client contract — canonical types and source factories that all
+ * protocol adapters speak. Re-exported from `@honua/sdk-js/contract`.
+ *
+ * The runtime classes in `src/core/surfaces.ts` remain the implementation;
+ * this module is the protocol-neutral vocabulary layered over them. See
+ * `docs/shared-client-contract.md` for the full design.
+ *
+ * @module
+ */
+export { CAPABILITIES, PROTOCOL_DEFAULT_CAPABILITIES, PROTOCOLS, capabilities, intersectCapabilities, unionCapabilities, } from "./types.js";
+export { EditWorkflowSession, createEditSession, normalizeEditWorkflowFailures } from "./edit-session.js";
+export { SPATIAL_AGGREGATION_CAPABILITY, SPATIAL_AGGREGATION_METADATA_SCHEMA_VERSION, SPATIAL_AGGREGATION_SCHEMA_VERSION, assertValidSpatialAggregationRequest, isSpatialAggregationComplete, spatialAggregationProgress, spatialAggregationSummaryKindRequiresField, spatialAggregationWidgets, validateSpatialAggregationRequest, } from "./spatial-aggregation.js";
+export { ALL_CAPABILITIES, FIRST_PARTY_PROTOCOLS, createDataset, geoServicesFeatureSource, geoServicesGPServiceSource, geoServicesGeometryServiceSource, geoServicesImageSource, geoServicesMapServiceSource, odataSource, ogcFeaturesSource, ogcTilesSource, ogcMapsSource, stacSearchSource, wfsSource, wmsSource, wmtsSource, } from "./source.js";
+export { isJobTerminal } from "./jobs.js";

package/contract/jobs.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Canonical async-operation surface. `IJobRun` is the protocol-neutral
+ * vocabulary every long-running operation in the SDK speaks. It is the
+ * receipt returned from operations that complete asynchronously on the
+ * server (OGC API Processes execution, future GeoServices async export
+ * tickets, OData function imports, etc.).
+ *
+ * Per the ticket constraint, OGC Processes specifically must surface
+ * through this shared interface — there is no `OgcJobRun` top-level
+ * type. The implementation in `src/core/ogc-processes.ts` returns
+ * `IJobRun<T>` directly.
+ *
+ * @module
+ */
+/**
+ * Coarse-grained job lifecycle. The OGC API Processes 1.0 status values
+ * (`accepted`, `running`, `successful`, `failed`, `dismissed`) are the
+ * canonical vocabulary; adapters for protocols that report a narrower or
+ * wider set must map onto these.
+ */
+export type JobStatus = "accepted" | "running" | "successful" | "failed" | "dismissed";
+/** Human-meaningful job-progress signal. Optional; servers may omit fields. */
+export interface JobProgress {
+    /** 0..100. Omitted when the server does not report a numeric estimate. */
+    percent?: number;
+    /** Human-readable status message for the current step. */
+    message?: string;
+    /** ISO-8601 timestamp of when the server last updated the progress. */
+    updatedAt?: string;
+}
+/**
+ * Snapshot of a job's state. Returned from `IJobRun.poll()` and emitted
+ * to `IJobRun.watch` listeners. The result/error fields are filled only
+ * for terminal states.
+ */
+export interface JobSnapshot<T = unknown> {
+    status: JobStatus;
+    progress?: JobProgress;
+    /** Payload returned for terminal `successful` snapshots only. */
+    result?: JobResult<T>;
+    /** Error envelope returned for terminal `failed` snapshots. */
+    error?: JobError;
+}
+/**
+ * Server-side error envelope for a failed job. Mirrors the OGC API
+ * Processes "exception" shape; adapters for other protocols translate
+ * onto this surface so callers can branch on `code` without protocol
+ * knowledge.
+ */
+export interface JobError {
+    /** Stable machine code (e.g. `"InvalidParameterValue"`). */
+    code: string;
+    /** Human-readable explanation. */
+    message: string;
+    /** Optional details payload as returned by the server. */
+    details?: unknown;
+}
+/**
+ * Job-result document. `outputs` is a map of output-id → value; the SDK
+ * does not parse the value further (it may be a GeoJSON feature
+ * collection, a download URL, a binary asset, etc., depending on the
+ * process). Adapters narrow `T` for typed access.
+ */
+export interface JobResult<T = unknown> {
+    outputs: Record<string, T>;
+}
+/** Listener function invoked on every observed snapshot transition. */
+export type JobSnapshotListener<T = unknown> = (snapshot: JobSnapshot<T>) => void;
+/**
+ * Canonical async-operation handle. Methods are intentionally narrow so
+ * downstream tickets that submit jobs (operator workflows, manifest
+ * apply, etc.) can speak one vocabulary across protocols.
+ */
+export interface IJobRun<T = unknown> {
+    /** Stable identifier assigned by the server when the job was accepted. */
+    readonly id: string;
+    /** Process / operation identifier, e.g. an OGC processId. */
+    readonly type: string;
+    /**
+     * Last-observed status. Backed by the most recent `poll()` /
+     * `status()` / `watch()` snapshot; reads are synchronous.
+     */
+    readonly status: JobStatus;
+    /** Last-observed progress, if the server reported any. */
+    readonly progress: JobProgress | undefined;
+    /** Force a fresh server poll and return the resulting snapshot. */
+    poll(): Promise<JobSnapshot<T>>;
+    /**
+     * Subscribe to snapshot transitions. The callback fires on every
+     * observed status / progress change, and again on the terminal
+     * snapshot. Returns an unsubscribe handle.
+     */
+    watch(listener: JobSnapshotListener<T>): () => void;
+    /**
+     * Wait for the job to reach a terminal state and resolve with the
+     * outputs. Rejects with `HonuaJobFailedError` for `failed` /
+     * `dismissed` terminal states. Implementations must poll on a
+     * configurable interval; the default cadence is left to the adapter.
+     */
+    results(): Promise<JobResult<T>>;
+    /**
+     * Cancel / dismiss the job. Idempotent. Returns the resulting status
+     * (typically `dismissed`, but the server may have raced to a terminal
+     * state already, in which case the original terminal status is
+     * returned).
+     */
+    cancel(): Promise<JobStatus>;
+}
+/**
+ * `true` when the snapshot status is one of the terminal values
+ * (`successful`, `failed`, `dismissed`). Useful for stop conditions in
+ * watchers and tests.
+ */
+export declare function isJobTerminal(status: JobStatus): boolean;
+//# sourceMappingURL=jobs.d.ts.map

package/contract/jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../../src/contract/jobs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEvF,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,iEAAiE;IACjE,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACtB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO;IACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;CAC5B;AAED,uEAAuE;AACvE,MAAM,MAAM,mBAAmB,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAElF;;;;GAIG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC,GAAG,OAAO;IAClC,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,SAAS,CAAC;IAC3C,mEAAmE;IACnE,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC;IACpD;;;;;OAKG;IACH,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC;;;;;OAKG;IACH,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAExD"}

package/contract/jobs.js

@@ -0,0 +1,22 @@
+/**
+ * Canonical async-operation surface. `IJobRun` is the protocol-neutral
+ * vocabulary every long-running operation in the SDK speaks. It is the
+ * receipt returned from operations that complete asynchronously on the
+ * server (OGC API Processes execution, future GeoServices async export
+ * tickets, OData function imports, etc.).
+ *
+ * Per the ticket constraint, OGC Processes specifically must surface
+ * through this shared interface — there is no `OgcJobRun` top-level
+ * type. The implementation in `src/core/ogc-processes.ts` returns
+ * `IJobRun<T>` directly.
+ *
+ * @module
+ */
+/**
+ * `true` when the snapshot status is one of the terminal values
+ * (`successful`, `failed`, `dismissed`). Useful for stop conditions in
+ * watchers and tests.
+ */
+export function isJobTerminal(status) {
+    return status === "successful" || status === "failed" || status === "dismissed";
+}

package/contract/source.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Built-in `Source` adapters that wrap the runtime classes in
+ * `src/core/surfaces.ts` (`HonuaFeatureLayer`, `HonuaMapLayer`,
+ * `HonuaOgcFeatureCollection`) and the OGC / STAC / WFS / WMS / OData
+ * adapters in `src/core/`. Consumers register adapters for any other
+ * protocol (MapLibre-native sources, etc.) via
+ * `CreateDatasetOptions.resolveSource`.
+ *
+ * These adapters do not reimplement query logic — they translate the
+ * canonical `Query` / `Result` envelope to and from the existing per-class
+ * request and response shapes.
+ *
+ * @module
+ */
+import type { HonuaClient } from "../core/client.js";
+import { HonuaOdataEntitySet } from "../core/odata.js";
+import { HonuaOgcCollectionMap, HonuaOgcMaps } from "../core/ogc-maps.js";
+import type { HonuaOgcProcesses } from "../core/ogc-processes.js";
+import { HonuaOgcTiles, HonuaOgcTileset } from "../core/ogc-tiles.js";
+import { HonuaStacSearch } from "../core/stac.js";
+import { HonuaFeatureLayer, HonuaGeometryService, HonuaGeoprocessingService, HonuaImageService, HonuaMapLayer, HonuaMapService, HonuaOgcFeatureCollection } from "../core/surfaces.js";
+import { HonuaWfsFeatureType } from "../core/wfs.js";
+import { HonuaWms, HonuaWmsLayer } from "../core/wms.js";
+import { HonuaWmts, HonuaWmtsLayer, HonuaWmtsTileset } from "../core/wmts.js";
+import { type Capability, type CapabilityPolicy, type CreateDatasetOptions, type Dataset, type Protocol, type Source, type SourceDescriptor } from "./types.js";
+/**
+ * Construct a `Dataset` over one `HonuaClient`. Compatibility is checked
+ * once and cached on the client. `Source` handles are constructed lazily.
+ */
+export declare function createDataset(options: CreateDatasetOptions): Dataset;
+export declare function geoServicesFeatureSource<T>(descriptor: SourceDescriptor, client: HonuaClient, policy: CapabilityPolicy): Source<T>;
+export declare function geoServicesMapServiceSource<T>(descriptor: SourceDescriptor, client: HonuaClient, policy: CapabilityPolicy): Source<T>;
+export declare function ogcFeaturesSource<T>(descriptor: SourceDescriptor, client: HonuaClient, policy: CapabilityPolicy): Source<T>;
+/**
+ * Build a `Source` over an Esri-style ImageServer endpoint. The query
+ * surface drives the raster catalog (each row is a raster with footprint
+ * geometry); image export, identify, and tile operations live behind
+ * `Source.protocol("geoservices-image-service")`.
+ */
+export declare function geoServicesImageSource<T>(descriptor: SourceDescriptor, client: HonuaClient, policy: CapabilityPolicy): Source<T>;
+/**
+ * Build a `Source` over an Esri-style Geometry Service endpoint. Geometry
+ * Service is a stateless utility — it does not host features — so the
+ * query family throws `HonuaCapabilityNotSupportedError` and operations
+ * (buffer, project, simplify, etc.) live behind
+ * `Source.protocol("geoservices-geometry-service")`.
+ */
+export declare function geoServicesGeometryServiceSource<T>(descriptor: SourceDescriptor, client: HonuaClient, policy: CapabilityPolicy): Source<T>;
+/**
+ * Build a `Source` over an Esri-style GP (geoprocessing) service. GP
+ * services run async tasks rather than hosting features; the canonical
+ * feature surface throws and task submission / status / result lookup
+ * live behind `Source.protocol("geoservices-gp-service")`.
+ */
+export declare function geoServicesGPServiceSource<T>(descriptor: SourceDescriptor, client: HonuaClient, policy: CapabilityPolicy): Source<T>;
+/**
+ * Render-only Source adapter for OGC API Tiles. The query family throws
+ * `HonuaCapabilityNotSupportedError` (the conformance class is
+ * tile-fetch, not feature-query); rendering integrations consume the
+ * tileset through `Source.protocol("ogc-tiles")` to reach the underlying
+ * runtime class.
+ */
+export declare function ogcTilesSource<T>(descriptor: SourceDescriptor, client: HonuaClient, policy: CapabilityPolicy): Source<T>;
+/**
+ * Render-only Source adapter for OGC API Maps. Same shape as the Tiles
+ * adapter — `Source.protocol("ogc-maps")` exposes the runtime class for
+ * server-rendered map images; the canonical query family throws.
+ */
+export declare function ogcMapsSource<T>(descriptor: SourceDescriptor, client: HonuaClient, policy: CapabilityPolicy): Source<T>;
+/**
+ * `Source` adapter for first-party WMS 1.3.0 services. The render path
+ * routes through `HonuaWms` / `HonuaWmsLayer` (both of which sit
+ * behind the canonical `Source.protocol("wms" | "wms-layer")` escape
+ * hatch); `Source.query()` translates a point spatial filter into a
+ * `GetFeatureInfo` call. Non-point queries throw
+ * `HonuaCapabilityNotSupportedError` so the canonical query envelope
+ * stays honest — multi-pixel feature info lives on
+ * `Source.protocol("wms").featureInfo()`.
+ */
+export declare function wmsSource<T>(descriptor: SourceDescriptor, client: HonuaClient, policy: CapabilityPolicy): Source<T>;
+/**
+ * Render-only `Source` adapter for first-party WMTS 1.0.0 services.
+ * `Source.query()` throws because WMTS GetFeatureInfo is keyed on tile
+ * pixels (not a canonical spatial filter); raw access lives on
+ * `Source.protocol("wmts" | "wmts-layer" | "wmts-tileset")`.
+ */
+export declare function wmtsSource<T>(descriptor: SourceDescriptor, client: HonuaClient, policy: CapabilityPolicy): Source<T>;
+export declare function stacSearchSource<T>(descriptor: SourceDescriptor, client: HonuaClient, policy: CapabilityPolicy): Source<T>;
+export declare function wfsSource<T>(descriptor: SourceDescriptor, client: HonuaClient, policy: CapabilityPolicy): Source<T>;
+/**
+ * Build a `Source` over an OData v4 entity set. The `Query` translation
+ * lowers `where` / `outFields` / `orderBy` / pagination / spatial filter
+ * onto OData's `$`-prefixed query options. Dialect-specific operations
+ * (`$batch`, `$apply`, `$search`, `$deltatoken`) live behind
+ * `Source.protocol("odata")` on the returned `HonuaOdataEntitySet`.
+ *
+ * `$metadata` is fetched lazily on the first call that needs it and
+ * cached on the entity-set instance. The fetched capability annotations
+ * are intersected with the descriptor's declared `Capabilities` set the
+ * first time a capability-gated method is invoked — this is the
+ * precedent for the metadata-driven downgrade pattern referenced in
+ * `docs/shared-client-contract.md`.
+ */
+export declare function odataSource<T>(descriptor: SourceDescriptor, client: HonuaClient, policy: CapabilityPolicy): Source<T>;
+/**
+ * Declare the shipped adapter → runtime-class bindings so
+ * `Source.adapter("geoservices-feature-service")` et al. narrow to the
+ * right class instead of collapsing to `unknown`. Downstream adapter
+ * tickets that ship outside this module add their own augmentations in
+ * their own modules.
+ */
+declare module "./types.js" {
+    interface AdapterTypeMap {
+        "geoservices-feature-service": HonuaFeatureLayer;
+        "geoservices-map-service": HonuaMapService;
+        "geoservices-map-layer": HonuaMapLayer;
+        "geoservices-image-service": HonuaImageService;
+        "geoservices-geometry-service": HonuaGeometryService;
+        "geoservices-gp-service": HonuaGeoprocessingService;
+        "ogc-features": HonuaOgcFeatureCollection;
+        "ogc-tiles": HonuaOgcTileset | HonuaOgcTiles;
+        "ogc-maps": HonuaOgcMaps | HonuaOgcCollectionMap;
+        "ogc-processes": HonuaOgcProcesses;
+        stac: HonuaStacSearch;
+        wfs: HonuaWfsFeatureType;
+        wms: HonuaWms;
+        "wms-layer": HonuaWmsLayer;
+        wmts: HonuaWmts;
+        "wmts-layer": HonuaWmtsLayer;
+        "wmts-tileset": HonuaWmtsTileset;
+        odata: HonuaOdataEntitySet;
+    }
+}
+/** Sentinel: `Capabilities` set that contains every defined capability. */
+export declare const ALL_CAPABILITIES: ReadonlySet<Capability>;
+/** Tag a `Protocol` as "first-party-supported by this build". */
+export declare const FIRST_PARTY_PROTOCOLS: ReadonlySet<Protocol>;
+//# sourceMappingURL=source.d.ts.map

package/contract/source.d.ts.map

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