@playbasis-ai/qwikcard-sdk 2.3.16 → 2.3.19

package/package.json

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

package/src/QwikCardApp.tsx

@@ -49,14 +49,16 @@ function AppContent({ leaderboardId }: { leaderboardId?: string }) {
       throw new Error('Missing playerId for widget bootstrap');
     }
 
-    const [player, balances, quests, allBadges, playerBadges, rewards] = await Promise.all([
-      client.getPlayer(playerId),
-      client.getBalances(playerId),
-      client.getPlayerQuests(playerId),
-      client.getBadges(),
-      client.getPlayerBadges(playerId),
-      client.getRewards().catch(() => []), // Gracefully handle if rewards endpoint doesn't exist
-    ]);
+    const [player, balances, playerQuests, questCatalog, allBadges, playerBadges, rewards] =
+      await Promise.all([
+        client.getPlayer(playerId),
+        client.getBalances(playerId),
+        client.getPlayerQuests(playerId),
+        client.getQuests(),
+        client.getBadges(),
+        client.getPlayerBadges(playerId),
+        client.getRewards().catch(() => []), // Gracefully handle if rewards endpoint doesn't exist
+      ]);
 
     const xp = balances.find((b) => b.currency === 'xp')?.balance ?? 0;
     const qwikCoins = balances.find((b) => b.currency === 'qwik-coins')?.balance ?? 0;
@@ -92,24 +94,35 @@ function AppContent({ leaderboardId }: { leaderboardId?: string }) {
         earnedDelta: 0,
         qwikCoins,
       },
-      goals: quests.map((q) => ({
-        goalId: q.id,
-        type: 'financial',
-        target: q.target,
-        current: q.progress,
-        progressPct: q.target > 0 ? Math.round((q.progress / q.target) * 100) : 0,
-        startDate: new Date().toISOString().slice(0, 10),
-        endDate: q.expiresAt ?? new Date(Date.now() + 7 * 24 * 60 * 60 * 1000).toISOString(),
-        status:
-          q.status === 'completed' ? 'completed' : q.status === 'expired' ? 'at_risk' : 'on_track',
-        rewards: {
-          xp: q.rewards?.find((r) => r.type === 'points')?.amount || 100,
-          badges: (q.rewards
-            ?.filter((r) => r.type === 'badge')
-            .map((r) => r.badgeId)
-            .filter(Boolean) || []) as string[],
-        },
-      })),
+      goals: (() => {
+        const quests = playerQuests.length > 0 ? playerQuests : questCatalog;
+        const nowIso = new Date().toISOString().slice(0, 10);
+        return quests.map((q) => ({
+          goalId: q.id,
+          type: 'financial',
+          target: q.target ?? 1,
+          current: q.progress ?? 0,
+          progressPct:
+            q.target && q.target > 0
+              ? Math.round(((q.progress ?? 0) / q.target) * 100)
+              : 0,
+          startDate: nowIso,
+          endDate: q.expiresAt ?? new Date(Date.now() + 7 * 24 * 60 * 60 * 1000).toISOString(),
+          status:
+            q.status === 'completed'
+              ? 'completed'
+              : q.status === 'expired'
+                ? 'at_risk'
+                : 'on_track',
+          rewards: {
+            xp: q.rewards?.find((r) => r.type === 'points')?.amount || 100,
+            badges: (q.rewards
+              ?.filter((r) => r.type === 'badge')
+              .map((r) => r.badgeId)
+              .filter(Boolean) || []) as string[],
+          },
+        }));
+      })(),
       badges: allBadges.map((b) => ({
         id: b.id,
         name: b.name,

package/src/api/client.ts

@@ -247,10 +247,11 @@ export class PlaybasisClient {
   }
 
   async getPlayerQuests(playerId: string): Promise<Quest[]> {
-    const data = await this.request<{ quests?: Quest[]; items?: Quest[] }>(
+    const data = await this.request<Quest[] | { quests?: Quest[]; items?: Quest[] }>(
       'GET',
       `/players/${encodeURIComponent(playerId)}/quests`,
     );
+    if (Array.isArray(data)) return data;
     return data.quests || data.items || [];
   }
 
@@ -272,10 +273,11 @@ export class PlaybasisClient {
   }
 
   async getPlayerBadges(playerId: string): Promise<Badge[]> {
-    const data = await this.request<{ badges?: Badge[]; items?: Badge[] }>(
+    const data = await this.request<Badge[] | { badges?: Badge[]; items?: Badge[] }>(
       'GET',
       `/players/${encodeURIComponent(playerId)}/badges`,
     );
+    if (Array.isArray(data)) return data;
     return data.badges || data.items || [];
   }
 
@@ -309,12 +311,56 @@ export class PlaybasisClient {
     if (options?.limit) params.set('limit', String(options.limit));
     if (options?.cursor) params.set('cursor', options.cursor);
 
-    const data = await this.request<{
-      leaderboard?: { entries?: LeaderboardEntry[]; total?: number };
-    }>('GET', `/leaderboards/${encodeURIComponent(leaderboardId)}?${params}`);
+    const data = await this.request<
+      | { entries?: LeaderboardEntry[]; total?: number }
+      | { items?: LeaderboardEntry[]; total?: number }
+      | { leaderboard?: { entries?: LeaderboardEntry[]; total?: number } }
+    >('GET', `/leaderboards/${encodeURIComponent(leaderboardId)}?${params}`);
+    const leaderboardData = data as { leaderboard?: { entries?: LeaderboardEntry[]; total?: number } };
+    const entries =
+      'entries' in data
+        ? data.entries
+        : 'items' in data
+          ? data.items
+          : leaderboardData.leaderboard?.entries;
+    const total =
+      'total' in data && typeof data.total === 'number'
+        ? data.total
+        : leaderboardData.leaderboard?.total ?? entries?.length ?? 0;
+
+    const normalizedEntries = (entries || []).map((entry, index) => {
+      const raw = entry as LeaderboardEntry & {
+        balance?: number;
+        points?: number;
+        value?: number;
+        name?: string;
+        id?: string;
+      };
+      const score =
+        typeof raw.score === 'number'
+          ? raw.score
+          : typeof raw.balance === 'number'
+            ? raw.balance
+            : typeof raw.points === 'number'
+              ? raw.points
+              : typeof raw.value === 'number'
+                ? raw.value
+                : 0;
+      const rank = typeof raw.rank === 'number' ? raw.rank : index + 1;
+      const displayName = raw.displayName || raw.name || raw.playerId || 'Player';
+      const playerId = raw.playerId || raw.id || displayName;
+
+      return {
+        playerId,
+        displayName,
+        rank,
+        score,
+        metadata: raw.metadata,
+      };
+    });
     return {
-      entries: data.leaderboard?.entries || [],
-      total: data.leaderboard?.total || 0,
+      entries: normalizedEntries,
+      total,
     };
   }