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

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

@@ -0,0 +1,64 @@
+import path from 'path';
+import fs from 'fs/promises';
+import { fileURLToPath } from 'url';
+import ejs from 'ejs';
+import { getFlowsForGeneration } from '../../app/src/generatedCode/Flow/_internal/shared/flowSelection.js';
+
+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 generateFlowOut(allSchemas, options) {
+    console.log('  [FlowOutGenerator] Generating Flow Out nodes (SNS Topics)...');
+    
+    const resourceYamlDir = path.join(options.outputPath, 'resource', 'sls_yaml', 'generatedCode', 'source');
+    await fs.mkdir(resourceYamlDir, { recursive: true });
+
+    const yamlTplPath = path.join(__dirname, 'templates', 'FlowOut_Yaml.ejs');
+    const yamlTpl = await fs.readFile(yamlTplPath, 'utf-8');
+
+    let generatedCount = 0;
+    const yamlOutputPath = path.join(resourceYamlDir, 'generated-sns-out.yml');
+
+    const flows = getFlowsForGeneration(allSchemas);
+    for (const flow of flows) {
+        if (flow.outputTopic === true) {
+            const upperCase = (str) => str.charAt(0).toUpperCase() + str.slice(1);
+            const topicName = upperCase(flow.flowTag);
+
+            const yamlContent = ejs.render(yamlTpl, {
+                topicName: topicName
+            });
+
+            await appendToFile(yamlOutputPath, yamlContent);
+            generatedCount++;
+        }
+    }
+
+    const systemTopics = [
+        'CreateObjectComplete',
+        'DeleteNodeComplete',
+        'UpdateNodeComplete',
+        'GetNodeComplete',
+        'ProcessLogicalComplete',
+        'FindDataComplete'
+    ];
+
+    for (const topic of systemTopics) {
+        const yamlContent = ejs.render(yamlTpl, {
+            topicName: topic
+        });
+        await appendToFile(yamlOutputPath, yamlContent);
+        generatedCount++;
+    }
+
+    console.log(`  [FlowOutGenerator] Generated ${generatedCount} SNS Topics for Flow Out nodes.`);
+}

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

@@ -0,0 +1,172 @@
+import path from 'path';
+import fs from 'fs/promises';
+import { fileURLToPath } from 'url';
+import ejs from 'ejs';
+import { getFlowsForGeneration } from '../../app/src/generatedCode/Flow/_internal/shared/flowSelection.js';
+
+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 generateFlowResourceYaml(allSchemas, options) {
+    console.log('  [FlowResourceYamlGenerator] Generating SQS/SNS YAML resources for flows...');
+    
+    const resourceYamlDir = path.join(options.outputPath, 'resource', 'sls_yaml', 'generatedCode', 'source');
+    await fs.mkdir(resourceYamlDir, { recursive: true });
+
+    const resourceYamlTplPath = path.join(__dirname, 'templates', 'crud', 'ResourceYaml.ejs');
+    const resourceBeforeLogicalYamlTplPath = path.join(__dirname, 'templates', 'crud', 'ResourceBeforeLogicalYaml.ejs');
+    
+    const resourceYamlTpl = await fs.readFile(resourceYamlTplPath, 'utf-8');
+    const resourceBeforeLogicalYamlTpl = await fs.readFile(resourceBeforeLogicalYamlTplPath, 'utf-8');
+
+    let generatedCount = 0;
+    const yamlOutputPath = path.join(resourceYamlDir, 'generated-sns-in-sqs.yml');
+
+    const flows = getFlowsForGeneration(allSchemas);
+    for (const flow of flows) {
+        const flowTag = flow.flowTag;
+        
+        // Generate In-Queue resources for any flow that listens on its own topic
+        if (flow.event && flow.event.includes('ownTopic')) {
+            // Render main ResourceYaml.ejs (e.g., InCreate, CreateHdrSqs)
+            const yamlContent = ejs.render(resourceYamlTpl, {
+                queueName: flowTag
+            });
+            await appendToFile(yamlOutputPath, yamlContent);
+            generatedCount++;
+
+            // Check if there are beforeLogical configs for this flow
+            const generateCodeConfigs = flows
+                .filter(f => f.generatedCodeConfig && f.generatedCodeConfig.generatedCodeTag.toLowerCase() === flowTag.toLowerCase())
+                .map(f => ({
+                    ...f.generatedCodeConfig,
+                    flowTag: f.flowTag
+                }));
+
+            const beforeLogicalConfigs = generateCodeConfigs.filter(c => c.codeHookTag === 'beforeLogical');
+
+            if (beforeLogicalConfigs.length > 0) {
+                // Collect unique flowTags (like ValidateUnitTrackedProperty) from the beforeLogical configs
+                const uniqueFlowTags = [...new Set(beforeLogicalConfigs.map(c => c.flowTag))];
+                
+                const beforeLogicalYamlContent = ejs.render(resourceBeforeLogicalYamlTpl, {
+                    queueName: `${flowTag}BeforeLogical`,
+                    flowTags: uniqueFlowTags
+                });
+
+                await appendToFile(yamlOutputPath, beforeLogicalYamlContent);
+                generatedCount++;
+            }
+        } else if (flow.event && flow.event.includes('extTopic')) {
+            // Custom flows using extTopic do not have ownTopic, but need an entry queue
+            const resourceSqsYamlTplPath = path.join(__dirname, 'templates', 'crud', 'ResourceSqsYaml.ejs');
+            const resourceSqsYamlTpl = await fs.readFile(resourceSqsYamlTplPath, 'utf-8');
+            const yamlContent = ejs.render(resourceSqsYamlTpl, {
+                queueName: `Process${flowTag}Sqs`
+            });
+            await appendToFile(yamlOutputPath, yamlContent);
+            generatedCount++;
+        }
+        
+        // Generate Complete queues for custom FlowSchema
+        // Also generate queues for any flowStep that uses sqs, dsq, or extTopic
+        if (flow.flowSteps && Array.isArray(flow.flowSteps)) {
+            for (const stepConfig of flow.flowSteps) {
+                const stepName = stepConfig.stepName;
+                if (stepName === 'InTag') continue;
+                
+                const events = stepConfig.event || ['sqs'];
+                for (const ev of events) {
+                    let queueName = flowTag + stepName;
+                    if (stepName === 'Complete') {
+                        queueName = flowTag + 'Complete';
+                    }
+
+                    if (ev === 'sqs' || ev === 'ownTopic') {
+                        // sqs and ownTopic create SNS Topic + Subscription + SQS Queue
+                        const yamlContent = ejs.render(resourceYamlTpl, {
+                            queueName: queueName
+                        });
+                        await appendToFile(yamlOutputPath, yamlContent);
+                        generatedCount++;
+                    } else if (ev === 'dsq' || ev === 'extTopic') {
+                        // extTopic and dsq create ONLY SQS Queue
+                        const resourceSqsYamlTplPath = path.join(__dirname, 'templates', 'crud', 'ResourceSqsYaml.ejs');
+                        const resourceSqsYamlTpl = await fs.readFile(resourceSqsYamlTplPath, 'utf-8');
+                        const yamlContent = ejs.render(resourceSqsYamlTpl, {
+                            queueName: queueName
+                        });
+                        await appendToFile(yamlOutputPath, yamlContent);
+                        generatedCount++;
+                    }
+                }
+            }
+        }
+
+        // Generate SQS queues for S3 Event flows
+        if (flow.event && flow.event.includes('s3')) {
+            const queueNames = [
+                `${flowTag}CreatePreSignUrlSqs`,
+                `${flowTag}ReservedLimitSqs`
+            ];
+            
+            for (const qName of queueNames) {
+                const resourceSqsYamlTplPath = path.join(__dirname, 'templates', 'crud', 'ResourceSqsYaml.ejs');
+                const resourceSqsYamlTpl = await fs.readFile(resourceSqsYamlTplPath, 'utf-8');
+                const yamlContent = ejs.render(resourceSqsYamlTpl, {
+                    queueName: qName
+                });
+                await appendToFile(yamlOutputPath, yamlContent);
+                generatedCount++;
+            }
+        }
+
+        // Generate Dsq queues for Relationship
+        if (flow.isDynamicRelationshipType) {
+            // Usually Relationship has dead-letter queue processing
+            const resourceSqsYamlTplPath = path.join(__dirname, 'templates', 'crud', 'ResourceSqsYaml.ejs');
+            const resourceSqsYamlTpl = await fs.readFile(resourceSqsYamlTplPath, 'utf-8');
+            const queueName = flowTag + 'Dsq';
+            const yamlContent = ejs.render(resourceSqsYamlTpl, {
+                queueName: queueName
+            });
+            await appendToFile(yamlOutputPath, yamlContent);
+            generatedCount++;
+        }
+    }
+
+    // Add System Queues
+    const systemQueues = [
+        'ProcessLogical',
+        'PaginateProcessLogical',
+        'FindData',
+        'Register',
+        'WebSocket',
+        'CreateObjectComplete',
+        'UpdateNodeComplete',
+        'DeleteNodeComplete',
+        'GetNodeComplete'
+    ];
+
+    const resourceSqsYamlTplPath = path.join(__dirname, 'templates', 'crud', 'ResourceSqsYaml.ejs');
+    const resourceSqsYamlTpl = await fs.readFile(resourceSqsYamlTplPath, 'utf-8');
+
+    for (const sysQueue of systemQueues) {
+        const yamlContent = ejs.render(resourceSqsYamlTpl, {
+            queueName: sysQueue
+        });
+        await appendToFile(yamlOutputPath, yamlContent);
+        generatedCount++;
+    }
+
+    console.log(`  [FlowResourceYamlGenerator] Appended ${generatedCount} sections to generated-sns-in-sqs.yml.`);
+}

package/src/codeGenerators/resource/sls_yaml/templates/DynamoDBTable_Yaml.ejs

@@ -0,0 +1,20 @@
+##===== [DynamoDB Table: <%- tableName %>]
+  <%- tableName %>Table:
+    Type: AWS::DynamoDB::Table
+    Properties:
+      TableName: ${self:custom.iz_serviceTag}_${self:custom.iz_stage}_<%- tableName %>
+      BillingMode: PAY_PER_REQUEST
+      AttributeDefinitions:
+        - AttributeName: "<%- pk %>"
+          AttributeType: "S"
+<% if (sk) { %>
+        - AttributeName: "<%- sk %>"
+          AttributeType: "S"
+<% } %>
+      KeySchema:
+        - AttributeName: "<%- pk %>"
+          KeyType: "HASH"
+<% if (sk) { %>
+        - AttributeName: "<%- sk %>"
+          KeyType: "RANGE"
+<% } %>

package/src/{generators/fromObjectSchema/relationship/create/complete/sns-out/template.ejs → codeGenerators/resource/sls_yaml/templates/FlowOut_Yaml.ejs}

@@ -1,8 +1,6 @@
-##--------- [Create Topic Out]
-  Out<%- queueName %>:
+##===== [Topic Out]
+  Out<%- topicName %>:
     Type: AWS::SNS::Topic
     Properties:
       DisplayName: "SNS Message out"
-      TopicName: ${self:custom.iz_serviceTag}_${self:custom.iz_stage}_<%- queueName %>_Out
-
-  
+      TopicName: ${self:custom.iz_serviceTag}_${self:custom.iz_stage}_<%- topicName %>_Out

package/src/codeGenerators/resource/sls_yaml/templates/SystemDynamoDB_Yaml.ejs

@@ -0,0 +1,138 @@
+Resources:
+  WebSocketTaskTable:
+    Type: "AWS::DynamoDB::Table"
+    Properties:
+      TableName: ${self:custom.iz_resourcePrefix}WebSocketTask
+      BillingMode: PAY_PER_REQUEST
+      AttributeDefinitions:
+      - AttributeName: taskKey
+        AttributeType: S
+      - AttributeName: connectionId
+        AttributeType: S
+      KeySchema:
+      - AttributeName: taskKey
+        KeyType: HASH
+      - AttributeName: connectionId
+        KeyType: RANGE
+      TimeToLiveSpecification:
+        AttributeName: expirationTime
+        Enabled: true
+
+  UserUploadRecordsTable:
+    Type: "AWS::DynamoDB::Table"
+    Properties:
+      TableName: ${self:custom.iz_resourcePrefix}UserUploadRecords
+      BillingMode: PAY_PER_REQUEST
+      AttributeDefinitions:
+      - AttributeName: connectionId
+        AttributeType: S
+      KeySchema:
+      - AttributeName: connectionId
+        KeyType: HASH
+      TimeToLiveSpecification:
+        AttributeName: expirationTime
+        Enabled: true
+
+  RegisterRecordsTable:
+    Type: "AWS::DynamoDB::Table"
+    Properties:
+      TableName: ${self:custom.iz_resourcePrefix}RegisterRecords
+      BillingMode: PAY_PER_REQUEST
+      AttributeDefinitions:
+      - AttributeName: identifiersTask
+        AttributeType: S
+      - AttributeName: connectionId
+        AttributeType: S
+      KeySchema:
+      - AttributeName: identifiersTask
+        KeyType: HASH
+      - AttributeName: connectionId
+        KeyType: RANGE
+
+  AwaitingMultipleStepsTable:
+    Type: "AWS::DynamoDB::Table"
+    Properties:
+      TableName: ${self:custom.iz_resourcePrefix}AwaitingMultipleSteps
+      BillingMode: PAY_PER_REQUEST
+      AttributeDefinitions:
+      - AttributeName: awaitingStepId
+        AttributeType: S
+      - AttributeName: pendingStepId
+        AttributeType: S
+      KeySchema:
+      - AttributeName: awaitingStepId
+        KeyType: HASH
+      - AttributeName: pendingStepId
+        KeyType: RANGE
+
+  AwaitingMultipleStepByPendingTable:
+    Type: "AWS::DynamoDB::Table"
+    Properties:
+      TableName: ${self:custom.iz_resourcePrefix}AwaitingMultipleStepByPending
+      BillingMode: PAY_PER_REQUEST
+      AttributeDefinitions:
+      - AttributeName: pendingStepId
+        AttributeType: S
+      - AttributeName: awaitingStepId
+        AttributeType: S
+      KeySchema:
+      - AttributeName: pendingStepId
+        KeyType: HASH
+      - AttributeName: awaitingStepId
+        KeyType: RANGE
+
+  FindDataMainTable:
+    Type: "AWS::DynamoDB::Table"
+    Properties:
+      TableName: ${self:custom.iz_resourcePrefix}FindDataMain
+      BillingMode: PAY_PER_REQUEST
+      AttributeDefinitions:
+      - AttributeName: findDataId
+        AttributeType: S
+      KeySchema:
+      - AttributeName: findDataId
+        KeyType: HASH
+
+  LogicalResultsMainTable:
+    Type: "AWS::DynamoDB::Table"
+    Properties:
+      TableName: ${self:custom.iz_resourcePrefix}LogicalResultsMain
+      BillingMode: PAY_PER_REQUEST
+      AttributeDefinitions:
+      - AttributeName: logicalResultId
+        AttributeType: S
+      KeySchema:
+      - AttributeName: logicalResultId
+        KeyType: HASH
+
+  LogicalResultsDataTable:
+    Type: "AWS::DynamoDB::Table"
+    Properties:
+      TableName: ${self:custom.iz_resourcePrefix}LogicalResultsData
+      BillingMode: PAY_PER_REQUEST
+      AttributeDefinitions:
+      - AttributeName: logicalResultId
+        AttributeType: S
+      - AttributeName: identifiersId
+        AttributeType: S
+      KeySchema:
+      - AttributeName: logicalResultId
+        KeyType: HASH
+      - AttributeName: identifiersId
+        KeyType: RANGE
+
+  AwaitingStepTable:
+    Type: "AWS::DynamoDB::Table"
+    Properties:
+      TableName: ${self:custom.iz_resourcePrefix}AwaitingStep
+      BillingMode: PAY_PER_REQUEST
+      AttributeDefinitions:
+      - AttributeName: awaitingStepId
+        AttributeType: S
+      - AttributeName: pendingStepId
+        AttributeType: S
+      KeySchema:
+      - AttributeName: awaitingStepId
+        KeyType: HASH
+      - AttributeName: pendingStepId
+        KeyType: RANGE

package/src/{generators/fromObjectSchema/relationship/update/complete/sns-in-sqs/template.ejs → codeGenerators/resource/sls_yaml/templates/crud/ResourceSqsYaml.ejs}

@@ -1,22 +1,23 @@
-##===== [Queue]
+  ##===== [Queue]
   <%- queueName %>:
     Type: "AWS::SQS::Queue"
     Properties:
       QueueName: ${self:custom.iz_resourcePrefix}<%- queueName %>
       RedrivePolicy:
         deadLetterTargetArn:
-        # !GetAtt
           Fn::GetAtt:
             - <%- queueName %>DLQ
             - Arn
         maxReceiveCount: 3
       VisibilityTimeout: 120
-##==== [QueueDLQ]
+
+  ##===== [Queue DLQ]
   <%- queueName %>DLQ:
     Type: AWS::SQS::Queue
     Properties:
       QueueName: ${self:custom.iz_resourcePrefix}<%- queueName %>DLQ
-##==== [QueuePolicy]
+
+  ##===== [Queue Policy]
   <%- queueName %>Policy:
     Type: AWS::SQS::QueuePolicy
     Properties:
@@ -27,17 +28,12 @@
             Effect: Allow
             Principal: "*"
             Resource:
-            # !GetAtt
               Fn::GetAtt:
                 - <%- queueName %>
                 - Arn
             Action: "SQS:SendMessage"
       Queues:
         - Ref: <%- queueName %>
+
   #<#<%- queueName %>QueueSetting#>
   #<#/<%- queueName %>QueueSetting#>
-
-
-<%_ function firstLetterLowerCase(str) {
-  return str.charAt(0).toLowerCase() + str.slice(1)
-} _%>

package/src/{generators/fromObjectSchema/endpoint/resourceTemplate.ejs → codeGenerators/resource/sls_yaml/templates/crud/ResourceYaml.ejs}

@@ -10,30 +10,30 @@
     Type: AWS::SNS::Subscription
     Properties:
       TopicArn: !Ref In<%- queueName %>
-      Endpoint: "arn:aws:sqs:${self:custom.iz_region}:${self:custom.iz_accountId}:${self:custom.iz_resourcePrefix}<%- queueName %>HdrSqs"
+      Endpoint: "arn:aws:sqs:${self:custom.iz_region}:${self:custom.iz_accountId}:${self:custom.iz_resourcePrefix}<%- queueName %>Sqs"
       Protocol: "sqs"
 
   ##===== [Queue]
-  <%- queueName %>HdrSqs:
+  <%- queueName %>Sqs:
     Type: "AWS::SQS::Queue"
     Properties:
-      QueueName: ${self:custom.iz_resourcePrefix}<%- queueName %>HdrSqs
+      QueueName: ${self:custom.iz_resourcePrefix}<%- queueName %>Sqs
       RedrivePolicy:
         deadLetterTargetArn:
           Fn::GetAtt:
-            - <%- queueName %>HdrSqsDLQ
+            - <%- queueName %>SqsDLQ
             - Arn
         maxReceiveCount: 3
       VisibilityTimeout: 120
 
   ##===== [Queue DLQ]
-  <%- queueName %>HdrSqsDLQ:
+  <%- queueName %>SqsDLQ:
     Type: AWS::SQS::Queue
     Properties:
-      QueueName: ${self:custom.iz_resourcePrefix}<%- queueName %>HdrSqsDLQ
+      QueueName: ${self:custom.iz_resourcePrefix}<%- queueName %>SqsDLQ
 
   ##===== [Queue Policy]
-  <%- queueName %>HdrSqsPolicy:
+  <%- queueName %>SqsPolicy:
     Type: AWS::SQS::QueuePolicy
     Properties:
       PolicyDocument:
@@ -44,11 +44,11 @@
             Principal: "*"
             Resource:
               Fn::GetAtt:
-                - <%- queueName %>HdrSqs
+                - <%- queueName %>Sqs
                 - Arn
             Action: "SQS:SendMessage"
       Queues:
-        - Ref: <%- queueName %>HdrSqs
+        - Ref: <%- queueName %>Sqs
 
   #<#<%- queueName %>QueueSetting#>
   #<#/<%- queueName %>QueueSetting#>

package/src/core/validate.js

@@ -0,0 +1,161 @@
+import { getObjectSchema, utils } from '@izara_project/izara-core-library-service-schemas';
+import path from 'path';
+import fs from 'fs/promises';
+import yaml from 'yaml';
+
+export async function validateSchemas(rootPath) {
+    const schemasPath = path.join(rootPath, 'app', 'src', 'schemas');
+    const serviceConfigPath = path.join(rootPath, 'config', 'serverless.config.yml');
+    const _izContext = { reqId: 'validate-sandbox', logger: console };
+
+    console.log('  [Validator] Validating local schemas with Safe Two-Way S3 Validation...');
+
+    let validateStatus = {
+        status: true,
+        validateErrors: [],
+        referenceErrors: [],
+        warning: []
+    };
+
+    // 1. Read config for bucket name and service tag
+    let configStr = '';
+    let iz_serviceTag = '';
+    let iz_serviceSchemaBucketName = '';
+    try {
+        configStr = await fs.readFile(serviceConfigPath, 'utf8');
+        const config = yaml.parse(configStr);
+        iz_serviceTag = config?.main_config?.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]).`);
+        }
+    } catch (e) {
+        validateStatus.validateErrors.push(`Could not read or parse serverless.config.yml at ${serviceConfigPath}: ${e.message}`);
+    }
+
+    // 2. Fetch local FlowSchemas (Basic validation)
+    try {
+        const flowsResponse = await getObjectSchema.getAllLocalFlowSchemas(_izContext, schemasPath);
+        const flows = flowsResponse.records || [];
+        for (const flow of flows) {
+            if (flow && flow.flowTag && !/^[A-Z]/.test(flow.flowTag)) {
+                validateStatus.validateErrors.push(`flowTag '${flow.flowTag}' must start with an uppercase letter.`);
+            }
+        }
+    } catch (e) {
+        validateStatus.warning.push(`Failed to load local flows: ${e.message}`);
+    }
+
+    // 3. Fetch local Reference Object Relationships for Two-Way Validation
+    console.log('  [Validator] Checking Cross-Service Reference Relationships...');
+    try {
+        const allReferenceObjectRelationships = await getObjectSchema.getAllLocalRefObjectRelationshipSchema(_izContext, schemasPath);
+        
+        await Promise.all(
+            allReferenceObjectRelationships.map(async refRelSchema => {
+                if (!refRelSchema) return;
+                try {
+                    // Try to fetch relationship schema from S3
+                    const relSchemaFromRef = await getObjectSchema.getRelationshipSchema(
+                        _izContext,
+                        {
+                            serviceTag: refRelSchema.relationshipServiceTag,
+                            relationshipTag: refRelSchema.relationshipTag
+                        },
+                        iz_serviceSchemaBucketName
+                    );
+
+                    if (!relSchemaFromRef) {
+                        validateStatus.referenceErrors.push(`[Safe] Invalid reference: '${refRelSchema.objectType}' -> '${refRelSchema.relationshipTag}' not found in service '${refRelSchema.relationshipServiceTag}' on S3.`);
+                    } else {
+                        // Two-way validation logic via utils
+                        const linkRecords = utils.findLinkByObjTypeV2(
+                            _izContext,
+                            { objectType: refRelSchema.objectType, serviceTag: iz_serviceTag },
+                            { serviceTag: refRelSchema.relationshipServiceTag, relationshipTag: refRelSchema.relationshipTag },
+                            relSchemaFromRef
+                        );
+
+                        if (!linkRecords || !linkRecords.length) {
+                            validateStatus.referenceErrors.push(`[Safe] Two-way validation failed: '${refRelSchema.relationshipTag}' in service '${refRelSchema.relationshipServiceTag}' does not link back to '${refRelSchema.objectType}'.`);
+                        }
+                    }
+                } catch (s3Error) {
+                    // ROBUSTNESS: Catch S3 NoSuchKey or any other SDK errors without crashing
+                    validateStatus.referenceErrors.push(`[Safe] S3 Fetch Error for '${refRelSchema.relationshipServiceTag}': ${s3Error.message || s3Error.Code}`);
+                }
+            })
+        );
+    } catch (e) {
+        validateStatus.warning.push(`Failed to check cross-service relationships: ${e.message}`);
+    }
+
+    // 4. Validate FlowSchemas Cache Fields and Custom Events (Developer Explanations)
+    try {
+        console.log('  [Validator] Checking FlowSchemas for strict compatibility issues (Soft Validation)...');
+        const allObjectSchemas = await getObjectSchema.getAllLocalObjectSchemasWithoutHierarchy(_izContext, schemasPath);
+        const objectSchemasMap = {};
+        if (allObjectSchemas && allObjectSchemas.records) {
+            allObjectSchemas.records.forEach(schema => {
+                if(schema) objectSchemasMap[schema.objectType] = schema;
+            });
+        }
+
+        const flowsResponse = await getObjectSchema.getAllLocalFlowSchemas(_izContext, schemasPath);
+        const flows = flowsResponse.records || [];
+        for (const flow of flows) {
+            if (!flow) continue;
+
+            // Check unsupported Enum (like dsq)
+            if (flow.event && Array.isArray(flow.event)) {
+                if (flow.event.includes('dsq')) {
+                    const errMsg = `\n  [Developer Error] FlowTag: '${flow.flowTag}' uses Event: 'dsq'\n` +
+                                   `    💡 Detailed Explanation: 'dsq' is a non-standard Event Type not found in the legacy validator enum.\n` +
+                                   `       Please change it to a supported event type (e.g., 'sqs') or update the allowed enums to proceed.`;
+                    validateStatus.validateErrors.push(errMsg);
+                }
+            }
+
+            // Check triggerCache expectations
+            if (flow.statusType === 'triggerCache' || flow.statusType === 'storedCache' || flow.statusType === 'statusField') {
+                if (flow.objType && flow.objType.objectType) {
+                    const targetObj = objectSchemasMap[flow.objType.objectType];
+                    if (targetObj) {
+                        const expectedPrefix = `TST_${flow.flowTag}`; // Example prefix logic
+                        const isMissingFields = !targetObj.fieldNames || !targetObj.fieldNames[`${expectedPrefix}Status`];
+                        
+                        if (isMissingFields) {
+                            const errMsg = `\n  [Developer Error] FlowTag: '${flow.flowTag}' has Cache enabled (statusType: '${flow.statusType}')\n` +
+                                           `    💡 Detailed Explanation: The validator requires Object '${targetObj.objectType}' to define specific cache status fields in DynamoDB when caching is enabled.\n` +
+                                           `       (e.g., Fields: ${expectedPrefix}Status, ${expectedPrefix}ErrorsFound, ${expectedPrefix}CacheComplete, etc.)\n` +
+                                           `       Please add these fields to ${targetObj.objectType}.js before continuing.`;
+                            validateStatus.validateErrors.push(errMsg);
+                        }
+                    }
+                }
+            }
+        }
+    } catch (e) {
+        console.warn(`  [Validator] Failed to run developer explanations: ${e.message}`);
+    }
+
+    // 5. Summarize Validation
+    if (validateStatus.validateErrors.length > 0) {
+        console.error('  [Validator] VALIDATION ERRORS:', validateStatus.validateErrors);
+        throw new Error(`Validation failed with ${validateStatus.validateErrors.length} critical errors.`);
+    }
+
+    if (validateStatus.referenceErrors.length > 0) {
+        console.warn('  [Validator] REFERENCE WARNINGS (S3/Cross-Service):', validateStatus.referenceErrors);
+        console.warn('  [Validator] Continuing generation despite reference warnings (Offline-friendly mode).');
+    }
+
+    if (validateStatus.warning.length > 0) {
+        console.warn('  [Validator] WARNINGS:', validateStatus.warning);
+    }
+
+    console.log('  [Validator] All local critical validations passed successfully.');
+}