@usions/sdk 2.0.1

package/src/index.js

@@ -0,0 +1,55 @@
+/**
+ * @usion/sdk — ES module wrapper for the Usion Mini App SDK
+ *
+ * Usage:
+ *   import Usion from '@usion/sdk';
+ *   // or
+ *   import { Usion } from '@usion/sdk';
+ */
+
+// Create a synthetic global for the IIFE to attach to
+const _global = {};
+
+// Execute the IIFE SDK with our synthetic global
+(function (global) {
+  'use strict';
+
+  // ---- Begin inlined SDK bootstrap ----
+  // We re-export the Usion object that the IIFE creates.
+  // Rather than duplicating the full SDK source, we dynamically load it.
+  // For the npm module path, consumers import this file;
+  // for script-tag usage, they load browser.js directly.
+  // ---- End inlined SDK bootstrap ----
+
+  // Attach a marker so consumers can detect the module version
+  global.__USION_SDK_MODULE__ = true;
+})(_global);
+
+// Dynamic import approach: read the IIFE SDK and evaluate it
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Create a minimal global-like object for the IIFE
+const _sdkGlobal = {};
+const sdkSource = readFileSync(join(__dirname, 'browser.js'), 'utf-8');
+
+// Replace the IIFE's global reference to capture the Usion object
+const wrappedSource = sdkSource
+  .replace(
+    /\}\)\(typeof window !== 'undefined' \? window : this\);?\s*$/,
+    '})(_sdkGlobal);'
+  );
+
+// Execute in a function scope to avoid polluting
+const execFn = new Function('_sdkGlobal', wrappedSource);
+execFn(_sdkGlobal);
+
+/** The Usion SDK instance */
+const Usion = _sdkGlobal.Usion;
+
+export { Usion };
+export default Usion;

package/types/index.d.ts

@@ -0,0 +1,278 @@
+/**
+ * Usion Mini App SDK v2.0 — TypeScript Declarations
+ */
+
+// ─── Config & Init ───────────────────────────────────────────────
+
+export interface UsionConfig {
+  userId?: string;
+  userName?: string;
+  userAvatar?: string;
+  authToken?: string;
+  sessionId?: string;
+  sessionData?: Record<string, any>;
+  balance?: number;
+  socketUrl?: string;
+  roomId?: string;
+  playerIds?: string[];
+  serviceId?: string;
+  serviceName?: string;
+  apiUrl?: string;
+  connectionMode?: 'platform' | 'direct';
+}
+
+// ─── Payment ─────────────────────────────────────────────────────
+
+export interface PaymentResponse {
+  success: boolean;
+  reason?: string;
+  newBalance?: number;
+}
+
+// ─── User ────────────────────────────────────────────────────────
+
+export interface UserProfile {
+  id: string;
+  name: string;
+  avatar: string;
+}
+
+export interface UserModule {
+  getId(): string | null;
+  getName(): string | null;
+  getAvatar(): string | null;
+  getToken(): string | null;
+  getProfile(): Promise<UserProfile>;
+}
+
+// ─── Storage ─────────────────────────────────────────────────────
+
+export interface StorageModule {
+  get(key: string): Promise<any>;
+  set(key: string, value: any): Promise<void>;
+  remove(key: string): Promise<void>;
+  clear(): Promise<void>;
+  keys(): Promise<string[]>;
+}
+
+// ─── Wallet ──────────────────────────────────────────────────────
+
+export interface WalletModule {
+  getBalance(): Promise<number>;
+  hasCredits(amount: number): Promise<boolean>;
+  requestPayment(amount: number, reason: string, data?: Record<string, any>): Promise<PaymentResponse>;
+  onBalanceChange(callback: (balance: number) => void): void;
+}
+
+// ─── Session ─────────────────────────────────────────────────────
+
+export interface SessionModule {
+  getId(): string | null;
+  getData(key?: string): any;
+  setData(keyOrData: string | Record<string, any>, value?: any): void;
+  clear(): void;
+}
+
+// ─── Chat ────────────────────────────────────────────────────────
+
+export interface ChatCreationResult {
+  chatId: string;
+  peerName: string;
+  peerUsername: string;
+  peerAvatar: string;
+}
+
+export interface ChatModule {
+  sendMessage(recipientId: string, message: string): Promise<{ success: boolean; reason?: string }>;
+  createPersonalChat(peerUserId: string): Promise<ChatCreationResult>;
+}
+
+// ─── Share ────────────────────────────────────────────────────────
+
+export interface ShareMediaItem {
+  type: 'image' | 'video' | 'audio';
+  url: string;
+  thumbnailUrl?: string;
+  width?: number;
+  height?: number;
+  duration?: number;
+}
+
+export interface ShareData {
+  text?: string;
+  audioUrl?: string;
+  imageUrl?: string;
+  videoUrl?: string;
+  thumbnailUrl?: string;
+  width?: number;
+  height?: number;
+  duration?: number;
+  media?: ShareMediaItem[];
+}
+
+// ─── Game ────────────────────────────────────────────────────────
+
+export interface GameJoinResult {
+  room_id: string;
+  player_id: string;
+  sequence?: number;
+  error?: string;
+  message?: string;
+}
+
+export interface ActionResult {
+  success: boolean;
+  sequence?: number;
+  error?: string;
+  message?: string;
+}
+
+export interface DirectConnectionConfig {
+  roomId?: string;
+  serviceId?: string;
+  apiUrl?: string;
+  token?: string;
+  protocolVersion?: string;
+}
+
+export interface PlayerJoinedData {
+  room_id: string;
+  player_id: string;
+  player_ids: string[];
+  status?: string;
+  game_state?: Record<string, any>;
+}
+
+export interface PlayerLeftData {
+  room_id: string;
+  player_id: string;
+}
+
+export interface StateUpdateData {
+  room_id: string;
+  game_state?: Record<string, any>;
+  current_turn?: string;
+  status?: string;
+  sequence?: number;
+  [key: string]: any;
+}
+
+export interface GameActionData {
+  room_id: string;
+  player_id: string;
+  action_type: string;
+  action_data: Record<string, any>;
+  sequence?: number;
+}
+
+export interface GameFinishedData {
+  room_id: string;
+  winner_ids: string[];
+  reason?: string;
+  forfeiter?: string;
+}
+
+export interface SyncData {
+  room_id: string;
+  actions: GameActionData[];
+  game_state: Record<string, any>;
+  sequence: number;
+}
+
+export interface RematchData {
+  room_id: string;
+  player_id: string;
+}
+
+export interface GameModule {
+  // Connection
+  connect(socketUrl?: string, token?: string): Promise<void>;
+  connectDirect(config?: DirectConnectionConfig): Promise<void>;
+  disconnect(): void;
+  isConnected(): boolean;
+
+  // Room & actions
+  join(roomId?: string): Promise<GameJoinResult>;
+  leave(): void;
+  action(actionType: string, actionData?: Record<string, any>): Promise<ActionResult>;
+  realtime(actionType: string, actionData?: Record<string, any>): void;
+  requestSync(lastSequence?: number): void;
+  requestRematch(): void;
+  forfeit(): Promise<{ success: boolean; error?: string }>;
+
+  // Event handlers
+  onJoined(callback: (data: GameJoinResult) => void): void;
+  onPlayerJoined(callback: (data: PlayerJoinedData) => void): void;
+  onPlayerLeft(callback: (data: PlayerLeftData) => void): void;
+  onStateUpdate(callback: (data: StateUpdateData) => void): void;
+  onSync(callback: (data: SyncData) => void): void;
+  onAction(callback: (data: GameActionData) => void): void;
+  onRealtime(callback: (data: Record<string, any>) => void): void;
+  onGameFinished(callback: (data: GameFinishedData) => void): void;
+  onGameRestarted(callback: (data: Record<string, any>) => void): void;
+  onError(callback: (data: { message: string; code?: string }) => void): void;
+  onRematchRequest(callback: (data: RematchData) => void): void;
+  onDisconnect(callback: (reason: string) => void): void;
+  onReconnect(callback: (attemptNumber: number) => void): void;
+  onConnectionError(callback: (error: Error) => void): void;
+
+  // Generic event listener
+  on(event: string, callback: (data: any) => void): void;
+}
+
+// ─── Selection Grid ──────────────────────────────────────────────
+
+export interface SelectionGrid {
+  getSelected(): string | null;
+  clear(): void;
+}
+
+// ─── Main SDK ────────────────────────────────────────────────────
+
+export interface UsionSDK {
+  version: string;
+  config: UsionConfig;
+
+  // Lifecycle
+  init(callback: (config: UsionConfig) => void): void;
+  exit(): void;
+
+  // Payments
+  requestPayment(amount: number, reason: string, data?: Record<string, any>): Promise<PaymentResponse>;
+
+  // Service communication
+  submit(data: Record<string, any>): void;
+  error(message: string): void;
+
+  // Sharing
+  share(contentType: 'audio' | 'image' | 'video' | 'text' | 'mixed', data: ShareData): void;
+
+  // Logging
+  log(msg: string): void;
+
+  // Generic event listener
+  on(type: string, callback: (data: any) => void): void;
+
+  // UI helpers
+  setLoading(btn: HTMLElement | string, loading: boolean): void;
+  toggle(el: HTMLElement | string, show: boolean): void;
+  charCount(input: HTMLElement | string, counter: HTMLElement | string, max: number): void;
+  selectionGrid(
+    containerSelector: string,
+    itemSelector: string,
+    onChange: (selected: string, item: HTMLElement) => void
+  ): SelectionGrid;
+
+  // Modules
+  user: UserModule;
+  storage: StorageModule;
+  wallet: WalletModule;
+  session: SessionModule;
+  chat: ChatModule;
+  game: GameModule;
+}
+
+declare const Usion: UsionSDK;
+
+export { Usion };
+export default Usion;