nostr-arena 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 kako-jun
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,188 @@
+# nostr-arena
+
+Nostr-based real-time battle room for multiplayer games. No server required.
+
+## Features
+
+- **P2P Matchmaking**: Create and join rooms via shareable URLs
+- **Real-time State Sync**: Send game state to opponents with automatic throttling
+- **Connection Health**: Heartbeat and disconnect detection
+- **Reconnection**: Automatic reconnection from localStorage
+- **Rematch**: Built-in rematch flow
+- **Framework Agnostic**: Core classes work anywhere, React hooks included
+
+## Installation
+
+```bash
+npm install nostr-arena nostr-tools
+```
+
+## Quick Start
+
+### React
+
+```tsx
+import { useArena } from 'nostr-arena/react';
+
+interface MyGameState {
+  score: number;
+  position: { x: number; y: number };
+}
+
+function Game() {
+  const { roomState, opponent, createRoom, joinRoom, sendState, leaveRoom } =
+    useArena<MyGameState>({
+      gameId: 'my-game',
+    });
+
+  const handleCreate = async () => {
+    const url = await createRoom();
+    // Share this URL with opponent
+    navigator.clipboard.writeText(url);
+  };
+
+  const handleMove = (x: number, y: number) => {
+    sendState({ score: 100, position: { x, y } });
+  };
+
+  return (
+    <div>
+      <p>Status: {roomState.status}</p>
+      {roomState.status === 'idle' && <button onClick={handleCreate}>Create Room</button>}
+      {opponent && <p>Opponent score: {opponent.gameState?.score ?? 0}</p>}
+    </div>
+  );
+}
+```
+
+### Vanilla JavaScript
+
+```typescript
+import { Arena } from 'nostr-arena';
+
+interface MyGameState {
+  score: number;
+}
+
+const room = new Arena<MyGameState>({
+  gameId: 'my-game',
+  relays: ['wss://relay.damus.io'],
+});
+
+// Register event callbacks (chainable)
+room
+  .onOpponentJoin((pubkey) => {
+    console.log('Opponent joined:', pubkey);
+  })
+  .onOpponentState((state) => {
+    console.log('Opponent score:', state.score);
+  })
+  .onOpponentDisconnect(() => {
+    console.log('Opponent disconnected');
+  });
+
+// Create a room
+room.connect();
+const url = await room.create();
+console.log('Share this URL:', url);
+
+// Send state updates
+room.sendState({ score: 100 });
+
+// Game over
+room.sendGameOver('win', 500);
+
+// Cleanup
+room.disconnect();
+```
+
+## API
+
+### ArenaConfig
+
+```typescript
+interface ArenaConfig {
+  gameId: string; // Required: unique game identifier
+  relays?: string[]; // Nostr relay URLs (default: public relays)
+  roomExpiry?: number; // Room expiration in ms (default: 600000 = 10 min)
+  heartbeatInterval?: number; // Heartbeat interval in ms (default: 3000)
+  disconnectThreshold?: number; // Disconnect threshold in ms (default: 10000)
+  stateThrottle?: number; // State update throttle in ms (default: 100)
+}
+```
+
+### Room States
+
+| 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                            |
+
+### Events (Callbacks)
+
+| Event              | Parameters                       | Description                |
+| ------------------ | -------------------------------- | -------------------------- |
+| opponentJoin       | (publicKey: string)              | Opponent joined the room   |
+| opponentState      | (state: TGameState)              | Opponent sent state update |
+| opponentDisconnect | ()                               | Opponent disconnected      |
+| opponentGameOver   | (reason: string, score?: number) | Opponent game over         |
+| rematchRequested   | ()                               | Opponent requested rematch |
+| rematchStart       | (newSeed: number)                | Rematch starting           |
+| error              | (error: Error)                   | Error occurred             |
+
+## Node.js / Proxy Support
+
+For Node.js environments or when you need proxy support, call `configureProxy()` before creating any rooms:
+
+```typescript
+import { configureProxy, Arena } from 'nostr-arena';
+
+// Call once at startup
+configureProxy();
+
+// Now create rooms as usual
+const room = new Arena({ gameId: 'my-game' });
+```
+
+This function:
+
+- Configures the `ws` package for Node.js WebSocket support
+- Reads proxy URL from environment variables: `HTTPS_PROXY`, `HTTP_PROXY`, or `ALL_PROXY`
+- No-op in browser environments (browsers handle proxies at OS level)
+
+**Required packages for Node.js:**
+
+```bash
+npm install ws                    # Required for Node.js
+npm install https-proxy-agent     # Required for proxy support
+```
+
+## Testing
+
+```typescript
+import { MockArena } from 'nostr-arena/testing';
+
+const mock = new MockArena<MyGameState>({ gameId: 'test' });
+
+// Simulate opponent actions
+mock.simulateOpponentJoin('pubkey123');
+mock.simulateOpponentState({ score: 100 });
+mock.simulateOpponentDisconnect();
+```
+
+## How It Works
+
+1. **Room Creation**: Host publishes a replaceable event (kind 30078) with room info
+2. **Joining**: Guest fetches room event, sends join notification (kind 25000)
+3. **State Sync**: Players send ephemeral events (kind 25000) with game state
+4. **Heartbeat**: Periodic heartbeat events detect disconnections
+5. **Cleanup**: Ephemeral events are not stored by relays (no garbage)
+
+## License
+
+MIT

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

@@ -0,0 +1,28 @@
+/**
+ * Callbacks Tests
+ *
+ * Source: README.md - Events (Callbacks) table
+ *
+ * | Event              | Parameters                       | Description                |
+ * | ------------------ | -------------------------------- | -------------------------- |
+ * | opponentJoin       | (publicKey: string)              | Opponent joined the room   |
+ * | opponentState      | (state: TGameState)              | Opponent sent state update |
+ * | opponentDisconnect | ()                               | Opponent disconnected      |
+ * | opponentGameOver   | (reason: string, score?: number) | Opponent game over         |
+ * | rematchRequested   | ()                               | Opponent requested rematch |
+ * | rematchStart       | (newSeed: number)                | Rematch starting           |
+ * | error              | (error: Error)                   | Error occurred             |
+ *
+ * Source: architecture.md - Arena API
+ *
+ * All callback methods return `this` for chaining:
+ * - onOpponentJoin(callback): this
+ * - onOpponentState(callback): this
+ * - onOpponentDisconnect(callback): this
+ * - onOpponentGameOver(callback): this
+ * - onRematchRequested(callback): this
+ * - onRematchStart(callback): this
+ * - onError(callback): this
+ */
+export {};
+//# sourceMappingURL=callbacks.test.d.ts.map

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

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

package/dist/__tests__/callbacks.test.js

@@ -0,0 +1,140 @@
+/**
+ * Callbacks Tests
+ *
+ * Source: README.md - Events (Callbacks) table
+ *
+ * | Event              | Parameters                       | Description                |
+ * | ------------------ | -------------------------------- | -------------------------- |
+ * | opponentJoin       | (publicKey: string)              | Opponent joined the room   |
+ * | opponentState      | (state: TGameState)              | Opponent sent state update |
+ * | opponentDisconnect | ()                               | Opponent disconnected      |
+ * | opponentGameOver   | (reason: string, score?: number) | Opponent game over         |
+ * | rematchRequested   | ()                               | Opponent requested rematch |
+ * | rematchStart       | (newSeed: number)                | Rematch starting           |
+ * | error              | (error: Error)                   | Error occurred             |
+ *
+ * Source: architecture.md - Arena API
+ *
+ * All callback methods return `this` for chaining:
+ * - onOpponentJoin(callback): this
+ * - onOpponentState(callback): this
+ * - onOpponentDisconnect(callback): this
+ * - onOpponentGameOver(callback): this
+ * - onRematchRequested(callback): this
+ * - onRematchStart(callback): this
+ * - onError(callback): this
+ */
+import { describe, it, expect, beforeEach } from 'vitest';
+import { MockArena } from '../testing/MockArena';
+describe('Callbacks (README.md, architecture.md)', () => {
+    let room;
+    beforeEach(() => {
+        room = new MockArena({ gameId: 'test-game' });
+    });
+    describe('opponentJoin: (publicKey: string)', () => {
+        it('should be called when opponent joins', async () => {
+            let receivedPubkey = null;
+            room.on('opponentJoin', (pubkey) => {
+                receivedPubkey = pubkey;
+            });
+            await room.create();
+            room.simulateOpponentJoin('opponent-abc123');
+            expect(receivedPubkey).toBe('opponent-abc123');
+        });
+    });
+    describe('opponentState: (state: TGameState)', () => {
+        it('should be called with game state when opponent sends state', async () => {
+            let receivedState = null;
+            room.on('opponentState', (state) => {
+                receivedState = state;
+            });
+            await room.create();
+            room.simulateOpponentJoin('opponent');
+            room.simulateOpponentState({ score: 250 });
+            expect(receivedState).toEqual({ score: 250 });
+        });
+    });
+    describe('opponentDisconnect: ()', () => {
+        it('should be called when opponent disconnects', async () => {
+            let disconnectCalled = false;
+            room.on('opponentDisconnect', () => {
+                disconnectCalled = true;
+            });
+            await room.create();
+            room.simulateOpponentJoin('opponent');
+            room.simulateOpponentDisconnect();
+            expect(disconnectCalled).toBe(true);
+        });
+    });
+    describe('opponentGameOver: (reason: string, score?: number)', () => {
+        it('should be called with reason when opponent ends game', async () => {
+            let receivedReason = null;
+            room.on('opponentGameOver', (reason) => {
+                receivedReason = reason;
+            });
+            await room.create();
+            room.simulateOpponentJoin('opponent');
+            room.simulateOpponentGameOver('surrender');
+            expect(receivedReason).toBe('surrender');
+        });
+        it('should receive optional score parameter', async () => {
+            let receivedScore;
+            room.on('opponentGameOver', (_reason, score) => {
+                receivedScore = score;
+            });
+            await room.create();
+            room.simulateOpponentJoin('opponent');
+            room.simulateOpponentGameOver('win', 1000);
+            expect(receivedScore).toBe(1000);
+        });
+    });
+    describe('rematchRequested: ()', () => {
+        it('should be called when opponent requests rematch', async () => {
+            let rematchRequested = false;
+            room.on('rematchRequested', () => {
+                rematchRequested = true;
+            });
+            await room.create();
+            room.simulateOpponentJoin('opponent');
+            room.sendGameOver('win');
+            room.simulateRematchRequested();
+            expect(rematchRequested).toBe(true);
+        });
+    });
+    describe('rematchStart: (newSeed: number)', () => {
+        it('should be called with new seed when rematch starts', async () => {
+            let receivedSeed = null;
+            room.on('rematchStart', (seed) => {
+                receivedSeed = seed;
+            });
+            await room.create();
+            room.simulateOpponentJoin('opponent');
+            room.sendGameOver('win');
+            room.simulateRematchRequested();
+            room.acceptRematch();
+            expect(receivedSeed).not.toBeNull();
+            expect(typeof receivedSeed).toBe('number');
+        });
+    });
+    describe('Chaining (architecture.md)', () => {
+        /**
+         * Source: architecture.md - Arena API
+         * All callback methods return `this` for chaining
+         */
+        it('on() should return this for chaining', () => {
+            const result = room.on('opponentJoin', () => { });
+            expect(result).toBe(room);
+        });
+        it('multiple callbacks can be chained', () => {
+            const result = room
+                .on('opponentJoin', () => { })
+                .on('opponentState', () => { })
+                .on('opponentDisconnect', () => { })
+                .on('opponentGameOver', () => { })
+                .on('rematchRequested', () => { })
+                .on('rematchStart', () => { });
+            expect(result).toBe(room);
+        });
+    });
+});
+//# sourceMappingURL=callbacks.test.js.map

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

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

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

@@ -0,0 +1,18 @@
+/**
+ * ArenaConfig Tests
+ *
+ * Source: README.md - ArenaConfig section
+ *
+ * ```typescript
+ * interface ArenaConfig {
+ *   gameId: string; // Required: unique game identifier
+ *   relays?: string[]; // Nostr relay URLs (default: public relays)
+ *   roomExpiry?: number; // Room expiration in ms (default: 600000 = 10 min)
+ *   heartbeatInterval?: number; // Heartbeat interval in ms (default: 3000)
+ *   disconnectThreshold?: number; // Disconnect threshold in ms (default: 10000)
+ *   stateThrottle?: number; // State update throttle in ms (default: 100)
+ * }
+ * ```
+ */
+export {};
+//# sourceMappingURL=config.test.d.ts.map

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

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

package/dist/__tests__/config.test.js

@@ -0,0 +1,43 @@
+/**
+ * ArenaConfig Tests
+ *
+ * Source: README.md - ArenaConfig section
+ *
+ * ```typescript
+ * interface ArenaConfig {
+ *   gameId: string; // Required: unique game identifier
+ *   relays?: string[]; // Nostr relay URLs (default: public relays)
+ *   roomExpiry?: number; // Room expiration in ms (default: 600000 = 10 min)
+ *   heartbeatInterval?: number; // Heartbeat interval in ms (default: 3000)
+ *   disconnectThreshold?: number; // Disconnect threshold in ms (default: 10000)
+ *   stateThrottle?: number; // State update throttle in ms (default: 100)
+ * }
+ * ```
+ */
+import { describe, it, expect } from 'vitest';
+import { DEFAULT_CONFIG } from '../types';
+describe('ArenaConfig defaults (README.md)', () => {
+    // "relays?: string[] // Nostr relay URLs (default: public relays)"
+    it('relays should default to public relays', () => {
+        expect(DEFAULT_CONFIG.relays).toBeDefined();
+        expect(Array.isArray(DEFAULT_CONFIG.relays)).toBe(true);
+        expect(DEFAULT_CONFIG.relays.length).toBeGreaterThan(0);
+    });
+    // "roomExpiry?: number // Room expiration in ms (default: 600000 = 10 min)"
+    it('roomExpiry should default to 600000ms (10 min)', () => {
+        expect(DEFAULT_CONFIG.roomExpiry).toBe(600000);
+    });
+    // "heartbeatInterval?: number // Heartbeat interval in ms (default: 3000)"
+    it('heartbeatInterval should default to 3000ms', () => {
+        expect(DEFAULT_CONFIG.heartbeatInterval).toBe(3000);
+    });
+    // "disconnectThreshold?: number // Disconnect threshold in ms (default: 10000)"
+    it('disconnectThreshold should default to 10000ms', () => {
+        expect(DEFAULT_CONFIG.disconnectThreshold).toBe(10000);
+    });
+    // "stateThrottle?: number // State update throttle in ms (default: 100)"
+    it('stateThrottle should default to 100ms', () => {
+        expect(DEFAULT_CONFIG.stateThrottle).toBe(100);
+    });
+});
+//# sourceMappingURL=config.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.js","sourceRoot":"","sources":["../../src/__tests__/config.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAChD,mEAAmE;IACnE,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,4EAA4E;IAC5E,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,2EAA2E;IAC3E,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,gFAAgF;IAChF,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,yEAAyE;IACzE,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/error-handling.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Error Handling Tests
+ *
+ * Source: architecture.md - Error Handling section
+ *
+ * Errors are reported via `onError` callback:
+ *
+ * Common errors:
+ * - `"Room not found"` - Room doesn't exist or expired
+ * - `"Room has expired"` - Room older than 10 minutes
+ * - `"NostrClient not connected"` - Called method before connect()
+ */
+export {};
+//# sourceMappingURL=error-handling.test.d.ts.map

package/dist/__tests__/error-handling.test.d.ts.map

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