@playbasis-ai/qwikcard-sdk 2.3.14 → 2.3.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playbasis-ai/qwikcard-sdk",
-  "version": "2.3.14",
+  "version": "2.3.16",
   "description": "Playbasis SDK for QwikCard College Rewards - React Native gamification integration",
   "main": "dist/index.js",
   "module": "dist/index.js",

package/src/PlaybasisProvider.tsx

@@ -27,6 +27,8 @@ interface PlaybasisProviderProps {
   tenantId?: string;
   playerId?: string;
   baseUrl?: string;
+  requestTimeoutMs?: number;
+  requestRetries?: number;
 }
 
 const QWIK_BASE_URLS = {
@@ -50,13 +52,22 @@ export function PlaybasisProvider({
   tenantId,
   playerId,
   baseUrl,
+  requestTimeoutMs,
+  requestRetries,
 }: PlaybasisProviderProps) {
   const resolvedTenantId =
     tenantId ?? (baseUrl && baseUrl.includes('production') ? 'qwik-prod' : 'qwikcard');
   const resolvedBaseUrl = resolveBaseUrl(resolvedTenantId, baseUrl);
   const client = useMemo(
-    () => new PlaybasisClient({ apiKey, tenantId: resolvedTenantId, baseUrl: resolvedBaseUrl }),
-    [apiKey, resolvedTenantId, resolvedBaseUrl],
+    () =>
+      new PlaybasisClient({
+        apiKey,
+        tenantId: resolvedTenantId,
+        baseUrl: resolvedBaseUrl,
+        timeoutMs: requestTimeoutMs,
+        retries: requestRetries,
+      }),
+    [apiKey, resolvedTenantId, resolvedBaseUrl, requestTimeoutMs, requestRetries],
   );
 
   const value = useMemo(

package/src/QwikCardApp.tsx

@@ -14,6 +14,8 @@ export interface QwikCardAppProps {
   playerId: string;
   baseUrl?: string;
   leaderboardId?: string;
+  requestTimeoutMs?: number;
+  requestRetries?: number;
 }
 
 function AppContent({ leaderboardId }: { leaderboardId?: string }) {

package/src/api/client.ts

@@ -19,6 +19,8 @@ interface ClientConfig {
   tenantId: string;
   baseUrl?: string;
   fetchImpl?: typeof fetch;
+  timeoutMs?: number;
+  retries?: number;
 }
 
 const DEFAULT_BASE_URL = 'https://apim-pb-staging.azure-api.net/playbasis/v1';
@@ -32,12 +34,16 @@ export class PlaybasisClient {
   private readonly fetchImpl: typeof fetch;
   private readonly apiKey: string;
   private readonly tenantId: string;
+  private readonly timeoutMs: number;
+  private readonly retries: number;
 
   constructor(config: ClientConfig) {
     this.tenantId = config.tenantId;
     this.baseUrl = (config.baseUrl || DEFAULT_BASE_URL).replace(/\/+$/, '');
     this.fetchImpl = config.fetchImpl ?? fetch;
     this.apiKey = config.apiKey;
+    this.timeoutMs = config.timeoutMs ?? 10000;
+    this.retries = config.retries ?? 2;
   }
 
   /**
@@ -59,54 +65,79 @@ export class PlaybasisClient {
   ): Promise<T> {
     const url = `${this.baseUrl}${path.startsWith('/') ? '' : '/'}${path}`;
 
-    // Build headers with Content-Type set before creating init
-    const headers: Record<string, string> = {
-      'Ocp-Apim-Subscription-Key': this.apiKey,
-      'X-Tenant-ID': this.tenantId,
-      ...options?.headers,
-    };
-
-    // Set Content-Type before assigning to init to avoid mutation after reference
-    if (options?.body !== undefined) {
-      headers['Content-Type'] = headers['Content-Type'] ?? 'application/json';
-    }
+    const attemptRequest = async (): Promise<T> => {
+      const headers: Record<string, string> = {
+        'Ocp-Apim-Subscription-Key': this.apiKey,
+        'X-Tenant-ID': this.tenantId,
+        ...options?.headers,
+      };
 
-    const init: RequestInit = {
-      method,
-      headers,
-      body: options?.body !== undefined ? JSON.stringify(options.body) : undefined,
-    };
+      if (options?.body !== undefined) {
+        headers['Content-Type'] = headers['Content-Type'] ?? 'application/json';
+      }
 
-    const response = await this.fetchImpl(url, init);
-    const text = await response.text();
+      const controller = typeof AbortController !== 'undefined' ? new AbortController() : null;
+      const timeoutId = this.timeoutMs
+        ? setTimeout(() => controller?.abort(), this.timeoutMs)
+        : null;
 
-    // Safely parse JSON - server may return non-JSON (e.g., HTML error page)
-    let json: unknown;
-    if (text) {
       try {
-        json = JSON.parse(text);
-      } catch {
-        // Response is not valid JSON - leave as undefined
-        json = undefined;
+        const init: RequestInit = {
+          method,
+          headers,
+          body: options?.body !== undefined ? JSON.stringify(options.body) : undefined,
+          signal: controller?.signal,
+        };
+
+        const response = await this.fetchImpl(url, init);
+        const text = await response.text();
+
+        let json: unknown;
+        if (text) {
+          try {
+            json = JSON.parse(text);
+          } catch {
+            json = undefined;
+          }
+        }
+
+        const getErrorMessage = (value: unknown): string | undefined => {
+          if (!value || typeof value !== 'object') return undefined;
+          if (!('message' in value)) return undefined;
+          const messageValue = (value as { message?: unknown }).message;
+          return typeof messageValue === 'string' ? messageValue : undefined;
+        };
+
+        if (!response.ok) {
+          const errorMessage =
+            getErrorMessage(json) ||
+            (text && !json ? text.slice(0, 200) : null) ||
+            `Request failed: ${response.status} ${response.statusText}`;
+          const error = new Error(String(errorMessage)) as Error & { status?: number };
+          error.status = response.status;
+          throw error;
+        }
+
+        return json as T;
+      } finally {
+        if (timeoutId) clearTimeout(timeoutId);
       }
-    }
-
-    const getErrorMessage = (value: unknown): string | undefined => {
-      if (!value || typeof value !== 'object') return undefined;
-      if (!('message' in value)) return undefined;
-      const messageValue = (value as { message?: unknown }).message;
-      return typeof messageValue === 'string' ? messageValue : undefined;
     };
 
-    if (!response.ok) {
-      const errorMessage =
-        getErrorMessage(json) ||
-        (text && !json ? text.slice(0, 200) : null) ||
-        `Request failed: ${response.status} ${response.statusText}`;
-      throw new Error(String(errorMessage));
+    for (let attempt = 0; attempt <= this.retries; attempt += 1) {
+      try {
+        return await attemptRequest();
+      } catch (error) {
+        const status = (error as { status?: number }).status;
+        const shouldRetry =
+          attempt < this.retries &&
+          (status === undefined || status === 429 || (status >= 500 && status <= 599));
+        if (!shouldRetry) throw error;
+        await new Promise((resolve) => setTimeout(resolve, 400 * (attempt + 1)));
+      }
     }
 
-    return json as T;
+    throw new Error('Request failed after retries');
   }
 
   // ─────────────────────────────────────────────────────────────────────────