@zeniai/client-epic-state 5.1.49 → 5.1.50-betaAK0

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

@@ -0,0 +1,137 @@
+import { blankInvoicingCatalogSubFamily, isTieredCatalogPricingModel, } from './invoicingCatalogItemFormConfig';
+const CURRENCY_CODE = 'USD';
+const trimOrUndefined = (value) => value.trim() !== '' ? value.trim() : undefined;
+const toAmountValue = (value) => Number(value) || 0;
+const buildAccountingDetail = (localData) => {
+    const detail = {};
+    if (localData.sku.trim() !== '') {
+        detail.sku = localData.sku.trim();
+    }
+    if (localData.accountingCode.trim() !== '') {
+        detail.accounting_code = localData.accountingCode.trim();
+    }
+    if (localData.accountingCategory.trim() !== '') {
+        detail.accounting_category_1 = localData.accountingCategory.trim();
+    }
+    return Object.keys(detail).length > 0 ? detail : undefined;
+};
+const buildSubFamilyPayload = (localData, subFamily, subFamilyId) => {
+    const isCharge = localData.catalogType === 'charge';
+    const isAddon = localData.catalogType === 'addon';
+    const tiered = isTieredCatalogPricingModel(subFamily.pricingModel);
+    const resolvedName = trimOrUndefined(subFamily.externalName) ??
+        trimOrUndefined(localData.invoiceName) ??
+        `${localData.name.trim()} ${CURRENCY_CODE}${subFamily.periodUnit ? ` ${subFamily.periodUnit}` : ''}`;
+    const payload = {
+        currency_code: CURRENCY_CODE,
+        free_quantity: Number(subFamily.freeQuantity) || 0,
+        id: subFamilyId,
+        is_taxable: subFamily.isTaxable,
+        item_type: isCharge ? 'charge' : isAddon ? 'addon' : 'plan',
+        name: resolvedName,
+        price: tiered ? 0 : toAmountValue(subFamily.priceDollars),
+        pricing_model: subFamily.pricingModel,
+        show_description_in_invoices: subFamily.showDescriptionInInvoices,
+        show_description_in_quotes: subFamily.showDescriptionInQuotes,
+    };
+    const externalName = trimOrUndefined(subFamily.externalName);
+    if (externalName != null) {
+        payload.external_name = externalName;
+    }
+    const description = trimOrUndefined(subFamily.description);
+    if (description != null) {
+        payload.description = description;
+    }
+    if (subFamily.period.trim() !== '') {
+        payload.period = Number(subFamily.period);
+        payload.period_unit = subFamily.periodUnit || 'month';
+    }
+    if (subFamily.trialPeriod.trim() !== '') {
+        payload.trial_period = Number(subFamily.trialPeriod);
+        payload.trial_period_unit = subFamily.trialPeriodUnit;
+        payload.trial_end_action = subFamily.trialEndAction;
+    }
+    if (subFamily.billingCycles.trim() !== '') {
+        payload.billing_cycles = Number(subFamily.billingCycles);
+    }
+    if (isAddon && subFamily.prorationType) {
+        payload.proration_type = subFamily.prorationType;
+    }
+    const notes = trimOrUndefined(localData.invoiceNotes);
+    if (notes != null) {
+        payload.invoice_notes = notes;
+    }
+    if (tiered) {
+        payload.tiers = subFamily.tiers.map((tier) => ({
+            ending_unit: tier.endingUnit.trim() !== '' ? Number(tier.endingUnit) : undefined,
+            package_size: tier.packageSize.trim() !== '' ? Number(tier.packageSize) : undefined,
+            price: toAmountValue(tier.price),
+            pricing_type: tier.pricingType,
+            starting_unit: Number(tier.startingUnit) || 1,
+        }));
+    }
+    const accountingDetail = buildAccountingDetail(localData);
+    if (accountingDetail != null) {
+        payload.accounting_detail = accountingDetail;
+    }
+    return payload;
+};
+/**
+ * Build the create/update catalog-item request body from the form draft. Plans
+ * are sent with nested `sub_family_details`; add-ons / one-time charges flatten
+ * the first sub-family onto the item payload. Ports the web-c form's builder.
+ */
+export const localDataToSaveInvoicingCatalogItemPayload = (localData, isCreate) => {
+    const isPlan = localData.catalogType === 'plan';
+    const itemPayload = {
+        currency_code: CURRENCY_CODE,
+        enabled_for_checkout: true,
+        enabled_in_portal: true,
+        is_giftable: false,
+        is_shippable: false,
+        item_applicability: localData.itemApplicability,
+        metered: false,
+        name: localData.name.trim(),
+        type: isPlan ? 'plan' : 'product',
+    };
+    if (isCreate) {
+        itemPayload.id = localData.itemId.trim();
+    }
+    const externalName = trimOrUndefined(localData.externalName);
+    if (externalName != null) {
+        itemPayload.externalName = externalName;
+    }
+    const description = trimOrUndefined(localData.description);
+    if (description != null) {
+        itemPayload.description = description;
+    }
+    const unit = trimOrUndefined(localData.unit);
+    if (unit != null) {
+        itemPayload.unit = unit;
+    }
+    if (localData.itemApplicability === 'restricted' &&
+        localData.applicableItems.length > 0) {
+        itemPayload.applicableItems = localData.applicableItems;
+    }
+    if (isPlan) {
+        const planId = localData.itemId.trim();
+        const usedIds = new Set();
+        const subFamilyDetails = localData.subFamilies.map((subFamily, index) => {
+            let subFamilyId = `${planId}-${CURRENCY_CODE.toLowerCase()}` +
+                (subFamily.period
+                    ? `-${subFamily.period}${subFamily.periodUnit.charAt(0)}`
+                    : '');
+            if (usedIds.has(subFamilyId)) {
+                subFamilyId = `${subFamilyId}-${index + 1}`;
+            }
+            usedIds.add(subFamilyId);
+            return buildSubFamilyPayload(localData, subFamily, subFamilyId);
+        });
+        return { ...itemPayload, sub_family_details: subFamilyDetails };
+    }
+    const subFamily = localData.subFamilies[0] ?? blankInvoicingCatalogSubFamily();
+    const subFamilyPayload = buildSubFamilyPayload(localData, subFamily, localData.itemId.trim());
+    delete subFamilyPayload.id;
+    delete subFamilyPayload.name;
+    return { ...itemPayload, ...subFamilyPayload };
+};

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

@@ -0,0 +1,64 @@
+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;
+        },
+        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, submitInvoicingCatalogItemFormSuccess, submitInvoicingCatalogItemFormFailure, resetEditInvoicingCatalogItemDetailView, } = editInvoicingCatalogItemDetailView.actions;
+export default editInvoicingCatalogItemDetailView.reducer;

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

@@ -0,0 +1,41 @@
+import { getInvoicingPlanById } from '../../../entity/invoicing/plan/planSelector';
+import { getInvoicingProductById } from '../../../entity/invoicing/product/productSelector';
+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;
+export const getInvoicingCatalogItemFormView = (state, kind, id) => {
+    const { editDraftById, error, fetchState, newItemDraft, savedItemId, savedKind } = state.editInvoicingCatalogItemDetailViewState;
+    const plan = kind === 'plan' && id != null
+        ? getInvoicingPlanById(state.invoicingPlanState, id)
+        : undefined;
+    const product = kind === 'product' && id != null
+        ? getInvoicingProductById(state.invoicingProductState, id)
+        : undefined;
+    const localData = id != null
+        ? (editDraftById[id] ??
+            entityToInvoicingCatalogItemFormLocalData(plan ?? product, kind))
+        : newItemDraft;
+    return {
+        applicabilityValues: [...INVOICING_CATALOG_APPLICABILITY_VALUES],
+        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],
+        plan,
+        product,
+        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,152 @@
+/**
+ * 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: '',
+    externalName: '',
+    freeQuantity: '0',
+    isTaxable: true,
+    period: '1',
+    periodUnit: 'month',
+    priceDollars: '',
+    pricingModel: 'flat_fee',
+    prorationType: 'site_default',
+    showDescriptionInInvoices: true,
+    showDescriptionInQuotes: true,
+    tiers: [blankInvoicingCatalogTier('1')],
+    trialEndAction: 'site_default',
+    trialPeriod: '',
+    trialPeriodUnit: 'month',
+});
+const subFamilyFromProduct = (product) => {
+    const base = blankInvoicingCatalogSubFamily();
+    if (product == null) {
+        return base;
+    }
+    return {
+        ...base,
+        billingCycles: product.billingCycles != null ? String(product.billingCycles) : '',
+        description: product.description ?? '',
+        externalName: product.externalName ?? '',
+        freeQuantity: product.freeQuantity != null ? String(product.freeQuantity) : '0',
+        isTaxable: product.isTaxable ?? true,
+        period: product.period != null ? String(product.period) : '1',
+        periodUnit: product.periodUnit ?? 'month',
+        priceDollars: product.price != null ? String(product.price.amount) : '',
+        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: '',
+    externalName: '',
+    invoiceName: '',
+    invoiceNotes: '',
+    itemApplicability: 'all',
+    itemId: '',
+    name: '',
+    sku: '',
+    subFamilies: [blankInvoicingCatalogSubFamily()],
+    unit: '',
+};
+/**
+ * Seed the form draft from an existing plan/product entity (edit mode). Mirrors
+ * the web-c form: product-specific pricing/accounting fields only populate for
+ * the `product` kind; a plan starts with a single blank sub-family.
+ */
+export const entityToInvoicingCatalogItemFormLocalData = (item, kind) => {
+    if (item == null) {
+        return {
+            ...initialInvoicingCatalogItemFormLocalData,
+            subFamilies: [blankInvoicingCatalogSubFamily()],
+        };
+    }
+    const product = kind === 'product' ? item : undefined;
+    const catalogType = kind === 'product'
+        ? product?.itemType === 'charge'
+            ? 'charge'
+            : 'addon'
+        : 'plan';
+    return {
+        accountingCategory: product?.accountingDetail?.accountingCategory1 ?? '',
+        accountingCode: product?.accountingDetail?.accountingCode ?? '',
+        applicableItems: item.applicableItems ?? [],
+        catalogType,
+        description: item.description ?? '',
+        externalName: item.externalName ?? '',
+        invoiceName: product?.name ?? '',
+        invoiceNotes: product?.invoiceNotes ?? '',
+        itemApplicability: item.itemApplicability ?? 'all',
+        itemId: item.id ?? '',
+        name: item.name ?? '',
+        sku: product?.accountingDetail?.sku ?? '',
+        subFamilies: [subFamilyFromProduct(product)],
+        unit: item.unit ?? '',
+    };
+};

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

@@ -0,0 +1,53 @@
+import { of } from 'rxjs';
+import { catchError, filter, mergeMap } from 'rxjs/operators';
+import { updateInvoicingPlans } from '../../../entity/invoicing/plan/planReducer';
+import { updateInvoicingProducts } from '../../../entity/invoicing/product/productReducer';
+import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+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 kind;
+    let data;
+    if (saveInvoicingCatalogItem.match(action)) {
+        kind = action.payload.kind;
+        data = action.payload.data;
+    }
+    else {
+        const viewState = state$.value.editInvoicingCatalogItemDetailViewState;
+        const localData = (id != null ? viewState.editDraftById[id] : viewState.newItemDraft) ??
+            viewState.newItemDraft;
+        kind = localData.catalogType === 'plan' ? 'plan' : 'product';
+        data = localDataToSaveInvoicingCatalogItemPayload(localData, id == null);
+    }
+    const baseUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0`;
+    const collection = kind === 'plan' ? 'plans' : 'products';
+    const path = id != null
+        ? `${baseUrl}/catalog/${collection}/${encodeURIComponent(id)}`
+        : `${baseUrl}/catalog/${collection}`;
+    const request$ = id != null
+        ? zeniAPI.putAndGetJSON(path, {
+            ...data,
+        })
+        : zeniAPI.postAndGetJSON(path, {
+            ...data,
+        });
+    return request$.pipe(mergeMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            const entityAction = kind === 'plan'
+                ? updateInvoicingPlans([response.data], 'merge')
+                : updateInvoicingProducts([response.data], 'merge');
+            return [
+                entityAction,
+                submitInvoicingCatalogItemFormSuccess({
+                    itemId: response.data.id,
+                    kind,
+                }),
+            ];
+        }
+        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,41 @@
+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, 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') : '',
+    };
+};