@unmap/sdk 0.10.0 → 0.13.0

package/README.md

@@ -26,6 +26,21 @@ await unmap.router.route([-114.07, 51.05], [-113.99, 51.05], { mode: 'bicycle' }
 await unmap.router.isochrone([-114.07, 51.05], { minutes: [10, 20] })
 ```
 
+## Without a build step
+
+The same SDK loads from a script tag, with MapLibre already inside it:
+
+```html
+<link rel="stylesheet" href="https://cdn.unmap.dev/sdk/0.13.0/unmap.css">
+<div id="map" style="height: 400px"></div>
+<script src="https://cdn.unmap.dev/sdk/0.13.0/unmap.js"></script>
+<script>
+  unmap.createMap({ key: 'um_live_...', container: '#map', center: [-114.07, 51.05] })
+</script>
+```
+
+Everything above is on the `unmap` global: `unmap.Unmap`, `unmap.Geocoder`, `unmap.Router`, `unmap.maplibregl`. Pin the exact version in production; `/sdk/0.13/` follows patches and `/sdk/latest/` follows everything.
+
 ## Options
 
 | Option      | Type                    | Notes                                                                        |

package/dist/index.d.ts

@@ -1,13 +1,196 @@
-import { Map, UnmapMapOptions, UnmapControlsOptions } from '@unmap/maps';
-export { DEMO_CITIES, DemoCity, Map, Projection, STYLE_NAMES, StyleInput, StyleName, UnmapControlsOptions, UnmapMapOptions, createMap, maplibregl, unmapStyle } from '@unmap/maps';
-import { Geocoder } from '@unmap/geocoding';
+import { Map, MapProfile, UnmapMapOptions, UnmapControlsOptions } from '@unmap/maps';
+export { DEMO_CITIES, DemoCity, Map, MapProfile, Projection, STYLE_NAMES, StyleInput, StyleName, UnmapControlsOptions, UnmapMapOptions, createMap, maplibregl, unmapStyle } from '@unmap/maps';
+import { Geocoder, Places, QueryOptions, QueryResponse, IdentifyOptions, IdentifyResponse } from '@unmap/geocoding';
 export * from '@unmap/geocoding';
 import { Router } from '@unmap/routing';
 export * from '@unmap/routing';
+import { Elevation } from '@unmap/elevation';
+export * from '@unmap/elevation';
+
+/**
+ * Typed clients for road events (`/incidents`, `/closures`, `/road-conditions`) and for data
+ * correction (`POST /feedback`).
+ *
+ * These live in `@unmap/sdk` rather than in packages of their own. A twelfth and thirteenth npm
+ * package would each need an entry in the changesets fixed group and a trusted publisher
+ * configured on npmjs.com, which is founder work, and neither has a framework wrapper the way
+ * geocoding and routing do. If a customer ever wants roads without the rest of the SDK, that is
+ * the moment to split it out.
+ */
+type RoadEventType = "closure" | "incident" | "construction" | "weather" | "restriction" | "ferry" | "hazard" | "special_event" | "unknown";
+type RoadCondition = "dry" | "wet" | "snow" | "ice" | "packed_snow" | "reduced_visibility" | "travel_not_recommended" | "closed" | "unknown";
+type RoadSeverity = "minor" | "major" | "unknown";
+interface AffectedRoad {
+    name: string;
+    direction: "north" | "south" | "east" | "west" | "both" | "unknown";
+    /** True only when the publisher says closed. Never inferred from the description. */
+    closed: boolean;
+    from?: string;
+    to?: string;
+    condition: RoadCondition;
+}
+interface RoadEvent {
+    /** `um:road:<jurisdiction>:<publisher id>`. */
+    id: string;
+    /** The publisher's own id, so a report can be taken back to them. */
+    source_id: string;
+    /** ISO 3166-2, e.g. `CA-BC`. */
+    jurisdiction: string;
+    type: RoadEventType;
+    /** The publisher's own subtype strings, untranslated. */
+    subtypes: string[];
+    status: "active" | "planned" | "archived";
+    severity: RoadSeverity;
+    /**
+     * The publisher's description, verbatim.
+     *
+     * Believe this over `type` when they disagree: our categories are a lossy projection of someone
+     * else's taxonomy, and the sentence a driver needs is in the prose.
+     */
+    description: string;
+    headline?: string;
+    /** The worst surface condition across this event's roads. */
+    condition: RoadCondition;
+    roads: AffectedRoad[];
+    /** GeoJSON Point or LineString, WGS84. */
+    geometry: {
+        type: string;
+        coordinates: unknown;
+    } | null;
+    starts_at: string | null;
+    ends_at: string | null;
+    source_updated_at: string | null;
+    unmap_updated_at: string;
+    source: string;
+}
+interface RoadEventsResponse {
+    data: RoadEvent[];
+    meta: {
+        status: "current" | "stale" | "partial" | "unknown";
+        attribution: string;
+        unmap_updated_at: string;
+        /**
+         * Jurisdictions that could not be reached, each with a reason.
+         *
+         * **Check this.** On `/closures` an empty `data` reads as "nothing is shut" to someone
+         * deciding whether to drive, and that is a very different answer from "we could not reach
+         * British Columbia".
+         */
+        unavailable?: {
+            jurisdiction: string;
+            reason: string;
+        }[];
+    };
+}
+interface RoadEventQuery {
+    /** Comma-separated ISO 3166-2 codes, or an array. An uncovered code is a 400, not an empty list. */
+    jurisdiction?: string | readonly string[];
+    bbox?: [number, number, number, number];
+    near?: [number, number];
+    /** Metres from `near`. Default 25000, max 500000. */
+    radius?: number;
+    type?: RoadEventType | readonly RoadEventType[];
+    severity?: RoadSeverity | readonly RoadSeverity[];
+    status?: "active" | "planned" | "archived";
+    /** ISO 8601. Only events the publisher changed at or after this time. */
+    updated_since?: string;
+    /** 1 to 500, default 100. Applied AFTER the endpoint's own narrowing. */
+    limit?: number;
+    signal?: AbortSignal;
+}
+interface RoadsOptions {
+    key: string;
+    gateway?: string;
+    fetch?: typeof fetch;
+}
+declare class RoadsError extends Error {
+    readonly status: number;
+    readonly code?: string | undefined;
+    constructor(status: number, message: string, code?: string | undefined);
+}
+/**
+ * Canadian road events.
+ *
+ *   const { data, meta } = await unmap.roads.closures({ jurisdiction: "CA-BC" });
+ *
+ * A 503 means every requested jurisdiction was unreachable; the body still carries
+ * `meta.unavailable`, so the thrown error is the exception rather than the information. Prefer
+ * reading `meta.unavailable` on a 200 over treating an empty list as good news.
+ */
+declare class Roads {
+    private readonly key;
+    private readonly base;
+    private readonly fetchImpl;
+    constructor(opts: RoadsOptions);
+    /** Every current road event. */
+    incidents(query?: RoadEventQuery): Promise<RoadEventsResponse>;
+    /** The subset where a road is actually shut. Narrowed before `limit` is applied. */
+    closures(query?: RoadEventQuery): Promise<RoadEventsResponse>;
+    /**
+     * The subset carrying a surface condition.
+     *
+     * Thin for British Columbia by design: its feed reports lane availability rather than the
+     * surface, so unmap answers `unknown` instead of inferring a dry road from open lanes.
+     */
+    conditions(query?: RoadEventQuery): Promise<RoadEventsResponse>;
+    private request;
+}
+type FeedbackProduct = "tiles" | "terrain" | "names" | "geocoding" | "places" | "routing" | "layers" | "transit" | "roads" | "ev";
+type FeedbackCategory = "incorrect_location" | "incorrect_address" | "missing_place" | "wrong_place_name" | "wrong_category" | "bad_route" | "missing_road_closure" | "incorrect_road_condition" | "incorrect_transit_result" | "other";
+interface FeedbackReport {
+    product: FeedbackProduct;
+    category: FeedbackCategory;
+    /** Up to 2000 characters, stored exactly as written. One of this or `resultId` is required. */
+    description?: string;
+    /** The unmap id of the result being reported. */
+    resultId?: string;
+    /**
+     * The request being reported.
+     *
+     * **Only send this with the reporter's explicit agreement.** The gateway refuses it without
+     * `include_context: true`, which this sets whenever `context` is present, and that flag is
+     * meant to record a person's choice rather than a client default. unmap redacts query strings
+     * from its own logs; a client that attached them here would undo that.
+     */
+    context?: unknown;
+    signal?: AbortSignal;
+}
+interface FeedbackReceipt {
+    /** Quote this in a follow-up. */
+    id: string;
+    status: string;
+    created_at: string;
+    /** Whether a request context was actually kept. `false` when none was offered. */
+    context_stored: boolean;
+}
+/**
+ * Report wrong data.
+ *
+ *   await unmap.feedback.submit({
+ *     product: "geocoding",
+ *     category: "incorrect_location",
+ *     description: "17 Ave SW returns a street in Edmonton.",
+ *   });
+ *
+ * Authenticated like everything else and **never metered**: telling us our data is wrong does not
+ * cost a call. At most 200 reports per account per day.
+ */
+declare class Feedback {
+    private readonly key;
+    private readonly base;
+    private readonly fetchImpl;
+    constructor(opts: RoadsOptions);
+    submit(report: FeedbackReport): Promise<FeedbackReceipt>;
+    /** A report about one place. `product` and `result_id` come from the path. */
+    aboutPlace(placeId: string, report: Omit<FeedbackReport, "product" | "resultId">): Promise<FeedbackReceipt>;
+    private post;
+}
 
 interface UnmapOptions {
     key: string;
     gateway?: string;
+    /** Override the fetch implementation (tests, non-global environments). */
+    fetch?: typeof fetch;
     /** If provided, a map is mounted in this container. */
     container?: string | HTMLElement;
     style?: string;
@@ -18,6 +201,10 @@ interface UnmapOptions {
     lang?: string;
     /** Compact `ut1.` theme code from unmap.dev/create. Wins over the path style on the gateway. */
     theme?: string;
+    /** Catalog layer ids composed onto the style (`municipalities`, `survey.dls`, …). */
+    overlays?: readonly string[];
+    /** Composition preset. Not a style. Explicit overlays replace the profile list. */
+    profile?: MapProfile;
     /** `"globe"` or `"mercator"`. See `@unmap/maps` `UnmapMapOptions.projection`. */
     projection?: UnmapMapOptions["projection"];
     center?: [number, number];
@@ -27,15 +214,27 @@ interface UnmapOptions {
 }
 /**
  * One Stripe-style key, the whole platform. With a `container` you get a rendered map;
- * `geocoder` and `router` are always available.
+ * `geocoder`, `router` and `elevation` are always available.
  *
  *   const map = new Unmap({ key: "um_live_...", container: "#map", center: [-75.69, 45.42] });
  */
 declare class Unmap {
     readonly geocoder: Geocoder;
     readonly router: Router;
+    readonly elevation: Elevation;
+    /** Canadian points of interest. Same corpus as the geocoder, in the Place shape. */
+    readonly places: Places;
+    /** Closures, incidents, construction and road conditions. */
+    readonly roads: Roads;
+    /** Report wrong data. Never metered. */
+    readonly feedback: Feedback;
+    readonly data: {
+        query(opts: QueryOptions): Promise<QueryResponse>;
+    };
     readonly map?: Map;
     constructor(opts: UnmapOptions);
+    /** Which catalog features contain a point. See `Geocoder.identify`. */
+    identify(opts: IdentifyOptions): Promise<IdentifyResponse>;
 }
 
-export { Unmap, type UnmapOptions };
+export { type AffectedRoad, Feedback, type FeedbackCategory, type FeedbackProduct, type FeedbackReceipt, type FeedbackReport, type RoadCondition, type RoadEvent, type RoadEventQuery, type RoadEventType, type RoadEventsResponse, type RoadSeverity, Roads, RoadsError, type RoadsOptions, Unmap, type UnmapOptions };

package/dist/index.js

@@ -2,25 +2,163 @@
 import {
   createMap
 } from "@unmap/maps";
-import { Geocoder } from "@unmap/geocoding";
+import { Geocoder, Places } from "@unmap/geocoding";
+
+// src/roads.ts
+import { DEFAULT_GATEWAY } from "@unmap/core";
+var RoadsError = class extends Error {
+  constructor(status, message, code) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.name = "RoadsError";
+  }
+  status;
+  code;
+};
+function list(value) {
+  if (value === void 0) return void 0;
+  return Array.isArray(value) ? value.join(",") : String(value);
+}
+async function errorFrom(res, path, name) {
+  const fallback = `${name} ${res.status} on ${path}`;
+  let body;
+  try {
+    body = await res.json();
+  } catch {
+    body = void 0;
+  }
+  const reason = typeof body?.error === "string" ? body.error : void 0;
+  const code = typeof body?.code === "string" ? body.code : void 0;
+  return new RoadsError(res.status, reason ? `${reason} (${fallback})` : fallback, code);
+}
+var Roads = class {
+  key;
+  base;
+  fetchImpl;
+  constructor(opts) {
+    this.key = opts.key;
+    this.base = (opts.gateway ?? DEFAULT_GATEWAY).replace(/\/+$/, "");
+    this.fetchImpl = opts.fetch ?? globalThis.fetch.bind(globalThis);
+  }
+  /** Every current road event. */
+  incidents(query = {}) {
+    return this.request("/incidents", query);
+  }
+  /** The subset where a road is actually shut. Narrowed before `limit` is applied. */
+  closures(query = {}) {
+    return this.request("/closures", query);
+  }
+  /**
+   * The subset carrying a surface condition.
+   *
+   * Thin for British Columbia by design: its feed reports lane availability rather than the
+   * surface, so unmap answers `unknown` instead of inferring a dry road from open lanes.
+   */
+  conditions(query = {}) {
+    return this.request("/road-conditions", query);
+  }
+  async request(path, query) {
+    const q = new URLSearchParams({ key: this.key });
+    const params = {
+      jurisdiction: list(query.jurisdiction),
+      bbox: query.bbox?.join(","),
+      near: query.near?.join(","),
+      radius: query.radius != null ? String(query.radius) : void 0,
+      type: list(query.type),
+      severity: list(query.severity),
+      status: query.status,
+      updated_since: query.updated_since,
+      limit: query.limit != null ? String(query.limit) : void 0
+    };
+    for (const [k, v] of Object.entries(params)) if (v != null && v !== "") q.set(k, v);
+    const res = await this.fetchImpl(`${this.base}${path}?${q}`, {
+      signal: query.signal,
+      headers: { accept: "application/json" }
+    });
+    if (!res.ok) throw await errorFrom(res, path, "roads");
+    return await res.json();
+  }
+};
+var Feedback = class {
+  key;
+  base;
+  fetchImpl;
+  constructor(opts) {
+    this.key = opts.key;
+    this.base = (opts.gateway ?? DEFAULT_GATEWAY).replace(/\/+$/, "");
+    this.fetchImpl = opts.fetch ?? globalThis.fetch.bind(globalThis);
+  }
+  submit(report) {
+    return this.post("/feedback", {
+      product: report.product,
+      category: report.category,
+      ...report.description ? { description: report.description } : {},
+      ...report.resultId ? { result_id: report.resultId } : {},
+      ...report.context !== void 0 ? { include_context: true, context: report.context } : {}
+    }, report.signal);
+  }
+  /** A report about one place. `product` and `result_id` come from the path. */
+  aboutPlace(placeId, report) {
+    return this.post(`/places/${encodeURIComponent(placeId)}/feedback`, {
+      category: report.category,
+      ...report.description ? { description: report.description } : {},
+      ...report.context !== void 0 ? { include_context: true, context: report.context } : {}
+    }, report.signal);
+  }
+  async post(path, body, signal) {
+    const res = await this.fetchImpl(`${this.base}${path}`, {
+      method: "POST",
+      signal,
+      headers: { "content-type": "application/json", authorization: `Bearer ${this.key}` },
+      body: JSON.stringify(body)
+    });
+    if (!res.ok) throw await errorFrom(res, path, "feedback");
+    return await res.json();
+  }
+};
+
+// src/index.ts
 import { Router } from "@unmap/routing";
+import { Elevation } from "@unmap/elevation";
 export * from "@unmap/geocoding";
 export * from "@unmap/routing";
+export * from "@unmap/elevation";
 import { createMap as createMap2, unmapStyle, DEMO_CITIES, STYLE_NAMES, maplibregl } from "@unmap/maps";
 var Unmap = class {
   geocoder;
   router;
+  elevation;
+  /** Canadian points of interest. Same corpus as the geocoder, in the Place shape. */
+  places;
+  /** Closures, incidents, construction and road conditions. */
+  roads;
+  /** Report wrong data. Never metered. */
+  feedback;
+  data;
   map;
   constructor(opts) {
     this.geocoder = new Geocoder(opts);
     this.router = new Router(opts);
+    this.elevation = new Elevation(opts);
+    this.places = new Places(opts);
+    this.roads = new Roads(opts);
+    this.feedback = new Feedback(opts);
+    this.data = { query: (queryOpts) => this.geocoder.queryLayer(queryOpts) };
     if (opts.container) {
       this.map = createMap({ ...opts, container: opts.container });
     }
   }
+  /** Which catalog features contain a point. See `Geocoder.identify`. */
+  identify(opts) {
+    return this.geocoder.identify(opts);
+  }
 };
 export {
   DEMO_CITIES,
+  Feedback,
+  Roads,
+  RoadsError,
   STYLE_NAMES,
   Unmap,
   createMap2 as createMap,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import {\n  createMap,\n  type Map as MaplibreMap,\n  type UnmapControlsOptions,\n  type UnmapMapOptions,\n} from \"@unmap/maps\";\nimport { Geocoder } from \"@unmap/geocoding\";\nimport { Router } from \"@unmap/routing\";\n\nexport * from \"@unmap/geocoding\";\nexport * from \"@unmap/routing\";\nexport { createMap, unmapStyle, DEMO_CITIES, STYLE_NAMES, maplibregl } from \"@unmap/maps\";\nexport type {\n  Map,\n  UnmapMapOptions,\n  UnmapControlsOptions,\n  DemoCity,\n  StyleName,\n  StyleInput,\n  Projection,\n} from \"@unmap/maps\";\n\nexport interface UnmapOptions {\n  key: string;\n  gateway?: string;\n  /** If provided, a map is mounted in this container. */\n  container?: string | HTMLElement;\n  style?: string;\n  flavor?: string;\n  /** \"light\" or \"dark\". Selects the mode half of the named style. */\n  mode?: string;\n  /** Label language, e.g. \"fr\". Omit to follow the request's Accept-Language. */\n  lang?: string;\n  /** Compact `ut1.` theme code from unmap.dev/create. Wins over the path style on the gateway. */\n  theme?: string;\n  /** `\"globe\"` or `\"mercator\"`. See `@unmap/maps` `UnmapMapOptions.projection`. */\n  projection?: UnmapMapOptions[\"projection\"];\n  center?: [number, number];\n  zoom?: number;\n  /** On-map controls. `true` (the default) adds zoom and compass buttons; `false` adds none. */\n  controls?: boolean | UnmapControlsOptions;\n}\n\n/**\n * One Stripe-style key, the whole platform. With a `container` you get a rendered map;\n * `geocoder` and `router` are always available.\n *\n *   const map = new Unmap({ key: \"um_live_...\", container: \"#map\", center: [-75.69, 45.42] });\n */\nexport class Unmap {\n  readonly geocoder: Geocoder;\n  readonly router: Router;\n  readonly map?: MaplibreMap;\n\n  constructor(opts: UnmapOptions) {\n    this.geocoder = new Geocoder(opts);\n    this.router = new Router(opts);\n    if (opts.container) {\n      this.map = createMap({ ...opts, container: opts.container } as UnmapMapOptions);\n    }\n  }\n}\n"],"mappings":";AAAA;AAAA,EACE;AAAA,OAIK;AACP,SAAS,gBAAgB;AACzB,SAAS,cAAc;AAEvB,cAAc;AACd,cAAc;AACd,SAAS,aAAAA,YAAW,YAAY,aAAa,aAAa,kBAAkB;AAsCrE,IAAM,QAAN,MAAY;AAAA,EACR;AAAA,EACA;AAAA,EACA;AAAA,EAET,YAAY,MAAoB;AAC9B,SAAK,WAAW,IAAI,SAAS,IAAI;AACjC,SAAK,SAAS,IAAI,OAAO,IAAI;AAC7B,QAAI,KAAK,WAAW;AAClB,WAAK,MAAM,UAAU,EAAE,GAAG,MAAM,WAAW,KAAK,UAAU,CAAoB;AAAA,IAChF;AAAA,EACF;AACF;","names":["createMap"]}
+{"version":3,"sources":["../src/index.ts","../src/roads.ts"],"sourcesContent":["import {\n  createMap,\n  type Map as MaplibreMap,\n  type MapProfile,\n  type UnmapControlsOptions,\n  type UnmapMapOptions,\n} from \"@unmap/maps\";\nimport { Geocoder, Places, type IdentifyOptions, type IdentifyResponse, type QueryOptions, type QueryResponse } from \"@unmap/geocoding\";\nimport { Feedback, Roads } from \"./roads\";\nimport { Router } from \"@unmap/routing\";\nimport { Elevation } from \"@unmap/elevation\";\n\nexport * from \"@unmap/geocoding\";\nexport * from \"@unmap/routing\";\nexport * from \"@unmap/elevation\";\nexport * from \"./roads\";\nexport { createMap, unmapStyle, DEMO_CITIES, STYLE_NAMES, maplibregl } from \"@unmap/maps\";\nexport type {\n  Map,\n  UnmapMapOptions,\n  UnmapControlsOptions,\n  DemoCity,\n  StyleName,\n  StyleInput,\n  Projection,\n  MapProfile,\n} from \"@unmap/maps\";\n\nexport interface UnmapOptions {\n  key: string;\n  gateway?: string;\n  /** Override the fetch implementation (tests, non-global environments). */\n  fetch?: typeof fetch;\n  /** If provided, a map is mounted in this container. */\n  container?: string | HTMLElement;\n  style?: string;\n  flavor?: string;\n  /** \"light\" or \"dark\". Selects the mode half of the named style. */\n  mode?: string;\n  /** Label language, e.g. \"fr\". Omit to follow the request's Accept-Language. */\n  lang?: string;\n  /** Compact `ut1.` theme code from unmap.dev/create. Wins over the path style on the gateway. */\n  theme?: string;\n  /** Catalog layer ids composed onto the style (`municipalities`, `survey.dls`, …). */\n  overlays?: readonly string[];\n  /** Composition preset. Not a style. Explicit overlays replace the profile list. */\n  profile?: MapProfile;\n  /** `\"globe\"` or `\"mercator\"`. See `@unmap/maps` `UnmapMapOptions.projection`. */\n  projection?: UnmapMapOptions[\"projection\"];\n  center?: [number, number];\n  zoom?: number;\n  /** On-map controls. `true` (the default) adds zoom and compass buttons; `false` adds none. */\n  controls?: boolean | UnmapControlsOptions;\n}\n\n/**\n * One Stripe-style key, the whole platform. With a `container` you get a rendered map;\n * `geocoder`, `router` and `elevation` are always available.\n *\n *   const map = new Unmap({ key: \"um_live_...\", container: \"#map\", center: [-75.69, 45.42] });\n */\nexport class Unmap {\n  readonly geocoder: Geocoder;\n  readonly router: Router;\n  readonly elevation: Elevation;\n  /** Canadian points of interest. Same corpus as the geocoder, in the Place shape. */\n  readonly places: Places;\n  /** Closures, incidents, construction and road conditions. */\n  readonly roads: Roads;\n  /** Report wrong data. Never metered. */\n  readonly feedback: Feedback;\n  readonly data: { query(opts: QueryOptions): Promise<QueryResponse> };\n  readonly map?: MaplibreMap;\n\n  constructor(opts: UnmapOptions) {\n    this.geocoder = new Geocoder(opts);\n    this.router = new Router(opts);\n    this.elevation = new Elevation(opts);\n    this.places = new Places(opts);\n    this.roads = new Roads(opts);\n    this.feedback = new Feedback(opts);\n    this.data = { query: (queryOpts) => this.geocoder.queryLayer(queryOpts) };\n    if (opts.container) {\n      this.map = createMap({ ...opts, container: opts.container } as UnmapMapOptions);\n    }\n  }\n\n  /** Which catalog features contain a point. See `Geocoder.identify`. */\n  identify(opts: IdentifyOptions): Promise<IdentifyResponse> {\n    return this.geocoder.identify(opts);\n  }\n}\n","import { DEFAULT_GATEWAY } from \"@unmap/core\";\n\n/**\n * Typed clients for road events (`/incidents`, `/closures`, `/road-conditions`) and for data\n * correction (`POST /feedback`).\n *\n * These live in `@unmap/sdk` rather than in packages of their own. A twelfth and thirteenth npm\n * package would each need an entry in the changesets fixed group and a trusted publisher\n * configured on npmjs.com, which is founder work, and neither has a framework wrapper the way\n * geocoding and routing do. If a customer ever wants roads without the rest of the SDK, that is\n * the moment to split it out.\n */\n\nexport type RoadEventType =\n  | \"closure\"\n  | \"incident\"\n  | \"construction\"\n  | \"weather\"\n  | \"restriction\"\n  | \"ferry\"\n  | \"hazard\"\n  | \"special_event\"\n  | \"unknown\";\n\nexport type RoadCondition =\n  | \"dry\"\n  | \"wet\"\n  | \"snow\"\n  | \"ice\"\n  | \"packed_snow\"\n  | \"reduced_visibility\"\n  | \"travel_not_recommended\"\n  | \"closed\"\n  | \"unknown\";\n\nexport type RoadSeverity = \"minor\" | \"major\" | \"unknown\";\n\nexport interface AffectedRoad {\n  name: string;\n  direction: \"north\" | \"south\" | \"east\" | \"west\" | \"both\" | \"unknown\";\n  /** True only when the publisher says closed. Never inferred from the description. */\n  closed: boolean;\n  from?: string;\n  to?: string;\n  condition: RoadCondition;\n}\n\nexport interface RoadEvent {\n  /** `um:road:<jurisdiction>:<publisher id>`. */\n  id: string;\n  /** The publisher's own id, so a report can be taken back to them. */\n  source_id: string;\n  /** ISO 3166-2, e.g. `CA-BC`. */\n  jurisdiction: string;\n  type: RoadEventType;\n  /** The publisher's own subtype strings, untranslated. */\n  subtypes: string[];\n  status: \"active\" | \"planned\" | \"archived\";\n  severity: RoadSeverity;\n  /**\n   * The publisher's description, verbatim.\n   *\n   * Believe this over `type` when they disagree: our categories are a lossy projection of someone\n   * else's taxonomy, and the sentence a driver needs is in the prose.\n   */\n  description: string;\n  headline?: string;\n  /** The worst surface condition across this event's roads. */\n  condition: RoadCondition;\n  roads: AffectedRoad[];\n  /** GeoJSON Point or LineString, WGS84. */\n  geometry: { type: string; coordinates: unknown } | null;\n  starts_at: string | null;\n  ends_at: string | null;\n  source_updated_at: string | null;\n  unmap_updated_at: string;\n  source: string;\n}\n\nexport interface RoadEventsResponse {\n  data: RoadEvent[];\n  meta: {\n    status: \"current\" | \"stale\" | \"partial\" | \"unknown\";\n    attribution: string;\n    unmap_updated_at: string;\n    /**\n     * Jurisdictions that could not be reached, each with a reason.\n     *\n     * **Check this.** On `/closures` an empty `data` reads as \"nothing is shut\" to someone\n     * deciding whether to drive, and that is a very different answer from \"we could not reach\n     * British Columbia\".\n     */\n    unavailable?: { jurisdiction: string; reason: string }[];\n  };\n}\n\nexport interface RoadEventQuery {\n  /** Comma-separated ISO 3166-2 codes, or an array. An uncovered code is a 400, not an empty list. */\n  jurisdiction?: string | readonly string[];\n  bbox?: [number, number, number, number];\n  near?: [number, number];\n  /** Metres from `near`. Default 25000, max 500000. */\n  radius?: number;\n  type?: RoadEventType | readonly RoadEventType[];\n  severity?: RoadSeverity | readonly RoadSeverity[];\n  status?: \"active\" | \"planned\" | \"archived\";\n  /** ISO 8601. Only events the publisher changed at or after this time. */\n  updated_since?: string;\n  /** 1 to 500, default 100. Applied AFTER the endpoint's own narrowing. */\n  limit?: number;\n  signal?: AbortSignal;\n}\n\nexport interface RoadsOptions {\n  key: string;\n  gateway?: string;\n  fetch?: typeof fetch;\n}\n\nexport class RoadsError extends Error {\n  constructor(\n    public readonly status: number,\n    message: string,\n    public readonly code?: string,\n  ) {\n    super(message);\n    this.name = \"RoadsError\";\n  }\n}\n\nfunction list(value: string | readonly string[] | undefined): string | undefined {\n  if (value === undefined) return undefined;\n  return Array.isArray(value) ? value.join(\",\") : String(value);\n}\n\nasync function errorFrom(res: Response, path: string, name: string): Promise<RoadsError> {\n  const fallback = `${name} ${res.status} on ${path}`;\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 RoadsError(res.status, reason ? `${reason} (${fallback})` : fallback, code);\n}\n\n/**\n * Canadian road events.\n *\n *   const { data, meta } = await unmap.roads.closures({ jurisdiction: \"CA-BC\" });\n *\n * A 503 means every requested jurisdiction was unreachable; the body still carries\n * `meta.unavailable`, so the thrown error is the exception rather than the information. Prefer\n * reading `meta.unavailable` on a 200 over treating an empty list as good news.\n */\nexport class Roads {\n  private readonly key: string;\n  private readonly base: string;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(opts: RoadsOptions) {\n    this.key = opts.key;\n    this.base = (opts.gateway ?? DEFAULT_GATEWAY).replace(/\\/+$/, \"\");\n    this.fetchImpl = opts.fetch ?? globalThis.fetch.bind(globalThis);\n  }\n\n  /** Every current road event. */\n  incidents(query: RoadEventQuery = {}): Promise<RoadEventsResponse> {\n    return this.request(\"/incidents\", query);\n  }\n\n  /** The subset where a road is actually shut. Narrowed before `limit` is applied. */\n  closures(query: RoadEventQuery = {}): Promise<RoadEventsResponse> {\n    return this.request(\"/closures\", query);\n  }\n\n  /**\n   * The subset carrying a surface condition.\n   *\n   * Thin for British Columbia by design: its feed reports lane availability rather than the\n   * surface, so unmap answers `unknown` instead of inferring a dry road from open lanes.\n   */\n  conditions(query: RoadEventQuery = {}): Promise<RoadEventsResponse> {\n    return this.request(\"/road-conditions\", query);\n  }\n\n  private async request(path: string, query: RoadEventQuery): Promise<RoadEventsResponse> {\n    const q = new URLSearchParams({ key: this.key });\n    const params: Record<string, string | undefined> = {\n      jurisdiction: list(query.jurisdiction),\n      bbox: query.bbox?.join(\",\"),\n      near: query.near?.join(\",\"),\n      radius: query.radius != null ? String(query.radius) : undefined,\n      type: list(query.type),\n      severity: list(query.severity),\n      status: query.status,\n      updated_since: query.updated_since,\n      limit: query.limit != null ? String(query.limit) : undefined,\n    };\n    for (const [k, v] of Object.entries(params)) if (v != null && v !== \"\") q.set(k, v);\n\n    const res = await this.fetchImpl(`${this.base}${path}?${q}`, {\n      signal: query.signal,\n      headers: { accept: \"application/json\" },\n    });\n    if (!res.ok) throw await errorFrom(res, path, \"roads\");\n    return (await res.json()) as RoadEventsResponse;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------\n// Feedback\n// ---------------------------------------------------------------------------------------------\n\nexport type FeedbackProduct =\n  | \"tiles\"\n  | \"terrain\"\n  | \"names\"\n  | \"geocoding\"\n  | \"places\"\n  | \"routing\"\n  | \"layers\"\n  | \"transit\"\n  | \"roads\"\n  | \"ev\";\n\nexport type FeedbackCategory =\n  | \"incorrect_location\"\n  | \"incorrect_address\"\n  | \"missing_place\"\n  | \"wrong_place_name\"\n  | \"wrong_category\"\n  | \"bad_route\"\n  | \"missing_road_closure\"\n  | \"incorrect_road_condition\"\n  | \"incorrect_transit_result\"\n  | \"other\";\n\nexport interface FeedbackReport {\n  product: FeedbackProduct;\n  category: FeedbackCategory;\n  /** Up to 2000 characters, stored exactly as written. One of this or `resultId` is required. */\n  description?: string;\n  /** The unmap id of the result being reported. */\n  resultId?: string;\n  /**\n   * The request being reported.\n   *\n   * **Only send this with the reporter's explicit agreement.** The gateway refuses it without\n   * `include_context: true`, which this sets whenever `context` is present, and that flag is\n   * meant to record a person's choice rather than a client default. unmap redacts query strings\n   * from its own logs; a client that attached them here would undo that.\n   */\n  context?: unknown;\n  signal?: AbortSignal;\n}\n\nexport interface FeedbackReceipt {\n  /** Quote this in a follow-up. */\n  id: string;\n  status: string;\n  created_at: string;\n  /** Whether a request context was actually kept. `false` when none was offered. */\n  context_stored: boolean;\n}\n\n/**\n * Report wrong data.\n *\n *   await unmap.feedback.submit({\n *     product: \"geocoding\",\n *     category: \"incorrect_location\",\n *     description: \"17 Ave SW returns a street in Edmonton.\",\n *   });\n *\n * Authenticated like everything else and **never metered**: telling us our data is wrong does not\n * cost a call. At most 200 reports per account per day.\n */\nexport class Feedback {\n  private readonly key: string;\n  private readonly base: string;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(opts: RoadsOptions) {\n    this.key = opts.key;\n    this.base = (opts.gateway ?? DEFAULT_GATEWAY).replace(/\\/+$/, \"\");\n    this.fetchImpl = opts.fetch ?? globalThis.fetch.bind(globalThis);\n  }\n\n  submit(report: FeedbackReport): Promise<FeedbackReceipt> {\n    return this.post(\"/feedback\", {\n      product: report.product,\n      category: report.category,\n      ...(report.description ? { description: report.description } : {}),\n      ...(report.resultId ? { result_id: report.resultId } : {}),\n      ...(report.context !== undefined ? { include_context: true, context: report.context } : {}),\n    }, report.signal);\n  }\n\n  /** A report about one place. `product` and `result_id` come from the path. */\n  aboutPlace(\n    placeId: string,\n    report: Omit<FeedbackReport, \"product\" | \"resultId\">,\n  ): Promise<FeedbackReceipt> {\n    return this.post(`/places/${encodeURIComponent(placeId)}/feedback`, {\n      category: report.category,\n      ...(report.description ? { description: report.description } : {}),\n      ...(report.context !== undefined ? { include_context: true, context: report.context } : {}),\n    }, report.signal);\n  }\n\n  private async post(path: string, body: unknown, signal?: AbortSignal): Promise<FeedbackReceipt> {\n    const res = await this.fetchImpl(`${this.base}${path}`, {\n      method: \"POST\",\n      signal,\n      headers: { \"content-type\": \"application/json\", authorization: `Bearer ${this.key}` },\n      body: JSON.stringify(body),\n    });\n    if (!res.ok) throw await errorFrom(res, path, \"feedback\");\n    return (await res.json()) as FeedbackReceipt;\n  }\n}\n"],"mappings":"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","names":["createMap"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unmap/sdk",
-  "version": "0.10.0",
+  "version": "0.13.0",
   "description": "One key, the whole unmap platform: map + geocoder + router",
   "license": "MIT",
   "keywords": [
@@ -40,10 +40,11 @@
   },
   "dependencies": {
     "maplibre-gl": "^6.7.0",
-    "@unmap/maps": "0.10.0",
-    "@unmap/geocoding": "0.10.0",
-    "@unmap/routing": "0.10.0",
-    "@unmap/core": "0.10.0"
+    "@unmap/core": "0.13.0",
+    "@unmap/elevation": "0.13.0",
+    "@unmap/geocoding": "0.13.0",
+    "@unmap/maps": "0.13.0",
+    "@unmap/routing": "0.13.0"
   },
   "devDependencies": {
     "tsup": "^8.3.0",