stelar-time-real 1.2.2 → 2.0.0

package/src/client.ts

@@ -0,0 +1,257 @@
+export interface StelarClientOptions {
+  reconnection?: boolean;
+  reconnectionAttempts?: number;
+  reconnectionDelay?: number;
+  heartbeatInterval?: number;
+  ackTimeout?: number;
+}
+
+export interface StelarEmitOptions {
+  ack?: string;
+}
+
+export type StelarEventHandler = (data: unknown) => void;
+export type StelarBinaryHandler = (buffer: ArrayBuffer) => void;
+
+class StelarClient {
+  private url: string;
+  private options: Required<StelarClientOptions>;
+  private ws: WebSocket | null = null;
+  private events = new Map<string, StelarEventHandler>();
+  private _wildcardHandler: ((data: { event: string; data: unknown; isBinary?: boolean; buffer?: ArrayBuffer }) => void) | null = null;
+  private connected = false;
+  private id: string | null = null;
+  private _reconnectAttempts = 0;
+  private _hbTimer: ReturnType<typeof setInterval> | null = null;
+  private _isManualClose = false;
+  private _acks = new Map<string, StelarEventHandler>();
+
+  constructor(urlOrPort: string | number = 'localhost:3000', options: StelarClientOptions = {}) {
+    if (typeof urlOrPort === 'number') {
+      this.url = `ws://localhost:${urlOrPort}`;
+    } else if (urlOrPort.includes('://')) {
+      this.url = urlOrPort.startsWith('http') ? 'ws' + urlOrPort.slice(4) : urlOrPort;
+    } else {
+      this.url = `ws://${urlOrPort}`;
+    }
+
+    this.options = {
+      reconnection: options.reconnection !== false,
+      reconnectionAttempts: options.reconnectionAttempts || 5,
+      reconnectionDelay: options.reconnectionDelay || 1000,
+      heartbeatInterval: options.heartbeatInterval || 30000,
+      ackTimeout: options.ackTimeout || 5000
+    };
+  }
+
+  setUrl(url: string): this {
+    this.url = url;
+    return this;
+  }
+
+  on(event: string, handler: StelarEventHandler): this {
+    this.events.set(event, handler);
+    return this;
+  }
+
+  off(event: string, handler: StelarEventHandler): this {
+    if (this.events.get(event) === handler) {
+      this.events.delete(event);
+    }
+    return this;
+  }
+
+  onAll(handler: (data: { event: string; data: unknown; isBinary?: boolean; buffer?: ArrayBuffer }) => void): this {
+    this._wildcardHandler = handler;
+    return this;
+  }
+
+  onAck(name: string, handler: StelarEventHandler): this {
+    this._acks.set(name, handler);
+    return this;
+  }
+
+  emit(event: string, data?: unknown, opts: StelarEmitOptions = {}): this {
+    if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+      const payload: Record<string, unknown> = { event, data };
+      if (opts.ack) {
+        payload._ackName = opts.ack;
+      }
+      this.ws.send(JSON.stringify(payload));
+    }
+    return this;
+  }
+
+  emitBinary(event: string, data: ArrayBuffer): this {
+    if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+      const header = JSON.stringify({ event });
+      const headerBytes = new TextEncoder().encode(header);
+      const combined = new Uint8Array(headerBytes.length + 1 + data.byteLength);
+      combined.set(headerBytes, 0);
+      combined[headerBytes.length] = 0;
+      combined.set(new Uint8Array(data), headerBytes.length + 1);
+      this.ws.send(combined);
+    }
+    return this;
+  }
+
+  sendFile(file: ArrayBuffer): this {
+    return this.emitBinary('file', file);
+  }
+
+  sendImage(blob: ArrayBuffer): this {
+    return this.emitBinary('image', blob);
+  }
+
+  request(event: string, data: unknown, ackName: string): Promise<unknown> {
+    return new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => {
+        reject(new Error(`ACK '${ackName}' timeout`));
+      }, this.options.ackTimeout);
+
+      const handler: StelarEventHandler = (responseData) => {
+        clearTimeout(timeout);
+        this._acks.delete(ackName);
+        resolve(responseData);
+      };
+
+      this._acks.set(ackName, handler);
+      this.emit(event, data, { ack: ackName });
+    });
+  }
+
+  joinRoom(room: string): this {
+    this.emit('join-room', room);
+    return this;
+  }
+
+  leaveRoom(): this {
+    this.emit('leave-room', {});
+    return this;
+  }
+
+  private startHeartbeat(): void {
+    this._hbTimer = setInterval(() => {
+      if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+        this.emit('pong', Date.now());
+      }
+    }, this.options.heartbeatInterval);
+  }
+
+  private stopHeartbeat(): void {
+    if (this._hbTimer) {
+      clearInterval(this._hbTimer);
+      this._hbTimer = null;
+    }
+  }
+
+  private _connect(): void {
+    this._isManualClose = false;
+    this.ws = new WebSocket(this.url);
+
+    this.ws.onopen = () => {
+      this.connected = true;
+      this._reconnectAttempts = 0;
+      const handler = this.events.get('connect');
+      if (handler) handler(undefined);
+      this.startHeartbeat();
+    };
+
+    this.ws.binaryType = 'arraybuffer';
+
+    this.ws.onmessage = (e: MessageEvent) => {
+      try {
+        if (e.data instanceof ArrayBuffer) {
+          const view = new Uint8Array(e.data);
+          let headerEnd = -1;
+          for (let i = 0; i < view.length; i++) {
+            if (view[i] === 0) {
+              headerEnd = i;
+              break;
+            }
+          }
+          if (headerEnd === -1) return;
+
+          const headerStr = new TextDecoder().decode(view.slice(0, headerEnd));
+          const header = JSON.parse(headerStr);
+          const buffer = view.slice(headerEnd + 1);
+
+          const handler = this.events.get(header.event);
+          if (handler) {
+            handler(buffer.buffer);
+          } else if (this._wildcardHandler) {
+            this._wildcardHandler({ event: header.event, data: buffer.buffer, isBinary: true, buffer: buffer.buffer });
+          }
+          return;
+        }
+
+        const msg = JSON.parse(e.data);
+        const { event, data, _isAck } = msg;
+
+        if (event === 'ping') return;
+
+        if (_isAck && this._acks.has(event)) {
+          const handler = this._acks.get(event)!;
+          handler(data);
+          return;
+        }
+
+        const handler = this.events.get(event);
+        if (handler) handler(data);
+
+        if (this._wildcardHandler) {
+          this._wildcardHandler({ event, data });
+        }
+      } catch {}
+    };
+
+    this.ws.onclose = () => {
+      this.connected = false;
+      this.stopHeartbeat();
+      const handler = this.events.get('disconnect');
+      if (handler) handler(undefined);
+
+      if (!this._isManualClose && this.options.reconnection && this._reconnectAttempts < this.options.reconnectionAttempts) {
+        this._reconnectAttempts++;
+        const reconHandler = this.events.get('reconnecting');
+        if (reconHandler) reconHandler(this._reconnectAttempts);
+        setTimeout(() => this.connect(), this.options.reconnectionDelay * this._reconnectAttempts);
+      }
+    };
+
+    this.ws.onerror = (err: Event) => {
+      const handler = this.events.get('error');
+      if (handler) handler(err);
+    };
+  }
+
+  connect(callback?: () => void): this {
+    this._connect();
+    if (callback) {
+      const checkConnection = setInterval(() => {
+        if (this.connected) {
+          clearInterval(checkConnection);
+          callback();
+        }
+      }, 100);
+    }
+    return this;
+  }
+
+  disconnect(): this {
+    this._isManualClose = true;
+    this.stopHeartbeat();
+    if (this.ws) this.ws.close();
+    return this;
+  }
+
+  isConnected(): boolean {
+    return this.connected;
+  }
+
+  getUrl(): string {
+    return this.url;
+  }
+}
+
+export default StelarClient;

package/src/index.d.ts

@@ -0,0 +1,85 @@
+import { IncomingMessage, Server } from 'http';
+import { WebSocket } from 'ws';
+export interface StelarOptions {
+    port?: number;
+    server?: Server;
+    namespace?: string;
+    heartbeatInterval?: number;
+}
+export interface StelarClientInfo {
+    id: string;
+    room: string | null;
+    lastPing: number;
+}
+export interface StelarContext {
+    id: string;
+    socket: WebSocket;
+    req: IncomingMessage;
+    data?: unknown;
+    buffer?: Uint8Array;
+    isBinary?: boolean;
+    event?: string;
+    error?: Error;
+    emit: (event: string, data: unknown) => void;
+    send: (respId: string, data: unknown) => void;
+    emitBinary: (event: string, buffer: ArrayBuffer) => void;
+    broadcast: (event: string, data: unknown) => void;
+    broadcastBinary: (event: string, buffer: ArrayBuffer) => void;
+    to: (room: string, event: string, data: unknown) => void;
+    toId: (id: string, event: string, data: unknown) => void;
+    getClients: (room?: string) => {
+        id: string;
+        room: string | null;
+    }[];
+    joinRoom: (room: string) => void;
+    leaveRoom: () => void;
+    ack: (ackName: string, data: unknown) => void;
+}
+export interface StelarMiddleware {
+    (ctx: StelarContext, next: () => void): void;
+}
+export type StelarEventHandler = (ctx: StelarContext) => void;
+export type StelarWildcardHandler = (data: {
+    event: string;
+    data: StelarContext;
+}) => void;
+declare class StelarServer {
+    private port;
+    private server;
+    private namespace;
+    private wss;
+    private clients;
+    private events;
+    private middlewares;
+    private heartbeatInterval;
+    private _hbTimer;
+    private _wildcardHandler;
+    private _connectionHandler;
+    private _acks;
+    private _externalServers;
+    constructor(options?: StelarOptions);
+    static of(path: string, options?: StelarOptions): StelarServer;
+    use(middleware: StelarMiddleware): this;
+    on(event: string, handler: StelarEventHandler): this;
+    onAll(handler: StelarWildcardHandler): this;
+    onConnection(handler: StelarEventHandler): this;
+    onAck(name: string, handler: StelarEventHandler): this;
+    broadcast(event: string, data: unknown): this;
+    broadcastBinary(event: string, buffer: ArrayBuffer): void;
+    to(room: string, event: string, data: unknown): this;
+    toId(id: string, event: string, data: unknown): this;
+    getClients(room?: string): {
+        id: string;
+        room: string | null;
+    }[];
+    getPort(): number;
+    private runMiddlewares;
+    private startHeartbeat;
+    private handleConnection;
+    start(callback?: (port: number) => void): Promise<number>;
+    stop(): this;
+}
+export default StelarServer;
+export { StelarServer };
+export { default as StelarClient } from './client.js';
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

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