llm-errors 0.1.3 → 0.1.5

package/fixtures/cases/anthropic/sdk-billing-error.json

@@ -0,0 +1,14 @@
+{
+  "name": "Anthropic SDK billing error",
+  "shape": "anthropic-sdk-error-envelope",
+  "error": {
+    "status": 429,
+    "error": {
+      "type": "error",
+      "error": {
+        "type": "billing_error",
+        "message": "Your credit balance is too low."
+      }
+    }
+  }
+}

package/fixtures/cases/anthropic/sdk-overloaded-529.json

@@ -0,0 +1,17 @@
+{
+  "name": "Anthropic SDK overloaded response",
+  "shape": "anthropic-sdk-apierror",
+  "error": {
+    "status": 529,
+    "headers": {
+      "anthropic-version": "2023-06-01"
+    },
+    "error": {
+      "type": "error",
+      "error": {
+        "type": "overloaded_error",
+        "message": "Overloaded"
+      }
+    }
+  }
+}

package/fixtures/cases/gemini/fetch-unavailable.json

@@ -0,0 +1,19 @@
+{
+  "name": "Gemini parsed fetch response unavailable",
+  "shape": "google-rpc-fetch-parsed-body",
+  "error": {
+    "response": {
+      "status": 503,
+      "headers": {
+        "retry-after": "4"
+      },
+      "data": {
+        "error": {
+          "code": 503,
+          "message": "The model is overloaded. Please try again later.",
+          "status": "UNAVAILABLE"
+        }
+      }
+    }
+  }
+}

package/fixtures/cases/gemini/plain-unavailable-body.json

@@ -0,0 +1,9 @@
+{
+  "name": "Gemini direct plain unavailable body",
+  "shape": "plain-provider-error-body",
+  "error": {
+    "code": 503,
+    "message": "The model is overloaded. Please try again later.",
+    "status": "UNAVAILABLE"
+  }
+}

package/fixtures/cases/gemini/rpc-permission-denied.json

@@ -0,0 +1,11 @@
+{
+  "name": "Gemini Google RPC permission denied",
+  "shape": "google-rpc-error-envelope",
+  "error": {
+    "error": {
+      "code": 403,
+      "message": "The caller does not have permission.",
+      "status": "PERMISSION_DENIED"
+    }
+  }
+}

package/fixtures/cases/gemini/rpc-quota-exhausted-billing.json

@@ -0,0 +1,11 @@
+{
+  "name": "Gemini Google RPC quota exhausted billing",
+  "shape": "google-rpc-error-envelope",
+  "error": {
+    "error": {
+      "code": 429,
+      "message": "You exceeded your current quota, please check your plan and billing details.",
+      "status": "RESOURCE_EXHAUSTED"
+    }
+  }
+}

package/fixtures/cases/gemini/rpc-quota-exhausted-rate-bucket.json

@@ -0,0 +1,11 @@
+{
+  "name": "Gemini RESOURCE_EXHAUSTED rate bucket without billing signal",
+  "shape": "google-rpc-error-body",
+  "error": {
+    "error": {
+      "code": 429,
+      "message": "Quota exceeded for requests per minute.",
+      "status": "RESOURCE_EXHAUSTED"
+    }
+  }
+}

package/fixtures/cases/gemini/rpc-resource-exhausted.json

@@ -0,0 +1,17 @@
+{
+  "name": "Gemini Google RPC resource exhausted",
+  "shape": "google-rpc-error-envelope",
+  "error": {
+    "error": {
+      "code": 429,
+      "message": "Resource has been exhausted.",
+      "status": "RESOURCE_EXHAUSTED",
+      "details": [
+        {
+          "@type": "type.googleapis.com/google.rpc.RetryInfo",
+          "retryDelay": "17s"
+        }
+      ]
+    }
+  }
+}

package/fixtures/cases/generic/http-400-retry-after.json

@@ -0,0 +1,15 @@
+{
+  "name": "Generic HTTP 400 with ignored Retry-After",
+  "shape": "fetch-like-http-error",
+  "error": {
+    "statusCode": 400,
+    "headers": {
+      "Retry-After": "60"
+    },
+    "body": {
+      "error": {
+        "message": "Bad request"
+      }
+    }
+  }
+}

package/fixtures/cases/generic/http-503-retry-after.json

@@ -0,0 +1,15 @@
+{
+  "name": "Generic HTTP 503 with Retry-After",
+  "shape": "fetch-like-http-error",
+  "error": {
+    "statusCode": 503,
+    "headers": {
+      "Retry-After": "6"
+    },
+    "body": {
+      "error": {
+        "message": "Service temporarily unavailable"
+      }
+    }
+  }
+}

package/fixtures/cases/network/abort-error.json

@@ -0,0 +1,8 @@
+{
+  "name": "Browser fetch abort",
+  "shape": "dom-abort-error",
+  "error": {
+    "name": "AbortError",
+    "message": "The operation was aborted."
+  }
+}

package/fixtures/cases/network/node-timeout.json

@@ -0,0 +1,9 @@
+{
+  "name": "Node transport timeout",
+  "shape": "node-error-code",
+  "error": {
+    "name": "Error",
+    "message": "connect ETIMEDOUT",
+    "code": "ETIMEDOUT"
+  }
+}

package/fixtures/cases/openai/fetch-context-length.json

@@ -0,0 +1,18 @@
+{
+  "name": "OpenAI parsed fetch response context length",
+  "shape": "openai-fetch-parsed-body",
+  "error": {
+    "status": 400,
+    "headers": {
+      "openai-processing-ms": "42"
+    },
+    "body": {
+      "error": {
+        "message": "This model's maximum context length is 128000 tokens.",
+        "type": "invalid_request_error",
+        "code": "context_length_exceeded",
+        "param": "messages"
+      }
+    }
+  }
+}

package/fixtures/cases/openai/plain-rate-limit-body.json

@@ -0,0 +1,10 @@
+{
+  "name": "OpenAI direct plain rate limit body",
+  "shape": "plain-provider-error-body",
+  "error": {
+    "message": "Rate limit reached for requests",
+    "type": "rate_limit_error",
+    "code": "rate_limit_exceeded",
+    "param": null
+  }
+}

package/fixtures/cases/openai/sdk-billing-hard-limit.json

@@ -0,0 +1,12 @@
+{
+  "name": "OpenAI SDK billing hard limit",
+  "shape": "openai-sdk-api-error",
+  "error": {
+    "error": {
+      "message": "Billing hard limit has been reached",
+      "type": "invalid_request_error",
+      "code": "billing_hard_limit_reached",
+      "param": null
+    }
+  }
+}

package/fixtures/cases/openai/sdk-insufficient-quota.json

@@ -0,0 +1,13 @@
+{
+  "name": "OpenAI SDK APIError insufficient quota",
+  "shape": "openai-sdk-apierror",
+  "error": {
+    "status": 429,
+    "error": {
+      "message": "You exceeded your current quota.",
+      "type": "insufficient_quota",
+      "code": "insufficient_quota",
+      "param": null
+    }
+  }
+}

package/fixtures/cases/openai/sdk-rate-limit.json

@@ -0,0 +1,18 @@
+{
+  "name": "OpenAI SDK APIError rate limit",
+  "shape": "openai-sdk-apierror",
+  "error": {
+    "status": 429,
+    "headers": {
+      "openai-version": "2020-10-01",
+      "retry-after-ms": "1250",
+      "retry-after": "2"
+    },
+    "error": {
+      "message": "Rate limit reached for requests",
+      "type": "rate_limit_error",
+      "code": "rate_limit_exceeded",
+      "param": null
+    }
+  }
+}

package/fixtures/expected/anthropic/fetch-context-length.json

@@ -0,0 +1,8 @@
+{
+  "provider": "anthropic",
+  "category": "context_length_exceeded",
+  "message": "prompt is too long: 250000 tokens > 200000 maximum",
+  "status": 400,
+  "code": "invalid_request_error",
+  "retryable": false
+}

package/fixtures/expected/anthropic/fetch-rate-limit.json

@@ -0,0 +1,9 @@
+{
+  "provider": "anthropic",
+  "category": "rate_limit",
+  "message": "rate limit exceeded",
+  "status": 429,
+  "code": "rate_limit_error",
+  "retryable": true,
+  "retryAfterMs": 30000
+}

package/fixtures/expected/anthropic/rate-limit-credit-balance.json

@@ -0,0 +1,8 @@
+{
+  "provider": "anthropic",
+  "category": "insufficient_quota",
+  "message": "Your credit balance is too low.",
+  "status": 429,
+  "code": "rate_limit_error",
+  "retryable": false
+}

package/fixtures/expected/anthropic/sdk-billing-error.json

@@ -0,0 +1,8 @@
+{
+  "provider": "anthropic",
+  "category": "insufficient_quota",
+  "message": "Your credit balance is too low.",
+  "status": 429,
+  "code": "billing_error",
+  "retryable": false
+}

package/fixtures/expected/anthropic/sdk-overloaded-529.json

@@ -0,0 +1,8 @@
+{
+  "provider": "anthropic",
+  "category": "overloaded",
+  "message": "Overloaded",
+  "status": 529,
+  "code": "overloaded_error",
+  "retryable": true
+}

package/fixtures/expected/gemini/fetch-unavailable.json

@@ -0,0 +1,9 @@
+{
+  "provider": "gemini",
+  "category": "overloaded",
+  "message": "The model is overloaded. Please try again later.",
+  "status": 503,
+  "code": "UNAVAILABLE",
+  "retryable": true,
+  "retryAfterMs": 4000
+}

package/fixtures/expected/gemini/plain-unavailable-body.json

@@ -0,0 +1,8 @@
+{
+  "provider": "gemini",
+  "category": "overloaded",
+  "message": "The model is overloaded. Please try again later.",
+  "status": 503,
+  "code": "UNAVAILABLE",
+  "retryable": true
+}

package/fixtures/expected/gemini/rpc-permission-denied.json

@@ -0,0 +1,8 @@
+{
+  "provider": "gemini",
+  "category": "permission",
+  "message": "The caller does not have permission.",
+  "status": 403,
+  "code": "PERMISSION_DENIED",
+  "retryable": false
+}

package/fixtures/expected/gemini/rpc-quota-exhausted-billing.json

@@ -0,0 +1,8 @@
+{
+  "provider": "gemini",
+  "category": "insufficient_quota",
+  "message": "You exceeded your current quota, please check your plan and billing details.",
+  "status": 429,
+  "code": "RESOURCE_EXHAUSTED",
+  "retryable": false
+}

package/fixtures/expected/gemini/rpc-quota-exhausted-rate-bucket.json

@@ -0,0 +1,8 @@
+{
+  "provider": "gemini",
+  "category": "rate_limit",
+  "message": "Quota exceeded for requests per minute.",
+  "status": 429,
+  "code": "RESOURCE_EXHAUSTED",
+  "retryable": true
+}

package/fixtures/expected/gemini/rpc-resource-exhausted.json

@@ -0,0 +1,9 @@
+{
+  "provider": "gemini",
+  "category": "rate_limit",
+  "message": "Resource has been exhausted.",
+  "status": 429,
+  "code": "RESOURCE_EXHAUSTED",
+  "retryable": true,
+  "retryAfterMs": 17000
+}

package/fixtures/expected/generic/http-400-retry-after.json

@@ -0,0 +1,7 @@
+{
+  "provider": "unknown",
+  "category": "invalid_request",
+  "message": "Bad request",
+  "status": 400,
+  "retryable": false
+}

package/fixtures/expected/generic/http-503-retry-after.json

@@ -0,0 +1,8 @@
+{
+  "provider": "unknown",
+  "category": "overloaded",
+  "message": "Service temporarily unavailable",
+  "status": 503,
+  "retryable": true,
+  "retryAfterMs": 6000
+}

package/fixtures/expected/network/abort-error.json

@@ -0,0 +1,7 @@
+{
+  "provider": "unknown",
+  "category": "timeout",
+  "message": "The operation was aborted.",
+  "code": "AbortError",
+  "retryable": true
+}

package/fixtures/expected/network/node-timeout.json

@@ -0,0 +1,7 @@
+{
+  "provider": "unknown",
+  "category": "timeout",
+  "message": "connect ETIMEDOUT",
+  "code": "ETIMEDOUT",
+  "retryable": true
+}

package/fixtures/expected/openai/fetch-context-length.json

@@ -0,0 +1,8 @@
+{
+  "provider": "openai",
+  "category": "context_length_exceeded",
+  "message": "This model's maximum context length is 128000 tokens.",
+  "status": 400,
+  "code": "context_length_exceeded",
+  "retryable": false
+}

package/fixtures/expected/openai/plain-rate-limit-body.json

@@ -0,0 +1,7 @@
+{
+  "provider": "openai",
+  "category": "rate_limit",
+  "message": "Rate limit reached for requests",
+  "code": "rate_limit_exceeded",
+  "retryable": true
+}

package/fixtures/expected/openai/sdk-billing-hard-limit.json

@@ -0,0 +1,7 @@
+{
+  "provider": "openai",
+  "category": "insufficient_quota",
+  "message": "Billing hard limit has been reached",
+  "code": "billing_hard_limit_reached",
+  "retryable": false
+}

package/fixtures/expected/openai/sdk-insufficient-quota.json

@@ -0,0 +1,8 @@
+{
+  "provider": "openai",
+  "category": "insufficient_quota",
+  "message": "You exceeded your current quota.",
+  "status": 429,
+  "code": "insufficient_quota",
+  "retryable": false
+}

package/fixtures/expected/openai/sdk-rate-limit.json

@@ -0,0 +1,9 @@
+{
+  "provider": "openai",
+  "category": "rate_limit",
+  "message": "Rate limit reached for requests",
+  "status": 429,
+  "code": "rate_limit_exceeded",
+  "retryable": true,
+  "retryAfterMs": 1250
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "llm-errors",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Normalize OpenAI, Anthropic and Gemini API errors into one shape: category, retryable flag and Retry-After delay. Zero dependencies.",
   "keywords": [
     "openai",
@@ -46,6 +46,7 @@
   },
   "files": [
     "dist",
+    "fixtures",
     "README.md",
     "LICENSE",
     "CHANGELOG.md"
@@ -71,7 +72,7 @@
     "eslint": "^10.4.1",
     "prettier": "^3.4.2",
     "tsup": "^8.3.5",
-    "typescript": "^5.7.2",
+    "typescript": "^6.0.3",
     "typescript-eslint": "^8.60.0",
     "vitest": "^4.1.8"
   }