feat!: balances and items replace the wallet in the player profile

skills/rudder-web-sdk/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: rudder-web-sdk
-description: Use when working with the Rudder TypeScript/JavaScript client SDK (@rudder/sdk) for web games. Covers createClient, device/google/apple/custom auth, identity linking, state objects (player with wallets and counters, catalog, storage), module calls through clients generated by `rudder client generate`, idempotent retries, and error handling. Load this whenever code imports from @rudder/sdk or a generated rudder.modules.ts.
+description: Use when working with the Rudder TypeScript/JavaScript client SDK (@rudder/sdk) for web games. Covers createClient, device/google/apple/custom auth, identity linking, state objects (player with balances and items, catalog, storage), module calls through clients generated by `rudder client generate`, idempotent retries, and error handling. Load this whenever code imports from @rudder/sdk or a generated rudder.modules.ts.
 ---
 
 # Rudder Web SDK (@rudder/sdk)
@@ -75,7 +75,7 @@ refresh clears tokens and emits `signed-out`. Details:
 | Area | Access | Kind |
 |---|---|---|
 | Auth | `client.auth` | service |
-| Player | `client.player` (`player`, `identities`, `wallets`, `counters`) | `SyncedState<PlayerProfile>` |
+| Player | `client.player` (`player`, `identities`, `balances`, `items`) | `SyncedState<PlayerProfile>` |
 | Catalog currencies | `client.catalog` | `SyncedState<Map<string, CatalogCurrency>>` |
 | Player storage | `client.storage` + `.save(type, data)` / `.delete(type)` | `SyncedState<GetStorageResponse>` + mutations |
 | Modules | `client.modules.call<T>(module, fn, args?, { moduleVersion? })` | resolves to `result` as `T` |
@@ -116,7 +116,7 @@ and commit it when installed modules change. Details:
 revision poll (`GET /sdk/v1/sync`, keys `profile`, `catalog`, `storage`) runs
 every 30 s (±20% jitter), pauses while the tab is hidden, and reloads the
 states whose revision grew. Storage mutations invalidate immediately. Call
-`player.reload()` after a module call that changes wallets or counters when
+`player.reload()` after a module call that changes balances or items when
 you need fresh values right away.
 
 ## Errors
@@ -137,6 +137,6 @@ timeout a 504, both without details.
 ## Reference files
 
 - [reference/auth.md](reference/auth.md): login flows, options, token store, session lifecycle
-- [reference/player.md](reference/player.md): profile, wallets, counters
+- [reference/player.md](reference/player.md): profile, balances, items
 - [reference/storage.md](reference/storage.md): player storage, limits
 - [reference/modules.md](reference/modules.md): generated clients, `modules.call`, idempotency, retries, errors

skills/rudder-web-sdk/reference/player.md

@@ -1,12 +1,11 @@
 # Player — `client.player`
 
 `PlayerDomain` (source: `src/domains/PlayerDomain.ts`) — the observable player
-profile: player, linked identities, currency wallets and
-number counters. Synced under revision key `profile`.
+profile: player, linked identities, currency balances and inventory stacks.
+Synced under revision key `profile`.
 
-There is no separate wallet service in this SDK. Wallet balances are read from
-the profile and are credited/debited server-side (admin wallet adjust, module
-functions).
+There is no separate ledger service in this SDK. Balances and items are read
+from the profile and are written server-side (admin adjust, module functions).
 
 ## Surface
 
@@ -24,10 +23,10 @@ await client.player.reload();  // force refetch
 
 ```ts
 interface PlayerProfile {
-  counters?: { [slug: string]: number };  // client-visible number counters
+  balances?: Balance[];
   identities?: PlayerProfileIdentity[];
+  items?: InventoryStack[];
   player?: Player;
-  wallets?: Wallet[];
 }
 
 interface PlayerProfileIdentity {
@@ -45,20 +44,25 @@ interface Player {
   region?: string;
 }
 
-interface Wallet {
+interface Balance {
   balance?: number;
-  currency?: string;  // currency code configured in the dashboard
+  currency?: string;  // currency slug configured in the dashboard
+}
+
+interface InventoryStack {
+  item?: string;      // item slug
+  quantity?: number;
 }
 ```
 
 ## Behavior notes
 
-- `counters` holds the values of `number` counters whose definition is
-  `client_visible`; hidden counters are left out. Currency counters are in
-  `wallets`, not in `counters`. Counter changes bump the `profile` revision.
+- `balances` carries one entry per currency in the latest release, zero-filled
+  for a player who never received it; `items` carries one entry per non-empty
+  inventory stack. Both bump the `profile` revision when they change.
 - Warmed automatically at login (with catalog).
 - Kept fresh by the revision poll; call `reload()` after a module function
-  that changes wallets or counters.
+  that changes balances or items.
 - All fields are optional on the wire (`?`); code defensively.
 - React: `useSyncExternalStore` maps directly onto `onChange` (see the SDK
   README "React recipe").