geogridapi 0.0.0-stage → 0.1.0

package/dist/index.cjs

@@ -0,0 +1,540 @@
+"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, {
+  APIConnectionError: () => APIConnectionError,
+  APIError: () => APIError,
+  AuthenticationError: () => AuthenticationError,
+  ConflictError: () => ConflictError,
+  DEFAULT_BASE_URL: () => DEFAULT_BASE_URL,
+  DEFAULT_TOLERANCE_SECONDS: () => DEFAULT_TOLERANCE_SECONDS,
+  GeoGridAPI: () => GeoGridAPI,
+  GeoGridAPIError: () => GeoGridAPIError,
+  InsufficientCreditsError: () => InsufficientCreditsError,
+  InvalidRequestError: () => InvalidRequestError,
+  NotFoundError: () => NotFoundError,
+  RateLimitError: () => RateLimitError,
+  SIGNATURE_HEADER: () => SIGNATURE_HEADER,
+  UnprocessableEntityError: () => UnprocessableEntityError,
+  VERSION: () => VERSION,
+  WaitTimeoutError: () => WaitTimeoutError,
+  WebhookSignatureError: () => WebhookSignatureError,
+  constructEvent: () => constructEvent,
+  default: () => index_default,
+  verifyWebhookSignature: () => verifyWebhookSignature
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var GeoGridAPIError = class extends Error {
+  /** HTTP status, `null` when no response was received. */
+  status;
+  /** API error code (`invalid_body`, `insufficient_points`, `rate_limited`…). */
+  code;
+  /** Seconds to wait before retrying, from the `Retry-After` header. */
+  retryAfter;
+  /** Parsed error body, when there is one. */
+  body;
+  /** Set when the error happened after a grid was created (while waiting for it): read it later with `grids.get`. */
+  gridId;
+  /** Set when the error happened after a batch was created (while waiting for it): read it later with `batches.get`. */
+  batchId;
+  constructor(message, options = {}) {
+    super(message, options.cause === void 0 ? void 0 : { cause: options.cause });
+    this.name = new.target.name;
+    this.status = options.status ?? null;
+    this.code = options.code ?? "unknown_error";
+    this.retryAfter = options.retryAfter ?? null;
+    this.body = options.body;
+    if (options.gridId) this.gridId = options.gridId;
+    if (options.batchId) this.batchId = options.batchId;
+  }
+};
+var InvalidRequestError = class extends GeoGridAPIError {
+};
+var AuthenticationError = class extends GeoGridAPIError {
+};
+var InsufficientCreditsError = class extends GeoGridAPIError {
+};
+var NotFoundError = class extends GeoGridAPIError {
+};
+var ConflictError = class extends GeoGridAPIError {
+};
+var UnprocessableEntityError = class extends GeoGridAPIError {
+};
+var RateLimitError = class extends GeoGridAPIError {
+};
+var APIError = class extends GeoGridAPIError {
+};
+var APIConnectionError = class extends GeoGridAPIError {
+};
+var WaitTimeoutError = class extends GeoGridAPIError {
+};
+function errorFromResponse(status, body, retryAfter) {
+  const envelope = body?.error;
+  const code = typeof envelope?.code === "string" ? envelope.code : `http_${status}`;
+  const message = typeof envelope?.message === "string" ? envelope.message : `GeoGridAPI request failed with status ${status}`;
+  const options = { status, code, retryAfter, body };
+  if (status === 400) return new InvalidRequestError(message, options);
+  if (status === 401) return new AuthenticationError(message, options);
+  if (status === 402) return new InsufficientCreditsError(message, options);
+  if (status === 404) return new NotFoundError(message, options);
+  if (status === 409) return new ConflictError(message, options);
+  if (status === 422) return new UnprocessableEntityError(message, options);
+  if (status === 429) return new RateLimitError(message, options);
+  if (status >= 500) return new APIError(message, options);
+  return new GeoGridAPIError(message, options);
+}
+function isTransient(error) {
+  return error.status === null || error.status === 408 || error.status === 429 || error.status >= 500;
+}
+
+// src/version.ts
+var VERSION = "0.1.0";
+
+// src/core.ts
+var DEFAULT_BASE_URL = "https://api.geogridapi.io";
+var DEFAULT_TIMEOUT_MS = 6e4;
+var DEFAULT_MAX_RETRIES = 2;
+var MAX_RETRY_DELAY_MS = 6e4;
+function readEnv(name) {
+  const env = globalThis.process?.env;
+  return env?.[name]?.trim() || void 0;
+}
+function sleep(ms, signal) {
+  return new Promise((resolve, reject) => {
+    if (signal?.aborted) return reject(signal.reason);
+    const timer = setTimeout(() => {
+      signal?.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    const onAbort = () => {
+      clearTimeout(timer);
+      reject(signal?.reason);
+    };
+    signal?.addEventListener("abort", onAbort, { once: true });
+  });
+}
+function parseRetryAfter(value) {
+  if (!value) return null;
+  const seconds = Number(value);
+  if (Number.isFinite(seconds) && seconds >= 0) return seconds;
+  const date = Date.parse(value);
+  return Number.isNaN(date) ? null : Math.max(0, (date - Date.now()) / 1e3);
+}
+function retryDelayMs(attempt, retryAfter) {
+  if (retryAfter !== null) return Math.min(retryAfter * 1e3, MAX_RETRY_DELAY_MS);
+  const base = Math.min(500 * 2 ** attempt, 8e3);
+  return base / 2 + Math.random() * (base / 2);
+}
+function combineSignals(timeoutMs, signal) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(new DOMException("Request timed out", "TimeoutError")), timeoutMs);
+  const onAbort = () => controller.abort(signal?.reason);
+  if (signal?.aborted) controller.abort(signal.reason);
+  else signal?.addEventListener("abort", onAbort, { once: true });
+  return {
+    signal: controller.signal,
+    cleanup: () => {
+      clearTimeout(timer);
+      signal?.removeEventListener("abort", onAbort);
+    }
+  };
+}
+async function readBody(response) {
+  const text = await response.text();
+  if (!text) return null;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+var Transport = class {
+  // Native private field: the key never shows in console.log, util.inspect or JSON.stringify.
+  #apiKey;
+  baseURL;
+  timeoutMs;
+  maxRetries;
+  fetchImpl;
+  constructor(options = {}) {
+    const apiKey = options.apiKey?.trim() || readEnv("GEOGRIDAPI_API_KEY");
+    if (!apiKey) {
+      throw new GeoGridAPIError(
+        "Missing GeoGridAPI API key: pass { apiKey } or set GEOGRIDAPI_API_KEY. Create one at https://geogridapi.io/en/console.",
+        { code: "missing_api_key" }
+      );
+    }
+    const fetchImpl = options.fetch ?? globalThis.fetch;
+    if (typeof fetchImpl !== "function") {
+      throw new GeoGridAPIError("No fetch implementation found: use Node.js 20+ or pass { fetch }.", { code: "missing_fetch" });
+    }
+    this.#apiKey = apiKey;
+    this.baseURL = (options.baseURL ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+    this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+    this.fetchImpl = fetchImpl;
+  }
+  /** Whether the key is a test key (free mock grids). */
+  get isTestKey() {
+    return this.#apiKey.startsWith("gga_test_");
+  }
+  buildURL(path, query) {
+    const url = new URL(`${this.baseURL}${path}`);
+    for (const [name, value] of Object.entries(query ?? {})) {
+      if (value !== void 0) url.searchParams.set(name, String(value));
+    }
+    return url.toString();
+  }
+  headers(spec) {
+    const headers = {
+      Authorization: `Bearer ${this.#apiKey}`,
+      Accept: spec.binary ? "image/png" : "application/json",
+      "User-Agent": `geogridapi-node/${VERSION}`
+    };
+    if (spec.body !== void 0) headers["Content-Type"] = "application/json";
+    if (spec.idempotencyKey) headers["Idempotency-Key"] = spec.idempotencyKey;
+    return headers;
+  }
+  async request(spec, options = {}) {
+    const maxRetries = options.maxRetries ?? this.maxRetries;
+    const url = this.buildURL(spec.path, spec.query);
+    const init = {
+      method: spec.method,
+      headers: this.headers(spec),
+      ...spec.body !== void 0 ? { body: JSON.stringify(spec.body) } : {}
+    };
+    for (let attempt = 0; ; attempt++) {
+      if (options.signal?.aborted) throw options.signal.reason;
+      const outcome = await this.attempt(url, init, spec, options);
+      if (outcome.ok) return outcome.value;
+      const { error } = outcome;
+      const transient = error.status === 429 || spec.retryable && isTransient(error);
+      if (!transient || attempt >= maxRetries) throw error;
+      await sleep(retryDelayMs(attempt, error.retryAfter), options.signal);
+    }
+  }
+  /** One HTTP exchange. A caller abort is rethrown as is; everything else becomes a GeoGridAPIError. */
+  async attempt(url, init, spec, options) {
+    const { signal, cleanup } = combineSignals(options.timeoutMs ?? this.timeoutMs, options.signal);
+    try {
+      const response = await this.fetchImpl(url, { ...init, signal });
+      if (response.ok) {
+        const value = spec.binary ? new Uint8Array(await response.arrayBuffer()) : await readBody(response);
+        return { ok: true, value };
+      }
+      const body = await readBody(response);
+      return { ok: false, error: errorFromResponse(response.status, body, parseRetryAfter(response.headers.get("retry-after"))) };
+    } catch (cause) {
+      if (options.signal?.aborted) throw options.signal.reason;
+      const timedOut = signal.aborted;
+      const message = timedOut ? "GeoGridAPI request timed out." : "Could not reach GeoGridAPI.";
+      return { ok: false, error: new APIConnectionError(message, { code: timedOut ? "timeout" : "connection_error", cause }) };
+    } finally {
+      cleanup();
+    }
+  }
+};
+
+// src/resources.ts
+var GRID_WAIT = { pollIntervalMs: 3e3, timeoutMs: 3e5 };
+var BATCH_WAIT = { pollIntervalMs: 5e3, timeoutMs: 9e5 };
+var MAX_POLL_INTERVAL_MS = 1e4;
+var POLL_BACKOFF = 1.5;
+var newIdempotencyKey = () => `gga-node-${crypto.randomUUID()}`;
+var segment = (id) => encodeURIComponent(id);
+function nextInterval(current) {
+  return Math.min(current * POLL_BACKOFF, Math.max(MAX_POLL_INTERVAL_MS, current));
+}
+var withJitter = (ms) => ms * (0.9 + Math.random() * 0.2);
+async function pollUntil(id, read, isDone, describe, defaults, options) {
+  let interval = options.pollIntervalMs ?? defaults.pollIntervalMs;
+  const deadline = Date.now() + (options.timeoutMs ?? defaults.timeoutMs);
+  let last = null;
+  for (; ; ) {
+    let delay = interval;
+    try {
+      last = await read();
+      if (isDone(last)) return last;
+    } catch (error) {
+      if (!(error instanceof GeoGridAPIError)) throw error;
+      if (!isTransient(error)) throw Object.assign(error, id);
+      if (error.retryAfter !== null) delay = Math.max(delay, error.retryAfter * 1e3);
+    }
+    if (Date.now() + delay > deadline) {
+      throw new WaitTimeoutError(`${describe(last)} Read it again later or use a webhook_url.`, { code: "wait_timeout", ...id });
+    }
+    await sleep(withJitter(delay), options.signal);
+    interval = nextInterval(interval);
+  }
+}
+var gridDone = (grid) => grid.status === "completed" || grid.status === "failed";
+var Places = class {
+  constructor(transport) {
+    this.transport = transport;
+  }
+  transport;
+  /** Finds a Google Business Profile by name and city, with its `place_id`. Free (a live key needs a positive balance). */
+  search(params, options) {
+    const query = typeof params === "string" ? { q: params } : params;
+    return this.transport.request({ method: "GET", path: "/v1/places/search", query, retryable: true }, options);
+  }
+};
+var Grids = class {
+  constructor(transport) {
+    this.transport = transport;
+  }
+  transport;
+  /**
+   * Starts a grid (status `pending`); it completes in 20 seconds to 2 minutes.
+   * Costs 1 credit per point, refunded if the grid fails. Use `run` to wait for the result.
+   * Retries inside this call reuse one idempotency key; pass your own `idempotencyKey` to make your own retries safe too.
+   */
+  create(params, options = {}) {
+    const { idempotencyKey = newIdempotencyKey(), ...rest } = options;
+    return this.transport.request({ method: "POST", path: "/v1/grids", body: params, idempotencyKey, retryable: true }, rest);
+  }
+  /** Exact number of points and credits a grid would cost. Free, nothing is reserved. */
+  estimate(params, options) {
+    return this.transport.request({ method: "POST", path: "/v1/grids/estimate", body: params, retryable: true }, options);
+  }
+  /** Status and result of a grid: ranks, summary, competitors ahead and change since the previous grid. */
+  get(id, options) {
+    return this.transport.request({ method: "GET", path: `/v1/grids/${segment(id)}`, retryable: true }, options);
+  }
+  /** One page of grids, newest first, without point details. */
+  list(params = {}, options) {
+    return this.transport.request({ method: "GET", path: "/v1/grids", query: { ...params }, retryable: true }, options);
+  }
+  /** Every grid, newest first, reading the pages as you iterate. */
+  async *listAll(params = {}, options) {
+    let before;
+    for (; ; ) {
+      const page = await this.list({ ...params, before }, options);
+      yield* page.data;
+      if (!page.has_more || !page.next_before) return;
+      before = page.next_before;
+    }
+  }
+  /** PNG heatmap (1200 × 1092) of a completed grid. Free. */
+  image(id, params = {}, options) {
+    return this.transport.request(
+      { method: "GET", path: `/v1/grids/${segment(id)}/image`, query: { ...params }, retryable: true, binary: true },
+      options
+    );
+  }
+  /** Reads the grid until it is `completed` or `failed`. */
+  wait(id, options = {}) {
+    return pollUntil(
+      { gridId: id },
+      () => this.get(id, { signal: options.signal, maxRetries: 0 }),
+      gridDone,
+      (grid) => `Grid ${id} is still ${grid?.status ?? "running"}.`,
+      GRID_WAIT,
+      options
+    );
+  }
+  /** Starts a grid and waits for its result (`completed` or `failed`; a failed grid is refunded). */
+  async run(params, options = {}) {
+    const { wait = {}, ...requestOptions } = options;
+    const grid = await this.create(params, requestOptions);
+    return gridDone(grid) ? grid : this.wait(grid.id, { signal: requestOptions.signal, ...wait });
+  }
+};
+var Batches = class {
+  constructor(transport) {
+    this.transport = transport;
+  }
+  transport;
+  /**
+   * Up to 50 grids with the same format: one listing with several keywords, or several listings with one keyword.
+   * Each grid is charged when it starts and refunded if it fails.
+   */
+  create(params, options = {}) {
+    const { idempotencyKey = newIdempotencyKey(), ...rest } = options;
+    return this.transport.request({ method: "POST", path: "/v1/batches", body: params, idempotencyKey, retryable: true }, rest);
+  }
+  /** A batch and the status of each of its grids. */
+  get(id, options) {
+    return this.transport.request({ method: "GET", path: `/v1/batches/${segment(id)}`, retryable: true }, options);
+  }
+  /** Reads the batch until every grid is finished. */
+  wait(id, options = {}) {
+    return pollUntil(
+      { batchId: id },
+      () => this.get(id, { signal: options.signal, maxRetries: 0 }),
+      (batch) => batch.status === "completed",
+      (batch) => batch ? `Batch ${id} is still running (${batch.counts.completed + batch.counts.failed}/${batch.items_count} grids finished).` : `Batch ${id} is still running.`,
+      BATCH_WAIT,
+      options
+    );
+  }
+  /** Starts a batch and waits until every grid is finished. */
+  async run(params, options = {}) {
+    const { wait = {}, ...requestOptions } = options;
+    const batch = await this.create(params, requestOptions);
+    return batch.status === "completed" ? batch : this.wait(batch.id, { signal: requestOptions.signal, ...wait });
+  }
+};
+var HistoryResource = class {
+  constructor(transport) {
+    this.transport = transport;
+  }
+  transport;
+  /** Every completed grid of the same map, oldest first, and the change between the first and the last. Free. */
+  get(params, options) {
+    return this.transport.request({ method: "GET", path: "/v1/history", query: { ...params }, retryable: true }, options);
+  }
+};
+var Schedules = class {
+  constructor(transport) {
+    this.transport = transport;
+  }
+  transport;
+  /** Repeats a completed grid every week or every month. Each run costs the grid's credits. */
+  create(params, options) {
+    return this.transport.request({ method: "POST", path: "/v1/schedules", body: params, retryable: false }, options);
+  }
+  list(options) {
+    return this.transport.request({ method: "GET", path: "/v1/schedules", retryable: true }, options);
+  }
+  /** Pauses (`paused`) or resumes (`active`) a schedule. */
+  update(id, params, options) {
+    return this.transport.request({ method: "PATCH", path: `/v1/schedules/${segment(id)}`, body: params, retryable: true }, options);
+  }
+  /** Stops repeating a grid for good. Grids already run are kept. Not retried: a lost response would turn into a 404. */
+  delete(id, options) {
+    return this.transport.request({ method: "DELETE", path: `/v1/schedules/${segment(id)}`, retryable: false }, options);
+  }
+};
+var BalanceResource = class {
+  constructor(transport) {
+    this.transport = transport;
+  }
+  transport;
+  /** Credits left on the account (1 credit = 1 grid point). */
+  get(options) {
+    return this.transport.request({ method: "GET", path: "/v1/balance", retryable: true }, options);
+  }
+};
+
+// src/webhooks.ts
+var SIGNATURE_HEADER = "GeoGridAPI-Signature";
+var DEFAULT_TOLERANCE_SECONDS = 300;
+var WebhookSignatureError = class extends GeoGridAPIError {
+};
+var encoder = new TextEncoder();
+function parseHeader(header) {
+  let timestamp = Number.NaN;
+  const signatures = [];
+  for (const part of header.split(",")) {
+    const separator = part.indexOf("=");
+    if (separator === -1) continue;
+    const key = part.slice(0, separator).trim();
+    const value = part.slice(separator + 1).trim();
+    if (key === "t") timestamp = Number(value);
+    if (key === "v1") signatures.push(value);
+  }
+  return { timestamp, signatures };
+}
+async function hmacHex(secret, message) {
+  const key = await crypto.subtle.importKey("raw", encoder.encode(secret), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
+  const signature = new Uint8Array(await crypto.subtle.sign("HMAC", key, message));
+  return Array.from(signature, (byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+function constantTimeEqual(a, b) {
+  if (a.length !== b.length) return false;
+  let diff = 0;
+  for (let i = 0; i < a.length; i++) diff |= a.charCodeAt(i) ^ b.charCodeAt(i);
+  return diff === 0;
+}
+function toBytes(payload) {
+  return typeof payload === "string" ? encoder.encode(payload) : payload;
+}
+async function verifyWebhookSignature(payload, header, secret, options = {}) {
+  if (!header || !secret) return false;
+  const { timestamp, signatures } = parseHeader(header);
+  if (!Number.isFinite(timestamp) || timestamp <= 0 || signatures.length === 0) return false;
+  const now = options.now ?? Math.floor(Date.now() / 1e3);
+  if (Math.abs(now - timestamp) > (options.toleranceSeconds ?? DEFAULT_TOLERANCE_SECONDS)) return false;
+  const prefix = encoder.encode(`${timestamp}.`);
+  const body = toBytes(payload);
+  const message = new Uint8Array(prefix.length + body.length);
+  message.set(prefix, 0);
+  message.set(body, prefix.length);
+  const expected = await hmacHex(secret, message);
+  return signatures.some((signature) => constantTimeEqual(expected, signature.toLowerCase()));
+}
+async function constructEvent(payload, header, secret, options = {}) {
+  if (!await verifyWebhookSignature(payload, header, secret, options)) {
+    throw new WebhookSignatureError("Invalid or expired GeoGridAPI webhook signature.", { code: "invalid_signature" });
+  }
+  const text = typeof payload === "string" ? payload : new TextDecoder().decode(payload);
+  return JSON.parse(text);
+}
+
+// src/index.ts
+var GeoGridAPI = class {
+  places;
+  grids;
+  batches;
+  history;
+  schedules;
+  balance;
+  transport;
+  constructor(options = {}) {
+    this.transport = new Transport(options);
+    this.places = new Places(this.transport);
+    this.grids = new Grids(this.transport);
+    this.batches = new Batches(this.transport);
+    this.history = new HistoryResource(this.transport);
+    this.schedules = new Schedules(this.transport);
+    this.balance = new BalanceResource(this.transport);
+  }
+  /** Whether the client uses a test key (`gga_test_`: free mock grids). */
+  get isTestKey() {
+    return this.transport.isTestKey;
+  }
+};
+var index_default = GeoGridAPI;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  APIConnectionError,
+  APIError,
+  AuthenticationError,
+  ConflictError,
+  DEFAULT_BASE_URL,
+  DEFAULT_TOLERANCE_SECONDS,
+  GeoGridAPI,
+  GeoGridAPIError,
+  InsufficientCreditsError,
+  InvalidRequestError,
+  NotFoundError,
+  RateLimitError,
+  SIGNATURE_HEADER,
+  UnprocessableEntityError,
+  VERSION,
+  WaitTimeoutError,
+  WebhookSignatureError,
+  constructEvent,
+  verifyWebhookSignature
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/version.ts","../src/core.ts","../src/resources.ts","../src/webhooks.ts"],"sourcesContent":["import { Transport, type ClientOptions } from \"./core.js\";\nimport { BalanceResource, Batches, Grids, HistoryResource, Places, Schedules } from \"./resources.js\";\n\n/**\n * GeoGridAPI client.\n *\n * ```ts\n * import { GeoGridAPI } from \"geogridapi\";\n * const gga = new GeoGridAPI(); // reads GEOGRIDAPI_API_KEY\n * const grid = await gga.grids.run({ query: \"Joe's Pizza, New York\", keyword: \"pizza\", size: 7 });\n * console.log(grid.summary?.average_rank, grid.ranks);\n * ```\n */\nexport class GeoGridAPI {\n  readonly places: Places;\n  readonly grids: Grids;\n  readonly batches: Batches;\n  readonly history: HistoryResource;\n  readonly schedules: Schedules;\n  readonly balance: BalanceResource;\n  private readonly transport: Transport;\n\n  constructor(options: ClientOptions = {}) {\n    this.transport = new Transport(options);\n    this.places = new Places(this.transport);\n    this.grids = new Grids(this.transport);\n    this.batches = new Batches(this.transport);\n    this.history = new HistoryResource(this.transport);\n    this.schedules = new Schedules(this.transport);\n    this.balance = new BalanceResource(this.transport);\n  }\n\n  /** Whether the client uses a test key (`gga_test_`: free mock grids). */\n  get isTestKey(): boolean {\n    return this.transport.isTestKey;\n  }\n}\n\nexport default GeoGridAPI;\n\nexport { DEFAULT_BASE_URL, type ClientOptions, type IdempotentRequestOptions, type RequestOptions } from \"./core.js\";\nexport type { RunOptions, WaitOptions } from \"./resources.js\";\nexport {\n  APIConnectionError,\n  APIError,\n  AuthenticationError,\n  ConflictError,\n  GeoGridAPIError,\n  InsufficientCreditsError,\n  InvalidRequestError,\n  NotFoundError,\n  RateLimitError,\n  UnprocessableEntityError,\n  WaitTimeoutError,\n  type GeoGridAPIErrorOptions,\n} from \"./errors.js\";\nexport {\n  DEFAULT_TOLERANCE_SECONDS,\n  SIGNATURE_HEADER,\n  WebhookSignatureError,\n  constructEvent,\n  verifyWebhookSignature,\n  type VerifyOptions,\n} from \"./webhooks.js\";\nexport { VERSION } from \"./version.js\";\nexport type * from \"./types.js\";\n","// Errors thrown by the client. Every API error carries the `code` and\n// `message` of the `{ error: { code, message } }` envelope.\n\nexport interface GeoGridAPIErrorOptions {\n  status?: number | null;\n  code?: string;\n  retryAfter?: number | null;\n  body?: unknown;\n  cause?: unknown;\n  gridId?: string;\n  batchId?: string;\n}\n\nexport class GeoGridAPIError extends Error {\n  /** HTTP status, `null` when no response was received. */\n  readonly status: number | null;\n  /** API error code (`invalid_body`, `insufficient_points`, `rate_limited`…). */\n  readonly code: string;\n  /** Seconds to wait before retrying, from the `Retry-After` header. */\n  readonly retryAfter: number | null;\n  /** Parsed error body, when there is one. */\n  readonly body: unknown;\n  /** Set when the error happened after a grid was created (while waiting for it): read it later with `grids.get`. */\n  gridId?: string;\n  /** Set when the error happened after a batch was created (while waiting for it): read it later with `batches.get`. */\n  batchId?: string;\n\n  constructor(message: string, options: GeoGridAPIErrorOptions = {}) {\n    super(message, options.cause === undefined ? undefined : { cause: options.cause });\n    this.name = new.target.name;\n    this.status = options.status ?? null;\n    this.code = options.code ?? \"unknown_error\";\n    this.retryAfter = options.retryAfter ?? null;\n    this.body = options.body;\n    if (options.gridId) this.gridId = options.gridId;\n    if (options.batchId) this.batchId = options.batchId;\n  }\n}\n\n/** 400: invalid body or parameters. */\nexport class InvalidRequestError extends GeoGridAPIError {}\n/** 401: missing, malformed, unknown or revoked API key. */\nexport class AuthenticationError extends GeoGridAPIError {}\n/** 402: not enough credits for this grid or batch. */\nexport class InsufficientCreditsError extends GeoGridAPIError {}\n/** 404: unknown grid, batch or schedule, or no listing matches. */\nexport class NotFoundError extends GeoGridAPIError {}\n/** 409: conflicting state (grid not ready, already scheduled, idempotency key reused…). */\nexport class ConflictError extends GeoGridAPIError {}\n/** 422: an account limit is reached (`schedule_limit`). */\nexport class UnprocessableEntityError extends GeoGridAPIError {}\n/** 429: too many requests or too many grids still running. */\nexport class RateLimitError extends GeoGridAPIError {}\n/** 5xx: the API or the ranking engine is temporarily unavailable. */\nexport class APIError extends GeoGridAPIError {}\n/** No response: network failure or request timeout. */\nexport class APIConnectionError extends GeoGridAPIError {}\n/** A grid or batch did not finish within the wait timeout. It keeps running server side. */\nexport class WaitTimeoutError extends GeoGridAPIError {}\n\nexport function errorFromResponse(status: number, body: unknown, retryAfter: number | null): GeoGridAPIError {\n  const envelope = (body as { error?: { code?: unknown; message?: unknown } } | null)?.error;\n  const code = typeof envelope?.code === \"string\" ? envelope.code : `http_${status}`;\n  const message = typeof envelope?.message === \"string\" ? envelope.message : `GeoGridAPI request failed with status ${status}`;\n  const options = { status, code, retryAfter, body };\n  if (status === 400) return new InvalidRequestError(message, options);\n  if (status === 401) return new AuthenticationError(message, options);\n  if (status === 402) return new InsufficientCreditsError(message, options);\n  if (status === 404) return new NotFoundError(message, options);\n  if (status === 409) return new ConflictError(message, options);\n  if (status === 422) return new UnprocessableEntityError(message, options);\n  if (status === 429) return new RateLimitError(message, options);\n  if (status >= 500) return new APIError(message, options);\n  return new GeoGridAPIError(message, options);\n}\n\n/** Errors worth waiting out: no response, timeout, 429 or 5xx. */\nexport function isTransient(error: GeoGridAPIError): boolean {\n  return error.status === null || error.status === 408 || error.status === 429 || error.status >= 500;\n}\n","export const VERSION = \"0.1.0\";\n","// HTTP transport: auth, timeouts, retries and error mapping.\n\nimport { APIConnectionError, GeoGridAPIError, errorFromResponse, isTransient } from \"./errors.js\";\nimport { VERSION } from \"./version.js\";\n\nexport const DEFAULT_BASE_URL = \"https://api.geogridapi.io\";\nexport const DEFAULT_TIMEOUT_MS = 60_000;\nexport const DEFAULT_MAX_RETRIES = 2;\nconst MAX_RETRY_DELAY_MS = 60_000;\n\nexport interface ClientOptions {\n  /** API key (`gga_live_…` or `gga_test_…`). Defaults to `process.env.GEOGRIDAPI_API_KEY`. */\n  apiKey?: string;\n  /** Defaults to `https://api.geogridapi.io`. */\n  baseURL?: string;\n  /** Timeout of each HTTP request, in milliseconds (default 60 000). */\n  timeoutMs?: number;\n  /** Retries on network errors, 429 and 5xx (default 2). Grid and batch creations are retried with the same idempotency key. */\n  maxRetries?: number;\n  /** Custom fetch implementation. Defaults to the global `fetch`. */\n  fetch?: typeof fetch;\n}\n\nexport interface RequestOptions {\n  signal?: AbortSignal;\n  timeoutMs?: number;\n  maxRetries?: number;\n}\n\nexport interface IdempotentRequestOptions extends RequestOptions {\n  /** Same key = same grid or batch, never charged twice. Generated when omitted. */\n  idempotencyKey?: string;\n}\n\nexport type QueryValue = string | number | boolean | undefined;\n\nexport interface RequestSpec {\n  method: \"GET\" | \"POST\" | \"PATCH\" | \"DELETE\";\n  path: string;\n  query?: Record<string, QueryValue>;\n  body?: unknown;\n  idempotencyKey?: string;\n  /** Safe to send again after a network error or a 5xx. */\n  retryable: boolean;\n  binary?: boolean;\n}\n\nfunction readEnv(name: string): string | undefined {\n  const env = (globalThis as { process?: { env?: Record<string, string | undefined> } }).process?.env;\n  return env?.[name]?.trim() || undefined;\n}\n\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) return reject(signal.reason);\n    const timer = setTimeout(() => {\n      signal?.removeEventListener(\"abort\", onAbort);\n      resolve();\n    }, ms);\n    const onAbort = () => {\n      clearTimeout(timer);\n      reject(signal?.reason);\n    };\n    signal?.addEventListener(\"abort\", onAbort, { once: true });\n  });\n}\n\nfunction parseRetryAfter(value: string | null): number | null {\n  if (!value) return null;\n  const seconds = Number(value);\n  if (Number.isFinite(seconds) && seconds >= 0) return seconds;\n  const date = Date.parse(value);\n  return Number.isNaN(date) ? null : Math.max(0, (date - Date.now()) / 1000);\n}\n\nfunction retryDelayMs(attempt: number, retryAfter: number | null): number {\n  if (retryAfter !== null) return Math.min(retryAfter * 1000, MAX_RETRY_DELAY_MS);\n  const base = Math.min(500 * 2 ** attempt, 8_000);\n  return base / 2 + Math.random() * (base / 2);\n}\n\nfunction combineSignals(timeoutMs: number, signal?: AbortSignal): { signal: AbortSignal; cleanup: () => void } {\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(new DOMException(\"Request timed out\", \"TimeoutError\")), timeoutMs);\n  const onAbort = () => controller.abort(signal?.reason);\n  if (signal?.aborted) controller.abort(signal.reason);\n  else signal?.addEventListener(\"abort\", onAbort, { once: true });\n  return {\n    signal: controller.signal,\n    cleanup: () => {\n      clearTimeout(timer);\n      signal?.removeEventListener(\"abort\", onAbort);\n    },\n  };\n}\n\nasync function readBody(response: Response): Promise<unknown> {\n  const text = await response.text();\n  if (!text) return null;\n  try {\n    return JSON.parse(text);\n  } catch {\n    return text;\n  }\n}\n\nexport class Transport {\n  // Native private field: the key never shows in console.log, util.inspect or JSON.stringify.\n  readonly #apiKey: string;\n  private readonly baseURL: string;\n  private readonly timeoutMs: number;\n  private readonly maxRetries: number;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(options: ClientOptions = {}) {\n    const apiKey = options.apiKey?.trim() || readEnv(\"GEOGRIDAPI_API_KEY\");\n    if (!apiKey) {\n      throw new GeoGridAPIError(\n        \"Missing GeoGridAPI API key: pass { apiKey } or set GEOGRIDAPI_API_KEY. Create one at https://geogridapi.io/en/console.\",\n        { code: \"missing_api_key\" },\n      );\n    }\n    const fetchImpl = options.fetch ?? globalThis.fetch;\n    if (typeof fetchImpl !== \"function\") {\n      throw new GeoGridAPIError(\"No fetch implementation found: use Node.js 20+ or pass { fetch }.\", { code: \"missing_fetch\" });\n    }\n    this.#apiKey = apiKey;\n    this.baseURL = (options.baseURL ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n    this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;\n    this.fetchImpl = fetchImpl;\n  }\n\n  /** Whether the key is a test key (free mock grids). */\n  get isTestKey(): boolean {\n    return this.#apiKey.startsWith(\"gga_test_\");\n  }\n\n  private buildURL(path: string, query?: Record<string, QueryValue>): string {\n    const url = new URL(`${this.baseURL}${path}`);\n    for (const [name, value] of Object.entries(query ?? {})) {\n      if (value !== undefined) url.searchParams.set(name, String(value));\n    }\n    return url.toString();\n  }\n\n  private headers(spec: RequestSpec): Record<string, string> {\n    const headers: Record<string, string> = {\n      Authorization: `Bearer ${this.#apiKey}`,\n      Accept: spec.binary ? \"image/png\" : \"application/json\",\n      \"User-Agent\": `geogridapi-node/${VERSION}`,\n    };\n    if (spec.body !== undefined) headers[\"Content-Type\"] = \"application/json\";\n    if (spec.idempotencyKey) headers[\"Idempotency-Key\"] = spec.idempotencyKey;\n    return headers;\n  }\n\n  async request<T>(spec: RequestSpec, options: RequestOptions = {}): Promise<T> {\n    const maxRetries = options.maxRetries ?? this.maxRetries;\n    const url = this.buildURL(spec.path, spec.query);\n    const init: RequestInit = {\n      method: spec.method,\n      headers: this.headers(spec),\n      ...(spec.body !== undefined ? { body: JSON.stringify(spec.body) } : {}),\n    };\n\n    for (let attempt = 0; ; attempt++) {\n      if (options.signal?.aborted) throw options.signal.reason;\n      const outcome = await this.attempt<T>(url, init, spec, options);\n      if (outcome.ok) return outcome.value;\n      const { error } = outcome;\n      // A 429 is refused before any processing: always safe to send again.\n      const transient = error.status === 429 || (spec.retryable && isTransient(error));\n      if (!transient || attempt >= maxRetries) throw error;\n      await sleep(retryDelayMs(attempt, error.retryAfter), options.signal);\n    }\n  }\n\n  /** One HTTP exchange. A caller abort is rethrown as is; everything else becomes a GeoGridAPIError. */\n  private async attempt<T>(\n    url: string,\n    init: RequestInit,\n    spec: RequestSpec,\n    options: RequestOptions,\n  ): Promise<{ ok: true; value: T } | { ok: false; error: GeoGridAPIError }> {\n    const { signal, cleanup } = combineSignals(options.timeoutMs ?? this.timeoutMs, options.signal);\n    try {\n      const response = await this.fetchImpl(url, { ...init, signal });\n      if (response.ok) {\n        const value = spec.binary ? new Uint8Array(await response.arrayBuffer()) : await readBody(response);\n        return { ok: true, value: value as T };\n      }\n      const body = await readBody(response);\n      return { ok: false, error: errorFromResponse(response.status, body, parseRetryAfter(response.headers.get(\"retry-after\"))) };\n    } catch (cause) {\n      if (options.signal?.aborted) throw options.signal.reason;\n      const timedOut = signal.aborted;\n      const message = timedOut ? \"GeoGridAPI request timed out.\" : \"Could not reach GeoGridAPI.\";\n      return { ok: false, error: new APIConnectionError(message, { code: timedOut ? \"timeout\" : \"connection_error\", cause }) };\n    } finally {\n      cleanup();\n    }\n  }\n}\n","// API resources: places, grids, batches, history, schedules and balance.\n\nimport { sleep, type IdempotentRequestOptions, type RequestOptions, type Transport } from \"./core.js\";\nimport { GeoGridAPIError, WaitTimeoutError, isTransient } from \"./errors.js\";\nimport type {\n  Balance,\n  Batch,\n  CreateBatchParams,\n  CreateGridParams,\n  CreateScheduleParams,\n  Estimate,\n  Grid,\n  GridList,\n  History,\n  HistoryParams,\n  ListGridsParams,\n  PlaceList,\n  Schedule,\n  ScheduleList,\n} from \"./types.js\";\n\nexport interface WaitOptions {\n  /** First delay between two status reads, in milliseconds (grids: 3 000, batches: 5 000). It then grows up to 10 s. */\n  pollIntervalMs?: number;\n  /** Give up after this many milliseconds (grids: 300 000, batches: 900 000). The work keeps running server side. */\n  timeoutMs?: number;\n  signal?: AbortSignal;\n}\n\nexport type RunOptions = IdempotentRequestOptions & { wait?: WaitOptions };\n\nconst GRID_WAIT = { pollIntervalMs: 3_000, timeoutMs: 300_000 };\nconst BATCH_WAIT = { pollIntervalMs: 5_000, timeoutMs: 900_000 };\nconst MAX_POLL_INTERVAL_MS = 10_000;\nconst POLL_BACKOFF = 1.5;\n\nconst newIdempotencyKey = (): string => `gga-node-${crypto.randomUUID()}`;\nconst segment = (id: string): string => encodeURIComponent(id);\n\n/** Next polling delay: grows by half up to 10 s (keeps several waits under the 60 requests/minute of a key), ±10 % jitter. */\nfunction nextInterval(current: number): number {\n  return Math.min(current * POLL_BACKOFF, Math.max(MAX_POLL_INTERVAL_MS, current));\n}\nconst withJitter = (ms: number): number => ms * (0.9 + Math.random() * 0.2);\n\n/**\n * Reads `id` until `isDone`. Transient errors (network, 429, 5xx) are waited out until the deadline;\n * any error thrown carries the id (`gridId` or `batchId`) so the work can be read again later.\n */\nasync function pollUntil<T>(\n  id: { gridId: string } | { batchId: string },\n  read: () => Promise<T>,\n  isDone: (value: T) => boolean,\n  describe: (value: T | null) => string,\n  defaults: { pollIntervalMs: number; timeoutMs: number },\n  options: WaitOptions,\n): Promise<T> {\n  let interval = options.pollIntervalMs ?? defaults.pollIntervalMs;\n  const deadline = Date.now() + (options.timeoutMs ?? defaults.timeoutMs);\n  let last: T | null = null;\n  for (;;) {\n    let delay = interval;\n    try {\n      last = await read();\n      if (isDone(last)) return last;\n    } catch (error) {\n      if (!(error instanceof GeoGridAPIError)) throw error;\n      if (!isTransient(error)) throw Object.assign(error, id);\n      if (error.retryAfter !== null) delay = Math.max(delay, error.retryAfter * 1000);\n    }\n    if (Date.now() + delay > deadline) {\n      throw new WaitTimeoutError(`${describe(last)} Read it again later or use a webhook_url.`, { code: \"wait_timeout\", ...id });\n    }\n    await sleep(withJitter(delay), options.signal);\n    interval = nextInterval(interval);\n  }\n}\n\nconst gridDone = (grid: Grid): boolean => grid.status === \"completed\" || grid.status === \"failed\";\n\nexport class Places {\n  constructor(private readonly transport: Transport) {}\n\n  /** Finds a Google Business Profile by name and city, with its `place_id`. Free (a live key needs a positive balance). */\n  search(params: string | { q: string; language?: string }, options?: RequestOptions): Promise<PlaceList> {\n    const query = typeof params === \"string\" ? { q: params } : params;\n    return this.transport.request({ method: \"GET\", path: \"/v1/places/search\", query, retryable: true }, options);\n  }\n}\n\nexport class Grids {\n  constructor(private readonly transport: Transport) {}\n\n  /**\n   * Starts a grid (status `pending`); it completes in 20 seconds to 2 minutes.\n   * Costs 1 credit per point, refunded if the grid fails. Use `run` to wait for the result.\n   * Retries inside this call reuse one idempotency key; pass your own `idempotencyKey` to make your own retries safe too.\n   */\n  create(params: CreateGridParams, options: IdempotentRequestOptions = {}): Promise<Grid> {\n    const { idempotencyKey = newIdempotencyKey(), ...rest } = options;\n    return this.transport.request({ method: \"POST\", path: \"/v1/grids\", body: params, idempotencyKey, retryable: true }, rest);\n  }\n\n  /** Exact number of points and credits a grid would cost. Free, nothing is reserved. */\n  estimate(params: CreateGridParams, options?: RequestOptions): Promise<Estimate> {\n    return this.transport.request({ method: \"POST\", path: \"/v1/grids/estimate\", body: params, retryable: true }, options);\n  }\n\n  /** Status and result of a grid: ranks, summary, competitors ahead and change since the previous grid. */\n  get(id: string, options?: RequestOptions): Promise<Grid> {\n    return this.transport.request({ method: \"GET\", path: `/v1/grids/${segment(id)}`, retryable: true }, options);\n  }\n\n  /** One page of grids, newest first, without point details. */\n  list(params: ListGridsParams = {}, options?: RequestOptions): Promise<GridList> {\n    return this.transport.request({ method: \"GET\", path: \"/v1/grids\", query: { ...params }, retryable: true }, options);\n  }\n\n  /** Every grid, newest first, reading the pages as you iterate. */\n  async *listAll(params: Omit<ListGridsParams, \"before\"> = {}, options?: RequestOptions): AsyncGenerator<Grid> {\n    let before: string | undefined;\n    for (;;) {\n      const page = await this.list({ ...params, before }, options);\n      yield* page.data;\n      if (!page.has_more || !page.next_before) return;\n      before = page.next_before;\n    }\n  }\n\n  /** PNG heatmap (1200 × 1092) of a completed grid. Free. */\n  image(id: string, params: { lang?: \"en\" | \"fr\" } = {}, options?: RequestOptions): Promise<Uint8Array> {\n    return this.transport.request(\n      { method: \"GET\", path: `/v1/grids/${segment(id)}/image`, query: { ...params }, retryable: true, binary: true },\n      options,\n    );\n  }\n\n  /** Reads the grid until it is `completed` or `failed`. */\n  wait(id: string, options: WaitOptions = {}): Promise<Grid> {\n    return pollUntil(\n      { gridId: id },\n      () => this.get(id, { signal: options.signal, maxRetries: 0 }),\n      gridDone,\n      (grid) => `Grid ${id} is still ${grid?.status ?? \"running\"}.`,\n      GRID_WAIT,\n      options,\n    );\n  }\n\n  /** Starts a grid and waits for its result (`completed` or `failed`; a failed grid is refunded). */\n  async run(params: CreateGridParams, options: RunOptions = {}): Promise<Grid> {\n    const { wait = {}, ...requestOptions } = options;\n    const grid = await this.create(params, requestOptions);\n    return gridDone(grid) ? grid : this.wait(grid.id, { signal: requestOptions.signal, ...wait });\n  }\n}\n\nexport class Batches {\n  constructor(private readonly transport: Transport) {}\n\n  /**\n   * Up to 50 grids with the same format: one listing with several keywords, or several listings with one keyword.\n   * Each grid is charged when it starts and refunded if it fails.\n   */\n  create(params: CreateBatchParams, options: IdempotentRequestOptions = {}): Promise<Batch> {\n    const { idempotencyKey = newIdempotencyKey(), ...rest } = options;\n    return this.transport.request({ method: \"POST\", path: \"/v1/batches\", body: params, idempotencyKey, retryable: true }, rest);\n  }\n\n  /** A batch and the status of each of its grids. */\n  get(id: string, options?: RequestOptions): Promise<Batch> {\n    return this.transport.request({ method: \"GET\", path: `/v1/batches/${segment(id)}`, retryable: true }, options);\n  }\n\n  /** Reads the batch until every grid is finished. */\n  wait(id: string, options: WaitOptions = {}): Promise<Batch> {\n    return pollUntil(\n      { batchId: id },\n      () => this.get(id, { signal: options.signal, maxRetries: 0 }),\n      (batch) => batch.status === \"completed\",\n      (batch) =>\n        batch\n          ? `Batch ${id} is still running (${batch.counts.completed + batch.counts.failed}/${batch.items_count} grids finished).`\n          : `Batch ${id} is still running.`,\n      BATCH_WAIT,\n      options,\n    );\n  }\n\n  /** Starts a batch and waits until every grid is finished. */\n  async run(params: CreateBatchParams, options: RunOptions = {}): Promise<Batch> {\n    const { wait = {}, ...requestOptions } = options;\n    const batch = await this.create(params, requestOptions);\n    return batch.status === \"completed\" ? batch : this.wait(batch.id, { signal: requestOptions.signal, ...wait });\n  }\n}\n\nexport class HistoryResource {\n  constructor(private readonly transport: Transport) {}\n\n  /** Every completed grid of the same map, oldest first, and the change between the first and the last. Free. */\n  get(params: HistoryParams, options?: RequestOptions): Promise<History> {\n    return this.transport.request({ method: \"GET\", path: \"/v1/history\", query: { ...params }, retryable: true }, options);\n  }\n}\n\nexport class Schedules {\n  constructor(private readonly transport: Transport) {}\n\n  /** Repeats a completed grid every week or every month. Each run costs the grid's credits. */\n  create(params: CreateScheduleParams, options?: RequestOptions): Promise<Schedule> {\n    return this.transport.request({ method: \"POST\", path: \"/v1/schedules\", body: params, retryable: false }, options);\n  }\n\n  list(options?: RequestOptions): Promise<ScheduleList> {\n    return this.transport.request({ method: \"GET\", path: \"/v1/schedules\", retryable: true }, options);\n  }\n\n  /** Pauses (`paused`) or resumes (`active`) a schedule. */\n  update(id: string, params: { status: \"active\" | \"paused\" }, options?: RequestOptions): Promise<Schedule> {\n    return this.transport.request({ method: \"PATCH\", path: `/v1/schedules/${segment(id)}`, body: params, retryable: true }, options);\n  }\n\n  /** Stops repeating a grid for good. Grids already run are kept. Not retried: a lost response would turn into a 404. */\n  delete(id: string, options?: RequestOptions): Promise<Record<string, unknown>> {\n    return this.transport.request({ method: \"DELETE\", path: `/v1/schedules/${segment(id)}`, retryable: false }, options);\n  }\n}\n\nexport class BalanceResource {\n  constructor(private readonly transport: Transport) {}\n\n  /** Credits left on the account (1 credit = 1 grid point). */\n  get(options?: RequestOptions): Promise<Balance> {\n    return this.transport.request({ method: \"GET\", path: \"/v1/balance\", retryable: true }, options);\n  }\n}\n","// Webhook signatures: header `GeoGridAPI-Signature: t=<unix seconds>,v1=<hex>`\n// where v1 = HMAC-SHA256(secret, `${t}.${raw body}`). Uses Web Crypto, so it\n// runs on Node 20+, Deno, Bun, Cloudflare Workers and edge runtimes.\n\nimport { GeoGridAPIError } from \"./errors.js\";\nimport type { WebhookEvent } from \"./types.js\";\n\nexport const SIGNATURE_HEADER = \"GeoGridAPI-Signature\";\nexport const DEFAULT_TOLERANCE_SECONDS = 300;\n\nexport interface VerifyOptions {\n  /** Maximum age of the signature, in seconds (default 300). */\n  toleranceSeconds?: number;\n  /** Current time in unix seconds, for tests. */\n  now?: number;\n}\n\n/** Thrown by `constructEvent` when the signature is missing, invalid or too old. */\nexport class WebhookSignatureError extends GeoGridAPIError {}\n\nconst encoder = new TextEncoder();\n\nfunction parseHeader(header: string): { timestamp: number; signatures: string[] } {\n  let timestamp = Number.NaN;\n  const signatures: string[] = [];\n  for (const part of header.split(\",\")) {\n    const separator = part.indexOf(\"=\");\n    if (separator === -1) continue;\n    const key = part.slice(0, separator).trim();\n    const value = part.slice(separator + 1).trim();\n    if (key === \"t\") timestamp = Number(value);\n    if (key === \"v1\") signatures.push(value);\n  }\n  return { timestamp, signatures };\n}\n\nasync function hmacHex(secret: string, message: Uint8Array<ArrayBuffer>): Promise<string> {\n  const key = await crypto.subtle.importKey(\"raw\", encoder.encode(secret), { name: \"HMAC\", hash: \"SHA-256\" }, false, [\"sign\"]);\n  const signature = new Uint8Array(await crypto.subtle.sign(\"HMAC\", key, message));\n  return Array.from(signature, (byte) => byte.toString(16).padStart(2, \"0\")).join(\"\");\n}\n\nfunction constantTimeEqual(a: string, b: string): boolean {\n  if (a.length !== b.length) return false;\n  let diff = 0;\n  for (let i = 0; i < a.length; i++) diff |= a.charCodeAt(i) ^ b.charCodeAt(i);\n  return diff === 0;\n}\n\nfunction toBytes(payload: string | Uint8Array): Uint8Array {\n  return typeof payload === \"string\" ? encoder.encode(payload) : payload;\n}\n\n/**\n * Checks the `GeoGridAPI-Signature` header of a webhook call.\n * `payload` must be the raw request body, exactly as received (not re-serialized JSON).\n */\nexport async function verifyWebhookSignature(\n  payload: string | Uint8Array,\n  header: string | null | undefined,\n  secret: string,\n  options: VerifyOptions = {},\n): Promise<boolean> {\n  if (!header || !secret) return false;\n  const { timestamp, signatures } = parseHeader(header);\n  if (!Number.isFinite(timestamp) || timestamp <= 0 || signatures.length === 0) return false;\n  const now = options.now ?? Math.floor(Date.now() / 1000);\n  if (Math.abs(now - timestamp) > (options.toleranceSeconds ?? DEFAULT_TOLERANCE_SECONDS)) return false;\n\n  const prefix = encoder.encode(`${timestamp}.`);\n  const body = toBytes(payload);\n  const message = new Uint8Array(prefix.length + body.length);\n  message.set(prefix, 0);\n  message.set(body, prefix.length);\n  const expected = await hmacHex(secret, message);\n  return signatures.some((signature) => constantTimeEqual(expected, signature.toLowerCase()));\n}\n\n/** Verifies the signature, then parses the event. Throws `WebhookSignatureError` when it does not match. */\nexport async function constructEvent(\n  payload: string | Uint8Array,\n  header: string | null | undefined,\n  secret: string,\n  options: VerifyOptions = {},\n): Promise<WebhookEvent> {\n  if (!(await verifyWebhookSignature(payload, header, secret, options))) {\n    throw new WebhookSignatureError(\"Invalid or expired GeoGridAPI webhook signature.\", { code: \"invalid_signature\" });\n  }\n  const text = typeof payload === \"string\" ? payload : new TextDecoder().decode(payload);\n  return JSON.parse(text) as WebhookEvent;\n}\n"],"mappings":"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","names":[]}