sentisense 0.63.0 → 0.63.1

package/README.md

@@ -157,7 +157,7 @@ const client = new SentiSense({
 | `apiKey` | none | Sent as `X-SentiSense-API-Key`. Required by every endpoint. |
 | `baseUrl` | `https://app.sentisense.ai` | Override for a non-production host. |
 | `timeout` | `30000` | Per-request timeout in milliseconds. |
-| `maxRetries` | `3` | Retries on 429 and 5xx, honouring `Retry-After`. Set `0` to fail fast. |
+| `maxRetries` | `3` | Retries the per-minute 429 and 5xx, honouring `Retry-After`. The monthly-allowance 429 is never retried. Set `0` to fail fast. |
 | `userAgentSuffix` | none | Appended to the User-Agent, after `sentisense-node/{version}`. |
 
 `userAgentSuffix` is how you say what is calling on top of the SDK, so your traffic is legible in your own logs and in ours. A tool name and version works (`"my-bot/1.4"`), optionally with an agent label (`"my-bot/1.4 agent/research-desk"`). Node only, since browsers set the header themselves. Newlines are collapsed and an empty value is ignored.
@@ -636,7 +636,12 @@ try {
   if (error instanceof AuthenticationError) {
     // 401 or 403: invalid/missing API key or insufficient tier
   } else if (error instanceof RateLimitError) {
-    // 429: quota exceeded
+    if (error.code === "quota_exceeded") {
+      // 429: monthly allowance used up. Not retried; error.message says when it resets.
+    } else {
+      // 429: per-minute limit ("rate_limit_exceeded"), thrown once retries are used up.
+      // error.retryAfter is the server's wait in seconds.
+    }
   }
 }
 ```
@@ -645,7 +650,7 @@ try {
 |------------|-------------|------|
 | `AuthenticationError` | 401, 403 | Invalid API key or insufficient tier |
 | `NotFoundError` | 404 | Resource not found |
-| `RateLimitError` | 429 | Quota exceeded |
+| `RateLimitError` | 429 | Per-minute limit (`code: "rate_limit_exceeded"`, retried first) or monthly allowance used up (`code: "quota_exceeded"`, thrown immediately) |
 | `APIError` | Other 4xx/5xx | General API error |
 
 All errors extend `SentiSenseError` and include `status`, `code`, and `message` properties.

package/dist/cli.cjs

@@ -66,10 +66,12 @@ var EXIT_TABLE = [
   [EXIT.USAGE, "bad usage, caught before any request was sent"],
   [EXIT.AUTH, "missing or rejected API key"],
   [EXIT.NOT_FOUND, "no data for that symbol or identifier"],
-  [EXIT.RATE_LIMIT, "rate limited"],
+  [EXIT.RATE_LIMIT, "rate limited, or the monthly request allowance is used up"],
   [EXIT.NETWORK, "network failure or timeout"]
 ];
 var KEY_URL = "https://app.sentisense.ai/get-api-key";
+var PRICING_URL = "https://app.sentisense.ai/pricing";
+var QUOTA_EXCEEDED = "quota_exceeded";
 var CliUsageError = class extends Error {
   constructor(message, hint) {
     super(message);
@@ -158,6 +160,15 @@ function classify(error, command) {
     };
   }
   if (error instanceof RateLimitError) {
+    if (error.code === QUOTA_EXCEEDED) {
+      return {
+        exitCode: EXIT.RATE_LIMIT,
+        lines: [
+          `error: monthly request allowance used up: ${error.message}`,
+          `next: the free monthly allowance resets at the start of next month, so running it again before then will not help. PRO has no monthly cap: ${PRICING_URL}`
+        ]
+      };
+    }
     const wait = error.retryAfter ? Math.ceil(error.retryAfter) : 60;
     return {
       exitCode: EXIT.RATE_LIMIT,
@@ -1345,7 +1356,7 @@ var flowsCommand = {
 };
 
 // src/version.ts
-var VERSION = "0.63.0";
+var VERSION = "0.63.1";
 
 // src/resources/analyst.ts
 var Analyst = class {
@@ -2668,6 +2679,15 @@ var DEEP_HISTORY_FALLBACK_WAIT_S = 3;
 var MAX_DEEP_HISTORY_WAIT_S = 30;
 var MAX_RATE_LIMIT_WAIT_S = 120;
 var RATE_LIMIT_FALLBACK_WAIT_S = 60;
+var QUOTA_EXCEEDED_CODE = "quota_exceeded";
+async function isQuotaExceeded(response) {
+  try {
+    const body = await response.clone().json();
+    return body?.error === QUOTA_EXCEEDED_CODE;
+  } catch {
+    return false;
+  }
+}
 function clampRetryAfter(raw, maxWaitS) {
   if (!raw) return void 0;
   const parsed = Number(raw);
@@ -2753,6 +2773,9 @@ var SentiSense = class {
           );
         }
         if (!response.ok) {
+          if (response.status === 429 && await isQuotaExceeded(response)) {
+            await this.handleErrorResponse(response);
+          }
           const isRetryable = response.status === 429 || response.status >= 500;
           if (isRetryable && attempt < this.maxRetries) {
             if (response.status === 429 || response.status === 503) {

package/dist/index.cjs

@@ -1394,7 +1394,7 @@ var Trackers = class {
 };
 
 // src/version.ts
-var VERSION = "0.63.0";
+var VERSION = "0.63.1";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://app.sentisense.ai";
@@ -1406,6 +1406,15 @@ var DEEP_HISTORY_FALLBACK_WAIT_S = 3;
 var MAX_DEEP_HISTORY_WAIT_S = 30;
 var MAX_RATE_LIMIT_WAIT_S = 120;
 var RATE_LIMIT_FALLBACK_WAIT_S = 60;
+var QUOTA_EXCEEDED_CODE = "quota_exceeded";
+async function isQuotaExceeded(response) {
+  try {
+    const body = await response.clone().json();
+    return body?.error === QUOTA_EXCEEDED_CODE;
+  } catch {
+    return false;
+  }
+}
 function clampRetryAfter(raw, maxWaitS) {
   if (!raw) return void 0;
   const parsed = Number(raw);
@@ -1491,6 +1500,9 @@ var SentiSense = class {
           );
         }
         if (!response.ok) {
+          if (response.status === 429 && await isQuotaExceeded(response)) {
+            await this.handleErrorResponse(response);
+          }
           const isRetryable = response.status === 429 || response.status >= 500;
           if (isRetryable && attempt < this.maxRetries) {
             if (response.status === 429 || response.status === 503) {