@dimcool/sdk 0.1.28 → 0.1.30

package/README.md

@@ -376,6 +376,61 @@ Check if a user is a friend. Note: This is a helper method that may require addi
 const isFriend = await sdk.users.isFriend('user-id');
 ```
 
+#### `getIncomingFriendRequests(opts?: { limit?: number; cursor?: string }): Promise<PaginatedFriendRequests>`
+
+List pending incoming friend requests for the authenticated user. Returns cursor-based pages of up to 100 items.
+
+```typescript
+// First page (default limit 50)
+const page1 = await sdk.users.getIncomingFriendRequests();
+// page1: { items: FriendRequestItem[], nextCursor?: string }
+
+// Next page
+if (page1.nextCursor) {
+  const page2 = await sdk.users.getIncomingFriendRequests({
+    cursor: page1.nextCursor,
+  });
+}
+
+// Custom page size
+const small = await sdk.users.getIncomingFriendRequests({ limit: 10 });
+```
+
+Each `FriendRequestItem` has the shape `{ id, user: PublicUser, mutualFriendsCount, createdAt }`.
+
+#### `getOutgoingFriendRequests(opts?: { limit?: number; cursor?: string }): Promise<PaginatedFriendRequests>`
+
+List pending outgoing friend requests sent by the authenticated user. Same pagination shape as `getIncomingFriendRequests`.
+
+```typescript
+const page1 = await sdk.users.getOutgoingFriendRequests({ limit: 20 });
+// page1: { items: FriendRequestItem[], nextCursor?: string }
+```
+
+#### `acceptFriendRequest(userId: string): Promise<{ message: string }>`
+
+Accept a pending incoming friend request.
+
+```typescript
+await sdk.users.acceptFriendRequest('user-id');
+```
+
+#### `declineFriendRequest(userId: string): Promise<{ message: string }>`
+
+Decline a pending incoming friend request.
+
+```typescript
+await sdk.users.declineFriendRequest('user-id');
+```
+
+#### `cancelFriendRequest(userId: string): Promise<{ message: string }>`
+
+Cancel a pending outgoing friend request.
+
+```typescript
+await sdk.users.cancelFriendRequest('user-id');
+```
+
 ### Profile Management
 
 #### `updateProfile(data: { name?: string, bio?: string, username?: string }): Promise<User>`
@@ -1289,11 +1344,11 @@ const signedTx = await sdk.wallet.signTransaction(unsignedTx);
 
 ### `depositForLobbySync(lobbyId: string): Promise<DepositForLobbyResponse>`
 
-Zero-polling deposit variant using server-side `awaitConfirmation`. Only 2 HTTP calls total with no client-side polling. Ideal for agents and bots.
+Agent-optimised deposit: prepare, sign, submit, then poll until **the calling user's own deposit** is confirmed. Returns as soon as your deposit is on-chain without waiting for the other player. The server auto-joins the matchmaking queue when all players have deposited.
 
 ```typescript
 const result = await sdk.escrow.depositForLobbySync(lobbyId);
-// result: { signature: string, status: 'confirmed', canProceedToQueue: true }
+// result: { signature: string, status: 'confirmed', canProceedToQueue: boolean }
 ```
 
 **Parameters:**
@@ -1302,15 +1357,15 @@ const result = await sdk.escrow.depositForLobbySync(lobbyId);
 
 **Returns:**
 
-- `Promise<DepositForLobbyResponse>` - The deposit result with confirmed status
+- `Promise<DepositForLobbyResponse>` - The deposit result. `canProceedToQueue` is `true` only if all players have deposited by the time your deposit confirms.
 
 **Behavior:**
 
 1. Calls `prepareAndStartDeposit` to prepare the unsigned transaction (1 HTTP call)
-2. Signs the transaction locally and submits with `awaitConfirmation=true` (1 HTTP call)
-3. Server waits for on-chain confirmation before returning
+2. Signs and submits the transaction (1 HTTP call)
+3. Polls `GET /escrow/lobby/:id/deposit/status` every second until the signature appears as confirmed (up to 60 seconds)
 
-**Note:** Requires `sdk.wallet.setSigner()` to be configured. The server auto-joins the matchmaking queue when all deposits are confirmed.
+**Note:** Requires `sdk.wallet.setSigner()` to be configured. Use `depositForLobby()` if you need to wait for all players before proceeding.
 
 ### `submitDeposit(lobbyId: string, signedTransaction: string): Promise<SubmitDepositResponse>`
 
@@ -1713,7 +1768,7 @@ const { lobby, unsignedTransaction } = await sdk.lobbies.playAgain(
   sdk.escrow,
 );
 
-// Deposit using the sync (server-awaited) variant
+// Deposit and wait for your own deposit to confirm (polls status endpoint)
 const result = await sdk.escrow.depositForLobbySync(lobby.id);
 ```