@omnitronix/bonnys-fortune-game-engine 1.3.1 → 1.3.2

package/src/config/game-logic-config/game-logic-config.ts

@@ -0,0 +1,382 @@
+import { BonnysFortuneGameLogicConfigInterface } from '../../logic/game-logic-config.interface';
+
+export const gameLogicConfig: BonnysFortuneGameLogicConfigInterface = {
+  baseGame: {
+    symbolMultipliers: [
+      {
+        symbolId: 0,
+        name: 'H1',
+        isWild: false,
+        isScatter: false,
+        multipliers: {
+          x3: 50,
+          x4: 150,
+          x5: 500,
+        },
+      },
+      {
+        symbolId: 1,
+        name: 'H2',
+        isWild: false,
+        isScatter: false,
+        multipliers: {
+          x3: 30,
+          x4: 100,
+          x5: 300,
+        },
+      },
+      {
+        symbolId: 2,
+        name: 'H3',
+        isWild: false,
+        isScatter: false,
+        multipliers: {
+          x3: 20,
+          x4: 50,
+          x5: 150,
+        },
+      },
+      {
+        symbolId: 3,
+        name: 'M1',
+        isWild: false,
+        isScatter: false,
+        multipliers: {
+          x3: 10,
+          x4: 25,
+          x5: 75,
+        },
+      },
+      {
+        symbolId: 4,
+        name: 'M2',
+        isWild: false,
+        isScatter: false,
+        multipliers: {
+          x3: 7,
+          x4: 15,
+          x5: 50,
+        },
+      },
+      {
+        symbolId: 5,
+        name: 'M3',
+        isWild: false,
+        isScatter: false,
+        multipliers: {
+          x3: 5,
+          x4: 10,
+          x5: 25,
+        },
+      },
+      {
+        symbolId: 6,
+        name: 'L1',
+        isWild: false,
+        isScatter: false,
+        multipliers: {
+          x3: 3,
+          x4: 6,
+          x5: 15,
+        },
+      },
+      {
+        symbolId: 7,
+        name: 'L2',
+        isWild: false,
+        isScatter: false,
+        multipliers: {
+          x3: 3,
+          x4: 6,
+          x5: 15,
+        },
+      },
+      {
+        symbolId: 8,
+        name: 'L3',
+        isWild: false,
+        isScatter: false,
+        multipliers: {
+          x3: 2,
+          x4: 4,
+          x5: 10,
+        },
+      },
+      {
+        symbolId: 9,
+        name: 'L4',
+        isWild: false,
+        isScatter: false,
+        multipliers: {
+          x3: 2,
+          x4: 4,
+          x5: 10,
+        },
+      },
+      {
+        symbolId: 10,
+        name: 'WILD',
+        isWild: true,
+        isScatter: false,
+        multipliers: {
+          x3: 1,
+          x4: 1,
+          x5: 1,
+        },
+      },
+      {
+        symbolId: 11,
+        name: 'SCATTER',
+        isWild: false,
+        isScatter: true,
+        multipliers: {
+          x3: 1,
+          x4: 1,
+          x5: 1,
+        },
+      },
+    ],
+    symbolDefinitions: {
+      baseSymbols: {
+        minIndex: 0,
+        maxIndex: 9,
+      },
+      specialSymbols: {
+        WILD: 10,
+        SCATTER: 11,
+      },
+      collectFeatureSymbols: {
+        multipliers: {
+          CM1: 12,
+          CM2: 13,
+          CM3: 14,
+        },
+        values: {
+          CV1: 15,
+          CV2: 16,
+          CV3: 17,
+        },
+      },
+    },
+    baseGameConfig: {
+      layout: {
+        rows: 3,
+        reels: 5,
+      },
+      winConfig: {
+        minLength: 3,
+        maxLength: 5,
+      },
+      baseBet: 10,
+      reelsOptions: {
+        numberOfOptions: 4,
+        optionWeights: [4, 4, 5, 5],
+      },
+    },
+    paidHSymbolWeights: {
+      None: 298,
+      H1: 22,
+      H2: 12,
+      H3: 50,
+    },
+    paidHSymbolReelWeights: {
+      H1: [5, 15],
+      H2: [5, 15],
+      H3: [5, 15],
+    },
+    paidScatterReelWeights: {
+      reel1: [3, 15],
+      reel2: [0, 5],
+      reel3: [3, 15],
+      reel4: [0, 5],
+      reel5: [3, 15],
+    },
+    bonusGameMeters: {
+      bonusGame1: {
+        symbol: 'H1',
+        min: 25,
+        max: 100,
+        percentageLevels: {
+          level1: { min: 0, max: 0.25, value: 1 },
+          level2: { min: 0.25, max: 0.65, value: 2 },
+          level3: { min: 0.65, max: 0.8, value: 3 },
+          level4: { min: 0.8, max: 1.0, value: 4 },
+          level5: { min: 1.0, max: 1.0, value: 5 },
+        },
+      },
+      bonusGame2: {
+        symbol: 'H2',
+        min: 25,
+        max: 70,
+        percentageLevels: {
+          level1: { min: 0, max: 0.25, value: 1 },
+          level2: { min: 0.25, max: 0.65, value: 2 },
+          level3: { min: 0.65, max: 0.8, value: 3 },
+          level4: { min: 0.8, max: 1.0, value: 4 },
+          level5: { min: 1.0, max: 1.0, value: 5 },
+        },
+      },
+      bonusGame3: {
+        symbol: 'H3',
+        min: 25,
+        max: 80,
+        percentageLevels: {
+          level1: { min: 0, max: 0.25, value: 1 },
+          level2: { min: 0.25, max: 0.65, value: 2 },
+          level3: { min: 0.65, max: 0.8, value: 3 },
+          level4: { min: 0.8, max: 1.0, value: 4 },
+          level5: { min: 1.0, max: 1.0, value: 5 },
+        },
+      },
+    },
+  },
+  bonusGames: {
+    bonusGame1: {
+      type: 'treasure_hunt',
+      potMeter: 'bonusGame1',
+      config: {
+        symbolsCount: 25,
+        stepsCount: 6,
+        jackpotMultipliers: {
+          mini: 20,
+          minor: 50,
+          major: 200,
+          grand: 2000,
+        },
+        jackpotStartCounts: {
+          mini: 0,
+          minor: 0,
+          major: 0,
+          grand: 0,
+        },
+        jackpotScreenCounts: {
+          mini: 10,
+          minor: 7,
+          major: 5,
+          grand: 3,
+        },
+        winningWeights: {
+          none: 30,
+          mini: 90,
+          minor: 25,
+          major: 5,
+          grand: 1,
+        },
+      },
+    },
+    bonusGame2: {
+      type: 'free_spins',
+      potMeter: 'bonusGame2',
+      config: {
+        spinTypes: [
+          {
+            layout: { reels: 5, rows: 3 },
+            spins: 8,
+            multiplier: 10,
+            weight: 5,
+            reelsOptionsWeights: [1, 1, 4, 4],
+          },
+          {
+            layout: { reels: 5, rows: 3 },
+            spins: 4,
+            multiplier: 20,
+            weight: 5,
+            reelsOptionsWeights: [1, 1, 4, 4],
+          },
+          {
+            layout: { reels: 5, rows: 4 },
+            spins: 8,
+            multiplier: 3,
+            weight: 5,
+            reelsOptionsWeights: [1, 1, 4, 4],
+          },
+          {
+            layout: { reels: 5, rows: 4 },
+            spins: 4,
+            multiplier: 6,
+            weight: 5,
+            reelsOptionsWeights: [1, 1, 4, 4],
+          },
+          {
+            layout: { reels: 5, rows: 5 },
+            spins: 8,
+            multiplier: 1,
+            weight: 5,
+            reelsOptionsWeights: [1, 1, 4, 4],
+          },
+          {
+            layout: { reels: 5, rows: 5 },
+            spins: 4,
+            multiplier: 2,
+            weight: 5,
+            reelsOptionsWeights: [1, 1, 4, 4],
+          },
+        ],
+      },
+    },
+    bonusGame3: {
+      type: 'steering_to_the_fortune',
+      potMeter: 'bonusGame3',
+      config: {
+        wheelResults: [
+          { type: 'MULTIPLIER', value: 5, weight: 2 },
+          { type: 'MULTIPLIER', value: 8, weight: 3 },
+          { type: 'MULTIPLIER', value: 10, weight: 5 },
+          { type: 'MULTIPLIER', value: 15, weight: 5 },
+          { type: 'MULTIPLIER', value: 25, weight: 5 },
+          { type: 'MULTIPLIER', value: 40, weight: 3 },
+          { type: 'MULTIPLIER', value: 80, weight: 2 },
+          { type: 'BONUS', bonusType: 'collectFeature', weight: 2 },
+          { type: 'BONUS', bonusType: 'bonusGame1', weight: 2 },
+          { type: 'BONUS', bonusType: 'bonusGame2', weight: 2 },
+        ],
+      },
+    },
+  },
+  defaultBetAmountThresholds: [0.1, 0.2, 0.5, 1, 2, 5, 10, 20, 50, 100],
+  defaultBetAmount: 1,
+  scatterGame: {
+    config: {
+      scatterMinNumber: 3,
+      scatterSpins: 6,
+      scatterCheckpoints: [
+        { spin: 3, multiMinValue: 0, valueMinValue: 1 },
+        { spin: 2, multiMinValue: 1, valueMinValue: 2 },
+      ],
+      scatterSymbols: [
+        {
+          symbolId: 'CM1',
+          value: 1,
+          weight: 20,
+        },
+        {
+          symbolId: 'CM2',
+          value: 2,
+          weight: 10,
+        },
+        {
+          symbolId: 'CM3',
+          value: 3,
+          weight: 2,
+        },
+        {
+          symbolId: 'CV1',
+          value: 1,
+          weight: 50,
+        },
+        {
+          symbolId: 'CV2',
+          value: 2,
+          weight: 15,
+        },
+        {
+          symbolId: 'CV3',
+          value: 5,
+          weight: 5,
+        },
+      ],
+      scatterSymbolSpins: [{ weight: 10 }, { weight: 4 }, { weight: 2 }],
+      scatterSymbolSlash: [{ weight: 10 }, { weight: 6 }, { weight: 0 }],
+    },
+  },
+};

package/src/config/reel-strips-config/file-system.reel-strips-config-loader.ts

@@ -0,0 +1,43 @@
+import { ReelStripsConfigLoader } from './reel-strips-config-loader';
+import path from 'path';
+import { readFileSync } from 'fs';
+
+export class FileSystemReelStripsConfigLoader
+  implements ReelStripsConfigLoader
+{
+  public async loadConfig(
+    gameId: string,
+    variantId: string,
+    reelSetName: string,
+    reelsCount: number,
+    optionsCount: number,
+  ): Promise<number[][][]> {
+    const filePath = path.resolve(__dirname, `./reels-${reelSetName}.csv`);
+
+    const content = readFileSync(filePath, 'utf-8');
+    const lines = content
+      .split('\n')
+      .map((line) => line.trim())
+      .filter((line) => line.length > 0)
+      .slice(2); // skip headers
+
+    const result: number[][][] = Array.from({ length: reelsCount }, () =>
+      Array.from({ length: optionsCount }, () => []),
+    );
+
+    for (const line of lines) {
+      const values = line.split(';').map((v) => v.trim());
+
+      for (let reel = 0; reel < reelsCount; reel++) {
+        for (let opt = 0; opt < optionsCount; opt++) {
+          const val = values[reel * optionsCount + opt];
+          if (val !== '') {
+            result[reel][opt].push(Number(val));
+          }
+        }
+      }
+    }
+
+    return result;
+  }
+}

package/src/config/reel-strips-config/reel-strip-option.dto.ts

@@ -0,0 +1,13 @@
+import { ArrayNotEmpty, IsArray, IsInt, Min } from 'class-validator';
+
+export class ReelStripOptionDto {
+  @IsArray()
+  @ArrayNotEmpty()
+  @IsInt({ each: true })
+  @Min(0, { each: true })
+  public symbols: number[];
+
+  constructor(symbols: number[]) {
+    this.symbols = symbols;
+  }
+}

package/src/config/reel-strips-config/reel-strips-config-loader.ts

@@ -0,0 +1,9 @@
+export interface ReelStripsConfigLoader {
+  loadConfig(
+    gameId: string,
+    variantId: string,
+    reelSetName: string,
+    reelsCount: number,
+    optionsCount: number,
+  ): Promise<number[][][]>;
+}

package/src/config/reel-strips-config/reel-strips-config.dto.ts

@@ -0,0 +1,16 @@
+import { ArrayNotEmpty, IsArray, ValidateNested } from 'class-validator';
+
+import { ReelDto } from './reel.dto';
+import { Type } from 'class-transformer';
+
+export class ReelStripsConfigDto {
+  @IsArray()
+  @ArrayNotEmpty()
+  @ValidateNested({ each: true })
+  @Type(() => ReelDto)
+  public reels: ReelDto[];
+
+  constructor(reels: ReelDto[]) {
+    this.reels = reels;
+  }
+}

package/src/config/reel-strips-config/reel.dto.ts

@@ -0,0 +1,16 @@
+import { ArrayNotEmpty, IsArray, ValidateNested } from 'class-validator';
+
+import { ReelStripOptionDto } from './reel-strip-option.dto';
+import { Type } from 'class-transformer';
+
+export class ReelDto {
+  @IsArray()
+  @ArrayNotEmpty()
+  @ValidateNested({ each: true })
+  @Type(() => ReelStripOptionDto)
+  public options: ReelStripOptionDto[];
+
+  constructor(options: ReelStripOptionDto[]) {
+    this.options = options;
+  }
+}

package/src/config/reel-strips-config/reels-BASE.csv

@@ -0,0 +1,52 @@
+Reel 1;;;;Reel 2;;;;Reel 3;;;;Reel 4;;;;Reel 5;;;
+option 0;option 1;option 2;option 3;option 0;option 1;option 2;option 3;option 0;option 1;option 2;option 3;option 0;option 1;option 2;option 3;option 0;option 1;option 2;option 3
+9;8;9;8;8;9;8;9;9;8;9;9;9;9;9;9;9;9;9;8
+9;8;9;8;8;9;8;9;9;8;9;9;9;9;9;9;9;9;9;8
+9;8;9;9;8;9;9;10;10;8;10;8;9;8;8;10;8;9;9;9
+7;6;7;6;6;7;6;7;7;6;7;6;6;7;6;7;7;6;7;6
+7;6;7;7;6;7;10;7;7;6;7;10;10;7;10;7;7;6;7;7
+7;4;6;4;4;7;4;6;7;4;6;4;4;7;4;6;7;4;6;4
+9;8;8;8;8;9;8;8;9;8;8;8;5;8;8;8;8;5;8;8
+5;8;5;3;8;5;3;5;5;10;5;3;8;10;3;3;5;8;5;3
+5;4;5;5;4;5;5;5;5;4;5;5;4;4;5;3;4;4;5;5
+7;6;7;6;6;7;6;7;7;6;7;7;6;6;7;7;6;6;7;6
+9;8;9;9;8;9;9;9;9;8;9;8;8;9;7;9;9;8;9;9
+3;8;3;9;8;3;9;3;3;8;3;9;3;10;9;5;3;3;3;9
+3;6;3;3;6;3;3;3;3;6;3;3;10;4;3;5;4;7;3;3
+5;6;5;7;6;5;7;5;5;6;5;6;6;5;6;5;5;6;5;7
+9;6;8;7;6;9;7;8;9;6;8;7;6;9;8;8;9;6;8;7
+9;8;8;8;8;9;8;8;9;8;8;9;8;9;9;8;9;8;8;8
+7;4;6;4;4;7;4;6;10;4;6;4;5;7;4;6;7;5;6;4
+7;4;6;4;4;7;4;6;7;4;6;4;5;7;4;6;7;5;6;4
+5;8;4;8;8;5;8;4;5;8;4;8;8;5;7;4;5;8;4;8
+5;8;4;8;8;5;8;4;5;10;4;8;8;5;7;4;5;8;4;8
+9;8;9;8;8;9;8;9;9;8;9;8;8;8;8;7;8;8;9;8
+9;4;9;5;4;9;5;9;9;4;9;5;4;8;5;7;8;4;9;5
+9;4;9;5;4;9;5;9;9;4;9;5;4;8;6;7;8;4;9;5
+7;6;7;6;6;7;6;7;7;6;7;7;7;7;7;7;7;7;7;6
+3;8;3;8;8;3;8;3;3;8;3;8;8;10;8;5;3;8;3;8
+3;8;3;8;8;3;10;3;3;8;3;10;8;3;10;5;3;8;3;8
+9;4;9;3;4;9;3;9;10;4;9;3;10;9;3;9;9;4;9;3
+7;6;7;7;6;7;7;7;7;10;7;7;3;6;7;9;6;3;7;7
+7;6;7;7;6;7;7;7;7;6;7;7;3;6;7;9;6;3;7;7
+7;8;7;8;8;7;8;7;7;8;7;8;9;6;8;9;6;9;7;8
+9;4;9;4;4;9;4;9;9;4;9;4;4;9;4;9;9;4;9;4
+5;4;5;4;4;5;4;10;5;4;10;4;4;4;4;10;4;4;5;4
+5;8;5;8;8;5;8;5;5;8;5;8;8;4;8;3;4;8;5;8
+7;8;6;8;8;7;8;6;7;8;6;8;8;7;8;6;7;8;6;8
+9;6;8;6;6;9;6;8;9;10;8;7;6;9;8;8;9;6;8;6
+9;6;8;6;6;9;6;8;9;6;8;6;6;9;6;8;9;6;8;6
+5;6;5;3;6;5;3;5;10;6;5;3;6;10;3;3;5;6;5;3
+5;8;5;9;8;5;10;5;5;8;5;10;10;5;10;5;5;8;5;9
+7;8;7;9;8;7;9;7;7;8;7;9;8;6;9;9;6;8;7;9
+7;8;7;8;8;7;8;7;7;8;7;9;8;7;9;9;7;8;7;8
+9;6;9;6;6;9;6;9;9;6;9;6;6;9;5;7;9;6;9;6
+9;6;9;6;6;9;6;9;9;6;9;6;6;9;5;7;9;6;9;6
+9;6;9;6;6;9;6;10;10;6;10;6;6;9;5;10;9;6;9;6
+5;8;4;8;8;5;8;4;5;8;4;8;9;4;8;4;4;9;4;8
+3;4;4;5;4;3;5;4;3;4;4;5;4;4;6;4;4;4;4;5
+3;4;8;5;4;3;5;8;3;4;8;5;4;10;6;8;4;4;8;5
+9;4;9;4;4;9;4;9;9;10;9;4;10;9;4;9;9;5;9;4
+5;6;5;7;6;5;7;5;5;6;5;6;7;5;6;5;5;7;5;7
+7;6;6;7;6;7;7;6;7;6;6;6;7;7;6;6;7;7;6;7
+7;6;6;7;6;7;7;6;7;6;6;7;7;7;8;6;7;7;6;7

package/src/config/reel-strips-config/reels-BONUS.csv

@@ -0,0 +1,52 @@
+Reel 1;;;;Reel 2;;;;Reel 3;;;;Reel 4;;;;Reel 5;;;
+option 0;option 1;option 2;option 3;option 0;option 1;option 2;option 3;option 0;option 1;option 2;option 3;option 0;option 1;option 2;option 3;option 0;option 1;option 2;option 3
+9;8;9;8;8;9;8;9;5;8;9;8;6;9;8;9;9;8;9;8
+9;8;9;8;8;9;10;10;5;8;10;10;6;9;10;10;9;8;9;8
+9;8;8;9;8;9;0;8;10;10;8;9;10;10;9;8;9;8;8;9
+7;6;6;6;6;7;4;5;7;6;6;4;8;7;4;6;7;6;6;6
+7;6;6;6;6;7;4;5;7;6;6;4;8;7;4;6;7;6;6;6
+5;4;4;5;4;5;5;3;9;4;4;5;4;5;5;4;5;4;4;5
+5;4;4;4;4;5;6;3;9;4;4;6;4;5;6;4;5;4;4;4
+9;8;9;8;8;9;7;8;9;8;8;7;6;9;8;9;9;8;9;8
+1;0;1;1;0;1;8;4;7;0;3;1;2;1;1;1;1;0;1;1
+1;0;0;0;0;1;9;0;7;0;0;0;2;1;0;0;1;0;0;0
+7;6;7;6;6;7;6;7;7;6;7;6;8;7;6;7;7;6;7;6
+3;2;2;3;2;3;3;2;3;2;2;3;2;3;3;2;3;2;2;3
+9;8;8;9;8;9;0;9;5;8;9;9;6;9;9;8;9;8;8;9
+9;8;8;9;8;9;10;8;5;8;8;10;6;9;10;8;9;8;8;9
+3;2;3;2;2;3;2;1;3;2;1;2;0;3;2;3;3;2;3;2
+3;2;3;2;2;3;2;4;3;2;3;2;0;3;2;3;3;2;3;2
+7;6;7;7;6;7;7;7;10;10;7;7;10;10;7;7;7;6;7;7
+7;6;7;7;6;7;1;7;7;6;7;8;6;7;7;7;7;6;7;7
+9;8;9;8;8;9;8;9;9;8;9;8;8;9;8;9;9;8;9;8
+5;4;4;4;4;5;6;4;9;4;4;6;4;5;6;4;5;4;4;4
+5;4;5;4;4;5;4;5;9;4;5;4;4;5;4;5;5;4;5;4
+5;4;5;4;4;5;4;5;5;4;5;4;4;5;4;5;5;4;5;4
+3;2;3;3;2;3;3;1;3;2;1;3;2;3;3;3;3;2;3;3
+9;8;9;8;8;9;8;9;9;8;9;8;8;9;8;9;9;8;9;8
+9;8;9;8;8;9;8;9;9;8;9;8;8;9;8;9;9;8;9;8
+9;8;9;9;8;9;2;9;9;8;9;7;8;9;9;9;9;8;9;9
+5;4;5;5;4;5;5;6;10;10;5;5;10;10;5;5;5;4;5;5
+7;6;6;6;6;7;5;6;7;6;6;5;6;7;6;6;7;6;6;6
+7;6;7;6;6;7;5;10;7;6;10;5;6;7;6;10;7;6;7;6
+7;6;7;6;6;7;10;7;7;6;7;10;6;7;10;7;7;6;7;6
+3;2;2;2;2;3;6;2;5;2;2;6;0;3;5;2;3;2;2;2
+3;2;2;2;2;3;6;2;5;2;2;6;0;3;5;2;3;2;2;2
+9;8;9;8;8;9;8;9;9;8;9;8;8;9;8;9;9;8;9;8
+1;0;0;1;0;1;8;0;10;10;0;1;10;10;1;0;1;0;0;1
+5;4;5;4;4;5;4;6;5;4;5;4;4;5;4;5;5;4;5;4
+7;6;7;7;6;7;2;7;7;6;7;7;6;7;7;7;7;6;7;7
+9;8;9;9;8;9;9;8;9;8;8;9;8;9;9;9;9;8;9;9
+9;8;9;8;8;9;7;8;9;8;8;7;8;9;8;9;9;8;9;8
+5;4;5;5;4;5;7;10;3;4;10;2;4;5;2;10;5;4;5;5
+5;4;4;5;4;5;2;4;3;4;4;2;4;5;2;4;5;4;4;5
+1;0;1;0;0;1;9;1;1;0;1;0;2;1;0;1;1;0;1;0
+1;0;1;0;0;1;0;3;1;0;3;0;2;1;0;1;1;0;1;0
+7;6;6;6;6;7;6;6;7;6;6;6;6;7;6;6;7;6;6;6
+7;6;6;7;6;7;9;6;7;6;6;9;6;7;7;6;7;6;6;7
+9;8;8;8;8;9;8;9;9;8;9;8;8;9;8;8;9;8;8;8
+9;8;8;8;8;9;8;9;9;8;9;8;8;9;8;8;9;8;8;8
+3;2;3;3;2;3;3;3;10;10;3;3;10;10;3;3;3;2;3;3
+5;4;4;4;4;5;4;4;5;4;4;4;4;5;4;4;5;4;4;4
+7;6;7;6;6;7;6;7;1;6;7;6;8;7;6;7;7;6;7;6
+7;6;7;7;6;7;1;7;1;6;7;8;8;7;7;7;7;6;7;7

package/src/domain/game-round.types.ts

@@ -0,0 +1,10 @@
+export enum GameRoundType {
+  BASE = 'BASE',
+  BONUS = 'BONUS',
+}
+
+export type BonusProgress = {
+  completed: number;
+  remaining: number;
+  total: number;
+};

package/src/domain/mappers/reel-strips-config.mapper.ts

@@ -0,0 +1,16 @@
+import { Reel } from '../reel';
+import { ReelStripOption } from '../reel-strip-option';
+import { ReelStripsConfig } from '../reel-strips-config';
+
+export class ReelStripsConfigMapper {
+  public mapRawToDomain(rawReels: number[][][]): ReelStripsConfig {
+    const reels: Reel[] = rawReels.map((reelOptions) => {
+      const options: ReelStripOption[] = reelOptions.map(
+        (symbols) => new ReelStripOption(symbols),
+      );
+      return new Reel(options);
+    });
+
+    return new ReelStripsConfig(reels);
+  }
+}

package/src/domain/reel-strip-option.ts

@@ -0,0 +1,15 @@
+export class ReelStripOption {
+  constructor(public readonly symbols: number[]) {}
+
+  public getSymbols(): number[] {
+    return this.symbols;
+  }
+
+  public get length(): number {
+    return this.symbols.length;
+  }
+
+  public getSymbolAt(position: number): number {
+    return this.symbols[position % this.length];
+  }
+}

package/src/domain/reel-strips-config.ts

@@ -0,0 +1,21 @@
+import { Reel } from './reel';
+
+export class ReelStripsConfig {
+  constructor(public readonly reels: Reel[]) {}
+
+  public getReels(): Reel[] {
+    return this.reels;
+  }
+
+  public getReel(index: number): Reel {
+    return this.reels[index];
+  }
+
+  public get reelsCount(): number {
+    return this.reels.length;
+  }
+
+  public get optionsCount(): number {
+    return this.reels[0]?.numberOfOptions ?? 0;
+  }
+}

package/src/domain/reel.ts

@@ -0,0 +1,17 @@
+import { ReelStripOption } from './reel-strip-option';
+
+export class Reel {
+  constructor(public readonly options: ReelStripOption[]) {}
+
+  public getOptions(): ReelStripOption[] {
+    return this.options;
+  }
+
+  public getOption(index: number): ReelStripOption {
+    return this.options[index];
+  }
+
+  public get numberOfOptions(): number {
+    return this.options.length;
+  }
+}

package/src/domain/types/cheat-trigger-bonus-command.ts

@@ -0,0 +1,5 @@
+export type CheatTriggerBonusCommand = {
+  sessionId: string;
+  bonusType: string;
+  betAmount: number;
+};

package/src/domain/types/cheat-trigger-bonus-request.dto.ts

@@ -0,0 +1,5 @@
+export interface CheatTriggerBonusRequestDto {
+  sessionId: string;
+  bonusType: string;
+  betAmount: number;
+}

package/src/domain/types/cheat-update-bonus-meter-progress-command.ts

@@ -0,0 +1,6 @@
+
+export type CheatUpdateBonusMeterProgressCommand = {
+  sessionId: string;
+  bonusType: string;
+  progress: number;
+};

package/src/domain/types/cheat-update-bonus-meter-progress-request.dto.ts

@@ -0,0 +1,5 @@
+export interface CheatUpdateBonusMeterProgressRequestDto {
+  sessionId: string;
+  bonusType: string;
+  progress: number;
+}