nonecap 0.2.0 → 0.3.0

package/README.md

@@ -68,6 +68,55 @@ 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.
+
+If you used the bare `solve()` path and it throws `TimeoutError`, the error usually carries the in-flight `solveId` (and last-known `solve`) so you can still cancel it. 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.

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 };
@@ -129,6 +138,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: {
@@ -158,28 +186,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 +282,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));
@@ -287,6 +398,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":";;;AAMO,IAAM,YAAA,GAAN,cAA2B,KAAA,CAAM;AAAA;AAAA,EAE7B,IAAA;AAAA;AAAA,EAEA,MAAA;AAAA;AAAA,EAEA,KAAA;AAAA,EAET,WAAA,CACE,OAAA,EACA,IAAA,GAAqE,EAAC,EACtE;AACA,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,OAAO,GAAA,CAAA,MAAA,CAAW,IAAA;AACvB,IAAA,IAAA,CAAK,OAAO,IAAA,CAAK,IAAA;AACjB,IAAA,IAAA,CAAK,SAAS,IAAA,CAAK,MAAA;AACnB,IAAA,IAAA,CAAK,KAAA,GAAQ,KAAK,KAAA,IAAS,IAAA;AAE3B,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,GAAA,CAAA,MAAA,CAAW,SAAS,CAAA;AAAA,EAClD;AACF;AAGO,IAAM,mBAAA,GAAN,cAAkC,YAAA,CAAa;AAAC;AAGhD,IAAM,eAAA,GAAN,cAA8B,YAAA,CAAa;AAAC;AAG5C,IAAM,wBAAA,GAAN,cAAuC,YAAA,CAAa;AAAC;AAGrD,IAAM,eAAA,GAAN,cAA8B,YAAA,CAAa;AAAC;AAG5C,IAAM,aAAA,GAAN,cAA4B,YAAA,CAAa;AAAC;AAG1C,IAAM,aAAA,GAAN,cAA4B,YAAA,CAAa;AAAC;AAG1C,IAAM,cAAA,GAAN,cAA6B,YAAA,CAAa;AAAC;AAG3C,IAAM,QAAA,GAAN,cAAuB,YAAA,CAAa;AAAC;AAGrC,IAAM,eAAA,GAAN,cAA8B,YAAA,CAAa;AAAC;AAO5C,IAAM,gBAAA,GAAN,cAA+B,YAAA,CAAa;AAAA,EACxC,KAAA;AAAA,EAET,YAAY,KAAA,EAAc;AACxB,IAAA,MAAM,MAAA,GAAS,KAAA,CAAM,KAAA,GAAQ,CAAA,EAAG,KAAA,CAAM,KAAA,CAAM,IAAI,CAAA,EAAA,EAAK,KAAA,CAAM,KAAA,CAAM,OAAO,CAAA,CAAA,GAAK,KAAA,CAAM,MAAA;AACnF,IAAA,KAAA,CAAM,CAAA,MAAA,EAAS,MAAM,EAAE,CAAA,CAAA,EAAI,MAAM,MAAM,CAAA,EAAA,EAAK,MAAM,CAAA,CAAA,CAAA,EAAK;AAAA,MACrD,IAAA,EAAM,MAAA;AAAA,MACN,MAAA,EAAQ;AAAA,KACT,CAAA;AACD,IAAA,IAAA,CAAK,KAAA,GAAQ,KAAA;AAAA,EACf;AACF;AAGO,IAAM,YAAA,GAAN,cAA2B,YAAA,CAAa;AAAC;AAGzC,SAAS,iBAAA,CACd,MAAA,EACA,IAAA,EACA,OAAA,EACA,KAAA,EACc;AACd,EAAA,MAAM,IAAA,GAAO,EAAE,IAAA,EAAM,MAAA,EAAQ,KAAA,EAAM;AACnC,EAAA,QAAQ,IAAA;AAAM,IACZ,KAAK,cAAA;AACH,MAAA,OAAO,IAAI,mBAAA,CAAoB,OAAA,EAAS,IAAI,CAAA;AAAA,IAC9C,KAAK,WAAA;AAAA,IACL,KAAK,gBAAA;AACH,MAAA,OAAO,IAAI,eAAA,CAAgB,OAAA,EAAS,IAAI,CAAA;AAAA,IAC1C,KAAK,sBAAA;AACH,MAAA,OAAO,IAAI,wBAAA,CAAyB,OAAA,EAAS,IAAI,CAAA;AAAA,IACnD,KAAK,iBAAA;AAAA,IACL,KAAK,kBAAA;AACH,MAAA,OAAO,IAAI,eAAA,CAAgB,OAAA,EAAS,IAAI,CAAA;AAAA,IAC1C,KAAK,WAAA;AACH,MAAA,OAAO,IAAI,aAAA,CAAc,OAAA,EAAS,IAAI,CAAA;AAAA,IACxC,KAAK,UAAA;AACH,MAAA,OAAO,IAAI,aAAA,CAAc,OAAA,EAAS,IAAI,CAAA;AAAA,IACxC,KAAK,cAAA;AAAA,IACL,KAAK,4BAAA;AAAA,IACL,KAAK,iBAAA;AACH,MAAA,OAAO,IAAI,cAAA,CAAe,OAAA,EAAS,IAAI,CAAA;AAAA,IACzC;AACE,MAAA,OAAO,IAAI,QAAA,CAAS,OAAA,EAAS,IAAI,CAAA;AAAA;AAEvC;;;ACxFA,IAAM,gBAAA,GAAmB,yBAAA;AAEzB,IAAM,gBAAA,GAAmB,EAAA;AACzB,IAAM,QAAA,uBAAyC,GAAA,CAAI;AAAA,EACjD,QAAA;AAAA,EACA,QAAA;AAAA,EACA,WAAA;AAAA,EACA;AACF,CAAC,CAAA;AAGM,SAAS,WAAW,MAAA,EAA8B;AACvD,EAAA,OAAO,QAAA,CAAS,IAAI,MAAM,CAAA;AAC5B;AAiEO,IAAM,UAAN,MAAc;AAAA,EACV,OAAA;AAAA,EACA,QAAA;AAAA,EACA,QAAA;AAAA,EACA,MAAA;AAAA,EAET,YAAY,OAAA,EAAyB;AACnC,IAAA,IAAI,CAAC,OAAA,IAAW,CAAC,OAAA,CAAQ,MAAA,EAAQ;AAC/B,MAAA,MAAM,IAAI,YAAA;AAAA,QACR;AAAA,OACF;AAAA,IACF;AACA,IAAA,IAAA,CAAK,UAAU,OAAA,CAAQ,MAAA;AACvB,IAAA,IAAA,CAAK,YAAY,OAAA,CAAQ,OAAA,IAAW,gBAAA,EAAkB,OAAA,CAAQ,QAAQ,EAAE,CAAA;AACxE,IAAA,IAAA,CAAK,QAAA,GAAW,QAAQ,OAAA,IAAW,GAAA;AACnC,IAAA,MAAM,CAAA,GAAI,OAAA,CAAQ,KAAA,IAAU,UAAA,CAAW,KAAA;AACvC,IAAA,IAAI,CAAC,CAAA,EAAG;AACN,MAAA,MAAM,IAAI,YAAA;AAAA,QACR;AAAA,OACF;AAAA,IACF;AACA,IAAA,IAAA,CAAK,MAAA,GAAS,CAAA;AAAA,EAChB;AAAA;AAAA,EAGS,MAAA,GAAS;AAAA;AAAA,IAEhB,MAAA,EAAQ,CAAC,MAAA,EAA2B,OAAA,GAAuB,EAAC,KAC1D,IAAA,CAAK,QAAA,CAAgB,MAAA,EAAQ,YAAA,EAAc;AAAA,MACzC,IAAA,EAAM,MAAA;AAAA,MACN,KAAA,EAAO,EAAE,IAAA,EAAM,OAAA,CAAQ,IAAA,EAAK;AAAA,MAC5B,QAAQ,OAAA,CAAQ,MAAA;AAAA,MAChB,OAAA,EAAS,IAAA,CAAK,eAAA,CAAgB,OAAA,CAAQ,IAAI,CAAA;AAAA,MAC1C,MAAA,EAAQ,CAAC,GAAG;AAAA,KACb,CAAA;AAAA;AAAA,IAGH,QAAA,EAAU,CAAC,EAAA,EAAY,OAAA,GAAuB,EAAC,KAC7C,IAAA,CAAK,QAAA,CAAgB,KAAA,EAAO,CAAA,WAAA,EAAc,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAA,EAAI;AAAA,MAClE,KAAA,EAAO,EAAE,IAAA,EAAM,OAAA,CAAQ,IAAA,EAAK;AAAA,MAC5B,QAAQ,OAAA,CAAQ,MAAA;AAAA,MAChB,OAAA,EAAS,IAAA,CAAK,eAAA,CAAgB,OAAA,CAAQ,IAAI,CAAA;AAAA,MAC1C,MAAA,EAAQ,CAAC,GAAG;AAAA,KACb,CAAA;AAAA;AAAA,IAGH,MAAA,EAAQ,CAAC,EAAA,EAAY,OAAA,GAAoC,EAAC,KACxD,IAAA,CAAK,QAAA,CAAgB,QAAA,EAAU,CAAA,WAAA,EAAc,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAA,EAAI;AAAA,MACrE,QAAQ,OAAA,CAAQ;AAAA,KACjB,CAAA;AAAA;AAAA,IAGH,IAAA,EAAM,CAAC,MAAA,GAA0B,EAAC,EAAG,OAAA,GAAoC,EAAC,KACxE,IAAA,CAAK,QAAA,CAAoB,KAAA,EAAO,YAAA,EAAc;AAAA,MAC5C,KAAA,EAAO;AAAA,QACL,OAAO,MAAA,CAAO,KAAA;AAAA,QACd,gBAAgB,MAAA,CAAO,cAAA;AAAA,QACvB,QAAQ,MAAA,CAAO,MAAA;AAAA,QACf,MAAM,MAAA,CAAO;AAAA,OACf;AAAA,MACA,QAAQ,OAAA,CAAQ;AAAA,KACjB,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IASH,OAAA,EAAS,CACP,MAAA,GAA0B,EAAC,EAC3B,OAAA,GAAoC,EAAC,KACJ,IAAA,CAAK,QAAA,CAAS,MAAA,EAAQ,OAAO;AAAA,GAClE;AAAA;AAAA,EAGA,EAAA,CAAG,OAAA,GAAoC,EAAC,EAAqB;AAC3D,IAAA,OAAO,IAAA,CAAK,SAAkB,KAAA,EAAO,QAAA,EAAU,EAAE,MAAA,EAAQ,OAAA,CAAQ,QAAQ,CAAA;AAAA,EAC3E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,KAAA,CAAM,MAAA,EAA2B,OAAA,GAA8B,EAAC,EAAmB;AACvF,IAAA,MAAM,OAAA,GAAU,QAAQ,OAAA,IAAW,IAAA;AACnC,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,GAAA,EAAI,GAAI,OAAA;AAE9B,IAAA,IAAI,KAAA,GAAQ,MAAM,IAAA,CAAK,MAAA,CAAO,OAAO,MAAA,EAAQ;AAAA,MAC3C,IAAA,EAAM,YAAY,QAAQ,CAAA;AAAA,MAC1B,QAAQ,OAAA,CAAQ;AAAA,KACjB,CAAA;AAED,IAAA,OAAO,CAAC,UAAA,CAAW,KAAA,CAAM,MAAM,CAAA,EAAG;AAChC,MAAA,IAAI,IAAA,CAAK,GAAA,EAAI,IAAK,QAAA,EAAU;AAC1B,QAAA,MAAM,IAAI,YAAA;AAAA,UACR,SAAS,KAAA,CAAM,EAAE,0BAA0B,OAAO,CAAA,iBAAA,EAAoB,MAAM,MAAM,CAAA,EAAA,CAAA;AAAA,UAClF,EAAE,MAAM,MAAA;AAAU,SACpB;AAAA,MACF;AACA,MAAA,KAAA,GAAQ,MAAM,IAAA,CAAK,MAAA,CAAO,QAAA,CAAS,MAAM,EAAA,EAAI;AAAA,QAC3C,IAAA,EAAM,YAAY,QAAQ,CAAA;AAAA,QAC1B,QAAQ,OAAA,CAAQ;AAAA,OACjB,CAAA;AAAA,IACH;AAEA,IAAA,IAAI,MAAM,MAAA,KAAW,QAAA,EAAU,MAAM,IAAI,iBAAiB,KAAK,CAAA;AAC/D,IAAA,OAAO,KAAA;AAAA,EACT;AAAA;AAAA,EAIA,gBAAgB,IAAA,EAAmC;AACjD,IAAA,IAAI,IAAA,KAAS,QAAW,OAAO,MAAA;AAE/B,IAAA,OAAO,OAAO,GAAA,GAAO,IAAA;AAAA,EACvB;AAAA,EAEA,OAAO,QAAA,CACL,MAAA,EACA,OAAA,EAC8B;AAC9B,IAAA,IAAI,SAAS,MAAA,CAAO,cAAA;AACpB,IAAA,WAAS;AACP,MAAA,MAAM,IAAA,GAAO,MAAM,IAAA,CAAK,MAAA,CAAO,IAAA,CAAK,EAAE,GAAG,MAAA,EAAQ,cAAA,EAAgB,MAAA,EAAO,EAAG,OAAO,CAAA;AAClF,MAAA,KAAA,MAAW,KAAA,IAAS,IAAA,CAAK,IAAA,EAAM,MAAM,KAAA;AACrC,MAAA,IAAI,CAAC,IAAA,CAAK,QAAA,IAAY,IAAA,CAAK,IAAA,CAAK,WAAW,CAAA,EAAG;AAC9C,MAAA,MAAA,GAAS,KAAK,IAAA,CAAK,IAAA,CAAK,IAAA,CAAK,MAAA,GAAS,CAAC,CAAA,CAAG,EAAA;AAAA,IAC5C;AAAA,EACF;AAAA,EAEA,MAAM,QAAA,CAAY,MAAA,EAAgB,IAAA,EAAc,OAAA,GAA0B,EAAC,EAAe;AACxF,IAAA,MAAM,GAAA,GAAM,IAAI,GAAA,CAAI,IAAA,CAAK,WAAW,IAAI,CAAA;AACxC,IAAA,IAAI,QAAQ,KAAA,EAAO;AACjB,MAAA,KAAA,MAAW,CAAC,KAAK,KAAK,CAAA,IAAK,OAAO,OAAA,CAAQ,OAAA,CAAQ,KAAK,CAAA,EAAG;AACxD,QAAA,IAAI,KAAA,KAAU,MAAA,IAAa,KAAA,KAAU,EAAA,EAAI,GAAA,CAAI,aAAa,GAAA,CAAI,GAAA,EAAK,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,MAClF;AAAA,IACF;AAEA,IAAA,MAAM,OAAA,GAAkC;AAAA,MACtC,aAAA,EAAe,CAAA,OAAA,EAAU,IAAA,CAAK,OAAO,CAAA,CAAA;AAAA,MACrC,MAAA,EAAQ;AAAA,KACV;AACA,IAAA,IAAI,QAAA;AACJ,IAAA,IAAI,OAAA,CAAQ,SAAS,MAAA,EAAW;AAC9B,MAAA,OAAA,CAAQ,cAAc,CAAA,GAAI,kBAAA;AAC1B,MAAA,QAAA,GAAW,IAAA,CAAK,SAAA,CAAU,OAAA,CAAQ,IAAI,CAAA;AAAA,IACxC;AAEA,IAAA,MAAM,UAAA,GAAa,IAAI,eAAA,EAAgB;AACvC,IAAA,MAAM,SAAA,GAAY,OAAA,CAAQ,OAAA,IAAW,IAAA,CAAK,QAAA;AAC1C,IAAA,MAAM,KAAA,GAAQ,UAAA,CAAW,MAAM,UAAA,CAAW,KAAA,CAAM,IAAI,YAAA,CAAa,CAAA,wBAAA,EAA2B,SAAS,CAAA,GAAA,CAAK,CAAC,CAAA,EAAG,SAAS,CAAA;AACvH,IAAA,MAAM,UAAU,MAAM,UAAA,CAAW,KAAA,CAAM,OAAA,CAAQ,QAAQ,MAAM,CAAA;AAC7D,IAAA,IAAI,QAAQ,MAAA,EAAQ;AAClB,MAAA,IAAI,OAAA,CAAQ,MAAA,CAAO,OAAA,EAAS,OAAA,EAAQ;AAAA,WAC/B,OAAA,CAAQ,OAAO,gBAAA,CAAiB,OAAA,EAAS,SAAS,EAAE,IAAA,EAAM,MAAM,CAAA;AAAA,IACvE;AAEA,IAAA,IAAI,GAAA;AACJ,IAAA,IAAI;AACF,MAAA,GAAA,GAAM,MAAM,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,UAAS,EAAG;AAAA,QACtC,MAAA;AAAA,QACA,OAAA;AAAA,QACA,IAAA,EAAM,QAAA;AAAA,QACN,QAAQ,UAAA,CAAW;AAAA,OACpB,CAAA;AAAA,IACH,SAAS,GAAA,EAAK;AACZ,MAAA,IAAI,GAAA,YAAe,cAAc,MAAM,GAAA;AACvC,MAAA,IAAI,OAAA,CAAQ,GAAG,CAAA,EAAG;AAEhB,QAAA,IAAI,OAAA,CAAQ,MAAA,EAAQ,OAAA,EAAS,MAAM,OAAA,CAAQ,MAAA,CAAO,MAAA,YAAkB,KAAA,GAChE,OAAA,CAAQ,MAAA,CAAO,MAAA,GACf,IAAI,aAAa,kBAAkB,CAAA;AACvC,QAAA,MAAM,IAAI,YAAA,CAAa,CAAA,wBAAA,EAA2B,SAAS,CAAA,GAAA,CAAK,CAAA;AAAA,MAClE;AACA,MAAA,MAAM,IAAI,eAAA;AAAA,QACR,CAAA,mCAAA,EAAsC,IAAA,CAAK,QAAQ,CAAA,EAAA,EAAM,IAAc,OAAO,CAAA;AAAA,OAChF;AAAA,IACF,CAAA,SAAE;AACA,MAAA,YAAA,CAAa,KAAK,CAAA;AAClB,MAAA,OAAA,CAAQ,MAAA,EAAQ,mBAAA,CAAoB,OAAA,EAAS,OAAO,CAAA;AAAA,IACtD;AAEA,IAAA,OAAO,KAAK,MAAA,CAAU,GAAA,EAAK,OAAA,CAAQ,MAAA,IAAU,EAAE,CAAA;AAAA,EACjD;AAAA,EAEA,MAAM,MAAA,CAAU,GAAA,EAAe,MAAA,EAA8B;AAC3D,IAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,IAAA,EAAK;AAC5B,IAAA,IAAI,IAAA;AACJ,IAAA,IAAI,IAAA,EAAM;AACR,MAAA,IAAI;AACF,QAAA,IAAA,GAAO,IAAA,CAAK,MAAM,IAAI,CAAA;AAAA,MACxB,CAAA,CAAA,MAAQ;AACN,QAAA,MAAM,IAAI,QAAA;AAAA,UACR,CAAA,mCAAA,EAAsC,IAAI,MAAM,CAAA,GAAA,EAAM,KAAK,KAAA,CAAM,CAAA,EAAG,GAAG,CAAC,CAAA,CAAA;AAAA,UACxE,EAAE,MAAA,EAAQ,GAAA,CAAI,MAAA;AAAO,SACvB;AAAA,MACF;AAAA,IACF;AAEA,IAAA,IAAI,IAAI,EAAA,IAAM,MAAA,CAAO,QAAA,CAAS,GAAA,CAAI,MAAM,CAAA,EAAG;AACzC,MAAA,OAAO,IAAA;AAAA,IACT;AAEA,IAAA,MAAM,QAAA,GAAW,IAAA;AACjB,IAAA,MAAM,WAAW,QAAA,EAAU,KAAA;AAC3B,IAAA,MAAM,iBAAA;AAAA,MACJ,GAAA,CAAI,MAAA;AAAA,MACJ,QAAA,EAAU,IAAA;AAAA,MACV,QAAA,EAAU,OAAA,IAAW,CAAA,KAAA,EAAQ,GAAA,CAAI,MAAM,CAAA,CAAA;AAAA,MACvC,UAAU,KAAA,IAAS;AAAA,KACrB;AAAA,EACF;AACF;AAQA,SAAS,YAAY,QAAA,EAA0B;AAC7C,EAAA,MAAM,YAAY,IAAA,CAAK,IAAA,CAAA,CAAM,WAAW,IAAA,CAAK,GAAA,MAAS,GAAI,CAAA;AAC1D,EAAA,OAAO,KAAK,GAAA,CAAI,CAAA,EAAG,KAAK,GAAA,CAAI,gBAAA,EAAkB,SAAS,CAAC,CAAA;AAC1D;AAEA,SAAS,QAAQ,GAAA,EAAuB;AACtC,EAAA,OAAO,GAAA,YAAe,KAAA,IAAS,GAAA,CAAI,IAAA,KAAS,YAAA;AAC9C","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      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  ConflictError,\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} 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  /** 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"]}

package/dist/index.d.cts

@@ -138,7 +138,7 @@ interface WaitOptions {
     /** Abort the request. */
     signal?: AbortSignal;
 }
-/** Options for {@link NoneCap.solve}. */
+/** Options for {@link NoneCap.solve} and {@link SolveHandle.result}. */
 interface SolveHelperOptions {
     /**
      * Give up after this many milliseconds and throw {@link TimeoutError}.
@@ -148,6 +148,11 @@ interface SolveHelperOptions {
     /** Abort waiting. */
     signal?: AbortSignal;
 }
+/** Options for {@link NoneCap.solves.start}. */
+interface SolveStartOptions {
+    /** Abort the submission. */
+    signal?: AbortSignal;
+}
 /**
  * The NoneCap API client.
  *
@@ -169,6 +174,22 @@ declare class NoneCap {
         cancel: (id: string, options?: {
             signal?: AbortSignal;
         }) => Promise<Solve>;
+        /**
+         * 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: (params: SolveCreateParams, options?: SolveStartOptions) => Promise<SolveHandle>;
         /** Fetch one page of solves. */
         list: (params?: SolveListParams, options?: {
             signal?: AbortSignal;
@@ -194,9 +215,58 @@ declare class NoneCap {
      * 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}.
      */
     solve(params: SolveCreateParams, options?: SolveHelperOptions): Promise<Solve>;
 }
+/**
+ * A handle on a started solve, returned by {@link NoneCap.solves.start}.
+ *
+ * The handle is the cancellable lifecycle object for one solve. It is a plain
+ * object, not a promise: `await`ing it does nothing useful. Wait for the result
+ * with {@link SolveHandle.result}, and cancel with {@link SolveHandle.cancel}.
+ * You do not construct it yourself — `solves.start()` hands you one with `id`
+ * already resolved.
+ */
+declare class SolveHandle {
+    #private;
+    /** The id of the started solve, available as soon as `start()` resolved. */
+    readonly id: string;
+    constructor(client: NoneCap, solve: Solve);
+    /** The last-known solve state for this handle. */
+    get solve(): 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?: SolveHelperOptions): Promise<Solve>;
+    /**
+     * 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.
+     */
+    cancel(options?: {
+        signal?: AbortSignal;
+    }): Promise<Solve>;
+}
 
 /**
  * Base class for every error this library throws. Catch `NoneCapError` to
@@ -251,8 +321,24 @@ declare class SolveFailedError extends NoneCapError {
     readonly solve: Solve;
     constructor(solve: Solve);
 }
-/** Thrown by {@link NoneCap.solve} when the client-side timeout elapses first. */
+/**
+ * Thrown by {@link NoneCap.solve} (and {@link SolveHandle.result}) when the
+ * client-side timeout elapses first. When the timeout came from waiting on a
+ * solve, `solveId` and the last-known `solve` are attached so you can still
+ * cancel the in-flight solve. They are `undefined` for transport-level timeouts.
+ */
 declare class TimeoutError extends NoneCapError {
+    /** The id of the in-flight solve, when the timeout came from a solve wait. */
+    readonly solveId: string | undefined;
+    /** The last-known solve state, so you can cancel it after a wait timed out. */
+    readonly solve: Solve | undefined;
+    constructor(message: string, opts?: {
+        code?: ErrorCode;
+        status?: number;
+        param?: string | null;
+        solveId?: string;
+        solve?: Solve;
+    });
 }
 
-export { APIError, type Account, AuthenticationError, ConflictError, ConnectionError, type ErrorCode, type ErrorEnvelope, type FetchLike, InsufficientCreditsError, NoneCap, NoneCapError, type NoneCapOptions, NotFoundError, PermissionError, type Proxy, RateLimitError, type Solve, type SolveCreateParams, type SolveError, SolveFailedError, type SolveHelperOptions, type SolveList, type SolveListParams, type SolveStatus, type SolveType, TimeoutError, ValidationError, type WaitOptions, isTerminal };
+export { APIError, type Account, AuthenticationError, ConflictError, ConnectionError, type ErrorCode, type ErrorEnvelope, type FetchLike, InsufficientCreditsError, NoneCap, NoneCapError, type NoneCapOptions, NotFoundError, PermissionError, type Proxy, RateLimitError, type Solve, type SolveCreateParams, type SolveError, SolveFailedError, SolveHandle, type SolveHelperOptions, type SolveList, type SolveListParams, type SolveStartOptions, type SolveStatus, type SolveType, TimeoutError, ValidationError, type WaitOptions, isTerminal };

package/dist/index.d.ts

@@ -138,7 +138,7 @@ interface WaitOptions {
     /** Abort the request. */
     signal?: AbortSignal;
 }
-/** Options for {@link NoneCap.solve}. */
+/** Options for {@link NoneCap.solve} and {@link SolveHandle.result}. */
 interface SolveHelperOptions {
     /**
      * Give up after this many milliseconds and throw {@link TimeoutError}.
@@ -148,6 +148,11 @@ interface SolveHelperOptions {
     /** Abort waiting. */
     signal?: AbortSignal;
 }
+/** Options for {@link NoneCap.solves.start}. */
+interface SolveStartOptions {
+    /** Abort the submission. */
+    signal?: AbortSignal;
+}
 /**
  * The NoneCap API client.
  *
@@ -169,6 +174,22 @@ declare class NoneCap {
         cancel: (id: string, options?: {
             signal?: AbortSignal;
         }) => Promise<Solve>;
+        /**
+         * 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: (params: SolveCreateParams, options?: SolveStartOptions) => Promise<SolveHandle>;
         /** Fetch one page of solves. */
         list: (params?: SolveListParams, options?: {
             signal?: AbortSignal;
@@ -194,9 +215,58 @@ declare class NoneCap {
      * 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}.
      */
     solve(params: SolveCreateParams, options?: SolveHelperOptions): Promise<Solve>;
 }
+/**
+ * A handle on a started solve, returned by {@link NoneCap.solves.start}.
+ *
+ * The handle is the cancellable lifecycle object for one solve. It is a plain
+ * object, not a promise: `await`ing it does nothing useful. Wait for the result
+ * with {@link SolveHandle.result}, and cancel with {@link SolveHandle.cancel}.
+ * You do not construct it yourself — `solves.start()` hands you one with `id`
+ * already resolved.
+ */
+declare class SolveHandle {
+    #private;
+    /** The id of the started solve, available as soon as `start()` resolved. */
+    readonly id: string;
+    constructor(client: NoneCap, solve: Solve);
+    /** The last-known solve state for this handle. */
+    get solve(): 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?: SolveHelperOptions): Promise<Solve>;
+    /**
+     * 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.
+     */
+    cancel(options?: {
+        signal?: AbortSignal;
+    }): Promise<Solve>;
+}
 
 /**
  * Base class for every error this library throws. Catch `NoneCapError` to
@@ -251,8 +321,24 @@ declare class SolveFailedError extends NoneCapError {
     readonly solve: Solve;
     constructor(solve: Solve);
 }
-/** Thrown by {@link NoneCap.solve} when the client-side timeout elapses first. */
+/**
+ * Thrown by {@link NoneCap.solve} (and {@link SolveHandle.result}) when the
+ * client-side timeout elapses first. When the timeout came from waiting on a
+ * solve, `solveId` and the last-known `solve` are attached so you can still
+ * cancel the in-flight solve. They are `undefined` for transport-level timeouts.
+ */
 declare class TimeoutError extends NoneCapError {
+    /** The id of the in-flight solve, when the timeout came from a solve wait. */
+    readonly solveId: string | undefined;
+    /** The last-known solve state, so you can cancel it after a wait timed out. */
+    readonly solve: Solve | undefined;
+    constructor(message: string, opts?: {
+        code?: ErrorCode;
+        status?: number;
+        param?: string | null;
+        solveId?: string;
+        solve?: Solve;
+    });
 }
 
-export { APIError, type Account, AuthenticationError, ConflictError, ConnectionError, type ErrorCode, type ErrorEnvelope, type FetchLike, InsufficientCreditsError, NoneCap, NoneCapError, type NoneCapOptions, NotFoundError, PermissionError, type Proxy, RateLimitError, type Solve, type SolveCreateParams, type SolveError, SolveFailedError, type SolveHelperOptions, type SolveList, type SolveListParams, type SolveStatus, type SolveType, TimeoutError, ValidationError, type WaitOptions, isTerminal };
+export { APIError, type Account, AuthenticationError, ConflictError, ConnectionError, type ErrorCode, type ErrorEnvelope, type FetchLike, InsufficientCreditsError, NoneCap, NoneCapError, type NoneCapOptions, NotFoundError, PermissionError, type Proxy, RateLimitError, type Solve, type SolveCreateParams, type SolveError, SolveFailedError, SolveHandle, type SolveHelperOptions, type SolveList, type SolveListParams, type SolveStartOptions, type SolveStatus, type SolveType, TimeoutError, ValidationError, type WaitOptions, isTerminal };

package/dist/index.js

@@ -45,6 +45,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 };
@@ -127,6 +136,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: {
@@ -156,28 +184,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) {
@@ -266,6 +280,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));
@@ -274,6 +385,6 @@ function isAbort(err) {
   return err instanceof Error && err.name === "AbortError";
 }
 
-export { APIError, AuthenticationError, ConflictError, ConnectionError, InsufficientCreditsError, NoneCap, NoneCapError, NotFoundError, PermissionError, RateLimitError, SolveFailedError, TimeoutError, ValidationError, isTerminal };
+export { APIError, AuthenticationError, ConflictError, ConnectionError, InsufficientCreditsError, NoneCap, NoneCapError, NotFoundError, PermissionError, RateLimitError, SolveFailedError, SolveHandle, TimeoutError, ValidationError, isTerminal };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.js","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.js","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      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  ConflictError,\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} 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  /** 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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nonecap",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Official TypeScript client for the NoneCap hCaptcha solving API.",
   "type": "module",
   "license": "MIT",