@beliq/sdk 0.3.0 → 0.3.1

package/README.md

@@ -88,6 +88,11 @@ costs you a second document.
 the work may still be running on beliq's side, so retrying risks producing a
 second document rather than recovering the first.
 
+A `429` carrying `QUOTA_EXCEEDED` is not retried either. `RATE_LIMITED` and
+`ACCOUNT_THROTTLED` clear on their own, but a spent monthly allowance only returns
+when your billing window turns, so the error is raised straight away and names the
+cause instead of sleeping against it.
+
 The default deadline is generous because beliq runs the full Schematron rule set
 over each document, and a generate or validate can legitimately take tens of
 seconds. If you lower it, keep it above the latency you actually see: a deadline

package/dist/index.cjs

@@ -255,6 +255,11 @@ var LIVE_CONVERT_TARGET_FORMATS = [
 
 // src/transport.ts
 var RETRYABLE_STATUSES = /* @__PURE__ */ new Set([429, 502, 503]);
+var QUOTA_EXHAUSTED_CODE = "QUOTA_EXCEEDED";
+function isRetryable(status, code) {
+  if (!RETRYABLE_STATUSES.has(status)) return false;
+  return !(status === 429 && code === QUOTA_EXHAUSTED_CODE);
+}
 var MAX_RETRY_AFTER_MS = 3e4;
 var BACKOFF_BASE_MS = 500;
 function authHeaders(config) {
@@ -302,12 +307,13 @@ async function send(config, req) {
       });
       const bytes = new Uint8Array(await res.arrayBuffer());
       if (res.ok) return { status: res.status, headers: res.headers, bytes };
-      lastError = errorFromResponse(res.status, bytes);
-      if (!RETRYABLE_STATUSES.has(res.status) || attempt === config.maxRetries) {
-        throw lastError;
+      const apiError = errorFromResponse(res.status, bytes);
+      lastError = apiError;
+      if (!isRetryable(apiError.status, apiError.code) || attempt === config.maxRetries) {
+        throw apiError;
       }
     } catch (err) {
-      if (err instanceof BeliqApiError && !RETRYABLE_STATUSES.has(err.status)) throw err;
+      if (err instanceof BeliqApiError && !isRetryable(err.status, err.code)) throw err;
       if (controller.signal.aborted) {
         throw new BeliqApiError(
           `beliq: request to ${req.path} exceeded ${config.timeoutMs}ms`,