@izara_project/izara-core-library-asynchronous-flow 1.0.21 → 1.0.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@izara_project/izara-core-library-asynchronous-flow",
-  "version": "1.0.21",
+  "version": "1.0.23",
   "description": "Shared asynchronous flow logic",
   "main": "index.js",
   "scripts": {

package/src/asyncFlowSharedLib.js

@@ -194,7 +194,7 @@ export async function checkUniqueRequestProcessing(
       //* get record from dynamo
       let existingRecord = await dynamodbSharedLib.getItem(
         _izContext,
-        await dynamodbSharedLib.tableName(_izContext, tableName),
+        dynamodbSharedLib.tableName(_izContext, tableName),
         primaryKey
       );
       _izContext.logger.debug('existingRecord:', existingRecord);
@@ -230,7 +230,7 @@ export async function checkUniqueRequestProcessing(
         try {
           updateRecord = await dynamodbSharedLib.updateItem(
             _izContext,
-            await dynamodbSharedLib.tableName(_izContext, tableName),
+            dynamodbSharedLib.tableName(_izContext, tableName),
             primaryKey,
             updateAttributes,
             queryElementsWhenUpdate,

package/src/awaitingMultipleSteps.js

@@ -58,14 +58,14 @@ export async function createAwaitingMultipleStepsWithAdditionalAttributes(
     promiseArray.push(
       dynamodbSharedLib.putItem(
         _izContext,
-        await dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleSteps'),
+        dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleSteps'),
         attributesWhenCreate
       )
     );
     promiseArray.push(
       dynamodbSharedLib.putItem(
         _izContext,
-        await dynamodbSharedLib.tableName(
+        dynamodbSharedLib.tableName(
           _izContext,
           'AwaitingMultipleStepByPending'
         ),
@@ -81,43 +81,53 @@ export async function createAwaitingMultipleStepsWithAdditionalAttributes(
   await Promise.all(promiseArray);
 }
 
-export async function createAwaitingMultipleStepsWithAdditionalAttributesV2(
+/**
+ * Batch initializes multiple pending steps in DynamoDB.
+ * Records status in both the primary tracking table and the pending-relation table.
+ * * @async
+ * @param {Object} _izContext - The system context providing logger and shared utilities.
+ * @param {Array<Object>} records - Array of step objects to be initialized.
+ * @param {string} records[].awaitingStepId - The unique identifier for the specific step.
+ * @param {Object} [records[].additionalAttributes] - Optional metadata to store with the step.
+ * @param {string} pendingStepId - The parent ID linking all related steps together.
+ * @returns {Promise<void>}
+ */
+export async function initAwaitingStepsWithAttrs(
   _izContext,
-  records, // array of object including properties: awaitingStepId / (optional) additionalAttributes
+  records,
   pendingStepId
 ) {
-  _izContext.logger.debug(
-    'Lib:createAwaitingMultipleStepsWithAdditionalAttributesV2',
-    {
-      records: records,
-      pendingStepId: pendingStepId
-    }
-  );
+  _izContext.logger.debug('Lib:initAwaitingStepsWithAttrs', {
+    records,
+    pendingStepId
+  });
+
+  const timestamp = Date.now();
   const promiseArray = [];
 
-  for (let record of records) {
+  for (const record of records) {
     promiseArray.push(
       dynamodbSharedLib.putItem(
         _izContext,
-        await dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleSteps'),
+        dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleSteps'),
         {
           awaitingStepId: record.awaitingStepId,
-          pendingStepId: pendingStepId,
-          timestamp: Date.now()
+          pendingStepId,
+          timestamp
         }
       )
     );
     promiseArray.push(
       dynamodbSharedLib.putItem(
         _izContext,
-        await dynamodbSharedLib.tableName(
+        dynamodbSharedLib.tableName(
           _izContext,
           'AwaitingMultipleStepByPending'
         ),
         {
-          pendingStepId: pendingStepId,
+          pendingStepId,
           awaitingStepId: record.awaitingStepId,
-          timestamp: Date.now(),
+          timestamp,
           ...record.additionalAttributes
         }
       )
@@ -160,7 +170,7 @@ export async function createAwaitingMultipleSteps(
     promiseArray.push(
       dynamodbSharedLib.putItem(
         _izContext,
-        await dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleSteps'),
+        dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleSteps'),
         attributesWhenCreate
       )
     );
@@ -171,7 +181,7 @@ export async function createAwaitingMultipleSteps(
     promiseArray.push(
       dynamodbSharedLib.putItem(
         _izContext,
-        await dynamodbSharedLib.tableName(
+        dynamodbSharedLib.tableName(
           _izContext,
           'AwaitingMultipleStepByPending'
         ),
@@ -197,7 +207,7 @@ export async function findPendingStepIdsAwaitingMultipleSteps(
 
   let listPendingStepIds = await dynamodbSharedLib.query(
     _izContext,
-    await dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleSteps'),
+    dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleSteps'),
     {
       awaitingStepId: awaitingStepId
     }
@@ -223,7 +233,7 @@ export async function findPendingStepsAwaitingMultipleSteps(
 ) {
   let listPendingSteps = await dynamodbSharedLib.query(
     _izContext,
-    await dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleSteps'),
+    dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleSteps'),
     {
       awaitingStepId: awaitingStepId
     }
@@ -246,7 +256,7 @@ export async function findPendingStepAwaitingMultipleSteps(
 ) {
   let listPendingSteps = await dynamodbSharedLib.query(
     _izContext,
-    await dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleSteps'),
+    dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleSteps'),
     {
       awaitingStepId: awaitingStepId
     }
@@ -278,10 +288,7 @@ export async function findAwaitingMultipleStepByPending(
 ) {
   let listAwaitingSteps = await dynamodbSharedLib.query(
     _izContext,
-    await dynamodbSharedLib.tableName(
-      _izContext,
-      'AwaitingMultipleStepByPending'
-    ),
+    dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleStepByPending'),
     {
       pendingStepId: pendingStepId
     }
@@ -303,7 +310,7 @@ export async function findAwaitingMultipleStepByPending(
  * @param {Attrs} [additionalAttributes={}]
  * @returns {Promise<boolean>}
  */
-export async function checkAllAwaitingStepsFinishedWithError(
+export async function checkAllAwaitingStepsFinished(
   _izContext,
   pendingStepId,
   currentAwaitingStepId = null,
@@ -319,10 +326,7 @@ export async function checkAllAwaitingStepsFinishedWithError(
   if (currentAwaitingStepId) {
     await dynamodbSharedLib.updateItem(
       _izContext,
-      await dynamodbSharedLib.tableName(
-        _izContext,
-        'AwaitingMultipleStepByPending'
-      ),
+      dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleStepByPending'),
       {
         pendingStepId: pendingStepId,
         awaitingStepId: currentAwaitingStepId
@@ -336,10 +340,7 @@ export async function checkAllAwaitingStepsFinishedWithError(
   }
   let listPendingStepIds = await dynamodbSharedLib.query(
     _izContext,
-    await dynamodbSharedLib.tableName(
-      _izContext,
-      'AwaitingMultipleStepByPending'
-    ),
+    dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleStepByPending'),
     {
       pendingStepId: pendingStepId
     },
@@ -377,10 +378,7 @@ export async function clearAllAwaitingSteps(_izContext, pendingStepId) {
   // ----- query items from GSI table
   let listPendingStepIds = await dynamodbSharedLib.query(
     _izContext,
-    await dynamodbSharedLib.tableName(
-      _izContext,
-      'AwaitingMultipleStepByPending'
-    ),
+    dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleStepByPending'),
     {
       pendingStepId: pendingStepId
     }
@@ -394,7 +392,7 @@ export async function clearAllAwaitingSteps(_izContext, pendingStepId) {
     promiseArray.push(
       dynamodbSharedLib.deleteItem(
         _izContext,
-        await dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleSteps'),
+        dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleSteps'),
         {
           awaitingStepId: listPendingStepIds.Items[idx].awaitingStepId,
           pendingStepId: listPendingStepIds.Items[idx].pendingStepId
@@ -408,7 +406,7 @@ export async function clearAllAwaitingSteps(_izContext, pendingStepId) {
     promiseArray.push(
       dynamodbSharedLib.deleteItem(
         _izContext,
-        await dynamodbSharedLib.tableName(
+        dynamodbSharedLib.tableName(
           _izContext,
           'AwaitingMultipleStepByPending'
         ),
@@ -468,7 +466,7 @@ export async function removeAwaitingMultipleStep(
   promiseArray.push(
     dynamodbSharedLib.deleteItem(
       _izContext,
-      await dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleSteps'),
+      dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleSteps'),
       keyValues
     )
   );
@@ -480,7 +478,7 @@ export async function removeAwaitingMultipleStep(
     promiseArray.push(
       dynamodbSharedLib.deleteItem(
         _izContext,
-        await dynamodbSharedLib.tableName(
+        dynamodbSharedLib.tableName(
           _izContext,
           'AwaitingMultipleStepByPending'
         ),
@@ -503,7 +501,7 @@ export async function removeAwaitingMultipleStep(
  * @param {Attrs} [additionalAttributes={}]
  * @returns {Promise<[boolean, Record<string, any>|null]>} A tuple indicating completion status and the collected attributes, or null if not all steps are complete.
  */
-export async function checkAllAwaitingMultipleStepsFinishedWithErrorAndReturnAdditionalAttributes(
+export async function syncAndCheckStepsCompletion(
   _izContext,
   pendingStepId,
   currentAwaitingStepId = null,
@@ -523,46 +521,43 @@ export async function checkAllAwaitingMultipleStepsFinishedWithErrorAndReturnAdd
   if (currentAwaitingStepId) {
     await dynamodbSharedLib.updateItem(
       _izContext,
-      await dynamodbSharedLib.tableName(
-        _izContext,
-        'AwaitingMultipleStepByPending'
-      ),
+      dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleStepByPending'),
       { pendingStepId, awaitingStepId: currentAwaitingStepId },
       {
         complete: true,
         errorsFound,
-        ...additionalAttributes
+        additionalAttributes
       }
     );
   }
 
   const awaitingStepItems = await dynamodbSharedLib.query(
     _izContext,
-    await dynamodbSharedLib.tableName(
-      _izContext,
-      'AwaitingMultipleStepByPending'
-    ),
+    dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleStepByPending'),
     { pendingStepId },
     {
-      limit: 50 // arbitrary limit so not pull too many results, need >2 because some others might be marked as "complete" = true
+      limit: 50
     }
   );
 
+  _izContext.logger.debug('awaitingStepItems:::', awaitingStepItems);
+
   const collectedAttributes = {};
+  const collectedErrors = [];
+
   for (const item of awaitingStepItems.Items) {
-    // For any step OTHER than the one we just completed, if it's not marked as complete,
-    // then the overall process is not finished.
     if (item.awaitingStepId !== currentAwaitingStepId && !item.complete) {
-      return [false, null];
+      return [false, null, []];
+    }
+
+    if (item.errorsFound?.length > 0) {
+      collectedErrors.push(...item.errorsFound);
     }
 
-    // If the step is complete (which all should be if we reach this point),
-    // collect its attributes if they exist.
     if (item.additionalAttributes) {
       collectedAttributes[item.awaitingStepId] = item.additionalAttributes;
     }
   }
 
-  // If the loop completes, it means all steps were finished.
-  return [true, collectedAttributes];
+  return [true, collectedAttributes, collectedErrors];
 }

package/src/awaitingStep.js

@@ -65,7 +65,7 @@ export async function createAwaitingStep(
 
   await dynamodbSharedLib.putItem(
     _izContext,
-    await dynamodbSharedLib.tableName(_izContext, 'AwaitingStep'),
+    dynamodbSharedLib.tableName(_izContext, 'AwaitingStep'),
     attributesWhenCreate
   );
 }
@@ -85,7 +85,7 @@ export async function findPendingStepIdsAwaitingStep(
 
   let listPendingStepIds = await dynamodbSharedLib.query(
     _izContext,
-    await dynamodbSharedLib.tableName(_izContext, 'AwaitingStep'),
+    dynamodbSharedLib.tableName(_izContext, 'AwaitingStep'),
     {
       awaitingStepId: awaitingStepId
     }
@@ -108,7 +108,7 @@ export async function findPendingStepIdsAwaitingStep(
 export async function findPendingStepsAwaitingStep(_izContext, awaitingStepId) {
   let listPendingSteps = await dynamodbSharedLib.query(
     _izContext,
-    await dynamodbSharedLib.tableName(_izContext, 'AwaitingStep'),
+    dynamodbSharedLib.tableName(_izContext, 'AwaitingStep'),
     {
       awaitingStepId: awaitingStepId
     }
@@ -128,7 +128,7 @@ export async function findPendingStepsAwaitingStep(_izContext, awaitingStepId) {
 export async function findPendingStepAwaitingStep(_izContext, awaitingStepId) {
   let listPendingSteps = await dynamodbSharedLib.query(
     _izContext,
-    await dynamodbSharedLib.tableName(_izContext, 'AwaitingStep'),
+    dynamodbSharedLib.tableName(_izContext, 'AwaitingStep'),
     {
       awaitingStepId: awaitingStepId
     }
@@ -186,7 +186,7 @@ export async function removeAwaitingStep(
 ) {
   await dynamodbSharedLib.deleteItem(
     _izContext,
-    await dynamodbSharedLib.tableName(_izContext, 'AwaitingStep'),
+    dynamodbSharedLib.tableName(_izContext, 'AwaitingStep'),
     {
       awaitingStepId: awaitingStepId,
       pendingStepId: pendingStepId
@@ -231,7 +231,7 @@ export async function removeAwaitingStepWithCheckUniqueRequestId(
 
   await dynamodbSharedLib.deleteItem(
     _izContext,
-    await dynamodbSharedLib.tableName(_izContext, 'AwaitingStep'),
+    dynamodbSharedLib.tableName(_izContext, 'AwaitingStep'),
     {
       awaitingStepId: awaitingStepId,
       pendingStepId: pendingStepId