@izara_project/izara-core-generate-service-code 1.0.1 → 1.0.3

package/src/TemplateData/relationshipPerAction/create/action/functionYaml/data.js

@@ -0,0 +1,206 @@
+/*
+Copyright (C) 2020 Sven Mason <http://izara.io>
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as
+published by the Free Software Foundation, either version 3 of the
+License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+import consts from '../../../../../libs/Consts.js';
+import utils from '../../../../../libs/Utils.js';
+import libs from '../../../../../libs/Libs.js'
+
+const {
+  STORAGE_TYPES,
+  RESOURCE_CLASSES,
+  SOURCE_PATH,
+  SAVE_FILE_NAME,
+  FUNCTION_NAME,
+  SNS_RESOURCE,
+  SHORT_FUNCTION_NAME,
+  SOURCE_GENERATE_IAM_ROLE,
+  SQS_RESOURCE,
+  HANDLER
+} = consts;
+
+const {
+  firstLetterUpperCase: upperCase,
+  getLocalConfig
+} = utils;
+
+const {
+  createIamRole,
+  resourceNames,
+  defaultIamRolePerAction,
+  awaitingMultipleStepsRole,
+  shortNameHandler,
+  checkDynamoTypeRelationship,
+  createDynamoDbComponentByLinks
+} = libs;
+
+const templatePath = path.join(__dirname, 'template.ejs');
+
+const apiTemplate = path.join(__dirname, 'templateByHandler/apiTemplate.ejs');
+const dsqTemplate = path.join(__dirname, 'templateByHandler/dsqTemplate.ejs');
+const invTemplate = path.join(__dirname, 'templateByHandler/invTemplate.ejs');
+const sqsTemplate = path.join(__dirname, 'templateByHandler/sqsTemplate.ejs');
+
+/**
+ * receive objectSchema
+ * create data for updateRelationshipSchema
+ *
+ * @param {Object} objectSchema
+ * @return {{ templatePath, templateData, setting } }
+ */
+
+function data(_izContext, allObjectRelationships, srcPath) {
+  let createSourceArray = [];
+  for (const handlerType of Object.values(HANDLER)) {
+    const createSourceParam = createParamForCreateSource(
+      allObjectRelationships,
+      handlerType,
+      srcPath
+    );
+    createSourceArray.push(createSourceParam);
+  }
+  // console.log("createSourceArrayInUpdaterelationShipSchemahdrSqs", createSourceArray)
+  return createSourceArray;
+}
+
+function createParamForCreateSource(
+  allObjectRelationships,
+  handlerType,
+  srcPath
+) {
+  let functionName = upperCase(FUNCTION_NAME.createRel);
+  let additionalResourcePermission = defaultIamRolePerAction();
+
+  additionalResourcePermission.push(awaitingMultipleStepsRole());
+
+  if (handlerType === HANDLER.hdrDsq) {
+    additionalResourcePermission.push(
+      createIamRole(
+        {
+          [RESOURCE_CLASSES.sqs]: [
+            SQS_RESOURCE.deleteMessage,
+            SQS_RESOURCE.getQueueAttributes,
+            SQS_RESOURCE.receiveMessage,
+            SQS_RESOURCE.sendMessage,
+            SQS_RESOURCE.getQueueUrl,
+            SQS_RESOURCE.deleteMessageBatch
+          ]
+        },
+        [
+          resourceNames(
+            RESOURCE_CLASSES.sqs,
+            upperCase(functionName) + upperCase(handlerType)
+          ),
+          resourceNames(
+            RESOURCE_CLASSES.sqs,
+            upperCase(functionName) + upperCase(handlerType) + 'DLQ'
+          )
+        ]
+      )
+    );
+  }
+
+  if (handlerType === HANDLER.hdrSqs) {
+    additionalResourcePermission.push(
+      createIamRole(
+        {
+          [RESOURCE_CLASSES.sns]: [
+            SNS_RESOURCE.publish,
+            SNS_RESOURCE.subscribe
+          ],
+          [RESOURCE_CLASSES.sqs]: Object.values(SQS_RESOURCE)
+        },
+        [
+          resourceNames(
+            RESOURCE_CLASSES.sns,
+            upperCase(FUNCTION_NAME.createRelComplete) + '_Out'
+          ),
+          resourceNames(
+            RESOURCE_CLASSES.sqs,
+            upperCase(functionName) + upperCase(handlerType)
+          ),
+          resourceNames(
+            RESOURCE_CLASSES.sqs,
+            upperCase(functionName) + upperCase(handlerType) + 'DLQ'
+          ),
+          resourceNames(RESOURCE_CLASSES.sns, upperCase(functionName) + '_In'),
+          resourceNames(RESOURCE_CLASSES.sns, upperCase(functionName) + '_Out')
+        ]
+      )
+    );
+  }
+
+  for (const relationship of allObjectRelationships) {
+    let [storageType, relationshipTag, links] =
+      checkDynamoTypeRelationship(relationship);
+    if (storageType === STORAGE_TYPES.dynamoDB) {
+      for (const link of links) {
+        let dynamoComponent = createDynamoDbComponentByLinks(
+          link,
+          relationshipTag
+        );
+        additionalResourcePermission.push(
+          createIamRole(
+            {
+              [RESOURCE_CLASSES.dynamoDbTable]: [DYNAMO_RESOURCE.putItem]
+            },
+            [
+              resourceNames(
+                RESOURCE_CLASSES.dynamoDbTable,
+                upperCase(dynamoComponent.tableNameFrom)
+              ),
+              resourceNames(
+                RESOURCE_CLASSES.dynamoDbTable,
+                upperCase(dynamoComponent.tableNameTo)
+              )
+            ]
+          )
+        );
+      }
+    }
+  }
+
+  return {
+    templatePath: templatePath,
+    templateData: {
+      functionName,
+      handlerType,
+      additionalResourcePermission,
+      resourceLocation: SOURCE_PATH.resourceLocationRelationshipPerAction,
+      functionNameConfig:
+        upperCase(SHORT_FUNCTION_NAME(FUNCTION_NAME.createRel)) +
+        upperCase(shortNameHandler(handlerType)),
+      roleName: SOURCE_GENERATE_IAM_ROLE.RelationshipRole,
+      serviceTag: getLocalConfig('iz_serviceTag'),
+      apiTemplate,
+      dsqTemplate,
+      invTemplate,
+      sqsTemplate
+    },
+    setting: {
+      savePath: path.join(srcPath, SOURCE_PATH.appYaml),
+      saveFileName: SAVE_FILE_NAME.functionRelationshipYaml,
+      fileExtension: '.yml',
+      isAppend: true
+    }
+  };
+}
+
+export default data;

package/src/TemplateData/relationshipPerAction/create/action/functionYaml/template.ejs

@@ -0,0 +1,9 @@
+<% if (handlerType === "hdrApi") { %>
+<%- include(apiTemplate),{ functionName, handlerType, additionalResourcePermission, resourceLocation, functionNameConfig, roleName, serviceTag } %>
+<% } else if (handlerType === "hdrDsq") { %>
+<%- include(dsqTemplate), { functionName, handlerType, additionalResourcePermission, resourceLocation, functionNameConfig, roleName } %>
+<% } else if (handlerType === "hdrInv") { %>
+<%- include(invTemplate), { functionName, handlerType, additionalResourcePermission, resourceLocation, functionNameConfig, roleName } %>
+<% } else if (handlerType === "hdrSqs") { %>
+<%- include(sqsTemplate),{ functionName, handlerType, additionalResourcePermission, resourceLocation, functionNameConfig, roleName } %>
+<% } %>

package/src/TemplateData/relationshipPerAction/create/action/functionYaml/templateByHandler/apiTemplate.ejs

@@ -0,0 +1,21 @@
+<%_ const join = require('path').join; _%>
+<%- firstLetterUpperCase(functionNameConfig) %>:
+  handler: <%- join(resourceLocation, `${firstLetterUpperCase(functionName)}_${firstLetterUpperCase(handlerType)}.main`)%>
+  name: ${self:custom.iz_resourcePrefix}<%- firstLetterUpperCase(functionName) %><%- firstLetterUpperCase(handlerType) %>
+  role: <%- roleName %>Role
+  #<#<%- functionName %><%- firstLetterUpperCase(handlerType) %>FunctionSetting#>
+  #<#/<%- functionName %><%- firstLetterUpperCase(handlerType) %>FunctionSetting#>
+  events:
+    - http:
+        path: /<%- serviceTag %>/<%- firstLetterLowerCase(functionName) %>/<%- functionName %>/
+        method: put
+        cors: true
+        #<#Authorizer#>
+        #<#/Authorizer#>
+
+<%_ function firstLetterUpperCase(text){
+  return text.charAt(0).toUpperCase() + text.slice(1)
+} _%>
+<%_ function firstLetterLowerCase(str) {
+  return str.charAt(0).toLowerCase() + str.slice(1)
+} _%>

package/src/TemplateData/relationshipPerAction/create/action/functionYaml/templateByHandler/dsqTemplate.ejs

@@ -0,0 +1,17 @@
+<%_ const join = require('path').join; _%>
+<%- firstLetterUpperCase(functionNameConfig) %>:
+  handler: <%- join(resourceLocation, `${firstLetterUpperCase(functionName)}_${firstLetterUpperCase(handlerType)}.main`)%>
+  name: ${self:custom.iz_resourcePrefix}<%- firstLetterUpperCase(functionName) %><%- firstLetterUpperCase(handlerType) %>
+  role: <%- roleName %>Role
+  #<#<%- functionName %><%- firstLetterUpperCase(handlerType) %>FunctionSetting#>
+  #<#/<%- functionName %><%- firstLetterUpperCase(handlerType) %>FunctionSetting#>
+  events:
+    - sqs:
+        arn: arn:aws:sqs:${self:custom.iz_region}:${self:custom.iz_accountId}:${self:custom.iz_resourcePrefix}<%- firstLetterUpperCase(functionName) %><%- firstLetterUpperCase(handlerType) %>
+        batchSize: 10
+<%_ function firstLetterUpperCase(text){
+  return text.charAt(0).toUpperCase() + text.slice(1)
+} _%>
+<%_ function firstLetterLowerCase(str) {
+  return str.charAt(0).toLowerCase() + str.slice(1)
+} _%>

package/src/TemplateData/relationshipPerAction/create/action/functionYaml/templateByHandler/invTemplate.ejs

@@ -0,0 +1,13 @@
+<%_ const join = require('path').join; _%>
+<%- firstLetterUpperCase(functionNameConfig) %>:
+  handler: <%- join(resourceLocation, `${firstLetterUpperCase(functionName)}_${firstLetterUpperCase(handlerType)}.main`)%>
+  name: ${self:custom.iz_resourcePrefix}<%- firstLetterUpperCase(functionName) %><%- firstLetterUpperCase(handlerType) %>
+  role: <%- roleName %>Role
+  #<#<%- functionName %><%- firstLetterUpperCase(handlerType) %>FunctionSetting#>
+  #<#/<%- functionName %><%- firstLetterUpperCase(handlerType) %>FunctionSetting#>
+<%_ function firstLetterUpperCase(text){
+  return text.charAt(0).toUpperCase() + text.slice(1)
+} _%>
+<%_ function firstLetterLowerCase(str) {
+  return str.charAt(0).toLowerCase() + str.slice(1)
+} _%>

package/src/TemplateData/relationshipPerAction/create/action/functionYaml/templateByHandler/sqsTemplate.ejs

@@ -0,0 +1,17 @@
+<%_ const join = require('path').join; _%>
+<%- firstLetterUpperCase(functionNameConfig) %>:
+  handler: <%- join(resourceLocation, `${firstLetterUpperCase(functionName)}_${firstLetterUpperCase(handlerType)}.main`)%>
+  name: ${self:custom.iz_resourcePrefix}<%- firstLetterUpperCase(functionName) %><%- firstLetterUpperCase(handlerType) %>
+  role: <%- roleName %>Role
+  #<#<%- functionName %><%- firstLetterUpperCase(handlerType) %>FunctionSetting#>
+  #<#/<%- functionName %><%- firstLetterUpperCase(handlerType) %>FunctionSetting#>
+  events:
+    - sqs:
+        arn: arn:aws:sqs:${self:custom.iz_region}:${self:custom.iz_accountId}:${self:custom.iz_resourcePrefix}<%- firstLetterUpperCase(functionName) %><%- firstLetterUpperCase(handlerType) %>
+        batchSize: 10
+<%_ function firstLetterUpperCase(text){
+  return text.charAt(0).toUpperCase() + text.slice(1)
+} _%>
+<%_ function firstLetterLowerCase(str) {
+  return str.charAt(0).toLowerCase() + str.slice(1)
+} _%>

package/src/TemplateData/relationshipPerAction/create/action/handler/data.js

@@ -0,0 +1,72 @@
+/*
+Copyright (C) 2020 Sven Mason <http://izara.io>
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as
+published by the Free Software Foundation, either version 3 of the
+License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+import consts from '../../../../../libs/Consts.js';
+import utils from '../../../../../libs/Utils.js';
+const { SOURCE_PATH, FUNCTION_NAME, HANDLER } = consts;
+
+const { firstLetterLowerCase: lowerCase, firstLetterUpperCase: upperCase } = utils;
+
+const templatePath = path.join(__dirname, 'template.ejs');
+const apiTemplate = path.join(__dirname, 'templateByHandler/apiTemplate.ejs');
+const dsqTemplate = path.join(__dirname, 'templateByHandler/dsqTemplate.ejs');
+const invTemplate = path.join(__dirname, 'templateByHandler/invTemplate.ejs');
+const sqsTemplate = path.join(__dirname, 'templateByHandler/sqsTemplate.ejs');
+
+/**
+ * receive objectSchema
+ * create data for hdrInv template
+ *
+ * @return {{ templatePath, templateData, setting } }
+ */
+function data(_izContext, srcPath) {
+  const createSourceParams = [];
+  for (const handler of Object.values(HANDLER)) {
+    const createSourceParam = createParamForCreateSource(handler, srcPath);
+    createSourceParams.push(createSourceParam);
+  }
+  return createSourceParams;
+}
+
+function createParamForCreateSource(handler, srcPath) {
+  let functionName = FUNCTION_NAME.createRel;
+  let queueName = functionName + upperCase(handler);
+  return {
+    templatePath: templatePath,
+    templateData: {
+      functionName,
+      queueName,
+      apiTemplate,
+      dsqTemplate,
+      invTemplate,
+      sqsTemplate,
+      handler
+    },
+    setting: {
+      savePath: path.join(srcPath, SOURCE_PATH.relationshipPerAction),
+      saveFileName: upperCase(functionName) + '_' + upperCase(handler),
+      fileExtension: '.js',
+      isAppend: false
+    }
+  };
+}
+
+export default data;

package/src/TemplateData/relationshipPerAction/create/action/handler/template.ejs

@@ -0,0 +1,9 @@
+<% if (handler === "hdrApi") { %>
+  <%- include(apiTemplate),{ functionName } %>
+  <% } else if (handler === "hdrDsq") { %>
+  <%- include(dsqTemplate), { functionName, queueName } %>
+  <% } else if (handler === "hdrInv") { %>
+  <%- include(invTemplate), { functionName} %>
+  <% } else if (handler === "hdrSqs") { %>
+  <%- include(sqsTemplate),{ functionName, queueName } %>
+  <% } %>

package/src/TemplateData/relationshipPerAction/create/action/handler/templateByHandler/apiTemplate.ejs

@@ -0,0 +1,137 @@
+/*
+Copyright (C) 2020 Sven Mason <http://izara.io>
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as
+published by the Free Software Foundation, either version 3 of the
+License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+
+
+import { middlewareHandler as middleware, validatorSchema } from "@izara_project/izara-middleware";
+import callingFlowSharedLib from '@izara_project/izara-core-library-calling-flow';
+import Logger from '@izara_project/izara-core-library-logger';
+import recordHandlerSharedLib from '@izara_project/izara-core-library-record-handler';
+
+import <%- functionName %>  from './<%- firstLetterUpperCase(functionName) %>_Main.js';
+
+// validate event params in middleware before into function
+let validator = {
+  type: "object",
+  required: ["firstObject", "secondObject", "relType", "relationshipDirection"],
+  properties: {
+    firstObject: {
+      type: "object",
+      required: ["objType", "identifiers"],
+      properties: {
+        objType: {
+          type: "object",
+          required: ["serviceTag", "objectType"],
+          properties: {
+            serviceTag: validatorSchema.stringNotEmpty(),
+            objectType: validatorSchema.stringNotEmpty()
+          }
+        },
+        identifiers: {
+          type: "object",
+          minProperties: 1
+        }
+      }
+    },
+    secondObject: {
+      type: "object",
+      required: ["objType", "identifiers"],
+      properties: {
+        objType: {
+          type: "object",
+          required: ["serviceTag", "objectType"],
+          properties: {
+            serviceTag: validatorSchema.stringNotEmpty(),
+            objectType: validatorSchema.stringNotEmpty()
+          }
+        },
+        identifiers: {
+          type: "object",
+          minProperties: 1
+        }
+      }
+    },
+    relType: {
+      type: "object",
+      required: ["relationshipTag", "serviceTag"],
+      properties: {
+        relationshipTag: validatorSchema.stringNotEmpty(),
+        serviceTag: {
+          type: 'string',
+          pattern: "^[a-zA-Z0-9_-]+$",
+          enum: [process.env.iz_serviceTag]
+        },
+      }
+    },
+    relationshipDirection: {
+      type: "string",
+      enum: ['from', "to"]
+    },
+    relationshipProperties: {
+      type: 'object',
+      default: {}
+    },
+  }
+};
+
+//(<globalVariable>
+//</globalVariable>)
+
+// validate event params in middleware before into main function
+validator = callingFlowSharedLib.addOptionalCallingFlowToValidatorSchema(validator);
+middleware.setValidatorSchema(validator)
+// if need to validate authorizer or additional params , add code to hook tag below
+
+//(<afterValidateWith>)
+//(</afterValidateWith>)
+
+
+export const main = middleware.wrap(async (event, context) => {
+  event._izContext.logger.debug('Event:', event);
+  try {
+    // invoke LambdaFunction
+    let lambdaFunctionResponse = await <%- functionName %>(
+      event._izContext,       // correlationId/logger/integrationTestDetail/uniqueRequestId/userId
+      {
+        firstObject: event.firstObject,
+        secondObject: event.secondObject,
+        relType: event.relType,
+        relationshipDirection: event.relationshipDirection,
+        relationshipProperties: event.relationshipProperties,
+      },
+      callingFlowSharedLib.addCallingFlowToPassOnProperties(event)
+    );
+
+    // return error to client
+    if (lambdaFunctionResponse instanceof Error) {
+      return (izara.response.failure(lambdaFunctionResponse));
+    }
+
+    // return success to client
+    return (izara.response.success(lambdaFunctionResponse));
+
+  } catch (err) {
+    event._izContext.logger.error('Error, <%- functionName %>HdrApi: ', err);
+    return (izara.response.failure(err));
+  }
+});
+<%_ function firstLetterUpperCase(text) {
+  return text.charAt(0).toUpperCase() + text.slice(1)
+} _%>
+<%_ function firstLetterLowerCase(str) {
+  return str.charAt(0).toLowerCase() + str.slice(1)
+} _%>

package/src/TemplateData/relationshipPerAction/create/action/handler/templateByHandler/dsqTemplate.ejs

@@ -0,0 +1,179 @@
+/*
+Copyright (C) 2020 Sven Mason <http://izara.io>
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as
+published by the Free Software Foundation, either version 3 of the
+License, or (at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+
+
+import { middlewareHandler as middleware, validatorSchema } from "@izara_project/izara-middleware";
+import Logger from '@izara_project/izara-core-library-logger';
+import callingFlowSharedLib from '@izara_project/izara-core-library-calling-flow';
+import { recordHandlerSharedLib } from '@izara_project/izara-core-library-record-handler';
+
+import <%- functionName %> from './<%- firstLetterUpperCase(functionName) %>_Main.js'
+
+// validate event properties in body.Message of sqs event
+middleware.setValidatorSchema(recordHandlerSharedLib.baseValidatorSchema(
+  {
+    type: "object",
+    required: ['body', 'messageAttributes'],
+    properties: {
+      body: {
+        type: 'object',
+      },
+      messageAttributes: {
+        type: 'object'
+      }
+    }
+  }
+));
+
+// validate event params in middlewware before into function.
+let validator = {
+  type: "object",
+  required: ["firstObject", "secondObject", "relType", "relationshipDirection"],
+  properties: {
+    firstObject: {
+      type: "object",
+      required: ["objType", "identifiers"],
+      properties: {
+        objType: {
+          type: "object",
+          required: ["serviceTag", "objectType"],
+          properties: {
+            serviceTag: validatorSchema.stringNotEmpty(),
+            objectType: validatorSchema.stringNotEmpty()
+          }
+        },
+        identifiers: {
+          type: "object",
+          minProperties: 1
+        }
+      }
+    },
+    secondObject: {
+      type: "object",
+      required: ["objType", "identifiers"],
+      properties: {
+        objType: {
+          type: "object",
+          required: ["serviceTag", "objectType"],
+          properties: {
+            serviceTag: validatorSchema.stringNotEmpty(),
+            objectType: validatorSchema.stringNotEmpty()
+          }
+        },
+        identifiers: {
+          type: "object",
+          minProperties: 1
+        }
+      }
+    },
+    relType: {
+      type: "object",
+      required: ["relationshipTag", "serviceTag"],
+      properties: {
+        relationshipTag: validatorSchema.stringNotEmpty(),
+        serviceTag: {
+          type: 'string',
+          pattern: "^[a-zA-Z0-9_-]+$",
+          enum: [process.env.iz_serviceTag]
+        },
+      }
+    },
+    relationshipDirection: {
+      type: "string",
+      enum: ['from', "to"]
+    },
+    relationshipProperties: {
+      type: 'object',
+      default: {}
+    },
+  }
+};
+
+
+//(<globalVariable>
+  //</globalVariable>)
+
+  // validate event params in middleware before into main function
+  validator = callingFlowSharedLib.addOptionalCallingFlowToValidatorSchema(validator);
+  // if need to validate authorizer or additional params , add code to hook tag below
+
+  //(<afterValidateWith>)
+  //(</afterValidateWith>)
+
+
+  export const main = middleware.wrap(async (event, context) => {
+    Logger.debug('event:', event);
+    Logger.debug('context:', context);
+    try {
+
+      let recordPromises = []; // final return
+
+      // loop each record and send to mainFunction
+      await Promise.all(event.Records.map(async record => { // promise.all for map() function
+
+        // --- reforming record.body for Dsq request
+        record = recordHandlerSharedLib.reformatDsqMessage(record._izContext, record);
+        record._izContext.logger.debug('record LambdaFunctionHdrDsq after reform', record);
+
+        let passOnProperties = []
+
+        // --- validate message (and MessageAttributes)
+        await recordHandlerSharedLib.validateRecord(
+          record, // one record will send to mainFunction
+          "<%- queueName %>",                       // queue name that need to retry or send to dlq
+          validator, // schema for record.Message
+          // messageAttributeValidatorSchema        // ----- for msgAttr default is null -> do not send this parameter if not want to validate msgAtt
+        );
+
+        // add argument (to invoke lambda) to passOnProperties[]
+        passOnProperties.push(record.body.Message)
+        passOnProperties.push(callingFlowSharedLib.addCallingFlowToPassOnProperties(record.body.Message));
+        //(<afterPutParamIntoMainFunction>)
+        //(</afterPutParamIntoMainFunction>)
+        record._izContext.logger.debug('passOnProperties in handler', passOnProperties);
+
+        // call recordHandlerSharedLib.recordHandler with 3 parameters and return promise(resolve)
+        let recordPromise = recordHandlerSharedLib.recordHandler(
+          record, // one record will send to mainFunction
+          <%- functionName %>,     // mainFunction that need to invoke.
+          "<%- queueName %>",                          // queue name that need to retry or send to dlq
+          passOnProperties,                            // all parameters that mainFunction needed.
+          );
+          record._izContext.logger.debug('after recordPromise in handler');
+          recordPromises.push(recordPromise); // push promise to recordPromises
+        })) //end record
+
+        Logger.debug('before Promise.all(recordPromises) in handler');
+        try {
+          await Promise.all(recordPromises); // await all promises
+          return event.Records // return all for local test
+        } catch {
+          Logger.debug('Promise.all(recordPromises) in handler threw error (at least one record did no resolve)');
+        }
+        Logger.debug('after Promise.all(recordPromises) in handler');
+      } catch (err) {
+        Logger.error('Unhandled Error, updateRelationshipHdrDsq:', err);
+        throw (err);
+      }
+    });
+  <%_ function firstLetterUpperCase(text) {
+    return text.charAt(0).toUpperCase() + text.slice(1)
+  } _%>
+  <%_ function firstLetterLowerCase(str) {
+    return str.charAt(0).toLowerCase() + str.slice(1)
+  } _%>