@izara_project/izara-core-library-asynchronous-flow 1.0.28 → 1.0.30

package/package.json

@@ -3,7 +3,7 @@
   "author": "Sven Mason <thebarbariansven@gmail.com>",
   "license": "AGPL-3.0-or-later",
   "homepage": "https://bitbucket.org/izara-core-libraries/izara-core-library-asynchronous-flow#readme",
-  "version": "1.0.28",
+  "version": "1.0.30",
   "description": "Shared asynchronous flow logic",
   "type": "module",
   "main": "index.js",
@@ -31,5 +31,7 @@
     "@izara_project/izara-core-library-sqs": "^1.0.7"
   },
   "peerDependenciesMeta": {},
-  "dependencies": {}
+  "dependencies": {
+    "@izara_project/izara-shared-core": "^1.0.12"
+  }
 }

package/src/awaitingMultipleSteps.js

@@ -18,6 +18,8 @@ along with this program.  If not, see <http://www.gnu.org/licenses/>.
 import { NoRetryError } from '@izara_project/izara-core-library-core';
 import dynamodbSharedLib from '@izara_project/izara-core-library-dynamodb';
 
+import { identifierUuid } from '@izara_project/izara-shared-core';
+
 //====================================== AwaitingMultipleSteps
 // AwaitingMultipleSteps is when a flow is awaiting multiple external flows before it can continue
 // One awaitingStepId can have multiple pendingStepIds that are awaiting it
@@ -192,6 +194,80 @@ export async function createAwaitingMultipleSteps(
   await Promise.all(promiseArray);
 }
 
+/**
+ * Create new awaiting multiple steps for a pending step.
+ * @async
+ * @param {IzContext} _izContext
+ * @param {string} pendingStepId
+ * @param {number} countAwaitingMultipleSteps
+ * @param {Object.<string, any>} [additionalAttributes={}] - Shared attributes stored for every step in AwaitingMultipleStepByPending.
+ *   The same object is applied to all steps (caller cannot know the generated UUIDs beforehand).
+ * @returns {Promise<string[]>} The list of awaiting step IDs created.
+ */
+export async function createNewAwaitingMultipleSteps(
+  _izContext,
+  pendingStepId,
+  countAwaitingMultipleSteps,
+  prefix = '',
+  additionalAttributes = {}
+) {
+  _izContext.logger.debug(
+    '[Lib:AsyncFlow:createNewAwaitingMultipleSteps] Input: ',
+    {
+      pendingStepId,
+      countAwaitingMultipleSteps,
+      additionalAttributes
+    }
+  );
+
+  const parendIds = Array.from(
+    { length: countAwaitingMultipleSteps },
+    () => (prefix ? `${prefix}_` : '') + identifierUuid.generate()
+  );
+
+  const promiseArray = [];
+
+  for (const parendId of parendIds) {
+    const attributesWhenCreate = {
+      awaitingStepId: parendId,
+      pendingStepId: pendingStepId,
+      complete: false,
+      errorsFound: []
+    };
+    promiseArray.push(
+      dynamodbSharedLib.putItem(
+        _izContext,
+        dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleSteps'),
+        attributesWhenCreate
+      )
+    );
+
+    const attributesForPending = {
+      ...attributesWhenCreate,
+      additionalAttributes: additionalAttributes
+    };
+
+    promiseArray.push(
+      dynamodbSharedLib.putItem(
+        _izContext,
+        dynamodbSharedLib.tableName(
+          _izContext,
+          'AwaitingMultipleStepByPending'
+        ),
+        attributesForPending
+      )
+    );
+
+    _izContext.logger.debug('putItem:AwaitingMultipleStepByPending', {
+      awaitingStepId: attributesWhenCreate.awaitingStepId
+    });
+  }
+
+  await Promise.all(promiseArray);
+
+  return parendIds;
+}
+
 /**
  * Find all pendingStepIds that are waiting on a given awaitingStepId (multiple).
  * @async
@@ -330,7 +406,6 @@ export async function checkAllAwaitingStepsFinishedShared(
   }
 }
 
-
 /**
  * Same as checkAllAwaitingStepsFinished but writes errors/additionalAttributes to the *_ByPending row.
  * @async
@@ -371,18 +446,22 @@ export async function checkAllAwaitingStepsFinished(
   return true;
 }
 
-
 /**
  * Checks if all awaiting steps for a pending step are complete after marking the current one as complete.
- * If all steps are finished, it returns `true` and an object containing the `additionalAttributes` from each of the completed steps, indexed by their `awaitingStepId`.
- * If any other step is not yet complete, it returns `[false, null]`.
+ * If all steps are finished, returns an object with `isComplete: true` and the collected data.
+ * If any other step is not yet complete, returns `isComplete: false` with null data.
  * @async
  * @param {IzContext} _izContext
  * @param {string} pendingStepId
  * @param {string|null} [currentAwaitingStepId=null] - The step that has just finished.
  * @param {any[]} [errorsFound=[]]
  * @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.
+ * @returns {Promise<{
+ *   isComplete: boolean,
+ *   collectedAttributes: Record<string, any>|null,
+ *   collectedErrors: any[],
+ *   sharedAdditionalAttributes: any|null
+ * }>}
  */
 export async function checkAllAwaitingStepsFinishedWithReturnParams(
   _izContext,
@@ -415,27 +494,44 @@ export async function checkAllAwaitingStepsFinishedWithReturnParams(
 
   _izContext.logger.debug('awaitingStepItems:::', awaitingStepItems);
 
-  const collectedAttributes = {};
-  const collectedErrors = [];
-
+  // Pass 1: check completeness of all other steps before collecting any data
   for (const item of awaitingStepItems.Items) {
     if (item.awaitingStepId !== currentAwaitingStepId && !item.complete) {
-      return [false, null, collectedErrors];
+      return {
+        isComplete: false,
+        collectedAttributes: null,
+        collectedErrors: [],
+        sharedAdditionalAttributes: null
+      };
     }
+  }
 
+  // Pass 2: all steps are complete — collect errors and attributes
+  const collectedAttributes = {};
+  const collectedErrors = [];
+  let sharedAdditionalAttributes = null;
+
+  for (const item of awaitingStepItems.Items) {
     if (item.errorsFound?.length > 0) {
       collectedErrors.push(...item.errorsFound);
     }
 
     if (item.additionalAttributes) {
       collectedAttributes[item.awaitingStepId] = item.additionalAttributes;
+      if (sharedAdditionalAttributes === null) {
+        sharedAdditionalAttributes = item.additionalAttributes;
+      }
     }
   }
 
-  return [true, collectedAttributes, collectedErrors];
+  return {
+    isComplete: true,
+    collectedAttributes,
+    collectedErrors,
+    sharedAdditionalAttributes
+  };
 }
 
-
 /**
  * Remove all awaiting records for a given pendingStepId from both tables.
  * @async
@@ -556,4 +652,4 @@ export async function removeAwaitingMultipleStep(
     );
   }
   await Promise.all(promiseArray);
-}
+}