@solworks/poll-api-client 0.1.0 → 0.1.2

package/dist/client.js

@@ -72,11 +72,15 @@ export class PollClient {
     }
     // ── User ──────────────────────────────────────────────────────────────
     async getAccount() {
-        return this.request('GET', '/api/user/account');
+        // API returns { user: {...}, address: string, error: null }
+        const res = await this.request('GET', '/api/user/account');
+        return { ...res.user, walletAddress: res.address };
     }
     async getProfile(uuid) {
+        // API returns { profile: {...}, stats: {...}, error: null }
         const path = uuid ? `/api/user/profile/${uuid}` : '/api/user/profile';
-        return this.request('GET', path);
+        const res = await this.request('GET', path);
+        return { ...res.profile, stats: res.stats };
     }
     async updateDisplayName(name) {
         await this.request('POST', '/api/user/account/displayname', {
@@ -84,30 +88,40 @@ export class PollClient {
         });
     }
     async getXpBalance() {
+        // API returns { xp: number, error: null }
         return this.request('GET', '/api/user/balance');
     }
     async getUsdcBalance() {
-        return this.request('GET', '/api/user/usdc/balance');
+        // API returns { balance: number, error: null } — field is "balance", not "usdc"
+        const res = await this.request('GET', '/api/user/usdc/balance');
+        return { usdc: res.balance, error: res.error };
     }
     // ── Bets ──────────────────────────────────────────────────────────────
+    // Bets endpoints use ResponseBuilder: { data: T, error: {...}, request: {...} }
     async listPublicBets(params) {
         const path = this.buildUrl('/api/bets-usdc/all/public', params);
-        return this.request('GET', path);
+        const res = await this.request('GET', path);
+        return res.data;
     }
     async getTrendingBets() {
-        return this.request('GET', '/api/bets-usdc/all/public/trending');
+        const res = await this.request('GET', '/api/bets-usdc/all/public/trending');
+        return res.data;
     }
     async getNewBets() {
-        return this.request('GET', '/api/bets-usdc/all/public/new');
+        const res = await this.request('GET', '/api/bets-usdc/all/public/new');
+        return res.data;
     }
     async getBet(id) {
-        return this.request('GET', `/api/bets-usdc/all/public/single/${id}`);
+        const res = await this.request('GET', `/api/bets-usdc/all/public/single/${id}`);
+        return res.data;
     }
     async getMyBets() {
-        return this.request('GET', '/api/bets-usdc/mine');
+        const res = await this.request('GET', '/api/bets-usdc/mine');
+        return res.data;
     }
     async createBet(params) {
-        return this.request('POST', '/api/bets-usdc', params);
+        const res = await this.request('POST', '/api/bets-usdc', params);
+        return res.data;
     }
     async joinBet(betAddress) {
         return this.request('POST', '/api/bets-usdc/join', { betAddress });
@@ -130,33 +144,44 @@ export class PollClient {
         return this.request('POST', '/api/bets-usdc/settle', { betAddress });
     }
     async getProbabilityHistory(betAddress) {
-        return this.request('GET', `/api/bets-usdc/all/public/single/${betAddress}/probability-history`);
+        // API returns { data: { betAddress, dataPoints: [...] } }
+        const res = await this.request('GET', `/api/bets-usdc/all/public/single/${betAddress}/probability-history`);
+        return res.data.dataPoints;
     }
     // ── Wagers ────────────────────────────────────────────────────────────
     async getMyWagers(params) {
+        // API returns { data: [...], error: {...}, request: {...} }
         const path = this.buildUrl('/api/bets-usdc/wagers', params);
-        return this.request('GET', path);
+        const res = await this.request('GET', path);
+        return res.data;
     }
     // ── Leaderboard ───────────────────────────────────────────────────────
     async getLeaderboard() {
-        return this.request('GET', '/api/leaderboard');
+        // API returns { leaderboard: [...], pagination: {...} }
+        const res = await this.request('GET', '/api/leaderboard');
+        return res.leaderboard;
     }
     async getMyRanking() {
         return this.request('GET', '/api/leaderboard/me');
     }
     // ── Social ────────────────────────────────────────────────────────────
     async getFriends() {
-        return this.request('GET', '/api/user/friends');
+        // API returns { friends: [...], totalCount, error }
+        const res = await this.request('GET', '/api/user/friends');
+        return res.friends;
     }
     async sendFriendRequest(uuid) {
-        return this.request('POST', '/api/user/friends/request', { uuid });
+        // API expects { targetUserUuid } not { uuid }
+        return this.request('POST', '/api/user/friends/request', { targetUserUuid: uuid });
     }
     async respondFriendRequest(id, accept) {
         const action = accept ? 'accept' : 'decline';
         return this.request('PUT', `/api/user/friends/request/${id}/${action}`);
     }
     async getFavouriteBets() {
-        return this.request('GET', '/api/user/favourites/bets');
+        // API returns { data: [...], error }
+        const res = await this.request('GET', '/api/user/favourites/bets');
+        return res.data;
     }
     async favouriteBet(betAddress) {
         return this.request('POST', '/api/user/favourites/bets', {
@@ -171,12 +196,16 @@ export class PollClient {
     }
     // ── Wallet ────────────────────────────────────────────────────────────
     async getWalletTransactions() {
-        return this.request('GET', '/api/user/wallet/transactions');
+        // API returns { transactions: [...], error }
+        const res = await this.request('GET', '/api/user/wallet/transactions');
+        return res.transactions;
     }
     // ── Notifications ─────────────────────────────────────────────────────
     async getNotifications(params) {
+        // API returns { notifications: [...], unreadCount, totalCount, page, limit, hasMore, error }
         const path = this.buildUrl('/api/user/notifications', params);
-        return this.request('GET', path);
+        const res = await this.request('GET', path);
+        return res.notifications;
     }
     async markNotificationRead(id) {
         return this.request('POST', '/api/user/notification/read', {

package/dist/types.d.ts

@@ -22,16 +22,18 @@ export interface UserAccount {
     email: string | null;
     xpBalance: number;
     balance: number;
+    walletAddress?: string;
     [key: string]: unknown;
 }
 export interface UserProfile {
-    id: number;
     uuid: string;
     displayName: string | null;
+    profileImageUrl: string | null;
+    stats?: Record<string, unknown>;
     [key: string]: unknown;
 }
 export interface Balance {
-    xp: number;
+    xp?: number;
     usdc?: number;
     error: string | null;
 }
@@ -55,6 +57,8 @@ export interface Friend {
     id: number;
     uuid: string;
     displayName: string | null;
+    profileImageUrl: string | null;
+    friendsSince?: string;
     [key: string]: unknown;
 }
 export interface WalletTransaction {
@@ -66,10 +70,10 @@ export interface WalletTransaction {
 }
 export interface Notification {
     id: string;
-    type: string;
+    eventType: string;
     title: string;
-    body?: string;
-    read: boolean;
+    description?: string;
+    readAt: string | null;
     createdAt: string;
     [key: string]: unknown;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solworks/poll-api-client",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Typed HTTP client for the Poll.fun REST API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/tests/unit/endpoints/bets.test.ts

@@ -3,6 +3,12 @@ import { PollClient } from '../../../src/client';
 import { createMockFetch, mockJsonResponse } from '../../helpers/mock-fetch';
 import { createBetFixture } from '../../fixtures';
 
+// API bets endpoints return ResponseBuilder.success() wrapper:
+// { data: T, error: { message: null, logs: [] }, request: { uuid, latency } }
+function wrapResponse<T>(data: T) {
+  return { data, error: { message: null, logs: [] }, request: { uuid: 'req-123', latency: 10 } };
+}
+
 describe('Bets endpoints', () => {
   let mockFetch: ReturnType<typeof createMockFetch>;
   let client: PollClient;
@@ -16,9 +22,9 @@ describe('Bets endpoints', () => {
     });
   });
 
-  it('listPublicBets sends correct GET', async () => {
+  it('listPublicBets sends correct GET and unwraps data', async () => {
     const bets = [createBetFixture(), createBetFixture()];
-    mockFetch.mockResolvedValue(mockJsonResponse(bets));
+    mockFetch.mockResolvedValue(mockJsonResponse(wrapResponse(bets)));
 
     const result = await client.listPublicBets();
 
@@ -30,7 +36,7 @@ describe('Bets endpoints', () => {
 
   it('listPublicBets with page param', async () => {
     const bets = [createBetFixture()];
-    mockFetch.mockResolvedValue(mockJsonResponse(bets));
+    mockFetch.mockResolvedValue(mockJsonResponse(wrapResponse(bets)));
 
     await client.listPublicBets({ page: 2 });
 
@@ -38,9 +44,9 @@ describe('Bets endpoints', () => {
     expect(url).toBe('https://api.poll.fun/api/bets-usdc/all/public?page=2');
   });
 
-  it('getTrendingBets sends correct GET', async () => {
+  it('getTrendingBets sends correct GET and unwraps data', async () => {
     const bets = [createBetFixture()];
-    mockFetch.mockResolvedValue(mockJsonResponse(bets));
+    mockFetch.mockResolvedValue(mockJsonResponse(wrapResponse(bets)));
 
     const result = await client.getTrendingBets();
 
@@ -50,9 +56,9 @@ describe('Bets endpoints', () => {
     expect(init.method).toBe('GET');
   });
 
-  it('getBet sends GET with ID', async () => {
+  it('getBet sends GET with ID and unwraps data', async () => {
     const bet = createBetFixture({ id: 'bet-123' });
-    mockFetch.mockResolvedValue(mockJsonResponse(bet));
+    mockFetch.mockResolvedValue(mockJsonResponse(wrapResponse(bet)));
 
     const result = await client.getBet('bet-123');
 
@@ -62,9 +68,9 @@ describe('Bets endpoints', () => {
     expect(init.method).toBe('GET');
   });
 
-  it('createBet sends POST with body', async () => {
+  it('createBet sends POST with body and unwraps data', async () => {
     const newBet = createBetFixture();
-    mockFetch.mockResolvedValue(mockJsonResponse(newBet));
+    mockFetch.mockResolvedValue(mockJsonResponse(wrapResponse(newBet)));
 
     const params = {
       question: 'Will it rain tomorrow?',

package/tests/unit/endpoints/leaderboard.test.ts

@@ -15,12 +15,16 @@ describe('Leaderboard endpoints', () => {
     });
   });
 
-  it('getLeaderboard sends correct GET', async () => {
+  it('getLeaderboard sends correct GET and unwraps leaderboard array', async () => {
     const entries = [
       { userId: 1, uuid: 'u1', displayName: 'User1', rank: 1, points: 1000 },
       { userId: 2, uuid: 'u2', displayName: 'User2', rank: 2, points: 800 },
     ];
-    mockFetch.mockResolvedValue(mockJsonResponse(entries));
+    // API returns { leaderboard: [...], pagination: {...} }
+    mockFetch.mockResolvedValue(mockJsonResponse({
+      leaderboard: entries,
+      pagination: { total: 2, page: 1, limit: 50 },
+    }));
 
     const result = await client.getLeaderboard();
 

package/tests/unit/endpoints/social.test.ts

@@ -15,12 +15,13 @@ describe('Social endpoints', () => {
     });
   });
 
-  it('getFriends sends correct GET', async () => {
+  it('getFriends sends correct GET and unwraps friends array', async () => {
     const friends = [
-      { id: 1, uuid: 'f1', displayName: 'Friend1' },
-      { id: 2, uuid: 'f2', displayName: 'Friend2' },
+      { id: 1, uuid: 'f1', displayName: 'Friend1', profileImageUrl: null },
+      { id: 2, uuid: 'f2', displayName: 'Friend2', profileImageUrl: null },
     ];
-    mockFetch.mockResolvedValue(mockJsonResponse(friends));
+    // API returns { friends: [...], totalCount, error }
+    mockFetch.mockResolvedValue(mockJsonResponse({ friends, totalCount: 2, error: null }));
 
     const result = await client.getFriends();
 
@@ -30,7 +31,7 @@ describe('Social endpoints', () => {
     expect(init.method).toBe('GET');
   });
 
-  it('sendFriendRequest sends POST', async () => {
+  it('sendFriendRequest sends POST with targetUserUuid', async () => {
     mockFetch.mockResolvedValue(mockJsonResponse({ success: true }));
 
     await client.sendFriendRequest('target-uuid');
@@ -38,7 +39,7 @@ describe('Social endpoints', () => {
     const [url, init] = mockFetch.mock.calls[0];
     expect(url).toBe('https://api.poll.fun/api/user/friends/request');
     expect(init.method).toBe('POST');
-    expect(JSON.parse(init.body)).toEqual({ uuid: 'target-uuid' });
+    expect(JSON.parse(init.body)).toEqual({ targetUserUuid: 'target-uuid' });
   });
 
   it('favouriteBet sends POST', async () => {

package/tests/unit/endpoints/user.test.ts

@@ -16,36 +16,41 @@ describe('User endpoints', () => {
     });
   });
 
-  it('getAccount sends correct GET', async () => {
+  it('getAccount sends correct GET and unwraps user + address', async () => {
     const user = createUserFixture();
-    mockFetch.mockResolvedValue(mockJsonResponse(user));
+    const address = 'So1anaAddr3ss123';
+    // API returns { user: {...}, address: string, error: null }
+    mockFetch.mockResolvedValue(mockJsonResponse({ user, address, error: null }));
 
     const result = await client.getAccount();
 
-    expect(result).toEqual(user);
+    expect(result).toEqual({ ...user, walletAddress: address });
     const [url, init] = mockFetch.mock.calls[0];
     expect(url).toBe('https://api.poll.fun/api/user/account');
     expect(init.method).toBe('GET');
   });
 
-  it('getProfile without uuid', async () => {
-    const profile = { id: 1, uuid: 'abc', displayName: 'Test' };
-    mockFetch.mockResolvedValue(mockJsonResponse(profile));
+  it('getProfile without uuid unwraps profile + stats', async () => {
+    const profile = { uuid: 'abc', displayName: 'Test', profileImageUrl: null };
+    const stats = { betsCreated: 5, totalWagered: 100 };
+    // API returns { profile: {...}, stats: {...}, error: null }
+    mockFetch.mockResolvedValue(mockJsonResponse({ profile, stats, error: null }));
 
     const result = await client.getProfile();
 
-    expect(result).toEqual(profile);
+    expect(result).toEqual({ ...profile, stats });
     const [url] = mockFetch.mock.calls[0];
     expect(url).toBe('https://api.poll.fun/api/user/profile');
   });
 
   it('getProfile with uuid sends GET /api/user/profile/:uuid', async () => {
-    const profile = { id: 2, uuid: 'user-uuid-123', displayName: 'OtherUser' };
-    mockFetch.mockResolvedValue(mockJsonResponse(profile));
+    const profile = { uuid: 'user-uuid-123', displayName: 'OtherUser', profileImageUrl: null };
+    const stats = { betsCreated: 10 };
+    mockFetch.mockResolvedValue(mockJsonResponse({ profile, stats, error: null }));
 
     const result = await client.getProfile('user-uuid-123');
 
-    expect(result).toEqual(profile);
+    expect(result).toEqual({ ...profile, stats });
     const [url] = mockFetch.mock.calls[0];
     expect(url).toBe('https://api.poll.fun/api/user/profile/user-uuid-123');
   });
@@ -72,4 +77,16 @@ describe('User endpoints', () => {
     expect(url).toBe('https://api.poll.fun/api/user/balance');
     expect(init.method).toBe('GET');
   });
+
+  it('getUsdcBalance sends correct GET and maps balance to usdc', async () => {
+    // API returns { balance: number, error: null }
+    mockFetch.mockResolvedValue(mockJsonResponse({ balance: 250.5, error: null }));
+
+    const result = await client.getUsdcBalance();
+
+    expect(result).toEqual({ usdc: 250.5, error: null });
+    const [url, init] = mockFetch.mock.calls[0];
+    expect(url).toBe('https://api.poll.fun/api/user/usdc/balance');
+    expect(init.method).toBe('GET');
+  });
 });

package/tests/unit/endpoints/wallet.test.ts

@@ -15,7 +15,7 @@ describe('Wallet endpoints', () => {
     });
   });
 
-  it('getWalletTransactions sends correct GET', async () => {
+  it('getWalletTransactions sends correct GET and unwraps transactions', async () => {
     const txns = [
       {
         signature: 'sig123',
@@ -30,7 +30,8 @@ describe('Wallet endpoints', () => {
         createdAt: '2026-01-02T00:00:00.000Z',
       },
     ];
-    mockFetch.mockResolvedValue(mockJsonResponse(txns));
+    // API returns { transactions: [...], error: null }
+    mockFetch.mockResolvedValue(mockJsonResponse({ transactions: txns, error: null }));
 
     const result = await client.getWalletTransactions();