@curviate/sdk 0.38.0 → 0.39.0

package/CHANGELOG.md

@@ -9,6 +9,34 @@ Versioning: semantic. Minor for additive changes, patch for bug fixes; no stabil
 
 ## [Unreleased]
 
+## [0.39.0] - 2026-09-28
+
+Fixture and types regenerated against the deployed production document
+(`https://api.curviate.com`, 130 paths, server
+`006f3739c93ff758085dc0ad13ae423bafab4631`).
+
+### Changed
+
+- **The retry decision now honours an explicit `retry_likely_to_succeed:
+  false`.** A GET on a retryable code (`INTERNAL`, `PLATFORM_ERROR`,
+  `PLATFORM_RATE_LIMIT`, `RATE_LIMIT_ACCOUNT`, `RATE_LIMIT_TENANT`) whose
+  envelope says `retry_likely_to_succeed: false` is no longer retried, with or
+  without a `retry_hint`. The server now sends `false` only as a verdict that
+  an unchanged retry fails the same way, and `true` for a failure whose cause
+  it cannot see, so this closes the half of the 0.37.1 fix that was deferred.
+  A response with no JSON envelope, or no such field, still retries on the
+  code table alone. Requires a server that includes the change; against an
+  older server, unexpected `INTERNAL` and `PLATFORM_ERROR` failures would stop
+  being retried.
+- **`accounts.addSeats()` documents its new failure shapes.** A `502` means
+  the purchase failed after today's charge was taken; the charge was refunded
+  in full and the seat count was confirmed unchanged, so no seats were added
+  and it is safe to retry. A `503 STRIPE_DRIFT_DETECTED` means the seat price
+  is misconfigured on our side: nothing was charged, this is not something you
+  can fix, and retrying fails the same way until the price is corrected.
+  Contact support. Both are generated-type/description additions; no
+  resource-method shape changed.
+
 ## [0.38.0] - 2026-09-26
 
 Fixture and types regenerated against the deployed production document

package/dist/index.d.ts

@@ -31778,7 +31778,16 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The purchase could not be confirmed while another change was in progress. Check the seat count before retrying. */
+            /** @description The purchase failed after today's charge was taken; the charge was refunded in full and the seat count was confirmed unchanged, so no seats were added. Safe to retry. */
+            502: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description The purchase could not be confirmed while another change was in progress (check the seat count before retrying), or the seat price is misconfigured on our side (nothing charged; contact support, retrying fails the same way). */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -31956,7 +31965,7 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Another change to this subscription is in progress. Retry shortly. */
+            /** @description Another change to this subscription is in progress (retry shortly), or the seat price is misconfigured on our side (nothing charged; contact support, retrying fails the same way). */
             503: {
                 headers: {
                     [name: string]: unknown;

package/dist/index.js

@@ -300,7 +300,7 @@ async function errorFromResponse(res) {
   }
   const safetyHint = toSafetyHint(env?.hint);
   const safetyReason = toSafetyReason(env?.reason);
-  return new CurviateError({
+  const err = new CurviateError({
     code: toErrorCode(env?.code),
     message: env?.message ?? `Request failed with status ${res.status}.`,
     httpStatus: res.status,
@@ -325,6 +325,7 @@ async function errorFromResponse(res) {
     ...safetyReason !== void 0 ? { safetyReason } : {},
     ...typeof env?.blocked === "boolean" ? { blocked: env.blocked } : {}
   });
+  return { err, refusesRetry: env?.retry_likely_to_succeed === false };
 }
 function retryDelay(err, attempt, jitter) {
   if (err.retryAfterMs !== void 0) return err.retryAfterMs;
@@ -405,9 +406,9 @@ async function execute(method, path, opts) {
     if (res.ok) {
       return parseSuccess(res);
     }
-    const err = await errorFromResponse(res);
+    const { err, refusesRetry } = await errorFromResponse(res);
     const namesBudgetRow = err.budgetRow !== void 0;
-    const neverRetry = err.retryHint?.kind === "never";
+    const neverRetry = err.retryHint?.kind === "never" || refusesRetry;
     const retryable = !isWrite && !namesBudgetRow && !neverRetry && RETRYABLE_CODES.has(err.code) && attempt < opts.maxRetries;
     if (retryable) {
       await sleep(retryDelay(err, attempt + 1, jitterFn()));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curviate/sdk",
-  "version": "0.38.0",
+  "version": "0.39.0",
   "private": false,
   "description": "TypeScript SDK for the Curviate API.",
   "license": "MIT",

package/src/generated/types.ts

@@ -31682,7 +31682,16 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The purchase could not be confirmed while another change was in progress. Check the seat count before retrying. */
+            /** @description The purchase failed after today's charge was taken; the charge was refunded in full and the seat count was confirmed unchanged, so no seats were added. Safe to retry. */
+            502: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description The purchase could not be confirmed while another change was in progress (check the seat count before retrying), or the seat price is misconfigured on our side (nothing charged; contact support, retrying fails the same way). */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -31860,7 +31869,7 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Another change to this subscription is in progress. Retry shortly. */
+            /** @description Another change to this subscription is in progress (retry shortly), or the seat price is misconfigured on our side (nothing charged; contact support, retrying fails the same way). */
             503: {
                 headers: {
                     [name: string]: unknown;