@zeniai/client-epic-state 5.1.98 → 5.1.99

package/lib/view/invoicing/invoicingSubscriptionListView/invoicingSubscriptionListViewState.d.ts

@@ -25,13 +25,6 @@ export declare const INVOICING_SUBSCRIPTION_COLUMNS: InvoicingSubscriptionColumn
 export declare const ALL_INVOICING_SUBSCRIPTION_TAB_IDS: readonly ["all", "active", "in_trial", "future", "non_renewing", "paused", "cancelled"];
 export declare const toInvoicingSubscriptionTabId: (v: string) => "cancelled" | "active" | "future" | "in_trial" | "non_renewing" | "paused" | "all";
 export type InvoicingSubscriptionTabId = ReturnType<typeof toInvoicingSubscriptionTabId>;
-/**
- * Ordered filter-tab id set owned by CES so the subscription-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_SUBSCRIPTION_TABS: InvoicingSubscriptionTabId[];
 export interface InvoicingSubscriptionListViewState extends FetchedState {
     /** Selected status tab (CES-owned so it persists across page revisits). */
     activeTab: InvoicingSubscriptionTabId;

package/lib/view/invoicing/invoicingSubscriptionListView/invoicingSubscriptionListViewState.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.INVOICING_SUBSCRIPTION_TABS = exports.toInvoicingSubscriptionTabId = exports.ALL_INVOICING_SUBSCRIPTION_TAB_IDS = exports.INVOICING_SUBSCRIPTION_COLUMNS = exports.toInvoicingSubscriptionSortKey = exports.ALL_INVOICING_SUBSCRIPTION_SORT_KEYS = void 0;
+exports.toInvoicingSubscriptionTabId = exports.ALL_INVOICING_SUBSCRIPTION_TAB_IDS = exports.INVOICING_SUBSCRIPTION_COLUMNS = exports.toInvoicingSubscriptionSortKey = exports.ALL_INVOICING_SUBSCRIPTION_SORT_KEYS = void 0;
 const stringToUnion_1 = require("../../../commonStateTypes/stringToUnion");
 exports.ALL_INVOICING_SUBSCRIPTION_SORT_KEYS = [
     'subscription',
@@ -37,12 +37,3 @@ exports.ALL_INVOICING_SUBSCRIPTION_TAB_IDS = [
 ];
 const toInvoicingSubscriptionTabId = (v) => (0, stringToUnion_1.stringToUnion)(v, exports.ALL_INVOICING_SUBSCRIPTION_TAB_IDS);
 exports.toInvoicingSubscriptionTabId = toInvoicingSubscriptionTabId;
-/**
- * Ordered filter-tab id set owned by CES so the subscription-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_SUBSCRIPTION_TABS = [
-    ...exports.ALL_INVOICING_SUBSCRIPTION_TAB_IDS,
-];

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

@@ -0,0 +1,27 @@
+import { InvoicingNamedOption } from '../../entity/invoicing/invoicingCommonPayload';
+export interface InvoicingTabIdsFromConfigParams<TabId extends string> {
+    /**
+     * The `as const` id set that backs the tab-id union. Used as the fallback
+     * before config lands, so the tabs are never empty on first paint.
+     */
+    allTabIds: readonly TabId[];
+    /** The config status/type list that decides membership and order. */
+    statusOptions: InvoicingNamedOption[] | undefined;
+    /**
+     * FE-derived tabs that are not backend statuses and so never appear in config
+     * (the customer list's `trial` / `at_risk`, the discount list's `inactive`).
+     * Appended after the config-driven ids, preserving today's display order.
+     */
+    localTabIds?: readonly TabId[];
+}
+/**
+ * Build a list's filter-tab ids from the config option list rather than a
+ * hardcoded array, so adding a status backend-side widens the tabs.
+ *
+ * `all` always leads and is never taken from config. Codes config sends that the
+ * tab-id union does not know still render: the union types state, the per-tab
+ * cache and URL parsing, but it is a frontend snapshot of a backend enum, and
+ * dropping unknown codes would silently hide a status the backend already has —
+ * the exact drift this is meant to end.
+ */
+export declare function invoicingTabIdsFromConfig<TabId extends string>({ allTabIds, localTabIds, statusOptions, }: InvoicingTabIdsFromConfigParams<TabId>): TabId[];

package/lib/view/invoicing/invoicingTabHelper.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invoicingTabIdsFromConfig = invoicingTabIdsFromConfig;
+const invoicingCommonPayload_1 = require("../../entity/invoicing/invoicingCommonPayload");
+/** Every list's leading "show everything" tab; FE-owned, never a backend status. */
+const ALL_TAB_ID = 'all';
+/**
+ * Build a list's filter-tab ids from the config option list rather than a
+ * hardcoded array, so adding a status backend-side widens the tabs.
+ *
+ * `all` always leads and is never taken from config. Codes config sends that the
+ * tab-id union does not know still render: the union types state, the per-tab
+ * cache and URL parsing, but it is a frontend snapshot of a backend enum, and
+ * dropping unknown codes would silently hide a status the backend already has —
+ * the exact drift this is meant to end.
+ */
+function invoicingTabIdsFromConfig({ allTabIds, localTabIds = [], statusOptions, }) {
+    // Nullish as well as empty: a partial test state or a draft persisted before
+    // these lists existed can leave it undefined.
+    if (statusOptions == null || statusOptions.length === 0) {
+        return [...allTabIds];
+    }
+    const configTabIds = (0, invoicingCommonPayload_1.invoicingOptionCodes)(statusOptions)
+        .filter((code) => code !== ALL_TAB_ID)
+        // A config code outside the union is still a valid tab at runtime — the
+        // caches key off the string — so it is admitted rather than dropped.
+        .map((code) => code);
+    const ordered = [ALL_TAB_ID, ...configTabIds, ...localTabIds];
+    return Array.from(new Set(ordered));
+}

package/lib/view/invoicing/invoicingTransactionListView/epics/fetchInvoicingTransactionListPageEpic.js

@@ -4,6 +4,7 @@ exports.fetchInvoicingTransactionListPageEpic = void 0;
 const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
 const invoicingTransactionListViewReducer_1 = require("../invoicingTransactionListViewReducer");
+const invoicingTransactionListViewState_1 = require("../invoicingTransactionListViewState");
 /**
  * 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).
@@ -19,7 +20,7 @@ const shouldFetch = (fetchStateAndError, cacheOverride) => cacheOverride ||
 const fetchInvoicingTransactionListPageEpic = (actions$, state$) => actions$.pipe((0, operators_1.filter)(invoicingTransactionListViewReducer_1.fetchInvoicingTransactionListPage.match), (0, operators_1.mergeMap)((action) => {
     const { cacheOverride, filters, sort } = action.payload;
     const state = state$.value.invoicingTransactionListViewState;
-    const activeTabState = state.byTab[state.activeTab];
+    const activeTabState = state.byTab[state.activeTab] ?? (0, invoicingTransactionListViewState_1.makeInvoicingTransactionTabState)();
     const pageActions = [];
     if (shouldFetch({ fetchState: activeTabState.fetchState, error: activeTabState.error }, cacheOverride)) {
         pageActions.push((0, invoicingTransactionListViewReducer_1.fetchInvoicingTransactionList)({ filters, sort }));

package/lib/view/invoicing/invoicingTransactionListView/invoicingTransactionListViewReducer.d.ts

@@ -25,6 +25,6 @@ export declare const fetchInvoicingTransactionList: import("@reduxjs/toolkit").A
     ids: ID[];
     keepExistingListItems: boolean;
     nextCursor: string | null;
-}, "invoicingTransactionListView/updateInvoicingTransactionList">, updateInvoicingTransactionListFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<ZeniAPIStatus<Record<string, unknown>>, "invoicingTransactionListView/updateInvoicingTransactionListFailure">, updateInvoicingTransactionFilters: import("@reduxjs/toolkit").ActionCreatorWithPayload<InvoicingTransactionFilters, "invoicingTransactionListView/updateInvoicingTransactionFilters">, setInvoicingTransactionActiveTab: import("@reduxjs/toolkit").ActionCreatorWithPayload<"refund" | "payment" | "all" | "authorization" | "payment_reversal", "invoicingTransactionListView/setInvoicingTransactionActiveTab">, addInvoicingTransactionToList: import("@reduxjs/toolkit").ActionCreatorWithPayload<string, "invoicingTransactionListView/addInvoicingTransactionToList">, clearInvoicingTransactionListView: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingTransactionListView/clearInvoicingTransactionListView">;
+}, "invoicingTransactionListView/updateInvoicingTransactionList">, updateInvoicingTransactionListFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<ZeniAPIStatus<Record<string, unknown>>, "invoicingTransactionListView/updateInvoicingTransactionListFailure">, updateInvoicingTransactionFilters: import("@reduxjs/toolkit").ActionCreatorWithPayload<InvoicingTransactionFilters, "invoicingTransactionListView/updateInvoicingTransactionFilters">, setInvoicingTransactionActiveTab: import("@reduxjs/toolkit").ActionCreatorWithPayload<"refund" | "payment" | "all" | "authorization" | "payment_reversal" | "excess_transfer", "invoicingTransactionListView/setInvoicingTransactionActiveTab">, addInvoicingTransactionToList: import("@reduxjs/toolkit").ActionCreatorWithPayload<string, "invoicingTransactionListView/addInvoicingTransactionToList">, clearInvoicingTransactionListView: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingTransactionListView/clearInvoicingTransactionListView">;
 declare const _default: import("redux").Reducer<InvoicingTransactionListViewState>;
 export default _default;

package/lib/view/invoicing/invoicingTransactionListView/invoicingTransactionListViewReducer.js

@@ -26,7 +26,7 @@ const invoicingTransactionListView = (0, toolkit_1.createSlice)({
     reducers: {
         fetchInvoicingTransactionList: {
             reducer(draft, action) {
-                const tab = draft.byTab[draft.activeTab];
+                const tab = (0, invoicingTransactionListViewState_1.invoicingTransactionTabStateFor)(draft.byTab, draft.activeTab);
                 if (!action.payload.keepExistingListItems) {
                     tab.ids = [];
                     tab.nextCursor = null;
@@ -69,7 +69,7 @@ const invoicingTransactionListView = (0, toolkit_1.createSlice)({
             },
         },
         updateInvoicingTransactionList(draft, action) {
-            const tab = draft.byTab[draft.activeTab];
+            const tab = (0, invoicingTransactionListViewState_1.invoicingTransactionTabStateFor)(draft.byTab, draft.activeTab);
             tab.ids = action.payload.keepExistingListItems
                 ? [...new Set([...tab.ids, ...action.payload.ids])]
                 : action.payload.ids;
@@ -78,7 +78,7 @@ const invoicingTransactionListView = (0, toolkit_1.createSlice)({
             tab.error = undefined;
         },
         updateInvoicingTransactionListFailure(draft, action) {
-            const tab = draft.byTab[draft.activeTab];
+            const tab = (0, invoicingTransactionListViewState_1.invoicingTransactionTabStateFor)(draft.byTab, draft.activeTab);
             tab.fetchState = 'Error';
             tab.error = action.payload;
         },
@@ -98,7 +98,7 @@ const invoicingTransactionListView = (0, toolkit_1.createSlice)({
         addInvoicingTransactionToList(draft, action) {
             const id = action.payload;
             const prependTo = (tabId) => {
-                const tab = draft.byTab[tabId];
+                const tab = (0, invoicingTransactionListViewState_1.invoicingTransactionTabStateFor)(draft.byTab, tabId);
                 if (!tab.ids.includes(id)) {
                     tab.ids = [id, ...tab.ids];
                 }

package/lib/view/invoicing/invoicingTransactionListView/invoicingTransactionListViewSelector.d.ts

@@ -1,4 +1,5 @@
 import { SelectorView } from '../../../commonStateTypes/viewAndReport/viewAndReport';
+import { InvoicingNamedOption } from '../../../entity/invoicing/invoicingCommonPayload';
 import { InvoicingTransaction } from '../../../entity/invoicing/invoicingTransaction/invoicingTransactionState';
 import { RootState } from '../../../reducer';
 import { InvoicingListSort } from '../invoicingApiHelper';
@@ -8,8 +9,15 @@ export interface InvoicingTransactionListView extends SelectorView {
     columns: InvoicingTransactionColumnConfig[];
     filters: InvoicingTransactionFilters;
     nextCursor: string | null;
+    /**
+     * Config lists this page labels from. Tabs on this list are transaction
+     * *types*, while row badges show transaction *status*, so both are exposed —
+     * conflating them left status badges with no names to resolve against.
+     */
+    statusOptions: InvoicingNamedOption[];
     tabIds: InvoicingTransactionTabId[];
     transactions: InvoicingTransaction[];
+    typeOptions: InvoicingNamedOption[];
     sort?: InvoicingListSort;
 }
 /**

package/lib/view/invoicing/invoicingTransactionListView/invoicingTransactionListViewSelector.js

@@ -3,14 +3,16 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getInvoicingTransactionListView = void 0;
 const toolkit_1 = require("@reduxjs/toolkit");
 const invoicingTransactionSelector_1 = require("../../../entity/invoicing/invoicingTransaction/invoicingTransactionSelector");
+const invoicingTabHelper_1 = require("../invoicingTabHelper");
 const invoicingTransactionListViewState_1 = require("./invoicingTransactionListViewState");
 /**
  * Memoized so the denormalized `transactions` array (and the wrapping view
  * object) keep referential identity until the transaction entity slice or the
  * list-view slice actually change.
  */
-exports.getInvoicingTransactionListView = (0, toolkit_1.createSelector)((state) => state.invoicingTransactionState, (state) => state.invoicingTransactionListViewState, (transactionState, listViewState) => {
-    const activeTabState = listViewState.byTab[listViewState.activeTab];
+exports.getInvoicingTransactionListView = (0, toolkit_1.createSelector)((state) => state.invoicingTransactionState, (state) => state.invoicingTransactionListViewState, (state) => state.invoicingConfigViewState.transactionTypeOptions, (state) => state.invoicingConfigViewState.transactionStatusOptions, (transactionState, listViewState, typeOptions, statusOptions) => {
+    const activeTabState = listViewState.byTab[listViewState.activeTab] ??
+        (0, invoicingTransactionListViewState_1.makeInvoicingTransactionTabState)();
     return {
         activeTab: listViewState.activeTab,
         columns: invoicingTransactionListViewState_1.INVOICING_TRANSACTION_COLUMNS,
@@ -19,7 +21,13 @@ exports.getInvoicingTransactionListView = (0, toolkit_1.createSelector)((state)
         nextCursor: activeTabState.nextCursor,
         fetchState: activeTabState.fetchState,
         error: activeTabState.error,
-        tabIds: invoicingTransactionListViewState_1.INVOICING_TRANSACTION_TABS,
+        statusOptions,
+        typeOptions,
+        // Tabs are types on this list, so the type list drives membership.
+        tabIds: (0, invoicingTabHelper_1.invoicingTabIdsFromConfig)({
+            allTabIds: invoicingTransactionListViewState_1.ALL_INVOICING_TRANSACTION_TAB_IDS,
+            statusOptions: typeOptions,
+        }),
         sort: listViewState.sort,
         version: 1.0,
     };

package/lib/view/invoicing/invoicingTransactionListView/invoicingTransactionListViewState.d.ts

@@ -20,16 +20,9 @@ export interface InvoicingTransactionColumnConfig {
     sortable: boolean;
 }
 export declare const INVOICING_TRANSACTION_COLUMNS: InvoicingTransactionColumnConfig[];
-export declare const ALL_INVOICING_TRANSACTION_TAB_IDS: readonly ["all", "payment", "refund", "authorization", "payment_reversal"];
-export declare const toInvoicingTransactionTabId: (v: string) => "refund" | "payment" | "all" | "authorization" | "payment_reversal";
+export declare const ALL_INVOICING_TRANSACTION_TAB_IDS: readonly ["all", "payment", "refund", "authorization", "payment_reversal", "excess_transfer"];
+export declare const toInvoicingTransactionTabId: (v: string) => "refund" | "payment" | "all" | "authorization" | "payment_reversal" | "excess_transfer";
 export type InvoicingTransactionTabId = ReturnType<typeof toInvoicingTransactionTabId>;
-/**
- * Ordered filter-tab id set owned by CES so the transaction-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_TRANSACTION_TABS: InvoicingTransactionTabId[];
 /**
  * Per-tab cache slice. Each `type` tab is a separate server query (the backend
  * filters by `type`), so its loaded ids, pagination cursor and fetch state are
@@ -39,7 +32,12 @@ export interface InvoicingTransactionTabState extends FetchStateAndError {
     ids: ID[];
     nextCursor: string | null;
 }
-export type InvoicingTransactionIdsByTab = Record<InvoicingTransactionTabId, InvoicingTransactionTabState>;
+/**
+ * Per-tab cache. `Partial` because the tab set comes from `/1.0/config`: a type
+ * the backend added that this build's tab-id union does not know still renders a
+ * tab, and its entry is created on first use rather than pre-seeded.
+ */
+export type InvoicingTransactionIdsByTab = Partial<Record<InvoicingTransactionTabId, InvoicingTransactionTabState>>;
 export interface InvoicingTransactionListViewState {
     /** Selected type tab (CES-owned so it persists across page revisits). */
     activeTab: InvoicingTransactionTabId;
@@ -51,4 +49,6 @@ export interface InvoicingTransactionListViewState {
     sort?: InvoicingListSort;
 }
 export declare const makeInvoicingTransactionTabState: () => InvoicingTransactionTabState;
+/** The cache entry for a tab, created on first use. */
+export declare const invoicingTransactionTabStateFor: (byTab: InvoicingTransactionIdsByTab, tabId: InvoicingTransactionTabId) => InvoicingTransactionTabState;
 export declare const makeInvoicingTransactionIdsByTab: () => InvoicingTransactionIdsByTab;

package/lib/view/invoicing/invoicingTransactionListView/invoicingTransactionListViewState.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.makeInvoicingTransactionIdsByTab = exports.makeInvoicingTransactionTabState = exports.INVOICING_TRANSACTION_TABS = exports.toInvoicingTransactionTabId = exports.ALL_INVOICING_TRANSACTION_TAB_IDS = exports.INVOICING_TRANSACTION_COLUMNS = exports.toInvoicingTransactionSortKey = exports.ALL_INVOICING_TRANSACTION_SORT_KEYS = void 0;
+exports.makeInvoicingTransactionIdsByTab = exports.invoicingTransactionTabStateFor = exports.makeInvoicingTransactionTabState = exports.toInvoicingTransactionTabId = exports.ALL_INVOICING_TRANSACTION_TAB_IDS = exports.INVOICING_TRANSACTION_COLUMNS = exports.toInvoicingTransactionSortKey = exports.ALL_INVOICING_TRANSACTION_SORT_KEYS = void 0;
 const stringToUnion_1 = require("../../../commonStateTypes/stringToUnion");
 exports.ALL_INVOICING_TRANSACTION_SORT_KEYS = [
     'transaction',
@@ -30,18 +30,10 @@ exports.ALL_INVOICING_TRANSACTION_TAB_IDS = [
     'refund',
     'authorization',
     'payment_reversal',
+    'excess_transfer',
 ];
 const toInvoicingTransactionTabId = (v) => (0, stringToUnion_1.stringToUnion)(v, exports.ALL_INVOICING_TRANSACTION_TAB_IDS);
 exports.toInvoicingTransactionTabId = toInvoicingTransactionTabId;
-/**
- * Ordered filter-tab id set owned by CES so the transaction-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_TRANSACTION_TABS = [
-    ...exports.ALL_INVOICING_TRANSACTION_TAB_IDS,
-];
 const makeInvoicingTransactionTabState = () => ({
     ids: [],
     nextCursor: null,
@@ -49,6 +41,17 @@ const makeInvoicingTransactionTabState = () => ({
     error: undefined,
 });
 exports.makeInvoicingTransactionTabState = makeInvoicingTransactionTabState;
+/** The cache entry for a tab, created on first use. */
+const invoicingTransactionTabStateFor = (byTab, tabId) => {
+    const existing = byTab[tabId];
+    if (existing != null) {
+        return existing;
+    }
+    const created = (0, exports.makeInvoicingTransactionTabState)();
+    byTab[tabId] = created;
+    return created;
+};
+exports.invoicingTransactionTabStateFor = invoicingTransactionTabStateFor;
 const makeInvoicingTransactionIdsByTab = () => exports.ALL_INVOICING_TRANSACTION_TAB_IDS.reduce((acc, tabId) => {
     acc[tabId] = (0, exports.makeInvoicingTransactionTabState)();
     return acc;

package/lib/view/invoicing/issueCreditNote/issueCreditNoteFormConfig.d.ts

@@ -1,4 +1,2 @@
 import { IssueCreditNoteFormLocalData } from './issueCreditNoteState';
-export declare const INVOICING_CREDIT_NOTE_REASON_CODES: readonly ["service_credit", "billing_error", "duplicate_charge", "pricing_correction", "goodwill", "other"];
-export type InvoicingCreditNoteReasonCode = (typeof INVOICING_CREDIT_NOTE_REASON_CODES)[number];
 export declare const initialIssueCreditNoteFormLocalData: (invoiceId?: string) => IssueCreditNoteFormLocalData;

package/lib/view/invoicing/issueCreditNote/issueCreditNoteFormConfig.js

@@ -1,17 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.initialIssueCreditNoteFormLocalData = exports.INVOICING_CREDIT_NOTE_REASON_CODES = void 0;
-exports.INVOICING_CREDIT_NOTE_REASON_CODES = [
-    'service_credit',
-    'billing_error',
-    'duplicate_charge',
-    'pricing_correction',
-    'goodwill',
-    'other',
-];
+exports.initialIssueCreditNoteFormLocalData = void 0;
 const initialIssueCreditNoteFormLocalData = (invoiceId = '') => ({
     invoiceId,
     lineItems: [],
     reasonCode: '',
+    type: '',
 });
 exports.initialIssueCreditNoteFormLocalData = initialIssueCreditNoteFormLocalData;

package/lib/view/invoicing/issueCreditNote/issueCreditNotePayload.d.ts

@@ -13,16 +13,16 @@ export interface IssueCreditNoteLineItemRequest {
 }
 export interface IssueCreditNoteRequest {
     line_items: IssueCreditNoteLineItemRequest[];
-    type: 'adjustment';
     reason_code?: string;
+    type?: string;
 }
 export type IssueCreditNoteResponse = ZeniAPIResponse<InvoicingCreditNotePayload>;
 export type CreateCreditNoteRequest = {
     customer_id: string;
     line_items: IssueCreditNoteLineItemRequest[];
-    type: 'adjustment';
     reason_code?: string;
     reference_invoice_id?: string;
+    type?: string;
 };
 export type CreateCreditNoteResponse = ZeniAPIResponse<InvoicingCreditNotePayload>;
 export declare const computeIssueCreditNoteTotal: (lineItems: IssueCreditNoteLineItemDraft[]) => number;

package/lib/view/invoicing/issueCreditNote/issueCreditNotePayload.js

@@ -27,16 +27,20 @@ const localDataToIssueCreditNotePayload = (localData) => {
         };
     });
     const reasonCode = localData.reasonCode.trim();
+    // Optional-chained: a draft persisted before this field existed has no
+    // `type`, and the draft survives navigation.
+    const type = localData.type?.trim() ?? '';
     return {
         line_items: lineItems,
-        type: 'adjustment',
         ...(reasonCode !== '' ? { reason_code: reasonCode } : {}),
+        ...(type !== '' ? { type } : {}),
     };
 };
 exports.localDataToIssueCreditNotePayload = localDataToIssueCreditNotePayload;
 const initializeIssueCreditNoteDraftFromInvoice = (invoice) => ({
     invoiceId: invoice.id,
     reasonCode: '',
+    type: '',
     lineItems: (invoice.lineItems ?? []).map((lineItem) => ({
         description: lineItem.description,
         id: lineItem.id,

package/lib/view/invoicing/issueCreditNote/issueCreditNoteSelector.d.ts

@@ -1,6 +1,7 @@
 import { FetchStateAndError, ID } from '../../../commonStateTypes/common';
 import { SelectorView } from '../../../commonStateTypes/viewAndReport/viewAndReport';
 import { InvoicingInvoice } from '../../../entity/invoicing/invoice/invoiceState';
+import { InvoicingNamedOption } from '../../../entity/invoicing/invoicingCommonPayload';
 import { RootState } from '../../../reducer';
 import { IssueCreditNoteFormLocalData } from './issueCreditNoteState';
 /**
@@ -16,8 +17,9 @@ export interface IssueCreditNoteView extends SelectorView {
      */
     isPageReady: boolean;
     localData: IssueCreditNoteFormLocalData;
-    reasonCodeValues: string[];
+    reasonCodeOptions: InvoicingNamedOption[];
     submitState: FetchStateAndError;
+    typeOptions: InvoicingNamedOption[];
     invoice?: InvoicingInvoice;
     issuedCreditNoteId?: ID;
 }

package/lib/view/invoicing/issueCreditNote/issueCreditNoteSelector.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getIssueCreditNoteView = void 0;
 const invoiceDetailSelector_1 = require("../invoiceDetail/invoiceDetailSelector");
+const invoicingConfigViewSelector_1 = require("../invoicingConfigView/invoicingConfigViewSelector");
 const issueCreditNoteFormConfig_1 = require("./issueCreditNoteFormConfig");
 /**
  * The draft is a single global slice, so a draft seeded for a previously opened
@@ -13,6 +14,7 @@ const getIssueCreditNoteView = (state, invoiceId) => {
     const invoiceView = (0, invoiceDetailSelector_1.getInvoiceDetail)(state, invoiceId);
     const { draft, error, fetchState, issuedCreditNoteId } = state.invoicingIssueCreditNoteState;
     const isDraftForInvoice = draft.invoiceId === invoiceId;
+    const { creditNoteReasonCodeOptions, creditNoteTypeOptions } = (0, invoicingConfigViewSelector_1.getInvoicingConfigView)(state);
     return {
         invoice: invoiceView.invoice,
         isPageReady: invoiceView.fetchState === 'Completed' &&
@@ -22,8 +24,9 @@ const getIssueCreditNoteView = (state, invoiceId) => {
         localData: isDraftForInvoice
             ? draft
             : (0, issueCreditNoteFormConfig_1.initialIssueCreditNoteFormLocalData)(invoiceId),
-        reasonCodeValues: [...issueCreditNoteFormConfig_1.INVOICING_CREDIT_NOTE_REASON_CODES],
+        reasonCodeOptions: creditNoteReasonCodeOptions,
         submitState: { error, fetchState },
+        typeOptions: creditNoteTypeOptions,
         error: invoiceView.error,
         fetchState: invoiceView.fetchState,
         version: 1.0,

package/lib/view/invoicing/issueCreditNote/issueCreditNoteState.d.ts

@@ -13,6 +13,12 @@ export interface IssueCreditNoteFormLocalData {
     invoiceId: ID;
     lineItems: IssueCreditNoteLineItemDraft[];
     reasonCode: string;
+    /**
+     * Credit-note type code from `credit_note_type_options`. Empty until the user
+     * picks one; the payload then omits it and lets the backend default, rather
+     * than the client asserting `adjustment` for every credit note as it used to.
+     */
+    type: string;
 }
 export interface IssueCreditNoteState extends FetchedState {
     draft: IssueCreditNoteFormLocalData;

package/lib/view/invoicing/recordPayment/recordPaymentFormConfig.d.ts

@@ -1,8 +1,2 @@
 import { RecordPaymentFormLocalData } from './recordPaymentState';
-/**
- * Canonical value sets for the Record Payment form. CES owns the values;
- * web-components maps each value to a localized label.
- */
-export declare const INVOICING_PAYMENT_METHOD_VALUES: readonly ["card", "cash", "check", "bank_transfer", "direct_debit", "paypal_express_checkout", "apple_pay", "google_pay", "ach_credit", "sepa_credit", "other"];
-export declare const INVOICING_PAYMENT_GATEWAY_VALUES: readonly ["stripe", "chargebee", "braintree", "paypal", "adyen", "razorpay", "other"];
 export declare const initialRecordPaymentFormLocalData: RecordPaymentFormLocalData;

package/lib/view/invoicing/recordPayment/recordPaymentFormConfig.js

@@ -1,32 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.initialRecordPaymentFormLocalData = exports.INVOICING_PAYMENT_GATEWAY_VALUES = exports.INVOICING_PAYMENT_METHOD_VALUES = void 0;
-/**
- * Canonical value sets for the Record Payment form. CES owns the values;
- * web-components maps each value to a localized label.
- */
-exports.INVOICING_PAYMENT_METHOD_VALUES = [
-    'card',
-    'cash',
-    'check',
-    'bank_transfer',
-    'direct_debit',
-    'paypal_express_checkout',
-    'apple_pay',
-    'google_pay',
-    'ach_credit',
-    'sepa_credit',
-    'other',
-];
-exports.INVOICING_PAYMENT_GATEWAY_VALUES = [
-    'stripe',
-    'chargebee',
-    'braintree',
-    'paypal',
-    'adyen',
-    'razorpay',
-    'other',
-];
+exports.initialRecordPaymentFormLocalData = void 0;
 exports.initialRecordPaymentFormLocalData = {
     comment: '',
     customerId: '',

package/lib/view/invoicing/recordPayment/recordPaymentSelector.d.ts

@@ -1,5 +1,6 @@
 import { ID } from '../../../commonStateTypes/common';
 import { SelectorView } from '../../../commonStateTypes/viewAndReport/viewAndReport';
+import { InvoicingNamedOption } from '../../../entity/invoicing/invoicingCommonPayload';
 import { RootState } from '../../../reducer';
 import { RecordPaymentFormLocalData } from './recordPaymentState';
 export interface InvoicingRecordPaymentView extends SelectorView {
@@ -16,9 +17,9 @@ export declare const getRecordPaymentView: (state: RootState) => InvoicingRecord
  * CES-owned payment-method / gateway value sets, and the submit fetch state.
  */
 export interface RecordPaymentFormView extends SelectorView {
-    gatewayValues: string[];
+    gatewayOptions: InvoicingNamedOption[];
     localData: RecordPaymentFormLocalData;
-    paymentMethodValues: string[];
+    paymentMethodOptions: InvoicingNamedOption[];
     contextInvoiceId?: ID;
 }
 export declare const getRecordPaymentFormView: (state: RootState) => RecordPaymentFormView;

package/lib/view/invoicing/recordPayment/recordPaymentSelector.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getRecordPaymentInvoiceOptions = exports.getRecordPaymentFormView = exports.getRecordPaymentView = void 0;
+const invoicingCommonPayload_1 = require("../../../entity/invoicing/invoicingCommonPayload");
 const invoiceListSelector_1 = require("../invoiceList/invoiceListSelector");
-const recordPaymentFormConfig_1 = require("./recordPaymentFormConfig");
+const invoicingConfigViewSelector_1 = require("../invoicingConfigView/invoicingConfigViewSelector");
 /**
  * Single bundled view for the record-payment submit lifecycle — carries the
  * submit fetch state/error and the ids produced on success.
@@ -20,22 +21,40 @@ const getRecordPaymentView = (state) => {
 exports.getRecordPaymentView = getRecordPaymentView;
 const getRecordPaymentFormView = (state) => {
     const { contextInvoiceId, error, fetchState, newPaymentDraft } = state.invoicingRecordPaymentState;
+    const { manualPaymentMethodOptions, paymentGatewayOptions } = (0, invoicingConfigViewSelector_1.getInvoicingConfigView)(state);
     return {
         contextInvoiceId,
-        gatewayValues: [...recordPaymentFormConfig_1.INVOICING_PAYMENT_GATEWAY_VALUES],
+        gatewayOptions: paymentGatewayOptions,
         localData: newPaymentDraft,
-        paymentMethodValues: [...recordPaymentFormConfig_1.INVOICING_PAYMENT_METHOD_VALUES],
+        paymentMethodOptions: manualPaymentMethodOptions,
         fetchState,
         error,
         version: 1.0,
     };
 };
 exports.getRecordPaymentFormView = getRecordPaymentFormView;
-const UNPAID_INVOICE_STATUSES = new Set([
+/**
+ * Statuses that leave nothing to collect. Kept FE-local and expressed as an
+ * exclusion so that "unpaid" is derived from the config status list rather than
+ * an allowlist: a status the backend adds later counts as collectable and shows
+ * up in the picker instead of silently disappearing from it.
+ */
+const SETTLED_INVOICE_STATUSES = new Set([
+    'paid',
+    'voided',
+]);
+/** Fallback while `/1.0/config` has not landed, so the picker is never empty. */
+const FALLBACK_UNPAID_INVOICE_STATUSES = [
     'not_paid',
     'partially_paid',
     'payment_due',
-]);
+];
+const unpaidInvoiceStatuses = (invoiceStatusOptions) => {
+    if (invoiceStatusOptions.length === 0) {
+        return new Set(FALLBACK_UNPAID_INVOICE_STATUSES);
+    }
+    return new Set((0, invoicingCommonPayload_1.invoicingOptionCodes)(invoiceStatusOptions).filter((code) => !SETTLED_INVOICE_STATUSES.has(code)));
+};
 const getRecordPaymentInvoiceOptions = (state, customerId) => {
     if (customerId === '') {
         return [];
@@ -44,8 +63,9 @@ const getRecordPaymentInvoiceOptions = (state, customerId) => {
     if (listView.filters.customerId !== customerId) {
         return [];
     }
+    const collectableStatuses = unpaidInvoiceStatuses((0, invoicingConfigViewSelector_1.getInvoicingConfigView)(state).invoiceStatusOptions);
     return listView.invoices
-        .filter((invoice) => UNPAID_INVOICE_STATUSES.has(invoice.status))
+        .filter((invoice) => collectableStatuses.has(invoice.status))
         .filter((invoice) => (invoice.amountDue?.amount ?? 0) > 0)
         .map((invoice) => ({
         amountDue: invoice.amountDue?.amount ?? 0,

package/lib/view/invoicing/settingsView/settingsViewSelector.d.ts

@@ -1,5 +1,5 @@
 import { FetchState, FetchStateAndError } from '../../../commonStateTypes/common';
-import { InvoicingNamedOption, InvoicingQboAccountMappingKindOption, InvoicingSettingsPayload } from '../../../entity/invoicing/invoicingCommonPayload';
+import { InvoicingDunningActionOption, InvoicingNamedOption, InvoicingQboAccountMappingKindOption, InvoicingSettingsPayload } from '../../../entity/invoicing/invoicingCommonPayload';
 import { RootState } from '../../../reducer';
 import { ZeniAPIStatus } from '../../../responsePayload';
 import { InvoicingBrandingFormLocalData } from './invoicingBrandingFormConfig';
@@ -46,10 +46,20 @@ export interface InvoicingEnablePrerequisites {
 export declare function deriveInvoicingEnablePrerequisites(settings: InvoicingSettingsPayload | undefined, isQboConnected: boolean, qboAccountMappingKindOptions: InvoicingQboAccountMappingKindOption[]): InvoicingEnablePrerequisites;
 export interface InvoicingSettingsHubView {
     canEnableInvoicing: boolean;
+    /**
+     * Config-owned lists and fetch state the settings hub renders, folded in so the
+     * screen reads this view instead of `getInvoicingConfigView`.
+     */
+    configFetchState: FetchState;
+    dunningScheduleActionOptions: InvoicingDunningActionOption[];
     isEnablingInvoicing: boolean;
     isQboConfigured: boolean;
     isStripeConnected: boolean;
+    qboAccountMappingKindOptions: InvoicingQboAccountMappingKindOption[];
+    qboCustomerMatchingOptions: InvoicingNamedOption[];
+    qboSyncStatusOptions: InvoicingNamedOption[];
     status: string | undefined;
+    configError?: ZeniAPIStatus;
 }
 /**
  * The settings hub's composite of everything it derives from the store: whether

package/lib/view/invoicing/settingsView/settingsViewSelector.js

@@ -79,11 +79,17 @@ function deriveInvoicingEnablePrerequisites(settings, isQboConnected, qboAccount
  * and QBO slices read here are only fetched once a settings screen is mounted.
  */
 const getInvoicingSettingsHubView = (state) => {
-    const { enableState, qboAccountMappingKindOptions, status } = (0, invoicingConfigViewSelector_1.getInvoicingConfigView)(state);
+    const { dunningScheduleActionOptions, enableState, error: configError, fetchState: configFetchState, qboAccountMappingKindOptions, qboCustomerMatchingOptions, qboSyncStatusOptions, status, } = (0, invoicingConfigViewSelector_1.getInvoicingConfigView)(state);
     const { canEnable, isQboConfigured, isStripeConnected } = deriveInvoicingEnablePrerequisites(state.invoicingSettingsViewState.settings, state.invoicingQboViewState.connection?.connected === true, qboAccountMappingKindOptions);
     return {
         canEnableInvoicing: status === 'settings' && canEnable,
+        configError,
+        configFetchState,
+        dunningScheduleActionOptions,
         isEnablingInvoicing: enableState.fetchState === 'In-Progress',
+        qboAccountMappingKindOptions,
+        qboCustomerMatchingOptions,
+        qboSyncStatusOptions,
         isQboConfigured,
         isStripeConnected,
         status,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeniai/client-epic-state",
-  "version": "5.1.98",
+  "version": "5.1.99",
   "description": "Shared module between Web & Mobile containing required abstractions for state management, async network communication. ",
   "main": "lib/index.js",
   "module": "lib/esm/index.js",