redweb 0.6.2 → 0.6.4

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2024 Arkam Mazrui
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+MIT License
+
+Copyright (c) 2024 Arkam Mazrui
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.

package/index.d.ts

@@ -1,199 +1,205 @@
-declare module 'redweb' {
-    import { Request, Response } from 'express';
-    import { Server as HTTPServer } from 'http';
-    import { Server as HTTPSServer } from 'https';
-    import WebSocket from 'ws';
-
-    /**
-     * RedWeb encoding types.
-     */
-    export type RedWebEncoding = 'json' | 'urlencoded';
-
-    /**
-     * Service configuration for RedWeb.
-     */
-    export interface Service {
-        serviceName: string;
-        method: 'get' | 'post' | 'put' | 'delete' | 'patch' | 'options' | 'head';
-        function: (req: Request, res: Response) => void;
-    }
-
-    /**
-     * Options for configuring a RedWeb server.
-     */
-    export interface RedWebOptions {
-        port?: number;
-        bind?: string;
-        publicPaths?: string[];
-        services?: Service[];
-        listenCallback?: () => void;
-        encoding?: RedWebEncoding;
-        ssl?: {
-            key: string;
-            cert: string;
-        };
-    }
-
-    /**
-     * Configuration for a WebSocket handler.
-     */
-    export interface HandlerConfig {
-        name: string;
-        handlers: {
-            [type: string]: (socket: WebSocket, data: any) => void;
-        };
-    }
-
-    /**
-     * Options for configuring a WebSocket server.
-     */
-    export interface SocketServerOptions {
-        port?: number;
-        connectionOpenCallback?: (socket: WebSocket) => void;
-        connectionCloseCallback?: (socket: WebSocket) => void;
-        messageCallback?: (socket: WebSocket, message: string) => void;
-        messageHandlers?: {
-            [type: string]: (socket: WebSocket, data: any) => void;
-        };
-        ssl?: {
-            key: string;
-            cert: string;
-        };
-        handlerConfig?: Array<new () => BaseHandler>;
-    }
-
-    /**
-     * Base class for WebSocket handlers.
-     */
-    export class BaseHandler {
-        /**
-         * The name of the handler (used to identify it in the server).
-         */
-        name: string;
-
-        /**
-         * Dictionary of message handlers for this handler.
-         */
-        messageHandlers: {
-            [type: string]: (socket: WebSocket, data: any) => void;
-        };
-
-        /**
-         * List of active WebSocket connections managed by this handler.
-         */
-        connections: WebSocket[];
-
-        /**
-         * Creates a new handler instance.
-         * @param config - Configuration for the handler.
-         */
-        constructor(config: HandlerConfig);
-
-        /**
-         * Adds a new WebSocket connection, processes initial data, and sets up message handling for this handler.
-         * @param socket - The WebSocket connection to add.
-         * @param data - Optional initial data sent during the connection handshake.
-         */
-        newConnection(socket: WebSocket, data?: any): void;
-
-        /**
-         * Handles an incoming message and routes it to the appropriate handler function.
-         * @param socket - The WebSocket connection that sent the message.
-         * @param message - The incoming message in JSON string format.
-         */
-        handleMessage(socket: WebSocket, message: string): void;
-
-        /**
-         * Broadcasts a message to all connections managed by this handler.
-         * @param message - The message to broadcast.
-         */
-        broadcast(message: object): void;
-    }
-
-    /**
-     * Base WebSocket server class.
-     */
-    export class BaseSocketServer {
-        /**
-         * Map of connected WebSocket clients by their IP address.
-         */
-        clients: Map<string, WebSocket>;
-
-        /**
-         * List of handler instances currently registered with the server.
-         */
-        handlers: BaseHandler[];
-
-        constructor(server: HTTPServer | HTTPSServer, options?: SocketServerOptions);
-
-        /**
-         * Adds a new handler to the WebSocket server.
-         * @param HandlerClass - A class extending `BaseHandler` to add to the server.
-         */
-        addHandler(HandlerClass: new () => BaseHandler): void;
-    }
-
-    /**
-     * HTTP server class.
-     */
-    export class HttpServer {
-        constructor(options?: RedWebOptions);
-    }
-
-    /**
-     * HTTPS server class.
-     */
-    export class HttpsServer {
-        constructor(options?: RedWebOptions);
-    }
-
-    /**
-     * WebSocket server class.
-     */
-    export class SocketServer extends BaseSocketServer {
-        constructor(options?: SocketServerOptions);
-    }
-
-    /**
-     * Secure WebSocket server class.
-     */
-    export class SecureSocketServer extends BaseSocketServer {
-        constructor(options?: SocketServerOptions);
-    }
-
-    /**
-     * SSL configuration loader.
-     */
-    export function loadSslConfig(sslOptions: { key: string; cert: string }): { key: string; cert: string };
-
-    /**
-     * Constants for encoding types.
-     */
-    export const ENCODINGS: {
-        json: 'json';
-        urlencoded: 'urlencoded';
-    };
-
-    /**
-     * Constants for HTTP methods.
-     */
-    export const METHODS: {
-        POST: 'post';
-        GET: 'get';
-        PUT: 'put';
-        DELETE: 'delete';
-        PATCH: 'patch';
-        OPTIONS: 'options';
-        HEAD: 'head';
-    };
-
-    /**
-     * Default HTTP options.
-     */
-    export const HTTP_OPTIONS: RedWebOptions;
-
-    /**
-     * Default socket options.
-     */
-    export const SOCKET_OPTIONS: SocketServerOptions;
-}
+declare module 'redweb' {
+    import { Request, Response } from 'express';
+    import { Server as HTTPServer } from 'http';
+    import { Server as HTTPSServer } from 'https';
+    import WebSocket from 'ws';
+
+    /**
+     * RedWeb encoding types.
+     */
+    export type RedWebEncoding = 'json' | 'urlencoded';
+
+    /**
+     * Service configuration for RedWeb.
+     */
+    export interface Service {
+        serviceName: string;
+        method: 'get' | 'post' | 'put' | 'delete' | 'patch' | 'options' | 'head';
+        function: (req: Request, res: Response) => void;
+    }
+
+    /**
+     * Options for configuring a RedWeb server.
+     */
+    export interface RedWebOptions {
+        port?: number;
+        bind?: string;
+        publicPaths?: string[];
+        services?: Service[];
+        listenCallback?: () => void;
+        encoding?: RedWebEncoding;
+        ssl?: {
+            key: string;
+            cert: string;
+        };
+    }
+
+    /**
+     * Configuration for a WebSocket handler.
+     */
+    export interface HandlerConfig {
+        name: string;
+        handlers: {
+            [type: string]: (socket: WebSocket, data: any) => void;
+        };
+    }
+
+    /**
+     * Options for configuring a WebSocket server.
+     */
+    export interface SocketServerOptions {
+        port?: number;
+        connectionOpenCallback?: (socket: WebSocket) => void;
+        connectionCloseCallback?: (socket: WebSocket) => void;
+        messageCallback?: (socket: WebSocket, message: string) => void;
+        messageHandlers?: {
+            [type: string]: (socket: WebSocket, data: any) => void;
+        };
+        ssl?: {
+            key: string;
+            cert: string;
+        };
+        handlerConfig?: Array<new () => BaseHandler>;
+    }
+
+    /**
+     * Base class for WebSocket handlers.
+     */
+    export class BaseHandler {
+        /**
+         * The name of the handler (used to identify it in the server).
+         */
+        name: string;
+
+        /**
+         * Dictionary of message handlers for this handler.
+         */
+        messageHandlers: {
+            [type: string]: (socket: WebSocket, data: any) => void;
+        };
+
+        /**
+         * List of active WebSocket connections managed by this handler.
+         */
+        connections: WebSocket[];
+
+        /**
+         * Creates a new handler instance.
+         * @param config - Configuration for the handler.
+         */
+        constructor(config: HandlerConfig);
+
+        /**
+         * Adds a new WebSocket connection, processes initial data, and sets up message handling for this handler.
+         * @param socket - The WebSocket connection to add.
+         * @param data - Optional initial data sent during the connection handshake.
+         */
+        newConnection(socket: WebSocket, data?: any): void;
+
+        /**
+         * Method called when a WebSocket connection is closed. Can be overridden in subclasses.
+         * @param socket - The WebSocket connection being closed.
+         */
+        onClose(socket: WebSocket): void;
+
+        /**
+         * Handles an incoming message and routes it to the appropriate handler function.
+         * @param socket - The WebSocket connection that sent the message.
+         * @param message - The incoming message in JSON string format.
+         */
+        handleMessage(socket: WebSocket, message: string): void;
+
+        /**
+         * Broadcasts a message to all connections managed by this handler.
+         * @param message - The message to broadcast.
+         */
+        broadcast(message: object): void;
+    }
+
+    /**
+     * Base WebSocket server class.
+     */
+    export class BaseSocketServer {
+        /**
+         * Map of connected WebSocket clients by their IP address.
+         */
+        clients: Map<string, WebSocket>;
+
+        /**
+         * List of handler instances currently registered with the server.
+         */
+        handlers: BaseHandler[];
+
+        constructor(server: HTTPServer | HTTPSServer, options?: SocketServerOptions);
+
+        /**
+         * Adds a new handler to the WebSocket server.
+         * @param HandlerClass - A class extending `BaseHandler` to add to the server.
+         */
+        addHandler(HandlerClass: new () => BaseHandler): void;
+    }
+
+    /**
+     * HTTP server class.
+     */
+    export class HttpServer {
+        constructor(options?: RedWebOptions);
+    }
+
+    /**
+     * HTTPS server class.
+     */
+    export class HttpsServer {
+        constructor(options?: RedWebOptions);
+    }
+
+    /**
+     * WebSocket server class.
+     */
+    export class SocketServer extends BaseSocketServer {
+        constructor(options?: SocketServerOptions);
+    }
+
+    /**
+     * Secure WebSocket server class.
+     */
+    export class SecureSocketServer extends BaseSocketServer {
+        constructor(options?: SocketServerOptions);
+    }
+
+    /**
+     * SSL configuration loader.
+     */
+    export function loadSslConfig(sslOptions: { key: string; cert: string }): { key: string; cert: string };
+
+    /**
+     * Constants for encoding types.
+     */
+    export const ENCODINGS: {
+        json: 'json';
+        urlencoded: 'urlencoded';
+    };
+
+    /**
+     * Constants for HTTP methods.
+     */
+    export const METHODS: {
+        POST: 'post';
+        GET: 'get';
+        PUT: 'put';
+        DELETE: 'delete';
+        PATCH: 'patch';
+        OPTIONS: 'options';
+        HEAD: 'head';
+    };
+
+    /**
+     * Default HTTP options.
+     */
+    export const HTTP_OPTIONS: RedWebOptions;
+
+    /**
+     * Default socket options.
+     */
+    export const SOCKET_OPTIONS: SocketServerOptions;
+}

package/index.js

@@ -1,12 +1,12 @@
-const { HttpServer, HttpsServer, METHODS } = require('./src/http');
-const { SocketServer, SecureSocketServer, SOCKET_OPTIONS } = require('./src/ws');
-const { BaseHandler } = require('./src/ws/BaseHandler');
-module.exports = {
-    SocketServer,
-    SecureSocketServer,
-    BaseHandler,
-    HttpServer,
-    HttpsServer,
-    SOCKET_OPTIONS,
-    METHODS
-};
+const { HttpServer, HttpsServer, METHODS } = require('./src/http');
+const { SocketServer, SecureSocketServer, SOCKET_OPTIONS } = require('./src/ws');
+const { BaseHandler } = require('./src/ws/BaseHandler');
+module.exports = {
+    SocketServer,
+    SecureSocketServer,
+    BaseHandler,
+    HttpServer,
+    HttpsServer,
+    SOCKET_OPTIONS,
+    METHODS
+};

package/package.json

@@ -1,27 +1,27 @@
-{
-  "name": "redweb",
-  "version": "0.6.2",
-  "description": "A way to quickly set up an express server",
-  "main": "index.js",
-  "scripts": {
-    "test": "node tester.js"
-  },
-  "files": [
-    "src/*",
-    "index.d.ts"
-  ],
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "dependencies": {
-    "cors": "^2.8.5",
-    "express": "^4.19.2",
-    "ws": "^8.17.0"
-  },
-  "devDependencies": {
-    "@types/express": "^4.17.21",
-    "@types/jest": "^29.5.12",
-    "jest": "^29.7.0",
-    "supertest": "^7.0.0"
-  }
-}
+{
+  "name": "redweb",
+  "version": "0.6.4",
+  "description": "A way to quickly set up an express server",
+  "main": "index.js",
+  "scripts": {
+    "test": "node tester.js"
+  },
+  "files": [
+    "src/*",
+    "index.d.ts"
+  ],
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "cors": "^2.8.5",
+    "express": "^4.19.2",
+    "ws": "^8.17.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/jest": "^29.5.12",
+    "jest": "^29.7.0",
+    "supertest": "^7.0.0"
+  }
+}