@slot-engine/core 0.0.3 → 0.0.4

package/dist/index.d.mts

@@ -603,12 +603,6 @@ declare class GameState<TGameModes extends AnyGameModes, TSymbols extends AnySym
      */
     getCurrentGameMode(): GameMode;
     resetState(): void;
-    /**
-     * Checks if a max win is reached by comparing `wallet.currentWin` to `config.maxWin`.
-     *
-     * Should be called after `wallet.confirmSpinWin()`.
-     */
-    isMaxWinTriggered(): void;
     /**
      * Empties the list of pending records in the recorder.
      */
@@ -769,7 +763,7 @@ declare class Board<TGameModes extends AnyGameModes, TSymbols extends AnySymbols
      */
     getRandomReelStops(reels: Reels, reelStops: number[][], amount: number): Record<string, number>;
     /**
-     * Selects a random reelset based on the configured weights for the current game mode.\
+     * Selects a random reel set based on the configured weights of the current result set.\
      * Returns the reels as arrays of GameSymbols.
      */
     getRandomReelset(): Reels;
@@ -896,7 +890,7 @@ declare class GameConfig<TGameModes extends AnyGameModes = AnyGameModes, TSymbol
     /**
      * Retrieves a reel set by its ID within a specific game mode.
      */
-    getReelsetById(gameMode: string, id: string): ReelGenerator;
+    getReelsetById(gameMode: string, id: string): Reels;
     /**
      * Retrieves the number of free spins awarded for a given spin type and scatter count.
      */
@@ -904,7 +898,7 @@ declare class GameConfig<TGameModes extends AnyGameModes = AnyGameModes, TSymbol
     /**
      * Retrieves a result set by its criteria within a specific game mode.
      */
-    getGameModeCriteria(mode: string, criteria: string): ResultSet<any>;
+    getResultSetByCriteria(mode: string, criteria: string): ResultSet<any>;
     /**
      * Returns all configured symbols as an array.
      */
@@ -1175,64 +1169,14 @@ declare class SlotGame<TGameModes extends AnyGameModes = AnyGameModes, TSymbols
  * @internal
  */
 interface CommonGameOptions<TGameModes extends AnyGameModes = AnyGameModes, TSymbols extends AnySymbols = AnySymbols, TUserState extends AnyUserData = AnyUserData> {
-    /**
-     * The unique identifier of the game, used for configuration and identification.
-     */
     id: string;
-    /**
-     * The name of the game, used for display purposes.
-     */
     name: string;
-    /**
-     * A GameMode is the core structure of a slot, defining the board,\
-     * bet cost, win type, and other properties.
-     *
-     * One-off mechanisms can also be injected into the core game logic from here.
-     */
     gameModes: Record<GameModeName, GameMode>;
-    /**
-     * A list of all symbols that will appear on the reels.
-     */
     symbols: TSymbols;
-    /**
-     * A mapping from spin type to scatter counts to the number of free spins awarded.
-     *
-     * @example
-     * ```ts
-     * scatterToFreespins: {
-     *   [GameConfig.CONSTANTS.BASE_GAME]: {
-     *     3: 10,
-     *     4: 12,
-     *     5: 15,
-     *   },
-     *   [GameConfig.CONSTANTS.FREE_SPINS]: {
-     *     3: 6,
-     *     4: 8,
-     *     5: 10,
-     *   },
-     * },
-     * ```
-     */
     scatterToFreespins: Record<string, Record<number, number>>;
-    /**
-     * If set, this will pad the board with symbols on the top and bottom of the reels.\
-     * Useful for teasing symbols right above or below the active board.
-     *
-     * Default: 1
-     */
     padSymbols?: number;
-    /**
-     * The maximum win multiplier of the game, e.g. 5000 for a 5000x max win.
-     */
     maxWinX: number;
-    /**
-     * Hooks are used to inject custom logic at specific points in the game flow.\
-     * Some required hooks must be implemented for certain features to work.
-     */
     hooks: GameHooks<TGameModes, TSymbols, TUserState>;
-    /**
-     * Custom additional state that can be used in game flow logic.
-     */
     userState?: TUserState;
 }
 /**
@@ -1280,14 +1224,62 @@ type HookContext<T> = T extends SlotGame<infer G, infer S, infer U> ? Simulation
 
 type InferGameType<TGameModes extends AnyGameModes, TSymbols extends AnySymbols, TUserState extends AnyUserData> = SlotGame<TGameModes, TSymbols, TUserState>;
 interface CreateSlotGameOpts<TGameModes extends AnyGameModes = AnyGameModes, TSymbols extends AnySymbols = AnySymbols, TUserState extends AnyUserData = AnyUserData> {
+    /**
+     * The unique identifier of the game, used for configuration and identification.
+     */
     id: CommonGameOptions["id"];
+    /**
+     * The name of the game, used for display purposes.
+     */
     name: CommonGameOptions["name"];
+    /**
+     * A GameMode is the core structure of a slot, defining the board,\
+     * bet cost, win type, and other properties.
+     */
     gameModes: TGameModes;
+    /**
+     * A list of all symbols that will appear on the reels.
+     */
     symbols: TSymbols;
+    /**
+     * A mapping from spin type to scatter counts to the number of free spins awarded.
+     *
+     * @example
+     * ```ts
+     * scatterToFreespins: {
+     *   [GameConfig.SPIN_TYPE.BASE_GAME]: {
+     *     3: 10,
+     *     4: 12,
+     *     5: 15,
+     *   },
+     *   [GameConfig.SPIN_TYPE.FREE_SPINS]: {
+     *     3: 6,
+     *     4: 8,
+     *     5: 10,
+     *   },
+     * },
+     * ```
+     */
     scatterToFreespins: CommonGameOptions["scatterToFreespins"];
+    /**
+     * If set, this will pad the board with symbols on the top and bottom of the reels.\
+     * Useful for teasing symbols right above or below the active board.
+     *
+     * Default: 1
+     */
     padSymbols?: CommonGameOptions["padSymbols"];
+    /**
+     * The maximum win multiplier of the game, e.g. 5000 for a 5000x max win.
+     */
     maxWinX: CommonGameOptions["maxWinX"];
+    /**
+     * Custom additional state that can be used in game flow logic.
+     */
     userState?: TUserState;
+    /**
+     * Hooks are used to inject custom logic at specific points in the game flow.\
+     * Some required hooks must be implemented for certain features to work.
+     */
     hooks: CommonGameOptions<TGameModes, TSymbols, TUserState>["hooks"];
 }
 declare function createSlotGame<TGame>(opts: TGame extends InferGameType<infer G, infer S, infer U> ? CreateSlotGameOpts<G, S, U> : never): TGame;

package/dist/index.d.ts

@@ -603,12 +603,6 @@ declare class GameState<TGameModes extends AnyGameModes, TSymbols extends AnySym
      */
     getCurrentGameMode(): GameMode;
     resetState(): void;
-    /**
-     * Checks if a max win is reached by comparing `wallet.currentWin` to `config.maxWin`.
-     *
-     * Should be called after `wallet.confirmSpinWin()`.
-     */
-    isMaxWinTriggered(): void;
     /**
      * Empties the list of pending records in the recorder.
      */
@@ -769,7 +763,7 @@ declare class Board<TGameModes extends AnyGameModes, TSymbols extends AnySymbols
      */
     getRandomReelStops(reels: Reels, reelStops: number[][], amount: number): Record<string, number>;
     /**
-     * Selects a random reelset based on the configured weights for the current game mode.\
+     * Selects a random reel set based on the configured weights of the current result set.\
      * Returns the reels as arrays of GameSymbols.
      */
     getRandomReelset(): Reels;
@@ -896,7 +890,7 @@ declare class GameConfig<TGameModes extends AnyGameModes = AnyGameModes, TSymbol
     /**
      * Retrieves a reel set by its ID within a specific game mode.
      */
-    getReelsetById(gameMode: string, id: string): ReelGenerator;
+    getReelsetById(gameMode: string, id: string): Reels;
     /**
      * Retrieves the number of free spins awarded for a given spin type and scatter count.
      */
@@ -904,7 +898,7 @@ declare class GameConfig<TGameModes extends AnyGameModes = AnyGameModes, TSymbol
     /**
      * Retrieves a result set by its criteria within a specific game mode.
      */
-    getGameModeCriteria(mode: string, criteria: string): ResultSet<any>;
+    getResultSetByCriteria(mode: string, criteria: string): ResultSet<any>;
     /**
      * Returns all configured symbols as an array.
      */
@@ -1175,64 +1169,14 @@ declare class SlotGame<TGameModes extends AnyGameModes = AnyGameModes, TSymbols
  * @internal
  */
 interface CommonGameOptions<TGameModes extends AnyGameModes = AnyGameModes, TSymbols extends AnySymbols = AnySymbols, TUserState extends AnyUserData = AnyUserData> {
-    /**
-     * The unique identifier of the game, used for configuration and identification.
-     */
     id: string;
-    /**
-     * The name of the game, used for display purposes.
-     */
     name: string;
-    /**
-     * A GameMode is the core structure of a slot, defining the board,\
-     * bet cost, win type, and other properties.
-     *
-     * One-off mechanisms can also be injected into the core game logic from here.
-     */
     gameModes: Record<GameModeName, GameMode>;
-    /**
-     * A list of all symbols that will appear on the reels.
-     */
     symbols: TSymbols;
-    /**
-     * A mapping from spin type to scatter counts to the number of free spins awarded.
-     *
-     * @example
-     * ```ts
-     * scatterToFreespins: {
-     *   [GameConfig.CONSTANTS.BASE_GAME]: {
-     *     3: 10,
-     *     4: 12,
-     *     5: 15,
-     *   },
-     *   [GameConfig.CONSTANTS.FREE_SPINS]: {
-     *     3: 6,
-     *     4: 8,
-     *     5: 10,
-     *   },
-     * },
-     * ```
-     */
     scatterToFreespins: Record<string, Record<number, number>>;
-    /**
-     * If set, this will pad the board with symbols on the top and bottom of the reels.\
-     * Useful for teasing symbols right above or below the active board.
-     *
-     * Default: 1
-     */
     padSymbols?: number;
-    /**
-     * The maximum win multiplier of the game, e.g. 5000 for a 5000x max win.
-     */
     maxWinX: number;
-    /**
-     * Hooks are used to inject custom logic at specific points in the game flow.\
-     * Some required hooks must be implemented for certain features to work.
-     */
     hooks: GameHooks<TGameModes, TSymbols, TUserState>;
-    /**
-     * Custom additional state that can be used in game flow logic.
-     */
     userState?: TUserState;
 }
 /**
@@ -1280,14 +1224,62 @@ type HookContext<T> = T extends SlotGame<infer G, infer S, infer U> ? Simulation
 
 type InferGameType<TGameModes extends AnyGameModes, TSymbols extends AnySymbols, TUserState extends AnyUserData> = SlotGame<TGameModes, TSymbols, TUserState>;
 interface CreateSlotGameOpts<TGameModes extends AnyGameModes = AnyGameModes, TSymbols extends AnySymbols = AnySymbols, TUserState extends AnyUserData = AnyUserData> {
+    /**
+     * The unique identifier of the game, used for configuration and identification.
+     */
     id: CommonGameOptions["id"];
+    /**
+     * The name of the game, used for display purposes.
+     */
     name: CommonGameOptions["name"];
+    /**
+     * A GameMode is the core structure of a slot, defining the board,\
+     * bet cost, win type, and other properties.
+     */
     gameModes: TGameModes;
+    /**
+     * A list of all symbols that will appear on the reels.
+     */
     symbols: TSymbols;
+    /**
+     * A mapping from spin type to scatter counts to the number of free spins awarded.
+     *
+     * @example
+     * ```ts
+     * scatterToFreespins: {
+     *   [GameConfig.SPIN_TYPE.BASE_GAME]: {
+     *     3: 10,
+     *     4: 12,
+     *     5: 15,
+     *   },
+     *   [GameConfig.SPIN_TYPE.FREE_SPINS]: {
+     *     3: 6,
+     *     4: 8,
+     *     5: 10,
+     *   },
+     * },
+     * ```
+     */
     scatterToFreespins: CommonGameOptions["scatterToFreespins"];
+    /**
+     * If set, this will pad the board with symbols on the top and bottom of the reels.\
+     * Useful for teasing symbols right above or below the active board.
+     *
+     * Default: 1
+     */
     padSymbols?: CommonGameOptions["padSymbols"];
+    /**
+     * The maximum win multiplier of the game, e.g. 5000 for a 5000x max win.
+     */
     maxWinX: CommonGameOptions["maxWinX"];
+    /**
+     * Custom additional state that can be used in game flow logic.
+     */
     userState?: TUserState;
+    /**
+     * Hooks are used to inject custom logic at specific points in the game flow.\
+     * Some required hooks must be implemented for certain features to work.
+     */
     hooks: CommonGameOptions<TGameModes, TSymbols, TUserState>["hooks"];
 }
 declare function createSlotGame<TGame>(opts: TGame extends InferGameType<infer G, infer S, infer U> ? CreateSlotGameOpts<G, S, U> : never): TGame;

package/dist/index.js

@@ -116,7 +116,7 @@ var GameConfig = class _GameConfig {
         `Reel set with id "${id}" not found in game mode "${gameMode}". Available reel sets: ${this.config.gameModes[gameMode].reelSets.map((rs) => rs.id).join(", ")}`
       );
     }
-    return reelSet;
+    return reelSet.reels;
   }
   /**
    * Retrieves the number of free spins awarded for a given spin type and scatter count.
@@ -133,7 +133,7 @@ var GameConfig = class _GameConfig {
   /**
    * Retrieves a result set by its criteria within a specific game mode.
    */
-  getGameModeCriteria(mode, criteria) {
+  getResultSetByCriteria(mode, criteria) {
     const gameMode = this.config.gameModes[mode];
     if (!gameMode) {
       throw new Error(`Game mode "${mode}" not found in game config.`);
@@ -1103,13 +1103,6 @@ var GameState = class extends GameConfig {
     this.clearPendingRecords();
     this.state.userData = this.config.userState || {};
   }
-  /**
-   * Checks if a max win is reached by comparing `wallet.currentWin` to `config.maxWin`.
-   *
-   * Should be called after `wallet.confirmSpinWin()`.
-   */
-  isMaxWinTriggered() {
-  }
   /**
    * Empties the list of pending records in the recorder.
    */
@@ -1555,7 +1548,7 @@ var Board = class extends GameState {
     return stopPositionsForReels;
   }
   /**
-   * Selects a random reelset based on the configured weights for the current game mode.\
+   * Selects a random reel set based on the configured weights of the current result set.\
    * Returns the reels as arrays of GameSymbols.
    */
   getRandomReelset() {
@@ -1570,7 +1563,7 @@ var Board = class extends GameState {
       reelSetId = weightedRandom(weights[this.state.currentSpinType], this.state.rng);
     }
     const reelSet = this.getReelsetById(this.state.currentGameMode, reelSetId);
-    return reelSet.reels;
+    return reelSet;
   }
   /**
    * Draws a board using specified reel stops.
@@ -2300,22 +2293,25 @@ var SimulationContext = class extends Board {
     this.state.currentGameMode = mode;
     this.state.currentSimulationId = simId;
     this.state.isCriteriaMet = false;
+    const resultSet = this.getResultSetByCriteria(this.state.currentGameMode, criteria);
     while (!this.state.isCriteriaMet) {
       this.actualSims++;
       this.resetSimulation();
-      const resultSet = this.getGameModeCriteria(this.state.currentGameMode, criteria);
       this.state.currentResultSet = resultSet;
       this.state.book.criteria = resultSet.criteria;
       this.handleGameFlow();
       if (resultSet.meetsCriteria(this)) {
         this.state.isCriteriaMet = true;
-        this.config.hooks.onSimulationAccepted?.(this);
-        this.record({
-          criteria: resultSet.criteria
-        });
       }
     }
     this.wallet.confirmWins(this);
+    if (this.state.book.getPayout() >= this.config.maxWinX) {
+      this.state.triggeredMaxWin = true;
+    }
+    this.record({
+      criteria: resultSet.criteria
+    });
+    this.config.hooks.onSimulationAccepted?.(this);
     this.confirmRecords();
     import_worker_threads2.parentPort?.postMessage({
       type: "complete",