@modular-rest/server 1.11.5 → 1.11.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modular-rest/server",
-  "version": "1.11.5",
+  "version": "1.11.7",
   "description": "a nodejs module based on KOAJS for developing Rest-APIs in a modular solution.",
   "main": "src/index.js",
   "scripts": {
@@ -10,7 +10,7 @@
   "types": "./types/index.d.ts",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/navidshad/modular-rest.git"
+    "url": "git+https://github.com/modular-rest/modular-rest.git"
   },
   "keywords": [
     "app",
@@ -21,9 +21,9 @@
   "author": "Navid Shad <navidshad72@gmail.com> (http://navid-shad.ir)",
   "license": "MIT",
   "bugs": {
-    "url": "https://github.com/navidshad/modular-rest/issues"
+    "url": "https://github.com/modular-rest/modular-rest/issues"
   },
-  "homepage": "https://github.com/navidshad/modular-rest#readme",
+  "homepage": "https://github.com/modular-rest/modular-rest#readme",
   "dependencies": {
     "@koa/cors": "^3.1.0",
     "colog": "^1.0.4",
@@ -32,8 +32,9 @@
     "keypair": "^1.0.4",
     "koa": "^2.5.3",
     "koa-body": "^4.2.0",
+    "koa-mount": "^4.0.0",
     "koa-router": "^7.4.0",
-    "koa-static-server": "^1.5.2",
+    "koa-static": "^5.0.0",
     "mongoose": "^5.10.9",
     "nested-property": "^4.0.0"
   },
@@ -43,4 +44,4 @@
     "@types/koa__cors": "^5.0.0",
     "typescript": "^5.3.3"
   }
-}
+}

package/src/application.js

@@ -1,7 +1,8 @@
 const koa = require("koa");
 const cors = require("@koa/cors");
 const koaBody = require("koa-body");
-const koaStatic = require("koa-static-server");
+const koaStatic = require("koa-static");
+const mount = require("koa-mount");
 const path = require("path");
 const Combination = require("./class/combinator");
 const DataProvider = require("./services/data_provider/service");
@@ -13,8 +14,8 @@ const defaultServiceRoot = __dirname + "/services";
  * @typedef {import('koa')} Koa
  * @typedef {import('http').Server} server
  * @typedef {import('@koa/cors').Options} Cors
- * @typedef {import('./class/security').PermissionGroup} PermissionGroup
- * @typedef {import('./class/database_trigger.js')} DatabaseTrigger
+ * @typedef {import('./class/security.js').PermissionGroup} PermissionGroup
+ * @typedef {import('./class/cms_trigger.js')} CmsTrigger
  */
 
 const { config, setConfig } = require("./config");
@@ -25,18 +26,19 @@ const { config, setConfig } = require("./config");
  *   cors?: Cors; // CORS options.
  *   modulesPath?: string; // Root directory of your router.js/db.js files.
  *   uploadDirectory?: string; // Root directory of your uploaded files.
- *   staticPath?: {
- *      rootDir?: string; // Root directory of your static files.
- *      rootPath?: string; // Root path of your static files.
- *      notFoundFile?: string; // Not found file.
- *      log?: boolean; // Log requests to console.
- *      last?: boolean; // Don't execute any downstream middleware.
- *      maxage?: number; // Browser cache max-age in milliseconds.
- *      hidden?: boolean; // Allow transfer of hidden files.
- *      gzip?: boolean; // Try to serve the gzipped version of a file automatically when gzip is supported by a client and if the requested file exists.
- *      brotli?: boolean; // Try to serve the brotli version of a file automatically when brotli is supported by a client and if the requested file exists.
- *      index?: string; // Index file.
- *   };
+ *   koaBodyOptions?: object; // Options for koa-body.
+ *    staticPath?: {
+ *        rootDir: string; // Root directory of your static files.
+ *        rootPath: string; // Root path of your static files, defaults to '/assets'.
+ *        maxage?: number; // Browser cache max-age in milliseconds. Defaults to 0.
+ *        hidden?: boolean; // Allow transfer of hidden files. Defaults to false.
+ *        index?: string; // Default file name. Defaults to 'index.html'.
+ *        defer?: boolean; // If true, serves after return next(), allowing any downstream middleware to respond first. Defaults to false.
+ *        gzip?: boolean; // Try to serve the gzipped version of a file automatically when gzip is supported by a client and if the requested file with .gz extension exists. Defaults to true.
+ *        br?: boolean; // Try to serve the brotli version of a file automatically when brotli is supported by a client and if the requested file with .br extension exists. Note that brotli is only accepted over https. Defaults to false.
+ *        setHeaders?: Function; // Function to set custom headers on response.
+ *        extensions?: boolean|Array; // Try to match extensions from passed array to search for file when no extension is suffixed in URL. First found is served. Defaults to false.
+ *    };
  *   onBeforeInit?: (koaApp:Koa) => void; // A callback called before initializing the Koa server.
  *   onAfterInit?: (koaApp:Koa) => void; // A callback called after server initialization.
  *   port?: number; // Server port.
@@ -57,7 +59,8 @@ const { config, setConfig } = require("./config");
  *   verificationCodeGeneratorMethod: () => string; // A method to return a verification code when registering a new user.
  *   collectionDefinitions?: CollectionDefinition[]; // An array of additional collection definitions.
  *   permissionGroups?: PermissionGroup[]; // An array of additional permission groups.
- *   authTriggers?: DatabaseTrigger[]; // An array of additional database triggers for the auth collection.
+ *   authTriggers?: CmsTrigger[]; // An array of additional database triggers for the auth collection.
+ *   fileTriggers?: CmsTrigger[]; // An array of additional database triggers for the auth collection.
  * }} options
  * @returns {Promise<{app: Koa, server: Server}>}
  */
@@ -90,6 +93,7 @@ async function createRest(options) {
    */
   const bodyParserOptions = {
     multipart: true,
+    ...(config.koaBodyOptions || {}),
   };
   app.use(koaBody(bodyParserOptions));
 
@@ -97,7 +101,18 @@ async function createRest(options) {
    * Plug In KoaStatic
    */
   if (config.staticPath) {
-    app.use(koaStatic(config.staticPath));
+    const defaultStaticPath = config.staticPath.rootDir;
+    const defaultStaticRootPath = config.staticPath.rootPath || "/assets";
+
+    delete config.staticPath.rootDir;
+    delete config.staticPath.rootPath;
+
+    app.use(
+      mount(
+        defaultStaticRootPath,
+        koaStatic(defaultStaticPath, config.staticPath)
+      )
+    );
   }
 
   /**

package/src/class/cms_trigger.js

@@ -0,0 +1,20 @@
+/**
+ * `CmsTrigger` is a class that defines a callback to be called on a specific database transaction.
+ *
+ * @class
+ */
+class CmsTrigger {
+  /**
+   * Creates a new instance of `CmsTrigger`.
+   *
+   * @param {'update-one' | 'insert-one' | 'remove-one' } operation - The operation to be triggered.
+   * @param {function({query: any, queryResult: any}): void} [callback=(context) => {}] - The callback to be called when the operation is executed. The callback function takes an object as parameter with two properties: 'query' and 'queryResult'.
+   * @constructor
+   */
+  constructor(operation, callback = (context) => {}) {
+    this.operation = operation;
+    this.callback = callback;
+  }
+}
+
+module.exports = CmsTrigger;

package/src/class/db_schemas.js

@@ -11,6 +11,7 @@ module.exports = {
       // Tag being used as the parent dir for files
       // uploadDir/$format/$tag/timestamp.format
       tag: String,
+      size: Number,
     },
     { timestamps: true }
   ),

package/src/class/paginator.js

@@ -6,8 +6,9 @@
  * @returns {Object} - An object containing pagination information.
  */
 function create(count, perPage, page) {
-  let totalPgaes = Math.ceil(count / perPage);
-  if (page > totalPgaes) page = 1;
+  const totalPages = Math.ceil(count / perPage);
+  
+  if (page > totalPages) page = 1;
 
   let from = 0;
   if (perPage == 1) from = page - 1;
@@ -16,7 +17,7 @@ function create(count, perPage, page) {
   if (page <= 1) from = 0;
 
   let result = {
-    'pages': totalPgaes,
+    'pages': totalPages,
     'page': page,
     'from': from,
     'to': perPage

package/src/class/reply.js

@@ -9,7 +9,7 @@ function create(status, detail = {}) {
 
     let result = detail || {};
 
-    // defin status
+    // define status
     switch (status) {
         case 's':
             result['status'] = 'success';

package/src/class/validator.js

@@ -8,13 +8,13 @@
 function validate(obj, requiredFields) {
     /*
         this method could validate an Object by given field's name list and return bool.
-        - requiredFields: is a string that contains keys being spareted by " ".
+        - requiredFields: is a string that contains keys being spared by " ".
     */
     let type = typeof requiredFields;
     let result;
 
     if (type == 'string')
-        result = ckeckSimple(obj, requiredFields);
+        result = checkSimple(obj, requiredFields);
     else if (type == 'object')
         result = checkComplex(obj, requiredFields);
 
@@ -25,7 +25,7 @@ function validate(obj, requiredFields) {
 
 module.exports = validate;
 
-function ckeckSimple(obj, requiredFields = '') {
+function checkSimple(obj, requiredFields = '') {
     let isValide = false;
     let requires = requiredFields.split(' ');
 

package/src/config.js

@@ -1,27 +1,28 @@
 /**
  * @typedef {import('koa')} Koa
  * @typedef {import('@koa/cors').Options} Cors
- * @typedef {import('./class/collection_definition')} CollectionDefinition
- * @typedef {import('./class/security').PermissionGroup} PermissionGroup
- * @typedef {import('./class/database_trigger.js')} DatabaseTrigger
+ * @typedef {import('./class/collection_definition.js')} CollectionDefinition
+ * @typedef {import('./class/security.js').PermissionGroup} PermissionGroup
+ * @typedef {import('./class/cms_trigger.js')} CmsTrigger
  */
 
 /**
  * @typedef {{
  *   cors?: Cors; // CORS options.
  *   modulesPath?: string; // Root directory of your router.js/db.js files.
- *   staticPath?: {
- *      rootDir?: string; // Root directory of your static files.
- *      rootPath?: string; // Root path of your static files.
- *      notFoundFile?: string; // Not found file.
- *      log?: boolean; // Log requests to console.
- *      last?: boolean; // Don't execute any downstream middleware.
- *      maxage?: number; // Browser cache max-age in milliseconds.
- *      hidden?: boolean; // Allow transfer of hidden files.
- *      gzip?: boolean; // Try to serve the gzipped version of a file automatically when gzip is supported by a client and if the requested file exists.
- *      brotli?: boolean; // Try to serve the brotli version of a file automatically when brotli is supported by a client and if the requested file exists.
- *      index?: string; // Index file.
- *   };
+ *   koaBodyOptions?: object; // Options for koa-body.
+ *    staticPath?: {
+ *        rootDir: string; // Root directory of your static files.
+ *        rootPath: string; // Root path of your static files, defaults to '/assets'.
+ *        maxage?: number; // Browser cache max-age in milliseconds. Defaults to 0.
+ *        hidden?: boolean; // Allow transfer of hidden files. Defaults to false.
+ *        index?: string; // Default file name. Defaults to 'index.html'.
+ *        defer?: boolean; // If true, serves after return next(), allowing any downstream middleware to respond first. Defaults to false.
+ *        gzip?: boolean; // Try to serve the gzipped version of a file automatically when gzip is supported by a client and if the requested file with .gz extension exists. Defaults to true.
+ *        br?: boolean; // Try to serve the brotli version of a file automatically when brotli is supported by a client and if the requested file with .br extension exists. Note that brotli is only accepted over https. Defaults to false.
+ *        setHeaders?: Function; // Function to set custom headers on response.
+ *        extensions?: boolean|Array; // Try to match extensions from passed array to search for file when no extension is suffixed in URL. First found is served. Defaults to false.
+ *    };
  *   onBeforeInit?: (koaApp:Koa) => void; // A callback called before initializing the Koa server.
  *   onAfterInit?: (koaApp:Koa) => void; // A callback called after server initialization.
  *   port?: number; // Server port.
@@ -43,6 +44,7 @@
  *   collectionDefinitions?: CollectionDefinition[]; // An array of additional collection definitions.
  *   permissionGroups?: PermissionGroup[]; // An array of additional permission groups.
  *   authTriggers?: DatabaseTrigger[]; // An array of additional database triggers for the auth collection.
+ *   fileTriggers?: CmsTrigger[]; // An array of additional database triggers for the auth collection.
  * }} Config
  * @exports Config
  */

package/src/index.js

@@ -9,36 +9,58 @@ const validator = require("./class/validator");
 const { getCollection } = require("./services/data_provider/service");
 const { defineFunction } = require("./services/functions/service");
 const TypeCasters = require("./services/data_provider/typeCasters");
+const userManager = require("./services/user_manager/service");
+const {
+  getFile,
+  getFileLink,
+  getFilePath,
+  removeFile,
+  storeFile,
+} = require("./services/file/service");
 
 // Base class
 const CollectionDefinition = require("./class/collection_definition");
 const Schemas = require("./class/db_schemas");
 const DatabaseTrigger = require("./class/database_trigger");
+const CmsTrigger = require("./class/cms_trigger");
 const SecurityClass = require("./class/security");
 const middleware = require("./middlewares");
-const userManager = require("./services/user_manager/service");
 
 module.exports = {
   createRest,
 
-  // Route utilities
-  reply,
-  TypeCasters,
-  paginator,
-  validator,
-
-  // Service utilities
-  getCollection,
-  defineFunction,
-
   // Database
   CollectionDefinition,
   Schemas,
   Schema,
   DatabaseTrigger,
+  CmsTrigger,
   ...SecurityClass,
 
-  // Middlewares
+  // Function
+  defineFunction,
+
+  // Private utilities
+  TypeCasters,
+  validator,
+
+  // Route utilities
+  reply,
+  paginator,
+
+  // Database utilities
+  getCollection,
+
+  // File Utilities
+  getFile,
+  getFileLink,
+  getFilePath,
+  removeFile,
+  storeFile,
+
+  // Middleware utilities
   middleware,
+
+  // User utilities
   userManager: userManager.main,
 };

package/src/services/data_provider/typeCasters.js

@@ -1,9 +1,10 @@
-let Mongoose = require('mongoose');
+const Mongoose = require('mongoose');
+
 module.exports = {
   'ObjectId': Mongoose.Types.ObjectId,
   'Date': (dateValue) => {
-      let strDate = dateValue.toString();
-      let mongoDateFormateInString = new Date(strDate).toISOString().split('T')[0];
+      const strDate = dateValue.toString();
+      const mongoDateFormateInString = new Date(strDate).toISOString().split('T')[0];
       return new Date(mongoDateFormateInString);
   }
 }

package/src/services/file/db.js

@@ -1,27 +1,29 @@
-var mongoose = require('mongoose');
-var Schemas = require('../../class/db_schemas');
+var mongoose = require("mongoose");
+var Schemas = require("../../class/db_schemas");
 
-let CollectionDefinition = require('../../class/collection_definition');
-let { Permission, PermissionTypes } = require('../../class/security');
+let CollectionDefinition = require("../../class/collection_definition");
+let { Permission, PermissionTypes } = require("../../class/security");
+const { config } = require("../../config");
 
 module.exports = [
-    new CollectionDefinition({
-        db: 'cms',
-        collection: 'file',
-        schema: Schemas.file,
-        permissions: [
-            new Permission({
-                type: PermissionTypes.upload_file_access,
-                read: true,
-                write: true,
-                onlyOwnData: false,
-            }),
-            new Permission({
-                type: PermissionTypes.remove_file_access,
-                read: true,
-                write: true,
-                onlyOwnData: false,
-            }),
-        ],
-    }),
-]
+  new CollectionDefinition({
+    db: "cms",
+    collection: "file",
+    schema: Schemas.file,
+    permissions: [
+      new Permission({
+        type: PermissionTypes.upload_file_access,
+        read: true,
+        write: true,
+        onlyOwnData: false,
+      }),
+      new Permission({
+        type: PermissionTypes.remove_file_access,
+        read: true,
+        write: true,
+        onlyOwnData: false,
+      }),
+    ],
+    triggers: config.fileTriggers || [],
+  }),
+];

package/src/services/file/service.js

@@ -1,9 +1,10 @@
-const fs = require('file-system');
-const pathModule = require('path');
-const DataProvider = require('./../data_provider/service')
+const fs = require("file-system");
+const pathModule = require("path");
+const DataProvider = require("./../data_provider/service");
+const triggerService = require("./../../class/trigger_operator");
+const { config } = require("./../../config");
 
 class FileService {
-
   constructor() {
     this.directory = null;
   }
@@ -13,9 +14,10 @@ class FileService {
   }
 
   /**
-   * 
-   * @param {string} fileType 
-   * 
+   *
+   * @param {string} fileType
+   * @param {string} tag
+   *
    * @returns storedFile
    * @returns storedFile.fileName
    * @returns storedFile.directory
@@ -23,119 +25,207 @@ class FileService {
    * @returns storedFile.fileFormat
    */
   createStoredDetail(fileType, tag) {
+    const typeParts = fileType.split("/");
+    const fileFormat = typeParts[1] || typeParts[0] || "unknown";
+
+    const time = new Date().getTime();
+    const fileName = `${time}.${fileFormat}`;
 
-    let time = new Date().getTime();
-    let fileFormat = fileType.split('/')[1];
-    let fileName = `${time}.${fileFormat}`;
-    let fullPath = pathModule.join(this.directory, fileFormat, tag, fileName);
+    const fullPath = pathModule.join(
+      FileService.instance.directory,
+      fileFormat,
+      tag,
+      fileName
+    );
 
     return { fileName, fullPath, fileFormat };
   }
 
-
   /**
-   * 
-   * @param args
-   * @param {file} args.file file object
-   * @param {string} args.ownerId file object
+   * Stores a file, removes the given temporary file, and submits file details into the database.
+   *
+   * @param {Object} options - The options for storing the file.
+   * @param {Object} options.file - The file to be stored.
+   * @param {string} options.file.path - The path of the file.
+   * @param {string} options.file.type - The type of the file.
+   * @param {string} options.file.name - The original name of the file.
+   * @param {number} options.file.size - The size of the file.
+   * @param {string} options.ownerId - The ID of the owner of the file.
+   * @param {string} options.tag - The tag associated with the file.
+   * @param {boolean} [options.removeFileAfterStore=true] - Whether to remove the file after storing it.
+   *
+   * @returns {Promise} A promise that resolves with the document of the stored file.
+   *
+   * @throws {string} If the upload directory has not been set.
    */
-  storeFile({ file, ownerId, tag }) {
-
-    if (!this.directory)
-      throw 'upload directory has not been set.'
+  storeFile({ file, ownerId, tag, removeFileAfterStore = true }) {
+    if (!FileService.instance.directory)
+      throw "upload directory has not been set.";
 
     let storedFile;
 
-    return new Promise(async (done, reject) =>
-  /**
-   * Store file and remove temp file
-   */ {
-
-      storedFile = this.createStoredDetail(file.type, tag);
+    return (
+      new Promise(async (done, reject) => /**
+       * Store file and remove temp file
+       */ {
+        storedFile = FileService.instance.createStoredDetail(file.type, tag);
 
-      fs.copyFile(file.path, storedFile.fullPath, {
-        done: (err) => {
-          if (err) reject(err);
-          else done();
+        fs.copyFile(file.path, storedFile.fullPath, {
+          done: (err) => {
+            if (err) reject(err);
+            else done();
 
-          // remove temp file
-          fs.fs.unlinkSync(file.path);
-        }
-      });
-    })
-      /**
-       * Submit file detail into database
-       */
-      .then(() => {
-
-        // Get collection model for access to relative collection
-        let CollectionModel = DataProvider.getCollection('cms', 'file');
-
-        // Create new document
-        let doc = new CollectionModel({
-          owner: ownerId,
-          fileName: storedFile.fileName,
-          originalName: file.name,
-          format: storedFile.fileFormat,
-          tag,
+            // remove temp file
+            if (removeFileAfterStore) fs.fs.unlinkSync(file.path);
+          },
         });
-
-        return doc.save().then(() => doc);
-
-      }).catch(err => {
-
-        // remove stored file 
-        fs.fs.unlinkSync(storedFile.fullPath);
-
-        throw err;
       })
+        /**
+         * Submit file detail into database
+         */
+        .then(() => {
+          // Get collection model for access to relative collection
+          const CollectionModel = DataProvider.getCollection("cms", "file");
+
+          const data = {
+            owner: ownerId,
+            fileName: storedFile.fileName,
+            originalName: file.name,
+            format: storedFile.fileFormat,
+            tag,
+            size: file.size,
+          };
+
+          // Create new document
+          const doc = new CollectionModel(data);
+
+          return doc.save().then((savedDoc) => {
+            triggerService.call("insert-one", "cms", "file", {
+              query: null,
+              queryResult: savedDoc,
+            });
+
+            return savedDoc;
+          });
+        })
+        .catch((err) => {
+          // remove stored file
+          fs.fs.unlinkSync(storedFile.fullPath);
+
+          throw err;
+        })
+    );
   }
 
+  /**
+   * Removes a file from the disk.
+   *
+   * @param {string} path - The path of the file to be removed.
+   * @returns {Promise} A promise that resolves if the file is successfully removed, and rejects if an error occurs.
+   */
   removeFromDisc(path) {
     return new Promise((done, reject) => {
       fs.fs.unlink(path, (err) => {
-        if (err) reject()
-        else done()
+        if (err) reject();
+        else done();
       });
-    })
+    });
   }
 
+  /**
+   * Removes a file from the database and the disk.
+   *
+   * @param {string} fileId - The ID of the file to be removed.
+   * @returns {Promise} A promise that resolves if the file is successfully removed, and rejects if an error occurs.
+   * @throws Will throw an error if upload directory has not been set.
+   */
   removeFile(fileId) {
-
-    if (!this.directory)
-      throw 'upload directory has not been set.'
+    if (!FileService.instance.directory)
+      throw "upload directory has not been set.";
 
     return new Promise(async (done, reject) => {
-      let CollectionModel = DataProvider.getCollection('cms', 'file');
+      let CollectionModel = DataProvider.getCollection("cms", "file");
       let fileDoc = await CollectionModel.findOne({ _id: fileId }).exec();
 
       if (!fileDoc) {
-        reject('file not found');
+        reject("file not found");
         return;
       }
 
-      await CollectionModel.deleteOne({ _id: fileId }).exec()
+      await CollectionModel.deleteOne({ _id: fileId })
+        .exec()
         .then(() => {
-
           // create file path
-          let filePath = pathModule.join(this.directory, fileDoc.format, fileDoc.tag, fileDoc.fileName);
+          const filePath = pathModule.join(
+            FileService.instance.directory,
+            fileDoc.format,
+            fileDoc.tag,
+            fileDoc.fileName
+          );
 
           // Remove file from disc
-          return this.removeFromDisc(filePath)
+          return FileService.instance
+            .removeFromDisc(filePath)
             .catch(async (err) => {
-
-              // Recreate fileDoc if removing file operation has error 
+              // Recreate fileDoc if removing file operation has error
               await new CollectionModel(fileDoc).save();
 
               throw err;
-            })
-
+            });
+        })
+        .then(() => {
+          triggerService.call("remove-one", "cms", "file", {
+            query: { _id: fileId },
+            queryResult: null,
+          });
         })
         .then(done)
-        .catch(reject)
-    })
+        .catch(reject);
+    });
+  }
+
+  /**
+   * Retrieves a file from the database.
+   *
+   * @param {string} fileId - The ID of the file to be retrieved.
+   * @returns {Promise} A promise that resolves with the file document, or rejects if an error occurs.
+   */
+  getFile(fileId) {
+    const CollectionModel = DataProvider.getCollection("cms", "file");
+
+    return CollectionModel.findOne({ _id: fileId }).exec();
+  }
+
+  /**
+   * Retrieves the link of a file.
+   *
+   * @param {string} fileId - The ID of the file to get the link for.
+   * @returns {Promise} A promise that resolves with the file link, or rejects if an error occurs.
+   */
+  async getFileLink(fileId) {
+    const fileDoc = await FileService.instance.getFile(fileId);
+
+    const link =
+      config.staticPath.rootPath +
+      `/${fileDoc.format}/${fileDoc.tag}/` +
+      fileDoc.fileName;
+
+    return link;
+  }
+
+  async getFilePath(fileId) {
+    const { fileName, format, tag } = await FileService.instance.getFile(
+      fileId
+    );
+    const fullPath = pathModule.join(
+      FileService.instance.directory,
+      format,
+      tag,
+      fileName
+    );
+    return fullPath;
   }
 }
 
-FileService.instance = new FileService()
-module.exports = FileService.instance;
+FileService.instance = new FileService();
+module.exports = FileService.instance;

package/src/services/user_manager/service.js

@@ -14,18 +14,21 @@ class UserManager {
   }
 
   /**
-   * Set a custom method for generating verification codes.
-   * @param {function} method - A method that returns a random verification code.
+   * Sets a custom method for generating verification codes.
+   *
+   * @param {Function} generatorMethod - A function that returns a random verification code.
+   * @returns {void}
    */
-  setCustomVerificationCodeGeneratorMethod(method) {
-    this.verificationCodeGeneratorMethod = method;
+  setCustomVerificationCodeGeneratorMethod(generatorMethod) {
+    this.verificationCodeGeneratorMethod = generatorMethod;
   }
 
   /**
-   * Generate a verification code.
-   * @param {string} id - The ID for which to generate the verification code.
-   * @param {string} idType - The type of the ID.
-   * @returns {string} The generated verification code.
+   * Get a user by their ID.
+   *
+   * @param {string} id - The ID of the user.
+   * @returns {Promise<User>} A promise that resolves to the user.
+   * @throws {Error} If the user is not found.
    */
   generateVerificationCode(id, idType) {
     if (this.verificationCodeGeneratorMethod)
@@ -37,6 +40,7 @@ class UserManager {
 
   /**
    * Get a user by their ID.
+   *
    * @param {string} id - The ID of the user.
    * @returns {Promise<User>} A promise that resolves to the user.
    * @throws {string} If the user is not found.
@@ -63,6 +67,7 @@ class UserManager {
 
   /**
    * Get a user by their identity.
+   *
    * @param {string} id - The identity of the user.
    * @param {string} idType - The type of the identity (phone or email).
    * @returns {Promise<User>} A promise that resolves to the user.
@@ -95,6 +100,7 @@ class UserManager {
 
   /**
    * Get a user by their token.
+   *
    * @param {string} token - The token of the user.
    * @returns {Promise<User>} A promise that resolves to the user.
    */
@@ -105,6 +111,7 @@ class UserManager {
 
   /**
    * Check if a verification code is valid.
+   *
    * @param {string} id - The ID of the user.
    * @param {string} code - The verification code.
    * @returns {boolean} Whether the verification code is valid.
@@ -123,6 +130,7 @@ class UserManager {
 
   /**
    * Login a user and return their token.
+   *
    * @param {string} id - The ID of the user.
    * @param {string} idType - The type of the ID (phone or email).
    * @param {string} password - The password of the user.
@@ -172,6 +180,7 @@ class UserManager {
 
   /**
    * Issue a token for a user.
+   *
    * @param {string} email - The email of the user.
    * @returns {Promise<string>} A promise that resolves to the token of the user.
    * @throws {string} If the user is not found.
@@ -199,6 +208,7 @@ class UserManager {
 
   /**
    * Login as an anonymous user.
+   *
    * @returns {Promise<string>} A promise that resolves to the token of the anonymous user.
    * @throws {string} If the anonymous user is not found.
    */
@@ -245,6 +255,7 @@ class UserManager {
 
   /**
    * Register a temporary ID.
+   *
    * @param {string} id - The ID to register.
    * @param {string} type - The type of the ID.
    * @param {string} code - The verification code.
@@ -255,6 +266,7 @@ class UserManager {
 
   /**
    * Submit a password for a temporary ID.
+   *
    * @param {string} id - The ID.
    * @param {string} password - The password.
    * @param {string} code - The verification code.
@@ -285,6 +297,7 @@ class UserManager {
 
   /**
    * Change the password for a temporary ID.
+   *
    * @param {string} id - The ID.
    * @param {string} password - The new password.
    * @param {string} code - The verification code.
@@ -310,6 +323,7 @@ class UserManager {
 
   /**
    * Register a user.
+   *
    * @param {Object} detail - The details of the user.
    * @returns {Promise<string>} A promise that resolves to the ID of the new user.
    * @throws {string} If the user could not be registered.
@@ -342,6 +356,7 @@ class UserManager {
 
   /**
    * Change the password of a user.
+   *
    * @param {Object} query - The query to find the user.
    * @param {string} newPass - The new password.
    * @returns {Promise<void>} A promise that resolves when the operation is complete.

package/test.js

@@ -1,10 +0,0 @@
-const { createRest } = require('.');
-const { PermissionTypes } = require('./src/class/security');
-
-{ createRest } require('./src/application');
-{PermissionTypes} require('./src/class/security');
-
-createRest({
-    uploadDirectory: 'uploads',
-    port: '3001'
-});