@energy8platform/game-engine 0.10.2 → 0.10.3

package/dist/vite.esm.js

@@ -64,31 +64,84 @@ await import('${entrySrc}');
 }
 // ─── Lua Plugin ─────────────────────────────────────────
 /**
- * Vite plugin that enables importing `.lua` files as raw strings
- * and triggers a full page reload on `.lua` file changes.
+ * 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`
  *
- * Also shims Node.js built-in modules (`os`, `child_process`, etc.) that
- * `fengari` references at the top level so the library can be pre-bundled
- * by esbuild and run in the browser without errors.
+ * fengari runs server-side only — no browser shims needed.
  */
-const FENGARI_NODE_SHIMS = {
-    os: 'export function platform() { return "browser"; } export default { platform };',
-    child_process: 'export default {};',
-    fs: 'export default {};',
-};
-function luaPlugin() {
+function luaPlugin(configPath) {
+    let luaEngine = null;
+    let viteServer = null;
+    async function initEngine() {
+        if (!viteServer)
+            return;
+        try {
+            // Use Vite's SSR module loader to handle .ts config files
+            const resolvedPath = configPath.startsWith('.')
+                ? '/' + configPath.replace(/^\.\//, '')
+                : configPath;
+            // ssrLoadModule transpiles TS and resolves imports (including ?raw)
+            const mod = await viteServer.ssrLoadModule(resolvedPath);
+            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 too (handles the fengari CJS import in Node.js)
+            const luaMod = await viteServer.ssrLoadModule('@energy8platform/game-engine/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: 'game-engine:lua',
         apply: 'serve',
-        resolveId(id) {
-            if (id in FENGARI_NODE_SHIMS)
-                return `\0fengari-shim:${id}`;
-        },
-        load(id) {
-            if (id.startsWith('\0fengari-shim:')) {
-                const mod = id.slice('\0fengari-shim:'.length);
-                return FENGARI_NODE_SHIMS[mod];
-            }
+        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')) {
@@ -98,8 +151,10 @@ function luaPlugin() {
                 };
             }
         },
-        handleHotUpdate({ file, server }) {
-            if (file.endsWith('.lua')) {
+        async handleHotUpdate({ file, server }) {
+            if (file.endsWith('.lua') || file.includes('dev.config')) {
+                console.log('[LuaPlugin] Reloading LuaEngine...');
+                await initEngine();
                 server.ws.send({ type: 'full-reload' });
                 return [];
             }
@@ -132,26 +187,15 @@ function defineGameConfig(config = {}) {
     if (config.devBridge) {
         const configPath = config.devBridgeConfig ?? './dev.config';
         plugins.push(devBridgePlugin(configPath));
-        plugins.push(luaPlugin());
+        plugins.push(luaPlugin(configPath));
     }
     const userVite = config.vite ?? {};
-    // fengari (Lua 5.3 in JS) is a CJS Node.js package that references `process`
-    // and `require('os')` at module level. Provide shims so it works in the browser.
-    const fengariShims = config.devBridge ? {
-        'process.versions.node': 'undefined',
-        'process.env': '({})',
-        'process.platform': '"browser"',
-    } : {};
     return {
         base: config.base ?? '/',
         plugins: [
             ...plugins,
             ...(userVite.plugins ?? []),
         ],
-        define: {
-            ...fengariShims,
-            ...userVite.define,
-        },
         build: {
             target: 'esnext',
             assetsInlineLimit: 8192,
@@ -193,10 +237,10 @@ function defineGameConfig(config = {}) {
                 'yoga-layout/load',
                 'react',
                 'react-dom',
-                ...(config.devBridge ? ['fengari'] : []),
             ],
             exclude: [
                 'yoga-layout',
+                'fengari',
             ],
             esbuildOptions: {
                 target: 'esnext',

package/dist/vite.esm.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@energy8platform/game-engine",
-  "version": "0.10.2",
+  "version": "0.10.3",
   "description": "Universal casino game engine built on PixiJS v8 and @energy8platform/game-sdk",
   "type": "module",
   "main": "./dist/index.cjs.js",

package/src/debug/DevBridge.ts

@@ -9,7 +9,6 @@ import {
   type PlayParams,
 } from '@energy8platform/game-sdk';
 import type { GameDefinition } from '../lua/types';
-import { LuaEngine } from '../lua/LuaEngine';
 
 export interface DevBridgeConfig {
   /** Mock initial balance */
@@ -28,7 +27,7 @@ export interface DevBridgeConfig {
   networkDelay?: number;
   /** Enable debug logging */
   debug?: boolean;
-  /** Lua script source code. When set, overrides onPlay with LuaEngine. */
+  /** Lua script source code. When set, play requests are routed to the Vite dev server's LuaEngine. */
   luaScript?: string;
   /** Game definition for Lua engine (actions, transitions, etc.) */
   gameDefinition?: GameDefinition;
@@ -60,11 +59,11 @@ const DEFAULT_CONFIG: Omit<Required<DevBridgeConfig>, 'luaScript' | 'gameDefinit
  * `CasinoGameSDK` via a shared in-memory `MemoryChannel`, removing
  * the need for postMessage and iframes.
  *
- * This allows games to be developed and tested without a real backend.
+ * When `luaScript` is set, play requests are sent to the Vite dev server
+ * which runs LuaEngine in Node.js — no fengari in the browser.
  *
  * @example
  * ```ts
- * // In your dev entry point or vite plugin
  * import { DevBridge } from '@energy8platform/game-engine/debug';
  *
  * const devBridge = new DevBridge({
@@ -73,10 +72,7 @@ const DEFAULT_CONFIG: Omit<Required<DevBridgeConfig>, 'luaScript' | 'gameDefinit
  *   gameConfig: { id: 'my-slot', type: 'slot', betLevels: [0.2, 0.5, 1, 2] },
  *   onPlay: ({ action, bet }) => ({
  *     totalWin: Math.random() > 0.5 ? bet * (Math.random() * 20) : 0,
- *     data: {
- *       matrix: generateRandomMatrix(5, 3, 10),
- *       win_lines: [],
- *     },
+ *     data: { matrix: [[1,2,3],[4,5,6],[7,8,9]] },
  *   }),
  * });
  * devBridge.start();
@@ -87,12 +83,12 @@ export class DevBridge {
   private _balance: number;
   private _roundCounter = 0;
   private _bridge: Bridge | null = null;
-  private _luaEngine: LuaEngine | null = null;
+  private _useLuaServer: boolean;
 
   constructor(config: DevBridgeConfig = {}) {
     this._config = { ...DEFAULT_CONFIG, ...config };
     this._balance = this._config.balance;
-    this.initLuaEngine();
+    this._useLuaServer = !!(this._config.luaScript && this._config.gameDefinition);
   }
 
   /** Current mock balance */
@@ -133,7 +129,8 @@ export class DevBridge {
     });
 
     if (this._config.debug) {
-      console.log('[DevBridge] Started — listening via Bridge (devMode)');
+      const mode = this._useLuaServer ? 'Lua (server-side)' : 'onPlay callback';
+      console.log(`[DevBridge] Started — mode: ${mode}`);
     }
   }
 
@@ -158,24 +155,6 @@ export class DevBridge {
   /** Destroy the dev bridge */
   destroy(): void {
     this.stop();
-    if (this._luaEngine) {
-      this._luaEngine.destroy();
-      this._luaEngine = null;
-    }
-  }
-
-  private initLuaEngine(): void {
-    if (!this._config.luaScript || !this._config.gameDefinition) return;
-
-    this._luaEngine = new LuaEngine({
-      script: this._config.luaScript,
-      gameDefinition: this._config.gameDefinition,
-      seed: this._config.luaSeed,
-    });
-
-    if (this._config.debug) {
-      console.log('[DevBridge] LuaEngine initialized');
-    }
   }
 
   // ─── Message Handling ──────────────────────────────────
@@ -202,28 +181,18 @@ export class DevBridge {
     this._balance -= bet;
     this._roundCounter++;
 
-    let result: PlayResultData;
-
-    if (this._luaEngine) {
-      // Use LuaEngine for real Lua execution
-      const luaResult = this._luaEngine.execute({ action, bet, roundId, params });
-      const totalWin = luaResult.creditDeferred ? 0 : luaResult.totalWin;
-
-      this._balance += totalWin;
-
-      result = {
-        roundId: roundId ?? `dev-round-${this._roundCounter}`,
-        action,
-        balanceAfter: this._balance,
-        totalWin: Math.round(luaResult.totalWin * 100) / 100,
-        data: luaResult.data,
-        nextActions: luaResult.nextActions,
-        session: luaResult.session,
-        creditPending: luaResult.creditDeferred,
-        bonusFreeSpin: null,
-        currency: this._config.currency,
-        gameId: this._config.gameConfig?.id ?? 'dev-game',
-      };
+    if (this._useLuaServer) {
+      // Send to Vite dev server for Lua execution
+      this.executeLuaOnServer({ action, bet, roundId, params })
+        .then((result) => {
+          this._bridge?.send('PLAY_RESULT', result, id);
+        })
+        .catch((err) => {
+          console.error('[DevBridge] Lua server error:', err);
+          // Refund bet on error
+          this._balance += bet;
+          this._bridge?.send('PLAY_RESULT', this.buildFallbackResult(action, bet, roundId), id);
+        });
     } else {
       // Fallback to onPlay callback
       const customResult = this._config.onPlay({ action, bet, roundId, params });
@@ -231,7 +200,7 @@ export class DevBridge {
 
       this._balance += totalWin;
 
-      result = {
+      const result: PlayResultData = {
         roundId: roundId ?? `dev-round-${this._roundCounter}`,
         action,
         balanceAfter: this._balance,
@@ -244,9 +213,57 @@ export class DevBridge {
         currency: this._config.currency,
         gameId: this._config.gameConfig?.id ?? 'dev-game',
       };
+
+      this.delayedSend('PLAY_RESULT', result, id);
     }
+  }
+
+  private async executeLuaOnServer(params: PlayParams): Promise<PlayResultData> {
+    const response = await fetch('/__lua-play', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(params),
+    });
 
-    this.delayedSend('PLAY_RESULT', result, id);
+    if (!response.ok) {
+      const err = await response.json().catch(() => ({ error: 'Unknown error' }));
+      throw new Error(err.error ?? `HTTP ${response.status}`);
+    }
+
+    const luaResult = await response.json();
+
+    const totalWin = luaResult.creditDeferred ? 0 : luaResult.totalWin;
+    this._balance += totalWin;
+
+    return {
+      roundId: params.roundId ?? `dev-round-${this._roundCounter}`,
+      action: params.action,
+      balanceAfter: this._balance,
+      totalWin: Math.round(luaResult.totalWin * 100) / 100,
+      data: luaResult.data,
+      nextActions: luaResult.nextActions,
+      session: luaResult.session,
+      creditPending: luaResult.creditDeferred,
+      bonusFreeSpin: null,
+      currency: this._config.currency,
+      gameId: this._config.gameConfig?.id ?? 'dev-game',
+    };
+  }
+
+  private buildFallbackResult(action: string, bet: number, roundId?: string): PlayResultData {
+    return {
+      roundId: roundId ?? `dev-round-${this._roundCounter}`,
+      action,
+      balanceAfter: this._balance,
+      totalWin: 0,
+      data: { error: 'Lua execution failed' },
+      nextActions: ['spin'],
+      session: null,
+      creditPending: false,
+      bonusFreeSpin: null,
+      currency: this._config.currency,
+      gameId: this._config.gameConfig?.id ?? 'dev-game',
+    };
   }
 
   private handlePlayAck(_payload: PlayResultAckPayload): void {
@@ -265,7 +282,7 @@ export class DevBridge {
 
   private handleOpenDeposit(): void {
     if (this._config.debug) {
-      console.log('[DevBridge] 💰 Open deposit requested (mock: adding 1000)');
+      console.log('[DevBridge] Open deposit requested (mock: adding 1000)');
     }
     this._balance += 1000;
     this._bridge?.send('BALANCE_UPDATE', { balance: this._balance });

package/src/index.ts

@@ -101,14 +101,9 @@ export type { DevBridgeConfig } from './debug/DevBridge';
 export { FPSOverlay } from './debug/FPSOverlay';
 
 // ─── Lua ────────────────────────────────────────────────
-// NOTE: fengari is an optional peer dependency.
-// Import Lua components from '@energy8platform/game-engine/lua' sub-path
-// to avoid pulling in fengari when it isn't installed.
-export { LuaEngine } from './lua/LuaEngine';
-export { LuaEngineAPI, createSeededRng } from './lua/LuaEngineAPI';
-export { ActionRouter, evaluateCondition } from './lua/ActionRouter';
-export { SessionManager } from './lua/SessionManager';
-export { PersistentState } from './lua/PersistentState';
+// Lua module is Node.js only (fengari). Use the sub-path import:
+//   import { LuaEngine } from '@energy8platform/game-engine/lua'
+// Re-export only types (zero runtime cost, no fengari in browser bundle).
 export type {
   GameDefinition,
   ActionDefinition,

package/src/lua/LuaEngine.ts

@@ -6,9 +6,8 @@ import { SessionManager } from './SessionManager';
 import { PersistentState } from './PersistentState';
 
 // fengari — Lua 5.3 in pure JavaScript
-// eslint-disable-next-line @typescript-eslint/no-var-requires
-declare const require: (module: string) => any;
-const fengari = require('fengari');
+import fengari from 'fengari';
+
 const { lua, lauxlib, lualib } = fengari;
 const { to_luastring, to_jsstring } = fengari;
 

package/src/lua/LuaEngineAPI.ts

@@ -1,9 +1,6 @@
 import type { GameDefinition } from './types';
+import fengari from 'fengari';
 
-// fengari is a CJS module — use dynamic import workaround for ESM compatibility
-// eslint-disable-next-line @typescript-eslint/no-var-requires
-declare const require: (module: string) => any;
-const fengari = require('fengari');
 const { lua, lauxlib } = fengari;
 const { to_luastring, to_jsstring } = fengari;
 

package/src/lua/fengari.d.ts

@@ -0,0 +1,10 @@
+declare module 'fengari' {
+  const fengari: {
+    lua: any;
+    lauxlib: any;
+    lualib: any;
+    to_luastring: (str: string) => Uint8Array;
+    to_jsstring: (str: Uint8Array) => string;
+  };
+  export default fengari;
+}

package/src/vite/index.ts

@@ -91,33 +91,92 @@ await import('${entrySrc}');
 // ─── Lua Plugin ─────────────────────────────────────────
 
 /**
- * Vite plugin that enables importing `.lua` files as raw strings
- * and triggers a full page reload on `.lua` file changes.
+ * 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`
  *
- * Also shims Node.js built-in modules (`os`, `child_process`, etc.) that
- * `fengari` references at the top level so the library can be pre-bundled
- * by esbuild and run in the browser without errors.
+ * fengari runs server-side only — no browser shims needed.
  */
-const FENGARI_NODE_SHIMS: Record<string, string> = {
-  os: 'export function platform() { return "browser"; } export default { platform };',
-  child_process: 'export default {};',
-  fs: 'export default {};',
-};
+function luaPlugin(configPath: string): Plugin {
+  let luaEngine: any = null;
+  let viteServer: any = null;
+
+  async function initEngine() {
+    if (!viteServer) return;
+
+    try {
+      // Use Vite's SSR module loader to handle .ts config files
+      const resolvedPath = configPath.startsWith('.')
+        ? '/' + configPath.replace(/^\.\//, '')
+        : configPath;
+
+      // ssrLoadModule transpiles TS and resolves imports (including ?raw)
+      const mod = await viteServer.ssrLoadModule(resolvedPath);
+      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 too (handles the fengari CJS import in Node.js)
+      const luaMod = await viteServer.ssrLoadModule('@energy8platform/game-engine/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: any) {
+      console.warn('[LuaPlugin] Failed to initialize LuaEngine:', e.message);
+      luaEngine = null;
+    }
+  }
 
-function luaPlugin(): Plugin {
   return {
     name: 'game-engine:lua',
     apply: 'serve',
 
-    resolveId(id: string) {
-      if (id in FENGARI_NODE_SHIMS) return `\0fengari-shim:${id}`;
-    },
-
-    load(id: string) {
-      if (id.startsWith('\0fengari-shim:')) {
-        const mod = id.slice('\0fengari-shim:'.length);
-        return FENGARI_NODE_SHIMS[mod];
-      }
+    async configureServer(server) {
+      viteServer = server;
+      await initEngine();
+
+      // POST /__lua-play — execute Lua on the server
+      server.middlewares.use('/__lua-play', (req: any, res: any) => {
+        if (req.method !== 'POST') {
+          res.statusCode = 405;
+          res.end('Method Not Allowed');
+          return;
+        }
+
+        let body = '';
+        req.on('data', (chunk: string) => { 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: any) {
+            res.statusCode = 500;
+            res.setHeader('Content-Type', 'application/json');
+            res.end(JSON.stringify({ error: e.message }));
+          }
+        });
+      });
     },
 
     transform(code: string, id: string) {
@@ -129,8 +188,10 @@ function luaPlugin(): Plugin {
       }
     },
 
-    handleHotUpdate({ file, server }: { file: string; server: any }) {
-      if (file.endsWith('.lua')) {
+    async handleHotUpdate({ file, server }: { file: string; server: any }) {
+      if (file.endsWith('.lua') || file.includes('dev.config')) {
+        console.log('[LuaPlugin] Reloading LuaEngine...');
+        await initEngine();
         server.ws.send({ type: 'full-reload' });
         return [];
       }
@@ -166,19 +227,11 @@ export function defineGameConfig(config: GameConfig = {}): UserConfig {
   if (config.devBridge) {
     const configPath = config.devBridgeConfig ?? './dev.config';
     plugins.push(devBridgePlugin(configPath));
-    plugins.push(luaPlugin());
+    plugins.push(luaPlugin(configPath));
   }
 
   const userVite = config.vite ?? {};
 
-  // fengari (Lua 5.3 in JS) is a CJS Node.js package that references `process`
-  // and `require('os')` at module level. Provide shims so it works in the browser.
-  const fengariShims: Record<string, string> = config.devBridge ? {
-    'process.versions.node': 'undefined',
-    'process.env': '({})',
-    'process.platform': '"browser"',
-  } : {};
-
   return {
     base: config.base ?? '/',
 
@@ -187,11 +240,6 @@ export function defineGameConfig(config: GameConfig = {}): UserConfig {
       ...((userVite.plugins as Plugin[]) ?? []),
     ],
 
-    define: {
-      ...fengariShims,
-      ...(userVite as Record<string, any>).define,
-    },
-
     build: {
       target: 'esnext',
       assetsInlineLimit: 8192,
@@ -236,10 +284,10 @@ export function defineGameConfig(config: GameConfig = {}): UserConfig {
         'yoga-layout/load',
         'react',
         'react-dom',
-        ...(config.devBridge ? ['fengari'] : []),
       ],
       exclude: [
         'yoga-layout',
+        'fengari',
       ],
       esbuildOptions: {
         target: 'esnext',