gennet.js 0.2.0 → 0.2.2

package/README.md

@@ -15,6 +15,8 @@ Client library for [GenNet](https://github.com/cryptagoEU/gennet.js) — interac
 - WebSocket & HTTP providers
 - Full TypeScript support (ESM + CJS)
 - Subscriptions (logs, messages, mempool)
+- Auto-reconnect with exponential backoff
+- Connection events (connect, disconnect, error)
 
 ## Installation
 
@@ -53,12 +55,20 @@ const gennet = new GenNet('ws://localhost:18789');
 const gennet = new GenNet('http://localhost:18790');
 ```
 
-You can also pass a custom provider:
+You can also pass a custom provider with options:
 
 ```typescript
 import { GenNet, WebSocketProvider } from 'gennet.js';
 
-const provider = new WebSocketProvider('ws://localhost:18789');
+const provider = new WebSocketProvider('ws://localhost:18789', {
+  timeout: 10_000,
+  reconnect: {
+    enabled: true,      // default: true
+    maxRetries: 10,     // default: 5
+    delay: 2000,        // default: 1000ms (doubles each attempt)
+    maxDelay: 60_000,   // default: 30000ms
+  },
+});
 const gennet = new GenNet(provider);
 ```
 
@@ -123,6 +133,26 @@ For methods not covered by the namespaces:
 const result = await gennet.request('custom_method', { key: 'value' });
 ```
 
+## Events
+
+The WebSocket provider emits connection lifecycle events:
+
+```typescript
+gennet.on('connect', () => {
+  console.log('Connected to GenNet node');
+});
+
+gennet.on('disconnect', () => {
+  console.log('Disconnected — reconnecting...');
+});
+
+gennet.on('error', (err) => {
+  console.error('Connection error:', err.message);
+});
+```
+
+Auto-reconnect is enabled by default. After a disconnect, the provider reconnects with exponential backoff. Call `gennet.disconnect()` to stop reconnecting.
+
 ## Error Handling
 
 RPC errors throw a typed `RpcError`:

package/dist/index.d.cts

@@ -39,6 +39,13 @@ interface ModuleInfo {
     state: string;
     status?: string;
 }
+interface TransportInfo {
+    enabled: boolean;
+    host?: string;
+    port?: number;
+    api: string[];
+    origins?: string[];
+}
 interface NodeInfo {
     state: GatewayState;
     peerId: string | null;
@@ -53,6 +60,9 @@ interface NodeInfo {
     listenPort: number;
     datadir: string;
     modules: ModuleInfo[];
+    ws: TransportInfo;
+    http: TransportInfo;
+    ipc: boolean;
 }
 interface PeerInfo {
     peerId: string;
@@ -287,4 +297,4 @@ declare class HttpProvider implements Provider {
 }
 
 export { Admin, Agent, GenNet, HttpProvider, Mempool, Net, Personal, RpcError, WebSocketProvider };
-export type { AgentResult, GatewayState, IdentityInfo, JsonRpcErrorResponse, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccessResponse, ModuleInfo, NodeInfo, PeerInfo, Provider, ProviderEvent, ProviderEventListener, ReconnectOptions, Subscription, SubscriptionTopic };
+export type { AgentResult, GatewayState, IdentityInfo, JsonRpcErrorResponse, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccessResponse, ModuleInfo, NodeInfo, PeerInfo, Provider, ProviderEvent, ProviderEventListener, ReconnectOptions, Subscription, SubscriptionTopic, TransportInfo };

package/dist/index.d.mts

@@ -39,6 +39,13 @@ interface ModuleInfo {
     state: string;
     status?: string;
 }
+interface TransportInfo {
+    enabled: boolean;
+    host?: string;
+    port?: number;
+    api: string[];
+    origins?: string[];
+}
 interface NodeInfo {
     state: GatewayState;
     peerId: string | null;
@@ -53,6 +60,9 @@ interface NodeInfo {
     listenPort: number;
     datadir: string;
     modules: ModuleInfo[];
+    ws: TransportInfo;
+    http: TransportInfo;
+    ipc: boolean;
 }
 interface PeerInfo {
     peerId: string;
@@ -287,4 +297,4 @@ declare class HttpProvider implements Provider {
 }
 
 export { Admin, Agent, GenNet, HttpProvider, Mempool, Net, Personal, RpcError, WebSocketProvider };
-export type { AgentResult, GatewayState, IdentityInfo, JsonRpcErrorResponse, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccessResponse, ModuleInfo, NodeInfo, PeerInfo, Provider, ProviderEvent, ProviderEventListener, ReconnectOptions, Subscription, SubscriptionTopic };
+export type { AgentResult, GatewayState, IdentityInfo, JsonRpcErrorResponse, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccessResponse, ModuleInfo, NodeInfo, PeerInfo, Provider, ProviderEvent, ProviderEventListener, ReconnectOptions, Subscription, SubscriptionTopic, TransportInfo };

package/dist/index.d.ts

@@ -39,6 +39,13 @@ interface ModuleInfo {
     state: string;
     status?: string;
 }
+interface TransportInfo {
+    enabled: boolean;
+    host?: string;
+    port?: number;
+    api: string[];
+    origins?: string[];
+}
 interface NodeInfo {
     state: GatewayState;
     peerId: string | null;
@@ -53,6 +60,9 @@ interface NodeInfo {
     listenPort: number;
     datadir: string;
     modules: ModuleInfo[];
+    ws: TransportInfo;
+    http: TransportInfo;
+    ipc: boolean;
 }
 interface PeerInfo {
     peerId: string;
@@ -287,4 +297,4 @@ declare class HttpProvider implements Provider {
 }
 
 export { Admin, Agent, GenNet, HttpProvider, Mempool, Net, Personal, RpcError, WebSocketProvider };
-export type { AgentResult, GatewayState, IdentityInfo, JsonRpcErrorResponse, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccessResponse, ModuleInfo, NodeInfo, PeerInfo, Provider, ProviderEvent, ProviderEventListener, ReconnectOptions, Subscription, SubscriptionTopic };
+export type { AgentResult, GatewayState, IdentityInfo, JsonRpcErrorResponse, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccessResponse, ModuleInfo, NodeInfo, PeerInfo, Provider, ProviderEvent, ProviderEventListener, ReconnectOptions, Subscription, SubscriptionTopic, TransportInfo };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gennet.js",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Client Library for GenNet — interact with GenNet nodes via JSON-RPC",
   "type": "module",
   "sideEffects": false,