ropegeo-common 1.6.0 → 1.8.0

package/README.md

@@ -1,47 +1,281 @@
 # ropegeo-common
 
-Shared types and utilities for [RopeGeo](https://github.com/yurst3/RopeGeo) and [WebScraper](https://github.com/yurst3/WebScraper). Published to npm as [`ropegeo-common`](https://www.npmjs.com/package/ropegeo-common) so both projects can depend on a single set of types instead of duplicating code.
+Shared **domain classes** (validated models, enums, request params) and **helpers** (S3, SQS, HTTP, etc.) for [RopeGeo](https://github.com/yurst3/RopeGeo) and [WebScraper](https://github.com/yurst3/WebScraper). Published to npm as [`ropegeo-common`](https://www.npmjs.com/package/ropegeo-common) so both projects can share one package instead of duplicating code.
 
-## What’s in this package
-
-- **Page preview types** – `PagePreview`, `Difficulty`, and related enums used by the route preview API (e.g. GET /route/{routeId}/preview). `PagePreview` includes optional `permit` (`PermitStatus` enum: Yes, No, Restricted, Closed, or null).
-- **Page data source** – `PageDataSource` enum (e.g. Ropewiki) used when linking routes to pages.
-- **Ropewiki page view types** – `RopewikiPageView`, `RopewikiBetaSectionView`, and `RopewikiImageView` for the getRopewikiPageView API (full Ropewiki page with beta sections and images). `BetaSectionImage` includes `id`, `downloadBytes` (`DownloadBytes`: preview/banner/full byte sizes), and **page-based pagination** – `PaginationResults` / `MapDataTileKeysResults` (e.g. `GET /mapdata/{mapDataId}/tiles` with `total`, `page`, `totalBytes`).
-- **Routes (GET /routes)** – `Route`, `RouteType`, `RouteGeoJsonFeature`, and `RoutesGeojson` for the routes GeoJSON Feature Collection API. `RoutesGeojson.fromRoutes(routes)` builds the response shape from an array of `Route`.
-- **Search API types** – `SearchResults` (paginated search response with `results: Preview[]` and `nextCursor: string`), `RegionPreview` (region search hit with id, name, parents, imageUrl, source), and `PagePreview` (page search hit; same type as route preview).
-
-## Usage
+## Install
 
 ```bash
 npm install ropegeo-common
 ```
 
-```ts
-import {
-  PagePreview,
-  PageDataSource,
-  Difficulty,
-  DifficultyTechnical,
-  DifficultyWater,
-  DifficultyTime,
-  DifficultyRisk,
-  PermitStatus,
-  Route,
-  RouteType,
-  RoutesGeojson,
-  type RopewikiPageView,
-  type RopewikiBetaSectionView,
-  type RopewikiImageView,
-  type RegionPreview,
-  type SearchResults,
-  DownloadBytes,
-  PaginationResults,
-  MapDataTileKeysResults,
-  PaginationResultType,
-} from 'ropegeo-common';
-```
+## Imports
+
+- **Classes** — `import { … } from 'ropegeo-common/classes'` (or `import type { … }` for symbols that are type-only in TypeScript). The package entry `ropegeo-common` also re-exports everything from `./classes` for convenience.
+- **Helpers** — `import { … } from 'ropegeo-common/helpers'` (and `import type { … }` for helper types such as `GetS3ObjectResult`).
+
+Helper tables use columns **Name**, **Description**, **Import**. Class tables add **Base class** after **Name** (`N/A` for enums, TypeScript-only type aliases, constants, registration functions, and classes without an exported superclass; otherwise the direct superclass).
+
+---
+
+### General HTTP and async helpers (`src/helpers/`)
+
+| Name | Description | Import |
+| --- | --- | --- |
+| `httpRequest` | HTTP client wrapper: headers, throws on non-OK responses, optional Lambda proxy routing. | `import { httpRequest } from 'ropegeo-common/helpers'` |
+| `ProgressLogger` | Progress logging utility. | `import { ProgressLogger } from 'ropegeo-common/helpers'` |
+| `timeoutAfter` | Promise helper that rejects after a timeout. | `import { timeoutAfter } from 'ropegeo-common/helpers'` |
+
+### S3 helpers (`src/helpers/s3/`)
+
+| Name | Description | Import |
+| --- | --- | --- |
+| `getS3Client` | Returns a shared S3 client (singleton for Lambda reuse). | `import { getS3Client } from 'ropegeo-common/helpers'` |
+| `resetS3ClientForTests` | Resets the S3 client singleton (tests). | `import { resetS3ClientForTests } from 'ropegeo-common/helpers'` |
+| `listS3Objects` | Lists objects under an S3 prefix with optional pagination. | `import { listS3Objects } from 'ropegeo-common/helpers'` |
+| `S3ObjectEntry` | Entry shape for listed S3 objects. | `import type { S3ObjectEntry } from 'ropegeo-common/helpers'` |
+| `getS3Object` | Reads an S3 object by bucket and key; returns body string and optional `Content-Type`. | `import { getS3Object } from 'ropegeo-common/helpers'` |
+| `GetS3ObjectResult` | Result type for `getS3Object`. | `import type { GetS3ObjectResult } from 'ropegeo-common/helpers'` |
+| `putS3Object` | Writes an object to S3. | `import { putS3Object } from 'ropegeo-common/helpers'` |
+| `deleteS3Object` | Deletes an object from S3. | `import { deleteS3Object } from 'ropegeo-common/helpers'` |
+| `listS3Folder` | Lists keys under a folder-like prefix. | `import { listS3Folder } from 'ropegeo-common/helpers'` |
+| `putS3Folder` | Uploads multiple objects as a folder. | `import { putS3Folder } from 'ropegeo-common/helpers'` |
+| `replaceS3Folder` | Replaces contents of a folder prefix (delete then upload). | `import { replaceS3Folder } from 'ropegeo-common/helpers'` |
+
+### SQS helpers (`src/helpers/sqs/`)
+
+| Name | Description | Import |
+| --- | --- | --- |
+| `getSQSClient` | Returns a shared SQS client. | `import { getSQSClient } from 'ropegeo-common/helpers'` |
+| `resetSQSClientForTests` | Resets the SQS client singleton (tests). | `import { resetSQSClientForTests } from 'ropegeo-common/helpers'` |
+| `sendSQSMessage` | Sends a message to an SQS queue. | `import { sendSQSMessage } from 'ropegeo-common/helpers'` |
+| `deleteSQSMessage` | Deletes a message from a queue (e.g. after processing). | `import { deleteSQSMessage } from 'ropegeo-common/helpers'` |
+| `changeSQSMessageVisibilityTimeout` | Changes visibility timeout for an in-flight message. | `import { changeSQSMessageVisibilityTimeout } from 'ropegeo-common/helpers'` |
+
+### CloudFront helpers (`src/helpers/cloudfront/`)
+
+| Name | Description | Import |
+| --- | --- | --- |
+| `createCloudFrontInvalidation` | Creates a CloudFront cache invalidation for the given distribution paths. | `import { createCloudFrontInvalidation } from 'ropegeo-common/helpers'` |
+
+---
+
+### Core enums (`src/classes/` root files)
+
+| Name | Base class | Description | Import |
+| --- | --- | --- | --- |
+| `PageDataSource` | N/A | Where linked page content comes from (e.g. Ropewiki). | `import { PageDataSource } from 'ropegeo-common/classes'` |
+| `PermitStatus` | N/A | Permit state for a canyon page (Yes, No, Restricted, Closed). | `import { PermitStatus } from 'ropegeo-common/classes'` |
+
+### Difficulty (`src/classes/difficulty/`)
+
+| Name | Base class | Description | Import |
+| --- | --- | --- | --- |
+| `DifficultyType` | N/A | Discriminator for difficulty scales (e.g. ACA). | `import { DifficultyType } from 'ropegeo-common/classes'` |
+| `Difficulty` | N/A | Abstract base for page/route difficulty; `fromResult` dispatches by `difficultyType`. | `import { Difficulty } from 'ropegeo-common/classes'` |
+| `registerDifficultyParser` | N/A | Registers a `Difficulty.fromResult` parser for a `DifficultyType`. | `import { registerDifficultyParser } from 'ropegeo-common/classes'` |
+| `ACA_RISK_ORDER` | N/A | Numeric total order for ACA risk ratings. | `import { ACA_RISK_ORDER } from 'ropegeo-common/classes'` |
+| `ACA_TECHNICAL_ORDER` | N/A | Numeric total order for ACA technical ratings. | `import { ACA_TECHNICAL_ORDER } from 'ropegeo-common/classes'` |
+| `ACA_TIME_ORDER` | N/A | Numeric total order for ACA time ratings. | `import { ACA_TIME_ORDER } from 'ropegeo-common/classes'` |
+| `ACA_WATER_ORDER` | N/A | Numeric total order for ACA water ratings. | `import { ACA_WATER_ORDER } from 'ropegeo-common/classes'` |
+| `AcaTechnicalRating` | N/A | ACA technical rating enum (1–4). | `import { AcaTechnicalRating } from 'ropegeo-common/classes'` |
+| `AcaWaterRating` | N/A | ACA water rating enum. | `import { AcaWaterRating } from 'ropegeo-common/classes'` |
+| `AcaTimeRating` | N/A | ACA time rating enum (I–VI). | `import { AcaTimeRating } from 'ropegeo-common/classes'` |
+| `AcaRiskRating` | N/A | ACA risk rating enum. | `import { AcaRiskRating } from 'ropegeo-common/classes'` |
+| `RISK_ORDER` | N/A | Deprecated alias for `ACA_RISK_ORDER`. | `import { RISK_ORDER } from 'ropegeo-common/classes'` |
+| `AcaDifficulty` | `Difficulty` | ACA difficulty from DB/API strings; raw vs effective risk. | `import { AcaDifficulty } from 'ropegeo-common/classes'` |
+| `DifficultyTechnical` | N/A | Deprecated alias for `AcaTechnicalRating`. | `import { DifficultyTechnical } from 'ropegeo-common/classes'` |
+| `DifficultyWater` | N/A | Deprecated alias for `AcaWaterRating`. | `import { DifficultyWater } from 'ropegeo-common/classes'` |
+| `DifficultyTime` | N/A | Deprecated alias for `AcaTimeRating`. | `import { DifficultyTime } from 'ropegeo-common/classes'` |
+| `DifficultyRisk` | N/A | Deprecated alias for `AcaRiskRating`. | `import { DifficultyRisk } from 'ropegeo-common/classes'` |
+
+### Request parameters (`src/classes/requestParams/`)
+
+| Name | Base class | Description | Import |
+| --- | --- | --- | --- |
+| `DifficultyParams` | N/A | Abstract GET-query difficulty filter; `fromQueryStringParams` / `fromResult`. | `import { DifficultyParams } from 'ropegeo-common/classes'` |
+| `DifficultyParamsQueryRecord` | N/A | Flat string map for difficulty query parsing. | `import type { DifficultyParamsQueryRecord } from 'ropegeo-common/classes'` |
+| `registerDifficultyParamsQueryInference` | N/A | Registers inference when `difficulty-type` is omitted. | `import { registerDifficultyParamsQueryInference } from 'ropegeo-common/classes'` |
+| `registerDifficultyParamsQueryParser` | N/A | Registers a query parser for a `DifficultyType`. | `import { registerDifficultyParamsQueryParser } from 'ropegeo-common/classes'` |
+| `isDifficultyParamsActive` | N/A | True if difficulty params are non-null and active. | `import { isDifficultyParamsActive } from 'ropegeo-common/classes'` |
+| `AcaDifficultyParams` | `DifficultyParams` | ACA pipe-list allow-lists for routes/search query strings. | `import { AcaDifficultyParams } from 'ropegeo-common/classes'` |
+| `Q_DIFFICULTY_TYPE` | N/A | Query key constant for difficulty type. | `import { Q_DIFFICULTY_TYPE } from 'ropegeo-common/classes'` |
+| `Q_ACA_TECHNICAL` | N/A | Query key for ACA technical rating list. | `import { Q_ACA_TECHNICAL } from 'ropegeo-common/classes'` |
+| `Q_ACA_WATER` | N/A | Query key for ACA water rating list. | `import { Q_ACA_WATER } from 'ropegeo-common/classes'` |
+| `Q_ACA_TIME` | N/A | Query key for ACA time rating list. | `import { Q_ACA_TIME } from 'ropegeo-common/classes'` |
+| `Q_ACA_RISK` | N/A | Query key for ACA risk rating list. | `import { Q_ACA_RISK } from 'ropegeo-common/classes'` |
+| `RoutesParams` | N/A | Validated GET /routes params (region, source, route type, difficulty). | `import { RoutesParams } from 'ropegeo-common/classes'` |
+| `SearchParams` | `CursorPaginationParams` | Validated GET /search params including cursor pagination and difficulty. | `import { SearchParams } from 'ropegeo-common/classes'` |
+| `SearchOrder` | N/A | Search sort order (`similarity` \| `quality` \| `distance`). | `import type { SearchOrder } from 'ropegeo-common/classes'` |
+| `SearchParamsPosition` | N/A | `{ lat, lon }` for distance search. | `import type { SearchParamsPosition } from 'ropegeo-common/classes'` |
+
+### Persisted filters (`src/classes/filters/`)
+
+| Name | Base class | Description | Import |
+| --- | --- | --- | --- |
+| `DifficultyFilterOptions` | N/A | Abstract saved/modal difficulty filter; `fromResult` by `difficultyType`. | `import { DifficultyFilterOptions } from 'ropegeo-common/classes'` |
+| `registerDifficultyFilterOptionsParser` | N/A | Registers `DifficultyFilterOptions.fromResult` for a scale. | `import { registerDifficultyFilterOptionsParser } from 'ropegeo-common/classes'` |
+| `TechnicalMinMax` | N/A | Inclusive ACA technical min/max for filter UI. | `import { TechnicalMinMax } from 'ropegeo-common/classes'` |
+| `WaterMinMax` | N/A | Inclusive ACA water min/max. | `import { WaterMinMax } from 'ropegeo-common/classes'` |
+| `TimeMinMax` | N/A | Inclusive ACA time min/max. | `import { TimeMinMax } from 'ropegeo-common/classes'` |
+| `RiskMinMax` | N/A | Inclusive ACA risk min/max. | `import { RiskMinMax } from 'ropegeo-common/classes'` |
+| `AcaDifficultyFilterOptions` | `DifficultyFilterOptions` | ACA filter options; expands to `AcaDifficultyParams`. | `import { AcaDifficultyFilterOptions } from 'ropegeo-common/classes'` |
+| `RouteFilter` | N/A | Persisted explore/minimap route filter → `RoutesParams`. | `import { RouteFilter } from 'ropegeo-common/classes'` |
+| `SearchFilter` | N/A | Persisted mobile search filter → `SearchParams`. | `import { SearchFilter } from 'ropegeo-common/classes'` |
+| `SavedPagesFilter` | N/A | Saved-pages list filter (name, order, difficulty). | `import { SavedPagesFilter } from 'ropegeo-common/classes'` |
+| `SavedPagesOrder` | N/A | `'newest'` \| `'oldest'`. | `import type { SavedPagesOrder } from 'ropegeo-common/classes'` |
+| `SavedFilters` | N/A | Bundle of explore, search, and saved-pages filter slots. | `import { SavedFilters } from 'ropegeo-common/classes'` |
+
+### Previews (`src/classes/previews/`)
+
+| Name | Base class | Description | Import |
+| --- | --- | --- | --- |
+| `PreviewType` | N/A | Discriminator for search hit kind (page vs region). | `import { PreviewType } from 'ropegeo-common/classes'` |
+| `Preview` | N/A | Abstract union base for search/route preview payloads. | `import { Preview } from 'ropegeo-common/classes'` |
+| `GetRopewikiPagePreviewRow` | N/A | DB row shape for building `PagePreview` from Ropewiki. | `import type { GetRopewikiPagePreviewRow } from 'ropegeo-common/classes'` |
+| `PagePreview` | `Preview` | Page preview (route preview and search hits). | `import { PagePreview } from 'ropegeo-common/classes'` |
+| `RegionPreview` | `Preview` | Region search preview. | `import { RegionPreview } from 'ropegeo-common/classes'` |
+
+### Route domain (`src/classes/routes/`)
+
+| Name | Base class | Description | Import |
+| --- | --- | --- | --- |
+| `RouteType` | N/A | Canyon, Cave, POI, Unknown. | `import { RouteType } from 'ropegeo-common/classes'` |
+| `Route` | N/A | Route entity for APIs. | `import { Route } from 'ropegeo-common/classes'` |
+| `RouteGeoJsonFeature` | N/A | One GeoJSON feature in the routes collection. | `import { RouteGeoJsonFeature } from 'ropegeo-common/classes'` |
+
+### Routes GeoJSON API (`src/classes/api/getRoutes/`)
+
+| Name | Base class | Description | Import |
+| --- | --- | --- | --- |
+| `RoutesGeojson` | N/A | FeatureCollection wrapper; `fromRoutes` builder. | `import { RoutesGeojson } from 'ropegeo-common/classes'` |
+| `RoutesGeojsonResult` | `Result` | API wrapper for GET routes GeoJSON response. | `import { RoutesGeojsonResult } from 'ropegeo-common/classes'` |
+
+### Route preview API (`src/classes/api/getRoutePreview/`)
+
+| Name | Base class | Description | Import |
+| --- | --- | --- | --- |
+| `RoutePreviewResult` | `Result` | Result for GET route preview (page previews array). | `import { RoutePreviewResult } from 'ropegeo-common/classes'` |
+
+### Ropewiki page view API (`src/classes/api/getRopewikiPageView/`)
+
+| Name | Base class | Description | Import |
+| --- | --- | --- | --- |
+| `RopewikiPageView` | N/A | Full Ropewiki page view (sections, images, minimap). | `import { RopewikiPageView } from 'ropegeo-common/classes'` |
+| `RopewikiPageViewResult` | `Result` | API result wrapping `RopewikiPageView`. | `import { RopewikiPageViewResult } from 'ropegeo-common/classes'` |
+
+### Page link preview API (`src/classes/api/getRopewikiPageLinkPreview/`)
+
+| Name | Base class | Description | Import |
+| --- | --- | --- | --- |
+| `RopewikiPageLinkPreviewResult` | `Result` | Result for lightweight link preview. | `import { RopewikiPageLinkPreviewResult } from 'ropegeo-common/classes'` |
+
+### Map data tile keys API (`src/classes/api/listMapDataTileKeys/`)
+
+| Name | Base class | Description | Import |
+| --- | --- | --- | --- |
+| `MapDataTileKeysResults` | `PaginationResults` | Page-based pagination of map tile keys (`total`, `page`, `totalBytes`). | `import { MapDataTileKeysResults } from 'ropegeo-common/classes'` |
+
+### Search API (`src/classes/api/search/`)
+
+| Name | Base class | Description | Import |
+| --- | --- | --- | --- |
+| `SearchResults` | `CursorPaginationResults` | Cursor-paginated search response (`Preview` items). | `import { SearchResults } from 'ropegeo-common/classes'` |
+
+### Ropewiki region view API (`src/classes/api/getRopewikiRegionView/`)
+
+| Name | Base class | Description | Import |
+| --- | --- | --- | --- |
+| `RopewikiRegionView` | N/A | Region detail view payload. | `import { RopewikiRegionView } from 'ropegeo-common/classes'` |
+| `RopewikiRegionViewResult` | `Result` | API result wrapping region view. | `import { RopewikiRegionViewResult } from 'ropegeo-common/classes'` |
+
+### Ropewiki region previews API (`src/classes/api/getRopewikiRegionPreviews/`)
+
+| Name | Base class | Description | Import |
+| --- | --- | --- | --- |
+| `RopewikiRegionPreviewsParams` | `CursorPaginationParams` | Query/cursor params for region previews. | `import { RopewikiRegionPreviewsParams } from 'ropegeo-common/classes'` |
+| `RopewikiRegionPreviewsResult` | `CursorPaginationResults` | Cursor-paginated region previews (`Preview`). | `import { RopewikiRegionPreviewsResult } from 'ropegeo-common/classes'` |
+
+### Ropewiki region images API (`src/classes/api/getRopewikiRegionImages/`)
+
+| Name | Base class | Description | Import |
+| --- | --- | --- | --- |
+| `RopewikiRegionImageView` | N/A | One image row in region images list. | `import { RopewikiRegionImageView } from 'ropegeo-common/classes'` |
+| `RopewikiRegionImageViewRow` | N/A | Raw row shape for region image views. | `import type { RopewikiRegionImageViewRow } from 'ropegeo-common/classes'` |
+| `RopewikiRegionImagesParams` | `CursorPaginationParams` | Query/cursor params for region images. | `import { RopewikiRegionImagesParams } from 'ropegeo-common/classes'` |
+| `RopewikiRegionImagesResult` | `CursorPaginationResults` | Cursor-paginated region images. | `import { RopewikiRegionImagesResult } from 'ropegeo-common/classes'` |
+
+### Beta sections (`src/classes/betaSections/`)
+
+| Name | Base class | Description | Import |
+| --- | --- | --- | --- |
+| `BetaSectionImage` | N/A | Image in a beta section (URLs, pagination bytes). | `import { BetaSectionImage } from 'ropegeo-common/classes'` |
+| `RopewikiImageView` | N/A | Type alias of `BetaSectionImage` for Ropewiki page view typings. | `import type { RopewikiImageView } from 'ropegeo-common/classes'` |
+| `DownloadBytes` | N/A | Preview/banner/full byte sizes for downloads. | `import { DownloadBytes } from 'ropegeo-common/classes'` |
+| `BetaSection` | N/A | Beta section with images. | `import { BetaSection } from 'ropegeo-common/classes'` |
+| `RopewikiBetaSectionView` | N/A | Type alias of `BetaSection` for Ropewiki page view typings. | `import type { RopewikiBetaSectionView } from 'ropegeo-common/classes'` |
+
+### Minimap (`src/classes/minimap/`)
+
+| Name | Base class | Description | Import |
+| --- | --- | --- | --- |
+| `Bounds` | N/A | Geographic bounding box. | `import { Bounds } from 'ropegeo-common/classes'` |
+| `MiniMapType` | N/A | Minimap discriminator (e.g. GeoJSON). | `import { MiniMapType } from 'ropegeo-common/classes'` |
+| `MiniMap` | N/A | Abstract base for page/region minimaps. | `import { MiniMap } from 'ropegeo-common/classes'` |
+| `RegionMiniMap` | `MiniMap` | Region minimap payload. | `import { RegionMiniMap } from 'ropegeo-common/classes'` |
+| `PageMiniMap` | `MiniMap` | Page minimap payload. | `import { PageMiniMap } from 'ropegeo-common/classes'` |
+
+### Link preview (`src/classes/linkPreview/`)
+
+| Name | Base class | Description | Import |
+| --- | --- | --- | --- |
+| `LinkPreview` | N/A | Generic link preview (title, image, URL). | `import { LinkPreview } from 'ropegeo-common/classes'` |
+| `LinkPreviewImage` | N/A | Image sub-object for link previews. | `import { LinkPreviewImage } from 'ropegeo-common/classes'` |
+
+### Cursors (`src/classes/cursors/`)
+
+| Name | Base class | Description | Import |
+| --- | --- | --- | --- |
+| `CursorType` | N/A | Discriminator for cursor encodings. | `import { CursorType } from 'ropegeo-common/classes'` |
+| `Cursor` | N/A | Abstract base for typed API cursors. | `import { Cursor } from 'ropegeo-common/classes'` |
+| `SearchCursor` | `Cursor` | Search pagination cursor (base64). | `import { SearchCursor } from 'ropegeo-common/classes'` |
+| `SearchCursorType` | N/A | Type alias for search cursor payload typing. | `import type { SearchCursorType } from 'ropegeo-common/classes'` |
+| `RegionPreviewsCursor` | `Cursor` | Cursor for region previews pagination. | `import { RegionPreviewsCursor } from 'ropegeo-common/classes'` |
+| `RegionImagesCursor` | `Cursor` | Cursor for region images pagination. | `import { RegionImagesCursor } from 'ropegeo-common/classes'` |
+
+### Pagination params (`src/classes/params/`)
+
+| Name | Base class | Description | Import |
+| --- | --- | --- | --- |
+| `CursorPaginationParams` | N/A | Abstract limit + optional encoded cursor for GET APIs. | `import { CursorPaginationParams } from 'ropegeo-common/classes'` |
+
+### Result wrappers (`src/classes/results/`)
+
+| Name | Base class | Description | Import |
+| --- | --- | --- | --- |
+| `ResultType` | N/A | Discriminator enum for single-result API wrappers. | `import { ResultType } from 'ropegeo-common/classes'` |
+| `Result` | N/A | Abstract single-result response; `fromResponseBody` dispatches to parsers. | `import { Result } from 'ropegeo-common/classes'` |
+| `registerResultParser` | N/A | Registers `Result.fromResponseBody` for a `ResultType`. | `import { registerResultParser } from 'ropegeo-common/classes'` |
+| `CursorPaginationResultType` | N/A | Discriminator for cursor-paginated result wrappers. | `import { CursorPaginationResultType } from 'ropegeo-common/classes'` |
+| `CursorPaginationResults` | N/A | Abstract `results` + `nextCursor` response shape. | `import { CursorPaginationResults } from 'ropegeo-common/classes'` |
+| `ValidatedCursorPaginationResponse` | N/A | Validated inner shape passed to specific cursor result classes. | `import type { ValidatedCursorPaginationResponse } from 'ropegeo-common/classes'` |
+| `registerCursorPaginationParser` | N/A | Registers parser for a `CursorPaginationResultType`. | `import { registerCursorPaginationParser } from 'ropegeo-common/classes'` |
+| `PaginationResultType` | N/A | Discriminator for page-based paginated result wrappers. | `import { PaginationResultType } from 'ropegeo-common/classes'` |
+| `PaginationResults` | N/A | Abstract `results` + `total` + `page` response shape. | `import { PaginationResults } from 'ropegeo-common/classes'` |
+| `ValidatedPaginationResponse` | N/A | Validated inner shape for page-based pagination. | `import type { ValidatedPaginationResponse } from 'ropegeo-common/classes'` |
+| `registerPaginationParser` | N/A | Registers parser for a `PaginationResultType`. | `import { registerPaginationParser } from 'ropegeo-common/classes'` |
+
+### Mobile / offline (`src/classes/mobile/`)
+
+| Name | Base class | Description | Import |
+| --- | --- | --- | --- |
+| `ImageVersion` | N/A | Enum of cached image variant kinds. | `import { ImageVersion } from 'ropegeo-common/classes'` |
+| `VERSION_FORMAT` | N/A | Format constant for version strings. | `import { VERSION_FORMAT } from 'ropegeo-common/classes'` |
+| `ImageVersions` | N/A | Map of image URLs by `ImageVersion`; `fromResult` for persisted JSON. | `import { ImageVersions } from 'ropegeo-common/classes'` |
+| `SavedPage` | N/A | Offline saved page record (`PagePreview` + metadata). | `import { SavedPage } from 'ropegeo-common/classes'` |
+
+---
 
 ## Related repos
 
-- **[RopeGeo](https://github.com/yurst3/RopeGeo)** – Expo app for canyoneering maps and route data.
-- **[WebScraper](https://github.com/yurst3/WebScraper)** – Lambdas and jobs that scrape canyoneering sites (e.g. Ropewiki), parse data, and store it for the API.
+- **[RopeGeo](https://github.com/yurst3/RopeGeo)** — Expo app for canyoneering maps and route data.
+- **[WebScraper](https://github.com/yurst3/WebScraper)** — Lambdas and jobs that scrape canyoneering sites (e.g. Ropewiki), parse data, and store it for the API.

package/dist/classes/api/getRopewikiPageLinkPreview/ropewikiPageLinkPreviewResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ropewikiPageLinkPreviewResult.d.ts","sourceRoot":"","sources":["../../../../src/classes/api/getRopewikiPageLinkPreview/ropewikiPageLinkPreviewResult.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,MAAM,EAAc,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAE5D;;GAEG;AACH,qBAAa,6BAA8B,SAAQ,MAAM,CAAC,WAAW,CAAC;aACtC,MAAM,EAAE,WAAW;gBAAnB,MAAM,EAAE,WAAW;IAI/C;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,6BAA6B;CAIpE"}

package/dist/{types → classes}/api/getRopewikiPageView/ropewikiPageView.d.ts

@@ -1,4 +1,5 @@
-import { Difficulty } from '../../difficulty';
+import '../../difficulty/registerDifficultyParsers';
+import { Difficulty } from '../../difficulty/difficulty';
 import { PermitStatus } from '../../permitStatus';
 import { BetaSection } from '../../betaSections/betaSection';
 import { BetaSectionImage } from '../../betaSections/betaSectionImage';

package/dist/classes/api/getRopewikiPageView/ropewikiPageView.d.ts.map

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

package/dist/{types → classes}/api/getRopewikiPageView/ropewikiPageView.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RopewikiPageView = void 0;
-const difficulty_1 = require("../../difficulty");
+require("../../difficulty/registerDifficultyParsers");
+const difficulty_1 = require("../../difficulty/difficulty");
 const permitStatus_1 = require("../../permitStatus");
 const betaSection_1 = require("../../betaSections/betaSection");
 const betaSectionImage_1 = require("../../betaSections/betaSectionImage");
@@ -82,7 +83,7 @@ class RopewikiPageView {
         RopewikiPageView.assertBetaSectionsArray(r, 'betaSections');
         RopewikiPageView.assertNullableMiniMap(r, 'miniMap');
         r.latestRevisionDate = new Date(r.latestRevisionDate);
-        r.difficulty = new difficulty_1.Difficulty(r.difficulty.technical, r.difficulty.water, r.difficulty.time, r.difficulty.risk);
+        r.difficulty = difficulty_1.Difficulty.fromResult(r.difficulty);
         if (r.miniMap != null && r.miniMap !== undefined) {
             r.miniMap = pageMiniMap_1.PageMiniMap.fromResult(r.miniMap);
         }

package/dist/classes/api/getRopewikiPageView/ropewikiPageViewResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ropewikiPageViewResult.d.ts","sourceRoot":"","sources":["../../../../src/classes/api/getRopewikiPageView/ropewikiPageViewResult.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,MAAM,EAAc,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,MAAM,CAAC,gBAAgB,CAAC;aACpC,MAAM,EAAE,gBAAgB;gBAAxB,MAAM,EAAE,gBAAgB;IAIpD;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,sBAAsB;CAI7D"}

package/dist/classes/api/getRopewikiRegionImages/ropewikiRegionImageView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ropewikiRegionImageView.d.ts","sourceRoot":"","sources":["../../../../src/classes/api/getRopewikiRegionImages/ropewikiRegionImageView.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,uBAAuB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEhB,GAAG,EAAE,0BAA0B;IAU3C;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,uBAAuB;IAgB3D,OAAO,CAAC,MAAM,CAAC,YAAY;IAS3B,OAAO,CAAC,MAAM,CAAC,oBAAoB;CAYtC"}

package/dist/classes/api/getRopewikiRegionImages/ropewikiRegionImagesParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ropewikiRegionImagesParams.d.ts","sourceRoot":"","sources":["../../../../src/classes/api/getRopewikiRegionImages/ropewikiRegionImagesParams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAItE;;;;GAIG;AACH,qBAAa,0BAA2B,SAAQ,sBAAsB,CAAC,kBAAkB,CAAC;gBAC1E,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;IAsBjD,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,0BAA0B;IAOpE;;;OAGG;IACH,MAAM,CAAC,qBAAqB,CACxB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,0BAA0B;CAOhC"}

package/dist/classes/api/getRopewikiRegionImages/ropewikiRegionImagesResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ropewikiRegionImagesResult.d.ts","sourceRoot":"","sources":["../../../../src/classes/api/getRopewikiRegionImages/ropewikiRegionImagesResult.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EACH,uBAAuB,EACvB,KAAK,iCAAiC,EAGzC,MAAM,uCAAuC,CAAC;AAE/C;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,uBAAuB,CAAC,uBAAuB,CAAC;gBAExF,OAAO,EAAE,uBAAuB,EAAE,EAClC,UAAU,EAAE,kBAAkB,GAAG,MAAM,GAAG,IAAI;IAWlD;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CACnB,IAAI,EAAE,iCAAiC,GACxC,0BAA0B;CAQhC"}

package/dist/classes/api/getRopewikiRegionPreviews/ropewikiRegionPreviewsParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ropewikiRegionPreviewsParams.d.ts","sourceRoot":"","sources":["../../../../src/classes/api/getRopewikiRegionPreviews/ropewikiRegionPreviewsParams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAI1E;;;;GAIG;AACH,qBAAa,4BAA6B,SAAQ,sBAAsB,CAAC,oBAAoB,CAAC;gBAC9E,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;IAsBjD,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,4BAA4B;IAOtE;;;OAGG;IACH,MAAM,CAAC,qBAAqB,CACxB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,4BAA4B;CAOlC"}

package/dist/classes/api/getRopewikiRegionPreviews/ropewikiRegionPreviewsResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ropewikiRegionPreviewsResult.d.ts","sourceRoot":"","sources":["../../../../src/classes/api/getRopewikiRegionPreviews/ropewikiRegionPreviewsResult.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EACH,uBAAuB,EACvB,KAAK,iCAAiC,EAGzC,MAAM,uCAAuC,CAAC;AAE/C;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,uBAAuB,CAAC,OAAO,CAAC;gBAE1E,OAAO,EAAE,OAAO,EAAE,EAClB,UAAU,EAAE,oBAAoB,GAAG,MAAM,GAAG,IAAI;IAWpD;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CACnB,IAAI,EAAE,iCAAiC,GACxC,4BAA4B;CAQlC"}

package/dist/classes/api/getRopewikiRegionView/ropewikiRegionView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ropewikiRegionView.d.ts","sourceRoot":"","sources":["../../../../src/classes/api/getRopewikiRegionView/ropewikiRegionView.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAE7D,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD;;;GAGG;AACH,qBAAa,kBAAkB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,gHAAgH;IAChH,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxC,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,0FAA0F;IAC1F,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,kBAAkB,EAAE,IAAI,CAAC;IACzB,wDAAwD;IACxD,QAAQ,EAAE,IAAI,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;gBAGpB,IAAI,EAAE,MAAM,EACZ,kBAAkB,EAAE,IAAI,EACxB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,OAAO,GAAG,IAAI,EACvB,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,EACxC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,EAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,EAC7B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,EAC/B,4BAA4B,CAAC,EAAE,MAAM,GAAG,IAAI,EAC5C,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EACxB,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAC5B,aAAa,CAAC,EAAE,OAAO,GAAG,IAAI;IAqBlC;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,kBAAkB;IAmCtD,OAAO,CAAC,MAAM,CAAC,YAAY;IAS3B,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAYnC,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAarC,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAYtC,OAAO,CAAC,MAAM,CAAC,kBAAkB;IA+BjC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAmBhC,OAAO,CAAC,MAAM,CAAC,aAAa;IAY5B,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAkBtC,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAUpC,OAAO,CAAC,MAAM,CAAC,cAAc;CAkBhC"}

package/dist/classes/api/getRopewikiRegionView/ropewikiRegionViewResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ropewikiRegionViewResult.d.ts","sourceRoot":"","sources":["../../../../src/classes/api/getRopewikiRegionView/ropewikiRegionViewResult.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,MAAM,EAAc,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,MAAM,CAAC,kBAAkB,CAAC;aACxC,MAAM,EAAE,kBAAkB;gBAA1B,MAAM,EAAE,kBAAkB;IAItD;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,wBAAwB;CAI/D"}

package/dist/classes/api/getRoutePreview/routePreviewResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routePreviewResult.d.ts","sourceRoot":"","sources":["../../../../src/classes/api/getRoutePreview/routePreviewResult.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,MAAM,EAAc,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,MAAM,CAAC,WAAW,EAAE,CAAC;aAC7B,MAAM,EAAE,WAAW,EAAE;gBAArB,MAAM,EAAE,WAAW,EAAE;IAIjD;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,kBAAkB;CASzD"}

package/dist/classes/api/getRoutes/routeGeojson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeGeojson.d.ts","sourceRoot":"","sources":["../../../../src/classes/api/getRoutes/routeGeojson.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEhE;;;GAGG;AACH,qBAAa,aAAa;IACtB,IAAI,EAAE,mBAAmB,CAAuB;IAChD,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,wEAAwE;IACxE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEV,QAAQ,EAAE,mBAAmB,EAAE,EAAE,MAAM,GAAE,MAAM,GAAG,IAAW;IAKzE;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,UAAU,UAAQ,GAAG,aAAa;IASrE,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAkBtC;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,aAAa;IAoBjD,OAAO,CAAC,MAAM,CAAC,aAAa;IAa5B,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAYlC,OAAO,CAAC,MAAM,CAAC,oBAAoB;CAYtC"}

package/dist/classes/api/getRoutes/routesGeojsonResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routesGeojsonResult.d.ts","sourceRoot":"","sources":["../../../../src/classes/api/getRoutes/routesGeojsonResult.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,MAAM,EAAc,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,MAAM,CAAC,aAAa,CAAC;aAC9B,MAAM,EAAE,aAAa;gBAArB,MAAM,EAAE,aAAa;IAIjD;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,mBAAmB;CAI1D"}

package/dist/classes/api/listMapDataTileKeys/mapDataTileKeysResults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapDataTileKeysResults.d.ts","sourceRoot":"","sources":["../../../../src/classes/api/listMapDataTileKeys/mapDataTileKeysResults.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,iBAAiB,EAGjB,KAAK,2BAA2B,EACnC,MAAM,iCAAiC,CAAC;AAEzC;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,iBAAiB,CAAC,MAAM,CAAC;IACjE,SAAiB,UAAU,EAAE,MAAM,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAI9E;;;OAGG;IACH,MAAM,CAAC,qBAAqB,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,SAAS,EAAE,2BAA2B,GACvC,sBAAsB;IAmBzB,OAAO,CAAC,MAAM,CAAC,gBAAgB;CAgBlC"}

package/dist/classes/api/search/searchResults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchResults.d.ts","sourceRoot":"","sources":["../../../../src/classes/api/search/searchResults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EACH,uBAAuB,EACvB,KAAK,iCAAiC,EAGzC,MAAM,uCAAuC,CAAC;AAE/C,qBAAa,aAAc,SAAQ,uBAAuB,CAAC,OAAO,CAAC;gBACnD,OAAO,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI;IAQxE;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,iCAAiC,GAAG,aAAa;CAQlF"}

package/dist/classes/betaSections/betaSection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"betaSection.d.ts","sourceRoot":"","sources":["../../../src/classes/betaSections/betaSection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;GAEG;AACH,qBAAa,WAAW;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,kBAAkB,EAAE,IAAI,CAAC;gBAGrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,kBAAkB,EAAE,IAAI,EACxB,MAAM,CAAC,EAAE,gBAAgB,EAAE;IAS/B;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW;IAiBnD,OAAO,CAAC,MAAM,CAAC,YAAY;IAS3B,OAAO,CAAC,MAAM,CAAC,YAAY;IAS3B,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAehC,OAAO,CAAC,MAAM,CAAC,uBAAuB;CAiBzC"}

package/dist/classes/betaSections/betaSectionImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"betaSectionImage.d.ts","sourceRoot":"","sources":["../../../src/classes/betaSections/betaSectionImage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;GAEG;AACH,qBAAa,gBAAgB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kBAAkB,EAAE,IAAI,CAAC;IACzB,+DAA+D;IAC/D,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;gBAGhC,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,kBAAkB,EAAE,IAAI,EACxB,aAAa,EAAE,aAAa,GAAG,IAAI;IAYvC;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB;IAoBpD,OAAO,CAAC,MAAM,CAAC,YAAY;IAS3B,OAAO,CAAC,MAAM,CAAC,oBAAoB;IASnC,OAAO,CAAC,MAAM,CAAC,YAAY;IAS3B,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAYjC,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAYxC,OAAO,CAAC,MAAM,CAAC,uBAAuB;CAiBzC"}

package/dist/classes/betaSections/downloadBytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"downloadBytes.d.ts","sourceRoot":"","sources":["../../../src/classes/betaSections/downloadBytes.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,aAAa;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;gBAED,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAMzD;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,aAAa;IAYjD,OAAO,CAAC,MAAM,CAAC,6BAA6B;CAgB/C"}

package/dist/classes/cursors/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../../src/classes/cursors/cursor.ts"],"names":[],"mappings":"AAAA,oBAAY,UAAU;IAClB,MAAM,WAAW;IACjB,cAAc,oBAAoB;IAClC,YAAY,kBAAkB;CACjC;AAuBD;;;GAGG;AACH,8BAAsB,MAAM;IACxB,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAEzC,0EAA0E;IAC1E,SAAS,CAAC,QAAQ,CAAC,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEvD,YAAY,IAAI,MAAM;IAMtB;;;OAGG;IACH,SAAS,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAkB7F;;;OAGG;IACH,SAAS,CAAC,MAAM,CAAC,kBAAkB,CAC/B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,QAAQ,EAAE,UAAU,EACpB,UAAU,EAAE,MAAM,GACnB,IAAI;CAUV"}

package/dist/classes/cursors/regionImagesCursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regionImagesCursor.d.ts","sourceRoot":"","sources":["../../../src/classes/cursors/regionImagesCursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE9C;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,MAAM;aAItB,OAAO,EAAE,MAAM;aACf,MAAM,EAAE,MAAM;aACd,OAAO,EAAE,MAAM;IALnC,QAAQ,CAAC,UAAU,2BAA2B;gBAG1B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM;IAKnC,SAAS,CAAC,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI9C;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB;CAqB3D"}

package/dist/classes/cursors/regionPreviewsCursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regionPreviewsCursor.d.ts","sourceRoot":"","sources":["../../../src/classes/cursors/regionPreviewsCursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE9C;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,MAAM;aAIxB,OAAO,EAAE,MAAM;aACf,IAAI,EAAE,MAAM;aACZ,EAAE,EAAE,MAAM;IAL9B,QAAQ,CAAC,UAAU,6BAA6B;gBAG5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM;IAK9B,SAAS,CAAC,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI9C;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB;CAqB7D"}

package/dist/classes/cursors/searchCursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchCursor.d.ts","sourceRoot":"","sources":["../../../src/classes/cursors/searchCursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEjD;;GAEG;AACH,qBAAa,YAAa,SAAQ,MAAM;aAIhB,OAAO,EAAE,MAAM;aACf,IAAI,EAAE,gBAAgB;aACtB,EAAE,EAAE,MAAM;IAL9B,QAAQ,CAAC,UAAU,qBAAqB;gBAGpB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,gBAAgB,EACtB,EAAE,EAAE,MAAM;IAK9B,SAAS,CAAC,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI9C;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;CAoBrD"}

package/dist/classes/difficulty/acaDifficulty.d.ts

@@ -0,0 +1,30 @@
+import { Difficulty, DifficultyType } from './difficulty';
+import { AcaRiskRating, AcaTechnicalRating, AcaTimeRating, AcaWaterRating } from './acaRatings';
+/**
+ * ACA canyon difficulty from DB strings. `risk` is the raw stored value; `effectiveRisk`
+ * applies the technical default floor when `risk` is null or milder than that default.
+ */
+export declare class AcaDifficulty extends Difficulty {
+    readonly difficultyType = DifficultyType.ACA;
+    readonly technical: AcaTechnicalRating | null;
+    readonly water: AcaWaterRating | null;
+    readonly time: AcaTimeRating | null;
+    /** Raw risk from ropewiki (`riskRating` column), after enum parse; null if unset. */
+    readonly risk: AcaRiskRating | null;
+    /** Risk used for display and sorting (never milder than the default implied by technical). */
+    readonly effectiveRisk: AcaRiskRating | null;
+    constructor(technicalRating: string | null | undefined, waterRating: string | null | undefined, timeRating: string | null | undefined, riskRating: string | null | undefined);
+    getEffectiveRiskForDisplay(): AcaRiskRating | null;
+    private static assignParts;
+    private static defaultRiskFromTechnical;
+    private static computeEffectiveRisk;
+    private static parseField;
+    /**
+     * Parses JSON/API objects: `difficultyType: 'ACA'` (optional when dispatched via
+     * {@link Difficulty.fromResult}), `technical`, `water`, `time`, `risk` (raw), optional
+     * `effectiveRisk` override.
+     */
+    static fromResult(result: unknown): AcaDifficulty;
+    private static coerceOptionalString;
+}
+//# sourceMappingURL=acaDifficulty.d.ts.map

package/dist/classes/difficulty/acaDifficulty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acaDifficulty.d.ts","sourceRoot":"","sources":["../../../src/classes/difficulty/acaDifficulty.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAA4B,MAAM,cAAc,CAAC;AACpF,OAAO,EAEH,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,cAAc,EACjB,MAAM,cAAc,CAAC;AAUtB;;;GAGG;AACH,qBAAa,aAAc,SAAQ,UAAU;IACzC,QAAQ,CAAC,cAAc,sBAAsB;IAE7C,QAAQ,CAAC,SAAS,EAAG,kBAAkB,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAG,cAAc,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAG,aAAa,GAAG,IAAI,CAAC;IACrC,qFAAqF;IACrF,QAAQ,CAAC,IAAI,EAAG,aAAa,GAAG,IAAI,CAAC;IACrC,8FAA8F;IAC9F,QAAQ,CAAC,aAAa,EAAG,aAAa,GAAG,IAAI,CAAC;gBAG1C,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC1C,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACtC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACrC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAiCzC,0BAA0B,IAAI,aAAa,GAAG,IAAI;IAIlD,OAAO,CAAC,MAAM,CAAC,WAAW;IAS1B,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAcvC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAanC,OAAO,CAAC,MAAM,CAAC,UAAU;IAezB;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,aAAa;IAuCjD,OAAO,CAAC,MAAM,CAAC,oBAAoB;CAOtC"}

package/dist/classes/difficulty/acaDifficulty.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AcaDifficulty = void 0;
+const difficulty_1 = require("./difficulty");
+const acaRatings_1 = require("./acaRatings");
+/**
+ * ACA canyon difficulty from DB strings. `risk` is the raw stored value; `effectiveRisk`
+ * applies the technical default floor when `risk` is null or milder than that default.
+ */
+class AcaDifficulty extends difficulty_1.Difficulty {
+    constructor(technicalRating, waterRating, timeRating, riskRating) {
+        super();
+        this.difficultyType = difficulty_1.DifficultyType.ACA;
+        const technical = AcaDifficulty.parseField(technicalRating, Object.values(acaRatings_1.AcaTechnicalRating), 'technical');
+        const water = AcaDifficulty.parseField(waterRating, Object.values(acaRatings_1.AcaWaterRating), 'water');
+        const time = AcaDifficulty.parseField(timeRating, Object.values(acaRatings_1.AcaTimeRating), 'time');
+        const parsedRisk = AcaDifficulty.parseField(riskRating, Object.values(acaRatings_1.AcaRiskRating), 'risk');
+        const parts = {
+            technical,
+            water,
+            time,
+            risk: parsedRisk,
+            effectiveRisk: AcaDifficulty.computeEffectiveRisk(parsedRisk, technical),
+        };
+        AcaDifficulty.assignParts(this, parts);
+    }
+    getEffectiveRiskForDisplay() {
+        return this.effectiveRisk;
+    }
+    static assignParts(target, parts) {
+        target.technical = parts.technical;
+        target.water = parts.water;
+        target.time = parts.time;
+        target.risk = parts.risk;
+        target.effectiveRisk =
+            parts.effectiveRisk;
+    }
+    static defaultRiskFromTechnical(technical) {
+        if (technical === acaRatings_1.AcaTechnicalRating.One)
+            return acaRatings_1.AcaRiskRating.G;
+        if (technical === acaRatings_1.AcaTechnicalRating.Two)
+            return acaRatings_1.AcaRiskRating.PG;
+        if (technical === acaRatings_1.AcaTechnicalRating.Three ||
+            technical === acaRatings_1.AcaTechnicalRating.Four) {
+            return acaRatings_1.AcaRiskRating.PG13;
+        }
+        return null;
+    }
+    static computeEffectiveRisk(rawRisk, technical) {
+        const defaultRisk = AcaDifficulty.defaultRiskFromTechnical(technical);
+        if (rawRisk != null) {
+            return defaultRisk != null && acaRatings_1.ACA_RISK_ORDER[rawRisk] < acaRatings_1.ACA_RISK_ORDER[defaultRisk]
+                ? defaultRisk
+                : rawRisk;
+        }
+        return defaultRisk;
+    }
+    static parseField(value, allowed, fieldName) {
+        if (value == null || value === '')
+            return null;
+        const trimmed = value.trim();
+        if (!allowed.includes(trimmed)) {
+            throw new Error(`Invalid difficulty ${fieldName}: "${value}" is not one of [${allowed.join(', ')}]`);
+        }
+        return trimmed;
+    }
+    /**
+     * Parses JSON/API objects: `difficultyType: 'ACA'` (optional when dispatched via
+     * {@link Difficulty.fromResult}), `technical`, `water`, `time`, `risk` (raw), optional
+     * `effectiveRisk` override.
+     */
+    static fromResult(result) {
+        if (result == null || typeof result !== 'object') {
+            throw new Error('AcaDifficulty result must be an object');
+        }
+        const r = result;
+        const dtype = r.difficultyType ?? r.DifficultyType;
+        if (dtype !== undefined &&
+            dtype !== null &&
+            typeof dtype === 'string' &&
+            dtype.toUpperCase() !== difficulty_1.DifficultyType.ACA) {
+            throw new Error(`Unsupported difficultyType for AcaDifficulty.fromResult: ${JSON.stringify(dtype)}`);
+        }
+        const tech = AcaDifficulty.coerceOptionalString(r.technical ?? r.Technical);
+        const water = AcaDifficulty.coerceOptionalString(r.water ?? r.Water);
+        const time = AcaDifficulty.coerceOptionalString(r.time ?? r.Time);
+        const riskRaw = AcaDifficulty.coerceOptionalString(r.risk ?? r.Risk);
+        const effectiveRaw = AcaDifficulty.coerceOptionalString(r.effectiveRisk ?? r.EffectiveRisk);
+        if (effectiveRaw !== null) {
+            const inst = new AcaDifficulty(tech, water, time, riskRaw);
+            const effParsed = AcaDifficulty.parseField(effectiveRaw, Object.values(acaRatings_1.AcaRiskRating), 'effectiveRisk');
+            inst.effectiveRisk = effParsed;
+            return inst;
+        }
+        return new AcaDifficulty(tech, water, time, riskRaw);
+    }
+    static coerceOptionalString(v) {
+        if (v === undefined || v === null || v === '')
+            return null;
+        if (typeof v !== 'string') {
+            throw new Error('AcaDifficulty field must be string or null');
+        }
+        return v;
+    }
+}
+exports.AcaDifficulty = AcaDifficulty;
+(0, difficulty_1.registerDifficultyParser)(difficulty_1.DifficultyType.ACA, (v) => AcaDifficulty.fromResult(v));