@omnitronix/bonnys-fortune-game-engine 1.2.0 → 1.2.2

package/src/rng/rng-service.ts

@@ -1,130 +0,0 @@
-import { RngOutcome, RngOutcomeRecord } from '../game-engine.interface';
-
-import { IRngClient } from './rng-client.interface';
-
-export class RngService {
-  private rngOutcomes: {
-    [commandId: string]: RngOutcome;
-  } = {};
-
-  constructor(private readonly rngClient: IRngClient) {}
-
-  public registerCommand(commandId: string): void {
-    if (!this.rngOutcomes[commandId]) {
-      this.rngOutcomes[commandId] = {};
-    }
-  }
-
-  public async getSingleNumber(
-    min: number,
-    max: number,
-    commandId: string,
-    actionId: string,
-  ): Promise<{ value: number; seed: number }> {
-    const existingSeed = this.getSeedForCommand(commandId, actionId);
-
-    if (existingSeed) {
-      const result = await this.rngClient.getSingleNumber(
-        existingSeed.min,
-        existingSeed.max,
-        existingSeed.seed,
-      );
-      return result;
-    } else {
-      const result = await this.rngClient.getSingleNumber(min, max);
-      this.storeSeedForCommand(
-        commandId,
-        actionId,
-        result.value,
-        result.seed,
-        min,
-        max,
-      );
-      return result;
-    }
-  }
-
-  public async getBatchNumbers(
-    min: number,
-    max: number,
-    count: number,
-    commandId: string,
-    actionId: string,
-  ): Promise<{ value: number; seed: number }[]> {
-    const results: { value: number; seed: number }[] = [];
-
-    for (let i = 0; i < count; i++) {
-      const result = await this.getSingleNumber(
-        min,
-        max,
-        commandId,
-        `${actionId}_${i}`,
-      );
-      results.push(result);
-    }
-
-    return results;
-  }
-
-  private getSeedForCommand(
-    commandId: string,
-    actionId: string,
-  ): RngOutcomeRecord | null {
-    try {
-      const commandSeeds = this.rngOutcomes[commandId];
-      if (!commandSeeds) {
-        return null;
-      }
-
-      const actionSeed = commandSeeds[actionId];
-      if (!actionSeed) {
-        return null;
-      }
-
-      return actionSeed;
-    } catch (error) {
-      return null;
-    }
-  }
-
-  private storeSeedForCommand(
-    commandId: string,
-    actionId: string,
-    result: number,
-    seed: number,
-    min: number,
-    max: number,
-  ): void {
-    this.registerCommand(commandId);
-    this.rngOutcomes[commandId][actionId] = { result, seed, min, max };
-  }
-
-  public getRngOutcomeForCommand(commandId: string): RngOutcome {
-    return this.rngOutcomes[commandId] || {};
-  }
-
-  public getAllRngOutcome(): {
-    [commandId: string]: RngOutcome;
-  } {
-    return { ...this.rngOutcomes };
-  }
-
-  public removeCommand(commandId: string): void {
-    delete this.rngOutcomes[commandId];
-  }
-
-  public clearAllRngOutcome(): void {
-    this.rngOutcomes = {};
-  }
-
-  public hasCommandRngOutcome(commandId: string): boolean {
-    const commandSeeds = this.rngOutcomes[commandId];
-    return commandSeeds ? Object.keys(commandSeeds).length > 0 : false;
-  }
-
-  public getRngOutcomeCountForCommand(commandId: string): number {
-    const commandSeeds = this.rngOutcomes[commandId];
-    if (!commandSeeds) return 0;
-    return Object.keys(commandSeeds).length;
-  }
-}

package/src/validation/abstract-game-logic-config.validator.ts

@@ -1,20 +0,0 @@
-import { ValidationError } from 'class-validator';
-import { ValidationHelper } from '../helpers/validation-helper';
-import { plainToInstance } from 'class-transformer';
-
-export abstract class AbstractGameLogicConfigValidator<T extends object> {
-  protected abstract getDtoClass(): new () => T;
-
-  public async validate(config: unknown): Promise<T> {
-    const dto = plainToInstance(this.getDtoClass(), config);
-
-    const errors: ValidationError[] = await ValidationHelper.validate<T>(dto);
-
-    if (errors.length > 0) {
-      console.error(JSON.stringify(errors, null, 2));
-      throw new Error('Game logic config validation failed');
-    }
-
-    return dto;
-  }
-}

package/src/validation/bonnys-fortune/bonnys-fortune-config.dto.ts

@@ -1,371 +0,0 @@
-import { Type } from 'class-transformer';
-import {
-  IsArray,
-  IsBoolean,
-  IsInt,
-  IsObject,
-  IsOptional,
-  IsString,
-  ValidateIf,
-  ValidateNested,
-} from 'class-validator';
-
-// --- SymbolMultiplier ---
-
-export class SymbolMultipliersDto {
-  @IsInt()
-  public symbolId: number;
-
-  @IsString()
-  public name: string;
-
-  @IsObject()
-  public multipliers: Record<'x3' | 'x4' | 'x5', number>;
-
-  @IsBoolean()
-  public isWild: boolean;
-
-  @IsBoolean()
-  public isScatter: boolean;
-}
-
-// --- SymbolDefinitions ---
-
-export class CollectFeatureSymbolsDto {
-  @IsObject()
-  public multipliers: Record<string, number>;
-
-  @IsObject()
-  public values: Record<string, number>;
-}
-
-export class SymbolRangeDto {
-  @IsInt()
-  public minIndex: number;
-
-  @IsInt()
-  public maxIndex: number;
-}
-
-export class SymbolDefinitionsDto {
-  @ValidateNested()
-  @Type(() => SymbolRangeDto)
-  public baseSymbols: SymbolRangeDto;
-
-  @IsObject()
-  public specialSymbols: Record<string, number>;
-
-  @ValidateNested()
-  @Type(() => CollectFeatureSymbolsDto)
-  public collectFeatureSymbols: CollectFeatureSymbolsDto;
-}
-
-// --- BaseGameConfig ---
-
-export class LayoutDto {
-  @IsInt()
-  public rows: number;
-
-  @IsInt()
-  public reels: number;
-}
-
-export class WinConfigDto {
-  @IsInt()
-  public minLength: number;
-
-  @IsInt()
-  public maxLength: number;
-}
-
-// --- ReelsOptions ---
-
-export class ReelsOptionsDto {
-  @IsInt()
-  public numberOfOptions: number;
-
-  @IsArray()
-  @IsInt({ each: true })
-  public optionWeights: number[];
-}
-
-export class BaseGameConfigDto {
-  @ValidateNested()
-  @Type(() => LayoutDto)
-  public layout: LayoutDto;
-
-  @ValidateNested()
-  @Type(() => WinConfigDto)
-  public winConfig: WinConfigDto;
-
-  @IsInt()
-  public baseBet: number;
-
-  @ValidateNested()
-  @Type(() => ReelsOptionsDto)
-  public reelsOptions: ReelsOptionsDto;
-}
-
-// --- BonusGameMeter ---
-
-export class BonusGameMeterDto {
-  @IsString()
-  public symbol: string;
-
-  @IsInt()
-  public min: number;
-
-  @IsInt()
-  public max: number;
-}
-
-// --- BaseGame ---
-
-export class BaseGameDto {
-  @IsArray()
-  @ValidateNested({ each: true })
-  @Type(() => SymbolMultipliersDto)
-  public symbolMultipliers: SymbolMultipliersDto[];
-
-  @ValidateNested()
-  @Type(() => SymbolDefinitionsDto)
-  public symbolDefinitions: SymbolDefinitionsDto;
-
-  @ValidateNested()
-  @Type(() => BaseGameConfigDto)
-  public baseGameConfig: BaseGameConfigDto;
-
-  @IsObject()
-  public paidHSymbolWeights: Record<string, number>;
-
-  @IsObject()
-  public paidHSymbolReelWeights: Record<string, [number, number]>;
-
-  @IsObject()
-  public paidScatterReelWeights: Record<string, [number, number]>;
-
-  @IsObject()
-  public bonusGameMeters: Record<string, BonusGameMeterDto>;
-}
-
-// --- BonusGame Specific Config DTOs ---
-
-export class TreasureHuntBonusConfigDto {
-  @IsInt()
-  public symbolsCount: number;
-
-  @IsInt()
-  public stepsCount: number;
-
-  @IsObject()
-  public jackpotMultipliers: Record<
-    'mini' | 'minor' | 'major' | 'grand',
-    number
-  >;
-
-  @IsObject()
-  public jackpotStartCounts: Record<
-    'mini' | 'minor' | 'major' | 'grand',
-    number
-  >;
-
-  @IsObject()
-  public jackpotScreenCounts: Record<
-    'mini' | 'minor' | 'major' | 'grand',
-    number
-  >;
-
-  @IsObject()
-  public winningWeights: Record<
-    'none' | 'mini' | 'minor' | 'major' | 'grand',
-    number
-  >;
-}
-
-// --- BonusGameEvaluationConfigDto ---
-
-export class BonusGameEvaluationConfigDto {
-  @IsString()
-  public defaultConfig: string;
-
-  @IsArray()
-  @IsString({ each: true })
-  @IsOptional()
-  public alternativeConfigs?: string[];
-
-  @IsOptional()
-  @IsObject()
-  public selectionWeights?: Record<string, number>;
-}
-
-// --- BonusGameDto (discriminated union with validation) ---
-
-export class BaseBonusGameDto {
-  @IsString()
-  public type: string;
-
-  @IsString()
-  public potMeter: string;
-
-  @ValidateNested()
-  @Type(() => BonusGameEvaluationConfigDto)
-  public evaluationConfig: BonusGameEvaluationConfigDto;
-}
-
-export class TreasureHuntBonusGameDto extends BaseBonusGameDto {
-  @ValidateNested()
-  @Type(() => TreasureHuntBonusConfigDto)
-  public config: TreasureHuntBonusConfigDto;
-}
-
-export class FreeSpinTypeDto {
-  @ValidateNested()
-  @Type(() => LayoutDto)
-  public layout: LayoutDto;
-
-  @IsInt()
-  public spins: number;
-
-  @IsInt()
-  public multiplier: number;
-
-  @IsInt()
-  public weight: number;
-
-  @IsArray()
-  @IsInt({ each: true })
-  public reelsOptionsWeights: number[];
-}
-
-export class FreeSpinBonusConfigDto {
-  @IsArray()
-  @ValidateNested({ each: true })
-  @Type(() => FreeSpinTypeDto)
-  public spinTypes: FreeSpinTypeDto[];
-}
-
-export class FreeSpinBonusGameDto extends BaseBonusGameDto {
-  @ValidateNested()
-  @Type(() => FreeSpinBonusConfigDto)
-  public config: FreeSpinBonusConfigDto;
-}
-
-export class SteeringToTheFortuneWheelResultDto {
-  @IsString()
-  public type: 'MULTIPLIER' | 'BONUS';
-
-  @IsOptional()
-  @IsInt()
-  public value?: number;
-
-  @IsOptional()
-  @IsString()
-  public bonusType?: string;
-
-  @IsInt()
-  public weight: number;
-}
-
-export class SteeringToTheFortuneBonusConfigDto {
-  @IsArray()
-  @ValidateNested({ each: true })
-  @Type(() => SteeringToTheFortuneWheelResultDto)
-  public wheelResults: SteeringToTheFortuneWheelResultDto[];
-}
-
-export class SteeringToTheFortuneBonusGameDto extends BaseBonusGameDto {
-  @ValidateNested()
-  @Type(() => SteeringToTheFortuneBonusConfigDto)
-  public config: SteeringToTheFortuneBonusConfigDto;
-}
-
-export class BonusGamesDto {
-  @ValidateNested()
-  @Type(() => TreasureHuntBonusGameDto)
-  @ValidateIf((o) => o['bonusGame1'] !== undefined)
-  public bonusGame1?: TreasureHuntBonusGameDto;
-
-  @ValidateNested()
-  @Type(() => FreeSpinBonusGameDto)
-  @ValidateIf((o) => o['bonusGame2'] !== undefined)
-  public bonusGame2?: FreeSpinBonusGameDto;
-
-  @ValidateNested()
-  @Type(() => SteeringToTheFortuneBonusGameDto)
-  @ValidateIf((o) => o['bonusGame3'] !== undefined)
-  public bonusGame3?: SteeringToTheFortuneBonusGameDto;
-}
-
-// --- ScatterSymbolDto ---
-
-export class ScatterSymbolDto {
-  @IsString()
-  public symbolId: string;
-
-  @IsInt()
-  public value: number;
-
-  @IsInt()
-  public weight: number;
-}
-
-// --- ScatterGameConfigDto ---
-
-export class ScatterCheckpointDto {
-  @IsInt()
-  public spin: number;
-
-  @IsInt()
-  public multiMinValue: number;
-
-  @IsInt()
-  public valueMinValue: number;
-}
-
-export class ScatterGameConfigDto {
-  @IsInt()
-  public scatterMinNumber: number;
-
-  @IsInt()
-  public scatterSpins: number;
-
-  @IsArray()
-  @ValidateNested({ each: true })
-  @Type(() => ScatterCheckpointDto)
-  public scatterCheckpoints: ScatterCheckpointDto[];
-
-  @IsArray()
-  @ValidateNested({ each: true })
-  @Type(() => ScatterSymbolDto)
-  public scatterSymbols: ScatterSymbolDto[];
-
-  @IsArray()
-  @IsObject({ each: true })
-  public scatterSymbolSpins: Record<string, number>[];
-
-  @IsArray()
-  @IsObject({ each: true })
-  public scatterSymbolSlash: Record<string, number>[];
-}
-
-export class ScatterGameConfigWrapperDto {
-  @ValidateNested()
-  @Type(() => ScatterGameConfigDto)
-  public config: ScatterGameConfigDto;
-}
-
-// --- Root Config DTO ---
-
-export class BonnysFortuneGameLogicConfigDto {
-  @ValidateNested()
-  @Type(() => BaseGameDto)
-  public baseGame: BaseGameDto;
-
-  @ValidateNested()
-  @Type(() => BonusGamesDto)
-  public bonusGames: BonusGamesDto;
-
-  @ValidateNested()
-  @Type(() => ScatterGameConfigWrapperDto)
-  public scatterGame: ScatterGameConfigWrapperDto;
-}

package/src/validation/bonnys-fortune/bonnys-fortune-config.validator.ts

@@ -1,8 +0,0 @@
-import { AbstractGameLogicConfigValidator } from '../abstract-game-logic-config.validator';
-import { BonnysFortuneGameLogicConfigDto } from './bonnys-fortune-config.dto';
-
-export class BonnysFortuneGameLogicConfigValidator extends AbstractGameLogicConfigValidator<BonnysFortuneGameLogicConfigDto> {
-  protected getDtoClass(): new () => BonnysFortuneGameLogicConfigDto {
-    return BonnysFortuneGameLogicConfigDto;
-  }
-}

package/src/validation/custom-decorators/IsNestedIntArray.ts

@@ -1,29 +0,0 @@
-import {
-  registerDecorator,
-  ValidationArguments,
-  ValidationOptions,
-} from 'class-validator';
-
-export function IsNestedIntArray(validationOptions?: ValidationOptions) {
-  return function (object: object, propertyName: string) {
-    registerDecorator({
-      name: 'isNestedIntArray',
-      target: object.constructor,
-      propertyName: propertyName,
-      options: validationOptions,
-      validator: {
-        validate(value: any) {
-          if (!Array.isArray(value)) return false;
-          return value.every(
-            (inner) =>
-              Array.isArray(inner) &&
-              inner.every((num) => Number.isInteger(num)),
-          );
-        },
-        defaultMessage(args: ValidationArguments) {
-          return `${args.property} must be a nested array of integers`;
-        },
-      },
-    });
-  };
-}

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

@@ -1,28 +0,0 @@
-export interface GameLogicConfigValidatorInterface<T = any> {
-  validate(config: unknown): Promise<T>;
-}
-
-export class GameLogicConfigValidationService {
-  private validators: Map<string, GameLogicConfigValidatorInterface> =
-    new Map();
-
-  public register<T>(
-    gameId: string,
-    validator: GameLogicConfigValidatorInterface<T>,
-  ): void {
-    this.validators.set(gameId, validator);
-  }
-
-  public async validate<T extends object>(
-    gameId: string,
-    config: unknown,
-  ): Promise<T> {
-    const validator = this.validators.get(gameId);
-
-    if (!validator) {
-      throw new Error(`No validator registered for gameId: ${gameId}`);
-    }
-
-    return validator.validate(config);
-  }
-}

package/src/validation/reel-strips-config-validation.service.ts

@@ -1,29 +0,0 @@
-import { ReelDto } from '../config/reel-strips-config/reel.dto';
-import { ReelStripOptionDto } from '../config/reel-strips-config/reel-strip-option.dto';
-import { ReelStripsConfigDto } from '../config/reel-strips-config/reel-strips-config.dto';
-import { ValidationHelper } from '../helpers/validation-helper';
-
-export class ReelStripsConfigValidationService {
-  private mapRawToDto(raw: number[][][]): ReelStripsConfigDto {
-    const reels = raw.map((reel) => {
-      const options = reel.map(
-        (optionSymbols) => new ReelStripOptionDto(optionSymbols),
-      );
-      return new ReelDto(options);
-    });
-    return new ReelStripsConfigDto(reels);
-  }
-
-  public async validate(rawReels: number[][][]): Promise<ReelStripsConfigDto> {
-    const dto = this.mapRawToDto(rawReels);
-    const errors = await ValidationHelper.validate(dto);
-
-    if (errors.length > 0) {
-      throw new Error(
-        'Reel strips validation failed: ' + JSON.stringify(errors, null, 2),
-      );
-    }
-
-    return dto;
-  }
-}