@usions/sdk 2.11.0 → 2.11.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usions/sdk",
-  "version": "2.11.0",
+  "version": "2.11.1",
   "description": "Usion Mini App SDK for iframe games and services",
   "type": "module",
   "main": "src/modules/index.js",
@@ -40,13 +40,14 @@
     "multiplayer",
     "mini-app"
   ],
-  "homepage": "https://github.com/usion-platform/sdk#readme",
+  "homepage": "https://github.com/ugshanyu/usionthemobile/tree/main/packages/sdk#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/usion-platform/sdk.git"
+    "url": "git+https://github.com/ugshanyu/usionthemobile.git",
+    "directory": "packages/sdk"
   },
   "bugs": {
-    "url": "https://github.com/usion-platform/sdk/issues"
+    "url": "https://github.com/ugshanyu/usionthemobile/issues"
   },
   "license": "MIT",
   "publishConfig": {

package/types/index.d.ts

@@ -745,9 +745,34 @@ export interface UsionSDK {
   lobby: LobbyModule;
   leaderboard: LeaderboardModule;
   matchmaking: MatchmakingModule;
+  cloud: CloudModule;
   netcode: NetcodeModule;
 }
 
+/** Scoped server-persisted KV operations (per-user or shared). */
+export interface CloudScope {
+  /** Get a value; resolves to null when the key doesn't exist. */
+  get(key: string, opts?: { serviceId?: string }): Promise<any>;
+  /** Set a JSON-serializable value (max 64 KB). Keys: 1-128 chars of A-Za-z0-9_.-:/ */
+  set(key: string, value: any, opts?: { serviceId?: string }): Promise<{ success: boolean; size: number }>;
+  /** Remove a key. */
+  remove(key: string, opts?: { serviceId?: string }): Promise<{ success: boolean; removed: boolean }>;
+  /** List keys in this scope's bucket. */
+  keys(opts?: { serviceId?: string }): Promise<string[]>;
+}
+
+/**
+ * Server-persisted cloud storage. Per-user scope on the module itself
+ * (cloud saves synced across devices); `shared` is one bucket per app that
+ * all users read/write. Quotas: 64 KB/value, 200 keys + 1 MB per bucket.
+ */
+export interface CloudModule extends CloudScope {
+  shared: CloudScope & {
+    /** Atomically increment a shared numeric value (default delta 1). Resolves to the new value. */
+    incr(key: string, delta?: number, opts?: { serviceId?: string }): Promise<number>;
+  };
+}
+
 export interface Match { roomId: string; players: string[]; serviceId?: string; }
 
 export interface MatchmakingModule {