@slot-engine/core 0.2.2 → 0.2.4

package/dist/index.mjs

@@ -44,7 +44,8 @@ function createPermanentFilePaths(basePath) {
     publishFiles: path.join(basePath, "publish_files"),
     simulationSummary: path.join(basePath, "simulation_summary.json"),
     statsPayouts: path.join(basePath, "stats_payouts.json"),
-    statsSummary: path.join(basePath, "stats_summary.json")
+    statsSummary: path.join(basePath, "stats_summary.json"),
+    statsRecords: path.join(basePath, "stats_records.json")
   };
 }
 function createTemporaryFilePaths(basePath, tempFolder) {
@@ -462,6 +463,14 @@ var Board = class {
       this.reels[reelIndex].splice(rowIndex, 1);
     }
   }
+  updateSymbol(reelIndex, rowIndex, properties) {
+    const symbol = this.getSymbol(reelIndex, rowIndex);
+    if (symbol) {
+      for (const [key, value] of Object.entries(properties)) {
+        symbol.properties.set(key, value);
+      }
+    }
+  }
   makeEmptyReels(opts) {
     const length = opts.reelsAmount ?? opts.ctx.services.game.getCurrentGameMode().reelsAmount;
     assert3(length, "Cannot make empty reels without context or reelsAmount.");
@@ -831,6 +840,12 @@ var BoardService = class extends AbstractService {
   removeSymbol(reelIndex, rowIndex) {
     this.board.removeSymbol(reelIndex, rowIndex);
   }
+  /**
+   * Updates properties of the symbol at the specified reel and row index.
+   */
+  updateSymbol(reelIndex, rowIndex, properties) {
+    this.board.updateSymbol(reelIndex, rowIndex, properties);
+  }
   resetReels() {
     this.board.resetReels({
       ctx: this.ctx()
@@ -1039,7 +1054,10 @@ var DataService = class extends AbstractService {
    * Calls `ctx.services.data.record()` with the provided data.
    */
   recordSymbolOccurrence(data) {
-    this.record(data);
+    this.record({
+      ...data,
+      spinType: this.ctx().state.currentSpinType
+    });
   }
   /**
    * Adds an event to the book.
@@ -3061,15 +3079,21 @@ function getLessBetHitrate(payoutWeights, cost) {
 
 // src/analysis/index.ts
 import { isMainThread as isMainThread3 } from "worker_threads";
+import chalk3 from "chalk";
 var Analysis = class {
   game;
   constructor(game) {
     this.game = game;
   }
-  async runAnalysis(gameModes) {
+  async runAnalysis(opts) {
+    const { gameModes, recordStats = [] } = opts;
     if (!isMainThread3) return;
+    console.log(chalk3.gray("Starting analysis..."));
     this.getNumberStats(gameModes);
     this.getWinRanges(gameModes);
+    if (recordStats.length > 0) {
+      this.getRecordStats(gameModes, recordStats);
+    }
     console.log("Analysis complete. Files written to build directory.");
   }
   getNumberStats(gameModes) {
@@ -3246,6 +3270,85 @@ var Analysis = class {
     }
     writeJsonFile(meta.paths.statsPayouts, payoutRanges);
   }
+  getRecordStats(gameModes, recordStatsConfig) {
+    const meta = this.game.getMetadata();
+    const allStats = [];
+    for (const modeStr of gameModes) {
+      const lutOptimized = parseLookupTable(
+        fs4.readFileSync(meta.paths.lookupTablePublish(modeStr), "utf-8")
+      );
+      const totalWeight = getTotalLutWeight(lutOptimized);
+      const weightMap = /* @__PURE__ */ new Map();
+      lutOptimized.forEach(([bookId, weight]) => {
+        weightMap.set(bookId, weight);
+      });
+      const forceRecordsPath = meta.paths.forceRecords(modeStr);
+      if (!fs4.existsSync(forceRecordsPath)) continue;
+      const forceRecords = JSON.parse(
+        fs4.readFileSync(forceRecordsPath, "utf-8")
+      );
+      const modeStats = {
+        gameMode: modeStr,
+        groups: []
+      };
+      for (const config of recordStatsConfig) {
+        const groupName = config.name || config.groupBy.join("_");
+        const aggregated = /* @__PURE__ */ new Map();
+        for (const record of forceRecords) {
+          const searchMap = new Map(record.search.map((s) => [s.name, s.value]));
+          if (config.filter) {
+            let matches = true;
+            for (const [key2, value] of Object.entries(config.filter)) {
+              if (searchMap.get(key2) !== value) {
+                matches = false;
+                break;
+              }
+            }
+            if (!matches) continue;
+          }
+          const hasAllProps = config.groupBy.every((prop) => searchMap.has(prop));
+          if (!hasAllProps) continue;
+          const key = config.groupBy.map((prop) => searchMap.get(prop)).join("|");
+          const properties = Object.fromEntries(
+            config.groupBy.map((prop) => [prop, searchMap.get(prop)])
+          );
+          let totalWeight2 = 0;
+          for (const bookId of record.bookIds) {
+            totalWeight2 += weightMap.get(bookId) ?? 0;
+          }
+          const existing = aggregated.get(key);
+          if (existing) {
+            existing.count += record.timesTriggered;
+            existing.totalWeight += totalWeight2;
+          } else {
+            aggregated.set(key, {
+              properties,
+              count: record.timesTriggered,
+              totalWeight: totalWeight2
+            });
+          }
+        }
+        const items = Array.from(aggregated.entries()).map(([key, data]) => {
+          const hitRate = round(totalWeight / data.totalWeight, 4);
+          return {
+            key,
+            properties: data.properties,
+            count: data.count,
+            hitRateString: `1 in ${Math.round(hitRate).toLocaleString()}`,
+            hitRate
+          };
+        }).sort((a, b) => a.hitRate - b.hitRate);
+        modeStats.groups.push({
+          name: groupName,
+          groupBy: config.groupBy,
+          filter: config.filter,
+          items
+        });
+      }
+      allStats.push(modeStats);
+    }
+    writeJsonFile(meta.paths.statsRecords, allStats);
+  }
   getGameModeConfig(mode) {
     const config = this.game.getConfig().gameModes[mode];
     assert6(config, `Game mode "${mode}" not found in game config`);
@@ -3610,7 +3713,7 @@ var SlotGame = class _SlotGame {
    */
   runAnalysis(opts) {
     this.analyzer = new Analysis(this);
-    this.analyzer.runAnalysis(opts.gameModes);
+    this.analyzer.runAnalysis(opts);
   }
   /**
    * Runs the configured tasks: simulation, optimization, and/or analysis.
@@ -4056,27 +4159,36 @@ var ManywaysWinType = class extends WinType {
    * Calculates wins based on the defined paylines and provided board state.\
    * Retrieve the results using `getWins()` after.
    */
-  evaluateWins(board) {
+  evaluateWins(board, opts = {}) {
     this.validateConfig();
+    const { jumpGaps = false } = opts;
     const waysWins = [];
     const reels = board;
     const possibleWaysWins = /* @__PURE__ */ new Map();
     const candidateSymbols = /* @__PURE__ */ new Map();
-    let searchReelIdx = 0;
-    let searchActive = true;
-    while (searchActive && searchReelIdx < reels.length) {
-      const reel = reels[searchReelIdx];
-      let hasWild = false;
-      for (const symbol of reel) {
-        candidateSymbols.set(symbol.id, symbol);
-        if (this.isWild(symbol)) {
-          hasWild = true;
+    if (jumpGaps) {
+      for (const reel of reels) {
+        for (const symbol of reel) {
+          candidateSymbols.set(symbol.id, symbol);
         }
       }
-      if (!hasWild) {
-        searchActive = false;
+    } else {
+      let searchReelIdx = 0;
+      let searchActive = true;
+      while (searchActive && searchReelIdx < reels.length) {
+        const reel = reels[searchReelIdx];
+        let hasWild = false;
+        for (const symbol of reel) {
+          candidateSymbols.set(symbol.id, symbol);
+          if (this.isWild(symbol)) {
+            hasWild = true;
+          }
+        }
+        if (!hasWild) {
+          searchActive = false;
+        }
+        searchReelIdx++;
       }
-      searchReelIdx++;
     }
     for (const baseSymbol of candidateSymbols.values()) {
       let symbolList = {};
@@ -4092,7 +4204,7 @@ var ManywaysWinType = class extends WinType {
             symbolList[ridx].push({ reel: ridx, row: sidx, symbol });
           }
         }
-        if (!symbolList[ridx]) {
+        if (!symbolList[ridx] && !jumpGaps) {
           isInterrupted = true;
           break;
         }
@@ -4108,7 +4220,7 @@ var ManywaysWinType = class extends WinType {
     for (const [baseSymbolId, symbolList] of possibleWaysWins.entries()) {
       const wayLength = this.getWayLength(symbolList);
       let baseSymbol = Object.values(symbolList).flatMap((l) => l.map((s) => s)).find((s) => !this.isWild(s.symbol))?.symbol;
-      if (!baseSymbol) baseSymbol = symbolList[0][0].symbol;
+      if (!baseSymbol) baseSymbol = symbolList[Object.keys(symbolList)[0]][0].symbol;
       const singleWayPayout = this.getSymbolPayout(baseSymbol, wayLength);
       const totalWays = Object.values(symbolList).reduce(
         (ways, syms) => ways * syms.length,
@@ -4142,7 +4254,7 @@ var ManywaysWinType = class extends WinType {
     return this;
   }
   getWayLength(symbolList) {
-    return Math.max(...Object.keys(symbolList).map((k) => parseInt(k, 10))) + 1;
+    return Object.keys(symbolList).length;
   }
 };
 
@@ -4604,6 +4716,12 @@ var StandaloneBoard = class {
   removeSymbol(reelIndex, rowIndex) {
     this.board.removeSymbol(reelIndex, rowIndex);
   }
+  /**
+   * Updates properties of the symbol at the specified reel and row index.
+   */
+  updateSymbol(reelIndex, rowIndex, properties) {
+    this.board.updateSymbol(reelIndex, rowIndex, properties);
+  }
   resetReels() {
     this.board.resetReels({
       ctx: this.ctx