@zeniai/client-epic-state 5.0.87-betaAK1 → 5.0.87-betaAK2

package/lib/esm/view/spendManagement/cashManagement/cashManagementOverview/cashManagementOverviewSelector.js

@@ -1,5 +1,7 @@
 import { zeroAmount } from '../../../../commonStateTypes/amount';
 import { reduceAllFetchState } from '../../../../commonStateTypes/reduceFetchState';
+import { getDepositAccountByDepositAccountId } from '../../../../entity/depositAccount/depositAccountSelector';
+import { mapDepositAccToFundingAccount, } from '../../commonSetup/setupViewSelector';
 /**
  * Default account type used when the recommend payload has no movement to
  * expose yet (e.g. before the first fetch resolves). Callers that care about
@@ -18,6 +20,26 @@ export const getCashManagementOverviewBanner = (state) => {
         { fetchState: banner.fetchState, error: banner.error },
         { fetchState: autoSweep.fetchState, error: autoSweep.error },
     ]);
+    const subMovementType = movement?.subMovementType ?? DEFAULT_SUB_MOVEMENT_TYPE;
+    // The "primary" account is the deposit-account side of the movement —
+    // source for a push (money leaving primary → treasury) and destination
+    // for a pull (money returning to primary).
+    const primaryAccountId = subMovementType === 'pull'
+        ? movement?.destinationBankAccountId
+        : movement?.sourceBankAccountId;
+    const primaryDepositAccount = primaryAccountId != null && primaryAccountId !== ''
+        ? getDepositAccountByDepositAccountId(state.depositAccountState, primaryAccountId)
+        : undefined;
+    const primaryFundingAccount = primaryDepositAccount != null
+        ? mapDepositAccToFundingAccount(primaryDepositAccount)
+        : undefined;
+    // For pull, surface the largest outflow in the horizon as the
+    // "triggering" event. This is a heuristic — the agent doesn't tag a
+    // specific outflow today, but the largest one is the most likely cause
+    // of the buffer breach and matches what the design wants to highlight.
+    const triggeringOutflow = subMovementType === 'pull'
+        ? pickLargestOutflow(banner.data?.outflows)
+        : undefined;
     return {
         fetchState: aggregate.fetchState,
         error: aggregate.error,
@@ -28,10 +50,18 @@ export const getCashManagementOverviewBanner = (state) => {
         reasoning: movement?.reasoning ?? '',
         sourceBankAccountId: movement?.sourceBankAccountId ?? '',
         sourceBankAccountType: movement?.sourceBankAccountType ?? DEFAULT_BANK_ACCOUNT_TYPE,
-        subMovementType: movement?.subMovementType ?? DEFAULT_SUB_MOVEMENT_TYPE,
+        subMovementType,
+        primaryFundingAccount,
+        triggeringOutflow,
         version: 0,
     };
 };
+const pickLargestOutflow = (outflows) => {
+    if (outflows == null || outflows.length === 0) {
+        return undefined;
+    }
+    return outflows.reduce((largest, event) => event.amount.amount > largest.amount.amount ? event : largest);
+};
 export const getCashManagementOverview = (state) => {
     const { cashManagementOverviewState, depositAccountListState, depositAccountState, paymentAccountListState, paymentAccountState, treasuryDetailState, } = state;
     const aggregate = reduceAllFetchState([

package/lib/view/spendManagement/cashManagement/cashManagementOverview/cashManagementOverviewSelector.d.ts

@@ -2,9 +2,25 @@ import { Amount } from '../../../../commonStateTypes/amount';
 import { ID } from '../../../../commonStateTypes/common';
 import { SelectorView } from '../../../../commonStateTypes/viewAndReport/viewAndReport';
 import { RootState } from '../../../../reducer';
+import { FundingAccount } from '../../commonSetup/setupViewSelector';
 import { CashManagementMovement, UpcomingPaymentEvent } from './cashManagementOverviewState';
 export interface CashManagementOverviewBannerSelectorView extends SelectorView, CashManagementMovement {
     cashManagementSettingsId?: ID;
+    /**
+     * Resolved funding account whose buffer the agent is managing. For a push
+     * movement this is the `sourceBankAccountId`; for a pull it is the
+     * `destinationBankAccountId`. `undefined` when the agent hasn't returned a
+     * movement yet or the deposit account hasn't been hydrated into the entity
+     * bucket.
+     */
+    primaryFundingAccount?: FundingAccount;
+    /**
+     * Pull-variant only. The largest upcoming outflow in the horizon — the
+     * event most likely to have pushed the primary account below its buffer
+     * and triggered the recommended pull. `undefined` for push movements or
+     * when the agent returned no outflow events.
+     */
+    triggeringOutflow?: UpcomingPaymentEvent;
 }
 export interface CashProjectionPoint {
     balance: Amount;

package/lib/view/spendManagement/cashManagement/cashManagementOverview/cashManagementOverviewSelector.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCashManagementOverview = exports.getCashManagementOverviewBanner = void 0;
 const amount_1 = require("../../../../commonStateTypes/amount");
 const reduceFetchState_1 = require("../../../../commonStateTypes/reduceFetchState");
+const depositAccountSelector_1 = require("../../../../entity/depositAccount/depositAccountSelector");
+const setupViewSelector_1 = require("../../commonSetup/setupViewSelector");
 /**
  * Default account type used when the recommend payload has no movement to
  * expose yet (e.g. before the first fetch resolves). Callers that care about
@@ -21,6 +23,26 @@ const getCashManagementOverviewBanner = (state) => {
         { fetchState: banner.fetchState, error: banner.error },
         { fetchState: autoSweep.fetchState, error: autoSweep.error },
     ]);
+    const subMovementType = movement?.subMovementType ?? DEFAULT_SUB_MOVEMENT_TYPE;
+    // The "primary" account is the deposit-account side of the movement —
+    // source for a push (money leaving primary → treasury) and destination
+    // for a pull (money returning to primary).
+    const primaryAccountId = subMovementType === 'pull'
+        ? movement?.destinationBankAccountId
+        : movement?.sourceBankAccountId;
+    const primaryDepositAccount = primaryAccountId != null && primaryAccountId !== ''
+        ? (0, depositAccountSelector_1.getDepositAccountByDepositAccountId)(state.depositAccountState, primaryAccountId)
+        : undefined;
+    const primaryFundingAccount = primaryDepositAccount != null
+        ? (0, setupViewSelector_1.mapDepositAccToFundingAccount)(primaryDepositAccount)
+        : undefined;
+    // For pull, surface the largest outflow in the horizon as the
+    // "triggering" event. This is a heuristic — the agent doesn't tag a
+    // specific outflow today, but the largest one is the most likely cause
+    // of the buffer breach and matches what the design wants to highlight.
+    const triggeringOutflow = subMovementType === 'pull'
+        ? pickLargestOutflow(banner.data?.outflows)
+        : undefined;
     return {
         fetchState: aggregate.fetchState,
         error: aggregate.error,
@@ -31,11 +53,19 @@ const getCashManagementOverviewBanner = (state) => {
         reasoning: movement?.reasoning ?? '',
         sourceBankAccountId: movement?.sourceBankAccountId ?? '',
         sourceBankAccountType: movement?.sourceBankAccountType ?? DEFAULT_BANK_ACCOUNT_TYPE,
-        subMovementType: movement?.subMovementType ?? DEFAULT_SUB_MOVEMENT_TYPE,
+        subMovementType,
+        primaryFundingAccount,
+        triggeringOutflow,
         version: 0,
     };
 };
 exports.getCashManagementOverviewBanner = getCashManagementOverviewBanner;
+const pickLargestOutflow = (outflows) => {
+    if (outflows == null || outflows.length === 0) {
+        return undefined;
+    }
+    return outflows.reduce((largest, event) => event.amount.amount > largest.amount.amount ? event : largest);
+};
 const getCashManagementOverview = (state) => {
     const { cashManagementOverviewState, depositAccountListState, depositAccountState, paymentAccountListState, paymentAccountState, treasuryDetailState, } = state;
     const aggregate = (0, reduceFetchState_1.reduceAllFetchState)([

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeniai/client-epic-state",
-  "version": "5.0.87-betaAK1",
+  "version": "5.0.87-betaAK2",
   "description": "Shared module between Web & Mobile containing required abstractions for state management, async network communication. ",
   "main": "lib/index.js",
   "module": "lib/esm/index.js",