nonecap 0.2.0 → 0.4.0

package/README.md

@@ -20,7 +20,7 @@ Works on Node 18+, Bun, Deno, and edge runtimes. No dependencies.
 
 ## Quick start
 
-Grab an API key from [dashboard.nonecap.com](https://dashboard.nonecap.com), then:
+Grab an API key from [dashboard.nonecap.com](https://dashboard.nonecap.com/signup?utm_source=npm&utm_medium=sdk-readme), then:
 
 ```ts
 import { NoneCap } from "nonecap";
@@ -68,6 +68,57 @@ try {
 
 The error subclasses are `AuthenticationError` (401), `PermissionError` (403), `InsufficientCreditsError` (402), `ValidationError` (422/400, with a `param` naming the bad field), `NotFoundError` (404), `ConflictError` (409), `RateLimitError` (429), `APIError` (5xx), and `ConnectionError` (the request never landed). `SolveFailedError` carries the full `solve` so you can read `solve.error` and the timing fields.
 
+## Cancelling a solve
+
+`solve()` is the simple path when you just want a token. When you need to cancel while the solve is in flight — clean shutdown, freeing a worker slot, or stopping early — start it instead. `solves.start()` returns as soon as the submission is accepted, handing you a `SolveHandle` whose `id` is available right away.
+
+Wait for the result when you want the token:
+
+```ts
+const handle = await nc.solves.start({ type: "hcaptcha", sitekey, url });
+console.log(handle.id); // available immediately
+
+const solve = await handle.result({ timeout: 120_000 });
+console.log(solve.token);
+```
+
+Or hold onto the handle and cancel it from somewhere else — a shutdown hook, a request that was abandoned, a "stop" button:
+
+```ts
+const handle = await nc.solves.start({ type: "hcaptcha", sitekey, url });
+
+process.on("SIGTERM", () => {
+  handle.cancel().catch(() => {}); // free the worker slot on shutdown
+});
+
+// elsewhere, whoever needs the token still awaits it:
+const solve = await handle.result();
+```
+
+`handle.result()` long-polls until the solve finishes, throwing `SolveFailedError` or `TimeoutError` exactly like `solve()`. The **terminal** outcome is memoized: once the solve actually finishes, every later `result()` call returns that same result. A `TimeoutError` is not memoized — it just means that wait gave up, so you can call `result()` again (for example with a larger `timeout`) to resume polling. Concurrent `result()` calls share a single in-flight poll.
+
+`handle.cancel()` cancels a pending or in-flight solve. If the solve already finished, the API would answer 409; the handle swallows that and returns the solve's current state instead, since cancelling a finished solve is not something you need to handle. Cancelling settles the handle, so a concurrent or later `result()` stops polling and reflects the cancelled (terminal) state.
+
+Cancelled and abandoned solves are **never charged** — nothing is billed unless a solve actually succeeds, and unfinished solves simply expire uncharged at the server deadline. So cancel is for cleanup and early-stop, not cost protection.
+
+### Cleaning up after a `solve()` timeout
+
+`solve()` blocks until the solve settles, so it hands you no handle to cancel a solve while it's still running — for that, use `solves.start()` above. The one thing the `solve()` path offers is cleanup *after* a timeout: when `solve()` throws `TimeoutError`, the error usually carries the in-flight `solveId` (and last-known `solve`), so you can cancel the solve the wait gave up on. Guard on `solveId` being present — if the very first submission times out at the transport level, no id has been assigned yet, so `solveId` is `undefined`.
+
+```ts
+import { TimeoutError } from "nonecap";
+
+try {
+  await nc.solve({ type: "hcaptcha", sitekey, url });
+} catch (err) {
+  if (err instanceof TimeoutError && err.solveId) {
+    await nc.solves.cancel(err.solveId);
+  } else {
+    throw err;
+  }
+}
+```
+
 ## Enterprise captchas
 
 For `hcaptcha_enterprise`, `rqdata` is required. The types enforce it, so leaving it out is a compile error, not a runtime surprise.
@@ -97,6 +148,42 @@ await nc.solve({
 });
 ```
 
+## Reporting token acceptance
+
+A token that hCaptcha blessed can still be refused by the site you send it to. Tell us what happened and we tune minting against your real acceptance rate — it's free, and it's the fastest way to get a regression on your sitekey noticed.
+
+Keep the `solve_id` next to the token you submit downstream, then report the verdict:
+
+```ts
+const solve = await nc.solve({ type: "hcaptcha", sitekey, url });
+const ok = await submitToTheSiteYouAreAutomating(solve.token);
+
+await nc.feedback.report({
+  solve_id: solve.id,
+  outcome: ok ? "accepted" : "rejected",
+  reason: ok ? undefined : "session invalidated", // optional, freeform
+});
+```
+
+At volume, buffer the verdicts and flush them in one call. Reports over 500 are split across requests for you:
+
+```ts
+const batch = await nc.feedback.reportMany([
+  { solve_id: "solve_01J...", outcome: "accepted" },
+  { solve_id: "solve_01J...", outcome: "rejected", reason: "..." },
+]);
+
+// Items resolve independently, so the call succeeds even when some are
+// rejected — check `failed` rather than relying on a throw.
+if (batch.failed > 0) {
+  console.warn(batch.results.filter((r) => r.status === "error"));
+}
+```
+
+`outcome` is one of `accepted`, `rejected`, `unknown` (submitted, verdict unclear), `unused` (never submitted), or `error` (downstream broke for a non-token reason). Only `accepted` and `rejected` count toward the acceptance rate.
+
+Reporting the same solve again corrects the earlier verdict, so retries and late fixes are safe. You can report any of your own solved solves within ~30 days of the solve; corrections to something you already reported are never cut off by that window.
+
 ## Lower-level API
 
 `solve()` is the convenient path. When you want control over submission and polling, the raw resource methods map one to one to the REST API.

package/dist/index.cjs

@@ -47,6 +47,15 @@ var SolveFailedError = class extends NoneCapError {
   }
 };
 var TimeoutError = class extends NoneCapError {
+  /** The id of the in-flight solve, when the timeout came from a solve wait. */
+  solveId;
+  /** The last-known solve state, so you can cancel it after a wait timed out. */
+  solve;
+  constructor(message, opts = {}) {
+    super(message, opts);
+    this.solveId = opts.solveId;
+    this.solve = opts.solve;
+  }
 };
 function errorFromResponse(status, code, message, param) {
   const opts = { code, status, param };
@@ -57,17 +66,21 @@ function errorFromResponse(status, code, message, param) {
     case "account_locked":
       return new PermissionError(message, opts);
     case "insufficient_credits":
+    case "key_credit_limit_exceeded":
       return new InsufficientCreditsError(message, opts);
     case "invalid_request":
     case "validation_error":
+    case "expired_window":
       return new ValidationError(message, opts);
     case "not_found":
+    case "not_eligible":
       return new NotFoundError(message, opts);
     case "conflict":
       return new ConflictError(message, opts);
     case "rate_limited":
     case "concurrency_limit_exceeded":
     case "ext_daily_limit":
+    case "sitekey_rate_limited":
       return new RateLimitError(message, opts);
     default:
       return new APIError(message, opts);
@@ -77,6 +90,7 @@ function errorFromResponse(status, code, message, param) {
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.nonecap.com";
 var MAX_WAIT_SECONDS = 90;
+var FEEDBACK_BATCH_MAX = 500;
 var TERMINAL = /* @__PURE__ */ new Set([
   "solved",
   "failed",
@@ -129,6 +143,25 @@ var NoneCap = class {
     cancel: (id, options = {}) => this.#request("DELETE", `/v1/solves/${encodeURIComponent(id)}`, {
       signal: options.signal
     }),
+    /**
+     * Submit a solve and return a {@link SolveHandle} for it.
+     *
+     * Unlike {@link NoneCap.solve}, this returns as soon as the submission is
+     * accepted, so `handle.id` is available immediately. Use the handle to
+     * `cancel()` the solve or `await handle.result()` for the finished solve.
+     *
+     * ```ts
+     * const handle = await nc.solves.start({ type: "hcaptcha", sitekey, url });
+     * // ...later, e.g. on shutdown:
+     * await handle.cancel();
+     * // or wait for it:
+     * const { token } = await handle.result();
+     * ```
+     */
+    start: async (params, options = {}) => {
+      const solve = await this.solves.create(params, { signal: options.signal });
+      return new SolveHandle(this, solve);
+    },
     /** Fetch one page of solves. */
     list: (params = {}, options = {}) => this.#request("GET", "/v1/solves", {
       query: {
@@ -148,6 +181,74 @@ var NoneCap = class {
      */
     listAll: (params = {}, options = {}) => this.#listAll(params, options)
   };
+  /**
+   * Report what your downstream target did with the tokens we minted.
+   *
+   * Feedback is free, own-solves-only, and idempotent per solve id: reporting
+   * the same solve again corrects the earlier verdict. Only `solved` solves can
+   * be reported, and only within the API's reporting window (~30 days from the
+   * solve; corrections to an already-reported solve are never re-gated by it).
+   */
+  feedback = {
+    /**
+     * Report one solve's downstream outcome, returning the recorded feedback.
+     *
+     * Unlike {@link NoneCap.feedback.reportMany}, a rejected report throws:
+     * {@link NotFoundError} if the solve isn't yours or never minted a token,
+     * {@link ValidationError} if a field is wrong or the reporting window closed.
+     *
+     * ```ts
+     * await nc.feedback.report({ solve_id: solve.id, outcome: "rejected", reason: "..." });
+     * ```
+     */
+    report: (report, options = {}) => {
+      const { solve_id, ...fields } = report;
+      return this.#request(
+        "POST",
+        `/v1/solves/${encodeURIComponent(solve_id)}/feedback`,
+        { body: toWireFields(fields), signal: options.signal }
+      );
+    },
+    /**
+     * Report many verdicts at once — the path to use at volume. Buffer verdicts
+     * as you learn them and flush them here.
+     *
+     * The call succeeds even when individual items are rejected: each is
+     * resolved on its own so one stale id never discards the rest. Check
+     * `failed` rather than relying on a thrown error.
+     *
+     * More than {@link FEEDBACK_BATCH_MAX} reports are split across sequential
+     * requests and merged into one result, in request order. An empty array is
+     * a no-op that returns an empty batch without a request.
+     *
+     * ```ts
+     * const batch = await nc.feedback.reportMany(buffer);
+     * if (batch.failed) console.warn(batch.results.filter((r) => r.status === "error"));
+     * ```
+     */
+    reportMany: async (reports, options = {}) => {
+      const merged = {
+        object: "feedback_batch",
+        recorded: 0,
+        updated: 0,
+        unchanged: 0,
+        failed: 0,
+        results: []
+      };
+      for (let i = 0; i < reports.length; i += FEEDBACK_BATCH_MAX) {
+        const batch = await this.#request("POST", "/v1/feedback", {
+          body: { feedback: reports.slice(i, i + FEEDBACK_BATCH_MAX).map(toWireReport) },
+          signal: options.signal
+        });
+        merged.recorded += batch.recorded;
+        merged.updated += batch.updated;
+        merged.unchanged += batch.unchanged;
+        merged.failed += batch.failed;
+        merged.results.push(...batch.results);
+      }
+      return merged;
+    }
+  };
   /** Fetch your account, including the current credit balance. */
   me(options = {}) {
     return this.#request("GET", "/v1/me", { signal: options.signal });
@@ -158,28 +259,14 @@ var NoneCap = class {
    * Uses the server's long-poll under the hood and keeps polling until the
    * solve is terminal or `timeout` elapses. Throws {@link SolveFailedError} if
    * the solve fails/expires/is cancelled, or {@link TimeoutError} on timeout.
+   *
+   * This is sugar for `(await solves.start(params)).result(options)`. When you
+   * need to cancel the solve while it runs, use {@link NoneCap.solves.start}
+   * and keep the {@link SolveHandle}.
    */
   async solve(params, options = {}) {
-    const timeout = options.timeout ?? 18e4;
-    const deadline = Date.now() + timeout;
-    let solve = await this.solves.create(params, {
-      wait: waitSeconds(deadline),
-      signal: options.signal
-    });
-    while (!isTerminal(solve.status)) {
-      if (Date.now() >= deadline) {
-        throw new TimeoutError(
-          `Solve ${solve.id} did not finish within ${timeout}ms (last status: ${solve.status}).`,
-          { code: void 0 }
-        );
-      }
-      solve = await this.solves.retrieve(solve.id, {
-        wait: waitSeconds(deadline),
-        signal: options.signal
-      });
-    }
-    if (solve.status !== "solved") throw new SolveFailedError(solve);
-    return solve;
+    const handle = await this.solves.start(params, { signal: options.signal });
+    return handle.result(options);
   }
   // -- internals ------------------------------------------------------------
   #timeoutForWait(wait) {
@@ -268,6 +355,103 @@ var NoneCap = class {
     );
   }
 };
+var SolveHandle = class {
+  /** The id of the started solve, available as soon as `start()` resolved. */
+  id;
+  #client;
+  /** The latest solve state we have seen, from the create, polls, or cancel. */
+  #solve;
+  /**
+   * The cached TERMINAL outcome: resolves to the solved solve, or rejects with
+   * {@link SolveFailedError} if terminal-but-not-solved. Only ever set once the
+   * solve actually reaches a terminal state, so it is safe to replay forever. A
+   * timed-out wait does NOT settle this — it is retryable.
+   */
+  #terminal;
+  /** The poll currently in flight, shared by concurrent result() callers. */
+  #inflight;
+  constructor(client, solve) {
+    this.#client = client;
+    this.#solve = solve;
+    this.id = solve.id;
+  }
+  /** The last-known solve state for this handle. */
+  get solve() {
+    return this.#solve;
+  }
+  /**
+   * Long-poll until the solve is terminal, returning the solved solve. Throws
+   * {@link SolveFailedError} if it fails/expires/is cancelled, or
+   * {@link TimeoutError} on timeout (with `solveId`/`solve` attached so you can
+   * still {@link SolveHandle.cancel} it).
+   *
+   * Memoizes the *terminal* outcome: once the solve actually finishes, every
+   * later call returns that same settled result. A {@link TimeoutError} is not
+   * memoized — it just means this wait gave up, so a later call (e.g. with a
+   * larger `timeout`) resumes polling. Concurrent calls share one in-flight
+   * poll, so they never issue duplicate requests. The first caller's
+   * `timeout`/`signal` drive the shared poll; a later call starts a fresh one.
+   */
+  result(options = {}) {
+    if (this.#terminal) return this.#terminal;
+    if (this.#inflight) return this.#inflight;
+    const run = this.#poll(options).finally(() => {
+      if (this.#inflight === run) this.#inflight = void 0;
+    });
+    this.#inflight = run;
+    return run;
+  }
+  /**
+   * Cancel the solve. Cancelled solves are never charged, so this is for clean
+   * shutdown / freeing slots / stopping early, not cost protection.
+   *
+   * If the solve already reached a terminal state the API answers 409; that is
+   * not an error a caller cares about, so this swallows {@link ConflictError}
+   * and returns the current solve state instead. A cancel that lands on a
+   * terminal state (cancelled, or whatever the 409-swallow read back) settles
+   * this handle's {@link SolveHandle.result}, so any in-flight or later wait
+   * stops polling and reflects that terminal state.
+   */
+  async cancel(options = {}) {
+    try {
+      this.#solve = await this.#client.solves.cancel(this.id, options);
+    } catch (err) {
+      if (!(err instanceof ConflictError)) throw err;
+      this.#solve = await this.#client.solves.retrieve(this.id, options);
+    }
+    if (!this.#terminal && isTerminal(this.#solve.status)) this.#cacheTerminal();
+    return this.#solve;
+  }
+  /**
+   * Build and memoize the terminal outcome from the current `#solve`. The
+   * precondition is that `#solve` is terminal and `#terminal` is unset.
+   */
+  #cacheTerminal() {
+    const settled = this.#solve.status === "solved" ? Promise.resolve(this.#solve) : Promise.reject(new SolveFailedError(this.#solve));
+    settled.catch(() => {
+    });
+    this.#terminal = settled;
+    return settled;
+  }
+  async #poll(options) {
+    const timeout = options.timeout ?? 18e4;
+    const deadline = Date.now() + timeout;
+    for (; ; ) {
+      if (this.#terminal) return this.#terminal;
+      if (isTerminal(this.#solve.status)) return this.#cacheTerminal();
+      if (Date.now() >= deadline) {
+        throw new TimeoutError(
+          `Solve ${this.id} did not finish within ${timeout}ms (last status: ${this.#solve.status}).`,
+          { solveId: this.id, solve: this.#solve }
+        );
+      }
+      this.#solve = await this.#client.solves.retrieve(this.id, {
+        wait: waitSeconds(deadline),
+        signal: options.signal
+      });
+    }
+  }
+};
 function waitSeconds(deadline) {
   const remaining = Math.ceil((deadline - Date.now()) / 1e3);
   return Math.max(1, Math.min(MAX_WAIT_SECONDS, remaining));
@@ -275,11 +459,25 @@ function waitSeconds(deadline) {
 function isAbort(err) {
   return err instanceof Error && err.name === "AbortError";
 }
+function toWireFields(fields) {
+  const wire = { outcome: fields.outcome };
+  if (fields.estado !== void 0) wire.estado = fields.estado;
+  if (fields.reason !== void 0) wire.reason = fields.reason;
+  if (fields.reported_at !== void 0) {
+    wire.reported_at = fields.reported_at instanceof Date ? fields.reported_at.toISOString() : fields.reported_at;
+  }
+  return wire;
+}
+function toWireReport(report) {
+  const { solve_id, ...fields } = report;
+  return { solve_id, ...toWireFields(fields) };
+}
 
 exports.APIError = APIError;
 exports.AuthenticationError = AuthenticationError;
 exports.ConflictError = ConflictError;
 exports.ConnectionError = ConnectionError;
+exports.FEEDBACK_BATCH_MAX = FEEDBACK_BATCH_MAX;
 exports.InsufficientCreditsError = InsufficientCreditsError;
 exports.NoneCap = NoneCap;
 exports.NoneCapError = NoneCapError;
@@ -287,6 +485,7 @@ exports.NotFoundError = NotFoundError;
 exports.PermissionError = PermissionError;
 exports.RateLimitError = RateLimitError;
 exports.SolveFailedError = SolveFailedError;
+exports.SolveHandle = SolveHandle;
 exports.TimeoutError = TimeoutError;
 exports.ValidationError = ValidationError;
 exports.isTerminal = isTerminal;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { ErrorCode, Solve } from \"./types.js\";\n\n/**\n * Base class for every error this library throws. Catch `NoneCapError` to\n * handle all of them, or catch a subclass to handle one kind.\n */\nexport class NoneCapError extends Error {\n  /** Machine-readable error code from the API envelope, when there is one. */\n  readonly code: ErrorCode | undefined;\n  /** HTTP status, when the error came from a response. */\n  readonly status: number | undefined;\n  /** The request field that was rejected, for validation errors. */\n  readonly param: string | null;\n\n  constructor(\n    message: string,\n    opts: { code?: ErrorCode; status?: number; param?: string | null } = {},\n  ) {\n    super(message);\n    this.name = new.target.name;\n    this.code = opts.code;\n    this.status = opts.status;\n    this.param = opts.param ?? null;\n    // Restore the prototype chain when compiled down to ES5-era targets.\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** 401 — the API key is missing, malformed, or revoked. */\nexport class AuthenticationError extends NoneCapError {}\n\n/** 403 — the key is valid but not allowed to do this (scope or locked account). */\nexport class PermissionError extends NoneCapError {}\n\n/** 402 — the account is out of credits. */\nexport class InsufficientCreditsError extends NoneCapError {}\n\n/** 422 / 400 — the request was rejected. `param` names the offending field. */\nexport class ValidationError extends NoneCapError {}\n\n/** 404 — no such resource. */\nexport class NotFoundError extends NoneCapError {}\n\n/** 409 — the solve is already in a terminal state (e.g. cancelling a finished solve). */\nexport class ConflictError extends NoneCapError {}\n\n/** 429 — too many concurrent solves, or rate limited. Back off and retry. */\nexport class RateLimitError extends NoneCapError {}\n\n/** 5xx, or a response that wasn't the expected shape. */\nexport class APIError extends NoneCapError {}\n\n/** The request never reached the API (DNS, TCP, TLS, timeout, offline). */\nexport class ConnectionError extends NoneCapError {}\n\n/**\n * Thrown by {@link NoneCap.solve} when a solve reaches a terminal state without\n * a token: `failed`, `expired`, or `cancelled`. The full solve is attached so\n * you can inspect `solve.error` and timings.\n */\nexport class SolveFailedError extends NoneCapError {\n  readonly solve: Solve;\n\n  constructor(solve: Solve) {\n    const detail = solve.error ? `${solve.error.code}: ${solve.error.message}` : solve.status;\n    super(`Solve ${solve.id} ${solve.status} (${detail})`, {\n      code: undefined,\n      status: undefined,\n    });\n    this.solve = solve;\n  }\n}\n\n/** Thrown by {@link NoneCap.solve} when the client-side timeout elapses first. */\nexport class TimeoutError extends NoneCapError {}\n\n/** Map an API error envelope (plus HTTP status) to the right error subclass. */\nexport function errorFromResponse(\n  status: number,\n  code: ErrorCode | undefined,\n  message: string,\n  param: string | null,\n): NoneCapError {\n  const opts = { code, status, param };\n  switch (code) {\n    case \"unauthorized\":\n      return new AuthenticationError(message, opts);\n    case \"forbidden\":\n    case \"account_locked\":\n      return new PermissionError(message, opts);\n    case \"insufficient_credits\":\n      return new InsufficientCreditsError(message, opts);\n    case \"invalid_request\":\n    case \"validation_error\":\n      return new ValidationError(message, opts);\n    case \"not_found\":\n      return new NotFoundError(message, opts);\n    case \"conflict\":\n      return new ConflictError(message, opts);\n    case \"rate_limited\":\n    case \"concurrency_limit_exceeded\":\n    case \"ext_daily_limit\":\n      return new RateLimitError(message, opts);\n    default:\n      return new APIError(message, opts);\n  }\n}\n","import {\n  APIError,\n  ConnectionError,\n  NoneCapError,\n  SolveFailedError,\n  TimeoutError,\n  errorFromResponse,\n} from \"./errors.js\";\nimport type {\n  Account,\n  ErrorCode,\n  Solve,\n  SolveCreateParams,\n  SolveList,\n  SolveListParams,\n  SolveStatus,\n} from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"https://api.nonecap.com\";\n/** The API caps server-side long-poll at 90 seconds. */\nconst MAX_WAIT_SECONDS = 90;\nconst TERMINAL: ReadonlySet<SolveStatus> = new Set([\n  \"solved\",\n  \"failed\",\n  \"cancelled\",\n  \"expired\",\n]);\n\n/** Is this a terminal solve status? */\nexport function isTerminal(status: SolveStatus): boolean {\n  return TERMINAL.has(status);\n}\n\n/** A `fetch` implementation. Defaults to the global `fetch`. */\nexport type FetchLike = (\n  input: string,\n  init?: RequestInit,\n) => Promise<Response>;\n\n/** Options for constructing a {@link NoneCap} client. */\nexport interface NoneCapOptions {\n  /** Your NoneCap API key. Find it at https://dashboard.nonecap.com. */\n  apiKey: string;\n  /** Override the API base URL. Defaults to https://api.nonecap.com. */\n  baseURL?: string;\n  /**\n   * Per-request timeout in milliseconds for a single HTTP call. Defaults to\n   * 100000 (just above the 90s server long-poll). Note this bounds one HTTP\n   * round trip, not the whole {@link NoneCap.solve} wait — use the `timeout`\n   * option on `solve()` for that.\n   */\n  timeout?: number;\n  /** Inject a custom `fetch` (for testing, proxies, or non-standard runtimes). */\n  fetch?: FetchLike;\n}\n\n/** Per-call options for the long-polling endpoints. */\nexport interface WaitOptions {\n  /**\n   * Hold the connection open up to this many seconds (1–90) waiting for the\n   * solve to finish before responding. Omit to return immediately.\n   */\n  wait?: number;\n  /** Abort the request. */\n  signal?: AbortSignal;\n}\n\n/** Options for {@link NoneCap.solve}. */\nexport interface SolveHelperOptions {\n  /**\n   * Give up after this many milliseconds and throw {@link TimeoutError}.\n   * Defaults to 180000 (3 minutes).\n   */\n  timeout?: number;\n  /** Abort waiting. */\n  signal?: AbortSignal;\n}\n\ninterface RequestOptions {\n  query?: Record<string, string | number | undefined>;\n  body?: unknown;\n  signal?: AbortSignal;\n  /** Override the per-request timeout for this call (used by long polls). */\n  timeout?: number;\n  /** HTTP statuses to treat as success in addition to 2xx (e.g. 202). */\n  expect?: number[];\n}\n\n/**\n * The NoneCap API client.\n *\n * ```ts\n * const nc = new NoneCap({ apiKey: process.env.NONECAP_KEY! });\n * const { token } = await nc.solve({ type: \"hcaptcha\", sitekey, url });\n * ```\n */\nexport class NoneCap {\n  readonly #apiKey: string;\n  readonly #baseURL: string;\n  readonly #timeout: number;\n  readonly #fetch: FetchLike;\n\n  constructor(options: NoneCapOptions) {\n    if (!options || !options.apiKey) {\n      throw new NoneCapError(\n        \"A NoneCap API key is required. Pass it as `new NoneCap({ apiKey })`.\",\n      );\n    }\n    this.#apiKey = options.apiKey;\n    this.#baseURL = (options.baseURL ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.#timeout = options.timeout ?? 100_000;\n    const f = options.fetch ?? (globalThis.fetch as FetchLike | undefined);\n    if (!f) {\n      throw new NoneCapError(\n        \"No `fetch` available. Use Node 18+, or pass a `fetch` in the client options.\",\n      );\n    }\n    this.#fetch = f;\n  }\n\n  /** Operations on solves. */\n  readonly solves = {\n    /** Submit a solve. Pass `{ wait }` to hold the connection until it finishes. */\n    create: (params: SolveCreateParams, options: WaitOptions = {}): Promise<Solve> =>\n      this.#request<Solve>(\"POST\", \"/v1/solves\", {\n        body: params,\n        query: { wait: options.wait },\n        signal: options.signal,\n        timeout: this.#timeoutForWait(options.wait),\n        expect: [202],\n      }),\n\n    /** Fetch a solve by id. Pass `{ wait }` to long-poll until it finishes. */\n    retrieve: (id: string, options: WaitOptions = {}): Promise<Solve> =>\n      this.#request<Solve>(\"GET\", `/v1/solves/${encodeURIComponent(id)}`, {\n        query: { wait: options.wait },\n        signal: options.signal,\n        timeout: this.#timeoutForWait(options.wait),\n        expect: [202],\n      }),\n\n    /** Cancel a pending or in-flight solve. */\n    cancel: (id: string, options: { signal?: AbortSignal } = {}): Promise<Solve> =>\n      this.#request<Solve>(\"DELETE\", `/v1/solves/${encodeURIComponent(id)}`, {\n        signal: options.signal,\n      }),\n\n    /** Fetch one page of solves. */\n    list: (params: SolveListParams = {}, options: { signal?: AbortSignal } = {}): Promise<SolveList> =>\n      this.#request<SolveList>(\"GET\", \"/v1/solves\", {\n        query: {\n          limit: params.limit,\n          starting_after: params.starting_after,\n          status: params.status,\n          type: params.type,\n        },\n        signal: options.signal,\n      }),\n\n    /**\n     * Iterate every solve across pages, newest first.\n     *\n     * ```ts\n     * for await (const solve of nc.solves.listAll()) { ... }\n     * ```\n     */\n    listAll: (\n      params: SolveListParams = {},\n      options: { signal?: AbortSignal } = {},\n    ): AsyncIterableIterator<Solve> => this.#listAll(params, options),\n  };\n\n  /** Fetch your account, including the current credit balance. */\n  me(options: { signal?: AbortSignal } = {}): Promise<Account> {\n    return this.#request<Account>(\"GET\", \"/v1/me\", { signal: options.signal });\n  }\n\n  /**\n   * Submit a solve and wait for it to finish, returning the solved solve.\n   *\n   * Uses the server's long-poll under the hood and keeps polling until the\n   * solve is terminal or `timeout` elapses. Throws {@link SolveFailedError} if\n   * the solve fails/expires/is cancelled, or {@link TimeoutError} on timeout.\n   */\n  async solve(params: SolveCreateParams, options: SolveHelperOptions = {}): Promise<Solve> {\n    const timeout = options.timeout ?? 180_000;\n    const deadline = Date.now() + timeout;\n\n    let solve = await this.solves.create(params, {\n      wait: waitSeconds(deadline),\n      signal: options.signal,\n    });\n\n    while (!isTerminal(solve.status)) {\n      if (Date.now() >= deadline) {\n        throw new TimeoutError(\n          `Solve ${solve.id} did not finish within ${timeout}ms (last status: ${solve.status}).`,\n          { code: undefined },\n        );\n      }\n      solve = await this.solves.retrieve(solve.id, {\n        wait: waitSeconds(deadline),\n        signal: options.signal,\n      });\n    }\n\n    if (solve.status !== \"solved\") throw new SolveFailedError(solve);\n    return solve;\n  }\n\n  // -- internals ------------------------------------------------------------\n\n  #timeoutForWait(wait?: number): number | undefined {\n    if (wait === undefined) return undefined;\n    // Give the socket a margin beyond the server's long-poll window.\n    return wait * 1000 + 15_000;\n  }\n\n  async *#listAll(\n    params: SolveListParams,\n    options: { signal?: AbortSignal },\n  ): AsyncIterableIterator<Solve> {\n    let cursor = params.starting_after;\n    for (;;) {\n      const page = await this.solves.list({ ...params, starting_after: cursor }, options);\n      for (const solve of page.data) yield solve;\n      if (!page.has_more || page.data.length === 0) return;\n      cursor = page.data[page.data.length - 1]!.id;\n    }\n  }\n\n  async #request<T>(method: string, path: string, options: RequestOptions = {}): Promise<T> {\n    const url = new URL(this.#baseURL + path);\n    if (options.query) {\n      for (const [key, value] of Object.entries(options.query)) {\n        if (value !== undefined && value !== \"\") url.searchParams.set(key, String(value));\n      }\n    }\n\n    const headers: Record<string, string> = {\n      Authorization: `Bearer ${this.#apiKey}`,\n      Accept: \"application/json\",\n    };\n    let bodyInit: string | undefined;\n    if (options.body !== undefined) {\n      headers[\"Content-Type\"] = \"application/json\";\n      bodyInit = JSON.stringify(options.body);\n    }\n\n    const controller = new AbortController();\n    const timeoutMs = options.timeout ?? this.#timeout;\n    const timer = setTimeout(() => controller.abort(new TimeoutError(`Request timed out after ${timeoutMs}ms.`)), timeoutMs);\n    const onAbort = () => controller.abort(options.signal?.reason);\n    if (options.signal) {\n      if (options.signal.aborted) onAbort();\n      else options.signal.addEventListener(\"abort\", onAbort, { once: true });\n    }\n\n    let res: Response;\n    try {\n      res = await this.#fetch(url.toString(), {\n        method,\n        headers,\n        body: bodyInit,\n        signal: controller.signal,\n      });\n    } catch (err) {\n      if (err instanceof TimeoutError) throw err;\n      if (isAbort(err)) {\n        // A caller-supplied signal aborting surfaces as the caller's reason.\n        if (options.signal?.aborted) throw options.signal.reason instanceof Error\n          ? options.signal.reason\n          : new NoneCapError(\"Request aborted.\");\n        throw new TimeoutError(`Request timed out after ${timeoutMs}ms.`);\n      }\n      throw new ConnectionError(\n        `Could not reach the NoneCap API at ${this.#baseURL}: ${(err as Error).message}`,\n      );\n    } finally {\n      clearTimeout(timer);\n      options.signal?.removeEventListener(\"abort\", onAbort);\n    }\n\n    return this.#parse<T>(res, options.expect ?? []);\n  }\n\n  async #parse<T>(res: Response, expect: number[]): Promise<T> {\n    const text = await res.text();\n    let json: unknown;\n    if (text) {\n      try {\n        json = JSON.parse(text);\n      } catch {\n        throw new APIError(\n          `Unexpected non-JSON response (HTTP ${res.status}): ${text.slice(0, 200)}`,\n          { status: res.status },\n        );\n      }\n    }\n\n    if (res.ok || expect.includes(res.status)) {\n      return json as T;\n    }\n\n    const envelope = json as { error?: { code?: ErrorCode; message?: string; param?: string | null } } | undefined;\n    const apiError = envelope?.error;\n    throw errorFromResponse(\n      res.status,\n      apiError?.code,\n      apiError?.message ?? `HTTP ${res.status}`,\n      apiError?.param ?? null,\n    );\n  }\n}\n\n/**\n * The `wait` value for the next long-poll: whole seconds until `deadline`,\n * clamped to the server's 1–90 window. The floor of 1 keeps the param valid,\n * so callers must decide whether the deadline has passed with the clock, not\n * with this return value.\n */\nfunction waitSeconds(deadline: number): number {\n  const remaining = Math.ceil((deadline - Date.now()) / 1000);\n  return Math.max(1, Math.min(MAX_WAIT_SECONDS, remaining));\n}\n\nfunction isAbort(err: unknown): boolean {\n  return err instanceof Error && err.name === \"AbortError\";\n}\n"]}
+{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["import type { ErrorCode, Solve } from \"./types.js\";\n\n/**\n * Base class for every error this library throws. Catch `NoneCapError` to\n * handle all of them, or catch a subclass to handle one kind.\n */\nexport class NoneCapError extends Error {\n  /** Machine-readable error code from the API envelope, when there is one. */\n  readonly code: ErrorCode | undefined;\n  /** HTTP status, when the error came from a response. */\n  readonly status: number | undefined;\n  /** The request field that was rejected, for validation errors. */\n  readonly param: string | null;\n\n  constructor(\n    message: string,\n    opts: { code?: ErrorCode; status?: number; param?: string | null } = {},\n  ) {\n    super(message);\n    this.name = new.target.name;\n    this.code = opts.code;\n    this.status = opts.status;\n    this.param = opts.param ?? null;\n    // Restore the prototype chain when compiled down to ES5-era targets.\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** 401 — the API key is missing, malformed, or revoked. */\nexport class AuthenticationError extends NoneCapError {}\n\n/** 403 — the key is valid but not allowed to do this (scope or locked account). */\nexport class PermissionError extends NoneCapError {}\n\n/** 402 — the account is out of credits. */\nexport class InsufficientCreditsError extends NoneCapError {}\n\n/** 422 / 400 — the request was rejected. `param` names the offending field. */\nexport class ValidationError extends NoneCapError {}\n\n/** 404 — no such resource. */\nexport class NotFoundError extends NoneCapError {}\n\n/** 409 — the solve is already in a terminal state (e.g. cancelling a finished solve). */\nexport class ConflictError extends NoneCapError {}\n\n/** 429 — too many concurrent solves, or rate limited. Back off and retry. */\nexport class RateLimitError extends NoneCapError {}\n\n/** 5xx, or a response that wasn't the expected shape. */\nexport class APIError extends NoneCapError {}\n\n/** The request never reached the API (DNS, TCP, TLS, timeout, offline). */\nexport class ConnectionError extends NoneCapError {}\n\n/**\n * Thrown by {@link NoneCap.solve} when a solve reaches a terminal state without\n * a token: `failed`, `expired`, or `cancelled`. The full solve is attached so\n * you can inspect `solve.error` and timings.\n */\nexport class SolveFailedError extends NoneCapError {\n  readonly solve: Solve;\n\n  constructor(solve: Solve) {\n    const detail = solve.error ? `${solve.error.code}: ${solve.error.message}` : solve.status;\n    super(`Solve ${solve.id} ${solve.status} (${detail})`, {\n      code: undefined,\n      status: undefined,\n    });\n    this.solve = solve;\n  }\n}\n\n/**\n * Thrown by {@link NoneCap.solve} (and {@link SolveHandle.result}) when the\n * client-side timeout elapses first. When the timeout came from waiting on a\n * solve, `solveId` and the last-known `solve` are attached so you can still\n * cancel the in-flight solve. They are `undefined` for transport-level timeouts.\n */\nexport class TimeoutError extends NoneCapError {\n  /** The id of the in-flight solve, when the timeout came from a solve wait. */\n  readonly solveId: string | undefined;\n  /** The last-known solve state, so you can cancel it after a wait timed out. */\n  readonly solve: Solve | undefined;\n\n  constructor(\n    message: string,\n    opts: {\n      code?: ErrorCode;\n      status?: number;\n      param?: string | null;\n      solveId?: string;\n      solve?: Solve;\n    } = {},\n  ) {\n    super(message, opts);\n    this.solveId = opts.solveId;\n    this.solve = opts.solve;\n  }\n}\n\n/** Map an API error envelope (plus HTTP status) to the right error subclass. */\nexport function errorFromResponse(\n  status: number,\n  code: ErrorCode | undefined,\n  message: string,\n  param: string | null,\n): NoneCapError {\n  const opts = { code, status, param };\n  switch (code) {\n    case \"unauthorized\":\n      return new AuthenticationError(message, opts);\n    case \"forbidden\":\n    case \"account_locked\":\n      return new PermissionError(message, opts);\n    case \"insufficient_credits\":\n    case \"key_credit_limit_exceeded\":\n      return new InsufficientCreditsError(message, opts);\n    case \"invalid_request\":\n    case \"validation_error\":\n    case \"expired_window\":\n      return new ValidationError(message, opts);\n    case \"not_found\":\n    case \"not_eligible\":\n      return new NotFoundError(message, opts);\n    case \"conflict\":\n      return new ConflictError(message, opts);\n    case \"rate_limited\":\n    case \"concurrency_limit_exceeded\":\n    case \"ext_daily_limit\":\n    case \"sitekey_rate_limited\":\n      return new RateLimitError(message, opts);\n    default:\n      return new APIError(message, opts);\n  }\n}\n","import {\n  APIError,\n  ConflictError,\n  ConnectionError,\n  NoneCapError,\n  SolveFailedError,\n  TimeoutError,\n  errorFromResponse,\n} from \"./errors.js\";\nimport type {\n  Account,\n  ErrorCode,\n  Feedback,\n  FeedbackBatch,\n  FeedbackReport,\n  Solve,\n  SolveCreateParams,\n  SolveList,\n  SolveListParams,\n  SolveStatus,\n} from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"https://api.nonecap.com\";\n/** The API caps server-side long-poll at 90 seconds. */\nconst MAX_WAIT_SECONDS = 90;\n/** The API caps one `POST /v1/feedback` call at 500 items. */\nexport const FEEDBACK_BATCH_MAX = 500;\nconst TERMINAL: ReadonlySet<SolveStatus> = new Set([\n  \"solved\",\n  \"failed\",\n  \"cancelled\",\n  \"expired\",\n]);\n\n/** Is this a terminal solve status? */\nexport function isTerminal(status: SolveStatus): boolean {\n  return TERMINAL.has(status);\n}\n\n/** A `fetch` implementation. Defaults to the global `fetch`. */\nexport type FetchLike = (\n  input: string,\n  init?: RequestInit,\n) => Promise<Response>;\n\n/** Options for constructing a {@link NoneCap} client. */\nexport interface NoneCapOptions {\n  /** Your NoneCap API key. Find it at https://dashboard.nonecap.com. */\n  apiKey: string;\n  /** Override the API base URL. Defaults to https://api.nonecap.com. */\n  baseURL?: string;\n  /**\n   * Per-request timeout in milliseconds for a single HTTP call. Defaults to\n   * 100000 (just above the 90s server long-poll). Note this bounds one HTTP\n   * round trip, not the whole {@link NoneCap.solve} wait — use the `timeout`\n   * option on `solve()` for that.\n   */\n  timeout?: number;\n  /** Inject a custom `fetch` (for testing, proxies, or non-standard runtimes). */\n  fetch?: FetchLike;\n}\n\n/** Per-call options for the long-polling endpoints. */\nexport interface WaitOptions {\n  /**\n   * Hold the connection open up to this many seconds (1–90) waiting for the\n   * solve to finish before responding. Omit to return immediately.\n   */\n  wait?: number;\n  /** Abort the request. */\n  signal?: AbortSignal;\n}\n\n/** Options for {@link NoneCap.solve} and {@link SolveHandle.result}. */\nexport interface SolveHelperOptions {\n  /**\n   * Give up after this many milliseconds and throw {@link TimeoutError}.\n   * Defaults to 180000 (3 minutes).\n   */\n  timeout?: number;\n  /** Abort waiting. */\n  signal?: AbortSignal;\n}\n\n/** Options for {@link NoneCap.solves.start}. */\nexport interface SolveStartOptions {\n  /** Abort the submission. */\n  signal?: AbortSignal;\n}\n\ninterface RequestOptions {\n  query?: Record<string, string | number | undefined>;\n  body?: unknown;\n  signal?: AbortSignal;\n  /** Override the per-request timeout for this call (used by long polls). */\n  timeout?: number;\n  /** HTTP statuses to treat as success in addition to 2xx (e.g. 202). */\n  expect?: number[];\n}\n\n/**\n * The NoneCap API client.\n *\n * ```ts\n * const nc = new NoneCap({ apiKey: process.env.NONECAP_KEY! });\n * const { token } = await nc.solve({ type: \"hcaptcha\", sitekey, url });\n * ```\n */\nexport class NoneCap {\n  readonly #apiKey: string;\n  readonly #baseURL: string;\n  readonly #timeout: number;\n  readonly #fetch: FetchLike;\n\n  constructor(options: NoneCapOptions) {\n    if (!options || !options.apiKey) {\n      throw new NoneCapError(\n        \"A NoneCap API key is required. Pass it as `new NoneCap({ apiKey })`.\",\n      );\n    }\n    this.#apiKey = options.apiKey;\n    this.#baseURL = (options.baseURL ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n    this.#timeout = options.timeout ?? 100_000;\n    const f = options.fetch ?? (globalThis.fetch as FetchLike | undefined);\n    if (!f) {\n      throw new NoneCapError(\n        \"No `fetch` available. Use Node 18+, or pass a `fetch` in the client options.\",\n      );\n    }\n    this.#fetch = f;\n  }\n\n  /** Operations on solves. */\n  readonly solves = {\n    /** Submit a solve. Pass `{ wait }` to hold the connection until it finishes. */\n    create: (params: SolveCreateParams, options: WaitOptions = {}): Promise<Solve> =>\n      this.#request<Solve>(\"POST\", \"/v1/solves\", {\n        body: params,\n        query: { wait: options.wait },\n        signal: options.signal,\n        timeout: this.#timeoutForWait(options.wait),\n        expect: [202],\n      }),\n\n    /** Fetch a solve by id. Pass `{ wait }` to long-poll until it finishes. */\n    retrieve: (id: string, options: WaitOptions = {}): Promise<Solve> =>\n      this.#request<Solve>(\"GET\", `/v1/solves/${encodeURIComponent(id)}`, {\n        query: { wait: options.wait },\n        signal: options.signal,\n        timeout: this.#timeoutForWait(options.wait),\n        expect: [202],\n      }),\n\n    /** Cancel a pending or in-flight solve. */\n    cancel: (id: string, options: { signal?: AbortSignal } = {}): Promise<Solve> =>\n      this.#request<Solve>(\"DELETE\", `/v1/solves/${encodeURIComponent(id)}`, {\n        signal: options.signal,\n      }),\n\n    /**\n     * Submit a solve and return a {@link SolveHandle} for it.\n     *\n     * Unlike {@link NoneCap.solve}, this returns as soon as the submission is\n     * accepted, so `handle.id` is available immediately. Use the handle to\n     * `cancel()` the solve or `await handle.result()` for the finished solve.\n     *\n     * ```ts\n     * const handle = await nc.solves.start({ type: \"hcaptcha\", sitekey, url });\n     * // ...later, e.g. on shutdown:\n     * await handle.cancel();\n     * // or wait for it:\n     * const { token } = await handle.result();\n     * ```\n     */\n    start: async (\n      params: SolveCreateParams,\n      options: SolveStartOptions = {},\n    ): Promise<SolveHandle> => {\n      const solve = await this.solves.create(params, { signal: options.signal });\n      return new SolveHandle(this, solve);\n    },\n\n    /** Fetch one page of solves. */\n    list: (params: SolveListParams = {}, options: { signal?: AbortSignal } = {}): Promise<SolveList> =>\n      this.#request<SolveList>(\"GET\", \"/v1/solves\", {\n        query: {\n          limit: params.limit,\n          starting_after: params.starting_after,\n          status: params.status,\n          type: params.type,\n        },\n        signal: options.signal,\n      }),\n\n    /**\n     * Iterate every solve across pages, newest first.\n     *\n     * ```ts\n     * for await (const solve of nc.solves.listAll()) { ... }\n     * ```\n     */\n    listAll: (\n      params: SolveListParams = {},\n      options: { signal?: AbortSignal } = {},\n    ): AsyncIterableIterator<Solve> => this.#listAll(params, options),\n  };\n\n  /**\n   * Report what your downstream target did with the tokens we minted.\n   *\n   * Feedback is free, own-solves-only, and idempotent per solve id: reporting\n   * the same solve again corrects the earlier verdict. Only `solved` solves can\n   * be reported, and only within the API's reporting window (~30 days from the\n   * solve; corrections to an already-reported solve are never re-gated by it).\n   */\n  readonly feedback = {\n    /**\n     * Report one solve's downstream outcome, returning the recorded feedback.\n     *\n     * Unlike {@link NoneCap.feedback.reportMany}, a rejected report throws:\n     * {@link NotFoundError} if the solve isn't yours or never minted a token,\n     * {@link ValidationError} if a field is wrong or the reporting window closed.\n     *\n     * ```ts\n     * await nc.feedback.report({ solve_id: solve.id, outcome: \"rejected\", reason: \"...\" });\n     * ```\n     */\n    report: (report: FeedbackReport, options: { signal?: AbortSignal } = {}): Promise<Feedback> => {\n      const { solve_id, ...fields } = report;\n      return this.#request<Feedback>(\n        \"POST\",\n        `/v1/solves/${encodeURIComponent(solve_id)}/feedback`,\n        { body: toWireFields(fields), signal: options.signal },\n      );\n    },\n\n    /**\n     * Report many verdicts at once — the path to use at volume. Buffer verdicts\n     * as you learn them and flush them here.\n     *\n     * The call succeeds even when individual items are rejected: each is\n     * resolved on its own so one stale id never discards the rest. Check\n     * `failed` rather than relying on a thrown error.\n     *\n     * More than {@link FEEDBACK_BATCH_MAX} reports are split across sequential\n     * requests and merged into one result, in request order. An empty array is\n     * a no-op that returns an empty batch without a request.\n     *\n     * ```ts\n     * const batch = await nc.feedback.reportMany(buffer);\n     * if (batch.failed) console.warn(batch.results.filter((r) => r.status === \"error\"));\n     * ```\n     */\n    reportMany: async (\n      reports: readonly FeedbackReport[],\n      options: { signal?: AbortSignal } = {},\n    ): Promise<FeedbackBatch> => {\n      const merged: FeedbackBatch = {\n        object: \"feedback_batch\",\n        recorded: 0,\n        updated: 0,\n        unchanged: 0,\n        failed: 0,\n        results: [],\n      };\n      // Chunks are sent in order and the server upserts last-write-wins, so a\n      // solve reported twice still ends at its last value. Duplicates split\n      // across a chunk boundary each get written, though, so the earlier one\n      // reports `recorded`/`updated` where a single request would say\n      // `unchanged`.\n      for (let i = 0; i < reports.length; i += FEEDBACK_BATCH_MAX) {\n        const batch = await this.#request<FeedbackBatch>(\"POST\", \"/v1/feedback\", {\n          body: { feedback: reports.slice(i, i + FEEDBACK_BATCH_MAX).map(toWireReport) },\n          signal: options.signal,\n        });\n        merged.recorded += batch.recorded;\n        merged.updated += batch.updated;\n        merged.unchanged += batch.unchanged;\n        merged.failed += batch.failed;\n        merged.results.push(...batch.results);\n      }\n      return merged;\n    },\n  };\n\n  /** Fetch your account, including the current credit balance. */\n  me(options: { signal?: AbortSignal } = {}): Promise<Account> {\n    return this.#request<Account>(\"GET\", \"/v1/me\", { signal: options.signal });\n  }\n\n  /**\n   * Submit a solve and wait for it to finish, returning the solved solve.\n   *\n   * Uses the server's long-poll under the hood and keeps polling until the\n   * solve is terminal or `timeout` elapses. Throws {@link SolveFailedError} if\n   * the solve fails/expires/is cancelled, or {@link TimeoutError} on timeout.\n   *\n   * This is sugar for `(await solves.start(params)).result(options)`. When you\n   * need to cancel the solve while it runs, use {@link NoneCap.solves.start}\n   * and keep the {@link SolveHandle}.\n   */\n  async solve(params: SolveCreateParams, options: SolveHelperOptions = {}): Promise<Solve> {\n    const handle = await this.solves.start(params, { signal: options.signal });\n    return handle.result(options);\n  }\n\n  // -- internals ------------------------------------------------------------\n\n  #timeoutForWait(wait?: number): number | undefined {\n    if (wait === undefined) return undefined;\n    // Give the socket a margin beyond the server's long-poll window.\n    return wait * 1000 + 15_000;\n  }\n\n  async *#listAll(\n    params: SolveListParams,\n    options: { signal?: AbortSignal },\n  ): AsyncIterableIterator<Solve> {\n    let cursor = params.starting_after;\n    for (;;) {\n      const page = await this.solves.list({ ...params, starting_after: cursor }, options);\n      for (const solve of page.data) yield solve;\n      if (!page.has_more || page.data.length === 0) return;\n      cursor = page.data[page.data.length - 1]!.id;\n    }\n  }\n\n  async #request<T>(method: string, path: string, options: RequestOptions = {}): Promise<T> {\n    const url = new URL(this.#baseURL + path);\n    if (options.query) {\n      for (const [key, value] of Object.entries(options.query)) {\n        if (value !== undefined && value !== \"\") url.searchParams.set(key, String(value));\n      }\n    }\n\n    const headers: Record<string, string> = {\n      Authorization: `Bearer ${this.#apiKey}`,\n      Accept: \"application/json\",\n    };\n    let bodyInit: string | undefined;\n    if (options.body !== undefined) {\n      headers[\"Content-Type\"] = \"application/json\";\n      bodyInit = JSON.stringify(options.body);\n    }\n\n    const controller = new AbortController();\n    const timeoutMs = options.timeout ?? this.#timeout;\n    const timer = setTimeout(() => controller.abort(new TimeoutError(`Request timed out after ${timeoutMs}ms.`)), timeoutMs);\n    const onAbort = () => controller.abort(options.signal?.reason);\n    if (options.signal) {\n      if (options.signal.aborted) onAbort();\n      else options.signal.addEventListener(\"abort\", onAbort, { once: true });\n    }\n\n    let res: Response;\n    try {\n      res = await this.#fetch(url.toString(), {\n        method,\n        headers,\n        body: bodyInit,\n        signal: controller.signal,\n      });\n    } catch (err) {\n      if (err instanceof TimeoutError) throw err;\n      if (isAbort(err)) {\n        // A caller-supplied signal aborting surfaces as the caller's reason.\n        if (options.signal?.aborted) throw options.signal.reason instanceof Error\n          ? options.signal.reason\n          : new NoneCapError(\"Request aborted.\");\n        throw new TimeoutError(`Request timed out after ${timeoutMs}ms.`);\n      }\n      throw new ConnectionError(\n        `Could not reach the NoneCap API at ${this.#baseURL}: ${(err as Error).message}`,\n      );\n    } finally {\n      clearTimeout(timer);\n      options.signal?.removeEventListener(\"abort\", onAbort);\n    }\n\n    return this.#parse<T>(res, options.expect ?? []);\n  }\n\n  async #parse<T>(res: Response, expect: number[]): Promise<T> {\n    const text = await res.text();\n    let json: unknown;\n    if (text) {\n      try {\n        json = JSON.parse(text);\n      } catch {\n        throw new APIError(\n          `Unexpected non-JSON response (HTTP ${res.status}): ${text.slice(0, 200)}`,\n          { status: res.status },\n        );\n      }\n    }\n\n    if (res.ok || expect.includes(res.status)) {\n      return json as T;\n    }\n\n    const envelope = json as { error?: { code?: ErrorCode; message?: string; param?: string | null } } | undefined;\n    const apiError = envelope?.error;\n    throw errorFromResponse(\n      res.status,\n      apiError?.code,\n      apiError?.message ?? `HTTP ${res.status}`,\n      apiError?.param ?? null,\n    );\n  }\n}\n\n/**\n * A handle on a started solve, returned by {@link NoneCap.solves.start}.\n *\n * The handle is the cancellable lifecycle object for one solve. It is a plain\n * object, not a promise: `await`ing it does nothing useful. Wait for the result\n * with {@link SolveHandle.result}, and cancel with {@link SolveHandle.cancel}.\n * You do not construct it yourself — `solves.start()` hands you one with `id`\n * already resolved.\n */\nexport class SolveHandle {\n  /** The id of the started solve, available as soon as `start()` resolved. */\n  readonly id: string;\n\n  readonly #client: NoneCap;\n  /** The latest solve state we have seen, from the create, polls, or cancel. */\n  #solve: Solve;\n  /**\n   * The cached TERMINAL outcome: resolves to the solved solve, or rejects with\n   * {@link SolveFailedError} if terminal-but-not-solved. Only ever set once the\n   * solve actually reaches a terminal state, so it is safe to replay forever. A\n   * timed-out wait does NOT settle this — it is retryable.\n   */\n  #terminal: Promise<Solve> | undefined;\n  /** The poll currently in flight, shared by concurrent result() callers. */\n  #inflight: Promise<Solve> | undefined;\n\n  constructor(client: NoneCap, solve: Solve) {\n    this.#client = client;\n    this.#solve = solve;\n    this.id = solve.id;\n  }\n\n  /** The last-known solve state for this handle. */\n  get solve(): Solve {\n    return this.#solve;\n  }\n\n  /**\n   * Long-poll until the solve is terminal, returning the solved solve. Throws\n   * {@link SolveFailedError} if it fails/expires/is cancelled, or\n   * {@link TimeoutError} on timeout (with `solveId`/`solve` attached so you can\n   * still {@link SolveHandle.cancel} it).\n   *\n   * Memoizes the *terminal* outcome: once the solve actually finishes, every\n   * later call returns that same settled result. A {@link TimeoutError} is not\n   * memoized — it just means this wait gave up, so a later call (e.g. with a\n   * larger `timeout`) resumes polling. Concurrent calls share one in-flight\n   * poll, so they never issue duplicate requests. The first caller's\n   * `timeout`/`signal` drive the shared poll; a later call starts a fresh one.\n   */\n  result(options: SolveHelperOptions = {}): Promise<Solve> {\n    if (this.#terminal) return this.#terminal;\n    if (this.#inflight) return this.#inflight;\n    const run = this.#poll(options).finally(() => {\n      // Free the slot so a retry can re-poll after a timeout; a terminal\n      // outcome is already memoized in #terminal and wins on the next call.\n      if (this.#inflight === run) this.#inflight = undefined;\n    });\n    this.#inflight = run;\n    return run;\n  }\n\n  /**\n   * Cancel the solve. Cancelled solves are never charged, so this is for clean\n   * shutdown / freeing slots / stopping early, not cost protection.\n   *\n   * If the solve already reached a terminal state the API answers 409; that is\n   * not an error a caller cares about, so this swallows {@link ConflictError}\n   * and returns the current solve state instead. A cancel that lands on a\n   * terminal state (cancelled, or whatever the 409-swallow read back) settles\n   * this handle's {@link SolveHandle.result}, so any in-flight or later wait\n   * stops polling and reflects that terminal state.\n   */\n  async cancel(options: { signal?: AbortSignal } = {}): Promise<Solve> {\n    try {\n      this.#solve = await this.#client.solves.cancel(this.id, options);\n    } catch (err) {\n      if (!(err instanceof ConflictError)) throw err;\n      // Already terminal — report the real state rather than the 409.\n      this.#solve = await this.#client.solves.retrieve(this.id, options);\n    }\n    if (!this.#terminal && isTerminal(this.#solve.status)) this.#cacheTerminal();\n    return this.#solve;\n  }\n\n  /**\n   * Build and memoize the terminal outcome from the current `#solve`. The\n   * precondition is that `#solve` is terminal and `#terminal` is unset.\n   */\n  #cacheTerminal(): Promise<Solve> {\n    const settled =\n      this.#solve.status === \"solved\"\n        ? Promise.resolve(this.#solve)\n        : Promise.reject(new SolveFailedError(this.#solve));\n    // Never let the memoized rejection surface as an unhandled rejection; real\n    // callers read it explicitly through result().\n    settled.catch(() => {});\n    this.#terminal = settled;\n    return settled;\n  }\n\n  async #poll(options: SolveHelperOptions): Promise<Solve> {\n    const timeout = options.timeout ?? 180_000;\n    const deadline = Date.now() + timeout;\n\n    for (;;) {\n      // cancel() (or a previous poll) may have already settled this handle.\n      if (this.#terminal) return this.#terminal;\n      if (isTerminal(this.#solve.status)) return this.#cacheTerminal();\n      if (Date.now() >= deadline) {\n        throw new TimeoutError(\n          `Solve ${this.id} did not finish within ${timeout}ms (last status: ${this.#solve.status}).`,\n          { solveId: this.id, solve: this.#solve },\n        );\n      }\n      this.#solve = await this.#client.solves.retrieve(this.id, {\n        wait: waitSeconds(deadline),\n        signal: options.signal,\n      });\n    }\n  }\n}\n\n/**\n * The `wait` value for the next long-poll: whole seconds until `deadline`,\n * clamped to the server's 1–90 window. The floor of 1 keeps the param valid,\n * so callers must decide whether the deadline has passed with the clock, not\n * with this return value.\n */\nfunction waitSeconds(deadline: number): number {\n  const remaining = Math.ceil((deadline - Date.now()) / 1000);\n  return Math.max(1, Math.min(MAX_WAIT_SECONDS, remaining));\n}\n\nfunction isAbort(err: unknown): boolean {\n  return err instanceof Error && err.name === \"AbortError\";\n}\n\n/** The fields of a report, ready for the wire: a `Date` becomes an ISO string. */\nfunction toWireFields(fields: Omit<FeedbackReport, \"solve_id\">): Record<string, unknown> {\n  const wire: Record<string, unknown> = { outcome: fields.outcome };\n  if (fields.estado !== undefined) wire.estado = fields.estado;\n  if (fields.reason !== undefined) wire.reason = fields.reason;\n  if (fields.reported_at !== undefined) {\n    wire.reported_at =\n      fields.reported_at instanceof Date ? fields.reported_at.toISOString() : fields.reported_at;\n  }\n  return wire;\n}\n\nfunction toWireReport(report: FeedbackReport): Record<string, unknown> {\n  const { solve_id, ...fields } = report;\n  return { solve_id, ...toWireFields(fields) };\n}\n"]}