@zeniai/client-epic-state 5.1.60-betaDI1 → 5.1.61

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

@@ -0,0 +1,156 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearInvoicingCatalogListView = exports.fetchInvoicingCatalogListPage = exports.addInvoicingCatalogItem = exports.updateInvoicingCatalogProductFilters = exports.updateInvoicingCatalogPlanFilters = exports.updateInvoicingCatalogCountsFailure = exports.updateInvoicingCatalogCounts = exports.fetchInvoicingCatalogCounts = exports.updateInvoicingCatalogProductListFailure = exports.updateInvoicingCatalogProductList = exports.fetchInvoicingCatalogProductList = exports.updateInvoicingCatalogPlanListFailure = exports.updateInvoicingCatalogPlanList = exports.fetchInvoicingCatalogPlanList = exports.initialState = void 0;
+const toolkit_1 = require("@reduxjs/toolkit");
+exports.initialState = {
+    fetchState: 'Not-Started',
+    error: undefined,
+    planIds: [],
+    planNextCursor: null,
+    planFilters: {},
+    productIds: [],
+    productNextCursor: null,
+    productFetchState: { fetchState: 'Not-Started', error: undefined },
+    productFilters: {},
+    counts: { all: 0 },
+    countsFetchState: { fetchState: 'Not-Started', error: undefined },
+    hasValidState() {
+        return this.fetchState === 'Completed';
+    },
+};
+const invoicingCatalogListView = (0, toolkit_1.createSlice)({
+    name: 'invoicingCatalogListView',
+    initialState: exports.initialState,
+    reducers: {
+        fetchInvoicingCatalogPlanList: {
+            reducer(draft, action) {
+                if (!action.payload.keepExistingListItems) {
+                    draft.planIds = [];
+                    draft.planNextCursor = null;
+                }
+                draft.planFilters = action.payload.filters;
+                draft.planSort = action.payload.sort;
+                draft.fetchState = 'In-Progress';
+                draft.error = undefined;
+            },
+            prepare(payload) {
+                return {
+                    payload: {
+                        filters: payload.filters ?? {},
+                        cursor: payload.cursor,
+                        keepExistingListItems: payload.keepExistingListItems ?? false,
+                        sort: payload.sort,
+                    },
+                };
+            },
+        },
+        updateInvoicingCatalogPlanList(draft, action) {
+            draft.planIds = action.payload.keepExistingListItems
+                ? [...new Set([...draft.planIds, ...action.payload.ids])]
+                : action.payload.ids;
+            draft.planNextCursor = action.payload.nextCursor;
+            draft.fetchState = 'Completed';
+            draft.error = undefined;
+        },
+        updateInvoicingCatalogPlanListFailure(draft, action) {
+            draft.fetchState = 'Error';
+            draft.error = action.payload;
+        },
+        fetchInvoicingCatalogProductList: {
+            reducer(draft, action) {
+                if (!action.payload.keepExistingListItems) {
+                    draft.productIds = [];
+                    draft.productNextCursor = null;
+                }
+                draft.productFilters = action.payload.filters;
+                draft.productSort = action.payload.sort;
+                draft.productFetchState.fetchState = 'In-Progress';
+                draft.productFetchState.error = undefined;
+            },
+            prepare(payload) {
+                return {
+                    payload: {
+                        filters: payload.filters ?? {},
+                        cursor: payload.cursor,
+                        keepExistingListItems: payload.keepExistingListItems ?? false,
+                        sort: payload.sort,
+                    },
+                };
+            },
+        },
+        updateInvoicingCatalogProductList(draft, action) {
+            draft.productIds = action.payload.keepExistingListItems
+                ? [...new Set([...draft.productIds, ...action.payload.ids])]
+                : action.payload.ids;
+            draft.productNextCursor = action.payload.nextCursor;
+            draft.productFetchState.fetchState = 'Completed';
+            draft.productFetchState.error = undefined;
+        },
+        updateInvoicingCatalogProductListFailure(draft, action) {
+            draft.productFetchState.fetchState = 'Error';
+            draft.productFetchState.error = action.payload;
+        },
+        fetchInvoicingCatalogCounts(draft) {
+            draft.countsFetchState.fetchState = 'In-Progress';
+            draft.countsFetchState.error = undefined;
+        },
+        updateInvoicingCatalogCounts(draft, action) {
+            draft.counts = action.payload;
+            draft.countsFetchState.fetchState = 'Completed';
+            draft.countsFetchState.error = undefined;
+        },
+        updateInvoicingCatalogCountsFailure(draft, action) {
+            draft.countsFetchState.fetchState = 'Error';
+            draft.countsFetchState.error = action.payload;
+        },
+        updateInvoicingCatalogPlanFilters(draft, action) {
+            draft.planFilters = action.payload;
+        },
+        updateInvoicingCatalogProductFilters(draft, action) {
+            draft.productFilters = action.payload;
+        },
+        // Reflect a newly created catalog item in the cached lists + tab counts so
+        // the catalog page shows it without refetching all lists from the server.
+        // Plans land in the plan list; add-ons/one-time-charges in the (single)
+        // product list, split back into tabs client-side by the catalog page.
+        addInvoicingCatalogItem(draft, action) {
+            const { id, type } = action.payload;
+            const isPlan = type === 'plan';
+            const alreadyPresent = (isPlan ? draft.planIds : draft.productIds).includes(id);
+            if (alreadyPresent) {
+                return;
+            }
+            if (isPlan) {
+                draft.planIds = [id, ...draft.planIds];
+            }
+            else {
+                draft.productIds = [id, ...draft.productIds];
+            }
+            draft.counts.all += 1;
+            draft.counts[type] = (draft.counts[type] ?? 0) + 1;
+        },
+        fetchInvoicingCatalogListPage: {
+            reducer() {
+                // No state mutation; the aggregator epic fans out the plan-list,
+                // product-list, counts fetches in response to this action.
+            },
+            prepare(payload) {
+                return {
+                    payload: {
+                        cacheOverride: payload.cacheOverride ?? false,
+                        planFilters: payload.planFilters ?? {},
+                        productFilters: payload.productFilters ?? {},
+                        planSort: payload.planSort,
+                        productSort: payload.productSort,
+                    },
+                };
+            },
+        },
+        clearInvoicingCatalogListView(draft) {
+            Object.assign(draft, exports.initialState);
+        },
+    },
+});
+_a = invoicingCatalogListView.actions, exports.fetchInvoicingCatalogPlanList = _a.fetchInvoicingCatalogPlanList, exports.updateInvoicingCatalogPlanList = _a.updateInvoicingCatalogPlanList, exports.updateInvoicingCatalogPlanListFailure = _a.updateInvoicingCatalogPlanListFailure, exports.fetchInvoicingCatalogProductList = _a.fetchInvoicingCatalogProductList, exports.updateInvoicingCatalogProductList = _a.updateInvoicingCatalogProductList, exports.updateInvoicingCatalogProductListFailure = _a.updateInvoicingCatalogProductListFailure, exports.fetchInvoicingCatalogCounts = _a.fetchInvoicingCatalogCounts, exports.updateInvoicingCatalogCounts = _a.updateInvoicingCatalogCounts, exports.updateInvoicingCatalogCountsFailure = _a.updateInvoicingCatalogCountsFailure, exports.updateInvoicingCatalogPlanFilters = _a.updateInvoicingCatalogPlanFilters, exports.updateInvoicingCatalogProductFilters = _a.updateInvoicingCatalogProductFilters, exports.addInvoicingCatalogItem = _a.addInvoicingCatalogItem, exports.fetchInvoicingCatalogListPage = _a.fetchInvoicingCatalogListPage, exports.clearInvoicingCatalogListView = _a.clearInvoicingCatalogListView;
+exports.default = invoicingCatalogListView.reducer;

package/lib/view/invoicing/invoicingCatalogListView/invoicingCatalogListViewSelector.d.ts

@@ -0,0 +1,29 @@
+import { FetchStateAndError } from '../../../commonStateTypes/common';
+import { SelectorView } from '../../../commonStateTypes/viewAndReport/viewAndReport';
+import { InvoicingListCounts } from '../../../entity/invoicing/invoicingCommonPayload';
+import { InvoicingPlan } from '../../../entity/invoicing/plan/planState';
+import { InvoicingProduct } from '../../../entity/invoicing/product/productState';
+import { RootState } from '../../../reducer';
+import { InvoicingListSort } from '../invoicingApiHelper';
+import { InvoicingCatalogPlanFilters, InvoicingCatalogProductFilters, InvoicingProductColumnConfig } from './invoicingCatalogListViewState';
+export interface InvoicingCatalogListView extends SelectorView {
+    count: InvoicingListCounts;
+    countsFetchState: FetchStateAndError;
+    planFilters: InvoicingCatalogPlanFilters;
+    planNextCursor: string | null;
+    plans: InvoicingPlan[];
+    productColumns: InvoicingProductColumnConfig[];
+    productFetchState: FetchStateAndError;
+    productFilters: InvoicingCatalogProductFilters;
+    productNextCursor: string | null;
+    products: InvoicingPlan[];
+    productSort?: InvoicingListSort;
+}
+export declare const getInvoicingCatalogPrices: (items: InvoicingPlan[]) => InvoicingProduct[];
+/**
+ * Bundled read view for the single catalog page (plans + products tabs).
+ * Memoized over the plan + product entity slices and the list-view slice so the
+ * denormalized arrays keep referential identity. The base `fetchState`/`error`
+ * track the plan list; the product list has its own `productFetchState`.
+ */
+export declare const getInvoicingCatalogListView: (state: RootState) => InvoicingCatalogListView;

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

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getInvoicingCatalogListView = exports.getInvoicingCatalogPrices = void 0;
+const toolkit_1 = require("@reduxjs/toolkit");
+const planSelector_1 = require("../../../entity/invoicing/plan/planSelector");
+const invoicingCatalogListViewState_1 = require("./invoicingCatalogListViewState");
+const getInvoicingCatalogPrices = (items) => items.flatMap((item) => (item.subFamilies ?? []).map((subFamily) => ({
+    ...subFamily,
+    itemID: item.id,
+    itemType: item.type ?? item.itemType,
+    name: subFamily.name,
+    priceCode: subFamily.priceCode,
+    productCode: item.productCode,
+})));
+exports.getInvoicingCatalogPrices = getInvoicingCatalogPrices;
+/**
+ * Bundled read view for the single catalog page (plans + products tabs).
+ * Memoized over the plan + product entity slices and the list-view slice so the
+ * denormalized arrays keep referential identity. The base `fetchState`/`error`
+ * track the plan list; the product list has its own `productFetchState`.
+ */
+exports.getInvoicingCatalogListView = (0, toolkit_1.createSelector)((state) => state.invoicingPlanState, (state) => state.invoicingCatalogListViewState, (planState, listViewState) => ({
+    plans: (0, planSelector_1.getInvoicingPlansByIds)(planState, listViewState.planIds),
+    productColumns: invoicingCatalogListViewState_1.INVOICING_PRODUCT_COLUMNS,
+    products: (0, planSelector_1.getInvoicingPlansByIds)(planState, listViewState.productIds),
+    productSort: listViewState.productSort,
+    count: listViewState.counts,
+    countsFetchState: listViewState.countsFetchState,
+    planFilters: listViewState.planFilters,
+    planNextCursor: listViewState.planNextCursor,
+    productFilters: listViewState.productFilters,
+    productNextCursor: listViewState.productNextCursor,
+    productFetchState: listViewState.productFetchState,
+    fetchState: listViewState.fetchState,
+    error: listViewState.error,
+    version: 1.0,
+}));

package/lib/view/invoicing/invoicingCatalogListView/invoicingCatalogListViewState.d.ts

@@ -0,0 +1,48 @@
+import { FetchStateAndError, FetchedState, ID } from '../../../commonStateTypes/common';
+import { InvoicingListCounts } from '../../../entity/invoicing/invoicingCommonPayload';
+import { InvoicingListSort } from '../invoicingApiHelper';
+export declare const ALL_INVOICING_PRODUCT_SORT_KEYS: readonly ["product_name", "product_code", "type", "pricing", "usage", "updated", "status"];
+export declare const toInvoicingProductSortKey: (v: string) => "status" | "type" | "updated" | "usage" | "product_code" | "product_name" | "pricing";
+export type InvoicingProductSortKey = ReturnType<typeof toInvoicingProductSortKey>;
+/**
+ * Structural column descriptor owned by CES for the catalog product table
+ * (add-ons / one-time charges), so the column set, order and sortability live
+ * next to the `InvoicingProduct` model rather than being hardcoded in
+ * web-components. Header labels, cell rendering and layout (alignment, widths)
+ * stay in the view layer. (The plans table keeps its own columns in web-c.)
+ */
+export interface InvoicingProductColumnConfig {
+    key: InvoicingProductSortKey;
+    sortable: boolean;
+}
+export declare const INVOICING_PRODUCT_COLUMNS: InvoicingProductColumnConfig[];
+export interface InvoicingCatalogPlanFilters {
+    search?: string;
+    status?: string;
+    type?: string;
+}
+export interface InvoicingCatalogProductFilters {
+    search?: string;
+    status?: string;
+    type?: string;
+}
+/**
+ * One catalog page renders plans and products as tabs, so this single list view
+ * holds both lists (the base `fetchState`/`error` track the plan list; the
+ * product list has its own `productFetchState`) plus shared counts.
+ */
+export interface InvoicingCatalogListViewState extends FetchedState {
+    counts: InvoicingListCounts;
+    countsFetchState: FetchStateAndError;
+    planFilters: InvoicingCatalogPlanFilters;
+    planIds: ID[];
+    planNextCursor: string | null;
+    productFetchState: FetchStateAndError;
+    productFilters: InvoicingCatalogProductFilters;
+    productIds: ID[];
+    productNextCursor: string | null;
+    /** Active server-side sort for the plans list (undefined = backend default). */
+    planSort?: InvoicingListSort;
+    /** Active server-side sort for the products list (undefined = backend default). */
+    productSort?: InvoicingListSort;
+}

package/lib/view/invoicing/invoicingCatalogListView/invoicingCatalogListViewState.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INVOICING_PRODUCT_COLUMNS = exports.toInvoicingProductSortKey = exports.ALL_INVOICING_PRODUCT_SORT_KEYS = void 0;
+const stringToUnion_1 = require("../../../commonStateTypes/stringToUnion");
+exports.ALL_INVOICING_PRODUCT_SORT_KEYS = [
+    'product_name',
+    'product_code',
+    'type',
+    'pricing',
+    'usage',
+    'updated',
+    'status',
+];
+const toInvoicingProductSortKey = (v) => (0, stringToUnion_1.stringToUnion)(v, exports.ALL_INVOICING_PRODUCT_SORT_KEYS);
+exports.toInvoicingProductSortKey = toInvoicingProductSortKey;
+exports.INVOICING_PRODUCT_COLUMNS = [
+    { key: 'product_name', sortable: true },
+    { key: 'product_code', sortable: true },
+    { key: 'type', sortable: true },
+    { key: 'pricing', sortable: false },
+    { key: 'usage', sortable: true },
+    { key: 'updated', sortable: true },
+    { key: 'status', sortable: true },
+];

package/lib/view/invoicing/invoicingConfigView/epics/acceptInvoicingTermsEpic.d.ts

@@ -0,0 +1,8 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { RootState } from '../../../../reducer';
+import { ZeniAPI } from '../../../../zeniAPI';
+import { fetchInvoicingSettings } from '../../settingsView/settingsViewReducer';
+import { acceptInvoicingTerms, acceptInvoicingTermsFailure, acceptInvoicingTermsSuccess, updateInvoicingConfig } from '../invoicingConfigViewReducer';
+export type ActionType = ReturnType<typeof acceptInvoicingTerms> | ReturnType<typeof acceptInvoicingTermsSuccess> | ReturnType<typeof acceptInvoicingTermsFailure> | ReturnType<typeof updateInvoicingConfig> | ReturnType<typeof fetchInvoicingSettings>;
+export declare const acceptInvoicingTermsEpic: (actions$: ActionsObservable<ActionType>, _state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

package/lib/view/invoicing/invoicingConfigView/epics/acceptInvoicingTermsEpic.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.acceptInvoicingTermsEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const responsePayload_1 = require("../../../../responsePayload");
+const settingsViewReducer_1 = require("../../settingsView/settingsViewReducer");
+const invoicingConfigViewReducer_1 = require("../invoicingConfigViewReducer");
+const acceptInvoicingTermsEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(invoicingConfigViewReducer_1.acceptInvoicingTerms.match), (0, operators_1.mergeMap)(() => {
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/config`;
+    return zeniAPI
+        .putAndGetJSON(apiUrl, {
+        is_invoicing_tos_accepted: true,
+    })
+        .pipe((0, operators_1.switchMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response) && response.data != null) {
+            // The TOS flip seeds the settings document server-side; refetch
+            // it so the settings step opens pre-filled.
+            return (0, rxjs_1.of)((0, invoicingConfigViewReducer_1.updateInvoicingConfig)(response.data), (0, invoicingConfigViewReducer_1.acceptInvoicingTermsSuccess)(), (0, settingsViewReducer_1.fetchInvoicingSettings)());
+        }
+        return (0, rxjs_1.of)((0, invoicingConfigViewReducer_1.acceptInvoicingTermsFailure)(response.status));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, invoicingConfigViewReducer_1.acceptInvoicingTermsFailure)((0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Accept invoicing terms REST API call errored out ' +
+        JSON.stringify(error))))));
+}));
+exports.acceptInvoicingTermsEpic = acceptInvoicingTermsEpic;

package/lib/view/invoicing/invoicingConfigView/epics/enableInvoicingEpic.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 { enableInvoicing, enableInvoicingFailure, enableInvoicingSuccess, updateInvoicingConfig } from '../invoicingConfigViewReducer';
+export type ActionType = ReturnType<typeof enableInvoicing> | ReturnType<typeof enableInvoicingSuccess> | ReturnType<typeof enableInvoicingFailure> | ReturnType<typeof updateInvoicingConfig>;
+export declare const enableInvoicingEpic: (actions$: ActionsObservable<ActionType>, _state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

package/lib/view/invoicing/invoicingConfigView/epics/enableInvoicingEpic.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enableInvoicingEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const responsePayload_1 = require("../../../../responsePayload");
+const invoicingConfigViewReducer_1 = require("../invoicingConfigViewReducer");
+const enableInvoicingEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(invoicingConfigViewReducer_1.enableInvoicing.match), (0, operators_1.mergeMap)(() => {
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/config`;
+    return zeniAPI
+        .putAndGetJSON(apiUrl, {
+        is_invoicing_enabled: true,
+    })
+        .pipe((0, operators_1.switchMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response) && response.data != null) {
+            return (0, rxjs_1.of)((0, invoicingConfigViewReducer_1.updateInvoicingConfig)(response.data), (0, invoicingConfigViewReducer_1.enableInvoicingSuccess)());
+        }
+        return (0, rxjs_1.of)((0, invoicingConfigViewReducer_1.enableInvoicingFailure)(response.status));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, invoicingConfigViewReducer_1.enableInvoicingFailure)((0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Enable invoicing REST API call errored out ' +
+        JSON.stringify(error))))));
+}));
+exports.enableInvoicingEpic = enableInvoicingEpic;

package/lib/view/invoicing/invoicingConfigView/epics/fetchInvoicingConfigEpic.d.ts

@@ -0,0 +1,12 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { RootState } from '../../../../reducer';
+import { ZeniAPI } from '../../../../zeniAPI';
+import { fetchInvoicingSettings } from '../../settingsView/settingsViewReducer';
+import { acceptInvoicingTerms, acceptInvoicingTermsFailure, acceptInvoicingTermsSuccess, enableInvoicing, enableInvoicingFailure, enableInvoicingSuccess, fetchInvoicingConfig, updateInvoicingConfig, updateInvoicingConfigFailure } from '../invoicingConfigViewReducer';
+/**
+ * Aggregate of every action emitted across the invoicing config epics.
+ * Wired into the root action union for this view.
+ */
+export type ActionType = ReturnType<typeof fetchInvoicingConfig> | ReturnType<typeof updateInvoicingConfig> | ReturnType<typeof updateInvoicingConfigFailure> | ReturnType<typeof acceptInvoicingTerms> | ReturnType<typeof acceptInvoicingTermsSuccess> | ReturnType<typeof acceptInvoicingTermsFailure> | ReturnType<typeof enableInvoicing> | ReturnType<typeof enableInvoicingSuccess> | ReturnType<typeof enableInvoicingFailure> | ReturnType<typeof fetchInvoicingSettings>;
+export declare const fetchInvoicingConfigEpic: (actions$: ActionsObservable<ActionType>, state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

package/lib/view/invoicing/invoicingConfigView/epics/fetchInvoicingConfigEpic.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchInvoicingConfigEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const responsePayload_1 = require("../../../../responsePayload");
+const invoicingConfigViewReducer_1 = require("../invoicingConfigViewReducer");
+const fetchInvoicingConfigEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(invoicingConfigViewReducer_1.fetchInvoicingConfig.match), (0, operators_1.switchMap)((action) => {
+    // Serve from cache unless forced: skip the call when the config is
+    // already loaded. Mirrors the reducer's `In-Progress` guard on the same
+    // `isInvoicingTosAccepted` marker.
+    const { isInvoicingTosAccepted } = state$.value.invoicingConfigViewState;
+    if (!action.payload.cacheOverride && isInvoicingTosAccepted != null) {
+        return rxjs_1.EMPTY;
+    }
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/config`;
+    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, invoicingConfigViewReducer_1.updateInvoicingConfig)(response.data));
+        }
+        return (0, rxjs_1.of)((0, invoicingConfigViewReducer_1.updateInvoicingConfigFailure)(response.status));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, invoicingConfigViewReducer_1.updateInvoicingConfigFailure)((0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Fetch invoicing config REST API call errored out ' +
+        JSON.stringify(error))))));
+}));
+exports.fetchInvoicingConfigEpic = fetchInvoicingConfigEpic;

package/lib/view/invoicing/invoicingConfigView/invoicingConfigViewPayload.d.ts

@@ -0,0 +1,40 @@
+import { AuditLogEntityRouteOptionWire, AuditLogListSortFieldOptionWire, AuditLogSourceLabelOptionWire, InvoicingCatalogLifecycleActionOptionWire, InvoicingDunningActionOption, InvoicingNamedOptionWire, InvoicingSubscriptionEditFieldOptionWire, InvoicingSubscriptionLifecycleActionOptionWire } from '../../../entity/invoicing/invoicingCommonPayload';
+import { ZeniAPIResponse } from '../../../responsePayload';
+/**
+ * Wire payload of the invoicing config API (GET/PUT `/1.0/config`). Follows
+ * the app-wide feature-config family (bill pay, charge cards, …): boolean
+ * flags plus server-stamped TOS acceptance audit fields.
+ */
+export interface InvoicingConfigPayload {
+    audit_log_entity_route_options: AuditLogEntityRouteOptionWire[];
+    audit_log_list_sort_field_options: AuditLogListSortFieldOptionWire[];
+    audit_log_source_labels: AuditLogSourceLabelOptionWire[];
+    catalog_item_lifecycle_action_options: InvoicingCatalogLifecycleActionOptionWire[];
+    catalog_product_lifecycle_action_options: InvoicingCatalogLifecycleActionOptionWire[];
+    discount_lifecycle_action_options: InvoicingCatalogLifecycleActionOptionWire[];
+    dunning_schedule_action_options: InvoicingDunningActionOption[];
+    is_invoicing_enabled: boolean;
+    is_invoicing_tos_accepted: boolean;
+    subscription_cancel_timing_options: InvoicingNamedOptionWire[];
+    subscription_change_option_options: InvoicingNamedOptionWire[];
+    subscription_commercial_edit_allowed_from_statuses: string[];
+    subscription_edit_field_options: InvoicingSubscriptionEditFieldOptionWire[];
+    subscription_lifecycle_action_options: InvoicingSubscriptionLifecycleActionOptionWire[];
+    subscription_metadata_edit_allowed_from_statuses: string[];
+    created_at?: string | null;
+    invoicing_tos_acceptance_ip?: string | null;
+    invoicing_tos_acceptance_time?: string | null;
+    invoicing_tos_acceptance_user_agent?: string | null;
+    invoicing_tos_acceptance_user_id?: string | null;
+    is_invoicing_settings_seeded?: boolean;
+    updated_at?: string | null;
+}
+export type InvoicingConfigResponse = ZeniAPIResponse<InvoicingConfigPayload>;
+export declare const INVOICING_ONBOARDING_STATUSES: readonly ["not_started", "settings", "completed"];
+/**
+ * Onboarding routing status derived from the config flags:
+ * TOS not accepted -> 'not_started', accepted but not enabled -> 'settings',
+ * enabled -> 'completed'.
+ */
+export type InvoicingOnboardingStatus = (typeof INVOICING_ONBOARDING_STATUSES)[number];
+export declare function deriveInvoicingOnboardingStatus(isInvoicingTosAccepted?: boolean, isInvoicingEnabled?: boolean): InvoicingOnboardingStatus | undefined;

package/lib/view/invoicing/invoicingConfigView/invoicingConfigViewPayload.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INVOICING_ONBOARDING_STATUSES = void 0;
+exports.deriveInvoicingOnboardingStatus = deriveInvoicingOnboardingStatus;
+exports.INVOICING_ONBOARDING_STATUSES = [
+    'not_started',
+    'settings',
+    'completed',
+];
+function deriveInvoicingOnboardingStatus(isInvoicingTosAccepted, isInvoicingEnabled) {
+    if (isInvoicingTosAccepted == null || isInvoicingEnabled == null) {
+        return undefined;
+    }
+    if (isInvoicingEnabled) {
+        return 'completed';
+    }
+    if (isInvoicingTosAccepted) {
+        return 'settings';
+    }
+    return 'not_started';
+}

package/lib/view/invoicing/invoicingConfigView/invoicingConfigViewReducer.d.ts

@@ -0,0 +1,12 @@
+import { ZeniAPIStatus } from '../../../responsePayload';
+import { InvoicingConfigPayload } from './invoicingConfigViewPayload';
+import { InvoicingConfigViewState } from './invoicingConfigViewState';
+export declare const initialState: InvoicingConfigViewState;
+export declare function mapInvoicingConfigPayloadToState(payload: InvoicingConfigPayload): Pick<InvoicingConfigViewState, 'auditLogEntityRouteOptions' | 'auditLogListSortFieldOptions' | 'auditLogSourceLabels' | 'dunningScheduleActionOptions' | 'subscriptionLifecycleActionOptions' | 'subscriptionCommercialEditAllowedFromStatuses' | 'subscriptionMetadataEditAllowedFromStatuses' | 'subscriptionEditFieldOptions' | 'subscriptionCancelTimingOptions' | 'subscriptionChangeOptionOptions' | 'catalogItemLifecycleActionOptions' | 'catalogProductLifecycleActionOptions' | 'discountLifecycleActionOptions' | 'isInvoicingEnabled' | 'isInvoicingTosAccepted' | 'invoicingTosAcceptanceIp' | 'invoicingTosAcceptanceTime' | 'invoicingTosAcceptanceUserAgent' | 'invoicingTosAcceptanceUserId' | 'isInvoicingSettingsSeeded'>;
+export declare const fetchInvoicingConfig: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[payload?: {
+    cacheOverride?: boolean;
+} | undefined], {
+    cacheOverride: boolean;
+}, "invoicingConfigView/fetchInvoicingConfig", never, never>, updateInvoicingConfig: import("@reduxjs/toolkit").ActionCreatorWithPayload<InvoicingConfigPayload, "invoicingConfigView/updateInvoicingConfig">, updateInvoicingConfigFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<ZeniAPIStatus<Record<string, unknown>>, "invoicingConfigView/updateInvoicingConfigFailure">, acceptInvoicingTerms: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingConfigView/acceptInvoicingTerms">, acceptInvoicingTermsSuccess: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingConfigView/acceptInvoicingTermsSuccess">, acceptInvoicingTermsFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<ZeniAPIStatus<Record<string, unknown>>, "invoicingConfigView/acceptInvoicingTermsFailure">, enableInvoicing: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingConfigView/enableInvoicing">, enableInvoicingSuccess: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingConfigView/enableInvoicingSuccess">, enableInvoicingFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<ZeniAPIStatus<Record<string, unknown>>, "invoicingConfigView/enableInvoicingFailure">, resetInvoicingConfigActionStates: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingConfigView/resetInvoicingConfigActionStates">, clearInvoicingConfig: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingConfigView/clearInvoicingConfig">;
+declare const _default: import("redux").Reducer<InvoicingConfigViewState>;
+export default _default;

package/lib/view/invoicing/invoicingConfigView/invoicingConfigViewReducer.js

@@ -0,0 +1,139 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearInvoicingConfig = exports.resetInvoicingConfigActionStates = exports.enableInvoicingFailure = exports.enableInvoicingSuccess = exports.enableInvoicing = exports.acceptInvoicingTermsFailure = exports.acceptInvoicingTermsSuccess = exports.acceptInvoicingTerms = exports.updateInvoicingConfigFailure = exports.updateInvoicingConfig = exports.fetchInvoicingConfig = exports.initialState = void 0;
+exports.mapInvoicingConfigPayloadToState = mapInvoicingConfigPayloadToState;
+const toolkit_1 = require("@reduxjs/toolkit");
+const invoicingCommonPayload_1 = require("../../../entity/invoicing/invoicingCommonPayload");
+exports.initialState = {
+    fetchState: 'Not-Started',
+    error: undefined,
+    acceptTermsFetchState: { fetchState: 'Not-Started', error: undefined },
+    auditLogEntityRouteOptions: [],
+    auditLogListSortFieldOptions: [],
+    auditLogSourceLabels: [],
+    dunningScheduleActionOptions: [],
+    enableFetchState: { fetchState: 'Not-Started', error: undefined },
+    subscriptionLifecycleActionOptions: [],
+    subscriptionCommercialEditAllowedFromStatuses: [],
+    subscriptionMetadataEditAllowedFromStatuses: [],
+    subscriptionEditFieldOptions: [],
+    subscriptionCancelTimingOptions: [],
+    subscriptionChangeOptionOptions: [],
+    catalogItemLifecycleActionOptions: [],
+    catalogProductLifecycleActionOptions: [],
+    discountLifecycleActionOptions: [],
+    isInvoicingEnabled: undefined,
+    isInvoicingTosAccepted: undefined,
+    invoicingTosAcceptanceIp: undefined,
+    invoicingTosAcceptanceTime: undefined,
+    invoicingTosAcceptanceUserAgent: undefined,
+    invoicingTosAcceptanceUserId: undefined,
+    isInvoicingSettingsSeeded: undefined,
+    hasValidState() {
+        return (this.fetchState === 'Completed' && this.isInvoicingTosAccepted != null);
+    },
+};
+function mapInvoicingConfigPayloadToState(payload) {
+    return {
+        auditLogEntityRouteOptions: (payload.audit_log_entity_route_options ?? []).map(invoicingCommonPayload_1.toAuditLogEntityRouteOption),
+        auditLogListSortFieldOptions: (payload.audit_log_list_sort_field_options ?? []).map((option) => ({
+            code: option.code,
+            name: option.name,
+        })),
+        auditLogSourceLabels: (payload.audit_log_source_labels ?? []).map((option) => ({
+            code: option.code,
+            name: option.name,
+        })),
+        dunningScheduleActionOptions: payload.dunning_schedule_action_options.map((option) => ({
+            code: (0, invoicingCommonPayload_1.toInvoicingDunningAction)(option.code),
+            name: option.name,
+        })),
+        subscriptionLifecycleActionOptions: payload.subscription_lifecycle_action_options.map((option) => (0, invoicingCommonPayload_1.toInvoicingSubscriptionLifecycleActionOption)(option)),
+        subscriptionCommercialEditAllowedFromStatuses: payload.subscription_commercial_edit_allowed_from_statuses ?? [],
+        subscriptionMetadataEditAllowedFromStatuses: payload.subscription_metadata_edit_allowed_from_statuses ?? [],
+        subscriptionEditFieldOptions: (payload.subscription_edit_field_options ?? []).map(invoicingCommonPayload_1.toInvoicingSubscriptionEditFieldOption),
+        subscriptionCancelTimingOptions: (payload.subscription_cancel_timing_options ?? []).map(invoicingCommonPayload_1.toInvoicingNamedOption),
+        subscriptionChangeOptionOptions: (payload.subscription_change_option_options ?? []).map(invoicingCommonPayload_1.toInvoicingNamedOption),
+        catalogItemLifecycleActionOptions: (payload.catalog_item_lifecycle_action_options ?? []).map((option) => (0, invoicingCommonPayload_1.toInvoicingCatalogItemLifecycleActionOption)(option)),
+        catalogProductLifecycleActionOptions: (payload.catalog_product_lifecycle_action_options ?? []).map((option) => (0, invoicingCommonPayload_1.toInvoicingCatalogProductLifecycleActionOption)(option)),
+        discountLifecycleActionOptions: (payload.discount_lifecycle_action_options ?? []).map((option) => (0, invoicingCommonPayload_1.toInvoicingDiscountLifecycleActionOption)(option)),
+        isInvoicingEnabled: payload.is_invoicing_enabled,
+        isInvoicingTosAccepted: payload.is_invoicing_tos_accepted,
+        invoicingTosAcceptanceIp: payload.invoicing_tos_acceptance_ip ?? undefined,
+        invoicingTosAcceptanceTime: payload.invoicing_tos_acceptance_time ?? undefined,
+        invoicingTosAcceptanceUserAgent: payload.invoicing_tos_acceptance_user_agent ?? undefined,
+        invoicingTosAcceptanceUserId: payload.invoicing_tos_acceptance_user_id ?? undefined,
+        isInvoicingSettingsSeeded: payload.is_invoicing_settings_seeded ?? false,
+    };
+}
+const invoicingConfigView = (0, toolkit_1.createSlice)({
+    name: 'invoicingConfigView',
+    initialState: exports.initialState,
+    reducers: {
+        // Cache-aware fetch: enters the loading state only when no config has
+        // been loaded yet, unless the caller forces a refresh with
+        // `cacheOverride`. The epic guard mirrors this same condition on
+        // `isInvoicingTosAccepted` so both agree on what "loaded" means.
+        fetchInvoicingConfig: {
+            reducer(draft, action) {
+                if (action.payload.cacheOverride ||
+                    draft.isInvoicingTosAccepted == null) {
+                    draft.fetchState = 'In-Progress';
+                    draft.error = undefined;
+                }
+            },
+            prepare(payload) {
+                return { payload: { cacheOverride: payload?.cacheOverride ?? false } };
+            },
+        },
+        updateInvoicingConfig(draft, action) {
+            Object.assign(draft, mapInvoicingConfigPayloadToState(action.payload));
+            draft.fetchState = 'Completed';
+            draft.error = undefined;
+        },
+        updateInvoicingConfigFailure(draft, action) {
+            draft.fetchState = 'Error';
+            draft.error = action.payload;
+        },
+        acceptInvoicingTerms(draft) {
+            draft.acceptTermsFetchState = {
+                fetchState: 'In-Progress',
+                error: undefined,
+            };
+        },
+        acceptInvoicingTermsSuccess(draft) {
+            draft.acceptTermsFetchState = {
+                fetchState: 'Completed',
+                error: undefined,
+            };
+        },
+        acceptInvoicingTermsFailure(draft, action) {
+            draft.acceptTermsFetchState = {
+                fetchState: 'Error',
+                error: action.payload,
+            };
+        },
+        enableInvoicing(draft) {
+            draft.enableFetchState = { fetchState: 'In-Progress', error: undefined };
+        },
+        enableInvoicingSuccess(draft) {
+            draft.enableFetchState = { fetchState: 'Completed', error: undefined };
+        },
+        enableInvoicingFailure(draft, action) {
+            draft.enableFetchState = { fetchState: 'Error', error: action.payload };
+        },
+        resetInvoicingConfigActionStates(draft) {
+            draft.acceptTermsFetchState = {
+                fetchState: 'Not-Started',
+                error: undefined,
+            };
+            draft.enableFetchState = { fetchState: 'Not-Started', error: undefined };
+        },
+        clearInvoicingConfig(draft) {
+            Object.assign(draft, exports.initialState);
+        },
+    },
+});
+_a = invoicingConfigView.actions, exports.fetchInvoicingConfig = _a.fetchInvoicingConfig, exports.updateInvoicingConfig = _a.updateInvoicingConfig, exports.updateInvoicingConfigFailure = _a.updateInvoicingConfigFailure, exports.acceptInvoicingTerms = _a.acceptInvoicingTerms, exports.acceptInvoicingTermsSuccess = _a.acceptInvoicingTermsSuccess, exports.acceptInvoicingTermsFailure = _a.acceptInvoicingTermsFailure, exports.enableInvoicing = _a.enableInvoicing, exports.enableInvoicingSuccess = _a.enableInvoicingSuccess, exports.enableInvoicingFailure = _a.enableInvoicingFailure, exports.resetInvoicingConfigActionStates = _a.resetInvoicingConfigActionStates, exports.clearInvoicingConfig = _a.clearInvoicingConfig;
+exports.default = invoicingConfigView.reducer;