@zeniai/client-epic-state 5.1.93 → 5.1.95-betaAK0

package/lib/esm/view/invoicing/editInvoicingCustomerDetailView/saveInvoicingCustomerEpic.js

@@ -1,8 +1,10 @@
-import { of } from 'rxjs';
+import { from } from 'rxjs';
 import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { updateAddresses } from '../../../entity/address/addressReducer';
 import { extractInvoicingCustomerAddresses } from '../../../entity/invoicing/invoicingCustomer/invoicingCustomerPayload';
 import { updateInvoicingCustomers } from '../../../entity/invoicing/invoicingCustomer/invoicingCustomerReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
+import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
 import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
 import { resetNewAddressDataInLocalStore } from '../../addressView/addressViewReducer';
 import { addInvoicingCustomerToList } from '../invoicingCustomerListView/invoicingCustomerListViewReducer';
@@ -45,9 +47,29 @@ export const saveInvoicingCustomerEpic = (actions$, state$, zeniAPI) => actions$
                     status: response.data.status,
                 }));
             }
+            resultActions.push(openSnackbar({
+                messageSection: 'invoicing_customer_saved',
+                messageText: 'success',
+                type: 'success',
+            }));
             return resultActions;
         }
-        return of(submitInvoicingCustomerFormFailure(response.status));
-    }), catchError((error) => of(submitInvoicingCustomerFormFailure(createZeniAPIStatus('Unexpected Error', 'Save customer REST API call errored out ' +
-        JSON.stringify(error))))));
+        return from([
+            submitInvoicingCustomerFormFailure(response.status),
+            openSnackbar({
+                messageSection: 'invoicing_customer_saved',
+                messageText: 'failed',
+                type: 'error',
+                variables: apiErrorSnackbarVariables(response.status),
+            }),
+        ]);
+    }), catchError((error) => from([
+        submitInvoicingCustomerFormFailure(createZeniAPIStatus('Unexpected Error', 'Save customer REST API call errored out ' +
+            JSON.stringify(error))),
+        openSnackbar({
+            messageSection: 'invoicing_customer_saved',
+            messageText: 'failed',
+            type: 'error',
+        }),
+    ])));
 }));

package/lib/esm/view/invoicing/editInvoicingSubscriptionDetailView/editInvoicingSubscriptionDetailViewPayload.js

@@ -1,9 +1,13 @@
 import { toAddressUpdatableInfoPayload } from '../../addressView/addressViewPayload';
-import { billingFrequencyToPeriod } from './invoicingSubscriptionFormConfig';
+import { billingFrequencyToPeriod, invoicingSubscriptionTodayIso, toInvoicingSubscriptionQuantity, } from './invoicingSubscriptionFormConfig';
 /**
  * Build the create/update subscription request body from the form draft. The
  * shipping address is sent as an object (captured via the shared Address
  * screen); the backend persists it — same pattern as the customer save flow.
+ *
+ * `remaining_billing_cycles` is omitted when the user left the field empty, so
+ * the backend applies the plan's own `billing_cycles` (or renews forever when
+ * the plan sets no limit) rather than being pinned to a value the form invented.
  */
 export const localDataToSaveInvoicingSubscriptionPayload = (localData, shippingAddress) => {
     const frequency = billingFrequencyToPeriod(localData.billingFrequency);
@@ -11,32 +15,40 @@ export const localDataToSaveInvoicingSubscriptionPayload = (localData, shippingA
         {
             item_price_code: localData.planPriceCode,
             item_type: 'plan',
-            quantity: Math.max(1, localData.planQuantity || 1),
+            quantity: toInvoicingSubscriptionQuantity(localData.planQuantity),
         },
         ...localData.addonPriceCodes.map((priceCode) => ({
             item_price_code: priceCode,
             item_type: 'addon',
-            quantity: 1,
+            quantity: toInvoicingSubscriptionQuantity(localData.addonQuantities[priceCode]),
         })),
         ...localData.chargePriceCodes.map((priceCode) => ({
             item_price_code: priceCode,
             item_type: 'charge',
-            quantity: 1,
+            quantity: toInvoicingSubscriptionQuantity(localData.chargeQuantities[priceCode]),
         })),
     ];
     const setupFee = localData.setupFee?.amount;
     const poNumber = localData.poNumber.trim();
     const trialEnd = localData.trialEnd.trim();
+    const startedAt = localData.startedAt.trim();
+    const remainingBillingCycles = localData.remainingBillingCycles.trim();
     return {
         auto_collection: localData.autoCollection ? 'on' : 'off',
         billing_period: frequency.period,
         billing_period_unit: frequency.unit,
         currency_code: localData.preferredCurrencyCode,
         customer_id: localData.customerId,
+        started_at: startedAt !== '' ? startedAt : invoicingSubscriptionTodayIso(),
         subscription_items: items,
         ...(setupFee != null ? { setup_fee: setupFee } : {}),
         ...(poNumber !== '' ? { po_number: poNumber } : {}),
         ...(trialEnd !== '' ? { trial_end: trialEnd } : {}),
+        ...(remainingBillingCycles !== ''
+            ? {
+                remaining_billing_cycles: toInvoicingSubscriptionQuantity(Number(remainingBillingCycles)),
+            }
+            : {}),
         ...(localData.couponId !== '' ? { coupon_ids: [localData.couponId] } : {}),
         ...(shippingAddress != null
             ? { shipping_address: toAddressUpdatableInfoPayload(shippingAddress) }

package/lib/esm/view/invoicing/editInvoicingSubscriptionDetailView/invoicingSubscriptionFormConfig.js

@@ -33,17 +33,42 @@ const subscriptionItemPriceCodes = (subscription, itemType) => subscription?.sub
     ?.filter((item) => item.itemType === itemType)
     .map((item) => item.itemPriceCode)
     .filter((code) => code != null && code !== '') ?? [];
+const subscriptionItemQuantities = (subscription, itemType) => {
+    const quantities = {};
+    subscription?.subscriptionItems
+        ?.filter((item) => item.itemType === itemType)
+        .forEach((item) => {
+        if (item.itemPriceCode != null && item.itemPriceCode !== '') {
+            quantities[item.itemPriceCode] = toInvoicingSubscriptionQuantity(item.quantity);
+        }
+    });
+    return quantities;
+};
+/** Today as `YYYY-MM-DD`, the default subscription start date. */
+export const invoicingSubscriptionTodayIso = () => new Date().toISOString().slice(0, 10);
+/**
+ * Clamp a subscription-item quantity to the minimum the API accepts. Shared by
+ * the plan, add-on and charge items so none of them can bill a 0 or a fraction.
+ */
+export const toInvoicingSubscriptionQuantity = (quantity) => {
+    const whole = Math.floor(Number(quantity));
+    return Number.isFinite(whole) && whole > 0 ? whole : 1;
+};
 export const initialInvoicingSubscriptionFormLocalData = {
     addonPriceCodes: [],
+    addonQuantities: {},
     autoCollection: true,
     billingFrequency: 'monthly',
     chargePriceCodes: [],
+    chargeQuantities: {},
     couponId: '',
     customerId: '',
     planPriceCode: '',
     planQuantity: 1,
     poNumber: '',
     preferredCurrencyCode: 'USD',
+    remainingBillingCycles: '',
+    startedAt: '',
     trialEnd: '',
 };
 /** Seed the form draft from an existing subscription entity (edit mode). */
@@ -54,18 +79,26 @@ export const entityToInvoicingSubscriptionFormLocalData = (subscription) => {
     const planItem = subscription.subscriptionItems?.find((item) => item.itemType === 'plan');
     return {
         addonPriceCodes: subscriptionItemPriceCodes(subscription, 'addon'),
+        addonQuantities: subscriptionItemQuantities(subscription, 'addon'),
         autoCollection: (subscription.autoCollection ?? 'on') === 'on',
         billingFrequency: periodToBillingFrequency(subscription.billingPeriod, subscription.billingPeriodUnit),
         chargePriceCodes: subscriptionItemPriceCodes(subscription, 'charge'),
+        chargeQuantities: subscriptionItemQuantities(subscription, 'charge'),
         couponId: subscription.coupons?.[0]?.couponCode ??
             subscription.coupons?.[0]?.couponID ??
             '',
         customerId: subscription.customerID ?? '',
         planPriceCode: subscriptionItemPriceCodes(subscription, 'plan')[0] ?? '',
-        planQuantity: planItem?.quantity ?? 1,
+        planQuantity: toInvoicingSubscriptionQuantity(planItem?.quantity),
         poNumber: subscription.poNumber ?? '',
         preferredCurrencyCode: subscription.currencyCode ?? 'USD',
+        remainingBillingCycles: subscription.remainingBillingCycles != null
+            ? String(subscription.remainingBillingCycles)
+            : '',
         setupFee: subscription.setupFee,
+        startedAt: subscription.startedAt != null
+            ? subscription.startedAt.format('YYYY-MM-DD')
+            : '',
         trialEnd: subscription.trialEnd != null
             ? subscription.trialEnd.format('YYYY-MM-DD')
             : '',

package/lib/esm/view/invoicing/editInvoicingSubscriptionDetailView/saveInvoicingSubscriptionEpic.js

@@ -1,8 +1,10 @@
-import { of } from 'rxjs';
+import { from } from 'rxjs';
 import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { updateAddresses } from '../../../entity/address/addressReducer';
 import { extractInvoicingSubscriptionAddresses } from '../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionPayload';
 import { updateInvoicingSubscriptions } from '../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
+import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
 import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
 import { resetNewAddressDataInLocalStore } from '../../addressView/addressViewReducer';
 import { addInvoicingSubscriptionToList } from '../invoicingSubscriptionListView/invoicingSubscriptionListViewReducer';
@@ -38,7 +40,15 @@ export const saveInvoicingSubscriptionEpic = (actions$, state$, zeniAPI) => acti
         : zeniAPI.postAndGetJSON(`${baseUrl}/subscriptions`, { ...data });
     return request$.pipe(mergeMap((response) => {
         if (!isSuccessResponse(response) || response.data == null) {
-            return [submitInvoicingSubscriptionFormFailure(response.status)];
+            return [
+                submitInvoicingSubscriptionFormFailure(response.status),
+                openSnackbar({
+                    messageSection: 'invoicing_subscription_saved',
+                    messageText: 'failed',
+                    type: 'error',
+                    variables: apiErrorSnackbarVariables(response.status),
+                }),
+            ];
         }
         const saved = response.data;
         const couponChanged = id != null &&
@@ -78,7 +88,19 @@ export const saveInvoicingSubscriptionEpic = (actions$, state$, zeniAPI) => acti
                 status: saved.status,
             }));
         }
+        resultActions.push(openSnackbar({
+            messageSection: 'invoicing_subscription_saved',
+            messageText: 'success',
+            type: 'success',
+        }));
         return resultActions;
-    }), catchError((error) => of(submitInvoicingSubscriptionFormFailure(createZeniAPIStatus('Unexpected Error', 'Save subscription REST API call errored out ' +
-        JSON.stringify(error))))));
+    }), catchError((error) => from([
+        submitInvoicingSubscriptionFormFailure(createZeniAPIStatus('Unexpected Error', 'Save subscription REST API call errored out ' +
+            JSON.stringify(error))),
+        openSnackbar({
+            messageSection: 'invoicing_subscription_saved',
+            messageText: 'failed',
+            type: 'error',
+        }),
+    ])));
 }));

package/lib/esm/view/invoicing/editInvoicingSubscriptionDetailView/syncInvoicingSubscriptionCouponsEpic.js

@@ -1,8 +1,9 @@
-import { EMPTY, of } from 'rxjs';
+import { EMPTY, from, of } from 'rxjs';
 import { catchError, filter, map, mergeMap } from 'rxjs/operators';
 import { updateAddresses } from '../../../entity/address/addressReducer';
 import { extractInvoicingSubscriptionAddresses, } from '../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionPayload';
 import { updateInvoicingSubscriptions } from '../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionReducer';
+import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
 import { createZeniAPIStatus, isSuccessResponse, } from '../../../responsePayload';
 import { resetNewAddressDataInLocalStore } from '../../addressView/addressViewReducer';
 import { submitInvoicingSubscriptionFormFailure, submitInvoicingSubscriptionFormSuccess, syncInvoicingSubscriptionCoupons, } from './editInvoicingSubscriptionDetailViewReducer';
@@ -39,7 +40,14 @@ export const syncInvoicingSubscriptionCouponsEpic = (actions$, _state$, zeniAPI)
         : couponMutation$(zeniAPI, baseUrl, subscriptionId, 'remove-coupon', prev);
     return removeStep$.pipe(mergeMap((removeResult) => {
         if (!removeResult.success) {
-            return of(submitInvoicingSubscriptionFormFailure(failureStatus(removeResult)));
+            return from([
+                submitInvoicingSubscriptionFormFailure(failureStatus(removeResult)),
+                openSnackbar({
+                    messageSection: 'invoicing_subscription_saved',
+                    messageText: 'failed',
+                    type: 'error',
+                }),
+            ]);
         }
         const applyStep$ = next === ''
             ? of({
@@ -51,6 +59,11 @@ export const syncInvoicingSubscriptionCouponsEpic = (actions$, _state$, zeniAPI)
             if (!applyResult.success) {
                 return [
                     submitInvoicingSubscriptionFormFailure(failureStatus(applyResult)),
+                    openSnackbar({
+                        messageSection: 'invoicing_subscription_saved',
+                        messageText: 'failed',
+                        type: 'error',
+                    }),
                 ];
             }
             const couponUpdated = applyResult.payload ?? removeResult.payload;
@@ -58,7 +71,11 @@ export const syncInvoicingSubscriptionCouponsEpic = (actions$, _state$, zeniAPI)
             if (couponUpdated != null) {
                 resultActions.push(updateInvoicingSubscriptions([couponUpdated], 'merge'), updateAddresses(extractInvoicingSubscriptionAddresses([couponUpdated])));
             }
-            resultActions.push(submitInvoicingSubscriptionFormSuccess({ subscriptionId }), resetNewAddressDataInLocalStore(INVOICING_SUBSCRIPTION_SHIPPING_ADDRESS_TYPE));
+            resultActions.push(submitInvoicingSubscriptionFormSuccess({ subscriptionId }), resetNewAddressDataInLocalStore(INVOICING_SUBSCRIPTION_SHIPPING_ADDRESS_TYPE), openSnackbar({
+                messageSection: 'invoicing_subscription_saved',
+                messageText: 'success',
+                type: 'success',
+            }));
             return resultActions;
         }));
     }));

package/lib/esm/view/invoicing/invoiceAction/invoiceActionEpic.js

@@ -1,13 +1,33 @@
-import { of } from 'rxjs';
+import { from } from 'rxjs';
 import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { updateAddresses } from '../../../entity/address/addressReducer';
 import { extractInvoicingInvoiceAddresses } from '../../../entity/invoicing/invoice/invoicePayload';
 import { updateInvoices } from '../../../entity/invoicing/invoice/invoiceReducer';
-import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
+import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
+import { createZeniAPIStatus, isSuccessResponse, } from '../../../responsePayload';
 import { runInvoicingInvoiceAction, runInvoicingInvoiceActionFailure, runInvoicingInvoiceActionSuccess, updateInvoicingInvoice, } from './invoiceActionReducer';
+/** Snackbar copy per action kind; unlisted kinds run without one. */
+const SNACKBAR_SECTION_BY_KIND = {
+    regenerate: 'invoicing_invoice_regenerated',
+    'send-reminder': 'invoicing_invoice_reminder_sent',
+    void: 'invoicing_invoice_voided',
+};
 export const runInvoicingInvoiceActionEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter((action) => runInvoicingInvoiceAction.match(action) &&
     action.payload.action !== 'issue-credit-note'), mergeMap((action) => {
     const { action: kind, body, invoiceId } = action.payload;
+    const snackbarSection = SNACKBAR_SECTION_BY_KIND[kind];
+    /** `status` surfaces the platform's error text; omit it to keep the generic copy. */
+    const snackbar = (messageText, status) => snackbarSection == null
+        ? []
+        : [
+            openSnackbar({
+                messageSection: snackbarSection,
+                messageText,
+                type: messageText === 'success' ? 'success' : 'error',
+                variables: apiErrorSnackbarVariables(status),
+            }),
+        ];
     const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/invoices/${encodeURIComponent(invoiceId)}/${kind}`;
     return zeniAPI
         .postAndGetJSON(apiUrl, (body ?? {}))
@@ -17,17 +37,24 @@ export const runInvoicingInvoiceActionEpic = (actions$, _state$, zeniAPI) => act
                 updateInvoices([response.data], 'merge'),
                 updateAddresses(extractInvoicingInvoiceAddresses([response.data])),
                 runInvoicingInvoiceActionSuccess({ invoiceId }),
+                ...snackbar('success'),
             ];
         }
-        return of(runInvoicingInvoiceActionFailure({
-            error: response.status,
+        return from([
+            runInvoicingInvoiceActionFailure({
+                error: response.status,
+                invoiceId,
+            }),
+            ...snackbar('failed', response.status),
+        ]);
+    }), catchError((error) => from([
+        runInvoicingInvoiceActionFailure({
+            error: createZeniAPIStatus('Unexpected Error', 'Invoice action REST API call errored out ' +
+                JSON.stringify(error)),
             invoiceId,
-        }));
-    }), catchError((error) => of(runInvoicingInvoiceActionFailure({
-        error: createZeniAPIStatus('Unexpected Error', 'Invoice action REST API call errored out ' +
-            JSON.stringify(error)),
-        invoiceId,
-    }))));
+        }),
+        ...snackbar('failed'),
+    ])));
 }));
 export const updateInvoicingInvoiceEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(updateInvoicingInvoice.match), mergeMap((action) => {
     const { data, invoiceId } = action.payload;
@@ -40,15 +67,35 @@ export const updateInvoicingInvoiceEpic = (actions$, _state$, zeniAPI) => action
                 updateInvoices([response.data], 'merge'),
                 updateAddresses(extractInvoicingInvoiceAddresses([response.data])),
                 runInvoicingInvoiceActionSuccess({ invoiceId }),
+                openSnackbar({
+                    messageSection: 'invoicing_invoice_saved',
+                    messageText: 'success',
+                    type: 'success',
+                }),
             ];
         }
-        return of(runInvoicingInvoiceActionFailure({
-            error: response.status,
+        return from([
+            runInvoicingInvoiceActionFailure({
+                error: response.status,
+                invoiceId,
+            }),
+            openSnackbar({
+                messageSection: 'invoicing_invoice_saved',
+                messageText: 'failed',
+                type: 'error',
+                variables: apiErrorSnackbarVariables(response.status),
+            }),
+        ]);
+    }), catchError((error) => from([
+        runInvoicingInvoiceActionFailure({
+            error: createZeniAPIStatus('Unexpected Error', 'Invoice update REST API call errored out ' +
+                JSON.stringify(error)),
             invoiceId,
-        }));
-    }), catchError((error) => of(runInvoicingInvoiceActionFailure({
-        error: createZeniAPIStatus('Unexpected Error', 'Invoice update REST API call errored out ' +
-            JSON.stringify(error)),
-        invoiceId,
-    }))));
+        }),
+        openSnackbar({
+            messageSection: 'invoicing_invoice_saved',
+            messageText: 'failed',
+            type: 'error',
+        }),
+    ])));
 }));

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

@@ -1,5 +1,5 @@
 import { createSlice } from '@reduxjs/toolkit';
-import { toAuditLogEntityRouteOption, toInvoicingCatalogItemLifecycleActionOption, toInvoicingCatalogProductLifecycleActionOption, toInvoicingDiscountLifecycleActionOption, toInvoicingDunningAction, toInvoicingNamedOption, toInvoicingQboAccountMappingKindOption, toInvoicingSubscriptionEditFieldOption, toInvoicingSubscriptionLifecycleActionOption, } from '../../../entity/invoicing/invoicingCommonPayload';
+import { toAuditLogEntityRouteOption, toInvoicingCatalogItemLifecycleActionOption, toInvoicingCatalogProductLifecycleActionOption, toInvoicingDiscountLifecycleActionOption, toInvoicingDunningAction, toInvoicingNamedOption, toInvoicingNamedOptionsByKey, toInvoicingQboAccountMappingKindOption, toInvoicingSubscriptionEditFieldOption, toInvoicingSubscriptionLifecycleActionOption, } from '../../../entity/invoicing/invoicingCommonPayload';
 import { clearAll } from '../../../rootActions';
 export const initialState = {
     fetchState: 'Not-Started',
@@ -8,7 +8,21 @@ export const initialState = {
     auditLogEntityRouteOptions: [],
     auditLogListSortFieldOptions: [],
     auditLogSourceLabels: [],
+    autoCollectionOptions: [],
+    billingPeriodUnitOptions: [],
+    catalogTierTypeOptionsByPricingModel: undefined,
+    catalogTrialEndActionOptions: [],
+    catalogTrialUnitOptions: [],
+    customerTypeOptions: [],
+    dateFormatOptions: [],
+    discountApplyOnOptions: [],
+    discountDurationTypeOptions: [],
+    discountTypeOptions: [],
     dunningScheduleActionOptions: [],
+    manualPaymentMethodOptions: [],
+    netTermDayOptions: [],
+    paymentGatewayOptions: [],
+    taxabilityOptions: [],
     enableFetchState: { fetchState: 'Not-Started', error: undefined },
     subscriptionLifecycleActionOptions: [],
     subscriptionCommercialEditAllowedFromStatuses: [],
@@ -29,6 +43,8 @@ export const initialState = {
     invoicingTosAcceptanceUserAgent: undefined,
     invoicingTosAcceptanceUserId: undefined,
     isInvoicingSettingsSeeded: undefined,
+    createdAt: undefined,
+    updatedAt: undefined,
     hasValidState() {
         return (this.fetchState === 'Completed' && this.isInvoicingTosAccepted != null);
     },
@@ -44,6 +60,24 @@ export function mapInvoicingConfigPayloadToState(payload) {
             code: option.code,
             name: option.name,
         })),
+        autoCollectionOptions: (payload.auto_collection_options ?? []).map(toInvoicingNamedOption),
+        billingPeriodUnitOptions: (payload.billing_period_unit_options ?? []).map(toInvoicingNamedOption),
+        catalogTierTypeOptionsByPricingModel: payload.catalog_tier_type_options_by_pricing_model != null
+            ? toInvoicingNamedOptionsByKey(payload.catalog_tier_type_options_by_pricing_model)
+            : undefined,
+        catalogTrialEndActionOptions: (payload.catalog_trial_end_action_options ?? []).map(toInvoicingNamedOption),
+        catalogTrialUnitOptions: (payload.catalog_trial_unit_options ?? []).map(toInvoicingNamedOption),
+        customerTypeOptions: (payload.customer_type_options ?? []).map(toInvoicingNamedOption),
+        dateFormatOptions: (payload.date_format_options ?? []).map(toInvoicingNamedOption),
+        discountApplyOnOptions: (payload.discount_apply_on_options ?? []).map(toInvoicingNamedOption),
+        discountDurationTypeOptions: (payload.discount_duration_type_options ?? []).map(toInvoicingNamedOption),
+        discountTypeOptions: (payload.discount_type_options ?? []).map(toInvoicingNamedOption),
+        manualPaymentMethodOptions: (payload.manual_payment_method_options ?? []).map(toInvoicingNamedOption),
+        netTermDayOptions: (payload.net_term_day_options ?? []).map(toInvoicingNamedOption),
+        paymentGatewayOptions: (payload.payment_gateway_options ?? []).map(toInvoicingNamedOption),
+        taxabilityOptions: (payload.taxability_options ?? []).map(toInvoicingNamedOption),
+        createdAt: payload.created_at ?? undefined,
+        updatedAt: payload.updated_at ?? undefined,
         dunningScheduleActionOptions: payload.dunning_schedule_action_options.map((option) => ({
             code: toInvoicingDunningAction(option.code),
             name: option.name,

package/lib/esm/view/invoicing/invoicingConfigView/invoicingConfigViewSelector.js

@@ -1,35 +1,10 @@
 import { deriveInvoicingOnboardingStatus, } from './invoicingConfigViewPayload';
-/**
- * Single bundled view for the invoicing config — consumers read only this.
- * Carries the config flags, the derived onboarding `status` used for route
- * gating, the config fetch (`fetchState`/`error`), and the accept-terms /
- * enable action fetch states.
- */
 export const getInvoicingConfigView = (state) => {
-    const configState = state.invoicingConfigViewState;
+    const { acceptTermsFetchState, enableFetchState, ...configState } = state.invoicingConfigViewState;
     return {
-        acceptTermsState: configState.acceptTermsFetchState,
-        auditLogEntityRouteOptions: configState.auditLogEntityRouteOptions,
-        auditLogListSortFieldOptions: configState.auditLogListSortFieldOptions,
-        auditLogSourceLabels: configState.auditLogSourceLabels,
-        dunningScheduleActionOptions: configState.dunningScheduleActionOptions,
-        enableState: configState.enableFetchState,
-        subscriptionLifecycleActionOptions: configState.subscriptionLifecycleActionOptions,
-        subscriptionCommercialEditAllowedFromStatuses: configState.subscriptionCommercialEditAllowedFromStatuses,
-        subscriptionMetadataEditAllowedFromStatuses: configState.subscriptionMetadataEditAllowedFromStatuses,
-        subscriptionEditFieldOptions: configState.subscriptionEditFieldOptions,
-        subscriptionCancelTimingOptions: configState.subscriptionCancelTimingOptions,
-        subscriptionChangeOptionOptions: configState.subscriptionChangeOptionOptions,
-        catalogItemLifecycleActionOptions: configState.catalogItemLifecycleActionOptions,
-        catalogProductLifecycleActionOptions: configState.catalogProductLifecycleActionOptions,
-        discountLifecycleActionOptions: configState.discountLifecycleActionOptions,
-        qboAccountMappingKindOptions: configState.qboAccountMappingKindOptions,
-        qboCustomerMatchingOptions: configState.qboCustomerMatchingOptions,
-        qboSyncStatusOptions: configState.qboSyncStatusOptions,
-        error: configState.error,
-        fetchState: configState.fetchState,
-        isInvoicingEnabled: configState.isInvoicingEnabled,
-        isInvoicingTosAccepted: configState.isInvoicingTosAccepted,
+        ...configState,
+        acceptTermsState: acceptTermsFetchState,
+        enableState: enableFetchState,
         status: deriveInvoicingOnboardingStatus(configState.isInvoicingTosAccepted, configState.isInvoicingEnabled),
     };
 };

package/lib/esm/view/invoicing/invoicingDunningCaseDetailView/fetchInvoicingDunningEmailPreviewEpic.js

@@ -0,0 +1,26 @@
+import { of } from 'rxjs';
+import { catchError, filter, map, switchMap } from 'rxjs/operators';
+import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { toInvoicingDunningEmailPreview, } from './invoicingDunningCaseDetailViewPayload';
+import { fetchInvoicingDunningEmailPreview, updateInvoicingDunningEmailPreview, updateInvoicingDunningEmailPreviewFailure, } from './invoicingDunningCaseDetailViewReducer';
+export const fetchInvoicingDunningEmailPreviewEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(fetchInvoicingDunningEmailPreview.match), switchMap((action) => {
+    const { id } = action.payload;
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/dunning/${encodeURIComponent(id)}/email-preview`;
+    return zeniAPI
+        .postAndGetJSON(apiUrl, {})
+        .pipe(map((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            return updateInvoicingDunningEmailPreview({
+                id,
+                preview: toInvoicingDunningEmailPreview(response.data),
+            });
+        }
+        return updateInvoicingDunningEmailPreviewFailure({
+            id,
+            status: response.status,
+        });
+    }), catchError((error) => of(updateInvoicingDunningEmailPreviewFailure({
+        id,
+        status: createZeniAPIStatus('Unexpected Error', `Dunning email preview REST API call errored out: ${error instanceof Error ? error.message : String(error)}`),
+    }))));
+}));

package/lib/esm/view/invoicing/invoicingDunningCaseDetailView/fetchInvoicingDunningEmailPreviewPageEpic.js

@@ -0,0 +1,16 @@
+import { EMPTY, of } from 'rxjs';
+import { filter, mergeMap } from 'rxjs/operators';
+import { fetchInvoicingDunningEmailPreview, fetchInvoicingDunningEmailPreviewPage, } from './invoicingDunningCaseDetailViewReducer';
+const shouldFetch = (fetchStateAndError, cacheOverride) => cacheOverride ||
+    (fetchStateAndError.fetchState !== 'Completed' &&
+        fetchStateAndError.fetchState !== 'In-Progress');
+export const fetchInvoicingDunningEmailPreviewPageEpic = (actions$, state$) => actions$.pipe(filter(fetchInvoicingDunningEmailPreviewPage.match), mergeMap((action) => {
+    const { cacheOverride, id } = action.payload;
+    const detailState = state$.value.invoicingDunningCaseDetailViewState;
+    if (detailState.id !== id) {
+        return EMPTY;
+    }
+    return shouldFetch(detailState.emailPreview, cacheOverride)
+        ? of(fetchInvoicingDunningEmailPreview({ id }))
+        : EMPTY;
+}));

package/lib/esm/view/invoicing/invoicingDunningCaseDetailView/invoicingDunningCaseDetailViewPayload.js

@@ -1 +1,9 @@
-export {};
+export const toInvoicingDunningEmailPreview = (payload) => ({
+    body: payload.body,
+    bodyToken: payload.body_token,
+    cc: payload.cc,
+    renderedHtmlTemplate: payload.rendered_html_template,
+    subject: payload.subject,
+    subjectToken: payload.subject_token,
+    to: payload.to,
+});

package/lib/esm/view/invoicing/invoicingDunningCaseDetailView/invoicingDunningCaseDetailViewReducer.js

@@ -1,8 +1,14 @@
 import { createSlice } from '@reduxjs/toolkit';
 import { clearAll } from '../../../rootActions';
+export const initialEmailPreviewState = {
+    fetchState: 'Not-Started',
+    error: undefined,
+    preview: undefined,
+};
 export const initialState = {
     fetchState: 'Not-Started',
     error: undefined,
+    emailPreview: initialEmailPreviewState,
     id: undefined,
 };
 const invoicingDunningCaseDetailView = createSlice({
@@ -10,10 +16,38 @@ const invoicingDunningCaseDetailView = createSlice({
     initialState,
     reducers: {
         fetchInvoicingDunningCaseDetail(draft, action) {
+            if (draft.id !== action.payload.id) {
+                draft.emailPreview = { ...initialEmailPreviewState };
+            }
             draft.id = action.payload.id;
             draft.fetchState = 'In-Progress';
             draft.error = undefined;
         },
+        fetchInvoicingDunningEmailPreview(draft, action) {
+            if (draft.id !== action.payload.id) {
+                return;
+            }
+            draft.emailPreview.fetchState = 'In-Progress';
+            draft.emailPreview.error = undefined;
+        },
+        fetchInvoicingDunningEmailPreviewPage: {
+            reducer() {
+                // Cache-aware orchestrator trigger only.
+            },
+            prepare(payload) {
+                return {
+                    payload: {
+                        cacheOverride: payload.cacheOverride ?? false,
+                        id: payload.id,
+                    },
+                };
+            },
+        },
+        invalidateInvoicingDunningEmailPreview(draft, action) {
+            if (draft.id === action.payload.id) {
+                draft.emailPreview = { ...initialEmailPreviewState };
+            }
+        },
         updateInvoicingDunningCaseDetail(draft, action) {
             draft.id = action.payload.id;
             draft.fetchState = 'Completed';
@@ -23,6 +57,21 @@ const invoicingDunningCaseDetailView = createSlice({
             draft.fetchState = 'Error';
             draft.error = action.payload;
         },
+        updateInvoicingDunningEmailPreview(draft, action) {
+            if (draft.id === action.payload.id) {
+                draft.emailPreview = {
+                    error: undefined,
+                    fetchState: 'Completed',
+                    preview: action.payload.preview,
+                };
+            }
+        },
+        updateInvoicingDunningEmailPreviewFailure(draft, action) {
+            if (draft.id === action.payload.id) {
+                draft.emailPreview.fetchState = 'Error';
+                draft.emailPreview.error = action.payload.status;
+            }
+        },
         clearInvoicingDunningCaseDetailView(draft) {
             Object.assign(draft, initialState);
         },
@@ -33,5 +82,5 @@ const invoicingDunningCaseDetailView = createSlice({
         });
     },
 });
-export const { fetchInvoicingDunningCaseDetail, updateInvoicingDunningCaseDetail, updateInvoicingDunningCaseDetailFailure, clearInvoicingDunningCaseDetailView, } = invoicingDunningCaseDetailView.actions;
+export const { clearInvoicingDunningCaseDetailView, fetchInvoicingDunningCaseDetail, fetchInvoicingDunningEmailPreview, fetchInvoicingDunningEmailPreviewPage, invalidateInvoicingDunningEmailPreview, updateInvoicingDunningCaseDetail, updateInvoicingDunningCaseDetailFailure, updateInvoicingDunningEmailPreview, updateInvoicingDunningEmailPreviewFailure, } = invoicingDunningCaseDetailView.actions;
 export default invoicingDunningCaseDetailView.reducer;