@zeniai/client-epic-state 5.1.39 → 5.1.40-betaAK1

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

@@ -0,0 +1,53 @@
+import { of } from 'rxjs';
+import { catchError, filter, switchMap } from 'rxjs/operators';
+import { updateInvoices } from '../../../entity/invoicing/invoice/invoiceReducer';
+import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { INVOICING_LIST_PAGE_SIZE, applyListSortParams, withQuery, } from '../invoicingApiHelper';
+import { fetchInvoiceList, updateInvoiceList, updateInvoiceListFailure, } from './invoiceListReducer';
+const buildInvoiceListQuery = (filters, cursor, sort) => {
+    const params = new URLSearchParams();
+    if (filters.status != null && filters.status.length > 0) {
+        params.set('status', filters.status);
+    }
+    if (filters.customerId != null) {
+        params.set('customer_id', filters.customerId);
+    }
+    if (filters.subscriptionId != null) {
+        params.set('subscription_id', filters.subscriptionId);
+    }
+    if (filters.search != null && filters.search.length > 0) {
+        params.set('search', filters.search);
+    }
+    if (filters.dateFrom != null) {
+        params.set('date_from', filters.dateFrom);
+    }
+    if (filters.dateTo != null) {
+        params.set('date_to', filters.dateTo);
+    }
+    params.set('limit', String(INVOICING_LIST_PAGE_SIZE));
+    if (cursor != null) {
+        params.set('cursor', cursor);
+    }
+    applyListSortParams(params, sort);
+    return params;
+};
+export const fetchInvoiceListEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(fetchInvoiceList.match), switchMap((action) => {
+    const { filters, cursor, keepExistingListItems, sort } = action.payload;
+    const apiUrl = withQuery(`${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/invoices`, buildInvoiceListQuery(filters, cursor, sort));
+    return zeniAPI.getJSON(apiUrl).pipe(switchMap((response) => {
+        if (isSuccessResponse(response)) {
+            const items = response.data?.items ?? [];
+            const actions = [
+                updateInvoices(items, 'merge'),
+                updateInvoiceList({
+                    invoices: items,
+                    nextCursor: response.data?.next_cursor ?? null,
+                    keepExistingListItems,
+                }),
+            ];
+            return actions;
+        }
+        return of(updateInvoiceListFailure(response.status));
+    }), catchError((error) => of(updateInvoiceListFailure(createZeniAPIStatus('Unexpected Error', 'Fetch invoice list REST API call errored out ' +
+        JSON.stringify(error))))));
+}));

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

@@ -0,0 +1,30 @@
+import { concat, from } from 'rxjs';
+import { filter, mergeMap } from 'rxjs/operators';
+import { fetchInvoiceCounts, fetchInvoiceKPIs, fetchInvoiceList, fetchInvoiceListPage, } from './invoiceListReducer';
+/**
+ * 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 invoices list page: on `fetchInvoiceListPage`, fans out to
+ * the list, counts and KPIs fetches, skipping any whose data is already cached
+ * unless `cacheOverride` is set (e.g. on a filter/sort change).
+ */
+export const fetchInvoiceListPageEpic = (actions$, state$) => actions$.pipe(filter(fetchInvoiceListPage.match), mergeMap((action) => {
+    const { cacheOverride, filters, sort } = action.payload;
+    const state = state$.value.invoicingInvoiceListState;
+    const pageActions = [];
+    if (shouldFetch({ fetchState: state.fetchState, error: state.error }, cacheOverride)) {
+        pageActions.push(fetchInvoiceList({ filters, sort }));
+    }
+    if (shouldFetch(state.countsFetchState, cacheOverride)) {
+        pageActions.push(fetchInvoiceCounts());
+    }
+    if (shouldFetch(state.kpisFetchState, cacheOverride)) {
+        pageActions.push(fetchInvoiceKPIs());
+    }
+    return concat(from(pageActions));
+}));

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

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

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

@@ -0,0 +1,105 @@
+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,
+                    },
+                };
+            },
+        },
+        fetchInvoiceListPage: {
+            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,
+                    },
+                };
+            },
+        },
+        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, fetchInvoiceListPage, 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,23 @@
+import { createSelector } from '@reduxjs/toolkit';
+import { INVOICING_INVOICE_TABS, } from './invoiceListState';
+/**
+ * Bundled read view for the invoices list page: the denormalized invoice rows
+ * plus list counts, KPIs and their fetch states. Memoized so the `invoices`
+ * array (and the wrapping view object) keep referential identity until the
+ * invoice entity slice or the list-view slice actually change.
+ */
+export const getInvoiceListView = createSelector((state) => state.invoicingInvoiceState, (state) => state.invoicingInvoiceListState, (invoiceState, listViewState) => ({
+    invoices: listViewState.invoiceIds
+        .map((id) => invoiceState.invoiceByID[id])
+        .filter((item) => item != null),
+    counts: listViewState.counts,
+    countsFetchState: listViewState.countsFetchState,
+    filters: listViewState.filters,
+    kpis: listViewState.kpis,
+    kpisFetchState: listViewState.kpisFetchState,
+    nextCursor: listViewState.nextCursor,
+    tabIds: INVOICING_INVOICE_TABS,
+    fetchState: listViewState.fetchState,
+    error: listViewState.error,
+    version: 1.0,
+}));

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

@@ -0,0 +1,19 @@
+import { stringToUnion } from '../../../commonStateTypes/stringToUnion';
+export const ALL_INVOICING_INVOICE_TAB_IDS = [
+    'all',
+    'paid',
+    'partially_paid',
+    'payment_due',
+    'not_paid',
+    'voided',
+];
+export const toInvoicingInvoiceTabId = (v) => stringToUnion(v, ALL_INVOICING_INVOICE_TAB_IDS);
+/**
+ * Ordered filter-tab id set owned by CES so the invoice-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_INVOICE_TABS = [
+    ...ALL_INVOICING_INVOICE_TAB_IDS,
+];

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/invoicingCatalogItemDetailView/invoicingCatalogItemDetailViewEpics.js

@@ -0,0 +1,24 @@
+import { of } from 'rxjs';
+import { catchError, filter, switchMap } from 'rxjs/operators';
+import { updateInvoicingPlans } from '../../../entity/invoicing/plan/planReducer';
+import { updateInvoicingProducts } from '../../../entity/invoicing/product/productReducer';
+import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { fetchInvoicingCatalogItemDetail, updateInvoicingCatalogItemDetail, updateInvoicingCatalogItemDetailFailure, } from './invoicingCatalogItemDetailViewReducer';
+export const fetchInvoicingCatalogItemDetailEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(fetchInvoicingCatalogItemDetail.match), switchMap((action) => {
+    const { id, kind } = action.payload;
+    const collection = kind === 'plan' ? 'plans' : 'products';
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/catalog/${collection}/${id}`;
+    return zeniAPI.getJSON(apiUrl).pipe(switchMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            const entityAction = kind === 'plan'
+                ? updateInvoicingPlans([response.data], 'merge')
+                : updateInvoicingProducts([response.data], 'merge');
+            return [
+                entityAction,
+                updateInvoicingCatalogItemDetail({ id: response.data.id, kind }),
+            ];
+        }
+        return of(updateInvoicingCatalogItemDetailFailure(response.status));
+    }), catchError((error) => of(updateInvoicingCatalogItemDetailFailure(createZeniAPIStatus('Unexpected Error', 'Fetch catalog item detail REST API call errored out ' +
+        JSON.stringify(error))))));
+}));

package/lib/esm/view/invoicing/invoicingCatalogItemDetailView/invoicingCatalogItemDetailViewPayload.js

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

package/lib/esm/view/invoicing/invoicingCatalogItemDetailView/invoicingCatalogItemDetailViewReducer.js

@@ -0,0 +1,34 @@
+import { createSlice } from '@reduxjs/toolkit';
+export const initialState = {
+    fetchState: 'Not-Started',
+    error: undefined,
+    id: undefined,
+    kind: undefined,
+};
+const invoicingCatalogItemDetailView = createSlice({
+    name: 'invoicingCatalogItemDetailView',
+    initialState,
+    reducers: {
+        fetchInvoicingCatalogItemDetail(draft, action) {
+            draft.id = action.payload.id;
+            draft.kind = action.payload.kind;
+            draft.fetchState = 'In-Progress';
+            draft.error = undefined;
+        },
+        updateInvoicingCatalogItemDetail(draft, action) {
+            draft.id = action.payload.id;
+            draft.kind = action.payload.kind;
+            draft.fetchState = 'Completed';
+            draft.error = undefined;
+        },
+        updateInvoicingCatalogItemDetailFailure(draft, action) {
+            draft.fetchState = 'Error';
+            draft.error = action.payload;
+        },
+        clearInvoicingCatalogItemDetailView(draft) {
+            Object.assign(draft, initialState);
+        },
+    },
+});
+export const { fetchInvoicingCatalogItemDetail, updateInvoicingCatalogItemDetail, updateInvoicingCatalogItemDetailFailure, clearInvoicingCatalogItemDetailView, } = invoicingCatalogItemDetailView.actions;
+export default invoicingCatalogItemDetailView.reducer;

package/lib/esm/view/invoicing/invoicingCatalogItemDetailView/invoicingCatalogItemDetailViewSelector.js

@@ -0,0 +1,14 @@
+import { getInvoicingPlanById as getInvoicingPlanByIdFromState } from '../../../entity/invoicing/plan/planSelector';
+import { getInvoicingProductById as getInvoicingProductByIdFromState } from '../../../entity/invoicing/product/productSelector';
+export const getInvoicingPlanById = (state, id) => getInvoicingPlanByIdFromState(state.invoicingPlanState, id);
+export const getInvoicingProductById = (state, id) => getInvoicingProductByIdFromState(state.invoicingProductState, id);
+export const getInvoicingCatalogItemDetail = (state, kind, id) => {
+    const { error, fetchState } = state.invoicingCatalogItemDetailViewState;
+    return {
+        plan: kind === 'plan' ? getInvoicingPlanById(state, id) : undefined,
+        product: kind === 'product' ? getInvoicingProductById(state, id) : undefined,
+        fetchState,
+        error,
+        version: 1.0,
+    };
+};

package/lib/esm/view/invoicing/invoicingCatalogItemDetailView/invoicingCatalogItemDetailViewState.js

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

package/lib/esm/view/invoicing/invoicingCatalogListView/epics/fetchInvoicingCatalogCountsEpic.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 { fetchInvoicingCatalogCounts, updateInvoicingCatalogCounts, updateInvoicingCatalogCountsFailure, } from '../invoicingCatalogListViewReducer';
+export const fetchInvoicingCatalogCountsEpic = (actions$, state$, zeniAPI) => actions$.pipe(filter(fetchInvoicingCatalogCounts.match), switchMap(() => {
+    const { planFilters } = state$.value.invoicingCatalogListViewState;
+    const params = new URLSearchParams();
+    if (planFilters.search != null && planFilters.search.length > 0) {
+        params.set('search', planFilters.search);
+    }
+    const apiUrl = withQuery(`${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/catalog/counts`, params);
+    return zeniAPI.getJSON(apiUrl).pipe(switchMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            return of(updateInvoicingCatalogCounts(response.data));
+        }
+        return of(updateInvoicingCatalogCountsFailure(response.status));
+    }), catchError((error) => of(updateInvoicingCatalogCountsFailure(createZeniAPIStatus('Unexpected Error', 'Fetch catalog counts REST API call errored out ' +
+        JSON.stringify(error))))));
+}));

package/lib/esm/view/invoicing/invoicingCatalogListView/epics/fetchInvoicingCatalogListPageEpic.js

@@ -0,0 +1,33 @@
+import { concat, from } from 'rxjs';
+import { filter, mergeMap } from 'rxjs/operators';
+import { fetchInvoicingCatalogCounts, fetchInvoicingCatalogListPage, fetchInvoicingCatalogPlanList, fetchInvoicingCatalogProductList, } from '../invoicingCatalogListViewReducer';
+/**
+ * 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 catalog page: on `fetchInvoicingCatalogListPage`, fans out to
+ * the plan-list, product-list, counts fetches, skipping any whose data
+ * is already cached unless `cacheOverride` is set (e.g. on a filter/sort change).
+ */
+export const fetchInvoicingCatalogListPageEpic = (actions$, state$) => actions$.pipe(filter(fetchInvoicingCatalogListPage.match), mergeMap((action) => {
+    const { cacheOverride, planFilters, productFilters, planSort, productSort, } = action.payload;
+    const state = state$.value.invoicingCatalogListViewState;
+    const pageActions = [];
+    if (shouldFetch({ fetchState: state.fetchState, error: state.error }, cacheOverride)) {
+        pageActions.push(fetchInvoicingCatalogPlanList({ filters: planFilters, sort: planSort }));
+    }
+    if (shouldFetch(state.productFetchState, cacheOverride)) {
+        pageActions.push(fetchInvoicingCatalogProductList({
+            filters: productFilters,
+            sort: productSort,
+        }));
+    }
+    if (shouldFetch(state.countsFetchState, cacheOverride)) {
+        pageActions.push(fetchInvoicingCatalogCounts());
+    }
+    return concat(from(pageActions));
+}));

package/lib/esm/view/invoicing/invoicingCatalogListView/epics/fetchInvoicingCatalogPlanListEpic.js

@@ -0,0 +1,43 @@
+import { of } from 'rxjs';
+import { catchError, filter, switchMap } from 'rxjs/operators';
+import { updateInvoicingPlans } from '../../../../entity/invoicing/plan/planReducer';
+import { createZeniAPIStatus, isSuccessResponse, } from '../../../../responsePayload';
+import { INVOICING_LIST_PAGE_SIZE, applyListSortParams, withQuery, } from '../../invoicingApiHelper';
+import { fetchInvoicingCatalogPlanList, updateInvoicingCatalogPlanList, updateInvoicingCatalogPlanListFailure, } from '../invoicingCatalogListViewReducer';
+const buildPlanQuery = (filters, cursor, sort) => {
+    const params = new URLSearchParams();
+    if (filters.status != null && filters.status.length > 0) {
+        params.set('status', filters.status);
+    }
+    if (filters.type != null && filters.type.length > 0) {
+        params.set('type', filters.type);
+    }
+    if (filters.search != null && filters.search.length > 0) {
+        params.set('search', filters.search);
+    }
+    params.set('limit', String(INVOICING_LIST_PAGE_SIZE));
+    if (cursor != null) {
+        params.set('cursor', cursor);
+    }
+    applyListSortParams(params, sort);
+    return params;
+};
+export const fetchInvoicingCatalogPlanListEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(fetchInvoicingCatalogPlanList.match), switchMap((action) => {
+    const { filters, cursor, keepExistingListItems, sort } = action.payload;
+    const apiUrl = withQuery(`${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/catalog/plans`, buildPlanQuery(filters, cursor, sort));
+    return zeniAPI.getJSON(apiUrl).pipe(switchMap((response) => {
+        if (isSuccessResponse(response)) {
+            const items = response.data?.items ?? [];
+            return [
+                updateInvoicingPlans(items, 'merge'),
+                updateInvoicingCatalogPlanList({
+                    ids: items.map((item) => item.id),
+                    nextCursor: response.data?.next_cursor ?? null,
+                    keepExistingListItems,
+                }),
+            ];
+        }
+        return of(updateInvoicingCatalogPlanListFailure(response.status));
+    }), catchError((error) => of(updateInvoicingCatalogPlanListFailure(createZeniAPIStatus('Unexpected Error', 'Fetch catalog plan list REST API call errored out ' +
+        JSON.stringify(error))))));
+}));

package/lib/esm/view/invoicing/invoicingCatalogListView/epics/fetchInvoicingCatalogProductListEpic.js

@@ -0,0 +1,46 @@
+import { of } from 'rxjs';
+import { catchError, filter, switchMap } from 'rxjs/operators';
+import { updateInvoicingProducts } from '../../../../entity/invoicing/product/productReducer';
+import { createZeniAPIStatus, isSuccessResponse, } from '../../../../responsePayload';
+import { INVOICING_LIST_PAGE_SIZE, applyListSortParams, withQuery, } from '../../invoicingApiHelper';
+import { fetchInvoicingCatalogProductList, updateInvoicingCatalogProductList, updateInvoicingCatalogProductListFailure, } from '../invoicingCatalogListViewReducer';
+const buildProductQuery = (filters, cursor, sort) => {
+    const params = new URLSearchParams();
+    if (filters.item_id != null && filters.item_id.length > 0) {
+        params.set('item_id', filters.item_id);
+    }
+    if (filters.item_type != null && filters.item_type.length > 0) {
+        params.set('item_type', filters.item_type);
+    }
+    if (filters.status != null && filters.status.length > 0) {
+        params.set('status', filters.status);
+    }
+    if (filters.search != null && filters.search.length > 0) {
+        params.set('search', filters.search);
+    }
+    params.set('limit', String(INVOICING_LIST_PAGE_SIZE));
+    if (cursor != null) {
+        params.set('cursor', cursor);
+    }
+    applyListSortParams(params, sort);
+    return params;
+};
+export const fetchInvoicingCatalogProductListEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(fetchInvoicingCatalogProductList.match), switchMap((action) => {
+    const { filters, cursor, keepExistingListItems, sort } = action.payload;
+    const apiUrl = withQuery(`${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/catalog/products`, buildProductQuery(filters, cursor, sort));
+    return zeniAPI.getJSON(apiUrl).pipe(switchMap((response) => {
+        if (isSuccessResponse(response)) {
+            const items = response.data?.items ?? [];
+            return [
+                updateInvoicingProducts(items, 'merge'),
+                updateInvoicingCatalogProductList({
+                    ids: items.map((item) => item.id),
+                    nextCursor: response.data?.next_cursor ?? null,
+                    keepExistingListItems,
+                }),
+            ];
+        }
+        return of(updateInvoicingCatalogProductListFailure(response.status));
+    }), catchError((error) => of(updateInvoicingCatalogProductListFailure(createZeniAPIStatus('Unexpected Error', 'Fetch catalog product list REST API call errored out ' +
+        JSON.stringify(error))))));
+}));

package/lib/esm/view/invoicing/invoicingCatalogListView/invoicingCatalogListViewPayload.js

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

package/lib/esm/view/invoicing/invoicingCatalogListView/invoicingCatalogListViewReducer.js

@@ -0,0 +1,132 @@
+import { createSlice } from '@reduxjs/toolkit';
+export const initialState = {
+    fetchState: 'Not-Started',
+    error: undefined,
+    planIds: [],
+    planNextCursor: null,
+    planFilters: {},
+    productIds: [],
+    productNextCursor: null,
+    productFetchState: { fetchState: 'Not-Started', error: undefined },
+    productFilters: {},
+    counts: { all: 0 },
+    countsFetchState: { fetchState: 'Not-Started', error: undefined },
+    hasValidState() {
+        return this.fetchState === 'Completed';
+    },
+};
+const invoicingCatalogListView = createSlice({
+    name: 'invoicingCatalogListView',
+    initialState,
+    reducers: {
+        fetchInvoicingCatalogPlanList: {
+            reducer(draft, action) {
+                if (!action.payload.keepExistingListItems) {
+                    draft.planIds = [];
+                    draft.planNextCursor = null;
+                }
+                draft.planFilters = action.payload.filters;
+                draft.planSort = 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,
+                    },
+                };
+            },
+        },
+        updateInvoicingCatalogPlanList(draft, action) {
+            draft.planIds = action.payload.keepExistingListItems
+                ? [...new Set([...draft.planIds, ...action.payload.ids])]
+                : action.payload.ids;
+            draft.planNextCursor = action.payload.nextCursor;
+            draft.fetchState = 'Completed';
+            draft.error = undefined;
+        },
+        updateInvoicingCatalogPlanListFailure(draft, action) {
+            draft.fetchState = 'Error';
+            draft.error = action.payload;
+        },
+        fetchInvoicingCatalogProductList: {
+            reducer(draft, action) {
+                if (!action.payload.keepExistingListItems) {
+                    draft.productIds = [];
+                    draft.productNextCursor = null;
+                }
+                draft.productFilters = action.payload.filters;
+                draft.productSort = action.payload.sort;
+                draft.productFetchState.fetchState = 'In-Progress';
+                draft.productFetchState.error = undefined;
+            },
+            prepare(payload) {
+                return {
+                    payload: {
+                        filters: payload.filters ?? {},
+                        cursor: payload.cursor,
+                        keepExistingListItems: payload.keepExistingListItems ?? false,
+                        sort: payload.sort,
+                    },
+                };
+            },
+        },
+        updateInvoicingCatalogProductList(draft, action) {
+            draft.productIds = action.payload.keepExistingListItems
+                ? [...new Set([...draft.productIds, ...action.payload.ids])]
+                : action.payload.ids;
+            draft.productNextCursor = action.payload.nextCursor;
+            draft.productFetchState.fetchState = 'Completed';
+            draft.productFetchState.error = undefined;
+        },
+        updateInvoicingCatalogProductListFailure(draft, action) {
+            draft.productFetchState.fetchState = 'Error';
+            draft.productFetchState.error = action.payload;
+        },
+        fetchInvoicingCatalogCounts(draft) {
+            draft.countsFetchState.fetchState = 'In-Progress';
+            draft.countsFetchState.error = undefined;
+        },
+        updateInvoicingCatalogCounts(draft, action) {
+            draft.counts = action.payload;
+            draft.countsFetchState.fetchState = 'Completed';
+            draft.countsFetchState.error = undefined;
+        },
+        updateInvoicingCatalogCountsFailure(draft, action) {
+            draft.countsFetchState.fetchState = 'Error';
+            draft.countsFetchState.error = action.payload;
+        },
+        updateInvoicingCatalogPlanFilters(draft, action) {
+            draft.planFilters = action.payload;
+        },
+        updateInvoicingCatalogProductFilters(draft, action) {
+            draft.productFilters = action.payload;
+        },
+        fetchInvoicingCatalogListPage: {
+            reducer() {
+                // No state mutation; the aggregator epic fans out the plan-list,
+                // product-list, counts fetches in response to this action.
+            },
+            prepare(payload) {
+                return {
+                    payload: {
+                        cacheOverride: payload.cacheOverride ?? false,
+                        planFilters: payload.planFilters ?? {},
+                        productFilters: payload.productFilters ?? {},
+                        planSort: payload.planSort,
+                        productSort: payload.productSort,
+                    },
+                };
+            },
+        },
+        clearInvoicingCatalogListView(draft) {
+            Object.assign(draft, initialState);
+        },
+    },
+});
+export const { fetchInvoicingCatalogPlanList, updateInvoicingCatalogPlanList, updateInvoicingCatalogPlanListFailure, fetchInvoicingCatalogProductList, updateInvoicingCatalogProductList, updateInvoicingCatalogProductListFailure, fetchInvoicingCatalogCounts, updateInvoicingCatalogCounts, updateInvoicingCatalogCountsFailure, updateInvoicingCatalogPlanFilters, updateInvoicingCatalogProductFilters, fetchInvoicingCatalogListPage, clearInvoicingCatalogListView, } = invoicingCatalogListView.actions;
+export default invoicingCatalogListView.reducer;

package/lib/esm/view/invoicing/invoicingCatalogListView/invoicingCatalogListViewSelector.js

@@ -0,0 +1,26 @@
+import { createSelector } from '@reduxjs/toolkit';
+import { getInvoicingPlansByIds } from '../../../entity/invoicing/plan/planSelector';
+import { getInvoicingProductsByIds } from '../../../entity/invoicing/product/productSelector';
+import { INVOICING_PRODUCT_COLUMNS, } from './invoicingCatalogListViewState';
+/**
+ * Bundled read view for the single catalog page (plans + products tabs).
+ * Memoized over the plan + product entity slices and the list-view slice so the
+ * denormalized arrays keep referential identity. The base `fetchState`/`error`
+ * track the plan list; the product list has its own `productFetchState`.
+ */
+export const getInvoicingCatalogListView = createSelector((state) => state.invoicingPlanState, (state) => state.invoicingProductState, (state) => state.invoicingCatalogListViewState, (planState, productState, listViewState) => ({
+    plans: getInvoicingPlansByIds(planState, listViewState.planIds),
+    productColumns: INVOICING_PRODUCT_COLUMNS,
+    products: getInvoicingProductsByIds(productState, listViewState.productIds),
+    productSort: listViewState.productSort,
+    count: listViewState.counts,
+    countsFetchState: listViewState.countsFetchState,
+    planFilters: listViewState.planFilters,
+    planNextCursor: listViewState.planNextCursor,
+    productFilters: listViewState.productFilters,
+    productNextCursor: listViewState.productNextCursor,
+    productFetchState: listViewState.productFetchState,
+    fetchState: listViewState.fetchState,
+    error: listViewState.error,
+    version: 1.0,
+}));