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

package/lib/esm/view/invoicing/editInvoicingCatalogItemDetailView/editInvoicingCatalogItemDetailViewReducer.js

@@ -0,0 +1,84 @@
+import { createSlice } from '@reduxjs/toolkit';
+import { initialInvoicingCatalogItemFormLocalData } from './invoicingCatalogItemFormConfig';
+export const initialState = {
+    fetchState: 'Not-Started',
+    error: undefined,
+    editDraftById: {},
+    newItemDraft: { ...initialInvoicingCatalogItemFormLocalData },
+    savedItemId: undefined,
+    savedKind: undefined,
+    hasValidState() {
+        return this.fetchState === 'Completed';
+    },
+};
+const editInvoicingCatalogItemDetailView = createSlice({
+    name: 'editInvoicingCatalogItemDetailView',
+    initialState,
+    reducers: {
+        updateInvoicingCatalogItemFormDraft(draft, action) {
+            const { id, localData } = action.payload;
+            if (id != null) {
+                draft.editDraftById[id] = localData;
+            }
+            else {
+                draft.newItemDraft = localData;
+            }
+        },
+        submitInvoicingCatalogItemForm: {
+            reducer(draft) {
+                draft.fetchState = 'In-Progress';
+                draft.error = undefined;
+                draft.savedItemId = undefined;
+            },
+            prepare(payload) {
+                return { payload };
+            },
+        },
+        saveInvoicingCatalogItem(draft, action) {
+            draft.fetchState = 'In-Progress';
+            draft.error = undefined;
+            draft.savedItemId = undefined;
+            draft.savedKind = action.payload.kind;
+        },
+        createInvoicingCatalogSubFamily: {
+            reducer(draft) {
+                draft.fetchState = 'In-Progress';
+                draft.error = undefined;
+                draft.savedItemId = undefined;
+            },
+            prepare(payload) {
+                return { payload };
+            },
+        },
+        archiveInvoicingCatalogSubFamily: {
+            reducer(draft) {
+                draft.fetchState = 'In-Progress';
+                draft.error = undefined;
+                draft.savedItemId = undefined;
+            },
+            prepare(payload) {
+                return { payload };
+            },
+        },
+        submitInvoicingCatalogItemFormSuccess(draft, action) {
+            draft.fetchState = 'Completed';
+            draft.error = undefined;
+            draft.savedItemId = action.payload.itemId;
+            draft.savedKind = action.payload.kind;
+        },
+        submitInvoicingCatalogItemFormFailure(draft, action) {
+            draft.fetchState = 'Error';
+            draft.error = action.payload;
+        },
+        resetEditInvoicingCatalogItemDetailView(draft) {
+            draft.fetchState = 'Not-Started';
+            draft.error = undefined;
+            draft.savedItemId = undefined;
+            draft.savedKind = undefined;
+            draft.editDraftById = {};
+            draft.newItemDraft = { ...initialInvoicingCatalogItemFormLocalData };
+        },
+    },
+});
+export const { updateInvoicingCatalogItemFormDraft, submitInvoicingCatalogItemForm, saveInvoicingCatalogItem, createInvoicingCatalogSubFamily, archiveInvoicingCatalogSubFamily, submitInvoicingCatalogItemFormSuccess, submitInvoicingCatalogItemFormFailure, resetEditInvoicingCatalogItemDetailView, } = editInvoicingCatalogItemDetailView.actions;
+export default editInvoicingCatalogItemDetailView.reducer;

package/lib/esm/view/invoicing/editInvoicingCatalogItemDetailView/editInvoicingCatalogItemDetailViewSelector.js

@@ -0,0 +1,70 @@
+import { createSelector } from '@reduxjs/toolkit';
+import { getInvoicingPlanById, getInvoicingPlansByIds, } from '../../../entity/invoicing/plan/planSelector';
+import { INVOICING_CATALOG_APPLICABILITY_VALUES, INVOICING_CATALOG_PERIOD_UNIT_VALUES, INVOICING_CATALOG_PRICING_MODEL_VALUES, INVOICING_CATALOG_PRORATION_VALUES, INVOICING_CATALOG_TIER_TYPE_VALUES, INVOICING_CATALOG_TRIAL_END_ACTION_VALUES, INVOICING_CATALOG_TRIAL_UNIT_VALUES, INVOICING_CATALOG_TYPE_VALUES, entityToInvoicingCatalogItemFormLocalData, } from './invoicingCatalogItemFormConfig';
+export const getEditInvoicingCatalogItemDetailViewState = (state) => ({
+    fetchState: state.editInvoicingCatalogItemDetailViewState.fetchState,
+    error: state.editInvoicingCatalogItemDetailViewState.error,
+});
+export const getSavedInvoicingCatalogItemId = (state) => state.editInvoicingCatalogItemDetailViewState.savedItemId;
+export const getSavedInvoicingCatalogItemKind = (state) => state.editInvoicingCatalogItemDetailViewState.savedKind;
+const isAddonOrCharge = (type) => type === 'addon' || type === 'charge';
+const catalogItemSubtitle = (productCode, detail) => {
+    const parts = [productCode, detail].filter((part) => part != null && part !== '');
+    return parts.length > 0 ? parts.join(' • ') : undefined;
+};
+const buildApplicableCatalogItemOptions = (plans) => {
+    const options = new Map();
+    for (const plan of plans) {
+        const type = plan.type ?? plan.itemType;
+        if (!isAddonOrCharge(type)) {
+            continue;
+        }
+        options.set(plan.id, {
+            id: plan.id,
+            label: plan.name ?? plan.id,
+            subtitle: catalogItemSubtitle(plan.productCode, type),
+        });
+    }
+    return [...options.values()].sort((a, b) => a.label.localeCompare(b.label));
+};
+/**
+ * Memoized add-on / one-time-charge options sourced from the catalog list slice.
+ * Kept referentially stable across unrelated dispatches; the form view filters
+ * out the item being edited (see `getInvoicingCatalogItemFormView`).
+ */
+export const getInvoicingApplicableCatalogItemOptions = createSelector((state) => state.invoicingPlanState, (state) => state.invoicingCatalogListViewState, (planState, listViewState) => buildApplicableCatalogItemOptions(getInvoicingPlansByIds(planState, [
+    ...listViewState.planIds,
+    ...listViewState.productIds,
+])));
+export const getInvoicingCatalogItemFormView = (state, id) => {
+    const { editDraftById, error, fetchState, newItemDraft, savedItemId, savedKind, } = state.editInvoicingCatalogItemDetailViewState;
+    const plan = id != null ? getInvoicingPlanById(state.invoicingPlanState, id) : undefined;
+    const kind = plan != null ? 'plan' : undefined;
+    const localData = id != null
+        ? (editDraftById[id] ?? entityToInvoicingCatalogItemFormLocalData(plan))
+        : newItemDraft;
+    const allApplicableItemOptions = getInvoicingApplicableCatalogItemOptions(state);
+    const applicableItemOptions = id != null
+        ? allApplicableItemOptions.filter((option) => option.id !== id)
+        : allApplicableItemOptions;
+    return {
+        applicabilityValues: INVOICING_CATALOG_APPLICABILITY_VALUES,
+        applicableItemOptions,
+        localData,
+        mode: id != null ? 'edit' : 'create',
+        periodUnitValues: INVOICING_CATALOG_PERIOD_UNIT_VALUES,
+        pricingModelValues: INVOICING_CATALOG_PRICING_MODEL_VALUES,
+        prorationValues: INVOICING_CATALOG_PRORATION_VALUES,
+        tierTypeValues: INVOICING_CATALOG_TIER_TYPE_VALUES,
+        trialEndActionValues: INVOICING_CATALOG_TRIAL_END_ACTION_VALUES,
+        trialUnitValues: INVOICING_CATALOG_TRIAL_UNIT_VALUES,
+        typeValues: INVOICING_CATALOG_TYPE_VALUES,
+        kind,
+        plan,
+        savedItemId,
+        savedKind,
+        fetchState,
+        error,
+        version: 1.0,
+    };
+};

package/lib/esm/view/invoicing/editInvoicingCatalogItemDetailView/editInvoicingCatalogItemDetailViewState.js

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

package/lib/esm/view/invoicing/editInvoicingCatalogItemDetailView/invoicingCatalogItemFormConfig.js

@@ -0,0 +1,154 @@
+/**
+ * Canonical value sets for the catalog item form. CES owns the values;
+ * web-components maps each value to a localized label.
+ */
+export const INVOICING_CATALOG_TYPE_VALUES = [
+    'plan',
+    'addon',
+    'charge',
+];
+export const INVOICING_CATALOG_PERIOD_UNIT_VALUES = [
+    'day',
+    'week',
+    'month',
+    'year',
+];
+export const INVOICING_CATALOG_PRICING_MODEL_VALUES = [
+    'flat_fee',
+    'per_unit',
+    'tiered',
+    'volume',
+    'stairstep',
+];
+export const INVOICING_CATALOG_TIER_TYPE_VALUES = [
+    'per_unit',
+    'flat_fee',
+    'package',
+];
+export const INVOICING_CATALOG_TRIAL_UNIT_VALUES = ['day', 'month'];
+export const INVOICING_CATALOG_TRIAL_END_ACTION_VALUES = [
+    'site_default',
+    'activate_subscription',
+    'cancel_subscription',
+];
+export const INVOICING_CATALOG_PRORATION_VALUES = [
+    'site_default',
+    'partial_term',
+    'full_term',
+];
+export const INVOICING_CATALOG_APPLICABILITY_VALUES = [
+    'all',
+    'restricted',
+];
+export const isTieredCatalogPricingModel = (model) => ['tiered', 'volume', 'stairstep'].includes(model);
+export const blankInvoicingCatalogTier = (startingUnit = '1') => ({
+    endingUnit: '',
+    packageSize: '',
+    price: '',
+    pricingType: 'per_unit',
+    startingUnit,
+});
+export const blankInvoicingCatalogSubFamily = () => ({
+    billingCycles: '',
+    description: '',
+    freeQuantity: '0',
+    id: '',
+    invoiceNotes: '',
+    isTaxable: true,
+    name: '',
+    period: '1',
+    periodUnit: 'month',
+    priceDollars: '',
+    priceCode: '',
+    pricingModel: 'flat_fee',
+    prorationType: 'site_default',
+    showDescriptionInInvoices: true,
+    showDescriptionInQuotes: true,
+    tiers: [blankInvoicingCatalogTier('1')],
+    trialEndAction: 'site_default',
+    trialPeriod: '',
+    trialPeriodUnit: 'month',
+});
+export const invoicingProductToCatalogItemFormSubFamily = (product) => {
+    const base = blankInvoicingCatalogSubFamily();
+    if (product == null) {
+        return base;
+    }
+    return {
+        ...base,
+        billingCycles: product.billingCycles != null ? String(product.billingCycles) : '',
+        description: product.description ?? '',
+        freeQuantity: product.freeQuantity != null ? String(product.freeQuantity) : '0',
+        id: product.id,
+        invoiceNotes: product.invoiceNotes ?? '',
+        isTaxable: product.isTaxable ?? true,
+        name: product.name ?? '',
+        period: product.period != null ? String(product.period) : '1',
+        periodUnit: product.periodUnit ?? 'month',
+        priceDollars: product.price != null ? String(product.price.amount) : '',
+        priceCode: product.priceCode ?? '',
+        pricingModel: product.pricingModel ?? 'flat_fee',
+        prorationType: product.prorationType ?? 'site_default',
+        showDescriptionInInvoices: product.showDescriptionInInvoices ?? true,
+        showDescriptionInQuotes: product.showDescriptionInQuotes ?? true,
+        tiers: product.tiers != null && product.tiers.length > 0
+            ? product.tiers.map((tier) => ({
+                endingUnit: tier.endingUnit != null ? String(tier.endingUnit) : '',
+                packageSize: tier.packageSize != null ? String(tier.packageSize) : '',
+                price: String(tier.price.amount),
+                pricingType: tier.pricingType ?? 'per_unit',
+                startingUnit: String(tier.startingUnit ?? 1),
+            }))
+            : [blankInvoicingCatalogTier('1')],
+        trialEndAction: product.trialEndAction ?? 'site_default',
+        trialPeriod: product.trialPeriod != null ? String(product.trialPeriod) : '',
+        trialPeriodUnit: product.trialPeriodUnit ?? 'month',
+    };
+};
+export const initialInvoicingCatalogItemFormLocalData = {
+    accountingCategory: '',
+    accountingCode: '',
+    applicableItems: [],
+    catalogType: 'plan',
+    description: '',
+    externalId: '',
+    itemApplicability: 'all',
+    name: '',
+    productCode: '',
+    sku: '',
+    subFamilies: [blankInvoicingCatalogSubFamily()],
+    unit: '',
+};
+/**
+ * Seed the form draft from a parent catalog item and its embedded sub-families.
+ */
+export const entityToInvoicingCatalogItemFormLocalData = (item) => {
+    if (item == null) {
+        return {
+            ...initialInvoicingCatalogItemFormLocalData,
+            subFamilies: [blankInvoicingCatalogSubFamily()],
+        };
+    }
+    const plan = item;
+    const catalogType = plan.type === 'charge' || plan.itemType === 'charge'
+        ? 'charge'
+        : plan.type === 'addon' || plan.itemType === 'addon'
+            ? 'addon'
+            : 'plan';
+    return {
+        accountingCategory: plan.subFamilies?.[0]?.accountingDetail?.accountingCategory1 ?? '',
+        accountingCode: plan.subFamilies?.[0]?.accountingDetail?.accountingCode ?? '',
+        applicableItems: item.applicableItems ?? [],
+        catalogType,
+        description: item.description ?? '',
+        externalId: item.externalId ?? '',
+        itemApplicability: item.itemApplicability ?? 'all',
+        name: item.name ?? '',
+        productCode: item.productCode ?? '',
+        sku: plan.subFamilies?.[0]?.accountingDetail?.sku ?? '',
+        subFamilies: plan?.subFamilies != null && plan.subFamilies.length > 0
+            ? plan.subFamilies.map(invoicingProductToCatalogItemFormSubFamily)
+            : [invoicingProductToCatalogItemFormSubFamily()],
+        unit: item.unit ?? '',
+    };
+};

package/lib/esm/view/invoicing/editInvoicingCatalogItemDetailView/invoicingCatalogSubFamilyEpics.js

@@ -0,0 +1,39 @@
+import { of } from 'rxjs';
+import { catchError, filter, mergeMap } from 'rxjs/operators';
+import { mergeInvoicingPlanSubFamily } from '../../../entity/invoicing/plan/planReducer';
+import { createZeniAPIStatus, isSuccessResponse, } from '../../../responsePayload';
+import { archiveInvoicingCatalogSubFamily, createInvoicingCatalogSubFamily, submitInvoicingCatalogItemFormFailure, submitInvoicingCatalogItemFormSuccess, } from './editInvoicingCatalogItemDetailViewReducer';
+const subFamilySuccessActions = (parentItemId, subFamilyPayload) => [
+    mergeInvoicingPlanSubFamily(parentItemId, subFamilyPayload),
+    submitInvoicingCatalogItemFormSuccess({
+        itemId: parentItemId,
+        kind: 'plan',
+    }),
+];
+export const createInvoicingCatalogSubFamilyEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(createInvoicingCatalogSubFamily.match), mergeMap((action) => {
+    const { data, parentItemId } = action.payload;
+    const baseUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0`;
+    return zeniAPI
+        .postAndGetJSON(`${baseUrl}/catalog/products`, data)
+        .pipe(mergeMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            return subFamilySuccessActions(parentItemId, response.data);
+        }
+        return of(submitInvoicingCatalogItemFormFailure(response.status));
+    }), catchError((error) => of(submitInvoicingCatalogItemFormFailure(createZeniAPIStatus('Unexpected Error', 'Create sub-family REST API call errored out ' +
+        JSON.stringify(error))))));
+}));
+export const archiveInvoicingCatalogSubFamilyEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(archiveInvoicingCatalogSubFamily.match), mergeMap((action) => {
+    const { parentItemId, subFamilyId } = action.payload;
+    const baseUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0`;
+    const path = `${baseUrl}/catalog/products/${encodeURIComponent(subFamilyId)}/actions`;
+    return zeniAPI
+        .postAndGetJSON(path, { action: 'archive' })
+        .pipe(mergeMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            return subFamilySuccessActions(parentItemId, response.data);
+        }
+        return of(submitInvoicingCatalogItemFormFailure(response.status));
+    }), catchError((error) => of(submitInvoicingCatalogItemFormFailure(createZeniAPIStatus('Unexpected Error', 'Archive sub-family REST API call errored out ' +
+        JSON.stringify(error))))));
+}));

package/lib/esm/view/invoicing/editInvoicingCatalogItemDetailView/saveInvoicingCatalogItemEpic.js

@@ -0,0 +1,81 @@
+import { forkJoin, of } from 'rxjs';
+import { catchError, filter, mergeMap } from 'rxjs/operators';
+import { mergeInvoicingPlanSubFamily, updateInvoicingPlans, } from '../../../entity/invoicing/plan/planReducer';
+import { updateInvoicingProducts } from '../../../entity/invoicing/product/productReducer';
+import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { addInvoicingCatalogItem } from '../invoicingCatalogListView/invoicingCatalogListViewReducer';
+import { localDataToSaveInvoicingCatalogItemPayload, } from './editInvoicingCatalogItemDetailViewPayload';
+import { saveInvoicingCatalogItem, submitInvoicingCatalogItemForm, submitInvoicingCatalogItemFormFailure, submitInvoicingCatalogItemFormSuccess, } from './editInvoicingCatalogItemDetailViewReducer';
+export const saveInvoicingCatalogItemEpic = (actions$, state$, zeniAPI) => actions$.pipe(filter((action) => submitInvoicingCatalogItemForm.match(action) ||
+    saveInvoicingCatalogItem.match(action)), mergeMap((action) => {
+    const { id } = action.payload;
+    // Draft-based create/edit form vs. detail-page inline edit (raw data).
+    let data;
+    if (saveInvoicingCatalogItem.match(action)) {
+        data = action.payload.data;
+    }
+    else {
+        const viewState = state$.value.editInvoicingCatalogItemDetailViewState;
+        const localData = (id != null ? viewState.editDraftById[id] : viewState.newItemDraft) ??
+            viewState.newItemDraft;
+        data = localDataToSaveInvoicingCatalogItemPayload(localData, id == null);
+    }
+    const baseUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0`;
+    const path = id != null
+        ? `${baseUrl}/catalog/plans/${encodeURIComponent(id)}`
+        : `${baseUrl}/catalog/plans`;
+    const request$ = id != null
+        ? zeniAPI.putAndGetJSON(path, {
+            ...data,
+        })
+        : zeniAPI.postAndGetJSON(path, {
+            ...data,
+        });
+    return request$.pipe(mergeMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            const savedItem = response.data;
+            const completeSave = (productResponses) => {
+                const failedProductResponse = productResponses.find((productResponse) => !isSuccessResponse(productResponse) ||
+                    productResponse.data == null);
+                if (failedProductResponse != null) {
+                    return of(submitInvoicingCatalogItemFormFailure(failedProductResponse.status));
+                }
+                const savedProducts = productResponses.flatMap((productResponse) => productResponse.data != null ? [productResponse.data] : []);
+                const resultActions = [
+                    updateInvoicingPlans([savedItem], 'merge'),
+                    ...(savedProducts.length > 0
+                        ? [updateInvoicingProducts(savedProducts, 'merge')]
+                        : []),
+                    ...savedProducts.map((product) => mergeInvoicingPlanSubFamily(savedItem.id, product)),
+                    submitInvoicingCatalogItemFormSuccess({
+                        itemId: savedItem.id,
+                        kind: 'plan',
+                    }),
+                ];
+                // Create (no id): reflect the new row + tab counts in the cached
+                // catalog lists 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) {
+                    const itemType = savedItem.type === 'charge' ||
+                        savedItem.item_type === 'charge'
+                        ? 'charge'
+                        : savedItem.type === 'addon' ||
+                            savedItem.item_type === 'addon'
+                            ? 'addon'
+                            : 'plan';
+                    resultActions.push(addInvoicingCatalogItem({ id: savedItem.id, type: itemType }));
+                }
+                return resultActions;
+            };
+            const productUpdates = saveInvoicingCatalogItem.match(action)
+                ? (action.payload.productUpdates ?? [])
+                : [];
+            if (productUpdates.length === 0) {
+                return completeSave([]);
+            }
+            return forkJoin(productUpdates.map((productUpdate) => zeniAPI.putAndGetJSON(`${baseUrl}/catalog/products/${encodeURIComponent(productUpdate.id)}`, productUpdate.data))).pipe(mergeMap(completeSave));
+        }
+        return of(submitInvoicingCatalogItemFormFailure(response.status));
+    }), catchError((error) => of(submitInvoicingCatalogItemFormFailure(createZeniAPIStatus('Unexpected Error', 'Save catalog item REST API call errored out ' +
+        JSON.stringify(error))))));
+}));

package/lib/esm/view/invoicing/editInvoicingCouponDetailView/editInvoicingCouponDetailViewPayload.js

@@ -0,0 +1,59 @@
+/**
+ * Build the create/update discount request body from the form draft (snake_case
+ * matching the `/discounts` schema). On create the coupon id is part of the
+ * body; on edit it is the URL param, so it is omitted here.
+ */
+export const localDataToSaveInvoicingCouponPayload = (localData, isCreate) => {
+    const data = {
+        apply_on: localData.applyOn,
+        discount_type: localData.discountType,
+        duration_type: localData.durationType,
+        name: localData.name.trim(),
+        status: 'active',
+    };
+    if (isCreate) {
+        data.id = localData.couponId.trim();
+    }
+    const couponCode = localData.couponCode.trim();
+    if (couponCode !== '') {
+        data.coupon_code = couponCode;
+    }
+    if (localData.discountType === 'percentage' &&
+        localData.discountPercentage.trim() !== '') {
+        data.discount_percentage = Number(localData.discountPercentage);
+    }
+    if (localData.discountType === 'fixed_amount') {
+        if (localData.discountAmount.trim() !== '') {
+            data.discount_amount = Number(localData.discountAmount);
+        }
+        data.currency_code = 'USD';
+    }
+    if (localData.discountType === 'offer_quantity' &&
+        localData.discountQuantity.trim() !== '') {
+        data.discount_quantity = Number(localData.discountQuantity);
+    }
+    if (localData.durationType === 'limited_period') {
+        if (localData.period.trim() !== '') {
+            data.period = Number(localData.period);
+        }
+        data.period_unit = localData.periodUnit;
+    }
+    if (localData.validFrom.trim() !== '') {
+        data.valid_from = localData.validFrom.trim();
+    }
+    if (localData.validTill.trim() !== '') {
+        data.valid_till = localData.validTill.trim();
+    }
+    if (localData.maxRedemptions.trim() !== '') {
+        data.max_redemptions = Number(localData.maxRedemptions);
+    }
+    const invoiceName = localData.invoiceName.trim();
+    if (invoiceName !== '') {
+        data.invoice_name = invoiceName;
+    }
+    const invoiceNotes = localData.invoiceNotes.trim();
+    if (invoiceNotes !== '') {
+        data.invoice_notes = invoiceNotes;
+    }
+    return data;
+};

package/lib/esm/view/invoicing/editInvoicingCouponDetailView/editInvoicingCouponDetailViewReducer.js

@@ -0,0 +1,65 @@
+import { createSlice } from '@reduxjs/toolkit';
+import { initialInvoicingCouponFormLocalData } from './invoicingCouponFormConfig';
+export const initialState = {
+    fetchState: 'Not-Started',
+    error: undefined,
+    editDraftById: {},
+    newCouponDraft: { ...initialInvoicingCouponFormLocalData },
+    savedCouponId: undefined,
+    hasValidState() {
+        return this.fetchState === 'Completed';
+    },
+};
+const editInvoicingCouponDetailView = createSlice({
+    name: 'editInvoicingCouponDetailView',
+    initialState,
+    reducers: {
+        updateInvoicingCouponFormDraft(draft, action) {
+            const { id, localData } = action.payload;
+            if (id != null) {
+                draft.editDraftById[id] = localData;
+            }
+            else {
+                draft.newCouponDraft = localData;
+            }
+        },
+        submitInvoicingCouponForm: {
+            reducer(draft) {
+                draft.fetchState = 'In-Progress';
+                draft.error = undefined;
+                draft.savedCouponId = undefined;
+            },
+            prepare(payload) {
+                return { payload };
+            },
+        },
+        saveInvoicingCoupon: {
+            reducer(draft) {
+                draft.fetchState = 'In-Progress';
+                draft.error = undefined;
+                draft.savedCouponId = undefined;
+            },
+            prepare(payload) {
+                return { payload };
+            },
+        },
+        submitInvoicingCouponFormSuccess(draft, action) {
+            draft.fetchState = 'Completed';
+            draft.error = undefined;
+            draft.savedCouponId = action.payload.couponId;
+        },
+        submitInvoicingCouponFormFailure(draft, action) {
+            draft.fetchState = 'Error';
+            draft.error = action.payload;
+        },
+        resetEditInvoicingCouponDetailView(draft) {
+            draft.fetchState = 'Not-Started';
+            draft.error = undefined;
+            draft.savedCouponId = undefined;
+            draft.editDraftById = {};
+            draft.newCouponDraft = { ...initialInvoicingCouponFormLocalData };
+        },
+    },
+});
+export const { updateInvoicingCouponFormDraft, submitInvoicingCouponForm, saveInvoicingCoupon, submitInvoicingCouponFormSuccess, submitInvoicingCouponFormFailure, resetEditInvoicingCouponDetailView, } = editInvoicingCouponDetailView.actions;
+export default editInvoicingCouponDetailView.reducer;

package/lib/esm/view/invoicing/editInvoicingCouponDetailView/editInvoicingCouponDetailViewSelector.js

@@ -0,0 +1,43 @@
+import { INVOICING_COUPON_APPLY_ON_OPTIONS, INVOICING_COUPON_DURATION_TYPE_OPTIONS, INVOICING_COUPON_PERIOD_UNIT_OPTIONS, INVOICING_DISCOUNT_TYPE_OPTIONS, } from '../../../entity/invoicing/coupon/couponConstants';
+import { getInvoicingCouponById } from '../../../entity/invoicing/coupon/couponSelector';
+import { entityToInvoicingCouponFormLocalData } from './invoicingCouponFormConfig';
+/**
+ * Bundled view for the discount create/edit form: the save fetch state/error,
+ * the id of the coupon last saved, and — when a `couponId` is passed (edit
+ * mode) — the existing coupon entity to prefill the form.
+ */
+export const getEditInvoicingCouponDetailViewState = (state, couponId) => {
+    const { error, fetchState, savedCouponId } = state.editInvoicingCouponDetailViewState;
+    return {
+        coupon: couponId != null
+            ? getInvoicingCouponById(state.invoicingCouponState, couponId)
+            : undefined,
+        savedCouponId,
+        fetchState,
+        error,
+        version: 1.0,
+    };
+};
+/**
+ * Bundled view for the discount form screen: the edit view (save state + the
+ * coupon to prefill in edit mode), the draft `localData` (seeded from the
+ * existing coupon in edit mode until the user edits), and the CES-owned
+ * select-option lists the form renders.
+ */
+export const getInvoicingCouponFormView = (state, couponId) => {
+    const base = getEditInvoicingCouponDetailViewState(state, couponId);
+    const { editDraftById, newCouponDraft } = state.editInvoicingCouponDetailViewState;
+    const localData = couponId != null
+        ? (editDraftById[couponId] ??
+            entityToInvoicingCouponFormLocalData(base.coupon))
+        : newCouponDraft;
+    return {
+        ...base,
+        applyOnOptions: INVOICING_COUPON_APPLY_ON_OPTIONS,
+        discountTypeOptions: INVOICING_DISCOUNT_TYPE_OPTIONS,
+        durationTypeOptions: INVOICING_COUPON_DURATION_TYPE_OPTIONS,
+        localData,
+        mode: couponId != null ? 'edit' : 'create',
+        periodUnitOptions: INVOICING_COUPON_PERIOD_UNIT_OPTIONS,
+    };
+};

package/lib/esm/view/invoicing/editInvoicingCouponDetailView/editInvoicingCouponDetailViewState.js

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

package/lib/esm/view/invoicing/editInvoicingCouponDetailView/invoicingCouponFormConfig.js

@@ -0,0 +1,44 @@
+export const initialInvoicingCouponFormLocalData = {
+    applyOn: 'invoice_amount',
+    couponCode: '',
+    couponId: '',
+    discountAmount: '',
+    discountPercentage: '',
+    discountQuantity: '',
+    discountType: 'percentage',
+    durationType: 'one_time',
+    invoiceName: '',
+    invoiceNotes: '',
+    maxRedemptions: '',
+    name: '',
+    period: '',
+    periodUnit: 'month',
+    validFrom: '',
+    validTill: '',
+};
+/** Seed the form draft from an existing coupon entity (edit mode). */
+export const entityToInvoicingCouponFormLocalData = (coupon) => {
+    if (coupon == null) {
+        return { ...initialInvoicingCouponFormLocalData };
+    }
+    return {
+        applyOn: coupon.applyOn ?? 'invoice_amount',
+        couponCode: coupon.couponCode ?? '',
+        couponId: coupon.id ?? '',
+        discountAmount: coupon.discountAmount != null ? String(coupon.discountAmount.amount) : '',
+        discountPercentage: coupon.discountPercentage != null
+            ? String(coupon.discountPercentage)
+            : '',
+        discountQuantity: coupon.discountQuantity != null ? String(coupon.discountQuantity) : '',
+        discountType: coupon.discountType ?? 'percentage',
+        durationType: coupon.durationType ?? 'one_time',
+        invoiceName: coupon.invoiceName ?? '',
+        invoiceNotes: coupon.invoiceNotes ?? '',
+        maxRedemptions: coupon.maxRedemptions != null ? String(coupon.maxRedemptions) : '',
+        name: coupon.name ?? '',
+        period: coupon.period != null ? String(coupon.period) : '',
+        periodUnit: coupon.periodUnit ?? 'month',
+        validFrom: coupon.validFrom != null ? coupon.validFrom.format('YYYY-MM-DD') : '',
+        validTill: coupon.validTill != null ? coupon.validTill.format('YYYY-MM-DD') : '',
+    };
+};