@rb-games/core 0.1.0

package/dist/plugins/scene/ScenePlugin.d.ts

@@ -0,0 +1,162 @@
+import { PixiEngine } from '../../engine/PixiEngine';
+import type { ScenePluginConfig } from './ScenePlugin.types';
+import type { EnginePlugin } from '../Plugin.types';
+import { Scene } from './Scene';
+/**
+ * Scene management plugin for PixiJS games.
+ *
+ * ScenePlugin provides a structured way to manage different game screens
+ * (menus, gameplay, loading screens, etc.) with smooth transitions and
+ * lifecycle management.
+ *
+ * ## Features
+ *
+ * - **Scene Registration**: Register multiple scenes
+ * - **Smooth Transitions**: Async scene switching with animations
+ * - **Lifecycle Management**: Automatic enter/exit/update calls
+ * - **Transition Safety**: Prevents overlapping transitions
+ * - **Default Scene**: Auto-load initial scene
+ * - **Custom Root**: Use custom container for scenes
+ *
+ * ## Usage Pattern
+ *
+ * 1. Create scenes extending Scene base class
+ * 2. Register scenes with ScenePlugin
+ * 3. Switch between scenes using switchScene()
+ * 4. Plugin handles lifecycle automatically
+ *
+ * ## Scene Lifecycle
+ *
+ * When switching from SceneA to SceneB:
+ * 1. SceneA.onExit() - Exit animation
+ * 2. SceneA.cleanup() - Resource cleanup
+ * 3. SceneA removed from stage
+ * 4. SceneB added to stage
+ * 5. SceneB.onInitialize() - First time only
+ * 6. SceneB.onEnter() - Entry animation
+ * 7. SceneB.update() - Called every frame
+ *
+ * @example
+ * ```typescript
+ * // Create scenes
+ * const mainMenu = new MainMenuScene();
+ * const gameplay = new GameplayScene();
+ *
+ * // Create and configure plugin
+ * const scenePlugin = new ScenePlugin({
+ *   defaultScene: 'MainMenu'
+ * });
+ *
+ * // Register scenes
+ * scenePlugin.registerScene('MainMenu', mainMenu);
+ * scenePlugin.registerScene('Gameplay', gameplay);
+ *
+ * // Register plugin
+ * engine.registerPlugin(scenePlugin);
+ * await engine.initialize();
+ *
+ * // Switch scenes
+ * await scenePlugin.switchScene('Gameplay');
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Scene with transitions
+ * class MenuScene extends Scene {
+ *   protected async onEnter(): Promise<void> {
+ *     this.alpha = 0;
+ *     await gsap.to(this, { alpha: 1, duration: 0.5 });
+ *   }
+ *
+ *   protected async onExit(): Promise<void> {
+ *     await gsap.to(this, { alpha: 0, duration: 0.3 });
+ *   }
+ * }
+ * ```
+ *
+ * @category Plugins
+ * @public
+ */
+export declare class ScenePlugin implements EnginePlugin {
+    name: string;
+    priority: number;
+    dependencies: string[];
+    private engine;
+    private currentScene;
+    private scenes;
+    private isTransitioning;
+    private config;
+    private root;
+    constructor(config?: ScenePluginConfig);
+    /**
+     * Initialize the scene plugin
+     */
+    initialize(engine: PixiEngine): Promise<void>;
+    /**
+     * Called when plugin is ready and can safely use other plugins
+     */
+    onReady(engine: PixiEngine): Promise<void>;
+    /**
+     * Registers a scene with the plugin.
+     *
+     * Scenes must be registered before they can be switched to.
+     * If the engine is already initialized, the scene will receive
+     * the engine reference immediately.
+     *
+     * @param name - Unique name for the scene
+     * @param scene - Scene instance to register
+     *
+     * @example
+     * ```typescript
+     * const mainMenu = new MainMenuScene();
+     * scenePlugin.registerScene('MainMenu', mainMenu);
+     * ```
+     */
+    registerScene(name: string, scene: Scene): void;
+    /**
+     * Switches to a different scene.
+     *
+     * Handles the complete transition:
+     * - Exits current scene (with animation)
+     * - Removes current scene from stage
+     * - Adds new scene to stage
+     * - Enters new scene (with animation)
+     *
+     * Prevents overlapping transitions.
+     *
+     * @param name - Name of the scene to switch to
+     * @param params - Optional parameters to pass to the scene's onEnter() method
+     * @throws Error if scene is not registered
+     *
+     * @example
+     * ```typescript
+     * await scenePlugin.switchScene('Gameplay');
+     * // With parameters
+     * await scenePlugin.switchScene('Gameplay', { level: 5, mode: 'bonus' });
+     * ```
+     */
+    switchScene(name: string, params?: unknown): Promise<void>;
+    /**
+     * Gets the currently active scene.
+     *
+     * @returns Current scene instance or null if no scene is active
+     *
+     * @example
+     * ```typescript
+     * const current = scenePlugin.getCurrentScene();
+     * if (current?.sceneName === 'Gameplay') {
+     *   // Do something
+     * }
+     * ```
+     */
+    getCurrentScene(): Scene | null;
+    /**
+     * Updates the current scene
+     * @param deltaTime The time elapsed since the last update
+     */
+    onUpdate(deltaTime: number): boolean;
+    [key: symbol]: any;
+    cleanup(): void;
+}
+export type { ScenePluginConfig } from './ScenePlugin.types';
+//# sourceMappingURL=ScenePlugin.d.ts.map

package/dist/plugins/scene/ScenePlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScenePlugin.d.ts","sourceRoot":"","sources":["../../../plugins/scene/ScenePlugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AACH,qBAAa,WAAY,YAAW,YAAY;IACvC,IAAI,EAAE,MAAM,CAAiB;IAC7B,QAAQ,EAAE,MAAM,CAAM;IACtB,YAAY,EAAE,MAAM,EAAE,CAAM;IAEnC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,IAAI,CAA0B;gBAE1B,MAAM,GAAE,iBAAsB;IA4B1C;;OAEG;IACU,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB1D;;OAEG;IACU,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvD;;;;;;;;;;;;;;;OAeG;IACI,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAmBtD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACU,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAkDvE;;;;;;;;;;;;OAYG;IACI,eAAe,IAAI,KAAK,GAAG,IAAI;IAItC;;;OAGG;IACI,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAoB3C,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IAEZ,OAAO,IAAI,IAAI;CAYvB;AAGD,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/plugins/scene/ScenePlugin.types.d.ts

@@ -0,0 +1,35 @@
+import { PluginConfig } from '../Plugin.types';
+/**
+ * Configuration for ScenePlugin.
+ *
+ * Controls scene management behavior including the root container
+ * and default initial scene.
+ *
+ * @example
+ * ```typescript
+ * const config: ScenePluginConfig = {
+ *   root: customContainer,
+ *   defaultScene: 'MainMenu',
+ *   debug: true
+ * };
+ * ```
+ *
+ * @public
+ */
+export interface ScenePluginConfig extends PluginConfig {
+    /**
+     * Root container where scenes will be added.
+     *
+     * If not specified, uses engine.pixiApp.stage as the root.
+     * Useful for adding scenes to a specific container layer.
+     */
+    root?: import('pixi.js').Container;
+    /**
+     * Default initial scene name.
+     *
+     * If specified, automatically switches to this scene when the plugin is ready.
+     * The scene must be registered before initialization.
+     */
+    defaultScene?: string;
+}
+//# sourceMappingURL=ScenePlugin.types.d.ts.map

package/dist/plugins/scene/ScenePlugin.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScenePlugin.types.d.ts","sourceRoot":"","sources":["../../../plugins/scene/ScenePlugin.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,SAAS,EAAE,SAAS,CAAC;IAEnC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/plugins/scene/index.d.ts

@@ -0,0 +1,4 @@
+export * from './ScenePlugin';
+export type { ScenePluginConfig } from './ScenePlugin.types';
+export * from './Scene';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/scene/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../plugins/scene/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,cAAc,SAAS,CAAC"}

package/dist/plugins/sentry/SentryPlugin.d.ts

@@ -0,0 +1,66 @@
+import { PixiEngine } from '../../engine';
+import type { EnginePlugin } from '../Plugin.types';
+import * as Sentry from '@sentry/browser';
+import { SentryPluginConfig } from './SentryPlugin.types';
+/**
+ * Error tracking and monitoring plugin using Sentry.
+ *
+ * @category Plugins
+ * @public
+ */
+export declare class SentryPlugin implements EnginePlugin {
+    name: string;
+    priority: number;
+    /**
+     * No dependencies - this should be the first plugin to initialize
+     */
+    dependencies: string[];
+    private _engine;
+    private config;
+    private isInitialized;
+    constructor(config: SentryPluginConfig);
+    /**
+     * Initialize Sentry plugin
+     * @param engine PixiEngine instance
+     */
+    initialize(engine: PixiEngine): void;
+    /**
+     * Plugin is ready immediately after initialization
+     */
+    onReady(engine: PixiEngine): void;
+    /**
+     * Check if plugin is ready for use
+     */
+    isReady(): boolean;
+    /**
+     * Report an error to Sentry
+     * @param error Error to report
+     * @param extra Additional context
+     */
+    captureError(error: Error, extra?: Record<string, any>): void;
+    /**
+     * Report a message to Sentry
+     * @param message Message to report
+     * @param level Message level
+     * @param extra Additional context
+     */
+    captureMessage(message: string, level?: Sentry.SeverityLevel, extra?: Record<string, any>): void;
+    /**
+     * Add breadcrumb to Sentry
+     * @param message Breadcrumb message
+     * @param category Category
+     * @param level Level
+     */
+    addBreadcrumb(message: string, category?: string, level?: Sentry.SeverityLevel): void;
+    /**
+     * Plugin update process
+     */
+    onUpdate(_deltaTime: number): boolean;
+    /**
+     * Cleanup the plugin
+     */
+    cleanup(): void;
+    [key: symbol]: any;
+}
+export type { SentryPluginConfig } from './SentryPlugin.types';
+//# sourceMappingURL=SentryPlugin.d.ts.map

package/dist/plugins/sentry/SentryPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SentryPlugin.d.ts","sourceRoot":"","sources":["../../../plugins/sentry/SentryPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D;;;;;GAKG;AACH,qBAAa,YAAa,YAAW,YAAY;IACxC,IAAI,EAAE,MAAM,CAAkB;IAC9B,QAAQ,EAAE,MAAM,CAAM;IAE7B;;OAEG;IACI,YAAY,EAAE,MAAM,EAAE,CAAM;IAEnC,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,aAAa,CAAS;gBAElB,MAAM,EAAE,kBAAkB;IAsBtC;;;OAGG;IACI,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IA0C3C;;OAEG;IACI,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAwBxC;;OAEG;IACI,OAAO,IAAI,OAAO;IAIzB;;;;OAIG;IACI,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAcpE;;;;;OAKG;IACI,cAAc,CACnB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,MAAM,CAAC,aAAsB,EACpC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B,IAAI;IAcP;;;;;OAKG;IACI,aAAa,CAClB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAiB,EAC3B,KAAK,GAAE,MAAM,CAAC,aAAsB,GACnC,IAAI;IAaP;;OAEG;IAEI,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAK5C;;OAEG;IACI,OAAO,IAAI,IAAI;IAOtB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAGD,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/plugins/sentry/SentryPlugin.types.d.ts

@@ -0,0 +1,8 @@
+import { PluginConfig } from "../Plugin.types";
+/**
+ * Specific configuration for SentryPlugin
+ */
+export interface SentryPluginConfig extends PluginConfig {
+    dsn: string;
+}
+//# sourceMappingURL=SentryPlugin.types.d.ts.map

package/dist/plugins/sentry/SentryPlugin.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SentryPlugin.types.d.ts","sourceRoot":"","sources":["../../../plugins/sentry/SentryPlugin.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAI/C;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACpD,GAAG,EAAE,MAAM,CAAC;CACf"}

package/dist/plugins/sentry/index.d.ts

@@ -0,0 +1,3 @@
+export * from './SentryPlugin';
+export type { SentryPluginConfig } from './SentryPlugin.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/sentry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../plugins/sentry/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/plugins/service/ServiceAdapter.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Abstract service adapter for backend API communication
+ * @module ServicePlugin
+ */
+import { EventEmitter } from 'pixi.js';
+import type { SessionResponse, GameplayRequest, GameplayResponse, HistoryEntry, HistoryResponse, PlatformResponse, ServiceActions } from './types';
+/**
+ * Abstract base class for service adapters
+ *
+ * Service adapters handle the low-level communication with the backend API.
+ * Different adapters can be implemented for different environments
+ * (RGSAdapter for production, OfflineAdapter for development).
+ *
+ * @example
+ * ```typescript
+ * class CustomAdapter extends ServiceAdapter {
+ *   async getSession(): Promise<SessionResponse> {
+ *     // Fetch session and game config
+ *   }
+ *
+ *   async spin(request: GameplayRequest): Promise<GameplayResponse> {
+ *     // Execute spin action
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class ServiceAdapter extends EventEmitter {
+    /**
+     * Session ID for the current game session
+     */
+    abstract get sessionId(): string;
+    /**
+     * Get session info and game configuration
+     * GET /session
+     *
+     * @returns Promise resolving to session response with gameConfig
+     */
+    abstract getSession(): Promise<SessionResponse>;
+    /**
+     * Execute a gameplay action (spin)
+     * POST /gameplay
+     *
+     * @param request - Gameplay request with action and optional clientSeed
+     * @returns Promise resolving to gameplay response
+     */
+    abstract spin(request: GameplayRequest): Promise<GameplayResponse>;
+    /**
+     * Get game history
+     * GET /session/{sessionId}/history
+     *
+     * @param limit - Maximum number of entries to return
+     * @param pointer - Pagination pointer for next page
+     * @returns Promise resolving to history response
+     */
+    abstract getHistory(limit?: number, pointer?: number): Promise<HistoryResponse>;
+    /**
+     * Get a single round summary by round ID
+     * GET /session/{sessionId}/round/{roundId}
+     *
+     * @param roundId - Round identifier
+     * @returns Promise resolving to history entry (single or range)
+     */
+    abstract getRound(roundId: string): Promise<HistoryEntry>;
+    /**
+     * Get player balance
+     * GET /session/{sessionId}/balance
+     *
+     * @returns Promise resolving to platform response with balance
+     */
+    abstract getBalance(): Promise<PlatformResponse>;
+    /**
+     * Replay a completed spin by nonce
+     * GET /session/{sessionId}/replay/{nonce}
+     *
+     * @param nonce - The nonce of the spin to replay
+     * @returns Promise resolving to gameplay response
+     */
+    abstract replay(nonce: number): Promise<GameplayResponse>;
+    /**
+     * Emit a service action event
+     *
+     * @param action - Service action type
+     * @param data - Event data
+     * @protected
+     */
+    protected emitAction(action: ServiceActions, data: unknown): void;
+}
+//# sourceMappingURL=ServiceAdapter.d.ts.map

package/dist/plugins/service/ServiceAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceAdapter.d.ts","sourceRoot":"","sources":["../../../plugins/service/ServiceAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,cAAc,EACf,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,8BAAsB,cAAe,SAAQ,YAAY;IACvD;;OAEG;IACH,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC;IAEjC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC;IAE/C;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAElE;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAE/E;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAEzD;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAEhD;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAEzD;;;;;;OAMG;IACH,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;CAGlE"}

package/dist/plugins/service/ServiceEventHelper.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Service Event Helper Utility
+ * @deprecated This file uses old event-based types. Use new API types instead.
+ * @module ServicePlugin/Helpers
+ */
+//# sourceMappingURL=ServiceEventHelper.d.ts.map

package/dist/plugins/service/ServiceEventHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceEventHelper.d.ts","sourceRoot":"","sources":["../../../plugins/service/ServiceEventHelper.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/plugins/service/ServicePlugin.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Service plugin for backend API communication
+ * @module ServicePlugin
+ */
+import { EventEmitter } from 'pixi.js';
+import type { PixiEngine } from '../../engine/PixiEngine';
+import type { EnginePlugin } from '../Plugin.types';
+import type { ServicePluginConfig } from './ServicePlugin.types';
+import type { ServiceAdapter } from './ServiceAdapter';
+import { type SessionResponse, type GameplayResponse, type HistoryEntry, type HistoryResponse, type PlatformResponse, type GameConfig } from './types';
+/**
+ * Service plugin for managing backend API communication
+ *
+ * This plugin provides a unified interface for all game-server communication including:
+ * - Session management and game configuration
+ * - Spin requests
+ * - Game history
+ *
+ * The plugin uses an adapter pattern to support different environments
+ * (RGSAdapter for production, OfflineAdapter for development).
+ *
+ * @example
+ * ```typescript
+ * // Create adapter
+ * const adapter = new RGSAdapter({
+ *   baseUrl: 'http://localhost:3000',
+ *   sessionId: 'test-session-123',
+ * });
+ *
+ * // Create plugin
+ * const servicePlugin = new ServicePlugin({
+ *   adapter,
+ *   debug: true,
+ * });
+ *
+ * // Register with engine
+ * engine.registerPlugin(servicePlugin);
+ * await engine.initialize();
+ *
+ * // Use in GameLogic
+ * const servicePlugin = engine.getPluginThrow<ServicePlugin>('servicePlugin');
+ * const session = await servicePlugin.getSession();
+ * const response = await servicePlugin.spin(2000);
+ * ```
+ */
+export declare class ServicePlugin extends EventEmitter implements EnginePlugin {
+    name: string;
+    priority: number;
+    dependencies: string[];
+    [key: symbol]: unknown;
+    private engine;
+    private adapter;
+    private config;
+    /** Cached session response */
+    private _session;
+    /** Cached game config */
+    private _gameConfig;
+    constructor(config: ServicePluginConfig);
+    /**
+     * Initialize the plugin
+     */
+    initialize(engine: PixiEngine): Promise<void>;
+    /**
+     * Called when plugin is ready
+     */
+    onReady(_engine: PixiEngine): Promise<void>;
+    /**
+     * Cleanup plugin resources
+     */
+    cleanup(): void;
+    /**
+     * Handle adapter events
+     */
+    private onAdapterEvent;
+    /**
+     * Get session info and game configuration
+     * Fetches from backend and caches the result
+     *
+     * @returns Promise resolving to session response with gameConfig
+     */
+    getSession(): Promise<SessionResponse>;
+    /**
+     * Execute a spin action
+     *
+     * @param totalBet - Total bet amount
+     * @param clientSeed - Optional client seed for provably fair
+     * @returns Promise resolving to gameplay response
+     */
+    spin(action: string, totalBet: number, clientSeed?: string): Promise<GameplayResponse>;
+    /**
+     * Get game history
+     *
+     * @param limit - Maximum number of entries to return
+     * @param pointer - Pagination pointer for next page
+     * @returns Promise resolving to history response
+     */
+    getHistory(limit?: number, pointer?: number): Promise<HistoryResponse>;
+    /**
+     * Get a single round summary by round ID
+     *
+     * @param roundId - Round identifier
+     * @returns Promise resolving to history entry (single or range)
+     */
+    getRound(roundId: string): Promise<HistoryEntry>;
+    /**
+     * Get player balance
+     *
+     * @returns Promise resolving to platform response with balance
+     */
+    getBalance(): Promise<PlatformResponse>;
+    /**
+     * Replay a completed spin by nonce
+     *
+     * @param nonce - The nonce of the spin to replay
+     * @returns Promise resolving to gameplay response
+     */
+    replay(nonce: number): Promise<GameplayResponse>;
+    /**
+     * Get session ID from adapter
+     */
+    get sessionId(): string;
+    /**
+     * Get cached session response
+     */
+    get session(): SessionResponse | null;
+    /**
+     * Get cached game config
+     */
+    get gameConfig(): GameConfig | null;
+    /**
+     * Get the adapter instance
+     */
+    get serviceAdapter(): ServiceAdapter;
+}
+//# sourceMappingURL=ServicePlugin.d.ts.map

package/dist/plugins/service/ServicePlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServicePlugin.d.ts","sourceRoot":"","sources":["../../../plugins/service/ServicePlugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EAErB,KAAK,UAAU,EAChB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,aAAc,SAAQ,YAAa,YAAW,YAAY;IAC9D,IAAI,SAAmB;IACvB,QAAQ,SAAM;IACd,YAAY,WAAsB;IAGzC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAEvB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,MAAM,CAAsB;IAEpC,8BAA8B;IAC9B,OAAO,CAAC,QAAQ,CAAgC;IAEhD,yBAAyB;IACzB,OAAO,CAAC,WAAW,CAA2B;gBAElC,MAAM,EAAE,mBAAmB;IAyBvC;;OAEG;IACU,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1D;;OAEG;IACU,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD;;OAEG;IACI,OAAO,IAAI,IAAI;IAStB;;OAEG;IACH,OAAO,CAAC,cAAc;IAgBtB;;;;;OAKG;IACU,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC;IAmBnD;;;;;;OAMG;IACU,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAanG;;;;;;OAMG;IACU,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAcnF;;;;;OAKG;IACU,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAa7D;;;;OAIG;IACU,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAcpD;;;;;OAKG;IACU,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkB7D;;OAEG;IACH,IAAW,SAAS,IAAI,MAAM,CAE7B;IAED;;OAEG;IACH,IAAW,OAAO,IAAI,eAAe,GAAG,IAAI,CAE3C;IAED;;OAEG;IACH,IAAW,UAAU,IAAI,UAAU,GAAG,IAAI,CAEzC;IAED;;OAEG;IACH,IAAW,cAAc,IAAI,cAAc,CAE1C;CACF"}

package/dist/plugins/service/ServicePlugin.types.d.ts

@@ -0,0 +1,14 @@
+/**
+ * ServicePlugin configuration and types
+ * @module ServicePlugin
+ */
+import type { PluginConfig } from '../Plugin.types';
+import type { ServiceAdapter } from './ServiceAdapter';
+/**
+ * ServicePlugin configuration
+ */
+export interface ServicePluginConfig extends PluginConfig {
+    /** Service adapter instance */
+    adapter: ServiceAdapter;
+}
+//# sourceMappingURL=ServicePlugin.types.d.ts.map

package/dist/plugins/service/ServicePlugin.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServicePlugin.types.d.ts","sourceRoot":"","sources":["../../../plugins/service/ServicePlugin.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,+BAA+B;IAC/B,OAAO,EAAE,cAAc,CAAC;CACzB"}

package/dist/plugins/service/adapters/DevAuthAdapter.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Development adapter that creates session via POST /session
+ * Use this in development to auto-create sessions
+ * @module ServicePlugin/Adapters
+ */
+import { RGSAdapter, type RGSAdapterConfig } from './RGSAdapter';
+import type { SessionResponse } from '../types';
+/**
+ * Development adapter configuration
+ */
+export interface DevAdapterConfig extends Omit<RGSAdapterConfig, 'sessionId'> {
+    /** Operator ID (UUID) */
+    operatorId?: string;
+    /** Player ID */
+    playerId?: string;
+    /** Game ID (UUID) */
+    gameId?: string;
+    /** Currency code */
+    currency?: string;
+    /** Optional public IP override (also overridable via ?clientIP= or ?ip=) */
+    ip?: string;
+}
+/**
+ * Development adapter that auto-creates sessions
+ *
+ * This adapter calls POST /session to create a new session,
+ * then uses the returned sessionId for subsequent requests.
+ *
+ * @example
+ * ```typescript
+ * const adapter = new DevAdapter({
+ *   baseUrl: 'http://localhost:3000',
+ *   debug: true,
+ * });
+ *
+ * // Creates session and returns session info
+ * const session = await adapter.getSession();
+ * console.log('Session ID:', adapter.sessionId);
+ * ```
+ */
+export declare class DevAdapter extends RGSAdapter {
+    private createSessionData;
+    private configIp?;
+    private queryParams;
+    private _sessionCreated;
+    constructor(config: DevAdapterConfig);
+    /**
+     * Get session - creates session if not exists, then fetches session info
+     */
+    getSession(): Promise<SessionResponse>;
+    /**
+     * Create a new session via POST /session
+     */
+    private createSession;
+}
+//# sourceMappingURL=DevAuthAdapter.d.ts.map

package/dist/plugins/service/adapters/DevAuthAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevAuthAdapter.d.ts","sourceRoot":"","sources":["../../../../plugins/service/adapters/DevAuthAdapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAehD;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAC;IAC3E,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,UAAW,SAAQ,UAAU;IACxC,OAAO,CAAC,iBAAiB,CAAmC;IAC5D,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,eAAe,CAAS;gBAEpB,MAAM,EAAE,gBAAgB;IA2BpC;;OAEG;IACmB,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC;IAU5D;;OAEG;YACW,aAAa;CAkE5B"}