@omnitronix/happy-panda-game-engine 0.0.2 → 0.0.4

package/dist/domain/types.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Happy Panda Game Engine - Domain Types
+ *
+ * Core type definitions for game state and spin results.
+ */
+import { Symbol, SpinType, ScreenWinType } from '../config/happy-panda.config';
+/** 3x3 grid indexed by [reel][row] */
+export type Grid = Symbol[][];
+/** Position on the grid */
+export interface Position {
+    reel: number;
+    row: number;
+}
+/** Line win result */
+export interface LineWin {
+    lineIndex: number;
+    symbol: Symbol;
+    matchLength: number;
+    payout: number;
+    positions: Position[];
+}
+/** Wall (3x3) win result */
+export interface WallWin {
+    wallType: ScreenWinType;
+    payout: number;
+    positions: Position[];
+}
+/** Scatter win result (Seven/Super Seven) */
+export interface ScatterWin {
+    symbol: Symbol;
+    count: number;
+    payout: number;
+    positions: Position[];
+    isSuperSevenOnly: boolean;
+}
+/** Special bonus win (cherry pieces, bell scatter, super bar scatter) */
+export interface SpecialWin {
+    winType: ScreenWinType;
+    count: number;
+    payout: number;
+    positions: Position[];
+}
+/** Combined win result for a spin */
+export interface SpinWinResult {
+    lineWins: LineWin[];
+    wallWin: WallWin | null;
+    scatterWins: ScatterWin[];
+    specialWins: SpecialWin[];
+    totalPayout: number;
+}
+/** Bonus counter state */
+export interface BonusCounters {
+    /** Jackpot bonus counter (triggers at 0, resets to 1) */
+    jackpot: number;
+    /** Cherry bonus counter (triggers at 0, resets to 6 or 9) */
+    cherry: number;
+    /** Bell bonus counter (triggers at 0, resets to 3 or 5) */
+    bell: number;
+    /** Bar1 bonus counter (triggers at 0, resets to 1) */
+    bar1: number;
+}
+/** Pending bonus queue */
+export interface PendingBonuses {
+    /** Number of pending jackpot bonuses */
+    jackpot: number;
+    /** Number of pending cherry bonuses */
+    cherry: number;
+    /** Number of pending bell bonuses (each grants 5 spins) */
+    bell: number;
+    /** Number of pending bar1 bonuses (each grants 7 spins) */
+    bar1: number;
+    /** Number of pending center cherry respins */
+    respin: number;
+}
+/** Jackpot state */
+export interface JackpotState {
+    /** Progressive jackpot value (accumulates on losing paid spins) */
+    bonusJackpotValue: number;
+    /** Pool jackpot value (paid when bell bonus triggers) */
+    poolJackpotValue: number;
+}
+/** Game direction/mode */
+export declare enum GameDirection {
+    SINGLE = 0,// 8 lines
+    BOTH = 1
+}
+/** Core game state */
+export interface GameState {
+    /** Game mode (8 or 16 lines) */
+    gameDirection: GameDirection;
+    /** Bet multiplier (line bet) */
+    betStake: number;
+    /** Total bet per spin (8 or 16 x betStake) */
+    betGame: number;
+    /** Current spin type */
+    currentSpinType: SpinType;
+    /** Next spin type (determined after current spin) */
+    nextSpinType: SpinType;
+    /** Remaining spins in current bonus (0 for paid spin) */
+    spinsRemaining: number;
+    /** Bonus counters */
+    counters: BonusCounters;
+    /** Pending bonuses to execute */
+    pendingBonuses: PendingBonuses;
+    /** Jackpot values */
+    jackpots: JackpotState;
+    /** Current grid (3x3) */
+    grid: Grid;
+    /** Accumulated bonus wins (reset when bonus sequence ends) */
+    accumulatedBonusWins: number;
+    /** Center cherry symbol for respin (if active) */
+    centerCherrySymbol: Symbol | null;
+}
+/** State visible to client */
+export interface PublicState {
+    gameDirection: GameDirection;
+    betStake: number;
+    betGame: number;
+    currentSpinType: SpinType;
+    spinsRemaining: number;
+    grid: Grid;
+    bonusJackpotValue: number;
+    poolJackpotValue: number;
+    /** Indicates if a bonus is pending (without revealing which) */
+    hasPendingBonus: boolean;
+}
+/** Server-side only state */
+export interface PrivateState {
+    counters: BonusCounters;
+    pendingBonuses: PendingBonuses;
+    nextSpinType: SpinType;
+    accumulatedBonusWins: number;
+    centerCherrySymbol: Symbol | null;
+}
+/** Spin request from client */
+export interface SpinRequest {
+    /** Session ID */
+    sessionId: string;
+    /** Game direction (8 or 16 lines) */
+    gameDirection: GameDirection;
+    /** Bet multiplier */
+    betStake: number;
+}
+/** Spin response to client */
+export interface SpinResponse {
+    /** Session ID */
+    sessionId: string;
+    /** Resulting grid */
+    grid: Grid;
+    /** Win results */
+    wins: SpinWinResult;
+    /** Updated public state */
+    state: PublicState;
+    /** Jackpot won this spin (if any) */
+    jackpotWon: number;
+    /** Pool jackpot won this spin (if any) */
+    poolJackpotWon: number;
+    /** Bonus type triggered (for animation) */
+    bonusTriggered: SpinType | null;
+    /** Is this the final spin of a bonus sequence */
+    isBonusComplete: boolean;
+}
+/** Full session state (for persistence) */
+export interface SessionState {
+    sessionId: string;
+    publicState: PublicState;
+    privateState: PrivateState;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** RNG interface for dependency injection */
+export interface RngProvider {
+    /** Generate random integer in range [0, max) */
+    random(max: number): Promise<number>;
+    /** Generate multiple random integers */
+    randomBatch(count: number, max: number): Promise<number[]>;
+}
+/** Game command types */
+export declare enum CommandType {
+    INIT_SESSION_STATE = "INIT_SESSION_STATE",
+    SPIN = "SPIN",
+    GET_SYMBOLS = "GET_SYMBOLS"
+}
+/** Command request base */
+export interface CommandRequest {
+    command: CommandType;
+    sessionId: string;
+}
+/** Init session command */
+export interface InitSessionRequest extends CommandRequest {
+    command: CommandType.INIT_SESSION_STATE;
+    gameDirection: GameDirection;
+    betStake: number;
+}
+/** Spin command */
+export interface SpinCommandRequest extends CommandRequest {
+    command: CommandType.SPIN;
+}
+/** Get symbols command */
+export interface GetSymbolsRequest extends CommandRequest {
+    command: CommandType.GET_SYMBOLS;
+}
+/** Union of all commands */
+export type GameCommand = InitSessionRequest | SpinCommandRequest | GetSymbolsRequest;
+//# sourceMappingURL=types.d.ts.map

package/dist/domain/types.d.ts.map

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

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

@@ -0,0 +1,50 @@
+/**
+ * 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.
+ */
+import { GameDirection, SessionState, RngProvider, GameCommand } from '../domain/types';
+export declare class HappyPandaEngine {
+    private rng;
+    constructor(rngProvider: RngProvider);
+    /**
+     * Handle a game command.
+     */
+    handleCommand(command: GameCommand, currentState?: SessionState): Promise<{
+        response: unknown;
+        state: SessionState;
+    }>;
+    private handleInitSession;
+    private handleSpin;
+    private handleGetSymbols;
+    /**
+     * Extract public state from game state.
+     */
+    private extractPublicState;
+    /**
+     * Extract private state from game state.
+     */
+    private extractPrivateState;
+    /**
+     * Create session state from game state.
+     */
+    private createSessionState;
+    /**
+     * Reconstruct game state from session state.
+     */
+    private reconstructGameState;
+    /**
+     * Create empty session for commands that don't need state.
+     */
+    private createEmptySession;
+    /**
+     * Update bet settings (only when no bonus pending).
+     */
+    updateBet(session: SessionState, gameDirection: GameDirection, betStake: number): SessionState;
+    /**
+     * Check if player can change bet.
+     */
+    canChangeBet(session: SessionState): boolean;
+}
+//# sourceMappingURL=happy-panda-engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"happy-panda-engine.d.ts","sourceRoot":"","sources":["../../src/engine/happy-panda-engine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,aAAa,EAGb,YAAY,EACZ,WAAW,EAEX,WAAW,EAIZ,MAAM,iBAAiB,CAAC;AAczB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,GAAG,CAAc;gBAEb,WAAW,EAAE,WAAW;IAQpC;;OAEG;IACG,aAAa,CACjB,OAAO,EAAE,WAAW,EACpB,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE,CAAC;YAuBxC,iBAAiB;YAiBjB,UAAU;YAiCV,gBAAgB;IAkB9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAuB5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoB1B;;OAEG;IACH,SAAS,CACP,OAAO,EAAE,YAAY,EACrB,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,MAAM,GACf,YAAY;IAMf;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;CAM7C"}

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/happy-panda-v1.game-engine.d.ts

@@ -0,0 +1,63 @@
+/**
+ * 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 { PublicState, PrivateState } from './domain/types';
+import { RngOutcome, RngOutcomeRecord } from './rng/rng-service';
+export { RngOutcome, RngOutcomeRecord };
+export interface GameEngineInfo {
+    gameCode: string;
+    version: string;
+    rtp: number;
+    gameType: string;
+    gameName: string;
+    provider: string;
+}
+export interface CommandProcessingResult<TPublicState = unknown, TPrivateState = unknown, TOutcome = unknown> {
+    success: boolean;
+    publicState: TPublicState;
+    privateState: TPrivateState;
+    outcome?: TOutcome;
+    message?: string;
+    rngOutcome?: RngOutcome;
+}
+export interface GameActionCommand<TPayload = unknown> {
+    id: string;
+    type: string;
+    payload?: TPayload;
+}
+export interface GameEngine<TPublicState = unknown, TPrivateState = unknown, TOutcome = unknown> {
+    processCommand(publicState: TPublicState, privateState: TPrivateState, command: GameActionCommand): Promise<CommandProcessingResult<TPublicState, TPrivateState, TOutcome>>;
+    getGameEngineInfo(): GameEngineInfo;
+}
+export interface HappyPandaV1GameEngineConfig {
+    metrics?: unknown;
+}
+/**
+ * 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 implements GameEngine<PublicState, PrivateState, unknown> {
+    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);
+    getGameEngineInfo(): GameEngineInfo;
+    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;AAGH,OAAO,EAGL,WAAW,EACX,YAAY,EAGb,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAc,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG7E,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC;AAGxC,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB,CACtC,YAAY,GAAG,OAAO,EACtB,aAAa,GAAG,OAAO,EACvB,QAAQ,GAAG,OAAO;IAElB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,YAAY,CAAC;IAC1B,YAAY,EAAE,aAAa,CAAC;IAC5B,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB,CAAC,QAAQ,GAAG,OAAO;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,QAAQ,CAAC;CACpB;AAED,MAAM,WAAW,UAAU,CACzB,YAAY,GAAG,OAAO,EACtB,aAAa,GAAG,OAAO,EACvB,QAAQ,GAAG,OAAO;IAElB,cAAc,CACZ,WAAW,EAAE,YAAY,EACzB,YAAY,EAAE,aAAa,EAC3B,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,uBAAuB,CAAC,YAAY,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE3E,iBAAiB,IAAI,cAAc,CAAC;CACrC;AAoCD,MAAM,WAAW,4BAA4B;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,qBAAa,sBACX,YAAW,UAAU,CAAC,WAAW,EAAE,YAAY,EAAE,OAAO,CAAC;IAEzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAW;IACnC,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;IAc9C,iBAAiB,IAAI,cAAc;IAW7B,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;CAmHxE"}

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

@@ -4,36 +4,35 @@
  *
  * 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
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HappyPandaV1GameEngine = void 0;
 const happy_panda_engine_1 = require("./engine/happy-panda-engine");
 const types_1 = require("./domain/types");
+const rng_client_factory_1 = require("./rng/rng-client.factory");
+const rng_service_1 = require("./rng/rng-service");
 /**
- * RNG adapter that tracks outcomes for the game engine service
+ * RNG Provider adapter that bridges RngService to the engine's RngProvider interface
  */
-class TrackedRngProvider {
-    constructor() {
-        this.outcomes = new Map();
+class RngServiceAdapter {
+    constructor(rngService) {
+        this.rngService = rngService;
         this.currentCommandId = '';
-        this.seedCounter = 0;
+        this.actionCounter = 0;
     }
     setCommandId(commandId) {
         this.currentCommandId = commandId;
-        if (!this.outcomes.has(commandId)) {
-            this.outcomes.set(commandId, []);
-        }
+        this.actionCounter = 0;
     }
     async random(max) {
-        const result = Math.floor(Math.random() * max);
-        const record = {
-            result,
-            seed: this.seedCounter++,
-            min: 0,
-            max: max - 1,
-        };
-        this.outcomes.get(this.currentCommandId)?.push(record);
-        return result;
+        const actionId = `rng_${this.actionCounter++}`;
+        const { value } = await this.rngService.getSingleNumber(0, max - 1, this.currentCommandId, actionId);
+        return value;
     }
     async randomBatch(count, max) {
         const results = [];
@@ -42,33 +41,29 @@ class TrackedRngProvider {
         }
         return results;
     }
-    getOutcomes(commandId) {
-        const records = this.outcomes.get(commandId) || [];
-        const outcome = {};
-        records.forEach((record, index) => {
-            outcome[`rng_${index}`] = record;
-        });
-        return outcome;
-    }
-    clearOutcomes(commandId) {
-        this.outcomes.delete(commandId);
-    }
 }
 /**
  * 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.
  */
 class HappyPandaV1GameEngine {
-    constructor() {
+    constructor(config = {}) {
         this.gameCode = 'happy-panda';
         this.version = '1.0.0';
         this.rtp = 96.05;
         this.gameType = 'slot';
         this.gameName = 'Happy Panda';
         this.provider = 'Omnitronix';
-        this.rngProvider = new TrackedRngProvider();
-        this.engine = new happy_panda_engine_1.HappyPandaEngine(this.rngProvider);
+        // Create RNG client based on environment (local for dev, external for prod)
+        const rngClient = rng_client_factory_1.RngClientFactory.create({ metrics: config.metrics });
+        // Wrap in service for audit trail tracking
+        this.rngService = new rng_service_1.RngService(rngClient);
+        // Create adapter to bridge to engine's RngProvider interface
+        this.rngAdapter = new RngServiceAdapter(this.rngService);
+        // Initialize engine with RNG adapter
+        this.engine = new happy_panda_engine_1.HappyPandaEngine(this.rngAdapter);
     }
     getGameEngineInfo() {
         return {
@@ -81,7 +76,9 @@ class HappyPandaV1GameEngine {
         };
     }
     async processCommand(publicState, privateState, command) {
-        this.rngProvider.setCommandId(command.id);
+        // Register command for RNG audit trail
+        this.rngService.registerCommand(command.id);
+        this.rngAdapter.setCommandId(command.id);
         try {
             switch (command.type) {
                 case 'INIT_SESSION_STATE': {
@@ -94,8 +91,8 @@ class HappyPandaV1GameEngine {
                         gameDirection,
                         betStake,
                     });
-                    const rngOutcome = this.rngProvider.getOutcomes(command.id);
-                    this.rngProvider.clearOutcomes(command.id);
+                    const rngOutcome = this.rngService.getRngOutcomeForCommand(command.id);
+                    this.rngService.removeCommand(command.id);
                     return {
                         success: true,
                         publicState: result.state.publicState,
@@ -107,6 +104,7 @@ class HappyPandaV1GameEngine {
                 }
                 case 'SPIN': {
                     if (!publicState || !privateState) {
+                        this.rngService.removeCommand(command.id);
                         return {
                             success: false,
                             publicState: publicState,
@@ -126,8 +124,8 @@ class HappyPandaV1GameEngine {
                         command: types_1.CommandType.SPIN,
                         sessionId: command.id,
                     }, sessionState);
-                    const rngOutcome = this.rngProvider.getOutcomes(command.id);
-                    this.rngProvider.clearOutcomes(command.id);
+                    const rngOutcome = this.rngService.getRngOutcomeForCommand(command.id);
+                    this.rngService.removeCommand(command.id);
                     return {
                         success: true,
                         publicState: result.state.publicState,
@@ -142,7 +140,7 @@ class HappyPandaV1GameEngine {
                         command: types_1.CommandType.GET_SYMBOLS,
                         sessionId: command.id,
                     });
-                    this.rngProvider.clearOutcomes(command.id);
+                    this.rngService.removeCommand(command.id);
                     return {
                         success: true,
                         publicState: publicState,
@@ -152,7 +150,7 @@ class HappyPandaV1GameEngine {
                     };
                 }
                 default: {
-                    this.rngProvider.clearOutcomes(command.id);
+                    this.rngService.removeCommand(command.id);
                     return {
                         success: false,
                         publicState: publicState,
@@ -163,7 +161,7 @@ class HappyPandaV1GameEngine {
             }
         }
         catch (error) {
-            this.rngProvider.clearOutcomes(command.id);
+            this.rngService.removeCommand(command.id);
             return {
                 success: false,
                 publicState: publicState,

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

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Happy Panda Game Engine
+ *
+ * A 3x3 slot game engine with 8/16 bidirectional paylines.
+ *
+ * @packageDocumentation
+ */
+export { HappyPandaV1GameEngine } from './happy-panda-v1.game-engine';
+export type { GameEngine, GameEngineInfo, GameActionCommand, CommandProcessingResult, RngOutcome, RngOutcomeRecord, } from './happy-panda-v1.game-engine';
+export { HappyPandaEngine } from './engine';
+export { Symbol, SpinType, ScreenWinType, GRID, LINE_SHAPES, LINES_PER_DIRECTION, } from './config';
+export { Grid, Position, LineWin, WallWin, ScatterWin, SpecialWin, SpinWinResult, BonusCounters, PendingBonuses, JackpotState, GameDirection, GameState, PublicState, PrivateState, SpinRequest, SpinResponse, SessionState, RngProvider, CommandType, GameCommand, InitSessionRequest, SpinCommandRequest, GetSymbolsRequest, } from './domain';
+export { evaluateSpin, evaluateLineWins, evaluateWallWin, evaluateScatterWins } from './logic/services';
+export { generateGrid } from './rng';
+export { IRngClient, RngSingleResponse, RngBatchResponse, } from './rng/rng-client.interface';
+export { DummyRngClient } from './rng/dummy-rng-client';
+export { RngClientFactory, RngClientConfig } from './rng/rng-client.factory';
+export { RngService } from './rng/rng-service';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,YAAY,EACV,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,UAAU,EACV,gBAAgB,GACjB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG5C,OAAO,EACL,MAAM,EACN,QAAQ,EACR,aAAa,EACb,IAAI,EACJ,WAAW,EACX,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,OAAO,EACP,UAAU,EACV,UAAU,EACV,aAAa,EACb,aAAa,EACb,cAAc,EACd,YAAY,EACZ,aAAa,EACb,SAAS,EACT,WAAW,EACX,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACxG,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAGrC,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -7,7 +7,7 @@
  * @packageDocumentation
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateGrid = exports.evaluateScatterWins = exports.evaluateWallWin = exports.evaluateLineWins = exports.evaluateSpin = exports.CommandType = exports.GameDirection = exports.LINES_PER_DIRECTION = exports.LINE_SHAPES = exports.GRID = exports.ScreenWinType = exports.SpinType = exports.Symbol = exports.HappyPandaEngine = exports.HappyPandaV1GameEngine = void 0;
+exports.RngService = exports.RngClientFactory = exports.DummyRngClient = exports.generateGrid = exports.evaluateScatterWins = exports.evaluateWallWin = exports.evaluateLineWins = exports.evaluateSpin = exports.CommandType = exports.GameDirection = exports.LINES_PER_DIRECTION = exports.LINE_SHAPES = exports.GRID = exports.ScreenWinType = exports.SpinType = exports.Symbol = exports.HappyPandaEngine = exports.HappyPandaV1GameEngine = void 0;
 // V1 Game Engine (for game-engine-service integration)
 var happy_panda_v1_game_engine_1 = require("./happy-panda-v1.game-engine");
 Object.defineProperty(exports, "HappyPandaV1GameEngine", { enumerable: true, get: function () { return happy_panda_v1_game_engine_1.HappyPandaV1GameEngine; } });
@@ -34,4 +34,10 @@ Object.defineProperty(exports, "evaluateWallWin", { enumerable: true, get: funct
 Object.defineProperty(exports, "evaluateScatterWins", { enumerable: true, get: function () { return services_1.evaluateScatterWins; } });
 var rng_1 = require("./rng");
 Object.defineProperty(exports, "generateGrid", { enumerable: true, get: function () { return rng_1.generateGrid; } });
+var dummy_rng_client_1 = require("./rng/dummy-rng-client");
+Object.defineProperty(exports, "DummyRngClient", { enumerable: true, get: function () { return dummy_rng_client_1.DummyRngClient; } });
+var rng_client_factory_1 = require("./rng/rng-client.factory");
+Object.defineProperty(exports, "RngClientFactory", { enumerable: true, get: function () { return rng_client_factory_1.RngClientFactory; } });
+var rng_service_1 = require("./rng/rng-service");
+Object.defineProperty(exports, "RngService", { enumerable: true, get: function () { return rng_service_1.RngService; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,uDAAuD;AACvD,2EAAsE;AAA7D,oIAAA,sBAAsB,OAAA;AAU/B,cAAc;AACd,mCAA4C;AAAnC,0GAAA,gBAAgB,OAAA;AAEzB,gBAAgB;AAChB,mCAOkB;AANhB,gGAAA,MAAM,OAAA;AACN,kGAAA,QAAQ,OAAA;AACR,uGAAA,aAAa,OAAA;AACb,8FAAA,IAAI,OAAA;AACJ,qGAAA,WAAW,OAAA;AACX,6GAAA,mBAAmB,OAAA;AAGrB,eAAe;AACf,mCAwBkB;AAbhB,uGAAA,aAAa,OAAA;AAQb,qGAAA,WAAW,OAAA;AAOb,yCAAyC;AACzC,6CAAwG;AAA/F,wGAAA,YAAY,OAAA;AAAE,4GAAA,gBAAgB,OAAA;AAAE,2GAAA,eAAe,OAAA;AAAE,+GAAA,mBAAmB,OAAA;AAC7E,6BAAqC;AAA5B,mGAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,uDAAuD;AACvD,2EAAsE;AAA7D,oIAAA,sBAAsB,OAAA;AAU/B,cAAc;AACd,mCAA4C;AAAnC,0GAAA,gBAAgB,OAAA;AAEzB,gBAAgB;AAChB,mCAOkB;AANhB,gGAAA,MAAM,OAAA;AACN,kGAAA,QAAQ,OAAA;AACR,uGAAA,aAAa,OAAA;AACb,8FAAA,IAAI,OAAA;AACJ,qGAAA,WAAW,OAAA;AACX,6GAAA,mBAAmB,OAAA;AAGrB,eAAe;AACf,mCAwBkB;AAbhB,uGAAA,aAAa,OAAA;AAQb,qGAAA,WAAW,OAAA;AAOb,yCAAyC;AACzC,6CAAwG;AAA/F,wGAAA,YAAY,OAAA;AAAE,4GAAA,gBAAgB,OAAA;AAAE,2GAAA,eAAe,OAAA;AAAE,+GAAA,mBAAmB,OAAA;AAC7E,6BAAqC;AAA5B,mGAAA,YAAY,OAAA;AAQrB,2DAAwD;AAA/C,kHAAA,cAAc,OAAA;AACvB,+DAA6E;AAApE,sHAAA,gBAAgB,OAAA;AACzB,iDAA+C;AAAtC,yGAAA,UAAU,OAAA"}

package/dist/logic/handlers/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Logic handlers exports
+ */
+export * from './spin-handler';
+//# sourceMappingURL=index.d.ts.map

package/dist/logic/handlers/index.d.ts.map

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

package/dist/logic/handlers/spin-handler.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Spin Handler
+ *
+ * Coordinates the entire spin flow:
+ * 1. Determine spin type
+ * 2. Generate grid
+ * 3. Evaluate wins
+ * 4. Update counters
+ * 5. Update jackpots
+ * 6. Determine next spin type
+ * 7. Build response
+ */
+import { SpinType } from '../../config/happy-panda.config';
+import { Grid, GameDirection, GameState, SpinWinResult, RngProvider } from '../../domain/types';
+export interface SpinResult {
+    /** Resulting grid */
+    grid: Grid;
+    /** Win evaluation results */
+    wins: SpinWinResult;
+    /** Updated game state */
+    state: GameState;
+    /** Progressive jackpot won (if any) */
+    jackpotWon: number;
+    /** Pool jackpot won (if any) */
+    poolJackpotWon: number;
+    /** Bonus type triggered this spin */
+    bonusTriggered: SpinType | null;
+    /** Is this the final spin of bonus sequence */
+    isBonusComplete: boolean;
+}
+/**
+ * Execute a single spin.
+ */
+export declare function executeSpin(state: GameState, rng: RngProvider): Promise<SpinResult>;
+/** Minimum bet stake */
+export declare const MIN_BET_STAKE = 1;
+/** Maximum bet stake (reasonable upper bound) */
+export declare const MAX_BET_STAKE = 100;
+/**
+ * Validate bet parameters.
+ * @throws Error if parameters are invalid
+ */
+export declare function validateBetParams(gameDirection: GameDirection, betStake: number): void;
+/**
+ * Create initial game state.
+ * @throws Error if parameters are invalid
+ */
+export declare function createInitialState(gameDirection: GameDirection, betStake: number): GameState;
+/**
+ * Update state for new bet.
+ * @throws Error if parameters are invalid
+ */
+export declare function updateBet(state: GameState, gameDirection: GameDirection, betStake: number): GameState;
+//# sourceMappingURL=spin-handler.d.ts.map