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

package/contract/index.d.ts

@@ -39,23 +39,34 @@
  *
  * @packageDocumentation
  */
-export type { AdapterFor, AdapterKind, AdapterTypeMap, AggregationFn, AggregationHistogramBucketAliases, AggregationHistogramBucketSpec, AggregationMetric, AggregationSpec, AggregationTimeIntervalSpec, AggregationTimeIntervalUnit, AggregationTimeSeriesAliases, AggregationTimeSeriesSpec, 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, SourceAnalyticsCapabilities, SourceDescriptor, SourceFreshnessContract, SourceHistogramCapabilityMetadata, SourceId, SourceLocator, SourceResolver, SourceSchema, SourceTimeSeriesCapabilityMetadata, } from "./types.js";
+export type { AdapterFor, AdapterKind, AdapterTypeMap, AggregationFn, AggregationHistogramBucketAliases, AggregationHistogramBucketSpec, AggregationMetric, AggregationSpec, AggregationTimeIntervalSpec, AggregationTimeIntervalUnit, AggregationTimeSeriesAliases, AggregationTimeSeriesSpec, AttachmentAdd, AttachmentApi, AttachmentDelete, AttachmentEditOutcome, AttachmentGroup, AttachmentInfo, AttachmentQuery, AttachmentUpdate, CanonicalFeature, Capabilities, CapabilityAwareSource, Capability, CapabilityPolicy, CreateDatasetOptions, Dataset, DatasetId, DegradedReason, EditEnvelope, EditOutcome, EditResult, FeatureId, MapBinding, PaginationSpec, Protocol, Query, RasterRequestBinding, RelatedGroup, RelatedQuery, RelatedResult, ResolveSourceContext, Result, SortSpec, Source, SourceWithCapability, SourceAnalyticsCapabilities, SourceDescriptor, SourceFreshnessContract, SourceHistogramCapabilityMetadata, SourceId, SourceLocator, SourceResolver, SourceSchema, SourceTimeSeriesCapabilityMetadata, } from "./types.js";
 export type { SpatialAggregationCacheMetadata, SpatialAggregationCategoryBucket, SpatialAggregationCategorySummarySpec, SpatialAggregationCategoryValue, SpatialAggregationCell, SpatialAggregationCellGeometry, SpatialAggregationContractFixture, SpatialAggregationCountSummarySpec, SpatialAggregationCountValue, SpatialAggregationDomainValue, SpatialAggregationGroupByMetadata, SpatialAggregationGroupBySpec, SpatialAggregationGroupedSummary, SpatialAggregationHistogramBucket, SpatialAggregationHistogramSummarySpec, SpatialAggregationHistogramValue, SpatialAggregationInclude, SpatialAggregationIndexModelMetadata, SpatialAggregationIndexCoverageMetadata, SpatialAggregationIndexSelection, SpatialAggregationIndexState, SpatialAggregationMetadata, SpatialAggregationMetricKind, SpatialAggregationMetricSummarySpec, SpatialAggregationMetricValue, SpatialAggregationPageInfo, SpatialAggregationPageRequest, SpatialAggregationProgressRefinement, SpatialAggregationProgressStatus, SpatialAggregationProgressiveState, SpatialAggregationRangeBucketSpec, SpatialAggregationRangeBucketValue, SpatialAggregationRangeSummarySpec, SpatialAggregationRangeValue, SpatialAggregationRequest, SpatialAggregationResolutionInput, SpatialAggregationResult, SpatialAggregationResolvedWidgetSummary, SpatialAggregationSummaryBag, SpatialAggregationSummaryBase, SpatialAggregationSummaryKind, SpatialAggregationSummaryMetadata, SpatialAggregationSummarySpec, SpatialAggregationSummaryValue, SpatialAggregationValidationIssue, SpatialAggregationValueType, SpatialAggregationViewport, SpatialAggregationWidgetKind, SpatialAggregationWidgetMetadata, SpatialAggregationWidgetSummarySource, } from "./spatial-aggregation.js";
 export { CAPABILITIES, PROTOCOL_DEFAULT_CAPABILITIES, PROTOCOLS, capabilities, intersectCapabilities, unionCapabilities, } from "./types.js";
+export type { SourceSchemaV2Envelope } from "./schema-envelope.js";
+export { HONUA_DISCOVERY_ADAPTER_VERSION, HONUA_DISCOVERY_PROJECTION_VERSION, createDiscoveryCacheIdentity, inspectDiscoveredSource, normalizeDiscoveryEndpoint, resolveDiscoveryCapabilities, } from "./discovery.js";
+export type { DiscoveryCacheIdentity, DiscoveryCacheIdentityOptions, DiscoveryCacheResourceIdentity, DiscoveryAxisOrderMetadata, DiscoveryCapabilityDecision, DiscoveryCapabilityDecisionCode, DiscoveryCapabilityEvidence, DiscoveryCapabilityEvidenceSummary, DiscoveryCapabilityPolicy, DiscoveryCapabilityResolution, DiscoveryDiagnostic, DiscoveryDiagnosticCode, DiscoveryDimensionMetadata, DiscoveryEvidenceKind, DiscoveryOperationMetadata, DiscoveryProvenance, DiscoverySourceMetadata, DiscoveryState, DiscoveryStyleMetadata, DiscoveryTileMatrixMetadata, DiscoveryTileMatrixSetMetadata, SourceDiscoveryInspection, } from "./discovery.js";
+export { HonuaDiscoveryError } from "../core/errors.js";
+export type { HonuaDiscoveryErrorCode } from "../core/errors.js";
 export { ANALYTICS_SOURCE_SCHEMA_VERSION, analyticsSourceDegradedReason, analyticsSourceId, assessAnalyticsSourcePushdown, buildAnalyticsSourceCacheKey, defineIndexedSpatialSource, defineWarehouseQuerySource, defineWarehouseTableSource, defineWarehouseTilesetSource, isAnalyticsSourceDescriptor, normalizeAnalyticsSourceDescriptor, } from "./analytics-sources.js";
 export type { AnalyticsIndexCoverageDescriptor, AnalyticsIndexCoverageKind, AnalyticsIndexDescriptor, AnalyticsIndexHierarchy, AnalyticsSourceCacheIdentity, AnalyticsSourceCacheKeyOptions, AnalyticsSourceCachePolicy, AnalyticsSourceCapabilityMetadata, AnalyticsSourceDescriptor, AnalyticsSourceDescriptorBase, AnalyticsSourceFallbackMode, AnalyticsSourceFallbackPolicy, AnalyticsSourceKind, AnalyticsSourceProtocolEscapeHatch, AnalyticsSourcePushdownAssessment, AnalyticsSourcePushdownCapability, AnalyticsSourceRelationDescriptor, AnalyticsSourceSchemaVersion, AnalyticsSourceSqlDescriptor, AnalyticsSourceTilesetDescriptor, AnalyticsWarehouseProvider, IndexedSpatialSourceDescriptor, WarehouseQuerySourceDescriptor, WarehouseTableSourceDescriptor, WarehouseTilesetSourceDescriptor, } from "./analytics-sources.js";
 export type { WidgetCategoriesRequest, WidgetCategoriesResult, WidgetCategoryBucket, WidgetCountRequest, WidgetCountResult, WidgetFormulaRequest, WidgetFormulaResult, WidgetHistogramBin, WidgetHistogramRequest, WidgetHistogramResult, WidgetRangeRequest, WidgetRangeResult, WidgetSource, WidgetSourceCacheHints, WidgetSourceCacheMetadata, WidgetSourceExecutionMode, WidgetSourceFilterClause, WidgetSourceFreshnessContract, WidgetSourceModelKind, WidgetSourceOptions, WidgetSourceOrderBy, WidgetSourceProjection, WidgetSourceRequestBase, WidgetSourceResponseBase, WidgetSourceSchemaVersion, WidgetSourceValue, WidgetTimeSeriesBucket, WidgetTimeSeriesInterval, WidgetTimeSeriesIntervalUnit, WidgetTimeSeriesRequest, WidgetTimeSeriesResult, WidgetTopValueBucket, WidgetTopValuesRequest, WidgetTopValuesResult, } from "./widget-source.js";
 export { WIDGET_SOURCE_SCHEMA_VERSION, createWidgetSource, widgetSource } from "./widget-source.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 { DEFAULT_SNAPPING_CONFIG, SnapIndex, compareSnapCandidates, createSnapIndex, createSnapIndexEditSessionHooks, resolveSnapCandidate, resolveSnappingConfig, withSnappedActiveVertex, } from "./edit-snapping.js";
+export type { SnapCandidate, SnapCandidateKind, SnapIndexEditSessionHookOptions, SnapIndexFeatureInput, SnapIndexStats, SnapPosition, SnapProjection, SnapQueryInput, SnapResolution, SnapScreenPoint, SnapSourceOptions, SnappingConfig, } from "./edit-snapping.js";
 export { EditSketchWorkflowModel, createEditSketchWorkflow } from "./edit-sketch.js";
 export type { EditAnnotationPersistenceHook, EditAnnotationPersistenceSnapshot, EditAnnotationPersistenceState, EditSketchCapabilityState, EditSketchStatus, EditSketchTool, EditSketchToolCapability, EditSketchToolCapabilityInput, EditSketchUndoSnapshot, EditSketchWorkflowOptions, EditSketchWorkflowSnapshot, } from "./edit-sketch.js";
 export { FEATURE_SERVER_H3_SPATIAL_AGGREGATION_INDEX_MODEL_ID, SPATIAL_AGGREGATION_CAPABILITY, SPATIAL_AGGREGATION_METADATA_SCHEMA_VERSION, SPATIAL_AGGREGATION_SCHEMA_VERSION, assertFeatureServerH3SpatialAggregationRequest, assertValidSpatialAggregationRequest, isSpatialAggregationComplete, resolveSpatialAggregationWidgetSummary, spatialAggregationProgress, spatialAggregationSummaryKindSupportedByFeatureServerH3, spatialAggregationSummaryKindRequiresField, spatialAggregationWidgets, validateFeatureServerH3SpatialAggregationRequest, validateSpatialAggregationRequest, } from "./spatial-aggregation.js";
 export { QUERY_TILE_SERVER_CONTRACT_VERSION, QUERY_TILE_SERVER_FEATURE_DETAIL_ROUTE_TEMPLATE, QUERY_TILE_SERVER_RESPONSE_HEADERS, QUERY_TILE_SERVER_ROUTE_PREFIX, QUERY_TILE_SERVER_SOURCE_ROUTE_TEMPLATE, QUERY_TILE_SERVER_TILEJSON_ROUTE_TEMPLATE, QUERY_TILE_SERVER_TILE_ROUTE_TEMPLATE, buildQueryTileCacheKey, buildQueryTileFeatureDetailQuery, buildQueryTileServerPath, buildQueryTileServerUrl, defineQueryTileSource, loadQueryTileFeatureDetail, mapQueryTileFeatureIdentity, normalizeQueryTileKey, normalizeQueryTileSourceDescriptor, parseQueryTileFeatureDetailResponse, parseQueryTileJson, parseQueryTileServerErrorResponse, queryTileServerRequestParamsFromDescriptor, queryTileKeyString, stableJson, } from "./tiles.js";
 export type { DefineQueryTileSourceOptions, QueryTileCacheIdentityDescriptor, QueryTileCacheKeyOptions, QueryTileCachePolicy, QueryTileEndpointDescriptor, QueryTileFallbackMode, QueryTileFallbackPolicy, QueryTileFeatureDetailOptions, QueryTileFeatureIdentityContext, QueryTileFeatureIdentityDescriptor, QueryTileFeatureIdentityMapper, QueryTileFeatureIdentityTarget, QueryTileFormat, QueryTileFeatureDetailResponse, QueryTileJson, QueryTileJsonVectorLayer, QueryTileKey, QueryTileKeyInput, QueryTileProjectionDescriptor, QueryTileScheme, QueryTileServerCachePolicyDescriptor, QueryTileServerCacheValidators, QueryTileServerContractFixture, QueryTileServerDegradation, QueryTileServerDegradationCode, QueryTileServerDegradationSeverity, QueryTileServerError, QueryTileServerErrorCode, QueryTileServerErrorResponse, QueryTileServerFeatureIdentityDescriptor, QueryTileServerLimitDescriptor, QueryTileServerRequestParameters, QueryTileServerRouteKind, QueryTileServerRouteOptions, QueryTileServerTileJsonMetadata, QueryTileSpatialReference, QueryTileSpatialReferenceDescriptor, QueryTileExtentDescriptor, QueryTileSourceDescriptor, } from "./tiles.js";
 export { ALL_CAPABILITIES, FIRST_PARTY_PROTOCOLS, createDataset, geoServicesFeatureSource, geoServicesGPServiceSource, geoServicesGeometryServiceSource, geoServicesImageSource, geoServicesMapServiceSource, odataSource, ogcFeaturesSource, ogcTilesSource, ogcMapsSource, ogcRecordsSource, stacSearchSource, wfsSource, wmsSource, wmtsSource, } from "./source.js";
+export type { OdataSourceOptions, OdataWriteEncoding } from "./source.js";
 export type { IJobRun, JobError, JobProgress, JobResult, JobResultsOptions, JobSnapshot, JobSnapshotListener, JobStatus, } from "./jobs.js";
 export { HonuaJobPollTimeoutError, isJobTerminal } from "./jobs.js";
+export { HonuaPmtilesArchive, describePmtilesArchive, pmtilesProtocolModule, stripPmtilesScheme, toPmtilesSourceUrl, } from "./pmtiles.js";
+export type { DescribePmtilesArchiveDeps, PmtilesArchiveDescription, PmtilesArchiveLike, PmtilesHeaderLike, PmtilesModuleLike, PmtilesRangeResponse, PmtilesSourceLike, PmtilesTileKind, PmtilesVectorLayerInfo, } from "./pmtiles.js";
+export type { ProtocolModule, ProtocolModuleDiagnostic, ProtocolModuleDiscoverOptions, ProtocolModuleEnvironment, ProtocolModuleHandle, } from "./protocol-module.js";
 export { TEMPORAL_CAPABILITY, TEMPORAL_ROUTE_PREFIX, TEMPORAL_ROUTES, TEMPORAL_SCHEMA_VERSION, assertValidTemporalRollbackPlanRequest, createTemporalClient, isReadOnlyTemporalHistory, temporalModeSupports, validateTemporalRollbackPlanRequest, } from "./temporal.js";
 export type { TemporalAsOfRequest, TemporalAttributeChange, TemporalCheckpoint, TemporalChangeSet, TemporalChangeSetOperationKind, TemporalClient, TemporalClientCallOptions, TemporalContractFixture, TemporalCursor, TemporalCursorType, TemporalDiff, TemporalDiffRequest, TemporalDiffStatus, TemporalDiffSummary, TemporalError, TemporalErrorCode, TemporalFeatureChangeType, TemporalFeatureDiff, TemporalFeatureTimeline, TemporalFeatureTimelineRequest, TemporalFilter, TemporalGeometryChange, TemporalHistoryModel, TemporalJobRef, TemporalMode, TemporalRequestClient, TemporalRevision, TemporalRevisionOperation, TemporalRiskLevel, TemporalRollbackExecuteRequest, TemporalRollbackMode, TemporalRollbackOperation, TemporalRollbackPlan, TemporalRollbackPlanRequest, TemporalRollbackScope, TemporalRollbackStatus, TemporalSourceCapability, TemporalValidationIssue, } from "./temporal.js";
 //# sourceMappingURL=index.d.ts.map

package/contract/index.d.ts.map

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

package/contract/index.js

@@ -40,12 +40,16 @@
  * @packageDocumentation
  */
 export { CAPABILITIES, PROTOCOL_DEFAULT_CAPABILITIES, PROTOCOLS, capabilities, intersectCapabilities, unionCapabilities, } from "./types.js";
+export { HONUA_DISCOVERY_ADAPTER_VERSION, HONUA_DISCOVERY_PROJECTION_VERSION, createDiscoveryCacheIdentity, inspectDiscoveredSource, normalizeDiscoveryEndpoint, resolveDiscoveryCapabilities, } from "./discovery.js";
+export { HonuaDiscoveryError } from "../core/errors.js";
 export { ANALYTICS_SOURCE_SCHEMA_VERSION, analyticsSourceDegradedReason, analyticsSourceId, assessAnalyticsSourcePushdown, buildAnalyticsSourceCacheKey, defineIndexedSpatialSource, defineWarehouseQuerySource, defineWarehouseTableSource, defineWarehouseTilesetSource, isAnalyticsSourceDescriptor, normalizeAnalyticsSourceDescriptor, } from "./analytics-sources.js";
 export { WIDGET_SOURCE_SCHEMA_VERSION, createWidgetSource, widgetSource } from "./widget-source.js";
 export { EditWorkflowSession, createEditSession, normalizeEditWorkflowFailures } from "./edit-session.js";
+export { DEFAULT_SNAPPING_CONFIG, SnapIndex, compareSnapCandidates, createSnapIndex, createSnapIndexEditSessionHooks, resolveSnapCandidate, resolveSnappingConfig, withSnappedActiveVertex, } from "./edit-snapping.js";
 export { EditSketchWorkflowModel, createEditSketchWorkflow } from "./edit-sketch.js";
 export { FEATURE_SERVER_H3_SPATIAL_AGGREGATION_INDEX_MODEL_ID, SPATIAL_AGGREGATION_CAPABILITY, SPATIAL_AGGREGATION_METADATA_SCHEMA_VERSION, SPATIAL_AGGREGATION_SCHEMA_VERSION, assertFeatureServerH3SpatialAggregationRequest, assertValidSpatialAggregationRequest, isSpatialAggregationComplete, resolveSpatialAggregationWidgetSummary, spatialAggregationProgress, spatialAggregationSummaryKindSupportedByFeatureServerH3, spatialAggregationSummaryKindRequiresField, spatialAggregationWidgets, validateFeatureServerH3SpatialAggregationRequest, validateSpatialAggregationRequest, } from "./spatial-aggregation.js";
 export { QUERY_TILE_SERVER_CONTRACT_VERSION, QUERY_TILE_SERVER_FEATURE_DETAIL_ROUTE_TEMPLATE, QUERY_TILE_SERVER_RESPONSE_HEADERS, QUERY_TILE_SERVER_ROUTE_PREFIX, QUERY_TILE_SERVER_SOURCE_ROUTE_TEMPLATE, QUERY_TILE_SERVER_TILEJSON_ROUTE_TEMPLATE, QUERY_TILE_SERVER_TILE_ROUTE_TEMPLATE, buildQueryTileCacheKey, buildQueryTileFeatureDetailQuery, buildQueryTileServerPath, buildQueryTileServerUrl, defineQueryTileSource, loadQueryTileFeatureDetail, mapQueryTileFeatureIdentity, normalizeQueryTileKey, normalizeQueryTileSourceDescriptor, parseQueryTileFeatureDetailResponse, parseQueryTileJson, parseQueryTileServerErrorResponse, queryTileServerRequestParamsFromDescriptor, queryTileKeyString, stableJson, } from "./tiles.js";
 export { ALL_CAPABILITIES, FIRST_PARTY_PROTOCOLS, createDataset, geoServicesFeatureSource, geoServicesGPServiceSource, geoServicesGeometryServiceSource, geoServicesImageSource, geoServicesMapServiceSource, odataSource, ogcFeaturesSource, ogcTilesSource, ogcMapsSource, ogcRecordsSource, stacSearchSource, wfsSource, wmsSource, wmtsSource, } from "./source.js";
 export { HonuaJobPollTimeoutError, isJobTerminal } from "./jobs.js";
+export { HonuaPmtilesArchive, describePmtilesArchive, pmtilesProtocolModule, stripPmtilesScheme, toPmtilesSourceUrl, } from "./pmtiles.js";
 export { TEMPORAL_CAPABILITY, TEMPORAL_ROUTE_PREFIX, TEMPORAL_ROUTES, TEMPORAL_SCHEMA_VERSION, assertValidTemporalRollbackPlanRequest, createTemporalClient, isReadOnlyTemporalHistory, temporalModeSupports, validateTemporalRollbackPlanRequest, } from "./temporal.js";

package/contract/pmtiles.d.ts

@@ -0,0 +1,193 @@
+/**
+ * PMTiles archive inspection for the protocol-neutral contract.
+ *
+ * A PMTiles archive is a single, immutable file (on object storage or any
+ * static host) that stores an entire raster or vector tile pyramid. It
+ * participates in the `Dataset` / `Source` model as a **tiles-only** protocol:
+ * the canonical query family throws {@link HonuaCapabilityNotSupportedError}
+ * (there is no feature-query surface on an archive), while archive metadata —
+ * bounds, min/max zoom, and vector layer names — is inspected through
+ * `Source.protocol("pmtiles").describe()`.
+ *
+ * This module never statically imports the `pmtiles` package. The reader is
+ * pulled in lazily (`await import("pmtiles")`) the first time an archive is
+ * actually described, mirroring the Cesium adapter so consumers that never
+ * touch PMTiles pay zero bundle cost. A minimal `pmtiles` module slice is
+ * modelled here so the wiring stays unit-testable against an injected fake
+ * without a network fetch.
+ *
+ * @module
+ */
+import type { ProtocolModule } from "./protocol-module.js";
+/**
+ * Canonical tile-payload kinds a PMTiles archive can store. `mvt` is a vector
+ * archive (Mapbox Vector Tiles); the rest are raster encodings. `unknown`
+ * covers archives whose header tile-type byte the reader could not classify.
+ */
+export type PmtilesTileKind = "mvt" | "png" | "jpeg" | "webp" | "avif" | "unknown";
+/**
+ * One vector layer advertised in a vector archive's TileJSON-style metadata
+ * (`vector_layers`). Present only for `mvt` archives; raster archives report an
+ * empty {@link PmtilesArchiveDescription.vectorLayers} list.
+ */
+export interface PmtilesVectorLayerInfo {
+    /** Layer id — the MapLibre `source-layer` name to reference in a style. */
+    readonly id: string;
+    /** Optional human description carried in the archive metadata. */
+    readonly description?: string;
+    /** Optional per-layer minimum zoom advertised in the metadata. */
+    readonly minZoom?: number;
+    /** Optional per-layer maximum zoom advertised in the metadata. */
+    readonly maxZoom?: number;
+    /** Optional field-name → type map advertised in the metadata. */
+    readonly fields?: Readonly<Record<string, string>>;
+}
+/**
+ * The archive metadata surfaced by {@link describePmtilesArchive}. Bounds are
+ * `[west, south, east, north]` in degrees; `center` is `[lon, lat, zoom]`. The
+ * raw metadata JSON is preserved on `metadata` for callers that need archive
+ * fields beyond the normalized shape.
+ */
+export interface PmtilesArchiveDescription {
+    /** Archive URL the description was read from. */
+    readonly url: string;
+    /** Tile payload kind stored in the archive. */
+    readonly tileKind: PmtilesTileKind;
+    /** Geographic bounds `[west, south, east, north]` in degrees. */
+    readonly bounds: readonly [number, number, number, number];
+    /** Lowest zoom level present in the archive. */
+    readonly minZoom: number;
+    /** Highest zoom level present in the archive. */
+    readonly maxZoom: number;
+    /** Suggested view center `[lon, lat, zoom]`. */
+    readonly center: readonly [number, number, number];
+    /** Vector layer definitions (empty for raster archives). */
+    readonly vectorLayers: readonly PmtilesVectorLayerInfo[];
+    /** Attribution string advertised in the archive metadata, when present. */
+    readonly attribution?: string;
+    /** The raw, parsed archive metadata JSON. */
+    readonly metadata: Readonly<Record<string, unknown>>;
+}
+/** A byte-range response from a {@link PmtilesSourceLike}. */
+export interface PmtilesRangeResponse {
+    readonly data: ArrayBuffer;
+    readonly etag?: string;
+}
+/**
+ * The `pmtiles` `Source` surface — a byte-range reader over the archive. A
+ * remote archive uses the reader's own `FetchSource`; a local fixture (tests)
+ * supplies a buffer-backed implementation.
+ */
+export interface PmtilesSourceLike {
+    getBytes(offset: number, length: number, signal?: AbortSignal, etag?: string): Promise<PmtilesRangeResponse>;
+    getKey(): string;
+}
+/** The `Header` fields this module reads (a subset of `pmtiles.Header`). */
+export interface PmtilesHeaderLike {
+    readonly minZoom: number;
+    readonly maxZoom: number;
+    readonly minLon: number;
+    readonly minLat: number;
+    readonly maxLon: number;
+    readonly maxLat: number;
+    readonly centerZoom: number;
+    readonly centerLon: number;
+    readonly centerLat: number;
+    readonly tileType: number;
+}
+/** The `PMTiles` reader surface this module drives. */
+export interface PmtilesArchiveLike {
+    getHeader(): Promise<PmtilesHeaderLike>;
+    getMetadata(): Promise<unknown>;
+}
+/** The minimal slice of `typeof import("pmtiles")` the describe path needs. */
+export interface PmtilesModuleLike {
+    new (source: PmtilesSourceLike | string): PmtilesArchiveLike;
+}
+/** Injectable dependencies for {@link describePmtilesArchive} (test seams). */
+export interface DescribePmtilesArchiveDeps {
+    /** Override the lazily-imported `pmtiles.PMTiles` constructor. */
+    readonly PMTiles?: PmtilesModuleLike;
+    /** Read from a local/in-memory source instead of fetching `url`. */
+    readonly source?: PmtilesSourceLike;
+}
+/**
+ * Inspect a PMTiles archive and return its normalized metadata (bounds, min/max
+ * zoom, suggested center, and vector layer names). The `pmtiles` reader is
+ * imported lazily on first use.
+ *
+ * Pass {@link DescribePmtilesArchiveDeps.source} to read a local archive (the
+ * unit-test path) or {@link DescribePmtilesArchiveDeps.PMTiles} to inject a fake
+ * reader; both default to fetching `url` through the real reader.
+ *
+ * @example
+ * ```ts
+ * const info = await describePmtilesArchive("https://example.com/basemap.pmtiles");
+ * console.log(info.bounds, info.minZoom, info.maxZoom);
+ * for (const layer of info.vectorLayers) console.log(layer.id);
+ * ```
+ */
+export declare function describePmtilesArchive(url: string, deps?: DescribePmtilesArchiveDeps): Promise<PmtilesArchiveDescription>;
+/**
+ * Typed adapter handle for a PMTiles archive, reachable through
+ * `Source.protocol("pmtiles")`. Provides the archive-metadata inspection
+ * surface ({@link HonuaPmtilesArchive.describe}) that the tiles-only PMTiles
+ * `Source` uses to participate in the Dataset model honestly. The first
+ * `describe()` call is cached so repeated inspection does not re-open the
+ * archive.
+ */
+export declare class HonuaPmtilesArchive {
+    #private;
+    /** The `pmtiles://`-free archive URL this handle inspects. */
+    readonly url: string;
+    constructor(url: string, deps?: DescribePmtilesArchiveDeps);
+    /**
+     * Inspect the archive and return its normalized metadata. Cached after the
+     * first successful call; a failed inspection is not cached so a transient
+     * fetch error can be retried.
+     */
+    describe(): Promise<PmtilesArchiveDescription>;
+}
+/**
+ * Strip a leading `pmtiles://` scheme from an archive URL, if present. MapLibre
+ * style sources address PMTiles archives as `pmtiles://https://…`; the reader
+ * (and this contract's describe path) want the bare archive URL.
+ */
+export declare function stripPmtilesScheme(url: string): string;
+/**
+ * Add the `pmtiles://` scheme to a bare archive URL if it is not already
+ * present. The inverse of {@link stripPmtilesScheme}; use it when composing a
+ * MapLibre source `url` from a plain archive locator.
+ */
+export declare function toPmtilesSourceUrl(url: string): string;
+/**
+ * The first-party PMTiles {@link ProtocolModule} (issue #538).
+ *
+ * `pmtilesSource()` (`src/contract/source.ts`) builds its
+ * `Source.protocol("pmtiles")` escape hatch through this exact factory
+ * instead of constructing {@link HonuaPmtilesArchive} directly, and
+ * `pmtilesProtocolPlugin` (`@honua/sdk-js/plugin`) packages the same factory
+ * as a `HonuaPluginFactory<"protocol">` for `HonuaPluginRegistry`. Both
+ * callers run the identical construction path, which is what proves the
+ * built-in adapter carries no special registry privilege.
+ *
+ * `discover()` is synchronous: PMTiles opens its reader lazily on the
+ * returned handle's own first `describe()` call, so no I/O happens before a
+ * caller actually asks for archive metadata (REQ-003, issue #538).
+ *
+ * @example
+ * ```ts
+ * const module = pmtilesProtocolModule();
+ * const handle = module.discover({
+ *   id: "basemap",
+ *   protocol: "pmtiles",
+ *   locator: { url: "https://example.com/basemap.pmtiles" },
+ * });
+ * if (!(handle instanceof Promise)) {
+ *   const info = await handle.adapter.describe();
+ *   console.log(info.bounds);
+ * }
+ * ```
+ */
+export declare function pmtilesProtocolModule(deps?: DescribePmtilesArchiveDeps): ProtocolModule<"pmtiles", HonuaPmtilesArchive>;
+//# sourceMappingURL=pmtiles.d.ts.map

package/contract/pmtiles.d.ts.map

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

package/contract/pmtiles.js

@@ -0,0 +1,195 @@
+import { PROTOCOL_DEFAULT_CAPABILITIES } from "./types.js";
+/**
+ * Lazily import the `pmtiles` reader. Kept in its own function so the dynamic
+ * `import("pmtiles")` is the only reference to the package in `src/`, which is
+ * what keeps PMTiles out of every bundle that never inspects an archive.
+ */
+async function loadPmtilesCtor() {
+    const mod = (await import("pmtiles"));
+    return mod.PMTiles;
+}
+/**
+ * The `pmtiles` `TileType` enum values (spec v3). Duplicated here as a plain
+ * map so classification does not force a value import of the package.
+ */
+const TILE_KIND_BY_TYPE = {
+    0: "unknown",
+    1: "mvt",
+    2: "png",
+    3: "jpeg",
+    4: "webp",
+    5: "avif",
+};
+function tileKindFromHeader(tileType) {
+    return TILE_KIND_BY_TYPE[tileType] ?? "unknown";
+}
+function readVectorLayers(metadata) {
+    const raw = metadata.vector_layers;
+    if (!Array.isArray(raw))
+        return [];
+    const layers = [];
+    for (const entry of raw) {
+        if (!entry || typeof entry !== "object")
+            continue;
+        const record = entry;
+        const id = record.id;
+        if (typeof id !== "string" || id === "")
+            continue;
+        const info = { id };
+        if (typeof record.description === "string")
+            info.description = record.description;
+        if (typeof record.minzoom === "number")
+            info.minZoom = record.minzoom;
+        if (typeof record.maxzoom === "number")
+            info.maxZoom = record.maxzoom;
+        if (record.fields && typeof record.fields === "object") {
+            info.fields = record.fields;
+        }
+        layers.push(info);
+    }
+    return layers;
+}
+function asMetadataRecord(metadata) {
+    return metadata && typeof metadata === "object" ? metadata : {};
+}
+/**
+ * Inspect a PMTiles archive and return its normalized metadata (bounds, min/max
+ * zoom, suggested center, and vector layer names). The `pmtiles` reader is
+ * imported lazily on first use.
+ *
+ * Pass {@link DescribePmtilesArchiveDeps.source} to read a local archive (the
+ * unit-test path) or {@link DescribePmtilesArchiveDeps.PMTiles} to inject a fake
+ * reader; both default to fetching `url` through the real reader.
+ *
+ * @example
+ * ```ts
+ * const info = await describePmtilesArchive("https://example.com/basemap.pmtiles");
+ * console.log(info.bounds, info.minZoom, info.maxZoom);
+ * for (const layer of info.vectorLayers) console.log(layer.id);
+ * ```
+ */
+export async function describePmtilesArchive(url, deps = {}) {
+    const PMTiles = deps.PMTiles ?? (await loadPmtilesCtor());
+    const archive = deps.source ? new PMTiles(deps.source) : new PMTiles(url);
+    const [header, rawMetadata] = await Promise.all([archive.getHeader(), archive.getMetadata()]);
+    const metadata = asMetadataRecord(rawMetadata);
+    const attribution = typeof metadata.attribution === "string" ? metadata.attribution : undefined;
+    return {
+        url,
+        tileKind: tileKindFromHeader(header.tileType),
+        bounds: [header.minLon, header.minLat, header.maxLon, header.maxLat],
+        minZoom: header.minZoom,
+        maxZoom: header.maxZoom,
+        center: [header.centerLon, header.centerLat, header.centerZoom],
+        vectorLayers: readVectorLayers(metadata),
+        ...(attribution ? { attribution } : {}),
+        metadata,
+    };
+}
+/**
+ * Typed adapter handle for a PMTiles archive, reachable through
+ * `Source.protocol("pmtiles")`. Provides the archive-metadata inspection
+ * surface ({@link HonuaPmtilesArchive.describe}) that the tiles-only PMTiles
+ * `Source` uses to participate in the Dataset model honestly. The first
+ * `describe()` call is cached so repeated inspection does not re-open the
+ * archive.
+ */
+export class HonuaPmtilesArchive {
+    /** The `pmtiles://`-free archive URL this handle inspects. */
+    url;
+    #deps;
+    #description;
+    constructor(url, deps = {}) {
+        this.url = url;
+        this.#deps = deps;
+    }
+    /**
+     * Inspect the archive and return its normalized metadata. Cached after the
+     * first successful call; a failed inspection is not cached so a transient
+     * fetch error can be retried.
+     */
+    describe() {
+        if (!this.#description) {
+            this.#description = describePmtilesArchive(this.url, this.#deps).catch((error) => {
+                this.#description = undefined;
+                throw error;
+            });
+        }
+        return this.#description;
+    }
+}
+/**
+ * Strip a leading `pmtiles://` scheme from an archive URL, if present. MapLibre
+ * style sources address PMTiles archives as `pmtiles://https://…`; the reader
+ * (and this contract's describe path) want the bare archive URL.
+ */
+export function stripPmtilesScheme(url) {
+    return url.startsWith("pmtiles://") ? url.slice("pmtiles://".length) : url;
+}
+/**
+ * Add the `pmtiles://` scheme to a bare archive URL if it is not already
+ * present. The inverse of {@link stripPmtilesScheme}; use it when composing a
+ * MapLibre source `url` from a plain archive locator.
+ */
+export function toPmtilesSourceUrl(url) {
+    return url.startsWith("pmtiles://") ? url : `pmtiles://${url}`;
+}
+function requirePmtilesModuleLocator(descriptor) {
+    const { url } = descriptor.locator;
+    if (typeof url !== "string" || url === "") {
+        throw new Error(`createDataset: source "${descriptor.id}" (pmtiles) requires locator.url`);
+    }
+    return url;
+}
+/**
+ * The first-party PMTiles {@link ProtocolModule} (issue #538).
+ *
+ * `pmtilesSource()` (`src/contract/source.ts`) builds its
+ * `Source.protocol("pmtiles")` escape hatch through this exact factory
+ * instead of constructing {@link HonuaPmtilesArchive} directly, and
+ * `pmtilesProtocolPlugin` (`@honua/sdk-js/plugin`) packages the same factory
+ * as a `HonuaPluginFactory<"protocol">` for `HonuaPluginRegistry`. Both
+ * callers run the identical construction path, which is what proves the
+ * built-in adapter carries no special registry privilege.
+ *
+ * `discover()` is synchronous: PMTiles opens its reader lazily on the
+ * returned handle's own first `describe()` call, so no I/O happens before a
+ * caller actually asks for archive metadata (REQ-003, issue #538).
+ *
+ * @example
+ * ```ts
+ * const module = pmtilesProtocolModule();
+ * const handle = module.discover({
+ *   id: "basemap",
+ *   protocol: "pmtiles",
+ *   locator: { url: "https://example.com/basemap.pmtiles" },
+ * });
+ * if (!(handle instanceof Promise)) {
+ *   const info = await handle.adapter.describe();
+ *   console.log(info.bounds);
+ * }
+ * ```
+ */
+export function pmtilesProtocolModule(deps = {}) {
+    return Object.freeze({
+        kind: "pmtiles",
+        environments: Object.freeze(["browser", "node", "worker"]),
+        capabilities(descriptor) {
+            return descriptor.capabilities ?? PROTOCOL_DEFAULT_CAPABILITIES.pmtiles;
+        },
+        discover(descriptor) {
+            const url = stripPmtilesScheme(requirePmtilesModuleLocator(descriptor));
+            const archive = new HonuaPmtilesArchive(url, deps);
+            return Object.freeze({
+                descriptor,
+                capabilities: descriptor.capabilities ?? PROTOCOL_DEFAULT_CAPABILITIES.pmtiles,
+                adapter: archive,
+                diagnostics: Object.freeze([]),
+                dispose() {
+                    // The archive holds no open handles between describe() calls;
+                    // disposal is deterministic and synchronous with nothing to release.
+                },
+            });
+        },
+    });
+}

package/contract/protocol-module.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Minimal protocol-module composition (issue #538).
+ *
+ * `RendererAdapter` (`src/kernel/renderer.ts`) is the accepted, plain,
+ * injectable seam every mounted renderer satisfies — first-party
+ * (`maplibreRenderer`) and an external, non-Web-Mercator renderer plugin
+ * (issue #566) alike — without the kernel importing the plugin SDK or
+ * maintaining a privileged construction path. `ProtocolModule` is the
+ * equivalent minimal
+ * seam for a `Source.protocol(...)` escape-hatch adapter: discovery, the
+ * capability set it advertises for a descriptor, diagnostics, and
+ * disposal. `compile`/`execute` are intentionally absent from this first
+ * bounded slice — no first-party module has migrated its query-compiler
+ * pipeline onto the seam yet (see `docs/plugin-manifest-certification.md`
+ * for the tracked follow-up).
+ *
+ * This module has no dependency on `src/plugin` or any global registry: a
+ * `ProtocolModule` is a plain value object. SDK-internal `Source`
+ * construction (for example `pmtilesSource()`) and a module packaged as a
+ * `HonuaPluginFactory<"protocol">` for `HonuaPluginRegistry`
+ * (`src/plugin/pmtiles-protocol-plugin.ts`) both consume exactly this shape,
+ * which is what proves the built-in adapter carries no special registry
+ * privilege.
+ *
+ * @module
+ */
+import type { Capabilities, SourceDescriptor } from "./types.js";
+/** Runtime environments a protocol module can execute in. Mirrors `RendererEnvironment`. */
+export type ProtocolModuleEnvironment = "browser" | "node" | "worker";
+/** Stable, protocol-neutral diagnostic exposed by one discovered module handle. */
+export interface ProtocolModuleDiagnostic {
+    readonly code: string;
+    readonly severity: "info" | "warning" | "error";
+    readonly message: string;
+}
+export interface ProtocolModuleDiscoverOptions {
+    readonly signal?: AbortSignal;
+}
+/**
+ * One discovered, disposable protocol-module handle bound to a source
+ * descriptor. `adapter` is the same typed escape-hatch value historically
+ * returned by `Source.protocol(name)` (for example a `HonuaPmtilesArchive`),
+ * so migrating a built-in onto this seam never changes what callers observe
+ * through the existing escape hatch.
+ */
+export interface ProtocolModuleHandle<TAdapter = unknown> {
+    readonly descriptor: SourceDescriptor;
+    readonly capabilities: Capabilities;
+    readonly adapter: TAdapter;
+    readonly diagnostics: readonly ProtocolModuleDiagnostic[];
+    dispose(): void | Promise<void>;
+}
+/**
+ * Minimal executable protocol seam. Heavy peers are injected as values
+ * (`peer`) and are never imported by SDK core; discovery stays lazy so a
+ * module that is registered but never discovered pays no I/O or peer-import
+ * cost. `discover` may return synchronously when construction needs no I/O
+ * (as PMTiles does — the archive itself is opened lazily on first
+ * `describe()`), or asynchronously for a module whose discovery is
+ * inherently a network round trip.
+ */
+export interface ProtocolModule<TKind extends string = string, TAdapter = unknown> {
+    readonly kind: TKind;
+    readonly environments: readonly ProtocolModuleEnvironment[];
+    readonly peer?: unknown;
+    /** Pure and synchronous: never performs I/O. */
+    capabilities(descriptor: SourceDescriptor): Capabilities;
+    discover(descriptor: SourceDescriptor, options?: ProtocolModuleDiscoverOptions): ProtocolModuleHandle<TAdapter> | Promise<ProtocolModuleHandle<TAdapter>>;
+}
+//# sourceMappingURL=protocol-module.d.ts.map

package/contract/protocol-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-module.d.ts","sourceRoot":"","sources":["../../../src/contract/protocol-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjE,4FAA4F;AAC5F,MAAM,MAAM,yBAAyB,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEtE,mFAAmF;AACnF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB,CAAC,QAAQ,GAAG,OAAO;IACtD,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC1D,OAAO,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAAE,QAAQ,GAAG,OAAO;IAC/E,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,YAAY,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,gDAAgD;IAChD,YAAY,CAAC,UAAU,EAAE,gBAAgB,GAAG,YAAY,CAAC;IACzD,QAAQ,CACN,UAAU,EAAE,gBAAgB,EAC5B,OAAO,CAAC,EAAE,6BAA6B,GACtC,oBAAoB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC;CAC7E"}

package/contract/protocol-module.js

@@ -0,0 +1 @@
+export {};

package/contract/schema-envelope.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Lightweight SourceSchemaV2 envelope checks for generic consumers.
+ *
+ * This module intentionally does not validate schema contents or recompute the
+ * fingerprint. Full validation belongs to the focused `/source-schema`
+ * ingestion and cache boundaries. Generic discovery uses this only as a
+ * bounded transport-envelope check; it does not establish trusted identity.
+ *
+ */
+export declare const SOURCE_SCHEMA_V2_KIND: "honua.source-schema";
+export declare const SOURCE_SCHEMA_V2_VERSION: "2.0";
+/**
+ * Stable, lightweight transport envelope for an opt-in source schema.
+ *
+ * The generic contract deliberately exposes only identity metadata. Consumers
+ * that need fields, geometry, or other schema semantics must enter through the
+ * focused `@honua/sdk-js/source-schema` subpath, which validates the complete
+ * value and exposes {@link SourceSchemaV2} there.
+ */
+export interface SourceSchemaV2Envelope {
+    readonly kind: typeof SOURCE_SCHEMA_V2_KIND;
+    readonly version: typeof SOURCE_SCHEMA_V2_VERSION;
+    readonly fingerprint: `sha256:${string}`;
+}
+export declare function sourceSchemaV2EnvelopeFingerprint(value: unknown): SourceSchemaV2Envelope["fingerprint"];
+//# sourceMappingURL=schema-envelope.d.ts.map

package/contract/schema-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-envelope.d.ts","sourceRoot":"","sources":["../../../src/contract/schema-envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,qBAAqB,EAAG,qBAA8B,CAAC;AACpE,eAAO,MAAM,wBAAwB,EAAG,KAAc,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,OAAO,qBAAqB,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,OAAO,wBAAwB,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,UAAU,MAAM,EAAE,CAAC;CAC1C;AAID,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAAC,aAAa,CAAC,CAYvG"}

package/contract/schema-envelope.js

@@ -0,0 +1,25 @@
+/**
+ * Lightweight SourceSchemaV2 envelope checks for generic consumers.
+ *
+ * This module intentionally does not validate schema contents or recompute the
+ * fingerprint. Full validation belongs to the focused `/source-schema`
+ * ingestion and cache boundaries. Generic discovery uses this only as a
+ * bounded transport-envelope check; it does not establish trusted identity.
+ *
+ */
+export const SOURCE_SCHEMA_V2_KIND = "honua.source-schema";
+export const SOURCE_SCHEMA_V2_VERSION = "2.0";
+const SOURCE_SCHEMA_V2_FINGERPRINT = /^sha256:[0-9a-f]{64}$/;
+export function sourceSchemaV2EnvelopeFingerprint(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new TypeError("SourceSchemaV2 must be an object");
+    }
+    const record = value;
+    if (record.kind !== SOURCE_SCHEMA_V2_KIND || record.version !== SOURCE_SCHEMA_V2_VERSION) {
+        throw new TypeError(`SourceSchemaV2 must use ${SOURCE_SCHEMA_V2_KIND}@${SOURCE_SCHEMA_V2_VERSION}`);
+    }
+    if (typeof record.fingerprint !== "string" || !SOURCE_SCHEMA_V2_FINGERPRINT.test(record.fingerprint)) {
+        throw new TypeError("SourceSchemaV2 fingerprint must be a lowercase SHA-256 digest");
+    }
+    return record.fingerprint;
+}