redweb 0.6.2 → 0.6.4

package/src/http/BaseHttpServer.js

@@ -1,69 +1,69 @@
-const express = require('express');
-const bodyParser = require('body-parser');
-const path = require('path');
-const cors = require('cors');
-
-/**
- * @typedef {'json' | 'urlencoded'} RedWebEncoding
- */
-
-/**
- * RedWeb options object.
- * @typedef {Object} RedWebOptions
- * @property {number} [port=80] - The port number to bind the server.
- * @property {string} [bind='0.0.0.0'] - The bind address for the server.
- * @property {string[]} [publicPaths=['./public']] - An array of paths to serve static files from.
- * @property {Array<{serviceName: string, method: string, function: Function}>} [services=[]] - An array of services with their endpoints and handlers.
- * @property {Function} [listenCallback] - Callback function to execute once the server starts listening.
- * @property {RedWebEncoding} [encoding='json'] - The encoding type for the request bodies ('json' or 'urlencoded').
- * @property {Object} [ssl] - SSL configuration for HTTPS server.
- * @property {string} [ssl.key] - Path to the SSL key file.
- * @property {string} [ssl.cert] - Path to the SSL certificate file.
- * @property {import('express').Application} [server] - Whether to automatically start listening.
- * @property {import('cors').CorsOptions} [corsOptions] - The CORS Options.
- */
-
-const ENCODINGS = { json: 'json', urlencoded: 'urlencoded' };
-const HTTP_OPTIONS = {
-    port: 80,
-    bind: '0.0.0.0',
-    publicPaths: ['./public'],
-    services: [],
-    listenCallback: undefined,
-    encoding: ENCODINGS.json,
-    ssl: null,
-    server: undefined,
-    corsOptions: undefined,
-};
-
-/**
- * Base HTTP Server
- * @param {RedWebOptions} options - Configuration options for RedWeb.
- * @return {Object} Express application instance.
- */
-function BaseHttpServer(options = {}) {
-    this.options = { ...HTTP_OPTIONS, ...options };
-    this.app = express() || this.options.server;
-    Object.assign(this, this.options);
-
-    // Middleware to parse request bodies based on the specified encoding
-    if (this.encoding === ENCODINGS.json) {
-        this.app.use(bodyParser.json());
-    } else if (this.encoding === ENCODINGS.urlencoded) {
-        this.app.use(bodyParser.urlencoded({ extended: true }));
-    }
-    this.app.use(cors(this.options.corsOptions));
-    this.publicPaths.forEach(public_path => this.app.use(express.static(path.join(process.cwd(), public_path))));
-    const catchAll = this.services.find((service) => service.serviceName === '*');
-    if (catchAll) this.services.splice(this.services.indexOf(catchAll), 1);
-    this.services.forEach(service => this.app[service.method](service.serviceName, service.function));
-    if (catchAll) this.app[catchAll.method](catchAll.serviceName, catchAll.function);
-    return this;
-}
-
-module.exports = {
-    BaseHttpServer,
-    ENCODINGS,
-    HTTP_OPTIONS,
-    METHODS: {GET: 'get', POST: 'post', PUT: 'put', DELETE: 'delete'}
-};
+const express = require('express');
+const bodyParser = require('body-parser');
+const path = require('path');
+const cors = require('cors');
+
+/**
+ * @typedef {'json' | 'urlencoded'} RedWebEncoding
+ */
+
+/**
+ * RedWeb options object.
+ * @typedef {Object} RedWebOptions
+ * @property {number} [port=80] - The port number to bind the server.
+ * @property {string} [bind='0.0.0.0'] - The bind address for the server.
+ * @property {string[]} [publicPaths=['./public']] - An array of paths to serve static files from.
+ * @property {Array<{serviceName: string, method: string, function: Function}>} [services=[]] - An array of services with their endpoints and handlers.
+ * @property {Function} [listenCallback] - Callback function to execute once the server starts listening.
+ * @property {RedWebEncoding} [encoding='json'] - The encoding type for the request bodies ('json' or 'urlencoded').
+ * @property {Object} [ssl] - SSL configuration for HTTPS server.
+ * @property {string} [ssl.key] - Path to the SSL key file.
+ * @property {string} [ssl.cert] - Path to the SSL certificate file.
+ * @property {import('express').Application} [server] - Whether to automatically start listening.
+ * @property {import('cors').CorsOptions} [corsOptions] - The CORS Options.
+ */
+
+const ENCODINGS = { json: 'json', urlencoded: 'urlencoded' };
+const HTTP_OPTIONS = {
+    port: 80,
+    bind: '0.0.0.0',
+    publicPaths: ['./public'],
+    services: [],
+    listenCallback: undefined,
+    encoding: ENCODINGS.json,
+    ssl: null,
+    server: undefined,
+    corsOptions: undefined,
+};
+
+/**
+ * Base HTTP Server
+ * @param {RedWebOptions} options - Configuration options for RedWeb.
+ * @return {Object} Express application instance.
+ */
+function BaseHttpServer(options = {}) {
+    this.options = { ...HTTP_OPTIONS, ...options };
+    this.app = express() || this.options.server;
+    Object.assign(this, this.options);
+
+    // Middleware to parse request bodies based on the specified encoding
+    if (this.encoding === ENCODINGS.json) {
+        this.app.use(bodyParser.json());
+    } else if (this.encoding === ENCODINGS.urlencoded) {
+        this.app.use(bodyParser.urlencoded({ extended: true }));
+    }
+    this.app.use(cors(this.options.corsOptions));
+    this.publicPaths.forEach(public_path => this.app.use(express.static(path.join(process.cwd(), public_path))));
+    const catchAll = this.services.find((service) => service.serviceName === '*');
+    if (catchAll) this.services.splice(this.services.indexOf(catchAll), 1);
+    this.services.forEach(service => this.app[service.method](service.serviceName, service.function));
+    if (catchAll) this.app[catchAll.method](catchAll.serviceName, catchAll.function);
+    return this;
+}
+
+module.exports = {
+    BaseHttpServer,
+    ENCODINGS,
+    HTTP_OPTIONS,
+    METHODS: {GET: 'get', POST: 'post', PUT: 'put', DELETE: 'delete'}
+};

package/src/http/HttpServer.js

@@ -1,14 +1,14 @@
-const { BaseHttpServer } = require('./BaseHttpServer');
-
-/**
- * HTTP Server
- * @param {RedWebOptions} options - Configuration options for RedWeb.
- * @return {Object} Express application instance.
- */
-function HttpServer(options = {}) {
-    BaseHttpServer.call(this, options);
-    this.server = this.app.listen(this.port, this.listenCallback ? this.listenCallback : () => console.log(`RedWeb HttpServer listening on port ${this.port}`));
-    return this;
-}
-
-module.exports = HttpServer;
+const { BaseHttpServer } = require('./BaseHttpServer');
+
+/**
+ * HTTP Server
+ * @param {RedWebOptions} options - Configuration options for RedWeb.
+ * @return {Object} Express application instance.
+ */
+function HttpServer(options = {}) {
+    BaseHttpServer.call(this, options);
+    this.server = this.app.listen(this.port, this.listenCallback ? this.listenCallback : () => console.log(`RedWeb HttpServer listening on port ${this.port}`));
+    return this;
+}
+
+module.exports = HttpServer;

package/src/http/HttpsServer.js

@@ -1,17 +1,17 @@
-const https = require('https');
-const { BaseHttpServer } = require('./BaseHttpServer');
-const loadSslConfig = require('../sslConfig');
-
-/**
- * HTTPS Server
- * @param {RedWebOptions} options - Configuration options for RedWeb.
- * @return {Object} Express application instance.
- */
-function HttpsServer(options = {}) {
-    BaseHttpServer.call(this, options);
-    const sslOptions = loadSslConfig(this.ssl);
-    https.createServer(sslOptions, this.app).listen(this.port, this.listenCallback ? this.listenCallback : () => console.log(`RedWeb HttpsServer listening on port ${this.port}`));
-    return this;
-}
-
-module.exports = HttpsServer;
+const https = require('https');
+const { BaseHttpServer } = require('./BaseHttpServer');
+const loadSslConfig = require('../sslConfig');
+
+/**
+ * HTTPS Server
+ * @param {RedWebOptions} options - Configuration options for RedWeb.
+ * @return {Object} Express application instance.
+ */
+function HttpsServer(options = {}) {
+    BaseHttpServer.call(this, options);
+    const sslOptions = loadSslConfig(this.ssl);
+    https.createServer(sslOptions, this.app).listen(this.port, this.listenCallback ? this.listenCallback : () => console.log(`RedWeb HttpsServer listening on port ${this.port}`));
+    return this;
+}
+
+module.exports = HttpsServer;

package/src/http/index.js

@@ -1,2 +1,2 @@
-const { METHODS } = require('./BaseHttpServer');
+const { METHODS } = require('./BaseHttpServer');
 module.exports = { HttpServer: require('./HttpServer'), HttpsServer: require('./HttpsServer'), METHODS}

package/src/sslConfig.js

@@ -1,20 +1,20 @@
-const fs = require('fs');
-
-/**
- * Load SSL configuration
- * @param {Object} sslOptions - The SSL options object containing the paths to key and cert files.
- * @param {string} sslOptions.key - Path to the SSL key file.
- * @param {string} sslOptions.cert - Path to the SSL certificate file.
- * @return {Object} - The loaded SSL options containing key and cert.
- */
-function loadSslConfig(sslOptions) {
-    if (!sslOptions || !sslOptions.key || !sslOptions.cert) {
-        throw new Error('SSL key and certificate paths must be provided');
-    }
-    return {
-        key: fs.readFileSync(sslOptions.key),
-        cert: fs.readFileSync(sslOptions.cert)
-    };
-}
-
-module.exports = loadSslConfig;
+const fs = require('fs');
+
+/**
+ * Load SSL configuration
+ * @param {Object} sslOptions - The SSL options object containing the paths to key and cert files.
+ * @param {string} sslOptions.key - Path to the SSL key file.
+ * @param {string} sslOptions.cert - Path to the SSL certificate file.
+ * @return {Object} - The loaded SSL options containing key and cert.
+ */
+function loadSslConfig(sslOptions) {
+    if (!sslOptions || !sslOptions.key || !sslOptions.cert) {
+        throw new Error('SSL key and certificate paths must be provided');
+    }
+    return {
+        key: fs.readFileSync(sslOptions.key),
+        cert: fs.readFileSync(sslOptions.cert)
+    };
+}
+
+module.exports = loadSslConfig;

package/src/ws/BaseHandler.js

@@ -1,93 +1,98 @@
-/**
- * Represents the base class for a WebSocket message handler.
- */
-class BaseHandler {
-    /**
-     * Creates a new handler instance.
-     * @param {{ name: string, handlers: Record<string, (socket: WebSocket, data: object) => void> }} config
-     * - `name`: The unique name of the handler.
-     * - `handlers`: A dictionary of message types and their corresponding handler functions.
-     */
-    constructor(config) {
-        /**
-         * The name of the handler (used to identify this handler in the server).
-         * @type {string}
-         */
-        this.name = config.name;
-
-        /**
-         * The dictionary of message handlers for this handler.
-         * @type {Record<string, (socket: WebSocket, data: object) => void>}
-         */
-        this.messageHandlers = config.handlers || {};
-
-        /**
-         * The list of active WebSocket connections managed by this handler.
-         * @type {WebSocket[]}
-         */
-        this.connections = [];
-    }
-
-    handleSocketMessages(socket) {
-        socket.on('message', (message) => this.handleMessage(socket, message));
-    }
-
-    handleSocketClose(socket) {
-        socket.on('close', () => {
-            this.connections = this.connections.filter((conn) => conn !== socket);
-            console.log(`Connection closed for handler "${this.name}".`);
-        });
-    }
-
-    handleNewConnection(socket) {
-        this.connections.push(socket);
-        this.handleSocketMessages(socket);
-        this.handleSocketClose(socket);
-        socket.isAssigned = true;
-        console.log(`New connection added to handler "${this.name}".`);
-    }
-
-    /**
-     * Adds a new WebSocket connection and sets up message handling for this handler.
-     * @param {WebSocket} socket - The WebSocket connection to add.
-     */
-    newConnection(socket, data) {
-        console.log(`Received newConnection data ${data}`);
-        this.handleNewConnection(socket);
-    }
-
-    /**
-     * Handles an incoming message and routes it to the appropriate handler function.
-     * @param {WebSocket} socket - The WebSocket connection that sent the message.
-     * @param {string} message - The incoming message in JSON string format.
-     */
-    handleMessage(socket, message) {
-        try {
-            const parsedMessage = JSON.parse(message);
-            const { type, ...data } = parsedMessage;
-
-            if (this.messageHandlers[type]) {
-                this.messageHandlers[type](socket, data);
-            } else {
-                console.warn(`Unhandled message type: "${type}" in handler "${this.name}".`);
-                socket.close();
-            }
-        } catch (error) {
-            console.error(`Error processing message in handler "${this.name}":`, error);
-        }
-    }
-
-    /**
-     * Broadcasts a message to all connections managed by this handler.
-     * @param {object} message - The message to broadcast.
-     */
-    broadcast(message) {
-        this.connections.forEach((socket) => {
-            if (socket.readyState === WebSocket.OPEN) {
-                socket.send(JSON.stringify(message));
-            }
-        });
-    }
-}
-
-module.exports = { BaseHandler };
+/**
+ * Represents the base class for a WebSocket message handler.
+ */
+class BaseHandler {
+    /**
+     * Creates a new handler instance.
+     * @param {{ name: string, handlers: Record<string, (socket: WebSocket, data: object) => void> }} config
+     * - `name`: The unique name of the handler.
+     * - `handlers`: A dictionary of message types and their corresponding handler functions.
+     */
+    constructor(config) {
+        /**
+         * The name of the handler (used to identify this handler in the server).
+         * @type {string}
+         */
+        this.name = config.name;
+
+        /**
+         * The dictionary of message handlers for this handler.
+         * @type {Record<string, (socket: WebSocket, data: object) => void>}
+         */
+        this.messageHandlers = config.handlers || {};
+
+        /**
+         * The list of active WebSocket connections managed by this handler.
+         * @type {WebSocket[]}
+         */
+        this.connections = [];
+    }
+
+    handleSocketMessages(socket) {
+        socket.on('message', (message) => this.handleMessage(socket, message));
+    }
+
+    handleSocketClose(socket) {
+        socket.on('close', () => {
+            this.onClose(socket);
+            this.connections = this.connections.filter((conn) => conn !== socket);
+            console.log(`Connection closed for handler "${this.name}".`);
+        });
+    }
+
+    handleNewConnection(socket) {
+        this.connections.push(socket);
+        this.handleSocketMessages(socket);
+        this.handleSocketClose(socket);
+        socket.isAssigned = true;
+        console.log(`New connection added to handler "${this.name}".`);
+    }
+
+    /**
+     * Adds a new WebSocket connection and sets up message handling for this handler.
+     * @param {WebSocket} socket - The WebSocket connection to add.
+     */
+    newConnection(socket, data) {
+        console.log(`Received newConnection data ${JSON.stringify(data)}`);
+        this.handleNewConnection(socket);
+    }
+
+    onClose(socket) {
+        console.log(`Closing socket ${socket.remoteAddress}`);
+    }
+
+    /**
+     * Handles an incoming message and routes it to the appropriate handler function.
+     * @param {WebSocket} socket - The WebSocket connection that sent the message.
+     * @param {string} message - The incoming message in JSON string format.
+     */
+    handleMessage(socket, message) {
+        try {
+            const parsedMessage = JSON.parse(message);
+            const { type, ...data } = parsedMessage;
+
+            if (this.messageHandlers[type]) {
+                this.messageHandlers[type](socket, data);
+            } else {
+                console.warn(`Unhandled message type: "${type}" in handler "${this.name}".`);
+                socket.close();
+            }
+        } catch (error) {
+            console.error(`Error processing message in handler "${this.name}":`, error);
+        }
+    }
+
+    /**
+     * Broadcasts a message to all connections managed by this handler.
+     * @param {object} message - The message to broadcast.
+     */
+    broadcast(message) {
+        this.connections.forEach((socket) => {
+            if (socket.readyState === WebSocket.OPEN) {
+                socket.send(JSON.stringify(message));
+            }
+        });
+    }
+}
+
+module.exports = { BaseHandler };