gameon-sdk 1.0.0 → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gameonworld.ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,94 @@
+# gameon-sdk
+
+TypeScript client for the GameOn roulette backend REST API. Fully typed, ESM, uses the built-in `fetch` (Node 18+ and browsers).
+
+The client is generated from [`specs/openapi.yaml`](specs/openapi.yaml). Live round updates (`roundState`, `livePlayer`, `settle`) are sent over socket.io and are not part of this SDK.
+
+## Install
+
+```bash
+npm install gameon-sdk
+```
+
+## Quick start
+
+```ts
+import { Configuration, DefaultApi, ResponseError } from "gameon-sdk";
+
+const api = new DefaultApi(
+  new Configuration({ basePath: "https://your-backend.example.com" })
+);
+
+try {
+  const health = await api.getHealth();
+  const config = await api.getGameConfig();
+  const state = await api.getGameState();
+  const balance = await api.getUserWalletBalance({ userUuid: "USER_UUID" });
+} catch (err) {
+  if (err instanceof ResponseError) {
+    console.error(err.response.status, await err.response.text());
+  } else {
+    throw err;
+  }
+}
+```
+
+### Admin endpoints
+
+Admin endpoints use the `x-admin-key` header:
+
+```ts
+const admin = new DefaultApi(
+  new Configuration({
+    basePath: "https://your-backend.example.com",
+    apiKey: (name) => (name === "x-admin-key" ? process.env.ADMIN_KEY! : ""),
+  })
+);
+
+const pool = await admin.getAdminHousePool();
+```
+
+## API
+
+All methods are on `DefaultApi`. Each one also has a `...Raw()` variant that returns the full HTTP response.
+
+| Method | Description |
+| --- | --- |
+| `getHealth()` | Health check |
+| `getGameConfig()` | Game configuration (currencies, limits) |
+| `getFxRate()` | Current FX rate |
+| `getGameState()` | Current round state |
+| `getGameRounds({ ... })` | Recent rounds |
+| `getGameHistory({ ... })` | Recent winning numbers |
+| `getGameMyBets({ ... })` | A player's bets |
+| `getGameMyHistory({ ... })` | A player's game history |
+| `placeGameBet({ placeBetRequest })` | Place a bet |
+| `getUserRecord({ uuid })` | User record (cached balance, profile) |
+| `getUserWalletBalance({ userUuid })` | Wallet balance |
+| `getUserHistory({ ... })` | User history |
+| `createRoomV2({ ... })` | Join the game, sync balance, return a play link |
+| `exchangeLaunchTicket({ ... })` | Exchange a launch ticket |
+| `getAdminHousePool()` | House pool stats (admin) |
+| `getAdminTopWinners({ ... })` | Top winners (admin) |
+
+All request and response types (for example `PlaceBetRequest`, `RoundState` and `WalletBalanceResponse`) are exported from the package root.
+
+## Development
+
+```bash
+npm install
+npm run generate   # regenerate src/ from specs/openapi.yaml
+npm run build      # compile to dist/
+npm test
+```
+
+Release:
+
+```bash
+npm version patch   # or minor / major
+npm publish
+```
+
+## License
+
+[MIT](LICENSE)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gameon-sdk",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "TypeScript client for the roulette backend, generated from specs/openapi.yaml",
   "type": "module",
   "main": "./dist/index.js",
@@ -21,7 +21,13 @@
     "test": "tsx tests/test-all.ts",
     "prepublishOnly": "npm run build"
   },
-  "keywords": [],
+  "keywords": [
+    "gameon",
+    "sdk",
+    "roulette",
+    "typescript",
+    "api-client"
+  ],
   "devDependencies": {
     "@openapitools/openapi-generator-cli": "^2.41.0",
     "ts-node": "^10.9.2",
@@ -30,5 +36,18 @@
   },
   "directories": {
     "test": "tests"
+  },
+  "license": "MIT",
+  "author": "Gameonworld.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Gameonworld-ai/game-idk.git"
+  },
+  "homepage": "https://github.com/Gameonworld-ai/game-idk#readme",
+  "bugs": {
+    "url": "https://github.com/Gameonworld-ai/game-idk/issues"
+  },
+  "engines": {
+    "node": ">=18"
   }
 }