@unmap/elevation 0.13.0 → 0.15.0

package/README.md

@@ -1,6 +1,6 @@
 # @unmap/elevation
 
-Ground elevation anywhere in Canada, from NRCan's national 30 m DEM.
+DEM elevation from the active unmap terrain release.
 
 ```ts
 import { Elevation } from "@unmap/elevation";
@@ -9,8 +9,18 @@ const elevation = new Elevation({ key: "um_live_..." });
 const [metres] = await elevation.get([-114.0719, 51.0447]);
 ```
 
-Heights are metres above the CGVD2013 geoid. `null` means the dataset covers nothing there; it
-never means sea level.
+Heights are metres. After global Mapterhorn activation, source datums, native resolutions and
+terrain/surface models vary; this is not a uniform bare-earth DTM. Before activation or after
+Canadian rollback, MRDEM reports CGVD2013 and 30 m resolution. Check `/coverage.json` for the
+active release. The client keeps returning an ordered `(number | null)[]`; `null` is missing data.
+Direct HTTP responses expose `datum: "mixed"`, `resolution: null`, `model: "mixed"` and sampling
+metadata for Mapterhorn. Its z12 0.5 m height increment is encoding precision, not accuracy.
+
+An unconfigured terrain archive throws `ElevationError` with status `404` and code `not_found`
+(`terrain archive not configured`). A terrain tile that will not decode is status `502` and code
+`upstream_error` (`elevation sample failed`). That `502` has no `Retry-After`. The client still
+retries it, on its own backoff. A coordinate the archive does not cover stays `null`. An unavailable selected global release
+throws status `503`, code `service_unavailable`, without falling back to another DEM.
 
 `@unmap/sdk` exposes the same object as `unmap.elevation`. Full documentation:
-<https://unmap.dev/docs/elevation-api>.
+<https://unmap.dev/docs/apis/elevation>.

package/dist/index.d.ts

@@ -1,3 +1,6 @@
+import { RetryPolicy, UnmapError } from '@unmap/core';
+export { RetryPolicy, UnmapError, parseRetryAfter } from '@unmap/core';
+
 /** [longitude, latitude]. Longitude first, everywhere in unmap. Not exported: `@unmap/routing`
  *  already exports a `LngLat` of the same shape, and both packages land in `@unmap/sdk`'s star
  *  exports, where two same-named exports would be a type error. */
@@ -6,6 +9,16 @@ interface ElevationOptions {
     key: string;
     gateway?: string;
     fetch?: typeof fetch;
+    /**
+     * Retry policy for `429`, `502`, `503` and transport failures. `false` disables it.
+     *
+     * On by default. `Retry-After` is on a `429` other than `billing_required`, and on a container
+     * `503`. A `502` has none: routing uses `routing_failed`, and `/elevation` uses
+     * `upstream_error`. With no header the client backs off itself. A wait longer than
+     * `maxDelayMs` (10 s) is not slept through; the error carries `retryAfterSeconds` instead.
+     * See `RetryPolicy` in `@unmap/core`.
+     */
+    retry?: RetryPolicy | false;
 }
 /** The gateway's own cap. Checked here so an over-long batch fails without spending a call. */
 declare const MAX_ELEVATION_POINTS = 1000;
@@ -20,27 +33,32 @@ declare const MAX_ELEVATION_POINTS = 1000;
  * here, against the real encoded URL, and the message says what actually fits.
  */
 declare const MAX_REQUEST_URL_BYTES = 16384;
-declare class ElevationError extends Error {
-    readonly status: number;
-    /** The gateway's machine-readable `code`, when the response carried one. */
-    readonly code?: string | undefined;
-    constructor(status: number, message: string, 
-    /** The gateway's machine-readable `code`, when the response carried one. */
-    code?: string | undefined);
+/**
+ * An elevation failure.
+ *
+ * Extends `UnmapError`, so `catch (e) { if (e instanceof UnmapError) }` catches this alongside
+ * every other unmap client's errors. `instanceof ElevationError` keeps working, and `status` and `code`
+ * are still where they were; `retryAfterSeconds` is new and comes from the header.
+ */
+declare class ElevationError extends UnmapError {
+    constructor(status: number, message: string, code?: string, retryAfterSeconds?: number);
 }
 /**
  * Typed client for the unmap elevation API (gateway `/elevation`).
  *
- * Heights are metres above CGVD2013. `null` means the dataset covers nothing at that coordinate;
- * it never means sea level, and the client does not substitute a number for it.
+ * Heights are metres in the active DEM's vertical datum. The global Mapterhorn mosaic mixes
+ * terrain/surface models and vertical datums; Canadian rollback uses CGVD2013. `null` means
+ * missing data, and the client does not substitute a number for it. See /coverage.json and
+ * the HTTP response's metadata for the active release and its limitations.
  */
 declare class Elevation {
     private readonly key;
     private readonly base;
     private readonly fetchImpl;
+    private readonly retry;
     constructor(opts: ElevationOptions);
     /**
-     * Ground elevation in metres, one entry per coordinate, in the order asked.
+     * DEM elevation in metres, one entry per coordinate, in the order asked.
      *
      * Always an array, whether you passed one coordinate or a thousand, so the single and batch
      * cases are the same call:

package/dist/index.js

@@ -1,29 +1,28 @@
 // src/index.ts
-import { DEFAULT_GATEWAY } from "@unmap/core";
+import { DEFAULT_GATEWAY, UnmapError, fetchWithRetry, parseRetryAfter } from "@unmap/core";
+import { UnmapError as UnmapError2, parseRetryAfter as parseRetryAfter2 } from "@unmap/core";
 var MAX_ELEVATION_POINTS = 1e3;
 var MAX_REQUEST_URL_BYTES = 16384;
 var URL_HEADROOM_BYTES = 256;
-var ElevationError = class extends Error {
-  constructor(status, message, code) {
-    super(message);
-    this.status = status;
-    this.code = code;
+var ElevationError = class extends UnmapError {
+  constructor(status, message, code, retryAfterSeconds) {
+    super(status, message, code, retryAfterSeconds);
     this.name = "ElevationError";
   }
-  status;
-  code;
 };
 var Elevation = class {
   key;
   base;
   fetchImpl;
+  retry;
   constructor(opts) {
+    this.retry = opts.retry;
     this.key = opts.key;
     this.base = (opts.gateway ?? DEFAULT_GATEWAY).replace(/\/+$/, "");
     this.fetchImpl = opts.fetch ?? globalThis.fetch.bind(globalThis);
   }
   /**
-   * Ground elevation in metres, one entry per coordinate, in the order asked.
+   * DEM elevation in metres, one entry per coordinate, in the order asked.
    *
    * Always an array, whether you passed one coordinate or a thousand, so the single and batch
    * cases are the same call:
@@ -54,10 +53,12 @@ var Elevation = class {
         `elevation.get built a ${bytes} byte request URL; this client sends at most ${budget} bytes, keeping headroom under the edge's ${MAX_REQUEST_URL_BYTES} byte limit. Send at most about ${fits} of these coordinates per request (roughly 700 at six decimal places).`
       );
     }
-    const res = await this.fetchImpl(target, {
-      signal: opts.signal,
-      headers: { accept: "application/json" }
-    });
+    const res = await fetchWithRetry(
+      this.fetchImpl,
+      target,
+      { signal: opts.signal, headers: { accept: "application/json" } },
+      this.retry
+    );
     if (!res.ok) throw await errorFrom(res);
     const body = await res.json();
     return body.elevations;
@@ -76,12 +77,15 @@ async function errorFrom(res) {
   }
   const reason = typeof body?.error === "string" ? body.error : void 0;
   const code = typeof body?.code === "string" ? body.code : void 0;
-  return new ElevationError(res.status, reason ? `${reason} (${fallback})` : fallback, code);
+  const retryAfter = parseRetryAfter(res.headers?.get("retry-after") ?? null) ?? void 0;
+  return new ElevationError(res.status, reason ? `${reason} (${fallback})` : fallback, code, retryAfter);
 }
 export {
   Elevation,
   ElevationError,
   MAX_ELEVATION_POINTS,
-  MAX_REQUEST_URL_BYTES
+  MAX_REQUEST_URL_BYTES,
+  UnmapError2 as UnmapError,
+  parseRetryAfter2 as parseRetryAfter
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { DEFAULT_GATEWAY } from \"@unmap/core\";\n\n/** [longitude, latitude]. Longitude first, everywhere in unmap. Not exported: `@unmap/routing`\n *  already exports a `LngLat` of the same shape, and both packages land in `@unmap/sdk`'s star\n *  exports, where two same-named exports would be a type error. */\ntype LngLat = [number, number];\n\nexport interface ElevationOptions {\n  key: string;\n  gateway?: string;\n  fetch?: typeof fetch;\n}\n\n/** The gateway's own cap. Checked here so an over-long batch fails without spending a call. */\nexport const MAX_ELEVATION_POINTS = 1000;\n\n/**\n * Cloudflare refuses a request URL longer than this at the edge, before the Worker runs.\n *\n * It bites well before `MAX_ELEVATION_POINTS` does. `URLSearchParams` percent-encodes both of\n * the batch separators (`,` becomes `%2C`, `|` becomes `%7C`), so a coordinate costs about six\n * bytes more than it reads, and a thousand six-decimal points is roughly 22 KB of URL. Past the\n * limit the request never reaches the gateway: the caller gets an edge 414 with no error\n * envelope to explain it, which is the least legible failure in the system. So the check is\n * here, against the real encoded URL, and the message says what actually fits.\n */\nexport const MAX_REQUEST_URL_BYTES = 16384;\n\n/** Headroom under the edge limit, so a proxy that appends a parameter cannot tip a request over. */\nconst URL_HEADROOM_BYTES = 256;\n\nexport class ElevationError extends Error {\n  constructor(\n    public readonly status: number,\n    message: string,\n    /** The gateway's machine-readable `code`, when the response carried one. */\n    public readonly code?: string,\n  ) {\n    super(message);\n    this.name = \"ElevationError\";\n  }\n}\n\ninterface ElevationResponse {\n  elevations: (number | null)[];\n  units: \"m\";\n  datum: string;\n  resolution: number;\n}\n\n/**\n * Typed client for the unmap elevation API (gateway `/elevation`).\n *\n * Heights are metres above CGVD2013. `null` means the dataset covers nothing at that coordinate;\n * it never means sea level, and the client does not substitute a number for it.\n */\nexport class Elevation {\n  private readonly key: string;\n  private readonly base: string;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(opts: ElevationOptions) {\n    this.key = opts.key;\n    this.base = (opts.gateway ?? DEFAULT_GATEWAY).replace(/\\/+$/, \"\");\n    // Bound to globalThis for the same reason Router does it: a bare `fetch` stored on an\n    // instance is invoked with that instance as its receiver, which browsers reject.\n    this.fetchImpl = opts.fetch ?? globalThis.fetch.bind(globalThis);\n  }\n\n  /**\n   * Ground elevation in metres, one entry per coordinate, in the order asked.\n   *\n   * Always an array, whether you passed one coordinate or a thousand, so the single and batch\n   * cases are the same call:\n   *\n   *   const [metres] = await unmap.elevation.get([-114.0719, 51.0447]);\n   */\n  async get(\n    points: LngLat | LngLat[],\n    opts: { signal?: AbortSignal } = {},\n  ): Promise<(number | null)[]> {\n    const list: LngLat[] = isSingle(points) ? [points] : points;\n    if (list.length === 0) return [];\n    if (list.length > MAX_ELEVATION_POINTS) {\n      throw new ElevationError(400, `elevation.get takes at most ${MAX_ELEVATION_POINTS} coordinates`);\n    }\n\n    const q = new URLSearchParams({ key: this.key });\n    if (list.length === 1) {\n      // Safe: the length check above guarantees index 0 exists.\n      const [lon, lat] = list[0]!;\n      q.set(\"lon\", String(lon));\n      q.set(\"lat\", String(lat));\n    } else {\n      q.set(\"points\", list.map(([lng, lat]) => `${lng},${lat}`).join(\"|\"));\n    }\n\n    const target = `${this.base}/elevation?${q}`;\n    const bytes = new TextEncoder().encode(target).length;\n    const budget = MAX_REQUEST_URL_BYTES - URL_HEADROOM_BYTES;\n    if (bytes > budget) {\n      // Scaled from the URL actually built, so the number quoted reflects this caller's own\n      // coordinate precision rather than an average of somebody else's.\n      const fits = Math.max(1, Math.floor((list.length * budget) / bytes));\n      throw new ElevationError(\n        414,\n        `elevation.get built a ${bytes} byte request URL; this client sends at most ${budget} ` +\n          `bytes, keeping headroom under the edge's ${MAX_REQUEST_URL_BYTES} byte limit. Send ` +\n          `at most about ${fits} of these coordinates per request (roughly 700 at six decimal ` +\n          `places).`,\n      );\n    }\n\n    const res = await this.fetchImpl(target, {\n      signal: opts.signal,\n      headers: { accept: \"application/json\" },\n    });\n    if (!res.ok) throw await errorFrom(res);\n    const body = (await res.json()) as ElevationResponse;\n    return body.elevations;\n  }\n}\n\n/** `[number, number]` is a coordinate; `[[number, number], ...]` is a list of them. */\nfunction isSingle(points: LngLat | LngLat[]): points is LngLat {\n  return typeof points[0] === \"number\";\n}\n\nasync function errorFrom(res: { status: number; json(): Promise<unknown> }): Promise<ElevationError> {\n  const fallback = `elevation ${res.status}`;\n  let body: { error?: unknown; code?: unknown } | undefined;\n  try {\n    body = (await res.json()) as { error?: unknown; code?: unknown };\n  } catch {\n    body = undefined;\n  }\n  const reason = typeof body?.error === \"string\" ? body.error : undefined;\n  const code = typeof body?.code === \"string\" ? body.code : undefined;\n  return new ElevationError(res.status, reason ? `${reason} (${fallback})` : fallback, code);\n}\n"],"mappings":";AAAA,SAAS,uBAAuB;AAczB,IAAM,uBAAuB;AAY7B,IAAM,wBAAwB;AAGrC,IAAM,qBAAqB;AAEpB,IAAM,iBAAN,cAA6B,MAAM;AAAA,EACxC,YACkB,QAChB,SAEgB,MAChB;AACA,UAAM,OAAO;AALG;AAGA;AAGhB,SAAK,OAAO;AAAA,EACd;AAAA,EAPkB;AAAA,EAGA;AAKpB;AAeO,IAAM,YAAN,MAAgB;AAAA,EACJ;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,YAAY,MAAwB;AAClC,SAAK,MAAM,KAAK;AAChB,SAAK,QAAQ,KAAK,WAAW,iBAAiB,QAAQ,QAAQ,EAAE;AAGhE,SAAK,YAAY,KAAK,SAAS,WAAW,MAAM,KAAK,UAAU;AAAA,EACjE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,IACJ,QACA,OAAiC,CAAC,GACN;AAC5B,UAAM,OAAiB,SAAS,MAAM,IAAI,CAAC,MAAM,IAAI;AACrD,QAAI,KAAK,WAAW,EAAG,QAAO,CAAC;AAC/B,QAAI,KAAK,SAAS,sBAAsB;AACtC,YAAM,IAAI,eAAe,KAAK,+BAA+B,oBAAoB,cAAc;AAAA,IACjG;AAEA,UAAM,IAAI,IAAI,gBAAgB,EAAE,KAAK,KAAK,IAAI,CAAC;AAC/C,QAAI,KAAK,WAAW,GAAG;AAErB,YAAM,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC;AACzB,QAAE,IAAI,OAAO,OAAO,GAAG,CAAC;AACxB,QAAE,IAAI,OAAO,OAAO,GAAG,CAAC;AAAA,IAC1B,OAAO;AACL,QAAE,IAAI,UAAU,KAAK,IAAI,CAAC,CAAC,KAAK,GAAG,MAAM,GAAG,GAAG,IAAI,GAAG,EAAE,EAAE,KAAK,GAAG,CAAC;AAAA,IACrE;AAEA,UAAM,SAAS,GAAG,KAAK,IAAI,cAAc,CAAC;AAC1C,UAAM,QAAQ,IAAI,YAAY,EAAE,OAAO,MAAM,EAAE;AAC/C,UAAM,SAAS,wBAAwB;AACvC,QAAI,QAAQ,QAAQ;AAGlB,YAAM,OAAO,KAAK,IAAI,GAAG,KAAK,MAAO,KAAK,SAAS,SAAU,KAAK,CAAC;AACnE,YAAM,IAAI;AAAA,QACR;AAAA,QACA,yBAAyB,KAAK,gDAAgD,MAAM,6CACtC,qBAAqB,mCAChD,IAAI;AAAA,MAEzB;AAAA,IACF;AAEA,UAAM,MAAM,MAAM,KAAK,UAAU,QAAQ;AAAA,MACvC,QAAQ,KAAK;AAAA,MACb,SAAS,EAAE,QAAQ,mBAAmB;AAAA,IACxC,CAAC;AACD,QAAI,CAAC,IAAI,GAAI,OAAM,MAAM,UAAU,GAAG;AACtC,UAAM,OAAQ,MAAM,IAAI,KAAK;AAC7B,WAAO,KAAK;AAAA,EACd;AACF;AAGA,SAAS,SAAS,QAA6C;AAC7D,SAAO,OAAO,OAAO,CAAC,MAAM;AAC9B;AAEA,eAAe,UAAU,KAA4E;AACnG,QAAM,WAAW,aAAa,IAAI,MAAM;AACxC,MAAI;AACJ,MAAI;AACF,WAAQ,MAAM,IAAI,KAAK;AAAA,EACzB,QAAQ;AACN,WAAO;AAAA,EACT;AACA,QAAM,SAAS,OAAO,MAAM,UAAU,WAAW,KAAK,QAAQ;AAC9D,QAAM,OAAO,OAAO,MAAM,SAAS,WAAW,KAAK,OAAO;AAC1D,SAAO,IAAI,eAAe,IAAI,QAAQ,SAAS,GAAG,MAAM,KAAK,QAAQ,MAAM,UAAU,IAAI;AAC3F;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { DEFAULT_GATEWAY, UnmapError, fetchWithRetry, parseRetryAfter, type RetryPolicy } from \"@unmap/core\";\n\n/** [longitude, latitude]. Longitude first, everywhere in unmap. Not exported: `@unmap/routing`\n *  already exports a `LngLat` of the same shape, and both packages land in `@unmap/sdk`'s star\n *  exports, where two same-named exports would be a type error. */\ntype LngLat = [number, number];\n\nexport interface ElevationOptions {\n  key: string;\n  gateway?: string;\n  fetch?: typeof fetch;\n  /**\n   * Retry policy for `429`, `502`, `503` and transport failures. `false` disables it.\n   *\n   * On by default. `Retry-After` is on a `429` other than `billing_required`, and on a container\n   * `503`. A `502` has none: routing uses `routing_failed`, and `/elevation` uses\n   * `upstream_error`. With no header the client backs off itself. A wait longer than\n   * `maxDelayMs` (10 s) is not slept through; the error carries `retryAfterSeconds` instead.\n   * See `RetryPolicy` in `@unmap/core`.\n   */\n  retry?: RetryPolicy | false;\n}\n\n/** The gateway's own cap. Checked here so an over-long batch fails without spending a call. */\nexport const MAX_ELEVATION_POINTS = 1000;\n\n/**\n * Cloudflare refuses a request URL longer than this at the edge, before the Worker runs.\n *\n * It bites well before `MAX_ELEVATION_POINTS` does. `URLSearchParams` percent-encodes both of\n * the batch separators (`,` becomes `%2C`, `|` becomes `%7C`), so a coordinate costs about six\n * bytes more than it reads, and a thousand six-decimal points is roughly 22 KB of URL. Past the\n * limit the request never reaches the gateway: the caller gets an edge 414 with no error\n * envelope to explain it, which is the least legible failure in the system. So the check is\n * here, against the real encoded URL, and the message says what actually fits.\n */\nexport const MAX_REQUEST_URL_BYTES = 16384;\n\n/** Headroom under the edge limit, so a proxy that appends a parameter cannot tip a request over. */\nconst URL_HEADROOM_BYTES = 256;\n\n/**\n * An elevation failure.\n *\n * Extends `UnmapError`, so `catch (e) { if (e instanceof UnmapError) }` catches this alongside\n * every other unmap client's errors. `instanceof ElevationError` keeps working, and `status` and `code`\n * are still where they were; `retryAfterSeconds` is new and comes from the header.\n */\nexport class ElevationError extends UnmapError {\n  constructor(status: number, message: string, code?: string, retryAfterSeconds?: number) {\n    super(status, message, code, retryAfterSeconds);\n    this.name = \"ElevationError\";\n  }\n}\n\ninterface ElevationResponse {\n  elevations: (number | null)[];\n  units: \"m\";\n  datum: string;\n  resolution: number | null;\n  model?: \"mixed\";\n  sampling?: { zoom: number; tile_size: number; height_increment_m: number; interpolation: \"bilinear\" };\n}\n\n/**\n * Typed client for the unmap elevation API (gateway `/elevation`).\n *\n * Heights are metres in the active DEM's vertical datum. The global Mapterhorn mosaic mixes\n * terrain/surface models and vertical datums; Canadian rollback uses CGVD2013. `null` means\n * missing data, and the client does not substitute a number for it. See /coverage.json and\n * the HTTP response's metadata for the active release and its limitations.\n */\nexport class Elevation {\n  private readonly key: string;\n  private readonly base: string;\n  private readonly fetchImpl: typeof fetch;\n  private readonly retry: RetryPolicy | false | undefined;\n\n  constructor(opts: ElevationOptions) {\n    this.retry = opts.retry;\n    this.key = opts.key;\n    this.base = (opts.gateway ?? DEFAULT_GATEWAY).replace(/\\/+$/, \"\");\n    // Bound to globalThis for the same reason Router does it: a bare `fetch` stored on an\n    // instance is invoked with that instance as its receiver, which browsers reject.\n    this.fetchImpl = opts.fetch ?? globalThis.fetch.bind(globalThis);\n  }\n\n  /**\n   * DEM elevation in metres, one entry per coordinate, in the order asked.\n   *\n   * Always an array, whether you passed one coordinate or a thousand, so the single and batch\n   * cases are the same call:\n   *\n   *   const [metres] = await unmap.elevation.get([-114.0719, 51.0447]);\n   */\n  async get(\n    points: LngLat | LngLat[],\n    opts: { signal?: AbortSignal } = {},\n  ): Promise<(number | null)[]> {\n    const list: LngLat[] = isSingle(points) ? [points] : points;\n    if (list.length === 0) return [];\n    if (list.length > MAX_ELEVATION_POINTS) {\n      throw new ElevationError(400, `elevation.get takes at most ${MAX_ELEVATION_POINTS} coordinates`);\n    }\n\n    const q = new URLSearchParams({ key: this.key });\n    if (list.length === 1) {\n      // Safe: the length check above guarantees index 0 exists.\n      const [lon, lat] = list[0]!;\n      q.set(\"lon\", String(lon));\n      q.set(\"lat\", String(lat));\n    } else {\n      q.set(\"points\", list.map(([lng, lat]) => `${lng},${lat}`).join(\"|\"));\n    }\n\n    const target = `${this.base}/elevation?${q}`;\n    const bytes = new TextEncoder().encode(target).length;\n    const budget = MAX_REQUEST_URL_BYTES - URL_HEADROOM_BYTES;\n    if (bytes > budget) {\n      // Scaled from the URL actually built, so the number quoted reflects this caller's own\n      // coordinate precision rather than an average of somebody else's.\n      const fits = Math.max(1, Math.floor((list.length * budget) / bytes));\n      throw new ElevationError(\n        414,\n        `elevation.get built a ${bytes} byte request URL; this client sends at most ${budget} ` +\n          `bytes, keeping headroom under the edge's ${MAX_REQUEST_URL_BYTES} byte limit. Send ` +\n          `at most about ${fits} of these coordinates per request (roughly 700 at six decimal ` +\n          `places).`,\n      );\n    }\n\n    const res = await fetchWithRetry(\n      this.fetchImpl,\n      target,\n      { signal: opts.signal, headers: { accept: \"application/json\" } },\n      this.retry,\n    );\n    if (!res.ok) throw await errorFrom(res);\n    const body = (await res.json()) as ElevationResponse;\n    return body.elevations;\n  }\n}\n\n/** `[number, number]` is a coordinate; `[[number, number], ...]` is a list of them. */\nfunction isSingle(points: LngLat | LngLat[]): points is LngLat {\n  return typeof points[0] === \"number\";\n}\n\nasync function errorFrom(res: { status: number; headers?: Headers; json(): Promise<unknown> }): Promise<ElevationError> {\n  const fallback = `elevation ${res.status}`;\n  let body: { error?: unknown; code?: unknown } | undefined;\n  try {\n    body = (await res.json()) as { error?: unknown; code?: unknown };\n  } catch {\n    body = undefined;\n  }\n  const reason = typeof body?.error === \"string\" ? body.error : undefined;\n  const code = typeof body?.code === \"string\" ? body.code : undefined;\n  const retryAfter = parseRetryAfter(res.headers?.get(\"retry-after\") ?? null) ?? undefined;\n  return new ElevationError(res.status, reason ? `${reason} (${fallback})` : fallback, code, retryAfter);\n}\n\n// The shared error type and retry policy, re-exported so a caller who installed only this\n// package can `catch (e) { if (e instanceof UnmapError) }` without adding @unmap/core.\nexport { UnmapError, parseRetryAfter, type RetryPolicy } from \"@unmap/core\";\n"],"mappings":"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","names":["UnmapError","parseRetryAfter"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@unmap/elevation",
-  "version": "0.13.0",
-  "description": "Typed client for the unmap elevation API (Canadian ground elevation)",
+  "version": "0.15.0",
+  "description": "Typed client for the unmap DEM elevation API",
   "license": "MIT",
   "keywords": [
     "unmap",
@@ -10,7 +10,7 @@
     "terrain",
     "canada"
   ],
-  "homepage": "https://unmap.dev/docs/elevation-api",
+  "homepage": "https://unmap.dev/docs/apis/elevation",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/unmap-dev/unmap.git",
@@ -37,7 +37,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@unmap/core": "0.13.0"
+    "@unmap/core": "0.15.0"
   },
   "devDependencies": {
     "tsup": "^8.3.0",