@slot-engine/core 0.0.3 → 0.0.5

package/dist/index.js

@@ -96,7 +96,6 @@ var GameConfig = class _GameConfig {
       if (mode.reelSets && mode.reelSets.length > 0) {
         for (const reelGenerator of Object.values(mode.reelSets)) {
           reelGenerator.associatedGameModeName = mode.name;
-          reelGenerator.outputDir = this.config.outputDir;
           reelGenerator.generateReels(this);
         }
       } else {
@@ -116,7 +115,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 +132,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.`);
@@ -159,6 +158,7 @@ var GameConfig = class _GameConfig {
 };
 
 // src/GameMode.ts
+var import_assert2 = __toESM(require("assert"));
 var GameMode = class {
   name;
   reelsAmount;
@@ -177,14 +177,12 @@ var GameMode = class {
     this.reelSets = opts.reelSets;
     this.resultSets = opts.resultSets;
     this.isBonusBuy = opts.isBonusBuy;
-    if (this.symbolsPerReel.length !== this.reelsAmount) {
-      throw new Error(
-        `symbolsPerReel length (${this.symbolsPerReel.length}) must match reelsAmount (${this.reelsAmount}).`
-      );
-    }
-    if (this.resultSets.length == 0) {
-      throw new Error("GameMode must have at least one ResultSet defined.");
-    }
+    (0, import_assert2.default)(this.rtp >= 0.9 && this.rtp <= 0.99, "RTP must be between 0.9 and 0.99");
+    (0, import_assert2.default)(
+      this.symbolsPerReel.length === this.reelsAmount,
+      "symbolsPerReel length must match reelsAmount."
+    );
+    (0, import_assert2.default)(this.reelSets.length > 0, "GameMode must have at least one ReelSet defined.");
   }
 };
 
@@ -395,7 +393,6 @@ var ReelGenerator = class {
   preferStackedSymbols;
   symbolStacks;
   symbolQuotas;
-  outputDir = "";
   csvPath = "";
   overrideExisting;
   rng;
@@ -403,7 +400,6 @@ var ReelGenerator = class {
     this.id = opts.id;
     this.symbolWeights = new Map(Object.entries(opts.symbolWeights));
     this.rowsAmount = opts.rowsAmount || 250;
-    this.outputDir = opts.outputDir;
     if (opts.limitSymbolsToReels) this.limitSymbolsToReels = opts.limitSymbolsToReels;
     this.overrideExisting = opts.overrideExisting || false;
     this.spaceBetweenSameSymbols = opts.spaceBetweenSameSymbols;
@@ -432,34 +428,16 @@ var ReelGenerator = class {
     this.rng.setSeed(opts.seed ?? 0);
   }
   validateConfig({ config }) {
-    config.symbols.forEach((symbol) => {
-      if (!this.symbolWeights.has(symbol.id)) {
+    this.symbolWeights.forEach((_, symbol) => {
+      if (!config.symbols.has(symbol)) {
         throw new Error(
-          [
-            `Symbol "${symbol.id}" is not defined in the symbol weights of the reel generator ${this.id} for mode ${this.associatedGameModeName}.`,
-            `Please ensure all symbols have weights defined.
-`
-          ].join(" ")
+          `Symbol "${symbol}" of the reel generator ${this.id} for mode ${this.associatedGameModeName} is not defined in the game config`
         );
       }
     });
-    for (const [symbolId, weight] of this.symbolWeights.entries()) {
-      if (!config.symbols.has(symbolId)) {
-        throw new Error(
-          [
-            `Symbol "${symbolId}" is defined in the reel generator's symbol weights, but does not exist in the game config.`,
-            `Please ensure all symbols in the reel generator are defined in the game config.
-`
-          ].join(" ")
-        );
-      }
-    }
     if (this.limitSymbolsToReels && Object.keys(this.limitSymbolsToReels).length == 0) {
       this.limitSymbolsToReels = void 0;
     }
-    if (this.outputDir === "") {
-      throw new Error("Output directory must be specified for the ReelGenerator.");
-    }
   }
   isSymbolAllowedOnReel(symbolId, reelIdx) {
     if (!this.limitSymbolsToReels) return true;
@@ -539,6 +517,15 @@ var ReelGenerator = class {
     );
     this.csvPath = filePath;
     const exists = import_fs2.default.existsSync(filePath);
+    if (exists && !this.overrideExisting) {
+      this.reels = this.parseReelsetCSV(filePath, gameConf);
+      return;
+    }
+    if (!exists && this.symbolWeights.size === 0) {
+      throw new Error(
+        `Cannot generate reels for generator "${this.id}" of mode "${this.associatedGameModeName}" because the symbol weights are empty.`
+      );
+    }
     const reelsAmount = gameMode.reelsAmount;
     const weightsObj = Object.fromEntries(this.symbolWeights);
     for (let ridx = 0; ridx < reelsAmount; ridx++) {
@@ -673,16 +660,12 @@ var ReelGenerator = class {
     }
     const csvString = csvRows.map((row) => row.join(",")).join("\n");
     if (import_worker_threads.isMainThread) {
-      createDirIfNotExists(this.outputDir);
       import_fs2.default.writeFileSync(filePath, csvString);
       this.reels = this.parseReelsetCSV(filePath, gameConf);
       console.log(
         `Generated reelset ${this.id} for game mode ${this.associatedGameModeName}`
       );
     }
-    if (exists) {
-      this.reels = this.parseReelsetCSV(filePath, gameConf);
-    }
   }
   /**
    * Reads a reelset CSV file and returns the reels as arrays of GameSymbols.
@@ -706,11 +689,21 @@ var ReelGenerator = class {
         reels[ridx].push(symbol);
       });
     });
+    const reelLengths = reels.map((r) => r.length);
+    const uniqueLengths = new Set(reelLengths);
+    if (uniqueLengths.size > 1) {
+      throw new Error(
+        `Inconsistent reel lengths in reelset CSV at ${reelSetPath}: ${[
+          ...uniqueLengths
+        ].join(", ")}`
+      );
+    }
     return reels;
   }
 };
 
 // src/ResultSet.ts
+var import_assert3 = __toESM(require("assert"));
 var ResultSet = class {
   criteria;
   quota;
@@ -729,16 +722,11 @@ var ResultSet = class {
     this.forceMaxWin = opts.forceMaxWin;
     this.forceFreespins = opts.forceFreespins;
     this.evaluate = opts.evaluate;
-    if (this.quota < 0 || this.quota > 1) {
-      throw new Error(`Quota must be a float between 0 and 1, got ${this.quota}.`);
-    }
   }
   static assignCriteriaToSimulations(ctx, gameModeName) {
     const rng = new RandomNumberGenerator();
     rng.setSeed(0);
-    if (!ctx.simRunsAmount) {
-      throw new Error("Simulation configuration is not set.");
-    }
+    (0, import_assert3.default)(ctx.simRunsAmount, "Simulation configuration is not set.");
     const simNums = ctx.simRunsAmount[gameModeName];
     const resultSets = ctx.gameConfig.config.gameModes[gameModeName]?.resultSets;
     if (!resultSets || resultSets.length === 0) {
@@ -747,8 +735,12 @@ var ResultSet = class {
     if (simNums === void 0 || simNums <= 0) {
       throw new Error(`No simulations configured for game mode "${gameModeName}".`);
     }
+    const totalQuota = resultSets.reduce((sum, rs) => sum + rs.quota, 0);
     const numberOfSimsForCriteria = Object.fromEntries(
-      resultSets.map((rs) => [rs.criteria, Math.max(Math.floor(rs.quota * simNums), 1)])
+      resultSets.map((rs) => {
+        const normalizedQuota = totalQuota > 0 ? rs.quota / totalQuota : 0;
+        return [rs.criteria, Math.max(Math.floor(normalizedQuota * simNums), 1)];
+      })
     );
     let totalSims = Object.values(numberOfSimsForCriteria).reduce(
       (sum, num) => sum + num,
@@ -1103,13 +1095,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 +1540,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 +1555,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.
@@ -1826,7 +1811,7 @@ var ManywaysWinType = class extends WinType {
 };
 
 // src/optimizer/OptimizationConditions.ts
-var import_assert2 = __toESM(require("assert"));
+var import_assert4 = __toESM(require("assert"));
 var OptimizationConditions = class {
   rtp;
   avgWin;
@@ -1837,14 +1822,14 @@ var OptimizationConditions = class {
   constructor(opts) {
     let { rtp, avgWin, hitRate, searchConditions, priority } = opts;
     if (rtp == void 0 || rtp === "x") {
-      (0, import_assert2.default)(avgWin !== void 0 && hitRate !== void 0, "If RTP is not specified, hit-rate (hr) and average win amount (av_win) must be given.");
+      (0, import_assert4.default)(avgWin !== void 0 && hitRate !== void 0, "If RTP is not specified, hit-rate (hr) and average win amount (av_win) must be given.");
       rtp = Math.round(avgWin / Number(hitRate) * 1e5) / 1e5;
     }
     let noneCount = 0;
     for (const val of [rtp, avgWin, hitRate]) {
       if (val === void 0) noneCount++;
     }
-    (0, import_assert2.default)(noneCount <= 1, "Invalid combination of optimization conditions.");
+    (0, import_assert4.default)(noneCount <= 1, "Invalid combination of optimization conditions.");
     this.searchRange = [-1, -1];
     this.forceSearch = {};
     if (typeof searchConditions === "number") {
@@ -1925,7 +1910,7 @@ var OptimizationParameters = class _OptimizationParameters {
 // src/Simulation.ts
 var import_fs3 = __toESM(require("fs"));
 var import_path2 = __toESM(require("path"));
-var import_assert3 = __toESM(require("assert"));
+var import_assert5 = __toESM(require("assert"));
 var import_zlib = __toESM(require("zlib"));
 var import_esbuild = require("esbuild");
 var import_worker_threads2 = require("worker_threads");
@@ -1949,7 +1934,7 @@ var Simulation = class _Simulation {
     this.library = /* @__PURE__ */ new Map();
     this.records = [];
     const gameModeKeys = Object.keys(this.gameConfig.config.gameModes);
-    (0, import_assert3.default)(
+    (0, import_assert5.default)(
       Object.values(this.gameConfig.config.gameModes).map((m) => gameModeKeys.includes(m.name)).every((v) => v === true),
       "Game mode name must match its key in the gameModes object."
     );
@@ -2300,22 +2285,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",
@@ -2352,7 +2340,7 @@ var SimulationContext = class extends Board {
 // src/analysis/index.ts
 var import_fs4 = __toESM(require("fs"));
 var import_path3 = __toESM(require("path"));
-var import_assert4 = __toESM(require("assert"));
+var import_assert6 = __toESM(require("assert"));
 
 // src/analysis/utils.ts
 function parseLookupTable(content) {
@@ -2517,7 +2505,7 @@ var Analysis = class {
         booksJsonlCompressed
       };
       for (const p of Object.values(paths[modeStr])) {
-        (0, import_assert4.default)(
+        (0, import_assert6.default)(
           import_fs4.default.existsSync(p),
           `File "${p}" does not exist. Run optimization to auto-create it.`
         );
@@ -2589,7 +2577,7 @@ var Analysis = class {
   }
   getGameModeConfig(mode) {
     const config = this.gameConfig.gameModes[mode];
-    (0, import_assert4.default)(config, `Game mode "${mode}" not found in game config`);
+    (0, import_assert6.default)(config, `Game mode "${mode}" not found in game config`);
     return config;
   }
 };
@@ -2693,7 +2681,7 @@ function makeSetupFile(optimizer, gameMode) {
 // src/optimizer/index.ts
 var import_child_process = require("child_process");
 var import_path6 = __toESM(require("path"));
-var import_assert5 = __toESM(require("assert"));
+var import_assert7 = __toESM(require("assert"));
 var import_worker_threads4 = require("worker_threads");
 var Optimizer = class {
   gameConfig;
@@ -2737,7 +2725,7 @@ var Optimizer = class {
         }
       }
       const criteria = configMode.resultSets.map((r) => r.criteria);
-      (0, import_assert5.default)(
+      (0, import_assert7.default)(
         conditions.every((c) => criteria.includes(c)),
         `Not all ResultSet criteria in game mode "${k}" are defined as optimization conditions.`
       );
@@ -2749,7 +2737,7 @@ var Optimizer = class {
       }
       gameModeRtp = Math.round(gameModeRtp * 1e3) / 1e3;
       paramRtp = Math.round(paramRtp * 1e3) / 1e3;
-      (0, import_assert5.default)(
+      (0, import_assert7.default)(
         gameModeRtp === paramRtp,
         `Sum of all RTP conditions (${paramRtp}) does not match the game mode RTP (${gameModeRtp}) in game mode "${k}".`
       );