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

package/src/generators/fromObjectSchema/endpoint/handler/api.js

@@ -0,0 +1,55 @@
+/*
+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/>.
+*/
+
+// api data.js
+import path from 'path';
+import { fileURLToPath } from 'url';
+import consts from '#libs/Consts.js';
+import utils from '#libs/Utils.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const { HANDLER, SOURCE_PATH } = consts;
+const { firstLetterUpperCase: upperCase } = utils;
+
+const templatePath = path.join(__dirname, 'apiTemplate.ejs');
+
+/**
+ * Generates hdrApi handler source params for a given action
+ * @param {Object} _izContext - Context object with logger
+ * @param {string} srcPath - Source path
+ * @param {string} action - Action name (create/update/get/delete)
+ * @returns {Array} Array of source params
+ */
+function data(_izContext, srcPath, { action, saveFileName, templateData }) {
+  return [
+    {
+      templatePath,
+      templateData,
+      setting: {
+        savePath: path.join(srcPath, SOURCE_PATH.endpointPerService),
+        saveFileName:
+          saveFileName ?? `${upperCase(action)}_${upperCase(HANDLER.hdrApi)}`,
+        fileExtension: '.js',
+        isAppend: false
+      }
+    }
+  ];
+}
+
+export default data;

package/src/generators/fromObjectSchema/endpoint/handler/beforeLogical.js

@@ -0,0 +1,56 @@
+/*
+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/>.
+*/
+
+// sqs data.js
+import path from 'path';
+import { fileURLToPath } from 'url';
+import consts from '#libs/Consts.js';
+import utils from '#libs/Utils.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const { HANDLER, SOURCE_PATH } = consts;
+const { firstLetterUpperCase: upperCase } = utils;
+
+const templatePath = path.join(__dirname, 'beforeLogicalTemplate.ejs');
+
+/**
+ * Generates hdrSqs handler source params for a given action
+ * @param {Object} _izContext - Context object with logger
+ * @param {string} srcPath - Source path
+ * @param {string} action - Action name (create/update/get/delete)
+ * @returns {Array} Array of source params
+ */
+function data(_izContext, srcPath, { saveFileName, templateData }) {
+  return [
+    {
+      templatePath,
+      templateData,
+      setting: {
+        savePath: path.join(srcPath, SOURCE_PATH.endpointPerService),
+        saveFileName:
+          saveFileName ??
+          `${upperCase(templateData.action)}_${upperCase(HANDLER.hdrSqs)}`,
+        fileExtension: '.js',
+        isAppend: false
+      }
+    }
+  ];
+}
+
+export default data;

package/src/generators/fromObjectSchema/endpoint/handler/dsq.js

@@ -0,0 +1,55 @@
+/*
+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/>.
+*/
+
+// dsq data.js
+import path from 'path';
+import { fileURLToPath } from 'url';
+import consts from '#libs/Consts.js';
+import utils from '#libs/Utils.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const { HANDLER, SOURCE_PATH } = consts;
+const { firstLetterUpperCase: upperCase } = utils;
+
+const templatePath = path.join(__dirname, 'dsqTemplate.ejs');
+
+/**
+ * Generates hdrDsq handler source params for a given action
+ * @param {Object} _izContext - Context object with logger
+ * @param {string} srcPath - Source path
+ * @param {string} action - Action name (create/update/get/delete)
+ * @returns {Array} Array of source params
+ */
+function data(_izContext, srcPath, { action, saveFileName, templateData }) {
+  return [
+    {
+      templatePath,
+      templateData,
+      setting: {
+        savePath: path.join(srcPath, SOURCE_PATH.endpointPerService),
+        saveFileName:
+          saveFileName ?? `${upperCase(action)}_${upperCase(HANDLER.hdrDsq)}`,
+        fileExtension: '.js',
+        isAppend: false
+      }
+    }
+  ];
+}
+
+export default data;

package/src/generators/fromObjectSchema/endpoint/handler/inv.js

@@ -0,0 +1,55 @@
+/*
+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/>.
+*/
+
+// inv data.js
+import path from 'path';
+import { fileURLToPath } from 'url';
+import consts from '#libs/Consts.js';
+import utils from '#libs/Utils.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const { HANDLER, SOURCE_PATH } = consts;
+const { firstLetterUpperCase: upperCase } = utils;
+
+const templatePath = path.join(__dirname, 'invTemplate.ejs');
+
+/**
+ * Generates hdrInv handler source params for a given action
+ * @param {Object} _izContext - Context object with logger
+ * @param {string} srcPath - Source path
+ * @param {string} action - Action name (create/update/get/delete)
+ * @returns {Array} Array of source params
+ */
+function data(_izContext, srcPath, { action, saveFileName, templateData }) {
+  return [
+    {
+      templatePath,
+      templateData,
+      setting: {
+        savePath: path.join(srcPath, SOURCE_PATH.endpointPerService),
+        saveFileName:
+          saveFileName ?? `${upperCase(action)}_${upperCase(HANDLER.hdrInv)}`,
+        fileExtension: '.js',
+        isAppend: false
+      }
+    }
+  ];
+}
+
+export default data;

package/src/generators/fromObjectSchema/endpoint/handler/sqs.js

@@ -0,0 +1,55 @@
+/*
+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/>.
+*/
+
+// sqs data.js
+import path from 'path';
+import { fileURLToPath } from 'url';
+import consts from '#libs/Consts.js';
+import utils from '#libs/Utils.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const { HANDLER, SOURCE_PATH } = consts;
+const { firstLetterUpperCase: upperCase } = utils;
+
+const templatePath = path.join(__dirname, 'sqsTemplate.ejs');
+
+/**
+ * Generates hdrSqs handler source params for a given action
+ * @param {Object} _izContext - Context object with logger
+ * @param {string} srcPath - Source path
+ * @param {string} action - Action name (create/update/get/delete)
+ * @returns {Array} Array of source params
+ */
+function data(_izContext, srcPath, { action, saveFileName, templateData }) {
+  return [
+    {
+      templatePath,
+      templateData,
+      setting: {
+        savePath: path.join(srcPath, SOURCE_PATH.endpointPerService),
+        saveFileName:
+          saveFileName ?? `${upperCase(action)}_${upperCase(HANDLER.hdrSqs)}`,
+        fileExtension: '.js',
+        isAppend: false
+      }
+    }
+  ];
+}
+
+export default data;

package/src/generators/fromObjectSchema/endpoint/index.js

@@ -0,0 +1,290 @@
+/*
+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 { NoRetryError } from '@izara_project/izara-core-library-core';
+
+import invHandler from './handler/inv.js';
+import apiHandler from './handler/api.js';
+import sqsHandler from './handler/sqs.js';
+import dsqHandler from './handler/dsq.js';
+
+import getMain from './main/get/get.js';
+import createMain from './main/create/create.js';
+import updateMain from './main/update/update.js';
+import deleteMain from './main/delete/delete.js';
+
+import beforeLogicalMain from './main/beforeLogical/beforeLogical.js';
+import beforeLogicalHandler from './handler/beforeLogical.js';
+
+import yamlGenerator from './yaml.js';
+import createResource from './resource.js';
+
+import consts from '#libs/Consts.js';
+const { HANDLER } = consts;
+
+import utils from '#libs/Utils.js';
+const { firstLetterUpperCase: upperCase } = utils;
+
+const HANDLER_MAP = {
+  hdrApi: apiHandler,
+  hdrInv: invHandler,
+  hdrSqs: sqsHandler,
+  hdrDsq: dsqHandler
+};
+
+const endpoint = {
+  get: {
+    phases: [{ key: 'main', fn: getMain }],
+    handlers: [HANDLER.hdrApi, HANDLER.hdrInv]
+  },
+  create: {
+    phases: [
+      { key: 'main', fn: createMain },
+      {
+        key: 'beforeLogical',
+        fn: beforeLogicalMain,
+        fnHandler: beforeLogicalHandler
+      }
+    ],
+    handlers: [HANDLER.hdrInv, HANDLER.hdrSqs]
+  },
+  update: {
+    phases: [
+      { key: 'main', fn: updateMain },
+      {
+        key: 'beforeLogical',
+        fn: beforeLogicalMain,
+        fnHandler: beforeLogicalHandler
+      }
+    ],
+    handlers: [HANDLER.hdrInv, HANDLER.hdrSqs]
+  },
+  delete: {
+    phases: [
+      { key: 'main', fn: deleteMain },
+      {
+        key: 'beforeLogical',
+        fn: beforeLogicalMain,
+        fnHandler: beforeLogicalHandler
+      }
+    ],
+    handlers: [HANDLER.hdrInv, HANDLER.hdrSqs]
+  }
+};
+
+/**
+ * Generates endpoint component source params per object schema
+ * @param {Object} _izContext - Context object with logger
+ * @param {string} appPath - Root path of the service
+ * @param {Array} allObjSchemas - All object schemas
+ * @param {Array} generatedCodeConfigFromFlowSchemas - Generated code configs from flow schemas
+ * @returns {Promise<Array>} Array of generated source params
+ */
+async function endpointComponent(
+  _izContext,
+  appPath,
+  allObjSchemas,
+  generatedCodeConfigFromFlowSchemas
+) {
+  try {
+    const createSourceParams = [];
+
+    // ── Flatten generatedCodeConfig ───────────────────────────────────────
+    const generatedCodeConfig = generatedCodeConfigFromFlowSchemas
+      .filter(
+        ({ generatedCodeConfig }) =>
+          generatedCodeConfig?.objType?.objectType !== undefined
+      )
+      .map(({ generatedCodeConfig, flowTag }) => ({
+        ...generatedCodeConfig,
+        flowTag
+      }));
+
+    console.debug(
+      '[endpointComponent] generatedCodeConfig=',
+      generatedCodeConfig
+    );
+
+    // ── Per action ────────────────────────────────────────────────────────
+    for (const [action, { handlers }] of Object.entries(endpoint)) {
+      const configPerAction = generatedCodeConfig.filter(
+        c => c.generatedCodeTag === action
+      );
+
+      const hasConfig = configPerAction.length > 0;
+
+      // ? ── Base handlers ─────────────────────────────────────────────────
+      for (const type of handlers) {
+        const queueName =
+          type === HANDLER.hdrSqs || type === HANDLER.hdrDsq
+            ? upperCase(action) + upperCase(type)
+            : '';
+        const params = HANDLER_MAP[type](_izContext, appPath, {
+          action,
+          saveFileName: `${upperCase(action)}_${upperCase(type)}`,
+          templateData: {
+            action,
+            handler: upperCase(type),
+            queueName,
+            functionMainName: action + 'Main',
+            fileMainName: upperCase(action) + '_Main.js',
+            upperQueueName: upperCase(queueName)
+          }
+        });
+        createSourceParams.push(...params);
+      }
+
+      // ? ── Additional phase handlers (main2, main3, ...) ─────────────────
+      if (hasConfig) {
+        const hasBeforeLogical = configPerAction.some(
+          c => c.codeHookTag === 'beforeLogical'
+        );
+
+        if (hasBeforeLogical) {
+          const type = HANDLER.hdrSqs;
+          const handler = endpoint[action].phases.find(
+            p => p.key === 'beforeLogical'
+          )?.fnHandler;
+          const params = handler(_izContext, appPath, {
+            saveFileName: `${upperCase(action)}BeforeLogical_${upperCase(type)}`,
+            templateData: {
+              action: `${action}`,
+              handler: upperCase(type),
+              queueName: upperCase(action) + 'BeforeLogical' + upperCase(type),
+              functionMainName: action + 'BeforeLogicalMain',
+              fileMainName: upperCase(action) + 'BeforeLogical' + '_Main.js',
+              getFlowTag: true
+            }
+          });
+          createSourceParams.push(...params);
+        }
+      }
+
+      // ── Main functions ────────────────────────────────────────────────
+      const createMainFile = endpoint[action].phases
+        .filter(phase => phase.key === 'main')
+        .map(({ fn }) => fn(_izContext, appPath, configPerAction));
+
+      createSourceParams.push(...createMainFile.flat());
+
+      // -- Main BeforeLogical --------------------------------------------
+      if (hasConfig) {
+        const hasBeforeLogical = configPerAction.some(
+          c => c.codeHookTag === 'beforeLogical'
+        );
+
+        if (hasBeforeLogical) {
+          const result = endpoint[action].phases
+            .filter(phase => phase.key === 'beforeLogical')
+            .map(({ fn }) => fn(_izContext, appPath, action, configPerAction));
+
+          createSourceParams.push(...result.flat());
+        }
+      }
+
+      // ── Yaml — base handlers ──────────────────────────────────────────
+      for (const handler of handlers) {
+        const result = await yamlGenerator(
+          _izContext,
+          allObjSchemas,
+          appPath,
+          action,
+          handler
+        ).catch(error => {
+          console.error(
+            `[endpointComponent] error base yaml action=${action} handler=${handler}:`,
+            error
+          );
+          return [];
+        });
+
+        createSourceParams.push(...result);
+      }
+
+      // ── Yaml — phase entries ──────────────────────────────────────────────
+      if (hasConfig) {
+        const checkCodeHookTag = configPerAction.find(
+          c => c.codeHookTag === 'beforeLogical'
+        );
+        if (checkCodeHookTag) {
+          const ownTopicFlowTags = configPerAction
+            .filter(c => c.invocationType === 'ownTopic')
+            .map(c => c.flowTag);
+
+          const result = await yamlGenerator(
+            _izContext,
+            allObjSchemas,
+            appPath,
+            action,
+            HANDLER.hdrSqs,
+            'BeforeLogical',
+            ownTopicFlowTags
+          ).catch(error => {
+            console.error(
+              `[endpointComponent] error phase yaml action=${action}:`,
+              error
+            );
+            return [];
+          });
+
+          createSourceParams.push(...result);
+        }
+      }
+
+      if (
+        handlers.includes(HANDLER.hdrSqs) ||
+        handlers.includes(HANDLER.hdrDsq)
+      ) {
+        const sourceResource = createResource(_izContext, appPath, {
+          queueName: upperCase(action)
+        });
+
+        createSourceParams.push(sourceResource);
+      }
+
+      if (hasConfig) {
+        if (
+          configPerAction.find(c => c.codeHookTag === 'beforeLogical') &&
+          configPerAction.some(c => c.invocationType === 'ownTopic')
+        ) {
+          const flowTags = configPerAction
+            .filter(c => c.invocationType === 'ownTopic')
+            .map(c => c.flowTag);
+
+          const sourceResourceBeforeLogical = createResource(
+            _izContext,
+            appPath,
+            {
+              queueName: upperCase(action) + 'BeforeLogical',
+              type: 'beforeLogical',
+              flowTags: flowTags
+            }
+          );
+
+          createSourceParams.push(sourceResourceBeforeLogical);
+        }
+      }
+    }
+
+    return createSourceParams;
+  } catch (error) {
+    console.error('[endpointComponent] error:', error);
+    return [];
+  }
+}
+
+export default endpointComponent;

package/src/generators/fromObjectSchema/endpoint/main/beforeLogical/beforeLogical.js

@@ -0,0 +1,54 @@
+/*
+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 { firstLetterLowerCase: lowerCase, firstLetterUpperCase: upperCase } =
+  utils;
+
+const templatePath = path.join(__dirname, 'template.ejs');
+
+function createSource(_izContext, appPath, action, generatedCodeConfig = []) {
+  const functionName = upperCase(action);
+
+  const upperFunctionName = upperCase(functionName);
+
+  return {
+    templatePath: templatePath,
+    templateData: {
+      action,
+      functionName,
+      generatedCodeConfig,
+      upperFunctionName
+    },
+    setting: {
+      savePath: path.join(appPath, SOURCE_PATH.endpointPerService),
+      saveFileName: `${upperCase(functionName)}BeforeLogical_Main`,
+      fileExtension: '.js',
+      isAppend: false
+    }
+  };
+}
+
+export default createSource;