@momo-cloud/gami-sdk 0.0.65 → 0.0.67

package/README.md

@@ -135,6 +135,35 @@ console.log('Game config:', config);
 
 ---
 
+#### `getExchange()`
+
+Load exchange metadata for the current game (coin → turn). The backend uses the fixed action `exchange_coin_to_turn`; the active `gameId` comes from `init`.
+
+```typescript
+const res = await GamiSDK.getExchange();
+const { balance, exchangeRate, counter, counterLimit, fromCurrency, toCurrency } = res.result;
+```
+
+**Returns:** `Promise<TGetExchangeResponse>` - Standard `response_info` plus `result` with rate, balances, counters, and currency pair
+
+---
+
+#### `postExchange(options)`
+
+Submit a coin-to-turn exchange for the current game.
+
+```typescript
+const res = await GamiSDK.postExchange({ amount: 100 });
+const { from, to, counter } = res.result;
+```
+
+**Parameters:**
+- `amount` (number): Coin amount to convert
+
+**Returns:** `Promise<TPostExchangeResponse>` - Updated `from` / `to` wallet snapshots and `counter` state
+
+---
+
 #### `spin()`
 
 Perform a spinner spin for the current game. Sends `POST` to the twirler service with the active `gameId` (set via `init`).
@@ -799,11 +828,20 @@ Game Ready ✓
 The SDK is written in TypeScript and includes type definitions:
 
 ```typescript
-import GamiSDK, { TBalance, TLeaderboard, IUserInfo } from '@momo-cloud/gami-sdk';
+import GamiSDK, {
+  TBalance,
+  TGetExchangeResponse,
+  TLeaderboard,
+  TPostExchangeResponse,
+  IUserInfo
+} from '@momo-cloud/gami-sdk';
 
 const balance: TBalance = await GamiSDK.getBalance({
   balanceIds: ['coin']
 });
+
+const exchangeInfo: TGetExchangeResponse = await GamiSDK.getExchange();
+const posted: TPostExchangeResponse = await GamiSDK.postExchange({ amount: 100 });
 ```
 
 ### Vite Integration

package/dist/index.public.d.ts

@@ -57,6 +57,13 @@ declare const GamiSDK: {
     }) => Promise<any>;
     getBalanceConfig: () => Promise<any>;
     getConfig: () => Promise<any>;
+    getExchange: (params?: {
+        actionId?: string;
+    }) => Promise<TGetExchangeResponse>;
+    postExchange: (params: {
+        amount: number;
+        actionId?: string;
+    }) => Promise<TPostExchangeResponse>;
     spin: () => Promise<any>;
     getLeaderboard: (params: {
         boardId: string;
@@ -240,6 +247,48 @@ export declare type TDeviceInfo = {
     devicePerformance?: string;
 };
 
+export declare type TGetExchangeResponse = {
+    response_info: {
+        error_message: string;
+        error_code: number;
+        event_tracking: string;
+    };
+    result: {
+        balance: number;
+        exchangeRate: number;
+        counter: number;
+        counterLimit: number;
+        fromCurrency: string;
+        toCurrency: string;
+    };
+};
+
+export declare type TPostExchangeResponse = {
+    response_info: {
+        error_message: string;
+        error_code: number;
+        event_tracking: string;
+    };
+    result: {
+        from: {
+            walletType: string;
+            currency: string;
+            before: number;
+            after: number;
+        };
+        to: {
+            walletType: string;
+            currency: string;
+            before: number;
+            after: number;
+        };
+        counter: {
+            value: number;
+            limit: number;
+        };
+    };
+};
+
 export declare const Utils: {
     num10to11: (number: string) => string;
     num11to10: (number: string) => string;