nostr-arena 0.1.1

package/dist/core/NostrClient.d.ts

@@ -0,0 +1,108 @@
+/**
+ * nostr-battle-room - NostrClient
+ * Framework-agnostic Nostr connection management
+ */
+import type { Filter } from 'nostr-tools';
+import type { NostrEvent, Unsubscribe } from '../types';
+import { type RetryOptions } from '../retry';
+export type { Filter as NostrFilter } from 'nostr-tools';
+/**
+ * Options for NostrClient
+ */
+export interface NostrClientOptions {
+    /** Nostr relay URLs */
+    relays?: string[];
+    /** Storage key prefix for persisting keys */
+    storageKeyPrefix?: string;
+    /** Custom storage (defaults to localStorage) */
+    storage?: {
+        getItem: (key: string) => string | null;
+        setItem: (key: string, value: string) => void;
+    };
+    /** Retry options for publish operations */
+    publishRetry?: RetryOptions;
+}
+/**
+ * NostrClient - Manages Nostr connection, publishing, and subscriptions
+ *
+ * @example
+ * ```typescript
+ * const client = new NostrClient({ relays: ['wss://relay.damus.io'] });
+ * await client.connect();
+ *
+ * // Publish an event
+ * await client.publish({
+ *   kind: 25000,
+ *   tags: [['d', 'my-room']],
+ *   content: JSON.stringify({ type: 'state', data: {} }),
+ * });
+ *
+ * // Subscribe to events
+ * const unsubscribe = client.subscribe(
+ *   [{ kinds: [25000], '#d': ['my-room'] }],
+ *   (event) => console.log('Received:', event)
+ * );
+ *
+ * // Later: cleanup
+ * unsubscribe();
+ * client.disconnect();
+ * ```
+ */
+export declare class NostrClient {
+    private pool;
+    private secretKey;
+    private _publicKey;
+    private _isConnected;
+    private relays;
+    private storageKeyPrefix;
+    private storage;
+    private publishRetry;
+    constructor(options?: NostrClientOptions);
+    /**
+     * Whether the client is connected to relays
+     */
+    get isConnected(): boolean;
+    /**
+     * The public key of this client (Nostr identity)
+     */
+    get publicKey(): string;
+    /**
+     * Get the connection status of each relay
+     * @returns Map of relay URL to connection status (true = connected)
+     */
+    getRelayStatus(): Map<string, boolean>;
+    /**
+     * Check if at least one relay is connected
+     */
+    get hasConnectedRelay(): boolean;
+    /**
+     * Connect to Nostr relays
+     * Generates or retrieves a key pair from storage
+     */
+    connect(): void;
+    /**
+     * Safely set storage item, ignoring quota errors
+     */
+    private safeStorageSet;
+    /**
+     * Disconnect from all relays
+     */
+    disconnect(): void;
+    /**
+     * Publish an event to all relays with retry logic
+     *
+     * Retries with exponential backoff if all relays fail.
+     * Succeeds if at least one relay accepts the event.
+     */
+    publish(eventTemplate: Omit<NostrEvent, 'id' | 'pubkey' | 'created_at' | 'sig'>): Promise<void>;
+    /**
+     * Subscribe to events matching the given filters
+     * @returns Unsubscribe function
+     */
+    subscribe(filters: Filter[], onEvent: (event: NostrEvent) => void): Unsubscribe;
+    /**
+     * Fetch events matching the given filter (one-time query)
+     */
+    fetch(filter: Filter, timeoutMs?: number): Promise<NostrEvent[]>;
+}
+//# sourceMappingURL=NostrClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NostrClient.d.ts","sourceRoot":"","sources":["../../src/core/NostrClient.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAExD,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxD,YAAY,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gDAAgD;IAChD,OAAO,CAAC,EAAE;QACR,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;QACxC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;KAC/C,CAAC;IACF,2CAA2C;IAC3C,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAA2B;IACvC,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,OAAO,CAA6C;IAC5D,OAAO,CAAC,YAAY,CAAe;gBAEvB,OAAO,GAAE,kBAAuB;IAc5C;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;OAGG;IACH,cAAc,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IAOtC;;OAEG;IACH,IAAI,iBAAiB,IAAI,OAAO,CAG/B;IAED;;;OAGG;IACH,OAAO,IAAI,IAAI;IA+Bf;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,UAAU,IAAI,IAAI;IAQlB;;;;;OAKG;IACG,OAAO,CACX,aAAa,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,QAAQ,GAAG,YAAY,GAAG,KAAK,CAAC,GACtE,OAAO,CAAC,IAAI,CAAC;IAkBhB;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,WAAW;IAuB/E;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,MAAa,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CA2C7E"}

package/dist/core/NostrClient.js

@@ -0,0 +1,225 @@
+/**
+ * nostr-battle-room - NostrClient
+ * Framework-agnostic Nostr connection management
+ */
+import { SimplePool, finalizeEvent, generateSecretKey, getPublicKey } from 'nostr-tools';
+import { DEFAULT_CONFIG } from '../types';
+import { withRetry } from '../retry';
+/**
+ * NostrClient - Manages Nostr connection, publishing, and subscriptions
+ *
+ * @example
+ * ```typescript
+ * const client = new NostrClient({ relays: ['wss://relay.damus.io'] });
+ * await client.connect();
+ *
+ * // Publish an event
+ * await client.publish({
+ *   kind: 25000,
+ *   tags: [['d', 'my-room']],
+ *   content: JSON.stringify({ type: 'state', data: {} }),
+ * });
+ *
+ * // Subscribe to events
+ * const unsubscribe = client.subscribe(
+ *   [{ kinds: [25000], '#d': ['my-room'] }],
+ *   (event) => console.log('Received:', event)
+ * );
+ *
+ * // Later: cleanup
+ * unsubscribe();
+ * client.disconnect();
+ * ```
+ */
+export class NostrClient {
+    constructor(options = {}) {
+        this.pool = null;
+        this.secretKey = null;
+        this._publicKey = '';
+        this._isConnected = false;
+        this.relays = options.relays ?? DEFAULT_CONFIG.relays;
+        this.storageKeyPrefix = options.storageKeyPrefix ?? 'nostr-battle';
+        this.storage = options.storage ?? {
+            getItem: (key) => localStorage.getItem(key),
+            setItem: (key, value) => localStorage.setItem(key, value),
+        };
+        this.publishRetry = options.publishRetry ?? {
+            maxAttempts: 3,
+            initialDelay: 1000,
+            maxDelay: 5000,
+        };
+    }
+    /**
+     * Whether the client is connected to relays
+     */
+    get isConnected() {
+        return this._isConnected;
+    }
+    /**
+     * The public key of this client (Nostr identity)
+     */
+    get publicKey() {
+        return this._publicKey;
+    }
+    /**
+     * Get the connection status of each relay
+     * @returns Map of relay URL to connection status (true = connected)
+     */
+    getRelayStatus() {
+        if (!this.pool) {
+            return new Map();
+        }
+        return this.pool.listConnectionStatus();
+    }
+    /**
+     * Check if at least one relay is connected
+     */
+    get hasConnectedRelay() {
+        const status = this.getRelayStatus();
+        return Array.from(status.values()).some((connected) => connected);
+    }
+    /**
+     * Connect to Nostr relays
+     * Generates or retrieves a key pair from storage
+     */
+    connect() {
+        if (this._isConnected)
+            return;
+        // Generate or retrieve key pair
+        const storageKey = `${this.storageKeyPrefix}-key`;
+        try {
+            const storedKey = this.storage.getItem(storageKey);
+            if (storedKey) {
+                try {
+                    this.secretKey = new Uint8Array(JSON.parse(storedKey));
+                }
+                catch {
+                    // Invalid stored key, generate new one
+                    this.secretKey = generateSecretKey();
+                    this.safeStorageSet(storageKey, JSON.stringify(Array.from(this.secretKey)));
+                }
+            }
+            else {
+                this.secretKey = generateSecretKey();
+                this.safeStorageSet(storageKey, JSON.stringify(Array.from(this.secretKey)));
+            }
+        }
+        catch {
+            // Storage not available, generate ephemeral key
+            this.secretKey = generateSecretKey();
+        }
+        this._publicKey = getPublicKey(this.secretKey);
+        this.pool = new SimplePool();
+        this._isConnected = true;
+    }
+    /**
+     * Safely set storage item, ignoring quota errors
+     */
+    safeStorageSet(key, value) {
+        try {
+            this.storage.setItem(key, value);
+        }
+        catch {
+            // Ignore storage errors (quota exceeded, etc.)
+        }
+    }
+    /**
+     * Disconnect from all relays
+     */
+    disconnect() {
+        if (this.pool) {
+            this.pool.close(this.relays);
+            this.pool = null;
+        }
+        this._isConnected = false;
+    }
+    /**
+     * Publish an event to all relays with retry logic
+     *
+     * Retries with exponential backoff if all relays fail.
+     * Succeeds if at least one relay accepts the event.
+     */
+    async publish(eventTemplate) {
+        if (!this.pool || !this.secretKey) {
+            throw new Error('NostrClient not connected. Call connect() first.');
+        }
+        const event = finalizeEvent({
+            kind: eventTemplate.kind,
+            tags: eventTemplate.tags,
+            content: eventTemplate.content,
+            created_at: Math.floor(Date.now() / 1000),
+        }, this.secretKey);
+        await withRetry(() => Promise.any(this.pool.publish(this.relays, event)), this.publishRetry);
+    }
+    /**
+     * Subscribe to events matching the given filters
+     * @returns Unsubscribe function
+     */
+    subscribe(filters, onEvent) {
+        if (!this.pool) {
+            console.warn('NostrClient not connected. Call connect() first.');
+            return () => { };
+        }
+        try {
+            // nostr-tools types show Filter (singular) but implementation accepts Filter[]
+            const sub = this.pool.subscribeMany(this.relays, filters, {
+                onevent(event) {
+                    onEvent(event);
+                },
+            });
+            return () => {
+                sub.close();
+            };
+        }
+        catch (error) {
+            console.error('Failed to subscribe:', error);
+            return () => { };
+        }
+    }
+    /**
+     * Fetch events matching the given filter (one-time query)
+     */
+    async fetch(filter, timeoutMs = 5000) {
+        if (!this.pool) {
+            throw new Error('NostrClient not connected. Call connect() first.');
+        }
+        return new Promise((resolve, reject) => {
+            const events = [];
+            let resolved = false;
+            const finish = (success, error) => {
+                if (resolved)
+                    return;
+                resolved = true;
+                sub.close();
+                if (success) {
+                    resolve(events);
+                }
+                else {
+                    reject(error);
+                }
+            };
+            const sub = this.pool.subscribeManyEose(this.relays, filter, {
+                onevent: (event) => {
+                    events.push(event);
+                },
+                onclose: (reasons) => {
+                    // Check if at least one relay sent EOSE (successful response)
+                    const hasEose = reasons.some((r) => r === 'EOSE');
+                    if (hasEose) {
+                        // Valid response (may have 0 events, but relay responded)
+                        finish(true);
+                    }
+                    else {
+                        // All relays failed without sending EOSE
+                        finish(false, new Error('No relay response: ' + reasons.join(', ')));
+                    }
+                },
+            });
+            // Timeout fallback
+            setTimeout(() => {
+                finish(false, new Error('No relay response: timeout'));
+            }, timeoutMs);
+        });
+    }
+}
+//# sourceMappingURL=NostrClient.js.map

package/dist/core/NostrClient.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * nostr-battle-room - Core exports
+ * Framework-agnostic classes for Nostr battle rooms
+ */
+export { NostrClient } from './NostrClient';
+export type { NostrClientOptions } from './NostrClient';
+export { Arena } from './Arena';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,7 @@
+/**
+ * nostr-battle-room - Core exports
+ * Framework-agnostic classes for Nostr battle rooms
+ */
+export { NostrClient } from './NostrClient';
+export { Arena } from './Arena';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * nostr-battle-room
+ * Nostr-based real-time battle room for multiplayer games
+ *
+ * @example
+ * ```typescript
+ * // Using the core Arena class (framework-agnostic)
+ * import { Arena } from 'nostr-battle-room';
+ *
+ * const room = new Arena<MyGameState>({ gameId: 'my-game' });
+ * room.onOpponentState((state) => console.log(state));
+ * await room.create();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using the React hook
+ * import { useArena } from 'nostr-battle-room/react';
+ *
+ * function Game() {
+ *   const { roomState, opponent, createRoom } = useArena<MyGameState>({
+ *     gameId: 'my-game',
+ *   });
+ *   // ...
+ * }
+ * ```
+ */
+export { Arena } from './core/Arena';
+export { NostrClient } from './core/NostrClient';
+export type { NostrClientOptions, NostrFilter } from './core/NostrClient';
+export type { ArenaConfig, ArenaCallbacks, ArenaEventName, RoomState, RoomStatus, OpponentBase, OpponentState, NostrEvent, StoredRoomData, Unsubscribe, RoomEventContent, JoinEventContent, StateEventContent, GameOverEventContent, RematchEventContent, HeartbeatEventContent, BattleEventContent, } from './types';
+export { DEFAULT_CONFIG, INITIAL_ROOM_STATE, NOSTR_KINDS, createRoomTag, generateSeed, generateRoomId, } from './types';
+export { configureProxy, resetProxyConfiguration } from './proxy';
+export { withRetry, withTimeout, timeout, type RetryOptions } from './retry';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAG1E,YAAY,EACV,WAAW,EACX,cAAc,EACd,cAAc,EACd,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EACV,cAAc,EACd,WAAW,EAEX,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,YAAY,EACZ,cAAc,GACf,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAGlE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,37 @@
+/**
+ * nostr-battle-room
+ * Nostr-based real-time battle room for multiplayer games
+ *
+ * @example
+ * ```typescript
+ * // Using the core Arena class (framework-agnostic)
+ * import { Arena } from 'nostr-battle-room';
+ *
+ * const room = new Arena<MyGameState>({ gameId: 'my-game' });
+ * room.onOpponentState((state) => console.log(state));
+ * await room.create();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using the React hook
+ * import { useArena } from 'nostr-battle-room/react';
+ *
+ * function Game() {
+ *   const { roomState, opponent, createRoom } = useArena<MyGameState>({
+ *     gameId: 'my-game',
+ *   });
+ *   // ...
+ * }
+ * ```
+ */
+// Core exports
+export { Arena } from './core/Arena';
+export { NostrClient } from './core/NostrClient';
+// Constants and utilities
+export { DEFAULT_CONFIG, INITIAL_ROOM_STATE, NOSTR_KINDS, createRoomTag, generateSeed, generateRoomId, } from './types';
+// Proxy support (Node.js)
+export { configureProxy, resetProxyConfiguration } from './proxy';
+// Retry utilities
+export { withRetry, withTimeout, timeout } from './retry';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,eAAe;AACf,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAyBjD,0BAA0B;AAC1B,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,YAAY,EACZ,cAAc,GACf,MAAM,SAAS,CAAC;AAEjB,0BAA0B;AAC1B,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAElE,kBAAkB;AAClB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAqB,MAAM,SAAS,CAAC"}

package/dist/proxy.d.ts

@@ -0,0 +1,36 @@
+/**
+ * nostr-battle-room - Proxy Support
+ * Configure WebSocket to work through HTTP/HTTPS proxies
+ *
+ * Call configureProxy() before creating any Arena instances.
+ * Reads proxy URL from environment variables:
+ *   - HTTPS_PROXY
+ *   - HTTP_PROXY
+ *   - ALL_PROXY
+ *
+ * @example
+ * ```typescript
+ * import { configureProxy } from 'nostr-battle-room';
+ *
+ * // Call once at startup (Node.js only)
+ * configureProxy();
+ *
+ * // Now create rooms as usual
+ * const room = new Arena({ gameId: 'my-game' });
+ * ```
+ */
+/**
+ * Configure WebSocket to use proxy from environment variables.
+ * Must be called before connecting to any relays.
+ *
+ * In Node.js: Sets up proxy-aware WebSocket if HTTPS_PROXY/HTTP_PROXY is set
+ * In browser: No-op (browsers handle proxies at OS/network level)
+ *
+ * @returns true if proxy was configured, false otherwise
+ */
+export declare function configureProxy(): boolean;
+/**
+ * Reset proxy configuration (mainly for testing)
+ */
+export declare function resetProxyConfiguration(): void;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAyBH;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAmDxC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/dist/proxy.js

@@ -0,0 +1,98 @@
+/**
+ * nostr-battle-room - Proxy Support
+ * Configure WebSocket to work through HTTP/HTTPS proxies
+ *
+ * Call configureProxy() before creating any Arena instances.
+ * Reads proxy URL from environment variables:
+ *   - HTTPS_PROXY
+ *   - HTTP_PROXY
+ *   - ALL_PROXY
+ *
+ * @example
+ * ```typescript
+ * import { configureProxy } from 'nostr-battle-room';
+ *
+ * // Call once at startup (Node.js only)
+ * configureProxy();
+ *
+ * // Now create rooms as usual
+ * const room = new Arena({ gameId: 'my-game' });
+ * ```
+ */
+import { useWebSocketImplementation } from 'nostr-tools/pool';
+let proxyConfigured = false;
+/**
+ * Get proxy URL from environment variables
+ */
+function getProxyUrl() {
+    if (typeof process === 'undefined' || !process.env) {
+        return undefined;
+    }
+    return process.env.HTTPS_PROXY || process.env.HTTP_PROXY || process.env.ALL_PROXY;
+}
+/**
+ * Check if running in Node.js environment
+ */
+function isNode() {
+    return (typeof process !== 'undefined' && process.versions != null && process.versions.node != null);
+}
+/**
+ * Configure WebSocket to use proxy from environment variables.
+ * Must be called before connecting to any relays.
+ *
+ * In Node.js: Sets up proxy-aware WebSocket if HTTPS_PROXY/HTTP_PROXY is set
+ * In browser: No-op (browsers handle proxies at OS/network level)
+ *
+ * @returns true if proxy was configured, false otherwise
+ */
+export function configureProxy() {
+    if (proxyConfigured) {
+        return false;
+    }
+    if (!isNode()) {
+        // Browser environment - no action needed
+        proxyConfigured = true;
+        return false;
+    }
+    const proxyUrl = getProxyUrl();
+    // Always configure ws for Node.js, even without proxy
+    // This ensures WebSocket works in Node.js environment
+    try {
+        // Dynamic import to avoid bundling issues in browser
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const WebSocket = require('ws');
+        if (proxyUrl) {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const { HttpsProxyAgent } = require('https-proxy-agent');
+            const agent = new HttpsProxyAgent(proxyUrl);
+            // Create a WebSocket class that uses the proxy agent
+            class ProxyWebSocket extends WebSocket {
+                constructor(url, protocols) {
+                    super(url, protocols, { agent });
+                }
+            }
+            useWebSocketImplementation(ProxyWebSocket);
+            proxyConfigured = true;
+            return true;
+        }
+        else {
+            // No proxy, but still need ws for Node.js
+            useWebSocketImplementation(WebSocket);
+            proxyConfigured = true;
+            return false;
+        }
+    }
+    catch {
+        // ws or https-proxy-agent not installed
+        console.warn('nostr-battle-room: Could not configure WebSocket for Node.js.', 'Install "ws" package for Node.js support.', proxyUrl ? 'Install "https-proxy-agent" for proxy support.' : '');
+        proxyConfigured = true;
+        return false;
+    }
+}
+/**
+ * Reset proxy configuration (mainly for testing)
+ */
+export function resetProxyConfiguration() {
+    proxyConfigured = false;
+}
+//# sourceMappingURL=proxy.js.map

package/dist/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAE9D,IAAI,eAAe,GAAG,KAAK,CAAC;AAE5B;;GAEG;AACH,SAAS,WAAW;IAClB,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QACnD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;AACpF,CAAC;AAED;;GAEG;AACH,SAAS,MAAM;IACb,OAAO,CACL,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,QAAQ,IAAI,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAC5F,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QACd,yCAAyC;QACzC,eAAe,GAAG,IAAI,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAE/B,sDAAsD;IACtD,sDAAsD;IACtD,IAAI,CAAC;QACH,qDAAqD;QACrD,iEAAiE;QACjE,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAEhC,IAAI,QAAQ,EAAE,CAAC;YACb,iEAAiE;YACjE,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;YACzD,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,QAAQ,CAAC,CAAC;YAE5C,qDAAqD;YACrD,MAAM,cAAe,SAAQ,SAAS;gBACpC,YAAY,GAAW,EAAE,SAA6B;oBACpD,KAAK,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;gBACnC,CAAC;aACF;YAED,0BAA0B,CAAC,cAAc,CAAC,CAAC;YAC3C,eAAe,GAAG,IAAI,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;aAAM,CAAC;YACN,0CAA0C;YAC1C,0BAA0B,CAAC,SAAS,CAAC,CAAC;YACtC,eAAe,GAAG,IAAI,CAAC;YACvB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,wCAAwC;QACxC,OAAO,CAAC,IAAI,CACV,+DAA+D,EAC/D,2CAA2C,EAC3C,QAAQ,CAAC,CAAC,CAAC,gDAAgD,CAAC,CAAC,CAAC,EAAE,CACjE,CAAC;QACF,eAAe,GAAG,IAAI,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,eAAe,GAAG,KAAK,CAAC;AAC1B,CAAC"}

package/dist/react/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * nostr-battle-room - React exports
+ * React hooks for Nostr battle rooms
+ */
+export { useArena } from './useArena';
+export type { UseArenaReturn, OpponentState } from './useArena';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,6 @@
+/**
+ * nostr-battle-room - React exports
+ * React hooks for Nostr battle rooms
+ */
+export { useArena } from './useArena';
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}