@usions/sdk 2.0.2 → 2.1.1

package/src/modules/wallet.js

@@ -0,0 +1,114 @@
+/**
+ * Usion SDK Wallet Module — wallet and payment operations
+ */
+
+import { getNextRequestId } from './core.js';
+
+/**
+ * @param {object} Usion - Reference to the main Usion object
+ */
+export function createWalletModule(Usion) {
+  return {
+    _balance: null,
+    _balanceChangeHandler: null,
+
+    /**
+     * Get current wallet balance
+     * @returns {Promise<number>} Balance in credits
+     */
+    getBalance: function() {
+      const self = this;
+
+      // If we have cached balance, return it
+      if (self._balance !== null) {
+        return Promise.resolve(self._balance);
+      }
+
+      return Usion._request('GET_BALANCE', {}).then(function(response) {
+        self._balance = response.balance;
+        return response.balance;
+      });
+    },
+
+    /**
+     * Check if user has enough credits
+     * @param {number} amount - Amount to check
+     * @returns {Promise<boolean>}
+     */
+    hasCredits: function(amount) {
+      return this.getBalance().then(function(balance) {
+        return balance >= amount;
+      });
+    },
+
+    /**
+     * Request payment from user with balance check
+     * @param {number} amount - Credit amount to charge
+     * @param {string} reason - Description shown to user
+     * @param {object} data - Optional additional data
+     * @returns {Promise} Resolves on payment success, rejects on failure
+     */
+    requestPayment: function(amount, reason, data) {
+      const self = this;
+
+      return new Promise(function(resolve, reject) {
+        const requestId = getNextRequestId();
+        const timeoutMs = 60000;
+
+        // Listen for response
+        function handler(event) {
+          let response;
+          try {
+            response = typeof event.data === 'string' ? JSON.parse(event.data) : event.data;
+          } catch (e) {
+            return;
+          }
+
+          // Only accept responses for this specific payment request.
+          if (response._requestId !== requestId) {
+            return;
+          }
+
+          if (response.type === 'PAYMENT_SUCCESS') {
+            clearTimeout(timer);
+            window.removeEventListener('message', handler);
+            // Update cached balance
+            if (response.newBalance !== undefined) {
+              self._balance = response.newBalance;
+            } else if (self._balance !== null) {
+              self._balance -= amount;
+            }
+            resolve(response);
+          } else if (response.type === 'PAYMENT_FAILED') {
+            clearTimeout(timer);
+            window.removeEventListener('message', handler);
+            reject(new Error(response.reason || 'Payment failed'));
+          }
+        }
+
+        window.addEventListener('message', handler);
+        const timer = setTimeout(function() {
+          window.removeEventListener('message', handler);
+          reject(new Error('Payment confirmation timeout'));
+        }, timeoutMs);
+
+        // Send payment request
+        Usion._post({
+          type: 'PAYMENT_REQUEST',
+          _requestId: requestId,
+          amount: amount,
+          reason: reason,
+          data: data
+        });
+      });
+    },
+
+    /**
+     * Listen for balance changes
+     * @param {function} callback - Called with new balance
+     */
+    onBalanceChange: function(callback) {
+      this._balanceChangeHandler = callback;
+    }
+  };
+}

package/types/browser.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Browser IIFE build — sets up window.Usion global.
+ * Import this module for its side effect only.
+ */
+export {};

package/types/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Usion Mini App SDK v2.0 — TypeScript Declarations
+ * Usion Mini App SDK v2.1 — TypeScript Declarations
  */
 
 // ─── Config & Init ───────────────────────────────────────────────
@@ -12,6 +12,9 @@ export interface UsionConfig {
   sessionId?: string;
   sessionData?: Record<string, any>;
   balance?: number;
+  results?: SavedResult[];
+  theme?: 'light' | 'dark';
+  language?: string;
   socketUrl?: string;
   roomId?: string;
   playerIds?: string[];
@@ -27,6 +30,8 @@ export interface PaymentResponse {
   success: boolean;
   reason?: string;
   newBalance?: number;
+  receiptToken?: string;
+  transactionId?: string;
 }
 
 // ─── User ────────────────────────────────────────────────────────
@@ -55,6 +60,14 @@ export interface StorageModule {
   keys(): Promise<string[]>;
 }
 
+// ─── File Storage ───────────────────────────────────────────────
+
+export interface FileStorageModule {
+  set(key: string, base64Data: string, mimeType: string): Promise<void>;
+  get(key: string): Promise<{ base64Data: string; mimeType: string } | null>;
+  remove(key: string): Promise<void>;
+}
+
 // ─── Wallet ──────────────────────────────────────────────────────
 
 export interface WalletModule {
@@ -220,6 +233,37 @@ export interface GameModule {
   on(event: string, callback: (data: any) => void): void;
 }
 
+// ─── Results ────────────────────────────────────────────────────
+
+export interface SavedResult {
+  id: string;
+  data: string;
+  metadata?: {
+    thumbnail_url?: string;
+    title?: string;
+    type?: string;
+  };
+  created_at?: string;
+}
+
+// ─── Bot ────────────────────────────────────────────────────────
+
+export interface BotMessage {
+  id: string;
+  content: string;
+  content_type?: string;
+  components?: any[];
+  sender_id: string;
+}
+
+export interface BotModule {
+  callAction(action: string, data?: Record<string, any>): Promise<any>;
+  sendMessage(text: string): void;
+  updateContext(ctx: Record<string, any>): void;
+  close(result?: any): void;
+  onMessage(callback: (message: BotMessage) => void): void;
+}
+
 // ─── Selection Grid ──────────────────────────────────────────────
 
 export interface SelectionGrid {
@@ -235,7 +279,11 @@ export interface UsionSDK {
 
   // Lifecycle
   init(callback: (config: UsionConfig) => void): void;
-  exit(): void;
+  exit(options?: { backCount?: number }): void;
+
+  // Theme & Locale
+  getTheme(): 'light' | 'dark';
+  getLanguage(): string;
 
   // Payments
   requestPayment(amount: number, reason: string, data?: Record<string, any>): Promise<PaymentResponse>;
@@ -244,6 +292,18 @@ export interface UsionSDK {
   submit(data: Record<string, any>): void;
   error(message: string): void;
 
+  // Results (server-side persistence)
+  saveResult(data: string, metadata?: { thumbnail_url?: string; title?: string; type?: string }): Promise<SavedResult>;
+  deleteResult(resultId: string): Promise<void>;
+  getResults(): SavedResult[];
+
+  // Back button
+  claimBackButton(callback: () => void): void;
+  releaseBackButton(): void;
+
+  // Download
+  download(url: string, filename?: string): Promise<{ success?: boolean; error?: string }>;
+
   // Sharing
   share(contentType: 'audio' | 'image' | 'video' | 'text' | 'mixed', data: ShareData): void;
 
@@ -266,9 +326,11 @@ export interface UsionSDK {
   // Modules
   user: UserModule;
   storage: StorageModule;
+  fileStorage: FileStorageModule;
   wallet: WalletModule;
   session: SessionModule;
   chat: ChatModule;
+  bot: BotModule;
   game: GameModule;
 }