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

package/dist/__tests__/helpers/test-engine-factory.js

@@ -0,0 +1,236 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.diffStates = exports.roundTripState = exports.statesEqual = exports.cloneState = exports.deserializeState = exports.serializeState = exports.validateRngOutcomeRecord = exports.validateRngOutcome = exports.isValidSha256 = exports.hashString = exports.hashRngOutcome = exports.canonicalizeRngOutcome = exports.getCommandIdCounter = exports.resetCommandIdCounter = exports.nextCommandId = exports.LcgRngClient = exports.MockRngClient = void 0;
+exports.createEngine = createEngine;
+exports.createEngineWithMockRng = createEngineWithMockRng;
+exports.createEngineWithLcgRng = createEngineWithLcgRng;
+exports.injectMockRng = injectMockRng;
+exports.waitForEngineReady = waitForEngineReady;
+exports.initSession = initSession;
+exports.executeSpin = executeSpin;
+exports.safeExecuteSpin = safeExecuteSpin;
+exports.executeSpins = executeSpins;
+exports.startBonusRound = startBonusRound;
+exports.debugTriggerBonus = debugTriggerBonus;
+exports.getRngOutcome = getRngOutcome;
+exports.getAllRngOutcomes = getAllRngOutcomes;
+exports.runSpinCycle = runSpinCycle;
+/**
+ * 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.
+ */
+const lucky_sharky_v1_game_engine_1 = require("../../lucky-sharky-v1.game-engine");
+// Import from shared test utilities package
+const game_test_utils_1 = require("@omnitronix/game-test-utils");
+// Re-export for convenience (from shared package)
+var game_test_utils_2 = require("@omnitronix/game-test-utils");
+Object.defineProperty(exports, "MockRngClient", { enumerable: true, get: function () { return game_test_utils_2.MockRngClient; } });
+Object.defineProperty(exports, "LcgRngClient", { enumerable: true, get: function () { return game_test_utils_2.LcgRngClient; } });
+Object.defineProperty(exports, "nextCommandId", { enumerable: true, get: function () { return game_test_utils_2.nextCommandId; } });
+Object.defineProperty(exports, "resetCommandIdCounter", { enumerable: true, get: function () { return game_test_utils_2.resetCommandIdCounter; } });
+Object.defineProperty(exports, "getCommandIdCounter", { enumerable: true, get: function () { return game_test_utils_2.getCommandIdCounter; } });
+Object.defineProperty(exports, "canonicalizeRngOutcome", { enumerable: true, get: function () { return game_test_utils_2.canonicalizeRngOutcome; } });
+Object.defineProperty(exports, "hashRngOutcome", { enumerable: true, get: function () { return game_test_utils_2.hashRngOutcome; } });
+Object.defineProperty(exports, "hashString", { enumerable: true, get: function () { return game_test_utils_2.hashString; } });
+Object.defineProperty(exports, "isValidSha256", { enumerable: true, get: function () { return game_test_utils_2.isValidSha256; } });
+Object.defineProperty(exports, "validateRngOutcome", { enumerable: true, get: function () { return game_test_utils_2.validateRngOutcome; } });
+Object.defineProperty(exports, "validateRngOutcomeRecord", { enumerable: true, get: function () { return game_test_utils_2.validateRngOutcomeRecord; } });
+Object.defineProperty(exports, "serializeState", { enumerable: true, get: function () { return game_test_utils_2.serializeState; } });
+Object.defineProperty(exports, "deserializeState", { enumerable: true, get: function () { return game_test_utils_2.deserializeState; } });
+Object.defineProperty(exports, "cloneState", { enumerable: true, get: function () { return game_test_utils_2.cloneState; } });
+Object.defineProperty(exports, "statesEqual", { enumerable: true, get: function () { return game_test_utils_2.statesEqual; } });
+Object.defineProperty(exports, "roundTripState", { enumerable: true, get: function () { return game_test_utils_2.roundTripState; } });
+Object.defineProperty(exports, "diffStates", { enumerable: true, get: function () { return game_test_utils_2.diffStates; } });
+/**
+ * Create a standard engine with default (DummyRngClient) RNG.
+ * Suitable for integration tests that don't need deterministic outcomes.
+ */
+function createEngine() {
+    return new lucky_sharky_v1_game_engine_1.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.
+ */
+function createEngineWithMockRng(values = 0) {
+    const engine = new lucky_sharky_v1_game_engine_1.LuckySharkyV1GameEngine();
+    const mockRng = new game_test_utils_1.MockRngClient(values);
+    engine.rngService.rngClient = mockRng;
+    return { engine, mockRng };
+}
+/**
+ * Create an engine with an LCG RNG for reproducible simulations.
+ * Same seed always produces the same sequence.
+ *
+ * @param seed - LCG seed (default: 12345)
+ */
+function createEngineWithLcgRng(seed = 12345) {
+    const engine = new lucky_sharky_v1_game_engine_1.LuckySharkyV1GameEngine();
+    const lcgRng = new game_test_utils_1.LcgRngClient(seed);
+    engine.rngService.rngClient = lcgRng;
+    return { engine, lcgRng };
+}
+/**
+ * Inject a mock RNG client into an existing engine.
+ * Useful when you need to change mock behavior mid-test.
+ */
+function injectMockRng(engine, mockRng) {
+    engine.rngService.rngClient = mockRng;
+}
+// ---------------------------------------------------------------------------
+// Engine Readiness
+// ---------------------------------------------------------------------------
+/**
+ * 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.
+ */
+async function waitForEngineReady(engine, timeout = 5000) {
+    const start = Date.now();
+    while (!engine.reels && Date.now() - start < timeout) {
+        await new Promise(resolve => setTimeout(resolve, 10));
+    }
+    if (!engine.reels) {
+        throw new Error('Engine preload did not complete within timeout');
+    }
+}
+/**
+ * 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.
+ */
+async function initSession(engine, betAmount = 1.0, betAmountThresholds = [0.2, 0.4, 1.0, 2.0]) {
+    await waitForEngineReady(engine);
+    const result = await engine.processCommand(null, null, {
+        id: (0, game_test_utils_1.nextCommandId)('init'),
+        type: 'INIT_SESSION_STATE',
+        payload: {
+            betAmountThresholds,
+            defaultBetAmount: betAmount,
+        },
+    });
+    expect(result.success).toBe(true);
+    return {
+        publicState: result.publicState,
+        privateState: result.privateState,
+    };
+}
+/**
+ * Execute a SPIN command and return the full result.
+ */
+async function executeSpin(engine, publicState, privateState, betAmount = 1.0) {
+    const result = await engine.processCommand(publicState, privateState, {
+        id: (0, game_test_utils_1.nextCommandId)('spin'),
+        type: 'SPIN',
+        payload: {
+            sessionId: 'test-session',
+            betAmount,
+            creditsPerLine: 1,
+            gameId: 'lucky-sharky',
+            gameVersion: '1.0.0',
+        },
+    });
+    return result;
+}
+/**
+ * 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.
+ */
+async function safeExecuteSpin(engine, publicState, privateState, betAmount = 1.0) {
+    try {
+        return await executeSpin(engine, publicState, privateState, betAmount);
+    }
+    catch (error) {
+        // Known engine bugs:
+        // 1. Hold-Win handler crashes on certain RNG outputs
+        // 2. DomainException when SPIN issued during bonus state
+        if (error.message?.includes('is not iterable') ||
+            error.message?.includes('Cannot read properties of undefined') ||
+            error.message?.includes('Cannot execute base spin')) {
+            return null;
+        }
+        throw error;
+    }
+}
+/**
+ * Execute multiple spins, threading state through each one.
+ * Returns an array of all results.
+ */
+async function executeSpins(engine, publicState, privateState, count, betAmount = 1.0) {
+    const results = [];
+    let currentPublic = publicState;
+    let currentPrivate = privateState;
+    for (let i = 0; i < count; i++) {
+        const result = await executeSpin(engine, currentPublic, currentPrivate, betAmount);
+        results.push(result);
+        currentPublic = result.publicState;
+        currentPrivate = result.privateState;
+    }
+    return results;
+}
+/**
+ * Start a bonus round.
+ */
+async function startBonusRound(engine, publicState, privateState, bonusType = 'FREE_SPINS', betAmount = 1.0) {
+    const bonusId = privateState.pendingBonuses?.[0]?.bonusId ?? 'test-bonus-id';
+    const result = await engine.processCommand(publicState, privateState, {
+        id: (0, game_test_utils_1.nextCommandId)('bonus'),
+        type: 'START_BONUS_ROUND',
+        payload: {
+            sessionId: 'test-session',
+            bonusId,
+            bonusType,
+            betAmount,
+        },
+    });
+    return result;
+}
+/**
+ * Trigger a debug bonus.
+ */
+async function debugTriggerBonus(engine, publicState, privateState, bonusType = 'FREE_SPINS', betAmount = 1.0) {
+    const result = await engine.processCommand(publicState, privateState, {
+        id: (0, game_test_utils_1.nextCommandId)('debug'),
+        type: 'DEBUG_TRIGGER_BONUS',
+        payload: {
+            sessionId: 'test-session',
+            bonusType,
+            betAmount,
+        },
+    });
+    return result;
+}
+/**
+ * Get the rngOutcome from the engine's RNG service for a specific command.
+ */
+function getRngOutcome(engine, commandId) {
+    return engine.rngService.getRngOutcomeForCommand(commandId);
+}
+/**
+ * Get all RNG outcomes currently tracked by the engine.
+ */
+function getAllRngOutcomes(engine) {
+    return engine.rngService.getAllRngOutcome();
+}
+/**
+ * Run a full init + N spins cycle. Convenience for RTP simulations.
+ * Returns { results, finalPublicState, finalPrivateState }.
+ */
+async function runSpinCycle(engine, spinCount, betAmount = 1.0) {
+    const session = await initSession(engine, betAmount);
+    const results = await executeSpins(engine, session.publicState, session.privateState, spinCount, betAmount);
+    const lastResult = results[results.length - 1];
+    return {
+        results,
+        finalPublicState: lastResult.publicState,
+        finalPrivateState: lastResult.privateState,
+    };
+}
+//# sourceMappingURL=test-engine-factory.js.map

package/dist/__tests__/helpers/test-engine-factory.js.map

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

package/dist/__tests__/hold-win-handler.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hold-win-handler.test.d.ts.map

package/dist/__tests__/hold-win-handler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hold-win-handler.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/hold-win-handler.test.ts"],"names":[],"mappings":""}