@zeniai/client-epic-state 5.1.30 → 5.1.32-betaAK0

package/lib/esm/view/invoicing/invoiceList/invoiceListReducer.js

@@ -0,0 +1,90 @@
+import { createSlice } from '@reduxjs/toolkit';
+export const initialState = {
+    fetchState: 'Not-Started',
+    error: undefined,
+    invoiceIds: [],
+    nextCursor: null,
+    filters: {},
+    counts: { all: 0 },
+    countsFetchState: { fetchState: 'Not-Started', error: undefined },
+    kpis: undefined,
+    kpisFetchState: { fetchState: 'Not-Started', error: undefined },
+    hasValidState() {
+        return this.fetchState === 'Completed';
+    },
+};
+const invoiceList = createSlice({
+    name: 'invoicingInvoiceList',
+    initialState,
+    reducers: {
+        fetchInvoiceList: {
+            reducer(draft, action) {
+                if (!action.payload.keepExistingListItems) {
+                    draft.invoiceIds = [];
+                    draft.nextCursor = null;
+                }
+                draft.filters = action.payload.filters;
+                draft.sort = action.payload.sort;
+                draft.fetchState = 'In-Progress';
+                draft.error = undefined;
+            },
+            prepare(payload) {
+                return {
+                    payload: {
+                        filters: payload.filters ?? {},
+                        cursor: payload.cursor,
+                        keepExistingListItems: payload.keepExistingListItems ?? false,
+                        sort: payload.sort,
+                    },
+                };
+            },
+        },
+        updateInvoiceList(draft, action) {
+            const newIds = action.payload.invoices.map((invoice) => invoice.id);
+            draft.invoiceIds = action.payload.keepExistingListItems
+                ? [...new Set([...draft.invoiceIds, ...newIds])]
+                : newIds;
+            draft.nextCursor = action.payload.nextCursor;
+            draft.fetchState = 'Completed';
+            draft.error = undefined;
+        },
+        updateInvoiceListFailure(draft, action) {
+            draft.fetchState = 'Error';
+            draft.error = action.payload;
+        },
+        fetchInvoiceCounts(draft) {
+            draft.countsFetchState.fetchState = 'In-Progress';
+            draft.countsFetchState.error = undefined;
+        },
+        updateInvoiceCounts(draft, action) {
+            draft.counts = action.payload;
+            draft.countsFetchState.fetchState = 'Completed';
+            draft.countsFetchState.error = undefined;
+        },
+        updateInvoiceCountsFailure(draft, action) {
+            draft.countsFetchState.fetchState = 'Error';
+            draft.countsFetchState.error = action.payload;
+        },
+        fetchInvoiceKPIs(draft) {
+            draft.kpisFetchState.fetchState = 'In-Progress';
+            draft.kpisFetchState.error = undefined;
+        },
+        updateInvoiceKPIs(draft, action) {
+            draft.kpis = action.payload;
+            draft.kpisFetchState.fetchState = 'Completed';
+            draft.kpisFetchState.error = undefined;
+        },
+        updateInvoiceKPIsFailure(draft, action) {
+            draft.kpisFetchState.fetchState = 'Error';
+            draft.kpisFetchState.error = action.payload;
+        },
+        updateInvoiceListFilters(draft, action) {
+            draft.filters = action.payload;
+        },
+        clearInvoiceList(draft) {
+            Object.assign(draft, initialState);
+        },
+    },
+});
+export const { fetchInvoiceList, updateInvoiceList, updateInvoiceListFailure, fetchInvoiceCounts, updateInvoiceCounts, updateInvoiceCountsFailure, fetchInvoiceKPIs, updateInvoiceKPIs, updateInvoiceKPIsFailure, updateInvoiceListFilters, clearInvoiceList, } = invoiceList.actions;
+export default invoiceList.reducer;

package/lib/esm/view/invoicing/invoiceList/invoiceListSelector.js

@@ -0,0 +1,11 @@
+import { getInvoicesByIds } from '../../../entity/invoicing/invoice/invoiceSelector';
+export const getInvoiceListFetchState = (state) => ({
+    fetchState: state.invoicingInvoiceListState.fetchState,
+    error: state.invoicingInvoiceListState.error,
+});
+export const getInvoiceListItems = (state) => getInvoicesByIds(state, state.invoicingInvoiceListState.invoiceIds);
+export const getInvoiceListNextCursor = (state) => state.invoicingInvoiceListState.nextCursor;
+export const getInvoiceListHasMore = (state) => state.invoicingInvoiceListState.nextCursor != null;
+export const getInvoiceListFilters = (state) => state.invoicingInvoiceListState.filters;
+export const getInvoiceCounts = (state) => state.invoicingInvoiceListState.counts;
+export const getInvoiceKPIs = (state) => state.invoicingInvoiceListState.kpis;

package/lib/esm/view/invoicing/invoiceList/invoiceListState.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/view/invoicing/invoicePdf/invoicePdfEpic.js

@@ -0,0 +1,36 @@
+import { of } from 'rxjs';
+import { catchError, filter, map, mergeMap } from 'rxjs/operators';
+import { createZeniAPIStatus } from '../../../responsePayload';
+import { downloadInvoicePdf, downloadInvoicePdfFailure, downloadInvoicePdfSuccess, } from './invoicePdfReducer';
+/**
+ * Turn the auth-fetched PDF bytes into a browser download. The invoicing PDF
+ * endpoint requires the zeni-* auth headers, so the blob must be fetched via
+ * ZeniAPI (a plain <a href>/<iframe> cannot attach them) and then handed to the
+ * browser as an object URL.
+ */
+const triggerBrowserDownload = (data, fileName) => {
+    if (typeof document === 'undefined' || typeof URL === 'undefined') {
+        return;
+    }
+    const blob = new Blob([data], { type: 'application/pdf' });
+    const objectUrl = URL.createObjectURL(blob);
+    const anchor = document.createElement('a');
+    anchor.href = objectUrl;
+    anchor.download = fileName;
+    document.body.appendChild(anchor);
+    anchor.click();
+    anchor.remove();
+    URL.revokeObjectURL(objectUrl);
+};
+export const downloadInvoicePdfEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(downloadInvoicePdf.match), mergeMap((action) => {
+    const { fileName, invoiceId } = action.payload;
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/invoices/${encodeURIComponent(invoiceId)}/pdf`;
+    return zeniAPI.getFile(apiUrl).pipe(map((data) => {
+        triggerBrowserDownload(data, fileName != null && fileName !== '' ? fileName : `${invoiceId}.pdf`);
+        return downloadInvoicePdfSuccess({ invoiceId });
+    }), catchError((error) => of(downloadInvoicePdfFailure({
+        error: createZeniAPIStatus('Unexpected Error', 'Invoice PDF download REST API call errored out ' +
+            JSON.stringify(error)),
+        invoiceId,
+    }))));
+}));

package/lib/esm/view/invoicing/invoicePdf/invoicePdfReducer.js

@@ -0,0 +1,33 @@
+import { createSlice } from '@reduxjs/toolkit';
+export const initialState = {
+    byInvoiceId: {},
+};
+const invoicePdf = createSlice({
+    name: 'invoicingInvoicePdf',
+    initialState,
+    reducers: {
+        downloadInvoicePdf(draft, action) {
+            draft.byInvoiceId[action.payload.invoiceId] = {
+                fetchState: 'In-Progress',
+                error: undefined,
+            };
+        },
+        downloadInvoicePdfSuccess(draft, action) {
+            draft.byInvoiceId[action.payload.invoiceId] = {
+                fetchState: 'Completed',
+                error: undefined,
+            };
+        },
+        downloadInvoicePdfFailure(draft, action) {
+            draft.byInvoiceId[action.payload.invoiceId] = {
+                fetchState: 'Error',
+                error: action.payload.error,
+            };
+        },
+        clearAllInvoicingInvoicePdf(draft) {
+            draft.byInvoiceId = {};
+        },
+    },
+});
+export const { downloadInvoicePdf, downloadInvoicePdfSuccess, downloadInvoicePdfFailure, clearAllInvoicingInvoicePdf, } = invoicePdf.actions;
+export default invoicePdf.reducer;

package/lib/esm/view/invoicing/invoicePdf/invoicePdfSelector.js

@@ -0,0 +1,5 @@
+const NOT_STARTED = {
+    fetchState: 'Not-Started',
+    error: undefined,
+};
+export const getInvoicingInvoicePdfState = (invoiceId) => (state) => state.invoicingInvoicePdfState.byInvoiceId[invoiceId] ?? NOT_STARTED;

package/lib/esm/view/invoicing/invoicePdf/invoicePdfState.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/view/invoicing/invoicingApiHelper.js

@@ -0,0 +1,14 @@
+/** Default page size for invoicing list / infinite-scroll requests. */
+export const INVOICING_LIST_PAGE_SIZE = 50;
+/** Append a query string (with leading `?`) when params are present. */
+export const withQuery = (path, params) => {
+    const qs = params.toString();
+    return qs.length > 0 ? `${path}?${qs}` : path;
+};
+/** Attach `sort_field`/`sort_dir` to a list query when a sort is active. */
+export const applyListSortParams = (params, sort) => {
+    if (sort != null && sort.field !== '') {
+        params.set('sort_field', sort.field);
+        params.set('sort_dir', sort.dir);
+    }
+};

package/lib/esm/view/invoicing/invoicingCustomerDetailView/fetchInvoicingCustomerDetailEpic.js

@@ -0,0 +1,22 @@
+import { of } from 'rxjs';
+import { catchError, filter, switchMap } from 'rxjs/operators';
+import { updateInvoicingCustomers } from '../../../entity/invoicing/invoicingCustomer/invoicingCustomerReducer';
+import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { fetchInvoicingCustomerDetail, updateInvoicingCustomerDetail, updateInvoicingCustomerDetailFailure, } from './invoicingCustomerDetailViewReducer';
+export const fetchInvoicingCustomerDetailEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(fetchInvoicingCustomerDetail.match), switchMap((action) => {
+    const { id } = action.payload;
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/customers/${id}`;
+    return zeniAPI.getJSON(apiUrl).pipe(switchMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            return [
+                updateInvoicingCustomers([response.data], 'merge'),
+                updateInvoicingCustomerDetail({ id: response.data.id }),
+            ];
+        }
+        return of(updateInvoicingCustomerDetailFailure({ id, status: response.status }));
+    }), catchError((error) => of(updateInvoicingCustomerDetailFailure({
+        id,
+        status: createZeniAPIStatus('Unexpected Error', 'Fetch customer detail REST API call errored out ' +
+            JSON.stringify(error)),
+    }))));
+}));

package/lib/esm/view/invoicing/invoicingCustomerDetailView/fetchInvoicingCustomerDetailPageEpic.js

@@ -0,0 +1,41 @@
+import { concat, from } from 'rxjs';
+import { filter, mergeMap } from 'rxjs/operators';
+import { fetchInvoiceList } from '../invoiceList/invoiceListReducer';
+import { fetchInvoicingSettings } from '../settingsView/settingsViewReducer';
+import { fetchInvoicingCustomerDetail, fetchInvoicingCustomerDetailPage, } from './invoicingCustomerDetailViewReducer';
+/**
+ * Fetch unless the endpoint is already loaded or in flight — or always when the
+ * caller forces a refresh via `cacheOverride` (e.g. on a manual refresh).
+ */
+const shouldFetch = (fetchStateAndError, cacheOverride) => cacheOverride ||
+    (fetchStateAndError.fetchState !== 'Completed' &&
+        fetchStateAndError.fetchState !== 'In-Progress');
+/**
+ * Orchestrates the customer detail page: on `fetchInvoicingCustomerDetailPage`,
+ * fans out to the customer detail, the customer's invoice list and the invoicing
+ * settings, skipping any whose data is already cached unless `cacheOverride` is
+ * set (e.g. on a manual refresh).
+ */
+export const fetchInvoicingCustomerDetailPageEpic = (actions$, state$) => actions$.pipe(filter(fetchInvoicingCustomerDetailPage.match), mergeMap((action) => {
+    const { cacheOverride, id } = action.payload;
+    const customerDetail = state$.value.invoicingCustomerDetailViewState.detailById[id];
+    const invoiceListState = state$.value.invoicingInvoiceListState;
+    const settingsState = state$.value.invoicingSettingsViewState;
+    const pageActions = [];
+    if (shouldFetch({
+        fetchState: customerDetail?.fetchState ?? 'Not-Started',
+        error: customerDetail?.error,
+    }, cacheOverride)) {
+        pageActions.push(fetchInvoicingCustomerDetail({ id }));
+    }
+    if (shouldFetch({
+        fetchState: invoiceListState.fetchState,
+        error: invoiceListState.error,
+    }, cacheOverride)) {
+        pageActions.push(fetchInvoiceList({ filters: { customerId: id } }));
+    }
+    if (shouldFetch({ fetchState: settingsState.fetchState, error: settingsState.error }, cacheOverride)) {
+        pageActions.push(fetchInvoicingSettings());
+    }
+    return concat(from(pageActions));
+}));

package/lib/esm/view/invoicing/invoicingCustomerDetailView/invoicingCustomerDetailViewPayload.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/view/invoicing/invoicingCustomerDetailView/invoicingCustomerDetailViewReducer.js

@@ -0,0 +1,51 @@
+import { createSlice } from '@reduxjs/toolkit';
+export const initialState = {
+    detailById: {},
+};
+/**
+ * Shared `hasValidState` implementation so every `detailById` entry references
+ * the same function (keeps entries reference-stable for equality checks).
+ */
+function hasCompletedFetch() {
+    return this.fetchState === 'Completed';
+}
+/** Build a per-customer detail fetch-state entry. */
+export function buildInvoicingCustomerDetail(id, fetchState, error) {
+    return { id, fetchState, error, hasValidState: hasCompletedFetch };
+}
+const invoicingCustomerDetailView = createSlice({
+    name: 'invoicingCustomerDetailView',
+    initialState,
+    reducers: {
+        fetchInvoicingCustomerDetail(draft, action) {
+            const { id } = action.payload;
+            draft.detailById[id] = buildInvoicingCustomerDetail(id, 'In-Progress');
+        },
+        fetchInvoicingCustomerDetailPage: {
+            reducer() {
+                // Orchestrator trigger only — the individual fetches own the state.
+            },
+            prepare(payload) {
+                return {
+                    payload: {
+                        cacheOverride: payload.cacheOverride ?? false,
+                        id: payload.id,
+                    },
+                };
+            },
+        },
+        updateInvoicingCustomerDetail(draft, action) {
+            const { id } = action.payload;
+            draft.detailById[id] = buildInvoicingCustomerDetail(id, 'Completed');
+        },
+        updateInvoicingCustomerDetailFailure(draft, action) {
+            const { id, status } = action.payload;
+            draft.detailById[id] = buildInvoicingCustomerDetail(id, 'Error', status);
+        },
+        clearInvoicingCustomerDetailView(draft) {
+            draft.detailById = {};
+        },
+    },
+});
+export const { fetchInvoicingCustomerDetail, fetchInvoicingCustomerDetailPage, updateInvoicingCustomerDetail, updateInvoicingCustomerDetailFailure, clearInvoicingCustomerDetailView, } = invoicingCustomerDetailView.actions;
+export default invoicingCustomerDetailView.reducer;

package/lib/esm/view/invoicing/invoicingCustomerDetailView/invoicingCustomerDetailViewSelector.js

@@ -0,0 +1,25 @@
+import recordGet from 'lodash/get';
+import { getInvoicingCustomerById } from '../../../entity/invoicing/invoicingCustomer/invoicingCustomerSelector';
+import { getInvoicingPaymentLinkSendState, getInvoicingPaymentMethodSaveState, getInvoicingPlaidLinkToken, getInvoicingSentPaymentLinkEmail, getInvoicingSetupIntent, getInvoicingSetupIntentFetchState, } from '../customerPaymentMethod/customerPaymentMethodSelector';
+import { getInvoiceListItems } from '../invoiceList/invoiceListSelector';
+import { getInvoicingSettings } from '../settingsView/settingsViewSelector';
+export const getInvoicingCustomerDetail = (state, invoicingCustomerID) => {
+    const { invoicingCustomerState, invoicingCustomerDetailViewState } = state;
+    const invoicingCustomerDetail = recordGet(invoicingCustomerDetailViewState.detailById, invoicingCustomerID, undefined);
+    const settings = getInvoicingSettings(state);
+    return {
+        invoicingCustomer: getInvoicingCustomerById(invoicingCustomerState, invoicingCustomerID),
+        invoices: getInvoiceListItems(state),
+        setupIntent: getInvoicingSetupIntent(state),
+        setupIntentFetchState: getInvoicingSetupIntentFetchState(state),
+        plaidLinkToken: getInvoicingPlaidLinkToken(state),
+        paymentMethodSaveState: getInvoicingPaymentMethodSaveState(state),
+        sendLinkState: getInvoicingPaymentLinkSendState(state),
+        sentPaymentLinkEmail: getInvoicingSentPaymentLinkEmail(state),
+        stripeConnected: settings?.stripe_connected_account_id != null &&
+            settings.stripe_connected_account_id !== '',
+        fetchState: invoicingCustomerDetail?.fetchState ?? 'Not-Started',
+        error: invoicingCustomerDetail?.error,
+        version: 1.0,
+    };
+};

package/lib/esm/view/invoicing/invoicingCustomerDetailView/invoicingCustomerDetailViewState.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/view/invoicing/invoicingCustomerListView/epics/fetchInvoicingCustomerCountsEpic.js

@@ -0,0 +1,20 @@
+import { of } from 'rxjs';
+import { catchError, filter, switchMap } from 'rxjs/operators';
+import { createZeniAPIStatus, isSuccessResponse, } from '../../../../responsePayload';
+import { withQuery } from '../../invoicingApiHelper';
+import { fetchInvoicingCustomerCounts, updateInvoicingCustomerCounts, updateInvoicingCustomerCountsFailure, } from '../invoicingCustomerListViewReducer';
+export const fetchInvoicingCustomerCountsEpic = (actions$, state$, zeniAPI) => actions$.pipe(filter(fetchInvoicingCustomerCounts.match), switchMap(() => {
+    const { filters } = state$.value.invoicingCustomerListViewState;
+    const params = new URLSearchParams();
+    if (filters.search != null && filters.search.length > 0) {
+        params.set('search', filters.search);
+    }
+    const apiUrl = withQuery(`${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/customers/counts`, params);
+    return zeniAPI.getJSON(apiUrl).pipe(switchMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            return of(updateInvoicingCustomerCounts(response.data));
+        }
+        return of(updateInvoicingCustomerCountsFailure(response.status));
+    }), catchError((error) => of(updateInvoicingCustomerCountsFailure(createZeniAPIStatus('Unexpected Error', 'Fetch customer counts REST API call errored out ' +
+        JSON.stringify(error))))));
+}));

package/lib/esm/view/invoicing/invoicingCustomerListView/epics/fetchInvoicingCustomerListEpic.js

@@ -0,0 +1,40 @@
+import { of } from 'rxjs';
+import { catchError, filter, switchMap } from 'rxjs/operators';
+import { updateInvoicingCustomers } from '../../../../entity/invoicing/invoicingCustomer/invoicingCustomerReducer';
+import { createZeniAPIStatus, isSuccessResponse, } from '../../../../responsePayload';
+import { INVOICING_LIST_PAGE_SIZE, applyListSortParams, withQuery, } from '../../invoicingApiHelper';
+import { fetchInvoicingCustomerList, updateInvoicingCustomerList, updateInvoicingCustomerListFailure, } from '../invoicingCustomerListViewReducer';
+const buildQuery = (filters, cursor, sort) => {
+    const params = new URLSearchParams();
+    if (filters.search != null && filters.search.length > 0) {
+        params.set('search', filters.search);
+    }
+    if (filters.status != null && filters.status.length > 0) {
+        params.set('status', filters.status);
+    }
+    params.set('limit', String(INVOICING_LIST_PAGE_SIZE));
+    if (cursor != null) {
+        params.set('cursor', cursor);
+    }
+    applyListSortParams(params, sort);
+    return params;
+};
+export const fetchInvoicingCustomerListEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(fetchInvoicingCustomerList.match), switchMap((action) => {
+    const { filters, cursor, keepExistingListItems, sort } = action.payload;
+    const apiUrl = withQuery(`${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/customers`, buildQuery(filters, cursor, sort));
+    return zeniAPI.getJSON(apiUrl).pipe(switchMap((response) => {
+        if (isSuccessResponse(response)) {
+            const items = response.data?.items ?? [];
+            return [
+                updateInvoicingCustomers(items, 'merge'),
+                updateInvoicingCustomerList({
+                    ids: items.map((item) => item.id),
+                    nextCursor: response.data?.next_cursor ?? null,
+                    keepExistingListItems,
+                }),
+            ];
+        }
+        return of(updateInvoicingCustomerListFailure(response.status));
+    }), catchError((error) => of(updateInvoicingCustomerListFailure(createZeniAPIStatus('Unexpected Error', 'Fetch customer list REST API call errored out ' +
+        JSON.stringify(error))))));
+}));

package/lib/esm/view/invoicing/invoicingCustomerListView/epics/fetchInvoicingCustomerListPageEpic.js

@@ -0,0 +1,27 @@
+import { concat, from } from 'rxjs';
+import { filter, mergeMap } from 'rxjs/operators';
+import { fetchInvoicingCustomerCounts, fetchInvoicingCustomerList, fetchInvoicingCustomerListPage, } from '../invoicingCustomerListViewReducer';
+/**
+ * Fetch unless the endpoint is already loaded or in flight — or always when the
+ * caller forces a refresh via `cacheOverride` (e.g. on a filter/sort change).
+ */
+const shouldFetch = (fetchStateAndError, cacheOverride) => cacheOverride ||
+    (fetchStateAndError.fetchState !== 'Completed' &&
+        fetchStateAndError.fetchState !== 'In-Progress');
+/**
+ * Orchestrates the customers list page: on `fetchInvoicingCustomerListPage`,
+ * fans out to the list and counts fetches, skipping either one whose data is
+ * already cached unless `cacheOverride` is set (e.g. on a filter/sort change).
+ */
+export const fetchInvoicingCustomerListPageEpic = (actions$, state$) => actions$.pipe(filter(fetchInvoicingCustomerListPage.match), mergeMap((action) => {
+    const { cacheOverride, filters, sort } = action.payload;
+    const state = state$.value.invoicingCustomerListViewState;
+    const pageActions = [];
+    if (shouldFetch({ fetchState: state.fetchState, error: state.error }, cacheOverride)) {
+        pageActions.push(fetchInvoicingCustomerList({ filters, sort }));
+    }
+    if (shouldFetch(state.countsFetchState, cacheOverride)) {
+        pageActions.push(fetchInvoicingCustomerCounts());
+    }
+    return concat(from(pageActions));
+}));

package/lib/esm/view/invoicing/invoicingCustomerListView/invoicingCustomerListViewPayload.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/view/invoicing/invoicingCustomerListView/invoicingCustomerListViewReducer.js

@@ -0,0 +1,89 @@
+import { createSlice } from '@reduxjs/toolkit';
+export const initialState = {
+    fetchState: 'Not-Started',
+    error: undefined,
+    ids: [],
+    nextCursor: null,
+    filters: {},
+    counts: { all: 0 },
+    countsFetchState: { fetchState: 'Not-Started', error: undefined },
+    hasValidState() {
+        return this.fetchState === 'Completed';
+    },
+};
+const invoicingCustomerListView = createSlice({
+    name: 'invoicingCustomerListView',
+    initialState,
+    reducers: {
+        fetchInvoicingCustomerList: {
+            reducer(draft, action) {
+                if (!action.payload.keepExistingListItems) {
+                    draft.ids = [];
+                    draft.nextCursor = null;
+                }
+                draft.filters = action.payload.filters;
+                draft.sort = action.payload.sort;
+                draft.fetchState = 'In-Progress';
+                draft.error = undefined;
+            },
+            prepare(payload) {
+                return {
+                    payload: {
+                        filters: payload.filters ?? {},
+                        cursor: payload.cursor,
+                        keepExistingListItems: payload.keepExistingListItems ?? false,
+                        sort: payload.sort,
+                    },
+                };
+            },
+        },
+        fetchInvoicingCustomerListPage: {
+            reducer(draft, action) {
+                draft.filters = action.payload.filters;
+                draft.sort = action.payload.sort;
+            },
+            prepare(payload) {
+                return {
+                    payload: {
+                        cacheOverride: payload.cacheOverride ?? false,
+                        filters: payload.filters ?? {},
+                        sort: payload.sort,
+                    },
+                };
+            },
+        },
+        updateInvoicingCustomerList(draft, action) {
+            draft.ids = action.payload.keepExistingListItems
+                ? [...new Set([...draft.ids, ...action.payload.ids])]
+                : action.payload.ids;
+            draft.nextCursor = action.payload.nextCursor;
+            draft.fetchState = 'Completed';
+            draft.error = undefined;
+        },
+        updateInvoicingCustomerListFailure(draft, action) {
+            draft.fetchState = 'Error';
+            draft.error = action.payload;
+        },
+        fetchInvoicingCustomerCounts(draft) {
+            draft.countsFetchState.fetchState = 'In-Progress';
+            draft.countsFetchState.error = undefined;
+        },
+        updateInvoicingCustomerCounts(draft, action) {
+            draft.counts = action.payload;
+            draft.countsFetchState.fetchState = 'Completed';
+            draft.countsFetchState.error = undefined;
+        },
+        updateInvoicingCustomerCountsFailure(draft, action) {
+            draft.countsFetchState.fetchState = 'Error';
+            draft.countsFetchState.error = action.payload;
+        },
+        updateInvoicingCustomerFilters(draft, action) {
+            draft.filters = action.payload;
+        },
+        clearInvoicingCustomerListView(draft) {
+            Object.assign(draft, initialState);
+        },
+    },
+});
+export const { fetchInvoicingCustomerList, fetchInvoicingCustomerListPage, updateInvoicingCustomerList, updateInvoicingCustomerListFailure, fetchInvoicingCustomerCounts, updateInvoicingCustomerCounts, updateInvoicingCustomerCountsFailure, updateInvoicingCustomerFilters, clearInvoicingCustomerListView, } = invoicingCustomerListView.actions;
+export default invoicingCustomerListView.reducer;

package/lib/esm/view/invoicing/invoicingCustomerListView/invoicingCustomerListViewSelector.js

@@ -0,0 +1,9 @@
+import { getInvoicingCustomersByIds } from '../../../entity/invoicing/invoicingCustomer/invoicingCustomerSelector';
+export const getInvoicingCustomerListView = (state) => ({
+    customers: getInvoicingCustomersByIds(state.invoicingCustomerState, state.invoicingCustomerListViewState.ids),
+    fetchState: state.invoicingCustomerListViewState.fetchState,
+    error: state.invoicingCustomerListViewState.error,
+    nextCursor: state.invoicingCustomerListViewState.nextCursor,
+    filters: state.invoicingCustomerListViewState.filters,
+    count: state.invoicingCustomerListViewState.counts,
+});

package/lib/esm/view/invoicing/invoicingCustomerListView/invoicingCustomerListViewState.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/view/invoicing/invoicingOverview/epics/fetchInvoicingOverviewChurnEpic.js

@@ -0,0 +1,17 @@
+import { EMPTY, of } from 'rxjs';
+import { catchError, filter, switchMap } from 'rxjs/operators';
+import { createZeniAPIStatus, isSuccessResponse } from '../../../../responsePayload';
+import { fetchInvoicingOverviewChurn, updateInvoicingOverviewChurn, updateInvoicingOverviewChurnFailure, } from '../invoicingOverviewReducer';
+export const fetchInvoicingOverviewChurnEpic = (actions$, state$, zeniAPI) => actions$.pipe(filter(fetchInvoicingOverviewChurn.match), switchMap(() => {
+    const { period } = state$.value.invoicingOverviewState;
+    if (period == null) {
+        return EMPTY;
+    }
+    const base = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0`;
+    return zeniAPI
+        .getJSON(`${base}/analytics/churn?months=6&year=${period.year}&month=${period.month}`)
+        .pipe(switchMap((response) => isSuccessResponse(response) && response.data != null
+        ? of(updateInvoicingOverviewChurn(response.data))
+        : of(updateInvoicingOverviewChurnFailure(response.status))), catchError((error) => of(updateInvoicingOverviewChurnFailure(createZeniAPIStatus('Unexpected Error', 'Fetch overview churn REST API call errored out ' +
+        JSON.stringify(error))))));
+}));

package/lib/esm/view/invoicing/invoicingOverview/epics/fetchInvoicingOverviewDashboardSummaryEpic.js

@@ -0,0 +1,17 @@
+import { EMPTY, of } from 'rxjs';
+import { catchError, filter, switchMap } from 'rxjs/operators';
+import { createZeniAPIStatus, isSuccessResponse } from '../../../../responsePayload';
+import { fetchInvoicingOverviewDashboardSummary, updateInvoicingOverviewDashboardSummary, updateInvoicingOverviewDashboardSummaryFailure, } from '../invoicingOverviewReducer';
+export const fetchInvoicingOverviewDashboardSummaryEpic = (actions$, state$, zeniAPI) => actions$.pipe(filter(fetchInvoicingOverviewDashboardSummary.match), switchMap(() => {
+    const { period } = state$.value.invoicingOverviewState;
+    if (period == null) {
+        return EMPTY;
+    }
+    const base = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0`;
+    return zeniAPI
+        .getJSON(`${base}/analytics/dashboard-summary?year=${period.year}&month=${period.month}`)
+        .pipe(switchMap((response) => isSuccessResponse(response) && response.data != null
+        ? of(updateInvoicingOverviewDashboardSummary(response.data))
+        : of(updateInvoicingOverviewDashboardSummaryFailure(response.status))), catchError((error) => of(updateInvoicingOverviewDashboardSummaryFailure(createZeniAPIStatus('Unexpected Error', 'Fetch overview dashboard summary REST API call errored out ' +
+        JSON.stringify(error))))));
+}));

package/lib/esm/view/invoicing/invoicingOverview/epics/fetchInvoicingOverviewEpic.js

@@ -0,0 +1,55 @@
+import { concat, from } from 'rxjs';
+import { filter, mergeMap } from 'rxjs/operators';
+import { fetchInvoicingSettings } from '../../settingsView/settingsViewReducer';
+import { getInvoicingSettingsFetchState } from '../../settingsView/settingsViewSelector';
+import { fetchInvoicingSubscriptionList } from '../../invoicingSubscriptionListView/invoicingSubscriptionListViewReducer';
+import { getInvoicingSubscriptionListView } from '../../invoicingSubscriptionListView/invoicingSubscriptionListViewSelector';
+import { fetchInvoicingOverviewChurn, fetchInvoicingOverviewDashboardSummary, fetchInvoicingOverviewKPIs, fetchInvoicingOverviewMRR, fetchInvoicingOverviewPlanRevenue, fetchInvoicingOverviewRevenue, fetchInvoicingOverview, } from '../invoicingOverviewReducer';
+/**
+ * Fetch unless the endpoint is already loaded or in flight \u2014 or always when the
+ * caller forces a refresh via `cacheOverride` (e.g. on a period change).
+ */
+const shouldFetch = (fetchStateAndError, cacheOverride) => cacheOverride ||
+    (fetchStateAndError.fetchState !== 'Completed' &&
+        fetchStateAndError.fetchState !== 'In-Progress');
+/**
+ * Orchestrates the overview: on `fetchInvoicingOverview`, fans out to each
+ * per-endpoint fetch (the six analytics calls plus settings and the
+ * subscription list), skipping any whose data is already cached unless
+ * `cacheOverride` is set.
+ */
+export const fetchInvoicingOverviewEpic = (actions$, state$) => actions$.pipe(filter(fetchInvoicingOverview.match), mergeMap((action) => {
+    const { cacheOverride } = action.payload;
+    const rootState = state$.value;
+    const state = rootState.invoicingOverviewState;
+    const overviewActions = [];
+    if (shouldFetch(state.kpisFetchState, cacheOverride)) {
+        overviewActions.push(fetchInvoicingOverviewKPIs());
+    }
+    if (shouldFetch(state.revenueFetchState, cacheOverride)) {
+        overviewActions.push(fetchInvoicingOverviewRevenue());
+    }
+    if (shouldFetch(state.mrrFetchState, cacheOverride)) {
+        overviewActions.push(fetchInvoicingOverviewMRR());
+    }
+    if (shouldFetch(state.churnFetchState, cacheOverride)) {
+        overviewActions.push(fetchInvoicingOverviewChurn());
+    }
+    if (shouldFetch(state.planRevenueFetchState, cacheOverride)) {
+        overviewActions.push(fetchInvoicingOverviewPlanRevenue());
+    }
+    if (shouldFetch(state.summaryFetchState, cacheOverride)) {
+        overviewActions.push(fetchInvoicingOverviewDashboardSummary());
+    }
+    if (shouldFetch(getInvoicingSettingsFetchState(rootState), cacheOverride)) {
+        overviewActions.push(fetchInvoicingSettings());
+    }
+    const subscriptionListView = getInvoicingSubscriptionListView(rootState);
+    if (shouldFetch({
+        fetchState: subscriptionListView.fetchState,
+        error: subscriptionListView.error,
+    }, cacheOverride)) {
+        overviewActions.push(fetchInvoicingSubscriptionList({}));
+    }
+    return concat(from(overviewActions));
+}));