nostr-arena 0.1.1

package/dist/__tests__/state-flow.test.js

@@ -0,0 +1,160 @@
+/**
+ * State Flow Tests
+ *
+ * Source: architecture.md - State Flow diagram
+ *
+ * ```
+ * ┌─────────┐  create()   ┌─────────┐  opponent   ┌─────────┐
+ * │  idle   │────────────▶│ waiting │────joins───▶│  ready  │
+ * └─────────┘             └─────────┘             └────┬────┘
+ *      ▲                                               │
+ *      │                                          game starts
+ *      │                                               │
+ *      │                  ┌──────────┐             ┌───▼─────┐
+ *      │◀────leave()──────│ finished │◀──gameover──│ playing │
+ *      │                  └────┬─────┘             └─────────┘
+ *      │                       │
+ *      │                   rematch
+ *      │                       │
+ *      │                  ┌────▼────┐
+ *      └──────────────────│  ready  │
+ *                         └─────────┘
+ * ```
+ *
+ * Source: README.md - Room States table
+ *
+ * | Status   | Description                           |
+ * | -------- | ------------------------------------- |
+ * | idle     | No room active                        |
+ * | creating | Creating a new room                   |
+ * | waiting  | Waiting for opponent to join          |
+ * | joining  | Joining an existing room              |
+ * | ready    | Both players connected, ready to play |
+ * | playing  | Game in progress                      |
+ * | finished | Game ended                            |
+ */
+import { describe, it, expect, beforeEach } from 'vitest';
+import { MockArena } from '../testing/MockArena';
+describe('State Flow (architecture.md)', () => {
+    let room;
+    beforeEach(() => {
+        room = new MockArena({ gameId: 'test-game' });
+    });
+    describe('Initial state: idle', () => {
+        /**
+         * Source: README.md - "idle: No room active"
+         */
+        it('should start in idle status', () => {
+            expect(room.roomState.status).toBe('idle');
+        });
+    });
+    describe('Transition: idle → waiting (via create())', () => {
+        /**
+         * Source: architecture.md diagram
+         * "idle ──create()──▶ waiting"
+         */
+        it('create() should transition from idle to waiting', async () => {
+            expect(room.roomState.status).toBe('idle');
+            await room.create();
+            expect(room.roomState.status).toBe('waiting');
+        });
+        it('after create(), isHost should be true', async () => {
+            await room.create();
+            expect(room.roomState.isHost).toBe(true);
+        });
+    });
+    describe('Transition: waiting → ready (opponent joins)', () => {
+        /**
+         * Source: architecture.md diagram
+         * "waiting ──opponent joins──▶ ready"
+         */
+        it('should transition from waiting to ready when opponent joins', async () => {
+            await room.create();
+            expect(room.roomState.status).toBe('waiting');
+            room.simulateOpponentJoin('opponent-pubkey');
+            expect(room.roomState.status).toBe('ready');
+        });
+    });
+    describe('Transition: idle → ready (via join())', () => {
+        /**
+         * Source: architecture.md - Arena API
+         * "join(roomId): Promise<void>"
+         *
+         * Note: The diagram shows idle → joining → ready, but for MockArena
+         * join() directly goes to ready (simplified for testing)
+         */
+        it('join() should transition to ready', async () => {
+            expect(room.roomState.status).toBe('idle');
+            await room.join('existing-room-id');
+            expect(room.roomState.status).toBe('ready');
+        });
+        it('after join(), isHost should be false', async () => {
+            await room.join('existing-room-id');
+            expect(room.roomState.isHost).toBe(false);
+        });
+    });
+    describe('Transition: playing → finished (gameover)', () => {
+        /**
+         * Source: architecture.md diagram
+         * "playing ──gameover──▶ finished"
+         */
+        it('sendGameOver() should transition to finished', async () => {
+            await room.create();
+            room.simulateOpponentJoin('opponent');
+            room.sendGameOver('win', 500);
+            expect(room.roomState.status).toBe('finished');
+        });
+    });
+    describe('Transition: any → idle (leave())', () => {
+        /**
+         * Source: architecture.md diagram
+         * "◀────leave()────"
+         */
+        it('leave() from waiting should go to idle', async () => {
+            await room.create();
+            expect(room.roomState.status).toBe('waiting');
+            room.leave();
+            expect(room.roomState.status).toBe('idle');
+        });
+        it('leave() from ready should go to idle', async () => {
+            await room.create();
+            room.simulateOpponentJoin('opponent');
+            expect(room.roomState.status).toBe('ready');
+            room.leave();
+            expect(room.roomState.status).toBe('idle');
+        });
+        it('leave() from finished should go to idle', async () => {
+            await room.create();
+            room.simulateOpponentJoin('opponent');
+            room.sendGameOver('win');
+            expect(room.roomState.status).toBe('finished');
+            room.leave();
+            expect(room.roomState.status).toBe('idle');
+        });
+    });
+    describe('Transition: finished → ready (rematch)', () => {
+        /**
+         * Source: architecture.md diagram
+         * "finished ──rematch──▶ ready"
+         */
+        it('acceptRematch() should transition from finished to ready', async () => {
+            await room.create();
+            room.simulateOpponentJoin('opponent');
+            room.sendGameOver('win');
+            expect(room.roomState.status).toBe('finished');
+            room.simulateRematchRequested();
+            room.acceptRematch();
+            expect(room.roomState.status).toBe('ready');
+        });
+        it('rematch should generate new seed', async () => {
+            await room.create();
+            room.simulateOpponentJoin('opponent');
+            const oldSeed = room.roomState.seed;
+            room.sendGameOver('win');
+            room.simulateRematchRequested();
+            room.acceptRematch();
+            expect(room.roomState.seed).not.toBe(oldSeed);
+        });
+    });
+});
+//# sourceMappingURL=state-flow.test.js.map

package/dist/__tests__/state-flow.test.js.map

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

package/dist/__tests__/timing.test.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Timing Tests
+ *
+ * Source: architecture.md - Timing section
+ *
+ * | Constant              | Default           | Description           |
+ * | --------------------- | ----------------- | --------------------- |
+ * | `roomExpiry`          | 600000ms (10 min) | Room expiration       |
+ * | `heartbeatInterval`   | 3000ms            | Heartbeat sending     |
+ * | `disconnectThreshold` | 10000ms           | Disconnect detection  |
+ * | `stateThrottle`       | 100ms             | State update throttle |
+ * | `joinTimeout`         | 30000ms           | Join timeout          |
+ *
+ * Source: protocol.md - Heartbeat section
+ *
+ * "Every 3 seconds"
+ * "If no heartbeat received for 10 seconds, opponent is considered disconnected."
+ */
+export {};
+//# sourceMappingURL=timing.test.d.ts.map

package/dist/__tests__/timing.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/timing.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/__tests__/timing.test.js

@@ -0,0 +1,73 @@
+/**
+ * Timing Tests
+ *
+ * Source: architecture.md - Timing section
+ *
+ * | Constant              | Default           | Description           |
+ * | --------------------- | ----------------- | --------------------- |
+ * | `roomExpiry`          | 600000ms (10 min) | Room expiration       |
+ * | `heartbeatInterval`   | 3000ms            | Heartbeat sending     |
+ * | `disconnectThreshold` | 10000ms           | Disconnect detection  |
+ * | `stateThrottle`       | 100ms             | State update throttle |
+ * | `joinTimeout`         | 30000ms           | Join timeout          |
+ *
+ * Source: protocol.md - Heartbeat section
+ *
+ * "Every 3 seconds"
+ * "If no heartbeat received for 10 seconds, opponent is considered disconnected."
+ */
+import { describe, it, expect } from 'vitest';
+import { DEFAULT_CONFIG } from '../types';
+describe('Timing Constants (architecture.md)', () => {
+    describe('roomExpiry', () => {
+        it('should be 600000ms (10 min)', () => {
+            expect(DEFAULT_CONFIG.roomExpiry).toBe(600000);
+        });
+        it('should equal 10 minutes in milliseconds', () => {
+            const tenMinutesMs = 10 * 60 * 1000;
+            expect(DEFAULT_CONFIG.roomExpiry).toBe(tenMinutesMs);
+        });
+    });
+    describe('heartbeatInterval', () => {
+        it('should be 3000ms', () => {
+            expect(DEFAULT_CONFIG.heartbeatInterval).toBe(3000);
+        });
+        it('should equal 3 seconds in milliseconds', () => {
+            const threeSecondsMs = 3 * 1000;
+            expect(DEFAULT_CONFIG.heartbeatInterval).toBe(threeSecondsMs);
+        });
+    });
+    describe('disconnectThreshold', () => {
+        it('should be 10000ms', () => {
+            expect(DEFAULT_CONFIG.disconnectThreshold).toBe(10000);
+        });
+        it('should equal 10 seconds in milliseconds', () => {
+            const tenSecondsMs = 10 * 1000;
+            expect(DEFAULT_CONFIG.disconnectThreshold).toBe(tenSecondsMs);
+        });
+    });
+    describe('stateThrottle', () => {
+        it('should be 100ms', () => {
+            expect(DEFAULT_CONFIG.stateThrottle).toBe(100);
+        });
+    });
+});
+describe('Timing Relationships (protocol.md)', () => {
+    /**
+     * Source: protocol.md - Heartbeat section
+     *
+     * "Every 3 seconds ... If no heartbeat received for 10 seconds"
+     *
+     * This implies: disconnectThreshold > heartbeatInterval * 3
+     * (we need to miss at least 3 heartbeats to detect disconnect)
+     */
+    it('should detect disconnect after missing ~3 heartbeats', () => {
+        const missedHeartbeats = DEFAULT_CONFIG.disconnectThreshold / DEFAULT_CONFIG.heartbeatInterval;
+        // 10000 / 3000 = 3.33, meaning ~3 missed heartbeats trigger disconnect
+        expect(missedHeartbeats).toBeGreaterThanOrEqual(3);
+    });
+    it('disconnect threshold should be greater than heartbeat interval', () => {
+        expect(DEFAULT_CONFIG.disconnectThreshold).toBeGreaterThan(DEFAULT_CONFIG.heartbeatInterval);
+    });
+});
+//# sourceMappingURL=timing.test.js.map

package/dist/__tests__/timing.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.test.js","sourceRoot":"","sources":["../../src/__tests__/timing.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,QAAQ,CAAC,oCAAoC,EAAE,GAAG,EAAE;IAClD,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,MAAM,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YACjD,MAAM,YAAY,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;YACpC,MAAM,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;QACjC,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;YAC1B,MAAM,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,CAAC;YAChC,MAAM,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;YAC3B,MAAM,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YACjD,MAAM,YAAY,GAAG,EAAE,GAAG,IAAI,CAAC;YAC/B,MAAM,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,iBAAiB,EAAE,GAAG,EAAE;YACzB,MAAM,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oCAAoC,EAAE,GAAG,EAAE;IAClD;;;;;;;OAOG;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,gBAAgB,GAAG,cAAc,CAAC,mBAAmB,GAAG,cAAc,CAAC,iBAAiB,CAAC;QAC/F,uEAAuE;QACvE,MAAM,CAAC,gBAAgB,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC,eAAe,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;IAC/F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/Arena.d.ts

@@ -0,0 +1,164 @@
+/**
+ * nostr-battle-room - Arena
+ * Main class for managing multiplayer game rooms over Nostr
+ */
+import type { ArenaConfig, RoomState, OpponentBase } from '../types';
+/**
+ * Internal opponent state (mutable)
+ */
+interface InternalOpponentState<TGameState> extends OpponentBase {
+    gameState: TGameState | null;
+}
+/**
+ * Arena - Manages a multiplayer game room over Nostr
+ *
+ * @example
+ * ```typescript
+ * interface MyGameState {
+ *   score: number;
+ *   position: { x: number; y: number };
+ * }
+ *
+ * const room = new Arena<MyGameState>({
+ *   gameId: 'my-game',
+ *   relays: ['wss://relay.damus.io'],
+ * });
+ *
+ * room.on('opponentState', (state) => {
+ *   console.log('Opponent score:', state.score);
+ * });
+ *
+ * const url = await room.create();
+ * console.log('Share this URL:', url);
+ * ```
+ */
+export declare class Arena<TGameState = Record<string, unknown>> {
+    private client;
+    private config;
+    private callbacks;
+    private _roomState;
+    private _opponent;
+    private unsubscribe;
+    private heartbeatInterval;
+    private disconnectCheckInterval;
+    private lastStateUpdate;
+    private storage;
+    constructor(config: ArenaConfig);
+    /** Current room state */
+    get roomState(): Readonly<RoomState>;
+    /** Current opponent state (null if no opponent) */
+    get opponent(): Readonly<InternalOpponentState<TGameState>> | null;
+    /** Whether connected to Nostr relays */
+    get isConnected(): boolean;
+    /** This player's public key */
+    get publicKey(): string;
+    /**
+     * Get the connection status of each relay
+     */
+    getRelayStatus(): Map<string, boolean>;
+    /**
+     * Check if at least one relay is connected
+     */
+    get hasConnectedRelay(): boolean;
+    /**
+     * Register event callback for opponentJoin
+     */
+    onOpponentJoin(callback: (publicKey: string) => void): this;
+    /**
+     * Register event callback for opponentState
+     */
+    onOpponentState(callback: (state: TGameState) => void): this;
+    /**
+     * Register event callback for opponentDisconnect
+     */
+    onOpponentDisconnect(callback: () => void): this;
+    /**
+     * Register event callback for opponentGameOver
+     */
+    onOpponentGameOver(callback: (reason: string, finalScore?: number) => void): this;
+    /**
+     * Register event callback for rematchRequested
+     */
+    onRematchRequested(callback: () => void): this;
+    /**
+     * Register event callback for rematchStart
+     */
+    onRematchStart(callback: (newSeed: number) => void): this;
+    /**
+     * Register event callback for error
+     */
+    onError(callback: (error: Error) => void): this;
+    /**
+     * Connect to Nostr relays
+     */
+    connect(): void;
+    /**
+     * Disconnect from relays and clean up
+     */
+    disconnect(): void;
+    /**
+     * Create a new room
+     *
+     * Times out after joinTimeout (default: 30 seconds)
+     * @returns Room URL (e.g., "https://example.com/battle/abc123")
+     */
+    create(baseUrl?: string): Promise<string>;
+    /**
+     * Internal create implementation
+     */
+    private createInternal;
+    /**
+     * Join an existing room
+     *
+     * Times out after joinTimeout (default: 30 seconds)
+     */
+    join(roomId: string): Promise<void>;
+    /**
+     * Internal join implementation
+     */
+    private joinInternal;
+    /**
+     * Leave the current room
+     */
+    leave(): void;
+    /**
+     * Attempt to reconnect to a previously joined room
+     */
+    reconnect(): Promise<boolean>;
+    /**
+     * Internal reconnection logic
+     */
+    private reconnectInternal;
+    /**
+     * Send game state to opponent (throttled)
+     */
+    sendState(state: TGameState): void;
+    /**
+     * Send game over event
+     */
+    sendGameOver(reason: string, finalScore?: number): void;
+    /**
+     * Request a rematch
+     */
+    requestRematch(): void;
+    /**
+     * Accept a rematch request
+     */
+    acceptRematch(): void;
+    private subscribeToRoom;
+    private handleRoomEvent;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private startDisconnectCheck;
+    private stopDisconnectCheck;
+    private publishToRoom;
+    private createInitialOpponent;
+    private resetForRematch;
+    private get storageKey();
+    private saveRoom;
+    private loadRoom;
+    private clearRoom;
+    private isExpired;
+}
+export {};
+//# sourceMappingURL=Arena.d.ts.map

package/dist/core/Arena.d.ts.map

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