@izara_project/izara-core-library-asynchronous-flow 1.0.24 → 1.0.27

package/package.json

@@ -1,6 +1,9 @@
 {
   "name": "@izara_project/izara-core-library-asynchronous-flow",
-  "version": "1.0.24",
+  "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.27",
   "description": "Shared asynchronous flow logic",
   "type": "module",
   "main": "index.js",
@@ -14,19 +17,16 @@
     "type": "git",
     "url": "git+ssh://git@bitbucket.org/izara-core-libraries/izara-core-library-asynchronous-flow.git"
   },
-  "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",
-  "devDependencies": {
-    "jest": "^30.4.2"
-  },
   "jest": {
     "testEnvironment": "node"
   },
+  "devDependencies": {
+    "jest": "^30.4.2"
+  },
   "peerDependencies": {
     "@izara_project/izara-core-library-core": "^1.0.32",
-    "@izara_project/izara-core-library-dynamodb": "^1.0.18",
-    "@izara_project/izara-core-library-external-request": "^1.0.29",
+    "@izara_project/izara-core-library-dynamodb": "^1.0.19",
+    "@izara_project/izara-core-library-external-request": "^1.0.30",
     "@izara_project/izara-core-library-logger": "^1.0.9",
     "@izara_project/izara-core-library-sqs": "^1.0.7"
   },

package/src/awaitingMultipleSteps.js

@@ -300,17 +300,7 @@ export async function findAwaitingMultipleStepByPending(
   return listAwaitingSteps.Items;
 }
 
-/**
- * Same as checkAllAwaitingStepsFinished but writes errors/additionalAttributes to the *_ByPending row.
- * @async
- * @param {IzContext} _izContext
- * @param {string} pendingStepId
- * @param {string|null} [currentAwaitingStepId=null]
- * @param {any[]} [errorsFound=[]]
- * @param {Attrs} [additionalAttributes={}]
- * @returns {Promise<boolean>}
- */
-export async function checkAllAwaitingStepsFinished(
+export async function checkAllAwaitingStepsFinishedShared(
   _izContext,
   pendingStepId,
   currentAwaitingStepId = null,
@@ -338,6 +328,35 @@ export async function checkAllAwaitingStepsFinished(
       }
     );
   }
+}
+
+
+/**
+ * Same as checkAllAwaitingStepsFinished but writes errors/additionalAttributes to the *_ByPending row.
+ * @async
+ * @param {IzContext} _izContext
+ * @param {string} pendingStepId
+ * @param {string|null} [currentAwaitingStepId=null]
+ * @param {any[]} [errorsFound=[]]
+ * @param {Attrs} [additionalAttributes={}]
+ * @returns {Promise<boolean>}
+ */
+export async function checkAllAwaitingStepsFinished(
+  _izContext,
+  pendingStepId,
+  currentAwaitingStepId = null,
+  errorsFound = [],
+  additionalAttributes = {}
+) {
+
+  await checkAllAwaitingStepsFinishedShared(
+    _izContext,
+    pendingStepId,
+    currentAwaitingStepId = null,
+    errorsFound = [],
+    additionalAttributes = {}
+  );
+
   let listPendingStepIds = await dynamodbSharedLib.query(
     _izContext,
     dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleStepByPending'),
@@ -367,6 +386,67 @@ export async function checkAllAwaitingStepsFinished(
   return true; // all passed
 }
 
+
+/**
+ * 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]`.
+ * @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.
+ */
+export async function checkAllAwaitingStepsFinishedWithReturnParams(
+  _izContext,
+  pendingStepId,
+  currentAwaitingStepId = null,
+  errorsFound = [],
+  additionalAttributes = {}
+) {
+
+  await checkAllAwaitingStepsFinishedShared(
+    _izContext,
+    pendingStepId,
+    currentAwaitingStepId = null,
+    errorsFound = [],
+    additionalAttributes = {}
+  );
+
+  const awaitingStepItems = await dynamodbSharedLib.query(
+    _izContext,
+    dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleStepByPending'),
+    { pendingStepId },
+    {
+      limit: 50
+    }
+  );
+
+  _izContext.logger.debug('awaitingStepItems:::', awaitingStepItems);
+
+  const collectedAttributes = {};
+  const collectedErrors = [];
+
+  for (const item of awaitingStepItems.Items) {
+    if (item.awaitingStepId !== currentAwaitingStepId && !item.complete) {
+      return [false, null, []];
+    }
+
+    if (item.errorsFound?.length > 0) {
+      collectedErrors.push(...item.errorsFound);
+    }
+
+    if (item.additionalAttributes) {
+      collectedAttributes[item.awaitingStepId] = item.additionalAttributes;
+    }
+  }
+
+  return [true, collectedAttributes, collectedErrors];
+}
+
+
 /**
  * Remove all awaiting records for a given pendingStepId from both tables.
  * @async
@@ -487,77 +567,4 @@ export async function removeAwaitingMultipleStep(
     );
   }
   await Promise.all(promiseArray);
-}
-
-/**
- * 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, keyed by their `awaitingStepId`.
- * If any other step is not yet complete, it returns `[false, null]`.
- * @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.
- */
-export async function syncAndCheckStepsCompletion(
-  _izContext,
-  pendingStepId,
-  currentAwaitingStepId = null,
-  errorsFound = [],
-  additionalAttributes = {}
-) {
-  _izContext.logger.debug(
-    'Lib:checkAllAwaitingMultipleStepsFinishedWithErrorAndReturnAdditionalAttributes',
-    {
-      pendingStepId,
-      currentAwaitingStepId,
-      errorsFound,
-      additionalAttributes
-    }
-  );
-
-  if (currentAwaitingStepId) {
-    await dynamodbSharedLib.updateItem(
-      _izContext,
-      dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleStepByPending'),
-      { pendingStepId, awaitingStepId: currentAwaitingStepId },
-      {
-        complete: true,
-        errorsFound,
-        additionalAttributes
-      }
-    );
-  }
-
-  const awaitingStepItems = await dynamodbSharedLib.query(
-    _izContext,
-    dynamodbSharedLib.tableName(_izContext, 'AwaitingMultipleStepByPending'),
-    { pendingStepId },
-    {
-      limit: 50
-    }
-  );
-
-  _izContext.logger.debug('awaitingStepItems:::', awaitingStepItems);
-
-  const collectedAttributes = {};
-  const collectedErrors = [];
-
-  for (const item of awaitingStepItems.Items) {
-    if (item.awaitingStepId !== currentAwaitingStepId && !item.complete) {
-      return [false, null, []];
-    }
-
-    if (item.errorsFound?.length > 0) {
-      collectedErrors.push(...item.errorsFound);
-    }
-
-    if (item.additionalAttributes) {
-      collectedAttributes[item.awaitingStepId] = item.additionalAttributes;
-    }
-  }
-
-  return [true, collectedAttributes, collectedErrors];
-}
+}