@playcademy/sdk 0.4.1-beta.8 → 0.4.1-beta.9

package/dist/index.d.ts

@@ -380,6 +380,9 @@ declare function parseOAuthState(state: string): {
 
 /** Permitted HTTP verbs */
 type Method = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+interface RetryPolicy {
+    retryableMethods?: readonly Method[];
+}
 
 /**
  * TimeBack Enums & Literal Types
@@ -946,11 +949,15 @@ declare abstract class PlaycademyBaseClient {
         body?: unknown;
         headers?: Record<string, string>;
         raw?: boolean;
+        retryPolicy?: RetryPolicy;
     }): Promise<T>;
     /**
      * Makes an authenticated HTTP request to the game's backend Worker.
      */
-    protected requestGameBackend<T>(path: string, method: Method, body?: unknown, headers?: Record<string, string>, raw?: boolean): Promise<T>;
+    protected requestGameBackend<T>(path: string, method: Method, body?: unknown, headers?: Record<string, string>, options?: {
+        raw?: boolean;
+        retryPolicy?: RetryPolicy;
+    }): Promise<T>;
     /**
      * Ensures a gameId is available, throwing an error if not.
      */

package/dist/index.js

@@ -1037,7 +1037,7 @@ function createBackendNamespace(client) {
       return client["requestGameBackend"](normalizePath(path), method, body, headers);
     },
     async download(path, method = "GET", body, headers) {
-      return client["requestGameBackend"](normalizePath(path), method, body, headers, true);
+      return client["requestGameBackend"](normalizePath(path), method, body, headers, { raw: true });
     },
     url(pathOrStrings, ...values) {
       if (Array.isArray(pathOrStrings) && "raw" in pathOrStrings) {
@@ -1391,6 +1391,7 @@ function isValidUUID(value) {
 // src/core/activity-tracker.ts
 var DEFAULT_HIDDEN_TIMEOUT_MS = 10 * 60 * 1000;
 var DEFAULT_HEARTBEAT_INTERVAL_MS = 15000;
+var HEARTBEAT_RETRY_POLICY = { retryableMethods: ["POST"] };
 function getCurrentPausedTotal(activity, now = Date.now()) {
   if (activity.pauseStartTime === null) {
     return activity.pausedTime;
@@ -1417,9 +1418,11 @@ function markPersistedTiming(activity, timing) {
   activity.totalPersistedPausedMs += timing.pausedMs;
 }
 function queueHeartbeatFlush(activity, timing, flush) {
-  markPersistedTiming(activity, timing);
   async function doFlush() {
-    await flush();
+    const wasPersisted = await flush();
+    if (wasPersisted) {
+      markPersistedTiming(activity, timing);
+    }
   }
   if (activity.flushInFlight) {
     const previousFlush = activity.flushInFlight.catch(() => {
@@ -1537,8 +1540,11 @@ function createTimebackActivityTracker(client) {
     const body = buildHeartbeatBody(trackedActivity, timing, isFinal);
     await queueHeartbeatFlush(trackedActivity, timing, async () => {
       try {
-        await client["requestGameBackend"](TIMEBACK_ROUTES.HEARTBEAT, "POST", body);
-      } catch {}
+        await client["requestGameBackend"](TIMEBACK_ROUTES.HEARTBEAT, "POST", body, undefined, { retryPolicy: HEARTBEAT_RETRY_POLICY });
+        return true;
+      } catch {
+        return false;
+      }
     });
   }
   function handlePageHide() {
@@ -1566,9 +1572,10 @@ function createTimebackActivityTracker(client) {
           keepalive: true
         });
         if (response.ok) {
-          return;
+          return true;
         }
       } catch {}
+      return false;
     });
   }
   function cleanupListeners() {
@@ -2219,7 +2226,8 @@ async function fetchWithRetry(url, init2) {
   const startedAt = Date.now();
   for (let attempt = 0;attempt <= RETRY_DELAYS_MS.length; attempt++) {
     const retryDelayMs = RETRY_DELAYS_MS[attempt];
-    const canRetry = init2.method === "GET" && retryDelayMs !== undefined;
+    const retryableMethods = init2.retryPolicy?.retryableMethods ?? ["GET"];
+    const canRetry = retryDelayMs !== undefined && retryableMethods.includes(init2.method);
     try {
       const response = await fetch(url, init2);
       if (canRetry && isRetryableStatus(response.status)) {
@@ -2303,7 +2311,8 @@ async function request({
   method = "GET",
   body,
   extraHeaders = {},
-  raw = false
+  raw = false,
+  retryPolicy
 }) {
   const url = baseUrl.replace(/\/$/, "") + (path.startsWith("/") ? path : `/${path}`);
   const headers = { ...extraHeaders };
@@ -2312,7 +2321,8 @@ async function request({
     method,
     headers,
     body: payload,
-    credentials: "omit"
+    credentials: "omit",
+    retryPolicy
   }));
   if (raw) {
     return res;
@@ -2447,7 +2457,8 @@ class PlaycademyBaseClient {
         body: options?.body,
         baseUrl: this.baseUrl,
         extraHeaders: effectiveHeaders,
-        raw: options?.raw
+        raw: options?.raw,
+        retryPolicy: options?.retryPolicy
       });
       this.connectionManager?.reportRequestSuccess();
       return result;
@@ -2456,7 +2467,7 @@ class PlaycademyBaseClient {
       throw error;
     }
   }
-  async requestGameBackend(path, method, body, headers, raw) {
+  async requestGameBackend(path, method, body, headers, options) {
     const effectiveHeaders = {
       ...headers,
       ...this.authStrategy.getHeaders()
@@ -2468,7 +2479,8 @@ class PlaycademyBaseClient {
         body,
         baseUrl: this.getGameBackendUrl(),
         extraHeaders: effectiveHeaders,
-        raw
+        raw: options?.raw,
+        retryPolicy: options?.retryPolicy
       });
       this.connectionManager?.reportRequestSuccess();
       return result;

package/dist/internal.d.ts

@@ -7,6 +7,9 @@ import { AUTH_PROVIDER_IDS } from '@playcademy/constants';
 
 /** Permitted HTTP verbs */
 type Method = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+interface RetryPolicy {
+    retryableMethods?: readonly Method[];
+}
 
 /**
  * TimeBack Enums & Literal Types
@@ -5137,11 +5140,15 @@ declare abstract class PlaycademyBaseClient {
         body?: unknown;
         headers?: Record<string, string>;
         raw?: boolean;
+        retryPolicy?: RetryPolicy;
     }): Promise<T>;
     /**
      * Makes an authenticated HTTP request to the game's backend Worker.
      */
-    protected requestGameBackend<T>(path: string, method: Method, body?: unknown, headers?: Record<string, string>, raw?: boolean): Promise<T>;
+    protected requestGameBackend<T>(path: string, method: Method, body?: unknown, headers?: Record<string, string>, options?: {
+        raw?: boolean;
+        retryPolicy?: RetryPolicy;
+    }): Promise<T>;
     /**
      * Ensures a gameId is available, throwing an error if not.
      */

package/dist/internal.js

@@ -1037,7 +1037,7 @@ function createBackendNamespace(client) {
       return client["requestGameBackend"](normalizePath(path), method, body, headers);
     },
     async download(path, method = "GET", body, headers) {
-      return client["requestGameBackend"](normalizePath(path), method, body, headers, true);
+      return client["requestGameBackend"](normalizePath(path), method, body, headers, { raw: true });
     },
     url(pathOrStrings, ...values) {
       if (Array.isArray(pathOrStrings) && "raw" in pathOrStrings) {
@@ -1391,6 +1391,7 @@ function isValidUUID(value) {
 // src/core/activity-tracker.ts
 var DEFAULT_HIDDEN_TIMEOUT_MS = 10 * 60 * 1000;
 var DEFAULT_HEARTBEAT_INTERVAL_MS = 15000;
+var HEARTBEAT_RETRY_POLICY = { retryableMethods: ["POST"] };
 function getCurrentPausedTotal(activity, now = Date.now()) {
   if (activity.pauseStartTime === null) {
     return activity.pausedTime;
@@ -1417,9 +1418,11 @@ function markPersistedTiming(activity, timing) {
   activity.totalPersistedPausedMs += timing.pausedMs;
 }
 function queueHeartbeatFlush(activity, timing, flush) {
-  markPersistedTiming(activity, timing);
   async function doFlush() {
-    await flush();
+    const wasPersisted = await flush();
+    if (wasPersisted) {
+      markPersistedTiming(activity, timing);
+    }
   }
   if (activity.flushInFlight) {
     const previousFlush = activity.flushInFlight.catch(() => {
@@ -1537,8 +1540,11 @@ function createTimebackActivityTracker(client) {
     const body = buildHeartbeatBody(trackedActivity, timing, isFinal);
     await queueHeartbeatFlush(trackedActivity, timing, async () => {
       try {
-        await client["requestGameBackend"](TIMEBACK_ROUTES.HEARTBEAT, "POST", body);
-      } catch {}
+        await client["requestGameBackend"](TIMEBACK_ROUTES.HEARTBEAT, "POST", body, undefined, { retryPolicy: HEARTBEAT_RETRY_POLICY });
+        return true;
+      } catch {
+        return false;
+      }
     });
   }
   function handlePageHide() {
@@ -1566,9 +1572,10 @@ function createTimebackActivityTracker(client) {
           keepalive: true
         });
         if (response.ok) {
-          return;
+          return true;
         }
       } catch {}
+      return false;
     });
   }
   function cleanupListeners() {
@@ -3179,7 +3186,8 @@ async function fetchWithRetry(url, init2) {
   const startedAt = Date.now();
   for (let attempt = 0;attempt <= RETRY_DELAYS_MS.length; attempt++) {
     const retryDelayMs = RETRY_DELAYS_MS[attempt];
-    const canRetry = init2.method === "GET" && retryDelayMs !== undefined;
+    const retryableMethods = init2.retryPolicy?.retryableMethods ?? ["GET"];
+    const canRetry = retryDelayMs !== undefined && retryableMethods.includes(init2.method);
     try {
       const response = await fetch(url, init2);
       if (canRetry && isRetryableStatus(response.status)) {
@@ -3263,7 +3271,8 @@ async function request({
   method = "GET",
   body,
   extraHeaders = {},
-  raw = false
+  raw = false,
+  retryPolicy
 }) {
   const url = baseUrl.replace(/\/$/, "") + (path.startsWith("/") ? path : `/${path}`);
   const headers = { ...extraHeaders };
@@ -3272,7 +3281,8 @@ async function request({
     method,
     headers,
     body: payload,
-    credentials: "omit"
+    credentials: "omit",
+    retryPolicy
   }));
   if (raw) {
     return res;
@@ -3407,7 +3417,8 @@ class PlaycademyBaseClient {
         body: options?.body,
         baseUrl: this.baseUrl,
         extraHeaders: effectiveHeaders,
-        raw: options?.raw
+        raw: options?.raw,
+        retryPolicy: options?.retryPolicy
       });
       this.connectionManager?.reportRequestSuccess();
       return result;
@@ -3416,7 +3427,7 @@ class PlaycademyBaseClient {
       throw error;
     }
   }
-  async requestGameBackend(path, method, body, headers, raw) {
+  async requestGameBackend(path, method, body, headers, options) {
     const effectiveHeaders = {
       ...headers,
       ...this.authStrategy.getHeaders()
@@ -3428,7 +3439,8 @@ class PlaycademyBaseClient {
         body,
         baseUrl: this.getGameBackendUrl(),
         extraHeaders: effectiveHeaders,
-        raw
+        raw: options?.raw,
+        retryPolicy: options?.retryPolicy
       });
       this.connectionManager?.reportRequestSuccess();
       return result;

package/dist/types.d.ts

@@ -21,6 +21,9 @@ declare function parseOAuthState(state: string): {
 
 /** Permitted HTTP verbs */
 type Method = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+interface RetryPolicy {
+    retryableMethods?: readonly Method[];
+}
 
 /**
  * TimeBack Enums & Literal Types
@@ -4680,11 +4683,15 @@ declare abstract class PlaycademyBaseClient {
         body?: unknown;
         headers?: Record<string, string>;
         raw?: boolean;
+        retryPolicy?: RetryPolicy;
     }): Promise<T>;
     /**
      * Makes an authenticated HTTP request to the game's backend Worker.
      */
-    protected requestGameBackend<T>(path: string, method: Method, body?: unknown, headers?: Record<string, string>, raw?: boolean): Promise<T>;
+    protected requestGameBackend<T>(path: string, method: Method, body?: unknown, headers?: Record<string, string>, options?: {
+        raw?: boolean;
+        retryPolicy?: RetryPolicy;
+    }): Promise<T>;
     /**
      * Ensures a gameId is available, throwing an error if not.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sdk",
-    "version": "0.4.1-beta.8",
+    "version": "0.4.1-beta.9",
     "type": "module",
     "exports": {
         ".": {