@izara_project/izara-core-library-asynchronous-flow 1.0.44 → 1.0.45

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.44",
+  "version": "1.0.45",
   "description": "Shared asynchronous flow logic",
   "type": "module",
   "main": "index.js",

package/src/awaitingMultipleSteps.js

@@ -551,3 +551,99 @@ export async function removeAwaitingMultipleStep(
 
   await Promise.all(promises);
 }
+
+/**
+ * Complete an action and update the state of the awaiting step.
+ * @async
+ * @param {IzContext} _izContext - The Izara context.
+ * @param {string} parentFlowId - The ID of the parent flow.
+ * @returns {Promise<Object>} Status object containing completion details.
+ */
+export async function completeAction(
+  _izContext,
+  parentFlowId,
+  prefix = '',
+  returnValue = {},
+  errorsFound = []
+){
+ _izContext.logger.debug('[Lib:CompleteAction] Input parameters', {
+  parentFlowId,
+  prefix
+  });
+
+  try {
+
+    const pendingStepId = findPendingStepAwaitingMultipleSteps(
+      _izContext,
+      createAwaitingStepId(
+        parentFlowId,
+        prefix
+      )
+    );
+
+     if (!pendingStepId) {
+      _izContext.logger.warn(
+        `No pending step found for awaitingStepId: ${awaitingStepId}`
+      );
+      return { returnValue, errorsFound };
+    }
+
+    const {
+      isComplete,
+      collectedReturnValueByAwaitingStepId,
+      collectedErrors,
+      returnValues,
+      additionalAttributes
+    } = await checkAllAwaitingStepsFinishedWithReturnParams(
+      _izContext,
+      pendingStepId,
+      createAwaitingStepId(
+        parentFlowId,
+        prefix
+      )
+    );
+
+    let status = true;
+
+    if (!isComplete) {
+      status =  false
+    };
+
+    if (collectedErrors.length > 0 || errorsFound.length > 0) {
+      status =false
+    };
+
+    if (status) {
+        await Promise.all(
+          (pendingStepId.listOfRecords ?? []).flatMap((records) =>
+            Object.values(records).map(async (record) =>
+              dynamodbSharedLib.putItem(
+                _izContext,
+                await dynamodbSharedLib.tableName(
+                _izContext,
+                record.tableName,
+                record.serviceTag
+              ),
+              {
+                ...record.objInstanceFull.identifiers,
+                ...record.objInstanceFull.fields
+              }
+            )
+          )
+        )
+      );
+    }
+
+    return {
+      pendingStepId,
+      isComplete,
+      collectedReturnValueByAwaitingStepId,
+      collectedErrors,
+      returnValues,
+      additionalAttributes
+    }
+
+  } catch (err) {
+    _izContext.logger.error(err)
+  }
+}