@omnitronix/bonnys-fortune-game-engine 1.4.0 → 1.4.1

package/README.md

@@ -602,6 +602,16 @@ async function testBonusGame() {
 }
 ```
 
+## Testing
+
+This engine uses [@omnitronix/game-test-utils](https://github.com/omnitronix/game-test-utils) for comprehensive testing including:
+- GLI-19 compliance validation
+- RNG security testing
+- Statistical RTP simulation
+- Symbol distribution analysis
+
+Run tests: `npm test`
+
 ## Development
 
 ### Running Tests

package/dist/__tests__/base-game.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/base-game.test.js

@@ -0,0 +1,255 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Base Game Logic Tests — Bonnys Fortune
+ *
+ * Tests the core base game mechanics:
+ *   - Screen generation (5x3 grid, 243 ways)
+ *   - Win calculation (ways evaluation)
+ *   - Bonus meter tracking and progression
+ *   - Bet amount handling
+ *   - Per-bet-amount meter state
+ */
+const test_engine_factory_1 = require("./helpers/test-engine-factory");
+describe('Base Game Logic — Bonnys Fortune', () => {
+    beforeEach(() => {
+        (0, test_engine_factory_1.resetCommandIdCounter)();
+    });
+    describe('Screen Generation', () => {
+        it('should generate a 5x3 screen on each spin', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const result = await (0, test_engine_factory_1.executeSpin)(engine, session.publicState, session.privateState);
+            expect(result.success).toBe(true);
+            const screen = result.outcome?.result?.screen ?? result.outcome?.screen;
+            expect(screen).toBeDefined();
+            expect(screen.length).toBe(5);
+            for (const reel of screen) {
+                expect(reel.length).toBe(3);
+            }
+        });
+        it('should produce valid symbol IDs on screen', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const result = await (0, test_engine_factory_1.executeSpin)(engine, session.publicState, session.privateState);
+            expect(result.success).toBe(true);
+            const screen = result.outcome?.result?.screen ?? result.outcome?.screen;
+            for (const reel of screen) {
+                for (const symbol of reel) {
+                    expect(typeof symbol).toBe('number');
+                    expect(symbol).toBeGreaterThanOrEqual(0);
+                }
+            }
+        });
+        it('should produce different screens across multiple spins', async () => {
+            // Use LCG RNG to avoid DummyRng producing identical screens and
+            // constant bonus meter triggers that prevent base game spins
+            const { engine } = (0, test_engine_factory_1.createEngineWithLcgRng)(54321);
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            let pub = session.publicState;
+            let priv = session.privateState;
+            const screens = [];
+            for (let i = 0; i < 50; i++) {
+                if (priv.nextSpinType !== 'BASE_GAME_SPIN') {
+                    // Bonus triggered — complete it via extractFinalBonusState
+                    if (priv.pendingBonuses?.length > 0) {
+                        const bonus = priv.pendingBonuses[0];
+                        const bonusResult = await (0, test_engine_factory_1.startBonusRound)(engine, pub, priv, bonus.bonusType);
+                        const finalState = (0, test_engine_factory_1.extractFinalBonusState)(bonusResult);
+                        pub = finalState.publicState;
+                        priv = finalState.privateState;
+                        // Handle chained bonuses (steering fortune)
+                        while (priv.pendingBonuses?.length > 0) {
+                            const nextBonus = priv.pendingBonuses[0];
+                            const chainResult = await (0, test_engine_factory_1.startBonusRound)(engine, pub, priv, nextBonus.bonusType);
+                            const chainFinal = (0, test_engine_factory_1.extractFinalBonusState)(chainResult);
+                            pub = chainFinal.publicState;
+                            priv = chainFinal.privateState;
+                        }
+                    }
+                    if (priv.nextSpinType !== 'BASE_GAME_SPIN')
+                        break;
+                }
+                const result = await (0, test_engine_factory_1.executeSpin)(engine, pub, priv);
+                expect(result.success).toBe(true);
+                const screen = result.outcome?.result?.screen ?? result.outcome?.screen ?? result.privateState.screen;
+                screens.push(JSON.stringify(screen));
+                pub = result.publicState;
+                priv = result.privateState;
+            }
+            const unique = new Set(screens);
+            expect(unique.size).toBeGreaterThan(1);
+        });
+    });
+    describe('Win Calculation', () => {
+        it('should report playerWinning as non-negative number', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const result = await (0, test_engine_factory_1.executeSpin)(engine, session.publicState, session.privateState);
+            expect(result.success).toBe(true);
+            const playerWinning = result.outcome?.result?.playerWinning ?? result.outcome?.playerWinning;
+            if (playerWinning !== undefined) {
+                expect(playerWinning).toBeGreaterThanOrEqual(0);
+                expect(typeof playerWinning).toBe('number');
+            }
+        });
+        it('should produce finite win amounts', 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;
+            for (let i = 0; i < 20; 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);
+                const playerWinning = result.outcome?.result?.playerWinning ?? result.outcome?.playerWinning;
+                if (playerWinning !== undefined) {
+                    expect(Number.isFinite(playerWinning)).toBe(true);
+                }
+                pub = result.publicState;
+                priv = result.privateState;
+            }
+        });
+    });
+    describe('Bonus Meter Mechanics', () => {
+        it('should have bonus meters in public state after init', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            expect(session.publicState.bonusMeters).toBeDefined();
+            const keys = Object.keys(session.publicState.bonusMeters || {});
+            expect(keys.length).toBeGreaterThan(0);
+        });
+        it('should have valid threshold and progress for each meter', 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(typeof m.threshold).toBe('number');
+                expect(typeof m.progress).toBe('number');
+            }
+        });
+        it('should maintain meter state across spins', 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;
+            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);
+                expect(result.publicState.bonusMeters).toBeDefined();
+                // Verify meter structure integrity
+                for (const [, meter] of Object.entries(result.publicState.bonusMeters || {})) {
+                    const m = meter;
+                    expect(m.threshold).toBeGreaterThan(0);
+                    expect(m.progress).toBeGreaterThanOrEqual(0);
+                    expect(m.progress).toBeLessThanOrEqual(m.threshold);
+                }
+                pub = result.publicState;
+                priv = result.privateState;
+            }
+        });
+        it('should not allow meter progress to exceed threshold', 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;
+            for (let i = 0; i < 30; 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);
+                for (const [, meter] of Object.entries(result.publicState.bonusMeters || {})) {
+                    const m = meter;
+                    expect(m.progress).toBeLessThanOrEqual(m.threshold);
+                }
+                pub = result.publicState;
+                priv = result.privateState;
+            }
+        });
+        it('should have per-bet-amount meter state in private state', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            expect(session.privateState.bonusMetersByAmount).toBeDefined();
+            const amounts = Object.keys(session.privateState.bonusMetersByAmount || {});
+            expect(amounts.length).toBeGreaterThan(0);
+        });
+    });
+    describe('RNG Outcome Tracking', () => {
+        it('should produce valid RNG outcome on each spin', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const result = await (0, test_engine_factory_1.executeSpin)(engine, session.publicState, session.privateState);
+            expect(result.success).toBe(true);
+            expect(result.rngOutcome).toBeDefined();
+            const validation = (0, test_engine_factory_1.validateRngOutcome)(result.rngOutcome);
+            expect(validation.valid).toBe(true);
+        });
+    });
+    describe('Bet Amount Handling', () => {
+        it('should accept different bet amounts', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine, 0.5);
+            const result = await (0, test_engine_factory_1.executeSpin)(engine, session.publicState, session.privateState, 0.5);
+            expect(result.success).toBe(true);
+        });
+        it('should update currentBetAmount in public state', 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 switch meter state when bet amount changes', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine, 1.0);
+            const result1 = await (0, test_engine_factory_1.executeSpin)(engine, session.publicState, session.privateState, 1.0);
+            expect(result1.success).toBe(true);
+            if (result1.privateState.nextSpinType === 'BASE_GAME_SPIN') {
+                // Change bet amount
+                const result2 = await (0, test_engine_factory_1.executeSpin)(engine, result1.publicState, result1.privateState, 2.0);
+                expect(result2.success).toBe(true);
+                // Meters should still be valid
+                expect(result2.publicState.bonusMeters).toBeDefined();
+            }
+        });
+    });
+    describe('Mock RNG Determinism', () => {
+        it('should produce deterministic results with mock RNG', async () => {
+            const { engine: engine1 } = (0, test_engine_factory_1.createEngineWithMockRng)([42, 42, 42, 42, 42]);
+            const { engine: engine2 } = (0, test_engine_factory_1.createEngineWithMockRng)([42, 42, 42, 42, 42]);
+            const session1 = await (0, test_engine_factory_1.initSession)(engine1);
+            const session2 = await (0, test_engine_factory_1.initSession)(engine2);
+            const result1 = await (0, test_engine_factory_1.executeSpin)(engine1, session1.publicState, session1.privateState);
+            const result2 = await (0, test_engine_factory_1.executeSpin)(engine2, session2.publicState, session2.privateState);
+            expect(result1.success).toBe(true);
+            expect(result2.success).toBe(true);
+            const screen1 = JSON.stringify(result1.outcome?.screen || result1.privateState.screen);
+            const screen2 = JSON.stringify(result2.outcome?.screen || result2.privateState.screen);
+            expect(screen1).toBe(screen2);
+        });
+    });
+    describe('Multiple Spin Stability', () => {
+        it('should handle 30 consecutive base game spins', 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 spinCount = 0;
+            for (let i = 0; i < 30; 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);
+                spinCount++;
+                pub = result.publicState;
+                priv = result.privateState;
+            }
+            expect(spinCount).toBeGreaterThan(0);
+        });
+    });
+});
+//# sourceMappingURL=base-game.test.js.map

package/dist/__tests__/base-game.test.js.map

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

package/dist/__tests__/bonnys-fortune-v1.game-engine.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/bonnys-fortune-v1.game-engine.test.js

@@ -10,7 +10,7 @@ describe('BonnysFortuneV1GameEngine', () => {
     it('should initialize the game engine and return info', async () => {
         const info = gameEngine.getGameEngineInfo();
         expect(info.gameCode).toBe('bonnys-fortune');
-        expect(info.version).toBe('1.0.0');
+        expect(info.version).toBe('1.5.0');
         expect(info.rtp).toBe(96);
         expect(info.gameType).toBe('slot');
     });

package/dist/__tests__/bonus-handlers.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/bonus-handlers.test.js

@@ -0,0 +1,303 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Bonus Handler Tests — Bonnys Fortune
+ *
+ * Tests all 4 bonus types via debug trigger:
+ *   - Treasure Hunt (bonusGame1): pick mechanic, jackpots
+ *   - Free Spins (bonusGame2): ways evaluation, multipliers
+ *   - Steering Fortune (bonusGame3): wheel spin, prize resolution
+ *   - Collect Feature (collectFeature): symbol collection, checkpoints
+ *   - Debug trigger → START_BONUS_ROUND flow
+ *   - Meter redraw after bonus completion
+ */
+const test_engine_factory_1 = require("./helpers/test-engine-factory");
+describe('Bonus Handlers — Bonnys Fortune', () => {
+    beforeEach(() => {
+        (0, test_engine_factory_1.resetCommandIdCounter)();
+    });
+    describe('Treasure Hunt (bonusGame1)', () => {
+        it('should trigger treasure hunt via debug successfully', 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');
+            expect(debugResult.success).toBe(true);
+            // Debug trigger adds exactly 1 pending bonus
+            expect(debugResult.privateState.pendingBonuses.length).toBe(1);
+        });
+        it('should complete treasure hunt 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, '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);
+            // BF generates all bonus results upfront — final state is in last result
+            const finalState = (0, test_engine_factory_1.extractFinalBonusState)(bonusResult);
+            expect(finalState.privateState.nextSpinType).toBe('BASE_GAME_SPIN');
+        });
+        it('should produce non-negative winnings from treasure hunt', 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);
+            if (bonusResult.outcome) {
+                const outcomes = Array.isArray(bonusResult.outcome)
+                    ? bonusResult.outcome
+                    : [bonusResult.outcome];
+                for (const o of outcomes) {
+                    if (o.playerWinning !== undefined) {
+                        expect(o.playerWinning).toBeGreaterThanOrEqual(0);
+                    }
+                }
+            }
+        });
+        it('should include RNG outcome in treasure hunt', 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);
+            expect(bonusResult.rngOutcome).toBeDefined();
+            expect(typeof bonusResult.rngOutcome).toBe('object');
+            expect(Object.keys(bonusResult.rngOutcome || {}).length).toBeGreaterThan(0);
+        });
+    });
+    describe('Free Spins (bonusGame2)', () => {
+        it('should trigger free spins via debug successfully', 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, 'bonusGame2');
+            expect(debugResult.success).toBe(true);
+            // Debug trigger adds exactly 1 pending bonus
+            expect(debugResult.privateState.pendingBonuses.length).toBe(1);
+        });
+        it('should complete free spins 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, 'bonusGame2');
+            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 — final state is in last result
+            const finalState = (0, test_engine_factory_1.extractFinalBonusState)(bonusResult);
+            expect(finalState.privateState.nextSpinType).toBe('BASE_GAME_SPIN');
+        });
+        it('should produce non-negative winnings from free spins', 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, 'bonusGame2');
+            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);
+            if (bonusResult.outcome) {
+                const outcomes = Array.isArray(bonusResult.outcome)
+                    ? bonusResult.outcome
+                    : [bonusResult.outcome];
+                for (const o of outcomes) {
+                    if (o.playerWinning !== undefined) {
+                        expect(o.playerWinning).toBeGreaterThanOrEqual(0);
+                    }
+                }
+            }
+        });
+    });
+    describe('Steering Fortune (bonusGame3)', () => {
+        it('should trigger steering fortune via debug successfully', 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);
+            // Debug trigger adds exactly 1 pending bonus
+            expect(debugResult.privateState.pendingBonuses.length).toBe(1);
+        });
+        it('should complete steering fortune', 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);
+            // Steering Fortune may chain to another bonus type
+            const finalState = (0, test_engine_factory_1.extractFinalBonusState)(bonusResult);
+            expect(finalState.privateState.nextSpinType).toBeDefined();
+        });
+        it('should handle steering fortune chaining to another bonus', 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);
+            // If it chained to another bonus, complete that too
+            const finalState = (0, test_engine_factory_1.extractFinalBonusState)(bonusResult);
+            if (finalState.privateState.pendingBonuses?.length > 0) {
+                const nextBonus = finalState.privateState.pendingBonuses[0];
+                const nextResult = await (0, test_engine_factory_1.startBonusRound)(engine, finalState.publicState, finalState.privateState, nextBonus.bonusType);
+                expect(nextResult.success).toBe(true);
+            }
+        });
+    });
+    describe('Collect Feature (collectFeature)', () => {
+        it('should trigger collect feature via debug successfully', 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, 'collectFeature');
+            expect(debugResult.success).toBe(true);
+            // Debug trigger adds exactly 1 pending bonus
+            expect(debugResult.privateState.pendingBonuses.length).toBe(1);
+        });
+        it('should complete collect feature 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, 'collectFeature');
+            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 — final state is in last result
+            const finalState = (0, test_engine_factory_1.extractFinalBonusState)(bonusResult);
+            expect(finalState.privateState.nextSpinType).toBe('BASE_GAME_SPIN');
+        });
+        it('should produce non-negative winnings from collect feature', 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, 'collectFeature');
+            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);
+            if (bonusResult.outcome) {
+                const outcomes = Array.isArray(bonusResult.outcome)
+                    ? bonusResult.outcome
+                    : [bonusResult.outcome];
+                for (const o of outcomes) {
+                    if (o.playerWinning !== undefined) {
+                        expect(o.playerWinning).toBeGreaterThanOrEqual(0);
+                    }
+                }
+            }
+        });
+    });
+    describe('Meter Redraw After Bonus', () => {
+        it('should redraw meter after non-collectFeature bonus', 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);
+            // After bonus, meters should be valid (may have been redrawn)
+            const finalMeters = bonusResult.publicState.bonusMeters;
+            expect(finalMeters).toBeDefined();
+            expect(typeof finalMeters).toBe('object');
+            // Should have 3 meters (bonusGame1, bonusGame2, bonusGame3)
+            expect(Object.keys(finalMeters || {}).length).toBe(3);
+            for (const [, meter] of Object.entries(finalMeters || {})) {
+                const m = meter;
+                expect(m.threshold).toBeGreaterThan(0);
+                expect(m.progress).toBeGreaterThanOrEqual(0);
+            }
+        });
+    });
+    describe('Post-Bonus Play', () => {
+        it('should allow normal spin after treasure hunt', 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);
+            const finalState1 = (0, test_engine_factory_1.extractFinalBonusState)(bonusResult);
+            if (finalState1.privateState.nextSpinType === 'BASE_GAME_SPIN') {
+                const spinResult = await (0, test_engine_factory_1.executeSpin)(engine, finalState1.publicState, finalState1.privateState);
+                expect(spinResult.success).toBe(true);
+            }
+        });
+        it('should allow normal spin after free spins', 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, 'bonusGame2');
+            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 finalState2 = (0, test_engine_factory_1.extractFinalBonusState)(bonusResult);
+            if (finalState2.privateState.nextSpinType === 'BASE_GAME_SPIN') {
+                const spinResult = await (0, test_engine_factory_1.executeSpin)(engine, finalState2.publicState, finalState2.privateState);
+                expect(spinResult.success).toBe(true);
+            }
+        });
+        it('should allow normal spin after collect feature', 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, 'collectFeature');
+            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 finalState3 = (0, test_engine_factory_1.extractFinalBonusState)(bonusResult);
+            if (finalState3.privateState.nextSpinType === 'BASE_GAME_SPIN') {
+                const spinResult = await (0, test_engine_factory_1.executeSpin)(engine, finalState3.publicState, finalState3.privateState);
+                expect(spinResult.success).toBe(true);
+            }
+        });
+    });
+    describe('Debug Trigger Mechanics', () => {
+        it('should support all 4 bonus types via debug', async () => {
+            const types = ['bonusGame1', 'bonusGame2', 'bonusGame3', 'collectFeature'];
+            for (const type of types) {
+                const engine = (0, test_engine_factory_1.createEngine)();
+                const session = await (0, test_engine_factory_1.initSession)(engine);
+                const result = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, session.privateState, type);
+                expect(result.success).toBe(true);
+            }
+        });
+        it('should add bonus to pending list with valid bonusId', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const result = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, session.privateState, 'bonusGame1');
+            expect(result.success).toBe(true);
+            const bonus = result.privateState.pendingBonuses[0];
+            expect(bonus).toBeDefined();
+            expect(bonus.bonusId).toBeDefined();
+            expect(typeof bonus.bonusId).toBe('string');
+            // UUID format: at least 32 characters (without dashes) or 36 with dashes
+            expect(bonus.bonusId.length).toBeGreaterThanOrEqual(32);
+        });
+        it('should preserve bet amount in triggered bonus', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine, 5.0);
+            const result = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, session.privateState, 'bonusGame1', 5.0);
+            expect(result.success).toBe(true);
+            const bonus = result.privateState.pendingBonuses[0];
+            expect(bonus.betAmount).toBe(5.0);
+        });
+    });
+});
+//# sourceMappingURL=bonus-handlers.test.js.map