feat(plugins): add commercial credit check plugin and related updates

apps/backoffice-v2/src/common/components/molecules/ProcessTracker/constants.tsx

@@ -100,6 +100,7 @@ export const pluginsWhiteList = [
   'merchantMonitoring',
   'merchantScreening',
   'bankAccountVerification',
+  'commercialCreditCheck',
 ] as const;
 
 export const DEFAULT_PROCESS_TRACKER_PROCESSES = ['collection-flow', 'third-party', 'ubos'];

apps/backoffice-v2/src/lib/blocks/hooks/useBankAccountVerificationBlock/useBankAccountVerificationBlock.tsx

@@ -0,0 +1,76 @@
+import { useCallback, useMemo } from 'react';
+
+import { createBlocksTyped } from '@/lib/blocks/create-blocks-typed/create-blocks-typed';
+
+export const useBankAccountVerificationBlock = ({ pluginsOutput }) => {
+  const getCell = useCallback(() => {
+    if (
+      Object.keys(pluginsOutput?.bankAccountVerification?.data.clientResponsePayload ?? {}).length
+    ) {
+      const data = {
+        ...pluginsOutput.bankAccountVerification.data.responseHeader.overallResponse,
+        decisionElements:
+          pluginsOutput.bankAccountVerification.data.clientResponsePayload.decisionElements,
+        orchestrationDecisions:
+          pluginsOutput.bankAccountVerification.data.clientResponsePayload.orchestrationDecisions,
+      };
+
+      return {
+        id: 'nested-details',
+        type: 'details',
+        hideSeparator: true,
+        value: {
+          data: Object.entries(data)
+            ?.filter(([property]) => !['tenantID', 'clientReferenceId'].includes(property))
+            .map(([title, value]) => ({
+              title,
+              value,
+            })),
+        },
+        props: {
+          config: {
+            sort: { predefinedOrder: ['decision', 'decisionText'] },
+          },
+        },
+      } satisfies Extract<
+        Parameters<ReturnType<typeof createBlocksTyped>['addCell']>[0],
+        {
+          type: 'details';
+        }
+      >;
+    }
+  }, [pluginsOutput]);
+
+  return useMemo(() => {
+    const cell = getCell();
+
+    if (!cell) {
+      return [];
+    }
+
+    return createBlocksTyped()
+      .addBlock()
+      .addCell({
+        type: 'block',
+        value: createBlocksTyped()
+          .addBlock()
+          .addCell({
+            id: 'nested-details-heading',
+            type: 'heading',
+            value: 'Bank Account Verification',
+          })
+          .addCell({
+            id: 'nested-details-subheading',
+            type: 'subheading',
+            value: 'Experian-Provided Data',
+            props: {
+              className: 'mb-4',
+            },
+          })
+          .addCell(cell)
+          .build()
+          .flat(1),
+      })
+      .build();
+  }, [getCell]);
+};

apps/backoffice-v2/src/lib/blocks/hooks/useCommercialCreditCheckBlock/useCommercialCreditCheckBlock.tsx

@@ -0,0 +1,63 @@
+import { useCallback, useMemo } from 'react';
+
+import { createBlocksTyped } from '@/lib/blocks/create-blocks-typed/create-blocks-typed';
+
+export const useCommercialCreditCheckBlock = ({ pluginsOutput }) => {
+  const getCell = useCallback(() => {
+    if (Object.keys(pluginsOutput?.commercialCreditCheck?.data ?? {}).length) {
+      return {
+        id: 'nested-details',
+        type: 'details',
+        hideSeparator: true,
+        value: {
+          data: Object.entries(pluginsOutput.commercialCreditCheck.data).map(([title, value]) => ({
+            title,
+            value,
+          })),
+        },
+        props: {
+          config: {
+            sort: { predefinedOrder: ['CommercialName', 'RegNumber'] },
+          },
+        },
+      } satisfies Extract<
+        Parameters<ReturnType<typeof createBlocksTyped>['addCell']>[0],
+        {
+          type: 'details';
+        }
+      >;
+    }
+  }, [pluginsOutput]);
+
+  return useMemo(() => {
+    const cell = getCell();
+
+    if (!cell) {
+      return [];
+    }
+
+    return createBlocksTyped()
+      .addBlock()
+      .addCell({
+        type: 'block',
+        value: createBlocksTyped()
+          .addBlock()
+          .addCell({
+            id: 'nested-details-heading',
+            type: 'heading',
+            value: 'Commercial Credit Check',
+          })
+          .addCell({
+            id: 'nested-details-subheading',
+            type: 'subheading',
+            value: 'Experian-Provided Data',
+            props: {
+              className: 'mb-4',
+            },
+          })
+          .addCell(cell)
+          .buildFlat(),
+      })
+      .build();
+  }, [getCell]);
+};

apps/backoffice-v2/src/lib/blocks/hooks/useKybRegistryInfoBlock/useKybRegistryInfoBlock.tsx

@@ -4,11 +4,6 @@ import { createBlocksTyped } from '@/lib/blocks/create-blocks-typed/create-block
 import { WarningFilledSvg } from '@ballerine/ui';
 
 export const useKybRegistryInfoBlock = ({ pluginsOutput, workflow }) => {
-  const isBankAccountVerification = useMemo(
-    () => !!pluginsOutput?.bankAccountVerification,
-    [pluginsOutput?.bankAccountVerification],
-  );
-
   const getCell = useCallback(() => {
     if (Object.keys(pluginsOutput?.businessInformation?.data?.[0] ?? {}).length) {
       return {
@@ -33,39 +28,6 @@ export const useKybRegistryInfoBlock = ({ pluginsOutput, workflow }) => {
       >;
     }
 
-    if (Object.keys(pluginsOutput?.bankAccountVerification?.clientResponsePayload ?? {}).length) {
-      const data = {
-        ...pluginsOutput?.bankAccountVerification?.responseHeader.overallResponse,
-        decisionElements:
-          pluginsOutput?.bankAccountVerification?.clientResponsePayload.decisionElements,
-        orchestrationDecisions:
-          pluginsOutput?.bankAccountVerification?.clientResponsePayload.orchestrationDecisions,
-      };
-
-      return {
-        id: 'nested-details',
-        type: 'details',
-        hideSeparator: true,
-        value: {
-          data: Object.entries(data)
-            ?.filter(([property]) => {
-              console.log(property);
-
-              return !['tenantID', 'clientReferenceId'].includes(property);
-            })
-            .map(([title, value]) => ({
-              title,
-              value,
-            })),
-        },
-      } satisfies Extract<
-        Parameters<ReturnType<typeof createBlocksTyped>['addCell']>[0],
-        {
-          type: 'details';
-        }
-      >;
-    }
-
     const message =
       pluginsOutput?.businessInformation?.message ??
       pluginsOutput?.businessInformation?.data?.message;
@@ -132,12 +94,12 @@ export const useKybRegistryInfoBlock = ({ pluginsOutput, workflow }) => {
           .addCell({
             id: 'nested-details-heading',
             type: 'heading',
-            value: isBankAccountVerification ? 'Bank Account Verification' : 'Registry Information',
+            value: 'Registry Information',
           })
           .addCell({
             id: 'nested-details-subheading',
             type: 'subheading',
-            value: `${isBankAccountVerification ? 'Experian' : 'Registry'}-Provided Data`,
+            value: 'Registry-Provided Data',
             props: {
               className: 'mb-4',
             },

apps/backoffice-v2/src/lib/blocks/variants/DefaultBlocks/hooks/useCaseBlocksLogic/utils/get-tabs-block-map.tsx

@@ -55,6 +55,8 @@ export const getTabsToBlocksMap = ({
     amlWithContainerBlock,
     merchantScreeningBlock,
     manageUbosBlock,
+    bankAccountVerificationBlock,
+    commercialCreditCheckBlock,
   ] = blocks;
 
   const defaultTabsMap = {
@@ -76,6 +78,8 @@ export const getTabsToBlocksMap = ({
       ...kybRegistryInfoBlock,
       ...companySanctionsBlock,
       ...bankingDetailsBlock,
+      ...bankAccountVerificationBlock,
+      ...commercialCreditCheckBlock,
     ],
     [Tab.STORE_INFO]: [
       ...storeInfoBlock,

apps/backoffice-v2/src/lib/blocks/variants/DefaultBlocks/hooks/useDefaultBlocksLogic/useDefaultBlocksLogic.tsx

@@ -57,6 +57,8 @@ import { useRemoveDecisionTaskByIdMutation } from '@/domains/entities/hooks/muta
 import { useApproveTaskByIdMutation } from '@/domains/entities/hooks/mutations/useApproveTaskByIdMutation/useApproveTaskByIdMutation';
 import { directorAdapter } from '@/lib/blocks/components/DirectorBlock/hooks/useDirectorBlock/helpers';
 import { createDirectorsBlocks } from '@/lib/blocks/components/DirectorBlock/hooks/useDirectorBlock/create-directors-blocks';
+import { useBankAccountVerificationBlock } from '@/lib/blocks/hooks/useBankAccountVerificationBlock/useBankAccountVerificationBlock';
+import { useCommercialCreditCheckBlock } from '@/lib/blocks/hooks/useCommercialCreditCheckBlock/useCommercialCreditCheckBlock';
 
 const registryInfoWhitelist = ['open_corporates'] as const;
 
@@ -173,6 +175,14 @@ export const useDefaultBlocksLogic = () => {
     workflow,
   });
 
+  const bankAccountVerificationBlock = useBankAccountVerificationBlock({
+    pluginsOutput: workflow?.context?.pluginsOutput,
+  });
+
+  const commercialCreditCheckBlock = useCommercialCreditCheckBlock({
+    pluginsOutput: workflow?.context?.pluginsOutput,
+  });
+
   const parentDocumentBlocks = useDocumentBlocks({
     workflow,
     parentMachine: workflow?.context?.parentMachine,
@@ -511,7 +521,9 @@ export const useDefaultBlocksLogic = () => {
   });
 
   const allBlocks = useMemo(() => {
-    if (!workflow?.context?.entity) return [];
+    if (!workflow?.context?.entity) {
+      return [];
+    }
 
     return [
       websiteMonitoringBlock,
@@ -543,6 +555,8 @@ export const useDefaultBlocksLogic = () => {
       amlWithContainerBlock,
       merchantScreeningBlock,
       manageUbosBlock,
+      bankAccountVerificationBlock,
+      commercialCreditCheckBlock,
     ];
   }, [
     associatedCompaniesBlock,
@@ -575,6 +589,8 @@ export const useDefaultBlocksLogic = () => {
     merchantScreeningBlock,
     workflow?.context?.entity,
     manageUbosBlock,
+    bankAccountVerificationBlock,
+    commercialCreditCheckBlock,
   ]);
 
   const { blocks, tabs } = useCaseBlocks({

packages/workflow-core/src/lib/constants.ts

@@ -10,6 +10,7 @@ import { BallerineApiPlugin } from './plugins/external-plugin/ballerine-api-plug
 import { BallerineEmailPlugin } from './plugins/external-plugin/ballerine-email-plugin';
 import { IndividualsSanctionsV2Plugin } from './plugins/external-plugin/individuals-sanctions-v2-plugin/individuals-sanctions-v2-plugin';
 import { BankAccountVerificationPlugin } from './plugins/external-plugin/bank-account-verification-plugin/bank-account-verification-plugin';
+import { CommercialCreditCheckPlugin } from './plugins/external-plugin/commercial-credit-check-plugin/commercial-credit-check-plugin';
 
 export const PluginKind = {
   KYC: 'kyc',
@@ -20,6 +21,7 @@ export const PluginKind = {
   MASTERCARD_MERCHANT_SCREENING: 'mastercard-merchant-screening',
   INDIVIDUAL_SANCTIONS_V2: 'individual-sanctions-v2',
   BANK_ACCOUNT_VERIFICATION: 'bank-account-verification',
+  COMMERCIAL_CREDIT_CHECK: 'commercial-credit-check',
 } as const;
 
 export const pluginsRegistry = {
@@ -31,6 +33,7 @@ export const pluginsRegistry = {
   [PluginKind.MASTERCARD_MERCHANT_SCREENING]: MastercardMerchantScreeningPlugin,
   [PluginKind.INDIVIDUAL_SANCTIONS_V2]: IndividualsSanctionsV2Plugin,
   [PluginKind.BANK_ACCOUNT_VERIFICATION]: BankAccountVerificationPlugin,
+  [PluginKind.COMMERCIAL_CREDIT_CHECK]: CommercialCreditCheckPlugin,
   [BALLERINE_API_PLUGINS['individual-sanctions']]: BallerineApiPlugin,
   [BALLERINE_API_PLUGINS['company-sanctions']]: BallerineApiPlugin,
   [BALLERINE_API_PLUGINS['ubo']]: BallerineApiPlugin,

packages/workflow-core/src/lib/plugins/external-plugin/bank-account-verification-plugin/bank-account-verification-plugin.ts

@@ -70,6 +70,8 @@ type TBankAccountVerificationPluginPayload = {
   };
 };
 
+const BankAccountVerificationResponseSchema = z.record(z.string(), z.unknown());
+
 export class BankAccountVerificationPlugin extends ApiPlugin {
   public static pluginType = 'http';
   public payload: TBankAccountVerificationPluginPayload;
@@ -94,7 +96,7 @@ export class BankAccountVerificationPlugin extends ApiPlugin {
     const env = validateEnv(this.pluginName);
 
     try {
-      const url = `${env.UNIFIED_API_URL}/bank-account-verification/commercial`;
+      const url = `${env.UNIFIED_API_URL}/bank-account-verification`;
 
       const payload = getPayloadPropertiesValue({
         properties: this.payload,
@@ -142,7 +144,7 @@ export class BankAccountVerificationPlugin extends ApiPlugin {
       }
 
       const res = await apiResponse.json();
-      const responseBody = z.record(z.string(), z.unknown()).parse(res);
+      const responseBody = BankAccountVerificationResponseSchema.parse(res);
 
       if (this.successAction) {
         return this.returnSuccessResponse(this.successAction, {