@omnitronix/happy-panda-game-engine 0.0.3 → 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/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/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

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

@@ -0,0 +1 @@
+{"version":3,"file":"spin-handler.d.ts","sourceRoot":"","sources":["../../../src/logic/handlers/spin-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAEL,QAAQ,EAET,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,IAAI,EACJ,aAAa,EACb,SAAS,EACT,aAAa,EACb,WAAW,EACZ,MAAM,oBAAoB,CAAC;AAoB5B,MAAM,WAAW,UAAU;IACzB,qBAAqB;IACrB,IAAI,EAAE,IAAI,CAAC;IACX,6BAA6B;IAC7B,IAAI,EAAE,aAAa,CAAC;IACpB,yBAAyB;IACzB,KAAK,EAAE,SAAS,CAAC;IACjB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,cAAc,EAAE,QAAQ,GAAG,IAAI,CAAC;IAChC,+CAA+C;IAC/C,eAAe,EAAE,OAAO,CAAC;CAC1B;AAqBD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,CA2KrB;AAMD,wBAAwB;AACxB,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,iDAAiD;AACjD,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAUtF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,MAAM,GACf,SAAS,CAsCX;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,SAAS,EAChB,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,MAAM,GACf,SAAS,CAiBX"}

package/dist/logic/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Logic module exports
+ */
+export * from './services';
+export * from './handlers';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/logic/services/counter-manager.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Counter Manager Service
+ *
+ * Manages bonus counters and trigger detection.
+ * Each bonus type has a counter that decrements on specific events.
+ * When a counter reaches 0, the bonus is triggered.
+ */
+import { SpinType } from '../../config/happy-panda.config';
+import { Grid, GameDirection, BonusCounters, PendingBonuses, LineWin, RngProvider } from '../../domain/types';
+/**
+ * Create initial bonus counters.
+ */
+export declare function createInitialCounters(): BonusCounters;
+/**
+ * Create empty pending bonuses.
+ */
+export declare function createEmptyPendingBonuses(): PendingBonuses;
+/**
+ * Randomize cherry counter initial value (6 or 9).
+ */
+export declare function randomizeCherryCounter(gameDirection: GameDirection, rng: RngProvider): Promise<number>;
+/**
+ * Randomize bell counter initial value (3 or 5).
+ */
+export declare function randomizeBellCounter(gameDirection: GameDirection, rng: RngProvider): Promise<number>;
+/** Result of counter update */
+export interface CounterUpdateResult {
+    counters: BonusCounters;
+    pendingBonuses: PendingBonuses;
+    triggeredJackpot: boolean;
+    triggeredCherry: boolean;
+    triggeredBell: boolean;
+    triggeredBar1: boolean;
+    triggeredRespin: number;
+}
+/**
+ * Update counters based on spin results.
+ * Only applies during paid_spin and respin_cherry.
+ */
+export declare function updateCounters(currentCounters: BonusCounters, currentPending: PendingBonuses, lineWins: LineWin[], grid: Grid, gameDirection: GameDirection, spinType: SpinType, totalWin: number, rng: RngProvider): Promise<CounterUpdateResult>;
+/** Bonus type to consume */
+export type BonusType = 'jackpot' | 'cherry' | 'bell' | 'bar1' | 'respin';
+/**
+ * Get the next bonus type to execute (priority order).
+ * Returns null if no bonuses pending.
+ */
+export declare function getNextBonusType(pending: PendingBonuses): BonusType | null;
+/**
+ * Consume one bonus from pending.
+ * Returns updated pending and number of spins for that bonus.
+ */
+export declare function consumeBonus(pending: PendingBonuses, bonusType: BonusType): {
+    pending: PendingBonuses;
+    spins: number;
+};
+/**
+ * Check if any bonus is pending.
+ */
+export declare function hasPendingBonus(pending: PendingBonuses): boolean;
+//# sourceMappingURL=counter-manager.d.ts.map

package/dist/logic/services/counter-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counter-manager.d.ts","sourceRoot":"","sources":["../../../src/logic/services/counter-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAEL,QAAQ,EAOT,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,IAAI,EACJ,aAAa,EACb,aAAa,EACb,cAAc,EACd,OAAO,EACP,WAAW,EACZ,MAAM,oBAAoB,CAAC;AAO5B;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,aAAa,CAOrD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,cAAc,CAQ1D;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,MAAM,CAAC,CAIjB;AAMD,+BAA+B;AAC/B,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,aAAa,CAAC;IACxB,cAAc,EAAE,cAAc,CAAC;IAC/B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,eAAe,EAAE,aAAa,EAC9B,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,OAAO,EAAE,EACnB,IAAI,EAAE,IAAI,EACV,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,mBAAmB,CAAC,CAwI9B;AAMD,4BAA4B;AAC5B,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1E;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI,CAQ1E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,SAAS,GACnB;IAAE,OAAO,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAsC5C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAQhE"}

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

@@ -0,0 +1,7 @@
+/**
+ * Logic services exports
+ */
+export * from './win-evaluator';
+export * from './counter-manager';
+export * from './jackpot-manager';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/logic/services/jackpot-manager.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Jackpot Manager Service
+ *
+ * Manages progressive jackpot and pool jackpot values.
+ *
+ * Progressive Jackpot (Bonus Jackpot):
+ * - Starts at 100 x bet_game
+ * - On losing paid spins: 3/13 chance to increase by 1-2 x bet_stake
+ * - Max: 1000 x bet_game
+ * - Paid when Jackpot Bonus triggered
+ *
+ * Pool Jackpot:
+ * - Starts at 0
+ * - Increases when Seven/Super Seven in center with no wins
+ * - Max: 250 x bet_game
+ * - Paid when Bell Bonus triggered
+ */
+import { SpinType } from '../../config/happy-panda.config';
+import { Grid, GameDirection, JackpotState, RngProvider } from '../../domain/types';
+/**
+ * Create initial jackpot state.
+ */
+export declare function createInitialJackpots(betGame: number): JackpotState;
+/**
+ * Update progressive jackpot value on losing paid spin.
+ * 3/13 probability to increase.
+ */
+export declare function updateProgressiveJackpot(currentValue: number, gameDirection: GameDirection, betGame: number, betStake: number, spinType: SpinType, totalWin: number, rng: RngProvider): Promise<number>;
+/**
+ * Pay out progressive jackpot and reset.
+ */
+export declare function payProgressiveJackpot(currentValue: number, betGame: number): {
+    payout: number;
+    newValue: number;
+};
+/**
+ * Update pool jackpot value.
+ * Increases when Seven/Super Seven in center position with no wins.
+ * IMPORTANT: Must be the ONLY Seven on the entire screen (per C++ math model).
+ */
+export declare function updatePoolJackpot(currentValue: number, grid: Grid, gameDirection: GameDirection, betGame: number, betStake: number, spinType: SpinType, totalWin: number): number;
+/**
+ * Pay out pool jackpot and reset.
+ */
+export declare function payPoolJackpot(currentValue: number, betGame: number): {
+    payout: number;
+    newValue: number;
+};
+/** Result of jackpot updates */
+export interface JackpotUpdateResult {
+    jackpots: JackpotState;
+    progressiveJackpotIncreased: boolean;
+    poolJackpotIncreased: boolean;
+}
+/**
+ * Update both jackpot values after a spin.
+ */
+export declare function updateJackpots(currentJackpots: JackpotState, grid: Grid, gameDirection: GameDirection, betGame: number, betStake: number, spinType: SpinType, totalWin: number, rng: RngProvider): Promise<JackpotUpdateResult>;
+//# sourceMappingURL=jackpot-manager.d.ts.map

package/dist/logic/services/jackpot-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jackpot-manager.d.ts","sourceRoot":"","sources":["../../../src/logic/services/jackpot-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAEL,QAAQ,EAIT,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAOpF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAKnE;AAMD;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,MAAM,CAAC,CAyBjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAItC;AAMD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,IAAI,EACV,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,CAsCR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAItC;AAMD,gCAAgC;AAChC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,YAAY,CAAC;IACvB,2BAA2B,EAAE,OAAO,CAAC;IACrC,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,eAAe,EAAE,YAAY,EAC7B,IAAI,EAAE,IAAI,EACV,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,mBAAmB,CAAC,CAgC9B"}

package/dist/logic/services/win-evaluator.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Win Evaluator Service
+ *
+ * Evaluates wins on a 3x3 grid with correct priority:
+ * 1. Wall wins (3x3) - suppress line wins
+ * 2. Scatter wins (Seven/Super Seven) - suppress line wins
+ * 3. Line wins (only if no wall or scatter)
+ * 4. Special wins (bonus-specific)
+ */
+import { SpinType } from '../../config/happy-panda.config';
+import { Grid, GameDirection, LineWin, WallWin, ScatterWin, SpecialWin, SpinWinResult } from '../../domain/types';
+/**
+ * Evaluate wall (3x3) wins.
+ * Wall wins require all 9 positions to be the same symbol or valid mix.
+ */
+export declare function evaluateWallWin(grid: Grid, betGame: number): WallWin | null;
+/**
+ * Evaluate Seven/Super Seven scatter wins.
+ * C++ can award TWO scatter wins:
+ * 1. Super Seven only scatter (if SEV_S >= 2, doubled if no regular Sevens)
+ * 2. Total count scatter (if total >= 2 AND at least 1 regular Seven)
+ *    Plus +bet_game bonus if exactly 1 Super Seven
+ */
+export declare function evaluateScatterWins(grid: Grid, betGame: number): ScatterWin[];
+/**
+ * Evaluate all line wins.
+ */
+export declare function evaluateLineWins(grid: Grid, gameDirection: GameDirection, betStake: number): LineWin[];
+/**
+ * Evaluate cherry piece line wins (Jackpot Bonus).
+ * Cherry pieces on lines pay special multiplier.
+ */
+export declare function evaluateCherryPieceWins(grid: Grid, gameDirection: GameDirection, betStake: number): SpecialWin[];
+/**
+ * Evaluate bell scatter wins (Bell Bonus).
+ * Each bell pays as scatter during bonus.
+ */
+export declare function evaluateBellScatterWins(grid: Grid, gameDirection: GameDirection, betStake: number): SpecialWin | null;
+/**
+ * Evaluate super bar scatter wins (Bar1 Bonus).
+ * Each super bar pays as scatter during bonus.
+ */
+export declare function evaluateSuperBarScatterWins(grid: Grid, gameDirection: GameDirection, betStake: number): SpecialWin | null;
+/**
+ * Evaluate all wins for a spin.
+ * Implements correct priority: Wall > Scatter > Lines
+ */
+export declare function evaluateSpin(grid: Grid, gameDirection: GameDirection, betStake: number, betGame: number, spinType: SpinType): SpinWinResult;
+//# sourceMappingURL=win-evaluator.d.ts.map

package/dist/logic/services/win-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"win-evaluator.d.ts","sourceRoot":"","sources":["../../../src/logic/services/win-evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,QAAQ,EAiBT,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,IAAI,EACJ,aAAa,EAEb,OAAO,EACP,OAAO,EACP,UAAU,EACV,UAAU,EACV,aAAa,EACd,MAAM,oBAAoB,CAAC;AAqE5B;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,MAAM,GACd,OAAO,GAAG,IAAI,CAmEhB;AAMD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,MAAM,GACd,UAAU,EAAE,CAsDd;AAmGD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,EACV,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,MAAM,GACf,OAAO,EAAE,CAYX;AAMD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,IAAI,EACV,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,MAAM,GACf,UAAU,EAAE,CAmCd;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,IAAI,EACV,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,MAAM,GACf,UAAU,GAAG,IAAI,CAcnB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,IAAI,EACV,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,MAAM,GACf,UAAU,GAAG,IAAI,CAcnB;AAMD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,EACV,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,GACjB,aAAa,CAyFf"}