@xoxno/sdk-js 1.0.214 → 1.0.216

package/dist/cjs/utils/__tests__/request-timeout.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/utils/api.d.ts

@@ -5,7 +5,27 @@ export type SafeHeaders = Record<string, string> & {
 export type OurRequestInit = Omit<RequestInit, 'body' | 'headers'> & {
     headers?: SafeHeaders;
     debug?: boolean;
+    /**
+     * Milliseconds before the request is aborted, as a client-wide default or a
+     * per-call override. `0` disables the deadline for that call.
+     *
+     * Defaults to {@link DEFAULT_REQUEST_TIMEOUT_MS} for requests with no body.
+     * Requests that send a body are left unbounded by default because their
+     * duration depends on the caller's uplink — a multipart upload on a slow
+     * mobile connection is not a stalled request. Pass `timeout` explicitly to
+     * bound those.
+     */
+    timeout?: number;
 };
+/**
+ * Default read deadline. Without one, a stalled response is bounded only by
+ * whatever the host runtime imposes (in Node, undici's Agent), which is
+ * typically longer than the caller's own budget — a Next.js `'use cache'` fill,
+ * for instance, gives up at `staticPageGenerationTimeout * 0.9` and turns the
+ * stall into a hard error instead of a fetch rejection the caller can degrade
+ * on. Generous enough that only a genuinely stuck read hits it.
+ */
+export declare const DEFAULT_REQUEST_TIMEOUT_MS = 30000;
 /**
  * Host-supplied configuration for {@link XOXNOClient}.
  *
@@ -42,5 +62,6 @@ export declare class XOXNOClient {
     fetchWithTimeout: <T>(path: string, { params, ...options }?: RequestInit & {
         debug?: boolean;
         params?: Record<string, any>;
+        timeout?: number;
     }) => Promise<T>;
 }