@energy8platform/platform-core 0.16.1 → 0.17.0

package/src/lua/SimulationRunner.ts

@@ -140,27 +140,25 @@ export class SimulationRunner {
     };
   }
 
-  /** Calculate the real cost of one spin (accounting for buy bonus / ante bet) */
+  /**
+   * Calculate the real cost of one spin — mirrors v5
+   * ActionDefinition.DebitAmount: bet × (cost_multiplier || 1) when
+   * debit==='bet', otherwise 0. Returns `bet` as a fallback for unknown
+   * actions so RTP math still progresses (we count those as wagered).
+   */
   private calculateSpinCost(
     action: string,
     bet: number,
     gameDefinition: GameDefinition,
-    params?: Record<string, unknown>,
+    _params?: Record<string, unknown>,
   ): number {
-    // Check if this is a buy bonus action
     const actionDef = gameDefinition.actions[action];
-    if (actionDef?.buy_bonus_mode && gameDefinition.buy_bonus) {
-      const mode = gameDefinition.buy_bonus.modes[actionDef.buy_bonus_mode];
-      if (mode) {
-        return bet * mode.cost_multiplier;
-      }
-    }
-
-    // Check ante bet
-    if (params?.ante_bet && gameDefinition.ante_bet) {
-      return bet * gameDefinition.ante_bet.cost_multiplier;
+    if (!actionDef) return bet;
+    if (actionDef.debit !== 'bet') return 0;
+    const mult = actionDef.cost_multiplier;
+    if (typeof mult === 'number' && mult > 0 && mult !== 1) {
+      return bet * mult;
     }
-
     return bet;
   }
 }

package/src/lua/index.ts

@@ -17,9 +17,6 @@ export type {
   LuaEngineConfig,
   LuaPlayResult,
   MaxWinConfig,
-  BuyBonusConfig,
-  BuyBonusMode,
-  AnteBetConfig,
   PersistentStateConfig,
   BetLevelsConfig,
   SimulationConfig,

package/src/lua/types.ts

@@ -8,9 +8,13 @@ export interface GameDefinition {
   actions: Record<string, ActionDefinition>;
   bet_levels?: number[] | BetLevelsConfig;
   max_win?: MaxWinConfig;
-  buy_bonus?: BuyBonusConfig;
-  ante_bet?: AnteBetConfig;
   persistent_state?: PersistentStateConfig;
+  /**
+   * Session expiry duration as a Go-style duration string ("24h", "2h", "5ms").
+   * Mirrors the platform's GameDefinition.SessionTTL — defaults to 24h on
+   * the server when absent. Used by DevBridge to surface SESSION_EXPIRED.
+   */
+  session_ttl?: string;
 }
 
 export interface BetLevelsConfig {
@@ -24,22 +28,6 @@ export interface MaxWinConfig {
   fixed?: number;
 }
 
-export interface BuyBonusConfig {
-  modes: Record<string, BuyBonusMode>;
-}
-
-export interface BuyBonusMode {
-  cost_multiplier: number;
-  /** Distribution of forced scatter counts. Optional — if omitted, Lua script handles bonus setup itself. */
-  scatter_distribution?: Record<string, number>;
-  /** Optional description */
-  description?: string;
-}
-
-export interface AnteBetConfig {
-  cost_multiplier: number;
-}
-
 export interface PersistentStateConfig {
   vars: string[];
   exposed_vars: string[];
@@ -47,12 +35,27 @@ export interface PersistentStateConfig {
 
 // ─── Actions & Transitions ──────────────────────────────
 
+/**
+ * v5 action contract — cost_multiplier and feature_data live on the action
+ * itself. Removed in v5: top-level `buy_bonus`/`ante_bet` blocks, debit modes
+ * `'buy_bonus_cost'`/`'ante_bet_cost'`, action.buy_bonus_mode, params.ante_bet/
+ * params.buy_bonus flags. Lua reads action context via `state.action` and
+ * `state.action_config = { cost_multiplier, feature_data }`.
+ */
 export interface ActionDefinition {
   stage: string;
-  debit: 'bet' | 'buy_bonus_cost' | 'ante_bet_cost' | 'none';
+  /** Either 'bet' (debit = bet × cost_multiplier) or 'none'/empty (no debit). */
+  debit: 'bet' | 'none';
+  /** Multiplier on `bet` when debit==='bet'. Defaults to 1.0. */
+  cost_multiplier?: number;
+  /**
+   * Opaque action-specific configuration exposed to Lua as
+   * `state.action_config.feature_data`. Common keys: `scatter_distribution`
+   * for buy-bonus actions, forced symbol counts, etc.
+   */
+  feature_data?: Record<string, unknown>;
   credit?: 'win' | 'none' | 'defer';
   requires_session?: boolean;
-  buy_bonus_mode?: string;
   transitions: TransitionRule[];
   input_schema?: Record<string, unknown>;
 }

package/src/types.ts

@@ -74,9 +74,6 @@ export type {
   LuaEngineConfig,
   LuaPlayResult,
   MaxWinConfig,
-  BuyBonusConfig,
-  BuyBonusMode,
-  AnteBetConfig,
   PersistentStateConfig,
   BetLevelsConfig,
   SimulationConfig,