@energy8platform/platform-core 0.16.0

package/dist/simulation.esm.js

@@ -0,0 +1,368 @@
+import { spawn, execSync } from 'child_process';
+import { writeFile, unlink } from 'fs/promises';
+import { accessSync, constants } from 'fs';
+import { join, dirname } from 'path';
+import { tmpdir, cpus } from 'os';
+import { randomBytes } from 'crypto';
+import { fileURLToPath } from 'url';
+import { Worker } from 'worker_threads';
+
+// ─── Runner ─────────────────────────────────────────────
+class NativeSimulationRunner {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async run() {
+        const { binaryPath, script, gameDefinition, iterations, bet, action, params } = this.config;
+        const id = randomBytes(8).toString('hex');
+        const tmpDir = tmpdir();
+        const luaPath = join(tmpDir, `sim-${id}.lua`);
+        const configPath = join(tmpDir, `sim-${id}.json`);
+        try {
+            // Write temp files
+            await Promise.all([
+                writeFile(luaPath, script, 'utf-8'),
+                writeFile(configPath, JSON.stringify({ ...gameDefinition, script_path: luaPath }), 'utf-8'),
+            ]);
+            // Build CLI args
+            const args = [
+                '-config', configPath,
+                '-iterations', String(iterations),
+                '-bet', String(bet),
+                '-format', 'json',
+            ];
+            if (action) {
+                args.push('-action', action);
+            }
+            if (params && Object.keys(params).length > 0) {
+                args.push('-params', JSON.stringify(params));
+            }
+            // Execute binary
+            const output = await this.exec(binaryPath, args);
+            // Parse JSON output
+            const json = JSON.parse(output);
+            return mapGoResult(json);
+        }
+        finally {
+            // Cleanup temp files
+            await Promise.allSettled([unlink(luaPath), unlink(configPath)]);
+        }
+    }
+    exec(binary, args) {
+        return new Promise((resolve, reject) => {
+            const child = spawn(binary, args, { stdio: ['ignore', 'pipe', 'pipe'] });
+            let stdout = '';
+            let stderr = '';
+            child.stdout.on('data', (chunk) => {
+                stdout += chunk.toString();
+            });
+            child.stderr.on('data', (chunk) => {
+                stderr += chunk.toString();
+            });
+            child.on('error', (err) => {
+                reject(new Error(`Failed to execute simulation binary: ${err.message}`));
+            });
+            child.on('close', (code) => {
+                if (code !== 0) {
+                    reject(new Error(`Simulation binary exited with code ${code}: ${stderr.trim()}`));
+                }
+                else {
+                    resolve(stdout);
+                }
+            });
+        });
+    }
+}
+// ─── Result mapping ─────────────────────────────────────
+function mapGoResult(json) {
+    const baseStage = json.per_stage_stats?.base_game;
+    const baseGameRtp = baseStage?.rtp ?? 0;
+    const baseGameWin = baseStage?.total_win ?? 0;
+    const perStage = json.per_stage_stats
+        ? Object.fromEntries(Object.entries(json.per_stage_stats).map(([key, s]) => [
+            key,
+            {
+                totalWin: s.total_win,
+                spinCount: s.spin_count,
+                hitCount: s.hit_count,
+                maxWin: s.max_win,
+                rtp: s.rtp,
+                perSpinRtp: s.per_spin_rtp,
+                hitFrequency: s.hit_frequency,
+                avgWin: s.avg_win,
+            },
+        ]))
+        : undefined;
+    return {
+        gameId: json.game_id,
+        action: 'spin',
+        iterations: json.iterations,
+        durationMs: Math.round(json.duration_sec * 1000),
+        totalRtp: json.total_rtp,
+        baseGameRtp,
+        bonusRtp: json.total_rtp - baseGameRtp,
+        hitFrequency: json.hit_frequency,
+        maxWin: json.max_win,
+        maxWinHits: json.max_win_hits,
+        bonusTriggered: json.bonus_triggered,
+        bonusSpinsPlayed: json.bonus_spins_total,
+        speed: json.speed,
+        workersUsed: json.workers_used,
+        perStage,
+        winDistribution: json.win_distribution,
+        _raw: {
+            totalWagered: json.total_bet,
+            totalWon: json.total_win,
+            baseGameWin,
+            bonusWin: json.total_win - baseGameWin,
+            hits: json.iterations > 0 ? Math.round((json.hit_frequency * json.iterations) / 100) : 0,
+        },
+    };
+}
+// ─── Binary discovery ───────────────────────────────────
+/**
+ * Search for a native simulation binary in standard locations.
+ * Returns the absolute path if found, null otherwise.
+ */
+function findNativeBinary(baseDir) {
+    // 1. Explicit env var
+    const envPath = process.env.SIMULATE_BINARY;
+    if (envPath && isExecutable(envPath)) {
+        return envPath;
+    }
+    const platform = process.platform; // darwin, linux, win32
+    const nodeArch = process.arch; // arm64, x64
+    const goArch = nodeArch === 'x64' ? 'amd64' : nodeArch;
+    const goPlatform = platform === 'win32' ? 'windows' : platform;
+    const ext = platform === 'win32' ? '.exe' : '';
+    const names = [
+        `simulate-${goPlatform}-${goArch}${ext}`,
+        `simulation-${goPlatform}-${goArch}${ext}`,
+        `simulate${ext}`,
+        `simulation${ext}`,
+    ];
+    // Search directories: user's project first, then this package's bin/
+    const searchDirs = [];
+    if (baseDir)
+        searchDirs.push(baseDir);
+    // This package's root (where postinstall downloads the binary)
+    try {
+        const pkgRoot = join(dirname(fileURLToPath(import.meta.url)), '..');
+        if (!searchDirs.includes(pkgRoot))
+            searchDirs.push(pkgRoot);
+    }
+    catch {
+        // fallback for CJS
+        if (typeof __dirname !== 'undefined') {
+            const pkgRoot = join(__dirname, '..');
+            if (!searchDirs.includes(pkgRoot))
+                searchDirs.push(pkgRoot);
+        }
+    }
+    for (const dir of searchDirs) {
+        for (const name of names) {
+            const candidate = join(dir, 'bin', name);
+            if (isExecutable(candidate))
+                return candidate;
+        }
+    }
+    // Check $PATH
+    for (const bin of ['simulate', 'simulation']) {
+        try {
+            const cmd = platform === 'win32' ? `where ${bin}` : `which ${bin}`;
+            const result = execSync(cmd, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'ignore'] }).trim();
+            if (result)
+                return result.split('\n')[0];
+        }
+        catch {
+            // not found
+        }
+    }
+    return null;
+}
+function isExecutable(path) {
+    try {
+        accessSync(path, constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ─── Extended formatting ────────────────────────────────
+/** Format a NativeSimulationResult with per-stage and distribution data */
+function formatNativeResult(result) {
+    const lines = [
+        '',
+        '--- Simulation Results ---',
+        `Game: ${result.gameId}`,
+        `Iterations: ${result.iterations.toLocaleString()}`,
+        `Duration: ${(result.durationMs / 1000).toFixed(1)}s`,
+    ];
+    if (result.speed) {
+        lines.push(`Speed: ${Math.round(result.speed).toLocaleString()} iterations/sec`);
+    }
+    if (result.workersUsed) {
+        lines.push(`Workers: ${result.workersUsed}`);
+    }
+    lines.push('', '--- Total ---', `Total RTP: ${result.totalRtp.toFixed(2)}%`, `Base Game RTP: ${result.baseGameRtp.toFixed(2)}%`, `Bonus RTP: ${result.bonusRtp.toFixed(2)}%`, `Hit Frequency: ${result.hitFrequency.toFixed(2)}%`, `Max Win: ${result.maxWin.toFixed(2)}x`, `Max Win Cap Hits: ${result.maxWinHits}`);
+    if (result.bonusTriggered > 0) {
+        const frequency = Math.round(result.iterations / result.bonusTriggered);
+        lines.push('', '--- Bonus Stats ---', `Bonus Triggered: ${result.bonusTriggered.toLocaleString()} (1 in ${frequency} spins)`, `Bonus Spins Total: ${result.bonusSpinsPlayed.toLocaleString()}`);
+    }
+    // Per-stage breakdown
+    if (result.perStage && Object.keys(result.perStage).length > 0) {
+        lines.push('', '--- Per-Stage Breakdown ---');
+        const header = 'Stage                | Spins      | RTP (contrib) | Per-Spin RTP | Hit Freq  | Avg Win   | Max Win';
+        lines.push(header);
+        lines.push('-'.repeat(header.length));
+        for (const [stage, stats] of Object.entries(result.perStage)) {
+            lines.push(`${stage.padEnd(20)} | ${String(stats.spinCount).padStart(10)} | ` +
+                `${stats.rtp.toFixed(2).padStart(12)}% | ` +
+                `${stats.perSpinRtp.toFixed(2).padStart(11)}% | ` +
+                `${stats.hitFrequency.toFixed(2).padStart(8)}% | ` +
+                `${stats.avgWin.toFixed(3).padStart(8)}x | ` +
+                `${stats.maxWin.toFixed(2).padStart(8)}x`);
+        }
+    }
+    // Win distribution
+    if (result.winDistribution && result.winDistribution.length > 0) {
+        lines.push('', '--- Win Distribution ---');
+        for (const bucket of result.winDistribution) {
+            const bar = '█'.repeat(Math.round(bucket.pct / 2));
+            lines.push(`${bucket.label.padEnd(10)} ${String(bucket.count).padStart(10)} (${bucket.pct.toFixed(2).padStart(6)}%) ${bar}`);
+        }
+    }
+    return lines.join('\n');
+}
+
+/// <reference types="node" />
+const SEED_STRIDE = 1 << 20; // 2^20 — gap between worker seeds to avoid overlap
+/**
+ * Runs simulation across multiple worker threads for parallel speedup.
+ * Each worker gets an independent LuaEngine with a partitioned seed range.
+ *
+ * Results are statistically equivalent to single-threaded mode but not
+ * bit-identical (different RNG sequence ordering).
+ *
+ * @example
+ * ```ts
+ * const runner = new ParallelSimulationRunner({
+ *   script: luaSource,
+ *   gameDefinition,
+ *   iterations: 1_000_000,
+ *   bet: 1.0,
+ *   workerCount: 8,
+ *   onProgress: (done, total) => console.log(`${done}/${total}`),
+ * });
+ * const result = await runner.run();
+ * ```
+ */
+class ParallelSimulationRunner {
+    config;
+    workerCount;
+    constructor(config) {
+        this.config = config;
+        const maxWorkers = cpus().length;
+        this.workerCount = Math.max(1, Math.min(config.workerCount ?? maxWorkers, maxWorkers, config.iterations));
+    }
+    async run() {
+        const { iterations, seed, onProgress, workerCount: _, ...restConfig } = this.config;
+        const workerCount = this.workerCount;
+        // Split iterations evenly, remainder goes to last worker
+        const baseChunk = Math.floor(iterations / workerCount);
+        const remainder = iterations - baseChunk * workerCount;
+        const workerPath = join(dirname(fileURLToPath(import.meta.url)), 'SimulationWorker.ts');
+        const progressPerWorker = new Array(workerCount).fill(0);
+        const totalIterations = iterations;
+        const promises = Array.from({ length: workerCount }, (_, i) => {
+            const workerIterations = baseChunk + (i < remainder ? 1 : 0);
+            const workerSeed = seed !== undefined ? seed + i * SEED_STRIDE : undefined;
+            const workerConfig = {
+                config: {
+                    ...restConfig,
+                    iterations: workerIterations,
+                    seed: workerSeed,
+                    progressInterval: this.config.progressInterval,
+                },
+            };
+            return new Promise((resolve, reject) => {
+                const worker = new Worker(workerPath, {
+                    workerData: workerConfig,
+                    // tsx registers itself via --require/--import; pass through to workers
+                    execArgv: process.execArgv,
+                });
+                worker.on('message', (msg) => {
+                    if (msg.type === 'progress' && onProgress) {
+                        progressPerWorker[i] = msg.progress.completed;
+                        const totalCompleted = progressPerWorker.reduce((a, b) => a + b, 0);
+                        onProgress(totalCompleted, totalIterations);
+                    }
+                    else if (msg.type === 'result') {
+                        resolve(msg.result);
+                    }
+                    else if (msg.type === 'error') {
+                        reject(new Error(`Worker ${i} failed: ${msg.error}`));
+                    }
+                });
+                worker.on('error', (err) => reject(new Error(`Worker ${i} error: ${err.message}`)));
+                worker.on('exit', (code) => {
+                    if (code !== 0)
+                        reject(new Error(`Worker ${i} exited with code ${code}`));
+                });
+            });
+        });
+        const results = await Promise.all(promises);
+        return aggregateResults(results);
+    }
+}
+function aggregateResults(results) {
+    const raw = {
+        totalWagered: 0,
+        totalWon: 0,
+        baseGameWin: 0,
+        bonusWin: 0,
+        hits: 0,
+    };
+    let iterations = 0;
+    let maxWin = 0;
+    let maxWinHits = 0;
+    let bonusTriggered = 0;
+    let bonusSpinsPlayed = 0;
+    let maxDurationMs = 0;
+    for (const r of results) {
+        const rr = r._raw;
+        raw.totalWagered += rr.totalWagered;
+        raw.totalWon += rr.totalWon;
+        raw.baseGameWin += rr.baseGameWin;
+        raw.bonusWin += rr.bonusWin;
+        raw.hits += rr.hits;
+        iterations += r.iterations;
+        if (r.maxWin > maxWin)
+            maxWin = r.maxWin;
+        maxWinHits += r.maxWinHits;
+        bonusTriggered += r.bonusTriggered;
+        bonusSpinsPlayed += r.bonusSpinsPlayed;
+        if (r.durationMs > maxDurationMs)
+            maxDurationMs = r.durationMs;
+    }
+    return {
+        gameId: results[0].gameId,
+        action: results[0].action,
+        iterations,
+        durationMs: maxDurationMs,
+        totalRtp: raw.totalWagered > 0 ? (raw.totalWon / raw.totalWagered) * 100 : 0,
+        baseGameRtp: raw.totalWagered > 0 ? (raw.baseGameWin / raw.totalWagered) * 100 : 0,
+        bonusRtp: raw.totalWagered > 0 ? (raw.bonusWin / raw.totalWagered) * 100 : 0,
+        hitFrequency: iterations > 0 ? (raw.hits / iterations) * 100 : 0,
+        maxWin,
+        maxWinHits,
+        bonusTriggered,
+        bonusSpinsPlayed,
+        _raw: raw,
+    };
+}
+
+export { NativeSimulationRunner, ParallelSimulationRunner, findNativeBinary, formatNativeResult };
+//# sourceMappingURL=simulation.esm.js.map

package/dist/simulation.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulation.esm.js","sources":["../src/simulation/NativeSimulationRunner.ts","../src/simulation/ParallelSimulationRunner.ts"],"sourcesContent":[null,null],"names":["fsConstants"],"mappings":"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"}

package/dist/vite.cjs.js

@@ -0,0 +1,179 @@
+'use strict';
+
+// ─── DevBridge Plugin ────────────────────────────────────
+/**
+ * Vite plugin that auto-injects the DevBridge mock-host bootstrapper
+ * into the HTML during development, so the game can communicate with
+ * a mock casino host without manual setup.
+ *
+ * Pair with `luaPlugin` to also enable `.lua` raw imports and serve a
+ * Lua execution endpoint at POST /__lua-play.
+ */
+const VIRTUAL_ID = '/@dev-bridge-entry.js';
+function devBridgePlugin(configPath) {
+    let entrySrc = '';
+    let viteRoot = '';
+    let resolvedConfigPath = configPath;
+    return {
+        name: 'platform-core:dev-bridge',
+        apply: 'serve', // dev only
+        enforce: 'pre',
+        configResolved(config) {
+            viteRoot = config.root;
+            // Resolve relative config path against Vite root so the virtual
+            // module can import it with an absolute path.
+            if (configPath.startsWith('.')) {
+                resolvedConfigPath = config.root + '/' + configPath.replace(/^\.\//, '');
+            }
+        },
+        resolveId(id) {
+            if (id === VIRTUAL_ID)
+                return id;
+        },
+        load(id) {
+            if (id === VIRTUAL_ID) {
+                // This goes through Vite's pipeline so bare imports are resolved
+                return `
+import { DevBridge } from '@energy8platform/platform-core/dev-bridge';
+
+try {
+  const mod = await import('${resolvedConfigPath}');
+  const config = mod.default ?? mod.config ?? mod;
+  new DevBridge(config).start();
+} catch (e) {
+  console.warn('[DevBridge] Failed to load config:', e);
+}
+
+await import('${entrySrc}');
+`;
+            }
+        },
+        transformIndexHtml(html) {
+            // Find the app's entry module script (skip Vite internal /@... scripts)
+            const scriptRegex = /<script\s+type="module"\s+src="((?!\/@)[^"]+)"\s*>\s*<\/script>/;
+            const match = html.match(scriptRegex);
+            if (!match) {
+                console.warn('[DevBridge] Could not find entry module script in index.html');
+                return html;
+            }
+            entrySrc = match[1];
+            if (entrySrc.startsWith('.')) {
+                entrySrc = viteRoot + '/' + entrySrc.replace(/^\.\//, '');
+            }
+            else if (entrySrc.startsWith('/')) {
+                entrySrc = viteRoot + entrySrc;
+            }
+            return html.replace(match[0], `<script type="module" src="${VIRTUAL_ID}"></script>`);
+        },
+    };
+}
+// ─── Lua Plugin ─────────────────────────────────────────
+/**
+ * Vite plugin that:
+ * 1. Enables importing `.lua` files as raw strings with HMR
+ * 2. Runs a LuaEngine on the Vite dev server (Node.js) via POST /__lua-play
+ *
+ * fengari runs server-side only — no browser shims needed.
+ */
+function luaPlugin(configPath) {
+    let luaEngine = null;
+    let viteServer = null;
+    async function initEngine() {
+        if (!viteServer)
+            return;
+        try {
+            // Invalidate cached modules so HMR picks up changes
+            const root = viteServer.config.root;
+            const fullConfigPath = configPath.startsWith('.')
+                ? root + '/' + configPath.replace(/^\.\//, '')
+                : configPath;
+            // Invalidate the config module and its dependencies
+            const configMod = viteServer.moduleGraph.getModuleById(fullConfigPath);
+            if (configMod)
+                viteServer.moduleGraph.invalidateModule(configMod);
+            // ssrLoadModule handles TS transpilation and resolves all imports
+            const mod = await viteServer.ssrLoadModule(fullConfigPath);
+            const config = mod.default ?? mod.config ?? mod;
+            if (!config.luaScript || !config.gameDefinition) {
+                console.log('[LuaPlugin] No luaScript/gameDefinition in config — Lua server disabled');
+                luaEngine = null;
+                return;
+            }
+            // Load LuaEngine via SSR (fengari runs natively in Node.js)
+            const luaMod = await viteServer.ssrLoadModule('@energy8platform/platform-core/lua');
+            const { LuaEngine } = luaMod;
+            if (luaEngine)
+                luaEngine.destroy();
+            luaEngine = new LuaEngine({
+                script: config.luaScript,
+                gameDefinition: config.gameDefinition,
+                seed: config.luaSeed,
+            });
+            console.log('[LuaPlugin] LuaEngine initialized (server-side)');
+        }
+        catch (e) {
+            console.warn('[LuaPlugin] Failed to initialize LuaEngine:', e.message);
+            luaEngine = null;
+        }
+    }
+    return {
+        name: 'platform-core:lua',
+        apply: 'serve',
+        async configureServer(server) {
+            viteServer = server;
+            await initEngine();
+            // POST /__lua-play — execute Lua on the server
+            server.middlewares.use('/__lua-play', (req, res) => {
+                if (req.method !== 'POST') {
+                    res.statusCode = 405;
+                    res.end('Method Not Allowed');
+                    return;
+                }
+                let body = '';
+                req.on('data', (chunk) => { body += chunk; });
+                req.on('end', () => {
+                    try {
+                        if (!luaEngine) {
+                            res.statusCode = 503;
+                            res.setHeader('Content-Type', 'application/json');
+                            res.end(JSON.stringify({ error: 'LuaEngine not initialized' }));
+                            return;
+                        }
+                        const params = JSON.parse(body);
+                        const result = luaEngine.execute(params);
+                        res.statusCode = 200;
+                        res.setHeader('Content-Type', 'application/json');
+                        res.end(JSON.stringify(result));
+                    }
+                    catch (e) {
+                        res.statusCode = 500;
+                        res.setHeader('Content-Type', 'application/json');
+                        res.end(JSON.stringify({ error: e.message }));
+                    }
+                });
+            });
+        },
+        transform(code, id) {
+            if (id.endsWith('.lua')) {
+                return {
+                    code: `export default ${JSON.stringify(code)};`,
+                    map: null,
+                };
+            }
+        },
+        async handleHotUpdate({ file, server }) {
+            if (file.endsWith('.lua') || file.includes('dev.config')) {
+                console.log('[LuaPlugin] Reloading LuaEngine...');
+                // Invalidate all SSR modules so ssrLoadModule picks up fresh code
+                server.moduleGraph.invalidateAll();
+                await initEngine();
+                server.ws.send({ type: 'full-reload' });
+                return [];
+            }
+        },
+    };
+}
+
+exports.devBridgePlugin = devBridgePlugin;
+exports.luaPlugin = luaPlugin;
+//# sourceMappingURL=vite.cjs.js.map

package/dist/vite.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.cjs.js","sources":["../src/vite/index.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/vite.d.ts

@@ -0,0 +1,13 @@
+import { Plugin } from 'vite';
+
+declare function devBridgePlugin(configPath: string): Plugin;
+/**
+ * Vite plugin that:
+ * 1. Enables importing `.lua` files as raw strings with HMR
+ * 2. Runs a LuaEngine on the Vite dev server (Node.js) via POST /__lua-play
+ *
+ * fengari runs server-side only — no browser shims needed.
+ */
+declare function luaPlugin(configPath: string): Plugin;
+
+export { devBridgePlugin, luaPlugin };