@edirect/template 1.0.2 → 1.0.3

package/README.md

@@ -63,7 +63,7 @@ To map a value that you'd like to use some transformer feature, you can use thes
 - `transformer`: it's a JS function, where you receive value and context as parameters and have all freedom to handle and return a value
 - `defaultValue` it's an option if the engine doesn't find any value in the fields data source array or the transformer doesn't return a value.
 
-#### File name: `baseTransformers.ts`
+##### File name: baseTransformers.ts
 
 ```javascript
 import { ITransformer, ITransformerParams } from "@edirect/template";
@@ -89,7 +89,7 @@ const transformers: ITransformer = {
 export default transformers;
 ```
 
-#### File name `index.ts`
+##### File name: index.ts
 
 ```javascript
 import { TemplateModule } from "@edirect/template";
@@ -140,3 +140,230 @@ console.log(result);
 //   timeZone: "Time zone in Porto (GMT+1)",
 // }
 ```
+
+### Example with nested object + transformers
+
+`Note`: the transformer notation uses three keys to identify an object as being a transformer: fields, transformer, and defaultValue, if there are at least 1 of these keys, the engine will consider the object as being a transformer, on the other hand, if there isn't, the engine will consider as a nested object to mapper all information.
+
+##### File name: baseTransformers.ts
+
+```javascript
+import { ITransformer, ITransformerParams } from "@edirect/template";
+
+const upperCase = ({ value }: ITransformerParams): string | null => {
+  return value ? String(value).toUpperCase() : null;
+};
+
+const transformers: ITransformer = {
+  upperCase,
+};
+
+export default transformers;
+```
+
+##### File name: index.ts
+
+```javascript
+import { TemplateModule } from "@edirect/template";
+import baseTransformers from "./baseTransformers";
+
+const template = {
+  order: {
+    date: "order.date",
+    value: "order.value",
+    subscriber: {
+      name: "sub.name",
+      phone: "sub.phone",
+      email: {
+        fields: ["email", "sub.email"],
+      },
+      address: {
+        street: "sub.add.stt",
+        number: "sub.add.num",
+        city: {
+          fields: ["sub.add.city"],
+          transformer: "upperCase",
+        },
+        state: {
+          fields: ["sub.add.stt"],
+          transformer: "upperCase",
+        },
+        zip: {
+          fields: ["sub.add.zip"],
+          defaultValue: "0000-000",
+        },
+      },
+    },
+  },
+};
+
+const dataSource = {
+  order: {
+    value: 1000.0,
+    date: "2000-01-01",
+  },
+  sub: {
+    name: "name-test",
+    phone: "999999999",
+    email: "template.service@bolltech.io",
+    add: {
+      st: "st-test",
+      num: 100,
+      city: "city-test",
+      stt: "state-test",
+      zip: "zip-test",
+    },
+  },
+};
+
+const templateModule = new TemplateModule();
+
+templateModule.setTemplate(template);
+templateModule.setContext(dataSource);
+templateModule.setTransformers(baseTransformers);
+
+const result = templateModule.transformPayload(dataSource);
+console.log(result);
+
+// {
+//   order: {
+//     date: "2000-01-01",
+//     value: 1000,
+//     subscriber: {
+//       name: "name-test",
+//       phone: "999999999",
+//       email: "template.service@bolltech.io",
+//       address: {
+//         street: "state-test",
+//         number: 100,
+//         city: "CITY-TEST",
+//         state: "STATE-TEST",
+//         zip: "zip-test",
+//       },
+//     },
+//   },
+// }
+```
+
+### Example with arrays + transformers
+
+`Note`: When it comes to arrays mapper, we need to have in mind that is required use this two keys: arraySource and arrayTemplate.
+
+- `arraySource`: source path where the engine will seek the information to mapper
+- `arrayTemplate`: template that will be used for each object within the array
+
+##### File name: baseTransformers.ts
+
+```javascript
+import { ITransformer, ITransformerParams } from "@edirect/template";
+
+const upperCase = ({ value }: ITransformerParams): string | null => {
+  return value ? String(value).toUpperCase() : null;
+};
+
+const transformers: ITransformer = {
+  upperCase,
+};
+
+export default transformers;
+```
+
+##### File name: index.ts
+
+```javascript
+import { TemplateModule } from "@edirect/template";
+import baseTransformers from "./baseTransformers";
+
+const template = {
+  quote: {
+    orders: {
+      arraySource: "order",
+      arrayTemplate: {
+        value: "value",
+        date: "date",
+        products: {
+          arraySource: "products",
+          arrayTemplate: {
+            id: "id",
+            value: "value",
+            description: {
+              fields: ["description"],
+              transformer: "upperCase",
+              defaultValue: "Default description",
+            },
+            categories: "categories",
+          },
+        },
+      },
+    },
+  },
+};
+
+const dataSource = {
+  order: [
+    {
+      value: 1000.0,
+      date: "2000-01-01",
+      products: [
+        {
+          id: "id-test-1",
+          value: 1000,
+          description: "description-test 1",
+          categories: ["category-1"],
+        },
+        {
+          id: "id-test-2",
+          value: 2000,
+          description: "description-test 2",
+          categories: ["category-1", "category-2"],
+        },
+        {
+          id: "id-test-3",
+          value: 3000,
+          categories: ["category-1", "category-2", "category-3"],
+        },
+      ],
+    },
+  ],
+};
+
+const templateModule = new TemplateModule();
+
+templateModule.setTemplate(template);
+templateModule.setContext(dataSource);
+templateModule.setTransformers(baseTransformers);
+
+const result = templateModule.transformPayload(dataSource);
+console.log(result);
+
+//{
+//  quote: {
+//     orders: [
+//       {
+//         value: 1000,
+//         date: "2000-01-01",
+//         products: [
+//           {
+//             id: "id-test-1",
+//             value: 1000,
+//             description: "DESCRIPTION-TEST 1",
+//             categories: ["category-1"],
+//           },
+//           {
+//             id: "id-test-2",
+//             value: 2000,
+//             description: "DESCRIPTION-TEST 2",
+//             categories: ["category-1", "category-2"],
+//           },
+//           {
+//             id: "id-test-3",
+//             value: 3000,
+//             description: "Default description",
+//             categories: ["category-1", "category-2", "category-3"],
+//           },
+//         ],
+//       },
+//     ],
+//   },
+// }
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edirect/template",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Template Module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",