not-node 6.0.4 → 6.0.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "not-node",
-  "version": "6.0.4",
+  "version": "6.0.6",
   "description": "node complimentary part for client side notFramework.",
   "main": "index.js",
   "scripts": {

package/src/exceptions/form.js

@@ -9,3 +9,15 @@ class FormExceptionExtractorForFieldIsUndefined extends notRequestError {
 
 module.exports.FormExceptionExtractorForFieldIsUndefined =
     FormExceptionExtractorForFieldIsUndefined;
+
+class FormExceptionTransformerForFieldIsUndefined extends notRequestError {
+    constructor(fieldName, instruction) {
+        super("not-node:form_exception_field_transformer_is_undefined", {
+            fieldName,
+            instruction,
+        });
+    }
+}
+
+module.exports.FormExceptionTransformerForFieldIsUndefined =
+    FormExceptionTransformerForFieldIsUndefined;

package/src/form/env_extractors/index.js

@@ -1,3 +1,7 @@
+/**
+ * Extracts specific environmental values
+ */
+
 module.exports = {
     _id: require("./_id.js"),
     ID: require("./ID.js"),

package/src/form/extractors/index.js

@@ -1,3 +1,6 @@
+/**
+ * Extracts values from different input sources
+ */
 module.exports = {
     activeUserId: require("./activeUserId.js"),
     activeUserModelName: require("./activeUserModelName.js"),

package/src/form/form.js

@@ -11,10 +11,12 @@ const { notValidationError, notError } = require("not-error");
 
 const {
     FormExceptionExtractorForFieldIsUndefined,
+    FormExceptionTransformerForFieldIsUndefined,
 } = require("../exceptions/form.js");
 
 const DEFAULT_EXTRACTORS = require("./extractors");
 const DEFAULT_ID_EXTRACTORS = require("./env_extractors");
+const DEFAULT_TRANSFORMERS = require("./transformers");
 
 /**
  * Generic form validation class
@@ -43,6 +45,10 @@ class Form {
         ...DEFAULT_ID_EXTRACTORS,
     };
 
+    #TRANSFORMERS = {
+        ...DEFAULT_TRANSFORMERS,
+    };
+
     constructor({
         FIELDS,
         FORM_NAME,
@@ -51,6 +57,7 @@ class Form {
         app,
         EXTRACTORS = {},
         ENV_EXTRACTORS = {},
+        TRANSFORMERS = {},
     }) {
         this.#FORM_NAME = FORM_NAME;
         this.#MODEL_NAME = MODEL_NAME;
@@ -60,6 +67,7 @@ class Form {
         this.#augmentValidationSchema();
         this.#addExtractors(EXTRACTORS);
         this.#addEnvExtractors(ENV_EXTRACTORS);
+        this.#addTransformers(TRANSFORMERS);
     }
 
     getModelName(req) {
@@ -283,22 +291,74 @@ class Form {
         const results = {};
         for (let fieldName in instructions) {
             const instruction = instructions[fieldName];
-            if (isFunc(instruction)) {
-                results[fieldName] = instruction(req, fieldName);
-            } else if (typeof instruction == "string") {
-                const extractor = this.#EXTRACTORS[instruction];
-                if (isFunc(extractor)) {
-                    results[fieldName] = extractor(req, fieldName);
-                } else {
-                    throw new FormExceptionExtractorForFieldIsUndefined(
-                        fieldName
-                    );
-                }
+            if (Array.isArray(instruction)) {
+                this.#extractByInstructionPipe({
+                    results,
+                    instructions: instruction,
+                    fieldName,
+                    req,
+                });
+            } else {
+                this.#extractByInstruction({
+                    results,
+                    instruction,
+                    fieldName,
+                    req,
+                });
             }
         }
         return results;
     }
 
+    #extractByInstruction({ results, instruction, fieldName, req }) {
+        if (isFunc(instruction)) {
+            results[fieldName] = instruction(req, fieldName);
+        } else if (typeof instruction == "string") {
+            const extractor = this.#EXTRACTORS[instruction];
+            if (isFunc(extractor)) {
+                results[fieldName] = extractor(req, fieldName);
+            } else {
+                throw new FormExceptionExtractorForFieldIsUndefined(fieldName);
+            }
+        }
+    }
+
+    #extractByInstructionPipe({ results, instructions, fieldName, req }) {
+        if (instructions.length === 0) {
+            throw new FormExceptionExtractorForFieldIsUndefined(fieldName);
+        }
+        this.#extractByInstruction({
+            results,
+            instruction: instructions[0],
+            fieldName,
+            req,
+        });
+        for (let t = 1; t < instructions.length; t++) {
+            const instruction = instructions[t];
+            this.#transformByInstruction({
+                results,
+                instruction,
+                fieldName,
+            });
+        }
+    }
+
+    #transformByInstruction({ results, instruction, fieldName }) {
+        if (isFunc(instruction)) {
+            results[fieldName] = instruction(results[fieldName]);
+        } else if (typeof instruction == "string") {
+            const transformer = this.#TRANSFORMERS[instruction];
+            if (isFunc(transformer)) {
+                results[fieldName] = transformer(results[fieldName]);
+            } else {
+                throw new FormExceptionTransformerForFieldIsUndefined(
+                    fieldName,
+                    instruction
+                );
+            }
+        }
+    }
+
     createInstructionFromRouteActionFields(
         req,
         mainInstruction = "fromBody",
@@ -333,6 +393,15 @@ class Form {
         );
         return this.extractByInstructions(req, instructions);
     }
+
+    /**
+     * Value transformers
+     */
+    #addTransformers(transformers = {}) {
+        if (transformers) {
+            this.#TRANSFORMERS = { ...this.#TRANSFORMERS, ...transformers };
+        }
+    }
 }
 
 module.exports = Form;

package/src/form/transformers/index.js

@@ -0,0 +1,7 @@
+/**
+ * Transforms data
+ */
+
+module.exports = {
+    stringToJSON: require("./stringToJSON.js"),
+};

package/src/form/transformers/stringToJSON.js

@@ -0,0 +1,3 @@
+module.exports = (input) => {
+    return JSON.parse(input);
+};