stelar-time-real 2.0.4 → 3.2.0

package/src/index.d.ts

@@ -1,25 +1,170 @@
-import { IncomingMessage, Server } from 'http';
-import { WebSocket } from 'ws';
+/**
+ * @stelar-time-real Server
+ *
+ * Dual-protocol real-time server: WebSocket (RFC 6455) + custom binary TCP.
+ * Zero external dependencies — uses only Node.js built-in modules.
+ */
+import { IncomingMessage, Server as HttpServer, ServerResponse } from 'http';
+import { Socket as NetSocket } from 'net';
+import type { TlsOptions } from 'tls';
+import { Logger, type LogLevel } from './logger.js';
+export interface IRateLimiter {
+    /** Returns true if the action is allowed */
+    check(id: string, cost?: number): boolean;
+    /** Reset rate limit for a specific client */
+    reset(id: string): void;
+    /** Clean up expired entries */
+    cleanup(): void;
+    /** Number of tracked entries */
+    size(): number;
+}
+export interface IIPTracker {
+    /** Returns true if connection from this IP is allowed */
+    check(ip: string): boolean;
+    /** Register a new connection from this IP */
+    add(ip: string): void;
+    /** Unregister a connection from this IP */
+    remove(ip: string): void;
+    /** Get current connection count for this IP */
+    getCount(ip: string): number;
+    /** Clean up stale entries */
+    cleanup(): void;
+}
+export interface StelarHooks {
+    /** Called when a client exceeds rate limit. Return false to skip disconnect. */
+    onRateLimitExceeded?: (info: {
+        clientId: string;
+        event?: string;
+        protocol: 'ws' | 'tcp';
+    }) => boolean | void;
+    /** Called when max connections is reached. */
+    onMaxConnectionsReached?: (info: {
+        activeConnections: number;
+        max: number;
+        ip: string;
+    }) => void;
+    /** Called when global max rooms is reached. Return false to reject room creation. */
+    onMaxRoomsReached?: (info: {
+        clientId: string;
+        room: string;
+        totalRooms: number;
+        max: number;
+    }) => boolean | void;
+    /** Called when per-client max rooms is reached. Return false to reject join. */
+    onMaxRoomsPerClientReached?: (info: {
+        clientId: string;
+        room: string;
+        currentRooms: number;
+        max: number;
+    }) => boolean | void;
+    /** Called when a payload exceeds maxPayloadSize. */
+    onPayloadTooLarge?: (info: {
+        clientId: string;
+        event?: string;
+        size: number;
+        max: number;
+    }) => void;
+    /** Called when a client sends an invalid message. */
+    onInvalidMessage?: (info: {
+        clientId: string;
+        reason: string;
+        protocol: 'ws' | 'tcp';
+    }) => void;
+    /** Called before a client joins a room. Return false to reject. */
+    onClientJoinRoom?: (info: {
+        clientId: string;
+        room: string;
+        metadata: Map<string, unknown>;
+    }) => boolean | void;
+    /** Called before a client leaves a room. Return false to reject. */
+    onClientLeaveRoom?: (info: {
+        clientId: string;
+        room: string;
+    }) => boolean | void;
+    /** Called before a broadcast. Return false to cancel. */
+    onBeforeBroadcast?: (info: {
+        event: string;
+        data: unknown;
+        excludeId?: string;
+    }) => boolean | void;
+    /** Called when a new client connects. */
+    onClientConnect?: (info: {
+        clientId: string;
+        ip: string;
+        protocol: 'ws' | 'tcp';
+        metadata: Map<string, unknown>;
+    }) => void;
+    /** Called when a client disconnects. */
+    onClientDisconnect?: (info: {
+        clientId: string;
+        ip: string;
+        protocol: 'ws' | 'tcp';
+        rooms: Set<string>;
+    }) => void;
+}
+export type EventRateLimits = Record<string, {
+    maxPoints: number;
+    windowMs: number;
+}>;
 export interface StelarOptions {
     port?: number;
-    server?: Server;
+    server?: HttpServer;
     namespace?: string;
     heartbeatInterval?: number;
+    heartbeatTimeout?: number;
+    tcpPort?: number | false;
+    maxConnections?: number;
+    maxConnectionsPerIP?: number;
+    maxRooms?: number;
+    maxRoomsPerClient?: number;
+    maxEventNameLength?: number;
+    maxPayloadSize?: number;
+    maxFrameSize?: number;
+    rateLimit?: {
+        maxPoints?: number;
+        windowMs?: number;
+    } | false;
+    connectTimeout?: number;
+    gracefulShutdown?: boolean;
+    shutdownTimeout?: number;
+    healthEndpoint?: string | false;
+    logger?: Logger | LogLevel | false;
+    tls?: TlsOptions;
+    allowedOrigins?: string[];
+    /** Custom rate limiter implementation. Replaces the built-in token bucket. */
+    customRateLimiter?: IRateLimiter;
+    /** Custom IP connection tracker. Replaces the built-in per-IP counter. */
+    customIPTracker?: IIPTracker;
+    /** Custom function to generate client IDs. Defaults to UUID v4. */
+    generateClientId?: () => string;
+    /** Per-event rate limits. Each event can have different maxPoints and windowMs. */
+    eventRateLimits?: EventRateLimits;
+    /** Hook callbacks for server events. */
+    hooks?: StelarHooks;
+    /** Custom health check handler. Receives (req, res, stats). */
+    customHealthHandler?: (req: IncomingMessage, res: ServerResponse, stats: StelarStats) => void;
 }
 export interface StelarClientInfo {
     id: string;
-    room: string | null;
+    rooms: Set<string>;
     lastPing: number;
+    protocol: 'ws' | 'tcp';
+    connectedAt: number;
+    metadata: Map<string, unknown>;
+    messagesReceived: number;
+    messagesSent: number;
+    remoteAddress: string;
 }
 export interface StelarContext {
     id: string;
-    socket: WebSocket;
-    req: IncomingMessage;
+    socket: NetSocket;
+    req: IncomingMessage | null;
     data?: unknown;
     buffer?: Uint8Array;
     isBinary?: boolean;
     event?: string;
     error?: Error;
+    clientInfo: StelarClientInfo;
     emit: (event: string, data: unknown) => void;
     send: (respId: string, data: unknown) => void;
     emitBinary: (event: string, buffer: ArrayBuffer) => void;
@@ -29,10 +174,12 @@ export interface StelarContext {
     toId: (id: string, event: string, data: unknown) => void;
     getClients: (room?: string) => {
         id: string;
-        room: string | null;
+        rooms: string[];
     }[];
     joinRoom: (room: string) => void;
-    leaveRoom: () => void;
+    leaveRoom: (room: string) => void;
+    setMetadata: (key: string, value: unknown) => void;
+    getMetadata: (key: string) => unknown;
     ack: (ackName: string, data: unknown) => void;
 }
 export interface StelarMiddleware {
@@ -43,43 +190,162 @@ export type StelarWildcardHandler = (data: {
     event: string;
     data: StelarContext;
 }) => void;
+export interface StelarStats {
+    totalConnections: number;
+    activeConnections: number;
+    totalMessagesReceived: number;
+    totalMessagesSent: number;
+    totalRooms: number;
+    uptime: number;
+    wsConnections: number;
+    tcpConnections: number;
+    memoryUsage: NodeJS.MemoryUsage;
+    rateLimiterEntries: number;
+}
 declare class StelarServer {
     private port;
-    private server;
+    private httpServer;
+    private tcpServer;
     private namespace;
-    private wss;
+    private heartbeatInterval;
+    private heartbeatTimeout;
+    private tcpPort;
+    private maxConnections;
+    private maxRooms;
+    private maxRoomsPerClient;
+    private maxPayloadSize;
+    private maxFrameSize;
+    private maxWSFrameSize;
+    private connectTimeout;
+    private doGracefulShutdown;
+    private shutdownTimeout;
+    private healthEndpoint;
+    private tlsOptions;
+    private allowedOrigins;
+    private _customRateLimiter;
+    private _customIPTracker;
+    private _generateClientId;
+    private _customHealthHandler;
+    private hooks;
+    private eventRateLimiters;
+    private _clientRateOverrides;
     private clients;
+    private clientsById;
+    private rooms;
     private events;
     private middlewares;
-    private heartbeatInterval;
     private _hbTimer;
+    private _rateCleanupTimer;
     private _wildcardHandler;
     private _connectionHandler;
     private _acks;
     private _externalServers;
+    private _upgradeHandler;
+    private _requestHandler;
+    private _started;
+    private _startTime;
+    private _shuttingDown;
+    private _sigintHandler;
+    private _sigtermHandler;
+    private rateLimiter;
+    private ipTracker;
+    private _totalConnections;
+    private _totalMessagesReceived;
+    private _totalMessagesSent;
+    private log;
     constructor(options?: StelarOptions);
     static of(path: string, options?: StelarOptions): StelarServer;
+    /** Update server configuration at runtime. */
+    updateConfig(options: Partial<StelarOptions>): this;
+    /** Set a per-client rate limit override. */
+    setClientRateLimit(clientId: string, config: {
+        maxPoints: number;
+        windowMs: number;
+    }): this;
+    /** Remove a per-client rate limit override, falling back to the global limiter. */
+    removeClientRateLimit(clientId: string): this;
+    /** Set a per-event rate limit. */
+    setEventRateLimit(event: string, config: {
+        maxPoints: number;
+        windowMs: number;
+    }): this;
+    /** Remove a per-event rate limit. */
+    removeEventRateLimit(event: string): this;
+    /** Get the current server configuration as a read-only object. */
+    getConfig(): Readonly<{
+        maxConnections: number;
+        maxConnectionsPerIP: number;
+        maxRooms: number;
+        maxRoomsPerClient: number;
+        maxPayloadSize: number;
+        heartbeatInterval: number;
+        heartbeatTimeout: number;
+        connectTimeout: number;
+        shutdownTimeout: number;
+        hasCustomRateLimiter: boolean;
+        hasCustomIPTracker: boolean;
+        hasCustomClientIdGenerator: boolean;
+        hasCustomHealthHandler: boolean;
+        eventRateLimits: string[];
+        hooks: string[];
+        allowedOrigins: string[] | null;
+    }>;
     use(middleware: StelarMiddleware): this;
     on(event: string, handler: StelarEventHandler): this;
     onAll(handler: StelarWildcardHandler): this;
     onConnection(handler: StelarEventHandler): this;
+    onDisconnect(handler: StelarEventHandler): this;
     onAck(name: string, handler: StelarEventHandler): this;
-    broadcast(event: string, data: unknown): this;
+    broadcast(event: string, data: unknown, excludeId?: string): this;
     broadcastBinary(event: string, buffer: ArrayBuffer): void;
-    to(room: string, event: string, data: unknown): this;
+    to(room: string, event: string, data: unknown, excludeId?: string): this;
     toId(id: string, event: string, data: unknown): this;
     getClients(room?: string): {
         id: string;
-        room: string | null;
+        rooms: string[];
     }[];
+    getRoomMembers(room: string): string[];
+    getRooms(): string[];
     getPort(): number;
+    getStats(): StelarStats;
+    private _getRateLimiterSize;
+    /** Check rate limit. Priority: per-client override > event-specific > custom/global. */
+    private _checkRateLimit;
+    private _sendJsonToClient;
+    private _sendBinaryRaw;
+    private _joinRoom;
+    private _leaveRoom;
+    private _removeFromAllRooms;
+    private _buildCtx;
     private runMiddlewares;
     private startHeartbeat;
-    private handleConnection;
+    private _getClientIP;
+    private _registerClient;
+    private _unregisterClient;
+    private _checkOrigin;
+    private handleWSUpgrade;
+    private _processWSData;
+    private _handleWSFrame;
+    private handleTCPConnection;
+    private _processTCPData;
+    private _handleTCPFrame;
+    private _handleError;
+    private _handleHealthCheck;
+    private _shutdownCallbacks;
+    /** Register a callback for when graceful shutdown completes. */
+    onShutdown(callback: (signal: string, force: boolean) => void): this;
+    private _emitShutdown;
+    private _setupGracefulShutdown;
+    private _removeSignalHandlers;
     start(callback?: (port: number) => void): Promise<number>;
+    private _startTCPServer;
+    private _startPlainTCPServer;
     stop(): this;
 }
 export default StelarServer;
 export { StelarServer };
 export { default as StelarClient } from './client.js';
+export { Logger, NULL_LOGGER, type LogLevel } from './logger.js';
+export { ProtocolError, validateEventName, DEFAULT_MAX_FRAME_SIZE, MAX_EVENT_LENGTH, HEADER_SIZE } from './protocol.js';
+export { WebSocketError, DEFAULT_MAX_WS_FRAME_SIZE, CLOSE_NORMAL, CLOSE_GOING_AWAY, CLOSE_PROTOCOL_ERROR, CLOSE_POLICY_VIOLATION, CLOSE_MESSAGE_TOO_BIG, CLOSE_INVALID_PAYLOAD, CLOSE_UNSUPPORTED } from './websocket.js';
 //# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

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