@chrtco/sdk 0.3.2

package/README.md

@@ -0,0 +1,126 @@
+# @chrtco/sdk
+
+Official TypeScript SDK for the [CHRT](https://chrt.co) nautical chart API.
+
+Zero dependencies · Works in Node 18+, browsers, Deno, Bun · Full TypeScript types
+
+## Install
+
+```bash
+npm install @chrtco/sdk
+```
+
+## Quick Start
+
+```typescript
+import { Chrt } from '@chrtco/sdk';
+
+const chrt = new Chrt('chrt_live_...');
+
+// Get depth areas in a bounding box
+const features = await chrt.features({
+  bbox: [-71, 42, -70, 43],
+  layer: 'DEPARE',
+});
+
+// Find buoys near a position
+const nearby = await chrt.query({
+  point: [-70.86, 42.02],
+  radius: 2000,
+  layer: 'BOYCAR,BOYLAT',
+});
+
+// List ENC cells
+const cells = await chrt.cells.list({ source: 'NOAA' });
+
+// Get a specific cell
+const cell = await chrt.cells.get('US5MA11M');
+```
+
+## Mapbox GL JS / MapLibre
+
+```typescript
+import mapboxgl from 'mapbox-gl';
+import { Chrt } from '@chrtco/sdk';
+
+const chrt = new Chrt('chrt_live_...');
+
+const map = new mapboxgl.Map({
+  container: 'map',
+  style: chrt.styleUrl(),
+  center: [-70.25, 43.66],
+  zoom: 12,
+  transformRequest: chrt.transformRequest(),
+});
+```
+
+## Configuration
+
+```typescript
+const chrt = new Chrt({
+  apiKey: 'chrt_live_...',
+  baseUrl: 'https://api.chrt.co/v1', // default
+  retries: 2,                         // retry on 5xx, default 2
+});
+```
+
+## API Reference
+
+### `chrt.features(options)`
+Query GeoJSON features by bounding box.
+
+| Option | Type | Required | Description |
+|--------|------|----------|-------------|
+| `bbox` | `[w, s, e, n]` | ✓ | Bounding box |
+| `layer` | `string` | | S-57 layer code (e.g. `DEPARE`) |
+| `limit` | `number` | | Max results (default 100) |
+| `offset` | `number` | | Pagination offset |
+
+### `chrt.query(options)`
+Spatial proximity search around a point.
+
+| Option | Type | Required | Description |
+|--------|------|----------|-------------|
+| `point` | `[lng, lat]` | ✓ | Centre point |
+| `radius` | `number` | | Radius in metres (default 1000) |
+| `layer` | `string` | | Comma-separated layer codes |
+| `limit` | `number` | | Max results |
+
+### `chrt.cells.list(options?)`
+List available ENC cells.
+
+### `chrt.cells.get(cellId)`
+Get metadata for a specific cell.
+
+### `chrt.tiles.styleUrl()`
+Returns a Mapbox/MapLibre-compatible `style.json` URL.
+
+### `chrt.tiles.tileUrl(z, x, y)`
+Returns a single vector tile URL.
+
+### `chrt.tiles.groups()`
+List available tileset groups.
+
+### `chrt.styleUrl()`
+Shortcut for `chrt.tiles.styleUrl()`.
+
+### `chrt.transformRequest()`
+Returns a `transformRequest` function for Mapbox GL / MapLibre that auto-injects the API key.
+
+## Error Handling
+
+```typescript
+import { Chrt, ChrtError } from '@chrtco/sdk';
+
+try {
+  await chrt.features({ bbox: [-71, 42, -70, 43] });
+} catch (e) {
+  if (e instanceof ChrtError) {
+    console.error(e.status, e.code, e.message);
+  }
+}
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,223 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Chrt: () => Chrt,
+  ChrtError: () => ChrtError
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.chrt.co/v1";
+var ChrtError = class extends Error {
+  status;
+  code;
+  body;
+  constructor(status, body) {
+    super(body?.message ?? body?.error ?? `CHRT API error ${status}`);
+    this.name = "ChrtError";
+    this.status = status;
+    this.code = body?.code;
+    this.body = body;
+  }
+};
+var HttpClient = class {
+  apiKey;
+  baseUrl;
+  retries;
+  constructor(apiKey, baseUrl, retries = 2) {
+    this.apiKey = apiKey;
+    this.baseUrl = (baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.retries = retries;
+  }
+  getBaseUrl() {
+    return this.baseUrl;
+  }
+  getApiKey() {
+    return this.apiKey;
+  }
+  async request(path, params) {
+    const url = new URL(`${this.baseUrl}${path}`);
+    if (params) {
+      for (const [k, v] of Object.entries(params)) {
+        if (v !== void 0) url.searchParams.set(k, String(v));
+      }
+    }
+    let lastError = null;
+    for (let attempt = 0; attempt <= this.retries; attempt++) {
+      try {
+        const res = await fetch(url.toString(), {
+          headers: { "x-api-key": this.apiKey }
+        });
+        if (!res.ok) {
+          let body;
+          try {
+            body = await res.json();
+          } catch {
+          }
+          const err = new ChrtError(res.status, body);
+          if (res.status >= 500 && attempt < this.retries) {
+            lastError = err;
+            await sleep(100 * 2 ** attempt);
+            continue;
+          }
+          throw err;
+        }
+        return await res.json();
+      } catch (e) {
+        if (e instanceof ChrtError) throw e;
+        lastError = e;
+        if (attempt < this.retries) {
+          await sleep(100 * 2 ** attempt);
+          continue;
+        }
+      }
+    }
+    throw lastError ?? new Error("CHRT API request failed");
+  }
+};
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+
+// src/endpoints/tiles.ts
+var TilesEndpoint = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** Full style.json URL with API key as query param */
+  styleUrl() {
+    return `${this.http.getBaseUrl()}/tiles/style.json?key=${this.http.getApiKey()}`;
+  }
+  /** Individual tile URL template */
+  tileUrl(z, x, y, format = "mvt") {
+    return `${this.http.getBaseUrl()}/tiles/${z}/${x}/${y}.${format}?key=${this.http.getApiKey()}`;
+  }
+  /** List available tileset groups */
+  async groups() {
+    return this.http.request("/tiles/groups");
+  }
+};
+
+// src/endpoints/cells.ts
+var CellsEndpoint = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** List ENC cells with optional filters */
+  async list(options) {
+    return this.http.request("/cells", options);
+  }
+  /** Get a single cell by ID */
+  async get(cellId) {
+    return this.http.request(`/cells/${encodeURIComponent(cellId)}`);
+  }
+};
+
+// src/endpoints/features.ts
+var FeaturesEndpoint = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** Query features within a bounding box */
+  async list(options) {
+    return this.http.request("/features", {
+      bbox: options.bbox.join(","),
+      layer: options.layer,
+      limit: options.limit,
+      offset: options.offset
+    });
+  }
+};
+
+// src/endpoints/query.ts
+var QueryEndpoint = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** Spatial proximity search around a point */
+  async nearby(options) {
+    return this.http.request("/query", {
+      point: options.point.join(","),
+      radius: options.radius,
+      layer: options.layer,
+      limit: options.limit
+    });
+  }
+};
+
+// src/index.ts
+var Chrt = class {
+  /** Tile endpoints — styleUrl, tileUrl, groups */
+  tiles;
+  /** Cell catalogue endpoints — list, get */
+  cells;
+  featuresEp;
+  queryEp;
+  http;
+  constructor(apiKeyOrConfig) {
+    const config = typeof apiKeyOrConfig === "string" ? { apiKey: apiKeyOrConfig } : apiKeyOrConfig;
+    this.http = new HttpClient(config.apiKey, config.baseUrl, config.retries);
+    this.tiles = new TilesEndpoint(this.http);
+    this.cells = new CellsEndpoint(this.http);
+    this.featuresEp = new FeaturesEndpoint(this.http);
+    this.queryEp = new QueryEndpoint(this.http);
+  }
+  /* ── Convenience shortcuts ───────────────────────── */
+  /** Query GeoJSON features by bounding box */
+  async features(options) {
+    return this.featuresEp.list(options);
+  }
+  /** Spatial proximity query around a point */
+  async query(options) {
+    return this.queryEp.nearby(options);
+  }
+  /* ── Map integration helpers ─────────────────────── */
+  /** Returns a style.json URL ready for Mapbox GL / MapLibre */
+  styleUrl() {
+    return this.tiles.styleUrl();
+  }
+  /**
+   * Returns a `transformRequest` function for Mapbox GL JS / MapLibre GL JS.
+   * Injects the API key header for requests to api.chrt.co.
+   *
+   * @example
+   * const map = new mapboxgl.Map({
+   *   style: chrt.styleUrl(),
+   *   transformRequest: chrt.transformRequest(),
+   * });
+   */
+  transformRequest() {
+    const apiKey = this.http.getApiKey();
+    return (url) => {
+      if (url.includes("api.chrt.co")) {
+        return { url, headers: { "x-api-key": apiKey } };
+      }
+      return void 0;
+    };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Chrt,
+  ChrtError
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/endpoints/tiles.ts","../src/endpoints/cells.ts","../src/endpoints/features.ts","../src/endpoints/query.ts"],"sourcesContent":["import { HttpClient, ChrtError } from \"./client.js\";\nimport { TilesEndpoint } from \"./endpoints/tiles.js\";\nimport { CellsEndpoint } from \"./endpoints/cells.js\";\nimport { FeaturesEndpoint } from \"./endpoints/features.js\";\nimport { QueryEndpoint } from \"./endpoints/query.js\";\nimport type {\n  ChrtConfig,\n  FeaturesOptions,\n  QueryOptions,\n  CellsOptions,\n  FeatureCollection,\n  CellsResponse,\n  CellDetail,\n  TransformRequest,\n} from \"./types.js\";\n\nexport class Chrt {\n  /** Tile endpoints — styleUrl, tileUrl, groups */\n  readonly tiles: TilesEndpoint;\n  /** Cell catalogue endpoints — list, get */\n  readonly cells: CellsEndpoint;\n\n  private featuresEp: FeaturesEndpoint;\n  private queryEp: QueryEndpoint;\n  private http: HttpClient;\n\n  constructor(apiKeyOrConfig: string | ChrtConfig) {\n    const config =\n      typeof apiKeyOrConfig === \"string\"\n        ? { apiKey: apiKeyOrConfig }\n        : apiKeyOrConfig;\n\n    this.http = new HttpClient(config.apiKey, config.baseUrl, config.retries);\n    this.tiles = new TilesEndpoint(this.http);\n    this.cells = new CellsEndpoint(this.http);\n    this.featuresEp = new FeaturesEndpoint(this.http);\n    this.queryEp = new QueryEndpoint(this.http);\n  }\n\n  /* ── Convenience shortcuts ───────────────────────── */\n\n  /** Query GeoJSON features by bounding box */\n  async features(options: FeaturesOptions): Promise<FeatureCollection> {\n    return this.featuresEp.list(options);\n  }\n\n  /** Spatial proximity query around a point */\n  async query(options: QueryOptions): Promise<FeatureCollection> {\n    return this.queryEp.nearby(options);\n  }\n\n  /* ── Map integration helpers ─────────────────────── */\n\n  /** Returns a style.json URL ready for Mapbox GL / MapLibre */\n  styleUrl(): string {\n    return this.tiles.styleUrl();\n  }\n\n  /**\n   * Returns a `transformRequest` function for Mapbox GL JS / MapLibre GL JS.\n   * Injects the API key header for requests to api.chrt.co.\n   *\n   * @example\n   * const map = new mapboxgl.Map({\n   *   style: chrt.styleUrl(),\n   *   transformRequest: chrt.transformRequest(),\n   * });\n   */\n  transformRequest(): (url: string) => TransformRequest | undefined {\n    const apiKey = this.http.getApiKey();\n    return (url: string) => {\n      if (url.includes(\"api.chrt.co\")) {\n        return { url, headers: { \"x-api-key\": apiKey } };\n      }\n      return undefined;\n    };\n  }\n}\n\n/* ── Re-exports ────────────────────────────────────── */\n\nexport { ChrtError } from \"./client.js\";\nexport type {\n  ChrtConfig,\n  FeaturesOptions,\n  QueryOptions,\n  CellsOptions,\n  FeatureCollection,\n  GeoJsonFeature,\n  GeoJsonGeometry,\n  CellsResponse,\n  CellDetail,\n  TileGroup,\n  TileGroupsResponse,\n  TransformRequest,\n} from \"./types.js\";\n","import type { ChrtErrorBody } from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"https://api.chrt.co/v1\";\n\nexport class ChrtError extends Error {\n  status: number;\n  code?: string;\n  body?: ChrtErrorBody;\n\n  constructor(status: number, body?: ChrtErrorBody) {\n    super(body?.message ?? body?.error ?? `CHRT API error ${status}`);\n    this.name = \"ChrtError\";\n    this.status = status;\n    this.code = body?.code;\n    this.body = body;\n  }\n}\n\nexport class HttpClient {\n  private apiKey: string;\n  private baseUrl: string;\n  private retries: number;\n\n  constructor(apiKey: string, baseUrl?: string, retries = 2) {\n    this.apiKey = apiKey;\n    this.baseUrl = (baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.retries = retries;\n  }\n\n  getBaseUrl(): string {\n    return this.baseUrl;\n  }\n\n  getApiKey(): string {\n    return this.apiKey;\n  }\n\n  async request<T>(path: string, params?: Record<string, string | number | undefined>): Promise<T> {\n    const url = new URL(`${this.baseUrl}${path}`);\n    if (params) {\n      for (const [k, v] of Object.entries(params)) {\n        if (v !== undefined) url.searchParams.set(k, String(v));\n      }\n    }\n\n    let lastError: Error | null = null;\n\n    for (let attempt = 0; attempt <= this.retries; attempt++) {\n      try {\n        const res = await fetch(url.toString(), {\n          headers: { \"x-api-key\": this.apiKey },\n        });\n\n        if (!res.ok) {\n          let body: ChrtErrorBody | undefined;\n          try {\n            body = await res.json() as ChrtErrorBody;\n          } catch {\n            /* empty */\n          }\n          const err = new ChrtError(res.status, body);\n\n          // Only retry on 5xx\n          if (res.status >= 500 && attempt < this.retries) {\n            lastError = err;\n            await sleep(100 * 2 ** attempt);\n            continue;\n          }\n          throw err;\n        }\n\n        return (await res.json()) as T;\n      } catch (e) {\n        if (e instanceof ChrtError) throw e;\n        lastError = e as Error;\n        if (attempt < this.retries) {\n          await sleep(100 * 2 ** attempt);\n          continue;\n        }\n      }\n    }\n\n    throw lastError ?? new Error(\"CHRT API request failed\");\n  }\n}\n\nfunction sleep(ms: number) {\n  return new Promise((r) => setTimeout(r, ms));\n}\n","import type { HttpClient } from \"../client.js\";\nimport type { TileGroupsResponse } from \"../types.js\";\n\nexport class TilesEndpoint {\n  constructor(private http: HttpClient) {}\n\n  /** Full style.json URL with API key as query param */\n  styleUrl(): string {\n    return `${this.http.getBaseUrl()}/tiles/style.json?key=${this.http.getApiKey()}`;\n  }\n\n  /** Individual tile URL template */\n  tileUrl(z: number, x: number, y: number, format: \"pbf\" | \"mvt\" = \"mvt\"): string {\n    return `${this.http.getBaseUrl()}/tiles/${z}/${x}/${y}.${format}?key=${this.http.getApiKey()}`;\n  }\n\n  /** List available tileset groups */\n  async groups(): Promise<TileGroupsResponse> {\n    return this.http.request<TileGroupsResponse>(\"/tiles/groups\");\n  }\n}\n","import type { HttpClient } from \"../client.js\";\nimport type { CellsOptions, CellsResponse, CellDetail } from \"../types.js\";\n\nexport class CellsEndpoint {\n  constructor(private http: HttpClient) {}\n\n  /** List ENC cells with optional filters */\n  async list(options?: CellsOptions): Promise<CellsResponse> {\n    return this.http.request<CellsResponse>(\"/cells\", options as Record<string, string | number | undefined>);\n  }\n\n  /** Get a single cell by ID */\n  async get(cellId: string): Promise<CellDetail> {\n    return this.http.request<CellDetail>(`/cells/${encodeURIComponent(cellId)}`);\n  }\n}\n","import type { HttpClient } from \"../client.js\";\nimport type { FeaturesOptions, FeatureCollection } from \"../types.js\";\n\nexport class FeaturesEndpoint {\n  constructor(private http: HttpClient) {}\n\n  /** Query features within a bounding box */\n  async list(options: FeaturesOptions): Promise<FeatureCollection> {\n    return this.http.request<FeatureCollection>(\"/features\", {\n      bbox: options.bbox.join(\",\"),\n      layer: options.layer,\n      limit: options.limit,\n      offset: options.offset,\n    });\n  }\n}\n","import type { HttpClient } from \"../client.js\";\nimport type { QueryOptions, FeatureCollection } from \"../types.js\";\n\nexport class QueryEndpoint {\n  constructor(private http: HttpClient) {}\n\n  /** Spatial proximity search around a point */\n  async nearby(options: QueryOptions): Promise<FeatureCollection> {\n    return this.http.request<FeatureCollection>(\"/query\", {\n      point: options.point.join(\",\"),\n      radius: options.radius,\n      layer: options.layer,\n      limit: options.limit,\n    });\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,156 @@
+interface GeoJsonGeometry {
+    type: string;
+    coordinates: unknown;
+}
+interface GeoJsonFeature<P = Record<string, unknown>> {
+    type: "Feature";
+    geometry: GeoJsonGeometry;
+    properties: P;
+}
+interface FeatureCollection<P = Record<string, unknown>> {
+    type: "FeatureCollection";
+    features: GeoJsonFeature<P>[];
+    total_count?: number;
+    limit?: number;
+    offset?: number;
+}
+interface FeaturesOptions {
+    /** Bounding box as [west, south, east, north] */
+    bbox: [number, number, number, number];
+    /** S-57 layer code, e.g. "DEPARE", "LIGHTS" */
+    layer?: string;
+    /** Max features to return (default 100) */
+    limit?: number;
+    /** Pagination offset */
+    offset?: number;
+}
+interface QueryOptions {
+    /** [longitude, latitude] */
+    point: [number, number];
+    /** Search radius in metres (default 1000) */
+    radius?: number;
+    /** Comma-separated layer codes */
+    layer?: string;
+    limit?: number;
+}
+interface CellsOptions {
+    /** Filter by chart source, e.g. "NOAA" */
+    source?: string;
+    /** Filter by status */
+    status?: string;
+    limit?: number;
+    offset?: number;
+}
+interface CellDetail {
+    cell_id: string;
+    title: string | null;
+    chart_source: string;
+    status: string;
+    scale: number | null;
+    scale_band: string | null;
+    edition: number | null;
+    update_number: number | null;
+    issue_date: string | null;
+    bbox_north: number | null;
+    bbox_south: number | null;
+    bbox_east: number | null;
+    bbox_west: number | null;
+}
+interface CellsResponse {
+    cells: CellDetail[];
+    total_count: number;
+    limit: number;
+    offset: number;
+}
+interface TileGroup {
+    id: string;
+    display_name: string;
+    tileset_id: string;
+    layer_names: string[];
+}
+interface TileGroupsResponse {
+    groups: TileGroup[];
+}
+interface TransformRequest {
+    url: string;
+    headers: Record<string, string>;
+}
+interface ChrtErrorBody {
+    error: string;
+    code?: string;
+    message?: string;
+}
+interface ChrtConfig {
+    /** API key (chrt_live_… or chrt_test_…) */
+    apiKey: string;
+    /** Override base URL (default https://api.chrt.co/v1) */
+    baseUrl?: string;
+    /** Max retries on 5xx/network errors (default 2) */
+    retries?: number;
+}
+
+declare class ChrtError extends Error {
+    status: number;
+    code?: string;
+    body?: ChrtErrorBody;
+    constructor(status: number, body?: ChrtErrorBody);
+}
+declare class HttpClient {
+    private apiKey;
+    private baseUrl;
+    private retries;
+    constructor(apiKey: string, baseUrl?: string, retries?: number);
+    getBaseUrl(): string;
+    getApiKey(): string;
+    request<T>(path: string, params?: Record<string, string | number | undefined>): Promise<T>;
+}
+
+declare class TilesEndpoint {
+    private http;
+    constructor(http: HttpClient);
+    /** Full style.json URL with API key as query param */
+    styleUrl(): string;
+    /** Individual tile URL template */
+    tileUrl(z: number, x: number, y: number, format?: "pbf" | "mvt"): string;
+    /** List available tileset groups */
+    groups(): Promise<TileGroupsResponse>;
+}
+
+declare class CellsEndpoint {
+    private http;
+    constructor(http: HttpClient);
+    /** List ENC cells with optional filters */
+    list(options?: CellsOptions): Promise<CellsResponse>;
+    /** Get a single cell by ID */
+    get(cellId: string): Promise<CellDetail>;
+}
+
+declare class Chrt {
+    /** Tile endpoints — styleUrl, tileUrl, groups */
+    readonly tiles: TilesEndpoint;
+    /** Cell catalogue endpoints — list, get */
+    readonly cells: CellsEndpoint;
+    private featuresEp;
+    private queryEp;
+    private http;
+    constructor(apiKeyOrConfig: string | ChrtConfig);
+    /** Query GeoJSON features by bounding box */
+    features(options: FeaturesOptions): Promise<FeatureCollection>;
+    /** Spatial proximity query around a point */
+    query(options: QueryOptions): Promise<FeatureCollection>;
+    /** Returns a style.json URL ready for Mapbox GL / MapLibre */
+    styleUrl(): string;
+    /**
+     * Returns a `transformRequest` function for Mapbox GL JS / MapLibre GL JS.
+     * Injects the API key header for requests to api.chrt.co.
+     *
+     * @example
+     * const map = new mapboxgl.Map({
+     *   style: chrt.styleUrl(),
+     *   transformRequest: chrt.transformRequest(),
+     * });
+     */
+    transformRequest(): (url: string) => TransformRequest | undefined;
+}
+
+export { type CellDetail, type CellsOptions, type CellsResponse, Chrt, type ChrtConfig, ChrtError, type FeatureCollection, type FeaturesOptions, type GeoJsonFeature, type GeoJsonGeometry, type QueryOptions, type TileGroup, type TileGroupsResponse, type TransformRequest };

package/dist/index.d.ts

@@ -0,0 +1,156 @@
+interface GeoJsonGeometry {
+    type: string;
+    coordinates: unknown;
+}
+interface GeoJsonFeature<P = Record<string, unknown>> {
+    type: "Feature";
+    geometry: GeoJsonGeometry;
+    properties: P;
+}
+interface FeatureCollection<P = Record<string, unknown>> {
+    type: "FeatureCollection";
+    features: GeoJsonFeature<P>[];
+    total_count?: number;
+    limit?: number;
+    offset?: number;
+}
+interface FeaturesOptions {
+    /** Bounding box as [west, south, east, north] */
+    bbox: [number, number, number, number];
+    /** S-57 layer code, e.g. "DEPARE", "LIGHTS" */
+    layer?: string;
+    /** Max features to return (default 100) */
+    limit?: number;
+    /** Pagination offset */
+    offset?: number;
+}
+interface QueryOptions {
+    /** [longitude, latitude] */
+    point: [number, number];
+    /** Search radius in metres (default 1000) */
+    radius?: number;
+    /** Comma-separated layer codes */
+    layer?: string;
+    limit?: number;
+}
+interface CellsOptions {
+    /** Filter by chart source, e.g. "NOAA" */
+    source?: string;
+    /** Filter by status */
+    status?: string;
+    limit?: number;
+    offset?: number;
+}
+interface CellDetail {
+    cell_id: string;
+    title: string | null;
+    chart_source: string;
+    status: string;
+    scale: number | null;
+    scale_band: string | null;
+    edition: number | null;
+    update_number: number | null;
+    issue_date: string | null;
+    bbox_north: number | null;
+    bbox_south: number | null;
+    bbox_east: number | null;
+    bbox_west: number | null;
+}
+interface CellsResponse {
+    cells: CellDetail[];
+    total_count: number;
+    limit: number;
+    offset: number;
+}
+interface TileGroup {
+    id: string;
+    display_name: string;
+    tileset_id: string;
+    layer_names: string[];
+}
+interface TileGroupsResponse {
+    groups: TileGroup[];
+}
+interface TransformRequest {
+    url: string;
+    headers: Record<string, string>;
+}
+interface ChrtErrorBody {
+    error: string;
+    code?: string;
+    message?: string;
+}
+interface ChrtConfig {
+    /** API key (chrt_live_… or chrt_test_…) */
+    apiKey: string;
+    /** Override base URL (default https://api.chrt.co/v1) */
+    baseUrl?: string;
+    /** Max retries on 5xx/network errors (default 2) */
+    retries?: number;
+}
+
+declare class ChrtError extends Error {
+    status: number;
+    code?: string;
+    body?: ChrtErrorBody;
+    constructor(status: number, body?: ChrtErrorBody);
+}
+declare class HttpClient {
+    private apiKey;
+    private baseUrl;
+    private retries;
+    constructor(apiKey: string, baseUrl?: string, retries?: number);
+    getBaseUrl(): string;
+    getApiKey(): string;
+    request<T>(path: string, params?: Record<string, string | number | undefined>): Promise<T>;
+}
+
+declare class TilesEndpoint {
+    private http;
+    constructor(http: HttpClient);
+    /** Full style.json URL with API key as query param */
+    styleUrl(): string;
+    /** Individual tile URL template */
+    tileUrl(z: number, x: number, y: number, format?: "pbf" | "mvt"): string;
+    /** List available tileset groups */
+    groups(): Promise<TileGroupsResponse>;
+}
+
+declare class CellsEndpoint {
+    private http;
+    constructor(http: HttpClient);
+    /** List ENC cells with optional filters */
+    list(options?: CellsOptions): Promise<CellsResponse>;
+    /** Get a single cell by ID */
+    get(cellId: string): Promise<CellDetail>;
+}
+
+declare class Chrt {
+    /** Tile endpoints — styleUrl, tileUrl, groups */
+    readonly tiles: TilesEndpoint;
+    /** Cell catalogue endpoints — list, get */
+    readonly cells: CellsEndpoint;
+    private featuresEp;
+    private queryEp;
+    private http;
+    constructor(apiKeyOrConfig: string | ChrtConfig);
+    /** Query GeoJSON features by bounding box */
+    features(options: FeaturesOptions): Promise<FeatureCollection>;
+    /** Spatial proximity query around a point */
+    query(options: QueryOptions): Promise<FeatureCollection>;
+    /** Returns a style.json URL ready for Mapbox GL / MapLibre */
+    styleUrl(): string;
+    /**
+     * Returns a `transformRequest` function for Mapbox GL JS / MapLibre GL JS.
+     * Injects the API key header for requests to api.chrt.co.
+     *
+     * @example
+     * const map = new mapboxgl.Map({
+     *   style: chrt.styleUrl(),
+     *   transformRequest: chrt.transformRequest(),
+     * });
+     */
+    transformRequest(): (url: string) => TransformRequest | undefined;
+}
+
+export { type CellDetail, type CellsOptions, type CellsResponse, Chrt, type ChrtConfig, ChrtError, type FeatureCollection, type FeaturesOptions, type GeoJsonFeature, type GeoJsonGeometry, type QueryOptions, type TileGroup, type TileGroupsResponse, type TransformRequest };

package/dist/index.js

@@ -0,0 +1,195 @@
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.chrt.co/v1";
+var ChrtError = class extends Error {
+  status;
+  code;
+  body;
+  constructor(status, body) {
+    super(body?.message ?? body?.error ?? `CHRT API error ${status}`);
+    this.name = "ChrtError";
+    this.status = status;
+    this.code = body?.code;
+    this.body = body;
+  }
+};
+var HttpClient = class {
+  apiKey;
+  baseUrl;
+  retries;
+  constructor(apiKey, baseUrl, retries = 2) {
+    this.apiKey = apiKey;
+    this.baseUrl = (baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.retries = retries;
+  }
+  getBaseUrl() {
+    return this.baseUrl;
+  }
+  getApiKey() {
+    return this.apiKey;
+  }
+  async request(path, params) {
+    const url = new URL(`${this.baseUrl}${path}`);
+    if (params) {
+      for (const [k, v] of Object.entries(params)) {
+        if (v !== void 0) url.searchParams.set(k, String(v));
+      }
+    }
+    let lastError = null;
+    for (let attempt = 0; attempt <= this.retries; attempt++) {
+      try {
+        const res = await fetch(url.toString(), {
+          headers: { "x-api-key": this.apiKey }
+        });
+        if (!res.ok) {
+          let body;
+          try {
+            body = await res.json();
+          } catch {
+          }
+          const err = new ChrtError(res.status, body);
+          if (res.status >= 500 && attempt < this.retries) {
+            lastError = err;
+            await sleep(100 * 2 ** attempt);
+            continue;
+          }
+          throw err;
+        }
+        return await res.json();
+      } catch (e) {
+        if (e instanceof ChrtError) throw e;
+        lastError = e;
+        if (attempt < this.retries) {
+          await sleep(100 * 2 ** attempt);
+          continue;
+        }
+      }
+    }
+    throw lastError ?? new Error("CHRT API request failed");
+  }
+};
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+
+// src/endpoints/tiles.ts
+var TilesEndpoint = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** Full style.json URL with API key as query param */
+  styleUrl() {
+    return `${this.http.getBaseUrl()}/tiles/style.json?key=${this.http.getApiKey()}`;
+  }
+  /** Individual tile URL template */
+  tileUrl(z, x, y, format = "mvt") {
+    return `${this.http.getBaseUrl()}/tiles/${z}/${x}/${y}.${format}?key=${this.http.getApiKey()}`;
+  }
+  /** List available tileset groups */
+  async groups() {
+    return this.http.request("/tiles/groups");
+  }
+};
+
+// src/endpoints/cells.ts
+var CellsEndpoint = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** List ENC cells with optional filters */
+  async list(options) {
+    return this.http.request("/cells", options);
+  }
+  /** Get a single cell by ID */
+  async get(cellId) {
+    return this.http.request(`/cells/${encodeURIComponent(cellId)}`);
+  }
+};
+
+// src/endpoints/features.ts
+var FeaturesEndpoint = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** Query features within a bounding box */
+  async list(options) {
+    return this.http.request("/features", {
+      bbox: options.bbox.join(","),
+      layer: options.layer,
+      limit: options.limit,
+      offset: options.offset
+    });
+  }
+};
+
+// src/endpoints/query.ts
+var QueryEndpoint = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** Spatial proximity search around a point */
+  async nearby(options) {
+    return this.http.request("/query", {
+      point: options.point.join(","),
+      radius: options.radius,
+      layer: options.layer,
+      limit: options.limit
+    });
+  }
+};
+
+// src/index.ts
+var Chrt = class {
+  /** Tile endpoints — styleUrl, tileUrl, groups */
+  tiles;
+  /** Cell catalogue endpoints — list, get */
+  cells;
+  featuresEp;
+  queryEp;
+  http;
+  constructor(apiKeyOrConfig) {
+    const config = typeof apiKeyOrConfig === "string" ? { apiKey: apiKeyOrConfig } : apiKeyOrConfig;
+    this.http = new HttpClient(config.apiKey, config.baseUrl, config.retries);
+    this.tiles = new TilesEndpoint(this.http);
+    this.cells = new CellsEndpoint(this.http);
+    this.featuresEp = new FeaturesEndpoint(this.http);
+    this.queryEp = new QueryEndpoint(this.http);
+  }
+  /* ── Convenience shortcuts ───────────────────────── */
+  /** Query GeoJSON features by bounding box */
+  async features(options) {
+    return this.featuresEp.list(options);
+  }
+  /** Spatial proximity query around a point */
+  async query(options) {
+    return this.queryEp.nearby(options);
+  }
+  /* ── Map integration helpers ─────────────────────── */
+  /** Returns a style.json URL ready for Mapbox GL / MapLibre */
+  styleUrl() {
+    return this.tiles.styleUrl();
+  }
+  /**
+   * Returns a `transformRequest` function for Mapbox GL JS / MapLibre GL JS.
+   * Injects the API key header for requests to api.chrt.co.
+   *
+   * @example
+   * const map = new mapboxgl.Map({
+   *   style: chrt.styleUrl(),
+   *   transformRequest: chrt.transformRequest(),
+   * });
+   */
+  transformRequest() {
+    const apiKey = this.http.getApiKey();
+    return (url) => {
+      if (url.includes("api.chrt.co")) {
+        return { url, headers: { "x-api-key": apiKey } };
+      }
+      return void 0;
+    };
+  }
+};
+export {
+  Chrt,
+  ChrtError
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/endpoints/tiles.ts","../src/endpoints/cells.ts","../src/endpoints/features.ts","../src/endpoints/query.ts","../src/index.ts"],"sourcesContent":["import type { ChrtErrorBody } from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"https://api.chrt.co/v1\";\n\nexport class ChrtError extends Error {\n  status: number;\n  code?: string;\n  body?: ChrtErrorBody;\n\n  constructor(status: number, body?: ChrtErrorBody) {\n    super(body?.message ?? body?.error ?? `CHRT API error ${status}`);\n    this.name = \"ChrtError\";\n    this.status = status;\n    this.code = body?.code;\n    this.body = body;\n  }\n}\n\nexport class HttpClient {\n  private apiKey: string;\n  private baseUrl: string;\n  private retries: number;\n\n  constructor(apiKey: string, baseUrl?: string, retries = 2) {\n    this.apiKey = apiKey;\n    this.baseUrl = (baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.retries = retries;\n  }\n\n  getBaseUrl(): string {\n    return this.baseUrl;\n  }\n\n  getApiKey(): string {\n    return this.apiKey;\n  }\n\n  async request<T>(path: string, params?: Record<string, string | number | undefined>): Promise<T> {\n    const url = new URL(`${this.baseUrl}${path}`);\n    if (params) {\n      for (const [k, v] of Object.entries(params)) {\n        if (v !== undefined) url.searchParams.set(k, String(v));\n      }\n    }\n\n    let lastError: Error | null = null;\n\n    for (let attempt = 0; attempt <= this.retries; attempt++) {\n      try {\n        const res = await fetch(url.toString(), {\n          headers: { \"x-api-key\": this.apiKey },\n        });\n\n        if (!res.ok) {\n          let body: ChrtErrorBody | undefined;\n          try {\n            body = await res.json() as ChrtErrorBody;\n          } catch {\n            /* empty */\n          }\n          const err = new ChrtError(res.status, body);\n\n          // Only retry on 5xx\n          if (res.status >= 500 && attempt < this.retries) {\n            lastError = err;\n            await sleep(100 * 2 ** attempt);\n            continue;\n          }\n          throw err;\n        }\n\n        return (await res.json()) as T;\n      } catch (e) {\n        if (e instanceof ChrtError) throw e;\n        lastError = e as Error;\n        if (attempt < this.retries) {\n          await sleep(100 * 2 ** attempt);\n          continue;\n        }\n      }\n    }\n\n    throw lastError ?? new Error(\"CHRT API request failed\");\n  }\n}\n\nfunction sleep(ms: number) {\n  return new Promise((r) => setTimeout(r, ms));\n}\n","import type { HttpClient } from \"../client.js\";\nimport type { TileGroupsResponse } from \"../types.js\";\n\nexport class TilesEndpoint {\n  constructor(private http: HttpClient) {}\n\n  /** Full style.json URL with API key as query param */\n  styleUrl(): string {\n    return `${this.http.getBaseUrl()}/tiles/style.json?key=${this.http.getApiKey()}`;\n  }\n\n  /** Individual tile URL template */\n  tileUrl(z: number, x: number, y: number, format: \"pbf\" | \"mvt\" = \"mvt\"): string {\n    return `${this.http.getBaseUrl()}/tiles/${z}/${x}/${y}.${format}?key=${this.http.getApiKey()}`;\n  }\n\n  /** List available tileset groups */\n  async groups(): Promise<TileGroupsResponse> {\n    return this.http.request<TileGroupsResponse>(\"/tiles/groups\");\n  }\n}\n","import type { HttpClient } from \"../client.js\";\nimport type { CellsOptions, CellsResponse, CellDetail } from \"../types.js\";\n\nexport class CellsEndpoint {\n  constructor(private http: HttpClient) {}\n\n  /** List ENC cells with optional filters */\n  async list(options?: CellsOptions): Promise<CellsResponse> {\n    return this.http.request<CellsResponse>(\"/cells\", options as Record<string, string | number | undefined>);\n  }\n\n  /** Get a single cell by ID */\n  async get(cellId: string): Promise<CellDetail> {\n    return this.http.request<CellDetail>(`/cells/${encodeURIComponent(cellId)}`);\n  }\n}\n","import type { HttpClient } from \"../client.js\";\nimport type { FeaturesOptions, FeatureCollection } from \"../types.js\";\n\nexport class FeaturesEndpoint {\n  constructor(private http: HttpClient) {}\n\n  /** Query features within a bounding box */\n  async list(options: FeaturesOptions): Promise<FeatureCollection> {\n    return this.http.request<FeatureCollection>(\"/features\", {\n      bbox: options.bbox.join(\",\"),\n      layer: options.layer,\n      limit: options.limit,\n      offset: options.offset,\n    });\n  }\n}\n","import type { HttpClient } from \"../client.js\";\nimport type { QueryOptions, FeatureCollection } from \"../types.js\";\n\nexport class QueryEndpoint {\n  constructor(private http: HttpClient) {}\n\n  /** Spatial proximity search around a point */\n  async nearby(options: QueryOptions): Promise<FeatureCollection> {\n    return this.http.request<FeatureCollection>(\"/query\", {\n      point: options.point.join(\",\"),\n      radius: options.radius,\n      layer: options.layer,\n      limit: options.limit,\n    });\n  }\n}\n","import { HttpClient, ChrtError } from \"./client.js\";\nimport { TilesEndpoint } from \"./endpoints/tiles.js\";\nimport { CellsEndpoint } from \"./endpoints/cells.js\";\nimport { FeaturesEndpoint } from \"./endpoints/features.js\";\nimport { QueryEndpoint } from \"./endpoints/query.js\";\nimport type {\n  ChrtConfig,\n  FeaturesOptions,\n  QueryOptions,\n  CellsOptions,\n  FeatureCollection,\n  CellsResponse,\n  CellDetail,\n  TransformRequest,\n} from \"./types.js\";\n\nexport class Chrt {\n  /** Tile endpoints — styleUrl, tileUrl, groups */\n  readonly tiles: TilesEndpoint;\n  /** Cell catalogue endpoints — list, get */\n  readonly cells: CellsEndpoint;\n\n  private featuresEp: FeaturesEndpoint;\n  private queryEp: QueryEndpoint;\n  private http: HttpClient;\n\n  constructor(apiKeyOrConfig: string | ChrtConfig) {\n    const config =\n      typeof apiKeyOrConfig === \"string\"\n        ? { apiKey: apiKeyOrConfig }\n        : apiKeyOrConfig;\n\n    this.http = new HttpClient(config.apiKey, config.baseUrl, config.retries);\n    this.tiles = new TilesEndpoint(this.http);\n    this.cells = new CellsEndpoint(this.http);\n    this.featuresEp = new FeaturesEndpoint(this.http);\n    this.queryEp = new QueryEndpoint(this.http);\n  }\n\n  /* ── Convenience shortcuts ───────────────────────── */\n\n  /** Query GeoJSON features by bounding box */\n  async features(options: FeaturesOptions): Promise<FeatureCollection> {\n    return this.featuresEp.list(options);\n  }\n\n  /** Spatial proximity query around a point */\n  async query(options: QueryOptions): Promise<FeatureCollection> {\n    return this.queryEp.nearby(options);\n  }\n\n  /* ── Map integration helpers ─────────────────────── */\n\n  /** Returns a style.json URL ready for Mapbox GL / MapLibre */\n  styleUrl(): string {\n    return this.tiles.styleUrl();\n  }\n\n  /**\n   * Returns a `transformRequest` function for Mapbox GL JS / MapLibre GL JS.\n   * Injects the API key header for requests to api.chrt.co.\n   *\n   * @example\n   * const map = new mapboxgl.Map({\n   *   style: chrt.styleUrl(),\n   *   transformRequest: chrt.transformRequest(),\n   * });\n   */\n  transformRequest(): (url: string) => TransformRequest | undefined {\n    const apiKey = this.http.getApiKey();\n    return (url: string) => {\n      if (url.includes(\"api.chrt.co\")) {\n        return { url, headers: { \"x-api-key\": apiKey } };\n      }\n      return undefined;\n    };\n  }\n}\n\n/* ── Re-exports ────────────────────────────────────── */\n\nexport { ChrtError } from \"./client.js\";\nexport type {\n  ChrtConfig,\n  FeaturesOptions,\n  QueryOptions,\n  CellsOptions,\n  FeatureCollection,\n  GeoJsonFeature,\n  GeoJsonGeometry,\n  CellsResponse,\n  CellDetail,\n  TileGroup,\n  TileGroupsResponse,\n  TransformRequest,\n} from \"./types.js\";\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@chrtco/sdk",
+  "version": "0.3.2",
+  "description": "Official TypeScript SDK for the CHRT nautical chart API",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": ["chrt", "nautical", "charts", "maritime", "enc", "s57", "mapbox", "maplibre", "gis", "api"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/chrt-co/enc-hub",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://chrt.co/docs/sdks",
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}