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

package/dist/rng/rng-service.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * RNG Service
+ *
+ * Core RNG service with audit trail tracking for compliance.
+ * Wraps an IRngClient and tracks all RNG outcomes per command.
+ * Matches the pattern used in Heroes of Aether and Bonny's Fortune.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RngService = void 0;
+/**
+ * RNG Service
+ *
+ * Provides RNG operations with full audit trail tracking.
+ * Each command ID can have multiple action IDs, allowing fine-grained tracking
+ * of all RNG calls within a single game command.
+ */
+class RngService {
+    constructor(rngClient) {
+        this.rngClient = rngClient;
+        this.rngOutcomes = {};
+    }
+    /**
+     * Register a command for RNG tracking.
+     * Call this at the start of command processing.
+     */
+    registerCommand(commandId) {
+        if (!this.rngOutcomes[commandId]) {
+            this.rngOutcomes[commandId] = {};
+        }
+    }
+    /**
+     * Remove a command's RNG outcomes.
+     * Call this after command processing to clean up.
+     */
+    removeCommand(commandId) {
+        delete this.rngOutcomes[commandId];
+    }
+    /**
+     * Check if a command has RNG outcomes
+     */
+    hasCommandRngOutcome(commandId) {
+        return !!this.rngOutcomes[commandId];
+    }
+    /**
+     * Get the count of RNG outcomes for a command
+     */
+    getRngOutcomeCountForCommand(commandId) {
+        const outcomes = this.rngOutcomes[commandId];
+        return outcomes ? Object.keys(outcomes).length : 0;
+    }
+    /**
+     * Store an RNG outcome for audit trail
+     */
+    storeSeedForCommand(commandId, actionId, result, seed, min, max) {
+        this.registerCommand(commandId);
+        this.rngOutcomes[commandId][actionId] = { result, seed, min, max };
+    }
+    /**
+     * Get cached seed for a command/action (for replay scenarios)
+     */
+    getSeedForCommand(commandId, actionId) {
+        return this.rngOutcomes[commandId]?.[actionId]?.seed;
+    }
+    /**
+     * Get all RNG outcomes for a command
+     */
+    getRngOutcomeForCommand(commandId) {
+        return this.rngOutcomes[commandId] || {};
+    }
+    /**
+     * Get all RNG outcomes across all commands
+     */
+    getAllRngOutcome() {
+        return { ...this.rngOutcomes };
+    }
+    /**
+     * Generate a single random integer in range [min, max]
+     * Tracks the outcome for audit trail
+     */
+    async getSingleNumber(min, max, commandId, actionId) {
+        // Check if we already have a cached result (for replay)
+        const existingSeed = this.getSeedForCommand(commandId, actionId);
+        if (existingSeed !== undefined) {
+            const existingResult = this.rngOutcomes[commandId][actionId];
+            return { value: existingResult.result, seed: existingResult.seed };
+        }
+        // Generate new random number
+        const response = await this.rngClient.getSingleNumber(min, max);
+        // Store for audit trail
+        this.storeSeedForCommand(commandId, actionId, response.value, response.seed, min, max);
+        return response;
+    }
+    /**
+     * Generate multiple random integers in range [min, max]
+     * Each number is tracked individually with incrementing action IDs
+     */
+    async getBatchNumbers(min, max, count, commandId, actionId) {
+        const results = [];
+        for (let i = 0; i < count; i++) {
+            const result = await this.getSingleNumber(min, max, commandId, `${actionId}_${i}`);
+            results.push(result);
+        }
+        return results;
+    }
+    /**
+     * Generate a weighted random selection
+     * Returns the index selected based on weights
+     */
+    async getWeightedRandomIndex(weights, commandId, actionId) {
+        const total = weights.reduce((acc, w) => acc + w, 0);
+        const { value: rand } = await this.getSingleNumber(0, total - 1, commandId, actionId);
+        let cumulative = 0;
+        for (let i = 0; i < weights.length; i++) {
+            cumulative += weights[i];
+            if (rand < cumulative) {
+                return i;
+            }
+        }
+        return weights.length - 1;
+    }
+}
+exports.RngService = RngService;
+//# sourceMappingURL=rng-service.js.map

package/dist/rng/rng-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rng-service.js","sourceRoot":"","sources":["../../src/rng/rng-service.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAmBH;;;;;;GAMG;AACH,MAAa,UAAU;IAGrB,YAA6B,SAAqB;QAArB,cAAS,GAAT,SAAS,CAAY;QAF1C,gBAAW,GAAwC,EAAE,CAAC;IAET,CAAC;IAEtD;;;OAGG;IACH,eAAe,CAAC,SAAiB;QAC/B,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,SAAiB;QAC7B,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,SAAiB;QACpC,OAAO,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,4BAA4B,CAAC,SAAiB;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC7C,OAAO,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACK,mBAAmB,CACzB,SAAiB,EACjB,QAAgB,EAChB,MAAc,EACd,IAAY,EACZ,GAAW,EACX,GAAW;QAEX,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QAChC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,SAAiB,EAAE,QAAgB;QACnD,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,uBAAuB,CAAC,SAAiB;QACvC,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CACnB,GAAW,EACX,GAAW,EACX,SAAiB,EACjB,QAAgB;QAEhB,wDAAwD;QACxD,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACjE,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC;YAC7D,OAAO,EAAE,KAAK,EAAE,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,cAAc,CAAC,IAAI,EAAE,CAAC;QACrE,CAAC;QAED,6BAA6B;QAC7B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAEhE,wBAAwB;QACxB,IAAI,CAAC,mBAAmB,CACtB,SAAS,EACT,QAAQ,EACR,QAAQ,CAAC,KAAK,EACd,QAAQ,CAAC,IAAI,EACb,GAAG,EACH,GAAG,CACJ,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CACnB,GAAW,EACX,GAAW,EACX,KAAa,EACb,SAAiB,EACjB,QAAgB;QAEhB,MAAM,OAAO,GAAsC,EAAE,CAAC;QAEtD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CACvC,GAAG,EACH,GAAG,EACH,SAAS,EACT,GAAG,QAAQ,IAAI,CAAC,EAAE,CACnB,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,sBAAsB,CAC1B,OAAiB,EACjB,SAAiB,EACjB,QAAgB;QAEhB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACrD,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,eAAe,CAChD,CAAC,EACD,KAAK,GAAG,CAAC,EACT,SAAS,EACT,QAAQ,CACT,CAAC;QAEF,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,UAAU,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;YACzB,IAAI,IAAI,GAAG,UAAU,EAAE,CAAC;gBACtB,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC5B,CAAC;CACF;AAhKD,gCAgKC"}

package/dist/rng/spin-generator.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Spin Generator with Symbol Limitation System
+ *
+ * Generates 3x3 grids with weighted symbol distribution and limitation constraints.
+ * Each symbol type has a randomly selected maximum count (2, 4, 7, or 9).
+ */
+import { Symbol, SpinType } from '../config/happy-panda.config';
+import { Grid, GameDirection, RngProvider } from '../domain/types';
+/**
+ * Generate a grid with weighted symbols and limitation constraints.
+ *
+ * IMPORTANT: C++ logic requires limitations to be selected FIRST, then
+ * 3x3 check only happens if a symbol has limit=9 (max symbols).
+ *
+ * @param spinType Type of spin
+ * @param gameDirection Game direction
+ * @param rng RNG provider
+ * @param centerSymbol Optional fixed center symbol (for respin)
+ * @returns Generated 3x3 grid
+ */
+export declare function generateGrid(spinType: SpinType, gameDirection: GameDirection, rng: RngProvider, centerSymbol?: Symbol): Promise<Grid>;
+/**
+ * Generate cherry piece grid for jackpot bonus.
+ * Each position gets the appropriate piece symbol.
+ */
+export declare function generateCherryPieceGrid(): Grid;
+/**
+ * Check if grid is a complete cherry piece (jackpot).
+ */
+export declare function isCompleteCherryPiece(grid: Grid): boolean;
+//# sourceMappingURL=spin-generator.d.ts.map

package/dist/rng/spin-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spin-generator.d.ts","sourceRoot":"","sources":["../../src/rng/spin-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,MAAM,EACN,QAAQ,EA+BT,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAqHnE;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,aAAa,EAC5B,GAAG,EAAE,WAAW,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAgJf;AA8ED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAM9C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAiBzD"}

package/dist/rng/weighted-random.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Weighted Random Selection Utilities
+ *
+ * Helper functions for weighted random selection using the RNG provider.
+ */
+import { RngProvider } from '../domain/types';
+/**
+ * Select an index from an array of weights.
+ * @param weights Array of weights (must be positive integers)
+ * @param rng RNG provider
+ * @returns Selected index
+ */
+export declare function selectWeightedIndex(weights: readonly number[], rng: RngProvider): Promise<number>;
+/**
+ * Check if a weighted random selection succeeds.
+ * @param yesWeight Weight for "yes" outcome
+ * @param noWeight Weight for "no" outcome
+ * @param rng RNG provider
+ * @returns true if "yes" was selected
+ */
+export declare function weightedBoolean(yesWeight: number, noWeight: number, rng: RngProvider): Promise<boolean>;
+/**
+ * Select multiple weighted indices (with replacement).
+ * @param weights Array of weights
+ * @param count Number of selections
+ * @param rng RNG provider
+ * @returns Array of selected indices
+ */
+export declare function selectMultipleWeighted(weights: readonly number[], count: number, rng: RngProvider): Promise<number[]>;
+//# sourceMappingURL=weighted-random.d.ts.map

package/dist/rng/weighted-random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weighted-random.d.ts","sourceRoot":"","sources":["../../src/rng/weighted-random.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,MAAM,CAAC,CAkBjB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,MAAM,EAAE,CAAC,CAMnB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omnitronix/happy-panda-game-engine",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Happy Panda Game Engine",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",