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

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

@@ -0,0 +1,48 @@
+import { toAddressUpdatableInfoPayload } from '../../addressView/addressViewPayload';
+import { billingFrequencyToPeriod } 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.
+ */
+export const localDataToSaveInvoicingSubscriptionPayload = (localData, shippingAddress) => {
+    const frequency = billingFrequencyToPeriod(localData.billingFrequency);
+    const items = [
+        {
+            item_price_code: localData.planPriceCode,
+            item_type: 'plan',
+            quantity: Math.max(1, localData.planQuantity || 1),
+        },
+        ...localData.addonPriceCodes.map((priceCode) => ({
+            item_price_code: priceCode,
+            item_type: 'addon',
+            quantity: 1,
+        })),
+        ...localData.chargePriceCodes.map((priceCode) => ({
+            item_price_code: priceCode,
+            item_type: 'charge',
+            quantity: 1,
+        })),
+    ];
+    const setupFee = localData.setupFee.trim();
+    const parsedSetupFee = Number.parseFloat(setupFee);
+    const poNumber = localData.poNumber.trim();
+    const trialEnd = localData.trialEnd.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,
+        subscription_items: items,
+        ...(setupFee !== '' && !Number.isNaN(parsedSetupFee)
+            ? { setup_fee: parsedSetupFee }
+            : {}),
+        ...(poNumber !== '' ? { po_number: poNumber } : {}),
+        ...(trialEnd !== '' ? { trial_end: trialEnd } : {}),
+        ...(localData.couponId !== '' ? { coupon_ids: [localData.couponId] } : {}),
+        ...(shippingAddress != null
+            ? { shipping_address: toAddressUpdatableInfoPayload(shippingAddress) }
+            : {}),
+    };
+};

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

@@ -0,0 +1,80 @@
+import { createSlice } from '@reduxjs/toolkit';
+import { initialInvoicingSubscriptionFormLocalData } from './invoicingSubscriptionFormConfig';
+export const initialState = {
+    fetchState: 'Not-Started',
+    error: undefined,
+    editDraftById: {},
+    newSubscriptionDraft: { ...initialInvoicingSubscriptionFormLocalData },
+    savedSubscriptionId: undefined,
+    hasValidState() {
+        return this.fetchState === 'Completed';
+    },
+};
+const editInvoicingSubscriptionDetailView = createSlice({
+    name: 'editInvoicingSubscriptionDetailView',
+    initialState,
+    reducers: {
+        fetchInvoicingSubscriptionFormPage: {
+            reducer() {
+                // No state mutation; the aggregator epic fans out the option-list
+                // and subscription-detail fetches in response to this action.
+            },
+            prepare(payload) {
+                return { payload: { subscriptionId: payload.subscriptionId } };
+            },
+        },
+        updateInvoicingSubscriptionFormDraft(draft, action) {
+            const { id, localData } = action.payload;
+            if (id != null) {
+                draft.editDraftById[id] = localData;
+            }
+            else {
+                draft.newSubscriptionDraft = localData;
+            }
+        },
+        submitInvoicingSubscriptionForm: {
+            reducer(draft) {
+                draft.fetchState = 'In-Progress';
+                draft.error = undefined;
+                draft.savedSubscriptionId = undefined;
+            },
+            prepare(payload) {
+                return { payload };
+            },
+        },
+        submitInvoicingSubscriptionFormSuccess(draft, action) {
+            draft.fetchState = 'Completed';
+            draft.error = undefined;
+            draft.savedSubscriptionId = action.payload.subscriptionId;
+        },
+        submitInvoicingSubscriptionFormFailure(draft, action) {
+            draft.fetchState = 'Error';
+            draft.error = action.payload;
+        },
+        resetEditInvoicingSubscriptionDetailView(draft) {
+            draft.fetchState = 'Not-Started';
+            draft.error = undefined;
+            draft.savedSubscriptionId = undefined;
+            draft.editDraftById = {};
+            draft.newSubscriptionDraft = {
+                ...initialInvoicingSubscriptionFormLocalData,
+            };
+        },
+        // Trigger only — handled by initializeInvoicingSubscriptionAddressEpic.
+        initializeInvoicingSubscriptionAddress: {
+            reducer() { },
+            prepare(payload) {
+                return { payload };
+            },
+        },
+        // Trigger only — handled by syncInvoicingSubscriptionCouponsEpic.
+        syncInvoicingSubscriptionCoupons: {
+            reducer() { },
+            prepare(payload) {
+                return { payload };
+            },
+        },
+    },
+});
+export const { fetchInvoicingSubscriptionFormPage, updateInvoicingSubscriptionFormDraft, submitInvoicingSubscriptionForm, submitInvoicingSubscriptionFormSuccess, submitInvoicingSubscriptionFormFailure, resetEditInvoicingSubscriptionDetailView, initializeInvoicingSubscriptionAddress, syncInvoicingSubscriptionCoupons, } = editInvoicingSubscriptionDetailView.actions;
+export default editInvoicingSubscriptionDetailView.reducer;

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

@@ -0,0 +1,56 @@
+import { getInvoicingSubscriptionById } from '../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionSelector';
+import { getFormattedAddress } from '../../addressView/addressViewSelector';
+import { getInvoicingCouponListItems } from '../couponView/couponViewSelector';
+import { getInvoicingCatalogListView, getInvoicingCatalogPrices, } from '../invoicingCatalogListView/invoicingCatalogListViewSelector';
+import { getInvoicingCustomerListView } from '../invoicingCustomerListView/invoicingCustomerListViewSelector';
+import { INVOICING_SUBSCRIPTION_BILLING_FREQUENCY_VALUES, INVOICING_SUBSCRIPTION_SHIPPING_ADDRESS_TYPE, entityToInvoicingSubscriptionFormLocalData, } from './invoicingSubscriptionFormConfig';
+export const getEditInvoicingSubscriptionDetailViewState = (state, invoicingSubscriptionID) => {
+    const { error, fetchState, savedSubscriptionId } = state.editInvoicingSubscriptionDetailViewState;
+    return {
+        subscription: invoicingSubscriptionID != null
+            ? getInvoicingSubscriptionById(state.invoicingSubscriptionState, invoicingSubscriptionID)
+            : undefined,
+        savedSubscriptionId,
+        fetchState,
+        error,
+        version: 1.0,
+    };
+};
+export const getInvoicingSubscriptionFormView = (state, invoicingSubscriptionID) => {
+    const { editDraftById, error, fetchState, newSubscriptionDraft, savedSubscriptionId, } = state.editInvoicingSubscriptionDetailViewState;
+    const mode = invoicingSubscriptionID != null ? 'edit' : 'create';
+    const subscription = invoicingSubscriptionID != null
+        ? getInvoicingSubscriptionById(state.invoicingSubscriptionState, invoicingSubscriptionID)
+        : undefined;
+    const localData = invoicingSubscriptionID != null
+        ? (editDraftById[invoicingSubscriptionID] ??
+            entityToInvoicingSubscriptionFormLocalData(subscription))
+        : newSubscriptionDraft;
+    // Shipping address is captured via the shared Address screen and seeded there
+    // (looked up in the shared address store by `shippingAddressId`) on detail
+    // load, so the formatted label comes from that draft via `getFormattedAddress`.
+    const newAddress = state.addressViewState.newAddressState?.[INVOICING_SUBSCRIPTION_SHIPPING_ADDRESS_TYPE];
+    const shippingAddressLabel = newAddress?.addressToCreate != null
+        ? getFormattedAddress(newAddress.addressToCreate)
+        : undefined;
+    const catalogListView = getInvoicingCatalogListView(state);
+    const planPrices = getInvoicingCatalogPrices(catalogListView.plans);
+    const addonAndChargePrices = getInvoicingCatalogPrices(catalogListView.products);
+    return {
+        billingFrequencyValues: [
+            ...INVOICING_SUBSCRIPTION_BILLING_FREQUENCY_VALUES,
+        ],
+        coupons: getInvoicingCouponListItems(state),
+        customers: getInvoicingCustomerListView(state).customers,
+        localData,
+        mode,
+        plans: planPrices,
+        products: addonAndChargePrices,
+        savedSubscriptionId,
+        shippingAddressLabel,
+        subscription,
+        fetchState,
+        error,
+        version: 1.0,
+    };
+};

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,29 @@
+import { concat, from } from 'rxjs';
+import { filter, mergeMap } from 'rxjs/operators';
+import { fetchInvoicingCouponList } from '../couponView/couponViewReducer';
+import { fetchInvoicingCatalogPlanList } from '../invoicingCatalogListView/invoicingCatalogListViewReducer';
+import { fetchInvoicingCustomerList } from '../invoicingCustomerListView/invoicingCustomerListViewReducer';
+import { fetchInvoicingSubscriptionDetail } from '../invoicingSubscriptionDetailView/invoicingSubscriptionDetailViewReducer';
+import { fetchInvoicingSubscriptionFormPage } from './editInvoicingSubscriptionDetailViewReducer';
+/**
+ * Orchestrates the subscription create/edit form: on
+ * `fetchInvoicingSubscriptionFormPage`, fans out the option-list fetches
+ * (customers, plans, coupons) the form's dropdowns need, plus the subscription
+ * detail fetch when editing an existing subscription. Blind fan-out — the form
+ * always refreshes its option lists, matching the prior screen behavior.
+ */
+export const fetchInvoicingSubscriptionFormPageEpic = (actions$) => actions$.pipe(filter(fetchInvoicingSubscriptionFormPage.match), mergeMap((action) => {
+    const { subscriptionId } = action.payload;
+    const pageActions = [
+        fetchInvoicingCustomerList({ filters: {}, keepExistingListItems: false }),
+        fetchInvoicingCatalogPlanList({
+            filters: {},
+            keepExistingListItems: false,
+        }),
+        fetchInvoicingCouponList({ filters: {}, keepExistingListItems: false }),
+    ];
+    if (subscriptionId != null) {
+        pageActions.push(fetchInvoicingSubscriptionDetail({ id: subscriptionId }));
+    }
+    return concat(from(pageActions));
+}));

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

@@ -0,0 +1,36 @@
+import { EMPTY, of } from 'rxjs';
+import { filter, mergeMap } from 'rxjs/operators';
+import { getAddressByAddressId } from '../../../entity/address/addressSelector';
+import { getInvoicingSubscriptionById } from '../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionSelector';
+import { newAddressInLocalStore } from '../../addressView/addressViewReducer';
+import { updateInvoicingSubscriptionDetail } from '../invoicingSubscriptionDetailView/invoicingSubscriptionDetailViewReducer';
+import { initializeInvoicingSubscriptionAddress } from './editInvoicingSubscriptionDetailViewReducer';
+import { INVOICING_SUBSCRIPTION_SHIPPING_ADDRESS_TYPE } from './invoicingSubscriptionFormConfig';
+/**
+ * Seed the shared Address screen with an existing subscription's saved shipping
+ * address (looked up in the shared address store by `shippingAddressId`, same as
+ * the customer billing-address flow).
+ * Runs both when the subscription detail loads and on an explicit initialize
+ * trigger. Skips when an in-progress draft already exists, so an address the
+ * user just entered survives navigating between the form and the Address screen.
+ * Mirrors `initializeInvoicingCustomerAddressEpic`.
+ */
+export const initializeInvoicingSubscriptionAddressEpic = (actions$, state$) => actions$.pipe(filter((action) => initializeInvoicingSubscriptionAddress.match(action) ||
+    updateInvoicingSubscriptionDetail.match(action)), mergeMap((action) => {
+    const { id } = action.payload;
+    const rootState = state$.value;
+    const existingDraft = rootState.addressViewState.newAddressState?.[INVOICING_SUBSCRIPTION_SHIPPING_ADDRESS_TYPE]?.addressToCreate;
+    if (existingDraft != null || id == null) {
+        return EMPTY;
+    }
+    const subscription = getInvoicingSubscriptionById(rootState.invoicingSubscriptionState, id);
+    const address = subscription?.shippingAddressId != null
+        ? getAddressByAddressId(rootState.addressState, subscription.shippingAddressId)
+        : undefined;
+    return address != null
+        ? of(newAddressInLocalStore({
+            addressType: INVOICING_SUBSCRIPTION_SHIPPING_ADDRESS_TYPE,
+            addressToCreate: address,
+        }))
+        : EMPTY;
+}));

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

@@ -0,0 +1,74 @@
+/** `AddressType` key used when the subscription form opens the shared Address screen. */
+export const INVOICING_SUBSCRIPTION_SHIPPING_ADDRESS_TYPE = 'invoicing_subscription_shipping_address';
+/**
+ * Canonical billing-frequency value set for the subscription form. CES owns the
+ * values (and their period/unit mapping); web-components maps each value to a
+ * localized label (same split as the customer form's value sets).
+ */
+export const INVOICING_SUBSCRIPTION_BILLING_FREQUENCY_VALUES = [
+    'weekly',
+    'monthly',
+    'quarterly',
+    'half_yearly',
+    'yearly',
+];
+const BILLING_FREQUENCY_TO_PERIOD = {
+    weekly: { period: 1, unit: 'week' },
+    monthly: { period: 1, unit: 'month' },
+    quarterly: { period: 3, unit: 'month' },
+    half_yearly: { period: 6, unit: 'month' },
+    yearly: { period: 1, unit: 'year' },
+};
+/** Map a billing-frequency value to its API `billing_period` / `billing_period_unit`. */
+export const billingFrequencyToPeriod = (value) => BILLING_FREQUENCY_TO_PERIOD[value] ?? BILLING_FREQUENCY_TO_PERIOD.monthly;
+/** Map an existing subscription's period/unit back to a billing-frequency value. */
+export const periodToBillingFrequency = (period, unit) => {
+    const match = INVOICING_SUBSCRIPTION_BILLING_FREQUENCY_VALUES.find((value) => {
+        const mapped = BILLING_FREQUENCY_TO_PERIOD[value];
+        return mapped.period === period && mapped.unit === unit;
+    });
+    return match ?? 'monthly';
+};
+const subscriptionItemPriceCodes = (subscription, itemType) => subscription?.subscriptionItems
+    ?.filter((item) => item.itemType === itemType)
+    .map((item) => item.itemPriceCode)
+    .filter((code) => code != null && code !== '') ?? [];
+export const initialInvoicingSubscriptionFormLocalData = {
+    addonPriceCodes: [],
+    autoCollection: true,
+    billingFrequency: 'monthly',
+    chargePriceCodes: [],
+    couponId: '',
+    customerId: '',
+    planPriceCode: '',
+    planQuantity: 1,
+    poNumber: '',
+    preferredCurrencyCode: 'USD',
+    setupFee: '',
+    trialEnd: '',
+};
+/** Seed the form draft from an existing subscription entity (edit mode). */
+export const entityToInvoicingSubscriptionFormLocalData = (subscription) => {
+    if (subscription == null) {
+        return { ...initialInvoicingSubscriptionFormLocalData };
+    }
+    const planItem = subscription.subscriptionItems?.find((item) => item.itemType === 'plan');
+    return {
+        addonPriceCodes: subscriptionItemPriceCodes(subscription, 'addon'),
+        autoCollection: (subscription.autoCollection ?? 'on') === 'on',
+        billingFrequency: periodToBillingFrequency(subscription.billingPeriod, subscription.billingPeriodUnit),
+        chargePriceCodes: subscriptionItemPriceCodes(subscription, 'charge'),
+        couponId: subscription.coupons?.[0]?.couponCode ??
+            subscription.coupons?.[0]?.couponID ??
+            '',
+        customerId: subscription.customerID ?? '',
+        planPriceCode: subscriptionItemPriceCodes(subscription, 'plan')[0] ?? '',
+        planQuantity: planItem?.quantity ?? 1,
+        poNumber: subscription.poNumber ?? '',
+        preferredCurrencyCode: subscription.currencyCode ?? 'USD',
+        setupFee: '',
+        trialEnd: subscription.trialEnd != null
+            ? subscription.trialEnd.format('YYYY-MM-DD')
+            : '',
+    };
+};

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

@@ -0,0 +1,84 @@
+import { of } 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 { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { resetNewAddressDataInLocalStore } from '../../addressView/addressViewReducer';
+import { addInvoicingSubscriptionToList } from '../invoicingSubscriptionListView/invoicingSubscriptionListViewReducer';
+import { localDataToSaveInvoicingSubscriptionPayload, } from './editInvoicingSubscriptionDetailViewPayload';
+import { submitInvoicingSubscriptionForm, submitInvoicingSubscriptionFormFailure, submitInvoicingSubscriptionFormSuccess, syncInvoicingSubscriptionCoupons, } from './editInvoicingSubscriptionDetailViewReducer';
+import { INVOICING_SUBSCRIPTION_SHIPPING_ADDRESS_TYPE } from './invoicingSubscriptionFormConfig';
+const normalizeCouponCode = (value) => (value ?? '').trim().toUpperCase();
+export const saveInvoicingSubscriptionEpic = (actions$, state$, zeniAPI) => actions$.pipe(filter(submitInvoicingSubscriptionForm.match), mergeMap((action) => {
+    const { id } = action.payload;
+    const rootState = state$.value;
+    const viewState = rootState.editInvoicingSubscriptionDetailViewState;
+    const localData = (id != null
+        ? viewState.editDraftById[id]
+        : viewState.newSubscriptionDraft) ?? viewState.newSubscriptionDraft;
+    // Shipping address captured via the shared Address screen is sent as an
+    // object in the payload (same pattern as the customer save flow).
+    const shippingAddress = rootState.addressViewState.newAddressState?.[INVOICING_SUBSCRIPTION_SHIPPING_ADDRESS_TYPE]?.addressToCreate;
+    const data = localDataToSaveInvoicingSubscriptionPayload(localData, shippingAddress);
+    // Coupons are synced via apply/remove-coupon after PUT (not via coupon_ids).
+    if (id != null) {
+        delete data.coupon_ids;
+    }
+    const baseUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0`;
+    const previousCouponCode = id != null
+        ? (rootState.invoicingSubscriptionState.invoicingSubscriptionByID[id]
+            ?.coupons?.[0]?.couponCode ??
+            rootState.invoicingSubscriptionState.invoicingSubscriptionByID[id]
+                ?.coupons?.[0]?.couponID ??
+            '')
+        : '';
+    const request$ = id != null
+        ? zeniAPI.putAndGetJSON(`${baseUrl}/subscriptions/${encodeURIComponent(id)}`, { ...data })
+        : zeniAPI.postAndGetJSON(`${baseUrl}/subscriptions`, { ...data });
+    return request$.pipe(mergeMap((response) => {
+        if (!isSuccessResponse(response) || response.data == null) {
+            return [submitInvoicingSubscriptionFormFailure(response.status)];
+        }
+        const saved = response.data;
+        const couponChanged = id != null &&
+            normalizeCouponCode(previousCouponCode) !==
+                normalizeCouponCode(localData.couponId);
+        // Edit + coupon change: merge the saved subscription, then hand the
+        // coupon attach/detach to syncInvoicingSubscriptionCouponsEpic, which
+        // finishes the flow (form success on both calls ok, form failure
+        // otherwise). Deferring success here is deliberate — a swallowed
+        // coupon failure must no longer surface as a false save success.
+        if (couponChanged) {
+            return [
+                updateInvoicingSubscriptions([saved], 'merge'),
+                updateAddresses(extractInvoicingSubscriptionAddresses([saved])),
+                syncInvoicingSubscriptionCoupons({
+                    subscriptionId: saved.id,
+                    previousCouponCode,
+                    nextCouponCode: localData.couponId,
+                }),
+            ];
+        }
+        const resultActions = [
+            updateInvoicingSubscriptions([saved], 'merge'),
+            updateAddresses(extractInvoicingSubscriptionAddresses([saved])),
+            submitInvoicingSubscriptionFormSuccess({
+                subscriptionId: saved.id,
+            }),
+            // Clear the stashed address so the next subscription starts fresh.
+            resetNewAddressDataInLocalStore(INVOICING_SUBSCRIPTION_SHIPPING_ADDRESS_TYPE),
+        ];
+        // Create (no id): reflect the new row + tab counts in the cached list
+        // so the list page shows it without a refetch. Edits keep the same
+        // id/counts, so the entity merge above is enough.
+        if (id == null) {
+            resultActions.push(addInvoicingSubscriptionToList({
+                id: saved.id,
+                status: saved.status,
+            }));
+        }
+        return resultActions;
+    }), catchError((error) => of(submitInvoicingSubscriptionFormFailure(createZeniAPIStatus('Unexpected Error', 'Save subscription REST API call errored out ' +
+        JSON.stringify(error))))));
+}));

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

@@ -0,0 +1,65 @@
+import { EMPTY, 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 { createZeniAPIStatus, isSuccessResponse, } from '../../../responsePayload';
+import { resetNewAddressDataInLocalStore } from '../../addressView/addressViewReducer';
+import { submitInvoicingSubscriptionFormFailure, submitInvoicingSubscriptionFormSuccess, syncInvoicingSubscriptionCoupons, } from './editInvoicingSubscriptionDetailViewReducer';
+import { INVOICING_SUBSCRIPTION_SHIPPING_ADDRESS_TYPE } from './invoicingSubscriptionFormConfig';
+const normalizeCouponCode = (value) => (value ?? '').trim().toUpperCase();
+const couponMutation$ = (zeniAPI, baseUrl, subscriptionId, endpoint, couponCode) => zeniAPI
+    .postAndGetJSON(`${baseUrl}/subscriptions/${encodeURIComponent(subscriptionId)}/${endpoint}`, { coupon_code: couponCode })
+    .pipe(map((response) => isSuccessResponse(response)
+    ? { success: true, payload: response.data ?? null }
+    : { success: false, payload: null, status: response.status }), catchError((error) => of({
+    success: false,
+    payload: null,
+    status: createZeniAPIStatus('Unexpected Error', `${endpoint} REST API call errored out ` + JSON.stringify(error)),
+})));
+const failureStatus = (step) => step.status ??
+    createZeniAPIStatus('Unexpected Error', 'Coupon sync failed without a status');
+/**
+ * After a commercial PUT, sync coupon attach/detach via dedicated endpoints
+ * (PUT does not replace coupons). Runs remove-then-apply; on success finishes
+ * the save flow (entity merge + address reset + form success), on failure
+ * dispatches the form failure so the swallowed-error false success no longer
+ * happens.
+ */
+export const syncInvoicingSubscriptionCouponsEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(syncInvoicingSubscriptionCoupons.match), mergeMap((action) => {
+    const { subscriptionId, previousCouponCode, nextCouponCode } = action.payload;
+    const prev = normalizeCouponCode(previousCouponCode);
+    const next = normalizeCouponCode(nextCouponCode);
+    if (prev === next) {
+        return EMPTY;
+    }
+    const baseUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0`;
+    const removeStep$ = prev === ''
+        ? of({ success: true, payload: null })
+        : couponMutation$(zeniAPI, baseUrl, subscriptionId, 'remove-coupon', prev);
+    return removeStep$.pipe(mergeMap((removeResult) => {
+        if (!removeResult.success) {
+            return of(submitInvoicingSubscriptionFormFailure(failureStatus(removeResult)));
+        }
+        const applyStep$ = next === ''
+            ? of({
+                success: true,
+                payload: removeResult.payload,
+            })
+            : couponMutation$(zeniAPI, baseUrl, subscriptionId, 'apply-coupon', next);
+        return applyStep$.pipe(mergeMap((applyResult) => {
+            if (!applyResult.success) {
+                return [
+                    submitInvoicingSubscriptionFormFailure(failureStatus(applyResult)),
+                ];
+            }
+            const couponUpdated = applyResult.payload ?? removeResult.payload;
+            const resultActions = [];
+            if (couponUpdated != null) {
+                resultActions.push(updateInvoicingSubscriptions([couponUpdated], 'merge'), updateAddresses(extractInvoicingSubscriptionAddresses([couponUpdated])));
+            }
+            resultActions.push(submitInvoicingSubscriptionFormSuccess({ subscriptionId }), resetNewAddressDataInLocalStore(INVOICING_SUBSCRIPTION_SHIPPING_ADDRESS_TYPE));
+            return resultActions;
+        }));
+    }));
+}));

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

@@ -0,0 +1,54 @@
+import { of } 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 { runInvoicingInvoiceAction, runInvoicingInvoiceActionFailure, runInvoicingInvoiceActionSuccess, updateInvoicingInvoice, } from './invoiceActionReducer';
+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 apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/invoices/${encodeURIComponent(invoiceId)}/${kind}`;
+    return zeniAPI
+        .postAndGetJSON(apiUrl, (body ?? {}))
+        .pipe(mergeMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            return [
+                updateInvoices([response.data], 'merge'),
+                updateAddresses(extractInvoicingInvoiceAddresses([response.data])),
+                runInvoicingInvoiceActionSuccess({ invoiceId }),
+            ];
+        }
+        return of(runInvoicingInvoiceActionFailure({
+            error: response.status,
+            invoiceId,
+        }));
+    }), catchError((error) => of(runInvoicingInvoiceActionFailure({
+        error: createZeniAPIStatus('Unexpected Error', 'Invoice action REST API call errored out ' +
+            JSON.stringify(error)),
+        invoiceId,
+    }))));
+}));
+export const updateInvoicingInvoiceEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(updateInvoicingInvoice.match), mergeMap((action) => {
+    const { data, invoiceId } = action.payload;
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/invoices/${encodeURIComponent(invoiceId)}`;
+    return zeniAPI
+        .putAndGetJSON(apiUrl, data)
+        .pipe(mergeMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            return [
+                updateInvoices([response.data], 'merge'),
+                updateAddresses(extractInvoicingInvoiceAddresses([response.data])),
+                runInvoicingInvoiceActionSuccess({ invoiceId }),
+            ];
+        }
+        return of(runInvoicingInvoiceActionFailure({
+            error: response.status,
+            invoiceId,
+        }));
+    }), catchError((error) => of(runInvoicingInvoiceActionFailure({
+        error: createZeniAPIStatus('Unexpected Error', 'Invoice update REST API call errored out ' +
+            JSON.stringify(error)),
+        invoiceId,
+    }))));
+}));

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,42 @@
+import { createSlice } from '@reduxjs/toolkit';
+export const initialState = {
+    byInvoiceId: {},
+};
+const invoiceAction = createSlice({
+    name: 'invoicingInvoiceAction',
+    initialState,
+    reducers: {
+        runInvoicingInvoiceAction(draft, action) {
+            draft.byInvoiceId[action.payload.invoiceId] = {
+                fetchState: 'In-Progress',
+                error: undefined,
+            };
+        },
+        runInvoicingInvoiceActionSuccess(draft, action) {
+            draft.byInvoiceId[action.payload.invoiceId] = {
+                fetchState: 'Completed',
+                error: undefined,
+            };
+        },
+        runInvoicingInvoiceActionFailure(draft, action) {
+            draft.byInvoiceId[action.payload.invoiceId] = {
+                fetchState: 'Error',
+                error: action.payload.error,
+            };
+        },
+        updateInvoicingInvoice(draft, action) {
+            draft.byInvoiceId[action.payload.invoiceId] = {
+                fetchState: 'In-Progress',
+                error: undefined,
+            };
+        },
+        clearInvoicingInvoiceAction(draft, action) {
+            delete draft.byInvoiceId[action.payload];
+        },
+        clearAllInvoicingInvoiceActions(draft) {
+            draft.byInvoiceId = {};
+        },
+    },
+});
+export const { runInvoicingInvoiceAction, runInvoicingInvoiceActionSuccess, runInvoicingInvoiceActionFailure, updateInvoicingInvoice, clearInvoicingInvoiceAction, clearAllInvoicingInvoiceActions, } = invoiceAction.actions;
+export default invoiceAction.reducer;

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

@@ -0,0 +1,2 @@
+/** Snake_case request bodies for invoice action endpoints. */
+export {};

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

@@ -0,0 +1,5 @@
+const NOT_STARTED = {
+    fetchState: 'Not-Started',
+    error: undefined,
+};
+export const getInvoicingInvoiceActionState = (invoiceId) => (state) => state.invoicingInvoiceActionState.byInvoiceId[invoiceId] ?? NOT_STARTED;

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

@@ -0,0 +1 @@
+export {};

package/lib/esm/view/invoicing/invoiceDetail/fetchInvoiceDetailEpic.js

@@ -0,0 +1,25 @@
+import { of } from 'rxjs';
+import { catchError, filter, switchMap } 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 { fetchInvoiceDetail, updateInvoiceDetail, updateInvoiceDetailFailure, } from './invoiceDetailReducer';
+export const fetchInvoiceDetailEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(fetchInvoiceDetail.match), switchMap((action) => {
+    const { invoiceId } = action.payload;
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/invoices/${invoiceId}`;
+    return zeniAPI.getJSON(apiUrl).pipe(switchMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            return [
+                updateAddresses(extractInvoicingInvoiceAddresses([response.data])),
+                updateInvoices([response.data], 'merge'),
+                updateInvoiceDetail({ invoiceId: response.data.id }),
+            ];
+        }
+        return of(updateInvoiceDetailFailure({ invoiceId, status: response.status }));
+    }), catchError((error) => of(updateInvoiceDetailFailure({
+        invoiceId,
+        status: createZeniAPIStatus('Unexpected Error', 'Fetch invoice detail REST API call errored out ' +
+            JSON.stringify(error)),
+    }))));
+}));

package/lib/esm/view/invoicing/invoiceDetail/invoiceDetailPayload.js

@@ -0,0 +1 @@
+export {};