@izara_project/izara-core-generate-service-code 1.0.45 → 1.0.47

package/src/generators/fromFlowSchema/flowStep/flowStep.js

@@ -0,0 +1,516 @@
+import path from 'path';
+import { fileURLToPath } from 'url';
+import consts from '#libs/Consts.js';
+import utils from '#libs/Utils.js';
+import libs from '#libs/Libs.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const {
+  HANDLER,
+  SOURCE_PATH,
+  RESOURCE_CLASSES,
+  SNS_RESOURCE,
+  SAVE_FILE_NAME,
+  SQS_RESOURCE
+} = consts;
+const { firstLetterUpperCase: upperCase, firstLetterLowerCase: lowerCase } =
+  utils;
+const {
+  shortNameHandler,
+  defaultIamRolePerAction,
+  createIamRole,
+  resourceNames
+} = libs;
+
+// ── Template paths ────────────────────────────────────────────────────────────
+
+const T = {
+  firstFlowStep: {
+    yaml: path.join(__dirname, 'firstFlowStep/templateYaml.ejs'),
+    handler: path.join(__dirname, 'firstFlowStep/templateHandler.ejs'),
+    main: path.join(__dirname, 'firstFlowStep/templateMain.ejs'),
+    resource: path.join(__dirname, 'firstFlowStep/templateResource.ejs')
+  },
+  afterPluginHook: {
+    handlerSqs: path.join(__dirname, 'afterPluginHook/handler/templateSqs.ejs'),
+    handlerDsq: path.join(__dirname, 'afterPluginHook/handler/templateDsq.ejs'),
+    main: path.join(__dirname, 'afterPluginHook/templateMain.ejs'),
+    yaml: path.join(__dirname, 'afterPluginHook/templateYaml.ejs'),
+    resource: path.join(__dirname, 'afterPluginHook/templateResource.ejs')
+  },
+  noPluginHook: {
+    handler: path.join(__dirname, 'noPlugInHook/templateHandler.ejs'),
+    main: path.join(__dirname, 'noPlugInHook/templateMain.ejs'),
+    yaml: path.join(__dirname, 'noPlugInHook/templateYaml.ejs'),
+    resource: path.join(__dirname, 'noPlugInHook/templateResource.ejs')
+  }
+};
+
+// ── IAM helpers ───────────────────────────────────────────────────────────────
+
+const sqsPermissions = names =>
+  createIamRole(
+    {
+      [RESOURCE_CLASSES.sqs]: [
+        SQS_RESOURCE.sendMessage,
+        SQS_RESOURCE.receiveMessage,
+        SQS_RESOURCE.deleteMessage,
+        SQS_RESOURCE.getQueueAttributes,
+        SQS_RESOURCE.deleteMessageBatch,
+        SQS_RESOURCE.getQueueUrl
+      ]
+    },
+    names
+  );
+
+const snsPublish = name =>
+  createIamRole({ [RESOURCE_CLASSES.sns]: [SNS_RESOURCE.publish] }, [
+    resourceNames(RESOURCE_CLASSES.sns, name)
+  ]);
+
+// ── Section builders ──────────────────────────────────────────────────────────
+
+function buildFirstPluginHookResources(
+  flowTag,
+  flowStepName,
+  flowStepConfig,
+  flowSchemaSourcePath,
+  saveFilePath,
+  currentIndex
+) {
+  const firstIndex = 1;
+  const iamRole = defaultIamRolePerAction();
+  iamRole.push(
+    snsPublish(`${flowTag}_${flowStepName}_In`),
+    sqsPermissions([
+      resourceNames(
+        RESOURCE_CLASSES.sqs,
+        upperCase(flowTag) + upperCase(flowStepName) + firstIndex
+      ),
+      resourceNames(
+        RESOURCE_CLASSES.sqs,
+        upperCase(flowTag) + upperCase(flowStepName) + firstIndex + 'DLQ'
+      )
+    ])
+  );
+
+  return [
+    {
+      templatePath: T.firstFlowStep.handler,
+      templateData: {
+        functionName: `${lowerCase(flowStepName)}${firstIndex}`,
+        fileNameHandler: `${upperCase(flowStepName)}_${firstIndex}_Main`,
+        queueName: `${upperCase(flowTag)}${upperCase(flowStepName)}${firstIndex}`
+      },
+      setting: {
+        savePath: flowSchemaSourcePath,
+        saveFileName: `${upperCase(flowStepName)}_${firstIndex}_${upperCase(HANDLER.hdrSqs)}`,
+        fileExtension: '.js',
+        isAppend: false
+      }
+    },
+    {
+      templatePath: T.firstFlowStep.main,
+      templateData: {
+        topicArn: `${upperCase(flowTag)}_${upperCase(flowStepName)}_${firstIndex}`,
+        functionName: `${lowerCase(flowStepName)}${firstIndex}`,
+        plugHookTag: flowStepConfig.plugInHooks[0].plugInHookTag,
+        objType: flowStepConfig.plugInHooks[0].objType,
+        flowTag,
+        flowStepName,
+        flowStepIndex: firstIndex,
+        queueNameDsq: `${upperCase(flowTag)}${upperCase(flowStepName)}${currentIndex}HdrDsq`,
+        upperFlowTag: upperCase(flowTag),
+        upperFlowStepName: upperCase(flowStepName)
+      },
+      setting: {
+        savePath: flowSchemaSourcePath,
+        saveFileName: `${upperCase(flowStepName)}_${firstIndex}_Main`,
+        fileExtension: '.js',
+        isAppend: false
+      }
+    },
+    {
+      templatePath: T.firstFlowStep.yaml,
+      templateData: {
+        handlerFilePath: path.join(
+          SOURCE_PATH.resourceLocationFlowSchema,
+          upperCase(flowTag),
+          upperCase(flowStepName),
+          'source/',
+          `${upperCase(flowStepName)}_${firstIndex}_${upperCase(HANDLER.hdrSqs)}`
+        ),
+        functionName: upperCase(flowStepName) + firstIndex + HANDLER.hdrSqs,
+        additionalResourcePermission: iamRole,
+        functionNameConfig:
+          upperCase(flowStepName) +
+          '1' +
+          upperCase(shortNameHandler(HANDLER.hdrSqs)),
+        roleName: upperCase(flowTag),
+        queueNameSqs: `${upperCase(flowTag)}${upperCase(flowStepName)}${firstIndex}`
+      },
+      setting: {
+        savePath: path.join(saveFilePath, SOURCE_PATH.appYaml),
+        saveFileName: SAVE_FILE_NAME.flowSchemaYaml,
+        fileExtension: '.yml',
+        isAppend: true
+      }
+    },
+    {
+      templatePath: T.firstFlowStep.resource,
+      templateData: {
+        queueName: `${upperCase(flowTag)}${upperCase(flowStepName)}${firstIndex}`,
+        topicName: `${upperCase(flowTag)}_${upperCase(flowStepName)}_${firstIndex}`,
+        resourceName: upperCase(flowTag) + upperCase(flowStepName) + firstIndex
+      },
+      setting: {
+        initialData: 'Resources:\n',
+        savePath: path.join(saveFilePath, SOURCE_PATH.resourceYaml),
+        saveFileName: SAVE_FILE_NAME.snsInSqsYaml,
+        fileExtension: '.yml',
+        isAppend: true
+      }
+    }
+  ];
+}
+
+function buildAfterPluginHookResources(
+  flowTag,
+  flowStepName,
+  pluginHook,
+  flowSchemaSourcePath,
+  saveFilePath,
+  currentIndex,
+  afterPlugInHookTag,
+  roleName
+) {
+  const iamRole = defaultIamRolePerAction();
+  const topicIn = `${upperCase(flowTag)}_${upperCase(flowStepName)}_${currentIndex}_In`;
+  iamRole.push(
+    snsPublish(topicIn),
+    sqsPermissions([
+      resourceNames(
+        RESOURCE_CLASSES.sqs,
+        upperCase(flowTag) + upperCase(flowStepName) + currentIndex
+      ),
+      resourceNames(
+        RESOURCE_CLASSES.sqs,
+        upperCase(flowTag) + upperCase(flowStepName) + currentIndex + 'DLQ'
+      )
+    ]),
+    sqsPermissions([
+      resourceNames(
+        RESOURCE_CLASSES.sqs,
+        upperCase(flowTag) + upperCase(flowStepName) + currentIndex + 'HdrDsq'
+      ),
+      resourceNames(
+        RESOURCE_CLASSES.sqs,
+        upperCase(flowTag) +
+        upperCase(flowStepName) +
+        currentIndex +
+        'HdrDsqDLQ'
+      )
+    ])
+  );
+
+  return [
+    {
+      templatePath: T.afterPluginHook.handlerSqs,
+      templateData: {
+        topicArn: `${lowerCase(flowTag)}${lowerCase(flowStepName)}${currentIndex}`,
+        functionName: `${lowerCase(flowStepName)}${currentIndex}`,
+        fileNameHandler: `${upperCase(flowStepName)}_${currentIndex}`,
+        queueName: `${upperCase(flowTag)}${upperCase(flowStepName)}${currentIndex}`
+      },
+      setting: {
+        savePath: flowSchemaSourcePath,
+        saveFileName: `${upperCase(flowStepName)}_${currentIndex}_HdrSqs`,
+        fileExtension: '.js',
+        isAppend: false
+      }
+    },
+    {
+      templatePath: T.afterPluginHook.handlerDsq,
+      templateData: {
+        topicArn: `${lowerCase(flowTag)}${lowerCase(flowStepName)}${currentIndex}HdrDsq`,
+        functionName: `${lowerCase(flowStepName)}${currentIndex}HdrDsq`,
+        fileNameHandler: `${upperCase(flowStepName)}_${currentIndex}`,
+        queueName: `${upperCase(flowTag)}${upperCase(flowStepName)}${currentIndex}HdrDsq`
+      },
+      setting: {
+        savePath: flowSchemaSourcePath,
+        saveFileName: `${upperCase(flowStepName)}_${currentIndex}_HdrDsq`,
+        fileExtension: '.js',
+        isAppend: false
+      }
+    },
+    {
+      templatePath: T.afterPluginHook.main,
+      templateData: {
+        topicArn: `${lowerCase(flowTag)}${lowerCase(flowStepName)}${currentIndex}`,
+        functionName: `${lowerCase(flowStepName)}${currentIndex}`,
+        afterPlugInHookTag,
+        plugInHookTag: pluginHook.plugInHookTag,
+        objType: pluginHook.objType,
+        queueNameDsq: `${upperCase(flowTag)}${upperCase(flowStepName)}${currentIndex}HdrDsq`,
+        flowTag,
+        flowStepName,
+        flowStepIndex: currentIndex - 1,
+        plugHookTag: pluginHook.plugInHookTag,
+        upperFlowTag: upperCase(flowTag),
+        upperFlowStepName: upperCase(flowStepName)
+      },
+      setting: {
+        savePath: flowSchemaSourcePath,
+        saveFileName: `${upperCase(flowStepName)}_${currentIndex}_Main`,
+        fileExtension: '.js',
+        isAppend: false
+      }
+    },
+    {
+      templatePath: T.afterPluginHook.yaml,
+      templateData: {
+        handlerFilePathSqs: path.join(
+          SOURCE_PATH.resourceLocationFlowSchema,
+          upperCase(flowTag),
+          upperCase(flowStepName),
+          'source/',
+          `${upperCase(flowStepName)}_${currentIndex}_HdrSqs`
+        ),
+
+        handlerFilePathDsq: path.join(
+          SOURCE_PATH.resourceLocationFlowSchema,
+          upperCase(flowTag),
+          upperCase(flowStepName),
+          'source/',
+          `${upperCase(flowStepName)}_${currentIndex}_HdrDsq`
+        ),
+
+        functionNameConfigSqs:
+          upperCase(flowStepName) +
+          currentIndex +
+          upperCase(shortNameHandler(upperCase(HANDLER.hdrSqs))),
+
+        functionNameConfigDsq:
+          upperCase(flowStepName) +
+          currentIndex +
+          upperCase(shortNameHandler(upperCase(HANDLER.hdrDsq))),
+
+        functionNameSqs:
+          upperCase(flowStepName) + currentIndex + upperCase(HANDLER.hdrSqs),
+
+        functionNameDsq:
+          upperCase(flowStepName) + currentIndex + upperCase(HANDLER.hdrDsq),
+
+        additionalResourcePermission: iamRole,
+        roleName,
+        queueName: upperCase(flowTag) + upperCase(flowStepName) + currentIndex,
+        upperRoleName: upperCase(roleName)
+      },
+      setting: {
+        savePath: path.join(saveFilePath, SOURCE_PATH.appYaml),
+        saveFileName: SAVE_FILE_NAME.flowSchemaYaml,
+        fileExtension: '.yml',
+        isAppend: true
+      }
+    },
+    {
+      templatePath: T.afterPluginHook.resource,
+      templateData: {
+        resourceName:
+          upperCase(flowTag) + upperCase(flowStepName) + currentIndex,
+        topicName: `${upperCase(flowTag)}_${upperCase(flowStepName)}_${currentIndex}`
+      },
+      setting: {
+        initialData: 'Resources:\n',
+        savePath: path.join(saveFilePath, SOURCE_PATH.resourceYaml),
+        saveFileName: SAVE_FILE_NAME.snsInSqsYaml,
+        fileExtension: '.yml',
+        isAppend: true
+      }
+    }
+  ];
+}
+
+function buildNoPluginHookResources(
+  flowTag,
+  flowStepName,
+  flowSchemaSourcePath,
+  saveFilePath
+) {
+  const iamRole = defaultIamRolePerAction();
+  iamRole.push(
+    snsPublish(`${flowTag}_${flowStepName}_In`),
+    sqsPermissions([
+      resourceNames(
+        RESOURCE_CLASSES.sqs,
+        upperCase(flowTag) + upperCase(flowStepName)
+      ),
+      resourceNames(
+        RESOURCE_CLASSES.sqs,
+        upperCase(flowTag) + upperCase(flowStepName) + 'DLQ'
+      )
+    ])
+  );
+
+  return [
+    {
+      templatePath: T.noPluginHook.handler,
+      templateData: {
+        functionName: lowerCase(flowStepName),
+        fileMainName: `${upperCase(flowStepName)}_Main`,
+        queueName: `${upperCase(flowTag)}${upperCase(flowStepName)}`
+      },
+      setting: {
+        savePath: flowSchemaSourcePath,
+        saveFileName: `${upperCase(flowStepName)}_${upperCase(HANDLER.hdrSqs)}`,
+        fileExtension: '.js',
+        isAppend: false
+      }
+    },
+    {
+      templatePath: T.noPluginHook.main,
+      templateData: {
+        topicArn: `${upperCase(flowTag)}_${upperCase(flowStepName)}`,
+        functionName: lowerCase(flowStepName)
+      },
+      setting: {
+        savePath: flowSchemaSourcePath,
+        saveFileName: `${upperCase(flowStepName)}_Main`,
+        fileExtension: '.js',
+        isAppend: false
+      }
+    },
+    {
+      templatePath: T.noPluginHook.yaml,
+      templateData: {
+        handlerFilePath: path.join(
+          SOURCE_PATH.resourceLocationFlowSchema,
+          upperCase(flowTag),
+          upperCase(flowStepName),
+          'source/',
+          `${upperCase(flowStepName)}_${upperCase(HANDLER.hdrSqs)}`
+        ),
+        functionName:
+          upperCase(flowTag) +
+          upperCase(flowStepName) +
+          upperCase(HANDLER.hdrSqs),
+        additionalResourcePermission: iamRole,
+        functionNameConfig:
+          upperCase(flowTag) +
+          upperCase(flowStepName) +
+          upperCase(shortNameHandler(HANDLER.hdrSqs)),
+        roleName: upperCase(flowTag),
+        queueNameSqs: `${upperCase(flowTag)}${upperCase(flowStepName)}`
+      },
+      setting: {
+        savePath: path.join(saveFilePath, SOURCE_PATH.appYaml),
+        saveFileName: SAVE_FILE_NAME.flowSchemaYaml,
+        fileExtension: '.yml',
+        isAppend: true
+      }
+    },
+    {
+      templatePath: T.noPluginHook.resource,
+      templateData: {
+        queueName: `${upperCase(flowTag)}${upperCase(flowStepName)}`,
+        topicName: `${upperCase(flowTag)}_${upperCase(flowStepName)}_In`,
+        resourceName: upperCase(flowTag) + upperCase(flowStepName)
+      },
+      setting: {
+        initialData: 'Resources:\n',
+        savePath: path.join(saveFilePath, SOURCE_PATH.resourceYaml),
+        saveFileName: SAVE_FILE_NAME.snsInSqsYaml,
+        fileExtension: '.yml',
+        isAppend: true
+      }
+    }
+  ];
+}
+
+// ── Main ──────────────────────────────────────────────────────────────────────
+
+/**
+ * Builds FlowStep resources for each step in the flow schema
+ * @param {Object} _izContext - Context object with logger
+ * @param {Object} flowSchema - Flow schema containing flowSteps definitions
+ * @param {string} saveFilePath - Base path where generated files will be saved
+ * @returns {Array} Array of resource generation configurations
+ */
+function buildFlowStepResources(_izContext, flowSchema, saveFilePath) {
+  try {
+    if (!flowSchema?.flowSteps || !Object.keys(flowSchema.flowSteps).length)
+      return [];
+
+    const results = [];
+
+    for (const [flowStepName, flowStepConfig] of Object.entries(
+      flowSchema.flowSteps
+    )) {
+      if (flowStepName === 'In' || flowStepName === 'Out') continue;
+
+      const flowTag = flowSchema.flowTag;
+      const roleName = upperCase(flowTag);
+      const flowSchemaSourcePath = path.join(
+        saveFilePath,
+        consts.SOURCE_PATH.flowSchema,
+        upperCase(flowTag) + '/',
+        `${upperCase(flowStepName)}/source/`
+      );
+
+      if (flowStepConfig.plugInHooks?.length) {
+        flowStepConfig.plugInHooks.forEach((pluginHook, index) => {
+          const currentIndex = index + 2;
+          const afterPlugInHookTag =
+            flowStepConfig.plugInHooks[index + 1]?.plugInHookTag;
+
+          // first step resources (index === 0 only)
+          if (index === 0) {
+            results.push(
+              ...buildFirstPluginHookResources(
+                flowTag,
+                flowStepName,
+                flowStepConfig,
+                flowSchemaSourcePath,
+                saveFilePath,
+                currentIndex
+              )
+            );
+          }
+
+          // after plugin hook resources (every index)
+          results.push(
+            ...buildAfterPluginHookResources(
+              flowTag,
+              flowStepName,
+              pluginHook,
+              flowSchemaSourcePath,
+              saveFilePath,
+              currentIndex,
+              afterPlugInHookTag,
+              roleName
+            )
+          );
+        });
+      } else {
+        results.push(
+          ...buildNoPluginHookResources(
+            flowTag,
+            flowStepName,
+            flowSchemaSourcePath,
+            saveFilePath
+          )
+        );
+      }
+    }
+
+    return results.flat();
+  } catch (error) {
+    console.error('Error in buildFlowStepResources flowStep:', error);
+    return [];
+  }
+}
+
+export default buildFlowStepResources;