nostr-arena 0.1.1

package/dist/react/useArena.d.ts

@@ -0,0 +1,74 @@
+/**
+ * nostr-battle-room - React Hook
+ * React bindings for Arena
+ */
+import type { ArenaConfig, ArenaCallbacks, RoomState, OpponentBase } from '../types';
+/**
+ * Opponent state with game state
+ */
+export interface OpponentState<TGameState> extends OpponentBase {
+    gameState: TGameState | null;
+}
+/**
+ * Return type for useArena hook
+ */
+export interface UseArenaReturn<TGameState> {
+    roomState: RoomState;
+    opponent: OpponentState<TGameState> | null;
+    isConnected: boolean;
+    publicKey: string;
+    createRoom: (baseUrl?: string) => Promise<string>;
+    joinRoom: (roomId: string) => Promise<void>;
+    leaveRoom: () => void;
+    reconnect: () => Promise<boolean>;
+    sendState: (state: TGameState) => void;
+    sendGameOver: (reason: string, finalScore?: number) => void;
+    requestRematch: () => void;
+    acceptRematch: () => void;
+}
+/**
+ * React hook for managing a battle room
+ *
+ * @example
+ * ```tsx
+ * interface MyGameState {
+ *   score: number;
+ *   position: { x: number; y: number };
+ * }
+ *
+ * function GameComponent() {
+ *   const {
+ *     roomState,
+ *     opponent,
+ *     createRoom,
+ *     joinRoom,
+ *     sendState,
+ *   } = useArena<MyGameState>({
+ *     gameId: 'my-game',
+ *     onOpponentState: (state) => {
+ *       console.log('Opponent moved:', state.position);
+ *     },
+ *   });
+ *
+ *   // Create a room
+ *   const handleCreate = async () => {
+ *     const url = await createRoom();
+ *     console.log('Share this URL:', url);
+ *   };
+ *
+ *   // Send game state
+ *   const handleMove = (x: number, y: number) => {
+ *     sendState({ score: 100, position: { x, y } });
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <p>Status: {roomState.status}</p>
+ *       {opponent && <p>Opponent score: {opponent.gameState?.score}</p>}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useArena<TGameState = Record<string, unknown>>(config: ArenaConfig, callbacks?: ArenaCallbacks<TGameState>): UseArenaReturn<TGameState>;
+//# sourceMappingURL=useArena.d.ts.map

package/dist/react/useArena.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useArena.d.ts","sourceRoot":"","sources":["../../src/react/useArena.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGrF;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,UAAU,CAAE,SAAQ,YAAY;IAC7D,SAAS,EAAE,UAAU,GAAG,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,UAAU;IAExC,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IAC3C,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAGlB,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAGlC,SAAS,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACvC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,QAAQ,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3D,MAAM,EAAE,WAAW,EACnB,SAAS,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,GACrC,cAAc,CAAC,UAAU,CAAC,CAuM5B"}

package/dist/react/useArena.js

@@ -0,0 +1,224 @@
+/**
+ * nostr-battle-room - React Hook
+ * React bindings for Arena
+ */
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { Arena } from '../core/Arena';
+import { INITIAL_ROOM_STATE } from '../types';
+/**
+ * React hook for managing a battle room
+ *
+ * @example
+ * ```tsx
+ * interface MyGameState {
+ *   score: number;
+ *   position: { x: number; y: number };
+ * }
+ *
+ * function GameComponent() {
+ *   const {
+ *     roomState,
+ *     opponent,
+ *     createRoom,
+ *     joinRoom,
+ *     sendState,
+ *   } = useArena<MyGameState>({
+ *     gameId: 'my-game',
+ *     onOpponentState: (state) => {
+ *       console.log('Opponent moved:', state.position);
+ *     },
+ *   });
+ *
+ *   // Create a room
+ *   const handleCreate = async () => {
+ *     const url = await createRoom();
+ *     console.log('Share this URL:', url);
+ *   };
+ *
+ *   // Send game state
+ *   const handleMove = (x: number, y: number) => {
+ *     sendState({ score: 100, position: { x, y } });
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <p>Status: {roomState.status}</p>
+ *       {opponent && <p>Opponent score: {opponent.gameState?.score}</p>}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useArena(config, callbacks) {
+    const [roomState, setRoomState] = useState(INITIAL_ROOM_STATE);
+    const [opponent, setOpponent] = useState(null);
+    const [isConnected, setIsConnected] = useState(false);
+    const roomRef = useRef(null);
+    const callbacksRef = useRef(callbacks);
+    // Keep callbacks ref updated
+    useEffect(() => {
+        callbacksRef.current = callbacks;
+    }, [callbacks]);
+    // Initialize Arena
+    useEffect(() => {
+        const room = new Arena(config);
+        // Register callbacks that update React state
+        room.onOpponentJoin((publicKey) => {
+            setOpponent({
+                publicKey,
+                gameState: null,
+                isConnected: true,
+                lastHeartbeat: Date.now(),
+                rematchRequested: false,
+            });
+            setRoomState((prev) => ({ ...prev, status: 'ready' }));
+            callbacksRef.current?.onOpponentJoin?.(publicKey);
+        });
+        room.onOpponentState((state) => {
+            setOpponent((prev) => prev
+                ? {
+                    ...prev,
+                    gameState: state,
+                    lastHeartbeat: Date.now(),
+                    isConnected: true,
+                }
+                : null);
+            callbacksRef.current?.onOpponentState?.(state);
+        });
+        room.onOpponentDisconnect(() => {
+            setOpponent((prev) => (prev ? { ...prev, isConnected: false } : null));
+            callbacksRef.current?.onOpponentDisconnect?.();
+        });
+        room.onOpponentGameOver((reason, finalScore) => {
+            setRoomState((prev) => ({ ...prev, status: 'finished', rematchRequested: false }));
+            setOpponent((prev) => (prev ? { ...prev, rematchRequested: false } : null));
+            callbacksRef.current?.onOpponentGameOver?.(reason, finalScore);
+        });
+        room.onRematchRequested(() => {
+            setOpponent((prev) => (prev ? { ...prev, rematchRequested: true } : null));
+            callbacksRef.current?.onRematchRequested?.();
+        });
+        room.onRematchStart((newSeed) => {
+            setRoomState((prev) => ({
+                ...prev,
+                seed: newSeed,
+                status: 'ready',
+                rematchRequested: false,
+            }));
+            setOpponent((prev) => (prev ? { ...prev, gameState: null, rematchRequested: false } : null));
+            callbacksRef.current?.onRematchStart?.(newSeed);
+        });
+        room.onError((error) => {
+            callbacksRef.current?.onError?.(error);
+        });
+        room.connect();
+        setIsConnected(true);
+        roomRef.current = room;
+        return () => {
+            room.disconnect();
+            roomRef.current = null;
+        };
+        // Note: config should be stable (memoized) by the caller
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [config.gameId]);
+    // Create room
+    const createRoom = useCallback(async (baseUrl) => {
+        if (!roomRef.current)
+            throw new Error('Arena not initialized');
+        const url = await roomRef.current.create(baseUrl);
+        setRoomState(roomRef.current.roomState);
+        return url;
+    }, []);
+    // Join room
+    const joinRoom = useCallback(async (roomId) => {
+        if (!roomRef.current)
+            throw new Error('Arena not initialized');
+        try {
+            await roomRef.current.join(roomId);
+            setRoomState(roomRef.current.roomState);
+            const opp = roomRef.current.opponent;
+            if (opp) {
+                setOpponent({
+                    publicKey: opp.publicKey,
+                    gameState: opp.gameState ?? null,
+                    isConnected: opp.isConnected,
+                    lastHeartbeat: opp.lastHeartbeat,
+                    rematchRequested: opp.rematchRequested,
+                });
+            }
+        }
+        catch (error) {
+            // Reset state on join failure
+            setRoomState(INITIAL_ROOM_STATE);
+            setOpponent(null);
+            throw error;
+        }
+    }, []);
+    // Leave room
+    const leaveRoom = useCallback(() => {
+        if (!roomRef.current)
+            return;
+        roomRef.current.leave();
+        setRoomState(INITIAL_ROOM_STATE);
+        setOpponent(null);
+    }, []);
+    // Reconnect
+    const reconnect = useCallback(async () => {
+        if (!roomRef.current)
+            return false;
+        const success = await roomRef.current.reconnect();
+        if (success) {
+            setRoomState(roomRef.current.roomState);
+            const opp = roomRef.current.opponent;
+            if (opp) {
+                setOpponent({
+                    publicKey: opp.publicKey,
+                    gameState: opp.gameState ?? null,
+                    isConnected: opp.isConnected,
+                    lastHeartbeat: opp.lastHeartbeat,
+                    rematchRequested: opp.rematchRequested,
+                });
+            }
+        }
+        return success;
+    }, []);
+    // Send state
+    const sendState = useCallback((state) => {
+        roomRef.current?.sendState(state);
+    }, []);
+    // Send game over
+    const sendGameOver = useCallback((reason, finalScore) => {
+        roomRef.current?.sendGameOver(reason, finalScore);
+        setRoomState((prev) => ({ ...prev, status: 'finished' }));
+    }, []);
+    // Request rematch
+    const requestRematch = useCallback(() => {
+        if (!roomRef.current)
+            return;
+        roomRef.current.requestRematch();
+        setRoomState((prev) => ({ ...prev, rematchRequested: true }));
+        // If opponent already requested, trigger acceptRematch
+        if (opponent?.rematchRequested) {
+            roomRef.current.acceptRematch();
+        }
+    }, [opponent?.rematchRequested]);
+    // Accept rematch
+    const acceptRematch = useCallback(() => {
+        roomRef.current?.acceptRematch();
+    }, []);
+    return {
+        roomState,
+        opponent,
+        isConnected,
+        publicKey: roomRef.current?.publicKey ?? '',
+        createRoom,
+        joinRoom,
+        leaveRoom,
+        reconnect,
+        sendState,
+        sendGameOver,
+        requestRematch,
+        acceptRematch,
+    };
+}
+//# sourceMappingURL=useArena.js.map

package/dist/react/useArena.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useArena.js","sourceRoot":"","sources":["../../src/react/useArena.ts"],"names":[],"mappings":"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"}

package/dist/retry.d.ts

@@ -0,0 +1,54 @@
+/**
+ * nostr-battle-room - Retry Utilities
+ * Exponential backoff retry logic for network operations
+ */
+export interface RetryOptions {
+    /** Maximum number of retry attempts (default: 3) */
+    maxAttempts?: number;
+    /** Initial delay in ms (default: 1000) */
+    initialDelay?: number;
+    /** Maximum delay in ms (default: 10000) */
+    maxDelay?: number;
+    /** Backoff multiplier (default: 2) */
+    backoffMultiplier?: number;
+    /** Called on each retry attempt */
+    onRetry?: (attempt: number, error: Error, delay: number) => void;
+}
+/**
+ * Execute a function with exponential backoff retry
+ *
+ * @example
+ * ```typescript
+ * const result = await withRetry(
+ *   () => fetchData(),
+ *   { maxAttempts: 3, initialDelay: 1000 }
+ * );
+ * ```
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+/**
+ * Create a promise that rejects after specified timeout
+ *
+ * @example
+ * ```typescript
+ * const result = await Promise.race([
+ *   fetchData(),
+ *   timeout(5000, 'Fetch timed out')
+ * ]);
+ * ```
+ */
+export declare function timeout<T = never>(ms: number, message?: string): Promise<T>;
+/**
+ * Execute a function with timeout
+ *
+ * @example
+ * ```typescript
+ * const result = await withTimeout(
+ *   () => fetchData(),
+ *   5000,
+ *   'Fetch timed out'
+ * );
+ * ```
+ */
+export declare function withTimeout<T>(fn: () => Promise<T>, ms: number, message?: string): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mCAAmC;IACnC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAClE;AAgBD;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,CAAC,CAAC,CA2B/F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,CAAC,GAAG,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,SAAwB,GAAG,OAAO,CAAC,CAAC,CAAC,CAI1F;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,EAAE,EAAE,MAAM,EACV,OAAO,SAAwB,GAC9B,OAAO,CAAC,CAAC,CAAC,CAEZ"}

package/dist/retry.js

@@ -0,0 +1,82 @@
+/**
+ * nostr-battle-room - Retry Utilities
+ * Exponential backoff retry logic for network operations
+ */
+const DEFAULT_RETRY_OPTIONS = {
+    maxAttempts: 3,
+    initialDelay: 1000,
+    maxDelay: 10000,
+    backoffMultiplier: 2,
+};
+/**
+ * Sleep for specified milliseconds
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Execute a function with exponential backoff retry
+ *
+ * @example
+ * ```typescript
+ * const result = await withRetry(
+ *   () => fetchData(),
+ *   { maxAttempts: 3, initialDelay: 1000 }
+ * );
+ * ```
+ */
+export async function withRetry(fn, options = {}) {
+    const opts = { ...DEFAULT_RETRY_OPTIONS, ...options };
+    let lastError = null;
+    let delay = opts.initialDelay;
+    for (let attempt = 1; attempt <= opts.maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (attempt === opts.maxAttempts) {
+                break;
+            }
+            // Call onRetry callback if provided
+            opts.onRetry?.(attempt, lastError, delay);
+            // Wait before next retry
+            await sleep(delay);
+            // Increase delay with exponential backoff
+            delay = Math.min(delay * opts.backoffMultiplier, opts.maxDelay);
+        }
+    }
+    throw lastError;
+}
+/**
+ * Create a promise that rejects after specified timeout
+ *
+ * @example
+ * ```typescript
+ * const result = await Promise.race([
+ *   fetchData(),
+ *   timeout(5000, 'Fetch timed out')
+ * ]);
+ * ```
+ */
+export function timeout(ms, message = 'Operation timed out') {
+    return new Promise((_, reject) => {
+        setTimeout(() => reject(new Error(message)), ms);
+    });
+}
+/**
+ * Execute a function with timeout
+ *
+ * @example
+ * ```typescript
+ * const result = await withTimeout(
+ *   () => fetchData(),
+ *   5000,
+ *   'Fetch timed out'
+ * );
+ * ```
+ */
+export async function withTimeout(fn, ms, message = 'Operation timed out') {
+    return Promise.race([fn(), timeout(ms, message)]);
+}
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,MAAM,qBAAqB,GAA4C;IACrE,WAAW,EAAE,CAAC;IACd,YAAY,EAAE,IAAI;IAClB,QAAQ,EAAE,KAAK;IACf,iBAAiB,EAAE,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,EAAoB,EAAE,UAAwB,EAAE;IACjF,MAAM,IAAI,GAAG,EAAE,GAAG,qBAAqB,EAAE,GAAG,OAAO,EAAE,CAAC;IACtD,IAAI,SAAS,GAAiB,IAAI,CAAC;IACnC,IAAI,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC;IAE9B,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QAC7D,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAEtE,IAAI,OAAO,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjC,MAAM;YACR,CAAC;YAED,oCAAoC;YACpC,IAAI,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;YAE1C,yBAAyB;YACzB,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;YAEnB,0CAA0C;YAC1C,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAC;AAClB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CAAY,EAAU,EAAE,OAAO,GAAG,qBAAqB;IAC5E,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC/B,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,EAAoB,EACpB,EAAU,EACV,OAAO,GAAG,qBAAqB;IAE/B,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAI,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC"}

package/dist/testing/MockArena.d.ts

@@ -0,0 +1,84 @@
+/**
+ * nostr-battle-room - MockArena
+ * Testing utilities for battle room
+ */
+import type { RoomState, OpponentBase, ArenaCallbacks, ArenaEventName } from '../types';
+/**
+ * Map event names to callback keys
+ */
+type EventToCallback<TGameState> = {
+    opponentJoin: ArenaCallbacks<TGameState>['onOpponentJoin'];
+    opponentState: ArenaCallbacks<TGameState>['onOpponentState'];
+    opponentDisconnect: ArenaCallbacks<TGameState>['onOpponentDisconnect'];
+    opponentGameOver: ArenaCallbacks<TGameState>['onOpponentGameOver'];
+    rematchRequested: ArenaCallbacks<TGameState>['onRematchRequested'];
+    rematchStart: ArenaCallbacks<TGameState>['onRematchStart'];
+    error: ArenaCallbacks<TGameState>['onError'];
+};
+/**
+ * Mock opponent state
+ */
+interface MockOpponentState<TGameState> extends OpponentBase {
+    gameState: TGameState | null;
+}
+/**
+ * MockArena - For testing without real Nostr connections
+ *
+ * @example
+ * ```typescript
+ * const mock = new MockArena<MyGameState>({ gameId: 'test' });
+ *
+ * // Simulate opponent joining
+ * mock.simulateOpponentJoin('pubkey123');
+ *
+ * // Simulate opponent state update
+ * mock.simulateOpponentState({ score: 100 });
+ *
+ * // Simulate opponent disconnect
+ * mock.simulateOpponentDisconnect();
+ * ```
+ */
+export declare class MockArena<TGameState = Record<string, unknown>> {
+    private _roomState;
+    private _opponent;
+    private callbacks;
+    constructor(_config: {
+        gameId: string;
+    });
+    get roomState(): Readonly<RoomState>;
+    get opponent(): Readonly<MockOpponentState<TGameState>> | null;
+    get isConnected(): boolean;
+    get publicKey(): string;
+    on<K extends ArenaEventName>(event: K, callback: NonNullable<EventToCallback<TGameState>[K]>): this;
+    connect(): void;
+    disconnect(): void;
+    create(): Promise<string>;
+    join(roomId: string): Promise<void>;
+    leave(): void;
+    sendState(_state: TGameState): void;
+    sendGameOver(_reason: string, _finalScore?: number): void;
+    requestRematch(): void;
+    acceptRematch(): void;
+    /**
+     * Simulate an opponent joining the room
+     */
+    simulateOpponentJoin(publicKey?: string): void;
+    /**
+     * Simulate opponent state update
+     */
+    simulateOpponentState(state: TGameState): void;
+    /**
+     * Simulate opponent disconnection
+     */
+    simulateOpponentDisconnect(): void;
+    /**
+     * Simulate opponent game over
+     */
+    simulateOpponentGameOver(reason: string, finalScore?: number): void;
+    /**
+     * Simulate opponent rematch request
+     */
+    simulateRematchRequested(): void;
+}
+export {};
+//# sourceMappingURL=MockArena.d.ts.map

package/dist/testing/MockArena.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockArena.d.ts","sourceRoot":"","sources":["../../src/testing/MockArena.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAGxF;;GAEG;AACH,KAAK,eAAe,CAAC,UAAU,IAAI;IACjC,YAAY,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC3D,aAAa,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC7D,kBAAkB,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC,sBAAsB,CAAC,CAAC;IACvE,gBAAgB,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,CAAC;IACnE,gBAAgB,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,CAAC;IACnE,YAAY,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC3D,KAAK,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC;CAC9C,CAAC;AAEF;;GAEG;AACH,UAAU,iBAAiB,CAAC,UAAU,CAAE,SAAQ,YAAY;IAC1D,SAAS,EAAE,UAAU,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,SAAS,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzD,OAAO,CAAC,UAAU,CAAwC;IAC1D,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,SAAS,CAAkC;gBAEvC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE;IAIvC,IAAI,SAAS,IAAI,QAAQ,CAAC,SAAS,CAAC,CAEnC;IAED,IAAI,QAAQ,IAAI,QAAQ,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI,CAE7D;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,EAAE,CAAC,CAAC,SAAS,cAAc,EACzB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,WAAW,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GACpD,IAAI;IAOP,OAAO,IAAI,IAAI;IAIf,UAAU,IAAI,IAAI;IAIZ,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAYzB,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUzC,KAAK,IAAI,IAAI;IAKb,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAInC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAIzD,cAAc,IAAI,IAAI;IAItB,aAAa,IAAI,IAAI;IAkBrB;;OAEG;IACH,oBAAoB,CAAC,SAAS,GAAE,MAA0B,GAAG,IAAI;IAYjE;;OAEG;IACH,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAY9C;;OAEG;IACH,0BAA0B,IAAI,IAAI;IAOlC;;OAEG;IACH,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAKnE;;OAEG;IACH,wBAAwB,IAAI,IAAI;CAMjC"}