aestasocket

Lightweight WebSocket client with memory-safe listeners.

Features

• Minimal API: ws.on, ws.send, ws.close
• Auto JSON parsing for incoming messages
• Optional reconnect support (if implemented in your app flow)
• Lazy connection (connects on first on/send)

Installation

npm install aestasocket

Usage (React / Browser)

import { useEffect } from "react";
import { createSocket } from "aestasocket";

export default function RealtimeWidget() {
  useEffect(() => {
    const ws = createSocket("wss://echo.websocket.events");

    const offMessage = ws.on("message", (data) => {
      console.log("message:", data); // string or parsed object
    });

    const offError = ws.on("error", (error) => {
      console.error("socket error:", error);
    });

    ws.send(JSON.stringify({ type: "hello", source: "react" }));

    return () => {
      offMessage();
      offError();
      ws.close();
    };
  }, []);

  return <div>Realtime connected</div>;
}

API

• createSocket(url)
• ws.on(event, handler)
• ws.send(data)
• ws.close()