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

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,13 @@
+import { FetchStateAndError, ID } from '../../../commonStateTypes/common';
+import { SelectorView } from '../../../commonStateTypes/viewAndReport/viewAndReport';
+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.
+ */
+export interface InvoiceDetailView extends SelectorView {
+    actionState: FetchStateAndError;
+    invoice?: InvoicingInvoice;
+}
+export declare const getInvoiceDetail: (state: RootState, invoiceId: ID) => InvoiceDetailView;

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

@@ -0,0 +1,20 @@
+"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 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);
+    return {
+        invoice: (0, invoiceSelector_1.getInvoiceById)(state, invoiceId),
+        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,8 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+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 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,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchInvoiceListEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+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, 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,32 @@
+import { InvoicingInvoicePayload } 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';
+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">, 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,109 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearInvoiceList = exports.updateInvoiceListFilters = exports.updateInvoiceKPIsFailure = exports.updateInvoiceKPIs = exports.fetchInvoiceKPIs = exports.updateInvoiceCountsFailure = exports.updateInvoiceCounts = exports.fetchInvoiceCounts = exports.updateInvoiceListFailure = exports.updateInvoiceList = exports.fetchInvoiceListPage = exports.fetchInvoiceList = exports.initialState = void 0;
+const toolkit_1 = require("@reduxjs/toolkit");
+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) {
+                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, 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.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;

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

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getInvoiceListView = void 0;
+const toolkit_1 = require("@reduxjs/toolkit");
+const invoiceListState_1 = require("./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.
+ */
+exports.getInvoiceListView = (0, toolkit_1.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: invoiceListState_1.INVOICING_INVOICE_TABS,
+    fetchState: listViewState.fetchState,
+    error: listViewState.error,
+    version: 1.0,
+}));

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

@@ -0,0 +1,36 @@
+import { FetchStateAndError, FetchedState, ID } from '../../../commonStateTypes/common';
+import { InvoicingInvoiceKPIs } from '../../../entity/invoicing/invoice/invoiceState';
+import { InvoicingListCounts } from '../../../entity/invoicing/invoicingCommonPayload';
+import { InvoicingListSort } from '../invoicingApiHelper';
+export declare const ALL_INVOICING_INVOICE_TAB_IDS: readonly ["all", "paid", "partially_paid", "payment_due", "not_paid", "voided"];
+export declare const toInvoicingInvoiceTabId: (v: string) => "paid" | "voided" | "partially_paid" | "payment_due" | "not_paid" | "all";
+export type InvoicingInvoiceTabId = ReturnType<typeof toInvoicingInvoiceTabId>;
+/**
+ * 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 declare const INVOICING_INVOICE_TABS: InvoicingInvoiceTabId[];
+/** Filters that drive the invoice list query (mirrors the Invoices hooks). */
+export interface InvoiceListFilters {
+    customerId?: ID;
+    dateFrom?: string;
+    dateTo?: string;
+    search?: string;
+    status?: string;
+    subscriptionId?: ID;
+}
+export interface InvoiceListState extends FetchedState {
+    counts: InvoicingListCounts;
+    countsFetchState: FetchStateAndError;
+    filters: InvoiceListFilters;
+    /** Ordered invoice IDs for the current list view. */
+    invoiceIds: ID[];
+    kpisFetchState: FetchStateAndError;
+    /** Cursor for the next page (null when there are no more pages). */
+    nextCursor: string | null;
+    kpis?: InvoicingInvoiceKPIs;
+    /** Active server-side sort (undefined = backend default order). */
+    sort?: InvoicingListSort;
+}

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

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INVOICING_INVOICE_TABS = exports.toInvoicingInvoiceTabId = exports.ALL_INVOICING_INVOICE_TAB_IDS = void 0;
+const stringToUnion_1 = require("../../../commonStateTypes/stringToUnion");
+exports.ALL_INVOICING_INVOICE_TAB_IDS = [
+    'all',
+    'paid',
+    'partially_paid',
+    'payment_due',
+    'not_paid',
+    'voided',
+];
+const toInvoicingInvoiceTabId = (v) => (0, stringToUnion_1.stringToUnion)(v, exports.ALL_INVOICING_INVOICE_TAB_IDS);
+exports.toInvoicingInvoiceTabId = toInvoicingInvoiceTabId;
+/**
+ * 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.
+ */
+exports.INVOICING_INVOICE_TABS = [
+    ...exports.ALL_INVOICING_INVOICE_TAB_IDS,
+];

package/lib/view/invoicing/invoicingApiHelper.d.ts

@@ -0,0 +1,15 @@
+/** Default page size for invoicing list / infinite-scroll requests. */
+export declare const INVOICING_LIST_PAGE_SIZE = 50;
+/** Append a query string (with leading `?`) when params are present. */
+export declare const withQuery: (path: string, params: URLSearchParams) => string;
+/**
+ * Server-side sort descriptor shared by all invoicing list views. `field` is the
+ * backend sort key (validated against a per-entity whitelist); `dir` mirrors the
+ * DataListTable sort direction.
+ */
+export interface InvoicingListSort {
+    dir: 'asc' | 'desc';
+    field: string;
+}
+/** Attach `sort_field`/`sort_dir` to a list query when a sort is active. */
+export declare const applyListSortParams: (params: URLSearchParams, sort?: InvoicingListSort) => void;

package/lib/view/invoicing/invoicingApiHelper.js

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

package/lib/view/invoicing/invoicingCatalogItemDetailView/invoicingCatalogItemDetailViewEpics.d.ts

@@ -0,0 +1,9 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { updateInvoicingPlans } from '../../../entity/invoicing/plan/planReducer';
+import { updateInvoicingProducts } from '../../../entity/invoicing/product/productReducer';
+import { RootState } from '../../../reducer';
+import { ZeniAPI } from '../../../zeniAPI';
+import { fetchInvoicingCatalogItemDetail, updateInvoicingCatalogItemDetail, updateInvoicingCatalogItemDetailFailure } from './invoicingCatalogItemDetailViewReducer';
+export type ActionType = ReturnType<typeof fetchInvoicingCatalogItemDetail> | ReturnType<typeof updateInvoicingCatalogItemDetail> | ReturnType<typeof updateInvoicingCatalogItemDetailFailure> | ReturnType<typeof updateInvoicingPlans> | ReturnType<typeof updateInvoicingProducts>;
+export declare const fetchInvoicingCatalogItemDetailEpic: (actions$: ActionsObservable<ActionType>, _state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;