gametime-api-client 1.2.1 → 1.3.0

package/README.md

@@ -107,6 +107,8 @@ const csv = await gametime.situations.exportCsv(id, 'nba');
 writeFileSync('austin-reaves-q4-down-1-15.csv', csv);
 ```
 
+`situations.create` automatically retries transient upstream failures (`429`, `502`, `503`, `504`) with capped exponential backoff. This keeps client usage simple, but heavily rate-limited periods can increase response time.
+
 ## API reference
 
 | Method | Description |

package/dist/index.js

@@ -22,6 +22,11 @@ class ApiError extends Error {
         this.name = "GametimeApiError";
     }
 }
+const CREATE_SITUATION_RETRY = {
+    maxAttempts: 5,
+    baseDelayMs: 600,
+    maxDelayMs: 12000,
+};
 async function request(baseUrl, path, init) {
     const url = `${baseUrl.replace(/\/$/, "")}${path}`;
     const res = await fetch(url, {
@@ -35,6 +40,25 @@ async function request(baseUrl, path, init) {
     }
     return body;
 }
+async function requestWithRetry(run, shouldRetry, options = {}) {
+    const maxAttempts = sanitizePositiveInt(options.maxAttempts, CREATE_SITUATION_RETRY.maxAttempts);
+    const baseDelayMs = sanitizePositiveInt(options.baseDelayMs, CREATE_SITUATION_RETRY.baseDelayMs);
+    const maxDelayMs = sanitizePositiveInt(options.maxDelayMs, CREATE_SITUATION_RETRY.maxDelayMs);
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+        try {
+            return await run();
+        }
+        catch (error) {
+            lastError = error;
+            if (!shouldRetry(error) || attempt >= maxAttempts) {
+                throw error;
+            }
+            await sleep(calculateBackoffDelay(attempt, baseDelayMs, maxDelayMs));
+        }
+    }
+    throw lastError;
+}
 function get(baseUrl, path) {
     return request(baseUrl, path, { method: "GET" });
 }
@@ -77,7 +101,7 @@ export function createClient(options = {}) {
     };
     const situations = {
         create(params) {
-            return post(baseUrl, "/v1/situations", params);
+            return requestWithRetry(() => post(baseUrl, "/v1/situations", params), isRetryableCreateSituationError);
         },
         analysis(id, sport) {
             return get(baseUrl, `/v1/situations/${encodeURIComponent(id)}/analysis?sport=${sport}`);
@@ -94,3 +118,28 @@ export function createClient(options = {}) {
 /** Pre-built client using default hosted API URL */
 export const gametime = createClient();
 export { ApiError };
+function isRetryableCreateSituationError(error) {
+    if (!(error instanceof ApiError)) {
+        return false;
+    }
+    const status = error.status;
+    if (status === 429 || status === 502 || status === 503 || status === 504) {
+        return true;
+    }
+    const upstreamStatus = error.details?.status;
+    return upstreamStatus === 429;
+}
+function calculateBackoffDelay(attempt, baseDelayMs, maxDelayMs) {
+    const exponential = Math.min(maxDelayMs, baseDelayMs * (2 ** (attempt - 1)));
+    const jitter = Math.floor(Math.random() * Math.min(250, Math.max(1, Math.floor(exponential * 0.25))));
+    return Math.min(maxDelayMs, exponential + jitter);
+}
+function sanitizePositiveInt(value, fallback) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 1) {
+        return fallback;
+    }
+    return Math.floor(value);
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gametime-api-client",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "JavaScript client for Gametime API - live sports data, player analysis, and predictions",
   "type": "module",
   "main": "dist/index.js",
@@ -12,22 +12,12 @@
       "default": "./dist/index.js"
     }
   },
-  "files": [
-    "dist"
-  ],
+  "files": ["dist"],
   "scripts": {
     "build": "tsc",
     "prepublishOnly": "npm run build"
   },
-  "keywords": [
-    "gametime",
-    "sports",
-    "api",
-    "nba",
-    "soccer",
-    "live",
-    "prediction"
-  ],
+  "keywords": ["gametime", "sports", "api", "nba", "soccer", "live", "prediction"],
   "author": "",
   "license": "MIT",
   "devDependencies": {