@zeniai/client-epic-state 5.2.30 → 5.2.32-betaAK0

package/lib/view/cashFlowClassesView/cashFlowClassesViewSelector.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCashFlowClassesView = void 0;
+const getCOABalancesSlice_1 = require("../../commonStateTypes/coaBalance/getCOABalancesSlice");
+const reduceFetchState_1 = require("../../commonStateTypes/reduceFetchState");
+const sectionClassesViewSelector_1 = require("../../entity/sectionClassesViewV2/sectionClassesViewSelector");
+const cashFlowGroupedSectionOrder_1 = require("../cashFlow/cashFlowGroupedSectionOrder");
+const getCashFlowClassesView = (filter, accountState, classState, sectionsState, cashFlowClassesViewState) => {
+    const fetchState = (0, reduceFetchState_1.reduceFetchStateParallelTimeframes)([
+        cashFlowClassesViewState.fetchState.month,
+        cashFlowClassesViewState.fetchState.quarter,
+        cashFlowClassesViewState.fetchState.year,
+    ]);
+    const reportId = 'cash_flow_by_classes';
+    const sections = {};
+    const calculatedSections = {};
+    if (fetchState.fetchState === 'Completed') {
+        cashFlowGroupedSectionOrder_1.CASH_FLOW_GROUPED_BREAKDOWN_IDS.forEach((sectionId) => {
+            sections[sectionId] = (0, sectionClassesViewSelector_1.getSectionClassesViewReport)(accountState, classState, sectionsState, { reportId, sectionId }, filter);
+        });
+        // These come back grouped, so each figure is read through the section layer
+        // and arrives already pruned by the class/project picker — the same source
+        // the breakdown rows above render from, so the two can never disagree.
+        cashFlowGroupedSectionOrder_1.CASH_FLOW_GROUPED_CALCULATED_IDS.forEach((calculatedSectionId) => {
+            calculatedSections[calculatedSectionId] = (0, getCOABalancesSlice_1.getCOABalances)(
+            // Already built by the breakdown loop above; rebuilding it would repeat
+            // the whole section walk on every recompute.
+            sections[calculatedSectionId].sectionBalancesTotalByPeriod, filter);
+        });
+        calculatedSections['investingActivitiesTotal'] = (0, getCOABalancesSlice_1.getCOABalances)(sections['investingActivities'].sectionBalancesTotalByPeriod, filter);
+        calculatedSections['financingActivitiesTotal'] = (0, getCOABalancesSlice_1.getCOABalances)(sections['financingActivities'].sectionBalancesTotalByPeriod, filter);
+    }
+    return {
+        sections,
+        calculatedSections,
+        fetchState: fetchState.fetchState,
+        error: fetchState.error,
+        filter,
+        uiState: cashFlowClassesViewState.uiState,
+        classHierarchy: cashFlowClassesViewState.classHierarchy,
+        classesToFilterOut: cashFlowClassesViewState.uiState.classesToFilterOut,
+        reportId: cashFlowClassesViewState.reportId,
+        reportTitle: cashFlowClassesViewState.reportTitle,
+        firstMonthOfFY: cashFlowClassesViewState.firstMonthOfFY,
+        dataAvailable: cashFlowClassesViewState.dataAvailable,
+        bookCloseDate: cashFlowClassesViewState.bookCloseDate,
+        version: cashFlowClassesViewState.version,
+        status: cashFlowClassesViewState.status,
+        idsInOrder: cashFlowGroupedSectionOrder_1.CASH_FLOW_GROUPED_IDS_IN_ORDER,
+        rootSectionsWithSubSectionIds: {
+            operatingActivities: cashFlowGroupedSectionOrder_1.CASH_FLOW_GROUPED_OPERATING_IDS_IN_ORDER,
+            investingActivities: cashFlowGroupedSectionOrder_1.CASH_FLOW_GROUPED_INVESTING_IDS_IN_ORDER,
+            financingActivities: cashFlowGroupedSectionOrder_1.CASH_FLOW_GROUPED_FINANCING_IDS_IN_ORDER,
+        },
+    };
+};
+exports.getCashFlowClassesView = getCashFlowClassesView;

package/lib/view/cashFlowClassesView/cashFlowClassesViewSelectorTypes.d.ts

@@ -0,0 +1,15 @@
+import { ClassesViewSelectorReportV2 } from '../../commonStateTypes/selectorTypes/classesViewSelectorReport';
+import { SectionClassesViewReportV2 } from '../../entity/sectionClassesViewV2/sectionClassesViewSelectorTypes';
+import { CashFlowReportViewCalculatedSectionID, CashFlowReportViewSectionID } from '../cashFlow/cashFlowPayload';
+import { SectionIdsWithSubSectionIds } from '../cashFlow/cashFlowSelectorTypes';
+import { CashFlowClassesViewUIState } from './cashFlowClassesViewState';
+export interface CashFlowClassesViewReport extends ClassesViewSelectorReportV2<CashFlowReportViewSectionID, CashFlowReportViewCalculatedSectionID> {
+    rootSectionsWithSubSectionIds: SectionIdsWithSubSectionIds;
+    /**
+     * Widened over the base: the response groups net income, the operating total
+     * and change in cash too, so those calculated ids also arrive as sections and
+     * their rows render with a per-class breakdown.
+     */
+    sections: Record<CashFlowReportViewSectionID, SectionClassesViewReportV2> & Partial<Record<CashFlowReportViewCalculatedSectionID, SectionClassesViewReportV2>>;
+    uiState: CashFlowClassesViewUIState;
+}

package/lib/view/cashFlowClassesView/cashFlowClassesViewState.d.ts

@@ -0,0 +1,23 @@
+import { Currency } from '../../commonStateTypes/amount';
+import { NestedClassHierarchyForReport, NestedClassID } from '../../commonStateTypes/classesView/nestedClassID';
+import { AccountViewMode, FetchStateAndError, ID } from '../../commonStateTypes/common';
+import { Report } from '../../commonStateTypes/viewAndReport/viewAndReport';
+export interface CashFlowClassesViewUIState {
+    accountViewMode: AccountViewMode;
+    classesToFilterOut: NestedClassID[];
+    nodeCollapseState: Record<ID, boolean>;
+    scrollPosition: {
+        scrollTop: number;
+        scrollLeft?: number;
+    } | undefined;
+}
+export interface CashFlowClassesViewState extends Report {
+    classHierarchy: NestedClassHierarchyForReport[];
+    fetchState: {
+        month: FetchStateAndError;
+        quarter: FetchStateAndError;
+        year: FetchStateAndError;
+    };
+    uiState: CashFlowClassesViewUIState;
+    currency?: Currency;
+}

package/lib/view/cashFlowClassesView/cashFlowForTimeframeClassesViewEpic.d.ts

@@ -0,0 +1,9 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { updateSectionClassesView } from '../../entity/sectionClassesViewV2/sectionClassesViewReducer';
+import { RootState } from '../../reducer';
+import { ZeniAPI } from '../../zeniAPI';
+import { fetchCashFlowForTimeframeClassesView, updateCashFlowForTimeframeClassesView, updateCashFlowForTimeframeClassesViewFailure } from './cashFlowClassesViewReducer';
+export type ActionType = ReturnType<typeof fetchCashFlowForTimeframeClassesView> | ReturnType<typeof updateCashFlowForTimeframeClassesView> | ReturnType<typeof updateCashFlowForTimeframeClassesViewFailure> | ReturnType<typeof updateSectionClassesView>;
+export declare const reportIdUniqueKey: () => "cash_flow_by_classes";
+export declare const fetchCashFlowForTimeframeClassesViewEpic: (actions$: ActionsObservable<ActionType>, _: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

package/lib/view/cashFlowClassesView/cashFlowForTimeframeClassesViewEpic.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchCashFlowForTimeframeClassesViewEpic = exports.reportIdUniqueKey = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const sectionClassesViewReducer_1 = require("../../entity/sectionClassesViewV2/sectionClassesViewReducer");
+const responsePayload_1 = require("../../responsePayload");
+const cashFlowPayload_1 = require("../cashFlow/cashFlowPayload");
+const cashFlowClassesViewReducer_1 = require("./cashFlowClassesViewReducer");
+const getTimeSeriesGroup = (timeframe) => {
+    switch (timeframe) {
+        case 'month':
+            return 'months';
+        case 'quarter':
+            return 'quarters';
+        case 'year':
+            return 'years';
+    }
+};
+const reportIdUniqueKey = () => 'cash_flow_by_classes';
+exports.reportIdUniqueKey = reportIdUniqueKey;
+const fetchCashFlowForTimeframeClassesViewEpic = (actions$, _, zeniAPI) => actions$.pipe((0, operators_1.filter)(cashFlowClassesViewReducer_1.fetchCashFlowForTimeframeClassesView.match), (0, operators_1.mergeMap)((action) => {
+    const queryValue = {
+        is_full_response: true,
+        time_series_groups: [getTimeSeriesGroup(action.payload.timeframe)],
+        is_group_by_class: true,
+        // Only sent when refreshing: the flag makes the backend bypass its saved
+        // report and regenerate, so a normal lookup must not carry it.
+        ...(action.payload.cacheOverride === true
+            ? { is_hard_refresh: true }
+            : {}),
+    };
+    return zeniAPI
+        .getJSON(`${zeniAPI.apiEndPoints.accountMicroServiceBaseUrl}/2.0/reports/cash_flow?query=${encodeURIComponent(JSON.stringify(queryValue))}`)
+        .pipe((0, operators_1.mergeMap)((response) => {
+        if (response.data != null && (0, responsePayload_1.isSuccessResponse)(response)) {
+            const actions = [];
+            const { report } = response.data;
+            const currency = report.currency;
+            actions.push((0, sectionClassesViewReducer_1.updateSectionClassesView)(action.payload.timeframe, (0, cashFlowPayload_1.toCashFlowReportViewID)('adjustments'), (0, exports.reportIdUniqueKey)(), report.operating_activities.adjustments, report.classes, report.accounts, currency));
+            actions.push((0, sectionClassesViewReducer_1.updateSectionClassesView)(action.payload.timeframe, (0, cashFlowPayload_1.toCashFlowReportViewID)('investing_activities'), (0, exports.reportIdUniqueKey)(), report.investing_activities, report.classes, report.accounts, currency));
+            actions.push((0, sectionClassesViewReducer_1.updateSectionClassesView)(action.payload.timeframe, (0, cashFlowPayload_1.toCashFlowReportViewID)('financing_activities'), (0, exports.reportIdUniqueKey)(), report.financing_activities, report.classes, report.accounts, currency));
+            actions.push((0, sectionClassesViewReducer_1.updateSectionClassesView)(action.payload.timeframe, (0, cashFlowPayload_1.toCashFlowReportViewID)('net_income'), (0, exports.reportIdUniqueKey)(), report.operating_activities.net_income, report.classes, report.accounts, currency));
+            actions.push((0, sectionClassesViewReducer_1.updateSectionClassesView)(action.payload.timeframe, (0, cashFlowPayload_1.toCashFlowReportViewID)('operating_activities'), (0, exports.reportIdUniqueKey)(), report.operating_activities, report.classes, report.accounts, currency));
+            actions.push((0, sectionClassesViewReducer_1.updateSectionClassesView)(action.payload.timeframe, (0, cashFlowPayload_1.toCashFlowReportViewID)('change_in_cash_and_equivalents'), (0, exports.reportIdUniqueKey)(), report.change_in_cash_and_equivalents, report.classes, report.accounts, currency));
+            actions.push((0, cashFlowClassesViewReducer_1.updateCashFlowForTimeframeClassesView)({
+                timeframe: action.payload.timeframe,
+                report: response.data,
+            }));
+            return (0, rxjs_1.from)(actions);
+        }
+        else {
+            return (0, rxjs_1.of)((0, cashFlowClassesViewReducer_1.updateCashFlowForTimeframeClassesViewFailure)(response.status, action.payload.timeframe));
+        }
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, cashFlowClassesViewReducer_1.updateCashFlowForTimeframeClassesViewFailure)((0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Cash Flow by Class REST API call errored out: ' +
+        (error instanceof Error
+            ? error.message
+            : JSON.stringify(error))), action.payload.timeframe))));
+}));
+exports.fetchCashFlowForTimeframeClassesViewEpic = fetchCashFlowForTimeframeClassesViewEpic;

package/lib/view/cashFlowProjectView/cashFlowForTimeframeProjectViewEpic.d.ts

@@ -0,0 +1,10 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { updateProjects } from '../../entity/project/projectReducer';
+import { updateSectionProjectView } from '../../entity/sectionProjectView/sectionProjectViewReducer';
+import { RootState } from '../../reducer';
+import { ZeniAPI } from '../../zeniAPI';
+import { fetchCashFlowForTimeframeProjectView, updateCashFlowForTimeframeProjectView, updateCashFlowForTimeframeProjectViewFailure } from './cashFlowProjectViewReducer';
+export type ActionType = ReturnType<typeof fetchCashFlowForTimeframeProjectView> | ReturnType<typeof updateCashFlowForTimeframeProjectView> | ReturnType<typeof updateCashFlowForTimeframeProjectViewFailure> | ReturnType<typeof updateProjects> | ReturnType<typeof updateSectionProjectView>;
+export declare const reportIdUniqueKey: () => "cash_flow_by_projects";
+export declare const fetchCashFlowForTimeframeProjectViewEpic: (actions$: ActionsObservable<ActionType>, _: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

package/lib/view/cashFlowProjectView/cashFlowForTimeframeProjectViewEpic.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchCashFlowForTimeframeProjectViewEpic = exports.reportIdUniqueKey = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const projectReducer_1 = require("../../entity/project/projectReducer");
+const sectionProjectViewReducer_1 = require("../../entity/sectionProjectView/sectionProjectViewReducer");
+const responsePayload_1 = require("../../responsePayload");
+const cashFlowPayload_1 = require("../cashFlow/cashFlowPayload");
+const cashFlowProjectViewReducer_1 = require("./cashFlowProjectViewReducer");
+const getTimeSeriesGroup = (timeframe) => {
+    switch (timeframe) {
+        case 'month':
+            return 'months';
+        case 'quarter':
+            return 'quarters';
+        case 'year':
+            return 'years';
+    }
+};
+const reportIdUniqueKey = () => 'cash_flow_by_projects';
+exports.reportIdUniqueKey = reportIdUniqueKey;
+const fetchCashFlowForTimeframeProjectViewEpic = (actions$, _, zeniAPI) => actions$.pipe((0, operators_1.filter)(cashFlowProjectViewReducer_1.fetchCashFlowForTimeframeProjectView.match), (0, operators_1.mergeMap)((action) => {
+    const queryValue = {
+        is_full_response: true,
+        time_series_groups: [getTimeSeriesGroup(action.payload.timeframe)],
+        is_group_by_project: true,
+        // Only sent when refreshing: the flag makes the backend bypass its saved
+        // report and regenerate, so a normal lookup must not carry it.
+        ...(action.payload.cacheOverride === true
+            ? { is_hard_refresh: true }
+            : {}),
+    };
+    return zeniAPI
+        .getJSON(`${zeniAPI.apiEndPoints.accountMicroServiceBaseUrl}/2.0/reports/cash_flow?query=${encodeURIComponent(JSON.stringify(queryValue))}`)
+        .pipe((0, operators_1.mergeMap)((response) => {
+        if (response.data != null && (0, responsePayload_1.isSuccessResponse)(response)) {
+            const actions = [];
+            const { report } = response.data;
+            const currency = report.currency;
+            actions.push((0, projectReducer_1.updateProjects)(report.projects));
+            actions.push((0, sectionProjectViewReducer_1.updateSectionProjectView)(action.payload.timeframe, (0, cashFlowPayload_1.toCashFlowReportViewID)('adjustments'), (0, exports.reportIdUniqueKey)(), report.operating_activities.adjustments, report.accounts, currency));
+            actions.push((0, sectionProjectViewReducer_1.updateSectionProjectView)(action.payload.timeframe, (0, cashFlowPayload_1.toCashFlowReportViewID)('investing_activities'), (0, exports.reportIdUniqueKey)(), report.investing_activities, report.accounts, currency));
+            actions.push((0, sectionProjectViewReducer_1.updateSectionProjectView)(action.payload.timeframe, (0, cashFlowPayload_1.toCashFlowReportViewID)('financing_activities'), (0, exports.reportIdUniqueKey)(), report.financing_activities, report.accounts, currency));
+            actions.push((0, sectionProjectViewReducer_1.updateSectionProjectView)(action.payload.timeframe, (0, cashFlowPayload_1.toCashFlowReportViewID)('net_income'), (0, exports.reportIdUniqueKey)(), report.operating_activities.net_income, report.accounts, currency));
+            actions.push((0, sectionProjectViewReducer_1.updateSectionProjectView)(action.payload.timeframe, (0, cashFlowPayload_1.toCashFlowReportViewID)('operating_activities'), (0, exports.reportIdUniqueKey)(), report.operating_activities, report.accounts, currency));
+            actions.push((0, sectionProjectViewReducer_1.updateSectionProjectView)(action.payload.timeframe, (0, cashFlowPayload_1.toCashFlowReportViewID)('change_in_cash_and_equivalents'), (0, exports.reportIdUniqueKey)(), report.change_in_cash_and_equivalents, report.accounts, currency));
+            actions.push((0, cashFlowProjectViewReducer_1.updateCashFlowForTimeframeProjectView)({
+                timeframe: action.payload.timeframe,
+                report: response.data,
+            }));
+            return (0, rxjs_1.from)(actions);
+        }
+        else {
+            return (0, rxjs_1.of)((0, cashFlowProjectViewReducer_1.updateCashFlowForTimeframeProjectViewFailure)(response.status, action.payload.timeframe));
+        }
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, cashFlowProjectViewReducer_1.updateCashFlowForTimeframeProjectViewFailure)((0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Cash Flow by Project REST API call errored out: ' +
+        (error instanceof Error
+            ? error.message
+            : JSON.stringify(error))), action.payload.timeframe))));
+}));
+exports.fetchCashFlowForTimeframeProjectViewEpic = fetchCashFlowForTimeframeProjectViewEpic;

package/lib/view/cashFlowProjectView/cashFlowProjectViewEpic.d.ts

@@ -0,0 +1,6 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { RootState } from '../../reducer';
+import { fetchCashFlowForTimeframeProjectView, fetchCashFlowProjectView } from './cashFlowProjectViewReducer';
+export type ActionType = ReturnType<typeof fetchCashFlowProjectView> | ReturnType<typeof fetchCashFlowForTimeframeProjectView>;
+export declare const fetchCashFlowProjectViewEpic: (actions$: ActionsObservable<ActionType>, state: StateObservable<RootState>) => Observable<ActionType>;

package/lib/view/cashFlowProjectView/cashFlowProjectViewEpic.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchCashFlowProjectViewEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const cashFlowProjectViewReducer_1 = require("./cashFlowProjectViewReducer");
+const fetchCashFlowProjectViewEpic = (actions$, state) => actions$.pipe((0, operators_1.filter)(cashFlowProjectViewReducer_1.fetchCashFlowProjectView.match), (0, operators_1.switchMap)((action) => {
+    const { cacheOverride } = action.payload;
+    if (cacheOverride === true) {
+        return (0, rxjs_1.from)([
+            (0, cashFlowProjectViewReducer_1.fetchCashFlowForTimeframeProjectView)('month', true),
+            (0, cashFlowProjectViewReducer_1.fetchCashFlowForTimeframeProjectView)('quarter', true),
+            (0, cashFlowProjectViewReducer_1.fetchCashFlowForTimeframeProjectView)('year', true),
+        ]);
+    }
+    else {
+        const fetchActions = [];
+        const projectFetchState = state.value.cashFlowProjectViewState.fetchState;
+        if (projectFetchState['month'].fetchState !== 'In-Progress' &&
+            projectFetchState['month'].fetchState !== 'Completed') {
+            fetchActions.push((0, cashFlowProjectViewReducer_1.fetchCashFlowForTimeframeProjectView)('month'));
+        }
+        if (projectFetchState['quarter'].fetchState !== 'In-Progress' &&
+            projectFetchState['quarter'].fetchState !== 'Completed') {
+            fetchActions.push((0, cashFlowProjectViewReducer_1.fetchCashFlowForTimeframeProjectView)('quarter'));
+        }
+        if (projectFetchState['year'].fetchState !== 'In-Progress' &&
+            projectFetchState['year'].fetchState !== 'Completed') {
+            fetchActions.push((0, cashFlowProjectViewReducer_1.fetchCashFlowForTimeframeProjectView)('year'));
+        }
+        return (0, rxjs_1.from)(fetchActions);
+    }
+}));
+exports.fetchCashFlowProjectViewEpic = fetchCashFlowProjectViewEpic;

package/lib/view/cashFlowProjectView/cashFlowProjectViewPayload.d.ts

@@ -0,0 +1,14 @@
+import { ZeniReportResponse } from '../../responsePayload';
+import { ReportByProjectMetadataPayloadV2, SectionByProjectCOABalanceGroupedPayloadV2 } from '../profitAndLossProjectView/profitAndLossProjectViewPayload';
+interface OperatingActivitiesProjectView {
+    adjustments: SectionByProjectCOABalanceGroupedPayloadV2;
+    net_income: SectionByProjectCOABalanceGroupedPayloadV2;
+}
+export interface CashFlowProjectViewPayload extends ReportByProjectMetadataPayloadV2 {
+    change_in_cash_and_equivalents: SectionByProjectCOABalanceGroupedPayloadV2;
+    financing_activities: SectionByProjectCOABalanceGroupedPayloadV2;
+    investing_activities: SectionByProjectCOABalanceGroupedPayloadV2;
+    operating_activities: SectionByProjectCOABalanceGroupedPayloadV2 & OperatingActivitiesProjectView;
+}
+export type CashFlowReportProjectViewResponse = ZeniReportResponse<CashFlowProjectViewPayload>;
+export {};

package/lib/view/cashFlowProjectView/cashFlowProjectViewReducer.d.ts

@@ -0,0 +1,33 @@
+import { AccountViewMode, ID } from '../../commonStateTypes/common';
+import { ZeniAPIStatus, ZeniReportData } from '../../responsePayload';
+import { CashFlowProjectViewPayload } from './cashFlowProjectViewPayload';
+import { CashFlowProjectViewState } from './cashFlowProjectViewState';
+export declare const initialState: CashFlowProjectViewState;
+export declare const fetchCashFlowProjectView: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[cacheOverride?: boolean | undefined], {
+    cacheOverride: boolean;
+}, "cashFlowProjectView/fetchCashFlowProjectView", never, never>, fetchCashFlowForTimeframeProjectView: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[timeframe: "month" | "year" | "quarter", cacheOverride?: boolean | undefined], {
+    timeframe: "month" | "year" | "quarter";
+    cacheOverride: boolean;
+}, "cashFlowProjectView/fetchCashFlowForTimeframeProjectView", never, never>, updateCashFlowForTimeframeProjectView: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    report: ZeniReportData<CashFlowProjectViewPayload>;
+    timeframe: "month" | "quarter" | "year";
+}, "cashFlowProjectView/updateCashFlowForTimeframeProjectView">, updateCashFlowForTimeframeProjectViewFailure: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[error: ZeniAPIStatus<Record<string, unknown>>, timeframe: "month" | "year" | "quarter"], {
+    error: ZeniAPIStatus<Record<string, unknown>>;
+    timeframe: "month" | "year" | "quarter";
+}, "cashFlowProjectView/updateCashFlowForTimeframeProjectViewFailure", never, never>, updateCashFlowProjectsToFilterOut: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    projectsToFilterOut: ID[];
+}, "cashFlowProjectView/updateCashFlowProjectsToFilterOut">, updateCashFlowProjectViewUIState: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    nodeCollapseState?: {
+        isCollapsed: boolean;
+        nodeId: ID;
+    };
+    resetLeftScroll?: boolean;
+    scrollPosition?: {
+        scrollTop: number;
+        scrollLeft?: number;
+    };
+}, "cashFlowProjectView/updateCashFlowProjectViewUIState">, updateCashFlowProjectViewAccountViewMode: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    viewMode: AccountViewMode;
+}, "cashFlowProjectView/updateCashFlowProjectViewAccountViewMode">, resetCashFlowProjectNodeCollapseState: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"cashFlowProjectView/resetCashFlowProjectNodeCollapseState">;
+declare const _default: import("redux").Reducer<CashFlowProjectViewState>;
+export default _default;

package/lib/view/cashFlowProjectView/cashFlowProjectViewReducer.js

@@ -0,0 +1,129 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resetCashFlowProjectNodeCollapseState = exports.updateCashFlowProjectViewAccountViewMode = exports.updateCashFlowProjectViewUIState = exports.updateCashFlowProjectsToFilterOut = exports.updateCashFlowForTimeframeProjectViewFailure = exports.updateCashFlowForTimeframeProjectView = exports.fetchCashFlowForTimeframeProjectView = exports.fetchCashFlowProjectView = exports.initialState = void 0;
+const toolkit_1 = require("@reduxjs/toolkit");
+const viewAndReportPayloadv2_1 = require("../../commonPayloadTypes/v2/viewAndReportPayloadv2");
+const rootActions_1 = require("../../rootActions");
+exports.initialState = {
+    bookCloseDate: undefined,
+    fetchState: {
+        month: {
+            fetchState: 'Not-Started',
+            error: undefined,
+        },
+        quarter: {
+            fetchState: 'Not-Started',
+            error: undefined,
+        },
+        year: {
+            fetchState: 'Not-Started',
+            error: undefined,
+        },
+    },
+    firstMonthOfFY: 1,
+    projectIds: [],
+    reportId: 'cash_flow_by_projects',
+    reportTitle: 'cash_flow_by_projects',
+    uiState: {
+        accountViewMode: 'account_group',
+        nodeCollapseState: {},
+        projectsToFilterOut: [],
+        scrollPosition: undefined,
+    },
+};
+const cashFlowProjectView = (0, toolkit_1.createSlice)({
+    name: 'cashFlowProjectView',
+    initialState: exports.initialState,
+    reducers: {
+        fetchCashFlowProjectView: {
+            prepare(cacheOverride = false) {
+                return { payload: { cacheOverride } };
+            },
+            reducer(
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            _draft, 
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            _action) {
+                // nothing to do here
+            },
+        },
+        fetchCashFlowForTimeframeProjectView: {
+            prepare(timeframe, cacheOverride = false) {
+                return { payload: { timeframe, cacheOverride } };
+            },
+            reducer(draft, action) {
+                const timeframe = action.payload.timeframe;
+                draft.fetchState[timeframe].fetchState = 'In-Progress';
+                draft.fetchState[timeframe].error = undefined;
+            },
+        },
+        updateCashFlowForTimeframeProjectView(draft, action) {
+            doUpdateCashFlowProjectView(draft, action.payload.timeframe, action.payload.report);
+        },
+        updateCashFlowForTimeframeProjectViewFailure: {
+            prepare(error, timeframe) {
+                return {
+                    payload: {
+                        error,
+                        timeframe,
+                    },
+                };
+            },
+            reducer(draft, action) {
+                draft.fetchState[action.payload.timeframe] = {
+                    fetchState: 'Error',
+                    error: action.payload.error,
+                };
+            },
+        },
+        updateCashFlowProjectsToFilterOut(draft, action) {
+            draft.uiState.projectsToFilterOut = action.payload.projectsToFilterOut;
+        },
+        updateCashFlowProjectViewUIState(draft, action) {
+            const { nodeCollapseState, scrollPosition, resetLeftScroll } = action.payload;
+            if (nodeCollapseState != null) {
+                draft.uiState.nodeCollapseState = Object.assign({}, draft.uiState.nodeCollapseState, {
+                    [nodeCollapseState.nodeId]: nodeCollapseState.isCollapsed,
+                });
+            }
+            // Mutually exclusive: resetLeftScroll clears only scrollLeft from the
+            // recorded position, scrollPosition replaces the whole record.
+            if (resetLeftScroll === true && draft.uiState.scrollPosition != null) {
+                draft.uiState.scrollPosition.scrollLeft = undefined;
+            }
+            else if (scrollPosition != null) {
+                draft.uiState.scrollPosition = scrollPosition;
+            }
+        },
+        updateCashFlowProjectViewAccountViewMode(draft, action) {
+            draft.uiState.accountViewMode = action.payload.viewMode;
+        },
+        resetCashFlowProjectNodeCollapseState(draft) {
+            draft.uiState.nodeCollapseState = {};
+        },
+    },
+    extraReducers: (builder) => {
+        builder.addCase(rootActions_1.clearAll, (draft) => {
+            Object.assign(draft, exports.initialState);
+        });
+    },
+});
+_a = cashFlowProjectView.actions, exports.fetchCashFlowProjectView = _a.fetchCashFlowProjectView, exports.fetchCashFlowForTimeframeProjectView = _a.fetchCashFlowForTimeframeProjectView, exports.updateCashFlowForTimeframeProjectView = _a.updateCashFlowForTimeframeProjectView, exports.updateCashFlowForTimeframeProjectViewFailure = _a.updateCashFlowForTimeframeProjectViewFailure, exports.updateCashFlowProjectsToFilterOut = _a.updateCashFlowProjectsToFilterOut, exports.updateCashFlowProjectViewUIState = _a.updateCashFlowProjectViewUIState, exports.updateCashFlowProjectViewAccountViewMode = _a.updateCashFlowProjectViewAccountViewMode, exports.resetCashFlowProjectNodeCollapseState = _a.resetCashFlowProjectNodeCollapseState;
+exports.default = cashFlowProjectView.reducer;
+const doUpdateCashFlowProjectView = (draft, timeframe, cashFlowReport) => {
+    const report = (0, viewAndReportPayloadv2_1.mapReportPayloadV2ToReportV2)(cashFlowReport.report);
+    draft.currency = report.currency;
+    draft.dataAvailable = report.dataAvailable;
+    draft.firstMonthOfFY = report.firstMonthOfFY;
+    draft.bookCloseDate = report.bookCloseDate;
+    draft.status = report.status;
+    draft.fetchState[timeframe].fetchState = 'Completed';
+    draft.fetchState[timeframe].error = undefined;
+    // Populated once, as with classHierarchy in the classes view: a project added
+    // mid-session is not picked up until the store is cleared, even by a hard
+    // refresh. Matches profitAndLossProjectViewReducer.
+    if (draft.projectIds.length <= 0) {
+        draft.projectIds = cashFlowReport.report.projects.map((project) => project.accounting_project_id);
+    }
+};

package/lib/view/cashFlowProjectView/cashFlowProjectViewSelector.d.ts

@@ -0,0 +1,7 @@
+import { COABalancesFilterProjectView } from '../../commonStateTypes/coaBalance/coaBalancesFilterProjectView';
+import { AccountState } from '../../entity/account/accountState';
+import { ProjectState } from '../../entity/project/projectReducer';
+import { SectionProjectViewState } from '../../entity/sectionProjectView/sectionProjectViewState';
+import { CashFlowProjectViewReport } from './cashFlowProjectViewSelectorTypes';
+import { CashFlowProjectViewState } from './cashFlowProjectViewState';
+export declare const getCashFlowProjectView: (filter: COABalancesFilterProjectView, accountState: AccountState, projectState: ProjectState, sectionsState: SectionProjectViewState, cashFlowProjectViewState: CashFlowProjectViewState) => CashFlowProjectViewReport;

package/lib/view/cashFlowProjectView/cashFlowProjectViewSelector.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCashFlowProjectView = void 0;
+const getCOABalancesSlice_1 = require("../../commonStateTypes/coaBalance/getCOABalancesSlice");
+const reduceFetchState_1 = require("../../commonStateTypes/reduceFetchState");
+const projectSelector_1 = require("../../entity/project/projectSelector");
+const sectionProjectViewSelector_1 = require("../../entity/sectionProjectView/sectionProjectViewSelector");
+const cashFlowGroupedSectionOrder_1 = require("../cashFlow/cashFlowGroupedSectionOrder");
+const getCashFlowProjectView = (filter, accountState, projectState, sectionsState, cashFlowProjectViewState) => {
+    const fetchState = (0, reduceFetchState_1.reduceFetchStateParallelTimeframes)([
+        cashFlowProjectViewState.fetchState.month,
+        cashFlowProjectViewState.fetchState.quarter,
+        cashFlowProjectViewState.fetchState.year,
+    ]);
+    const reportId = 'cash_flow_by_projects';
+    const sections = {};
+    const calculatedSections = {};
+    if (fetchState.fetchState === 'Completed') {
+        cashFlowGroupedSectionOrder_1.CASH_FLOW_GROUPED_BREAKDOWN_IDS.forEach((sectionId) => {
+            sections[sectionId] = (0, sectionProjectViewSelector_1.getSectionProjectViewReport)(accountState, projectState, sectionsState, cashFlowProjectViewState.projectIds, { reportId, sectionId }, filter);
+        });
+        // These come back grouped, so each figure is read through the section layer
+        // and arrives already pruned by the class/project picker — the same source
+        // the breakdown rows above render from, so the two can never disagree.
+        cashFlowGroupedSectionOrder_1.CASH_FLOW_GROUPED_CALCULATED_IDS.forEach((calculatedSectionId) => {
+            calculatedSections[calculatedSectionId] = (0, getCOABalancesSlice_1.getCOABalances)(
+            // Already built by the breakdown loop above; rebuilding it would repeat
+            // the whole section walk on every recompute.
+            sections[calculatedSectionId].sectionBalancesTotalByPeriod, filter);
+        });
+        calculatedSections['investingActivitiesTotal'] = (0, getCOABalancesSlice_1.getCOABalances)(sections['investingActivities'].sectionBalancesTotalByPeriod, filter);
+        calculatedSections['financingActivitiesTotal'] = (0, getCOABalancesSlice_1.getCOABalances)(sections['financingActivities'].sectionBalancesTotalByPeriod, filter);
+    }
+    return {
+        sections,
+        calculatedSections,
+        fetchState: fetchState.fetchState,
+        error: fetchState.error,
+        filter,
+        uiState: cashFlowProjectViewState.uiState,
+        projects: (0, projectSelector_1.getProjectsByIds)(projectState, cashFlowProjectViewState.projectIds),
+        projectsToFilterOut: cashFlowProjectViewState.uiState.projectsToFilterOut,
+        reportId: cashFlowProjectViewState.reportId,
+        reportTitle: cashFlowProjectViewState.reportTitle,
+        firstMonthOfFY: cashFlowProjectViewState.firstMonthOfFY,
+        dataAvailable: cashFlowProjectViewState.dataAvailable,
+        bookCloseDate: cashFlowProjectViewState.bookCloseDate,
+        version: cashFlowProjectViewState.version,
+        status: cashFlowProjectViewState.status,
+        idsInOrder: cashFlowGroupedSectionOrder_1.CASH_FLOW_GROUPED_IDS_IN_ORDER,
+        rootSectionsWithSubSectionIds: {
+            operatingActivities: cashFlowGroupedSectionOrder_1.CASH_FLOW_GROUPED_OPERATING_IDS_IN_ORDER,
+            investingActivities: cashFlowGroupedSectionOrder_1.CASH_FLOW_GROUPED_INVESTING_IDS_IN_ORDER,
+            financingActivities: cashFlowGroupedSectionOrder_1.CASH_FLOW_GROUPED_FINANCING_IDS_IN_ORDER,
+        },
+    };
+};
+exports.getCashFlowProjectView = getCashFlowProjectView;

package/lib/view/cashFlowProjectView/cashFlowProjectViewSelectorTypes.d.ts

@@ -0,0 +1,19 @@
+import { COABalancesFilterProjectView } from '../../commonStateTypes/coaBalance/coaBalancesFilterProjectView';
+import { ID } from '../../commonStateTypes/common';
+import { CalculatedSection } from '../../commonStateTypes/selectorTypes/selectorTypes';
+import { SelectorReport } from '../../commonStateTypes/viewAndReport/viewAndReport';
+import { Project } from '../../entity/project/projectState';
+import { SectionProjectViewReport } from '../../entity/sectionProjectView/sectionProjectViewSelectorTypes';
+import { CashFlowReportViewCalculatedSectionID, CashFlowReportViewSectionID } from '../cashFlow/cashFlowPayload';
+import { SectionIdsWithSubSectionIds } from '../cashFlow/cashFlowSelectorTypes';
+import { CashFlowProjectViewUIState } from './cashFlowProjectViewState';
+export interface CashFlowProjectViewReport extends SelectorReport {
+    calculatedSections: Record<CashFlowReportViewCalculatedSectionID, CalculatedSection>;
+    filter: COABalancesFilterProjectView;
+    idsInOrder: (CashFlowReportViewSectionID | CashFlowReportViewCalculatedSectionID)[];
+    projects: Project[];
+    projectsToFilterOut: ID[];
+    rootSectionsWithSubSectionIds: SectionIdsWithSubSectionIds;
+    sections: Record<CashFlowReportViewSectionID, SectionProjectViewReport> & Partial<Record<CashFlowReportViewCalculatedSectionID, SectionProjectViewReport>>;
+    uiState: CashFlowProjectViewUIState;
+}

package/lib/view/cashFlowProjectView/cashFlowProjectViewState.d.ts

@@ -0,0 +1,22 @@
+import { Currency } from '../../commonStateTypes/amount';
+import { AccountViewMode, FetchStateAndError, ID } from '../../commonStateTypes/common';
+import { Report } from '../../commonStateTypes/viewAndReport/viewAndReport';
+export interface CashFlowProjectViewUIState {
+    accountViewMode: AccountViewMode;
+    nodeCollapseState: Record<ID, boolean>;
+    projectsToFilterOut: ID[];
+    scrollPosition: {
+        scrollTop: number;
+        scrollLeft?: number;
+    } | undefined;
+}
+export interface CashFlowProjectViewState extends Report {
+    fetchState: {
+        month: FetchStateAndError;
+        quarter: FetchStateAndError;
+        year: FetchStateAndError;
+    };
+    projectIds: ID[];
+    uiState: CashFlowProjectViewUIState;
+    currency?: Currency;
+}

package/lib/view/cashInCashOut/cashInCashOutSelector.d.ts

@@ -15,7 +15,7 @@ export declare const getCashInCashOut: (accountState: AccountState, accountGroup
     firstMonthOfFY: 1 | 2 | 3 | 4 | 5 | 11 | 6 | 7 | 8 | 9 | 10 | 12;
     dataAvailable: import("../../commonStateTypes/timeframeTick").TimeframeTick | undefined;
     availableNumberOfPeriods: number | undefined;
-    reportId: "vendor" | "cash_balance" | "card_balance" | "expense_automation_card" | "operating_expenses" | "operating_expenses_by_classes" | "operating_expenses_by_projects" | "revenue" | "revenue_by_classes" | "revenue_by_projects" | "net_burn_or_income" | "net_burn_or_income_story_card" | "net_burn_or_income_by_classes" | "net_burn_or_income_by_projects" | "cash_position" | "top_expenses" | "profit_and_loss" | "profit_and_loss_by_classes" | "profit_and_loss_by_projects" | "balance_sheet" | "balance_sheet_by_classes" | "balance_sheet_by_projects" | "cash_flow" | "dashboard" | "finance_statement" | "transaction_list_of_account" | "transaction_list_missing_receipt" | "transaction_list_of_account_by_class" | "transaction_list_of_account_by_project" | "transaction_detail" | "cash_in_cash_out" | "insights_dashboard" | "company_details" | "class_list" | "account_list" | "account_list_by_type" | "task_card" | "bill_pay" | "reimbursement" | "bill_pay_card" | "reimbursement_card" | "bill_pay_promo_card" | "zeni_accounts" | "zeni_accounts_promo_card" | "zeni_treasury" | "charge_cards" | "other_connection" | "reimbursement_promo_card" | "onboarding" | "operating_expenses_by_vendor" | "operating_expenses_by_vendor_summary" | "vendors_tab" | "accounts_payable_aging" | "accounts_receivable_aging" | "vendor_global_review" | "prepaid_expenses" | "fixed_assets" | "notification" | "rewards_card" | "billing" | "flux_analysis_operating_expense" | "account_reconciliation" | "zeni_credit_promo_card" | "treasury_promo_card" | "excluded_account_reconciliation" | "transfer_accounts" | "credit_card_transfer_accounts";
+    reportId: "vendor" | "cash_balance" | "card_balance" | "expense_automation_card" | "operating_expenses" | "operating_expenses_by_classes" | "operating_expenses_by_projects" | "revenue" | "revenue_by_classes" | "revenue_by_projects" | "net_burn_or_income" | "net_burn_or_income_story_card" | "net_burn_or_income_by_classes" | "net_burn_or_income_by_projects" | "cash_position" | "top_expenses" | "profit_and_loss" | "profit_and_loss_by_classes" | "profit_and_loss_by_projects" | "balance_sheet" | "balance_sheet_by_classes" | "balance_sheet_by_projects" | "cash_flow" | "cash_flow_by_classes" | "cash_flow_by_projects" | "dashboard" | "finance_statement" | "transaction_list_of_account" | "transaction_list_missing_receipt" | "transaction_list_of_account_by_class" | "transaction_list_of_account_by_project" | "transaction_detail" | "cash_in_cash_out" | "insights_dashboard" | "company_details" | "class_list" | "account_list" | "account_list_by_type" | "task_card" | "bill_pay" | "reimbursement" | "bill_pay_card" | "reimbursement_card" | "bill_pay_promo_card" | "zeni_accounts" | "zeni_accounts_promo_card" | "zeni_treasury" | "charge_cards" | "other_connection" | "reimbursement_promo_card" | "onboarding" | "operating_expenses_by_vendor" | "operating_expenses_by_vendor_summary" | "vendors_tab" | "accounts_payable_aging" | "accounts_receivable_aging" | "vendor_global_review" | "prepaid_expenses" | "fixed_assets" | "notification" | "rewards_card" | "billing" | "flux_analysis_operating_expense" | "account_reconciliation" | "zeni_credit_promo_card" | "treasury_promo_card" | "excluded_account_reconciliation" | "transfer_accounts" | "credit_card_transfer_accounts";
     reportTitle: string;
     version: string | number | undefined;
     status: import("../..").Status | undefined;

package/lib/view/cashPosition/cashPositionSelector.d.ts

@@ -12,7 +12,7 @@ export declare const getCashPosition: (accountState: AccountState, cashPositionS
     firstMonthOfFY: 1 | 2 | 3 | 4 | 5 | 11 | 6 | 7 | 8 | 9 | 10 | 12;
     dataAvailable: import("../../commonStateTypes/timeframeTick").TimeframeTick | undefined;
     availableNumberOfPeriods: number | undefined;
-    reportId: "vendor" | "cash_balance" | "card_balance" | "expense_automation_card" | "operating_expenses" | "operating_expenses_by_classes" | "operating_expenses_by_projects" | "revenue" | "revenue_by_classes" | "revenue_by_projects" | "net_burn_or_income" | "net_burn_or_income_story_card" | "net_burn_or_income_by_classes" | "net_burn_or_income_by_projects" | "cash_position" | "top_expenses" | "profit_and_loss" | "profit_and_loss_by_classes" | "profit_and_loss_by_projects" | "balance_sheet" | "balance_sheet_by_classes" | "balance_sheet_by_projects" | "cash_flow" | "dashboard" | "finance_statement" | "transaction_list_of_account" | "transaction_list_missing_receipt" | "transaction_list_of_account_by_class" | "transaction_list_of_account_by_project" | "transaction_detail" | "cash_in_cash_out" | "insights_dashboard" | "company_details" | "class_list" | "account_list" | "account_list_by_type" | "task_card" | "bill_pay" | "reimbursement" | "bill_pay_card" | "reimbursement_card" | "bill_pay_promo_card" | "zeni_accounts" | "zeni_accounts_promo_card" | "zeni_treasury" | "charge_cards" | "other_connection" | "reimbursement_promo_card" | "onboarding" | "operating_expenses_by_vendor" | "operating_expenses_by_vendor_summary" | "vendors_tab" | "accounts_payable_aging" | "accounts_receivable_aging" | "vendor_global_review" | "prepaid_expenses" | "fixed_assets" | "notification" | "rewards_card" | "billing" | "flux_analysis_operating_expense" | "account_reconciliation" | "zeni_credit_promo_card" | "treasury_promo_card" | "excluded_account_reconciliation" | "transfer_accounts" | "credit_card_transfer_accounts";
+    reportId: "vendor" | "cash_balance" | "card_balance" | "expense_automation_card" | "operating_expenses" | "operating_expenses_by_classes" | "operating_expenses_by_projects" | "revenue" | "revenue_by_classes" | "revenue_by_projects" | "net_burn_or_income" | "net_burn_or_income_story_card" | "net_burn_or_income_by_classes" | "net_burn_or_income_by_projects" | "cash_position" | "top_expenses" | "profit_and_loss" | "profit_and_loss_by_classes" | "profit_and_loss_by_projects" | "balance_sheet" | "balance_sheet_by_classes" | "balance_sheet_by_projects" | "cash_flow" | "cash_flow_by_classes" | "cash_flow_by_projects" | "dashboard" | "finance_statement" | "transaction_list_of_account" | "transaction_list_missing_receipt" | "transaction_list_of_account_by_class" | "transaction_list_of_account_by_project" | "transaction_detail" | "cash_in_cash_out" | "insights_dashboard" | "company_details" | "class_list" | "account_list" | "account_list_by_type" | "task_card" | "bill_pay" | "reimbursement" | "bill_pay_card" | "reimbursement_card" | "bill_pay_promo_card" | "zeni_accounts" | "zeni_accounts_promo_card" | "zeni_treasury" | "charge_cards" | "other_connection" | "reimbursement_promo_card" | "onboarding" | "operating_expenses_by_vendor" | "operating_expenses_by_vendor_summary" | "vendors_tab" | "accounts_payable_aging" | "accounts_receivable_aging" | "vendor_global_review" | "prepaid_expenses" | "fixed_assets" | "notification" | "rewards_card" | "billing" | "flux_analysis_operating_expense" | "account_reconciliation" | "zeni_credit_promo_card" | "treasury_promo_card" | "excluded_account_reconciliation" | "transfer_accounts" | "credit_card_transfer_accounts";
     reportTitle: string;
     version: string | number | undefined;
     status: import("../..").Status | undefined;