redux-cluster-ws 1.4.0 → 2.0.1

package/dist/esm/server.js

@@ -0,0 +1,299 @@
+import { createServer as createHttpServer } from "http";
+import { createServer as createHttpsServer } from "https";
+import { readFileSync } from "fs";
+import { hasher, replacer, generateUID } from "./utils.js";
+// Import WebSocket server for Node.js
+import { WebSocketServer } from "ws";
+export class ReduxClusterWSServerWrapper {
+    store;
+    uid;
+    connections;
+    authDatabase;
+    ipBanDatabase;
+    config;
+    server;
+    wss;
+    unsubscribe;
+    IP_BAN_ATTEMPTS = 15;
+    IP_BAN_TIMEOUT = 10800000; // 3 hours
+    CONNECTION_TIMEOUT = 30000;
+    gcInterval;
+    constructor(store) {
+        this.store = store;
+        this.uid = generateUID();
+        this.connections = new Map();
+        this.authDatabase = {};
+        this.ipBanDatabase = {};
+        this.config = { host: "0.0.0.0", port: 10002 };
+        // Attach createWSServer method to store
+        store.createWSServer = this.createWSServer.bind(this);
+    }
+    createWSServer = (config) => {
+        this.config = { ...this.config, ...config };
+        // Setup authentication database
+        if (this.config.logins) {
+            for (const [login, password] of Object.entries(this.config.logins)) {
+                const hashedLogin = hasher(`REDUX_CLUSTER${login}`);
+                const hashedPassword = hasher(`REDUX_CLUSTER${password}`);
+                this.authDatabase[hashedLogin] = hashedPassword;
+            }
+        }
+        // Start garbage collection for banned IPs
+        this.startGarbageCollection();
+        // Create HTTP/HTTPS server if not provided
+        if (!this.config.server) {
+            if (this.config.ssl?.key && this.config.ssl?.cert) {
+                const ssl = {
+                    key: readFileSync(this.config.ssl.key),
+                    cert: readFileSync(this.config.ssl.cert) +
+                        (this.config.ssl.ca ? "\n" + readFileSync(this.config.ssl.ca) : ""),
+                };
+                this.server = createHttpsServer(ssl);
+            }
+            else {
+                this.server = createHttpServer();
+            }
+            this.server.setTimeout(this.CONNECTION_TIMEOUT);
+            this.server.listen(this.config.port, this.config.host);
+        }
+        else {
+            this.server = this.config.server;
+        }
+        // Create WebSocket server
+        this.wss = new WebSocketServer({
+            server: this.server,
+            path: `/redux-cluster-${this.store.RCHash}`,
+        });
+        this.wss.on("connection", this.handleConnection.bind(this));
+        // Subscribe to store changes
+        this.unsubscribe = this.store.subscribe(() => {
+            if (this.store.mode === "snapshot") {
+                this.sendToAll();
+            }
+        });
+        // For action mode, override dispatch to send individual actions
+        if (this.store.mode === "action") {
+            const originalDispatch = this.store.dispatch;
+            this.store.dispatch = (action) => {
+                const result = originalDispatch(action);
+                // Send the action to all connected clients
+                if (action.type !== "@@INIT" && action.type !== "REDUX_CLUSTER_SYNC") {
+                    this.sendToAll({
+                        _msg: "REDUX_CLUSTER_MSGTOWORKER",
+                        _hash: this.store.RCHash,
+                        _action: action,
+                    });
+                }
+                return result;
+            };
+        }
+        // Add server role
+        if (!this.store.role.includes("server")) {
+            this.store.role.push("server");
+        }
+    };
+    handleConnection = (ws, req) => {
+        const connectionId = generateUID();
+        const ip = this.extractIP(req);
+        const processedIP = replacer(ip, true);
+        // Check if IP is banned
+        if (this.isIPBanned(processedIP)) {
+            this.sendMessage(ws, {
+                _msg: "REDUX_CLUSTER_SOCKET_AUTHSTATE",
+                _hash: this.store.RCHash,
+                _value: false,
+                _banned: true,
+            });
+            ws.close();
+            return;
+        }
+        const connection = {
+            id: connectionId,
+            ws,
+            authenticated: false,
+            ip: processedIP,
+        };
+        this.connections.set(connectionId, connection);
+        ws.on("message", (data) => {
+            try {
+                const message = JSON.parse(data.toString());
+                this.handleMessage(connectionId, message);
+            }
+            catch (error) {
+                this.store.stderr(`ReduxCluster.createWSServer message parse error: ${error}`);
+                this.removeConnection(connectionId);
+            }
+        });
+        ws.on("close", () => {
+            this.removeConnection(connectionId);
+        });
+        ws.on("error", (error) => {
+            this.store.stderr(`ReduxCluster.createWSServer connection error: ${error.message}`);
+            this.removeConnection(connectionId);
+        });
+    };
+    handleMessage = (connectionId, message) => {
+        const connection = this.connections.get(connectionId);
+        if (!connection || message._hash !== this.store.RCHash) {
+            return;
+        }
+        switch (message._msg) {
+            case "REDUX_CLUSTER_SOCKET_AUTH":
+                this.handleAuthentication(connectionId, message);
+                break;
+            case "REDUX_CLUSTER_START":
+                if (connection.authenticated) {
+                    this.sendMessage(connection.ws, {
+                        _msg: "REDUX_CLUSTER_MSGTOWORKER",
+                        _hash: this.store.RCHash,
+                        _action: {
+                            type: "REDUX_CLUSTER_SYNC",
+                            payload: this.store.getState(),
+                        },
+                    });
+                }
+                break;
+            case "REDUX_CLUSTER_MSGTOMASTER":
+                if (connection.authenticated && message._action) {
+                    if (message._action.type === "REDUX_CLUSTER_SYNC") {
+                        throw new Error("Please don't use REDUX_CLUSTER_SYNC action type!");
+                    }
+                    this.store.dispatch(message._action);
+                }
+                break;
+        }
+    };
+    handleAuthentication = (connectionId, message) => {
+        const connection = this.connections.get(connectionId);
+        if (!connection)
+            return;
+        const { _login, _password } = message;
+        if (_login &&
+            _password &&
+            this.authDatabase[_login] &&
+            this.authDatabase[_login] === _password) {
+            // Authentication successful
+            connection.authenticated = true;
+            this.clearIPBan(connection.ip);
+            this.sendMessage(connection.ws, {
+                _msg: "REDUX_CLUSTER_SOCKET_AUTHSTATE",
+                _hash: this.store.RCHash,
+                _value: true,
+            });
+        }
+        else {
+            // Authentication failed
+            this.recordFailedAttempt(connection.ip);
+            this.sendMessage(connection.ws, {
+                _msg: "REDUX_CLUSTER_SOCKET_AUTHSTATE",
+                _hash: this.store.RCHash,
+                _value: false,
+            });
+            this.removeConnection(connectionId);
+        }
+    };
+    sendToAll = (message) => {
+        const msg = message || {
+            _msg: "REDUX_CLUSTER_MSGTOWORKER",
+            _hash: this.store.RCHash,
+            _action: { type: "REDUX_CLUSTER_SYNC", payload: this.store.getState() },
+        };
+        for (const connection of this.connections.values()) {
+            if (connection.authenticated && connection.ws.readyState === 1) {
+                // WebSocket.OPEN = 1
+                try {
+                    this.sendMessage(connection.ws, msg);
+                }
+                catch (error) {
+                    this.store.stderr(`ReduxCluster.createWSServer write error: ${error}`);
+                }
+            }
+        }
+    };
+    sendMessage = (ws, message) => {
+        if (ws.readyState === 1) {
+            // WebSocket.OPEN = 1
+            ws.send(JSON.stringify(message));
+        }
+    };
+    extractIP = (req) => {
+        const forwarded = req.headers["x-forwarded-for"];
+        if (typeof forwarded === "string") {
+            return forwarded.split(",")[0].trim();
+        }
+        if (Array.isArray(forwarded)) {
+            return forwarded[0];
+        }
+        return req.socket.remoteAddress || "127.0.0.1";
+    };
+    isIPBanned = (ip) => {
+        const banInfo = this.ipBanDatabase[ip];
+        if (!banInfo)
+            return false;
+        const isTimedOut = banInfo.time + this.IP_BAN_TIMEOUT < Date.now();
+        if (isTimedOut) {
+            delete this.ipBanDatabase[ip];
+            return false;
+        }
+        return banInfo.count >= this.IP_BAN_ATTEMPTS;
+    };
+    recordFailedAttempt = (ip) => {
+        const existing = this.ipBanDatabase[ip];
+        let count = 0;
+        if (existing) {
+            const isTimedOut = existing.time + this.IP_BAN_TIMEOUT < Date.now();
+            count = isTimedOut ? 0 : existing.count;
+        }
+        this.ipBanDatabase[ip] = {
+            time: Date.now(),
+            count: count + 1,
+        };
+    };
+    clearIPBan = (ip) => {
+        delete this.ipBanDatabase[ip];
+    };
+    removeConnection = (connectionId) => {
+        const connection = this.connections.get(connectionId);
+        if (connection) {
+            try {
+                connection.ws.close();
+            }
+            catch {
+                // Ignore errors when closing
+            }
+            this.connections.delete(connectionId);
+        }
+    };
+    startGarbageCollection = () => {
+        this.gcInterval = setInterval(() => {
+            const now = Date.now();
+            for (const [ip, banInfo] of Object.entries(this.ipBanDatabase)) {
+                if (banInfo.time + this.IP_BAN_TIMEOUT < now) {
+                    delete this.ipBanDatabase[ip];
+                }
+            }
+        }, 60000); // Run every minute
+    };
+    destroy = () => {
+        if (this.gcInterval) {
+            clearInterval(this.gcInterval);
+        }
+        if (this.unsubscribe) {
+            this.unsubscribe();
+        }
+        for (const connection of this.connections.values()) {
+            this.removeConnection(connection.id);
+        }
+        if (this.wss) {
+            this.wss.close();
+        }
+        if (this.server && this.server.close) {
+            this.server.close();
+        }
+    };
+}
+export function server(store) {
+    new ReduxClusterWSServerWrapper(store);
+    return store;
+}
+//# sourceMappingURL=server.js.map

package/dist/esm/server.js.map

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

package/dist/esm/types.d.ts

@@ -0,0 +1,83 @@
+import type { Reducer, Action, AnyAction, Dispatch } from "redux";
+export interface WSServerConfig {
+    host?: string;
+    port?: number;
+    server?: any;
+    logins?: Record<string, string>;
+    ssl?: {
+        key: string;
+        cert: string;
+        ca?: string;
+    };
+}
+export interface WSClientConfig {
+    host: string;
+    port?: number;
+    login: string;
+    password: string;
+    reconnectInterval?: number;
+    timeout?: number;
+}
+export interface ReduxClusterMessage {
+    _msg: string;
+    _hash: string;
+    _action?: AnyAction;
+    _login?: string;
+    _password?: string;
+    _value?: boolean;
+    _banned?: boolean;
+}
+export interface ReduxClusterStore<S = any, A extends Action = AnyAction> {
+    getState(): S;
+    dispatch: Dispatch<A>;
+    subscribe(listener: () => void): () => void;
+    replaceReducer(nextReducer: Reducer<S, A>): void;
+    [Symbol.observable](): any;
+    createWSServer?: (config: WSServerConfig) => void;
+    createWSClient?: (config: WSClientConfig) => void;
+    RCHash: string;
+    role: string[];
+    mode: "action" | "snapshot";
+    connected: boolean;
+    stderr: (message: string) => void;
+    version: string;
+    homepage: string;
+}
+export interface WSConnection {
+    id: string;
+    ws: any;
+    authenticated: boolean;
+    ip: string;
+}
+export interface BanInfo {
+    time: number;
+    count: number;
+}
+export interface AuthDatabase {
+    [hashedLogin: string]: string;
+}
+export interface IPBanDatabase {
+    [ip: string]: BanInfo;
+}
+export interface ReduxClusterWSServer {
+    store: ReduxClusterStore;
+    uid: string;
+    connections: Map<string, WSConnection>;
+    authDatabase: AuthDatabase;
+    ipBanDatabase: IPBanDatabase;
+    config: WSServerConfig;
+    server?: any;
+    wss?: any;
+    sendToAll: (message?: ReduxClusterMessage) => void;
+    unsubscribe?: () => void;
+}
+export interface ReduxClusterWSClient {
+    store: ReduxClusterStore;
+    config: WSClientConfig;
+    ws?: any;
+    reconnectTimer?: any;
+    authenticated: boolean;
+    login: string;
+    password: string;
+    reconnect: () => void;
+}

package/dist/esm/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/dist/esm/utils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Hash a string using SHA-1
+ */
+export declare function hasher(data: string): string;
+/**
+ * Replace dots with underscores and vice versa
+ */
+export declare function replacer(data: string, dotToUnderscore?: boolean): string;
+/**
+ * Generate a unique identifier using crypto.randomUUID
+ * Supports Node.js 14.17+ and modern browsers (Chrome 92+, Firefox 95+, Safari 15.4+)
+ */
+export declare function generateUID(): string;
+/**
+ * Deep clone an object
+ */
+export declare function deepClone<T>(obj: T): T;

package/dist/esm/utils.js

@@ -0,0 +1,69 @@
+import { createHash, randomUUID } from "crypto";
+/**
+ * Hash a string using SHA-1
+ */
+export function hasher(data) {
+    if (typeof data === "string") {
+        const hash = createHash("sha1");
+        hash.update(data);
+        return hash.digest("hex");
+    }
+    throw new Error("Data must be a string");
+}
+/**
+ * Replace dots with underscores and vice versa
+ */
+export function replacer(data, dotToUnderscore = true) {
+    if (typeof data === "string") {
+        if (dotToUnderscore) {
+            return data.replace(/\./g, "_");
+        }
+        else {
+            return data.replace(/_/g, ".");
+        }
+    }
+    throw new Error("Data must be a string");
+}
+/**
+ * Generate a unique identifier using crypto.randomUUID
+ * Supports Node.js 14.17+ and modern browsers (Chrome 92+, Firefox 95+, Safari 15.4+)
+ */
+export function generateUID() {
+    // Use crypto.randomUUID if available (Node.js 14.17+ and modern browsers)
+    if (typeof randomUUID === "function") {
+        return randomUUID();
+    }
+    // Browser global crypto.randomUUID
+    if (typeof crypto !== "undefined" && crypto.randomUUID) {
+        return crypto.randomUUID();
+    }
+    // Final fallback for very old environments
+    return (Math.random().toString(36).substring(2, 15) +
+        Math.random().toString(36).substring(2, 15) +
+        Date.now().toString(36));
+}
+/**
+ * Deep clone an object
+ */
+export function deepClone(obj) {
+    if (obj === null || typeof obj !== "object") {
+        return obj;
+    }
+    if (obj instanceof Date) {
+        return new Date(obj.getTime());
+    }
+    if (obj instanceof Array) {
+        return obj.map((item) => deepClone(item));
+    }
+    if (typeof obj === "object") {
+        const cloned = {};
+        for (const key in obj) {
+            if (Object.prototype.hasOwnProperty.call(obj, key)) {
+                cloned[key] = deepClone(obj[key]);
+            }
+        }
+        return cloned;
+    }
+    return obj;
+}
+//# sourceMappingURL=utils.js.map

package/dist/esm/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEhD;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CACtB,IAAY,EACZ,kBAA2B,IAAI;IAE/B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;AAC3C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,0EAA0E;IAC1E,IAAI,OAAO,UAAU,KAAK,UAAU,EAAE,CAAC;QACrC,OAAO,UAAU,EAAE,CAAC;IACtB,CAAC;IAED,mCAAmC;IACnC,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACvD,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;IAED,2CAA2C;IAC3C,OAAO,CACL,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC;QAC3C,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC;QAC3C,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CACxB,CAAC;AACJ,CAAC;AACD;;GAEG;AACH,MAAM,UAAU,SAAS,CAAI,GAAM;IACjC,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,GAAG,CAAC;IACb,CAAC;IAED,IAAI,GAAG,YAAY,IAAI,EAAE,CAAC;QACxB,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAM,CAAC;IACtC,CAAC;IAED,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAM,CAAC;IACjD,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,EAAO,CAAC;QACvB,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;YACtB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;gBACnD,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/eslint.config.js

@@ -0,0 +1,143 @@
+import js from "@eslint/js";
+import tsPlugin from "@typescript-eslint/eslint-plugin";
+import tsParser from "@typescript-eslint/parser";
+
+export default [
+  js.configs.recommended,
+  {
+    ignores: ["*.md", "**/*.md"], // Ignore Markdown files
+  },
+  {
+    files: ["src/**/*.ts"],
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: {
+        ecmaVersion: 2020,
+        sourceType: "module",
+        project: "./tsconfig.json",
+      },
+      globals: {
+        // Node.js globals
+        global: "readonly",
+        process: "readonly",
+        console: "readonly",
+        Buffer: "readonly",
+        require: "readonly",
+        module: "readonly",
+        exports: "readonly",
+        __dirname: "readonly",
+        __filename: "readonly",
+        setTimeout: "readonly",
+        clearTimeout: "readonly",
+        setInterval: "readonly",
+        clearInterval: "readonly",
+        setImmediate: "readonly",
+        clearImmediate: "readonly",
+        structuredClone: "readonly",
+        // TypeScript globals
+        NodeJS: "readonly",
+        BufferEncoding: "readonly",
+      },
+    },
+    plugins: {
+      "@typescript-eslint": tsPlugin,
+    },
+    rules: {
+      ...tsPlugin.configs.recommended.rules,
+      "@typescript-eslint/no-explicit-any": "off",
+      "@typescript-eslint/no-unused-vars": [
+        "error",
+        { argsIgnorePattern: "^_" },
+      ],
+      "@typescript-eslint/explicit-function-return-type": "off",
+      "@typescript-eslint/explicit-module-boundary-types": "off",
+      "@typescript-eslint/no-empty-function": "off",
+      "no-case-declarations": "off",
+      "no-undef": "off", // TypeScript handles this
+    },
+  },
+  {
+    files: ["tests/**/*.cjs", "*.test.cjs", "test.*.cjs"],
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: {
+        ecmaVersion: 2020,
+        sourceType: "script",
+      },
+      globals: {
+        // Node.js globals
+        global: "readonly",
+        process: "readonly",
+        console: "readonly",
+        Buffer: "readonly",
+        require: "readonly",
+        module: "readonly",
+        exports: "readonly",
+        __dirname: "readonly",
+        __filename: "readonly",
+        setTimeout: "readonly",
+        clearTimeout: "readonly",
+        setInterval: "readonly",
+        clearInterval: "readonly",
+        setImmediate: "readonly",
+        clearImmediate: "readonly",
+        structuredClone: "readonly",
+      },
+    },
+    plugins: {
+      "@typescript-eslint": tsPlugin,
+    },
+    rules: {
+      ...tsPlugin.configs.recommended.rules,
+      "@typescript-eslint/no-explicit-any": "off",
+      "no-case-declarations": "off",
+      "no-undef": "off",
+      // Allow console in test files
+      "no-console": "off",
+      // Allow require in CommonJS
+      "@typescript-eslint/no-var-requires": "off",
+    },
+  },
+  {
+    files: ["examples/**/*.cjs", "*.cjs"],
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: {
+        ecmaVersion: 2020,
+        sourceType: "script",
+      },
+      globals: {
+        // Node.js globals
+        global: "readonly",
+        process: "readonly",
+        console: "readonly",
+        Buffer: "readonly",
+        require: "readonly",
+        module: "readonly",
+        exports: "readonly",
+        __dirname: "readonly",
+        __filename: "readonly",
+        setTimeout: "readonly",
+        clearTimeout: "readonly",
+        setInterval: "readonly",
+        clearInterval: "readonly",
+        setImmediate: "readonly",
+        clearImmediate: "readonly",
+        structuredClone: "readonly",
+      },
+    },
+    plugins: {
+      "@typescript-eslint": tsPlugin,
+    },
+    rules: {
+      ...tsPlugin.configs.recommended.rules,
+      "@typescript-eslint/no-explicit-any": "off",
+      "no-case-declarations": "off",
+      "no-undef": "off",
+      // Allow console in examples
+      "no-console": "off",
+      // Allow require in CommonJS
+      "@typescript-eslint/no-var-requires": "off",
+    },
+  },
+];