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

package/lib/view/invoicing/invoicingCreditNoteListView/invoicingCreditNoteListViewReducer.js

@@ -0,0 +1,93 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearInvoicingCreditNoteListView = exports.updateInvoicingCreditNoteFilters = exports.updateInvoicingCreditNoteCountsFailure = exports.updateInvoicingCreditNoteCounts = exports.fetchInvoicingCreditNoteCounts = exports.updateInvoicingCreditNoteListFailure = exports.updateInvoicingCreditNoteList = exports.fetchInvoicingCreditNoteListPage = exports.fetchInvoicingCreditNoteList = exports.initialState = void 0;
+const toolkit_1 = require("@reduxjs/toolkit");
+exports.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 invoicingCreditNoteListView = (0, toolkit_1.createSlice)({
+    name: 'invoicingCreditNoteListView',
+    initialState: exports.initialState,
+    reducers: {
+        fetchInvoicingCreditNoteList: {
+            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,
+                    },
+                };
+            },
+        },
+        fetchInvoicingCreditNoteListPage: {
+            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,
+                    },
+                };
+            },
+        },
+        updateInvoicingCreditNoteList(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;
+        },
+        updateInvoicingCreditNoteListFailure(draft, action) {
+            draft.fetchState = 'Error';
+            draft.error = action.payload;
+        },
+        fetchInvoicingCreditNoteCounts(draft) {
+            draft.countsFetchState.fetchState = 'In-Progress';
+            draft.countsFetchState.error = undefined;
+        },
+        updateInvoicingCreditNoteCounts(draft, action) {
+            draft.counts = action.payload;
+            draft.countsFetchState.fetchState = 'Completed';
+            draft.countsFetchState.error = undefined;
+        },
+        updateInvoicingCreditNoteCountsFailure(draft, action) {
+            draft.countsFetchState.fetchState = 'Error';
+            draft.countsFetchState.error = action.payload;
+        },
+        updateInvoicingCreditNoteFilters(draft, action) {
+            draft.filters = action.payload;
+        },
+        clearInvoicingCreditNoteListView(draft) {
+            Object.assign(draft, exports.initialState);
+        },
+    },
+});
+_a = invoicingCreditNoteListView.actions, exports.fetchInvoicingCreditNoteList = _a.fetchInvoicingCreditNoteList, exports.fetchInvoicingCreditNoteListPage = _a.fetchInvoicingCreditNoteListPage, exports.updateInvoicingCreditNoteList = _a.updateInvoicingCreditNoteList, exports.updateInvoicingCreditNoteListFailure = _a.updateInvoicingCreditNoteListFailure, exports.fetchInvoicingCreditNoteCounts = _a.fetchInvoicingCreditNoteCounts, exports.updateInvoicingCreditNoteCounts = _a.updateInvoicingCreditNoteCounts, exports.updateInvoicingCreditNoteCountsFailure = _a.updateInvoicingCreditNoteCountsFailure, exports.updateInvoicingCreditNoteFilters = _a.updateInvoicingCreditNoteFilters, exports.clearInvoicingCreditNoteListView = _a.clearInvoicingCreditNoteListView;
+exports.default = invoicingCreditNoteListView.reducer;

package/lib/view/invoicing/invoicingCreditNoteListView/invoicingCreditNoteListViewSelector.d.ts

@@ -0,0 +1,22 @@
+import { FetchStateAndError } from '../../../commonStateTypes/common';
+import { SelectorView } from '../../../commonStateTypes/viewAndReport/viewAndReport';
+import { InvoicingCreditNote } from '../../../entity/invoicing/creditNote/creditNoteState';
+import { InvoicingListCounts } from '../../../entity/invoicing/invoicingCommonPayload';
+import { RootState } from '../../../reducer';
+import { InvoicingListSort } from '../invoicingApiHelper';
+import { InvoicingCreditNoteColumnConfig, InvoicingCreditNoteFilters, InvoicingCreditNoteTabId } from './invoicingCreditNoteListViewState';
+export interface InvoicingCreditNoteListView extends SelectorView {
+    columns: InvoicingCreditNoteColumnConfig[];
+    count: InvoicingListCounts;
+    countsFetchState: FetchStateAndError;
+    creditNotes: InvoicingCreditNote[];
+    filters: InvoicingCreditNoteFilters;
+    tabIds: InvoicingCreditNoteTabId[];
+    sort?: InvoicingListSort;
+}
+/**
+ * Memoized so the denormalized `creditNotes` array (and the wrapping view
+ * object) keep referential identity until the credit-note entity slice or the
+ * list-view slice actually change.
+ */
+export declare const getInvoicingCreditNoteListView: (state: RootState) => InvoicingCreditNoteListView;

package/lib/view/invoicing/invoicingCreditNoteListView/invoicingCreditNoteListViewSelector.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getInvoicingCreditNoteListView = void 0;
+const toolkit_1 = require("@reduxjs/toolkit");
+const creditNoteSelector_1 = require("../../../entity/invoicing/creditNote/creditNoteSelector");
+const invoicingCreditNoteListViewState_1 = require("./invoicingCreditNoteListViewState");
+/**
+ * Memoized so the denormalized `creditNotes` array (and the wrapping view
+ * object) keep referential identity until the credit-note entity slice or the
+ * list-view slice actually change.
+ */
+exports.getInvoicingCreditNoteListView = (0, toolkit_1.createSelector)((state) => state.invoicingCreditNoteState, (state) => state.invoicingCreditNoteListViewState, (creditNoteState, listViewState) => ({
+    columns: invoicingCreditNoteListViewState_1.INVOICING_CREDIT_NOTE_COLUMNS,
+    creditNotes: (0, creditNoteSelector_1.getInvoicingCreditNotesByIds)(creditNoteState, listViewState.ids),
+    count: listViewState.counts,
+    countsFetchState: listViewState.countsFetchState,
+    filters: listViewState.filters,
+    nextCursor: listViewState.nextCursor,
+    tabIds: invoicingCreditNoteListViewState_1.INVOICING_CREDIT_NOTE_TABS,
+    fetchState: listViewState.fetchState,
+    error: listViewState.error,
+    sort: listViewState.sort,
+    version: 1.0,
+}));

package/lib/view/invoicing/invoicingCreditNoteListView/invoicingCreditNoteListViewState.d.ts

@@ -0,0 +1,42 @@
+import { FetchStateAndError, FetchedState, ID } from '../../../commonStateTypes/common';
+import { InvoicingListCounts } from '../../../entity/invoicing/invoicingCommonPayload';
+import { InvoicingListSort } from '../invoicingApiHelper';
+export interface InvoicingCreditNoteFilters {
+    customerId?: ID;
+    search?: string;
+    status?: string;
+}
+export declare const ALL_INVOICING_CREDIT_NOTE_SORT_KEYS: readonly ["credit_note", "customer", "date", "type", "status", "reference_invoice", "utilization", "total"];
+export declare const toInvoicingCreditNoteSortKey: (v: string) => "date" | "status" | "type" | "customer" | "total" | "credit_note" | "reference_invoice" | "utilization";
+export type InvoicingCreditNoteSortKey = ReturnType<typeof toInvoicingCreditNoteSortKey>;
+/**
+ * Structural column descriptor owned by CES so the credit-notes-list column set,
+ * ordering and sortability live next to the `InvoicingCreditNote` model rather
+ * than being hardcoded in web-components. Header labels, cell rendering and
+ * layout (alignment, widths) stay in the view layer; this only carries the
+ * column set, order and sort metadata.
+ */
+export interface InvoicingCreditNoteColumnConfig {
+    key: InvoicingCreditNoteSortKey;
+    sortable: boolean;
+}
+export declare const INVOICING_CREDIT_NOTE_COLUMNS: InvoicingCreditNoteColumnConfig[];
+export declare const ALL_INVOICING_CREDIT_NOTE_TAB_IDS: readonly ["all", "refund_due", "adjusted", "refunded", "voided"];
+export declare const toInvoicingCreditNoteTabId: (v: string) => "adjusted" | "refunded" | "refund_due" | "voided" | "all";
+export type InvoicingCreditNoteTabId = ReturnType<typeof toInvoicingCreditNoteTabId>;
+/**
+ * Ordered filter-tab id set owned by CES so the credit-notes-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 declare const INVOICING_CREDIT_NOTE_TABS: InvoicingCreditNoteTabId[];
+export interface InvoicingCreditNoteListViewState extends FetchedState {
+    counts: InvoicingListCounts;
+    countsFetchState: FetchStateAndError;
+    filters: InvoicingCreditNoteFilters;
+    ids: ID[];
+    nextCursor: string | null;
+    /** Active server-side sort (undefined = backend default order). */
+    sort?: InvoicingListSort;
+}

package/lib/view/invoicing/invoicingCreditNoteListView/invoicingCreditNoteListViewState.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INVOICING_CREDIT_NOTE_TABS = exports.toInvoicingCreditNoteTabId = exports.ALL_INVOICING_CREDIT_NOTE_TAB_IDS = exports.INVOICING_CREDIT_NOTE_COLUMNS = exports.toInvoicingCreditNoteSortKey = exports.ALL_INVOICING_CREDIT_NOTE_SORT_KEYS = void 0;
+const stringToUnion_1 = require("../../../commonStateTypes/stringToUnion");
+exports.ALL_INVOICING_CREDIT_NOTE_SORT_KEYS = [
+    'credit_note',
+    'customer',
+    'date',
+    'type',
+    'status',
+    'reference_invoice',
+    'utilization',
+    'total',
+];
+const toInvoicingCreditNoteSortKey = (v) => (0, stringToUnion_1.stringToUnion)(v, exports.ALL_INVOICING_CREDIT_NOTE_SORT_KEYS);
+exports.toInvoicingCreditNoteSortKey = toInvoicingCreditNoteSortKey;
+exports.INVOICING_CREDIT_NOTE_COLUMNS = [
+    { key: 'credit_note', sortable: true },
+    { key: 'customer', sortable: true },
+    { key: 'date', sortable: true },
+    { key: 'type', sortable: true },
+    { key: 'status', sortable: true },
+    { key: 'reference_invoice', sortable: true },
+    { key: 'utilization', sortable: true },
+    { key: 'total', sortable: true },
+];
+exports.ALL_INVOICING_CREDIT_NOTE_TAB_IDS = [
+    'all',
+    'refund_due',
+    'adjusted',
+    'refunded',
+    'voided',
+];
+const toInvoicingCreditNoteTabId = (v) => (0, stringToUnion_1.stringToUnion)(v, exports.ALL_INVOICING_CREDIT_NOTE_TAB_IDS);
+exports.toInvoicingCreditNoteTabId = toInvoicingCreditNoteTabId;
+/**
+ * Ordered filter-tab id set owned by CES so the credit-notes-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.
+ */
+exports.INVOICING_CREDIT_NOTE_TABS = [
+    ...exports.ALL_INVOICING_CREDIT_NOTE_TAB_IDS,
+];

package/lib/view/invoicing/invoicingCustomerDetailView/fetchInvoicingCustomerDetailEpic.d.ts

@@ -0,0 +1,8 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { updateInvoicingCustomers } from '../../../entity/invoicing/invoicingCustomer/invoicingCustomerReducer';
+import { RootState } from '../../../reducer';
+import { ZeniAPI } from '../../../zeniAPI';
+import { fetchInvoicingCustomerDetail, updateInvoicingCustomerDetail, updateInvoicingCustomerDetailFailure } from './invoicingCustomerDetailViewReducer';
+export type ActionType = ReturnType<typeof fetchInvoicingCustomerDetail> | ReturnType<typeof updateInvoicingCustomerDetail> | ReturnType<typeof updateInvoicingCustomerDetailFailure> | ReturnType<typeof updateInvoicingCustomers>;
+export declare const fetchInvoicingCustomerDetailEpic: (actions$: ActionsObservable<ActionType>, _state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

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

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchInvoicingCustomerDetailEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const invoicingCustomerReducer_1 = require("../../../entity/invoicing/invoicingCustomer/invoicingCustomerReducer");
+const responsePayload_1 = require("../../../responsePayload");
+const invoicingCustomerDetailViewReducer_1 = require("./invoicingCustomerDetailViewReducer");
+const fetchInvoicingCustomerDetailEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(invoicingCustomerDetailViewReducer_1.fetchInvoicingCustomerDetail.match), (0, operators_1.switchMap)((action) => {
+    const { id } = action.payload;
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/customers/${id}`;
+    return zeniAPI.getJSON(apiUrl).pipe((0, operators_1.switchMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response) && response.data != null) {
+            return [
+                (0, invoicingCustomerReducer_1.updateInvoicingCustomers)([response.data], 'merge'),
+                (0, invoicingCustomerDetailViewReducer_1.updateInvoicingCustomerDetail)({ id: response.data.id }),
+            ];
+        }
+        return (0, rxjs_1.of)((0, invoicingCustomerDetailViewReducer_1.updateInvoicingCustomerDetailFailure)({ id, status: response.status }));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, invoicingCustomerDetailViewReducer_1.updateInvoicingCustomerDetailFailure)({
+        id,
+        status: (0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Fetch customer detail REST API call errored out ' +
+            JSON.stringify(error)),
+    }))));
+}));
+exports.fetchInvoicingCustomerDetailEpic = fetchInvoicingCustomerDetailEpic;

package/lib/view/invoicing/invoicingCustomerDetailView/fetchInvoicingCustomerDetailPageEpic.d.ts

@@ -0,0 +1,18 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { RootState } from '../../../reducer';
+import { fetchInvoiceList } from '../invoiceList/invoiceListReducer';
+import { fetchInvoicingSettings } from '../settingsView/settingsViewReducer';
+import { fetchInvoicingCustomerDetail, fetchInvoicingCustomerDetailPage } from './invoicingCustomerDetailViewReducer';
+/**
+ * Aggregate of every action emitted across the customer detail page epic.
+ * Wired into the root action union for this view.
+ */
+export type ActionType = ReturnType<typeof fetchInvoicingCustomerDetail> | ReturnType<typeof fetchInvoicingCustomerDetailPage> | ReturnType<typeof fetchInvoiceList> | ReturnType<typeof fetchInvoicingSettings>;
+/**
+ * Orchestrates the customer detail page: on `fetchInvoicingCustomerDetailPage`,
+ * fans out to the customer detail, the customer's invoice list and the invoicing
+ * settings, skipping any whose data is already cached unless `cacheOverride` is
+ * set (e.g. on a manual refresh).
+ */
+export declare const fetchInvoicingCustomerDetailPageEpic: (actions$: ActionsObservable<ActionType>, state$: StateObservable<RootState>) => Observable<ActionType>;

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

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

package/lib/view/invoicing/invoicingCustomerDetailView/invoicingCustomerDetailViewPayload.d.ts

@@ -0,0 +1,3 @@
+import { InvoicingCustomerPayload } from '../../../entity/invoicing/invoicingCustomer/invoicingCustomerPayload';
+import { ZeniAPIResponse } from '../../../responsePayload';
+export type InvoicingCustomerDetailResponse = ZeniAPIResponse<InvoicingCustomerPayload>;

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

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

package/lib/view/invoicing/invoicingCustomerDetailView/invoicingCustomerDetailViewReducer.d.ts

@@ -0,0 +1,22 @@
+import { FetchState, ID } from '../../../commonStateTypes/common';
+import { ZeniAPIStatus } from '../../../responsePayload';
+import { InvoicingCustomerDetail, InvoicingCustomerDetailViewState } from './invoicingCustomerDetailViewState';
+export declare const initialState: InvoicingCustomerDetailViewState;
+/** Build a per-customer detail fetch-state entry. */
+export declare function buildInvoicingCustomerDetail(id: ID, fetchState: FetchState, error?: ZeniAPIStatus): InvoicingCustomerDetail;
+export declare const fetchInvoicingCustomerDetail: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    id: ID;
+}, "invoicingCustomerDetailView/fetchInvoicingCustomerDetail">, fetchInvoicingCustomerDetailPage: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[payload: {
+    id: ID;
+    cacheOverride?: boolean;
+}], {
+    cacheOverride: boolean;
+    id: string;
+}, "invoicingCustomerDetailView/fetchInvoicingCustomerDetailPage", never, never>, updateInvoicingCustomerDetail: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    id: ID;
+}, "invoicingCustomerDetailView/updateInvoicingCustomerDetail">, updateInvoicingCustomerDetailFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    id: ID;
+    status: ZeniAPIStatus;
+}, "invoicingCustomerDetailView/updateInvoicingCustomerDetailFailure">, clearInvoicingCustomerDetailView: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingCustomerDetailView/clearInvoicingCustomerDetailView">;
+declare const _default: import("redux").Reducer<InvoicingCustomerDetailViewState>;
+export default _default;

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

@@ -0,0 +1,56 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearInvoicingCustomerDetailView = exports.updateInvoicingCustomerDetailFailure = exports.updateInvoicingCustomerDetail = exports.fetchInvoicingCustomerDetailPage = exports.fetchInvoicingCustomerDetail = exports.initialState = void 0;
+exports.buildInvoicingCustomerDetail = buildInvoicingCustomerDetail;
+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-customer detail fetch-state entry. */
+function buildInvoicingCustomerDetail(id, fetchState, error) {
+    return { id, fetchState, error, hasValidState: hasCompletedFetch };
+}
+const invoicingCustomerDetailView = (0, toolkit_1.createSlice)({
+    name: 'invoicingCustomerDetailView',
+    initialState: exports.initialState,
+    reducers: {
+        fetchInvoicingCustomerDetail(draft, action) {
+            const { id } = action.payload;
+            draft.detailById[id] = buildInvoicingCustomerDetail(id, 'In-Progress');
+        },
+        fetchInvoicingCustomerDetailPage: {
+            reducer() {
+                // Orchestrator trigger only — the individual fetches own the state.
+            },
+            prepare(payload) {
+                return {
+                    payload: {
+                        cacheOverride: payload.cacheOverride ?? false,
+                        id: payload.id,
+                    },
+                };
+            },
+        },
+        updateInvoicingCustomerDetail(draft, action) {
+            const { id } = action.payload;
+            draft.detailById[id] = buildInvoicingCustomerDetail(id, 'Completed');
+        },
+        updateInvoicingCustomerDetailFailure(draft, action) {
+            const { id, status } = action.payload;
+            draft.detailById[id] = buildInvoicingCustomerDetail(id, 'Error', status);
+        },
+        clearInvoicingCustomerDetailView(draft) {
+            draft.detailById = {};
+        },
+    },
+});
+_a = invoicingCustomerDetailView.actions, exports.fetchInvoicingCustomerDetail = _a.fetchInvoicingCustomerDetail, exports.fetchInvoicingCustomerDetailPage = _a.fetchInvoicingCustomerDetailPage, exports.updateInvoicingCustomerDetail = _a.updateInvoicingCustomerDetail, exports.updateInvoicingCustomerDetailFailure = _a.updateInvoicingCustomerDetailFailure, exports.clearInvoicingCustomerDetailView = _a.clearInvoicingCustomerDetailView;
+exports.default = invoicingCustomerDetailView.reducer;

package/lib/view/invoicing/invoicingCustomerDetailView/invoicingCustomerDetailViewSelector.d.ts

@@ -0,0 +1,25 @@
+import { FetchStateAndError, ID } from '../../../commonStateTypes/common';
+import { SelectorView } from '../../../commonStateTypes/viewAndReport/viewAndReport';
+import { InvoicingInvoice } from '../../../entity/invoicing/invoice/invoiceState';
+import { InvoicingCustomer } from '../../../entity/invoicing/invoicingCustomer/invoicingCustomerState';
+import { RootState } from '../../../reducer';
+import { InvoicingSetupIntent } from '../customerPaymentMethod/customerPaymentMethodState';
+/**
+ * Read-only view for the customer detail page: the customer entity + its fetch
+ * state, plus everything the page renders in view mode — recent invoices, the
+ * Add-Payment-Method dialog state (setup intent / Plaid token / save), the
+ * payment-link send state, and whether Stripe is connected. Lets the detail
+ * screen depend on this single read selector.
+ */
+export interface InvoicingCustomerDetailView extends SelectorView {
+    invoices: InvoicingInvoice[];
+    paymentMethodSaveState: FetchStateAndError;
+    sendLinkState: FetchStateAndError;
+    setupIntentFetchState: FetchStateAndError;
+    stripeConnected: boolean;
+    invoicingCustomer?: InvoicingCustomer;
+    plaidLinkToken?: string;
+    sentPaymentLinkEmail?: string;
+    setupIntent?: InvoicingSetupIntent;
+}
+export declare const getInvoicingCustomerDetail: (state: RootState, invoicingCustomerID: ID) => InvoicingCustomerDetailView;

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

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getInvoicingCustomerDetail = void 0;
+const get_1 = __importDefault(require("lodash/get"));
+const invoiceSelector_1 = require("../../../entity/invoicing/invoice/invoiceSelector");
+const invoicingCustomerSelector_1 = require("../../../entity/invoicing/invoicingCustomer/invoicingCustomerSelector");
+const customerPaymentMethodSelector_1 = require("../customerPaymentMethod/customerPaymentMethodSelector");
+const settingsViewSelector_1 = require("../settingsView/settingsViewSelector");
+const getInvoicingCustomerDetail = (state, invoicingCustomerID) => {
+    const { invoicingCustomerState, invoicingCustomerDetailViewState } = state;
+    const invoicingCustomerDetail = (0, get_1.default)(invoicingCustomerDetailViewState.detailById, invoicingCustomerID, undefined);
+    const settings = (0, settingsViewSelector_1.getInvoicingSettings)(state);
+    return {
+        invoicingCustomer: (0, invoicingCustomerSelector_1.getInvoicingCustomerById)(invoicingCustomerState, invoicingCustomerID),
+        invoices: (0, invoiceSelector_1.getInvoicesByIds)(state, state.invoicingInvoiceListState.invoiceIds),
+        setupIntent: (0, customerPaymentMethodSelector_1.getInvoicingSetupIntent)(state),
+        setupIntentFetchState: (0, customerPaymentMethodSelector_1.getInvoicingSetupIntentFetchState)(state),
+        plaidLinkToken: (0, customerPaymentMethodSelector_1.getInvoicingPlaidLinkToken)(state),
+        paymentMethodSaveState: (0, customerPaymentMethodSelector_1.getInvoicingPaymentMethodSaveState)(state),
+        sendLinkState: (0, customerPaymentMethodSelector_1.getInvoicingPaymentLinkSendState)(state),
+        sentPaymentLinkEmail: (0, customerPaymentMethodSelector_1.getInvoicingSentPaymentLinkEmail)(state),
+        stripeConnected: settings?.stripe_connected_account_id != null &&
+            settings.stripe_connected_account_id !== '',
+        fetchState: invoicingCustomerDetail?.fetchState ?? 'Not-Started',
+        error: invoicingCustomerDetail?.error,
+        version: 1.0,
+    };
+};
+exports.getInvoicingCustomerDetail = getInvoicingCustomerDetail;

package/lib/view/invoicing/invoicingCustomerDetailView/invoicingCustomerDetailViewState.d.ts

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

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

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

package/lib/view/invoicing/invoicingCustomerListView/epics/fetchInvoicingCustomerCountsEpic.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 { fetchInvoicingCustomerCounts, updateInvoicingCustomerCounts, updateInvoicingCustomerCountsFailure } from '../invoicingCustomerListViewReducer';
+export type ActionType = ReturnType<typeof fetchInvoicingCustomerCounts> | ReturnType<typeof updateInvoicingCustomerCounts> | ReturnType<typeof updateInvoicingCustomerCountsFailure>;
+export declare const fetchInvoicingCustomerCountsEpic: (actions$: ActionsObservable<ActionType>, state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

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

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchInvoicingCustomerCountsEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const responsePayload_1 = require("../../../../responsePayload");
+const invoicingApiHelper_1 = require("../../invoicingApiHelper");
+const invoicingCustomerListViewReducer_1 = require("../invoicingCustomerListViewReducer");
+const fetchInvoicingCustomerCountsEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(invoicingCustomerListViewReducer_1.fetchInvoicingCustomerCounts.match), (0, operators_1.switchMap)(() => {
+    const { filters } = state$.value.invoicingCustomerListViewState;
+    const params = new URLSearchParams();
+    if (filters.search != null && filters.search.length > 0) {
+        params.set('search', filters.search);
+    }
+    const apiUrl = (0, invoicingApiHelper_1.withQuery)(`${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/customers/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, invoicingCustomerListViewReducer_1.updateInvoicingCustomerCounts)(response.data));
+        }
+        return (0, rxjs_1.of)((0, invoicingCustomerListViewReducer_1.updateInvoicingCustomerCountsFailure)(response.status));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, invoicingCustomerListViewReducer_1.updateInvoicingCustomerCountsFailure)((0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Fetch customer counts REST API call errored out ' +
+        JSON.stringify(error))))));
+}));
+exports.fetchInvoicingCustomerCountsEpic = fetchInvoicingCustomerCountsEpic;

package/lib/view/invoicing/invoicingCustomerListView/epics/fetchInvoicingCustomerListEpic.d.ts

@@ -0,0 +1,8 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { updateInvoicingCustomers } from '../../../../entity/invoicing/invoicingCustomer/invoicingCustomerReducer';
+import { RootState } from '../../../../reducer';
+import { ZeniAPI } from '../../../../zeniAPI';
+import { fetchInvoicingCustomerList, updateInvoicingCustomerList, updateInvoicingCustomerListFailure } from '../invoicingCustomerListViewReducer';
+export type ActionType = ReturnType<typeof fetchInvoicingCustomerList> | ReturnType<typeof updateInvoicingCustomerList> | ReturnType<typeof updateInvoicingCustomerListFailure> | ReturnType<typeof updateInvoicingCustomers>;
+export declare const fetchInvoicingCustomerListEpic: (actions$: ActionsObservable<ActionType>, _state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

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

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

package/lib/view/invoicing/invoicingCustomerListView/epics/fetchInvoicingCustomerListPageEpic.d.ts

@@ -0,0 +1,16 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { updateInvoicingCustomers } from '../../../../entity/invoicing/invoicingCustomer/invoicingCustomerReducer';
+import { RootState } from '../../../../reducer';
+import { fetchInvoicingCustomerCounts, fetchInvoicingCustomerList, fetchInvoicingCustomerListPage, updateInvoicingCustomerCounts, updateInvoicingCustomerCountsFailure, updateInvoicingCustomerList, updateInvoicingCustomerListFailure } from '../invoicingCustomerListViewReducer';
+/**
+ * Aggregate of every action emitted across the customer list view epics.
+ * Wired into the root action union for this view.
+ */
+export type ActionType = ReturnType<typeof fetchInvoicingCustomerList> | ReturnType<typeof fetchInvoicingCustomerListPage> | ReturnType<typeof fetchInvoicingCustomerCounts> | ReturnType<typeof updateInvoicingCustomerList> | ReturnType<typeof updateInvoicingCustomerListFailure> | ReturnType<typeof updateInvoicingCustomerCounts> | ReturnType<typeof updateInvoicingCustomerCountsFailure> | ReturnType<typeof updateInvoicingCustomers>;
+/**
+ * Orchestrates the customers list page: on `fetchInvoicingCustomerListPage`,
+ * fans out to the list and counts fetches, skipping either one whose data is
+ * already cached unless `cacheOverride` is set (e.g. on a filter/sort change).
+ */
+export declare const fetchInvoicingCustomerListPageEpic: (actions$: ActionsObservable<ActionType>, state$: StateObservable<RootState>) => Observable<ActionType>;