@omnitronix/game-engine-sdk 2.0.1 → 2.1.0

package/dist/debug/debug-command-registry.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Debug Command Registry
+ *
+ * A registry pattern implementation for debug commands that provides
+ * a single source of truth for both definitions and execution.
+ *
+ * This eliminates the risk of definition/implementation drift by
+ * co-locating the command metadata with its handler.
+ *
+ * @example
+ * ```typescript
+ * const debugCommands = createDebugCommandRegistry({
+ *   TRIGGER_BONUS: {
+ *     displayName: 'Trigger Bonus',
+ *     description: 'Force-trigger a specific bonus type',
+ *     category: 'bonus',
+ *     parameters: [
+ *       {
+ *         name: 'bonusType',
+ *         displayName: 'Bonus Type',
+ *         type: 'enum',
+ *         enumValues: ['BONUS_GAME', 'FREE_SPIN_AIR', 'FREE_SPIN_WATER'],
+ *       },
+ *     ],
+ *     execute: async (engine, params) => {
+ *       return engine.triggerBonus(params.bonusType);
+ *     },
+ *   },
+ * });
+ *
+ * // Get definitions for dev-tools
+ * const definitions = debugCommands.getDefinitions();
+ *
+ * // Execute a command
+ * const result = await debugCommands.execute('TRIGGER_BONUS', engine, { bonusType: 'BONUS_GAME' });
+ * ```
+ */
+import { DebugCommandDefinition, DebugParameterDefinition } from '@omnitronix/game-engine-contract';
+/**
+ * Handler function type for debug commands.
+ * Receives the game engine instance and validated parameters.
+ */
+export type DebugCommandHandler<TEngine, TParams, TResult> = (engine: TEngine, params: TParams) => Promise<TResult> | TResult;
+/**
+ * Configuration for a single debug command in the registry.
+ */
+export interface DebugCommandConfig<TEngine, TParams = Record<string, unknown>, TResult = unknown> {
+    /**
+     * Human-readable display name
+     */
+    displayName: string;
+    /**
+     * Detailed description of what this command does
+     */
+    description?: string;
+    /**
+     * Grouping category for UI organization
+     */
+    category?: string;
+    /**
+     * Parameter definitions
+     */
+    parameters?: DebugParameterDefinition[];
+    /**
+     * Whether this command can cause issues (shows warning in UI)
+     */
+    dangerous?: boolean;
+    /**
+     * Warning message to display
+     */
+    warningMessage?: string;
+    /**
+     * The command execution handler
+     */
+    execute: DebugCommandHandler<TEngine, TParams, TResult>;
+}
+/**
+ * Registry configuration type.
+ * Maps command codes to their configurations.
+ */
+export type DebugCommandRegistryConfig<TEngine> = {
+    [code: string]: DebugCommandConfig<TEngine, any, any>;
+};
+/**
+ * The debug command registry interface.
+ */
+export interface DebugCommandRegistry<TEngine> {
+    /**
+     * Get all command definitions (for dev-tools).
+     * Safe to call - strips execute handlers before returning.
+     */
+    getDefinitions(): DebugCommandDefinition[];
+    /**
+     * Execute a debug command by code.
+     *
+     * @param code - The command code to execute
+     * @param engine - The game engine instance
+     * @param params - The command parameters
+     * @throws Error if command code is not found
+     */
+    execute<TResult = unknown>(code: string, engine: TEngine, params: Record<string, unknown>): Promise<TResult>;
+    /**
+     * Check if a command code exists in the registry.
+     */
+    hasCommand(code: string): boolean;
+    /**
+     * Get list of all registered command codes.
+     */
+    getCommandCodes(): string[];
+}
+/**
+ * Creates a debug command registry with type-safe definitions and handlers.
+ *
+ * The registry pattern ensures that:
+ * 1. Definitions and handlers are always in sync (single source of truth)
+ * 2. Type safety is maintained for parameters
+ * 3. Unknown commands throw clear errors
+ *
+ * @param config - Map of command codes to their configurations
+ * @returns A registry object with getDefinitions() and execute() methods
+ *
+ * @example
+ * ```typescript
+ * const registry = createDebugCommandRegistry({
+ *   FORCE_WIN: {
+ *     displayName: 'Force Win',
+ *     description: 'Force the next spin to be a winning spin',
+ *     category: 'testing',
+ *     parameters: [
+ *       { name: 'multiplier', displayName: 'Win Multiplier', type: 'number', min: 1, max: 100 },
+ *     ],
+ *     execute: async (engine, { multiplier }) => {
+ *       return engine.setNextWinMultiplier(multiplier);
+ *     },
+ *   },
+ * });
+ * ```
+ */
+export declare function createDebugCommandRegistry<TEngine>(config: DebugCommandRegistryConfig<TEngine>): DebugCommandRegistry<TEngine>;
+/**
+ * Security error thrown when debug features are accessed in production.
+ */
+export declare class DebugSecurityError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Production guard wrapper for debug definitions.
+ *
+ * Throws DebugSecurityError in production environments as defense-in-depth.
+ * This should be called at the start of getDebugCommandDefinitions().
+ *
+ * @param logger - Optional logger for audit logging
+ * @throws DebugSecurityError if NODE_ENV is 'production'
+ *
+ * @example
+ * ```typescript
+ * getDebugCommandDefinitions(): DebugCommandDefinition[] {
+ *   assertNotProduction(this.logger);
+ *   return this.debugRegistry.getDefinitions();
+ * }
+ * ```
+ */
+export declare function assertNotProduction(logger?: {
+    warn: (msg: string, ctx?: object) => void;
+}): void;
+/**
+ * Wraps a getDebugCommandDefinitions implementation with production guard.
+ *
+ * @param getDefinitions - The function that returns definitions
+ * @param logger - Optional logger for audit logging
+ * @returns A wrapped function that throws in production
+ *
+ * @example
+ * ```typescript
+ * class MyEngine implements DebugIntrospectable {
+ *   getDebugCommandDefinitions = withProductionGuard(
+ *     () => this.debugRegistry.getDefinitions(),
+ *     this.logger,
+ *   );
+ * }
+ * ```
+ */
+export declare function withProductionGuard(getDefinitions: () => DebugCommandDefinition[], logger?: {
+    warn: (msg: string, ctx?: object) => void;
+}): () => DebugCommandDefinition[];
+//# sourceMappingURL=debug-command-registry.d.ts.map

package/dist/debug/debug-command-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-command-registry.d.ts","sourceRoot":"","sources":["../../src/debug/debug-command-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,kCAAkC,CAAC;AAE1C;;;GAGG;AACH,MAAM,MAAM,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,CAC3D,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,OAAO,KACZ,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO;IAC/F;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,wBAAwB,EAAE,CAAC;IAExC;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,OAAO,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;CACzD;AAED;;;GAGG;AACH,MAAM,MAAM,0BAA0B,CAAC,OAAO,IAAI;IAChD,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;CACvD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,OAAO;IAC3C;;;OAGG;IACH,cAAc,IAAI,sBAAsB,EAAE,CAAC;IAE3C;;;;;;;OAOG;IACH,OAAO,CAAC,OAAO,GAAG,OAAO,EACvB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAElC;;OAEG;IACH,eAAe,IAAI,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAChD,MAAM,EAAE,0BAA0B,CAAC,OAAO,CAAC,GAC1C,oBAAoB,CAAC,OAAO,CAAC,CA6C/B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,GAAE,MAAyD;CAI/E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GAAG,IAAI,CAQhG;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,sBAAsB,EAAE,EAC9C,MAAM,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GACrD,MAAM,sBAAsB,EAAE,CAKhC"}

package/dist/debug/debug-command-registry.js

@@ -0,0 +1,163 @@
+"use strict";
+/**
+ * Debug Command Registry
+ *
+ * A registry pattern implementation for debug commands that provides
+ * a single source of truth for both definitions and execution.
+ *
+ * This eliminates the risk of definition/implementation drift by
+ * co-locating the command metadata with its handler.
+ *
+ * @example
+ * ```typescript
+ * const debugCommands = createDebugCommandRegistry({
+ *   TRIGGER_BONUS: {
+ *     displayName: 'Trigger Bonus',
+ *     description: 'Force-trigger a specific bonus type',
+ *     category: 'bonus',
+ *     parameters: [
+ *       {
+ *         name: 'bonusType',
+ *         displayName: 'Bonus Type',
+ *         type: 'enum',
+ *         enumValues: ['BONUS_GAME', 'FREE_SPIN_AIR', 'FREE_SPIN_WATER'],
+ *       },
+ *     ],
+ *     execute: async (engine, params) => {
+ *       return engine.triggerBonus(params.bonusType);
+ *     },
+ *   },
+ * });
+ *
+ * // Get definitions for dev-tools
+ * const definitions = debugCommands.getDefinitions();
+ *
+ * // Execute a command
+ * const result = await debugCommands.execute('TRIGGER_BONUS', engine, { bonusType: 'BONUS_GAME' });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DebugSecurityError = void 0;
+exports.createDebugCommandRegistry = createDebugCommandRegistry;
+exports.assertNotProduction = assertNotProduction;
+exports.withProductionGuard = withProductionGuard;
+/**
+ * Creates a debug command registry with type-safe definitions and handlers.
+ *
+ * The registry pattern ensures that:
+ * 1. Definitions and handlers are always in sync (single source of truth)
+ * 2. Type safety is maintained for parameters
+ * 3. Unknown commands throw clear errors
+ *
+ * @param config - Map of command codes to their configurations
+ * @returns A registry object with getDefinitions() and execute() methods
+ *
+ * @example
+ * ```typescript
+ * const registry = createDebugCommandRegistry({
+ *   FORCE_WIN: {
+ *     displayName: 'Force Win',
+ *     description: 'Force the next spin to be a winning spin',
+ *     category: 'testing',
+ *     parameters: [
+ *       { name: 'multiplier', displayName: 'Win Multiplier', type: 'number', min: 1, max: 100 },
+ *     ],
+ *     execute: async (engine, { multiplier }) => {
+ *       return engine.setNextWinMultiplier(multiplier);
+ *     },
+ *   },
+ * });
+ * ```
+ */
+function createDebugCommandRegistry(config) {
+    // Pre-compute definitions at creation time (immutable)
+    const definitions = Object.entries(config).map(([code, cmdConfig]) => ({
+        code,
+        commandType: `DEBUG_${code}`,
+        displayName: cmdConfig.displayName,
+        description: cmdConfig.description,
+        category: cmdConfig.category,
+        parameters: cmdConfig.parameters,
+        dangerous: cmdConfig.dangerous,
+        warningMessage: cmdConfig.warningMessage,
+    }));
+    return {
+        getDefinitions() {
+            // Return a copy to prevent external mutation
+            return [...definitions];
+        },
+        async execute(code, engine, params) {
+            const cmdConfig = config[code];
+            if (!cmdConfig) {
+                const available = Object.keys(config).join(', ');
+                throw new Error(`Unknown debug command: '${code}'. Available commands: ${available}`);
+            }
+            return cmdConfig.execute(engine, params);
+        },
+        hasCommand(code) {
+            return code in config;
+        },
+        getCommandCodes() {
+            return Object.keys(config);
+        },
+    };
+}
+/**
+ * Security error thrown when debug features are accessed in production.
+ */
+class DebugSecurityError extends Error {
+    constructor(message = 'Debug features are not available in production') {
+        super(message);
+        this.name = 'DebugSecurityError';
+    }
+}
+exports.DebugSecurityError = DebugSecurityError;
+/**
+ * Production guard wrapper for debug definitions.
+ *
+ * Throws DebugSecurityError in production environments as defense-in-depth.
+ * This should be called at the start of getDebugCommandDefinitions().
+ *
+ * @param logger - Optional logger for audit logging
+ * @throws DebugSecurityError if NODE_ENV is 'production'
+ *
+ * @example
+ * ```typescript
+ * getDebugCommandDefinitions(): DebugCommandDefinition[] {
+ *   assertNotProduction(this.logger);
+ *   return this.debugRegistry.getDefinitions();
+ * }
+ * ```
+ */
+function assertNotProduction(logger) {
+    if (process.env.NODE_ENV === 'production') {
+        logger?.warn('Attempted to access debug definitions in production', {
+            timestamp: new Date().toISOString(),
+            nodeEnv: process.env.NODE_ENV,
+        });
+        throw new DebugSecurityError();
+    }
+}
+/**
+ * Wraps a getDebugCommandDefinitions implementation with production guard.
+ *
+ * @param getDefinitions - The function that returns definitions
+ * @param logger - Optional logger for audit logging
+ * @returns A wrapped function that throws in production
+ *
+ * @example
+ * ```typescript
+ * class MyEngine implements DebugIntrospectable {
+ *   getDebugCommandDefinitions = withProductionGuard(
+ *     () => this.debugRegistry.getDefinitions(),
+ *     this.logger,
+ *   );
+ * }
+ * ```
+ */
+function withProductionGuard(getDefinitions, logger) {
+    return () => {
+        assertNotProduction(logger);
+        return getDefinitions();
+    };
+}

package/dist/debug/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Debug Command Infrastructure
+ *
+ * Provides utilities for game engines to implement DebugIntrospectable interface
+ * with the registry pattern for type-safe, single-source-of-truth debug commands.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   createDebugCommandRegistry,
+ *   withProductionGuard,
+ *   DebugCommandRegistry,
+ * } from '@omnitronix/game-engine-sdk/debug';
+ *
+ * const debugRegistry = createDebugCommandRegistry({
+ *   TRIGGER_BONUS: {
+ *     displayName: 'Trigger Bonus',
+ *     description: 'Force trigger a bonus round',
+ *     category: 'bonus',
+ *     execute: async (engine, params) => engine.triggerBonus(params.bonusType),
+ *   },
+ * });
+ * ```
+ */
+export { createDebugCommandRegistry, assertNotProduction, withProductionGuard, DebugSecurityError, DebugCommandHandler, DebugCommandConfig, DebugCommandRegistryConfig, DebugCommandRegistry, } from './debug-command-registry';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/debug/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAEL,0BAA0B,EAE1B,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAElB,mBAAmB,EACnB,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,0BAA0B,CAAC"}

package/dist/debug/index.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Debug Command Infrastructure
+ *
+ * Provides utilities for game engines to implement DebugIntrospectable interface
+ * with the registry pattern for type-safe, single-source-of-truth debug commands.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   createDebugCommandRegistry,
+ *   withProductionGuard,
+ *   DebugCommandRegistry,
+ * } from '@omnitronix/game-engine-sdk/debug';
+ *
+ * const debugRegistry = createDebugCommandRegistry({
+ *   TRIGGER_BONUS: {
+ *     displayName: 'Trigger Bonus',
+ *     description: 'Force trigger a bonus round',
+ *     category: 'bonus',
+ *     execute: async (engine, params) => engine.triggerBonus(params.bonusType),
+ *   },
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DebugSecurityError = exports.withProductionGuard = exports.assertNotProduction = exports.createDebugCommandRegistry = void 0;
+var debug_command_registry_1 = require("./debug-command-registry");
+// Registry factory
+Object.defineProperty(exports, "createDebugCommandRegistry", { enumerable: true, get: function () { return debug_command_registry_1.createDebugCommandRegistry; } });
+// Production guards
+Object.defineProperty(exports, "assertNotProduction", { enumerable: true, get: function () { return debug_command_registry_1.assertNotProduction; } });
+Object.defineProperty(exports, "withProductionGuard", { enumerable: true, get: function () { return debug_command_registry_1.withProductionGuard; } });
+Object.defineProperty(exports, "DebugSecurityError", { enumerable: true, get: function () { return debug_command_registry_1.DebugSecurityError; } });

package/dist/esm/debug/debug-command-registry.js

@@ -0,0 +1,156 @@
+/**
+ * Debug Command Registry
+ *
+ * A registry pattern implementation for debug commands that provides
+ * a single source of truth for both definitions and execution.
+ *
+ * This eliminates the risk of definition/implementation drift by
+ * co-locating the command metadata with its handler.
+ *
+ * @example
+ * ```typescript
+ * const debugCommands = createDebugCommandRegistry({
+ *   TRIGGER_BONUS: {
+ *     displayName: 'Trigger Bonus',
+ *     description: 'Force-trigger a specific bonus type',
+ *     category: 'bonus',
+ *     parameters: [
+ *       {
+ *         name: 'bonusType',
+ *         displayName: 'Bonus Type',
+ *         type: 'enum',
+ *         enumValues: ['BONUS_GAME', 'FREE_SPIN_AIR', 'FREE_SPIN_WATER'],
+ *       },
+ *     ],
+ *     execute: async (engine, params) => {
+ *       return engine.triggerBonus(params.bonusType);
+ *     },
+ *   },
+ * });
+ *
+ * // Get definitions for dev-tools
+ * const definitions = debugCommands.getDefinitions();
+ *
+ * // Execute a command
+ * const result = await debugCommands.execute('TRIGGER_BONUS', engine, { bonusType: 'BONUS_GAME' });
+ * ```
+ */
+/**
+ * Creates a debug command registry with type-safe definitions and handlers.
+ *
+ * The registry pattern ensures that:
+ * 1. Definitions and handlers are always in sync (single source of truth)
+ * 2. Type safety is maintained for parameters
+ * 3. Unknown commands throw clear errors
+ *
+ * @param config - Map of command codes to their configurations
+ * @returns A registry object with getDefinitions() and execute() methods
+ *
+ * @example
+ * ```typescript
+ * const registry = createDebugCommandRegistry({
+ *   FORCE_WIN: {
+ *     displayName: 'Force Win',
+ *     description: 'Force the next spin to be a winning spin',
+ *     category: 'testing',
+ *     parameters: [
+ *       { name: 'multiplier', displayName: 'Win Multiplier', type: 'number', min: 1, max: 100 },
+ *     ],
+ *     execute: async (engine, { multiplier }) => {
+ *       return engine.setNextWinMultiplier(multiplier);
+ *     },
+ *   },
+ * });
+ * ```
+ */
+export function createDebugCommandRegistry(config) {
+    // Pre-compute definitions at creation time (immutable)
+    const definitions = Object.entries(config).map(([code, cmdConfig]) => ({
+        code,
+        commandType: `DEBUG_${code}`,
+        displayName: cmdConfig.displayName,
+        description: cmdConfig.description,
+        category: cmdConfig.category,
+        parameters: cmdConfig.parameters,
+        dangerous: cmdConfig.dangerous,
+        warningMessage: cmdConfig.warningMessage,
+    }));
+    return {
+        getDefinitions() {
+            // Return a copy to prevent external mutation
+            return [...definitions];
+        },
+        async execute(code, engine, params) {
+            const cmdConfig = config[code];
+            if (!cmdConfig) {
+                const available = Object.keys(config).join(', ');
+                throw new Error(`Unknown debug command: '${code}'. Available commands: ${available}`);
+            }
+            return cmdConfig.execute(engine, params);
+        },
+        hasCommand(code) {
+            return code in config;
+        },
+        getCommandCodes() {
+            return Object.keys(config);
+        },
+    };
+}
+/**
+ * Security error thrown when debug features are accessed in production.
+ */
+export class DebugSecurityError extends Error {
+    constructor(message = 'Debug features are not available in production') {
+        super(message);
+        this.name = 'DebugSecurityError';
+    }
+}
+/**
+ * Production guard wrapper for debug definitions.
+ *
+ * Throws DebugSecurityError in production environments as defense-in-depth.
+ * This should be called at the start of getDebugCommandDefinitions().
+ *
+ * @param logger - Optional logger for audit logging
+ * @throws DebugSecurityError if NODE_ENV is 'production'
+ *
+ * @example
+ * ```typescript
+ * getDebugCommandDefinitions(): DebugCommandDefinition[] {
+ *   assertNotProduction(this.logger);
+ *   return this.debugRegistry.getDefinitions();
+ * }
+ * ```
+ */
+export function assertNotProduction(logger) {
+    if (process.env.NODE_ENV === 'production') {
+        logger?.warn('Attempted to access debug definitions in production', {
+            timestamp: new Date().toISOString(),
+            nodeEnv: process.env.NODE_ENV,
+        });
+        throw new DebugSecurityError();
+    }
+}
+/**
+ * Wraps a getDebugCommandDefinitions implementation with production guard.
+ *
+ * @param getDefinitions - The function that returns definitions
+ * @param logger - Optional logger for audit logging
+ * @returns A wrapped function that throws in production
+ *
+ * @example
+ * ```typescript
+ * class MyEngine implements DebugIntrospectable {
+ *   getDebugCommandDefinitions = withProductionGuard(
+ *     () => this.debugRegistry.getDefinitions(),
+ *     this.logger,
+ *   );
+ * }
+ * ```
+ */
+export function withProductionGuard(getDefinitions, logger) {
+    return () => {
+        assertNotProduction(logger);
+        return getDefinitions();
+    };
+}

package/dist/esm/debug/index.js

@@ -0,0 +1,29 @@
+/**
+ * Debug Command Infrastructure
+ *
+ * Provides utilities for game engines to implement DebugIntrospectable interface
+ * with the registry pattern for type-safe, single-source-of-truth debug commands.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   createDebugCommandRegistry,
+ *   withProductionGuard,
+ *   DebugCommandRegistry,
+ * } from '@omnitronix/game-engine-sdk/debug';
+ *
+ * const debugRegistry = createDebugCommandRegistry({
+ *   TRIGGER_BONUS: {
+ *     displayName: 'Trigger Bonus',
+ *     description: 'Force trigger a bonus round',
+ *     category: 'bonus',
+ *     execute: async (engine, params) => engine.triggerBonus(params.bonusType),
+ *   },
+ * });
+ * ```
+ */
+export { 
+// Registry factory
+createDebugCommandRegistry, 
+// Production guards
+assertNotProduction, withProductionGuard, DebugSecurityError, } from './debug-command-registry';

package/dist/esm/generated/game-engine-registry_pb.js

@@ -1,27 +1,21 @@
 // @generated by protoc-gen-es v2.11.0 with parameter "target=ts"
 // @generated from file game-engine-registry.proto (package game_engine_registry, syntax proto3)
 /* eslint-disable */
-import { fileDesc, messageDesc, serviceDesc } from '@bufbuild/protobuf/codegenv2';
+import { fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv2";
 /**
  * Describes the file game-engine-registry.proto.
  */
-export const file_game_engine_registry = 
-/*@__PURE__*/
-fileDesc('ChpnYW1lLWVuZ2luZS1yZWdpc3RyeS5wcm90bxIUZ2FtZV9lbmdpbmVfcmVnaXN0cnkilgEKGVJlZ2lzdGVyR2FtZUVuZ2luZVJlcXVlc3QSEQoJZ2FtZV9jb2RlGAEgASgJEg8KB3ZlcnNpb24YAiABKAkSCwoDcnRwGAMgASgBEhEKCWdhbWVfdHlwZRgEIAEoCRIQCghncnBjX3VybBgFIAEoCRIRCglnYW1lX25hbWUYBiABKAkSEAoIcHJvdmlkZXIYByABKAkiTwoaUmVnaXN0ZXJHYW1lRW5naW5lUmVzcG9uc2USDwoHc3VjY2VzcxgBIAEoCBIUCgdtZXNzYWdlGAIgASgJSACIAQFCCgoIX21lc3NhZ2UylAEKGUdhbWVFbmdpbmVSZWdpc3RyeVNlcnZpY2USdwoSUmVnaXN0ZXJHYW1lRW5naW5lEi8uZ2FtZV9lbmdpbmVfcmVnaXN0cnkuUmVnaXN0ZXJHYW1lRW5naW5lUmVxdWVzdBowLmdhbWVfZW5naW5lX3JlZ2lzdHJ5LlJlZ2lzdGVyR2FtZUVuZ2luZVJlc3BvbnNlYgZwcm90bzM');
+export const file_game_engine_registry = /*@__PURE__*/ fileDesc("ChpnYW1lLWVuZ2luZS1yZWdpc3RyeS5wcm90bxIUZ2FtZV9lbmdpbmVfcmVnaXN0cnkilgEKGVJlZ2lzdGVyR2FtZUVuZ2luZVJlcXVlc3QSEQoJZ2FtZV9jb2RlGAEgASgJEg8KB3ZlcnNpb24YAiABKAkSCwoDcnRwGAMgASgBEhEKCWdhbWVfdHlwZRgEIAEoCRIQCghncnBjX3VybBgFIAEoCRIRCglnYW1lX25hbWUYBiABKAkSEAoIcHJvdmlkZXIYByABKAkiTwoaUmVnaXN0ZXJHYW1lRW5naW5lUmVzcG9uc2USDwoHc3VjY2VzcxgBIAEoCBIUCgdtZXNzYWdlGAIgASgJSACIAQFCCgoIX21lc3NhZ2UylAEKGUdhbWVFbmdpbmVSZWdpc3RyeVNlcnZpY2USdwoSUmVnaXN0ZXJHYW1lRW5naW5lEi8uZ2FtZV9lbmdpbmVfcmVnaXN0cnkuUmVnaXN0ZXJHYW1lRW5naW5lUmVxdWVzdBowLmdhbWVfZW5naW5lX3JlZ2lzdHJ5LlJlZ2lzdGVyR2FtZUVuZ2luZVJlc3BvbnNlYgZwcm90bzM");
 /**
  * Describes the message game_engine_registry.RegisterGameEngineRequest.
  * Use `create(RegisterGameEngineRequestSchema)` to create a new message.
  */
-export const RegisterGameEngineRequestSchema = 
-/*@__PURE__*/
-messageDesc(file_game_engine_registry, 0);
+export const RegisterGameEngineRequestSchema = /*@__PURE__*/ messageDesc(file_game_engine_registry, 0);
 /**
  * Describes the message game_engine_registry.RegisterGameEngineResponse.
  * Use `create(RegisterGameEngineResponseSchema)` to create a new message.
  */
-export const RegisterGameEngineResponseSchema = 
-/*@__PURE__*/
-messageDesc(file_game_engine_registry, 1);
+export const RegisterGameEngineResponseSchema = /*@__PURE__*/ messageDesc(file_game_engine_registry, 1);
 /**
  * @generated from service game_engine_registry.GameEngineRegistryService
  */

package/dist/esm/generated/game-engine_pb.js

@@ -1,56 +1,42 @@
 // @generated by protoc-gen-es v2.11.0 with parameter "target=ts"
 // @generated from file game-engine.proto (package game_engine, syntax proto3)
 /* eslint-disable */
-import { fileDesc, messageDesc, serviceDesc } from '@bufbuild/protobuf/codegenv2';
-import { file_google_protobuf_struct } from '@bufbuild/protobuf/wkt';
+import { fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv2";
+import { file_google_protobuf_struct } from "@bufbuild/protobuf/wkt";
 /**
  * Describes the file game-engine.proto.
  */
-export const file_game_engine = 
-/*@__PURE__*/
-fileDesc('ChFnYW1lLWVuZ2luZS5wcm90bxILZ2FtZV9lbmdpbmUi5QEKFVByb2Nlc3NDb21tYW5kUmVxdWVzdBIyCgxwdWJsaWNfc3RhdGUYASABKAsyFy5nb29nbGUucHJvdG9idWYuU3RydWN0SACIAQESMwoNcHJpdmF0ZV9zdGF0ZRgCIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3RIAYgBARI0Cgdjb21tYW5kGAMgASgLMh4uZ2FtZV9lbmdpbmUuR2FtZUFjdGlvbkNvbW1hbmRIAogBAUIPCg1fcHVibGljX3N0YXRlQhAKDl9wcml2YXRlX3N0YXRlQgoKCF9jb21tYW5kImgKEUdhbWVBY3Rpb25Db21tYW5kEgoKAmlkGAEgASgJEgwKBHR5cGUYAiABKAkSLQoHcGF5bG9hZBgDIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3RIAIgBAUIKCghfcGF5bG9hZCJKChBSbmdPdXRjb21lUmVjb3JkEg4KBnJlc3VsdBgBIAEoARIMCgRzZWVkGAIgASgJEgsKA21pbhgDIAEoARILCgNtYXgYBCABKAEirgMKFlByb2Nlc3NDb21tYW5kUmVzcG9uc2USDwoHc3VjY2VzcxgBIAEoCBIyCgxwdWJsaWNfc3RhdGUYAiABKAsyFy5nb29nbGUucHJvdG9idWYuU3RydWN0SACIAQESMwoNcHJpdmF0ZV9zdGF0ZRgDIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3RIAYgBARItCgdvdXRjb21lGAQgASgLMhcuZ29vZ2xlLnByb3RvYnVmLlN0cnVjdEgCiAEBEhQKB21lc3NhZ2UYBSABKAlIA4gBARJICgtybmdfb3V0Y29tZRgGIAMoCzIzLmdhbWVfZW5naW5lLlByb2Nlc3NDb21tYW5kUmVzcG9uc2UuUm5nT3V0Y29tZUVudHJ5GlAKD1JuZ091dGNvbWVFbnRyeRILCgNrZXkYASABKAkSLAoFdmFsdWUYAiABKAsyHS5nYW1lX2VuZ2luZS5SbmdPdXRjb21lUmVjb3JkOgI4AUIPCg1fcHVibGljX3N0YXRlQhAKDl9wcml2YXRlX3N0YXRlQgoKCF9vdXRjb21lQgoKCF9tZXNzYWdlIhoKGEdldEdhbWVFbmdpbmVJbmZvUmVxdWVzdCKEAQoZR2V0R2FtZUVuZ2luZUluZm9SZXNwb25zZRIRCglnYW1lX2NvZGUYASABKAkSDwoHdmVyc2lvbhgCIAEoCRILCgNydHAYAyABKAESEQoJZ2FtZV90eXBlGAQgASgJEhEKCWdhbWVfbmFtZRgFIAEoCRIQCghwcm92aWRlchgGIAEoCTLSAQoRR2FtZUVuZ2luZVNlcnZpY2USWQoOUHJvY2Vzc0NvbW1hbmQSIi5nYW1lX2VuZ2luZS5Qcm9jZXNzQ29tbWFuZFJlcXVlc3QaIy5nYW1lX2VuZ2luZS5Qcm9jZXNzQ29tbWFuZFJlc3BvbnNlEmIKEUdldEdhbWVFbmdpbmVJbmZvEiUuZ2FtZV9lbmdpbmUuR2V0R2FtZUVuZ2luZUluZm9SZXF1ZXN0GiYuZ2FtZV9lbmdpbmUuR2V0R2FtZUVuZ2luZUluZm9SZXNwb25zZWIGcHJvdG8z', [file_google_protobuf_struct]);
+export const file_game_engine = /*@__PURE__*/ fileDesc("ChFnYW1lLWVuZ2luZS5wcm90bxILZ2FtZV9lbmdpbmUisAIKFVByb2Nlc3NDb21tYW5kUmVxdWVzdBIyCgxwdWJsaWNfc3RhdGUYASABKAsyFy5nb29nbGUucHJvdG9idWYuU3RydWN0SACIAQESMwoNcHJpdmF0ZV9zdGF0ZRgCIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3RIAYgBARI0Cgdjb21tYW5kGAMgASgLMh4uZ2FtZV9lbmdpbmUuR2FtZUFjdGlvbkNvbW1hbmRIAogBARI1Cg9hZGRpdGlvbmFsX2RhdGEYBCABKAsyFy5nb29nbGUucHJvdG9idWYuU3RydWN0SAOIAQFCDwoNX3B1YmxpY19zdGF0ZUIQCg5fcHJpdmF0ZV9zdGF0ZUIKCghfY29tbWFuZEISChBfYWRkaXRpb25hbF9kYXRhImgKEUdhbWVBY3Rpb25Db21tYW5kEgoKAmlkGAEgASgJEgwKBHR5cGUYAiABKAkSLQoHcGF5bG9hZBgDIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3RIAIgBAUIKCghfcGF5bG9hZCJKChBSbmdPdXRjb21lUmVjb3JkEg4KBnJlc3VsdBgBIAEoARIMCgRzZWVkGAIgASgJEgsKA21pbhgDIAEoARILCgNtYXgYBCABKAEi+QMKFlByb2Nlc3NDb21tYW5kUmVzcG9uc2USDwoHc3VjY2VzcxgBIAEoCBIyCgxwdWJsaWNfc3RhdGUYAiABKAsyFy5nb29nbGUucHJvdG9idWYuU3RydWN0SACIAQESMwoNcHJpdmF0ZV9zdGF0ZRgDIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3RIAYgBARItCgdvdXRjb21lGAQgASgLMhcuZ29vZ2xlLnByb3RvYnVmLlN0cnVjdEgCiAEBEhQKB21lc3NhZ2UYBSABKAlIA4gBARJICgtybmdfb3V0Y29tZRgGIAMoCzIzLmdhbWVfZW5naW5lLlByb2Nlc3NDb21tYW5kUmVzcG9uc2UuUm5nT3V0Y29tZUVudHJ5EjUKD2FkZGl0aW9uYWxfZGF0YRgHIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3RIBIgBARpQCg9SbmdPdXRjb21lRW50cnkSCwoDa2V5GAEgASgJEiwKBXZhbHVlGAIgASgLMh0uZ2FtZV9lbmdpbmUuUm5nT3V0Y29tZVJlY29yZDoCOAFCDwoNX3B1YmxpY19zdGF0ZUIQCg5fcHJpdmF0ZV9zdGF0ZUIKCghfb3V0Y29tZUIKCghfbWVzc2FnZUISChBfYWRkaXRpb25hbF9kYXRhIhoKGEdldEdhbWVFbmdpbmVJbmZvUmVxdWVzdCKEAQoZR2V0R2FtZUVuZ2luZUluZm9SZXNwb25zZRIRCglnYW1lX2NvZGUYASABKAkSDwoHdmVyc2lvbhgCIAEoCRILCgNydHAYAyABKAESEQoJZ2FtZV90eXBlGAQgASgJEhEKCWdhbWVfbmFtZRgFIAEoCRIQCghwcm92aWRlchgGIAEoCTLSAQoRR2FtZUVuZ2luZVNlcnZpY2USWQoOUHJvY2Vzc0NvbW1hbmQSIi5nYW1lX2VuZ2luZS5Qcm9jZXNzQ29tbWFuZFJlcXVlc3QaIy5nYW1lX2VuZ2luZS5Qcm9jZXNzQ29tbWFuZFJlc3BvbnNlEmIKEUdldEdhbWVFbmdpbmVJbmZvEiUuZ2FtZV9lbmdpbmUuR2V0R2FtZUVuZ2luZUluZm9SZXF1ZXN0GiYuZ2FtZV9lbmdpbmUuR2V0R2FtZUVuZ2luZUluZm9SZXNwb25zZWIGcHJvdG8z", [file_google_protobuf_struct]);
 /**
  * Describes the message game_engine.ProcessCommandRequest.
  * Use `create(ProcessCommandRequestSchema)` to create a new message.
  */
-export const ProcessCommandRequestSchema = 
-/*@__PURE__*/
-messageDesc(file_game_engine, 0);
+export const ProcessCommandRequestSchema = /*@__PURE__*/ messageDesc(file_game_engine, 0);
 /**
  * Describes the message game_engine.GameActionCommand.
  * Use `create(GameActionCommandSchema)` to create a new message.
  */
-export const GameActionCommandSchema = 
-/*@__PURE__*/
-messageDesc(file_game_engine, 1);
+export const GameActionCommandSchema = /*@__PURE__*/ messageDesc(file_game_engine, 1);
 /**
  * Describes the message game_engine.RngOutcomeRecord.
  * Use `create(RngOutcomeRecordSchema)` to create a new message.
  */
-export const RngOutcomeRecordSchema = 
-/*@__PURE__*/
-messageDesc(file_game_engine, 2);
+export const RngOutcomeRecordSchema = /*@__PURE__*/ messageDesc(file_game_engine, 2);
 /**
  * Describes the message game_engine.ProcessCommandResponse.
  * Use `create(ProcessCommandResponseSchema)` to create a new message.
  */
-export const ProcessCommandResponseSchema = 
-/*@__PURE__*/
-messageDesc(file_game_engine, 3);
+export const ProcessCommandResponseSchema = /*@__PURE__*/ messageDesc(file_game_engine, 3);
 /**
  * Describes the message game_engine.GetGameEngineInfoRequest.
  * Use `create(GetGameEngineInfoRequestSchema)` to create a new message.
  */
-export const GetGameEngineInfoRequestSchema = 
-/*@__PURE__*/
-messageDesc(file_game_engine, 4);
+export const GetGameEngineInfoRequestSchema = /*@__PURE__*/ messageDesc(file_game_engine, 4);
 /**
  * Describes the message game_engine.GetGameEngineInfoResponse.
  * Use `create(GetGameEngineInfoResponseSchema)` to create a new message.
  */
-export const GetGameEngineInfoResponseSchema = 
-/*@__PURE__*/
-messageDesc(file_game_engine, 5);
+export const GetGameEngineInfoResponseSchema = /*@__PURE__*/ messageDesc(file_game_engine, 5);
 /**
  * @generated from service game_engine.GameEngineService
  */

package/dist/esm/grpc/game-engine.grpc.in-adapter.js

@@ -28,8 +28,9 @@ let GameEngineGrpcInAdapter = GameEngineGrpcInAdapter_1 = class GameEngineGrpcIn
             const command = this.extractCommandFromRequest(request);
             const publicState = request.publicState ?? {};
             const privateState = request.privateState ?? {};
+            const additionalData = request.additionalData;
             const result = await this.gameEngineInPort.processCommand(publicState, privateState, command);
-            return this.createSuccessResponse(result);
+            return this.createSuccessResponse(result, additionalData);
         }
         catch (error) {
             this.logger.error('Error in processCommand', error);
@@ -49,8 +50,10 @@ let GameEngineGrpcInAdapter = GameEngineGrpcInAdapter_1 = class GameEngineGrpcIn
         }
         return { id, type, payload };
     }
-    createSuccessResponse(result) {
+    createSuccessResponse(result, requestAdditionalData) {
         const rngOutcome = this.convertRngOutcome(result.rngOutcome);
+        // additionalData passthrough: game engine result takes precedence, falls back to request
+        const additionalData = result.additionalData ?? requestAdditionalData;
         return create(ProcessCommandResponseSchema, {
             success: result.success ?? true,
             // Cast at gRPC boundary: game engine state objects are serialized as protobuf Struct
@@ -59,6 +62,7 @@ let GameEngineGrpcInAdapter = GameEngineGrpcInAdapter_1 = class GameEngineGrpcIn
             outcome: result.outcome,
             message: result.message,
             rngOutcome: rngOutcome,
+            additionalData: additionalData,
         });
     }
     /**
@@ -105,15 +109,26 @@ let GameEngineGrpcInAdapter = GameEngineGrpcInAdapter_1 = class GameEngineGrpcIn
      * Validate a single RNG outcome record for GLI-19 compliance.
      * Throws INVALID_RNG_SEED on any invalid numeric field to prevent
      * silent data corruption in the audit trail.
+     *
+     * Note: seed field may come as string from RNG service (JSON parsing).
+     * We accept both number and numeric string for seed since it's converted
+     * to string for wire format anyway.
      */
     validateRngRecord(key, record) {
-        const fields = ['result', 'seed', 'min', 'max'];
-        for (const field of fields) {
+        // Validate result, min, max as strict numbers
+        const strictFields = ['result', 'min', 'max'];
+        for (const field of strictFields) {
             const val = record[field];
             if (typeof val !== 'number' || !isFinite(val)) {
                 throw new DomainException(InternalErrorCode.INVALID_RNG_SEED, `Invalid RNG ${field} for action '${key}': expected finite number, got ${String(val)}`);
             }
         }
+        // Validate seed - allow string or number (RNG service may return string)
+        const seed = record.seed;
+        const seedNum = typeof seed === 'string' ? Number(seed) : seed;
+        if (typeof seedNum !== 'number' || !isFinite(seedNum)) {
+            throw new DomainException(InternalErrorCode.INVALID_RNG_SEED, `Invalid RNG seed for action '${key}': expected finite number, got ${String(seed)}`);
+        }
         if (record.min > record.max) {
             throw new DomainException(InternalErrorCode.INVALID_RNG_SEED, `Invalid RNG range for action '${key}': min (${record.min}) > max (${record.max})`);
         }

package/dist/esm/index.js

@@ -10,6 +10,8 @@ export * from './registration';
 export * from './grpc';
 // Bootstrap
 export { createGameEngineApp } from './bootstrap';
+// Debug command infrastructure
+export * from './debug';
 // Generated proto types (re-exported for convenience)
 export { GameEngineService, ProcessCommandRequestSchema, ProcessCommandResponseSchema, GetGameEngineInfoRequestSchema, GetGameEngineInfoResponseSchema, } from './generated/game-engine_pb';
 export { GameEngineRegistryService, RegisterGameEngineRequestSchema, RegisterGameEngineResponseSchema, } from './generated/game-engine-registry_pb';

package/dist/generated/game-engine-registry_pb.d.ts

@@ -1,5 +1,5 @@
-import type { GenFile, GenMessage, GenService } from '@bufbuild/protobuf/codegenv2';
-import type { Message } from '@bufbuild/protobuf';
+import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
 /**
  * Describes the file game-engine-registry.proto.
  */
@@ -7,7 +7,7 @@ export declare const file_game_engine_registry: GenFile;
 /**
  * @generated from message game_engine_registry.RegisterGameEngineRequest
  */
-export type RegisterGameEngineRequest = Message<'game_engine_registry.RegisterGameEngineRequest'> & {
+export type RegisterGameEngineRequest = Message<"game_engine_registry.RegisterGameEngineRequest"> & {
     /**
      * @generated from field: string game_code = 1;
      */
@@ -45,7 +45,7 @@ export declare const RegisterGameEngineRequestSchema: GenMessage<RegisterGameEng
 /**
  * @generated from message game_engine_registry.RegisterGameEngineResponse
  */
-export type RegisterGameEngineResponse = Message<'game_engine_registry.RegisterGameEngineResponse'> & {
+export type RegisterGameEngineResponse = Message<"game_engine_registry.RegisterGameEngineResponse"> & {
     /**
      * @generated from field: bool success = 1;
      */
@@ -68,7 +68,7 @@ export declare const GameEngineRegistryService: GenService<{
      * @generated from rpc game_engine_registry.GameEngineRegistryService.RegisterGameEngine
      */
     registerGameEngine: {
-        methodKind: 'unary';
+        methodKind: "unary";
         input: typeof RegisterGameEngineRequestSchema;
         output: typeof RegisterGameEngineResponseSchema;
     };

package/dist/generated/game-engine-registry_pb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"game-engine-registry_pb.d.ts","sourceRoot":"","sources":["../../src/generated/game-engine-registry_pb.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAEpF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,OAIrC,CAAC;AAEJ;;GAEG;AACH,MAAM,MAAM,yBAAyB,GACnC,OAAO,CAAC,gDAAgD,CAAC,GAAG;IAC1D;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,+BAA+B,EAAE,UAAU,CAAC,yBAAyB,CAEvC,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,0BAA0B,GACpC,OAAO,CAAC,iDAAiD,CAAC,GAAG;IAC3D;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,gCAAgC,EAAE,UAAU,CAAC,0BAA0B,CAEzC,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,UAAU,CAAC;IACjD;;OAEG;IACH,kBAAkB,EAAE;QAClB,UAAU,EAAE,OAAO,CAAC;QACpB,KAAK,EAAE,OAAO,+BAA+B,CAAC;QAC9C,MAAM,EAAE,OAAO,gCAAgC,CAAC;KACjD,CAAC;CACH,CAA2D,CAAC"}
+{"version":3,"file":"game-engine-registry_pb.d.ts","sourceRoot":"","sources":["../../src/generated/game-engine-registry_pb.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAEpF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,OACqjB,CAAC;AAE9lB;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAC,gDAAgD,CAAC,GAAG;IAClG;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,+BAA+B,EAAE,UAAU,CAAC,yBAAyB,CACvC,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAAC,iDAAiD,CAAC,GAAG;IACpG;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gCAAgC,EAAE,UAAU,CAAC,0BAA0B,CACzC,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,UAAU,CAAC;IACjD;;OAEG;IACH,kBAAkB,EAAE;QAClB,UAAU,EAAE,OAAO,CAAC;QACpB,KAAK,EAAE,OAAO,+BAA+B,CAAC;QAC9C,MAAM,EAAE,OAAO,gCAAgC,CAAC;KACjD,CAAC;CACH,CAC0C,CAAC"}

package/dist/generated/game-engine-registry_pb.js

@@ -8,23 +8,17 @@ const codegenv2_1 = require("@bufbuild/protobuf/codegenv2");
 /**
  * Describes the file game-engine-registry.proto.
  */
-exports.file_game_engine_registry = 
-/*@__PURE__*/
-(0, codegenv2_1.fileDesc)('ChpnYW1lLWVuZ2luZS1yZWdpc3RyeS5wcm90bxIUZ2FtZV9lbmdpbmVfcmVnaXN0cnkilgEKGVJlZ2lzdGVyR2FtZUVuZ2luZVJlcXVlc3QSEQoJZ2FtZV9jb2RlGAEgASgJEg8KB3ZlcnNpb24YAiABKAkSCwoDcnRwGAMgASgBEhEKCWdhbWVfdHlwZRgEIAEoCRIQCghncnBjX3VybBgFIAEoCRIRCglnYW1lX25hbWUYBiABKAkSEAoIcHJvdmlkZXIYByABKAkiTwoaUmVnaXN0ZXJHYW1lRW5naW5lUmVzcG9uc2USDwoHc3VjY2VzcxgBIAEoCBIUCgdtZXNzYWdlGAIgASgJSACIAQFCCgoIX21lc3NhZ2UylAEKGUdhbWVFbmdpbmVSZWdpc3RyeVNlcnZpY2USdwoSUmVnaXN0ZXJHYW1lRW5naW5lEi8uZ2FtZV9lbmdpbmVfcmVnaXN0cnkuUmVnaXN0ZXJHYW1lRW5naW5lUmVxdWVzdBowLmdhbWVfZW5naW5lX3JlZ2lzdHJ5LlJlZ2lzdGVyR2FtZUVuZ2luZVJlc3BvbnNlYgZwcm90bzM');
+exports.file_game_engine_registry = (0, codegenv2_1.fileDesc)("ChpnYW1lLWVuZ2luZS1yZWdpc3RyeS5wcm90bxIUZ2FtZV9lbmdpbmVfcmVnaXN0cnkilgEKGVJlZ2lzdGVyR2FtZUVuZ2luZVJlcXVlc3QSEQoJZ2FtZV9jb2RlGAEgASgJEg8KB3ZlcnNpb24YAiABKAkSCwoDcnRwGAMgASgBEhEKCWdhbWVfdHlwZRgEIAEoCRIQCghncnBjX3VybBgFIAEoCRIRCglnYW1lX25hbWUYBiABKAkSEAoIcHJvdmlkZXIYByABKAkiTwoaUmVnaXN0ZXJHYW1lRW5naW5lUmVzcG9uc2USDwoHc3VjY2VzcxgBIAEoCBIUCgdtZXNzYWdlGAIgASgJSACIAQFCCgoIX21lc3NhZ2UylAEKGUdhbWVFbmdpbmVSZWdpc3RyeVNlcnZpY2USdwoSUmVnaXN0ZXJHYW1lRW5naW5lEi8uZ2FtZV9lbmdpbmVfcmVnaXN0cnkuUmVnaXN0ZXJHYW1lRW5naW5lUmVxdWVzdBowLmdhbWVfZW5naW5lX3JlZ2lzdHJ5LlJlZ2lzdGVyR2FtZUVuZ2luZVJlc3BvbnNlYgZwcm90bzM");
 /**
  * Describes the message game_engine_registry.RegisterGameEngineRequest.
  * Use `create(RegisterGameEngineRequestSchema)` to create a new message.
  */
-exports.RegisterGameEngineRequestSchema = 
-/*@__PURE__*/
-(0, codegenv2_1.messageDesc)(exports.file_game_engine_registry, 0);
+exports.RegisterGameEngineRequestSchema = (0, codegenv2_1.messageDesc)(exports.file_game_engine_registry, 0);
 /**
  * Describes the message game_engine_registry.RegisterGameEngineResponse.
  * Use `create(RegisterGameEngineResponseSchema)` to create a new message.
  */
-exports.RegisterGameEngineResponseSchema = 
-/*@__PURE__*/
-(0, codegenv2_1.messageDesc)(exports.file_game_engine_registry, 1);
+exports.RegisterGameEngineResponseSchema = (0, codegenv2_1.messageDesc)(exports.file_game_engine_registry, 1);
 /**
  * @generated from service game_engine_registry.GameEngineRegistryService
  */

package/dist/generated/game-engine_pb.d.ts

@@ -1,5 +1,5 @@
-import type { GenFile, GenMessage, GenService } from '@bufbuild/protobuf/codegenv2';
-import type { JsonObject, Message } from '@bufbuild/protobuf';
+import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { JsonObject, Message } from "@bufbuild/protobuf";
 /**
  * Describes the file game-engine.proto.
  */
@@ -7,7 +7,7 @@ export declare const file_game_engine: GenFile;
 /**
  * @generated from message game_engine.ProcessCommandRequest
  */
-export type ProcessCommandRequest = Message<'game_engine.ProcessCommandRequest'> & {
+export type ProcessCommandRequest = Message<"game_engine.ProcessCommandRequest"> & {
     /**
      * @generated from field: optional google.protobuf.Struct public_state = 1;
      */
@@ -20,6 +20,10 @@ export type ProcessCommandRequest = Message<'game_engine.ProcessCommandRequest'>
      * @generated from field: optional game_engine.GameActionCommand command = 3;
      */
     command?: GameActionCommand;
+    /**
+     * @generated from field: optional google.protobuf.Struct additional_data = 4;
+     */
+    additionalData?: JsonObject;
 };
 /**
  * Describes the message game_engine.ProcessCommandRequest.
@@ -29,7 +33,7 @@ export declare const ProcessCommandRequestSchema: GenMessage<ProcessCommandReque
 /**
  * @generated from message game_engine.GameActionCommand
  */
-export type GameActionCommand = Message<'game_engine.GameActionCommand'> & {
+export type GameActionCommand = Message<"game_engine.GameActionCommand"> & {
     /**
      * @generated from field: string id = 1;
      */
@@ -51,7 +55,7 @@ export declare const GameActionCommandSchema: GenMessage<GameActionCommand>;
 /**
  * @generated from message game_engine.RngOutcomeRecord
  */
-export type RngOutcomeRecord = Message<'game_engine.RngOutcomeRecord'> & {
+export type RngOutcomeRecord = Message<"game_engine.RngOutcomeRecord"> & {
     /**
      * @generated from field: double result = 1;
      */
@@ -77,7 +81,7 @@ export declare const RngOutcomeRecordSchema: GenMessage<RngOutcomeRecord>;
 /**
  * @generated from message game_engine.ProcessCommandResponse
  */
-export type ProcessCommandResponse = Message<'game_engine.ProcessCommandResponse'> & {
+export type ProcessCommandResponse = Message<"game_engine.ProcessCommandResponse"> & {
     /**
      * @generated from field: bool success = 1;
      */
@@ -106,6 +110,10 @@ export type ProcessCommandResponse = Message<'game_engine.ProcessCommandResponse
     rngOutcome: {
         [key: string]: RngOutcomeRecord;
     };
+    /**
+     * @generated from field: optional google.protobuf.Struct additional_data = 7;
+     */
+    additionalData?: JsonObject;
 };
 /**
  * Describes the message game_engine.ProcessCommandResponse.
@@ -115,7 +123,7 @@ export declare const ProcessCommandResponseSchema: GenMessage<ProcessCommandResp
 /**
  * @generated from message game_engine.GetGameEngineInfoRequest
  */
-export type GetGameEngineInfoRequest = Message<'game_engine.GetGameEngineInfoRequest'> & {};
+export type GetGameEngineInfoRequest = Message<"game_engine.GetGameEngineInfoRequest"> & {};
 /**
  * Describes the message game_engine.GetGameEngineInfoRequest.
  * Use `create(GetGameEngineInfoRequestSchema)` to create a new message.
@@ -124,7 +132,7 @@ export declare const GetGameEngineInfoRequestSchema: GenMessage<GetGameEngineInf
 /**
  * @generated from message game_engine.GetGameEngineInfoResponse
  */
-export type GetGameEngineInfoResponse = Message<'game_engine.GetGameEngineInfoResponse'> & {
+export type GetGameEngineInfoResponse = Message<"game_engine.GetGameEngineInfoResponse"> & {
     /**
      * @generated from field: string game_code = 1;
      */
@@ -163,7 +171,7 @@ export declare const GameEngineService: GenService<{
      * @generated from rpc game_engine.GameEngineService.ProcessCommand
      */
     processCommand: {
-        methodKind: 'unary';
+        methodKind: "unary";
         input: typeof ProcessCommandRequestSchema;
         output: typeof ProcessCommandResponseSchema;
     };
@@ -171,7 +179,7 @@ export declare const GameEngineService: GenService<{
      * @generated from rpc game_engine.GameEngineService.GetGameEngineInfo
      */
     getGameEngineInfo: {
-        methodKind: 'unary';
+        methodKind: "unary";
         input: typeof GetGameEngineInfoRequestSchema;
         output: typeof GetGameEngineInfoResponseSchema;
     };

package/dist/generated/game-engine_pb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"game-engine_pb.d.ts","sourceRoot":"","sources":["../../src/generated/game-engine_pb.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"game-engine_pb.d.ts","sourceRoot":"","sources":["../../src/generated/game-engine_pb.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAGpF,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAC02D,CAAC;AAE14D;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,mCAAmC,CAAC,GAAG;IACjF;;OAEG;IACH,WAAW,CAAC,EAAE,UAAU,CAAC;IAEzB;;OAEG;IACH,YAAY,CAAC,EAAE,UAAU,CAAC;IAE1B;;OAEG;IACH,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAE5B;;OAEG;IACH,cAAc,CAAC,EAAE,UAAU,CAAC;CAC7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,2BAA2B,EAAE,UAAU,CAAC,qBAAqB,CACxC,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,+BAA+B,CAAC,GAAG;IACzE;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,UAAU,CAAC,iBAAiB,CAChC,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,8BAA8B,CAAC,GAAG;IACvE;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,UAAU,CAAC,gBAAgB,CAC9B,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC,oCAAoC,CAAC,GAAG;IACnF;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,UAAU,CAAC;IAEzB;;OAEG;IACH,YAAY,CAAC,EAAE,UAAU,CAAC;IAE1B;;OAEG;IACH,OAAO,CAAC,EAAE,UAAU,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,UAAU,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAAA;KAAE,CAAC;IAEhD;;OAEG;IACH,cAAc,CAAC,EAAE,UAAU,CAAC;CAC7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,UAAU,CAAC,sBAAsB,CAC1C,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC,sCAAsC,CAAC,GAAG,EACxF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,8BAA8B,EAAE,UAAU,CAAC,wBAAwB,CAC9C,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAC,uCAAuC,CAAC,GAAG;IACzF;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,+BAA+B,EAAE,UAAU,CAAC,yBAAyB,CAChD,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,UAAU,CAAC;IACzC;;OAEG;IACH,cAAc,EAAE;QACd,UAAU,EAAE,OAAO,CAAC;QACpB,KAAK,EAAE,OAAO,2BAA2B,CAAC;QAC1C,MAAM,EAAE,OAAO,4BAA4B,CAAC;KAC7C,CAAC;IACF;;OAEG;IACH,iBAAiB,EAAE;QACjB,UAAU,EAAE,OAAO,CAAC;QACpB,KAAK,EAAE,OAAO,8BAA8B,CAAC;QAC7C,MAAM,EAAE,OAAO,+BAA+B,CAAC;KAChD,CAAC;CACH,CACiC,CAAC"}

package/dist/generated/game-engine_pb.js

@@ -9,51 +9,37 @@ const wkt_1 = require("@bufbuild/protobuf/wkt");
 /**
  * Describes the file game-engine.proto.
  */
-exports.file_game_engine = 
-/*@__PURE__*/
-(0, codegenv2_1.fileDesc)('ChFnYW1lLWVuZ2luZS5wcm90bxILZ2FtZV9lbmdpbmUi5QEKFVByb2Nlc3NDb21tYW5kUmVxdWVzdBIyCgxwdWJsaWNfc3RhdGUYASABKAsyFy5nb29nbGUucHJvdG9idWYuU3RydWN0SACIAQESMwoNcHJpdmF0ZV9zdGF0ZRgCIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3RIAYgBARI0Cgdjb21tYW5kGAMgASgLMh4uZ2FtZV9lbmdpbmUuR2FtZUFjdGlvbkNvbW1hbmRIAogBAUIPCg1fcHVibGljX3N0YXRlQhAKDl9wcml2YXRlX3N0YXRlQgoKCF9jb21tYW5kImgKEUdhbWVBY3Rpb25Db21tYW5kEgoKAmlkGAEgASgJEgwKBHR5cGUYAiABKAkSLQoHcGF5bG9hZBgDIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3RIAIgBAUIKCghfcGF5bG9hZCJKChBSbmdPdXRjb21lUmVjb3JkEg4KBnJlc3VsdBgBIAEoARIMCgRzZWVkGAIgASgJEgsKA21pbhgDIAEoARILCgNtYXgYBCABKAEirgMKFlByb2Nlc3NDb21tYW5kUmVzcG9uc2USDwoHc3VjY2VzcxgBIAEoCBIyCgxwdWJsaWNfc3RhdGUYAiABKAsyFy5nb29nbGUucHJvdG9idWYuU3RydWN0SACIAQESMwoNcHJpdmF0ZV9zdGF0ZRgDIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3RIAYgBARItCgdvdXRjb21lGAQgASgLMhcuZ29vZ2xlLnByb3RvYnVmLlN0cnVjdEgCiAEBEhQKB21lc3NhZ2UYBSABKAlIA4gBARJICgtybmdfb3V0Y29tZRgGIAMoCzIzLmdhbWVfZW5naW5lLlByb2Nlc3NDb21tYW5kUmVzcG9uc2UuUm5nT3V0Y29tZUVudHJ5GlAKD1JuZ091dGNvbWVFbnRyeRILCgNrZXkYASABKAkSLAoFdmFsdWUYAiABKAsyHS5nYW1lX2VuZ2luZS5SbmdPdXRjb21lUmVjb3JkOgI4AUIPCg1fcHVibGljX3N0YXRlQhAKDl9wcml2YXRlX3N0YXRlQgoKCF9vdXRjb21lQgoKCF9tZXNzYWdlIhoKGEdldEdhbWVFbmdpbmVJbmZvUmVxdWVzdCKEAQoZR2V0R2FtZUVuZ2luZUluZm9SZXNwb25zZRIRCglnYW1lX2NvZGUYASABKAkSDwoHdmVyc2lvbhgCIAEoCRILCgNydHAYAyABKAESEQoJZ2FtZV90eXBlGAQgASgJEhEKCWdhbWVfbmFtZRgFIAEoCRIQCghwcm92aWRlchgGIAEoCTLSAQoRR2FtZUVuZ2luZVNlcnZpY2USWQoOUHJvY2Vzc0NvbW1hbmQSIi5nYW1lX2VuZ2luZS5Qcm9jZXNzQ29tbWFuZFJlcXVlc3QaIy5nYW1lX2VuZ2luZS5Qcm9jZXNzQ29tbWFuZFJlc3BvbnNlEmIKEUdldEdhbWVFbmdpbmVJbmZvEiUuZ2FtZV9lbmdpbmUuR2V0R2FtZUVuZ2luZUluZm9SZXF1ZXN0GiYuZ2FtZV9lbmdpbmUuR2V0R2FtZUVuZ2luZUluZm9SZXNwb25zZWIGcHJvdG8z', [wkt_1.file_google_protobuf_struct]);
+exports.file_game_engine = (0, codegenv2_1.fileDesc)("ChFnYW1lLWVuZ2luZS5wcm90bxILZ2FtZV9lbmdpbmUisAIKFVByb2Nlc3NDb21tYW5kUmVxdWVzdBIyCgxwdWJsaWNfc3RhdGUYASABKAsyFy5nb29nbGUucHJvdG9idWYuU3RydWN0SACIAQESMwoNcHJpdmF0ZV9zdGF0ZRgCIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3RIAYgBARI0Cgdjb21tYW5kGAMgASgLMh4uZ2FtZV9lbmdpbmUuR2FtZUFjdGlvbkNvbW1hbmRIAogBARI1Cg9hZGRpdGlvbmFsX2RhdGEYBCABKAsyFy5nb29nbGUucHJvdG9idWYuU3RydWN0SAOIAQFCDwoNX3B1YmxpY19zdGF0ZUIQCg5fcHJpdmF0ZV9zdGF0ZUIKCghfY29tbWFuZEISChBfYWRkaXRpb25hbF9kYXRhImgKEUdhbWVBY3Rpb25Db21tYW5kEgoKAmlkGAEgASgJEgwKBHR5cGUYAiABKAkSLQoHcGF5bG9hZBgDIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3RIAIgBAUIKCghfcGF5bG9hZCJKChBSbmdPdXRjb21lUmVjb3JkEg4KBnJlc3VsdBgBIAEoARIMCgRzZWVkGAIgASgJEgsKA21pbhgDIAEoARILCgNtYXgYBCABKAEi+QMKFlByb2Nlc3NDb21tYW5kUmVzcG9uc2USDwoHc3VjY2VzcxgBIAEoCBIyCgxwdWJsaWNfc3RhdGUYAiABKAsyFy5nb29nbGUucHJvdG9idWYuU3RydWN0SACIAQESMwoNcHJpdmF0ZV9zdGF0ZRgDIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3RIAYgBARItCgdvdXRjb21lGAQgASgLMhcuZ29vZ2xlLnByb3RvYnVmLlN0cnVjdEgCiAEBEhQKB21lc3NhZ2UYBSABKAlIA4gBARJICgtybmdfb3V0Y29tZRgGIAMoCzIzLmdhbWVfZW5naW5lLlByb2Nlc3NDb21tYW5kUmVzcG9uc2UuUm5nT3V0Y29tZUVudHJ5EjUKD2FkZGl0aW9uYWxfZGF0YRgHIAEoCzIXLmdvb2dsZS5wcm90b2J1Zi5TdHJ1Y3RIBIgBARpQCg9SbmdPdXRjb21lRW50cnkSCwoDa2V5GAEgASgJEiwKBXZhbHVlGAIgASgLMh0uZ2FtZV9lbmdpbmUuUm5nT3V0Y29tZVJlY29yZDoCOAFCDwoNX3B1YmxpY19zdGF0ZUIQCg5fcHJpdmF0ZV9zdGF0ZUIKCghfb3V0Y29tZUIKCghfbWVzc2FnZUISChBfYWRkaXRpb25hbF9kYXRhIhoKGEdldEdhbWVFbmdpbmVJbmZvUmVxdWVzdCKEAQoZR2V0R2FtZUVuZ2luZUluZm9SZXNwb25zZRIRCglnYW1lX2NvZGUYASABKAkSDwoHdmVyc2lvbhgCIAEoCRILCgNydHAYAyABKAESEQoJZ2FtZV90eXBlGAQgASgJEhEKCWdhbWVfbmFtZRgFIAEoCRIQCghwcm92aWRlchgGIAEoCTLSAQoRR2FtZUVuZ2luZVNlcnZpY2USWQoOUHJvY2Vzc0NvbW1hbmQSIi5nYW1lX2VuZ2luZS5Qcm9jZXNzQ29tbWFuZFJlcXVlc3QaIy5nYW1lX2VuZ2luZS5Qcm9jZXNzQ29tbWFuZFJlc3BvbnNlEmIKEUdldEdhbWVFbmdpbmVJbmZvEiUuZ2FtZV9lbmdpbmUuR2V0R2FtZUVuZ2luZUluZm9SZXF1ZXN0GiYuZ2FtZV9lbmdpbmUuR2V0R2FtZUVuZ2luZUluZm9SZXNwb25zZWIGcHJvdG8z", [wkt_1.file_google_protobuf_struct]);
 /**
  * Describes the message game_engine.ProcessCommandRequest.
  * Use `create(ProcessCommandRequestSchema)` to create a new message.
  */
-exports.ProcessCommandRequestSchema = 
-/*@__PURE__*/
-(0, codegenv2_1.messageDesc)(exports.file_game_engine, 0);
+exports.ProcessCommandRequestSchema = (0, codegenv2_1.messageDesc)(exports.file_game_engine, 0);
 /**
  * Describes the message game_engine.GameActionCommand.
  * Use `create(GameActionCommandSchema)` to create a new message.
  */
-exports.GameActionCommandSchema = 
-/*@__PURE__*/
-(0, codegenv2_1.messageDesc)(exports.file_game_engine, 1);
+exports.GameActionCommandSchema = (0, codegenv2_1.messageDesc)(exports.file_game_engine, 1);
 /**
  * Describes the message game_engine.RngOutcomeRecord.
  * Use `create(RngOutcomeRecordSchema)` to create a new message.
  */
-exports.RngOutcomeRecordSchema = 
-/*@__PURE__*/
-(0, codegenv2_1.messageDesc)(exports.file_game_engine, 2);
+exports.RngOutcomeRecordSchema = (0, codegenv2_1.messageDesc)(exports.file_game_engine, 2);
 /**
  * Describes the message game_engine.ProcessCommandResponse.
  * Use `create(ProcessCommandResponseSchema)` to create a new message.
  */
-exports.ProcessCommandResponseSchema = 
-/*@__PURE__*/
-(0, codegenv2_1.messageDesc)(exports.file_game_engine, 3);
+exports.ProcessCommandResponseSchema = (0, codegenv2_1.messageDesc)(exports.file_game_engine, 3);
 /**
  * Describes the message game_engine.GetGameEngineInfoRequest.
  * Use `create(GetGameEngineInfoRequestSchema)` to create a new message.
  */
-exports.GetGameEngineInfoRequestSchema = 
-/*@__PURE__*/
-(0, codegenv2_1.messageDesc)(exports.file_game_engine, 4);
+exports.GetGameEngineInfoRequestSchema = (0, codegenv2_1.messageDesc)(exports.file_game_engine, 4);
 /**
  * Describes the message game_engine.GetGameEngineInfoResponse.
  * Use `create(GetGameEngineInfoResponseSchema)` to create a new message.
  */
-exports.GetGameEngineInfoResponseSchema = 
-/*@__PURE__*/
-(0, codegenv2_1.messageDesc)(exports.file_game_engine, 5);
+exports.GetGameEngineInfoResponseSchema = (0, codegenv2_1.messageDesc)(exports.file_game_engine, 5);
 /**
  * @generated from service game_engine.GameEngineService
  */

package/dist/grpc/game-engine.grpc.in-adapter.d.ts

@@ -25,6 +25,10 @@ export declare class GameEngineGrpcInAdapter {
      * Validate a single RNG outcome record for GLI-19 compliance.
      * Throws INVALID_RNG_SEED on any invalid numeric field to prevent
      * silent data corruption in the audit trail.
+     *
+     * Note: seed field may come as string from RNG service (JSON parsing).
+     * We accept both number and numeric string for seed since it's converted
+     * to string for wire format anyway.
      */
     private validateRngRecord;
     getGameEngineInfo(_request: GetGameEngineInfoRequest): Promise<GetGameEngineInfoResponse>;

package/dist/grpc/game-engine.grpc.in-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"game-engine.grpc.in-adapter.d.ts","sourceRoot":"","sources":["../../src/grpc/game-engine.grpc.in-adapter.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EAEzB,qBAAqB,EACrB,sBAAsB,EAEvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAEL,gBAAgB,EAMjB,MAAM,UAAU,CAAC;AAGlB,qBACa,uBAAuB;IAIhC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAHnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAGb,gBAAgB,EAAE,gBAAgB;IAK/C,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAerF,OAAO,CAAC,yBAAyB;IA2BjC,OAAO,CAAC,qBAAqB;IAc7B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAmBnB,iBAAiB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC;CAYhG"}
+{"version":3,"file":"game-engine.grpc.in-adapter.d.ts","sourceRoot":"","sources":["../../src/grpc/game-engine.grpc.in-adapter.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EAEzB,qBAAqB,EACrB,sBAAsB,EAEvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAEL,gBAAgB,EAMjB,MAAM,UAAU,CAAC;AAGlB,qBACa,uBAAuB;IAIhC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAHnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAGb,gBAAgB,EAAE,gBAAgB;IAK/C,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAgBrF,OAAO,CAAC,yBAAyB;IA2BjC,OAAO,CAAC,qBAAqB;IAsB7B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB;IA+BnB,iBAAiB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC;CAYhG"}

package/dist/grpc/game-engine.grpc.in-adapter.js

@@ -31,8 +31,9 @@ let GameEngineGrpcInAdapter = GameEngineGrpcInAdapter_1 = class GameEngineGrpcIn
             const command = this.extractCommandFromRequest(request);
             const publicState = request.publicState ?? {};
             const privateState = request.privateState ?? {};
+            const additionalData = request.additionalData;
             const result = await this.gameEngineInPort.processCommand(publicState, privateState, command);
-            return this.createSuccessResponse(result);
+            return this.createSuccessResponse(result, additionalData);
         }
         catch (error) {
             this.logger.error('Error in processCommand', error);
@@ -52,8 +53,10 @@ let GameEngineGrpcInAdapter = GameEngineGrpcInAdapter_1 = class GameEngineGrpcIn
         }
         return { id, type, payload };
     }
-    createSuccessResponse(result) {
+    createSuccessResponse(result, requestAdditionalData) {
         const rngOutcome = this.convertRngOutcome(result.rngOutcome);
+        // additionalData passthrough: game engine result takes precedence, falls back to request
+        const additionalData = result.additionalData ?? requestAdditionalData;
         return (0, protobuf_1.create)(game_engine_pb_1.ProcessCommandResponseSchema, {
             success: result.success ?? true,
             // Cast at gRPC boundary: game engine state objects are serialized as protobuf Struct
@@ -62,6 +65,7 @@ let GameEngineGrpcInAdapter = GameEngineGrpcInAdapter_1 = class GameEngineGrpcIn
             outcome: result.outcome,
             message: result.message,
             rngOutcome: rngOutcome,
+            additionalData: additionalData,
         });
     }
     /**
@@ -108,15 +112,26 @@ let GameEngineGrpcInAdapter = GameEngineGrpcInAdapter_1 = class GameEngineGrpcIn
      * Validate a single RNG outcome record for GLI-19 compliance.
      * Throws INVALID_RNG_SEED on any invalid numeric field to prevent
      * silent data corruption in the audit trail.
+     *
+     * Note: seed field may come as string from RNG service (JSON parsing).
+     * We accept both number and numeric string for seed since it's converted
+     * to string for wire format anyway.
      */
     validateRngRecord(key, record) {
-        const fields = ['result', 'seed', 'min', 'max'];
-        for (const field of fields) {
+        // Validate result, min, max as strict numbers
+        const strictFields = ['result', 'min', 'max'];
+        for (const field of strictFields) {
             const val = record[field];
             if (typeof val !== 'number' || !isFinite(val)) {
                 throw new domain_exception_1.DomainException(internal_error_code_1.InternalErrorCode.INVALID_RNG_SEED, `Invalid RNG ${field} for action '${key}': expected finite number, got ${String(val)}`);
             }
         }
+        // Validate seed - allow string or number (RNG service may return string)
+        const seed = record.seed;
+        const seedNum = typeof seed === 'string' ? Number(seed) : seed;
+        if (typeof seedNum !== 'number' || !isFinite(seedNum)) {
+            throw new domain_exception_1.DomainException(internal_error_code_1.InternalErrorCode.INVALID_RNG_SEED, `Invalid RNG seed for action '${key}': expected finite number, got ${String(seed)}`);
+        }
         if (record.min > record.max) {
             throw new domain_exception_1.DomainException(internal_error_code_1.InternalErrorCode.INVALID_RNG_SEED, `Invalid RNG range for action '${key}': min (${record.min}) > max (${record.max})`);
         }

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export * from './health';
 export * from './registration';
 export * from './grpc';
 export { createGameEngineApp, GameEngineAppOptions } from './bootstrap';
+export * from './debug';
 export { GameEngineService, ProcessCommandRequest, ProcessCommandRequestSchema, ProcessCommandResponse, ProcessCommandResponseSchema, GetGameEngineInfoRequest, GetGameEngineInfoRequestSchema, GetGameEngineInfoResponse, GetGameEngineInfoResponseSchema, } from './generated/game-engine_pb';
 export { GameEngineRegistryService, RegisterGameEngineRequest, RegisterGameEngineRequestSchema, RegisterGameEngineResponse, RegisterGameEngineResponseSchema, } from './generated/game-engine-registry_pb';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAGjB,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,gBAAgB,CAAC;AAG/B,cAAc,QAAQ,CAAC;AAGvB,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,2BAA2B,EAC3B,sBAAsB,EACtB,4BAA4B,EAC5B,wBAAwB,EACxB,8BAA8B,EAC9B,yBAAyB,EACzB,+BAA+B,GAChC,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,+BAA+B,EAC/B,0BAA0B,EAC1B,gCAAgC,GACjC,MAAM,qCAAqC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAGjB,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,gBAAgB,CAAC;AAG/B,cAAc,QAAQ,CAAC;AAGvB,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGxE,cAAc,SAAS,CAAC;AAGxB,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,2BAA2B,EAC3B,sBAAsB,EACtB,4BAA4B,EAC5B,wBAAwB,EACxB,8BAA8B,EAC9B,yBAAyB,EACzB,+BAA+B,GAChC,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,+BAA+B,EAC/B,0BAA0B,EAC1B,gCAAgC,GACjC,MAAM,qCAAqC,CAAC"}

package/dist/index.js

@@ -30,6 +30,8 @@ __exportStar(require("./grpc"), exports);
 // Bootstrap
 var bootstrap_1 = require("./bootstrap");
 Object.defineProperty(exports, "createGameEngineApp", { enumerable: true, get: function () { return bootstrap_1.createGameEngineApp; } });
+// Debug command infrastructure
+__exportStar(require("./debug"), exports);
 // Generated proto types (re-exported for convenience)
 var game_engine_pb_1 = require("./generated/game-engine_pb");
 Object.defineProperty(exports, "GameEngineService", { enumerable: true, get: function () { return game_engine_pb_1.GameEngineService; } });

package/dist/types.d.ts

@@ -35,6 +35,7 @@ export interface CommandProcessingResult<TPublicState = unknown, TPrivateState =
     outcome?: TOutcome;
     message?: string;
     rngOutcome?: RngOutcome;
+    additionalData?: unknown;
 }
 export interface GameActionCommand<TPayload = unknown> {
     id: string;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,WAAW,eAAwB,CAAC;AAEjD,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;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAAA;CAAE,CAAC;AAElE,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,CAAC,YAAY,GAAG,OAAO,EAAE,aAAa,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO;IAC7F,cAAc,CACZ,WAAW,EAAE,YAAY,GAAG,IAAI,EAChC,YAAY,EAAE,aAAa,GAAG,IAAI,EAClC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,uBAAuB,CAAC,YAAY,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE3E,iBAAiB,IAAI,cAAc,CAAC;CACrC;AAED,eAAO,MAAM,mBAAmB,eAAgC,CAAC;AAEjE,MAAM,WAAW,gBAAgB;IAC/B,cAAc,CACZ,WAAW,EAAE,OAAO,EACpB,YAAY,EAAE,OAAO,EACrB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACpC,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;CAC9C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,WAAW,eAAwB,CAAC;AAEjD,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;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAAA;CAAE,CAAC;AAElE,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;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;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,CAAC,YAAY,GAAG,OAAO,EAAE,aAAa,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO;IAC7F,cAAc,CACZ,WAAW,EAAE,YAAY,GAAG,IAAI,EAChC,YAAY,EAAE,aAAa,GAAG,IAAI,EAClC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,uBAAuB,CAAC,YAAY,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE3E,iBAAiB,IAAI,cAAc,CAAC;CACrC;AAED,eAAO,MAAM,mBAAmB,eAAgC,CAAC;AAEjE,MAAM,WAAW,gBAAgB;IAC/B,cAAc,CACZ,WAAW,EAAE,OAAO,EACpB,YAAY,EAAE,OAAO,EACrB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACpC,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;CAC9C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omnitronix/game-engine-sdk",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "description": "Shared NestJS infrastructure SDK for Omnitronix game engine services",
   "main": "dist/index.js",
   "module": "dist/esm/index.js",
@@ -65,6 +65,16 @@
         "types": "./dist/bootstrap/index.d.ts",
         "default": "./dist/bootstrap/index.js"
       }
+    },
+    "./debug": {
+      "import": {
+        "types": "./dist/debug/index.d.ts",
+        "default": "./dist/esm/debug/index.js"
+      },
+      "require": {
+        "types": "./dist/debug/index.d.ts",
+        "default": "./dist/debug/index.js"
+      }
     }
   },
   "scripts": {
@@ -143,7 +153,7 @@
     "@nestjs/platform-express": "^11.0.0",
     "@nestjs/swagger": "^11.0.6",
     "@nestjs/testing": "^11.0.9",
-    "@omnitronix/game-engine-contract": "^1.0.0",
+    "@omnitronix/game-engine-contract": "^1.2.0",
     "@types/express": "^5.0.0",
     "@types/jest": "^29.5.14",
     "@types/node": "^20.17.10",