@zeniai/client-epic-state 5.1.60 → 5.1.61

package/lib/view/invoicing/invoiceAction/invoiceActionSelector.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getInvoicingInvoiceActionState = void 0;
+const NOT_STARTED = {
+    fetchState: 'Not-Started',
+    error: undefined,
+};
+const getInvoicingInvoiceActionState = (invoiceId) => (state) => state.invoicingInvoiceActionState.byInvoiceId[invoiceId] ?? NOT_STARTED;
+exports.getInvoicingInvoiceActionState = getInvoicingInvoiceActionState;

package/lib/view/invoicing/invoiceAction/invoiceActionState.d.ts

@@ -0,0 +1,5 @@
+import { FetchStateAndError, ID } from '../../../commonStateTypes/common';
+/** Per-invoice action fetch state keyed by invoice id. */
+export interface InvoicingInvoiceActionState {
+    byInvoiceId: Record<ID, FetchStateAndError>;
+}

package/lib/view/invoicing/invoiceAction/invoiceActionState.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/view/invoicing/invoiceDetail/fetchInvoiceDetailEpic.d.ts

@@ -0,0 +1,9 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { updateAddresses } from '../../../entity/address/addressReducer';
+import { updateInvoices } from '../../../entity/invoicing/invoice/invoiceReducer';
+import { RootState } from '../../../reducer';
+import { ZeniAPI } from '../../../zeniAPI';
+import { fetchInvoiceDetail, updateInvoiceDetail, updateInvoiceDetailFailure } from './invoiceDetailReducer';
+export type ActionType = ReturnType<typeof fetchInvoiceDetail> | ReturnType<typeof updateInvoiceDetail> | ReturnType<typeof updateInvoiceDetailFailure> | ReturnType<typeof updateAddresses> | ReturnType<typeof updateInvoices>;
+export declare const fetchInvoiceDetailEpic: (actions$: ActionsObservable<ActionType>, _state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

package/lib/view/invoicing/invoiceDetail/fetchInvoiceDetailEpic.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchInvoiceDetailEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const addressReducer_1 = require("../../../entity/address/addressReducer");
+const invoicePayload_1 = require("../../../entity/invoicing/invoice/invoicePayload");
+const invoiceReducer_1 = require("../../../entity/invoicing/invoice/invoiceReducer");
+const responsePayload_1 = require("../../../responsePayload");
+const invoiceDetailReducer_1 = require("./invoiceDetailReducer");
+const fetchInvoiceDetailEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(invoiceDetailReducer_1.fetchInvoiceDetail.match), (0, operators_1.switchMap)((action) => {
+    const { invoiceId } = action.payload;
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/invoices/${invoiceId}`;
+    return zeniAPI.getJSON(apiUrl).pipe((0, operators_1.switchMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response) && response.data != null) {
+            return [
+                (0, addressReducer_1.updateAddresses)((0, invoicePayload_1.extractInvoicingInvoiceAddresses)([response.data])),
+                (0, invoiceReducer_1.updateInvoices)([response.data], 'merge'),
+                (0, invoiceDetailReducer_1.updateInvoiceDetail)({ invoiceId: response.data.id }),
+            ];
+        }
+        return (0, rxjs_1.of)((0, invoiceDetailReducer_1.updateInvoiceDetailFailure)({ invoiceId, status: response.status }));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, invoiceDetailReducer_1.updateInvoiceDetailFailure)({
+        invoiceId,
+        status: (0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Fetch invoice detail REST API call errored out ' +
+            JSON.stringify(error)),
+    }))));
+}));
+exports.fetchInvoiceDetailEpic = fetchInvoiceDetailEpic;

package/lib/view/invoicing/invoiceDetail/invoiceDetailPayload.d.ts

@@ -0,0 +1,3 @@
+import { InvoicingInvoicePayload } from '../../../entity/invoicing/invoice/invoicePayload';
+import { ZeniAPIResponse } from '../../../responsePayload';
+export type InvoiceDetailResponse = ZeniAPIResponse<InvoicingInvoicePayload>;

package/lib/view/invoicing/invoiceDetail/invoiceDetailPayload.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/view/invoicing/invoiceDetail/invoiceDetailReducer.d.ts

@@ -0,0 +1,16 @@
+import { FetchState, ID } from '../../../commonStateTypes/common';
+import { ZeniAPIStatus } from '../../../responsePayload';
+import { InvoiceDetail, InvoiceDetailState } from './invoiceDetailState';
+export declare const initialState: InvoiceDetailState;
+/** Build a per-invoice detail fetch-state entry. */
+export declare function buildInvoiceDetail(id: ID, fetchState: FetchState, error?: ZeniAPIStatus): InvoiceDetail;
+export declare const fetchInvoiceDetail: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    invoiceId: ID;
+}, "invoicingInvoiceDetail/fetchInvoiceDetail">, updateInvoiceDetail: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    invoiceId: ID;
+}, "invoicingInvoiceDetail/updateInvoiceDetail">, updateInvoiceDetailFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    invoiceId: ID;
+    status: ZeniAPIStatus;
+}, "invoicingInvoiceDetail/updateInvoiceDetailFailure">, clearAllInvoiceDetail: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingInvoiceDetail/clearAllInvoiceDetail">;
+declare const _default: import("redux").Reducer<InvoiceDetailState>;
+export default _default;

package/lib/view/invoicing/invoiceDetail/invoiceDetailReducer.js

@@ -0,0 +1,43 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearAllInvoiceDetail = exports.updateInvoiceDetailFailure = exports.updateInvoiceDetail = exports.fetchInvoiceDetail = exports.initialState = void 0;
+exports.buildInvoiceDetail = buildInvoiceDetail;
+const toolkit_1 = require("@reduxjs/toolkit");
+exports.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-invoice detail fetch-state entry. */
+function buildInvoiceDetail(id, fetchState, error) {
+    return { id, fetchState, error, hasValidState: hasCompletedFetch };
+}
+const invoiceDetail = (0, toolkit_1.createSlice)({
+    name: 'invoicingInvoiceDetail',
+    initialState: exports.initialState,
+    reducers: {
+        fetchInvoiceDetail(draft, action) {
+            const { invoiceId } = action.payload;
+            draft.detailById[invoiceId] = buildInvoiceDetail(invoiceId, 'In-Progress');
+        },
+        updateInvoiceDetail(draft, action) {
+            const { invoiceId } = action.payload;
+            draft.detailById[invoiceId] = buildInvoiceDetail(invoiceId, 'Completed');
+        },
+        updateInvoiceDetailFailure(draft, action) {
+            const { invoiceId, status } = action.payload;
+            draft.detailById[invoiceId] = buildInvoiceDetail(invoiceId, 'Error', status);
+        },
+        clearAllInvoiceDetail(draft) {
+            draft.detailById = {};
+        },
+    },
+});
+_a = invoiceDetail.actions, exports.fetchInvoiceDetail = _a.fetchInvoiceDetail, exports.updateInvoiceDetail = _a.updateInvoiceDetail, exports.updateInvoiceDetailFailure = _a.updateInvoiceDetailFailure, exports.clearAllInvoiceDetail = _a.clearAllInvoiceDetail;
+exports.default = invoiceDetail.reducer;

package/lib/view/invoicing/invoiceDetail/invoiceDetailSelector.d.ts

@@ -0,0 +1,18 @@
+import { FetchStateAndError, ID } from '../../../commonStateTypes/common';
+import { SelectorView } from '../../../commonStateTypes/viewAndReport/viewAndReport';
+import { Address } from '../../../entity/address/addressState';
+import { InvoicingInvoice } from '../../../entity/invoicing/invoice/invoiceState';
+import { RootState } from '../../../reducer';
+/**
+ * Read-only view for the invoice detail page: the invoice entity + its per-id
+ * fetch state, with the per-invoice lifecycle-action run-state folded in. The
+ * billing/shipping addresses are resolved here from the shared address store so
+ * the view layer renders them without touching the store itself.
+ */
+export interface InvoiceDetailView extends SelectorView {
+    actionState: FetchStateAndError;
+    billingAddress?: Address;
+    invoice?: InvoicingInvoice;
+    shippingAddress?: Address;
+}
+export declare const getInvoiceDetail: (state: RootState, invoiceId: ID) => InvoiceDetailView;

package/lib/view/invoicing/invoiceDetail/invoiceDetailSelector.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getInvoiceDetail = void 0;
+const get_1 = __importDefault(require("lodash/get"));
+const addressSelector_1 = require("../../../entity/address/addressSelector");
+const invoiceSelector_1 = require("../../../entity/invoicing/invoice/invoiceSelector");
+const invoiceActionSelector_1 = require("../invoiceAction/invoiceActionSelector");
+const getInvoiceDetail = (state, invoiceId) => {
+    const detail = (0, get_1.default)(state.invoicingInvoiceDetailState.detailById, invoiceId, undefined);
+    const invoice = (0, invoiceSelector_1.getInvoiceById)(state.invoicingInvoiceState, invoiceId);
+    return {
+        invoice,
+        billingAddress: invoice?.billingAddressId != null
+            ? (0, addressSelector_1.getAddressByAddressId)(state.addressState, invoice.billingAddressId)
+            : undefined,
+        shippingAddress: invoice?.shippingAddressId != null
+            ? (0, addressSelector_1.getAddressByAddressId)(state.addressState, invoice.shippingAddressId)
+            : undefined,
+        actionState: (0, invoiceActionSelector_1.getInvoicingInvoiceActionState)(invoiceId)(state),
+        fetchState: detail?.fetchState ?? 'Not-Started',
+        error: detail?.error,
+        version: 1.0,
+    };
+};
+exports.getInvoiceDetail = getInvoiceDetail;

package/lib/view/invoicing/invoiceDetail/invoiceDetailState.d.ts

@@ -0,0 +1,7 @@
+import { FetchedState, ID } from '../../../commonStateTypes/common';
+export interface InvoiceDetailState {
+    detailById: Record<ID, InvoiceDetail>;
+}
+export interface InvoiceDetail extends FetchedState {
+    id: ID;
+}

package/lib/view/invoicing/invoiceDetail/invoiceDetailState.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/view/invoicing/invoiceList/fetchInvoiceCountsEpic.d.ts

@@ -0,0 +1,7 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { RootState } from '../../../reducer';
+import { ZeniAPI } from '../../../zeniAPI';
+import { fetchInvoiceCounts, updateInvoiceCounts, updateInvoiceCountsFailure } from './invoiceListReducer';
+export type ActionType = ReturnType<typeof fetchInvoiceCounts> | ReturnType<typeof updateInvoiceCounts> | ReturnType<typeof updateInvoiceCountsFailure>;
+export declare const fetchInvoiceCountsEpic: (actions$: ActionsObservable<ActionType>, state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

package/lib/view/invoicing/invoiceList/fetchInvoiceCountsEpic.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchInvoiceCountsEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const responsePayload_1 = require("../../../responsePayload");
+const invoicingApiHelper_1 = require("../invoicingApiHelper");
+const invoiceListReducer_1 = require("./invoiceListReducer");
+const fetchInvoiceCountsEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(invoiceListReducer_1.fetchInvoiceCounts.match), (0, operators_1.switchMap)(() => {
+    const { filters } = state$.value.invoicingInvoiceListState;
+    const params = new URLSearchParams();
+    if (filters.search != null && filters.search.length > 0) {
+        params.set('search', filters.search);
+    }
+    if (filters.customerId != null) {
+        params.set('customer_id', filters.customerId);
+    }
+    if (filters.subscriptionId != null) {
+        params.set('subscription_id', filters.subscriptionId);
+    }
+    if (filters.dateFrom != null) {
+        params.set('date_from', filters.dateFrom);
+    }
+    if (filters.dateTo != null) {
+        params.set('date_to', filters.dateTo);
+    }
+    const apiUrl = (0, invoicingApiHelper_1.withQuery)(`${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/invoices/counts`, params);
+    return zeniAPI.getJSON(apiUrl).pipe((0, operators_1.switchMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response) && response.data != null) {
+            return (0, rxjs_1.of)((0, invoiceListReducer_1.updateInvoiceCounts)(response.data));
+        }
+        return (0, rxjs_1.of)((0, invoiceListReducer_1.updateInvoiceCountsFailure)(response.status));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, invoiceListReducer_1.updateInvoiceCountsFailure)((0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Fetch invoice counts REST API call errored out ' +
+        JSON.stringify(error))))));
+}));
+exports.fetchInvoiceCountsEpic = fetchInvoiceCountsEpic;

package/lib/view/invoicing/invoiceList/fetchInvoiceKPIsEpic.d.ts

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

package/lib/view/invoicing/invoiceList/fetchInvoiceKPIsEpic.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchInvoiceKPIsEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const invoicePayload_1 = require("../../../entity/invoicing/invoice/invoicePayload");
+const responsePayload_1 = require("../../../responsePayload");
+const invoiceListReducer_1 = require("./invoiceListReducer");
+const fetchInvoiceKPIsEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(invoiceListReducer_1.fetchInvoiceKPIs.match), (0, operators_1.switchMap)(() => {
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/invoices/kpis`;
+    return zeniAPI.getJSON(apiUrl).pipe((0, operators_1.switchMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response) && response.data != null) {
+            return (0, rxjs_1.of)((0, invoiceListReducer_1.updateInvoiceKPIs)((0, invoicePayload_1.mapInvoicingInvoiceKPIsPayloadToState)(response.data)));
+        }
+        return (0, rxjs_1.of)((0, invoiceListReducer_1.updateInvoiceKPIsFailure)(response.status));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, invoiceListReducer_1.updateInvoiceKPIsFailure)((0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Fetch invoice KPIs REST API call errored out ' +
+        JSON.stringify(error))))));
+}));
+exports.fetchInvoiceKPIsEpic = fetchInvoiceKPIsEpic;

package/lib/view/invoicing/invoiceList/fetchInvoiceListEpic.d.ts

@@ -0,0 +1,9 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { updateAddresses } from '../../../entity/address/addressReducer';
+import { updateInvoices } from '../../../entity/invoicing/invoice/invoiceReducer';
+import { RootState } from '../../../reducer';
+import { ZeniAPI } from '../../../zeniAPI';
+import { fetchInvoiceList, updateInvoiceList, updateInvoiceListFailure, updateInvoiceListFilters } from './invoiceListReducer';
+export type ActionType = ReturnType<typeof fetchInvoiceList> | ReturnType<typeof updateInvoiceList> | ReturnType<typeof updateInvoiceListFailure> | ReturnType<typeof updateInvoiceListFilters> | ReturnType<typeof updateAddresses> | ReturnType<typeof updateInvoices>;
+export declare const fetchInvoiceListEpic: (actions$: ActionsObservable<ActionType>, _state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

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

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchInvoiceListEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const addressReducer_1 = require("../../../entity/address/addressReducer");
+const invoicePayload_1 = require("../../../entity/invoicing/invoice/invoicePayload");
+const invoiceReducer_1 = require("../../../entity/invoicing/invoice/invoiceReducer");
+const responsePayload_1 = require("../../../responsePayload");
+const invoicingApiHelper_1 = require("../invoicingApiHelper");
+const invoiceListReducer_1 = require("./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(invoicingApiHelper_1.INVOICING_LIST_PAGE_SIZE));
+    if (cursor != null) {
+        params.set('cursor', cursor);
+    }
+    (0, invoicingApiHelper_1.applyListSortParams)(params, sort);
+    return params;
+};
+const fetchInvoiceListEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(invoiceListReducer_1.fetchInvoiceList.match), (0, operators_1.switchMap)((action) => {
+    const { filters, cursor, keepExistingListItems, sort } = action.payload;
+    const apiUrl = (0, invoicingApiHelper_1.withQuery)(`${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/invoices`, buildInvoiceListQuery(filters, cursor, sort));
+    return zeniAPI.getJSON(apiUrl).pipe((0, operators_1.switchMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response)) {
+            const items = response.data?.items ?? [];
+            const actions = [
+                (0, invoiceReducer_1.updateInvoices)(items, 'merge'),
+                (0, addressReducer_1.updateAddresses)((0, invoicePayload_1.extractInvoicingInvoiceAddresses)(items)),
+                (0, invoiceListReducer_1.updateInvoiceList)({
+                    invoices: items,
+                    nextCursor: response.data?.next_cursor ?? null,
+                    keepExistingListItems,
+                }),
+            ];
+            return actions;
+        }
+        return (0, rxjs_1.of)((0, invoiceListReducer_1.updateInvoiceListFailure)(response.status));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, invoiceListReducer_1.updateInvoiceListFailure)((0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Fetch invoice list REST API call errored out ' +
+        JSON.stringify(error))))));
+}));
+exports.fetchInvoiceListEpic = fetchInvoiceListEpic;

package/lib/view/invoicing/invoiceList/fetchInvoiceListPageEpic.d.ts

@@ -0,0 +1,11 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { RootState } from '../../../reducer';
+import { fetchInvoiceCounts, fetchInvoiceKPIs, fetchInvoiceList, fetchInvoiceListPage, updateInvoiceCounts, updateInvoiceCountsFailure, updateInvoiceKPIs, updateInvoiceKPIsFailure, updateInvoiceList, updateInvoiceListFailure } from './invoiceListReducer';
+export type ActionType = ReturnType<typeof fetchInvoiceList> | ReturnType<typeof fetchInvoiceListPage> | ReturnType<typeof fetchInvoiceCounts> | ReturnType<typeof fetchInvoiceKPIs> | ReturnType<typeof updateInvoiceList> | ReturnType<typeof updateInvoiceListFailure> | ReturnType<typeof updateInvoiceCounts> | ReturnType<typeof updateInvoiceCountsFailure> | ReturnType<typeof updateInvoiceKPIs> | ReturnType<typeof updateInvoiceKPIsFailure>;
+/**
+ * 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 declare const fetchInvoiceListPageEpic: (actions$: ActionsObservable<ActionType>, state$: StateObservable<RootState>) => Observable<ActionType>;

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

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchInvoiceListPageEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const invoiceListReducer_1 = require("./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).
+ */
+const fetchInvoiceListPageEpic = (actions$, state$) => actions$.pipe((0, operators_1.filter)(invoiceListReducer_1.fetchInvoiceListPage.match), (0, operators_1.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((0, invoiceListReducer_1.fetchInvoiceList)({ filters, sort }));
+    }
+    if (shouldFetch(state.countsFetchState, cacheOverride)) {
+        pageActions.push((0, invoiceListReducer_1.fetchInvoiceCounts)());
+    }
+    if (shouldFetch(state.kpisFetchState, cacheOverride)) {
+        pageActions.push((0, invoiceListReducer_1.fetchInvoiceKPIs)());
+    }
+    return (0, rxjs_1.concat)((0, rxjs_1.from)(pageActions));
+}));
+exports.fetchInvoiceListPageEpic = fetchInvoiceListPageEpic;

package/lib/view/invoicing/invoiceList/invoiceListPayload.d.ts

@@ -0,0 +1,6 @@
+import { InvoicingInvoiceKPIsPayload, InvoicingInvoicePayload } from '../../../entity/invoicing/invoice/invoicePayload';
+import { InvoicingListCounts, InvoicingPaginatedList } from '../../../entity/invoicing/invoicingCommonPayload';
+import { ZeniAPIResponse } from '../../../responsePayload';
+export type InvoiceListResponse = ZeniAPIResponse<InvoicingPaginatedList<InvoicingInvoicePayload>>;
+export type InvoiceCountsResponse = ZeniAPIResponse<InvoicingListCounts>;
+export type InvoiceKPIsResponse = ZeniAPIResponse<InvoicingInvoiceKPIsPayload>;

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

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/view/invoicing/invoiceList/invoiceListReducer.d.ts

@@ -0,0 +1,48 @@
+import { ID } from '../../../commonStateTypes/common';
+import { InvoicingInvoicePayload, InvoicingInvoiceStatus } from '../../../entity/invoicing/invoice/invoicePayload';
+import { InvoicingInvoiceKPIs } from '../../../entity/invoicing/invoice/invoiceState';
+import { InvoicingListCounts } from '../../../entity/invoicing/invoicingCommonPayload';
+import { ZeniAPIStatus } from '../../../responsePayload';
+import { InvoicingListSort } from '../invoicingApiHelper';
+import { InvoiceListFilters, InvoiceListState } from './invoiceListState';
+/**
+ * Whether two invoice-list queries (filters + sort) would return the same list.
+ * Used to invalidate the cached list when a page mounts with a different query
+ * — e.g. the customer detail page after the main Invoices page, or vice versa.
+ */
+export declare const sameInvoiceListQuery: (a: {
+    filters: InvoiceListFilters;
+    sort?: InvoicingListSort;
+}, b: {
+    filters: InvoiceListFilters;
+    sort?: InvoicingListSort;
+}) => boolean;
+export declare const initialState: InvoiceListState;
+export declare const fetchInvoiceList: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[payload: {
+    cursor?: string;
+    filters?: InvoiceListFilters;
+    keepExistingListItems?: boolean;
+    sort?: InvoicingListSort;
+}], {
+    filters: InvoiceListFilters;
+    cursor: string | undefined;
+    keepExistingListItems: boolean;
+    sort: InvoicingListSort | undefined;
+}, "invoicingInvoiceList/fetchInvoiceList", never, never>, fetchInvoiceListPage: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[payload: {
+    cacheOverride?: boolean;
+    filters?: InvoiceListFilters;
+    sort?: InvoicingListSort;
+}], {
+    cacheOverride: boolean;
+    filters: InvoiceListFilters;
+    sort: InvoicingListSort | undefined;
+}, "invoicingInvoiceList/fetchInvoiceListPage", never, never>, updateInvoiceList: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    invoices: InvoicingInvoicePayload[];
+    keepExistingListItems: boolean;
+    nextCursor: string | null;
+}, "invoicingInvoiceList/updateInvoiceList">, updateInvoiceListFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<ZeniAPIStatus<Record<string, unknown>>, "invoicingInvoiceList/updateInvoiceListFailure">, fetchInvoiceCounts: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingInvoiceList/fetchInvoiceCounts">, updateInvoiceCounts: import("@reduxjs/toolkit").ActionCreatorWithPayload<InvoicingListCounts, "invoicingInvoiceList/updateInvoiceCounts">, updateInvoiceCountsFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<ZeniAPIStatus<Record<string, unknown>>, "invoicingInvoiceList/updateInvoiceCountsFailure">, fetchInvoiceKPIs: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingInvoiceList/fetchInvoiceKPIs">, updateInvoiceKPIs: import("@reduxjs/toolkit").ActionCreatorWithPayload<InvoicingInvoiceKPIs, "invoicingInvoiceList/updateInvoiceKPIs">, updateInvoiceKPIsFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<ZeniAPIStatus<Record<string, unknown>>, "invoicingInvoiceList/updateInvoiceKPIsFailure">, updateInvoiceListFilters: import("@reduxjs/toolkit").ActionCreatorWithPayload<InvoiceListFilters, "invoicingInvoiceList/updateInvoiceListFilters">, addInvoiceToList: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    id: ID;
+    status: InvoicingInvoiceStatus;
+}, "invoicingInvoiceList/addInvoiceToList">, clearInvoiceList: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingInvoiceList/clearInvoiceList">;
+declare const _default: import("redux").Reducer<InvoiceListState>;
+export default _default;

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

@@ -0,0 +1,145 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearInvoiceList = exports.addInvoiceToList = exports.updateInvoiceListFilters = exports.updateInvoiceKPIsFailure = exports.updateInvoiceKPIs = exports.fetchInvoiceKPIs = exports.updateInvoiceCountsFailure = exports.updateInvoiceCounts = exports.fetchInvoiceCounts = exports.updateInvoiceListFailure = exports.updateInvoiceList = exports.fetchInvoiceListPage = exports.fetchInvoiceList = exports.initialState = exports.sameInvoiceListQuery = void 0;
+const toolkit_1 = require("@reduxjs/toolkit");
+/**
+ * Whether two invoice-list queries (filters + sort) would return the same list.
+ * Used to invalidate the cached list when a page mounts with a different query
+ * — e.g. the customer detail page after the main Invoices page, or vice versa.
+ */
+const sameInvoiceListQuery = (a, b) => a.filters.customerId === b.filters.customerId &&
+    a.filters.subscriptionId === b.filters.subscriptionId &&
+    a.filters.status === b.filters.status &&
+    a.filters.search === b.filters.search &&
+    a.filters.dateFrom === b.filters.dateFrom &&
+    a.filters.dateTo === b.filters.dateTo &&
+    a.sort?.field === b.sort?.field &&
+    a.sort?.dir === b.sort?.dir;
+exports.sameInvoiceListQuery = sameInvoiceListQuery;
+exports.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 = (0, toolkit_1.createSlice)({
+    name: 'invoicingInvoiceList',
+    initialState: exports.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) {
+                // A different query invalidates the cached list — reset so the page
+                // epic's shouldFetch refetches instead of showing another view's rows
+                // (e.g. a customer-filtered list left behind by the detail page).
+                if (!(0, exports.sameInvoiceListQuery)(draft, action.payload)) {
+                    draft.invoiceIds = [];
+                    draft.nextCursor = null;
+                    draft.fetchState = 'Not-Started';
+                }
+                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;
+        },
+        // Reflect a newly created invoice in the cached list + tab counts so the
+        // invoices page shows it without refetching from the server. Bumps the
+        // `all` total and the per-status count key the tabs read (a create is
+        // typically `draft`). KPIs are money aggregates (Amount, not a plain
+        // increment), so they are left untouched and refetched lazily.
+        addInvoiceToList(draft, action) {
+            const { id, status } = action.payload;
+            if (draft.invoiceIds.includes(id)) {
+                return;
+            }
+            draft.invoiceIds = [id, ...draft.invoiceIds];
+            draft.counts.all += 1;
+            draft.counts[status] = (draft.counts[status] ?? 0) + 1;
+        },
+        clearInvoiceList(draft) {
+            Object.assign(draft, exports.initialState);
+        },
+    },
+});
+_a = invoiceList.actions, exports.fetchInvoiceList = _a.fetchInvoiceList, exports.fetchInvoiceListPage = _a.fetchInvoiceListPage, exports.updateInvoiceList = _a.updateInvoiceList, exports.updateInvoiceListFailure = _a.updateInvoiceListFailure, exports.fetchInvoiceCounts = _a.fetchInvoiceCounts, exports.updateInvoiceCounts = _a.updateInvoiceCounts, exports.updateInvoiceCountsFailure = _a.updateInvoiceCountsFailure, exports.fetchInvoiceKPIs = _a.fetchInvoiceKPIs, exports.updateInvoiceKPIs = _a.updateInvoiceKPIs, exports.updateInvoiceKPIsFailure = _a.updateInvoiceKPIsFailure, exports.updateInvoiceListFilters = _a.updateInvoiceListFilters, exports.addInvoiceToList = _a.addInvoiceToList, exports.clearInvoiceList = _a.clearInvoiceList;
+exports.default = invoiceList.reducer;

package/lib/view/invoicing/invoiceList/invoiceListSelector.d.ts

@@ -0,0 +1,23 @@
+import { FetchStateAndError } from '../../../commonStateTypes/common';
+import { SelectorView } from '../../../commonStateTypes/viewAndReport/viewAndReport';
+import { InvoicingInvoice, InvoicingInvoiceKPIs } from '../../../entity/invoicing/invoice/invoiceState';
+import { InvoicingListCounts } from '../../../entity/invoicing/invoicingCommonPayload';
+import { RootState } from '../../../reducer';
+import { InvoiceListFilters, InvoicingInvoiceTabId } from './invoiceListState';
+export interface InvoiceListView extends SelectorView {
+    counts: InvoicingListCounts;
+    countsFetchState: FetchStateAndError;
+    filters: InvoiceListFilters;
+    invoices: InvoicingInvoice[];
+    kpisFetchState: FetchStateAndError;
+    nextCursor: string | null;
+    tabIds: InvoicingInvoiceTabId[];
+    kpis?: InvoicingInvoiceKPIs;
+}
+/**
+ * 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 declare const getInvoiceListView: (state: RootState) => InvoiceListView;