@zeniai/client-epic-state 5.1.60 → 5.1.61

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

@@ -0,0 +1,131 @@
+import { blankInvoicingCatalogSubFamily, isTieredCatalogPricingModel, } from './invoicingCatalogItemFormConfig';
+const CURRENCY_CODE = 'USD';
+const trimOrUndefined = (value) => value.trim() !== '' ? value.trim() : undefined;
+const trimOrNull = (value) => value.trim() !== '' ? value.trim() : null;
+const toProductCode = (value) => value
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-|-$/g, '');
+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, clearEmptyValues) => {
+    const isAddon = localData.catalogType === 'addon';
+    const tiered = isTieredCatalogPricingModel(subFamily.pricingModel);
+    const name = subFamily.name.trim();
+    const priceCode = trimOrUndefined(subFamily.priceCode) ?? toProductCode(name);
+    const payload = {
+        currency_code: CURRENCY_CODE,
+        free_quantity: Number(subFamily.freeQuantity) || 0,
+        is_taxable: subFamily.isTaxable,
+        name,
+        price: tiered ? 0 : toAmountValue(subFamily.priceDollars),
+        price_code: priceCode,
+        pricing_model: subFamily.pricingModel,
+        show_description_in_invoices: subFamily.showDescriptionInInvoices,
+        show_description_in_quotes: subFamily.showDescriptionInQuotes,
+    };
+    const description = trimOrUndefined(subFamily.description);
+    if (description != null) {
+        payload.description = description;
+    }
+    else if (clearEmptyValues) {
+        payload.description = null;
+    }
+    const invoiceNotes = trimOrUndefined(subFamily.invoiceNotes);
+    if (invoiceNotes != null) {
+        payload.invoice_notes = invoiceNotes;
+    }
+    else if (clearEmptyValues) {
+        payload.invoice_notes = null;
+    }
+    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;
+    }
+    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 parent catalog-item request body from the form draft. Creates omit
+ * both parent and sub-family IDs; edits retain returned sub-family IDs.
+ */
+export const localDataToSaveInvoicingCatalogItemPayload = (localData, isCreate) => {
+    const description = trimOrUndefined(localData.description);
+    const productCode = trimOrUndefined(localData.productCode) ?? toProductCode(localData.name);
+    const itemPayload = {
+        enabled_for_checkout: true,
+        enabled_in_portal: true,
+        is_giftable: false,
+        is_shippable: false,
+        item_applicability: localData.itemApplicability,
+        metered: false,
+        name: localData.name.trim(),
+        product_code: productCode,
+        type: localData.catalogType,
+    };
+    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.applicable_items = localData.applicableItems;
+    }
+    const subFamilies = localData.subFamilies.length > 0
+        ? localData.subFamilies
+        : [blankInvoicingCatalogSubFamily()];
+    itemPayload.sub_family_details = isCreate
+        ? subFamilies.map((subFamily) => buildSubFamilyPayload(localData, subFamily, false))
+        : subFamilies.map((subFamily) => {
+            const priceCode = trimOrUndefined(subFamily.priceCode) ?? toProductCode(subFamily.name);
+            const detail = {
+                description: trimOrNull(subFamily.description),
+                invoice_notes: trimOrNull(subFamily.invoiceNotes),
+                name: subFamily.name.trim(),
+                price_code: priceCode,
+                show_description_in_invoices: subFamily.showDescriptionInInvoices,
+            };
+            const id = trimOrUndefined(subFamily.id);
+            return id != null ? { ...detail, id } : detail;
+        });
+    return itemPayload;
+};

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;
+};