@unmap/routing 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,45 @@
+interface RouterOptions {
+    key: string;
+    gateway?: string;
+    fetch?: typeof fetch;
+}
+type TravelMode = "auto" | "bicycle" | "pedestrian";
+/** [longitude, latitude]. */
+type LngLat = [number, number];
+interface RouteResult {
+    distanceMeters: number;
+    durationSeconds: number;
+    geometry: {
+        type: "LineString";
+        coordinates: LngLat[];
+    };
+}
+/** Minimal GeoJSON FeatureCollection (isochrone bands). */
+interface FeatureCollection {
+    type: "FeatureCollection";
+    features: unknown[];
+}
+interface IsochroneOptions {
+    minutes: number[];
+    mode?: TravelMode;
+    signal?: AbortSignal;
+}
+declare class RouterError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+/** Typed client for the unmap routing API (gateway `/route`, `/isochrone`). */
+declare class Router {
+    private readonly key;
+    private readonly base;
+    private readonly fetchImpl;
+    constructor(opts: RouterOptions);
+    route(from: LngLat, to: LngLat, opts?: {
+        mode?: TravelMode;
+        signal?: AbortSignal;
+    }): Promise<RouteResult>;
+    isochrone(center: LngLat, opts: IsochroneOptions): Promise<FeatureCollection>;
+    private get;
+}
+
+export { type FeatureCollection, type IsochroneOptions, type LngLat, type RouteResult, Router, RouterError, type RouterOptions, type TravelMode };

package/dist/index.js

@@ -0,0 +1,49 @@
+// src/index.ts
+import { DEFAULT_GATEWAY } from "@unmap/core";
+var RouterError = class extends Error {
+  constructor(status, message) {
+    super(message);
+    this.status = status;
+    this.name = "RouterError";
+  }
+  status;
+};
+var Router = 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);
+  }
+  route(from, to, opts = {}) {
+    return this.get(
+      "/route",
+      { from: from.join(","), to: to.join(","), mode: opts.mode },
+      opts.signal
+    );
+  }
+  isochrone(center, opts) {
+    return this.get(
+      "/isochrone",
+      { lon: String(center[0]), lat: String(center[1]), minutes: opts.minutes.join(","), mode: opts.mode },
+      opts.signal
+    );
+  }
+  async get(path, params, signal) {
+    const q = new URLSearchParams({ key: this.key });
+    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,
+      headers: { accept: "application/json" }
+    });
+    if (!res.ok) throw new RouterError(res.status, `route ${res.status} on ${path}`);
+    return res.json();
+  }
+};
+export {
+  Router,
+  RouterError
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { DEFAULT_GATEWAY } from \"@unmap/core\";\n\nexport interface RouterOptions {\n  key: string;\n  gateway?: string;\n  fetch?: typeof fetch;\n}\n\nexport type TravelMode = \"auto\" | \"bicycle\" | \"pedestrian\";\n/** [longitude, latitude]. */\nexport type LngLat = [number, number];\n\nexport interface RouteResult {\n  distanceMeters: number;\n  durationSeconds: number;\n  geometry: { type: \"LineString\"; coordinates: LngLat[] };\n}\n\n/** Minimal GeoJSON FeatureCollection (isochrone bands). */\nexport interface FeatureCollection {\n  type: \"FeatureCollection\";\n  features: unknown[];\n}\n\nexport interface IsochroneOptions {\n  minutes: number[];\n  mode?: TravelMode;\n  signal?: AbortSignal;\n}\n\nexport class RouterError extends Error {\n  constructor(\n    public readonly status: number,\n    message: string,\n  ) {\n    super(message);\n    this.name = \"RouterError\";\n  }\n}\n\n/** Typed client for the unmap routing API (gateway `/route`, `/isochrone`). */\nexport class Router {\n  private readonly key: string;\n  private readonly base: string;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(opts: RouterOptions) {\n    this.key = opts.key;\n    this.base = (opts.gateway ?? DEFAULT_GATEWAY).replace(/\\/+$/, \"\");\n    // Bound to globalThis: stored on an instance and called as `this.fetchImpl(...)`, a bare\n    // `fetch` reference is invoked with the Router as its receiver, and browsers reject that\n    // with \"Illegal invocation\". Node is lenient, so this only ever surfaces in the browser.\n    this.fetchImpl = opts.fetch ?? globalThis.fetch.bind(globalThis);\n  }\n\n  route(\n    from: LngLat,\n    to: LngLat,\n    opts: { mode?: TravelMode; signal?: AbortSignal } = {},\n  ): Promise<RouteResult> {\n    return this.get<RouteResult>(\n      \"/route\",\n      { from: from.join(\",\"), to: to.join(\",\"), mode: opts.mode },\n      opts.signal,\n    );\n  }\n\n  isochrone(center: LngLat, opts: IsochroneOptions): Promise<FeatureCollection> {\n    return this.get<FeatureCollection>(\n      \"/isochrone\",\n      { lon: String(center[0]), lat: String(center[1]), minutes: opts.minutes.join(\",\"), mode: opts.mode },\n      opts.signal,\n    );\n  }\n\n  private async get<T>(\n    path: string,\n    params: Record<string, string | undefined>,\n    signal?: AbortSignal,\n  ): Promise<T> {\n    const q = new URLSearchParams({ key: this.key });\n    for (const [k, v] of Object.entries(params)) if (v != null && v !== \"\") q.set(k, v);\n    const res = await this.fetchImpl(`${this.base}${path}?${q}`, {\n      signal,\n      headers: { accept: \"application/json\" },\n    });\n    if (!res.ok) throw new RouterError(res.status, `route ${res.status} on ${path}`);\n    return res.json() as Promise<T>;\n  }\n}\n"],"mappings":";AAAA,SAAS,uBAAuB;AA8BzB,IAAM,cAAN,cAA0B,MAAM;AAAA,EACrC,YACkB,QAChB,SACA;AACA,UAAM,OAAO;AAHG;AAIhB,SAAK,OAAO;AAAA,EACd;AAAA,EALkB;AAMpB;AAGO,IAAM,SAAN,MAAa;AAAA,EACD;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,YAAY,MAAqB;AAC/B,SAAK,MAAM,KAAK;AAChB,SAAK,QAAQ,KAAK,WAAW,iBAAiB,QAAQ,QAAQ,EAAE;AAIhE,SAAK,YAAY,KAAK,SAAS,WAAW,MAAM,KAAK,UAAU;AAAA,EACjE;AAAA,EAEA,MACE,MACA,IACA,OAAoD,CAAC,GAC/B;AACtB,WAAO,KAAK;AAAA,MACV;AAAA,MACA,EAAE,MAAM,KAAK,KAAK,GAAG,GAAG,IAAI,GAAG,KAAK,GAAG,GAAG,MAAM,KAAK,KAAK;AAAA,MAC1D,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EAEA,UAAU,QAAgB,MAAoD;AAC5E,WAAO,KAAK;AAAA,MACV;AAAA,MACA,EAAE,KAAK,OAAO,OAAO,CAAC,CAAC,GAAG,KAAK,OAAO,OAAO,CAAC,CAAC,GAAG,SAAS,KAAK,QAAQ,KAAK,GAAG,GAAG,MAAM,KAAK,KAAK;AAAA,MACnG,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EAEA,MAAc,IACZ,MACA,QACA,QACY;AACZ,UAAM,IAAI,IAAI,gBAAgB,EAAE,KAAK,KAAK,IAAI,CAAC;AAC/C,eAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,MAAM,EAAG,KAAI,KAAK,QAAQ,MAAM,GAAI,GAAE,IAAI,GAAG,CAAC;AAClF,UAAM,MAAM,MAAM,KAAK,UAAU,GAAG,KAAK,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI;AAAA,MAC3D;AAAA,MACA,SAAS,EAAE,QAAQ,mBAAmB;AAAA,IACxC,CAAC;AACD,QAAI,CAAC,IAAI,GAAI,OAAM,IAAI,YAAY,IAAI,QAAQ,SAAS,IAAI,MAAM,OAAO,IAAI,EAAE;AAC/E,WAAO,IAAI,KAAK;AAAA,EAClB;AACF;","names":[]}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@unmap/routing",
+  "version": "0.0.1",
+  "description": "Typed client for the unmap routing API (route + isochrone)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@unmap/core": "0.0.1"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}