@omnitronix/happy-panda-game-engine 0.5.1

package/dist/engine/happy-panda-engine.js

@@ -0,0 +1,324 @@
+"use strict";
+/**
+ * Happy Panda Game Engine
+ *
+ * Main engine class that provides the public API for the game.
+ * Implements the command pattern used by other Omnitronix game engines.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HappyPandaEngine = void 0;
+const types_1 = require("../domain/types");
+const happy_panda_config_1 = require("../config/happy-panda.config");
+const spin_handler_1 = require("../logic/handlers/spin-handler");
+const counter_manager_1 = require("../logic/services/counter-manager");
+// =============================================================================
+// ENGINE CLASS
+// =============================================================================
+class HappyPandaEngine {
+    constructor(rngProvider) {
+        this.rng = rngProvider;
+    }
+    // ===========================================================================
+    // COMMAND HANDLING
+    // ===========================================================================
+    /**
+     * Handle a game command.
+     */
+    async handleCommand(command, currentState) {
+        switch (command.command) {
+            case types_1.CommandType.INIT_SESSION_STATE:
+                return this.handleInitSession(command);
+            case types_1.CommandType.SPIN:
+                if (!currentState) {
+                    throw new Error('No session state for SPIN command');
+                }
+                return this.handleSpin(currentState);
+            case types_1.CommandType.GET_SYMBOLS:
+                return this.handleGetSymbols(currentState);
+            default:
+                throw new Error(`Unknown command: ${command.command}`);
+        }
+    }
+    // ===========================================================================
+    // INIT SESSION
+    // ===========================================================================
+    async handleInitSession(request) {
+        const gameState = (0, spin_handler_1.createInitialState)(request.gameDirection, request.betStake);
+        const sessionState = this.createSessionState(request.sessionId, gameState);
+        const publicState = this.extractPublicState(gameState);
+        return {
+            response: publicState,
+            state: sessionState,
+        };
+    }
+    // ===========================================================================
+    // SPIN
+    // ===========================================================================
+    async handleSpin(currentSession) {
+        const gameState = this.reconstructGameState(currentSession);
+        // Execute spin
+        const result = await (0, spin_handler_1.executeSpin)(gameState, this.rng);
+        // Build triggered bonus info if a bonus was triggered
+        let triggeredBonus;
+        if (result.bonusTriggered !== null) {
+            triggeredBonus = {
+                bonusId: `bonus-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`,
+                bonusType: this.spinTypeToBonusType(result.bonusTriggered),
+                betAmount: gameState.betGame,
+            };
+        }
+        // Build response
+        const executedType = result.executedSpinType;
+        const nextType = result.state.nextSpinType;
+        const response = {
+            // Game-specific fields
+            spinType: executedType,
+            screen: result.screen,
+            wins: result.wins,
+            jackpotWon: result.jackpotWon,
+            poolJackpotWon: result.poolJackpotWon,
+            triggeredBonus,
+            isBonusComplete: result.isBonusComplete,
+            playerWinning: result.playerWinning,
+            nextSpinType: nextType,
+            // BaseOutcome standardized fields
+            actionType: executedType,
+            nextActionType: nextType,
+            roundPhase: executedType === happy_panda_config_1.SpinType.BASE_GAME_SPIN ? 'BASE' : 'BONUS',
+            isRoundComplete: result.isBonusComplete,
+        };
+        // Update session state
+        const newSession = this.createSessionState(currentSession.sessionId, result.state);
+        return {
+            response,
+            state: newSession,
+        };
+    }
+    // ===========================================================================
+    // GET SYMBOLS
+    // ===========================================================================
+    async handleGetSymbols(currentSession) {
+        // Return symbol definitions
+        const symbols = Object.entries(happy_panda_config_1.Symbol)
+            .filter(([key]) => isNaN(Number(key)))
+            .map(([name, value]) => ({ name, value }));
+        return {
+            response: { symbols },
+            state: currentSession || this.createEmptySession(),
+        };
+    }
+    // ===========================================================================
+    // STATE MANAGEMENT
+    // ===========================================================================
+    /**
+     * Extract public state from game state.
+     */
+    extractPublicState(state) {
+        return {
+            gameDirection: state.gameDirection,
+            betStake: state.betStake,
+            betGame: state.betGame,
+            currentSpinType: state.currentSpinType,
+            spinsRemaining: state.spinsRemaining,
+            screen: state.screen,
+            bonusJackpotValue: state.jackpots.bonusJackpotValue,
+            poolJackpotValue: state.jackpots.poolJackpotValue,
+            hasPendingBonus: (0, counter_manager_1.hasPendingBonus)(state.pendingBonuses),
+            additionalData: {
+                counters: state.counters,
+            },
+        };
+    }
+    /**
+     * Extract private state from game state.
+     * Converts internal counter-based pendingBonuses to RGS-compatible array format.
+     */
+    extractPrivateState(state) {
+        // Convert counter-based pending bonuses to RGS-compatible array format
+        const pendingBonusesArray = this.convertPendingBonusesToArray(state.pendingBonuses, state.betGame);
+        // Determine if there's an active bonus (currently in a bonus round)
+        let activeBonus;
+        if (state.currentSpinType !== happy_panda_config_1.SpinType.BASE_GAME_SPIN && state.spinsRemaining > 0) {
+            activeBonus = {
+                bonusId: `active-${state.currentSpinType}-${Date.now()}`,
+                bonusType: this.spinTypeToBonusType(state.currentSpinType),
+                betAmount: state.betGame,
+            };
+        }
+        return {
+            counters: state.counters,
+            internalPendingBonuses: state.pendingBonuses,
+            nextSpinType: state.nextSpinType,
+            accumulatedBonusWins: state.accumulatedBonusWins,
+            centerBambooSymbol: state.centerBambooSymbol,
+            pendingBonuses: pendingBonusesArray,
+            activeBonus,
+        };
+    }
+    /**
+     * Convert counter-based pending bonuses to RGS-compatible array format.
+     */
+    convertPendingBonusesToArray(pending, betAmount) {
+        const bonuses = [];
+        const timestamp = Date.now();
+        // Add bonuses in priority order (bambooTriplets > bambooTwins > camera > fireworks > centerBamboo)
+        for (let i = 0; i < pending.bambooTriplets; i++) {
+            bonuses.push({
+                bonusId: `pending-bambooTriplets-${timestamp}-${i}`,
+                bonusType: 'BONUS_BAMBOO_TRIPLETS',
+                betAmount,
+            });
+        }
+        for (let i = 0; i < pending.bambooTwins; i++) {
+            bonuses.push({
+                bonusId: `pending-bambooTwins-${timestamp}-${i}`,
+                bonusType: 'BONUS_BAMBOO_TWINS',
+                betAmount,
+            });
+        }
+        for (let i = 0; i < pending.camera; i++) {
+            bonuses.push({
+                bonusId: `pending-camera-${timestamp}-${i}`,
+                bonusType: 'BONUS_CAMERA',
+                betAmount,
+            });
+        }
+        for (let i = 0; i < pending.fireworks; i++) {
+            bonuses.push({
+                bonusId: `pending-fireworks-${timestamp}-${i}`,
+                bonusType: 'BONUS_FIREWORKS',
+                betAmount,
+            });
+        }
+        for (let i = 0; i < pending.centerBamboo; i++) {
+            bonuses.push({
+                bonusId: `pending-centerBamboo-${timestamp}-${i}`,
+                bonusType: 'RESPIN_CENTER_BAMBOO',
+                betAmount,
+            });
+        }
+        return bonuses;
+    }
+    /**
+     * Convert SpinType to bonus type string for RGS.
+     * Now that SpinType is a string enum, this is a simple cast.
+     */
+    spinTypeToBonusType(spinType) {
+        return spinType;
+    }
+    /**
+     * Create session state from game state.
+     */
+    createSessionState(sessionId, state) {
+        return {
+            sessionId,
+            publicState: this.extractPublicState(state),
+            privateState: this.extractPrivateState(state),
+            createdAt: new Date(),
+            updatedAt: new Date(),
+        };
+    }
+    /**
+     * Reconstruct game state from session state.
+     */
+    reconstructGameState(session) {
+        const pub = session.publicState;
+        const priv = session.privateState;
+        // Use internalPendingBonuses (counter format) for game logic
+        // Fall back to converting from array format if internalPendingBonuses is not present (legacy state)
+        const pendingBonuses = priv.internalPendingBonuses ??
+            this.convertArrayToPendingBonuses(priv.pendingBonuses);
+        return {
+            gameDirection: pub.gameDirection,
+            betStake: pub.betStake,
+            betGame: pub.betGame,
+            currentSpinType: pub.currentSpinType,
+            nextSpinType: priv.nextSpinType,
+            spinsRemaining: pub.spinsRemaining,
+            counters: priv.counters,
+            pendingBonuses,
+            jackpots: {
+                bonusJackpotValue: pub.bonusJackpotValue,
+                poolJackpotValue: pub.poolJackpotValue,
+            },
+            screen: pub.screen,
+            accumulatedBonusWins: priv.accumulatedBonusWins,
+            centerBambooSymbol: priv.centerBambooSymbol,
+        };
+    }
+    /**
+     * Convert RGS-compatible array back to counter-based format (for legacy state compatibility).
+     */
+    convertArrayToPendingBonuses(bonuses) {
+        const result = {
+            bambooTriplets: 0,
+            bambooTwins: 0,
+            camera: 0,
+            fireworks: 0,
+            centerBamboo: 0,
+        };
+        if (!bonuses || !Array.isArray(bonuses)) {
+            return result;
+        }
+        for (const bonus of bonuses) {
+            switch (bonus.bonusType) {
+                case 'BONUS_BAMBOO_TRIPLETS':
+                    result.bambooTriplets++;
+                    break;
+                case 'BONUS_BAMBOO_TWINS':
+                    result.bambooTwins++;
+                    break;
+                case 'BONUS_CAMERA':
+                    result.camera++;
+                    break;
+                case 'BONUS_FIREWORKS':
+                    result.fireworks++;
+                    break;
+                case 'RESPIN_CENTER_BAMBOO':
+                    result.centerBamboo++;
+                    break;
+            }
+        }
+        return result;
+    }
+    /**
+     * Create empty session for commands that don't need state.
+     */
+    createEmptySession() {
+        return {
+            sessionId: '',
+            publicState: this.extractPublicState((0, spin_handler_1.createInitialState)(types_1.GameDirection.SINGLE, 1)),
+            privateState: {
+                counters: { bambooTriplets: 1, bambooTwins: 9, camera: 5, fireworks: 1 },
+                internalPendingBonuses: { bambooTriplets: 0, bambooTwins: 0, camera: 0, fireworks: 0, centerBamboo: 0 },
+                nextSpinType: happy_panda_config_1.SpinType.BASE_GAME_SPIN,
+                accumulatedBonusWins: 0,
+                centerBambooSymbol: null,
+                pendingBonuses: [],
+                activeBonus: undefined,
+            },
+            createdAt: new Date(),
+            updatedAt: new Date(),
+        };
+    }
+    // ===========================================================================
+    // UTILITY METHODS
+    // ===========================================================================
+    /**
+     * Update bet settings (only when no bonus pending).
+     */
+    updateBet(session, gameDirection, betStake) {
+        const gameState = this.reconstructGameState(session);
+        const updatedState = (0, spin_handler_1.updateBet)(gameState, gameDirection, betStake);
+        return this.createSessionState(session.sessionId, updatedState);
+    }
+    /**
+     * Check if player can change bet.
+     */
+    canChangeBet(session) {
+        return (session.publicState.currentSpinType === happy_panda_config_1.SpinType.BASE_GAME_SPIN &&
+            !session.publicState.hasPendingBonus);
+    }
+}
+exports.HappyPandaEngine = HappyPandaEngine;
+//# sourceMappingURL=happy-panda-engine.js.map

package/dist/engine/happy-panda-engine.js.map

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

package/dist/engine/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Engine module exports
+ */
+export * from './happy-panda-engine';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,sBAAsB,CAAC"}

package/dist/engine/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Engine module exports
+ */
+__exportStar(require("./happy-panda-engine"), exports);
+//# sourceMappingURL=index.js.map

package/dist/engine/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;GAEG;AACH,uDAAqC"}

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

@@ -0,0 +1,19 @@
+/**
+ * Game Engine Interface Types
+ *
+ * Re-exports types from @omnitronix/game-engine-contract for use by consumers.
+ * Defines Happy Panda-specific configuration types.
+ */
+import type { ILogger as ILoggerType } from '@omnitronix/game-engine-contract';
+export { GameEngine, GameEngineInfo, } from '@omnitronix/game-engine-contract';
+export { GameActionCommand, CommandProcessingResult, } from '@omnitronix/game-engine-contract';
+export { RngOutcome, RngOutcomeRecord, } from '@omnitronix/game-engine-contract';
+export { ILogger } from '@omnitronix/game-engine-contract';
+/**
+ * Configuration options for HappyPandaV1GameEngine
+ */
+export interface HappyPandaV1GameEngineConfig {
+    logger?: ILoggerType;
+    metrics?: unknown;
+}
+//# sourceMappingURL=game-engine.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"game-engine.interface.d.ts","sourceRoot":"","sources":["../src/game-engine.interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAG/E,OAAO,EACL,UAAU,EACV,cAAc,GACf,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,UAAU,EACV,gBAAgB,GACjB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/game-engine.interface.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Game Engine Interface Types
+ *
+ * Re-exports types from @omnitronix/game-engine-contract for use by consumers.
+ * Defines Happy Panda-specific configuration types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=game-engine.interface.js.map

package/dist/game-engine.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-engine.interface.js","sourceRoot":"","sources":["../src/game-engine.interface.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/happy-panda-v1.game-engine.d.ts

@@ -0,0 +1,60 @@
+/**
+ * HappyPandaV1GameEngine
+ *
+ * Wrapper class that adapts HappyPandaEngine to the standard GameEngine interface
+ * expected by the game-engine-service infrastructure.
+ *
+ * Uses the proper RNG infrastructure matching Heroes of Aether and Bonny's Fortune:
+ * - RngClientFactory for environment-based client selection
+ * - RngService for audit trail tracking
+ * - Full RNG outcome reporting for compliance
+ */
+import { DebugIntrospectable, DebugCommandDefinition } from '@omnitronix/game-engine-contract';
+import { SlotGameHandler, BetConfig as SdkBetConfig, SlotState as SdkSlotState, SpinResult as SdkSpinResult, BonusTrigger as SdkBonusTrigger, BonusResult as SdkBonusResult, GameTypeConfig } from '@omnitronix/game-engine-sdk';
+import { PublicState, PrivateState } from './domain/types';
+import { GameEngine, GameEngineInfo, GameActionCommand, CommandProcessingResult, HappyPandaV1GameEngineConfig, RngOutcome, RngOutcomeRecord } from './game-engine.interface';
+export type { GameEngine, GameEngineInfo, GameActionCommand, CommandProcessingResult, HappyPandaV1GameEngineConfig, RngOutcome, RngOutcomeRecord, };
+/**
+ * Happy Panda V1 Game Engine
+ *
+ * Implements the standard GameEngine interface for use with game-engine-service.
+ * Uses proper RNG infrastructure with full audit trail support.
+ */
+export declare class HappyPandaV1GameEngine extends SlotGameHandler implements GameEngine<PublicState, PrivateState, unknown>, DebugIntrospectable {
+    /**
+     * SDK GameTypeConfig declaration.
+     *
+     * Declares this engine as a slot game with immediate result delivery
+     * and token-encoded state management.
+     */
+    static readonly gameTypeConfig: GameTypeConfig;
+    private readonly gameCode;
+    private readonly version;
+    private readonly rtp;
+    private readonly gameType;
+    private readonly gameName;
+    private readonly provider;
+    private readonly rngService;
+    private readonly rngAdapter;
+    private readonly engine;
+    constructor(config?: HappyPandaV1GameEngineConfig);
+    /**
+     * Implements SlotGameHandler.spin().
+     *
+     * Delegates to the internal HappyPandaEngine SPIN command and maps
+     * the result to the SDK SpinResult contract.
+     */
+    spin(bet: SdkBetConfig, state: SdkSlotState): Promise<SdkSpinResult>;
+    /**
+     * Implements SlotGameHandler.startBonus().
+     *
+     * Delegates to the internal HappyPandaEngine by executing all bonus
+     * spins in a loop (precomputed-queue strategy) and returns a
+     * BonusResult with attached delivery strategy metadata.
+     */
+    startBonus(trigger: SdkBonusTrigger, state: SdkSlotState): Promise<SdkBonusResult>;
+    getGameEngineInfo(): GameEngineInfo;
+    getDebugCommandDefinitions(): DebugCommandDefinition[];
+    processCommand(publicState: PublicState | null, privateState: PrivateState | null, command: GameActionCommand): Promise<CommandProcessingResult<PublicState, PrivateState, unknown>>;
+}
+//# sourceMappingURL=happy-panda-v1.game-engine.d.ts.map

package/dist/happy-panda-v1.game-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"happy-panda-v1.game-engine.d.ts","sourceRoot":"","sources":["../src/happy-panda-v1.game-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAEL,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,eAAe,EACf,SAAS,IAAI,YAAY,EACzB,SAAS,IAAI,YAAY,EACzB,UAAU,IAAI,aAAa,EAC3B,YAAY,IAAI,eAAe,EAC/B,WAAW,IAAI,cAAc,EAC7B,cAAc,EAGf,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAGL,WAAW,EACX,YAAY,EAKb,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EACL,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,4BAA4B,EAC5B,UAAU,EACV,gBAAgB,EACjB,MAAM,yBAAyB,CAAC;AAGjC,YAAY,EACV,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,4BAA4B,EAC5B,UAAU,EACV,gBAAgB,GACjB,CAAC;AAuCF;;;;;GAKG;AACH,qBAAa,sBACX,SAAQ,eACR,YAAW,UAAU,CAAC,WAAW,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,mBAAmB;IAE9E;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAW5C;IAEF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IAEzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;gBAE9B,MAAM,GAAE,4BAAiC;IAkBrD;;;;;OAKG;IACG,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IA4C1E;;;;;;OAMG;IACG,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IAsEjF,iBAAiB,IAAI,cAAc;IAWnC,0BAA0B,IAAI,sBAAsB,EAAE;IAIhD,cAAc,CACzB,WAAW,EAAE,WAAW,GAAG,IAAI,EAC/B,YAAY,EAAE,YAAY,GAAG,IAAI,EACjC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,uBAAuB,CAAC,WAAW,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;CAkXxE"}