@omnitronix/lucky-sharky-game-engine 1.1.0 → 1.2.0

package/dist/__tests__/free-spins-handler.test.js

@@ -0,0 +1,410 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Free Spins Handler Tests - Lucky Sharky
+ *
+ * Tests the Free Spins bonus mechanics:
+ *   - Free spins initialization by booster level (different spin counts)
+ *   - Retrigger mechanics (additional scatters during free spins)
+ *   - Guaranteed spin handling
+ *   - Free spins completion and return to base game
+ *   - Win accumulation during free spins
+ *   - Multiplier application in free spins
+ */
+const test_engine_factory_1 = require("./helpers/test-engine-factory");
+describe('Free Spins Handler - Lucky Sharky', () => {
+    beforeEach(() => {
+        (0, test_engine_factory_1.resetCommandIdCounter)();
+    });
+    describe('Free Spins Initialization by Booster Level', () => {
+        it('should award 10 free spins at booster level 0', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            // Ensure booster level is 0
+            expect(session.publicState.boosterLevel).toBe(0);
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, session.privateState, 'FREE_SPINS');
+            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);
+            // Verify the series completed (freeSpinsRemaining should be 0)
+            expect(bonusResult.publicState.freeSpinsRemaining).toBe(0);
+        });
+        it('should award 15 free spins at booster level 3', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            // Set booster level to 3 manually
+            const modifiedPrivate = {
+                ...session.privateState,
+                boosterLevel: 3,
+                boosterMemory: 3,
+            };
+            const modifiedPublic = {
+                ...session.publicState,
+                boosterLevel: 3,
+            };
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, modifiedPublic, modifiedPrivate, 'FREE_SPINS');
+            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.publicState.freeSpinsRemaining).toBe(0);
+        });
+        it('should award 20 free spins at booster level 6', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const modifiedPrivate = {
+                ...session.privateState,
+                boosterLevel: 6,
+                boosterMemory: 6,
+            };
+            const modifiedPublic = {
+                ...session.publicState,
+                boosterLevel: 6,
+            };
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, modifiedPublic, modifiedPrivate, 'FREE_SPINS');
+            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.publicState.freeSpinsRemaining).toBe(0);
+        });
+        it('should award 25 free spins at booster level 9', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const modifiedPrivate = {
+                ...session.privateState,
+                boosterLevel: 9,
+                boosterMemory: 9,
+            };
+            const modifiedPublic = {
+                ...session.publicState,
+                boosterLevel: 9,
+            };
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, modifiedPublic, modifiedPrivate, 'FREE_SPINS');
+            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.publicState.freeSpinsRemaining).toBe(0);
+        });
+        it('should use boosterMemory if boosterLevel is 0', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            // Simulate scenario where boosterMemory was saved before entering free spins
+            const modifiedPrivate = {
+                ...session.privateState,
+                boosterLevel: 0,
+                boosterMemory: 6, // Should use this value
+            };
+            const modifiedPublic = {
+                ...session.publicState,
+                boosterLevel: 0,
+            };
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, modifiedPublic, modifiedPrivate, 'FREE_SPINS');
+            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);
+        });
+    });
+    describe('Retrigger Mechanics', () => {
+        it('should support retrigger at booster level 3 (+5 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, 'FREE_SPINS');
+            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);
+            // Free spins should complete successfully regardless of retrigger
+            expect(bonusResult.success).toBe(true);
+            expect(bonusResult.privateState.nextSpinType).toBe('BASE_GAME_SPIN');
+        });
+        it('should allow multiple retriggers during free spins', async () => {
+            const { engine, lcgRng } = (0, test_engine_factory_1.createEngineWithLcgRng)(42424);
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, session.privateState, 'FREE_SPINS');
+            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);
+            // Verify RNG outcome is present
+            expect(bonusResult.rngOutcome).toBeDefined();
+        });
+        it('should not retrigger if booster level does not increase', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            // Start at max booster level
+            const modifiedPrivate = {
+                ...session.privateState,
+                boosterLevel: 9,
+                boosterMemory: 9,
+            };
+            const modifiedPublic = {
+                ...session.publicState,
+                boosterLevel: 9,
+            };
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, modifiedPublic, modifiedPrivate, 'FREE_SPINS');
+            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.publicState.freeSpinsRemaining).toBe(0);
+        });
+    });
+    describe('Guaranteed Spin Handling', () => {
+        it('should decrement guaranteeSpinCount during free spins', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const modifiedPrivate = {
+                ...session.privateState,
+                guaranteeSpinCount: 5,
+            };
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, modifiedPrivate, 'FREE_SPINS');
+            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);
+            // Guarantee count should be decremented or zero
+            expect(bonusResult.privateState.guaranteeSpinCount).toBeGreaterThanOrEqual(0);
+        });
+        it('should handle zero guaranteeSpinCount', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            const modifiedPrivate = {
+                ...session.privateState,
+                guaranteeSpinCount: 0,
+            };
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, session.publicState, modifiedPrivate, 'FREE_SPINS');
+            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.privateState.guaranteeSpinCount).toBe(0);
+        });
+    });
+    describe('Free Spins Completion and Return to Base Game', () => {
+        it('should return to BASE_GAME_SPIN after all free spins complete', 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, 'FREE_SPINS');
+            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.privateState.nextSpinType).toBe('BASE_GAME_SPIN');
+            expect(bonusResult.publicState.freeSpinsRemaining).toBe(0);
+        });
+        it('should restore booster level 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, 'FREE_SPINS');
+            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);
+            // Booster should be restored to pre-bonus level (stored in boosterMemory)
+            expect(bonusResult.publicState.boosterLevel).toBeGreaterThanOrEqual(0);
+            expect(bonusResult.publicState.boosterLevel).toBeLessThanOrEqual(9);
+            expect(bonusResult.privateState.boosterMemory).toBe(0);
+        });
+        it('should clear pending bonuses 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, 'FREE_SPINS');
+            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.privateState.pendingBonuses).toEqual([]);
+        });
+        it('should allow normal spins after free spins complete', 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, 'FREE_SPINS');
+            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);
+            // Should be able to execute a normal spin
+            const spinResult = await (0, test_engine_factory_1.executeSpin)(engine, bonusResult.publicState, bonusResult.privateState);
+            expect(spinResult.success).toBe(true);
+        });
+    });
+    describe('Win Accumulation During Free Spins', () => {
+        it('should produce non-negative total 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, 'FREE_SPINS');
+            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);
+            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 produce finite win amounts', 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, 'FREE_SPINS');
+            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);
+            if (bonusResult.outcome) {
+                const outcomes = Array.isArray(bonusResult.outcome)
+                    ? bonusResult.outcome
+                    : [bonusResult.outcome];
+                for (const o of outcomes) {
+                    if (o.playerWinning !== undefined) {
+                        expect(Number.isFinite(o.playerWinning)).toBe(true);
+                    }
+                }
+            }
+        });
+        it('should scale wins with bet amount during free spins', async () => {
+            // Test at bet 1.0
+            const engine1 = (0, test_engine_factory_1.createEngine)();
+            const session1 = await (0, test_engine_factory_1.initSession)(engine1, 1.0);
+            const debug1 = await (0, test_engine_factory_1.debugTriggerBonus)(engine1, session1.publicState, session1.privateState, 'FREE_SPINS', 1.0);
+            expect(debug1.success).toBe(true);
+            const bonus1 = debug1.privateState.pendingBonuses[0];
+            const result1 = await (0, test_engine_factory_1.startBonusRound)(engine1, debug1.publicState, debug1.privateState, bonus1.bonusType, 1.0);
+            expect(result1.success).toBe(true);
+            // Test at bet 5.0
+            const engine2 = (0, test_engine_factory_1.createEngine)();
+            const session2 = await (0, test_engine_factory_1.initSession)(engine2, 5.0);
+            const debug2 = await (0, test_engine_factory_1.debugTriggerBonus)(engine2, session2.publicState, session2.privateState, 'FREE_SPINS', 5.0);
+            expect(debug2.success).toBe(true);
+            const bonus2 = debug2.privateState.pendingBonuses[0];
+            const result2 = await (0, test_engine_factory_1.startBonusRound)(engine2, debug2.publicState, debug2.privateState, bonus2.bonusType, 5.0);
+            expect(result2.success).toBe(true);
+        });
+    });
+    describe('Multiplier Application in Free Spins', () => {
+        it('should apply booster multiplier to wins', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            // Set higher booster level for visible multiplier effect
+            const modifiedPrivate = {
+                ...session.privateState,
+                boosterLevel: 5,
+                boosterMemory: 5,
+            };
+            const modifiedPublic = {
+                ...session.publicState,
+                boosterLevel: 5,
+            };
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, modifiedPublic, modifiedPrivate, 'FREE_SPINS');
+            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);
+        });
+        it('should handle booster level progression during 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, 'FREE_SPINS');
+            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);
+            if (bonusResult.outcome) {
+                const outcomes = Array.isArray(bonusResult.outcome)
+                    ? bonusResult.outcome
+                    : [bonusResult.outcome];
+                for (const o of outcomes) {
+                    if (o.boosterLevel !== undefined) {
+                        expect(o.boosterLevel).toBeGreaterThanOrEqual(0);
+                        expect(o.boosterLevel).toBeLessThanOrEqual(9);
+                    }
+                }
+            }
+        });
+        it('should cap booster level at 9 during free spins', async () => {
+            const engine = (0, test_engine_factory_1.createEngine)();
+            const session = await (0, test_engine_factory_1.initSession)(engine);
+            // Start at max level
+            const modifiedPrivate = {
+                ...session.privateState,
+                boosterLevel: 9,
+                boosterMemory: 9,
+            };
+            const modifiedPublic = {
+                ...session.publicState,
+                boosterLevel: 9,
+            };
+            const debugResult = await (0, test_engine_factory_1.debugTriggerBonus)(engine, modifiedPublic, modifiedPrivate, 'FREE_SPINS');
+            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);
+            if (bonusResult.outcome) {
+                const outcomes = Array.isArray(bonusResult.outcome)
+                    ? bonusResult.outcome
+                    : [bonusResult.outcome];
+                for (const o of outcomes) {
+                    if (o.boosterLevel !== undefined) {
+                        expect(o.boosterLevel).toBeLessThanOrEqual(9);
+                    }
+                }
+            }
+        });
+    });
+    describe('RNG Outcome Tracking', () => {
+        it('should include RNG outcome for 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, 'FREE_SPINS');
+            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.rngOutcome).toBeDefined();
+        });
+        it('should produce valid RNG outcome structure', 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, 'FREE_SPINS');
+            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);
+            if (bonusResult.rngOutcome) {
+                const validation = (0, test_engine_factory_1.validateRngOutcome)(bonusResult.rngOutcome);
+                expect(validation.valid).toBe(true);
+            }
+        });
+    });
+    describe('Deterministic Testing with Mock RNG', () => {
+        it('should produce deterministic results with same mock values', async () => {
+            const mockValues = Array(100).fill(50);
+            const { engine: engine1 } = (0, test_engine_factory_1.createEngineWithMockRng)(mockValues);
+            const { engine: engine2 } = (0, test_engine_factory_1.createEngineWithMockRng)(mockValues);
+            const session1 = await (0, test_engine_factory_1.initSession)(engine1);
+            const session2 = await (0, test_engine_factory_1.initSession)(engine2);
+            const debug1 = await (0, test_engine_factory_1.debugTriggerBonus)(engine1, session1.publicState, session1.privateState, 'FREE_SPINS');
+            const debug2 = await (0, test_engine_factory_1.debugTriggerBonus)(engine2, session2.publicState, session2.privateState, 'FREE_SPINS');
+            expect(debug1.success).toBe(true);
+            expect(debug2.success).toBe(true);
+        });
+        it('should handle LCG RNG for reproducible simulations', async () => {
+            const { engine, lcgRng } = (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, 'FREE_SPINS');
+            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);
+        });
+    });
+});
+//# sourceMappingURL=free-spins-handler.test.js.map

package/dist/__tests__/free-spins-handler.test.js.map

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

package/dist/__tests__/helpers/test-engine-factory.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Lucky Sharky Test Engine Factory.
+ * Creates engine instances with controllable RNG for deterministic testing.
+ *
+ * Mock injection strategy:
+ *   The engine, gameLogic, and all handlers share a SINGLE RngService instance.
+ *   We replace the `rngClient` on that shared instance so all RNG calls go
+ *   through our mock — no need to rebuild gameLogic or handlers.
+ */
+import { LuckySharkyV1GameEngine } from '../../lucky-sharky-v1.game-engine';
+import { MockRngClient, LcgRngClient } from '@omnitronix/game-test-utils';
+export { MockRngClient, LcgRngClient, nextCommandId, resetCommandIdCounter, getCommandIdCounter, canonicalizeRngOutcome, hashRngOutcome, hashString, isValidSha256, validateRngOutcome, validateRngOutcomeRecord, serializeState, deserializeState, cloneState, statesEqual, roundTripState, diffStates, } from '@omnitronix/game-test-utils';
+/**
+ * Create a standard engine with default (DummyRngClient) RNG.
+ * Suitable for integration tests that don't need deterministic outcomes.
+ */
+export declare function createEngine(): LuckySharkyV1GameEngine;
+/**
+ * Create an engine with a MockRngClient injected.
+ * Returns both the engine and the mock for test control.
+ *
+ * @param values - Fixed value or sequence of values the mock will return.
+ */
+export declare function createEngineWithMockRng(values?: number[] | number): {
+    engine: LuckySharkyV1GameEngine;
+    mockRng: MockRngClient;
+};
+/**
+ * Create an engine with an LCG RNG for reproducible simulations.
+ * Same seed always produces the same sequence.
+ *
+ * @param seed - LCG seed (default: 12345)
+ */
+export declare function createEngineWithLcgRng(seed?: number): {
+    engine: LuckySharkyV1GameEngine;
+    lcgRng: LcgRngClient;
+};
+/**
+ * Inject a mock RNG client into an existing engine.
+ * Useful when you need to change mock behavior mid-test.
+ */
+export declare function injectMockRng(engine: LuckySharkyV1GameEngine, mockRng: MockRngClient): void;
+/**
+ * Wait for the engine's async preload() to finish.
+ * The engine constructor fires preload() without await (fire-and-forget).
+ * We poll for `engine.reels` to be defined before proceeding.
+ */
+export declare function waitForEngineReady(engine: any, timeout?: number): Promise<void>;
+export interface SessionState {
+    publicState: any;
+    privateState: any;
+}
+/**
+ * Initialize a session on the engine.
+ * Returns the public and private state for subsequent commands.
+ * Waits for engine preload to complete before issuing any commands.
+ */
+export declare function initSession(engine: LuckySharkyV1GameEngine, betAmount?: number, betAmountThresholds?: number[]): Promise<SessionState>;
+/**
+ * Execute a SPIN command and return the full result.
+ */
+export declare function executeSpin(engine: LuckySharkyV1GameEngine, publicState: any, privateState: any, betAmount?: number): Promise<any>;
+/**
+ * Execute a SPIN command with error handling for known engine bugs.
+ * Returns null if a known bug is encountered, allowing tests to skip bad spins.
+ */
+export declare function safeExecuteSpin(engine: LuckySharkyV1GameEngine, publicState: any, privateState: any, betAmount?: number): Promise<any | null>;
+/**
+ * Execute multiple spins, threading state through each one.
+ * Returns an array of all results.
+ */
+export declare function executeSpins(engine: LuckySharkyV1GameEngine, publicState: any, privateState: any, count: number, betAmount?: number): Promise<any[]>;
+/**
+ * Start a bonus round.
+ */
+export declare function startBonusRound(engine: LuckySharkyV1GameEngine, publicState: any, privateState: any, bonusType?: string, betAmount?: number): Promise<any>;
+/**
+ * Trigger a debug bonus.
+ */
+export declare function debugTriggerBonus(engine: LuckySharkyV1GameEngine, publicState: any, privateState: any, bonusType?: string, betAmount?: number): Promise<any>;
+/**
+ * Get the rngOutcome from the engine's RNG service for a specific command.
+ */
+export declare function getRngOutcome(engine: LuckySharkyV1GameEngine, commandId: string): any;
+/**
+ * Get all RNG outcomes currently tracked by the engine.
+ */
+export declare function getAllRngOutcomes(engine: LuckySharkyV1GameEngine): any;
+/**
+ * Run a full init + N spins cycle. Convenience for RTP simulations.
+ * Returns { results, finalPublicState, finalPrivateState }.
+ */
+export declare function runSpinCycle(engine: LuckySharkyV1GameEngine, spinCount: number, betAmount?: number): Promise<{
+    results: any[];
+    finalPublicState: any;
+    finalPrivateState: any;
+}>;
+//# sourceMappingURL=test-engine-factory.d.ts.map

package/dist/__tests__/helpers/test-engine-factory.d.ts.map

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