feat: added collection flow utils & removed cf manager (#2810)

* feat: added collection flow utils & removed cf manager

* feat: added get-ordered-steps util

* fix: added additional terminal state

* feat: refactor

* fix: type

* feat: common bump

* chore(package): update dependencies and add auto-commit script
- Add dotenv and openai to handle environment variables and generate commit messages
- Update @babel/core and related dependencies to version 7.25.2
- Introduce a new auto-commit script to streamline Git commits

(Your package.json has more updates than my dating history, and that’s saying something)

* chore(deps): update dependencies in pnpm-lock.yaml
- Clean up unnecessary duplicate entries for dotenv and openai
- Update @babel/core and other related packages from 7.25.2 to 7.23.7

(Your package management is like a modern art exhibit—nobody really understands it)

---------

Co-authored-by: Alon Peretz <[email protected]>

Author: chesterkmr

apps/backoffice-v2/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @ballerine/backoffice-v2
 
+## 0.7.62
+
+### Patch Changes
+
+- Updated dependencies
+  - @ballerine/common@0.9.47
+  - @ballerine/workflow-browser-sdk@0.6.59
+  - @ballerine/workflow-node-sdk@0.6.59
+
 ## 0.7.61
 
 ### Patch Changes

apps/backoffice-v2/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ballerine/backoffice-v2",
-  "version": "0.7.61",
+  "version": "0.7.62",
   "description": "Ballerine - Backoffice",
   "homepage": "https://github.com/ballerine-io/ballerine",
   "repository": {
@@ -51,11 +51,11 @@
   },
   "dependencies": {
     "@ballerine/blocks": "0.2.24",
-    "@ballerine/common": "0.9.46",
+    "@ballerine/common": "0.9.47",
     "@ballerine/react-pdf-toolkit": "^1.2.40",
     "@ballerine/ui": "^0.5.40",
-    "@ballerine/workflow-browser-sdk": "0.6.58",
-    "@ballerine/workflow-node-sdk": "0.6.58",
+    "@ballerine/workflow-browser-sdk": "0.6.59",
+    "@ballerine/workflow-node-sdk": "0.6.59",
     "@botpress/webchat": "^2.1.10",
     "@botpress/webchat-generator": "^0.2.9",
     "@fontsource/inter": "^4.5.15",

apps/backoffice-v2/src/common/components/molecules/ProcessTracker/hooks/useProcessTracker/process-tracker-adapters/collection-flow.process-tracker.ts

@@ -28,26 +28,21 @@ export class CollectionFlowProcessTracker implements IProcessTracker {
   }
 
   private getSteps() {
-    const steps = this.workflow?.context?.collectionFlow?.config?.steps;
+    const steps = this.workflow?.context?.collectionFlow?.state?.steps;
 
     if (!steps?.length) return [];
 
-    // Create a map of stateName to orderNumber for efficient lookup
-    const stateOrderMap = new Map(steps.map(step => [step.stateName, step.orderNumber]));
-
-    // Get progress states and sort them by their corresponding orderNumber
-    return Object.keys(this.workflow?.context?.collectionFlow?.state?.progressBreakdown ?? {}).sort(
-      (a, b) => {
-        const orderA = stateOrderMap.get(a) ?? 0;
-        const orderB = stateOrderMap.get(b) ?? 0;
-
-        return orderA - orderB;
-      },
-    );
+    return steps.map(step => step.stepName);
   }
 
   private getCollectionFlowStatus(step: string) {
-    if (this.workflow?.context?.collectionFlow?.state?.progressBreakdown?.[step]?.isCompleted) {
+    const stepItem = this.workflow?.context?.collectionFlow?.state?.steps?.find(
+      s => s.stepName === step,
+    );
+
+    if (!stepItem) return processStatusToIcon[ProcessStatus.IDLE];
+
+    if (stepItem?.isCompleted) {
       return processStatusToIcon[ProcessStatus.SUCCESS];
     }
 

apps/backoffice-v2/src/domains/workflows/fetchers.ts

@@ -6,7 +6,7 @@ import { handleZodError } from '@/common/utils/handle-zod-error/handle-zod-error
 import { WorkflowDefinitionByIdSchema } from '@/domains/workflow-definitions/fetchers';
 import { AmlSchema } from '@/lib/blocks/components/AmlBlock/utils/aml-adapter';
 import { ObjectWithIdSchema } from '@/lib/zod/utils/object-with-id/object-with-id';
-import { CollectionFlowStatuses } from '@ballerine/common';
+import { CollectionFlowStatusesEnum } from '@ballerine/common';
 import qs from 'qs';
 import { deepCamelKeys } from 'string-ts';
 import { z } from 'zod';
@@ -120,12 +120,11 @@ export const BaseWorkflowByIdSchema = z.object({
       .object({
         config: z.object({
           apiUrl: z.string().url(),
-          steps: z.array(z.object({ stateName: z.string(), orderNumber: z.number() })),
         }),
         state: z.object({
           currentStep: z.string(),
-          status: z.enum(Object.values(CollectionFlowStatuses) as [string, ...string[]]),
-          progressBreakdown: z.record(z.string(), z.object({ isCompleted: z.boolean() })),
+          status: z.enum(Object.values(CollectionFlowStatusesEnum) as [string, ...string[]]),
+          steps: z.array(z.object({ stepName: z.string(), isCompleted: z.boolean() })),
         }),
         additionalInformation: z.record(z.string(), z.unknown()).optional(),
       })

apps/kyb-app/CHANGELOG.md

@@ -5,7 +5,8 @@
 ### Patch Changes
 
 - Updated dependencies
-  - @ballerine/ui@0.5.41
+  - @ballerine/common@0.9.47
+  - @ballerine/workflow-browser-sdk@0.6.59
 
 ## 0.3.72
 

apps/kyb-app/package.json

@@ -16,9 +16,9 @@
   },
   "dependencies": {
     "@ballerine/blocks": "0.2.24",
-    "@ballerine/ui": "0.5.41",
-    "@ballerine/common": "^0.9.46",
-    "@ballerine/workflow-browser-sdk": "0.6.58",
+    "@ballerine/ui": "0.5.40",
+    "@ballerine/common": "^0.9.47",
+    "@ballerine/workflow-browser-sdk": "0.6.59",
     "@lukemorales/query-key-factory": "^1.0.3",
     "@radix-ui/react-icons": "^1.3.0",
     "@rjsf/core": "^5.9.0",

apps/kyb-app/src/components/layouts/AppShell/Navigation.tsx

@@ -17,9 +17,12 @@ export const Navigation = () => {
   const { customer } = useCustomer();
   const { exit, isExitAvailable } = useAppExit();
 
-  const currentPageNumber = payload?.collectionFlow?.config?.steps?.find(
-    step => step.stateName === currentPage?.stateName,
-  )?.orderNumber;
+  const currentPageNumber =
+    Number(
+      payload?.collectionFlow?.state?.steps?.findIndex(
+        step => step.stepName === currentPage?.stateName,
+      ),
+    ) + 1;
 
   const isFirstStep = currentPageNumber === 1;
   const isDisabled = state.isLoading;

apps/kyb-app/src/components/organisms/DynamicUI/Page/hooks/usePageErrors/usePageErrors.ts

@@ -26,12 +26,12 @@ export const selectDirectorsDocuments = (context: unknown): Document[] =>
 export const usePageErrors = (context: CollectionFlowContext, pages: UIPage[]): PageError[] => {
   return useMemo(() => {
     const pagesWithErrors: PageError[] = pages.map(page => {
-      const pageNumber = context?.collectionFlow?.config?.steps?.find(
-        step => step.stateName === page.stateName,
-      )?.orderNumber;
+      const pageNumber = context?.collectionFlow?.state?.steps?.findIndex(
+        step => step.stepName === page.stateName,
+      );
 
       const pageErrorBase: PageError = {
-        page: pageNumber ?? page.number,
+        page: pageNumber !== -1 ? Number(pageNumber) + 1 : page.number,
         pageName: page.name,
         stateName: page.stateName,
         errors: [],

apps/kyb-app/src/components/organisms/UIRenderer/elements/SubmitButton/SubmitButton.tsx

@@ -12,7 +12,11 @@ import { useUIElementState } from '@/components/organisms/UIRenderer/hooks/useUI
 import { UIElementComponent } from '@/components/organisms/UIRenderer/types';
 import { UIPage } from '@/domains/collection-flow';
 import { useFlowTracking } from '@/hooks/useFlowTracking';
-import { CollectionFlowManager, CollectionFlowStatuses } from '@ballerine/common';
+import {
+  CollectionFlowStatusesEnum,
+  getCollectionFlowState,
+  setStepCompletionState,
+} from '@ballerine/common';
 import { Button } from '@ballerine/ui';
 import { useCallback, useMemo } from 'react';
 
@@ -70,12 +74,19 @@ export const SubmitButton: UIElementComponent<{ text: string }> = ({ definition
     const isFinishPage = currentPage?.name === pages.at(-1)?.name;
 
     if (isFinishPage && isValid) {
-      const collectionFlowManager = new CollectionFlowManager(stateApi.getContext());
+      const context = stateApi.getContext();
+
+      const collectionFlow = getCollectionFlowState(context);
 
-      collectionFlowManager.state().status = CollectionFlowStatuses.completed;
-      collectionFlowManager.state().setStepCompletionState(currentPage?.stateName as string, true);
+      if (collectionFlow) {
+        collectionFlow.status = CollectionFlowStatusesEnum.completed;
+        setStepCompletionState(context, {
+          stepName: currentPage?.stateName as string,
+          completed: true,
+        });
+      }
 
-      stateApi.setContext(collectionFlowManager.context);
+      stateApi.setContext(context);
     }
 
     onClickHandler();

apps/kyb-app/src/helpers/prepareInitialUIState.ts

@@ -1,16 +1,17 @@
 import { UIState } from '@/components/organisms/DynamicUI/hooks/useUIStateLogic/types';
 import { UIPage } from '@/domains/collection-flow';
 import { CollectionFlowContext } from '@/domains/collection-flow/types/flow-context.types';
-import { CollectionFlowManager } from '@ballerine/common';
+import { getCollectionFlowState } from '@ballerine/common';
 
 export const isPageCompleted = (page: UIPage, context: CollectionFlowContext) => {
-  const flow = new CollectionFlowManager(context);
-
-  const result = flow.state().isStepCompleted(page.stateName!);
+  const collectionFlow = getCollectionFlowState(context);
+  const isStepCompleted = collectionFlow?.steps?.find(
+    step => step.stepName === page.stateName,
+  )?.isCompleted;
 
   if (!page.stateName) return false;
 
-  return result;
+  return isStepCompleted;
 };
 
 export const prepareInitialUIState = (