@zeniai/client-epic-state 5.0.92 → 5.0.93-betaAK1

package/lib/view/spendManagement/cashManagement/cashManagementOverview/epics/fetchCashManagementBannerEpic.d.ts

@@ -0,0 +1,23 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { RootState } from '../../../../../reducer';
+import { fetchCashManagementSettings } from '../../autoSweepFlow/autoSweepFlowReducer';
+import { fetchCashManagementBanner, fetchCashManagementRecommendation, fetchRecentTransfer } from '../cashManagementOverviewReducer';
+export type ActionType = ReturnType<typeof fetchCashManagementBanner> | ReturnType<typeof fetchCashManagementRecommendation> | ReturnType<typeof fetchCashManagementSettings> | ReturnType<typeof fetchRecentTransfer>;
+/**
+ * Single public entry point for the cash-management banner data. Fans out
+ * to the three independent API calls that back the banner — recommendation
+ * (`/cash-agent/recommend`), settings (`/cash-management/settings`), and
+ * recent transfer (`/cash-management/transfers`) — in parallel. Consumers
+ * (`<CashManagementBanner>`, the page-fetch epic, the standalone
+ * `useCashManagementBanner` hook) only dispatch this one action; this epic
+ * owns the orchestration so the host apps don't have to know which inner
+ * endpoints exist.
+ *
+ * `cacheOverride === true` forces all three inner fetches regardless of
+ * slice state — the page-fetch epic relies on this to actually refresh
+ * the banner on a hard reload. `cacheOverride === false` keeps per-slice
+ * dedup: an inner action is only dispatched when its slice isn't already
+ * `Completed` or `In-Progress`.
+ */
+export declare const fetchCashManagementBannerEpic: (actions$: ActionsObservable<ActionType>, state$: StateObservable<RootState>) => Observable<ActionType>;

package/lib/view/spendManagement/cashManagement/cashManagementOverview/epics/fetchCashManagementBannerEpic.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchCashManagementBannerEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const autoSweepFlowReducer_1 = require("../../autoSweepFlow/autoSweepFlowReducer");
+const cashManagementOverviewReducer_1 = require("../cashManagementOverviewReducer");
+/**
+ * Single public entry point for the cash-management banner data. Fans out
+ * to the three independent API calls that back the banner — recommendation
+ * (`/cash-agent/recommend`), settings (`/cash-management/settings`), and
+ * recent transfer (`/cash-management/transfers`) — in parallel. Consumers
+ * (`<CashManagementBanner>`, the page-fetch epic, the standalone
+ * `useCashManagementBanner` hook) only dispatch this one action; this epic
+ * owns the orchestration so the host apps don't have to know which inner
+ * endpoints exist.
+ *
+ * `cacheOverride === true` forces all three inner fetches regardless of
+ * slice state — the page-fetch epic relies on this to actually refresh
+ * the banner on a hard reload. `cacheOverride === false` keeps per-slice
+ * dedup: an inner action is only dispatched when its slice isn't already
+ * `Completed` or `In-Progress`.
+ */
+const fetchCashManagementBannerEpic = (actions$, state$) => actions$.pipe((0, operators_1.filter)(cashManagementOverviewReducer_1.fetchCashManagementBanner.match), (0, operators_1.mergeMap)((action) => {
+    const { cacheOverride } = action.payload;
+    const state = state$.value;
+    const actions = [];
+    if (cacheOverride === true ||
+        needsFetch(state.cashManagementOverviewState.banner.fetchState)) {
+        actions.push((0, cashManagementOverviewReducer_1.fetchCashManagementRecommendation)());
+    }
+    if (cacheOverride === true ||
+        needsFetch(state.autoSweepFlowState.fetchState)) {
+        actions.push((0, autoSweepFlowReducer_1.fetchCashManagementSettings)());
+    }
+    if (cacheOverride === true ||
+        needsFetch(state.cashManagementOverviewState.recentTransfer.fetchState)) {
+        actions.push((0, cashManagementOverviewReducer_1.fetchRecentTransfer)());
+    }
+    return (0, rxjs_1.from)(actions);
+}));
+exports.fetchCashManagementBannerEpic = fetchCashManagementBannerEpic;
+const needsFetch = (fetchState) => fetchState !== 'Completed' && fetchState !== 'In-Progress';

package/lib/view/spendManagement/cashManagement/cashManagementOverview/epics/fetchCashManagementOverviewPageEpic.d.ts

@@ -0,0 +1,9 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { RootState } from '../../../../../reducer';
+import { fetchAutoTransferRules } from '../../../autotransferRules/autoTransferRulesReducer';
+import { fetchTreasuryOverviewDetail } from '../../../treasury/treasuryList/treasuryDetailReducer';
+import { fetchZeniAccountList } from '../../../zeniAccounts/zeniAccountList/zeniAccountListReducer';
+import { fetchCashManagementBanner, fetchCashManagementOverviewPage } from '../cashManagementOverviewReducer';
+export type ActionType = ReturnType<typeof fetchCashManagementOverviewPage> | ReturnType<typeof fetchTreasuryOverviewDetail> | ReturnType<typeof fetchZeniAccountList> | ReturnType<typeof fetchCashManagementBanner> | ReturnType<typeof fetchAutoTransferRules>;
+export declare const fetchCashManagementOverviewPageEpic: (actions$: ActionsObservable<ActionType>, state$: StateObservable<RootState>) => Observable<ActionType>;

package/lib/view/spendManagement/cashManagement/cashManagementOverview/epics/fetchCashManagementOverviewPageEpic.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchCashManagementOverviewPageEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const autoTransferRulesReducer_1 = require("../../../autotransferRules/autoTransferRulesReducer");
+const treasuryDetailReducer_1 = require("../../../treasury/treasuryList/treasuryDetailReducer");
+const zeniAccountListReducer_1 = require("../../../zeniAccounts/zeniAccountList/zeniAccountListReducer");
+const cashManagementOverviewReducer_1 = require("../cashManagementOverviewReducer");
+const fetchCashManagementOverviewPageEpic = (actions$, state$) => actions$.pipe((0, operators_1.filter)(cashManagementOverviewReducer_1.fetchCashManagementOverviewPage.match), (0, operators_1.mergeMap)((action) => {
+    const { cacheOverride } = action.payload;
+    const state = state$.value;
+    const pageActions = [];
+    if (cacheOverride === true) {
+        // Banner orchestrator (fetchCashManagementBannerEpic) fans out to
+        // recommendation + settings + recent-transfer internally.
+        pageActions.push((0, treasuryDetailReducer_1.fetchTreasuryOverviewDetail)(true), (0, zeniAccountListReducer_1.fetchZeniAccountList)(true), (0, cashManagementOverviewReducer_1.fetchCashManagementBanner)(true), (0, autoTransferRulesReducer_1.fetchAutoTransferRules)(true));
+    }
+    else {
+        const treasuryDetailState = state.treasuryDetailState;
+        if (treasuryDetailState.hasValidState() === false &&
+            treasuryDetailState.fetchState !== 'In-Progress') {
+            pageActions.push((0, treasuryDetailReducer_1.fetchTreasuryOverviewDetail)(false));
+        }
+        // zeniAccountListState has no top-level fetchState to dedup against
+        // (only `newCheckingAccount.fetchState`), and the downstream epic is
+        // cheap. Always re-dispatch so the summary stays fresh on page entry.
+        pageActions.push((0, zeniAccountListReducer_1.fetchZeniAccountList)(false));
+        // Banner orchestrator handles its own per-slice dedup across
+        // recommendation, settings, and recent-transfer.
+        pageActions.push((0, cashManagementOverviewReducer_1.fetchCashManagementBanner)(false));
+        const autoTransferRules = state.autotransferRulesState;
+        if (autoTransferRules.fetchState !== 'Completed' &&
+            autoTransferRules.fetchState !== 'In-Progress') {
+            pageActions.push((0, autoTransferRulesReducer_1.fetchAutoTransferRules)(false));
+        }
+    }
+    return (0, rxjs_1.concat)((0, rxjs_1.from)(pageActions));
+}));
+exports.fetchCashManagementOverviewPageEpic = fetchCashManagementOverviewPageEpic;

package/lib/view/spendManagement/cashManagement/cashManagementOverview/epics/fetchCashManagementRecommendationEpic.d.ts

@@ -0,0 +1,7 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { RootState } from '../../../../../reducer';
+import { ZeniAPI } from '../../../../../zeniAPI';
+import { fetchCashManagementRecommendation, updateCashManagementRecommendation, updateCashManagementRecommendationFetchStatus } from '../cashManagementOverviewReducer';
+export type ActionType = ReturnType<typeof fetchCashManagementRecommendation> | ReturnType<typeof updateCashManagementRecommendation> | ReturnType<typeof updateCashManagementRecommendationFetchStatus>;
+export declare const fetchCashManagementRecommendationEpic: (actions$: ActionsObservable<ActionType>, _state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

package/lib/view/spendManagement/cashManagement/cashManagementOverview/epics/fetchCashManagementRecommendationEpic.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchCashManagementRecommendationEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const responsePayload_1 = require("../../../../../responsePayload");
+const cashManagementOverviewReducer_1 = require("../cashManagementOverviewReducer");
+/**
+ * Hits the cash agent's recommend endpoint and stores the full response on
+ * the banner state — `inflows[]`, `outflows[]`, and `money_movements[]` all
+ * live there, so consumers can read them directly without an entity-bucket
+ * lookup.
+ */
+const DEFAULT_RECOMMEND_HORIZON_DAYS = 30;
+const fetchCashManagementRecommendationEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(cashManagementOverviewReducer_1.fetchCashManagementRecommendation.match), (0, operators_1.switchMap)(() => {
+    const endpoint = `${zeniAPI.apiEndPoints.cashManagementAgentBaseUrl}/1.0/cash-agent/recommend?horizon_days=${DEFAULT_RECOMMEND_HORIZON_DAYS}`;
+    return zeniAPI.getJSON(endpoint).pipe((0, operators_1.mergeMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response) && response.data != null) {
+            return (0, rxjs_1.of)((0, cashManagementOverviewReducer_1.updateCashManagementRecommendation)({ data: response.data }));
+        }
+        return (0, rxjs_1.of)((0, cashManagementOverviewReducer_1.updateCashManagementRecommendationFetchStatus)({
+            fetchState: 'Error',
+            error: response.status,
+        }));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, cashManagementOverviewReducer_1.updateCashManagementRecommendationFetchStatus)({
+        fetchState: 'Error',
+        error: (0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Fetch cash management recommendation REST API call errored out: ' +
+            (error?.message ?? String(error))),
+    }))));
+}));
+exports.fetchCashManagementRecommendationEpic = fetchCashManagementRecommendationEpic;

package/lib/view/spendManagement/cashManagement/cashManagementOverview/epics/fetchRecentTransferEpic.d.ts

@@ -0,0 +1,15 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { RootState } from '../../../../../reducer';
+import { ZeniAPI } from '../../../../../zeniAPI';
+import { fetchRecentTransfer, updateRecentTransfer, updateRecentTransferFetchStatus } from '../cashManagementOverviewReducer';
+export type ActionType = ReturnType<typeof fetchRecentTransfer> | ReturnType<typeof updateRecentTransfer> | ReturnType<typeof updateRecentTransferFetchStatus>;
+/**
+ * Hits `GET /cash-management/transfers` and stores the most recent actual
+ * cash-management transfer on `recentTransfer.data`. Used by the banner
+ * surface to render the "transfer scheduled / in-progress / complete"
+ * variant for existing users who have a settings id. The API returns the
+ * single most-relevant transfer under `transfer`; that field is optional
+ * (fresh users with no transfer history get `undefined`).
+ */
+export declare const fetchRecentTransferEpic: (actions$: ActionsObservable<ActionType>, _state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

package/lib/view/spendManagement/cashManagement/cashManagementOverview/epics/fetchRecentTransferEpic.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchRecentTransferEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const responsePayload_1 = require("../../../../../responsePayload");
+const cashManagementOverviewReducer_1 = require("../cashManagementOverviewReducer");
+/**
+ * Hits `GET /cash-management/transfers` and stores the most recent actual
+ * cash-management transfer on `recentTransfer.data`. Used by the banner
+ * surface to render the "transfer scheduled / in-progress / complete"
+ * variant for existing users who have a settings id. The API returns the
+ * single most-relevant transfer under `transfer`; that field is optional
+ * (fresh users with no transfer history get `undefined`).
+ */
+const fetchRecentTransferEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(cashManagementOverviewReducer_1.fetchRecentTransfer.match), (0, operators_1.switchMap)(() => {
+    const endpoint = `${zeniAPI.apiEndPoints.cashManagementAgentBaseUrl}/1.0/cash-management/transfers`;
+    return zeniAPI.getJSON(endpoint).pipe((0, operators_1.mergeMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response) && response.data != null) {
+            return (0, rxjs_1.of)((0, cashManagementOverviewReducer_1.updateRecentTransfer)({ data: response.data.transfer }));
+        }
+        return (0, rxjs_1.of)((0, cashManagementOverviewReducer_1.updateRecentTransferFetchStatus)({
+            fetchState: 'Error',
+            error: response.status,
+        }));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, cashManagementOverviewReducer_1.updateRecentTransferFetchStatus)({
+        fetchState: 'Error',
+        error: (0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Fetch recent cash-management transfer REST API call errored out: ' +
+            (error?.message ?? String(error))),
+    }))));
+}));
+exports.fetchRecentTransferEpic = fetchRecentTransferEpic;

package/lib/zeniAPI.d.ts

@@ -10,6 +10,7 @@ export interface RESTAPIEndpoints {
     readonly authMicroServiceBaseUrl: string;
     readonly bankingMicroServiceBaseUrl: string;
     readonly cardMicroServiceBaseUrl: string;
+    readonly cashManagementAgentBaseUrl: string;
     readonly communicationAgentMicroServiceBaseUrl: string;
     readonly documentAIMicroServiceBaseUrl: string;
     readonly fileMicroServiceBaseUrl: string;

package/package.json

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