@energy8platform/game-engine 0.7.0 → 0.8.0

package/src/debug/DevBridge.ts

@@ -5,6 +5,7 @@ import {
   type GameConfigData,
   type PlayResultData,
   type SessionData,
+  type PlayResultAckPayload,
 } from '@energy8platform/game-sdk';
 
 export interface DevBridgeConfig {
@@ -104,7 +105,7 @@ export class DevBridge {
       this.handlePlayRequest(payload, id);
     });
 
-    this._bridge.on('PLAY_RESULT_ACK', (payload: unknown) => {
+    this._bridge.on('PLAY_RESULT_ACK', (payload: PlayResultAckPayload) => {
       this.handlePlayAck(payload);
     });
 
@@ -188,14 +189,15 @@ export class DevBridge {
       nextActions: customResult.nextActions ?? ['spin'],
       session: customResult.session ?? null,
       creditPending: false,
-      currency: 'USD',
+      bonusFreeSpin: customResult.bonusFreeSpin ?? null,
+      currency: this._config.currency,
       gameId: this._config.gameConfig?.id ?? 'dev-game',
     };
 
     this.delayedSend('PLAY_RESULT', result, id);
   }
 
-  private handlePlayAck(_payload: unknown): void {
+  private handlePlayAck(_payload: PlayResultAckPayload): void {
     if (this._config.debug) {
       console.log('[DevBridge] Play acknowledged');
     }
@@ -206,7 +208,7 @@ export class DevBridge {
   }
 
   private handleGetState(id?: string): void {
-    this.delayedSend('STATE_RESPONSE', this._config.session, id);
+    this.delayedSend('STATE_RESPONSE', { session: this._config.session ?? null }, id);
   }
 
   private handleOpenDeposit(): void {

package/src/index.ts

@@ -29,6 +29,11 @@ export type {
   SessionData,
   PlayParams,
   PlayResultData,
+  BalanceData,
+  SymbolData,
+  PaylineData,
+  WinLineData,
+  AnywhereWinData,
 } from './types';
 
 // ─── Assets ──────────────────────────────────────────────
@@ -37,6 +42,14 @@ export { AssetManager } from './assets/AssetManager';
 // ─── Audio ───────────────────────────────────────────────
 export { AudioManager } from './audio/AudioManager';
 
+// ─── SDK Error Classes ───────────────────────────────────
+export {
+  SDKError,
+  TimeoutError,
+  BridgeNotReadyError,
+  BridgeDestroyedError,
+} from '@energy8platform/game-sdk';
+
 // ─── Viewport ────────────────────────────────────────────
 export { ViewportManager } from './viewport/ViewportManager';
 

package/src/state/StateMachine.ts

@@ -58,10 +58,12 @@ interface StateMachineEvents {
  * ```
  */
 export class StateMachine<TContext = Record<string, unknown>> extends EventEmitter<StateMachineEvents> {
+  private static MAX_TRANSITION_DEPTH = 10;
+
   private _states = new Map<string, StateConfig<TContext>>();
   private _guards = new Map<string, (ctx: TContext) => boolean>();
   private _current: string | null = null;
-  private _transitioning = false;
+  private _transitionDepth = 0;
   private _context: TContext;
 
   constructor(context: TContext) {
@@ -76,7 +78,7 @@ export class StateMachine<TContext = Record<string, unknown>> extends EventEmitt
 
   /** Whether a transition is in progress */
   get isTransitioning(): boolean {
-    return this._transitioning;
+    return this._transitionDepth > 0;
   }
 
   /** State machine context (shared data) */
@@ -131,9 +133,10 @@ export class StateMachine<TContext = Record<string, unknown>> extends EventEmitt
    * @returns true if the transition succeeded, false if blocked by a guard
    */
   async transition(to: string, data?: unknown): Promise<boolean> {
-    if (this._transitioning) {
-      console.warn('[StateMachine] Transition already in progress');
-      return false;
+    if (this._transitionDepth >= StateMachine.MAX_TRANSITION_DEPTH) {
+      throw new Error(
+        '[StateMachine] Max transition depth exceeded — possible infinite loop',
+      );
     }
 
     const from = this._current;
@@ -152,7 +155,7 @@ export class StateMachine<TContext = Record<string, unknown>> extends EventEmitt
       throw new Error(`[StateMachine] State "${to}" not registered.`);
     }
 
-    this._transitioning = true;
+    this._transitionDepth++;
 
     try {
       // Exit current state
@@ -170,7 +173,7 @@ export class StateMachine<TContext = Record<string, unknown>> extends EventEmitt
       this.emit('error', err instanceof Error ? err : new Error(String(err)));
       throw err;
     } finally {
-      this._transitioning = false;
+      this._transitionDepth--;
     }
 
     return true;
@@ -213,7 +216,7 @@ export class StateMachine<TContext = Record<string, unknown>> extends EventEmitt
       await state?.exit?.(this._context);
     }
     this._current = null;
-    this._transitioning = false;
+    this._transitionDepth = 0;
   }
 
   /**

package/src/types.ts

@@ -5,6 +5,11 @@ import type {
   SessionData,
   PlayParams,
   PlayResultData,
+  BalanceData,
+  SymbolData,
+  PaylineData,
+  WinLineData,
+  AnywhereWinData,
 } from '@energy8platform/game-sdk';
 
 // ─── Scale Modes ───────────────────────────────────────────
@@ -191,6 +196,8 @@ export interface GameEngineEvents {
   orientationChange: Orientation;
   /** Fired on scene change */
   sceneChange: { from: string | null; to: string };
+  /** Fired when player balance changes (forwarded from SDK) */
+  balanceUpdate: { balance: number };
   /** Fired on error */
   error: Error;
   /** Fired when engine is destroyed */
@@ -219,4 +226,9 @@ export type {
   SessionData,
   PlayParams,
   PlayResultData,
+  BalanceData,
+  SymbolData,
+  PaylineData,
+  WinLineData,
+  AnywhereWinData,
 };