@izara_project/izara-core-generate-service-code 1.0.52 → 1.0.54

package/index.js

@@ -15,25 +15,19 @@ 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 createSource from './src/sourceManager/CreateSource.js';
-import generateCode from './src/generateCode.js';
-import generateIntTest from './src/generateTests.js';
-import generateResourceIntTest from './src/generateResources.js';
-
-import consts from './src/libs/Consts.js';
-import generateCodeLibs from './src/libs/GenerateCodeLibs.js';
-import libs from './src/libs/Libs.js';
-import utils from './src/libs/Utils.js';
+import { generate } from './src/generate.js';
+import { generateCode } from './src/generateCode.js';
+import { generateSchema } from './src/generateSchema.js';
+import { generateIntTest } from './src/generateIntTest.js';
+import { generateResourceIntTest } from './src/generateResourceIntTest.js';
 
 export {
-  createSource,
-  // main generateCode
+  // High-level API (recommended for consumers) — wires legacy Logger+validateLocalSchema
+  generate,
+  // Main generators (low-level)
   generateCode,
+  generateSchema,
+  // IntTest generators (Result-Driven: no createSource/libs dependencies)
   generateIntTest,
-  generateResourceIntTest,
-  // libs
-  consts,
-  generateCodeLibs,
-  libs,
-  utils
+  generateResourceIntTest
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@izara_project/izara-core-generate-service-code",
-  "version": "1.0.52",
+  "version": "1.0.54",
   "description": "Code for locally generating per service files",
   "homepage": "https://bitbucket.org/izara-core-support-services/izara-core-support-services-generate-service-code#readme",
   "repository": {
@@ -10,9 +10,6 @@
   "license": "AGPL-3.0-or-later",
   "author": "Sven Mason <thebarbariansven@gmail.com>",
   "type": "module",
-  "imports": {
-    "#libs/*": "./src/libs/*"
-  },
   "main": "index.js",
   "scripts": {
     "test": "jest"
@@ -21,16 +18,19 @@
     "testEnvironment": "node"
   },
   "dependencies": {
+    "@izara_project/izara-attribute-tree": "^1.0.15",
     "@izara_project/izara-core-library-core": "^1.0.32",
     "@izara_project/izara-core-library-logger": "^1.0.9",
-    "@izara_project/izara-core-library-s3": "^1.0.9",
-    "@izara_project/izara-core-library-service-schemas": "^1.0.145",
+    "@izara_project/izara-core-library-s3": "^1.0.10",
+    "@izara_project/izara-core-library-service-schemas": "^1.0.155",
+    "@izara_project/izara-property-nodes": "^1.0.16",
     "@izara_project/izara-shared-core": "^1.0.12",
+    "@izara_project/izara-shared-service-schemas": "^1.0.64",
     "ejs": "^5.0.1",
     "js-beautify": "^1.15.4",
-    "yaml": "^2.8.2"
+    "yaml": "^2.9.0"
   },
   "devDependencies": {
-    "jest": "^30.3.0"
+    "jest": "^30.4.2"
   }
 }

package/src/codeGenerators/app/initial_setup/InitialSetupGenerator.js

@@ -0,0 +1,149 @@
+import path from 'path';
+import fs from 'fs/promises';
+import ejs from 'ejs';
+import { fileURLToPath } from 'url';
+import { getFlowsForGeneration } from '../src/generatedCode/Flow/_shared/shared/flowSelection.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export async function generateInitialSetup(allSchemas, options) {
+    console.log('  [InitialSetupGenerator] Generating Initial Setup Scripts...');
+    const flows = getFlowsForGeneration(allSchemas);
+
+    const setupDir = path.join(options.outputPath, 'app', 'initial_setup');
+    const sourceDir = path.join(setupDir, 'generatedCode', 'source');
+    const hookDir = path.join(setupDir, 'generatedCode', 'hook');
+    
+    await fs.mkdir(sourceDir, { recursive: true });
+    await fs.mkdir(hookDir, { recursive: true });
+
+    // 1. Table Names
+    const tableNames = new Set();
+    const tableNameTpl = await fs.readFile(path.join(__dirname, 'templates', 'InitialSetup_TableName.ejs'), 'utf-8');
+    const tableNameContent = ejs.render(tableNameTpl, { tableNames: Array.from(tableNames) });
+    await fs.writeFile(path.join(sourceDir, 'generatedTableNameConfig.js'), tableNameContent, 'utf-8');
+
+    // 2. SNS Subscriptions
+    const hardcodedSubscriptions = [
+        { serviceTag: "GraphHandler", topicName: "UpdateRelationship_Out", sqsEndpoint: "UpdateRelationshipComplete" },
+        { serviceTag: "GraphHandler", topicName: "CreateRelationship_Out", sqsEndpoint: "CreateRelationshipComplete" },
+        { serviceTag: "GraphHandler", topicName: "DeleteRelationship_Out", sqsEndpoint: "DeleteRelationshipComplete" },
+        { serviceTag: "GraphHandler", topicName: "UpdateNode_Out", sqsEndpoint: "UpdateNodeComplete" },
+        { serviceTag: "GraphHandler", topicName: "CreateNode_Out", sqsEndpoint: "CreateObjectComplete" },
+        { serviceTag: "GraphHandler", topicName: "ChangeRelationshipType_Out", sqsEndpoint: "ChangeRelationshipComplete" },
+        { serviceTag: "GraphHandler", topicName: "MoveRelationship_Out", sqsEndpoint: "MoveRelationshipComplete" }
+    ];
+
+    const snsTpl = await fs.readFile(path.join(__dirname, 'templates', 'InitialSetup_SnsService.ejs'), 'utf-8');
+    const snsContent = ejs.render(snsTpl, { subscriptions: hardcodedSubscriptions });
+    await fs.writeFile(path.join(sourceDir, 'generatedSnsServiceConfig.js'), snsContent, 'utf-8');
+
+    // 3. Lambda Roles
+    const lambdaRoles = [
+        {
+            objectType: "PerActionEndpoint",
+            additionalResourcePermission: [
+                {
+                    effect: "Allow",
+                    action: { "lambda": ["InvokeFunction"] },
+                    resource: ["arn:aws:lambda:${process.env.iz_region}:${process.env.iz_accountId}:function:${lambdaSharedLib.lambdaFunctionName(_izContext, \"GetNodeHdrInv\" ,\"GraphHandler\")}"]
+                },
+                {
+                    effect: "Allow",
+                    action: { "sns": ["Publish"] },
+                    resource: ["arn:aws:sns:${process.env.iz_region}:${process.env.iz_accountId}:${snsSharedLib.snsTopicNameByFlowSchema(_izContext, \"UpdateNode_In\", \"GraphHandler\")}"]
+                },
+                {
+                    effect: "Allow",
+                    action: { "sns": ["Publish"] },
+                    resource: ["arn:aws:sns:${process.env.iz_region}:${process.env.iz_accountId}:${snsSharedLib.snsTopicNameByFlowSchema(_izContext, \"CreateNode_In\", \"GraphHandler\")}"]
+                }
+            ]
+        },
+        {
+            objectType: "ProcFindData",
+            additionalResourcePermission: [
+                {
+                    effect: "Allow",
+                    action: { "lambda": ["InvokeFunction"] },
+                    resource: ["arn:aws:lambda:${process.env.iz_region}:${process.env.iz_accountId}:function:${lambdaSharedLib.lambdaFunctionName(_izContext, \"GetNodeHdrInv\" ,\"GraphHandler\")}"]
+                }
+            ]
+        }
+    ];
+
+    if (flows.length > 0) {
+        for (const flow of flows) {
+            if (flow.event && flow.event.includes('s3')) {
+                lambdaRoles.push({
+                    objectType: "FlowSchemaUploadS3Role",
+                    additionalResourcePermission: [
+                        {
+                            effect: "Allow",
+                            action: { "sns": ["Publish"] },
+                            resource: ["arn:aws:sns:${process.env.iz_region}:${process.env.iz_accountId}:${snsSharedLib.snsTopicNameByFlowSchema(_izContext, \"ReservedDynamicUsage_In\", \"AccountLimits\")}"]
+                        },
+                        {
+                            effect: "Allow",
+                            action: { "lambda": ["InvokeFunction"] },
+                            resource: ["arn:aws:lambda:${process.env.iz_region}:${process.env.iz_accountId}:function:${lambdaSharedLib.lambdaFunctionName(_izContext, \"StaticLimitProcessHdrInv\" ,\"AccountLimits\")}"]
+                        },
+                        {
+                            effect: "Allow",
+                            action: { "sns": ["Publish"] },
+                            resource: ["arn:aws:sns:${process.env.iz_region}:${process.env.iz_accountId}:${snsSharedLib.snsTopicNameByFlowSchema(_izContext, \"CancelUsage_In\", \"AccountLimits\")}"]
+                        },
+                        {
+                            effect: "Allow",
+                            action: { "sns": ["Publish"] },
+                            resource: [
+                                "arn:aws:sns:${process.env.iz_region}:${process.env.iz_accountId}:${snsSharedLib.snsTopicNameByFlowSchema(_izContext, \"ReservedDynamicUsageComplet_Out\", \"AccountLimits\")}",
+                                "arn:aws:sns:${process.env.iz_region}:${process.env.iz_accountId}:${snsSharedLib.snsTopicNameByFlowSchema(_izContext, \"ConfirmUsage_In\", \"AccountLimits\")}"
+                            ]
+                        }
+                    ]
+                });
+            }
+        }
+    }
+
+    const lambdaTpl = await fs.readFile(path.join(__dirname, 'templates', 'InitialSetup_LambdaRole.ejs'), 'utf-8');
+    const lambdaContent = ejs.render(lambdaTpl, { datas: lambdaRoles });
+    await fs.writeFile(path.join(sourceDir, 'generatedLambdaRoleServiceConfig.js'), lambdaContent, 'utf-8');
+
+    // 4. RoleNameConfig.js
+    const roleNameConfigs = new Set();
+    const upperCase = (str) => {
+        if (!str) return str;
+        return str.charAt(0).toUpperCase() + str.slice(1);
+    };
+
+    if (flows.length > 0) {
+        for (const flow of flows) {
+            if (flow.flowTag) {
+                roleNameConfigs.add(upperCase(flow.flowTag));
+            }
+        }
+    }
+    roleNameConfigs.add('ProcFindData');
+    if (flows.length > 0 && flows.some(f => f.event && f.event.includes('webSocket'))) {
+        roleNameConfigs.add('WebSocketMain');
+    }
+    roleNameConfigs.add('PerActionEndpoint');
+    roleNameConfigs.add('Register');
+    roleNameConfigs.add('ObjectCom');
+    roleNameConfigs.add('RelationshipCom');
+    roleNameConfigs.add('Relationship');
+
+    const roleNameConfigContent = `export function generatedIntTestRoleNameConfig() {
+  let roleNameConfigIntTest = [
+${Array.from(roleNameConfigs).map(r => `        "${r}",`).join('\n')}
+  ];
+  return roleNameConfigIntTest;
+}
+`;
+    await fs.writeFile(path.join(sourceDir, 'RoleNameConfig.js'), roleNameConfigContent, 'utf-8');
+
+    console.log(`  [InitialSetupGenerator] Wrote initial_setup scripts to ${sourceDir}`);
+}

package/src/codeGenerators/app/initial_setup/templates/InitialSetup_LambdaRole.ejs

@@ -0,0 +1,43 @@
+import Logger from '@izara_project/izara-core-library-logger';
+import dynamodbSharedLib from '@izara_project/izara-core-library-dynamodb';
+import lambdaSharedLib from '@izara_project/izara-core-library-lambda';
+import snsSharedLib from '@izara_project/izara-core-library-sns';
+import initialSetupConfig from '../../config/Config.js';
+
+const _izContext = { logger: Logger };
+
+export function generatedLambdaRole() {
+  const externalLambdaRole = [
+<% datas.forEach((data, dataIndex) => { %>
+    {
+      roleName: "<%- data.objectType %>",
+      statement: [
+<% data.additionalResourcePermission.forEach((resourcePermission, resourceIdx) => { %>
+        {
+          "Sid": "<%- data.objectType %>Test<%- resourceIdx %>",
+          "Effect": "<%- resourcePermission.effect %>",
+          "Action": [
+<% Object.keys(resourcePermission.action).forEach(resourcePerAction => { %>
+<% resourcePermission.action[resourcePerAction].forEach(permission => { %>
+            "<%- resourcePerAction %>:<%- permission %>",
+<% }) %>
+<% }) %>
+          ],
+          "Resource": [
+<% resourcePermission.resource.forEach(resource => { %>
+            `<%- resource %>`,
+<% }) %>
+          ]
+        },
+<% }) %>
+        //(<create<%- data.objectType %>Role>)
+        //(</create<%- data.objectType %>Role>)
+      ]
+    },
+<% }) %>
+    //(<additionalRole>)
+    //(</additionalRole>)
+  ];
+
+  return externalLambdaRole;
+}

package/src/codeGenerators/app/initial_setup/templates/InitialSetup_SnsService.ejs

@@ -0,0 +1,15 @@
+const generatedSnsTopicSubscription = [
+<% subscriptions.forEach(sub => { %>
+  {
+    serviceTag: "<%- sub.serviceTag %>",
+    topicName: "<%- sub.topicName %>",
+    sqsEndpoint: "<%- sub.sqsEndpoint %>"
+  },
+<% }) %>
+  //(<additionalSubscription>)
+  //(</additionalSubscription>)
+];
+
+export {
+  generatedSnsTopicSubscription
+};

package/src/codeGenerators/app/initial_setup/templates/InitialSetup_TableName.ejs

@@ -0,0 +1,9 @@
+const generatedTableNameConfig = [
+<% tableNames.forEach(tableName => { %>
+  { "<%- tableName %>": {} },
+<% }) %>
+];
+
+export {
+  generatedTableNameConfig
+};

package/src/codeGenerators/app/sls_yaml/FindDataYamlGenerator.js

@@ -0,0 +1,23 @@
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { renderYamlTemplate } from './renderYamlTemplate.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export async function generateFindDataYaml(options) {
+  console.log('  [FindDataYamlGenerator] Generating FindData YAML...');
+
+  await renderYamlTemplate(
+    path.join(__dirname, 'templates', 'FindData_Yaml.ejs'),
+    path.join(options.outputPath, 'app', 'sls_yaml', 'generatedCode', 'source', 'find-data.yml'),
+    {
+      functionName: 'FindData',
+      handlerPath: 'src/generatedCode/FindData/source/FindData_HdrSqs.main',
+      roleName: 'ProcFindData',
+      upperFunctionName: 'FINDDATA',
+      upperHandlerType: 'HDRSQS'
+    },
+    'FindDataYamlGenerator'
+  );
+}

package/src/codeGenerators/app/sls_yaml/FunctionYamlGenerator.js

@@ -0,0 +1,230 @@
+import fs from 'fs/promises';
+import path from 'path';
+import ejs from 'ejs';
+import { fileURLToPath } from 'url';
+import { getFlowsForGeneration } from '../src/generatedCode/Flow/_shared/shared/flowSelection.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export async function generateFunctionYaml(allSchemas, options) {
+    console.log('  [FunctionYamlGenerator] Generating Function YAMLs...');
+    
+    const slsYamlDir = path.join(options.outputPath, 'app', 'sls_yaml', 'generatedCode', 'source');
+    await fs.mkdir(slsYamlDir, { recursive: true });
+
+    const templates = {
+        sqs: await fs.readFile(path.join(__dirname, 'templates', 'FunctionYaml_Sqs.ejs'), 'utf-8'),
+        inv: await fs.readFile(path.join(__dirname, 'templates', 'FunctionYaml_Inv.ejs'), 'utf-8'),
+        api: await fs.readFile(path.join(__dirname, 'templates', 'FunctionYaml_Api.ejs'), 'utf-8'),
+        wbs: await fs.readFile(path.join(__dirname, 'templates', 'FunctionYaml_Wbs.ejs'), 'utf-8'),
+        eventBridge: await fs.readFile(path.join(__dirname, 'templates', 'FunctionYaml_EventBridge.ejs'), 'utf-8')
+    };
+    const flows = getFlowsForGeneration(allSchemas);
+
+    const CRUD_FLOW_TAGS = ['Create', 'Update', 'Delete', 'Get'];
+    const REL_FLOW_TAGS = [
+        'createRelationship', 'updateRelationship', 'deleteRelationship',
+        'getRelationship', 'changeRelationship', 'moveRelationship'
+    ];
+
+    let perActionYaml = '';
+    let relActionYaml = '';
+    let flowSchemaYaml = '';
+
+    const upperCase = (str) => str.charAt(0).toUpperCase() + str.slice(1);
+
+    // 1. Find all generated Handlers
+    const generatedCodeDir = path.join(options.outputPath, 'app', 'src', 'generatedCode');
+    const handlerFiles = [];
+    async function getHandlerFiles(dir) {
+        try {
+            const dirents = await fs.readdir(dir, { withFileTypes: true });
+            for (const dirent of dirents) {
+                const res = path.resolve(dir, dirent.name);
+                if (dirent.isDirectory()) {
+                    await getHandlerFiles(res);
+                } else if (dirent.name.includes('_Hdr') && dirent.name.endsWith('.js')) {
+                    // Extract relative path from generatedCodeDir
+                    const relativePath = path.relative(generatedCodeDir, res);
+                    // normalize to forward slashes
+                    handlerFiles.push(relativePath.replace(/\\/g, '/'));
+                }
+            }
+        } catch (e) {
+            // directory might not exist if no flows generated
+        }
+    }
+    await getHandlerFiles(generatedCodeDir);
+
+    // Prepare API routes
+    const crudApiRoutes = allSchemas.objects.map(obj => ({
+        objectName: obj.objectType,
+        upperName: upperCase(obj.objectType)
+    }));
+    const relApiRoutes = allSchemas.relationships.map(rel => {
+        const relName = Object.keys(rel)[0];
+        return {
+            objectName: relName,
+            upperName: upperCase(relName)
+        };
+    });
+
+    for (const handlerFile of handlerFiles) {
+        // e.g. "Endpoints/Create/source/ProcessCreate_HdrSqs.js"
+        const parts = handlerFile.split('/');
+        if (parts.length < 4) continue;
+
+        const subDir = parts[0]; // e.g. FlowEndpoints, FlowSchemas, SystemFlowSchemas
+        if (subDir === 'SystemFlowSchemas') continue;
+
+        const flowTag = parts[1];
+        const fileName = parts[3]; // e.g. ProcessCreate_HdrSqs.js
+        
+        const fileNameWithoutExt = fileName.replace('.js', '');
+        // e.g. ProcessCreate_HdrSqs
+        const splitFileName = fileNameWithoutExt.split('_');
+        const handlerBaseName = splitFileName[0]; // e.g. ProcessCreate or CreateComplete
+        const handlerSuffix = splitFileName[1]; // e.g. HdrSqs, HdrApi, HdrInv
+
+        const isCrud = CRUD_FLOW_TAGS.map(t => t.toLowerCase()).includes(flowTag.toLowerCase());
+        const isRel = REL_FLOW_TAGS.map(t => t.toLowerCase()).includes(flowTag.toLowerCase());
+        const isCustom = !isCrud && !isRel;
+
+        // Role mapping
+        let roleName = '';
+        if (isCrud) {
+            roleName = 'PerActionEndpointRole';
+        } else if (isRel) {
+            roleName = 'RelationshipRole';
+        } else {
+            roleName = `${upperCase(flowTag)}Role`;
+        }
+
+        // Function Name Config
+        // e.g. ProcessCreateSqs or CreateCompleteSqs or GetApi
+        let suffixType = handlerSuffix.replace('Hdr', ''); // Sqs, Api, Inv
+        let functionNameConfig = `${handlerBaseName}${suffixType}`;
+        if (isCrud && handlerBaseName === `Process${upperCase(flowTag)}`) {
+            // Legacy matches: CreateSqs, GetApi instead of ProcessCreateSqs
+            functionNameConfig = `${upperCase(flowTag)}${suffixType}`;
+        }
+        if (isRel && handlerBaseName === `Process${upperCase(flowTag)}`) {
+            // Legacy matches: CreateRelSqs
+            functionNameConfig = `${upperCase(flowTag).replace('Relationship', 'Rel')}${suffixType}`;
+        }
+        if (handlerBaseName.endsWith('Complete')) {
+            // e.g. CreateObjectComp or CreateCompleteSqs
+            if (isCrud) {
+                // Legacy: DeleteNodeComp, UpdateNodeComp, CreateObjectComp
+                const crudType = upperCase(flowTag);
+                if (crudType === 'Create') functionNameConfig = `CreateObjectComp`;
+                else functionNameConfig = `${crudType}NodeComp`;
+            } else if (isRel) {
+                // Legacy: UpdateRelComp
+                functionNameConfig = `${upperCase(flowTag).replace('Relationship', 'Rel')}Comp`;
+            } else {
+                functionNameConfig = `${handlerBaseName}${suffixType}`;
+            }
+        }
+
+        let queueName = '';
+        const flowDefForQueue = flows.find(f => f.flowTag === flowTag);
+        
+        if (isCrud || isRel) {
+            queueName = handlerBaseName.replace('Process', ''); 
+            if (handlerSuffix === 'HdrSqs' || handlerSuffix === 'HdrDsq') {
+                queueName += handlerSuffix.replace('Hdr', '');
+            }
+        } else {
+            // For Custom Flows (e.g. OwnTopicFlowProcess, ProcessExtTopicFlow)
+            // The queue name exactly matches the handler name without the underscore.
+            if (handlerSuffix === 'HdrSqs' || handlerSuffix === 'HdrDsq') {
+                if (handlerBaseName === `Process${upperCase(flowTag)}` && flowDefForQueue && flowDefForQueue.event && flowDefForQueue.event.includes('ownTopic')) {
+                    // ownTopic flows in FlowResourceYamlGenerator omit 'Process' for the queue
+                    queueName = flowTag + handlerSuffix.replace('Hdr', '');
+                } else {
+                    queueName = handlerBaseName + handlerSuffix.replace('Hdr', '');
+                }
+            } else {
+                queueName = handlerBaseName;
+            }
+        }
+
+        // Api routes
+        let apiRoutes = [];
+        if (suffixType === 'Api') {
+            const routesList = isCrud ? crudApiRoutes : (isRel ? relApiRoutes : []);
+            const actionPath = flowTag.toLowerCase().replace('relationship', '');
+            apiRoutes = routesList.map(r => ({
+                path: `/TST/${r.objectName}/${actionPath}`,
+                upperName: r.upperName
+            }));
+        }
+
+        // Handler Path
+        const handlerPath = `src/generatedCode/${subDir}/${flowTag}/source/${fileNameWithoutExt}.main`;
+
+        let filterPatterns = '';
+        if (handlerBaseName.endsWith('Complete') && (suffixType === 'Sqs' || suffixType === 'Dsq')) {
+            filterPatterns = `        filterPatterns: #**** need to update serverless framework upper v.2.69.1
+          - body: {"MessageAttributes":{"callingFlow":{"Value":["\${self:custom.iz_resourcePrefix}${functionNameConfig}"]}}} # functionName of callingFlow
+          - body: {"MessageAttributes":{"callingFlow":{"Value":[{"exists":false}]}}}`;
+        }
+
+        const flowDef = flows.find(f => f.flowTag === flowTag);
+        let schedules = [];
+        if (flowDef && flowDef.schedules) {
+            schedules = flowDef.schedules;
+        }
+
+        const renderVars = {
+            functionNameConfig,
+            handlerPath,
+            roleName,
+            queueName,
+            apiRoutes,
+            filterPatterns,
+            schedules,
+            flowTag
+        };
+
+        let yamlBlock = '';
+        if (schedules.length > 0 && suffixType === 'Inv') {
+            yamlBlock = ejs.render(templates.eventBridge, renderVars);
+        } else if (suffixType === 'Sqs' || suffixType === 'Dsq') {
+            yamlBlock = ejs.render(templates.sqs, renderVars);
+        } else if (suffixType === 'Inv') {
+            yamlBlock = ejs.render(templates.inv, renderVars);
+        } else if (suffixType === 'Api') {
+            yamlBlock = ejs.render(templates.api, renderVars);
+        } else if (suffixType === 'Wbs') {
+            renderVars.routeName = flowTag;
+            yamlBlock = ejs.render(templates.wbs, renderVars);
+        } else {
+            // Fallback for others
+            yamlBlock = ejs.render(templates.inv, renderVars); // Simple no-events template
+        }
+
+        if (isCrud) {
+            perActionYaml += yamlBlock + '\n\n';
+        } else if (isRel) {
+            relActionYaml += yamlBlock + '\n\n';
+        } else {
+            flowSchemaYaml += yamlBlock + '\n\n';
+        }
+    }
+
+    if (perActionYaml) {
+        await fs.writeFile(path.join(slsYamlDir, 'per-action-function.yml'), perActionYaml, 'utf-8');
+    }
+    if (relActionYaml) {
+        await fs.writeFile(path.join(slsYamlDir, 'relationship-per-action.yml'), relActionYaml, 'utf-8');
+    }
+    if (flowSchemaYaml) {
+        // Append to flow-schema.yml just in case WebSocket/TriggerCache already created it, or create new.
+        await fs.appendFile(path.join(slsYamlDir, 'flow-schema.yml'), flowSchemaYaml, 'utf-8');
+    }
+
+    console.log(`  [FunctionYamlGenerator] Wrote YAML functions for CRUD, Relationships, and Custom Flows.`);
+}

package/src/codeGenerators/app/sls_yaml/ProcessLogicalYamlGenerator.js

@@ -0,0 +1,21 @@
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { renderYamlTemplate } from './renderYamlTemplate.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export async function generateProcessLogicalYaml(allSchemas, options) {
+  console.log('  [ProcessLogicalYamlGenerator] Generating ProcessLogical YAML...');
+
+  if (!allSchemas.objects || allSchemas.objects.length === 0) {
+    return;
+  }
+
+  await renderYamlTemplate(
+    path.join(__dirname, 'templates', 'ProcessLogical_Yaml.ejs'),
+    path.join(options.outputPath, 'app', 'sls_yaml', 'generatedCode', 'source', 'process-logical.yml'),
+    {},
+    'ProcessLogicalYamlGenerator'
+  );
+}

package/src/codeGenerators/app/sls_yaml/RoleNameConfigGenerator.js

@@ -0,0 +1,83 @@
+import fs from 'fs/promises';
+import path from 'path';
+import ejs from 'ejs';
+import { fileURLToPath } from 'url';
+import { getFlowsForGeneration } from '../src/generatedCode/Flow/_shared/shared/flowSelection.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export async function generateRoleNameConfig(allSchemas, options) {
+    console.log('  [RoleNameConfigGenerator] Generating IAM Role Configurations...');
+
+    const resourceYamlDir = path.join(options.outputPath, 'app', 'sls_yaml', 'generatedCode', 'source');
+    await fs.mkdir(resourceYamlDir, { recursive: true });
+
+  const roleNameConfigs = new Set();
+  const CRUD_FLOW_TAGS = new Set(['Create', 'Update', 'Delete', 'Get']);
+  const REL_FLOW_TAGS = new Set([
+    'CreateRelationship',
+    'UpdateRelationship',
+    'DeleteRelationship',
+    'GetRelationship',
+    'ChangeRelationship',
+    'MoveRelationship'
+  ]);
+
+    const upperCase = (str) => {
+        if (!str) return str;
+        return str.charAt(0).toUpperCase() + str.slice(1);
+    };
+
+    const flows = getFlowsForGeneration(allSchemas);
+
+  if (flows.length > 0) {
+    for (const flow of flows) {
+      if (flow.flowTag) {
+        const upperFlowTag = upperCase(flow.flowTag);
+        if (CRUD_FLOW_TAGS.has(upperFlowTag)) {
+          roleNameConfigs.add('PerActionEndpointRole');
+        } else if (REL_FLOW_TAGS.has(upperFlowTag)) {
+          roleNameConfigs.add('RelationshipRole');
+        } else {
+          roleNameConfigs.add(`${upperFlowTag}Role`);
+        }
+      }
+    }
+  }
+
+    // Static core framework roles that are generated
+  roleNameConfigs.add('ProcFindDataRole');
+    
+    // 2. Main Execution Roles (Based on initiateBy & outputTopic)
+    if (flows.length > 0 && flows.some(f => f.event && f.event.includes('ownTopic'))) {
+        roleNameConfigs.add('WebSocketMainRole');
+    }
+
+    // Prepare template output
+    const templatePath = path.join(__dirname, 'templates', 'RoleNameConfig_Yaml.ejs');
+    
+    // Create templates directory and file if it doesn't exist
+    await fs.mkdir(path.dirname(templatePath), { recursive: true });
+    
+    let templateString;
+    try {
+        templateString = await fs.readFile(templatePath, 'utf-8');
+    } catch (e) {
+        // Fallback to auto-creating the template based on old roleNameConfig
+        templateString = `# for createIamRole\n\n<% roleNameConfigs.forEach(roleNameConfig => { _%>\n- arn:aws:iam::\${self:custom.iz_accountId}:role/\${self:custom.iz_resourcePrefix}<%- roleNameConfig %>\n<% }) _%>\n`;
+        await fs.writeFile(templatePath, templateString, 'utf-8');
+    }
+
+    const fileContent = ejs.render(templateString, {
+        roleNameConfigs: Array.from(roleNameConfigs)
+    });
+
+    const outputPath = path.join(resourceYamlDir, 'role-name-config.yml');
+    
+    // Since isAppend was true in the old code, we should append or overwrite.
+    // However, since we clean the resource folder at start, writeFile is fine.
+    await fs.writeFile(outputPath, fileContent, 'utf-8');
+
+    console.log(`  [RoleNameConfigGenerator] Wrote ${roleNameConfigs.size} role configs to ${outputPath}`);
+}