@chrtco/sdk 0.3.2 → 0.4.1

package/dist/index.cjs

@@ -21,7 +21,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   Chrt: () => Chrt,
-  ChrtError: () => ChrtError
+  ChrtError: () => ChrtError,
+  paginate: () => paginate,
+  parseWebhook: () => parseWebhook
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -54,7 +56,7 @@ var HttpClient = class {
   getApiKey() {
     return this.apiKey;
   }
-  async request(path, params) {
+  async request(path, params, signal) {
     const url = new URL(`${this.baseUrl}${path}`);
     if (params) {
       for (const [k, v] of Object.entries(params)) {
@@ -63,9 +65,13 @@ var HttpClient = class {
     }
     let lastError = null;
     for (let attempt = 0; attempt <= this.retries; attempt++) {
+      if (signal?.aborted) {
+        throw signal.reason ?? new DOMException("The operation was aborted.", "AbortError");
+      }
       try {
         const res = await fetch(url.toString(), {
-          headers: { "x-api-key": this.apiKey }
+          headers: { "x-api-key": this.apiKey },
+          signal
         });
         if (!res.ok) {
           let body;
@@ -84,6 +90,7 @@ var HttpClient = class {
         return await res.json();
       } catch (e) {
         if (e instanceof ChrtError) throw e;
+        if (signal?.aborted) throw e;
         lastError = e;
         if (attempt < this.retries) {
           await sleep(100 * 2 ** attempt);
@@ -124,11 +131,36 @@ var CellsEndpoint = class {
   }
   /** List ENC cells with optional filters */
   async list(options) {
-    return this.http.request("/cells", options);
+    const { signal, ...params } = options ?? {};
+    return this.http.request(
+      "/cells",
+      params,
+      signal
+    );
   }
   /** Get a single cell by ID */
-  async get(cellId) {
-    return this.http.request(`/cells/${encodeURIComponent(cellId)}`);
+  async get(cellId, signal) {
+    return this.http.request(
+      `/cells/${encodeURIComponent(cellId)}`,
+      void 0,
+      signal
+    );
+  }
+};
+
+// src/endpoints/coverage.ts
+var CoverageEndpoint = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** List available chart sources with cell counts */
+  async list(options) {
+    const { signal, ...params } = options ?? {};
+    return this.http.request(
+      "/coverage",
+      params,
+      signal
+    );
   }
 };
 
@@ -139,12 +171,16 @@ var FeaturesEndpoint = class {
   }
   /** 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
-    });
+    return this.http.request(
+      "/features",
+      {
+        bbox: options.bbox.join(","),
+        layer: options.layer,
+        limit: options.limit,
+        offset: options.offset
+      },
+      options.signal
+    );
   }
 };
 
@@ -155,21 +191,68 @@ var QueryEndpoint = class {
   }
   /** 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
-    });
+    return this.http.request(
+      "/query",
+      {
+        point: options.point.join(","),
+        radius: options.radius,
+        layer: options.layer,
+        limit: options.limit
+      },
+      options.signal
+    );
   }
 };
 
+// src/pagination.ts
+async function* paginate(fetchPage, getItems, getTotalCount, options) {
+  const pageSize = options?.pageSize ?? 100;
+  const signal = options?.signal;
+  let offset = 0;
+  while (true) {
+    if (signal?.aborted) return;
+    const response = await fetchPage(offset, signal);
+    const items = getItems(response);
+    for (const item of items) {
+      yield item;
+    }
+    if (items.length === 0) return;
+    offset += items.length;
+    const total = getTotalCount(response);
+    if (total > 0 && offset >= total) return;
+  }
+}
+
+// src/webhooks.ts
+var VALID_TYPES = /* @__PURE__ */ new Set(["cell.updated", "cell.new", "cell.deleted"]);
+function parseWebhook(body) {
+  if (typeof body !== "object" || body === null) {
+    throw new Error("Invalid webhook payload: expected an object");
+  }
+  const obj = body;
+  if (typeof obj.id !== "string") {
+    throw new Error("Invalid webhook payload: missing 'id'");
+  }
+  if (typeof obj.timestamp !== "string") {
+    throw new Error("Invalid webhook payload: missing 'timestamp'");
+  }
+  if (typeof obj.type !== "string" || !VALID_TYPES.has(obj.type)) {
+    throw new Error(`Invalid webhook payload: unknown type '${String(obj.type)}'`);
+  }
+  if (typeof obj.data !== "object" || obj.data === null) {
+    throw new Error("Invalid webhook payload: missing 'data'");
+  }
+  return obj;
+}
+
 // src/index.ts
 var Chrt = class {
   /** Tile endpoints — styleUrl, tileUrl, groups */
   tiles;
   /** Cell catalogue endpoints — list, get */
   cells;
+  /** Coverage data — list available chart sources */
+  coverage;
   featuresEp;
   queryEp;
   http;
@@ -178,6 +261,7 @@ var Chrt = class {
     this.http = new HttpClient(config.apiKey, config.baseUrl, config.retries);
     this.tiles = new TilesEndpoint(this.http);
     this.cells = new CellsEndpoint(this.http);
+    this.coverage = new CoverageEndpoint(this.http);
     this.featuresEp = new FeaturesEndpoint(this.http);
     this.queryEp = new QueryEndpoint(this.http);
   }
@@ -190,6 +274,45 @@ var Chrt = class {
   async query(options) {
     return this.queryEp.nearby(options);
   }
+  /* ── Auto-pagination iterators ───────────────────── */
+  /**
+   * Iterate all features matching a bounding-box query, auto-paginating.
+   *
+   * @example
+   * ```ts
+   * for await (const feature of chrt.featuresIter({ bbox: [-74, 40, -73, 41] })) {
+   *   console.log(feature.properties);
+   * }
+   * ```
+   */
+  featuresIter(options) {
+    const pageSize = options.limit ?? 100;
+    return paginate(
+      (offset, signal) => this.features({ ...options, limit: pageSize, offset, signal }),
+      (r) => r.features,
+      (r) => r.total_count ?? 0,
+      { pageSize, signal: options.signal }
+    );
+  }
+  /**
+   * Iterate all cells matching a query, auto-paginating.
+   *
+   * @example
+   * ```ts
+   * for await (const cell of chrt.cellsIter({ source: "NOAA" })) {
+   *   console.log(cell.cell_id, cell.title);
+   * }
+   * ```
+   */
+  cellsIter(options) {
+    const pageSize = options?.limit ?? 100;
+    return paginate(
+      (offset, signal) => this.cells.list({ ...options, limit: pageSize, offset, signal }),
+      (r) => r.cells,
+      (r) => r.total_count,
+      { pageSize, signal: options?.signal }
+    );
+  }
   /* ── Map integration helpers ─────────────────────── */
   /** Returns a style.json URL ready for Mapbox GL / MapLibre */
   styleUrl() {
@@ -218,6 +341,8 @@ var Chrt = class {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Chrt,
-  ChrtError
+  ChrtError,
+  paginate,
+  parseWebhook
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +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":[]}
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/endpoints/tiles.ts","../src/endpoints/cells.ts","../src/endpoints/coverage.ts","../src/endpoints/features.ts","../src/endpoints/query.ts","../src/pagination.ts","../src/webhooks.ts"],"sourcesContent":["import { HttpClient, ChrtError } from \"./client.js\";\nimport { TilesEndpoint } from \"./endpoints/tiles.js\";\nimport { CellsEndpoint } from \"./endpoints/cells.js\";\nimport { CoverageEndpoint } from \"./endpoints/coverage.js\";\nimport { FeaturesEndpoint } from \"./endpoints/features.js\";\nimport { QueryEndpoint } from \"./endpoints/query.js\";\nimport { paginate } from \"./pagination.js\";\nimport type {\n  ChrtConfig,\n  FeaturesOptions,\n  QueryOptions,\n  CellsOptions,\n  CoverageOptions,\n  FeatureCollection,\n  GeoJsonFeature,\n  CellsResponse,\n  CellDetail,\n  CoverageResponse,\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  /** Coverage data — list available chart sources */\n  readonly coverage: CoverageEndpoint;\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.coverage = new CoverageEndpoint(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  /* ── Auto-pagination iterators ───────────────────── */\n\n  /**\n   * Iterate all features matching a bounding-box query, auto-paginating.\n   *\n   * @example\n   * ```ts\n   * for await (const feature of chrt.featuresIter({ bbox: [-74, 40, -73, 41] })) {\n   *   console.log(feature.properties);\n   * }\n   * ```\n   */\n  featuresIter(\n    options: Omit<FeaturesOptions, \"offset\">,\n  ): AsyncIterable<GeoJsonFeature> {\n    const pageSize = options.limit ?? 100;\n    return paginate<FeatureCollection, GeoJsonFeature>(\n      (offset, signal) =>\n        this.features({ ...options, limit: pageSize, offset, signal }),\n      (r) => r.features,\n      (r) => r.total_count ?? 0,\n      { pageSize, signal: options.signal },\n    );\n  }\n\n  /**\n   * Iterate all cells matching a query, auto-paginating.\n   *\n   * @example\n   * ```ts\n   * for await (const cell of chrt.cellsIter({ source: \"NOAA\" })) {\n   *   console.log(cell.cell_id, cell.title);\n   * }\n   * ```\n   */\n  cellsIter(\n    options?: Omit<CellsOptions, \"offset\">,\n  ): AsyncIterable<CellDetail> {\n    const pageSize = options?.limit ?? 100;\n    return paginate<CellsResponse, CellDetail>(\n      (offset, signal) =>\n        this.cells.list({ ...options, limit: pageSize, offset, signal }),\n      (r) => r.cells,\n      (r) => r.total_count,\n      { pageSize, signal: options?.signal },\n    );\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 { paginate } from \"./pagination.js\";\nexport { parseWebhook } from \"./webhooks.js\";\nexport type {\n  ChrtConfig,\n  FeaturesOptions,\n  QueryOptions,\n  CellsOptions,\n  CoverageOptions,\n  FeatureCollection,\n  GeoJsonFeature,\n  GeoJsonGeometry,\n  CellsResponse,\n  CellDetail,\n  CoverageSource,\n  CoverageResponse,\n  TileGroup,\n  TileGroupsResponse,\n  TransformRequest,\n} from \"./types.js\";\nexport type {\n  WebhookPayload,\n  WebhookEvent,\n  WebhookEventType,\n  CellUpdatedEvent,\n  CellNewEvent,\n  CellDeletedEvent,\n  CellEventData,\n  CellUpdatedData,\n} from \"./webhooks.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>(\n    path: string,\n    params?: Record<string, string | number | undefined>,\n    signal?: AbortSignal,\n  ): 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      if (signal?.aborted) {\n        throw signal.reason ?? new DOMException(\"The operation was aborted.\", \"AbortError\");\n      }\n\n      try {\n        const res = await fetch(url.toString(), {\n          headers: { \"x-api-key\": this.apiKey },\n          signal,\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        // Don't retry aborted requests\n        if (signal?.aborted) 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    const { signal, ...params } = options ?? {};\n    return this.http.request<CellsResponse>(\n      \"/cells\",\n      params as Record<string, string | number | undefined>,\n      signal,\n    );\n  }\n\n  /** Get a single cell by ID */\n  async get(cellId: string, signal?: AbortSignal): Promise<CellDetail> {\n    return this.http.request<CellDetail>(\n      `/cells/${encodeURIComponent(cellId)}`,\n      undefined,\n      signal,\n    );\n  }\n}\n","import type { HttpClient } from \"../client.js\";\nimport type { CoverageOptions, CoverageResponse } from \"../types.js\";\n\nexport class CoverageEndpoint {\n  constructor(private http: HttpClient) {}\n\n  /** List available chart sources with cell counts */\n  async list(options?: CoverageOptions): Promise<CoverageResponse> {\n    const { signal, ...params } = options ?? {};\n    return this.http.request<CoverageResponse>(\n      \"/coverage\",\n      params as Record<string, string | number | undefined>,\n      signal,\n    );\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>(\n      \"/features\",\n      {\n        bbox: options.bbox.join(\",\"),\n        layer: options.layer,\n        limit: options.limit,\n        offset: options.offset,\n      },\n      options.signal,\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>(\n      \"/query\",\n      {\n        point: options.point.join(\",\"),\n        radius: options.radius,\n        layer: options.layer,\n        limit: options.limit,\n      },\n      options.signal,\n    );\n  }\n}\n","/**\n * Generic async auto-pagination generator.\n *\n * Fetches pages from a callback that returns `{ items, total_count }` and\n * yields individual items until all pages are consumed or the signal is aborted.\n *\n * @example\n * ```ts\n * for await (const feature of paginate(\n *   (offset, signal) => chrt.features({ bbox, limit: 100, offset, signal }),\n *   f => f.features,\n *   f => f.total_count ?? 0,\n * )) {\n *   console.log(feature);\n * }\n * ```\n */\nexport async function* paginate<TResponse, TItem>(\n  fetchPage: (offset: number, signal?: AbortSignal) => Promise<TResponse>,\n  getItems: (response: TResponse) => TItem[],\n  getTotalCount: (response: TResponse) => number,\n  options?: { pageSize?: number; signal?: AbortSignal },\n): AsyncGenerator<TItem, void, undefined> {\n  const pageSize = options?.pageSize ?? 100;\n  const signal = options?.signal;\n  let offset = 0;\n\n  // eslint-disable-next-line no-constant-condition\n  while (true) {\n    if (signal?.aborted) return;\n\n    const response = await fetchPage(offset, signal);\n    const items = getItems(response);\n\n    for (const item of items) {\n      yield item;\n    }\n\n    if (items.length === 0) return;\n\n    offset += items.length;\n    const total = getTotalCount(response);\n    if (total > 0 && offset >= total) return;\n  }\n}\n","/* ── Webhook event types ───────────────────────────── */\n\n/** Base envelope for all webhook payloads */\nexport interface WebhookPayload<T extends string, D> {\n  /** Unique event ID */\n  id: string;\n  /** ISO 8601 timestamp */\n  timestamp: string;\n  /** Event type discriminator */\n  type: T;\n  /** Event-specific data */\n  data: D;\n}\n\n/* ── Event data shapes ─────────────────────────────── */\n\nexport interface CellEventData {\n  cell_id: string;\n  chart_source: string;\n  title: string | null;\n  edition: number | null;\n  update_number: number | null;\n  scale_band: string | null;\n}\n\nexport interface CellUpdatedData extends CellEventData {\n  previous_edition: number | null;\n  previous_update_number: number | null;\n}\n\n/* ── Concrete event types ──────────────────────────── */\n\nexport type CellUpdatedEvent = WebhookPayload<\"cell.updated\", CellUpdatedData>;\nexport type CellNewEvent = WebhookPayload<\"cell.new\", CellEventData>;\nexport type CellDeletedEvent = WebhookPayload<\"cell.deleted\", CellEventData>;\n\n/** Discriminated union of all webhook events */\nexport type WebhookEvent = CellUpdatedEvent | CellNewEvent | CellDeletedEvent;\n\n/** All recognised webhook event type strings */\nexport type WebhookEventType = WebhookEvent[\"type\"];\n\n/* ── Runtime parser ────────────────────────────────── */\n\nconst VALID_TYPES = new Set<string>([\"cell.updated\", \"cell.new\", \"cell.deleted\"]);\n\n/**\n * Parse and validate a raw webhook payload.\n *\n * @param body - The raw request body (parsed JSON object)\n * @returns A typed `WebhookEvent`\n * @throws Error if the payload is malformed or has an unknown event type\n *\n * @example\n * ```ts\n * import { parseWebhook } from \"@chrtco/sdk\";\n *\n * app.post(\"/webhooks/chrt\", (req, res) => {\n *   const event = parseWebhook(req.body);\n *   switch (event.type) {\n *     case \"cell.updated\":\n *       console.log(\"Cell updated:\", event.data.cell_id);\n *       break;\n *     case \"cell.new\":\n *       console.log(\"New cell:\", event.data.cell_id);\n *       break;\n *   }\n *   res.sendStatus(200);\n * });\n * ```\n */\nexport function parseWebhook(body: unknown): WebhookEvent {\n  if (typeof body !== \"object\" || body === null) {\n    throw new Error(\"Invalid webhook payload: expected an object\");\n  }\n\n  const obj = body as Record<string, unknown>;\n\n  if (typeof obj.id !== \"string\") {\n    throw new Error(\"Invalid webhook payload: missing 'id'\");\n  }\n  if (typeof obj.timestamp !== \"string\") {\n    throw new Error(\"Invalid webhook payload: missing 'timestamp'\");\n  }\n  if (typeof obj.type !== \"string\" || !VALID_TYPES.has(obj.type)) {\n    throw new Error(`Invalid webhook payload: unknown type '${String(obj.type)}'`);\n  }\n  if (typeof obj.data !== \"object\" || obj.data === null) {\n    throw new Error(\"Invalid webhook payload: missing 'data'\");\n  }\n\n  return obj as unknown as WebhookEvent;\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -23,6 +23,8 @@ interface FeaturesOptions {
     limit?: number;
     /** Pagination offset */
     offset?: number;
+    /** AbortSignal to cancel the request */
+    signal?: AbortSignal;
 }
 interface QueryOptions {
     /** [longitude, latitude] */
@@ -32,6 +34,8 @@ interface QueryOptions {
     /** Comma-separated layer codes */
     layer?: string;
     limit?: number;
+    /** AbortSignal to cancel the request */
+    signal?: AbortSignal;
 }
 interface CellsOptions {
     /** Filter by chart source, e.g. "NOAA" */
@@ -40,6 +44,8 @@ interface CellsOptions {
     status?: string;
     limit?: number;
     offset?: number;
+    /** AbortSignal to cancel the request */
+    signal?: AbortSignal;
 }
 interface CellDetail {
     cell_id: string;
@@ -62,6 +68,30 @@ interface CellsResponse {
     limit: number;
     offset: number;
 }
+interface CoverageSource {
+    /** Chart source ID, e.g. "NOAA" */
+    source: string;
+    /** ISO 3166-1 alpha-2 country code */
+    country: string;
+    /** Display name of the agency */
+    agency: string;
+    /** Number of available ENC cells */
+    cell_count: number;
+    /** Scale bands with cell counts */
+    scale_bands?: Record<string, number>;
+}
+interface CoverageResponse {
+    sources: CoverageSource[];
+    total_cells: number;
+}
+interface CoverageOptions {
+    /** Filter by country code */
+    country?: string;
+    /** Filter by chart source */
+    source?: string;
+    /** AbortSignal to cancel the request */
+    signal?: AbortSignal;
+}
 interface TileGroup {
     id: string;
     display_name: string;
@@ -102,7 +132,7 @@ declare class HttpClient {
     constructor(apiKey: string, baseUrl?: string, retries?: number);
     getBaseUrl(): string;
     getApiKey(): string;
-    request<T>(path: string, params?: Record<string, string | number | undefined>): Promise<T>;
+    request<T>(path: string, params?: Record<string, string | number | undefined>, signal?: AbortSignal): Promise<T>;
 }
 
 declare class TilesEndpoint {
@@ -122,14 +152,102 @@ declare class CellsEndpoint {
     /** List ENC cells with optional filters */
     list(options?: CellsOptions): Promise<CellsResponse>;
     /** Get a single cell by ID */
-    get(cellId: string): Promise<CellDetail>;
+    get(cellId: string, signal?: AbortSignal): Promise<CellDetail>;
+}
+
+declare class CoverageEndpoint {
+    private http;
+    constructor(http: HttpClient);
+    /** List available chart sources with cell counts */
+    list(options?: CoverageOptions): Promise<CoverageResponse>;
+}
+
+/**
+ * Generic async auto-pagination generator.
+ *
+ * Fetches pages from a callback that returns `{ items, total_count }` and
+ * yields individual items until all pages are consumed or the signal is aborted.
+ *
+ * @example
+ * ```ts
+ * for await (const feature of paginate(
+ *   (offset, signal) => chrt.features({ bbox, limit: 100, offset, signal }),
+ *   f => f.features,
+ *   f => f.total_count ?? 0,
+ * )) {
+ *   console.log(feature);
+ * }
+ * ```
+ */
+declare function paginate<TResponse, TItem>(fetchPage: (offset: number, signal?: AbortSignal) => Promise<TResponse>, getItems: (response: TResponse) => TItem[], getTotalCount: (response: TResponse) => number, options?: {
+    pageSize?: number;
+    signal?: AbortSignal;
+}): AsyncGenerator<TItem, void, undefined>;
+
+/** Base envelope for all webhook payloads */
+interface WebhookPayload<T extends string, D> {
+    /** Unique event ID */
+    id: string;
+    /** ISO 8601 timestamp */
+    timestamp: string;
+    /** Event type discriminator */
+    type: T;
+    /** Event-specific data */
+    data: D;
+}
+interface CellEventData {
+    cell_id: string;
+    chart_source: string;
+    title: string | null;
+    edition: number | null;
+    update_number: number | null;
+    scale_band: string | null;
+}
+interface CellUpdatedData extends CellEventData {
+    previous_edition: number | null;
+    previous_update_number: number | null;
 }
+type CellUpdatedEvent = WebhookPayload<"cell.updated", CellUpdatedData>;
+type CellNewEvent = WebhookPayload<"cell.new", CellEventData>;
+type CellDeletedEvent = WebhookPayload<"cell.deleted", CellEventData>;
+/** Discriminated union of all webhook events */
+type WebhookEvent = CellUpdatedEvent | CellNewEvent | CellDeletedEvent;
+/** All recognised webhook event type strings */
+type WebhookEventType = WebhookEvent["type"];
+/**
+ * Parse and validate a raw webhook payload.
+ *
+ * @param body - The raw request body (parsed JSON object)
+ * @returns A typed `WebhookEvent`
+ * @throws Error if the payload is malformed or has an unknown event type
+ *
+ * @example
+ * ```ts
+ * import { parseWebhook } from "@chrtco/sdk";
+ *
+ * app.post("/webhooks/chrt", (req, res) => {
+ *   const event = parseWebhook(req.body);
+ *   switch (event.type) {
+ *     case "cell.updated":
+ *       console.log("Cell updated:", event.data.cell_id);
+ *       break;
+ *     case "cell.new":
+ *       console.log("New cell:", event.data.cell_id);
+ *       break;
+ *   }
+ *   res.sendStatus(200);
+ * });
+ * ```
+ */
+declare function parseWebhook(body: unknown): WebhookEvent;
 
 declare class Chrt {
     /** Tile endpoints — styleUrl, tileUrl, groups */
     readonly tiles: TilesEndpoint;
     /** Cell catalogue endpoints — list, get */
     readonly cells: CellsEndpoint;
+    /** Coverage data — list available chart sources */
+    readonly coverage: CoverageEndpoint;
     private featuresEp;
     private queryEp;
     private http;
@@ -138,6 +256,28 @@ declare class Chrt {
     features(options: FeaturesOptions): Promise<FeatureCollection>;
     /** Spatial proximity query around a point */
     query(options: QueryOptions): Promise<FeatureCollection>;
+    /**
+     * Iterate all features matching a bounding-box query, auto-paginating.
+     *
+     * @example
+     * ```ts
+     * for await (const feature of chrt.featuresIter({ bbox: [-74, 40, -73, 41] })) {
+     *   console.log(feature.properties);
+     * }
+     * ```
+     */
+    featuresIter(options: Omit<FeaturesOptions, "offset">): AsyncIterable<GeoJsonFeature>;
+    /**
+     * Iterate all cells matching a query, auto-paginating.
+     *
+     * @example
+     * ```ts
+     * for await (const cell of chrt.cellsIter({ source: "NOAA" })) {
+     *   console.log(cell.cell_id, cell.title);
+     * }
+     * ```
+     */
+    cellsIter(options?: Omit<CellsOptions, "offset">): AsyncIterable<CellDetail>;
     /** Returns a style.json URL ready for Mapbox GL / MapLibre */
     styleUrl(): string;
     /**
@@ -153,4 +293,4 @@ declare class Chrt {
     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 };
+export { type CellDeletedEvent, type CellDetail, type CellEventData, type CellNewEvent, type CellUpdatedData, type CellUpdatedEvent, type CellsOptions, type CellsResponse, Chrt, type ChrtConfig, ChrtError, type CoverageOptions, type CoverageResponse, type CoverageSource, type FeatureCollection, type FeaturesOptions, type GeoJsonFeature, type GeoJsonGeometry, type QueryOptions, type TileGroup, type TileGroupsResponse, type TransformRequest, type WebhookEvent, type WebhookEventType, type WebhookPayload, paginate, parseWebhook };

package/dist/index.d.ts

@@ -23,6 +23,8 @@ interface FeaturesOptions {
     limit?: number;
     /** Pagination offset */
     offset?: number;
+    /** AbortSignal to cancel the request */
+    signal?: AbortSignal;
 }
 interface QueryOptions {
     /** [longitude, latitude] */
@@ -32,6 +34,8 @@ interface QueryOptions {
     /** Comma-separated layer codes */
     layer?: string;
     limit?: number;
+    /** AbortSignal to cancel the request */
+    signal?: AbortSignal;
 }
 interface CellsOptions {
     /** Filter by chart source, e.g. "NOAA" */
@@ -40,6 +44,8 @@ interface CellsOptions {
     status?: string;
     limit?: number;
     offset?: number;
+    /** AbortSignal to cancel the request */
+    signal?: AbortSignal;
 }
 interface CellDetail {
     cell_id: string;
@@ -62,6 +68,30 @@ interface CellsResponse {
     limit: number;
     offset: number;
 }
+interface CoverageSource {
+    /** Chart source ID, e.g. "NOAA" */
+    source: string;
+    /** ISO 3166-1 alpha-2 country code */
+    country: string;
+    /** Display name of the agency */
+    agency: string;
+    /** Number of available ENC cells */
+    cell_count: number;
+    /** Scale bands with cell counts */
+    scale_bands?: Record<string, number>;
+}
+interface CoverageResponse {
+    sources: CoverageSource[];
+    total_cells: number;
+}
+interface CoverageOptions {
+    /** Filter by country code */
+    country?: string;
+    /** Filter by chart source */
+    source?: string;
+    /** AbortSignal to cancel the request */
+    signal?: AbortSignal;
+}
 interface TileGroup {
     id: string;
     display_name: string;
@@ -102,7 +132,7 @@ declare class HttpClient {
     constructor(apiKey: string, baseUrl?: string, retries?: number);
     getBaseUrl(): string;
     getApiKey(): string;
-    request<T>(path: string, params?: Record<string, string | number | undefined>): Promise<T>;
+    request<T>(path: string, params?: Record<string, string | number | undefined>, signal?: AbortSignal): Promise<T>;
 }
 
 declare class TilesEndpoint {
@@ -122,14 +152,102 @@ declare class CellsEndpoint {
     /** List ENC cells with optional filters */
     list(options?: CellsOptions): Promise<CellsResponse>;
     /** Get a single cell by ID */
-    get(cellId: string): Promise<CellDetail>;
+    get(cellId: string, signal?: AbortSignal): Promise<CellDetail>;
+}
+
+declare class CoverageEndpoint {
+    private http;
+    constructor(http: HttpClient);
+    /** List available chart sources with cell counts */
+    list(options?: CoverageOptions): Promise<CoverageResponse>;
+}
+
+/**
+ * Generic async auto-pagination generator.
+ *
+ * Fetches pages from a callback that returns `{ items, total_count }` and
+ * yields individual items until all pages are consumed or the signal is aborted.
+ *
+ * @example
+ * ```ts
+ * for await (const feature of paginate(
+ *   (offset, signal) => chrt.features({ bbox, limit: 100, offset, signal }),
+ *   f => f.features,
+ *   f => f.total_count ?? 0,
+ * )) {
+ *   console.log(feature);
+ * }
+ * ```
+ */
+declare function paginate<TResponse, TItem>(fetchPage: (offset: number, signal?: AbortSignal) => Promise<TResponse>, getItems: (response: TResponse) => TItem[], getTotalCount: (response: TResponse) => number, options?: {
+    pageSize?: number;
+    signal?: AbortSignal;
+}): AsyncGenerator<TItem, void, undefined>;
+
+/** Base envelope for all webhook payloads */
+interface WebhookPayload<T extends string, D> {
+    /** Unique event ID */
+    id: string;
+    /** ISO 8601 timestamp */
+    timestamp: string;
+    /** Event type discriminator */
+    type: T;
+    /** Event-specific data */
+    data: D;
+}
+interface CellEventData {
+    cell_id: string;
+    chart_source: string;
+    title: string | null;
+    edition: number | null;
+    update_number: number | null;
+    scale_band: string | null;
+}
+interface CellUpdatedData extends CellEventData {
+    previous_edition: number | null;
+    previous_update_number: number | null;
 }
+type CellUpdatedEvent = WebhookPayload<"cell.updated", CellUpdatedData>;
+type CellNewEvent = WebhookPayload<"cell.new", CellEventData>;
+type CellDeletedEvent = WebhookPayload<"cell.deleted", CellEventData>;
+/** Discriminated union of all webhook events */
+type WebhookEvent = CellUpdatedEvent | CellNewEvent | CellDeletedEvent;
+/** All recognised webhook event type strings */
+type WebhookEventType = WebhookEvent["type"];
+/**
+ * Parse and validate a raw webhook payload.
+ *
+ * @param body - The raw request body (parsed JSON object)
+ * @returns A typed `WebhookEvent`
+ * @throws Error if the payload is malformed or has an unknown event type
+ *
+ * @example
+ * ```ts
+ * import { parseWebhook } from "@chrtco/sdk";
+ *
+ * app.post("/webhooks/chrt", (req, res) => {
+ *   const event = parseWebhook(req.body);
+ *   switch (event.type) {
+ *     case "cell.updated":
+ *       console.log("Cell updated:", event.data.cell_id);
+ *       break;
+ *     case "cell.new":
+ *       console.log("New cell:", event.data.cell_id);
+ *       break;
+ *   }
+ *   res.sendStatus(200);
+ * });
+ * ```
+ */
+declare function parseWebhook(body: unknown): WebhookEvent;
 
 declare class Chrt {
     /** Tile endpoints — styleUrl, tileUrl, groups */
     readonly tiles: TilesEndpoint;
     /** Cell catalogue endpoints — list, get */
     readonly cells: CellsEndpoint;
+    /** Coverage data — list available chart sources */
+    readonly coverage: CoverageEndpoint;
     private featuresEp;
     private queryEp;
     private http;
@@ -138,6 +256,28 @@ declare class Chrt {
     features(options: FeaturesOptions): Promise<FeatureCollection>;
     /** Spatial proximity query around a point */
     query(options: QueryOptions): Promise<FeatureCollection>;
+    /**
+     * Iterate all features matching a bounding-box query, auto-paginating.
+     *
+     * @example
+     * ```ts
+     * for await (const feature of chrt.featuresIter({ bbox: [-74, 40, -73, 41] })) {
+     *   console.log(feature.properties);
+     * }
+     * ```
+     */
+    featuresIter(options: Omit<FeaturesOptions, "offset">): AsyncIterable<GeoJsonFeature>;
+    /**
+     * Iterate all cells matching a query, auto-paginating.
+     *
+     * @example
+     * ```ts
+     * for await (const cell of chrt.cellsIter({ source: "NOAA" })) {
+     *   console.log(cell.cell_id, cell.title);
+     * }
+     * ```
+     */
+    cellsIter(options?: Omit<CellsOptions, "offset">): AsyncIterable<CellDetail>;
     /** Returns a style.json URL ready for Mapbox GL / MapLibre */
     styleUrl(): string;
     /**
@@ -153,4 +293,4 @@ declare class Chrt {
     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 };
+export { type CellDeletedEvent, type CellDetail, type CellEventData, type CellNewEvent, type CellUpdatedData, type CellUpdatedEvent, type CellsOptions, type CellsResponse, Chrt, type ChrtConfig, ChrtError, type CoverageOptions, type CoverageResponse, type CoverageSource, type FeatureCollection, type FeaturesOptions, type GeoJsonFeature, type GeoJsonGeometry, type QueryOptions, type TileGroup, type TileGroupsResponse, type TransformRequest, type WebhookEvent, type WebhookEventType, type WebhookPayload, paginate, parseWebhook };

package/dist/index.js

@@ -27,7 +27,7 @@ var HttpClient = class {
   getApiKey() {
     return this.apiKey;
   }
-  async request(path, params) {
+  async request(path, params, signal) {
     const url = new URL(`${this.baseUrl}${path}`);
     if (params) {
       for (const [k, v] of Object.entries(params)) {
@@ -36,9 +36,13 @@ var HttpClient = class {
     }
     let lastError = null;
     for (let attempt = 0; attempt <= this.retries; attempt++) {
+      if (signal?.aborted) {
+        throw signal.reason ?? new DOMException("The operation was aborted.", "AbortError");
+      }
       try {
         const res = await fetch(url.toString(), {
-          headers: { "x-api-key": this.apiKey }
+          headers: { "x-api-key": this.apiKey },
+          signal
         });
         if (!res.ok) {
           let body;
@@ -57,6 +61,7 @@ var HttpClient = class {
         return await res.json();
       } catch (e) {
         if (e instanceof ChrtError) throw e;
+        if (signal?.aborted) throw e;
         lastError = e;
         if (attempt < this.retries) {
           await sleep(100 * 2 ** attempt);
@@ -97,11 +102,36 @@ var CellsEndpoint = class {
   }
   /** List ENC cells with optional filters */
   async list(options) {
-    return this.http.request("/cells", options);
+    const { signal, ...params } = options ?? {};
+    return this.http.request(
+      "/cells",
+      params,
+      signal
+    );
   }
   /** Get a single cell by ID */
-  async get(cellId) {
-    return this.http.request(`/cells/${encodeURIComponent(cellId)}`);
+  async get(cellId, signal) {
+    return this.http.request(
+      `/cells/${encodeURIComponent(cellId)}`,
+      void 0,
+      signal
+    );
+  }
+};
+
+// src/endpoints/coverage.ts
+var CoverageEndpoint = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /** List available chart sources with cell counts */
+  async list(options) {
+    const { signal, ...params } = options ?? {};
+    return this.http.request(
+      "/coverage",
+      params,
+      signal
+    );
   }
 };
 
@@ -112,12 +142,16 @@ var FeaturesEndpoint = class {
   }
   /** 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
-    });
+    return this.http.request(
+      "/features",
+      {
+        bbox: options.bbox.join(","),
+        layer: options.layer,
+        limit: options.limit,
+        offset: options.offset
+      },
+      options.signal
+    );
   }
 };
 
@@ -128,21 +162,68 @@ var QueryEndpoint = class {
   }
   /** 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
-    });
+    return this.http.request(
+      "/query",
+      {
+        point: options.point.join(","),
+        radius: options.radius,
+        layer: options.layer,
+        limit: options.limit
+      },
+      options.signal
+    );
   }
 };
 
+// src/pagination.ts
+async function* paginate(fetchPage, getItems, getTotalCount, options) {
+  const pageSize = options?.pageSize ?? 100;
+  const signal = options?.signal;
+  let offset = 0;
+  while (true) {
+    if (signal?.aborted) return;
+    const response = await fetchPage(offset, signal);
+    const items = getItems(response);
+    for (const item of items) {
+      yield item;
+    }
+    if (items.length === 0) return;
+    offset += items.length;
+    const total = getTotalCount(response);
+    if (total > 0 && offset >= total) return;
+  }
+}
+
+// src/webhooks.ts
+var VALID_TYPES = /* @__PURE__ */ new Set(["cell.updated", "cell.new", "cell.deleted"]);
+function parseWebhook(body) {
+  if (typeof body !== "object" || body === null) {
+    throw new Error("Invalid webhook payload: expected an object");
+  }
+  const obj = body;
+  if (typeof obj.id !== "string") {
+    throw new Error("Invalid webhook payload: missing 'id'");
+  }
+  if (typeof obj.timestamp !== "string") {
+    throw new Error("Invalid webhook payload: missing 'timestamp'");
+  }
+  if (typeof obj.type !== "string" || !VALID_TYPES.has(obj.type)) {
+    throw new Error(`Invalid webhook payload: unknown type '${String(obj.type)}'`);
+  }
+  if (typeof obj.data !== "object" || obj.data === null) {
+    throw new Error("Invalid webhook payload: missing 'data'");
+  }
+  return obj;
+}
+
 // src/index.ts
 var Chrt = class {
   /** Tile endpoints — styleUrl, tileUrl, groups */
   tiles;
   /** Cell catalogue endpoints — list, get */
   cells;
+  /** Coverage data — list available chart sources */
+  coverage;
   featuresEp;
   queryEp;
   http;
@@ -151,6 +232,7 @@ var Chrt = class {
     this.http = new HttpClient(config.apiKey, config.baseUrl, config.retries);
     this.tiles = new TilesEndpoint(this.http);
     this.cells = new CellsEndpoint(this.http);
+    this.coverage = new CoverageEndpoint(this.http);
     this.featuresEp = new FeaturesEndpoint(this.http);
     this.queryEp = new QueryEndpoint(this.http);
   }
@@ -163,6 +245,45 @@ var Chrt = class {
   async query(options) {
     return this.queryEp.nearby(options);
   }
+  /* ── Auto-pagination iterators ───────────────────── */
+  /**
+   * Iterate all features matching a bounding-box query, auto-paginating.
+   *
+   * @example
+   * ```ts
+   * for await (const feature of chrt.featuresIter({ bbox: [-74, 40, -73, 41] })) {
+   *   console.log(feature.properties);
+   * }
+   * ```
+   */
+  featuresIter(options) {
+    const pageSize = options.limit ?? 100;
+    return paginate(
+      (offset, signal) => this.features({ ...options, limit: pageSize, offset, signal }),
+      (r) => r.features,
+      (r) => r.total_count ?? 0,
+      { pageSize, signal: options.signal }
+    );
+  }
+  /**
+   * Iterate all cells matching a query, auto-paginating.
+   *
+   * @example
+   * ```ts
+   * for await (const cell of chrt.cellsIter({ source: "NOAA" })) {
+   *   console.log(cell.cell_id, cell.title);
+   * }
+   * ```
+   */
+  cellsIter(options) {
+    const pageSize = options?.limit ?? 100;
+    return paginate(
+      (offset, signal) => this.cells.list({ ...options, limit: pageSize, offset, signal }),
+      (r) => r.cells,
+      (r) => r.total_count,
+      { pageSize, signal: options?.signal }
+    );
+  }
   /* ── Map integration helpers ─────────────────────── */
   /** Returns a style.json URL ready for Mapbox GL / MapLibre */
   styleUrl() {
@@ -190,6 +311,8 @@ var Chrt = class {
 };
 export {
   Chrt,
-  ChrtError
+  ChrtError,
+  paginate,
+  parseWebhook
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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":[]}
+{"version":3,"sources":["../src/client.ts","../src/endpoints/tiles.ts","../src/endpoints/cells.ts","../src/endpoints/coverage.ts","../src/endpoints/features.ts","../src/endpoints/query.ts","../src/pagination.ts","../src/webhooks.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>(\n    path: string,\n    params?: Record<string, string | number | undefined>,\n    signal?: AbortSignal,\n  ): 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      if (signal?.aborted) {\n        throw signal.reason ?? new DOMException(\"The operation was aborted.\", \"AbortError\");\n      }\n\n      try {\n        const res = await fetch(url.toString(), {\n          headers: { \"x-api-key\": this.apiKey },\n          signal,\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        // Don't retry aborted requests\n        if (signal?.aborted) 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    const { signal, ...params } = options ?? {};\n    return this.http.request<CellsResponse>(\n      \"/cells\",\n      params as Record<string, string | number | undefined>,\n      signal,\n    );\n  }\n\n  /** Get a single cell by ID */\n  async get(cellId: string, signal?: AbortSignal): Promise<CellDetail> {\n    return this.http.request<CellDetail>(\n      `/cells/${encodeURIComponent(cellId)}`,\n      undefined,\n      signal,\n    );\n  }\n}\n","import type { HttpClient } from \"../client.js\";\nimport type { CoverageOptions, CoverageResponse } from \"../types.js\";\n\nexport class CoverageEndpoint {\n  constructor(private http: HttpClient) {}\n\n  /** List available chart sources with cell counts */\n  async list(options?: CoverageOptions): Promise<CoverageResponse> {\n    const { signal, ...params } = options ?? {};\n    return this.http.request<CoverageResponse>(\n      \"/coverage\",\n      params as Record<string, string | number | undefined>,\n      signal,\n    );\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>(\n      \"/features\",\n      {\n        bbox: options.bbox.join(\",\"),\n        layer: options.layer,\n        limit: options.limit,\n        offset: options.offset,\n      },\n      options.signal,\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>(\n      \"/query\",\n      {\n        point: options.point.join(\",\"),\n        radius: options.radius,\n        layer: options.layer,\n        limit: options.limit,\n      },\n      options.signal,\n    );\n  }\n}\n","/**\n * Generic async auto-pagination generator.\n *\n * Fetches pages from a callback that returns `{ items, total_count }` and\n * yields individual items until all pages are consumed or the signal is aborted.\n *\n * @example\n * ```ts\n * for await (const feature of paginate(\n *   (offset, signal) => chrt.features({ bbox, limit: 100, offset, signal }),\n *   f => f.features,\n *   f => f.total_count ?? 0,\n * )) {\n *   console.log(feature);\n * }\n * ```\n */\nexport async function* paginate<TResponse, TItem>(\n  fetchPage: (offset: number, signal?: AbortSignal) => Promise<TResponse>,\n  getItems: (response: TResponse) => TItem[],\n  getTotalCount: (response: TResponse) => number,\n  options?: { pageSize?: number; signal?: AbortSignal },\n): AsyncGenerator<TItem, void, undefined> {\n  const pageSize = options?.pageSize ?? 100;\n  const signal = options?.signal;\n  let offset = 0;\n\n  // eslint-disable-next-line no-constant-condition\n  while (true) {\n    if (signal?.aborted) return;\n\n    const response = await fetchPage(offset, signal);\n    const items = getItems(response);\n\n    for (const item of items) {\n      yield item;\n    }\n\n    if (items.length === 0) return;\n\n    offset += items.length;\n    const total = getTotalCount(response);\n    if (total > 0 && offset >= total) return;\n  }\n}\n","/* ── Webhook event types ───────────────────────────── */\n\n/** Base envelope for all webhook payloads */\nexport interface WebhookPayload<T extends string, D> {\n  /** Unique event ID */\n  id: string;\n  /** ISO 8601 timestamp */\n  timestamp: string;\n  /** Event type discriminator */\n  type: T;\n  /** Event-specific data */\n  data: D;\n}\n\n/* ── Event data shapes ─────────────────────────────── */\n\nexport interface CellEventData {\n  cell_id: string;\n  chart_source: string;\n  title: string | null;\n  edition: number | null;\n  update_number: number | null;\n  scale_band: string | null;\n}\n\nexport interface CellUpdatedData extends CellEventData {\n  previous_edition: number | null;\n  previous_update_number: number | null;\n}\n\n/* ── Concrete event types ──────────────────────────── */\n\nexport type CellUpdatedEvent = WebhookPayload<\"cell.updated\", CellUpdatedData>;\nexport type CellNewEvent = WebhookPayload<\"cell.new\", CellEventData>;\nexport type CellDeletedEvent = WebhookPayload<\"cell.deleted\", CellEventData>;\n\n/** Discriminated union of all webhook events */\nexport type WebhookEvent = CellUpdatedEvent | CellNewEvent | CellDeletedEvent;\n\n/** All recognised webhook event type strings */\nexport type WebhookEventType = WebhookEvent[\"type\"];\n\n/* ── Runtime parser ────────────────────────────────── */\n\nconst VALID_TYPES = new Set<string>([\"cell.updated\", \"cell.new\", \"cell.deleted\"]);\n\n/**\n * Parse and validate a raw webhook payload.\n *\n * @param body - The raw request body (parsed JSON object)\n * @returns A typed `WebhookEvent`\n * @throws Error if the payload is malformed or has an unknown event type\n *\n * @example\n * ```ts\n * import { parseWebhook } from \"@chrtco/sdk\";\n *\n * app.post(\"/webhooks/chrt\", (req, res) => {\n *   const event = parseWebhook(req.body);\n *   switch (event.type) {\n *     case \"cell.updated\":\n *       console.log(\"Cell updated:\", event.data.cell_id);\n *       break;\n *     case \"cell.new\":\n *       console.log(\"New cell:\", event.data.cell_id);\n *       break;\n *   }\n *   res.sendStatus(200);\n * });\n * ```\n */\nexport function parseWebhook(body: unknown): WebhookEvent {\n  if (typeof body !== \"object\" || body === null) {\n    throw new Error(\"Invalid webhook payload: expected an object\");\n  }\n\n  const obj = body as Record<string, unknown>;\n\n  if (typeof obj.id !== \"string\") {\n    throw new Error(\"Invalid webhook payload: missing 'id'\");\n  }\n  if (typeof obj.timestamp !== \"string\") {\n    throw new Error(\"Invalid webhook payload: missing 'timestamp'\");\n  }\n  if (typeof obj.type !== \"string\" || !VALID_TYPES.has(obj.type)) {\n    throw new Error(`Invalid webhook payload: unknown type '${String(obj.type)}'`);\n  }\n  if (typeof obj.data !== \"object\" || obj.data === null) {\n    throw new Error(\"Invalid webhook payload: missing 'data'\");\n  }\n\n  return obj as unknown as WebhookEvent;\n}\n","import { HttpClient, ChrtError } from \"./client.js\";\nimport { TilesEndpoint } from \"./endpoints/tiles.js\";\nimport { CellsEndpoint } from \"./endpoints/cells.js\";\nimport { CoverageEndpoint } from \"./endpoints/coverage.js\";\nimport { FeaturesEndpoint } from \"./endpoints/features.js\";\nimport { QueryEndpoint } from \"./endpoints/query.js\";\nimport { paginate } from \"./pagination.js\";\nimport type {\n  ChrtConfig,\n  FeaturesOptions,\n  QueryOptions,\n  CellsOptions,\n  CoverageOptions,\n  FeatureCollection,\n  GeoJsonFeature,\n  CellsResponse,\n  CellDetail,\n  CoverageResponse,\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  /** Coverage data — list available chart sources */\n  readonly coverage: CoverageEndpoint;\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.coverage = new CoverageEndpoint(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  /* ── Auto-pagination iterators ───────────────────── */\n\n  /**\n   * Iterate all features matching a bounding-box query, auto-paginating.\n   *\n   * @example\n   * ```ts\n   * for await (const feature of chrt.featuresIter({ bbox: [-74, 40, -73, 41] })) {\n   *   console.log(feature.properties);\n   * }\n   * ```\n   */\n  featuresIter(\n    options: Omit<FeaturesOptions, \"offset\">,\n  ): AsyncIterable<GeoJsonFeature> {\n    const pageSize = options.limit ?? 100;\n    return paginate<FeatureCollection, GeoJsonFeature>(\n      (offset, signal) =>\n        this.features({ ...options, limit: pageSize, offset, signal }),\n      (r) => r.features,\n      (r) => r.total_count ?? 0,\n      { pageSize, signal: options.signal },\n    );\n  }\n\n  /**\n   * Iterate all cells matching a query, auto-paginating.\n   *\n   * @example\n   * ```ts\n   * for await (const cell of chrt.cellsIter({ source: \"NOAA\" })) {\n   *   console.log(cell.cell_id, cell.title);\n   * }\n   * ```\n   */\n  cellsIter(\n    options?: Omit<CellsOptions, \"offset\">,\n  ): AsyncIterable<CellDetail> {\n    const pageSize = options?.limit ?? 100;\n    return paginate<CellsResponse, CellDetail>(\n      (offset, signal) =>\n        this.cells.list({ ...options, limit: pageSize, offset, signal }),\n      (r) => r.cells,\n      (r) => r.total_count,\n      { pageSize, signal: options?.signal },\n    );\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 { paginate } from \"./pagination.js\";\nexport { parseWebhook } from \"./webhooks.js\";\nexport type {\n  ChrtConfig,\n  FeaturesOptions,\n  QueryOptions,\n  CellsOptions,\n  CoverageOptions,\n  FeatureCollection,\n  GeoJsonFeature,\n  GeoJsonGeometry,\n  CellsResponse,\n  CellDetail,\n  CoverageSource,\n  CoverageResponse,\n  TileGroup,\n  TileGroupsResponse,\n  TransformRequest,\n} from \"./types.js\";\nexport type {\n  WebhookPayload,\n  WebhookEvent,\n  WebhookEventType,\n  CellUpdatedEvent,\n  CellNewEvent,\n  CellDeletedEvent,\n  CellEventData,\n  CellUpdatedData,\n} from \"./webhooks.js\";\n"],"mappings":";AAEA,IAAM,mBAAmB;AAElB,IAAM,YAAN,cAAwB,MAAM;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,QAAgB,MAAsB;AAChD,UAAM,MAAM,WAAW,MAAM,SAAS,kBAAkB,MAAM,EAAE;AAChE,SAAK,OAAO;AACZ,SAAK,SAAS;AACd,SAAK,OAAO,MAAM;AAClB,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,aAAN,MAAiB;AAAA,EACd;AAAA,EACA;AAAA,EACA;AAAA,EAER,YAAY,QAAgB,SAAkB,UAAU,GAAG;AACzD,SAAK,SAAS;AACd,SAAK,WAAW,WAAW,kBAAkB,QAAQ,QAAQ,EAAE;AAC/D,SAAK,UAAU;AAAA,EACjB;AAAA,EAEA,aAAqB;AACnB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,YAAoB;AAClB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAM,QACJ,MACA,QACA,QACY;AACZ,UAAM,MAAM,IAAI,IAAI,GAAG,KAAK,OAAO,GAAG,IAAI,EAAE;AAC5C,QAAI,QAAQ;AACV,iBAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,MAAM,GAAG;AAC3C,YAAI,MAAM,OAAW,KAAI,aAAa,IAAI,GAAG,OAAO,CAAC,CAAC;AAAA,MACxD;AAAA,IACF;AAEA,QAAI,YAA0B;AAE9B,aAAS,UAAU,GAAG,WAAW,KAAK,SAAS,WAAW;AACxD,UAAI,QAAQ,SAAS;AACnB,cAAM,OAAO,UAAU,IAAI,aAAa,8BAA8B,YAAY;AAAA,MACpF;AAEA,UAAI;AACF,cAAM,MAAM,MAAM,MAAM,IAAI,SAAS,GAAG;AAAA,UACtC,SAAS,EAAE,aAAa,KAAK,OAAO;AAAA,UACpC;AAAA,QACF,CAAC;AAED,YAAI,CAAC,IAAI,IAAI;AACX,cAAI;AACJ,cAAI;AACF,mBAAO,MAAM,IAAI,KAAK;AAAA,UACxB,QAAQ;AAAA,UAER;AACA,gBAAM,MAAM,IAAI,UAAU,IAAI,QAAQ,IAAI;AAG1C,cAAI,IAAI,UAAU,OAAO,UAAU,KAAK,SAAS;AAC/C,wBAAY;AACZ,kBAAM,MAAM,MAAM,KAAK,OAAO;AAC9B;AAAA,UACF;AACA,gBAAM;AAAA,QACR;AAEA,eAAQ,MAAM,IAAI,KAAK;AAAA,MACzB,SAAS,GAAG;AACV,YAAI,aAAa,UAAW,OAAM;AAElC,YAAI,QAAQ,QAAS,OAAM;AAC3B,oBAAY;AACZ,YAAI,UAAU,KAAK,SAAS;AAC1B,gBAAM,MAAM,MAAM,KAAK,OAAO;AAC9B;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAEA,UAAM,aAAa,IAAI,MAAM,yBAAyB;AAAA,EACxD;AACF;AAEA,SAAS,MAAM,IAAY;AACzB,SAAO,IAAI,QAAQ,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAC7C;;;AChGO,IAAM,gBAAN,MAAoB;AAAA,EACzB,YAAoB,MAAkB;AAAlB;AAAA,EAAmB;AAAA;AAAA,EAGvC,WAAmB;AACjB,WAAO,GAAG,KAAK,KAAK,WAAW,CAAC,yBAAyB,KAAK,KAAK,UAAU,CAAC;AAAA,EAChF;AAAA;AAAA,EAGA,QAAQ,GAAW,GAAW,GAAW,SAAwB,OAAe;AAC9E,WAAO,GAAG,KAAK,KAAK,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,QAAQ,KAAK,KAAK,UAAU,CAAC;AAAA,EAC9F;AAAA;AAAA,EAGA,MAAM,SAAsC;AAC1C,WAAO,KAAK,KAAK,QAA4B,eAAe;AAAA,EAC9D;AACF;;;ACjBO,IAAM,gBAAN,MAAoB;AAAA,EACzB,YAAoB,MAAkB;AAAlB;AAAA,EAAmB;AAAA;AAAA,EAGvC,MAAM,KAAK,SAAgD;AACzD,UAAM,EAAE,QAAQ,GAAG,OAAO,IAAI,WAAW,CAAC;AAC1C,WAAO,KAAK,KAAK;AAAA,MACf;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,IAAI,QAAgB,QAA2C;AACnE,WAAO,KAAK,KAAK;AAAA,MACf,UAAU,mBAAmB,MAAM,CAAC;AAAA,MACpC;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;;;ACrBO,IAAM,mBAAN,MAAuB;AAAA,EAC5B,YAAoB,MAAkB;AAAlB;AAAA,EAAmB;AAAA;AAAA,EAGvC,MAAM,KAAK,SAAsD;AAC/D,UAAM,EAAE,QAAQ,GAAG,OAAO,IAAI,WAAW,CAAC;AAC1C,WAAO,KAAK,KAAK;AAAA,MACf;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;;;ACZO,IAAM,mBAAN,MAAuB;AAAA,EAC5B,YAAoB,MAAkB;AAAlB;AAAA,EAAmB;AAAA;AAAA,EAGvC,MAAM,KAAK,SAAsD;AAC/D,WAAO,KAAK,KAAK;AAAA,MACf;AAAA,MACA;AAAA,QACE,MAAM,QAAQ,KAAK,KAAK,GAAG;AAAA,QAC3B,OAAO,QAAQ;AAAA,QACf,OAAO,QAAQ;AAAA,QACf,QAAQ,QAAQ;AAAA,MAClB;AAAA,MACA,QAAQ;AAAA,IACV;AAAA,EACF;AACF;;;AChBO,IAAM,gBAAN,MAAoB;AAAA,EACzB,YAAoB,MAAkB;AAAlB;AAAA,EAAmB;AAAA;AAAA,EAGvC,MAAM,OAAO,SAAmD;AAC9D,WAAO,KAAK,KAAK;AAAA,MACf;AAAA,MACA;AAAA,QACE,OAAO,QAAQ,MAAM,KAAK,GAAG;AAAA,QAC7B,QAAQ,QAAQ;AAAA,QAChB,OAAO,QAAQ;AAAA,QACf,OAAO,QAAQ;AAAA,MACjB;AAAA,MACA,QAAQ;AAAA,IACV;AAAA,EACF;AACF;;;ACFA,gBAAuB,SACrB,WACA,UACA,eACA,SACwC;AACxC,QAAM,WAAW,SAAS,YAAY;AACtC,QAAM,SAAS,SAAS;AACxB,MAAI,SAAS;AAGb,SAAO,MAAM;AACX,QAAI,QAAQ,QAAS;AAErB,UAAM,WAAW,MAAM,UAAU,QAAQ,MAAM;AAC/C,UAAM,QAAQ,SAAS,QAAQ;AAE/B,eAAW,QAAQ,OAAO;AACxB,YAAM;AAAA,IACR;AAEA,QAAI,MAAM,WAAW,EAAG;AAExB,cAAU,MAAM;AAChB,UAAM,QAAQ,cAAc,QAAQ;AACpC,QAAI,QAAQ,KAAK,UAAU,MAAO;AAAA,EACpC;AACF;;;ACAA,IAAM,cAAc,oBAAI,IAAY,CAAC,gBAAgB,YAAY,cAAc,CAAC;AA2BzE,SAAS,aAAa,MAA6B;AACxD,MAAI,OAAO,SAAS,YAAY,SAAS,MAAM;AAC7C,UAAM,IAAI,MAAM,6CAA6C;AAAA,EAC/D;AAEA,QAAM,MAAM;AAEZ,MAAI,OAAO,IAAI,OAAO,UAAU;AAC9B,UAAM,IAAI,MAAM,uCAAuC;AAAA,EACzD;AACA,MAAI,OAAO,IAAI,cAAc,UAAU;AACrC,UAAM,IAAI,MAAM,8CAA8C;AAAA,EAChE;AACA,MAAI,OAAO,IAAI,SAAS,YAAY,CAAC,YAAY,IAAI,IAAI,IAAI,GAAG;AAC9D,UAAM,IAAI,MAAM,0CAA0C,OAAO,IAAI,IAAI,CAAC,GAAG;AAAA,EAC/E;AACA,MAAI,OAAO,IAAI,SAAS,YAAY,IAAI,SAAS,MAAM;AACrD,UAAM,IAAI,MAAM,yCAAyC;AAAA,EAC3D;AAEA,SAAO;AACT;;;ACvEO,IAAM,OAAN,MAAW;AAAA;AAAA,EAEP;AAAA;AAAA,EAEA;AAAA;AAAA,EAEA;AAAA,EAED;AAAA,EACA;AAAA,EACA;AAAA,EAER,YAAY,gBAAqC;AAC/C,UAAM,SACJ,OAAO,mBAAmB,WACtB,EAAE,QAAQ,eAAe,IACzB;AAEN,SAAK,OAAO,IAAI,WAAW,OAAO,QAAQ,OAAO,SAAS,OAAO,OAAO;AACxE,SAAK,QAAQ,IAAI,cAAc,KAAK,IAAI;AACxC,SAAK,QAAQ,IAAI,cAAc,KAAK,IAAI;AACxC,SAAK,WAAW,IAAI,iBAAiB,KAAK,IAAI;AAC9C,SAAK,aAAa,IAAI,iBAAiB,KAAK,IAAI;AAChD,SAAK,UAAU,IAAI,cAAc,KAAK,IAAI;AAAA,EAC5C;AAAA;AAAA;AAAA,EAKA,MAAM,SAAS,SAAsD;AACnE,WAAO,KAAK,WAAW,KAAK,OAAO;AAAA,EACrC;AAAA;AAAA,EAGA,MAAM,MAAM,SAAmD;AAC7D,WAAO,KAAK,QAAQ,OAAO,OAAO;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,aACE,SAC+B;AAC/B,UAAM,WAAW,QAAQ,SAAS;AAClC,WAAO;AAAA,MACL,CAAC,QAAQ,WACP,KAAK,SAAS,EAAE,GAAG,SAAS,OAAO,UAAU,QAAQ,OAAO,CAAC;AAAA,MAC/D,CAAC,MAAM,EAAE;AAAA,MACT,CAAC,MAAM,EAAE,eAAe;AAAA,MACxB,EAAE,UAAU,QAAQ,QAAQ,OAAO;AAAA,IACrC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,UACE,SAC2B;AAC3B,UAAM,WAAW,SAAS,SAAS;AACnC,WAAO;AAAA,MACL,CAAC,QAAQ,WACP,KAAK,MAAM,KAAK,EAAE,GAAG,SAAS,OAAO,UAAU,QAAQ,OAAO,CAAC;AAAA,MACjE,CAAC,MAAM,EAAE;AAAA,MACT,CAAC,MAAM,EAAE;AAAA,MACT,EAAE,UAAU,QAAQ,SAAS,OAAO;AAAA,IACtC;AAAA,EACF;AAAA;AAAA;AAAA,EAKA,WAAmB;AACjB,WAAO,KAAK,MAAM,SAAS;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,mBAAkE;AAChE,UAAM,SAAS,KAAK,KAAK,UAAU;AACnC,WAAO,CAAC,QAAgB;AACtB,UAAI,IAAI,SAAS,aAAa,GAAG;AAC/B,eAAO,EAAE,KAAK,SAAS,EAAE,aAAa,OAAO,EAAE;AAAA,MACjD;AACA,aAAO;AAAA,IACT;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chrtco/sdk",
-  "version": "0.3.2",
+  "version": "0.4.1",
   "description": "Official TypeScript SDK for the CHRT nautical chart API",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -23,7 +23,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/chrt-co/enc-hub",
+    "url": "git+https://github.com/chrt-co/enc-hub.git",
     "directory": "packages/sdk"
   },
   "homepage": "https://chrt.co/docs/sdks",