@usions/sdk 2.0.1

package/README.md

@@ -0,0 +1,144 @@
+# @usion/sdk
+
+Client SDK for building mini-apps and games on the [Usion](https://usions.com) platform.
+
+Provides access to user info, storage, wallet, chat, sessions, and real-time multiplayer game features.
+
+## Install
+
+```bash
+npm install @usion/sdk
+```
+
+Or load via script tag:
+
+```html
+<script src="https://usions.com/usion-sdk.js"></script>
+```
+
+## Quick Start
+
+```javascript
+import Usion from '@usion/sdk';
+
+Usion.init((config) => {
+  console.log('User:', Usion.user.getName());
+  console.log('Room:', config.roomId);
+});
+```
+
+## Modules
+
+### User
+
+```javascript
+Usion.user.getId()       // User ID
+Usion.user.getName()     // Display name
+Usion.user.getAvatar()   // Avatar URL
+Usion.user.getToken()    // Auth JWT
+Usion.user.getProfile()  // Promise<{ id, name, avatar }>
+```
+
+### Storage (persistent, per-user, per-service)
+
+```javascript
+await Usion.storage.set('highscore', 1500)
+await Usion.storage.get('highscore')     // 1500
+await Usion.storage.remove('highscore')
+await Usion.storage.keys()               // ['key1', 'key2']
+await Usion.storage.clear()
+```
+
+### Wallet
+
+```javascript
+await Usion.wallet.getBalance()            // 500
+await Usion.wallet.hasCredits(100)         // true
+await Usion.wallet.requestPayment(50, 'Power-up')
+Usion.wallet.onBalanceChange((balance) => { ... })
+```
+
+### Session (ephemeral)
+
+```javascript
+Usion.session.getId()
+Usion.session.getData('key')
+Usion.session.setData('key', 'value')
+Usion.session.clear()
+```
+
+### Chat
+
+```javascript
+await Usion.chat.sendMessage(recipientId, 'Hello!')
+await Usion.chat.createPersonalChat(peerUserId)
+```
+
+### Game (Multiplayer)
+
+#### Platform Mode (relay through Usion backend)
+
+```javascript
+await Usion.game.connect()
+await Usion.game.join(roomId)
+
+// Send actions (validated, sequenced)
+await Usion.game.action('move', { cell: 4 })
+
+// Send real-time updates (fire-and-forget)
+Usion.game.realtime('position', { x: 100, y: 200 })
+```
+
+#### Direct Mode (connect to game creator's server)
+
+```javascript
+await Usion.game.connectDirect()
+await Usion.game.join(roomId)
+```
+
+#### Event Handlers
+
+```javascript
+Usion.game.onPlayerJoined((data) => { ... })
+Usion.game.onPlayerLeft((data) => { ... })
+Usion.game.onStateUpdate((data) => { ... })
+Usion.game.onAction((data) => { ... })
+Usion.game.onRealtime((data) => { ... })
+Usion.game.onGameFinished((data) => { ... })
+Usion.game.onGameRestarted((data) => { ... })
+Usion.game.onError((data) => { ... })
+Usion.game.onDisconnect((reason) => { ... })
+Usion.game.onReconnect((attempt) => { ... })
+```
+
+#### Other
+
+```javascript
+Usion.game.requestSync(lastSequence)  // Recover missed actions
+Usion.game.requestRematch()
+Usion.game.forfeit()
+Usion.game.disconnect()
+Usion.game.isConnected()              // boolean
+```
+
+### Utility
+
+```javascript
+Usion.requestPayment(amount, reason)
+Usion.share('image', { imageUrl, text })
+Usion.exit()                         // Close the mini-app
+Usion.log(message)                   // Debug log
+```
+
+## TypeScript
+
+Full type declarations included:
+
+```typescript
+import Usion from '@usion/sdk';
+import type { UsionConfig, GameModule, PlayerJoinedData } from '@usion/sdk';
+```
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@usions/sdk",
+  "version": "2.0.1",
+  "description": "Usion Mini App SDK for iframe games and services",
+  "type": "module",
+  "main": "src/index.js",
+  "browser": "src/browser.js",
+  "types": "types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./src/index.js",
+      "browser": "./src/browser.js",
+      "default": "./src/index.js"
+    },
+    "./browser": "./src/browser.js"
+  },
+  "files": [
+    "src/",
+    "types/"
+  ],
+  "keywords": [
+    "usion",
+    "game",
+    "sdk",
+    "multiplayer",
+    "mini-app"
+  ],
+  "homepage": "https://github.com/usion-platform/sdk#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/usion-platform/sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/usion-platform/sdk/issues"
+  },
+  "license": "MIT"
+}