@izara_project/izara-core-generate-service-code 1.0.61 → 1.0.62

package/src/codeGenerators/app/src/generatedCode/Flow/_shared/handlers/FlowHandler_HdrSqs.ejs

@@ -15,8 +15,8 @@ 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 { 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 callingFlowSharedLib from '@izara_project/izara-core-library-calling-flow';
 import <%= functionName %> from './<%= mainFileName %>.js';
@@ -27,11 +27,9 @@ let perRecordsValidatorSchema = {
 <% if (typeof startConfig !== 'undefined' && startConfig !== null && startConfig.properties && startConfig.properties.length > 0) { -%>
   type: 'object',
   properties: {
-  <% startConfig.properties.forEach(prop => { -%>
-    '<%- prop.propertyName %>': { type: '<%- prop.type || 'string' %>' },
-  <% }) -%>
-  },
-  required: [ <%- startConfig.properties.filter(p => p.required !== false).map(p => `'${p.propertyName}'`).join(', ') %> ]
+<% startConfig.properties.forEach((prop, index) => { %>    <%- prop.propertyName %>: { type: '<%- prop.type || 'string' %>' }<%= index < startConfig.properties.length - 1 ? ',' : '' %>
+<% }) %>  },
+  required: [<%- startConfig.properties.filter(p => p.required !== false).map(p => `'${p.propertyName}'`).join(', ') %>]
 <% } -%>
   //(</validatorSchema>)
 };
@@ -40,18 +38,16 @@ let perRecordsValidatorSchema = {
 let messageAttributeValidatorSchema = {
   type: 'object',
   properties: {
-  <% startConfig.messageAttributes.forEach(prop => { -%>
-    '<%- prop.propertyName %>': {
+<% startConfig.messageAttributes.forEach((prop, index) => { %>    '<%- prop.propertyName %>': {
       type: 'object',
       properties: {
         Type: { type: 'string' },
         Value: { type: '<%- prop.type || 'string' %>' }
       },
       required: ['Type', 'Value']
-    },
-  <% }) -%>
-  },
-  required: [ <%- startConfig.messageAttributes.filter(p => p.required !== false).map(p => `'${p.propertyName}'`).join(', ') %> ]
+    }<%= index < startConfig.messageAttributes.length - 1 ? ',' : '' %>
+<% }) %>  },
+  required: [<%- startConfig.messageAttributes.filter(p => p.required !== false).map(p => `'${p.propertyName}'`).join(', ') %>]
 };
 <% } else { -%>
 let messageAttributeValidatorSchema = null;
@@ -59,57 +55,65 @@ let messageAttributeValidatorSchema = null;
 middleware.setValidatorSchema(recordHandlerSharedLib.baseValidatorSchema());
 
 export const 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
-      );
-
-      // add argument (to invoke lambda) to passOnProperties[]
-      passOnProperties.push(record.body.Message);
-      passOnProperties.push(callingFlowSharedLib.addCallingFlowToPassOnProperties(record.body.Message));
-      //(<additionalParams>)
-      //(</additionalParams>)
-      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
-    }))
+    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
+        );
+
+        // add argument (to invoke lambda) to passOnProperties[]
+        passOnProperties.push(record.body.Message);
+        passOnProperties.push(
+          callingFlowSharedLib.addCallingFlowToPassOnProperties(
+            record.body.Message
+          )
+        );
+        //(<additionalParams>)
+        //(</additionalParams>)
+        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
-
+      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(
+        '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);
+    throw err;
   }
 });

package/src/codeGenerators/app/src/generatedCode/Flow/_shared/shared/flowEntryPointBase.js

@@ -4,9 +4,9 @@ import { fileURLToPath } from 'url';
 import ejs from 'ejs';
 import { EVENT_HANDLERS } from '../events/registry.js';
 import { STATUS_HANDLERS } from './registry.js';
-import { getFlowOutputSubDir, isRbacFlow, isRelationshipFlow } from './flowClassifier.js';
+import { getFlowOutputSubDir, isCrudFlow, isRbacFlow, isRelationshipFlow } from './flowClassifier.js';
 import { normalizeEvents } from './eventTypes.js';
-import { processMainFileName, upperFirst } from './flowNaming.js';
+import { processMainFileName, ownTopicMainFileName, upperFirst } from './flowNaming.js';
 import { getFlowsForGeneration, getGeneratedCodeConfigs } from './flowSelection.js';
 
 const __filename = fileURLToPath(import.meta.url);
@@ -41,10 +41,13 @@ export async function generateFlowEntryPoint(allSchemas, options) {
         const flowOutputDir = path.join(baseOutputDir, subDir, upperCaseFlowTag, 'source');
         await fs.mkdir(flowOutputDir, { recursive: true });
 
-        // NOTE: Changed to Process${upperCaseFlowTag}_Main to match legacy.
-        const mainFileName = processMainFileName(flowTag);
         // 2. Generate Handlers based on event array using Registry
         const events = normalizeEvents(flow.event, ['ownTopic']);
+
+        const isOwnTopic = !isCrudFlow(flowTag) && !isRbacFlow(flowTag) && !isRelationshipFlow(flowTag) && events.includes('ownTopic');
+        const mainFileName = isOwnTopic
+            ? ownTopicMainFileName(flowTag)
+            : processMainFileName(flowTag);
         
         // Use invocationType from generatedCodeConfig if available
         if (flow.generatedCodeConfig && flow.generatedCodeConfig.invocationType) {

package/src/codeGenerators/app/src/generatedCode/Flow/_shared/shared/flowMainFunctionBase.js

@@ -3,8 +3,9 @@ import fs from 'fs/promises';
 import { fileURLToPath } from 'url';
 import ejs from 'ejs';
 import { getFlowOutputSubDir, isCrudFlow, isRbacFlow, isRelationshipFlow } from './flowClassifier.js';
-import { processMainFileName, upperFirst } from './flowNaming.js';
+import { processMainFileName, processFunctionName, ownTopicMainFileName, ownTopicFunctionName, ownTopicWebSocketMainFileName, ownTopicWebSocketFunctionName, upperFirst } from './flowNaming.js';
 import { getFlowsForGeneration, getGeneratedCodeConfigs } from './flowSelection.js';
+import { normalizePropertyType } from './propertyNormalizer.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -41,11 +42,13 @@ export async function generateFlowMainFunction(allSchemas, options) {
     const flowOutputDir = path.join(baseOutputDir, subDir, upperCaseFlowTag, 'source');
     await fs.mkdir(flowOutputDir, { recursive: true });
 
-    // For ownTopic flows the SNS-publish file is <FlowTag>_Main.js; others stay Process<FlowTag>_Main.js
     const isOwnTopic = !isCrud && flow.event && flow.event.includes('ownTopic');
     const mainFileName = isOwnTopic
-      ? `${upperCaseFlowTag}_Main`
+      ? ownTopicMainFileName(flowTag)
       : processMainFileName(flowTag);
+    const functionName = isOwnTopic
+      ? ownTopicFunctionName(flowTag)
+      : processFunctionName(flowTag);
     const topicArn = `${upperCaseFlowTag}_In`;
 
     const generateCode = getGeneratedCodeConfigs(flows, flowTag, { includeFlowTag: true });
@@ -55,9 +58,6 @@ export async function generateFlowMainFunction(allSchemas, options) {
       templateName = `${flowTag}Endpoint_Main.ejs`;
     } else if (String(flowTag || '').toLowerCase().endsWith('rbacflow')) {
       templateName = 'FlowRbac_Main.ejs';
-    } else if (isOwnTopic) {
-      // Non-CRUD flow with ownTopic: WebSocket entry that fetches flowSchema and publishes to SNS In topic
-      templateName = 'FlowMain_Wbs.ejs';
     }
 
     // crud templates live under FlowObjects (the only output child that uses them);
@@ -75,27 +75,15 @@ export async function generateFlowMainFunction(allSchemas, options) {
       'utf-8'
     );
 
-    const startStep = flow.flowSteps && flow.flowSteps.find(
-      s => s.stepName === 'start'
-    );
+    const startStep = flow.flowSteps && flow.flowSteps.length > 0 ? flow.flowSteps[0] : null;
     let startConfig = startStep ? { ...startStep } : null;
 
     if (startConfig) {
       if (startConfig.properties && Array.isArray(startConfig.properties)) {
-        startConfig.properties = startConfig.properties.map(p => {
-          if (typeof p === 'string') {
-            return (flow.stepProperties && flow.stepProperties[p]) ? flow.stepProperties[p] : { propertyName: p, type: 'string' };
-          }
-          return p;
-        });
+        startConfig.properties = startConfig.properties.map(p => normalizePropertyType(p, flow.stepProperties));
       }
       if (startConfig.messageAttributes && Array.isArray(startConfig.messageAttributes)) {
-        startConfig.messageAttributes = startConfig.messageAttributes.map(p => {
-          if (typeof p === 'string') {
-            return (flow.stepMessageAttributes && flow.stepMessageAttributes[p]) ? flow.stepMessageAttributes[p] : { propertyName: p, type: 'string' };
-          }
-          return p;
-        });
+        startConfig.messageAttributes = startConfig.messageAttributes.map(p => normalizePropertyType(p, flow.stepMessageAttributes));
       }
     }
 
@@ -119,7 +107,8 @@ export async function generateFlowMainFunction(allSchemas, options) {
       generateCode: generateCode,
       flow: flow,
       startConfig: startConfig,
-      tableName: tableName
+      tableName: tableName,
+      functionName: functionName
     });
     await fs.writeFile(
       path.join(flowOutputDir, `${mainFileName}.js`),
@@ -127,25 +116,28 @@ export async function generateFlowMainFunction(allSchemas, options) {
       'utf-8'
     );
 
-    // For ownTopic flows: also generate Process${FlowTag}_Main.js (simple endpoint, triggered from SQS)
+    // For ownTopic flows: generate WebSocket main that publishes to SNS In topic
     if (isOwnTopic) {
-      const processMainTemplateStr = await fs.readFile(
-        path.join(__dirname, '..', '..', 'FlowSchemas', 'templates', 'endpoint', 'FlowEndpoint_Main.ejs'),
+      const wbsMainTemplateStr = await fs.readFile(
+        path.join(__dirname, '..', '..', 'FlowSchemas', 'templates', 'endpoint', 'FlowMain_Wbs.ejs'),
         'utf-8'
       );
-      const processMainContent = ejs.render(processMainTemplateStr, {
+      const wbsMainContent = ejs.render(wbsMainTemplateStr, {
         flowTag: flowTag,
         upperCaseFlowTag: upperCaseFlowTag,
+        topicArn: topicArn,
         generateCode: generateCode,
         flow: flow,
         startConfig: startConfig,
-        tableName: tableName
+        tableName: tableName,
+        functionName: ownTopicWebSocketFunctionName(flowTag)
       });
       await fs.writeFile(
-        path.join(flowOutputDir, `${processMainFileName(flowTag)}.js`),
-        processMainContent,
+        path.join(flowOutputDir, `${ownTopicWebSocketMainFileName(flowTag)}.js`),
+        wbsMainContent,
         'utf-8'
       );
+      generatedCount++;
     }
 
     // 2. Generate BeforeLogical Main Logic File if needed (CRUD flows only)

package/src/codeGenerators/app/src/generatedCode/Flow/_shared/shared/flowNaming.js

@@ -16,6 +16,22 @@ export function processFunctionName(flowTag) {
     return `Process${upperFirst(flowTag)}`;
 }
 
+export function ownTopicMainFileName(flowTag) {
+    return `${upperFirst(flowTag)}_Main`;
+}
+
+export function ownTopicFunctionName(flowTag) {
+    return `${upperFirst(flowTag)}_Main`;
+}
+
+export function ownTopicWebSocketMainFileName(flowTag) {
+    return `${upperFirst(flowTag)}_WbsMain`;
+}
+
+export function ownTopicWebSocketFunctionName(flowTag) {
+    return `${upperFirst(flowTag)}_WbsMain`;
+}
+
 export function flowSourceLocation(subDir, flowTag) {
     return `src/generatedCode/${subDir}/${upperFirst(flowTag)}/source/`;
 }

package/src/codeGenerators/app/src/generatedCode/Flow/_shared/shared/flowStepBase.js

@@ -2,7 +2,7 @@ import path from 'path';
 import fs from 'fs/promises';
 import { fileURLToPath } from 'url';
 import ejs from 'ejs';
-import { getFlowOutputSubDir, isRbacFlow, isRelationshipFlow } from './flowClassifier.js';
+import { getFlowOutputSubDir, isRbacFlow, isRelationshipFlow, isCrudFlow } from './flowClassifier.js';
 import { getStepEventHandlerConfig, normalizeEvents } from './eventTypes.js';
 import { normalizeFlowSteps } from './flowStepNormalizer.js';
 import { getFlowsForGeneration } from './flowSelection.js';
@@ -52,9 +52,14 @@ export async function generateFlowSteps(allSchemas, options) {
 
         let createdDir = false;
 
-        for (const stepConfig of normalizeFlowSteps(flow.flowSteps)) {
+        const normalizedSteps = normalizeFlowSteps(flow.flowSteps);
+        for (let index = 0; index < normalizedSteps.length; index++) {
+            const stepConfig = normalizedSteps[index];
             const stepName = stepConfig.stepName;
-            if (['In', 'start', 'Out', 'beforeLogical'].includes(stepName)) continue;
+            
+            // Skip the first step (which is the entry point, handled by flowMainFunctionBase)
+            // Also skip traditional skipped steps by name for backward compatibility
+            if (index === 0 || ['in', 'start', 'out', 'beforelogical'].includes(stepName?.toLowerCase())) continue;
 
             if (!createdDir) {
                 await fs.mkdir(flowOutputDir, { recursive: true });
@@ -79,7 +84,7 @@ export async function generateFlowSteps(allSchemas, options) {
                 functionName: `${flowTag}${stepName}`,
             };
 
-            const isCompleteStep = stepName === 'Complete';
+            const isCompleteStep = stepName === 'Complete' && isCrudFlow(flowTag);
             // Base Step Generation
             if (isCompleteStep) {
                 templateToUse = templates.complete;

package/src/codeGenerators/app/src/generatedCode/Flow/_shared/shared/flowStepNormalizer.js

@@ -40,35 +40,36 @@ export function normalizeUnifiedFlows(rawFlows) {
         // Ensure flowSteps is always an Array for the rest of the generation process
         flow.flowSteps = normalizedSteps;
         
-        const hasStart = flow.flowSteps.some(s => s.stepName?.toLowerCase() === 'start');
-        
+        // ponytail: root-level event is standard, flowStep[0] has no event.
         if (flow.event) {
-            if (!hasStart) {
+            const firstStep = flow.flowSteps[0];
+            const needsStartStep = !firstStep || firstStep.event;
+            
+            if (needsStartStep) {
                 flow.flowSteps.unshift({
                     stepName: 'Start',
                     properties: flow.properties || [],
                     messageAttributes: flow.messageAttributes || []
                 });
             }
-        } else {
-            const firstStep = flow.flowSteps[0];
-            
-            if (firstStep) {
-                flow.event = firstStep.event;
-                if (firstStep.generatedCodeConfig) flow.generatedCodeConfig = firstStep.generatedCodeConfig;
-                if (firstStep.schedules) flow.schedules = firstStep.schedules;
-                if (firstStep.bucketName) flow.bucketName = firstStep.bucketName;
-                if (firstStep.createBucket !== undefined) flow.createBucket = firstStep.createBucket;
-                
-                if (!hasStart) {
-                    flow.flowSteps.unshift({
-                        stepName: 'Start',
-                        properties: firstStep.properties || [],
-                        messageAttributes: firstStep.messageAttributes || []
-                    });
+        }
+        // Validate flowStep events
+        flow.flowSteps.forEach((step, index) => {
+            if (index === 0) {
+                if (step.event) {
+                    throw new Error(`[Schema Error] Flow '${flow.flowTag || 'Unknown'}' -> stepName '${step.stepName}' (Index 0) must not have an 'event'. Set it at the flow root instead.`);
+                }
+            } else {
+                if (step.event) {
+                    const validStepEvents = ['extTopic', 'lambdaSyncInv', 'dsq'];
+                    const invalidEvents = step.event.filter(e => !validStepEvents.includes(e));
+                    if (invalidEvents.length > 0) {
+                        throw new Error(`[Schema Error] Flow '${flow.flowTag || 'Unknown'}' -> stepName '${step.stepName}' has invalid event: ${invalidEvents.join(', ')}. Allowed: ${validStepEvents.join(', ')}`);
+                    }
                 }
             }
-        }
+        });
+
         return flow;
     });
 }

package/src/codeGenerators/app/src/generatedCode/Flow/_shared/shared/flowValidator.js

@@ -85,7 +85,6 @@ export function validateFlowsForGeneration(flows) {
     const flowSteps = Array.isArray(flow.flowSteps) ? flow.flowSteps : [];
     const seenStepNames = new Set();
     let anyStepHasPlugInHooks = false;
-    let startStepCount = 0;
 
     for (const step of flowSteps) {
       const stepName = step?.stepName;
@@ -99,13 +98,6 @@ export function validateFlowsForGeneration(flows) {
       }
       seenStepNames.add(stepName);
 
-      if (stepName === 'In') {
-        errors.push(`Flow '${flowTag}' uses legacy stepName 'In'. Use 'start'.`);
-      }
-      if (stepName === 'start') {
-        startStepCount += 1;
-      }
-
       if (step.plugInHooks && step.plugInHooks.length > 0) {
         anyStepHasPlugInHooks = true;
       }
@@ -120,11 +112,7 @@ export function validateFlowsForGeneration(flows) {
       validateNamedRefs(flowTag, stepName, step.messageAttributes, flow.stepMessageAttributes, 'messageAttributes', errors);
     }
 
-    if (startStepCount > 1) {
-      errors.push(`Flow '${flowTag}' has multiple 'start' steps. Only one is allowed.`);
-    }
-
-    // ponytail: relaxed anyStepHasPlugInHooks && startStepCount === 0 requirement 
+    // ponytail: relaxed anyStepHasPlugInHooks requirement 
     // since unified entry points (step 0) can now handle plugins directly without start.
 
     if (anyStepHasPlugInHooks) {

package/src/codeGenerators/app/src/generatedCode/Flow/_shared/shared/propertyNormalizer.js

@@ -0,0 +1,20 @@
+const TYPE_MAP = {
+    string: 'string', number: 'number', integer: 'number',
+    currency: 'string', currencyValue: 'number', numeric: 'number',
+    float: 'number', special: 'string', object: 'object',
+    boolean: 'boolean', array: 'array', arrayMixed: 'array',
+    arrayObject: 'array', arrayNumeric: 'array', arrayString: 'array',
+    timestamp: 'number'
+};
+
+export function normalizePropertyType(p, lookupSource) {
+    let prop = typeof p === 'string'
+        ? ((lookupSource && lookupSource[p]) ? lookupSource[p] : { propertyName: p, type: 'string' })
+        : p;
+    
+    if (prop && prop.type) {
+        prop = { ...prop, type: TYPE_MAP[prop.type] || prop.type };
+    }
+    
+    return prop;
+}

package/src/codeGenerators/app/src/generatedCode/Flow/_shared/shared/roleNameDetection.js

@@ -0,0 +1,49 @@
+import { getFlowsForGeneration } from './flowSelection.js';
+import { isCrudFlow, isRbacFlow, isRelationshipFlow } from './flowClassifier.js';
+
+export const FLOW_OBJECTS_ROLE = 'FlowObjectsRole';
+export const FLOW_RBAC_ROLE = 'FlowRbacRole';
+export const FLOW_RELATIONSHIP_ROLE = 'FlowRelationshipRole';
+export const WEB_SOCKET_MAIN_ROLE = 'WebSocketMainRole';
+export const PROC_FIND_DATA_ROLE = 'ProcFindDataRole';
+
+function upperCase(str) {
+  if (!str) return str;
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+
+function isCustomRbacFlow(flowTag) {
+  return String(flowTag || '').toLowerCase().endsWith('rbacflow');
+}
+
+export function detectRoleNames(allSchemas) {
+  const flows = getFlowsForGeneration(allSchemas);
+  const roleNames = new Set([PROC_FIND_DATA_ROLE]);
+
+  for (const flow of flows) {
+    if (!flow.flowTag) continue;
+
+    if (isCrudFlow(flow.flowTag)) {
+      roleNames.add(FLOW_OBJECTS_ROLE);
+      continue;
+    }
+
+    if (isRbacFlow(flow.flowTag) || isCustomRbacFlow(flow.flowTag)) {
+      roleNames.add(FLOW_RBAC_ROLE);
+      continue;
+    }
+
+    if (isRelationshipFlow(flow.flowTag)) {
+      roleNames.add(FLOW_RELATIONSHIP_ROLE);
+      continue;
+    }
+
+    if ((flow.event || []).includes('ownTopic')) {
+      roleNames.add(WEB_SOCKET_MAIN_ROLE);
+    }
+
+    roleNames.add(`${upperCase(flow.flowTag)}Role`);
+  }
+
+  return { flows, roleNames };
+}

package/src/codeGenerators/resource/sls_yaml/DynamoDBGenerator.js

@@ -6,15 +6,6 @@ import ejs from 'ejs';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
-async function appendToFile(filePath, content) {
-    try {
-        await fs.mkdir(path.dirname(filePath), { recursive: true });
-        await fs.appendFile(filePath, content + '\n', 'utf-8');
-    } catch (error) {
-        console.error(`[Error] Failed to append to file: ${filePath}`, error);
-    }
-}
-
 export async function generateDynamoDBTables(allSchemas, options) {
     console.log('  [DynamoDBGenerator] Generating DynamoDB Tables...');
 
@@ -88,7 +79,7 @@ export async function generateDynamoDBTables(allSchemas, options) {
             pk: keys.pk,
             sk: keys.sk
         });
-        await appendToFile(yamlOutputPath, yamlContent);
+    await fs.appendFile(yamlOutputPath, `${yamlContent}\n`, 'utf-8');
         generatedCount++;
     }
 

package/src/codeGenerators/resource/sls_yaml/FlowOutGenerator.js

@@ -8,15 +8,6 @@ import { getFlowsForGeneration } from '../../app/src/generatedCode/Flow/_shared/
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
-async function appendToFile(filePath, content) {
-  try {
-    await fs.mkdir(path.dirname(filePath), { recursive: true });
-    await fs.appendFile(filePath, `${content}\n`, 'utf-8');
-  } catch (error) {
-    console.error(`[Error] Failed to append file: ${filePath}`, error);
-  }
-}
-
 export async function generateFlowOut(allSchemas, options) {
   console.log('  [FlowOutGenerator] Generating Flow Out nodes (SNS Topics)...');
 
@@ -37,7 +28,7 @@ export async function generateFlowOut(allSchemas, options) {
 
     generatedTopics.add(topicName);
     const yamlContent = ejs.render(yamlTpl, { topicName });
-    await appendToFile(yamlOutputPath, yamlContent);
+    await fs.appendFile(yamlOutputPath, `${yamlContent}\n`, 'utf-8');
     generatedCount++;
   }
 

package/src/codeGenerators/resource/sls_yaml/FlowResourceYamlGenerator.js

@@ -8,15 +8,6 @@ import { getFlowsForGeneration } from '../../app/src/generatedCode/Flow/_shared/
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
-async function appendToFile(filePath, content) {
-  try {
-    await fs.mkdir(path.dirname(filePath), { recursive: true });
-    await fs.appendFile(filePath, `${content}\n`, 'utf-8');
-  } catch (error) {
-    console.error(`[Error] Failed to append file: ${filePath}`, error);
-  }
-}
-
 export async function generateFlowResourceYaml(allSchemas, options) {
   console.log('  [FlowResourceYamlGenerator] Generating SQS/SNS YAML resources for flows...');
 
@@ -42,7 +33,7 @@ export async function generateFlowResourceYaml(allSchemas, options) {
 
     generatedResources.add(resourceKey);
     const yamlContent = ejs.render(template, templateData);
-    await appendToFile(yamlOutputPath, yamlContent);
+    await fs.appendFile(yamlOutputPath, `${yamlContent}\n`, 'utf-8');
     generatedCount++;
   }
 
@@ -79,7 +70,7 @@ export async function generateFlowResourceYaml(allSchemas, options) {
     if (Array.isArray(flow.flowSteps)) {
       for (const stepConfig of flow.flowSteps) {
         const stepName = stepConfig.stepName;
-        if (stepName === 'start') continue;
+        if (stepName?.toLowerCase() === 'start') continue;
 
         const events = stepConfig.event || ['extTopic'];
         for (const ev of events) {

package/src/core/validate.js

@@ -20,17 +20,21 @@ export async function validateSchemas(rootPath) {
     // 1. Read config for bucket name and service tag
     let configStr = '';
     let iz_serviceTag = '';
+    let iz_serviceName = '';
     let iz_serviceSchemaBucketName = '';
     try {
         configStr = await fs.readFile(serviceConfigPath, 'utf8');
         const config = yaml.parse(configStr);
         iz_serviceTag = config?.main_config?.iz_serviceTag;
+        iz_serviceName = config?.main_config?.iz_serviceName || iz_serviceTag;
         iz_serviceSchemaBucketName = config?.main_config?.iz_serviceSchemaBucketName || 'unknown-bucket';
         
-        if (!iz_serviceTag) {
-            validateStatus.validateErrors.push('Missing iz_serviceTag in serverless.config.yml. This is a critical configuration field.');
-        } else if (!/^[a-zA-Z0-9]+$/.test(iz_serviceTag)) {
-            validateStatus.validateErrors.push(`iz_serviceTag '${iz_serviceTag}' must contain only alphanumeric characters ([a-zA-Z0-9]).`);
+        if (!iz_serviceName) {
+            validateStatus.validateErrors.push('Missing iz_serviceName or iz_serviceTag in serverless.config.yml. This is a critical configuration field.');
+        } else if (!/^[a-zA-Z0-9]+$/.test(iz_serviceName)) {
+            validateStatus.validateErrors.push(`Service Name '${iz_serviceName}' must contain only alphanumeric characters ([a-zA-Z0-9]).`);
+        } else {
+            console.log(`  [Validator] Validating with serviceName: '${iz_serviceName}'`);
         }
     } catch (e) {
         validateStatus.validateErrors.push(`Could not read or parse serverless.config.yml at ${serviceConfigPath}: ${e.message}`);
@@ -124,7 +128,7 @@ export async function validateSchemas(rootPath) {
                 if (flow.objType && flow.objType.objectType) {
                     const targetObj = objectSchemasMap[flow.objType.objectType];
                     if (targetObj) {
-                        const expectedPrefix = `TST_${flow.flowTag}`; // Example prefix logic
+                        const expectedPrefix = `${iz_serviceName}_${flow.flowTag}`; // Prefix logic based on service name
                         const isMissingFields = !targetObj.fieldNames || !targetObj.fieldNames[`${expectedPrefix}Status`];
                         
                         if (isMissingFields) {

package/src/generate.js

@@ -87,7 +87,7 @@ async function generate(rootPath, options = {}) {
   }
 
   const startTime = Date.now();
-  await generateCode(rootPath, { outputPath });
+  await generateCode(rootPath, { outputPath, configPath });
   return { durationMs: Date.now() - startTime };
 }