@aouda/client 0.1.8 → 0.1.9

package/dist/cli/index.cjs

@@ -421,7 +421,7 @@ var import_node_url = require("url");
 // package.json
 var package_default = {
   name: "@aouda/client",
-  version: "0.1.8",
+  version: "0.1.9",
   description: "Official TypeScript/JavaScript client library for Aouda",
   type: "module",
   main: "./dist/index.cjs",
@@ -536,12 +536,13 @@ var AoudaResponseError = class extends AoudaError {
   }
 };
 var AoudaApiError = class extends AoudaError {
-  constructor(message, code, statusCode, details, requestId) {
+  constructor(message, code, statusCode, details, requestId, retryAfterSeconds) {
     super(message);
     this.code = code;
     this.statusCode = statusCode;
     this.details = details;
     this.requestId = requestId;
+    this.retryAfterSeconds = retryAfterSeconds;
     this.name = "AoudaApiError";
   }
 };
@@ -564,8 +565,8 @@ var AoudaValidationError = class extends AoudaApiError {
   }
 };
 var AoudaServerError = class extends AoudaApiError {
-  constructor(message, code, statusCode, details, requestId) {
-    super(message, code, statusCode, details, requestId);
+  constructor(message, code, statusCode, details, requestId, retryAfterSeconds) {
+    super(message, code, statusCode, details, requestId, retryAfterSeconds);
     this.name = "AoudaServerError";
   }
 };
@@ -1504,6 +1505,8 @@ var ERROR_CODE_MAP = {
   SERVICE_UNAVAILABLE: AoudaServerError,
   TIMEOUT: AoudaServerError,
   OVERLOADED: AoudaServerError,
+  MEMORY_BUDGET_EXCEEDED: AoudaServerError,
+  WAL_CAPACITY_EXCEEDED: AoudaServerError,
   AUTH_TOKEN_MISSING: AoudaAuthenticationError,
   AUTH_TOKEN_EXPIRED: AoudaAuthenticationError,
   AUTH_TOKEN_INVALID: AoudaAuthenticationError,
@@ -1531,13 +1534,22 @@ function createComposedAbortController(...signals) {
   }
   return controller;
 }
-function createApiError(statusCode, statusText, body) {
+function parseRetryAfterSeconds(header) {
+  if (header == null || header.trim() === "") return void 0;
+  const trimmed = header.trim();
+  if (!/^\d+$/.test(trimmed)) return void 0;
+  const n = Number.parseInt(trimmed, 10);
+  if (!Number.isFinite(n) || n < 0) return void 0;
+  return n;
+}
+function createApiError(statusCode, statusText, body, retryAfterHeader) {
   const message = body.error ?? `${statusCode} ${statusText}`;
   const code = body.code ?? "UNKNOWN";
   const details = body.details;
   const requestId = body.requestId;
+  const retryAfterSeconds = parseRetryAfterSeconds(retryAfterHeader ?? null);
   const Ctor = ERROR_CODE_MAP[code] ?? AoudaApiError;
-  return new Ctor(message, code, statusCode, details, requestId);
+  return new Ctor(message, code, statusCode, details, requestId, retryAfterSeconds);
 }
 var HttpTransport = class {
   constructor(options) {
@@ -1630,7 +1642,8 @@ var HttpTransport = class {
           throw createApiError(
             response.status,
             response.statusText,
-            errorBody
+            errorBody,
+            response.headers.get("Retry-After")
           );
         }
         throw new AoudaResponseError(
@@ -1740,7 +1753,8 @@ var HttpTransport = class {
         throw createApiError(
           response.status,
           response.statusText,
-          errorBody
+          errorBody,
+          response.headers.get("Retry-After")
         );
       }
       throw new AoudaResponseError(
@@ -2086,6 +2100,17 @@ var CIRCUIT_BREAKER_POLICY_DISABLED = {
 
 // src/resilience/resilient-transport.ts
 var REQUEST_ID_HEADER3 = "X-Request-Id";
+function isCapacityBackPressure(error) {
+  return error instanceof AoudaApiError && (error.code === "MEMORY_BUDGET_EXCEEDED" || error.code === "WAL_CAPACITY_EXCEEDED");
+}
+function retryDelayMs(retryPolicy, attempt, error) {
+  const backoff = calculateDelay(retryPolicy, attempt);
+  if (!isCapacityBackPressure(error) || !(error instanceof AoudaApiError)) {
+    return backoff;
+  }
+  const headerMs = error.retryAfterSeconds != null ? error.retryAfterSeconds * 1e3 : 0;
+  return Math.max(backoff, headerMs);
+}
 function delayMs(ms, signal) {
   if (ms <= 0) return Promise.resolve();
   return new Promise((resolve4, reject) => {
@@ -2140,7 +2165,7 @@ var ResilientTransport = class {
       } catch (error) {
         lastError = error;
         const retryable = isRetryable(error);
-        if (retryable) {
+        if (retryable && !isCapacityBackPressure(error)) {
           this.circuitBreaker.recordFailure(error);
         }
         if (!retryable) {
@@ -2150,7 +2175,7 @@ var ResilientTransport = class {
         if (attempt > this.retryPolicy.maxRetries) {
           throw error;
         }
-        const delay = calculateDelay(this.retryPolicy, attempt);
+        const delay = retryDelayMs(this.retryPolicy, attempt, error);
         try {
           await delayMs(delay, config.signal);
         } catch {
@@ -2186,7 +2211,7 @@ var ResilientTransport = class {
       } catch (error) {
         lastError = error;
         const retryable = isRetryable(error);
-        if (retryable) {
+        if (retryable && !isCapacityBackPressure(error)) {
           this.circuitBreaker.recordFailure(error);
         }
         if (!retryable) {
@@ -2196,7 +2221,7 @@ var ResilientTransport = class {
         if (attempt > this.retryPolicy.maxRetries) {
           throw error;
         }
-        const delay = calculateDelay(this.retryPolicy, attempt);
+        const delay = retryDelayMs(this.retryPolicy, attempt, error);
         try {
           await delayMs(delay, config.signal);
         } catch {