@codespar/sdk 0.11.0 → 0.12.0

package/README.md

@@ -158,6 +158,8 @@ const result = await loop(session, {
 | `session.mcp` | MCP transport URL and headers (when using managed runtime) |
 | `session.close()` | Close session |
 
+For everything the API exposes over REST beyond the session surface, see [REST client generated from the OpenAPI document](#rest-client-generated-from-the-openapi-document).
+
 ### Free functions
 
 `tools`, `findTools`, and `loop` are free functions that accept any `SessionBase` — they work with the managed runtime, Managed Agents sessions, and custom runtimes alike.
@@ -168,6 +170,73 @@ const result = await loop(session, {
 | `findTools(session, query)` | Search tools by name or description |
 | `loop(session, config)` | Run a Complete Loop workflow |
 
+## REST client generated from the OpenAPI document
+
+`cs.api` reaches every operation the API publishes at
+[`https://api.codespar.dev/openapi.json`](https://api.codespar.dev/openapi.json):
+215 operations across 175 paths at the snapshot this version ships. No
+method is written by hand. The document is committed as
+`openapi-snapshot.json`, the types under `src/generated/` are produced
+from it with openapi-typescript, and the client is typed by path and
+method: a path that does not declare the method does not compile, a
+missing required path parameter or body field does not compile, and the
+result is the documented 2xx shape.
+
+```typescript
+import { CodeSpar } from "@codespar/sdk";
+
+const cs = new CodeSpar({ apiKey: process.env.CODESPAR_API_KEY });
+
+// 1. List wallets in the project the key is bound to.
+const wallets = await cs.api.get("/v1/wallets");
+
+// 2. Create a payment from a wallet. The gateway answers 200 (completed),
+//    402 (requires approval), 403 (denied) or 422 (failed) with the same
+//    body shape, so read it with response() and branch on status.
+const payment = await cs.api.response("post", "/v1/wallets/{id}/execute", {
+  path: { id: "wal_example" },
+  body: {
+    amount: 1,
+    currency: "BRL",
+    recipient: "recipient@example.com",
+    description: "Example payment",
+    mandate_id: "mnd_example",
+  },
+});
+if (payment.status === 402) {
+  console.log("approval needed", payment.data);
+}
+
+// 3. Read one agentic receipt by id.
+const receipt = await cs.api.get("/v1/consumers/receipts/{id}", {
+  path: { id: "rcpt_example" },
+});
+console.log(receipt.state); // "paid" | "delivered" | "exception" | "voided"
+```
+
+`get`/`post`/`put`/`patch`/`delete` and `request(method, path, options)`
+return the documented 2xx data and throw `CodesparApiError` on any other
+status (parsed body on `e.body`, same as the session methods).
+`response(method, path, options)` returns `{ status, ok, data, response }`
+for every status the document lists, discriminated on `status`. Options
+carry `path`, `query`, `header` and `body` exactly as the document
+declares them, plus the SDK-wide per-call `timeout` and `signal`.
+Operations documented as `text/event-stream` resolve to the raw
+`Response` once headers arrive.
+
+The client only knows what the document says. A parameter a route
+accepts but does not declare is not typed here; the fix is in the
+document, not in this package. `createApiClient(config)` builds the same
+client without a `CodeSpar` instance, and `ApiClient.operations()` lists
+what it reaches.
+
+Keeping it current: `npm run sdk:spec:refresh` (repo root) re-fetches
+the document and regenerates; `npm run sdk:spec:check` fails when the
+snapshot was edited by hand, when the generated files do not match the
+snapshot, or when the served document no longer matches the snapshot.
+The test suite pins the first two and dispatches all 215 operations
+through the client.
+
 ## Migrating from 0.2.x
 
 `tools`, `findTools`, and `loop` moved from session instance methods to free functions in 0.3.0.

package/dist/__tests__/abort.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=abort.test.d.ts.map

package/dist/__tests__/abort.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/abort.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/abort.test.js

@@ -0,0 +1,70 @@
+import { describe, it, expect, vi, afterEach } from "vitest";
+import { mergeSignals, timeoutSignal } from "../internal/abort.js";
+import { TimeoutError } from "../errors.js";
+afterEach(() => vi.useRealTimers());
+describe("mergeSignals", () => {
+    it("aborts when any input signal aborts, with that signal's reason", () => {
+        const a = new AbortController();
+        const b = new AbortController();
+        const { signal } = mergeSignals([a.signal, b.signal]);
+        expect(signal.aborted).toBe(false);
+        const reason = new Error("from-b");
+        b.abort(reason);
+        expect(signal.aborted).toBe(true);
+        expect(signal.reason).toBe(reason);
+    });
+    it("is already aborted if an input is already aborted", () => {
+        const a = new AbortController();
+        a.abort(new Error("pre"));
+        const { signal } = mergeSignals([a.signal]);
+        expect(signal.aborted).toBe(true);
+    });
+    it("cleanup() detaches listeners and does not abort the merged signal", () => {
+        const a = new AbortController();
+        const { signal, cleanup } = mergeSignals([a.signal]);
+        cleanup();
+        a.abort(new Error("late"));
+        expect(signal.aborted).toBe(false);
+    });
+    it("forwards the reason when an input is already aborted", () => {
+        const a = new AbortController();
+        const pre = new Error("pre-reason");
+        a.abort(pre);
+        const { signal } = mergeSignals([a.signal]);
+        expect(signal.aborted).toBe(true);
+        expect(signal.reason).toBe(pre);
+    });
+    it("returns a never-aborting signal for an empty or all-undefined input", () => {
+        const { signal: s1 } = mergeSignals([]);
+        const { signal: s2 } = mergeSignals([undefined]);
+        expect(s1.aborted).toBe(false);
+        expect(s2.aborted).toBe(false);
+    });
+});
+describe("timeoutSignal", () => {
+    it("aborts after the given ms with a TimeoutError-named reason", () => {
+        vi.useFakeTimers();
+        const { signal } = timeoutSignal(1000);
+        expect(signal.aborted).toBe(false);
+        vi.advanceTimersByTime(1000);
+        expect(signal.aborted).toBe(true);
+        expect(signal.reason.name).toBe("TimeoutError");
+    });
+    it("clear() prevents the abort", () => {
+        vi.useFakeTimers();
+        const { signal, clear } = timeoutSignal(1000);
+        clear();
+        vi.advanceTimersByTime(5000);
+        expect(signal.aborted).toBe(false);
+    });
+});
+describe("TimeoutError", () => {
+    it("is an Error subclass with name TimeoutError and a timeoutMs field", () => {
+        const e = new TimeoutError(1234);
+        expect(e).toBeInstanceOf(Error);
+        expect(e.name).toBe("TimeoutError");
+        expect(e.timeoutMs).toBe(1234);
+        expect(e.message).toMatch(/1234/);
+    });
+});
+//# sourceMappingURL=abort.test.js.map

package/dist/__tests__/abort.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.test.js","sourceRoot":"","sources":["../../src/__tests__/abort.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/api-client.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The generated REST client: every operation of the snapshot is
+ * reachable (URL, method, content types all come from the generated
+ * table), and the transport behaves like the rest of the SDK.
+ */
+export {};
+//# sourceMappingURL=api-client.test.d.ts.map

package/dist/__tests__/api-client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/api-client.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/__tests__/api-client.test.js

@@ -0,0 +1,286 @@
+/**
+ * The generated REST client: every operation of the snapshot is
+ * reachable (URL, method, content types all come from the generated
+ * table), and the transport behaves like the rest of the SDK.
+ */
+import { afterEach, describe, expect, expectTypeOf, it, vi } from "vitest";
+import { ApiClient, createApiClient } from "../api/client.js";
+import { API_OPERATIONS } from "../generated/operations.js";
+import { CodeSpar } from "../index.js";
+import { CodesparApiError, TimeoutError } from "../errors.js";
+const BASE = "https://api.example.test";
+const KEY = "csk_test_example";
+function stubFetch(respond = () => json({})) {
+    const calls = [];
+    vi.stubGlobal("fetch", async (url, init) => {
+        const call = { url, init };
+        calls.push(call);
+        return respond(call);
+    });
+    return calls;
+}
+function json(body, status = 200) {
+    return new Response(JSON.stringify(body), {
+        status,
+        headers: { "content-type": "application/json; charset=utf-8" },
+    });
+}
+function client(extra = {}) {
+    return createApiClient({ baseUrl: BASE, apiKey: KEY, timeout: 5000, ...extra });
+}
+afterEach(() => {
+    vi.unstubAllGlobals();
+});
+describe("coverage: every operation in the generated table is dispatchable", () => {
+    it("reaches all operations of the snapshot with the documented method, URL and content types", async () => {
+        const calls = stubFetch((call) => call.init.headers && call.init.headers.Accept === "text/event-stream"
+            ? new Response("event: done\ndata: {}\n\n", {
+                status: 200,
+                headers: { "content-type": "text/event-stream" },
+            })
+            : json({ ok: true }));
+        const api = client();
+        let reached = 0;
+        for (const row of API_OPERATIONS) {
+            const names = [...row.path.matchAll(/\{([^}]+)\}/g)].map((m) => m[1]);
+            const pathParams = Object.fromEntries(names.map((n) => [n, `${n}-value`]));
+            const expectedUrl = BASE + row.path.replace(/\{([^}]+)\}/g, (_, n) => encodeURIComponent(`${n}-value`));
+            const before = calls.length;
+            const result = (await api.response(row.method, row.path, {
+                path: pathParams,
+                body: row.body ? { example: "value" } : undefined,
+            }));
+            expect(calls.length, `${row.method} ${row.path} made one request`).toBe(before + 1);
+            const call = calls[before];
+            expect(call.url, `${row.method} ${row.path} URL`).toBe(expectedUrl);
+            expect(call.init.method, `${row.method} ${row.path} method`).toBe(row.method.toUpperCase());
+            const headers = call.init.headers;
+            expect(headers.Authorization).toBe(`Bearer ${KEY}`);
+            if (row.accept)
+                expect(headers.Accept, `${row.method} ${row.path} Accept`).toBe(row.accept);
+            else
+                expect(headers.Accept).toBeUndefined();
+            if (row.body) {
+                expect(headers["Content-Type"], `${row.method} ${row.path} Content-Type`).toBe(row.body);
+                expect(call.init.body).toBeDefined();
+            }
+            else {
+                expect(call.init.body).toBeUndefined();
+            }
+            expect(result.ok).toBe(true);
+            reached += 1;
+        }
+        expect(reached).toBe(API_OPERATIONS.length);
+        // The number the snapshot carries. Stated here so a snapshot refresh that
+        // drops routes has to change this line on purpose. 213 at #139; 215 after
+        // the 2026-09-10 refresh (`/v1/fees`, `/v1/fees/movimentar`).
+        expect(API_OPERATIONS.length).toBe(215);
+    });
+    it("refuses a method/path pair the document does not declare, before any request", async () => {
+        const calls = stubFetch();
+        const api = client();
+        await expect(api.request("get", "/v1/not-in-the-document")).rejects.toThrow(/not an operation of the OpenAPI document/);
+        await expect(api.request("put", "/v1/wallets")).rejects.toThrow(/PUT \/v1\/wallets is not/);
+        expect(calls).toHaveLength(0);
+    });
+});
+describe("request shaping", () => {
+    it("encodes path parameters and refuses a missing one before fetching", async () => {
+        const calls = stubFetch();
+        const api = client();
+        await api.get("/v1/wallets/{id}", { path: { id: "wal_a/b c" } });
+        expect(calls[0].url).toBe(`${BASE}/v1/wallets/wal_a%2Fb%20c`);
+        await expect(api.request("get", "/v1/wallets/{id}", { path: {} })).rejects.toThrow(/missing path parameter id/);
+        expect(calls).toHaveLength(1);
+    });
+    it("serialises query parameters, repeating arrays and skipping undefined", async () => {
+        const calls = stubFetch();
+        const api = client();
+        await api.request("get", "/v1/wallets", {
+            query: { limit: 10, status: ["a", "b"], cursor: undefined, flag: false },
+        });
+        const url = new URL(calls[0].url);
+        expect(url.pathname).toBe("/v1/wallets");
+        expect(url.searchParams.getAll("status")).toEqual(["a", "b"]);
+        expect(url.searchParams.get("limit")).toBe("10");
+        expect(url.searchParams.get("flag")).toBe("false");
+        expect(url.searchParams.has("cursor")).toBe(false);
+    });
+    it("sends JSON bodies with the documented content type", async () => {
+        const calls = stubFetch(() => json({ id: "wal_example" }, 201));
+        const api = client();
+        const wallet = await api.post("/v1/wallets", {
+            body: { display_name: "Example wallet", currency: "BRL" },
+        });
+        expect(wallet).toEqual({ id: "wal_example" });
+        expect(calls[0].init.body).toBe(JSON.stringify({ display_name: "Example wallet", currency: "BRL" }));
+        expect(calls[0].init.headers["Content-Type"]).toBe("application/json");
+    });
+    it("sends form bodies for x-www-form-urlencoded operations", async () => {
+        const calls = stubFetch();
+        const api = client();
+        await api.post("/oauth/token", {
+            body: { grant_type: "authorization_code", code: "code-value" },
+        });
+        const headers = calls[0].init.headers;
+        expect(headers["Content-Type"]).toBe("application/x-www-form-urlencoded");
+        expect(String(calls[0].init.body)).toBe("grant_type=authorization_code&code=code-value");
+    });
+    it("carries the project scope and per-call header parameters", async () => {
+        const calls = stubFetch();
+        const api = client({ projectId: "prj_abc123DEF456ghi7" });
+        await api.patch("/v1/audit-events/config", {
+            header: { "x-codespar-user": "user_example" },
+            body: {},
+        });
+        const headers = calls[0].init.headers;
+        expect(headers["x-codespar-project"]).toBe("prj_abc123DEF456ghi7");
+        expect(headers["x-codespar-user"]).toBe("user_example");
+    });
+    it("tolerates a trailing slash on baseUrl", async () => {
+        const calls = stubFetch();
+        await client({ baseUrl: `${BASE}/` }).get("/v1/health");
+        expect(calls[0].url).toBe(`${BASE}/v1/health`);
+    });
+});
+describe("responses and errors", () => {
+    it("request() throws CodesparApiError with the parsed body on a non-2xx", async () => {
+        stubFetch(() => json({ error: "not_found" }, 404));
+        const api = client();
+        const err = await api.get("/v1/wallets/{id}", { path: { id: "wal_missing" } }).catch((e) => e);
+        expect(err).toBeInstanceOf(CodesparApiError);
+        expect(err.status).toBe(404);
+        expect(err.code).toBe("not_found");
+        expect(err.body).toEqual({ error: "not_found" });
+        expect(err.message).toMatch(/^GET \/v1\/wallets\/\{id\} failed: 404/);
+    });
+    it("response() returns non-2xx statuses as values, discriminated on status", async () => {
+        stubFetch(() => json({ status: "requires-approval" }, 402));
+        const api = client();
+        const r = await api.response("post", "/v1/wallets/{id}/execute", {
+            path: { id: "wal_example" },
+            body: {
+                amount: 1,
+                currency: "BRL",
+                recipient: "recipient-example",
+                description: "example",
+                mandate_id: "mnd_example",
+            },
+        });
+        expect(r.status).toBe(402);
+        expect(r.ok).toBe(false);
+        expect(r.data).toEqual({ status: "requires-approval" });
+        expect(r.response.status).toBe(402);
+    });
+    it("returns undefined for an empty body and text for a non-JSON one", async () => {
+        stubFetch((call) => call.url.endsWith("/v1/health")
+            ? new Response(null, { status: 204 })
+            : new Response("<html></html>", { status: 200, headers: { "content-type": "text/html" } }));
+        const api = client();
+        expect(await api.get("/v1/health")).toBeUndefined();
+        expect(await api.get("/oauth/authorize", { query: {} })).toBe("<html></html>");
+    });
+    it("returns the raw Response for text/event-stream operations", async () => {
+        stubFetch(() => new Response("event: snapshot\ndata: {}\n\n", {
+            status: 200,
+            headers: { "content-type": "text/event-stream" },
+        }));
+        const api = client();
+        const res = await api.get("/v1/tool-calls/{id}/payment-status/stream", {
+            path: { id: "tc_example" },
+        });
+        expect(res).toBeInstanceOf(Response);
+        expect(await res.text()).toContain("event: snapshot");
+    });
+    it("maps a fetch rejection to CodesparApiError status 0 with the cause attached", async () => {
+        const boom = new TypeError("fetch failed");
+        vi.stubGlobal("fetch", async () => {
+            throw boom;
+        });
+        const err = await client().get("/v1/health").catch((e) => e);
+        expect(err).toBeInstanceOf(CodesparApiError);
+        expect(err.status).toBe(0);
+        expect(err.cause).toBe(boom);
+    });
+    it("times out with TimeoutError when the backend never answers", async () => {
+        vi.stubGlobal("fetch", (_url, init) => new Promise((_, reject) => init.signal?.addEventListener("abort", () => reject(init.signal.reason))));
+        const err = await client().get("/v1/health", { timeout: 20 }).catch((e) => e);
+        expect(err).toBeInstanceOf(TimeoutError);
+        expect(err.timeoutMs).toBe(20);
+    });
+    it("propagates the caller's abort reason verbatim", async () => {
+        vi.stubGlobal("fetch", (_url, init) => new Promise((_, reject) => init.signal?.addEventListener("abort", () => reject(init.signal.reason))));
+        const ac = new AbortController();
+        const reason = new Error("caller cancelled");
+        const pending = client().get("/v1/health", { signal: ac.signal });
+        ac.abort(reason);
+        await expect(pending).rejects.toBe(reason);
+    });
+    it("rejects an invalid per-call timeout before fetching", async () => {
+        const calls = stubFetch();
+        await expect(client().get("/v1/health", { timeout: 0 })).rejects.toThrow(/timeout must be/);
+        expect(calls).toHaveLength(0);
+    });
+});
+describe("CodeSpar.api", () => {
+    it("shares the client's credentials, base URL, project and timeout", async () => {
+        const calls = stubFetch();
+        const cs = new CodeSpar({
+            apiKey: KEY,
+            baseUrl: BASE,
+            projectId: "prj_abc123DEF456ghi7",
+            timeout: 1234,
+        });
+        expect(cs.api).toBeInstanceOf(ApiClient);
+        await cs.api.get("/v1/whoami");
+        const headers = calls[0].init.headers;
+        expect(calls[0].url).toBe(`${BASE}/v1/whoami`);
+        expect(headers.Authorization).toBe(`Bearer ${KEY}`);
+        expect(headers["x-codespar-project"]).toBe("prj_abc123DEF456ghi7");
+    });
+});
+describe("README examples (the three snippets, compiled and dispatched)", () => {
+    it("list wallets, create a payment, read a receipt", async () => {
+        const calls = stubFetch((call) => call.url.endsWith("/execute")
+            ? json({ status: "requires-approval" }, 402)
+            : call.url.includes("/receipts/")
+                ? json({ receipt_id: "rcpt_example", state: "paid" })
+                : json([]));
+        const cs = new CodeSpar({ apiKey: KEY, baseUrl: BASE });
+        const wallets = await cs.api.get("/v1/wallets");
+        expect(wallets).toEqual([]);
+        const payment = await cs.api.response("post", "/v1/wallets/{id}/execute", {
+            path: { id: "wal_example" },
+            body: {
+                amount: 1,
+                currency: "BRL",
+                recipient: "recipient@example.com",
+                description: "Example payment",
+                mandate_id: "mnd_example",
+            },
+        });
+        expect(payment.status).toBe(402);
+        if (payment.status === 402)
+            expect(payment.data.status).toBe("requires-approval");
+        const receipt = await cs.api.get("/v1/consumers/receipts/{id}", {
+            path: { id: "rcpt_example" },
+        });
+        expect(receipt.state).toBe("paid");
+        expect(calls.map((c) => `${c.init.method} ${new URL(c.url).pathname}`)).toEqual([
+            "GET /v1/wallets",
+            "POST /v1/wallets/wal_example/execute",
+            "GET /v1/consumers/receipts/rcpt_example",
+        ]);
+    });
+});
+describe("types (checked by tsc, not at runtime)", () => {
+    it("path parameters are required where the document declares them", () => {
+        expectTypeOf().toEqualTypeOf();
+        expectTypeOf().toHaveProperty("id");
+        expectTypeOf().toMatchTypeOf();
+        // A path that does not declare the method is not an accepted argument.
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().not.toMatchTypeOf();
+    });
+});
+//# sourceMappingURL=api-client.test.js.map

package/dist/__tests__/api-client.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.test.js","sourceRoot":"","sources":["../../src/__tests__/api-client.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/close-timeout.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=close-timeout.test.d.ts.map

package/dist/__tests__/close-timeout.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-timeout.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/close-timeout.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/close-timeout.test.js

@@ -0,0 +1,57 @@
+import { describe, it, expect, afterEach } from "vitest";
+import { CodeSpar } from "../index.js";
+const realFetch = globalThis.fetch;
+afterEach(() => { globalThis.fetch = realFetch; });
+function sessionCreate() {
+    return { ok: true, status: 201, text: async () => "", json: async () => ({
+            id: "ses_c", org_id: "o", user_id: "u", servers: [],
+            status: "active", created_at: new Date().toISOString(), closed_at: null,
+        }) };
+}
+describe("session.close timeout", () => {
+    it("close() is best-effort: a DELETE timeout is swallowed, not thrown", async () => {
+        // Backend accepts the DELETE socket but never responds. close()
+        // must stay bounded (the timeout budget still fires) AND best-effort
+        // (it does not surface the timeout to the caller — parity with the
+        // Python client and the managed-agents adapter).
+        globalThis.fetch = ((url, init) => {
+            if (String(url).endsWith("/v1/sessions"))
+                return Promise.resolve(sessionCreate());
+            return new Promise((_res, rej) => {
+                init?.signal?.addEventListener("abort", () => rej(init.signal.reason), { once: true });
+            });
+        });
+        const cs = new CodeSpar({ apiKey: "csk_live_t", baseUrl: "https://x", timeout: 50 });
+        const session = await cs.create("u");
+        const start = Date.now();
+        await expect(session.close()).resolves.toBeUndefined();
+        // Bounded: it returned because the 50ms budget fired, not because
+        // it hung until the 5s test timeout.
+        expect(Date.now() - start).toBeLessThan(2000);
+    }, 5000);
+    it("close() still validates the timeout (invalid value is NOT swallowed)", async () => {
+        globalThis.fetch = ((url) => {
+            if (String(url).endsWith("/v1/sessions"))
+                return Promise.resolve(sessionCreate());
+            return Promise.resolve({ ok: true, status: 204, text: async () => "" });
+        });
+        const cs = new CodeSpar({ apiKey: "csk_live_t", baseUrl: "https://x" });
+        const session = await cs.create("u");
+        await expect(session.close({ timeout: 0 })).rejects.toThrow(/timeout/i);
+    }, 5000);
+    it("close() stays best-effort with a per-call timeout override", async () => {
+        globalThis.fetch = ((url, init) => {
+            if (String(url).endsWith("/v1/sessions"))
+                return Promise.resolve(sessionCreate());
+            return new Promise((_res, rej) => {
+                init?.signal?.addEventListener("abort", () => rej(init.signal.reason), { once: true });
+            });
+        });
+        const cs = new CodeSpar({ apiKey: "csk_live_t", baseUrl: "https://x", timeout: 10_000 });
+        const session = await cs.create("u");
+        const start = Date.now();
+        await expect(session.close({ timeout: 50 })).resolves.toBeUndefined();
+        expect(Date.now() - start).toBeLessThan(2000);
+    }, 5000);
+});
+//# sourceMappingURL=close-timeout.test.js.map

package/dist/__tests__/close-timeout.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-timeout.test.js","sourceRoot":"","sources":["../../src/__tests__/close-timeout.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/codespar.test.js

@@ -66,6 +66,17 @@ describe("CodeSpar constructor", () => {
             delete process.env.CODESPAR_BASE_URL;
         }
     });
+    it("defaults timeout to 60000 and accepts an override", () => {
+        const a = new CodeSpar({ apiKey: "csk_live_t" });
+        // @ts-expect-error private config read for the test only
+        expect(a.config.timeout).toBe(60000);
+        const b = new CodeSpar({ apiKey: "csk_live_t", timeout: 5000 });
+        // @ts-expect-error private config read for the test only
+        expect(b.config.timeout).toBe(5000);
+    });
+    it.each([0, -1, NaN, Infinity])("rejects an invalid default timeout (%p) at construction", (bad) => {
+        expect(() => new CodeSpar({ apiKey: "csk_live_t", timeout: bad })).toThrow(/timeout/i);
+    });
 });
 describe("SessionConfigSchema", () => {
     it("accepts an empty config", () => {