@slot-engine/core 0.2.0 → 0.2.2

package/dist/index.d.mts

@@ -50,6 +50,7 @@ type PermanentFilePaths = {
     booksIndexMeta: (mode: string) => string;
     booksChunk: (mode: string, worker: number, chunk: number) => string;
     booksCompressed: (mode: string) => string;
+    booksUncompressed: (mode: string) => string;
     lookupTable: (mode: string) => string;
     lookupTableIndex: (mode: string) => string;
     lookupTableSegmented: (mode: string) => string;
@@ -175,6 +176,7 @@ declare class Simulation {
     readonly gameConfig: GameConfig & GameMetadata;
     readonly simRunsAmount: Partial<Record<string, number>>;
     readonly concurrency: number;
+    readonly makeUncompressedBooks: boolean;
     private debug;
     private actualSims;
     private wallet;
@@ -265,6 +267,7 @@ declare class Simulation {
      */
     confirmRecords(ctx: GameContext): void;
     printSimulationSummary(): Promise<void>;
+    private sendSimulationStatus;
 }
 type SimulationOptions = {
     /**
@@ -293,6 +296,10 @@ type SimulationOptions = {
      * Default: 50
      */
     maxDiskBuffer?: number;
+    /**
+     * Whether to generate uncompressed book files alongside compressed ones.
+     */
+    makeUncompressedBooks?: boolean;
 };
 type SimulationConfigOptions = {
     debug?: boolean;
@@ -538,6 +545,7 @@ declare class BoardService<TGameModes extends AnyGameModes = AnyGameModes, TSymb
     getPaddingTop(): Reels;
     getPaddingBottom(): Reels;
     getAnticipation(): boolean[];
+    getLockedReels(): boolean[];
     /**
      * Gets the symbol at the specified reel and row index.
      */
@@ -555,6 +563,10 @@ declare class BoardService<TGameModes extends AnyGameModes = AnyGameModes, TSymb
      * Sets the anticipation value for a specific reel.
      */
     setAnticipationForReel(reelIndex: number, value: boolean): void;
+    /**
+     * Sets the locked state for a specific reel.
+     */
+    setReelLocked(reelIndex: number, value: boolean): void;
     /**
      * Counts how many symbols matching the criteria are on a specific reel.
      */
@@ -1722,6 +1734,8 @@ declare class StandaloneBoard {
     getBoardReels(): Reels;
     getPaddingTop(): Reels;
     getPaddingBottom(): Reels;
+    getAnticipation(): boolean[];
+    getLockedReels(): boolean[];
     /**
      * Gets the symbol at the specified reel and row index.
      */
@@ -1739,6 +1753,10 @@ declare class StandaloneBoard {
      * Sets the anticipation value for a specific reel.
      */
     setAnticipationForReel(reelIndex: number, value: boolean): void;
+    /**
+     * Sets the locked state for a specific reel.
+     */
+    setReelLocked(reelIndex: number, value: boolean): void;
     /**
      * Counts how many symbols matching the criteria are on a specific reel.
      */

package/dist/index.d.ts

@@ -50,6 +50,7 @@ type PermanentFilePaths = {
     booksIndexMeta: (mode: string) => string;
     booksChunk: (mode: string, worker: number, chunk: number) => string;
     booksCompressed: (mode: string) => string;
+    booksUncompressed: (mode: string) => string;
     lookupTable: (mode: string) => string;
     lookupTableIndex: (mode: string) => string;
     lookupTableSegmented: (mode: string) => string;
@@ -175,6 +176,7 @@ declare class Simulation {
     readonly gameConfig: GameConfig & GameMetadata;
     readonly simRunsAmount: Partial<Record<string, number>>;
     readonly concurrency: number;
+    readonly makeUncompressedBooks: boolean;
     private debug;
     private actualSims;
     private wallet;
@@ -265,6 +267,7 @@ declare class Simulation {
      */
     confirmRecords(ctx: GameContext): void;
     printSimulationSummary(): Promise<void>;
+    private sendSimulationStatus;
 }
 type SimulationOptions = {
     /**
@@ -293,6 +296,10 @@ type SimulationOptions = {
      * Default: 50
      */
     maxDiskBuffer?: number;
+    /**
+     * Whether to generate uncompressed book files alongside compressed ones.
+     */
+    makeUncompressedBooks?: boolean;
 };
 type SimulationConfigOptions = {
     debug?: boolean;
@@ -538,6 +545,7 @@ declare class BoardService<TGameModes extends AnyGameModes = AnyGameModes, TSymb
     getPaddingTop(): Reels;
     getPaddingBottom(): Reels;
     getAnticipation(): boolean[];
+    getLockedReels(): boolean[];
     /**
      * Gets the symbol at the specified reel and row index.
      */
@@ -555,6 +563,10 @@ declare class BoardService<TGameModes extends AnyGameModes = AnyGameModes, TSymb
      * Sets the anticipation value for a specific reel.
      */
     setAnticipationForReel(reelIndex: number, value: boolean): void;
+    /**
+     * Sets the locked state for a specific reel.
+     */
+    setReelLocked(reelIndex: number, value: boolean): void;
     /**
      * Counts how many symbols matching the criteria are on a specific reel.
      */
@@ -1722,6 +1734,8 @@ declare class StandaloneBoard {
     getBoardReels(): Reels;
     getPaddingTop(): Reels;
     getPaddingBottom(): Reels;
+    getAnticipation(): boolean[];
+    getLockedReels(): boolean[];
     /**
      * Gets the symbol at the specified reel and row index.
      */
@@ -1739,6 +1753,10 @@ declare class StandaloneBoard {
      * Sets the anticipation value for a specific reel.
      */
     setAnticipationForReel(reelIndex: number, value: boolean): void;
+    /**
+     * Sets the locked state for a specific reel.
+     */
+    setReelLocked(reelIndex: number, value: boolean): void;
     /**
      * Counts how many symbols matching the criteria are on a specific reel.
      */

package/dist/index.js

@@ -79,6 +79,7 @@ function createPermanentFilePaths(basePath) {
       `books_${mode}_chunk_${worker}-${chunk}.jsonl.zst`
     ),
     booksCompressed: (mode) => import_path.default.join(basePath, "publish_files", `books_${mode}.jsonl.zst`),
+    booksUncompressed: (mode) => import_path.default.join(basePath, `books_${mode}.jsonl`),
     lookupTable: (mode) => import_path.default.join(basePath, `lookUpTable_${mode}.csv`),
     lookupTableIndex: (mode) => import_path.default.join(basePath, `lookUpTable_${mode}.index`),
     lookupTableSegmented: (mode) => import_path.default.join(basePath, `lookUpTableSegmented_${mode}.csv`),
@@ -476,8 +477,18 @@ var Board = class {
    * Used for triggering anticipation effects.
    */
   anticipation;
+  /**
+   * The most recent stop positions for the reels.
+   */
   lastDrawnReelStops;
+  /**
+   * The reel set used in the most recent draw.
+   */
   lastUsedReels;
+  /**
+   * Indicates whether each reel is locked or not.
+   */
+  reelsLocked;
   constructor() {
     this.reels = [];
     this.paddingTop = [];
@@ -485,6 +496,7 @@ var Board = class {
     this.anticipation = [];
     this.lastDrawnReelStops = [];
     this.lastUsedReels = [];
+    this.reelsLocked = [];
   }
   getSymbol(reelIndex, rowIndex) {
     return this.reels[reelIndex]?.[rowIndex];
@@ -632,14 +644,19 @@ var Board = class {
     return reelSet;
   }
   resetReels(opts) {
-    const length = opts.reelsAmount ?? opts.ctx.services.game.getCurrentGameMode().reelsAmount;
+    const { ctx, reelsAmount, reelsLocked } = opts;
+    const length = reelsAmount ?? ctx.services.game.getCurrentGameMode().reelsAmount;
     this.reels = this.makeEmptyReels(opts);
     this.anticipation = Array.from({ length }, () => false);
+    this.reelsLocked = reelsLocked ?? Array.from({ length }, () => false);
     this.paddingTop = this.makeEmptyReels(opts);
     this.paddingBottom = this.makeEmptyReels(opts);
   }
   drawBoardMixed(opts) {
-    this.resetReels(opts);
+    this.resetReels({
+      ...opts,
+      ...this.reelsLocked.length && { reelsLocked: this.reelsLocked }
+    });
     const reelsAmount = opts.reelsAmount ?? opts.ctx.services.game.getCurrentGameMode().reelsAmount;
     const symbolsPerReel = opts.symbolsPerReel ?? opts.ctx.services.game.getCurrentGameMode().symbolsPerReel;
     const padSymbols = opts.padSymbols ?? opts.ctx.config.padSymbols;
@@ -668,6 +685,18 @@ var Board = class {
         );
       }
     }
+    if (this.reelsLocked.some((locked) => locked) && this.lastDrawnReelStops.length == 0) {
+      throw new Error(
+        "Cannot draw board with locked reels before drawing it at least once."
+      );
+    }
+    if (this.reelsLocked.some((locked) => locked)) {
+      for (let ridx = 0; ridx < reelsAmount; ridx++) {
+        if (this.reelsLocked[ridx]) {
+          finalReelStops[ridx] = this.lastDrawnReelStops[ridx];
+        }
+      }
+    }
     this.lastDrawnReelStops = finalReelStops.map((pos) => pos);
     this.lastUsedReels = opts.reels;
     for (let ridx = 0; ridx < reelsAmount; ridx++) {
@@ -829,6 +858,9 @@ var BoardService = class extends AbstractService {
   getAnticipation() {
     return this.board.anticipation;
   }
+  getLockedReels() {
+    return this.board.reelsLocked;
+  }
   /**
    * Gets the symbol at the specified reel and row index.
    */
@@ -858,6 +890,12 @@ var BoardService = class extends AbstractService {
   setAnticipationForReel(reelIndex, value) {
     this.board.anticipation[reelIndex] = value;
   }
+  /**
+   * Sets the locked state for a specific reel.
+   */
+  setReelLocked(reelIndex, value) {
+    this.board.reelsLocked[reelIndex] = value;
+  }
   /**
    * Counts how many symbols matching the criteria are on a specific reel.
    */
@@ -1799,6 +1837,8 @@ var TerminalUi = class {
   logs = [];
   logScrollOffset = 0;
   isScrolled = false;
+  maxLogs = 500;
+  totalLogs = 0;
   minWidth = 50;
   minHeight = 12;
   isRendering = false;
@@ -1824,12 +1864,13 @@ var TerminalUi = class {
         this.scrollDown();
       } else if (key === "l") {
         this.scrollToBottom();
-      } else if (key === "") {
+      } else if (key === "q" || key === "") {
         this.stop();
         process.exit(0);
       }
     };
     process.stdout.on("resize", this.resizeHandler);
+    process.on("SIGINT", this.sigintHandler);
   }
   get terminalWidth() {
     return process.stdout.columns || 80;
@@ -1851,7 +1892,6 @@ var TerminalUi = class {
     }
     this.render();
     this.renderInterval = setInterval(() => this.render(), 100);
-    process.on("SIGINT", this.sigintHandler);
   }
   stop() {
     if (this.renderInterval) {
@@ -1879,7 +1919,16 @@ var TerminalUi = class {
     this.totalSims = opts.totalSims;
   }
   log(message) {
-    this.logs.push({ i: this.logs.length, m: message });
+    this.logs.push({ i: this.totalLogs, m: message });
+    this.totalLogs++;
+    if (this.logs.length > this.maxLogs) {
+      const excess = this.logs.length - this.maxLogs;
+      this.logs.splice(0, excess);
+      this.logScrollOffset = Math.min(
+        this.logScrollOffset,
+        Math.max(0, this.logs.length - this.getLogAreaHeight())
+      );
+    }
     if (!this.isScrolled) this.scrollToBottom();
   }
   scrollUp(lines = 1) {
@@ -2044,6 +2093,7 @@ var Simulation = class {
   gameConfig;
   simRunsAmount;
   concurrency;
+  makeUncompressedBooks;
   debug = false;
   actualSims = 0;
   wallet = new Wallet();
@@ -2072,6 +2122,7 @@ var Simulation = class {
     const { config, metadata } = createGameConfig(gameConfigOpts);
     this.gameConfig = { ...config, ...metadata };
     this.gameConfigOpts = gameConfigOpts;
+    this.makeUncompressedBooks = opts.makeUncompressedBooks || false;
     this.simRunsAmount = opts.simRunsAmount || {};
     this.concurrency = (opts.concurrency || 6) >= 2 ? opts.concurrency || 6 : 2;
     this.maxPendingSims = opts.maxPendingSims ?? 25;
@@ -2149,9 +2200,7 @@ var Simulation = class {
         const startTime = Date.now();
         statusMessage = `Simulating mode "${mode}" with ${this.simRunsAmount[mode]} runs.`;
         this.tui?.log(statusMessage);
-        if (this.socket && this.panelActive) {
-          this.socket.emit("simulationStatus", statusMessage);
-        }
+        this.sendSimulationStatus(statusMessage);
         const runs = this.simRunsAmount[mode] || 0;
         if (runs <= 0) continue;
         if (!configuredGameModes.includes(mode)) {
@@ -2188,9 +2237,7 @@ var Simulation = class {
         createDirIfNotExists(this.PATHS.publishFiles);
         statusMessage = `Writing final files for game mode "${mode}". This may take a while...`;
         this.tui?.log(statusMessage);
-        if (this.socket && this.panelActive) {
-          this.socket.emit("simulationStatus", statusMessage);
-        }
+        this.sendSimulationStatus(statusMessage);
         writeFile(
           this.PATHS.booksIndexMeta(mode),
           JSON.stringify(
@@ -2245,13 +2292,43 @@ var Simulation = class {
         }
         await this.writeRecords(mode);
         this.writeIndexJson();
+        if (this.makeUncompressedBooks) {
+          statusMessage = `Creating decompressed book file for mode "${mode}". This may take a while...`;
+          this.tui?.log(statusMessage);
+          this.sendSimulationStatus(statusMessage);
+          const uncompressedBooksPath = this.PATHS.booksUncompressed(mode);
+          const outputStream = import_fs3.default.createWriteStream(uncompressedBooksPath, {
+            highWaterMark: this.streamHighWaterMark
+          });
+          try {
+            for (const { worker, chunks: chunks2 } of this.bookIndexMetas) {
+              for (let chunk = 0; chunk < chunks2; chunk++) {
+                const bookChunkPath = this.PATHS.booksChunk(mode, worker, chunk);
+                if (!import_fs3.default.existsSync(bookChunkPath)) continue;
+                const inputStream = import_fs3.default.createReadStream(bookChunkPath);
+                const compress = import_zlib.default.createZstdDecompress();
+                for await (const decompChunk of inputStream.pipe(compress)) {
+                  if (!outputStream.write(decompChunk)) {
+                    await new Promise((r) => outputStream.once("drain", () => r()));
+                  }
+                }
+              }
+            }
+            outputStream.end();
+            await new Promise((r) => outputStream.on("finish", () => r()));
+          } catch (error) {
+            statusMessage = import_chalk2.default.yellow(
+              `Error creating uncompressed book file: ${error.message}`
+            );
+            this.tui?.log(statusMessage);
+            this.sendSimulationStatus(statusMessage);
+          }
+        }
         const endTime = Date.now();
         const prettyTime = new Date(endTime - startTime).toISOString().slice(11, -1);
         statusMessage = `Mode ${mode} done! Time taken: ${prettyTime}`;
         this.tui?.log(statusMessage);
-        if (this.socket && this.panelActive) {
-          this.socket.emit("simulationStatus", statusMessage);
-        }
+        this.sendSimulationStatus(statusMessage);
       }
       this.tui?.stop();
       await this.printSimulationSummary();
@@ -2453,7 +2530,7 @@ var Simulation = class {
 `
               )
             ]);
-            if (this.bookBufferSizes.get(index) >= 12 * 1024 * 1024) {
+            if (this.bookBufferSizes.get(index) >= 10 * 1024 * 1024) {
               await flushBookChunk();
             }
             if (this.recordsWriteStream) {
@@ -2899,6 +2976,11 @@ var Simulation = class {
       });
     }
   }
+  sendSimulationStatus(message) {
+    if (this.socket && this.panelActive) {
+      this.socket.emit("simulationStatus", message);
+    }
+  }
 };
 
 // src/analysis/index.ts
@@ -4546,6 +4628,12 @@ var StandaloneBoard = class {
   getPaddingBottom() {
     return this.board.paddingBottom;
   }
+  getAnticipation() {
+    return this.board.anticipation;
+  }
+  getLockedReels() {
+    return this.board.reelsLocked;
+  }
   /**
    * Gets the symbol at the specified reel and row index.
    */
@@ -4575,6 +4663,12 @@ var StandaloneBoard = class {
   setAnticipationForReel(reelIndex, value) {
     this.board.anticipation[reelIndex] = value;
   }
+  /**
+   * Sets the locked state for a specific reel.
+   */
+  setReelLocked(reelIndex, value) {
+    this.board.reelsLocked[reelIndex] = value;
+  }
   /**
    * Counts how many symbols matching the criteria are on a specific reel.
    */