@slot-engine/core 0.0.2 → 0.0.4

package/dist/index.js

@@ -53,6 +53,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/GameConfig.ts
+var import_assert = __toESM(require("assert"));
 var GameConfig = class _GameConfig {
   config;
   constructor(opts) {
@@ -76,14 +77,12 @@ var GameConfig = class _GameConfig {
       userState: opts.userState,
       outputDir: "__build__"
     };
-    for (const symbol of opts.symbols) {
-      if (!this.config.symbols.has(symbol.id)) {
-        this.config.symbols.set(symbol.id, symbol);
-      } else {
-        console.warn(
-          `Symbol with id "${symbol.id}" already exists in the game config. Skipping duplicate. This is probably not intentional.`
-        );
-      }
+    for (const [key, value] of Object.entries(opts.symbols)) {
+      (0, import_assert.default)(
+        value.id === key,
+        `Symbol key "${key}" does not match symbol id "${value.id}"`
+      );
+      this.config.symbols.set(key, value);
     }
     function getAnticipationTrigger(spinType) {
       return Math.min(...Object.keys(opts.scatterToFreespins[spinType]).map(Number)) - 1;
@@ -117,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.
@@ -134,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.`);
@@ -1104,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.
    */
@@ -1556,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() {
@@ -1571,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.
@@ -1827,7 +1819,7 @@ var ManywaysWinType = class extends WinType {
 };
 
 // src/optimizer/OptimizationConditions.ts
-var import_assert = __toESM(require("assert"));
+var import_assert2 = __toESM(require("assert"));
 var OptimizationConditions = class {
   rtp;
   avgWin;
@@ -1838,14 +1830,14 @@ var OptimizationConditions = class {
   constructor(opts) {
     let { rtp, avgWin, hitRate, searchConditions, priority } = opts;
     if (rtp == void 0 || rtp === "x") {
-      (0, import_assert.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_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.");
       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_assert.default)(noneCount <= 1, "Invalid combination of optimization conditions.");
+    (0, import_assert2.default)(noneCount <= 1, "Invalid combination of optimization conditions.");
     this.searchRange = [-1, -1];
     this.forceSearch = {};
     if (typeof searchConditions === "number") {
@@ -1925,41 +1917,11 @@ var OptimizationParameters = class _OptimizationParameters {
 
 // src/Simulation.ts
 var import_fs3 = __toESM(require("fs"));
-var import_path3 = __toESM(require("path"));
-var import_assert2 = __toESM(require("assert"));
+var import_path2 = __toESM(require("path"));
+var import_assert3 = __toESM(require("assert"));
+var import_zlib = __toESM(require("zlib"));
 var import_esbuild = require("esbuild");
 var import_worker_threads2 = require("worker_threads");
-
-// src/utils/zstd.ts
-var import_path2 = __toESM(require("path"));
-var import_child_process = require("child_process");
-async function zstd(...args) {
-  return new Promise((resolve, reject) => {
-    const task = (0, import_child_process.spawn)(import_path2.default.join(__dirname, "./lib/zstd.exe"), args);
-    task.on("error", (error) => {
-      console.error("Error:", error);
-      reject(error);
-    });
-    task.on("exit", () => {
-      resolve(true);
-    });
-    task.on("close", () => {
-      resolve(true);
-    });
-    task.stdout.on("data", (data) => {
-      console.log(data.toString());
-    });
-    task.stderr.on("data", (data) => {
-      console.log(data.toString());
-    });
-    task.stdout.on("error", (data) => {
-      console.log(data.toString());
-      reject(data.toString());
-    });
-  });
-}
-
-// src/Simulation.ts
 var completedSimulations = 0;
 var TEMP_FILENAME = "__temp_compiled_src_IGNORE.js";
 var Simulation = class _Simulation {
@@ -1980,7 +1942,7 @@ var Simulation = class _Simulation {
     this.library = /* @__PURE__ */ new Map();
     this.records = [];
     const gameModeKeys = Object.keys(this.gameConfig.config.gameModes);
-    (0, import_assert2.default)(
+    (0, import_assert3.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."
     );
@@ -2017,14 +1979,14 @@ Simulating game mode: ${mode}`);
         const simNumsToCriteria = ResultSet.assignCriteriaToSimulations(this, mode);
         await this.spawnWorkersForGameMode({ mode, simNumsToCriteria });
         createDirIfNotExists(
-          import_path3.default.join(
+          import_path2.default.join(
             process.cwd(),
             this.gameConfig.config.outputDir,
             "optimization_files"
           )
         );
         createDirIfNotExists(
-          import_path3.default.join(process.cwd(), this.gameConfig.config.outputDir, "publish_files")
+          import_path2.default.join(process.cwd(), this.gameConfig.config.outputDir, "publish_files")
         );
         _Simulation.writeLookupTableCSV({
           gameMode: mode,
@@ -2120,7 +2082,7 @@ Simulating game mode: ${mode}`);
       }
     }
     return new Promise((resolve, reject) => {
-      const scriptPath = import_path3.default.join(process.cwd(), basePath, TEMP_FILENAME);
+      const scriptPath = import_path2.default.join(process.cwd(), basePath, TEMP_FILENAME);
       const worker = new import_worker_threads2.Worker(scriptPath, {
         workerData: {
           mode,
@@ -2168,10 +2130,10 @@ Simulating game mode: ${mode}`);
     }
     rows.sort((a, b) => Number(a.split(",")[0]) - Number(b.split(",")[0]));
     let outputFileName = `lookUpTable_${gameMode}.csv`;
-    let outputFilePath = import_path3.default.join(gameConfig.outputDir, outputFileName);
+    let outputFilePath = import_path2.default.join(gameConfig.outputDir, outputFileName);
     writeFile(outputFilePath, rows.join("\n"));
     outputFileName = `lookUpTable_${gameMode}_0.csv`;
-    outputFilePath = import_path3.default.join(gameConfig.outputDir, outputFileName);
+    outputFilePath = import_path2.default.join(gameConfig.outputDir, outputFileName);
     writeFile(outputFilePath, rows.join("\n"));
     return outputFilePath;
   }
@@ -2188,21 +2150,21 @@ Simulating game mode: ${mode}`);
     }
     rows.sort((a, b) => Number(a.split(",")[0]) - Number(b.split(",")[0]));
     const outputFileName = `lookUpTableSegmented_${gameMode}.csv`;
-    const outputFilePath = import_path3.default.join(gameConfig.outputDir, outputFileName);
+    const outputFilePath = import_path2.default.join(gameConfig.outputDir, outputFileName);
     writeFile(outputFilePath, rows.join("\n"));
     return outputFilePath;
   }
   static writeRecords(opts) {
     const { gameMode, fileNameWithoutExtension, records, gameConfig, debug } = opts;
     const outputFileName = fileNameWithoutExtension ? `${fileNameWithoutExtension}.json` : `force_record_${gameMode}.json`;
-    const outputFilePath = import_path3.default.join(gameConfig.outputDir, outputFileName);
+    const outputFilePath = import_path2.default.join(gameConfig.outputDir, outputFileName);
     writeFile(outputFilePath, JSON.stringify(records, null, 2));
     if (debug) _Simulation.logSymbolOccurrences(records);
     return outputFilePath;
   }
   static writeIndexJson(opts) {
     const { gameConfig } = opts;
-    const outputFilePath = import_path3.default.join(
+    const outputFilePath = import_path2.default.join(
       process.cwd(),
       gameConfig.outputDir,
       "publish_files",
@@ -2219,7 +2181,7 @@ Simulating game mode: ${mode}`);
   static async writeBooksJson(opts) {
     const { gameMode, fileNameWithoutExtension, library, gameConfig } = opts;
     const outputFileName = fileNameWithoutExtension ? `${fileNameWithoutExtension}.jsonl` : `books_${gameMode}.jsonl`;
-    const outputFilePath = import_path3.default.join(gameConfig.outputDir, outputFileName);
+    const outputFilePath = import_path2.default.join(gameConfig.outputDir, outputFileName);
     const books = Array.from(library.values()).map((b) => b.serialize()).map((b) => ({
       id: b.id,
       payoutMultiplier: b.payout,
@@ -2228,14 +2190,15 @@ Simulating game mode: ${mode}`);
     const contents = JSONL.stringify(books);
     writeFile(outputFilePath, contents);
     const compressedFileName = fileNameWithoutExtension ? `${fileNameWithoutExtension}.jsonl.zst` : `books_${gameMode}.jsonl.zst`;
-    const compressedFilePath = import_path3.default.join(
+    const compressedFilePath = import_path2.default.join(
       process.cwd(),
       gameConfig.outputDir,
       "publish_files",
       compressedFileName
     );
     import_fs3.default.rmSync(compressedFilePath, { force: true });
-    await zstd("-f", outputFilePath, "-o", compressedFilePath);
+    const compressed = import_zlib.default.zstdCompressSync(Buffer.from(contents));
+    import_fs3.default.writeFileSync(compressedFilePath, compressed);
   }
   static logSymbolOccurrences(records) {
     const validRecords = records.filter(
@@ -2266,14 +2229,14 @@ Simulating game mode: ${mode}`);
    * Compiles user configured game to JS for use in different Node processes
    */
   preprocessFiles() {
-    const builtFilePath = import_path3.default.join(this.gameConfig.config.outputDir, TEMP_FILENAME);
+    const builtFilePath = import_path2.default.join(this.gameConfig.config.outputDir, TEMP_FILENAME);
     import_fs3.default.rmSync(builtFilePath, { force: true });
     (0, import_esbuild.buildSync)({
       entryPoints: [process.cwd()],
       bundle: true,
       platform: "node",
-      outfile: import_path3.default.join(this.gameConfig.config.outputDir, TEMP_FILENAME),
-      external: ["esbuild", "@mongodb-js/zstd"]
+      outfile: import_path2.default.join(this.gameConfig.config.outputDir, TEMP_FILENAME),
+      external: ["esbuild"]
     });
   }
   getSimRangesForChunks(total, chunks) {
@@ -2330,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",
@@ -2381,8 +2347,8 @@ var SimulationContext = class extends Board {
 
 // src/analysis/index.ts
 var import_fs4 = __toESM(require("fs"));
-var import_path4 = __toESM(require("path"));
-var import_assert3 = __toESM(require("assert"));
+var import_path3 = __toESM(require("path"));
+var import_assert4 = __toESM(require("assert"));
 
 // src/analysis/utils.ts
 function parseLookupTable(content) {
@@ -2426,8 +2392,11 @@ function getPayoutWeights(lut, opts = {}) {
 }
 function getNonZeroHitrate(payoutWeights) {
   const totalWeight = getTotalWeight(payoutWeights);
-  const nonZeroWeight = totalWeight - (payoutWeights[0] ?? 0) * totalWeight;
-  return nonZeroWeight / totalWeight;
+  if (Math.min(...Object.keys(payoutWeights).map(Number)) == 0) {
+    return totalWeight / (totalWeight - (payoutWeights[0] ?? 0) / totalWeight);
+  } else {
+    return 1;
+  }
 }
 function getNullHitrate(payoutWeights) {
   return payoutWeights[0] ?? 0;
@@ -2488,6 +2457,7 @@ function getLessBetHitrate(payoutWeights, cost) {
 }
 
 // src/analysis/index.ts
+var import_worker_threads3 = require("worker_threads");
 var Analysis = class {
   gameConfig;
   optimizerConfig;
@@ -2498,6 +2468,7 @@ var Analysis = class {
     this.filePaths = {};
   }
   async runAnalysis(gameModes) {
+    if (!import_worker_threads3.isMainThread) return;
     this.filePaths = this.getPathsForModes(gameModes);
     this.getNumberStats(gameModes);
     this.getWinRanges(gameModes);
@@ -2507,28 +2478,28 @@ var Analysis = class {
     const rootPath = process.cwd();
     const paths = {};
     for (const modeStr of gameModes) {
-      const lut = import_path4.default.join(
+      const lut = import_path3.default.join(
         rootPath,
         this.gameConfig.outputDir,
         `lookUpTable_${modeStr}.csv`
       );
-      const lutSegmented = import_path4.default.join(
+      const lutSegmented = import_path3.default.join(
         rootPath,
         this.gameConfig.outputDir,
         `lookUpTableSegmented_${modeStr}.csv`
       );
-      const lutOptimized = import_path4.default.join(
+      const lutOptimized = import_path3.default.join(
         rootPath,
         this.gameConfig.outputDir,
         "publish_files",
         `lookUpTable_${modeStr}_0.csv`
       );
-      const booksJsonl = import_path4.default.join(
+      const booksJsonl = import_path3.default.join(
         rootPath,
         this.gameConfig.outputDir,
         `books_${modeStr}.jsonl`
       );
-      const booksJsonlCompressed = import_path4.default.join(
+      const booksJsonlCompressed = import_path3.default.join(
         rootPath,
         this.gameConfig.outputDir,
         "publish_files",
@@ -2542,7 +2513,7 @@ var Analysis = class {
         booksJsonlCompressed
       };
       for (const p of Object.values(paths[modeStr])) {
-        (0, import_assert3.default)(
+        (0, import_assert4.default)(
           import_fs4.default.existsSync(p),
           `File "${p}" does not exist. Run optimization to auto-create it.`
         );
@@ -2576,7 +2547,7 @@ var Analysis = class {
       });
     }
     writeJsonFile(
-      import_path4.default.join(process.cwd(), this.gameConfig.outputDir, "stats_summary.json"),
+      import_path3.default.join(process.cwd(), this.gameConfig.outputDir, "stats_summary.json"),
       stats
     );
   }
@@ -2614,13 +2585,13 @@ var Analysis = class {
   }
   getGameModeConfig(mode) {
     const config = this.gameConfig.gameModes[mode];
-    (0, import_assert3.default)(config, `Game mode "${mode}" not found in game config`);
+    (0, import_assert4.default)(config, `Game mode "${mode}" not found in game config`);
     return config;
   }
 };
 
 // src/utils/math-config.ts
-var import_path5 = __toESM(require("path"));
+var import_path4 = __toESM(require("path"));
 function makeMathConfig(optimizer, opts = {}) {
   const game = optimizer.getGameConfig();
   const gameModesCfg = optimizer.getOptimizerGameModes();
@@ -2664,14 +2635,14 @@ function makeMathConfig(optimizer, opts = {}) {
     }))
   };
   if (writeToFile) {
-    const outPath = import_path5.default.join(process.cwd(), game.outputDir, "math_config.json");
+    const outPath = import_path4.default.join(process.cwd(), game.outputDir, "math_config.json");
     writeJsonFile(outPath, config);
   }
   return config;
 }
 
 // src/utils/setup-file.ts
-var import_path6 = __toESM(require("path"));
+var import_path5 = __toESM(require("path"));
 function makeSetupFile(optimizer, gameMode) {
   const gameConfig = optimizer.getGameConfig();
   const optimizerGameModes = optimizer.getOptimizerGameModes();
@@ -2707,19 +2678,19 @@ function makeSetupFile(optimizer, gameMode) {
 `;
   content += `simulation_trials;${params.simulationTrials}
 `;
-  content += `user_game_build_path;${import_path6.default.join(process.cwd(), gameConfig.outputDir)}
+  content += `user_game_build_path;${import_path5.default.join(process.cwd(), gameConfig.outputDir)}
 `;
   content += `pmb_rtp;${params.pmbRtp}
 `;
-  const outPath = import_path6.default.join(__dirname, "./optimizer-rust/src", "setup.txt");
+  const outPath = import_path5.default.join(__dirname, "./optimizer-rust/src", "setup.txt");
   writeFile(outPath, content);
 }
 
 // src/optimizer/index.ts
-var import_child_process2 = require("child_process");
-var import_path7 = __toESM(require("path"));
-var import_assert4 = __toESM(require("assert"));
-var import_worker_threads3 = require("worker_threads");
+var import_child_process = require("child_process");
+var import_path6 = __toESM(require("path"));
+var import_assert5 = __toESM(require("assert"));
+var import_worker_threads4 = require("worker_threads");
 var Optimizer = class {
   gameConfig;
   gameModes;
@@ -2732,12 +2703,13 @@ var Optimizer = class {
    * Runs the optimization process, and runs analysis after.
    */
   async runOptimization({ gameModes }) {
-    if (!import_worker_threads3.isMainThread) return;
+    if (!import_worker_threads4.isMainThread) return;
     const mathConfig = makeMathConfig(this, { writeToFile: true });
     for (const mode of gameModes) {
       const setupFile = makeSetupFile(this, mode);
       await this.runSingleOptimization();
     }
+    console.log("Optimization complete. Files written to build directory.");
   }
   async runSingleOptimization() {
     return await rustProgram();
@@ -2761,7 +2733,7 @@ var Optimizer = class {
         }
       }
       const criteria = configMode.resultSets.map((r) => r.criteria);
-      (0, import_assert4.default)(
+      (0, import_assert5.default)(
         conditions.every((c) => criteria.includes(c)),
         `Not all ResultSet criteria in game mode "${k}" are defined as optimization conditions.`
       );
@@ -2773,7 +2745,7 @@ var Optimizer = class {
       }
       gameModeRtp = Math.round(gameModeRtp * 1e3) / 1e3;
       paramRtp = Math.round(paramRtp * 1e3) / 1e3;
-      (0, import_assert4.default)(
+      (0, import_assert5.default)(
         gameModeRtp === paramRtp,
         `Sum of all RTP conditions (${paramRtp}) does not match the game mode RTP (${gameModeRtp}) in game mode "${k}".`
       );
@@ -2788,9 +2760,9 @@ var Optimizer = class {
 };
 async function rustProgram(...args) {
   return new Promise((resolve, reject) => {
-    const task = (0, import_child_process2.spawn)("cargo", ["run", "--release", ...args], {
+    const task = (0, import_child_process.spawn)("cargo", ["run", "--release", ...args], {
       shell: true,
-      cwd: import_path7.default.join(__dirname, "./optimizer-rust"),
+      cwd: import_path6.default.join(__dirname, "./optimizer-rust"),
       stdio: "pipe"
     });
     task.on("error", (error) => {