@playbasis-ai/qwikcard-sdk 2.3.14 → 2.3.16

package/CHANGELOG.md

@@ -67,6 +67,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Fallback badge image mapping for Qwik slugs when API omits image URLs.
 
+## [2.3.15] - 2026-01-30
+
+### Added
+
+- Lightweight request retries/timeouts with opt-in configuration for smoother client UX.
+
+## [2.3.16] - 2026-01-30
+
+### Changed
+
+- Improved empty-state guidance and skeletons in dashboard quest/badge/leaderboard panels.
+
 ## [2.3.11] - 2026-01-29
 
 ### Changed

package/dist/PlaybasisProvider.d.ts

@@ -12,8 +12,10 @@ interface PlaybasisProviderProps {
     tenantId?: string;
     playerId?: string;
     baseUrl?: string;
+    requestTimeoutMs?: number;
+    requestRetries?: number;
 }
-export declare function PlaybasisProvider({ children, apiKey, tenantId, playerId, baseUrl, }: PlaybasisProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function PlaybasisProvider({ children, apiKey, tenantId, playerId, baseUrl, requestTimeoutMs, requestRetries, }: PlaybasisProviderProps): import("react/jsx-runtime").JSX.Element;
 export declare function usePlaybasis(): PlaybasisContextValue;
 export default PlaybasisProvider;
 //# sourceMappingURL=PlaybasisProvider.d.ts.map

package/dist/PlaybasisProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlaybasisProvider.d.ts","sourceRoot":"","sources":["../src/PlaybasisProvider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAO/C,UAAU,qBAAqB;IAC7B,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAQD,UAAU,sBAAsB;IAC9B,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAiBD,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,OAAO,GACR,EAAE,sBAAsB,2CAwBxB;AAMD,wBAAgB,YAAY,IAAI,qBAAqB,CAMpD;AAED,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"PlaybasisProvider.d.ts","sourceRoot":"","sources":["../src/PlaybasisProvider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAO/C,UAAU,qBAAqB;IAC7B,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAQD,UAAU,sBAAsB;IAC9B,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAiBD,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,gBAAgB,EAChB,cAAc,GACf,EAAE,sBAAsB,2CA+BxB;AAMD,wBAAgB,YAAY,IAAI,qBAAqB,CAMpD;AAED,eAAe,iBAAiB,CAAC"}

package/dist/PlaybasisProvider.js

@@ -17,10 +17,16 @@ const resolveBaseUrl = (tenantId, baseUrl) => {
 // ─────────────────────────────────────────────────────────────────────────────
 // Provider Component
 // ─────────────────────────────────────────────────────────────────────────────
-export function PlaybasisProvider({ children, apiKey, tenantId, playerId, baseUrl, }) {
+export function PlaybasisProvider({ children, apiKey, tenantId, playerId, baseUrl, requestTimeoutMs, requestRetries, }) {
     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]);
+    const client = useMemo(() => new PlaybasisClient({
+        apiKey,
+        tenantId: resolvedTenantId,
+        baseUrl: resolvedBaseUrl,
+        timeoutMs: requestTimeoutMs,
+        retries: requestRetries,
+    }), [apiKey, resolvedTenantId, resolvedBaseUrl, requestTimeoutMs, requestRetries]);
     const value = useMemo(() => ({
         client,
         tenantId: resolvedTenantId,

package/dist/QwikCardApp.d.ts

@@ -4,6 +4,8 @@ export interface QwikCardAppProps {
     playerId: string;
     baseUrl?: string;
     leaderboardId?: string;
+    requestTimeoutMs?: number;
+    requestRetries?: number;
 }
 export declare function QwikCardApp(props: QwikCardAppProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=QwikCardApp.d.ts.map

package/dist/QwikCardApp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QwikCardApp.d.ts","sourceRoot":"","sources":["../src/QwikCardApp.tsx"],"names":[],"mappings":"AAUA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAwRD,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,2CAMlD"}
+{"version":3,"file":"QwikCardApp.d.ts","sourceRoot":"","sources":["../src/QwikCardApp.tsx"],"names":[],"mappings":"AAUA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAwRD,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,2CAMlD"}

package/dist/api/client.d.ts

@@ -4,12 +4,16 @@ interface ClientConfig {
     tenantId: string;
     baseUrl?: string;
     fetchImpl?: typeof fetch;
+    timeoutMs?: number;
+    retries?: number;
 }
 export declare class PlaybasisClient {
     private readonly baseUrl;
     private readonly fetchImpl;
     private readonly apiKey;
     private readonly tenantId;
+    private readonly timeoutMs;
+    private readonly retries;
     constructor(config: ClientConfig);
     /**
      * Generate a unique ID for idempotency keys.

package/dist/api/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"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"}

package/dist/api/client.js

@@ -8,6 +8,8 @@ export class PlaybasisClient {
         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;
     }
     /**
      * Generate a unique ID for idempotency keys.
@@ -22,49 +24,74 @@ export class PlaybasisClient {
     }
     async request(method, path, options) {
         const url = `${this.baseUrl}${path.startsWith('/') ? '' : '/'}${path}`;
-        // Build headers with Content-Type set before creating init
-        const headers = {
-            '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 init = {
-            method,
-            headers,
-            body: options?.body !== undefined ? JSON.stringify(options.body) : undefined,
-        };
-        const response = await this.fetchImpl(url, init);
-        const text = await response.text();
-        // Safely parse JSON - server may return non-JSON (e.g., HTML error page)
-        let json;
-        if (text) {
+        const attemptRequest = async () => {
+            const headers = {
+                'Ocp-Apim-Subscription-Key': this.apiKey,
+                'X-Tenant-ID': this.tenantId,
+                ...options?.headers,
+            };
+            if (options?.body !== undefined) {
+                headers['Content-Type'] = headers['Content-Type'] ?? 'application/json';
+            }
+            const controller = typeof AbortController !== 'undefined' ? new AbortController() : null;
+            const timeoutId = this.timeoutMs
+                ? setTimeout(() => controller?.abort(), this.timeoutMs)
+                : null;
             try {
-                json = JSON.parse(text);
+                const init = {
+                    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;
+                if (text) {
+                    try {
+                        json = JSON.parse(text);
+                    }
+                    catch {
+                        json = undefined;
+                    }
+                }
+                const getErrorMessage = (value) => {
+                    if (!value || typeof value !== 'object')
+                        return undefined;
+                    if (!('message' in value))
+                        return undefined;
+                    const messageValue = value.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));
+                    error.status = response.status;
+                    throw error;
+                }
+                return json;
             }
-            catch {
-                // Response is not valid JSON - leave as undefined
-                json = undefined;
+            finally {
+                if (timeoutId)
+                    clearTimeout(timeoutId);
             }
-        }
-        const getErrorMessage = (value) => {
-            if (!value || typeof value !== 'object')
-                return undefined;
-            if (!('message' in value))
-                return undefined;
-            const messageValue = value.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.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;
+        throw new Error('Request failed after retries');
     }
     // ─────────────────────────────────────────────────────────────────────────
     // Players