added jsdoc

src/methods/allow.js

@@ -3,6 +3,12 @@ const {promisify} = require("util");
 const promisifiedExec = promisify(exec);
 const util = require("../Util");
 
+/**
+  * Allow incoming requests through specific port. (root/sudo access is mandatory)
+  * @param {number} port The connection pange. From range 1 - 65535.
+  * @param {"udp" | "tcp" | undefined} protocol The protocol.
+  * @returns {Promise<Boolean>} Returns a boolean.
+*/
 module.exports.port = async function (port, protocol) {
   try {
     if (!port) throw new Error("Missing port input.");
@@ -37,6 +43,13 @@ module.exports.port = async function (port, protocol) {
   };
 };
 
+/**
+  * Allow incoming requests through specific (IP) address. (root/sudo access is mandatory)
+  * @param {string} address IP address, supported by subnet/net mask. From range 0.0.0.0 to 255.255.255.255
+  * @param {number | undefined} port The connection pange. From range 1 - 65535.
+  * @param {"udp" | "tcp" | undefined} protocol The protocol.
+  * @returns {Promise<Boolean>} Returns a boolean.
+*/
 module.exports.address = async function (address, port, protocol) {
   try {
     // address validation

src/methods/deny.js

@@ -3,6 +3,12 @@ const {promisify} = require("util");
 const promisifiedExec = promisify(exec);
 const util = require("../Util");
 
+/**
+  * Deny incoming requests through specific port. (root/sudo access is mandatory)
+  * @param {number} port The connection pange. From range 1 - 65535.
+  * @param {"udp" | "tcp" | undefined} protocol The protocol.
+  * @returns {Promise<Boolean>} Returns a boolean.
+*/
 module.exports.port = async function (port, protocol) {
   try {
     if (!port) throw new Error("Missing port input.");
@@ -37,6 +43,13 @@ module.exports.port = async function (port, protocol) {
   };
 };
 
+/**
+  * Deny incoming requests through specific (IP) address. (root/sudo access is mandatory)
+  * @param {string} address IP address, supported by subnet/net mask. From range 0.0.0.0 to 255.255.255.255
+  * @param {number | undefined} port The connection pange. From range 1 - 65535.
+  * @param {"udp" | "tcp" | undefined} protocol The protocol.
+  * @returns {Promise<Boolean>} Returns a boolean.
+*/
 module.exports.address = async function (address, port, protocol) {
   try {
     // address validation

src/methods/disable.js

@@ -2,7 +2,10 @@ const {exec} = require("child_process");
 const {promisify} = require("util");
 const promisifiedExec = promisify(exec);
 
-// disable
+/**
+  * Disable ufw. (root/sudo access is mandatory)
+  * @returns {Promise<Boolean>} Returns a boolean.
+*/
 module.exports.disable = async function() {
   try {
     let res = await promisifiedExec(`echo "y" | sudo ufw disable`);

src/methods/enable.js

@@ -2,6 +2,10 @@ const {exec} = require("child_process");
 const {promisify} = require("util");
 const promisifiedExec = promisify(exec);
 
+/**
+  * Enable ufw. (root/sudo access is mandatory)
+  * @returns {Promise<Boolean>} Returns a boolean.
+*/
 module.exports.enable = async function() {
   try {
     // https://serverfault.com/a/790150

src/methods/status.js

@@ -2,7 +2,12 @@ const {exec} = require("child_process");
 const {promisify} = require("util");
 const promisifiedExec = promisify(exec);
 
-module.exports = function(raw) {
+/**
+  * List of currently activated ufw. (root/sudo access is mandatory)
+  * @param {boolean} [raw=false] A raw version of "ufw status"
+  * @returns {Promise<string | {to: string, action: string, from: string}[]>} Returns a string if "raw" param is included, otherwise a list of array with to/action/from.
+*/
+module.exports = async function(raw) {
   if (raw && typeof raw !== "boolean") {
     throw new Error("The raw must be type of boolean.");
   };