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

package/src/generators/fromObjectSchema/endpoint/main/create/template.ejs

@@ -0,0 +1,673 @@
+/*
+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 , identifierUuid } 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: 'createObjectAsyncEndpoint',
+  CREATE_OBJECT_ASYNC_COMPLETE: 'createObjectAsyncEndpointComplete',
+  CREATE_OBJECT_EXTERNAL_TOPIC: 'createObjectExternalTopicEndpoint'
+};
+
+/**
+ * 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 parentFlowId = identifierUuid();
+    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({
+              [storageTag]: {
+                serviceTag: createDataDetail.serviceTag,
+                tableName: createDataDetail.tableName,
+                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);
+
+          const records = allAwaitingStepsId.length === 0 ? listOfRecords : [];
+          allAwaitingStepsId.push({
+            awaitingStepId: await asyncFlowSharedLib.createAwaitingStepId(
+              parentFlowId,
+              PREFIX.CREATE_OBJECT_ASYNC
+            ),
+            //(<additionalAttributeCreateNode>)
+            additionalAttributes: { listOfRecords: records }
+            //(</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(
+              parentFlowId,
+              PREFIX.CREATE_OBJECT_EXTERNAL_TOPIC
+            ),
+            //(<additionalAttributeCreateExternalTopic>)
+            additionalAttributes: {}
+            //(</additionalAttributeCreateExternalTopic>)
+          });
+
+          Object.assign(objInstanceFullForExternalTopic, { parentFlowId: parentFlowId });
+
+          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 || [],
+            parentFlowId: parentFlowId
+          };
+        }
+
+        if (errorsFound.length > 0) break;
+
+        Object.assign(messageObject, { settings: { updatePropertiesOnMatch: false }, originTimestamp: Date.now() });
+
+        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;
+  }
+}