@izara_project/izara-core-generate-service-code 1.0.51 → 1.0.53

package/src/codeGenerators/app/src/generatedCode/Flow/FlowRbac/templates/rbac/ListRolePermissions.ejs

@@ -0,0 +1,120 @@
+/*
+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 dynamodbSharedLib from '@izara_project/izara-core-library-dynamodb';
+import snsSharedLib from '@izara_project/izara-core-library-sns';
+import sqsSharedLib from '@izara_project/izara-core-library-sqs';
+import asyncFlowSharedLib from '@izara_project/izara-core-library-asynchronous-flow';
+import callingFlowSharedLib from '@izara_project/izara-core-library-calling-flow';
+import lambdaSharedLib from '@izara_project/izara-core-library-lambda';
+
+//(<optionalImport>)
+import { getObjectSchema } from '@izara_project/izara-core-library-service-schemas';
+import {
+  lambda,
+  sns,
+  sqs
+} from '@izara_project/izara-core-library-external-request';
+import { identifierUuid } from '@izara_project/izara-shared-core';
+import { consts, NoRetryError } from '@izara_project/izara-core-library-core';
+import { utils } from '@izara_project/izara-core-library-service-schemas';
+
+const { createFlowTypeConcat } = utils;
+//(</optionalImport>)
+
+/**
+ *
+ *
+ * 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 Process<%=  flowTag %>(
+  _izContext,
+  requestParams,
+  callingFlowConfig = {}
+  //(<additionalParams>)
+  //(</additionalParams>)
+) {
+  try {
+    _izContext.logger.debug(
+      'Process<%= flowTag %> _izContext',
+      _izContext
+    );
+    _izContext.logger.debug(
+      'Process<%= flowTag %> requestParams',
+      requestParams
+    );
+    _izContext.logger.debug(
+      'Process<%= flowTag %> callingFlowConfig',
+      callingFlowConfig
+    );
+
+    const { roleIdKey } = requestParams;
+
+    _izContext.logger.debug(
+      '[Rbac:Process<%=  flowTag %>] roleIdKey',
+      roleIdKey
+    );
+
+    const resultQuery = await dynamodbSharedLib.query(
+      _izContext,
+      dynamodbSharedLib.tableName(_izContext, 'RolePermissions'),
+      {
+        roleIdKey
+      }
+    );
+
+    _izContext.logger.debug(
+      '[Rbac:Process<%=  flowTag %>] resultQuery',
+      resultQuery
+    );
+
+    const message = {
+      returnResult: {
+        records: resultQuery.Items || []
+      }
+    };
+
+    const messageResult = {
+      message,
+      TopicArn: snsSharedLib.snsTopicArnByFlowSchema(_izContext, `<%- flowTag %>_Out`)
+    };
+
+    _izContext.logger.debug(
+      '[Rbac:Process<%=  flowTag %>] messageResult',
+      messageResult
+    );
+
+    await sns.publishMessage(_izContext, messageResult);
+  } catch (err) {
+    _izContext.logger.error(
+      '[Rbac:Process<%=  flowTag %>] error: ',
+      err
+    );
+    throw err;
+  }
+}

package/src/codeGenerators/app/src/generatedCode/Flow/FlowRbac/templates/rbac/ListTargetRole.ejs

@@ -0,0 +1,122 @@
+/*
+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 dynamodbSharedLib from '@izara_project/izara-core-library-dynamodb';
+import snsSharedLib from '@izara_project/izara-core-library-sns';
+import sqsSharedLib from '@izara_project/izara-core-library-sqs';
+import asyncFlowSharedLib from '@izara_project/izara-core-library-asynchronous-flow';
+import callingFlowSharedLib from '@izara_project/izara-core-library-calling-flow';
+import lambdaSharedLib from '@izara_project/izara-core-library-lambda';
+
+//(<optionalImport>)
+import { getObjectSchema } from '@izara_project/izara-core-library-service-schemas';
+import {
+  lambda,
+  sns,
+  sqs
+} from '@izara_project/izara-core-library-external-request';
+import { identifierUuid } from '@izara_project/izara-shared-core';
+import { consts, NoRetryError } from '@izara_project/izara-core-library-core';
+import { utils } from '@izara_project/izara-core-library-service-schemas';
+
+const { createFlowTypeConcat } = utils;
+//(</optionalImport>)
+
+/**
+ *
+ *
+ * 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 Process<%=  flowTag %>(
+  _izContext,
+  requestParams,
+  callingFlowConfig = {}
+  //(<additionalParams>)
+  //(</additionalParams>)
+) {
+  try {
+    _izContext.logger.debug(
+      'Process<%= flowTag %> _izContext',
+      _izContext
+    );
+    _izContext.logger.debug(
+      'Process<%= flowTag %> requestParams',
+      requestParams
+    );
+    _izContext.logger.debug(
+      'Process<%= flowTag %> callingFlowConfig',
+      callingFlowConfig
+    );
+
+    const userId = _izContext.correlationIds.get(consts.BASE_USER_ID);
+
+    _izContext.logger.debug(
+      '[Rbac:Process<%=  flowTag %>] userId',
+      userId
+    );
+
+    if (!userId) {
+      throw new NoRetryError('User Id not found.');
+    }
+
+    const resultQuery = await dynamodbSharedLib.query(
+      _izContext,
+      dynamodbSharedLib.tableName(_izContext, 'TargetRoles'),
+      { userId }
+    );
+
+    _izContext.logger.debug(
+      '[Rbac:Process<%=  flowTag %>] resultQuery',
+      resultQuery
+    );
+
+    const message = {
+      returnResult: {
+        records: resultQuery.Items || []
+      }
+    };
+
+    const messageResult = {
+      message,
+      TopicArn: snsSharedLib.snsTopicArnByFlowSchema(_izContext, `<%- flowTag %>_Out`)
+    };
+
+    _izContext.logger.debug(
+      '[Rbac:Process<%=  flowTag %>] messageResult',
+      messageResult
+    );
+
+    await sns.publishMessage(_izContext, messageResult);
+  } catch (err) {
+    _izContext.logger.error(
+      '[Rbac:Process<%=  flowTag %>] error: ',
+      err
+    );
+    throw err;
+  }
+}

package/src/codeGenerators/app/src/generatedCode/Flow/FlowRbac/templates/rbac/ListUserInRoles.ejs

@@ -0,0 +1,117 @@
+/*
+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 dynamodbSharedLib from '@izara_project/izara-core-library-dynamodb';
+import snsSharedLib from '@izara_project/izara-core-library-sns';
+import sqsSharedLib from '@izara_project/izara-core-library-sqs';
+import asyncFlowSharedLib from '@izara_project/izara-core-library-asynchronous-flow';
+import callingFlowSharedLib from '@izara_project/izara-core-library-calling-flow';
+import lambdaSharedLib from '@izara_project/izara-core-library-lambda';
+
+//(<optionalImport>)
+import { getObjectSchema } from '@izara_project/izara-core-library-service-schemas';
+import {
+  lambda,
+  sns,
+  sqs
+} from '@izara_project/izara-core-library-external-request';
+import { identifierUuid } from '@izara_project/izara-shared-core';
+import { consts, NoRetryError } from '@izara_project/izara-core-library-core';
+import { utils } from '@izara_project/izara-core-library-service-schemas';
+
+const { createFlowTypeConcat } = utils;
+//(</optionalImport>)
+
+/**
+ *
+ *
+ * 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 Process<%=  flowTag %>(
+  _izContext,
+  requestParams,
+  callingFlowConfig = {}
+  //(<additionalParams>)
+  //(</additionalParams>)
+) {
+  try {
+    _izContext.logger.debug(
+      'Process<%= flowTag %> _izContext',
+      _izContext
+    );
+    _izContext.logger.debug(
+      'Process<%= flowTag %> requestParams',
+      requestParams
+    );
+    _izContext.logger.debug(
+      'Process<%= flowTag %> callingFlowConfig',
+      callingFlowConfig
+    );
+
+    const { roleIdKey } = requestParams;
+
+    _izContext.logger.debug(
+      '[Rbac:Process<%=  flowTag %>] Inputs', { roleIdKey }
+    );
+
+    const resultQuery = await dynamodbSharedLib.query(
+      _izContext,
+      dynamodbSharedLib.tableName(_izContext, 'RoleUsers'),
+      { roleIdKey }
+    );
+
+    _izContext.logger.debug(
+      '[Rbac:Process<%=  flowTag %>] resultQuery',
+      resultQuery
+    );
+
+    const message = {
+      returnResult: {
+        records: resultQuery.Items || []
+      }
+    };
+
+    const messageResult = {
+      message,
+      TopicArn: snsSharedLib.snsTopicArnByFlowSchema(_izContext, `<%- flowTag %>_Out`)
+    };
+
+    _izContext.logger.debug(
+      '[Rbac:Process<%=  flowTag %>] messageResult',
+      messageResult
+    );
+
+    await sns.publishMessage(_izContext, messageResult);
+  } catch (err) {
+    _izContext.logger.error(
+      '[Rbac:Process<%=  flowTag %>] error: ',
+      err
+    );
+    throw err;
+  }
+}

package/src/codeGenerators/app/src/generatedCode/Flow/FlowRelationshipEndpoints/RelationshipFlowGenerator.js

@@ -0,0 +1,127 @@
+import path from 'path';
+import fs from 'fs/promises';
+import { fileURLToPath } from 'url';
+import ejs from 'ejs';
+import { isRelationshipFlow } from '../_internal/shared/flowClassifier.js';
+import { hasFlowStep } from '../_internal/shared/flowStepNormalizer.js';
+import { getFlowsForGeneration } from '../_internal/shared/flowSelection.js';
+import { processFunctionName, processMainFileName, upperFirst } from '../_internal/shared/flowNaming.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export async function generateRelationshipFlows(allSchemas, options) {
+    console.log('  [RelationshipFlowGenerator] Generating Custom Relationship Flows...');
+    const baseOutputDir = path.join(options.outputPath, 'app', 'src', 'generatedCode');
+    // Local templates/ folder (4-way shared handlers via symlink + relationship/ specific templates)
+    const templateDir = path.join(__dirname, 'templates');
+
+    // Read standard handler templates for reuse
+    const templates = {
+        sqs: await fs.readFile(path.join(templateDir, 'FlowHandler_HdrSqs.ejs'), 'utf-8'),
+        api: await fs.readFile(path.join(templateDir, 'FlowHandler_HdrApi.ejs'), 'utf-8'),
+        inv: await fs.readFile(path.join(templateDir, 'FlowHandler_HdrInv.ejs'), 'utf-8')
+    };
+
+    let generatedCount = 0;
+
+    const flows = getFlowsForGeneration(allSchemas);
+
+    for (const flow of flows) {
+        const flowTag = flow.flowTag;
+        const upperFlowTag = upperFirst(flowTag);
+        const processFunction = processFunctionName(flowTag);
+
+        if (!isRelationshipFlow(flowTag)) continue;
+
+        const flowOutputDir = path.join(baseOutputDir, 'FlowRelationshipEndpoints', upperFlowTag, 'source');
+        await fs.mkdir(flowOutputDir, { recursive: true });
+
+        // 1. Generate Action Step (In) Main Function
+        const actionFileName = processMainFileName(flowTag);
+        const actionTemplatePath = path.join(templateDir, 'relationship', `${actionFileName}.ejs`);
+        
+        try {
+            const actionTemplateStr = await fs.readFile(actionTemplatePath, 'utf-8');
+            const actionContent = ejs.render(actionTemplateStr, {
+                functionName: processFunction, 
+                upperFunctionName: processFunction
+            });
+            await fs.writeFile(path.join(flowOutputDir, `${actionFileName}.js`), actionContent, 'utf-8');
+            generatedCount++;
+        } catch (err) {
+            console.warn(`  [RelationshipFlowGenerator] Warning: Action template not found for ${flowTag}. Skipping.`);
+        }
+
+        // 2. Generate Action Step Handlers (based on flow.event)
+        for (const event of flow.event || []) {
+            let handlerFileName, handlerContent, handlerFunctionName;
+            if (event === 'ownTopic' || event === 'extTopic') {
+                handlerFunctionName = `${processFunction}_HdrSqs`;
+                handlerContent = ejs.render(templates.sqs, {
+                    flowTag: flowTag,
+                    flowStepName: '', 
+                    mainFileName: actionFileName,
+                    functionName: processFunction,
+                    queueName: `${processFunction}HdrSqs`
+                });
+                await fs.writeFile(path.join(flowOutputDir, `${handlerFunctionName}.js`), handlerContent, 'utf-8');
+                generatedCount++;
+            } else if (event === 'lambdaSyncApi') {
+                handlerFunctionName = `${processFunction}_HdrApi`;
+                handlerContent = ejs.render(templates.api, {
+                    flowTag: flowTag,
+                    flowStepName: '',
+                    mainFileName: actionFileName,
+                    functionName: processFunction
+                });
+                await fs.writeFile(path.join(flowOutputDir, `${handlerFunctionName}.js`), handlerContent, 'utf-8');
+                generatedCount++;
+            } else if (event === 'lambdaSyncInv') {
+                handlerFunctionName = `${processFunction}_HdrInv`;
+                handlerContent = ejs.render(templates.inv, {
+                    flowTag: flowTag,
+                    flowStepName: '',
+                    mainFileName: actionFileName,
+                    functionName: processFunction
+                });
+                await fs.writeFile(path.join(flowOutputDir, `${handlerFunctionName}.js`), handlerContent, 'utf-8');
+                generatedCount++;
+            }
+        }
+
+        // 3. Generate Complete Step (if any)
+        if (hasFlowStep(flow.flowSteps, 'Complete')) {
+            const completeFunction = `${processFunction}Complete`;
+            const completeFileName = `${completeFunction}_Main`;
+            const completeTemplatePath = path.join(templateDir, 'relationship', `${completeFileName}.ejs`);
+            
+            try {
+                const completeTemplateStr = await fs.readFile(completeTemplatePath, 'utf-8');
+                const completeContent = ejs.render(completeTemplateStr, {
+                    functionName: completeFunction,
+                    upperFunctionName: completeFunction
+                });
+                await fs.writeFile(path.join(flowOutputDir, `${completeFileName}.js`), completeContent, 'utf-8');
+                generatedCount++;
+
+                // Complete Handler is always SQS typically in Izara
+                const completeHandlerName = `${completeFunction}_HdrSqs`;
+                const completeHandlerContent = ejs.render(templates.sqs, {
+                    flowTag: flowTag,
+                    flowStepName: 'Complete', 
+                    mainFileName: completeFileName,
+                    functionName: completeFunction,
+                    queueName: `${completeFunction}HdrSqs`
+                });
+                await fs.writeFile(path.join(flowOutputDir, `${completeHandlerName}.js`), completeHandlerContent, 'utf-8');
+                generatedCount++;
+
+            } catch (err) {
+                console.warn(`  [RelationshipFlowGenerator] Warning: Complete template not found for ${flowTag}. Skipping.`);
+            }
+        }
+    }
+
+    console.log(`  [RelationshipFlowGenerator] Generated ${generatedCount} files for Relationship Flows.`);
+}

package/src/codeGenerators/app/src/generatedCode/Flow/FlowSchemas/StatusFieldGenerator.js

@@ -0,0 +1,116 @@
+import path from 'path';
+import fs from 'fs/promises';
+import { fileURLToPath } from 'url';
+import ejs from 'ejs';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+function upperCase(str) {
+    if (!str) return str;
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+
+function lowerCase(str) {
+    if (!str) return str;
+    return str.charAt(0).toLowerCase() + str.slice(1);
+}
+
+function shortNameHandler(handlerType) {
+    // Basic mapping for short names
+    const map = {
+        'HdrSqs': 'Sqs',
+        'HdrApi': 'Api',
+        'HdrWbs': 'Wbs',
+        'HdrDsq': 'Dsq'
+    };
+    return map[handlerType] || handlerType;
+}
+
+export async function generateStatusField(flowSchema, appPath, outputBaseDir) {
+    const flowTag = flowSchema.flowTag;
+    const upperFlowTag = upperCase(flowTag);
+    const functionName = 'CompleteStatusField' + upperFlowTag;
+    const handlerType = upperCase('hdrSqs'); // default in old system
+    const queueName = functionName + handlerType;
+
+    // Load templates
+    const templatesDir = path.join(__dirname, 'templates', 'statusField');
+    const mainTpl = await fs.readFile(path.join(templatesDir, 'CompleteStatusField_Main.ejs'), 'utf-8');
+    const handlerTpl = await fs.readFile(path.join(templatesDir, 'CompleteStatusField_HdrSqs.ejs'), 'utf-8');
+    const yamlTpl = await fs.readFile(path.join(__dirname, '..', '_internal', '_shared', 'yaml', 'SharedFunctionSqs_Yaml.ejs'), 'utf-8');
+    const snsTpl = await fs.readFile(path.join(templatesDir, 'CompleteStatusFieldSns_Yaml.ejs'), 'utf-8');
+
+    // Shared variables
+    const upperFunctionName = upperCase(functionName);
+    const upperHandlerType = upperCase(handlerType);
+    const upperQueueName = upperCase(queueName);
+    const roleName = upperFlowTag;
+    const upperRoleName = upperCase(roleName);
+    const functionNameConfig = upperFunctionName + upperCase(shortNameHandler(handlerType));
+    const upperFunctionNameConfig = upperCase(functionNameConfig);
+    const resourceLocation = `src/generatedCode/FlowSchemas/${upperFlowTag}/source/`;
+    const handlerPath = path.join(resourceLocation, `${functionName}_${upperHandlerType}.main`);
+    const handlerPathUpperFunctionName = path.join(resourceLocation, `${upperFunctionName}_${upperHandlerType}.main`);
+    
+    // Placeholder for IAM permissions (simulating old defaultIamRolePerAction)
+    const additionalResourcePermission = []; 
+
+    // 1. Output Main
+    const flowOutputDir = path.join(outputBaseDir, 'app', 'src', 'generatedCode', 'FlowSchemas', upperFlowTag, 'source');
+    await fs.mkdir(flowOutputDir, { recursive: true });
+    
+    const mainContent = ejs.render(mainTpl, {
+        functionName,
+        flowType: flowTag,
+        upperFunctionName
+    });
+    await fs.writeFile(path.join(flowOutputDir, `${functionName}_Main.js`), mainContent, 'utf-8');
+
+    // 2. Output Handler
+    const handlerContent = ejs.render(handlerTpl, {
+        functionName,
+        handlerType,
+        queueName,
+        upperFunctionName,
+        upperHandlerType,
+        upperQueueName
+    });
+    await fs.writeFile(path.join(flowOutputDir, `${functionName}_${handlerType}.js`), handlerContent, 'utf-8');
+
+    // 3. Output Yaml
+    const slsYamlDir = path.join(outputBaseDir, 'app', 'sls_yaml', 'generatedCode', 'source');
+    await fs.mkdir(slsYamlDir, { recursive: true });
+
+    const yamlContent = ejs.render(yamlTpl, {
+        resourceLocation,
+        functionName,
+        handlerType,
+        additionalResourcePermission,
+        functionNameConfig,
+        roleName,
+        queueName,
+        upperFunctionName,
+        upperHandlerType,
+        upperFunctionNameConfig,
+        upperRoleName,
+        upperQueueName,
+        handlerPath,
+        handlerPathUpperFunctionName
+    });
+    // Append to flow-schema.yml (creating if not exist)
+    const flowSchemaYamlPath = path.join(slsYamlDir, 'flow-schema.yml');
+    await fs.appendFile(flowSchemaYamlPath, '\n' + yamlContent, 'utf-8');
+
+    // 4. Output SNS
+    const snsResourceDir = path.join(outputBaseDir, 'resource', 'sls_yaml', 'generatedCode', 'source');
+    await fs.mkdir(snsResourceDir, { recursive: true });
+    
+    const snsContent = ejs.render(snsTpl, {
+        queueName: 'CompleteStatusField' + upperFlowTag
+    });
+    const snsYamlPath = path.join(snsResourceDir, 'generated-sns-in-sqs.yml');
+    await fs.appendFile(snsYamlPath, '\n' + snsContent, 'utf-8');
+
+    console.log(`  [StatusFieldGenerator] Generated statusField files for flow: ${flowTag}`);
+}