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

package/src/TemplateData/flowSchema/eventBridge/handler/inv/data.js

@@ -0,0 +1,70 @@
+/*
+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 { firstLetterUpperCase: upperCase } = utils;
+const { SOURCE_PATH, HANDLER } = consts;
+
+const templatePath = path.join(__dirname, 'template.ejs');
+/**
+ * receive objectSchema
+ * create data for hdrInv template
+ *
+ * @param {Object} _izContext
+ * @param {Object} flowSchema
+ * @param {String} srcPath
+ * @return {Object[]}
+ */
+function data(_izContext, flowSchema, srcPath) {
+  const handler = HANDLER.hdrInv;
+  const flowTag = flowSchema.flowTag;
+  // const action = SOURCE_GENERATE_IAM_ROLE.EventBridge;
+  const functionName = 'EventBridge';
+  // const fileName = `${upperCase(flowTag)}${upperCase(action)}_${upperCase(handler)}`;
+  return [
+    {
+      templatePath: templatePath,
+      templateData: {
+        functionName: functionName,
+        flowTag: flowTag,
+        // action: action,
+        handler
+        // roleName: SOURCE_GENERATE_IAM_ROLE.EventBridge,
+        // firstLetterUpperCase: upperCase,
+      },
+      setting: {
+        savePath: path.join(
+          srcPath,
+          SOURCE_PATH.flowSchemaEventBridge,
+          flowSchema.flowTag,
+          'source/'
+        ),
+        saveFileName: `${upperCase(functionName)}_${upperCase(handler)}`,
+        fileExtension: '.js',
+        isAppend: false
+      }
+    }
+  ];
+}
+
+export default data;

package/src/TemplateData/flowSchema/eventBridge/handler/inv/request.json

@@ -0,0 +1,7 @@
+{
+  "objectType": "objectType",
+  "action": "get",
+  "mainFunction": "xxx",
+  "mainFunctionFile": "directoryOfMainFunction",
+  "isCreateMainByDev": "boolean"
+}

package/src/TemplateData/flowSchema/eventBridge/handler/inv/template.ejs

@@ -0,0 +1,60 @@
+/*
+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 { middlewareHandleras middlewar } from "@izara_project/izara-middleware";
+import callingFlowSharedLib from '@izara_project/zara-core-library-calling-flow';
+
+import <%- functionName %>Main from './<%- firstLetterUpperCase(functionName)%>_Main.js'
+
+//(<globalVariable>
+//</globalVariable>)
+
+
+//(<afterValidateWithGenereatedSchema>)
+//(</afterValidateWithGenereatedSchema>)
+
+
+export const main = middlewareHandler.wrap(async (event, context) => {
+  event._izContext.logger.debug('Event:', event);
+  event._izContext.logger.debug('context:', context);
+
+  try {
+
+    //(<beforeInvoke>)
+    //(</beforeInvoke>)
+
+    // invoke LambdaFunction
+    return await <% - functionName %> Main(
+      event._izContext, // correlationId/logger/integrationTestDetail/uniqueRequestId
+      event,
+      callingFlowSharedLib.addCallingFlowToPassOnProperties(event)
+    );
+
+  } catch (err) {
+    event._izContext.logger.error('Error, <%- firstLetterUpperCase(flowTag) %>: ', 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)
+} _ %>

package/src/TemplateData/flowSchema/eventBridge/mainFunction/data.js

@@ -0,0 +1,68 @@
+/*
+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 { firstLetterUpperCase: upperCase } = utils;
+const { SOURCE_PATH, SOURCE_GENERATE_IAM_ROLE } = consts;
+
+const templatePath = path.join(__dirname, 'template.ejs');
+
+/**
+ * receive objectSchema
+ * create data for hdrInv template
+ *
+ * @param {Object} flowSchema
+ * @return {{ templatePath, templateData, setting } }
+ */
+function data(_izContext, flowSchema, srcPath) {
+  // const handler = HANDLER.hdrInv;
+  const flowTag = flowSchema.flowTag;
+  // const functionName = "EventBridge" + upperCase(handler);
+  // const action = SOURCE_GENERATE_IAM_ROLE.EventBridge;
+  // const fileName = `${upperCase(flowTag)}${upperCase(action)}_Main`;
+  return [
+    {
+      templatePath: templatePath,
+      templateData: {
+        functionName: 'EventBridge',
+        flowTag: flowTag,
+        roleName: SOURCE_GENERATE_IAM_ROLE.EventBridge,
+        // action: action,
+        firstLetterUpperCase: upperCase
+      },
+      setting: {
+        savePath: path.join(
+          srcPath,
+          SOURCE_PATH.flowSchemaEventBridge,
+          flowSchema.flowTag,
+          'source/'
+        ),
+        saveFileName: 'EventBridge_Main',
+        fileExtension: '.js',
+        isAppend: false
+      }
+    }
+  ];
+}
+
+export default data;

package/src/TemplateData/flowSchema/eventBridge/mainFunction/request.json

@@ -0,0 +1,5 @@
+{
+  "getDataDetail": "object",
+  "objectType": "string",
+  "functionName": "string"
+}

package/src/TemplateData/flowSchema/eventBridge/mainFunction/template.ejs

@@ -0,0 +1,59 @@
+/*
+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 />.
+  */
+
+
+
+//(<optionalRequire>)
+//(</optionalRequire>)
+
+/**
+ *
+ *
+ * description of function.
+ * @param {Object} _izContext
+ * @param {CorrelationIds} _izContext.correlationIds - property of _izContext
+ * @param {Logger} _izContext.logger - property of _izContext
+ * @param {Object} requestParams - request params
+ * @param {Object} requestParams.identifiers - identifiers for get data
+ * @param {Object} requestParams.additionalRequest - additionalRequest
+ *
+ *
+ * @returns {object} description of return value
+ */
+export default async function <%- functionName %>Main(
+  _izContext,
+  requestParams,
+  callingFlowConfig = {},
+  //(<additionalParams>)
+  //(</additionalParams>)
+  ) {
+
+
+  try {
+  _izContext.logger.debug('<%- functionName %> _izContext: ', _izContext);
+  _izContext.logger.debug('<%- functionName %> requestParams: ', requestParams);
+  _izContext.logger.debug('<%- functionName %> callingFlowConfig: ', callingFlowConfig);
+
+    //(<eventBridgeHook>)
+    //(</eventBridgeHook>)
+
+  } catch (err) {
+  _izContext.logger.error('error <%- firstLetterUpperCase(functionName) %>Main: ', err)
+    throw (err)
+  }
+}

package/src/TemplateData/flowSchema/externalTopic/Complete/functionYaml/data.js

@@ -0,0 +1,114 @@
+/*
+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 {
+  HANDLER,
+  SOURCE_PATH,
+  RESOURCE_CLASSES,
+  SNS_RESOURCE,
+  SAVE_FILE_NAME,
+  SQS_RESOURCE
+} = consts;
+
+const { firstLetterUpperCase: upperCase } = utils;
+const {
+  defaultIamRolePerAction,
+  createIamRole,
+  resourceNames,
+  shortNameHandler
+} = libs;
+const templatePath = path.join(__dirname, 'template.ejs');
+/**
+ * receive objectSchema
+ * create data for WebScoket handler template
+ *
+ * @param {Object} objectSchema
+ * @return {{templatePath, templateData,setting}}
+ */
+
+function data(_izContext, flowSchema, srcPath) {
+  if (!flowSchema.outputTopic) {
+    return [];
+  } else {
+    return [createSourceParams(_izContext, flowSchema, srcPath)];
+  }
+}
+
+function createSourceParams(_izContext, flowSchema, srcPath) {
+  let functionName = upperCase(flowSchema.flowTag) + 'Complete';
+  let handlerType = upperCase(HANDLER.hdrSqs);
+  let additionalResourcePermission = defaultIamRolePerAction();
+  let queueName = functionName + handlerType;
+  let topicOut = upperCase(flowSchema.flowTag) + '_Out';
+  additionalResourcePermission.push(
+    createIamRole(
+      {
+        [RESOURCE_CLASSES.sqs]: Object.values(SQS_RESOURCE)
+      },
+      [
+        resourceNames(RESOURCE_CLASSES.sqs, queueName),
+        resourceNames(RESOURCE_CLASSES.sqs, queueName + 'DLQ')
+      ]
+    )
+  );
+
+  if (Object.keys(flowSchema.flowSteps).includes('Out')) {
+    additionalResourcePermission.push(
+      createIamRole(
+        {
+          [RESOURCE_CLASSES.sns]: [SNS_RESOURCE.publish]
+        },
+        [resourceNames(RESOURCE_CLASSES.sns, topicOut)]
+      )
+    );
+  }
+
+  return {
+    templatePath: templatePath,
+    templateData: {
+      resourceLocation: path.join(
+        SOURCE_PATH.resourceLocationFlowSchema,
+        flowSchema.flowTag,
+        'source/'
+      ),
+      functionName,
+      handlerType,
+      additionalResourcePermission,
+      functionNameConfig:
+        upperCase(functionName) + upperCase(shortNameHandler(handlerType)),
+      roleName: upperCase(flowSchema.flowTag),
+      queueName
+    },
+    setting: {
+      savePath: path.join(srcPath, SOURCE_PATH.appYaml),
+      saveFileName: upperCase(SAVE_FILE_NAME.flowSchema),
+      fileExtension: '.yml',
+      isAppend: true
+    }
+  };
+}
+
+export default data;

package/src/TemplateData/flowSchema/externalTopic/Complete/functionYaml/template.ejs

@@ -0,0 +1,20 @@
+<%_ const join = require('path').join; _%>
+<%- firstLetterUpperCase(functionNameConfig) %>:
+  handler: <%- join(resourceLocation, `${firstLetterUpperCase(functionName)}_${firstLetterUpperCase(handlerType)}.main`)%>
+  name: ${self:custom.iz_resourcePrefix}<%- firstLetterUpperCase(functionName) %><%- firstLetterUpperCase(handlerType) %>
+  #<#<%- functionName %><%- handlerType %>FunctionSetting#>
+  #<#/<%- functionName %><%- handlerType %>FunctionSetting#>
+  role: <%- roleName %>Role
+  events:
+    - sqs:
+        arn: arn:aws:sqs:${self:custom.iz_region}:${self:custom.iz_accountId}:${self:custom.iz_resourcePrefix}<%- queueName %>
+        batchSize: 10
+        filterPatterns: #**** need to update serverless framework upper v.2.69.1
+          - body: {"MessageAttributes":{"callingFlow":{"Value":["${self:custom.iz_resourcePrefix}<%- functionName %>"]}}} # functionName of callingFlow
+          - body: {"MessageAttributes":{"callingFlow":{"Value":[{"exists":false}]}}}
+<%_ 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/flowSchema/externalTopic/Complete/handler/data.js

@@ -0,0 +1,76 @@
+/*
+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 {
+  HANDLER,
+  SOURCE_PATH,
+} = consts;
+
+const { firstLetterUpperCase: upperCase } = utils;
+
+const templatePath = path.join(__dirname, 'template.ejs');
+/**
+ * receive objectSchema
+ * create data for WebScoket handler template
+ *
+ * @param {Object} objectSchema
+ * @return {{templatePath, templateData,setting}}
+ */
+
+function data(_izContext, flowSchema, srcPath) {
+  if (!flowSchema.outputTopic) {
+    return [];
+  } else {
+    return [createSourceParams(_izContext, flowSchema, srcPath)];
+  }
+}
+
+function createSourceParams(_izContext, flowSchema, srcPath) {
+  let functionName = upperCase(flowSchema.flowTag) + 'Complete';
+  let handlerType = upperCase(HANDLER.hdrSqs);
+  let queueName = functionName + handlerType;
+
+  return {
+    templatePath: templatePath,
+    templateData: {
+      functionName,
+      handlerType,
+      queueName
+    },
+    setting: {
+      savePath: path.join(
+        srcPath,
+        SOURCE_PATH.flowSchema,
+        flowSchema.flowTag,
+        'source/'
+      ),
+      saveFileName: `${functionName}_${handlerType}`,
+      fileExtension: '.js',
+      isAppend: false
+    }
+  };
+}
+
+export default data;

package/src/TemplateData/flowSchema/externalTopic/Complete/handler/template.ejs

@@ -0,0 +1,81 @@
+/*
+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 } from "@izara_project/izara-middleware";
+import { recordHandlerSharedLib } from "@izara_project/izara-core-library-record-handler";
+import Logger from '@izara_project/izara-core-library-logger';
+
+import <%- functionName %> from './<%- functionName %>_Main.js';
+
+// validate event properties in body.Message of sqs event
+let perRecordsValidatorSchema = {}
+middleware.setValidatorSchema(recordHandlerSharedLib.baseValidatorSchema());
+
+module.exports.main = middleware.wrap(async (event, context) => {
+
+  try {
+
+    let recordPromises = [];
+
+    // loop each record and send to mainFunction
+    await Promise.all(event.Records.map(async record => { // promise.all for map() function
+
+      let passOnProperties = []
+      record._izContext.logger.debug('record ReceiveMsgOutHdrSqs', record);
+
+      //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
+        perRecordsValidatorSchema, // 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)
+      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
+    }))
+
+    Logger.debug('before Promise.all(recordPromises) in handler');
+    try {
+      // --- main await all promises
+      await Promise.all(recordPromises); // await all promises
+
+      return event.Records // return all for local testing
+
+    } 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, LambdaFunctionHdrSqs: ', err);
+    throw (err);
+  }
+});

package/src/TemplateData/flowSchema/externalTopic/Complete/mainFunction/data.js

@@ -0,0 +1,70 @@
+/*
+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 } = consts;
+
+const { firstLetterUpperCase: upperCase } = utils;
+const templatePath = path.join(__dirname, './template.ejs');
+
+/**
+ * receive objectSchema
+ * create data for WebScoket handler template
+ *
+ * @param {Object} objectSchema
+ * @return {{templatePath, templateData,setting}}
+ */
+
+function data(_izContext, flowSchema, srcPath) {
+  if (!flowSchema.outputTopic) {
+    return [];
+  } else {
+    return [createParamsForCreateSource(_izContext, flowSchema, srcPath)];
+  }
+}
+
+function createParamsForCreateSource(_izContext, flowSchema, srcPath) {
+  let functionName = upperCase(flowSchema.flowTag) + 'Complete';
+  let flowSchemaComplete = functionName + 'Complete';
+  return {
+    templatePath: templatePath,
+    templateData: {
+      flowTag: flowSchema.flowTag,
+      functionName,
+      flowSchemaComplete
+    },
+    setting: {
+      savePath: path.join(
+        srcPath,
+        SOURCE_PATH.flowSchema,
+        flowSchema.flowTag,
+        'source/'
+      ),
+      saveFileName: `${functionName}_Main`,
+      fileExtension: '.js',
+      isAppend: false
+    }
+  };
+}
+export default data;