@zeniai/client-epic-state 5.1.59 → 5.1.60-betaAK0

package/lib/esm/view/invoicing/invoicingDunningCaseListView/invoicingDunningCaseListViewReducer.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 invoicingDunningCaseListView = createSlice({
+    name: 'invoicingDunningCaseListView',
+    initialState,
+    reducers: {
+        fetchInvoicingDunningCaseList: {
+            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,
+                    },
+                };
+            },
+        },
+        fetchInvoicingDunningCaseListPage: {
+            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,
+                    },
+                };
+            },
+        },
+        updateInvoicingDunningCaseList(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;
+        },
+        updateInvoicingDunningCaseListFailure(draft, action) {
+            draft.fetchState = 'Error';
+            draft.error = action.payload;
+        },
+        fetchInvoicingDunningCaseCounts(draft) {
+            draft.countsFetchState.fetchState = 'In-Progress';
+            draft.countsFetchState.error = undefined;
+        },
+        updateInvoicingDunningCaseCounts(draft, action) {
+            draft.counts = action.payload;
+            draft.countsFetchState.fetchState = 'Completed';
+            draft.countsFetchState.error = undefined;
+        },
+        updateInvoicingDunningCaseCountsFailure(draft, action) {
+            draft.countsFetchState.fetchState = 'Error';
+            draft.countsFetchState.error = action.payload;
+        },
+        updateInvoicingDunningCaseFilters(draft, action) {
+            draft.filters = action.payload;
+        },
+        clearInvoicingDunningCaseListView(draft) {
+            Object.assign(draft, initialState);
+        },
+    },
+});
+export const { fetchInvoicingDunningCaseList, fetchInvoicingDunningCaseListPage, updateInvoicingDunningCaseList, updateInvoicingDunningCaseListFailure, fetchInvoicingDunningCaseCounts, updateInvoicingDunningCaseCounts, updateInvoicingDunningCaseCountsFailure, updateInvoicingDunningCaseFilters, clearInvoicingDunningCaseListView, } = invoicingDunningCaseListView.actions;
+export default invoicingDunningCaseListView.reducer;

package/lib/esm/view/invoicing/invoicingDunningCaseListView/invoicingDunningCaseListViewSelector.js

@@ -0,0 +1,21 @@
+import { createSelector } from '@reduxjs/toolkit';
+import { getInvoicingDunningCasesByIds } from '../../../entity/invoicing/dunningCase/dunningCaseSelector';
+import { INVOICING_DUNNING_CASE_COLUMNS, INVOICING_DUNNING_CASE_TABS, } from './invoicingDunningCaseListViewState';
+/**
+ * Memoized so the denormalized `dunningCases` array (and the wrapping view
+ * object) keep referential identity until the dunning-case entity slice or the
+ * list-view slice actually change.
+ */
+export const getInvoicingDunningCaseListView = createSelector((state) => state.invoicingDunningCaseState, (state) => state.invoicingDunningCaseListViewState, (dunningCaseState, listViewState) => ({
+    columns: INVOICING_DUNNING_CASE_COLUMNS,
+    dunningCases: getInvoicingDunningCasesByIds(dunningCaseState, listViewState.ids),
+    count: listViewState.counts,
+    countsFetchState: listViewState.countsFetchState,
+    filters: listViewState.filters,
+    nextCursor: listViewState.nextCursor,
+    fetchState: listViewState.fetchState,
+    error: listViewState.error,
+    tabIds: INVOICING_DUNNING_CASE_TABS,
+    sort: listViewState.sort,
+    version: 1.0,
+}));

package/lib/esm/view/invoicing/invoicingDunningCaseListView/invoicingDunningCaseListViewState.js

@@ -0,0 +1,40 @@
+import { stringToUnion } from '../../../commonStateTypes/stringToUnion';
+export const ALL_INVOICING_DUNNING_CASE_SORT_KEYS = [
+    'customer',
+    'invoice',
+    'attempts',
+    'nextRetry',
+    'daysPastDue',
+    'failureReason',
+    'status',
+    'amount',
+];
+export const toInvoicingDunningCaseSortKey = (v) => stringToUnion(v, ALL_INVOICING_DUNNING_CASE_SORT_KEYS);
+export const INVOICING_DUNNING_CASE_COLUMNS = [
+    { key: 'customer', sortable: true },
+    { key: 'invoice', sortable: true },
+    { key: 'attempts', sortable: true },
+    { key: 'nextRetry', sortable: true },
+    { key: 'daysPastDue', sortable: true },
+    { key: 'failureReason', sortable: false },
+    { key: 'status', sortable: true },
+    { key: 'amount', sortable: true },
+];
+export const ALL_INVOICING_DUNNING_CASE_TAB_IDS = [
+    'all',
+    'Retrying',
+    'Scheduled',
+    'Manual Review',
+    'Resolved',
+    'Cancelled',
+];
+export const toInvoicingDunningCaseTabId = (v) => stringToUnion(v, ALL_INVOICING_DUNNING_CASE_TAB_IDS);
+/**
+ * Ordered filter-tab id set owned by CES so the dunning-cases-list tabs live
+ * next to the model rather than being hardcoded in web-components. Tab labels
+ * and the per-tab count lookup stay in the view layer; this only carries the id
+ * set and display order.
+ */
+export const INVOICING_DUNNING_CASE_TABS = [
+    ...ALL_INVOICING_DUNNING_CASE_TAB_IDS,
+];

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 { fetchInvoicingSubscriptionList } from '../../invoicingSubscriptionListView/invoicingSubscriptionListViewReducer';
+import { getInvoicingSubscriptionListView } from '../../invoicingSubscriptionListView/invoicingSubscriptionListViewSelector';
+import { fetchInvoicingSettings } from '../../settingsView/settingsViewReducer';
+import { getInvoicingSettingsFetchState } from '../../settingsView/settingsViewSelector';
+import { fetchInvoicingOverview, fetchInvoicingOverviewChurn, fetchInvoicingOverviewDashboardSummary, fetchInvoicingOverviewKPIs, fetchInvoicingOverviewMRR, fetchInvoicingOverviewPlanRevenue, fetchInvoicingOverviewRevenue, } 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));
+}));

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

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

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

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

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

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

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

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

package/lib/esm/view/invoicing/invoicingOverview/invoicingOverviewPayload.js

@@ -0,0 +1,88 @@
+import { toAmount } from '../../../commonStateTypes/amount';
+// ── Payload → State mappers (snake_case wire shape → camelCase domain shape) ──
+export const mapInvoicingOverviewKPIsPayloadToState = (payload) => ({
+    activeCustomers: payload.active_customers,
+    activeSubscriptions: payload.active_subscriptions,
+    arr: toAmount(payload.arr, 'USD', '$'),
+    churnRate: payload.churn_rate,
+    mrr: toAmount(payload.mrr, 'USD', '$'),
+    ltv: payload.ltv,
+    netRevenueRetention: payload.net_revenue_retention,
+});
+export const mapInvoicingRevenueDataPointPayloadToState = (payload) => ({
+    month: payload.month,
+    revenue: toAmount(payload.revenue, 'USD', '$'),
+    arr: payload.arr != null ? toAmount(payload.arr, 'USD', '$') : undefined,
+});
+export const mapInvoicingMRRDataPointPayloadToState = (payload) => ({
+    month: payload.month,
+    mrr: toAmount(payload.mrr, 'USD', '$'),
+    churned: payload.churned,
+    expansion: payload.expansion,
+    monthNum: payload.month_num,
+    net: payload.net,
+    new: payload.new,
+    startMrr: payload.start_mrr != null
+        ? toAmount(payload.start_mrr, 'USD', '$')
+        : undefined,
+    year: payload.year,
+});
+export const mapInvoicingChurnDataPointPayloadToState = (payload) => ({
+    month: payload.month,
+    rate: payload.rate,
+    churned: payload.churned,
+    subscribers: payload.subscribers,
+});
+export const mapInvoicingPlanRevenuePointPayloadToState = (payload) => ({
+    mrr: toAmount(payload.mrr, 'USD', '$'),
+    pct: payload.pct,
+    planID: payload.plan,
+    productCode: payload.product_code,
+});
+export const mapInvoicingDashboardSummaryPayloadToState = (payload) => ({
+    customerMovement: {
+        churned: payload.customer_movement.churned,
+        netChange: payload.customer_movement.net_change,
+        new: payload.customer_movement.new,
+        paused: payload.customer_movement.paused,
+        reactivated: payload.customer_movement.reactivated,
+        resumed: payload.customer_movement.resumed,
+        totalActive: payload.customer_movement.total_active,
+        totalActiveValue: toAmount(payload.customer_movement.total_active_value, 'USD', '$'),
+    },
+    failedPayments: {
+        amount: toAmount(payload.failed_payments.amount, 'USD', '$'),
+        count: payload.failed_payments.count,
+    },
+    grossRevenueRetention: {
+        churn: toAmount(payload.grr.churn, 'USD', '$'),
+        contraction: toAmount(payload.grr.contraction, 'USD', '$'),
+        grr: payload.grr.grr,
+        retainedArr: toAmount(payload.grr.retained_arr, 'USD', '$'),
+        startingArr: toAmount(payload.grr.starting_arr, 'USD', '$'),
+    },
+    mrrMovement: {
+        churned: payload.mrr_movement.churned,
+        expansions: payload.mrr_movement.expansions,
+        netChange: payload.mrr_movement.net_change,
+        newSubscriptions: payload.mrr_movement.new_subscriptions,
+    },
+    netRevenueRetention: {
+        churn: toAmount(payload.nrr.churn, 'USD', '$'),
+        contraction: toAmount(payload.nrr.contraction, 'USD', '$'),
+        endingArr: toAmount(payload.nrr.ending_arr, 'USD', '$'),
+        expansionArr: toAmount(payload.nrr.expansion_arr, 'USD', '$'),
+        nrr: payload.nrr.nrr,
+        startingArr: toAmount(payload.nrr.starting_arr, 'USD', '$'),
+    },
+    outstanding: toAmount(payload.outstanding, 'USD', '$'),
+    pastDueInvoices: {
+        amount: toAmount(payload.past_due_invoices.amount, 'USD', '$'),
+        count: payload.past_due_invoices.count,
+    },
+    upcomingInvoices: {
+        amount: toAmount(payload.upcoming_invoices.amount, 'USD', '$'),
+        count: payload.upcoming_invoices.count,
+    },
+    outstandingChangePct: payload.outstanding_change_pct,
+});

package/lib/esm/view/invoicing/invoicingOverview/invoicingOverviewReducer.js

@@ -0,0 +1,115 @@
+import { createSlice } from '@reduxjs/toolkit';
+import { mapInvoicingChurnDataPointPayloadToState, mapInvoicingDashboardSummaryPayloadToState, mapInvoicingMRRDataPointPayloadToState, mapInvoicingOverviewKPIsPayloadToState, mapInvoicingPlanRevenuePointPayloadToState, mapInvoicingRevenueDataPointPayloadToState, } from './invoicingOverviewPayload';
+const notStarted = { fetchState: 'Not-Started', error: undefined };
+export const initialState = {
+    churn: [],
+    kpis: undefined,
+    mrr: [],
+    period: undefined,
+    planRevenue: [],
+    revenue: [],
+    summary: undefined,
+    churnFetchState: { ...notStarted },
+    kpisFetchState: { ...notStarted },
+    mrrFetchState: { ...notStarted },
+    planRevenueFetchState: { ...notStarted },
+    revenueFetchState: { ...notStarted },
+    summaryFetchState: { ...notStarted },
+};
+const invoicingOverview = createSlice({
+    name: 'invoicingOverview',
+    initialState,
+    reducers: {
+        // ── Orchestrator trigger (handled by fetchInvoicingOverviewEpic) ─────────
+        fetchInvoicingOverview: {
+            reducer(draft, action) {
+                draft.period = action.payload.period;
+            },
+            prepare(period, cacheOverride = false) {
+                return {
+                    payload: {
+                        period,
+                        cacheOverride,
+                    },
+                };
+            },
+        },
+        // ── KPIs ─────────────────────────────────────────────────────────────────
+        fetchInvoicingOverviewKPIs(draft) {
+            draft.kpisFetchState = { fetchState: 'In-Progress', error: undefined };
+        },
+        updateInvoicingOverviewKPIs(draft, action) {
+            draft.kpis = mapInvoicingOverviewKPIsPayloadToState(action.payload);
+            draft.kpisFetchState = { fetchState: 'Completed', error: undefined };
+        },
+        updateInvoicingOverviewKPIsFailure(draft, action) {
+            draft.kpisFetchState = { fetchState: 'Error', error: action.payload };
+        },
+        // ── Revenue ────────────────────────────────────────────────────────────────
+        fetchInvoicingOverviewRevenue(draft) {
+            draft.revenueFetchState = { fetchState: 'In-Progress', error: undefined };
+        },
+        updateInvoicingOverviewRevenue(draft, action) {
+            draft.revenue = action.payload.map(mapInvoicingRevenueDataPointPayloadToState);
+            draft.revenueFetchState = { fetchState: 'Completed', error: undefined };
+        },
+        updateInvoicingOverviewRevenueFailure(draft, action) {
+            draft.revenueFetchState = { fetchState: 'Error', error: action.payload };
+        },
+        // ── MRR ────────────────────────────────────────────────────────────────────
+        fetchInvoicingOverviewMRR(draft) {
+            draft.mrrFetchState = { fetchState: 'In-Progress', error: undefined };
+        },
+        updateInvoicingOverviewMRR(draft, action) {
+            draft.mrr = action.payload.map(mapInvoicingMRRDataPointPayloadToState);
+            draft.mrrFetchState = { fetchState: 'Completed', error: undefined };
+        },
+        updateInvoicingOverviewMRRFailure(draft, action) {
+            draft.mrrFetchState = { fetchState: 'Error', error: action.payload };
+        },
+        // ── Churn ──────────────────────────────────────────────────────────────────
+        fetchInvoicingOverviewChurn(draft) {
+            draft.churnFetchState = { fetchState: 'In-Progress', error: undefined };
+        },
+        updateInvoicingOverviewChurn(draft, action) {
+            draft.churn = action.payload.map(mapInvoicingChurnDataPointPayloadToState);
+            draft.churnFetchState = { fetchState: 'Completed', error: undefined };
+        },
+        updateInvoicingOverviewChurnFailure(draft, action) {
+            draft.churnFetchState = { fetchState: 'Error', error: action.payload };
+        },
+        // ── Plan revenue ───────────────────────────────────────────────────────────
+        fetchInvoicingOverviewPlanRevenue(draft) {
+            draft.planRevenueFetchState = {
+                fetchState: 'In-Progress',
+                error: undefined,
+            };
+        },
+        updateInvoicingOverviewPlanRevenue(draft, action) {
+            draft.planRevenue = action.payload.map(mapInvoicingPlanRevenuePointPayloadToState);
+            draft.planRevenueFetchState = { fetchState: 'Completed', error: undefined };
+        },
+        updateInvoicingOverviewPlanRevenueFailure(draft, action) {
+            draft.planRevenueFetchState = {
+                fetchState: 'Error',
+                error: action.payload,
+            };
+        },
+        // ── Dashboard summary ──────────────────────────────────────────────────────
+        fetchInvoicingOverviewDashboardSummary(draft) {
+            draft.summaryFetchState = { fetchState: 'In-Progress', error: undefined };
+        },
+        updateInvoicingOverviewDashboardSummary(draft, action) {
+            draft.summary = mapInvoicingDashboardSummaryPayloadToState(action.payload);
+            draft.summaryFetchState = { fetchState: 'Completed', error: undefined };
+        },
+        updateInvoicingOverviewDashboardSummaryFailure(draft, action) {
+            draft.summaryFetchState = { fetchState: 'Error', error: action.payload };
+        },
+        clearInvoicingOverview(draft) {
+            Object.assign(draft, initialState);
+        },
+    },
+});
+export const { fetchInvoicingOverview, fetchInvoicingOverviewKPIs, updateInvoicingOverviewKPIs, updateInvoicingOverviewKPIsFailure, fetchInvoicingOverviewRevenue, updateInvoicingOverviewRevenue, updateInvoicingOverviewRevenueFailure, fetchInvoicingOverviewMRR, updateInvoicingOverviewMRR, updateInvoicingOverviewMRRFailure, fetchInvoicingOverviewChurn, updateInvoicingOverviewChurn, updateInvoicingOverviewChurnFailure, fetchInvoicingOverviewPlanRevenue, updateInvoicingOverviewPlanRevenue, updateInvoicingOverviewPlanRevenueFailure, fetchInvoicingOverviewDashboardSummary, updateInvoicingOverviewDashboardSummary, updateInvoicingOverviewDashboardSummaryFailure, clearInvoicingOverview, } = invoicingOverview.actions;
+export default invoicingOverview.reducer;

package/lib/esm/view/invoicing/invoicingOverview/invoicingOverviewSelector.js

@@ -0,0 +1,65 @@
+import { reduceAllFetchState } from '../../../commonStateTypes/reduceFetchState';
+import { getInvoicingSubscriptionListView } from '../invoicingSubscriptionListView/invoicingSubscriptionListViewSelector';
+import { getInvoicingSettings, getInvoicingSettingsFetchState, } from '../settingsView/settingsViewSelector';
+const PERIOD_OPTION_MONTHS = 12;
+function daysInMonth(year, month) {
+    return new Date(year, month, 0).getDate();
+}
+/** "Jun 1 - Jun 30, 2026" labels for the trailing months, newest first. */
+export function buildPeriodOptions() {
+    const now = new Date();
+    const options = [];
+    for (let offset = 0; offset < PERIOD_OPTION_MONTHS; offset += 1) {
+        const date = new Date(now.getFullYear(), now.getMonth() - offset, 1);
+        const year = date.getFullYear();
+        const month = date.getMonth() + 1;
+        const monthName = date.toLocaleDateString('en-US', { month: 'short' });
+        options.push({
+            label: `${monthName} 1 - ${monthName} ${daysInMonth(year, month)}, ${year}`,
+            month,
+            year,
+        });
+    }
+    return options;
+}
+export const getInvoicingOverview = (state) => {
+    const overview = state.invoicingOverviewState;
+    const settingsFetchState = getInvoicingSettingsFetchState(state);
+    const subscriptionListView = getInvoicingSubscriptionListView(state);
+    const subscriptionListFetchState = {
+        fetchState: subscriptionListView.fetchState,
+        error: subscriptionListView.error,
+    };
+    const reducedFetchState = reduceAllFetchState([
+        overview.kpisFetchState,
+        overview.revenueFetchState,
+        overview.mrrFetchState,
+        overview.churnFetchState,
+        overview.planRevenueFetchState,
+        overview.summaryFetchState,
+        settingsFetchState,
+        subscriptionListFetchState,
+    ]);
+    return {
+        kpis: { data: overview.kpis, fetchState: overview.kpisFetchState },
+        revenue: { data: overview.revenue, fetchState: overview.revenueFetchState },
+        mrr: { data: overview.mrr, fetchState: overview.mrrFetchState },
+        periodOptions: buildPeriodOptions(),
+        churn: { data: overview.churn, fetchState: overview.churnFetchState },
+        planRevenue: {
+            data: overview.planRevenue,
+            fetchState: overview.planRevenueFetchState,
+        },
+        summary: { data: overview.summary, fetchState: overview.summaryFetchState },
+        settings: {
+            data: getInvoicingSettings(state),
+            fetchState: settingsFetchState,
+        },
+        subscriptionList: {
+            data: subscriptionListView.subscriptions,
+            fetchState: subscriptionListFetchState,
+        },
+        ...reducedFetchState,
+        version: 1.0,
+    };
+};

package/lib/esm/view/invoicing/invoicingOverview/invoicingOverviewState.js

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

package/lib/esm/view/invoicing/invoicingSubscriptionDetailView/invoicingSubscriptionDetailViewEpics.js

@@ -0,0 +1,22 @@
+import { of } from 'rxjs';
+import { catchError, filter, switchMap } from 'rxjs/operators';
+import { updateAddresses } from '../../../entity/address/addressReducer';
+import { extractInvoicingSubscriptionAddresses } from '../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionPayload';
+import { updateInvoicingSubscriptions } from '../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionReducer';
+import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { fetchInvoicingSubscriptionDetail, updateInvoicingSubscriptionDetail, updateInvoicingSubscriptionDetailFailure, } from './invoicingSubscriptionDetailViewReducer';
+export const fetchInvoicingSubscriptionDetailEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(fetchInvoicingSubscriptionDetail.match), switchMap((action) => {
+    const { id } = action.payload;
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/subscriptions/${id}`;
+    return zeniAPI.getJSON(apiUrl).pipe(switchMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            return [
+                updateAddresses(extractInvoicingSubscriptionAddresses([response.data])),
+                updateInvoicingSubscriptions([response.data], 'merge'),
+                updateInvoicingSubscriptionDetail({ id: response.data.id }),
+            ];
+        }
+        return of(updateInvoicingSubscriptionDetailFailure(response.status));
+    }), catchError((error) => of(updateInvoicingSubscriptionDetailFailure(createZeniAPIStatus('Unexpected Error', 'Fetch subscription detail REST API call errored out ' +
+        JSON.stringify(error))))));
+}));

package/lib/esm/view/invoicing/invoicingSubscriptionDetailView/invoicingSubscriptionDetailViewPayload.js

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

package/lib/esm/view/invoicing/invoicingSubscriptionDetailView/invoicingSubscriptionDetailViewReducer.js

@@ -0,0 +1,31 @@
+import { createSlice } from '@reduxjs/toolkit';
+export const initialState = {
+    fetchState: 'Not-Started',
+    error: undefined,
+    id: undefined,
+};
+const invoicingSubscriptionDetailView = createSlice({
+    name: 'invoicingSubscriptionDetailView',
+    initialState,
+    reducers: {
+        fetchInvoicingSubscriptionDetail(draft, action) {
+            draft.id = action.payload.id;
+            draft.fetchState = 'In-Progress';
+            draft.error = undefined;
+        },
+        updateInvoicingSubscriptionDetail(draft, action) {
+            draft.id = action.payload.id;
+            draft.fetchState = 'Completed';
+            draft.error = undefined;
+        },
+        updateInvoicingSubscriptionDetailFailure(draft, action) {
+            draft.fetchState = 'Error';
+            draft.error = action.payload;
+        },
+        clearInvoicingSubscriptionDetailView(draft) {
+            Object.assign(draft, initialState);
+        },
+    },
+});
+export const { fetchInvoicingSubscriptionDetail, updateInvoicingSubscriptionDetail, updateInvoicingSubscriptionDetailFailure, clearInvoicingSubscriptionDetailView, } = invoicingSubscriptionDetailView.actions;
+export default invoicingSubscriptionDetailView.reducer;