@honua/app-platform 0.0.20-alpha.0 → 0.1.1-beta.0

package/core/wmts-capabilities.d.ts

@@ -1,82 +1,82 @@
-/**
- * WMTS 1.0.0 Capabilities parser. Hand-rolled, narrow-scope walker over
- * the `Capabilities` document advertised by honua-server (single
- * advertised TileMatrixSet today: `WebMercatorQuad`). Yields a typed
- * `WmtsCapabilities` shape so the SDK can route through the canonical
- * `Source` surface without leaking XML.
- *
- * @module
- */
-/**
- * Top-level WMTS Capabilities surface.
- */
+/** Bounded WMTS 1.0 capabilities projection. @module */
+import { HonuaSdkError } from "./error-envelope.js";
 export interface WmtsCapabilities {
-    /** Protocol version. honua-server advertises `1.0.0`. */
-    version: string;
-    service: WmtsCapabilitiesService;
-    layers: ReadonlyArray<WmtsCapabilityLayer>;
-    tileMatrixSets: ReadonlyArray<WmtsCapabilityTileMatrixSet>;
+    readonly version: string;
+    readonly service: WmtsCapabilitiesService;
+    readonly layers: ReadonlyArray<WmtsCapabilityLayer>;
+    readonly tileMatrixSets: ReadonlyArray<WmtsCapabilityTileMatrixSet>;
+    readonly operations: readonly WmtsCapabilityOperation[];
+    /** Optional metadata entries ignored because they were malformed. */
+    readonly warnings: readonly string[];
 }
 export interface WmtsCapabilitiesService {
-    title?: string;
-    abstract?: string;
+    readonly title?: string;
+    readonly abstract?: string;
+}
+export interface WmtsCapabilityOperation {
+    readonly name: string;
+    readonly methods: readonly ("GET" | "POST")[];
+    readonly getUrls: readonly string[];
+    readonly postUrls: readonly string[];
 }
 export interface WmtsCapabilityLayer {
-    identifier: string;
-    title?: string;
-    abstract?: string;
-    formats: readonly string[];
-    styles: ReadonlyArray<WmtsCapabilityStyle>;
-    /** TileMatrixSet identifiers the layer supports. */
-    tileMatrixSetIds: readonly string[];
-    /** RESTful tile templates (xlink:href) advertised by `ResourceURL@resourceType="tile"`. */
-    resourceTemplates: ReadonlyArray<WmtsCapabilityResourceUrl>;
-    /** RESTful FeatureInfo templates advertised by `ResourceURL@resourceType="FeatureInfo"`. */
-    featureInfoTemplates: ReadonlyArray<WmtsCapabilityResourceUrl>;
-    /** Geographic bounding box (WGS84) when advertised. */
-    bbox?: {
-        west: number;
-        south: number;
-        east: number;
-        north: number;
+    readonly identifier: string;
+    readonly title?: string;
+    readonly abstract?: string;
+    readonly formats: readonly string[];
+    readonly infoFormats: readonly string[];
+    readonly styles: ReadonlyArray<WmtsCapabilityStyle>;
+    readonly dimensions: ReadonlyArray<WmtsCapabilityDimension>;
+    readonly tileMatrixSetIds: readonly string[];
+    readonly resourceTemplates: ReadonlyArray<WmtsCapabilityResourceUrl>;
+    readonly featureInfoTemplates: ReadonlyArray<WmtsCapabilityResourceUrl>;
+    readonly bbox?: {
+        readonly west: number;
+        readonly south: number;
+        readonly east: number;
+        readonly north: number;
     };
 }
 export interface WmtsCapabilityStyle {
-    identifier: string;
-    title?: string;
-    isDefault: boolean;
-    legendUrl?: string;
+    readonly identifier: string;
+    readonly title?: string;
+    readonly isDefault: boolean;
+    readonly legendUrl?: string;
+    readonly legendFormat?: string;
+}
+export interface WmtsCapabilityDimension {
+    readonly identifier: string;
+    readonly default?: string;
+    readonly current: boolean;
+    readonly values: readonly string[];
 }
 export interface WmtsCapabilityResourceUrl {
-    format: string;
-    template: string;
+    readonly format: string;
+    readonly template: string;
 }
 export interface WmtsCapabilityTileMatrixSet {
-    identifier: string;
-    /** CRS supportedCRS or wellKnownScaleSet href when advertised. */
-    supportedCrs?: string;
-    wellKnownScaleSet?: string;
-    matrices: ReadonlyArray<WmtsCapabilityTileMatrix>;
+    readonly identifier: string;
+    readonly supportedCrs?: string;
+    readonly wellKnownScaleSet?: string;
+    readonly matrices: ReadonlyArray<WmtsCapabilityTileMatrix>;
 }
 export interface WmtsCapabilityTileMatrix {
-    identifier: string;
-    scaleDenominator: number;
-    matrixWidth: number;
-    matrixHeight: number;
-    tileWidth: number;
-    tileHeight: number;
-    topLeftCorner: readonly [number, number];
+    readonly identifier: string;
+    readonly scaleDenominator: number;
+    readonly matrixWidth: number;
+    readonly matrixHeight: number;
+    readonly tileWidth: number;
+    readonly tileHeight: number;
+    readonly topLeftCorner: readonly [number, number];
 }
-export declare class HonuaWmtsCapabilitiesParseError extends Error {
-    constructor(message: string);
+export declare class HonuaWmtsCapabilitiesParseError extends HonuaSdkError {
+    constructor(message: string, options?: {
+        readonly cause?: unknown;
+    });
 }
-/**
- * Parse a `Capabilities` text body for WMTS 1.0 into the typed
- * `WmtsCapabilities` shape.
- */
 export declare function parseWmtsCapabilities(xml: string): WmtsCapabilities;
-/** Find a layer by identifier in a parsed `WmtsCapabilities`. */
+/** @internal Whether every matrix advertised by this parsed set was structurally valid. */
+export declare function isWmtsCapabilityTileMatrixSetComplete(matrixSet: WmtsCapabilityTileMatrixSet): boolean;
 export declare function findWmtsLayer(capabilities: WmtsCapabilities, identifier: string): WmtsCapabilityLayer | undefined;
-/** Find a tile-matrix-set by identifier. */
 export declare function findWmtsTileMatrixSet(capabilities: WmtsCapabilities, identifier: string): WmtsCapabilityTileMatrixSet | undefined;
 //# sourceMappingURL=wmts-capabilities.d.ts.map

package/core/wmts-capabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wmts-capabilities.d.ts","sourceRoot":"","sources":["../../../src/core/wmts-capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,uBAAuB,CAAC;IACjC,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC3C,cAAc,EAAE,aAAa,CAAC,2BAA2B,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC3C,oDAAoD;IACpD,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,2FAA2F;IAC3F,iBAAiB,EAAE,aAAa,CAAC,yBAAyB,CAAC,CAAC;IAC5D,4FAA4F;IAC5F,oBAAoB,EAAE,aAAa,CAAC,yBAAyB,CAAC,CAAC;IAC/D,uDAAuD;IACvD,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACrE;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,aAAa,CAAC,wBAAwB,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,qBAAa,+BAAgC,SAAQ,KAAK;gBACrC,OAAO,EAAE,MAAM;CAInC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAcnE;AAgWD,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAEjH;AAED,4CAA4C;AAC5C,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,gBAAgB,EAC9B,UAAU,EAAE,MAAM,GACjB,2BAA2B,GAAG,SAAS,CAEzC"}
+{"version":3,"file":"wmts-capabilities.d.ts","sourceRoot":"","sources":["../../../src/core/wmts-capabilities.ts"],"names":[],"mappings":"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"}