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

package/src/generateCode/generateSchema/actionEndpointComponent/mainFunction/create/main/template.ejs

@@ -1,679 +0,0 @@
-/*
-Copyright (C) 2021 Sven Mason <http://izara.io>
-
-This program is free software: you can redistribute it and/or modify
-it under the terms of the GNU Affero General Public License as
-published by the Free Software Foundation, either version 3 of the
-License, or (at your option) any later version.
-
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU Affero General Public License for more details.
-
-You should have received a copy of the GNU Affero General Public License
-along with this program.  If not, see <http://www.gnu.org/licenses/>.
-*/
-
-import { objectHash as hash } from '@izara_project/izara-shared-core';
-import dynamodbSharedLib from '@izara_project/izara-core-library-dynamodb';
-import snsSharedLib from '@izara_project/izara-core-library-sns';
-import asyncFlowSharedLib from '@izara_project/izara-core-library-asynchronous-flow';
-import callingFlowSharedLib from '@izara_project/izara-core-library-calling-flow';
-import lambdaSharedLib from '@izara_project/izara-core-library-lambda';
-import { consts as coreConsts, NoRetryError } from '@izara_project/izara-core-library-core';
-import { consts as middlewareConsts } from '@izara_project/izara-middleware';
-import { sns, lambda } from '@izara_project/izara-core-library-external-request';
-import {
-  utils, createNodeLib, uploadUseCase, consts, getObjectSchema,
-  identifiersObject, dataDetailsLib
-} from '@izara_project/izara-core-library-service-schemas';
-import graphSharedLibs from '@izara_project/izara-core-library-graph-service';
-
-//(<optionalRequire>)
-//(</optionalRequire>)
-
-const { createObjType, firstLetterUpperCase } = utils;
-const { createDataDetailsLib } = dataDetailsLib;
-const { dynamoDbIdentifiersByStorageResource, createIdentifiersByUseCase } = identifiersObject;
-const { TOPIC_NAME_GENERATE_CODE, TOPIC_NAME_GRAPH_HANDLER } = consts;
-
-const PREFIX = {
-  ONE: 'one',
-  MANY: 'many',
-  CREATE_OBJECT_ASYNC: 'createObjectAsync',
-  CREATE_OBJECT_ASYNC_COMPLETE: 'createObjectAsyncComplete',
-  CREATE_OBJECT_EXTERNAL_TOPIC: 'createObjectExternalTopic'
-};
-
-/**
- * Core logical processing after beforeLogical phase completes
- * Called by both createMain (no beforeLogical) and createBeforeLogicalMain (after callback)
- * @param {Object} _izContext - Context object with logger
- * @param {Object} requestParams - { fieldNames, relationships[] }
- * @param {Object} callingFlowConfig - Calling flow configuration
- * @param {Object} beforeLogicalResults - Results from beforeLogical
- * @returns {Promise<Object>} Result with objType, objInstanceFull, relationships, status, errorsFound
- */
-export async function createMainLogical(
-  _izContext,
-  requestParams,
-  callingFlowConfig = {},
-  errorsFound = [],
-  beforeLogicalResults = {}
-) {
-  try {
-    _izContext.logger.debug('createMainLogical:', {
-      requestParams,
-      callingFlowConfig,
-      beforeLogicalResults
-    });
-
-    //(<beforeCreateMainLogical>)
-    //(</beforeCreateMainLogical>)
-
-    const objType = createObjType(requestParams.objectType);
-
-    // ── Load schema ───────────────────────────────────────────────────────────
-    const objectSchema = await getObjectSchema.getObjSchemaS3WithHierarchy(_izContext, objType);
-    _izContext.logger.debug('objectSchema', objectSchema);
-
-    const objectSchemas = uploadUseCase.generateObjectSchemaForCombineFieldNames(_izContext, objectSchema);
-    _izContext.logger.debug('objectSchemas', objectSchemas);
-
-    // ── Parent object ─────────────────────────────────────────────────────────
-    let parentObject;
-    if (objectSchemas.hasOwnProperty('extendObjType')) {
-      parentObject = await getObjectSchema.getObjSchemaS3WithHierarchy(_izContext, objectSchema.extendObjType);
-    }
-
-    // ── Detect invocation type ────────────────────────────────────────────────
-    const directInvoke = requestParams.hasOwnProperty('__context__') &&
-      requestParams.izEventSource?.eventSourceTag === 'DirectInvoke';
-
-    // ── Build createDataDetails ───────────────────────────────────────────────
-    const createDataDetails = await createDataDetailsLib(_izContext, objectSchemas);
-    _izContext.logger.debug('createDataDetails:', createDataDetails);
-
-    // ── Build objInstanceFull identifiers ─────────────────────────────────────
-    const objInstanceFull = { identifiers: {}, fields: {} };
-
-    for (const fieldName of Object.keys(requestParams.fieldNames)) {
-      if (objectSchemas.identifierFieldNames.includes(fieldName)) {
-        Object.assign(objInstanceFull.identifiers, { [fieldName]: requestParams.fieldNames[fieldName] });
-      }
-    }
-
-    // ── Helper: extract fields per storageTag ─────────────────────────────────
-    function createObjInstanceFullFieldsByStorageTag(_izContext, storageTag, createDataDetail) {
-      const fields = {};
-      for (const fieldName of Object.keys(requestParams.fieldNames)) {
-        if (
-          createDataDetails[storageTag].fieldNames.includes(fieldName) &&
-          createDataDetail.fieldNames.includes(fieldName) &&
-          !objInstanceFull.identifiers.hasOwnProperty(fieldName) &&
-          !fields.hasOwnProperty(fieldName)
-        ) {
-          Object.assign(fields, { [fieldName]: requestParams.fieldNames[fieldName] });
-        }
-      }
-      return fields;
-    }
-
-    // ── Process storage resources ─────────────────────────────────────────────
-    const objInstanceFullForDynamoDb = structuredClone(objInstanceFull);
-    const objInstanceFullForGraph = structuredClone(objInstanceFull);
-    const objInstanceFullForExternalTopic = structuredClone(objInstanceFull);
-    const allAwaitingStepsId = [];
-    const listOfObjectForCreates = [];
-    const listOfRecords = [];
-
-    if (errorsFound.length === 0) {
-      //(<validateBeforeCreate>)
-      //(</validateBeforeCreate>)
-
-      for (const [storageTag, createDataDetail] of Object.entries(createDataDetails)) {
-        //(<beforeCreate>)
-        //(</beforeCreate>)
-
-        // ── DynamoDB ──────────────────────────────────────────────────────────
-        if (createDataDetail.storageType === consts.STORAGE_TYPES.dynamoDB) {
-          _izContext.logger.debug('::::::DynamoDB::::::', { storageTag, objInstanceFull });
-
-          if (parentObject && createDataDetail.tableName.includes(firstLetterUpperCase(`${parentObject.objectType}Records`))) {
-            Object.assign(objInstanceFullForDynamoDb.fields, { [`${parentObject.objectType}HandlerServiceTag`]: process.env.iz_serviceTag });
-          }
-
-          Object.assign(objInstanceFullForDynamoDb.fields,
-          createObjInstanceFullFieldsByStorageTag(_izContext, storageTag, createDataDetail));
-
-          _izContext.logger.debug('objInstanceFull before create item in dynamoDB', objInstanceFullForDynamoDb);
-
-          const identifiersForCreateData = await dynamoDbIdentifiersByStorageResource(
-            _izContext,
-            objectSchema,
-            createDataDetails,
-            objInstanceFullForDynamoDb.identifiers
-          );
-          _izContext.logger.debug('identifiersForCreateData', identifiersForCreateData);
-
-          //(<beforeCreateRecordDynamo>)
-          //(</beforeCreateRecordDynamo>)
-
-          if (Object.values(createDataDetails).some(
-            createDataDetail => createDataDetail.storageType === consts.STORAGE_TYPES.graph)) {
-            _izContext.logger.debug('must process graph first');
-            listOfRecords.push({
-              [createDataDetail.tableName]: {
-                serviceTag: createDataDetail.serviceTag,
-                objInstanceFull: {
-                  identifiers: identifiersForCreateData,
-                  fields: objInstanceFullForDynamoDb.fields
-                }
-              }
-            })
-          } else {
-            _izContext.logger.debug('can process record dynamo')
-            await dynamodbSharedLib.putItem(
-              _izContext,
-              dynamodbSharedLib.tableName(_izContext,
-                createDataDetail.tableName,
-                createDataDetail.serviceTag
-              ),
-              {
-                ...identifiersForCreateData,
-                ...objInstanceFullForDynamoDb.fields
-              }
-            );
-
-            objInstanceFullForDynamoDb.fields = {}
-          }
-
-          //(<afterCreateRecordDynamo>)
-          //(</afterCreateRecordDynamo>)
-
-          // ── Graph ─────────────────────────────────────────────────────────────
-        } else if (createDataDetail.storageType === consts.STORAGE_TYPES.graph) {
-          //(<beforeCreateNode>)
-          //(</beforeCreateNode>)
-          _izContext.logger.debug('::::::Graph::::::', { storageTag, objInstanceFull });
-
-          Object.assign(objInstanceFullForGraph.fields,
-           createObjInstanceFullFieldsByStorageTag(_izContext, storageTag, createDataDetail));
-          _izContext.logger.debug('objInstanceFull before send to Graph', objInstanceFullForGraph);
-
-          allAwaitingStepsId.push({
-            awaitingStepId: await asyncFlowSharedLib.createAwaitingStepId(
-              hash({ objType,
-                graphServerTag: storageTag,
-                identifiers: objInstanceFullForGraph.identifiers,
-                callingFlowProperties: callingFlowConfig.callingFlowProperties || {}
-              }),
-              PREFIX.CREATE_OBJECT_ASYNC
-            ),
-            //(<additionalAttributeCreateNode>)
-            additionalAttributes: { listOfRecords: listOfRecords }
-            //(</additionalAttributeCreateNode>)
-          });
-
-          listOfObjectForCreates.push({
-            [storageTag]: {
-              objInstanceFull: {
-                identifiers: objInstanceFullForGraph.identifiers,
-                fields: objInstanceFullForGraph.fields
-              },
-              allStorageTagComplete: false
-            }
-          });
-
-          // ── External Topic ────────────────────────────────────────────────────
-        } else if (createDataDetail.storageType === consts.STORAGE_TYPES.externalTopic) {
-          _izContext.logger.debug('::::::externalTopic::::::', { storageTag, createDataDetail });
-          //(<beforeSendMessageToExternalTopic>)
-          //(</beforeSendMessageToExternalTopic>)
-
-          Object.assign(objInstanceFullForExternalTopic.fields, createObjInstanceFullFieldsByStorageTag(_izContext, storageTag, createDataDetail));
-          _izContext.logger.debug('objInstanceFull before send to external topic', objInstanceFullForExternalTopic);
-
-          allAwaitingStepsId.push({
-            awaitingStepId: await asyncFlowSharedLib.createAwaitingStepId(
-              hash({ objType, graphServerTag: storageTag, identifiers: objInstanceFullForGraph.identifiers, callingFlowProperties: callingFlowConfig.callingFlowProperties || {} }),
-              PREFIX.CREATE_OBJECT_EXTERNAL_TOPIC
-            ),
-            //(<additionalAttributeCreateExternalTopic>)
-            additionalAttributes: {}
-            //(</additionalAttributeCreateExternalTopic>)
-          });
-
-          await sns.publishAsync(_izContext, {
-            Message: JSON.stringify(objInstanceFullForExternalTopic),
-            TopicArn: `arn:aws:sns:${createDataDetail.region}:${createDataDetail.accountId}:${createDataDetail.serviceTag}_${createDataDetail.stage}_Create_In`
-          });
-        }
-      }
-    }
-
-    // ── Create awaiting multiple steps ────────────────────────────────────────
-    _izContext.logger.debug('not api will create awaitingStep');
-    await asyncFlowSharedLib.createAwaitingMultipleStepsWithAdditionalAttributes(
-      _izContext,
-      allAwaitingStepsId,
-      asyncFlowSharedLib.createPendingStepId(
-        hash({ objType, identifiers: objInstanceFull.identifiers }),
-        PREFIX.CREATE_OBJECT_ASYNC_COMPLETE
-      )
-    );
-
-    // ── Process graph objects ─────────────────────────────────────────────────
-    let messageObject = {};
-    for (const objectCreate of listOfObjectForCreates) {
-      for (const [graphServiceName, objectForCreate] of Object.entries(objectCreate)) {
-        _izContext.logger.debug('Loop each graph:', { [graphServiceName]: objectForCreate });
-
-        if (!objectForCreate.allStorageTagComplete) {
-          //(<beforeSendMessageToGraph>)
-          //(</beforeSendMessageToGraph>)
-          messageObject = {
-            objType,
-            objInstanceFull: objectForCreate.objInstanceFull,
-            deepPathConditional: requestParams.deepPathConditional || [],
-            setFieldConditionals: requestParams.setFieldConditionals || [],
-            relationships: requestParams.relationships || []
-          };
-        }
-
-        if (errorsFound.length > 0) break;
-
-        Object.assign(messageObject, { settings: { updatePropertiesOnMatch: false }, originTimestamp: Date.now() });
-
-        if (directInvoke) {
-          _izContext.logger.debug('DirectInvoke case will invoke GraphHandlerInv');
-          return await graphSharedLibs.createNodeV2(
-            _izContext, graphServiceName, objType, objInstanceFullForGraph,
-            requestParams.relationships || [], Date.now(), { updatePropertiesOnMatch: false }
-          );
-        }
-
-        messageObject = callingFlowSharedLib.addCallingFlowToSnsRequestMessageObject(
-          messageObject,
-          callingFlowSharedLib.addParentCallingFlowConfig(
-            callingFlowConfig,
-            callingFlowSharedLib.createCallingFlowConfig(
-              //(<callingFlowProperties>)
-              await lambdaSharedLib.lambdaFunctionName(_izContext, TOPIC_NAME_GENERATE_CODE.createNodeComplete),
-              {}
-              //(</callingFlowProperties>)
-            )
-          )
-        );
-
-        await sns.publishAsync(_izContext, {
-          Message: JSON.stringify(messageObject),
-          TopicArn: await snsSharedLib.snsTopicArnByFlowSchema(_izContext, TOPIC_NAME_GRAPH_HANDLER.inCreateNode, graphServiceName)
-        });
-
-        //(<afterSendMessageToGraph>)
-        //(</afterSendMessageToGraph>)
-        return {
-          objType,
-          objInstanceFull: objInstanceFullForGraph,
-          relationships: requestParams.relationships || [],
-          status: 'complete',
-          errorsFound
-        };
-      }
-      if (errorsFound.length > 0) break;
-    }
-
-    // ── Handle errors ─────────────────────────────────────────────────────────
-    if (errorsFound.length > 0) {
-      _izContext.logger.debug('Case have errorsFound:::', errorsFound);
-
-      await asyncFlowSharedLib.clearAllAwaitingSteps(
-        _izContext,
-        asyncFlowSharedLib.createPendingStepId(
-          hash({ objType, identifiers: objInstanceFull.identifiers }),
-          PREFIX.CREATE_OBJECT_ASYNC_COMPLETE
-        )
-      );
-
-      messageObject = callingFlowSharedLib.addPassBackPropertiesToSnsResponseMessageObject(
-        callingFlowConfig,
-        { objType, identifiers: null, errorsFound }
-      );
-
-      await sns.publishAsync(_izContext, {
-        Message: JSON.stringify(messageObject),
-        MessageAttributes: sns.createStringMessageAttributes(
-          _izContext,
-          callingFlowSharedLib.addCallingFlowToSnsResponseMessageAttributes(callingFlowConfig, {})
-        ),
-        TopicArn: await snsSharedLib.snsTopicArnByFlowSchema(_izContext, TOPIC_NAME_GENERATE_CODE.outCreateNodeComplete)
-      });
-
-      return { objType, objInstanceFull, relationships: requestParams.relationships || [], status: 'error', errorsFound };
-    }
-
-    // ── DynamoDB-only complete path ───────────────────────────────────────────
-    if (allAwaitingStepsId.length === 0 && listOfObjectForCreates.length === 0) {
-      const outMessage =
-        callingFlowSharedLib.addPassBackPropertiesToSnsResponseMessageObject(
-          callingFlowConfig,
-          {
-            objType: objType,
-            objInstanceFull: {
-              identifiers: objInstanceFullForDynamoDb.identifiers,
-              fields: objInstanceFullForDynamoDb.fields
-            }
-          }
-        );
-
-      if (callingFlowConfig[callingFlowSharedLib.consts.CALLINGFLOW_PROPERTYNAME]) {
-        _izContext.logger.debug('HAVE CallingFlow');
-        await sns.publishAsync(_izContext, {
-          Message: JSON.stringify(outMessage),
-          MessageAttributes: sns.createStringMessageAttributes(
-            _izContext,
-            callingFlowSharedLib.addCallingFlowToSnsResponseMessageAttributes(callingFlowConfig, {})
-          ),
-          TopicArn: await snsSharedLib.snsTopicArnByFlowSchema(_izContext, TOPIC_NAME_GENERATE_CODE.outCreateNodeComplete)
-        });
-      }
-    }
-
-    return {
-      objType,
-      objInstanceFull: {
-        identifiers: objInstanceFullForDynamoDb.identifiers,
-        fields: objInstanceFullForDynamoDb.fields
-      },
-      relationships: requestParams.relationships || [],
-      status: 'complete',
-      errorsFound
-    };
-
-  } catch (err) {
-    throw err;
-  }
-}
-
-/**
- * Creates an object instance — handles beforeLogical phase routing or proceeds directly to logical
- * @param {Object} _izContext - Context object with logger
- * @param {Object} requestParams - { fieldNames, relationships[] }
- * @param {Object} callingFlowConfig - Calling flow configuration
- * @returns {Promise<Object>}
- */
-export default async function createMain(
-  _izContext,
-  requestParams,
-  callingFlowConfig = {}
-  //(<additionalParams>)
-  //(</additionalParams>)
-) {
-  try {
-    _izContext.logger.debug('createMain:', { requestParams, callingFlowConfig });
-
-    const errorsFound = [];
-    const objType = createObjType(requestParams.objectType);
-
-    // ── Load schema ───────────────────────────────────────────────────────────
-    const objectSchema = await getObjectSchema.getObjSchemaS3WithHierarchy(_izContext, objType);
-    _izContext.logger.debug('objectSchema', objectSchema);
-
-    // ── Resolve userId / targetId ─────────────────────────────────────────────
-    let userId, targetId;
-    if (objectSchema.generatedBy === 'userGenerated') {
-      userId = _izContext.correlationIds.get(coreConsts.BASE_USER_ID);
-      targetId = _izContext.correlationIds.get(coreConsts.TARGET_ID);
-      if (!userId) errorsFound.push('Not have userId');
-      if (objectSchema.hasOwnProperty('belongTo') && !targetId) errorsFound.push('not have targetId');
-    } else if (objectSchema.generatedBy === 'searchResultGenerated') {
-      throw new NoRetryError('error searchResultGenerated should not happen here');
-    }
-
-    //(<beforeQuery>)
-    //(</beforeQuery>)
-
-    // ── Build objectSchemas ───────────────────────────────────────────────────
-    const objectSchemas = uploadUseCase.generateObjectSchemaForCombineFieldNames(_izContext, objectSchema);
-    _izContext.logger.debug('objectSchemas', objectSchemas);
-
-    // ── Build createDataDetails ───────────────────────────────────────────────
-    const createDataDetails = await createDataDetailsLib(_izContext, objectSchemas);
-    _izContext.logger.debug('createDataDetails:', createDataDetails);
-
-    if (requestParams.relationships?.length > 0) {
-      //(<beforeValidateRelationships>)
-      //(</beforeValidateRelationships>)
-    }
-
-    errorsFound.push(
-      ...(await createNodeLib.validateRequiredOnCreateLinks(_izContext, objType, requestParams.relationships))
-    );
-    _izContext.logger.debug('errorsFound', errorsFound);
-
-    // ── Build field lists ─────────────────────────────────────────────────────
-    const listOfRequiredOnCreate = [];
-    const listOfOptionalOnCreate = [];
-
-    for (const [key, val] of Object.entries(objectSchemas.fieldNames)) {
-      if (val.randomOnCreate === true || val.requiredOnCreate === true || val.hashOnCreate?.length) {
-        listOfRequiredOnCreate.push(key);
-      }
-      if (val.requiredOnCreate === false && val.optionalOnCreate === true) {
-        listOfOptionalOnCreate.push(key);
-      }
-    }
-
-    _izContext.logger.debug('listOfRequiredOnCreate', listOfRequiredOnCreate);
-    _izContext.logger.debug('listOfOptionalOnCreate', listOfOptionalOnCreate);
-
-    // ── Resolve identifiers ───────────────────────────────────────────────────
-    let errors;
-    const identifiers = objectSchemas.identifiers;
-
-    //(<createOptionalOnCreateIdentifiers>)
-    let optionalOnCreateIdentifiers;
-    //(</createOptionalOnCreateIdentifiers>)
-
-    if (identifiers.length === 1 && !identifiers[0].hasOwnProperty('fieldNames')) {
-      [requestParams, errors] = await createIdentifiersByUseCase(_izContext, requestParams, objectSchemas, identifiers[0], optionalOnCreateIdentifiers);
-    } else if (identifiers.length > 1) {
-      for (const identifier of identifiers) {
-        [requestParams, errors] = await createIdentifiersByUseCase(_izContext, requestParams, objectSchemas, identifier, optionalOnCreateIdentifiers);
-      }
-    }
-
-    _izContext.logger.debug('requestParams:', requestParams);
-    errorsFound.push(...errors);
-    _izContext.logger.debug('errorsFound::', errorsFound);
-
-    if (errorsFound.length > 0)
-      return await createMainLogical(
-        _izContext,
-        requestParams,
-        callingFlowConfig,
-        errorsFound
-      );
-
-    // ── Validate fieldNames ───────────────────────────────────────────────────
-    const objInstanceFull = { identifiers: {}, fields: {} };
-
-    //(<optionalObjInstanceFull>)
-    //(</optionalObjInstanceFull>)
-
-    for (const fieldName of Object.keys(requestParams.fieldNames)) {
-      if (!listOfRequiredOnCreate.includes(fieldName) && !listOfOptionalOnCreate.includes(fieldName)) {
-        errorsFound.push('[invalid] over fieldNames create object');
-      }
-      if (listOfOptionalOnCreate.length > 0 && listOfRequiredOnCreate.includes(fieldName)) {
-        //(<optionalParams>)
-        //(</optionalParams>)
-      }
-      if (objectSchemas.identifierFieldNames.includes(fieldName)) {
-        _izContext.logger.debug('identifiers is', fieldName);
-        Object.assign(objInstanceFull.identifiers, { [fieldName]: requestParams.fieldNames[fieldName] });
-      }
-      if (errorsFound.length > 0) {
-        _izContext.logger.debug('HaveError::', errorsFound);
-        break;
-      }
-    }
-
-    // ── beforeLogical phase check ─────────────────────────────────────────────
-    <%_
-    const groupedByObjType = generatedCodeConfig
-      .filter(c => c.codeHookTag === 'beforeLogical')
-      .reduce((acc, config) => {
-        const key = config.objType.objectType;
-        if (!acc[key]) acc[key] = [];
-        acc[key].push(config);
-        return acc;
-      }, {});
-    _%>
-    <%_ Object.entries(groupedByObjType).forEach(([objectType, configs]) => { _%>
-      <%_
-      const hasOwnTopic      = configs.some(c => c.invocationType === 'ownTopic');
-      const hasLambdaSyncInv = configs.some(c => c.invocationType === 'lambdaSyncInv');
-      _%>
-      if (requestParams.objectType === '<%= objectType %>') {
-
-        <%_ if (hasLambdaSyncInv) { _%>
-        const lambdaSyncInvResults = await Promise.all([
-          <%_ configs.filter(c => c.invocationType === 'lambdaSyncInv').forEach((config, index, arr) => { _%>
-          // lambdaSyncInv <%= config.flowTag %>
-          lambda.invokeSync(
-            _izContext,
-            await lambdaSharedLib.lambdaFunctionName(
-              _izContext,
-              'Process<%= config.flowTag %>HdrInv'
-            ),
-            { requestParams, callingFlowConfig }
-          ).then(returnValue => ({ flowTag: '<%= config.flowTag %>', returnValue }))<%= index < arr.length - 1 ? ',' : '' %>
-          // lambdaSyncInv <%= config.flowTag %>
-          <%_ }) _%>
-        ]);
-
-        <%_ } _%>
-
-        //(<afterBeforeLogical_<%= objectType %>>)
-        //(</afterBeforeLogical_<%= objectType %>>)
-
-      <%_ if (hasOwnTopic) { _%>
-      // ── ownTopic (async — create awaitingSteps and then publish) ──────────────
-      const awaitingMultipleStepIds = [];
-      const recordMsgs = [];
-
-      <%_ configs.filter(c => c.invocationType === 'ownTopic').forEach(config => { _%>
-      // ownTopic <%= config.flowTag %>
-      awaitingMultipleStepIds.push({
-        awaitingStepId: await asyncFlowSharedLib.createAwaitingStepId(
-          hash(objInstanceFull.identifiers),
-          '<%= config.codeHookTag %>_<%= objectType %>_<%= config.flowTag.charAt(0).toUpperCase() + config.flowTag.slice(1) %>'
-        ),
-        additionalAttributes: {}
-      });
-
-      recordMsgs.push({
-        msg: callingFlowSharedLib.addCallingFlowToSnsRequestMessageObject(
-          requestParams,
-          callingFlowSharedLib.addParentCallingFlowConfig(
-            callingFlowConfig,
-            callingFlowSharedLib.createCallingFlowConfig(
-              //(<callingFlowProperties_<%= config.flowTag %>>)
-              await lambdaSharedLib.lambdaFunctionName(
-                _izContext,
-                '<%= config.generatedCodeTag %><%= config.codeHookTag.charAt(0).toUpperCase() + config.codeHookTag.slice(1) %>'
-              ),
-              {}
-              //(</callingFlowProperties_<%= config.flowTag %>>)
-            )
-          )
-        ),
-        flowTag: '<%= config.flowTag.charAt(0).toUpperCase() + config.flowTag.slice(1) %>'
-      });
-      <%_ }) _%>
-
-      <%_ if (hasLambdaSyncInv) { _%>
-      // ── Add lambdaSyncInv results to awaitingSteps ────────────────────────
-      for (const syncResult of lambdaSyncInvResults) {
-        awaitingMultipleStepIds.push({
-          awaitingStepId: await asyncFlowSharedLib.createAwaitingStepId(
-            hash(objInstanceFull.identifiers),
-            '<%= configs[0].codeHookTag %>_<%= objectType %>_' + syncResult.flowTag
-          ),
-          additionalAttributes: {
-            complete:    true,
-            errorsFound: [],
-            returnValue: syncResult.returnValue
-          }
-        });
-      }
-      <%_ } _%>
-
-      await asyncFlowSharedLib.initAwaitingStepsWithAttrs(
-        _izContext,
-        awaitingMultipleStepIds,
-        asyncFlowSharedLib.createPendingStepId(
-          hash(objInstanceFull.identifiers),
-          'beforeLogical_<%= objectType %>'
-        )
-      );
-
-      //(<beforePublish_<%= objectType %>>)
-      //(</beforePublish_<%= objectType %>>)
-
-      for (const recordMsg of recordMsgs) {
-        const messageAttributes = sns.createStringMessageAttributes(
-          _izContext,
-          callingFlowSharedLib.addCallingFlowToSnsResponseMessageAttributes(
-            callingFlowConfig,
-            {}
-          )
-        );
-
-        const topicArn = snsSharedLib.snsTopicArnByFlowSchema(
-          _izContext,
-          `${recordMsg.flowTag}_In`
-        );
-
-        await sns.publishAsync(_izContext, {
-          Message: JSON.stringify(recordMsg.msg),
-          MessageAttributes: messageAttributes,
-          TopicArn: topicArn
-        });
-      }
-
-      return 'complete beforeLogical <%= objectType %>';
-
-      <%_ } else { _%>
-      // ── lambdaSyncInv only — collect results and proceed to createMainLogical ────────────
-      const beforeLogicalResults = lambdaSyncInvResults.reduce((acc, r) => {
-        acc[r.flowTag] = r.returnValue;
-        return acc;
-      }, {});
-
-      return await createMainLogical(
-        _izContext,
-        requestParams,
-        callingFlowConfig,
-        beforeLogicalResults
-      );
-      <%_ } _%>
-    }
-    <%_ }) _%>
-
-    //(<beforeCreateMainLogical>)
-    //(</beforeCreateMainLogical>)
-
-    // ── No beforeLogical → proceed directly to logical ────────────────────────
-    return await createMainLogical(
-      _izContext,
-      requestParams,
-      callingFlowConfig
-    );
-  } catch (err) {
-    throw err;
-  }
-}