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

package/src/libs/consts/functions.js

@@ -0,0 +1,96 @@
+const FUNCTION_NAME = {
+  updateRel: 'updateRelationship',
+  createRel: 'createRelationship',
+  updateRelComplete: 'updateRelationshipComplete',
+  createRelComplete: 'createRelationshipComplete',
+  deleteRel: 'deleteRelationship',
+  deleteRelComplete: 'deleteRelationshipComplete',
+  translateId: 'translateIdsRequest',
+  translateIdsProcess: 'processTranslateIds',
+  outTranslateIds: 'processTranslateIdsComplete',
+  findData: 'findData',
+  processLogical: 'processLogical',
+  updateNodeComplete: 'updateNodeComplete',
+  createObjectComplete: 'createObjectComplete',
+  getNodeComplete: 'getNodeComplete',
+  paginateProcessLogical: 'paginateProcessLogical',
+  deleteNode: 'deleteNode',
+  deleteNodeComplete: 'deleteNodeComplete',
+  createObjectS3: 'createObjectS3',
+  createObjectS3Complete: 'webSocketTaskComplete',
+  processAfterUploadS3: 'processAfterUploadS3',
+  getRel: 'getRelationship',
+  getRelComplete: 'getRelationshipComplete',
+  reservedLimit: 'reservedLimit',
+  createPresignUrl: 'createPresignUrl',
+  flowSchemaOwnTopic: 'flowSchemaOwnTopic',
+  flowSchemaOwnTopicComplete: 'flowSchemaOwnTopicComplete',
+  flowSchemaOwnTopicEndpoint: 'flowSchemaOwnTopicEndpoint',
+  flowSchemaOwnTopicEndpointComplete: 'flowSchemaOwnTopicEndpointComplete',
+  flowSchemaExternalTopic: 'externalTopic',
+  flowSchemaEventBridge: 'EventBridge',
+  createRecordComplete: 'createRecordComplete',
+  flowSchemaRegister: 'register',
+  changeRel: 'changeRelationship',
+  changeRelComplete: 'changeRelationshipComplete',
+  moveRel: 'moveRelationship',
+  moveRelComplete: 'moveRelationshipComplete'
+};
+
+const SHORT_FUNCTION_NAME = functionName => {
+  return {
+    [FUNCTION_NAME.updateRel]: 'updateRel',
+    [FUNCTION_NAME.createRel]: 'createRel',
+    [FUNCTION_NAME.updateRelComplete]: 'updateRelComp',
+    [FUNCTION_NAME.createRelComplete]: 'createRelComp',
+    [FUNCTION_NAME.deleteRel]: 'deleteRel',
+    [FUNCTION_NAME.deleteRelComplete]: 'deleteRelComp',
+    [FUNCTION_NAME.findData]: 'findData',
+    [FUNCTION_NAME.processLogical]: 'processLogical',
+    [FUNCTION_NAME.updateNodeComplete]: 'updateNodeComp',
+    [FUNCTION_NAME.createObjectComplete]: 'createObjectComp',
+    [FUNCTION_NAME.getNodeComplete]: 'getNodeComp',
+    [FUNCTION_NAME.paginateProcessLogical]: 'paginateProLogical',
+    [FUNCTION_NAME.deleteNode]: 'deleteNode',
+    [FUNCTION_NAME.deleteNodeComplete]: 'deleteNodeComp',
+    [FUNCTION_NAME.createObjectS3Complete]: 'webSocketTaskComp',
+    [FUNCTION_NAME.getRel]: 'getRel',
+    [FUNCTION_NAME.getRelComplete]: 'getRelComp',
+    [FUNCTION_NAME.changeRel]: 'changeRel',
+    [FUNCTION_NAME.changeRelComplete]: 'changeRelComp',
+    [FUNCTION_NAME.moveRel]: 'moveRel',
+    [FUNCTION_NAME.moveRelComplete]: 'moveRelComp'
+  }[functionName];
+};
+
+const PREFIX = {
+  updateRel: 'updateRelationshipEndpoint',
+  createRel: 'createRelationshipEndpoint',
+  deleteRel: 'deleteRelationshipEndpoint',
+  updateNode: 'updateNodeEndpoint',
+  createNode: 'createNodeEndpoint',
+  getRel: 'getRelationshipEndpoint',
+  changeRel: 'changeRelationshipEndpoint',
+  ONE: 'one',
+  MANY: 'many',
+  CREATE_OBJECT_ASYNC: 'createObjectAsync',
+  CREATE_OBJECT_ASYNC_COMPLETE: 'createObjectAsyncComplete',
+  CREATE_OBJECT_EXTERNAL_TOPIC: 'createObjectExternalTopic'
+};
+
+const SOURCE_GENERATE_IAM_ROLE = {
+  ProcessFindDataRole: 'ProcFindData',
+  ObjectCompleteRole: 'ObjectCom',
+  NodeCompleteRole: 'NodeCom',
+  RelationshipRole: 'Relationship',
+  RelationshipCompleteRole: 'RelationshipCom',
+  FlowSchemaUploadS3Role: 'FlowSchemaUploadS3',
+  FlowSchemaOwnTopic: 'FlowSchemaOwnTopic',
+  PerActionEndpoint: 'PerActionEndpoint',
+  ExternalTopicRole: 'ExternalTopic',
+  EventBridge: 'EventBridge',
+  CreateRecordComplete: 'CreateRecordComplete',
+  RegisterRole: 'Register'
+};
+
+export { FUNCTION_NAME, SHORT_FUNCTION_NAME, PREFIX, SOURCE_GENERATE_IAM_ROLE };

package/src/libs/consts/handlers.js

@@ -0,0 +1,30 @@
+import { consts as coreConsts } from '@izara_project/izara-core-library-service-schemas';
+const { HANDLER, ACTIONS, STORAGE_TYPES } = coreConsts;
+
+const DEFAULT_HANDLER_PER_ACTION = {
+  [ACTIONS.create]: [HANDLER.hdrApi, HANDLER.hdrSqs, HANDLER.hdrInv],
+  [ACTIONS.update]: [HANDLER.hdrApi, HANDLER.hdrSqs, HANDLER.hdrInv],
+  [ACTIONS.get]: [HANDLER.hdrApi, HANDLER.hdrInv],
+  [ACTIONS.delete]: [HANDLER.hdrApi, HANDLER.hdrSqs]
+};
+
+const DEFAULT_LAMBDA_ROLE_PER_ACTION = {
+  [ACTIONS.create]: {
+    dynamoDbPermission: 'PutItem',
+    httpMethod: 'put'
+  },
+  [ACTIONS.update]: {
+    dynamoDbPermission: 'UpdateItem',
+    httpMethod: 'post'
+  },
+  [ACTIONS.get]: {
+    dynamoDbPermission: 'GetItem',
+    httpMethod: 'post'
+  },
+  [ACTIONS.delete]: {
+    dynamoDbPermission: 'DeleteItem',
+    httpMethod: 'delete'
+  }
+};
+
+export { HANDLER, ACTIONS, STORAGE_TYPES, DEFAULT_HANDLER_PER_ACTION, DEFAULT_LAMBDA_ROLE_PER_ACTION };

package/src/libs/consts/index.js

@@ -0,0 +1,6 @@
+export * from './handlers.js';
+export * from './paths.js';
+export * from './functions.js';
+export * from './resources.js';
+export * from './topics.js';
+export * from './tags.js';

package/src/libs/consts/paths.js

@@ -0,0 +1,84 @@
+// relative with ./app/src
+const SOURCE_PATH = {
+  appYaml: `/sls_yaml/generatedCode/source/`,
+  resourceYaml: `../resource/sls_yaml/generatedCode/source/`,
+  externalService: '/initial_setup/generatedCode/source/',
+  lambdaPerAction: '/src/generatedCode/ObjectTypePerActionEndpoint/source/',
+  outPerActionComplete: '/src/generatedCode/OutPerActionComplete/source/',
+  resourceLocationOutPerActionComplete:
+    'src/generatedCode/OutPerActionComplete/source/',
+  relationshipPerAction: '/src/generatedCode/RelationshipPerAction/source/',
+  findData: '/src/generatedCode/FindData/source/',
+  translateIdsRequestFile: '/src/generatedCode/TranslateId/source/',
+  processLogical: '/src/generatedCode/ProcessLogical/source/',
+  resourceLocationPerAction:
+    'src/generatedCode/ObjectTypePerActionEndpoint/source/',
+  resourceLocationFindData: 'src/generatedCode/FindData/source/',
+  resourceLocationRelationshipPerAction:
+    'src/generatedCode/RelationshipPerAction/source/',
+  resourceLocationTranslateId: 'src/generatedCode/TranslateId/source/',
+  resourceLocationProcessLogical: 'src/generatedCode/ProcessLogical/source/',
+  // ** FlowSchema
+  webSocket: '/src/generatedCode/FlowSchema/UploadS3/',
+  resourceLocationWebSocket: 'src/generatedCode/FlowSchema/UploadS3/',
+  // * FlowSchema event
+  flowSchema: '/src/generatedCode/FlowSchema/',
+  resourceLocationFlowSchema: 'src/generatedCode/FlowSchema/',
+  // * FlowSchema eventBridge
+  flowSchemaEventBridge: '/src/generatedCode/FlowSchema/EventBridge/',
+  resourceLocationFlowSchemaEventBridge:
+    'src/generatedCode/FlowSchema/EventBridge/',
+  // * FlowSchema lambdaSync
+  flowSchemaLambdaSync: '/src/generatedCode/FlowSchema/lambdaSync/',
+  resourceLocationFlowSchemaLambdaSync:
+    'src/generatedCode/FlowSchema/lambdaSync/',
+  // * FlowSchema Register
+  flowSchemaRegister: '/src/generatedCode/FlowSchema/Register/',
+  resourceLocationFlowSchemaRegister: 'src/generatedCode/FlowSchema/Register/',
+  //* WebSocket Main
+  WebSocketMain: '/src/generatedCode/FlowSchema/WebSocketMain/source/',
+  resourceLocationWebSocketMain:
+    'src/generatedCode/FlowSchema/WebSocketMain/source/',
+  generateCodeLib: '/src/generatedCode/libs/source/',
+  generatedCodeHookFunction:
+    '/src/generatedCode/WebSocket/source/FlowSchemaHook/HookFunctionGeneratedCode/source/',
+  resourceLocationGeneratedCodeHookFunction:
+    'src/generatedCode/WebSocket/source/FlowSchemaHook/HookFunctionGeneratedCode/source/',
+  endpointPerService: '/src/generatedCode/ActionEndpoint/source/',
+  resourceLocationHandlerEndpointPerService:
+    'src/generatedCode/ActionEndpoint/source/',
+  createRecordComplete: '/src/generatedCode/CreateRecordComplete/',
+  resourceLocationCreateRecordComplete:
+    'src/generatedCode/CreateRecordComplete/',
+  // systemText
+  systemTextSchema: 'SystemTextSchemas/generatedCode/',
+  // rbac
+  rbac: '/src/generatedCode/Rbac/source/',
+  resourceLocationRbac: 'src/generatedCode/Rbac/source/'
+};
+
+const SAVE_FILE_NAME = {
+  dynamoDbYaml: 'generated-dynamoDB-table',
+  snsInSqsYaml: 'generated-sns-in-sqs',
+  snsOutYaml: 'generated-sns-out',
+  functionRelationshipYaml: 'relationship-per-action',
+  functionPerActionYaml: 'per-action-function',
+  processLogicalYaml: 'process-logical',
+  flowSchemaYaml: 'flow-schema',
+  roleNameConfigYaml: 'role-name-config',
+  sharedResourceYaml: 'generate-shared-resource',
+  authorizerYaml: 'authorizer',
+  findData: 'find-data',
+  rbac: 'rbac',
+  externalLambdaRole: 'generatedLambdaRoleServiceConfig',
+  snsSubscription: 'generatedSnsServiceConfig',
+  tableName: 'generatedTableNameConfig',
+  S3Bucket: 'generated-s3-bucket',
+  objectRelationship: 'ObjectRelationships',
+  refObjectRelationship: 'RefObjectRelationships',
+  objectSchema: 'ObjectFieldSchema',
+  roleNameConfig: 'RoleNameConfig',
+  systemTextSchema: 'SystemTextSchemas'
+};
+
+export { SOURCE_PATH, SAVE_FILE_NAME };

package/src/libs/consts/resources.js

@@ -0,0 +1,48 @@
+const RESOURCE_CLASSES = {
+  sqs: 'sqs',
+  s3: 's3',
+  dynamoDbTable: 'dynamodb',
+  dynamoDbAcrossService: 'dynamodb',
+  sns: 'sns',
+  lambda: 'lambda',
+  webSocket: 'webSocket'
+};
+
+const SQS_RESOURCE = {
+  sendMessage: 'SendMessage',
+  receiveMessage: 'ReceiveMessage',
+  deleteMessage: 'DeleteMessage',
+  getQueueAttributes: 'GetQueueAttributes',
+  deleteMessageBatch: 'DeleteMessageBatch',
+  getQueueUrl: 'GetQueueUrl'
+};
+
+const SNS_RESOURCE = {
+  publish: 'Publish',
+  subscribe: 'Subscribe'
+};
+
+const DYNAMO_RESOURCE = {
+  putItem: 'PutItem',
+  getItem: 'GetItem',
+  query: 'Query',
+  updateItem: 'UpdateItem',
+  deleteItem: 'DeleteItem'
+};
+
+const LAMBDA_RESOURCE = {
+  invokeFunction: 'InvokeFunction'
+};
+
+const S3_RESOURCE = {
+  getObject: 'GetObject',
+  getObjectTagging: 'GetObjectTagging',
+  deleteObject: 'DeleteObject',
+  deleteObjectTagging: 'DeleteObjectTagging',
+  putObject: 'PutObject',
+  putObjectTagging: 'PutObjectTagging',
+  getObjectVersion: 'GetObjectVersion',
+  listBucket: 'ListBucket'
+};
+
+export { RESOURCE_CLASSES, SQS_RESOURCE, SNS_RESOURCE, DYNAMO_RESOURCE, LAMBDA_RESOURCE, S3_RESOURCE };

package/src/libs/consts/tags.js

@@ -0,0 +1,68 @@
+const ADD_ON_DATA_STRUCTURE_TYPE = {
+  versionedData: 'versionedData',
+  attributeTree: 'attributeTree',
+  propertyValue: 'propertyValue',
+  translation: 'translation'
+};
+
+const ATTRIBUTE_TAG = {
+  attributeTagValue: 'Value',
+  attributeTagLabel: 'Label',
+  attributeTagLink: 'Link',
+  attributeTagValueStandard: 'ValueStandard',
+  attributeTagProperty: 'Property',
+  attributeTagPropertyLabel: 'PropertyLabel'
+};
+
+const PROPERTY_VALUE_TAG = {
+  property: 'PropertyValue',
+  propertyLabel: 'PropertyLabel'
+};
+
+const FIELD_NAME_TYPE = {
+  identifiers: 'identifiers',
+  nonIdentifiers: 'nonIdentifiers',
+  requiredOnCreateFieldName: 'requiredOnCreateFieldName',
+  randomOnCreateFieldName: 'randomOnCreateFieldName',
+  optionalOnCreate: 'optionalOnCreate'
+};
+
+const GENERATE_SEED_DATA_TYPE = {
+  RANDOM_ON_CREATE_IDENTIFIERS: 'randomOnCreateIdentifier',
+  NON_RANDOM_ON_CREATE_IDENTIFIERS: 'notRandomOnIdentifier',
+  RELATIONSHIPS: 'relationships'
+};
+
+const SEED_DATA_TAG = {
+  dynamoDBSeedDataTags: 'dynamoDBSeedDataTags',
+  graphSeedDataTags: 'graphSeedDataTags',
+  cleaningDynamoOneRecordsTags: 'cleaningDynamoOneRecordsTags',
+  cleaningDynamoManyRecordsTags: 'cleaningDynamoManyRecordsTags'
+};
+
+const ACCOUNTLIMIT_TAG = {
+  staticLimit: 'staticLimit',
+  reservedDynamic: 'reservedDynamic'
+};
+
+const LIMIT_TAG = {
+  uploadImage: 'uploadImageS3',
+  uploadData: 'uploadDataS3'
+};
+
+const RBAC_TYPE = {
+  appLevel: 'AppLevel',
+  userLevel: 'UserLevel'
+};
+
+export {
+  ADD_ON_DATA_STRUCTURE_TYPE,
+  ATTRIBUTE_TAG,
+  PROPERTY_VALUE_TAG,
+  FIELD_NAME_TYPE,
+  GENERATE_SEED_DATA_TYPE,
+  SEED_DATA_TAG,
+  ACCOUNTLIMIT_TAG,
+  LIMIT_TAG,
+  RBAC_TYPE
+};

package/src/libs/consts/topics.js

@@ -0,0 +1,67 @@
+const TOPIC_NAME_GRAPH_HANDLER = {
+  inUpdateRel: 'UpdateRelationship_In',
+  inCreateRel: 'CreateRelationship_In',
+  outUpdateRel: 'UpdateRelationship_Out',
+  outCreateRel: 'CreateRelationship_Out',
+  inDeleteRel: 'DeleteRelationship_In',
+  outDeleteRel: 'DeleteRelationship_Out',
+  inUpdateNode: 'UpdateNode_In',
+  outUpdateNode: 'UpdateNode_Out',
+  inCreateNode: 'CreateNode_In',
+  outCreateNode: 'CreateNode_Out',
+  inDeleteNode: 'DeleteNode_In',
+  outDeleteNode: 'DeleteNode_Out',
+  inChangeRelationship: 'ChangeRelationshipType_In',
+  outChangeRelationship: 'ChangeRelationshipType_Out',
+  inMoveRelationship: 'MoveRelationship_In',
+  outMoveRelationship: 'MoveRelationship_Out'
+};
+
+const TOPIC_NAME_GENERATE_CODE = {
+  updateRelComplete: 'UpdateRelationshipComplete',
+  createRelComplete: 'CreateRelationshipComplete',
+  deleteRelComplete: 'DeleteRelationshipComplete',
+  getRelComplete: 'GetRelationshipComplete',
+  outUpdateRelComplete: 'UpdateRelationshipComplete_Out',
+  outCreateRelComplete: 'CreateRelationshipComplete_Out',
+  outDeleteRelComplete: 'DeleteRelationshipComplete_Out',
+  outGetRelComplete: 'GetRelationshipComplete_Out',
+  updateNodeComplete: 'UpdateNodeComplete',
+  outUpdateNodeComplete: 'UpdateNodeComplete_Out',
+  createNodeComplete: 'CreateObjectComplete',
+  outCreateNodeComplete: 'CreateObjectComplete_Out',
+  deleteNodeComplete: 'DeleteNodeComplete',
+  outDeleteNodeComplete: 'DeleteNodeComplete_Out',
+  getNodeComplete: 'GetNodeComplete',
+  outGetNodeComplete: 'GetNodeComplete_Out',
+  reservedLimitComplete: 'ReservedLimitComplete',
+  createPresignUrl: 'CreatePresignUrl',
+  flowSchemaOwnTopicComplete: 'FlowSchemaOwnTopicComplete',
+  flowSchemaOwnTopicEndpointComplete: 'FlowSchemaOwnTopicEndpointComplete',
+  createRecordComplete: 'CreateRecordComplete',
+  changeRelationshipComplete: 'ChangeRelationshipComplete',
+  outChangeRelationshipComplete: 'ChangeRelationshipComplete_Out',
+  moveRelationshipComplete: 'MoveRelationshipComplete',
+  outMoveRelationshipComplete: 'MoveRelationshipComplete_Out'
+};
+
+const GRAPH_HANDLER_SERVICE_NAME = {
+  graphHandler: 'GraphHandler'
+};
+
+const TOPIC_NAME_EXTERNAL_SERVICE = {
+  staticLimitProcessComplete: 'StaticLimitProcessComplete_Out',
+  reservedDynamicUsageComplete: 'ReservedDynamicUsageComplete_Out'
+};
+
+const EXTERNAL_SERVICE_NAME = {
+  accountLimits: 'AccountLimits'
+};
+
+export {
+  TOPIC_NAME_GRAPH_HANDLER,
+  TOPIC_NAME_GENERATE_CODE,
+  GRAPH_HANDLER_SERVICE_NAME,
+  TOPIC_NAME_EXTERNAL_SERVICE,
+  EXTERNAL_SERVICE_NAME
+};

package/src/pipeline/fetchSchemas.js

@@ -0,0 +1,31 @@
+import { getObjectSchema } from '@izara_project/izara-core-library-service-schemas';
+import path from 'path';
+
+/**
+ * Phase 1: Load all schema types from local filesystem in parallel.
+ * @param {Object} _izContext
+ * @param {string} rootServicePath
+ * @returns {Promise<{flowSchemas, objSchemas, relSchemas, notifSchemas}>}
+ */
+async function fetchSchemas(_izContext, rootServicePath) {
+  const schemasPath = path.join(rootServicePath, '/app/src/schemas');
+
+  console.info('[INFO] [generateCode] STATUS=FETCHING  | schemas...');
+  const fetchStartTime = Date.now();
+
+  const [flowSchemas, objSchemas, relSchemas, notifSchemas] = await Promise.all([
+    getObjectSchema.getAllLocalFlowSchemas(_izContext, schemasPath),
+    getObjectSchema.getAllLocalObjectSchemasWithHierarchy(_izContext, schemasPath),
+    getObjectSchema.getAllLocalRelationshipSchema(_izContext, schemasPath),
+    getObjectSchema.getLocalNotificationSystemSchemas(_izContext, schemasPath)
+  ]);
+
+  const fetchStr = `flow=${flowSchemas.records?.length ?? 0} obj=${objSchemas.records?.length ?? 0} rel=${relSchemas.length ?? 0}`;
+  console.info(
+    `[INFO] [generateCode] STATUS=FETCHED   | ${fetchStr.padEnd(40)} | elapsedMs=${Date.now() - fetchStartTime}`
+  );
+
+  return { flowSchemas, objSchemas, relSchemas, notifSchemas };
+}
+
+export { fetchSchemas };

package/src/pipeline/transformSchemas.js

@@ -0,0 +1,75 @@
+import path from 'path';
+import generateTemplateDataFromFlowSchema from '../generators/fromFlowSchema/index.js';
+import generateTemplateDataFromSchema from '../generators/fromObjectSchema/index.js';
+import generateTemplateDataInitialSetup from '../generators/fromExternalService/index.js';
+import generateTemplateDataOther from '../generators/other/index.js';
+import generatePlugIn from '../generators/fromPlugIn/index.js';
+import generateTemplateDataRole from '../generators/roles/index.js';
+
+/**
+ * Phase 2: Run all generators against loaded schemas and return the flat source list.
+ * @param {Object} _izContext
+ * @param {string} rootServicePath
+ * @param {{flowSchemas, objSchemas, relSchemas, notifSchemas}} schemas
+ * @param {Object} settings
+ * @returns {Promise<Array>} allCreateSource items
+ */
+async function transformSchemas(_izContext, rootServicePath, schemas, settings = {}) {
+  const { flowSchemas, objSchemas, relSchemas, notifSchemas } = schemas;
+  const appPath = path.join(rootServicePath, '/app');
+
+  console.info('[INFO] [generateCode] STATUS=GENERATING| template data...');
+  _izContext.logger.info('[generateCode] generating template data...');
+  const genStartTime = Date.now();
+
+  const [
+    flowSchemaResult,
+    schemaResult,
+    initialSetupResult,
+    otherResult,
+    generatePlugInResult
+  ] = await Promise.all([
+    generateTemplateDataFromFlowSchema(_izContext, appPath, flowSchemas.records, settings),
+    generateTemplateDataFromSchema(
+      _izContext,
+      appPath,
+      objSchemas,
+      relSchemas,
+      flowSchemas.records,
+      notifSchemas,
+      settings
+    ).catch(error => {
+      console.error('[generateCode] schemaResult error:', error);
+      _izContext.logger.error('[generateCode] schemaResult error:', error);
+      return [];
+    }),
+    generateTemplateDataInitialSetup(_izContext, appPath, objSchemas.records, relSchemas, flowSchemas.records, settings),
+    generateTemplateDataOther(_izContext, appPath),
+    generatePlugIn(_izContext, rootServicePath, appPath, objSchemas.records, flowSchemas.records)
+  ]);
+
+  const genStr = `flow=${flowSchemaResult.length} sch=${schemaResult.length} setup=${initialSetupResult.length} other=${otherResult.length}`;
+  console.info(
+    `[INFO] [generateCode] STATUS=GENERATED | ${genStr.padEnd(40)} | elapsedMs=${Date.now() - genStartTime}`
+  );
+
+  const allCreateSource = [
+    ...flowSchemaResult,
+    ...schemaResult,
+    ...initialSetupResult,
+    ...otherResult,
+    ...generatePlugInResult
+  ];
+
+  // Append role configs derived from the collected sources
+  console.info('[INFO] [generateCode] STATUS=GENERATING| role configs...');
+  const createSourceRole = generateTemplateDataRole(_izContext, appPath, allCreateSource);
+  allCreateSource.push(...createSourceRole);
+
+  const roleStr = `items=${allCreateSource.length} roles=${createSourceRole.length}`;
+  console.info(`[INFO] [generateCode] STATUS=ROLES_GEN | ${roleStr.padEnd(40)} |`);
+
+  return allCreateSource;
+}
+
+export { transformSchemas };

package/src/pipeline/validateSources.js

@@ -0,0 +1,47 @@
+import { readFileSync } from 'fs';
+import validatePathWithRootServicePath from '#libs/GenerateCodeLibs.js';
+import utils from '#libs/Utils.js';
+import createSource from '../sourceManager/CreateSource.js';
+
+const { deleteFileInDir } = utils;
+
+/**
+ * Phase 3: Validate every source item against its template and clear output dirs.
+ * Throws on first invalid item so nothing is written from a broken state.
+ * @param {Object} _izContext
+ * @param {string} rootServicePath
+ * @param {Array} allCreateSource
+ */
+async function validateSources(_izContext, rootServicePath, allCreateSource) {
+  const validateStartTime = Date.now();
+  console.info('[INFO] [generateCode] STATUS=VALIDATING| source items...');
+
+  for (const item of allCreateSource) {
+    if (!item?.templatePath || !item?.templateData || !item?.setting) {
+      console.debug('###### error item:', item);
+      throw new Error(`[generateCode] invalid source item: ${JSON.stringify(item)}`);
+    }
+    const { templatePath, templateData, setting } = item;
+    setting.checkCreateSourcePass = true;
+
+    const [status, errors] = await createSource(
+      readFileSync(templatePath, 'utf8'),
+      templateData,
+      setting
+    );
+    if (!status) {
+      console.error('[generateCode] validation failed:', errors);
+      console.debug('###### item:', item);
+      throw new Error(errors);
+    }
+
+    validatePathWithRootServicePath(rootServicePath, setting.savePath);
+    await deleteFileInDir(setting.savePath);
+  }
+
+  console.info(
+    `[INFO] [generateCode] STATUS=VALIDATED | ${'items=' + allCreateSource.length} | elapsedMs=${Date.now() - validateStartTime}`
+  );
+}
+
+export { validateSources };

package/src/pipeline/writeSources.js

@@ -0,0 +1,24 @@
+import { readFileSync } from 'fs';
+import createSource from '../sourceManager/CreateSource.js';
+
+/**
+ * Phase 4: Write all generated files in parallel.
+ * @param {Array} allCreateSource
+ */
+async function writeSources(allCreateSource) {
+  console.info('[INFO] [generateCode] STATUS=WRITING   | source files...');
+  const writeStartTime = Date.now();
+
+  await Promise.all(
+    allCreateSource.map(({ templatePath, templateData, setting }) => {
+      setting.checkCreateSourcePass = false;
+      return createSource(readFileSync(templatePath, 'utf8'), templateData, setting);
+    })
+  );
+
+  console.info(
+    `[INFO] [generateCode] STATUS=WRITTEN   | ${'files=' + allCreateSource.length} | elapsedMs=${Date.now() - writeStartTime}`
+  );
+}
+
+export { writeSources };