@codespar/sdk 0.11.0 → 0.13.0

package/dist/internal/fetch.js

@@ -0,0 +1,57 @@
+// LIMITATION: aborting/timing out only closes the client connection.
+// It does NOT undo an upstream side effect the backend already
+// dispatched (e.g. a Pix transfer / NF-e issuance). HTTP has no
+// out-of-band cancel; the server only learns the socket closed. True
+// cancellation of a side-effecting call needs a backend cancel
+// endpoint or idempotency key. Tracked separately (not in R3).
+import { mergeSignals, timeoutSignal } from "./abort.js";
+import { TimeoutError } from "../errors.js";
+/**
+ * Fail-fast validation for an effective per-call timeout (ms). Mirrors
+ * the Python client's normalize_timeout so both SDKs reject the same
+ * bad inputs (0, negative, NaN, Infinity, non-number) before a request
+ * starts, instead of producing an unpredictable timer.
+ */
+export function validateTimeout(ms) {
+    if (typeof ms !== "number" ||
+        Number.isNaN(ms) ||
+        !Number.isFinite(ms) ||
+        ms <= 0) {
+        throw new Error(`timeout must be a positive, finite number of milliseconds, got ${String(ms)}`);
+    }
+}
+/**
+ * fetch() with a TOTAL timeout that covers body consumption too.
+ *
+ * The `consume` callback reads the body (`res.json()`/`res.text()`)
+ * while the timeout signal is still armed — a backend that returns
+ * headers and then stalls the body still hits the timeout instead of
+ * hanging forever. The timeout fires a TimeoutError; the caller's own
+ * signal aborting re-throws that signal's reason verbatim (a standard
+ * AbortError), so the two causes stay distinguishable.
+ */
+export async function fetchWithTimeout(url, init, opts, consume) {
+    validateTimeout(opts.timeout);
+    const t = timeoutSignal(opts.timeout);
+    const merged = mergeSignals([t.signal, opts.signal]);
+    try {
+        const res = await fetch(url, { ...init, signal: merged.signal });
+        // Body read stays inside the timeout/abort budget.
+        return await consume(res);
+    }
+    catch (err) {
+        // Caller cancellation takes priority and propagates verbatim.
+        if (opts.signal?.aborted)
+            throw opts.signal.reason;
+        // Otherwise, if our timeout fired, surface a typed TimeoutError.
+        if (t.signal.aborted)
+            throw new TimeoutError(opts.timeout);
+        // Unrelated failure (network/DNS/etc.) — rethrow as-is.
+        throw err;
+    }
+    finally {
+        t.clear();
+        merged.cleanup();
+    }
+}
+//# sourceMappingURL=fetch.js.map

package/dist/internal/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/internal/fetch.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,+DAA+D;AAC/D,gEAAgE;AAChE,qEAAqE;AACrE,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5C;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,IACE,OAAO,EAAE,KAAK,QAAQ;QACtB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAChB,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpB,EAAE,IAAI,CAAC,EACP,CAAC;QACD,MAAM,IAAI,KAAK,CACb,kEAAkE,MAAM,CAAC,EAAE,CAAC,EAAE,CAC/E,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAW,EACX,IAAiC,EACjC,IAA+C,EAC/C,OAAsC;IAEtC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACjE,mDAAmD;QACnD,OAAO,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,8DAA8D;QAC9D,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO;YAAE,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QACnD,iEAAiE;QACjE,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO;YAAE,MAAM,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3D,wDAAwD;QACxD,MAAM,GAAG,CAAC;IACZ,CAAC;YAAS,CAAC;QACT,CAAC,CAAC,KAAK,EAAE,CAAC;QACV,MAAM,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/session.d.ts

@@ -1,13 +1,14 @@
 /**
  * Session implementation for the CodeSpar managed runtime.
  */
-import type { SessionConfig } from "./types.js";
+import type { SessionConfig, CallOptions } from "./types.js";
 import type { Session } from "@codespar/types";
 interface SessionDeps {
     baseUrl: string;
     apiKey: string;
     projectId?: string;
+    timeout: number;
 }
-export declare function createSession(userId: string, config: SessionConfig, deps: SessionDeps): Promise<Session>;
+export declare function createSession(userId: string, config: SessionConfig, deps: SessionDeps, createOpts?: CallOptions): Promise<Session>;
 export {};
 //# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAQ,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EACV,OAAO,EA4BR,MAAM,iBAAiB,CAAC;AAEzB,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAoCD,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,OAAO,CAAC,CAudlB"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAQ,WAAW,EAAE,MAAM,YAAY,CAAC;AAGnE,OAAO,KAAK,EACV,OAAO,EA4BR,MAAM,iBAAiB,CAAC;AAEzB,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AA6CD,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,WAAW,EACjB,UAAU,CAAC,EAAE,WAAW,GACvB,OAAO,CAAC,OAAO,CAAC,CA6iBlB"}