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

package/dist/__tests__/rtp-simulation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtp-simulation.test.js","sourceRoot":"","sources":["../../src/__tests__/rtp-simulation.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/state-transitions.test.js

@@ -0,0 +1,307 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * State Transition Tests — Bonnys Fortune
+ *
+ * Validates the state machine that governs game flow:
+ *   - INIT_SESSION_STATE → BASE_GAME_SPIN
+ *   - BASE_GAME_SPIN → BASE_GAME_SPIN (no trigger)
+ *   - BASE_GAME_SPIN → BONUS_GAME_1_SPIN (treasure hunt via debug)
+ *   - BASE_GAME_SPIN → BONUS_GAME_2_SPIN (free spins via debug)
+ *   - BASE_GAME_SPIN → BONUS_GAME_3_SPIN (steering fortune via debug)
+ *   - BASE_GAME_SPIN → COLLECT_FEATURE_SPIN (collect feature via debug)
+ *   - All bonus types → BASE_GAME_SPIN (after completion)
+ *   - Bonus meter initialization and tracking
+ *   - Invalid transitions rejected
+ */
+const test_engine_factory_1 = require("./helpers/test-engine-factory");
+describe('State Transitions — Bonnys Fortune', () => {
+    beforeEach(() => {
+        (0, test_engine_factory_1.resetCommandIdCounter)();
+    });
+    describe('Initial State', () => {
+        it('should start in BASE_GAME_SPIN state after init', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            expect(session.privateState.nextSpinType).toBe('BASE_GAME_SPIN');
+        });
+        it('should have empty pending bonuses after init', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            expect(session.privateState.pendingBonuses).toBeDefined();
+            expect(session.privateState.pendingBonuses.length).toBe(0);
+        });
+        it('should have no active bonus after init', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            expect(session.privateState.activeBonus).toBeUndefined();
+        });
+        it('should initialize bonus meters', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const meters = session.publicState.bonusMeters;
+            expect(meters).toBeDefined();
+            expect(typeof meters).toBe('object');
+            // Should have 3 meter entries (bonusGame1, bonusGame2, bonusGame3)
+            // collectFeature is triggered via steering fortune wheel, not by a meter
+            const meterKeys = Object.keys(meters || {});
+            expect(meterKeys.length).toBe(3);
+        });
+        it('should initialize bonus meters with valid thresholds', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const meters = session.publicState.bonusMeters;
+            for (const [, meter] of Object.entries(meters || {})) {
+                const m = meter;
+                expect(m.threshold).toBeGreaterThan(0);
+                expect(m.progress).toBeGreaterThanOrEqual(0);
+                expect(m.progress).toBeLessThanOrEqual(m.threshold);
+            }
+        });
+        it('should set bet amount from init payload', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine, 2.0);
+            expect(session.publicState.currentBetAmount).toBe(2.0);
+        });
+        it('should initialize per-bet-amount meter state', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            // bonusMetersByAmount should be populated
+            expect(session.privateState.bonusMetersByAmount).toBeDefined();
+            expect(typeof session.privateState.bonusMetersByAmount).toBe('object');
+            const amounts = Object.keys(session.privateState.bonusMetersByAmount || {});
+            // At least 1 bet amount tier should be initialized
+            expect(amounts.length).toBeGreaterThanOrEqual(1);
+        });
+    });
+    describe('Base Game Transitions', () => {
+        it('should stay in BASE_GAME_SPIN when no bonus triggers', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            let pub = session.publicState;
+            let priv = session.privateState;
+            let baseCount = 0;
+            for (let i = 0; i < 10; i++) {
+                if (priv.nextSpinType !== 'BASE_GAME_SPIN')
+                    break;
+                const result = await (0, test_engine_factory_1.executeSpin)(engine, pub, priv);
+                expect(result.success).toBe(true);
+                if (result.privateState.nextSpinType === 'BASE_GAME_SPIN') {
+                    baseCount++;
+                }
+                pub = result.publicState;
+                priv = result.privateState;
+            }
+            // At least 1 spin should stay in base game
+            expect(baseCount).toBeGreaterThanOrEqual(1);
+        });
+        it('should update bonus meter progress during base game spins', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            // Track initial meter state
+            const initialMeters = JSON.parse(JSON.stringify(session.publicState.bonusMeters));
+            let pub = session.publicState;
+            let priv = session.privateState;
+            // Execute several spins
+            for (let i = 0; i < 5; i++) {
+                if (priv.nextSpinType !== 'BASE_GAME_SPIN')
+                    break;
+                const result = await (0, test_engine_factory_1.executeSpin)(engine, pub, priv);
+                expect(result.success).toBe(true);
+                pub = result.publicState;
+                priv = result.privateState;
+            }
+            // Meters may have changed (or may not, depending on symbol hits)
+            const finalMeters = pub.bonusMeters;
+            expect(finalMeters).toBeDefined();
+        });
+        it('should carry state forward between spins', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const result1 = await (0, test_engine_factory_1.executeSpin)(engine, session.publicState, session.privateState);
+            expect(result1.success).toBe(true);
+            if (result1.privateState.nextSpinType === 'BASE_GAME_SPIN') {
+                const result2 = await (0, test_engine_factory_1.executeSpin)(engine, result1.publicState, result1.privateState);
+                expect(result2.success).toBe(true);
+            }
+        });
+    });
+    describe('Bonus Transitions (via Debug)', () => {
+        const bonusTypes = [
+            { type: 'bonusGame1', expectedSpin: 'BONUS_GAME_1_SPIN', name: 'Treasure Hunt' },
+            { type: 'bonusGame2', expectedSpin: 'BONUS_GAME_2_SPIN', name: 'Free Spins' },
+            { type: 'bonusGame3', expectedSpin: 'BONUS_GAME_3_SPIN', name: 'Steering Fortune' },
+            { type: 'collectFeature', expectedSpin: 'COLLECT_FEATURE_SPIN', name: 'Collect Feature' },
+        ];
+        for (const { type, expectedSpin, name } of bonusTypes) {
+            it(`should add ${name} to pending bonuses via debug trigger`, async () => {
+                const engine = (0, test_engine_factory_1.createEngine)();
+                const session = await (0, test_engine_factory_1.initSession)(engine);
+                const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, session.privateState, type);
+                expect(debugResult.success).toBe(true);
+                // Debug trigger adds exactly 1 pending bonus
+                expect(debugResult.privateState.pendingBonuses.length).toBe(1);
+                const bonus = debugResult.privateState.pendingBonuses[0];
+                expect(bonus.bonusType).toBe(type);
+            });
+            it(`should complete ${name} and return to BASE_GAME_SPIN`, async () => {
+                const engine = (0, test_engine_factory_1.createEngine)();
+                const session = await (0, test_engine_factory_1.initSession)(engine);
+                const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, session.privateState, type);
+                if (!debugResult.success)
+                    return;
+                const bonus = debugResult.privateState.pendingBonuses[0];
+                const bonusResult = await (0, test_engine_factory_1.startBonusRound)(engine, debugResult.publicState, debugResult.privateState, bonus.bonusType);
+                expect(bonusResult.success).toBe(true);
+                // BF generates all bonus results upfront in START_BONUS_ROUND.
+                // Final state (nextSpinType = BASE_GAME_SPIN) is in last result entry.
+                let { publicState: pub, privateState: priv } = (0, test_engine_factory_1.extractFinalBonusState)(bonusResult);
+                // Handle chained bonuses (steering fortune may chain to another bonus)
+                let maxChains = 5;
+                while (priv.pendingBonuses?.length > 0 && maxChains-- > 0) {
+                    const nextBonus = priv.pendingBonuses[0];
+                    const chainResult = await (0, test_engine_factory_1.startBonusRound)(engine, pub, priv, nextBonus.bonusType);
+                    expect(chainResult.success).toBe(true);
+                    ({ publicState: pub, privateState: priv } = (0, test_engine_factory_1.extractFinalBonusState)(chainResult));
+                }
+                // After completion, should return to base
+                if (type !== 'bonusGame3') {
+                    expect(priv.nextSpinType).toBe('BASE_GAME_SPIN');
+                }
+                else {
+                    // Steering Fortune may still be chaining
+                    expect(priv.nextSpinType).toBeDefined();
+                }
+            });
+        }
+        it('should clear pending bonuses after starting a bonus round', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, session.privateState, 'bonusGame1');
+            if (!debugResult.success)
+                return;
+            const bonus = debugResult.privateState.pendingBonuses[0];
+            const bonusResult = await (0, test_engine_factory_1.startBonusRound)(engine, debugResult.publicState, debugResult.privateState, bonus.bonusType);
+            expect(bonusResult.success).toBe(true);
+            // Pending bonus for this type should be consumed
+            const remaining = bonusResult.privateState.pendingBonuses.filter((b) => b.bonusId === bonus.bonusId);
+            expect(remaining.length).toBe(0);
+        });
+    });
+    describe('Debug Update Bonus Meter', () => {
+        it('should update bonus meter progress via debug command', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            // Get a meter key from the public state
+            const meters = session.publicState.bonusMeters;
+            const meterKeys = Object.keys(meters || {});
+            if (meterKeys.length === 0)
+                return;
+            const meterKey = meterKeys[0];
+            try {
+                const result = await engine.processCommand(session.publicState, session.privateState, {
+                    id: (0, test_engine_factory_1.nextCommandId)('debug-meter'),
+                    type: 'DEBUG_UPDATE_BONUS_METER_PROGRESS',
+                    payload: {
+                        meterId: meterKey,
+                        progress: 5,
+                    },
+                });
+                expect(result.success).toBe(true);
+                const updatedMeter = result.publicState.bonusMeters?.[meterKey];
+                if (updatedMeter) {
+                    expect(updatedMeter.progress).toBe(5);
+                }
+            }
+            catch (error) {
+                // Some implementations may not support this
+                expect(error).toBeInstanceOf(Error);
+            }
+        });
+    });
+    describe('GET_SYMBOLS Command', () => {
+        it('should return symbol definitions', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            await (0, test_engine_factory_1.waitForEngineReady)(engine);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const result = await engine.processCommand(null, null, {
+                id: (0, test_engine_factory_1.nextCommandId)('symbols'),
+                type: 'GET_SYMBOLS',
+                payload: {},
+            });
+            expect(result.success).toBe(true);
+            expect(result.outcome).toBeDefined();
+            expect(typeof result.outcome).toBe('object');
+        });
+    });
+    describe('Invalid Transitions', () => {
+        it('should reject SPIN when bonus spin is expected', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            // Set nextSpinType to a bonus type
+            const modifiedPriv = {
+                ...session.privateState,
+                nextSpinType: 'BONUS_GAME_1_SPIN',
+            };
+            try {
+                const result = await (0, test_engine_factory_1.executeSpin)(engine, session.publicState, modifiedPriv);
+                // Should fail or throw
+                if (result.success === false) {
+                    expect(result.success).toBe(false);
+                }
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(Error);
+            }
+        });
+        it('should reject START_BONUS_ROUND when no bonuses pending', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            try {
+                const result = await engine.processCommand(session.publicState, session.privateState, {
+                    id: (0, test_engine_factory_1.nextCommandId)('bonus'),
+                    type: 'START_BONUS_ROUND',
+                    payload: {
+                        sessionId: 'test',
+                        bonusId: 'fake-id',
+                        bonusType: 'bonusGame1',
+                        betAmount: 1.0,
+                        gameCode: 'bonnys-fortune',
+                        gameVersion: '1.0.0',
+                    },
+                });
+                expect(result.success).toBe(false);
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(Error);
+            }
+        });
+        it('should reject START_BONUS_ROUND with mismatched bonus type', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, session.privateState, 'bonusGame1');
+            if (!debugResult.success)
+                return;
+            const bonus = debugResult.privateState.pendingBonuses[0];
+            try {
+                const result = await engine.processCommand(debugResult.publicState, debugResult.privateState, {
+                    id: (0, test_engine_factory_1.nextCommandId)('bonus'),
+                    type: 'START_BONUS_ROUND',
+                    payload: {
+                        sessionId: 'test',
+                        bonusId: bonus.bonusId,
+                        bonusType: 'bonusGame2', // Wrong type
+                        betAmount: 1.0,
+                        gameCode: 'bonnys-fortune',
+                        gameVersion: '1.0.0',
+                    },
+                });
+                expect(result.success).toBe(false);
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(Error);
+            }
+        });
+    });
+});
+//# sourceMappingURL=state-transitions.test.js.map

package/dist/__tests__/state-transitions.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-transitions.test.js","sourceRoot":"","sources":["../../src/__tests__/state-transitions.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/steering-fortune-handler.test.js

@@ -0,0 +1,286 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Steering Fortune Bonus Handler Tests - Bonnys Fortune
+ *
+ * Tests the Steering Fortune (bonusGame3) bonus feature:
+ *   - Wheel spin mechanics
+ *   - Prize resolution from wheel segments
+ *   - Wheel animation states
+ *   - Complete bonus flow
+ *   - Prize tier distribution
+ */
+const test_engine_factory_1 = require("./helpers/test-engine-factory");
+const bonnys_fortune_types_1 = require("../logic/bonnys-fortune.types");
+describe('Steering Fortune Handler - Bonnys Fortune', () => {
+    beforeEach(() => {
+        (0, test_engine_factory_1.resetCommandIdCounter)();
+    });
+    describe('Wheel Spin Mechanics', () => {
+        it('should execute wheel spin and return single result', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, session.privateState, 'bonusGame3');
+            expect(debugResult.success).toBe(true);
+            const bonus = debugResult.privateState.pendingBonuses[0];
+            const bonusResult = await (0, test_engine_factory_1.startBonusRound)(engine, debugResult.publicState, debugResult.privateState, bonus.bonusType);
+            expect(bonusResult.success).toBe(true);
+            expect(bonusResult.outcome?.results).toBeDefined();
+            // Steering Fortune produces exactly 1 result per spin
+            expect(bonusResult.outcome.results.length).toBe(1);
+        });
+        it('should use weighted draw for wheel segment selection', async () => {
+            const { engine } = (0, test_engine_factory_1.createEngineWithLcgRng)(12345);
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, session.privateState, 'bonusGame3');
+            if (!debugResult.success)
+                return;
+            const bonus = debugResult.privateState.pendingBonuses[0];
+            const bonusResult = await (0, test_engine_factory_1.startBonusRound)(engine, debugResult.publicState, debugResult.privateState, bonus.bonusType);
+            expect(bonusResult.success).toBe(true);
+            expect(bonusResult.rngOutcome).toBeDefined();
+            // Should have RNG call for wheel selection
+            expect(Object.keys(bonusResult.rngOutcome || {}).length).toBeGreaterThan(0);
+        });
+        it('should set spinType to BONUS_GAME_3_SPIN', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, session.privateState, 'bonusGame3');
+            if (!debugResult.success)
+                return;
+            const bonus = debugResult.privateState.pendingBonuses[0];
+            const bonusResult = await (0, test_engine_factory_1.startBonusRound)(engine, debugResult.publicState, debugResult.privateState, bonus.bonusType);
+            expect(bonusResult.success).toBe(true);
+            expect(bonusResult.outcome.results[0].result.spinType).toBe(bonnys_fortune_types_1.SpinType.BONUS_GAME_3_SPIN);
+        });
+    });
+    describe('Prize Resolution', () => {
+        it('should resolve to either MULTIPLIER or BONUS prize type', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, session.privateState, 'bonusGame3');
+            if (!debugResult.success)
+                return;
+            const bonus = debugResult.privateState.pendingBonuses[0];
+            const bonusResult = await (0, test_engine_factory_1.startBonusRound)(engine, debugResult.publicState, debugResult.privateState, bonus.bonusType);
+            expect(bonusResult.success).toBe(true);
+            const prizeType = bonusResult.outcome.results[0].result.prizeType;
+            expect([bonnys_fortune_types_1.PrizeType.MULTIPLIER, bonnys_fortune_types_1.PrizeType.BONUS]).toContain(prizeType);
+        });
+        it('should calculate playerWinning for MULTIPLIER prize type', async () => {
+            // Use mock RNG to force a multiplier prize (low RNG value typically hits first segment)
+            const { engine, mockRng } = (0, test_engine_factory_1.createEngineWithMockRng)([0]);
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, session.privateState, 'bonusGame3');
+            if (!debugResult.success)
+                return;
+            const bonus = debugResult.privateState.pendingBonuses[0];
+            const bonusResult = await (0, test_engine_factory_1.startBonusRound)(engine, debugResult.publicState, debugResult.privateState, bonus.bonusType);
+            expect(bonusResult.success).toBe(true);
+            const result = bonusResult.outcome.results[0].result;
+            expect(result.playerWinning).toBeDefined();
+            expect(typeof result.playerWinning).toBe('number');
+        });
+        it('should include prizeValue in result', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, session.privateState, 'bonusGame3');
+            if (!debugResult.success)
+                return;
+            const bonus = debugResult.privateState.pendingBonuses[0];
+            const bonusResult = await (0, test_engine_factory_1.startBonusRound)(engine, debugResult.publicState, debugResult.privateState, bonus.bonusType);
+            expect(bonusResult.success).toBe(true);
+            const result = bonusResult.outcome.results[0].result;
+            expect(result.prizeValue).toBeDefined();
+        });
+        it('should set totalMultiplier for multiplier prizes', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, session.privateState, 'bonusGame3');
+            if (!debugResult.success)
+                return;
+            const bonus = debugResult.privateState.pendingBonuses[0];
+            const bonusResult = await (0, test_engine_factory_1.startBonusRound)(engine, debugResult.publicState, debugResult.privateState, bonus.bonusType);
+            expect(bonusResult.success).toBe(true);
+            const result = bonusResult.outcome.results[0].result;
+            expect(result.totalMultiplier).toBeDefined();
+            expect(typeof result.totalMultiplier).toBe('number');
+        });
+    });
+    describe('Bonus Chaining', () => {
+        it('should set triggeredBonus when prize is BONUS type', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            // Run multiple attempts to hit a BONUS prize
+            for (let attempt = 0; attempt < 20; attempt++) {
+                (0, test_engine_factory_1.resetCommandIdCounter)();
+                const { engine: attemptEngine } = (0, test_engine_factory_1.createEngineWithLcgRng)(attempt * 1000);
+                const attemptSession = await (0, test_engine_factory_1.initSession)(attemptEngine);
+                const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(attemptEngine, attemptSession.publicState, attemptSession.privateState, 'bonusGame3');
+                if (!debugResult.success)
+                    continue;
+                const bonus = debugResult.privateState.pendingBonuses[0];
+                const bonusResult = await (0, test_engine_factory_1.startBonusRound)(attemptEngine, debugResult.publicState, debugResult.privateState, bonus.bonusType);
+                if (!bonusResult.success)
+                    continue;
+                const result = bonusResult.outcome.results[0].result;
+                if (result.prizeType === bonnys_fortune_types_1.PrizeType.BONUS) {
+                    expect(result.triggeredBonus).toBeDefined();
+                    expect(result.triggeredBonus.bonusId).toBeDefined();
+                    expect(result.triggeredBonus.bonusType).toBeDefined();
+                    return; // Test passed
+                }
+            }
+            // If no BONUS prize found in 20 attempts, that's also valid (multipliers are more common)
+            expect(true).toBe(true);
+        });
+        it('should add triggered bonus to pendingBonuses for chaining', async () => {
+            // Test the chaining mechanism by checking privateState
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, session.privateState, 'bonusGame3');
+            if (!debugResult.success)
+                return;
+            const bonus = debugResult.privateState.pendingBonuses[0];
+            const bonusResult = await (0, test_engine_factory_1.startBonusRound)(engine, debugResult.publicState, debugResult.privateState, bonus.bonusType);
+            expect(bonusResult.success).toBe(true);
+            const finalState = (0, test_engine_factory_1.extractFinalBonusState)(bonusResult);
+            const result = bonusResult.outcome.results[0].result;
+            if (result.prizeType === bonnys_fortune_types_1.PrizeType.BONUS) {
+                // Should have pending bonus for chaining
+                expect(finalState.privateState.pendingBonuses.length).toBe(1);
+            }
+            else {
+                // No pending bonus for multiplier prizes
+                expect(finalState.privateState.pendingBonuses.length).toBe(0);
+            }
+        });
+    });
+    describe('Complete Bonus Flow', () => {
+        it('should complete steering fortune and determine next state', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, session.privateState, 'bonusGame3');
+            expect(debugResult.success).toBe(true);
+            const bonus = debugResult.privateState.pendingBonuses[0];
+            const bonusResult = await (0, test_engine_factory_1.startBonusRound)(engine, debugResult.publicState, debugResult.privateState, bonus.bonusType);
+            expect(bonusResult.success).toBe(true);
+            const finalState = (0, test_engine_factory_1.extractFinalBonusState)(bonusResult);
+            expect(finalState.privateState.nextSpinType).toBeDefined();
+        });
+        it('should return to BASE_GAME_SPIN for multiplier prizes', async () => {
+            // Run with different seeds until we get a multiplier prize
+            for (let seed = 0; seed < 50; seed++) {
+                (0, test_engine_factory_1.resetCommandIdCounter)();
+                const { engine } = (0, test_engine_factory_1.createEngineWithLcgRng)(seed * 100);
+                const session = await (0, test_engine_factory_1.initSession)(engine);
+                const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, session.privateState, 'bonusGame3');
+                if (!debugResult.success)
+                    continue;
+                const bonus = debugResult.privateState.pendingBonuses[0];
+                const bonusResult = await (0, test_engine_factory_1.startBonusRound)(engine, debugResult.publicState, debugResult.privateState, bonus.bonusType);
+                if (!bonusResult.success)
+                    continue;
+                const result = bonusResult.outcome.results[0].result;
+                if (result.prizeType === bonnys_fortune_types_1.PrizeType.MULTIPLIER) {
+                    const finalState = (0, test_engine_factory_1.extractFinalBonusState)(bonusResult);
+                    expect(finalState.privateState.nextSpinType).toBe(bonnys_fortune_types_1.SpinType.BASE_GAME_SPIN);
+                    return;
+                }
+            }
+            // Skip if no multiplier found (weighted towards bonuses in config)
+            expect(true).toBe(true);
+        });
+        it('should clear activeBonus after completion', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, session.privateState, 'bonusGame3');
+            if (!debugResult.success)
+                return;
+            const bonus = debugResult.privateState.pendingBonuses[0];
+            const bonusResult = await (0, test_engine_factory_1.startBonusRound)(engine, debugResult.publicState, debugResult.privateState, bonus.bonusType);
+            expect(bonusResult.success).toBe(true);
+            const finalState = (0, test_engine_factory_1.extractFinalBonusState)(bonusResult);
+            expect(finalState.privateState.activeBonus).toBeUndefined();
+        });
+    });
+    describe('Prize Tier Distribution', () => {
+        it('should produce valid prize values from wheel config', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, session.privateState, 'bonusGame3');
+            if (!debugResult.success)
+                return;
+            const bonus = debugResult.privateState.pendingBonuses[0];
+            const bonusResult = await (0, test_engine_factory_1.startBonusRound)(engine, debugResult.publicState, debugResult.privateState, bonus.bonusType);
+            expect(bonusResult.success).toBe(true);
+            const result = bonusResult.outcome.results[0].result;
+            if (result.prizeType === bonnys_fortune_types_1.PrizeType.MULTIPLIER) {
+                expect(typeof result.prizeValue).toBe('number');
+                expect(result.prizeValue).toBeGreaterThan(0);
+            }
+            else {
+                // BONUS type - prizeValue should be the bonus type string
+                expect(typeof result.prizeValue).toBe('string');
+            }
+        });
+        it('should produce non-negative winnings', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, session.privateState, 'bonusGame3');
+            if (!debugResult.success)
+                return;
+            const bonus = debugResult.privateState.pendingBonuses[0];
+            const bonusResult = await (0, test_engine_factory_1.startBonusRound)(engine, debugResult.publicState, debugResult.privateState, bonus.bonusType);
+            expect(bonusResult.success).toBe(true);
+            expect(bonusResult.outcome.results[0].result.playerWinning).toBeGreaterThanOrEqual(0);
+        });
+        it('should scale winnings with bet amount for multiplier prizes', async () => {
+            const betAmounts = [1.0, 5.0, 10.0];
+            const winnings = [];
+            // Use same LCG seed to get same wheel outcome
+            for (const betAmount of betAmounts) {
+                (0, test_engine_factory_1.resetCommandIdCounter)();
+                const { engine } = (0, test_engine_factory_1.createEngineWithLcgRng)(77777);
+                const session = await (0, test_engine_factory_1.initSession)(engine, betAmount);
+                const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, session.privateState, 'bonusGame3', betAmount);
+                if (!debugResult.success)
+                    continue;
+                const bonus = debugResult.privateState.pendingBonuses[0];
+                const bonusResult = await (0, test_engine_factory_1.startBonusRound)(engine, debugResult.publicState, debugResult.privateState, bonus.bonusType, betAmount);
+                if (bonusResult.success) {
+                    const result = bonusResult.outcome.results[0].result;
+                    if (result.prizeType === bonnys_fortune_types_1.PrizeType.MULTIPLIER) {
+                        winnings.push(result.playerWinning);
+                    }
+                }
+            }
+            // If we got multiplier results, winnings should scale with bet
+            if (winnings.length >= 2) {
+                // Higher bet should produce higher or equal winnings
+                expect(winnings[1]).toBeGreaterThanOrEqual(winnings[0]);
+            }
+        });
+    });
+    describe('RNG Determinism', () => {
+        it('should produce consistent results with same LCG seed', async () => {
+            const results = [];
+            for (let i = 0; i < 2; i++) {
+                (0, test_engine_factory_1.resetCommandIdCounter)();
+                const { engine } = (0, test_engine_factory_1.createEngineWithLcgRng)(99999);
+                const session = await (0, test_engine_factory_1.initSession)(engine);
+                const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, session.privateState, 'bonusGame3');
+                if (!debugResult.success)
+                    continue;
+                const bonus = debugResult.privateState.pendingBonuses[0];
+                const bonusResult = await (0, test_engine_factory_1.startBonusRound)(engine, debugResult.publicState, debugResult.privateState, bonus.bonusType);
+                results.push(bonusResult.outcome.results[0].result);
+            }
+            expect(results.length).toBe(2);
+            expect(results[0].prizeType).toEqual(results[1].prizeType);
+            expect(results[0].prizeValue).toEqual(results[1].prizeValue);
+            expect(results[0].playerWinning).toEqual(results[1].playerWinning);
+        });
+    });
+});
+//# sourceMappingURL=steering-fortune-handler.test.js.map