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

package/dist/domain/types/game-spin-output.dto.d.ts

@@ -1,119 +0,0 @@
-export declare enum SpinType {
-    BASE_GAME_SPIN = "BASE_GAME_SPIN",
-    BONUS_GAME_1_SPIN = "BONUS_GAME_1_SPIN",
-    BONUS_GAME_2_SPIN = "BONUS_GAME_2_SPIN",
-    BONUS_GAME_3_SPIN = "BONUS_GAME_3_SPIN",
-    COLLECT_FEATURE_SPIN = "COLLECT_FEATURE_SPIN"
-}
-export declare enum PrizeType {
-    MULTIPLIER = "MULTIPLIER",
-    BONUS = "BONUS"
-}
-/** Triggered bonus */
-export interface TriggeredBonusDto {
-    bonusId: string;
-    bonusType: string;
-    betAmount: number;
-}
-/** Winning line */
-export interface WinningLineDto {
-    win: number;
-    ways: number;
-    symbol: number;
-    positions: number[][];
-    multiplier: number;
-    consecutiveReels: number;
-}
-/** Win result */
-export interface WinResultDto {
-    totalWin: number;
-    winningLines: WinningLineDto[];
-}
-/** Bonus meter */
-export interface BonusMeterDto {
-    progress: number;
-    symbolId: number;
-    threshold: number;
-    symbolName: string;
-}
-/** Public state */
-export interface PublicStateDto {
-    bonusMeters: Record<string, BonusMeterDto>;
-}
-/** Base Game Spin */
-export interface BaseGameSpinResultDto {
-    spinType: SpinType;
-    screen: number[][];
-    winResult: WinResultDto;
-    playerWinning: number;
-    nextSpinType: SpinType;
-    triggeredBonus?: TriggeredBonusDto;
-}
-/** Treasure Hunt (Bonus Game 1) */
-export interface TreasureHuntSpinResultDto {
-    spinType: SpinType;
-    selection: string;
-    multiplier: number;
-    multiplierCounts: Record<string, number>;
-    winningMultiplier: number | null;
-    winningCount: number;
-    totalMultiplier: number;
-}
-/** Free Spin (Bonus Game 2) */
-export interface FreeSpinResultDto {
-    spinType: SpinType;
-    screen: number[][];
-    playerWinning: number;
-    nextSpinType: SpinType;
-    multiplier: number;
-}
-/** Steering to the Fortune (Bonus Game 3) */
-export interface SteeringToTheFortuneResultDto {
-    spinType: SpinType;
-    playerWinning: number;
-    nextSpinType: SpinType;
-    prizeType: PrizeType;
-    prizeValue?: number | string;
-    totalMultiplier: number;
-    triggeredBonus?: TriggeredBonusDto;
-}
-/** Collect Feature Spin */
-export interface CollectFeatureSpinResultDto {
-    spinIndex?: number;
-    spinType: SpinType;
-    symbols?: string[];
-    slashed?: boolean[];
-    currentValues?: number;
-    currentMultipliers?: number;
-    totalValues?: number;
-    totalMultipliers?: number;
-    playerWinning: number;
-    totalWin?: number;
-    spinsLeft?: number;
-    nextSpinType: SpinType;
-}
-export interface BaseGameSpinResultWrapperDto {
-    result: BaseGameSpinResultDto;
-}
-export interface FreeSpinResultWrapperDto {
-    result: FreeSpinResultDto;
-}
-export interface TreasureHuntSpinResultWrapperDto {
-    result: TreasureHuntSpinResultDto;
-}
-export interface SteeringToTheFortuneResultWrapperDto {
-    result: SteeringToTheFortuneResultDto;
-}
-export interface CollectFeatureSpinResultWrapperDto {
-    result: CollectFeatureSpinResultDto;
-}
-/** Game Spin Output DTO */
-export interface GameSpinOutputDto {
-    sessionId: string;
-    balance: number;
-    betAmount: number;
-    balanceBeforeSpin: number;
-    outcome: BaseGameSpinResultWrapperDto;
-    publicState: PublicStateDto;
-    lastSpin: BaseGameSpinResultWrapperDto | FreeSpinResultWrapperDto | TreasureHuntSpinResultWrapperDto | SteeringToTheFortuneResultWrapperDto | CollectFeatureSpinResultWrapperDto | null;
-}

package/dist/domain/types/game-symbols.response.dto.d.ts

@@ -1,10 +0,0 @@
-export interface GameSymbol {
-    symbolId: number;
-    name: string;
-    multipliers: Record<'x3' | 'x4' | 'x5', number>;
-    isWild: boolean;
-    isScatter: boolean;
-}
-export declare class GameSymbolsResponseDto {
-    symbols: GameSymbol[];
-}

package/dist/domain/types/reel-strip-option.dto.d.ts

@@ -1,4 +0,0 @@
-export declare class ReelStripOptionDto {
-    symbols: number[];
-    constructor(symbols: number[]);
-}

package/dist/domain/types/reel-strips-config.dto.d.ts

@@ -1,5 +0,0 @@
-import { ReelDto } from './reel.dto';
-export declare class ReelStripsConfigDto {
-    reels: ReelDto[];
-    constructor(reels: ReelDto[]);
-}

package/dist/domain/types/reel.dto.d.ts

@@ -1,5 +0,0 @@
-import { ReelStripOptionDto } from './reel-strip-option.dto';
-export declare class ReelDto {
-    options: ReelStripOptionDto[];
-    constructor(options: ReelStripOptionDto[]);
-}

package/dist/domain/types/start-bonus-round-command.d.ts

@@ -1,8 +0,0 @@
-export type StartBonusRoundCommand = {
-    sessionId: string;
-    bonusId: string;
-    bonusType: string;
-    betAmount: number;
-    gameCode: string;
-    gameVersion: string;
-};

package/dist/domain/types/start-bonus-round-input.dto.d.ts

@@ -1,10 +0,0 @@
-export interface StartBonusRoundInputDto {
-    sessionId: string;
-    bonusType: string;
-    betAmount: number;
-    gameCode: string;
-    gameVersion: string;
-    lines?: number;
-    creditsPerLine?: number;
-    bonusId: string;
-}

package/dist/game-engine.interface.d.ts

@@ -1,41 +0,0 @@
-import { RngClientConfig } from '@omnitronix/rng-client-core';
-export type GameEngineMetricsHandlers = RngClientConfig['metrics']['handlers'];
-export interface GameEngineConfig {
-    metrics?: {
-        handlers: GameEngineMetricsHandlers;
-    };
-}
-export interface GameEngineInfo {
-    gameCode: string;
-    version: string;
-    rtp: number;
-    gameType: string;
-    gameName: string;
-    provider: string;
-}
-export interface RngOutcomeRecord {
-    result: number;
-    seed: number;
-    min: number;
-    max: number;
-}
-export type RngOutcome = {
-    [actionId: string]: RngOutcomeRecord;
-};
-export interface CommandProcessingResult<TPublicState = any, TPrivateState = any, TOutcome = any> {
-    success: boolean;
-    publicState: TPublicState;
-    privateState: TPrivateState;
-    outcome?: TOutcome;
-    message?: string;
-    rngOutcome?: RngOutcome;
-}
-export interface GameActionCommand<TPayload = any> {
-    id: string;
-    type: string;
-    payload?: TPayload;
-}
-export interface GameEngine<TPublicState = any, TPrivateState = any, TOutcome = any> {
-    processCommand(publicState: TPublicState, privateState: TPrivateState, command: GameActionCommand): Promise<CommandProcessingResult<TPublicState, TPrivateState, TOutcome>>;
-    getGameEngineInfo(): GameEngineInfo;
-}

package/dist/helpers/generate-hash.d.ts

@@ -1 +0,0 @@
-export declare const generateHash: (input: string) => string;

package/dist/helpers/number-helper.d.ts

@@ -1,23 +0,0 @@
-export declare class NumberHelper {
-    /**
-     * Safely formats a number to the specified decimal places,
-     * minimizing floating-point issues.
-     */
-    static toFixedNumber(value: number, decimals: number): number;
-    /**
-     * Safely adds two numbers and formats result.
-     */
-    static safeSum(a: number, b: number, decimals: number): number;
-    /**
-     * Safely multiplies two numbers and formats result.
-     */
-    static safeMultiply(a: number, b: number, decimals: number): number;
-    /**
-     * Clamps a number between min and max.
-     */
-    static clamp(value: number, min: number, max: number): number;
-    /**
-     * Safely divides two numbers.
-     */
-    static safeDivide(a: number, b: number, decimals: number): number;
-}

package/dist/helpers/optional-boolean-mapper.d.ts

@@ -1 +0,0 @@
-export declare const optionalBooleanMapper: Map<string, boolean>;

package/dist/helpers/uuid-helper.d.ts

@@ -1,3 +0,0 @@
-export declare class UuidHelper {
-    static generateUuid(): string;
-}

package/dist/helpers/validation-helper.d.ts

@@ -1,14 +0,0 @@
-import { ValidationError } from 'class-validator';
-export declare class ValidationHelper {
-    static readonly validationOptions: {
-        whitelist: boolean;
-        forbidNonWhitelisted: boolean;
-    };
-    static readonly validationOptionsWithoutForbidden: {
-        whitelist: boolean;
-        forbidNonWhitelisted: boolean;
-    };
-    static validate<T extends object>(dto: T): Promise<ValidationError[]>;
-    static validateWithoutForbidden<T extends object>(dto: T): Promise<ValidationError[]>;
-    static isPlainObject(value: unknown): value is Record<string, any>;
-}

package/dist/index.d.ts

@@ -1,2 +0,0 @@
-import 'reflect-metadata';
-export { BonnysFortuneV1GameEngine } from './bonnys-fortune-v1.game-engine';

package/dist/logger/logger.d.ts

@@ -1,22 +0,0 @@
-type LogFormat = 'json' | 'pretty';
-export declare class Logger {
-    private readonly logger;
-    private context;
-    constructor(context: string, logFormat?: LogFormat);
-    private detectLogFormat;
-    private createWinstonLogger;
-    private getLogFormat;
-    private selectFormat;
-    private getJsonFormat;
-    private getPrettyFormat;
-    private safeStringify;
-    private getTransports;
-    log(message: any, { level, ...rest }?: {
-        level?: string;
-    } & Record<string, any>): void;
-    error(message: any, ...optionalParams: any[]): void;
-    warn(message: any, ...optionalParams: any[]): void;
-    debug(message: any, ...optionalParams: any[]): void;
-    verbose(message: any, ...optionalParams: any[]): void;
-}
-export {};

package/dist/logic/bonnys-fortune.game-logic.d.ts

@@ -1,32 +0,0 @@
-import { BonnysFortuneBaseGameSpinResult, BonnysFortunePrivateState, BonnysFortunePublicState, CheatTriggerBonusResult, CheatUpdateBonusMeterProgressResult, GetSymbolsResult, SpinResultResponse, StartBonusRoundResult } from './bonnys-fortune.types';
-import { BonnysFortuneGameLogicConfigInterface, BonnysFortuneSessionStateInterface } from './game-logic-config.interface';
-import { CheatTriggerBonusRequestDto } from '../domain/types/cheat-trigger-bonus-request.dto';
-import { CheatUpdateBonusMeterProgressRequestDto } from '../domain/types/cheat-update-bonus-meter-progress-request.dto';
-import { GameActionCommand } from '../game-engine.interface';
-import { GameSpinInputDto } from '../domain/types/game-spin-input.dto';
-import { ReelStripsConfig } from '../domain/reel-strips-config';
-import { RngService } from '../rng/rng-service';
-import { StartBonusRoundInputDto } from '../domain/types/start-bonus-round-input.dto';
-export declare class BonnysFortuneGameLogic {
-    private readonly rngService;
-    constructor(rngService: RngService);
-    initSessionState(gameLogicConfig: BonnysFortuneGameLogicConfigInterface, reelStripsConfig: ReelStripsConfig, gameConfig: {
-        betAmountThresholds: number[];
-        defaultBetAmount: number;
-    }, commandId: string): Promise<BonnysFortuneSessionStateInterface>;
-    spin(params: GameSpinInputDto, publicState: BonnysFortunePublicState, privateState: BonnysFortunePrivateState, gameLogicConfig: BonnysFortuneGameLogicConfigInterface, reelStripsConfig: ReelStripsConfig, commandId: string): Promise<SpinResultResponse<BonnysFortuneBaseGameSpinResult>>;
-    startBonusRound(params: StartBonusRoundInputDto, publicState: BonnysFortunePublicState, privateState: BonnysFortunePrivateState, gameLogicConfig: BonnysFortuneGameLogicConfigInterface, reelStripsConfig: ReelStripsConfig, commandId: string): Promise<StartBonusRoundResult>;
-    private drawBonusMeters;
-    updateSessionState(publicState: BonnysFortunePublicState, privateState: BonnysFortunePrivateState, gameLogicConfig: BonnysFortuneGameLogicConfigInterface, command: GameActionCommand<{
-        bonusMeters: {
-            redraw: string[];
-        };
-    }>): Promise<BonnysFortuneSessionStateInterface>;
-    cheatTriggerBonus(publicState: BonnysFortunePublicState, privateState: BonnysFortunePrivateState, params: CheatTriggerBonusRequestDto): CheatTriggerBonusResult;
-    cheatUpdateBonusMeterProgress(publicState: BonnysFortunePublicState, privateState: BonnysFortunePrivateState, params: CheatUpdateBonusMeterProgressRequestDto, gameLogicConfig: BonnysFortuneGameLogicConfigInterface): CheatUpdateBonusMeterProgressResult;
-    getSymbols(gameLogicConfig: BonnysFortuneGameLogicConfigInterface): GetSymbolsResult;
-    private shouldRedrawMeter;
-    private requiresMeterUpdate;
-    private getMeterLevel;
-    private randomThreshold;
-}

package/dist/logic/bonnys-fortune.spin-generator.d.ts

@@ -1,19 +0,0 @@
-import { BonnysFortuneGameLogicConfigInterface } from './game-logic-config.interface';
-import { ReelStripsConfig } from '../domain/reel-strips-config';
-import { RngService } from '../rng/rng-service';
-export declare class BonnysFortuneSpinGenerator {
-    private readonly rngService;
-    constructor(rngService: RngService);
-    generateScreenWithLayout(reelStripsConfig: ReelStripsConfig, layout: {
-        reels: number;
-        rows: number;
-    }, optionWeights: number[], commandId: string, actionId: string): Promise<number[][]>;
-    generateBaseScreen(config: BonnysFortuneGameLogicConfigInterface, reelStripsConfig: ReelStripsConfig, commandId: string, actionId: string): Promise<number[][]>;
-    private selectReelOption;
-    private drawReelColumn;
-    applyBonusSymbols(screen: number[][], config: BonnysFortuneGameLogicConfigInterface, commandId: string, actionId: string): Promise<number[][]>;
-    private placeHSymbols;
-    private placeScatterSymbols;
-    private placeSymbolRandomlyOnReel;
-    private getRandomWeightedIndex;
-}

package/dist/logic/bonnys-fortune.types.d.ts

@@ -1,170 +0,0 @@
-export interface WinLine {
-    symbol: number;
-    consecutiveReels: number;
-    ways: number;
-    multiplier: number;
-    win: number;
-    positions: [number, number][];
-}
-export interface MeterState {
-    symbolName: string;
-    symbolId: number;
-    threshold: number;
-    progress: number;
-    level: number;
-}
-export type MetersState = Record<string, MeterState>;
-export interface BonnysFortunePublicState {
-    currentBetAmount: number;
-    bonusMeters: MetersState;
-}
-export interface BonnysFortunePrivateState {
-    screen?: number[][];
-    nextSpinType: SpinType;
-    pendingBonuses: BonusTrigger[];
-    activeBonus?: BonusTrigger;
-    bonusMetersByAmount: Record<number, MetersState>;
-}
-export interface BonusTrigger {
-    bonusId: string;
-    bonusType: string;
-    betAmount: number;
-}
-export interface SpinResult {
-    spinType: string;
-    playerWinning: number;
-    nextSpinType: SpinType | string;
-}
-export interface SpinResultResponse<T extends SpinResult> {
-    result: T;
-    publicState: BonnysFortunePublicState;
-    privateState: BonnysFortunePrivateState;
-}
-export interface BonnysFortuneBaseGameSpinResult extends SpinResult {
-    spinType: SpinType.BASE_GAME_SPIN;
-    screen: number[][];
-    winResult: {
-        totalWin: number;
-        winningLines: WinLine[];
-    };
-    triggeredBonus?: BonusTrigger;
-}
-export interface TreasureHuntSpinResult extends SpinResult {
-    spinType: SpinType;
-    selection: string;
-    multiplier: number;
-    multiplierCounts: Record<string, number>;
-    winningMultiplier: number | null;
-    winningCount: number;
-    totalMultiplier: number;
-}
-export interface FreeSpinResult {
-    spinType: SpinType.BONUS_GAME_2_SPIN;
-    screen: number[][];
-    winResult: {
-        totalWin: number;
-        winningLines: WinLine[];
-    };
-    playerWinning: number;
-    nextSpinType: SpinType;
-    multiplier: number;
-}
-export interface SteeringToTheFortuneResult {
-    spinType: SpinType;
-    playerWinning: number;
-    nextSpinType: SpinType;
-    prizeType: string;
-    prizeValue: number | string;
-    totalMultiplier: number;
-    triggeredBonus?: BonusTrigger;
-}
-export interface CollectFeatureSpinResult {
-    spinIndex: number;
-    spinType: SpinType;
-    symbols: string[];
-    slashed: boolean[];
-    currentValues: number;
-    currentMultipliers: number;
-    totalValues: number;
-    totalMultipliers: number;
-    playerWinning: number;
-    totalWin: number;
-    spinsLeft: number;
-    nextSpinType: SpinType;
-}
-export interface BonusRoundResult<TSpin extends SpinResult> {
-    results: SpinResultResponse<TSpin>[];
-    publicState: BonnysFortunePublicState;
-    privateState: BonnysFortunePrivateState;
-}
-export interface BonusRoundResultWithActiveBonus<TSpin extends SpinResult> extends BonusRoundResult<TSpin> {
-    activeBonus: BonusTrigger;
-}
-export type BonnysFortuneGameLogicSpinResult = SpinResultResponse<BonnysFortuneBaseGameSpinResult> | SpinResultResponse<FreeSpinResult> | SpinResultResponse<TreasureHuntSpinResult> | SpinResultResponse<SteeringToTheFortuneResult> | SpinResultResponse<CollectFeatureSpinResult>;
-export type BonnysFortuneBonusGameLogicSpinResult = BonusRoundResult<FreeSpinResult> | BonusRoundResult<TreasureHuntSpinResult> | BonusRoundResult<SteeringToTheFortuneResult> | BonusRoundResult<CollectFeatureSpinResult>;
-export type StartBonusRoundResult = BonusRoundResultWithActiveBonus<FreeSpinResult> | BonusRoundResultWithActiveBonus<TreasureHuntSpinResult> | BonusRoundResultWithActiveBonus<SteeringToTheFortuneResult> | BonusRoundResultWithActiveBonus<CollectFeatureSpinResult>;
-export declare enum SpinType {
-    BASE_GAME_SPIN = "BASE_GAME_SPIN",
-    BONUS_GAME_1_SPIN = "BONUS_GAME_1_SPIN",
-    BONUS_GAME_2_SPIN = "BONUS_GAME_2_SPIN",
-    BONUS_GAME_3_SPIN = "BONUS_GAME_3_SPIN",
-    COLLECT_FEATURE_SPIN = "COLLECT_FEATURE_SPIN"
-}
-export declare enum PrizeType {
-    MULTIPLIER = "MULTIPLIER",
-    BONUS = "BONUS"
-}
-export interface ExtractedConfigData {
-    baseMin: number;
-    baseMax: number;
-    WILD: number;
-    reels: number;
-    rows: number;
-    minLength: number;
-    maxLength: number;
-    multipliers: Map<number, Record<string, number>>;
-}
-export type SymbolsCountMatrix = number[][];
-export type SymbolPositionsMatrix = boolean[][][];
-export interface SymbolAnalysisResult {
-    symbolsCount: SymbolsCountMatrix;
-    symbolPositions: SymbolPositionsMatrix;
-}
-export interface FindWinningLinesParams {
-    symbolsCount: SymbolsCountMatrix;
-    symbolPositions: SymbolPositionsMatrix;
-    configData: ExtractedConfigData;
-    betStake: number;
-    currentMultiplier: number;
-}
-export interface CalculateWinsResult {
-    totalWin: number;
-    winningLines: WinLine[];
-}
-export interface CheatTriggerBonusOutcome {
-    triggeredBonus: BonusTrigger;
-}
-export interface CheatUpdateBonusMeterProgressOutcome {
-    updatedMeter: MeterState;
-}
-export interface CheatTriggerBonusResult {
-    publicState: BonnysFortunePublicState;
-    privateState: BonnysFortunePrivateState;
-    outcome: CheatTriggerBonusOutcome;
-}
-export interface CheatUpdateBonusMeterProgressResult {
-    publicState: BonnysFortunePublicState;
-    privateState: BonnysFortunePrivateState;
-    outcome: CheatUpdateBonusMeterProgressOutcome;
-}
-export interface GetSymbolsOutcome {
-    symbolId: number;
-    name: string;
-    multipliers: Record<'x3' | 'x4' | 'x5', number>;
-    isWild: boolean | undefined;
-    isScatter: boolean | undefined;
-}
-export interface GetSymbolsResult {
-    symbols: GetSymbolsOutcome[];
-}
-export type BonnysFortuneOutcome = BonnysFortuneGameLogicSpinResult | BonnysFortuneBonusGameLogicSpinResult | SymbolsCountMatrix | CheatTriggerBonusOutcome | CheatUpdateBonusMeterProgressOutcome | GetSymbolsOutcome | null;

package/dist/logic/bonnys-fortune.win-calculator.d.ts

@@ -1,10 +0,0 @@
-import { CalculateWinsResult, SpinType } from './bonnys-fortune.types';
-import { BonnysFortuneGameLogicConfigInterface } from './game-logic-config.interface';
-export declare class BonnysFortuneWinCalculator {
-    static calculateWins(screen: number[][], config: BonnysFortuneGameLogicConfigInterface, betStake: number, currentMultiplier: number, spinType: SpinType, spinTypeIndex?: number): CalculateWinsResult;
-    private static isEligibleSpin;
-    private static buildConfigData;
-    private static analyzeScreenSymbols;
-    private static markWildPositions;
-    private static findWinningLines;
-}