@honua/app-platform 0.0.20-alpha.0

package/contract/tiles.d.ts

@@ -0,0 +1,370 @@
+/**
+ * Dynamic vector/query tile contract primitives.
+ *
+ * The runtime helpers in `src/runtime/query-tiles.ts` use these types to
+ * describe query-backed vector tile sources without tying the contract to
+ * MapLibre. The descriptor is intentionally serializable except for the
+ * optional feature identity hook.
+ *
+ * @module
+ */
+import type { HonuaTypedFeature } from "../core/types.js";
+import type { AnalyticsSourceDescriptor } from "./analytics-sources.js";
+import type { FeatureId, Protocol, Query, Source, SourceDescriptor, SourceId } from "./types.js";
+export type QueryTileFormat = "mvt" | "geojson";
+export type QueryTileScheme = "xyz" | "tms";
+export type QueryTileFallbackMode = "disabled" | "query-bbox" | "geojson-source";
+export type QueryTileServerRouteKind = "tilejson" | "tile" | "feature-detail";
+export type QueryTileServerDegradationSeverity = "info" | "warning" | "error";
+export type QueryTileServerDegradationCode = "empty-tile" | "geometry-simplified" | "max-features-exceeded" | "partial-results" | "fallback-query" | "stale-cache" | "unsupported-sr" | "authorization-filtered";
+export type QueryTileServerErrorCode = "bad-request" | "unauthorized" | "forbidden" | "not-found" | "not-acceptable" | "unsupported-sr" | "tile-out-of-range" | "max-features-exceeded" | "timeout" | "rate-limited" | "server-error" | "unavailable";
+export declare const QUERY_TILE_SERVER_CONTRACT_VERSION = 1;
+export declare const QUERY_TILE_SERVER_ROUTE_PREFIX = "query-tiles";
+export declare const QUERY_TILE_SERVER_SOURCE_ROUTE_TEMPLATE = "sources/{sourceId}";
+export declare const QUERY_TILE_SERVER_TILEJSON_ROUTE_TEMPLATE = "sources/{sourceId}/tilejson.json";
+export declare const QUERY_TILE_SERVER_TILE_ROUTE_TEMPLATE = "sources/{sourceId}/tiles/{z}/{x}/{y}.{format}";
+export declare const QUERY_TILE_SERVER_FEATURE_DETAIL_ROUTE_TEMPLATE = "sources/{sourceId}/features/{featureId}";
+export declare const QUERY_TILE_SERVER_RESPONSE_HEADERS: {
+    readonly cacheControl: "Cache-Control";
+    readonly etag: "ETag";
+    readonly lastModified: "Last-Modified";
+    readonly vary: "Vary";
+    readonly sourceVersion: "X-Honua-Source-Version";
+    readonly featureCount: "X-Honua-Feature-Count";
+    readonly maxFeatures: "X-Honua-Max-Features";
+    readonly degraded: "X-Honua-Degraded";
+};
+/** Slippy-map tile coordinate in XYZ order. */
+export interface QueryTileKey {
+    z: number;
+    x: number;
+    y: number;
+}
+/** Accepts XYZ field names plus OGC-style tile matrix aliases. */
+export interface QueryTileKeyInput {
+    z?: number | string;
+    x?: number | string;
+    y?: number | string;
+    tileMatrix?: number | string;
+    tileCol?: number | string;
+    tileRow?: number | string;
+}
+/** Tile endpoint hints. `urlTemplate` wins over `tilejsonUrl` and `baseUrl`. */
+export interface QueryTileEndpointDescriptor {
+    /** URL template containing `{z}`, `{x}`, and `{y}` placeholders. */
+    urlTemplate?: string;
+    /** Server-hosted TileJSON URL, if discovery is already available. */
+    tilejsonUrl?: string;
+    /**
+     * Query-tile service root used when constructing a URL template. The
+     * canonical server route under this root is
+     * `sources/{sourceId}/tiles/{z}/{x}/{y}.mvt`.
+     */
+    baseUrl?: string;
+    /** Relative tile path under `baseUrl`. Defaults to the canonical source tile route. */
+    path?: string;
+}
+/** SQL/query projection that must participate in cache identity. */
+export interface QueryTileProjectionDescriptor {
+    /** Fields needed by styling and interactions. */
+    fields?: readonly string[];
+    /** Whether tile payloads should include feature geometry. Defaults to true. */
+    returnGeometry?: boolean;
+    /** Optional server simplification tolerance hint. */
+    simplifyTolerance?: number;
+}
+/** Caller-controlled cache dimensions beyond the tile coordinate. */
+export interface QueryTileCacheIdentityDescriptor {
+    /** Server-side source data version, etag, cursor, or materialized view id. */
+    sourceVersion?: string;
+    /** Authorization partition, role set, tenant id, or other non-secret auth scope id. */
+    authorizationScope?: string;
+    /** Style-relevant filters that alter which features are rendered. */
+    styleFilters?: unknown;
+    /** Extra stable dimensions owned by an adapter. */
+    extra?: Readonly<Record<string, unknown>>;
+}
+export interface QueryTileCachePolicy {
+    /** Maximum cached tile payloads. Defaults are runtime-controller specific. */
+    maxEntries?: number;
+    /** Time-to-live in milliseconds. Omit for no TTL. */
+    ttlMs?: number;
+    /** Cache key dimensions that are not already present on the descriptor. */
+    key?: QueryTileCacheIdentityDescriptor;
+}
+export interface QueryTileFallbackPolicy {
+    mode: QueryTileFallbackMode;
+    reason?: string;
+}
+export interface QueryTileSpatialReferenceDescriptor {
+    wkid?: number;
+    latestWkid?: number;
+    wkt?: string;
+    authority?: string;
+}
+export type QueryTileSpatialReference = number | string | QueryTileSpatialReferenceDescriptor;
+export interface QueryTileExtentDescriptor {
+    xmin: number;
+    ymin: number;
+    xmax: number;
+    ymax: number;
+    spatialReference?: QueryTileSpatialReference;
+}
+export interface QueryTileServerRequestParameters {
+    where?: string;
+    outFields?: string | readonly string[];
+    returnGeometry?: boolean;
+    outSr?: string | number;
+    tileMatrixSet?: string;
+    extent?: readonly [number, number, number, number] | QueryTileExtentDescriptor;
+    extentSr?: string | number;
+    projection?: string | readonly string[];
+    projectionReturnGeometry?: boolean;
+    simplifyTolerance?: number;
+    maxFeatures?: number;
+    cacheKey?: string;
+    cacheBust?: string;
+}
+export interface QueryTileServerRouteOptions<T = Record<string, unknown>> {
+    baseUrl?: string;
+    routePrefix?: string;
+    sourceId: SourceId;
+    tileKey?: QueryTileKeyInput;
+    featureId?: FeatureId;
+    format?: QueryTileFormat;
+    query?: Omit<Query<T>, "signal">;
+    projection?: QueryTileProjectionDescriptor;
+    params?: QueryTileServerRequestParameters;
+    extraParams?: Readonly<Record<string, string | number | boolean | undefined>>;
+}
+export interface QueryTileServerCacheValidators {
+    etag?: string;
+    lastModified?: string;
+    cacheControl?: string;
+    expires?: string;
+    vary?: string;
+    sourceVersion?: string;
+}
+export interface QueryTileServerCachePolicyDescriptor {
+    validators: readonly ("etag" | "last-modified")[];
+    cacheControl?: string;
+    vary?: readonly string[];
+    sourceVersion?: string;
+}
+export interface QueryTileServerLimitDescriptor {
+    maxFeaturesPerTile?: number;
+    maxFeaturesPerDetail?: number;
+    defaultSimplifyTolerance?: number;
+    maxSimplifyTolerance?: number;
+}
+export interface QueryTileServerFeatureIdentityDescriptor {
+    sourceId: SourceId;
+    idProperty: string | readonly string[];
+    sourceLayer?: string;
+    sourceIdProperty?: string;
+    sourceLayerProperty?: string;
+    promoteId?: string | Readonly<Record<string, string>>;
+    detailUrlTemplate?: string;
+}
+export interface QueryTileServerDegradation {
+    code: QueryTileServerDegradationCode;
+    severity: QueryTileServerDegradationSeverity;
+    message: string;
+    sourceId?: SourceId;
+    tileKey?: QueryTileKey;
+    maxFeatures?: number;
+    returnedFeatures?: number;
+    omittedFeatures?: number;
+    simplifyTolerance?: number;
+    retryAfterMs?: number;
+    details?: Readonly<Record<string, unknown>>;
+}
+export interface QueryTileServerTileJsonMetadata {
+    contractVersion: number;
+    sourceId: SourceId;
+    tileMatrixSet: string;
+    format: QueryTileFormat;
+    spatialReference: QueryTileSpatialReference;
+    extent?: QueryTileExtentDescriptor;
+    requestParameters?: QueryTileServerRequestParameters;
+    featureIdentity: QueryTileServerFeatureIdentityDescriptor;
+    detailUrlTemplate: string;
+    cache?: QueryTileServerCachePolicyDescriptor;
+    limits?: QueryTileServerLimitDescriptor;
+    degraded?: readonly QueryTileServerDegradation[];
+}
+export interface QueryTileFeatureDetailResponse<T = Record<string, unknown>> {
+    contractVersion: number;
+    identity: QueryTileFeatureIdentityTarget;
+    found: boolean;
+    feature: HonuaTypedFeature<T> | null;
+    cache?: QueryTileServerCacheValidators;
+    degraded?: readonly QueryTileServerDegradation[];
+}
+export interface QueryTileServerError {
+    code: QueryTileServerErrorCode;
+    message: string;
+    status?: number;
+    requestId?: string;
+    retryAfterMs?: number;
+    degraded?: readonly QueryTileServerDegradation[];
+    details?: Readonly<Record<string, unknown>>;
+}
+export interface QueryTileServerErrorResponse {
+    contractVersion: number;
+    error: QueryTileServerError;
+}
+export interface QueryTileServerContractFixture<T = Record<string, unknown>> {
+    schemaVersion: number;
+    routePrefix: string;
+    routes: Readonly<Record<QueryTileServerRouteKind, string>>;
+    requestParameters: QueryTileServerRequestParameters;
+    tilejsonResponse: QueryTileJson;
+    detailResponse: QueryTileFeatureDetailResponse<T>;
+    errorResponse: QueryTileServerErrorResponse;
+}
+export interface QueryTileFeatureIdentityTarget {
+    sourceId: SourceId;
+    id: FeatureId;
+    sourceLayer?: string;
+    properties?: Readonly<Record<string, unknown>>;
+    feature?: unknown;
+}
+export interface QueryTileFeatureIdentityContext {
+    descriptor: QueryTileSourceDescriptor;
+    sourceId: SourceId;
+    sourceLayer?: string;
+    properties: Readonly<Record<string, unknown>>;
+}
+export type QueryTileFeatureIdentityMapper = (feature: unknown, context: QueryTileFeatureIdentityContext) => QueryTileFeatureIdentityTarget | undefined;
+export interface QueryTileFeatureIdentityDescriptor {
+    /**
+     * Property name(s) that carry canonical feature id. The first non-nullish
+     * value wins. When omitted, MapLibre `feature.id`, `id`, `OBJECTID`,
+     * `objectId`, and `fid` are tried in that order.
+     */
+    idProperty?: string | readonly string[];
+    /** Optional property that overrides the descriptor's canonical source id. */
+    sourceIdProperty?: string;
+    /** Optional property that carries the vector source-layer id. */
+    sourceLayerProperty?: string;
+    /** MapLibre `promoteId` value to expose on the generated source spec. */
+    promoteId?: string | Readonly<Record<string, string>>;
+    /** Last-mile hook for protocols whose tile feature shape is not property based. */
+    mapFeature?: QueryTileFeatureIdentityMapper;
+}
+export interface QueryTileSourceDescriptor<T = Record<string, unknown>> {
+    kind: "query-vector-tile";
+    /** Runtime / MapLibre source id for this dynamic tiled source. */
+    id: SourceId;
+    /** Canonical source id used by selection, detail lookup, and feature state. */
+    sourceId: SourceId;
+    /** Optional canonical source descriptor this tiled source is derived from. */
+    source?: SourceDescriptor;
+    /** Optional warehouse/indexed analytics descriptor this tiled source is derived from. */
+    analyticsSource?: AnalyticsSourceDescriptor;
+    /** Protocol override when `source` is not provided. */
+    protocol?: Protocol;
+    endpoint?: QueryTileEndpointDescriptor;
+    /** Server-generated TileJSON metadata, if already available. */
+    tilejson?: QueryTileJson;
+    tileMatrixSet?: string;
+    format?: QueryTileFormat;
+    scheme?: QueryTileScheme;
+    tileSize?: number;
+    minzoom?: number;
+    maxzoom?: number;
+    bounds?: readonly [number, number, number, number];
+    query?: Omit<Query<T>, "signal">;
+    projection?: QueryTileProjectionDescriptor;
+    cache?: QueryTileCachePolicy;
+    featureIdentity?: QueryTileFeatureIdentityDescriptor;
+    fallback?: QueryTileFallbackPolicy;
+    attribution?: string;
+    metadata?: Readonly<Record<string, unknown>>;
+}
+export interface QueryTileJsonVectorLayer {
+    id: string;
+    fields?: Readonly<Record<string, string>>;
+    description?: string;
+    minzoom?: number;
+    maxzoom?: number;
+}
+/** Minimal TileJSON v3 shape used by MapLibre vector sources. */
+export interface QueryTileJson {
+    tilejson: "3.0.0";
+    tiles: readonly string[];
+    vector_layers?: readonly QueryTileJsonVectorLayer[];
+    name?: string;
+    description?: string;
+    attribution?: string;
+    scheme?: QueryTileScheme;
+    minzoom?: number;
+    maxzoom?: number;
+    bounds?: readonly [number, number, number, number];
+    center?: readonly [number, number, number];
+    "honua:queryTiles"?: QueryTileServerTileJsonMetadata;
+}
+export interface DefineQueryTileSourceOptions<T = Record<string, unknown>> extends Omit<QueryTileSourceDescriptor<T>, "kind" | "sourceId" | "source" | "analyticsSource" | "protocol"> {
+    /** Source id, source descriptor, or live Source handle to tile. */
+    source: SourceId | SourceDescriptor | AnalyticsSourceDescriptor | Source<T>;
+    /** Override the canonical source id inferred from `source`. */
+    sourceId?: SourceId;
+    /** Protocol override when `source` is a bare source id. */
+    protocol?: Protocol;
+}
+export interface QueryTileCacheKeyOptions {
+    cache?: QueryTileCacheIdentityDescriptor;
+    prefix?: string;
+}
+export interface QueryTileFeatureDetailOptions<T = Record<string, unknown>> {
+    source: Source<T>;
+    target: QueryTileFeatureIdentityTarget;
+    /**
+     * Canonical id field used to build the detail query. When omitted, the
+     * descriptor's string `featureIdentity.idProperty` is used.
+     */
+    idField?: string;
+    descriptor?: QueryTileSourceDescriptor<T>;
+    baseQuery?: Omit<Query<T>, "signal">;
+    outFields?: readonly string[];
+    returnGeometry?: boolean;
+    signal?: AbortSignal;
+    where?: string | ((target: QueryTileFeatureIdentityTarget) => string);
+}
+/** Build a canonical query-tile server path for TileJSON, MVT tiles, or detail lookup. */
+export declare function buildQueryTileServerPath<T = Record<string, unknown>>(kind: QueryTileServerRouteKind, options: QueryTileServerRouteOptions<T>): string;
+/** Build a canonical query-tile server URL and serialize supported query parameters. */
+export declare function buildQueryTileServerUrl<T = Record<string, unknown>>(kind: QueryTileServerRouteKind, options: QueryTileServerRouteOptions<T> & {
+    baseUrl: string;
+}): string;
+/** Project a descriptor's query/projection/cache-relevant dimensions into server query params. */
+export declare function queryTileServerRequestParamsFromDescriptor<T = Record<string, unknown>>(descriptor: QueryTileSourceDescriptor<T>, options?: Pick<QueryTileServerRouteOptions<T>, "params" | "query" | "projection">): QueryTileServerRequestParameters;
+/** Validate and return TileJSON that follows the dynamic query tile contract. */
+export declare function parseQueryTileJson(value: unknown): QueryTileJson;
+/** Validate and return the canonical feature-detail lookup response. */
+export declare function parseQueryTileFeatureDetailResponse<T = Record<string, unknown>>(value: unknown): QueryTileFeatureDetailResponse<T>;
+/** Validate and return the canonical query-tile server error envelope. */
+export declare function parseQueryTileServerErrorResponse(value: unknown): QueryTileServerErrorResponse;
+/** Build a normalized descriptor from a source id, descriptor, or Source handle. */
+export declare function defineQueryTileSource<T = Record<string, unknown>>(options: DefineQueryTileSourceOptions<T>): QueryTileSourceDescriptor<T>;
+/** Normalize defaults and validate the descriptor's stable identity fields. */
+export declare function normalizeQueryTileSourceDescriptor<T = Record<string, unknown>>(descriptor: QueryTileSourceDescriptor<T>): QueryTileSourceDescriptor<T>;
+/** Normalize XYZ / OGC tile aliases into a canonical, wrapped XYZ key. */
+export declare function normalizeQueryTileKey(input: QueryTileKeyInput): QueryTileKey;
+export declare function queryTileKeyString(input: QueryTileKeyInput): string;
+/**
+ * Build a stable cache key. The key includes tile coordinate, source id,
+ * protocol, tile matrix set, query, projection, style filters, source
+ * version, and authorization scope.
+ */
+export declare function buildQueryTileCacheKey<T = Record<string, unknown>>(descriptor: QueryTileSourceDescriptor<T>, tileKey: QueryTileKeyInput, options?: QueryTileCacheKeyOptions): string;
+/** Map a rendered tile feature back to canonical source + feature identity. */
+export declare function mapQueryTileFeatureIdentity<T = Record<string, unknown>>(descriptor: QueryTileSourceDescriptor<T>, feature: unknown): QueryTileFeatureIdentityTarget | undefined;
+/** Build the canonical Source.query() request for selected-tile-feature detail. */
+export declare function buildQueryTileFeatureDetailQuery<T = Record<string, unknown>>(options: QueryTileFeatureDetailOptions<T>): Query<T>;
+/** Load a selected tile feature through the canonical Source detail path. */
+export declare function loadQueryTileFeatureDetail<T = Record<string, unknown>>(options: QueryTileFeatureDetailOptions<T>): Promise<HonuaTypedFeature<T> | undefined>;
+/** Stable JSON for cache keys and diagnostics snapshots. */
+export declare function stableJson(value: unknown): string;
+//# sourceMappingURL=tiles.d.ts.map

package/contract/tiles.d.ts.map

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