@playbasis-ai/qwikcard-sdk 2.3.16 → 2.3.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/dist/QwikCardApp.d.ts.map +1 -1
  3. package/dist/QwikCardApp.js +29 -18
  4. package/dist/api/client.d.ts.map +1 -1
  5. package/dist/api/client.js +4 -0
  6. package/package.json +1 -1
  7. package/src/QwikCardApp.tsx +39 -26
  8. package/src/api/client.ts +4 -2
package/CHANGELOG.md CHANGED
@@ -79,6 +79,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
79
79
 
80
80
  - Improved empty-state guidance and skeletons in dashboard quest/badge/leaderboard panels.
81
81
 
82
+ ## [2.3.17] - 2026-01-30
83
+
84
+ ### Fixed
85
+
86
+ - Use quest catalog when player progress is empty so quests render immediately.
87
+ - Support array responses for player quests/badges.
88
+
82
89
  ## [2.3.11] - 2026-01-29
83
90
 
84
91
  ### Changed
package/dist/QwikCardApp.d.ts.map CHANGED
@@ -1 +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;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAwRD,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,2CAMlD"}
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;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAqSD,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,2CAMlD"}
package/dist/QwikCardApp.js CHANGED
@@ -31,10 +31,11 @@ function AppContent({ leaderboardId }) {
31
31
  if (!playerId) {
32
32
  throw new Error('Missing playerId for widget bootstrap');
33
33
  }
34
- const [player, balances, quests, allBadges, playerBadges, rewards] = await Promise.all([
34
+ const [player, balances, playerQuests, questCatalog, allBadges, playerBadges, rewards] = await Promise.all([
35
35
  client.getPlayer(playerId),
36
36
  client.getBalances(playerId),
37
37
  client.getPlayerQuests(playerId),
38
+ client.getQuests(),
38
39
  client.getBadges(),
39
40
  client.getPlayerBadges(playerId),
40
41
  client.getRewards().catch(() => []), // Gracefully handle if rewards endpoint doesn't exist
@@ -72,23 +73,33 @@ function AppContent({ leaderboardId }) {
72
73
  earnedDelta: 0,
73
74
  qwikCoins,
74
75
  },
75
- goals: quests.map((q) => ({
76
- goalId: q.id,
77
- type: 'financial',
78
- target: q.target,
79
- current: q.progress,
80
- progressPct: q.target > 0 ? Math.round((q.progress / q.target) * 100) : 0,
81
- startDate: new Date().toISOString().slice(0, 10),
82
- endDate: q.expiresAt ?? new Date(Date.now() + 7 * 24 * 60 * 60 * 1000).toISOString(),
83
- status: q.status === 'completed' ? 'completed' : q.status === 'expired' ? 'at_risk' : 'on_track',
84
- rewards: {
85
- xp: q.rewards?.find((r) => r.type === 'points')?.amount || 100,
86
- badges: (q.rewards
87
- ?.filter((r) => r.type === 'badge')
88
- .map((r) => r.badgeId)
89
- .filter(Boolean) || []),
90
- },
91
- })),
76
+ goals: (() => {
77
+ const quests = playerQuests.length > 0 ? playerQuests : questCatalog;
78
+ const nowIso = new Date().toISOString().slice(0, 10);
79
+ return quests.map((q) => ({
80
+ goalId: q.id,
81
+ type: 'financial',
82
+ target: q.target ?? 1,
83
+ current: q.progress ?? 0,
84
+ progressPct: q.target && q.target > 0
85
+ ? Math.round(((q.progress ?? 0) / q.target) * 100)
86
+ : 0,
87
+ startDate: nowIso,
88
+ endDate: q.expiresAt ?? new Date(Date.now() + 7 * 24 * 60 * 60 * 1000).toISOString(),
89
+ status: q.status === 'completed'
90
+ ? 'completed'
91
+ : q.status === 'expired'
92
+ ? 'at_risk'
93
+ : 'on_track',
94
+ rewards: {
95
+ xp: q.rewards?.find((r) => r.type === 'points')?.amount || 100,
96
+ badges: (q.rewards
97
+ ?.filter((r) => r.type === 'badge')
98
+ .map((r) => r.badgeId)
99
+ .filter(Boolean) || []),
100
+ },
101
+ }));
102
+ })(),
92
103
  badges: allBadges.map((b) => ({
93
104
  id: b.id,
94
105
  name: b.name,
package/dist/api/client.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"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"}
package/dist/api/client.js CHANGED
@@ -162,6 +162,8 @@ export class PlaybasisClient {
162
162
  }
163
163
  async getPlayerQuests(playerId) {
164
164
  const data = await this.request('GET', `/players/${encodeURIComponent(playerId)}/quests`);
165
+ if (Array.isArray(data))
166
+ return data;
165
167
  return data.quests || data.items || [];
166
168
  }
167
169
  async getQuestProgress(playerId, questId) {
@@ -177,6 +179,8 @@ export class PlaybasisClient {
177
179
  }
178
180
  async getPlayerBadges(playerId) {
179
181
  const data = await this.request('GET', `/players/${encodeURIComponent(playerId)}/badges`);
182
+ if (Array.isArray(data))
183
+ return data;
180
184
  return data.badges || data.items || [];
181
185
  }
182
186
  // ─────────────────────────────────────────────────────────────────────────
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@playbasis-ai/qwikcard-sdk",
3
- "version": "2.3.16",
3
+ "version": "2.3.17",
4
4
  "description": "Playbasis SDK for QwikCard College Rewards - React Native gamification integration",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.js",
package/src/QwikCardApp.tsx CHANGED
@@ -49,14 +49,16 @@ function AppContent({ leaderboardId }: { leaderboardId?: string }) {
49
49
  throw new Error('Missing playerId for widget bootstrap');
50
50
  }
51
51
 
52
- const [player, balances, quests, allBadges, playerBadges, rewards] = await Promise.all([
53
- client.getPlayer(playerId),
54
- client.getBalances(playerId),
55
- client.getPlayerQuests(playerId),
56
- client.getBadges(),
57
- client.getPlayerBadges(playerId),
58
- client.getRewards().catch(() => []), // Gracefully handle if rewards endpoint doesn't exist
59
- ]);
52
+ const [player, balances, playerQuests, questCatalog, allBadges, playerBadges, rewards] =
53
+ await Promise.all([
54
+ client.getPlayer(playerId),
55
+ client.getBalances(playerId),
56
+ client.getPlayerQuests(playerId),
57
+ client.getQuests(),
58
+ client.getBadges(),
59
+ client.getPlayerBadges(playerId),
60
+ client.getRewards().catch(() => []), // Gracefully handle if rewards endpoint doesn't exist
61
+ ]);
60
62
 
61
63
  const xp = balances.find((b) => b.currency === 'xp')?.balance ?? 0;
62
64
  const qwikCoins = balances.find((b) => b.currency === 'qwik-coins')?.balance ?? 0;
@@ -92,24 +94,35 @@ function AppContent({ leaderboardId }: { leaderboardId?: string }) {
92
94
  earnedDelta: 0,
93
95
  qwikCoins,
94
96
  },
95
- goals: quests.map((q) => ({
96
- goalId: q.id,
97
- type: 'financial',
98
- target: q.target,
99
- current: q.progress,
100
- progressPct: q.target > 0 ? Math.round((q.progress / q.target) * 100) : 0,
101
- startDate: new Date().toISOString().slice(0, 10),
102
- endDate: q.expiresAt ?? new Date(Date.now() + 7 * 24 * 60 * 60 * 1000).toISOString(),
103
- status:
104
- q.status === 'completed' ? 'completed' : q.status === 'expired' ? 'at_risk' : 'on_track',
105
- rewards: {
106
- xp: q.rewards?.find((r) => r.type === 'points')?.amount || 100,
107
- badges: (q.rewards
108
- ?.filter((r) => r.type === 'badge')
109
- .map((r) => r.badgeId)
110
- .filter(Boolean) || []) as string[],
111
- },
112
- })),
97
+ goals: (() => {
98
+ const quests = playerQuests.length > 0 ? playerQuests : questCatalog;
99
+ const nowIso = new Date().toISOString().slice(0, 10);
100
+ return quests.map((q) => ({
101
+ goalId: q.id,
102
+ type: 'financial',
103
+ target: q.target ?? 1,
104
+ current: q.progress ?? 0,
105
+ progressPct:
106
+ q.target && q.target > 0
107
+ ? Math.round(((q.progress ?? 0) / q.target) * 100)
108
+ : 0,
109
+ startDate: nowIso,
110
+ endDate: q.expiresAt ?? new Date(Date.now() + 7 * 24 * 60 * 60 * 1000).toISOString(),
111
+ status:
112
+ q.status === 'completed'
113
+ ? 'completed'
114
+ : q.status === 'expired'
115
+ ? 'at_risk'
116
+ : 'on_track',
117
+ rewards: {
118
+ xp: q.rewards?.find((r) => r.type === 'points')?.amount || 100,
119
+ badges: (q.rewards
120
+ ?.filter((r) => r.type === 'badge')
121
+ .map((r) => r.badgeId)
122
+ .filter(Boolean) || []) as string[],
123
+ },
124
+ }));
125
+ })(),
113
126
  badges: allBadges.map((b) => ({
114
127
  id: b.id,
115
128
  name: b.name,
package/src/api/client.ts CHANGED
@@ -247,10 +247,11 @@ export class PlaybasisClient {
247
247
  }
248
248
 
249
249
  async getPlayerQuests(playerId: string): Promise<Quest[]> {
250
- const data = await this.request<{ quests?: Quest[]; items?: Quest[] }>(
250
+ const data = await this.request<Quest[] | { quests?: Quest[]; items?: Quest[] }>(
251
251
  'GET',
252
252
  `/players/${encodeURIComponent(playerId)}/quests`,
253
253
  );
254
+ if (Array.isArray(data)) return data;
254
255
  return data.quests || data.items || [];
255
256
  }
256
257
 
@@ -272,10 +273,11 @@ export class PlaybasisClient {
272
273
  }
273
274
 
274
275
  async getPlayerBadges(playerId: string): Promise<Badge[]> {
275
- const data = await this.request<{ badges?: Badge[]; items?: Badge[] }>(
276
+ const data = await this.request<Badge[] | { badges?: Badge[]; items?: Badge[] }>(
276
277
  'GET',
277
278
  `/players/${encodeURIComponent(playerId)}/badges`,
278
279
  );
280
+ if (Array.isArray(data)) return data;
279
281
  return data.badges || data.items || [];
280
282
  }
281
283