gennet.js 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cryptagoEU
+
+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

@@ -1,5 +1,13 @@
 # gennet.js
 
+[![npm version](https://img.shields.io/npm/v/gennet.js)](https://www.npmjs.com/package/gennet.js)
+[![npm downloads](https://img.shields.io/npm/dm/gennet.js)](https://www.npmjs.com/package/gennet.js)
+[![CI](https://img.shields.io/github/actions/workflow/status/cryptagoEU/gennet.js/ci.yml?label=CI)](https://github.com/cryptagoEU/gennet.js/actions/workflows/ci.yml)
+[![license](https://img.shields.io/npm/l/gennet.js)](https://github.com/cryptagoEU/gennet.js/blob/main/LICENSE)
+
+[![ES Version](https://img.shields.io/badge/ES-2022-yellow)](https://github.com/cryptagoEU/gennet.js)
+[![Node Version](https://img.shields.io/badge/node-≥22-green)](https://github.com/cryptagoEU/gennet.js)
+
 Client library for [GenNet](https://github.com/cryptagoEU/gennet.js) — interact with GenNet nodes via JSON-RPC.
 
 - Zero runtime dependencies

package/dist/index.cjs

@@ -38,7 +38,7 @@ class HttpProvider {
     }
     return json.result;
   }
-  // HTTP unterstützt keine Push-Notifications
+  // HTTP unterstützt keine Events
   on(_event, _listener) {
   }
   off(_event, _listener) {
@@ -48,17 +48,32 @@ class HttpProvider {
 }
 
 const DEFAULT_TIMEOUT = 3e4;
+const DEFAULT_RECONNECT = {
+  enabled: true,
+  maxRetries: 5,
+  delay: 1e3,
+  maxDelay: 3e4
+};
 class WebSocketProvider {
   url;
   timeout;
+  reconnectOpts;
   ws = null;
   requestId = 0;
+  reconnectAttempts = 0;
+  reconnectTimer = null;
+  manualDisconnect = false;
   pending = /* @__PURE__ */ new Map();
-  listeners = /* @__PURE__ */ new Set();
+  // Typisierte Event-Listener
+  notificationListeners = /* @__PURE__ */ new Set();
+  connectListeners = /* @__PURE__ */ new Set();
+  disconnectListeners = /* @__PURE__ */ new Set();
+  errorListeners = /* @__PURE__ */ new Set();
   connectPromise = null;
-  constructor(url, timeout = DEFAULT_TIMEOUT) {
+  constructor(url, options) {
     this.url = url;
-    this.timeout = timeout;
+    this.timeout = options?.timeout ?? DEFAULT_TIMEOUT;
+    this.reconnectOpts = { ...DEFAULT_RECONNECT, ...options?.reconnect };
   }
   get connected() {
     return this.ws !== null && this.ws.readyState === WebSocket.OPEN;
@@ -66,26 +81,36 @@ class WebSocketProvider {
   async connect() {
     if (this.connected) return;
     if (this.connectPromise) return this.connectPromise;
+    this.manualDisconnect = false;
     this.connectPromise = new Promise((resolve, reject) => {
       this.ws = new WebSocket(this.url);
       this.ws.onopen = () => {
         this.connectPromise = null;
+        this.reconnectAttempts = 0;
+        this.emit("connect");
         resolve();
       };
       this.ws.onerror = (ev) => {
         this.connectPromise = null;
-        reject(new Error(`WebSocket-Verbindung fehlgeschlagen: ${this.url} (${ev})`));
+        const error = new Error(`WebSocket-Verbindung fehlgeschlagen: ${this.url} (${ev})`);
+        this.emit("error", error);
+        reject(error);
       };
       this.ws.onmessage = (ev) => {
         this.handleMessage(typeof ev.data === "string" ? ev.data : String(ev.data));
       };
       this.ws.onclose = () => {
         this.connectPromise = null;
+        this.ws = null;
         for (const [id, req] of this.pending) {
           clearTimeout(req.timer);
           req.reject(new Error("WebSocket-Verbindung geschlossen"));
           this.pending.delete(id);
         }
+        this.emit("disconnect");
+        if (!this.manualDisconnect && this.reconnectOpts.enabled) {
+          this.scheduleReconnect();
+        }
       };
     });
     return this.connectPromise;
@@ -105,19 +130,71 @@ class WebSocketProvider {
       this.ws.send(payload);
     });
   }
-  on(_event, listener) {
-    this.listeners.add(listener);
+  on(event, listener) {
+    this.getListenerSet(event).add(listener);
   }
-  off(_event, listener) {
-    this.listeners.delete(listener);
+  off(event, listener) {
+    this.getListenerSet(event).delete(listener);
   }
   disconnect() {
+    this.manualDisconnect = true;
+    if (this.reconnectTimer) {
+      clearTimeout(this.reconnectTimer);
+      this.reconnectTimer = null;
+    }
     if (this.ws) {
       this.ws.close();
       this.ws = null;
     }
   }
   // ── Private ────────────────────────────────────────────────
+  scheduleReconnect() {
+    if (this.reconnectAttempts >= this.reconnectOpts.maxRetries) {
+      this.emit("error", new Error(
+        `Reconnect fehlgeschlagen nach ${this.reconnectOpts.maxRetries} Versuchen`
+      ));
+      return;
+    }
+    const delay = Math.min(
+      this.reconnectOpts.delay * Math.pow(2, this.reconnectAttempts),
+      this.reconnectOpts.maxDelay
+    );
+    this.reconnectAttempts++;
+    this.reconnectTimer = setTimeout(() => {
+      this.reconnectTimer = null;
+      this.connect().catch((err) => {
+        this.emit("error", err instanceof Error ? err : new Error(String(err)));
+      });
+    }, delay);
+  }
+  emit(event, data) {
+    switch (event) {
+      case "connect":
+        for (const l of this.connectListeners) l();
+        break;
+      case "disconnect":
+        for (const l of this.disconnectListeners) l();
+        break;
+      case "error":
+        for (const l of this.errorListeners) l(data);
+        break;
+      case "notification":
+        for (const l of this.notificationListeners) l(data);
+        break;
+    }
+  }
+  getListenerSet(event) {
+    switch (event) {
+      case "notification":
+        return this.notificationListeners;
+      case "connect":
+        return this.connectListeners;
+      case "disconnect":
+        return this.disconnectListeners;
+      case "error":
+        return this.errorListeners;
+    }
+  }
   handleMessage(raw) {
     let msg;
     try {
@@ -141,10 +218,7 @@ class WebSocketProvider {
       return;
     }
     if ("method" in msg && "params" in msg) {
-      const notification = msg;
-      for (const listener of this.listeners) {
-        listener(notification);
-      }
+      this.emit("notification", msg);
     }
   }
 }
@@ -284,6 +358,14 @@ class GenNet {
       }
     };
   }
+  /** Event-Listener registrieren (connect, disconnect, error). */
+  on(event, listener) {
+    this.provider.on(event, listener);
+  }
+  /** Event-Listener entfernen. */
+  off(event, listener) {
+    this.provider.off(event, listener);
+  }
   /** Raw JSON-RPC Request (für erweiterte Nutzung). */
   async request(method, params) {
     return this.provider.request(method, params);

package/dist/index.d.cts

@@ -82,13 +82,15 @@ interface Subscription {
     id: string;
     unsubscribe: () => Promise<boolean>;
 }
+type ProviderEvent = 'notification' | 'connect' | 'disconnect' | 'error';
+type ProviderEventListener<E extends ProviderEvent> = E extends 'notification' ? (notification: JsonRpcNotification) => void : E extends 'connect' ? () => void : E extends 'disconnect' ? () => void : E extends 'error' ? (error: Error) => void : never;
 interface Provider {
     /** JSON-RPC Request senden und auf Response warten. */
     request(method: string, params?: Record<string, unknown> | unknown[]): Promise<unknown>;
-    /** Listener für Push-Notifications (Subscriptions). */
-    on(event: 'notification', listener: (notification: JsonRpcNotification) => void): void;
-    /** Listener entfernen. */
-    off(event: 'notification', listener: (notification: JsonRpcNotification) => void): void;
+    /** Event-Listener registrieren. */
+    on<E extends ProviderEvent>(event: E, listener: ProviderEventListener<E>): void;
+    /** Event-Listener entfernen. */
+    off<E extends ProviderEvent>(event: E, listener: ProviderEventListener<E>): void;
     /** Verbindung schließen. */
     disconnect(): void;
     /** Verbindung herstellen (bei WebSocket). */
@@ -96,6 +98,16 @@ interface Provider {
     /** Ob eine aktive Verbindung besteht. */
     readonly connected: boolean;
 }
+interface ReconnectOptions {
+    /** Auto-Reconnect aktivieren. Default: true */
+    enabled?: boolean;
+    /** Maximale Anzahl Reconnect-Versuche. Default: 5 */
+    maxRetries?: number;
+    /** Initiale Wartezeit in ms (verdoppelt sich pro Versuch). Default: 1000 */
+    delay?: number;
+    /** Maximale Wartezeit in ms. Default: 30000 */
+    maxDelay?: number;
+}
 
 /** admin Namespace — Node-Administration. */
 declare class Admin {
@@ -216,6 +228,10 @@ declare class GenNet {
      * Topics: 'logs', 'messages', 'mempool'.
      */
     subscribe(topic: SubscriptionTopic, callback: (data: unknown) => void): Promise<Subscription>;
+    /** Event-Listener registrieren (connect, disconnect, error). */
+    on<E extends ProviderEvent>(event: E, listener: ProviderEventListener<E>): void;
+    /** Event-Listener entfernen. */
+    off<E extends ProviderEvent>(event: E, listener: ProviderEventListener<E>): void;
     /** Raw JSON-RPC Request (für erweiterte Nutzung). */
     request(method: string, params?: Record<string, unknown> | unknown[]): Promise<unknown>;
     private static createProvider;
@@ -223,23 +239,36 @@ declare class GenNet {
 
 /**
  * WebSocket Provider — nutzt native WebSocket API (Browser + Node 22+).
- * Unterstützt Subscriptions via Push-Notifications.
+ * Unterstützt Subscriptions via Push-Notifications und Auto-Reconnect.
  */
 declare class WebSocketProvider implements Provider {
     private readonly url;
     private readonly timeout;
+    private readonly reconnectOpts;
     private ws;
     private requestId;
+    private reconnectAttempts;
+    private reconnectTimer;
+    private manualDisconnect;
     private pending;
-    private listeners;
+    private notificationListeners;
+    private connectListeners;
+    private disconnectListeners;
+    private errorListeners;
     private connectPromise;
-    constructor(url: string, timeout?: number);
+    constructor(url: string, options?: {
+        timeout?: number;
+        reconnect?: ReconnectOptions;
+    });
     get connected(): boolean;
     connect(): Promise<void>;
     request(method: string, params?: Record<string, unknown> | unknown[]): Promise<unknown>;
-    on(_event: 'notification', listener: (notification: JsonRpcNotification) => void): void;
-    off(_event: 'notification', listener: (notification: JsonRpcNotification) => void): void;
+    on<E extends ProviderEvent>(event: E, listener: ProviderEventListener<E>): void;
+    off<E extends ProviderEvent>(event: E, listener: ProviderEventListener<E>): void;
     disconnect(): void;
+    private scheduleReconnect;
+    private emit;
+    private getListenerSet;
     private handleMessage;
 }
 
@@ -252,10 +281,10 @@ declare class HttpProvider implements Provider {
     constructor(url: string);
     get connected(): boolean;
     request(method: string, params?: Record<string, unknown> | unknown[]): Promise<unknown>;
-    on(_event: 'notification', _listener: (notification: JsonRpcNotification) => void): void;
-    off(_event: 'notification', _listener: (notification: JsonRpcNotification) => void): void;
+    on<E extends ProviderEvent>(_event: E, _listener: ProviderEventListener<E>): void;
+    off<E extends ProviderEvent>(_event: E, _listener: ProviderEventListener<E>): void;
     disconnect(): void;
 }
 
 export { Admin, Agent, GenNet, HttpProvider, Mempool, Net, Personal, RpcError, WebSocketProvider };
-export type { AgentResult, GatewayState, IdentityInfo, JsonRpcErrorResponse, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccessResponse, ModuleInfo, NodeInfo, PeerInfo, Provider, Subscription, SubscriptionTopic };
+export type { AgentResult, GatewayState, IdentityInfo, JsonRpcErrorResponse, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccessResponse, ModuleInfo, NodeInfo, PeerInfo, Provider, ProviderEvent, ProviderEventListener, ReconnectOptions, Subscription, SubscriptionTopic };

package/dist/index.d.mts

@@ -82,13 +82,15 @@ interface Subscription {
     id: string;
     unsubscribe: () => Promise<boolean>;
 }
+type ProviderEvent = 'notification' | 'connect' | 'disconnect' | 'error';
+type ProviderEventListener<E extends ProviderEvent> = E extends 'notification' ? (notification: JsonRpcNotification) => void : E extends 'connect' ? () => void : E extends 'disconnect' ? () => void : E extends 'error' ? (error: Error) => void : never;
 interface Provider {
     /** JSON-RPC Request senden und auf Response warten. */
     request(method: string, params?: Record<string, unknown> | unknown[]): Promise<unknown>;
-    /** Listener für Push-Notifications (Subscriptions). */
-    on(event: 'notification', listener: (notification: JsonRpcNotification) => void): void;
-    /** Listener entfernen. */
-    off(event: 'notification', listener: (notification: JsonRpcNotification) => void): void;
+    /** Event-Listener registrieren. */
+    on<E extends ProviderEvent>(event: E, listener: ProviderEventListener<E>): void;
+    /** Event-Listener entfernen. */
+    off<E extends ProviderEvent>(event: E, listener: ProviderEventListener<E>): void;
     /** Verbindung schließen. */
     disconnect(): void;
     /** Verbindung herstellen (bei WebSocket). */
@@ -96,6 +98,16 @@ interface Provider {
     /** Ob eine aktive Verbindung besteht. */
     readonly connected: boolean;
 }
+interface ReconnectOptions {
+    /** Auto-Reconnect aktivieren. Default: true */
+    enabled?: boolean;
+    /** Maximale Anzahl Reconnect-Versuche. Default: 5 */
+    maxRetries?: number;
+    /** Initiale Wartezeit in ms (verdoppelt sich pro Versuch). Default: 1000 */
+    delay?: number;
+    /** Maximale Wartezeit in ms. Default: 30000 */
+    maxDelay?: number;
+}
 
 /** admin Namespace — Node-Administration. */
 declare class Admin {
@@ -216,6 +228,10 @@ declare class GenNet {
      * Topics: 'logs', 'messages', 'mempool'.
      */
     subscribe(topic: SubscriptionTopic, callback: (data: unknown) => void): Promise<Subscription>;
+    /** Event-Listener registrieren (connect, disconnect, error). */
+    on<E extends ProviderEvent>(event: E, listener: ProviderEventListener<E>): void;
+    /** Event-Listener entfernen. */
+    off<E extends ProviderEvent>(event: E, listener: ProviderEventListener<E>): void;
     /** Raw JSON-RPC Request (für erweiterte Nutzung). */
     request(method: string, params?: Record<string, unknown> | unknown[]): Promise<unknown>;
     private static createProvider;
@@ -223,23 +239,36 @@ declare class GenNet {
 
 /**
  * WebSocket Provider — nutzt native WebSocket API (Browser + Node 22+).
- * Unterstützt Subscriptions via Push-Notifications.
+ * Unterstützt Subscriptions via Push-Notifications und Auto-Reconnect.
  */
 declare class WebSocketProvider implements Provider {
     private readonly url;
     private readonly timeout;
+    private readonly reconnectOpts;
     private ws;
     private requestId;
+    private reconnectAttempts;
+    private reconnectTimer;
+    private manualDisconnect;
     private pending;
-    private listeners;
+    private notificationListeners;
+    private connectListeners;
+    private disconnectListeners;
+    private errorListeners;
     private connectPromise;
-    constructor(url: string, timeout?: number);
+    constructor(url: string, options?: {
+        timeout?: number;
+        reconnect?: ReconnectOptions;
+    });
     get connected(): boolean;
     connect(): Promise<void>;
     request(method: string, params?: Record<string, unknown> | unknown[]): Promise<unknown>;
-    on(_event: 'notification', listener: (notification: JsonRpcNotification) => void): void;
-    off(_event: 'notification', listener: (notification: JsonRpcNotification) => void): void;
+    on<E extends ProviderEvent>(event: E, listener: ProviderEventListener<E>): void;
+    off<E extends ProviderEvent>(event: E, listener: ProviderEventListener<E>): void;
     disconnect(): void;
+    private scheduleReconnect;
+    private emit;
+    private getListenerSet;
     private handleMessage;
 }
 
@@ -252,10 +281,10 @@ declare class HttpProvider implements Provider {
     constructor(url: string);
     get connected(): boolean;
     request(method: string, params?: Record<string, unknown> | unknown[]): Promise<unknown>;
-    on(_event: 'notification', _listener: (notification: JsonRpcNotification) => void): void;
-    off(_event: 'notification', _listener: (notification: JsonRpcNotification) => void): void;
+    on<E extends ProviderEvent>(_event: E, _listener: ProviderEventListener<E>): void;
+    off<E extends ProviderEvent>(_event: E, _listener: ProviderEventListener<E>): void;
     disconnect(): void;
 }
 
 export { Admin, Agent, GenNet, HttpProvider, Mempool, Net, Personal, RpcError, WebSocketProvider };
-export type { AgentResult, GatewayState, IdentityInfo, JsonRpcErrorResponse, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccessResponse, ModuleInfo, NodeInfo, PeerInfo, Provider, Subscription, SubscriptionTopic };
+export type { AgentResult, GatewayState, IdentityInfo, JsonRpcErrorResponse, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccessResponse, ModuleInfo, NodeInfo, PeerInfo, Provider, ProviderEvent, ProviderEventListener, ReconnectOptions, Subscription, SubscriptionTopic };

package/dist/index.d.ts

@@ -82,13 +82,15 @@ interface Subscription {
     id: string;
     unsubscribe: () => Promise<boolean>;
 }
+type ProviderEvent = 'notification' | 'connect' | 'disconnect' | 'error';
+type ProviderEventListener<E extends ProviderEvent> = E extends 'notification' ? (notification: JsonRpcNotification) => void : E extends 'connect' ? () => void : E extends 'disconnect' ? () => void : E extends 'error' ? (error: Error) => void : never;
 interface Provider {
     /** JSON-RPC Request senden und auf Response warten. */
     request(method: string, params?: Record<string, unknown> | unknown[]): Promise<unknown>;
-    /** Listener für Push-Notifications (Subscriptions). */
-    on(event: 'notification', listener: (notification: JsonRpcNotification) => void): void;
-    /** Listener entfernen. */
-    off(event: 'notification', listener: (notification: JsonRpcNotification) => void): void;
+    /** Event-Listener registrieren. */
+    on<E extends ProviderEvent>(event: E, listener: ProviderEventListener<E>): void;
+    /** Event-Listener entfernen. */
+    off<E extends ProviderEvent>(event: E, listener: ProviderEventListener<E>): void;
     /** Verbindung schließen. */
     disconnect(): void;
     /** Verbindung herstellen (bei WebSocket). */
@@ -96,6 +98,16 @@ interface Provider {
     /** Ob eine aktive Verbindung besteht. */
     readonly connected: boolean;
 }
+interface ReconnectOptions {
+    /** Auto-Reconnect aktivieren. Default: true */
+    enabled?: boolean;
+    /** Maximale Anzahl Reconnect-Versuche. Default: 5 */
+    maxRetries?: number;
+    /** Initiale Wartezeit in ms (verdoppelt sich pro Versuch). Default: 1000 */
+    delay?: number;
+    /** Maximale Wartezeit in ms. Default: 30000 */
+    maxDelay?: number;
+}
 
 /** admin Namespace — Node-Administration. */
 declare class Admin {
@@ -216,6 +228,10 @@ declare class GenNet {
      * Topics: 'logs', 'messages', 'mempool'.
      */
     subscribe(topic: SubscriptionTopic, callback: (data: unknown) => void): Promise<Subscription>;
+    /** Event-Listener registrieren (connect, disconnect, error). */
+    on<E extends ProviderEvent>(event: E, listener: ProviderEventListener<E>): void;
+    /** Event-Listener entfernen. */
+    off<E extends ProviderEvent>(event: E, listener: ProviderEventListener<E>): void;
     /** Raw JSON-RPC Request (für erweiterte Nutzung). */
     request(method: string, params?: Record<string, unknown> | unknown[]): Promise<unknown>;
     private static createProvider;
@@ -223,23 +239,36 @@ declare class GenNet {
 
 /**
  * WebSocket Provider — nutzt native WebSocket API (Browser + Node 22+).
- * Unterstützt Subscriptions via Push-Notifications.
+ * Unterstützt Subscriptions via Push-Notifications und Auto-Reconnect.
  */
 declare class WebSocketProvider implements Provider {
     private readonly url;
     private readonly timeout;
+    private readonly reconnectOpts;
     private ws;
     private requestId;
+    private reconnectAttempts;
+    private reconnectTimer;
+    private manualDisconnect;
     private pending;
-    private listeners;
+    private notificationListeners;
+    private connectListeners;
+    private disconnectListeners;
+    private errorListeners;
     private connectPromise;
-    constructor(url: string, timeout?: number);
+    constructor(url: string, options?: {
+        timeout?: number;
+        reconnect?: ReconnectOptions;
+    });
     get connected(): boolean;
     connect(): Promise<void>;
     request(method: string, params?: Record<string, unknown> | unknown[]): Promise<unknown>;
-    on(_event: 'notification', listener: (notification: JsonRpcNotification) => void): void;
-    off(_event: 'notification', listener: (notification: JsonRpcNotification) => void): void;
+    on<E extends ProviderEvent>(event: E, listener: ProviderEventListener<E>): void;
+    off<E extends ProviderEvent>(event: E, listener: ProviderEventListener<E>): void;
     disconnect(): void;
+    private scheduleReconnect;
+    private emit;
+    private getListenerSet;
     private handleMessage;
 }
 
@@ -252,10 +281,10 @@ declare class HttpProvider implements Provider {
     constructor(url: string);
     get connected(): boolean;
     request(method: string, params?: Record<string, unknown> | unknown[]): Promise<unknown>;
-    on(_event: 'notification', _listener: (notification: JsonRpcNotification) => void): void;
-    off(_event: 'notification', _listener: (notification: JsonRpcNotification) => void): void;
+    on<E extends ProviderEvent>(_event: E, _listener: ProviderEventListener<E>): void;
+    off<E extends ProviderEvent>(_event: E, _listener: ProviderEventListener<E>): void;
     disconnect(): void;
 }
 
 export { Admin, Agent, GenNet, HttpProvider, Mempool, Net, Personal, RpcError, WebSocketProvider };
-export type { AgentResult, GatewayState, IdentityInfo, JsonRpcErrorResponse, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccessResponse, ModuleInfo, NodeInfo, PeerInfo, Provider, Subscription, SubscriptionTopic };
+export type { AgentResult, GatewayState, IdentityInfo, JsonRpcErrorResponse, JsonRpcNotification, JsonRpcRequest, JsonRpcResponse, JsonRpcSuccessResponse, ModuleInfo, NodeInfo, PeerInfo, Provider, ProviderEvent, ProviderEventListener, ReconnectOptions, Subscription, SubscriptionTopic };

package/dist/index.mjs

@@ -36,7 +36,7 @@ class HttpProvider {
     }
     return json.result;
   }
-  // HTTP unterstützt keine Push-Notifications
+  // HTTP unterstützt keine Events
   on(_event, _listener) {
   }
   off(_event, _listener) {
@@ -46,17 +46,32 @@ class HttpProvider {
 }
 
 const DEFAULT_TIMEOUT = 3e4;
+const DEFAULT_RECONNECT = {
+  enabled: true,
+  maxRetries: 5,
+  delay: 1e3,
+  maxDelay: 3e4
+};
 class WebSocketProvider {
   url;
   timeout;
+  reconnectOpts;
   ws = null;
   requestId = 0;
+  reconnectAttempts = 0;
+  reconnectTimer = null;
+  manualDisconnect = false;
   pending = /* @__PURE__ */ new Map();
-  listeners = /* @__PURE__ */ new Set();
+  // Typisierte Event-Listener
+  notificationListeners = /* @__PURE__ */ new Set();
+  connectListeners = /* @__PURE__ */ new Set();
+  disconnectListeners = /* @__PURE__ */ new Set();
+  errorListeners = /* @__PURE__ */ new Set();
   connectPromise = null;
-  constructor(url, timeout = DEFAULT_TIMEOUT) {
+  constructor(url, options) {
     this.url = url;
-    this.timeout = timeout;
+    this.timeout = options?.timeout ?? DEFAULT_TIMEOUT;
+    this.reconnectOpts = { ...DEFAULT_RECONNECT, ...options?.reconnect };
   }
   get connected() {
     return this.ws !== null && this.ws.readyState === WebSocket.OPEN;
@@ -64,26 +79,36 @@ class WebSocketProvider {
   async connect() {
     if (this.connected) return;
     if (this.connectPromise) return this.connectPromise;
+    this.manualDisconnect = false;
     this.connectPromise = new Promise((resolve, reject) => {
       this.ws = new WebSocket(this.url);
       this.ws.onopen = () => {
         this.connectPromise = null;
+        this.reconnectAttempts = 0;
+        this.emit("connect");
         resolve();
       };
       this.ws.onerror = (ev) => {
         this.connectPromise = null;
-        reject(new Error(`WebSocket-Verbindung fehlgeschlagen: ${this.url} (${ev})`));
+        const error = new Error(`WebSocket-Verbindung fehlgeschlagen: ${this.url} (${ev})`);
+        this.emit("error", error);
+        reject(error);
       };
       this.ws.onmessage = (ev) => {
         this.handleMessage(typeof ev.data === "string" ? ev.data : String(ev.data));
       };
       this.ws.onclose = () => {
         this.connectPromise = null;
+        this.ws = null;
         for (const [id, req] of this.pending) {
           clearTimeout(req.timer);
           req.reject(new Error("WebSocket-Verbindung geschlossen"));
           this.pending.delete(id);
         }
+        this.emit("disconnect");
+        if (!this.manualDisconnect && this.reconnectOpts.enabled) {
+          this.scheduleReconnect();
+        }
       };
     });
     return this.connectPromise;
@@ -103,19 +128,71 @@ class WebSocketProvider {
       this.ws.send(payload);
     });
   }
-  on(_event, listener) {
-    this.listeners.add(listener);
+  on(event, listener) {
+    this.getListenerSet(event).add(listener);
   }
-  off(_event, listener) {
-    this.listeners.delete(listener);
+  off(event, listener) {
+    this.getListenerSet(event).delete(listener);
   }
   disconnect() {
+    this.manualDisconnect = true;
+    if (this.reconnectTimer) {
+      clearTimeout(this.reconnectTimer);
+      this.reconnectTimer = null;
+    }
     if (this.ws) {
       this.ws.close();
       this.ws = null;
     }
   }
   // ── Private ────────────────────────────────────────────────
+  scheduleReconnect() {
+    if (this.reconnectAttempts >= this.reconnectOpts.maxRetries) {
+      this.emit("error", new Error(
+        `Reconnect fehlgeschlagen nach ${this.reconnectOpts.maxRetries} Versuchen`
+      ));
+      return;
+    }
+    const delay = Math.min(
+      this.reconnectOpts.delay * Math.pow(2, this.reconnectAttempts),
+      this.reconnectOpts.maxDelay
+    );
+    this.reconnectAttempts++;
+    this.reconnectTimer = setTimeout(() => {
+      this.reconnectTimer = null;
+      this.connect().catch((err) => {
+        this.emit("error", err instanceof Error ? err : new Error(String(err)));
+      });
+    }, delay);
+  }
+  emit(event, data) {
+    switch (event) {
+      case "connect":
+        for (const l of this.connectListeners) l();
+        break;
+      case "disconnect":
+        for (const l of this.disconnectListeners) l();
+        break;
+      case "error":
+        for (const l of this.errorListeners) l(data);
+        break;
+      case "notification":
+        for (const l of this.notificationListeners) l(data);
+        break;
+    }
+  }
+  getListenerSet(event) {
+    switch (event) {
+      case "notification":
+        return this.notificationListeners;
+      case "connect":
+        return this.connectListeners;
+      case "disconnect":
+        return this.disconnectListeners;
+      case "error":
+        return this.errorListeners;
+    }
+  }
   handleMessage(raw) {
     let msg;
     try {
@@ -139,10 +216,7 @@ class WebSocketProvider {
       return;
     }
     if ("method" in msg && "params" in msg) {
-      const notification = msg;
-      for (const listener of this.listeners) {
-        listener(notification);
-      }
+      this.emit("notification", msg);
     }
   }
 }
@@ -282,6 +356,14 @@ class GenNet {
       }
     };
   }
+  /** Event-Listener registrieren (connect, disconnect, error). */
+  on(event, listener) {
+    this.provider.on(event, listener);
+  }
+  /** Event-Listener entfernen. */
+  off(event, listener) {
+    this.provider.off(event, listener);
+  }
   /** Raw JSON-RPC Request (für erweiterte Nutzung). */
   async request(method, params) {
     return this.provider.request(method, params);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gennet.js",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Client Library for GenNet — interact with GenNet nodes via JSON-RPC",
   "type": "module",
   "sideEffects": false,
@@ -27,6 +27,7 @@
     "dev": "unbuild --stub",
     "test": "vitest",
     "lint": "eslint src/",
+    "changeset": "changeset",
     "check": "publint && attw --pack",
     "prepublishOnly": "npm run build && npm run check"
   },
@@ -52,9 +53,11 @@
   "homepage": "https://github.com/cryptagoEU/gennet.js#readme",
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.17.0",
+    "@changesets/changelog-github": "^0.6.0",
+    "@changesets/cli": "^2.30.0",
     "publint": "^0.3.0",
     "typescript": "^5.4.0",
     "unbuild": "^3.0.0",
     "vitest": "^3.0.0"
   }
-}
+}